@voltro/testing 0.72.0 → 0.73.0

package/CHANGELOG.md

@@ -39,6 +39,91 @@ _Changes staged for the next release accumulate here (rolled up from
 
 ---
 
+## [0.73.0] — 2026-09-17
+
+### Added
+
+- **Typed writes on the Effect channel — the row check and StoreError compose** — `@voltro/runtime`
+
+  `insertRow`, `insertManyRows`, `upsertRow`, `upsertRowOutcome` and `insertIgnoreRowOutcome` check their payload against the table — a required column the row omits is a compile error at the call site — and return a `Promise`. `EffectStore` carries every one of those operations on the typed error channel and takes `(table, row)` with an unchecked `Row`.
+
+  So the two properties excluded each other. A handler that wanted the row checked gave up `StoreError`; one that wanted the channel passed an unchecked row. There was no third option: wrapping a typed helper in `Effect.promise` runs the write outside the Effect and discards exactly the channel at issue.
+
+  Five helpers close it, with the same signatures over a store whose methods return Effects:
+
+  ```ts
+  const store = yield* EffectStore
+  const saved = yield* insertRowEffect(store, players, { tenantId, name })
+  const { row, outcome } = yield* upsertRowOutcomeEffect(store, players, player, {
+    conflictColumns: ['tenantId', 'externalId'],
+    update: ['name', 'score'],
+  })
+  ```
+
+  `EffectStore` satisfies each helper's store parameter structurally, so it is the argument at every call site. The row type, the conflict-key constraint and the return type are spelled as the Promise forms spell them, so moving between the two families means reading one signature rather than two.
+
+  One deliberate difference: `upsertRowOutcome` throws when a hand-written `DataStore` lacks `upsertWithOutcome`. `EffectStore` always provides it, so the Effect form does not carry that failure — an error case for an unreachable condition is one every caller must handle and none can trigger.
+
+### Fixed
+
+- **A module that re-exports the generated route builder is not a hand-roll** — `@voltro/cli`
+
+  `voltro doctor`'s `hand-route-module` rule read the importing file and asked whether it mentioned `.framework/routes.generated`. An app that keeps exactly one module importing the generated builder and re-exports it — so that a single file owns the dependency — therefore had every consumer of that alias reported, while using the typed builders the rule recommends.
+
+  The rule now resolves the imported module and stays silent when it re-exports the generated builder. A genuinely hand-maintained route or url module is reported as before.
+
+  An alias onto a generated artefact is the adoption of this rule, and a finding that fires on the adoption is an argument for deleting the seam that made it clean.
+- **The migration codemod no longer re-indents the body it rewrites** — `@voltro/cli`
+
+  `0.72.0/01_migration-context-raw` rewrites two lines per migration and produced diffs of 85 to 133 changed lines. Two causes, both removed.
+
+  A migration whose body is an expression — `up: (ctx) => Effect.gen(function* () { … })`, the common shape — was hoisted into a block so the `raw(reason)` binding had somewhere to live, which indented the entire body one level. The binding is placed inside the generator instead, so the body keeps its position and the change is the two lines it actually is.
+
+  Separately, every node any codemod inserted was printed with four-space indentation while this framework's own templates use two. That is fixed for all codemods, not just this one.
+
+  Neither changes what the codemod means. It changes whether the diff can be read — which matters here more than most, because every `raw(reason)` it writes is a placeholder its author has to fill in before committing.
+- **voltro serve refuses a serve bundle built by a different framework version** — `@voltro/cli`
+
+  `voltro serve` loads the precompiled serve bundle, and a bundle built before an upgrade imports perfectly — it simply runs the previous version's code. Nothing said so. Updating `@voltro/*` without re-running `voltro build` therefore left a process serving the old framework while the installed one had moved on, and the only way to notice was to recognise a log line's shape as belonging to the older release.
+
+  The bundle already carries the version that built it. `voltro serve` now reads it before importing and refuses when it disagrees with the installed CLI, naming both versions and the command that fixes it:
+
+  ```
+  FATAL: the serve bundle was built by @voltro/cli 0.71.1, but 0.72.0 is installed.
+    Serving it would run 0.71.1's code against 0.72.0's dependencies.
+    Rebuild it:  voltro build .
+  ```
+
+  A mismatch refuses rather than falling back to the slower boot path: it is a build error of the deployment, and quietly running a different version is the failure being fixed. A bundle carrying no version marker is left alone — those predate the marker and are not evidence of anything.
+- **A workflow step can reach the store under the test runner** — `@voltro/testing`
+
+  A workflow step may `yield* EffectStore`, and in production it gets one: the runtime provides the layer from the context's store. `makeWorkflowRunner` provided the step recorder and the workflow's own layer and nothing else, so the step died under test with
+
+  ```
+  Service not found: @voltro/EffectStore
+  ```
+
+  while the identical code ran in production. The only supported way to drive a workflow in a test could not run the form the framework documents, which left `Effect.promise` as the shape people shipped instead.
+
+  The runner now provides the same layer from the same place production does, from the context it already receives. A context without a store stays runnable, so a test that never touches the store does not acquire a requirement.
+- **The AI usage receipt key no longer refuses to migrate an existing ledger** — `@voltro/ai`, `@voltro/cli`
+
+  `_voltro_ai_usage.receiptKey` arrived NOT NULL with neither a default nor a backfill, so adding it to a database that already holds usage rows was refused:
+
+  ```
+  auto-migrate: REFUSED — 1 blocked operation(s):
+    - add-column [_voltro_ai_usage]: NOT NULL column on a table whose row count is unknown
+  auto-migrate failed — aborting boot
+  ```
+
+  The refusal was correct and its advice was not reachable: it asks whoever owns the declaration to add `.backfill()` or `.default()`, and this table is the framework's, not the app's. `VOLTRO_AUTO_MIGRATE=0` left the app on the previous schema and `voltro db apply` refused the same way before a deploy, so an upgrade could not be rolled out at all.
+
+  The column now derives a per-row value from the row's own id. A literal default could not do this job — the column is UNIQUE, so one value for every existing row collides on the second — and the derivation is computed per row rather than in SQL because string concatenation has no dialect-neutral spelling and this table ships on five.
+
+  A guard now plans every framework table against a populated database and fails on any column added since the last release that an app could not migrate onto. Two earlier shapes of that check were built and discarded, each disproved by its own measurement: both asked every framework column to be addable, and a column created together with its table never is.
+
+---
+
 ## [0.72.0] — 2026-09-16
 
 ### ⚠ BREAKING

package/dist/index.js

@@ -1,47 +1,47 @@
 import { AUTO_FILLED_COLUMNS as e, allRegisteredTables as t, changeDelete as n, changeInsert as r, changeSoftDelete as i, changeUpdate as a, clearRelationsRegistry as o, missingRequiredColumns as s, registerRelations as c } from "@voltro/database";
 import { Cause as l, Effect as u, Exit as d, Layer as f, Schema as p } from "effect";
 import { SubjectService as m, anonymousSubject as h, checkGuardsEffect as g, composeAuthStrategies as _, composeRpcInterceptors as v, eventRoute as y, systemSubject as b, tenantScopedSubject as ee } from "@voltro/protocol";
-import { EventBus as x, InMemoryDataStore as S, NO_ROW_FILTER as C, appValidation as te, applyRowFilterToDescriptor as ne, clearSystemStoreHandle as re, getRowFilter as w, getSystemStoreHandle as ie, makeAppAccess as ae, makeConnectionState as oe, makeDataLoader as se, makeEffectStoreLayer as ce, makeEventPublisher as le, makeFieldCipher as ue, makeOutboxFacade as de, makeSchemaRegistry as fe, publishEvent as pe, resolveRowFilterScopeFor as me, resolveTransactionSubject as he, runProvidedEffect as T, runWithDeadlockRetry as ge, setFieldCipher as _e, setSystemStoreHandle as E, wrapStoreWithMixinBehaviour as D } from "@voltro/runtime";
-import { installEnvSnapshot as ve } from "@voltro/env";
-import ye from "node:net";
-import { describe as be } from "vitest";
-import { collectPublicApiRoutes as xe, dispatchSharedPath as Se, restRoutesToHttpRoutes as Ce } from "@voltro/protocol/rest";
-import { createLogger as we } from "@voltro/logger";
-import { CurrentWorkflowRunId as Te, inMemoryWorkflowEngineLayer as Ee, makeInMemoryRecorder as De } from "@voltro/workflow";
+import { EventBus as x, InMemoryDataStore as S, NO_ROW_FILTER as C, appValidation as te, applyRowFilterToDescriptor as ne, clearSystemStoreHandle as re, getRowFilter as w, getSystemStoreHandle as ie, makeAppAccess as ae, makeConnectionState as oe, makeDataLoader as se, makeEffectStoreLayer as T, makeEventPublisher as ce, makeFieldCipher as le, makeOutboxFacade as ue, makeSchemaRegistry as de, publishEvent as fe, resolveRowFilterScopeFor as pe, resolveTransactionSubject as me, runProvidedEffect as E, runWithDeadlockRetry as he, setFieldCipher as ge, setSystemStoreHandle as D, wrapStoreWithMixinBehaviour as O } from "@voltro/runtime";
+import { installEnvSnapshot as _e } from "@voltro/env";
+import ve from "node:net";
+import { describe as ye } from "vitest";
+import { collectPublicApiRoutes as be, dispatchSharedPath as xe, restRoutesToHttpRoutes as Se } from "@voltro/protocol/rest";
+import { createLogger as Ce } from "@voltro/logger";
+import { CurrentWorkflowRunId as we, inMemoryWorkflowEngineLayer as Te, makeInMemoryRecorder as Ee } from "@voltro/workflow";
 //#region src/fixtureRow.ts
-var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
+var De = new Set(e), k = 0, A = () => ++k, Oe = (e, t) => {
 	if (t.oneOf && t.oneOf.length > 0) return t.oneOf[0];
 	if (t.enumValues && t.enumValues.length > 0) return t.enumValues[0];
 	let n = t.unique === !0;
 	switch (t.type) {
 		case "text":
 		case "id":
-		case "enum": return n ? `${e}-${++O}` : e;
-		case "reference": return t.referenceStorage === "numeric" ? n ? ++O : 0 : n ? `${e}-${++O}` : e;
+		case "enum": return n ? `${e}-${++k}` : e;
+		case "reference": return t.referenceStorage === "numeric" ? n ? ++k : 0 : n ? `${e}-${++k}` : e;
 		case "integer":
-		case "real": return n ? ++O : 0;
+		case "real": return n ? ++k : 0;
 		case "decimal":
-		case "bigint": return n ? String(++O) : "0";
+		case "bigint": return n ? String(++k) : "0";
 		case "boolean": return !1;
 		case "timestamp":
 		case "date": return /* @__PURE__ */ new Date(0);
 		default: throw Error(`fixtureRow: column '${e}' is a required '${t.type}' with no default, and fixtureRow can't synthesize a safe placeholder for that type. Pass it explicitly: fixtureRow(table, { ${e}: … }).`);
 	}
-}, A = (e, t = {}) => {
+}, j = (e, t = {}) => {
 	let n = {};
-	for (let r of s(e, t)) Oe.has(r) || (n[r] = ke(r, e.fields[r]));
+	for (let r of s(e, t)) De.has(r) || (n[r] = Oe(r, e.fields[r]));
 	return {
 		...n,
 		...t
 	};
-}, Ae = (e) => {
+}, ke = (e) => {
 	let t = {};
-	for (let [n, r] of Object.entries(e)) t[n] = typeof r == "function" ? r(k()) : r;
+	for (let [n, r] of Object.entries(e)) t[n] = typeof r == "function" ? r(A()) : r;
 	return t;
-}, je = (e) => {
+}, Ae = (e) => {
 	for (let [t, n] of Object.entries(e.fields)) if (n.type === "id") return t;
 	return "id";
-}, Me = async (e, t, n, r, i) => {
+}, je = async (e, t, n, r, i) => {
 	let a = {};
 	for (let o of s(t, n)) {
 		let n = t.fields[o];
@@ -49,29 +49,29 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 		let s = n.references();
 		if (i.includes(s.tableName)) throw Error(`defineFactory: creating '${t.tableName}' requires '${s.tableName}' via '${o}', and that reference is cyclic (${[...i, s.tableName].join(" → ")}). Insert one side first and pass the id: create(store, { ${o}: existing.id }).`);
 		let c = r[o];
-		a[o] = (c === void 0 ? await j(e, s, {}, {}, [...i, s.tableName]) : await c.create(e, {}))[n.referenceColumn ?? je(s)];
+		a[o] = (c === void 0 ? await M(e, s, {}, {}, [...i, s.tableName]) : await c.create(e, {}))[n.referenceColumn ?? Ae(s)];
 	}
 	return a;
-}, j = async (e, t, n, r, i) => {
+}, M = async (e, t, n, r, i) => {
 	let a = {
-		...await Me(e, t, n, r, i),
+		...await je(e, t, n, r, i),
 		...n
 	};
-	return e.insert(t.tableName, A(t, a));
-}, M = (e, t) => typeof e == "function" ? e(t) : e ?? {}, Ne = (e, t = {}) => {
+	return e.insert(t.tableName, j(t, a));
+}, N = (e, t) => typeof e == "function" ? e(t) : e ?? {}, Me = (e, t = {}) => {
 	let n = t.traits ?? {}, r = t.associations ?? {}, i = (t) => {
 		let a = (e = {}) => ({
-			...Ae(t),
+			...ke(t),
 			...e
-		}), o = (t = {}) => A(e, a(t));
+		}), o = (t = {}) => j(e, a(t));
 		return {
 			table: e,
 			build: o,
-			buildList: (e, t) => Array.from({ length: e }, (e, n) => o(M(t, n))),
-			create: (t, n = {}) => j(t, e, a(n), r, [e.tableName]),
+			buildList: (e, t) => Array.from({ length: e }, (e, n) => o(N(t, n))),
+			create: (t, n = {}) => M(t, e, a(n), r, [e.tableName]),
 			createList: async (t, n, i) => {
 				let o = [];
-				for (let s = 0; s < n; s++) o.push(await j(t, e, a(M(i, s)), r, [e.tableName]));
+				for (let s = 0; s < n; s++) o.push(await M(t, e, a(N(i, s)), r, [e.tableName]));
 				return o;
 			},
 			with: (...r) => {
@@ -93,19 +93,19 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 		};
 	};
 	return i(t.defaults ?? {});
-}, N = Symbol.for("voltro/testing/mockClock.installed"), P = () => globalThis, Pe = (e, t) => new Proxy(e, {
+}, P = Symbol.for("voltro/testing/mockClock.installed"), F = () => globalThis, Ne = (e, t) => new Proxy(e, {
 	construct: (e, n, r) => Reflect.construct(e, n.length === 0 ? [t()] : n, r),
 	apply: () => new e(t()).toString(),
 	get: (e, n, r) => n === "now" ? () => t() : Reflect.get(e, n, r)
-}), F = (e) => {
+}), I = (e) => {
 	if (typeof e == "number") return e;
 	let t = e instanceof Date ? e.getTime() : Date.parse(e);
 	if (Number.isNaN(t)) throw Error(`mockClock: cannot read an instant from '${String(e)}'`);
 	return t;
-}, I = class {
+}, L = class {
 	currentMs;
 	constructor(e = "2026-01-01T00:00:00Z") {
-		this.currentMs = F(e);
+		this.currentMs = I(e);
 	}
 	now() {
 		return this.currentMs;
@@ -114,47 +114,47 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 		return new Date(this.currentMs);
 	}
 	advance(e) {
-		this.currentMs += typeof e == "number" ? e : Re(e);
+		this.currentMs += typeof e == "number" ? e : Le(e);
 	}
 	set(e) {
-		this.currentMs = F(e);
+		this.currentMs = I(e);
 	}
 	get installed() {
-		return P()[N]?.clock === this;
+		return F()[P]?.clock === this;
 	}
 	install() {
-		let e = P(), t = e[N];
+		let e = F(), t = e[P];
 		if (t !== void 0) throw Error("mockClock: global time is already faked" + (t.clock === this ? " by this same clock" : " by another MockClock") + ". Uninstall it before installing again — a nested install restores the outer fake on the way out, which leaves the realm frozen with nothing pointing at why. `withFrozenTime` always restores, including on a throw.");
 		let n = globalThis.Date;
-		return e[N] = {
+		return e[P] = {
 			realDate: n,
 			clock: this
-		}, globalThis.Date = Pe(n, () => this.currentMs), () => {
+		}, globalThis.Date = Ne(n, () => this.currentMs), () => {
 			this.uninstall();
 		};
 	}
 	uninstall() {
-		let e = P(), t = e[N];
-		t !== void 0 && t.clock === this && (globalThis.Date = t.realDate, delete e[N]);
+		let e = F(), t = e[P];
+		t !== void 0 && t.clock === this && (globalThis.Date = t.realDate, delete e[P]);
 	}
-}, Fe = (e) => typeof e == "object" && !!e && typeof e.then == "function", Ie = (e, t) => {
-	let n = e instanceof I ? e : new I(e);
+}, Pe = (e) => typeof e == "object" && !!e && typeof e.then == "function", Fe = (e, t) => {
+	let n = e instanceof L ? e : new L(e);
 	n.install();
 	let r = !1;
 	try {
 		let e = t(n);
-		return Fe(e) ? (r = !0, e.then((e) => (n.uninstall(), e), (e) => {
+		return Pe(e) ? (r = !0, e.then((e) => (n.uninstall(), e), (e) => {
 			throw n.uninstall(), e;
 		})) : e;
 	} finally {
 		r || n.uninstall();
 	}
-}, Le = (e) => u.acquireRelease(u.sync(() => {
-	let t = e instanceof I ? e : new I(e);
+}, Ie = (e) => u.acquireRelease(u.sync(() => {
+	let t = e instanceof L ? e : new L(e);
 	return t.install(), t;
 }), (e) => u.sync(() => {
 	e.uninstall();
-})), Re = (e) => {
+})), Le = (e) => {
 	let t = /^\s*(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)\s*$/.exec(e);
 	if (!t) throw Error(`mockClock: cannot parse duration '${e}'`);
 	let n = Number(t[1]), r = t[2];
@@ -166,7 +166,7 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 		case "d": return n * 864e5;
 		default: throw Error(`mockClock: unknown unit '${r}'`);
 	}
-}, L = class {
+}, R = class {
 	emitted = [];
 	async emit(e, t) {
 		let n = typeof e == "string" ? e : e.id ?? e.event ?? "(unnamed event)";
@@ -185,14 +185,14 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 	clear() {
 		this.emitted.length = 0;
 	}
-}, R = (e = {}) => {
+}, z = (e = {}) => {
 	let t = e.tenantId ?? null, n = new x({
 		origin: e.origin ?? "test",
 		...e.ringSize === void 0 ? {} : { ringSize: e.ringSize }
 	});
 	return {
 		publish: async (e, r, i) => {
-			let a = await u.runPromise(u.either(pe({
+			let a = await u.runPromise(u.either(fe({
 				bus: n,
 				tenantId: t
 			}, e, r, i)));
@@ -255,7 +255,7 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 			n.clear();
 		}
 	};
-}, z = class {
+}, B = class {
 	queue;
 	calls = [];
 	constructor(e) {
@@ -270,33 +270,33 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 	remaining() {
 		return this.queue.length;
 	}
-}, ze = (e) => e, B = "00000000000000000000000000000000", V = /* @__PURE__ */ new WeakMap(), H = /* @__PURE__ */ new WeakMap(), Be = (e, t) => {
-	let n = H.get(e);
+}, Re = (e) => e, V = "00000000000000000000000000000000", H = /* @__PURE__ */ new WeakMap(), U = /* @__PURE__ */ new WeakMap(), ze = (e, t) => {
+	let n = U.get(e);
 	if (n === void 0) throw Error("withRpcConnection requires a context created by makeTestContext");
 	return n(t);
-}, U = /* @__PURE__ */ new WeakMap(), W = /* @__PURE__ */ new WeakMap(), G = /* @__PURE__ */ new WeakMap(), K = (e) => G.get(e) ?? [], q = /* @__PURE__ */ new WeakMap(), J = (e, t) => {
-	q.set(e, { publicApi: t });
-}, Y = (e) => q.get(e), X = /* @__PURE__ */ new WeakMap(), Ve = (e, t) => {
-	let n = G.get(e) ?? [], r = t === "mutation" ? "interceptMutation" : t === "query" ? "interceptQuery" : "interceptAction", i = [];
+}, W = /* @__PURE__ */ new WeakMap(), G = /* @__PURE__ */ new WeakMap(), K = /* @__PURE__ */ new WeakMap(), q = (e) => K.get(e) ?? [], J = /* @__PURE__ */ new WeakMap(), Y = (e, t) => {
+	J.set(e, { publicApi: t });
+}, X = (e) => J.get(e), Be = /* @__PURE__ */ new WeakMap(), Ve = (e, t) => {
+	let n = K.get(e) ?? [], r = t === "mutation" ? "interceptMutation" : t === "query" ? "interceptQuery" : "interceptAction", i = [];
 	for (let e of n) {
 		let t = e[r];
 		typeof t == "function" && i.push(t);
 	}
 	return v(i);
 }, He = (e) => {
-	let t = (G.get(e) ?? []).map((e) => e.services).filter((e) => e !== void 0), n = X.get(e) ?? [], r = [...t, ...n];
+	let t = (K.get(e) ?? []).map((e) => e.services).filter((e) => e !== void 0), n = Be.get(e) ?? [], r = [...t, ...n];
 	if (r.length !== 0) return f.mergeAll(...r);
 }, Ue = (e) => {
-	let t = U.get(e);
+	let t = W.get(e);
 	t !== void 0 && (t.length = 0);
 }, Z = async (e) => {
-	let t = U.get(e);
+	let t = W.get(e);
 	if (t === void 0 || t.length === 0) return;
 	let n = [...t];
 	t.length = 0;
 	for (let e of n) await e();
-}, We = (e) => W.get(e) ?? [], Ge = async (e, t) => {
-	let n = V.get(e);
+}, We = (e) => G.get(e) ?? [], Ge = async (e, t) => {
+	let n = H.get(e);
 	return n === void 0 ? e.store.transactional(async (n) => t({
 		...e,
 		store: n
@@ -370,11 +370,11 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 	};
 }, Je = async (e, t) => {
 	let n = ie();
-	E(e);
+	D(e);
 	try {
 		return await t();
 	} finally {
-		n === void 0 ? re() : E(n);
+		n === void 0 ? re() : D(n);
 	}
 }, Ye = /* @__PURE__ */ new Set(), Xe = (e) => {
 	Ye.has(e) || (Ye.add(e), console.warn(e));
@@ -382,7 +382,7 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 	let r = Qe, i;
 	return () => {
 		let a = t ?? w();
-		return t !== void 0 && w() !== void 0 && t !== w() && Xe("[voltro:testing] this test passes `rowFilter:` while a DIFFERENT filter is registered via `setRowFilter`. The option wins, so this test does not exercise your app's registration. Drop `rowFilter:` to run the real process-global one."), (i === void 0 || a !== r) && (r = a, i = Je(n, () => T(me(a, e, (e) => {
+		return t !== void 0 && w() !== void 0 && t !== w() && Xe("[voltro:testing] this test passes `rowFilter:` while a DIFFERENT filter is registered via `setRowFilter`. The option wins, so this test does not exercise your app's registration. Drop `rowFilter:` to run the real process-global one."), (i === void 0 || a !== r) && (r = a, i = Je(n, () => E(pe(a, e, (e) => {
 			console.error("[voltro:testing] row filter failed to load — reads refused for this subject", e);
 		})))), i;
 	};
@@ -391,24 +391,24 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 	let r = Reflect.get(e, n, e);
 	return typeof r == "function" ? r.bind(e) : r;
 } }), et = (e = {}) => {
-	if (ve({
+	if (_e({
 		...process.env,
 		...e.env ?? {}
-	}), e.fieldEncryptionKey !== void 0 && _e(ue(e.fieldEncryptionKey)), e.relations !== void 0) {
+	}), e.fieldEncryptionKey !== void 0 && ge(le(e.fieldEncryptionKey)), e.relations !== void 0) {
 		o();
 		for (let t of e.relations) c(t);
 	}
-	let n = e.tables ?? t(), r = fe(n), i = new S(e.store ?? {}), a = {
+	let n = e.tables ?? t(), r = de(n), i = new S(e.store ?? {}), a = {
 		dataStore: i,
 		schemaRegistry: r
 	};
-	E(a);
-	let s = new I(e.clockStart), l = new L(), u = R(), d = new z(e.llmResponses ?? []), f = Ke(() => s.now()), p = qe(() => s.now()), m = (t, n, o = i, c, h = !1) => {
+	D(a);
+	let s = new L(e.clockStart), l = new R(), u = z(), d = new B(e.llmResponses ?? []), f = Ke(() => s.now()), p = qe(() => s.now()), m = (t, n, o = i, c, h = !1) => {
 		let g = {
 			subject: t,
-			traceId: B,
+			traceId: V,
 			...n === void 0 ? {} : { connection: n }
-		}, _ = c?.queued ?? [], v = c?.nudges ?? [], y = le({
+		}, _ = c?.queued ?? [], v = c?.nudges ?? [], y = ce({
 			bus: u.bus,
 			tenantId: t.tenantId ?? null,
 			...o === i ? {} : { deferToCommit: (e) => {
@@ -418,7 +418,7 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 			} }
 		}), b = se({ store: o }), x = h ? async () => C : Ze(t, e.rowFilter, a), S = {
 			transaction: async (e, r) => {
-				let a = he(t, r?.tenantId, o !== i);
+				let a = me(t, r?.tenantId, o !== i);
 				if (a !== t) return m(a, n, i, void 0, !0).transaction(e);
 				if (o !== i) return e(S);
 				let s, c = await o.transactional(async (r) => {
@@ -444,22 +444,22 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 			access: ae(t),
 			cache: f,
 			kv: p,
-			store: D($e(o, x), {
+			store: O($e(o, x), {
 				subject: t,
 				schemaRegistry: r,
 				rowFilter: C
 			}),
-			storeForTenant: (e) => D($e(o, x), {
+			storeForTenant: (e) => O($e(o, x), {
 				subject: ee(t, e),
 				schemaRegistry: r,
 				rowFilter: C
 			}),
-			outbox: de({
+			outbox: ue({
 				store: o,
 				subject: t,
-				traceId: B,
+				traceId: V,
 				nudge: () => {
-					v.push(B);
+					v.push(V);
 				},
 				afterCommit: (e) => {
 					_.push(e);
@@ -490,10 +490,10 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 				nudges: v
 			})
 		};
-		return U.set(S, _), H.set(S, (e) => m(t, e, o, {
+		return W.set(S, _), U.set(S, (e) => m(t, e, o, {
 			queued: _,
 			nudges: v
-		})), W.set(S, v), G.set(S, e.plugins ?? []), X.set(S, e.layers ?? []), V.set(S, (e) => o.transactional((r) => e(m(t, n, r, {
+		})), G.set(S, v), K.set(S, e.plugins ?? []), Be.set(S, e.layers ?? []), H.set(S, (e) => o.transactional((r) => e(m(t, n, r, {
 			queued: _,
 			nudges: v
 		})))), S;
@@ -501,11 +501,11 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 	return m(e.subject ?? h(null), e.connection);
 }, tt = (e, t) => {
 	let n = He(t);
-	return (n === void 0 ? e : u.provide(e, n)).pipe(u.provide(ce(t.store)), u.provideService(m, t.request.subject));
+	return (n === void 0 ? e : u.provide(e, n)).pipe(u.provide(T(t.store)), u.provideService(m, t.request.subject));
 }, nt = async (e, t, n, r) => {
 	let i = e.input, a = await p.decodeUnknownPromise(i)(n), o = e.kind, s = async (e) => {
 		let n = t(a, e);
-		return u.isEffect(n) ? T(tt(n, e)) : n;
+		return u.isEffect(n) ? E(tt(n, e)) : n;
 	}, c = async () => {
 		let t = e.guards;
 		if (t !== void 0 && t.length > 0) {
@@ -513,14 +513,14 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 			if (e !== null) throw e;
 		}
 		if (o !== "mutation") return s(r);
-		let n = await ge(async () => Ge(r, async (e) => (Ue(r), s(e))), { delay: () => Promise.resolve() });
+		let n = await he(async () => Ge(r, async (e) => (Ue(r), s(e))), { delay: () => Promise.resolve() });
 		return await Z(r), n;
 	}, f = o === "mutation" || o === "query" || o === "action" ? o : void 0, m = f === void 0 ? void 0 : Ve(r, f);
 	if (m === void 0 || f === void 0) return await c();
 	let h = u.tryPromise({
 		try: () => c(),
 		catch: (e) => e
-	}), _ = Y(r), v = m(h, {
+	}), _ = X(r), v = m(h, {
 		tag: e.name ?? "",
 		kind: f,
 		input: a,
@@ -535,7 +535,7 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 	if (d.isSuccess(y)) return y.value;
 	throw l.squash(y.cause);
 }, rt = (e) => new Promise((t) => {
-	let n = new ye.Socket(), r = (e) => {
+	let n = new ve.Socket(), r = (e) => {
 		clearTimeout(i), n.destroy(), t(e);
 	}, i = setTimeout(() => r(!1), e.timeoutMs ?? 750);
 	n.once("connect", () => r(!0)), n.once("error", () => r(!1)), n.connect(e.port, e.host);
@@ -547,7 +547,7 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 	} catch {
 		i = !1;
 	}
-	be.skipIf(!i)(i ? e : `${e} [SKIPPED: needs ${t}]`, r);
+	ye.skipIf(!i)(i ? e : `${e} [SKIPPED: needs ${t}]`, r);
 }, at = async (e, t, n) => {
 	await it(e, `${t.name} at ${t.host}:${t.port}`, () => rt(t), n);
 }, ot = async (e, t) => {
@@ -578,11 +578,11 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 	for (let [n, r] of Object.entries(e)) t[n.toLowerCase()] = r;
 	return t;
 }, ht = (e) => e === void 0 ? /* @__PURE__ */ new Uint8Array() : new TextEncoder().encode(JSON.stringify(e)), gt = (e) => e === void 0 ? "" : typeof e == "string" ? e : new TextDecoder().decode(e), _t = (e) => {
-	let { ctx: t } = e, n = xe((e.publicApi ?? []).map((e) => ({
+	let { ctx: t } = e, n = be((e.publicApi ?? []).map((e) => ({
 		descriptor: e.descriptor,
-		invoke: (n, r) => t.withSubject(r.subject, (t) => (e.descriptor.publicApi !== void 0 && J(t, e.descriptor.publicApi), nt(e.descriptor, e.handler, n, t)))
+		invoke: (n, r) => t.withSubject(r.subject, (t) => (e.descriptor.publicApi !== void 0 && Y(t, e.descriptor.publicApi), nt(e.descriptor, e.handler, n, t)))
 	})), {
-		pluginErrors: K(t).flatMap((e) => e.errorSchemas ?? []),
+		pluginErrors: q(t).flatMap((e) => e.errorSchemas ?? []),
 		...e.publicApiProfile === void 0 ? {} : { profile: e.publicApiProfile }
 	}), r = [...e.restRoutes ?? [], ...n], i = _(e.strategies ?? [], {
 		...e.anonymousTenantRequired === void 0 ? {} : { anonymousTenantRequired: e.anonymousTenantRequired },
@@ -596,7 +596,7 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 				clientId: -1
 			})).subject : () => n,
 			...e.idempotency === void 0 ? {} : { idempotency: e.idempotency }
-		}, c = Ce(r, s).map((e, t) => ({
+		}, c = Se(r, s).map((e, t) => ({
 			pattern: r[t].path,
 			route: e
 		})), l = async (e, n, i = {}) => {
@@ -621,7 +621,7 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 				},
 				rawBody: ht(i.body),
 				store: t.store
-			}, d = await Se(l, u), f = {};
+			}, d = await xe(l, u), f = {};
 			for (let [e, t] of Object.entries(d.headers ?? {})) f[e.toLowerCase()] = t;
 			d.contentType !== void 0 && (f["content-type"] = d.contentType);
 			let p = gt(d.body), m = (d.contentType ?? "").includes("json");
@@ -664,7 +664,7 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 	} });
 	return {
 		id: t,
-		log: e.log ?? we({ scope: `subscribe:${t}` }),
+		log: e.log ?? Ce({ scope: `subscribe:${t}` }),
 		store: n,
 		...e.publish === void 0 ? {} : { publish: e.publish }
 	};
@@ -700,24 +700,24 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 		start: async (i, a) => {
 			let o = t.find((e) => e.workflow.name === i);
 			if (o === void 0) throw Error(`makeWorkflowRunner: no workflow named '${i}' — pass it in makeWorkflowRunner({ ctx, workflows: [{ workflow, execute }] }).`);
-			let s = `wfrun_test_${++r}`, c = De(), l = o.workflow.toLayer(o.execute).pipe(f.provideMerge(Ee)), d = /* @__PURE__ */ new Date(), p = o.workflow.execute(a).pipe(u.locally(Te, s), u.provide(c.layer), u.provide(l), u.either), m = await u.runPromise(p), h = yt(c.readSteps()), g = /* @__PURE__ */ new Date(), _;
-			if (m._tag === "Right") _ = {
+			let s = `wfrun_test_${++r}`, c = Ee(), l = o.workflow.toLayer(o.execute).pipe(f.provideMerge(Te)), d = /* @__PURE__ */ new Date(), p = o.workflow.execute(a).pipe(u.locally(we, s), u.provide(c.layer), u.provide(l)), m = (e.ctx.store === void 0 ? p : u.provide(p, T(e.ctx.store))).pipe(u.either), h = await u.runPromise(m), g = yt(c.readSteps()), _ = /* @__PURE__ */ new Date(), v;
+			if (h._tag === "Right") v = {
 				status: "succeeded",
-				output: m.right,
+				output: h.right,
 				error: null,
-				steps: h,
+				steps: g,
 				runId: s
 			};
 			else {
-				let e = m.left;
-				_ = {
+				let e = h.left;
+				v = {
 					status: "failed",
 					output: null,
 					error: {
 						tag: e && typeof e == "object" && "_tag" in e ? String(e._tag) : null,
-						message: e && typeof e == "object" && "message" in e && typeof e.message == "string" ? e.message : String(m.left)
+						message: e && typeof e == "object" && "message" in e && typeof e.message == "string" ? e.message : String(h.left)
 					},
-					steps: h,
+					steps: g,
 					runId: s
 				};
 			}
@@ -725,21 +725,21 @@ var Oe = new Set(e), O = 0, k = () => ++O, ke = (e, t) => {
 				id: s,
 				executionId: s,
 				name: i,
-				status: _.status,
+				status: v.status,
 				input: a,
-				output: _.output,
+				output: v.output,
 				subject: e.ctx.request.subject,
 				source: "test-runner",
-				steps: h,
+				steps: g,
 				startedAt: d,
-				finishedAt: g,
+				finishedAt: _,
 				traceId: null,
 				parentExecutionId: null,
 				parentClosePolicy: null
-			}), _;
+			}), v;
 		},
 		inspect: async (e) => n.get(e) ?? null
 	};
 }, xt = 1;
 //#endregion
-export { I as MockClock, z as MockLLM, L as MockWebhooks, xt as TESTING_PRESET_VERSION, st as TEST_TENANT_ID, dt as anonymous, lt as apiKey, n as changeDelete, r as changeInsert, i as changeSoftDelete, a as changeUpdate, Ne as defineFactory, it as describeIfAvailable, at as describeIfReachable, A as fixtureRow, Le as frozenTime, nt as invoke, rt as isTcpReachable, vt as makeSubscribeContext, _t as makeTestApp, et as makeTestContext, bt as makeWorkflowRunner, J as markRestInvocation, ze as mockStore, k as nextSequence, We as outboxNudgesOf, K as pluginsOf, ot as reportEngineVersion, Ue as resetAfterCommit, Y as restInvocationOf, Ve as rpcInterceptorFor, Z as runAfterCommit, Ge as runInStoreTransaction, ut as serviceAccount, He as serviceLayerFor, ft as system, R as testEventBus, ct as user, Ie as withFrozenTime, Be as withRpcConnection };
+export { L as MockClock, B as MockLLM, R as MockWebhooks, xt as TESTING_PRESET_VERSION, st as TEST_TENANT_ID, dt as anonymous, lt as apiKey, n as changeDelete, r as changeInsert, i as changeSoftDelete, a as changeUpdate, Me as defineFactory, it as describeIfAvailable, at as describeIfReachable, j as fixtureRow, Ie as frozenTime, nt as invoke, rt as isTcpReachable, vt as makeSubscribeContext, _t as makeTestApp, et as makeTestContext, bt as makeWorkflowRunner, Y as markRestInvocation, Re as mockStore, A as nextSequence, We as outboxNudgesOf, q as pluginsOf, ot as reportEngineVersion, Ue as resetAfterCommit, X as restInvocationOf, Ve as rpcInterceptorFor, Z as runAfterCommit, Ge as runInStoreTransaction, ut as serviceAccount, He as serviceLayerFor, ft as system, z as testEventBus, ct as user, Fe as withFrozenTime, ze as withRpcConnection };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/testing",
-  "version": "0.72.0",
+  "version": "0.73.0",
   "description": "Test utilities for Voltro apps — deterministic clock, subject and row factories, a handler-level invoke and a request-level app harness, queued LLM responses, scoped subject/tenant runners, and a cross-dialect parity harness.",
   "keywords": [
     "voltro",
@@ -43,16 +43,16 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/database": "0.72.0",
-    "@voltro/env": "0.72.0",
-    "@voltro/logger": "0.72.0",
-    "@voltro/protocol": "0.72.0",
-    "@voltro/runtime": "0.72.0",
-    "@voltro/workflow": "0.72.0"
+    "@voltro/database": "0.73.0",
+    "@voltro/env": "0.73.0",
+    "@voltro/logger": "0.73.0",
+    "@voltro/protocol": "0.73.0",
+    "@voltro/runtime": "0.73.0",
+    "@voltro/workflow": "0.73.0"
   },
   "peerDependencies": {
     "@effect/sql": "^0.52.1",
-    "@voltro/client": "0.72.0",
+    "@voltro/client": "0.73.0",
     "effect": "^3.22.1",
     "react": "^19.0.0"
   },