lexxit-automation-framework 3.0.2 → 3.0.4

package/src/executor/stepExecutor.ts

@@ -1,289 +0,0 @@
-// import { StepRequest, StepResult } from '../types/types';
-// import { FUNCTION_MAP } from './functionMap';
-// import { Mapping } from './mapping';
-// import { TextHandler } from '../actions/textHandler';
-// import { ClickHandler } from '../actions/clickHandler';
-// import { CheckboxHandler } from '../actions/checkboxHandler';
-// import { RadiobuttonHandler } from '../actions/radiobuttonHandler';
-// import { DropdownHandler } from '../actions/dropdownHandler';
-// import { BrowserManager } from '../actions/browserManager';
-
-// export class StepExecutor {
-//   private browserManager: BrowserManager;
-
-//   constructor(browserManager: BrowserManager) {
-//     this.browserManager = browserManager;
-//   }
-
-//   private getHandlerInstance(handlerName: string): any {
-//     if (handlerName === 'browserManager') {
-//       return this.browserManager;
-//     }
-
-//     const page = this.browserManager.getPage();
-//     const handlerMap: Record<string, any> = {
-//       textHandler: new TextHandler(page),
-//       clickHandler: new ClickHandler(page),
-//       checkboxHandler: new CheckboxHandler(page),
-//       radiobuttonHandler: new RadiobuttonHandler(page),
-//       dropdownHandler: new DropdownHandler(page)
-//     };
-
-//     return handlerMap[handlerName];
-//   }
-
-//   private buildSkippedResult(step: StepRequest): StepResult {
-//     return {
-//       uid: null,
-//       obj_uid: step.obj_uid ?? null,
-//       page_uid: step.page_uid ?? null,
-//       step_name: step.step_name,
-//       status: 'skip',
-//       expected_result: 'Step skipped',
-//       comments: 'Skipped due to previous step failure',
-//       duration: '0 seconds',
-//       start_time: new Date().toISOString().replace('T', ' ').split('.')[0]
-//     };
-//   }
-
-//   private buildErrorResult(step: StepRequest, message: string): StepResult {
-//     return {
-//       uid: null,
-//       obj_uid: step.obj_uid ?? null,
-//       page_uid: step.page_uid ?? null,
-//       step_name: step.step_name,
-//       status: 'fail',
-//       expected_result: 'Step executed successfully',
-//       comments: message,
-//       duration: '0 seconds',
-//       start_time: new Date().toISOString().replace('T', ' ').split('.')[0]
-//     };
-//   }
-
-//   async executeStep(
-//     step: StepRequest,
-//     skip: boolean = false,
-//     context: { browser?: string; headless?: boolean; videoEnabled?: boolean; testScriptUid?: string } = {}
-//   ): Promise<StepResult> {
-//     if (skip) {
-//       return this.buildSkippedResult(step);
-//     }
-
-//     try {
-//       const parsed = Mapping.parse(step.step_script);
-//       const handlerInfo = FUNCTION_MAP[parsed.functionName];
-
-//       if (!handlerInfo) {
-//         return this.buildErrorResult(step, `No handler mapped for function: ${parsed.functionName}`);
-//       }
-
-//       const handlerInstance = this.getHandlerInstance(handlerInfo.handler);
-
-//       if (!handlerInstance) {
-//         return this.buildErrorResult(step, `Handler instance not found: ${handlerInfo.handler}`);
-//       }
-
-//       const method = handlerInstance[handlerInfo.method];
-
-//       if (typeof method !== 'function') {
-//         return this.buildErrorResult(step, `Method '${handlerInfo.method}' not found on handler '${handlerInfo.handler}'`);
-//       }
-
-//       const callArgs = this.buildCallArgs(handlerInfo.handler, parsed, step, context);
-//       const result: StepResult = await method.apply(handlerInstance, callArgs);
-
-//       result.step_name = step.step_name;
-//       result.obj_uid = step.obj_uid ?? null;
-//       result.page_uid = step.page_uid ?? null;
-
-//       return result;
-//     } catch (error: any) {
-//       return this.buildErrorResult(step, `Unexpected error executing step: ${error.message || error}`);
-//     }
-//   }
-
-//   private buildCallArgs(
-//     handlerName: string,
-//     parsed: { functionName: string; args: string[] },
-//     step: StepRequest,
-//     context: { browser?: string; headless?: boolean; videoEnabled?: boolean; testScriptUid?: string }
-//   ): any[] {
-//     if (handlerName === 'browserManager') {
-//       if (parsed.functionName === 'openBrowser') {
-//         return [context.browser, context.headless, context.videoEnabled];
-//       }
-//       if (parsed.functionName === 'closeBrowser') {
-//         return [context.testScriptUid];
-//       }
-//       return [...parsed.args, step.step_name];
-//     }
-
-//     const label = step.label || '';
-//     const locators = step.locators || [];
-//     return [label, locators, ...parsed.args.slice(2), step.step_name];
-//   }
-// }
-
-
-import { StepRequest, StepResult } from '../types/types';
-import { FUNCTION_MAP } from './functionMap';
-import { Mapping } from './mapping';
-import { TextHandler } from '../actions/textHandler';
-import { ClickHandler } from '../actions/clickHandler';
-import { CheckboxHandler } from '../actions/checkboxHandler';
-import { RadiobuttonHandler } from '../actions/radiobuttonHandler';
-import { DropdownHandler } from '../actions/dropdownHandler';
-import { BrowserManager } from '../actions/browserManager';
-import { CustomCodeHandler } from '../actions/customcodehandler';
-import { TestDataStore } from '../store/testDataStore';
-import { ScreenshotMode } from '../types/types';
-import { DEFAULT_SCREENSHOT_MODE } from '../config';
-
-type StepContext = {
-  browser?: string;
-  headless?: boolean;
-  videoEnabled?: boolean;
-  testScriptUid?: string;
-  screenshotMode?: ScreenshotMode;
-};
-
-export class StepExecutor {
-  private browserManager: BrowserManager;
-  private testData: TestDataStore;
-
-  constructor(browserManager: BrowserManager, testData?: TestDataStore) {
-    this.browserManager = browserManager;
-    this.testData = testData ?? new TestDataStore();
-  }
-
-  private getHandlerInstance(handlerName: string, screenshotMode: ScreenshotMode): any {
-    if (handlerName === 'browserManager') {
-      return this.browserManager;
-    }
-
-    const page = this.browserManager.getPage();
-    const handlerMap: Record<string, any> = {
-      textHandler:        new TextHandler(page),
-      clickHandler:       new ClickHandler(page, screenshotMode),
-      checkboxHandler:    new CheckboxHandler(page),
-      radiobuttonHandler: new RadiobuttonHandler(page),
-      dropdownHandler:    new DropdownHandler(page),
-      customCodeHandler:  new CustomCodeHandler(page, this.testData)
-    };
-
-    return handlerMap[handlerName];
-  }
-
-  private buildSkippedResult(step: StepRequest): StepResult {
-    return {
-      uid: null,
-      obj_uid: step.obj_uid ?? null,
-      page_uid: step.page_uid ?? null,
-      step_name: step.step_name,
-      step_script: step.step_script,
-      status: 'SKIP',
-      expected_result: 'Step skipped',
-      comments: 'Skipped due to previous step failure',
-      duration: 0,
-      start_time: new Date().toISOString().replace('T', ' ').split('.')[0]
-    };
-  }
-
-  private buildErrorResult(step: StepRequest, message: string): StepResult {
-    return {
-      uid: null,
-      obj_uid: step.obj_uid ?? null,
-      page_uid: step.page_uid ?? null,
-      step_name: step.step_name,
-      step_script: step.step_script,
-      status: 'FAIL',
-      expected_result: 'Step executed successfully',
-      comments: message,
-      duration: 0,
-      start_time: new Date().toISOString().replace('T', ' ').split('.')[0]
-    };
-  }
-
-  async executeStep(
-    step: StepRequest,
-    skip: boolean = false,
-    context: StepContext = {}
-  ): Promise<StepResult> {
-    if (skip) {
-      return this.buildSkippedResult(step);
-    }
-
-    const screenshotMode: ScreenshotMode = context.screenshotMode ?? DEFAULT_SCREENSHOT_MODE;
-
-    try {
-      const parsed = Mapping.parse(step.step_script);
-      const handlerInfo = FUNCTION_MAP[parsed.functionName];
-
-      if (!handlerInfo) {
-        return this.buildErrorResult(step, `No handler mapped for function: ${parsed.functionName}`);
-      }
-
-      const handlerInstance = this.getHandlerInstance(handlerInfo.handler, screenshotMode);
-
-      if (!handlerInstance) {
-        return this.buildErrorResult(step, `Handler instance not found: ${handlerInfo.handler}`);
-      }
-
-      const method = handlerInstance[handlerInfo.method];
-
-      if (typeof method !== 'function') {
-        return this.buildErrorResult(step, `Method '${handlerInfo.method}' not found on handler '${handlerInfo.handler}'`);
-      }
-
-      const callArgs = this.buildCallArgs(handlerInfo.handler, parsed, step, context);
-      const result: StepResult = await method.apply(handlerInstance, callArgs);
-      const screenshot = await this.browserManager.captureScreenshot(
-      context.screenshotMode || 'never',
-      result.status === 'FAIL'
-    );
-    result.screenshot = screenshot;
-
-      result.step_name = step.step_name;
-      result.obj_uid   = step.obj_uid ?? null;
-      result.page_uid  = step.page_uid ?? null;
-
-      return result;
-    } catch (error: any) {
-      return this.buildErrorResult(step, `Unexpected error executing step: ${error.message || error}`);
-    }
-  }
-
-  private buildCallArgs(
-    handlerName: string,
-    parsed: { functionName: string; args: string[] },
-    step: StepRequest,
-    context: StepContext
-  ): any[] {
-    if (handlerName === 'browserManager') {
-      if (parsed.functionName === 'openBrowser') {
-        return [context.browser, context.headless, context.videoEnabled];
-      }
-      if (parsed.functionName === 'closeBrowser') {
-        return [context.testScriptUid];
-      }
-      return [...parsed.args, step.step_name];
-    }
-
-    // customCodeHandler: runCustomCode(codeStr, returnVariable?, xpath?)
-    // args come straight from the step_script — no label/locators prepended
-    // if (handlerName === 'customCodeHandler') {
-    //   return [...parsed.args, step.step_name];
-    // }
-    if (handlerName === 'customCodeHandler') {
-      const [codeStr, returnVariable, xpath] = parsed.args;
-      return [codeStr, returnVariable, xpath, step.step_name];
-    }
-
-    const label    = step.label    || '';
-    const locators = step.locators || [];
-    const resolvedArgs = parsed.args.slice(2).map(arg =>
-      typeof arg === 'string' ? this.testData.resolve(arg) : arg
-    );
-    return [label, locators, ...resolvedArgs, step.step_name];
-  }
-}

package/src/runner/testRunner.ts

@@ -1,78 +0,0 @@
-import { TestSetRequest, TestSetResult, TestScriptResult } from '../types/types';
-import { ScriptExecutor } from '../executor/scriptExecutor';
-import { executionStore } from '../store/executionStore';
-import { sseManager } from '../sse/sseManager';
-
-const MAX_PARALLEL = 10;
-
-export async function testRunner(payload: TestSetRequest, executionId: string): Promise<TestSetResult> {
-  const startMs = Date.now();
-
-  const execMode             = payload.exec_mode?.mode || 'fast';
-  const delayMs              = execMode === 'fast' ? 0 : (payload.exec_mode?.delay_ms || (execMode === 'medium' ? 1000 : 3000));
-  const effectiveVideoEnabled = execMode === 'fast' ? false : payload.video_enabled;
-
-  // ─── Emit execution start ──────────────────────────────────────────────────
-  sseManager.emit(executionId, 'execution_start', {
-    test_set_name: payload.test_set_name,
-    total_scripts: payload.scripts.length,
-    parallel:      payload.parallel,
-    exec_mode:     payload.exec_mode
-  });
-
-  const scriptExecutor = new ScriptExecutor();
-  let results: TestScriptResult[] = [];
-
-  if (payload.parallel) {
-    results = await runInBatches(payload, scriptExecutor, MAX_PARALLEL, executionId, effectiveVideoEnabled, delayMs);
-  } else {
-    for (const script of payload.scripts) {
-      const result = await scriptExecutor.executeScript(script, effectiveVideoEnabled, executionId, delayMs);
-      results.push(result);
-    }
-  }
-
-  const passed = results.filter((r) => r.status === 'PASS').length;
-  const failed = results.filter((r) => r.status === 'FAIL').length;
-  const overallStatus = failed > 0 ? 'FAIL' : 'PASS';
-
-  const finalResult: TestSetResult = {
-    executionId,
-    status:        overallStatus,
-    total_scripts: results.length,
-    passed,
-    failed,
-    duration:      Date.now() - startMs,
-    results
-  };
-
-  executionStore.setFinalResult(executionId, finalResult);
-  executionStore.completeExecution(executionId, overallStatus);
-
-  // ─── Emit execution complete ───────────────────────────────────────────────
-  sseManager.emit(executionId, 'execution_complete', finalResult);
-
-  return finalResult;
-}
-
-async function runInBatches(
-  payload: TestSetRequest,
-  scriptExecutor: ScriptExecutor,
-  maxParallel: number,
-  executionId: string,
-  videoEnabled: boolean,
-  delayMs: number
-): Promise<TestScriptResult[]> {
-  const results: TestScriptResult[] = [];
-  const scripts = payload.scripts;
-
-  for (let i = 0; i < scripts.length; i += maxParallel) {
-    const batch = scripts.slice(i, i + maxParallel);
-    const batchResults = await Promise.all(
-      batch.map((script) => scriptExecutor.executeScript(script, videoEnabled, executionId, delayMs))
-    );
-    results.push(...batchResults);
-  }
-
-  return results;
-}

package/src/sse/sseManager.ts

@@ -1,130 +0,0 @@
-import { Response } from 'express';
-import { SSEEvent, SSEEventType } from '../types/types';
-import { Logger } from '../utils/logger';
-
-const log = Logger.create('SSEManager');
-
-export class SSEManager {
-  private clients: Map<string, Set<Response>> = new Map();
-  private eventBuffer: Map<string, SSEEvent[]> = new Map();
-  private readonly MAX_BUFFER = 500;
-  private readonly BUFFER_TTL = 2 * 60 * 60 * 1000;
-
-  // ─── Add Client ────────────────────────────────────────────────────────────
-
-  addClient(executionId: string, res: Response): void {
-    res.setHeader('Content-Type',      'text/event-stream');
-    res.setHeader('Cache-Control',     'no-cache');
-    res.setHeader('Connection',        'keep-alive');
-    res.setHeader('X-Accel-Buffering', 'no');
-    res.flushHeaders();
-
-    if (!this.clients.has(executionId)) {
-      this.clients.set(executionId, new Set());
-    }
-    this.clients.get(executionId)!.add(res);
-
-    log.info(`SSE client connected: ${executionId}`);
-
-    const pastEvents = this.eventBuffer.get(executionId) ?? [];
-    if (pastEvents.length > 0) {
-      log.info(`Replaying ${pastEvents.length} past events to late client: ${executionId}`);
-      pastEvents.forEach((ev) => this.sendToOne(res, ev));
-    } else {
-      this.sendToOne(res, {
-        type:        'log',
-        executionId,
-        timestamp:   new Date().toISOString(),
-        data:        { message: 'Connected to execution stream' }
-      });
-    }
-
-    const hb = setInterval(() => {
-      if (!res.writableEnded) res.write(': heartbeat\n\n');
-      else clearInterval(hb);
-    }, 20000);
-
-    res.on('close', () => {
-      clearInterval(hb);
-      this.removeClient(executionId, res);
-    });
-  }
-
-  // ─── Emit ──────────────────────────────────────────────────────────────────
-
-  emit(executionId: string, type: SSEEventType, data: any): void {
-    const event: SSEEvent = {
-      type,
-      executionId,
-      timestamp: new Date().toISOString(),
-      data
-    };
-
-    if (!this.eventBuffer.has(executionId)) {
-      this.eventBuffer.set(executionId, []);
-    }
-    const buf = this.eventBuffer.get(executionId)!;
-    if (buf.length < this.MAX_BUFFER) {
-      buf.push(event);
-    }
-
-    const clients = this.clients.get(executionId);
-    if (clients && clients.size > 0) {
-      clients.forEach((res) => this.sendToOne(res, event));
-    }
-
-    if (type === 'execution_complete') {
-      setTimeout(() => this.clients.delete(executionId), 5000);
-      setTimeout(() => this.eventBuffer.delete(executionId), this.BUFFER_TTL);
-    }
-  }
-
-  // ─── Broadcast ─────────────────────────────────────────────────────────────
-
-  broadcast(type: SSEEventType, data: any): void {
-    const event: SSEEvent = {
-      type,
-      executionId: 'global',
-      timestamp:   new Date().toISOString(),
-      data
-    };
-    this.clients.forEach((clients) => {
-      clients.forEach((res) => this.sendToOne(res, event));
-    });
-  }
-
-  // ─── Get Buffer ────────────────────────────────────────────────────────────
-
-  getBuffer(executionId: string): SSEEvent[] {
-    return this.eventBuffer.get(executionId) ?? [];
-  }
-
-  // ─── Has Clients ───────────────────────────────────────────────────────────
-
-  hasClients(executionId: string): boolean {
-    return (this.clients.get(executionId)?.size ?? 0) > 0;
-  }
-
-  // ─── Private: Send To One ──────────────────────────────────────────────────
-
-  private sendToOne(res: Response, event: SSEEvent): void {
-    try {
-      if (!res.writableEnded) {
-        res.write(`data: ${JSON.stringify(event)}\n\n`);
-      }
-    } catch {
-      /* client gone */
-    }
-  }
-
-  // ─── Private: Remove Client ────────────────────────────────────────────────
-
-  private removeClient(executionId: string, res: Response): void {
-    this.clients.get(executionId)?.delete(res);
-    if (this.clients.get(executionId)?.size === 0) {
-      this.clients.delete(executionId);
-    }
-  }
-}
-
-export const sseManager = new SSEManager();

package/src/store/executionStore.ts

@@ -1,152 +0,0 @@
-import { ExecutionState, LiveScriptState, LiveStepState, ExecutionOverallStatus, StepLiveStatus, TestSetResult } from '../types/types';
-
-class ExecutionStore {
-  private executions: Map<string, ExecutionState> = new Map();
-
-  // ─── Create ────────────────────────────────────────────────────────────────
-
-  createExecution(executionId: string, testSetName: string): void {
-    const execution: ExecutionState = {
-      execution_id:  executionId,
-      test_set_name: testSetName,
-      status:        'RUNNING',
-      start_time:    new Date().toISOString(),
-      end_time:      null,
-      scripts:       [],
-      final_result:  null
-    };
-
-    this.executions.set(executionId, execution);
-  }
-
-  // ─── Register Script ───────────────────────────────────────────────────────
-
-  registerScript(executionId: string, testScriptUid: string, testCaseName: string, stepNames: string[]): void {
-    const execution = this.executions.get(executionId);
-    if (!execution) return;
-
-    const scriptState: LiveScriptState = {
-      test_script_uid: testScriptUid,
-      test_case_name:  testCaseName,
-      status:          'RUNNING',
-      video_path:      null,
-      steps:           stepNames.map((name) => ({
-        step_name:       name,
-        status:          'PENDING' as StepLiveStatus,
-        expected_result: null,
-        comments:        null,
-        duration:        null
-      }))
-    };
-
-    execution.scripts.push(scriptState);
-  }
-
-  // ─── Set Video Path ────────────────────────────────────────────────────────
-
-  setVideoPath(executionId: string, testScriptUid: string, videoPath: string): void {
-    const execution = this.executions.get(executionId);
-    if (!execution) return;
-
-    const script = execution.scripts.find((s) => s.test_script_uid === testScriptUid);
-    if (!script) return;
-
-    script.video_path = videoPath;
-  }
-
-  // ─── Update Step ───────────────────────────────────────────────────────────
-
-  updateStep(
-    executionId: string,
-    testScriptUid: string,
-    stepIndex: number,
-    status: StepLiveStatus,
-    expected_result: string | null = null,
-    comments: string | null = null,
-    duration: number | null = null
-  ): void {
-    const execution = this.executions.get(executionId);
-    if (!execution) return;
-
-    const script = execution.scripts.find((s) => s.test_script_uid === testScriptUid);
-    if (!script || !script.steps[stepIndex]) return;
-
-    script.steps[stepIndex].status = status;
-    if (expected_result !== null) script.steps[stepIndex].expected_result = expected_result;
-    if (comments !== null)        script.steps[stepIndex].comments        = comments;
-    if (duration !== null)        script.steps[stepIndex].duration        = duration;
-  }
-
-  // ─── Update Script Status ──────────────────────────────────────────────────
-
-  updateScriptStatus(executionId: string, testScriptUid: string, status: ExecutionOverallStatus): void {
-    const execution = this.executions.get(executionId);
-    if (!execution) return;
-
-    const script = execution.scripts.find((s) => s.test_script_uid === testScriptUid);
-    if (!script) return;
-
-    script.status = status;
-  }
-
-  // ─── Complete Execution ────────────────────────────────────────────────────
-
-  completeExecution(executionId: string, status: ExecutionOverallStatus): void {
-    const execution = this.executions.get(executionId);
-    if (!execution) return;
-
-    execution.status   = status;
-    execution.end_time = new Date().toISOString();
-  }
-
-  // ─── Get Execution ─────────────────────────────────────────────────────────
-
-  getExecution(executionId: string): ExecutionState | undefined {
-    return this.executions.get(executionId);
-  }
-
-  // ─── Set Final Result ──────────────────────────────────────────────────────
-
-  setFinalResult(executionId: string, result: TestSetResult): void {
-    const execution = this.executions.get(executionId);
-    if (!execution) return;
-
-    execution.final_result = result;
-  }
-
-  // ─── List Executions (latest first) ───────────────────────────────────────
-
-  listExecutions(): { execution_id: string; test_set_name: string; status: ExecutionOverallStatus; start_time: string }[] {
-    return Array.from(this.executions.values())
-      .map((e) => ({
-        execution_id:  e.execution_id,
-        test_set_name: e.test_set_name,
-        status:        e.status,
-        start_time:    e.start_time
-      }))
-      .reverse();
-  }
-
-  // ─── Queue Stats ───────────────────────────────────────────────────────────
-
-  getQueueStats(): { total: number; queued: number; running: number; done: number; failed: number; cancelled: number; maxConcurrent: number; jobs: { execution_id: string; test_set_name: string; status: string }[] } {
-    const all = Array.from(this.executions.values());
-
-    return {
-      total:          all.length,
-      queued:         0,
-      running:        all.filter((e) => e.status === 'RUNNING').length,
-      done:           all.filter((e) => e.status === 'PASS').length,
-      failed:         all.filter((e) => e.status === 'FAIL').length,
-      cancelled:      0,
-      maxConcurrent:  10,
-      jobs:           all.map((e) => ({
-        execution_id:  e.execution_id,
-        test_set_name: e.test_set_name,
-        status:        e.status
-      }))
-    };
-  }
-}
-
-export const executionStore = new ExecutionStore();

package/src/store/testDataStore.ts

@@ -1,46 +0,0 @@
-/**
- * TestDataStore
- * -------------
- * A simple key-value store shared across all steps of a single script execution.
- * runCustomCode writes values into it; any subsequent step arg that contains
- * testData["key"] has the token replaced with the stored value at call time.
- */
-export class TestDataStore {
-  private store = new Map<string, string>();
-
-  set(key: string, value: string): void {
-    this.store.set(key, String(value));
-  }
-
-  get(key: string): string | undefined {
-    return this.store.get(key);
-  }
-
-  has(key: string): boolean {
-    return this.store.has(key);
-  }
-
-  /**
-   * Resolves a step arg string that may contain testData["key"] tokens.
-   * e.g. 'testData["RN_randomEmail"]'  →  'abc@xyz.com'
-   * Plain strings pass through unchanged.
-   */
-  resolve(value: string): string {
-    return value.replace(/testData\["([^"]+)"\]/g, (_, key) => {
-      const resolved = this.store.get(key);
-      if (resolved === undefined) {
-        console.warn(`[TestDataStore] Key "${key}" not found in store`);
-        return value; // return original token so the error is visible
-      }
-      return resolved;
-    });
-  }
-
-  getAll(): Record<string, string> {
-    return Object.fromEntries(this.store);
-  }
-
-  clear(): void {
-    this.store.clear();
-  }
-}