@oxprotocol/cli 0.1.0

package/dist/lib/host-detect.js

@@ -0,0 +1,479 @@
+/**
+ * Host detection — discover IDEs installed on the user's machine.
+ *
+ * The OXP install flow needs to know which editors are present so it can
+ * (a) ensure the OXP host adapter is installed for each one, and
+ * (b) report which environments the freshly-installed extension is now
+ *     available in.
+ *
+ * Detection is **silent** and **best-effort**: a missing IDE is not an
+ * error, and we never spawn a long-running probe. We look for the
+ * canonical CLI binary on PATH and the canonical user-data / extensions
+ * directories for each platform. If both exist we consider the IDE
+ * installed; if only one is present the host is reported with
+ * `partial: true` so the caller can decide whether to skip it.
+ *
+ * Supported families today:
+ *   - VS Code, Cursor, Windsurf, VSCodium, VS Code Insiders
+ *     (all share the same extension format → adapter VSIX is reusable)
+ *
+ * JetBrains, Zed, Theia, Gitpod, Coder are placeholders — detection is
+ * stubbed so the surface stays stable as we add real probes.
+ */
+import { promises as fs } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const exec = promisify(execFile);
+const VSCODE_FAMILY = [
+    {
+        id: "vscode",
+        displayName: "VS Code",
+        bin: ["code"],
+        macApps: ["Visual Studio Code.app"],
+        userDataSubdir: "Code",
+        extensionsSubdir: ".vscode/extensions",
+        processFragment: "Visual Studio Code",
+    },
+    {
+        id: "vscode",
+        displayName: "VS Code Insiders",
+        bin: ["code-insiders"],
+        macApps: ["Visual Studio Code - Insiders.app"],
+        userDataSubdir: "Code - Insiders",
+        extensionsSubdir: ".vscode-insiders/extensions",
+        processFragment: "Visual Studio Code - Insiders",
+    },
+    {
+        id: "cursor",
+        displayName: "Cursor",
+        bin: ["cursor"],
+        macApps: ["Cursor.app"],
+        userDataSubdir: "Cursor",
+        extensionsSubdir: ".cursor/extensions",
+        processFragment: "Cursor",
+    },
+    {
+        id: "windsurf",
+        displayName: "Windsurf",
+        bin: ["windsurf"],
+        macApps: ["Windsurf.app"],
+        userDataSubdir: "Windsurf",
+        extensionsSubdir: ".windsurf/extensions",
+        processFragment: "Windsurf",
+    },
+    {
+        id: "vscodium",
+        displayName: "VSCodium",
+        bin: ["codium"],
+        macApps: ["VSCodium.app"],
+        userDataSubdir: "VSCodium",
+        extensionsSubdir: ".vscode-oss/extensions",
+        processFragment: "VSCodium",
+    },
+];
+/**
+ * Discover every supported IDE on the current machine. Returns only
+ * hosts where we found *some* evidence of installation; absent IDEs are
+ * silently omitted. Order is stable: VS Code family first (in the
+ * declaration order above), then everything else.
+ */
+export async function detectHosts(opts = {}) {
+    const found = [];
+    // Capture process list once so we can tag every host without paying the
+    // exec cost N times.
+    const procList = opts.skipProcessProbe ? "" : await snapshotProcesses();
+    for (const entry of VSCODE_FAMILY) {
+        const host = await detectVSCodeFamily(entry, procList);
+        if (host)
+            found.push(host);
+    }
+    // JetBrains family — installs are per-product per-year (IntelliJIdea2025.2,
+    // WebStorm2024.3, etc.). We collapse them into a single `jetbrains` entry
+    // keyed on the newest installation found.
+    const jb = await detectJetBrains(procList);
+    if (jb)
+        found.push(jb);
+    // Neovim — `nvim` on PATH plus a config dir.
+    const nv = await detectNeovim(procList);
+    if (nv)
+        found.push(nv);
+    return found;
+}
+/**
+ * Look up a single host by id. Convenience for `oxp install --host vscode`.
+ * Returns undefined when not installed.
+ */
+export async function detectHost(id) {
+    const all = await detectHosts();
+    return all.find((h) => h.id === id);
+}
+/* -------------------------------------------------------------------------- */
+/* VS Code family probes                                                      */
+/* -------------------------------------------------------------------------- */
+async function detectVSCodeFamily(entry, procList) {
+    const cliPath = await findCli(entry);
+    const userDataDir = vscodeUserDataDir(entry.userDataSubdir);
+    const extensionsDir = vscodeExtensionsDir(entry.extensionsSubdir);
+    const userDataExists = await pathExists(userDataDir);
+    const extDirExists = await pathExists(extensionsDir);
+    const haveCli = !!cliPath;
+    const haveData = userDataExists || extDirExists;
+    if (!haveCli && !haveData)
+        return undefined;
+    const running = procList.length > 0 && procList.includes(entry.processFragment);
+    return {
+        id: entry.id,
+        displayName: entry.displayName,
+        family: "vscode",
+        cliPath,
+        extensionsDir: extDirExists ? extensionsDir : undefined,
+        userDataDir: userDataExists ? userDataDir : undefined,
+        installed: haveCli && haveData,
+        partial: !(haveCli && haveData),
+        running,
+    };
+}
+/* -------------------------------------------------------------------------- */
+/* Path helpers                                                               */
+/* -------------------------------------------------------------------------- */
+function vscodeUserDataDir(subdir) {
+    switch (platform()) {
+        case "darwin":
+            return join(homedir(), "Library", "Application Support", subdir);
+        case "win32":
+            return join(process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"), subdir);
+        default:
+            return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), subdir);
+    }
+}
+function vscodeExtensionsDir(subdir) {
+    return join(homedir(), subdir);
+}
+/* -------------------------------------------------------------------------- */
+/* CLI discovery                                                              */
+/* -------------------------------------------------------------------------- */
+async function findCli(entry) {
+    // 1) macOS app bundles ship the CLI inside Contents/Resources/app/bin
+    if (platform() === "darwin") {
+        for (const app of entry.macApps) {
+            for (const root of ["/Applications", join(homedir(), "Applications")]) {
+                for (const bin of entry.bin) {
+                    const p = join(root, app, "Contents", "Resources", "app", "bin", bin);
+                    if (await pathExists(p))
+                        return p;
+                }
+            }
+        }
+    }
+    // 2) Anything on PATH wins next.
+    for (const bin of entry.bin) {
+        const p = await whichBinary(bin);
+        if (p)
+            return p;
+    }
+    // 3) Common Linux/Windows install locations as a final fallback.
+    const candidates = platformFallbackBins(entry);
+    for (const p of candidates) {
+        if (await pathExists(p))
+            return p;
+    }
+    return undefined;
+}
+function platformFallbackBins(entry) {
+    if (platform() === "win32") {
+        const local = process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local");
+        const programs = process.env.ProgramFiles ?? "C:\\Program Files";
+        return entry.bin.flatMap((b) => [
+            join(local, "Programs", entry.displayName, "bin", `${b}.cmd`),
+            join(programs, entry.displayName, "bin", `${b}.cmd`),
+        ]);
+    }
+    // Linux / other unix
+    return entry.bin.flatMap((b) => [
+        `/usr/bin/${b}`,
+        `/usr/local/bin/${b}`,
+        `/snap/bin/${b}`,
+        `/var/lib/flatpak/exports/bin/${b}`,
+    ]);
+}
+async function whichBinary(bin) {
+    // Prefer `command -v` over `which` — it's a POSIX builtin and works in
+    // restricted PATHs. On Windows we fall back to `where`.
+    const cmd = platform() === "win32" ? "where" : "command";
+    const args = platform() === "win32" ? [bin] : ["-v", bin];
+    try {
+        const { stdout } = await exec(cmd, args, {
+            shell: platform() !== "win32", // `command` is a builtin
+            timeout: 1500,
+        });
+        const first = stdout.split(/\r?\n/).find((s) => s.trim().length > 0);
+        return first?.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Process probe                                                              */
+/* -------------------------------------------------------------------------- */
+async function snapshotProcesses() {
+    try {
+        if (platform() === "win32") {
+            const { stdout } = await exec("tasklist", [], { timeout: 2000 });
+            return stdout;
+        }
+        const { stdout } = await exec("ps", ["-Aco", "command"], { timeout: 2000 });
+        return stdout;
+    }
+    catch {
+        return "";
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* fs helpers                                                                 */
+/* -------------------------------------------------------------------------- */
+async function pathExists(p) {
+    try {
+        await fs.stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const JETBRAINS_PRODUCTS = [
+    {
+        configPrefix: "IntelliJIdea",
+        macApp: "IntelliJ IDEA.app",
+        bin: ["idea"],
+        displayName: "IntelliJ IDEA",
+        processFragment: "idea",
+    },
+    {
+        configPrefix: "IntelliJIdea",
+        macApp: "IntelliJ IDEA Ultimate.app",
+        bin: ["idea"],
+        displayName: "IntelliJ IDEA",
+        processFragment: "idea",
+    },
+    {
+        configPrefix: "IdeaIC",
+        macApp: "IntelliJ IDEA CE.app",
+        bin: ["idea"],
+        displayName: "IntelliJ IDEA CE",
+        processFragment: "idea",
+    },
+    {
+        configPrefix: "WebStorm",
+        macApp: "WebStorm.app",
+        bin: ["webstorm"],
+        displayName: "WebStorm",
+        processFragment: "webstorm",
+    },
+    {
+        configPrefix: "PyCharm",
+        macApp: "PyCharm.app",
+        bin: ["pycharm"],
+        displayName: "PyCharm",
+        processFragment: "pycharm",
+    },
+    {
+        configPrefix: "PyCharmCE",
+        macApp: "PyCharm CE.app",
+        bin: ["pycharm"],
+        displayName: "PyCharm CE",
+        processFragment: "pycharm",
+    },
+    {
+        configPrefix: "GoLand",
+        macApp: "GoLand.app",
+        bin: ["goland"],
+        displayName: "GoLand",
+        processFragment: "goland",
+    },
+    {
+        configPrefix: "RustRover",
+        macApp: "RustRover.app",
+        bin: ["rustrover"],
+        displayName: "RustRover",
+        processFragment: "rustrover",
+    },
+    {
+        configPrefix: "CLion",
+        macApp: "CLion.app",
+        bin: ["clion"],
+        displayName: "CLion",
+        processFragment: "clion",
+    },
+    {
+        configPrefix: "RubyMine",
+        macApp: "RubyMine.app",
+        bin: ["mine"],
+        displayName: "RubyMine",
+        processFragment: "rubymine",
+    },
+    {
+        configPrefix: "PhpStorm",
+        macApp: "PhpStorm.app",
+        bin: ["pstorm"],
+        displayName: "PhpStorm",
+        processFragment: "phpstorm",
+    },
+    {
+        configPrefix: "DataGrip",
+        macApp: "DataGrip.app",
+        bin: ["datagrip"],
+        displayName: "DataGrip",
+        processFragment: "datagrip",
+    },
+    {
+        configPrefix: "Rider",
+        macApp: "Rider.app",
+        bin: ["rider"],
+        displayName: "Rider",
+        processFragment: "rider",
+    },
+];
+async function detectJetBrains(procList) {
+    const configRoot = jetBrainsConfigRoot();
+    let configDirs = [];
+    try {
+        const entries = await fs.readdir(configRoot, { withFileTypes: true });
+        configDirs = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        // No JetBrains configs at all → no JetBrains products installed.
+    }
+    // Find the newest config dir matching any known product prefix. The
+    // dir name format is `<Prefix><Year>.<Minor>` (e.g. IntelliJIdea2025.2).
+    let bestProduct;
+    let bestConfig;
+    let bestVersion = "";
+    for (const dir of configDirs) {
+        for (const p of JETBRAINS_PRODUCTS) {
+            if (!dir.startsWith(p.configPrefix))
+                continue;
+            const ver = dir.slice(p.configPrefix.length);
+            if (!/^\d{4}\.\d+$/.test(ver))
+                continue;
+            if (compareJbVersion(ver, bestVersion) > 0) {
+                bestProduct = p;
+                bestConfig = dir;
+                bestVersion = ver;
+            }
+        }
+    }
+    // Also probe for an .app bundle on macOS even if no config dir exists yet.
+    let cliPath;
+    let macAppFound;
+    if (platform() === "darwin") {
+        for (const p of JETBRAINS_PRODUCTS) {
+            for (const root of ["/Applications", join(homedir(), "Applications")]) {
+                const app = join(root, p.macApp);
+                if (await pathExists(app)) {
+                    macAppFound ??= p;
+                    // JetBrains ships a tiny launcher script under MacOS/<bin>
+                    for (const bin of p.bin) {
+                        const candidate = join(app, "Contents", "MacOS", bin);
+                        if (await pathExists(candidate)) {
+                            cliPath ??= candidate;
+                            break;
+                        }
+                    }
+                    break;
+                }
+            }
+        }
+    }
+    // PATH lookup last (Toolbox often installs `idea`, `webstorm` shims).
+    if (!cliPath) {
+        const product = bestProduct ?? macAppFound;
+        if (product) {
+            for (const bin of product.bin) {
+                const p = await whichBinary(bin);
+                if (p) {
+                    cliPath = p;
+                    break;
+                }
+            }
+        }
+    }
+    const product = bestProduct ?? macAppFound;
+    if (!product && !cliPath && !bestConfig)
+        return undefined;
+    const userDataDir = bestConfig ? join(configRoot, bestConfig) : undefined;
+    const extensionsDir = userDataDir ? join(userDataDir, "plugins") : undefined;
+    const haveData = !!userDataDir && (await pathExists(userDataDir));
+    const haveCli = !!cliPath;
+    const running = procList.length > 0 &&
+        !!product &&
+        procList.toLowerCase().includes(product.processFragment);
+    return {
+        id: "jetbrains",
+        displayName: product
+            ? bestVersion
+                ? `${product.displayName} ${bestVersion}`
+                : product.displayName
+            : "JetBrains IDE",
+        family: "jetbrains",
+        cliPath,
+        extensionsDir,
+        userDataDir,
+        installed: haveCli && haveData,
+        partial: !(haveCli && haveData),
+        running,
+    };
+}
+function jetBrainsConfigRoot() {
+    switch (platform()) {
+        case "darwin":
+            return join(homedir(), "Library", "Application Support", "JetBrains");
+        case "win32":
+            return join(process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"), "JetBrains");
+        default:
+            return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "JetBrains");
+    }
+}
+/** Compare "2025.2" vs "2024.3" — newer wins. Empty string sorts lowest. */
+function compareJbVersion(a, b) {
+    if (!a)
+        return -1;
+    if (!b)
+        return 1;
+    const [ay, am] = a.split(".").map(Number);
+    const [by, bm] = b.split(".").map(Number);
+    if ((ay ?? 0) !== (by ?? 0))
+        return (ay ?? 0) - (by ?? 0);
+    return (am ?? 0) - (bm ?? 0);
+}
+/* -------------------------------------------------------------------------- */
+/* Neovim probe                                                               */
+/* -------------------------------------------------------------------------- */
+async function detectNeovim(procList) {
+    const cliPath = await whichBinary("nvim");
+    const configDir = platform() === "win32"
+        ? join(process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local"), "nvim")
+        : join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "nvim");
+    const dataDir = platform() === "win32"
+        ? join(process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local"), "nvim-data")
+        : join(process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share"), "nvim");
+    const haveConfig = await pathExists(configDir);
+    const haveData = await pathExists(dataDir);
+    if (!cliPath && !haveConfig && !haveData)
+        return undefined;
+    const running = procList.length > 0 && /\bnvim\b/.test(procList);
+    return {
+        id: "neovim",
+        displayName: "Neovim",
+        family: "other",
+        cliPath,
+        extensionsDir: haveData ? dataDir : undefined,
+        userDataDir: haveConfig ? configDir : undefined,
+        installed: !!cliPath && haveConfig,
+        partial: !(cliPath && haveConfig),
+        running,
+    };
+}
+//# sourceMappingURL=host-detect.js.map

package/dist/lib/host-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-detect.js","sourceRoot":"","sources":["../../src/lib/host-detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAsCjC,MAAM,aAAa,GAAiC;IAClD;QACE,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,SAAS;QACtB,GAAG,EAAE,CAAC,MAAM,CAAC;QACb,OAAO,EAAE,CAAC,wBAAwB,CAAC;QACnC,cAAc,EAAE,MAAM;QACtB,gBAAgB,EAAE,oBAAoB;QACtC,eAAe,EAAE,oBAAoB;KACtC;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,kBAAkB;QAC/B,GAAG,EAAE,CAAC,eAAe,CAAC;QACtB,OAAO,EAAE,CAAC,mCAAmC,CAAC;QAC9C,cAAc,EAAE,iBAAiB;QACjC,gBAAgB,EAAE,6BAA6B;QAC/C,eAAe,EAAE,+BAA+B;KACjD;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,QAAQ;QACrB,GAAG,EAAE,CAAC,QAAQ,CAAC;QACf,OAAO,EAAE,CAAC,YAAY,CAAC;QACvB,cAAc,EAAE,QAAQ;QACxB,gBAAgB,EAAE,oBAAoB;QACtC,eAAe,EAAE,QAAQ;KAC1B;IACD;QACE,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,UAAU;QACvB,GAAG,EAAE,CAAC,UAAU,CAAC;QACjB,OAAO,EAAE,CAAC,cAAc,CAAC;QACzB,cAAc,EAAE,UAAU;QAC1B,gBAAgB,EAAE,sBAAsB;QACxC,eAAe,EAAE,UAAU;KAC5B;IACD;QACE,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,UAAU;QACvB,GAAG,EAAE,CAAC,QAAQ,CAAC;QACf,OAAO,EAAE,CAAC,cAAc,CAAC;QACzB,cAAc,EAAE,UAAU;QAC1B,gBAAgB,EAAE,wBAAwB;QAC1C,eAAe,EAAE,UAAU;KAC5B;CACF,CAAC;AAWF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAsB,EAAE;IAExB,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,wEAAwE;IACxE,qBAAqB;IACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,iBAAiB,EAAE,CAAC;IAExE,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACvD,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,4EAA4E;IAC5E,0EAA0E;IAC1E,0CAA0C;IAC1C,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEvB,6CAA6C;IAC7C,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEvB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAU;IAEV,MAAM,GAAG,GAAG,MAAM,WAAW,EAAE,CAAC;IAChC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,KAAK,UAAU,kBAAkB,CAC/B,KAAwB,EACxB,QAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,mBAAmB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAElE,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;IAC1B,MAAM,QAAQ,GAAG,cAAc,IAAI,YAAY,CAAC;IAEhD,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAE5C,MAAM,OAAO,GACX,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAElE,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,QAAQ;QAChB,OAAO;QACP,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;QACvD,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QACrD,SAAS,EAAE,OAAO,IAAI,QAAQ;QAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,QAAQ,CAAC;QAC/B,OAAO;KACR,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,SAAS,iBAAiB,CAAC,MAAc;IACvC,QAAQ,QAAQ,EAAE,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;QACnE,KAAK,OAAO;YACV,OAAO,IAAI,CACT,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EAC5D,MAAM,CACP,CAAC;QACJ;YACE,OAAO,IAAI,CACT,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EACzD,MAAM,CACP,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc;IACzC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,KAAK,UAAU,OAAO,CAAC,KAAwB;IAC7C,sEAAsE;IACtE,IAAI,QAAQ,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChC,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;gBACtE,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;oBAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;oBACtE,IAAI,MAAM,UAAU,CAAC,CAAC,CAAC;wBAAE,OAAO,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IAClB,CAAC;IAED,iEAAiE;IACjE,MAAM,UAAU,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,MAAM,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAwB;IACpD,IAAI,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GACT,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,mBAAmB,CAAC;QACjE,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;YAC7D,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;SACrD,CAAC,CAAC;IACL,CAAC;IACD,qBAAqB;IACrB,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC9B,YAAY,CAAC,EAAE;QACf,kBAAkB,CAAC,EAAE;QACrB,aAAa,CAAC,EAAE;QAChB,gCAAgC,CAAC,EAAE;KACpC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,GAAW;IACpC,uEAAuE;IACvE,wDAAwD;IACxD,MAAM,GAAG,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,MAAM,IAAI,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;YACvC,KAAK,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,yBAAyB;YACxD,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrE,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,KAAK,UAAU,iBAAiB;IAC9B,IAAI,CAAC;QACH,IAAI,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;YAC3B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,KAAK,UAAU,UAAU,CAAC,CAAS;IACjC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAmBD,MAAM,kBAAkB,GAAgC;IACtD;QACE,YAAY,EAAE,cAAc;QAC5B,MAAM,EAAE,mBAAmB;QAC3B,GAAG,EAAE,CAAC,MAAM,CAAC;QACb,WAAW,EAAE,eAAe;QAC5B,eAAe,EAAE,MAAM;KACxB;IACD;QACE,YAAY,EAAE,cAAc;QAC5B,MAAM,EAAE,4BAA4B;QACpC,GAAG,EAAE,CAAC,MAAM,CAAC;QACb,WAAW,EAAE,eAAe;QAC5B,eAAe,EAAE,MAAM;KACxB;IACD;QACE,YAAY,EAAE,QAAQ;QACtB,MAAM,EAAE,sBAAsB;QAC9B,GAAG,EAAE,CAAC,MAAM,CAAC;QACb,WAAW,EAAE,kBAAkB;QAC/B,eAAe,EAAE,MAAM;KACxB;IACD;QACE,YAAY,EAAE,UAAU;QACxB,MAAM,EAAE,cAAc;QACtB,GAAG,EAAE,CAAC,UAAU,CAAC;QACjB,WAAW,EAAE,UAAU;QACvB,eAAe,EAAE,UAAU;KAC5B;IACD;QACE,YAAY,EAAE,SAAS;QACvB,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,CAAC,SAAS,CAAC;QAChB,WAAW,EAAE,SAAS;QACtB,eAAe,EAAE,SAAS;KAC3B;IACD;QACE,YAAY,EAAE,WAAW;QACzB,MAAM,EAAE,gBAAgB;QACxB,GAAG,EAAE,CAAC,SAAS,CAAC;QAChB,WAAW,EAAE,YAAY;QACzB,eAAe,EAAE,SAAS;KAC3B;IACD;QACE,YAAY,EAAE,QAAQ;QACtB,MAAM,EAAE,YAAY;QACpB,GAAG,EAAE,CAAC,QAAQ,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,eAAe,EAAE,QAAQ;KAC1B;IACD;QACE,YAAY,EAAE,WAAW;QACzB,MAAM,EAAE,eAAe;QACvB,GAAG,EAAE,CAAC,WAAW,CAAC;QAClB,WAAW,EAAE,WAAW;QACxB,eAAe,EAAE,WAAW;KAC7B;IACD;QACE,YAAY,EAAE,OAAO;QACrB,MAAM,EAAE,WAAW;QACnB,GAAG,EAAE,CAAC,OAAO,CAAC;QACd,WAAW,EAAE,OAAO;QACpB,eAAe,EAAE,OAAO;KACzB;IACD;QACE,YAAY,EAAE,UAAU;QACxB,MAAM,EAAE,cAAc;QACtB,GAAG,EAAE,CAAC,MAAM,CAAC;QACb,WAAW,EAAE,UAAU;QACvB,eAAe,EAAE,UAAU;KAC5B;IACD;QACE,YAAY,EAAE,UAAU;QACxB,MAAM,EAAE,cAAc;QACtB,GAAG,EAAE,CAAC,QAAQ,CAAC;QACf,WAAW,EAAE,UAAU;QACvB,eAAe,EAAE,UAAU;KAC5B;IACD;QACE,YAAY,EAAE,UAAU;QACxB,MAAM,EAAE,cAAc;QACtB,GAAG,EAAE,CAAC,UAAU,CAAC;QACjB,WAAW,EAAE,UAAU;QACvB,eAAe,EAAE,UAAU;KAC5B;IACD;QACE,YAAY,EAAE,OAAO;QACrB,MAAM,EAAE,WAAW;QACnB,GAAG,EAAE,CAAC,OAAO,CAAC;QACd,WAAW,EAAE,OAAO;QACpB,eAAe,EAAE,OAAO;KACzB;CACF,CAAC;AAEF,KAAK,UAAU,eAAe,CAC5B,QAAgB;IAEhB,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;IACzC,IAAI,UAAU,GAAa,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;IAED,oEAAoE;IACpE,yEAAyE;IACzE,IAAI,WAAyC,CAAC;IAC9C,IAAI,UAA8B,CAAC;IACnC,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,kBAAkB,EAAE,CAAC;YACnC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;gBAAE,SAAS;YAC9C,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,SAAS;YACxC,IAAI,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3C,WAAW,GAAG,CAAC,CAAC;gBAChB,UAAU,GAAG,GAAG,CAAC;gBACjB,WAAW,GAAG,GAAG,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,IAAI,OAA2B,CAAC;IAChC,IAAI,WAAyC,CAAC;IAC9C,IAAI,QAAQ,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,kBAAkB,EAAE,CAAC;YACnC,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;gBACtE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;gBACjC,IAAI,MAAM,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1B,WAAW,KAAK,CAAC,CAAC;oBAClB,2DAA2D;oBAC3D,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;wBACxB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;wBACtD,IAAI,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;4BAChC,OAAO,KAAK,SAAS,CAAC;4BACtB,MAAM;wBACR,CAAC;oBACH,CAAC;oBACD,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,WAAW,IAAI,WAAW,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC9B,MAAM,CAAC,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;gBACjC,IAAI,CAAC,EAAE,CAAC;oBACN,OAAO,GAAG,CAAC,CAAC;oBACZ,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,IAAI,WAAW,CAAC;IAC3C,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAE1D,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;IAC1B,MAAM,OAAO,GACX,QAAQ,CAAC,MAAM,GAAG,CAAC;QACnB,CAAC,CAAC,OAAO;QACT,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAE3D,OAAO;QACL,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,OAAO;YAClB,CAAC,CAAC,WAAW;gBACX,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,EAAE;gBACzC,CAAC,CAAC,OAAO,CAAC,WAAW;YACvB,CAAC,CAAC,eAAe;QACnB,MAAM,EAAE,WAAW;QACnB,OAAO;QACP,aAAa;QACb,WAAW;QACX,SAAS,EAAE,OAAO,IAAI,QAAQ;QAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,QAAQ,CAAC;QAC/B,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB;IAC1B,QAAQ,QAAQ,EAAE,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,WAAW,CAAC,CAAC;QACxE,KAAK,OAAO;YACV,OAAO,IAAI,CACT,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EAC5D,WAAW,CACZ,CAAC;QACJ;YACE,OAAO,IAAI,CACT,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EACzD,WAAW,CACZ,CAAC;IACN,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,SAAS,gBAAgB,CAAC,CAAS,EAAE,CAAS;IAC5C,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IAClB,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,KAAK,UAAU,YAAY,CACzB,QAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GACb,QAAQ,EAAE,KAAK,OAAO;QACpB,CAAC,CAAC,IAAI,CACF,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAC/D,MAAM,CACP;QACH,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9E,MAAM,OAAO,GACX,QAAQ,EAAE,KAAK,OAAO;QACpB,CAAC,CAAC,IAAI,CACF,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAC/D,WAAW,CACZ;QACH,CAAC,CAAC,IAAI,CACF,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,EAC/D,MAAM,CACP,CAAC;IAER,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAE3D,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEjE,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,OAAO;QACf,OAAO;QACP,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAC7C,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAC/C,SAAS,EAAE,CAAC,CAAC,OAAO,IAAI,UAAU;QAClC,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC;QACjC,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/lib/oxp-url.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `oxp://` deep-link parser.
+ *
+ * Supported forms:
+ *
+ *   oxp://install/@publisher/slug
+ *   oxp://install/@publisher/slug?version=1.2.3
+ *   oxp://install/@publisher/slug?version=1.2.3&host=vscode&host=cursor
+ *
+ * The web side (`apps/web`) emits these as the target of "Install"
+ * buttons. The OS routes the URL to whichever app has registered the
+ * `oxp` scheme — for us, the helper produced by `oxp protocol-register`,
+ * which simply re-invokes `oxp install --from <url>`.
+ *
+ * Strict parsing on purpose: a bad URL fails fast rather than letting a
+ * malformed click mutate the install store.
+ */
+export interface InstallUrl {
+    kind: "install";
+    id: string;
+    version?: string;
+    hosts?: string[];
+}
+export type ParsedOxpUrl = InstallUrl;
+export declare class OxpUrlError extends Error {
+    constructor(message: string);
+}
+export declare function parseOxpUrl(input: string): ParsedOxpUrl;
+/** Build a canonical install URL — used by the web button helper. */
+export declare function buildInstallUrl(id: string, opts?: {
+    version?: string;
+    hosts?: string[];
+}): string;
+//# sourceMappingURL=oxp-url.d.ts.map

package/dist/lib/oxp-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oxp-url.d.ts","sourceRoot":"","sources":["../../src/lib/oxp-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AAEtC,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CA2CvD;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAChD,MAAM,CAMR"}

package/dist/lib/oxp-url.js

@@ -0,0 +1,74 @@
+/**
+ * `oxp://` deep-link parser.
+ *
+ * Supported forms:
+ *
+ *   oxp://install/@publisher/slug
+ *   oxp://install/@publisher/slug?version=1.2.3
+ *   oxp://install/@publisher/slug?version=1.2.3&host=vscode&host=cursor
+ *
+ * The web side (`apps/web`) emits these as the target of "Install"
+ * buttons. The OS routes the URL to whichever app has registered the
+ * `oxp` scheme — for us, the helper produced by `oxp protocol-register`,
+ * which simply re-invokes `oxp install --from <url>`.
+ *
+ * Strict parsing on purpose: a bad URL fails fast rather than letting a
+ * malformed click mutate the install store.
+ */
+export class OxpUrlError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "OxpUrlError";
+    }
+}
+const ID_RE = /^@[^/\s]+\/[^/\s?#]+$/;
+export function parseOxpUrl(input) {
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch {
+        throw new OxpUrlError(`not a valid URL: ${input}`);
+    }
+    if (url.protocol !== "oxp:") {
+        throw new OxpUrlError(`expected oxp:// scheme, got ${url.protocol}`);
+    }
+    // `new URL("oxp://install/@p/s")` parses host="install" and pathname="/@p/s".
+    const action = url.host || url.hostname;
+    if (action !== "install") {
+        throw new OxpUrlError(`unknown action '${action}' (expected 'install')`);
+    }
+    // Strip leading slash; everything after is `@publisher/slug`.
+    const id = decodeURIComponent(url.pathname.replace(/^\/+/, ""));
+    if (!ID_RE.test(id)) {
+        throw new OxpUrlError(`bad extension id '${id}' — expected @publisher/slug`);
+    }
+    const version = url.searchParams.get("version") ?? undefined;
+    if (version && !/^[A-Za-z0-9.\-+]+$/.test(version)) {
+        throw new OxpUrlError(`bad version '${version}'`);
+    }
+    const hosts = url.searchParams.getAll("host");
+    for (const h of hosts) {
+        if (!/^[a-z0-9-]+$/.test(h)) {
+            throw new OxpUrlError(`bad host filter '${h}'`);
+        }
+    }
+    return {
+        kind: "install",
+        id,
+        version,
+        hosts: hosts.length ? hosts : undefined,
+    };
+}
+/** Build a canonical install URL — used by the web button helper. */
+export function buildInstallUrl(id, opts = {}) {
+    if (!ID_RE.test(id))
+        throw new OxpUrlError(`bad id ${id}`);
+    const url = new URL(`oxp://install/${id}`);
+    if (opts.version)
+        url.searchParams.set("version", opts.version);
+    for (const h of opts.hosts ?? [])
+        url.searchParams.append("host", h);
+    return url.toString();
+}
+//# sourceMappingURL=oxp-url.js.map

package/dist/lib/oxp-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oxp-url.js","sourceRoot":"","sources":["../../src/lib/oxp-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAWH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,KAAK,GAAG,uBAAuB,CAAC;AAEtC,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,WAAW,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,WAAW,CAAC,+BAA+B,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,8EAA8E;IAC9E,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC;IACxC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,WAAW,CAAC,mBAAmB,MAAM,wBAAwB,CAAC,CAAC;IAC3E,CAAC;IAED,8DAA8D;IAC9D,MAAM,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,WAAW,CACnB,qBAAqB,EAAE,8BAA8B,CACtD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;IAC7D,IAAI,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,WAAW,CAAC,gBAAgB,OAAO,GAAG,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,WAAW,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,EAAE;QACF,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KACxC,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAC7B,EAAU,EACV,OAA+C,EAAE;IAEjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,OAAO;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAChE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE;QAAE,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC"}

package/dist/lib/vsx-install.d.ts

@@ -0,0 +1,41 @@
+/**
+ * VSX install adapter — handles `oxp install @publisher/slug` for entries
+ * that are mirrored from Open VSX rather than published natively to OXP.
+ *
+ * Strategy:
+ *   1. Caller pre-fetched `/api/v1/extensions/<publisher>/<slug>` and
+ *      saw a `vsx` block in the response → call `installVsx()`.
+ *   2. We detect the user's VS Code-family IDEs (already done by the
+ *      install command) and run `<cli> --install-extension <ns>.<name>`
+ *      against each one. The IDE's own install path handles VSIX fetch,
+ *      signature checks (or lack thereof), and registration.
+ *   3. We DO NOT touch the OXP shared host-store — VSX extensions are
+ *      not OXP wasm components and have no oxp.json runtime contract.
+ *
+ * This keeps the CLI honest: VSX entries are explicitly delegated to
+ * the IDE, and we surface that in CLI output so the user knows what
+ * happened.
+ */
+import type { DetectedHost } from "./host-detect.js";
+export interface VsxInstallTarget {
+    namespace: string;
+    name: string;
+    /** Optional; informational only. */
+    version?: string;
+}
+export interface VsxInstallReport {
+    host: DetectedHost;
+    /** ok | skipped | failed */
+    status: "ok" | "skipped" | "failed";
+    /** Filled when status !== ok. */
+    reason?: string;
+    /** Captured stdout/stderr tail (truncated to 400 chars). */
+    output?: string;
+}
+/**
+ * Run `<cliPath> --install-extension <namespace>.<name>` against every
+ * detected vscode-family host. JetBrains/Zed/Piye are reported as
+ * skipped since they have no compatible install command for VSIX.
+ */
+export declare function installVsx(target: VsxInstallTarget, hosts: DetectedHost[]): VsxInstallReport[];
+//# sourceMappingURL=vsx-install.d.ts.map

package/dist/lib/vsx-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsx-install.d.ts","sourceRoot":"","sources":["../../src/lib/vsx-install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,4BAA4B;IAC5B,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpC,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,YAAY,EAAE,GACpB,gBAAgB,EAAE,CAgDpB"}