@windagency/valora 2.0.1

package/dist/utils/metrics-collector.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Metrics Collector Utility
+ *
+ * Comprehensive metrics collection system for performance monitoring.
+ * Supports counters, gauges, histograms, and timers with automatic aggregation.
+ */
+export interface CounterMetric {
+    description: string;
+    labels?: Record<string, string>;
+    name: string;
+    value: number;
+}
+export interface GaugeMetric {
+    description: string;
+    labels?: Record<string, string>;
+    name: string;
+    value: number;
+}
+export interface HistogramMetric {
+    buckets: Record<string, number>;
+    count: number;
+    description: string;
+    labels?: Record<string, string>;
+    name: string;
+    sum: number;
+}
+export interface MetricsOptions {
+    cleanupInterval?: number;
+    enableHistograms?: boolean;
+    histogramBuckets?: number[];
+    maxMetricsAge?: number;
+}
+export interface MetricsSnapshot {
+    collectionDuration: number;
+    counters: CounterMetric[];
+    gauges: GaugeMetric[];
+    histograms: HistogramMetric[];
+    timestamp: number;
+    uptime: number;
+}
+export interface MetricValue {
+    labels?: Record<string, string>;
+    timestamp: number;
+    value: number;
+}
+export interface TimerResult {
+    duration: number;
+    endTime: number;
+    startTime: number;
+}
+/**
+ * Metrics Collector Class
+ *
+ * Provides comprehensive metrics collection with automatic cleanup and aggregation.
+ */
+export declare class MetricsCollector {
+    private cleanupInterval;
+    private counters;
+    private gauges;
+    private histograms;
+    private options;
+    private startTime;
+    private timers;
+    constructor(options?: MetricsOptions);
+    /**
+     * Increment a counter metric
+     */
+    incrementCounter(name: string, value?: number, labels?: Record<string, string>): void;
+    /**
+     * Set a gauge metric value
+     */
+    setGauge(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * Update a gauge metric by adding to current value
+     */
+    updateGauge(name: string, delta: number, labels?: Record<string, string>): void;
+    /**
+     * Record a histogram observation
+     */
+    observeHistogram(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * Start a timer for measuring operation duration
+     */
+    startTimer(name: string): string;
+    /**
+     * End a timer and record the duration
+     */
+    endTimer(timerId: string, labels?: Record<string, string>): null | TimerResult;
+    /**
+     * Time an async operation automatically
+     */
+    timeAsync<T>(name: string, operation: () => Promise<T>, labels?: Record<string, string>): Promise<T>;
+    /**
+     * Time a sync operation automatically
+     */
+    timeSync<T>(name: string, operation: () => T, labels?: Record<string, string>): T;
+    /**
+     * Get a snapshot of all current metrics
+     */
+    getSnapshot(): MetricsSnapshot;
+    /**
+     * Export metrics in Prometheus format
+     */
+    exportPrometheus(): string;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Get metrics statistics
+     */
+    getStats(): {
+        activeTimers: number;
+        counters: number;
+        gauges: number;
+        histograms: number;
+        uptime: number;
+    };
+    /**
+     * Destroy the collector and clean up resources
+     */
+    destroy(): void;
+    /**
+     * Create a unique key for metrics with labels
+     */
+    private createKey;
+    /**
+     * Convert metric name to Prometheus format
+     */
+    private prometheusName;
+    /**
+     * Format labels for Prometheus
+     */
+    private formatPrometheusLabels;
+    /**
+     * Start automatic cleanup of old metrics
+     */
+    private startCleanup;
+    /**
+     * Clean up old metrics based on age and activity
+     */
+    private cleanup;
+}
+/**
+ * Get the global metrics collector instance
+ */
+export declare function getMetricsCollector(options?: MetricsOptions): MetricsCollector;
+/**
+ * Set a custom global metrics collector instance
+ */
+export declare function setMetricsCollector(collector: MetricsCollector): void;
+/**
+ * Convenience functions for global metrics collection
+ */
+export declare function endTimer(timerId: string, labels?: Record<string, string>): null | TimerResult;
+export declare function exportMetricsPrometheus(): string;
+export declare function getMetricsSnapshot(): MetricsSnapshot;
+export declare function incrementCounter(name: string, value?: number, labels?: Record<string, string>): void;
+export declare function observeHistogram(name: string, value: number, labels?: Record<string, string>): void;
+export declare function setGauge(name: string, value: number, labels?: Record<string, string>): void;
+export declare function startTimer(name: string): string;
+export declare function timeAsync<T>(name: string, operation: () => Promise<T>, labels?: Record<string, string>): Promise<T>;
+export declare function timeSync<T>(name: string, operation: () => T, labels?: Record<string, string>): T;
+export declare function updateGauge(name: string, delta: number, labels?: Record<string, string>): void;
+//# sourceMappingURL=metrics-collector.d.ts.map

package/dist/utils/metrics-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.d.ts","sourceRoot":"","sources":["../../src/utils/metrics-collector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,cAAc;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CAClB;AAaD;;;;GAIG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,MAAM,CAAkC;gBAEpC,OAAO,GAAE,cAAmB;IAKxC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAgBxF;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAW5E;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAQ/E;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAuCpF;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMhC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,WAAW;IAgB9E;;OAEG;IACG,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAa1G;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;IAajF;;OAEG;IACH,WAAW,IAAI,eAAe;IAa9B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAwD1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,QAAQ,IAAI;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KACf;IAUD;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,OAAO;CAwCf;AAKD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAG9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,WAAW,CAE7F;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEpG;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEnG;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAE3F;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEnH;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAEhG;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAE9F"}

package/dist/utils/metrics-collector.js

@@ -0,0 +1,392 @@
+/**
+ * Metrics Collector Utility
+ *
+ * Comprehensive metrics collection system for performance monitoring.
+ * Supports counters, gauges, histograms, and timers with automatic aggregation.
+ */
+/**
+ * Default configuration for metrics collection
+ */
+const DEFAULT_METRICS_OPTIONS = {
+    // 24 hours
+    cleanupInterval: 60 * 60 * 1000,
+    enableHistograms: true,
+    histogramBuckets: [0.1, 0.5, 1, 2.5, 5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000, 10000],
+    maxMetricsAge: 24 * 60 * 60 * 1000 // 1 hour
+};
+/**
+ * Metrics Collector Class
+ *
+ * Provides comprehensive metrics collection with automatic cleanup and aggregation.
+ */
+export class MetricsCollector {
+    cleanupInterval = null;
+    counters = new Map();
+    gauges = new Map();
+    histograms = new Map();
+    options;
+    startTime = Date.now();
+    timers = new Map();
+    constructor(options = {}) {
+        this.options = { ...DEFAULT_METRICS_OPTIONS, ...options };
+        this.startCleanup();
+    }
+    /**
+     * Increment a counter metric
+     */
+    incrementCounter(name, value = 1, labels) {
+        const key = this.createKey(name, labels);
+        const existing = this.counters.get(key);
+        if (existing) {
+            existing.value += value;
+        }
+        else {
+            this.counters.set(key, {
+                description: `${name} counter`,
+                labels,
+                name,
+                value
+            });
+        }
+    }
+    /**
+     * Set a gauge metric value
+     */
+    setGauge(name, value, labels) {
+        const key = this.createKey(name, labels);
+        this.gauges.set(key, {
+            description: `${name} gauge`,
+            labels,
+            name,
+            value
+        });
+    }
+    /**
+     * Update a gauge metric by adding to current value
+     */
+    updateGauge(name, delta, labels) {
+        const key = this.createKey(name, labels);
+        const existing = this.gauges.get(key);
+        const newValue = existing ? existing.value + delta : delta;
+        this.setGauge(name, newValue, labels);
+    }
+    /**
+     * Record a histogram observation
+     */
+    observeHistogram(name, value, labels) {
+        if (!this.options.enableHistograms)
+            return;
+        const key = this.createKey(name, labels);
+        const existing = this.histograms.get(key);
+        if (existing) {
+            existing.count++;
+            existing.sum += value;
+            // Update buckets
+            Object.entries(existing.buckets).forEach(([bucket, count]) => {
+                const bucketValue = parseFloat(bucket);
+                if (value <= bucketValue) {
+                    existing.buckets[bucket] = count + 1;
+                }
+            });
+        }
+        else {
+            // Create new histogram
+            const bucketEntries = [
+                ...this.options.histogramBuckets.map((bucket) => [
+                    bucket.toString(),
+                    value <= bucket ? 1 : 0
+                ]),
+                ['+Inf', 1]
+            ];
+            const buckets = Object.fromEntries(bucketEntries);
+            this.histograms.set(key, {
+                buckets,
+                count: 1,
+                description: `${name} histogram`,
+                labels,
+                name,
+                sum: value
+            });
+        }
+    }
+    /**
+     * Start a timer for measuring operation duration
+     */
+    startTimer(name) {
+        const timerId = `${name}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        this.timers.set(timerId, Date.now());
+        return timerId;
+    }
+    /**
+     * End a timer and record the duration
+     */
+    endTimer(timerId, labels) {
+        const startTime = this.timers.get(timerId);
+        if (!startTime)
+            return null;
+        const endTime = Date.now();
+        const duration = endTime - startTime;
+        this.timers.delete(timerId);
+        // Record in histogram if enabled
+        const timerName = timerId.split('_')[0];
+        this.observeHistogram(`${timerName}_duration`, duration, labels);
+        return { duration, endTime, startTime };
+    }
+    /**
+     * Time an async operation automatically
+     */
+    async timeAsync(name, operation, labels) {
+        const timerId = this.startTimer(name);
+        try {
+            const result = await operation();
+            this.endTimer(timerId, { ...labels, status: 'success' });
+            return result;
+        }
+        catch (error) {
+            this.endTimer(timerId, { ...labels, status: 'error' });
+            this.incrementCounter(`${name}_errors`, 1, labels);
+            throw error;
+        }
+    }
+    /**
+     * Time a sync operation automatically
+     */
+    timeSync(name, operation, labels) {
+        const timerId = this.startTimer(name);
+        try {
+            const result = operation();
+            this.endTimer(timerId, { ...labels, status: 'success' });
+            return result;
+        }
+        catch (error) {
+            this.endTimer(timerId, { ...labels, status: 'error' });
+            this.incrementCounter(`${name}_errors`, 1, labels);
+            throw error;
+        }
+    }
+    /**
+     * Get a snapshot of all current metrics
+     */
+    getSnapshot() {
+        const snapshotStart = Date.now();
+        return {
+            collectionDuration: Date.now() - snapshotStart,
+            counters: Array.from(this.counters.values()),
+            gauges: Array.from(this.gauges.values()),
+            histograms: Array.from(this.histograms.values()),
+            timestamp: Date.now(),
+            uptime: Date.now() - this.startTime
+        };
+    }
+    /**
+     * Export metrics in Prometheus format
+     */
+    exportPrometheus() {
+        const snapshot = this.getSnapshot();
+        const uptimeLines = [
+            `# HELP ai_orchestrator_uptime_seconds Time since metrics collection started`,
+            `# TYPE ai_orchestrator_uptime_seconds gauge`,
+            `ai_orchestrator_uptime_seconds ${snapshot.uptime / 1000}`
+        ];
+        // Export counters
+        const counterLines = snapshot.counters.flatMap((counter) => {
+            const labels = this.formatPrometheusLabels(counter.labels);
+            return [
+                `# HELP ${this.prometheusName(counter.name)} ${counter.description}`,
+                `# TYPE ${this.prometheusName(counter.name)} counter`,
+                `${this.prometheusName(counter.name)}${labels} ${counter.value}`
+            ];
+        });
+        // Export gauges
+        const gaugeLines = snapshot.gauges.flatMap((gauge) => {
+            const labels = this.formatPrometheusLabels(gauge.labels);
+            return [
+                `# HELP ${this.prometheusName(gauge.name)} ${gauge.description}`,
+                `# TYPE ${this.prometheusName(gauge.name)} gauge`,
+                `${this.prometheusName(gauge.name)}${labels} ${gauge.value}`
+            ];
+        });
+        // Export histograms
+        const histogramLines = snapshot.histograms.flatMap((histogram) => {
+            const baseName = this.prometheusName(histogram.name);
+            const labels = this.formatPrometheusLabels(histogram.labels);
+            const bucketLines = Object.entries(histogram.buckets).map(([bucket, count]) => {
+                const bucketLabels = { ...histogram.labels, le: bucket };
+                const bucketLabelStr = this.formatPrometheusLabels(bucketLabels);
+                return `${baseName}_bucket${bucketLabelStr} ${count}`;
+            });
+            return [
+                `# HELP ${baseName}_count ${histogram.description} count`,
+                `# TYPE ${baseName}_count counter`,
+                `${baseName}_count${labels} ${histogram.count}`,
+                `# HELP ${baseName}_sum ${histogram.description} sum`,
+                `# TYPE ${baseName}_sum counter`,
+                `${baseName}_sum${labels} ${histogram.sum}`,
+                `# HELP ${baseName}_bucket ${histogram.description} bucket`,
+                `# TYPE ${baseName}_bucket counter`,
+                ...bucketLines
+            ];
+        });
+        return [...uptimeLines, ...counterLines, ...gaugeLines, ...histogramLines].join('\n');
+    }
+    /**
+     * Reset all metrics
+     */
+    reset() {
+        this.counters.clear();
+        this.gauges.clear();
+        this.histograms.clear();
+        this.timers.clear();
+        this.startTime = Date.now();
+    }
+    /**
+     * Get metrics statistics
+     */
+    getStats() {
+        return {
+            activeTimers: this.timers.size,
+            counters: this.counters.size,
+            gauges: this.gauges.size,
+            histograms: this.histograms.size,
+            uptime: Date.now() - this.startTime
+        };
+    }
+    /**
+     * Destroy the collector and clean up resources
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.reset();
+    }
+    /**
+     * Create a unique key for metrics with labels
+     */
+    createKey(name, labels) {
+        if (!labels)
+            return name;
+        const sortedLabels = Object.keys(labels)
+            .sort()
+            .map((key) => `${key}=${labels[key]}`)
+            .join(',');
+        return `${name}{${sortedLabels}}`;
+    }
+    /**
+     * Convert metric name to Prometheus format
+     */
+    prometheusName(name) {
+        return name
+            .replace(/[^a-zA-Z0-9_]/g, '_')
+            .replace(/^[^a-zA-Z_]/, '_')
+            .toLowerCase();
+    }
+    /**
+     * Format labels for Prometheus
+     */
+    formatPrometheusLabels(labels) {
+        if (!labels || Object.keys(labels).length === 0)
+            return '';
+        const formatted = Object.entries(labels)
+            .map(([key, value]) => `${this.prometheusName(key)}="${value.replace(/"/g, '\\"')}"`)
+            .join(',');
+        return `{${formatted}}`;
+    }
+    /**
+     * Start automatic cleanup of old metrics
+     */
+    startCleanup() {
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, this.options.cleanupInterval);
+        // Allow process to exit even if cleanup interval is active
+        this.cleanupInterval.unref();
+    }
+    /**
+     * Clean up old metrics based on age and activity
+     */
+    cleanup() {
+        const now = Date.now();
+        const maxAge = this.options.maxMetricsAge;
+        // Clean up old timers (unfinished operations)
+        Array.from(this.timers.entries())
+            .filter(([, startTime]) => now - startTime > maxAge)
+            .forEach(([timerId]) => this.timers.delete(timerId));
+        // For gauges and counters, we don't have timestamps, so we use a different approach
+        // In a production system, you might want to track last-update timestamps
+        // For now, we'll implement a simple size-based cleanup to prevent unbounded growth
+        const maxCounters = 1000;
+        const maxGauges = 500;
+        const maxHistograms = 200;
+        // If we exceed size limits, remove oldest entries
+        // This is a simple LRU-style cleanup
+        if (this.counters.size > maxCounters) {
+            const entriesToRemove = this.counters.size - maxCounters;
+            Array.from(this.counters.keys())
+                .slice(0, entriesToRemove)
+                .forEach((key) => this.counters.delete(key));
+        }
+        if (this.gauges.size > maxGauges) {
+            const entriesToRemove = this.gauges.size - maxGauges;
+            Array.from(this.gauges.keys())
+                .slice(0, entriesToRemove)
+                .forEach((key) => this.gauges.delete(key));
+        }
+        if (this.histograms.size > maxHistograms) {
+            const entriesToRemove = this.histograms.size - maxHistograms;
+            Array.from(this.histograms.keys())
+                .slice(0, entriesToRemove)
+                .forEach((key) => this.histograms.delete(key));
+        }
+    }
+}
+// Singleton instance for global use
+let globalMetricsCollector = null;
+/**
+ * Get the global metrics collector instance
+ */
+export function getMetricsCollector(options) {
+    globalMetricsCollector ??= new MetricsCollector(options);
+    return globalMetricsCollector;
+}
+/**
+ * Set a custom global metrics collector instance
+ */
+export function setMetricsCollector(collector) {
+    globalMetricsCollector = collector;
+}
+/**
+ * Convenience functions for global metrics collection
+ */
+export function endTimer(timerId, labels) {
+    return getMetricsCollector().endTimer(timerId, labels);
+}
+export function exportMetricsPrometheus() {
+    return getMetricsCollector().exportPrometheus();
+}
+export function getMetricsSnapshot() {
+    return getMetricsCollector().getSnapshot();
+}
+export function incrementCounter(name, value, labels) {
+    getMetricsCollector().incrementCounter(name, value, labels);
+}
+export function observeHistogram(name, value, labels) {
+    getMetricsCollector().observeHistogram(name, value, labels);
+}
+export function setGauge(name, value, labels) {
+    getMetricsCollector().setGauge(name, value, labels);
+}
+export function startTimer(name) {
+    return getMetricsCollector().startTimer(name);
+}
+export function timeAsync(name, operation, labels) {
+    return getMetricsCollector().timeAsync(name, operation, labels);
+}
+export function timeSync(name, operation, labels) {
+    return getMetricsCollector().timeSync(name, operation, labels);
+}
+export function updateGauge(name, delta, labels) {
+    getMetricsCollector().updateGauge(name, delta, labels);
+}
+//# sourceMappingURL=metrics-collector.js.map

package/dist/utils/metrics-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.js","sourceRoot":"","sources":["../../src/utils/metrics-collector.ts"],"names":[],"mappings":"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"}

package/dist/utils/number-format.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Number formatting utilities
+ *
+ * Formats numbers as:
+ * - 1, 10, 100 for small numbers
+ * - 1k, 1.1k, 10k for thousands
+ * - 1M, 1.1M for millions
+ */
+/**
+ * Format a number for compact display
+ * Examples: 1, 10, 100, 1k, 1.1k, 10k, 100k, 1M, 1.1M
+ */
+export declare function formatNumber(num: number): string;
+/**
+ * Format a number with locale-aware thousand separators
+ * Examples: 1, 10, 100, 1,000, 10,000, 1,000,000
+ */
+export declare function formatNumberWithSeparators(num: number): string;
+/**
+ * Format duration in seconds to human-readable format
+ * Examples: 45s, 2m 30s, 1h 42m 32s, 2d 3h 15m
+ */
+export declare function formatDuration(seconds: number): string;
+/**
+ * Format duration in milliseconds to human-readable format
+ * Examples: 500ms, 45s, 2m 30s, 1h 42m 32s
+ */
+export declare function formatDurationMs(ms: number): string;
+//# sourceMappingURL=number-format.d.ts.map

package/dist/utils/number-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-format.d.ts","sourceRoot":"","sources":["../../src/utils/number-format.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBhD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9D;AAYD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAWtD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKnD"}