browserclaw 0.7.0 → 0.8.0

package/dist/index.d.cts

@@ -195,6 +195,17 @@ interface LaunchOptions {
      * @deprecated Use `ssrfPolicy: { dangerouslyAllowPrivateNetwork: true }` instead.
      */
     allowInternal?: boolean;
+    /**
+     * Record video for all pages. Requires a directory to save video files.
+     * Videos are saved when the page or context is closed.
+     */
+    recordVideo?: {
+        dir: string;
+        size?: {
+            width: number;
+            height: number;
+        };
+    };
 }
 /** Options for connecting to an existing browser instance. */
 interface ConnectOptions {
@@ -215,6 +226,17 @@ interface ConnectOptions {
      * (e.g. OpenClaw browser control with gateway.auth.token).
      */
     authToken?: string;
+    /**
+     * Record video for all pages. Requires a directory to save video files.
+     * Videos are saved when the page or context is closed.
+     */
+    recordVideo?: {
+        dir: string;
+        size?: {
+            width: number;
+            height: number;
+        };
+    };
 }
 /**
  * Describes a single interactive element found during a snapshot.
@@ -644,6 +666,68 @@ declare class CrawlPage {
      * ```
      */
     click(ref: string, opts?: ClickOptions): Promise<void>;
+    /**
+     * Click at specific page coordinates.
+     *
+     * Useful for canvas elements, custom widgets, or elements without ARIA roles.
+     *
+     * @param x - X coordinate in pixels
+     * @param y - Y coordinate in pixels
+     * @param opts - Click options (button, clickCount, delayMs)
+     *
+     * @example
+     * ```ts
+     * await page.mouseClick(100, 200);
+     * await page.mouseClick(100, 200, { button: 'right' });
+     * await page.mouseClick(100, 200, { clickCount: 2 }); // double-click
+     * ```
+     */
+    mouseClick(x: number, y: number, opts?: {
+        button?: 'left' | 'right' | 'middle';
+        clickCount?: number;
+        delayMs?: number;
+    }): Promise<void>;
+    /**
+     * Click an element by its visible text content (no snapshot/ref needed).
+     *
+     * Finds and clicks atomically — no stale ref problem.
+     *
+     * @param text - Text content to match
+     * @param opts - Options (exact: require full match, button, modifiers)
+     *
+     * @example
+     * ```ts
+     * await page.clickByText('Submit');
+     * await page.clickByText('Save Changes', { exact: true });
+     * ```
+     */
+    clickByText(text: string, opts?: {
+        exact?: boolean;
+        button?: 'left' | 'right' | 'middle';
+        modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[];
+        timeoutMs?: number;
+    }): Promise<void>;
+    /**
+     * Click an element by its ARIA role and accessible name (no snapshot/ref needed).
+     *
+     * Finds and clicks atomically — no stale ref problem.
+     *
+     * @param role - ARIA role (e.g. `'button'`, `'link'`, `'menuitem'`)
+     * @param name - Accessible name to match (optional)
+     * @param opts - Click options
+     *
+     * @example
+     * ```ts
+     * await page.clickByRole('button', 'Save');
+     * await page.clickByRole('link', 'Settings');
+     * await page.clickByRole('menuitem', 'Delete');
+     * ```
+     */
+    clickByRole(role: string, name?: string, opts?: {
+        button?: 'left' | 'right' | 'middle';
+        modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[];
+        timeoutMs?: number;
+    }): Promise<void>;
     /**
      * Type text into an input element by ref.
      *
@@ -1243,6 +1327,7 @@ declare class CrawlPage {
 declare class BrowserClaw {
     private readonly cdpUrl;
     private readonly ssrfPolicy;
+    private readonly recordVideo;
     private chrome;
     private constructor();
     /**
@@ -1283,7 +1368,7 @@ declare class BrowserClaw {
      * const browser = await BrowserClaw.connect('http://localhost:9222');
      * ```
      */
-    static connect(cdpUrl: string, opts?: ConnectOptions): Promise<BrowserClaw>;
+    static connect(cdpUrl?: string, opts?: ConnectOptions): Promise<BrowserClaw>;
     /**
      * Open a URL in a new tab and return the page handle.
      *

package/dist/index.d.ts

@@ -195,6 +195,17 @@ interface LaunchOptions {
      * @deprecated Use `ssrfPolicy: { dangerouslyAllowPrivateNetwork: true }` instead.
      */
     allowInternal?: boolean;
+    /**
+     * Record video for all pages. Requires a directory to save video files.
+     * Videos are saved when the page or context is closed.
+     */
+    recordVideo?: {
+        dir: string;
+        size?: {
+            width: number;
+            height: number;
+        };
+    };
 }
 /** Options for connecting to an existing browser instance. */
 interface ConnectOptions {
@@ -215,6 +226,17 @@ interface ConnectOptions {
      * (e.g. OpenClaw browser control with gateway.auth.token).
      */
     authToken?: string;
+    /**
+     * Record video for all pages. Requires a directory to save video files.
+     * Videos are saved when the page or context is closed.
+     */
+    recordVideo?: {
+        dir: string;
+        size?: {
+            width: number;
+            height: number;
+        };
+    };
 }
 /**
  * Describes a single interactive element found during a snapshot.
@@ -644,6 +666,68 @@ declare class CrawlPage {
      * ```
      */
     click(ref: string, opts?: ClickOptions): Promise<void>;
+    /**
+     * Click at specific page coordinates.
+     *
+     * Useful for canvas elements, custom widgets, or elements without ARIA roles.
+     *
+     * @param x - X coordinate in pixels
+     * @param y - Y coordinate in pixels
+     * @param opts - Click options (button, clickCount, delayMs)
+     *
+     * @example
+     * ```ts
+     * await page.mouseClick(100, 200);
+     * await page.mouseClick(100, 200, { button: 'right' });
+     * await page.mouseClick(100, 200, { clickCount: 2 }); // double-click
+     * ```
+     */
+    mouseClick(x: number, y: number, opts?: {
+        button?: 'left' | 'right' | 'middle';
+        clickCount?: number;
+        delayMs?: number;
+    }): Promise<void>;
+    /**
+     * Click an element by its visible text content (no snapshot/ref needed).
+     *
+     * Finds and clicks atomically — no stale ref problem.
+     *
+     * @param text - Text content to match
+     * @param opts - Options (exact: require full match, button, modifiers)
+     *
+     * @example
+     * ```ts
+     * await page.clickByText('Submit');
+     * await page.clickByText('Save Changes', { exact: true });
+     * ```
+     */
+    clickByText(text: string, opts?: {
+        exact?: boolean;
+        button?: 'left' | 'right' | 'middle';
+        modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[];
+        timeoutMs?: number;
+    }): Promise<void>;
+    /**
+     * Click an element by its ARIA role and accessible name (no snapshot/ref needed).
+     *
+     * Finds and clicks atomically — no stale ref problem.
+     *
+     * @param role - ARIA role (e.g. `'button'`, `'link'`, `'menuitem'`)
+     * @param name - Accessible name to match (optional)
+     * @param opts - Click options
+     *
+     * @example
+     * ```ts
+     * await page.clickByRole('button', 'Save');
+     * await page.clickByRole('link', 'Settings');
+     * await page.clickByRole('menuitem', 'Delete');
+     * ```
+     */
+    clickByRole(role: string, name?: string, opts?: {
+        button?: 'left' | 'right' | 'middle';
+        modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[];
+        timeoutMs?: number;
+    }): Promise<void>;
     /**
      * Type text into an input element by ref.
      *
@@ -1243,6 +1327,7 @@ declare class CrawlPage {
 declare class BrowserClaw {
     private readonly cdpUrl;
     private readonly ssrfPolicy;
+    private readonly recordVideo;
     private chrome;
     private constructor();
     /**
@@ -1283,7 +1368,7 @@ declare class BrowserClaw {
      * const browser = await BrowserClaw.connect('http://localhost:9222');
      * ```
      */
-    static connect(cdpUrl: string, opts?: ConnectOptions): Promise<BrowserClaw>;
+    static connect(cdpUrl?: string, opts?: ConnectOptions): Promise<BrowserClaw>;
     /**
      * Open a URL in a new tab and return the page handle.
      *