@playq/core 0.2.77

package/dist/helper/fixtures/webFixture.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webFixture = void 0;
+const browserManager_1 = require("../browsers/browserManager");
+// Inline runner detection to avoid external alias dependency
+function isPlaywrightRunner() { return process.env.TEST_RUNNER === 'playwright'; }
+const pages = new Map();
+const frames = new Map();
+let currentPage;
+let currentFrame;
+let logger;
+let currentPageName = "main";
+let browser;
+let context;
+let _world = null;
+let smartIQData = [];
+exports.webFixture = {
+    pages,
+    frames,
+    async launchBrowser() {
+        browser = await (0, browserManager_1.invokeBrowser)();
+    },
+    async newContext(options) {
+        if (!options) {
+            options = {
+                recordVideo: {
+                    dir: "test-results/videos",
+                },
+            };
+        }
+        context = await browser.newContext(options);
+        return context;
+    },
+    async newPage(name = "main") {
+        const page = await context.newPage();
+        pages.set(name, page);
+        currentPage = page;
+        currentPageName = name;
+        return page;
+    },
+    getBrowser() {
+        return browser;
+    },
+    getContext() {
+        return context;
+    },
+    getCurrentPage() {
+        return currentPage;
+    },
+    setCurrentPage(name) {
+        currentPage = pages.get(name);
+        currentPageName = name;
+    },
+    async closeContext() {
+        if (context) {
+            await context.close();
+        }
+    },
+    async closeAll() {
+        try {
+            if (context) {
+                // Close all pages explicitly
+                const allPages = context.pages();
+                for (const page of allPages) {
+                    try {
+                        // If tracing is on, stop and save
+                        if (context.tracing && context.tracing.stop) {
+                            await context.tracing.stop({ path: `test-results/trace/trace.zip` });
+                        }
+                        await page.close();
+                    }
+                    catch (err) {
+                        // Swallow errors silently
+                    }
+                }
+                await context.close();
+            }
+            if (browser) {
+                await browser.close();
+            }
+        }
+        catch (err) {
+            // Swallow errors silently
+        }
+    },
+    setWorld(world) {
+        _world = world;
+    },
+    getWorld() {
+        if (isPlaywrightRunner()) {
+            console.warn('⚠️ Skipping getWorld() in Playwright Runner');
+            return null;
+        }
+        if (!_world) {
+            throw new Error("❌ Cucumber World context not set. Did you forget to call webFixture.setWorld(this) in your step?");
+        }
+        return _world;
+    },
+    // other frame helpers remain the same
+    setPlaywrightPage(page) {
+        console.log('✅ Playwright page set in webFixture');
+        currentPage = page;
+    },
+    // SmartIQ Imeplementation
+    getSmartIQData() {
+        return smartIQData;
+    },
+    setSmartIQData(data) {
+        smartIQData = data;
+    }
+};
+async function createContextWithDefaults(scenarioName) {
+    const ctx = await browser.newContext({
+        recordVideo: {
+            dir: "test-results/videos",
+        },
+    });
+    await ctx.tracing.start({
+        name: scenarioName,
+        title: scenarioName,
+        sources: true,
+        screenshots: true,
+        snapshots: true,
+    });
+    return ctx;
+}
+// import { Page, Frame } from "@playwright/test";
+// import { Logger } from "winston";
+// import { invokeBrowser } from "@helper/browsers/browserManager";
+// const pages = new Map<string, Page>();
+// const frames = new Map<string, Frame>();
+// let currentPage: Page | undefined;
+// let currentFrame: Frame | undefined;
+// let logger: Logger;
+// let currentPageName: string = "main";
+// export const uiFixture = {
+//     pages,
+//     frames,
+//     setPage(page: Page) {
+//         pages.set(currentPageName, page);
+//     },
+//     setPageWithName(name: string, page: Page) {
+//         pages.set(name, page);
+//         currentPage = page;
+//         currentPageName = name;
+//     },
+//     getPage(name: string): Page | undefined {
+//         return pages.get(name);
+//     },
+//     setCurrentPage(name: string) {
+//         currentPage = pages.get(name);
+//         currentPageName = name;
+//     },
+//     getCurrentPage(): Page | undefined {
+//         return currentPage;
+//     },
+//     getCurrentPageName(): string {
+//         return currentPageName;
+//     },
+//     setFrame(name: string, frame: Frame) {
+//         frames.set(name, frame);
+//         currentFrame = frame;
+//     },
+//     getFrame(name: string): Frame | undefined {
+//         return frames.get(name);
+//     },
+//     setCurrentFrame(name: string) {
+//         currentFrame = frames.get(name);
+//     },
+//     getCurrentFrame(): Frame | undefined {
+//         return currentFrame;
+//     },
+//     setLogger(log: Logger) {
+//         logger = log;
+//     },
+//     getLogger(): Logger {
+//         return logger;
+//     }
+// };
+// import { Page } from "@playwright/test";
+// import { Logger } from "winston";
+// export const fixture = {
+//     // @ts-ignore
+//     page: undefined as Page,
+//     logger: undefined as Logger
+// }

package/dist/helper/fixtures/webLocFixture.d.ts

@@ -0,0 +1,2 @@
+import type { Page, Locator } from "playwright";
+export declare function webLocResolver(type: string, selector: string, pageArg: Page, overridePattern?: string, timeout?: number, smartAiRefresh?: 'before' | 'after' | ''): Promise<Locator>;

package/dist/helper/fixtures/webLocFixture.js

@@ -0,0 +1,144 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webLocResolver = webLocResolver;
+const vars = __importStar(require("../bundle/vars"));
+// Access project-provided engines dynamically at call time to avoid module init ordering issues
+function getEngines() { return globalThis.engines || {}; }
+// import { smartAI} from "@project/engines/smartAi/smartAiEngine";
+async function webLocResolver(type, selector, pageArg, overridePattern, timeout, smartAiRefresh = '') {
+    var _a, _b, _c, _d, _e;
+    console.log(`🔍 Resolving locator: ${selector}`);
+    const page = pageArg;
+    const isPlaywrightPrefixed = selector.startsWith("xpath=") || selector.startsWith("xpath =") || selector.startsWith("css=") || selector.startsWith("css =");
+    if (isPlaywrightPrefixed) {
+        // const rawSelector = selector.replace(/^xpath=|^css=|^xpath =|^xpath=\\|^xpath =\\|^css =/, "");
+        // Normalize escaped forward slashes first, then remove prefix
+        const rawSelector = selector
+            .replace(/^xpath=\\|^xpath =\\/, "xpath=") // normalize `xpath=\` to `xpath=`
+            .replace(/^xpath=|^xpath =|^css=|^css =/, "") // remove the actual prefix
+            .replace(/\\\//g, "/"); // replace escaped slashes with normal ones
+        console.log("📍 Detected Playwright-prefixed selector. Returning raw locator.");
+        return page.locator(rawSelector);
+    }
+    const isPlaywrightChainedPrefixed = selector.startsWith("chain=") || selector.startsWith("chain =");
+    if (isPlaywrightChainedPrefixed) {
+        const rawSelector = selector.replace(/^chain=|^chain =/, "");
+        console.log("📍 Detected Playwright-prefixed chained selector. Returning raw locator.");
+        return page.locator(rawSelector);
+    }
+    const isXPath = selector.trim().startsWith("//") || selector.trim().startsWith("(");
+    const isCSS = selector.includes(">") ||
+        selector.startsWith(".") ||
+        selector.includes("#");
+    const isChained = selector.includes(">>");
+    const isResourceLocator = selector.startsWith("loc.");
+    if ((isXPath || isCSS || isChained) && !isResourceLocator) {
+        console.log("📍 Detected XPath/CSS/Chained. Returning locator directly.");
+        return page.locator(selector);
+    }
+    if (isResourceLocator) {
+        const parts = selector.split(".");
+        if (parts.length < 3) {
+            throw new Error(`❌ Invalid locator format: "${selector}". Expected format: loc.(ts|json).<page>.<field>`);
+        }
+        const [, locType, pageName, fieldName] = parts;
+        if (selector.startsWith("loc.json.")) {
+            const [, , fileName, pageName, fieldName] = selector.split(".");
+            const jsonLocatorMap = await Promise.resolve(`${`@resources/locators/json/${fileName}.json`}`).then(s => __importStar(require(s)));
+            const pageObj = jsonLocatorMap === null || jsonLocatorMap === void 0 ? void 0 : jsonLocatorMap[pageName];
+            if (!pageObj)
+                throw new Error(`❌ Page "${pageName}" not found in ${fileName}.json`);
+            const locatorString = pageObj[fieldName];
+            if (!locatorString)
+                throw new Error(`❌ Field "${fieldName}" not found in ${fileName}.json[${pageName}]`);
+            console.log(`🧩 Resolved locator string from loc.json.${fileName}.${pageName}.${fieldName} -> ${locatorString}`);
+            return page.locator(await vars.replaceVariables(locatorString));
+        }
+        if (selector.startsWith("loc.ts.")) {
+            const [, , fileName, pageName, fieldName] = selector.split(".");
+            // First try globalThis.loc if available
+            const globalLoc = globalThis.loc;
+            if ((_b = (_a = globalLoc === null || globalLoc === void 0 ? void 0 : globalLoc[fileName]) === null || _a === void 0 ? void 0 : _a[pageName]) === null || _b === void 0 ? void 0 : _b[fieldName]) {
+                // console.log(`✅ Found locator in globalThis.loc for loc.ts.${fileName}.${pageName}.${fieldName}`);
+                return globalLoc[fileName][pageName][fieldName](page);
+            }
+        }
+        if (selector.startsWith("loc.")) {
+            const [, fileName, pageName, fieldName] = selector.split(".");
+            // First try globalThis.loc if available
+            const globalLoc = globalThis.loc;
+            if ((_d = (_c = globalLoc === null || globalLoc === void 0 ? void 0 : globalLoc[fileName]) === null || _c === void 0 ? void 0 : _c[pageName]) === null || _d === void 0 ? void 0 : _d[fieldName]) {
+                // console.log(`✅ Found locator in globalThis.loc for loc.ts.${fileName}.${pageName}.${fieldName}`);
+                return globalLoc[fileName][pageName][fieldName](page);
+            }
+        }
+        throw new Error(`❌ Unknown locator source type "${locType}". Use loc. or locator.`);
+    }
+    if (overridePattern && overridePattern.toLowerCase() === '-no-check-') {
+        console.log("📍 '-no-check-' detected. Skipping locator resolution.");
+        return undefined; // or even better, throw a custom signal or null to trigger fallback
+    }
+    // SmartAI (guard if engine missing)
+    const isSmartAiEnabled = String(vars.getConfigValue('smartAi.enable')).toLowerCase().trim() === 'true';
+    if (isSmartAiEnabled) {
+        const smartAiEngine = (_e = getEngines()) === null || _e === void 0 ? void 0 : _e.smartAi;
+        if (typeof smartAiEngine === 'function') {
+            return await smartAiEngine(page, type, selector, smartAiRefresh);
+        }
+        else {
+            console.warn('⚠️ SmartAI enabled but engines.smartAi not available/function. Falling back.');
+        }
+    }
+    // Fallback to locatorPattern (locPattern)
+    const isPatternEnabled = String(vars.getConfigValue('patternIq.enable')).toLowerCase().trim() === 'true';
+    console.log('PatternIQ enabled?', isPatternEnabled);
+    if (isPatternEnabled) {
+        const eng = getEngines();
+        try {
+            console.log('PatternIQ engines keys:', Object.keys(eng || {}));
+        }
+        catch { }
+        const patternEngine = (eng === null || eng === void 0 ? void 0 : eng.patternIq) || (eng && eng.engines && eng.engines.patternIq);
+        if (typeof patternEngine === 'function') {
+            return await patternEngine(page, type, selector, overridePattern, timeout);
+        }
+        else {
+            console.warn('⚠️ PatternIQ enabled but engines.patternIq not available/function. Falling back to default locator.');
+        }
+    }
+    // Fallback to default locator
+    return page.locator(selector);
+}

package/dist/helper/report/allureStepLogger.js

@@ -0,0 +1,25 @@
+// src/helper/report/allureStepLogger.ts
+// import { step, attachment, owner, issue } from 'allure-js-commons';
+// import { isCucumberRunner } from '@config/runner';
+// import { webFixture } from '@helper/fixtures/webFixture';
+// /**
+//  * Logs a step to Allure or attaches it in Cucumber world.
+//  * 
+//  * @param stepName Description of the step
+//  * @param stepFn Function to execute within the step
+//  */
+// export async function logStep(stepName: string, stepFn: () => Promise<void>) {
+//   if (isCucumberRunner()) {
+//     const world = webFixture.getWorld();
+//     try {
+//       await world.attach(`🟡 Step: ${stepName}`, 'text/plain');
+//       await stepFn();
+//       await world.attach(`✅ Passed: ${stepName}`, 'text/plain');
+//     } catch (err: any) {
+//       await world.attach(`❌ Failed: ${stepName} - ${err.message}`, 'text/plain');
+//       throw err;
+//     }
+//   } else {
+//     await allure.step(stepName, stepFn);
+//   }
+// }

package/dist/helper/report/customiseReport.d.ts

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

package/dist/helper/report/customiseReport.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const inputPath = 'test-results/cucumber-report.json';
+const outputPath = 'test-results/cucumber-report-custom.json';
+function extractReplacements(embeddings) {
+    const replacements = {};
+    embeddings === null || embeddings === void 0 ? void 0 : embeddings.forEach(embed => {
+        const data = embed === null || embed === void 0 ? void 0 : embed.data;
+        const match = data === null || data === void 0 ? void 0 : data.match(/Replaced: \|\\?"(.*?)\\?"\|-with-\|(.*?)\|/);
+        if (match) {
+            const original = match[1];
+            const replaced = match[2];
+            replacements[original] = replaced;
+        }
+    });
+    return replacements;
+}
+function updateStepName(step) {
+    const replacements = extractReplacements(step.embeddings || []);
+    for (const [original, replaced] of Object.entries(replacements)) {
+        const quotedOriginal = `"${original}"`;
+        const quotedReplaced = `"${replaced}"`;
+        step.name = step.name.replace(quotedOriginal, quotedReplaced);
+    }
+}
+function processReport() {
+    const raw = fs_1.default.readFileSync(inputPath, 'utf-8');
+    if (!raw || !raw.trim()) {
+        console.warn("⚠️ customiseReport: Empty or invalid JSON input. Skipping processing.");
+        return;
+    }
+    const report = JSON.parse(raw);
+    for (const feature of report) {
+        for (const scenario of feature.elements || []) {
+            for (const step of scenario.steps || []) {
+                updateStepName(step);
+                // Check for soft assertion failures in embeddings
+                if (Array.isArray(step.embeddings) &&
+                    step.embeddings.some((embed) => typeof embed.data === "string" &&
+                        embed.data.includes("Soft Assertion: [Failed]"))) {
+                    if (!step.result)
+                        step.result = {};
+                    step.result.status = "failed";
+                }
+            }
+        }
+    }
+    fs_1.default.writeFileSync(outputPath, JSON.stringify(report, null, 2), 'utf-8');
+    console.log(`✅ Updated report written to ${outputPath}`);
+}
+processReport();

package/dist/helper/report/init.d.ts

@@ -0,0 +1 @@
+declare const fs: any;

package/dist/helper/report/init.js

@@ -0,0 +1,14 @@
+const fs = require("fs-extra");
+try {
+    fs.ensureDirSync("test-results/screenshots");
+    fs.emptyDirSync("test-results/screenshots");
+    fs.ensureDirSync("test-results/videos");
+    fs.emptyDirSync("test-results/videos");
+    fs.ensureDirSync("test-results/trace");
+    fs.emptyDirSync("test-results/trace");
+    // Do NOT clean the whole test-results folder!
+    // fs.emptyDirSync("test-results");
+}
+catch (error) {
+    console.log("⚠️ Folder setup failed! " + error);
+}

package/dist/helper/report/report.d.ts

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

package/dist/helper/report/report.js

@@ -0,0 +1,102 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const report = require("multiple-cucumber-html-reporter");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const jsonPath = "test-results/cucumber-report.json";
+if (!fs.existsSync(jsonPath)) {
+    console.warn("⚠️ cucumber-report.json not found.");
+    const files = fs.readdirSync("test-results");
+    console.warn("📁 test-results folder contains:", files);
+}
+else {
+    // 💡 Load JSON, patch paths, save back
+    const raw = fs.readFileSync(jsonPath, "utf-8");
+    const data = JSON.parse(raw);
+    data.forEach((feature) => {
+        var _a;
+        if ((_a = feature.uri) === null || _a === void 0 ? void 0 : _a.startsWith("_TEMP/execution/")) {
+            feature.uri = feature.uri.replace("_TEMP/execution/", "");
+        }
+    });
+    fs.writeFileSync(jsonPath, JSON.stringify(data, null, 2)); // Save the cleaned version
+}
+// Removing "_TEMP/execution/" from cucumber-report.html
+const htmlReportPath = "test-results/cucumber-report.html";
+if (fs.existsSync(htmlReportPath)) {
+    let html = fs.readFileSync(htmlReportPath, "utf-8");
+    // Use split/join for wide Node compatibility (avoid String.replaceAll requirement)
+    const updatedHtml = html.split("_TEMP/execution/").join("");
+    fs.writeFileSync(htmlReportPath, updatedHtml, "utf-8");
+    console.log("🧼 Cleaned cucumber-report.html by removing '_TEMP/execution/'");
+}
+else {
+    console.warn("⚠️ cucumber-report.html not found.");
+}
+if (fs.existsSync(jsonPath)) {
+    fs.unlinkSync(jsonPath);
+    console.log(`🗑️ Removed existing ${jsonPath}`);
+}
+// Fetching the system details
+const platformName = os.platform();
+const platformVersion = os.release();
+const deviceName = os.hostname();
+report.generate({
+    jsonDir: "test-results",
+    reportPath: "test-results/reports/",
+    reportName: "Playwright Automation Report",
+    pageTitle: "BookCart App test report",
+    displayDuration: false,
+    metadata: {
+        browser: {
+            name: "chrome",
+            version: "112",
+        },
+        device: deviceName,
+        platform: {
+            name: platformName,
+            version: platformVersion,
+        },
+    },
+    customData: {
+        title: "Test Info",
+        data: [
+            { label: "Project", value: "Book Cart Application" },
+            { label: "Release", value: "1.2.3" },
+            { label: "Cycle", value: "Smoke-1" },
+        ],
+    },
+});

package/dist/helper/util/dataLoader.d.ts

@@ -0,0 +1,10 @@
+type DataFormat = 'json' | 'excel' | 'csv';
+/**
+ * Reads test data from .json, .xlsx, or .csv
+ *
+ * @param file - Filename (without extension), e.g., "login"
+ * @param format - File format: "json" | "excel" | "csv"
+ * @param sheetName - (optional) Sheet name for Excel files
+ */
+export declare function getTestData(file: string, format?: DataFormat, sheetName?: string): any[];
+export {};

package/dist/helper/util/dataLoader.js

@@ -0,0 +1,73 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTestData = getTestData;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const XLSX = __importStar(require("@e965/xlsx"));
+/**
+ * Reads test data from .json, .xlsx, or .csv
+ *
+ * @param file - Filename (without extension), e.g., "login"
+ * @param format - File format: "json" | "excel" | "csv"
+ * @param sheetName - (optional) Sheet name for Excel files
+ */
+function getTestData(file, format = 'json', sheetName) {
+    const basePath = path_1.default.resolve(`resources/test-data`);
+    switch (format) {
+        case 'json': {
+            const jsonPath = path_1.default.join(basePath, `${file}.json`);
+            const raw = fs_1.default.readFileSync(jsonPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        case 'excel': {
+            const xlsxPath = path_1.default.join(basePath, `${file}.xlsx`);
+            const workbook = XLSX.readFile(xlsxPath);
+            const sheet = workbook.Sheets[sheetName || workbook.SheetNames[0]];
+            return XLSX.utils.sheet_to_json(sheet);
+        }
+        case 'csv': {
+            const csvPath = path_1.default.join(basePath, `${file}.csv`);
+            const fileData = fs_1.default.readFileSync(csvPath, 'utf-8');
+            const worksheet = XLSX.read(fileData, { type: 'string' }).Sheets['Sheet1'];
+            return XLSX.utils.sheet_to_json(worksheet);
+        }
+        default:
+            throw new Error(`Unsupported format: ${format}`);
+    }
+}

package/dist/helper/util/logger.d.ts

@@ -0,0 +1,4 @@
+import { transports } from "winston";
+export declare function options(scenarioName: string): {
+    transports: transports.FileTransportInstance[];
+};