Error handling

import {
  BabySea,
  BabySeaError,
  BabySeaTimeoutError,
  BabySeaRetryError,
} from 'babysea';

const client = new BabySea({ apiKey: 'bye_...', region: 'us' });

try {
  await client.generate('google/nano-banana', {
    generation_prompt: 'A cute baby seal',
  });
} catch (err) {
  if (err instanceof BabySeaError) {
    console.log(err.status);     // 402
    console.log(err.code);       // 'BSE1004'
    console.log(err.type);       // 'insufficient_credits'
    console.log(err.message);    // human-readable description
    console.log(err.retryable);  // false
    console.log(err.requestId);  // request trace ID

    // Rate limit info (present on 429 responses)
    if (err.rateLimit) {
      console.log(err.rateLimit.limit);
      console.log(err.rateLimit.remaining);
      console.log(err.rateLimit.reset);
      console.log(err.rateLimit.retryAfter);
    }

    // Provider-level errors (when failover occurred)
    if (err.body.error.provider_errors) {
      for (const pe of err.body.error.provider_errors) {
        console.log(pe.provider); // 'replicate' | 'fal' | 'byteplus' | 'cloudflare'
        console.log(pe.code);
        console.log(pe.message);
      }
    }
  }

  if (err instanceof BabySeaTimeoutError) {
    console.log(err.message); // 'Request timed out after 30000ms'
  }

  if (err instanceof BabySeaRetryError) {
    console.log(err.attempts);              // total attempts made
    console.log(err.lastError.status);      // HTTP status of the last attempt
    console.log(err.lastError.code);        // BSE error code of the last attempt
  }
}

// Disable retries
const client = new BabySea({ apiKey: 'bye_...', region: 'us', maxRetries: 0 });

// More retries for batch jobs
const client = new BabySea({ apiKey: 'bye_...', region: 'us', maxRetries: 5 });