chrome-cdp-manager 1.2.7 → 1.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-cdp-manager",
-  "version": "1.2.7",
+  "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",

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";