micsapp Gamma Debug Bundle
Contents
Overview
Comprehensive debugging toolkit for systematic troubleshooting of Gamma integration issues including request tracing, environment checks, and exportable debug bundles.
Prerequisites
- Active Gamma integration with issues
- Node.js 18+ for debug tools
- Access to application logs
Instructions
Step 1: Create Debug Client
Wrap GammaClient with request/response/error interceptors that log method, path, duration, status, and full payloads.
Step 2: Run Diagnostic Script
Sequential tests: authentication (ping), API access (list presentations), generation (dry-run create), and rate limit status check.
Step 3: Check Environment
Verify GAMMA_API_KEY is set, NODE_ENV is correct, and Node.js version is compatible.
Step 4: Export Debug Bundle
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.
Output
- Debug client with full request tracing
- Diagnostic report with pass/fail for each subsystem
- Environment verification report
- Exportable JSON debug bundle
Error Handling
| 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 |
Examples
Quick Diagnostic
npx ts-node debug/diagnose.ts
# Output: 4 tests with pass/fail and request log summary
Resources
Next Steps
Proceed to gamma-rate-limits for rate limit management.