apollo-sdk-patterns

# Apollo SDK Patterns ## Overview Production-ready patterns for Apollo.io API integration. Apollo has no official SDK — these patterns wrap the REST API (`https://api.apollo.io/api/v1/`) with type safety, retry logic, pagination, and bulk operations. All requests use the `x-api-key` header. ## Prerequisites - Completed `apollo-install-auth` setup - TypeScript 5+ with strict mode ## Instructions ### Step 1: Type-Safe Client with Zod Validation ```typescript // src/apollo/client.ts import axios, { AxiosInstance } from 'axios'; import { z } from 'zod'; const ConfigSchema = z.object({ apiKey: z.string().min(10, 'API key too short'), baseURL: z.string().url().default('https://api.apollo.io/api/v1'), timeout: z.number().default(30_000), }); let instance: AxiosInstance | null = null; export function getApolloClient(config?: Partial<z.input<typeof ConfigSchema>>): AxiosInstance { if (instance) return instance; const parsed = ConfigSchema.parse({ apiKey: config?.apiKey ?? process.env.APOLLO_API_KEY, ...config, }); instance = axios.create({ baseURL: parsed.baseURL, timeout: parsed.timeout, headers: { 'Content-Type': 'application/json', 'x-api-key': parsed.apiKey, }, }); return instance; } // Reset for testing export function resetClient() { instance = null; } ``` ### Step 2: Custom Error Classes ```typescript // src/apollo/errors.ts import { AxiosError } from 'axios'; export class ApolloApiError extends Error { constr...