TypeScript SDK

npm install @devhelm/sdk

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

const client = new DevHelm({
  apiToken: process.env.DEVHELM_API_TOKEN,
});

const monitor = await client.monitors.create({
  name: "API Health",
  type: "HTTP",
  config: {
    url: "https://api.example.com/health",
    method: "GET",
  },
  frequencySeconds: 60,
  regions: ["us-east", "eu-west"],
});

console.log(`Created monitor: ${monitor.id}`);

const monitors = await client.monitors.list({
  page: 0,
  size: 50,
});

for (const monitor of monitors.data) {
  console.log(`${monitor.name}: ${monitor.status}`);
}

const results = await client.monitors.checkResults(monitor.id, {
  limit: 10,
});

for (const check of results.data) {
  console.log(`${check.region}: ${check.passed ? "✓" : "✗"} (${check.responseTimeMs}ms)`);
}

// List active incidents
const incidents = await client.incidents.list({
  status: "CONFIRMED",
});

// Resolve an incident
await client.incidents.resolve(incidentId);

const channel = await client.alertChannels.create({
  name: "Slack Alerts",
  config: {
    channelType: "slack",
    webhookUrl: process.env.SLACK_WEBHOOK_URL,
  },
});

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

try {
  await client.monitors.get("nonexistent-id");
} catch (error) {
  if (error instanceof DevHelmError) {
    console.error(`${error.status}: ${error.message}`);
  }
}