@testsmith/perfornium 0.1.0

package/dist/reporting/statistics.d.ts

@@ -0,0 +1,144 @@
+import { TestResult } from '../metrics/types';
+import { SLA_DEFAULTS } from './constants';
+/**
+ * Check if a result should be included in statistics (only verifications/measurements)
+ */
+export declare function isMeasurableResult(result: TestResult): boolean;
+export interface ApdexScore {
+    score: number;
+    satisfied: number;
+    tolerating: number;
+    frustrated: number;
+    total: number;
+    rating: 'Excellent' | 'Good' | 'Fair' | 'Poor' | 'Unacceptable';
+}
+export interface SLACompliance {
+    passed: boolean;
+    checks: SLACheck[];
+    summary: string;
+}
+export interface SLACheck {
+    name: string;
+    target: number;
+    actual: number;
+    passed: boolean;
+    unit: string;
+}
+export interface OutlierAnalysis {
+    outliers: OutlierPoint[];
+    outlierCount: number;
+    outlierPercentage: number;
+    lowerBound: number;
+    upperBound: number;
+    method: 'IQR' | 'Z-Score';
+}
+export interface OutlierPoint {
+    value: number;
+    timestamp: number;
+    vu_id: number;
+    step_name?: string;
+    severity: 'mild' | 'extreme';
+}
+export interface ConfidenceInterval {
+    mean: number;
+    lower: number;
+    upper: number;
+    confidenceLevel: number;
+    standardError: number;
+    marginOfError: number;
+}
+export interface HeatmapData {
+    data: number[][];
+    timeLabels: string[];
+    responseTimeLabels: string[];
+    maxValue: number;
+}
+export declare class StatisticsCalculator {
+    /**
+     * Calculate percentiles using linear interpolation (consistent method)
+     */
+    static calculatePercentiles(values: number[], percentiles?: number[]): Record<number, number>;
+    /**
+     * Calculate Apdex (Application Performance Index) score
+     * Industry-standard metric for user satisfaction
+     * Only includes measurable results (verifications, not actions like click/fill)
+     */
+    static calculateApdexScore(results: TestResult[], satisfiedThreshold?: number): ApdexScore;
+    /**
+     * Check SLA compliance against defined thresholds
+     * Only measures verifications, not actions like click/fill
+     */
+    static checkSLACompliance(results: TestResult[], slaConfig?: Partial<typeof SLA_DEFAULTS>): SLACompliance;
+    /**
+     * Detect outliers using IQR method
+     * Only analyzes measurable results (verifications, not actions like click/fill)
+     */
+    static detectOutliers(results: TestResult[]): OutlierAnalysis;
+    /**
+     * Calculate confidence interval for mean response time
+     */
+    static calculateConfidenceInterval(values: number[], confidenceLevel?: number): ConfidenceInterval;
+    /**
+     * Generate heatmap data for response time over time visualization
+     * Only includes measurable results (verifications, not actions like click/fill)
+     */
+    static generateHeatmapData(results: TestResult[], timeBuckets?: number, responseTimeBuckets?: number): HeatmapData;
+    /**
+     * O(n) time-based grouping using Map-based bucketing
+     * FIXED: Replaces O(n²) filter-based implementation
+     */
+    static groupResultsByTime(results: TestResult[], intervalMs?: number): any[];
+    /**
+     * Calculate enhanced statistics including all metrics
+     */
+    static calculateEnhancedStatistics(values: number[]): {
+        count: number;
+        min: number;
+        max: number;
+        mean: number;
+        median: number;
+        stdDev: number;
+        percentiles: Record<number, number>;
+        confidenceInterval: ConfidenceInterval;
+    };
+    static calculateThroughput(results: TestResult[], totalDurationMs: number): number;
+    static calculateErrorRate(results: TestResult[]): number;
+    /**
+     * Calculate aggregated Core Web Vitals statistics
+     */
+    static calculateWebVitalsStatistics(results: TestResult[]): {
+        web_vitals_data?: any;
+        vitals_score?: 'good' | 'needs-improvement' | 'poor';
+        vitals_details?: any;
+    };
+    /**
+     * Enhanced response time distribution with adaptive bucketing
+     * Only includes measurable results (verifications, not actions like click/fill)
+     */
+    static calculateResponseTimeDistribution(results: TestResult[], targetBuckets?: number): any[];
+    /**
+     * Calculate detailed step statistics (single source of truth)
+     * Only includes measurable results (verifications, waits, measurements)
+     * Excludes actions like click, fill, press, goto, select
+     */
+    static calculateDetailedStepStatistics(results: TestResult[]): any[];
+    /**
+     * Calculate error distribution and patterns
+     */
+    static calculateErrorDistribution(results: TestResult[]): any;
+    /**
+     * Calculate performance trends using linear regression
+     * Only analyzes measurable results (verifications, not actions like click/fill)
+     */
+    static calculatePerformanceTrends(results: TestResult[]): any;
+    /**
+     * Get comprehensive analysis of test results
+     */
+    static getComprehensiveAnalysis(results: TestResult[], slaConfig?: Partial<typeof SLA_DEFAULTS>): {
+        apdex: ApdexScore;
+        sla: SLACompliance;
+        outliers: OutlierAnalysis;
+        trends: any;
+        heatmap: HeatmapData;
+    };
+}