agentic-qe 3.3.3 → 3.3.4

package/v3/dist/domains/test-execution/services/e2e/browser-orchestrator.js

@@ -0,0 +1,325 @@
+/**
+ * Agentic QE v3 - Browser Orchestrator
+ *
+ * Manages browser client lifecycle, type detection, and snapshot operations.
+ * Supports both agent-browser (CLI-based) and Vibium (MCP-based) clients.
+ *
+ * @module test-execution/services/e2e/browser-orchestrator
+ */
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard to check if client is an agent-browser client
+ */
+export function isAgentBrowserClient(client) {
+    return 'tool' in client && client.tool === 'agent-browser';
+}
+/**
+ * Type guard to check if client is a Vibium client (legacy)
+ */
+export function isVibiumClient(client) {
+    return !('tool' in client) || !client.tool;
+}
+// ============================================================================
+// Element Target Conversion
+// ============================================================================
+/**
+ * Convert a step selector to an ElementTarget for the unified browser interface
+ * Supports CSS selectors, XPath, text content, and agent-browser refs
+ *
+ * @param selector - The selector string from the step
+ * @returns ElementTarget for use with IBrowserClient
+ */
+export function toElementTarget(selector) {
+    // Agent-browser snapshot refs (@e1, @e2, e1, e2)
+    if (/^@?e\d+$/.test(selector)) {
+        const value = selector.startsWith('@') ? selector : `@${selector}`;
+        return { type: 'ref', value };
+    }
+    // XPath selectors
+    if (selector.startsWith('//') || selector.startsWith('xpath=')) {
+        const value = selector.replace(/^xpath=/, '');
+        return { type: 'xpath', value };
+    }
+    // Text content matching
+    if (selector.startsWith('text=')) {
+        const value = selector.replace(/^text=/, '');
+        return { type: 'text', value };
+    }
+    // Default to CSS selector
+    return { type: 'css', value: selector };
+}
+// ============================================================================
+// Result Conversion Utilities
+// ============================================================================
+/**
+ * Convert BrowserScreenshotResult to Vibium ScreenshotResult format
+ * This is needed for backward compatibility
+ */
+export function toVibiumScreenshotResult(result) {
+    return {
+        base64: result.base64,
+        path: result.path,
+        format: result.format,
+        dimensions: result.dimensions,
+        sizeBytes: result.base64 ? Math.ceil(result.base64.length * 0.75) : 0,
+        capturedAt: new Date(),
+    };
+}
+/**
+ * Convert axe-core results to Vibium AccessibilityResult format
+ */
+export function toVibiumAccessibilityResult(axeResults) {
+    const violationsBySeverity = {
+        critical: 0,
+        high: 0,
+        medium: 0,
+        low: 0,
+        info: 0,
+    };
+    const violations = axeResults.violations.map((v) => {
+        const impact = v.impact;
+        if (impact in violationsBySeverity) {
+            violationsBySeverity[impact]++;
+        }
+        return {
+            id: v.id,
+            impact: v.impact,
+            description: v.description,
+            nodes: v.nodes.length,
+        };
+    });
+    return {
+        passes: violations.length === 0,
+        violations: violations,
+        violationsBySeverity,
+        passedRules: axeResults.passes.map((p) => p.id),
+        incompleteRules: axeResults.incomplete.map((i) => i.id),
+        checkedAt: new Date(),
+    };
+}
+// ============================================================================
+// Browser Orchestrator Class
+// ============================================================================
+/**
+ * Browser Orchestrator
+ *
+ * Manages browser client operations including launch, snapshot refresh,
+ * screenshot capture, and cleanup. Abstracts differences between
+ * agent-browser and Vibium clients.
+ */
+export class BrowserOrchestrator {
+    client;
+    unifiedClient;
+    useAgentBrowser;
+    config;
+    log;
+    constructor(client, config, logger) {
+        this.client = client;
+        this.config = config;
+        this.log = logger;
+        // Use provided browser client from config if available
+        this.unifiedClient = config.browserClient ?? client;
+        // Determine if we're using agent-browser
+        this.useAgentBrowser = isAgentBrowserClient(this.unifiedClient);
+    }
+    /**
+     * Get the unified browser client
+     */
+    getClient() {
+        return this.unifiedClient;
+    }
+    /**
+     * Check if using agent-browser client
+     */
+    isUsingAgentBrowser() {
+        return this.useAgentBrowser;
+    }
+    /**
+     * Ensure browser is launched for the test case
+     * Handles both agent-browser and Vibium clients
+     */
+    async ensureBrowserLaunched(testCase) {
+        try {
+            if (this.useAgentBrowser && isAgentBrowserClient(this.unifiedClient)) {
+                const launchResult = await this.unifiedClient.launch({
+                    headless: true,
+                    viewport: testCase.viewport,
+                });
+                if (!launchResult.success) {
+                    return `Failed to launch browser: ${launchResult.error.message}`;
+                }
+                return null;
+            }
+            else if (isVibiumClient(this.client)) {
+                const session = await this.client.getSession();
+                if (!session) {
+                    const launchResult = await this.client.launch({
+                        headless: true,
+                        viewport: testCase.viewport,
+                        ...this.getBrowserContextOptions(testCase),
+                    });
+                    if (!launchResult.success) {
+                        return `Failed to launch browser: ${launchResult.error.message}`;
+                    }
+                }
+                return null;
+            }
+            else {
+                const launchResult = await this.unifiedClient.launch({
+                    headless: true,
+                    viewport: testCase.viewport,
+                });
+                if (!launchResult.success) {
+                    return `Failed to launch browser: ${launchResult.error.message}`;
+                }
+                return null;
+            }
+        }
+        catch (error) {
+            return error instanceof Error ? error.message : String(error);
+        }
+    }
+    /**
+     * Refresh the page snapshot (agent-browser only)
+     */
+    async refreshSnapshot() {
+        if (!this.useAgentBrowser || !isAgentBrowserClient(this.unifiedClient)) {
+            return undefined;
+        }
+        try {
+            const snapshotResult = await this.unifiedClient.getSnapshot({ interactive: true });
+            if (snapshotResult.success) {
+                return snapshotResult.value;
+            }
+        }
+        catch {
+            this.log('Failed to refresh snapshot');
+        }
+        return undefined;
+    }
+    /**
+     * Capture screenshot on failure
+     */
+    async captureFailureScreenshot(stepId) {
+        try {
+            if (!isVibiumClient(this.unifiedClient)) {
+                const browserClient = this.unifiedClient;
+                const result = await browserClient.screenshot({ fullPage: true });
+                if (result.success) {
+                    return toVibiumScreenshotResult(result.value);
+                }
+                return null;
+            }
+            const result = await this.client.screenshot({
+                fullPage: true,
+                format: 'png',
+            });
+            if (result.success) {
+                return result.value;
+            }
+        }
+        catch {
+            this.log(`Failed to capture failure screenshot for step ${stepId}`);
+        }
+        return null;
+    }
+    /**
+     * Check if element is visible (Vibium client)
+     */
+    async checkElementVisible(selector) {
+        if (!isVibiumClient(this.client)) {
+            return false;
+        }
+        const result = await this.client.findElement({
+            selector,
+            visible: true,
+            timeout: 1000,
+        });
+        return result.success && result.value.visible;
+    }
+    /**
+     * Check if element is enabled (Vibium client)
+     */
+    async checkElementEnabled(selector) {
+        if (!isVibiumClient(this.client)) {
+            return false;
+        }
+        const result = await this.client.findElement({ selector, timeout: 1000 });
+        return result.success && result.value.enabled;
+    }
+    /**
+     * Check element text against expected value (Vibium client)
+     */
+    async checkElementText(selector, expectedText, matchMode) {
+        if (!isVibiumClient(this.client)) {
+            return { matches: false, actualText: '' };
+        }
+        const result = await this.client.getText(selector);
+        if (!result.success) {
+            return { matches: false, actualText: '' };
+        }
+        const actualText = result.value;
+        let matches = false;
+        switch (matchMode) {
+            case 'exact':
+                matches = actualText === expectedText;
+                break;
+            case 'contains':
+                matches = actualText.includes(expectedText);
+                break;
+            case 'regex':
+                matches = new RegExp(expectedText).test(actualText);
+                break;
+        }
+        return { matches, actualText };
+    }
+    /**
+     * Check element attribute against expected value (Vibium client)
+     */
+    async checkElementAttribute(selector, attributeName, expectedValue) {
+        if (!isVibiumClient(this.client)) {
+            return { matches: false, actualValue: '' };
+        }
+        const result = await this.client.getAttribute(selector, attributeName);
+        if (!result.success) {
+            return { matches: false, actualValue: '' };
+        }
+        return {
+            matches: result.value === expectedValue,
+            actualValue: result.value,
+        };
+    }
+    /**
+     * Scroll element into view (Vibium client)
+     */
+    async scrollIntoView(selector) {
+        if (isVibiumClient(this.client)) {
+            await this.client.findElement({ selector, visible: true });
+        }
+    }
+    /**
+     * Get browser context options from test case
+     */
+    getBrowserContextOptions(testCase) {
+        const options = {};
+        if (testCase.browserContext?.userAgent) {
+            options.userAgent = testCase.browserContext.userAgent;
+        }
+        if (testCase.browserContext?.locale) {
+            options.locale = testCase.browserContext.locale;
+        }
+        if (testCase.browserContext?.timezoneId) {
+            options.timezoneId = testCase.browserContext.timezoneId;
+        }
+        return options;
+    }
+}
+/**
+ * Create a browser orchestrator instance
+ */
+export function createBrowserOrchestrator(client, config, logger) {
+    return new BrowserOrchestrator(client, config, logger);
+}
+//# sourceMappingURL=browser-orchestrator.js.map

package/v3/dist/domains/test-execution/services/e2e/browser-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-orchestrator.js","sourceRoot":"","sources":["../../../../../src/domains/test-execution/services/e2e/browser-orchestrator.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,97 @@
+/**
+ * Agentic QE v3 - E2E Test Coordinator
+ *
+ * Main coordinator that orchestrates E2E test execution by composing
+ * the modular components: browser orchestrator, step executors,
+ * step retry handler, and result collector.
+ *
+ * @module test-execution/services/e2e/e2e-coordinator
+ */
+import type { VibiumClient } from '../../../../integrations/vibium';
+import type { IBrowserClient } from '../../../../integrations/browser';
+import type { E2ETestCase, E2ETestResult, E2ETestSuite, E2ETestSuiteResult } from '../../types';
+import type { E2ERunnerConfig, IE2ETestRunnerService, ExecutionStrategy } from './types';
+/**
+ * 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 orchestrator;
+    private readonly stepExecutors;
+    private readonly retryHandler;
+    private readonly resultCollector;
+    /**
+     * Create E2E Test Runner Service
+     *
+     * @param client - Browser automation client (VibiumClient or IBrowserClient)
+     * @param config - Runner configuration
+     */
+    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>;
+    /**
+     * Execute hook steps
+     */
+    private executeHooks;
+    /**
+     * Execute tests in parallel with limited concurrency
+     */
+    private executeInParallel;
+    /**
+     * 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
+ */
+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
+ */
+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
+ */
+export declare function createAutoE2ETestRunnerService(config?: Partial<E2ERunnerConfig>): Promise<E2ETestRunnerService>;
+//# sourceMappingURL=e2e-coordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"e2e-coordinator.d.ts","sourceRoot":"","sources":["../../../../../src/domains/test-execution/services/e2e/e2e-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAyC,MAAM,iCAAiC,CAAC;AAC3G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAIvE,OAAO,KAAK,EAGV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,kBAAkB,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EAElB,MAAM,SAAS,CAAC;AAWjB;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAc9D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAElD;;;;;OAKG;gBAEgB,MAAM,EAAE,YAAY,GAAG,cAAc,EACtD,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAsBvC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAiKhE;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,YAAY,EACnB,QAAQ,GAAE,iBAA8D,GACvE,OAAO,CAAC,kBAAkB,CAAC;IA8B9B;;OAEG;YACW,YAAY;IAqB1B;;OAEG;YACW,iBAAiB;IA2B/B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ;AAMD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,oBAAoB,CAEtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,2CAA2C,CACzD,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,oBAAoB,CAKtB;AAED;;;;;;;;;GASG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,OAAO,CAAC,oBAAoB,CAAC,CAQ/B"}