@le-space/ui 0.9.4 → 0.9.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@le-space/ui",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Floating Aleph Relay Button UI components for Svelte and React.",
   "license": "MIT",
   "type": "module",
@@ -44,8 +44,8 @@
     "url": "https://github.com/NiKrause/relay-button/issues"
   },
   "dependencies": {
-    "@le-space/browser": "0.9.4",
-    "@le-space/core": "0.9.4",
+    "@le-space/browser": "0.9.5",
+    "@le-space/core": "0.9.5",
     "viem": "^2.53.1"
   },
   "peerDependencies": {

package/react/index.js

@@ -96,7 +96,7 @@ var RECENT_INSTANCE_RUNTIME_GRACE_MS = 10 * 60 * 1e3;
 var DEPLOYMENT_PENDING_WARNING_MS = 3 * 60 * 1e3;
 
 // src/shared/package-version.ts
-var UI_PACKAGE_VERSION = "0.9.4";
+var UI_PACKAGE_VERSION = "0.9.5";
 
 // src/shared/format.ts
 function shortHash(value, head = 8, tail = 6) {
@@ -3207,20 +3207,24 @@ async function fetchAlephBootstrapPosts(options = {}) {
   }
   const payload = await response.json();
   const posts = (payload.posts ?? []).map((entry) => normalizeRelayBootstrapPostRecord(entry)).filter((entry) => entry != null).sort((left, right) => compareRelayBootstrapPostRecency(right, left));
-  posts.forEach(assertSupportedRelayBootstrapPost);
-  return posts;
+  return usableRelayBootstrapPosts(posts, options.onUnsupportedPost);
 }
-function assertSupportedRelayBootstrapPost(post) {
+function unsupportedRelayBootstrapReason(post) {
   if (post.type === "relay-bootstrap") {
-    throw new Error(
-      "Legacy relay-bootstrap record encountered. Only relay-bootstrap-v2 is supported."
-    );
+    return "legacy relay-bootstrap record; only relay-bootstrap-v2 is supported";
   }
   if (post.type && post.type !== DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE) {
-    throw new Error(
-      `Unsupported relay bootstrap post type: ${post.type}. Expected ${DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE}.`
-    );
+    return `unsupported post type ${post.type}; expected ${DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE}`;
   }
+  return null;
+}
+function usableRelayBootstrapPosts(posts, onUnsupportedPost) {
+  return posts.filter((post) => {
+    const reason = unsupportedRelayBootstrapReason(post);
+    if (!reason) return true;
+    onUnsupportedPost?.({ hash: post.itemHash ?? post.hash, reason });
+    return false;
+  });
 }
 function compareRelayBootstrapPostRecency(left, right) {
   const leftUpdatedAt = left.content?.updatedAt ?? 0;
@@ -3241,8 +3245,7 @@ function selectCurrentRelayBootstrapPosts(posts, options = {}) {
   const maxAgeMs = options.maxAgeMs ?? DEFAULT_BOOTSTRAP_MAX_AGE_MS;
   const now = options.now ?? Date.now();
   const selected = /* @__PURE__ */ new Map();
-  for (const post of posts) {
-    assertSupportedRelayBootstrapPost(post);
+  for (const post of usableRelayBootstrapPosts(posts, options.onUnsupportedPost)) {
     const content = post.content;
     if (!content) continue;
     if (now - content.updatedAt > maxAgeMs) continue;
@@ -3959,8 +3962,29 @@ function describeRequest(input, init) {
   const url = typeof input === "string" ? input : input instanceof URL ? input.toString() : typeof input?.url === "string" ? input.url : "<unknown url>";
   return `${method} ${url}`;
 }
+function describeThrown(error) {
+  if (error instanceof Error) {
+    const cause = error.cause;
+    const causeText = cause != null && cause !== error ? ` (cause: ${describeThrown(cause)})` : "";
+    return `${error.message}${causeText}`;
+  }
+  if (typeof error === "object" && error !== null) {
+    const message = error.message;
+    if (typeof message === "string" && message.trim()) return message;
+    try {
+      const json = JSON.stringify(error);
+      if (json && json !== "{}") {
+        return json.length > 400 ? `${json.slice(0, 400)}\u2026` : json;
+      }
+    } catch {
+    }
+    const name = error.constructor?.name;
+    return name && name !== "Object" ? `<${name}>` : "<object with no message>";
+  }
+  return String(error);
+}
 function deploymentFailureMessage(error, stage) {
-  const message = error instanceof Error ? error.message : String(error);
+  const message = describeThrown(error);
   const step = String(stage ?? "").trim();
   return step ? `${message} (while: ${step})` : message;
 }
@@ -3972,7 +3996,7 @@ function asJsonFetch(input, init) {
       json: async () => await response.json()
     }),
     (error) => {
-      const reason = error instanceof Error ? error.message : String(error);
+      const reason = describeThrown(error);
       throw new Error(`${reason} (${describeRequest(input, init)})`, {
         cause: error
       });
@@ -4160,7 +4184,7 @@ function defaultState(props = {}) {
   };
 }
 function manifestLoadErrorState(error) {
-  const message = error instanceof Error ? error.message : String(error);
+  const message = describeThrown(error);
   return {
     manifest: null,
     valid: false,
@@ -4205,7 +4229,7 @@ function hostnameOfUrl(value) {
 }
 var INSTANCE_ADDRESS_TIMEOUT_MS = 1e4;
 function describeInstanceAddressFailure(error, sourceUrl) {
-  const raw = error instanceof Error ? error.message : String(error);
+  const raw = describeThrown(error);
   if (error instanceof Error && error.name === "AbortError") {
     return `${sourceUrl} did not answer within ${INSTANCE_ADDRESS_TIMEOUT_MS / 1e3}s. Press Refresh to try again.`;
   }
@@ -4504,7 +4528,7 @@ async function inspectInstanceRuntime(args) {
     return {
       details: {
         ...details,
-        error: error instanceof Error ? error.message : String(error)
+        error: describeThrown(error)
       },
       lookup
     };
@@ -5333,7 +5357,7 @@ var SponsorRelayController = class {
         this.trace("deploy:bootstrap-config-cleanup-error", {
           itemHash: args.itemHash,
           deploymentToken: args.deploymentToken,
-          error: error instanceof Error ? error.message : String(error)
+          error: describeThrown(error)
         });
       });
       await this.cleanupStaleVmBootstrapConfigHistory({
@@ -5401,7 +5425,7 @@ var SponsorRelayController = class {
       this.trace("deploy:bootstrap-config-history-scan-error", {
         itemHash: args.itemHash,
         currentAggregateItemHash: args.currentAggregateItemHash,
-        error: error instanceof Error ? error.message : String(error)
+        error: describeThrown(error)
       });
       return [];
     });
@@ -5444,7 +5468,7 @@ var SponsorRelayController = class {
         itemHash: args.itemHash,
         currentAggregateItemHash: args.currentAggregateItemHash,
         staleHashes,
-        error: error instanceof Error ? error.message : String(error)
+        error: describeThrown(error)
       });
     });
   }
@@ -5765,7 +5789,7 @@ var SponsorRelayController = class {
     } catch (error) {
       this.patch({
         busy: { connectingWallet: false },
-        errorText: error instanceof Error ? error.message : String(error),
+        errorText: describeThrown(error),
         statusText: "Wallet connection failed"
       });
     }
@@ -5981,7 +6005,7 @@ var SponsorRelayController = class {
       this.trace("refresh:error", error);
       this.patch({
         busy: { refreshing: false },
-        errorText: error instanceof Error ? error.message : String(error),
+        errorText: describeThrown(error),
         statusText: "Refresh failed"
       });
     }
@@ -6316,7 +6340,7 @@ var SponsorRelayController = class {
           });
           return;
         } catch (error) {
-          lastError = error instanceof Error ? error : new Error(String(error));
+          lastError = error instanceof Error ? error : new Error(describeThrown(error), { cause: error });
           const attemptLabel = crnDisplayName;
           const failedDueToInvalidIpv6 = /not globally routable|public guest IPv6/i.test(lastError.message);
           attemptErrors.push(`${attemptLabel}: ${lastError.message}`);
@@ -6745,7 +6769,7 @@ var SponsorRelayController = class {
       this.trace("delete:error", error);
       this.patch({
         busy: { deletingInstanceHash: null },
-        errorText: error instanceof Error ? error.message : String(error),
+        errorText: describeThrown(error),
         statusText: "Delete failed"
       });
     }
@@ -6811,7 +6835,7 @@ var SponsorRelayController = class {
       this.trace("registration-delete:error", error);
       this.patch({
         busy: { deletingRegistrationHash: null },
-        errorText: error instanceof Error ? error.message : String(error),
+        errorText: describeThrown(error),
         statusText: "Registration cleanup failed"
       });
     }

package/shared/index.d.ts

@@ -480,7 +480,7 @@ declare const STALE_INSTANCE_ALLOCATION_COOLDOWN_MS: number;
 declare const RECENT_INSTANCE_RUNTIME_GRACE_MS: number;
 declare const DEPLOYMENT_PENDING_WARNING_MS: number;
 
-declare const UI_PACKAGE_VERSION = "0.9.4";
+declare const UI_PACKAGE_VERSION = "0.9.5";
 
 interface RootfsRequiredPortForward {
     port: number;
@@ -539,6 +539,24 @@ declare function describeRequest(input: RequestInfo | URL, init?: RequestInit):
  *
  * Exported for its test.
  */
+/**
+ * Say what was thrown, even when it was not an `Error`.
+ *
+ * `String(value)` on a plain object is `"[object Object]"`, and that is what a
+ * user saw when every CRN failed at once: five candidates, five identical
+ * `[object Object]`, and no way to tell whether they had failed for one reason
+ * or five. Not every rejection in this path is an `Error` — an Aleph or CRN
+ * response rejected as `{ code, message }` is an object, and so is anything a
+ * dependency throws as a bare literal.
+ *
+ * Order matters: a `message` field is what the thrower meant to say, so it wins
+ * over a dump of the whole object. The dump is the fallback, truncated, because
+ * an unreadable line is still better than a line saying nothing — and a cyclic
+ * object must not take the error handler down with it.
+ *
+ * Exported for its test.
+ */
+declare function describeThrown(error: unknown): string;
 declare function deploymentFailureMessage(error: unknown, stage: string | null | undefined): string;
 /**
  * Normalise the two address documents in the fleet into one list of groups.
@@ -628,4 +646,4 @@ interface DeploymentProgressEmitter {
 }
 declare function createDeploymentProgressEmitter(): DeploymentProgressEmitter;
 
-export { type CompactBootstrapRegistrationRecord, type CompactInstanceDetails, type CompactInstanceRecord, DEFAULT_FAB_CORNER, DEFAULT_INSTANCE_NAME, DEFAULT_MANIFEST_URL, DEFAULT_TIER_ID, DEFAULT_UCAN_STORE_ALLOWED_CAPABILITIES, DEFAULT_UCAN_STORE_MAX_DELEGATION_EXPIRATION_SECONDS, DEFAULT_UCAN_STORE_PWA_ORIGIN, DEFAULT_UCAN_STORE_SERVICE_DID, DEFAULT_UCAN_STORE_SERVICE_ORIGIN, DEFAULT_UCAN_STORE_USER_DELEGATION_EXPIRATION_SECONDS, DEPLOYMENT_PENDING_WARNING_MS, type DeploymentProgressEmitter, type EthereumProviderLike, FAB_DRAG_THRESHOLD, FAB_EDGE_MARGIN, type FabCorner, type FabPanelPlacement, type FabPanelSide, type FabPlacement, type FabPoint, type FabSize, type FabViewport, IDLE_DEPLOYMENT_PROGRESS, INSTANCE_RUNTIME_PENDING_REFRESH_MS, INSTANCE_RUNTIME_READY_REFRESH_MS, INSTANCE_RUNTIME_STALE_REFRESH_MS, MANIFEST_SOURCE_REFRESH_DEBOUNCE_MS, RECENT_INSTANCE_RUNTIME_GRACE_MS, REFRESH_INTERVAL_MS, ROOTFS_MISSING_STATE, STALE_INSTANCE_ALLOCATION_COOLDOWN_MS, type SponsorRelayAddressGroup, SponsorRelayController, type SponsorRelayHealthTone, type SponsorRelayInstanceAddresses, type SponsorRelayPricingSummary, type SponsorRelayProps, type SponsorRelayRootfsHealth, type SponsorRelayState, type SponsorRelaySubscriber, type SponsorRelayUcanStoreBootstrapInput, type SponsorRelayWalletState, UI_PACKAGE_VERSION, anchorPanelToLauncher, buildSshCommand, clampToViewport, connectWallet, createDeploymentProgressEmitter, createSponsorRelayController, deploymentFailureMessage, describeRequest, dragExceedsThreshold, formatDateTime, formatNumber, formatTierSpecLabel, getEthereumProvider, joinMappedPorts, joinRequiredPortForwards, parseInstanceAddressPayload, personalSign, readStoredPosition, resolveCornerPlacement, resolveManifestSource, rootfsHealth, shortHash, toChecksumAddress, watchWallet, writeStoredPosition };
+export { type CompactBootstrapRegistrationRecord, type CompactInstanceDetails, type CompactInstanceRecord, DEFAULT_FAB_CORNER, DEFAULT_INSTANCE_NAME, DEFAULT_MANIFEST_URL, DEFAULT_TIER_ID, DEFAULT_UCAN_STORE_ALLOWED_CAPABILITIES, DEFAULT_UCAN_STORE_MAX_DELEGATION_EXPIRATION_SECONDS, DEFAULT_UCAN_STORE_PWA_ORIGIN, DEFAULT_UCAN_STORE_SERVICE_DID, DEFAULT_UCAN_STORE_SERVICE_ORIGIN, DEFAULT_UCAN_STORE_USER_DELEGATION_EXPIRATION_SECONDS, DEPLOYMENT_PENDING_WARNING_MS, type DeploymentProgressEmitter, type EthereumProviderLike, FAB_DRAG_THRESHOLD, FAB_EDGE_MARGIN, type FabCorner, type FabPanelPlacement, type FabPanelSide, type FabPlacement, type FabPoint, type FabSize, type FabViewport, IDLE_DEPLOYMENT_PROGRESS, INSTANCE_RUNTIME_PENDING_REFRESH_MS, INSTANCE_RUNTIME_READY_REFRESH_MS, INSTANCE_RUNTIME_STALE_REFRESH_MS, MANIFEST_SOURCE_REFRESH_DEBOUNCE_MS, RECENT_INSTANCE_RUNTIME_GRACE_MS, REFRESH_INTERVAL_MS, ROOTFS_MISSING_STATE, STALE_INSTANCE_ALLOCATION_COOLDOWN_MS, type SponsorRelayAddressGroup, SponsorRelayController, type SponsorRelayHealthTone, type SponsorRelayInstanceAddresses, type SponsorRelayPricingSummary, type SponsorRelayProps, type SponsorRelayRootfsHealth, type SponsorRelayState, type SponsorRelaySubscriber, type SponsorRelayUcanStoreBootstrapInput, type SponsorRelayWalletState, UI_PACKAGE_VERSION, anchorPanelToLauncher, buildSshCommand, clampToViewport, connectWallet, createDeploymentProgressEmitter, createSponsorRelayController, deploymentFailureMessage, describeRequest, describeThrown, dragExceedsThreshold, formatDateTime, formatNumber, formatTierSpecLabel, getEthereumProvider, joinMappedPorts, joinRequiredPortForwards, parseInstanceAddressPayload, personalSign, readStoredPosition, resolveCornerPlacement, resolveManifestSource, rootfsHealth, shortHash, toChecksumAddress, watchWallet, writeStoredPosition };

package/shared/index.js

@@ -96,7 +96,7 @@ var RECENT_INSTANCE_RUNTIME_GRACE_MS = 10 * 60 * 1e3;
 var DEPLOYMENT_PENDING_WARNING_MS = 3 * 60 * 1e3;
 
 // src/shared/package-version.ts
-var UI_PACKAGE_VERSION = "0.9.4";
+var UI_PACKAGE_VERSION = "0.9.5";
 
 // src/shared/format.ts
 function shortHash(value, head = 8, tail = 6) {
@@ -3207,20 +3207,24 @@ async function fetchAlephBootstrapPosts(options = {}) {
   }
   const payload = await response.json();
   const posts = (payload.posts ?? []).map((entry) => normalizeRelayBootstrapPostRecord(entry)).filter((entry) => entry != null).sort((left, right) => compareRelayBootstrapPostRecency(right, left));
-  posts.forEach(assertSupportedRelayBootstrapPost);
-  return posts;
+  return usableRelayBootstrapPosts(posts, options.onUnsupportedPost);
 }
-function assertSupportedRelayBootstrapPost(post) {
+function unsupportedRelayBootstrapReason(post) {
   if (post.type === "relay-bootstrap") {
-    throw new Error(
-      "Legacy relay-bootstrap record encountered. Only relay-bootstrap-v2 is supported."
-    );
+    return "legacy relay-bootstrap record; only relay-bootstrap-v2 is supported";
   }
   if (post.type && post.type !== DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE) {
-    throw new Error(
-      `Unsupported relay bootstrap post type: ${post.type}. Expected ${DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE}.`
-    );
+    return `unsupported post type ${post.type}; expected ${DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE}`;
   }
+  return null;
+}
+function usableRelayBootstrapPosts(posts, onUnsupportedPost) {
+  return posts.filter((post) => {
+    const reason = unsupportedRelayBootstrapReason(post);
+    if (!reason) return true;
+    onUnsupportedPost?.({ hash: post.itemHash ?? post.hash, reason });
+    return false;
+  });
 }
 function compareRelayBootstrapPostRecency(left, right) {
   const leftUpdatedAt = left.content?.updatedAt ?? 0;
@@ -3241,8 +3245,7 @@ function selectCurrentRelayBootstrapPosts(posts, options = {}) {
   const maxAgeMs = options.maxAgeMs ?? DEFAULT_BOOTSTRAP_MAX_AGE_MS;
   const now = options.now ?? Date.now();
   const selected = /* @__PURE__ */ new Map();
-  for (const post of posts) {
-    assertSupportedRelayBootstrapPost(post);
+  for (const post of usableRelayBootstrapPosts(posts, options.onUnsupportedPost)) {
     const content = post.content;
     if (!content) continue;
     if (now - content.updatedAt > maxAgeMs) continue;
@@ -3959,8 +3962,29 @@ function describeRequest(input, init) {
   const url = typeof input === "string" ? input : input instanceof URL ? input.toString() : typeof input?.url === "string" ? input.url : "<unknown url>";
   return `${method} ${url}`;
 }
+function describeThrown(error) {
+  if (error instanceof Error) {
+    const cause = error.cause;
+    const causeText = cause != null && cause !== error ? ` (cause: ${describeThrown(cause)})` : "";
+    return `${error.message}${causeText}`;
+  }
+  if (typeof error === "object" && error !== null) {
+    const message = error.message;
+    if (typeof message === "string" && message.trim()) return message;
+    try {
+      const json = JSON.stringify(error);
+      if (json && json !== "{}") {
+        return json.length > 400 ? `${json.slice(0, 400)}\u2026` : json;
+      }
+    } catch {
+    }
+    const name = error.constructor?.name;
+    return name && name !== "Object" ? `<${name}>` : "<object with no message>";
+  }
+  return String(error);
+}
 function deploymentFailureMessage(error, stage) {
-  const message = error instanceof Error ? error.message : String(error);
+  const message = describeThrown(error);
   const step = String(stage ?? "").trim();
   return step ? `${message} (while: ${step})` : message;
 }
@@ -3972,7 +3996,7 @@ function asJsonFetch(input, init) {
       json: async () => await response.json()
     }),
     (error) => {
-      const reason = error instanceof Error ? error.message : String(error);
+      const reason = describeThrown(error);
       throw new Error(`${reason} (${describeRequest(input, init)})`, {
         cause: error
       });
@@ -4160,7 +4184,7 @@ function defaultState(props = {}) {
   };
 }
 function manifestLoadErrorState(error) {
-  const message = error instanceof Error ? error.message : String(error);
+  const message = describeThrown(error);
   return {
     manifest: null,
     valid: false,
@@ -4205,7 +4229,7 @@ function hostnameOfUrl(value) {
 }
 var INSTANCE_ADDRESS_TIMEOUT_MS = 1e4;
 function describeInstanceAddressFailure(error, sourceUrl) {
-  const raw = error instanceof Error ? error.message : String(error);
+  const raw = describeThrown(error);
   if (error instanceof Error && error.name === "AbortError") {
     return `${sourceUrl} did not answer within ${INSTANCE_ADDRESS_TIMEOUT_MS / 1e3}s. Press Refresh to try again.`;
   }
@@ -4504,7 +4528,7 @@ async function inspectInstanceRuntime(args) {
     return {
       details: {
         ...details,
-        error: error instanceof Error ? error.message : String(error)
+        error: describeThrown(error)
       },
       lookup
     };
@@ -5333,7 +5357,7 @@ var SponsorRelayController = class {
         this.trace("deploy:bootstrap-config-cleanup-error", {
           itemHash: args.itemHash,
           deploymentToken: args.deploymentToken,
-          error: error instanceof Error ? error.message : String(error)
+          error: describeThrown(error)
         });
       });
       await this.cleanupStaleVmBootstrapConfigHistory({
@@ -5401,7 +5425,7 @@ var SponsorRelayController = class {
       this.trace("deploy:bootstrap-config-history-scan-error", {
         itemHash: args.itemHash,
         currentAggregateItemHash: args.currentAggregateItemHash,
-        error: error instanceof Error ? error.message : String(error)
+        error: describeThrown(error)
       });
       return [];
     });
@@ -5444,7 +5468,7 @@ var SponsorRelayController = class {
         itemHash: args.itemHash,
         currentAggregateItemHash: args.currentAggregateItemHash,
         staleHashes,
-        error: error instanceof Error ? error.message : String(error)
+        error: describeThrown(error)
       });
     });
   }
@@ -5765,7 +5789,7 @@ var SponsorRelayController = class {
     } catch (error) {
       this.patch({
         busy: { connectingWallet: false },
-        errorText: error instanceof Error ? error.message : String(error),
+        errorText: describeThrown(error),
         statusText: "Wallet connection failed"
       });
     }
@@ -5981,7 +6005,7 @@ var SponsorRelayController = class {
       this.trace("refresh:error", error);
       this.patch({
         busy: { refreshing: false },
-        errorText: error instanceof Error ? error.message : String(error),
+        errorText: describeThrown(error),
         statusText: "Refresh failed"
       });
     }
@@ -6316,7 +6340,7 @@ var SponsorRelayController = class {
           });
           return;
         } catch (error) {
-          lastError = error instanceof Error ? error : new Error(String(error));
+          lastError = error instanceof Error ? error : new Error(describeThrown(error), { cause: error });
           const attemptLabel = crnDisplayName;
           const failedDueToInvalidIpv6 = /not globally routable|public guest IPv6/i.test(lastError.message);
           attemptErrors.push(`${attemptLabel}: ${lastError.message}`);
@@ -6745,7 +6769,7 @@ var SponsorRelayController = class {
       this.trace("delete:error", error);
       this.patch({
         busy: { deletingInstanceHash: null },
-        errorText: error instanceof Error ? error.message : String(error),
+        errorText: describeThrown(error),
         statusText: "Delete failed"
       });
     }
@@ -6811,7 +6835,7 @@ var SponsorRelayController = class {
       this.trace("registration-delete:error", error);
       this.patch({
         busy: { deletingRegistrationHash: null },
-        errorText: error instanceof Error ? error.message : String(error),
+        errorText: describeThrown(error),
         statusText: "Registration cleanup failed"
       });
     }
@@ -6853,6 +6877,7 @@ export {
   createSponsorRelayController,
   deploymentFailureMessage,
   describeRequest,
+  describeThrown,
   dragExceedsThreshold,
   formatDateTime,
   formatNumber,