@voltro/workflow 0.87.0 → 0.88.0

package/dist/admission.js

@@ -1,4 +1,4 @@
-//#region src/admission.ts
+// src/admission.ts
 var e = class extends Error {
 	workflowName;
 	field;
@@ -136,5 +136,4 @@ var e = class extends Error {
 	let r = e.timeouts?.finishMs;
 	return r === void 0 || t.terminal ? !1 : n - t.startedAt >= r;
 }, u = (e, t) => e.priority === t.priority ? e.firstSeenAt === t.firstSeenAt ? e.id < t.id ? -1 : +(e.id > t.id) : e.firstSeenAt - t.firstSeenAt : t.priority - e.priority;
-//#endregion
 export { e as FlowControlKeyError, u as comparePendingOrder, a as decideAdmission, l as isFinishExpired, c as isStartExpired, i as nextSlotAt, n as pooledConcurrencyKey, r as resolveAdmissionKeys };

package/dist/admissionDrainer.js

@@ -16,7 +16,7 @@ import { forwardStartReceipts as L } from "./forwardStartReceipts.js";
 import { Schema as R } from "effect";
 import { eq as z } from "@voltro/database";
 import { randomUUID as B } from "node:crypto";
-//#region src/admissionDrainer.ts
+// src/admissionDrainer.ts
 var V = {
 	scanned: 0,
 	admitted: 0,
@@ -604,7 +604,10 @@ var V = {
 		evicted: 0
 	}, i, n.batch !== void 0, r);
 	let o = await e.transaction((e) => f(e, t.id));
-	if (o?.executionId == null || o.executionId !== o.preparedExecutionId) throw Error("Admission submission has no confirmed engine acceptance");
+	if (o?.executionId == null || o.executionId !== o.preparedExecutionId) {
+		let e = /* @__PURE__ */ Error("Admission submission has no confirmed engine acceptance");
+		throw o !== void 0 && o.receiptsBound && o.failureId === null && o.executionId === null && o.runId === null && (o.preparedExecutionId === null ? o.dispatchAttempts === 0 : o.preparedExecutionId.length > 0) && o.workflowName === a.workflowName && o.tenantId === a.tenantId && o.ledgerId === a.ledgerId ? new U(t.id, e) : e;
+	}
 	return o.executionId;
 }, $ = async (e, t, n, r, i, a, o) => {
 	let s = t.dispatchAttempts === 0 ? 0 : void 0, u = t.retry.recovery?.attempts ?? 0;
@@ -701,5 +704,4 @@ var V = {
 		...i === void 0 ? {} : { nextDeadlineAt: i }
 	};
 };
-//#endregion
 export { H as DEFAULT_DRAIN_BATCH, ee as acceptAdmissionSubmission, G as drainTick, W as isUnacknowledgedSubmission };

package/dist/admissionGate.js

@@ -1,7 +1,7 @@
 import { resolveAdmissionKeys as e } from "./admission.js";
 import { decodePendingPayload as t, evaluateAdmission as n, persistDefer as r, recordAdmission as i } from "./admissionStore.js";
 import { and as a, eq as o } from "@voltro/database";
-//#region src/admissionGate.ts
+// src/admissionGate.ts
 var s = async (t) => {
 	let { store: a, control: o, now: s } = t, l = e(o, t.payload), u = await n({
 		store: a,
@@ -111,5 +111,4 @@ var s = async (t) => {
 		runId: r
 	});
 };
-//#endregion
 export { s as admitStart, l as linkExecution };

package/dist/admissionStore.js

@@ -4,7 +4,7 @@ import { comparePendingOrder as r, decideAdmission as i } from "./admission.js";
 import { settlePendingStartReceipts as a } from "./startReceipt.js";
 import { and as o, eq as s, gt as c, isNull as l, or as u } from "@voltro/database";
 import { createHash as d, randomUUID as f } from "node:crypto";
-//#region src/admissionStore.ts
+// src/admissionStore.ts
 var p = "_voltro_workflow_pending", m = "_voltro_workflow_admissions", h = "_voltro_workflow_pauses", g = (e) => o(l("releasedAt"), u(l("executionId"), c("expiresAt", new Date(e)))), _ = (e, t, n) => e.encodeWorkflowPayload === void 0 ? n : e.encodeWorkflowPayload(t, n), v = (e, t, n) => e.decodeWorkflowPayload === void 0 ? n : e.decodeWorkflowPayload(t, n), y = 864e5, b = (e, t, n) => `wfp_${d("sha256").update(`${e}\u0000${t}\u0000${n}`).digest("hex").slice(0, 40)}`, x = (e) => {
 	if (e instanceof Date) return e.getTime();
 	if (typeof e == "number") return e;
@@ -343,5 +343,4 @@ var p = "_voltro_workflow_pending", m = "_voltro_workflow_admissions", h = "_vol
 	}], n)), i = t.getTime(), a = r.filter((e) => e.releasedAt != null && x(e.admittedAt) < i);
 	return await Promise.all(a.map((t) => e.delete(m, String(t.id)))), a.length;
 };
-//#endregion
 export { m as ADMISSIONS_TABLE, y as DEFAULT_LEASE_MS, h as PAUSES_TABLE, p as PENDING_TABLE, g as admissionLeaseHeldPredicate, L as allIntents, U as deadLetterIntent, v as decodePendingPayload, R as deleteIntent, z as discardIntent, B as discardIntentInTransaction, F as dueIntents, _ as encodePendingPayload, G as evaluateAdmission, H as noteIntentAttempt, j as parkDelayedStart, E as pauseWorkflow, b as pendingSlotId, I as pendingWindow, A as persistDefer, K as pruneAdmissions, O as readAdmissionState, T as readPausedWorkflows, N as recordAdmission, P as releaseLease, D as resumeWorkflow, V as retryBackoffMs, W as retryDeadLetterIntent, C as toPendingIntent };

package/dist/admissionSubmission.js

@@ -9,7 +9,7 @@ import { Schema as f } from "effect";
 import { and as p, eq as m, gt as h, isNull as g } from "@voltro/database";
 import { createHash as _, randomUUID as v } from "node:crypto";
 import { isDeepStrictEqual as y } from "node:util";
-//#region src/admissionSubmission.ts
+// src/admissionSubmission.ts
 var b = "_voltro_workflow_submissions", x = "wfsub", S = () => `${x}_${v()}`, C = f.Struct({
 	id: f.String,
 	workflowName: f.String,
@@ -293,5 +293,4 @@ var E = async (e, t, n) => (await D(e, t, n)).map((e) => w(e)), D = async (e, t,
 	if (await e.update("_voltro_workflow_submissions", t, { failureId: u }) === null) throw Error("Admission submission disappeared during rejection");
 	return await a(e, d.id, s.now), d;
 };
-//#endregion
 export { x as ADMISSION_SUBMISSION_ID_PREFIX, b as SUBMISSIONS_TABLE, M as acknowledgeAdmissionSubmission, N as acknowledgeAdmissionSubmissionInTransaction, I as beginAdmissionSubmissionDispatchInTransaction, w as decodeAdmissionSubmission, T as dispatchedExecutionSubmissions, S as newAdmissionSubmissionId, F as noteAdmissionSubmissionFailure, E as pendingAdmissionSubmissions, j as persistReservedSubmission, P as prepareAdmissionSubmissionExecutionInTransaction, O as readAdmissionSubmission, D as readPendingAdmissionSubmissionRows, L as rejectAdmissionSubmissionInTransaction, k as reserveAdmissionSubmission, A as reserveAdmissionSubmissionInTransaction };

package/dist/admissionTables.js

@@ -1,5 +1,5 @@
 import { boolean as e, id as t, integer as n, json as r, real as i, table as a, text as o, timestamp as s } from "@voltro/database";
-//#region src/admissionTables.ts
+// src/admissionTables.ts
 var c = a("_voltro_workflow_admission_locks", {
 	id: t({ prefix: "wfalk" }),
 	nonce: o()
@@ -67,8 +67,9 @@ var c = a("_voltro_workflow_admission_locks", {
 	payload: r(),
 	callerContext: r().nullable(),
 	intentIds: r(),
-	eviction: r().nullable()
-}).nonReactive(), p = a("_voltro_workflow_start_receipts", {
+	eviction: r().nullable(),
+	poolReleaseSettledAt: s().nullable()
+}).index("_voltro_workflow_submissions_pool_settlement_idx", ["poolReleaseSettledAt", "id"]).nonReactive(), p = a("_voltro_workflow_start_receipts", {
 	id: t({ prefix: "wfrc" }),
 	workflowName: o(),
 	tenantId: o().nullable(),
@@ -133,5 +134,4 @@ var c = a("_voltro_workflow_admission_locks", {
 	pausedBy: o().nullable(),
 	reason: o().nullable()
 });
-//#endregion
 export { c as _voltroWorkflowAdmissionLocksTable, h as _voltroWorkflowAdmissionsTable, u as _voltroWorkflowControlRequestsTable, d as _voltroWorkflowFailureReportsTable, l as _voltroWorkflowParentClosuresTable, g as _voltroWorkflowPausesTable, m as _voltroWorkflowPendingTable, p as _voltroWorkflowStartReceiptsTable, f as _voltroWorkflowSubmissionsTable };

package/dist/admissionTransaction.js

@@ -1,6 +1,6 @@
 import { eq as e } from "@voltro/database";
 import { randomUUID as t } from "node:crypto";
-//#region src/admissionTransaction.ts
+// src/admissionTransaction.ts
 var n = "_voltro_workflow_admission_locks", r = "deployment", i = async (i, a) => (await i.insertIgnoreWithOutcome(n, {
 	id: r,
 	nonce: t()
@@ -17,5 +17,4 @@ var n = "_voltro_workflow_admission_locks", r = "deployment", i = async (i, a) =
 	if (await n.update("_voltro_workflow_admission_locks", r, { nonce: t() }) === null) throw Error("Admission coordinator row disappeared; refusing an unlocked decision");
 	return a(n);
 }));
-//#endregion
 export { n as ADMISSION_LOCKS_TABLE, i as withAdmissionTransaction };

package/dist/awaitEvent.js

@@ -2,7 +2,7 @@ import { encryptionAwareActivity as e } from "./journalEncryption.js";
 import { CurrentWorkflowRunId as t, WorkflowRunRecorder as n } from "./recorder.js";
 import { Effect as r, Schema as i } from "effect";
 import { and as a, eq as o, gte as s } from "@voltro/database";
-//#region src/awaitEvent.ts
+// src/awaitEvent.ts
 var c = async (e, t) => {
 	if (e !== void 0) try {
 		await e.recordEvent(t);
@@ -78,5 +78,4 @@ var c = async (e, t) => {
 	}
 	return /* @__PURE__ */ new Date(0);
 });
-//#endregion
 export { l as awaitEvent };

package/dist/budgetHold.js

@@ -1,7 +1,7 @@
 import { awaitSignalSuspending as e, completeSuspendingSignal as t } from "./signalsSuspending.js";
 import { Cause as n, Effect as r, Schema as i } from "effect";
 import { and as a, eq as o, generateId as s, id as c, isNull as l, registerRetention as u, retentionTtlMsFromEnv as d, table as f, text as p, timestamp as m } from "@voltro/database";
-//#region src/budgetHold.ts
+// src/budgetHold.ts
 var h = "_voltro_budget_holds", g = "budget-hold", _ = (e) => `${g}:${e}`, v = (e) => `${e.executionId}/${e.stepName}/${e.budget}#${e.generation}`, y = async (e, t) => (await e.query({
 	table: h,
 	predicate: a(o("executionId", t.executionId), o("stepName", t.stepName), o("budget", t.budget)),
@@ -132,5 +132,4 @@ var h = "_voltro_budget_holds", g = "budget-hold", _ = (e) => `${g}:${e}`, v = (
 	}
 	return [...n.values()];
 };
-//#endregion
 export { h as BUDGET_HOLDS_TABLE, S as BudgetHoldExpired, C as DEFAULT_BUDGET_HOLD_TIMEOUT_MS, w as DEFAULT_BUDGET_RECHECK_MS, b as _voltroBudgetHoldsTable, y as budgetHoldGeneration, v as budgetHoldKey, _ as budgetHoldSignalName, j as heldBudgets, A as pendingBudgetHolds, k as releaseBudgetHolds, T as suspendForBudget };

package/dist/cancelOnPlan.js

@@ -1,5 +1,5 @@
 import { Result as e, Schema as t } from "effect";
-//#region src/cancelOnPlan.ts
+// src/cancelOnPlan.ts
 var n = (e) => {
 	let t = e instanceof Error ? e.message : String(e);
 	return t.length > 400 ? `${t.slice(0, 400)}…` : t;
@@ -71,5 +71,4 @@ var n = (e) => {
 	for (let n of e) (t === void 0 || n.occurredAt.getTime() > t.getTime()) && (t = n.occurredAt);
 	return t;
 };
-//#endregion
 export { i as newestEventAt, r as planCancellations };

package/dist/cancelOnSweep.js

@@ -1,6 +1,6 @@
 import { newestEventAt as e, planCancellations as t } from "./cancelOnPlan.js";
 import { and as n, eq as r, gte as i } from "@voltro/database";
-//#region src/cancelOnSweep.ts
+// src/cancelOnSweep.ts
 var a = "_voltro_workflow_watermarks", o = "_voltro_workflow_events", s = "cancelOn", c = 36e5, l = 500, u = 2e3, d = (e) => {
 	if (e instanceof Date) return e;
 	if (typeof e == "number") return new Date(e);
@@ -184,5 +184,4 @@ var a = "_voltro_workflow_watermarks", o = "_voltro_workflow_events", s = "cance
 		watermark: A
 	};
 };
-//#endregion
 export { s as CANCEL_ON_WATERMARK, c as DEFAULT_COLD_LOOKBACK_MS, l as DEFAULT_EVENT_BATCH, u as DEFAULT_RUN_PAGE, o as EVENTS_TABLE, a as WATERMARKS_TABLE, p as readWatermark, _ as sweepCancelOn, m as writeWatermark };

package/dist/cancelPendingStart.js

@@ -2,7 +2,7 @@ import { readAdmissionSubmission as e } from "./admissionSubmission.js";
 import { readWorkflowStartReceipt as t, settlePendingStartReceipts as n } from "./startReceipt.js";
 import { PENDING_TABLE as r, toPendingIntent as i } from "./admissionStore.js";
 import { eq as a } from "@voltro/database";
-//#region src/cancelPendingStart.ts
+// src/cancelPendingStart.ts
 var o = async (o, s) => {
 	if (!Number.isFinite(s.now) || !Number.isFinite(new Date(s.now).getTime())) throw Error("Queued cancellation requires a valid timestamp");
 	let c = await t(o, s.receiptId);
@@ -46,5 +46,4 @@ var o = async (o, s) => {
 		outcome: d
 	};
 };
-//#endregion
 export { o as cancelPendingWorkflowStartInTransaction };

package/dist/clusterCron.js

@@ -1,7 +1,7 @@
 import { captureWorkflowShardGroups as e } from "./clusterShardGroups.js";
 import { Duration as t, Effect as n } from "effect";
 import { ClusterCron as r } from "effect/cluster";
-//#region src/clusterCron.ts
+// src/clusterCron.ts
 var i = (i) => {
 	let a = i.shardGroup;
 	return a !== void 0 && e({
@@ -15,5 +15,4 @@ var i = (i) => {
 		skipIfOlderThan: i.skipIfOlderThan ?? t.days(1)
 	});
 };
-//#endregion
 export { i as makeClusterCronLayer };

package/dist/clusterDiagnostics.js

@@ -1,5 +1,5 @@
 import { Context as e, Effect as t } from "effect";
-//#region src/clusterDiagnostics.ts
+// src/clusterDiagnostics.ts
 var n = 6e5, r = class extends e.Service()("@voltro/workflow/ClusterDiagnostics") {}, i = (e, n, r = Date.now()) => t.flatMap(e.messagesFor(n), (n) => {
 	if (n.length === 0) return t.succeed(void 0);
 	let i = [...new Set(n.filter((e) => !e.processed).map((e) => e.shardId))], a = i.length === 0 ? t.succeed([]) : e.shardLockHolders(i);
@@ -16,5 +16,4 @@ var n = 6e5, r = class extends e.Service()("@voltro/workflow/ClusterDiagnostics"
 		shardLocks: t
 	}));
 });
-//#endregion
 export { n as CLUSTER_REREAD_WINDOW_MS, r as ClusterDiagnostics, i as describeStalledRun };

package/dist/clusterDiagnosticsSql.js

@@ -1,7 +1,7 @@
 import { CLUSTER_REREAD_WINDOW_MS as e } from "./clusterDiagnostics.js";
 import { Effect as t } from "effect";
 import { SqlClient as n } from "effect/sql";
-//#region src/clusterDiagnosticsSql.ts
+// src/clusterDiagnosticsSql.ts
 var r = (e) => {
 	if (e instanceof Date) return Number.isNaN(e.getTime()) ? null : e;
 	if (typeof e == "string" || typeof e == "number") {
@@ -141,5 +141,4 @@ var r = (e) => {
 		}
 	};
 });
-//#endregion
 export { o as clusterLockNamespaceOid, c as makeClusterDiagnostics };

package/dist/clusterLayer.js

@@ -20,7 +20,7 @@ import { SqlClient as w } from "effect/sql";
 import { ClusterWorkflowEngine as T, MessageStorage as E, RunnerAddress as D, ShardId as O, Sharding as k } from "effect/cluster";
 import { sqlPoolCapacity as A } from "@voltro/database/sql";
 import { createLogger as j } from "@voltro/logger";
-//#region src/clusterLayer.ts
+// src/clusterLayer.ts
 var M = j({ scope: "voltro:workflow" }), N = 34e3, P = (e) => {
 	let t = e.runnerListenHost ?? process.env.POD_IP ?? process.env.VOLTRO_WORKFLOW_RUNNER_HOST ?? "localhost";
 	return {
@@ -141,5 +141,4 @@ var M = j({ scope: "voltro:workflow" }), N = 34e3, P = (e) => {
 	}), oe = v.layer.pipe(S.provide(v.layerStoreMemory));
 	return S.merge(ie, oe).pipe(S.provideMerge(ae), S.flatMap((e) => S.succeedContext(o(e, y.get(e, _.WorkflowEngine), N, L, V))));
 };
-//#endregion
 export { N as DEFAULT_RUNNER_LISTEN_PORT, L as detectWsrepCluster, I as parseShardLockMode, V as pollWorkflowStorage, B as resolveFailoverTuning, P as resolveRunnerIdentity, F as resolveRunnerStorage, R as resolveShardLockDisableAdvisory, z as shardLockLogFields, W as workflowEngineLayer };

package/dist/clusterMigrationGate.js

@@ -3,7 +3,7 @@ import { Effect as t, Layer as n } from "effect";
 import { SqlClient as r } from "effect/sql";
 import { ShardingConfig as i, SqlMessageStorage as a, SqlRunnerStorage as o } from "effect/cluster";
 import { applyUndeclaredCharsetWork as s, fnv1a64 as c, readUndeclaredCharsetColumns as l, resolveMigrationLockSchema as u, sqlPoolCapacity as d, undeclaredCharsetWork as f } from "@voltro/database/sql";
-//#region src/clusterMigrationGate.ts
+// src/clusterMigrationGate.ts
 var p = 6322741009312601n, m = () => {
 	let e = u();
 	return e === void 0 ? p : c(`voltro_cluster_migration_lock:${e}`) & 9223372036854775807n;
@@ -57,5 +57,4 @@ var p = 6322741009312601n, m = () => {
 	let n = yield* r.SqlClient, i = k(e.runnerStorage), a = d(n);
 	return a !== void 0 && a < i ? yield* t.die(/* @__PURE__ */ Error(`the workflow runtime needs ${i} database connections at once and the pool has ${a}: ` + (e.runnerStorage === "sql" ? "on a first boot it holds its migration lock and its runner lock while the migration runs on a third, and once running it keeps the runner lock and needs one more to work. " : "on a first boot it holds its migration lock while the migration runs on a second. ") + `Set DB_MAX_CONNECTIONS (or PG_MAX_CONNECTIONS) to at least ${i}` + (e.runnerStorage === "sql" ? ", or VOLTRO_WORKFLOW_RUNNER_STORAGE=memory for a single-process runtime that needs 2 (no cross-pod shard handoff)." : "."))) : ((yield* w(n, e.runnerStorage)) || (yield* x(n, O(n, e.runnerStorage, e.charset))), n);
 }));
-//#endregion
 export { k as clusterConnectionFloor, A as clusterMigrationGateLayer, C as tableExists, x as withClusterMigrationLock };

package/dist/clusterRunnerLayer.js

@@ -7,7 +7,7 @@ import { guardRunnerStorage as o } from "./runnerStorageGuard.js";
 import { Effect as s, Layer as c, Option as l, Semaphore as u } from "effect";
 import { SqlClient as d } from "effect/sql";
 import { MessageStorage as f, RunnerHealth as p, RunnerStorage as m, Runners as h, Sharding as g, ShardingConfig as _, SqlMessageStorage as v, SqlRunnerStorage as y } from "effect/cluster";
-//#region src/clusterRunnerLayer.ts
+// src/clusterRunnerLayer.ts
 var b = (e) => s.map(u.make(1), (t) => ({
 	...e,
 	release: (n, r) => t.withPermits(1)(s.suspend(() => e.release(n, r)))
@@ -27,5 +27,4 @@ var b = (e) => s.map(u.make(1), (t) => ({
 	let r = yield* g.Sharding, a = yield* s.serviceOption(e), o = yield* s.serviceOption(t), c = l.isSome(o) ? n(r, o.value) : r;
 	return l.isSome(a) ? i(c, a.value) : c;
 })).pipe(c.provide(g.layer)), T = (e) => w.pipe(c.provideMerge(h.layerNoop), c.provideMerge(C), c.provide([e.runnerStorage === "memory" ? m.layerMemory : e.clientOnly ? c.orDie(x) : S(e.guard), p.layerNoop]), c.provide(_.layerFromEnv(e.shardingConfig)), c.provide(r));
-//#endregion
 export { T as clusterRunnerLayer, b as limitSqliteShardReleases };

package/dist/clusterShardGroups.js

@@ -1,4 +1,4 @@
-//#region src/clusterShardGroups.ts
+// src/clusterShardGroups.ts
 var e = (e, t) => {
 	if (e === void 0) return;
 	if (!e || typeof e != "object" || Array.isArray(e) || ![Object.prototype, null].includes(Object.getPrototypeOf(e))) throw Error("Workflow shard groups require a plain data object");
@@ -29,5 +29,4 @@ var e = (e, t) => {
 		assigned: a
 	});
 };
-//#endregion
 export { e as captureWorkflowShardGroups };

package/dist/clusterTestSuite.d.ts

@@ -36,6 +36,26 @@ export declare interface ClusterEngineFixture {
     readonly reachable: () => Promise<boolean>;
 }
 
+/** Test-runner operations supplied by the suite caller, outside the runtime graph. */
+export declare interface ClusterSuiteTestApi {
+    readonly describe: (name: string, body: () => void) => unknown;
+    readonly test: (name: string, body: (context: {
+        readonly skip: () => void;
+    }) => Promise<void>, timeoutMs?: number) => unknown;
+    readonly beforeAll: (body: () => Promise<void>, timeoutMs?: number) => unknown;
+    readonly afterEach: (body: () => void | Promise<void>) => unknown;
+    readonly expect: (actual: unknown, message?: string) => {
+        readonly toBe: (expected: unknown) => unknown;
+        readonly toEqual: (expected: unknown) => unknown;
+        readonly toContain: (expected: unknown) => unknown;
+        readonly toBeGreaterThan: (expected: number) => unknown;
+        readonly toBeGreaterThanOrEqual: (expected: number) => unknown;
+        readonly rejects: {
+            readonly toThrow: () => Promise<unknown>;
+        };
+    };
+}
+
 declare interface JournalRoutingState {
     readonly generation: number;
     readonly layout: string;
@@ -75,9 +95,9 @@ export declare const purgeClusterState: (fixture: ClusterEngineFixture) => Promi
  * `@voltro/sql-*` (or the workflow package) calls this from a thin
  * `cluster.<dialect>.integration.test.ts` with its fixture.
  */
-export declare const runClusterEngineSuite: (fixture: ClusterEngineFixture) => void;
+export declare const runClusterEngineSuite: (fixture: ClusterEngineFixture, tests: ClusterSuiteTestApi) => void;
 
-export declare const runJournalEncryptionSuite: (fixture: ClusterEngineFixture) => void;
+export declare const runJournalEncryptionSuite: (fixture: ClusterEngineFixture, tests: ClusterSuiteTestApi) => void;
 
 /**
  * Runner-storage backend for `effect/cluster.SingleRunner`.