cry-synced-db-client 0.1.170 → 0.1.172

package/dist/index.js

@@ -600,6 +600,17 @@ function canExpandArrayToBrackets(value) {
   }
   return true;
 }
+function pickLayerTarget(newPath, newValue) {
+  if (!isTerminalBracketKey(newPath)) return null;
+  if (newValue === void 0) return null;
+  if (Array.isArray(newValue) && newValue.length === 1 && newValue[0] && typeof newValue[0] === "object") {
+    return newValue[0];
+  }
+  if (newValue && typeof newValue === "object" && !Array.isArray(newValue)) {
+    return newValue;
+  }
+  return null;
+}
 function mergeDirtyPath(accumulated, newPath, newValue) {
   for (const existingKey of Object.keys(accumulated)) {
     if (existingKey === newPath) continue;
@@ -628,14 +639,27 @@ function mergeDirtyPath(accumulated, newPath, newValue) {
       break;
     }
   }
-  const toDelete = [];
+  const descendants = [];
   for (const existingKey of Object.keys(accumulated)) {
     if (existingKey === newPath) continue;
     if (isDescendantOrEqual(existingKey, newPath)) {
-      toDelete.push(existingKey);
+      descendants.push(existingKey);
+    }
+  }
+  const layerInto = pickLayerTarget(newPath, newValue);
+  if (layerInto && descendants.length > 0) {
+    for (const desc of descendants) {
+      const sepChar = desc[newPath.length];
+      const relativePath = sepChar === "[" ? desc.substring(newPath.length) : desc.substring(newPath.length + 1);
+      const descValue = accumulated[desc];
+      if (descValue === void 0) {
+        deleteByPath(layerInto, relativePath);
+      } else {
+        setByPath(layerInto, relativePath, descValue);
+      }
     }
   }
-  for (const k of toDelete) delete accumulated[k];
+  for (const k of descendants) delete accumulated[k];
   accumulated[newPath] = newValue;
 }
 function mergeDirtyChanges(accumulated, newChanges) {
@@ -722,14 +746,14 @@ var InMemManager = class {
           try {
             metadatas = config.onObjectsUpdated(items);
           } catch (err) {
-            console.error("onObjectsUpdated callback failed:", err);
+            console.error("[InMem] onObjectsUpdated callback failed:", err);
             return;
           }
         } else if (config.onObjectUpdated) {
           try {
             metadatas = items.map((item) => config.onObjectUpdated(item));
           } catch (err) {
-            console.error("onObjectUpdated callback failed:", err);
+            console.error("[InMem] onObjectUpdated callback failed:", err);
             return;
           }
         } else {
@@ -762,14 +786,14 @@ var InMemManager = class {
           try {
             metadatas = config.onObjectsUpdated(items);
           } catch (err) {
-            console.error("onObjectsUpdated callback failed:", err);
+            console.error("[InMem] onObjectsUpdated callback failed:", err);
             return;
           }
         } else if (config.onObjectUpdated) {
           try {
             metadatas = items.map((item) => config.onObjectUpdated(item));
           } catch (err) {
-            console.error("onObjectUpdated callback failed:", err);
+            console.error("[InMem] onObjectUpdated callback failed:", err);
             return;
           }
         } else {
@@ -876,6 +900,7 @@ var LeaderElectionManager = class {
     this.isLeaderFlag = false;
     this.closing = false;
     this.releasingDueToVisibility = false;
+    this._followerSince = /* @__PURE__ */ new Date();
     this.tenant = config.tenant;
     this.windowId = config.windowId;
     this.callbacks = config.callbacks;
@@ -973,6 +998,21 @@ var LeaderElectionManager = class {
   isLeader() {
     return this.isLeaderFlag;
   }
+  /**
+   * Returns the timestamp when this tab became leader, or undefined if currently a follower.
+   * Cleared on transition to follower.
+   */
+  leaderSince() {
+    return this._leaderSince;
+  }
+  /**
+   * Returns the timestamp when this tab became follower, or undefined if currently a leader.
+   * Initialized at construction (every tab starts as a follower until it claims the lock).
+   * Cleared on transition to leader.
+   */
+  followerSince() {
+    return this._followerSince;
+  }
   /**
    * Cleanup resources.
    */
@@ -1019,25 +1059,29 @@ var LeaderElectionManager = class {
       try {
         this.leaderReelectionChannel.postMessage({ type: "reelect-leader" });
       } catch (err) {
-        console.error("Failed to broadcast leader reelection:", err);
+        console.error("[LeaderElection] Failed to broadcast leader reelection:", err);
       }
     }
   }
   callOnBecameLeader() {
+    this._leaderSince = /* @__PURE__ */ new Date();
+    this._followerSince = void 0;
     if (this.callbacks.onBecameLeader) {
       try {
         this.callbacks.onBecameLeader();
       } catch (err) {
-        console.error("onBecameLeader callback failed:", err);
+        console.error("[LeaderElection] onBecameLeader callback failed:", err);
       }
     }
   }
   callOnLostLeadership() {
+    this._followerSince = /* @__PURE__ */ new Date();
+    this._leaderSince = void 0;
     if (this.callbacks.onLostLeadership) {
       try {
         this.callbacks.onLostLeadership();
       } catch (err) {
-        console.error("onLostLeadership callback failed:", err);
+        console.error("[LeaderElection] onLostLeadership callback failed:", err);
       }
     }
   }
@@ -1046,7 +1090,7 @@ var LeaderElectionManager = class {
       try {
         this.callbacks.onInfrastructureError(type, message, error);
       } catch (err) {
-        console.error("onInfrastructureError callback failed:", err);
+        console.error("[LeaderElection] onInfrastructureError callback failed:", err);
       }
     }
   }
@@ -1171,7 +1215,7 @@ var CrossTabSyncManager = class {
       try {
         this.metaUpdateChannel.postMessage(payload);
       } catch (err) {
-        console.error("Failed to broadcast meta update:", err);
+        console.error("[CrossTabSync] Failed to broadcast meta update:", err);
       }
     }
     this.pendingBroadcasts.clear();
@@ -1217,7 +1261,7 @@ var CrossTabSyncManager = class {
       try {
         await this.deps.reloadCollectionFromDexie(collection);
       } catch (err) {
-        console.error(`Error reloading collection ${collection} from Dexie:`, err);
+        console.error(`[CrossTabSync] Error reloading collection ${collection} from Dexie:`, err);
       }
     }
   }
@@ -1265,11 +1309,11 @@ var CrossTabSyncManager = class {
             };
             this.callbacks.onCrossTabSync(info);
           } catch (err) {
-            console.error("onCrossTabSync callback failed:", err);
+            console.error("[CrossTabSync] onCrossTabSync callback failed:", err);
           }
         }
       } catch (err) {
-        console.error(`Error handling cross-tab delta update for ${collection}:`, err);
+        console.error(`[CrossTabSync] Error handling cross-tab delta update for ${collection}:`, err);
       }
     }
   }
@@ -1285,7 +1329,7 @@ var CrossTabSyncManager = class {
     try {
       this.metaUpdateChannel.postMessage(payload);
     } catch (err) {
-      console.error("Failed to broadcast reload:", err);
+      console.error("[CrossTabSync] Failed to broadcast reload:", err);
     }
   }
   callOnInfrastructureError(type, message, error) {
@@ -1293,7 +1337,7 @@ var CrossTabSyncManager = class {
       try {
         this.callbacks.onInfrastructureError(type, message, error);
       } catch (err) {
-        console.error("onInfrastructureError callback failed:", err);
+        console.error("[CrossTabSync] onInfrastructureError callback failed:", err);
       }
     }
   }
@@ -1359,7 +1403,7 @@ var ConnectionManager = class {
     } else {
       this.deps.tryBecomeLeader();
       this.tryGoOnline().catch((err) => {
-        console.error("Failed to go online after forceOffline release:", err);
+        console.error("[Connection] Failed to go online after forceOffline release:", err);
       });
     }
   }
@@ -1383,13 +1427,13 @@ var ConnectionManager = class {
             "ping"
           );
         } catch (err) {
-          console.warn("tryGoOnline: ping failed:", err);
+          console.warn("[Connection] tryGoOnline: ping failed:", err);
           this.online = false;
           return;
         }
         if (!pingResult) {
           const url = (_a = this.restInterface.endpoint) != null ? _a : "unknown";
-          console.warn(`Ping to ${url} failed - staying offline`);
+          console.warn(`[Connection] Ping to ${url} failed - staying offline`);
           return;
         }
         this.online = true;
@@ -1401,7 +1445,7 @@ var ConnectionManager = class {
       try {
         await this.deps.sync("INITIAL SYNC");
       } catch (err) {
-        console.warn("INITIAL SYNC after tryGoOnline failed (stays online):", err);
+        console.warn("[Connection] INITIAL SYNC after tryGoOnline failed (stays online):", err);
       }
     } finally {
       this.tryGoOnlineInFlight = false;
@@ -1417,7 +1461,7 @@ var ConnectionManager = class {
       this.autoSyncTimer = setInterval(() => {
         if (this.forcedOffline || !this.online) return;
         this.deps.sync(`interval ${intervalMs}ms`).catch((err) => {
-          console.error("Auto-sync failed:", err);
+          console.error("[Connection] Auto-sync failed:", err);
         });
       }, intervalMs);
     }
@@ -1426,7 +1470,7 @@ var ConnectionManager = class {
       this.reconnectTimer = setInterval(() => {
         if (this.forcedOffline || this.online || this.tryGoOnlineInFlight) return;
         this.tryGoOnline().catch((err) => {
-          console.error("Reconnect tryGoOnline failed:", err);
+          console.error("[Connection] Reconnect tryGoOnline failed:", err);
         });
       }, retryMs);
     }
@@ -1510,7 +1554,7 @@ var ConnectionManager = class {
       try {
         this.callbacks.onInfrastructureError(type, message, error);
       } catch (err) {
-        console.error("onInfrastructureError callback failed:", err);
+        console.error("[Connection] onInfrastructureError callback failed:", err);
       }
     }
   }
@@ -1523,7 +1567,7 @@ var ConnectionManager = class {
       try {
         this.callbacks.onSyncFailed(reason);
       } catch (err) {
-        console.error("onSyncFailed callback failed:", err);
+        console.error("[Connection] onSyncFailed callback failed:", err);
       }
     }
   }
@@ -1535,7 +1579,7 @@ var ConnectionManager = class {
       try {
         this.callbacks.onWsConnect();
       } catch (err) {
-        console.error("onWsConnect callback failed:", err);
+        console.error("[Connection] onWsConnect callback failed:", err);
       }
     }
   }
@@ -1547,7 +1591,7 @@ var ConnectionManager = class {
       try {
         this.callbacks.onWsDisconnect(reason);
       } catch (err) {
-        console.error("onWsDisconnect callback failed:", err);
+        console.error("[Connection] onWsDisconnect callback failed:", err);
       }
     }
     this.reportInfrastructureError(
@@ -1563,7 +1607,7 @@ var ConnectionManager = class {
       try {
         this.callbacks.onWsReconnect(attempt);
       } catch (err) {
-        console.error("onWsReconnect callback failed:", err);
+        console.error("[Connection] onWsReconnect callback failed:", err);
       }
     }
   }
@@ -2430,7 +2474,7 @@ function savePendingWrite(tenant, collection, id, delta) {
     }
     localStorage.setItem(key, dist_default.stringify(pending));
   } catch (e) {
-    console.warn("Failed to save pending write to localStorage");
+    console.warn("[CrashRecovery] Failed to save pending write to localStorage");
   }
 }
 function clearPendingWrite(tenant, collection, id) {
@@ -2612,7 +2656,7 @@ var PendingChangesManager = class {
           clearPendingWrite(this.tenant, write.collection, write.id);
         }
       } catch (err) {
-        console.error(`Failed to recover pending writes for ${collection}:`, err);
+        console.error(`[PendingChanges] Failed to recover pending writes for ${collection}:`, err);
       }
     }
   }
@@ -2662,7 +2706,7 @@ var PendingChangesManager = class {
             calledFrom: pending.calledFrom
           });
         } catch (err) {
-          console.error("onDexieWriteRequest callback failed:", err);
+          console.error("[PendingChanges] onDexieWriteRequest callback failed:", err);
         }
       }
       if (existing) {
@@ -2677,7 +2721,7 @@ var PendingChangesManager = class {
           // ensure _id is after spread
         });
         if (typeof insertData._id === "object") {
-          console.error(`Dexie: _id is object type in ${pending.collection}:`, typeof insertData._id, insertData._id);
+          console.error(`[PendingChanges] Dexie: _id is object type in ${pending.collection}:`, typeof insertData._id, insertData._id);
         }
         await this.deps.dexieDb.insert(pending.collection, insertData);
       }
@@ -2691,7 +2735,7 @@ var PendingChangesManager = class {
             calledFrom: pending.calledFrom
           });
         } catch (err) {
-          console.error("onDexieWriteResult callback failed:", err);
+          console.error("[PendingChanges] onDexieWriteResult callback failed:", err);
         }
       }
       clearPendingWrite(this.tenant, pending.collection, pending.id);
@@ -2705,12 +2749,12 @@ var PendingChangesManager = class {
             calledFrom: pending.calledFrom
           });
         } catch (err) {
-          console.error("onLocalstorageWriteResult callback failed:", err);
+          console.error("[PendingChanges] onLocalstorageWriteResult callback failed:", err);
         }
       }
       this.scheduleRestUpload();
     } catch (err) {
-      console.error("Failed to write to Dexie:", err);
+      console.error("[PendingChanges] Failed to write to Dexie:", err);
       if (this.callbacks.onDexieWriteResult) {
         try {
           this.callbacks.onDexieWriteResult({
@@ -2722,13 +2766,13 @@ var PendingChangesManager = class {
             calledFrom: pending.calledFrom
           });
         } catch (callbackErr) {
-          console.error("onDexieWriteResult callback failed:", callbackErr);
+          console.error("[PendingChanges] onDexieWriteResult callback failed:", callbackErr);
         }
       }
       const newRetryCount = pending.retryCount + 1;
       if (newRetryCount >= MAX_RETRY_COUNT) {
         console.error(
-          `Max retry count (${MAX_RETRY_COUNT}) reached for pending change ${key}. Data remains in localStorage for crash recovery.`
+          `[PendingChanges] Max retry count (${MAX_RETRY_COUNT}) reached for pending change ${key}. Data remains in localStorage for crash recovery.`
         );
         return;
       }
@@ -2764,7 +2808,7 @@ var PendingChangesManager = class {
     try {
       await this.deps.uploadDirtyItems();
     } catch (err) {
-      console.error("REST upload failed:", err);
+      console.error("[PendingChanges] REST upload failed:", err);
     } finally {
       this.isUploadingToRest = false;
       resolveUpload();
@@ -2841,10 +2885,6 @@ function mergeObjectArrays(local, external, parentServerWins = false) {
   }
   if (objectItemsMissingId.length > 0) {
     for (const item of objectItemsMissingId) {
-      console.error(
-        "[mergeObjectArrays] array element without _id \u2014 falling back to whole-array replace by higher _rev:",
-        item
-      );
     }
     return parentServerWins ? external.slice() : local.slice();
   }
@@ -2972,6 +3012,7 @@ function stripServerManagedFromChanges(changes) {
 }
 
 // src/db/sync/SyncEngine.ts
+var SUPRESS_DB_WARNINGS = false;
 var _SyncEngine = class _SyncEngine {
   constructor(config) {
     this.tenant = config.tenant;
@@ -3119,7 +3160,7 @@ var _SyncEngine = class _SyncEngine {
         }
       } catch (err) {
         console.error(
-          "uploadDirtyItems failed (download succeeded, staying online):",
+          "[SyncEngine] uploadDirtyItems failed (download succeeded, staying online):",
           err
         );
       }
@@ -3145,7 +3186,7 @@ var _SyncEngine = class _SyncEngine {
       });
     } catch (err) {
       const reason = err instanceof Error ? err.message : String(err);
-      console.error("Sync failed:", err);
+      console.error("[SyncEngine] Sync failed:", err);
       this.deps.onSyncFailed(`Sync failed: ${reason}`);
       this.callOnSyncEnd({
         durationMs: Date.now() - startTime,
@@ -3203,7 +3244,7 @@ var _SyncEngine = class _SyncEngine {
       }
       if (updates.length === 0) {
         console.warn(
-          `uploadDirtyItems: ${collectionName} has ${dirtyChanges.length} dirty entries but 0 resolvable items`,
+          `[SyncEngine] uploadDirtyItems: ${collectionName} has ${dirtyChanges.length} dirty entries but 0 resolvable items`,
           skipped
         );
         if (this.callbacks.onUploadSkip) {
@@ -3218,7 +3259,7 @@ var _SyncEngine = class _SyncEngine {
               timestamp: /* @__PURE__ */ new Date()
             });
           } catch (err) {
-            console.error("onUploadSkip callback failed:", err);
+            console.error("[SyncEngine] onUploadSkip callback failed:", err);
           }
         }
         continue;
@@ -3235,7 +3276,7 @@ var _SyncEngine = class _SyncEngine {
             timestamp: /* @__PURE__ */ new Date()
           });
         } catch (err) {
-          console.error("onUploadSkip callback failed:", err);
+          console.error("[SyncEngine] onUploadSkip callback failed:", err);
         }
       }
       collectionBatches.push([{
@@ -3332,7 +3373,7 @@ var _SyncEngine = class _SyncEngine {
       }
       if (ambiguous.length > 0) {
         console.error(
-          `Sync upload [${collection}]: ${ambiguous.length} id(s) appeared in BOTH inserted/updated/deleted AND errors[] \u2014 keeping dirty for safety. _ids: ${ambiguous.join(", ")}`
+          `[SyncEngine] Sync upload [${collection}]: ${ambiguous.length} id(s) appeared in BOTH inserted/updated/deleted AND errors[] \u2014 keeping dirty for safety. _ids: ${ambiguous.join(", ")}`
         );
       }
       if (allSuccessIds.length > 0) {
@@ -3430,14 +3471,14 @@ var _SyncEngine = class _SyncEngine {
       if (errors2 && errors2.length > 0) {
         for (const e of errors2) {
           console.error(
-            `Sync upload error [${collection}] _id=${e._id}: ${e.error} \u2014 dirty entry will persist until retry`
+            `[SyncEngine] Sync upload error [${collection}] _id=${e._id}: ${e.error} \u2014 dirty entry will persist until retry`
           );
         }
       }
-      if (warnings && warnings.length > 0) {
+      if (warnings && warnings.length > 0 && !SUPRESS_DB_WARNINGS) {
         for (const w of warnings) {
-          console.warn(
-            `Sync upload warning [${collection}] _id=${w._id}: ${w.error}`
+          console.error(
+            `[SyncEngine] DB-WARNING [${collection}] _id=${w._id}: ${w.error}`
           );
         }
       }
@@ -3451,7 +3492,7 @@ var _SyncEngine = class _SyncEngine {
       const unacked = [...sentIds].filter((id) => !ackIds.has(id));
       if (unacked.length > 0) {
         console.warn(
-          `uploadDirtyItems: ${collection}: ${unacked.length} items sent but not acknowledged:`,
+          `[SyncEngine] uploadDirtyItems: ${collection}: ${unacked.length} items sent but not acknowledged:`,
           unacked
         );
       }
@@ -3507,14 +3548,14 @@ var _SyncEngine = class _SyncEngine {
         for (const e of errors2) {
           erroredIds.add(String(e._id));
           console.error(
-            `Sync upload error [${collection}] _id=${e._id}: ${e.error} \u2014 dirty entry will persist until retry`
+            `[SyncEngine] Sync upload error [${collection}] _id=${e._id}: ${e.error} \u2014 dirty entry will persist until retry`
           );
         }
       }
-      if (warnings && warnings.length > 0) {
+      if (warnings && warnings.length > 0 && !SUPRESS_DB_WARNINGS) {
         for (const w of warnings) {
-          console.warn(
-            `Sync upload warning [${collection}] _id=${w._id}: ${w.error}`
+          console.error(
+            `[SyncEngine] DB-WARNING [${collection}] _id=${w._id}: ${w.error}`
           );
         }
       }
@@ -3546,7 +3587,7 @@ var _SyncEngine = class _SyncEngine {
       }
       if (ambiguous.length > 0) {
         console.error(
-          `Sync upload [${collection}]: ${ambiguous.length} id(s) appeared in BOTH inserted/updated/deleted AND errors[] \u2014 keeping dirty for safety. _ids: ${ambiguous.join(", ")}`
+          `[SyncEngine] Sync upload [${collection}]: ${ambiguous.length} id(s) appeared in BOTH inserted/updated/deleted AND errors[] \u2014 keeping dirty for safety. _ids: ${ambiguous.join(", ")}`
         );
       }
       if (allSuccessIds.length > 0) {
@@ -3685,7 +3726,7 @@ var _SyncEngine = class _SyncEngine {
           timestamp: /* @__PURE__ */ new Date()
         });
       } catch (err) {
-        console.error("onConflictResolved callback failed:", err);
+        console.error("[SyncEngine] onConflictResolved callback failed:", err);
       }
     }
     return resolved;
@@ -3699,7 +3740,7 @@ var _SyncEngine = class _SyncEngine {
       try {
         fn(info);
       } catch (err) {
-        console.error("Callback failed:", err);
+        console.error("[SyncEngine] Callback failed:", err);
       }
     }
   }
@@ -3708,7 +3749,7 @@ var _SyncEngine = class _SyncEngine {
       try {
         this.callbacks.onSyncStart(info);
       } catch (err) {
-        console.error("onSyncStart callback failed:", err);
+        console.error("[SyncEngine] onSyncStart callback failed:", err);
       }
     }
   }
@@ -3717,7 +3758,7 @@ var _SyncEngine = class _SyncEngine {
       try {
         this.callbacks.onSyncEnd(info);
       } catch (err) {
-        console.error("onSyncEnd callback failed:", err);
+        console.error("[SyncEngine] onSyncEnd callback failed:", err);
       }
     }
   }
@@ -3730,7 +3771,7 @@ var _SyncEngine = class _SyncEngine {
           calledFrom
         });
       } catch (err) {
-        console.error("onFindNewerManyCall callback failed:", err);
+        console.error("[SyncEngine] onFindNewerManyCall callback failed:", err);
       }
     }
   }
@@ -3746,7 +3787,7 @@ var _SyncEngine = class _SyncEngine {
           calledFrom
         });
       } catch (err) {
-        console.error("onFindNewerManyResult callback failed:", err);
+        console.error("[SyncEngine] onFindNewerManyResult callback failed:", err);
       }
     }
   }
@@ -3759,7 +3800,7 @@ var _SyncEngine = class _SyncEngine {
           calledFrom
         });
       } catch (err) {
-        console.error("onServerWriteRequest callback failed:", err);
+        console.error("[SyncEngine] onServerWriteRequest callback failed:", err);
       }
     }
   }
@@ -3774,7 +3815,7 @@ var _SyncEngine = class _SyncEngine {
           calledFrom
         });
       } catch (err) {
-        console.error("onServerWriteResult callback failed:", err);
+        console.error("[SyncEngine] onServerWriteResult callback failed:", err);
       }
     }
   }
@@ -3795,7 +3836,7 @@ var _SyncEngine = class _SyncEngine {
         timestamp
       });
     } catch (err) {
-      console.error("onServerSyncWrite callback failed:", err);
+      console.error("[SyncEngine] onServerSyncWrite callback failed:", err);
     }
   }
 };
@@ -4060,7 +4101,7 @@ var ServerUpdateHandler = class {
           timestamp: /* @__PURE__ */ new Date()
         });
       } catch (err) {
-        console.error("onWsNotification callback failed:", err);
+        console.error("[ServerUpdateHandler] onWsNotification callback failed:", err);
       }
     }
   }
@@ -4142,11 +4183,11 @@ var WakeSyncManager = class {
             timestamp: /* @__PURE__ */ new Date()
           });
         } catch (err) {
-          console.error("onWakeSync callback failed:", err);
+          console.error("[WakeSync] onWakeSync callback failed:", err);
         }
       }
       this.deps.sync(`wake-sync:${trigger}`).catch((err) => {
-        console.error(`Wake sync (${trigger}) failed:`, err);
+        console.error(`[WakeSync] Wake sync (${trigger}) failed:`, err);
       });
     }, this.debounceMs);
   }
@@ -4215,7 +4256,7 @@ var NetworkStatusManager = class {
         try {
           this.callbacks.onBrowserNetworkChange(info);
         } catch (err) {
-          console.error("onBrowserNetworkChange callback failed:", err);
+          console.error("[NetworkStatus] onBrowserNetworkChange callback failed:", err);
         }
       }
       if (finalOnlineState) {
@@ -4223,7 +4264,7 @@ var NetworkStatusManager = class {
           try {
             this.callbacks.onBrowserOnline();
           } catch (err) {
-            console.error("onBrowserOnline callback failed:", err);
+            console.error("[NetworkStatus] onBrowserOnline callback failed:", err);
           }
         }
       } else {
@@ -4231,12 +4272,12 @@ var NetworkStatusManager = class {
           try {
             this.callbacks.onBrowserOffline();
           } catch (err) {
-            console.error("onBrowserOffline callback failed:", err);
+            console.error("[NetworkStatus] onBrowserOffline callback failed:", err);
           }
         }
       }
       this.deps.setOnline(finalOnlineState).catch((err) => {
-        console.error("Failed to set online status:", err);
+        console.error("[NetworkStatus] Failed to set online status:", err);
       });
     }, this.debounceMs);
   }
@@ -4301,14 +4342,14 @@ var _SyncedDb = class _SyncedDb {
         onBecameLeader: () => {
           if (this.initialized && !this.connectionManager.isOnline() && !this.connectionManager.isForcedOffline()) {
             this.connectionManager.tryGoOnline().catch((err) => {
-              console.error("tryGoOnline on becameLeader failed:", err);
+              console.error("[SyncedDb] tryGoOnline on becameLeader failed:", err);
             });
           }
           if (config.onBecameLeader) {
             try {
               config.onBecameLeader();
             } catch (err) {
-              console.error("onBecameLeader callback failed:", err);
+              console.error("[SyncedDb] onBecameLeader callback failed:", err);
             }
           }
         },
@@ -4499,6 +4540,55 @@ var _SyncedDb = class _SyncedDb {
   isLeaderTab() {
     return this.leaderElection.isLeader();
   }
+  leaderSince() {
+    return this.leaderElection.leaderSince();
+  }
+  followerSince() {
+    return this.leaderElection.followerSince();
+  }
+  /**
+   * Register a collection for sync at runtime. See `I_SyncedDb.addCollectionToSync`.
+   */
+  async addCollectionToSync(spec) {
+    const existing = this.collections.get(spec.name);
+    if (existing && !existing.temporaryConfig) {
+      return;
+    }
+    await this._installCollectionConfig(spec);
+  }
+  /**
+   * Replace the collection config and re-sync. See `I_SyncedDb.replaceSyncCollection`.
+   */
+  async replaceSyncCollection(spec) {
+    const existing = this.collections.get(spec.name);
+    if (existing && !existing.temporaryConfig && spec.temporaryConfig) {
+      return false;
+    }
+    await this._installCollectionConfig(spec);
+    return true;
+  }
+  /**
+   * Shared install path for addCollectionToSync / replaceSyncCollection:
+   * write config, extend active sync filter, load Dexie cursor + in-mem,
+   * fire a targeted one-shot download for just this collection.
+   */
+  async _installCollectionConfig(spec) {
+    var _a;
+    this.collections.set(spec.name, spec);
+    if (this.syncOnlyCollections) {
+      this.syncOnlyCollections.add(spec.name);
+    }
+    const meta = await this.dexieDb.getSyncMeta(spec.name);
+    if (meta) this.syncMetaCache.set(spec.name, meta);
+    if (!spec.writeOnly) {
+      await this.loadCollectionToInMem(spec.name);
+    }
+    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 });
+    }
+  }
   /**
    * Restrict sync to only these collections. When non-empty, only the listed
    * collections load from Dexie→in-mem and download from server. Pass an empty
@@ -4562,7 +4652,7 @@ var _SyncedDb = class _SyncedDb {
       try {
         this.onDatabaseCreated();
       } catch (err) {
-        console.error("onDatabaseCreated callback failed:", err);
+        console.error("[SyncedDb] onDatabaseCreated callback failed:", err);
       }
     }
     await this.pendingChanges.recoverPendingWrites();
@@ -4595,10 +4685,10 @@ var _SyncedDb = class _SyncedDb {
       try {
         await this.serverUpdateNotifier.connect();
         const ep = (_c = this.serverUpdateNotifier.endpoint) != null ? _c : "unknown";
-        console.log(`SyncedDb: ebus-proxy connected to ${ep}`);
+        console.log(`[SyncedDb] SyncedDb: ebus-proxy connected to ${ep}`);
       } catch (err) {
         const ep = (_d = this.serverUpdateNotifier.endpoint) != null ? _d : "unknown";
-        console.warn(`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`,
@@ -4610,12 +4700,21 @@ var _SyncedDb = class _SyncedDb {
       this.beforeUnloadHandler = () => {
         if (this.initialized && this.pendingChanges.hasPendingChanges()) {
           console.warn(
-            `SyncedDb: pending changes not flushed. Call close() before page unload.`
+            `[SyncedDb] SyncedDb: pending changes not flushed. Call close() before page unload.`
           );
         }
       };
       window.addEventListener("beforeunload", this.beforeUnloadHandler);
     }
+    if (typeof document !== "undefined") {
+      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);
+        });
+      };
+      document.addEventListener("visibilitychange", this.visibilityFlushHandler);
+    }
     this.initialized = true;
   }
   /**
@@ -4626,6 +4725,25 @@ var _SyncedDb = class _SyncedDb {
   async flush() {
     await this.pendingChanges.flushAll();
   }
+  /**
+   * Push dirty data to the server immediately, bypassing the upload debounce.
+   *
+   * Flushes pending Dexie writes, awaits any in-flight REST upload, then fires
+   * a fresh `uploadDirtyItems()`. Called automatically when the tab becomes
+   * hidden so data is not stranded by browser tab-throttling / suspension.
+   *
+   * No-op when offline, forced offline, or not yet initialized.
+   *
+   * @param calledFrom Diagnostic tag threaded through to upload callbacks
+   */
+  async flushToServer(calledFrom) {
+    if (!this.initialized) return;
+    if (!this.connectionManager.canSync()) return;
+    this.pendingChanges.cancelRestUploadTimer();
+    await this.pendingChanges.flushAll();
+    await this.pendingChanges.awaitRestUpload();
+    await this.syncEngine.uploadDirtyItems(calledFrom);
+  }
   /**
    * Returns when all collections were last successfully synced
    * from the server, or undefined if never.
@@ -4706,6 +4824,10 @@ var _SyncedDb = class _SyncedDb {
       window.removeEventListener("beforeunload", this.beforeUnloadHandler);
       this.beforeUnloadHandler = void 0;
     }
+    if (typeof document !== "undefined" && this.visibilityFlushHandler) {
+      document.removeEventListener("visibilitychange", this.visibilityFlushHandler);
+      this.visibilityFlushHandler = void 0;
+    }
     this.syncMetaCache.clear();
     for (const collectionName of this.collections.keys()) {
       this.inMemManager.clearCollection(collectionName);
@@ -4729,6 +4851,11 @@ var _SyncedDb = class _SyncedDb {
   async findById(collection, id, opts) {
     var _a;
     this.assertCollection(collection);
+    if (!id) {
+      const err = new Error(`[SyncedDb] findById ${collection} no id ${id}`);
+      console.error(err);
+      return null;
+    }
     id = this.normalizeId(id, "findById", collection);
     opts = this.resolveOpts(opts);
     if ((_a = this.collections.get(collection)) == null ? void 0 : _a.writeOnly) {
@@ -4961,7 +5088,7 @@ var _SyncedDb = class _SyncedDb {
         await this.syncEngine.processCollectionServerData(collection, serverData, { source: "refresh" });
       }
     }).catch((err) => {
-      console.error(`referToServer failed for ${collection}:`, err);
+      console.error(`[SyncedDb] referToServer failed for ${collection}:`, err);
     });
   }
   /**
@@ -4982,7 +5109,7 @@ var _SyncedDb = class _SyncedDb {
       if (!serverItems || serverItems.length === 0) return;
       await this.syncEngine.processCollectionServerData(collection, serverItems, { source: "incremental" });
     }).catch((err) => {
-      console.error(`refreshInBackground failed for ${collection}:`, err);
+      console.error(`[SyncedDb] refreshInBackground failed for ${collection}:`, err);
     });
   }
   async ensureItemsAreLoaded(collection, ids, withDeleted) {
@@ -5028,7 +5155,7 @@ var _SyncedDb = class _SyncedDb {
     id = this.normalizeId(id, "save", collection);
     if ("_id" in update && !update._id) {
       console.error(
-        `SyncedDb.save("${collection}", "${String(id)}"): update._id is present but falsy (${JSON.stringify(update._id)}). Stripped from update to prevent overwriting valid id. This is a bug \u2014 the caller should not pass falsy _id in update. Data keys: [${Object.keys(update).join(", ")}]`
+        `[SyncedDb] SyncedDb.save("${collection}", "${String(id)}"): update._id is present but falsy (${JSON.stringify(update._id)}). Stripped from update to prevent overwriting valid id. This is a bug \u2014 the caller should not pass falsy _id in update. Data keys: [${Object.keys(update).join(", ")}]`
       );
       delete update._id;
     }
@@ -5042,7 +5169,7 @@ var _SyncedDb = class _SyncedDb {
         }
       })();
       console.error(
-        `SyncedDb.save("${collection}", "${String(id)}"): update._id (${JSON.stringify(update._id)}) does NOT match id (${JSON.stringify(String(id))}). Stripped from update to prevent stuck-dirty bug. The caller likely passed a stale this._id while building update from a freshly-generated record. Data keys: [${updateKeys.join(", ")}]`
+        `[SyncedDb] SyncedDb.save("${collection}", "${String(id)}"): update._id (${JSON.stringify(update._id)}) does NOT match id (${JSON.stringify(String(id))}). Stripped from update to prevent stuck-dirty bug. The caller likely passed a stale this._id while building update from a freshly-generated record. Data keys: [${updateKeys.join(", ")}]`
       );
       this.safeCallback(this.onSaveIdMismatch, {
         collection,
@@ -5058,7 +5185,7 @@ var _SyncedDb = class _SyncedDb {
     const existing = await this.dexieDb.getById(collection, id);
     if (!existing && !((_a = this.collections.get(collection)) == null ? void 0 : _a.writeOnly)) {
       console.warn(
-        `SyncedDb.save: Object ${String(id)} not found in ${collection}, creating new`
+        `[SyncedDb] SyncedDb.save: Object ${String(id)} not found in ${collection}, creating new`
       );
     }
     const fullChanges = __spreadProps(__spreadValues({}, update), { _lastUpdaterId: this.updaterId });
@@ -5108,7 +5235,7 @@ var _SyncedDb = class _SyncedDb {
     const existing = await this.dexieDb.getById(collection, id);
     if (existing && !existing._deleted && !existing._archived) {
       console.warn(
-        `SyncedDb.insert: Object ${String(id)} already exists in ${collection}, overwriting`
+        `[SyncedDb] SyncedDb.insert: Object ${String(id)} already exists in ${collection}, overwriting`
       );
     }
     const insertChanges = __spreadProps(__spreadValues({}, data), { _lastUpdaterId: this.updaterId });
@@ -5247,7 +5374,7 @@ var _SyncedDb = class _SyncedDb {
             this.inMemManager.writeBatch(collection, [{ _id: item.id }], "delete", { source: "incremental" });
             results.push(true);
           } catch (err) {
-            console.error(`Failed to hard delete ${String(item.id)}:`, err);
+            console.error(`[SyncedDb] Failed to hard delete ${String(item.id)}:`, err);
             results.push(false);
           }
         }
@@ -5282,7 +5409,7 @@ var _SyncedDb = class _SyncedDb {
           evictionPlan = await this._collectScopeExitPlan("auto");
         } catch (err) {
           console.error(
-            "[evict] phase 1 failed (skipping bundled eviction):",
+            "[SyncedDb] [evict] phase 1 failed (skipping bundled eviction):",
             err
           );
         }
@@ -5299,11 +5426,11 @@ var _SyncedDb = class _SyncedDb {
           const now = /* @__PURE__ */ new Date();
           if (!this._lastFullSyncDate) {
             this._setLastInitialSync(now).catch((err) => {
-              console.error("Failed to persist lastInitialSync:", err);
+              console.error("[SyncedDb] Failed to persist lastInitialSync:", err);
             });
           }
           this._setLastFullSync(now).catch((err) => {
-            console.error("Failed to persist lastFullSync:", err);
+            console.error("[SyncedDb] Failed to persist lastFullSync:", err);
           });
         }
       } catch (err) {
@@ -5322,7 +5449,7 @@ var _SyncedDb = class _SyncedDb {
             );
             await this._persistEvictionTimestamp();
           } catch (err) {
-            console.error("[evict] phase 3 failed:", err);
+            console.error("[SyncedDb] [evict] phase 3 failed:", err);
           }
         }
       }
@@ -5629,7 +5756,7 @@ var _SyncedDb = class _SyncedDb {
         serverEvictedCount = serverExits.length;
       } catch (err) {
         console.error(
-          `[evict] server-assisted pass failed for ${collection} (proceeding with local-only):`,
+          `[SyncedDb] [evict] server-assisted pass failed for ${collection} (proceeding with local-only):`,
           err
         );
       }
@@ -5746,7 +5873,7 @@ var _SyncedDb = class _SyncedDb {
       } catch (err) {
         serverFailed = true;
         console.error(
-          "[evict] server-assisted batch failed (proceeding with local-only):",
+          "[SyncedDb] [evict] server-assisted batch failed (proceeding with local-only):",
           err
         );
       }
@@ -6058,7 +6185,7 @@ var _SyncedDb = class _SyncedDb {
       try {
         fn(info);
       } catch (err) {
-        console.error("Callback failed:", err);
+        console.error("[SyncedDb] Callback failed:", err);
       }
     }
   }
@@ -6149,12 +6276,12 @@ var _SyncedDb = class _SyncedDb {
   normalizeId(id, method, collection) {
     if (!id && id !== void 0) {
       console.error(
-        `SyncedDb.${method != null ? method : "?"}("${collection != null ? collection : "?"}"): id parameter is falsy (${JSON.stringify(id)}). This is a bug \u2014 the caller must provide a valid _id.`
+        `[SyncedDb] SyncedDb.${method != null ? method : "?"}("${collection != null ? collection : "?"}"): id parameter is falsy (${JSON.stringify(id)}). This is a bug \u2014 the caller must provide a valid _id.`
       );
     }
     if (typeof id === "string" && _SyncedDb.STRINGIFIED_FALSY.has(id)) {
       console.error(
-        `SyncedDb.${method != null ? method : "?"}("${collection != null ? collection : "?"}"): id is a stringified falsy value ("${id}"). This is a bug \u2014 a falsy value was coerced to string before being passed as _id.`
+        `[SyncedDb] SyncedDb.${method != null ? method : "?"}("${collection != null ? collection : "?"}"): id is a stringified falsy value ("${id}"). This is a bug \u2014 a falsy value was coerced to string before being passed as _id.`
       );
     }
     return typeof id === "object" && id !== null ? String(id) : id;
@@ -6166,12 +6293,12 @@ var _SyncedDb = class _SyncedDb {
   warnFalsyQueryId(data, method, collection) {
     if ("_id" in data && !data._id) {
       console.error(
-        `SyncedDb.${method}("${collection}"): _id is present in query/data but falsy (${JSON.stringify(data._id)}). This is a bug \u2014 _id must be valid when specified. Data keys: [${Object.keys(data).join(", ")}]`
+        `[SyncedDb] SyncedDb.${method}("${collection}"): _id is present in query/data but falsy (${JSON.stringify(data._id)}). This is a bug \u2014 _id must be valid when specified. Data keys: [${Object.keys(data).join(", ")}]`
       );
     }
     if ("_id" in data && typeof data._id === "string" && _SyncedDb.STRINGIFIED_FALSY.has(data._id)) {
       console.error(
-        `SyncedDb.${method}("${collection}"): _id is a stringified falsy value ("${data._id}"). This is a bug \u2014 a falsy value was coerced to string before being passed as _id. Data keys: [${Object.keys(data).join(", ")}]`
+        `[SyncedDb] SyncedDb.${method}("${collection}"): _id is a stringified falsy value ("${data._id}"). This is a bug \u2014 a falsy value was coerced to string before being passed as _id. Data keys: [${Object.keys(data).join(", ")}]`
       );
     }
   }
@@ -6184,7 +6311,7 @@ var _SyncedDb = class _SyncedDb {
   ensureId(data, method, collection) {
     if (typeof data._id === "string" && _SyncedDb.STRINGIFIED_FALSY.has(data._id)) {
       console.error(
-        `SyncedDb.${method}("${collection}"): _id is a stringified falsy value ("${data._id}"). This is a bug \u2014 a falsy value was coerced to string before being passed as _id. Data keys: [${Object.keys(data).join(", ")}]`
+        `[SyncedDb] SyncedDb.${method}("${collection}"): _id is a stringified falsy value ("${data._id}"). This is a bug \u2014 a falsy value was coerced to string before being passed as _id. Data keys: [${Object.keys(data).join(", ")}]`
       );
       data._id = null;
     }
@@ -6192,7 +6319,7 @@ var _SyncedDb = class _SyncedDb {
       const newId = new ObjectId2().toHexString();
       if ("_id" in data) {
         console.error(
-          `SyncedDb.${method}("${collection}"): _id is present but falsy (${JSON.stringify(data._id)}). Replaced with "${newId}". This is a bug \u2014 the caller should provide a valid _id. Data keys: [${Object.keys(data).join(", ")}]`
+          `[SyncedDb] SyncedDb.${method}("${collection}"): _id is present but falsy (${JSON.stringify(data._id)}). Replaced with "${newId}". This is a bug \u2014 the caller should provide a valid _id. Data keys: [${Object.keys(data).join(", ")}]`
         );
       }
       data._id = newId;
@@ -6282,7 +6409,7 @@ var _SyncedDb = class _SyncedDb {
     const drop = (reason) => {
       if (dropSilently) return;
       console.error(
-        `SyncedDb.applyDiffLocally: dropping bracket-path diff entry (${reason})`,
+        `[SyncedDb] applyDiffLocally: dropping bracket-path diff entry (${reason})`,
         { collection, _id: String(id), path, value }
       );
     };
@@ -6498,7 +6625,7 @@ var DexieDb = class extends Dexie {
       this.ensureStringId(item);
       if (typeof item._id !== "string" || item._id.length === 0) {
         console.error(
-          `DexieDb.saveMany: skipping item with invalid _id in "${collection}"`,
+          `[DexieDb] DexieDb.saveMany: skipping item with invalid _id in "${collection}"`,
           { _id: item._id, _idType: typeof item._id, item }
         );
         continue;
@@ -6511,7 +6638,7 @@ var DexieDb = class extends Dexie {
     } catch (err) {
       const ids = valid.map((it) => String(it._id));
       console.error(
-        `DexieDb.saveMany: bulkPut failed for "${collection}" (${valid.length} items):`,
+        `[DexieDb] DexieDb.saveMany: bulkPut failed for "${collection}" (${valid.length} items):`,
         err,
         "_ids:",
         ids
@@ -9466,7 +9593,7 @@ var Ebus2ProxyServerUpdateNotifier = class {
     this.reconnectAttempt = 0;
     this.currentReconnectDelay = this.reconnectDelayMs;
     console.log(
-      `Ebus2Proxy connected to ${this.wsUrl} (db: ${this.dbName})`
+      `[Ebus2ProxyNotifier] Ebus2Proxy connected to ${this.wsUrl} (db: ${this.dbName})`
     );
     this.sendSubscribe(`db/${this.dbName}`);
     if (this.subscribeServices) {
@@ -9477,7 +9604,7 @@ var Ebus2ProxyServerUpdateNotifier = class {
       try {
         callback();
       } catch (err) {
-        console.error("onWsConnect callback failed:", err);
+        console.error("[Ebus2ProxyNotifier] onWsConnect callback failed:", err);
       }
     }
   }
@@ -9492,7 +9619,7 @@ var Ebus2ProxyServerUpdateNotifier = class {
         try {
           callback(reason);
         } catch (err) {
-          console.error("onWsDisconnect callback failed:", err);
+          console.error("[Ebus2ProxyNotifier] onWsDisconnect callback failed:", err);
         }
       }
     }
@@ -9501,7 +9628,7 @@ var Ebus2ProxyServerUpdateNotifier = class {
     }
   }
   handleError(event) {
-    console.error("WebSocket error:", event);
+    console.error("[Ebus2ProxyNotifier] WebSocket error:", event);
   }
   handleMessage(event) {
     try {
@@ -9523,11 +9650,11 @@ var Ebus2ProxyServerUpdateNotifier = class {
           this.handlePong();
           break;
         case "error":
-          console.error("WebSocket server error:", message.error);
+          console.error("[Ebus2ProxyNotifier] WebSocket server error:", message.error);
           break;
       }
     } catch (err) {
-      console.error("Failed to parse WebSocket message:", err);
+      console.error("[Ebus2ProxyNotifier] Failed to parse WebSocket message:", err);
     }
   }
   handleChannelMessage(message) {
@@ -9535,7 +9662,7 @@ var Ebus2ProxyServerUpdateNotifier = class {
       try {
         this.onServicesChange(message.data);
       } catch (err) {
-        console.error("onServicesChange callback failed:", err);
+        console.error("[Ebus2ProxyNotifier] onServicesChange callback failed:", err);
       }
       return;
     }
@@ -9552,14 +9679,14 @@ var Ebus2ProxyServerUpdateNotifier = class {
       try {
         this.onWsNotification(payload);
       } catch (err) {
-        console.error("onWsNotification callback failed:", err);
+        console.error("[Ebus2ProxyNotifier] onWsNotification callback failed:", err);
       }
     }
     for (const callback of this.callbacks) {
       try {
         callback(payload);
       } catch (err) {
-        console.error("ServerUpdateCallback failed:", err);
+        console.error("[Ebus2ProxyNotifier] ServerUpdateCallback failed:", err);
       }
     }
   }
@@ -9578,14 +9705,14 @@ var Ebus2ProxyServerUpdateNotifier = class {
       try {
         callback(this.reconnectAttempt);
       } catch (err) {
-        console.error("onWsReconnect callback failed:", err);
+        console.error("[Ebus2ProxyNotifier] onWsReconnect callback failed:", err);
       }
     }
     this.reconnectTimer = setTimeout(() => {
       this.reconnectTimer = void 0;
       if (this.shouldReconnect && !this.forcedOffline) {
         this.createWebSocket().catch((err) => {
-          console.error("Reconnection failed:", err);
+          console.error("[Ebus2ProxyNotifier] Reconnection failed:", err);
           this.currentReconnectDelay = Math.min(
             this.currentReconnectDelay * 2,
             this.maxReconnectDelayMs
@@ -9608,7 +9735,7 @@ var Ebus2ProxyServerUpdateNotifier = class {
     const pingMsg = { type: "ping", id: `ping-${Date.now()}` };
     this.ws.send(packr2.pack(preprocessForPack2(pingMsg)));
     this.pongTimer = setTimeout(() => {
-      console.warn("Pong timeout - closing WebSocket");
+      console.warn("[Ebus2ProxyNotifier] Pong timeout - closing WebSocket");
       if (this.ws) {
         this.ws.close(4e3, "Pong timeout");
       }