chrome-cdp-manager 1.2.6 → 1.2.8

package/README.md

@@ -140,8 +140,9 @@ playwright-cli click "Sign in"
 playwright-cli --help
 ```
 
-Requires the optional `playwright` peer dependency (`npm i playwright`). The
-endpoint port follows your saved config (`~/.config/chrome-cdp-manager/config.json`).
+The Playwright CLI ships via `playwright-core` (a dependency of this package, so
+it works out of the box — no browser download). The endpoint port follows your
+saved config (`~/.config/chrome-cdp-manager/config.json`).
 
 ## Common options
 

package/bin/playwright-cli.js

@@ -59,10 +59,12 @@ async function main() {
   let program;
   try {
     ({ program } = require("playwright-core/lib/tools/cli-client/program"));
-  } catch {
+  } catch (error) {
     throw new Error(
-      "Playwright not found. The `playwright-cli` command needs Playwright " +
-        "installed:\n  npm i playwright",
+      "Could not load the Playwright CLI from playwright-core " +
+        "(a dependency of this package). Try reinstalling:\n" +
+        "  npm install -g chrome-cdp-manager\n" +
+        `Original error: ${error.message}`,
     );
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-cdp-manager",
-  "version": "1.2.6",
+  "version": "1.2.8",
   "description": "Set up and drive a Chrome DevTools Protocol (CDP) instance on macOS or Windows through a dedicated launcher (consistent Dock/taskbar icon). Works with any Chromium-based browser — Chrome, Edge, Brave, Chromium, Vivaldi, Opera, Arc.",
   "type": "module",
   "main": "./src/index.js",
@@ -59,7 +59,8 @@
   "license": "MIT",
   "dependencies": {
     "cheerio": "^1.2.0",
-    "commander": "^12.1.0"
+    "commander": "^12.1.0",
+    "playwright-core": "^1.61.0"
   },
   "peerDependencies": {
     "playwright": ">=1.40.0"

package/src/index.js

@@ -10,11 +10,20 @@
 import { loadConfig } from "./config.js";
 import { getLauncher } from "./launcher.js";
 import { ensureBrowserRunning } from "./browser.js";
+import { parseProxy } from "./proxy.js";
 
 export { CdpClient, openUrl, getPageHtml, closeBrowser } from "./cdp.js";
 export { loadConfig, computeDefaults, DEFAULTS } from "./config.js";
 export { getLauncher } from "./launcher.js";
 export { ensureBrowserRunning, probeCdp, waitForCdp } from "./browser.js";
+export {
+  parseProxy,
+  detectProxy,
+  DEFAULT_PROXY,
+  DEFAULT_PROXY_HOST,
+  DEFAULT_PROXY_PORT,
+  DEFAULT_PROXY_SCHEME,
+} from "./proxy.js";
 
 // Values the launcher bakes in at creation time; overriding them only takes
 // effect if the launcher is (re)created to match.
@@ -27,6 +36,12 @@ const BAKED_KEYS = ["cdpPort", "profileDir", "browserPath"];
  * @param {boolean} [opts.headless=false]
  * @param {number}  [opts.timeoutMs=30000] startup timeout in milliseconds.
  * @param {boolean} [opts.force=false] rewrite the launcher even if it exists.
+ * @param {boolean|string} [opts.proxy] route browser traffic through a proxy.
+ *                  `true` / "default" → the default SOCKS5 proxy
+ *                  (socks5://127.0.0.1:1080); a port ("1080"), "host:port", or
+ *                  full "scheme://host:port" is normalised via {@link parseProxy};
+ *                  `false` forces a direct connection. Applies on a fresh launch
+ *                  only — an already-running compatible browser is reused as-is.
  * @param {object}  [opts.config] overrides merged over the persisted config
  *                  (e.g. `{ cdpPort, profileDir, browserPath }`). If these
  *                  differ from your saved `setup`, the launcher is rewritten so
@@ -34,9 +49,20 @@ const BAKED_KEYS = ["cdpPort", "profileDir", "browserPath"];
  *                  silently ignored).
  * @returns {Promise<{ config: object, endpoint: string, launched: boolean, version: object }>}
  */
-export async function launch({ headless = false, timeoutMs = 30_000, force = false, config: overrides } = {}) {
+export async function launch({
+  headless = false,
+  timeoutMs = 30_000,
+  force = false,
+  proxy,
+  config: overrides,
+} = {}) {
   const persisted = loadConfig();
   const config = { ...persisted, ...overrides };
+  // Per-launch proxy: true/string enables it (normalised to a --proxy-server
+  // value), false forces a direct connection. Never persisted.
+  if (proxy !== undefined) {
+    config.proxy = proxy === false ? null : parseProxy(proxy).server;
+  }
   const launcher = getLauncher();
 
   // If a caller overrode a baked value, the existing launcher would still use

package/types/index.d.ts

@@ -5,6 +5,12 @@
  * @param {boolean} [opts.headless=false]
  * @param {number}  [opts.timeoutMs=30000] startup timeout in milliseconds.
  * @param {boolean} [opts.force=false] rewrite the launcher even if it exists.
+ * @param {boolean|string} [opts.proxy] route browser traffic through a proxy.
+ *                  `true` / "default" → the default SOCKS5 proxy
+ *                  (socks5://127.0.0.1:1080); a port ("1080"), "host:port", or
+ *                  full "scheme://host:port" is normalised via {@link parseProxy};
+ *                  `false` forces a direct connection. Applies on a fresh launch
+ *                  only — an already-running compatible browser is reused as-is.
  * @param {object}  [opts.config] overrides merged over the persisted config
  *                  (e.g. `{ cdpPort, profileDir, browserPath }`). If these
  *                  differ from your saved `setup`, the launcher is rewritten so
@@ -12,10 +18,11 @@
  *                  silently ignored).
  * @returns {Promise<{ config: object, endpoint: string, launched: boolean, version: object }>}
  */
-export function launch({ headless, timeoutMs, force, config: overrides }?: {
+export function launch({ headless, timeoutMs, force, proxy, config: overrides, }?: {
     headless?: boolean;
     timeoutMs?: number;
     force?: boolean;
+    proxy?: boolean | string;
     config?: object;
 }): Promise<{
     config: object;
@@ -27,3 +34,4 @@ export { getLauncher } from "./launcher.js";
 export { CdpClient, openUrl, getPageHtml, closeBrowser } from "./cdp.js";
 export { loadConfig, computeDefaults, DEFAULTS } from "./config.js";
 export { ensureBrowserRunning, probeCdp, waitForCdp } from "./browser.js";
+export { parseProxy, detectProxy, DEFAULT_PROXY, DEFAULT_PROXY_HOST, DEFAULT_PROXY_PORT, DEFAULT_PROXY_SCHEME } from "./proxy.js";