cry-synced-db-client 0.1.200 → 0.1.202

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # 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`

package/dist/index.js

@@ -4902,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,
@@ -4916,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
+              );
             }
           }
         },
@@ -5026,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,
@@ -5168,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`.
@@ -5205,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);
@@ -5267,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}":`,
@@ -5306,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
+      });
     }
   }
   /**
@@ -5332,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(() => {
@@ -5374,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();
@@ -5410,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`,
@@ -5432,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();
@@ -5548,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
+        );
       });
     }
   }
@@ -5622,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();
@@ -5702,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) {
@@ -5775,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) {
@@ -5818,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;
@@ -5836,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;
     }
   }
@@ -5889,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) {
     }
@@ -5911,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);
@@ -5943,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 = [];
@@ -5971,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" }
+      );
     }
   }
   /**
@@ -6002,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) {
@@ -6032,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 ====================
@@ -6077,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(
@@ -6091,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;
   }
@@ -6138,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;
   }
@@ -6162,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;
   }
@@ -6172,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 = [];
@@ -6189,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) {
@@ -6217,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) {
@@ -6233,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++) {
@@ -6248,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;
   }
@@ -6317,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;
         }
@@ -6475,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()
         });
@@ -6541,10 +6700,34 @@ 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 allDirty = await this.dexieDb.getDirty(collectionName);
+      const content = stuck.map((m) => {
+        const dirtyId = String(m.id);
+        const found = allDirty.find(
+          (d) => String(d._id) === dirtyId
+        );
+        if (found) {
+          const _a = found, { _id, _ts, _rev } = _a, changedFields = __objRest(_a, ["_id", "_ts", "_rev"]);
+          return {
+            collection: collectionName,
+            id: dirtyId,
+            changes: changedFields,
+            baseTs: _ts,
+            baseRev: _rev,
+            createdAt: m.createdAt,
+            updatedAt: m.updatedAt,
+            firstUploadAttempt: m.firstUploadAttempt,
+            lastUploadAttempt: m.lastUploadAttempt,
+            numUploadAttempts: m.numUploadAttempts,
+            stuckSince: m.stuckSince
+          };
+        }
+        return __spreadProps(__spreadValues({}, m), { changes: {} });
+      });
       this.safeCallback(this.onBeforeDirtyClearAll, {
         reason: "discard-stuck",
         collection: collectionName,
-        items: stuck,
+        items: content,
         calledFrom,
         timestamp: /* @__PURE__ */ new Date()
       });
@@ -6590,7 +6773,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());
@@ -6598,7 +6783,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) {
@@ -6876,7 +7064,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;
@@ -7179,7 +7371,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;
   }
   /**
@@ -7254,7 +7447,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) {
@@ -7281,7 +7478,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++;
@@ -7303,22 +7503,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();
@@ -7387,7 +7599,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`
+      );
     }
   }
   /**
@@ -7517,7 +7731,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.200",
+  "version": "0.1.202",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",