@le-space/browser 0.1.27 → 0.1.29

package/README.md

@@ -25,6 +25,8 @@ That client should remain small and stable. It currently owns:
 - CRN listing
 - instance listing
 - message envelope lookup
+- scheduler allocation lookup
+- CRN allocation notify
 - deployment result inspection and polling
 - Aleph message broadcast helpers
 

package/index.d.ts

@@ -143,6 +143,27 @@ interface DeploymentInspectionResult {
     rejectionReason: string | null;
     references: MessageReference[];
 }
+interface InstanceAllocationNode {
+    node_id?: string;
+    url?: string;
+    ipv6?: string | null;
+    supports_ipv6?: boolean;
+}
+interface InstanceAllocationPeriod {
+    start_timestamp?: string;
+    duration_seconds?: number;
+}
+interface InstanceAllocation {
+    source: 'scheduler' | 'manual';
+    crnHash?: string | null;
+    crnUrl?: string | null;
+    node?: InstanceAllocationNode | null;
+    vmIpv6?: string | null;
+    period?: InstanceAllocationPeriod | null;
+}
+interface AllocationNotifyResult {
+    status: 'confirmed' | 'unconfirmed';
+}
 interface AlephBroadcastMessage {
     sender: string;
     chain: AlephSenderChain;
@@ -169,10 +190,13 @@ interface BroadcastResult {
 interface AlephBrowserClient {
     apiHost: string;
     crnListUrl: string;
+    schedulerApiHost: string;
     fetchBalance(address: string): Promise<BalanceResponse>;
     fetchCrns(): Promise<Crn[]>;
     fetchInstances(address: string): Promise<InstanceMessage[]>;
     fetchMessageEnvelope(itemHash: string): Promise<AlephMessageEnvelope | null>;
+    fetchSchedulerAllocation(itemHash: string): Promise<InstanceAllocation | null>;
+    notifyCrnAllocation(crnUrl: string, itemHash: string): Promise<AllocationNotifyResult>;
     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>;
@@ -220,10 +244,13 @@ declare function fetchWithTimeout(input: RequestInfo | URL, init?: RequestInit,
 
 declare const DEFAULT_ALEPH_API_HOST = "https://api2.aleph.im";
 declare const DEFAULT_CRN_LIST_URL = "https://crns-list.aleph.sh/crns.json";
+declare const DEFAULT_ALEPH_SCHEDULER_API_HOST = "https://scheduler.api.aleph.cloud";
 declare function normalizeMessageStatus(status: unknown): MessageStatus;
 declare function fetchBalance(address: string, apiHost?: string): Promise<BalanceResponse>;
 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 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>;
@@ -233,6 +260,7 @@ declare function broadcastAlephMessage(message: AlephBroadcastMessage, apiHost?:
 interface CreateAlephBrowserClientOptions {
     apiHost?: string;
     crnListUrl?: string;
+    schedulerApiHost?: string;
 }
 declare function createAlephBrowserClient(options?: CreateAlephBrowserClientOptions): AlephBrowserClient;
 
@@ -251,4 +279,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, 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_CRN_LIST_URL, DEFAULT_IPFS_GATEWAY_BASE_URL, DEFAULT_ROOTFS_MANIFEST_URL, type DeploymentInspectionResult, type GatewayProbeStatus, ITEM_HASH_RE, 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, fetchWithTimeout, inspectDeploymentResult, loadRootfsManifest, normalizeMessageStatus, 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 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 };

package/index.js

@@ -50,6 +50,7 @@ async function fetchWithTimeout(input, init = {}, timeoutMs = 15e3) {
 // src/aleph-api.ts
 var DEFAULT_ALEPH_API_HOST = "https://api2.aleph.im";
 var DEFAULT_CRN_LIST_URL = "https://crns-list.aleph.sh/crns.json";
+var DEFAULT_ALEPH_SCHEDULER_API_HOST = "https://scheduler.api.aleph.cloud";
 function normalizeMessageStatus(status) {
   if (typeof status !== "string") return "unknown";
   const normalized = status.toLowerCase();
@@ -58,6 +59,16 @@ function normalizeMessageStatus(status) {
   }
   return "unknown";
 }
+function asString(value) {
+  return typeof value === "string" && value.trim() ? value : null;
+}
+function asNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function isUnconfirmedNetworkError(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return error instanceof TypeError || message.includes("Failed to fetch") || message.includes("Request timed out");
+}
 async function fetchBalance(address, apiHost = DEFAULT_ALEPH_API_HOST) {
   const response = await fetchWithTimeout(`${apiHost}/api/v0/addresses/${address}/balance`, {
     cache: "no-cache"
@@ -89,6 +100,53 @@ async function fetchInstances(address, apiHost = DEFAULT_ALEPH_API_HOST) {
     status: typeof message.status === "string" && message.status.trim() ? message.status : message.confirmed ? "processed" : message.status
   }));
 }
+async function fetchSchedulerAllocation(itemHash, schedulerApiHost = DEFAULT_ALEPH_SCHEDULER_API_HOST) {
+  const response = await fetchWithTimeout(`${schedulerApiHost}/api/v0/allocation/${itemHash}`, {
+    cache: "no-cache"
+  });
+  if (response.status === 404) return null;
+  if (!response.ok) throw new Error(`Scheduler allocation request failed: ${response.status}`);
+  const payload = await response.json();
+  const node = payload.node;
+  return {
+    source: "scheduler",
+    crnUrl: asString(node?.url),
+    node: node ? {
+      node_id: asString(node.node_id) ?? void 0,
+      url: asString(node.url) ?? void 0,
+      ipv6: asString(node.ipv6),
+      supports_ipv6: typeof node.supports_ipv6 === "boolean" ? node.supports_ipv6 : void 0
+    } : null,
+    vmIpv6: asString(payload.vm_ipv6),
+    period: payload.period ? {
+      start_timestamp: asString(payload.period.start_timestamp) ?? void 0,
+      duration_seconds: asNumber(payload.period.duration_seconds) ?? void 0
+    } : null
+  };
+}
+async function notifyCrnAllocation(crnUrl, itemHash) {
+  const normalizedCrnUrl = crnUrl.replace(/\/+$/, "");
+  try {
+    const response = await fetchWithTimeout(`${normalizedCrnUrl}/control/allocation/notify`, {
+      method: "POST",
+      headers: {
+        "content-type": "text/plain;charset=UTF-8"
+      },
+      body: JSON.stringify({ instance: itemHash }),
+      mode: "cors"
+    });
+    if (!response.ok) {
+      const responseText = await response.text().catch(() => "");
+      throw new Error(`CRN allocation notify failed: ${response.status}${responseText ? ` ${responseText}` : ""}`);
+    }
+    return { status: "confirmed" };
+  } 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);
@@ -229,9 +287,11 @@ async function broadcastAlephMessage(message, apiHost = DEFAULT_ALEPH_API_HOST,
 function createAlephBrowserClient(options = {}) {
   const apiHost = options.apiHost ?? DEFAULT_ALEPH_API_HOST;
   const crnListUrl = options.crnListUrl ?? DEFAULT_CRN_LIST_URL;
+  const schedulerApiHost = options.schedulerApiHost ?? DEFAULT_ALEPH_SCHEDULER_API_HOST;
   return {
     apiHost,
     crnListUrl,
+    schedulerApiHost,
     fetchBalance(address) {
       return fetchBalance(address, apiHost);
     },
@@ -244,6 +304,12 @@ function createAlephBrowserClient(options = {}) {
     fetchMessageEnvelope(itemHash) {
       return fetchMessageEnvelope(itemHash, apiHost);
     },
+    fetchSchedulerAllocation(itemHash) {
+      return fetchSchedulerAllocation(itemHash, schedulerApiHost);
+    },
+    notifyCrnAllocation(crnUrl, itemHash) {
+      return notifyCrnAllocation(crnUrl, itemHash);
+    },
     inspectDeploymentResult(itemHash, rootfsRef) {
       return inspectDeploymentResult(itemHash, rootfsRef, apiHost);
     },
@@ -472,6 +538,7 @@ export {
   BROWSER_PACKAGE_PLAN,
   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,
@@ -484,10 +551,12 @@ export {
   fetchInstancePricing,
   fetchInstances,
   fetchMessageEnvelope,
+  fetchSchedulerAllocation,
   fetchWithTimeout,
   inspectDeploymentResult,
   loadRootfsManifest,
   normalizeMessageStatus,
+  notifyCrnAllocation,
   parseInstancePricing,
   resolveRootfsReference,
   validateRootfsManifest,

package/package.json

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