@xbrowser/cli 1.0.0 → 1.0.3

package/dist/{cdp-driver-MNPR3HZH.js → cdp-driver-4X3DK6PS.js}

@@ -1,10 +1,11 @@
 import {
   connectToCDP,
+  errMsg,
   findChrome,
   getCDPTargets,
   killChrome,
   launchChrome
-} from "./chunk-T4J4C2NZ.js";
+} from "./chunk-AMI64BSD.js";
 import {
   __require
 } from "./chunk-3RG5ZIWI.js";
@@ -247,36 +248,36 @@ function resolveKeyMapping(key) {
   return { key, code: key };
 }
 var KEY_MAP = {
-  Enter: { key: "Enter", code: "Enter", text: "\r" },
-  Tab: { key: "Tab", code: "Tab", text: "	" },
-  Escape: { key: "Escape", code: "Escape" },
-  Backspace: { key: "Backspace", code: "Backspace" },
-  Delete: { key: "Delete", code: "Delete" },
-  Space: { key: " ", code: "Space", text: " " },
-  ArrowUp: { key: "ArrowUp", code: "ArrowUp" },
-  ArrowDown: { key: "ArrowDown", code: "ArrowDown" },
-  ArrowLeft: { key: "ArrowLeft", code: "ArrowLeft" },
-  ArrowRight: { key: "ArrowRight", code: "ArrowRight" },
-  Home: { key: "Home", code: "Home" },
-  End: { key: "End", code: "End" },
-  PageUp: { key: "PageUp", code: "PageUp" },
-  PageDown: { key: "PageDown", code: "PageDown" },
-  Control: { key: "Control", code: "ControlLeft" },
-  Shift: { key: "Shift", code: "ShiftLeft" },
-  Alt: { key: "Alt", code: "AltLeft" },
-  Meta: { key: "Meta", code: "MetaLeft" },
-  F1: { key: "F1", code: "F1" },
-  F2: { key: "F2", code: "F2" },
-  F3: { key: "F3", code: "F3" },
-  F4: { key: "F4", code: "F4" },
-  F5: { key: "F5", code: "F5" },
-  F6: { key: "F6", code: "F6" },
-  F7: { key: "F7", code: "F7" },
-  F8: { key: "F8", code: "F8" },
-  F9: { key: "F9", code: "F9" },
-  F10: { key: "F10", code: "F10" },
-  F11: { key: "F11", code: "F11" },
-  F12: { key: "F12", code: "F12" }
+  Enter: { key: "Enter", code: "Enter", text: "\r", keyCode: 13 },
+  Tab: { key: "Tab", code: "Tab", text: "	", keyCode: 9 },
+  Escape: { key: "Escape", code: "Escape", keyCode: 27 },
+  Backspace: { key: "Backspace", code: "Backspace", keyCode: 8 },
+  Delete: { key: "Delete", code: "Delete", keyCode: 46 },
+  Space: { key: " ", code: "Space", text: " ", keyCode: 32 },
+  ArrowUp: { key: "ArrowUp", code: "ArrowUp", keyCode: 38 },
+  ArrowDown: { key: "ArrowDown", code: "ArrowDown", keyCode: 40 },
+  ArrowLeft: { key: "ArrowLeft", code: "ArrowLeft", keyCode: 37 },
+  ArrowRight: { key: "ArrowRight", code: "ArrowRight", keyCode: 39 },
+  Home: { key: "Home", code: "Home", keyCode: 36 },
+  End: { key: "End", code: "End", keyCode: 35 },
+  PageUp: { key: "PageUp", code: "PageUp", keyCode: 33 },
+  PageDown: { key: "PageDown", code: "PageDown", keyCode: 34 },
+  Control: { key: "Control", code: "ControlLeft", keyCode: 17 },
+  Shift: { key: "Shift", code: "ShiftLeft", keyCode: 16 },
+  Alt: { key: "Alt", code: "AltLeft", keyCode: 18 },
+  Meta: { key: "Meta", code: "MetaLeft", keyCode: 91 },
+  F1: { key: "F1", code: "F1", keyCode: 112 },
+  F2: { key: "F2", code: "F2", keyCode: 113 },
+  F3: { key: "F3", code: "F3", keyCode: 114 },
+  F4: { key: "F4", code: "F4", keyCode: 115 },
+  F5: { key: "F5", code: "F5", keyCode: 116 },
+  F6: { key: "F6", code: "F6", keyCode: 117 },
+  F7: { key: "F7", code: "F7", keyCode: 118 },
+  F8: { key: "F8", code: "F8", keyCode: 119 },
+  F9: { key: "F9", code: "F9", keyCode: 120 },
+  F10: { key: "F10", code: "F10", keyCode: 121 },
+  F11: { key: "F11", code: "F11", keyCode: 122 },
+  F12: { key: "F12", code: "F12", keyCode: 123 }
 };
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -971,7 +972,7 @@ function createXBRequest(page, data) {
     }
   };
 }
-function createXBRouteFetch(conn, sessionId, params) {
+function createXBRouteFetch(conn, sessionId, params, emitter) {
   const request = createXBRequest(null, {
     requestId: params.requestId,
     url: params.request.url,
@@ -1009,6 +1010,16 @@ function createXBRouteFetch(conn, sessionId, params) {
         responseHeaders: Object.entries(headers).map(([k, v]) => ({ name: k, value: v })),
         body: bodyBytes.toString("base64")
       }, sessionId);
+      if (emitter) {
+        const responseData = {
+          requestId: params.requestId,
+          status: opts.status ?? 200,
+          url: params.request.url,
+          headers
+        };
+        const response = createXBResponse(responseData, conn, sessionId);
+        emitter.emit("response", response);
+      }
     }
   };
 }
@@ -1190,7 +1201,7 @@ var XBPageImpl = class _XBPageImpl {
         );
         if (result) return result;
       } catch (err) {
-        lastError = err;
+        lastError = err instanceof Error ? err : new Error(errMsg(err));
       }
       const pollMs = typeof polling === "number" ? polling : 16;
       await this.waitForTimeout(pollMs);
@@ -1230,6 +1241,25 @@ Last error: ${lastError.message}` : "";
     }
     return result.result?.value;
   }
+  /** evaluateHandle — evaluates fn and returns a handle for element bounding box */
+  async evaluateHandle(fn, ...args) {
+    let expression;
+    if (typeof fn === "string") {
+      expression = fn;
+    } else {
+      const argStr = args.length > 0 ? `...${JSON.stringify(args)}` : "";
+      expression = `(()=>{const __fn=(${fn.toString()});const __el=__fn(${argStr});if(__el&&typeof __el.getBoundingClientRect==='function'){const r=__el.getBoundingClientRect();return JSON.parse(JSON.stringify({x:r.x,y:r.y,w:r.width,h:r.height}));}return null;})()`;
+    }
+    const result = await this.conn.send("Runtime.evaluate", { expression, returnByValue: true }).catch(() => ({ result: { value: null } }));
+    let box = null;
+    try {
+      box = JSON.parse(result.result?.value);
+    } catch {
+    }
+    return {
+      asElement: () => box ? { boundingBox: async () => box } : null
+    };
+  }
   async $eval(selector, fn, ...args) {
     const fnBody = typeof fn === "function" ? fn.toString() : fn;
     return this.evaluate(
@@ -1445,6 +1475,26 @@ Last error: ${lastError.message}` : "";
   off(event, handler) {
     this._emitter.off(event, handler);
   }
+  /**
+   * Wait for a one-shot event (Playwright-compatible subset).
+   * Used to listen for 'filechooser', 'dialog', 'popup', 'framenavigated', etc.
+   */
+  async waitForEvent(event, opts = {}) {
+    const timeout = opts.timeout ?? 3e4;
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this._emitter.off(event, handler);
+        reject(new Error(`waitForEvent('${event}') timeout after ${timeout}ms`));
+      }, timeout);
+      const handler = (...args) => {
+        if (opts.predicate && !opts.predicate(...args)) return;
+        clearTimeout(timer);
+        this._emitter.off(event, handler);
+        resolve(args.length === 1 ? args[0] : args);
+      };
+      this._emitter.on(event, handler);
+    });
+  }
   // ── Lifecycle ───────────────────────────────────────────────
   async close() {
     if (this._closed) return;
@@ -1561,6 +1611,19 @@ Last error: ${lastError.message}` : "";
   async _cdpSend(method, params) {
     return this.conn.send(method, params, this.sessionId);
   }
+  /**
+   * 开启/关闭原生文件选择框拦截（CDP stateful 开关）。
+   *
+   * - enabled=true（执行期默认）：点击上传按钮时不弹系统文件框，改发 Page.fileChooserOpened 事件，
+   *   page 的 'filechooser' 监听器拿到 chooser 后用 setFiles/setInputFiles 注入文件。
+   * - enabled=false（录制期默认）：真实文件选择框正常弹出，用户手动选文件；
+   *   前端 input[type=file] 的 change 事件由 action signal 脚本捕获记录。
+   *
+   * 可多次调用切换状态（CDP 协议是 stateful 的）。
+   */
+  async setFileDialogInterception(enabled) {
+    await this.conn.send("Page.setInterceptFileChooserDialog", { enabled }, this.sessionId).catch((e) => console.error("[XBPage] setInterceptFileChooserDialog failed:", errMsg(e)));
+  }
   /** Subscribe to a CDP event on this page's session. Returns unsubscribe function. */
   _subscribe(event, handler) {
     return this.conn.subscribe(event, this.sessionId, handler);
@@ -1608,6 +1671,40 @@ Last error: ${lastError.message}` : "";
         this._emit("dialog", dialog);
       })
     );
+    this._subscriptions.push(
+      this.conn.subscribe("Page.fileChooserOpened", this.sessionId, async (params) => {
+        const p = params;
+        let selector = "";
+        try {
+          const result = await this.conn.send("DOM.describeNode", { backendNodeId: p.backendNodeId }, this.sessionId);
+          const attrs = result.node?.attributes || [];
+          const idIdx = attrs.indexOf("id");
+          if (idIdx >= 0) selector = "#" + attrs[idIdx + 1];
+        } catch {
+        }
+        if (!selector) {
+          try {
+            const result = await this.conn.send("DOM.resolveNode", { backendNodeId: p.backendNodeId }, this.sessionId);
+            const evalResult = await this.conn.send("Runtime.callFunctionOn", {
+              objectId: result.objectId,
+              functionDeclaration: 'function() { return this.id || this.name || "" }',
+              returnByValue: true
+            }, this.sessionId);
+            if (evalResult.result?.value) selector = "#" + evalResult.result.value;
+          } catch {
+          }
+        }
+        const fileChooser = {
+          selector,
+          isMultiple: p.mode === "selectMultiple",
+          setFiles: async (files) => {
+            const fileArray = Array.isArray(files) ? files : [files];
+            await this.setInputFiles(selector || 'input[type="file"]', fileArray);
+          }
+        };
+        this._emit("filechooser", fileChooser);
+      })
+    );
   }
   setupNetworkEvents() {
     this._subscriptions.push(
@@ -1621,7 +1718,17 @@ Last error: ${lastError.message}` : "";
           postData: p.request.postData ?? null,
           resourceType: p.type
         });
-        this._emit("request", p);
+        this._emit("request", createXBRequest(
+          null,
+          {
+            requestId: p.requestId,
+            url: p.request.url,
+            method: p.request.method,
+            headers: p.request.headers,
+            postData: p.request.postData ?? null,
+            resourceType: p.type
+          }
+        ));
         this.checkNetworkIdle();
       })
     );
@@ -1633,7 +1740,11 @@ Last error: ${lastError.message}` : "";
           url: p.response.url,
           headers: p.response.headers
         });
-        this._emit("response", p);
+        this._emit("response", createXBResponse(
+          { requestId: p.requestId, status: p.response.status, url: p.response.url, headers: p.response.headers },
+          this.conn,
+          this.sessionId
+        ));
       })
     );
     this._subscriptions.push(
@@ -1719,14 +1830,21 @@ Last error: ${lastError.message}` : "";
         reject(new Error(`waitForResponse timed out after ${timeout}ms`));
       }, timeout);
       const handler = (params) => {
-        const p = params;
-        const data = {
-          requestId: p.requestId,
-          status: p.response.status,
-          url: p.response.url,
-          headers: p.response.headers
-        };
-        const response = createXBResponse(data, this.conn, this.sessionId);
+        let response;
+        const respObj = params;
+        if (respObj.response) {
+          const data = {
+            requestId: respObj.requestId || "",
+            status: respObj.response.status || 0,
+            url: respObj.response.url || "",
+            headers: respObj.response.headers || {}
+          };
+          response = createXBResponse(data, this.conn, this.sessionId);
+        } else if (typeof params.status === "function") {
+          response = params;
+        } else {
+          return;
+        }
         if (predicate(response)) {
           clearTimeout(timer);
           this._emitter.removeListener("response", handler);
@@ -1750,16 +1868,22 @@ Last error: ${lastError.message}` : "";
         reject(new Error(`waitForRequest timed out after ${timeout}ms`));
       }, timeout);
       const handler = (params) => {
-        const p = params;
-        const data = {
-          requestId: p.requestId,
-          url: p.request.url,
-          method: p.request.method,
-          headers: p.request.headers,
-          postData: p.request.postData ?? null,
-          resourceType: p.type
-        };
-        const request = createXBRequest(this, data);
+        let request;
+        const reqObj = params;
+        if (reqObj.request) {
+          request = createXBRequest(this, {
+            requestId: reqObj.requestId || "",
+            url: reqObj.request.url || "",
+            method: reqObj.request.method || "",
+            headers: reqObj.request.headers || {},
+            postData: reqObj.request.postData ?? null,
+            resourceType: reqObj.type || ""
+          });
+        } else if (typeof params.url === "function") {
+          request = params;
+        } else {
+          return;
+        }
         if (predicate(request)) {
           clearTimeout(timer);
           this._emitter.removeListener("request", handler);
@@ -1820,7 +1944,18 @@ Last error: ${lastError.message}` : "";
     const requestUrl = params.request.url;
     for (const { regex, handler } of this._routeHandlers) {
       if (regex.test(requestUrl)) {
-        const route = createXBRouteFetch(this.conn, this.sessionId, params);
+        this._emit("request", createXBRequest(
+          null,
+          {
+            requestId: params.requestId,
+            url: params.request.url,
+            method: params.request.method,
+            headers: params.request.headers,
+            postData: params.request.postData ?? null,
+            resourceType: params.resourceType
+          }
+        ));
+        const route = createXBRouteFetch(this.conn, this.sessionId, params, this._emitter);
         try {
           await handler(route);
         } catch {
@@ -1987,6 +2122,7 @@ var XBContextImpl = class {
     const page = new XBPageImpl(this.conn, sessionId, targetId, this, this._browser);
     await page._init();
     this._pages.push(page);
+    this.forwardPageEvents(page);
     if (this.options.viewport) {
       await page.setViewportSize(this.options.viewport).catch(() => {
       });
@@ -2028,7 +2164,10 @@ var XBContextImpl = class {
     }
     this._browser._removeContext(this.contextId);
   }
-  async newCDPSession(_page) {
+  async newCDPSession(page) {
+    if (page instanceof XBPageImpl) {
+      return new XBCDPSessionImpl(this.conn, page.sessionId);
+    }
     return new XBCDPSessionImpl(this.conn);
   }
   async addInitScript(script) {
@@ -2065,7 +2204,31 @@ var XBContextImpl = class {
   off(event, handler) {
     this._emitter.off(event, handler);
   }
+  /**
+   * Register a page that was attached to an existing target (discovered via
+   * Target.getTargets). Used by XBBrowserImpl.discoverContexts() to wire up
+   * pages from the user's existing browser session into the context wrapper
+   * so they appear in `context.pages()` and can be reused by plugins.
+   */
+  _addDiscoveredPage(page) {
+    const exists = this._pages.some((p) => p._targetId === page._targetId);
+    if (exists) return;
+    this._pages.push(page);
+    this.forwardPageEvents(page);
+  }
   // ── Private ─────────────────────────────────────────────────
+  /** Forward page-level events (request, response, etc.) to context listeners */
+  forwardPageEvents(page) {
+    const forward = (event) => {
+      page.on(event, (...args) => {
+        this._emitter.emit(event, ...args);
+      });
+    };
+    forward("request");
+    forward("response");
+    forward("requestfailed");
+    forward("requestfinished");
+  }
   setupAutoAttach() {
     this.targetAttachedHandler = (paramsRaw) => {
       const params = paramsRaw;
@@ -2090,6 +2253,7 @@ var XBContextImpl = class {
           });
         }
         this._pages.push(page);
+        this.forwardPageEvents(page);
         this._emitter.emit("page", page);
       });
     };
@@ -2106,10 +2270,17 @@ var XBBrowserImpl = class {
   childProcess = null;
   tmpDir;
   _exitHandler = null;
-  constructor(conn, childProcess, tmpDir) {
+  /**
+   * Original CDP endpoint (HTTP or ws URL) used to construct this browser.
+   * Used by discoverContexts() as a fallback to HTTP /json/list when
+   * Target.getTargets doesn't return page-type targets (e.g. cdp-tunnel proxy).
+   */
+  cdpEndpoint;
+  constructor(conn, childProcess, tmpDir, cdpEndpoint) {
     this.conn = conn;
     this.childProcess = childProcess ?? null;
     this.tmpDir = tmpDir;
+    this.cdpEndpoint = cdpEndpoint;
     conn.on("disconnect", () => {
       this._disconnected = true;
       this._emitter.emit("disconnected");
@@ -2153,7 +2324,7 @@ var XBBrowserImpl = class {
       this._exitHandler = null;
     }
     if (this.childProcess) {
-      const { killChrome: killChrome2 } = await import("./launcher-KA7J32K5.js");
+      const { killChrome: killChrome2 } = await import("./launcher-OZXJQPNG.js");
       await killChrome2(this.childProcess, this.tmpDir);
     }
     await this.conn.close();
@@ -2183,6 +2354,10 @@ var XBBrowserImpl = class {
       contextId,
       context
     });
+    if (this.childProcess) {
+      this._enableAutoAttach().catch(() => {
+      });
+    }
     return context;
   }
   contexts() {
@@ -2211,6 +2386,23 @@ var XBBrowserImpl = class {
   async _detachFromTarget(sessionId) {
     await this.conn.send("Target.detachFromTarget", { sessionId });
   }
+  /**
+   * Derive the HTTP /json base URL from the original cdpEndpoint for use
+   * as a fallback when Target.getTargets doesn't return page targets.
+   * Supports both http:// and ws:// input formats.
+   */
+  _httpFallbackURL() {
+    if (!this.cdpEndpoint) return void 0;
+    if (this.cdpEndpoint.startsWith("http://") || this.cdpEndpoint.startsWith("https://")) {
+      return this.cdpEndpoint;
+    }
+    if (this.cdpEndpoint.startsWith("ws://") || this.cdpEndpoint.startsWith("wss://")) {
+      const url = this.cdpEndpoint.replace(/^ws/, "http");
+      const slashIdx = url.indexOf("/", url.indexOf("//") + 2);
+      return slashIdx >= 0 ? url.substring(0, slashIdx) : url;
+    }
+    return void 0;
+  }
   /** Create a new page target within a browser context */
   async _createTarget(contextId, url = "about:blank") {
     const params = { url };
@@ -2227,10 +2419,97 @@ var XBBrowserImpl = class {
   async _enableAutoAttach() {
     await this.conn.send("Target.setAutoAttach", {
       autoAttach: true,
-      waitForDebuggerOnStart: true,
+      waitForDebuggerOnStart: false,
       flatten: true
     });
   }
+  /**
+   * Discover existing browser contexts and pages via Target.getTargets.
+   *
+   * For CDP tunnel connections (cdp-tunnel, attach scenarios), the
+   * Target.attachedToTarget auto-attach flow is unreliable. Without this
+   * call, `b.contexts()` would return [] and callers would fall back to
+   * `b.newContext()` — which creates an isolated context with NO cookies
+   * shared with the user's existing browser session (causing login failures).
+   *
+   * This method:
+   *  1. Queries Target.getTargets to enumerate all page targets
+   *  2. Groups them by browserContextId
+   *  3. Attaches to each existing page via Target.attachToTarget
+   *  4. Wraps the discovered pages in a XBContextImpl and registers it in
+   *     this._contexts so `contexts()` returns the user's actual contexts
+   *  5. Enables Target.setAutoAttach for future pages
+   *
+   * No-op for self-launched browsers (they already populated contexts via
+   * newContext() + childProcess-gated auto-attach).
+   */
+  async discoverContexts() {
+    if (this._disconnected) return;
+    let targetInfos = [];
+    try {
+      const result = await this.conn.send(
+        "Target.getTargets"
+      );
+      targetInfos = result.targetInfos ?? [];
+    } catch {
+      return;
+    }
+    const pageTargets = targetInfos.filter((t) => t.type === "page");
+    const httpFallbackUrl = this._httpFallbackURL();
+    if (pageTargets.length === 0 && httpFallbackUrl) {
+      console.log(`[discoverContexts] Target.getTargets returned ${targetInfos.length} targets (0 page type). Falling back to HTTP /json/list at ${httpFallbackUrl}`);
+      try {
+        const { getCDPTargets: getCDPTargets2 } = await import("./launcher-OZXJQPNG.js");
+        const httpPages = await getCDPTargets2(httpFallbackUrl);
+        console.log(`[discoverContexts] HTTP /json/list returned ${httpPages.length} pages`);
+        for (const p of httpPages) {
+          if (p.type !== "page") continue;
+          if (!p.url || p.url.startsWith("chrome://") || p.url.startsWith("devtools://")) continue;
+          targetInfos.push({
+            targetId: p.id,
+            type: "page",
+            url: p.url,
+            title: p.title
+          });
+        }
+        console.log(`[discoverContexts] After HTTP fallback: ${targetInfos.length} total targets, ${targetInfos.filter((t) => t.type === "page").length} pages`);
+      } catch (err) {
+        console.log(`[discoverContexts] HTTP fallback failed: ${errMsg(err)}`);
+      }
+    }
+    const pagesByContext = /* @__PURE__ */ new Map();
+    for (const t of targetInfos) {
+      if (t.type !== "page") continue;
+      if (!t.url || t.url.startsWith("chrome://") || t.url.startsWith("devtools://")) {
+        continue;
+      }
+      const ctxId = t.browserContextId || "default";
+      if (!pagesByContext.has(ctxId)) pagesByContext.set(ctxId, []);
+      pagesByContext.get(ctxId).push(t);
+    }
+    for (const [ctxId, pages] of pagesByContext) {
+      if (this._contexts.has(ctxId)) continue;
+      const context = new XBContextImpl(this.conn, ctxId, this, {});
+      for (const p of pages) {
+        try {
+          const sessionId = await this._attachToTarget(p.targetId);
+          const page = new XBPageImpl(this.conn, sessionId, p.targetId, context, this);
+          await page._init();
+          context._addDiscoveredPage(page);
+        } catch {
+        }
+      }
+      this._contexts.set(ctxId, { contextId: ctxId, context });
+    }
+    try {
+      await this.conn.send("Target.setAutoAttach", {
+        autoAttach: true,
+        waitForDebuggerOnStart: false,
+        flatten: true
+      });
+    } catch {
+    }
+  }
 };
 
 // src/cdp-driver/connection.ts
@@ -2510,7 +2789,8 @@ async function launch(options = {}) {
   }
   const conn = new CDPConnection(wsEndpoint);
   await conn.ready();
-  const browser = new XBBrowserImpl(conn, childProcess, tmpDir);
+  const httpEndpoint = options.cdpEndpoint && !options.cdpEndpoint.startsWith("ws") ? options.cdpEndpoint : void 0;
+  const browser = new XBBrowserImpl(conn, childProcess, tmpDir, httpEndpoint);
   return { browser, wsEndpoint };
 }
 export {

package/dist/{cdp-driver-SSXUGXP6.js → cdp-driver-D6WMSMWX.js}

@@ -14,15 +14,16 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-42RPMJ76.js";
+} from "./chunk-N2JFPWMI.js";
 import {
   connectToCDP,
   findChrome,
   getCDPTargets,
   killChrome,
   launchChrome
-} from "./chunk-T4J4C2NZ.js";
-import "./chunk-3RG5ZIWI.js";
+} from "./chunk-TNEN6VQ2.js";
+import "./chunk-GDKLH7ZY.js";
+import "./chunk-KFQGP6VL.js";
 export {
   CDPConnection,
   CDPProtocolError,