@syncular/client 0.15.38 → 0.15.40

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>;
@@ -53,12 +54,6 @@ 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. */
@@ -81,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,7 +8,6 @@ const UNSUPPORTED_SNAPSHOT = Object.freeze({
     phase: 'unsupported',
     attempt: 0,
 });
-const observationSources = new WeakMap();
 function attachment(client, visited = new Set()) {
     if (visited.has(client))
         return undefined;
@@ -15,19 +16,9 @@ function attachment(client, visited = new Set()) {
     if (candidate?.version === 1 && candidate.supervisor) {
         return candidate;
     }
-    const source = observationSources.get(client);
+    const source = realtimeSupervisorObservationSource(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);
     return () => globalThis.clearTimeout(timer);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/client",
-  "version": "0.15.38",
+  "version": "0.15.40",
   "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.38"
+    "@syncular/core": "0.15.40"
   },
   "peerDependencies": {
     "better-sqlite3": ">=11"
@@ -92,7 +100,7 @@
     }
   },
   "devDependencies": {
-    "@syncular/server": "0.15.38",
+    "@syncular/server": "0.15.40",
     "@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,8 +93,6 @@ interface RealtimeSupervisorAttachment {
   readonly supervisor: RealtimeSupervisor;
 }
 
-const observationSources = new WeakMap<object, object>();
-
 function attachment(
   client: object,
   visited: Set<object> = new Set(),
@@ -104,23 +105,10 @@ function attachment(
   if (candidate?.version === 1 && candidate.supervisor) {
     return candidate as RealtimeSupervisorAttachment;
   }
-  const source = observationSources.get(client);
+  const source = realtimeSupervisorObservationSource(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 {
   const timer = globalThis.setTimeout(callback, delayMs);
   return () => globalThis.clearTimeout(timer);