@le-space/browser 0.1.22

package/README.md

@@ -0,0 +1,49 @@
+# @le-space/browser
+
+This package is the planned browser/PWA-facing layer for reusable Aleph
+deployment primitives.
+
+It is intended to sit between:
+
+- `@le-space/core`
+- `@le-space/rootfs`
+- browser applications such as deployment PWAs
+
+The package should stay UI-neutral. It should provide browser-safe helpers, but
+it should not own app-specific Svelte state, prepaid product logic, or wallet
+UX.
+
+## Planned v1 Scope
+
+The first real extraction wave should cover:
+
+- `http.ts`
+  - `fetchWithTimeout`
+- `aleph-api.ts`
+  - balance fetch
+  - CRN fetch
+  - instance listing
+  - Aleph message broadcast helpers
+  - deployment polling and result inspection
+  - runtime detail inspection
+- `rootfs.ts`
+  - RootFS manifest load
+  - RootFS existence check
+  - RootFS reference resolution
+- `pricing.ts`
+  - instance pricing fetch and parse helpers
+
+## Not In Scope Initially
+
+These should remain local to apps until the browser package has a stable base:
+
+- wallet-provider integrations
+- prepaid vault flows
+- UI-only formatting helpers
+- Svelte state orchestration
+
+## Source Of Truth
+
+The detailed extraction roadmap lives in:
+
+- `docs/docusaurus/docs/architecture/browser-extraction-plan.md`

package/index.d.ts

@@ -0,0 +1,16 @@
+type BrowserExtractionPhase = 'planned' | 'scaffolded';
+interface BrowserPackagePlan {
+    phase: BrowserExtractionPhase;
+    modules: string[];
+}
+declare const BROWSER_PACKAGE_PLAN: BrowserPackagePlan;
+
+declare function fetchWithTimeout(input: RequestInfo | URL, init?: RequestInit, timeoutMs?: number): Promise<Response>;
+
+declare const BROWSER_ALEPH_API_MODULE = "planned";
+
+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 };

package/index.js

@@ -0,0 +1,50 @@
+// src/types.ts
+var BROWSER_PACKAGE_PLAN = {
+  phase: "scaffolded",
+  modules: ["http", "aleph-api", "rootfs", "pricing"]
+};
+
+// src/http.ts
+async function fetchWithTimeout(input, init = {}, timeoutMs = 15e3) {
+  const controller = new AbortController();
+  const timeout = globalThis.setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    if (typeof input === "string" || input instanceof URL) {
+      const url = new URL(String(input), globalThis.location?.href);
+      url.searchParams.set("_ts", String(Date.now()));
+      return await fetch(url, {
+        ...init,
+        cache: init.cache ?? "no-store",
+        signal: init.signal ?? controller.signal
+      });
+    }
+    return await fetch(input, {
+      ...init,
+      cache: init.cache ?? "no-store",
+      signal: init.signal ?? controller.signal
+    });
+  } catch (error) {
+    if (error instanceof DOMException && error.name === "AbortError") {
+      throw new Error(`Request timed out after ${timeoutMs / 1e3}s.`);
+    }
+    throw error;
+  } finally {
+    globalThis.clearTimeout(timeout);
+  }
+}
+
+// src/aleph-api.ts
+var BROWSER_ALEPH_API_MODULE = "planned";
+
+// src/rootfs.ts
+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
+};

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@le-space/browser",
+  "version": "0.1.22",
+  "description": "Shared browser-safe Aleph deployment and polling helpers.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}