browser-pilot 0.0.7 → 0.0.8

package/dist/{types-TVlTA7nH.d.cts → types-DklIxnbO.d.cts}

@@ -189,9 +189,25 @@ interface InteractiveElement {
     /** Whether the element is disabled */
     disabled?: boolean;
 }
+interface FailureHint {
+    /** Suggested selector */
+    selector: string;
+    /** Why this might work */
+    reason: string;
+    /** Confidence level */
+    confidence: 'high' | 'medium' | 'low';
+    /** Element info */
+    element: {
+        ref: string;
+        role: string;
+        name: string;
+        disabled?: boolean;
+    };
+}
 declare class ElementNotFoundError extends Error {
     selectors: string[];
-    constructor(selectors: string | string[]);
+    hints?: FailureHint[];
+    constructor(selectors: string | string[], hints?: FailureHint[]);
 }
 declare class TimeoutError extends Error {
     constructor(message?: string);
@@ -466,6 +482,7 @@ interface ClearCookiesOptions {
 
 declare class Page {
     private cdp;
+    private _targetId;
     private rootNodeId;
     private batchExecutor;
     private emulationState;
@@ -484,12 +501,23 @@ declare class Page {
     private frameExecutionContexts;
     /** Current frame's execution context ID (null = main frame default) */
     private currentFrameContextId;
-    constructor(cdp: CDPClient);
+    /** Last matched selector from findElement (for selectorUsed tracking) */
+    private _lastMatchedSelector;
+    constructor(cdp: CDPClient, targetId: string);
+    /**
+     * Get the CDP target ID for this page
+     */
+    get targetId(): string;
     /**
      * Get the underlying CDP client for advanced operations.
      * Use with caution - prefer high-level Page methods when possible.
      */
     get cdpClient(): CDPClient;
+    /**
+     * Get the last matched selector from findElement (for selectorUsed tracking).
+     * Returns undefined if no selector has been matched yet.
+     */
+    getLastMatchedSelector(): string | undefined;
     /**
      * Initialize the page (enable required CDP domains)
      */
@@ -557,6 +585,9 @@ declare class Page {
      * - 'auto' (default): Attempt to detect navigation for 1 second, then assume client-side handling
      * - true: Wait for full navigation (traditional forms)
      * - false: Return immediately (AJAX forms where you'll wait for something else)
+     *
+     * When targeting a <form> element directly, uses form.requestSubmit() which fires
+     * the submit event and triggers HTML5 validation.
      */
     submit(selector: string | string[], options?: SubmitOptions): Promise<boolean>;
     /**
@@ -851,6 +882,7 @@ declare class Page {
 /**
  * Action/Step types for batch execution
  */
+
 type ActionType = 'goto' | 'click' | 'fill' | 'type' | 'select' | 'check' | 'uncheck' | 'submit' | 'press' | 'focus' | 'hover' | 'scroll' | 'wait' | 'snapshot' | 'screenshot' | 'evaluate' | 'text' | 'switchFrame' | 'switchToMain';
 interface Step {
     /** Action type */
@@ -927,6 +959,8 @@ interface StepResult {
     result?: unknown;
     /** Text content (for text action) */
     text?: string;
+    /** Failure hints when element not found */
+    hints?: FailureHint[];
 }
 interface BatchResult {
     /** Whether all steps succeeded */
@@ -939,4 +973,4 @@ interface BatchResult {
     totalDurationMs: number;
 }
 
-export { type WaitResult as $, type ActionType as A, type BatchOptions as B, type ConsoleHandler as C, type Dialog as D, type ElementInfo as E, type FileInput as F, type GeolocationOptions as G, type FailRequestOptions as H, type InteractiveElement as I, type FulfillRequestOptions as J, type InterceptedRequest as K, type RequestActions as L, type ResourceType as M, NavigationError as N, type RouteOptions as O, Page as P, type ClearCookiesOptions as Q, type RequestPattern as R, type Step as S, TimeoutError as T, type UserAgentMetadata as U, type ViewportOptions as V, type WaitForOptions as W, type Cookie as X, type DeleteCookieOptions as Y, type SetCookieOptions as Z, type WaitOptions as _, type RequestHandler as a, type WaitState as a0, waitForAnyElement as a1, waitForElement as a2, waitForNavigation as a3, waitForNetworkIdle as a4, type BatchResult as b, type StepResult as c, type ActionOptions as d, type ActionResult as e, type ConsoleMessage as f, type ConsoleMessageType as g, type CustomSelectConfig as h, type DialogHandler as i, type DialogType as j, type Download as k, ElementNotFoundError as l, type EmulationState as m, type ErrorHandler as n, type FillOptions as o, type NetworkIdleOptions as p, type PageError as q, type PageSnapshot as r, type SnapshotNode as s, type SubmitOptions as t, type TypeOptions as u, type UserAgentOptions as v, type DeviceDescriptor as w, type DeviceName as x, devices as y, type ContinueRequestOptions as z };
+export { type WaitResult as $, type ActionType as A, type BatchOptions as B, type ConsoleHandler as C, type Dialog as D, type ElementInfo as E, type FileInput as F, type GeolocationOptions as G, type FailRequestOptions as H, type InteractiveElement as I, type FulfillRequestOptions as J, type InterceptedRequest as K, type RequestActions as L, type ResourceType as M, NavigationError as N, type RouteOptions as O, Page as P, type ClearCookiesOptions as Q, type RequestPattern as R, type Step as S, TimeoutError as T, type UserAgentMetadata as U, type ViewportOptions as V, type WaitForOptions as W, type Cookie as X, type DeleteCookieOptions as Y, type SetCookieOptions as Z, type WaitOptions as _, type RequestHandler as a, type WaitState as a0, waitForAnyElement as a1, waitForElement as a2, waitForNavigation as a3, waitForNetworkIdle as a4, type FailureHint as a5, type BatchResult as b, type StepResult as c, type ActionOptions as d, type ActionResult as e, type ConsoleMessage as f, type ConsoleMessageType as g, type CustomSelectConfig as h, type DialogHandler as i, type DialogType as j, type Download as k, ElementNotFoundError as l, type EmulationState as m, type ErrorHandler as n, type FillOptions as o, type NetworkIdleOptions as p, type PageError as q, type PageSnapshot as r, type SnapshotNode as s, type SubmitOptions as t, type TypeOptions as u, type UserAgentOptions as v, type DeviceDescriptor as w, type DeviceName as x, devices as y, type ContinueRequestOptions as z };

package/dist/{types-CbdmaocU.d.ts → types-Pv8KzZ6l.d.ts}

@@ -189,9 +189,25 @@ interface InteractiveElement {
     /** Whether the element is disabled */
     disabled?: boolean;
 }
+interface FailureHint {
+    /** Suggested selector */
+    selector: string;
+    /** Why this might work */
+    reason: string;
+    /** Confidence level */
+    confidence: 'high' | 'medium' | 'low';
+    /** Element info */
+    element: {
+        ref: string;
+        role: string;
+        name: string;
+        disabled?: boolean;
+    };
+}
 declare class ElementNotFoundError extends Error {
     selectors: string[];
-    constructor(selectors: string | string[]);
+    hints?: FailureHint[];
+    constructor(selectors: string | string[], hints?: FailureHint[]);
 }
 declare class TimeoutError extends Error {
     constructor(message?: string);
@@ -466,6 +482,7 @@ interface ClearCookiesOptions {
 
 declare class Page {
     private cdp;
+    private _targetId;
     private rootNodeId;
     private batchExecutor;
     private emulationState;
@@ -484,12 +501,23 @@ declare class Page {
     private frameExecutionContexts;
     /** Current frame's execution context ID (null = main frame default) */
     private currentFrameContextId;
-    constructor(cdp: CDPClient);
+    /** Last matched selector from findElement (for selectorUsed tracking) */
+    private _lastMatchedSelector;
+    constructor(cdp: CDPClient, targetId: string);
+    /**
+     * Get the CDP target ID for this page
+     */
+    get targetId(): string;
     /**
      * Get the underlying CDP client for advanced operations.
      * Use with caution - prefer high-level Page methods when possible.
      */
     get cdpClient(): CDPClient;
+    /**
+     * Get the last matched selector from findElement (for selectorUsed tracking).
+     * Returns undefined if no selector has been matched yet.
+     */
+    getLastMatchedSelector(): string | undefined;
     /**
      * Initialize the page (enable required CDP domains)
      */
@@ -557,6 +585,9 @@ declare class Page {
      * - 'auto' (default): Attempt to detect navigation for 1 second, then assume client-side handling
      * - true: Wait for full navigation (traditional forms)
      * - false: Return immediately (AJAX forms where you'll wait for something else)
+     *
+     * When targeting a <form> element directly, uses form.requestSubmit() which fires
+     * the submit event and triggers HTML5 validation.
      */
     submit(selector: string | string[], options?: SubmitOptions): Promise<boolean>;
     /**
@@ -851,6 +882,7 @@ declare class Page {
 /**
  * Action/Step types for batch execution
  */
+
 type ActionType = 'goto' | 'click' | 'fill' | 'type' | 'select' | 'check' | 'uncheck' | 'submit' | 'press' | 'focus' | 'hover' | 'scroll' | 'wait' | 'snapshot' | 'screenshot' | 'evaluate' | 'text' | 'switchFrame' | 'switchToMain';
 interface Step {
     /** Action type */
@@ -927,6 +959,8 @@ interface StepResult {
     result?: unknown;
     /** Text content (for text action) */
     text?: string;
+    /** Failure hints when element not found */
+    hints?: FailureHint[];
 }
 interface BatchResult {
     /** Whether all steps succeeded */
@@ -939,4 +973,4 @@ interface BatchResult {
     totalDurationMs: number;
 }
 
-export { type WaitResult as $, type ActionType as A, type BatchOptions as B, type ConsoleHandler as C, type Dialog as D, type ElementInfo as E, type FileInput as F, type GeolocationOptions as G, type FailRequestOptions as H, type InteractiveElement as I, type FulfillRequestOptions as J, type InterceptedRequest as K, type RequestActions as L, type ResourceType as M, NavigationError as N, type RouteOptions as O, Page as P, type ClearCookiesOptions as Q, type RequestPattern as R, type Step as S, TimeoutError as T, type UserAgentMetadata as U, type ViewportOptions as V, type WaitForOptions as W, type Cookie as X, type DeleteCookieOptions as Y, type SetCookieOptions as Z, type WaitOptions as _, type RequestHandler as a, type WaitState as a0, waitForAnyElement as a1, waitForElement as a2, waitForNavigation as a3, waitForNetworkIdle as a4, type BatchResult as b, type StepResult as c, type ActionOptions as d, type ActionResult as e, type ConsoleMessage as f, type ConsoleMessageType as g, type CustomSelectConfig as h, type DialogHandler as i, type DialogType as j, type Download as k, ElementNotFoundError as l, type EmulationState as m, type ErrorHandler as n, type FillOptions as o, type NetworkIdleOptions as p, type PageError as q, type PageSnapshot as r, type SnapshotNode as s, type SubmitOptions as t, type TypeOptions as u, type UserAgentOptions as v, type DeviceDescriptor as w, type DeviceName as x, devices as y, type ContinueRequestOptions as z };
+export { type WaitResult as $, type ActionType as A, type BatchOptions as B, type ConsoleHandler as C, type Dialog as D, type ElementInfo as E, type FileInput as F, type GeolocationOptions as G, type FailRequestOptions as H, type InteractiveElement as I, type FulfillRequestOptions as J, type InterceptedRequest as K, type RequestActions as L, type ResourceType as M, NavigationError as N, type RouteOptions as O, Page as P, type ClearCookiesOptions as Q, type RequestPattern as R, type Step as S, TimeoutError as T, type UserAgentMetadata as U, type ViewportOptions as V, type WaitForOptions as W, type Cookie as X, type DeleteCookieOptions as Y, type SetCookieOptions as Z, type WaitOptions as _, type RequestHandler as a, type WaitState as a0, waitForAnyElement as a1, waitForElement as a2, waitForNavigation as a3, waitForNetworkIdle as a4, type FailureHint as a5, type BatchResult as b, type StepResult as c, type ActionOptions as d, type ActionResult as e, type ConsoleMessage as f, type ConsoleMessageType as g, type CustomSelectConfig as h, type DialogHandler as i, type DialogType as j, type Download as k, ElementNotFoundError as l, type EmulationState as m, type ErrorHandler as n, type FillOptions as o, type NetworkIdleOptions as p, type PageError as q, type PageSnapshot as r, type SnapshotNode as s, type SubmitOptions as t, type TypeOptions as u, type UserAgentOptions as v, type DeviceDescriptor as w, type DeviceName as x, devices as y, type ContinueRequestOptions as z };

package/package.json

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