Error Handling

import { AuthError } from '@mira.network/gatekeeper';

// Thrown when:
// - Authorization header is missing
// - Token format is invalid
// - Token prefix doesn't match service
// - API key validation fails

{
  "error": "Unauthorized",
  "message": "Authorization header required"
}

import { RateLimitError } from '@mira.network/gatekeeper';

// Properties:
// - type: 'minute' | 'day' - Which limit was exceeded
// - resetAt: number - Unix timestamp when limit resets
// - retryAfter: number - Seconds until limit resets

{
  "error": "Rate Limit Exceeded",
  "message": "Per-minute rate limit exceeded",
  "resetAt": 1699999999
}

Retry-After: 45

import { InsufficientBalanceError } from '@mira.network/gatekeeper';

// Properties:
// - balance: number - Current balance

{
  "error": "Payment Required",
  "message": "Insufficient balance",
  "balance": 0
}

import {
  AuthError,
  RateLimitError,
  InsufficientBalanceError,
} from '@mira.network/gatekeeper';

app.onError((err, c) => {
  if (err instanceof AuthError) {
    return c.json(
      { error: 'Unauthorized', message: err.message },
      401
    );
  }

  if (err instanceof RateLimitError) {
    c.header('Retry-After', err.retryAfter.toString());
    return c.json(
      {
        error: 'Rate Limit Exceeded',
        message: err.message,
        resetAt: err.resetAt,
      },
      429
    );
  }

  if (err instanceof InsufficientBalanceError) {
    return c.json(
      {
        error: 'Payment Required',
        message: 'Insufficient balance',
        balance: err.balance,
      },
      402
    );
  }

  // Handle other errors
  console.error(err);
  return c.json({ error: 'Internal Server Error' }, 500);
});

app.post('/api/endpoint', async (c) => {
  try {
    // Your handler logic
  } catch (err) {
    if (err instanceof AuthError) {
      // Handle auth error
    }
    throw err; // Re-throw to global error handler
  }
});