canva-reliability-patterns

# Canva Reliability Patterns ## Overview Production-grade reliability patterns for the Canva Connect API. The API has async operations (exports, uploads, autofills) that can fail or timeout, OAuth tokens that expire every 4 hours, and rate limits that require backoff. ## Circuit Breaker ```typescript import CircuitBreaker from 'opossum'; const canvaBreaker = new CircuitBreaker( async (fn: () => Promise<any>) => fn(), { timeout: 30000, // 30s before failure errorThresholdPercentage: 50, // Open after 50% failure rate resetTimeout: 60000, // Try again after 60s volumeThreshold: 5, // Min 5 requests before evaluating } ); canvaBreaker.on('open', () => { console.warn('[canva] Circuit OPEN — Canva API unreachable, failing fast'); }); canvaBreaker.on('halfOpen', () => { console.info('[canva] Circuit HALF-OPEN — testing Canva recovery'); }); canvaBreaker.on('close', () => { console.info('[canva] Circuit CLOSED — Canva API recovered'); }); // Usage async function createDesignSafe(body: object, token: string) { return canvaBreaker.fire(async () => { return canvaAPI('/designs', token, { method: 'POST', body: JSON.stringify(body), }); }); } ``` ## Graceful Degradation ```typescript // When Canva is down, degrade gracefully instead of breaking the entire app async function getDesignWithFallback( designId: string, token: string, cache: LRUCache<string, any> ): Promise<{ data: any; source: ...