@hasna/uptime 0.1.0 → 0.1.1

package/dist/report.js

@@ -0,0 +1,274 @@
+// @bun
+// src/report.ts
+var DEFAULT_MAILERY_API_URL = "http://localhost:3900";
+var DEFAULT_TELEPHONY_API_URL = "http://localhost:19451";
+var DEFAULT_LOGS_API_URL = "http://localhost:3460";
+var DEFAULT_TIMEOUT_MS = 15000;
+function buildUptimeReport(summary, options = {}) {
+  const subject = options.subject ?? defaultSubject(summary);
+  const lines = [
+    subject,
+    `Generated: ${summary.generatedAt}`,
+    `Monitors: ${summary.totals.monitors} total, ${summary.totals.enabled} enabled, ${summary.totals.up} up, ${summary.totals.down} down, ${summary.totals.openIncidents} open incidents`,
+    "",
+    ...summary.monitors.map(renderMonitorLine)
+  ];
+  const text = lines.join(`
+`).trimEnd();
+  const json = {
+    kind: "open-uptime.report",
+    generated_at: summary.generatedAt,
+    subject,
+    totals: summary.totals,
+    monitors: summary.monitors
+  };
+  return {
+    subject,
+    generatedAt: summary.generatedAt,
+    summary,
+    text,
+    html: `<pre>${escapeHtml(text)}</pre>`,
+    json
+  };
+}
+async function sendUptimeReport(summary, options = {}) {
+  const report = buildUptimeReport(summary, options);
+  const fetchImpl = options.fetchImpl ?? fetch;
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const deliveries = [];
+  if (options.email) {
+    deliveries.push(await sendEmailReport(report, resolveEmailTarget(options.email), fetchImpl, timeoutMs));
+  }
+  if (options.sms) {
+    const smsTarget = resolveSmsTarget(options.sms);
+    const recipients = splitTargets(smsTarget.to);
+    if (recipients.length === 0) {
+      deliveries.push(await sendSmsReport(report, smsTarget, fetchImpl, timeoutMs));
+    } else {
+      for (const target of recipients) {
+        deliveries.push(await sendSmsReport(report, { ...smsTarget, to: target }, fetchImpl, timeoutMs));
+      }
+    }
+  }
+  if (options.logs) {
+    deliveries.push(await sendLogsReport(report, resolveLogsTarget(options.logs), fetchImpl, timeoutMs));
+  }
+  return deliveries;
+}
+function defaultSubject(summary) {
+  if (summary.totals.openIncidents > 0 || summary.totals.down > 0) {
+    return `Open Uptime alert: ${summary.totals.down} down, ${summary.totals.openIncidents} open incidents`;
+  }
+  return `Open Uptime report: ${summary.totals.up}/${summary.totals.enabled} enabled monitors up`;
+}
+function renderMonitorLine(item) {
+  const uptime = item.uptimePercent == null ? "-" : `${item.uptimePercent.toFixed(2)}%`;
+  const latency = item.averageLatencyMs == null ? "-" : `${item.averageLatencyMs}ms`;
+  const incident = item.openIncident ? ` open incident: ${item.openIncident.reason ?? "down"}` : "";
+  return `- ${item.monitor.status.toUpperCase()} ${item.monitor.name} (${targetLabel(item)}): uptime ${uptime}, latency ${latency}${incident}`;
+}
+function targetLabel(item) {
+  return item.monitor.kind === "http" ? item.monitor.url ?? "" : `${item.monitor.host}:${item.monitor.port}`;
+}
+function resolveEmailTarget(value) {
+  const target = typeof value === "boolean" ? {} : value;
+  return {
+    apiUrl: target.apiUrl ?? env("HASNA_MAILERY_API_URL", "MAILERY_API_URL") ?? DEFAULT_MAILERY_API_URL,
+    sendKey: target.sendKey ?? env("HASNA_MAILERY_SEND_KEY", "MAILERY_SEND_KEY", "ESK"),
+    from: target.from ?? env("HASNA_UPTIME_REPORT_EMAIL_FROM", "UPTIME_REPORT_EMAIL_FROM"),
+    to: target.to ?? env("HASNA_UPTIME_REPORT_EMAIL_TO", "UPTIME_REPORT_EMAIL_TO"),
+    subject: target.subject,
+    providerId: target.providerId ?? env("HASNA_MAILERY_PROVIDER_ID", "MAILERY_PROVIDER_ID")
+  };
+}
+function resolveSmsTarget(value) {
+  const target = typeof value === "boolean" ? {} : value;
+  return {
+    apiUrl: target.apiUrl ?? env("HASNA_TELEPHONY_API_URL", "TELEPHONY_API_URL") ?? DEFAULT_TELEPHONY_API_URL,
+    from: target.from ?? env("HASNA_UPTIME_REPORT_SMS_FROM", "UPTIME_REPORT_SMS_FROM"),
+    to: target.to ?? env("HASNA_UPTIME_REPORT_PHONE_TO", "UPTIME_REPORT_PHONE_TO")
+  };
+}
+function resolveLogsTarget(value) {
+  const target = typeof value === "boolean" ? {} : value;
+  return {
+    apiUrl: target.apiUrl ?? env("HASNA_LOGS_URL", "LOGS_URL") ?? DEFAULT_LOGS_API_URL,
+    apiKey: target.apiKey ?? env("HASNA_LOGS_API_TOKEN", "LOGS_API_TOKEN", "HASNA_LOGS_API_KEY", "LOGS_API_KEY"),
+    projectId: target.projectId ?? env("HASNA_LOGS_PROJECT_ID", "LOGS_PROJECT_ID") ?? "open-uptime",
+    environment: target.environment ?? env("HASNA_ENV", "NODE_ENV"),
+    service: target.service ?? "open-uptime"
+  };
+}
+async function sendEmailReport(report, target, fetchImpl, timeoutMs) {
+  if (!target.sendKey)
+    return { channel: "email", ok: false, error: "Mailery send key is required" };
+  if (!target.from)
+    return { channel: "email", ok: false, error: "Email from address is required" };
+  if (!hasTargets(target.to))
+    return { channel: "email", ok: false, error: "Email recipient is required" };
+  const body = {
+    from: target.from,
+    to: splitTargets(target.to),
+    subject: target.subject ?? report.subject,
+    text: report.text,
+    html: report.html,
+    provider_id: target.providerId
+  };
+  return requestJson("email", `${normalizeUrl(target.apiUrl ?? DEFAULT_MAILERY_API_URL)}/api/v1/send`, {
+    method: "POST",
+    headers: { authorization: `Bearer ${target.sendKey}` },
+    body
+  }, fetchImpl, timeoutMs, secretsForTarget(target));
+}
+async function sendSmsReport(report, target, fetchImpl, timeoutMs) {
+  if (!hasTargets(target.to))
+    return { channel: "sms", ok: false, error: "SMS recipient phone number is required" };
+  return requestJson("sms", `${normalizeUrl(target.apiUrl ?? DEFAULT_TELEPHONY_API_URL)}/api/sms/send`, {
+    method: "POST",
+    body: {
+      to: Array.isArray(target.to) ? target.to[0] : target.to,
+      from: target.from,
+      body: truncateSms(report.text)
+    }
+  }, fetchImpl, timeoutMs, secretsForTarget(target));
+}
+async function sendLogsReport(report, target, fetchImpl, timeoutMs) {
+  const params = new URLSearchParams({
+    format: "json",
+    source: "structured",
+    service: target.service ?? "open-uptime",
+    project_id: target.projectId ?? "open-uptime"
+  });
+  if (target.environment)
+    params.set("environment", target.environment);
+  return requestJson("logs", `${normalizeUrl(target.apiUrl ?? DEFAULT_LOGS_API_URL)}/api/logs/structured?${params}`, {
+    method: "POST",
+    headers: target.apiKey ? { authorization: `Bearer ${target.apiKey}` } : undefined,
+    body: {
+      timestamp: report.generatedAt,
+      level: report.summary.totals.down > 0 || report.summary.totals.openIncidents > 0 ? "warn" : "info",
+      message: report.subject,
+      report: report.json
+    }
+  }, fetchImpl, timeoutMs, secretsForTarget(target));
+}
+async function requestJson(channel, url, options, fetchImpl, timeoutMs, secrets = []) {
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await fetchImpl(url, {
+      method: options.method,
+      signal: controller.signal,
+      headers: {
+        "content-type": "application/json",
+        accept: "application/json",
+        ...options.headers
+      },
+      body: JSON.stringify(options.body)
+    });
+    const text = await response.text();
+    const data = parseMaybeJson(text);
+    if (!response.ok) {
+      return { channel, ok: false, status: response.status, error: errorFromResponse(data, response.statusText, secrets) };
+    }
+    return { channel, ok: true, status: response.status, id: redactOptional(idFromResponse(data), secrets) };
+  } catch (error) {
+    const message = error instanceof Error && error.name === "AbortError" ? "request timed out" : error instanceof Error ? error.message : String(error);
+    return { channel, ok: false, error: redactSecrets(message, secrets) };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function hasTargets(value) {
+  return splitTargets(value).length > 0;
+}
+function splitTargets(value) {
+  if (!value)
+    return [];
+  const values = Array.isArray(value) ? value : value.split(",");
+  return values.map((item) => item.trim()).filter(Boolean);
+}
+function normalizeUrl(value) {
+  const parsed = new URL(value.trim());
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new Error("Integration API URL must use http or https");
+  }
+  return parsed.toString().replace(/\/$/, "");
+}
+function truncateSms(value) {
+  return value.length > 1400 ? `${value.slice(0, 1397)}...` : value;
+}
+function parseMaybeJson(text) {
+  if (!text.trim())
+    return {};
+  try {
+    return JSON.parse(text);
+  } catch {
+    return { message: text };
+  }
+}
+function idFromResponse(data) {
+  if (!data || typeof data !== "object")
+    return;
+  const record = data;
+  for (const key of ["id", "message_id", "event_id"]) {
+    if (typeof record[key] === "string")
+      return record[key];
+  }
+  return;
+}
+function errorFromResponse(data, fallback, secrets = []) {
+  if (data && typeof data === "object") {
+    const record = data;
+    if (typeof record.error === "string")
+      return redactSecrets(record.error, secrets);
+    if (typeof record.message === "string")
+      return redactSecrets(record.message, secrets);
+  }
+  return redactSecrets(fallback, secrets);
+}
+function env(...keys) {
+  for (const key of keys) {
+    const value = process.env[key]?.trim();
+    if (value)
+      return value;
+  }
+  return;
+}
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function secretsForTarget(target) {
+  const values = new Set;
+  for (const key of ["sendKey", "apiKey"]) {
+    const value = target[key];
+    if (typeof value === "string" && value.trim())
+      values.add(value.trim());
+  }
+  const apiUrl = target.apiUrl;
+  if (apiUrl) {
+    try {
+      const parsed = new URL(apiUrl);
+      if (parsed.username)
+        values.add(decodeURIComponent(parsed.username));
+      if (parsed.password)
+        values.add(decodeURIComponent(parsed.password));
+    } catch {}
+  }
+  return [...values];
+}
+function redactSecrets(value, secrets = []) {
+  let redacted = value;
+  for (const secret of secrets) {
+    if (secret.length >= 3)
+      redacted = redacted.split(secret).join("[REDACTED]");
+  }
+  return redacted.replace(/\bBearer\s+[A-Za-z0-9._~+/=-]+/gi, "Bearer [REDACTED]").replace(/\besk_[A-Za-z0-9._~+/=-]+/g, "esk_[REDACTED]");
+}
+function redactOptional(value, secrets) {
+  return value === undefined ? undefined : redactSecrets(value, secrets);
+}
+export {
+  sendUptimeReport,
+  buildUptimeReport
+};

package/dist/service.d.ts

@@ -1,4 +1,5 @@
 import { UptimeStore, type UptimeStoreOptions } from "./store.js";
+import { type BuildUptimeReportOptions, type SendUptimeReportOptions, type UptimeReport, type UptimeReportDelivery } from "./report.js";
 import type { CheckAttemptResult, CheckResult, CreateMonitorInput, Incident, ListResultsOptions, Monitor, SchedulerHandle, UpdateMonitorInput, UptimeSummary } from "./types.js";
 export interface UptimeServiceOptions extends UptimeStoreOptions {
     store?: UptimeStore;
@@ -7,6 +8,7 @@ export interface UptimeServiceOptions extends UptimeStoreOptions {
 export declare class UptimeService {
     readonly store: UptimeStore;
     private readonly checkRunner;
+    private readonly leaseOwner;
     private readonly inFlightChecks;
     constructor(options?: UptimeServiceOptions);
     close(): void;
@@ -24,6 +26,8 @@ export declare class UptimeService {
         limit?: number;
     }): Incident[];
     summary(): UptimeSummary;
+    buildReport(options?: BuildUptimeReportOptions): UptimeReport;
+    sendReport(options?: SendUptimeReportOptions): Promise<UptimeReportDelivery[]>;
     checkMonitor(idOrName: string): Promise<CheckResult>;
     checkAll(): Promise<CheckResult[]>;
     startScheduler(options?: {
@@ -33,4 +37,7 @@ export declare class UptimeService {
     private isDue;
 }
 export declare function createUptimeClient(options?: UptimeServiceOptions): UptimeService;
+export declare class MonitorCheckBusyError extends Error {
+    constructor(message: string);
+}
 //# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,OAAO,EACP,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjE;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoD;IAChF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,OAAO,GAAE,oBAAyB;IAK9C,KAAK,IAAI,IAAI;IAIb,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO;IAIjD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO;IAInE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC,YAAY,CAAC,OAAO,GAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,EAAE;IAIpE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAI5C,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,EAAE;IAI5D,aAAa,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,QAAQ,EAAE;IAI3G,OAAO,IAAI,aAAa;IAIlB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA4BpD,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IASxC,cAAc,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,eAAe;IAY5D,YAAY,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAWlE,OAAO,CAAC,KAAK;CAOd;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAEpF"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAuC,KAAK,wBAAwB,EAAE,KAAK,uBAAuB,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC7K,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,OAAO,EACP,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjE;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoD;IAChF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwD;IACnF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,OAAO,GAAE,oBAAyB;IAK9C,KAAK,IAAI,IAAI;IAIb,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO;IAIjD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO;IAInE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC,YAAY,CAAC,OAAO,GAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,EAAE;IAIpE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAI5C,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,EAAE;IAI5D,aAAa,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,QAAQ,EAAE;IAI3G,OAAO,IAAI,aAAa;IAIxB,WAAW,CAAC,OAAO,GAAE,wBAA6B,GAAG,YAAY;IAI3D,UAAU,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAIlF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAkCpD,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IASxC,cAAc,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,eAAe;IAY5D,YAAY,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgBlE,OAAO,CAAC,KAAK;CAOd;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAEpF;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B"}