@playq/core 0.2.77

package/dist/helper/util/utilities/schemaGeneratorUtil.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+"use strict";
+/* PlayQ OpenAPI (OAS 3.1) -> schema TS files generator */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+function parseArgs(argv) {
+    const args = {
+        outDir: "resources/schemas",
+        prefix: "", // optional export prefix e.g. "Api"
+        indexFile: "index.ts",
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const v = argv[i + 1];
+        if (a === "--input" && v) {
+            args.input = v;
+            i++;
+            continue;
+        }
+        if (a === "--url" && v) {
+            args.url = v;
+            i++;
+            continue;
+        }
+        if (a === "--outDir" && v) {
+            args.outDir = v;
+            i++;
+            continue;
+        }
+        if (a === "--prefix" && v) {
+            args.prefix = v;
+            i++;
+            continue;
+        }
+        if (a === "--indexFile" && v) {
+            args.indexFile = v;
+            i++;
+            continue;
+        }
+    }
+    if (!args.input && !args.url) {
+        throw new Error(`Provide either --input <path-to-openapi.json> OR --url <openapi-json-url>`);
+    }
+    if (args.input && args.url) {
+        throw new Error(`Use only one of --input or --url (not both).`);
+    }
+    return args;
+}
+async function loadOpenApi(args) {
+    if (args.input) {
+        const p = node_path_1.default.resolve(args.input);
+        const raw = node_fs_1.default.readFileSync(p, "utf8");
+        return JSON.parse(raw);
+    }
+    // URL
+    const res = await fetch(args.url, {
+        headers: { Accept: "application/json" },
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch OpenAPI JSON from ${args.url}. HTTP ${res.status}`);
+    }
+    return (await res.json());
+}
+function safeIdent(name) {
+    // Make a valid TS identifier-ish name (keeps underscores)
+    const cleaned = name.replace(/[^a-zA-Z0-9_]/g, "_");
+    // Avoid leading digit
+    if (/^\d/.test(cleaned))
+        return "_" + cleaned;
+    return cleaned;
+}
+function exportNameFor(schemaName, prefix) {
+    // AgentVersion -> AgentVersionSchema, optional prefix -> ApiAgentVersionSchema
+    const base = `${schemaName}Schema`;
+    return prefix ? `${prefix}${base}` : base;
+}
+function ensureOutDir(outDir) {
+    node_fs_1.default.mkdirSync(outDir, { recursive: true });
+}
+function writeSchemaFile(outDir, schemaKey, exportName, schema, openapiVersion) {
+    const fileName = `${schemaKey}.schema.ts`;
+    const fullPath = node_path_1.default.join(outDir, fileName);
+    const content = `/* Auto-generated by PlayQ schema generator - OpenAPI ${openapiVersion} */\n` +
+        `/* Source schema: #/components/schemas/${schemaKey} */\n\n` +
+        `export const ${exportName} = ${JSON.stringify(schema, null, 2)} as const;\n`;
+    node_fs_1.default.writeFileSync(fullPath, content, "utf8");
+}
+function writeIndexFile(outDir, indexFile, entries) {
+    const fullPath = node_path_1.default.join(outDir, indexFile);
+    const lines = entries
+        .sort((a, b) => a.schemaKey.localeCompare(b.schemaKey))
+        .map(e => `export { ${e.exportName} } from "./${e.schemaKey}.schema";`);
+    node_fs_1.default.writeFileSync(fullPath, lines.join("\n") + "\n", "utf8");
+}
+async function main() {
+    var _a, _b, _c;
+    const args = parseArgs(process.argv.slice(2));
+    const doc = await loadOpenApi(args);
+    if (!((_a = doc.openapi) === null || _a === void 0 ? void 0 : _a.startsWith("3.1"))) {
+        // still might work, but you said OAS 3.1 and this generator assumes that
+        console.warn(`⚠️ OpenAPI version is "${doc.openapi}". Generator is optimised for 3.1.x.`);
+    }
+    const schemas = (_c = (_b = doc.components) === null || _b === void 0 ? void 0 : _b.schemas) !== null && _c !== void 0 ? _c : {};
+    const schemaKeys = Object.keys(schemas);
+    if (!schemaKeys.length) {
+        throw new Error(`No components.schemas found in the OpenAPI document.`);
+    }
+    const outDir = node_path_1.default.resolve(args.outDir);
+    ensureOutDir(outDir);
+    const indexEntries = [];
+    for (const rawKey of schemaKeys) {
+        const schemaKey = safeIdent(rawKey);
+        const exportName = exportNameFor(schemaKey, args.prefix);
+        const schema = schemas[rawKey];
+        writeSchemaFile(outDir, schemaKey, exportName, schema, doc.openapi);
+        indexEntries.push({ schemaKey, exportName });
+    }
+    writeIndexFile(outDir, args.indexFile, indexEntries);
+    console.log(`✅ Generated ${schemaKeys.length} schemas into: ${outDir}`);
+    console.log(`✅ Barrel export: ${node_path_1.default.join(outDir, args.indexFile)}`);
+}
+main().catch(err => {
+    console.error(`❌ ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+});

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

@@ -0,0 +1,2 @@
+declare function toCamelCase(input: string): string;
+export { toCamelCase };

package/dist/helper/util/utils.js

@@ -0,0 +1,22 @@
+"use strict";
+// Utilities for Test Automation
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCamelCase = toCamelCase;
+function toCamelCase(input) {
+    // Remove all non-alphanumeric characters except spaces
+    const cleaned = input.replace(/[^a-zA-Z0-9 ]/g, " ");
+    // Split by whitespace, lowercase first word, capitalize others
+    const words = cleaned.trim().split(/\s+/);
+    if (words.length === 0)
+        return "";
+    let camelCase = words[0].toLowerCase() +
+        words
+            .slice(1)
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join("");
+    // Ensure it doesn't start with a digit
+    if (/^[0-9]/.test(camelCase)) {
+        camelCase = "_" + camelCase;
+    }
+    return camelCase;
+}

package/dist/helper/wrapper/PlaywrightWrappers.d.ts

@@ -0,0 +1,8 @@
+import { Page } from "@playwright/test";
+export default class PlaywrightWrapper {
+    private page;
+    constructor(page: Page);
+    goto(url: string): Promise<void>;
+    waitAndClick(locator: string): Promise<void>;
+    navigateTo(link: string): Promise<void>;
+}

package/dist/helper/wrapper/PlaywrightWrappers.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class PlaywrightWrapper {
+    constructor(page) {
+        this.page = page;
+    }
+    async goto(url) {
+        await this.page.goto(url, {
+            waitUntil: "domcontentloaded"
+        });
+    }
+    async waitAndClick(locator) {
+        const element = this.page.locator(locator);
+        await element.waitFor({
+            state: "visible"
+        });
+        await element.click();
+    }
+    async navigateTo(link) {
+        await Promise.all([
+            this.page.waitForNavigation(),
+            this.page.click(link)
+        ]);
+    }
+}
+exports.default = PlaywrightWrapper;

package/dist/helper/wrapper/assert.d.ts

@@ -0,0 +1,9 @@
+import { Page } from "@playwright/test";
+export default class Assert {
+    private page;
+    constructor(page: Page);
+    assertTitle(title: string): Promise<void>;
+    assertTitleContains(title: string): Promise<void>;
+    assertURL(url: string): Promise<void>;
+    assertURLContains(title: string): Promise<void>;
+}

package/dist/helper/wrapper/assert.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_1 = require("@playwright/test");
+class Assert {
+    constructor(page) {
+        this.page = page;
+    }
+    async assertTitle(title) {
+        await (0, test_1.expect)(this.page).toHaveTitle(title);
+    }
+    async assertTitleContains(title) {
+        const pageTitle = await this.page.title();
+        (0, test_1.expect)(pageTitle).toContain(title);
+    }
+    async assertURL(url) {
+        await (0, test_1.expect)(this.page).toHaveURL(url);
+    }
+    async assertURLContains(title) {
+        const pageURL = this.page.url();
+        (0, test_1.expect)(pageURL).toContain(title);
+    }
+}
+exports.default = Assert;

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './global';
+export { loadEnv } from './helper/bundle/env';
+export * as vars from './helper/bundle/vars';
+export { webFixture } from './helper/fixtures/webFixture';
+export { logFixture } from './helper/fixtures/logFixture';
+export { webLocResolver } from './helper/fixtures/webLocFixture';
+export declare const loc: any;

package/dist/index.js

@@ -0,0 +1,57 @@
+"use strict";
+// Public entrypoint for @playq/core
+// Re-export commonly used framework APIs
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+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.loc = exports.webLocResolver = exports.logFixture = exports.webFixture = exports.vars = exports.loadEnv = void 0;
+// Global aggregator (vars, fixtures, actions, utils, faker, etc.)
+__exportStar(require("./global"), exports);
+// Lightweight config/env helpers for use in config files
+var env_1 = require("./helper/bundle/env");
+Object.defineProperty(exports, "loadEnv", { enumerable: true, get: function () { return env_1.loadEnv; } });
+exports.vars = __importStar(require("./helper/bundle/vars"));
+// Optional: direct exports for key fixtures
+var webFixture_1 = require("./helper/fixtures/webFixture");
+Object.defineProperty(exports, "webFixture", { enumerable: true, get: function () { return webFixture_1.webFixture; } });
+var logFixture_1 = require("./helper/fixtures/logFixture");
+Object.defineProperty(exports, "logFixture", { enumerable: true, get: function () { return logFixture_1.logFixture; } });
+var webLocFixture_1 = require("./helper/fixtures/webLocFixture");
+Object.defineProperty(exports, "webLocResolver", { enumerable: true, get: function () { return webLocFixture_1.webLocResolver; } });
+const locAggregate_1 = require("./helper/fixtures/locAggregate");
+// Expose loc from global if already initialized (via alias import), else build a best-effort namespace
+exports.loc = globalThis.loc || (0, locAggregate_1.getLocNamespace)();

package/dist/scripts/get-versions.d.ts

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

package/dist/scripts/get-versions.js

@@ -0,0 +1,98 @@
+"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 child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function getVersion(command) {
+    try {
+        return (0, child_process_1.execSync)(command, { encoding: 'utf8' }).trim();
+    }
+    catch (error) {
+        return 'Not installed';
+    }
+}
+function getPackageVersion(packageName) {
+    try {
+        const packageJsonPath = path.join(process.cwd(), 'node_modules', packageName, 'package.json');
+        if (fs.existsSync(packageJsonPath)) {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+            return packageJson.version;
+        }
+        return 'Not found';
+    }
+    catch (error) {
+        return 'Error reading version';
+    }
+}
+function getInstalledVersion(packageName) {
+    try {
+        const output = (0, child_process_1.execSync)(`npm list ${packageName} --depth=0`, { encoding: 'utf8' });
+        const match = output.match(new RegExp(`${packageName}@([\\d\\.]+)`));
+        return match ? match[1] : 'Not found';
+    }
+    catch (error) {
+        return 'Not installed';
+    }
+}
+function getPackageInfo() {
+    try {
+        const packageJsonPath = path.join(process.cwd(), 'package.json');
+        if (fs.existsSync(packageJsonPath)) {
+            return JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        }
+        return { name: 'Unknown', version: 'Unknown' };
+    }
+    catch (error) {
+        return { name: 'Error reading package.json', version: 'Error' };
+    }
+}
+console.log('🔍 PlayQ Framework Version Information\n');
+console.log('| Component | Version |');
+console.log('|-----------|---------|');
+console.log(`| Programming Language (TypeScript) | ${getVersion('npx tsc --version').replace('Version ', '')} |`);
+console.log(`| Runtime Environment (Node.js) | ${getVersion('node --version').replace('v', '')} |`);
+console.log(`| Automation Framework (Playwright) | ${getInstalledVersion('@playwright/test')} |`);
+console.log(`| Test Runner (Playwright Test Runner) | ${getInstalledVersion('@playwright/test')} |`);
+console.log(`| BDD Framework (Cucumber) | ${getInstalledVersion('@cucumber/cucumber')} |`);
+console.log(`| Reporting (Allure Playwright) | ${getInstalledVersion('allure-playwright')} |`);
+console.log(`| Data Generation Utility (Faker.js) | ${getInstalledVersion('@faker-js/faker')} |`);
+console.log(`| Cross Platform (cross-env) | ${getInstalledVersion('cross-env')} |`);
+console.log(`| File Operations (rimraf) | ${getInstalledVersion('rimraf')} |`);
+console.log('\n📦 Package Manager Information:');
+console.log(`| npm | ${getVersion('npm --version')} |`);
+const packageInfo = getPackageInfo();
+console.log(`| Package Name | ${packageInfo.name || 'play-ts-cucumber'} |`);
+console.log(`| Package Version | ${packageInfo.version || '1.0.0'} |`);

package/dist/scripts/posttest.d.ts

@@ -0,0 +1 @@
+export declare function executePostTest(): void;

package/dist/scripts/posttest.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executePostTest = executePostTest;
+const env_1 = require("../helper/bundle/env");
+const path_1 = __importDefault(require("path"));
+const { execSync } = require('child_process');
+const global_1 = require("../global");
+function executePostTest() {
+    (0, env_1.loadEnv)();
+    if (process.env.PLAYQ_RUNNER === 'cucumber') {
+        // CUCUMBER RUNNER
+    }
+    else {
+        // PLAYWRIGHT RUNNER
+        let allureSingleFile = (global_1.vars.getConfigValue('report.allure.singleFile') == 'true') ? '--single-file' : '';
+        execSync(`npx allure generate ${allureSingleFile} ./allure-results --output ./allure-report`, { stdio: 'inherit', cwd: path_1.default.resolve(__dirname, '../../') });
+        if (process.env.PLAYQ_REPORT_OPEN.toLowerCase() !== 'false' && global_1.vars.getConfigValue('testExecution.autoReportOpen') !== 'false') {
+            console.log('- [INFO] Report open disabled using PLAYQ_REPORT_OPEN');
+            execSync('npx allure open ./allure-report', { stdio: 'inherit', cwd: path_1.default.resolve(__dirname, '../../') });
+        }
+    }
+}
+// If called directly (not imported)
+if (require.main === module) {
+    executePostTest();
+}

package/dist/scripts/pretest.d.ts

@@ -0,0 +1 @@
+export declare function setupEnvironment(): void;

package/dist/scripts/pretest.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupEnvironment = setupEnvironment;
+const env_1 = require("../helper/bundle/env");
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("fs");
+function setupEnvironment() {
+    (0, env_1.loadEnv)();
+    // If running in Cucumber mode, we need to handle pre-processing differently
+    if (process.env.PLAYQ_RUNNER === 'cucumber') {
+        // CUCUMBER RUNNER
+        // Remove allure-report directory in the project folder for cucumber runner
+        try {
+            (0, fs_1.rmSync)(path_1.default.resolve(process.env['PLAYQ_PROJECT_ROOT'], 'test-results'), { recursive: true, force: true });
+        }
+        catch (err) {
+            console.warn('Warning: Failed to remove allure-report', err);
+        }
+        require(path_1.default.resolve(process.env['PLAYQ_CORE_ROOT'], 'exec/preProcessEntry.ts'));
+    }
+    else {
+        // PLAYWRIGHT RUNNER
+        // Remove allure-report and allure-results directories
+        try {
+            (0, fs_1.rmSync)(path_1.default.resolve(process.env['PLAYQ_PROJECT_ROOT'], 'allure-report'), { recursive: true, force: true });
+        }
+        catch (err) {
+            console.warn('Warning: Failed to remove ./allure-report', err);
+        }
+        try {
+            (0, fs_1.rmSync)(path_1.default.resolve(process.env['PLAYQ_PROJECT_ROOT'], 'allure-results'), { recursive: true, force: true });
+        }
+        catch (err) {
+            console.warn('Warning: Failed to remove ./allure-results', err);
+        }
+    }
+    // General directory cleanup
+    try {
+        (0, fs_1.rmSync)(path_1.default.resolve(process.env['PLAYQ_PROJECT_ROOT'], '_Temp/sessions'), { recursive: true, force: true });
+    }
+    catch (err) {
+        console.warn('Warning: Failed to remove _Temp/sessions folder', err);
+    }
+    try {
+        (0, fs_1.rmSync)(path_1.default.resolve(process.env['PLAYQ_PROJECT_ROOT'], '_Temp/smartAI'), { recursive: true, force: true });
+    }
+    catch (err) {
+        console.warn('Warning: Failed to remove _Temp/smartAI folder', err);
+    }
+}
+// If called directly (not imported)
+if (require.main === module) {
+    setupEnvironment();
+}

package/dist/scripts/util.d.ts

@@ -0,0 +1 @@
+export declare function encryptUserInput(): Promise<void>;