browserclaw 0.9.3 → 0.9.5

package/dist/index.d.cts

@@ -717,6 +717,25 @@ declare class CrawlPage {
         clickCount?: number;
         delayMs?: number;
     }): Promise<void>;
+    /**
+     * 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 (holdMs: hold duration, default 1000, max 30000)
+     *
+     * @example
+     * ```ts
+     * await page.pressAndHold(400, 300, { holdMs: 5000 });
+     * ```
+     */
+    pressAndHold(x: number, y: number, opts?: {
+        holdMs?: number;
+    }): Promise<void>;
     /**
      * Click an element by its visible text content (no snapshot/ref needed).
      *
@@ -1717,6 +1736,14 @@ declare function getRestoredPageForTarget(opts: {
     targetId?: string;
 }): Promise<Page>;
 
+declare function pressAndHoldViaCdp(opts: {
+    cdpUrl: string;
+    targetId?: string;
+    x: number;
+    y: number;
+    holdMs?: number;
+}): Promise<void>;
+
 /**
  * Comprehensive browser stealth evasions.
  *
@@ -1755,4 +1782,4 @@ declare function waitForChallengeViaPlaywright(opts: {
     pollMs?: number;
 }): Promise<ChallengeWaitResult>;
 
-export { type AriaNode, type AriaSnapshotResult, type BatchAction, type BatchActionResult, BrowserClaw, type BrowserNavigationPolicyOptions, type BrowserNavigationRequestLike, type BrowserTab, BrowserTabNotFoundError, type ChallengeInfo, type ChallengeKind, type ChallengeWaitResult, type ChromeExecutable, type ChromeKind, type ClickOptions, type ColorScheme, type ConnectOptions, type ConsoleMessage, type ContextState, type CookieData, CrawlPage, type DialogEvent, type DialogHandler, type DialogOptions, type DownloadResult, type FormField, type FrameEvalResult, type GeolocationOptions, type HttpCredentials, InvalidBrowserNavigationUrlError, type LaunchOptions, type LookupFn, type NetworkRequest, type PageError, type PinnedHostname, type ResponseBodyResult, type RoleRefInfo, type RoleRefs, STEALTH_SCRIPT, type ScreenshotOptions, type SnapshotOptions, type SnapshotResult, type SnapshotStats, type SsrfPolicy, type StorageKind, type TraceStartOptions, type TypeOptions, type UntrustedContentMeta, type WaitOptions, assertBrowserNavigationAllowed, assertBrowserNavigationRedirectChainAllowed, assertBrowserNavigationResultAllowed, assertSafeUploadPaths, batchViaPlaywright, createPinnedLookup, detectChallengeViaPlaywright, ensureContextState, executeSingleAction, forceDisconnectPlaywrightForTarget, getChromeWebSocketUrl, getRestoredPageForTarget, isChromeCdpReady, isChromeReachable, normalizeCdpHttpBaseForJsonEndpoints, parseRoleRef, requireRef, requireRefOrSelector, requiresInspectableBrowserNavigationRedirects, resolveBoundedDelayMs, resolveInteractionTimeoutMs, resolvePageByTargetIdOrThrow, resolvePinnedHostnameWithPolicy, resolveStrictExistingUploadPaths, sanitizeUntrustedFileName, setDialogHandler, waitForChallengeViaPlaywright, withBrowserNavigationPolicy, withPageScopedCdpClient, withPlaywrightPageCdpSession, writeViaSiblingTempPath };
+export { type AriaNode, type AriaSnapshotResult, type BatchAction, type BatchActionResult, BrowserClaw, type BrowserNavigationPolicyOptions, type BrowserNavigationRequestLike, type BrowserTab, BrowserTabNotFoundError, type ChallengeInfo, type ChallengeKind, type ChallengeWaitResult, type ChromeExecutable, type ChromeKind, type ClickOptions, type ColorScheme, type ConnectOptions, type ConsoleMessage, type ContextState, type CookieData, CrawlPage, type DialogEvent, type DialogHandler, type DialogOptions, type DownloadResult, type FormField, type FrameEvalResult, type GeolocationOptions, type HttpCredentials, InvalidBrowserNavigationUrlError, type LaunchOptions, type LookupFn, type NetworkRequest, type PageError, type PinnedHostname, type ResponseBodyResult, type RoleRefInfo, type RoleRefs, STEALTH_SCRIPT, type ScreenshotOptions, type SnapshotOptions, type SnapshotResult, type SnapshotStats, type SsrfPolicy, type StorageKind, type TraceStartOptions, type TypeOptions, type UntrustedContentMeta, type WaitOptions, assertBrowserNavigationAllowed, assertBrowserNavigationRedirectChainAllowed, assertBrowserNavigationResultAllowed, assertSafeUploadPaths, batchViaPlaywright, createPinnedLookup, detectChallengeViaPlaywright, ensureContextState, executeSingleAction, forceDisconnectPlaywrightForTarget, getChromeWebSocketUrl, getRestoredPageForTarget, isChromeCdpReady, isChromeReachable, normalizeCdpHttpBaseForJsonEndpoints, parseRoleRef, pressAndHoldViaCdp, requireRef, requireRefOrSelector, requiresInspectableBrowserNavigationRedirects, resolveBoundedDelayMs, resolveInteractionTimeoutMs, resolvePageByTargetIdOrThrow, resolvePinnedHostnameWithPolicy, resolveStrictExistingUploadPaths, sanitizeUntrustedFileName, setDialogHandler, waitForChallengeViaPlaywright, withBrowserNavigationPolicy, withPageScopedCdpClient, withPlaywrightPageCdpSession, writeViaSiblingTempPath };

package/dist/index.d.ts

@@ -717,6 +717,25 @@ declare class CrawlPage {
         clickCount?: number;
         delayMs?: number;
     }): Promise<void>;
+    /**
+     * 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 (holdMs: hold duration, default 1000, max 30000)
+     *
+     * @example
+     * ```ts
+     * await page.pressAndHold(400, 300, { holdMs: 5000 });
+     * ```
+     */
+    pressAndHold(x: number, y: number, opts?: {
+        holdMs?: number;
+    }): Promise<void>;
     /**
      * Click an element by its visible text content (no snapshot/ref needed).
      *
@@ -1717,6 +1736,14 @@ declare function getRestoredPageForTarget(opts: {
     targetId?: string;
 }): Promise<Page>;
 
+declare function pressAndHoldViaCdp(opts: {
+    cdpUrl: string;
+    targetId?: string;
+    x: number;
+    y: number;
+    holdMs?: number;
+}): Promise<void>;
+
 /**
  * Comprehensive browser stealth evasions.
  *
@@ -1755,4 +1782,4 @@ declare function waitForChallengeViaPlaywright(opts: {
     pollMs?: number;
 }): Promise<ChallengeWaitResult>;
 
-export { type AriaNode, type AriaSnapshotResult, type BatchAction, type BatchActionResult, BrowserClaw, type BrowserNavigationPolicyOptions, type BrowserNavigationRequestLike, type BrowserTab, BrowserTabNotFoundError, type ChallengeInfo, type ChallengeKind, type ChallengeWaitResult, type ChromeExecutable, type ChromeKind, type ClickOptions, type ColorScheme, type ConnectOptions, type ConsoleMessage, type ContextState, type CookieData, CrawlPage, type DialogEvent, type DialogHandler, type DialogOptions, type DownloadResult, type FormField, type FrameEvalResult, type GeolocationOptions, type HttpCredentials, InvalidBrowserNavigationUrlError, type LaunchOptions, type LookupFn, type NetworkRequest, type PageError, type PinnedHostname, type ResponseBodyResult, type RoleRefInfo, type RoleRefs, STEALTH_SCRIPT, type ScreenshotOptions, type SnapshotOptions, type SnapshotResult, type SnapshotStats, type SsrfPolicy, type StorageKind, type TraceStartOptions, type TypeOptions, type UntrustedContentMeta, type WaitOptions, assertBrowserNavigationAllowed, assertBrowserNavigationRedirectChainAllowed, assertBrowserNavigationResultAllowed, assertSafeUploadPaths, batchViaPlaywright, createPinnedLookup, detectChallengeViaPlaywright, ensureContextState, executeSingleAction, forceDisconnectPlaywrightForTarget, getChromeWebSocketUrl, getRestoredPageForTarget, isChromeCdpReady, isChromeReachable, normalizeCdpHttpBaseForJsonEndpoints, parseRoleRef, requireRef, requireRefOrSelector, requiresInspectableBrowserNavigationRedirects, resolveBoundedDelayMs, resolveInteractionTimeoutMs, resolvePageByTargetIdOrThrow, resolvePinnedHostnameWithPolicy, resolveStrictExistingUploadPaths, sanitizeUntrustedFileName, setDialogHandler, waitForChallengeViaPlaywright, withBrowserNavigationPolicy, withPageScopedCdpClient, withPlaywrightPageCdpSession, writeViaSiblingTempPath };
+export { type AriaNode, type AriaSnapshotResult, type BatchAction, type BatchActionResult, BrowserClaw, type BrowserNavigationPolicyOptions, type BrowserNavigationRequestLike, type BrowserTab, BrowserTabNotFoundError, type ChallengeInfo, type ChallengeKind, type ChallengeWaitResult, type ChromeExecutable, type ChromeKind, type ClickOptions, type ColorScheme, type ConnectOptions, type ConsoleMessage, type ContextState, type CookieData, CrawlPage, type DialogEvent, type DialogHandler, type DialogOptions, type DownloadResult, type FormField, type FrameEvalResult, type GeolocationOptions, type HttpCredentials, InvalidBrowserNavigationUrlError, type LaunchOptions, type LookupFn, type NetworkRequest, type PageError, type PinnedHostname, type ResponseBodyResult, type RoleRefInfo, type RoleRefs, STEALTH_SCRIPT, type ScreenshotOptions, type SnapshotOptions, type SnapshotResult, type SnapshotStats, type SsrfPolicy, type StorageKind, type TraceStartOptions, type TypeOptions, type UntrustedContentMeta, type WaitOptions, assertBrowserNavigationAllowed, assertBrowserNavigationRedirectChainAllowed, assertBrowserNavigationResultAllowed, assertSafeUploadPaths, batchViaPlaywright, createPinnedLookup, detectChallengeViaPlaywright, ensureContextState, executeSingleAction, forceDisconnectPlaywrightForTarget, getChromeWebSocketUrl, getRestoredPageForTarget, isChromeCdpReady, isChromeReachable, normalizeCdpHttpBaseForJsonEndpoints, parseRoleRef, pressAndHoldViaCdp, requireRef, requireRefOrSelector, requiresInspectableBrowserNavigationRedirects, resolveBoundedDelayMs, resolveInteractionTimeoutMs, resolvePageByTargetIdOrThrow, resolvePinnedHostnameWithPolicy, resolveStrictExistingUploadPaths, sanitizeUntrustedFileName, setDialogHandler, waitForChallengeViaPlaywright, withBrowserNavigationPolicy, withPageScopedCdpClient, withPlaywrightPageCdpSession, writeViaSiblingTempPath };

package/dist/index.js

@@ -37,9 +37,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 = {
@@ -1377,6 +1377,7 @@ 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",
@@ -1715,7 +1716,13 @@ function appendCdpPath2(cdpUrl, cdpPath) {
   }
 }
 async function withPlaywrightPageCdpSession(page, fn) {
-  const session = await page.context().newCDPSession(page);
+  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)
+    )
+  ]);
   try {
     return await fn(session);
   } finally {
@@ -3067,6 +3074,25 @@ async function mouseClickViaPlaywright(opts) {
     delay: opts.delayMs
   });
 }
+var MAX_HOLD_MS = 3e4;
+async function pressAndHoldViaCdp(opts) {
+  const holdMs = resolveBoundedDelayMs(opts.holdMs ?? 1e3, "holdMs", MAX_HOLD_MS);
+  const page = await getPageForTargetId({ cdpUrl: opts.cdpUrl, targetId: opts.targetId });
+  ensurePageState(page);
+  const pos = { x: opts.x, y: opts.y };
+  const btn = { button: "left", clickCount: 1 };
+  await withPageScopedCdpClient({
+    cdpUrl: opts.cdpUrl,
+    page,
+    targetId: opts.targetId,
+    fn: async (send) => {
+      await send("Input.dispatchMouseEvent", { type: "mouseMoved", ...pos });
+      await send("Input.dispatchMouseEvent", { type: "mousePressed", ...pos, ...btn });
+      await new Promise((r) => setTimeout(r, holdMs));
+      await send("Input.dispatchMouseEvent", { type: "mouseReleased", ...pos, ...btn });
+    }
+  });
+}
 async function clickByTextViaPlaywright(opts) {
   const page = await getRestoredPageForTarget(opts);
   const timeout = resolveInteractionTimeoutMs(opts.timeoutMs);
@@ -3437,7 +3463,12 @@ async function closePageViaPlaywright(opts) {
   await page.close();
 }
 async function closePageByTargetIdViaPlaywright(opts) {
-  await (await resolvePageByTargetIdOrThrow(opts)).close();
+  try {
+    await (await resolvePageByTargetIdOrThrow(opts)).close();
+  } catch (err) {
+    if (err instanceof BrowserTabNotFoundError) return;
+    throw err;
+  }
 }
 async function focusPageByTargetIdViaPlaywright(opts) {
   const page = await resolvePageByTargetIdOrThrow(opts);
@@ -4915,6 +4946,31 @@ 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 (holdMs: hold duration, default 1000, max 30000)
+   *
+   * @example
+   * ```ts
+   * await page.pressAndHold(400, 300, { holdMs: 5000 });
+   * ```
+   */
+  async pressAndHold(x, y, opts) {
+    return pressAndHoldViaCdp({
+      cdpUrl: this.cdpUrl,
+      targetId: this.targetId,
+      x,
+      y,
+      holdMs: opts?.holdMs
+    });
+  }
   /**
    * Click an element by its visible text content (no snapshot/ref needed).
    *
@@ -6055,6 +6111,6 @@ var BrowserClaw = class _BrowserClaw {
   }
 };
 
-export { BrowserClaw, BrowserTabNotFoundError, CrawlPage, InvalidBrowserNavigationUrlError, STEALTH_SCRIPT, assertBrowserNavigationAllowed, assertBrowserNavigationRedirectChainAllowed, assertBrowserNavigationResultAllowed, assertSafeUploadPaths, batchViaPlaywright, createPinnedLookup, detectChallengeViaPlaywright, ensureContextState, executeSingleAction, forceDisconnectPlaywrightForTarget, getChromeWebSocketUrl, getRestoredPageForTarget, isChromeCdpReady, isChromeReachable, normalizeCdpHttpBaseForJsonEndpoints, parseRoleRef, requireRef, requireRefOrSelector, requiresInspectableBrowserNavigationRedirects, resolveBoundedDelayMs, resolveInteractionTimeoutMs, resolvePageByTargetIdOrThrow, resolvePinnedHostnameWithPolicy, resolveStrictExistingUploadPaths, sanitizeUntrustedFileName, setDialogHandler, waitForChallengeViaPlaywright, withBrowserNavigationPolicy, withPageScopedCdpClient, withPlaywrightPageCdpSession, writeViaSiblingTempPath };
+export { BrowserClaw, BrowserTabNotFoundError, CrawlPage, InvalidBrowserNavigationUrlError, STEALTH_SCRIPT, assertBrowserNavigationAllowed, assertBrowserNavigationRedirectChainAllowed, assertBrowserNavigationResultAllowed, assertSafeUploadPaths, batchViaPlaywright, createPinnedLookup, detectChallengeViaPlaywright, ensureContextState, executeSingleAction, forceDisconnectPlaywrightForTarget, getChromeWebSocketUrl, getRestoredPageForTarget, isChromeCdpReady, isChromeReachable, normalizeCdpHttpBaseForJsonEndpoints, parseRoleRef, pressAndHoldViaCdp, requireRef, requireRefOrSelector, requiresInspectableBrowserNavigationRedirects, resolveBoundedDelayMs, resolveInteractionTimeoutMs, resolvePageByTargetIdOrThrow, resolvePinnedHostnameWithPolicy, resolveStrictExistingUploadPaths, sanitizeUntrustedFileName, setDialogHandler, waitForChallengeViaPlaywright, withBrowserNavigationPolicy, withPageScopedCdpClient, withPlaywrightPageCdpSession, writeViaSiblingTempPath };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map