@xbrowser/cli 1.14.0 → 1.16.0

package/dist/cli.js

@@ -26,6 +26,16 @@ import {
 import {
   buildViewerUrl
 } from "./chunk-3OD76SUE.js";
+import {
+  NPM_REGISTRY_URL,
+  NPM_SCOPE,
+  getConfigValue,
+  getMarketplaceUrl,
+  loadConfig,
+  resolveNpmPackageWithFallback,
+  resolveScreenshotsDir,
+  setConfigValue
+} from "./chunk-ZTHE5RBZ.js";
 import {
   getDaemonConfig,
   getDaemonProcessStatus,
@@ -56,10 +66,13 @@ import {
   getAllSessions,
   getBrowser,
   getSessionById,
+  rand,
   resolveLaunchOpts,
   saveSessionDiskMeta,
-  setActivePage
-} from "./chunk-BTFKJD7Z.js";
+  setActivePage,
+  sleep,
+  wheelDelta
+} from "./chunk-5EYOEB4R.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -68,16 +81,6 @@ import {
   detectAntiBot,
   formatDetectionMessage
 } from "./chunk-JKVUFP3G.js";
-import {
-  NPM_REGISTRY_URL,
-  NPM_SCOPE,
-  getConfigValue,
-  getMarketplaceUrl,
-  loadConfig,
-  resolveNpmPackageWithFallback,
-  resolveScreenshotsDir,
-  setConfigValue
-} from "./chunk-ZTHE5RBZ.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/router.ts
@@ -352,7 +355,8 @@ var gotoCommand = registerCommand({
   parameters: z.object({
     url: z.string(),
     waitUntil: z.enum(["load", "domcontentloaded", "networkidle", "commit"]).optional(),
-    timeout: z.number().optional()
+    timeout: z.number().optional(),
+    referrer: z.string().optional()
   }),
   result: z.object({
     url: z.string(),
@@ -373,7 +377,9 @@ var gotoCommand = registerCommand({
     try {
       response = await ctx.page.goto(url, {
         waitUntil: p.waitUntil || "domcontentloaded",
-        ...p.timeout ? { timeout: p.timeout } : {}
+        ...p.timeout ? { timeout: p.timeout } : {},
+        // referrer（d54）：模拟从源页面点链接进入 —— document.referrer 非空
+        ...p.referrer ? { referer: p.referrer } : {}
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -900,21 +906,34 @@ var scrollCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     const distance = p.distance ?? 500;
-    const deltas = {
-      down: [0, distance],
-      up: [0, -distance],
-      right: [distance, 0],
-      left: [-distance, 0]
-    };
-    const [dx, dy] = deltas[p.direction];
+    const sign = { down: 1, up: -1, right: 1, left: -1 };
+    const vertical = p.direction === "down" || p.direction === "up";
+    const s = sign[p.direction];
     if (p.selector) {
       const element = ctx.page.locator(p.selector).first();
       await element.evaluate((el, args) => {
         const [dxx, dyy] = args;
         el.scrollBy(dxx, dyy);
-      }, [dx, dy]);
+      }, [vertical ? 0 : distance * s, vertical ? distance * s : 0]);
+    } else if (process.env.XBROWSER_STEALTH !== "off") {
+      let acc = 0;
+      let step = 0;
+      while (acc < distance && step < 60) {
+        const d = Math.min(wheelDelta(step), distance - acc);
+        if (d < 1) break;
+        await ctx.page.mouse.wheel(
+          vertical ? 0 : d * s,
+          vertical ? d * s : 0
+        );
+        acc += d;
+        step++;
+        await sleep(rand(16, 28));
+      }
     } else {
-      await ctx.page.mouse.wheel(dx, dy);
+      await ctx.page.mouse.wheel(
+        vertical ? 0 : distance * s,
+        vertical ? distance * s : 0
+      );
     }
     return ok5({ direction: p.direction, distance });
   }
@@ -7523,7 +7542,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-DI6UQN6Q.js");
+    const { findTargetPage } = await import("./browser-KT4FOWBO.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -7737,7 +7756,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
     const errorMessage = errMsg(err);
     if (session?.page && process.env.XBROWSER_RECOVERY && !extraOpts?._recoveryAttempted) {
       try {
-        const { attemptRecovery } = await import("./recovery-FTZGV6VY.js");
+        const { attemptRecovery } = await import("./recovery-NXC35EQN.js");
         const recovery = await attemptRecovery(
           session.page,
           sessionName,
@@ -7803,6 +7822,9 @@ async function executeChain(input, options) {
     for (const pipeline of pipelines) {
       const { type, pipeline: commands } = pipeline;
       for (const cmdStr of commands) {
+        if (process.env.XBROWSER_CHAIN_PACE === "human" && results.length > 0) {
+          await new Promise((r) => setTimeout(r, 800 + Math.random() * 1700));
+        }
         const parts = splitCommand(cmdStr);
         if (parts.length === 0) continue;
         const cmdName = parts[0];
@@ -10173,12 +10195,33 @@ function normalizeSelector(input) {
 
 // src/cli/browser-routes.ts
 import { helpGenerator } from "@dyyz1993/xcli-core";
+function autoCompleteParams(cmdName, params, options) {
+  try {
+    const cmd = getCommand(cmdName);
+    if (!cmd?.parameters) return params;
+    const schema = asZodSchema(cmd.parameters);
+    const shape = schema?.shape ?? schema?._def?.shape;
+    if (!shape) return params;
+    for (const key of Object.keys(shape)) {
+      if (params[key] !== void 0) continue;
+      const v = options[key];
+      if (v === void 0 || v === true && key === "json" || key === "yaml") continue;
+      if (typeof v === "string" && v === "") continue;
+      params[key] = v;
+    }
+    return params;
+  } catch {
+    return params;
+  }
+}
 function parseSelectorFlags(args, options) {
-  const selector = options.s || options.selector || options["selector"];
-  const value = options.v || options.value;
+  const rawSelector = options.s ?? options.selector;
+  const rawValue = options.v ?? options.value;
+  const selector = typeof rawSelector === "string" ? normalizeSelector(rawSelector) : void 0;
+  const value = typeof rawValue === "string" ? rawValue : void 0;
   const remaining = args.filter((a) => !a.startsWith("-"));
   return {
-    selector: selector ? normalizeSelector(selector) : void 0,
+    selector,
     value,
     remaining
   };
@@ -10266,7 +10309,11 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
         if (!sel || !txt)
           outputError("Usage: xbrowser type <selector> <text>\n       xbrowser type -s <selector> -v <text>");
         cmdName = "type";
-        params = { selector: sel, text: txt };
+        params = {
+          selector: sel,
+          text: txt,
+          ...options.delay !== void 0 ? { delay: Number(options.delay) } : {}
+        };
         break;
       }
       case "press": {
@@ -10408,7 +10455,13 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
           outputError("Usage: xbrowser mouse <move|click|dblclick> <x> <y>\n       xbrowser mouse --action <action> --x <x> --y <y>");
         }
         cmdName = "mouse";
-        params = { action, x, y, ...options.button ? { button: options.button } : {} };
+        params = {
+          action,
+          x,
+          y,
+          ...options.button ? { button: options.button } : {},
+          ...options.steps !== void 0 ? { steps: Number(options.steps) } : {}
+        };
         break;
       }
       case "html":
@@ -10610,6 +10663,7 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
   if (target) {
     params = { ...params, _target: target };
   }
+  params = autoCompleteParams(cmdName, params, options);
   const tabIndex = options.tab;
   if (tabIndex !== void 0) {
     params = { ...params, _tabIndex: Number(tabIndex) };
@@ -13663,7 +13717,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage: setActivePage2 } = await import("./browser-DI6UQN6Q.js");
+              const { setActivePage: setActivePage2 } = await import("./browser-KT4FOWBO.js");
               setActivePage2(session, targetPage);
             }
           }
@@ -13939,7 +13993,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-DI6UQN6Q.js");
+      const { ensureProcessCanExit } = await import("./browser-KT4FOWBO.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(process.exitCode || exitCode);

package/dist/clipboard-BOL2GP2E.js

@@ -0,0 +1,58 @@
+import "./chunk-KFQGP6VL.js";
+
+// src/utils/clipboard.ts
+import { exec, execSync } from "child_process";
+function writeClipboard(text) {
+  const plat = process.platform;
+  if (plat === "darwin") {
+    const p = exec("pbcopy");
+    if (!p.stdin) throw new Error("pbcopy stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("sleep 0.05");
+  } else if (plat === "linux") {
+    execSync("command -v xclip >/dev/null 2>&1 && echo ok", { stdio: "ignore" });
+    const p = exec("xclip -selection clipboard -in");
+    if (!p.stdin) throw new Error("xclip stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("sleep 0.05");
+  } else if (plat === "win32") {
+    const p = exec("clip");
+    if (!p.stdin) throw new Error("clip stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("timeout /t 1 /nobreak >nul");
+  } else {
+    throw new Error(`Unsupported platform for clipboard: ${plat}`);
+  }
+}
+async function pasteViaClipboard(page, text) {
+  writeClipboard(text);
+  const kb = page.keyboard;
+  const mod = process.platform === "darwin" ? "Meta" : "Control";
+  await kb.pressCombo("v", mod);
+  await new Promise((r) => setTimeout(r, 150));
+}
+async function syntheticPaste(page, selector, text) {
+  const result = await page.evaluate(`
+    (function() {
+      const el = ${"{SELECTOR}"};
+      if (!el) return false;
+      el.focus();
+      if (el.value) { el.select(); document.execCommand('delete'); }
+      try {
+        const dt = new DataTransfer();
+        dt.setData('text/plain', ${JSON.stringify(text)});
+        el.dispatchEvent(new ClipboardEvent('paste', { clipboardData: dt, bubbles: true, cancelable: true }));
+      } catch (e) { /* ClipboardEvent ctor guard */ }
+      const ok = document.execCommand('insertText', false, ${JSON.stringify(text)});
+      return ok === true && (el.value || '') === ${JSON.stringify(text)};
+    })()
+  `.replace("{SELECTOR}", selector));
+  return result === true;
+}
+export {
+  pasteViaClipboard,
+  syntheticPaste
+};

package/dist/clipboard-XRP54ENE.js

@@ -0,0 +1,58 @@
+import "./chunk-3RG5ZIWI.js";
+
+// src/utils/clipboard.ts
+import { exec, execSync } from "child_process";
+function writeClipboard(text) {
+  const plat = process.platform;
+  if (plat === "darwin") {
+    const p = exec("pbcopy");
+    if (!p.stdin) throw new Error("pbcopy stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("sleep 0.05");
+  } else if (plat === "linux") {
+    execSync("command -v xclip >/dev/null 2>&1 && echo ok", { stdio: "ignore" });
+    const p = exec("xclip -selection clipboard -in");
+    if (!p.stdin) throw new Error("xclip stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("sleep 0.05");
+  } else if (plat === "win32") {
+    const p = exec("clip");
+    if (!p.stdin) throw new Error("clip stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("timeout /t 1 /nobreak >nul");
+  } else {
+    throw new Error(`Unsupported platform for clipboard: ${plat}`);
+  }
+}
+async function pasteViaClipboard(page, text) {
+  writeClipboard(text);
+  const kb = page.keyboard;
+  const mod = process.platform === "darwin" ? "Meta" : "Control";
+  await kb.pressCombo("v", mod);
+  await new Promise((r) => setTimeout(r, 150));
+}
+async function syntheticPaste(page, selector, text) {
+  const result = await page.evaluate(`
+    (function() {
+      const el = ${"{SELECTOR}"};
+      if (!el) return false;
+      el.focus();
+      if (el.value) { el.select(); document.execCommand('delete'); }
+      try {
+        const dt = new DataTransfer();
+        dt.setData('text/plain', ${JSON.stringify(text)});
+        el.dispatchEvent(new ClipboardEvent('paste', { clipboardData: dt, bubbles: true, cancelable: true }));
+      } catch (e) { /* ClipboardEvent ctor guard */ }
+      const ok = document.execCommand('insertText', false, ${JSON.stringify(text)});
+      return ok === true && (el.value || '') === ${JSON.stringify(text)};
+    })()
+  `.replace("{SELECTOR}", selector));
+  return result === true;
+}
+export {
+  pasteViaClipboard,
+  syntheticPaste
+};

package/dist/daemon-main.js

@@ -7,6 +7,10 @@ import {
 import {
   buildViewerUrl
 } from "./chunk-TZPKFUBT.js";
+import {
+  ScreencastCapturer,
+  resolveScreenshotsDir
+} from "./chunk-HBMEFSTB.js";
 import "./chunk-CG3D3CHY.js";
 import {
   commandLogStore,
@@ -30,10 +34,13 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-ZD4OSYOX.js";
+} from "./chunk-GWQ5NTVE.js";
 import {
-  createRuleEngine
-} from "./chunk-UPAWITVM.js";
+  createRuleEngine,
+  rand,
+  sleep,
+  wheelDelta
+} from "./chunk-LTBNQERK.js";
 import {
   queryJS
 } from "./chunk-3FWLW7FS.js";
@@ -45,10 +52,6 @@ import {
   detectAntiBot,
   formatDetectionMessage
 } from "./chunk-JKVUFP3G.js";
-import {
-  ScreencastCapturer,
-  resolveScreenshotsDir
-} from "./chunk-HBMEFSTB.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/daemon/daemon-main.ts
@@ -312,7 +315,8 @@ var gotoCommand = registerCommand({
   parameters: z.object({
     url: z.string(),
     waitUntil: z.enum(["load", "domcontentloaded", "networkidle", "commit"]).optional(),
-    timeout: z.number().optional()
+    timeout: z.number().optional(),
+    referrer: z.string().optional()
   }),
   result: z.object({
     url: z.string(),
@@ -333,7 +337,9 @@ var gotoCommand = registerCommand({
     try {
       response = await ctx.page.goto(url, {
         waitUntil: p.waitUntil || "domcontentloaded",
-        ...p.timeout ? { timeout: p.timeout } : {}
+        ...p.timeout ? { timeout: p.timeout } : {},
+        // referrer（d54）：模拟从源页面点链接进入 —— document.referrer 非空
+        ...p.referrer ? { referer: p.referrer } : {}
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -860,21 +866,34 @@ var scrollCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     const distance = p.distance ?? 500;
-    const deltas = {
-      down: [0, distance],
-      up: [0, -distance],
-      right: [distance, 0],
-      left: [-distance, 0]
-    };
-    const [dx, dy] = deltas[p.direction];
+    const sign = { down: 1, up: -1, right: 1, left: -1 };
+    const vertical = p.direction === "down" || p.direction === "up";
+    const s = sign[p.direction];
     if (p.selector) {
       const element = ctx.page.locator(p.selector).first();
       await element.evaluate((el, args) => {
         const [dxx, dyy] = args;
         el.scrollBy(dxx, dyy);
-      }, [dx, dy]);
+      }, [vertical ? 0 : distance * s, vertical ? distance * s : 0]);
+    } else if (process.env.XBROWSER_STEALTH !== "off") {
+      let acc = 0;
+      let step = 0;
+      while (acc < distance && step < 60) {
+        const d = Math.min(wheelDelta(step), distance - acc);
+        if (d < 1) break;
+        await ctx.page.mouse.wheel(
+          vertical ? 0 : d * s,
+          vertical ? d * s : 0
+        );
+        acc += d;
+        step++;
+        await sleep(rand(16, 28));
+      }
     } else {
-      await ctx.page.mouse.wheel(dx, dy);
+      await ctx.page.mouse.wheel(
+        vertical ? 0 : distance * s,
+        vertical ? distance * s : 0
+      );
     }
     return ok5({ direction: p.direction, distance });
   }
@@ -7041,7 +7060,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-5A6AL62M.js");
+    const { findTargetPage } = await import("./browser-AOVQTGJ7.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -7255,7 +7274,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
     const errorMessage = errMsg(err);
     if (session?.page && process.env.XBROWSER_RECOVERY && !extraOpts?._recoveryAttempted) {
       try {
-        const { attemptRecovery } = await import("./recovery-Z3RDZENA.js");
+        const { attemptRecovery } = await import("./recovery-MDWAVXE4.js");
         const recovery = await attemptRecovery(
           session.page,
           sessionName,
@@ -7321,6 +7340,9 @@ async function executeChain(input, options) {
     for (const pipeline of pipelines) {
       const { type, pipeline: commands } = pipeline;
       for (const cmdStr of commands) {
+        if (process.env.XBROWSER_CHAIN_PACE === "human" && results.length > 0) {
+          await new Promise((r) => setTimeout(r, 800 + Math.random() * 1700));
+        }
         const parts = splitCommand(cmdStr);
         if (parts.length === 0) continue;
         const cmdName = parts[0];
@@ -8292,7 +8314,7 @@ function createRPCHandler() {
       return result;
     } catch (err) {
       const errorMessage = errMsg(err);
-      const { attemptRecovery } = await import("./recovery-Z3RDZENA.js");
+      const { attemptRecovery } = await import("./recovery-MDWAVXE4.js");
       const recovery = await attemptRecovery(
         session?.page,
         sessionName,
@@ -8857,7 +8879,7 @@ function createRPCHandler() {
     if (isNewFormat) {
       try {
         const replayErrors = [];
-        const { SessionReplayer } = await import("./session-replayer-I3PJFO3H.js");
+        const { SessionReplayer } = await import("./session-replayer-MJH5W7BB.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,

package/dist/index.d.ts

@@ -316,6 +316,10 @@ interface XBKeyboard {
     press(key: string, opts?: {
         delay?: number;
     }): Promise<void>;
+    /** Navigation key with CDP 'keyDown' type (carries browser default actions) */
+    pressNav(key: string): Promise<void>;
+    /** Shortcut combo (modifier+key) with explicit per-event modifiers bitmask */
+    pressCombo(key: string, modifier: 'Meta' | 'Control' | 'Alt' | 'Shift'): Promise<void>;
     down(key: string): Promise<void>;
     up(key: string): Promise<void>;
     type(text: string, opts?: {