lexxit-automation-framework 2.0.1 → 2.0.2

package/src/core/handlers/AllHandlers.ts

@@ -1,626 +0,0 @@
-import { Page } from "playwright";
-import { ActionResponse, TestCaseConfig } from "../../types/types";
-import { pass, fail } from "../../utils/response";
-import { buildLocatorString } from "../../utils/locatorHelper";
-import { BaseHandler } from "./BaseHandler";
-
-// ─── AssertionHandler ─────────────────────────────────────────────────────────
-
-export class AssertionHandler extends BaseHandler {
-  constructor(tConfig: TestCaseConfig, page: Page) { super(tConfig, page); }
-
-  getActions() {
-    return {
-      verifytext:         this.verifyText.bind(this),
-      verifytextcontains: this.verifyTextContains.bind(this),
-      verifytextnotequal: this.verifyTextNotEqual.bind(this),
-      verifyvalue:        this.verifyValue.bind(this),
-      verifyvisible:      this.verifyVisible.bind(this),
-      verifyhidden:       this.verifyHidden.bind(this),
-      verifyenabled:      this.verifyEnabled.bind(this),
-      verifydisabled:     this.verifyDisabled.bind(this),
-      verifyurl:          this.verifyURL.bind(this),
-      verifypartialurl:   this.verifyPartialURL.bind(this),
-      verifyelementcount: this.verifyElementCount.bind(this),
-      verifyattribute:    this.verifyAttribute.bind(this),
-      verifychecked:      this.verifyChecked.bind(this),
-      verifyunchecked:    this.verifyUnchecked.bind(this),
-      gettext:            this.getText.bind(this),
-      getattribute:       this.getAttribute.bind(this),
-      assertequal:        this.assertEqual.bind(this),
-      assertnotequal:     this.assertNotEqual.bind(this),
-    };
-  }
-
-  async verifyText(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, expected] = args;
-    if (!strategy || !locator || expected === undefined) return fail("verifyText needs: strategy, locator, expectedText");
-    try {
-      const el     = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      const actual = (await el.innerText()).trim();
-      const ok     = actual === expected.trim();
-      const msg    = ok ? `Text matches: "${expected}"` : `Text mismatch. Expected: "${expected}", Got: "${actual}"`;
-      const sc = ok ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return ok ? pass(msg, sc) : fail(msg, undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyText [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async verifyTextContains(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, partial] = args;
-    if (!strategy || !locator || partial === undefined) return fail("verifyTextContains needs: strategy, locator, partialText");
-    try {
-      const el     = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      const actual = (await el.innerText()).trim();
-      const ok     = actual.toLowerCase().includes(partial.toLowerCase());
-      const msg    = ok ? `Text contains: "${partial}"` : `Text "${actual}" does not contain "${partial}"`;
-      const sc = ok ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return ok ? pass(msg, sc) : fail(msg, undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyTextContains [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async verifyTextNotEqual(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, notExpected] = args;
-    if (!strategy || !locator || notExpected === undefined) return fail("verifyTextNotEqual needs: strategy, locator, text");
-    try {
-      const el     = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      const actual = (await el.innerText()).trim();
-      const ok     = actual !== notExpected.trim();
-      const msg    = ok ? `Text is not "${notExpected}" ✓` : `Text should not equal "${notExpected}"`;
-      const sc = ok ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return ok ? pass(msg, sc) : fail(msg, undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyTextNotEqual [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async verifyValue(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, expected] = args;
-    if (!strategy || !locator || expected === undefined) return fail("verifyValue needs: strategy, locator, expected");
-    try {
-      const el     = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "attached", timeout: this.timeout });
-      const actual = await el.inputValue();
-      const ok     = actual === expected;
-      const msg    = ok ? `Value matches: "${expected}"` : `Value mismatch. Expected: "${expected}", Got: "${actual}"`;
-      const sc = ok ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return ok ? pass(msg, sc) : fail(msg, undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyValue [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async verifyVisible(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator] = args;
-    if (!strategy || !locator) return fail("verifyVisible needs: strategy, locator");
-    try {
-      const el = this.page.locator(buildLocatorString(strategy, locator));
-      const visible = await el.isVisible();
-      const msg = visible ? "Element is visible ✓" : "Element is NOT visible";
-      const sc = visible ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return visible ? pass(msg, sc) : fail(msg, undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyVisible [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async verifyHidden(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator] = args;
-    if (!strategy || !locator) return fail("verifyHidden needs: strategy, locator");
-    try {
-      const el = this.page.locator(buildLocatorString(strategy, locator));
-      const hidden = await el.isHidden();
-      const msg = hidden ? "Element is hidden ✓" : "Element is visible (expected hidden)";
-      const sc = hidden ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return hidden ? pass(msg, sc) : fail(msg, undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyHidden [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async verifyEnabled(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator] = args;
-    if (!strategy || !locator) return fail("verifyEnabled needs: strategy, locator");
-    try {
-      const el = this.page.locator(buildLocatorString(strategy, locator));
-      const enabled = await el.isEnabled();
-      const sc = enabled ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return enabled ? pass("Element is enabled ✓", sc) : fail("Element is NOT enabled", undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyEnabled [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async verifyDisabled(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator] = args;
-    if (!strategy || !locator) return fail("verifyDisabled needs: strategy, locator");
-    try {
-      const el = this.page.locator(buildLocatorString(strategy, locator));
-      const disabled = await el.isDisabled();
-      const sc = disabled ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return disabled ? pass("Element is disabled ✓", sc) : fail("Element is NOT disabled", undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyDisabled [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async verifyURL(args: string[]): Promise<ActionResponse> {
-    const [expected] = args;
-    const actual = this.page.url();
-    const ok     = actual === expected;
-    const msg    = ok ? `URL matches ✓` : `URL mismatch. Expected: "${expected}", Got: "${actual}"`;
-    const sc     = ok ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-    return ok ? pass(msg, sc) : fail(msg, undefined, sc);
-  }
-
-  async verifyPartialURL(args: string[]): Promise<ActionResponse> {
-    const [partial] = args;
-    const actual = this.page.url();
-    const ok     = actual.includes(partial);
-    const msg    = ok ? `URL contains: "${partial}" ✓` : `URL "${actual}" does not contain "${partial}"`;
-    const sc     = ok ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-    return ok ? pass(msg, sc) : fail(msg, undefined, sc);
-  }
-
-  async verifyElementCount(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, expectedStr] = args;
-    const expected = parseInt(expectedStr, 10);
-    if (!strategy || !locator || isNaN(expected)) return fail("verifyElementCount needs: strategy, locator, expectedCount");
-    try {
-      const actual = await this.page.locator(buildLocatorString(strategy, locator)).count();
-      const ok     = actual === expected;
-      const msg    = ok ? `Count: ${actual} ✓` : `Count mismatch. Expected: ${expected}, Got: ${actual}`;
-      const sc     = ok ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return ok ? pass(msg, sc) : fail(msg, undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyElementCount [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async verifyAttribute(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, attribute, expected] = args;
-    if (!strategy || !locator || !attribute || expected === undefined) return fail("verifyAttribute needs: strategy, locator, attribute, expectedValue");
-    try {
-      const el     = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "attached", timeout: this.timeout });
-      const actual = await el.getAttribute(attribute);
-      const ok     = actual === expected;
-      const msg    = ok ? `Attribute "${attribute}" = "${expected}" ✓` : `Attr "${attribute}" mismatch. Expected: "${expected}", Got: "${actual}"`;
-      const sc     = ok ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return ok ? pass(msg, sc) : fail(msg, undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyAttribute [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async verifyChecked(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator] = args;
-    if (!strategy || !locator) return fail("verifyChecked needs: strategy, locator");
-    try {
-      const el = this.page.locator(buildLocatorString(strategy, locator));
-      const checked = await el.isChecked();
-      const sc = checked ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return checked ? pass("Checkbox is checked ✓", sc) : fail("Checkbox is NOT checked", undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyChecked [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async verifyUnchecked(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator] = args;
-    if (!strategy || !locator) return fail("verifyUnchecked needs: strategy, locator");
-    try {
-      const el = this.page.locator(buildLocatorString(strategy, locator));
-      const unchecked = !(await el.isChecked());
-      const sc = unchecked ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return unchecked ? pass("Checkbox is unchecked ✓", sc) : fail("Checkbox IS checked (expected unchecked)", undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyUnchecked [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async getText(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, storeKey] = args;
-    if (!strategy || !locator) return fail("getText needs: strategy, locator, [storeKey]");
-    try {
-      const el   = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      const text = (await el.innerText()).trim();
-      if (storeKey) this.testData.set(storeKey, text);
-      return pass(`Text: "${text}"`, await this.shots.onPass(this.page), { text });
-    } catch (error: any) {
-      return fail(`Failed getText [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async getAttribute(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, attribute, storeKey] = args;
-    if (!strategy || !locator || !attribute) return fail("getAttribute needs: strategy, locator, attribute, [storeKey]");
-    try {
-      const el    = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "attached", timeout: this.timeout });
-      const value = await el.getAttribute(attribute);
-      if (storeKey) this.testData.set(storeKey, value);
-      return pass(`Attribute "${attribute}": "${value}"`, await this.shots.onPass(this.page), { value });
-    } catch (error: any) {
-      return fail(`Failed getAttribute [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async assertEqual(args: string[]): Promise<ActionResponse> {
-    const [actual, expected, label] = args;
-    const ok  = actual === expected;
-    const tag = label || "Value";
-    const msg = ok ? `${tag} matches: "${expected}" ✓` : `${tag} mismatch. Expected: "${expected}", Got: "${actual}"`;
-    return ok ? pass(msg) : fail(msg);
-  }
-
-  async assertNotEqual(args: string[]): Promise<ActionResponse> {
-    const [actual, notExpected, label] = args;
-    const ok  = actual !== notExpected;
-    const tag = label || "Value";
-    const msg = ok ? `${tag} is not "${notExpected}" ✓` : `${tag} should not equal "${notExpected}"`;
-    return ok ? pass(msg) : fail(msg);
-  }
-}
-
-// ─── WaitHandler ─────────────────────────────────────────────────────────────
-
-export class WaitHandler extends BaseHandler {
-  constructor(tConfig: TestCaseConfig, page: Page) { super(tConfig, page); }
-
-  getActions() {
-    return {
-      waitforelement:       this.waitForElement.bind(this),
-      waitforelementhidden: this.waitForElementHidden.bind(this),
-      waitforurl:           this.waitForURL.bind(this),
-      waitfortitle:         this.waitForTitle.bind(this),
-      waitforpageload:      this.waitForPageLoad.bind(this),
-      waitfornetworkidle:   this.waitForNetworkIdle.bind(this),
-      waitfortextpresent:   this.waitForTextPresent.bind(this),
-      sleep:                this.sleep.bind(this),
-    };
-  }
-
-  async waitForElement(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, timeoutStr] = args;
-    const timeout = parseInt(timeoutStr || String(this.timeout), 10);
-    if (!strategy || !locator) return fail("waitForElement needs: strategy, locator, [timeoutMs]");
-    try {
-      await this.page.locator(buildLocatorString(strategy, locator)).waitFor({ state: "visible", timeout });
-      return pass(`Element visible: [${strategy}=${locator}]`, await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Element not visible in ${timeout}ms [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async waitForElementHidden(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, timeoutStr] = args;
-    const timeout = parseInt(timeoutStr || String(this.timeout), 10);
-    if (!strategy || !locator) return fail("waitForElementHidden needs: strategy, locator, [timeoutMs]");
-    try {
-      await this.page.locator(buildLocatorString(strategy, locator)).waitFor({ state: "hidden", timeout });
-      return pass(`Element hidden: [${strategy}=${locator}]`, await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Element still visible after ${timeout}ms [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async waitForURL(args: string[]): Promise<ActionResponse> {
-    const [urlPattern, timeoutStr] = args;
-    const timeout = parseInt(timeoutStr || String(this.timeout), 10);
-    if (!urlPattern) return fail("waitForURL needs: urlPattern, [timeoutMs]");
-    try {
-      await this.page.waitForURL(new RegExp(urlPattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")), { timeout });
-      return pass(`URL matches: "${urlPattern}"`, await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`URL not reached in ${timeout}ms: "${urlPattern}"`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async waitForTitle(args: string[]): Promise<ActionResponse> {
-    const [titlePart, timeoutStr] = args;
-    const timeout = parseInt(timeoutStr || String(this.timeout), 10);
-    if (!titlePart) return fail("waitForTitle needs: titlePart, [timeoutMs]");
-    try {
-      await this.page.waitForFunction((t: string) => document.title.includes(t), titlePart, { timeout });
-      return pass(`Title contains: "${titlePart}"`, await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Title not found in ${timeout}ms: "${titlePart}"`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async waitForPageLoad(args: string[]): Promise<ActionResponse> {
-    const timeout = parseInt(args[0] || String(this.timeout), 10);
-    try {
-      await this.page.waitForLoadState("domcontentloaded", { timeout });
-      return pass("Page loaded", await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Page did not load in ${timeout}ms`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async waitForNetworkIdle(args: string[]): Promise<ActionResponse> {
-    const timeout = parseInt(args[0] || String(this.timeout), 10);
-    try {
-      await this.page.waitForLoadState("networkidle", { timeout });
-      return pass("Network is idle", await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Network not idle in ${timeout}ms`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async waitForTextPresent(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, text, timeoutStr] = args;
-    const timeout = parseInt(timeoutStr || String(this.timeout), 10);
-    if (!strategy || !locator || !text) return fail("waitForTextPresent needs: strategy, locator, text, [timeoutMs]");
-    try {
-      await this.page.locator(buildLocatorString(strategy, locator)).filter({ hasText: text }).waitFor({ state: "visible", timeout });
-      return pass(`Text "${text}" is present`, await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Text "${text}" not found in ${timeout}ms`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async sleep(args: string[]): Promise<ActionResponse> {
-    const ms = parseInt(args[0] || "1000", 10);
-    await this.page.waitForTimeout(ms);
-    return pass(`Waited ${ms}ms`);
-  }
-}
-
-// ─── KeyboardHandler ──────────────────────────────────────────────────────────
-
-export class KeyboardHandler extends BaseHandler {
-  constructor(tConfig: TestCaseConfig, page: Page) { super(tConfig, page); }
-
-  getActions() {
-    return {
-      presskey:     this.pressKey.bind(this),
-      presskeyon:   this.pressKeyOn.bind(this),
-      keysendenter: this.sendEnter.bind(this),
-      keysendtab:   this.sendTab.bind(this),
-      keysendesc:   this.sendEsc.bind(this),
-      keycombo:     this.keyCombo.bind(this),
-      selectall:    this.selectAll.bind(this),
-      copytext:     this.copyText.bind(this),
-      pastetext:    this.pasteText.bind(this),
-    };
-  }
-
-  async pressKey(args: string[]): Promise<ActionResponse> {
-    const [key] = args;
-    if (!key) return fail("pressKey needs: keyName (e.g. Enter, Tab, F5, ArrowDown)");
-    try {
-      await this.page.keyboard.press(key);
-      return pass(`Pressed: ${key}`);
-    } catch (error: any) {
-      return fail(`Failed pressKey: ${key}`, error.message);
-    }
-  }
-
-  async pressKeyOn(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, key] = args;
-    if (!strategy || !locator || !key) return fail("pressKeyOn needs: strategy, locator, keyName");
-    try {
-      const el = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      await el.press(key, { timeout: this.timeout });
-      return pass(`Pressed ${key} on [${strategy}=${locator}]`, await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Failed pressKeyOn [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async sendEnter(args: string[]): Promise<ActionResponse> { return this.pressKeyOn([args[0], args[1], "Enter"]); }
-  async sendTab(args: string[]): Promise<ActionResponse>   { return this.pressKeyOn([args[0], args[1], "Tab"]); }
-  async sendEsc(args: string[]): Promise<ActionResponse>   { return this.pressKeyOn([args[0], args[1], "Escape"]); }
-
-  // tSetup.keyCombo('Control+A')
-  async keyCombo(args: string[]): Promise<ActionResponse> {
-    const [combo] = args;
-    if (!combo) return fail("keyCombo needs: combo (e.g. Control+A, Control+Shift+T)");
-    try {
-      await this.page.keyboard.press(combo);
-      return pass(`Key combo: ${combo}`);
-    } catch (error: any) {
-      return fail(`Failed keyCombo: ${combo}`, error.message);
-    }
-  }
-
-  async selectAll(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator] = args;
-    try {
-      if (strategy && locator) {
-        const el = this.page.locator(buildLocatorString(strategy, locator));
-        await el.focus();
-      }
-      await this.page.keyboard.press("Control+A");
-      return pass("Select All (Ctrl+A)");
-    } catch (error: any) {
-      return fail("Failed selectAll", error.message);
-    }
-  }
-
-  async copyText(args: string[]): Promise<ActionResponse> {
-    try {
-      await this.page.keyboard.press("Control+C");
-      return pass("Copied selection");
-    } catch (error: any) {
-      return fail("Failed copyText", error.message);
-    }
-  }
-
-  async pasteText(args: string[]): Promise<ActionResponse> {
-    try {
-      await this.page.keyboard.press("Control+V");
-      return pass("Pasted");
-    } catch (error: any) {
-      return fail("Failed pasteText", error.message);
-    }
-  }
-}
-
-// ─── CheckboxHandler ──────────────────────────────────────────────────────────
-
-export class CheckboxHandler extends BaseHandler {
-  constructor(tConfig: TestCaseConfig, page: Page) { super(tConfig, page); }
-
-  getActions() {
-    return {
-      checkcheckbox:   this.check.bind(this),
-      uncheckcheckbox: this.uncheck.bind(this),
-      togglecheckbox:  this.toggle.bind(this),
-      selectradio:     this.selectRadio.bind(this),
-    };
-  }
-
-  async check(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator] = args;
-    if (!strategy || !locator) return fail("checkCheckbox needs: strategy, locator");
-    try {
-      const el = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      await el.check({ timeout: this.timeout });
-      return pass(`Checked [${strategy}=${locator}]`, await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Failed check [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async uncheck(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator] = args;
-    if (!strategy || !locator) return fail("uncheckCheckbox needs: strategy, locator");
-    try {
-      const el = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      await el.uncheck({ timeout: this.timeout });
-      return pass(`Unchecked [${strategy}=${locator}]`, await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Failed uncheck [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async toggle(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator] = args;
-    if (!strategy || !locator) return fail("toggleCheckbox needs: strategy, locator");
-    try {
-      const el      = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      const checked = await el.isChecked();
-      checked ? await el.uncheck() : await el.check();
-      return pass(`Toggled (now ${!checked}) [${strategy}=${locator}]`, await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Failed toggle [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  async selectRadio(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator] = args;
-    if (!strategy || !locator) return fail("selectRadio needs: strategy, locator");
-    try {
-      const el = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      await el.click({ timeout: this.timeout });
-      return pass(`Radio selected [${strategy}=${locator}]`, await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Failed selectRadio [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-}
-
-// ─── TableHandler ─────────────────────────────────────────────────────────────
-
-export class TableHandler extends BaseHandler {
-  constructor(tConfig: TestCaseConfig, page: Page) { super(tConfig, page); }
-
-  getActions() {
-    return {
-      gettablerowcount:    this.getTableRowCount.bind(this),
-      gettablecellvalue:   this.getTableCellValue.bind(this),
-      verifytablecell:     this.verifyTableCell.bind(this),
-      clicktablerow:       this.clickTableRow.bind(this),
-      gettablecolumnvalues: this.getTableColumnValues.bind(this),
-    };
-  }
-
-  // tSetup.getTableRowCount('xpath', '//table/tbody/tr', 'storeKey')
-  async getTableRowCount(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, storeKey] = args;
-    if (!strategy || !locator) return fail("getTableRowCount needs: strategy, locator, [storeKey]");
-    try {
-      const count = await this.page.locator(buildLocatorString(strategy, locator)).count();
-      if (storeKey) this.testData.set(storeKey, count);
-      return pass(`Row count: ${count}`, await this.shots.onPass(this.page), { count });
-    } catch (error: any) {
-      return fail(`Failed getTableRowCount [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  // tSetup.getTableCellValue('xpath', '//table/tbody/tr[2]/td[3]', 'storeKey')
-  async getTableCellValue(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, storeKey] = args;
-    if (!strategy || !locator) return fail("getTableCellValue needs: strategy, locator, [storeKey]");
-    try {
-      const el   = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      const text = (await el.innerText()).trim();
-      if (storeKey) this.testData.set(storeKey, text);
-      return pass(`Cell value: "${text}"`, await this.shots.onPass(this.page), { text });
-    } catch (error: any) {
-      return fail(`Failed getTableCellValue [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  // tSetup.verifyTableCell('xpath', '//table/tbody/tr[1]/td[2]', 'Expected Value')
-  async verifyTableCell(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, expected] = args;
-    if (!strategy || !locator || !expected) return fail("verifyTableCell needs: strategy, locator, expectedValue");
-    try {
-      const el     = this.page.locator(buildLocatorString(strategy, locator));
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      const actual = (await el.innerText()).trim();
-      const ok     = actual === expected.trim();
-      const msg    = ok ? `Cell matches: "${expected}" ✓` : `Cell mismatch. Expected: "${expected}", Got: "${actual}"`;
-      const sc     = ok ? await this.shots.onPass(this.page) : await this.shots.onFail(this.page);
-      return ok ? pass(msg, sc) : fail(msg, undefined, sc);
-    } catch (error: any) {
-      return fail(`Failed verifyTableCell [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  // tSetup.clickTableRow('xpath', '//table/tbody/tr', '3')
-  async clickTableRow(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, rowStr] = args;
-    const row = parseInt(rowStr || "1", 10) - 1;
-    if (!strategy || !locator) return fail("clickTableRow needs: strategy, locator, rowNumber");
-    try {
-      const el = this.page.locator(buildLocatorString(strategy, locator)).nth(row);
-      await el.waitFor({ state: "visible", timeout: this.timeout });
-      await el.click({ timeout: this.timeout });
-      return pass(`Clicked row ${row + 1}`, await this.shots.onPass(this.page));
-    } catch (error: any) {
-      return fail(`Failed clickTableRow row=${row + 1}`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-
-  // tSetup.getTableColumnValues('xpath', '//table/tbody/tr/td[2]', 'storeKey')
-  async getTableColumnValues(args: string[]): Promise<ActionResponse> {
-    const [strategy, locator, storeKey] = args;
-    if (!strategy || !locator) return fail("getTableColumnValues needs: strategy, locator, [storeKey]");
-    try {
-      const values = await this.page.locator(buildLocatorString(strategy, locator)).allInnerTexts();
-      const trimmed = values.map(v => v.trim());
-      if (storeKey) this.testData.set(storeKey, trimmed);
-      return pass(`Column values: [${trimmed.join(", ")}]`, await this.shots.onPass(this.page), { values: trimmed });
-    } catch (error: any) {
-      return fail(`Failed getTableColumnValues [${strategy}=${locator}]`, error.message, await this.shots.onFail(this.page));
-    }
-  }
-}

package/src/core/handlers/BaseHandler.ts

@@ -1,41 +0,0 @@
-import { Page } from "playwright";
-import { TestCaseConfig, IActionHandler, ActionHandler } from "../../types/types";
-import { ScreenshotManager } from "../ScreenshotManager";
-import { Logger } from "../../utils/logger";
-import { highlightElement, removeHighlight } from "../../utils/elementHighlight";
-
-export abstract class BaseHandler implements IActionHandler {
-  protected page: Page;
-  protected testData: TestCaseConfig["testData"];
-  protected timeout: number;
-  readonly shots: ScreenshotManager;
-  protected log: Logger;
-
-  constructor(tConfig: TestCaseConfig, page: Page) {
-    this.page = page;
-    this.testData = tConfig.testData;
-    this.timeout = tConfig.timeout ?? 30000;
-    this.shots = new ScreenshotManager(tConfig.screenshot_mode);
-    this.log = Logger.create(this.constructor.name, tConfig.executionId);
-  }
-
-  setPage(page: Page): void { this.page = page; }
-
-  // ── Visual highlight helpers ─────────────────────────────────────────────────
-  // Call highlight() BEFORE the interaction, remove() AFTER (pass or fail).
-  // All errors are suppressed — highlighting is purely cosmetic.
-
-  protected async highlight(
-    locatorStr: string,
-    type: "input" | "click" | "verify" | "select" | "checkbox" = "input",
-    label: string = "",
-  ): Promise<void> {
-    await highlightElement(this.page, locatorStr, type, label);
-  }
-
-  protected async unhighlight(): Promise<void> {
-    await removeHighlight(this.page);
-  }
-
-  abstract getActions(): Record<string, ActionHandler>;
-}