@voltro/testing 0.85.0 → 0.87.0

package/dist/client.d.ts

@@ -6,6 +6,7 @@ import { FormBinding } from '@voltro/client';
 import { FormStateSnapshot } from '@voltro/client';
 import { ReactElement } from 'react';
 import { ReactNode } from 'react';
+import { RecoveryOptions } from '@voltro/client';
 import { UseFormBindingOptions } from '@voltro/client';
 
 /** The snapshot shape `useConnectionStatus` subscribes to. */
@@ -177,6 +178,10 @@ export declare interface VoltroTestClientConfig {
     readonly mutations?: Readonly<Record<string, Handler>>;
     /** Action handlers per tag. */
     readonly actions?: Readonly<Record<string, Handler>>;
+    /** The client's recovery options, as an app passes them — `replayWindowMs` is how
+     *  long an action waits for a disconnected transport before it is refused
+     *  (default 10 s, at least 250 ms). */
+    readonly recovery?: RecoveryOptions;
 }
 
 export { }

package/dist/client.js

@@ -1,85 +1,47 @@
-import { Effect as e } from "effect";
-import { act as t, createElement as n } from "react";
-import { FrameworkRuntimesContext as r, RpcErrorBus as i, useFormBinding as a } from "@voltro/client";
-//#region src/formBindingHarness.tsx
-var o = async (e, r = {}) => {
-	if (globalThis.document === void 0) throw Error("renderFormBinding needs a DOM to render hooks — add `// @vitest-environment jsdom` to the spec.");
-	let { createRoot: i } = await import("react-dom/client"), o = r.apiName ?? "app", s = c({
-		apiName: o,
-		...r.client ?? {},
-		mutations: {
-			[e]: r.mutation ?? (() => ({ ok: !0 })),
-			...r.client?.mutations ?? {}
-		}
-	}), l, u = () => (l = a(o, e, r.binding ?? {}), null), d = i(globalThis.document.createElement("div"));
-	return await t(async () => {
-		d.render(n(s.Provider, null, n(u)));
-	}), {
-		binding: () => l,
-		fill: (e, n) => {
-			t(() => {
-				l.field(e).setValue(n);
-			});
-		},
-		blur: (e) => {
-			t(() => {
-				l.field(e).onBlur();
-			});
-		},
-		submit: async () => {
-			let e;
-			return await t(async () => {
-				e = await l.submit();
-			}), e;
-		},
-		errors: () => l.errors,
-		state: () => l.state,
-		client: s,
-		unmount: () => {
-			t(() => {
-				d.unmount();
-			});
-		}
-	};
-}, s = {
-	runPromise: e.runPromise,
-	runPromiseExit: e.runPromiseExit,
-	runFork: e.runFork,
-	dispose: () => e.void
-}, c = (t = {}) => {
-	let a = t.apiName ?? "app", o = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), u = [];
-	for (let [e, n] of Object.entries(t.subscriptions ?? {})) o.set(e, {
+import { renderFormBinding as e } from "./formBindingHarness.js";
+import { Effect as t } from "effect";
+import { createElement as n } from "react";
+import { FrameworkRuntimesContext as r, INITIAL_RECOVERY_SNAPSHOT as i, RpcErrorBus as a, resolveRecoveryOptions as o } from "@voltro/client";
+//#region src/client.tsx
+var s = {
+	runPromise: t.runPromise,
+	runPromiseExit: t.runPromiseExit,
+	runFork: t.runFork,
+	dispose: () => t.void
+}, c = (e = {}) => {
+	let c = e.apiName ?? "app", l = /* @__PURE__ */ new Map(), u = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Map(), f = [];
+	for (let [t, n] of Object.entries(e.subscriptions ?? {})) l.set(t, {
 		data: n,
 		error: void 0,
 		revision: 0,
 		pendingPatches: 0,
 		emittedAt: void 0
 	});
-	let d = (e) => o.get(e) ?? {
+	let p = (e) => l.get(e) ?? {
 		data: void 0,
 		error: void 0,
 		revision: -1,
 		pendingPatches: 0,
 		emittedAt: void 0
-	}, f = (e) => {
-		l.delete(e);
-		for (let t of c.get(e) ?? []) t();
-	}, p = (e) => String(e[0] ?? ""), m = {
+	}, m = (e) => {
+		d.delete(e);
+		for (let t of u.get(e) ?? []) t();
+	}, h = (e) => String(e[0] ?? ""), g = {
 		peek: (e) => {
-			let t = p(e), n = l.get(t);
+			let t = h(e), n = d.get(t);
 			if (n) return n;
-			let r = d(t), i = {
+			let r = p(t), i = {
 				data: r.data,
 				revision: r.revision,
 				emittedAt: r.emittedAt,
 				error: r.error,
 				pendingPatches: r.pendingPatches
 			};
-			return l.set(t, i), i;
+			return d.set(t, i), i;
 		},
 		subscribe: (e, t, n, r) => {
-			let i = p(e), a = c.get(i) ?? /* @__PURE__ */ new Set();
-			return a.add(r), c.set(i, a), { unsubscribe: () => {
+			let i = h(e), a = u.get(i) ?? /* @__PURE__ */ new Set();
+			return a.add(r), u.set(i, a), { unsubscribe: () => {
 				a.delete(r);
 			} };
 		},
@@ -92,9 +54,9 @@ var o = async (e, r = {}) => {
 		update: () => {},
 		forTag: () => ({ patchedCount: 0 }),
 		refreshAll: () => {
-			h += 1;
+			_ += 1;
 		}
-	}, h = 0, g = {
+	}, _ = 0, v = {
 		rawTransport: "connected",
 		status: "connected",
 		failureCount: 0,
@@ -102,83 +64,109 @@ var o = async (e, r = {}) => {
 		failedSubscriptions: [],
 		pendingMutationReplays: 0,
 		mutationReplay: "unknown"
-	}, _ = /* @__PURE__ */ new Set(), v = {
-		subscribe: (e) => (_.add(e), () => {
-			_.delete(e);
+	}, y = /* @__PURE__ */ new Set(), b = o(e.recovery), x = new a(), S = !0, C = {
+		options: b,
+		subscribe: (e) => (y.add(e), () => {
+			y.delete(e);
 		}),
-		getSnapshot: () => g,
+		getSnapshot: () => v,
+		getServerSnapshot: () => i,
+		getPreloadSeedPermission: () => S,
+		invalidatePreloadSeeds: () => {
+			if (S) {
+				S = !1;
+				for (let e of y) e();
+			}
+		},
+		onVisibleError: (e) => x.on(e),
+		waitForProtocolReady: (e, t) => {
+			if (t?.aborted) return Promise.resolve(!1);
+			if (v.rawTransport === "connected") return Promise.resolve(!0);
+			let n = b.replayWindowMs - (Date.now() - e);
+			return n <= 0 ? Promise.resolve(!1) : new Promise((e) => {
+				let r = (n) => {
+					y.delete(i), clearTimeout(o), t?.removeEventListener("abort", a), e(n);
+				}, i = () => {
+					v.rawTransport === "connected" && r(!0);
+				}, a = () => r(!1), o = setTimeout(() => r(!1), n);
+				y.add(i), t?.addEventListener("abort", a, { once: !0 }), t?.aborted && a();
+			});
+		},
+		reserveMutationReplay: () => void 0,
+		waitForMutationReplaySupport: async () => !1,
+		replayWindowRemaining: () => 0,
 		reportExternalSuccess: () => {},
 		subjectSignal: new AbortController().signal
-	}, y = {}, b = (t, n, r) => {
-		let i = t.split("."), a = y;
+	}, w = {}, T = (e, n, r) => {
+		let i = e.split("."), a = w;
 		for (let e of i.slice(0, -1)) a[e] = a[e] ?? {}, a = a[e];
-		a[i[i.length - 1]] = (i) => e.tryPromise({
-			try: async () => (u.push({
+		a[i[i.length - 1]] = (i) => t.tryPromise({
+			try: async () => (f.push({
 				kind: n,
-				tag: t,
+				tag: e,
 				input: i
 			}), await r(i)),
 			catch: (e) => e
 		});
 	};
-	for (let [e, n] of Object.entries(t.mutations ?? {})) b(e, "mutation", n);
-	for (let [e, n] of Object.entries(t.actions ?? {})) b(e, "action", n);
-	let x = {
+	for (let [t, n] of Object.entries(e.mutations ?? {})) T(t, "mutation", n);
+	for (let [t, n] of Object.entries(e.actions ?? {})) T(t, "action", n);
+	let E = {
 		runtime: s,
-		cache: m,
-		recovery: v,
-		client: y,
+		cache: g,
+		recovery: C,
+		client: w,
 		descriptors: {},
 		inspectBaseUrl: "http://test.local",
-		errorBus: new i()
-	}, S = {
+		errorBus: x
+	}, D = {
 		get: (e) => {
-			if (e !== a) throw Error(`makeVoltroTestClient: component asked for api '${e}' but the harness was built for '${a}'. Pass { apiName: '${e}' }.`);
-			return x;
+			if (e !== c) throw Error(`makeVoltroTestClient: component asked for api '${e}' but the harness was built for '${c}'. Pass { apiName: '${e}' }.`);
+			return E;
 		},
-		names: [a]
+		names: [c]
 	};
 	return {
-		Provider: ({ children: e }) => n(r.Provider, { value: S }, e),
+		Provider: ({ children: e }) => n(r.Provider, { value: D }, e),
 		setSubscription: (e, t, n) => {
-			let r = d(e);
-			o.set(e, {
+			let r = p(e);
+			l.set(e, {
 				data: t,
 				error: void 0,
 				revision: r.revision + 1,
 				pendingPatches: n?.pendingPatches ?? 0,
 				emittedAt: n?.emittedAt
-			}), f(e);
+			}), m(e);
 		},
 		failSubscription: (e, t) => {
-			o.set(e, {
+			l.set(e, {
 				data: void 0,
 				error: t,
 				revision: -1,
 				pendingPatches: 0,
 				emittedAt: void 0
-			}), f(e);
+			}), m(e);
 		},
 		resetSubscription: (e) => {
-			o.delete(e), f(e);
+			l.delete(e), m(e);
 		},
-		calls: u,
+		calls: f,
 		setConnectionStatus: (e, t) => {
-			g = {
-				...g,
+			v = {
+				...v,
 				...t,
 				status: e,
 				rawTransport: t?.rawTransport ?? (e === "connected" ? "connected" : "disconnected")
 			};
-			for (let e of _) e();
+			for (let e of y) e();
 		},
 		get refreshes() {
-			return h;
+			return _;
 		},
 		emitRpcError: (e) => {
-			x.errorBus.emit(e);
+			E.errorBus.emit(e);
 		}
 	};
 };
 //#endregion
-export { s as FAKE_RUNTIME, c as makeVoltroTestClient, o as renderFormBinding };
+export { s as FAKE_RUNTIME, c as makeVoltroTestClient, e as renderFormBinding };

package/dist/dialect.d.ts

@@ -1,5 +1,6 @@
 import { applySchema } from '@voltro/database/sql';
 import { DataStore } from '@voltro/database';
+import { DialectId } from '@voltro/database';
 import { Effect } from 'effect';
 import { SqlClient } from 'effect/sql';
 import { SqlDialect } from '@voltro/database';
@@ -48,6 +49,22 @@ export declare interface DialectFixtureSession {
     readonly dispose: () => Promise<void>;
 }
 
+export declare interface HotSqlFixture {
+    readonly dialect: DialectId;
+    readonly name: string;
+    readonly make: () => Promise<HotSqlFixtureSession>;
+}
+
+/** A real SQL fixture owns a fresh physical namespace and every connection it opens. */
+export declare interface HotSqlFixtureSession {
+    readonly store: DataStore;
+    /** Open another independent SQL connection/pool to the same owned tables. */
+    readonly connect: () => Promise<DataStore>;
+    /** Re-apply the declared tables; SQL fixtures must keep DDL idempotent. */
+    readonly migrate: () => Promise<void>;
+    readonly dispose: () => Promise<void>;
+}
+
 /**
  * Register the dialect's parity suite with vitest. Calls
  * `describe(...)` so the dialect's name appears in test output.
@@ -64,4 +81,7 @@ export declare interface DialectFixtureSession {
  */
 export declare const runDialectParity: (fixture: DialectFixture) => void;
 
+/** Identical HotStore assertions for every live SQL dialect; no fixture opt-outs. */
+export declare const runHotStoreSqlParity: (fixture: HotSqlFixture) => void;
+
 export { }