@calimero-network/mero-js 7.0.4 → 7.1.0

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { RpcClient, RpcError } from './rpc';
 export type { MigrateMyEntriesSummary } from './rpc';
 export type { ExecuteParams } from './rpc';
 export { SseClient, WsClient } from './events';
-export type { SseEventData, WsEventData, AppVersionChangedEvent } from './events';
+export type { SseEventData, WsEventData, AppVersionChangedEvent, GroupMembershipEventData } from './events';
 export * from './cloud';
 export * from './capabilities';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGzD,cAAc,eAAe,CAAC;AAG9B,cAAc,YAAY,CAAC;AAG3B,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,YAAY,EAAE,uBAAuB,EAAE,MAAM,OAAO,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGlF,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGzD,cAAc,eAAe,CAAC;AAG9B,cAAc,YAAY,CAAC;AAG3B,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,YAAY,EAAE,uBAAuB,EAAE,MAAM,OAAO,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAG5G,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC"}

package/dist/index.mjs

@@ -688,23 +688,61 @@ function unwrap(response) {
   return response?.data;
 }
 function compareSemver(a, b) {
-  const pa = a.split(".");
-  const pb = b.split(".");
-  const n = Math.max(pa.length, pb.length);
+  const [coreA, preA] = splitVersion(a);
+  const [coreB, preB] = splitVersion(b);
+  const na = coreA.split(".");
+  const nb = coreB.split(".");
+  const n = Math.max(na.length, nb.length);
   for (let i = 0; i < n; i++) {
-    const sa = pa[i] ?? "0";
-    const sb = pb[i] ?? "0";
-    const na = Number.parseInt(sa, 10);
-    const nb = Number.parseInt(sb, 10);
-    if (Number.isNaN(na) || Number.isNaN(nb)) {
-      const c = sa.localeCompare(sb);
-      if (c !== 0) return c;
-    } else if (na !== nb) {
-      return na - nb;
-    }
+    const c = compareSemverId(na[i] ?? "0", nb[i] ?? "0");
+    if (c !== 0) return c;
+  }
+  if (preA === void 0 && preB === void 0) return 0;
+  if (preA === void 0) return 1;
+  if (preB === void 0) return -1;
+  const pa = preA.split(".");
+  const pb = preB.split(".");
+  const m = Math.max(pa.length, pb.length);
+  for (let i = 0; i < m; i++) {
+    if (i >= pa.length) return -1;
+    if (i >= pb.length) return 1;
+    const c = compareSemverId(pa[i], pb[i]);
+    if (c !== 0) return c;
   }
   return 0;
 }
+function splitVersion(v) {
+  const core = v.split("+", 1)[0];
+  const dash = core.indexOf("-");
+  return dash === -1 ? [core, void 0] : [core.slice(0, dash), core.slice(dash + 1)];
+}
+function compareSemverId(a, b) {
+  const na = /^\d+$/.test(a);
+  const nb = /^\d+$/.test(b);
+  if (na && nb) {
+    const d = Number(a) - Number(b);
+    return d < 0 ? -1 : d > 0 ? 1 : 0;
+  }
+  if (na) return -1;
+  if (nb) return 1;
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+async function fetchRegistry(url, kind, context) {
+  return withRetry(
+    async () => {
+      const resp = await fetch(url, { signal: AbortSignal.timeout(1e4) });
+      if (!resp.ok) {
+        const err = new Error(
+          `registry ${kind} fetch failed (${resp.status}) for ${context}`
+        );
+        err.status = resp.status;
+        throw err;
+      }
+      return resp;
+    },
+    { attempts: 3 }
+  );
+}
 var AdminApiClient = class {
   constructor(httpClient) {
     this.httpClient = httpClient;
@@ -734,12 +772,7 @@ var AdminApiClient = class {
       `/api/v2/bundles/${encodeURIComponent(packageName)}/${encodeURIComponent(version)}`,
       base
     ).toString();
-    const resp = await fetch(manifestUrl);
-    if (!resp.ok) {
-      throw new Error(
-        `registry manifest fetch failed (${resp.status}) for ${packageName}@${version}`
-      );
-    }
+    const resp = await fetchRegistry(manifestUrl, "manifest", `${packageName}@${version}`);
     const bundle = await resp.json();
     const pkg = encodeURIComponent(bundle.package);
     const ver = encodeURIComponent(bundle.appVersion);
@@ -762,12 +795,7 @@ var AdminApiClient = class {
   async getRegistryVersions(registryUrl, packageName) {
     const url = new URL("/api/v2/bundles", new URL(registryUrl).origin);
     url.searchParams.set("package", packageName);
-    const resp = await fetch(url.toString());
-    if (!resp.ok) {
-      throw new Error(
-        `registry versions fetch failed (${resp.status}) for ${packageName}`
-      );
-    }
+    const resp = await fetchRegistry(url.toString(), "versions", packageName);
     const bundles = await resp.json();
     return (Array.isArray(bundles) ? bundles : []).map((b) => b.appVersion).filter((v) => typeof v === "string").sort((a, b) => compareSemver(b, a));
   }
@@ -1495,6 +1523,7 @@ var SseClient = class {
     this.abortController = null;
     this.reconnectTimer = null;
     this.subscribedContextIds = /* @__PURE__ */ new Set();
+    this.subscribedGroupIds = /* @__PURE__ */ new Set();
     this.closed = false;
     this.listeners = { connect: [], event: [], error: [] };
     this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
@@ -1617,21 +1646,25 @@ var SseClient = class {
       if (msg.type === "connect" && msg.session_id) {
         this.sessionId = msg.session_id;
         this.emit("connect", msg.session_id);
-        if (this.subscribedContextIds.size > 0) {
-          this.sendSubscription("subscribe", [...this.subscribedContextIds]);
+        if (this.subscribedContextIds.size > 0 || this.subscribedGroupIds.size > 0) {
+          this.sendSubscription("subscribe", {
+            contextIds: [...this.subscribedContextIds],
+            groupIds: [...this.subscribedGroupIds]
+          });
         }
         return;
       }
-      if (msg.result && msg.result.contextId) {
-        let eventData = msg.result.data;
-        if (Array.isArray(eventData)) {
-          try {
-            const bytes = new Uint8Array(eventData);
-            const text = new TextDecoder().decode(bytes);
-            eventData = JSON.parse(text);
-          } catch {
-          }
+      if (!msg.result) return;
+      let eventData = msg.result.data;
+      if (Array.isArray(eventData)) {
+        try {
+          const bytes = new Uint8Array(eventData);
+          const text = new TextDecoder().decode(bytes);
+          eventData = JSON.parse(text);
+        } catch {
         }
+      }
+      if (msg.result.contextId) {
         this.emit("event", {
           contextId: msg.result.contextId,
           // Forward the event tag (sibling of `data` in core's flattened
@@ -1639,31 +1672,52 @@ var SseClient = class {
           type: msg.result.type,
           data: eventData
         });
+        return;
+      }
+      if (msg.result.groupId) {
+        this.emit("event", {
+          groupId: msg.result.groupId,
+          type: msg.result.type,
+          data: eventData
+        });
       }
     } catch {
     }
   }
-  async subscribe(contextIds) {
-    const newIds = contextIds.filter((id) => !this.subscribedContextIds.has(id));
-    for (const id of contextIds) {
+  async subscribe(idsOrOpts) {
+    const opts = Array.isArray(idsOrOpts) ? { contextIds: idsOrOpts } : idsOrOpts;
+    const newContextIds = (opts.contextIds ?? []).filter((id) => !this.subscribedContextIds.has(id));
+    const newGroupIds = (opts.groupIds ?? []).filter((id) => !this.subscribedGroupIds.has(id));
+    for (const id of opts.contextIds ?? []) {
       this.subscribedContextIds.add(id);
     }
-    if (newIds.length > 0 && this.sessionId) {
-      await this.sendSubscription("subscribe", newIds);
+    for (const id of opts.groupIds ?? []) {
+      this.subscribedGroupIds.add(id);
+    }
+    if ((newContextIds.length > 0 || newGroupIds.length > 0) && this.sessionId) {
+      await this.sendSubscription("subscribe", { contextIds: newContextIds, groupIds: newGroupIds });
     }
   }
-  async unsubscribe(contextIds) {
-    const hadIds = contextIds.filter((id) => this.subscribedContextIds.has(id));
-    for (const id of contextIds) {
+  async unsubscribe(idsOrOpts) {
+    const opts = Array.isArray(idsOrOpts) ? { contextIds: idsOrOpts } : idsOrOpts;
+    const hadContextIds = (opts.contextIds ?? []).filter((id) => this.subscribedContextIds.has(id));
+    const hadGroupIds = (opts.groupIds ?? []).filter((id) => this.subscribedGroupIds.has(id));
+    for (const id of opts.contextIds ?? []) {
       this.subscribedContextIds.delete(id);
     }
-    if (hadIds.length > 0 && this.sessionId) {
-      await this.sendSubscription("unsubscribe", hadIds);
+    for (const id of opts.groupIds ?? []) {
+      this.subscribedGroupIds.delete(id);
+    }
+    if ((hadContextIds.length > 0 || hadGroupIds.length > 0) && this.sessionId) {
+      await this.sendSubscription("unsubscribe", { contextIds: hadContextIds, groupIds: hadGroupIds });
     }
   }
-  async sendSubscription(method, contextIds) {
+  async sendSubscription(method, ids) {
     try {
       const token = await this.getAuthToken();
+      const params = {};
+      if (ids.contextIds && ids.contextIds.length > 0) params.contextIds = ids.contextIds;
+      if (ids.groupIds && ids.groupIds.length > 0) params.groupIds = ids.groupIds;
       const response = await fetch(`${this.baseUrl}/sse/subscription`, {
         method: "POST",
         headers: {
@@ -1673,7 +1727,7 @@ var SseClient = class {
         body: JSON.stringify({
           id: this.sessionId,
           method,
-          params: { contextIds }
+          params
         })
       });
       if (!response.ok) {
@@ -1713,6 +1767,7 @@ var SseClient = class {
     }
     this.sessionId = null;
     this.subscribedContextIds.clear();
+    this.subscribedGroupIds.clear();
   }
 };
 
@@ -1724,6 +1779,7 @@ var _WsClient = class _WsClient {
     this.reconnectAttempt = 0;
     this.reconnectTimer = null;
     this.subscribedContextIds = /* @__PURE__ */ new Set();
+    this.subscribedGroupIds = /* @__PURE__ */ new Set();
     this.listeners = { connect: [], event: [], error: [] };
     this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
     this.getAuthToken = opts.getAuthToken;
@@ -1755,7 +1811,7 @@ var _WsClient = class _WsClient {
     }
   }
   async connect() {
-    if (this.ws && (this.ws.readyState === WebSocket.CONNECTING || this.ws.readyState === WebSocket.OPEN)) {
+    if (this.ws && (this.ws.readyState === 0 || this.ws.readyState === 1)) {
       return;
     }
     this.closed = false;
@@ -1769,13 +1825,7 @@ var _WsClient = class _WsClient {
       this.ws.onopen = () => {
         this.reconnectAttempt = 0;
         this.emit("connect");
-        if (this.subscribedContextIds.size > 0) {
-          this.sendMessage({
-            id: null,
-            method: "subscribe",
-            params: { contextIds: [...this.subscribedContextIds] }
-          });
-        }
+        this.resubscribeAfterReconnect();
       };
       this.ws.onmessage = (event) => {
         this.handleMessage(event.data);
@@ -1799,16 +1849,17 @@ var _WsClient = class _WsClient {
     if (typeof raw !== "string") return;
     try {
       const msg = JSON.parse(raw);
-      if (msg.result && msg.result.contextId) {
-        let eventData = msg.result.data;
-        if (Array.isArray(eventData)) {
-          try {
-            const bytes = new Uint8Array(eventData);
-            const text = new TextDecoder().decode(bytes);
-            eventData = JSON.parse(text);
-          } catch {
-          }
+      if (!msg.result) return;
+      let eventData = msg.result.data;
+      if (Array.isArray(eventData)) {
+        try {
+          const bytes = new Uint8Array(eventData);
+          const text = new TextDecoder().decode(bytes);
+          eventData = JSON.parse(text);
+        } catch {
         }
+      }
+      if (msg.result.contextId) {
         this.emit("event", {
           contextId: msg.result.contextId,
           // Forward the event tag (sibling of `data` in core's flattened
@@ -1816,36 +1867,66 @@ var _WsClient = class _WsClient {
           type: msg.result.type,
           data: eventData
         });
+        return;
+      }
+      if (msg.result.groupId) {
+        this.emit("event", {
+          groupId: msg.result.groupId,
+          type: msg.result.type,
+          data: eventData
+        });
       }
     } catch {
     }
   }
-  subscribe(contextIds) {
-    for (const id of contextIds) {
+  subscribe(idsOrOpts) {
+    const opts = Array.isArray(idsOrOpts) ? { contextIds: idsOrOpts } : idsOrOpts;
+    for (const id of opts.contextIds ?? []) {
       this.subscribedContextIds.add(id);
     }
-    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+    for (const id of opts.groupIds ?? []) {
+      this.subscribedGroupIds.add(id);
+    }
+    if (this.ws && this.ws.readyState === 1) {
       this.sendMessage({
         id: null,
         method: "subscribe",
-        params: { contextIds }
+        params: this.buildSubscriptionParams(opts.contextIds ?? [], opts.groupIds ?? [])
       });
     }
   }
-  unsubscribe(contextIds) {
-    for (const id of contextIds) {
+  unsubscribe(idsOrOpts) {
+    const opts = Array.isArray(idsOrOpts) ? { contextIds: idsOrOpts } : idsOrOpts;
+    for (const id of opts.contextIds ?? []) {
       this.subscribedContextIds.delete(id);
     }
-    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+    for (const id of opts.groupIds ?? []) {
+      this.subscribedGroupIds.delete(id);
+    }
+    if (this.ws && this.ws.readyState === 1) {
       this.sendMessage({
         id: null,
         method: "unsubscribe",
-        params: { contextIds }
+        params: this.buildSubscriptionParams(opts.contextIds ?? [], opts.groupIds ?? [])
       });
     }
   }
+  resubscribeAfterReconnect() {
+    if (this.subscribedContextIds.size === 0 && this.subscribedGroupIds.size === 0) return;
+    this.sendMessage({
+      id: null,
+      method: "subscribe",
+      params: this.buildSubscriptionParams([...this.subscribedContextIds], [...this.subscribedGroupIds])
+    });
+  }
+  buildSubscriptionParams(contextIds, groupIds) {
+    const params = {};
+    if (contextIds.length > 0) params.contextIds = contextIds;
+    if (groupIds.length > 0) params.groupIds = groupIds;
+    return params;
+  }
   sendMessage(msg) {
-    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+    if (this.ws && this.ws.readyState === 1) {
       this.ws.send(JSON.stringify(msg));
     }
   }
@@ -1876,6 +1957,7 @@ var _WsClient = class _WsClient {
       this.ws = null;
     }
     this.subscribedContextIds.clear();
+    this.subscribedGroupIds.clear();
   }
 };
 _WsClient.MAX_BACKOFF_MS = 3e4;