@monotykamary/localterm-server 2.33.0 → 2.34.0

package/dist/utils/find-binary-on-path.js

@@ -0,0 +1,24 @@
+import { accessSync, constants } from "node:fs";
+import { delimiter, join } from "node:path";
+// Walks PATH for an executable named `name`, returning the first absolute path
+// that's executable or null when nothing matches. Sync because the keep-awake
+// controller reads `supported` at construction (a handful of stat calls scoped
+// to the few PATH dirs, microseconds) and the browser launcher calls it inside
+// a best-effort async handler where brief sync fs is harmless. No shell-out to
+// `which`/`command -v`, so it works without a POSIX shell on PATH.
+export const findBinaryOnPath = (name, envPath = process.env.PATH ?? "") => {
+    for (const dir of envPath.split(delimiter)) {
+        if (!dir)
+            continue;
+        const candidate = join(dir, name);
+        try {
+            accessSync(candidate, constants.X_OK);
+            return candidate;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+};
+//# sourceMappingURL=find-binary-on-path.js.map

package/dist/utils/find-binary-on-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-binary-on-path.js","sourceRoot":"","sources":["../../src/utils/find-binary-on-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5C,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,mEAAmE;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,IAAY,EACZ,UAAkB,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EACzB,EAAE;IACjB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC;YACH,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/utils/open-chrome-inspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-chrome-inspect.d.ts","sourceRoot":"","sources":["../../src/utils/open-chrome-inspect.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,IAAI,CAWtD,CAAC"}
+{"version":3,"file":"open-chrome-inspect.d.ts","sourceRoot":"","sources":["../../src/utils/open-chrome-inspect.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,IAAI,CAoBtD,CAAC"}

package/dist/utils/open-chrome-inspect.js

@@ -1,6 +1,7 @@
 import { spawn } from "node:child_process";
 import open from "open";
 import { getBrowserCandidates } from "../cdp/detect-chromium.js";
+import { findBinaryOnPath } from "./find-binary-on-path.js";
 // chrome://inspect with the #remote-debugging fragment jumps straight to the
 // "Discover network targets" section the user needs to toggle.
 const CHROME_INSPECT_URL = "chrome://inspect/#remote-debugging";
@@ -10,13 +11,18 @@ const darwinAppName = (candidateName) => candidateName === "Brave" ? "Brave Brow
 // Open chrome://inspect in the user's browser. This is the bootstrap path for
 // users who haven't enabled remote debugging yet, so it must NOT go through CDP.
 // chrome:// URLs can't be navigated to from a web page and have no registered
-// URL-scheme handler on the OS, so the daemon targets a running Chromium app by
-// name — picked dynamically (never assumed): the frontmost one (the browser the
-// user is viewing localterm in), falling back to the first running candidate.
+// URL-scheme handler on the OS, so the daemon targets a Chromium app — picked
+// dynamically (never assumed): the frontmost one (the browser the user is
+// viewing localterm in), falling back to the first running candidate.
 //
 // macOS: AppleScript `open location` addressed to the chosen app reuses its
-// current profile (avoids the profile picker that `open -a` triggers). Elsewhere
-// we fall back to the OS opener. Best-effort — never throws.
+// current profile (avoids the profile picker that `open -a` triggers).
+// Linux: xdg-open has no chrome:// handler, so invoke the browser binary
+// directly with the URL — a running Chromium reuses the existing instance's
+// profile and opens a new tab (the same profile-reuse behavior the macOS
+// AppleScript buys us). The first installed candidate wins; priority order
+// matches the DevToolsActivePort scan.
+// Elsewhere we fall back to the OS opener. Best-effort — never throws.
 export const openChromeInspect = async () => {
     try {
         if (process.platform === "darwin") {
@@ -24,12 +30,56 @@ export const openChromeInspect = async () => {
             await runOsascript(darwinOpenInspectScript(CHROME_INSPECT_URL, apps));
             return;
         }
+        if (process.platform === "linux") {
+            const binary = findInstalledLinuxBrowserBinary();
+            if (binary !== null) {
+                // Fire-and-forget: the browser owns its own lifecycle and must outlive
+                // the daemon. detached + unref lets the daemon exit without waiting.
+                spawn(binary, [CHROME_INSPECT_URL], { stdio: "ignore", detached: true }).unref();
+                return;
+            }
+        }
         await open(CHROME_INSPECT_URL);
     }
     catch {
         /* best-effort — the user can open the page manually */
     }
 };
+// Candidate browser name -> the binary names it ships as on Linux, in the
+// order to prefer (stable over canary, non-suffixed over -stable where both
+// exist). Names align with the linux branch of getBrowserCandidates so the
+// DevToolsActivePort scan and the launcher agree on which browsers localterm
+// looks for.
+const LINUX_BROWSER_BINARIES = {
+    "Google Chrome": ["google-chrome-stable", "google-chrome"],
+    "Google Chrome Canary": ["google-chrome-unstable", "google-chrome-canary"],
+    Chromium: ["chromium", "chromium-browser"],
+    "Microsoft Edge": ["microsoft-edge", "microsoft-edge-stable"],
+    Brave: ["brave-browser", "brave"],
+    Dia: ["dia"],
+    Vivaldi: ["vivaldi"],
+    Opera: ["opera", "opera-stable"],
+    Aside: ["aside"],
+};
+// First candidate browser binary that's executable on PATH, scanning browsers
+// in DevToolsActivePort-scan priority order. Resolves to the absolute path so
+// the spawn isn't PATH-dependent at exec time. Null when no Chromium binary is
+// installed (the caller then falls back to the OS opener).
+const findInstalledLinuxBrowserBinary = () => {
+    const binaries = [];
+    for (const candidate of getBrowserCandidates()) {
+        for (const binary of LINUX_BROWSER_BINARIES[candidate.name] ?? []) {
+            if (!binaries.includes(binary))
+                binaries.push(binary);
+        }
+    }
+    for (const binary of binaries) {
+        const resolved = findBinaryOnPath(binary);
+        if (resolved !== null)
+            return resolved;
+    }
+    return null;
+};
 const darwinOpenInspectScript = (url, apps) => `
 set inspectURL to "${url}"
 set browserApps to {${apps.map((app) => `"${app}"`).join(", ")}}

package/dist/utils/open-chrome-inspect.js.map

@@ -1 +1 @@
-{"version":3,"file":"open-chrome-inspect.js","sourceRoot":"","sources":["../../src/utils/open-chrome-inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,6EAA6E;AAC7E,+DAA+D;AAC/D,MAAM,kBAAkB,GAAG,oCAAoC,CAAC;AAEhE,8EAA8E;AAC9E,uDAAuD;AACvD,MAAM,aAAa,GAAG,CAAC,aAAqB,EAAU,EAAE,CACtD,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC;AAE9D,8EAA8E;AAC9E,iFAAiF;AACjF,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,iFAAiF;AACjF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,IAAmB,EAAE;IACzD,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACtF,MAAM,YAAY,CAAC,uBAAuB,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,CAAC;YACtE,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;IACzD,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,GAAW,EAAE,IAAuB,EAAU,EAAE,CAAC;qBAC7D,GAAG;sBACF,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;CAkB7D,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,MAAc,EAAiB,EAAE,CACrD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACxB,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;;YACrB,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC,CAAC,CAAC"}
+{"version":3,"file":"open-chrome-inspect.js","sourceRoot":"","sources":["../../src/utils/open-chrome-inspect.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monotykamary/localterm-server",
-  "version": "2.33.0",
+  "version": "2.34.0",
   "description": "PTY-backed HTTP/WebSocket server that powers localterm, built on Hono + node-pty.",
   "keywords": [
     "hono",