chrome-proc 1.0.0 → 1.0.1

package/dist/platform/linux.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.linuxProvider = void 0;
+const child_process_1 = require("child_process");
+const os_1 = require("os");
+const fs_1 = require("fs");
+const completion_helpers_1 = require("./completion-helpers");
+const CHROME_CANDIDATES = [
+    "/usr/bin/google-chrome",
+    "/usr/bin/google-chrome-stable",
+    "/usr/bin/chromium",
+    "/usr/bin/chromium-browser",
+];
+function getChromePids(exact = false) {
+    const names = ["chrome", "google-chrome", "google-chrome-stable", "chromium", "chromium-browser"];
+    const pids = [];
+    for (const name of names) {
+        try {
+            const flag = exact ? "-x" : "-f";
+            const output = (0, child_process_1.execSync)(`pgrep ${flag} "${name}"`, { encoding: "utf-8" });
+            output
+                .trim()
+                .split("\n")
+                .filter((line) => line.trim() !== "")
+                .map((line) => parseInt(line.trim(), 10))
+                .filter((pid) => !isNaN(pid) && !pids.includes(pid))
+                .forEach((pid) => pids.push(pid));
+        }
+        catch {
+            // pgrep exits with code 1 when no matches found
+        }
+    }
+    return pids;
+}
+function getProcessArgs(pid) {
+    try {
+        return (0, child_process_1.execSync)(`ps -p "${pid}" -o args=`, { encoding: "utf-8" }).trim();
+    }
+    catch {
+        return "?";
+    }
+}
+function getProcessName(pid) {
+    try {
+        return (0, child_process_1.execSync)(`ps -p "${pid}" -o comm=`, { encoding: "utf-8" }).trim();
+    }
+    catch {
+        return "?";
+    }
+}
+function killPid(pid, signal) {
+    try {
+        (0, child_process_1.execSync)(`kill -${signal} "${pid}"`, { stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isChromeRunning() {
+    return getChromePids(true).length > 0;
+}
+const processManager = {
+    getChromePids,
+    getProcessArgs,
+    getProcessName,
+    killPid,
+    isChromeRunning,
+};
+function findChrome() {
+    for (const candidate of CHROME_CANDIDATES) {
+        if ((0, fs_1.existsSync)(candidate)) {
+            return candidate;
+        }
+    }
+    return CHROME_CANDIDATES[0];
+}
+exports.linuxProvider = {
+    name: "linux",
+    getChromeExecutablePath() {
+        return findChrome();
+    },
+    getDefaultChromeDataDir() {
+        return `${(0, os_1.homedir)()}/.config/google-chrome`;
+    },
+    getProcessManager() {
+        return processManager;
+    },
+    supportedShells() {
+        return ["bash", "zsh"];
+    },
+    generateCompletion(shell, profileDirs) {
+        switch (shell) {
+            case "bash":
+                return (0, completion_helpers_1.generateBashCompletion)(profileDirs);
+            case "zsh":
+                return (0, completion_helpers_1.generateZshCompletion)(profileDirs);
+            default:
+                throw new Error(`Unsupported shell: ${shell}`);
+        }
+    },
+};

package/dist/platform/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/platform/win32.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.win32Provider = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const completion_helpers_1 = require("./completion-helpers");
+function getChromePids(_exact = false) {
+    try {
+        const output = (0, child_process_1.execSync)(`tasklist /FI "IMAGENAME eq chrome.exe" /FO CSV /NH`, { encoding: "utf-8" }).trim();
+        if (!output || output.startsWith("INFO:"))
+            return [];
+        return output
+            .split("\n")
+            .map((line) => {
+            const match = line.match(/^"[^"]+","(\d+)"/);
+            return match ? parseInt(match[1], 10) : NaN;
+        })
+            .filter((pid) => !isNaN(pid));
+    }
+    catch {
+        return [];
+    }
+}
+function getProcessArgs(pid) {
+    try {
+        const output = (0, child_process_1.execSync)(`powershell.exe -NoProfile -Command "(Get-CimInstance Win32_Process -Filter \\"ProcessId=${pid}\\").CommandLine"`, { encoding: "utf-8" }).trim();
+        return output || "?";
+    }
+    catch {
+        return "?";
+    }
+}
+function getProcessName(pid) {
+    try {
+        const output = (0, child_process_1.execSync)(`tasklist /FI "PID eq ${pid}" /FO CSV /NH`, { encoding: "utf-8" }).trim();
+        if (!output || output.startsWith("INFO:"))
+            return "?";
+        const match = output.match(/^"([^"]+)"/);
+        return match ? match[1] : "?";
+    }
+    catch {
+        return "?";
+    }
+}
+function killPid(pid, signal) {
+    try {
+        const forceFlag = signal === "KILL" ? "/F" : "";
+        (0, child_process_1.execSync)(`taskkill /PID ${pid} /T ${forceFlag}`, { stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isChromeRunning() {
+    return getChromePids().length > 0;
+}
+const processManager = {
+    getChromePids,
+    getProcessArgs,
+    getProcessName,
+    killPid,
+    isChromeRunning,
+};
+function findChrome() {
+    const candidates = [];
+    if (process.env.LOCALAPPDATA) {
+        candidates.push(`${process.env.LOCALAPPDATA}\\Google\\Chrome\\Application\\chrome.exe`);
+    }
+    if (process.env.PROGRAMFILES) {
+        candidates.push(`${process.env.PROGRAMFILES}\\Google\\Chrome\\Application\\chrome.exe`);
+    }
+    if (process.env["PROGRAMFILES(X86)"]) {
+        candidates.push(`${process.env["PROGRAMFILES(X86)"]}\\Google\\Chrome\\Application\\chrome.exe`);
+    }
+    for (const candidate of candidates) {
+        if ((0, fs_1.existsSync)(candidate)) {
+            return candidate;
+        }
+    }
+    return candidates[0] || "chrome.exe";
+}
+exports.win32Provider = {
+    name: "win32",
+    getChromeExecutablePath() {
+        return findChrome();
+    },
+    getDefaultChromeDataDir() {
+        if (process.env.LOCALAPPDATA) {
+            return `${process.env.LOCALAPPDATA}\\Google\\Chrome\\User Data`;
+        }
+        return `${process.env.USERPROFILE || ""}\\AppData\\Local\\Google\\Chrome\\User Data`;
+    },
+    getProcessManager() {
+        return processManager;
+    },
+    supportedShells() {
+        return ["powershell"];
+    },
+    generateCompletion(shell, profileDirs) {
+        switch (shell) {
+            case "powershell":
+                return (0, completion_helpers_1.generatePowerShellCompletion)(profileDirs);
+            default:
+                throw new Error(`Unsupported shell: ${shell}`);
+        }
+    },
+};

package/dist/utils/localState.js

@@ -8,12 +8,13 @@ exports.profileExists = profileExists;
 exports.validateProfileDir = validateProfileDir;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const platform_1 = require("../platform");
 function getChromeDataDir() {
     const dir = process.env.CHROME_DATA_DIR;
-    if (!dir) {
-        throw new Error("CHROME_DATA_DIR environment variable is not set");
+    if (dir) {
+        return dir;
     }
-    return dir;
+    return (0, platform_1.getPlatform)().getDefaultChromeDataDir();
 }
 function getLocalStatePath() {
     return (0, path_1.join)(getChromeDataDir(), "Local State");

package/dist/utils/process.js

@@ -6,51 +6,23 @@ exports.getProcessName = getProcessName;
 exports.extractDebugPort = extractDebugPort;
 exports.killPid = killPid;
 exports.isChromeRunning = isChromeRunning;
-const child_process_1 = require("child_process");
+const platform_1 = require("../platform");
 function getChromePids(exact = false) {
-    try {
-        const flag = exact ? "-x" : "-f";
-        const output = (0, child_process_1.execSync)(`pgrep ${flag} "Google Chrome"`, { encoding: "utf-8" });
-        return output
-            .trim()
-            .split("\n")
-            .filter((line) => line.trim() !== "")
-            .map((line) => parseInt(line.trim(), 10))
-            .filter((pid) => !isNaN(pid));
-    }
-    catch {
-        return [];
-    }
+    return (0, platform_1.getPlatform)().getProcessManager().getChromePids(exact);
 }
 function getProcessArgs(pid) {
-    try {
-        return (0, child_process_1.execSync)(`ps -p "${pid}" -o args=`, { encoding: "utf-8" }).trim();
-    }
-    catch {
-        return "?";
-    }
+    return (0, platform_1.getPlatform)().getProcessManager().getProcessArgs(pid);
 }
 function getProcessName(pid) {
-    try {
-        return (0, child_process_1.execSync)(`ps -p "${pid}" -o comm=`, { encoding: "utf-8" }).trim();
-    }
-    catch {
-        return "?";
-    }
+    return (0, platform_1.getPlatform)().getProcessManager().getProcessName(pid);
 }
 function extractDebugPort(args) {
     const match = args.match(/--remote-debugging-port=(\d+)/);
     return match ? parseInt(match[1], 10) : null;
 }
 function killPid(pid, signal) {
-    try {
-        (0, child_process_1.execSync)(`/bin/kill -${signal} "${pid}"`, { stdio: "pipe" });
-        return true;
-    }
-    catch {
-        return false;
-    }
+    return (0, platform_1.getPlatform)().getProcessManager().killPid(pid, signal);
 }
 function isChromeRunning() {
-    return getChromePids(true).length > 0;
+    return (0, platform_1.getPlatform)().getProcessManager().isChromeRunning();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-proc",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Manage Chrome browser processes, profiles, and CDP endpoints",
   "main": "dist/index.js",
   "bin": {
@@ -10,7 +10,11 @@
     "build": "tsc",
     "dev": "tsc --watch"
   },
-  "keywords": ["chrome", "cdp", "devtools"],
+  "keywords": [
+    "chrome",
+    "cdp",
+    "devtools"
+  ],
   "license": "MIT",
   "dependencies": {
     "commander": "^12.0.0"

package/src/commands/completion.ts

@@ -0,0 +1,21 @@
+import { getPlatform } from "../platform";
+import { readLocalState } from "../utils/localState";
+
+export function completionCommand(shell: string): void {
+  const platform = getPlatform();
+  const shells = platform.supportedShells();
+  if (!shells.includes(shell)) {
+    console.error(`Error: unsupported shell '${shell}'. Supported: ${shells.join(", ")}`);
+    process.exit(1);
+  }
+  console.log(platform.generateCompletion(shell, getProfileDirs()));
+}
+
+function getProfileDirs(): string[] {
+  try {
+    const state = readLocalState();
+    return Object.keys(state.profile?.info_cache ?? {});
+  } catch {
+    return [];
+  }
+}

package/src/commands/launch.ts

@@ -1,6 +1,7 @@
 import { spawn } from "child_process";
 import { existsSync } from "fs";
-import { isChromeRunning } from "../utils/process";
+import { getPlatform } from "../platform";
+import { isChromeRunning, getChromePids } from "../utils/process";
 
 interface LaunchOptions {
   dir?: string;
@@ -10,7 +11,7 @@ interface LaunchOptions {
 }
 
 export function launchCommand(options: LaunchOptions): void {
-  const chromeBin = "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome";
+  const chromeBin = getPlatform().getChromeExecutablePath();
   const profile = options.profile ?? process.env.CHROME_PROFILE ?? "";
   const dataDir = options.dir ?? process.env.CHROME_DATA_DIR ?? "";
 
@@ -38,10 +39,9 @@ export function launchCommand(options: LaunchOptions): void {
   }
 
   if (isChromeRunning()) {
-    const { execSync } = require("child_process");
-    const existing = execSync('pgrep -x "Google Chrome" | tr "\\n" " " | sed "s/ $//"', { encoding: "utf-8" }).trim();
-    if (existing) {
-      console.error(`Warning: Chrome is already running (PIDs: ${existing})`);
+    const existing = getChromePids(true);
+    if (existing.length > 0) {
+      console.error(`Warning: Chrome is already running (PIDs: ${existing.join(" ")})`);
     }
   }
 

package/src/index.ts

@@ -5,6 +5,7 @@ import { killCommand } from "./commands/kill";
 import { launchCommand } from "./commands/launch";
 import { profileList, profileName, profileDelete } from "./commands/profile";
 import { cdpCommand } from "./commands/cdp";
+import { completionCommand } from "./commands/completion";
 
 const program = new Command();
 
@@ -75,4 +76,11 @@ program
     await cdpCommand(options);
   });
 
+program
+  .command("completion <shell>")
+  .description("Generate shell completion script (bash or zsh)")
+  .action((shell: string) => {
+    completionCommand(shell);
+  });
+
 program.parse();

package/src/platform/completion-helpers.ts

@@ -0,0 +1,253 @@
+export function generateBashCompletion(profileDirs: string[]): string {
+  const profileDirsNewline = profileDirs.join("\n");
+
+  return `#!/usr/bin/env bash
+_chrome_proc() {
+  local cur="\${COMP_WORDS[COMP_CWORD]}"
+  local prev="\${COMP_WORDS[COMP_CWORD-1]}"
+
+  local commands="list kill launch profile cdp completion"
+  local profile_subcommands="list name delete"
+
+  local list_opts="--verbose --json"
+  local kill_opts="--force --all"
+  local launch_opts="--dir --profile --debug --debugging-port"
+  local profile_list_opts="--json"
+  local cdp_opts="--json"
+  local completion_shells="bash zsh powershell"
+
+  local profile_dirs='
+${profileDirsNewline}
+'
+
+  local cmd=""
+  local subcmd=""
+  local i=1
+
+  while [[ $i -lt $COMP_CWORD ]]; do
+    local word="\${COMP_WORDS[$i]}"
+    if [[ "$word" != -* ]]; then
+      if [[ -z "$cmd" ]]; then
+        cmd="$word"
+      elif [[ "$cmd" == "profile" && -z "$subcmd" ]]; then
+        subcmd="$word"
+        break
+      else
+        break
+      fi
+    fi
+    ((i++))
+  done
+
+  if [[ -z "$cmd" ]]; then
+    if [[ "$cur" == -* ]]; then
+      COMPREPLY=()
+    else
+      COMPREPLY=( $(compgen -W "$commands" -- "$cur") )
+    fi
+    return
+  fi
+
+  case "$cmd" in
+    list)
+      COMPREPLY=( $(compgen -W "$list_opts" -- "$cur") )
+      ;;
+    kill)
+      COMPREPLY=( $(compgen -W "$kill_opts" -- "$cur") )
+      ;;
+    launch)
+      COMPREPLY=( $(compgen -W "$launch_opts" -- "$cur") )
+      ;;
+    cdp)
+      COMPREPLY=( $(compgen -W "$cdp_opts" -- "$cur") )
+      ;;
+    completion)
+      COMPREPLY=( $(compgen -W "$completion_shells" -- "$cur") )
+      ;;
+    profile)
+      if [[ -z "$subcmd" ]]; then
+        if [[ "$cur" == -* ]]; then
+          COMPREPLY=()
+        else
+          COMPREPLY=( $(compgen -W "$profile_subcommands" -- "$cur") )
+        fi
+      else
+        case "$subcmd" in
+          list)
+            COMPREPLY=( $(compgen -W "$profile_list_opts" -- "$cur") )
+            ;;
+          name|delete)
+            if [[ -n "$profile_dirs" && ( -z "$prev" || "$prev" == "name" || "$prev" == "delete" ) ]]; then
+              local OLD_IFS="$IFS"
+              IFS=$'\n'
+              COMPREPLY=( $(compgen -W "$profile_dirs" -- "$cur") )
+              IFS="$OLD_IFS"
+            else
+              COMPREPLY=()
+            fi
+            ;;
+          *)
+            COMPREPLY=()
+            ;;
+        esac
+      fi
+      ;;
+    *)
+      COMPREPLY=()
+      ;;
+  esac
+}
+
+complete -F _chrome_proc chrome-proc
+`;
+}
+
+export function generateZshCompletion(profileDirs: string[]): string {
+  const profileDirsNewline = profileDirs.join("\n");
+
+  return `#!/usr/bin/env zsh
+#compdef chrome-proc
+
+_chrome_proc() {
+  local curcontext="$curcontext" state line
+  typeset -A opt_args
+
+  local profile_dirs='
+${profileDirsNewline}
+'
+
+  _arguments -C \\
+    '1: :->command' \\
+    '2: :->subcommand' \\
+    '*: :->args'
+
+  case "$state" in
+    command)
+      local commands=(list kill launch profile cdp completion)
+      _describe -t commands 'chrome-proc command' commands
+      ;;
+    subcommand)
+      case "$line[1]" in
+        list)
+          local opts=('--verbose:Show full command line' '--json:Output as JSON lines')
+          _describe -t options 'list options' opts
+          ;;
+        kill)
+          local opts=('--force:Use SIGKILL instead of SIGTERM' '--all:Kill helper processes too')
+          _describe -t options 'kill options' opts
+          ;;
+        launch)
+          local opts=('--dir:Chrome user data directory' '--profile:Chrome profile name' '--debug:Enable remote debugging mode' '--debugging-port:Remote debugging port')
+          _describe -t options 'launch options' opts
+          ;;
+        cdp)
+          local opts=('--json:Output as JSON lines')
+          _describe -t options 'cdp options' opts
+          ;;
+        completion)
+          local shells=(bash zsh powershell)
+          _describe -t shells 'shell' shells
+          ;;
+        profile)
+          local subcmds=(list name delete)
+          _describe -t subcommands 'profile subcommand' subcmds
+          ;;
+      esac
+      ;;
+    args)
+      case "$line[1]" in
+        list)
+          local opts=('--verbose:Show full command line' '--json:Output as JSON lines')
+          _describe -t options 'list options' opts
+          ;;
+        kill)
+          local opts=('--force:Use SIGKILL instead of SIGTERM' '--all:Kill helper processes too')
+          _describe -t options 'kill options' opts
+          ;;
+        launch)
+          local opts=('--dir:Chrome user data directory' '--profile:Chrome profile name' '--debug:Enable remote debugging mode' '--debugging-port:Remote debugging port')
+          _describe -t options 'launch options' opts
+          ;;
+        cdp)
+          local opts=('--json:Output as JSON lines')
+          _describe -t options 'cdp options' opts
+          ;;
+        profile)
+          case "$line[2]" in
+            list)
+              local opts=('--json:Output as JSON lines')
+              _describe -t options 'profile list options' opts
+              ;;
+            name|delete)
+              if [[ -n "$profile_dirs" ]]; then
+                local dirs=(\${(f)profile_dirs})
+                _describe -t directories 'profile directory' dirs
+              fi
+              ;;
+          esac
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_chrome_proc "$@"
+`;
+}
+
+export function generatePowerShellCompletion(profileDirs: string[]): string {
+  const profileDirsQuoted = profileDirs.map((d) => `'${d.replace(/'/g, "''")}'`).join(", ");
+
+  return `Register-ArgumentCompleter -Native -CommandName chrome-proc -ScriptBlock {
+    param($wordToComplete, $commandAst, $cursorPosition)
+
+    $commands = @('list', 'kill', 'launch', 'profile', 'cdp', 'completion')
+    $profileSubcommands = @('list', 'name', 'delete')
+    $tokens = $commandAst.CommandElements | ForEach-Object { $_.Value }
+    $cmd = $tokens[1]
+    $subcmd = $tokens[2]
+
+    if (-not $cmd) {
+        $commands | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { $_ }
+        return
+    }
+
+    switch ($cmd) {
+        'list' {
+            @('--verbose', '--json') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { $_ }
+        }
+        'kill' {
+            @('--force', '--all') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { $_ }
+        }
+        'launch' {
+            @('--dir', '--profile', '--debug', '--debugging-port') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { $_ }
+        }
+        'cdp' {
+            @('--json') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { $_ }
+        }
+        'completion' {
+            @('bash', 'zsh', 'powershell') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { $_ }
+        }
+        'profile' {
+            if (-not $subcmd) {
+                $profileSubcommands | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { $_ }
+            } else {
+                switch ($subcmd) {
+                    'list' {
+                        @('--json') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { $_ }
+                    }
+                    'name' {
+                        $profileDirs = @(${profileDirsQuoted})
+                        $profileDirs | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { $_ }
+                    }
+                    'delete' {
+                        $profileDirs = @(${profileDirsQuoted})
+                        $profileDirs | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { $_ }
+                    }
+                }
+            }
+        }
+    }
+}
+`;
+}