browser-pilot 0.0.10 → 0.0.11

package/dist/index.d.cts

@@ -1,9 +1,9 @@
 export { BatchExecutor, ValidationError, ValidationResult, addBatchToPage, validateSteps } from './actions.cjs';
-import { R as RequestPattern, a as RequestHandler, C as CaptureResult } from './types-CYw-7vx1.cjs';
-export { k as ActionOptions, l as ActionResult, A as ActionType, d as AudioChunk, e as AudioInput, f as AudioInputState, g as AudioOutput, B as BatchOptions, b as BatchResult, h as CaptureOptions, a3 as ClearCookiesOptions, m as ConsoleHandler, n as ConsoleMessage, o as ConsoleMessageType, Y as ContinueRequestOptions, a4 as Cookie, p as CustomSelectConfig, a5 as DeleteCookieOptions, O as DeviceDescriptor, Q as DeviceName, D as Dialog, q as DialogHandler, r as DialogType, s as Download, E as ElementInfo, t as ElementNotFoundError, u as EmulationState, v as ErrorHandler, Z as FailRequestOptions, F as FileInput, w as FillOptions, _ as FulfillRequestOptions, G as GeolocationOptions, I as InteractiveElement, $ as InterceptedRequest, N as NavigationError, x as NetworkIdleOptions, y as Page, z as PageError, H as PageSnapshot, P as PlayOptions, a0 as RequestActions, a1 as ResourceType, i as RoundTripOptions, j as RoundTripResult, a2 as RouteOptions, a6 as SetCookieOptions, J as SnapshotNode, S as Step, c as StepResult, K as SubmitOptions, T as TimeoutError, L as TypeOptions, U as UserAgentMetadata, M as UserAgentOptions, V as ViewportOptions, W as WaitForOptions, a7 as WaitOptions, a8 as WaitResult, a9 as WaitState, X as devices, aa as waitForAnyElement, ab as waitForElement, ac as waitForNavigation, ad as waitForNetworkIdle } from './types-CYw-7vx1.cjs';
+import { R as RequestPattern, a as RequestHandler, C as CaptureResult } from './types-GWuQJs_e.cjs';
+export { k as ActionOptions, l as ActionResult, A as ActionType, d as AudioChunk, e as AudioInput, f as AudioInputState, g as AudioOutput, B as BatchOptions, b as BatchResult, h as CaptureOptions, a3 as ClearCookiesOptions, m as ConsoleHandler, n as ConsoleMessage, o as ConsoleMessageType, Y as ContinueRequestOptions, a4 as Cookie, p as CustomSelectConfig, a5 as DeleteCookieOptions, O as DeviceDescriptor, Q as DeviceName, D as Dialog, q as DialogHandler, r as DialogType, s as Download, E as ElementInfo, t as ElementNotFoundError, u as EmulationState, v as ErrorHandler, Z as FailRequestOptions, F as FileInput, w as FillOptions, _ as FulfillRequestOptions, G as GeolocationOptions, I as InteractiveElement, $ as InterceptedRequest, N as NavigationError, x as NetworkIdleOptions, y as Page, z as PageError, H as PageSnapshot, P as PlayOptions, a0 as RequestActions, a1 as ResourceType, i as RoundTripOptions, j as RoundTripResult, a2 as RouteOptions, a6 as SetCookieOptions, J as SnapshotNode, S as Step, c as StepResult, K as SubmitOptions, T as TimeoutError, L as TypeOptions, U as UserAgentMetadata, M as UserAgentOptions, V as ViewportOptions, W as WaitForOptions, a7 as WaitOptions, a8 as WaitResult, a9 as WaitState, X as devices, aa as waitForAnyElement, ab as waitForElement, ac as waitForNavigation, ad as waitForNetworkIdle } from './types-GWuQJs_e.cjs';
 import { C as CDPClient } from './client-7Nqka5MV.cjs';
 export { a as CDPClientOptions, c as createCDPClient } from './client-7Nqka5MV.cjs';
-export { Browser, BrowserOptions, connect } from './browser.cjs';
+export { Browser, BrowserOptions, PageOptions, connect } from './browser.cjs';
 export { CDPError } from './cdp.cjs';
 export { BrowserBaseProvider, BrowserlessProvider, GenericProvider, createProvider, discoverTargets, getBrowserWebSocketUrl } from './providers.cjs';
 export { b as ConnectOptions, C as CreateSessionOptions, P as Provider, a as ProviderSession } from './types--wXNHUwt.cjs';

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 export { BatchExecutor, ValidationError, ValidationResult, addBatchToPage, validateSteps } from './actions.js';
-import { R as RequestPattern, a as RequestHandler, C as CaptureResult } from './types-DOGsEYQa.js';
-export { k as ActionOptions, l as ActionResult, A as ActionType, d as AudioChunk, e as AudioInput, f as AudioInputState, g as AudioOutput, B as BatchOptions, b as BatchResult, h as CaptureOptions, a3 as ClearCookiesOptions, m as ConsoleHandler, n as ConsoleMessage, o as ConsoleMessageType, Y as ContinueRequestOptions, a4 as Cookie, p as CustomSelectConfig, a5 as DeleteCookieOptions, O as DeviceDescriptor, Q as DeviceName, D as Dialog, q as DialogHandler, r as DialogType, s as Download, E as ElementInfo, t as ElementNotFoundError, u as EmulationState, v as ErrorHandler, Z as FailRequestOptions, F as FileInput, w as FillOptions, _ as FulfillRequestOptions, G as GeolocationOptions, I as InteractiveElement, $ as InterceptedRequest, N as NavigationError, x as NetworkIdleOptions, y as Page, z as PageError, H as PageSnapshot, P as PlayOptions, a0 as RequestActions, a1 as ResourceType, i as RoundTripOptions, j as RoundTripResult, a2 as RouteOptions, a6 as SetCookieOptions, J as SnapshotNode, S as Step, c as StepResult, K as SubmitOptions, T as TimeoutError, L as TypeOptions, U as UserAgentMetadata, M as UserAgentOptions, V as ViewportOptions, W as WaitForOptions, a7 as WaitOptions, a8 as WaitResult, a9 as WaitState, X as devices, aa as waitForAnyElement, ab as waitForElement, ac as waitForNavigation, ad as waitForNetworkIdle } from './types-DOGsEYQa.js';
+import { R as RequestPattern, a as RequestHandler, C as CaptureResult } from './types-DtGF3yGl.js';
+export { k as ActionOptions, l as ActionResult, A as ActionType, d as AudioChunk, e as AudioInput, f as AudioInputState, g as AudioOutput, B as BatchOptions, b as BatchResult, h as CaptureOptions, a3 as ClearCookiesOptions, m as ConsoleHandler, n as ConsoleMessage, o as ConsoleMessageType, Y as ContinueRequestOptions, a4 as Cookie, p as CustomSelectConfig, a5 as DeleteCookieOptions, O as DeviceDescriptor, Q as DeviceName, D as Dialog, q as DialogHandler, r as DialogType, s as Download, E as ElementInfo, t as ElementNotFoundError, u as EmulationState, v as ErrorHandler, Z as FailRequestOptions, F as FileInput, w as FillOptions, _ as FulfillRequestOptions, G as GeolocationOptions, I as InteractiveElement, $ as InterceptedRequest, N as NavigationError, x as NetworkIdleOptions, y as Page, z as PageError, H as PageSnapshot, P as PlayOptions, a0 as RequestActions, a1 as ResourceType, i as RoundTripOptions, j as RoundTripResult, a2 as RouteOptions, a6 as SetCookieOptions, J as SnapshotNode, S as Step, c as StepResult, K as SubmitOptions, T as TimeoutError, L as TypeOptions, U as UserAgentMetadata, M as UserAgentOptions, V as ViewportOptions, W as WaitForOptions, a7 as WaitOptions, a8 as WaitResult, a9 as WaitState, X as devices, aa as waitForAnyElement, ab as waitForElement, ac as waitForNavigation, ad as waitForNetworkIdle } from './types-DtGF3yGl.js';
 import { C as CDPClient } from './client-7Nqka5MV.js';
 export { a as CDPClientOptions, c as createCDPClient } from './client-7Nqka5MV.js';
-export { Browser, BrowserOptions, connect } from './browser.js';
+export { Browser, BrowserOptions, PageOptions, connect } from './browser.js';
 export { CDPError } from './cdp.js';
 export { BrowserBaseProvider, BrowserlessProvider, GenericProvider, createProvider, discoverTargets, getBrowserWebSocketUrl } from './providers.js';
 export { b as ConnectOptions, C as CreateSessionOptions, P as Provider, a as ProviderSession } from './types--wXNHUwt.js';

package/dist/index.mjs

@@ -16,7 +16,7 @@ import {
   waitForElement,
   waitForNavigation,
   waitForNetworkIdle
-} from "./chunk-7OSR2CAE.mjs";
+} from "./chunk-JHAF52FA.mjs";
 import {
   CDPError,
   createCDPClient
@@ -28,7 +28,7 @@ import {
   createProvider,
   discoverTargets,
   getBrowserWebSocketUrl
-} from "./chunk-R3PS4PCM.mjs";
+} from "./chunk-BRAFQUMG.mjs";
 import {
   BatchExecutor,
   ElementNotFoundError,
@@ -36,7 +36,7 @@ import {
   TimeoutError,
   addBatchToPage,
   validateSteps
-} from "./chunk-KKW2SZLV.mjs";
+} from "./chunk-FAUNIZR7.mjs";
 
 // src/audio/flags.ts
 function getAudioChromeFlags(options) {

package/dist/providers.cjs

@@ -160,6 +160,34 @@ var BrowserlessProvider = class {
 };
 
 // src/providers/generic.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function fetchDevToolsJson(host, path, errorPrefix, options = {}) {
+  const protocol = host.includes("://") ? "" : "http://";
+  const attempts = options.attempts ?? 1;
+  let delayMs = options.initialDelayMs ?? 50;
+  const maxDelayMs = options.maxDelayMs ?? 250;
+  let lastError;
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    try {
+      const response = await fetch(`${protocol}${host}${path}`);
+      if (response.ok) {
+        return await response.json();
+      }
+      lastError = new Error(`${errorPrefix}: ${response.status}`);
+    } catch (error) {
+      lastError = new Error(
+        `${errorPrefix}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+    if (attempt < attempts) {
+      await sleep(delayMs);
+      delayMs = Math.min(delayMs * 2, maxDelayMs);
+    }
+  }
+  throw lastError ?? new Error(errorPrefix);
+}
 var GenericProvider = class {
   name = "generic";
   wsUrl;
@@ -178,20 +206,14 @@ var GenericProvider = class {
   }
 };
 async function discoverTargets(host = "localhost:9222") {
-  const protocol = host.includes("://") ? "" : "http://";
-  const response = await fetch(`${protocol}${host}/json/list`);
-  if (!response.ok) {
-    throw new Error(`Failed to discover targets: ${response.status}`);
-  }
-  return await response.json();
+  return fetchDevToolsJson(host, "/json/list", "Failed to discover targets");
 }
 async function getBrowserWebSocketUrl(host = "localhost:9222") {
-  const protocol = host.includes("://") ? "" : "http://";
-  const response = await fetch(`${protocol}${host}/json/version`);
-  if (!response.ok) {
-    throw new Error(`Failed to get browser info: ${response.status}`);
-  }
-  const info = await response.json();
+  const info = await fetchDevToolsJson(host, "/json/version", "Failed to get browser info", {
+    attempts: 10,
+    initialDelayMs: 50,
+    maxDelayMs: 250
+  });
   return info.webSocketDebuggerUrl;
 }
 

package/dist/providers.mjs

@@ -5,7 +5,7 @@ import {
   createProvider,
   discoverTargets,
   getBrowserWebSocketUrl
-} from "./chunk-R3PS4PCM.mjs";
+} from "./chunk-BRAFQUMG.mjs";
 export {
   BrowserBaseProvider,
   BrowserlessProvider,

package/dist/{types-DOGsEYQa.d.ts → types-DtGF3yGl.d.ts}

@@ -270,10 +270,10 @@ interface ActionOptions {
     optional?: boolean;
 }
 interface FillOptions extends ActionOptions {
-    /** Clear existing content before filling */
-    clear?: boolean;
     /** Trigger blur after filling (useful for React/Vue frameworks that update on blur) */
     blur?: boolean;
+    /** Verify value stuck after fill; falls back to char-by-char typing if not (default: true) */
+    verify?: boolean;
 }
 interface TypeOptions extends ActionOptions {
     /** Delay between keystrokes in ms */
@@ -707,6 +707,8 @@ declare class Page {
     private currentFrameContextId;
     /** Last matched selector from findElement (for selectorUsed tracking) */
     private _lastMatchedSelector;
+    /** Last snapshot for stale ref recovery */
+    private lastSnapshot?;
     /** Audio input controller (lazy-initialized) */
     private _audioInput?;
     /** Audio output controller (lazy-initialized) */
@@ -730,6 +732,7 @@ declare class Page {
      * Initialize the page (enable required CDP domains)
      */
     init(): Promise<void>;
+    private installEventListenerTracker;
     /**
      * Navigate to a URL
      */
@@ -757,8 +760,9 @@ declare class Page {
     /**
      * Click an element (supports multi-selector)
      *
-     * Uses CDP mouse events for regular elements. For form submit buttons,
-     * uses dispatchEvent to reliably trigger form submission in headless Chrome.
+     * Uses CDP mouse events (mouseMoved + mousePressed + mouseReleased) to
+     * simulate a real click. Real mouse events on submit buttons naturally
+     * trigger native form submission — no JS dispatch needed.
      */
     click(selector: string | string[], options?: ActionOptions): Promise<boolean>;
     /**
@@ -767,6 +771,10 @@ declare class Page {
     fill(selector: string | string[], value: string, options?: FillOptions): Promise<boolean>;
     /**
      * Type text character by character (for autocomplete fields, etc.)
+     *
+     * Uses proper keyDown/rawKeyDown distinction with US keyboard layout.
+     * Printable chars use 'keyDown' with text, non-text keys use 'rawKeyDown',
+     * and non-layout chars (emoji, CJK) fall back to Input.insertText.
      */
     type(selector: string | string[], text: string, options?: TypeOptions): Promise<boolean>;
     /**
@@ -779,11 +787,13 @@ declare class Page {
      */
     private selectCustom;
     /**
-     * Check a checkbox or radio button
+     * Check a checkbox or radio button using real mouse click.
+     * No-op if already checked. Verifies state changed after click.
      */
     check(selector: string | string[], options?: ActionOptions): Promise<boolean>;
     /**
-     * Uncheck a checkbox
+     * Uncheck a checkbox using real mouse click.
+     * No-op if already unchecked. Radio buttons can't be unchecked (returns true).
      */
     uncheck(selector: string | string[], options?: ActionOptions): Promise<boolean>;
     /**
@@ -864,6 +874,17 @@ declare class Page {
      * Set files on a file input
      */
     setInputFiles(selector: string | string[], files: FileInput[], options?: ActionOptions): Promise<boolean>;
+    private getNativeSelectMetadata;
+    private readNativeSelectValues;
+    private selectValuesMatch;
+    private applyNativeSelectByKeyboard;
+    private applyNativeSelectFallback;
+    private selectEditableContent;
+    private clearEditableSelection;
+    private readEditableValue;
+    private typeEditableFallback;
+    private applyRecordedSelectFallback;
+    private invokeRecordedEventListeners;
     /**
      * Wait for a download to complete, triggered by an action
      */
@@ -1082,9 +1103,18 @@ declare class Page {
      */
     private getBoxModel;
     /**
-     * Click an element by node ID
+     * Click an element by node ID using Playwright's 3-event sequence:
+     * mouseMoved → mousePressed → mouseReleased (sequential).
+     * Uses DOM.getContentQuads for accurate coordinates (handles CSS transforms).
+     * Falls back to JS this.click() if CDP mouse dispatch fails.
      */
     private clickElement;
+    /**
+     * Resolve a nodeId to a Remote Object ID for use with Runtime.callFunctionOn
+     */
+    private resolveObjectId;
+    private dispatchKeyDefinition;
+    private dispatchKey;
     /**
      * Audio input controller (fake microphone).
      * Lazy-initialized on first access.
@@ -1146,14 +1176,12 @@ interface Step {
     optional?: boolean;
     /** Submit method */
     method?: 'enter' | 'click' | 'enter+click';
-    /** Clear input before filling */
-    clear?: boolean;
     /** Trigger blur after filling (for React/Vue frameworks) */
     blur?: boolean;
     /** Delay between keystrokes for type action */
     delay?: number;
-    /** Wait for navigation after click action completes */
-    waitForNavigation?: boolean;
+    /** Wait mode after click/submit: true, false, or 'auto' for submit heuristics */
+    waitForNavigation?: boolean | 'auto';
     /** Custom select: trigger selector */
     trigger?: string | string[];
     /** Custom select: option selector */

package/dist/{types-CYw-7vx1.d.cts → types-GWuQJs_e.d.cts}

@@ -270,10 +270,10 @@ interface ActionOptions {
     optional?: boolean;
 }
 interface FillOptions extends ActionOptions {
-    /** Clear existing content before filling */
-    clear?: boolean;
     /** Trigger blur after filling (useful for React/Vue frameworks that update on blur) */
     blur?: boolean;
+    /** Verify value stuck after fill; falls back to char-by-char typing if not (default: true) */
+    verify?: boolean;
 }
 interface TypeOptions extends ActionOptions {
     /** Delay between keystrokes in ms */
@@ -707,6 +707,8 @@ declare class Page {
     private currentFrameContextId;
     /** Last matched selector from findElement (for selectorUsed tracking) */
     private _lastMatchedSelector;
+    /** Last snapshot for stale ref recovery */
+    private lastSnapshot?;
     /** Audio input controller (lazy-initialized) */
     private _audioInput?;
     /** Audio output controller (lazy-initialized) */
@@ -730,6 +732,7 @@ declare class Page {
      * Initialize the page (enable required CDP domains)
      */
     init(): Promise<void>;
+    private installEventListenerTracker;
     /**
      * Navigate to a URL
      */
@@ -757,8 +760,9 @@ declare class Page {
     /**
      * Click an element (supports multi-selector)
      *
-     * Uses CDP mouse events for regular elements. For form submit buttons,
-     * uses dispatchEvent to reliably trigger form submission in headless Chrome.
+     * Uses CDP mouse events (mouseMoved + mousePressed + mouseReleased) to
+     * simulate a real click. Real mouse events on submit buttons naturally
+     * trigger native form submission — no JS dispatch needed.
      */
     click(selector: string | string[], options?: ActionOptions): Promise<boolean>;
     /**
@@ -767,6 +771,10 @@ declare class Page {
     fill(selector: string | string[], value: string, options?: FillOptions): Promise<boolean>;
     /**
      * Type text character by character (for autocomplete fields, etc.)
+     *
+     * Uses proper keyDown/rawKeyDown distinction with US keyboard layout.
+     * Printable chars use 'keyDown' with text, non-text keys use 'rawKeyDown',
+     * and non-layout chars (emoji, CJK) fall back to Input.insertText.
      */
     type(selector: string | string[], text: string, options?: TypeOptions): Promise<boolean>;
     /**
@@ -779,11 +787,13 @@ declare class Page {
      */
     private selectCustom;
     /**
-     * Check a checkbox or radio button
+     * Check a checkbox or radio button using real mouse click.
+     * No-op if already checked. Verifies state changed after click.
      */
     check(selector: string | string[], options?: ActionOptions): Promise<boolean>;
     /**
-     * Uncheck a checkbox
+     * Uncheck a checkbox using real mouse click.
+     * No-op if already unchecked. Radio buttons can't be unchecked (returns true).
      */
     uncheck(selector: string | string[], options?: ActionOptions): Promise<boolean>;
     /**
@@ -864,6 +874,17 @@ declare class Page {
      * Set files on a file input
      */
     setInputFiles(selector: string | string[], files: FileInput[], options?: ActionOptions): Promise<boolean>;
+    private getNativeSelectMetadata;
+    private readNativeSelectValues;
+    private selectValuesMatch;
+    private applyNativeSelectByKeyboard;
+    private applyNativeSelectFallback;
+    private selectEditableContent;
+    private clearEditableSelection;
+    private readEditableValue;
+    private typeEditableFallback;
+    private applyRecordedSelectFallback;
+    private invokeRecordedEventListeners;
     /**
      * Wait for a download to complete, triggered by an action
      */
@@ -1082,9 +1103,18 @@ declare class Page {
      */
     private getBoxModel;
     /**
-     * Click an element by node ID
+     * Click an element by node ID using Playwright's 3-event sequence:
+     * mouseMoved → mousePressed → mouseReleased (sequential).
+     * Uses DOM.getContentQuads for accurate coordinates (handles CSS transforms).
+     * Falls back to JS this.click() if CDP mouse dispatch fails.
      */
     private clickElement;
+    /**
+     * Resolve a nodeId to a Remote Object ID for use with Runtime.callFunctionOn
+     */
+    private resolveObjectId;
+    private dispatchKeyDefinition;
+    private dispatchKey;
     /**
      * Audio input controller (fake microphone).
      * Lazy-initialized on first access.
@@ -1146,14 +1176,12 @@ interface Step {
     optional?: boolean;
     /** Submit method */
     method?: 'enter' | 'click' | 'enter+click';
-    /** Clear input before filling */
-    clear?: boolean;
     /** Trigger blur after filling (for React/Vue frameworks) */
     blur?: boolean;
     /** Delay between keystrokes for type action */
     delay?: number;
-    /** Wait for navigation after click action completes */
-    waitForNavigation?: boolean;
+    /** Wait mode after click/submit: true, false, or 'auto' for submit heuristics */
+    waitForNavigation?: boolean | 'auto';
     /** Custom select: trigger selector */
     trigger?: string | string[];
     /** Custom select: option selector */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-pilot",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Lightweight CDP-based browser automation for Node.js, Bun, and Cloudflare Workers",
   "type": "module",
   "main": "./dist/index.cjs",