Error Handling

import {
  VelaError,
  VelaAuthError,
  VelaNotFoundError,
  VelaValidationError,
  VelaRateLimitError,
} from '@vela/sdk';

try {
  await client.apps.get('nonexistent');
} catch (err) {
  if (err instanceof VelaNotFoundError) {
    console.error('App not found');
  } else if (err instanceof VelaAuthError) {
    console.error('Invalid or missing client secret');
  } else if (err instanceof VelaValidationError) {
    console.error('Validation error:', err.message);
  } else if (err instanceof VelaRateLimitError) {
    console.error('Rate limited -- back off and retry');
  } else if (err instanceof VelaError) {
    console.error(`API error ${err.statusCode}:`, err.message);
  } else {
    throw err; // network error, timeout, etc.
  }
}

interface VelaError {
  message: string;      // Human-readable error message
  statusCode: number;   // HTTP status code
  error: string;        // Error type (e.g., "Not Found")
  path: string;         // Request path that caused the error
  timestamp: string;    // ISO-8601 timestamp
}

try {
  await client.apps.list();
} catch (err) {
  if (err instanceof VelaError) {
    // API returned an error response
  } else {
    // Network issue -- DNS, timeout, connection refused
  }
}