@le-space/ui 0.1.52

package/README.md

@@ -0,0 +1,22 @@
+# @le-space/ui
+
+Floating Aleph relay deployment UI components for Svelte and React.
+
+Primary goals:
+
+- Svelte-first floating `Sponsor Relay` panel
+- lightweight React wrapper
+- shared controller and browser-safe Aleph helpers
+- minimal host configuration beyond a rootfs manifest URL
+
+Entry points:
+
+- `@le-space/ui/shared`
+- `@le-space/ui/svelte`
+- `@le-space/ui/react`
+
+Example:
+
+```ts
+import SponsorRelayFab from '@le-space/ui/svelte'
+```

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@le-space/ui",
+  "version": "0.1.52",
+  "description": "Floating Aleph sponsor relay UI components for Svelte and React.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./shared/index.js",
+  "types": "./shared/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./shared/index.d.ts",
+      "import": "./shared/index.js"
+    },
+    "./shared": {
+      "types": "./shared/index.d.ts",
+      "import": "./shared/index.js"
+    },
+    "./react": {
+      "types": "./react/index.d.ts",
+      "import": "./react/index.js"
+    },
+    "./svelte": "./svelte/index.js",
+    "./styles.css": "./styles.css"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@le-space/browser": "0.1.52",
+    "@le-space/core": "0.1.52"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18",
+    "svelte": ">=4"
+  }
+}

package/react/index.d.ts

@@ -0,0 +1,315 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type MessageStatus = 'processed' | 'pending' | 'rejected' | 'unknown';
+interface BalanceResponse {
+    address: string;
+    balance: string;
+    locked_amount: string;
+    details?: Record<string, string>;
+    credit_balance: number;
+}
+interface Price {
+    payg?: string | number | null;
+    holding?: string | number | null;
+    fixed?: string | number | null;
+    credit?: string | number | null;
+}
+interface ComputeUnit {
+    vcpus: number;
+    memory_mib: number;
+    disk_mib: number;
+}
+interface Tier {
+    id: string;
+    compute_units: number;
+    vram?: number | null;
+    model?: string | null;
+}
+interface InstancePricing {
+    price: {
+        storage?: Price;
+        compute_unit?: Price;
+    };
+    compute_unit: ComputeUnit;
+    tiers: Tier[];
+}
+interface CrnUsage {
+    cpu?: {
+        count?: number;
+    };
+    mem?: {
+        available_kB?: number;
+    };
+    disk?: {
+        available_kB?: number;
+    };
+    active?: boolean;
+}
+interface CrnLocation {
+    city?: string | null;
+    region?: string | null;
+    country?: string | null;
+    country_code?: string | null;
+}
+interface Crn {
+    hash: string;
+    name: string;
+    address: string;
+    score?: number | string | null;
+    performance?: number | string | null;
+    decentralization?: number | string | null;
+    qemu_support?: boolean;
+    confidential_support?: boolean;
+    gpu_support?: boolean;
+    system_usage?: CrnUsage | null;
+    payment_receiver_address?: string | null;
+    version?: string | null;
+    city?: string | null;
+    region?: string | null;
+    country?: string | null;
+    country_code?: string | null;
+    location?: CrnLocation | string | null;
+    resolved_ip?: string | null;
+    geo_source?: string | null;
+}
+type PaymentMode = 'hold' | 'credit';
+interface InstanceMessage {
+    item_hash: string;
+    sender: string;
+    chain: string;
+    type: 'INSTANCE';
+    channel?: string;
+    content?: {
+        metadata?: {
+            name?: string;
+        };
+        payment?: {
+            type?: PaymentMode;
+            chain?: string;
+        };
+        rootfs?: {
+            parent?: {
+                ref?: string;
+            };
+            size_mib?: number;
+        };
+        requirements?: {
+            node?: {
+                node_hash?: string;
+            };
+        };
+    };
+    time?: string | number;
+    reception_time?: string;
+    confirmed?: boolean;
+    status?: string;
+}
+interface InstancePortMapping {
+    host?: number;
+    tcp?: boolean;
+    udp?: boolean;
+}
+interface InstanceExecutionStatus {
+    defined_at?: string | null;
+    preparing_at?: string | null;
+    prepared_at?: string | null;
+    starting_at?: string | null;
+    started_at?: string | null;
+    stopping_at?: string | null;
+    stopped_at?: string | null;
+}
+interface InstanceExecutionNetworking {
+    ipv4?: string | null;
+    ipv6?: string | null;
+    ipv4_network?: string | null;
+    host_ipv4?: string | null;
+    ipv6_network?: string | null;
+    ipv6_ip?: string | null;
+    ipv4_ip?: string | null;
+    proxy_url?: string | null;
+    mapped_ports?: Record<string, InstancePortMapping>;
+}
+interface InstanceExecution {
+    crnUrl: string;
+    version: 'v1' | 'v2';
+    running?: boolean;
+    networking: InstanceExecutionNetworking;
+    status?: InstanceExecutionStatus | null;
+}
+interface RootfsRequiredPortForward {
+    port: number;
+    tcp?: boolean;
+    udp?: boolean;
+    purpose?: string;
+}
+interface RootfsManifest {
+    profile?: string;
+    version: string;
+    rootfsInstallStrategy?: 'thin' | 'prebaked' | string;
+    requiresBootstrapNetwork?: boolean;
+    bootstrapSummary?: string;
+    requiredPortForwards?: RootfsRequiredPortForward[];
+    rootfsItemHash: string;
+    rootfsSizeMiB: number;
+    rootfsSourceSizeBytes?: number;
+    createdAt: string;
+    notes?: string;
+}
+interface RootfsManifestState {
+    manifest: RootfsManifest | null;
+    valid: boolean;
+    errors: string[];
+}
+type GatewayProbeStatus = 'reachable' | 'timeout' | 'error' | 'unavailable' | 'unknown';
+interface RootfsResolution {
+    itemHash: string;
+    messageStatus: MessageStatus;
+    messageType: string | null;
+    cid: string | null;
+    receptionTime?: string | null;
+    rejectionErrorCode?: number | null;
+    rejectionReason?: string | null;
+    gatewayUrl: string | null;
+    gatewayStatus: GatewayProbeStatus;
+    gatewayError?: string | null;
+}
+
+type SponsorRelayHealthTone = 'ok' | 'caution' | 'error' | 'idle';
+interface SponsorRelayProps {
+    libp2p?: unknown;
+    manifestUrl?: string;
+    manifestJson?: string;
+    sshPublicKey?: string;
+    instanceName?: string;
+    showInstances?: boolean;
+    openByDefault?: boolean;
+    launcherMode?: 'floating' | 'inline';
+    apiHost?: string;
+    crnListUrl?: string;
+    schedulerApiHost?: string;
+    twoN6ApiHost?: string;
+}
+interface SponsorRelayWalletState {
+    connected: boolean;
+    address: string | null;
+    chainId: string | null;
+    isMetaMask: boolean;
+}
+interface SponsorRelayPricingSummary {
+    pricing: InstancePricing | null;
+    tier: Tier | null;
+    requiredCredits: number | null;
+    availableCredits: number | null;
+    vcpus: number | null;
+    memoryMiB: number | null;
+    diskMiB: number | null;
+}
+interface SponsorRelayRootfsHealth {
+    tone: SponsorRelayHealthTone;
+    label: string;
+    detail: string | null;
+}
+interface RelayPingState {
+    tone: SponsorRelayHealthTone;
+    sent: boolean;
+    received: boolean;
+    lastPeerId: string | null;
+    lastLatencyMs: number | null;
+    lastSentAt: number | null;
+    lastReceivedAt: number | null;
+    error: string | null;
+}
+interface CompactInstanceDetails {
+    messageStatus: string;
+    allocationSource: string | null;
+    crnUrl: string | null;
+    hostIpv4: string | null;
+    ipv6: string | null;
+    vmIpv4: string | null;
+    webUrl: string | null;
+    sshCommand: string | null;
+    mappedPorts: Array<{
+        label: string;
+        hostPort: number | null;
+    }>;
+    execution: InstanceExecution | null;
+    error: string | null;
+}
+interface CompactInstanceRecord {
+    instance: InstanceMessage;
+    details: CompactInstanceDetails;
+}
+interface SponsorRelayState {
+    ready: boolean;
+    open: boolean;
+    wallet: SponsorRelayWalletState;
+    manifestUrl: string;
+    manifestJson: string;
+    sshPublicKey: string;
+    instanceName: string;
+    tierId: string;
+    showInstances: boolean;
+    showPasteManifest: boolean;
+    busy: {
+        connectingWallet: boolean;
+        refreshing: boolean;
+        deploying: boolean;
+        deletingInstanceHash: string | null;
+    };
+    statusText: string;
+    errorText: string | null;
+    manifestState: RootfsManifestState;
+    manifest: RootfsManifest | null;
+    rootfsResolution: RootfsResolution | null;
+    rootfsVerified: boolean;
+    rootfsHealth: SponsorRelayRootfsHealth;
+    pricingSummary: SponsorRelayPricingSummary;
+    balance: BalanceResponse | null;
+    crns: Crn[];
+    selectedCrn: Crn | null;
+    instances: CompactInstanceRecord[];
+    relayPing: RelayPingState;
+    lastDeploymentHash: string | null;
+}
+type SponsorRelaySubscriber = (state: SponsorRelayState) => void;
+
+declare class SponsorRelayController {
+    private state;
+    private subscribers;
+    private client;
+    private refreshTimer;
+    private pingTimer;
+    private stopWalletWatch;
+    private props;
+    constructor(props?: SponsorRelayProps);
+    subscribe(subscriber: SponsorRelaySubscriber): () => void;
+    getState(): SponsorRelayState;
+    private emit;
+    private patch;
+    init(): Promise<void>;
+    destroy(): void;
+    setOpen(open: boolean): void;
+    toggleOpen(): void;
+    setManifestUrl(manifestUrl: string): void;
+    setManifestJson(manifestJson: string): void;
+    setShowPasteManifest(showPasteManifest: boolean): void;
+    setSshPublicKey(sshPublicKey: string): void;
+    setInstanceName(instanceName: string): void;
+    setTierId(tierId: string): void;
+    private recomputePricingSummary;
+    connectWallet(): Promise<void>;
+    private refreshWalletDerivedState;
+    refresh(): Promise<void>;
+    refreshRelayPing(): Promise<void>;
+    deploy(): Promise<void>;
+    deleteInstance(instanceHash: string): Promise<void>;
+}
+
+declare function SponsorRelayFab(props: SponsorRelayProps): react_jsx_runtime.JSX.Element;
+
+declare function useSponsorRelayController(props: SponsorRelayProps): {
+    controller: SponsorRelayController;
+    state: SponsorRelayState;
+};
+
+export { SponsorRelayFab, SponsorRelayFab as default, useSponsorRelayController };