qa360 1.0.3 → 1.1.0

package/dist/core/adapters/playwright-api.js

@@ -0,0 +1,252 @@
+/**
+ * QA360 Playwright API Adapter (Socle OOTB)
+ * Smoke tests for REST/GraphQL APIs with retry logic
+ */
+import { chromium } from '@playwright/test';
+import { SecurityRedactor } from '../security/redactor.js';
+export class PlaywrightApiAdapter {
+    browser;
+    context;
+    redactor;
+    constructor() {
+        this.redactor = SecurityRedactor.forLogs();
+    }
+    /**
+     * Execute API smoke tests
+     */
+    async runSmokeTests(config) {
+        try {
+            await this.setupBrowser();
+            const results = [];
+            const smokeTests = config.target.smoke || [`GET ${config.target.baseUrl}/health -> 200`];
+            console.log(`🌐 Running API smoke tests (${smokeTests.length} endpoints)`);
+            for (const test of smokeTests) {
+                const testResult = await this.executeApiTest(test, config);
+                results.push(testResult);
+                if (testResult.success) {
+                    console.log(`  ✅ ${testResult.method} ${testResult.endpoint} -> ${testResult.status} (${testResult.responseTime}ms)`);
+                }
+                else {
+                    console.log(`  ❌ ${testResult.method} ${testResult.endpoint} -> ${testResult.error}`);
+                }
+            }
+            const summary = this.calculateSummary(results);
+            const junit = this.generateJUnit(results);
+            return {
+                success: summary.failed === 0,
+                results,
+                summary,
+                junit
+            };
+        }
+        finally {
+            await this.cleanup();
+        }
+    }
+    /**
+     * Execute single API test with retry logic
+     */
+    async executeApiTest(testSpec, config) {
+        const { method, endpoint, expectedStatus } = this.parseTestSpec(testSpec, config.target.baseUrl);
+        const maxRetries = config.retries || 1;
+        let lastError = '';
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                const startTime = Date.now();
+                const response = await this.context.request.fetch(endpoint, {
+                    method: method,
+                    timeout: config.timeout || 10000,
+                    headers: {
+                        'User-Agent': 'QA360-API-Smoke/1.0',
+                        'Accept': 'application/json, text/plain, */*'
+                    }
+                });
+                const responseTime = Date.now() - startTime;
+                const status = response.status();
+                const success = status === expectedStatus;
+                // Get response body safely
+                let body;
+                try {
+                    const contentType = response.headers()['content-type'] || '';
+                    if (contentType.includes('application/json')) {
+                        body = await response.json();
+                    }
+                    else {
+                        const text = await response.text();
+                        body = text.substring(0, 200); // Limit body size
+                    }
+                }
+                catch {
+                    body = '[Response body not readable]';
+                }
+                return {
+                    endpoint,
+                    method,
+                    status,
+                    responseTime,
+                    success,
+                    error: success ? undefined : `Expected status ${expectedStatus}, got ${status}`,
+                    headers: response.headers(),
+                    body: this.redactor.redactObject(body)
+                };
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error.message : 'Unknown error';
+                // Check if this is a retryable error
+                const isRetryable = this.isRetryableError(lastError);
+                if (isRetryable && attempt < maxRetries) {
+                    console.log(`    🔄 Retry ${attempt + 1}/${maxRetries} for ${method} ${endpoint} (${lastError})`);
+                    await new Promise(resolve => setTimeout(resolve, 1000 * (attempt + 1))); // Exponential backoff
+                    continue;
+                }
+                break;
+            }
+        }
+        return {
+            endpoint,
+            method,
+            status: 0,
+            responseTime: 0,
+            success: false,
+            error: this.redactor.redact(lastError)
+        };
+    }
+    /**
+     * Parse test specification string
+     */
+    parseTestSpec(spec, baseUrl) {
+        // Format: "GET /path -> 200" or "POST /api/users -> 201"
+        const match = spec.match(/^(\w+)\s+(.+?)\s*->\s*(\d+)$/);
+        if (!match) {
+            throw new Error(`Invalid test spec format: ${spec}. Expected: "METHOD /path -> STATUS"`);
+        }
+        const [, method, path, statusStr] = match;
+        const expectedStatus = parseInt(statusStr, 10);
+        // Build full endpoint URL
+        let endpoint = path;
+        if (!path.startsWith('http')) {
+            endpoint = baseUrl.replace(/\/$/, '') + (path.startsWith('/') ? path : `/${path}`);
+        }
+        return {
+            method: method.toUpperCase(),
+            endpoint,
+            expectedStatus
+        };
+    }
+    /**
+     * Check if error is retryable
+     */
+    isRetryableError(error) {
+        const retryablePatterns = [
+            /ECONNRESET/,
+            /ETIMEDOUT/,
+            /ECONNREFUSED/,
+            /502 Bad Gateway/,
+            /503 Service Unavailable/,
+            /504 Gateway Timeout/,
+            /timeout/i,
+            /network/i
+        ];
+        return retryablePatterns.some(pattern => pattern.test(error));
+    }
+    /**
+     * Calculate test summary
+     */
+    calculateSummary(results) {
+        const total = results.length;
+        const passed = results.filter(r => r.success).length;
+        const failed = total - passed;
+        const avgResponseTime = total > 0 ?
+            Math.round(results.reduce((sum, r) => sum + r.responseTime, 0) / total) : 0;
+        return { total, passed, failed, avgResponseTime };
+    }
+    /**
+     * Generate JUnit XML fragment
+     */
+    generateJUnit(results) {
+        const summary = this.calculateSummary(results);
+        const timestamp = new Date().toISOString();
+        let junit = `<?xml version="1.0" encoding="UTF-8"?>
+<testsuite name="API Smoke Tests" tests="${summary.total}" failures="${summary.failed}" time="${summary.avgResponseTime / 1000}" timestamp="${timestamp}">
+`;
+        for (const result of results) {
+            const testName = `${result.method} ${result.endpoint}`;
+            const time = result.responseTime / 1000;
+            junit += `  <testcase name="${this.escapeXml(testName)}" time="${time}">
+`;
+            if (!result.success) {
+                junit += `    <failure message="${this.escapeXml(result.error || 'Test failed')}">${this.escapeXml(JSON.stringify(result, null, 2))}</failure>
+`;
+            }
+            junit += `  </testcase>
+`;
+        }
+        junit += `</testsuite>`;
+        return junit;
+    }
+    /**
+     * Escape XML special characters
+     */
+    escapeXml(str) {
+        return str
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
+    /**
+     * Setup browser context
+     */
+    async setupBrowser() {
+        this.browser = await chromium.launch({
+            headless: true,
+            args: ['--no-sandbox', '--disable-dev-shm-usage']
+        });
+        this.context = await this.browser.newContext({
+            userAgent: 'QA360-API-Smoke/1.0',
+            extraHTTPHeaders: {
+                'Accept': 'application/json, text/plain, */*'
+            }
+        });
+    }
+    /**
+     * Cleanup browser resources
+     */
+    async cleanup() {
+        if (this.context) {
+            await this.context.close();
+        }
+        if (this.browser) {
+            await this.browser.close();
+        }
+    }
+    /**
+     * Validate API target configuration
+     */
+    static validateConfig(target) {
+        const errors = [];
+        if (!target.baseUrl) {
+            errors.push('API target requires baseUrl');
+        }
+        else {
+            try {
+                new URL(target.baseUrl);
+            }
+            catch {
+                errors.push('API target baseUrl must be a valid URL');
+            }
+        }
+        if (target.smoke) {
+            for (const test of target.smoke) {
+                if (!/^\w+\s+.+\s*->\s*\d+$/.test(test)) {
+                    errors.push(`Invalid smoke test format: ${test}. Expected: "METHOD /path -> STATUS"`);
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+}

package/dist/core/adapters/playwright-ui.d.ts

@@ -0,0 +1,115 @@
+/**
+ * QA360 Playwright UI Adapter (Socle OOTB)
+ * UI smoke tests + accessibility via axe-core
+ */
+import { WebTarget, PackBudgets } from '../types/pack-v1.js';
+export interface UiTestConfig {
+    target: WebTarget;
+    budgets?: PackBudgets;
+    timeout?: number;
+    login?: {
+        url?: string;
+        username?: string;
+        password?: string;
+        usernameSelector?: string;
+        passwordSelector?: string;
+        submitSelector?: string;
+    };
+}
+export interface UiTestResult {
+    page: string;
+    success: boolean;
+    loadTime: number;
+    error?: string;
+    screenshot?: string;
+    accessibility?: {
+        score: number;
+        violations: Array<{
+            id: string;
+            impact: 'minor' | 'moderate' | 'serious' | 'critical';
+            description: string;
+            nodes: number;
+        }>;
+    };
+    domSnapshot?: {
+        title: string;
+        url: string;
+        elements: {
+            buttons: number;
+            links: number;
+            forms: number;
+            inputs: number;
+        };
+    };
+}
+export interface UiSmokeResult {
+    success: boolean;
+    results: UiTestResult[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        avgLoadTime: number;
+        avgA11yScore: number;
+    };
+    junit?: string;
+}
+export declare class PlaywrightUiAdapter {
+    private browser?;
+    private context?;
+    private page?;
+    private redactor;
+    constructor();
+    /**
+     * Execute UI smoke tests with accessibility
+     */
+    runSmokeTests(config: UiTestConfig): Promise<UiSmokeResult>;
+    /**
+     * Test single page with accessibility
+     */
+    private testPage;
+    /**
+     * Perform login if configured
+     */
+    private performLogin;
+    /**
+     * Run accessibility tests using axe-core
+     */
+    private runAccessibilityTests;
+    /**
+     * Get DOM snapshot for debugging
+     */
+    private getDomSnapshot;
+    /**
+     * Take screenshot for debugging
+     */
+    private takeScreenshot;
+    /**
+     * Calculate test summary
+     */
+    private calculateSummary;
+    /**
+     * Generate JUnit XML fragment
+     */
+    private generateJUnit;
+    /**
+     * Escape XML special characters
+     */
+    private escapeXml;
+    /**
+     * Setup browser context
+     */
+    private setupBrowser;
+    /**
+     * Cleanup browser resources
+     */
+    private cleanup;
+    /**
+     * Validate UI target configuration
+     */
+    static validateConfig(target: WebTarget): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+//# sourceMappingURL=playwright-ui.d.ts.map

package/dist/core/adapters/playwright-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-ui.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/playwright-ui.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAa7D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,KAAK,CAAC;YAChB,EAAE,EAAE,MAAM,CAAC;YACX,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;YACtD,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC,CAAC;KACJ,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE;YACR,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,IAAI,CAAC,CAAO;IACpB,OAAO,CAAC,QAAQ,CAAmB;;IAMnC;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA0CjE;;OAEG;YACW,QAAQ;IAuDtB;;OAEG;YACW,YAAY;IA8B1B;;OAEG;YACW,qBAAqB;IAkEnC;;OAEG;YACW,cAAc;IAyB5B;;OAEG;YACW,cAAc;IAc5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;YACW,YAAY;IAc1B;;OAEG;YACW,OAAO;IAYrB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CA4B/E"}