@skillsmith/core 0.5.6 → 0.5.8

package/dist/analysis/memory-monitor.d.ts

@@ -1,199 +0,0 @@
-/**
- * SMI-1308: Memory Monitor
- *
- * Monitors memory usage and triggers cleanup when thresholds are exceeded.
- * Integrates with ParseCache for memory pressure handling.
- *
- * @see docs/internal/architecture/multi-language-analysis.md
- * @module analysis/memory-monitor
- */
-import type { ParseCache } from './cache.js';
-/**
- * Memory usage statistics
- */
-export interface MemoryStats {
-    /** Heap used in bytes */
-    heapUsed: number;
-    /** Total heap size in bytes */
-    heapTotal: number;
-    /** External memory in bytes */
-    external: number;
-    /** ArrayBuffers memory in bytes */
-    arrayBuffers: number;
-    /** Resident set size in bytes */
-    rss: number;
-    /** Memory threshold in bytes */
-    threshold: number;
-    /** Whether currently over threshold */
-    isOverThreshold: boolean;
-}
-/**
- * Result of a cleanup operation
- */
-export interface CleanupResult {
-    /** Whether cleanup was performed */
-    cleaned: boolean;
-    /** Bytes freed (estimated) */
-    freedBytes: number;
-    /** Cleanup reason */
-    reason?: string;
-}
-/**
- * Options for MemoryMonitor
- */
-export interface MemoryMonitorOptions {
-    /** Memory threshold in MB (default: 500) */
-    thresholdMB?: number;
-    /** ParseCache instance for cleanup */
-    cache?: ParseCache;
-    /** Enable verbose logging */
-    verbose?: boolean;
-}
-/**
- * Monitor memory usage and trigger cleanup when needed
- *
- * Provides:
- * - Real-time memory statistics
- * - Automatic cleanup when threshold exceeded
- * - Periodic monitoring with configurable interval
- * - Integration with ParseCache
- *
- * @example
- * ```typescript
- * const cache = new ParseCache({ maxMemoryMB: 200 })
- * const monitor = new MemoryMonitor({
- *   thresholdMB: 500,
- *   cache
- * })
- *
- * // Check memory and cleanup if needed
- * const result = monitor.checkAndCleanup()
- * if (result.cleaned) {
- *   console.log(`Freed ${MemoryMonitor.formatBytes(result.freedBytes)}`)
- * }
- *
- * // Start periodic monitoring
- * const stop = monitor.startMonitoring(10000) // 10 seconds
- *
- * // Later...
- * stop()
- * ```
- */
-export declare class MemoryMonitor {
-    private readonly thresholdBytes;
-    private readonly cache;
-    private readonly verbose;
-    private monitorInterval;
-    private cleanupCount;
-    private totalFreedBytes;
-    constructor(options?: MemoryMonitorOptions);
-    /**
-     * Get current memory statistics
-     *
-     * @returns Current memory usage statistics
-     *
-     * @example
-     * ```typescript
-     * const stats = monitor.getStats()
-     * console.log(`Heap: ${MemoryMonitor.formatBytes(stats.heapUsed)}`)
-     * console.log(`Over threshold: ${stats.isOverThreshold}`)
-     * ```
-     */
-    getStats(): MemoryStats;
-    /**
-     * Check memory and cleanup if needed
-     *
-     * Triggers cleanup when heap usage exceeds threshold.
-     * Clears cache and requests garbage collection.
-     *
-     * @returns Cleanup result with bytes freed
-     *
-     * @example
-     * ```typescript
-     * const result = monitor.checkAndCleanup()
-     * if (result.cleaned) {
-     *   console.log(`Cleaned up ${MemoryMonitor.formatBytes(result.freedBytes)}`)
-     * }
-     * ```
-     */
-    checkAndCleanup(): CleanupResult;
-    /**
-     * Force cleanup regardless of threshold
-     *
-     * Useful for explicit memory management before large operations.
-     *
-     * @returns Cleanup result with bytes freed
-     */
-    forceCleanup(): CleanupResult;
-    /**
-     * Start periodic monitoring
-     *
-     * Checks memory at the specified interval and performs
-     * cleanup when threshold is exceeded.
-     *
-     * @param intervalMs - Monitoring interval in milliseconds (default: 10000)
-     * @returns Stop function to cancel monitoring
-     *
-     * @example
-     * ```typescript
-     * const stop = monitor.startMonitoring(5000)
-     *
-     * // Later, when done...
-     * stop()
-     * ```
-     */
-    startMonitoring(intervalMs?: number): () => void;
-    /**
-     * Stop periodic monitoring
-     */
-    stopMonitoring(): void;
-    /**
-     * Get cleanup count
-     *
-     * @returns Number of cleanups performed
-     */
-    getCleanupCount(): number;
-    /**
-     * Get total bytes freed across all cleanups
-     *
-     * @returns Total bytes freed (estimated)
-     */
-    getTotalFreedBytes(): number;
-    /**
-     * Get monitoring status
-     *
-     * @returns Whether periodic monitoring is active
-     */
-    isMonitoring(): boolean;
-    /**
-     * Get memory threshold
-     *
-     * @returns Threshold in bytes
-     */
-    getThreshold(): number;
-    /**
-     * Reset statistics
-     */
-    resetStats(): void;
-    /**
-     * Format bytes for display
-     *
-     * @param bytes - Number of bytes
-     * @returns Human-readable string
-     *
-     * @example
-     * ```typescript
-     * MemoryMonitor.formatBytes(1024)        // "1.00 KB"
-     * MemoryMonitor.formatBytes(1048576)     // "1.00 MB"
-     * MemoryMonitor.formatBytes(1073741824)  // "1.00 GB"
-     * ```
-     */
-    static formatBytes(bytes: number): string;
-    /**
-     * Get memory usage summary string
-     *
-     * @returns Formatted summary of current memory usage
-     */
-    getSummary(): string;
-}
-//# sourceMappingURL=memory-monitor.d.ts.map

package/dist/analysis/memory-monitor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-monitor.d.ts","sourceRoot":"","sources":["../../src/analysis/memory-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,eAAe,EAAE,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,eAAe,CAAI;gBAEf,OAAO,GAAE,oBAAyB;IAM9C;;;;;;;;;;;OAWG;IACH,QAAQ,IAAI,WAAW;IAavB;;;;;;;;;;;;;;;OAeG;IACH,eAAe,IAAI,aAAa;IA8ChC;;;;;;OAMG;IACH,YAAY,IAAI,aAAa;IA0B7B;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,UAAU,SAAQ,GAAG,MAAM,IAAI;IAe/C;;OAEG;IACH,cAAc,IAAI,IAAI;IAOtB;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;OAIG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;;OAIG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAczC;;;;OAIG;IACH,UAAU,IAAI,MAAM;CAWrB"}

package/dist/analysis/memory-monitor.js

@@ -1,271 +0,0 @@
-/**
- * SMI-1308: Memory Monitor
- *
- * Monitors memory usage and triggers cleanup when thresholds are exceeded.
- * Integrates with ParseCache for memory pressure handling.
- *
- * @see docs/internal/architecture/multi-language-analysis.md
- * @module analysis/memory-monitor
- */
-/**
- * Monitor memory usage and trigger cleanup when needed
- *
- * Provides:
- * - Real-time memory statistics
- * - Automatic cleanup when threshold exceeded
- * - Periodic monitoring with configurable interval
- * - Integration with ParseCache
- *
- * @example
- * ```typescript
- * const cache = new ParseCache({ maxMemoryMB: 200 })
- * const monitor = new MemoryMonitor({
- *   thresholdMB: 500,
- *   cache
- * })
- *
- * // Check memory and cleanup if needed
- * const result = monitor.checkAndCleanup()
- * if (result.cleaned) {
- *   console.log(`Freed ${MemoryMonitor.formatBytes(result.freedBytes)}`)
- * }
- *
- * // Start periodic monitoring
- * const stop = monitor.startMonitoring(10000) // 10 seconds
- *
- * // Later...
- * stop()
- * ```
- */
-export class MemoryMonitor {
-    thresholdBytes;
-    cache;
-    verbose;
-    monitorInterval = null;
-    cleanupCount = 0;
-    totalFreedBytes = 0;
-    constructor(options = {}) {
-        this.thresholdBytes = (options.thresholdMB ?? 500) * 1024 * 1024;
-        this.cache = options.cache ?? null;
-        this.verbose = options.verbose ?? false;
-    }
-    /**
-     * Get current memory statistics
-     *
-     * @returns Current memory usage statistics
-     *
-     * @example
-     * ```typescript
-     * const stats = monitor.getStats()
-     * console.log(`Heap: ${MemoryMonitor.formatBytes(stats.heapUsed)}`)
-     * console.log(`Over threshold: ${stats.isOverThreshold}`)
-     * ```
-     */
-    getStats() {
-        const usage = process.memoryUsage();
-        return {
-            heapUsed: usage.heapUsed,
-            heapTotal: usage.heapTotal,
-            external: usage.external,
-            arrayBuffers: usage.arrayBuffers,
-            rss: usage.rss,
-            threshold: this.thresholdBytes,
-            isOverThreshold: usage.heapUsed > this.thresholdBytes,
-        };
-    }
-    /**
-     * Check memory and cleanup if needed
-     *
-     * Triggers cleanup when heap usage exceeds threshold.
-     * Clears cache and requests garbage collection.
-     *
-     * @returns Cleanup result with bytes freed
-     *
-     * @example
-     * ```typescript
-     * const result = monitor.checkAndCleanup()
-     * if (result.cleaned) {
-     *   console.log(`Cleaned up ${MemoryMonitor.formatBytes(result.freedBytes)}`)
-     * }
-     * ```
-     */
-    checkAndCleanup() {
-        const stats = this.getStats();
-        if (!stats.isOverThreshold) {
-            return { cleaned: false, freedBytes: 0 };
-        }
-        const beforeHeap = stats.heapUsed;
-        if (this.verbose) {
-            console.warn(`[MemoryMonitor] Memory pressure: ${MemoryMonitor.formatBytes(stats.heapUsed)} ` +
-                `(threshold: ${MemoryMonitor.formatBytes(this.thresholdBytes)})`);
-        }
-        // Clear cache if available
-        if (this.cache) {
-            const cacheStats = this.cache.getStats();
-            this.cache.clear();
-            if (this.verbose) {
-                console.warn(`[MemoryMonitor] Cleared cache (${cacheStats.entries} entries)`);
-            }
-        }
-        // Request garbage collection if available
-        if (typeof global.gc === 'function') {
-            global.gc();
-            if (this.verbose) {
-                console.warn('[MemoryMonitor] Triggered garbage collection');
-            }
-        }
-        this.cleanupCount++;
-        const afterUsage = process.memoryUsage();
-        const freedBytes = Math.max(0, beforeHeap - afterUsage.heapUsed);
-        this.totalFreedBytes += freedBytes;
-        return {
-            cleaned: true,
-            freedBytes,
-            reason: `Heap exceeded threshold (${MemoryMonitor.formatBytes(beforeHeap)})`,
-        };
-    }
-    /**
-     * Force cleanup regardless of threshold
-     *
-     * Useful for explicit memory management before large operations.
-     *
-     * @returns Cleanup result with bytes freed
-     */
-    forceCleanup() {
-        const beforeHeap = process.memoryUsage().heapUsed;
-        // Clear cache if available
-        if (this.cache) {
-            this.cache.clear();
-        }
-        // Request garbage collection if available
-        if (typeof global.gc === 'function') {
-            global.gc();
-        }
-        this.cleanupCount++;
-        const afterUsage = process.memoryUsage();
-        const freedBytes = Math.max(0, beforeHeap - afterUsage.heapUsed);
-        this.totalFreedBytes += freedBytes;
-        return {
-            cleaned: true,
-            freedBytes,
-            reason: 'Forced cleanup',
-        };
-    }
-    /**
-     * Start periodic monitoring
-     *
-     * Checks memory at the specified interval and performs
-     * cleanup when threshold is exceeded.
-     *
-     * @param intervalMs - Monitoring interval in milliseconds (default: 10000)
-     * @returns Stop function to cancel monitoring
-     *
-     * @example
-     * ```typescript
-     * const stop = monitor.startMonitoring(5000)
-     *
-     * // Later, when done...
-     * stop()
-     * ```
-     */
-    startMonitoring(intervalMs = 10000) {
-        if (this.monitorInterval) {
-            return () => this.stopMonitoring();
-        }
-        this.monitorInterval = setInterval(() => {
-            this.checkAndCleanup();
-        }, intervalMs);
-        // Prevent interval from keeping process alive
-        this.monitorInterval.unref();
-        return () => this.stopMonitoring();
-    }
-    /**
-     * Stop periodic monitoring
-     */
-    stopMonitoring() {
-        if (this.monitorInterval) {
-            clearInterval(this.monitorInterval);
-            this.monitorInterval = null;
-        }
-    }
-    /**
-     * Get cleanup count
-     *
-     * @returns Number of cleanups performed
-     */
-    getCleanupCount() {
-        return this.cleanupCount;
-    }
-    /**
-     * Get total bytes freed across all cleanups
-     *
-     * @returns Total bytes freed (estimated)
-     */
-    getTotalFreedBytes() {
-        return this.totalFreedBytes;
-    }
-    /**
-     * Get monitoring status
-     *
-     * @returns Whether periodic monitoring is active
-     */
-    isMonitoring() {
-        return this.monitorInterval !== null;
-    }
-    /**
-     * Get memory threshold
-     *
-     * @returns Threshold in bytes
-     */
-    getThreshold() {
-        return this.thresholdBytes;
-    }
-    /**
-     * Reset statistics
-     */
-    resetStats() {
-        this.cleanupCount = 0;
-        this.totalFreedBytes = 0;
-    }
-    /**
-     * Format bytes for display
-     *
-     * @param bytes - Number of bytes
-     * @returns Human-readable string
-     *
-     * @example
-     * ```typescript
-     * MemoryMonitor.formatBytes(1024)        // "1.00 KB"
-     * MemoryMonitor.formatBytes(1048576)     // "1.00 MB"
-     * MemoryMonitor.formatBytes(1073741824)  // "1.00 GB"
-     * ```
-     */
-    static formatBytes(bytes) {
-        const units = ['B', 'KB', 'MB', 'GB'];
-        let size = Math.abs(bytes);
-        let unitIndex = 0;
-        while (size >= 1024 && unitIndex < units.length - 1) {
-            size /= 1024;
-            unitIndex++;
-        }
-        const prefix = bytes < 0 ? '-' : '';
-        return `${prefix}${size.toFixed(2)} ${units[unitIndex]}`;
-    }
-    /**
-     * Get memory usage summary string
-     *
-     * @returns Formatted summary of current memory usage
-     */
-    getSummary() {
-        const stats = this.getStats();
-        return [
-            `Heap: ${MemoryMonitor.formatBytes(stats.heapUsed)} / ${MemoryMonitor.formatBytes(stats.heapTotal)}`,
-            `RSS: ${MemoryMonitor.formatBytes(stats.rss)}`,
-            `Threshold: ${MemoryMonitor.formatBytes(stats.threshold)}`,
-            `Status: ${stats.isOverThreshold ? 'OVER THRESHOLD' : 'OK'}`,
-            `Cleanups: ${this.cleanupCount}`,
-            `Total freed: ${MemoryMonitor.formatBytes(this.totalFreedBytes)}`,
-        ].join(', ');
-    }
-}
-//# sourceMappingURL=memory-monitor.js.map

package/dist/analysis/memory-monitor.js.map

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

package/dist/analysis/metrics.d.ts

@@ -1,103 +0,0 @@
-/**
- * SMI-1337: Analysis Pipeline Metrics and Telemetry
- *
- * Provides metrics collection for the multi-language analysis pipeline:
- * - Files parsed per language (counter)
- * - Parse duration by language (histogram)
- * - Cache hit/miss rates (gauge)
- * - Worker pool utilization (gauge)
- * - Memory usage (gauge)
- * - Error counts by type (counter)
- *
- * @see docs/internal/architecture/multi-language-analysis.md
- * @module analysis/metrics
- */
-import type { SupportedLanguage } from './types.js';
-import type { AnalysisMetricsConfig, AnalysisMetricsSnapshot } from './metrics.types.js';
-import { InMemoryCounter, InMemoryHistogram, InMemoryGauge } from './metrics.implementations.js';
-export type { AnalysisMetricsConfig, AnalysisMetricsSnapshot } from './metrics.types.js';
-/**
- * Analysis Pipeline Metrics Collector
- *
- * Provides comprehensive metrics collection for the multi-language
- * analysis pipeline with graceful fallback when telemetry is unavailable.
- *
- * @example
- * ```typescript
- * const metrics = new AnalysisMetrics()
- *
- * // Record file parse
- * metrics.recordFileParsed('typescript')
- *
- * // Record parse duration
- * metrics.recordParseDuration('typescript', 15.5)
- *
- * // Record cache operations
- * metrics.recordCacheHit()
- * metrics.recordCacheMiss()
- *
- * // Get snapshot
- * const snapshot = metrics.getSnapshot()
- * console.log(`Parse p95: ${snapshot.parseDuration.stats.p95}ms`)
- * ```
- */
-export declare class AnalysisMetrics {
-    private readonly enabled;
-    private readonly prefix;
-    readonly filesParsed: InMemoryCounter;
-    readonly parseDuration: InMemoryHistogram;
-    readonly cacheHits: InMemoryCounter;
-    readonly cacheMisses: InMemoryCounter;
-    readonly cacheSize: InMemoryGauge;
-    readonly workerPoolActive: InMemoryGauge;
-    readonly workerPoolQueued: InMemoryGauge;
-    readonly workerPoolUtilization: InMemoryGauge;
-    readonly memoryHeapUsed: InMemoryGauge;
-    readonly memoryHeapTotal: InMemoryGauge;
-    readonly memoryRss: InMemoryGauge;
-    readonly errorCount: InMemoryCounter;
-    readonly aggregatorFilesProcessed: InMemoryGauge;
-    readonly aggregatorImports: InMemoryGauge;
-    readonly aggregatorExports: InMemoryGauge;
-    readonly aggregatorFunctions: InMemoryGauge;
-    constructor(config?: AnalysisMetricsConfig);
-    /** Check if metrics collection is enabled */
-    isEnabled(): boolean;
-    /** Record a file being parsed */
-    recordFileParsed(language: SupportedLanguage | string): void;
-    /** Record parse duration for a file */
-    recordParseDuration(language: SupportedLanguage | string, durationMs: number): void;
-    /** Record a cache hit */
-    recordCacheHit(language?: SupportedLanguage | string): void;
-    /** Record a cache miss */
-    recordCacheMiss(language?: SupportedLanguage | string): void;
-    /** Update cache size */
-    updateCacheSize(size: number, entries?: number): void;
-    /** Update worker pool metrics */
-    updateWorkerPool(activeWorkers: number, queuedTasks: number, poolSize?: number): void;
-    /** Update memory usage metrics */
-    updateMemoryUsage(): void;
-    /** Record an error */
-    recordError(errorType: string, language?: SupportedLanguage | string): void;
-    /** Update aggregator metrics */
-    updateAggregatorStats(filesProcessed: number, imports: number, exports: number, functions: number): void;
-    /** Get cache hit rate */
-    getCacheHitRate(): number;
-    /** Get files parsed by language */
-    getFilesByLanguage(): Record<string, number>;
-    /** Get parse duration stats by language */
-    getParseDurationByLanguage(language: SupportedLanguage | string): ReturnType<InMemoryHistogram['getStats']>;
-    /** Get complete metrics snapshot */
-    getSnapshot(): AnalysisMetricsSnapshot;
-    /** Reset all metrics */
-    reset(): void;
-}
-/** Get the default analysis metrics instance */
-export declare function getAnalysisMetrics(): AnalysisMetrics;
-/** Initialize the default analysis metrics instance */
-export declare function initializeAnalysisMetrics(config?: AnalysisMetricsConfig): AnalysisMetrics;
-/** Helper: Time an async operation and record to analysis metrics */
-export declare function timeParseAsync<T>(language: SupportedLanguage | string, fn: () => Promise<T>, metrics?: AnalysisMetrics): Promise<T>;
-/** Helper: Time a sync operation and record to analysis metrics */
-export declare function timeParseSync<T>(language: SupportedLanguage | string, fn: () => T, metrics?: AnalysisMetrics): T;
-//# sourceMappingURL=metrics.d.ts.map

package/dist/analysis/metrics.d.ts.map

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

package/dist/analysis/metrics.implementations.d.ts

@@ -1,39 +0,0 @@
-/**
- * In-Memory Metrics Implementations
- * @module analysis/metrics.implementations
- */
-import type { Counter, Histogram, Gauge, MetricLabels } from '../telemetry/metrics.js';
-import type { HistogramStats } from './metrics.types.js';
-/**
- * In-memory counter implementation
- */
-export declare class InMemoryCounter implements Counter {
-    private values;
-    add(value: number, labels?: MetricLabels): void;
-    increment(labels?: MetricLabels): void;
-    getValues(): Map<string, number>;
-    getTotal(): number;
-    reset(): void;
-}
-/**
- * In-memory histogram implementation
- */
-export declare class InMemoryHistogram implements Histogram {
-    private values;
-    private labeledValues;
-    record(value: number, labels?: MetricLabels): void;
-    getStats(): HistogramStats;
-    getStatsByLabel(labels: MetricLabels): HistogramStats;
-    reset(): void;
-}
-/**
- * In-memory gauge implementation
- */
-export declare class InMemoryGauge implements Gauge {
-    private values;
-    set(value: number, labels?: MetricLabels): void;
-    getValue(labels?: MetricLabels): number;
-    getAllValues(): Map<string, number>;
-    reset(): void;
-}
-//# sourceMappingURL=metrics.implementations.d.ts.map

package/dist/analysis/metrics.implementations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics.implementations.d.ts","sourceRoot":"","sources":["../../src/analysis/metrics.implementations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD;;GAEG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,OAAO,CAAC,MAAM,CAA4B;IAE1C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAM/C,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAItC,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIhC,QAAQ,IAAI,MAAM;IAQlB,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,aAAa,CAA8B;IAEnD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAUlD,QAAQ,IAAI,cAAc;IAwB1B,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc;IA2BrD,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,KAAK;IACzC,OAAO,CAAC,MAAM,CAA4B;IAE1C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAK/C,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;IAKvC,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAInC,KAAK,IAAI,IAAI;CAGd"}