fondo-sdk-patterns

# Fondo SDK Patterns ## Overview Production-ready patterns for integrating with Fondo tax and accounting data. Fondo is a managed bookkeeping platform that syncs through QuickBooks Online and payroll providers. Integration uses the `FONDO_API_KEY`-authenticated REST endpoints for exports, the QuickBooks Online API for GL data, and structured CSV parsing with Zod validation for bulk imports. ## Singleton Client ```typescript const FONDO_BASE = 'https://api.fondo.com/v1'; let _client: FondoClient | null = null; export function getClient(): FondoClient { if (!_client) { const apiKey = process.env.FONDO_API_KEY; if (!apiKey) throw new Error('FONDO_API_KEY must be set — get it from your Fondo dashboard'); _client = new FondoClient(apiKey); } return _client; } class FondoClient { private headers: Record<string, string>; constructor(apiKey: string) { this.headers = { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' }; } async getTransactions(start: string, end: string): Promise<FondoTransaction[]> { const res = await fetch(`${FONDO_BASE}/transactions?start=${start}&end=${end}`, { headers: this.headers }); if (!res.ok) throw new FondoError(res.status, await res.text()); return res.json(); } async getAccounts(): Promise<FondoAccount[]> { const res = await fetch(`${FONDO_BASE}/accounts`, { headers: this.headers }); if (!res.ok) throw new FondoError(res.status, await res.text()); return res.json(); } } ``` ## Error ...