flexport-sdk-patterns

# Flexport SDK Patterns ## Overview Production-ready patterns for the Flexport REST API v2. Since Flexport has no official npm/pip SDK, you build typed HTTP clients. Key patterns: singleton client, paginated iteration, retry wrapper, and Zod response validation. ## Instructions ### Pattern 1: Singleton Client with Auto-Retry ```typescript // src/flexport/client.ts import { z } from 'zod'; class FlexportClient { private static instance: FlexportClient | null = null; private base = 'https://api.flexport.com'; private headers: Record<string, string>; private constructor(apiKey: string) { this.headers = { 'Authorization': `Bearer ${apiKey}`, 'Flexport-Version': '2', 'Content-Type': 'application/json', }; } static getInstance(): FlexportClient { if (!this.instance) { const key = process.env.FLEXPORT_API_KEY; if (!key) throw new Error('Missing FLEXPORT_API_KEY'); this.instance = new FlexportClient(key); } return this.instance; } async request<T>(path: string, options: RequestInit = {}): Promise<T> { const res = await fetch(`${this.base}${path}`, { ...options, headers: { ...this.headers, ...options.headers } }); if (res.status === 429) { const retryAfter = parseInt(res.headers.get('Retry-After') || '60'); await new Promise(r => setTimeout(r, retryAfter * 1000)); return this.request(path, options); // Retry once } if (!res.ok) { const body = await res.text(); ...