Error Codes Reference

async function processWithRetry(url, formData, maxRetries = 3) {
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    try {
      const response = await fetch(url, {
        method: 'POST',
        headers: { 'Authorization': 'Bearer pk_live_...' },
        body: formData
      });
      
      if (response.ok) {
        return await response.blob();
      }
      
      const error = await response.json();
      
      // Don't retry client errors (4xx)
      if (response.status >= 400 && response.status < 500) {
        throw new Error(`Client error: ${error.message}`);
      }
      
      // Retry server errors (5xx) and rate limits (429)
      if (attempt === maxRetries) {
        throw new Error(`Max retries exceeded: ${error.message}`);
      }
      
      // Exponential backoff
      const delay = Math.pow(2, attempt) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
      
    } catch (err) {
      if (attempt === maxRetries) throw err;
    }
  }
}

async function handleApiResponse(response) {
  if (response.ok) {
    return await response.blob();
  }
  
  const error = await response.json();
  
  switch (response.status) {
    case 400:
      throw new ValidationError(error.message, error.details);
    case 401:
      throw new AuthenticationError('Invalid API key');
    case 402:
      throw new PaymentError('Insufficient balance', error.details);
    case 403:
      throw new PermissionError('Access forbidden');
    case 413:
      throw new FileSizeError('File too large');
    case 422:
      throw new ProcessingError('Cannot process file', error.details);
    case 429:
      throw new RateLimitError('Rate limit exceeded', error.details);
    case 500:
      throw new ServerError('Server error', error.requestId);
    default:
      throw new ApiError(`HTTP ${response.status}: ${error.message}`);
  }
}

// Custom error classes for better error handling
class ValidationError extends Error {
  constructor(message, details) {
    super(message);
    this.name = 'ValidationError';
    this.details = details;
  }
}