@supernal/interface 1.0.9 → 1.0.12

package/dist/cjs/src/testing/graph-tester/core/GraphTester.js

@@ -0,0 +1,339 @@
+"use strict";
+/**
+ * Main orchestrator for graph-based testing.
+ *
+ * GraphTester coordinates:
+ * 1. Route discovery (manual or via NavigationGraph)
+ * 2. Test function execution across all routes
+ * 3. Result aggregation and reporting
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphTester = void 0;
+const test_1 = require("@playwright/test");
+const TestFunction_1 = require("./TestFunction");
+const types_1 = require("./types");
+/**
+ * Main orchestrator for graph-based testing.
+ *
+ * @example
+ * ```typescript
+ * const tester = new GraphTester({
+ *   baseUrl: 'http://localhost:3000',
+ *   routes: [
+ *     { route: '/', metadata: { name: 'Home' } },
+ *     { route: '/dashboard', metadata: { name: 'Dashboard' } }
+ *   ],
+ *   modes: ['visual', 'performance'],
+ *   output: {
+ *     dir: './test-results',
+ *     formats: ['html', 'json']
+ *   }
+ * });
+ *
+ * const results = await tester.runTests();
+ * console.log(`Pass rate: ${results.passRate}%`);
+ * ```
+ */
+class GraphTester {
+    /**
+     * Create a new GraphTester instance.
+     *
+     * @param config - Configuration for the tester
+     */
+    constructor(config) {
+        this.testFunctions = new Map();
+        this.browser = null;
+        this.context = null;
+        this.config = this.validateConfig(config);
+    }
+    /**
+     * Validate and normalize configuration.
+     */
+    validateConfig(config) {
+        if (!config.baseUrl) {
+            throw new Error('baseUrl is required');
+        }
+        if (!config.modes || config.modes.length === 0) {
+            throw new Error('At least one test mode is required');
+        }
+        // Normalize routes configuration
+        if (!config.routes) {
+            config.routes = {
+                strategy: 'manual',
+            };
+        }
+        // Normalize output configuration
+        if (!config.output) {
+            config.output = {
+                dir: './test-results',
+                formats: ['json', 'html'],
+            };
+        }
+        // Normalize execution configuration
+        if (!config.execution) {
+            config.execution = {
+                parallel: 1,
+                timeout: 30000,
+                retries: 0,
+                failFast: false,
+            };
+        }
+        return config;
+    }
+    /**
+     * Register a test function.
+     *
+     * @param testFunction - Test function to register
+     */
+    registerTestFunction(testFunction) {
+        if (!(0, TestFunction_1.isTestFunction)(testFunction)) {
+            throw new Error('Invalid test function');
+        }
+        const validationErrors = testFunction.validate();
+        if (validationErrors.length > 0) {
+            throw new Error(`Test function validation failed: ${validationErrors.join(', ')}`);
+        }
+        this.testFunctions.set(testFunction.mode, testFunction);
+    }
+    /**
+     * Discover routes to test.
+     *
+     * @returns Array of route descriptors
+     */
+    async discoverRoutes() {
+        const routesConfig = this.config.routes;
+        // Manual routes provided as array
+        if (Array.isArray(routesConfig)) {
+            return routesConfig;
+        }
+        // Route discovery configuration
+        const discoveryConfig = routesConfig;
+        if (discoveryConfig.strategy === 'manual') {
+            throw new Error('Manual strategy requires routes array');
+        }
+        if (discoveryConfig.strategy === 'navigation-graph') {
+            throw new Error('NavigationGraph discovery is only available in @supernalintelligence/interface-enterprise');
+        }
+        if (discoveryConfig.strategy === 'custom' && discoveryConfig.discoveryFn) {
+            return discoveryConfig.discoveryFn();
+        }
+        throw new Error(`Unknown discovery strategy: ${discoveryConfig.strategy}`);
+    }
+    /**
+     * Filter routes based on include/exclude patterns.
+     *
+     * @param routes - Routes to filter
+     * @returns Filtered routes
+     */
+    filterRoutes(routes) {
+        const routesConfig = this.config.routes;
+        if (Array.isArray(routesConfig)) {
+            return routes;
+        }
+        const discoveryConfig = routesConfig;
+        const { include, exclude } = discoveryConfig;
+        let filtered = routes;
+        // Apply include patterns
+        if (include && include.length > 0) {
+            filtered = filtered.filter((r) => include.some((pattern) => this.matchPattern(r.route, pattern)));
+        }
+        // Apply exclude patterns
+        if (exclude && exclude.length > 0) {
+            filtered = filtered.filter((r) => !exclude.some((pattern) => this.matchPattern(r.route, pattern)));
+        }
+        return filtered;
+    }
+    /**
+     * Simple pattern matching for route filtering.
+     * Supports basic glob patterns with *.
+     *
+     * @param route - Route to match
+     * @param pattern - Pattern to match against
+     * @returns Whether route matches pattern
+     */
+    matchPattern(route, pattern) {
+        // Convert glob pattern to regex
+        const regexPattern = pattern
+            .replace(/\*/g, '.*')
+            .replace(/\?/g, '.')
+            .replace(/\//g, '\\/');
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(route);
+    }
+    /**
+     * Initialize browser and context.
+     */
+    async initBrowser() {
+        const browserConfig = this.config.browser || {};
+        this.browser = await test_1.chromium.launch({
+            headless: browserConfig.headless !== false,
+            ...browserConfig.launchOptions,
+        });
+        this.context = await this.browser.newContext({
+            viewport: browserConfig.viewport || { width: 1280, height: 720 },
+        });
+    }
+    /**
+     * Close browser and context.
+     */
+    async closeBrowser() {
+        if (this.context) {
+            await this.context.close();
+            this.context = null;
+        }
+        if (this.browser) {
+            await this.browser.close();
+            this.browser = null;
+        }
+    }
+    /**
+     * Apply a test function to a route with optional viewport.
+     *
+     * @param route - Route descriptor
+     * @param testFunction - Test function to apply
+     * @param viewport - Viewport configuration (optional)
+     * @returns Test result
+     */
+    async applyTestFunction(route, testFunction, viewport) {
+        if (!this.context) {
+            throw new Error('Browser context not initialized');
+        }
+        const page = await this.context.newPage();
+        try {
+            // Set viewport if provided
+            if (viewport) {
+                await page.setViewportSize({ width: viewport.width, height: viewport.height });
+                // Note: Device scale factor and mobile emulation would require creating
+                // a new context per viewport for full mobile emulation.
+                // For now, we just set viewport size which covers most responsive testing needs.
+            }
+            // Navigate to route
+            const url = `${this.config.baseUrl}${route.route}`;
+            await page.goto(url, { waitUntil: 'networkidle', timeout: this.config.execution?.timeout });
+            // Create test context
+            const testContext = {
+                route: route.route,
+                contextId: route.contextId,
+                metadata: route.metadata,
+                baseUrl: this.config.baseUrl,
+                viewport,
+            };
+            // Run test function
+            const result = await testFunction.run(page, testContext);
+            return result;
+        }
+        catch (error) {
+            return {
+                passed: false,
+                duration: 0,
+                errors: [
+                    {
+                        severity: 'critical',
+                        message: `Failed to test route: ${error instanceof Error ? error.message : String(error)}`,
+                        stack: error instanceof Error ? error.stack : undefined,
+                    },
+                ],
+                metadata: {},
+                mode: testFunction.mode,
+                route: route.route,
+            };
+        }
+        finally {
+            await page.close();
+        }
+    }
+    /**
+     * Run all tests across all routes.
+     *
+     * @returns Aggregated test results
+     */
+    async runTests() {
+        const startTime = Date.now();
+        try {
+            // Discover and filter routes
+            const allRoutes = await this.discoverRoutes();
+            const routes = this.filterRoutes(allRoutes);
+            if (routes.length === 0) {
+                throw new Error('No routes to test');
+            }
+            console.log(`Discovered ${routes.length} routes to test`);
+            // Get viewports to test
+            const browserConfig = this.config.browser || {};
+            const viewports = browserConfig.viewports || [
+                browserConfig.viewport
+                    ? { name: 'default', ...browserConfig.viewport }
+                    : types_1.ViewportPresets.Desktop
+            ];
+            console.log(`Testing with ${viewports.length} viewport(s): ${viewports.map(v => v.name).join(', ')}`);
+            // Initialize browser
+            await this.initBrowser();
+            // Execute tests
+            const resultsByRoute = new Map();
+            const resultsByMode = new Map();
+            const allErrors = [];
+            // Test each viewport
+            for (const viewport of viewports) {
+                console.log(`\n📱 Testing viewport: ${viewport.name} (${viewport.width}x${viewport.height})`);
+                for (const route of routes) {
+                    const routeKey = viewports.length > 1
+                        ? `${route.route} [${viewport.name}]`
+                        : route.route;
+                    console.log(`  Testing route: ${routeKey}`);
+                    const routeResults = [];
+                    for (const [mode, testFunction] of this.testFunctions) {
+                        console.log(`    Running ${mode} test...`);
+                        const result = await this.applyTestFunction(route, testFunction, viewport);
+                        routeResults.push(result);
+                        // Aggregate by mode
+                        if (!resultsByMode.has(mode)) {
+                            resultsByMode.set(mode, []);
+                        }
+                        resultsByMode.get(mode).push(result);
+                        // Collect errors
+                        allErrors.push(...result.errors);
+                    }
+                    resultsByRoute.set(routeKey, routeResults);
+                }
+            }
+            // Calculate statistics
+            const testCount = routes.length * this.testFunctions.size * viewports.length;
+            const passedCount = Array.from(resultsByRoute.values())
+                .flat()
+                .filter((r) => r.passed).length;
+            const failedCount = testCount - passedCount;
+            const passRate = testCount > 0 ? Math.round((passedCount / testCount) * 100) : 0;
+            return {
+                routeCount: routes.length,
+                testCount,
+                passedCount,
+                failedCount,
+                passRate,
+                totalDuration: Date.now() - startTime,
+                resultsByRoute,
+                resultsByMode,
+                errors: allErrors,
+                timestamp: new Date(),
+                config: this.config,
+            };
+        }
+        finally {
+            await this.closeBrowser();
+        }
+    }
+    /**
+     * Get registered test functions.
+     */
+    getTestFunctions() {
+        return Array.from(this.testFunctions.values());
+    }
+    /**
+     * Get configuration.
+     */
+    getConfig() {
+        return this.config;
+    }
+}
+exports.GraphTester = GraphTester;
+//# sourceMappingURL=GraphTester.js.map

package/dist/cjs/src/testing/graph-tester/core/GraphTester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphTester.js","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/core/GraphTester.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/testing/graph-tester/core/TestFunction.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Abstract base class for all test functions.
+ *
+ * Test functions implement specific testing modes (visual regression, performance, accessibility, etc.).
+ * Each test function:
+ * 1. Receives a Playwright page and test context
+ * 2. Performs its testing logic
+ * 3. Returns a TestResult with pass/fail status and metadata
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestFunction = void 0;
+exports.isTestFunction = isTestFunction;
+/**
+ * Abstract base class for test functions.
+ *
+ * @example
+ * ```typescript
+ * class VisualRegressionMode extends TestFunction {
+ *   mode = 'visual';
+ *
+ *   async execute(page: Page, context: TestContext): Promise<TestResult> {
+ *     const startTime = Date.now();
+ *     const screenshot = await page.screenshot({ fullPage: true });
+ *
+ *     return {
+ *       passed: true,
+ *       duration: Date.now() - startTime,
+ *       errors: [],
+ *       metadata: {
+ *         screenshot,
+ *         screenshotPath: './screenshots/example.png'
+ *       }
+ *     };
+ *   }
+ * }
+ * ```
+ */
+class TestFunction {
+    /**
+     * Execute the full test lifecycle: setup, execute, teardown.
+     * This method handles the orchestration and error handling.
+     *
+     * @param page - Playwright page instance
+     * @param context - Test context
+     * @returns Test result
+     */
+    async run(page, context) {
+        const startTime = Date.now();
+        const errors = [];
+        try {
+            // Check if we should test this route
+            if (this.shouldTest && !this.shouldTest(context)) {
+                return {
+                    passed: true,
+                    duration: Date.now() - startTime,
+                    errors: [],
+                    metadata: {
+                        skipped: true,
+                        reason: 'Skipped by shouldTest() predicate',
+                    },
+                    mode: this.mode,
+                    route: context.route,
+                };
+            }
+            // Setup
+            if (this.setup) {
+                try {
+                    await this.setup(page);
+                }
+                catch (error) {
+                    errors.push({
+                        severity: 'critical',
+                        message: `Setup failed: ${error instanceof Error ? error.message : String(error)}`,
+                        stack: error instanceof Error ? error.stack : undefined,
+                    });
+                    return {
+                        passed: false,
+                        duration: Date.now() - startTime,
+                        errors,
+                        metadata: {},
+                        mode: this.mode,
+                        route: context.route,
+                    };
+                }
+            }
+            // Execute
+            let result;
+            try {
+                result = await this.execute(page, context);
+            }
+            catch (error) {
+                errors.push({
+                    severity: 'critical',
+                    message: `Execution failed: ${error instanceof Error ? error.message : String(error)}`,
+                    stack: error instanceof Error ? error.stack : undefined,
+                });
+                result = {
+                    passed: false,
+                    duration: Date.now() - startTime,
+                    errors,
+                    metadata: {},
+                };
+            }
+            // Teardown
+            if (this.teardown) {
+                try {
+                    await this.teardown(page);
+                }
+                catch (error) {
+                    errors.push({
+                        severity: 'warning',
+                        message: `Teardown failed: ${error instanceof Error ? error.message : String(error)}`,
+                        stack: error instanceof Error ? error.stack : undefined,
+                    });
+                }
+            }
+            // Merge errors and add metadata
+            return {
+                ...result,
+                errors: [...errors, ...result.errors],
+                mode: this.mode,
+                route: context.route,
+            };
+        }
+        catch (error) {
+            // Catch-all for unexpected errors
+            return {
+                passed: false,
+                duration: Date.now() - startTime,
+                errors: [
+                    ...errors,
+                    {
+                        severity: 'critical',
+                        message: `Unexpected error: ${error instanceof Error ? error.message : String(error)}`,
+                        stack: error instanceof Error ? error.stack : undefined,
+                    },
+                ],
+                metadata: {},
+                mode: this.mode,
+                route: context.route,
+            };
+        }
+    }
+    /**
+     * Validate test function configuration.
+     * Override to add custom validation logic.
+     *
+     * @returns Array of validation errors (empty if valid)
+     */
+    validate() {
+        const errors = [];
+        if (!this.mode) {
+            errors.push('mode is required');
+        }
+        if (!this.name) {
+            errors.push('name is required');
+        }
+        if (!this.description) {
+            errors.push('description is required');
+        }
+        return errors;
+    }
+    /**
+     * Get test function info for reporting.
+     */
+    getInfo() {
+        return {
+            mode: this.mode,
+            name: this.name,
+            description: this.description,
+        };
+    }
+}
+exports.TestFunction = TestFunction;
+/**
+ * Type guard to check if an object is a TestFunction.
+ */
+function isTestFunction(obj) {
+    return (obj &&
+        typeof obj === 'object' &&
+        typeof obj.mode === 'string' &&
+        typeof obj.name === 'string' &&
+        typeof obj.description === 'string' &&
+        typeof obj.execute === 'function');
+}
+//# sourceMappingURL=TestFunction.js.map

package/dist/cjs/src/testing/graph-tester/core/TestFunction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestFunction.js","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/core/TestFunction.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/testing/graph-tester/core/types.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Core types for the graph-based testing framework.
+ *
+ * This file is the contract between all packages - changes require consensus.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewportPresets = void 0;
+/**
+ * Predefined viewport presets.
+ */
+exports.ViewportPresets = {
+    Desktop: { name: 'desktop', width: 1920, height: 1080 },
+    DesktopSmall: { name: 'desktop-small', width: 1366, height: 768 },
+    Laptop: { name: 'laptop', width: 1280, height: 720 },
+    TabletLandscape: { name: 'tablet-landscape', width: 1024, height: 768, isMobile: true, hasTouch: true },
+    TabletPortrait: { name: 'tablet-portrait', width: 768, height: 1024, isMobile: true, hasTouch: true },
+    MobileLarge: { name: 'mobile-large', width: 414, height: 896, isMobile: true, hasTouch: true },
+    Mobile: { name: 'mobile', width: 375, height: 812, isMobile: true, hasTouch: true },
+    MobileSmall: { name: 'mobile-small', width: 320, height: 568, isMobile: true, hasTouch: true },
+};
+//# sourceMappingURL=types.js.map

package/dist/cjs/src/testing/graph-tester/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/core/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAyPH;;GAEG;AACU,QAAA,eAAe,GAAG;IAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACvD,YAAY,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACjE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACpD,eAAe,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACvG,cAAc,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACrG,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACnF,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;CACtF,CAAC"}

package/dist/cjs/src/testing/graph-tester/fixtures/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Fixtures exports.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanupPortPool = exports.expect = exports.test = void 0;
+var portPool_1 = require("./portPool");
+Object.defineProperty(exports, "test", { enumerable: true, get: function () { return portPool_1.test; } });
+Object.defineProperty(exports, "expect", { enumerable: true, get: function () { return portPool_1.expect; } });
+Object.defineProperty(exports, "cleanupPortPool", { enumerable: true, get: function () { return portPool_1.cleanupPortPool; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/testing/graph-tester/fixtures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/fixtures/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,uCAA2D;AAAlD,gGAAA,IAAI,OAAA;AAAE,kGAAA,MAAM,OAAA;AAAE,2GAAA,eAAe,OAAA"}