@cronwatch/sdk 0.7.0 → 0.8.0

package/dist/index.cjs

@@ -67,6 +67,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) {
@@ -104,15 +112,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;
@@ -121,20 +150,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;
@@ -170,6 +200,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;
@@ -206,8 +237,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
@@ -230,6 +263,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: [] };
 }
@@ -440,7 +482,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 "";
@@ -836,9 +880,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;
@@ -1329,7 +1377,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) {
@@ -1862,7 +1911,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;
     },
@@ -2132,7 +2181,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) {
@@ -2192,7 +2241,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));
@@ -2426,7 +2475,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() }
@@ -2615,7 +2664,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));