0xray 2.1.3 → 2.2.0

package/dist/performance/performance-budget-enforcer.js

@@ -1,434 +0,0 @@
-/**
- * Performance Budget Enforcement System
- *
- * Comprehensive performance testing and monitoring system that enforces
- * Universal Development Codex performance budget requirements.
- *
- * Performance Budget Requirements:
- * - Bundle size <2MB (gzipped <700KB)
- * - First Contentful Paint <2s
- * - Time to Interactive <5s
- *
- * @version 1.0.0
- * @since 2026-01-08
- */
-import { EventEmitter } from "events";
-import * as fs from "fs";
-import * as path from "path";
-import { execSync } from "child_process";
-import { performance } from "perf_hooks";
-import { frameworkLogger } from "../core/framework-logger.js";
-// Performance budget constants from Universal Development Codex
-export const PERFORMANCE_BUDGET = {
-    bundleSize: {
-        uncompressed: 2 * 1024 * 1024, // 2MB
-        gzipped: 700 * 1024, // 700KB
-    },
-    webVitals: {
-        firstContentfulPaint: 2000, // 2s
-        timeToInteractive: 5000, // 5s
-        largestContentfulPaint: 2500, // 2.5s
-        cumulativeLayoutShift: 0.1, // 0.1
-        firstInputDelay: 100, // 100ms
-    },
-    runtime: {
-        memoryUsage: 50 * 1024 * 1024, // 50MB heap usage
-        startupTime: 100, // 100ms
-        testExecutionTime: 5000, // 5s
-    },
-};
-/**
- * Comprehensive performance budget enforcement system
- */
-export class PerformanceBudgetEnforcer extends EventEmitter {
-    reports = [];
-    monitoringActive = false;
-    alertThresholds = {
-        warning: 0.9,
-        error: 1.0,
-        critical: 1.1,
-    };
-    started = false;
-    boundViolation;
-    boundBudgetExceeded;
-    constructor() {
-        super();
-    }
-    start() {
-        if (this.started)
-            return;
-        this.started = true;
-        this.setupEventHandlers();
-    }
-    setupEventHandlers() {
-        this.boundViolation = this.handleViolation.bind(this);
-        this.boundBudgetExceeded = this.handleBudgetExceeded.bind(this);
-        this.on("violation", this.boundViolation);
-        this.on("budget-exceeded", this.boundBudgetExceeded);
-    }
-    destroy() {
-        this.off("violation", this.boundViolation);
-        this.off("budget-exceeded", this.boundBudgetExceeded);
-        this.removeAllListeners();
-    }
-    /**
-     * Analyze bundle size against performance budget
-     */
-    async analyzeBundleSize(distPath = "./dist") {
-        const metrics = {
-            totalSize: 0,
-            gzippedSize: 0,
-            fileCount: 0,
-            largestFile: { name: "", size: 0, gzippedSize: 0 },
-            breakdown: [],
-        };
-        if (!fs.existsSync(distPath)) {
-            throw new Error(`Distribution directory not found: ${distPath}`);
-        }
-        const files = fs.readdirSync(distPath);
-        const jsFiles = files.filter((file) => file.endsWith(".js") || file.endsWith(".mjs"));
-        for (const file of jsFiles) {
-            const filePath = path.join(distPath, file);
-            const stats = fs.statSync(filePath);
-            const size = stats.size;
-            // Calculate gzipped size
-            let gzippedSize = 0;
-            try {
-                const gzipped = execSync(`gzip -c "${filePath}" | wc -c`, {
-                    encoding: "utf8",
-                });
-                gzippedSize = parseInt(gzipped.trim());
-            }
-            catch (error) {
-                frameworkLogger.log("performance-budget-enforcer", "gzip-failed", "warning", { file, error });
-                gzippedSize = size; // Fallback to uncompressed size
-            }
-            metrics.totalSize += size;
-            metrics.gzippedSize += gzippedSize;
-            metrics.fileCount++;
-            // Track largest file
-            if (size > metrics.largestFile.size) {
-                metrics.largestFile = { name: file, size, gzippedSize };
-            }
-            // Add to breakdown
-            metrics.breakdown.push({
-                name: file,
-                size,
-                gzippedSize,
-                percentage: 0, // Will be calculated after all files are processed
-            });
-        }
-        // Calculate percentages
-        metrics.breakdown.forEach((file) => {
-            file.percentage = (file.size / (metrics.totalSize || 1)) * 100;
-        });
-        // Sort breakdown by size descending
-        metrics.breakdown.sort((a, b) => b.size - a.size);
-        return metrics;
-    }
-    /**
-     * Measure web vitals (simulated for server-side framework)
-     * In a real web application, this would use the Web Vitals library
-     */
-    async measureWebVitals() {
-        // For server-side framework, we'll simulate measurements
-        // In a real implementation, this would collect from actual page loads
-        const metrics = {
-            firstContentfulPaint: Math.random() * 1000 + 500, // 500-1500ms
-            timeToInteractive: Math.random() * 2000 + 2000, // 2000-4000ms
-            largestContentfulPaint: Math.random() * 1000 + 1500, // 1500-2500ms
-            cumulativeLayoutShift: Math.random() * 0.1, // 0-0.1
-            firstInputDelay: Math.random() * 50 + 25, // 25-75ms
-            timestamp: Date.now(),
-        };
-        return metrics;
-    }
-    /**
-     * Measure runtime performance metrics
-     */
-    measureRuntimePerformance() {
-        const memUsage = process.memoryUsage();
-        const cpuUsage = process.cpuUsage();
-        return {
-            memoryUsage: {
-                rss: memUsage.rss,
-                heapUsed: memUsage.heapUsed,
-                heapTotal: memUsage.heapTotal,
-                external: memUsage.external,
-            },
-            startupTime: performance.now(), // This would be measured from app start
-            cpuUsage: (cpuUsage.user + cpuUsage.system) / 1000, // Convert to milliseconds
-            timestamp: Date.now(),
-        };
-    }
-    /**
-     * Check performance budget compliance
-     */
-    checkBudgetCompliance(bundleSize, webVitals, runtime) {
-        const violations = [];
-        // Bundle size checks
-        if (bundleSize.totalSize > PERFORMANCE_BUDGET.bundleSize.uncompressed) {
-            violations.push({
-                metric: "bundle-size-uncompressed",
-                actual: bundleSize.totalSize,
-                budget: PERFORMANCE_BUDGET.bundleSize.uncompressed,
-                percentage: (bundleSize.totalSize / PERFORMANCE_BUDGET.bundleSize.uncompressed) *
-                    100,
-                severity: bundleSize.totalSize >
-                    PERFORMANCE_BUDGET.bundleSize.uncompressed * 1.1
-                    ? "critical"
-                    : "error",
-                recommendation: "Reduce bundle size by code splitting, tree shaking, or removing unused dependencies",
-            });
-        }
-        if (bundleSize.gzippedSize > PERFORMANCE_BUDGET.bundleSize.gzipped) {
-            violations.push({
-                metric: "bundle-size-gzipped",
-                actual: bundleSize.gzippedSize,
-                budget: PERFORMANCE_BUDGET.bundleSize.gzipped,
-                percentage: (bundleSize.gzippedSize / PERFORMANCE_BUDGET.bundleSize.gzipped) *
-                    100,
-                severity: bundleSize.gzippedSize > PERFORMANCE_BUDGET.bundleSize.gzipped * 1.1
-                    ? "critical"
-                    : "error",
-                recommendation: "Optimize gzipped bundle size through minification and compression improvements",
-            });
-        }
-        // Web vitals checks (if available)
-        if (webVitals) {
-            if (webVitals.firstContentfulPaint >
-                PERFORMANCE_BUDGET.webVitals.firstContentfulPaint) {
-                violations.push({
-                    metric: "first-contentful-paint",
-                    actual: webVitals.firstContentfulPaint,
-                    budget: PERFORMANCE_BUDGET.webVitals.firstContentfulPaint,
-                    percentage: (webVitals.firstContentfulPaint /
-                        PERFORMANCE_BUDGET.webVitals.firstContentfulPaint) *
-                        100,
-                    severity: webVitals.firstContentfulPaint >
-                        PERFORMANCE_BUDGET.webVitals.firstContentfulPaint * 1.1
-                        ? "critical"
-                        : "error",
-                    recommendation: "Optimize critical rendering path, reduce render-blocking resources",
-                });
-            }
-            if (webVitals.timeToInteractive >
-                PERFORMANCE_BUDGET.webVitals.timeToInteractive) {
-                violations.push({
-                    metric: "time-to-interactive",
-                    actual: webVitals.timeToInteractive,
-                    budget: PERFORMANCE_BUDGET.webVitals.timeToInteractive,
-                    percentage: (webVitals.timeToInteractive /
-                        PERFORMANCE_BUDGET.webVitals.timeToInteractive) *
-                        100,
-                    severity: webVitals.timeToInteractive >
-                        PERFORMANCE_BUDGET.webVitals.timeToInteractive * 1.1
-                        ? "critical"
-                        : "error",
-                    recommendation: "Reduce JavaScript execution time, optimize main thread work",
-                });
-            }
-        }
-        // Runtime checks
-        if (runtime.memoryUsage.heapUsed > PERFORMANCE_BUDGET.runtime.memoryUsage) {
-            violations.push({
-                metric: "memory-usage",
-                actual: runtime.memoryUsage.heapUsed,
-                budget: PERFORMANCE_BUDGET.runtime.memoryUsage,
-                percentage: (runtime.memoryUsage.heapUsed /
-                    PERFORMANCE_BUDGET.runtime.memoryUsage) *
-                    100,
-                severity: runtime.memoryUsage.heapUsed >
-                    PERFORMANCE_BUDGET.runtime.memoryUsage * 1.1
-                    ? "critical"
-                    : "warning",
-                recommendation: "Optimize memory usage through garbage collection improvements or memory leak fixes",
-            });
-        }
-        return violations;
-    }
-    /**
-     * Generate comprehensive performance report
-     */
-    async generatePerformanceReport() {
-        const bundleSize = await this.analyzeBundleSize();
-        const webVitals = await this.measureWebVitals();
-        const runtime = this.measureRuntimePerformance();
-        const violations = this.checkBudgetCompliance(bundleSize, webVitals, runtime);
-        // Generate recommendations based on violations
-        const recommendations = this.generateRecommendations(violations, bundleSize, webVitals, runtime);
-        // Determine overall status
-        const hasCritical = violations.some((v) => v.severity === "critical");
-        const hasError = violations.some((v) => v.severity === "error");
-        const hasWarning = violations.some((v) => v.severity === "warning");
-        let overallStatus = "pass";
-        if (hasCritical || hasError) {
-            overallStatus = "fail";
-        }
-        else if (hasWarning) {
-            overallStatus = "warning";
-        }
-        const report = {
-            timestamp: Date.now(),
-            bundleSize,
-            webVitals,
-            runtime,
-            violations,
-            recommendations,
-            overallStatus,
-        };
-        this.reports.push(report);
-        // Emit events for violations
-        violations.forEach((violation) => {
-            this.emit("violation", violation);
-            if (violation.percentage > 100) {
-                this.emit("budget-exceeded", violation);
-            }
-        });
-        return report;
-    }
-    /**
-     * Generate performance optimization recommendations
-     */
-    generateRecommendations(violations, bundleSize, webVitals, runtime) {
-        const recommendations = [];
-        // Bundle size recommendations
-        if (bundleSize.totalSize >
-            PERFORMANCE_BUDGET.bundleSize.uncompressed * 0.8) {
-            recommendations.push("Consider implementing code splitting to reduce initial bundle size");
-        }
-        if (bundleSize.largestFile.size > bundleSize.totalSize * 0.5) {
-            recommendations.push(`Largest file (${bundleSize.largestFile.name}) is ${((bundleSize.largestFile.size / bundleSize.totalSize) * 100).toFixed(1)}% of bundle - consider splitting or optimizing`);
-        }
-        // Web vitals recommendations
-        if (webVitals && webVitals.firstContentfulPaint > 1500) {
-            recommendations.push("Optimize First Contentful Paint by prioritizing critical CSS and above-the-fold content");
-        }
-        if (webVitals && webVitals.timeToInteractive > 3000) {
-            recommendations.push("Reduce Time to Interactive by minimizing main thread blocking JavaScript");
-        }
-        // Runtime recommendations
-        if (runtime.memoryUsage.heapUsed >
-            PERFORMANCE_BUDGET.runtime.memoryUsage * 0.8) {
-            recommendations.push("Monitor for memory leaks and consider implementing memory optimization strategies");
-        }
-        // Add specific recommendations from violations
-        violations.forEach((violation) => {
-            if (!recommendations.includes(violation.recommendation)) {
-                recommendations.push(violation.recommendation);
-            }
-        });
-        return recommendations;
-    }
-    /**
-     * Handle performance violations
-     */
-    handleViolation(violation) {
-        const severity = violation.severity.toUpperCase();
-        frameworkLogger.log("performance-budget-enforcer", "budget-violation", "warning", {
-            severity,
-            metric: violation.metric,
-            actual: violation.actual.toLocaleString(),
-            budget: violation.budget.toLocaleString(),
-            percentage: violation.percentage.toFixed(1) + "%",
-            recommendation: violation.recommendation,
-        });
-    }
-    /**
-     * Handle budget exceeded events
-     */
-    handleBudgetExceeded(violation) {
-        frameworkLogger.log("performance-budget-enforcer", "budget-exceeded", "error", {
-            metric: violation.metric,
-            percentage: violation.percentage.toFixed(1) + "% of budget",
-        });
-        if (violation.severity === "critical") {
-            frameworkLogger.log("performance-budget-enforcer", "critical-violation", "error", {
-                message: "CRITICAL: This violation requires immediate attention before deployment",
-            });
-        }
-    }
-    /**
-     * Start continuous performance monitoring
-     */
-    startMonitoring(intervalMs = 30000) {
-        if (this.monitoringActive) {
-            return;
-        }
-        this.monitoringActive = true;
-        const monitor = async () => {
-            if (!this.monitoringActive) {
-                return;
-            }
-            try {
-                await this.generatePerformanceReport();
-            }
-            catch (error) {
-                frameworkLogger.log("performance-budget-enforcer", "monitoring-error", "error", { error });
-            }
-            setTimeout(monitor, intervalMs);
-        };
-        // Initial report
-        monitor();
-    }
-    /**
-     * Stop performance monitoring
-     */
-    stopMonitoring() {
-        this.monitoringActive = false;
-    }
-    /**
-     * Get historical performance reports
-     */
-    getReports(limit = 10) {
-        return this.reports.slice(-limit);
-    }
-    /**
-     * Export performance data for analysis
-     */
-    exportPerformanceData() {
-        const summary = {
-            totalReports: this.reports.length,
-            averageViolations: this.reports.length > 0
-                ? this.reports.reduce((sum, r) => sum + r.violations.length, 0) /
-                    this.reports.length
-                : 0,
-            mostCommonViolation: "",
-            trend: "stable",
-        };
-        // Calculate most common violation
-        const violationCounts = {};
-        this.reports.forEach((report) => {
-            report.violations.forEach((violation) => {
-                violationCounts[violation.metric] =
-                    (violationCounts[violation.metric] || 0) + 1;
-            });
-        });
-        const mostCommon = Object.entries(violationCounts).sort(([, a], [, b]) => b - a)[0];
-        summary.mostCommonViolation = mostCommon ? mostCommon[0] : "none";
-        // Calculate trend (simple implementation)
-        if (this.reports.length >= 3) {
-            const recent = this.reports.slice(-3);
-            const violationTrend = recent.map((r) => r.violations.length);
-            if (violationTrend.length >= 3 &&
-                violationTrend[0] !== undefined &&
-                violationTrend[1] !== undefined &&
-                violationTrend[2] !== undefined) {
-                const avgFirst = (violationTrend[0] + violationTrend[1]) / 2;
-                const avgLast = (violationTrend[1] + violationTrend[2]) / 2;
-                if (avgLast < avgFirst) {
-                    summary.trend = "improving";
-                }
-                else if (avgLast > avgFirst) {
-                    summary.trend = "degrading";
-                }
-            }
-        }
-        return {
-            reports: this.reports,
-            summary,
-        };
-    }
-}
-// Export singleton instance
-export const performanceBudgetEnforcer = new PerformanceBudgetEnforcer();

package/dist/performance/performance-regression-tester.d.ts

@@ -1,108 +0,0 @@
-/**
- * Performance Regression Testing
- *
- * Automated testing system that detects performance regressions and
- * enforces performance budget compliance in CI/CD pipelines.
- *
- * @version 1.0.0
- * @since 2026-01-08
- */
-import { PerformanceBudgetEnforcer, PerformanceReport } from "./performance-budget-enforcer.js";
-export interface PerformanceRegressionTest {
-    name: string;
-    description: string;
-    testFunction: () => Promise<void> | void;
-    timeout: number;
-    expectedDuration?: number;
-    tolerance: number;
-}
-export interface RegressionTestResult {
-    testName: string;
-    duration: number;
-    expectedDuration?: number;
-    deviation: number;
-    status: "pass" | "warning" | "fail";
-    error?: string;
-    timestamp: number;
-}
-export interface PerformanceBaseline {
-    testName: string;
-    averageDuration: number;
-    standardDeviation: number;
-    sampleCount: number;
-    lastUpdated: number;
-    tolerance: number;
-}
-export interface RegressionTestSuite {
-    name: string;
-    description: string;
-    tests: PerformanceRegressionTest[];
-    baselineFile: string;
-    failOnRegression: boolean;
-    warningThreshold: number;
-    failureThreshold: number;
-}
-/**
- * Performance regression testing system
- */
-export declare class PerformanceRegressionTester {
-    private baselines;
-    private results;
-    private budgetEnforcer;
-    constructor(budgetEnforcer?: PerformanceBudgetEnforcer);
-    /**
-     * Load performance baselines from file
-     */
-    loadBaselines(baselineFile: string): void;
-    /**
-     * Save performance baselines to file
-     */
-    saveBaselines(baselineFile: string): void;
-    /**
-     * Run a single performance regression test
-     */
-    runRegressionTest(test: PerformanceRegressionTest): Promise<RegressionTestResult>;
-    /**
-     * Run a complete regression test suite
-     */
-    runTestSuite(suite: RegressionTestSuite): Promise<{
-        results: RegressionTestResult[];
-        summary: {
-            totalTests: number;
-            passed: number;
-            warnings: number;
-            failed: number;
-            averageDeviation: number;
-            maxDeviation: number;
-            duration: number;
-        };
-        budgetReport?: PerformanceReport;
-        success: boolean;
-    }>;
-    /**
-     * Update baselines with new test results
-     */
-    private updateBaselines;
-    /**
-     * Generate test suite summary
-     */
-    private generateSummary;
-    /**
-     * Create default performance regression test suite
-     */
-    createDefaultTestSuite(): RegressionTestSuite;
-    /**
-     * Export test results for analysis
-     */
-    exportResults(): {
-        results: RegressionTestResult[];
-        baselines: Record<string, PerformanceBaseline>;
-        summary: {
-            totalTests: number;
-            passRate: number;
-            averageDeviation: number;
-            regressionDetected: boolean;
-        };
-    };
-}
-export declare const performanceRegressionTester: PerformanceRegressionTester;