@voltro/testing 0.65.0 → 0.66.0

package/dist/index.d.ts

@@ -20,6 +20,7 @@ import { RestRouteDescriptor } from '@voltro/protocol/rest';
 import { RestServeBindings } from '@voltro/protocol/rest';
 import { Row } from '@voltro/database';
 import { RowFilter } from '@voltro/runtime';
+import { RpcConnection } from '@voltro/runtime';
 import { RpcInterceptor } from '@voltro/protocol';
 import { RpcKind } from '@voltro/protocol';
 import { Schema } from 'effect';
@@ -351,6 +352,10 @@ export declare interface MakeTestContextOptions<RowFilterCtx = unknown> {
     /** The acting subject. Default: anonymous, no tenant. Read it back at
      *  `ctx.request.subject` (the same place a live handler reads it). */
     readonly subject?: Subject;
+    /** Optional connection fixture, or the actual RuntimeContext.connection from
+     * a listener test. Shared by transaction/subject re-scopes, never invented by
+     * the harness; omitting it models an internal invocation. */
+    readonly connection?: RpcConnection;
     /** Tables to wire into the store's schema. Default: all globally
      *  registered tables (whatever the test imported). */
     readonly tables?: ReadonlyArray<TableLike>;
@@ -930,6 +935,11 @@ export declare const user: (id: string, options?: TestSubjectOptions) => Subject
  */
 export declare const withFrozenTime: <A>(at: Date | number | string | MockClock, body: (clock: MockClock) => A) => A;
 
+/** Model another native RPC connection against the SAME test store/services.
+ * The connection may come from a real listener. Passing undefined models an
+ * internal call; no identity is fabricated or copied from another caller. */
+export declare const withRpcConnection: (ctx: TestContext, connection: RpcConnection | undefined) => TestContext;
+
 /** A workflow + its execute function, as the framework pairs them via
  *  `workflow.toLayer(execute)`. Structural (no `@effect/workflow` generic
  *  signature) so callers can pass the value from `workflow({ name, ... })`

package/dist/index.js

@@ -1,7 +1,7 @@
 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 te, InMemoryDataStore as ne, NO_ROW_FILTER as x, appValidation as re, applyRowFilterToDescriptor as ie, clearSystemStoreHandle as ae, getRowFilter as S, getSystemStoreHandle as oe, makeAppAccess as se, makeDataLoader as ce, makeEffectStoreLayer as le, makeEventPublisher as ue, makeOutboxFacade as de, makeSchemaRegistry as fe, publishEvent as pe, resolveRowFilterScopeFor as me, runProvidedEffect as C, runWithDeadlockRetry as he, setSystemStoreHandle as w, wrapStoreWithMixinBehaviour as T } from "@voltro/runtime";
+import { EventBus as x, InMemoryDataStore as te, NO_ROW_FILTER as S, appValidation as ne, applyRowFilterToDescriptor as re, clearSystemStoreHandle as ie, getRowFilter as C, getSystemStoreHandle as ae, makeAppAccess as oe, makeConnectionState as se, makeDataLoader as ce, makeEffectStoreLayer as le, makeEventPublisher as ue, makeOutboxFacade as de, makeSchemaRegistry as fe, publishEvent as pe, resolveRowFilterScopeFor as me, runProvidedEffect as w, runWithDeadlockRetry as he, setSystemStoreHandle as T, wrapStoreWithMixinBehaviour as E } from "@voltro/runtime";
 import { installEnvSnapshot as ge } from "@voltro/env";
 import _e from "node:net";
 import { describe as ve } from "vitest";
@@ -9,39 +9,39 @@ import { collectPublicApiRoutes as ye, dispatchSharedPath as be, restRoutesToHtt
 import { createLogger as Se } from "@voltro/logger";
 import { CurrentWorkflowRunId as Ce, inMemoryWorkflowEngineLayer as we, makeInMemoryRecorder as Te } from "@voltro/workflow";
 //#region src/fixtureRow.ts
-var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
+var Ee = new Set(e), D = 0, O = () => ++D, De = (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 "reference":
 		case "id":
-		case "enum": return n ? `${e}-${++E}` : e;
+		case "enum": return n ? `${e}-${++D}` : e;
+		case "reference": return t.referenceStorage === "numeric" ? n ? ++D : 0 : n ? `${e}-${++D}` : e;
 		case "integer":
-		case "real": return n ? ++E : 0;
+		case "real": return n ? ++D : 0;
 		case "decimal":
-		case "bigint": return n ? String(++E) : "0";
+		case "bigint": return n ? String(++D) : "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}: … }).`);
 	}
-}, D = (e, t = {}) => {
+}, k = (e, t = {}) => {
 	let n = {};
-	for (let r of s(e, t)) Ee.has(r) || (n[r] = Oe(r, e.fields[r]));
+	for (let r of s(e, t)) Ee.has(r) || (n[r] = De(r, e.fields[r]));
 	return {
 		...n,
 		...t
 	};
-}, ke = (e) => {
+}, Oe = (e) => {
 	let t = {};
-	for (let [n, r] of Object.entries(e)) t[n] = typeof r == "function" ? r(De()) : r;
+	for (let [n, r] of Object.entries(e)) t[n] = typeof r == "function" ? r(O()) : r;
 	return t;
-}, Ae = (e) => {
+}, ke = (e) => {
 	for (let [t, n] of Object.entries(e.fields)) if (n.type === "id") return t;
 	return "id";
-}, je = async (e, t, n, r, i) => {
+}, Ae = 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 Ee = new Set(e), E = 0, De = () => ++E, Oe = (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 O(e, s, {}, {}, [...i, s.tableName]) : await c.create(e, {}))[Ae(s)];
+		a[o] = (c === void 0 ? await A(e, s, {}, {}, [...i, s.tableName]) : await c.create(e, {}))[n.referenceColumn ?? ke(s)];
 	}
 	return a;
-}, O = async (e, t, n, r, i) => {
+}, A = async (e, t, n, r, i) => {
 	let a = {
-		...await je(e, t, n, r, i),
+		...await Ae(e, t, n, r, i),
 		...n
 	};
-	return e.insert(t.tableName, D(t, a));
-}, k = (e, t) => typeof e == "function" ? e(t) : e ?? {}, Me = (e, t = {}) => {
+	return e.insert(t.tableName, k(t, a));
+}, j = (e, t) => typeof e == "function" ? e(t) : e ?? {}, je = (e, t = {}) => {
 	let n = t.traits ?? {}, r = t.associations ?? {}, i = (t) => {
 		let a = (e = {}) => ({
-			...ke(t),
+			...Oe(t),
 			...e
-		}), o = (t = {}) => D(e, a(t));
+		}), o = (t = {}) => k(e, a(t));
 		return {
 			table: e,
 			build: o,
-			buildList: (e, t) => Array.from({ length: e }, (e, n) => o(k(t, n))),
-			create: (t, n = {}) => O(t, e, a(n), r, [e.tableName]),
+			buildList: (e, t) => Array.from({ length: e }, (e, n) => o(j(t, n))),
+			create: (t, n = {}) => A(t, e, a(n), r, [e.tableName]),
 			createList: async (t, n, i) => {
 				let o = [];
-				for (let s = 0; s < n; s++) o.push(await O(t, e, a(k(i, s)), r, [e.tableName]));
+				for (let s = 0; s < n; s++) o.push(await A(t, e, a(j(i, s)), r, [e.tableName]));
 				return o;
 			},
 			with: (...r) => {
@@ -93,19 +93,19 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 		};
 	};
 	return i(t.defaults ?? {});
-}, A = Symbol.for("voltro/testing/mockClock.installed"), j = () => globalThis, Ne = (e, t) => new Proxy(e, {
+}, M = Symbol.for("voltro/testing/mockClock.installed"), N = () => globalThis, Me = (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)
-}), M = (e) => {
+}), P = (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;
-}, N = class {
+}, F = class {
 	currentMs;
 	constructor(e = "2026-01-01T00:00:00Z") {
-		this.currentMs = M(e);
+		this.currentMs = P(e);
 	}
 	now() {
 		return this.currentMs;
@@ -114,47 +114,47 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 		return new Date(this.currentMs);
 	}
 	advance(e) {
-		this.currentMs += typeof e == "number" ? e : Le(e);
+		this.currentMs += typeof e == "number" ? e : Ie(e);
 	}
 	set(e) {
-		this.currentMs = M(e);
+		this.currentMs = P(e);
 	}
 	get installed() {
-		return j()[A]?.clock === this;
+		return N()[M]?.clock === this;
 	}
 	install() {
-		let e = j(), t = e[A];
+		let e = N(), t = e[M];
 		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[A] = {
+		return e[M] = {
 			realDate: n,
 			clock: this
-		}, globalThis.Date = Ne(n, () => this.currentMs), () => {
+		}, globalThis.Date = Me(n, () => this.currentMs), () => {
 			this.uninstall();
 		};
 	}
 	uninstall() {
-		let e = j(), t = e[A];
-		t !== void 0 && t.clock === this && (globalThis.Date = t.realDate, delete e[A]);
+		let e = N(), t = e[M];
+		t !== void 0 && t.clock === this && (globalThis.Date = t.realDate, delete e[M]);
 	}
-}, Pe = (e) => typeof e == "object" && !!e && typeof e.then == "function", Fe = (e, t) => {
-	let n = e instanceof N ? e : new N(e);
+}, Ne = (e) => typeof e == "object" && !!e && typeof e.then == "function", Pe = (e, t) => {
+	let n = e instanceof F ? e : new F(e);
 	n.install();
 	let r = !1;
 	try {
 		let e = t(n);
-		return Pe(e) ? (r = !0, e.then((e) => (n.uninstall(), e), (e) => {
+		return Ne(e) ? (r = !0, e.then((e) => (n.uninstall(), e), (e) => {
 			throw n.uninstall(), e;
 		})) : e;
 	} finally {
 		r || n.uninstall();
 	}
-}, Ie = (e) => u.acquireRelease(u.sync(() => {
-	let t = e instanceof N ? e : new N(e);
+}, Fe = (e) => u.acquireRelease(u.sync(() => {
+	let t = e instanceof F ? e : new F(e);
 	return t.install(), t;
 }), (e) => u.sync(() => {
 	e.uninstall();
-})), Le = (e) => {
+})), Ie = (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 Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 		case "d": return n * 864e5;
 		default: throw Error(`mockClock: unknown unit '${r}'`);
 	}
-}, P = class {
+}, I = class {
 	emitted = [];
 	async emit(e, t) {
 		let n = typeof e == "string" ? e : e.id ?? e.event ?? "(unnamed event)";
@@ -185,8 +185,8 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 	clear() {
 		this.emitted.length = 0;
 	}
-}, F = (e = {}) => {
-	let t = e.tenantId ?? null, n = new te({
+}, L = (e = {}) => {
+	let t = e.tenantId ?? null, n = new x({
 		origin: e.origin ?? "test",
 		...e.ringSize === void 0 ? {} : { ringSize: e.ringSize }
 	});
@@ -255,7 +255,7 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 			n.clear();
 		}
 	};
-}, I = class {
+}, R = class {
 	queue;
 	calls = [];
 	constructor(e) {
@@ -270,27 +270,31 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 	remaining() {
 		return this.queue.length;
 	}
-}, Re = (e) => e, L = "00000000000000000000000000000000", R = /* @__PURE__ */ new WeakMap(), z = /* @__PURE__ */ new WeakMap(), B = /* @__PURE__ */ new WeakMap(), V = /* @__PURE__ */ new WeakMap(), H = /* @__PURE__ */ new WeakMap(), U = (e, t) => {
-	let n = V.get(e) ?? [], r = t === "mutation" ? "interceptMutation" : t === "query" ? "interceptQuery" : "interceptAction", i = [];
+}, Le = (e) => e, z = "00000000000000000000000000000000", B = /* @__PURE__ */ new WeakMap(), V = /* @__PURE__ */ new WeakMap(), Re = (e, t) => {
+	let n = V.get(e);
+	if (n === void 0) throw Error("withRpcConnection requires a context created by makeTestContext");
+	return n(t);
+}, H = /* @__PURE__ */ new WeakMap(), U = /* @__PURE__ */ new WeakMap(), W = /* @__PURE__ */ new WeakMap(), G = /* @__PURE__ */ new WeakMap(), K = (e, t) => {
+	let n = W.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);
-}, W = (e) => {
-	let t = (V.get(e) ?? []).map((e) => e.services).filter((e) => e !== void 0), n = H.get(e) ?? [], r = [...t, ...n];
+}, q = (e) => {
+	let t = (W.get(e) ?? []).map((e) => e.services).filter((e) => e !== void 0), n = G.get(e) ?? [], r = [...t, ...n];
 	if (r.length !== 0) return f.mergeAll(...r);
-}, G = (e) => {
-	let t = z.get(e);
+}, J = (e) => {
+	let t = H.get(e);
 	t !== void 0 && (t.length = 0);
-}, K = async (e) => {
-	let t = z.get(e);
+}, Y = async (e) => {
+	let t = H.get(e);
 	if (t === void 0 || t.length === 0) return;
 	let n = [...t];
 	t.length = 0;
 	for (let e of n) await e();
-}, ze = (e) => B.get(e) ?? [], q = async (e, t) => {
-	let n = R.get(e);
+}, ze = (e) => U.get(e) ?? [], X = async (e, t) => {
+	let n = B.get(e);
 	return n === void 0 ? e.store.transactional(async (n) => t({
 		...e,
 		store: n
@@ -363,28 +367,28 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 		}
 	};
 }, He = async (e, t) => {
-	let n = oe();
-	w(e);
+	let n = ae();
+	T(e);
 	try {
 		return await t();
 	} finally {
-		n === void 0 ? ae() : w(n);
+		n === void 0 ? ie() : T(n);
 	}
-}, J = /* @__PURE__ */ new Set(), Ue = (e) => {
-	J.has(e) || (J.add(e), console.warn(e));
+}, Z = /* @__PURE__ */ new Set(), Ue = (e) => {
+	Z.has(e) || (Z.add(e), console.warn(e));
 }, We = (e, t, n) => {
 	let r = Ge, i;
 	return () => {
-		let a = t ?? S();
-		return t !== void 0 && S() !== void 0 && t !== S() && Ue("[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 = He(n, () => C(me(a, e, (e) => {
+		let a = t ?? C();
+		return t !== void 0 && C() !== void 0 && t !== C() && Ue("[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 = He(n, () => w(me(a, e, (e) => {
 			console.error("[voltro:testing] row filter failed to load — reads refused for this subject", e);
 		})))), i;
 	};
-}, Ge = Symbol("unresolved"), Y = (e, t) => new Proxy(e, { get: (e, n) => {
-	if (n === "query") return async (n) => e.query(ie(await t(), n));
+}, Ge = Symbol("unresolved"), Ke = (e, t) => new Proxy(e, { get: (e, n) => {
+	if (n === "query") return async (n) => e.query(re(await t(), n));
 	let r = Reflect.get(e, n, e);
 	return typeof r == "function" ? r.bind(e) : r;
-} }), Ke = (e = {}) => {
+} }), qe = (e = {}) => {
 	if (ge({
 		...process.env,
 		...e.env ?? {}
@@ -392,78 +396,90 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 		o();
 		for (let t of e.relations) c(t);
 	}
-	let n = e.tables ?? t(), r = fe(n), i = new ne(e.store ?? {}), a = {
+	let n = e.tables ?? t(), r = fe(n), i = new te(e.store ?? {}), a = {
 		dataStore: i,
 		schemaRegistry: r
 	};
-	w(a);
-	let s = new N(e.clockStart), l = new P(), u = F(), d = new I(e.llmResponses ?? []), f = Be(() => s.now()), p = Ve(() => s.now()), m = (t, n = i, o) => {
-		let c = {
+	T(a);
+	let s = new F(e.clockStart), l = new I(), u = L(), d = new R(e.llmResponses ?? []), f = Be(() => s.now()), p = Ve(() => s.now()), m = (t, n, o = i, c) => {
+		let h = {
 			subject: t,
-			traceId: L
-		}, h = ue({
+			traceId: z,
+			...n === void 0 ? {} : { connection: n }
+		}, g = c?.queued ?? [], _ = c?.nudges ?? [], v = ue({
 			bus: u.bus,
-			tenantId: t.tenantId ?? null
-		}), g = o?.queued ?? [], _ = o?.nudges ?? [], v = ce({ store: n }), y = We(t, e.rowFilter, a), b = {
+			tenantId: t.tenantId ?? null,
+			...o === i ? {} : { deferToCommit: (e) => {
+				g.push(async () => {
+					e();
+				});
+			} }
+		}), y = ce({ store: o }), b = We(t, e.rowFilter, a), x = {
 			clock: s,
 			webhooks: l,
-			events: h,
+			events: v,
 			eventBus: u,
 			llm: d,
 			...e.ai === void 0 ? {} : { ai: e.ai },
-			request: c,
-			validation: re,
-			access: se(t),
+			request: h,
+			...n === void 0 ? {} : { connectionState: se(n, o === i ? void 0 : (e) => {
+				g.push(e);
+			}) },
+			validation: ne,
+			access: oe(t),
 			cache: f,
 			kv: p,
-			store: T(Y(n, y), {
+			store: E(Ke(o, b), {
 				subject: t,
 				schemaRegistry: r,
-				rowFilter: x
+				rowFilter: S
 			}),
-			storeForTenant: (e) => T(Y(n, y), {
+			storeForTenant: (e) => E(Ke(o, b), {
 				subject: ee(t, e),
 				schemaRegistry: r,
-				rowFilter: x
+				rowFilter: S
 			}),
 			outbox: de({
-				store: n,
+				store: o,
 				subject: t,
-				traceId: L,
+				traceId: z,
 				nudge: () => {
-					_.push(L);
+					_.push(z);
 				},
 				afterCommit: (e) => {
 					g.push(e);
 				}
 			}),
-			load: v.load,
-			loadMany: v.loadMany,
-			withSubject: (e, t) => Promise.resolve(t(m(e, n, {
+			load: y.load,
+			loadMany: y.loadMany,
+			withSubject: (e, t) => Promise.resolve(t(m(e, n, o, {
 				queued: g,
 				nudges: _
 			}))),
 			withTenant: (e, r) => Promise.resolve(r(m({
 				...t,
 				tenantId: e
-			}, n, {
+			}, n, o, {
 				queued: g,
 				nudges: _
 			})))
 		};
-		return z.set(b, g), B.set(b, _), V.set(b, e.plugins ?? []), H.set(b, e.layers ?? []), R.set(b, (e) => n.transactional((n) => e(m(t, n, {
+		return H.set(x, g), V.set(x, (e) => m(t, e, o, {
+			queued: g,
+			nudges: _
+		})), U.set(x, _), W.set(x, e.plugins ?? []), G.set(x, e.layers ?? []), B.set(x, (e) => o.transactional((r) => e(m(t, n, r, {
 			queued: g,
 			nudges: _
-		})))), b;
+		})))), x;
 	};
-	return m(e.subject ?? h(null));
-}, qe = (e, t) => {
-	let n = W(t);
+	return m(e.subject ?? h(null), e.connection);
+}, Je = (e, t) => {
+	let n = q(t);
 	return (n === void 0 ? e : u.provide(e, n)).pipe(u.provide(le(t.store)), u.provideService(m, t.request.subject));
-}, X = async (e, t, n, r) => {
+}, Ye = 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) ? C(qe(n, e)) : n;
+		return u.isEffect(n) ? w(Je(n, e)) : n;
 	}, c = async () => {
 		let t = e.guards;
 		if (t !== void 0 && t.length > 0) {
@@ -471,9 +487,9 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 			if (e !== null) throw e;
 		}
 		if (o !== "mutation") return s(r);
-		let n = await he(async () => q(r, async (e) => (G(r), s(e))), { delay: () => Promise.resolve() });
-		return await K(r), n;
-	}, f = o === "mutation" || o === "query" || o === "action" ? o : void 0, m = f === void 0 ? void 0 : U(r, f);
+		let n = await he(async () => X(r, async (e) => (J(r), s(e))), { delay: () => Promise.resolve() });
+		return await Y(r), n;
+	}, f = o === "mutation" || o === "query" || o === "action" ? o : void 0, m = f === void 0 ? void 0 : K(r, f);
 	if (m === void 0 || f === void 0) return await c();
 	let h = m(u.tryPromise({
 		try: () => c(),
@@ -488,12 +504,12 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 	}), _ = await u.runPromiseExit(h);
 	if (d.isSuccess(_)) return _.value;
 	throw l.squash(_.cause);
-}, Z = (e) => new Promise((t) => {
+}, Xe = (e) => new Promise((t) => {
 	let n = new _e.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);
-}), Q = async (e, t, n, r) => {
+}), Ze = async (e, t, n, r) => {
 	if (typeof t != "string" || typeof n != "function" || typeof r != "function") throw TypeError(`describeIfAvailable('${e}', ...): expected (label, dependency, probe, suite) — got dependency: ${typeof t}, probe: ${typeof n}, suite: ${typeof r}. Three arguments means the suite body is being used as the probe: it would run at file scope, unconditionally, and the skip would silently do nothing.`);
 	let i = !1;
 	try {
@@ -502,20 +518,20 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 		i = !1;
 	}
 	ve.skipIf(!i)(i ? e : `${e} [SKIPPED: needs ${t}]`, r);
-}, Je = async (e, t, n) => {
-	await Q(e, `${t.name} at ${t.host}:${t.port}`, () => Z(t), n);
-}, Ye = async (e, t) => {
+}, Qe = async (e, t, n) => {
+	await Ze(e, `${t.name} at ${t.host}:${t.port}`, () => Xe(t), n);
+}, $e = async (e, t) => {
 	try {
 		let n = await t();
 		n !== void 0 && n !== "" && console.log(`[engine] ${e}: ${n}`);
 	} catch {}
-}, Xe = "test-tenant", $ = (e, t, n) => ({
+}, et = "test-tenant", Q = (e, t, n) => ({
 	type: e,
 	id: t,
 	tenantId: n.tenantId ?? "test-tenant",
 	scopes: n.scopes ?? [],
 	...n.metadata === void 0 ? {} : { metadata: n.metadata }
-}), Ze = (e, t = {}) => $("user", e, t), Qe = (e, t = {}) => $("apiKey", e, t), $e = (e, t = {}) => $("serviceAccount", e, t), et = (e = null) => h(e), tt = (e = "job:test", t) => t === void 0 ? b(e) : b(e, t), nt = (e) => {
+}), tt = (e, t = {}) => Q("user", e, t), nt = (e, t = {}) => Q("apiKey", e, t), rt = (e, t = {}) => Q("serviceAccount", e, t), it = (e = null) => h(e), at = (e = "job:test", t) => t === void 0 ? b(e) : b(e, t), ot = (e) => {
 	let t = e.indexOf("?");
 	return t === -1 ? {
 		path: e,
@@ -524,23 +540,24 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 		path: e.slice(0, t),
 		query: e.slice(t + 1)
 	};
-}, rt = (e, t) => {
+}, st = (e, t) => {
 	let n = e.split("/").filter((e) => e.length > 0), r = t.split("/").filter((e) => e.length > 0);
 	return n.length === r.length && n.every((e, t) => e.startsWith(":") || e === r[t]);
-}, it = (e) => {
+}, $ = (e) => {
 	let t = {};
 	for (let [n, r] of Object.entries(e)) t[n.toLowerCase()] = r;
 	return t;
-}, at = (e) => e === void 0 ? /* @__PURE__ */ new Uint8Array() : new TextEncoder().encode(JSON.stringify(e)), ot = (e) => e === void 0 ? "" : typeof e == "string" ? e : new TextDecoder().decode(e), st = (e) => {
+}, ct = (e) => e === void 0 ? /* @__PURE__ */ new Uint8Array() : new TextEncoder().encode(JSON.stringify(e)), lt = (e) => e === void 0 ? "" : typeof e == "string" ? e : new TextDecoder().decode(e), ut = (e) => {
 	let { ctx: t } = e, n = ye((e.publicApi ?? []).map((e) => ({
 		descriptor: e.descriptor,
-		invoke: (n, r) => t.withSubject(r.subject, (t) => X(e.descriptor, e.handler, n, t))
+		invoke: (n, r) => t.withSubject(r.subject, (t) => Ye(e.descriptor, e.handler, n, t))
 	}))), r = [...e.restRoutes ?? [], ...n], i = _(e.strategies ?? [], {
 		...e.anonymousTenantRequired === void 0 ? {} : { anonymousTenantRequired: e.anonymousTenantRequired },
 		getStore: () => t.store
 	}), a = (n, o) => {
 		let s = {
 			store: t.store,
+			buildContext: () => t,
 			resolveSubject: n === void 0 ? async (e) => (await i({
 				headers: e,
 				clientId: -1
@@ -550,7 +567,7 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 			pattern: r[t].path,
 			route: e
 		})), l = async (e, n, i = {}) => {
-			let { path: a, query: s } = nt(n), l = c.filter((e) => rt(e.pattern, a)).map((e) => e.route);
+			let { path: a, query: s } = ot(n), l = c.filter((e) => st(e.pattern, a)).map((e) => e.route);
 			if (l.length === 0) return {
 				status: 404,
 				headers: {},
@@ -566,15 +583,15 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 				path: a,
 				query: s,
 				headers: {
-					...it(o),
-					...it(i.headers ?? {})
+					...$(o),
+					...$(i.headers ?? {})
 				},
-				rawBody: at(i.body),
+				rawBody: ct(i.body),
 				store: t.store
 			}, d = await be(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 = ot(d.body), m = (d.contentType ?? "").includes("json");
+			let p = lt(d.body), m = (d.contentType ?? "").includes("json");
 			return {
 				status: d.status,
 				headers: f,
@@ -608,7 +625,7 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 		};
 	};
 	return a(void 0, {});
-}, ct = (e = {}) => {
+}, dt = (e = {}) => {
 	let t = e.id ?? "test", n = e.store ?? new Proxy({}, { get: (e, t) => {
 		throw Error(`makeSubscribeContext: this subscriber reached ctx.store.${String(t)} and the test passed no store. Pass \`{ store: makeTestContext().store }\` so the subscriber and the code under test share one — an empty stand-in would let a read of the wrong table pass.`);
 	} });
@@ -618,7 +635,7 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 		store: n,
 		...e.publish === void 0 ? {} : { publish: e.publish }
 	};
-}, lt = (e) => {
+}, ft = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
 		let e = t.get(n.stepName);
@@ -644,13 +661,13 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 		});
 	}
 	return n.sort((e, t) => e._startedAt - t._startedAt), n.map(({ _startedAt: e, ...t }) => t);
-}, ut = (e) => {
+}, pt = (e) => {
 	let t = e.workflows ?? [], n = /* @__PURE__ */ new Map(), r = 0;
 	return {
 		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 = Te(), l = o.workflow.toLayer(o.execute).pipe(f.provideMerge(we)), d = /* @__PURE__ */ new Date(), p = o.workflow.execute(a).pipe(u.locally(Ce, s), u.provide(c.layer), u.provide(l), u.either), m = await u.runPromise(p), h = lt(c.readSteps()), g = /* @__PURE__ */ new Date(), _;
+			let s = `wfrun_test_${++r}`, c = Te(), l = o.workflow.toLayer(o.execute).pipe(f.provideMerge(we)), d = /* @__PURE__ */ new Date(), p = o.workflow.execute(a).pipe(u.locally(Ce, s), u.provide(c.layer), u.provide(l), u.either), m = await u.runPromise(p), h = ft(c.readSteps()), g = /* @__PURE__ */ new Date(), _;
 			if (m._tag === "Right") _ = {
 				status: "succeeded",
 				output: m.right,
@@ -690,6 +707,6 @@ var Ee = new Set(e), E = 0, De = () => ++E, Oe = (e, t) => {
 		},
 		inspect: async (e) => n.get(e) ?? null
 	};
-}, dt = 1;
+}, mt = 1;
 //#endregion
-export { N as MockClock, I as MockLLM, P as MockWebhooks, dt as TESTING_PRESET_VERSION, Xe as TEST_TENANT_ID, et as anonymous, Qe as apiKey, n as changeDelete, r as changeInsert, i as changeSoftDelete, a as changeUpdate, Me as defineFactory, Q as describeIfAvailable, Je as describeIfReachable, D as fixtureRow, Ie as frozenTime, X as invoke, Z as isTcpReachable, ct as makeSubscribeContext, st as makeTestApp, Ke as makeTestContext, ut as makeWorkflowRunner, Re as mockStore, De as nextSequence, ze as outboxNudgesOf, Ye as reportEngineVersion, G as resetAfterCommit, U as rpcInterceptorFor, K as runAfterCommit, q as runInStoreTransaction, $e as serviceAccount, W as serviceLayerFor, tt as system, F as testEventBus, Ze as user, Fe as withFrozenTime };
+export { F as MockClock, R as MockLLM, I as MockWebhooks, mt as TESTING_PRESET_VERSION, et as TEST_TENANT_ID, it as anonymous, nt as apiKey, n as changeDelete, r as changeInsert, i as changeSoftDelete, a as changeUpdate, je as defineFactory, Ze as describeIfAvailable, Qe as describeIfReachable, k as fixtureRow, Fe as frozenTime, Ye as invoke, Xe as isTcpReachable, dt as makeSubscribeContext, ut as makeTestApp, qe as makeTestContext, pt as makeWorkflowRunner, Le as mockStore, O as nextSequence, ze as outboxNudgesOf, $e as reportEngineVersion, J as resetAfterCommit, K as rpcInterceptorFor, Y as runAfterCommit, X as runInStoreTransaction, rt as serviceAccount, q as serviceLayerFor, at as system, L as testEventBus, tt as user, Pe as withFrozenTime, Re as withRpcConnection };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/testing",
-  "version": "0.65.0",
+  "version": "0.66.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,15 +43,15 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/database": "0.65.0",
-    "@voltro/env": "0.65.0",
-    "@voltro/logger": "0.65.0",
-    "@voltro/protocol": "0.65.0",
-    "@voltro/runtime": "0.65.0",
-    "@voltro/workflow": "0.65.0"
+    "@voltro/database": "0.66.0",
+    "@voltro/env": "0.66.0",
+    "@voltro/logger": "0.66.0",
+    "@voltro/protocol": "0.66.0",
+    "@voltro/runtime": "0.66.0",
+    "@voltro/workflow": "0.66.0"
   },
   "peerDependencies": {
-    "@voltro/client": "0.65.0",
+    "@voltro/client": "0.66.0",
     "effect": "^3.22.0",
     "react": "^19.0.0",
     "@effect/sql": "^0.52.0"