@calimero-network/mero-js 2.2.1 → 2.4.0

package/dist/index.d.ts

@@ -8,9 +8,10 @@ export type { AuthCallbackResult, AuthLoginOptions } from './auth';
 export { MemoryTokenStore, LocalStorageTokenStore } from './token-store';
 export type { TokenStore } from './token-store';
 export { RpcClient, RpcError } from './rpc';
+export type { MigrateMyEntriesSummary } from './rpc';
 export type { ExecuteParams } from './rpc';
 export { SseClient, WsClient } from './events';
-export type { SseEventData, WsEventData } from './events';
+export type { SseEventData, WsEventData, AppVersionChangedEvent } 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,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG1D,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,MAAM,UAAU,CAAC;AAGlF,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,uEAAuE;AAEvE,iBAAiB;AACjB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGjD,2CAA2C;AAC3C,cAAc,eAAe,CAAC;AAE9B,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAE3B,mBAAmB;AACnB,cAAc,aAAa,CAAC;AAE5B,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAG9D,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGzE,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG5C,2BAA2B;AAC3B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAG/C,uCAAuC;AACvC,cAAc,SAAS,CAAC;AAExB,gDAAgD;AAChD,cAAc,gBAAgB,CAAC;AAE/B,YAAY"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,uEAAuE;AAEvE,iBAAiB;AACjB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGjD,2CAA2C;AAC3C,cAAc,eAAe,CAAC;AAE9B,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAE3B,mBAAmB;AACnB,cAAc,aAAa,CAAC;AAE5B,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAG9D,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGzE,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAI5C,2BAA2B;AAC3B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAG/C,uCAAuC;AACvC,cAAc,SAAS,CAAC;AAExB,gDAAgD;AAChD,cAAc,gBAAgB,CAAC;AAE/B,YAAY"}

package/dist/index.mjs

@@ -638,6 +638,24 @@ function createAuthApiClientFromHttpClient(httpClient, _config) {
 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);
+  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;
+    }
+  }
+  return 0;
+}
 var AdminApiClient = class {
   constructor(httpClient) {
     this.httpClient = httpClient;
@@ -653,6 +671,57 @@ var AdminApiClient = class {
   async installApplication(request) {
     return unwrap(await this.httpClient.post("/admin-api/install-application", request));
   }
+  /**
+   * Resolve a `package@version` to its registry artifact URL and install it.
+   * Node install is URL-based (no node-side package+version resolution), so this
+   * fetches the bundle manifest from the registry, derives the `.mpk` artifact
+   * URL, then calls {@link installApplication}. `registryUrl` is the registry
+   * origin. This is the discrete "download" step an Updates flow pairs with a
+   * subsequent `upgradeGroup`.
+   */
+  async installFromRegistry(registryUrl, packageName, version) {
+    const base = new URL(registryUrl).origin;
+    const manifestUrl = new URL(
+      `/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 bundle = await resp.json();
+    const pkg = encodeURIComponent(bundle.package);
+    const ver = encodeURIComponent(bundle.appVersion);
+    const artifactUrl = `${base}/artifacts/${pkg}/${ver}/${pkg}-${ver}.mpk`;
+    return this.installApplication({
+      url: artifactUrl,
+      package: bundle.package,
+      version: bundle.appVersion,
+      metadata: []
+    });
+  }
+  /**
+   * List a package's published versions from the registry, newest-first by
+   * semver. Reads the registry's V2 bundle listing
+   * (`GET {registry}/api/v2/bundles?package={package}`), taking each bundle's
+   * `appVersion`. Registry-side data — distinct from the node's
+   * installed-version list — and the source an Updates view compares against
+   * the running `Context.applicationVersion` to detect "a new version exists".
+   */
+  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 bundles = await resp.json();
+    return (Array.isArray(bundles) ? bundles : []).map((b) => b.appVersion).filter((v) => typeof v === "string").sort((a, b) => compareSemver(b, a));
+  }
   async installDevApplication(request) {
     return unwrap(await this.httpClient.post("/admin-api/install-dev-application", request));
   }
@@ -1005,6 +1074,22 @@ var AdminApiClient = class {
       await this.httpClient.get(`/admin-api/groups/${groupId}/upgrade/status`)
     );
   }
+  /**
+   * The operator-facing "have all peers migrated?" rollup for a namespace.
+   * The handler serializes the payload directly, so there is no `{ data }`
+   * envelope to unwrap here (unlike most admin reads).
+   */
+  async getMigrationStatus(namespaceId) {
+    const id = encodeURIComponent(namespaceId);
+    return this.httpClient.get(`/admin-api/groups/${id}/migration-status`);
+  }
+  /** Per-group cascade-migration snapshots for a namespace. */
+  async getCascadeStatus(namespaceId) {
+    const id = encodeURIComponent(namespaceId);
+    return unwrap(
+      await this.httpClient.get(`/admin-api/groups/${id}/cascade-status`)
+    );
+  }
   async retryGroupUpgrade(groupId, request) {
     return unwrap(
       await this.httpClient.post(
@@ -1203,6 +1288,19 @@ var RpcClient = class {
     }
     return response.result;
   }
+  /**
+   * One-tap owner-driven convert: re-signs the caller's identity-gated entries
+   * to the current schema. The export converts all of the caller's
+   * below-target entries in a single sweep, so this issues one call and returns
+   * the resulting summary — it does not loop.
+   */
+  async migrateMyEntries(contextId) {
+    return this.execute({ contextId, method: "migrate_my_entries" });
+  }
+  /** Read-only count of the caller's entries still below the target schema. */
+  async countMyPending(contextId) {
+    return this.execute({ contextId, method: "count_my_pending" });
+  }
 };
 
 // src/events/sse.ts
@@ -1233,6 +1331,20 @@ var SseClient = class {
       if (idx !== -1) arr.splice(idx, 1);
     }
   }
+  /**
+   * Typed convenience over the generic `'event'` stream: invokes `handler` only
+   * for `AppVersionChanged` context events, with the payload already parsed.
+   * Returns an unsubscribe closure (so callers need not retain the listener).
+   */
+  onAppVersionChanged(handler) {
+    const listener = (ev) => {
+      const d = ev.data;
+      if (d?.type !== "AppVersionChanged") return;
+      handler({ contextId: ev.contextId, fromVersion: d.data?.fromVersion, toVersion: d.data?.toVersion });
+    };
+    this.on("event", listener);
+    return () => this.off("event", listener);
+  }
   emit(event, arg) {
     const key = event;
     if (key in this.listeners) {
@@ -1964,6 +2076,7 @@ export {
   WsClient,
   buildAuthLoginUrl,
   combineSignals,
+  compareSemver,
   createAdminApiClient,
   createAdminApiClientFromHttpClient,
   createAuthApiClient,