Rate Limits & Quotas

async function makeRequestWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    try {
      const response = await fetch(url, options);

      // Check rate limit headers
      const remaining = parseInt(response.headers.get('X-RateLimit-Remaining') || '0');
      const limit = parseInt(response.headers.get('X-RateLimit-Limit') || '1');

      // Log warning if approaching limit
      if (remaining < limit * 0.1) {
        console.warn(`Rate limit warning: ${remaining}/${limit} requests remaining`);
      }

      // Handle rate limit
      if (response.status === 429) {
        const retryAfter = parseInt(response.headers.get('Retry-After') || '60');

        if (attempt < maxRetries) {
          console.log(`Rate limited. Retrying after ${retryAfter}s...`);
          await sleep(retryAfter * 1000);
          continue;
        } else {
          throw new Error('Max retries exceeded');
        }
      }

      // Success
      if (response.ok) {
        return await response.json();
      }

      throw new Error(`HTTP ${response.status}: ${response.statusText}`);

    } catch (error) {
      if (attempt === maxRetries) throw error;

      // Exponential backoff for other errors
      const delay = Math.min(1000 * Math.pow(2, attempt), 30000);
      await sleep(delay);
    }
  }
}

function sleep(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

// Usage
const data = await makeRequestWithRetry('https://api.wave.inc/v1/streams', {
  headers: {
    'Authorization': `Bearer ${API_KEY}`
  }
});