[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M790E81BYP17CKTZ1AC41RYK":3,"skill-same:01M790E81BYP17CKTZ1AC41RYK":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":36,"repositoryHtmlUrl":37,"repositoryHomepageUrl":6,"ownerHtmlUrl":38,"ownerBlogUrl":39,"ownerDescription":40,"updatedAt":41,"install":42,"resources":55},"01M790E81BYP17CKTZ1AC41RYK","flexport-sdk-patterns",null,"Apply production-ready Flexport API patterns for TypeScript and Python.\nUse when building typed HTTP clients, implementing pagination,\nor establishing team coding standards for Flexport logistics integration.\nTrigger: \"flexport SDK patterns\", \"flexport best practices\", \"flexport client wrapper\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--flexport-pack--flexport-sdk-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: flexport-sdk-patterns\ndescription: |\n  Apply production-ready Flexport API patterns for TypeScript and Python.\n  Use when building typed HTTP clients, implementing pagination,\n  or establishing team coding standards for Flexport logistics integration.\n  Trigger: \"flexport SDK patterns\", \"flexport best practices\", \"flexport client wrapper\".\nallowed-tools: Read, Write, Edit\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ntags: [saas, logistics, flexport]\ncompatible-with: claude-code\n---\n\n# Flexport SDK Patterns\n\n## Overview\n\nProduction-ready patterns for the Flexport REST API v2. Since Flexport has no official npm\u002Fpip SDK, you build typed HTTP clients. Key patterns: singleton client, paginated iteration, retry wrapper, and Zod response validation.\n\n## Instructions\n\n### Pattern 1: Singleton Client with Auto-Retry\n\n```typescript\n\u002F\u002F src\u002Fflexport\u002Fclient.ts\nimport { z } from 'zod';\n\nclass FlexportClient {\n  private static instance: FlexportClient | null = null;\n  private base = 'https:\u002F\u002Fapi.flexport.com';\n  private headers: Record\u003Cstring, string>;\n\n  private constructor(apiKey: string) {\n    this.headers = {\n      'Authorization': `Bearer ${apiKey}`,\n      'Flexport-Version': '2',\n      'Content-Type': 'application\u002Fjson',\n    };\n  }\n\n  static getInstance(): FlexportClient {\n    if (!this.instance) {\n      const key = process.env.FLEXPORT_API_KEY;\n      if (!key) throw new Error('Missing FLEXPORT_API_KEY');\n      this.instance = new FlexportClient(key);\n    }\n    return this.instance;\n  }\n\n  async request\u003CT>(path: string, options: RequestInit = {}): Promise\u003CT> {\n    const res = await fetch(`${this.base}${path}`, { ...options, headers: { ...this.headers, ...options.headers } });\n    if (res.status === 429) {\n      const retryAfter = parseInt(res.headers.get('Retry-After') || '60');\n      await new Promise(r => setTimeout(r, retryAfter * 1000));\n      return this.request(path, options);  \u002F\u002F Retry once\n    }\n    if (!res.ok) {\n      const body = await res.text();\n      throw new FlexportAPIError(res.status, body, path);\n    }\n    return res.json();\n  }\n}\n\nclass FlexportAPIError extends Error {\n  constructor(public status: number, public body: string, public path: string) {\n    super(`Flexport ${status} on ${path}: ${body}`);\n    this.name = 'FlexportAPIError';\n  }\n}\n```\n\n### Pattern 2: Paginated Iterator\n\n```typescript\n\u002F\u002F Iterate all pages of a Flexport list endpoint\nasync function* paginate\u003CT>(path: string, perPage = 25): AsyncGenerator\u003CT> {\n  const client = FlexportClient.getInstance();\n  let page = 1;\n  while (true) {\n    const separator = path.includes('?') ? '&' : '?';\n    const res = await client.request\u003C{ data: { records: T[]; total_count: number } }>(\n      `${path}${separator}page=${page}&per=${perPage}`\n    );\n    for (const record of res.data.records) yield record;\n    if (res.data.records.length \u003C perPage) break;\n    page++;\n  }\n}\n\n\u002F\u002F Usage: iterate all shipments\nfor await (const shipment of paginate\u003CShipment>('\u002Fshipments')) {\n  console.log(shipment.id, shipment.status);\n}\n```\n\n### Pattern 3: Zod Response Validation\n\n```typescript\nconst ShipmentSchema = z.object({\n  id: z.string(),\n  status: z.enum(['booked', 'in_transit', 'arrived', 'delivered']),\n  freight_type: z.enum(['ocean', 'air', 'trucking']),\n  origin_port: z.object({ code: z.string(), name: z.string() }),\n  destination_port: z.object({ code: z.string(), name: z.string() }),\n  cargo_ready_date: z.string(),\n  estimated_arrival_date: z.string().nullable(),\n});\n\ntype Shipment = z.infer\u003Ctypeof ShipmentSchema>;\n\nasync function getShipment(id: string): Promise\u003CShipment> {\n  const client = FlexportClient.getInstance();\n  const res = await client.request\u003C{ data: unknown }>(`\u002Fshipments\u002F${id}`);\n  return ShipmentSchema.parse(res.data);  \u002F\u002F Throws ZodError on mismatch\n}\n```\n\n### Pattern 4: Python Typed Client\n\n```python\nimport os, requests\nfrom dataclasses import dataclass\nfrom typing import Iterator\n\n@dataclass\nclass Shipment:\n    id: str\n    status: str\n    freight_type: str\n\nclass FlexportClient:\n    BASE = 'https:\u002F\u002Fapi.flexport.com'\n\n    def __init__(self):\n        self.session = requests.Session()\n        self.session.headers.update({\n            'Authorization': f'Bearer {os.environ[\"FLEXPORT_API_KEY\"]}',\n            'Flexport-Version': '2',\n        })\n\n    def list_shipments(self, per: int = 25) -> Iterator[Shipment]:\n        page = 1\n        while True:\n            r = self.session.get(f'{self.BASE}\u002Fshipments', params={'page': page, 'per': per})\n            r.raise_for_status()\n            records = r.json()['data']['records']\n            for rec in records:\n                yield Shipment(id=rec['id'], status=rec['status'], freight_type=rec['freight_type'])\n            if len(records) \u003C per:\n                break\n            page += 1\n```\n\n## Error Handling\n\n| Pattern | Use Case | Benefit |\n|---------|----------|---------|\n| Singleton | All API calls | One instance, consistent config |\n| Paginator | List endpoints | No data loss from pagination |\n| Zod validation | Response parsing | Catches API contract changes early |\n| Error class | All failures | Structured error data for logging |\n\n## Resources\n\n- [Flexport API Reference](https:\u002F\u002Fapidocs.flexport.com\u002F)\n- [Zod Documentation](https:\u002F\u002Fzod.dev\u002F)\n\n## Next Steps\n\nApply patterns in `flexport-core-workflow-a` for real-world usage.\n","# Flexport SDK Patterns\n\n## Overview\n\nProduction-ready patterns for the Flexport REST API v2. Since Flexport has no official npm\u002Fpip SDK, you build typed HTTP clients. Key patterns: singleton client, paginated iteration, retry wrapper, and Zod response validation.\n\n## Instructions\n\n### Pattern 1: Singleton Client with Auto-Retry\n\n```typescript\n\u002F\u002F src\u002Fflexport\u002Fclient.ts\nimport { z } from 'zod';\n\nclass FlexportClient {\n  private static instance: FlexportClient | null = null;\n  private base = 'https:\u002F\u002Fapi.flexport.com';\n  private headers: Record\u003Cstring, string>;\n\n  private constructor(apiKey: string) {\n    this.headers = {\n      'Authorization': `Bearer ${apiKey}`,\n      'Flexport-Version': '2',\n      'Content-Type': 'application\u002Fjson',\n    };\n  }\n\n  static getInstance(): FlexportClient {\n    if (!this.instance) {\n      const key = process.env.FLEXPORT_API_KEY;\n      if (!key) throw new Error('Missing FLEXPORT_API_KEY');\n      this.instance = new FlexportClient(key);\n    }\n    return this.instance;\n  }\n\n  async request\u003CT>(path: string, options: RequestInit = {}): Promise\u003CT> {\n    const res = await fetch(`${this.base}${path}`, { ...options, headers: { ...this.headers, ...options.headers } });\n    if (res.status === 429) {\n      const retryAfter = parseInt(res.headers.get('Retry-After') || '60');\n      await new Promise(r => setTimeout(r, retryAfter * 1000));\n      return this.request(path, options);  \u002F\u002F Retry once\n    }\n    if (!res.ok) {\n      const body = await res.text();\n      throw new FlexportAPIError(res.status, body, path);\n    }\n    return res.json();\n  }\n}\n\nclass FlexportAPIError extends Error {\n  constructor(public status: number, public body: string, public path: string) {\n    super(`Flexport ${status} on ${path}: ${body}`);\n    this.name = 'FlexportAPIError';\n  }\n}\n```\n\n### Pattern 2: Paginated Iterator\n\n```typescript\n\u002F\u002F Iterate all pages of a Flexport list endpoint\nasync function* paginate\u003CT>(path: string, perPage = 25): AsyncGenerator\u003CT> {\n  const client = FlexportClient.getInstance();\n  let page = 1;\n  while (true) {\n    const separator = path.includes('?') ? '&' : '?';\n    const res = await client.request\u003C{ data: { records: T[]; total_count: number } }>(\n      `${path}${separator}page=${page}&per=${perPage}`\n    );\n    for (const record of res.data.records) yield record;\n    if (res.data.records.length \u003C perPage) break;\n    page++;\n  }\n}\n\n\u002F\u002F Usage: iterate all shipments\nfor await (const shipment of paginate\u003CShipment>('\u002Fshipments')) {\n  console.log(shipment.id, shipment.status);\n}\n```\n\n### Pattern 3: Zod Response Validation\n\n```typescript\nconst ShipmentSchema = z.object({\n  id: z.string(),\n  status: z.enum(['booked', 'in_transit', 'arrived', 'delivered']),\n  freight_type: z.enum(['ocean', 'air', 'trucking']),\n  origin_port: z.object({ code: z.string(), name: z.string() }),\n  destination_port: z.object({ code: z.string(), name: z.string() }),\n  cargo_ready_date: z.string(),\n  estimated_arrival_date: z.string().nullable(),\n});\n\ntype Shipment = z.infer\u003Ctypeof ShipmentSchema>;\n\nasync function getShipment(id: string): Promise\u003CShipment> {\n  const client = FlexportClient.getInstance();\n  const res = await client.request\u003C{ data: unknown }>(`\u002Fshipments\u002F${id}`);\n  return ShipmentSchema.parse(res.data);  \u002F\u002F Throws ZodError on mismatch\n}\n```\n\n### Pattern 4: Python Typed Client\n\n```python\nimport os, requests\nfrom dataclasses import dataclass\nfrom typing import Iterator\n\n@dataclass\nclass Shipment:\n    id: str\n    status: str\n    freight_type: str\n\nclass FlexportClient:\n    BASE = 'https:\u002F\u002Fapi.flexport.com'\n\n    def __init__(self):\n        self.session = requests.Session()\n        self.session.headers.update({\n            'Authorization': f'Bearer {os.environ[\"FLEXPORT_API_KEY\"]}',\n            'Flexport-Version': '2',\n        })\n\n    def list_shipments(self, per: int = 25) -> Iterator[Shipment]:\n        page = 1\n        while True:\n            r = self.session.get(f'{self.BASE}\u002Fshipments', params={'page': page, 'per': per})\n            r.raise_for_status()\n            records = r.json()['data']['records']\n            for rec in records:\n                yield Shipment(id=rec['id'], status=rec['status'], freight_type=rec['freight_type'])\n            if len(records) \u003C per:\n                break\n            page += 1\n```\n\n## Error Handling\n\n| Pattern | Use Case | Benefit |\n|---------|----------|---------|\n| Singleton | All API calls | One instance, consistent config |\n| Paginator | List endpoints | No data loss from pagination |\n| Zod validation | Response parsing | Catches API contract changes early |\n| Error class | All failures | Structured error data for logging |\n\n## Resources\n\n- [Flexport API Reference](https:\u002F\u002Fapidocs.flexport.com\u002F)\n- [Zod Documentation](https:\u002F\u002Fzod.dev\u002F)\n\n## Next Steps\n\nApply patterns in `flexport-core-workflow-a` for real-world usage.\n",{"name":5,"tags":24,"author":28,"license":15,"version":29,"description":30,"allowed-tools":31,"compatible-with":32},[25,26,27],"saas","logistics","flexport","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Apply production-ready Flexport API patterns for TypeScript and Python.\nUse when building typed HTTP clients, implementing pagination,\nor establishing team coding standards for Flexport logistics integration.\nTrigger: \"flexport SDK patterns\", \"flexport best practices\", \"flexport client wrapper\".\n","Read, Write, Edit","claude-code","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--flexport-pack--flexport-sdk-patterns",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill flexport-sdk-patterns",{"tool":48,"command":49},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill flexport-sdk-patterns",{"tool":51,"command":52},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill flexport-sdk-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--flexport-pack--flexport-sdk-patterns\u002FSKILL.md",true,[],[57,64,71,78,85,93],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":89,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]