@syncular/react 0.15.37 → 0.15.38

package/README.md

@@ -252,7 +252,11 @@ not need a custom retention effect.
   `useSyncClient().resolveCommitOutcome(...)`.
 - `usePresence(scopeKey)` observes ephemeral realtime peers.
 - `useSyncClient()` and `useReactiveStore()` expose the normalized low-level
-  surfaces for integrations.
+  surfaces for integrations. When the concrete client was passed through
+  `installRealtimeSupervisor()` before mounting `SyncProvider`, its normalized
+  `useSyncClient()` facade preserves supervisor observation: pass it directly
+  to `realtimeSupervisorSnapshot()` and `subscribeRealtimeSupervisor()`.
+  Transport ownership and disposal remain on the concrete client/resource.
 
 The hooks are SSR-safe: no local query runs during server rendering.
 

package/dist/client.js

@@ -1,3 +1,17 @@
+/**
+ * The ONE client interface the React bindings target. Both the direct
+ * `SyncClient` (constructed on the current thread) and the worker-mode
+ * `SyncClientHandle` (a promise proxy over the OPFS worker) satisfy it —
+ * their public surfaces diverge (getters vs methods, sync vs promise), so
+ * this module normalizes both into a single async-friendly facade the hooks
+ * consume. That is the "one interface across direct and worker-handle modes"
+ * the invalidation seam (TODO 3.1) was standardized to enable.
+ *
+ * The normalizer resolves each accessor at call time (function → call it,
+ * value → read it) and wraps every result in `Promise.resolve`, so a hook
+ * never has to care which core it holds.
+ */
+import { linkRealtimeSupervisorObservation } from '@syncular/client';
 /**
  * Read a member by key that is EITHER a value getter (SyncClient) or a
  * method returning a value/promise (SyncClientHandle). Read from the client
@@ -11,7 +25,7 @@ function resolveMember(client, key) {
     return Promise.resolve(value);
 }
 export function normalizeClient(client) {
-    return {
+    const normalized = {
         ...(client.currentSchemaVersion !== undefined
             ? { currentSchemaVersion: client.currentSchemaVersion }
             : {}),
@@ -47,4 +61,5 @@ export function normalizeClient(client) {
         setWindow: (base, units) => Promise.resolve(client.setWindow(base, units)),
         windowState: (base) => Promise.resolve(client.windowState(base)),
     };
+    return linkRealtimeSupervisorObservation(normalized, client);
 }

package/dist/runtime-version.d.ts

@@ -3,4 +3,4 @@
  * Vite HMR uses it to replace a worker owner after a Syncular package upgrade
  * even when the application's generated schema version did not change.
  */
-export declare const SYNCULAR_REACT_RUNTIME_VERSION = "0.15.37";
+export declare const SYNCULAR_REACT_RUNTIME_VERSION = "0.15.38";

package/dist/runtime-version.js

@@ -3,4 +3,4 @@
  * Vite HMR uses it to replace a worker owner after a Syncular package upgrade
  * even when the application's generated schema version did not change.
  */
-export const SYNCULAR_REACT_RUNTIME_VERSION = '0.15.37';
+export const SYNCULAR_REACT_RUNTIME_VERSION = '0.15.38';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/react",
-  "version": "0.15.37",
+  "version": "0.15.38",
   "description": "React hooks for Syncular offline-first sync",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -55,15 +55,15 @@
     "test": "bun test --preload ./test/setup.ts"
   },
   "dependencies": {
-    "@syncular/client": "0.15.37"
+    "@syncular/client": "0.15.38"
   },
   "peerDependencies": {
     "react": ">=18.0.0"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.0.0",
-    "@syncular/core": "0.15.37",
-    "@syncular/server": "0.15.37",
+    "@syncular/core": "0.15.38",
+    "@syncular/server": "0.15.38",
     "@testing-library/react": "^16.1.0",
     "@types/react": "^18.3.0",
     "react": "^18.3.1",

package/src/client.ts

@@ -11,6 +11,7 @@
  * value → read it) and wraps every result in `Promise.resolve`, so a hook
  * never has to care which core it holds.
  */
+
 import type {
   ClientChangeListener,
   ClientDiagnosticsListener,
@@ -40,6 +41,7 @@ import type {
   WindowBase,
   WindowState,
 } from '@syncular/client';
+import { linkRealtimeSupervisorObservation } from '@syncular/client';
 
 /**
  * The structural union of `SyncClient` and `SyncClientHandle`. Members that
@@ -193,7 +195,7 @@ export interface NormalizedClient {
 }
 
 export function normalizeClient(client: SyncClientLike): NormalizedClient {
-  return {
+  const normalized: NormalizedClient = {
     ...(client.currentSchemaVersion !== undefined
       ? { currentSchemaVersion: client.currentSchemaVersion }
       : {}),
@@ -237,4 +239,5 @@ export function normalizeClient(client: SyncClientLike): NormalizedClient {
     setWindow: (base, units) => Promise.resolve(client.setWindow(base, units)),
     windowState: (base) => Promise.resolve(client.windowState(base)),
   };
+  return linkRealtimeSupervisorObservation(normalized, client);
 }

package/src/runtime-version.ts

@@ -3,4 +3,4 @@
  * Vite HMR uses it to replace a worker owner after a Syncular package upgrade
  * even when the application's generated schema version did not change.
  */
-export const SYNCULAR_REACT_RUNTIME_VERSION = '0.15.37';
+export const SYNCULAR_REACT_RUNTIME_VERSION = '0.15.38';