TypeScript Error Handling

import { DevhelmError } from "@devhelm/sdk";

try {
  await client.monitors.get("nonexistent");
} catch (error) {
  if (error instanceof DevhelmError) {
    console.error(error.code);    // "NOT_FOUND"
    console.error(error.status);  // 404
    console.error(error.message); // "Monitor not found"
    console.error(error.detail);  // optional additional context
  }
}

import { AuthError } from "@devhelm/sdk";

try {
  await client.monitors.list();
} catch (error) {
  if (error instanceof AuthError) {
    console.error("Check your API token");
  }
}

import { DevhelmError, AuthError } from "@devhelm/sdk";

try {
  const monitor = await client.monitors.create({
    name: "API Health",
    type: "HTTP",
    config: { url: "https://api.example.com/health" },
    frequencySeconds: 60,
  });
} catch (error) {
  if (error instanceof AuthError) {
    // Re-authenticate or refresh token
  } else if (error instanceof DevhelmError) {
    switch (error.code) {
      case "VALIDATION":
        console.error("Invalid request:", error.detail);
        break;
      case "CONFLICT":
        console.error("Resource already exists");
        break;
      default:
        console.error(`API error: ${error.message}`);
    }
  } else {
    throw error; // Network error or unexpected issue
  }
}

async function withRetry<T>(fn: () => Promise<T>, maxRetries = 3): Promise<T> {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    try {
      return await fn();
    } catch (error) {
      if (error instanceof DevhelmError && error.status === 429) {
        const delay = Math.pow(2, attempt) * 1000;
        await new Promise((r) => setTimeout(r, delay));
        continue;
      }
      throw error;
    }
  }
  throw new Error("Max retries exceeded");
}

const monitors = await withRetry(() => client.monitors.list());

try {
  const lock = await client.deployLock.acquire({
    lockedBy: "ci-pipeline",
    ttlMinutes: 30,
  });
} catch (error) {
  if (error instanceof DevhelmError && error.code === "CONFLICT") {
    const current = await client.deployLock.current();
    console.error(`Lock held by ${current?.lockedBy}`);
  }
}