figma-sdk-patterns

# Figma SDK Patterns ## Overview Production patterns for the Figma REST API (external tools) and Plugin API (in-editor plugins). Figma has no official Node.js SDK -- you call `https://api.figma.com` directly with `fetch`. These patterns give you type safety, error handling, and reusable abstractions. ## Prerequisites - `FIGMA_PAT` environment variable set - TypeScript 5+ project - Understanding of Figma node types ## Instructions ### Step 1: Typed REST API Client ```typescript // src/figma-client.ts export class FigmaClient { private baseUrl = 'https://api.figma.com'; constructor(private token: string) { if (!token) throw new Error('Figma token is required'); } private async request<T>(path: string, init?: RequestInit): Promise<T> { const res = await fetch(`${this.baseUrl}${path}`, { ...init, headers: { 'X-Figma-Token': this.token, 'Content-Type': 'application/json', ...init?.headers, }, }); if (res.status === 429) { const retryAfter = parseInt(res.headers.get('Retry-After') || '60'); throw new FigmaRateLimitError(retryAfter); } if (res.status === 403) throw new FigmaAuthError('Invalid or expired token'); if (res.status === 404) throw new FigmaNotFoundError(path); if (!res.ok) throw new FigmaApiError(res.status, await res.text()); return res.json(); } async getFile(fileKey: string) { return this.request<FigmaFileResponse>(`/v1/files/${fileKey}`); } async get...