cry-synced-db-client 0.1.59 → 0.1.60

package/dist/index.js

@@ -572,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);
           }

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;
 }

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.59",
+  "version": "0.1.60",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",