flexport-local-dev-loop

# Flexport Local Dev Loop ## Overview Set up a fast, reproducible local development workflow for Flexport integrations. Since Flexport has no official SDK, the dev loop centers on a typed HTTP client wrapper with mock responses for testing. ## Instructions ### Step 1: Project Structure ``` flexport-integration/ ├── src/ │ ├── flexport/ │ │ ├── client.ts # Typed Flexport API client │ │ ├── types.ts # API response types │ │ └── mock-data.ts # Test fixtures │ └── index.ts ├── tests/ │ ├── flexport.test.ts # Unit tests with mocks │ └── integration.test.ts # Live API tests (CI only) ├── .env.local # Local secrets (git-ignored) ├── .env.example └── package.json ``` ### Step 2: Typed Client Wrapper ```typescript // src/flexport/types.ts interface FlexportShipment { id: string; status: 'booked' | 'in_transit' | 'arrived' | 'delivered'; freight_type: 'ocean' | 'air' | 'trucking'; origin_port: { code: string; name: string }; destination_port: { code: string; name: string }; cargo_ready_date: string; estimated_arrival_date: string; } interface FlexportResponse<T> { data: { records: T[]; total_count: number }; } // src/flexport/client.ts export class FlexportClient { private base = 'https://api.flexport.com'; private headers: Record<string, string>; constructor(apiKey: string) { this.headers = { 'Authorization': `Bearer ${apiKey}`, 'Flexport-Version': '2', 'Content-T...