agentic-qe 3.3.3 → 3.3.5

package/v3/dist/domains/test-execution/services/e2e-runner.d.ts

@@ -1,400 +1,26 @@
 /**
- * Agentic QE v3 - E2E Test Runner Service
+ * Agentic QE v3 - E2E Test Runner Service (Facade)
  *
- * Executes E2E test cases using browser automation clients.
- * Supports both the Vibium browser automation client and the agent-browser CLI tool.
- * Provides step-by-step execution with retry logic, timeout handling,
- * and comprehensive result aggregation.
+ * This file is a backward-compatible facade that re-exports from the
+ * modular E2E runner components located in ./e2e/
  *
- * Browser Client Support:
- * - IBrowserClient: Common interface for all browser tools
- * - IAgentBrowserClient: Extended interface for agent-browser specific features
- * - VibiumClient: Legacy Vibium integration (backward compatible)
+ * The E2E runner has been split into modular components:
+ * - e2e/types.ts: Configuration, interfaces, errors (~170 LOC)
+ * - e2e/browser-orchestrator.ts: Browser client management (~330 LOC)
+ * - e2e/step-executors.ts: Individual step execution (~850 LOC)
+ * - e2e/step-retry-handler.ts: Retry logic and timeout handling (~160 LOC)
+ * - e2e/result-collector.ts: Result aggregation (~150 LOC)
+ * - e2e/e2e-coordinator.ts: Main service orchestration (~340 LOC)
  *
- * Agent-browser provides enhanced E2E testing capabilities:
- * - Snapshot-based element refs (@e1, @e2) for reliable element selection
- * - Session management for state persistence
- * - Network interception and API mocking
- * - Device emulation for responsive testing
+ * All original public exports are preserved for backward compatibility.
  *
  * @module test-execution/services/e2e-runner
  */
-import type { VibiumClient } from '../../../integrations/vibium';
-import { type IBrowserClient } from '../../../integrations/browser';
-import { type E2ETestCase, type E2ETestResult, type E2ETestSuite, type E2ETestSuiteResult } from '../types';
-/**
- * Browser client type for configuration
- */
-export type BrowserClientType = 'vibium' | 'agent-browser' | 'auto';
-/**
- * E2E Test Runner configuration
- */
-export interface E2ERunnerConfig {
-    /** Default step timeout in milliseconds */
-    defaultStepTimeout: number;
-    /** Default retry count for steps */
-    defaultRetries: number;
-    /** Delay between retries in milliseconds */
-    retryDelay: number;
-    /** Capture screenshot on failure */
-    screenshotOnFailure: boolean;
-    /** Stop on first failure */
-    stopOnFirstFailure: boolean;
-    /** Default polling interval for wait conditions */
-    pollingInterval: number;
-    /** Maximum parallel workers for suite execution */
-    maxParallelWorkers: number;
-    /** Enable verbose logging */
-    verbose: boolean;
-    /**
-     * Prefer agent-browser over Vibium for E2E testing
-     * Agent-browser provides enhanced features: refs (@e1, @e2), sessions, mocking
-     * @default true
-     */
-    preferAgentBrowser: boolean;
-    /**
-     * Browser client type preference
-     * - 'vibium': Use Vibium (MCP-based)
-     * - 'agent-browser': Use agent-browser (CLI-based with refs)
-     * - 'auto': Auto-select based on availability and use case
-     * @default 'auto'
-     */
-    browserClientType: BrowserClientType;
-    /**
-     * Pre-configured browser client instance
-     * If provided, this client will be used instead of creating a new one
-     * Useful for sharing browser instances across test suites
-     */
-    browserClient?: IBrowserClient;
-}
-/**
- * Default E2E runner configuration
- */
-export declare const DEFAULT_E2E_RUNNER_CONFIG: E2ERunnerConfig;
-/**
- * Test suite execution strategy
- */
-export type ExecutionStrategy = 'sequential' | 'parallel';
-/**
- * E2E Runner error class
- */
-export declare class E2ERunnerError extends Error {
-    readonly code: string;
-    readonly stepId?: string | undefined;
-    readonly cause?: Error | undefined;
-    constructor(message: string, code: string, stepId?: string | undefined, cause?: Error | undefined);
-}
-/**
- * Step timeout error
- */
-export declare class StepTimeoutError extends E2ERunnerError {
-    constructor(stepId: string, timeout: number, cause?: Error);
-}
-/**
- * Assertion failure error
- */
-export declare class AssertionError extends E2ERunnerError {
-    readonly expected: unknown;
-    readonly actual: unknown;
-    constructor(message: string, stepId: string, expected: unknown, actual: unknown, cause?: Error);
-}
-/**
- * E2E Test Runner Service Interface
- */
-export interface IE2ETestRunnerService {
-    /**
-     * Execute a single E2E test case
-     * @param testCase - Test case to execute
-     * @returns Promise resolving to test result
-     */
-    runTestCase(testCase: E2ETestCase): Promise<E2ETestResult>;
-    /**
-     * Execute an E2E test suite
-     * @param suite - Test suite to execute
-     * @param strategy - Execution strategy (sequential or parallel)
-     * @returns Promise resolving to suite result
-     */
-    runTestSuite(suite: E2ETestSuite, strategy?: ExecutionStrategy): Promise<E2ETestSuiteResult>;
-}
-/**
- * E2E Test Runner Service
- *
- * Executes E2E test cases using browser automation clients.
- * Supports both the Vibium browser automation client and the agent-browser CLI tool.
- * Provides step-by-step execution with retry logic, timeout handling,
- * and comprehensive result aggregation.
- *
- * Agent-browser provides enhanced E2E testing capabilities:
- * - Snapshot-based element refs (@e1, @e2) for reliable element selection
- * - Session management for state persistence
- * - Network interception and API mocking
- * - Device emulation for responsive testing
- */
-export declare class E2ETestRunnerService implements IE2ETestRunnerService {
-    private readonly client;
-    private readonly config;
-    private readonly unifiedClient;
-    private readonly useAgentBrowser;
-    /**
-     * Create E2E Test Runner Service
-     *
-     * @param client - Browser automation client (VibiumClient or IBrowserClient)
-     * @param config - Runner configuration
-     *
-     * @example
-     * ```typescript
-     * // Using VibiumClient (legacy)
-     * const vibiumClient = await createVibiumClient({ enabled: true });
-     * const runner = new E2ETestRunnerService(vibiumClient);
-     *
-     * // Using agent-browser (recommended for E2E)
-     * const agentClient = await createAgentBrowserClient();
-     * const runner = new E2ETestRunnerService(agentClient, {
-     *   preferAgentBrowser: true
-     * });
-     *
-     * // Using auto-selection
-     * const runner = createE2ETestRunnerServiceWithBrowserClient(undefined, {
-     *   browserClientType: 'auto'
-     * });
-     * ```
-     */
-    constructor(client: VibiumClient | IBrowserClient, config?: Partial<E2ERunnerConfig>);
-    /**
-     * Execute a single E2E test case
-     */
-    runTestCase(testCase: E2ETestCase): Promise<E2ETestResult>;
-    /**
-     * Execute an E2E test suite
-     */
-    runTestSuite(suite: E2ETestSuite, strategy?: ExecutionStrategy): Promise<E2ETestSuiteResult>;
-    /**
-     * Ensure browser is launched for the test case
-     * Handles both agent-browser and Vibium clients
-     */
-    private ensureBrowserLaunched;
-    /**
-     * Refresh the page snapshot (agent-browser only)
-     */
-    private refreshSnapshot;
-    /**
-     * Execute a navigate step
-     * Supports both agent-browser and Vibium clients
-     */
-    private executeNavigateStep;
-    /**
-     * Execute a click step
-     * Supports both agent-browser and Vibium clients
-     */
-    private executeClickStep;
-    /**
-     * Execute a type step
-     * Supports both agent-browser and Vibium clients
-     */
-    private executeTypeStep;
-    /**
-     * Execute a wait step
-     * Supports both agent-browser and Vibium clients
-     */
-    private executeWaitStep;
-    /**
-     * Execute an assert step
-     * Supports both agent-browser and Vibium clients
-     */
-    private executeAssertStep;
-    /**
-     * Execute a screenshot step
-     * Supports both agent-browser and Vibium clients
-     */
-    private executeScreenshotStep;
-    /**
-     * Execute an accessibility check step
-     * Supports both agent-browser and Vibium clients
-     */
-    private executeA11yCheckStep;
-    /**
-     * Wait for a condition to be met
-     */
-    private waitForCondition;
-    /**
-     * Perform an assertion using the unified browser client (IBrowserClient)
-     * Supports agent-browser and generic browser clients
-     */
-    private performUnifiedAssertion;
-    /**
-     * Perform an assertion (Legacy Vibium path)
-     */
-    private performAssertion;
-    /**
-     * Execute a step with retry logic
-     */
-    private executeStepWithRetry;
-    /**
-     * Execute a single step based on its type
-     */
-    private executeStep;
-    /**
-     * Execute hook steps
-     */
-    private executeHooks;
-    /**
-     * Execute tests in parallel with limited concurrency
-     */
-    private executeInParallel;
-    /**
-     * Check if element is visible
-     */
-    private checkElementVisible;
-    /**
-     * Check if element is enabled
-     */
-    private checkElementEnabled;
-    /**
-     * Check element text against expected value
-     */
-    private checkElementText;
-    /**
-     * Check element attribute against expected value
-     */
-    private checkElementAttribute;
-    /**
-     * Scroll element into view
-     */
-    private scrollIntoView;
-    /**
-     * Assert a condition is true
-     */
-    private assertCondition;
-    /**
-     * Assert text matches using specified operator
-     */
-    private assertTextMatch;
-    /**
-     * Assert numeric condition
-     */
-    private assertNumericCondition;
-    /**
-     * Resolve URL with base URL
-     */
-    private resolveUrl;
-    /**
-     * Evaluate conditional expression
-     * Uses safe expression evaluator to prevent code injection (CVE fix)
-     */
-    private evaluateCondition;
-    /**
-     * Get browser context options from test case
-     */
-    private getBrowserContextOptions;
-    /**
-     * Capture screenshot on failure
-     * Supports both agent-browser and Vibium clients
-     */
-    private captureFailureScreenshot;
-    /**
-     * Check if any results have failures
-     */
-    private hasFailure;
-    /**
-     * Calculate summary statistics
-     */
-    private calculateSummary;
-    /**
-     * Create skipped test result
-     */
-    private createSkippedResult;
-    /**
-     * Create error test result
-     */
-    private createErrorResult;
-    /**
-     * Create test result from step results
-     */
-    private createResult;
-    /**
-     * Wrap promise with timeout
-     */
-    private withTimeout;
-    /**
-     * Delay execution
-     */
-    private delay;
-    /**
-     * Log message if verbose mode is enabled
-     */
-    private log;
-}
-/**
- * Create an E2E Test Runner Service instance with a VibiumClient (legacy)
- *
- * @param client - Vibium browser automation client
- * @param config - Optional runner configuration
- * @returns E2E Test Runner Service instance
- *
- * @example
- * ```typescript
- * import { createVibiumClient } from '../../../integrations/vibium';
- * import { createE2ETestRunnerService } from './e2e-runner';
- *
- * const client = await createVibiumClient({ enabled: true });
- * const runner = createE2ETestRunnerService(client, {
- *   screenshotOnFailure: true,
- *   verbose: true,
- * });
- *
- * const result = await runner.runTestCase(testCase);
- * ```
- */
-export declare function createE2ETestRunnerService(client: VibiumClient, config?: Partial<E2ERunnerConfig>): E2ETestRunnerService;
-/**
- * Create an E2E Test Runner Service instance with a browser client
- *
- * This factory supports the unified IBrowserClient interface, including
- * agent-browser with its enhanced E2E testing capabilities.
- *
- * @param client - Browser client (IBrowserClient or IAgentBrowserClient)
- * @param config - Optional runner configuration
- * @returns E2E Test Runner Service instance
- *
- * @example
- * ```typescript
- * import { createAgentBrowserClient } from '../../../integrations/browser';
- * import { createE2ETestRunnerServiceWithBrowserClient } from './e2e-runner';
- *
- * // Using agent-browser (recommended for E2E testing)
- * const agentClient = await createAgentBrowserClient();
- * const runner = createE2ETestRunnerServiceWithBrowserClient(agentClient, {
- *   preferAgentBrowser: true,
- *   screenshotOnFailure: true,
- * });
- *
- * // Execute test with snapshot refs
- * const result = await runner.runTestCase(testCase);
- * ```
- */
-export declare function createE2ETestRunnerServiceWithBrowserClient(client: IBrowserClient, config?: Partial<E2ERunnerConfig>): E2ETestRunnerService;
-/**
- * Create an E2E Test Runner Service with auto-selected browser client
- *
- * This factory automatically selects the best available browser client:
- * - Prefers agent-browser for E2E testing (supports refs, sessions, mocking)
- * - Falls back to Vibium if agent-browser is unavailable
- *
- * @param config - Optional runner configuration
- * @returns Promise resolving to E2E Test Runner Service instance
- *
- * @example
- * ```typescript
- * import { createAutoE2ETestRunnerService } from './e2e-runner';
- *
- * // Auto-select best browser client for E2E testing
- * const runner = await createAutoE2ETestRunnerService({
- *   screenshotOnFailure: true,
- *   verbose: true,
- * });
- *
- * const result = await runner.runTestCase(testCase);
- * ```
- */
-export declare function createAutoE2ETestRunnerService(config?: Partial<E2ERunnerConfig>): Promise<E2ETestRunnerService>;
+export { type E2ERunnerConfig, type BrowserClientType, type ExecutionStrategy, DEFAULT_E2E_RUNNER_CONFIG, type IE2ETestRunnerService, E2ERunnerError, StepTimeoutError, AssertionError, } from './e2e/types';
+export { E2ETestRunnerService, createE2ETestRunnerService, createE2ETestRunnerServiceWithBrowserClient, createAutoE2ETestRunnerService, } from './e2e/e2e-coordinator';
+export { BrowserOrchestrator, createBrowserOrchestrator, isAgentBrowserClient, isVibiumClient, toElementTarget, toVibiumScreenshotResult, toVibiumAccessibilityResult, } from './e2e/browser-orchestrator';
+export { StepExecutors, createStepExecutors, } from './e2e/step-executors';
+export { StepRetryHandler, createStepRetryHandler, } from './e2e/step-retry-handler';
+export { ResultCollector, createResultCollector, } from './e2e/result-collector';
+export type { StepExecutionContext, StepExecutionData, UnifiedBrowserClient, } from './e2e/types';
 //# sourceMappingURL=e2e-runner.d.ts.map

package/v3/dist/domains/test-execution/services/e2e-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"e2e-runner.d.ts","sourceRoot":"","sources":["../../../../src/domains/test-execution/services/e2e-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"e2e-runner.d.ts","sourceRoot":"","sources":["../../../../src/domains/test-execution/services/e2e-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,2CAA2C,EAC3C,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}