gamma-debug-bundle

Gamma Debug Bundle

Contents

• Overview
• Prerequisites
• Instructions
• Output
• Error Handling
• Examples
• Resources

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

• Gamma Debug Guide
• Gamma Support Portal

Next Steps

Proceed to gamma-rate-limits for rate limit management.