hubspot-reliability-patterns

# HubSpot Reliability Patterns ## Overview Production-grade reliability patterns for HubSpot CRM integrations: circuit breaker, retry with Retry-After, graceful degradation, and dead letter queues. ## Prerequisites - `@hubspot/api-client` installed (has built-in retry) - Optional: `opossum` for circuit breaker - Optional: Redis or database for dead letter queue ## Instructions ### Step 1: SDK Built-in Retry (First Line of Defense) ```typescript import * as hubspot from '@hubspot/api-client'; // The SDK automatically retries 429 and 5xx errors const client = new hubspot.Client({ accessToken: process.env.HUBSPOT_ACCESS_TOKEN!, numberOfApiCallRetries: 3, // retries with exponential backoff }); // This handles most transient failures automatically ``` ### Step 2: Circuit Breaker for HubSpot API ```typescript import CircuitBreaker from 'opossum'; // Circuit breaker wrapping all HubSpot API calls const hubspotBreaker = new CircuitBreaker( async <T>(operation: () => Promise<T>): Promise<T> => operation(), { timeout: 15000, // 15s timeout per call errorThresholdPercentage: 50, // open after 50% failure rate resetTimeout: 30000, // try again after 30s volumeThreshold: 5, // need 5+ calls before evaluating rollingCountTimeout: 60000, // 60s rolling window } ); // Monitor circuit state hubspotBreaker.on('open', () => { console.warn('[HubSpot] Circuit OPEN -- requests failing fast'); // Alert team: Hub...