ff-automationv2 2.2.34-beta.0 → 2.2.34-beta.1

package/dist/ai/llmprompts/llmPromptTypes/systemPromptTypes.d.ts

@@ -1,5 +1,7 @@
 export type keywordExtractor = {
     priorAndNextSteps: string[];
+    allSteps?: string[];
+    previousPlatform?: string | null;
 };
 export type FFInspectorArgs = {
     stepAction: string;

package/dist/ai/llmprompts/promptRegistry.js

@@ -13,6 +13,7 @@ const getActionExtractorPrompt_js_1 = require("./systemPrompts/getActionExtracto
 const verifyActionExtractorPromptMob_js_1 = require("./systemPrompts/verifyActionExtractorPromptMob.js");
 const getActionExtractorPromptMob_js_1 = require("./systemPrompts/getActionExtractorPromptMob.js");
 const mobileKeywordExtractor_js_1 = require("./systemPrompts/mobileKeywordExtractor.js");
+const multichannelKeywordExtractor_js_1 = require("./systemPrompts/multichannelKeywordExtractor.js");
 const combinedActionExtractorPromptMob_js_1 = require("./systemPrompts/combinedActionExtractorPromptMob.js");
 const waitActionExtractorPromptMob_js_1 = require("./systemPrompts/waitActionExtractorPromptMob.js");
 const waitActionExtractorPrompt_js_1 = require("./systemPrompts/waitActionExtractorPrompt.js");
@@ -25,6 +26,7 @@ exports.prompts = {
     web: {
         userStoryToList: userStoryToListPrompt_js_1.buildStepExtractionPrompt,
         keywordExtractorPrompt: actionExtractorPrompt_js_1.keywordExtractor,
+        multichannelKeywordExtractorPrompt: multichannelKeywordExtractor_js_1.keywordExtractorMultichannel,
         errorDescriptionPrompt: errorDescriptionPrompt_js_1.buildErrorDescriptionPrompt,
         ffInspectorNumExtractor: fireflinkElementIndexExtactors_js_1.ffInspectorNumExtractor,
         verifyActionExtractorPrompt: verifyActionExtractorPrompt_js_1.verifyActionExtractorPrompt,
@@ -40,6 +42,7 @@ exports.prompts = {
     android: {
         userStoryToList: userStoryToListPrompt_js_1.androidbuildStepExtractionPrompt,
         keywordExtractorPrompt: mobileKeywordExtractor_js_1.keywordExtractorMobile,
+        multichannelKeywordExtractorPrompt: multichannelKeywordExtractor_js_1.keywordExtractorMultichannel,
         errorDescriptionPrompt: errorDescriptionPrompt_js_1.buildErrorDescriptionPrompt,
         ffInspectorNumExtractor: fireflinkElementIndexExtractor_Mob_js_1.ffInspectorNumExtractorMob,
         verifyActionExtractorPrompt: verifyActionExtractorPromptMob_js_1.verifyActionExtractorPromptMob,
@@ -55,6 +58,7 @@ exports.prompts = {
     ios: {
         userStoryToList: userStoryToListPrompt_js_1.androidbuildStepExtractionPrompt,
         keywordExtractorPrompt: mobileKeywordExtractor_js_1.keywordExtractorMobile,
+        multichannelKeywordExtractorPrompt: multichannelKeywordExtractor_js_1.keywordExtractorMultichannel,
         errorDescriptionPrompt: errorDescriptionPrompt_js_1.buildErrorDescriptionPrompt,
         ffInspectorNumExtractor: fireflinkElementIndexExtractor_Mob_js_1.ffInspectorNumExtractorMob,
         verifyActionExtractorPrompt: verifyActionExtractorPromptMob_js_1.verifyActionExtractorPromptMob,

package/dist/ai/llmprompts/systemPrompts/multichannelKeywordExtractor.d.ts

@@ -0,0 +1,6 @@
+import { keywordExtractor } from "../llmPromptTypes/systemPromptTypes";
+export type multichannelKeywordExtractor = keywordExtractor & {
+    allSteps: string[];
+    previousPlatform?: string | null;
+};
+export declare function keywordExtractorMultichannel({ priorAndNextSteps, allSteps, previousPlatform, }: multichannelKeywordExtractor): Promise<string>;

package/dist/ai/llmprompts/systemPrompts/multichannelKeywordExtractor.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keywordExtractorMultichannel = keywordExtractorMultichannel;
+const actionExtractorPrompt_js_1 = require("./actionExtractorPrompt.js");
+const mobileKeywordExtractor_js_1 = require("./mobileKeywordExtractor.js");
+async function keywordExtractorMultichannel({ priorAndNextSteps, allSteps, previousPlatform, }) {
+    const webPrompt = await (0, actionExtractorPrompt_js_1.keywordExtractor)({ priorAndNextSteps });
+    const mobilePrompt = await (0, mobileKeywordExtractor_js_1.keywordExtractorMobile)({ priorAndNextSteps });
+    const allowedActions = [
+        "enter",
+        "refresh",
+        "wait",
+        "verify",
+        "scroll",
+        "navigate",
+        "navigateBack",
+        "click",
+        "maximize",
+        "minimize",
+        "get",
+        "upload",
+        "close",
+        "open",
+        "openApp",
+        "drag_and_drop",
+        "closeApp",
+        "switch",
+        "cleartext",
+        "tap",
+        "combined",
+        "mouseAction",
+        "switchToAndroid",
+        "switchToWeb",
+        "getOtp",
+        "enterOtp",
+        "arithmetic",
+    ];
+    return `
+You are extracting keywords for a MULTICHANNEL test. Platform is not provided by the user.
+You MUST decide the platform for the CURRENT step and return it so downstream execution stays unchanged.
+
+previousPlatform: ${previousPlatform ?? "none"}
+allSteps (full script, use as context only): ${JSON.stringify(allSteps)}
+nearbySteps: ${JSON.stringify(priorAndNextSteps)}
+
+PLATFORM DECISION RULES (mandatory):
+- platform MUST be exactly one of: "web" | "android" | "ios"
+- Decide using the CURRENT step first, then allSteps for context, then previousPlatform.
+- If the current step is in the middle of a flow and does not clearly name a platform, browser, URL, app, package, bundle, or device, you MUST reuse previousPlatform.
+- If previousPlatform is "none" (first step), infer from the current step and allSteps:
+  - web: browser, URL, http/https, navigate, click, open browser, web page, tab, window
+  - android: Android app, APK, appPackage, appActivity, UiAutomator, Android device
+  - ios: iOS app, iPhone, IPA, bundle id, XCUITest, Safari on iOS
+- Do not switch platform on generic UI verbs (tap/click/enter/verify/scroll) unless the step or surrounding allSteps clearly change channel.
+- After you choose platform, follow THAT platform's keyword/action rules below. Do not mix web actions onto mobile or mobile actions onto web.
+  - web actions include: click, open, close, navigate, navigateBack, maximize, minimize, refresh, mouseAction, drag_and_drop, switch, cleartext, upload
+  - android/ios actions include: tap, openApp, closeApp, combined, enterOtp
+  - shared: enter, wait, verify, scroll, get, getOtp, arithmetic, switchToAndroid, switchToWeb
+- action must be one of: ${JSON.stringify(allowedActions)}
+
+===== WEB KEYWORD RULES (use when platform is web) =====
+${webPrompt}
+
+===== ANDROID / iOS KEYWORD RULES (use when platform is android or ios) =====
+${mobilePrompt}
+
+Respond ONLY with valid JSON in this EXACT format (this overrides the JSON formats in the sections above):
+{
+  "steps": [
+    {
+      "platform": "web" | "android" | "ios",
+      "keywords": ["key1", "key2"],
+      "elementName": "element name",
+      "action": ${allowedActions.join("|")},
+      "isStepValueDependable": boolean,
+      "liveLog": "Short human-readable description of what the AI is about to do.",
+      "fileType": "pdf" | other lowercase file extension | null,
+      "step": "Single atomic instruction for this step."
+    }
+  ]
+}
+
+Every object in "steps" MUST include platform. If you split one user step into multiple objects, keep the same platform unless the wording clearly switches channel.
+No other text.
+`;
+}

package/dist/ai/llmprompts/userPrompts/userPrompt.js

@@ -6,6 +6,7 @@ const imageUtils_js_1 = require("../../../utils/helpers/imageUtils.js");
 exports.userInputFormatters = {
     [promptType_js_1.PromptType.USER_STORY_TO_LIST]: (userInput) => `Convert the following user story into steps:\n\n${JSON.stringify(userInput.userStory, null, 2)}`,
     [promptType_js_1.PromptType.KEYWORD_EXTRACTOR]: (userInput) => `Extract keywords from the following input:\n\n${JSON.stringify(userInput.currentStep, null, 2)}`,
+    [promptType_js_1.PromptType.MULTICHANNEL_KEYWORD_EXTRACTOR]: (userInput) => `Extract keywords and decide platform for the following current step:\n\n${JSON.stringify(userInput.currentStep, null, 2)}`,
     [promptType_js_1.PromptType.ERROR_DESCRIPTION]: (error) => `Analyze the following error context:\n\n${JSON.stringify(error.error, null, 2)}`,
     [promptType_js_1.PromptType.FF_INSPECTOR]: (userInput) => `Inspect the DOM for the following action context:\n\n${JSON.stringify(userInput.currentStep, null, 2)}`,
     [promptType_js_1.PromptType.VERIFY_PROMPT]: (userInput) => `Inspect the DOM for the following verify context:\n\n${JSON.stringify(userInput.currentStep, null, 2)}`,

package/dist/automation/actions/interaction/shadowDom/shadowDomUpload.js

@@ -1,26 +1,104 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.uploadFileShadowElement = uploadFileShadowElement;
-const jsForShadowRoot_js_1 = require("../../../../utils/javascript/jsForShadowRoot.js");
 const appendScriptData_js_1 = require("../../../../fireflinkData/fireflinkScript/appendScriptData.js");
+const generateJsPath_js_1 = require("../../../../utils/JsPathGenerator/generateJsPath.js");
+const logData_js_1 = require("../../../../utils/logger/logData.js");
 async function uploadFileShadowElement(args) {
     try {
-        const executableJS = jsForShadowRoot_js_1.SHADOW_DOM_UPLOAD_JS.replace("arguments[0]", `"${args.selector}"`);
-        const exists = await args.driver.execute(jsForShadowRoot_js_1.SHADOW_DOM_UPLOAD_JS, args.selector);
-        if (!exists) {
-            throw new Error("uploda for shadow dom  is failed");
+        const parts = args.selector.split("/shadow/");
+        let fileInput = null;
+        // Build shadow host chain ONCE — shared across all tiers (avoids duplicate traversal)
+        const shadowHosts = [];
+        try {
+            let el = await args.driver.$(parts[0]);
+            shadowHosts.push(el);
+            for (let i = 1; i < parts.length - 1; i++) {
+                el = await el.shadow$((0, generateJsPath_js_1.convertToCssSelector)(parts[i]));
+                shadowHosts.push(el);
+            }
+        }
+        catch {
+            // partial shadowHosts[] is still usable for whatever was resolved
+        }
+        const lastKnownHost = shadowHosts.length > 0 ? shadowHosts[shadowHosts.length - 1] : null;
+        // Tier 1 — shadow$() on deepest known host (1 level below last host)
+        if (lastKnownHost && await lastKnownHost.isExisting()) {
+            try {
+                const candidate = await lastKnownHost.shadow$('input[type="file"]');
+                if (candidate && await candidate.isExisting()) {
+                    fileInput = candidate;
+                }
+            }
+            catch {
+                // fall through to Tier 2
+            }
+        }
+        // Tier 2 — Option A: element-scoped >>> deep-pierce from last known host
+        if (!fileInput && lastKnownHost && await lastKnownHost.isExisting()) {
+            try {
+                const candidate = await lastKnownHost.$('>>>input[type="file"]');
+                if (candidate && await candidate.isExisting()) {
+                    fileInput = candidate;
+                }
+            }
+            catch {
+                // fall through to Tier 3
+            }
+        }
+        // Tier 3 — backtrack deepest → outermost across all recorded shadow hosts
+        if (!fileInput) {
+            for (let i = shadowHosts.length - 1; i >= 0; i--) {
+                try {
+                    const candidate = await shadowHosts[i].shadow$('input[type="file"]');
+                    if (candidate && await candidate.isExisting()) {
+                        fileInput = candidate;
+                        break;
+                    }
+                }
+                catch {
+                    // continue up the chain
+                }
+            }
+        }
+        if (!fileInput) {
+            throw new Error(`Shadow DOM file input not found. Selector: "${args.selector}"`);
         }
         const remoteFilePath = await args.driver.uploadFile(args.value);
-        const fileInput = await args.driver.$(exists);
-        await fileInput.setValue(remoteFilePath);
+        try {
+            await fileInput.setValue(remoteFilePath);
+        }
+        catch (err) {
+            logData_js_1.logger.info(`setValue failed on shadow file input, trying addValue: ${err.message}`);
+            await fileInput.addValue(remoteFilePath);
+        }
+        //Dispatch change and input events so custom UI components update their state
+        await args.driver.execute((el) => {
+            if (el) {
+                el.dispatchEvent(new Event("input", { bubbles: true, composed: true }));
+                el.dispatchEvent(new Event("change", { bubbles: true, composed: true }));
+            }
+        }, fileInput);
+        logData_js_1.logger.info(`Successfully uploaded file into shadow DOM element`);
+        // Generate JSPath
+        const jsPath = (0, generateJsPath_js_1.generateJsPath)(args.selector, 'input[type="file"]');
+        console.warn("RAW JSPath:\n" + jsPath);
+        const ffElementIndex = `Fire-Flink-${args.fireflinkIndex}`;
         (0, appendScriptData_js_1.appendScriptData)({
             scriptDataAppender: args.scriptDataAppender,
-            nlpName: "ExecuteJavaScript",
-            stepInputs: [executableJS]
+            nlpName: "SendKeys",
+            stepInputs: [args.value],
+            pageDOM: args.pageDOM,
+            elementGetter: args.elementGetter,
+            ffNumber: ffElementIndex,
+            elementName: args.elementName,
+            elementType: "button",
+            selector: jsPath,
+            platform: args.platform
         });
     }
     catch (error) {
-        args.scriptDataAppender.setErrorNLP("ExecuteJavaScript");
+        args.scriptDataAppender.setErrorNLP("SendKeys");
         throw new Error("Shadow Upload action failed", {
             cause: error
         });

package/dist/automation/actions/interface/FireFlinkResponseSchema.d.ts

@@ -19,6 +19,36 @@ export declare const KeywordSchema: z.ZodObject<{
         step: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export declare const MultichannelStepItemSchema: z.ZodObject<{
+    keywords: z.ZodArray<z.ZodString>;
+    elementName: z.ZodString;
+    action: z.ZodString;
+    isStepValueDependable: z.ZodBoolean;
+    liveLog: z.ZodString;
+    fileType: z.ZodNullable<z.ZodString>;
+    step: z.ZodString;
+    platform: z.ZodEnum<{
+        web: "web";
+        android: "android";
+        ios: "ios";
+    }>;
+}, z.core.$strip>;
+export declare const MultichannelKeywordSchema: z.ZodObject<{
+    steps: z.ZodArray<z.ZodObject<{
+        keywords: z.ZodArray<z.ZodString>;
+        elementName: z.ZodString;
+        action: z.ZodString;
+        isStepValueDependable: z.ZodBoolean;
+        liveLog: z.ZodString;
+        fileType: z.ZodNullable<z.ZodString>;
+        step: z.ZodString;
+        platform: z.ZodEnum<{
+            web: "web";
+            android: "android";
+            ios: "ios";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const AlertShema: z.ZodObject<{
     action: z.ZodString;
     inputText: z.ZodString;

package/dist/automation/actions/interface/FireFlinkResponseSchema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArithmeticSchema = exports.InputContextSchema = exports.OtpExtractorSchema = exports.ErrorDescriptionSchema = exports.UserStorySchema = exports.VisionSchema = exports.DefaultInteractionSchema = exports.MouseActionSchema = exports.UploadActionSchema = exports.GetOtpActionSchema = exports.ClearTextActionSchema = exports.EnterActionSchema = exports.TapActionSchema = exports.ClickActionSchema = exports.SwitchActionSchema = exports.MobileScrollSchema = exports.WebScrollSchema = exports.DragDropActionSchema = exports.MobileCombinedSchema = exports.CombinedActionSchema = exports.WaitActionSchema = exports.MobileGetSchema = exports.MobileFileVerifySchema = exports.MobileVerifySchema = exports.WebGetSchema = exports.WebFileVerifySchema = exports.WebVerifySchema = exports.AlertShema = exports.KeywordSchema = exports.StepItemSchema = void 0;
+exports.ArithmeticSchema = exports.InputContextSchema = exports.OtpExtractorSchema = exports.ErrorDescriptionSchema = exports.UserStorySchema = exports.VisionSchema = exports.DefaultInteractionSchema = exports.MouseActionSchema = exports.UploadActionSchema = exports.GetOtpActionSchema = exports.ClearTextActionSchema = exports.EnterActionSchema = exports.TapActionSchema = exports.ClickActionSchema = exports.SwitchActionSchema = exports.MobileScrollSchema = exports.WebScrollSchema = exports.DragDropActionSchema = exports.MobileCombinedSchema = exports.CombinedActionSchema = exports.WaitActionSchema = exports.MobileGetSchema = exports.MobileFileVerifySchema = exports.MobileVerifySchema = exports.WebGetSchema = exports.WebFileVerifySchema = exports.WebVerifySchema = exports.AlertShema = exports.MultichannelKeywordSchema = exports.MultichannelStepItemSchema = exports.KeywordSchema = exports.StepItemSchema = void 0;
 exports.getSchemaForPrompt = getSchemaForPrompt;
 const zod_1 = require("zod");
 const promptType_js_1 = require("../../../core/types/promptType.js");
@@ -16,6 +16,12 @@ exports.StepItemSchema = zod_1.z.object({
 exports.KeywordSchema = zod_1.z.object({
     steps: zod_1.z.array(exports.StepItemSchema)
 });
+exports.MultichannelStepItemSchema = exports.StepItemSchema.extend({
+    platform: zod_1.z.enum(["web", "android", "ios"]),
+});
+exports.MultichannelKeywordSchema = zod_1.z.object({
+    steps: zod_1.z.array(exports.MultichannelStepItemSchema)
+});
 exports.AlertShema = zod_1.z.object({
     action: zod_1.z.string(),
     inputText: zod_1.z.string()
@@ -202,6 +208,7 @@ exports.ArithmeticSchema = zod_1.z.object({
 });
 const schemaMap = {
     [promptType_js_1.PromptType.KEYWORD_EXTRACTOR]: exports.KeywordSchema,
+    [promptType_js_1.PromptType.MULTICHANNEL_KEYWORD_EXTRACTOR]: exports.MultichannelKeywordSchema,
     [promptType_js_1.PromptType.VISION_PROMPT]: exports.VisionSchema,
     [promptType_js_1.PromptType.USER_STORY_TO_LIST]: exports.UserStorySchema,
     [promptType_js_1.PromptType.ERROR_DESCRIPTION]: exports.ErrorDescriptionSchema,

package/dist/core/interfaces/executionDetails.d.ts

@@ -23,7 +23,7 @@ export interface AutomationRequest {
     userName: string;
     serverHost: string;
     browserName: BrowserName;
-    platform: platform;
+    platform?: platform;
     token: string;
     appiumPort: number;
     realDeviceId: string;
@@ -38,4 +38,5 @@ export interface AutomationRequest {
     adbPath?: string;
     topic: string;
     aiExecutionAction: string;
+    hasMoreSteps: boolean;
 }

package/dist/core/interfaces/fireflinkScriptPayloadInterface.d.ts

@@ -9,8 +9,7 @@ export interface IStep {
 }
 export interface IPayload {
     scriptName: string;
-    scriptType: string;
-    type?: string;
+    type: string;
     projectId?: string;
     testCaseId?: string;
     pageDetails?: any;
@@ -20,7 +19,6 @@ export interface IPayload {
     projectType?: string;
     tokensConsumed?: number;
     error?: IErrorInfo;
-    platform?: string;
     serviceProvider?: string;
     model?: string;
 }

package/dist/core/interfaces/promptInterface.d.ts

@@ -4,6 +4,11 @@ export interface PromptArgsMap {
     [PromptType.KEYWORD_EXTRACTOR]: {
         priorAndNextSteps: string[];
     };
+    [PromptType.MULTICHANNEL_KEYWORD_EXTRACTOR]: {
+        priorAndNextSteps: string[];
+        allSteps: string[];
+        previousPlatform?: string | null;
+    };
     [PromptType.ERROR_DESCRIPTION]: Record<string, any>;
     [PromptType.FF_INSPECTOR]: {
         stepAction: string;

package/dist/core/main/actionHandlerFactory.js

@@ -265,7 +265,7 @@ function createActionHandlers(context) {
         },
         openApp: async (result) => {
             try {
-                const isIOS = context.request.platform?.toLowerCase() === "ios";
+                const isIOS = context.activePlatform === "ios";
                 const appPackage = result.keywords
                     .find((item) => item.startsWith("appPackage:"))
                     ?.substring("appPackage:".length);
@@ -340,7 +340,7 @@ function createActionHandlers(context) {
         closeApp: async () => {
             try {
                 await context.mobileSession.close();
-                const nlpName = context.request.platform.toLowerCase() === "ios" ? "IOS_CloseApp" : "MOB_CloseApp";
+                const nlpName = context.activePlatform === "ios" ? "IOS_CloseApp" : "MOB_CloseApp";
                 context.scriptAppender.add(async () => ({
                     nlpName: nlpName,
                     elementsData: [],
@@ -357,7 +357,7 @@ function createActionHandlers(context) {
                 if (!context.browserOpened) {
                     logData_js_1.logger.info("Browser not initialized, auto-opening before navigate...");
                     await context.session.open();
-                    context.executor = new executor_js_1.ActionExecutor(await context.session.getCurrentDriver(), context.scriptAppender, context.locator, context.request.platform, context.adbPath);
+                    context.executor = new executor_js_1.ActionExecutor(await context.session.getCurrentDriver(), context.scriptAppender, context.locator, context.activePlatform, context.adbPath);
                     context.browserOpened = true;
                     context.scriptAppender.add(async () => ({
                         nlpName: "Open Browser",

package/dist/core/main/executionContext.d.ts

@@ -18,6 +18,8 @@ export declare class ExecutionContext {
     activePlatform: platform;
     browserOpened: boolean;
     stepsInputData: any[];
+    allManualSteps: string[];
     constructor(request: AutomationRequest, workerPool: LocatorWorkerPool);
     initializeMobileDriver(caps: any): Promise<void>;
+    syncExecutorToActivePlatform(): Promise<void>;
 }

package/dist/core/main/executionContext.js

@@ -15,15 +15,16 @@ class ExecutionContext {
         this.executor = null;
         this.browserOpened = false;
         this.stepsInputData = [];
+        this.allManualSteps = [];
         this.session = new initiateBrowserSession_js_1.BrowserSession(browserType_js_1.browserName[request.browserName], request.isCloud, request.capabilities, defaultValues_js_1.DEFAULT_PAGE_LOAD, request.cloudConfig);
         this.locator = new getListOfLocators_js_1.ElementGetter(workerPool);
         this.scriptAppender = new scriptGenrationData_js_1.ScriptDataAppender();
         this.mobileSession = new initiateMobileSession_js_1.MobileSession(request.appiumPort, request.isCloud, request.capabilities, request.cloudConfig, request.adbPath);
         this.adbPath = request.adbPath || "";
-        this.activePlatform = request.platform.toLowerCase();
+        this.activePlatform = (request.platform?.toLowerCase() || "web");
     }
     async initializeMobileDriver(caps) {
-        const isIOS = this.request.platform.toLowerCase() === "ios";
+        const isIOS = this.activePlatform === "ios";
         const appiumCaps = {};
         const allowedCapabilities = [
             "app",
@@ -107,7 +108,21 @@ class ExecutionContext {
                 ...appiumCaps
             };
         await this.mobileSession.createDriver(capabilities);
-        this.executor = new executor_js_1.ActionExecutor(await this.mobileSession.getCurrentDriver(), this.scriptAppender, this.locator, this.request.platform, this.adbPath, this.stepsInputData);
+        this.executor = new executor_js_1.ActionExecutor(await this.mobileSession.getCurrentDriver(), this.scriptAppender, this.locator, this.activePlatform, this.adbPath, this.stepsInputData);
+    }
+    async syncExecutorToActivePlatform() {
+        try {
+            if (this.activePlatform === "web") {
+                const webDriver = await this.session.getCurrentDriver();
+                this.executor = new executor_js_1.ActionExecutor(webDriver, this.scriptAppender, this.locator, "web", this.adbPath, this.stepsInputData);
+                return;
+            }
+            const mobileDriver = await this.mobileSession.getCurrentDriver();
+            this.executor = new executor_js_1.ActionExecutor(mobileDriver, this.scriptAppender, this.locator, this.activePlatform, this.adbPath, this.stepsInputData);
+        }
+        catch {
+            // Driver for the detected platform may not exist yet (open/openApp comes later).
+        }
     }
 }
 exports.ExecutionContext = ExecutionContext;

package/dist/core/main/runAutomationScript.d.ts

@@ -1,6 +1,7 @@
 import "../../utils/sslConfig/apiCallPatch.js";
 import { IAutomationRunner } from "../interfaces/automationRunnerInterface.js";
 import { AutomationRequest } from "../../core/interfaces/executionDetails.js";
+import { platform } from "../types/scriptTypesType.js";
 export declare class AutomationRunner implements IAutomationRunner {
     static sessionTerminationDetails: Record<string, boolean>;
     static sessionNames: Record<string, string>;
@@ -9,6 +10,7 @@ export declare class AutomationRunner implements IAutomationRunner {
     static updateSessionTerminationInfo(testCaseId: string): void;
     static sessionName(testCaseId: string, sessionName: string): void;
     static getSessionName(testCaseId: string): string;
+    static resolveDetectedPlatform(detectedPlatform?: string, previousPlatform?: platform): platform;
     static normalizeScriptType(scriptType?: string): string;
     private cleanup;
     private saveSessionStepData;

package/dist/core/main/runAutomationScript.js

@@ -24,7 +24,6 @@ const isAlertPresent_js_1 = require("../../utils/alertPopup/isAlertPresent.js");
 const logData_js_1 = require("../../utils/logger/logData.js");
 const sameActionsHelper_js_1 = require("../../utils/helpers/sameActionsHelper.js");
 const messageType_js_1 = require("../types/messageType.js");
-const platformSyntax_js_1 = require("../../utils/helpers/platformSyntax.js");
 const driverState_js_1 = require("../../automation/driverState.js");
 const SessionManager_js_1 = require("./SessionManager.js");
 const runnerKafkaReporter_js_1 = require("../helpers/runnerKafkaReporter.js");
@@ -49,6 +48,18 @@ class AutomationRunner {
     static getSessionName(testCaseId) {
         return AutomationRunner.sessionNames[testCaseId];
     }
+    static resolveDetectedPlatform(detectedPlatform, previousPlatform) {
+        const value = (detectedPlatform ?? "").trim().toLowerCase();
+        if (value === "ios")
+            return "ios";
+        if (value === "android")
+            return "android";
+        if (value === "web")
+            return "web";
+        if (previousPlatform)
+            return previousPlatform;
+        return "web";
+    }
     static normalizeScriptType(scriptType) {
         const rawValue = (scriptType ?? "Web").trim();
         if (!rawValue) {
@@ -150,15 +161,16 @@ class AutomationRunner {
         const usedElementNames = [];
         const usedVariableNames = [];
         (0, logData_js_1.initLogger)(request.sessionPath);
-        request.type = request.platform;
-        request.platform = AutomationRunner.normalizeScriptType(request.platform);
-        const isWebMobile = (request.type?.toLowerCase().includes("web") &&
-            request.type?.toLowerCase().includes("android")) ||
+        const isMultichannel = request.type?.toLowerCase().includes("Multi-Channel");
+        if (!isMultichannel) {
+            request.platform = AutomationRunner.normalizeScriptType(request.platform);
+        }
+        const isWebMobile = isMultichannel ||
+            (request.type?.toLowerCase().includes("web") &&
+                request.type?.toLowerCase().includes("android")) ||
             (request.type?.toLowerCase() === "android");
         logData_js_1.logger.info("User Given Step", request.userStory);
-        const data = request.scriptName ? JSON.parse(request.scriptName) : {};
-        const hasMoreSteps = data?.hasMoreSteps ?? false;
-        request.scriptName = data?.automationScriptName ?? "automationScriptName";
+        const hasMoreSteps = request.hasMoreSteps;
         if (!request.isTerminate)
             AutomationRunner.sessionName(request.testCaseId, request.scriptName);
         if (request.isTerminate) {
@@ -170,6 +182,7 @@ class AutomationRunner {
         const instanceDetails = await fireflinkServiceInstance.runGetInstancesDetails(request.projectId, request.token, request.serverHost, request.licenseId);
         const aiInfo = (0, getInstancesInfo_js_1.getAiInstanceInfo)(instanceDetails.responseObject);
         let context = SessionManager_js_1.SessionManager.get(request);
+        const hadExistingSession = Boolean(context);
         if (!context) {
             context = SessionManager_js_1.SessionManager.create(request);
         }
@@ -183,11 +196,13 @@ class AutomationRunner {
         const stepProcessor = new stepProcessor_js_1.StepProcessor(llm);
         let currentPlatform = context.activePlatform;
         (0, platformContext_js_1.setPlatform)(currentPlatform);
+        let previousDetectedPlatform = isMultichannel && hadExistingSession ? context.activePlatform : undefined;
         const actionHandlers = (0, actionHandlerFactory_js_1.createActionHandlers)(context);
         const domProcessor = new getRelaventElements_js_1.DomProcessingEngine();
         let stepCount = 1;
         const stepsInputData = context.stepsInputData || (context.stepsInputData = []);
         const listOfSteps = request.userStory.map((step) => String(step));
+        context.allManualSteps.push(...listOfSteps);
         let driver;
         if (listOfSteps.length === 0 && request?.aiExecutionAction !== "stopExecution") {
             logData_js_1.logger.info(listOfSteps);
@@ -227,14 +242,40 @@ class AutomationRunner {
                 const start = Math.max(0, index - 3);
                 const end = Math.min(listOfSteps.length, index + 4);
                 const priorAndNextSteps = listOfSteps.slice(start, end);
-                const result = await stepProcessor.getLLMResponse({
-                    platform: currentPlatform,
-                    type: promptType_js_1.PromptType.KEYWORD_EXTRACTOR,
-                    args: { priorAndNextSteps },
-                    input: { currentStep: step },
-                });
+                const result = isMultichannel
+                    ? await stepProcessor.getLLMResponse({
+                        platform: currentPlatform || "web",
+                        type: promptType_js_1.PromptType.MULTICHANNEL_KEYWORD_EXTRACTOR,
+                        args: {
+                            priorAndNextSteps,
+                            allSteps: context.allManualSteps,
+                            previousPlatform: previousDetectedPlatform ?? null,
+                        },
+                        input: { currentStep: step },
+                    })
+                    : await stepProcessor.getLLMResponse({
+                        platform: currentPlatform,
+                        type: promptType_js_1.PromptType.KEYWORD_EXTRACTOR,
+                        args: { priorAndNextSteps },
+                        input: { currentStep: step },
+                    });
+                if (isMultichannel) {
+                    const firstStepPlatform = AutomationRunner.resolveDetectedPlatform(result.response?.steps?.[0]?.platform ?? result.response?.platform, previousDetectedPlatform);
+                    currentPlatform = firstStepPlatform;
+                    previousDetectedPlatform = firstStepPlatform;
+                    context.activePlatform = firstStepPlatform;
+                    context.request.platform = firstStepPlatform;
+                    (0, platformContext_js_1.setPlatform)(firstStepPlatform);
+                }
                 if (currentPlatform === "android" || currentPlatform === "ios") {
-                    if (!driver) {
+                    let mobileDriver = null;
+                    try {
+                        mobileDriver = await context.mobileSession.getCurrentDriver();
+                    }
+                    catch {
+                        mobileDriver = null;
+                    }
+                    if (!mobileDriver) {
                         const initialKeywords = result.response?.keywords ||
                             (Array.isArray(result.response?.steps) ? result.response.steps[0]?.keywords : undefined);
                         await context.initializeMobileDriver(initialKeywords);
@@ -253,6 +294,15 @@ class AutomationRunner {
                     const stepObj = stepsArray[i];
                     const action = stepObj.action;
                     const keywords = stepObj.keywords;
+                    if (isMultichannel) {
+                        const stepPlatform = AutomationRunner.resolveDetectedPlatform(stepObj.platform, previousDetectedPlatform);
+                        currentPlatform = stepPlatform;
+                        previousDetectedPlatform = stepPlatform;
+                        context.activePlatform = stepPlatform;
+                        context.request.platform = stepPlatform;
+                        (0, platformContext_js_1.setPlatform)(stepPlatform);
+                        await context.syncExecutorToActivePlatform();
+                    }
                     const currentStep = action?.toLowerCase() === "getotp" ? step : stepObj.step || step;
                     let currentElementName = stepObj.elementName;
                     let currentVariableName;
@@ -686,7 +736,6 @@ class AutomationRunner {
         const payload = {
             scriptName: AutomationRunner.getSessionName(request.testCaseId) ?? "SCRIPT_NAME",
             type: request.type,
-            scriptType: request.type,
             projectId: request.projectId,
             testCaseId: request.testCaseId,
             pageDetails: request.pageDetails,
@@ -694,7 +743,6 @@ class AutomationRunner {
             licenseId: request.licenseId,
             userId: request.userId,
             projectType: request.projectType,
-            platform: (0, platformSyntax_js_1.getPlatformSyntax)(currentPlatform),
             tokensConsumed: (await stepProcessor.getResultTokenUsage()).totalTokens,
         };
         this.KafkaPayload.topic = request.topic;

package/dist/core/types/promptType.d.ts

@@ -1,6 +1,7 @@
 export declare enum PromptType {
     USER_STORY_TO_LIST = "userStoryToList",
     KEYWORD_EXTRACTOR = "keywordExtractorPrompt",
+    MULTICHANNEL_KEYWORD_EXTRACTOR = "multichannelKeywordExtractorPrompt",
     ERROR_DESCRIPTION = "errorDescriptionPrompt",
     FF_INSPECTOR = "ffInspectorNumExtractor",
     VISION_PROMPT = "visionPrompt",

package/dist/core/types/promptType.js

@@ -5,6 +5,7 @@ var PromptType;
 (function (PromptType) {
     PromptType["USER_STORY_TO_LIST"] = "userStoryToList";
     PromptType["KEYWORD_EXTRACTOR"] = "keywordExtractorPrompt";
+    PromptType["MULTICHANNEL_KEYWORD_EXTRACTOR"] = "multichannelKeywordExtractorPrompt";
     PromptType["ERROR_DESCRIPTION"] = "errorDescriptionPrompt";
     PromptType["FF_INSPECTOR"] = "ffInspectorNumExtractor";
     PromptType["VISION_PROMPT"] = "visionPrompt";

package/dist/fireflinkData/fireflinkScript/appendScriptData.js

@@ -45,29 +45,40 @@ async function appendScriptData(args) {
         }
         if (args.elementName) {
             let locators;
-            try {
-                if (!searchAttribute) {
-                    throw new Error("searchAttribute is not found");
-                }
-                const ffElement = await args.elementGetter.getFireFlinkElement(args.pageDOM, searchAttribute, effectivePlatform);
-                // locators = [{ name: "xpath", value: args.selector }];
-                if (!ffElement?.locators || ffElement.locators.length === 0) {
-                    throw new Error("locators is not found");
-                }
-                else {
-                    locators = ffElement.locators;
-                }
-            }
-            catch (error) {
-                logData_js_1.logger.info(`Element is not found ${error.message}`);
+            const isJsPath = args.selector?.includes(".shadowRoot") || args.selector?.startsWith("document.");
+            if (isJsPath) {
                 locators = [{
-                        name: "xpath",
-                        type: "static",
+                        name: "JsPath",
+                        type: "Static",
                         value: args.selector,
                         isRecorded: "N",
                         isAiRecorded: "Y"
                     }];
             }
+            else {
+                try {
+                    if (!searchAttribute) {
+                        throw new Error("searchAttribute is not found");
+                    }
+                    const ffElement = await args.elementGetter.getFireFlinkElement(args.pageDOM, searchAttribute, effectivePlatform);
+                    if (!ffElement?.locators || ffElement.locators.length === 0) {
+                        throw new Error("locators is not found");
+                    }
+                    else {
+                        locators = ffElement.locators;
+                    }
+                }
+                catch (error) {
+                    logData_js_1.logger.info(`Element is not found ${error.message}`);
+                    locators = [{
+                            name: "xpath",
+                            type: "static",
+                            value: args.selector,
+                            isRecorded: "N",
+                            isAiRecorded: "Y"
+                        }];
+                }
+            }
             data.elementsData = [{
                     name: args.elementName,
                     type: args.elementType,

package/dist/tests/test12.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/test12.js

@@ -1,35 +1,34 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-// import { verify } from "node:crypto";
-const index_js_1 = require("../index.js");
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-const certPath = path_1.default.join("D:", "Bitbucket", "ai-chat-backend", "Certificates", "V3keystore.jks");
-const ssl = {
-    ca: [fs_1.default.readFileSync(certPath, "utf-8")],
-    rejectUnauthorized: false,
-};
-const runner = new index_js_1.AutomationRunner();
-runner.run({
-    // hasMoreSteps: false,
-    userStory: [
-        ["Launch the browser"],
-        ["navigate to url https://www.indiamart.com"],
-        ["wait for 20 seconds"],
-        ["get otp from INDMRT message within 60 seconds and wait for 60 seconds"],
-        ["Enter OTP into enter otp boxes"],
-        ["wait for 10 seconds"],
-        ["Close the browser"]
-    ],
-    scenario: false,
-    sslConfig: ssl,
-    scriptType: "android",
-    broker: ["test3.fireflink.com:9092"], "scriptName": "script", "type": "Web & Mobile", "projectId": "PJT1006", "testCaseId": "SCR1806", kafkaMessageKey: 'lohit',
-    "promptId": "a8fba64a-4d91-422c-bdfd-a7609576a63e", "generatedBy": "", "webSocketId": "", "licenseType": "C-Professional", "licenseId": "LIC2026980", "userId": "USR26860", "projectType": "Web", "serverData": "https://performance.fireflink.com", "pageDetails": { "Web": { "pageId": "PAG3e09350f-4917-4c80-8ce5-a08e97fe314e", "pageName": "ai-Page" } }, "userName": "jai", isTerminate: false, "appiumPort": 4723, "realDeviceId": "", "browserName": "Google Chrome", "token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJIUlpZV2NoTURZWXVQaDF3TDkxb3drS3Q1OUtuNC1sOFRJcXF3a2RBV2pjIn0.eyJleHAiOjE3ODA1NzkwNzEsImlhdCI6MTc4MDQ5MjY3MSwianRpIjoib25ydHJvOmYxYzJiNjg2LTJiZGMtNGIxOS04ZGVhLTMwMjhhNDkxZDY5NCIsImlzcyI6Imh0dHA6Ly8xNDguNzIuMTY4LjE2OjMwMTA3L3JlYWxtcy9GaXJlRmxpbmstdGVzdDEiLCJhdWQiOiJ0YXJnZXQtY2xpZW50Iiwic3ViIjoiZjo4ODkyOWIwMC03M2I4LTQ3NGYtYmJiYy1kYjJlMWEzZTA3OTg6amFpYWthc2hAeW9wbWFpbC5jb20iLCJ0eXAiOiJCZWFyZXIiLCJhenAiOiJmbGluay1zZXJ2aWNlIiwic2lkIjoiZWRiMDgwZDctNzhiYi00NzU5LTgyM2EtMTM1ZDUzYTM5NmQzIiwiYWNyIjoiMSIsImFsbG93ZWQtb3JpZ2lucyI6WyIiXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbIm9mZmxpbmVfYWNjZXNzIiwidW1hX2F1dGhvcml6YXRpb24iXX0sInNjb3BlIjoicHJvZmlsZSBlbWFpbCIsImN1cnJlbnRMaWNlbnNlSWQiOiJMSUMzOTIyIiwiZW1haWxfdmVyaWZpZWQiOmZhbHNlLCJjdXJyZW50UHJpdmlsZWdlIjoiQWRtaW4iLCJmdWxsTmFtZSI6ImphaSIsImFjdGl2YXRpb25TdGF0dXMiOiJBQ1RJVkUiLCJwcml2aWxlZ2UiOiJBZG1pbiIsImxpY2Vuc2VOYW1lIjoiRmlyZUZsaW5rIC0gTElDMzkyMnciLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJqYWkiLCJ1c2VyTmFtZSI6ImphaWFrYXNoQHlvcG1haWwuY29tIiwiYmlsbGluZ0N5Y2xlIjoiWWVhcmx5IiwiaWQiOiJVU1IyNjc1MiIsImxpY2Vuc2VJZCI6IkxJQzM5MjIiLCJlbWFpbCI6ImphaWFrYXNoQHlvcG1haWwuY29tIn0.LPBCnEKBi8Yi4Qktpd_oW46-P7s0iQ0AejZeXRMIa8aUwfwY8gNl3McIrKLBVqPL4NKYe_05aMaiepvjkolu7RWh120mX90ZdNJuMUjg0WuRaM90xNjmy1YK94mBt0mphKK04u1K4trvhvgW2hTt4rvGRq_oEvH2E_2YqYw310TuP-guqxuZqTv_IJ6HFtvMJkV9L3A579juICZfGdS53-KuZwqn7jA-73nJZBzPJyMucaPz42s36RWpDmfs7MX0-Fcv8LH7FvCjCs63GvCC-tdGoh5m0MRCiElJocWlw9jabsPHymEt5-nemnXIZIon2675wYbxVx99mHA1VBPD2w", "sessionPath": "session", "platform": "android", "platformVersion": "", "env": "test1",
-    "serverHost": "https://sg-app.fireflink.com", "adbPath": "C:\\FireFlinkClient\\resources\\bin\\win\\android-sdk\\platform-tools\\adb.exe",
-    topic: "test-topic",
-    aiExecutionAction: ""
-});
+// // import { verify } from "node:crypto";
+// import { AutomationRunner } from "../index.js"
+// import { Kafka, Producer } from "kafkajs";
+// import path from "path";
+// import fs from "fs";
+// const certPath = path.join(
+//     "D:", "Bitbucket", "ai-chat-backend", "Certificates", "V3keystore.jks"
+// );
+// const ssl = {
+//     ca: [fs.readFileSync(certPath, "utf-8")],
+//     rejectUnauthorized: false,
+// }
+// const runner = new AutomationRunner();
+// runner.run({
+//     // hasMoreSteps: false,
+//     userStory: [
+//         ["Launch the browser"],
+//         ["navigate to url https://www.indiamart.com"],
+//         ["wait for 20 seconds"],
+//         ["get otp from INDMRT message within 60 seconds and wait for 60 seconds"],
+//         ["Enter OTP into enter otp boxes"],
+//         ["wait for 10 seconds"],
+//         ["Close the browser"]
+//     ],
+//     scenario: false,
+//     sslConfig: ssl,
+//     scriptType: "android",
+//     broker: ["test3.fireflink.com:9092"], "scriptName": "script", "type": "Web & Mobile", "projectId": "PJT1006", "testCaseId": "SCR1806", kafkaMessageKey: 'lohit',
+//     "promptId": "a8fba64a-4d91-422c-bdfd-a7609576a63e", "generatedBy": "", "webSocketId": "", "licenseType": "C-Professional", "licenseId": "LIC2026980", "userId": "USR26860", "projectType": "Web", "serverData": "https://performance.fireflink.com", "pageDetails": { "Web": { "pageId": "PAG3e09350f-4917-4c80-8ce5-a08e97fe314e", "pageName": "ai-Page" } }, "userName": "jai", isTerminate: false, "appiumPort": 4723, "realDeviceId": "", "browserName": "Google Chrome", "token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJIUlpZV2NoTURZWXVQaDF3TDkxb3drS3Q1OUtuNC1sOFRJcXF3a2RBV2pjIn0.eyJleHAiOjE3ODA1NzkwNzEsImlhdCI6MTc4MDQ5MjY3MSwianRpIjoib25ydHJvOmYxYzJiNjg2LTJiZGMtNGIxOS04ZGVhLTMwMjhhNDkxZDY5NCIsImlzcyI6Imh0dHA6Ly8xNDguNzIuMTY4LjE2OjMwMTA3L3JlYWxtcy9GaXJlRmxpbmstdGVzdDEiLCJhdWQiOiJ0YXJnZXQtY2xpZW50Iiwic3ViIjoiZjo4ODkyOWIwMC03M2I4LTQ3NGYtYmJiYy1kYjJlMWEzZTA3OTg6amFpYWthc2hAeW9wbWFpbC5jb20iLCJ0eXAiOiJCZWFyZXIiLCJhenAiOiJmbGluay1zZXJ2aWNlIiwic2lkIjoiZWRiMDgwZDctNzhiYi00NzU5LTgyM2EtMTM1ZDUzYTM5NmQzIiwiYWNyIjoiMSIsImFsbG93ZWQtb3JpZ2lucyI6WyIiXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbIm9mZmxpbmVfYWNjZXNzIiwidW1hX2F1dGhvcml6YXRpb24iXX0sInNjb3BlIjoicHJvZmlsZSBlbWFpbCIsImN1cnJlbnRMaWNlbnNlSWQiOiJMSUMzOTIyIiwiZW1haWxfdmVyaWZpZWQiOmZhbHNlLCJjdXJyZW50UHJpdmlsZWdlIjoiQWRtaW4iLCJmdWxsTmFtZSI6ImphaSIsImFjdGl2YXRpb25TdGF0dXMiOiJBQ1RJVkUiLCJwcml2aWxlZ2UiOiJBZG1pbiIsImxpY2Vuc2VOYW1lIjoiRmlyZUZsaW5rIC0gTElDMzkyMnciLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJqYWkiLCJ1c2VyTmFtZSI6ImphaWFrYXNoQHlvcG1haWwuY29tIiwiYmlsbGluZ0N5Y2xlIjoiWWVhcmx5IiwiaWQiOiJVU1IyNjc1MiIsImxpY2Vuc2VJZCI6IkxJQzM5MjIiLCJlbWFpbCI6ImphaWFrYXNoQHlvcG1haWwuY29tIn0.LPBCnEKBi8Yi4Qktpd_oW46-P7s0iQ0AejZeXRMIa8aUwfwY8gNl3McIrKLBVqPL4NKYe_05aMaiepvjkolu7RWh120mX90ZdNJuMUjg0WuRaM90xNjmy1YK94mBt0mphKK04u1K4trvhvgW2hTt4rvGRq_oEvH2E_2YqYw310TuP-guqxuZqTv_IJ6HFtvMJkV9L3A579juICZfGdS53-KuZwqn7jA-73nJZBzPJyMucaPz42s36RWpDmfs7MX0-Fcv8LH7FvCjCs63GvCC-tdGoh5m0MRCiElJocWlw9jabsPHymEt5-nemnXIZIon2675wYbxVx99mHA1VBPD2w", "sessionPath": "session", "platform": "android", "platformVersion": "", "env": "test1",
+//     "serverHost": "https://sg-app.fireflink.com", "adbPath": "C:\\FireFlinkClient\\resources\\bin\\win\\android-sdk\\platform-tools\\adb.exe",
+//     topic: "test-topic",
+//     aiExecutionAction: ""
+// });

package/dist/utils/JsPathGenerator/generateJsPath.d.ts

@@ -0,0 +1,2 @@
+export declare function convertToCssSelector(pathFragment: string): string;
+export declare function generateJsPath(selector: string, finalSelectorOverride?: string): string;

package/dist/utils/JsPathGenerator/generateJsPath.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToCssSelector = convertToCssSelector;
+exports.generateJsPath = generateJsPath;
+//Converts XPath or FireFlink selector fragment to a clean CSS selector.
+function convertToCssSelector(pathFragment) {
+    let s = pathFragment.trim().replace(/^\/+/, "");
+    // Remove redundant html/body prefix for top-level selectors
+    s = s.replace(/^html(\[\d+\])?\/body(\[\d+\])?\//i, "");
+    // Convert tag[n] -> tag or tag:nth-of-type(n)
+    s = s.replace(/([a-zA-Z0-9_-]+)\[(\d+)\]/g, (_, tag, index) => {
+        return index === "1" ? tag : `${tag}:nth-of-type(${index})`;
+    });
+    s = s.replace(/\//g, " > ");
+    return s;
+}
+//jspath generation
+function generateJsPath(selector, finalSelectorOverride) {
+    if (typeof selector !== 'string' || selector.trim().length === 0) {
+        throw new TypeError('generateJsPath: "selector" must be a non-empty string.');
+    }
+    const SHADOW_TOKEN = '/shadow/';
+    const trimmedSelector = selector.trim();
+    if (trimmedSelector.startsWith(SHADOW_TOKEN)) {
+        throw new Error('generateJsPath: selector cannot start with "/shadow/" — a host element path is required before it.');
+    }
+    if (trimmedSelector.endsWith(SHADOW_TOKEN)) {
+        throw new Error('generateJsPath: selector cannot end with "/shadow/" — a path is required after it.');
+    }
+    const rawChunks = trimmedSelector
+        .split(SHADOW_TOKEN)
+        .map((c) => c.trim())
+        .filter((c) => c.length > 0);
+    if (rawChunks.length === 0) {
+        throw new Error('generateJsPath: no valid path segments found in selector.');
+    }
+    const cssChunks = rawChunks.map((chunk) => xpathChunkToCss(chunk));
+    if (typeof finalSelectorOverride === 'string' && finalSelectorOverride.trim().length > 0) {
+        cssChunks[cssChunks.length - 1] = finalSelectorOverride.trim();
+    }
+    let jsPath = `document.querySelector(${toQuotedSelector(cssChunks[0])})`;
+    for (let i = 1; i < cssChunks.length; i++) {
+        jsPath += `.shadowRoot.querySelector(${toQuotedSelector(cssChunks[i])})`;
+    }
+    return jsPath;
+}
+//Helpers
+function toQuotedSelector(cssSelector) {
+    const cleanSelector = cssSelector.replace(/\[([\w\-:]+)\s*=\s*['"]([^'"]+)['"]\]/g, '[$1=$2]');
+    return `'${cleanSelector}'`;
+}
+//Nodes
+function xpathChunkToCss(chunk) {
+    const { nodes, combinators } = tokenizeXPath(chunk);
+    if (nodes.length === 0) {
+        throw new Error(`generateJsPath: unable to parse path segment "${chunk}".`);
+    }
+    let css = xpathNodeToCss(nodes[0]);
+    for (let i = 1; i < nodes.length; i++) {
+        const combinator = combinators[i] === 'descendant' ? ' ' : ' > ';
+        css += combinator + xpathNodeToCss(nodes[i]);
+    }
+    return css;
+}
+/**
+ * Splits an XPath chunk into node segments plus the axis combinator
+ * ('child' | 'descendant') that precedes each node. Bracket contents are
+ * treated as opaque so a `/` inside a predicate does not cause an
+ */
+function tokenizeXPath(path) {
+    const nodes = [];
+    const combinators = [];
+    let depth = 0;
+    let current = '';
+    let pendingCombinator;
+    let i = 0;
+    const pushCurrent = () => {
+        const trimmed = current.trim();
+        if (trimmed.length > 0 && trimmed !== '.') {
+            nodes.push(trimmed);
+            combinators.push(pendingCombinator);
+        }
+        current = '';
+    };
+    while (i < path.length) {
+        const ch = path[i];
+        if (ch === '[')
+            depth++;
+        if (ch === ']')
+            depth--;
+        if (ch === '/' && depth === 0) {
+            pushCurrent();
+            if (path[i + 1] === '/') {
+                pendingCombinator = 'descendant';
+                i += 2;
+                continue;
+            }
+            else {
+                pendingCombinator = 'child';
+                i += 1;
+                continue;
+            }
+        }
+        current += ch;
+        i += 1;
+    }
+    pushCurrent();
+    return { nodes, combinators };
+}
+/**
+ * Converts a single XPath node (e.g. `div[1]`, `input[@id='x']`,
+ * `span[contains(@class,'icon')]`) into an equivalent CSS selector
+ * fragment, always preserving positional predicates as `:nth-of-type()`.
+ */
+function xpathNodeToCss(node) {
+    const match = node.match(/^(\*|[A-Za-z_][\w\-.:]*)((?:\[[^\]]*\])*)$/);
+    // Fallback: if the node doesn't match the expected shape, pass it
+    // through as-is rather than silently dropping information.
+    if (!match) {
+        return node;
+    }
+    const tag = match[1];
+    const predicatesStr = match[2] || '';
+    const predicates = predicatesStr.match(/\[[^\]]*\]/g) || [];
+    const attrSelectors = [];
+    let nthIndex = null;
+    for (const pred of predicates) {
+        const inner = pred.slice(1, -1).trim();
+        // [@attr='value'] or [@attr="value"]
+        const attrEqMatch = inner.match(/^@([\w\-:]+)\s*=\s*(['"])(.*)\2$/);
+        // contains(@attr, 'value')
+        const containsMatch = inner.match(/^contains\(\s*@([\w\-:]+)\s*,\s*(['"])(.*)\2\s*\)$/i);
+        // position()=n
+        const positionMatch = inner.match(/^position\(\)\s*=\s*(\d+)$/i);
+        if (attrEqMatch) {
+            const attrName = attrEqMatch[1];
+            const attrValue = escapeCssString(attrEqMatch[3]);
+            attrSelectors.push(`[${attrName}='${attrValue}']`);
+        }
+        else if (containsMatch) {
+            const attrName = containsMatch[1];
+            const attrValue = escapeCssString(containsMatch[3]);
+            attrSelectors.push(`[${attrName}*='${attrValue}']`);
+        }
+        else if (/^\d+$/.test(inner)) {
+            nthIndex = inner;
+        }
+        else if (positionMatch) {
+            nthIndex = positionMatch[1];
+        }
+        else if (/^last\(\)$/i.test(inner)) {
+            nthIndex = 'last';
+        }
+        // Unrecognized predicates (e.g. text()-based) are skipped: they have
+        // no reliable CSS equivalent and are not safe to guess at.
+    }
+    let css = tag;
+    css += attrSelectors.join('');
+    if (nthIndex === 'last') {
+        css += ':nth-last-of-type(1)';
+    }
+    else if (nthIndex) {
+        css += `:nth-of-type(${nthIndex})`;
+    }
+    return css;
+}
+function escapeCssString(value) {
+    return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ff-automationv2",
-  "version": "2.2.34-beta.0",
+  "version": "2.2.34-beta.1",
   "private": false,
   "type": "commonjs",
   "description": "This lib is used to automate the manual testcase",