@flash-ai-team/flash-test-framework 0.0.1 → 0.0.2

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export { Web } from './keywords/WebUI';
 export { AIWeb } from './keywords/AIWebUI';
 export { Keyword, KeywordContext } from './core/Keyword';
 export { TestObject, el } from './core/ObjectRepository';
+export { TestCase } from './core/TestDecorators';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.el = exports.TestObject = exports.KeywordContext = exports.Keyword = exports.AIWeb = exports.Web = void 0;
+exports.TestCase = exports.el = exports.TestObject = exports.KeywordContext = exports.Keyword = exports.AIWeb = exports.Web = void 0;
 var WebUI_1 = require("./keywords/WebUI");
 Object.defineProperty(exports, "Web", { enumerable: true, get: function () { return WebUI_1.Web; } });
 var AIWebUI_1 = require("./keywords/AIWebUI");
@@ -11,3 +11,5 @@ Object.defineProperty(exports, "KeywordContext", { enumerable: true, get: functi
 var ObjectRepository_1 = require("./core/ObjectRepository");
 Object.defineProperty(exports, "TestObject", { enumerable: true, get: function () { return ObjectRepository_1.TestObject; } });
 Object.defineProperty(exports, "el", { enumerable: true, get: function () { return ObjectRepository_1.el; } });
+var TestDecorators_1 = require("./core/TestDecorators");
+Object.defineProperty(exports, "TestCase", { enumerable: true, get: function () { return TestDecorators_1.TestCase; } });

package/dist/keywords/AIWebUI.d.ts

@@ -12,6 +12,11 @@ export declare class AIWeb {
     static click(description: string): Promise<void>;
     static setText(description: string, text: string): Promise<void>;
     static verifyText(description: string, expectedText: string): Promise<void>;
+    /**
+     * Specialized handler for reCAPTCHA.
+     * Searches for the reCAPTCHA iframe and clicks the checkbox.
+     */
+    static clickReCaptcha(): Promise<void>;
     /**
      * Executes manual test steps by converting them to WebUI keyword calls using AI.
      * @param steps - Natural language test steps (one per line or paragraph).

package/dist/keywords/AIWebUI.js

@@ -152,6 +152,36 @@ class AIWeb {
             throw new Error(`Expected text "${expectedText}" not found in element "${description}". Found: "${text}"`);
         }
     }
+    /**
+     * Specialized handler for reCAPTCHA.
+     * Searches for the reCAPTCHA iframe and clicks the checkbox.
+     */
+    static async clickReCaptcha() {
+        console.log("Attempting to find and click reCAPTCHA...");
+        const frames = this.page.frames();
+        let captchaFrame = null;
+        // Find the reCAPTCHA iframe
+        for (const frame of frames) {
+            if (frame.url().includes('google.com/recaptcha/api2/anchor')) {
+                captchaFrame = frame;
+                break;
+            }
+        }
+        if (!captchaFrame) {
+            console.warn("reCAPTCHA iframe not found among " + frames.length + " frames.");
+            // Try waiting? fallback
+            return;
+        }
+        const anchor = captchaFrame.locator('#recaptcha-anchor, .recaptcha-checkbox-border').first();
+        try {
+            await anchor.waitFor({ state: 'visible', timeout: 5000 });
+            await anchor.click();
+            console.log("Clicked reCAPTCHA anchor.");
+        }
+        catch (e) {
+            console.error("Failed to click reCAPTCHA anchor", e);
+        }
+    }
     /**
      * Executes manual test steps by converting them to WebUI keyword calls using AI.
      * @param steps - Natural language test steps (one per line or paragraph).
@@ -164,14 +194,56 @@ class AIWeb {
             // Remove numbering (e.g., "1. ")
             const cleanLine = line.replace(/^\d+\.\s*/, '').trim();
             console.log(`Processing step: "${cleanLine}"`);
+            // 8. Wait for "..." to disappear (Moved to top priority to avoid conflicts)
+            const waitDisappearMatch = cleanLine.match(/^Wait for "([^"]+)"(?: .+)? (?:to )?disappear$/i);
+            if (waitDisappearMatch) {
+                const targetDesc = waitDisappearMatch[1];
+                const selector = `text="${targetDesc}" >> nth=0`;
+                await WebUI_1.Web.waitForElementNotVisible((0, ObjectRepository_1.el)(selector, targetDesc));
+                continue;
+            }
+            // 10. Verify that element "..." contains text "..." is also "..."
+            const tripleCheckMatch = cleanLine.match(/^Verify that element "([^"]+)" contains (?:text )?"([^"]+)" is also "([^"]+)"$/i);
+            if (tripleCheckMatch) {
+                const containerDesc = tripleCheckMatch[1];
+                const text1 = tripleCheckMatch[2];
+                const text2 = tripleCheckMatch[3];
+                const selector = `*:has-text("${containerDesc}"):has-text("${text1}"):has-text("${text2}") >> nth=-1`;
+                await WebUI_1.Web.verifyElementPresent((0, ObjectRepository_1.el)(selector, `Element '${containerDesc}' containing '${text1}' and '${text2}'`));
+                continue;
+            }
+            // 9. Verify that element "..." contains text "..."
+            const elementContainsMatch = cleanLine.match(/^Verify that element "([^"]+)" contains (?:text )?"([^"]+)"$/i);
+            if (elementContainsMatch) {
+                const containerDesc = elementContainsMatch[1];
+                const containedText = elementContainsMatch[2];
+                // Select the deepest element (*) that contains BOTH strings.
+                // nth=-1 selects the last one, which is typically the most specific common ancestor in the DOM tree order.
+                const selector = `*:has-text("${containerDesc}"):has-text("${containedText}") >> nth=-1`;
+                await WebUI_1.Web.verifyElementPresent((0, ObjectRepository_1.el)(selector, `Element '${containerDesc}' with text '${containedText}'`));
+                continue;
+            }
+            // SPECIAL CASE: reCAPTCHA
+            if (cleanLine.toLowerCase().includes("i'm not a robot") || cleanLine.toLowerCase().includes("i am not robot")) {
+                await this.clickReCaptcha();
+                continue;
+            }
+            // 8a. Wait for "..." to appear
+            const waitAppearMatch = cleanLine.match(/^Wait for "([^"]+)"(?: .+)? (?:to )?appear$/i);
+            if (waitAppearMatch) {
+                const targetDesc = waitAppearMatch[1];
+                const selector = `text="${targetDesc}" >> nth=0`;
+                await WebUI_1.Web.waitForElementVisible((0, ObjectRepository_1.el)(selector, targetDesc));
+                continue;
+            }
             // 1. Navigate to "url"
             const navigateMatch = cleanLine.match(/^Navigate to "([^"]+)"$/i);
             if (navigateMatch) {
                 await WebUI_1.Web.navigateToUrl(navigateMatch[1]);
                 continue;
             }
-            // 2. Enter "text" into ...
-            const enterMatch = cleanLine.match(/^Enter "([^"]+)" into (?:the )?(.+)$/i);
+            // 2. Enter "text" into ... / Type "text" into ...
+            const enterMatch = cleanLine.match(/^(?:Enter|Type) "([^"]+)" into (?:the )?(.+)$/i);
             if (enterMatch) {
                 const text = enterMatch[1];
                 let targetDesc = enterMatch[2];
@@ -230,9 +302,10 @@ class AIWeb {
                 continue;
             }
             // 5. Scroll to ...
+            const quotedScrollMatch = cleanLine.match(/^Scroll to (?:the )?"([^"]+)"/i);
             const scrollMatch = cleanLine.match(/^Scroll to (?:the )?(.+)$/i);
-            if (scrollMatch) {
-                let targetDesc = scrollMatch[1];
+            if (quotedScrollMatch || scrollMatch) {
+                let targetDesc = quotedScrollMatch ? quotedScrollMatch[1] : scrollMatch[1];
                 targetDesc = targetDesc.replace(/ button$/i, '').replace(/ link$/i, '').replace(/ marker$/i, '').trim();
                 const selector = `text="${targetDesc}" >> nth=0`;
                 await WebUI_1.Web.scrollToElement((0, ObjectRepository_1.el)(selector, targetDesc));
@@ -242,7 +315,71 @@ class AIWeb {
             const verifyTextMatch = cleanLine.match(/^Verify that the text "([^"]+)" is present$/i);
             if (verifyTextMatch) {
                 const expectedText = verifyTextMatch[1];
-                await WebUI_1.Web.verifyElementPresent((0, ObjectRepository_1.el)(`text="${expectedText}"`, `Text '${expectedText}'`));
+                await WebUI_1.Web.verifyElementPresent((0, ObjectRepository_1.el)(`text="${expectedText}" >> nth=0`, `Text '${expectedText}'`));
+                continue;
+            }
+            // 7. Delay for ...
+            const delayMatch = cleanLine.match(/^Delay for ([\d.]+) seconds?$/i);
+            if (delayMatch) {
+                const seconds = parseFloat(delayMatch[1]);
+                await WebUI_1.Web.delay(seconds);
+                continue;
+            }
+            // Verify page url is "..."
+            const verifyUrlMatch = cleanLine.match(/^Verify page url is "([^"]+)"$/i);
+            if (verifyUrlMatch) {
+                const url = verifyUrlMatch[1];
+                await WebUI_1.Web.verifyUrl(url);
+                continue;
+            }
+            // Maximize Window
+            if (cleanLine.match(/^Maximize window$/i)) {
+                await WebUI_1.Web.maximizeWindow();
+                continue;
+            }
+            // Minimize Window
+            if (cleanLine.match(/^Minimize window$/i)) {
+                await WebUI_1.Web.minimizeWindow();
+                continue;
+            }
+            // Wait for Angular to load
+            if (cleanLine.match(/^Wait for Angular to load$/i)) {
+                await WebUI_1.Web.waitForAngularLoad();
+                continue;
+            }
+            // Check "..."
+            const checkMatch = cleanLine.match(/^Check "([^"]+)"$/i);
+            if (checkMatch) {
+                const targetDesc = checkMatch[1];
+                // Try finding by label or just text.
+                // For Material checkbox, label usually contains the text.
+                const selector = `text="${targetDesc}" >> nth=0`;
+                await WebUI_1.Web.check((0, ObjectRepository_1.el)(selector, targetDesc));
+                continue;
+            }
+            // Uncheck "..."
+            const uncheckMatch = cleanLine.match(/^Uncheck "([^"]+)"$/i);
+            if (uncheckMatch) {
+                const targetDesc = uncheckMatch[1];
+                const selector = `text="${targetDesc}" >> nth=0`;
+                await WebUI_1.Web.uncheck((0, ObjectRepository_1.el)(selector, targetDesc));
+                continue;
+            }
+            // Verify that element "..." is checked/unchecked
+            const verifyCheckedMatch = cleanLine.match(/^Verify that element "([^"]+)" is (checked|unchecked)$/i);
+            if (verifyCheckedMatch) {
+                const targetDesc = verifyCheckedMatch[1];
+                const state = verifyCheckedMatch[2].toLowerCase();
+                const selector = `text="${targetDesc}" >> nth=0`;
+                await WebUI_1.Web.verifyElementChecked((0, ObjectRepository_1.el)(selector, targetDesc), state === 'checked');
+                continue;
+            }
+            // Set window size to WxH
+            const setSizeMatch = cleanLine.match(/^Set window size to (\d+)x(\d+)$/i);
+            if (setSizeMatch) {
+                const width = parseInt(setSizeMatch[1]);
+                const height = parseInt(setSizeMatch[2]);
+                await WebUI_1.Web.setWindowSize(width, height);
                 continue;
             }
             console.warn(`Could not parse step: "${cleanLine}"`);

package/dist/keywords/WebUI.d.ts

@@ -7,6 +7,12 @@ export declare class Web {
      * @param url - The URL to navigate to.
      */
     static navigateToUrl(url: string): Promise<void>;
+    /**
+     * Verifies that the current page URL matches the expected URL.
+     * @param url - The expected URL.
+     * @param timeout - The maximum time to wait in milliseconds (default: 5000).
+     */
+    static verifyUrl(url: string, timeout?: number): Promise<void>;
     /**
      * Clicks on the specified element.
      * @param to - The TestObject representing the element.
@@ -123,6 +129,12 @@ export declare class Web {
      * @param expectedValue - The expected attribute value.
      */
     static verifyElementAttributeValue(to: TestObject, attribute: string, expectedValue: string): Promise<void>;
+    /**
+     * Verifies that the element is checked or unchecked.
+     * @param to - The TestObject representing the checkbox/radio.
+     * @param checked - True to verify checked, false to verify unchecked (default: true).
+     */
+    static verifyElementChecked(to: TestObject, checked?: boolean): Promise<void>;
     /**
      * Waits for the specified element to be visible.
      * @param to - The TestObject representing the element.
@@ -163,4 +175,22 @@ export declare class Web {
      * @param to - The TestObject representing the element.
      */
     static scrollToElement(to: TestObject): Promise<void>;
+    /**
+     * Maximizes the browser window (sets viewport to 1920x1080).
+     */
+    static maximizeWindow(): Promise<void>;
+    /**
+     * Minimizes the browser window (sets viewport to a small size).
+     */
+    static minimizeWindow(): Promise<void>;
+    /**
+     * Sets the browser window size.
+     * @param width - The width in pixels.
+     * @param height - The height in pixels.
+     */
+    static setWindowSize(width: number, height: number): Promise<void>;
+    /**
+     * Waits for Angular to finish rendering.
+     */
+    static waitForAngularLoad(): Promise<void>;
 }

package/dist/keywords/WebUI.js

@@ -31,6 +31,14 @@ class Web {
     static async navigateToUrl(url) {
         await this.page.goto(url);
     }
+    /**
+     * Verifies that the current page URL matches the expected URL.
+     * @param url - The expected URL.
+     * @param timeout - The maximum time to wait in milliseconds (default: 5000).
+     */
+    static async verifyUrl(url, timeout = 5000) {
+        await (0, test_1.expect)(this.page).toHaveURL(url, { timeout });
+    }
     /**
      * Clicks on the specified element.
      * @param to - The TestObject representing the element.
@@ -262,6 +270,19 @@ class Web {
     static async verifyElementAttributeValue(to, attribute, expectedValue) {
         await (0, test_1.expect)(this.getLocator(to)).toHaveAttribute(attribute, expectedValue);
     }
+    /**
+     * Verifies that the element is checked or unchecked.
+     * @param to - The TestObject representing the checkbox/radio.
+     * @param checked - True to verify checked, false to verify unchecked (default: true).
+     */
+    static async verifyElementChecked(to, checked = true) {
+        if (checked) {
+            await (0, test_1.expect)(this.getLocator(to)).toBeChecked();
+        }
+        else {
+            await (0, test_1.expect)(this.getLocator(to)).not.toBeChecked();
+        }
+    }
     // --- Wait Keywords ---
     /**
      * Waits for the specified element to be visible.
@@ -324,6 +345,39 @@ class Web {
     static async scrollToElement(to) {
         await this.getLocator(to).scrollIntoViewIfNeeded();
     }
+    // --- Window Keywords ---
+    /**
+     * Maximizes the browser window (sets viewport to 1920x1080).
+     */
+    static async maximizeWindow() {
+        await this.page.setViewportSize({ width: 1920, height: 1080 });
+    }
+    /**
+     * Minimizes the browser window (sets viewport to a small size).
+     */
+    static async minimizeWindow() {
+        await this.page.setViewportSize({ width: 500, height: 400 });
+    }
+    /**
+     * Sets the browser window size.
+     * @param width - The width in pixels.
+     * @param height - The height in pixels.
+     */
+    static async setWindowSize(width, height) {
+        await this.page.setViewportSize({ width, height });
+    }
+    /**
+     * Waits for Angular to finish rendering.
+     */
+    static async waitForAngularLoad() {
+        await this.page.evaluate(async () => {
+            // @ts-ignore
+            if (window.getAllAngularTestabilities) {
+                // @ts-ignore
+                await Promise.all(window.getAllAngularTestabilities().map(t => new Promise(resolve => t.whenStable(resolve))));
+            }
+        });
+    }
 }
 exports.Web = Web;
 __decorate([
@@ -332,6 +386,12 @@ __decorate([
     __metadata("design:paramtypes", [String]),
     __metadata("design:returntype", Promise)
 ], Web, "navigateToUrl", null);
+__decorate([
+    (0, Keyword_1.Keyword)("Verify Url"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Number]),
+    __metadata("design:returntype", Promise)
+], Web, "verifyUrl", null);
 __decorate([
     (0, Keyword_1.Keyword)("Click"),
     __metadata("design:type", Function),
@@ -458,6 +518,12 @@ __decorate([
     __metadata("design:paramtypes", [ObjectRepository_1.TestObject, String, String]),
     __metadata("design:returntype", Promise)
 ], Web, "verifyElementAttributeValue", null);
+__decorate([
+    (0, Keyword_1.Keyword)("Verify Element Checked"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [ObjectRepository_1.TestObject, Boolean]),
+    __metadata("design:returntype", Promise)
+], Web, "verifyElementChecked", null);
 __decorate([
     (0, Keyword_1.Keyword)("Wait For Element Visible"),
     __metadata("design:type", Function),
@@ -500,3 +566,27 @@ __decorate([
     __metadata("design:paramtypes", [ObjectRepository_1.TestObject]),
     __metadata("design:returntype", Promise)
 ], Web, "scrollToElement", null);
+__decorate([
+    (0, Keyword_1.Keyword)("Maximize Window"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], Web, "maximizeWindow", null);
+__decorate([
+    (0, Keyword_1.Keyword)("Minimize Window"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], Web, "minimizeWindow", null);
+__decorate([
+    (0, Keyword_1.Keyword)("Set Window Size"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Number, Number]),
+    __metadata("design:returntype", Promise)
+], Web, "setWindowSize", null);
+__decorate([
+    (0, Keyword_1.Keyword)("Wait For Angular Load"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], Web, "waitForAngularLoad", null);

package/dist/reporting/ReporterUtils.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getReportFolder = getReportFolder;
 exports.resetReportFolderCache = resetReportFolderCache;
+const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 let cachedReportFolder = null;
 function getReportFolder(suite) {
@@ -56,6 +57,10 @@ function getReportFolder(suite) {
         }
     }
     cachedReportFolder = path.join(process.cwd(), 'reports', suiteName, `test_${timestamp}`);
+    // Ensure the folder exists
+    if (!fs.existsSync(cachedReportFolder)) {
+        fs.mkdirSync(cachedReportFolder, { recursive: true });
+    }
     console.log(`[ReporterUtils] Calculated report folder: ${cachedReportFolder}`);
     return cachedReportFolder;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flash-ai-team/flash-test-framework",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "A powerful keyword-driven automation framework built on top of Playwright and TypeScript.",
   "keywords": [
     "playwright",
@@ -60,4 +60,4 @@
     "@types/nodemailer": "^7.0.4",
     "typescript": "^5.9.3"
   }
-}
+}