browser-pilot 0.0.4 → 0.0.6

package/README.md

@@ -403,6 +403,45 @@ Output:
 
 Run `bp actions` for complete action reference.
 
+### Recording Browser Actions
+
+Record human interactions to create automation recipes:
+
+```bash
+# Auto-connect to local Chrome and record (creates new session)
+bp record
+
+# Use most recent session
+bp record -s
+
+# Use specific session with custom output file
+bp record -s my-session -f login-flow.json
+
+# Review and edit the recording
+cat recording.json
+
+# Replay the recording
+bp exec -s my-session --file recording.json
+```
+
+The output format is compatible with `page.batch()`:
+```json
+{
+  "recordedAt": "2026-01-06T10:00:00.000Z",
+  "startUrl": "https://example.com",
+  "duration": 15000,
+  "steps": [
+    { "action": "fill", "selector": ["[data-testid=\"email\"]", "#email"], "value": "user@example.com" },
+    { "action": "click", "selector": ["[data-testid=\"submit\"]", "#login-btn"] }
+  ]
+}
+```
+
+**Notes:**
+- Password fields are automatically redacted as `[REDACTED]`
+- Selectors are multi-selector arrays ordered by reliability (data attributes > IDs > CSS paths)
+- Edit the JSON to adjust selectors or add `optional: true` flags
+
 ## Examples
 
 ### Login Flow with Error Handling

package/dist/actions.cjs

@@ -110,7 +110,8 @@ var BatchExecutor = class {
         await this.page.fill(step.selector, step.value, {
           timeout,
           optional,
-          clear: step.clear ?? true
+          clear: step.clear ?? true,
+          blur: step.blur
         });
         return { selectorUsed: this.getUsedSelector(step.selector) };
       }

package/dist/actions.d.cts

@@ -1,5 +1,5 @@
-import { P as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-C6m0bT04.cjs';
-export { A as ActionType, c as StepResult } from './types-C6m0bT04.cjs';
+import { P as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-TVlTA7nH.cjs';
+export { A as ActionType, c as StepResult } from './types-TVlTA7nH.cjs';
 import './client-7Nqka5MV.cjs';
 
 /**

package/dist/actions.d.ts

@@ -1,5 +1,5 @@
-import { P as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-BJv2dzu0.js';
-export { A as ActionType, c as StepResult } from './types-BJv2dzu0.js';
+import { P as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-CbdmaocU.js';
+export { A as ActionType, c as StepResult } from './types-CbdmaocU.js';
 import './client-7Nqka5MV.js';
 
 /**

package/dist/actions.mjs

@@ -1,7 +1,7 @@
 import {
   BatchExecutor,
   addBatchToPage
-} from "./chunk-YEHK2XY3.mjs";
+} from "./chunk-6RB3GKQP.mjs";
 export {
   BatchExecutor,
   addBatchToPage

package/dist/browser.cjs

@@ -542,7 +542,8 @@ var BatchExecutor = class {
         await this.page.fill(step.selector, step.value, {
           timeout,
           optional,
-          clear: step.clear ?? true
+          clear: step.clear ?? true,
+          blur: step.blur
         });
         return { selectorUsed: this.getUsedSelector(step.selector) };
       }
@@ -1133,6 +1134,13 @@ var Page = class {
     this.cdp = cdp;
     this.batchExecutor = new BatchExecutor(this);
   }
+  /**
+   * Get the underlying CDP client for advanced operations.
+   * Use with caution - prefer high-level Page methods when possible.
+   */
+  get cdpClient() {
+    return this.cdp;
+  }
   /**
    * Initialize the page (enable required CDP domains)
    */
@@ -1283,7 +1291,7 @@ var Page = class {
    * Fill an input field (clears first by default)
    */
   async fill(selector, value, options = {}) {
-    const { clear = true } = options;
+    const { clear = true, blur = false } = options;
     return this.withStaleNodeRetry(async () => {
       const element = await this.findElement(selector, options);
       if (!element) {
@@ -1297,7 +1305,11 @@ var Page = class {
             const el = document.querySelector(${JSON.stringify(element.selector)});
             if (el) {
               el.value = '';
-              el.dispatchEvent(new Event('input', { bubbles: true }));
+              el.dispatchEvent(new InputEvent('input', {
+                bubbles: true,
+                cancelable: true,
+                inputType: 'deleteContent'
+              }));
             }
           })()`
         );
@@ -1307,11 +1319,21 @@ var Page = class {
         `(() => {
           const el = document.querySelector(${JSON.stringify(element.selector)});
           if (el) {
-            el.dispatchEvent(new Event('input', { bubbles: true }));
+            el.dispatchEvent(new InputEvent('input', {
+              bubbles: true,
+              cancelable: true,
+              inputType: 'insertText',
+              data: ${JSON.stringify(value)}
+            }));
             el.dispatchEvent(new Event('change', { bubbles: true }));
           }
         })()`
       );
+      if (blur) {
+        await this.evaluateInFrame(
+          `document.querySelector(${JSON.stringify(element.selector)})?.blur()`
+        );
+      }
       return true;
     });
   }

package/dist/browser.d.cts

@@ -1,7 +1,7 @@
 import { C as CDPClient } from './client-7Nqka5MV.cjs';
 import { C as ConnectOptions } from './types-D_uDqh0Z.cjs';
-import { P as Page } from './types-C6m0bT04.cjs';
-export { d as ActionOptions, e as ActionResult, C as ConsoleHandler, f as ConsoleMessage, g as ConsoleMessageType, h as CustomSelectConfig, D as Dialog, i as DialogHandler, j as DialogType, k as Download, E as ElementInfo, l as ElementNotFoundError, m as EmulationState, n as ErrorHandler, F as FileInput, o as FillOptions, G as GeolocationOptions, I as InteractiveElement, N as NavigationError, p as NetworkIdleOptions, q as PageError, r as PageSnapshot, s as SnapshotNode, t as SubmitOptions, T as TimeoutError, u as TypeOptions, U as UserAgentMetadata, v as UserAgentOptions, V as ViewportOptions, W as WaitForOptions } from './types-C6m0bT04.cjs';
+import { P as Page } from './types-TVlTA7nH.cjs';
+export { d as ActionOptions, e as ActionResult, C as ConsoleHandler, f as ConsoleMessage, g as ConsoleMessageType, h as CustomSelectConfig, D as Dialog, i as DialogHandler, j as DialogType, k as Download, E as ElementInfo, l as ElementNotFoundError, m as EmulationState, n as ErrorHandler, F as FileInput, o as FillOptions, G as GeolocationOptions, I as InteractiveElement, N as NavigationError, p as NetworkIdleOptions, q as PageError, r as PageSnapshot, s as SnapshotNode, t as SubmitOptions, T as TimeoutError, u as TypeOptions, U as UserAgentMetadata, v as UserAgentOptions, V as ViewportOptions, W as WaitForOptions } from './types-TVlTA7nH.cjs';
 
 /**
  * Browser class - manages CDP connection and pages

package/dist/browser.d.ts

@@ -1,7 +1,7 @@
 import { C as CDPClient } from './client-7Nqka5MV.js';
 import { C as ConnectOptions } from './types-D_uDqh0Z.js';
-import { P as Page } from './types-BJv2dzu0.js';
-export { d as ActionOptions, e as ActionResult, C as ConsoleHandler, f as ConsoleMessage, g as ConsoleMessageType, h as CustomSelectConfig, D as Dialog, i as DialogHandler, j as DialogType, k as Download, E as ElementInfo, l as ElementNotFoundError, m as EmulationState, n as ErrorHandler, F as FileInput, o as FillOptions, G as GeolocationOptions, I as InteractiveElement, N as NavigationError, p as NetworkIdleOptions, q as PageError, r as PageSnapshot, s as SnapshotNode, t as SubmitOptions, T as TimeoutError, u as TypeOptions, U as UserAgentMetadata, v as UserAgentOptions, V as ViewportOptions, W as WaitForOptions } from './types-BJv2dzu0.js';
+import { P as Page } from './types-CbdmaocU.js';
+export { d as ActionOptions, e as ActionResult, C as ConsoleHandler, f as ConsoleMessage, g as ConsoleMessageType, h as CustomSelectConfig, D as Dialog, i as DialogHandler, j as DialogType, k as Download, E as ElementInfo, l as ElementNotFoundError, m as EmulationState, n as ErrorHandler, F as FileInput, o as FillOptions, G as GeolocationOptions, I as InteractiveElement, N as NavigationError, p as NetworkIdleOptions, q as PageError, r as PageSnapshot, s as SnapshotNode, t as SubmitOptions, T as TimeoutError, u as TypeOptions, U as UserAgentMetadata, v as UserAgentOptions, V as ViewportOptions, W as WaitForOptions } from './types-CbdmaocU.js';
 
 /**
  * Browser class - manages CDP connection and pages

package/dist/browser.mjs

@@ -5,10 +5,10 @@ import {
   Page,
   TimeoutError,
   connect
-} from "./chunk-CWSTSVWO.mjs";
+} from "./chunk-PCNEJAJ7.mjs";
 import "./chunk-BCOZUKWS.mjs";
 import "./chunk-R3PS4PCM.mjs";
-import "./chunk-YEHK2XY3.mjs";
+import "./chunk-6RB3GKQP.mjs";
 export {
   Browser,
   ElementNotFoundError,

package/dist/{chunk-YEHK2XY3.mjs → chunk-6RB3GKQP.mjs}

@@ -83,7 +83,8 @@ var BatchExecutor = class {
         await this.page.fill(step.selector, step.value, {
           timeout,
           optional,
-          clear: step.clear ?? true
+          clear: step.clear ?? true,
+          blur: step.blur
         });
         return { selectorUsed: this.getUsedSelector(step.selector) };
       }

package/dist/{chunk-CWSTSVWO.mjs → chunk-PCNEJAJ7.mjs}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-R3PS4PCM.mjs";
 import {
   BatchExecutor
-} from "./chunk-YEHK2XY3.mjs";
+} from "./chunk-6RB3GKQP.mjs";
 
 // src/network/interceptor.ts
 var RequestInterceptor = class {
@@ -471,6 +471,13 @@ var Page = class {
     this.cdp = cdp;
     this.batchExecutor = new BatchExecutor(this);
   }
+  /**
+   * Get the underlying CDP client for advanced operations.
+   * Use with caution - prefer high-level Page methods when possible.
+   */
+  get cdpClient() {
+    return this.cdp;
+  }
   /**
    * Initialize the page (enable required CDP domains)
    */
@@ -621,7 +628,7 @@ var Page = class {
    * Fill an input field (clears first by default)
    */
   async fill(selector, value, options = {}) {
-    const { clear = true } = options;
+    const { clear = true, blur = false } = options;
     return this.withStaleNodeRetry(async () => {
       const element = await this.findElement(selector, options);
       if (!element) {
@@ -635,7 +642,11 @@ var Page = class {
             const el = document.querySelector(${JSON.stringify(element.selector)});
             if (el) {
               el.value = '';
-              el.dispatchEvent(new Event('input', { bubbles: true }));
+              el.dispatchEvent(new InputEvent('input', {
+                bubbles: true,
+                cancelable: true,
+                inputType: 'deleteContent'
+              }));
             }
           })()`
         );
@@ -645,11 +656,21 @@ var Page = class {
         `(() => {
           const el = document.querySelector(${JSON.stringify(element.selector)});
           if (el) {
-            el.dispatchEvent(new Event('input', { bubbles: true }));
+            el.dispatchEvent(new InputEvent('input', {
+              bubbles: true,
+              cancelable: true,
+              inputType: 'insertText',
+              data: ${JSON.stringify(value)}
+            }));
             el.dispatchEvent(new Event('change', { bubbles: true }));
           }
         })()`
       );
+      if (blur) {
+        await this.evaluateInFrame(
+          `document.querySelector(${JSON.stringify(element.selector)})?.blur()`
+        );
+      }
       return true;
     });
   }