@xbrowser/cli 1.8.7 → 1.9.1

package/dist/{extract-RM62AJXW.js → extract-DSU2RVMN.js}

@@ -2,7 +2,7 @@ import {
   extractAndSave,
   extractRecording,
   printExtractSummary
-} from "./chunk-MJFYLKGL.js";
+} from "./chunk-X46HDAOT.js";
 import "./chunk-KFQGP6VL.js";
 export {
   extractAndSave,

package/dist/{extract-O46CC533.js → extract-EUWPRSKH.js}

@@ -4,9 +4,33 @@ import "./chunk-KFQGP6VL.js";
 import * as fs from "fs";
 import * as yaml from "yaml";
 function extractRecording(filePath) {
-  const content = fs.readFileSync(filePath, "utf-8");
-  const recording = yaml.parse(content);
-  const events = recording.actions || recording.events || [];
+  let recording;
+  try {
+    const content = fs.readFileSync(filePath, "utf-8");
+    recording = yaml.parse(content);
+  } catch (e) {
+    throw new Error(`Failed to read "${filePath}": ${e instanceof Error ? e.message.split("\n")[0] : String(e)}`);
+  }
+  if (recording === null || typeof recording !== "object" || Array.isArray(recording)) {
+    throw new Error(`"${filePath}" does not contain a valid recording (expected a YAML object with events or actions).`);
+  }
+  let rawEvents = recording.events ?? [];
+  const rawActions = recording.actions;
+  if (Array.isArray(rawActions) && rawEvents.length === 0) {
+    rawEvents = rawActions.map((a) => {
+      const action = a;
+      const element = action.element ?? {};
+      return {
+        type: action.type,
+        selector: element.selector ?? action.selector,
+        tagName: element.tag ?? action.tagName,
+        data: { ...action.data, value: action.value, key: action.key },
+        timestamp: action.timestamp,
+        pageState: action.pageState
+      };
+    });
+  }
+  const events = rawEvents;
   const keyEvents = [];
   const eventTypes = {};
   for (const event of events) {

package/dist/{filter-K6FGRJQU.js → filter-3DXC6432.js}

@@ -1,7 +1,7 @@
 import {
   filterRecording,
   parseExcludeTypes
-} from "./chunk-GJAV3QGG.js";
+} from "./chunk-ANVL2ID2.js";
 import "./chunk-KFQGP6VL.js";
 export {
   filterRecording,

package/dist/{filter-TAAYMSYI.js → filter-7YOPVPVC.js}

@@ -24,9 +24,33 @@ var DEFAULT_EXCLUDE_TYPES = [
   "mousedown"
 ];
 function filterRecording(inputPath, outputPath, excludeTypes) {
-  const content = fs.readFileSync(inputPath, "utf-8");
-  const recording = yaml.parse(content);
-  const events = recording.actions || recording.events || [];
+  let recording;
+  try {
+    const content = fs.readFileSync(inputPath, "utf-8");
+    recording = yaml.parse(content);
+  } catch (e) {
+    throw new Error(`Failed to read "${inputPath}": ${e instanceof Error ? e.message.split("\n")[0] : String(e)}`);
+  }
+  if (recording === null || typeof recording !== "object" || Array.isArray(recording)) {
+    throw new Error(`"${inputPath}" does not contain a valid recording (expected a YAML object with events or actions).`);
+  }
+  let rawEvents = recording.events ?? [];
+  const rawActions = recording.actions;
+  if (Array.isArray(rawActions) && rawEvents.length === 0) {
+    rawEvents = rawActions.map((a) => {
+      const action = a;
+      const element = action.element ?? {};
+      return {
+        type: action.type,
+        selector: element.selector ?? action.selector,
+        data: { ...action.data, value: action.value, key: action.key },
+        scrollX: action.scrollX,
+        scrollY: action.scrollY
+      };
+    });
+    delete recording.actions;
+  }
+  const events = rawEvents;
   const originalCount = events.length;
   const exclude = excludeTypes || DEFAULT_EXCLUDE_TYPES;
   const filteredEvents = events.filter((event) => {

package/dist/index.d.ts

@@ -1737,6 +1737,8 @@ interface UserAction {
         distance: number;
         duration: number;
     };
+    /** Base64-encoded PNG screenshot of the target element (captured on key actions) */
+    elementScreenshot?: string;
 }
 interface NetworkEntry {
     id: number;
@@ -1854,7 +1856,7 @@ declare class SessionRecorder {
         value?: string;
         url?: string;
         element?: UserAction['element'];
-    }): void;
+    }): Promise<void>;
     get networkCount(): number;
     getLiveData(): RecordingData;
     addManualCheckpoint(type: string, hint: string, selector?: string): CheckpointEntry;
@@ -1884,6 +1886,14 @@ declare class SessionRecorder {
     private handleFileChooser;
     private pollActions;
     private flushPendingActions;
+    /**
+     * Capture a screenshot of the target element for key action types.
+     * Returns a base64-encoded PNG string, or undefined if the element has no
+     * selector or the screenshot fails (non-critical — never blocks recording).
+     *
+     * Only captures for: click, input, change, dblclick, and their CDP counterparts.
+     */
+    private captureElementScreenshot;
     /**
      * After a click, wait 300ms then scan for popover/dropdown/menu elements
      * near the click position. This runs server-side to avoid race conditions