@voltro/react-native 0.81.0 → 0.82.0

package/dist/index.js

@@ -1,71 +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, recoveryCoordinatorFor as d, startApiSupervisor as f } from "@voltro/client";
-//#region src/deepLink.ts
-var p = (e) => {
-	let t = e.pattern;
-	if (t.length === 0 || t[0] !== "/") throw Error(`defineDeepLink: pattern must start with "/" (got "${t}")`);
-	return {
-		_tag: "VoltroDeepLink",
-		pattern: t,
-		handler: e.handler
-	};
-}, 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();
-		if (r === "http" || r === "https") {
-			let n = e.indexOf("/");
-			t = n === -1 ? "/" : e.slice(n);
-		} else t = `/${e}`;
-	}
-	let r = t.search(/[?#]/);
-	return r !== -1 && (t = t.slice(0, r)), t.split("/").filter((e) => e.length > 0).map((e) => {
-		try {
-			return decodeURIComponent(e);
-		} catch {
-			return e;
-		}
-	});
-}, 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++) {
-		let t = n[e], a = r[e];
-		if (t.startsWith(":")) {
-			let e = t.slice(1);
-			if (e.length === 0) return null;
-			i[e] = a;
-		} else if (t !== "*" && t !== a) return null;
-	}
-	return i;
-}, 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];
-		if (i === void 0) throw Error(`deepLinkHref: pattern "${e}" needs a ":${r}" param`);
-		return encodeURIComponent(i);
-	}).join("/");
-	return n.length === 0 ? "/" : n;
-}, v = (e, t) => {
-	for (let n of e) {
-		let e = h(n.pattern, t);
-		if (e !== null) return {
-			descriptor: n,
-			params: e
-		};
-	}
-	return null;
-}, y = (e, t) => {
-	let n = v(e, t);
-	if (n === null) return null;
-	let r = n.descriptor.handler;
-	return r(n.params), n.params;
-}, b = {
+import { browserOnlineSource as a, browserOnlineSource as o, buildApiRuntime as s, deepLinkHref as c, defineDeepLink as l, definePlatform as u, dispatchDeepLink as d, matchDeepLink as f, matchFirstDeepLink as p, recoveryCoordinatorFor as m, runDeepLink as h, startApiSupervisor as g } from "@voltro/client";
+import { useCallback as _, useEffect as v, useReducer as y, useRef as b, useState as x } from "react";
+//#region src/backgroundSync.ts
+var S = {
 	status: "idle",
 	isForeground: !0,
 	lastSyncAt: void 0,
@@ -73,7 +10,7 @@ var p = (e) => {
 	lastError: void 0,
 	successCount: 0,
 	failureCount: 0
-}, x = (e, t) => {
+}, C = (e, t) => {
 	switch (t.type) {
 		case "foreground": return e.isForeground ? e : {
 			...e,
@@ -104,11 +41,11 @@ var p = (e) => {
 			failureCount: e.failureCount + 1
 		};
 		case "reset": return {
-			...b,
+			...S,
 			isForeground: e.isForeground
 		};
 	}
-}, 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) => {
+}, w = (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), T = (e, t) => {
 	if (typeof document > "u" || typeof window > "u") return () => {};
 	let n = () => {
 		document.visibilityState === "visible" ? e() : t();
@@ -116,58 +53,58 @@ var p = (e) => {
 	return document.addEventListener("visibilitychange", n), window.addEventListener("focus", e), () => {
 		document.removeEventListener("visibilitychange", n), window.removeEventListener("focus", 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) => {
-		S(m.current, l(), {
+}, E = 3e5, D = (e, t = {}) => {
+	let n = t.intervalMs ?? E, r = t.syncOnForeground ?? !0, i = t.enabled ?? !0, a = t.now ?? Date.now, o = t.subscribeForeground ?? T, [s, c] = y(C, S), l = b(e);
+	l.current = e;
+	let u = b(s);
+	u.current = s;
+	let d = b(!0), f = _((e) => {
+		w(u.current, a(), {
 			intervalMs: n,
 			enabled: i
-		}, e) && (f({
+		}, e) && (c({
 			type: "syncStarted",
-			at: l()
-		}), Promise.resolve().then(() => p.current()).then(() => {
-			h.current && f({
+			at: a()
+		}), Promise.resolve().then(() => l.current()).then(() => {
+			d.current && c({
 				type: "syncSucceeded",
-				at: l()
+				at: a()
 			});
 		}).catch((e) => {
-			h.current && f({
+			d.current && c({
 				type: "syncFailed",
-				at: l(),
+				at: a(),
 				error: e instanceof Error ? e.message : String(e)
 			});
 		}));
 	}, [
 		i,
 		n,
-		l
+		a
 	]);
-	o(() => (h.current = !0, () => {
-		h.current = !1;
-	}), []), o(() => u(() => {
-		f({ type: "foreground" }), r && g(!0);
-	}, () => f({ type: "background" })), [
-		u,
+	v(() => (d.current = !0, () => {
+		d.current = !1;
+	}), []), v(() => o(() => {
+		c({ type: "foreground" }), r && f(!0);
+	}, () => c({ type: "background" })), [
+		o,
 		r,
-		g
-	]), o(() => {
+		f
+	]), v(() => {
 		if (!i || n <= 0) return;
-		let e = setInterval(() => g(!1), n);
+		let e = setInterval(() => f(!1), n);
 		return () => clearInterval(e);
 	}, [
 		i,
 		n,
-		g
+		f
 	]);
-	let _ = a(() => g(!0), [g]);
+	let p = _(() => f(!0), [f]);
 	return {
-		...d,
-		sync: _
+		...s,
+		sync: p
 	};
-}, E = {
+}, O = {
 	localFirst: !0,
 	optimistic: !0,
 	syncOnForeground: !0,
@@ -179,16 +116,7 @@ var p = (e) => {
 		15e3,
 		6e4
 	]
-}, D = (e, t) => e ? t > 0 ? "degraded" : "connected" : "offline", O = {
-	read: () => typeof navigator > "u" || navigator.onLine,
-	subscribe: (e) => {
-		if (typeof window > "u") return () => {};
-		let t = () => e(!0), n = () => e(!1);
-		return window.addEventListener("online", t), window.addEventListener("offline", n), () => {
-			window.removeEventListener("online", t), window.removeEventListener("offline", n);
-		};
-	}
-}, k = (e) => {
+}, k = (e, t) => e ? t > 0 ? "degraded" : "connected" : "offline", A = (e) => {
 	let t = (e) => typeof e.isInternetReachable == "boolean" ? e.isInternetReachable : e.isConnected === !0, n = !0;
 	return {
 		read: () => n,
@@ -201,27 +129,27 @@ var p = (e) => {
 			}).catch(() => {}), i;
 		}
 	};
-}, 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) => {
-		r(e), e && s(0);
+}, j = (e) => {
+	let t = e?.onlineSource ?? o, [n, r] = x(() => t.read()), [i, a] = x(0), [s, c] = x(void 0), l = b(!0);
+	v(() => (l.current = !0, () => {
+		l.current = !1;
+	}), []), v(() => t.subscribe((e) => {
+		r(e), e && a(0);
 	}), [t]);
-	let p = a(() => {
-		f.current && (s((e) => e + 1), d(Date.now()));
-	}, []), m = a(() => {
-		f.current && s(0);
+	let u = _(() => {
+		l.current && (a((e) => e + 1), c(Date.now()));
+	}, []), d = _(() => {
+		l.current && a(0);
 	}, []);
 	return {
-		status: D(n, i),
+		status: k(n, i),
 		online: n,
 		failureCount: i,
-		lastFailureAt: u,
-		reportFailure: p,
-		reportSuccess: m
+		lastFailureAt: s,
+		reportFailure: u,
+		reportSuccess: d
 	};
-}, j = (e) => {
+}, M = (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,16 +208,16 @@ var p = (e) => {
 		},
 		keys: () => [...i.keys()]
 	};
-}, M = (e, t) => {
+}, N = (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);
-}, N = (e, t, n) => (r, i) => {
+}, P = (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;
-}, P = (e) => {
-	let t = e.webSocketConstructor ?? M;
-	return f({
+}, F = (e) => {
+	let t = e.webSocketConstructor ?? N;
+	return g({
 		apis: e.apis.map((e) => ({
 			name: e.name,
 			group: e.group,
@@ -300,7 +228,7 @@ var p = (e) => {
 		})),
 		...e.retryDelayMs === void 0 ? {} : { retryDelayMs: e.retryDelayMs },
 		onChange: e.onChange,
-		buildClient: async (e, n, r, i, a, o) => await u({
+		buildClient: async (e, n, r, i, a, o) => await s({
 			name: e.name,
 			generation: n,
 			wsUrl: e.wsUrl,
@@ -308,13 +236,13 @@ var p = (e) => {
 			...e.headers === void 0 ? {} : { headers: e.headers },
 			...a === void 0 ? {} : { errorBus: a },
 			...o === void 0 ? {} : { recovery: o },
-			webSocketConstructor: N(t, r, i)
+			webSocketConstructor: P(t, r, i)
 		})
 	});
-}, F = (e, t, n = "/ws") => {
+}, I = (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}`;
-}, I = (e, t) => {
+}, L = (e, t) => {
 	let n = /* @__PURE__ */ new Map();
 	for (let r of e) {
 		let e = t.get(r.name);
@@ -325,10 +253,164 @@ var p = (e) => {
 			descriptors: r.descriptors,
 			inspectBaseUrl: r.wsUrl.replace(/^ws/, "http").replace(/\/ws$/, ""),
 			errorBus: e.errorBus,
-			recovery: e.recovery ?? d(e.errorBus, r.name, r.recovery)
+			recovery: e.recovery ?? m(e.errorBus, r.name, r.recovery)
 		});
 	}
 	return n;
+}, R = (e) => e === "ios" ? "ios" : e === "android" ? "android" : e === "web" ? "web" : "unknown", z = (e) => e === "active" ? "active" : e === "background" ? "background" : "inactive", B = (e) => e === "granted" ? "granted" : e === "denied" ? "denied" : "prompt", V = (e) => ({
+	kind: "keychain",
+	get: (t) => e.getItemAsync(t),
+	set: (t, n) => e.setItemAsync(t, n),
+	delete: (t) => e.deleteItemAsync(t)
+}), H = (e) => ({
+	read: () => z(e.currentState),
+	subscribe: (t) => {
+		let n = e.addEventListener("change", (e) => t(z(e)));
+		return () => n.remove();
+	}
+}), U = (e) => ({
+	initialUrl: () => e.getInitialURL(),
+	subscribe: (t) => {
+		let n = e.addEventListener("url", ({ url: e }) => t(e));
+		return () => n.remove();
+	}
+}), W = (e, t) => ({
+	permission: async () => B((await e.getPermissionsAsync()).status),
+	requestPermission: async () => B((await e.requestPermissionsAsync()).status),
+	...e.getExpoPushTokenAsync === void 0 ? {} : { pushToken: async () => (await e.getExpoPushTokenAsync(t === void 0 ? void 0 : { projectId: t })).data },
+	...e.scheduleNotificationAsync === void 0 ? {} : { show: async (t) => {
+		await e.scheduleNotificationAsync({
+			content: {
+				title: t.title,
+				...t.body === void 0 ? {} : { body: t.body },
+				...t.data === void 0 ? {} : { data: { ...t.data } }
+			},
+			trigger: null
+		});
+	} }
+}), G = (e) => ({
+	check: async () => {
+		let t = await e.checkForUpdateAsync();
+		return t.isAvailable ? { version: t.manifest?.id ?? "available" } : null;
+	},
+	apply: async () => {
+		await e.fetchUpdateAsync(), await e.reloadAsync();
+	}
+}), K = (e) => ({
+	available: async () => await e.hasHardwareAsync() && await e.isEnrolledAsync(),
+	authenticate: async (t) => (await e.authenticateAsync({ promptMessage: t })).success
+}), q = async (e) => {
+	let t = M({
+		storage: e.storage,
+		...e.persistedKeys === void 0 ? {} : { keys: e.persistedKeys }
+	});
+	return await t.hydrate(), {
+		adapter: u({
+			platform: {
+				kind: R(e.os),
+				shell: "expo",
+				installed: !0,
+				...e.appVersion === void 0 ? {} : { appVersion: e.appVersion },
+				...e.updates?.updateId ? { buildId: e.updates.updateId } : {}
+			},
+			webSocket: e.webSocket ?? N,
+			storage: t.provider,
+			secureStorage: V(e.secureStore),
+			online: A(e.netInfo),
+			lifecycle: H(e.appState),
+			links: U(e.linking),
+			...e.notifications === void 0 ? {} : { notifications: W(e.notifications, e.expoProjectId) },
+			...e.updates === void 0 ? {} : { updates: G(e.updates) },
+			...e.localAuthentication === void 0 ? {} : { biometrics: K(e.localAuthentication) },
+			clock: { now: () => Date.now() },
+			...e.extensions === void 0 ? {} : { extensions: e.extensions },
+			...e.capabilities === void 0 ? {} : { capabilities: e.capabilities }
+		}),
+		persistence: t
+	};
+}, J = "\nCREATE TABLE IF NOT EXISTS voltro_crdt (key TEXT PRIMARY KEY NOT NULL, state BLOB NOT NULL);\nCREATE TABLE IF NOT EXISTS voltro_queue (id INTEGER PRIMARY KEY CHECK (id = 1), json TEXT NOT NULL);\nCREATE TABLE IF NOT EXISTS voltro_pins (key TEXT PRIMARY KEY NOT NULL);\nCREATE TABLE IF NOT EXISTS voltro_kv (key TEXT PRIMARY KEY NOT NULL, json TEXT NOT NULL);\n", Y = (e, t) => `${e}\u0001${t}`, X = (e) => {
+	if (e instanceof Uint8Array) return new Uint8Array(e);
+	if (ArrayBuffer.isView(e)) return new Uint8Array(e.buffer, e.byteOffset, e.byteLength).slice();
+	if (e instanceof ArrayBuffer) return new Uint8Array(e.slice(0));
+	throw Error("expo-sqlite persistence: CRDT state column is not a BLOB");
+}, Z = (e) => `${e.replace(/[\\%_]/g, (e) => `\\${e}`)}%`, Q = async (e) => {
+	let t = async () => {
+		await e.execAsync(J);
+	};
+	return await t(), {
+		persistence: {
+			kind: "expo-sqlite",
+			loadCrdtState: async (t, n) => {
+				let r = await e.getFirstAsync("SELECT state FROM voltro_crdt WHERE key = ?", [Y(t, n)]);
+				return r === null ? void 0 : X(r.state);
+			},
+			saveCrdtState: async (t, n, r) => {
+				await e.runAsync("INSERT OR REPLACE INTO voltro_crdt (key, state) VALUES (?, ?)", [Y(t, n), new Uint8Array(r)]);
+			},
+			loadQueue: async () => {
+				let t = await e.getFirstAsync("SELECT json FROM voltro_queue WHERE id = 1");
+				if (t === null) return [];
+				try {
+					return JSON.parse(t.json);
+				} catch {
+					return [];
+				}
+			},
+			saveQueue: async (t) => {
+				await e.runAsync("INSERT OR REPLACE INTO voltro_queue (id, json) VALUES (1, ?)", [JSON.stringify(t)]);
+			},
+			pin: async (t, n) => {
+				await e.runAsync("INSERT OR IGNORE INTO voltro_pins (key) VALUES (?)", [Y(t, n)]);
+			},
+			isPinned: async (t, n) => await e.getFirstAsync("SELECT key FROM voltro_pins WHERE key = ?", [Y(t, n)]) !== null
+		},
+		kv: {
+			kind: "expo-sqlite",
+			get: async (t) => {
+				let n = await e.getFirstAsync("SELECT json FROM voltro_kv WHERE key = ?", [t]);
+				if (n !== null) try {
+					return JSON.parse(n.json);
+				} catch {
+					return;
+				}
+			},
+			put: async (t, n) => {
+				await e.runAsync("INSERT OR REPLACE INTO voltro_kv (key, json) VALUES (?, ?)", [t, JSON.stringify(n)]);
+			},
+			del: async (t) => {
+				await e.runAsync("DELETE FROM voltro_kv WHERE key = ?", [t]);
+			},
+			keysWithPrefix: async (t) => (await e.getAllAsync("SELECT key FROM voltro_kv WHERE key LIKE ? ESCAPE '\\'", [Z(t)])).map((e) => e.key)
+		},
+		migrate: t
+	};
+}, $ = "voltro-background-sync", ee = (e) => {
+	let t = e.name ?? "voltro-background-sync", n = e.backgroundFetch.BackgroundFetchResult, r = async () => {
+		try {
+			let t = await e.run() ?? "no-data";
+			return e.onOutcome?.(t), t;
+		} catch (t) {
+			return e.onOutcome?.("failed", t), "failed";
+		}
+	}, i = (e) => e === "new-data" ? n.NewData : e === "no-data" ? n.NoData : n.Failed;
+	return e.taskManager.defineTask(t, async ({ error: t }) => t ? (e.onOutcome?.("failed", t), n.Failed) : i(await r())), {
+		name: t,
+		register: async () => {
+			e.taskManager.isTaskRegisteredAsync && await e.taskManager.isTaskRegisteredAsync(t) || await e.backgroundFetch.registerTaskAsync(t, {
+				minimumInterval: e.minimumIntervalSeconds ?? 900,
+				stopOnTerminate: !(e.survivesTermination ?? !0),
+				startOnBoot: e.startOnBoot ?? !0
+			});
+		},
+		unregister: () => e.backgroundFetch.unregisterTaskAsync(t),
+		availability: async () => {
+			let t = e.backgroundFetch;
+			if (!t.getStatusAsync || !t.BackgroundFetchStatus) return "unknown";
+			let n = await t.getStatusAsync();
+			return n === t.BackgroundFetchStatus.Available ? "available" : n === t.BackgroundFetchStatus.Denied ? "denied" : n === t.BackgroundFetchStatus.Restricted ? "restricted" : "unknown";
+		},
+		runNow: r
+	};
 };
 //#endregion
-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 };
+export { $ as DEFAULT_BACKGROUND_SYNC_TASK, i as DEVICES_TABLE, n as DEVICE_PLATFORMS, H as appStateLifecycle, C as backgroundSyncReducer, a as browserOnlineSource, M as createAsyncStoragePersistence, q as createExpoPlatform, Q as createExpoSqliteLocalFirst, c as deepLinkHref, N as defaultWebSocketConstructor, ee as defineBackgroundSyncTask, l as defineDeepLink, k as deriveConnectionStatus, d as dispatchDeepLink, K as expoBiometrics, W as expoNotifications, V as expoSecureTokenStore, G as expoUpdates, S as initialBackgroundSyncState, r as isDevicePlatform, U as linkingDeepLinks, f as matchDeepLink, p as matchFirstDeepLink, A as netInfoOnlineSource, O as offlineFirstDefaults, t as registerDevice, I as resolveDevWsUrl, e as resolveDeviceRegistration, h as runDeepLink, w as shouldSync, F as startMobileApis, L as toApiHandles, D as useBackgroundSync, j as useMobileConnectionStatus, P as wireSocket };

package/dist/schema.d.ts

@@ -1,7 +1,14 @@
 import { ColumnBuilder } from '@voltro/database';
+import { DataStore } from '@voltro/database';
 import { FieldDefinitions } from '@voltro/database';
 import { Table } from '@voltro/database';
 
+/** `localeFor` for `sendNotification`: the most recently seen device's locale. */
+export declare const deviceLocaleFor: (store: DataStore) => (subjectId: string) => Promise<string | null>;
+
+/** The push transport a device is reachable on. */
+declare type DevicePlatform = 'ios' | 'android' | 'web';
+
 /** The framework table name devices are stored in — shared with `./schema`. */
 export declare const DEVICES_TABLE = "_voltro_devices";
 
@@ -19,4 +26,12 @@ export declare const devicesTable: Table<"_voltro_devices", FieldDefinitions<{
     readonly createdAt: ColumnBuilder<Date, "timestamp", true>;
 }>, true, "byDeviceUser" | "byDeviceTenant">;
 
+/** `tokensFor` for `pushChannel`: every registered token of a subject, newest
+ *  first. Optionally one platform (`'ios'`, `'android'`). */
+export declare const deviceTokensFor: (store: DataStore, platform?: DevicePlatform) => (subjectId: string) => Promise<ReadonlyArray<string>>;
+
+/** `onTokenRejected` for `pushChannel`: delete the device row a provider
+ *  reported gone, so the next fan-out does not retry it. */
+export declare const pruneDeviceToken: (store: DataStore) => (token: string) => Promise<void>;
+
 export { }

package/dist/schema.js

@@ -1,18 +1,21 @@
 import { t as e } from "./devices-BjXAU-8I.js";
-import { id as t, table as n, text as r, timestamp as i } from "@voltro/database";
+import { eq as t, id as n, queryFor as r, table as i, text as a, timestamp as o } from "@voltro/database";
 //#region src/schema.ts
-var a = n(e, {
-	id: t({ prefix: "device" }),
-	tenantId: r().nullable(),
-	userId: r(),
-	platform: r(),
-	token: r(),
-	locale: r().nullable(),
-	timezone: r().nullable(),
-	appVersion: r().nullable(),
-	metadata: r().nullable(),
-	lastSeenAt: i().default("now"),
-	createdAt: i().default("now")
-}).unique("byDeviceToken", ["platform", "token"]).index("byDeviceUser", ["userId"]).index("byDeviceTenant", ["tenantId"]);
+var s = i(e, {
+	id: n({ prefix: "device" }),
+	tenantId: a().nullable(),
+	userId: a(),
+	platform: a(),
+	token: a(),
+	locale: a().nullable(),
+	timezone: a().nullable(),
+	appVersion: a().nullable(),
+	metadata: a().nullable(),
+	lastSeenAt: o().default("now"),
+	createdAt: o().default("now")
+}).unique("byDeviceToken", ["platform", "token"]).index("byDeviceUser", ["userId"]).index("byDeviceTenant", ["tenantId"]), c = (e, n) => async (i) => (await e.query(r(s).where(t("userId", i)).descriptor)).filter((e) => n === void 0 || e.platform === n).sort((e, t) => t.lastSeenAt.getTime() - e.lastSeenAt.getTime()).map((e) => e.token), l = (n) => async (i) => {
+	let a = await n.query(r(s).where(t("token", i)).descriptor);
+	for (let t of a) await n.delete(e, t.id);
+}, u = (e) => async (n) => [...await e.query(r(s).where(t("userId", n)).descriptor)].sort((e, t) => t.lastSeenAt.getTime() - e.lastSeenAt.getTime())[0]?.locale ?? null;
 //#endregion
-export { e as DEVICES_TABLE, a as devicesTable };
+export { e as DEVICES_TABLE, u as deviceLocaleFor, c as deviceTokensFor, s as devicesTable, l as pruneDeviceToken };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/react-native",
-  "version": "0.81.0",
+  "version": "0.82.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,9 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/client": "0.81.0",
-    "@voltro/database": "0.81.0"
+    "@voltro/client": "0.82.0",
+    "@voltro/database": "0.82.0",
+    "@voltro/local-first": "0.82.0"
   },
   "peerDependencies": {
     "react": "^19.0.0"