instantly-performance-tuning

# Instantly Performance Tuning ## Overview Optimize Instantly API v2 integrations for speed and throughput. Key areas: caching analytics data, batching lead operations, concurrent request management, efficient pagination, and connection reuse. The email listing endpoint has a strict **20 req/min** limit that requires special handling. ## Prerequisites - Completed `instantly-install-auth` setup - Working Instantly integration - Understanding of async patterns and caching strategies ## Instructions ### Step 1: Cache Analytics Data Campaign analytics don't change every second — cache them for 5-15 minutes to avoid redundant API calls. ```typescript class InstantlyCache { private cache = new Map<string, { data: unknown; expiry: number }>(); get<T>(key: string): T | null { const entry = this.cache.get(key); if (!entry || Date.now() > entry.expiry) { this.cache.delete(key); return null; } return entry.data as T; } set(key: string, data: unknown, ttlMs: number) { this.cache.set(key, { data, expiry: Date.now() + ttlMs }); } } const cache = new InstantlyCache(); async function getCachedAnalytics(campaignId: string) { const cacheKey = `analytics:${campaignId}`; const cached = cache.get<CampaignAnalytics>(cacheKey); if (cached) return cached; const data = await instantly<CampaignAnalytics>( `/campaigns/analytics?id=${campaignId}` ); cache.set(cacheKey, data, 5 * 60 * 1000); // 5 min TTL return data; } // Cache campai...