@syncular/client 0.25.1 → 0.25.2

package/dist/reactive-store.js

@@ -240,6 +240,27 @@ class ObservationCache {
         this.#active.clear();
     }
 }
+const EMPTY_ROWS = Object.freeze([]);
+const unreadQuerySnapshots = new Map();
+/** One frozen snapshot per phase and availability for entries that have no
+ * successful read, so switching between unread entries keeps the snapshot and
+ * `rows` identity. */
+function unreadQuerySnapshot(phase, availability) {
+    const key = canonicalValue([phase, availability]);
+    let snapshot = unreadQuerySnapshots.get(key);
+    if (snapshot === undefined) {
+        snapshot = Object.freeze({
+            rows: EMPTY_ROWS,
+            phase,
+            revision: undefined,
+            error: undefined,
+            isRefreshing: false,
+            availability,
+        });
+        unreadQuerySnapshots.set(key, snapshot);
+    }
+    return snapshot;
+}
 class QueryEntry {
     store;
     spec;
@@ -247,14 +268,9 @@ class QueryEntry {
     cache;
     #owner = Symbol('query-window-claim');
     #listeners = new Set();
-    #state = {
-        rows: [],
-        phase: 'loading',
-        revision: undefined,
-        error: undefined,
-        isRefreshing: false,
-        availability: { state: 'ready' },
-    };
+    #state = unreadQuerySnapshot('loading', {
+        state: 'ready',
+    });
     #delegate;
     #generation = 0;
     #scheduled = false;
@@ -351,14 +367,7 @@ class QueryEntry {
         this.#desiredRevision = 0n;
         this.#claimError = undefined;
         this.#claimPending = false;
-        this.#state = {
-            rows: [],
-            phase: 'loading',
-            revision: undefined,
-            error: undefined,
-            isRefreshing: false,
-            availability: { state: 'ready' },
-        };
+        this.#state = unreadQuerySnapshot('loading', { state: 'ready' });
     }
     dispose() {
         this.#listeners.clear();
@@ -385,7 +394,13 @@ class QueryEntry {
                 canonicalValue(this.#state.availability)) {
             return;
         }
-        this.#state = next;
+        this.#state =
+            next.revision === undefined &&
+                next.rows.length === 0 &&
+                next.error === undefined &&
+                !next.isRefreshing
+                ? unreadQuerySnapshot(next.phase, next.availability)
+                : next;
         for (const listener of this.#listeners)
             listener();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/client",
-  "version": "0.25.1",
+  "version": "0.25.2",
   "description": "Syncular TypeScript client core — offline-first sync over SQLite (WASM/OPFS, Bun, Node)",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -89,10 +89,10 @@
   },
   "dependencies": {
     "@sqlite.org/sqlite-wasm": "^3.53.0-build1",
-    "@syncular/core": "0.25.1"
+    "@syncular/core": "0.25.2"
   },
   "devDependencies": {
-    "@syncular/server": "0.25.1",
+    "@syncular/server": "0.25.2",
     "playwright": "1.63.0"
   }
 }

package/src/reactive-store.ts

@@ -360,17 +360,38 @@ class ObservationCache {
   }
 }
 
+const EMPTY_ROWS: readonly never[] = Object.freeze([]);
+const unreadQuerySnapshots = new Map<string, LiveQueryResult<never>>();
+
+/** One frozen snapshot per phase and availability for entries that have no
+ * successful read, so switching between unread entries keeps the snapshot and
+ * `rows` identity. */
+function unreadQuerySnapshot(
+  phase: LiveQueryPhase,
+  availability: SyncAvailability,
+): LiveQueryResult<never> {
+  const key = canonicalValue([phase, availability]);
+  let snapshot = unreadQuerySnapshots.get(key);
+  if (snapshot === undefined) {
+    snapshot = Object.freeze({
+      rows: EMPTY_ROWS,
+      phase,
+      revision: undefined,
+      error: undefined,
+      isRefreshing: false,
+      availability,
+    });
+    unreadQuerySnapshots.set(key, snapshot);
+  }
+  return snapshot;
+}
+
 class QueryEntry<Row> implements ExternalStoreEntry<LiveQueryResult<Row>> {
   readonly #owner = Symbol('query-window-claim');
   readonly #listeners = new Set<() => void>();
-  #state: LiveQueryResult<Row> = {
-    rows: [],
-    phase: 'loading',
-    revision: undefined,
-    error: undefined,
-    isRefreshing: false,
-    availability: { state: 'ready' },
-  };
+  #state: LiveQueryResult<Row> = unreadQuerySnapshot('loading', {
+    state: 'ready',
+  });
   #delegate: QueryEntry<Row> | undefined;
   #generation = 0;
   #scheduled = false;
@@ -476,14 +497,7 @@ class QueryEntry<Row> implements ExternalStoreEntry<LiveQueryResult<Row>> {
     this.#desiredRevision = 0n;
     this.#claimError = undefined;
     this.#claimPending = false;
-    this.#state = {
-      rows: [],
-      phase: 'loading',
-      revision: undefined,
-      error: undefined,
-      isRefreshing: false,
-      availability: { state: 'ready' },
-    };
+    this.#state = unreadQuerySnapshot('loading', { state: 'ready' });
   }
 
   dispose(): void {
@@ -513,7 +527,13 @@ class QueryEntry<Row> implements ExternalStoreEntry<LiveQueryResult<Row>> {
     ) {
       return;
     }
-    this.#state = next;
+    this.#state =
+      next.revision === undefined &&
+      next.rows.length === 0 &&
+      next.error === undefined &&
+      !next.isRefreshing
+        ? unreadQuerySnapshot(next.phase, next.availability)
+        : next;
     for (const listener of this.#listeners) listener();
   }