@cronwatch/sdk 0.6.1 → 0.8.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { C as CronWatchOptions, a as CronWatch } from './client-B7bqnkI5.cjs';
-export { F as FetchHandler, H as HandlerFn, b as HandlerOptions, J as JobContext, c as JobFn, d as JobHandle, R as RecordRunOptions, e as Routes, f as RoutesOptions, g as RunHandle, h as RunOutcome, S as Source, i as SourceHost, j as StartOptions, k as consoleChannel, l as createRoutes, m as custom } from './client-B7bqnkI5.cjs';
-import { S as Store, D as Duration, b as AlertDraft, c as StoredJobDefinition, A as Alert } from './types-Ddq1MUPL.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, J as JobDefinition, h as JobHealth, i as JobOptions, j as JobState, k as JobSummary, R as Run, l as RunStatus, m as StoredJob, T as TriageContext, n as TriageFn } from './types-Ddq1MUPL.cjs';
+import { C as CronWatchOptions, a as CronWatch } from './client-Di5HAWQz.cjs';
+export { F as FetchHandler, H as HandlerFn, b as HandlerOptions, J as JobContext, c as JobFn, d as JobHandle, R as RecordRunOptions, e as Routes, f as RoutesOptions, g as RunHandle, h as RunOutcome, S as Source, i as SourceHost, j as StartOptions, k as consoleChannel, l as createRoutes, m as custom } from './client-Di5HAWQz.cjs';
+import { S as Store, D as Duration, b as AlertDraft, c as StoredJobDefinition, A as Alert } from './types-BjBbCGeJ.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, J as JobDefinition, h as JobHealth, i as JobOptions, j as JobState, k as JobSummary, R as Run, l as RunStatus, m as StoredJob, T as TriageContext, n as TriageFn } from './types-BjBbCGeJ.cjs';
 
 /**
  * Keeps everything in process memory. The default when no store is given,

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { C as CronWatchOptions, a as CronWatch } from './client-pmqH3apS.js';
-export { F as FetchHandler, H as HandlerFn, b as HandlerOptions, J as JobContext, c as JobFn, d as JobHandle, R as RecordRunOptions, e as Routes, f as RoutesOptions, g as RunHandle, h as RunOutcome, S as Source, i as SourceHost, j as StartOptions, k as consoleChannel, l as createRoutes, m as custom } from './client-pmqH3apS.js';
-import { S as Store, D as Duration, b as AlertDraft, c as StoredJobDefinition, A as Alert } from './types-Ddq1MUPL.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, J as JobDefinition, h as JobHealth, i as JobOptions, j as JobState, k as JobSummary, R as Run, l as RunStatus, m as StoredJob, T as TriageContext, n as TriageFn } from './types-Ddq1MUPL.js';
+import { C as CronWatchOptions, a as CronWatch } from './client-B5hM4l-D.js';
+export { F as FetchHandler, H as HandlerFn, b as HandlerOptions, J as JobContext, c as JobFn, d as JobHandle, R as RecordRunOptions, e as Routes, f as RoutesOptions, g as RunHandle, h as RunOutcome, S as Source, i as SourceHost, j as StartOptions, k as consoleChannel, l as createRoutes, m as custom } from './client-B5hM4l-D.js';
+import { S as Store, D as Duration, b as AlertDraft, c as StoredJobDefinition, A as Alert } from './types-BjBbCGeJ.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, J as JobDefinition, h as JobHealth, i as JobOptions, j as JobState, k as JobSummary, R as Run, l as RunStatus, m as StoredJob, T as TriageContext, n as TriageFn } from './types-BjBbCGeJ.js';
 
 /**
  * Keeps everything in process memory. The default when no store is given,

package/dist/index.js

@@ -9,11 +9,14 @@ var UNIT_MS = {
   d: 864e5,
   w: 6048e5
 };
+var MAX_LENGTH = 64;
+var QUOTED = 32;
 function parseDuration(value, label = "duration") {
   if (typeof value === "number") {
     if (!Number.isFinite(value) || value < 0) throw new Error(`${label} must be a non-negative number of milliseconds`);
     return value;
   }
+  if (value.length > MAX_LENGTH) tooLong(value, label);
   const text = value.trim().toLowerCase();
   if (text === "") throw new Error(`${label} is empty`);
   const re = /(\d+(?:\.\d+)?)\s*(ms|s|m|h|d|w)/g;
@@ -29,6 +32,16 @@ function parseDuration(value, label = "duration") {
   }
   return Math.round(total);
 }
+function tooLong(value, label) {
+  let count = 0;
+  let head = "";
+  for (const char of value) {
+    if (count < QUOTED) head += char;
+    if (++count > MAX_LENGTH) {
+      throw new Error(`${label} "${head}..." is too long for a duration (more than ${MAX_LENGTH} characters)`);
+    }
+  }
+}
 function formatDuration(ms) {
   if (!Number.isFinite(ms)) return "?";
   if (ms < 1e3) return `${Math.round(ms)}ms`;
@@ -52,6 +65,14 @@ function formatRelative(at, now) {
   if (abs < 5e3) return text;
   return diff < 0 ? `${text} ago` : `in ${text}`;
 }
+var FIRST_DATE_MS = -621355968e5;
+var LAST_DATE_MS = 253402300799999;
+function isoTime(at) {
+  return at >= FIRST_DATE_MS && at <= LAST_DATE_MS ? new Date(at).toISOString() : null;
+}
+function beyondDates(at) {
+  return at > LAST_DATE_MS ? "after 9999-12-31 23:59:59 UTC" : "before 0001-01-01 00:00:00 UTC";
+}
 
 // src/env.ts
 function readEnv(name) {
@@ -89,15 +110,36 @@ function parseSchedule(schedule, timezone) {
   cache.set(key, parsed);
   return parsed;
 }
+var CYCLE_MS = 146097 * 864e5;
+var CRONER_FIRST_MS = Date.UTC(400, 0, 1);
+var CRONER_LAST_MS = Date.UTC(2800, 0, 1);
+function runsAfter(cron, n, from) {
+  let shift = 0;
+  if (from < CRONER_FIRST_MS) shift = Math.ceil((CRONER_FIRST_MS - from) / CYCLE_MS) * CYCLE_MS;
+  else if (from >= CRONER_LAST_MS) shift = -(Math.floor((from - CRONER_LAST_MS) / CYCLE_MS) + 1) * CYCLE_MS;
+  const out = [];
+  for (const date of cron.nextRuns(n, new Date(from + shift))) {
+    const t = date.getTime() - shift;
+    if (t > LAST_DATE_MS) break;
+    out.push(t);
+  }
+  return out;
+}
+function countFrom(from) {
+  if (from >= LAST_DATE_MS) return null;
+  return from >= FIRST_DATE_MS ? from : FIRST_DATE_MS - 1;
+}
 function fireAfter(parsed, from) {
   const cron = crons.get(parsed);
   if (!cron) throw new Error(`schedule "${parsed.source}" was not made by parseSchedule`);
-  let probe = from;
+  const start = countFrom(from);
+  if (start === null) return null;
+  let probe = start;
   for (let attempt = 0; attempt < 4; attempt++) {
-    const runs = cron.nextRuns(8, new Date(probe));
+    const runs = runsAfter(cron, 8, probe);
     if (runs.length === 0) return null;
-    const found = runs.find((d) => d.getTime() > from);
-    if (found) return found.getTime();
+    const found = runs.find((t) => t > start);
+    if (found !== void 0) return found;
     probe += 36e5;
   }
   return null;
@@ -106,20 +148,21 @@ function firesBetween(parsed, from, to, limit) {
   const cron = crons.get(parsed);
   if (!cron) throw new Error(`schedule "${parsed.source}" was not made by parseSchedule`);
   const out = [];
-  let probe = from;
-  let last = from;
+  const start = countFrom(from);
+  if (start === null) return out;
+  let probe = start;
+  let last = start;
   for (let guard = 0; guard < 1e3; guard++) {
-    const batch = cron.nextRuns(Math.min(limit + 1 - out.length, 24), new Date(probe));
+    const batch = runsAfter(cron, Math.min(limit + 1 - out.length, 24), probe);
     if (batch.length === 0) return out;
-    for (const date of batch) {
-      const t = date.getTime();
+    for (const t of batch) {
       if (t <= last) continue;
       if (t > to) return out;
       out.push(t);
       last = t;
       if (out.length > limit) return null;
     }
-    const end = batch[batch.length - 1].getTime();
+    const end = batch[batch.length - 1];
     probe = end > probe ? end : probe + 36e5;
   }
   return out;
@@ -155,6 +198,7 @@ function runCovers(startedAt, dueAt, followingAt = null) {
 }
 function inSpringForwardGap(parsed, startedAt, fireAt) {
   const LOOKBACK = 3 * 36e5;
+  if (fireAt - LOOKBACK < FIRST_DATE_MS) return false;
   const after2 = utcOffset(fireAt, parsed.timezone);
   const before = utcOffset(fireAt - LOOKBACK, parsed.timezone);
   const gap = after2 - before;
@@ -191,8 +235,10 @@ function utcOffset(at, timezone) {
   for (const part of format.formatToParts(new Date(at))) {
     if (part.type !== "literal") parts[part.type] = Number(part.value);
   }
-  const wall = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second);
-  return wall - Math.floor(at / 1e3) * 1e3;
+  const wall = /* @__PURE__ */ new Date(0);
+  wall.setUTCFullYear(parts.year, parts.month - 1, parts.day);
+  wall.setUTCHours(parts.hour, parts.minute, parts.second);
+  return wall.getTime() - Math.floor(at / 1e3) * 1e3;
 }
 
 // src/stats.ts
@@ -215,6 +261,15 @@ var DEFAULT_TIMEOUT_MS = 60 * 6e4;
 var SLOW_FLOOR_MS = 1e4;
 var BASELINE_MIN_RUNS = 5;
 var BASELINE_WINDOW = 20;
+var MAX_DURATION_MS = Number.MAX_SAFE_INTEGER;
+function runDuration(startedAt, finishedAt) {
+  const ms = finishedAt - startedAt;
+  return ms > 0 ? Math.min(ms, MAX_DURATION_MS) : 0;
+}
+function stateVersion(state) {
+  const version = state?.version;
+  return typeof version === "number" && Number.isSafeInteger(version) && version >= 0 ? version + 0 : 0;
+}
 function emptyState(job) {
   return { job, open: {}, consecutiveFailures: 0, silencedUntil: null, lastAlertAt: null, pendingRecovery: [], undelivered: [] };
 }
@@ -425,7 +480,9 @@ function summary(stored, recent, state, nextExpectedAt, health) {
 // src/format.ts
 function when(at, now) {
   if (at === null || at === void 0) return "never";
-  return `${new Date(at).toISOString().replace("T", " ").slice(0, 19)} UTC (${formatRelative(at, now)})`;
+  const iso = isoTime(at);
+  if (iso === null) return beyondDates(at);
+  return `${iso.replace("T", " ").slice(0, 19)} UTC (${formatRelative(at, now)})`;
 }
 function firstLines(text, n) {
   if (!text) return "";
@@ -821,9 +878,13 @@ function dayLabel(t) {
   return `${WEEKDAYS[d.getUTCDay()]} ${d.getUTCDate()} ${MONTHS[d.getUTCMonth()]}`;
 }
 function when2(t, now) {
+  if (t > LAST_DATE_MS) return "after 31 Dec 9999 23:59";
+  if (!(t >= FIRST_DATE_MS)) return "before 1 Jan 0001 00:00";
   if (Math.floor(t / DAY) === Math.floor(now / DAY)) return clock(t);
   const d = new Date(t);
-  return `${d.getUTCDate()} ${MONTHS[d.getUTCMonth()]} ${clock(t)}`;
+  const year = d.getUTCFullYear();
+  const other = year === new Date(now).getUTCFullYear() ? "" : ` ${String(year).padStart(4, "0")}`;
+  return `${d.getUTCDate()} ${MONTHS[d.getUTCMonth()]}${other} ${clock(t)}`;
 }
 function parsedSchedule(job) {
   if (!job.definition.schedule) return null;
@@ -1314,7 +1375,8 @@ function sparkline(runs) {
 }
 function stamp(at, now) {
   if (at === null) return `<span class="muted">never</span>`;
-  const iso = new Date(at).toISOString();
+  const iso = isoTime(at);
+  if (iso === null) return `<span class="nowrap">${beyondDates(at)}</span>`;
   return `<time class="nowrap" datetime="${iso}" title="${iso.replace("T", " ").slice(0, 19)} UTC">${h(formatRelative(at, now))}</time>`;
 }
 function healthFigures(jobs) {
@@ -1480,7 +1542,20 @@ function developmentToken() {
   return btoa(String.fromCharCode(...bytes)).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
 }
 function developmentSignInLine(origin, base, token) {
-  return `[cronwatch] CRONWATCH_TOKEN is not set, so this development server made a token for the dashboard. Sign in: ${origin}${base}/?token=${token}`;
+  const intro = "[cronwatch] CRONWATCH_TOKEN is not set, so this development server made a token for the dashboard. Sign in: ";
+  return origin === null ? `${intro}${base}/?token=${token} on this server (the first request's host is not local, so the link leaves it out)` : `${intro}${origin}${base}/?token=${token}`;
+}
+function isLoopbackOrigin(origin) {
+  let host;
+  try {
+    host = new URL(origin).hostname.toLowerCase();
+  } catch {
+    return false;
+  }
+  if (host === "localhost" || host.endsWith(".localhost")) return true;
+  if (host === "[::1]") return true;
+  const octets = /^127\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(host);
+  return octets !== null && octets.slice(1).every((o) => Number(o) <= 255);
 }
 function safeDecode(value) {
   try {
@@ -1585,7 +1660,8 @@ function createRoutes(cw, options = {}) {
     const publicOrigin = originOf(request, url);
     if (generated && !announced) {
       announced = true;
-      console.info(developmentSignInLine(publicOrigin, base, token));
+      const shown = fixedOrigin ?? (isLoopbackOrigin(publicOrigin) ? publicOrigin : null);
+      console.info(developmentSignInLine(shown, base, token));
     }
     if (method === "GET" || method === "HEAD") {
       if (path === "/offline") {
@@ -1833,7 +1909,7 @@ function memory() {
       states.set(state.job, clone(state));
     },
     async compareAndSetState(state, expectedVersion) {
-      if ((states.get(state.job)?.version ?? 0) !== expectedVersion) return false;
+      if (stateVersion(states.get(state.job)) !== expectedVersion) return false;
       states.set(state.job, clone(state));
       return true;
     },
@@ -2103,7 +2179,7 @@ var CronWatch = class {
         const current = await this.readState(job);
         const { state, result } = await change(current);
         if (sameState(state, current)) return { state: current, result };
-        const version = current.version ?? 0;
+        const version = stateVersion(current);
         const next = { ...state, version: version + 1 };
         if (await this.writeState(next, version)) return { state: next, result };
         if (attempt >= STATE_ATTEMPTS) {
@@ -2163,7 +2239,7 @@ var CronWatch = class {
     }
     const finishedAt = this.now();
     run.finishedAt = finishedAt;
-    run.durationMs = Math.max(0, finishedAt - startedAt);
+    run.durationMs = runDuration(startedAt, finishedAt);
     run.metrics = recorder.metrics();
     run.output = recorder.output() ?? (typeof result === "string" ? capOutput(result) : null);
     this.conclude(definition, run, result, error, threw, recorder.expectText() ?? (typeof result === "string" ? result : null));
@@ -2397,7 +2473,7 @@ ${id}`;
           ...from,
           status: "running",
           finishedAt,
-          durationMs: Math.max(0, finishedAt - from.startedAt),
+          durationMs: runDuration(from.startedAt, finishedAt),
           error: null,
           output: joinOutput(from.output, added),
           metrics: { ...from.metrics, ...recorder.metrics() }
@@ -2586,7 +2662,7 @@ ${id}`;
         const timeout = timeoutMs(definition);
         run.status = "timeout";
         run.finishedAt = now;
-        run.durationMs = now - run.startedAt;
+        run.durationMs = runDuration(run.startedAt, now);
         run.error = `Still running after ${formatDuration(timeout)}; marked as timed out`;
         if (!await this.writeRunIf(run, ["running"])) continue;
         alerts.push(...await this.finishRun(definition, run, now));