Rate Limits

// Rate limit headers in API responses
{
  'x-ratelimit-limit': '100',        // Maximum requests allowed
  'x-ratelimit-remaining': '95',     // Remaining requests in window
  'x-ratelimit-reset': '1640995200', // Unix timestamp when limit resets
  'retry-after': '60'                // Seconds to wait before retrying (if exceeded)
}

// Check rate limit status
async function checkRateLimit() {
  const response = await fetch('https://api.metigan.com/v1/emails', {
    headers: {
      'Authorization': `Bearer ${apiKey}`
    }
  });

  const limit = response.headers.get('x-ratelimit-limit');
  const remaining = response.headers.get('x-ratelimit-remaining');
  const reset = response.headers.get('x-ratelimit-reset');

  console.log(`Rate limit: ${remaining}/${limit}`);
  console.log(`Resets at: ${new Date(parseInt(reset!) * 1000).toLocaleString()}`);
}

import Metigan from 'metigan';

async function sendEmailWithRateLimitHandling() {
  try {
    const result = await metigan.email.sendEmail({
      from: 'sender@example.com',
      recipients: ['recipient@example.com'],
      subject: 'Test',
      content: '<p>Hello</p>'
    });

    if ('success' in result && result.success) {
      return result;
    }

    // Handle rate limit error
    if ('error' in result && result.error === 'rate_limit_exceeded') {
      const retryAfter = result.retryAfter || 60; // Default to 60 seconds
      
      console.log(`Rate limit exceeded. Retrying after ${retryAfter} seconds...`);
      
      // Wait and retry
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      
      // Retry the request
      return await metigan.email.sendEmail({
        from: 'sender@example.com',
        recipients: ['recipient@example.com'],
        subject: 'Test',
        content: '<p>Hello</p>'
      });
    }

    return result;
  } catch (error) {
    console.error('Error:', error);
    throw error;
  }
}