instantly-sdk-patterns

# Instantly SDK Patterns ## Overview Production-ready patterns for Instantly API v2 integrations. Instantly has no official SDK — all integrations use direct REST calls to `https://api.instantly.ai/api/v2/`. These patterns provide type safety, retry logic, pagination, and multi-tenant support. ## Prerequisites - Completed `instantly-install-auth` setup - Familiarity with async/await and TypeScript generics - Understanding of REST API pagination patterns ## Instructions ### Step 1: Type-Safe Client with Error Classification ```typescript // src/instantly/client.ts import "dotenv/config"; export class InstantlyClient { private baseUrl: string; private apiKey: string; constructor(options?: { apiKey?: string; baseUrl?: string }) { this.apiKey = options?.apiKey || process.env.INSTANTLY_API_KEY || ""; this.baseUrl = options?.baseUrl || "https://api.instantly.ai/api/v2"; if (!this.apiKey) throw new Error("INSTANTLY_API_KEY is required"); } async request<T>(path: string, options: RequestInit = {}): Promise<T> { const url = `${this.baseUrl}${path}`; const res = await fetch(url, { ...options, headers: { "Content-Type": "application/json", Authorization: `Bearer ${this.apiKey}`, ...options.headers, }, }); if (!res.ok) { const body = await res.text(); throw new InstantlyApiError(res.status, path, body); } return res.json() as Promise<T>; } // Typed convenience methods async...