documenso-sdk-patterns

# Documenso SDK Patterns ## Overview Production-ready patterns for the Documenso TypeScript SDK (`@documenso/sdk-typescript`) and Python SDK. Covers singleton clients, typed wrappers, error handling, retry logic, and testing patterns. ## Prerequisites - Completed `documenso-install-auth` setup - Familiarity with async/await and TypeScript generics - Understanding of error handling best practices ## Instructions ### Pattern 1: Singleton Client with Configuration ```typescript // src/documenso/client.ts import { Documenso } from "@documenso/sdk-typescript"; interface DocumensoConfig { apiKey: string; baseUrl?: string; timeout?: number; } let instance: Documenso | null = null; export function getDocumensoClient(config?: DocumensoConfig): Documenso { if (!instance) { const apiKey = config?.apiKey ?? process.env.DOCUMENSO_API_KEY; if (!apiKey) throw new Error("DOCUMENSO_API_KEY is required"); instance = new Documenso({ apiKey, ...(config?.baseUrl && { serverURL: config.baseUrl }), }); } return instance; } // Reset for testing export function resetClient(): void { instance = null; } ``` ### Pattern 2: Typed Document Service ```typescript // src/documenso/documents.ts import { getDocumensoClient } from "./client"; export interface CreateDocumentInput { title: string; pdfPath: string; signers: Array<{ email: string; name: string; fields: Array<{ type: "SIGNATURE" | "INITIALS" | "NAME" | "EMAIL" | "DATE" ...