userflow-mcp 0.2.1 → 0.3.0

package/dist/utils/page-snapshot.d.ts

@@ -1,11 +1,18 @@
 import type { Page } from "puppeteer-core";
 import type { PageSnapshot } from "../types.js";
+import type { NetworkMonitor } from "./network-monitor.js";
+import type { ConsoleMonitor } from "./console-monitor.js";
+export interface SnapshotOptions {
+    readonly fullPage?: boolean;
+    readonly networkMonitor?: NetworkMonitor;
+    readonly consoleMonitor?: ConsoleMonitor;
+    /** Skip heavy audits (accessibility, storage) for faster snapshots during steps. */
+    readonly lightweight?: boolean;
+}
 /**
  * Extract a full snapshot of the current page state.
- * Gathers all interactive elements, text content, headings, error messages, etc.
- * Shared between session manager (step-by-step) and legacy flow walker (auto_walk).
+ * Gathers all interactive elements, text content, headings, error messages,
+ * plus optional v0.3 data: performance metrics, accessibility, network, console, storage.
  */
-export declare function extractPageSnapshot(page: Page, options?: {
-    readonly fullPage?: boolean;
-}): Promise<PageSnapshot>;
+export declare function extractPageSnapshot(page: Page, options?: SnapshotOptions): Promise<PageSnapshot>;
 //# sourceMappingURL=page-snapshot.d.ts.map

package/dist/utils/page-snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-snapshot.d.ts","sourceRoot":"","sources":["../../src/utils/page-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAE7D;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACxC,OAAO,CAAC,YAAY,CAAC,CA4GvB"}
+{"version":3,"file":"page-snapshot.d.ts","sourceRoot":"","sources":["../../src/utils/page-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,YAAY,CAAC,CAqJvB"}

package/dist/utils/page-snapshot.js

@@ -1,7 +1,10 @@
+import { collectPerformanceMetrics } from "./performance.js";
+import { runAccessibilityAudit } from "./accessibility.js";
+import { inspectStorage } from "./storage-inspector.js";
 /**
  * Extract a full snapshot of the current page state.
- * Gathers all interactive elements, text content, headings, error messages, etc.
- * Shared between session manager (step-by-step) and legacy flow walker (auto_walk).
+ * Gathers all interactive elements, text content, headings, error messages,
+ * plus optional v0.3 data: performance metrics, accessibility, network, console, storage.
  */
 export async function extractPageSnapshot(page, options) {
     const startTime = Date.now();
@@ -84,6 +87,39 @@ export async function extractPageSnapshot(page, options) {
     });
     const screenshot = Buffer.from(screenshotBuffer).toString("base64");
     const loadTimeMs = Date.now() - startTime;
+    // ── v0.3 enrichment: collect performance, network, console, storage, a11y ──
+    // Performance metrics (always collected — lightweight)
+    let performance = undefined;
+    try {
+        performance = await collectPerformanceMetrics(page);
+    }
+    catch {
+        // Performance collection may fail on some pages — graceful degradation
+    }
+    // Network summary (from monitor if available)
+    const network = options?.networkMonitor?.getSummary() ?? undefined;
+    // Console summary (from monitor if available)
+    const console = options?.consoleMonitor?.getSummary() ?? undefined;
+    // Accessibility audit (skip in lightweight mode to keep step speed)
+    let accessibility = undefined;
+    if (!options?.lightweight) {
+        try {
+            accessibility = await runAccessibilityAudit(page);
+        }
+        catch {
+            // axe-core injection may fail on some pages
+        }
+    }
+    // Storage inspection (skip in lightweight mode)
+    let storage = undefined;
+    if (!options?.lightweight) {
+        try {
+            storage = await inspectStorage(page);
+        }
+        catch {
+            // Storage inspection may fail on cross-origin pages
+        }
+    }
     return {
         url,
         title,
@@ -97,6 +133,11 @@ export async function extractPageSnapshot(page, options) {
         buttons: pageData.buttons,
         errorMessages: pageData.errorMessages,
         loadTimeMs,
+        performance,
+        network,
+        console,
+        accessibility,
+        storage,
     };
 }
 //# sourceMappingURL=page-snapshot.js.map

package/dist/utils/page-snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-snapshot.js","sourceRoot":"","sources":["../../src/utils/page-snapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"page-snapshot.js","sourceRoot":"","sources":["../../src/utils/page-snapshot.ts"],"names":[],"mappings":"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"}

package/dist/utils/performance.d.ts

@@ -0,0 +1,43 @@
+import type { Page } from "puppeteer-core";
+export interface PerformanceMetrics {
+    /** Largest Contentful Paint (ms) */
+    lcp: number | null;
+    /** Cumulative Layout Shift (unitless score) */
+    cls: number | null;
+    /** Interaction to Next Paint (ms) */
+    inp: number | null;
+    /** First Contentful Paint (ms) */
+    fcp: number | null;
+    /** Time to First Byte (ms) */
+    ttfb: number | null;
+    /** DOMContentLoaded relative to navigationStart (ms) */
+    domContentLoaded: number | null;
+    /** domComplete relative to navigationStart (ms) */
+    domComplete: number | null;
+    /** Total number of resources loaded */
+    resourceCount: number;
+    /** Total transfer size of all resources (bytes) */
+    totalResourceSize: number;
+    /** LCP quality rating per Google's thresholds */
+    lcpRating: "good" | "needs-improvement" | "poor" | null;
+    /** CLS quality rating per Google's thresholds */
+    clsRating: "good" | "needs-improvement" | "poor" | null;
+    /** INP quality rating per Google's thresholds */
+    inpRating: "good" | "needs-improvement" | "poor" | null;
+}
+/**
+ * Inject PerformanceObservers into every new document before navigation.
+ *
+ * Must be called before `page.goto()`. Stores collected values on
+ * `window.__userflow_perf` so they can be read by `collectPerformanceMetrics`.
+ */
+export declare function injectPerformanceObservers(page: Page): Promise<void>;
+/**
+ * Read all performance metrics from the page after it has loaded.
+ *
+ * Combines values captured by `injectPerformanceObservers` with
+ * Navigation Timing and Resource Timing data from the browser's
+ * Performance API. Missing or unsupported metrics are returned as `null`.
+ */
+export declare function collectPerformanceMetrics(page: Page): Promise<PerformanceMetrics>;
+//# sourceMappingURL=performance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/utils/performance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAI3C,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,qCAAqC;IACrC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,kCAAkC;IAClC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mDAAmD;IACnD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAC;IACxD,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAC;IACxD,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAC;CACzD;AA0BD;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B1E;AAID;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmDvF"}

package/dist/utils/performance.js

@@ -0,0 +1,108 @@
+function rateLcp(ms) {
+    if (ms <= 2500)
+        return "good";
+    if (ms <= 4000)
+        return "needs-improvement";
+    return "poor";
+}
+function rateCls(score) {
+    if (score <= 0.1)
+        return "good";
+    if (score <= 0.25)
+        return "needs-improvement";
+    return "poor";
+}
+function rateInp(ms) {
+    if (ms <= 200)
+        return "good";
+    if (ms <= 500)
+        return "needs-improvement";
+    return "poor";
+}
+// ── Observer injection ─────────────────────────────────────────
+/**
+ * Inject PerformanceObservers into every new document before navigation.
+ *
+ * Must be called before `page.goto()`. Stores collected values on
+ * `window.__userflow_perf` so they can be read by `collectPerformanceMetrics`.
+ */
+export async function injectPerformanceObservers(page) {
+    await page.evaluateOnNewDocument(() => {
+        const store = { lcp: null, cls: null, inp: null };
+        // @ts-expect-error — injected global not in Window typings
+        window.__userflow_perf = store;
+        const observe = (type, opts, cb) => {
+            try {
+                new PerformanceObserver((l) => l.getEntries().forEach(cb)).observe({ type, buffered: true, ...opts });
+            }
+            catch { /* entry type unsupported in this browser */ }
+        };
+        // LCP — last entry wins (browser re-fires until first user interaction)
+        observe("largest-contentful-paint", {}, (e) => { store.lcp = e.startTime; });
+        // CLS — accumulate shifts not preceded by user input
+        observe("layout-shift", {}, (e) => {
+            const s = e;
+            if (!s.hadRecentInput)
+                store.cls = (store.cls ?? 0) + s.value;
+        });
+        // INP — worst (max) event duration; durationThreshold cast needed for older TS lib defs
+        observe("event", { durationThreshold: 16 }, (e) => {
+            const d = e.duration;
+            if (store.inp === null || d > store.inp)
+                store.inp = d;
+        });
+    });
+}
+// ── Metric collection ──────────────────────────────────────────
+/**
+ * Read all performance metrics from the page after it has loaded.
+ *
+ * Combines values captured by `injectPerformanceObservers` with
+ * Navigation Timing and Resource Timing data from the browser's
+ * Performance API. Missing or unsupported metrics are returned as `null`.
+ */
+export async function collectPerformanceMetrics(page) {
+    const raw = await page.evaluate(() => {
+        // Observed vitals written by the injected PerformanceObservers
+        const vitals = window
+            .__userflow_perf ?? { lcp: null, cls: null, inp: null };
+        // Navigation Timing (Level 2)
+        const [navEntry] = performance.getEntriesByType("navigation");
+        const ttfb = navEntry ? navEntry.responseStart - navEntry.requestStart : null;
+        const domContentLoaded = navEntry ? navEntry.domContentLoadedEventEnd - navEntry.startTime : null;
+        const domComplete = navEntry ? navEntry.domComplete - navEntry.startTime : null;
+        // FCP via paint entries
+        const fcpEntry = performance.getEntriesByName("first-contentful-paint")[0];
+        const fcp = fcpEntry ? fcpEntry.startTime : null;
+        // Resource summary
+        const resources = performance.getEntriesByType("resource");
+        const resourceCount = resources.length;
+        const totalResourceSize = resources.reduce((sum, r) => sum + (r.transferSize ?? 0), 0);
+        return {
+            lcp: vitals.lcp,
+            cls: vitals.cls,
+            inp: vitals.inp,
+            fcp,
+            ttfb,
+            domContentLoaded,
+            domComplete,
+            resourceCount,
+            totalResourceSize,
+        };
+    });
+    return {
+        lcp: raw.lcp,
+        cls: raw.cls,
+        inp: raw.inp,
+        fcp: raw.fcp,
+        ttfb: raw.ttfb,
+        domContentLoaded: raw.domContentLoaded,
+        domComplete: raw.domComplete,
+        resourceCount: raw.resourceCount,
+        totalResourceSize: raw.totalResourceSize,
+        lcpRating: raw.lcp !== null ? rateLcp(raw.lcp) : null,
+        clsRating: raw.cls !== null ? rateCls(raw.cls) : null,
+        inpRating: raw.inp !== null ? rateInp(raw.inp) : null,
+    };
+}
+//# sourceMappingURL=performance.js.map

package/dist/utils/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../src/utils/performance.ts"],"names":[],"mappings":"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"}

package/dist/utils/screenshot-diff.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Visual screenshot comparison using pixelmatch and pngjs.
+ *
+ * Accepts two base64-encoded PNG screenshots, optionally pads the smaller
+ * one to match dimensions, computes a pixel-level diff, and returns match
+ * statistics together with a base64-encoded diff-overlay image.
+ */
+/** Result of a pixel-level screenshot comparison. */
+export interface ScreenshotDiff {
+    /** Percentage of matching pixels (0 = no match, 100 = identical). */
+    matchPercentage: number;
+    /** Number of pixels that differ beyond the threshold. */
+    diffPixels: number;
+    /** Total number of pixels in the (possibly padded) canvas. */
+    totalPixels: number;
+    dimensions: {
+        width: number;
+        height: number;
+    };
+    /** Base64-encoded PNG highlighting differing pixels in red. */
+    diffImage: string;
+}
+/**
+ * Compares two base64-encoded PNG screenshots and produces a visual diff.
+ *
+ * When the images have different dimensions the smaller one is padded with
+ * transparent pixels so both canvases share the same bounding box before
+ * comparison.
+ *
+ * @param screenshot1 - Base64-encoded PNG (first / "before" image).
+ * @param screenshot2 - Base64-encoded PNG (second / "after" image).
+ * @param threshold   - Per-channel colour tolerance in [0, 1]. Defaults to 0.1.
+ * @returns Diff statistics and a base64 diff-overlay image.
+ */
+export declare function compareScreenshots(screenshot1: string, screenshot2: string, threshold?: number): Promise<ScreenshotDiff>;
+//# sourceMappingURL=screenshot-diff.d.ts.map

package/dist/utils/screenshot-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-diff.d.ts","sourceRoot":"","sources":["../../src/utils/screenshot-diff.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;CACnB;AAwBD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,SAAM,GACd,OAAO,CAAC,cAAc,CAAC,CAoCzB"}

package/dist/utils/screenshot-diff.js

@@ -0,0 +1,62 @@
+/**
+ * Visual screenshot comparison using pixelmatch and pngjs.
+ *
+ * Accepts two base64-encoded PNG screenshots, optionally pads the smaller
+ * one to match dimensions, computes a pixel-level diff, and returns match
+ * statistics together with a base64-encoded diff-overlay image.
+ */
+import pixelmatch from "pixelmatch";
+import { PNG } from "pngjs";
+/** Decodes a base64 PNG string into a `pngjs` `PNG` object. */
+function decodePng(base64) {
+    const buffer = Buffer.from(base64, "base64");
+    return PNG.sync.read(buffer);
+}
+/**
+ * Pads a PNG canvas to the target dimensions by copying pixels into a new,
+ * zero-initialised (transparent black) buffer. Returns the original PNG
+ * unchanged when it already matches the target size.
+ */
+function padPng(png, width, height) {
+    if (png.width === width && png.height === height)
+        return png;
+    const padded = new PNG({ width, height });
+    // Zero-fill guarantees transparent black padding pixels.
+    padded.data.fill(0);
+    PNG.bitblt(png, padded, 0, 0, Math.min(png.width, width), Math.min(png.height, height), 0, 0);
+    return padded;
+}
+/**
+ * Compares two base64-encoded PNG screenshots and produces a visual diff.
+ *
+ * When the images have different dimensions the smaller one is padded with
+ * transparent pixels so both canvases share the same bounding box before
+ * comparison.
+ *
+ * @param screenshot1 - Base64-encoded PNG (first / "before" image).
+ * @param screenshot2 - Base64-encoded PNG (second / "after" image).
+ * @param threshold   - Per-channel colour tolerance in [0, 1]. Defaults to 0.1.
+ * @returns Diff statistics and a base64 diff-overlay image.
+ */
+export async function compareScreenshots(screenshot1, screenshot2, threshold = 0.1) {
+    const png1 = decodePng(screenshot1);
+    const png2 = decodePng(screenshot2);
+    // Compute the bounding box that encloses both images.
+    const width = Math.max(png1.width, png2.width);
+    const height = Math.max(png1.height, png2.height);
+    const padded1 = padPng(png1, width, height);
+    const padded2 = padPng(png2, width, height);
+    const diff = new PNG({ width, height });
+    const totalPixels = width * height;
+    const diffPixels = pixelmatch(padded1.data, padded2.data, diff.data, width, height, { threshold, includeAA: false });
+    const matchPercentage = parseFloat((((totalPixels - diffPixels) / totalPixels) * 100).toFixed(2));
+    const diffImage = PNG.sync.write(diff).toString("base64");
+    return {
+        matchPercentage,
+        diffPixels,
+        totalPixels,
+        dimensions: { width, height },
+        diffImage,
+    };
+}
+//# sourceMappingURL=screenshot-diff.js.map

package/dist/utils/screenshot-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-diff.js","sourceRoot":"","sources":["../../src/utils/screenshot-diff.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAe5B,+DAA+D;AAC/D,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,SAAS,MAAM,CAAC,GAAQ,EAAE,KAAa,EAAE,MAAc;IACrD,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC;IAE7D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,yDAAyD;IACzD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEpB,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,WAAmB,EACnB,SAAS,GAAG,GAAG;IAEf,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAEpC,sDAAsD;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAElD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAE5C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC;IAEnC,MAAM,UAAU,GAAG,UAAU,CAC3B,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,IAAI,EACZ,IAAI,CAAC,IAAI,EACT,KAAK,EACL,MAAM,EACN,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAChC,CAAC;IAEF,MAAM,eAAe,GAAG,UAAU,CAChC,CAAC,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAC9D,CAAC;IAEF,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE1D,OAAO;QACL,eAAe;QACf,UAAU;QACV,WAAW;QACX,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;QAC7B,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/utils/selector-engine.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Smart Selector Engine for Puppeteer
+ *
+ * Generates reliable, fallback-capable selectors that survive styled-components
+ * and dynamic class names. Each element gets multiple selector strategies tried
+ * in priority order, from most stable to least stable.
+ */
+import type { Page, ElementHandle } from "puppeteer-core";
+export interface SmartSelector {
+    /** The best selector to try first. */
+    primary: string;
+    /** Ordered list of alternatives to try if primary fails. */
+    fallbacks: string[];
+    /** Human-readable description of what the element is. */
+    description: string;
+    /** Strategy used to derive the primary selector. */
+    strategy: "testid" | "id" | "aria" | "role-text" | "input-attr" | "link-href" | "text" | "css";
+}
+/**
+ * Generates multiple selector strategies for an element.
+ * Designed to run inside `page.evaluate()` — has no Node.js dependencies.
+ *
+ * Priority order (most → least stable):
+ *   1. data-testid
+ *   2. Unique id
+ *   3. aria-label / aria-labelledby
+ *   4. role + visible text
+ *   5. input type + name or placeholder
+ *   6. anchor href
+ *   7. Puppeteer text pseudo-selector
+ *   8. Minimal CSS path (fallback)
+ */
+export declare function generateSmartSelectors(element: Element): SmartSelector;
+/**
+ * Tries to find an element on the page using multiple selector strategies.
+ * Returns the first `ElementHandle` that successfully resolves, or `null`.
+ *
+ * @param page     - Puppeteer Page instance.
+ * @param target   - Primary selector string or SmartSelector.primary.
+ * @param fallbacks - Additional selectors to try if primary fails.
+ * @param timeout  - Per-selector wait timeout in ms (default: 3000).
+ */
+export declare function resolveSelector(page: Page, target: string, fallbacks?: string[], timeout?: number): Promise<ElementHandle | null>;
+/**
+ * Takes a basic CSS selector (e.g. from a snapshot), injects
+ * `generateSmartSelectors` into the page, and returns a richer SmartSelector
+ * with stable alternatives.
+ *
+ * @param page        - Puppeteer Page instance.
+ * @param cssSelector - Existing (possibly fragile) CSS selector.
+ */
+export declare function enhanceElementSelectors(page: Page, cssSelector: string): Promise<SmartSelector>;
+//# sourceMappingURL=selector-engine.d.ts.map

package/dist/utils/selector-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-engine.d.ts","sourceRoot":"","sources":["../../src/utils/selector-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAM1D,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;CAChG;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CA2EtE;AAkDD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAM,EAAO,EACxB,OAAO,SAAQ,GACd,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAa/B;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,CA0BxB"}

package/dist/utils/selector-engine.js

@@ -0,0 +1,180 @@
+/**
+ * Smart Selector Engine for Puppeteer
+ *
+ * Generates reliable, fallback-capable selectors that survive styled-components
+ * and dynamic class names. Each element gets multiple selector strategies tried
+ * in priority order, from most stable to least stable.
+ */
+// ---------------------------------------------------------------------------
+// Browser-context helper (runs inside page.evaluate)
+// ---------------------------------------------------------------------------
+/**
+ * Generates multiple selector strategies for an element.
+ * Designed to run inside `page.evaluate()` — has no Node.js dependencies.
+ *
+ * Priority order (most → least stable):
+ *   1. data-testid
+ *   2. Unique id
+ *   3. aria-label / aria-labelledby
+ *   4. role + visible text
+ *   5. input type + name or placeholder
+ *   6. anchor href
+ *   7. Puppeteer text pseudo-selector
+ *   8. Minimal CSS path (fallback)
+ */
+export function generateSmartSelectors(element) {
+    const tag = element.tagName.toLowerCase();
+    const candidates = [];
+    // 1. data-testid (most stable — explicit test hook)
+    const testid = element.getAttribute("data-testid") ?? element.getAttribute("data-test-id") ?? element.getAttribute("data-cy");
+    if (testid) {
+        const attr = element.hasAttribute("data-testid") ? "data-testid" : element.hasAttribute("data-test-id") ? "data-test-id" : "data-cy";
+        candidates.push({ selector: `[${attr}="${CSS.escape(testid)}"]`, strategy: "testid" });
+    }
+    // 2. Unique id attribute
+    const id = element.getAttribute("id");
+    if (id && document.querySelectorAll(`#${CSS.escape(id)}`).length === 1) {
+        candidates.push({ selector: `#${CSS.escape(id)}`, strategy: "id" });
+    }
+    // 3. aria-label / aria-labelledby
+    const ariaLabel = element.getAttribute("aria-label");
+    if (ariaLabel) {
+        candidates.push({ selector: `[aria-label="${CSS.escape(ariaLabel)}"]`, strategy: "aria" });
+    }
+    const labelledBy = element.getAttribute("aria-labelledby");
+    if (labelledBy) {
+        candidates.push({ selector: `[aria-labelledby="${CSS.escape(labelledBy)}"]`, strategy: "aria" });
+    }
+    // 4. Role + visible text content (for buttons, links, headings, etc.)
+    const role = element.getAttribute("role") ?? tag;
+    const visibleText = (element.textContent ?? "").trim().slice(0, 80);
+    if (visibleText && ["button", "a", "h1", "h2", "h3", "h4", "h5", "h6", "label", "li"].includes(tag)) {
+        candidates.push({ selector: `::-p-aria(${visibleText})`, strategy: "role-text" });
+    }
+    // 5. Input type + name or placeholder
+    if (tag === "input" || tag === "textarea" || tag === "select") {
+        const name = element.getAttribute("name");
+        const placeholder = element.getAttribute("placeholder");
+        const type = element.getAttribute("type") ?? "text";
+        if (name) {
+            candidates.push({ selector: `${tag}[name="${CSS.escape(name)}"]`, strategy: "input-attr" });
+        }
+        else if (placeholder) {
+            candidates.push({ selector: `${tag}[placeholder="${CSS.escape(placeholder)}"]`, strategy: "input-attr" });
+        }
+        else if (type !== "text") {
+            candidates.push({ selector: `${tag}[type="${CSS.escape(type)}"]`, strategy: "input-attr" });
+        }
+    }
+    // 6. Anchor href (for navigation links)
+    if (tag === "a") {
+        const href = element.getAttribute("href");
+        if (href && !href.startsWith("javascript:") && href !== "#") {
+            candidates.push({ selector: `a[href="${CSS.escape(href)}"]`, strategy: "link-href" });
+        }
+    }
+    // 7. Puppeteer text pseudo-selector
+    if (visibleText) {
+        candidates.push({ selector: `::-p-text(${visibleText})`, strategy: "text" });
+    }
+    // 8. Minimal CSS path (stable ancestor chain, stops at id or body)
+    candidates.push({ selector: buildMinimalCssPath(element), strategy: "css" });
+    // Build result: first candidate is primary, rest are fallbacks
+    const [first, ...rest] = candidates;
+    const description = buildDescription(tag, visibleText, ariaLabel, testid, id);
+    return {
+        primary: first.selector,
+        fallbacks: rest.map((c) => c.selector),
+        description,
+        strategy: first.strategy,
+    };
+}
+/** Builds a minimal CSS path by walking up the DOM, stopping at an id anchor or body. */
+function buildMinimalCssPath(el) {
+    const parts = [];
+    let current = el;
+    while (current && current.tagName.toLowerCase() !== "body") {
+        const tag = current.tagName.toLowerCase();
+        const id = current.getAttribute("id");
+        if (id && document.querySelectorAll(`#${CSS.escape(id)}`).length === 1) {
+            parts.unshift(`#${CSS.escape(id)}`);
+            break;
+        }
+        // nth-of-type using only the tag (avoids fragile dynamic class names)
+        const siblings = Array.from(current.parentElement?.children ?? []).filter((s) => s.tagName === current.tagName);
+        if (siblings.length > 1) {
+            const idx = siblings.indexOf(current) + 1;
+            parts.unshift(`${tag}:nth-of-type(${idx})`);
+        }
+        else {
+            parts.unshift(tag);
+        }
+        current = current.parentElement;
+    }
+    return parts.join(" > ") || el.tagName.toLowerCase();
+}
+/** Builds a human-readable description of the element. */
+function buildDescription(tag, text, ariaLabel, testid, id) {
+    const label = ariaLabel ?? testid ?? id ?? text;
+    if (label)
+        return `${tag}[${label.slice(0, 60)}]`;
+    return `<${tag}>`;
+}
+// ---------------------------------------------------------------------------
+// Node.js-context helpers (use Page API)
+// ---------------------------------------------------------------------------
+/**
+ * Tries to find an element on the page using multiple selector strategies.
+ * Returns the first `ElementHandle` that successfully resolves, or `null`.
+ *
+ * @param page     - Puppeteer Page instance.
+ * @param target   - Primary selector string or SmartSelector.primary.
+ * @param fallbacks - Additional selectors to try if primary fails.
+ * @param timeout  - Per-selector wait timeout in ms (default: 3000).
+ */
+export async function resolveSelector(page, target, fallbacks = [], timeout = 3_000) {
+    const strategies = [target, ...fallbacks];
+    for (const selector of strategies) {
+        try {
+            const handle = await page.waitForSelector(selector, { timeout });
+            if (handle)
+                return handle;
+        }
+        catch {
+            // Selector not found within timeout — try next
+        }
+    }
+    return null;
+}
+/**
+ * Takes a basic CSS selector (e.g. from a snapshot), injects
+ * `generateSmartSelectors` into the page, and returns a richer SmartSelector
+ * with stable alternatives.
+ *
+ * @param page        - Puppeteer Page instance.
+ * @param cssSelector - Existing (possibly fragile) CSS selector.
+ */
+export async function enhanceElementSelectors(page, cssSelector) {
+    const result = await page.evaluate(
+    // NOTE: generateSmartSelectors is serialised and sent to the browser.
+    // It must remain self-contained (no closures over Node.js variables).
+    (sel, genFnSrc) => {
+        const el = document.querySelector(sel);
+        if (!el)
+            return null;
+        // eslint-disable-next-line no-new-func
+        const fn = new Function(`return (${genFnSrc})`)();
+        return fn(el);
+    }, cssSelector, generateSmartSelectors.toString());
+    if (!result) {
+        // Element not found — return a degenerate SmartSelector
+        return {
+            primary: cssSelector,
+            fallbacks: [],
+            description: `<not found: ${cssSelector}>`,
+            strategy: "css",
+        };
+    }
+    return result;
+}
+//# sourceMappingURL=selector-engine.js.map

package/dist/utils/selector-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-engine.js","sourceRoot":"","sources":["../../src/utils/selector-engine.ts"],"names":[],"mappings":"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"}