cry-synced-db-client 0.1.199 → 0.1.201

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Versions
 
+## 0.1.201 (2026-06-14)
+
+### `onBeforeDirtyClearAll` callback zdaj prejme `DirtyChange[]` (ne samo `DirtyMeta[]`)
+
+`BeforeDirtyClearAllInfo.items` je nadgrajen iz `DirtyMeta[]` v `DirtyChange[]` —
+callback dobi poleg metapodatkov (`id`, `collection`, `stuckSince`, ...) tudi
+`changes` payload z dejanskimi field-level spremembami.
+
+**Affected paths:**
+- `clearDirty()` clear-all path: fetcha `DirtyChange[]` prek `getDirtyChangesBatch`
+- `discardStuckItems()`: zamenja `getDirty` + `find` (ki je vračal
+  `Partial<LocalDbEntity>[]`) z `getDirtyChangesBatch` za pravilne `DirtyChange[]`
+
+**Type change (backward-compatible):**
+- `items` v `BeforeDirtyClearAllInfo`: `DirtyMeta[]` → `DirtyChange[]`
+- `DirtyChange` je superset of `DirtyMeta`; vsa obstoječa polja (`id`,
+  `collection`, `createdAt`, `updatedAt`, `stuckSince`, ...) so še vedno na voljo
+
+876 pass, 0 fail.
+
+## 0.1.200 (2026-06-14)
+
+### `preprocessDirtyItem` skip/throw zdaj incrementa `numUploadAttempts`
+
+`SyncEngine.uploadDirtyItems`: ko `preprocessDirtyItem` vrne `undefined` ali vrže
+exception, se item ne samo preskoči — zdaj dobi tudi `incrementDirtyUploadAttempts`,
+tako da po 2+ skipih postane stuck in viden prek `getStuckItems()` / `onDirtyItemStuck`.
+
+Prej so skipani itemi tiho ostali v `_dirty_changes` brez metapodatkov in nikoli ne
+bi postali stuck — zdaj se po 3 skipih (vsak sync da 2 incrementa = main + followUp)
+dobijo `stuckSince`.
+
+**Internal:**
+- V `uploadDirtyItems` zbira `preprocessSkippedIds` v obeh poteh, batch-write v
+  `incrementDirtyUploadAttempts` takoj za `for` zanko (en DB write za vse skipane
+  iteme namesto N write-ov)
+
+**Tests:** 5 novih testov v `test/preprocessDirtyItem.test.ts`:
+- `undefined/throw: numUploadAttempts increments across sync cycles, eventually stuck`
+- `undefined/throw: onDirtyItemStuck fires when item becomes stuck`
+- `mixed: stuck item via getStuckItems while non-stuck dirty still active`
+
+876 pass, 0 fail.
+
 ## 0.1.198 (2026-06-13)
 
 ### Stuck-item tracking (`getStuckItems` / `discardStuckItems` / `onDirtyItemStuck`)

package/dist/index.js

@@ -3245,7 +3245,10 @@ var _SyncEngine = class _SyncEngine {
         configMap.set(collectionName, config);
       }
       this.callOnFindNewerManyCall(syncSpecs, calledFrom);
-      this.callbackSafe(this.callbacks.onServerSyncStart, { calledFrom, collectionCount: syncSpecs.length });
+      this.callbackSafe(this.callbacks.onServerSyncStart, {
+        calledFrom,
+        collectionCount: syncSpecs.length
+      });
       const findNewerManyStartTime = Date.now();
       const collectionState = /* @__PURE__ */ new Map();
       for (const [name] of configMap) {
@@ -3276,7 +3279,12 @@ var _SyncEngine = class _SyncEngine {
               if (!config) return;
               const state = collectionState.get(collection);
               state.receivedCount += items.length;
-              const stats = await this.processIncomingServerData(collection, config, items, state.source);
+              const stats = await this.processIncomingServerData(
+                collection,
+                config,
+                items,
+                state.source
+              );
               state.conflicts += stats.conflictsResolved;
               if (stats.maxTs) {
                 if (!state.maxTs || this.compareTimestamps(stats.maxTs, state.maxTs) > 0) {
@@ -3358,12 +3366,16 @@ var _SyncEngine = class _SyncEngine {
       try {
         uploadStats = await this.uploadDirtyItems(calledFrom);
         await this.deps.flushAllPendingChanges();
-        const followUp = await this.uploadDirtyItems(`${calledFrom != null ? calledFrom : "sync"}:followUp`);
+        const followUp = await this.uploadDirtyItems(
+          `${calledFrom != null ? calledFrom : "sync"}:followUp`
+        );
         if (followUp.sentCount > 0) {
           uploadStats.sentCount += followUp.sentCount;
           if (followUp.collectionSentCounts) {
             uploadStats.collectionSentCounts = uploadStats.collectionSentCounts || {};
-            for (const [c, n] of Object.entries(followUp.collectionSentCounts)) {
+            for (const [c, n] of Object.entries(
+              followUp.collectionSentCounts
+            )) {
               uploadStats.collectionSentCounts[c] = (uploadStats.collectionSentCounts[c] || 0) + n;
             }
           }
@@ -3375,7 +3387,9 @@ var _SyncEngine = class _SyncEngine {
         );
       }
       sentCount = uploadStats.sentCount;
-      for (const [collectionName, stats] of Object.entries(uploadStats.collectionSentCounts || {})) {
+      for (const [collectionName, stats] of Object.entries(
+        uploadStats.collectionSentCounts || {}
+      )) {
         if (collectionStats[collectionName]) {
           collectionStats[collectionName].sentCount = stats;
         } else {
@@ -3473,15 +3487,20 @@ var _SyncEngine = class _SyncEngine {
         });
       }
     }
-    if (dexieSave.length > 0) await this.dexieDb.saveMany(collection, dexieSave);
+    if (dexieSave.length > 0)
+      await this.dexieDb.saveMany(collection, dexieSave);
     if (dexieDeleteIds.length > 0) {
       await this.dexieDb.deleteMany(collection, dexieDeleteIds);
     }
     if (memUpsert.length > 0) {
-      this.deps.writeToInMemBatch(collection, memUpsert, "upsert", { source: "incremental" });
+      this.deps.writeToInMemBatch(collection, memUpsert, "upsert", {
+        source: "incremental"
+      });
     }
     if (memDelete.length > 0) {
-      this.deps.writeToInMemBatch(collection, memDelete, "delete", { source: "incremental" });
+      this.deps.writeToInMemBatch(collection, memDelete, "delete", {
+        source: "incremental"
+      });
     }
     if (reAddDirty.length > 0) {
       await this.dexieDb.addDirtyChangesBatch(collection, reAddDirty);
@@ -3520,7 +3539,10 @@ var _SyncEngine = class _SyncEngine {
       const updates = [];
       const skipped = [];
       const ids = dirtyChanges.map((dc) => dc._id);
-      const fullItems = await this.dexieDb.getByIds(collectionName, ids);
+      const fullItems = await this.dexieDb.getByIds(
+        collectionName,
+        ids
+      );
       const orphanReconstructed = [];
       for (let i = 0; i < fullItems.length; i++) {
         const fullItem = fullItems[i];
@@ -3531,7 +3553,10 @@ var _SyncEngine = class _SyncEngine {
             const currentServerRev = typeof fullItem._rev === "number" ? fullItem._rev : void 0;
             updates.push({ _id: fullItem._id, delta, currentServerRev });
           } else {
-            skipped.push({ _id: String(fullItem._id), reason: "no-delta-for-fullitem" });
+            skipped.push({
+              _id: String(fullItem._id),
+              reason: "no-delta-for-fullitem"
+            });
           }
         } else if (id != null) {
           const delta = dirtyChangesMap.get(String(id));
@@ -3568,7 +3593,10 @@ var _SyncEngine = class _SyncEngine {
               timestamp: /* @__PURE__ */ new Date()
             });
           } catch (err) {
-            console.error(`[SyncEngine] onUploadSkip callback failed: ${err}`, err);
+            console.error(
+              `[SyncEngine] onUploadSkip callback failed: ${err}`,
+              err
+            );
           }
         }
         continue;
@@ -3585,10 +3613,14 @@ var _SyncEngine = class _SyncEngine {
             timestamp: /* @__PURE__ */ new Date()
           });
         } catch (err) {
-          console.error(`[SyncEngine] onUploadSkip callback failed: ${err}`, err);
+          console.error(
+            `[SyncEngine] onUploadSkip callback failed: ${err}`,
+            err
+          );
         }
       }
       const mappedUpdates = [];
+      const preprocessSkippedIds = [];
       for (const item of updates) {
         const dirtyBaseRev = typeof item.delta._rev === "number" ? item.delta._rev : void 0;
         const stripped = stripServerManagedFromChanges(
@@ -3605,8 +3637,12 @@ var _SyncEngine = class _SyncEngine {
         };
         if (this.preprocessDirtyItem) {
           try {
-            const processed = this.preprocessDirtyItem(candidate, collectionName);
+            const processed = this.preprocessDirtyItem(
+              candidate,
+              collectionName
+            );
             if (processed === void 0) {
+              preprocessSkippedIds.push(item._id);
               continue;
             }
             candidate = processed;
@@ -3615,6 +3651,7 @@ var _SyncEngine = class _SyncEngine {
               `[SyncEngine] preprocessDirtyItem(${collectionName}) failed for _id=${String(item._id)}; keeping dirty for retry:`,
               err
             );
+            preprocessSkippedIds.push(item._id);
             continue;
           }
         }
@@ -3624,14 +3661,23 @@ var _SyncEngine = class _SyncEngine {
           update: candidate.update
         });
       }
+      if (preprocessSkippedIds.length > 0) {
+        const newlyStuck = await this.dexieDb.incrementDirtyUploadAttempts(
+          collectionName,
+          preprocessSkippedIds
+        );
+        this.callOnDirtyItemStuck(collectionName, newlyStuck, calledFrom);
+      }
       if (mappedUpdates.length === 0) continue;
-      collectionBatches.push([{
-        collection: collectionName,
-        batch: {
-          updates: mappedUpdates,
-          deletes: []
+      collectionBatches.push([
+        {
+          collection: collectionName,
+          batch: {
+            updates: mappedUpdates,
+            deletes: []
+          }
         }
-      }]);
+      ]);
     }
     if (collectionBatches.length === 0) {
       return { sentCount: 0 };
@@ -3669,7 +3715,10 @@ var _SyncEngine = class _SyncEngine {
           const allIds = [];
           for (const u of b.batch.updates) allIds.push(u._id);
           for (const d of b.batch.deletes) allIds.push((_a = d._id) != null ? _a : d);
-          const newlyStuck = await this.dexieDb.incrementDirtyUploadAttempts(b.collection, allIds);
+          const newlyStuck = await this.dexieDb.incrementDirtyUploadAttempts(
+            b.collection,
+            allIds
+          );
           this.callOnDirtyItemStuck(b.collection, newlyStuck, calledFrom);
         }
       }
@@ -3721,7 +3770,9 @@ var _SyncEngine = class _SyncEngine {
           `[SyncEngine] Sync upload [${collection}]: ${ambiguous.length} id(s) appeared in BOTH inserted/updated/deleted AND errors[] \u2014 keeping dirty for safety. _ids: ${ambiguous.join(", ")}`
         );
       }
-      const dirtyBeforeRefresh = mustRefreshIds.size > 0 ? await this.dexieDb.getDirtyChangesBatch(collection, [...mustRefreshIds]) : /* @__PURE__ */ new Map();
+      const dirtyBeforeRefresh = mustRefreshIds.size > 0 ? await this.dexieDb.getDirtyChangesBatch(collection, [
+        ...mustRefreshIds
+      ]) : /* @__PURE__ */ new Map();
       const uploadedByIdRefresh = mustRefreshIds.size > 0 ? this.uploadedSnapshotFor(collectionBatches, collection) : /* @__PURE__ */ new Map();
       if (allSuccessIds.length > 0) {
         await this.dexieDb.clearDirtyChangesBatch(collection, allSuccessIds);
@@ -3730,8 +3781,10 @@ var _SyncEngine = class _SyncEngine {
       for (const batch of collectionBatches) {
         for (const b of batch) {
           if (b.collection !== collection) continue;
-          for (const u of b.batch.updates) sentIdsForCollection.add(String(u._id));
-          for (const d of b.batch.deletes) sentIdsForCollection.add(String(d._id));
+          for (const u of b.batch.updates)
+            sentIdsForCollection.add(String(u._id));
+          for (const d of b.batch.deletes)
+            sentIdsForCollection.add(String(d._id));
         }
       }
       const retainedIds = [];
@@ -3741,7 +3794,10 @@ var _SyncEngine = class _SyncEngine {
         }
       }
       if (retainedIds.length > 0) {
-        const newlyStuck = await this.dexieDb.incrementDirtyUploadAttempts(collection, retainedIds);
+        const newlyStuck = await this.dexieDb.incrementDirtyUploadAttempts(
+          collection,
+          retainedIds
+        );
         this.callOnDirtyItemStuck(collection, newlyStuck, calledFrom);
       }
       let collectionSentCount = 0;
@@ -3753,7 +3809,10 @@ var _SyncEngine = class _SyncEngine {
         if (isWriteOnly) {
           await this.dexieDb.deleteMany(collection, idsToCheck);
         } else {
-          const dexieItems = await this.dexieDb.getByIds(collection, idsToCheck);
+          const dexieItems = await this.dexieDb.getByIds(
+            collection,
+            idsToCheck
+          );
           const dexieSaveBatch = [];
           const inMemUpdateBatch = [];
           const inMemDeleteIds = [];
@@ -3781,7 +3840,12 @@ var _SyncEngine = class _SyncEngine {
             await this.dexieDb.deleteMany(collection, dexieDeleteIds);
           }
           if (inMemUpdateBatch.length > 0) {
-            this.deps.writeToInMemBatch(collection, inMemUpdateBatch, "upsert", { source: "incremental" });
+            this.deps.writeToInMemBatch(
+              collection,
+              inMemUpdateBatch,
+              "upsert",
+              { source: "incremental" }
+            );
           }
           if (inMemDeleteIds.length > 0) {
             this.deps.writeToInMemBatch(
@@ -3804,7 +3868,9 @@ var _SyncEngine = class _SyncEngine {
         }
         await this.dexieDb.deleteMany(collection, deleteIds);
         if (!isWriteOnly) {
-          this.deps.writeToInMemBatch(collection, deleteDbEntities, "delete", { source: "incremental" });
+          this.deps.writeToInMemBatch(collection, deleteDbEntities, "delete", {
+            source: "incremental"
+          });
         }
         sentCount += deleted.length;
         collectionSentCount += deleted.length;
@@ -3820,7 +3886,7 @@ var _SyncEngine = class _SyncEngine {
       if (collectionSentCount > 0) {
         collectionSentCounts[collection] = collectionSentCount;
       }
-      let maxTs = void 0;
+      let maxTs;
       for (const arr of [inserted, updated, deleted]) {
         for (const item of arr) {
           if (item._ts) {
@@ -3890,7 +3956,10 @@ var _SyncEngine = class _SyncEngine {
       return { sentCount: 0 };
     }
     const ids = dirtyItems.map((item) => item._id);
-    const fullItems = await this.dexieDb.getByIds(collection, ids);
+    const fullItems = await this.dexieDb.getByIds(
+      collection,
+      ids
+    );
     const dirtyChangesMap = /* @__PURE__ */ new Map();
     for (const dirtyItem of dirtyItems) {
       dirtyChangesMap.set(String(dirtyItem._id), dirtyItem);
@@ -3906,20 +3975,24 @@ var _SyncEngine = class _SyncEngine {
     if (updates.length === 0) {
       return { sentCount: 0 };
     }
-    const collectionBatches = [[{
-      collection,
-      batch: {
-        updates: updates.map((item) => {
-          const _a = item.delta, { _ts, _rev } = _a, changes = __objRest(_a, ["_ts", "_rev"]);
-          return {
-            _id: item._id,
-            _rev: typeof _rev === "number" ? _rev : 0,
-            update: changes
-          };
-        }),
-        deletes: []
-      }
-    }]];
+    const collectionBatches = [
+      [
+        {
+          collection,
+          batch: {
+            updates: updates.map((item) => {
+              const _a = item.delta, { _ts, _rev } = _a, changes = __objRest(_a, ["_ts", "_rev"]);
+              return {
+                _id: item._id,
+                _rev: typeof _rev === "number" ? _rev : 0,
+                update: changes
+              };
+            }),
+            deletes: []
+          }
+        }
+      ]
+    ];
     const results = await this.deps.withSyncTimeout(
       this.restInterface.updateCollections(collectionBatches),
       "updateCollections"
@@ -3986,8 +4059,10 @@ var _SyncEngine = class _SyncEngine {
       for (const batch of collectionBatches) {
         for (const b of batch) {
           if (b.collection !== collection) continue;
-          for (const u of b.batch.updates) sentIdsForCollection.add(String(u._id));
-          for (const d of b.batch.deletes) sentIdsForCollection.add(String(d._id));
+          for (const u of b.batch.updates)
+            sentIdsForCollection.add(String(u._id));
+          for (const d of b.batch.deletes)
+            sentIdsForCollection.add(String(d._id));
         }
       }
       const retainedIds = [];
@@ -3997,7 +4072,10 @@ var _SyncEngine = class _SyncEngine {
         }
       }
       if (retainedIds.length > 0) {
-        const newlyStuck = await this.dexieDb.incrementDirtyUploadAttempts(collection, retainedIds);
+        const newlyStuck = await this.dexieDb.incrementDirtyUploadAttempts(
+          collection,
+          retainedIds
+        );
         this.callOnDirtyItemStuck(collection, newlyStuck, calledFrom);
       }
       if (mustRefresh && mustRefresh.length > 0) {
@@ -4025,7 +4103,12 @@ var _SyncEngine = class _SyncEngine {
     const config = this.collections.get(collectionName);
     if (!config) return { updatedIds: [] };
     const source = (_a = opts == null ? void 0 : opts.source) != null ? _a : "incremental";
-    const result = await this.processIncomingServerData(collectionName, config, serverData, source);
+    const result = await this.processIncomingServerData(
+      collectionName,
+      config,
+      serverData,
+      source
+    );
     if (result.updatedIds.length > 0) {
       this.deps.broadcastUpdates({ [collectionName]: result.updatedIds });
     }
@@ -4043,8 +4126,14 @@ var _SyncEngine = class _SyncEngine {
       const chunk = serverData.slice(offset, offset + BATCH);
       const chunkIds = [];
       for (const item of chunk) chunkIds.push(item._id);
-      const localItems = await this.dexieDb.getByIds(collectionName, chunkIds);
-      const dirtyChangesMap = await this.dexieDb.getDirtyChangesBatch(collectionName, chunkIds);
+      const localItems = await this.dexieDb.getByIds(
+        collectionName,
+        chunkIds
+      );
+      const dirtyChangesMap = await this.dexieDb.getDirtyChangesBatch(
+        collectionName,
+        chunkIds
+      );
       const dexieBatch = [];
       const inMemSaveBatch = [];
       const inMemDeleteIds = [];
@@ -4093,7 +4182,9 @@ var _SyncEngine = class _SyncEngine {
         await this.dexieDb.saveMany(collectionName, dexieBatch);
       }
       if (inMemSaveBatch.length > 0) {
-        this.deps.writeToInMemBatch(collectionName, inMemSaveBatch, "upsert", { source });
+        this.deps.writeToInMemBatch(collectionName, inMemSaveBatch, "upsert", {
+          source
+        });
       }
       if (inMemDeleteIds.length > 0) {
         this.deps.writeToInMemBatch(
@@ -4141,7 +4232,10 @@ var _SyncEngine = class _SyncEngine {
           timestamp: /* @__PURE__ */ new Date()
         });
       } catch (err) {
-        console.error(`[SyncEngine] onConflictResolved callback failed: ${err}`, err);
+        console.error(
+          `[SyncEngine] onConflictResolved callback failed: ${err}`,
+          err
+        );
       }
     }
     return resolved;
@@ -4186,7 +4280,10 @@ var _SyncEngine = class _SyncEngine {
           calledFrom
         });
       } catch (err) {
-        console.error(`[SyncEngine] onFindNewerManyCall callback failed: ${err}`, err);
+        console.error(
+          `[SyncEngine] onFindNewerManyCall callback failed: ${err}`,
+          err
+        );
       }
     }
   }
@@ -4205,7 +4302,10 @@ var _SyncEngine = class _SyncEngine {
           ttfbMs: metrics == null ? void 0 : metrics.ttfbMs
         });
       } catch (err) {
-        console.error(`[SyncEngine] onFindNewerManyResult callback failed: ${err}`, err);
+        console.error(
+          `[SyncEngine] onFindNewerManyResult callback failed: ${err}`,
+          err
+        );
       }
     }
   }
@@ -4218,7 +4318,10 @@ var _SyncEngine = class _SyncEngine {
           calledFrom
         });
       } catch (err) {
-        console.error(`[SyncEngine] onServerWriteRequest callback failed: ${err}`, err);
+        console.error(
+          `[SyncEngine] onServerWriteRequest callback failed: ${err}`,
+          err
+        );
       }
     }
   }
@@ -4233,7 +4336,10 @@ var _SyncEngine = class _SyncEngine {
           calledFrom
         });
       } catch (err) {
-        console.error(`[SyncEngine] onServerWriteResult callback failed: ${err}`, err);
+        console.error(
+          `[SyncEngine] onServerWriteResult callback failed: ${err}`,
+          err
+        );
       }
     }
   }
@@ -4247,7 +4353,10 @@ var _SyncEngine = class _SyncEngine {
         timestamp: /* @__PURE__ */ new Date()
       });
     } catch (err) {
-      console.error(`[SyncEngine] onDirtyItemStuck callback failed: ${err}`, err);
+      console.error(
+        `[SyncEngine] onDirtyItemStuck callback failed: ${err}`,
+        err
+      );
     }
   }
   callOnServerSyncWrite(request, response, error, startTime, timestamp, calledFrom) {
@@ -4267,7 +4376,10 @@ var _SyncEngine = class _SyncEngine {
         timestamp
       });
     } catch (err) {
-      console.error(`[SyncEngine] onServerSyncWrite callback failed: ${err}`, err);
+      console.error(
+        `[SyncEngine] onServerSyncWrite callback failed: ${err}`,
+        err
+      );
     }
   }
 };
@@ -4790,7 +4902,8 @@ var _SyncedDb = class _SyncedDb {
     this.evictOnWake = (_g = config.evictOnWake) != null ? _g : false;
     for (const col of config.collections) {
       this.collections.set(col.name, col);
-      if (!col.writeOnly) this.preloadStatusMap.set(col.name, { state: "pending", itemCount: 0 });
+      if (!col.writeOnly)
+        this.preloadStatusMap.set(col.name, { state: "pending", itemCount: 0 });
     }
     this.inMemManager = new InMemManager({
       inMemDb: this.inMemDb,
@@ -4804,14 +4917,20 @@ var _SyncedDb = class _SyncedDb {
         onBecameLeader: () => {
           if (this.initialized && !this.connectionManager.isOnline() && !this.connectionManager.isForcedOffline()) {
             this.connectionManager.tryGoOnline().catch((err) => {
-              networkError(`[SyncedDb] tryGoOnline on becameLeader failed: ${err}`, err);
+              networkError(
+                `[SyncedDb] tryGoOnline on becameLeader failed: ${err}`,
+                err
+              );
             });
           }
           if (config.onBecameLeader) {
             try {
               config.onBecameLeader();
             } catch (err) {
-              console.error(`[SyncedDb] onBecameLeader callback failed: ${err}`, err);
+              console.error(
+                `[SyncedDb] onBecameLeader callback failed: ${err}`,
+                err
+              );
             }
           }
         },
@@ -4914,7 +5033,9 @@ var _SyncedDb = class _SyncedDb {
       restInterface: this.restInterface,
       preprocessDirtyItem: config.preprocessDirtyItem,
       callbacks: {
-        onSyncStart: config.onSyncStart ? (info) => config.onSyncStart(__spreadProps(__spreadValues({}, info), { initialSync: !this._lastFullSyncDate })) : void 0,
+        onSyncStart: config.onSyncStart ? (info) => config.onSyncStart(__spreadProps(__spreadValues({}, info), {
+          initialSync: !this._lastFullSyncDate
+        })) : void 0,
         onSyncEnd: config.onSyncEnd,
         onSyncProgress: config.onSyncProgress,
         onServerSyncStart: config.onServerSyncStart,
@@ -5056,7 +5177,12 @@ var _SyncedDb = class _SyncedDb {
         "[SyncedDb] callWorker: no serverUpdateNotifier or notifier does not support callWorker"
       );
     }
-    return fn.call(this.serverUpdateNotifier, service, payload, options);
+    return fn.call(
+      this.serverUpdateNotifier,
+      service,
+      payload,
+      options
+    );
   }
   /**
    * Register a collection for sync at runtime. See `I_SyncedDb.addCollectionToSync`.
@@ -5093,7 +5219,10 @@ var _SyncedDb = class _SyncedDb {
       if (existing && !existing.temporaryConfig) continue;
       this.collections.set(spec.name, spec);
       if (!spec.writeOnly && !this.preloadStatusMap.has(spec.name)) {
-        this.preloadStatusMap.set(spec.name, { state: "pending", itemCount: 0 });
+        this.preloadStatusMap.set(spec.name, {
+          state: "pending",
+          itemCount: 0
+        });
       }
       if (this.syncOnlyCollections) {
         this.syncOnlyCollections.add(spec.name);
@@ -5155,7 +5284,11 @@ var _SyncedDb = class _SyncedDb {
       if (!data || data.length === 0) continue;
       const source = plan.wasFirstTime ? "initial" : "incremental";
       try {
-        await this.syncEngine.processCollectionServerData(plan.spec.name, data, { source });
+        await this.syncEngine.processCollectionServerData(
+          plan.spec.name,
+          data,
+          { source }
+        );
       } catch (err) {
         console.error(
           `[SyncedDb] addCollectionsToSync: processCollectionServerData failed for "${plan.spec.name}":`,
@@ -5194,7 +5327,9 @@ var _SyncedDb = class _SyncedDb {
     if (!spec.writeOnly && this.connectionManager.canSync()) {
       const rawQuery = (_a = spec.syncConfig) == null ? void 0 : _a.query;
       const query = typeof rawQuery === "function" ? rawQuery() : rawQuery;
-      await this.syncCollectionForFind(spec.name, query, { returnDeleted: true });
+      await this.syncCollectionForFind(spec.name, query, {
+        returnDeleted: true
+      });
     }
   }
   /**
@@ -5220,7 +5355,10 @@ var _SyncedDb = class _SyncedDb {
     }
     this.emitPreloadStatusChange();
     if (newlyAllowed.length > 0) {
-      await this.loadCollectionsToInMem(newlyAllowed, "setSyncOnlyTheseCollections");
+      await this.loadCollectionsToInMem(
+        newlyAllowed,
+        "setSyncOnlyTheseCollections"
+      );
     }
     if (newlyAllowed.length > 0 && this.connectionManager.canSync()) {
       this.sync("setSyncOnlyTheseCollections").catch(() => {
@@ -5262,12 +5400,17 @@ var _SyncedDb = class _SyncedDb {
       try {
         this.onDatabaseCreated();
       } catch (err) {
-        console.error(`[SyncedDb] onDatabaseCreated callback failed: ${err}`, err);
+        console.error(
+          `[SyncedDb] onDatabaseCreated callback failed: ${err}`,
+          err
+        );
       }
     }
     await this.pendingChanges.recoverPendingWrites();
     await this.preloadAllSyncMetas();
-    const allowedColls = [...this.collections.keys()].filter((n) => this.isSyncAllowed(n));
+    const allowedColls = [...this.collections.keys()].filter(
+      (n) => this.isSyncAllowed(n)
+    );
     await this.loadCollectionsToInMem(allowedColls, "init");
     this.leaderElection.init();
     this.crossTabSync.init();
@@ -5298,7 +5441,9 @@ var _SyncedDb = class _SyncedDb {
         console.log(`[SyncedDb] SyncedDb: ebus-proxy connected to ${ep}`);
       } catch (err) {
         const ep = (_d = this.serverUpdateNotifier.endpoint) != null ? _d : "unknown";
-        console.warn(`[SyncedDb] SyncedDb: ebus-proxy connection to ${ep} failed`);
+        console.warn(
+          `[SyncedDb] SyncedDb: ebus-proxy connection to ${ep} failed`
+        );
         this.connectionManager.reportInfrastructureError(
           "WEBSOCKET_CONNECTION_FAILED",
           `WebSocket connection to ${ep} failed during initialization`,
@@ -5320,10 +5465,16 @@ var _SyncedDb = class _SyncedDb {
       this.visibilityFlushHandler = () => {
         if (document.visibilityState !== "hidden") return;
         this.flushToServer("visibility-hidden").catch((err) => {
-          console.warn(`[SyncedDb] flushToServer on visibility-hidden failed: ${err == null ? void 0 : err.message}`, err);
+          console.warn(
+            `[SyncedDb] flushToServer on visibility-hidden failed: ${err == null ? void 0 : err.message}`,
+            err
+          );
         });
       };
-      document.addEventListener("visibilitychange", this.visibilityFlushHandler);
+      document.addEventListener(
+        "visibilitychange",
+        this.visibilityFlushHandler
+      );
     }
     this._checkForceFullResyncThreshold("init");
     this._startForceResyncCheckTimer();
@@ -5436,7 +5587,10 @@ var _SyncedDb = class _SyncedDb {
     });
     if (this.connectionManager.canSync()) {
       this.sync(`force-full-resync:${reason}`).catch((err) => {
-        console.error(`[SyncedDb] force full resync sync() failed: ${err}`, err);
+        console.error(
+          `[SyncedDb] force full resync sync() failed: ${err}`,
+          err
+        );
       });
     }
   }
@@ -5510,7 +5664,10 @@ var _SyncedDb = class _SyncedDb {
       this.beforeUnloadHandler = void 0;
     }
     if (typeof document !== "undefined" && this.visibilityFlushHandler) {
-      document.removeEventListener("visibilitychange", this.visibilityFlushHandler);
+      document.removeEventListener(
+        "visibilitychange",
+        this.visibilityFlushHandler
+      );
       this.visibilityFlushHandler = void 0;
     }
     this.syncMetaCache.clear();
@@ -5590,7 +5747,12 @@ var _SyncedDb = class _SyncedDb {
         if (serverItem) {
           await this.dexieDb.saveMany(collection, [serverItem]);
           if (!serverItem._deleted && !serverItem._archived) {
-            this.inMemManager.writeBatch(collection, [serverItem], "upsert", { source: "incremental" });
+            this.inMemManager.writeBatch(
+              collection,
+              [serverItem],
+              "upsert",
+              { source: "incremental" }
+            );
           }
         }
       } catch (e) {
@@ -5663,9 +5825,16 @@ var _SyncedDb = class _SyncedDb {
         );
         if (serverItems && serverItems.length > 0) {
           await this.dexieDb.saveMany(collection, serverItems);
-          const toInMem = serverItems.filter((s) => !s._deleted && !s._archived);
+          const toInMem = serverItems.filter(
+            (s) => !s._deleted && !s._archived
+          );
           if (toInMem.length > 0) {
-            this.inMemManager.writeBatch(collection, toInMem, "upsert", { source: "incremental" });
+            this.inMemManager.writeBatch(
+              collection,
+              toInMem,
+              "upsert",
+              { source: "incremental" }
+            );
           }
         }
       } catch (e) {
@@ -5706,11 +5875,16 @@ var _SyncedDb = class _SyncedDb {
         filtered.push(item);
       }
       if (filtered.length === 0) {
-        if ((opts == null ? void 0 : opts.referToServer) && this.isOnline()) this.referToServerSync(collection, query);
+        if ((opts == null ? void 0 : opts.referToServer) && this.isOnline())
+          this.referToServerSync(collection, query);
         return null;
       }
-      const sorted = applyQueryOpts(filtered, { sort: opts.sort, project: opts == null ? void 0 : opts.project });
-      if ((opts == null ? void 0 : opts.referToServer) && this.isOnline()) this.referToServerSync(collection, query);
+      const sorted = applyQueryOpts(filtered, {
+        sort: opts.sort,
+        project: opts == null ? void 0 : opts.project
+      });
+      if ((opts == null ? void 0 : opts.referToServer) && this.isOnline())
+        this.referToServerSync(collection, query);
       return (_b = sorted[0]) != null ? _b : null;
     } else {
       let result = null;
@@ -5724,7 +5898,8 @@ var _SyncedDb = class _SyncedDb {
       if (result && (opts == null ? void 0 : opts.project)) {
         result = projectItem(result, opts.project);
       }
-      if ((opts == null ? void 0 : opts.referToServer) && this.isOnline()) this.referToServerSync(collection, query);
+      if ((opts == null ? void 0 : opts.referToServer) && this.isOnline())
+        this.referToServerSync(collection, query);
       return result;
     }
   }
@@ -5777,15 +5952,24 @@ var _SyncedDb = class _SyncedDb {
     const timestamp = (meta == null ? void 0 : meta.lastSyncTs) || 0;
     try {
       const serverData = await this.connectionManager.withRestTimeout(
-        this.restInterface.findNewer(collection, timestamp, query, {
-          returnDeleted: (opts == null ? void 0 : opts.returnDeleted) || false,
-          returnArchived: (opts == null ? void 0 : opts.returnArchived) || false
-        }),
+        this.restInterface.findNewer(
+          collection,
+          timestamp,
+          query,
+          {
+            returnDeleted: (opts == null ? void 0 : opts.returnDeleted) || false,
+            returnArchived: (opts == null ? void 0 : opts.returnArchived) || false
+          }
+        ),
         "syncCollectionForFind"
       );
       if (serverData.length > 0) {
         const source = timestamp === 0 ? "initial" : "incremental";
-        await this.syncEngine.processCollectionServerData(collection, serverData, { source });
+        await this.syncEngine.processCollectionServerData(
+          collection,
+          serverData,
+          { source }
+        );
       }
     } catch (e) {
     }
@@ -5799,11 +5983,17 @@ var _SyncedDb = class _SyncedDb {
    */
   referToServerSync(collection, query) {
     this.connectionManager.withRestTimeout(
-      this.restInterface.findNewer(collection, 0, query, { returnDeleted: true }),
+      this.restInterface.findNewer(collection, 0, query, {
+        returnDeleted: true
+      }),
       "referToServer"
     ).then(async (serverData) => {
       if (serverData.length > 0) {
-        await this.syncEngine.processCollectionServerData(collection, serverData, { source: "refresh" });
+        await this.syncEngine.processCollectionServerData(
+          collection,
+          serverData,
+          { source: "refresh" }
+        );
       }
     }).catch((err) => {
       networkError(`[SyncedDb] referToServer failed for ${collection}:`, err);
@@ -5831,7 +6021,10 @@ var _SyncedDb = class _SyncedDb {
     for (const item of serverItems) {
       serverById.set(String(item._id), item);
     }
-    const localItems = await this.dexieDb.getByIds(collection, ids);
+    const localItems = await this.dexieDb.getByIds(
+      collection,
+      ids
+    );
     const dirtyMap = await this.dexieDb.getDirtyChangesBatch(collection, ids);
     const toSaveDexie = [];
     const toSaveInMem = [];
@@ -5859,10 +6052,16 @@ var _SyncedDb = class _SyncedDb {
       await this.dexieDb.saveMany(collection, toSaveDexie);
     }
     if (toSaveInMem.length > 0) {
-      this.inMemManager.writeBatch(collection, toSaveInMem, "upsert", { source: "incremental" });
+      this.inMemManager.writeBatch(collection, toSaveInMem, "upsert", {
+        source: "incremental"
+      });
     }
     if (dirtyServerItems.length > 0) {
-      await this.syncEngine.processCollectionServerData(collection, dirtyServerItems, { source: "incremental" });
+      await this.syncEngine.processCollectionServerData(
+        collection,
+        dirtyServerItems,
+        { source: "incremental" }
+      );
     }
   }
   /**
@@ -5890,9 +6089,16 @@ var _SyncedDb = class _SyncedDb {
       "refreshInBackground"
     ).then(async (serverItems) => {
       if (!serverItems || serverItems.length === 0) return;
-      await this.syncEngine.processCollectionServerData(collection, serverItems, { source: "incremental" });
+      await this.syncEngine.processCollectionServerData(
+        collection,
+        serverItems,
+        { source: "incremental" }
+      );
     }).catch((err) => {
-      networkError(`[SyncedDb] refreshInBackground failed for ${collection}:`, err);
+      networkError(
+        `[SyncedDb] refreshInBackground failed for ${collection}:`,
+        err
+      );
     });
   }
   async ensureItemsAreLoaded(collection, ids, withDeleted) {
@@ -5920,7 +6126,9 @@ var _SyncedDb = class _SyncedDb {
       await this.dexieDb.saveMany(collection, toSaveDexie);
     }
     if (toSaveInMem.length > 0) {
-      this.inMemManager.writeBatch(collection, toSaveInMem, "upsert", { source: "incremental" });
+      this.inMemManager.writeBatch(collection, toSaveInMem, "upsert", {
+        source: "incremental"
+      });
     }
   }
   // ==================== Write Operations ====================
@@ -5965,12 +6173,10 @@ var _SyncedDb = class _SyncedDb {
     }
     const fullChanges = __spreadProps(__spreadValues({}, update), { _lastUpdaterId: this.updaterId });
     const diff = computeObjDiff(existing, fullChanges);
-    await this.dexieDb.addDirtyChange(
-      collection,
-      id,
-      diff,
-      { _ts: existing == null ? void 0 : existing._ts, _rev: existing == null ? void 0 : existing._rev }
-    );
+    await this.dexieDb.addDirtyChange(collection, id, diff, {
+      _ts: existing == null ? void 0 : existing._ts,
+      _rev: existing == null ? void 0 : existing._rev
+    });
     const isWriteOnly = (_b = this.collections.get(collection)) == null ? void 0 : _b.writeOnly;
     const currentMem = isWriteOnly ? null : this.inMemDb.getById(collection, id);
     const merged = applyObjDiff(
@@ -5979,9 +6185,17 @@ var _SyncedDb = class _SyncedDb {
       id,
       collection
     );
-    this.pendingChanges.schedule(collection, id, merged, 0, "save");
+    this.pendingChanges.schedule(
+      collection,
+      id,
+      merged,
+      0,
+      "save"
+    );
     if (!isWriteOnly && !(existing == null ? void 0 : existing._deleted) && !(existing == null ? void 0 : existing._archived)) {
-      this.inMemManager.writeBatch(collection, [merged], "upsert", { source: "incremental" });
+      this.inMemManager.writeBatch(collection, [merged], "upsert", {
+        source: "incremental"
+      });
     }
     return merged;
   }
@@ -6026,7 +6240,12 @@ var _SyncedDb = class _SyncedDb {
     for (const path of unsetPaths) deleteByPath(newData, path);
     this.pendingChanges.schedule(collection, id, newData, 0, "insert");
     if (!((_a = this.collections.get(collection)) == null ? void 0 : _a.writeOnly)) {
-      this.inMemManager.writeBatch(collection, [newData], "upsert", { source: "incremental" });
+      this.inMemManager.writeBatch(
+        collection,
+        [newData],
+        "upsert",
+        { source: "incremental" }
+      );
     }
     return newData;
   }
@@ -6050,7 +6269,12 @@ var _SyncedDb = class _SyncedDb {
     };
     this.pendingChanges.schedule(collection, id, deleteUpdate, 0, "deleteOne");
     if (!((_a = this.collections.get(collection)) == null ? void 0 : _a.writeOnly)) {
-      this.inMemManager.writeBatch(collection, [{ _id: id }], "delete", { source: "incremental" });
+      this.inMemManager.writeBatch(
+        collection,
+        [{ _id: id }],
+        "delete",
+        { source: "incremental" }
+      );
     }
     return existing;
   }
@@ -6060,7 +6284,10 @@ var _SyncedDb = class _SyncedDb {
     const items = await this.find(collection, query);
     if (items.length === 0) return 0;
     const ids = items.map((item) => item._id);
-    const existingItems = await this.dexieDb.getByIds(collection, ids);
+    const existingItems = await this.dexieDb.getByIds(
+      collection,
+      ids
+    );
     const now = /* @__PURE__ */ new Date();
     const dirtyChangesBatch = [];
     const idsToDelete = [];
@@ -6077,7 +6304,13 @@ var _SyncedDb = class _SyncedDb {
         _deleted: now,
         _lastUpdaterId: this.updaterId
       };
-      this.pendingChanges.schedule(collection, item._id, deleteUpdate, 0, "deleteMany");
+      this.pendingChanges.schedule(
+        collection,
+        item._id,
+        deleteUpdate,
+        0,
+        "deleteMany"
+      );
       idsToDelete.push(item._id);
     }
     if (dirtyChangesBatch.length > 0) {
@@ -6105,11 +6338,19 @@ var _SyncedDb = class _SyncedDb {
       return null;
     }
     await this.connectionManager.withRestTimeout(
-      this.restInterface.call("hardDeleteOne", { collection, query: { _id: id } }),
+      this.restInterface.call("hardDeleteOne", {
+        collection,
+        query: { _id: id }
+      }),
       "hardDeleteOne"
     );
     await this.dexieDb.deleteOne(collection, id);
-    this.inMemManager.writeBatch(collection, [{ _id: id }], "delete", { source: "incremental" });
+    this.inMemManager.writeBatch(
+      collection,
+      [{ _id: id }],
+      "delete",
+      { source: "incremental" }
+    );
     return existing;
   }
   async hardDelete(collection, query) {
@@ -6121,7 +6362,9 @@ var _SyncedDb = class _SyncedDb {
     const items = await this.find(collection, query);
     if (items.length === 0) return 0;
     const existingItems = await Promise.all(
-      items.map((item) => this.dexieDb.getById(collection, item._id))
+      items.map(
+        (item) => this.dexieDb.getById(collection, item._id)
+      )
     );
     const toDelete = [];
     for (let i = 0; i < items.length; i++) {
@@ -6136,24 +6379,38 @@ var _SyncedDb = class _SyncedDb {
     const queue = [...toDelete];
     const results = [];
     await Promise.all(
-      Array.from({ length: Math.min(maxConcurrency, queue.length) }, async () => {
-        while (queue.length > 0) {
-          const item = queue.pop();
-          if (!item) break;
-          try {
-            await this.connectionManager.withRestTimeout(
-              this.restInterface.call("hardDeleteOne", { collection, query: { _id: item.id } }),
-              "hardDelete"
-            );
-            await this.dexieDb.deleteOne(collection, item.id);
-            this.inMemManager.writeBatch(collection, [{ _id: item.id }], "delete", { source: "incremental" });
-            results.push(true);
-          } catch (err) {
-            networkError(`[SyncedDb] Failed to hard delete ${String(item.id)}:`, err);
-            results.push(false);
+      Array.from(
+        { length: Math.min(maxConcurrency, queue.length) },
+        async () => {
+          while (queue.length > 0) {
+            const item = queue.pop();
+            if (!item) break;
+            try {
+              await this.connectionManager.withRestTimeout(
+                this.restInterface.call("hardDeleteOne", {
+                  collection,
+                  query: { _id: item.id }
+                }),
+                "hardDelete"
+              );
+              await this.dexieDb.deleteOne(collection, item.id);
+              this.inMemManager.writeBatch(
+                collection,
+                [{ _id: item.id }],
+                "delete",
+                { source: "incremental" }
+              );
+              results.push(true);
+            } catch (err) {
+              networkError(
+                `[SyncedDb] Failed to hard delete ${String(item.id)}:`,
+                err
+              );
+              results.push(false);
+            }
           }
         }
-      })
+      )
     );
     return results.filter(Boolean).length;
   }
@@ -6205,11 +6462,17 @@ var _SyncedDb = class _SyncedDb {
           const now = /* @__PURE__ */ new Date();
           if (!this._lastFullSyncDate) {
             this._setLastInitialSync(now).catch((err) => {
-              console.error(`[SyncedDb] Failed to persist lastInitialSync: ${err}`, err);
+              console.error(
+                `[SyncedDb] Failed to persist lastInitialSync: ${err}`,
+                err
+              );
             });
           }
           this._setLastFullSync(now).catch((err) => {
-            console.error(`[SyncedDb] Failed to persist lastFullSync: ${err}`, err);
+            console.error(
+              `[SyncedDb] Failed to persist lastFullSync: ${err}`,
+              err
+            );
           });
           if (consumingPendingFullResync) this._pendingFullResync = false;
         }
@@ -6363,10 +6626,18 @@ var _SyncedDb = class _SyncedDb {
       for (const [name] of this.collections) {
         const metas2 = await this.dexieDb.getDirtyMeta(name);
         if (metas2.length === 0) continue;
+        const ids2 = metas2.map((m) => m.id);
+        const changesMap = await this.dexieDb.getDirtyChangesBatch(name, ids2);
+        const items = metas2.map(
+          (m) => {
+            var _a;
+            return (_a = changesMap.get(m.id)) != null ? _a : __spreadProps(__spreadValues({}, m), { changes: {} });
+          }
+        );
         this.safeCallback(this.onBeforeDirtyClearAll, {
           reason: calledFrom != null ? calledFrom : "manual",
           collection: name,
-          items: metas2,
+          items,
           calledFrom,
           timestamp: /* @__PURE__ */ new Date()
         });
@@ -6429,10 +6700,19 @@ var _SyncedDb = class _SyncedDb {
       const metas = await this.dexieDb.getDirtyMeta(collectionName);
       const stuck = metas.filter((m) => m.stuckSince !== void 0);
       if (stuck.length === 0) continue;
+      const stuckIds = stuck.map((m) => m.id);
+      const changesMap = await this.dexieDb.getDirtyChangesBatch(
+        collectionName,
+        stuckIds
+      );
+      const content = stuck.map((m) => {
+        const entry = changesMap.get(m.id);
+        return entry != null ? entry : __spreadProps(__spreadValues({}, m), { changes: {} });
+      });
       this.safeCallback(this.onBeforeDirtyClearAll, {
         reason: "discard-stuck",
         collection: collectionName,
-        items: stuck,
+        items: content,
         calledFrom,
         timestamp: /* @__PURE__ */ new Date()
       });
@@ -6478,7 +6758,9 @@ var _SyncedDb = class _SyncedDb {
   }
   async dropDatabase(force = false) {
     if (!force && (this.connectionManager.isForcedOffline() || !this.connectionManager.isOnline())) {
-      throw new Error("Cannot drop database: database is offline. Use force=true to drop anyway.");
+      throw new Error(
+        "Cannot drop database: database is offline. Use force=true to drop anyway."
+      );
     }
     await this.pendingChanges.flushAll();
     const collectionNames = Array.from(this.collections.keys());
@@ -6486,7 +6768,10 @@ var _SyncedDb = class _SyncedDb {
     for (const collectionName of collectionNames) {
       const dirtyItems = await this.dexieDb.getDirty(collectionName);
       if (dirtyItems.length > 0) {
-        dirtyCollections.push({ name: collectionName, count: dirtyItems.length });
+        dirtyCollections.push({
+          name: collectionName,
+          count: dirtyItems.length
+        });
       }
     }
     if (dirtyCollections.length > 0) {
@@ -6764,7 +7049,11 @@ var _SyncedDb = class _SyncedDb {
         );
         serverRounds = 1;
         for (const [specId, items] of Object.entries(results)) {
-          this._applyScopeExitChunkToPlan(plan, specId, items);
+          this._applyScopeExitChunkToPlan(
+            plan,
+            specId,
+            items
+          );
         }
       } catch (err) {
         serverFailed = true;
@@ -7067,7 +7356,8 @@ var _SyncedDb = class _SyncedDb {
     const config = this.collections.get(collection);
     if (!config) return false;
     if (config.writeOnly) return false;
-    if (this.syncOnlyCollections && !this.syncOnlyCollections.has(collection)) return false;
+    if (this.syncOnlyCollections && !this.syncOnlyCollections.has(collection))
+      return false;
     return true;
   }
   /**
@@ -7142,7 +7432,11 @@ var _SyncedDb = class _SyncedDb {
     var _a;
     try {
       const count = await this._hydrateCollectionFromDexie(name);
-      this.preloadStatusMap.set(name, { state: "hydrated", itemCount: count, hydratedAt: /* @__PURE__ */ new Date() });
+      this.preloadStatusMap.set(name, {
+        state: "hydrated",
+        itemCount: count,
+        hydratedAt: /* @__PURE__ */ new Date()
+      });
       this.emitPreloadStatusChange();
       return count;
     } catch (err) {
@@ -7169,7 +7463,10 @@ var _SyncedDb = class _SyncedDb {
     let pendingCount = 0;
     for (const name of this.collections.keys()) {
       if (!this.isSyncAllowed(name)) continue;
-      const rec = (_a = this.preloadStatusMap.get(name)) != null ? _a : { state: "pending", itemCount: 0 };
+      const rec = (_a = this.preloadStatusMap.get(name)) != null ? _a : {
+        state: "pending",
+        itemCount: 0
+      };
       const everDownloaded = !!((_b = this.syncMetaCache.get(name)) == null ? void 0 : _b.lastSyncTs);
       const ready = rec.state === "hydrated";
       if (rec.state === "failed") failedCount++;
@@ -7191,22 +7488,34 @@ var _SyncedDb = class _SyncedDb {
     else if (readyCount === expectedCount) aggregate = "full";
     else if (failedCount === expectedCount) aggregate = "failed";
     else aggregate = "partial";
-    return { aggregate, collections, expectedCount, readyCount, failedCount, pendingCount };
+    return {
+      aggregate,
+      collections,
+      expectedCount,
+      readyCount,
+      failedCount,
+      pendingCount
+    };
   }
   /** Emit onPreloadStatusChange with a fresh snapshot (skips computation when no listener). */
   emitPreloadStatusChange() {
-    if (this.onPreloadStatusChange) this.safeCallback(this.onPreloadStatusChange, this.getPreloadStatus());
+    if (this.onPreloadStatusChange)
+      this.safeCallback(this.onPreloadStatusChange, this.getPreloadStatus());
   }
   async _hydrateCollectionFromDexie(name) {
     const allItems = [];
-    await this.dexieDb.forEachBatch(name, 2e3, async (chunk) => {
-      for (let i = 0; i < chunk.length; i++) {
-        const item = chunk[i];
-        if (!item._deleted && !item._archived) {
-          allItems.push(item);
+    await this.dexieDb.forEachBatch(
+      name,
+      2e3,
+      async (chunk) => {
+        for (let i = 0; i < chunk.length; i++) {
+          const item = chunk[i];
+          if (!item._deleted && !item._archived) {
+            allItems.push(item);
+          }
         }
       }
-    });
+    );
     const dirty = await this.dexieDb.getDirty(name);
     if (dirty.length > 0) {
       const itemById = /* @__PURE__ */ new Map();
@@ -7275,7 +7584,9 @@ var _SyncedDb = class _SyncedDb {
   }
   assertCollection(name) {
     if (!this.collections.has(name)) {
-      throw new Error(`SyncedDb: Collection "${(name == null ? void 0 : name.toString()) || "?"}" not configured`);
+      throw new Error(
+        `SyncedDb: Collection "${(name == null ? void 0 : name.toString()) || "?"}" not configured`
+      );
     }
   }
   /**
@@ -7405,7 +7716,8 @@ var _SyncedDb = class _SyncedDb {
     if (_SyncedDb.isObjectIdLike(data)) return String(data);
     if (typeof data !== "object") return data;
     if (data instanceof Date) return data;
-    if (Array.isArray(data)) return data.map((v) => _SyncedDb.stringifyObjectIds(v));
+    if (Array.isArray(data))
+      return data.map((v) => _SyncedDb.stringifyObjectIds(v));
     const result = {};
     for (const key of Object.keys(data)) {
       result[key] = _SyncedDb.stringifyObjectIds(data[key]);

package/dist/src/types/I_SyncedDb.d.ts

@@ -121,8 +121,8 @@ export interface BeforeDirtyClearAllInfo {
     reason: string;
     /** Collection whose dirty entries are about to be deleted. */
     collection: string;
-    /** Meta of every dirty entry in this collection (no `changes` payload). */
-    items: import("./I_DexieDb").DirtyMeta[];
+    /** Every dirty entry in this collection — includes both metadata and the `changes` payload. */
+    items: import("./I_DexieDb").DirtyChange[];
     /** Optional caller tag passed through `clearDirty(undefined, undefined, calledFrom)`. */
     calledFrom?: string;
     /** Timestamp when the callback fires. */
@@ -648,7 +648,7 @@ export interface SyncedDbConfig {
      * `loaded`/`total` are scoped to the phase that emitted the event.
      */
     onSyncProgress?: (info: {
-        phase: 'dexie' | 'server';
+        phase: "dexie" | "server";
         collection: string;
         loaded: number;
         total: number;

package/package.json

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