@voltro/testing 0.33.0 → 0.34.0

package/dist/index.js

@@ -1,14 +1,15 @@
 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, composeRpcInterceptors as _, eventRoute as v, tenantScopedSubject as ee } from "@voltro/protocol";
-import { EventBus as y, InMemoryDataStore as te, applyRowFilterToDescriptor as ne, clearSystemStoreHandle as b, getRowFilter as x, getSystemStoreHandle as S, makeAppAccess as C, makeDataLoader as w, makeEffectStoreLayer as T, makeOutboxFacade as re, makeSchemaRegistry as ie, publishEvent as ae, resolveRowFilterScopeFor as oe, runProvidedEffect as E, runWithDeadlockRetry as se, setSystemStoreHandle as D, wrapStoreWithMixinBehaviour as O } from "@voltro/runtime";
-import { installEnvSnapshot as ce } from "@voltro/env";
-import le from "node:net";
-import { describe as ue } from "vitest";
-import { createLogger as de } from "@voltro/logger";
-import { CurrentWorkflowRunId as fe, inMemoryWorkflowEngineLayer as k, makeInMemoryRecorder as A } from "@voltro/workflow";
+import { SubjectService as m, anonymousSubject as h, checkGuardsEffect as g, composeAuthStrategies as _, composeRpcInterceptors as v, eventRoute as ee, systemSubject as y, tenantScopedSubject as b } from "@voltro/protocol";
+import { EventBus as te, InMemoryDataStore as ne, applyRowFilterToDescriptor as re, clearSystemStoreHandle as ie, getRowFilter as ae, getSystemStoreHandle as oe, makeAppAccess as se, makeDataLoader as x, makeEffectStoreLayer as ce, makeOutboxFacade as le, makeSchemaRegistry as ue, publishEvent as de, resolveRowFilterScopeFor as fe, runProvidedEffect as S, runWithDeadlockRetry as pe, setSystemStoreHandle as C, wrapStoreWithMixinBehaviour as w } from "@voltro/runtime";
+import { installEnvSnapshot as me } from "@voltro/env";
+import he from "node:net";
+import { describe as ge } from "vitest";
+import { collectPublicApiRoutes as _e, dispatchSharedPath as ve, restRoutesToHttpRoutes as ye } from "@voltro/protocol/rest";
+import { createLogger as be } from "@voltro/logger";
+import { CurrentWorkflowRunId as xe, inMemoryWorkflowEngineLayer as Se, makeInMemoryRecorder as Ce } from "@voltro/workflow";
 //#region src/fixtureRow.ts
-var j = new Set(e), M = 0, N = (e, t) => {
+var we = new Set(e), T = 0, E = () => ++T, Te = (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;
@@ -16,27 +17,95 @@ var j = new Set(e), M = 0, N = (e, t) => {
 		case "text":
 		case "reference":
 		case "id":
-		case "enum": return n ? `${e}-${++M}` : e;
+		case "enum": return n ? `${e}-${++T}` : e;
 		case "integer":
-		case "real": return n ? ++M : 0;
+		case "real": return n ? ++T : 0;
 		case "decimal":
-		case "bigint": return n ? String(++M) : "0";
+		case "bigint": return n ? String(++T) : "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}: … }).`);
 	}
-}, P = (e, t = {}) => {
+}, D = (e, t = {}) => {
 	let n = {};
-	for (let r of s(e, t)) j.has(r) || (n[r] = N(r, e.fields[r]));
+	for (let r of s(e, t)) we.has(r) || (n[r] = Te(r, e.fields[r]));
 	return {
 		...n,
 		...t
 	};
-}, F = class {
+}, O = (e) => {
+	let t = {};
+	for (let [n, r] of Object.entries(e)) t[n] = typeof r == "function" ? r(E()) : r;
+	return t;
+}, Ee = (e) => {
+	for (let [t, n] of Object.entries(e.fields)) if (n.type === "id") return t;
+	return "id";
+}, De = async (e, t, n, r, i) => {
+	let a = {};
+	for (let o of s(t, n)) {
+		let n = t.fields[o];
+		if (n === void 0 || n.type !== "reference" || n.references === void 0) continue;
+		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 k(e, s, {}, {}, [...i, s.tableName]) : await c.create(e, {}))[Ee(s)];
+	}
+	return a;
+}, k = async (e, t, n, r, i) => {
+	let a = {
+		...await De(e, t, n, r, i),
+		...n
+	};
+	return e.insert(t.tableName, D(t, a));
+}, A = (e, t) => typeof e == "function" ? e(t) : e ?? {}, Oe = (e, t = {}) => {
+	let n = t.traits ?? {}, r = t.associations ?? {}, i = (t) => {
+		let a = (e = {}) => ({
+			...O(t),
+			...e
+		}), o = (t = {}) => D(e, a(t));
+		return {
+			table: e,
+			build: o,
+			buildList: (e, t) => Array.from({ length: e }, (e, n) => o(A(t, n))),
+			create: (t, n = {}) => k(t, e, a(n), r, [e.tableName]),
+			createList: async (t, n, i) => {
+				let o = [];
+				for (let s = 0; s < n; s++) o.push(await k(t, e, a(A(i, s)), r, [e.tableName]));
+				return o;
+			},
+			with: (...r) => {
+				let a = t;
+				for (let t of r) {
+					let r = n[t];
+					if (r === void 0) throw Error(`defineFactory: '${e.tableName}' has no trait '${t}'. Declared: ${Object.keys(n).join(", ") || "(none)"}.`);
+					a = {
+						...a,
+						...r
+					};
+				}
+				return i(a);
+			},
+			extend: (e) => i({
+				...t,
+				...e
+			})
+		};
+	};
+	return i(t.defaults ?? {});
+}, j = Symbol.for("voltro/testing/mockClock.installed"), M = () => globalThis, ke = (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)
+}), N = (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;
+}, P = class {
 	currentMs;
-	constructor(e = /* @__PURE__ */ new Date("2026-01-01T00:00:00Z")) {
-		this.currentMs = typeof e == "number" ? e : e.getTime();
+	constructor(e = "2026-01-01T00:00:00Z") {
+		this.currentMs = N(e);
 	}
 	now() {
 		return this.currentMs;
@@ -45,9 +114,47 @@ var j = new Set(e), M = 0, N = (e, t) => {
 		return new Date(this.currentMs);
 	}
 	advance(e) {
-		this.currentMs += typeof e == "number" ? e : I(e);
+		this.currentMs += typeof e == "number" ? e : Ne(e);
+	}
+	set(e) {
+		this.currentMs = N(e);
+	}
+	get installed() {
+		return M()[j]?.clock === this;
 	}
-}, I = (e) => {
+	install() {
+		let e = M(), t = e[j];
+		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[j] = {
+			realDate: n,
+			clock: this
+		}, globalThis.Date = ke(n, () => this.currentMs), () => {
+			this.uninstall();
+		};
+	}
+	uninstall() {
+		let e = M(), t = e[j];
+		t === void 0 || t.clock !== this || (globalThis.Date = t.realDate, delete e[j]);
+	}
+}, Ae = (e) => typeof e == "object" && !!e && typeof e.then == "function", je = (e, t) => {
+	let n = e instanceof P ? e : new P(e);
+	n.install();
+	let r = !1;
+	try {
+		let e = t(n);
+		return Ae(e) ? (r = !0, e.then((e) => (n.uninstall(), e), (e) => {
+			throw n.uninstall(), e;
+		})) : e;
+	} finally {
+		r || n.uninstall();
+	}
+}, Me = (e) => u.acquireRelease(u.sync(() => {
+	let t = e instanceof P ? e : new P(e);
+	return t.install(), t;
+}), (e) => u.sync(() => {
+	e.uninstall();
+})), Ne = (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];
@@ -59,21 +166,7 @@ var j = new Set(e), M = 0, N = (e, t) => {
 		case "d": return n * 864e5;
 		default: throw Error(`mockClock: unknown unit '${r}'`);
 	}
-}, L = class {
-	sent = [];
-	send(e) {
-		this.sent.push({
-			...e,
-			sentAt: /* @__PURE__ */ new Date()
-		});
-	}
-	lastTo(e) {
-		for (let t = this.sent.length - 1; t >= 0; t--) if (this.sent[t].to === e) return this.sent[t];
-	}
-	clear() {
-		this.sent.length = 0;
-	}
-}, R = class {
+}, F = class {
 	emitted = [];
 	async emit(e, t) {
 		let n = typeof e == "string" ? e : e.id ?? e.event ?? "(unnamed event)";
@@ -92,7 +185,7 @@ var j = new Set(e), M = 0, N = (e, t) => {
 	clear() {
 		this.emitted.length = 0;
 	}
-}, z = class {
+}, I = class {
 	queue;
 	calls = [];
 	constructor(e) {
@@ -107,29 +200,32 @@ var j = new Set(e), M = 0, N = (e, t) => {
 	remaining() {
 		return this.queue.length;
 	}
-}, B = (e) => e, V = "00000000000000000000000000000000", H = /* @__PURE__ */ new WeakMap(), U = /* @__PURE__ */ new WeakMap(), W = /* @__PURE__ */ new WeakMap(), G = /* @__PURE__ */ new WeakMap(), K = (e, t) => {
-	let n = G.get(e) ?? [], r = t === "mutation" ? "interceptMutation" : t === "query" ? "interceptQuery" : "interceptAction", i = [];
+}, Pe = (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 = [];
 	for (let e of n) {
 		let t = e[r];
 		typeof t == "function" && i.push(t);
 	}
-	return _(i);
-}, q = (e) => {
-	let t = U.get(e);
+	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];
+	if (r.length !== 0) return f.mergeAll(...r);
+}, G = (e) => {
+	let t = z.get(e);
 	t !== void 0 && (t.length = 0);
-}, J = async (e) => {
-	let t = U.get(e);
+}, K = async (e) => {
+	let t = z.get(e);
 	if (t === void 0 || t.length === 0) return;
 	let n = [...t];
 	t.length = 0;
 	for (let e of n) await e();
-}, pe = (e) => W.get(e) ?? [], Y = async (e, t) => {
-	let n = H.get(e);
+}, Fe = (e) => B.get(e) ?? [], q = async (e, t) => {
+	let n = R.get(e);
 	return n === void 0 ? e.store.transactional(async (n) => t({
 		...e,
 		store: n
 	})) : n(t);
-}, me = (e) => {
+}, Ie = (e) => {
 	let t = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map(), r = (n) => {
 		let r = t.get(n);
 		return r === void 0 ? !1 : r.expiresAt !== null && r.expiresAt <= e() ? (t.delete(n), !1) : !0;
@@ -168,7 +264,7 @@ var j = new Set(e), M = 0, N = (e, t) => {
 			return i(e, o, n.ttlMs, n.tags), o;
 		}
 	};
-}, he = (e) => {
+}, Le = (e) => {
 	let t = /* @__PURE__ */ new Map(), n = (n) => {
 		let r = t.get(n);
 		return r === void 0 ? !1 : r.expiresAt !== null && r.expiresAt <= e() ? (t.delete(n), !1) : !0;
@@ -196,96 +292,98 @@ var j = new Set(e), M = 0, N = (e, t) => {
 			t.clear();
 		}
 	};
-}, ge = async (e, t) => {
-	let n = S();
-	D(e);
+}, Re = async (e, t) => {
+	let n = oe();
+	C(e);
 	try {
 		return await t();
 	} finally {
-		n === void 0 ? b() : D(n);
+		n === void 0 ? ie() : C(n);
 	}
-}, _e = (e, t, n) => {
-	let r = ve, i;
+}, ze = (e, t, n) => {
+	let r = Be, i;
 	return () => {
-		let a = t ?? x();
-		return (i === void 0 || a !== r) && (r = a, i = ge(n, () => E(oe(a, e, (e) => {
+		let a = t ?? ae();
+		return (i === void 0 || a !== r) && (r = a, i = Re(n, () => S(fe(a, e, (e) => {
 			console.error("[voltro:testing] row filter failed to load — reads refused for this subject", e);
 		})))), i;
 	};
-}, ve = Symbol("unresolved"), X = (e, t) => new Proxy(e, { get: (e, n) => {
-	if (n === "query") return async (n) => e.query(ne(await t(), n));
+}, Be = Symbol("unresolved"), J = (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;
-} }), ye = (e = {}) => {
-	if (ce({
+} }), Ve = (e = {}) => {
+	if (me({
 		...process.env,
 		...e.env ?? {}
 	}), e.relations !== void 0) {
 		o();
 		for (let t of e.relations) c(t);
 	}
-	let n = ie(e.tables ?? t()), r = new te(e.store ?? {}), i = {
+	let n = ue(e.tables ?? t()), r = new ne(e.store ?? {}), i = {
 		dataStore: r,
 		schemaRegistry: n
 	};
-	D(i);
-	let a = new F(e.clockStart), s = new L(), l = new R(), u = new z(e.llmResponses ?? []), d = me(() => a.now()), f = he(() => a.now()), p = (t, o = r, c) => {
-		let m = {
+	C(i);
+	let a = new P(e.clockStart), s = new F(), l = new I(e.llmResponses ?? []), u = Ie(() => a.now()), d = Le(() => a.now()), f = (t, o = r, c) => {
+		let p = {
 			subject: t,
-			traceId: V
-		}, h = c?.queued ?? [], g = c?.nudges ?? [], _ = w({ store: o }), v = _e(t, e.rowFilter, i), y = {
+			traceId: L
+		}, m = c?.queued ?? [], h = c?.nudges ?? [], g = x({ store: o }), _ = ze(t, e.rowFilter, i), v = {
 			clock: a,
-			email: s,
-			webhooks: l,
-			llm: u,
+			webhooks: s,
+			llm: l,
 			...e.ai === void 0 ? {} : { ai: e.ai },
-			request: m,
-			access: C(t),
-			cache: d,
-			kv: f,
-			store: O(X(o, v), {
+			request: p,
+			access: se(t),
+			cache: u,
+			kv: d,
+			store: w(J(o, _), {
 				subject: t,
 				schemaRegistry: n
 			}),
-			storeForTenant: (e) => O(X(o, v), {
-				subject: ee(t, e),
+			storeForTenant: (e) => w(J(o, _), {
+				subject: b(t, e),
 				schemaRegistry: n
 			}),
-			outbox: re({
+			outbox: le({
 				store: o,
 				subject: t,
-				traceId: V,
+				traceId: L,
 				nudge: () => {
-					g.push(V);
+					h.push(L);
 				},
 				afterCommit: (e) => {
-					h.push(e);
+					m.push(e);
 				}
 			}),
-			load: _.load,
-			loadMany: _.loadMany,
-			withSubject: (e, t) => Promise.resolve(t(p(e, o, {
-				queued: h,
-				nudges: g
+			load: g.load,
+			loadMany: g.loadMany,
+			withSubject: (e, t) => Promise.resolve(t(f(e, o, {
+				queued: m,
+				nudges: h
 			}))),
-			withTenant: (e, n) => Promise.resolve(n(p({
+			withTenant: (e, n) => Promise.resolve(n(f({
 				...t,
 				tenantId: e
 			}, o, {
-				queued: h,
-				nudges: g
+				queued: m,
+				nudges: h
 			})))
 		};
-		return U.set(y, h), W.set(y, g), G.set(y, e.plugins ?? []), H.set(y, (e) => o.transactional((n) => e(p(t, n, {
-			queued: h,
-			nudges: g
-		})))), y;
+		return z.set(v, m), B.set(v, h), V.set(v, e.plugins ?? []), H.set(v, e.layers ?? []), R.set(v, (e) => o.transactional((n) => e(f(t, n, {
+			queued: m,
+			nudges: h
+		})))), v;
 	};
-	return p(e.subject ?? h(null));
-}, be = (e, t) => e.pipe(u.provide(T(t.store)), u.provideService(m, t.request.subject)), xe = async (e, t, n, r) => {
+	return f(e.subject ?? h(null));
+}, He = (e, t) => {
+	let n = W(t);
+	return (n === void 0 ? e : u.provide(e, n)).pipe(u.provide(ce(t.store)), u.provideService(m, t.request.subject));
+}, Y = 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) ? E(be(n, e)) : n;
+		return u.isEffect(n) ? S(He(n, e)) : n;
 	}, c = async () => {
 		let t = e.guards;
 		if (t !== void 0 && t.length > 0) {
@@ -293,9 +391,9 @@ var j = new Set(e), M = 0, N = (e, t) => {
 			if (e !== null) throw e;
 		}
 		if (o !== "mutation") return s(r);
-		let n = await se(async () => (q(r), Y(r, async (e) => s(e))), { delay: () => Promise.resolve() });
-		return await J(r), n;
-	}, f = o === "mutation" || o === "query" || o === "action" ? o : void 0, m = f === void 0 ? void 0 : K(r, f);
+		let n = await pe(async () => (G(r), q(r, async (e) => 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);
 	if (m === void 0 || f === void 0) return await c();
 	let h = m(u.tryPromise({
 		try: () => c(),
@@ -310,12 +408,12 @@ var j = new Set(e), M = 0, N = (e, t) => {
 	}), _ = await u.runPromiseExit(h);
 	if (d.isSuccess(_)) return _.value;
 	throw l.squash(_.cause);
-}, Z = (e) => new Promise((t) => {
-	let n = new le.Socket(), r = (e) => {
+}, X = (e) => new Promise((t) => {
+	let n = new he.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) => {
+}), Z = 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 {
@@ -323,17 +421,115 @@ var j = new Set(e), M = 0, N = (e, t) => {
 	} catch {
 		i = !1;
 	}
-	ue.skipIf(!i)(i ? e : `${e} [SKIPPED: needs ${t}]`, r);
-}, Se = async (e, t, n) => {
-	await Q(e, `${t.name} at ${t.host}:${t.port}`, () => Z(t), n);
-}, Ce = (e = {}) => {
-	let t = e.tenantId ?? null, n = new y({
+	ge.skipIf(!i)(i ? e : `${e} [SKIPPED: needs ${t}]`, r);
+}, Ue = async (e, t, n) => {
+	await Z(e, `${t.name} at ${t.host}:${t.port}`, () => X(t), n);
+}, We = "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 }
+}), Ge = (e, t = {}) => Q("user", e, t), Ke = (e, t = {}) => Q("apiKey", e, t), qe = (e, t = {}) => Q("serviceAccount", e, t), Je = (e = null) => h(e), Ye = (e = "job:test", t) => t === void 0 ? y(e) : y(e, t), Xe = (e) => {
+	let t = e.indexOf("?");
+	return t === -1 ? {
+		path: e,
+		query: ""
+	} : {
+		path: e.slice(0, t),
+		query: e.slice(t + 1)
+	};
+}, Ze = (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]);
+}, $ = (e) => {
+	let t = {};
+	for (let [n, r] of Object.entries(e)) t[n.toLowerCase()] = r;
+	return t;
+}, Qe = (e) => e === void 0 ? /* @__PURE__ */ new Uint8Array() : new TextEncoder().encode(JSON.stringify(e)), $e = (e) => e === void 0 ? "" : typeof e == "string" ? e : new TextDecoder().decode(e), et = (e) => {
+	let { ctx: t } = e, n = _e((e.publicApi ?? []).map((e) => ({
+		descriptor: e.descriptor,
+		invoke: (n, r) => t.withSubject(r.subject, (t) => Y(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,
+			resolveSubject: n === void 0 ? async (e) => (await i({
+				headers: e,
+				clientId: -1
+			})).subject : () => n,
+			...e.idempotency === void 0 ? {} : { idempotency: e.idempotency }
+		}, c = ye(r, s).map((e, t) => ({
+			pattern: r[t].path,
+			route: e
+		})), l = async (e, n, i = {}) => {
+			let { path: a, query: s } = Xe(n), l = c.filter((e) => Ze(e.pattern, a)).map((e) => e.route);
+			if (l.length === 0) return {
+				status: 404,
+				headers: {},
+				text: "",
+				body: {
+					error: "No route mounted for this path",
+					mounted: r.map((e) => e.path)
+				},
+				stream: !1
+			};
+			let u = await ve(l, {
+				method: e.toUpperCase(),
+				path: a,
+				query: s,
+				headers: {
+					...$(o),
+					...$(i.headers ?? {})
+				},
+				rawBody: Qe(i.body),
+				store: t.store
+			}), d = $(u.headers ?? {});
+			u.contentType !== void 0 && (d["content-type"] = u.contentType);
+			let f = $e(u.body), p = (u.contentType ?? "").includes("json");
+			return {
+				status: u.status,
+				headers: d,
+				text: f,
+				body: p && f !== "" ? JSON.parse(f) : void 0,
+				stream: u.stream !== void 0
+			};
+		};
+		return {
+			actingAs: (e) => a(e, o),
+			withHeaders: (e) => a(n, {
+				...o,
+				...e
+			}),
+			get: (e, t) => l("GET", e, t ?? {}),
+			delete: (e, t) => l("DELETE", e, t ?? {}),
+			post: (e, t, n) => l("POST", e, {
+				...n ?? {},
+				body: t
+			}),
+			put: (e, t, n) => l("PUT", e, {
+				...n ?? {},
+				body: t
+			}),
+			patch: (e, t, n) => l("PATCH", e, {
+				...n ?? {},
+				body: t
+			}),
+			request: (e, t, n) => l(e, t, n ?? {}),
+			paths: r.map((e) => e.path)
+		};
+	};
+	return a(void 0, {});
+}, tt = (e = {}) => {
+	let t = e.tenantId ?? null, n = new te({
 		origin: e.origin ?? "test",
 		...e.ringSize === void 0 ? {} : { ringSize: e.ringSize }
 	});
 	return {
 		publish: async (e, r, i) => {
-			let a = await u.runPromise(u.either(ae({
+			let a = await u.runPromise(u.either(de({
 				bus: n,
 				tenantId: t
 			}, e, r, i)));
@@ -382,7 +578,7 @@ var j = new Set(e), M = 0, N = (e, t) => {
 		},
 		skipSerials: (e, r, i, a) => {
 			let o = {
-				route: v(a?.tenantId ?? t, e.name, r),
+				route: ee(a?.tenantId ?? t, e.name, r),
 				event: e.name,
 				origin: "test-gap",
 				n: i + 1,
@@ -396,17 +592,17 @@ var j = new Set(e), M = 0, N = (e, t) => {
 			n.clear();
 		}
 	};
-}, $ = (e = {}) => {
+}, nt = (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.`);
 	} });
 	return {
 		id: t,
-		log: e.log ?? de({ scope: `subscribe:${t}` }),
+		log: e.log ?? be({ scope: `subscribe:${t}` }),
 		store: n,
 		...e.publish === void 0 ? {} : { publish: e.publish }
 	};
-}, we = (e) => {
+}, rt = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
 		let e = t.get(n.stepName);
@@ -432,13 +628,13 @@ var j = new Set(e), M = 0, N = (e, t) => {
 		});
 	}
 	return n.sort((e, t) => e._startedAt - t._startedAt), n.map(({ _startedAt: e, ...t }) => t);
-}, Te = (e) => {
+}, it = (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 = A(), l = o.workflow.toLayer(o.execute).pipe(f.provideMerge(k)), d = /* @__PURE__ */ new Date(), p = o.workflow.execute(a).pipe(u.locally(fe, s), u.provide(c.layer), u.provide(l), u.either), m = await u.runPromise(p), h = we(c.readSteps()), g = /* @__PURE__ */ new Date(), _;
+			let s = `wfrun_test_${++r}`, c = Ce(), l = o.workflow.toLayer(o.execute).pipe(f.provideMerge(Se)), d = /* @__PURE__ */ new Date(), p = o.workflow.execute(a).pipe(u.locally(xe, s), u.provide(c.layer), u.provide(l), u.either), m = await u.runPromise(p), h = rt(c.readSteps()), g = /* @__PURE__ */ new Date(), _;
 			if (m._tag === "Right") _ = {
 				status: "succeeded",
 				output: m.right,
@@ -478,6 +674,6 @@ var j = new Set(e), M = 0, N = (e, t) => {
 		},
 		inspect: async (e) => n.get(e) ?? null
 	};
-}, Ee = 1;
+}, at = 1;
 //#endregion
-export { F as MockClock, L as MockEmail, z as MockLLM, R as MockWebhooks, Ee as TESTING_PRESET_VERSION, n as changeDelete, r as changeInsert, i as changeSoftDelete, a as changeUpdate, Q as describeIfAvailable, Se as describeIfReachable, P as fixtureRow, xe as invoke, Z as isTcpReachable, $ as makeSubscribeContext, ye as makeTestContext, Te as makeWorkflowRunner, B as mockStore, pe as outboxNudgesOf, q as resetAfterCommit, K as rpcInterceptorFor, J as runAfterCommit, Y as runInStoreTransaction, Ce as testEventBus };
+export { P as MockClock, I as MockLLM, F as MockWebhooks, at as TESTING_PRESET_VERSION, We as TEST_TENANT_ID, Je as anonymous, Ke as apiKey, n as changeDelete, r as changeInsert, i as changeSoftDelete, a as changeUpdate, Oe as defineFactory, Z as describeIfAvailable, Ue as describeIfReachable, D as fixtureRow, Me as frozenTime, Y as invoke, X as isTcpReachable, nt as makeSubscribeContext, et as makeTestApp, Ve as makeTestContext, it as makeWorkflowRunner, Pe as mockStore, E as nextSequence, Fe as outboxNudgesOf, G as resetAfterCommit, U as rpcInterceptorFor, K as runAfterCommit, q as runInStoreTransaction, qe as serviceAccount, W as serviceLayerFor, Ye as system, tt as testEventBus, Ge as user, je as withFrozenTime };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@voltro/testing",
-  "version": "0.33.0",
-  "description": "Test utilities for Voltro apps — deterministic clock, captured emails, queued LLM responses, scoped subject/tenant runners, and a cross-dialect parity harness.",
+  "version": "0.34.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",
     "typescript",
@@ -43,15 +43,15 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/database": "0.33.0",
-    "@voltro/env": "0.33.0",
-    "@voltro/logger": "0.33.0",
-    "@voltro/protocol": "0.33.0",
-    "@voltro/runtime": "0.33.0",
-    "@voltro/workflow": "0.33.0"
+    "@voltro/database": "0.34.0",
+    "@voltro/env": "0.34.0",
+    "@voltro/logger": "0.34.0",
+    "@voltro/protocol": "0.34.0",
+    "@voltro/runtime": "0.34.0",
+    "@voltro/workflow": "0.34.0"
   },
   "peerDependencies": {
-    "@voltro/client": "0.33.0",
+    "@voltro/client": "0.34.0",
     "effect": "^3.22.0",
     "react": "^19.0.0",
     "@effect/sql": "^0.52.0"