fireflies-sdk-patterns

# Fireflies.ai Client Patterns ## Overview Production-ready patterns for the Fireflies.ai GraphQL API. Fireflies has no official SDK -- all interaction is via HTTP POST to `https://api.fireflies.ai/graphql`. These patterns provide typed wrappers, error handling, caching, and multi-tenant support. ## Prerequisites - `FIREFLIES_API_KEY` environment variable set - TypeScript 5+ or Python 3.10+ - Optional: `graphql-request` for typed queries ## Instructions ### Step 1: Typed GraphQL Client (TypeScript) ```typescript // lib/fireflies-client.ts const FIREFLIES_API = "https://api.fireflies.ai/graphql"; interface FirefliesError { message: string; code?: string; extensions?: { status: number; helpUrls?: string[] }; } interface FirefliesResponse<T> { data?: T; errors?: FirefliesError[]; } export class FirefliesClient { private apiKey: string; private baseUrl: string; constructor(apiKey?: string) { this.apiKey = apiKey || process.env.FIREFLIES_API_KEY!; this.baseUrl = FIREFLIES_API; if (!this.apiKey) throw new Error("FIREFLIES_API_KEY is required"); } async query<T = any>(gql: string, variables?: Record<string, any>): Promise<T> { const res = await fetch(this.baseUrl, { method: "POST", headers: { "Content-Type": "application/json", Authorization: `Bearer ${this.apiKey}`, }, body: JSON.stringify({ query: gql, variables }), }); const json: FirefliesResponse<T> = await res.json(); if (json.er...