@calimero-network/mero-js 2.3.0 → 2.4.1

package/dist/index.cjs

@@ -34,6 +34,7 @@ __export(index_exports, {
   WsClient: () => WsClient,
   buildAuthLoginUrl: () => buildAuthLoginUrl,
   combineSignals: () => combineSignals,
+  compareSemver: () => compareSemver,
   createAdminApiClient: () => createAdminApiClient,
   createAdminApiClientFromHttpClient: () => createAdminApiClientFromHttpClient,
   createAuthApiClient: () => createAuthApiClient,
@@ -697,6 +698,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;
@@ -712,6 +731,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));
   }
@@ -1027,7 +1097,7 @@ var AdminApiClient = class {
     await this.httpClient.put(`/admin-api/groups/${groupId}/metadata`, request);
   }
   async getGroupMetadata(groupId) {
-    return unwrap(await this.httpClient.get(`/admin-api/groups/${groupId}/metadata`)).data;
+    return unwrap(await this.httpClient.get(`/admin-api/groups/${groupId}/metadata`))?.data ?? null;
   }
   async setMemberMetadata(groupId, identity, request) {
     await this.httpClient.put(`/admin-api/groups/${groupId}/members/${identity}/metadata`, request);
@@ -1035,7 +1105,7 @@ var AdminApiClient = class {
   async getMemberMetadata(groupId, identity) {
     return unwrap(
       await this.httpClient.get(`/admin-api/groups/${groupId}/members/${identity}/metadata`)
-    ).data;
+    )?.data ?? null;
   }
   async setContextMetadata(groupId, contextId, request) {
     await this.httpClient.put(`/admin-api/groups/${groupId}/contexts/${contextId}/metadata`, request);
@@ -1043,7 +1113,7 @@ var AdminApiClient = class {
   async getContextMetadata(groupId, contextId) {
     return unwrap(
       await this.httpClient.get(`/admin-api/groups/${groupId}/contexts/${contextId}/metadata`)
-    ).data;
+    )?.data ?? null;
   }
   async syncGroup(groupId, request) {
     return unwrap(await this.httpClient.post(`/admin-api/groups/${groupId}/sync`, request ?? {}));