agentic-qe 3.7.6 → 3.7.7

package/dist/domains/test-execution/services/e2e/adaptive-locator-service.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Adaptive Locator Service
+ *
+ * Inspired by Scrapling's similarity-based element matching.
+ * When a primary selector fails, falls back through text, ARIA, and
+ * fingerprint similarity matching to find the intended element.
+ *
+ * @module test-execution/services/e2e/adaptive-locator-service
+ */
+import type { IBrowserClient } from '@integrations/browser';
+import type { ElementFingerprint, AdaptiveLocatorConfig, LocatorResolutionResult } from './adaptive-locator-types';
+/**
+ * Compute weighted similarity between a stored fingerprint and a candidate element
+ */
+export declare function computeSimilarity(stored: ElementFingerprint, candidate: Omit<ElementFingerprint, 'matchCount' | 'lastMatchedAt'>): number;
+/**
+ * Simple in-memory fingerprint store keyed by `pageUrl::selector`
+ */
+export declare class FingerprintStore {
+    private readonly store;
+    private readonly maxPerPage;
+    constructor(maxPerPage?: number);
+    private key;
+    get(pageUrl: string, selector: string): ElementFingerprint | undefined;
+    set(pageUrl: string, selector: string, fp: ElementFingerprint): void;
+    size(): number;
+    clear(): void;
+}
+/**
+ * Adaptive Locator Service
+ *
+ * Provides fallback element resolution when primary selectors fail.
+ * Maintains a fingerprint database of previously-matched elements
+ * and uses weighted similarity to find the best match.
+ */
+export declare class AdaptiveLocatorService {
+    private readonly config;
+    private readonly fingerprintStore;
+    constructor(config?: Partial<AdaptiveLocatorConfig>);
+    /**
+     * Capture and store a fingerprint for a successfully-interacted element
+     */
+    captureFingerprint(selector: string, client: IBrowserClient, pageUrl: string): Promise<ElementFingerprint | null>;
+    /**
+     * Resolve an element target with adaptive fallback chain.
+     *
+     * 1. Try primary selector
+     * 2. Text-based match
+     * 3. ARIA-based match
+     * 4. Fingerprint similarity matching
+     */
+    resolveWithFallback(selector: string, client: IBrowserClient, pageUrl: string): Promise<LocatorResolutionResult | null>;
+    /**
+     * Get the fingerprint store size (for diagnostics)
+     */
+    getStoreSize(): number;
+    /**
+     * Clear all stored fingerprints
+     */
+    clearFingerprints(): void;
+    private tryFallbackMethod;
+    private tryTextMatch;
+    private tryAriaMatch;
+    private tryFingerprintMatch;
+    /**
+     * Convert a selector string to a CSS selector suitable for capture.
+     * Returns null for non-CSS selectors that can't be used with querySelector.
+     */
+    private toCssForCapture;
+}
+//# sourceMappingURL=adaptive-locator-service.d.ts.map

package/dist/domains/test-execution/services/e2e/adaptive-locator-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-locator-service.d.ts","sourceRoot":"","sources":["../../../../../src/domains/test-execution/services/e2e/adaptive-locator-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EAExB,MAAM,0BAA0B,CAAC;AA4JlC;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,GAAG,eAAe,CAAC,GAClE,MAAM,CAuCR;AA8BD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyC;IAC/D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,SAAM;IAI5B,OAAO,CAAC,GAAG;IAIX,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAItE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,kBAAkB,GAAG,IAAI;IAepE,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;CAGd;AAMD;;;;;;GAMG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;gBAExC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAKnD;;OAEG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAwBrC;;;;;;;OAOG;IACG,mBAAmB,CACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAc1C;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,iBAAiB,IAAI,IAAI;YAQX,iBAAiB;YAiBjB,YAAY;YAwCZ,YAAY;YAkCZ,mBAAmB;IAoCjC;;;OAGG;IACH,OAAO,CAAC,eAAe;CAMxB"}

package/dist/domains/test-execution/services/e2e/adaptive-locator-service.js

@@ -0,0 +1,456 @@
+/**
+ * Adaptive Locator Service
+ *
+ * Inspired by Scrapling's similarity-based element matching.
+ * When a primary selector fails, falls back through text, ARIA, and
+ * fingerprint similarity matching to find the intended element.
+ *
+ * @module test-execution/services/e2e/adaptive-locator-service
+ */
+import { DEFAULT_ADAPTIVE_LOCATOR_CONFIG } from './adaptive-locator-types';
+// ============================================================================
+// Fingerprint Capture Script (runs in browser context)
+// ============================================================================
+/**
+ * JavaScript to evaluate in the browser to capture an element fingerprint.
+ * Returns a serialisable object matching ElementFingerprint.
+ */
+function buildCaptureScript(cssSelector) {
+    return `
+    (() => {
+      const el = document.querySelector(${JSON.stringify(cssSelector)});
+      if (!el) return null;
+      const parent = el.parentElement;
+      const siblings = parent ? parent.children : [];
+      let childIndex = 0;
+      for (let i = 0; i < siblings.length; i++) {
+        if (siblings[i] === el) { childIndex = i; break; }
+      }
+      return {
+        tagName: el.tagName.toLowerCase(),
+        classes: Array.from(el.classList),
+        ariaRole: el.getAttribute('role') || undefined,
+        ariaLabel: el.getAttribute('aria-label') || undefined,
+        textContent: (el.textContent || '').trim().slice(0, 200) || undefined,
+        attributes: {
+          id: el.id || undefined,
+          name: el.getAttribute('name') || undefined,
+          'data-testid': el.getAttribute('data-testid') || undefined,
+          type: el.getAttribute('type') || undefined,
+          placeholder: el.getAttribute('placeholder') || undefined,
+          href: el.getAttribute('href') || undefined,
+        },
+        positionHints: {
+          parentTag: parent ? parent.tagName.toLowerCase() : undefined,
+          childIndex,
+          siblingCount: siblings.length,
+        },
+        matchCount: 0,
+        lastMatchedAt: new Date().toISOString(),
+      };
+    })()
+  `;
+}
+/**
+ * JavaScript to find candidate elements on the page and return their fingerprints.
+ */
+function buildCandidatesScript() {
+    return `
+    (() => {
+      const interactiveTags = 'a,button,input,select,textarea,[role],[data-testid],[aria-label]';
+      const elements = document.querySelectorAll(interactiveTags);
+      const results = [];
+      for (let i = 0; i < Math.min(elements.length, 300); i++) {
+        const el = elements[i];
+        const parent = el.parentElement;
+        const siblings = parent ? parent.children : [];
+        let childIndex = 0;
+        for (let j = 0; j < siblings.length; j++) {
+          if (siblings[j] === el) { childIndex = j; break; }
+        }
+        results.push({
+          tagName: el.tagName.toLowerCase(),
+          classes: Array.from(el.classList),
+          ariaRole: el.getAttribute('role') || undefined,
+          ariaLabel: el.getAttribute('aria-label') || undefined,
+          textContent: (el.textContent || '').trim().slice(0, 200) || undefined,
+          attributes: {
+            id: el.id || undefined,
+            name: el.getAttribute('name') || undefined,
+            'data-testid': el.getAttribute('data-testid') || undefined,
+            type: el.getAttribute('type') || undefined,
+            placeholder: el.getAttribute('placeholder') || undefined,
+            href: el.getAttribute('href') || undefined,
+          },
+          positionHints: {
+            parentTag: parent ? parent.tagName.toLowerCase() : undefined,
+            childIndex,
+            siblingCount: siblings.length,
+          },
+          // Build a unique-enough CSS selector for this element
+          selector: buildSelector(el),
+        });
+      }
+
+      function buildSelector(el) {
+        if (el.id) return '#' + CSS.escape(el.id);
+        if (el.getAttribute('data-testid')) return '[data-testid="' + el.getAttribute('data-testid') + '"]';
+        if (el.getAttribute('name')) return el.tagName.toLowerCase() + '[name="' + el.getAttribute('name') + '"]';
+        // Fallback: tag + nth-child
+        const parent = el.parentElement;
+        if (!parent) return el.tagName.toLowerCase();
+        const siblings = Array.from(parent.children).filter(s => s.tagName === el.tagName);
+        const idx = siblings.indexOf(el) + 1;
+        return el.tagName.toLowerCase() + ':nth-of-type(' + idx + ')';
+      }
+
+      return results;
+    })()
+  `;
+}
+// ============================================================================
+// Similarity Computation
+// ============================================================================
+/** Weights for similarity scoring */
+const WEIGHTS = {
+    tagName: 0.20,
+    ariaRole: 0.15,
+    classes: 0.15,
+    textContent: 0.20,
+    attributes: 0.15,
+    positionHints: 0.15,
+};
+/**
+ * Compute Jaccard similarity between two string arrays
+ */
+function jaccardSimilarity(a, b) {
+    if (a.length === 0 && b.length === 0)
+        return 1;
+    const setA = new Set(a);
+    const setB = new Set(b);
+    let intersection = 0;
+    for (const item of setA) {
+        if (setB.has(item))
+            intersection++;
+    }
+    const union = new Set([...setA, ...setB]).size;
+    return union === 0 ? 0 : intersection / union;
+}
+/**
+ * Normalised string similarity (simple containment-based)
+ */
+function textSimilarity(a, b) {
+    if (!a && !b)
+        return 1;
+    if (!a || !b)
+        return 0;
+    const la = a.toLowerCase();
+    const lb = b.toLowerCase();
+    if (la === lb)
+        return 1;
+    if (la.includes(lb) || lb.includes(la))
+        return 0.8;
+    // Character overlap ratio
+    const setA = new Set(la);
+    const setB = new Set(lb);
+    let common = 0;
+    for (const c of setA) {
+        if (setB.has(c))
+            common++;
+    }
+    const total = new Set([...setA, ...setB]).size;
+    return total === 0 ? 0 : common / total * 0.6;
+}
+/**
+ * Compute weighted similarity between a stored fingerprint and a candidate element
+ */
+export function computeSimilarity(stored, candidate) {
+    let score = 0;
+    // Tag name (exact match)
+    score += (stored.tagName === candidate.tagName ? 1 : 0) * WEIGHTS.tagName;
+    // ARIA role
+    if (stored.ariaRole || candidate.ariaRole) {
+        score += (stored.ariaRole === candidate.ariaRole ? 1 : 0) * WEIGHTS.ariaRole;
+    }
+    else {
+        score += WEIGHTS.ariaRole; // both undefined = match
+    }
+    // Classes (Jaccard)
+    score += jaccardSimilarity(stored.classes, candidate.classes) * WEIGHTS.classes;
+    // Text content
+    score += textSimilarity(stored.textContent, candidate.textContent) * WEIGHTS.textContent;
+    // Attributes overlap
+    const storedAttrs = Object.entries(stored.attributes).filter(([, v]) => v);
+    const candidateAttrs = Object.entries(candidate.attributes).filter(([, v]) => v);
+    if (storedAttrs.length === 0 && candidateAttrs.length === 0) {
+        score += WEIGHTS.attributes;
+    }
+    else {
+        let matches = 0;
+        for (const [key, val] of storedAttrs) {
+            const candidateVal = candidate.attributes[key];
+            if (candidateVal === val)
+                matches++;
+        }
+        const total = Math.max(storedAttrs.length, candidateAttrs.length, 1);
+        score += (matches / total) * WEIGHTS.attributes;
+    }
+    // Position hints
+    const posScore = computePositionScore(stored.positionHints, candidate.positionHints);
+    score += posScore * WEIGHTS.positionHints;
+    return Math.min(1, Math.max(0, score));
+}
+function computePositionScore(a, b) {
+    let total = 0;
+    let matches = 0;
+    // Parent tag
+    total++;
+    if (a.parentTag === b.parentTag)
+        matches++;
+    // Child index proximity
+    total++;
+    const indexDiff = Math.abs(a.childIndex - b.childIndex);
+    matches += Math.max(0, 1 - indexDiff / 10);
+    // Sibling count proximity
+    total++;
+    const sibDiff = Math.abs(a.siblingCount - b.siblingCount);
+    matches += Math.max(0, 1 - sibDiff / 10);
+    return matches / total;
+}
+// ============================================================================
+// In-Memory Fingerprint Store (lightweight, no DB dependency)
+// ============================================================================
+/**
+ * Simple in-memory fingerprint store keyed by `pageUrl::selector`
+ */
+export class FingerprintStore {
+    store = new Map();
+    maxPerPage;
+    constructor(maxPerPage = 200) {
+        this.maxPerPage = maxPerPage;
+    }
+    key(pageUrl, selector) {
+        return `${pageUrl}::${selector}`;
+    }
+    get(pageUrl, selector) {
+        return this.store.get(this.key(pageUrl, selector));
+    }
+    set(pageUrl, selector, fp) {
+        const k = this.key(pageUrl, selector);
+        this.store.set(k, fp);
+        // Enforce per-page limit by evicting oldest entries
+        const prefix = `${pageUrl}::`;
+        const pageKeys = [...this.store.keys()].filter((key) => key.startsWith(prefix));
+        if (pageKeys.length > this.maxPerPage) {
+            const toRemove = pageKeys.length - this.maxPerPage;
+            for (let i = 0; i < toRemove; i++) {
+                this.store.delete(pageKeys[i]);
+            }
+        }
+    }
+    size() {
+        return this.store.size;
+    }
+    clear() {
+        this.store.clear();
+    }
+}
+// ============================================================================
+// Adaptive Locator Service
+// ============================================================================
+/**
+ * Adaptive Locator Service
+ *
+ * Provides fallback element resolution when primary selectors fail.
+ * Maintains a fingerprint database of previously-matched elements
+ * and uses weighted similarity to find the best match.
+ */
+export class AdaptiveLocatorService {
+    config;
+    fingerprintStore;
+    constructor(config) {
+        this.config = { ...DEFAULT_ADAPTIVE_LOCATOR_CONFIG, ...config };
+        this.fingerprintStore = new FingerprintStore(this.config.maxFingerprintsPerPage);
+    }
+    /**
+     * Capture and store a fingerprint for a successfully-interacted element
+     */
+    async captureFingerprint(selector, client, pageUrl) {
+        if (!this.config.enabled)
+            return null;
+        try {
+            const cssSelector = this.toCssForCapture(selector);
+            if (!cssSelector)
+                return null;
+            const result = await client.evaluate(buildCaptureScript(cssSelector));
+            if (!result.success || !result.value)
+                return null;
+            const fingerprint = result.value;
+            fingerprint.matchCount = (this.fingerprintStore.get(pageUrl, selector)?.matchCount ?? 0) + 1;
+            fingerprint.lastMatchedAt = new Date().toISOString();
+            this.fingerprintStore.set(pageUrl, selector, fingerprint);
+            return fingerprint;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Resolve an element target with adaptive fallback chain.
+     *
+     * 1. Try primary selector
+     * 2. Text-based match
+     * 3. ARIA-based match
+     * 4. Fingerprint similarity matching
+     */
+    async resolveWithFallback(selector, client, pageUrl) {
+        if (!this.config.enabled)
+            return null;
+        const storedFingerprint = this.fingerprintStore.get(pageUrl, selector);
+        if (!storedFingerprint)
+            return null;
+        for (const method of this.config.fallbackChain) {
+            const result = await this.tryFallbackMethod(method, storedFingerprint, client);
+            if (result)
+                return result;
+        }
+        return null;
+    }
+    /**
+     * Get the fingerprint store size (for diagnostics)
+     */
+    getStoreSize() {
+        return this.fingerprintStore.size();
+    }
+    /**
+     * Clear all stored fingerprints
+     */
+    clearFingerprints() {
+        this.fingerprintStore.clear();
+    }
+    // ==========================================================================
+    // Private Helpers
+    // ==========================================================================
+    async tryFallbackMethod(method, stored, client) {
+        switch (method) {
+            case 'text':
+                return this.tryTextMatch(stored, client);
+            case 'aria':
+                return this.tryAriaMatch(stored, client);
+            case 'fingerprint':
+                return this.tryFingerprintMatch(stored, client);
+            default:
+                return null;
+        }
+    }
+    async tryTextMatch(stored, client) {
+        if (!stored.textContent)
+            return null;
+        const safeText = JSON.stringify(stored.textContent);
+        const script = `
+      (() => {
+        const target = ${safeText};
+        const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_ELEMENT);
+        while (walker.nextNode()) {
+          const el = walker.currentNode;
+          const text = (el.textContent || '').trim().slice(0, 200);
+          if (text === target) {
+            if (el.id) return '#' + CSS.escape(el.id);
+            if (el.getAttribute('data-testid')) return '[data-testid="' + el.getAttribute('data-testid') + '"]';
+            return null;
+          }
+        }
+        return null;
+      })()
+    `;
+        try {
+            const result = await client.evaluate(script);
+            if (result.success && result.value) {
+                return {
+                    resolvedSelector: result.value,
+                    method: 'text',
+                    similarityScore: 0.9,
+                    fingerprintUpdated: false,
+                };
+            }
+        }
+        catch {
+            // continue to next method
+        }
+        return null;
+    }
+    async tryAriaMatch(stored, client) {
+        if (!stored.ariaRole && !stored.ariaLabel)
+            return null;
+        let ariaSelector = '';
+        if (stored.ariaRole && stored.ariaLabel) {
+            ariaSelector = `[role="${stored.ariaRole}"][aria-label="${stored.ariaLabel}"]`;
+        }
+        else if (stored.ariaLabel) {
+            ariaSelector = `[aria-label="${stored.ariaLabel}"]`;
+        }
+        else if (stored.ariaRole) {
+            ariaSelector = `[role="${stored.ariaRole}"]`;
+        }
+        if (!ariaSelector)
+            return null;
+        try {
+            const checkScript = `!!document.querySelector(${JSON.stringify(ariaSelector)})`;
+            const result = await client.evaluate(checkScript);
+            if (result.success && result.value) {
+                return {
+                    resolvedSelector: ariaSelector,
+                    method: 'aria',
+                    similarityScore: 0.85,
+                    fingerprintUpdated: false,
+                };
+            }
+        }
+        catch {
+            // continue to next method
+        }
+        return null;
+    }
+    async tryFingerprintMatch(stored, client) {
+        try {
+            const result = await client.evaluate(buildCandidatesScript());
+            if (!result.success || !result.value?.length)
+                return null;
+            let bestScore = 0;
+            let bestSelector = '';
+            for (const candidate of result.value) {
+                const score = computeSimilarity(stored, candidate);
+                if (score > bestScore) {
+                    bestScore = score;
+                    bestSelector = candidate.selector;
+                }
+            }
+            if (bestScore >= this.config.similarityThreshold && bestSelector) {
+                return {
+                    resolvedSelector: bestSelector,
+                    method: 'fingerprint',
+                    similarityScore: bestScore,
+                    fingerprintUpdated: false,
+                };
+            }
+        }
+        catch {
+            // fingerprint match failed
+        }
+        return null;
+    }
+    /**
+     * Convert a selector string to a CSS selector suitable for capture.
+     * Returns null for non-CSS selectors that can't be used with querySelector.
+     */
+    toCssForCapture(selector) {
+        if (selector.startsWith('//') || selector.startsWith('xpath='))
+            return null;
+        if (/^@?e\d+$/.test(selector))
+            return null;
+        if (selector.startsWith('text='))
+            return null;
+        return selector;
+    }
+}
+//# sourceMappingURL=adaptive-locator-service.js.map

package/dist/domains/test-execution/services/e2e/adaptive-locator-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-locator-service.js","sourceRoot":"","sources":["../../../../../src/domains/test-execution/services/e2e/adaptive-locator-service.ts"],"names":[],"mappings":"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"}

package/dist/domains/test-execution/services/e2e/adaptive-locator-types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Adaptive Locator Types
+ *
+ * Inspired by Scrapling's similarity-based element matching.
+ * When a CSS/XPath selector fails, falls back to fingerprint-based
+ * element matching to reduce E2E flakiness from UI changes.
+ *
+ * @module test-execution/services/e2e/adaptive-locator-types
+ */
+/**
+ * Captured fingerprint of a DOM element for similarity matching.
+ * Stored after successful interactions to enable fallback matching.
+ */
+export interface ElementFingerprint {
+    /** HTML tag name (e.g., 'button', 'input', 'a') */
+    tagName: string;
+    /** CSS classes on the element */
+    classes: string[];
+    /** WAI-ARIA role */
+    ariaRole?: string;
+    /** WAI-ARIA label */
+    ariaLabel?: string;
+    /** Visible text content (trimmed, max 200 chars) */
+    textContent?: string;
+    /** Key attributes for matching */
+    attributes: {
+        id?: string;
+        name?: string;
+        'data-testid'?: string;
+        type?: string;
+        placeholder?: string;
+        href?: string;
+    };
+    /** Structural position hints */
+    positionHints: {
+        parentTag?: string;
+        childIndex: number;
+        siblingCount: number;
+    };
+    /** Number of times this fingerprint matched */
+    matchCount: number;
+    /** Last time this fingerprint was matched (ISO string) */
+    lastMatchedAt: string;
+}
+/**
+ * Configuration for the adaptive locator service
+ */
+export interface AdaptiveLocatorConfig {
+    /** Enable adaptive locator fallback */
+    enabled: boolean;
+    /** Minimum similarity score (0-1) to accept a fingerprint match */
+    similarityThreshold: number;
+    /** Maximum fingerprints to store per page */
+    maxFingerprintsPerPage: number;
+    /** Memory namespace for fingerprint storage */
+    namespace: string;
+    /** Fallback chain order */
+    fallbackChain: Array<'text' | 'aria' | 'fingerprint'>;
+}
+/**
+ * Default adaptive locator configuration
+ */
+export declare const DEFAULT_ADAPTIVE_LOCATOR_CONFIG: AdaptiveLocatorConfig;
+/**
+ * Method used to resolve an element target
+ */
+export type LocatorResolutionMethod = 'primary' | 'text' | 'aria' | 'fingerprint';
+/**
+ * Result of adaptive locator resolution
+ */
+export interface LocatorResolutionResult {
+    /** The resolved element target selector */
+    resolvedSelector: string;
+    /** How the element was found */
+    method: LocatorResolutionMethod;
+    /** Similarity score (1.0 for primary, 0-1 for fallbacks) */
+    similarityScore: number;
+    /** Whether the fingerprint database was updated */
+    fingerprintUpdated: boolean;
+}
+//# sourceMappingURL=adaptive-locator-types.d.ts.map

package/dist/domains/test-execution/services/e2e/adaptive-locator-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-locator-types.d.ts","sourceRoot":"","sources":["../../../../../src/domains/test-execution/services/e2e/adaptive-locator-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,UAAU,EAAE;QACV,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,gCAAgC;IAChC,aAAa,EAAE;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,aAAa,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAE,qBAM7C,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,MAAM,EAAE,uBAAuB,CAAC;IAChC,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,kBAAkB,EAAE,OAAO,CAAC;CAC7B"}

package/dist/domains/test-execution/services/e2e/adaptive-locator-types.js

@@ -0,0 +1,20 @@
+/**
+ * Adaptive Locator Types
+ *
+ * Inspired by Scrapling's similarity-based element matching.
+ * When a CSS/XPath selector fails, falls back to fingerprint-based
+ * element matching to reduce E2E flakiness from UI changes.
+ *
+ * @module test-execution/services/e2e/adaptive-locator-types
+ */
+/**
+ * Default adaptive locator configuration
+ */
+export const DEFAULT_ADAPTIVE_LOCATOR_CONFIG = {
+    enabled: true,
+    similarityThreshold: 0.6,
+    maxFingerprintsPerPage: 200,
+    namespace: 'aqe/adaptive-locators',
+    fallbackChain: ['text', 'aria', 'fingerprint'],
+};
+//# sourceMappingURL=adaptive-locator-types.js.map

package/dist/domains/test-execution/services/e2e/adaptive-locator-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-locator-types.js","sourceRoot":"","sources":["../../../../../src/domains/test-execution/services/e2e/adaptive-locator-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8DH;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAA0B;IACpE,OAAO,EAAE,IAAI;IACb,mBAAmB,EAAE,GAAG;IACxB,sBAAsB,EAAE,GAAG;IAC3B,SAAS,EAAE,uBAAuB;IAClC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC;CAC/C,CAAC"}