gamma-performance-tuning

Gamma Performance Tuning

Contents

Overview

Optimize Gamma API integration performance through client configuration, caching, connection pooling, and parallel request patterns.

Prerequisites

Instructions

Step 1: Optimize Client Configuration

Enable keep-alive, compression, and configure max sockets (10). Set retry conditions for 5xx and 429 errors.

Step 2: Implement Response Caching

Use node-cache with 5-minute TTL. Invalidate on presentation.updated events.

Step 3: Parallelize Requests

Replace sequential loops with p-limit (concurrency 5) for bulk operations. Use batch API where available.

Step 4: Add Pagination with Generators

Use async generators for memory-efficient iteration over large presentation lists.

Step 5: Optimize Request Payloads

Request only needed fields to reduce response size. Use returnImmediately for creation operations.

Step 6: Configure Connection Pooling

Create shared HTTP/HTTPS agents with keep-alive, 25 max sockets, and 60s timeout.

See detailed implementation for advanced patterns.

Output

Error Handling

Issue Cause Solution

High latency No connection reuse Enable keep-alive and pooling

Memory growth Unbounded cache Set TTL and max cache size

Rate limiting Too many parallel requests Use p-limit with concurrency cap

Examples

Performance Targets

Operation Target Action if Exceeded

Simple GET < 200ms Check network, use caching

List (100 items) < 500ms Reduce page size

Create presentation < 5s Use async pattern

Export PDF < 30s Use webhook notification

Resources

Source Transparency