@syncular/client 0.15.37 → 0.15.39

package/dist/realtime-supervisor-observation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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;
+/** @internal Resolve one facade hop for the supervisor attachment lookup. */
+export declare function realtimeSupervisorObservationSource(target: object): object | undefined;

package/dist/realtime-supervisor-observation.js

@@ -0,0 +1,15 @@
+const observationSources = new WeakMap();
+/**
+ * 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;
+}
+/** @internal Resolve one facade hop for the supervisor attachment lookup. */
+export function realtimeSupervisorObservationSource(target) {
+    return observationSources.get(target);
+}

package/dist/realtime-supervisor.d.ts

@@ -1,5 +1,6 @@
 import type { SecurityLifecycle } from './client.js';
 import type { ClientDiagnosticsConnectivity, ClientDiagnosticsListener, ClientDiagnosticsSnapshot } from './diagnostics.js';
+export { linkRealtimeSupervisorObservation } from './realtime-supervisor-observation.js';
 type CancelTimer = () => void;
 export interface RealtimeSupervisorClient {
     connectRealtime(): Promise<void>;
@@ -75,4 +76,3 @@ export declare class RealtimeSupervisor {
 export declare function installRealtimeSupervisor<T extends RealtimeSupervisorClient>(client: T, options?: RealtimeSupervisorOptions): T;
 export declare function realtimeSupervisorSnapshot(client: object): RealtimeSupervisorSnapshot;
 export declare function subscribeRealtimeSupervisor(client: object, listener: () => void): () => void;
-export {};

package/dist/realtime-supervisor.js

@@ -1,3 +1,5 @@
+import { realtimeSupervisorObservationSource } from './realtime-supervisor-observation.js';
+export { linkRealtimeSupervisorObservation } from './realtime-supervisor-observation.js';
 const REALTIME_SUPERVISOR_KEY = Symbol.for('syncular.realtime-supervisor.v1');
 const DEFAULT_INITIAL_DELAY_MS = 1_000;
 const DEFAULT_MAXIMUM_DELAY_MS = 30_000;
@@ -6,11 +8,16 @@ const UNSUPPORTED_SNAPSHOT = Object.freeze({
     phase: 'unsupported',
     attempt: 0,
 });
-function attachment(client) {
+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 = realtimeSupervisorObservationSource(client);
+    return source === undefined ? undefined : attachment(source, visited);
 }
 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.39",
   "description": "Syncular TypeScript client core — offline-first sync over SQLite (WASM/OPFS, Bun, Node)",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -34,6 +34,14 @@
         "default": "./dist/index.js"
       }
     },
+    "./realtime-supervisor-observation": {
+      "bun": "./src/realtime-supervisor-observation.ts",
+      "browser": "./dist/realtime-supervisor-observation.js",
+      "import": {
+        "types": "./dist/realtime-supervisor-observation.d.ts",
+        "default": "./dist/realtime-supervisor-observation.js"
+      }
+    },
     "./bun": {
       "bun": "./src/bun-database.ts",
       "browser": "./dist/bun-database.js",
@@ -81,7 +89,7 @@
   },
   "dependencies": {
     "@sqlite.org/sqlite-wasm": "^3.53.0-build1",
-    "@syncular/core": "0.15.37"
+    "@syncular/core": "0.15.39"
   },
   "peerDependencies": {
     "better-sqlite3": ">=11"
@@ -92,7 +100,7 @@
     }
   },
   "devDependencies": {
-    "@syncular/server": "0.15.37",
+    "@syncular/server": "0.15.39",
     "@types/better-sqlite3": "^7.6.13",
     "better-sqlite3": "^12.11.1"
   }

package/src/realtime-supervisor-observation.ts

@@ -0,0 +1,21 @@
+const observationSources = new WeakMap<object, object>();
+
+/**
+ * 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;
+}
+
+/** @internal Resolve one facade hop for the supervisor attachment lookup. */
+export function realtimeSupervisorObservationSource(
+  target: object,
+): object | undefined {
+  return observationSources.get(target);
+}

package/src/realtime-supervisor.ts

@@ -4,6 +4,9 @@ import type {
   ClientDiagnosticsListener,
   ClientDiagnosticsSnapshot,
 } from './diagnostics';
+import { realtimeSupervisorObservationSource } from './realtime-supervisor-observation';
+
+export { linkRealtimeSupervisorObservation } from './realtime-supervisor-observation';
 
 type CancelTimer = () => void;
 
@@ -90,13 +93,20 @@ interface RealtimeSupervisorAttachment {
   readonly supervisor: RealtimeSupervisor;
 }
 
-function attachment(client: object): RealtimeSupervisorAttachment | undefined {
+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 = realtimeSupervisorObservationSource(client);
+  return source === undefined ? undefined : attachment(source, visited);
 }
 
 function scheduleTimer(callback: () => void, delayMs: number): CancelTimer {