webflow-sdk-patterns

# Webflow SDK Patterns ## Overview Production-ready patterns for the `webflow-api` SDK (v3.x). Covers singleton client, typed error handling, pagination, raw response headers, and multi-tenant factory. ## Prerequisites - `webflow-api` v3.x installed - TypeScript 5+ project - Familiarity with async/await and the Webflow Data API v2 ## Instructions ### Pattern 1: Singleton Client with Configuration ```typescript // src/webflow/client.ts import { WebflowClient } from "webflow-api"; interface WebflowConfig { accessToken: string; timeout?: number; // Request timeout in ms (default: SDK default) maxRetries?: number; // Auto-retry on 429/5xx (default: 2) } let instance: WebflowClient | null = null; export function getWebflowClient(config?: Partial<WebflowConfig>): WebflowClient { if (!instance) { const token = config?.accessToken || process.env.WEBFLOW_API_TOKEN; if (!token) throw new Error("WEBFLOW_API_TOKEN required"); instance = new WebflowClient({ accessToken: token, // The SDK supports timeout and maxRetries natively ...(config?.timeout && { timeout: config.timeout }), ...(config?.maxRetries !== undefined && { maxRetries: config.maxRetries }), }); } return instance; } // Reset client (useful for token rotation) export function resetWebflowClient(): void { instance = null; } ``` ### Pattern 2: Typed Error Handling The SDK throws `WebflowError` subclasses. Handle them by type: ```typescript import { WebflowCli...