cry-synced-db-client 0.1.141 → 0.1.143

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 ## Unreleased
 
+### `getDirtyMeta()` for lightweight dirty-state inspection
+
+- New `SyncedDb.getDirtyMeta()` returns dirty-entry meta (everything except the
+  `changes` payload) grouped per collection, only for collections with ≥1 dirty
+  record. Mirrors `getDirty()` shape but avoids loading change payloads —
+  useful for counts, timestamps, and indicator UIs.
+- New `I_DexieDb.getDirtyMeta(collection)` returning `DirtyMeta[]`.
+- New exported `DirtyMeta` type (`Omit<DirtyChange, "changes">`) and
+  `DirtyChange` type surfaced from the package entry.
+
+### Fix: multi-tab divergence when offline edits cross leader/follower
+
+Fixes a bug where, after both tabs edited different records offline and came
+online with leader-first, the leader ended up with stale record content
+carrying the new server `_rev`. Because `resolveConflict` ignores server
+echoes with equal-or-lower `_rev`, the divergence was permanent until page
+reload. Follower-first came out clean; leader-first did not.
+
+Two contributing causes, both fixed:
+
+- `SyncEngine` post-upload in-mem patch no longer spreads stale `getInMemById`
+  result over server-returned `_rev`/`_ts`. In-mem is now fed the freshly
+  patched Dexie item (authoritative content + server meta), so the tab that
+  uploaded on behalf of another tab's dirty write ends up with matching
+  content and `_rev` in-mem.
+- `CrossTabSyncManager.broadcastMetaUpdate` no longer gated by `isLeader()`.
+  Non-leader tabs now broadcast their local writes so the leader's in-mem
+  cache learns of them via the existing shared-Dexie reload path. Reload
+  broadcasts (post-full-sync) remain leader-only.
+
 ### BREAKING: Self-healing sync/reconnect lifecycle
 
 Fixes a class of bugs where the 60s auto-sync scheduler silently died after a

package/dist/index.js

@@ -634,13 +634,14 @@ var CrossTabSyncManager = class {
   }
   /**
    * Broadcast updated IDs to other tabs (debounced).
-   * Only the leader should broadcast.
+   * Any tab with local writes broadcasts so other tabs refresh their in-mem
+   * from shared Dexie. Otherwise non-leader writes stay invisible to the leader's
+   * in-mem cache, and a later upload patches new _rev onto stale content.
    * While a server sync is in progress, suppresses delta broadcasts and only
    * records which collections were affected (for the post-sync reload broadcast).
    */
   broadcastMetaUpdate(updates) {
     if (!this.metaUpdateChannel) return;
-    if (!this.deps.isLeader()) return;
     if (this.serverSyncInProgress) {
       for (const collection of Object.keys(updates)) {
         this.syncAffectedCollections.add(collection);
@@ -2668,13 +2669,7 @@ var _SyncEngine = class _SyncEngine {
                 dexieDeleteIds.push(entity._id);
               } else {
                 dexieSaveBatch.push(dexieItem);
-                const inMemItem = this.deps.getInMemById(collection, entity._id);
-                if (inMemItem) {
-                  inMemUpdateBatch.push(__spreadProps(__spreadValues({}, inMemItem), {
-                    _rev: entity._rev,
-                    _ts: entity._ts
-                  }));
-                }
+                inMemUpdateBatch.push(dexieItem);
               }
             }
           }
@@ -4550,6 +4545,16 @@ var _SyncedDb = class _SyncedDb {
     }
     return result;
   }
+  async getDirtyMeta() {
+    const result = {};
+    for (const [collectionName] of this.collections) {
+      const metas = await this.dexieDb.getDirtyMeta(collectionName);
+      if (metas.length > 0) {
+        result[collectionName] = metas;
+      }
+    }
+    return result;
+  }
   // ==================== Data Deletion ====================
   async dropCollection(collection, force = false) {
     this.assertCollection(collection);
@@ -5170,6 +5175,21 @@ var DexieDb = class extends Dexie {
     }
     return result;
   }
+  async getDirtyMeta(collection) {
+    const dirtyEntries = await this.dirtyChanges.where("[collection+id]").between([collection, Dexie.minKey], [collection, Dexie.maxKey]).toArray();
+    const result = [];
+    for (const entry of dirtyEntries) {
+      result.push({
+        collection: entry.collection,
+        id: entry.id,
+        baseTs: entry.baseTs,
+        baseRev: entry.baseRev,
+        createdAt: entry.createdAt,
+        updatedAt: entry.updatedAt
+      });
+    }
+    return result;
+  }
   async addDirtyChange(collection, id, changes, baseMeta) {
     const stringId = this.idToString(id);
     const existing = await this.dirtyChanges.get([collection, stringId]);

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

@@ -1,5 +1,5 @@
 import Dexie from "dexie";
-import type { DirtyChange, I_DexieDb, SyncMeta } from "../types/I_DexieDb";
+import type { DirtyChange, DirtyMeta, I_DexieDb, SyncMeta } from "../types/I_DexieDb";
 import type { CollectionConfig } from "../types/CollectionConfig";
 import type { Id, LocalDbEntity } from "../types/DbEntity";
 /**
@@ -31,6 +31,7 @@ export declare class DexieDb extends Dexie implements I_DexieDb {
     forEachBatch<T extends LocalDbEntity>(collection: string, batchSize: number, callback: (items: T[]) => Promise<void>): Promise<void>;
     count(collection: string): Promise<number>;
     getDirty<T extends LocalDbEntity>(collection: string): Promise<Partial<T>[]>;
+    getDirtyMeta(collection: string): Promise<DirtyMeta[]>;
     addDirtyChange(collection: string, id: Id, changes: Record<string, any>, baseMeta?: {
         _ts?: any;
         _rev?: number;

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

@@ -1,6 +1,6 @@
 import type { AggregateOptions } from "mongodb";
 import type { I_SyncedDb, SyncedDbConfig, WsNotificationInfo, EvictionInfo, EvictionCollectionInfo } from "../types/I_SyncedDb";
-import type { MetaUpdateBroadcast } from "../types/I_DexieDb";
+import type { DirtyMeta, MetaUpdateBroadcast } from "../types/I_DexieDb";
 import type { QuerySpec, QueryOpts, UpdateSpec, InsertSpec, BatchSpec } from "../types/I_RestInterface";
 import type { Id, DbEntity } from "../types/DbEntity";
 /**
@@ -161,6 +161,7 @@ export declare class SyncedDb implements I_SyncedDb {
     getOnWsNotification(): ((info: WsNotificationInfo) => void) | undefined;
     getOnWakeSync(): ((info: import("./types/managers").WakeSyncInfo) => void) | undefined;
     getDirty<T extends DbEntity>(): Promise<Readonly<Record<string, readonly T[]>>>;
+    getDirtyMeta(): Promise<Readonly<Record<string, readonly DirtyMeta[]>>>;
     dropCollection(collection: string, force?: boolean): Promise<void>;
     dropDatabase(force?: boolean): Promise<void>;
     /**

package/dist/src/db/managers/CrossTabSyncManager.d.ts

@@ -1,8 +1,9 @@
 /**
  * CrossTabSyncManager - Manages cross-tab synchronization via BroadcastChannel.
  *
- * When the leader tab syncs data or receives WebSocket updates, it broadcasts
- * the IDs of updated records so other tabs can refresh their in-memory state.
+ * Any tab with local writes (leader or follower) broadcasts the IDs of updated
+ * records so other tabs refresh their in-memory state from shared Dexie.
+ * Reload broadcasts (post-full-sync) remain leader-only.
  */
 import type { MetaUpdateBroadcast } from "../../types/I_DexieDb";
 import type { I_CrossTabSyncManager, CrossTabSyncConfig } from "../types/managers";
@@ -31,7 +32,9 @@ export declare class CrossTabSyncManager implements I_CrossTabSyncManager {
     init(): void;
     /**
      * Broadcast updated IDs to other tabs (debounced).
-     * Only the leader should broadcast.
+     * Any tab with local writes broadcasts so other tabs refresh their in-mem
+     * from shared Dexie. Otherwise non-leader writes stay invisible to the leader's
+     * in-mem cache, and a later upload patches new _rev onto stale content.
      * While a server sync is in progress, suppresses delta broadcasts and only
      * records which collections were affected (for the post-sync reload broadcast).
      */

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

@@ -27,6 +27,12 @@ export interface DirtyChange {
     /** When last change was accumulated */
     updatedAt: number;
 }
+/**
+ * Meta fields of a DirtyChange entry, without the `changes` payload.
+ * Used by `getDirtyMeta` for lightweight dirty-state inspection
+ * (counts, timestamps) without loading change payloads into memory.
+ */
+export type DirtyMeta = Omit<DirtyChange, "changes">;
 /** Shared fields for all cross-tab broadcast messages */
 interface BroadcastBase {
     /** Unique ID of the SyncedDb instance that sent this broadcast */
@@ -84,6 +90,8 @@ export interface I_DexieDb {
     forEachBatch<T extends LocalDbEntity>(collection: string, batchSize: number, callback: (items: T[]) => Promise<void>): Promise<void>;
     /** Vrne vse dirty objekte (z lokalnimi spremembami) - returns only changed fields + _id + metadata */
     getDirty<T extends LocalDbEntity>(collection: string): Promise<Partial<T>[]>;
+    /** Vrne meta podatke vseh dirty vnosov za kolekcijo (brez `changes` payloada) */
+    getDirtyMeta(collection: string): Promise<DirtyMeta[]>;
     /** Add or accumulate changes for a record */
     addDirtyChange(collection: string, id: Id, changes: Record<string, any>, baseMeta?: {
         _ts?: any;

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

@@ -1,7 +1,7 @@
 import type { AggregateOptions } from "mongodb";
 import type { Id, DbEntity, LocalDbEntity } from "./DbEntity";
 import type { QuerySpec, QueryOpts, UpdateSpec, InsertSpec, BatchSpec, I_RestInterface, CollectionUpdateRequest, CollectionUpdateResult, GetNewerSpec } from "./I_RestInterface";
-import type { I_DexieDb } from "./I_DexieDb";
+import type { DirtyMeta, I_DexieDb } from "./I_DexieDb";
 import type { I_InMemDb } from "./I_InMemDb";
 import type { I_ServerUpdateNotifier } from "./I_ServerUpdateNotifier";
 import type { WakeSyncInfo, NetworkStatusChangeInfo } from "../db/types/managers";
@@ -700,6 +700,11 @@ export interface I_SyncedDb {
     getDebounceRestWritesMs(): number;
     /** Vrne vse dirty objekte iz vseh kolekcij */
     getDirty<T extends DbEntity>(): Promise<Readonly<Record<string, readonly T[]>>>;
+    /**
+     * Vrne meta podatke dirty vnosov (brez `changes` payloada) po kolekcijah,
+     * ki imajo vsaj en dirty zapis. Kolekcije brez dirty vnosov niso vključene.
+     */
+    getDirtyMeta(): Promise<Readonly<Record<string, readonly DirtyMeta[]>>>;
     /**
      * Drops a collection, ensuring no data loss.
      * - Throws if offline or forcedOffline (unless force=true)

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

@@ -2,7 +2,7 @@ export type { Id, Entity, IdOrEntity, DbEntity, LocalDbEntity } from "./DbEntity
 export type { PublishableOperation, PublishRevsPayloadInsert, PublishRevsPayloadUpdate, PublishRevsPayloadDelete, PublishRevsPayloadUpdateMany, PublishRevsPayloadDeleteMany, PublishRevsPayloadBatchItem, PublishRevsPayloadBatch, PublishRevsPayload, PublishRevsSpec, PublishDataPayloadBase, PublishDataPayloadInsert, PublishDataPayloadUpdate, PublishDataPayloadDelete, PublishDataPayloadBatch, PublishDataPayload, PublishDataSpec, PublishSpec, } from "./PublishRevsPayload";
 export type { Obj, QuerySpec, Projection, QueryOpts, KeyOf, InsertKeyOf, InsertSpec, UpdateSpec, BatchSpec, UpsertOptions, GetNewerSpec, I_RestInterface as RestInterface, } from "./I_RestInterface";
 export type { I_InMemDb as InMemDb } from "./I_InMemDb";
-export type { I_DexieDb as DexieDb, SyncMeta } from "./I_DexieDb";
+export type { I_DexieDb as DexieDb, SyncMeta, DirtyChange, DirtyMeta } from "./I_DexieDb";
 export type { I_ServerUpdateNotifier as ServerUpdateNotifier, ServerUpdateCallback, ServerUpdateNotifierCallbacks } from "./I_ServerUpdateNotifier";
 export type { I_SyncedDb as SyncedDb, SyncedDbConfig, CollectionConfig, CollectionSyncConfig, SyncInfo, ServerWriteRequestInfo, ServerWriteResultInfo, FindNewerManyCallInfo, FindNewerManyResultInfo, DexieWriteRequestInfo, DexieWriteResultInfo, LocalstorageWriteResultInfo, WsNotificationInfo, InfrastructureErrorType, InfrastructureErrorInfo, ConflictSource, ConflictResolutionReport, CrossTabSyncInfo, EvictionInfo, EvictionCollectionInfo, } from "./I_SyncedDb";
 export type { NetworkStatusChangeInfo } from "../db/types/managers";

package/package.json

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