gamma-webhooks-events

# Gamma Webhooks & Events ## Overview Gamma's public API (v1.0) is generation-focused and does not expose a traditional webhook system at time of writing. Instead, use the **poll-based pattern** (GET `/v1.0/generations/{id}`) to detect completion. For event-driven architectures, wrap polling in a background worker that emits application-level events when generations complete or fail. ## Prerequisites - Completed `gamma-sdk-patterns` setup - Event bus or message queue (Bull, RabbitMQ, or EventEmitter) - Understanding of the generate-poll-retrieve pattern ## Gamma Event Model (Application-Level) Since Gamma does not push events, you create them by polling: | Synthetic Event | Trigger Condition | Use Case | |-----------------|-------------------|----------| | `generation.started` | POST `/generations` returns `generationId` | Log, notify user | | `generation.completed` | Poll returns `status: "completed"` | Download export, update DB | | `generation.failed` | Poll returns `status: "failed"` | Alert, retry, notify user | | `generation.timeout` | Poll exceeds max duration | Alert, escalate | ## Instructions ### Step 1: Event Emitter Pattern ```typescript // src/gamma/events.ts import { EventEmitter } from "events"; import { createGammaClient } from "./client"; export const gammaEvents = new EventEmitter(); export interface GenerationEvent { generationId: string; status: "started" | "completed" | "failed" | "timeout"; gammaUrl?: string; exportUrl?: string; cre...