@calimero-network/mero-js 12.0.0 → 13.0.0

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { RpcClient, RpcError } from './rpc/index.js';
 export type { MigrateMyEntriesSummary } from './rpc/index.js';
 export type { ExecuteParams } from './rpc/index.js';
 export { SseClient, WsClient } from './events/index.js';
-export type { SseEventData, WsEventData, AppVersionChangedEvent, GroupMembershipEventData } from './events/index.js';
+export type { SseEventData, WsEventData, AppVersionChangedEvent, GroupMembershipEventData, GroupMigrationEventData, MigrationStartedData, MigrationProgressData, CascadeProgressData, MigrationCompletedData, } from './events/index.js';
 export * from './cloud/index.js';
 export * from './capabilities.js';
 export { DEFAULT_LOCAL_NODE_PORTS, localNodeUrl, nodeEndpoint, probeNodeHealth, discoverLocalNodes, } from './nodeDiscovery.js';

package/dist/index.mjs

@@ -1517,6 +1517,17 @@ var RpcClient = class {
   }
 };
 
+// src/events/group.ts
+var MIGRATION_EVENT_TYPES = /* @__PURE__ */ new Set([
+  "MigrationStarted",
+  "MigrationProgress",
+  "CascadeProgress",
+  "MigrationCompleted"
+]);
+function isGroupMigrationEvent(event) {
+  return event.type !== void 0 && MIGRATION_EVENT_TYPES.has(event.type);
+}
+
 // src/events/sse.ts
 var SseClient = class {
   constructor(opts) {
@@ -1560,6 +1571,22 @@ var SseClient = class {
     this.on("event", listener);
     return () => this.off("event", listener);
   }
+  /**
+   * Typed convenience over the generic `'event'` stream: invokes `handler` only
+   * for group-migration events, narrowed on `type` so `data` is the matching
+   * payload. Returns an unsubscribe closure.
+   *
+   * A non-admin subscriber sees `MigrationStarted`, `MigrationProgress` and
+   * `MigrationCompleted` but never `CascadeProgress`, which core delivers to
+   * namespace admins only.
+   */
+  onMigrationEvent(handler) {
+    const listener = (ev) => {
+      if (isGroupMigrationEvent(ev)) handler(ev);
+    };
+    this.on("event", listener);
+    return () => this.off("event", listener);
+  }
   emit(event, arg) {
     const key = event;
     if (key in this.listeners) {