miro-sdk-patterns

# Miro SDK Patterns ## Overview Production-ready patterns for the `@mirohq/miro-api` Node.js client and direct REST API v2 usage. Covers the high-level `Miro` client (stateful, OAuth-aware) and the low-level `MiroApi` client (stateless, token-based). ## Prerequisites - `@mirohq/miro-api` installed - TypeScript 5+ project - Understanding of Miro REST API v2 item model ## Two Client Modes ```typescript import { Miro, MiroApi } from '@mirohq/miro-api'; // HIGH-LEVEL: Stateful, manages OAuth tokens per user // Use for multi-user apps (SaaS, web apps with OAuth) const miro = new Miro({ clientId: process.env.MIRO_CLIENT_ID!, clientSecret: process.env.MIRO_CLIENT_SECRET!, redirectUrl: process.env.MIRO_REDIRECT_URI!, }); const userApi = await miro.as('user-id'); // Returns MiroApi scoped to user // LOW-LEVEL: Stateless, pass token directly // Use for scripts, automation, single-user integrations const api = new MiroApi(process.env.MIRO_ACCESS_TOKEN!); ``` ## Pattern 1: Type-Safe Board Service ```typescript // src/miro/board-service.ts import { MiroApi } from '@mirohq/miro-api'; // Response types matching Miro REST API v2 interface MiroBoard { id: string; type: 'board'; name: string; description: string; createdAt: string; modifiedAt: string; } interface MiroBoardItem { id: string; type: 'sticky_note' | 'shape' | 'card' | 'text' | 'frame' | 'image' | 'document' | 'embed' | 'app_card'; data: Record<string, unknown>; position: { x: number; y: numbe...