@le-space/browser 0.1.29 → 0.1.30

package/README.md

@@ -27,6 +27,7 @@ That client should remain small and stable. It currently owns:
 - message envelope lookup
 - scheduler allocation lookup
 - CRN allocation notify
+- relay setup-server configure request
 - deployment result inspection and polling
 - Aleph message broadcast helpers
 

package/index.d.ts

@@ -164,6 +164,21 @@ interface InstanceAllocation {
 interface AllocationNotifyResult {
     status: 'confirmed' | 'unconfirmed';
 }
+interface RelaySetupRequest {
+    hostIpv4: string;
+    publicIpv6?: string | null;
+    setupPort: number;
+    tcpPort: number;
+    wsPort: number;
+    proxyUrl?: string | null;
+    metricsPort?: number | null;
+    metricsHttpsPort?: number | null;
+    webrtcPort?: number | null;
+    quicPort?: number | null;
+}
+interface RelaySetupResult {
+    status: 'configured' | 'unconfirmed';
+}
 interface AlephBroadcastMessage {
     sender: string;
     chain: AlephSenderChain;
@@ -197,6 +212,7 @@ interface AlephBrowserClient {
     fetchMessageEnvelope(itemHash: string): Promise<AlephMessageEnvelope | null>;
     fetchSchedulerAllocation(itemHash: string): Promise<InstanceAllocation | null>;
     notifyCrnAllocation(crnUrl: string, itemHash: string): Promise<AllocationNotifyResult>;
+    configureOrbitdbRelaySetup(args: RelaySetupRequest): Promise<RelaySetupResult>;
     inspectDeploymentResult(itemHash: string, rootfsRef?: string): Promise<DeploymentInspectionResult>;
     waitForDeploymentResult(itemHash: string, rootfsRef?: string, attempts?: number, delayMs?: number): Promise<DeploymentInspectionResult>;
     broadcastInstanceMessage(message: AlephBroadcastMessage, sync?: boolean): Promise<BroadcastResult>;
@@ -251,6 +267,7 @@ declare function fetchCrns(url?: string): Promise<Crn[]>;
 declare function fetchInstances(address: string, apiHost?: string): Promise<InstanceMessage[]>;
 declare function fetchSchedulerAllocation(itemHash: string, schedulerApiHost?: string): Promise<InstanceAllocation | null>;
 declare function notifyCrnAllocation(crnUrl: string, itemHash: string): Promise<AllocationNotifyResult>;
+declare function configureOrbitdbRelaySetup(args: RelaySetupRequest): Promise<RelaySetupResult>;
 declare function fetchMessageEnvelope(itemHash: string, apiHost?: string): Promise<AlephMessageEnvelope | null>;
 declare function inspectDeploymentResult(itemHash: string, rootfsRef?: string, apiHost?: string): Promise<DeploymentInspectionResult>;
 declare function waitForDeploymentResult(itemHash: string, rootfsRef?: string, apiHost?: string, attempts?: number, delayMs?: number): Promise<DeploymentInspectionResult>;
@@ -279,4 +296,4 @@ declare const DEFAULT_ALEPH_AGGREGATE_ADDRESS = "0xFba561a84A537fCaa567bb7A2257e
 declare function parseInstancePricing(payload: unknown): InstancePricing;
 declare function fetchInstancePricing(apiHost?: string, aggregateAddress?: string): Promise<PricingState>;
 
-export { type AlephBroadcastMessage, type AlephBroadcastResponse, type AlephBrowserClient, type AlephMessageEnvelope, type AlephMessageType, type AlephSenderChain, type AllocationNotifyResult, BROWSER_PACKAGE_PLAN, type BalanceResponse, type BroadcastResult, type BrowserExtractionPhase, type BrowserPackagePlan, type ComputeUnit, type CreateAlephBrowserClientOptions, type Crn, type CrnListResponse, type CrnLocation, type CrnUsage, DEFAULT_ALEPH_AGGREGATE_ADDRESS, DEFAULT_ALEPH_API_HOST, DEFAULT_ALEPH_SCHEDULER_API_HOST, DEFAULT_CRN_LIST_URL, DEFAULT_IPFS_GATEWAY_BASE_URL, DEFAULT_ROOTFS_MANIFEST_URL, type DeploymentInspectionResult, type GatewayProbeStatus, ITEM_HASH_RE, type InstanceAllocation, type InstanceAllocationNode, type InstanceAllocationPeriod, type InstanceMessage, type InstancePricing, type LoadRootfsManifestOptions, type MessageReference, type MessageStatus, type PaymentMode, type Price, type PricingState, type ReferenceStatus, type RootfsManifest, type RootfsManifestState, type RootfsRequiredPortForward, type RootfsResolution, type Tier, broadcastAlephMessage, broadcastInstanceMessage, createAlephBrowserClient, fetchBalance, fetchCrns, fetchInstancePricing, fetchInstances, fetchMessageEnvelope, fetchSchedulerAllocation, fetchWithTimeout, inspectDeploymentResult, loadRootfsManifest, normalizeMessageStatus, notifyCrnAllocation, parseInstancePricing, resolveRootfsReference, validateRootfsManifest, verifyRootfsExists, waitForDeploymentResult };
+export { type AlephBroadcastMessage, type AlephBroadcastResponse, type AlephBrowserClient, type AlephMessageEnvelope, type AlephMessageType, type AlephSenderChain, type AllocationNotifyResult, BROWSER_PACKAGE_PLAN, type BalanceResponse, type BroadcastResult, type BrowserExtractionPhase, type BrowserPackagePlan, type ComputeUnit, type CreateAlephBrowserClientOptions, type Crn, type CrnListResponse, type CrnLocation, type CrnUsage, DEFAULT_ALEPH_AGGREGATE_ADDRESS, DEFAULT_ALEPH_API_HOST, DEFAULT_ALEPH_SCHEDULER_API_HOST, DEFAULT_CRN_LIST_URL, DEFAULT_IPFS_GATEWAY_BASE_URL, DEFAULT_ROOTFS_MANIFEST_URL, type DeploymentInspectionResult, type GatewayProbeStatus, ITEM_HASH_RE, type InstanceAllocation, type InstanceAllocationNode, type InstanceAllocationPeriod, type InstanceMessage, type InstancePricing, type LoadRootfsManifestOptions, type MessageReference, type MessageStatus, type PaymentMode, type Price, type PricingState, type ReferenceStatus, type RelaySetupRequest, type RelaySetupResult, type RootfsManifest, type RootfsManifestState, type RootfsRequiredPortForward, type RootfsResolution, type Tier, broadcastAlephMessage, broadcastInstanceMessage, configureOrbitdbRelaySetup, createAlephBrowserClient, fetchBalance, fetchCrns, fetchInstancePricing, fetchInstances, fetchMessageEnvelope, fetchSchedulerAllocation, fetchWithTimeout, inspectDeploymentResult, loadRootfsManifest, normalizeMessageStatus, notifyCrnAllocation, parseInstancePricing, resolveRootfsReference, validateRootfsManifest, verifyRootfsExists, waitForDeploymentResult };

package/index.js

@@ -147,6 +147,43 @@ async function notifyCrnAllocation(crnUrl, itemHash) {
     throw error;
   }
 }
+async function configureOrbitdbRelaySetup(args) {
+  const targetUrl = `http://${args.hostIpv4}:${args.setupPort}/configure`;
+  try {
+    const response = await fetchWithTimeout(
+      targetUrl,
+      {
+        method: "POST",
+        headers: {
+          "content-type": "text/plain;charset=UTF-8"
+        },
+        body: JSON.stringify({
+          public_ipv4: args.hostIpv4,
+          public_ipv6: args.publicIpv6 ?? void 0,
+          tcp_port: args.tcpPort,
+          ws_port: args.wsPort,
+          proxy_url: args.proxyUrl ?? void 0,
+          metrics_port: args.metricsPort ?? void 0,
+          metrics_https_port: args.metricsHttpsPort ?? void 0,
+          webrtc_port: args.webrtcPort ?? void 0,
+          quic_port: args.quicPort ?? void 0
+        }),
+        mode: "cors"
+      },
+      3e4
+    );
+    if (!response.ok) {
+      const responseText = await response.text().catch(() => "");
+      throw new Error(`Relay setup request failed: ${response.status}${responseText ? ` ${responseText}` : ""}`);
+    }
+    return { status: "configured" };
+  } catch (error) {
+    if (isUnconfirmedNetworkError(error)) {
+      return { status: "unconfirmed" };
+    }
+    throw error;
+  }
+}
 function messageTypeFromEnvelope(payload) {
   if (!payload) return null;
   const type = payload.type ?? payload.message?.type ?? (Array.isArray(payload.messages) ? payload.messages[0]?.type : void 0);
@@ -310,6 +347,9 @@ function createAlephBrowserClient(options = {}) {
     notifyCrnAllocation(crnUrl, itemHash) {
       return notifyCrnAllocation(crnUrl, itemHash);
     },
+    configureOrbitdbRelaySetup(args) {
+      return configureOrbitdbRelaySetup(args);
+    },
     inspectDeploymentResult(itemHash, rootfsRef) {
       return inspectDeploymentResult(itemHash, rootfsRef, apiHost);
     },
@@ -545,6 +585,7 @@ export {
   ITEM_HASH_RE,
   broadcastAlephMessage,
   broadcastInstanceMessage,
+  configureOrbitdbRelaySetup,
   createAlephBrowserClient,
   fetchBalance,
   fetchCrns,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@le-space/browser",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "description": "Shared browser-safe Aleph deployment and polling helpers.",
   "license": "MIT",
   "type": "module",