browserclaw 0.10.4 → 0.10.5

package/dist/index.cjs

@@ -48,9 +48,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// node_modules/ipaddr.js/lib/ipaddr.js
+// ../../../node_modules/ipaddr.js/lib/ipaddr.js
 var require_ipaddr = __commonJS({
-  "node_modules/ipaddr.js/lib/ipaddr.js"(exports$1, module) {
+  "../../../node_modules/ipaddr.js/lib/ipaddr.js"(exports$1, module) {
     (function(root) {
       const ipv4Part = "(0?\\d+|0x[a-f0-9]+)";
       const ipv4Regexes = {
@@ -1388,7 +1388,6 @@ async function launchChrome(opts = {}) {
   const spawnChrome = () => {
     const args = [
       `--remote-debugging-port=${String(cdpPort)}`,
-      "--remote-debugging-address=127.0.0.1",
       `--user-data-dir=${userDataDir}`,
       "--no-first-run",
       "--no-default-browser-check",
@@ -1407,9 +1406,6 @@ async function launchChrome(opts = {}) {
     if (opts.noSandbox === true) {
       args.push("--no-sandbox", "--disable-setuid-sandbox");
     }
-    if (opts.ignoreHTTPSErrors === true) {
-      args.push("--ignore-certificate-errors");
-    }
     if (process.platform === "linux") args.push("--disable-dev-shm-usage");
     const extraArgs = Array.isArray(opts.chromeArgs) ? opts.chromeArgs.filter((a) => typeof a === "string" && a.trim().length > 0) : [];
     if (extraArgs.length) args.push(...extraArgs);
@@ -1730,15 +1726,7 @@ function appendCdpPath2(cdpUrl, cdpPath) {
   }
 }
 async function withPlaywrightPageCdpSession(page, fn) {
-  const CDP_SESSION_TIMEOUT_MS = 1e4;
-  const session = await Promise.race([
-    page.context().newCDPSession(page),
-    new Promise((_, reject) => {
-      setTimeout(() => {
-        reject(new Error("newCDPSession timed out after 10s"));
-      }, CDP_SESSION_TIMEOUT_MS);
-    })
-  ]);
+  const session = await page.context().newCDPSession(page);
   try {
     return await fn(session);
   } finally {
@@ -2378,14 +2366,7 @@ function toAIFriendlyError(error, selector) {
       `Element "${selector}" is not interactable (hidden or covered). Try scrolling it into view, closing overlays, or re-snapshotting.`
     );
   }
-  const timeoutMatch = /Timeout (\d+)ms exceeded/.exec(message);
-  if (timeoutMatch) {
-    return new Error(
-      `Element "${selector}" timed out after ${timeoutMatch[1]}ms \u2014 element may be hidden or not interactable. Run a new snapshot to see current page elements.`
-    );
-  }
-  const cleaned = message.replace(/locator\([^)]*\)\./g, "").replace(/waiting for locator\([^)]*\)/g, "").trim();
-  return new Error(cleaned || message);
+  return error instanceof Error ? error : new Error(message);
 }
 function normalizeTimeoutMs(timeoutMs, fallback, maxMs = 12e4) {
   return Math.max(500, Math.min(maxMs, timeoutMs ?? fallback));
@@ -3083,19 +3064,7 @@ function requiresInspectableBrowserNavigationRedirects(ssrfPolicy) {
 
 // src/actions/interaction.ts
 var MAX_CLICK_DELAY_MS = 5e3;
-var DEFAULT_SCROLL_TIMEOUT_MS = 2e4;
-var CHECKABLE_ROLES = /* @__PURE__ */ new Set(["menuitemcheckbox", "menuitemradio", "checkbox", "radio", "switch"]);
-async function setCheckedViaEvaluate(locator, checked) {
-  await locator.evaluate((el, desired) => {
-    const input = el;
-    const desc = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "checked");
-    if (desc?.set) desc.set.call(input, desired);
-    else input.checked = desired;
-    input.dispatchEvent(new Event("input", { bubbles: true }));
-    input.dispatchEvent(new Event("change", { bubbles: true }));
-    input.click();
-  }, checked);
-}
+var CHECKABLE_ROLES = /* @__PURE__ */ new Set(["menuitemcheckbox", "menuitemradio", "checkbox", "switch"]);
 function resolveLocator(page, resolved) {
   if (resolved.ref !== void 0 && resolved.ref !== "") return refLocator(page, resolved.ref);
   const sel = resolved.selector ?? "";
@@ -3109,29 +3078,11 @@ async function mouseClickViaPlaywright(opts) {
     delay: opts.delayMs
   });
 }
-async function pressAndHoldViaCdp(opts) {
-  const page = await getPageForTargetId({ cdpUrl: opts.cdpUrl, targetId: opts.targetId });
-  ensurePageState(page);
-  const { x, y } = opts;
-  await withPageScopedCdpClient({
-    cdpUrl: opts.cdpUrl,
-    page,
-    targetId: opts.targetId,
-    fn: async (send) => {
-      await send("Input.dispatchMouseEvent", { type: "mouseMoved", x, y, button: "none" });
-      if (opts.delay !== void 0 && opts.delay !== 0) await new Promise((r) => setTimeout(r, opts.delay));
-      await send("Input.dispatchMouseEvent", { type: "mousePressed", x, y, button: "left", clickCount: 1 });
-      if (opts.holdMs !== void 0 && opts.holdMs !== 0) await new Promise((r) => setTimeout(r, opts.holdMs));
-      await send("Input.dispatchMouseEvent", { type: "mouseReleased", x, y, button: "left", clickCount: 1 });
-    }
-  });
-}
 async function clickByTextViaPlaywright(opts) {
   const page = await getRestoredPageForTarget(opts);
   const timeout = resolveInteractionTimeoutMs(opts.timeoutMs);
-  const locator = page.getByText(opts.text, { exact: opts.exact }).and(page.locator(":visible")).or(page.getByTitle(opts.text, { exact: opts.exact })).first();
   try {
-    await locator.click({ timeout, button: opts.button, modifiers: opts.modifiers });
+    await page.getByText(opts.text, { exact: opts.exact }).click({ timeout, button: opts.button, modifiers: opts.modifiers });
   } catch (err) {
     throw toAIFriendlyError(err, `text="${opts.text}"`);
   }
@@ -3139,12 +3090,13 @@ async function clickByTextViaPlaywright(opts) {
 async function clickByRoleViaPlaywright(opts) {
   const page = await getRestoredPageForTarget(opts);
   const timeout = resolveInteractionTimeoutMs(opts.timeoutMs);
-  const label = `role=${opts.role}${opts.name !== void 0 && opts.name !== "" ? ` name="${opts.name}"` : ""}`;
-  const locator = page.getByRole(opts.role, { name: opts.name }).nth(opts.index ?? 0);
   try {
-    await locator.click({ timeout, button: opts.button, modifiers: opts.modifiers });
+    await page.getByRole(opts.role, { name: opts.name }).click({ timeout, button: opts.button, modifiers: opts.modifiers });
   } catch (err) {
-    throw toAIFriendlyError(err, label);
+    throw toAIFriendlyError(
+      err,
+      `role=${opts.role}${opts.name !== void 0 && opts.name !== "" ? ` name="${opts.name}"` : ""}`
+    );
   }
 }
 async function clickViaPlaywright(opts) {
@@ -3165,7 +3117,7 @@ async function clickViaPlaywright(opts) {
   try {
     const delayMs = resolveBoundedDelayMs(opts.delayMs, "click delayMs", MAX_CLICK_DELAY_MS);
     if (delayMs > 0) {
-      await locator.hover({ timeout, force: opts.force });
+      await locator.hover({ timeout });
       await new Promise((resolve2) => setTimeout(resolve2, delayMs));
     }
     let ariaCheckedBefore;
@@ -3173,9 +3125,9 @@ async function clickViaPlaywright(opts) {
       ariaCheckedBefore = await locator.getAttribute("aria-checked", { timeout }).catch(() => void 0);
     }
     if (opts.doubleClick === true) {
-      await locator.dblclick({ timeout, button: opts.button, modifiers: opts.modifiers, force: opts.force });
+      await locator.dblclick({ timeout, button: opts.button, modifiers: opts.modifiers });
     } else {
-      await locator.click({ timeout, button: opts.button, modifiers: opts.modifiers, force: opts.force });
+      await locator.click({ timeout, button: opts.button, modifiers: opts.modifiers });
     }
     if (checkableRole && opts.doubleClick !== true && ariaCheckedBefore !== void 0) {
       const POLL_INTERVAL_MS = 50;
@@ -3269,13 +3221,9 @@ async function fillFormViaPlaywright(opts) {
     if (type === "checkbox" || type === "radio") {
       const checked = rawValue === true || rawValue === 1 || rawValue === "1" || rawValue === "true";
       try {
-        await locator.setChecked(checked, { timeout, force: true });
-      } catch {
-        try {
-          await setCheckedViaEvaluate(locator, checked);
-        } catch (err) {
-          throw toAIFriendlyError(err, ref);
-        }
+        await locator.setChecked(checked, { timeout });
+      } catch (err) {
+        throw toAIFriendlyError(err, ref);
       }
       continue;
     }
@@ -3292,13 +3240,7 @@ async function scrollIntoViewViaPlaywright(opts) {
   const label = resolved.ref ?? resolved.selector ?? "";
   const locator = resolveLocator(page, resolved);
   try {
-    await locator.waitFor({
-      state: "attached",
-      timeout: normalizeTimeoutMs(opts.timeoutMs, DEFAULT_SCROLL_TIMEOUT_MS)
-    });
-    await locator.evaluate((el) => {
-      el.scrollIntoView({ block: "center", behavior: "instant" });
-    });
+    await locator.scrollIntoViewIfNeeded({ timeout: normalizeTimeoutMs(opts.timeoutMs, 2e4) });
   } catch (err) {
     throw toAIFriendlyError(err, label);
   }
@@ -3506,12 +3448,7 @@ async function closePageViaPlaywright(opts) {
   await page.close();
 }
 async function closePageByTargetIdViaPlaywright(opts) {
-  try {
-    await (await resolvePageByTargetIdOrThrow(opts)).close();
-  } catch (err) {
-    if (err instanceof BrowserTabNotFoundError) return;
-    throw err;
-  }
+  await (await resolvePageByTargetIdOrThrow(opts)).close();
 }
 async function focusPageByTargetIdViaPlaywright(opts) {
   const page = await resolvePageByTargetIdOrThrow(opts);
@@ -3533,27 +3470,6 @@ async function focusPageByTargetIdViaPlaywright(opts) {
     }
   }
 }
-async function waitForTabViaPlaywright(opts) {
-  if (opts.urlContains === void 0 && opts.titleContains === void 0)
-    throw new Error("urlContains or titleContains is required");
-  const timeout = Math.max(1e3, Math.min(12e4, opts.timeoutMs ?? 3e4));
-  const start = Date.now();
-  const POLL_INTERVAL_MS = 250;
-  while (Date.now() - start < timeout) {
-    const tabs = await listPagesViaPlaywright({ cdpUrl: opts.cdpUrl });
-    const match = tabs.find((t) => {
-      if (opts.urlContains !== void 0 && !t.url.includes(opts.urlContains)) return false;
-      if (opts.titleContains !== void 0 && !t.title.includes(opts.titleContains)) return false;
-      return true;
-    });
-    if (match) return match;
-    await new Promise((resolve2) => setTimeout(resolve2, POLL_INTERVAL_MS));
-  }
-  const criteria = [];
-  if (opts.urlContains !== void 0) criteria.push(`url contains "${opts.urlContains}"`);
-  if (opts.titleContains !== void 0) criteria.push(`title contains "${opts.titleContains}"`);
-  throw new Error(`Timed out waiting for tab: ${criteria.join(", ")}`);
-}
 async function resizeViewportViaPlaywright(opts) {
   const page = await getPageForTargetId({ cdpUrl: opts.cdpUrl, targetId: opts.targetId });
   ensurePageState(page);
@@ -3595,13 +3511,9 @@ async function waitForViaPlaywright(opts) {
   if (opts.loadState !== void 0) {
     await page.waitForLoadState(opts.loadState, { timeout });
   }
-  if (opts.fn !== void 0) {
-    if (typeof opts.fn === "function") {
-      await page.waitForFunction(opts.fn, opts.arg, { timeout });
-    } else {
-      const fn = opts.fn.trim();
-      if (fn !== "") await page.waitForFunction(fn, opts.arg, { timeout });
-    }
+  if (opts.fn !== void 0 && opts.fn !== "") {
+    const fn = opts.fn.trim();
+    if (fn !== "") await page.waitForFunction(fn, void 0, { timeout });
   }
 }
 
@@ -3713,7 +3625,6 @@ async function executeSingleAction(action, cdpUrl, targetId, evaluateEnabled, de
         url: action.url,
         loadState: action.loadState,
         fn: action.fn,
-        arg: action.arg,
         timeoutMs: action.timeoutMs
       });
       break;
@@ -4189,40 +4100,6 @@ async function responseBodyViaPlaywright(opts) {
     truncated
   };
 }
-async function waitForRequestViaPlaywright(opts) {
-  const page = await getPageForTargetId({ cdpUrl: opts.cdpUrl, targetId: opts.targetId });
-  ensurePageState(page);
-  const timeout = normalizeTimeoutMs(opts.timeoutMs, 3e4, 12e4);
-  const pattern = opts.url.trim();
-  if (!pattern) throw new Error("url is required");
-  const upperMethod = opts.method !== void 0 ? opts.method.toUpperCase() : void 0;
-  const response = await page.waitForResponse(
-    (resp) => matchUrlPattern(pattern, resp.url()) && (upperMethod === void 0 || resp.request().method() === upperMethod),
-    { timeout }
-  );
-  const request = response.request();
-  let responseBody;
-  let truncated = false;
-  try {
-    responseBody = await response.text();
-    const maxChars = typeof opts.maxChars === "number" && Number.isFinite(opts.maxChars) ? Math.max(1, Math.min(5e6, Math.floor(opts.maxChars))) : 2e5;
-    if (responseBody.length > maxChars) {
-      responseBody = responseBody.slice(0, maxChars);
-      truncated = true;
-    }
-  } catch (err) {
-    console.warn("[browserclaw] response body unavailable:", err instanceof Error ? err.message : String(err));
-  }
-  return {
-    url: response.url(),
-    method: request.method(),
-    postData: request.postData() ?? void 0,
-    status: response.status(),
-    ok: response.ok(),
-    responseBody,
-    truncated
-  };
-}
 
 // src/capture/screenshot.ts
 async function takeScreenshotViaPlaywright(opts) {
@@ -4346,13 +4223,6 @@ async function traceStopViaPlaywright(opts) {
 }
 
 // src/snapshot/ref-map.ts
-function parseStateFromSuffix(suffix) {
-  const state = {};
-  if (/\[disabled\]/i.test(suffix)) state.disabled = true;
-  if (/\[checked\s*=\s*"?mixed"?\]/i.test(suffix)) state.checked = "mixed";
-  else if (/\[checked\]/i.test(suffix)) state.checked = true;
-  return state;
-}
 var INTERACTIVE_ROLES = /* @__PURE__ */ new Set([
   "button",
   "link",
@@ -4511,8 +4381,7 @@ function buildRoleSnapshotFromAriaSnapshot(ariaSnapshot, options = {}) {
       const ref = nextRef();
       const nth = tracker.getNextIndex(role, name);
       tracker.trackRef(role, name, ref);
-      const state = parseStateFromSuffix(suffix);
-      refs[ref] = { role, name, nth, ...state };
+      refs[ref] = { role, name, nth };
       let enhanced = `${prefix}${roleRaw}`;
       if (name !== void 0 && name !== "") enhanced += ` "${name}"`;
       enhanced += ` [ref=${ref}]`;
@@ -4549,8 +4418,7 @@ function buildRoleSnapshotFromAriaSnapshot(ariaSnapshot, options = {}) {
     const ref = nextRef();
     const nth = tracker.getNextIndex(role, name);
     tracker.trackRef(role, name, ref);
-    const state = parseStateFromSuffix(suffix);
-    refs[ref] = { role, name, nth, ...state };
+    refs[ref] = { role, name, nth };
     let enhanced = `${prefix}${roleRaw}`;
     if (name !== "") enhanced += ` "${name}"`;
     enhanced += ` [ref=${ref}]`;
@@ -4588,13 +4456,12 @@ function buildRoleSnapshotFromAiSnapshot(aiSnapshot, options = {}) {
       if (!INTERACTIVE_ROLES.has(role)) continue;
       const ref = parseAiSnapshotRef(suffix);
       const prefix = /^(\s*-\s*)/.exec(line)?.[1] ?? "";
-      const state = parseStateFromSuffix(suffix);
       if (ref !== null) {
-        refs[ref] = { role, ...name !== void 0 && name !== "" ? { name } : {}, ...state };
+        refs[ref] = { role, ...name !== void 0 && name !== "" ? { name } : {} };
         out2.push(`${prefix}${roleRaw}${name !== void 0 && name !== "" ? ` "${name}"` : ""}${suffix}`);
       } else {
         const generatedRef = nextInteractiveRef();
-        refs[generatedRef] = { role, ...name !== void 0 && name !== "" ? { name } : {}, ...state };
+        refs[generatedRef] = { role, ...name !== void 0 && name !== "" ? { name } : {} };
         let enhanced = `${prefix}${roleRaw}`;
         if (name !== void 0 && name !== "") enhanced += ` "${name}"`;
         enhanced += ` [ref=${generatedRef}]`;
@@ -4632,13 +4499,12 @@ function buildRoleSnapshotFromAiSnapshot(aiSnapshot, options = {}) {
     const isStructural = STRUCTURAL_ROLES.has(role);
     if (options.compact === true && isStructural && name === "") continue;
     const ref = parseAiSnapshotRef(suffix);
-    const state = parseStateFromSuffix(suffix);
     if (ref !== null) {
-      refs[ref] = { role, ...name !== "" ? { name } : {}, ...state };
+      refs[ref] = { role, ...name !== "" ? { name } : {} };
       out.push(line);
     } else if (INTERACTIVE_ROLES.has(role)) {
       const generatedRef = nextGeneratedRef();
-      refs[generatedRef] = { role, ...name !== "" ? { name } : {}, ...state };
+      refs[generatedRef] = { role, ...name !== "" ? { name } : {} };
       let enhanced = `${prefix}${roleRaw}`;
       if (name !== "") enhanced += ` "${name}"`;
       enhanced += ` [ref=${generatedRef}]`;
@@ -5004,8 +4870,7 @@ var CrawlPage = class {
       button: opts?.button,
       modifiers: opts?.modifiers,
       delayMs: opts?.delayMs,
-      timeoutMs: opts?.timeoutMs,
-      force: opts?.force
+      timeoutMs: opts?.timeoutMs
     });
   }
   /**
@@ -5031,8 +4896,7 @@ var CrawlPage = class {
       button: opts?.button,
       modifiers: opts?.modifiers,
       delayMs: opts?.delayMs,
-      timeoutMs: opts?.timeoutMs,
-      force: opts?.force
+      timeoutMs: opts?.timeoutMs
     });
   }
   /**
@@ -5062,32 +4926,6 @@ var CrawlPage = class {
       delayMs: opts?.delayMs
     });
   }
-  /**
-   * Press and hold at page coordinates using raw CDP events.
-   *
-   * Bypasses Playwright's automation layer by dispatching CDP
-   * `Input.dispatchMouseEvent` directly — useful for anti-bot challenges
-   * that detect automated clicks.
-   *
-   * @param x - X coordinate in CSS pixels
-   * @param y - Y coordinate in CSS pixels
-   * @param opts - Options (delay: ms before press, holdMs: hold duration)
-   *
-   * @example
-   * ```ts
-   * await page.pressAndHold(400, 300, { delay: 150, holdMs: 5000 });
-   * ```
-   */
-  async pressAndHold(x, y, opts) {
-    return pressAndHoldViaCdp({
-      cdpUrl: this.cdpUrl,
-      targetId: this.targetId,
-      x,
-      y,
-      delay: opts?.delay,
-      holdMs: opts?.holdMs
-    });
-  }
   /**
    * Click an element by its visible text content (no snapshot/ref needed).
    *
@@ -5135,7 +4973,6 @@ var CrawlPage = class {
       targetId: this.targetId,
       role,
       name,
-      index: opts?.index,
       button: opts?.button,
       modifiers: opts?.modifiers,
       timeoutMs: opts?.timeoutMs
@@ -5659,35 +5496,6 @@ var CrawlPage = class {
       maxChars: opts?.maxChars
     });
   }
-  /**
-   * Wait for a network request matching a URL pattern and return request + response details.
-   *
-   * Unlike `networkRequests()` which only captures metadata, this method captures
-   * the full request body (POST data) and response body.
-   *
-   * @param url - URL string or pattern to match (supports `*` wildcards and substring matching)
-   * @param opts - Options (method filter, timeoutMs, maxChars for response body)
-   * @returns Request method, postData, response status, and response body
-   *
-   * @example
-   * ```ts
-   * const reqPromise = page.waitForRequest('/api/submit', { method: 'POST' });
-   * await page.click('e5'); // submit a form
-   * const req = await reqPromise;
-   * console.log(req.postData); // form body
-   * console.log(req.status, req.responseBody); // response
-   * ```
-   */
-  async waitForRequest(url, opts) {
-    return waitForRequestViaPlaywright({
-      cdpUrl: this.cdpUrl,
-      targetId: this.targetId,
-      url,
-      method: opts?.method,
-      timeoutMs: opts?.timeoutMs,
-      maxChars: opts?.maxChars
-    });
-  }
   /**
    * Get console messages captured from the page.
    *
@@ -6210,31 +6018,6 @@ var BrowserClaw = class _BrowserClaw {
   async tabs() {
     return listPagesViaPlaywright({ cdpUrl: this.cdpUrl });
   }
-  /**
-   * Wait for a tab matching the given criteria and return a page handle.
-   *
-   * Polls open tabs until one matches, then focuses it and returns a CrawlPage.
-   *
-   * @param opts - Match criteria (urlContains, titleContains) and timeout
-   * @returns A CrawlPage for the matched tab
-   *
-   * @example
-   * ```ts
-   * await page.click('e5'); // opens a new tab
-   * const appPage = await browser.waitForTab({ urlContains: 'app-web' });
-   * const { snapshot } = await appPage.snapshot();
-   * ```
-   */
-  async waitForTab(opts) {
-    const tab = await waitForTabViaPlaywright({
-      cdpUrl: this.cdpUrl,
-      urlContains: opts.urlContains,
-      titleContains: opts.titleContains,
-      timeoutMs: opts.timeoutMs
-    });
-    await focusPageByTargetIdViaPlaywright({ cdpUrl: this.cdpUrl, targetId: tab.targetId });
-    return new CrawlPage(this.cdpUrl, tab.targetId, this.ssrfPolicy);
-  }
   /**
    * Bring a tab to the foreground.
    *
@@ -6304,7 +6087,6 @@ exports.isChromeCdpReady = isChromeCdpReady;
 exports.isChromeReachable = isChromeReachable;
 exports.normalizeCdpHttpBaseForJsonEndpoints = normalizeCdpHttpBaseForJsonEndpoints;
 exports.parseRoleRef = parseRoleRef;
-exports.pressAndHoldViaCdp = pressAndHoldViaCdp;
 exports.requireRef = requireRef;
 exports.requireRefOrSelector = requireRefOrSelector;
 exports.requiresInspectableBrowserNavigationRedirects = requiresInspectableBrowserNavigationRedirects;