@oxprotocol/cli 0.1.0

package/dist/commands/dev.js

@@ -0,0 +1,191 @@
+import { createServer, } from "node:http";
+import { resolve } from "node:path";
+import chokidar from "chokidar";
+import { WebSocketServer } from "ws";
+import { packBundle } from "@oxprotocol/bundle";
+import { findProjectRoot, fail, info } from "../util.js";
+export async function dev(args) {
+    // Parse args: [--port N] [dir]
+    let port = Number(process.env.OXP_DEV_PORT ?? 7373);
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--port" || a === "-p") {
+            const v = args[++i];
+            if (!v)
+                fail("usage: oxp dev --port <n>");
+            port = Number(v);
+        }
+        else if (a.startsWith("--port=")) {
+            port = Number(a.slice("--port=".length));
+        }
+        else {
+            positional.push(a);
+        }
+    }
+    if (!Number.isFinite(port) || port < 1 || port > 65535) {
+        fail(`invalid port: ${port}`);
+    }
+    const startDir = resolve(positional[0] ?? process.cwd());
+    const maybeRoot = await findProjectRoot(startDir);
+    if (!maybeRoot)
+        fail(`no oxp.json found at or above ${startDir}`);
+    const root = maybeRoot;
+    let state = null;
+    let building = false;
+    let pendingRebuild = false;
+    async function rebuild(reason) {
+        if (building) {
+            pendingRebuild = true;
+            return;
+        }
+        building = true;
+        try {
+            const t0 = Date.now();
+            const r = await packBundle(root, {});
+            state = {
+                manifest: r.manifest,
+                digest: r.bundleSha256,
+                bundle: Buffer.from(r.oxp),
+                builtAt: Date.now(),
+            };
+            const ms = Date.now() - t0;
+            info(`↻ packed ${state.manifest.id}@${state.manifest.version} ` +
+                `(${state.bundle.length} bytes, sha256:${state.digest.slice(0, 12)}…) ` +
+                `in ${ms}ms — ${reason}`);
+            broadcast({
+                kind: "reload",
+                manifest: state.manifest,
+                digest: state.digest,
+                bundle: state.bundle.toString("base64"),
+                builtAt: state.builtAt,
+                dev: true,
+            });
+        }
+        catch (err) {
+            info(`✖ pack failed: ${err.message}`);
+            broadcast({ kind: "error", message: err.message });
+        }
+        finally {
+            building = false;
+            if (pendingRebuild) {
+                pendingRebuild = false;
+                await rebuild("debounced");
+            }
+        }
+    }
+    // ── HTTP server ──────────────────────────────────────────────────────────
+    const http = createServer((req, res) => handleHttp(req, res, () => state));
+    // ── WebSocket server piggy-backs on HTTP ─────────────────────────────────
+    const wss = new WebSocketServer({ server: http, path: "/dev" });
+    const sockets = new Set();
+    wss.on("connection", (ws) => {
+        sockets.add(ws);
+        info(`+ dev client connected (${sockets.size} total)`);
+        if (state) {
+            ws.send(JSON.stringify({
+                kind: "reload",
+                manifest: state.manifest,
+                digest: state.digest,
+                bundle: state.bundle.toString("base64"),
+                builtAt: state.builtAt,
+                dev: true,
+            }));
+        }
+        ws.on("close", () => {
+            sockets.delete(ws);
+            info(`- dev client disconnected (${sockets.size} total)`);
+        });
+    });
+    function broadcast(msg) {
+        const json = JSON.stringify(msg);
+        for (const ws of sockets) {
+            if (ws.readyState === ws.OPEN)
+                ws.send(json);
+        }
+    }
+    // ── chokidar watch ───────────────────────────────────────────────────────
+    const watcher = chokidar.watch(root, {
+        ignored: (p) => /(^|[\\/])(\.git|node_modules|dist\/.*\.oxp|\.next|\.oxp-cache)([\\/]|$)/.test(p),
+        ignoreInitial: true,
+    });
+    let debounce = null;
+    watcher.on("all", (event, path) => {
+        if (debounce)
+            clearTimeout(debounce);
+        debounce = setTimeout(() => {
+            void rebuild(`${event} ${path.replace(root + "/", "")}`);
+        }, 100);
+    });
+    // ── Initial build + start ────────────────────────────────────────────────
+    await rebuild("initial");
+    await new Promise((r) => http.listen(port, "127.0.0.1", r));
+    info("");
+    info("╭───────────────────────────────────────────────────────────╮");
+    info("│  oxp dev — DEV MODE (signature bypass, do not ship)       │");
+    info(`│  ws:    ws://localhost:${port}/dev`.padEnd(60) + "│");
+    info(`│  http:  http://localhost:${port}/info`.padEnd(60) + "│");
+    info(`│  root:  ${root}`.padEnd(60) + "│");
+    info("╰───────────────────────────────────────────────────────────╯");
+    info("");
+    info("Press Ctrl+C to stop.");
+    // Keep alive until SIGINT.
+    await new Promise((resolveSig) => {
+        const stop = async () => {
+            info("\noxp dev: shutting down…");
+            await watcher.close();
+            for (const ws of sockets)
+                ws.terminate();
+            wss.close();
+            http.close();
+            resolveSig();
+        };
+        process.on("SIGINT", stop);
+        process.on("SIGTERM", stop);
+    });
+    return 0;
+}
+// ── HTTP handler ───────────────────────────────────────────────────────────
+function handleHttp(req, res, getState) {
+    res.setHeader("access-control-allow-origin", "*");
+    const url = new URL(req.url ?? "/", "http://localhost");
+    const state = getState();
+    switch (url.pathname) {
+        case "/info":
+            if (!state)
+                return send(res, 503, { error: "not built yet" });
+            return send(res, 200, {
+                dev: true,
+                manifest: state.manifest,
+                digest: state.digest,
+                bundleSize: state.bundle.length,
+                builtAt: state.builtAt,
+            });
+        case "/manifest":
+            if (!state)
+                return send(res, 503, { error: "not built yet" });
+            return send(res, 200, state.manifest);
+        case "/bundle":
+            if (!state)
+                return send(res, 503, { error: "not built yet" });
+            res.statusCode = 200;
+            res.setHeader("content-type", "application/x-oxp+zstd");
+            res.setHeader("x-oxp-digest", `sha256:${state.digest}`);
+            res.setHeader("x-oxp-dev", "true");
+            res.end(state.bundle);
+            return;
+        case "/":
+            return send(res, 200, {
+                service: "oxp dev",
+                endpoints: ["/info", "/manifest", "/bundle", "/dev (ws)"],
+            });
+        default:
+            return send(res, 404, { error: "not found" });
+    }
+}
+function send(res, status, body) {
+    res.statusCode = status;
+    res.setHeader("content-type", "application/json");
+    res.end(JSON.stringify(body));
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `oxp doctor` — print a health summary so users (and support tickets) can
+ * answer "what does my setup look like?" in one command.
+ *
+ * Reports:
+ *   - CLI version & node version
+ *   - Registry URL & login state (handle, scopes, expiry)
+ *   - OXP_HOME location, runtime binary, store layout
+ *   - Detected IDEs and host-adapter status (read-only — never installs)
+ *
+ * Always exits 0 on a successful report; non-zero only when the doctor
+ * itself crashes. Issues are presented in the report, not via exit code,
+ * so pipelines can still capture the JSON output.
+ */
+export declare function doctor(args: string[]): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAuBH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmJ5D"}

package/dist/commands/doctor.js

@@ -0,0 +1,197 @@
+/**
+ * `oxp doctor` — print a health summary so users (and support tickets) can
+ * answer "what does my setup look like?" in one command.
+ *
+ * Reports:
+ *   - CLI version & node version
+ *   - Registry URL & login state (handle, scopes, expiry)
+ *   - OXP_HOME location, runtime binary, store layout
+ *   - Detected IDEs and host-adapter status (read-only — never installs)
+ *
+ * Always exits 0 on a successful report; non-zero only when the doctor
+ * itself crashes. Issues are presented in the report, not via exit code,
+ * so pipelines can still capture the JSON output.
+ */
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
+import { homedir, platform, release } from "node:os";
+import { detectHosts } from "../lib/host-detect.js";
+import { ensureAdapters } from "../lib/host-adapter.js";
+import { info, oxpHome, readCredentials, registryUrl } from "../util.js";
+const HELP = `oxp doctor [--json]   Inspect this machine and report what OXP can see
+
+Flags:
+  --json   Emit a machine-readable JSON report on a single line.
+`;
+export async function doctor(args) {
+    if (args[0] === "-h" || args[0] === "--help") {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    const json = args.includes("--json");
+    const home = oxpHome();
+    const reg = registryUrl();
+    const tokenPresent = !!(await readCredentials());
+    // Best-effort whoami (registry might be down — fall through silently).
+    let who = null;
+    if (tokenPresent) {
+        try {
+            const ctl = new AbortController();
+            const timer = setTimeout(() => ctl.abort(), 3_000);
+            const tok = await readCredentials();
+            const r = await fetch(`${reg}/api/v1/auth/whoami`, {
+                headers: { authorization: `Bearer ${tok ?? ""}` },
+                signal: ctl.signal,
+            }).finally(() => clearTimeout(timer));
+            if (r.ok)
+                who = (await r.json());
+        }
+        catch {
+            // network/DNS error — leave who as null
+        }
+    }
+    // Filesystem layout — every path is reported with present:true|false so
+    // the user knows what's there and what isn't.
+    const paths = await reportPaths(home);
+    // Detect IDEs (skip running-process probe to keep the doctor cheap).
+    const detected = await detectHosts({ skipProcessProbe: false });
+    const adapters = await ensureAdapters(detected, { reportOnly: true });
+    if (json) {
+        process.stdout.write(JSON.stringify({
+            ok: true,
+            cli: {
+                version: "0.1.0",
+                node: process.version,
+                platform: platform(),
+                release: release(),
+            },
+            registry: {
+                url: reg,
+                loggedIn: tokenPresent,
+                handle: who?.handle ?? null,
+                scopes: who?.token?.scopes ?? [],
+                expiresAt: who?.token?.expiresAt ?? null,
+            },
+            oxpHome: home,
+            paths,
+            hosts: adapters.map((a) => ({
+                id: a.host.id,
+                name: a.host.displayName,
+                family: a.host.family,
+                installed: a.host.installed,
+                running: a.host.running,
+                cliPath: a.host.cliPath ?? null,
+                userDataDir: a.host.userDataDir ?? null,
+                extensionsDir: a.host.extensionsDir ?? null,
+                adapter: a.status,
+                adapterReason: a.status === "unavailable"
+                    ? a.reason
+                    : a.status === "failed"
+                        ? a.error
+                        : undefined,
+            })),
+        }) + "\n");
+        return 0;
+    }
+    info(`OXP doctor`);
+    info(`──────────────────────────────────────────────────────────`);
+    info(`CLI:        v0.1.0  ·  node ${process.version}  ·  ${platform()} ${release()}`);
+    info(`Registry:   ${reg}`);
+    if (tokenPresent && who?.handle) {
+        info(`Logged in:  @${who.handle}` +
+            (who.token?.expiresAt ? `  (expires ${who.token.expiresAt})` : ""));
+        if (who.token?.scopes?.length)
+            info(`Scopes:     ${who.token.scopes.join(", ")}`);
+    }
+    else if (tokenPresent) {
+        info(`Logged in:  yes (registry unreachable — could not verify)`);
+    }
+    else {
+        info(`Logged in:  no  (run \`oxp login\` to publish)`);
+    }
+    info(``);
+    info(`Filesystem (OXP_HOME = ${home}):`);
+    for (const p of paths) {
+        const tag = p.present ? "✓" : "✗";
+        info(`  ${tag} ${p.label.padEnd(22)} ${p.path}`);
+    }
+    info(``);
+    info(`IDEs detected:`);
+    if (adapters.length === 0) {
+        info(`  (none)  — install VS Code, JetBrains, or Neovim to use OXP extensions`);
+    }
+    else {
+        for (const a of adapters) {
+            const run = a.host.running ? " · running" : "";
+            const part = a.host.partial ? " · partial" : "";
+            let adapterTail;
+            switch (a.status) {
+                case "present":
+                    adapterTail = "adapter ✓";
+                    break;
+                case "installed":
+                    adapterTail = "adapter installed";
+                    break;
+                case "unsupported":
+                    adapterTail = "adapter ✗ (unsupported family)";
+                    break;
+                case "unavailable":
+                    adapterTail = `adapter ⊘ (${a.reason})`;
+                    break;
+                case "failed":
+                    adapterTail = `adapter ✗ (${a.error})`;
+                    break;
+            }
+            info(`  • ${a.host.displayName.padEnd(28)} ${adapterTail}${run}${part}`);
+            if (a.host.cliPath)
+                info(`      cli:  ${a.host.cliPath}`);
+            if (a.host.userDataDir)
+                info(`      data: ${a.host.userDataDir}`);
+        }
+    }
+    info(``);
+    info(`Next steps:`);
+    if (!tokenPresent)
+        info(`  • run \`oxp login\` to publish extensions`);
+    if (adapters.every((a) => a.status !== "present" && a.status !== "installed")) {
+        info(`  • host adapters will auto-install once they're on the marketplaces`);
+    }
+    info(`  • run \`oxp install <id>\` to install an extension`);
+    info(`  • run \`oxp create <name>\` to start a new extension`);
+    return 0;
+}
+async function reportPaths(home) {
+    const items = [
+        { label: "credentials", path: join(home, "credentials") },
+        { label: "publisher key", path: join(home, "keys", "publisher.json") },
+        { label: "host-store", path: join(home, "host-store") },
+        { label: "  extensions/", path: join(home, "host-store", "extensions") },
+        {
+            label: "  url-installs/",
+            path: join(home, "host-store", "url-installs"),
+        },
+        { label: "cache", path: join(home, "cache") },
+        {
+            label: "runtime (env)",
+            path: process.env.OXP_RUNTIME ?? "(OXP_RUNTIME unset)",
+        },
+    ];
+    const out = [];
+    for (const it of items) {
+        const present = it.path.startsWith("(") ? false : await pathExists(it.path);
+        out.push({ ...it, present });
+    }
+    return out;
+}
+async function pathExists(p) {
+    try {
+        await fs.stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// Suppress unused-import warning when the helper above isn't used.
+void homedir;
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/install-url.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `oxp install-url <url>` — install a raw `.wasm` component from a URL into
+ * the shared host store, so any installed IDE host (VS Code, JetBrains)
+ * can list and activate it without re-downloading.
+ *
+ * Source schemes:
+ *   https://…wasm     always allowed
+ *   file://…wasm      always allowed
+ *   http://…wasm      only when --insecure-http (or host is localhost / 127.0.0.1 / ::1)
+ *
+ * Storage:
+ *   $OXP_HOME/host-store/url-installs/<sha256>/bundle.wasm
+ *   $OXP_HOME/host-store/url-installs/<sha256>/meta.json
+ *
+ * This sidesteps the registry / signature pipeline; the caller is trusting
+ * the URL. Hosts still gate activation with the permission prompt before
+ * loading the bytes into the runtime.
+ */
+export declare function installUrl(args: string[]): Promise<number>;
+//# sourceMappingURL=install-url.d.ts.map

package/dist/commands/install-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-url.d.ts","sourceRoot":"","sources":["../../src/commands/install-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqGH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4IhE"}