attio-sdk-patterns

# Attio SDK Patterns ## Overview There is no official Attio Node.js SDK. The API is a clean REST/JSON interface at `https://api.attio.com/v2`. These patterns wrap `fetch` into a production-grade typed client with retry, pagination, and error normalization. ## Prerequisites - Node.js 18+ (native `fetch`) - TypeScript 5+ - Completed `attio-install-auth` ## Instructions ### Pattern 1: Typed Client with Error Normalization ```typescript // src/attio/client.ts const ATTIO_BASE = "https://api.attio.com/v2"; export class AttioApiError extends Error { constructor( public statusCode: number, public type: string, public code: string, message: string ) { super(message); this.name = "AttioApiError"; } get retryable(): boolean { return this.statusCode === 429 || this.statusCode >= 500; } } export class AttioClient { constructor(private apiKey: string) {} async request<T>( method: string, path: string, body?: Record<string, unknown> ): Promise<T> { const res = await fetch(`${ATTIO_BASE}${path}`, { method, headers: { Authorization: `Bearer ${this.apiKey}`, "Content-Type": "application/json", }, body: body ? JSON.stringify(body) : undefined, }); if (!res.ok) { const err = await res.json().catch(() => ({})); throw new AttioApiError( res.status, err.type || "unknown", err.code || "unknown", err.message || `HTTP ${res.status}` ...