@voltro/react-native 0.62.3 → 0.63.0

package/CHANGELOG.md

@@ -39,6 +39,20 @@ _Changes staged for the next release accumulate here (rolled up from
 
 ---
 
+## [0.63.0] — 2026-09-03
+
+### ⚠ BREAKING
+
+- **@voltro/client, @voltro/runtime, @voltro/cli, @voltro/web, @voltro/react-native** — Short transport gaps now have one bounded recovery contract. Raw diagnostics remain immediate, while `useConnectionStatus` exposes `recovering` during a configurable grace window and `useOnRpcError` emits exactly one visible transport failure only if the gap remains open. Same-subject runtime swaps keep subscription bases, revisions and optimistic patches; subject changes discard them. Interrupted mutations report `outcome: unknown` and replay once with the same key only after the deployed API proves that server idempotency is active. The codemod explains the new status member and the raw versus presentation error channels.
+
+  **`voltro update` carries you across this** — codemod `0.63.0/01_recovery-presentation`. If you pin versions by hand and never run it, print the notes without changing anything: `voltro update --codemods-only --from <your current version> --dry-run` (this one ships in 0.63.0).
+
+### Fixed
+
+- **@voltro/database, @voltro/sql-turso, @voltro/sql-sqlite, @voltro/sql-mssql** — Framework-table evolution now converges under real SQLite and both local Turso transports, and has a live MSSQL fixture. The new Turso runs also fixed internal table protection, boolean/number introspection normalization, and case-insensitive SQLite-family index-name comparison. The MSSQL fixture exposed and fixes a second convergence bug: unbounded text that MSSQL auto-bounds for an index is now rendered and compared with the same indexed-column rule, so a second plan no longer tries to widen an indexed `NVARCHAR(450)` to `NVARCHAR(MAX)`.
+
+---
+
 ## [0.62.3] — 2026-09-03
 
 ### Added

package/dist/index.d.ts

@@ -325,6 +325,7 @@ export declare interface MobileApiBinding {
      *  {@link resolveDevWsUrl}. */
     readonly wsUrl: string;
     readonly headers?: ResolvableHeaders | undefined;
+    readonly recovery?: MountedApi['recovery'];
 }
 
 export declare interface MobileConnectionControls {

package/dist/index.js

@@ -1,8 +1,8 @@
 import { a as e, i as t, n, r, t as i } from "./devices-BjXAU-8I.js";
 import { useCallback as a, useEffect as o, useReducer as s, useRef as c, useState as l } from "react";
-import { buildApiRuntime as u, startApiSupervisor as d } from "@voltro/client";
+import { buildApiRuntime as u, recoveryCoordinatorFor as d, startApiSupervisor as f } from "@voltro/client";
 //#region src/deepLink.ts
-var f = (e) => {
+var p = (e) => {
 	let t = e.pattern;
 	if (t.length === 0 || t[0] !== "/") throw Error(`defineDeepLink: pattern must start with "/" (got "${t}")`);
 	return {
@@ -10,7 +10,7 @@ var f = (e) => {
 		pattern: t,
 		handler: e.handler
 	};
-}, p = (e) => {
+}, m = (e) => {
 	let t = e, n = /^([a-zA-Z][a-zA-Z0-9+.-]*):\/\//.exec(t);
 	if (n) {
 		let e = t.slice(n[0].length), r = n[1].toLowerCase();
@@ -27,8 +27,8 @@ var f = (e) => {
 			return e;
 		}
 	});
-}, m = (e, t) => {
-	let n = p(e), r = p(t);
+}, h = (e, t) => {
+	let n = m(e), r = m(t);
 	if (n.length !== r.length) return null;
 	let i = {};
 	for (let e = 0; e < n.length; e++) {
@@ -40,10 +40,10 @@ var f = (e) => {
 		} else if (t !== "*" && t !== a) return null;
 	}
 	return i;
-}, h = (e, t) => {
-	let n = m(e.pattern, t);
-	return n === null ? null : (e.handler(n), n);
 }, g = (e, t) => {
+	let n = h(e.pattern, t);
+	return n === null ? null : (e.handler(n), n);
+}, _ = (e, t) => {
 	let n = e.split("/").map((n) => {
 		if (!n.startsWith(":")) return n;
 		let r = n.slice(1), i = t[r];
@@ -51,21 +51,21 @@ var f = (e) => {
 		return encodeURIComponent(i);
 	}).join("/");
 	return n.length === 0 ? "/" : n;
-}, _ = (e, t) => {
+}, v = (e, t) => {
 	for (let n of e) {
-		let e = m(n.pattern, t);
+		let e = h(n.pattern, t);
 		if (e !== null) return {
 			descriptor: n,
 			params: e
 		};
 	}
 	return null;
-}, v = (e, t) => {
-	let n = _(e, t);
+}, y = (e, t) => {
+	let n = v(e, t);
 	if (n === null) return null;
 	let r = n.descriptor.handler;
 	return r(n.params), n.params;
-}, y = {
+}, b = {
 	status: "idle",
 	isForeground: !0,
 	lastSyncAt: void 0,
@@ -73,7 +73,7 @@ var f = (e) => {
 	lastError: void 0,
 	successCount: 0,
 	failureCount: 0
-}, b = (e, t) => {
+}, x = (e, t) => {
 	switch (t.type) {
 		case "foreground": return e.isForeground ? e : {
 			...e,
@@ -104,11 +104,11 @@ var f = (e) => {
 			failureCount: e.failureCount + 1
 		};
 		case "reset": return {
-			...y,
+			...b,
 			isForeground: e.isForeground
 		};
 	}
-}, x = (e, t, n, r = !1) => !(!n.enabled || e.status === "syncing" || !r && !e.isForeground || !r && n.intervalMs > 0 && e.lastAttemptAt !== void 0 && t - e.lastAttemptAt < n.intervalMs), S = (e, t) => {
+}, S = (e, t, n, r = !1) => !(!n.enabled || e.status === "syncing" || !r && !e.isForeground || !r && n.intervalMs > 0 && e.lastAttemptAt !== void 0 && t - e.lastAttemptAt < n.intervalMs), C = (e, t) => {
 	if (typeof document > "u" || typeof window > "u") return () => {};
 	let n = () => {
 		document.visibilityState === "visible" ? e() : t();
@@ -116,13 +116,13 @@ var f = (e) => {
 	return document.addEventListener("visibilitychange", n), window.addEventListener("focus", e), () => {
 		document.removeEventListener("visibilitychange", n), window.removeEventListener("focus", e);
 	};
-}, C = 3e5, w = (e, t = {}) => {
-	let n = t.intervalMs ?? C, r = t.syncOnForeground ?? !0, i = t.enabled ?? !0, l = t.now ?? Date.now, u = t.subscribeForeground ?? S, [d, f] = s(b, y), p = c(e);
+}, w = 3e5, T = (e, t = {}) => {
+	let n = t.intervalMs ?? w, r = t.syncOnForeground ?? !0, i = t.enabled ?? !0, l = t.now ?? Date.now, u = t.subscribeForeground ?? C, [d, f] = s(x, b), p = c(e);
 	p.current = e;
 	let m = c(d);
 	m.current = d;
 	let h = c(!0), g = a((e) => {
-		x(m.current, l(), {
+		S(m.current, l(), {
 			intervalMs: n,
 			enabled: i
 		}, e) && (f({
@@ -167,7 +167,7 @@ var f = (e) => {
 		...d,
 		sync: _
 	};
-}, T = {
+}, E = {
 	localFirst: !0,
 	optimistic: !0,
 	syncOnForeground: !0,
@@ -179,7 +179,7 @@ var f = (e) => {
 		15e3,
 		6e4
 	]
-}, E = (e, t) => e ? t > 0 ? "degraded" : "connected" : "offline", D = {
+}, D = (e, t) => e ? t > 0 ? "degraded" : "connected" : "offline", O = {
 	read: () => typeof navigator > "u" || navigator.onLine,
 	subscribe: (e) => {
 		if (typeof window > "u") return () => {};
@@ -188,7 +188,7 @@ var f = (e) => {
 			window.removeEventListener("online", t), window.removeEventListener("offline", n);
 		};
 	}
-}, O = (e) => {
+}, k = (e) => {
 	let t = (e) => typeof e.isInternetReachable == "boolean" ? e.isInternetReachable : e.isConnected === !0, n = !0;
 	return {
 		read: () => n,
@@ -201,8 +201,8 @@ var f = (e) => {
 			}).catch(() => {}), i;
 		}
 	};
-}, k = (e) => {
-	let t = e?.onlineSource ?? D, [n, r] = l(() => t.read()), [i, s] = l(0), [u, d] = l(void 0), f = c(!0);
+}, A = (e) => {
+	let t = e?.onlineSource ?? O, [n, r] = l(() => t.read()), [i, s] = l(0), [u, d] = l(void 0), f = c(!0);
 	o(() => (f.current = !0, () => {
 		f.current = !1;
 	}), []), o(() => t.subscribe((e) => {
@@ -214,14 +214,14 @@ var f = (e) => {
 		f.current && s(0);
 	}, []);
 	return {
-		status: E(n, i),
+		status: D(n, i),
 		online: n,
 		failureCount: i,
 		lastFailureAt: u,
 		reportFailure: p,
 		reportSuccess: m
 	};
-}, A = (e) => {
+}, j = (e) => {
 	let { storage: t, keys: n } = e, r = e.onError ?? ((e, t) => {
 		console.warn(`[voltro] persisting '${e}' failed`, t);
 	}), i = /* @__PURE__ */ new Map(), a = !1, o = null, s = /* @__PURE__ */ new Map(), c = null, l = async () => {
@@ -280,38 +280,41 @@ var f = (e) => {
 		},
 		keys: () => [...i.keys()]
 	};
-}, j = (e, t) => {
+}, M = (e, t) => {
 	let n = globalThis.WebSocket;
 	if (n === void 0) throw Error("startMobileApis: no global WebSocket. React Native provides one; if you are running these bindings somewhere else, pass `webSocketConstructor`.");
 	return t === void 0 ? new n(e) : new n(e, t);
-}, M = (e, t, n) => (r, i) => {
+}, N = (e, t, n) => (r, i) => {
 	let a = e(r, i);
 	return a.addEventListener("open", () => t()), a.addEventListener("close", () => n("close")), a.addEventListener("error", () => n("error")), a;
-}, N = (e) => {
-	let t = e.webSocketConstructor ?? j;
-	return d({
+}, P = (e) => {
+	let t = e.webSocketConstructor ?? M;
+	return f({
 		apis: e.apis.map((e) => ({
 			name: e.name,
 			group: e.group,
 			descriptors: e.descriptors,
 			wsUrl: e.wsUrl,
-			...e.headers === void 0 ? {} : { headers: e.headers }
+			...e.headers === void 0 ? {} : { headers: e.headers },
+			...e.recovery === void 0 ? {} : { recovery: e.recovery }
 		})),
 		...e.retryDelayMs === void 0 ? {} : { retryDelayMs: e.retryDelayMs },
 		onChange: e.onChange,
-		buildClient: async (e, n, r, i, a) => await u({
+		buildClient: async (e, n, r, i, a, o) => await u({
 			name: e.name,
+			generation: n,
 			wsUrl: e.wsUrl,
 			group: e.group,
 			...e.headers === void 0 ? {} : { headers: e.headers },
 			...a === void 0 ? {} : { errorBus: a },
-			webSocketConstructor: M(t, r, i)
+			...o === void 0 ? {} : { recovery: o },
+			webSocketConstructor: N(t, r, i)
 		})
 	});
-}, P = (e, t, n = "/ws") => {
+}, F = (e, t, n = "/ws") => {
 	let r = (e ?? "").split(":")[0];
 	return r === void 0 || r === "" || r === "localhost" || r === "127.0.0.1" ? `ws://localhost:${t}${n}` : `ws://${r}:${t}${n}`;
-}, F = (e, t) => {
+}, I = (e, t) => {
 	let n = /* @__PURE__ */ new Map();
 	for (let r of e) {
 		let e = t.get(r.name);
@@ -321,10 +324,11 @@ var f = (e) => {
 			client: e.client,
 			descriptors: r.descriptors,
 			inspectBaseUrl: r.wsUrl.replace(/^ws/, "http").replace(/\/ws$/, ""),
-			errorBus: e.errorBus
+			errorBus: e.errorBus,
+			recovery: e.recovery ?? d(e.errorBus, r.name, r.recovery)
 		});
 	}
 	return n;
 };
 //#endregion
-export { i as DEVICES_TABLE, n as DEVICE_PLATFORMS, b as backgroundSyncReducer, D as browserOnlineSource, A as createAsyncStoragePersistence, g as deepLinkHref, j as defaultWebSocketConstructor, f as defineDeepLink, E as deriveConnectionStatus, v as dispatchDeepLink, y as initialBackgroundSyncState, r as isDevicePlatform, m as matchDeepLink, _ as matchFirstDeepLink, O as netInfoOnlineSource, T as offlineFirstDefaults, t as registerDevice, P as resolveDevWsUrl, e as resolveDeviceRegistration, h as runDeepLink, x as shouldSync, N as startMobileApis, F as toApiHandles, w as useBackgroundSync, k as useMobileConnectionStatus, M as wireSocket };
+export { i as DEVICES_TABLE, n as DEVICE_PLATFORMS, x as backgroundSyncReducer, O as browserOnlineSource, j as createAsyncStoragePersistence, _ as deepLinkHref, M as defaultWebSocketConstructor, p as defineDeepLink, D as deriveConnectionStatus, y as dispatchDeepLink, b as initialBackgroundSyncState, r as isDevicePlatform, h as matchDeepLink, v as matchFirstDeepLink, k as netInfoOnlineSource, E as offlineFirstDefaults, t as registerDevice, F as resolveDevWsUrl, e as resolveDeviceRegistration, g as runDeepLink, S as shouldSync, P as startMobileApis, I as toApiHandles, T as useBackgroundSync, A as useMobileConnectionStatus, N as wireSocket };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/react-native",
-  "version": "0.62.3",
+  "version": "0.63.0",
   "description": "React Native bindings for the framework: device-registration primitive, background-sync state machine, offline-first client defaults + connection-status surface, and the deep-link declaration shape — the credential-free mobile plumbing on top of the RN-safe React client.",
   "keywords": [
     "voltro",
@@ -38,8 +38,8 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/client": "0.62.3",
-    "@voltro/database": "0.62.3"
+    "@voltro/client": "0.63.0",
+    "@voltro/database": "0.63.0"
   },
   "peerDependencies": {
     "react": "^19.0.0"