@cronwatch/sdk 0.12.4 → 0.12.5

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { C as CronwatchOptions, a as Cronwatch } from './client-BkPMRkDq.cjs';
-export { b as CronWatch, c as CronWatchOptions, F as FetchHandler, H as HandlerFn, d as HandlerOptions, J as JobContext, e as JobFn, f as JobHandle, R as RecordRunOptions, g as Routes, h as RoutesOptions, i as RunHandle, j as RunOutcome, S as Source, k as SourceHost, l as StartOptions, m as consoleChannel, n as createRoutes, o as custom } from './client-BkPMRkDq.cjs';
-import { S as Store, D as Duration, b as AlertDraft, c as StoredJobDefinition, A as Alert } from './types-Bm972Uqj.cjs';
-export { a as AlertChannel, d as AlertDetails, e as AlertType, B as BudgetBreach, C as ChannelContext, f as CheckResult, g as Condition, E as ExpectRule, h as JobDefinition, i as JobHealth, J as JobOptions, j as JobState, k as JobSummary, R as Run, l as RunStatus, m as SendingAlert, n as StoredJob, T as TriageContext, o as TriageFn } from './types-Bm972Uqj.cjs';
+import { C as CronwatchOptions, a as Cronwatch } from './client-CFJUFEOg.cjs';
+export { b as CronWatch, c as CronWatchOptions, F as FetchHandler, H as HandlerFn, d as HandlerOptions, J as JobContext, e as JobFn, f as JobHandle, R as RecordRunOptions, g as Routes, h as RoutesOptions, i as RunHandle, j as RunOutcome, S as Source, k as SourceHost, l as StartOptions, m as consoleChannel, n as createRoutes, o as custom } from './client-CFJUFEOg.cjs';
+import { S as Store, D as Duration, b as AlertDraft, c as StoredJobDefinition, A as Alert } from './types-V8SN54o9.cjs';
+export { a as AlertChannel, d as AlertDetails, e as AlertType, B as BudgetBreach, C as ChannelContext, f as CheckResult, g as Condition, E as ExpectRule, h as JobDefinition, i as JobHealth, J as JobOptions, j as JobState, k as JobSummary, R as Run, l as RunStatus, m as SendingAlert, n as StoredJob, T as TriageContext, o as TriageFn } from './types-V8SN54o9.cjs';
 
 /**
  * Keeps everything in process memory. The default when no store is given,
@@ -11,7 +11,7 @@ export { a as AlertChannel, d as AlertDetails, e as AlertType, B as BudgetBreach
 declare function memory(): Store;
 
 /** This release of @cronwatch/sdk. scripts/release.mjs keeps it in step with package.json. */
-declare const VERSION = "0.12.4";
+declare const VERSION = "0.12.5";
 
 /**
  * "15m" -> 900000. Accepts a plain number of milliseconds, and compound

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { C as CronwatchOptions, a as Cronwatch } from './client-DySsV5T0.js';
-export { b as CronWatch, c as CronWatchOptions, F as FetchHandler, H as HandlerFn, d as HandlerOptions, J as JobContext, e as JobFn, f as JobHandle, R as RecordRunOptions, g as Routes, h as RoutesOptions, i as RunHandle, j as RunOutcome, S as Source, k as SourceHost, l as StartOptions, m as consoleChannel, n as createRoutes, o as custom } from './client-DySsV5T0.js';
-import { S as Store, D as Duration, b as AlertDraft, c as StoredJobDefinition, A as Alert } from './types-Bm972Uqj.js';
-export { a as AlertChannel, d as AlertDetails, e as AlertType, B as BudgetBreach, C as ChannelContext, f as CheckResult, g as Condition, E as ExpectRule, h as JobDefinition, i as JobHealth, J as JobOptions, j as JobState, k as JobSummary, R as Run, l as RunStatus, m as SendingAlert, n as StoredJob, T as TriageContext, o as TriageFn } from './types-Bm972Uqj.js';
+import { C as CronwatchOptions, a as Cronwatch } from './client-k5UVIH38.js';
+export { b as CronWatch, c as CronWatchOptions, F as FetchHandler, H as HandlerFn, d as HandlerOptions, J as JobContext, e as JobFn, f as JobHandle, R as RecordRunOptions, g as Routes, h as RoutesOptions, i as RunHandle, j as RunOutcome, S as Source, k as SourceHost, l as StartOptions, m as consoleChannel, n as createRoutes, o as custom } from './client-k5UVIH38.js';
+import { S as Store, D as Duration, b as AlertDraft, c as StoredJobDefinition, A as Alert } from './types-V8SN54o9.js';
+export { a as AlertChannel, d as AlertDetails, e as AlertType, B as BudgetBreach, C as ChannelContext, f as CheckResult, g as Condition, E as ExpectRule, h as JobDefinition, i as JobHealth, J as JobOptions, j as JobState, k as JobSummary, R as Run, l as RunStatus, m as SendingAlert, n as StoredJob, T as TriageContext, o as TriageFn } from './types-V8SN54o9.js';
 
 /**
  * Keeps everything in process memory. The default when no store is given,
@@ -11,7 +11,7 @@ export { a as AlertChannel, d as AlertDetails, e as AlertType, B as BudgetBreach
 declare function memory(): Store;
 
 /** This release of @cronwatch/sdk. scripts/release.mjs keeps it in step with package.json. */
-declare const VERSION = "0.12.4";
+declare const VERSION = "0.12.5";
 
 /**
  * "15m" -> 900000. Accepts a plain number of milliseconds, and compound

package/dist/index.js

@@ -28,7 +28,7 @@ function parseDuration(value, label = "duration") {
     consumed += match[0];
   }
   if (consumed.replace(/\s+/g, "") !== text.replace(/\s+/g, "")) {
-    throw new Error(`${label} "${value}" is not a duration like "15m", "1h30m" or "90s"`);
+    throw new Error(`${label} "${value}" is not a duration like "15m", "1h30m", or "90s"`);
   }
   return Math.round(total);
 }
@@ -634,6 +634,10 @@ function tail(text, n) {
   const lines = text.trimEnd().split("\n");
   return lines.slice(Math.max(0, lines.length - n)).join("\n");
 }
+function andList(words2) {
+  if (words2.length <= 2) return words2.join(" and ");
+  return `${words2.slice(0, -1).join(", ")}, and ${words2[words2.length - 1]}`;
+}
 function errorLine(error) {
   const text = firstLines(error, 4);
   return /^[A-Za-z_$][\w$]*: /.test(text) ? text : `Error: ${text}`;
@@ -707,7 +711,7 @@ ${out}`);
         break;
       }
       title = `${name} recovered`;
-      const after2 = draft.details.after.map((c) => c.replace("_", " ")).join(", ");
+      const after2 = andList(draft.details.after.map((c) => c.replace("_", " ")));
       lines.push(`A run ${run ? when(run.startedAt, now) : "just now"} succeeded${after2 ? ` after: ${after2}` : ""}.`);
       if (run?.durationMs !== null && run?.durationMs !== void 0) lines.push(`Ran ${formatDuration(run.durationMs)}.`);
       break;
@@ -797,7 +801,7 @@ var SECRET_PATTERNS = [
   // Incoming webhook URLs carry their secret in the path.
   [/(\bhooks\.slack\.com\/(?:services|workflows|triggers)\/)[A-Za-z0-9/_-]{1,255}/gi, `$1${REDACTED}`],
   [/(\bdiscord(?:app)?\.com\/api\/(?:v\d{1,2}\/)?webhooks\/)[A-Za-z0-9/_-]{1,255}/gi, `$1${REDACTED}`],
-  // Well-known token shapes: AWS, GitHub, Slack, Stripe, Anthropic, OpenAI and Google style keys.
+  // Well-known token shapes: AWS, GitHub, Slack, Stripe, Anthropic, OpenAI, and Google style keys.
   [/\b(?:AKIA|ASIA)[0-9A-Z]{16}\b/g, REDACTED],
   [/\b(?:gh[pousr]_[A-Za-z0-9]{30,255}|github_pat_[A-Za-z0-9_]{20,255})\b/g, REDACTED],
   [/\bxox[abposr]-[A-Za-z0-9-]{10,255}/g, REDACTED],
@@ -935,7 +939,7 @@ function manifest(base) {
     id: `${base}/`,
     name: "CronWatch",
     short_name: "CronWatch",
-    description: "The scheduled jobs of this app: their health, their last day and their runs.",
+    description: "The scheduled jobs of this app: their health, their last day, and their runs.",
     start_url: `${base}/`,
     scope: `${base}/`,
     display: "standalone",
@@ -1039,7 +1043,7 @@ function staticAsset(path, base) {
 }
 
 // src/version.ts
-var VERSION = "0.12.4";
+var VERSION = "0.12.5";
 var API_VERSION = 1;
 
 // src/routes/timeline.ts
@@ -1155,11 +1159,11 @@ function laneNote(job, missed, now) {
   if (job.open.includes("stuck")) return "stuck";
   if (job.open.includes("over_budget") && last) {
     const over = overCeilings(job);
-    return `went over budget${over.length ? ` on ${over.join(" and ")}` : ""} at ${when2(last.startedAt, now)}`;
+    return `went over budget${over.length ? ` on ${andList(over)}` : ""} at ${when2(last.startedAt, now)}`;
   }
   if (job.open.includes("under_floor") && last) {
     const under = underFloors(job);
-    return `fell short${under.length ? ` on ${under.join(" and ")}` : ""} at ${when2(last.startedAt, now)}`;
+    return `fell short${under.length ? ` on ${andList(under)}` : ""} at ${when2(last.startedAt, now)}`;
   }
   if (job.open.includes("slow") && last?.durationMs != null) return `slow: took ${formatDuration(last.durationMs)}`;
   if (job.open.includes("failed")) return "failing";
@@ -1277,7 +1281,7 @@ function legend() {
     [box("run ok"), "ran"],
     [box("run bad"), "failed"],
     [box("run timeout"), "timed out"],
-    [box("run warn"), "over budget, under floor or slow"],
+    [box("run warn"), "over budget, under floor, or slow"],
     [box("run running"), "running"],
     [box("missed"), "missed"]
   ];
@@ -2223,7 +2227,7 @@ function validateDefinition(def) {
     }
   }
   if (def.expect !== void 0 && typeof def.expect !== "string" && !(def.expect instanceof RegExp) && typeof def.expect !== "function") {
-    throw new Error(`job "${name}": expect must be a string, a RegExp or a function`);
+    throw new Error(`job "${name}": expect must be a string, a RegExp, or a function`);
   }
 }
 function sameState(a, b) {
@@ -2295,7 +2299,7 @@ var Cronwatch = class {
   /** Declare a job. Call it once, at module level, and keep the handle. */
   job(name, options = {}) {
     if (!NAME_RE.test(name)) {
-      throw new Error(`job name "${name}" must be 1 to 120 characters of letters, digits, ".", "_", ":" or "-"`);
+      throw new Error(`job name "${name}" must be 1 to 120 characters of letters, digits, ".", "_", ":", or "-"`);
     }
     const definition = { ...this.defaults, ...options, name };
     validateDefinition(definition);
@@ -3118,7 +3122,7 @@ ${id}`;
       state.silencedUntil = null;
     });
   }
-  /** Read, change and write one job's state, in turn with every other update to it. */
+  /** Read, change, and write one job's state, in turn with every other update to it. */
   async patchState(name, change) {
     await this.ensureReady();
     const { state } = await this.updateState(name, (current) => {
@@ -3187,7 +3191,7 @@ ${id}`;
   }
   /**
    * Stop the interval, wait for a check already under way (bounded by its
-   * own channel, triage and retry timeouts; what it throws was reported to
+   * own channel, triage, and retry timeouts; what it throws was reported to
    * whoever started it), then close the store, so that check neither writes
    * after the store is closed nor loses the alerts it would queue.
    */