/**
 * @file Read-side helpers — `getPerformanceMetrics` returns a shallow copy of
 *   the recorded rows, `getPerformanceSummary` rolls them up per operation
 *   (count / total / avg / min / max), and `clearPerformanceMetrics` empties
 *   the array in place.
 */
import type { PerformanceMetrics } from './types';
/**
 * Clear all collected performance metrics.
 *
 * @example
 *   import { clearPerformanceMetrics } from '@socketsecurity/lib/perf/metrics'
 *
 *   clearPerformanceMetrics()
 */
export declare function clearPerformanceMetrics(): void;
/**
 * Get all collected performance metrics. Only available when DEBUG=perf is
 * enabled.
 *
 * @example
 *   import { getPerformanceMetrics } from '@socketsecurity/lib/perf/metrics'
 *
 *   const metrics = getPerformanceMetrics()
 *   console.log(metrics)
 *
 * @returns Array of performance metrics
 */
export declare function getPerformanceMetrics(): PerformanceMetrics[];
/**
 * Get performance summary statistics.
 *
 * @example
 *   import { getPerformanceSummary } from '@socketsecurity/lib/perf/metrics'
 *
 *   const summary = getPerformanceSummary()
 *   console.log(summary)
 *   // {
 *   //   'api-call': { count: 5, total: 1234, avg: 246.8, min: 100, max: 500 },
 *   //   'file-read': { count: 10, total: 50, avg: 5, min: 2, max: 15 }
 *   // }
 *
 * @returns Summary of metrics grouped by operation
 */
export declare function getPerformanceSummary(): Record<string, {
    count: number;
    total: number;
    avg: number;
    min: number;
    max: number;
}>;
