ff-automationv2 2.2.0 → 2.2.5

package/src/utils/DomExtraction/jsForAttributeInjection.ts

@@ -1,378 +0,0 @@
-import { logger } from "../../utils/logger/logData.js"
-export interface AnnotatedDOMResult {
-    dom: string;
-    // selectors: Record<string, string>;
-}
-
-export async function getAnnotatedDOM(
-    browser: WebdriverIO.Browser
-): Promise<AnnotatedDOMResult> {
-
-    return await browser.execute<AnnotatedDOMResult, []>(() => {
-
-        let nodeIndex = 0;
-        // const xpaths: Record<string, string> = {};
-
-        // ==========================================================
-        // COVERAGE CHECK
-        // ==========================================================
-        function getCoverageStatus(el: Element): string {
-
-            if (!el || !el.getBoundingClientRect) return "unknown";
-
-            const rect = el.getBoundingClientRect();
-            if (rect.width === 0 || rect.height === 0) return "false";
-
-            const testPoints = [
-                [rect.left + 5, rect.top + 5],
-                [rect.right - 5, rect.top + 5],
-                [rect.left + 5, rect.bottom - 5],
-                [rect.right - 5, rect.bottom - 5],
-                [rect.left + rect.width / 2, rect.top + rect.height / 2]
-            ];
-
-            for (const [x, y] of testPoints) {
-
-                const topEl = document.elementFromPoint(x, y);
-                if (!topEl) continue;
-
-                if (topEl === el || el.contains(topEl)) continue;
-
-                const style = getComputedStyle(topEl);
-
-                if (
-                    style.pointerEvents === "none" ||
-                    style.opacity === "0" ||
-                    style.visibility === "hidden"
-                ) continue;
-
-                if (el.closest("label")?.contains(topEl)) continue;
-                if (topEl.closest("label")?.contains(el)) continue;
-                if (el.parentElement?.contains(topEl)) continue;
-
-                const isBlocking =
-                    ["BUTTON", "A"].includes(topEl.tagName) ||
-                    (topEl as HTMLElement).onclick ||
-                    topEl.getAttribute("role") === "button";
-
-                if (isBlocking) return "true";
-            }
-
-            return "false";
-        }
-
-        // ==========================================================
-        // VISIBILITY CHECK
-        // ==========================================================
-        function isUsable(node: Element): boolean {
-
-            const s = getComputedStyle(node);
-
-            if (
-                s.display === "none" ||
-                s.visibility === "hidden" ||
-                s.opacity === "0" ||
-                s.pointerEvents === "none"
-            ) return false;
-
-            const rect = node.getBoundingClientRect();
-            if (rect.width === 0 || rect.height === 0) return false;
-
-            return true;
-        }
-
-        // ==========================================================
-        // ANNOTATION
-        // ==========================================================
-        function annotate(node: Element): void {
-
-            const s = getComputedStyle(node);
-
-            node.setAttribute("element-visibility", s.visibility || "");
-            node.setAttribute("element-pointer-events", s.pointerEvents || "");
-            node.setAttribute("element-zindex", s.zIndex || "");
-
-            if (!isUsable(node)) {
-                node.setAttribute("element-covered", "true");
-                return;
-            }
-
-            try {
-                node.setAttribute(
-                    "element-covered",
-                    getCoverageStatus(node)
-                );
-            } catch {
-                node.setAttribute("element-covered", "unknown");
-            }
-        }
-
-        // ==========================================================
-        // XPATH (Shadow + iframe safe)
-        // ==========================================================
-        function getXPath(node: Element): string {
-
-            if (!node || node.nodeType !== 1) return "";
-
-            const segments: string[] = [];
-            let current: Element | null = node;
-
-            while (current && current.nodeType === 1) {
-
-                const parent = current.parentNode;
-
-                if (parent instanceof ShadowRoot) {
-
-                    const host = parent.host;
-
-                    const siblings = Array.from(parent.children)
-                        .filter(n => n.tagName === current!.tagName);
-
-                    const index = siblings.indexOf(current) + 1;
-
-                    segments.unshift(
-                        "shadow/" +
-                        current.tagName.toLowerCase() +
-                        "[" + index + "]"
-                    );
-
-                    current = host as Element;
-                    continue;
-                }
-
-                let index = 1;
-
-                if (parent && (parent as Element).children) {
-
-                    const siblings = Array.from(
-                        (parent as Element).children
-                    ).filter(n => n.tagName === current!.tagName);
-
-                    index = siblings.indexOf(current) + 1;
-                }
-
-                segments.unshift(
-                    current.tagName.toLowerCase() +
-                    "[" + index + "]"
-                );
-
-                if (!parent || parent.nodeType !== 1) break;
-
-                current = parent as Element;
-            }
-
-            let path = "/" + segments.join("/");
-
-            if (node.ownerDocument !== document) {
-
-                const frameEl =
-                    node.ownerDocument.defaultView?.frameElement;
-
-                if (frameEl) {
-
-                    let framePath =
-                        frameEl.getAttribute("ff-xpath");
-
-                    if (!framePath) {
-                        framePath = getXPath(frameEl);
-                    }
-
-                    path = framePath + path;
-                }
-            }
-
-            return path;
-        }
-
-        // ==========================================================
-        // TRUE NODE WALK (TreeWalker)
-        // ==========================================================
-        function walk(root: Node): void {
-
-            const walker = document.createTreeWalker(
-                root,
-                NodeFilter.SHOW_ELEMENT,
-                null
-            );
-
-            let node = walker.currentNode as Element | null;
-
-            while (node) {
-
-                if (
-                    node.nodeType === 1 &&
-                    !["META", "STYLE", "SCRIPT"]
-                        .includes(node.tagName)
-                ) {
-
-                    const fireId =
-                        "Fire-Flink-" + nodeIndex++;
-
-                    const xpath = getXPath(node);
-
-                    node.setAttribute("ff-inspect", fireId);
-                    node.setAttribute("ff-xpath", xpath);
-
-                    // xpaths[fireId] = xpath;
-
-                    annotate(node);
-                }
-
-                if ((node as HTMLElement).shadowRoot) {
-                    walk((node as HTMLElement).shadowRoot!);
-                }
-
-                if (node.tagName === "IFRAME") {
-                    try {
-                        const doc =
-                            (node as HTMLIFrameElement)
-                                .contentDocument;
-
-                        if (doc?.documentElement) {
-                            walk(doc.documentElement);
-                        }
-                    } catch {
-                        node.setAttribute(
-                            "ff-cross-origin",
-                            "true"
-                        );
-                    }
-                }
-
-                node = walker.nextNode() as Element | null;
-            }
-        }
-
-        // Start traversal
-        walk(document.documentElement);
-
-        // ==========================================================
-        // SERIALIZER
-        // ==========================================================
-        function serializeNode(node: Node): string {
-
-            if (node.nodeType === Node.TEXT_NODE)
-                return node.textContent || "";
-
-            if (node.nodeType !== Node.ELEMENT_NODE)
-                return "";
-
-            const el = node as Element;
-            const tag = el.tagName.toLowerCase();
-
-            let html = "<" + tag;
-
-            for (const attr of Array.from(el.attributes)) {
-                if (attr.name === "srcdoc") continue;
-
-                html +=
-                    " " + attr.name +
-                    "=\"" +
-                    attr.value.replace(/"/g, "&quot;") +
-                    "\"";
-            }
-
-            html += ">";
-
-            if ((el as HTMLElement).shadowRoot) {
-                html += "<!--#shadow-root-->";
-                (el as HTMLElement)
-                    .shadowRoot!
-                    .childNodes
-                    .forEach(child => {
-                        html += serializeNode(child);
-                    });
-                html += "<!--#/shadow-root-->";
-            }
-
-            if (
-                tag === "iframe" &&
-                el.getAttribute("ff-cross-origin") !== "true"
-            ) {
-                try {
-                    const doc =
-                        (el as HTMLIFrameElement)
-                            .contentDocument;
-
-                    if (doc) {
-                        html += serializeNode(
-                            doc.documentElement
-                        );
-                    }
-                } catch (error) {
-
-                    logger.error("Attribute injection failed", error)
-                }
-            }
-
-            el.childNodes.forEach(child => {
-                html += serializeNode(child);
-            });
-
-            html += "</" + tag + ">";
-            return html;
-        }
-
-        return {
-            dom:
-                "<!DOCTYPE html>\n" +
-                serializeNode(document.documentElement)
-            // selectors: xpaths
-        };
-
-    });
-}
-
-import { DOMParser, XMLSerializer } from "@xmldom/xmldom";
-
-export async function getAnnotatedDOMForMobile(
-    driver: WebdriverIO.Browser
-): Promise<AnnotatedDOMResult> {
-
-    try {
-
-        // Wait like Python sleep(2)
-        await driver.pause(2000);
-
-        const pageSource = await driver.getPageSource();
-
-        if (!pageSource) {
-            throw new Error("Unable to capture DOM");
-        }
-
-        // Parse XML DOM
-        const parser = new DOMParser();
-        const xmlDoc = parser.parseFromString(pageSource, "text/xml");
-
-        const allElements = xmlDoc.getElementsByTagName("*");
-
-        let index = 1;
-
-        for (const element of Array.from(allElements)) {
-            element.setAttribute("FF-inspecter", `Fire-Flink-${index}`);
-            index++;
-        }
-
-        // Convert DOM back to string
-        const serializer = new XMLSerializer();
-        let annotatedXML = serializer.serializeToString(xmlDoc);
-
-        // Preserve XML declaration if present
-        if (pageSource.trim().startsWith("<?xml")) {
-            const declarationEnd = pageSource.indexOf("?>");
-
-            if (declarationEnd !== -1) {
-                const declaration = pageSource.substring(0, declarationEnd + 2).trim();
-                annotatedXML = `${declaration}\n${annotatedXML}`;
-            }
-        }
-
-        return {
-            dom: annotatedXML
-        };
-
-    } catch (error: any) {
-            throw new Error(`Unable to annotate DOM: ${error.message}`, { cause: error });
-        }
-}
-

package/src/utils/InstancesDetails/getInstancesInfo.ts

@@ -1,12 +0,0 @@
-
-export function getAiInstanceInfo(
-    responseObject: any
-): Record<string, string> {
-    return {
-        serviceProvider: responseObject.serviceProvider,
-        apiKey: responseObject.instanceDetails.apiKey,
-        apiUrl: responseObject.instanceDetails.apiUrl,
-        visionApiKey: responseObject.instanceDetails.visionApiKey ?? "c2stcHJvai1zODVFenVfWkdnVUxoT1dNVVhRTmxuUW9ELUpnS3dEMGpvSmJZcDE0YWd4ZEZ3MWM5Mlh5NnlLUFJpYk1XckUtTTRTV1dzcHc0MFQzQmxia0ZKekVkWXRMTm1rWWlJQVRYTUwyTWhhTU5NR3FUWjhZekJYZHdkTHc0MHRVT084d0t6N19wRENYSERSX0NsSVRtTVpjR3VsY3ZlNEE=",
-        model: responseObject.model,
-    };
-}

package/src/utils/alertPopup/isAlertPresent.ts

@@ -1,20 +0,0 @@
-
-import { IAlertChecker } from "./isAlertPresentInterface";
-
-export const isAlertPresent: IAlertChecker = async (
-    driver,
-    timeout: number = 0
-): Promise<boolean> => {
-    try {
-        if (!driver) return false;
-
-        await driver.waitUntil(
-            async () => await driver.isAlertOpen(),
-            { timeout }
-        );
-
-        return true;
-    } catch {
-        return false;
-    }
-};

package/src/utils/alertPopup/isAlertPresentInterface.ts

@@ -1,6 +0,0 @@
-export interface IAlertChecker {
-    (
-        driver: WebdriverIO.Browser,
-        timeout?: number
-    ): Promise<boolean>;
-}

package/src/utils/helpers/enterActionHelper.ts

@@ -1,180 +0,0 @@
-import { JSDOM } from "jsdom";
-import { DOMParser } from "@xmldom/xmldom";
-import { getFFIndexAndXPath } from "./xpathcreation.js";
-import { logger } from "../logger/logData.js";
-import xpath from "xpath";
-
-interface EnterActionResult {
-    ffNumber: number;
-    xpathPath: string;
-}
-interface EnterActionResultMob {
-    xpathPath: string;
-}
-
-
-export const enterActionHelper = (
-    pageDOM: string,
-    ffNumber: string
-): EnterActionResult => {
-
-    //  Extract numeric part
-    const match = ffNumber.match(/\d+$/);
-    let numericFF = match ? parseInt(match[0], 10) : 0;
-
-    const parser = new JSDOM(pageDOM);
-    const doc = parser.window.document;
-
-    const isEditable = (el: Element | null): boolean => {
-        if (!el) return false;
-
-        const tag = el.tagName?.toLowerCase();
-
-        return (
-            ["input", "textarea", "select"].includes(tag) ||
-            el.getAttribute("contenteditable") === "true"
-        );
-    };
-
-    const getXPath = (el: Element | null): string => {
-        return el?.getAttribute("ff-xpath") || "";
-    };
-
-    const element = doc.querySelector(
-        `[ff-inspect="Fire-Flink-${numericFF}"]`
-    );
-
-    if (!element) {
-        return { ffNumber: numericFF, xpathPath: "" };
-    }
-
-    let xpathPath = "";
-
-    //  Current element editable
-    if (isEditable(element)) {
-        xpathPath = getXPath(element);
-
-    } else {
-
-        // Search editable child
-        let editableChild: Element | null = null;
-
-        for (const child of Array.from(element.querySelectorAll("*"))) {
-            if (isEditable(child)) {
-                editableChild = child;
-                break;
-            }
-        }
-
-        if (editableChild) {
-            xpathPath = getXPath(editableChild);
-
-        } else {
-
-            // Try next 10 FF elements
-            for (let offset = 1; offset <= 10; offset++) {
-                const nextNum = numericFF + offset;
-
-                const nextTarget = doc.querySelector(
-                    `[ff-inspect="Fire-Flink-${nextNum}"]`
-                );
-
-                if (isEditable(nextTarget)) {
-                    numericFF = nextNum;
-                    xpathPath = getXPath(nextTarget);
-                    break;
-                }
-            }
-
-            // Final fallback
-            if (!xpathPath) {
-                xpathPath = getXPath(element);
-            }
-        }
-    }
-
-    // console.log("xpathPath", xpathPath);
-
-    return {
-        ffNumber: numericFF,
-        xpathPath
-    };
-};
-
-
-
-export function enterActionHelperMob(
-  annotatedDom: string,
-  num: string,
-): EnterActionResultMob {
-
-    const parser = new DOMParser();
-    const match = num.match(/\d+$/);
-    const numericFF = match ? parseInt(match[0], 10) : 0;
-    const xmlDoc = parser.parseFromString(annotatedDom, "text/xml");
-
-    
-    const xpathQuery = `//*[@FF-inspecter='${num}']`;
-  
-    const nodes = xpath.select(xpathQuery, xmlDoc) as Node[];
-  
-    const element = nodes.length ? (nodes[0] as Element) : null;
-
-    let xpathPath = "";
-
-    if (element) {
-
-      const elementClass = (element.getAttribute("class") || "").toLowerCase();
-
-        if (
-          elementClass.includes("edittext") ||
-          elementClass.includes("autocompletetextview")
-        ) {
-
-          xpathPath = getFFIndexAndXPath(annotatedDom, num);
-
-        } else {
-
-          // check immediate children
-          const children = Array.from(element.children);
-
-          let editableChild: Element | null = null;
-
-          for (const child of children) {
-
-            const childClass = (child.getAttribute("class") || "").toLowerCase();
-
-            if (
-              childClass.includes("edittext") ||
-              childClass.includes("autocompletetextview")
-            ) {
-              editableChild = child;
-              break;
-            }
-          }
-
-          if (editableChild) {
-
-            const childNum =
-              editableChild.getAttribute("FF-inspecter")?.split("-").pop();
-
-            if (childNum) {
-              xpathPath = getFFIndexAndXPath(annotatedDom, `Fire-Flink-${childNum}`);
-            }
-
-          } else {
-
-            xpathPath = getFFIndexAndXPath(annotatedDom, num);
-          }
-        }
-
-
-    } else {
-      logger.info(`No element found for ffNumber: ${numericFF} in MOB_Enter action`);
-
-    }
-
-     return {
-        xpathPath
-    };
-}

package/src/utils/helpers/imageUtils.ts

@@ -1,10 +0,0 @@
-/**
- * Ensures that a base64 string or Buffer has the correct data URI prefix for PNG images.
- * @param image The base64 string or Buffer.
- * @returns The base64 string with the `data:image/png;base64,` prefix.
- */
-export function formatImageBase64(image: string | Buffer): string {
-    if (!image) return "";
-    const base64 = Buffer.isBuffer(image) ? image.toString("base64") : image;
-    return base64.startsWith("data:") ? base64 : `data:image/png;base64,${base64}`;
-}

package/src/utils/helpers/sameActionsHelper.ts

@@ -1,52 +0,0 @@
-export const sameActionHelper: Record<string, string> = {
-    MOB_Tap: "Click",
-    MOB_Enter: "SendKeys",
-    MOB_VerifyElementIsDisplayed: "VerifyElementIsDisplayed",
-    MOB_VerifyElementIsEnabled: "VerifyElementIsEnabled",
-    MOB_VerifyXLocationOfAndroidElement: "VerifyXLocationOfElement",
-    MOB_VerifyElementIsSelected: "VerifyElementIsSelected",
-    MOB_VerifyYLocationOfAndroidElement: "VerifyYLocationOfElement",
-    MOB_VerifyWidthOfElement: "VerifyWidthOfElement",
-    MOB_WaitAndClick: "WaitAndClick",
-    MOB_GetScreenshot: "GetScreenshot",
-    MOB_VerifyText: "VerifyText",
-    MOB_VerifyElementNotContainsText: "VerifyElementNotContainsText",
-    MOB_VerifyIfXAndYCoordinateOfElement: "VerifyIfXAndYCoordinateOfElement",
-    MOB_VerifyPartialAttributeValue: "VerifyPartialAttributeValue",
-    MOB_VerifyElementIsClickable: "VerifyElementIsClickable",
-    MOB_VerifyElementIsDisabled: "VerifyElementIsDisabled",
-    MOB_GetImplicitTimeOut: "GetImplicitTimeOut",
-    MOB_GetDriverInstance: "GetDriverInstance",
-    MOB_GetCurrentWindowHandle: "GetCurrentWindowHandle",
-    MOB_GetTagName: "GetTagName",
-    MOB_GetScreenshotAs: "GetScreenshotAs",
-    MOB_GetX: "GetXLocationOfWebElement",
-    MOB_GetLocation: "GetLocation",
-    MOB_GetY: "GetYLocationOfWebElement",
-    MOB_GetRect: "GetRect",
-    MOB_GetText: "GetText",
-    MOB_GetSize: "GetSize",
-    MOB_GetAttribute: "GetAttribute",
-    MOB_Clear: "Clear",
-    MOB_DoubleTap: "DoubleClick",
-    MOB_TapNTimes: "ClickNTimes",
-    MOB_VerifyPartialText: "VerifyPartialText",
-    MOB_VerifyAttributeValue: "VerifyAttributeValue",
-    MOB_ClearThenEnterInput: "ClearThenEnterInput",
-    MOB_EnterDataAndPressKey: "EnterDataAndPressKey",
-    MOB_WaitAndSendKeys: "WaitAndSendKeys",
-    MOB_VerifyHeightOfElement: "VerifyHeightOfWebElement",
-    MOB_WaitTillPresenceOfElement: "WaitTillPresenceOfElement",
-    MOB_WaitTillPresenceOfAllElements: "WaitTillPresenceOfAllElements",
-    MOB_WaitTillAttributeOfElementIsString: "WaitTillAttributeOfElementIsString",
-    MOB_EnterUrl: "EnterUrl",
-    MOB_SetClipBoardText: "SetClipBoardText",
-    MOB_PressAnyKeyNTimes: "PressAnyKeyNTimes",
-    MOB_FindElements: "FindElements",
-    MOB_WaitTillElementIsClickable: "WaitTillElementIsClickable",
-    MOB_CheckIfElementIsDisplayed: "CheckIfElementIsDisplayed",
-    MOB_PressAnyKey: "PressAnyKey",
-    MOB_WaitTillElementHasText: "WaitTillElementHasText",
-    MOB_WaitTillElementContainsText: "WaitTillElementContainsText",
-    MOB_PressEnterKey: "PressEnterKey"
-};