@voltro/workflow 0.86.0 → 0.88.0

package/dist/signalsSuspending.js

@@ -4,7 +4,7 @@ import { SuspensionUnavailable as i, WorkflowCannotPark as a } from "./suspensio
 import { resolveWorkflowMessageRun as o } from "./messages.js";
 import { DurableClock as s, DurableDeferred as c, Workflow as l, WorkflowEngine as u } from "effect/workflow";
 import { Cause as d, Effect as f, Exit as p, Schema as m } from "effect";
-//#region src/signalsSuspending.ts
+// src/signalsSuspending.ts
 var h = 864e5, g = "voltro/suspending-signal", _ = (e, t) => `${g}/${e}/${t}`, v = (n, r) => c.make(n, { success: e(r) ? t(m.Unknown, `signal '${n}' value`) : m.Unknown }), y = async (e, t) => {
 	if (e) try {
 		await e.recordEvent(t);
@@ -53,5 +53,4 @@ var h = 864e5, g = "voltro/suspending-signal", _ = (e, t) => `${g}/${e}/${t}`, v
 		exit: p.succeed(e.payload)
 	}), { completed: !0 };
 });
-//#endregion
 export { b as awaitSignalSuspending, x as completeSuspendingSignal, _ as suspendingSignalDeferredName };

package/dist/sqliteWorkflowOwnership.js

@@ -1,6 +1,6 @@
 import { Effect as e } from "effect";
 import { realpath as t } from "node:fs/promises";
-//#region src/sqliteWorkflowOwnership.ts
+// src/sqliteWorkflowOwnership.ts
 var n = (n) => e.gen(function* () {
 	let i = yield* e.tryPromise({
 		try: () => t(n),
@@ -22,5 +22,4 @@ var n = (n) => e.gen(function* () {
 		}
 	});
 }), r = (e) => e instanceof Error ? e : Error(String(e));
-//#endregion
 export { n as acquireSqliteWorkflowOwnership };

package/dist/stalenessSweep.js

@@ -1,5 +1,5 @@
 import { and as e, eq as t, gt as n, inSet as r, lt as i, or as a } from "@voltro/database";
-//#region src/stalenessSweep.ts
+// src/stalenessSweep.ts
 var o = 18e5, s = 200, c = 20, l = (e) => {
 	if (e instanceof Date) return e;
 	if (typeof e == "number") return new Date(e);
@@ -187,5 +187,4 @@ var o = 18e5, s = 200, c = 20, l = (e) => {
 		...w === void 0 ? {} : { nextRun: w }
 	};
 };
-//#endregion
 export { o as DEFAULT_STALL_AFTER_MS, c as DEFAULT_STALL_EVENT_LOOKBACK, s as DEFAULT_STALL_RUN_PAGE, h as sweepStalledRuns };

package/dist/startContextsTable.js

@@ -1,5 +1,5 @@
 import { id as e, json as t, table as n, text as r, timestamp as i } from "@voltro/database";
-//#region src/startContextsTable.ts
+// src/startContextsTable.ts
 var a = n("_voltro_workflow_start_contexts", {
 	id: e({ prefix: "wfctx" }),
 	workflowName: r(),
@@ -16,5 +16,4 @@ var a = n("_voltro_workflow_start_contexts", {
 	]).nullable(),
 	createdAt: i().default("now")
 }).index(["workflowName"]).index(["executionId"]).index(["parentExecutionId"]);
-//#endregion
 export { a as _voltroWorkflowStartContextsTable };

package/dist/startReceipt.js

@@ -5,7 +5,7 @@ import { PENDING_TABLE as r, toPendingIntent as i } from "./admissionStore.js";
 import { Schema as a } from "effect";
 import { WorkflowStartTerminalOutcomeSchema as o } from "@voltro/protocol";
 import { and as s, eq as c, isNull as l } from "@voltro/database";
-//#region src/startReceipt.ts
+// src/startReceipt.ts
 var u = "_voltro_workflow_start_receipts", d = class extends Error {
 	_tag = "WorkflowStartRequestConflictError";
 	constructor() {
@@ -139,5 +139,4 @@ var u = "_voltro_workflow_start_receipts", d = class extends Error {
 		}
 	}
 };
-//#endregion
 export { u as START_RECEIPTS_TABLE, d as WorkflowStartRequestConflictError, v as bindWorkflowStartReceipts, p as decodeWorkflowStartReceipt, m as readWorkflowStartReceipt, h as readWorkflowStartRequest, _ as recordWorkflowStartReceipt, g as resolveWorkflowStartReceipt, y as settlePendingStartReceipts };

package/dist/submissionRecovery.js

@@ -4,7 +4,7 @@ import { acknowledgeAdmissionSubmissionInTransaction as n, beginAdmissionSubmiss
 import { decodePendingPayload as c, releaseLease as l, retryBackoffMs as u } from "./admissionStore.js";
 import { prepareSubmissionDispatch as d } from "./prepareSubmissionDispatch.js";
 import { Schema as f } from "effect";
-//#region src/submissionRecovery.ts
+// src/submissionRecovery.ts
 var p = /* @__PURE__ */ new WeakMap(), m = async (m, h, g, _) => {
 	let v = p.get(m), y = await o(m.store, g, v?.afterId), b = 0, x = 0, S = 0, C = 0, w = v?.nextDueAt, T = (e) => {
 		w = Math.min(w ?? e, e);
@@ -118,5 +118,4 @@ var p = /* @__PURE__ */ new WeakMap(), m = async (m, h, g, _) => {
 		examined: y.length > 0
 	});
 };
-//#endregion
 export { m as recoverAdmissionSubmissions };

package/dist/submissionRejection.js

@@ -1,10 +1,9 @@
 import { readWorkflowFailureRecord as e } from "./failureReportStore.js";
-//#region src/submissionRejection.ts
+// src/submissionRejection.ts
 var t = async (t, n) => {
 	if (n.failureId === null) throw Error("Workflow submission has no rejection marker");
 	let r = await e(t, n.failureId);
 	if (n.executionId !== null || n.dispatchAttempts > 1 || r === void 0 || r.sourceKind !== "submission" || r.sourceId !== n.id || r.workflowName !== n.workflowName || r.tenantId !== n.tenantId || r.report.executionId !== null || r.report.runId !== null) throw Error("Workflow start rejection has contradictory ownership or execution evidence");
 	return r.id;
 };
-//#endregion
 export { t as readProvenSubmissionRejection };

package/dist/submissionRetry.js

@@ -1,7 +1,7 @@
 import { readAdmissionSubmission as e } from "./admissionSubmission.js";
 import { ADMISSIONS_TABLE as t } from "./admissionStore.js";
 import { eq as n } from "@voltro/database";
-//#region src/submissionRetry.ts
+// src/submissionRetry.ts
 var r = (e, t) => ({
 	kind: "refused",
 	submissionId: e,
@@ -67,5 +67,4 @@ var r = (e, t) => ({
 		expected: o
 	};
 };
-//#endregion
 export { o as inspectAdmissionSubmissionRetry, s as retryAdmissionSubmissionInTransaction };

package/dist/suspensionUnavailable.js

@@ -1,9 +1,8 @@
 import { Context as e } from "effect";
-//#region src/suspensionUnavailable.ts
+// src/suspensionUnavailable.ts
 var t = e.Reference("@voltro/workflow/SuspensionUnavailable", { defaultValue: () => void 0 }), n = class extends Error {
 	constructor(e, t) {
 		super(`${e} cannot wait for a durable result here: ${t}`), this.name = "WorkflowCannotPark";
 	}
 };
-//#endregion
 export { t as SuspensionUnavailable, n as WorkflowCannotPark };

package/dist/updates.js

@@ -4,7 +4,7 @@ import { CurrentWorkflowRunId as r, WorkflowRunRecorder as i } from "./recorder.
 import { terminalUpdates as a } from "./workflowReadSelections.js";
 import { Cause as o, Effect as s, Schema as c } from "effect";
 import { eq as l } from "@voltro/database";
-//#region src/updates.ts
+// src/updates.ts
 var u = async (e, t) => {
 	if (e) try {
 		await e.recordEvent(t);
@@ -83,5 +83,4 @@ var u = async (e, t) => {
 		execute: f
 	});
 };
-//#endregion
 export { f as awaitUpdate };

package/dist/watermarkTable.js

@@ -1,9 +1,8 @@
 import { id as e, table as t, timestamp as n } from "@voltro/database";
-//#region src/watermarkTable.ts
+// src/watermarkTable.ts
 var r = t("_voltro_workflow_watermarks", {
 	id: e({ prefix: "wfwm" }),
 	positionAt: n(),
 	updatedAt: n().default("now")
 });
-//#endregion
 export { r as _voltroWorkflowWatermarksTable };

package/dist/webCrypto.js

@@ -1,17 +1,4 @@
-import { Crypto as e, Effect as t, Layer as n, PlatformError as r } from "effect";
-//#region src/webCrypto.ts
-var i = e.make({
-	randomBytes: (e) => globalThis.crypto.getRandomValues(new Uint8Array(e)),
-	digest: (e, n) => t.tryPromise({
-		try: async () => new Uint8Array(await globalThis.crypto.subtle.digest(e, new Uint8Array(n).buffer)),
-		catch: (t) => r.systemError({
-			_tag: "Unknown",
-			module: "Crypto",
-			method: "digest",
-			description: `digest ${e} failed`,
-			cause: t
-		})
-	})
-}), a = n.succeed(e.Crypto, i);
-//#endregion
-export { i as webCrypto, a as webCryptoLayer };
+import { Digest as e } from "effect/crypto";
+// src/webCrypto.ts
+var t = e.layerWebCrypto;
+export { t as webCryptoLayer };

package/dist/workflowDelivery.js

@@ -1,5 +1,5 @@
 import { Context as e, Effect as t } from "effect";
-//#region src/workflowDelivery.ts
+// src/workflowDelivery.ts
 var n = "voltro-workflow-restart", r = class extends e.Service()("voltro/CurrentWorkflowDelivery") {}, i = (e) => ({
 	...e,
 	registerEntity: (n, i, a) => e.registerEntity(n, n.type.startsWith("Workflow/") ? i.pipe(t.map((e) => {
@@ -20,5 +20,4 @@ var n = "voltro-workflow-restart", r = class extends e.Service()("voltro/Current
 		};
 	})) : i, a)
 });
-//#endregion
 export { r as CurrentWorkflowDelivery, n as WORKFLOW_RESTART_HEADER, i as withWorkflowDelivery };

package/dist/workflowExecutorRouting.js

@@ -0,0 +1,32 @@
+import { journalExecutorGroups as e } from "./journalRoutingLayout.js";
+import { WorkflowEngine as t } from "effect/workflow";
+import { Context as n, Effect as r, Layer as i, Option as a } from "effect";
+// src/workflowExecutorRouting.ts
+var o = n.Service("@voltro/workflow/WorkflowExecutorRouting"), s = (e, t, r, i, a) => n.add(e, o, Object.freeze({
+	engine: t,
+	mode: r,
+	state: i,
+	groups: a ?? Object.freeze({
+		available: Object.freeze(["default"]),
+		assigned: Object.freeze(r === "client" ? [] : ["default"])
+	})
+})), c = (n, s) => {
+	let c = Object.freeze({
+		workflows: s.workflows,
+		schedules: s.schedules,
+		webhooks: s.webhooks
+	});
+	if (Object.values(c).some((e) => typeof e != "boolean")) throw Error("Explicit executor selection is required");
+	let l = Object.values(c).every(Boolean), u = Object.values(c).some(Boolean), d = r.gen(function* () {
+		let n = yield* r.serviceOption(t.WorkflowEngine);
+		if (a.isNone(n)) return yield* r.die(/* @__PURE__ */ Error("Executor registration requires a workflow engine"));
+		let i = yield* r.serviceOption(o);
+		if (a.isNone(i)) return l ? void 0 : yield* r.die(/* @__PURE__ */ Error("Selected executor roles require an engine routing contract"));
+		let s = i.value;
+		if (s.engine !== n.value || s.mode !== (u ? "worker" : "client")) return yield* r.die(/* @__PURE__ */ Error("Executor roles do not match the provided workflow engine"));
+		let d = yield* r.sync(() => e(s.state?.layout ?? "default", c)), f = (e, t) => e.length === t.length && e.every((e) => t.includes(e));
+		if (!f(s.groups.available, d.available) || !f(s.groups.assigned, d.assigned)) return yield* r.die(/* @__PURE__ */ Error("Executor roles do not match the engine shard ownership"));
+	});
+	return i.effectDiscard(d).pipe(i.provideMerge(n));
+};
+export { s as recordWorkflowExecutorRouting, c as withWorkflowExecutorSelection };

package/dist/workflowJournal.js

@@ -1,7 +1,7 @@
 import { latestExitReply as e } from "./workflowReadSelections.js";
 import { Context as t, Effect as n, Option as r, Schema as i } from "effect";
 import { ClusterSchema as a, EntityAddress as o, EntityId as s, EntityType as c, MessageStorage as l, Sharding as u } from "effect/cluster";
-//#region src/workflowJournal.ts
+// src/workflowJournal.ts
 var d = (e, t) => `${e}/${t}`, f = (e, n, r) => {
 	let i = s.make(n), l = t.get(e.annotations, a.ShardGroup)(i);
 	return new o.EntityAddress({
@@ -120,5 +120,4 @@ var d = (e, t) => `${e}/${t}`, f = (e, n, r) => {
 		reason: "run-reset-unconfirmed"
 	};
 });
-//#endregion
 export { m as JournalExit, d as activityPrimaryKey, g as classifyRunReply, p as readWorkflowRunReply, _ as redriveFailedRun, v as resumeRunFromStep, f as runEntityAddress };

package/dist/workflowJournalReset.js

@@ -1,7 +1,7 @@
 import { WORKFLOW_RESTART_HEADER as e } from "./workflowDelivery.js";
 import { Effect as t, Schema as n } from "effect";
 import { SqlClient as r } from "effect/sql";
-//#region src/workflowJournalReset.ts
+// src/workflowJournalReset.ts
 var i = n.fromJsonString(n.Struct({
 	_tag: n.Literal("Success"),
 	value: n.Struct({ _tag: n.Literal("Suspended") })
@@ -107,5 +107,4 @@ var i = n.fromJsonString(n.Struct({
 		};
 	}).pipe(d.withTransaction, t.provideService(r.SafeIntegers, !0));
 }), c = (e, t) => s(e, t === void 0 ? {} : { restart: t }), l = (e) => s([e], { suspension: e });
-//#endregion
 export { o as observeWorkflowSuspension, c as resetExpectedWorkflowReplies, l as resetExpectedWorkflowSuspension };

package/dist/workflowReadSelections.js

@@ -1,4 +1,4 @@
-//#region src/workflowReadSelections.ts
+// src/workflowReadSelections.ts
 var e = (e) => e.findLast((e, t, n) => t in n && e._tag === "WithExit"), t = (e) => {
 	let t = /* @__PURE__ */ new Set();
 	for (let n of e) {
@@ -8,5 +8,4 @@ var e = (e) => e.findLast((e, t, n) => t in n && e._tag === "WithExit"), t = (e)
 	}
 	return t;
 };
-//#endregion
 export { e as latestExitReply, t as terminalUpdates };

package/dist/workflowRestartDispatch.js

@@ -1,29 +1,34 @@
-import { resetReservedWorkflowJournal as e } from "./workflowRestartReservation.js";
-import { prepareWorkflowRestartCommand as t } from "./workflowRestartPreparation.js";
-import { observeWorkflowRestartReplies as n } from "./workflowRestartObservation.js";
-import { Context as r, Effect as i } from "effect";
-import { SqlClient as a } from "effect/sql";
-import { MessageStorage as o, Sharding as s } from "effect/cluster";
-//#region src/workflowRestartDispatch.ts
-var c = (t) => i.gen(function* () {
-	let n = yield* e(t);
-	return n.kind === "waiting-capacity" ? n : (yield* (yield* s.Sharding).pollStorage, {
+import { JournalRoutingGuard as e, protectJournalRoutingEffect as t, tryOwnedJournalRoutingPromise as n } from "./journalRoutingGuard.js";
+import { resetReservedWorkflowJournal as r } from "./workflowRestartReservation.js";
+import { JournalRoutingLayout as i, routeJournalWorkflow as a } from "./journalRoutingRuntime.js";
+import { prepareWorkflowRestartCommand as o } from "./workflowRestartPreparation.js";
+import { observeWorkflowRestartReplies as s } from "./workflowRestartObservation.js";
+import { Context as c, Effect as l, Option as u } from "effect";
+import { SqlClient as d } from "effect/sql";
+import { MessageStorage as f, Sharding as p } from "effect/cluster";
+// src/workflowRestartDispatch.ts
+var m = (e) => l.gen(function* () {
+	let t = yield* r(e);
+	return t.kind === "waiting-capacity" ? t : (yield* (yield* p.Sharding).pollStorage, {
 		kind: "attempted",
-		journal: n
+		journal: t
 	});
-}), l = class extends r.Service()("@voltro/workflow/WorkflowRestartDispatcher") {}, u = i.gen(function* () {
-	let e = yield* a.SqlClient, r = yield* s.Sharding, u = yield* o.MessageStorage, d = (t) => n(t).pipe(i.provideService(a.SqlClient, e), i.provideService(s.Sharding, r), i.provideService(o.MessageStorage, u));
-	return l.of({
-		prepare: (e) => i.tryPromise({
-			try: (n) => t({
-				...e,
-				observe: (e) => i.runPromise(d(e), { signal: n })
-			}),
-			catch: (e) => e
-		}),
-		observe: d,
-		dispatch: (t) => c(t).pipe(i.provideService(a.SqlClient, e), i.provideService(s.Sharding, r))
+}), h = class extends c.Service()("@voltro/workflow/WorkflowRestartDispatcher") {}, g = l.gen(function* () {
+	let r = u.getOrUndefined(yield* l.serviceOption(e)), c = u.getOrUndefined(yield* l.serviceOption(i)), g = yield* d.SqlClient, _ = yield* p.Sharding, v = yield* f.MessageStorage, y = (e) => t(r, s(c === void 0 ? e : {
+		...e,
+		workflow: a(e.workflow, c)
+	})).pipe(l.provideService(d.SqlClient, g), l.provideService(p.Sharding, _), l.provideService(f.MessageStorage, v));
+	return h.of({
+		prepare: (e) => t(r, n((t) => o({
+			...e,
+			transaction: (n) => {
+				if (t.throwIfAborted(), r?.isClosed()) throw Error("Journal routing admission is closed");
+				return e.transaction(n);
+			},
+			observe: (e) => l.runPromise(y(e), { signal: t })
+		}))),
+		observe: y,
+		dispatch: (e) => t(r, m(e)).pipe(l.provideService(d.SqlClient, g), l.provideService(p.Sharding, _))
 	});
 });
-//#endregion
-export { l as WorkflowRestartDispatcher, c as dispatchWorkflowRestart, u as makeWorkflowRestartDispatcher };
+export { h as WorkflowRestartDispatcher, m as dispatchWorkflowRestart, g as makeWorkflowRestartDispatcher };

package/dist/workflowRestartObservation.js

@@ -3,7 +3,7 @@ import { activityPrimaryKey as e, classifyRunReply as t, runEntityAddress as n }
 import { Effect as r, Option as i, Schema as a } from "effect";
 import { SqlClient as o } from "effect/sql";
 import { MessageStorage as s, Sharding as c } from "effect/cluster";
-//#region src/workflowRestartObservation.ts
+// src/workflowRestartObservation.ts
 var l = a.fromJsonString(a.Record(a.String, a.String)), u = (u) => r.gen(function* () {
 	if (!/^[1-9]\d*$/.test(u.delivery.requestId) || u.executionId.length === 0 || u.activities.some((e) => e.name.length === 0 || !Number.isSafeInteger(e.attempt) || e.attempt < 1)) return yield* r.die(/* @__PURE__ */ Error("Restart observation requires an exact delivery and valid activity attempts"));
 	let d = (yield* o.SqlClient).withoutTransforms(), f = yield* s.MessageStorage, p = yield* c.Sharding, m = n(u.workflow, u.executionId, p), h = (e, t) => r.gen(function* () {
@@ -56,5 +56,4 @@ var l = a.fromJsonString(a.Record(a.String, a.String)), u = (u) => r.gen(functio
 		}))
 	};
 }).pipe(r.provideService(o.SafeIntegers, !0));
-//#endregion
 export { u as observeWorkflowRestartReplies };

package/dist/workflowRestartPreparation.js

@@ -1,7 +1,7 @@
 import { readWorkflowRestartCommandInTransaction as e, readWorkflowRestartReservationInTransaction as t, reserveWorkflowRestartInTransaction as n } from "./workflowRestartReservation.js";
 import { Schema as r } from "effect";
 import { eq as i } from "@voltro/database";
-//#region src/workflowRestartPreparation.ts
+// src/workflowRestartPreparation.ts
 var a = async (t) => {
 	if (t.workflow._tag !== t.command.workflowName || t.control.workflowName !== t.command.workflowName) throw Error("Restart preparation requires the matching workflow");
 	let n = await t.transaction(async (n) => {
@@ -105,5 +105,4 @@ var a = async (t) => {
 		});
 	});
 };
-//#endregion
 export { s as prepareWorkflowRestart, a as prepareWorkflowRestartCommand };