automation_model 1.0.441-dev → 1.0.441

package/lib/snapshot_validation.d.ts

@@ -0,0 +1,37 @@
+export declare function highlightSnapshot(snapshot: any, scope: any): Promise<void>;
+/**
+ * One flattened line of an ARIA snapshot
+ */
+interface SnapshotLine {
+    /** original 0-based line number in the file that was parsed */
+    line: number;
+    /** the ARIA role / node name: “text”, “button”, “listitem”…   */
+    key: string;
+    /** the textual value after the role, or null */
+    value: string | null;
+    /** indentation depth (0 = root, 1 = child of the previous level, …) */
+    level: number;
+    /** validation / parsing flags */
+    error: string | null;
+    /** interpret `value` as a RegExp instead of literal text */
+    regex: boolean;
+    /** the original line text */
+    line_text: string;
+}
+export declare function fromLinesToSnapshotLines(lines: string[]): SnapshotLine[];
+/**
+ * Successful-/error-report returned by `matchSnapshot`.
+ *
+ *  ─ matchingLines … full-snapshot **original** line numbers that correspond
+ *                    to every line in the sub-snapshot (same order & length).
+ *  ─ errorLine …..  first sub-snapshot index that could **not** be matched,
+ *                    or -1 when the whole sub-snapshot was found.
+ */
+export interface MatchResult {
+    matchingLines: number[];
+    errorLine: number;
+    errorLineText: string | null;
+}
+export declare function snapshotValidation(snapshot: string, referanceSnapshot: string, snapshotName: string): MatchResult;
+export declare function matchSnapshot(full: SnapshotLine[], sub: SnapshotLine[], snapshotName: string): MatchResult;
+export {};

package/lib/snapshot_validation.js

@@ -0,0 +1,280 @@
+export async function highlightSnapshot(snapshot, scope) { }
+/*
+- banner:
+  - heading "Shop NOW" [level=6]
+- text: Log In Username
+- textbox "Username"
+- text: Password
+- textbox "Password"
+- button "Login"
+- paragraph: "Accepted usernames are:"
+- list:
+  - listitem:
+    - paragraph: blinq_user
+  - listitem:
+    - paragraph: blinq_admin
+- paragraph: "Password for all users:"
+- paragraph: let_me_in
+*/
+class SnapshotNode {
+    key;
+    value;
+    role;
+    name;
+    children = [];
+    parent = null;
+    constructor(key, value) {
+        this.key = key;
+        this.value = value;
+        if (!key) {
+            throw new Error("Key cannot be null or undefined");
+        }
+        this.role = key.split(" ")[0];
+        if (this.value) {
+            this.name = this.value;
+        }
+        else {
+            // the value will be from the first " to the last "
+            const start = key.indexOf('"') + 1;
+            const end = key.lastIndexOf('"');
+            if (start > -1 && end > -1 && start < end) {
+                this.name = key.substring(start, end);
+            }
+            else {
+                this.name = null;
+            }
+        }
+    }
+    generateNodeLocator() {
+        let locator = `internal:role=${this.role}`;
+        switch (this.role) {
+            case "paragraph":
+                // internal:role=paragraph >> internal:text='blinq_user'"
+                return `internal:role=${this.role} >> internal:text='${this.name}'`;
+            default:
+                // "internal:role=textbox[name=\"Password\"]"
+                if (this.name) {
+                    locator += `[name="${this.name}"]`;
+                }
+                return locator;
+        }
+    }
+    getFullLocator() {
+        // create an array of all the parents and current node locators
+        const locators = [];
+        let currentNode = this;
+        while (currentNode) {
+            locators.unshift(currentNode.generateNodeLocator());
+            currentNode = currentNode.parent;
+        }
+        // join the locators with " >> "
+        return locators.join(" >> ");
+    }
+}
+export function fromLinesToSnapshotLines(lines) {
+    // the input is yaml text split into lines, 2 spaces is 1 level
+    const nodes = [];
+    // identify the space count for tabulation
+    let previouseLineSpaceCount = -1;
+    let foundTabulationCount = -1;
+    // look for 2 consecutive lines that have different space counts, the absolute difference is the space count for tabulation
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmedLine = line.trim();
+        if (trimmedLine.length === 0) {
+            continue;
+        }
+        // count the number of leading spaces
+        const match = line.match(/^ */); // Matches spaces at the beginning
+        const count = match ? match[0].length : 0;
+        if (previouseLineSpaceCount !== -1 && previouseLineSpaceCount !== count) {
+            foundTabulationCount = Math.abs(previouseLineSpaceCount - count);
+            break;
+        }
+        previouseLineSpaceCount = count;
+    }
+    if (foundTabulationCount === -1) {
+        foundTabulationCount = 2;
+    }
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmedLine = line.trim();
+        if (trimmedLine.length === 0) {
+            continue;
+        }
+        // count the number of leading spaces
+        let level = 0;
+        const match = line.match(/^ */); // Matches spaces at the beginning
+        const count = match ? match[0].length : 0;
+        level = count / foundTabulationCount; // 2 spaces is 1 level
+        // find the start of the line: - and space
+        const start = line.indexOf("- ") + 2;
+        if (start === -1) {
+            // no - found, set it to error
+            nodes.push({
+                line: i,
+                line_text: line,
+                key: line,
+                value: null,
+                level,
+                error: "No - found",
+                regex: false,
+            });
+            continue;
+        }
+        // first we need to extract the role, we should find the first space or : after the start
+        const end = line.indexOf(" ", start);
+        const end2 = line.indexOf(":", start);
+        if (end === -1 && end2 === -1) {
+            // no space or : found, set it to error
+            nodes.push({
+                line: i,
+                line_text: line,
+                key: line,
+                value: null,
+                level,
+                error: "No space or : found",
+                regex: false,
+            });
+            continue;
+        }
+        const endIndex = end === -1 ? end2 : end2 === -1 ? end : Math.min(end, end2);
+        const key = line.substring(start, endIndex).trim();
+        // define value is string or null
+        let value = line.substring(endIndex + 1).trim();
+        if (value.startsWith('"')) {
+            const lastQuote = value.lastIndexOf('"');
+            if (lastQuote !== -1) {
+                value = value.substring(0, lastQuote + 1);
+            }
+        }
+        // improved regex detection
+        const rawValue = value.endsWith(":") ? value.slice(0, -1) : value;
+        const regex = rawValue.startsWith("/") && /\/[a-z]*$/.test(rawValue);
+        nodes.push({
+            line: i,
+            line_text: line,
+            key,
+            value: value.length > 0 ? value : null,
+            level,
+            error: null,
+            regex,
+        });
+    }
+    return nodes;
+}
+/**
+ * Turn a “/pattern/flags” string into a real RegExp.
+ */
+function toRegExp(raw) {
+    // Remove trailing colon from YAML-style key: /pattern/: → /pattern/
+    const sanitized = raw.endsWith(":") ? raw.slice(0, -1) : raw;
+    if (!sanitized.startsWith("/"))
+        return new RegExp(sanitized);
+    const lastSlash = sanitized.lastIndexOf("/");
+    const pattern = sanitized.slice(1, lastSlash);
+    const flags = sanitized.slice(lastSlash + 1); // i, g, etc.
+    return new RegExp(pattern, flags);
+}
+/**
+ * Single-line comparison with fixed regex handling.
+ */
+function lineMatches(full, sub) {
+    let status = { status: false };
+    if (full.key !== sub.key)
+        return status;
+    // We handle level offset outside this function
+    if (sub.value === null) {
+        status.status = true;
+        return status;
+    }
+    if (sub.regex) {
+        status.status = toRegExp(sub.value).test(full.value ?? "");
+    }
+    else if (full.regex) {
+        status.status = toRegExp(full.value).test(sub.value ?? "");
+    }
+    else {
+        status.status = full.value === sub.value;
+    }
+    return status;
+}
+export function snapshotValidation(snapshot, referanceSnapshot, snapshotName) {
+    const lines = snapshot.split("\n");
+    const nodes = fromLinesToSnapshotLines(lines);
+    const subLines = referanceSnapshot.split("\n");
+    const subNodes = fromLinesToSnapshotLines(subLines);
+    return matchSnapshot(nodes, subNodes, snapshotName);
+}
+export function matchSnapshot(full, sub, snapshotName) {
+    const parentIdx = sub.map((_, i) => {
+        for (let j = i - 1; j >= 0; j--)
+            if (sub[j].level < sub[i].level)
+                return j;
+        return -1;
+    });
+    const fullIdx = new Array(sub.length);
+    const mapping = new Array(sub.length);
+    let failureAt = -1;
+    function dfs(s, fFrom, baseLevelOffset) {
+        if (s === sub.length)
+            return true;
+        for (let f = fFrom; f < full.length; f++) {
+            let levelMatch = true;
+            if (baseLevelOffset !== null) {
+                // Must match levels relative to initial offset
+                if (full[f].level !== sub[s].level + baseLevelOffset)
+                    continue;
+            }
+            const status = lineMatches(full[f], sub[s]);
+            if (!status.status)
+                continue;
+            // For first match, set level offset
+            const nextBaseOffset = baseLevelOffset !== null ? baseLevelOffset : full[f].level - sub[s].level;
+            const pSub = parentIdx[s];
+            if (pSub !== -1) {
+                let pFull = f - 1;
+                while (pFull >= 0 && full[pFull].level >= full[f].level)
+                    pFull--;
+                if (pFull < 0 || pFull !== fullIdx[pSub])
+                    continue;
+            }
+            fullIdx[s] = f;
+            mapping[s] = full[f].line;
+            if (dfs(s + 1, f + 1, nextBaseOffset))
+                return true;
+        }
+        if (failureAt === -1)
+            failureAt = s;
+        return false;
+    }
+    const found = dfs(0, 0, null);
+    let error = null;
+    if (!found) {
+        error = `Snapshot file: ${snapshotName}\nLine no.: ${sub[failureAt].line}\nLine: ${sub[failureAt].line_text}`;
+    }
+    return {
+        matchingLines: found ? mapping : mapping.slice(0, failureAt),
+        errorLine: found ? -1 : failureAt,
+        errorLineText: error,
+    };
+}
+// let ttt = `- banner:
+//   - heading "Shop NOW" [level=6]
+// - text: Log In Username
+// - textbox "Username"
+// - text: Password
+// - textbox "Password"
+// - button "Login"
+// - paragraph: "Accepted usernames are:"
+// - list:
+//   - listitem:
+//     - paragraph: blinq_user
+//   - listitem:
+//     - paragraph: blinq_admin
+// - paragraph: "Password for all users:"
+// - paragraph: let_me_in`;
+// const lines = ttt.split("\n");
+// const nodes = fromLinesToSnapshotLines(lines);
+// console.log("nodes", nodes);
+//# sourceMappingURL=snapshot_validation.js.map

package/lib/snapshot_validation.js.map

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

package/lib/stable_browser.d.ts

@@ -1,44 +1,95 @@
 import type { Browser, Page } from "playwright";
-type Params = Record<string, string>;
+import { Params } from "./utils.js";
+export declare const Types: {
+    CLICK: string;
+    WAIT_ELEMENT: string;
+    NAVIGATE: string;
+    FILL: string;
+    EXECUTE: string;
+    OPEN: string;
+    COMPLETE: string;
+    ASK: string;
+    GET_PAGE_STATUS: string;
+    CLICK_ROW_ACTION: string;
+    VERIFY_ELEMENT_CONTAINS_TEXT: string;
+    VERIFY_PAGE_CONTAINS_TEXT: string;
+    VERIFY_PAGE_CONTAINS_NO_TEXT: string;
+    ANALYZE_TABLE: string;
+    SELECT: string;
+    VERIFY_PAGE_PATH: string;
+    TYPE_PRESS: string;
+    PRESS: string;
+    HOVER: string;
+    CHECK: string;
+    UNCHECK: string;
+    EXTRACT: string;
+    CLOSE_PAGE: string;
+    TABLE_OPERATION: string;
+    SET_DATE_TIME: string;
+    SET_VIEWPORT: string;
+    VERIFY_VISUAL: string;
+    LOAD_DATA: string;
+    SET_INPUT: string;
+    WAIT_FOR_TEXT_TO_DISAPPEAR: string;
+    VERIFY_ATTRIBUTE: string;
+    VERIFY_TEXT_WITH_RELATION: string;
+    BRUNO: string;
+    VERIFY_FILE_EXISTS: string;
+    SET_INPUT_FILES: string;
+    SNAPSHOT_VALIDATION: string;
+};
+export declare const apps: {};
 declare class StableBrowser {
     browser: Browser;
     page: Page;
     logger: any;
     context: any;
+    world?: any;
     project_path: null;
     webLogFile: null;
+    networkLogger: null;
     configuration: null;
-    constructor(browser: Browser, page: Page, logger?: any, context?: any);
-    getWebLogFile(logFolder: string): string;
-    registerConsoleLogListener(page: Page, context: any, logFile: string): void;
-    registerRequestListener(): void;
-    goto(url: string): Promise<void>;
-    _validateSelectors(selectors: any): void;
-    _fixUsingParams(text: any, _params: Params): any;
-    _fixLocatorUsingParams(locator: any, _params: Params): any;
-    _isObject(value: any): any;
-    scanAndManipulate(currentObj: any, _params: Params): void;
-    _getLocator(locator: any, scope: any, _params: any): any;
+    appName: string;
+    tags: null;
+    isRecording: boolean;
+    initSnapshotTaken: boolean;
+    constructor(browser: Browser, page: Page, logger?: any, context?: any, world?: any);
+    registerEventListeners(context: any): void;
+    switchApp(appName: any): Promise<void>;
+    switchTab(tabTitleOrIndex: number | string): Promise<void>;
+    registerConsoleLogListener(page: Page, context: any): void;
+    registerRequestListener(page: Page, context: any, logFile: string): void;
+    goto(url: string, world?: null): Promise<void>;
+    _getLocator(locator: any, scope: any, _params: any): Promise<any>;
     _locateElmentByTextClimbCss(scope: any, text: any, climb: any, css: any, _params: Params): Promise<string | undefined>;
-    _locateElementByText(scope: any, text1: any, tag1: any, regex1: boolean | undefined, partial1: any, _params: Params): Promise<any>;
-    _collectLocatorInformation(selectorHierarchy: any, index: number | undefined, scope: any, foundLocators: any, _params: Params, info: any, visibleOnly?: boolean): Promise<void>;
+    _locateElementByText(scope: any, text1: any, tag1: any, regex1: boolean | undefined, partial1: any, ignoreCase: boolean | undefined, _params: Params): Promise<{
+        elementCount: number;
+        randomToken: string;
+    }>;
+    _collectLocatorInformation(selectorHierarchy: any, index: number | undefined, scope: any, foundLocators: any, _params: Params, info: any, visibleOnly?: boolean, allowDisabled?: boolean | undefined, element_name?: null, logErrors?: boolean | undefined): Promise<void>;
     closeUnexpectedPopups(info: any, _params: any): Promise<{
         rerun: boolean;
     }>;
-    _locate(selectors: any, info: any, _params?: Params, timeout?: number): Promise<any>;
-    _locate_internal(selectors: any, info: any, _params?: Params, timeout?: number): Promise<any>;
-    _scanLocatorsGroup(locatorsGroup: any, scope: any, _params: any, info: any, visibleOnly: any): Promise<{
+    _locate(selectors: any, info: any, _params?: Params, timeout: any, allowDisabled?: boolean | undefined): Promise<any>;
+    _findFrameScope(selectors: any, timeout: number | undefined, info: any): Promise<any>;
+    _getDocumentBody(selectors: any, timeout: number | undefined, info: any): Promise<any>;
+    _locate_internal(selectors: any, info: any, _params?: Params, timeout?: number, allowDisabled?: boolean | undefined): Promise<any>;
+    _scanLocatorsGroup(locatorsGroup: any, scope: any, _params: any, info: any, visibleOnly: any, allowDisabled?: boolean | undefined, element_name: any, logErrors?: boolean | undefined): Promise<{
         foundElements: any[];
     }>;
-    click(selectors: any, _params?: Params, options?: {}, world?: null): Promise<{}>;
-    setCheck(selectors: any, checked?: boolean, _params?: Params, options?: {}, world?: null): Promise<{}>;
-    hover(selectors: any, _params?: Params, options?: {}, world?: null): Promise<{}>;
-    selectOption(selectors: any, values: any, _params?: null, options?: {}, world?: null): Promise<{}>;
-    type(_value: any, _params?: null, options?: {}, world?: null): Promise<{}>;
+    simpleClick(elementDescription: any, _params?: Params, options?: {}, world?: null): Promise<void>;
+    simpleClickType(elementDescription: any, value: any, _params?: Params, options?: {}, world?: null): Promise<void>;
+    click(selectors: any, _params?: Params, options?: {}, world?: null): Promise<any>;
+    waitForElement(selectors: any, _params?: Params, options?: {}, world?: null): Promise<boolean>;
+    setCheck(selectors: any, checked?: boolean, _params?: Params, options?: {}, world?: null): Promise<any>;
+    hover(selectors: any, _params?: Params, options?: {}, world?: null): Promise<any>;
+    selectOption(selectors: any, values: any, _params?: null, options?: {}, world?: null): Promise<any>;
+    type(_value: any, _params?: null, options?: {}, world?: null): Promise<any>;
     setInputValue(selectors: any, value: any, _params?: null, options?: {}, world?: null): Promise<void>;
     setDateTime(selectors: any, value: any, format?: null, enter?: boolean, _params?: null, options?: {}, world?: null): Promise<void>;
-    clickType(selectors: any, _value: any, enter?: boolean, _params?: null, options?: {}, world?: null): Promise<{}>;
-    fill(selectors: any, value: any, enter?: boolean, _params?: null, options?: {}, world?: null): Promise<{}>;
+    clickType(selectors: any, _value: any, enter?: boolean, _params?: null, options?: {}, world?: null): Promise<any>;
+    fill(selectors: any, value: any, enter?: boolean, _params?: null, options?: {}, world?: null): Promise<any>;
+    setInputFiles(selectors: any, files: any, _params?: null, options?: {}, world?: null): Promise<any>;
     getText(selectors: any, _params?: null, options?: {}, info?: {}, world?: null): Promise<{
         text: any;
         screenshotId: any;
@@ -65,11 +116,12 @@ declare class StableBrowser {
         value: any;
         element?: undefined;
     }>;
-    containsPattern(selectors: any, pattern: any, text: any, _params?: null, options?: {}, world?: null): Promise<{}>;
-    containsText(selectors: any, text: any, climb: any, _params?: null, options?: {}, world?: null): Promise<{}>;
-    _getDataFile(world?: null): string;
+    containsPattern(selectors: any, pattern: any, text: any, _params?: null, options?: {}, world?: null): Promise<any>;
+    containsText(selectors: any, text: any, climb: any, _params?: null, options?: {}, world?: null): Promise<any>;
+    snapshotValidation(frameSelectors: any, referanceSnapshot: any, _params?: null, options?: {}, world?: null): Promise<any>;
     waitForUserInput(message: any, world?: null): Promise<void>;
     setTestData(testData: any, world?: null): void;
+    overwriteTestData(testData: any, world?: null): void;
     _getDataFilePath(fileName: any): string;
     _parseCSVSync(filePath: any): Promise<unknown>;
     loadTestData(type: string, dataSelector: string, world?: null): {
@@ -81,28 +133,48 @@ declare class StableBrowser {
     getTestData(world?: null): {};
     _screenShot(options?: {}, world?: null, info?: null): Promise<{}>;
     takeScreenshot(screenshotPath: any): Promise<any>;
-    verifyElementExistInPage(selectors: any, _params?: null, options?: {}, world?: null): Promise<{}>;
-    extractAttribute(selectors: any, attribute: any, variable: any, _params?: null, options?: {}, world?: null): Promise<{}>;
+    verifyElementExistInPage(selectors: any, _params?: null, options?: {}, world?: null): Promise<any>;
+    extractAttribute(selectors: any, attribute: any, variable: any, _params?: null, options?: {}, world?: null): Promise<any>;
+    verifyAttribute(selectors: any, attribute: any, value: any, _params?: null, options?: {}, world?: null): Promise<any>;
     extractEmailData(emailAddress: any, options: any, world: any): Promise<{
         emailUrl: any;
         emailCode: any;
     }>;
     _highlightElements(scope: any, css: any): Promise<void>;
     verifyPagePath(pathPart: any, options?: {}, world?: null): Promise<{} | undefined>;
-    verifyTextExistInPage(text: any, options?: {}, world?: null): Promise<{}>;
-    _getServerUrl(): string;
-    visualVerification(text: any, options?: {}, world?: null): Promise<{}>;
+    verifyPageTitle(title: any, options?: {}, world?: null): Promise<{} | undefined>;
+    findTextInAllFrames(dateAlternatives: any, numberAlternatives: any, text: any, state: any, partial?: boolean, ignoreCase?: boolean): Promise<{
+        elementCount: number;
+        randomToken: string;
+    }[]>;
+    verifyTextExistInPage(text: any, options?: {}, world?: null): Promise<any>;
+    waitForTextToDisappear(text: any, options?: {}, world?: null): Promise<any>;
+    verifyTextRelatedToText(textAnchor: string, climb: number, textToVerify: string, options?: {}, world?: any): Promise<any>;
+    findRelatedTextInAllFrames(textAnchor: string, climb: number, textToVerify: string, params?: Params, options?: {}, world?: any): Promise<{
+        elementCount: number;
+        randomToken: string;
+    }[]>;
+    visualVerification(text: any, options?: {}, world?: null): Promise<{} | undefined>;
     verifyTableData(selectors: any, data: any, _params?: null, options?: {}, world?: null): Promise<void>;
     getTableData(selectors: any, _params?: null, options?: {}, world?: null): Promise<any>;
-    analyzeTable(selectors: any, query: any, operator: any, value: any, _params?: null, options?: {}, world?: null): Promise<{}>;
-    _replaceWithLocalData(value: any, world: any, _decrypt?: boolean, totpWait?: boolean): Promise<any>;
+    analyzeTable(selectors: any, query: any, operator: any, value: any, _params?: null, options?: {}, world?: null): Promise<{} | undefined>;
+    _replaceWithLocalData(value: any, world: any, _decrypt?: boolean, totpWait?: boolean): Promise<string>;
     _getLoadTimeout(options: any): number;
+    _getFindElementTimeout(options: any): any;
+    saveStoreState(path?: string | null, world?: any): Promise<void>;
+    restoreSaveState(path?: string | null, world?: any): Promise<void>;
     waitForPageLoad(options?: {}, world?: null): Promise<void>;
     closePage(options?: {}, world?: null): Promise<void>;
+    tableCellOperation(headerText: string, rowText: string, options: any, _params: Params, world?: null): Promise<void>;
+    saveTestDataAsGlobal(options: any, world: any): void;
     setViewportSize(width: number, hight: number, options?: {}, world?: null): Promise<void>;
     reloadPage(options?: {}, world?: null): Promise<void>;
     scrollIfNeeded(element: any, info: any): Promise<void>;
-    _reportToWorld(world: any, properties: JsonCommandReport): void;
+    beforeScenario(world: any, scenario: any): Promise<void>;
+    afterScenario(world: any, scenario: any): Promise<void>;
+    beforeStep(world: any, step: any): Promise<void>;
+    getAriaSnapshot(): Promise<string | null>;
+    afterStep(world: any, step: any): Promise<void>;
 }
 type JsonTimestamp = number;
 type JsonResultPassed = {
@@ -117,7 +189,7 @@ type JsonResultFailed = {
     message?: string;
 };
 type JsonCommandResult = JsonResultPassed | JsonResultFailed;
-type JsonCommandReport = {
+export type JsonCommandReport = {
     type: string;
     value?: string;
     text: string;