juicebox-rate-limits

# Juicebox Rate Limits ## Overview Juicebox's AI-powered data analysis API enforces plan-tiered rate limits across dataset uploads, analysis triggers, and result retrieval. Heavy analytical workloads like running comparative analyses across multiple datasets or batch-processing survey results hit the analysis trigger limit first. The enrichment endpoints for augmenting datasets with external data sources have separate, lower caps, making it essential to prioritize enrichment calls and batch analysis runs during off-peak windows. ## Rate Limit Reference | Endpoint | Limit | Window | Scope | |----------|-------|--------|-------| | Dataset upload | 20 req | 1 minute | Per API key | | Analysis trigger | 30 req | 1 minute | Per API key | | Result retrieval | 120 req | 1 minute | Per API key | | Data enrichment | 15 req | 1 minute | Per API key | | Export download | 10 req | 1 minute | Per API key | ## Rate Limiter Implementation ```typescript class JuiceboxRateLimiter { private tokens: number; private lastRefill: number; private readonly max: number; private readonly refillRate: number; private queue: Array<{ resolve: () => void }> = []; constructor(maxPerMinute: number) { this.max = maxPerMinute; this.tokens = maxPerMinute; this.lastRefill = Date.now(); this.refillRate = maxPerMinute / 60_000; } async acquire(): Promise<void> { this.refill(); if (this.tokens >= 1) { this.tokens -= 1; return; } return new Promise(resolve => this....