@voltro/testing 0.86.0 → 0.88.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,47 +1,47 @@
 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 } from "@voltro/client";
-//#region src/client.tsx
-var o = {
+import { FrameworkRuntimesContext as r, INITIAL_RECOVERY_SNAPSHOT as i, RpcErrorBus as a, resolveRecoveryOptions as o } from "@voltro/client";
+// src/client.tsx
+var s = {
 	runPromise: t.runPromise,
 	runPromiseExit: t.runPromiseExit,
 	runFork: t.runFork,
 	dispose: () => t.void
-}, s = (e = {}) => {
-	let s = e.apiName ?? "app", c = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), u = /* @__PURE__ */ new Map(), d = [];
-	for (let [t, n] of Object.entries(e.subscriptions ?? {})) c.set(t, {
+}, 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 f = (e) => c.get(e) ?? {
+	let p = (e) => l.get(e) ?? {
 		data: void 0,
 		error: void 0,
 		revision: -1,
 		pendingPatches: 0,
 		emittedAt: void 0
-	}, p = (e) => {
-		u.delete(e);
-		for (let t of l.get(e) ?? []) t();
-	}, m = (e) => String(e[0] ?? ""), h = {
+	}, m = (e) => {
+		d.delete(e);
+		for (let t of u.get(e) ?? []) t();
+	}, h = (e) => String(e[0] ?? ""), g = {
 		peek: (e) => {
-			let t = m(e), n = u.get(t);
+			let t = h(e), n = d.get(t);
 			if (n) return n;
-			let r = f(t), i = {
+			let r = p(t), i = {
 				data: r.data,
 				revision: r.revision,
 				emittedAt: r.emittedAt,
 				error: r.error,
 				pendingPatches: r.pendingPatches
 			};
-			return u.set(t, i), i;
+			return d.set(t, i), i;
 		},
 		subscribe: (e, t, n, r) => {
-			let i = m(e), a = l.get(i) ?? /* @__PURE__ */ new Set();
-			return a.add(r), l.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);
 			} };
 		},
@@ -54,9 +54,9 @@ var o = {
 		update: () => {},
 		forTag: () => ({ patchedCount: 0 }),
 		refreshAll: () => {
-			g += 1;
+			_ += 1;
 		}
-	}, g = 0, _ = {
+	}, _ = 0, v = {
 		rawTransport: "connected",
 		status: "connected",
 		failureCount: 0,
@@ -64,31 +64,44 @@ var o = {
 		failedSubscriptions: [],
 		pendingMutationReplays: 0,
 		mutationReplay: "unknown"
-	}, v = /* @__PURE__ */ new Set(), y = new a(), b = !0, x = {
-		subscribe: (e) => (v.add(e), () => {
-			v.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: () => _,
+		getSnapshot: () => v,
 		getServerSnapshot: () => i,
-		getPreloadSeedPermission: () => b,
+		getPreloadSeedPermission: () => S,
 		invalidatePreloadSeeds: () => {
-			if (b) {
-				b = !1;
-				for (let e of v) e();
+			if (S) {
+				S = !1;
+				for (let e of y) e();
 			}
 		},
-		onVisibleError: (e) => y.on(e),
-		waitForProtocolReady: async (e, t) => !t?.aborted && _.rawTransport === "connected",
+		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
-	}, S = {}, C = (e, n, r) => {
-		let i = e.split("."), a = S;
+	}, 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) => t.tryPromise({
-			try: async () => (d.push({
+			try: async () => (f.push({
 				kind: n,
 				tag: e,
 				input: i
@@ -96,64 +109,63 @@ var o = {
 			catch: (e) => e
 		});
 	};
-	for (let [t, n] of Object.entries(e.mutations ?? {})) C(t, "mutation", n);
-	for (let [t, n] of Object.entries(e.actions ?? {})) C(t, "action", n);
-	let w = {
-		runtime: o,
-		cache: h,
-		recovery: x,
-		client: S,
+	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: g,
+		recovery: C,
+		client: w,
 		descriptors: {},
 		inspectBaseUrl: "http://test.local",
-		errorBus: y
-	}, T = {
+		errorBus: x
+	}, D = {
 		get: (e) => {
-			if (e !== s) throw Error(`makeVoltroTestClient: component asked for api '${e}' but the harness was built for '${s}'. Pass { apiName: '${e}' }.`);
-			return w;
+			if (e !== c) throw Error(`makeVoltroTestClient: component asked for api '${e}' but the harness was built for '${c}'. Pass { apiName: '${e}' }.`);
+			return E;
 		},
-		names: [s]
+		names: [c]
 	};
 	return {
-		Provider: ({ children: e }) => n(r.Provider, { value: T }, e),
+		Provider: ({ children: e }) => n(r.Provider, { value: D }, e),
 		setSubscription: (e, t, n) => {
-			let r = f(e);
-			c.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
-			}), p(e);
+			}), m(e);
 		},
 		failSubscription: (e, t) => {
-			c.set(e, {
+			l.set(e, {
 				data: void 0,
 				error: t,
 				revision: -1,
 				pendingPatches: 0,
 				emittedAt: void 0
-			}), p(e);
+			}), m(e);
 		},
 		resetSubscription: (e) => {
-			c.delete(e), p(e);
+			l.delete(e), m(e);
 		},
-		calls: d,
+		calls: f,
 		setConnectionStatus: (e, t) => {
-			_ = {
-				..._,
+			v = {
+				...v,
 				...t,
 				status: e,
 				rawTransport: t?.rawTransport ?? (e === "connected" ? "connected" : "disconnected")
 			};
-			for (let e of v) e();
+			for (let e of y) e();
 		},
 		get refreshes() {
-			return g;
+			return _;
 		},
 		emitRpcError: (e) => {
-			w.errorBus.emit(e);
+			E.errorBus.emit(e);
 		}
 	};
 };
-//#endregion
-export { o as FAKE_RUNTIME, s as makeVoltroTestClient, e as renderFormBinding };
+export { s as FAKE_RUNTIME, c as makeVoltroTestClient, e as renderFormBinding };

package/dist/crdt.js

@@ -1,5 +1,5 @@
 import { describe as e, expect as t, it as n } from "vitest";
-//#region src/crdtBackendConformance.ts
+// src/crdtBackendConformance.ts
 var r = (r, i) => {
 	let a = i.backend, o = (e) => a.createText(e).encodeState(), s = (e, t, n) => {
 		let r = a.createText();
@@ -73,5 +73,4 @@ var r = (r, i) => {
 		});
 	});
 };
-//#endregion
 export { r as crdtBackendConformance };

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 { }