lucidchart-sdk-patterns

# Lucidchart SDK Patterns ## Overview Lucid's REST API uses OAuth 2.0 with versioned `Lucid-Api-Version` headers to manage documents, pages, shapes, data-linked fields, and collaborative comments. A structured SDK client is essential because the API requires version negotiation on every request, returns deeply nested shape tree hierarchies, and enforces document-level locking for concurrent edits. These patterns provide OAuth token lifecycle management, typed shape and document models, fluent query building for filtered shape searches, and mock factories for diagramming test scenarios. ## Prerequisites - Node.js 18+, TypeScript 5+ - `LUCID_CLIENT_ID` and `LUCID_CLIENT_SECRET` environment variables (OAuth 2.0 app credentials) - `LUCID_ACCESS_TOKEN` or refresh token flow for per-user access - `axios` or `node-fetch` for HTTP transport ## Singleton Client ```typescript interface LucidConfig { clientId: string; clientSecret: string; accessToken: string; apiVersion?: string; baseUrl?: string; } let client: LucidClient | null = null; export function getLucidClient(overrides?: Partial<LucidConfig>): LucidClient { if (!client) { const config: LucidConfig = { clientId: process.env.LUCID_CLIENT_ID ?? '', clientSecret: process.env.LUCID_CLIENT_SECRET ?? '', accessToken: process.env.LUCID_ACCESS_TOKEN ?? '', apiVersion: '2', baseUrl: 'https://api.lucid.co', ...overrides, }; if (!config.accessToken) throw new Error('LUCID_AC...