@le-space/browser 0.1.22 → 0.1.23

package/index.d.ts

@@ -4,13 +4,100 @@ interface BrowserPackagePlan {
     modules: string[];
 }
 declare const BROWSER_PACKAGE_PLAN: BrowserPackagePlan;
+type MessageStatus = 'processed' | 'pending' | 'rejected' | 'unknown';
+interface BalanceResponse {
+    address: string;
+    balance: string;
+    locked_amount: string;
+    details?: Record<string, string>;
+    credit_balance: number;
+}
+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;
+}
+interface CrnListResponse {
+    crns: Crn[];
+}
+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;
+}
 
 declare function fetchWithTimeout(input: RequestInfo | URL, init?: RequestInit, timeoutMs?: number): Promise<Response>;
 
-declare const BROWSER_ALEPH_API_MODULE = "planned";
+declare const DEFAULT_ALEPH_API_HOST = "https://api2.aleph.im";
+declare const DEFAULT_CRN_LIST_URL = "https://crns-list.aleph.sh/crns.json";
+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 const BROWSER_ROOTFS_MODULE = "planned";
 
 declare const BROWSER_PRICING_MODULE = "planned";
 
-export { BROWSER_ALEPH_API_MODULE, BROWSER_PACKAGE_PLAN, BROWSER_PRICING_MODULE, BROWSER_ROOTFS_MODULE, type BrowserExtractionPhase, type BrowserPackagePlan, fetchWithTimeout };
+export { BROWSER_PACKAGE_PLAN, BROWSER_PRICING_MODULE, BROWSER_ROOTFS_MODULE, type BalanceResponse, type BrowserExtractionPhase, type BrowserPackagePlan, type Crn, type CrnListResponse, type CrnLocation, type CrnUsage, DEFAULT_ALEPH_API_HOST, DEFAULT_CRN_LIST_URL, type InstanceMessage, type MessageStatus, type PaymentMode, fetchBalance, fetchCrns, fetchInstances, fetchWithTimeout, normalizeMessageStatus };

package/index.js

@@ -34,7 +34,47 @@ async function fetchWithTimeout(input, init = {}, timeoutMs = 15e3) {
 }
 
 // src/aleph-api.ts
-var BROWSER_ALEPH_API_MODULE = "planned";
+var DEFAULT_ALEPH_API_HOST = "https://api2.aleph.im";
+var DEFAULT_CRN_LIST_URL = "https://crns-list.aleph.sh/crns.json";
+function normalizeMessageStatus(status) {
+  if (typeof status !== "string") return "unknown";
+  const normalized = status.toLowerCase();
+  if (normalized === "processed" || normalized === "pending" || normalized === "rejected") {
+    return normalized;
+  }
+  return "unknown";
+}
+async function fetchBalance(address, apiHost = DEFAULT_ALEPH_API_HOST) {
+  const response = await fetchWithTimeout(`${apiHost}/api/v0/addresses/${address}/balance`, {
+    cache: "no-cache"
+  });
+  if (!response.ok) throw new Error(`Balance request failed: ${response.status}`);
+  return await response.json();
+}
+async function fetchCrns(url = DEFAULT_CRN_LIST_URL) {
+  const requestUrl = new URL(url);
+  requestUrl.searchParams.set("filter_inactive", "true");
+  const response = await fetchWithTimeout(requestUrl, { cache: "no-cache" });
+  if (!response.ok) throw new Error(`CRN list request failed: ${response.status}`);
+  const payload = await response.json();
+  return payload.crns ?? [];
+}
+async function fetchInstances(address, apiHost = DEFAULT_ALEPH_API_HOST) {
+  const url = new URL("/api/v0/messages.json", apiHost);
+  url.searchParams.set("msgTypes", "INSTANCE");
+  url.searchParams.set("addresses", address);
+  url.searchParams.set("message_statuses", "processed,pending,rejected,removing");
+  url.searchParams.set("pagination", "100");
+  url.searchParams.set("page", "1");
+  url.searchParams.set("sortOrder", "-1");
+  const response = await fetchWithTimeout(url, { cache: "no-cache" });
+  if (!response.ok) throw new Error(`Instance list request failed: ${response.status}`);
+  const payload = await response.json();
+  return (payload.messages ?? []).map((message) => ({
+    ...message,
+    status: typeof message.status === "string" && message.status.trim() ? message.status : message.confirmed ? "processed" : message.status
+  }));
+}
 
 // src/rootfs.ts
 var BROWSER_ROOTFS_MODULE = "planned";
@@ -42,9 +82,14 @@ var BROWSER_ROOTFS_MODULE = "planned";
 // src/pricing.ts
 var BROWSER_PRICING_MODULE = "planned";
 export {
-  BROWSER_ALEPH_API_MODULE,
   BROWSER_PACKAGE_PLAN,
   BROWSER_PRICING_MODULE,
   BROWSER_ROOTFS_MODULE,
-  fetchWithTimeout
+  DEFAULT_ALEPH_API_HOST,
+  DEFAULT_CRN_LIST_URL,
+  fetchBalance,
+  fetchCrns,
+  fetchInstances,
+  fetchWithTimeout,
+  normalizeMessageStatus
 };

package/package.json

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