cry-synced-db-client 0.1.58 → 0.1.60

package/dist/index.js

@@ -438,6 +438,7 @@ class LeaderElectionManager {
 class CrossTabSyncManager {
   tenant;
   instanceId;
+  windowId;
   debounceMs;
   callbacks;
   deps;
@@ -447,6 +448,7 @@ class CrossTabSyncManager {
   constructor(config) {
     this.tenant = config.tenant;
     this.instanceId = config.instanceId;
+    this.windowId = config.windowId;
     this.debounceMs = config.debounceMs;
     this.callbacks = config.callbacks;
     this.deps = config.deps;
@@ -500,7 +502,9 @@ class CrossTabSyncManager {
     if (Object.keys(updates).length > 0) {
       const payload = {
         updates,
-        instanceId: this.instanceId
+        instanceId: this.instanceId,
+        isLeader: this.deps.isLeader(),
+        windowId: this.windowId
       };
       try {
         this.metaUpdateChannel.postMessage(payload);
@@ -568,7 +572,15 @@ class CrossTabSyncManager {
         }
         if (this.callbacks.onCrossTabSync && newItemsCount > 0) {
           try {
-            this.callbacks.onCrossTabSync(collection, newItemsCount);
+            const info = {
+              collection,
+              itemsCount: newItemsCount,
+              senderInstanceId: payload.instanceId,
+              senderWindowId: payload.windowId,
+              senderWasLeader: payload.isLeader,
+              timestamp: new Date
+            };
+            this.callbacks.onCrossTabSync(info);
           } catch (err) {
             console.error("onCrossTabSync callback failed:", err);
           }
@@ -2730,6 +2742,7 @@ class SyncedDb {
     this.crossTabSync = new CrossTabSyncManager({
       tenant: this.tenant,
       instanceId: this.syncedDbInstanceId,
+      windowId,
       debounceMs: config.crossTabSyncDebounceMs ?? 100,
       callbacks: {
         onCrossTabSync: config.onCrossTabSync,

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

@@ -9,6 +9,7 @@ import type { I_CrossTabSyncManager, CrossTabSyncConfig } from "../types/manager
 export declare class CrossTabSyncManager implements I_CrossTabSyncManager {
     private readonly tenant;
     private readonly instanceId;
+    private readonly windowId;
     private readonly debounceMs;
     private readonly callbacks;
     private readonly deps;

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

@@ -7,7 +7,7 @@ import type { I_DexieDb, SyncMeta, MetaUpdateBroadcast } from "../../types/I_Dex
 import type { I_InMemDb } from "../../types/I_InMemDb";
 import type { I_RestInterface } from "../../types/I_RestInterface";
 import type { PublishDataPayload } from "../../types/PublishRevsPayload";
-import type { CollectionConfig, SyncInfo, ConflictResolutionReport, ServerWriteRequestInfo, ServerWriteResultInfo, FindNewerManyCallInfo, FindNewerManyResultInfo, DexieWriteRequestInfo, DexieWriteResultInfo, LocalstorageWriteResultInfo, WsNotificationInfo } from "../../types/I_SyncedDb";
+import type { CollectionConfig, SyncInfo, ConflictResolutionReport, ServerWriteRequestInfo, ServerWriteResultInfo, FindNewerManyCallInfo, FindNewerManyResultInfo, DexieWriteRequestInfo, DexieWriteResultInfo, LocalstorageWriteResultInfo, WsNotificationInfo, CrossTabSyncInfo } from "../../types/I_SyncedDb";
 import type { PendingChange, UploadResult } from "./internal";
 export interface LeaderElectionCallbacks {
     onBecameLeader?: () => void;
@@ -35,7 +35,7 @@ export interface I_LeaderElectionManager {
 }
 export interface CrossTabSyncCallbacks {
     /** Called after cross-tab sync completes. */
-    onCrossTabSync?: (collection: string, newItemsCount: number) => void;
+    onCrossTabSync?: (info: CrossTabSyncInfo) => void;
     /** Called when BroadcastChannel is unavailable. */
     onInfrastructureError?: (type: string, message: string, error?: Error) => void;
 }
@@ -54,6 +54,7 @@ export interface CrossTabSyncDeps {
 export interface CrossTabSyncConfig {
     tenant: string;
     instanceId: string;
+    windowId: string;
     debounceMs: number;
     callbacks: CrossTabSyncCallbacks;
     deps: CrossTabSyncDeps;

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

@@ -34,7 +34,12 @@ export interface DirtyChange {
 export interface MetaUpdateBroadcast {
     /** Map of collection name -> array of _id strings that were updated */
     updates: Record<string, string[]>;
+    /** Unique ID of the SyncedDb instance that sent this broadcast */
     instanceId: string;
+    /** Whether the sender is the leader tab */
+    isLeader: boolean;
+    /** Window ID of the sender (for debugging) */
+    windowId: string;
 }
 /**
  * Interface za Dexie (IndexedDB) bazo podatkov

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

@@ -158,6 +158,24 @@ export type ConflictSource =
  | "serverUpdate_pendingChanges"
 /** Conflict when processing server update with dirty local item in Dexie */
  | "serverUpdate_dirtyLocal";
+/**
+ * Callback payload for cross-tab synchronization events.
+ * Contains information about the source tab that triggered the sync.
+ */
+export interface CrossTabSyncInfo {
+    /** Collection that was synchronized */
+    collection: string;
+    /** Number of items that were updated in local in-memory cache */
+    itemsCount: number;
+    /** Unique ID of the SyncedDb instance that sent the broadcast */
+    senderInstanceId: string;
+    /** Window ID of the sender tab (for debugging multi-window scenarios) */
+    senderWindowId: string;
+    /** Whether the sender was the leader tab when broadcasting */
+    senderWasLeader: boolean;
+    /** Timestamp when the sync was processed locally */
+    timestamp: Date;
+}
 /**
  * Callback payload for conflict resolution
  */
@@ -279,7 +297,7 @@ export interface SyncedDbConfig {
     /** Debounce interval for cross-tab sync broadcasts in ms (default: 100) */
     crossTabSyncDebounceMs?: number;
     /** Callback when another tab synced data and local in-memory cache was updated */
-    onCrossTabSync?: (collection: string, newItemsCount: number) => void;
+    onCrossTabSync?: (info: CrossTabSyncInfo) => void;
     /** Callback when this instance becomes the leader tab */
     onBecameLeader?: () => void;
     /** Callback when this instance loses leadership (e.g., another tab took over) */

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

@@ -4,5 +4,5 @@ export type { Obj, QuerySpec, Projection, QueryOpts, KeyOf, InsertKeyOf, InsertS
 export type { I_InMemDb as InMemDb } from "./I_InMemDb";
 export type { I_DexieDb as DexieDb, SyncMeta } from "./I_DexieDb";
 export type { I_ServerUpdateNotifier as ServerUpdateNotifier, ServerUpdateCallback, ServerUpdateNotifierCallbacks } from "./I_ServerUpdateNotifier";
-export type { I_SyncedDb as SyncedDb, SyncedDbConfig, CollectionConfig, SyncInfo, ServerWriteRequestInfo, ServerWriteResultInfo, FindNewerManyCallInfo, FindNewerManyResultInfo, DexieWriteRequestInfo, DexieWriteResultInfo, LocalstorageWriteResultInfo, WsNotificationInfo, InfrastructureErrorType, InfrastructureErrorInfo, ConflictSource, ConflictResolutionReport, } from "./I_SyncedDb";
+export type { I_SyncedDb as SyncedDb, SyncedDbConfig, CollectionConfig, SyncInfo, ServerWriteRequestInfo, ServerWriteResultInfo, FindNewerManyCallInfo, FindNewerManyResultInfo, DexieWriteRequestInfo, DexieWriteResultInfo, LocalstorageWriteResultInfo, WsNotificationInfo, InfrastructureErrorType, InfrastructureErrorInfo, ConflictSource, ConflictResolutionReport, CrossTabSyncInfo, } from "./I_SyncedDb";
 export type { CollectionConfig as CollectionConfigFull } from "./CollectionConfig";

package/package.json

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