@calimero-network/mero-js 26.4.1 → 26.5.0

package/dist/index.d.ts

@@ -28,8 +28,8 @@ export { signerFromSecret, signerFromCryptoKey } from "./signer/index.js";
 export type { Signer } from "./signer/index.js";
 export { generateAccountRoot, accountRootFromPhrase, accountRootFromSecret, createAccountRootSigner, accountRootSignerFromPhrase, signAccountLink, signAccountLogin, resolveRoot, resolveRootPair, } from "./account/index.js";
 export type { AccountRoot, RecoverableAccountRoot, AccountRootSigner, NewAccountRootSigner, AccountLinkInput, AccountLoginInput, RootSource, ResolvedRoot, } from "./account/index.js";
-export { readDelegatedSession, saveDelegatedSession, clearDelegatedSession, readDelegatedCredential, saveDelegatedCredential, clearDelegatedCredential, persistedNonces, markContextNonceSpent, pinRelayNodeKey, readPinnedRelayNodeKey, attemptRelayNodeKey, resolveRelayNodeKey, learnRelayNodeKey, RELAY_NODE_KEY_RETRY_MS, forgetMethodKinds, forgetRelaySealing, relayTransportFetch, buildDelegatedClient, readRelayMap, rememberRelay, relayForContext, carryExecutorAccount, knownRelays, listDelegatedContexts, listDelegatedNamespaces, resolveRelayFromInvitation, normaliseAccount, joinWithNode, bootstrapFromInvitation, joinAsAccount, createDelegatedContext, createDelegatedPrivateContext, foundDelegatedNamespace, delegatedGovernance, latestPublishedVersion, HA_ACCOUNT_NOT_LINKED_MESSAGE, HA_REFUSAL_MESSAGES, governGroup, governRoot, namespaceOfGroup, rememberGroupNamespace, applicationIdForBundle, fetchRegistryBundles, resolveApplicationIdFromRegistry, selectLatestBundle, createAccountAdmin, InvitationNotClaimableError, NoRelayError, NotForAccountError, createNodeAdmin, } from "./account/index.js";
-export type { DelegatedCredential, DelegatedAccountSession, RelayMap, RelayNodeKeyAttempt, RelayResolutionStep, RelayResolutionFailure, ResolvedInvitationRelay, ResolveRelayResult, ResolveRelayFromInvitationInput, JoinWithNodeInput, JoinWithNodeResult, JoinWithNodeSuccess, JoinWithNodeFailure, JoinWithNodeStep, BootstrapStep, BootstrapResult, BootstrapSuccess, BootstrapFailure, BootstrapFromInvitationInput, CreateDelegatedContextRequest, FoundedDelegatedNamespace, RegistryBundle, ResolvedApplication, AccountAdminDeps, NodeAdminDeps, } from "./account/index.js";
+export { readDelegatedSession, saveDelegatedSession, clearDelegatedSession, readDelegatedCredential, saveDelegatedCredential, clearDelegatedCredential, persistedNonces, markContextNonceSpent, pinRelayNodeKey, readPinnedRelayNodeKey, attemptRelayNodeKey, resolveRelayNodeKey, learnRelayNodeKey, RELAY_NODE_KEY_RETRY_MS, forgetMethodKinds, forgetRelaySealing, relayTransportFetch, buildDelegatedClient, readRelayMap, rememberRelay, relayForContext, carryExecutorAccount, knownRelays, listDelegatedContexts, listDelegatedNamespaces, RelaysUnavailableError, resolveRelayFromInvitation, normaliseAccount, joinWithNode, bootstrapFromInvitation, joinAsAccount, createDelegatedContext, createDelegatedPrivateContext, foundDelegatedNamespace, delegatedGovernance, latestPublishedVersion, HA_ACCOUNT_NOT_LINKED_MESSAGE, HA_REFUSAL_MESSAGES, governGroup, governRoot, namespaceOfGroup, rememberGroupNamespace, applicationIdForBundle, fetchRegistryBundles, resolveApplicationIdFromRegistry, selectLatestBundle, createAccountAdmin, InvitationNotClaimableError, NoRelayError, NotForAccountError, createNodeAdmin, } from "./account/index.js";
+export type { DelegatedCredential, DelegatedAccountSession, RelayMap, RelayNodeKeyAttempt, RelayListingFailure, RelayResolutionStep, RelayResolutionFailure, ResolvedInvitationRelay, ResolveRelayResult, ResolveRelayFromInvitationInput, JoinWithNodeInput, JoinWithNodeResult, JoinWithNodeSuccess, JoinWithNodeFailure, JoinWithNodeStep, BootstrapStep, BootstrapResult, BootstrapSuccess, BootstrapFailure, BootstrapFromInvitationInput, CreateDelegatedContextRequest, FoundedDelegatedNamespace, RegistryBundle, ResolvedApplication, AccountAdminDeps, NodeAdminDeps, } from "./account/index.js";
 export { signDeviceCert, mintDeviceId, deviceCertPayload, accountForRoot, accountForRootPublicKey, parseDeviceCredential, verifyDeviceCredential, } from "./device-cert/index.js";
 export type { DeviceCertInput, DeviceCredential } from "./device-cert/index.js";
 export { signDeviceScope, deviceScopePayload } from "./device-cert/index.js";

package/dist/index.js

@@ -52,7 +52,7 @@ resolveRoot, resolveRootPair, } from "./account/index.js";
 // Framework-free; mero-react re-exports every one of these under the same name
 // (its `DelegatedSession` is `DelegatedAccountSession` here: the login module
 // already owns the bare name for the session `login()` mints).
-export { readDelegatedSession, saveDelegatedSession, clearDelegatedSession, readDelegatedCredential, saveDelegatedCredential, clearDelegatedCredential, persistedNonces, markContextNonceSpent, pinRelayNodeKey, readPinnedRelayNodeKey, attemptRelayNodeKey, resolveRelayNodeKey, learnRelayNodeKey, RELAY_NODE_KEY_RETRY_MS, forgetMethodKinds, forgetRelaySealing, relayTransportFetch, buildDelegatedClient, readRelayMap, rememberRelay, relayForContext, carryExecutorAccount, knownRelays, listDelegatedContexts, listDelegatedNamespaces, resolveRelayFromInvitation, normaliseAccount, joinWithNode, bootstrapFromInvitation, joinAsAccount, createDelegatedContext, createDelegatedPrivateContext, foundDelegatedNamespace, delegatedGovernance, latestPublishedVersion, HA_ACCOUNT_NOT_LINKED_MESSAGE, HA_REFUSAL_MESSAGES, governGroup, governRoot, namespaceOfGroup, rememberGroupNamespace, applicationIdForBundle, fetchRegistryBundles, resolveApplicationIdFromRegistry, selectLatestBundle, createAccountAdmin, InvitationNotClaimableError, NoRelayError, NotForAccountError, createNodeAdmin, } from "./account/index.js";
+export { readDelegatedSession, saveDelegatedSession, clearDelegatedSession, readDelegatedCredential, saveDelegatedCredential, clearDelegatedCredential, persistedNonces, markContextNonceSpent, pinRelayNodeKey, readPinnedRelayNodeKey, attemptRelayNodeKey, resolveRelayNodeKey, learnRelayNodeKey, RELAY_NODE_KEY_RETRY_MS, forgetMethodKinds, forgetRelaySealing, relayTransportFetch, buildDelegatedClient, readRelayMap, rememberRelay, relayForContext, carryExecutorAccount, knownRelays, listDelegatedContexts, listDelegatedNamespaces, RelaysUnavailableError, resolveRelayFromInvitation, normaliseAccount, joinWithNode, bootstrapFromInvitation, joinAsAccount, createDelegatedContext, createDelegatedPrivateContext, foundDelegatedNamespace, delegatedGovernance, latestPublishedVersion, HA_ACCOUNT_NOT_LINKED_MESSAGE, HA_REFUSAL_MESSAGES, governGroup, governRoot, namespaceOfGroup, rememberGroupNamespace, applicationIdForBundle, fetchRegistryBundles, resolveApplicationIdFromRegistry, selectLatestBundle, createAccountAdmin, InvitationNotClaimableError, NoRelayError, NotForAccountError, createNodeAdmin, } from "./account/index.js";
 export { signDeviceCert, mintDeviceId, deviceCertPayload, accountForRoot, accountForRootPublicKey, parseDeviceCredential, verifyDeviceCredential, } from "./device-cert/index.js";
 // A device's scope — signed by the root beside its certificate, and what a relay
 // needs with it to bind the device of an account that has no node.

package/dist/index.mjs

@@ -9570,24 +9570,53 @@ function knownRelays(s) {
   const all = [s.relayUrl, ...Object.values(map.namespaces), ...Object.values(map.contexts)].filter((u) => typeof u === "string" && u.length > 0).map(relayOrigin);
   return [...new Set(all)];
 }
+var RelaysUnavailableError = class extends Error {
+  constructor(failures) {
+    super(`none of this account's relays answered: ${failures.map((f) => `${f.relayUrl} (${f.kind})`).join(", ")}`);
+    this.failures = failures;
+    this.name = "RelaysUnavailableError";
+    this.relays = failures.map((f) => f.relayUrl);
+  }
+  /** Every relay refused its attestation: retrying will not help. */
+  get refused() {
+    return this.failures.every((f) => f.kind === "refused");
+  }
+};
+async function listingClient(s, relayUrl) {
+  const key = await attemptRelayNodeKey(relayUrl);
+  if (key.kind !== "learned") {
+    console.warn("[mero-js] could not learn the relay node key from its attestation", key.error);
+    return { failure: { relayUrl, kind: key.kind, error: key.error } };
+  }
+  const client2 = buildDelegatedClient({ ...s, relayUrl }, null);
+  if (!client2) return { failure: { relayUrl, kind: "unavailable", error: new Error(`no client for ${relayUrl}`) } };
+  return { client: client2 };
+}
 async function listDelegatedContexts(s) {
   const out = [];
   const map = readRelayMap(s.account);
-  for (const relayUrl of knownRelays(s)) {
+  const relays = knownRelays(s);
+  const failures = [];
+  for (const relayUrl of relays) {
+    const got = await listingClient(s, relayUrl);
+    if ("failure" in got) {
+      failures.push(got.failure);
+      continue;
+    }
+    const { client: client2 } = got;
     try {
-      if (!await resolveRelayNodeKey(relayUrl)) continue;
-      const client2 = buildDelegatedClient({ ...s, relayUrl }, null);
-      if (!client2) continue;
       const { contexts } = await client2.admin.getContexts();
       for (const c of contexts ?? []) {
         out.push({ ...c, relayUrl });
         map.contexts[c.id] = relayUrl;
       }
     } catch (e) {
+      failures.push({ relayUrl, kind: "unavailable", error: e });
       console.warn(`[mero-js] could not list contexts on ${relayUrl}`, e);
     }
   }
   writeRelayMap(s.account, map);
+  if (relays.length > 0 && failures.length === relays.length) throw new RelaysUnavailableError(failures);
   return out;
 }
 async function listDelegatedNamespaces(s) {
@@ -9595,11 +9624,16 @@ async function listDelegatedNamespaces(s) {
   const out = [];
   const seen = /* @__PURE__ */ new Set();
   const map = readRelayMap(s.account);
-  for (const relayUrl of knownRelays(s)) {
+  const relays = knownRelays(s);
+  const failures = [];
+  for (const relayUrl of relays) {
+    const got = await listingClient(s, relayUrl);
+    if ("failure" in got) {
+      failures.push(got.failure);
+      continue;
+    }
+    const { client: client2 } = got;
     try {
-      if (!await resolveRelayNodeKey(relayUrl)) continue;
-      const client2 = buildDelegatedClient({ ...s, relayUrl }, null);
-      if (!client2) continue;
       for (const ns of await client2.admin.listNamespaces()) {
         if (seen.has(ns.namespaceId)) continue;
         seen.add(ns.namespaceId);
@@ -9607,10 +9641,12 @@ async function listDelegatedNamespaces(s) {
         (_a = map.namespaces)[_b = ns.namespaceId] ?? (_a[_b] = relayUrl);
       }
     } catch (e) {
+      failures.push({ relayUrl, kind: "unavailable", error: e });
       console.warn(`[mero-js] could not list namespaces on ${relayUrl}`, e);
     }
   }
   writeRelayMap(s.account, map);
+  if (relays.length > 0 && failures.length === relays.length) throw new RelaysUnavailableError(failures);
   return out;
 }
 
@@ -13133,6 +13169,7 @@ export {
   RelayObserver,
   RelayPresenceClient,
   RelayTransport,
+  RelaysUnavailableError,
   RpcClient,
   RpcError,
   SEALED_CONTENT_TYPE,