@syncular/client 0.15.37 → 0.15.38

package/dist/realtime-supervisor.d.ts

@@ -53,6 +53,12 @@ export interface DocumentLifecycleSignalOptions {
         readonly visibilityState?: string;
     };
 }
+/**
+ * Preserve supervisor observation across a facade without transferring
+ * transport ownership or exposing the source client. Binding packages use
+ * this when they normalize a client into another object identity.
+ */
+export declare function linkRealtimeSupervisorObservation<Target extends object>(target: Target, source: object): Target;
 /** Browser/Tauri-webview connectivity evidence without importing DOM types. */
 export declare function browserConnectivitySignal(options?: BrowserConnectivitySignalOptions): RealtimeSupervisorSignal<ClientDiagnosticsConnectivity>;
 /** Browser/Tauri-webview visibility evidence without importing DOM types. */

package/dist/realtime-supervisor.js

@@ -6,11 +6,27 @@ const UNSUPPORTED_SNAPSHOT = Object.freeze({
     phase: 'unsupported',
     attempt: 0,
 });
-function attachment(client) {
+const observationSources = new WeakMap();
+function attachment(client, visited = new Set()) {
+    if (visited.has(client))
+        return undefined;
+    visited.add(client);
     const candidate = Reflect.get(client, REALTIME_SUPERVISOR_KEY);
-    return candidate?.version === 1 && candidate.supervisor
-        ? candidate
-        : undefined;
+    if (candidate?.version === 1 && candidate.supervisor) {
+        return candidate;
+    }
+    const source = observationSources.get(client);
+    return source === undefined ? undefined : attachment(source, visited);
+}
+/**
+ * Preserve supervisor observation across a facade without transferring
+ * transport ownership or exposing the source client. Binding packages use
+ * this when they normalize a client into another object identity.
+ */
+export function linkRealtimeSupervisorObservation(target, source) {
+    if (target !== source)
+        observationSources.set(target, source);
+    return target;
 }
 function scheduleTimer(callback, delayMs) {
     const timer = globalThis.setTimeout(callback, delayMs);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/client",
-  "version": "0.15.37",
+  "version": "0.15.38",
   "description": "Syncular TypeScript client core — offline-first sync over SQLite (WASM/OPFS, Bun, Node)",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -81,7 +81,7 @@
   },
   "dependencies": {
     "@sqlite.org/sqlite-wasm": "^3.53.0-build1",
-    "@syncular/core": "0.15.37"
+    "@syncular/core": "0.15.38"
   },
   "peerDependencies": {
     "better-sqlite3": ">=11"
@@ -92,7 +92,7 @@
     }
   },
   "devDependencies": {
-    "@syncular/server": "0.15.37",
+    "@syncular/server": "0.15.38",
     "@types/better-sqlite3": "^7.6.13",
     "better-sqlite3": "^12.11.1"
   }

package/src/realtime-supervisor.ts

@@ -90,13 +90,35 @@ interface RealtimeSupervisorAttachment {
   readonly supervisor: RealtimeSupervisor;
 }
 
-function attachment(client: object): RealtimeSupervisorAttachment | undefined {
+const observationSources = new WeakMap<object, object>();
+
+function attachment(
+  client: object,
+  visited: Set<object> = new Set(),
+): RealtimeSupervisorAttachment | undefined {
+  if (visited.has(client)) return undefined;
+  visited.add(client);
   const candidate = Reflect.get(client, REALTIME_SUPERVISOR_KEY) as
     | Partial<RealtimeSupervisorAttachment>
     | undefined;
-  return candidate?.version === 1 && candidate.supervisor
-    ? (candidate as RealtimeSupervisorAttachment)
-    : undefined;
+  if (candidate?.version === 1 && candidate.supervisor) {
+    return candidate as RealtimeSupervisorAttachment;
+  }
+  const source = observationSources.get(client);
+  return source === undefined ? undefined : attachment(source, visited);
+}
+
+/**
+ * Preserve supervisor observation across a facade without transferring
+ * transport ownership or exposing the source client. Binding packages use
+ * this when they normalize a client into another object identity.
+ */
+export function linkRealtimeSupervisorObservation<Target extends object>(
+  target: Target,
+  source: object,
+): Target {
+  if (target !== source) observationSources.set(target, source);
+  return target;
 }
 
 function scheduleTimer(callback: () => void, delayMs: number): CancelTimer {