saltfish 0.3.73 → 0.3.74

package/dist/utils/domSnapshotCapture.d.ts

@@ -0,0 +1,23 @@
+/**
+ * DOM Snapshot Capture
+ *
+ * Captures DOM snapshots using rrweb-snapshot for debugging element finding failures.
+ * Loads rrweb-snapshot from Saltfish CDN to avoid adding to bundle size - only loaded when needed.
+ * Hosted on Saltfish domain to work with customer CSP rules that whitelist *.saltfish.ai
+ */
+export type DOMSnapshot = Record<string, unknown>;
+/**
+ * Captures a snapshot of the current DOM state.
+ * Loads rrweb-snapshot from Saltfish CDN to keep bundle size zero.
+ *
+ * @returns Serialized DOM snapshot or null if capture fails
+ */
+export declare function captureDOMSnapshot(): Promise<DOMSnapshot | null>;
+/**
+ * Captures a snapshot and serializes it to a JSON string.
+ * Useful for sending to API endpoints.
+ *
+ * @returns JSON string of DOM snapshot or null if capture fails
+ */
+export declare function captureDOMSnapshotAsString(): Promise<string | null>;
+//# sourceMappingURL=domSnapshotCapture.d.ts.map

package/dist/utils/domSnapshotCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domSnapshotCapture.d.ts","sourceRoot":"","sources":["../../src/utils/domSnapshotCapture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAIlD;;;;;GAKG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAUtE;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYzE"}

package/dist/utils/elementErrorReporter.d.ts

@@ -3,6 +3,9 @@
  *
  * Reports element finding failures to the backend API for tracking.
  * Used when cursor/transition element finding fails after all retries.
+ *
+ * Captures a DOM snapshot using rrweb-snapshot for all failures,
+ * allowing reconstruction of the page state for debugging.
  */
 import type { ExpectedElement, ExpectedSize } from './elementSizeValidator';
 export type ElementErrorReason = 'no_elements' | 'tag_mismatch' | 'text_mismatch' | 'size_mismatch';
@@ -11,10 +14,14 @@ export interface ElementErrorPayload {
     stepId: string;
     failureReason: ElementErrorReason;
     selector: string;
+    domSnapshot?: string;
 }
 /**
  * Reports an element finding error to the backend.
  * Fire-and-forget - does not block or throw.
+ *
+ * Always captures a DOM snapshot to allow reconstruction of the page state
+ * for debugging, regardless of failure type.
  */
 export declare function reportElementError(playlistId: string, stepId: string, selector: string, expectedElement?: ExpectedElement, expectedSize?: ExpectedSize): void;
 //# sourceMappingURL=elementErrorReporter.d.ts.map

package/dist/utils/elementErrorReporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elementErrorReporter.d.ts","sourceRoot":"","sources":["../../src/utils/elementErrorReporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI5E,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,eAAe,CAAC;AAEpG,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,kBAAkB,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAyCD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,eAAe,EACjC,YAAY,CAAC,EAAE,YAAY,GAC1B,IAAI,CAqBN"}
+{"version":3,"file":"elementErrorReporter.d.ts","sourceRoot":"","sources":["../../src/utils/elementErrorReporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAK5E,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,eAAe,CAAC;AAEpG,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,kBAAkB,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAyCD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,eAAe,EACjC,YAAY,CAAC,EAAE,YAAY,GAC1B,IAAI,CA+BN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saltfish",
-  "version": "0.3.73",
+  "version": "0.3.74",
   "description": "An interactive video-guided tour system for web applications",
   "main": "dist/saltfish-playlist-player.umd.js",
   "types": "dist/index.d.ts",