Error Handling

{
  "error": "Error type",
  "message": "Detailed error description",
  "details": {
    "field": "Additional context"
  }
}

{
  "error": "Unauthorized: Invalid API key"
}

{
  "error": "text is required"
}

{
  "error": "Ruleset 'custom_ruleset' not found"
}

{
  "error": "Input too long: maximum 5000 characters allowed"
}

{
  "error": "Rate limit exceeded",
  "message": "Daily rate limit of 1000 requests exceeded",
  "rateLimit": {
    "dailyRemaining": 0,
    "monthlyRemaining": 28500,
    "resetTime": "2025-01-15T00:00:00Z"
  }
}

async function safeApiCall(requestData, maxRetries = 3) {
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    try {
      const response = await fetch("/api/ult", {
        method: "POST",
        headers: {
          "x-api-key": "your-api-key",
          "Content-Type": "application/json",
        },
        body: JSON.stringify(requestData),
      });

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

      if (response.status === 429 && attempt < maxRetries) {
        // Exponential backoff for rate limits
        await sleep(2 ** attempt * 1000);
        continue;
      }

      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
    } catch (error) {
      if (attempt === maxRetries) throw error;
      await sleep(1000 * attempt); // Simple backoff
    }
  }
}

function validateRequest(text, ruleset) {
  const errors = [];

  if (!text || text.trim().length === 0) {
    errors.push("Text is required");
  }

  if (text.length > 5000) {
    errors.push("Text exceeds maximum length of 5000 characters");
  }

  if (!ruleset) {
    errors.push("Ruleset is required");
  }

  return errors;
}