@voltro/runtime 0.86.0 → 0.87.0

package/dist/coordinatedSchedule.js

@@ -1,19 +1,22 @@
-import { cronForInterval as e, externalizationRefusal as t, registerExternalizedTask as n, unregisterExternalizedTask as r } from "./externalizedTasks.js";
+import { cronForInterval as e, externalizationRefusal as t, registerExternalizedTask as n } from "./externalizedTasks.js";
 //#region src/coordinatedSchedule.ts
-var i = (e) => {
+var r = (e) => {
 	if (e === void 0) return null;
 	let t = e.nextDueInMs;
 	return {
 		idle: e.idle === !0,
 		...t === null ? { nextDueInMs: null } : typeof t == "number" && Number.isFinite(t) ? { nextDueInMs: t } : {}
 	};
-}, a = /* @__PURE__ */ new WeakMap(), o = (e) => a.get(e)?.() ?? null, s = 3e4, c = (e = process.env) => {
+}, i = /* @__PURE__ */ new WeakMap(), a = (e) => i.get(e)?.() ?? null, o = 3e4, s = (e = process.env) => {
 	let t = e.VOLTRO_POLL_CEILING_MS;
-	if (t === void 0) return s;
+	if (t === void 0) return o;
 	let n = Number(t);
-	return Number.isFinite(n) && n > 0 ? n : s;
-}, l = (o, s, l, d) => {
-	let f = Math.max(s, d.maxIdleIntervalMs ?? c()), p = !1, m, h = !1, g = s, _ = !1, v = !1, y = 0, b = null, x = {
+	return Number.isFinite(n) && n > 0 ? n : o;
+}, c = (a, o, c, u) => {
+	let d = Math.max(o, u.maxIdleIntervalMs ?? s()), f = !1, p, m = /* @__PURE__ */ new Set(), h = (e) => {
+		let t = Promise.resolve().then(e);
+		return m.add(t), t.then(() => m.delete(t), () => m.delete(t)), t;
+	}, g, _ = !1, v = o, y = !1, b = !1, x = 0, S = null, C = {
 		ticks: 0,
 		claimWins: 0,
 		claimLosses: 0,
@@ -25,115 +28,118 @@ var i = (e) => {
 		lastWakeAt: null,
 		lastDecision: "starting",
 		lastOutcome: null
-	}, S = (e) => {
-		p || (m !== void 0 && clearTimeout(m), m = void 0, b = null, e === "disarm" ? h = !0 : (h = !1, g = Math.max(0, Math.min(e, f)), b = Date.now() + g, m = setTimeout(() => {
-			C();
-		}, g), typeof m.unref == "function" && m.unref()));
-	}, C = async () => {
-		if (p) return;
-		if (_) {
-			v = !0;
+	}, w = (e) => {
+		f || (g !== void 0 && clearTimeout(g), g = void 0, S = null, e === "disarm" ? _ = !0 : (_ = !1, v = Math.max(0, Math.min(e, d)), S = Date.now() + v, g = setTimeout(() => {
+			E();
+		}, v), typeof g.unref == "function" && g.unref()));
+	}, T = async () => {
+		if (f) return;
+		if (y) {
+			b = !0;
 			return;
 		}
-		x.ticks++, x.lastTickAt = Date.now(), x.lastOutcome = null, b = null, _ = !0;
-		let e = new Date(Math.floor(Date.now() / s) * s);
+		C.ticks++, C.lastTickAt = Date.now(), C.lastOutcome = null, S = null, y = !0;
+		let e = new Date(Math.floor(Date.now() / o) * o);
 		try {
 			let t = !1;
 			try {
-				t = await d.coordinator.tryClaim(o, e, s);
+				t = await u.coordinator.tryClaim(a, e, o);
 			} catch (e) {
-				x.claimFailures++, x.lastDecision = "claim-failed", d.log?.warn("coordinated schedule: claim check failed — skipping this tick", {
-					task: o,
+				C.claimFailures++, C.lastDecision = "claim-failed", u.log?.warn("coordinated schedule: claim check failed — skipping this tick", {
+					task: a,
 					reason: e?.message ?? String(e)
-				}), S(s);
+				}), w(o);
 				return;
 			}
 			if (!t) {
-				x.claimLosses++, x.lastDecision = "claim-lost", S(s);
+				C.claimLosses++, C.lastDecision = "claim-lost", w(o);
 				return;
 			}
+			if (f) return;
 			let n;
-			x.claimWins++;
+			C.claimWins++;
 			try {
-				n = await l();
+				n = await c();
 			} catch (e) {
-				x.taskFailures++, x.lastDecision = "task-failed", d.log?.warn("coordinated schedule: task threw", {
-					task: o,
+				C.taskFailures++, C.lastDecision = "task-failed", u.log?.warn("coordinated schedule: task threw", {
+					task: a,
 					reason: e?.message ?? String(e)
-				}), S(s);
+				}), w(o);
 				return;
 			}
-			x.lastOutcome = i(n);
-			let r = u(x.lastOutcome ?? void 0, s, g, f, d.disarmWhenIdle ?? !1);
-			x.lastDecision = r === "disarm" ? "idle-disarmed" : n?.idle ? "idle-backoff" : "active", S(r);
+			C.lastOutcome = r(n);
+			let i = l(C.lastOutcome ?? void 0, o, v, d, u.disarmWhenIdle ?? !1);
+			C.lastDecision = i === "disarm" ? "idle-disarmed" : n?.idle ? "idle-backoff" : "active", w(i);
 		} finally {
-			_ = !1, v && !p && (v = !1, S(0));
+			y = !1, b && !f && (b = !1, w(0));
 		}
-	}, w = async () => {
-		x.ticks++, x.lastTickAt = Date.now(), x.lastOutcome = null;
-		let e = new Date(Math.floor(Date.now() / s) * s), t;
+	}, E = () => f ? Promise.resolve() : h(T), D = async () => {
+		if (f) throw Error("Coordinated schedule is stopped");
+		C.ticks++, C.lastTickAt = Date.now(), C.lastOutcome = null;
+		let e = new Date(Math.floor(Date.now() / o) * o), t;
 		try {
-			t = await (d.externalClaim ?? d.coordinator).tryClaim(o, e, s);
+			t = await (u.externalClaim ?? u.coordinator).tryClaim(a, e, o);
 		} catch (e) {
-			throw x.claimFailures++, x.lastDecision = "claim-failed", e;
+			throw C.claimFailures++, C.lastDecision = "claim-failed", e;
 		}
-		if (!t) return x.claimLosses++, x.lastDecision = "claim-lost", "deduplicated";
-		x.claimWins++;
+		if (!t) return C.claimLosses++, C.lastDecision = "claim-lost", "deduplicated";
+		if (f) throw Error("Coordinated schedule is stopped");
+		C.claimWins++;
 		try {
-			let e = await l();
-			x.lastOutcome = i(e), x.lastDecision = "active";
+			let e = await c();
+			C.lastOutcome = r(e), C.lastDecision = "active";
 		} catch (e) {
-			throw x.taskFailures++, x.lastDecision = "task-failed", e;
+			throw C.taskFailures++, C.lastDecision = "task-failed", e;
 		}
 		return "ran";
-	}, T = d.externalize === !0 ? t(o, s) : void 0, E = d.externalize === !0 && T === void 0;
-	T !== void 0 && d.log?.warn(`coordinated schedule: REFUSING to externalise this task — ${T}`, {
-		task: o,
-		intervalMs: s
-	}), E ? (n({
-		name: o,
-		intervalMs: s,
-		cron: e(s),
-		run: w
-	}), d.log?.info("coordinated schedule: externalised — no in-process timer", {
-		task: o,
-		intervalMs: s
-	})) : S(s);
-	let D = {
-		name: o,
-		currentIntervalMs: () => g,
-		isArmed: () => !p && !h && !E,
+	}, O = () => f ? Promise.reject(/* @__PURE__ */ Error("Coordinated schedule is stopped")) : h(D), k = u.externalize === !0 ? t(a, o) : void 0, A = u.externalize === !0 && k === void 0;
+	k !== void 0 && u.log?.warn(`coordinated schedule: REFUSING to externalise this task — ${k}`, {
+		task: a,
+		intervalMs: o
+	});
+	let j;
+	A ? (j = (u.externalTasks?.register ?? n)({
+		name: a,
+		intervalMs: o,
+		cron: e(o),
+		run: O
+	}), u.log?.info("coordinated schedule: externalised — no in-process timer", {
+		task: a,
+		intervalMs: o
+	})) : w(o);
+	let M = {
+		name: a,
+		currentIntervalMs: () => v,
+		isArmed: () => !f && !_ && !A,
 		wake: () => {
-			if (p) return;
-			x.wakes++, x.lastWakeAt = Date.now();
+			if (f) return;
+			C.wakes++, C.lastWakeAt = Date.now();
 			let e = Date.now();
-			!h && e - y < s ? x.coalescedWakes++ : (x.lastDecision = "wake", y = e, _ ? v = !0 : S(0));
+			!_ && e - x < o ? C.coalescedWakes++ : (C.lastDecision = "wake", x = e, y ? b = !0 : w(0));
 		},
-		stop: () => {
-			p || (p = !0, m !== void 0 && clearTimeout(m), m = void 0, b = null, E && r(o));
-		}
+		stop: () => (p === void 0 && (f = !0, g !== void 0 && clearTimeout(g), g = void 0, S = null, j?.(), p = Promise.allSettled([...m]).then(() => {})), p)
 	};
-	return a.set(D, () => ({
-		...x,
-		lastOutcome: x.lastOutcome === null ? null : { ...x.lastOutcome },
-		task: o,
-		state: p ? "stopped" : E ? "externalized" : _ ? "running" : h ? "disarmed" : "armed",
-		baseIntervalMs: s,
-		currentIntervalMs: g,
-		maxIdleIntervalMs: f,
-		nextTickAt: b,
-		disarmWhenIdle: d.disarmWhenIdle ?? !1
-	})), D;
-}, u = (e, t, n, r, i = !1) => {
+	return i.set(M, () => ({
+		...C,
+		lastOutcome: C.lastOutcome === null ? null : { ...C.lastOutcome },
+		task: a,
+		state: f ? "stopped" : A ? "externalized" : y ? "running" : _ ? "disarmed" : "armed",
+		baseIntervalMs: o,
+		currentIntervalMs: v,
+		maxIdleIntervalMs: d,
+		nextTickAt: S,
+		disarmWhenIdle: u.disarmWhenIdle ?? !1
+	})), M;
+}, l = (e, t, n, r, i = !1) => {
 	if (e === void 0 || !e.idle) return t;
 	let a = typeof e.nextDueInMs == "number" && Number.isFinite(e.nextDueInMs) ? e.nextDueInMs : void 0;
 	if (a === void 0 && e.nextDueInMs === null && i) return "disarm";
 	let o = Math.min(Math.max(n, t) * 2, r);
 	return a === void 0 ? o : Math.max(t, i ? a : Math.min(o, a));
-}, d = (e) => (t, n, r, i) => l(t, n, r, {
+}, u = (e) => (t, n, r, i) => c(t, n, r, {
 	...e,
 	...e.externalizeTask === void 0 ? {} : { externalize: e.externalizeTask(t) },
 	...i?.disarmWhenIdle === void 0 ? {} : { disarmWhenIdle: i.disarmWhenIdle }
 });
 //#endregion
-export { s as DEFAULT_MAX_IDLE_INTERVAL_MS, o as inspectCoordinatedSchedule, d as makeCoordinatedScheduler, u as nextDelay, c as readPollCeilingMs, l as scheduleCoordinated };
+export { o as DEFAULT_MAX_IDLE_INTERVAL_MS, a as inspectCoordinatedSchedule, u as makeCoordinatedScheduler, l as nextDelay, s as readPollCeilingMs, c as scheduleCoordinated };