Comprehensive debugging toolkit for systematic troubleshooting of Gamma integration issues including request tracing, environment checks, and exportable debug bundles.
Wrap GammaClient with request/response/error interceptors that log method, path, duration, status, and full payloads.
Sequential tests: authentication (ping), API access (list presentations), generation (dry-run create), and rate limit status check.
Verify GAMMA_API_KEY is set, NODE_ENV is correct, and Node.js version is compatible.
Package environment info, request logs, and config into a JSON file for sharing with support.
See detailed implementation for debug client with interceptors, diagnostic script, environment checker, and bundle export code.
| Error | Cause | Solution |
|---|---|---|
| Auth test fails | Invalid API key | Verify GAMMA_API_KEY env var |
| List returns empty | No presentations | Create test presentation first |
| Generation fails | Rate limit or quota | Check rate limit status |
| Timeout errors | Network issues | Check connectivity to gamma.app |
npx ts-node debug/diagnose.ts
# Output: 4 tests with pass/fail and request log summary
Proceed to gamma-rate-limits for rate limit management.