Error Handling

async function handleApiResponse(response) {
  if (!response.ok) {
    const errorData = await response.json();
    
    switch (response.status) {
      case 401:
        throw new AuthenticationError(errorData.error.message);
      case 402:
        throw new InsufficientCreditsError(errorData.error.message);
      case 429:
        throw new RateLimitError(errorData.error.message, errorData.error.retryAfter);
      case 500:
        throw new ServerError(errorData.error.message);
      default:
        throw new ApiError(errorData.error.message, response.status);
    }
  }
  
  return response.json();
}

async function makeRequestWithRetry(url, options, maxRetries = 3) {
  const retryableStatuses = [429, 500, 502, 503, 504];
  
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      const response = await fetch(url, options);
      
      if (response.ok) {
        return await response.json();
      }
      
      if (!retryableStatuses.includes(response.status)) {
        throw new Error('Non-retryable error: ' + response.status);
      }
      
      if (attempt === maxRetries - 1) {
        throw new Error('Max retries exceeded');
      }
      
      const delay = Math.min(1000 * Math.pow(2, attempt), 10000);
      console.log(`Retrying in ${delay}ms (attempt ${attempt + 1})`);
      await new Promise(resolve => setTimeout(resolve, delay));
      
    } catch (error) {
      if (attempt === maxRetries - 1) throw error;
      await new Promise(resolve => setTimeout(resolve, 1000 * Math.pow(2, attempt)));
    }
  }
}

function logApiError(error, context) {
  const logData = {
    timestamp: new Date().toISOString(),
    context,
    error: {
      code: error.code,
      message: error.message,
      status: error.status
    }
  };
  
  switch (error.status) {
    case 401:
    case 402:
      // Authentication/billing issues - warn level
      console.warn('API authentication/billing error:', logData);
      break;
    case 429:
      // Rate limiting - info level (expected during high usage)
      console.info('API rate limit hit:', logData);
      break;
    case 500:
    case 502:
    case 503:
    case 504:
      // Server errors - error level
      console.error('API server error:', logData);
      break;
    default:
      // Client errors - debug level
      console.debug('API client error:', logData);
  }
}

function getUserFriendlyMessage(error) {
  const friendlyMessages = {
    INVALID_API_KEY: 'There was an authentication issue. Please check your API configuration.',
    INSUFFICIENT_CREDITS: 'You don\'t have enough credits to complete this request. Please add more credits to your account.',
    RATE_LIMIT_EXCEEDED: 'You\'re sending requests too quickly. Please wait a moment before trying again.',
    GENERATION_FAILED: 'We couldn\'t generate a lead magnet with the provided information. Please try with more detailed data.',
    INTERNAL_SERVER_ERROR: 'Something went wrong on our end. Please try again in a few moments.'
  };
  
  return friendlyMessages[error.code] || 'An unexpected error occurred. Please try again or contact support if the issue persists.';
}