cry-synced-db-client 0.1.145 → 0.1.146

package/CHANGELOG.md

@@ -108,6 +108,36 @@ Signature is identical. No other callback changes.
   - Noop when offline or on writeOnly collections.
   - Ignored on `find` / `findOne` (use `referToServer` there).
 
+## 0.1.146 (2026-04-25)
+
+### Fix: INITIAL SYNC re-fetched whole dataset on every reload (cursor race)
+
+`syncMetaCache` was populated lazily inside `loadCollectionToInMem` — one
+collection at a time, only after that collection's records finished hydrating
+into in-memory state. When `ConnectionManager.tryGoOnline` fired
+`sync("INITIAL SYNC")` on WS connect (or `setSyncOnlyTheseCollections`
+expanded the allowed set under a fresh login), the sync engine read
+`syncMetaCache.get(collection)?.lastSyncTs` for each collection — and for
+collections whose hydration hadn't completed yet, it found nothing and fell
+back to `timestamp: 0` (`SyncEngine.ts:94`). The server then returned every
+matching row since epoch, not a delta.
+
+In one observed reproducer with 62 sync'd collections, 58 of them arrived at
+the server with `timestamp: 0` and the server replied with 60 131 rows on a
+session that already had 58 745 rows cached locally — i.e. ~full re-fetch
+every reload, regardless of how recently the client had synced.
+
+`init()` now eagerly preloads sync cursors for every registered collection
+into `syncMetaCache` before `connectionManager.startTimers()` runs, via a
+parallel fan-out of `getSyncMeta` reads. Cursor cache availability is
+decoupled from in-mem record hydration: a sync triggered the moment WS comes
+up reads a fully populated cache, regardless of where hydration is. One Dexie
+point-lookup per registered collection — cheap.
+
+The lazy populate inside `loadCollectionToInMem` is retained as a defensive
+overwrite for collections registered after init (e.g. via dynamic
+`addCollection`).
+
 ## 0.1.145 (2026-04-25)
 
 ### Fix: `onSyncProgress` back-track during initial sync

package/dist/index.js

@@ -3801,6 +3801,7 @@ var _SyncedDb = class _SyncedDb {
       }
     }
     await this.pendingChanges.recoverPendingWrites();
+    await this.preloadAllSyncMetas();
     const allowedColls = [...this.collections.keys()].filter((n) => this.isSyncAllowed(n));
     await this.loadCollectionsToInMem(allowedColls, "init");
     this.leaderElection.init();
@@ -5019,6 +5020,25 @@ var _SyncedDb = class _SyncedDb {
     }
     return allItems.length;
   }
+  /**
+   * Bulk-read sync cursors for every registered collection into syncMetaCache.
+   * Called once during init() before sync can fire. Decouples cursor cache
+   * availability from in-mem record hydration, eliminating the race where a
+   * sync triggered by ConnectionManager.tryGoOnline (or by setSyncOnlyTheseCollections
+   * expanding the allowed set) reads an unpopulated cache and sends timestamp:0
+   * for un-hydrated collections.
+   */
+  async preloadAllSyncMetas() {
+    const names = [...this.collections.keys()];
+    const results = await Promise.all(
+      names.map(
+        (name) => this.dexieDb.getSyncMeta(name).then((meta) => ({ name, meta }))
+      )
+    );
+    for (const { name, meta } of results) {
+      if (meta) this.syncMetaCache.set(name, meta);
+    }
+  }
   assertCollection(name) {
     if (!this.collections.has(name)) {
       throw new Error(`SyncedDb: Collection "${(name == null ? void 0 : name.toString()) || "?"}" not configured`);

package/dist/src/db/SyncedDb.d.ts

@@ -291,6 +291,15 @@ export declare class SyncedDb implements I_SyncedDb {
      */
     private loadCollectionsToInMem;
     private loadCollectionToInMem;
+    /**
+     * Bulk-read sync cursors for every registered collection into syncMetaCache.
+     * Called once during init() before sync can fire. Decouples cursor cache
+     * availability from in-mem record hydration, eliminating the race where a
+     * sync triggered by ConnectionManager.tryGoOnline (or by setSyncOnlyTheseCollections
+     * expanding the allowed set) reads an unpopulated cache and sends timestamp:0
+     * for un-hydrated collections.
+     */
+    private preloadAllSyncMetas;
     private assertCollection;
     private static readonly STRINGIFIED_FALSY;
     /** Stringify an Id parameter (ObjectId → hex string). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cry-synced-db-client",
-  "version": "0.1.145",
+  "version": "0.1.146",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",