@le-space/ui 0.1.52

package/shared/index.d.ts

@@ -0,0 +1,339 @@
+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 const DEFAULT_INSTANCE_NAME = "sponsor-relay";
+declare const DEFAULT_MANIFEST_URL = "./rootfs-manifest.json";
+declare const DEFAULT_TIER_ID = "tier-1";
+declare const ROOTFS_MISSING_STATE: SponsorRelayRootfsHealth;
+declare const RELAY_PING_IDLE_STATE: RelayPingState;
+declare const REFRESH_INTERVAL_MS = 30000;
+declare const RELAY_PING_INTERVAL_MS = 20000;
+
+declare function shortHash(value: string | null | undefined, head?: number, tail?: number): string;
+declare function formatNumber(value: number | null | undefined, digits?: number): string;
+declare function formatDateTime(value: string | number | null | undefined): string;
+declare function buildSshCommand(hostIpv4: string | null, mappedPorts: CompactInstanceRecord['details']['mappedPorts']): string | null;
+declare function joinMappedPorts(mappedPorts: CompactInstanceRecord['details']['mappedPorts']): string;
+
+declare function resolveManifestSource(args: {
+    manifestJson: string;
+}): RootfsManifestState | null;
+
+interface EthereumProviderLike {
+    isMetaMask?: boolean;
+    request<T = unknown>(args: {
+        method: string;
+        params?: unknown[] | Record<string, unknown>;
+    }): Promise<T>;
+    on?(event: string, listener: (...args: unknown[]) => void): void;
+    removeListener?(event: string, listener: (...args: unknown[]) => void): void;
+}
+declare function getEthereumProvider(): EthereumProviderLike | null;
+declare function connectWallet(provider?: EthereumProviderLike | null): Promise<SponsorRelayWalletState>;
+declare function personalSign(address: string, message: string, provider?: EthereumProviderLike | null): Promise<string>;
+declare function watchWallet(onChange: () => void, provider?: EthereumProviderLike | null): () => 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 createSponsorRelayController(props?: SponsorRelayProps): SponsorRelayController;
+
+export { type CompactInstanceDetails, type CompactInstanceRecord, DEFAULT_INSTANCE_NAME, DEFAULT_MANIFEST_URL, DEFAULT_TIER_ID, type EthereumProviderLike, REFRESH_INTERVAL_MS, RELAY_PING_IDLE_STATE, RELAY_PING_INTERVAL_MS, ROOTFS_MISSING_STATE, type RelayPingState, SponsorRelayController, type SponsorRelayHealthTone, type SponsorRelayPricingSummary, type SponsorRelayProps, type SponsorRelayRootfsHealth, type SponsorRelayState, type SponsorRelaySubscriber, type SponsorRelayWalletState, buildSshCommand, connectWallet, createSponsorRelayController, formatDateTime, formatNumber, getEthereumProvider, joinMappedPorts, personalSign, resolveManifestSource, shortHash, watchWallet };