Handle Errors from the Figranium SDK

class FigraniumError extends Error {
  readonly name: "FigraniumError";
  readonly status: number;      // HTTP status, or 0 for transport failures
  readonly code?: string;        // Server-provided error code, e.g. TASK_NOT_FOUND
  readonly details?: unknown;    // Server-provided diagnostics
  readonly requestId?: string;   // From the x-request-id response header
  readonly response?: Response;  // Original Response, when available
}

import { Figranium, FigraniumError } from "@figranium/sdk";

const figranium = new Figranium({ apiKey: process.env.FIGRANIUM_API_KEY! });

try {
  await figranium.runTask("missing-task");
} catch (error) {
  if (error instanceof FigraniumError) {
    console.error(error.status);     // e.g. 404
    console.error(error.code);       // e.g. "TASK_NOT_FOUND"
    console.error(error.details);    // server diagnostics
    console.error(error.requestId);  // when supplied by the server or proxy
  }
}

try {
  await figranium.tasks.get(id);
} catch (error) {
  if (!(error instanceof FigraniumError)) throw error;

  switch (error.status) {
    case 401:
      // Reauthenticate or refresh the API key.
      break;
    case 404:
      // Task is gone; treat as an empty result.
      break;
    case 429:
      // Back off and retry.
      break;
    default:
      throw error;
  }
}

try {
  await figranium.health.check();
} catch (error) {
  if (error instanceof FigraniumError && error.code === "NETWORK_ERROR") {
    console.error("Figranium is unreachable", error.cause);
  }
}