bootifyjs 1.2.0 → 1.3.0

package/dist/events/config/buffered-event-config.d.ts

@@ -0,0 +1,153 @@
+import { EventPriority } from '../shared-buffer';
+/**
+ * Configuration for buffered event processing system
+ */
+export interface BufferedEventConfig {
+    /** Enable/disable buffered event processing */
+    enabled: boolean;
+    /** Number of worker threads to spawn */
+    workerCount: number;
+    /** Maximum number of events in queue */
+    maxQueueSize: number;
+    /** Maximum memory allocation in MB */
+    maxMemoryMB: number;
+    /** Maximum size per event in bytes */
+    maxEventSize: number;
+    /** Maximum retry attempts before moving to DLQ */
+    retryAttempts: number;
+    /** Retry delays in milliseconds (exponential backoff) */
+    retryDelays: number[];
+    /** Priority configuration */
+    priorities: {
+        critical: number;
+        normal: number;
+        low: number;
+    };
+    /** Memory limits */
+    memoryLimits: MemoryLimits;
+    /** Performance limits */
+    performanceLimits: PerformanceLimits;
+    /** Reliability limits */
+    reliabilityLimits: ReliabilityLimits;
+    /** Monitoring configuration */
+    monitoring: MonitoringConfig;
+    /** Fallback to synchronous processing if workers fail */
+    fallbackToSync: boolean;
+}
+/**
+ * Memory constraint configuration
+ */
+export interface MemoryLimits {
+    /** Maximum events in buffer */
+    maxQueueSize: number;
+    /** Maximum size per event in bytes */
+    maxEventSize: number;
+    /** Total memory allocation in MB */
+    totalMemoryMB: number;
+    /** Per-worker heap limit in MB */
+    workerHeapMB: number;
+}
+/**
+ * Performance constraint configuration
+ */
+export interface PerformanceLimits {
+    /** Maximum input rate (events/sec) */
+    maxInputRate: number;
+    /** Target processing rate (events/sec) */
+    targetProcessingRate: number;
+    /** Maximum CPU usage on main thread (%) */
+    maxMainThreadImpact: number;
+    /** Maximum queue latency for 95th percentile (ms) */
+    maxQueueLatency: number;
+}
+/**
+ * Reliability constraint configuration
+ */
+export interface ReliabilityLimits {
+    /** Maximum retry attempts before DLQ */
+    maxRetryAttempts: number;
+    /** Delay before restarting failed worker (ms) */
+    workerRestartDelay: number;
+    /** Interval between health checks (ms) */
+    healthCheckInterval: number;
+    /** Timeout for graceful shutdown (ms) */
+    gracefulShutdownTimeout: number;
+}
+/**
+ * Monitoring and metrics configuration
+ */
+export interface MonitoringConfig {
+    /** Enable metrics collection */
+    enabled: boolean;
+    /** Metrics collection interval (ms) */
+    metricsInterval: number;
+    /** Enable health monitoring */
+    healthMonitoring: boolean;
+    /** Health check interval (ms) */
+    healthCheckInterval: number;
+    /** Alert thresholds */
+    alertThresholds: AlertThresholds;
+}
+/**
+ * Alert threshold configuration
+ */
+export interface AlertThresholds {
+    /** Queue depth warning threshold */
+    queueDepthWarning: number;
+    /** Processing rate degradation threshold (events/sec) */
+    processingRateMin: number;
+    /** Maximum failed workers before alert */
+    maxFailedWorkers: number;
+    /** Dead letter queue size alert threshold */
+    dlqSizeAlert: number;
+    /** Main thread CPU usage alert threshold (%) */
+    mainThreadCpuAlert: number;
+}
+/**
+ * Default configuration for buffered event processing
+ */
+export declare const defaultBufferedEventConfig: BufferedEventConfig;
+/**
+ * Configuration validator
+ */
+export declare class BufferedEventConfigValidator {
+    /**
+     * Validate configuration and return errors if any
+     */
+    static validate(config: Partial<BufferedEventConfig>): string[];
+    /**
+     * Merge user config with defaults
+     */
+    static mergeWithDefaults(userConfig: Partial<BufferedEventConfig>): BufferedEventConfig;
+}
+/**
+ * Environment-based configuration loader
+ */
+export declare class BufferedEventConfigLoader {
+    /**
+     * Load configuration from environment variables
+     */
+    static fromEnvironment(): Partial<BufferedEventConfig>;
+    /**
+     * Load configuration from file
+     */
+    static fromFile(filePath: string): Partial<BufferedEventConfig>;
+}
+/**
+ * Priority helper functions
+ */
+export declare class PriorityHelper {
+    /**
+     * Get numeric priority value
+     */
+    static getPriorityValue(priority: EventPriority, config: BufferedEventConfig): number;
+    /**
+     * Compare priorities (higher number = higher priority)
+     */
+    static comparePriorities(a: EventPriority, b: EventPriority, config: BufferedEventConfig): number;
+    /**
+     * Check if priority is valid
+     */
+    static isValidPriority(priority: string): priority is EventPriority;
+}
+//# sourceMappingURL=buffered-event-config.d.ts.map

package/dist/events/config/buffered-event-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffered-event-config.d.ts","sourceRoot":"","sources":["../../../src/events/config/buffered-event-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IAEjB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IAErB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IAEtB,yDAAyD;IACzD,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,6BAA6B;IAC7B,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IAEF,oBAAoB;IACpB,YAAY,EAAE,YAAY,CAAC;IAE3B,yBAAyB;IACzB,iBAAiB,EAAE,iBAAiB,CAAC;IAErC,yBAAyB;IACzB,iBAAiB,EAAE,iBAAiB,CAAC;IAErC,+BAA+B;IAC/B,UAAU,EAAE,gBAAgB,CAAC;IAE7B,yDAAyD;IACzD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IAErB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IAEtB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IAErB,0CAA0C;IAC1C,oBAAoB,EAAE,MAAM,CAAC;IAE7B,2CAA2C;IAC3C,mBAAmB,EAAE,MAAM,CAAC;IAE5B,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,iDAAiD;IACjD,kBAAkB,EAAE,MAAM,CAAC;IAE3B,0CAA0C;IAC1C,mBAAmB,EAAE,MAAM,CAAC;IAE5B,yCAAyC;IACzC,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IAEjB,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IAExB,+BAA+B;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAE1B,iCAAiC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,uBAAuB;IACvB,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IAEzB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IAErB,gDAAgD;IAChD,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,mBA6CxC,CAAC;AAEF;;GAEG;AACH,qBAAa,4BAA4B;IACvC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,MAAM,EAAE;IA8B/D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,mBAAmB;CA0BxF;AAED;;GAEG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC;IA0BtD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAUhE;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM;IAIrF;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM;IAMjG;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,aAAa;CAGpE"}

package/dist/events/config/buffered-event-config.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PriorityHelper = exports.BufferedEventConfigLoader = exports.BufferedEventConfigValidator = exports.defaultBufferedEventConfig = void 0;
+/**
+ * Default configuration for buffered event processing
+ */
+exports.defaultBufferedEventConfig = {
+    enabled: true,
+    workerCount: 5,
+    maxQueueSize: 10000,
+    maxMemoryMB: 50,
+    maxEventSize: 5120, // 5KB
+    retryAttempts: 3,
+    retryDelays: [1000, 2000, 4000], // 1s, 2s, 4s
+    priorities: {
+        critical: 3,
+        normal: 2,
+        low: 1
+    },
+    memoryLimits: {
+        maxQueueSize: 10000,
+        maxEventSize: 5120,
+        totalMemoryMB: 50,
+        workerHeapMB: 100
+    },
+    performanceLimits: {
+        maxInputRate: 1000,
+        targetProcessingRate: 500,
+        maxMainThreadImpact: 5,
+        maxQueueLatency: 100
+    },
+    reliabilityLimits: {
+        maxRetryAttempts: 3,
+        workerRestartDelay: 1000,
+        healthCheckInterval: 5000,
+        gracefulShutdownTimeout: 10000
+    },
+    monitoring: {
+        enabled: true,
+        metricsInterval: 1000,
+        healthMonitoring: true,
+        healthCheckInterval: 5000,
+        alertThresholds: {
+            queueDepthWarning: 8000,
+            processingRateMin: 0, // Set to 0 to prevent alerts when no events are being processed
+            maxFailedWorkers: 1,
+            dlqSizeAlert: 100,
+            mainThreadCpuAlert: 10
+        }
+    },
+    fallbackToSync: true
+};
+/**
+ * Configuration validator
+ */
+class BufferedEventConfigValidator {
+    /**
+     * Validate configuration and return errors if any
+     */
+    static validate(config) {
+        const errors = [];
+        if (config.workerCount && (config.workerCount < 1 || config.workerCount > 20)) {
+            errors.push('workerCount must be between 1 and 20');
+        }
+        if (config.maxQueueSize && config.maxQueueSize < 100) {
+            errors.push('maxQueueSize must be at least 100');
+        }
+        if (config.maxEventSize && config.maxEventSize < 1024) {
+            errors.push('maxEventSize must be at least 1KB');
+        }
+        if (config.maxMemoryMB && config.maxMemoryMB < 10) {
+            errors.push('maxMemoryMB must be at least 10MB');
+        }
+        if (config.retryAttempts && (config.retryAttempts < 0 || config.retryAttempts > 10)) {
+            errors.push('retryAttempts must be between 0 and 10');
+        }
+        if (config.retryDelays && config.retryDelays.some(delay => delay < 100)) {
+            errors.push('All retry delays must be at least 100ms');
+        }
+        return errors;
+    }
+    /**
+     * Merge user config with defaults
+     */
+    static mergeWithDefaults(userConfig) {
+        return {
+            ...exports.defaultBufferedEventConfig,
+            ...userConfig,
+            memoryLimits: {
+                ...exports.defaultBufferedEventConfig.memoryLimits,
+                ...userConfig.memoryLimits
+            },
+            performanceLimits: {
+                ...exports.defaultBufferedEventConfig.performanceLimits,
+                ...userConfig.performanceLimits
+            },
+            reliabilityLimits: {
+                ...exports.defaultBufferedEventConfig.reliabilityLimits,
+                ...userConfig.reliabilityLimits
+            },
+            monitoring: {
+                ...exports.defaultBufferedEventConfig.monitoring,
+                ...userConfig.monitoring,
+                alertThresholds: {
+                    ...exports.defaultBufferedEventConfig.monitoring.alertThresholds,
+                    ...userConfig.monitoring?.alertThresholds
+                }
+            }
+        };
+    }
+}
+exports.BufferedEventConfigValidator = BufferedEventConfigValidator;
+/**
+ * Environment-based configuration loader
+ */
+class BufferedEventConfigLoader {
+    /**
+     * Load configuration from environment variables
+     */
+    static fromEnvironment() {
+        const config = {};
+        if (process.env.BUFFERED_EVENTS_ENABLED) {
+            config.enabled = process.env.BUFFERED_EVENTS_ENABLED === 'true';
+        }
+        if (process.env.BUFFERED_EVENTS_WORKER_COUNT) {
+            config.workerCount = parseInt(process.env.BUFFERED_EVENTS_WORKER_COUNT, 10);
+        }
+        if (process.env.BUFFERED_EVENTS_MAX_QUEUE_SIZE) {
+            config.maxQueueSize = parseInt(process.env.BUFFERED_EVENTS_MAX_QUEUE_SIZE, 10);
+        }
+        if (process.env.BUFFERED_EVENTS_MAX_MEMORY_MB) {
+            config.maxMemoryMB = parseInt(process.env.BUFFERED_EVENTS_MAX_MEMORY_MB, 10);
+        }
+        if (process.env.BUFFERED_EVENTS_RETRY_ATTEMPTS) {
+            config.retryAttempts = parseInt(process.env.BUFFERED_EVENTS_RETRY_ATTEMPTS, 10);
+        }
+        return config;
+    }
+    /**
+     * Load configuration from file
+     */
+    static fromFile(filePath) {
+        try {
+            const fs = require('fs');
+            const configData = fs.readFileSync(filePath, 'utf8');
+            return JSON.parse(configData);
+        }
+        catch (error) {
+            console.warn(`Failed to load buffered event config from ${filePath}:`, error);
+            return {};
+        }
+    }
+}
+exports.BufferedEventConfigLoader = BufferedEventConfigLoader;
+/**
+ * Priority helper functions
+ */
+class PriorityHelper {
+    /**
+     * Get numeric priority value
+     */
+    static getPriorityValue(priority, config) {
+        return config.priorities[priority] || config.priorities.normal;
+    }
+    /**
+     * Compare priorities (higher number = higher priority)
+     */
+    static comparePriorities(a, b, config) {
+        const priorityA = this.getPriorityValue(a, config);
+        const priorityB = this.getPriorityValue(b, config);
+        return priorityB - priorityA; // Higher priority first
+    }
+    /**
+     * Check if priority is valid
+     */
+    static isValidPriority(priority) {
+        return ['critical', 'normal', 'low'].includes(priority);
+    }
+}
+exports.PriorityHelper = PriorityHelper;
+//# sourceMappingURL=buffered-event-config.js.map

package/dist/events/config/buffered-event-config.js.map

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

package/dist/events/index.d.ts

@@ -1,5 +1,8 @@
 export * from './bootstrap';
 export * from './event-bus.service';
+export * from './buffered-event-bus.service';
 export * from './event.types';
 export * from './decorators';
+export * from './shared-buffer';
+export * from './config/buffered-event-config';
 //# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gCAAgC,CAAA"}

package/dist/events/index.js

@@ -16,6 +16,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./bootstrap"), exports);
 __exportStar(require("./event-bus.service"), exports);
+__exportStar(require("./buffered-event-bus.service"), exports);
 __exportStar(require("./event.types"), exports);
 __exportStar(require("./decorators"), exports);
+__exportStar(require("./shared-buffer"), exports);
+__exportStar(require("./config/buffered-event-config"), exports);
 //# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,sDAAmC;AACnC,gDAA6B;AAC7B,+CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,sDAAmC;AACnC,+DAA4C;AAC5C,gDAA6B;AAC7B,+CAA4B;AAC5B,kDAA+B;AAC/B,iEAA8C"}

package/dist/events/metrics/event-metrics.d.ts

@@ -0,0 +1,175 @@
+import { EventPriority } from '../shared-buffer';
+import { BufferedEventConfig } from '../config/buffered-event-config';
+import { RetryStats } from '../retry/retry-handler';
+/**
+ * Worker status information
+ */
+export interface WorkerStatus {
+    id: string;
+    pid: number;
+    status: 'running' | 'idle' | 'error' | 'restarting';
+    eventsProcessed: number;
+    lastActivity: number;
+    memoryUsage: number;
+    cpuUsage: number;
+    errors: number;
+    uptime: number;
+}
+/**
+ * Queue metrics by priority
+ */
+export interface PriorityQueueMetrics {
+    critical: number;
+    normal: number;
+    low: number;
+}
+/**
+ * Performance metrics
+ */
+export interface PerformanceMetrics {
+    /** Average processing time per event (ms) */
+    averageProcessingTime: number;
+    /** 95th percentile processing time (ms) */
+    p95ProcessingTime: number;
+    /** Queue latency (time from enqueue to dequeue) */
+    averageQueueLatency: number;
+    /** Throughput metrics */
+    inputRate: number;
+    processingRate: number;
+    /** Main thread impact */
+    mainThreadCpuUsage: number;
+    mainThreadMemoryUsage: number;
+}
+/**
+ * Comprehensive event system metrics
+ */
+export interface EventMetrics {
+    /** Timestamp of metrics collection */
+    timestamp: number;
+    /** Queue metrics */
+    queueDepth: number;
+    queueDepthByPriority: PriorityQueueMetrics;
+    queueUtilization: number;
+    /** Throughput metrics */
+    eventsEnqueued: number;
+    eventsProcessed: number;
+    eventsDropped: number;
+    processingRate: number;
+    /** Performance metrics */
+    performance: PerformanceMetrics;
+    /** Worker health */
+    activeWorkers: number;
+    failedWorkers: number;
+    workerStatuses: WorkerStatus[];
+    /** Error metrics */
+    errorRate: number;
+    deadLetterQueueSize: number;
+    retryStats: RetryStats;
+    /** Resource usage */
+    memoryUsage: number;
+    totalMemoryAllocated: number;
+    memoryUtilization: number;
+}
+/**
+ * Bottleneck detection report
+ */
+export interface BottleneckReport {
+    detected: boolean;
+    type: 'queue_full' | 'slow_processing' | 'worker_failure' | 'memory_pressure' | 'none';
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    description: string;
+    recommendations: string[];
+    metrics: Partial<EventMetrics>;
+}
+/**
+ * Optimization hints
+ */
+export interface OptimizationHint {
+    type: 'scale_workers' | 'increase_memory' | 'optimize_handlers' | 'adjust_priorities';
+    priority: 'low' | 'medium' | 'high';
+    description: string;
+    expectedImpact: string;
+    implementation: string;
+}
+/**
+ * Event metrics collector and analyzer
+ */
+export declare class EventMetricsCollector {
+    private config;
+    private metricsHistory;
+    private maxHistorySize;
+    private eventsEnqueued;
+    private eventsProcessed;
+    private eventsDropped;
+    private processingTimes;
+    private queueLatencies;
+    private workerStatuses;
+    private lastMetricsTime;
+    private lastEventsProcessed;
+    constructor(config: BufferedEventConfig);
+    /**
+     * Record event enqueued
+     */
+    recordEventEnqueued(priority?: EventPriority): void;
+    /**
+     * Record event processed
+     */
+    recordEventProcessed(processingTime: number, queueLatency: number): void;
+    /**
+     * Record event dropped
+     */
+    recordEventDropped(): void;
+    /**
+     * Update worker status
+     */
+    updateWorkerStatus(workerId: string, status: Partial<WorkerStatus>): void;
+    /**
+     * Collect current metrics
+     */
+    collectMetrics(queueDepth: number, queueDepthByPriority: PriorityQueueMetrics, memoryUsage: number, retryStats: RetryStats, deadLetterQueueSize: number): EventMetrics;
+    /**
+     * Calculate performance metrics
+     */
+    private calculatePerformanceMetrics;
+    /**
+     * Calculate percentile from array of numbers
+     */
+    private calculatePercentile;
+    /**
+     * Calculate rate from metrics history
+     */
+    private calculateRate;
+    /**
+     * Estimate main thread CPU usage (simplified)
+     */
+    private estimateMainThreadCpuUsage;
+    /**
+     * Get queue depth by priority
+     */
+    getQueueDepthByPriority(): PriorityQueueMetrics;
+    /**
+     * Get metrics history
+     */
+    getMetricsHistory(limit?: number): EventMetrics[];
+    /**
+     * Reset counters
+     */
+    resetCounters(): void;
+    /**
+     * Clear metrics history
+     */
+    clearHistory(): void;
+    /**
+     * Get current worker count
+     */
+    getWorkerCount(): {
+        active: number;
+        failed: number;
+        total: number;
+    };
+    /**
+     * Remove worker from tracking
+     */
+    removeWorker(workerId: string): void;
+}
+//# sourceMappingURL=event-metrics.d.ts.map

package/dist/events/metrics/event-metrics.d.ts.map

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