@unbrowse/sdk 11.1.1 → 11.1.6

package/dist/runtime.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Local-binary lifecycle for `@unbrowse/sdk`.
+ *
+ * The SDK talks to a co-located `unbrowse` runtime over loopback HTTP.
+ * `runtime.ts` owns the contract for locating, probing, and spawning that
+ * runtime so `client.ts` can stay a pure HTTP transport.
+ *
+ * Tree-shaking note: heavy Node-only imports (`child_process`) are pulled
+ * in lazily inside `spawnUnbrowseRuntime`. Callers that only use
+ * `Unbrowse.connect` never pay for them.
+ */
+/**
+ * Handle returned by a successful spawn. `owned` distinguishes processes the
+ * SDK forked (kill on `.close()`) from processes the SDK adopted via probe
+ * (leave running on `.close()`).
+ */
+export interface RuntimeHandle {
+    /** Base URL the running runtime listens on, e.g. "http://127.0.0.1:6969". */
+    baseUrl: string;
+    /** OS process id; -1 if the runtime was adopted via probe. */
+    pid: number;
+    /** Stops the runtime if `owned`; no-op otherwise. */
+    kill(): Promise<void>;
+    /** Resolves once the runtime answers `/health` with 200. */
+    ready: Promise<void>;
+    /** True iff this SDK started the process and is responsible for tearing it down. */
+    owned: boolean;
+}
+/**
+ * Options for `spawnUnbrowseRuntime`. Every field has a sensible default,
+ * so the zero-arg call is the documented happy path.
+ */
+export interface SpawnRuntimeOptions {
+    /** Preferred port; default 6969. If already alive, adopts that runtime. */
+    port?: number;
+    /** Working directory for the child; default = current process cwd. */
+    cwd?: string;
+    /** Extra env vars layered onto the child's inherited env. */
+    env?: Record<string, string>;
+    /** Explicit path to the binary; overrides `locateUnbrowseBinary`. */
+    binaryPath?: string;
+    /** Milliseconds to wait for `/health` readiness; default 10_000. */
+    readyTimeoutMs?: number;
+}
+/**
+ * Probe an already-running runtime by hitting `/health`. Returns true iff
+ * the response status is 2xx. Never throws — connection refused, timeout,
+ * DNS failures, and non-2xx all resolve to `false`.
+ */
+export declare function probeUnbrowseRuntime(baseUrl: string, timeoutMs?: number): Promise<boolean>;
+/**
+ * Locate the `unbrowse` binary by walking, in order:
+ *   1. `UNBROWSE_BIN` env var
+ *   2. `require.resolve('unbrowse/package.json')` -> derived `bin/unbrowse-wrapper.mjs`
+ *   3. `Bun.which('unbrowse')` if running under Bun
+ * Returns null when nothing is wired.
+ */
+export declare function locateUnbrowseBinary(): string | null;
+/**
+ * Spawn (or adopt) a co-located `unbrowse` runtime and wait for it to
+ * answer `/health`. Returns a `RuntimeHandle` whose `.kill()` tears the
+ * child down. Throws `RuntimeUnavailableError` on failure modes.
+ *
+ * Concurrency: if two callers race on the same port, only one spawn is
+ * launched. The second caller awaits the first's promise and gets an
+ * adopted (`owned=false`) view of the same handle so it cannot
+ * double-kill the child.
+ */
+export declare function spawnUnbrowseRuntime(opts?: SpawnRuntimeOptions): Promise<RuntimeHandle>;
+/**
+ * Always activate the auth-proxy bridge when spawning via the SDK — same default as
+ * the CLI. "auto" makes the runtime attempt the bridge and degrade safely to direct
+ * egress when no proxy creds resolve (so it never re-introduces the v9.3.4 ERR_TUNNEL
+ * breakage of forcing a proxy default). An explicit UNBROWSE_KURI_PROXY (incl. "0"/
+ * "false" — the emergency disable) is preserved. Pure + exported for unit tests.
+ */
+export declare function applyBridgeDefault(env: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,4DAA4D;IAC5D,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,oFAAoF;IACpF,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAiC,GAC3C,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAoCpD;AA2BD;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,aAAa,CAAC,CA8BxB;AAgLD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKtF"}

package/dist/runtime.js

@@ -0,0 +1,339 @@
+/**
+ * Local-binary lifecycle for `@unbrowse/sdk`.
+ *
+ * The SDK talks to a co-located `unbrowse` runtime over loopback HTTP.
+ * `runtime.ts` owns the contract for locating, probing, and spawning that
+ * runtime so `client.ts` can stay a pure HTTP transport.
+ *
+ * Tree-shaking note: heavy Node-only imports (`child_process`) are pulled
+ * in lazily inside `spawnUnbrowseRuntime`. Callers that only use
+ * `Unbrowse.connect` never pay for them.
+ */
+import { RuntimeUnavailableError } from "./errors.js";
+import { createRequire } from "node:module";
+// Under Node ESM (`"type": "module"` + tsc `module: ESNext`), bare `require`
+// is undefined and the lazy `require("node:fs")` / `require("node:path")`
+// calls below would throw `ReferenceError`, get swallowed by their try/catch,
+// and silently return false/null. Bind a CommonJS-style require to this
+// module's URL so all the lazy `require(...)` sites in this file resolve.
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const require = createRequire(import.meta.url);
+const DEFAULT_PORT = 6969;
+const DEFAULT_READY_TIMEOUT_MS = 10_000;
+const DEFAULT_PROBE_TIMEOUT_MS = 1_000;
+/**
+ * Probe an already-running runtime by hitting `/health`. Returns true iff
+ * the response status is 2xx. Never throws — connection refused, timeout,
+ * DNS failures, and non-2xx all resolve to `false`.
+ */
+export async function probeUnbrowseRuntime(baseUrl, timeoutMs = DEFAULT_PROBE_TIMEOUT_MS) {
+    const url = `${baseUrl.replace(/\/+$/, "")}/health`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, { method: "GET", signal: controller.signal });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Locate the `unbrowse` binary by walking, in order:
+ *   1. `UNBROWSE_BIN` env var
+ *   2. `require.resolve('unbrowse/package.json')` -> derived `bin/unbrowse-wrapper.mjs`
+ *   3. `Bun.which('unbrowse')` if running under Bun
+ * Returns null when nothing is wired.
+ */
+export function locateUnbrowseBinary() {
+    // 1. Explicit env override.
+    const fromEnv = readEnv("UNBROWSE_BIN");
+    if (fromEnv && fileExists(fromEnv))
+        return fromEnv;
+    // 2. require.resolve('unbrowse/package.json') -> bin/unbrowse-wrapper.mjs.
+    //    Only honor this when the resolved package looks like a real install
+    //    (the wrapper has a sibling native binary or compiled launcher). A
+    //    bare workspace tree with no postinstall artifacts would set us up to
+    //    spawn-and-fail; fall through to PATH lookup in that case.
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { createRequire } = require("node:module");
+        const requireFn = createRequire(import.meta.url);
+        const pkgPath = requireFn.resolve("unbrowse/package.json");
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const path = require("node:path");
+        const binDir = path.join(path.dirname(pkgPath), "bin");
+        const wrapper = path.join(binDir, "unbrowse-wrapper.mjs");
+        if (fileExists(wrapper) && hasNativeSibling(binDir))
+            return wrapper;
+    }
+    catch {
+        // peer dep not installed — fall through
+    }
+    // 3. Bun.which / PATH lookup. Bun gives us a one-liner; under raw Node
+    //    we do the PATH walk ourselves so `npx node smoke.mjs` against a
+    //    globally-installed `unbrowse` works the same as `bun smoke.ts`.
+    const bunWhich = globalThis.Bun?.which;
+    if (typeof bunWhich === "function") {
+        const onPath = bunWhich("unbrowse");
+        if (onPath && fileExists(onPath))
+            return onPath;
+    }
+    const fromPath = findOnPath("unbrowse");
+    if (fromPath)
+        return fromPath;
+    return null;
+}
+function hasNativeSibling(binDir) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const fs = require("node:fs");
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const path = require("node:path");
+        return fs.existsSync(path.join(binDir, "unbrowse"))
+            || fs.existsSync(path.join(binDir, "unbrowse.exe"));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * In-flight spawn promises keyed by port. When two callers race to spawn on
+ * the same port, the second one awaits the first's promise instead of
+ * launching a competing child that would lose the bind and exit with code=1.
+ *
+ * Each caller gets its own `RuntimeHandle` view: the *winner* of the race
+ * keeps `owned=true` so its `.close()` actually kills the child; subsequent
+ * `Unbrowse.local()` callers that joined the in-flight wait get an adopted
+ * (`owned=false`) handle so they don't double-kill the shared child.
+ */
+const inFlightSpawns = new Map();
+/**
+ * Spawn (or adopt) a co-located `unbrowse` runtime and wait for it to
+ * answer `/health`. Returns a `RuntimeHandle` whose `.kill()` tears the
+ * child down. Throws `RuntimeUnavailableError` on failure modes.
+ *
+ * Concurrency: if two callers race on the same port, only one spawn is
+ * launched. The second caller awaits the first's promise and gets an
+ * adopted (`owned=false`) view of the same handle so it cannot
+ * double-kill the child.
+ */
+export async function spawnUnbrowseRuntime(opts = {}) {
+    const port = opts.port ?? DEFAULT_PORT;
+    // If another caller is mid-spawn on this port, join their promise
+    // instead of competing for the bind. The joiner receives an adopted
+    // view (owned=false) so the winner's .close() / .kill() is the only
+    // one that actually tears the child down.
+    const existing = inFlightSpawns.get(port);
+    if (existing) {
+        const winner = await existing;
+        return {
+            baseUrl: winner.baseUrl,
+            pid: winner.pid,
+            kill: async () => { },
+            ready: Promise.resolve(),
+            owned: false,
+        };
+    }
+    const spawnPromise = spawnUnbrowseRuntimeInternal(opts);
+    inFlightSpawns.set(port, spawnPromise);
+    try {
+        return await spawnPromise;
+    }
+    finally {
+        // Clear the slot once the spawn settles (success or failure) so a
+        // subsequent .close()-then-spawn cycle re-enters the spawn path.
+        if (inFlightSpawns.get(port) === spawnPromise) {
+            inFlightSpawns.delete(port);
+        }
+    }
+}
+async function spawnUnbrowseRuntimeInternal(opts) {
+    const port = opts.port ?? DEFAULT_PORT;
+    const baseUrl = `http://127.0.0.1:${port}`;
+    const readyTimeoutMs = opts.readyTimeoutMs ?? DEFAULT_READY_TIMEOUT_MS;
+    // 1. If a runtime is already alive on the requested port, adopt it.
+    if (await probeUnbrowseRuntime(baseUrl, DEFAULT_PROBE_TIMEOUT_MS)) {
+        return {
+            baseUrl,
+            pid: -1,
+            kill: async () => { },
+            ready: Promise.resolve(),
+            owned: false,
+        };
+    }
+    // 2. Locate the binary.
+    const binary = opts.binaryPath ?? locateUnbrowseBinary();
+    if (!binary || !fileExists(binary)) {
+        throw new RuntimeUnavailableError(`unbrowse binary not found${opts.binaryPath ? ` at ${opts.binaryPath}` : ""}. Install with: npm i -g unbrowse`, "binary_missing", port);
+    }
+    // 3. Spawn via Node's child_process (cross-runtime; Bun shims this).
+    //    Lazy import keeps the connect-only path tree-shakeable.
+    const childProcess = await import("node:child_process");
+    const env = applyBridgeDefault({
+        ...sanitizeEnv(process.env),
+        ...(opts.env ?? {}),
+        PORT: String(port),
+        HOST: "127.0.0.1",
+    });
+    // `unbrowse-wrapper.mjs` is a node script; the global `unbrowse` binary
+    // may be a wrapper or a compiled single-binary. Pass `serve` as argv[0]
+    // either way — `src/single-binary.ts:106` keys on it, and the wrapper
+    // forwards argv unchanged.
+    const isJsLauncher = binary.endsWith(".mjs") || binary.endsWith(".js");
+    const command = isJsLauncher ? process.execPath : binary;
+    const args = isJsLauncher ? [binary, "serve"] : ["serve"];
+    // `detached: true` puts the child in its own process group so we can
+    // signal the entire group at teardown. The unbrowse wrapper fork-execs
+    // a node grandchild that wouldn't otherwise receive our SIGTERM.
+    const isPosix = process.platform !== "win32";
+    const child = childProcess.spawn(command, args, {
+        cwd: opts.cwd,
+        env,
+        stdio: ["ignore", "pipe", "pipe"],
+        detached: isPosix,
+    });
+    // Prevent the detached child from keeping the parent event loop alive.
+    if (isPosix)
+        child.unref();
+    const signalGroup = (signal) => {
+        if (child.pid && isPosix) {
+            try {
+                process.kill(-child.pid, signal);
+                return;
+            }
+            catch { /* fall through */ }
+        }
+        try {
+            child.kill(signal);
+        }
+        catch { /* ignore */ }
+    };
+    // 4. Poll readiness up to readyTimeoutMs.
+    const ready = (async () => {
+        const deadline = Date.now() + readyTimeoutMs;
+        while (Date.now() < deadline) {
+            if (child.exitCode !== null) {
+                throw new RuntimeUnavailableError(`unbrowse exited (code=${child.exitCode}) before reaching ready state on port ${port}`, "spawn_failed", port);
+            }
+            if (await probeUnbrowseRuntime(baseUrl, 250))
+                return;
+            await sleep(100);
+        }
+        // Timeout — tear the orphan down and surface the failure.
+        signalGroup("SIGTERM");
+        throw new RuntimeUnavailableError(`unbrowse runtime on port ${port} did not become ready within ${readyTimeoutMs}ms`, "spawn_failed", port);
+    })();
+    try {
+        await ready;
+    }
+    catch (e) {
+        if (child.exitCode === null)
+            signalGroup("SIGTERM");
+        throw e;
+    }
+    return {
+        baseUrl,
+        pid: child.pid ?? -1,
+        kill: async () => {
+            if (child.exitCode !== null)
+                return;
+            signalGroup("SIGTERM");
+            // Wait up to 2s for graceful exit; fastify close + browser shutdown
+            // can take a moment.
+            for (let i = 0; i < 20; i++) {
+                if (child.exitCode !== null)
+                    return;
+                await sleep(100);
+            }
+            if (child.exitCode === null) {
+                signalGroup("SIGKILL");
+                // Give the kernel a beat to release the listener.
+                await sleep(100);
+            }
+        },
+        ready: Promise.resolve(),
+        owned: true,
+    };
+}
+// ---- internal helpers ----
+function readEnv(name) {
+    const p = globalThis.process;
+    if (!p?.env)
+        return undefined;
+    const v = p.env[name];
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function fileExists(p) {
+    try {
+        // Lazy require keeps this file safe in non-Node runtimes that import
+        // only the type definitions. `node:fs` is available wherever spawn
+        // matters, so this branch is gated by the caller.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const fs = require("node:fs");
+        return fs.existsSync(p);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * PATH walk for raw Node (no Bun.which). Walks `process.env.PATH`, joins each
+ * entry with `name` (+ `.exe` on Windows), and returns the first hit. Honors
+ * `PATHEXT` on Windows so `unbrowse.cmd` / `unbrowse.bat` resolve too.
+ */
+function findOnPath(name) {
+    try {
+        const proc = globalThis.process;
+        const pathEnv = proc?.env?.PATH ?? proc?.env?.Path;
+        if (!pathEnv)
+            return null;
+        const path = require("node:path");
+        const isWin = proc?.platform === "win32";
+        const sep = isWin ? ";" : ":";
+        const exts = isWin
+            ? (proc?.env?.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";").map((e) => e.toLowerCase())
+            : [""];
+        for (const dir of pathEnv.split(sep)) {
+            if (!dir)
+                continue;
+            for (const ext of exts) {
+                const candidate = path.join(dir, name + ext);
+                if (fileExists(candidate))
+                    return candidate;
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+/**
+ * Always activate the auth-proxy bridge when spawning via the SDK — same default as
+ * the CLI. "auto" makes the runtime attempt the bridge and degrade safely to direct
+ * egress when no proxy creds resolve (so it never re-introduces the v9.3.4 ERR_TUNNEL
+ * breakage of forcing a proxy default). An explicit UNBROWSE_KURI_PROXY (incl. "0"/
+ * "false" — the emergency disable) is preserved. Pure + exported for unit tests.
+ */
+export function applyBridgeDefault(env) {
+    if (env.UNBROWSE_KURI_PROXY == null || env.UNBROWSE_KURI_PROXY === "") {
+        return { ...env, UNBROWSE_KURI_PROXY: "auto" };
+    }
+    return env;
+}
+function sanitizeEnv(env) {
+    const out = {};
+    for (const [k, v] of Object.entries(env)) {
+        if (typeof v === "string")
+            out[k] = v;
+    }
+    return out;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unbrowse/sdk",
-  "version": "11.1.1",
-  "description": "TypeScript SDK for Unbrowse \u2014 auto-spawns the unbrowse binary and talks to it over a local socket. For an HTTP-first, browser/edge-compatible client with zero runtime deps, see @unbrowse/client.",
+  "version": "11.1.6",
+  "description": "TypeScript SDK for Unbrowse 11.1.6: local runtime control, truthful health, and public stats.",
   "type": "module",
   "license": "MIT",
   "exports": {
@@ -31,8 +31,7 @@
     }
   },
   "optionalDependencies": {
-    "unbrowse": "^11.1.1",
-    "@faremeter/flex-solana": "^0.2.1"
+    "unbrowse": ">=9.3.15"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",