@le-space/ui 0.7.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@le-space/ui",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "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.7.0",
-    "@le-space/core": "0.7.0",
+    "@le-space/browser": "0.9.0",
+    "@le-space/core": "0.9.0",
     "viem": "^2.53.1"
   },
   "peerDependencies": {

package/react/index.d.ts

@@ -1,5 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+type CrnSource = 'list' | 'aggregate';
+type CrnSourcePreference = 'auto' | 'aggregate' | 'list';
+
 type MessageStatus = 'processed' | 'pending' | 'rejected' | 'removing' | 'removed' | 'unknown';
 interface BalanceResponse {
     address: string;
@@ -222,6 +225,12 @@ interface SponsorRelayProps {
     apiHost?: string;
     apiHosts?: string | readonly string[];
     crnListUrl?: string;
+    /**
+     * Which CRN source to read. `auto` falls back to the corechannel aggregate
+     * when crns.json is down, `aggregate` skips crns.json, `list` disables the
+     * fallback. `localStorage.LE_SPACE_CRN_SOURCE` overrides this at runtime.
+     */
+    crnSource?: CrnSourcePreference;
     schedulerApiHost?: string;
     twoN6ApiHost?: string;
 }
@@ -255,6 +264,12 @@ interface CompactInstanceDetails {
     vmIpv4: string | null;
     webUrl: string | null;
     sshCommand: string | null;
+    /**
+     * Hostname of the deployment's HTTPS proxy. The mapped ports are plain HTTP,
+     * which a browser on an HTTPS page refuses to fetch, so this is the only
+     * address the card can read the relay's own documents from.
+     */
+    proxyHostname: string | null;
     mappedPorts: Array<{
         label: string;
         hostPort: number | null;
@@ -262,6 +277,32 @@ interface CompactInstanceDetails {
     execution: InstanceExecution | null;
     error: string | null;
 }
+/** One transport's worth of addresses, as the relay itself groups them. */
+interface SponsorRelayAddressGroup {
+    key: string;
+    label: string;
+    addresses: string[];
+}
+/**
+ * What a deployment reports about itself at `/multiaddrs`. Deliberately not
+ * normalised into "the best address": the card shows what the relay says, and
+ * choosing between addresses is the consumer's business, not this UI's.
+ */
+interface SponsorRelayInstanceAddresses {
+    status: 'idle' | 'loading' | 'ready' | 'unsupported' | 'error';
+    /** Transport groups, empty for a profile that publishes no libp2p addresses. */
+    groups: SponsorRelayAddressGroup[];
+    /** Ready-to-paste environment block, when the profile publishes one. */
+    pwaEnv: Record<string, string> | null;
+    /** Raw payload, rendered verbatim on the health tab. */
+    payload: Record<string, unknown> | null;
+    peerId: string | null;
+    version: string | null;
+    fetchedAt: number | null;
+    error: string | null;
+    /** Source URL, shown so a person can curl exactly what the card read. */
+    sourceUrl: string | null;
+}
 interface CompactInstanceRecord {
     instance: InstanceMessage;
     details: CompactInstanceDetails;
@@ -314,6 +355,8 @@ interface SponsorRelayState {
     pricingSummary: SponsorRelayPricingSummary;
     balance: BalanceResponse | null;
     crns: Crn[];
+    /** Which source the current `crns` came from; `null` until the first load. */
+    crnSource: CrnSource | null;
     selectedCrn: Crn | null;
     crnOptions: Array<{
         hash: string;
@@ -326,6 +369,13 @@ interface SponsorRelayState {
     orphanBootstrapRegistrations: CompactBootstrapRegistrationRecord[];
     lastDeploymentHash: string | null;
     deploymentProgress: DeploymentProgressEvent;
+    /**
+     * What each deployment reports at `/multiaddrs`, keyed by instance item hash.
+     * Fetched on demand rather than with the instance list: AutoTLS addresses only
+     * appear a minute or two after a deploy reports success, so this is state that
+     * has to be refreshable on its own.
+     */
+    instanceAddresses: Record<string, SponsorRelayInstanceAddresses>;
 }
 type SponsorRelaySubscriber = (state: SponsorRelayState) => void;
 
@@ -379,6 +429,18 @@ declare class SponsorRelayController {
     private refreshWalletDerivedState;
     refresh(): Promise<void>;
     deploy(): Promise<void>;
+    /**
+     * Read one deployment's own address document over its HTTPS proxy.
+     *
+     * The mapped ports are plain HTTP, which a browser on an HTTPS page refuses to
+     * fetch, so the proxy hostname is the only way in. Deliberately single-shot:
+     * unlike the deploy-time readiness probe this backs a button someone pressed,
+     * and a caller who wants newer data presses it again.
+     */
+    loadInstanceAddresses(instanceHash: string, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    private patchInstanceAddresses;
     deleteInstance(instanceHash: string): Promise<void>;
     deleteBootstrapRegistration(registrationHash: string): Promise<void>;
 }