node-runtime-guardian 0.1.0

package/dist/plugins/Plugin.d.ts

@@ -0,0 +1,53 @@
+import { RuntimeMetrics } from '../types';
+/**
+ * Base interface for Guardian plugins
+ */
+export interface GuardianPlugin {
+    /**
+     * Called when metrics are updated
+     */
+    onMetricUpdate(data: RuntimeMetrics): void;
+    /**
+     * Called when plugin is registered
+     */
+    onRegister?(): void;
+    /**
+     * Called when plugin is unregistered
+     */
+    onUnregister?(): void;
+    /**
+     * Plugin name
+     */
+    name: string;
+}
+/**
+ * Plugin registry for managing plugins
+ */
+export declare class PluginRegistry {
+    private plugins;
+    /**
+     * Register a plugin
+     */
+    register(plugin: GuardianPlugin): void;
+    /**
+     * Unregister a plugin
+     */
+    unregister(name: string): void;
+    /**
+     * Get a plugin by name
+     */
+    get(name: string): GuardianPlugin | undefined;
+    /**
+     * Get all registered plugins
+     */
+    getAll(): GuardianPlugin[];
+    /**
+     * Notify all plugins of metric update
+     */
+    notifyMetrics(data: RuntimeMetrics): void;
+    /**
+     * Clear all plugins
+     */
+    clear(): void;
+}
+//# sourceMappingURL=Plugin.d.ts.map

package/dist/plugins/Plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/Plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,UAAU,CAAC,IAAI,IAAI,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,IAAI,IAAI,CAAC;IAEtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA0C;IAEzD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAatC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU9B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C;;OAEG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAWzC;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd"}

package/dist/plugins/Plugin.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginRegistry = void 0;
+/**
+ * Plugin registry for managing plugins
+ */
+class PluginRegistry {
+    constructor() {
+        this.plugins = new Map();
+    }
+    /**
+     * Register a plugin
+     */
+    register(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            throw new Error(`Plugin with name "${plugin.name}" is already registered`);
+        }
+        this.plugins.set(plugin.name, plugin);
+        if (plugin.onRegister) {
+            plugin.onRegister();
+        }
+    }
+    /**
+     * Unregister a plugin
+     */
+    unregister(name) {
+        const plugin = this.plugins.get(name);
+        if (plugin) {
+            if (plugin.onUnregister) {
+                plugin.onUnregister();
+            }
+            this.plugins.delete(name);
+        }
+    }
+    /**
+     * Get a plugin by name
+     */
+    get(name) {
+        return this.plugins.get(name);
+    }
+    /**
+     * Get all registered plugins
+     */
+    getAll() {
+        return Array.from(this.plugins.values());
+    }
+    /**
+     * Notify all plugins of metric update
+     */
+    notifyMetrics(data) {
+        this.plugins.forEach((plugin) => {
+            try {
+                plugin.onMetricUpdate(data);
+            }
+            catch (error) {
+                // Silently handle plugin errors to prevent breaking the main flow
+                console.error(`Error in plugin ${plugin.name}:`, error);
+            }
+        });
+    }
+    /**
+     * Clear all plugins
+     */
+    clear() {
+        this.plugins.forEach((plugin) => {
+            if (plugin.onUnregister) {
+                plugin.onUnregister();
+            }
+        });
+        this.plugins.clear();
+    }
+}
+exports.PluginRegistry = PluginRegistry;
+//# sourceMappingURL=Plugin.js.map

package/dist/plugins/Plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/plugins/Plugin.ts"],"names":[],"mappings":";;;AA2BA;;GAEG;AACH,MAAa,cAAc;IAA3B;QACU,YAAO,GAAgC,IAAI,GAAG,EAAE,CAAC;IAsE3D,CAAC;IApEC;;OAEG;IACH,QAAQ,CAAC,MAAsB;QAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,qBAAqB,MAAM,CAAC,IAAI,yBAAyB,CAC1D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACxB,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,IAAoB;QAChC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAC9B,IAAI,CAAC;gBACH,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,kEAAkE;gBAClE,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAC9B,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACxB,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAvED,wCAuEC"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Plugin';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Plugin"), exports);
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB"}

package/dist/server/MetricsServer.d.ts

@@ -0,0 +1,26 @@
+import { Guardian } from '../core/Guardian';
+import { MetricsServerConfig } from '../types';
+/**
+ * HTTP server for exposing metrics endpoint
+ */
+export declare class MetricsServer {
+    private server;
+    private guardian;
+    private config;
+    private isRunning;
+    constructor(guardian: Guardian, config?: MetricsServerConfig);
+    /**
+     * Start the metrics server
+     */
+    start(): void;
+    /**
+     * Stop the metrics server
+     */
+    stop(): void;
+    /**
+     * Check if server is running
+     */
+    getIsRunning(): boolean;
+    private handleRequest;
+}
+//# sourceMappingURL=MetricsServer.d.ts.map

package/dist/server/MetricsServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsServer.d.ts","sourceRoot":"","sources":["../../src/server/MetricsServer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAE,mBAAwB;IAShE;;OAEG;IACH,KAAK,IAAI,IAAI;IAqBb;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB,OAAO,CAAC,aAAa;CAkCtB"}

package/dist/server/MetricsServer.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsServer = void 0;
+const http_1 = require("http");
+/**
+ * HTTP server for exposing metrics endpoint
+ */
+class MetricsServer {
+    constructor(guardian, config = {}) {
+        this.server = null;
+        this.isRunning = false;
+        this.guardian = guardian;
+        this.config = {
+            enabled: config.enabled ?? true,
+            port: config.port ?? 9090,
+            path: config.path ?? '/guardian/metrics',
+        };
+    }
+    /**
+     * Start the metrics server
+     */
+    start() {
+        if (!this.config.enabled || this.isRunning) {
+            return;
+        }
+        this.server = (0, http_1.createServer)((req, res) => {
+            this.handleRequest(req, res);
+        });
+        this.server.listen(this.config.port, () => {
+            this.isRunning = true;
+            console.log(`Guardian metrics server listening on port ${this.config.port}`);
+        });
+        this.server.on('error', (error) => {
+            console.error('Metrics server error:', error);
+        });
+    }
+    /**
+     * Stop the metrics server
+     */
+    stop() {
+        if (this.server) {
+            this.server.close(() => {
+                this.isRunning = false;
+            });
+            this.server = null;
+        }
+    }
+    /**
+     * Check if server is running
+     */
+    getIsRunning() {
+        return this.isRunning;
+    }
+    handleRequest(req, res) {
+        // Only handle GET requests to the metrics path
+        if (req.method !== 'GET' || req.url !== this.config.path) {
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Not found' }));
+            return;
+        }
+        try {
+            const metrics = this.guardian.getMetrics();
+            const healthScore = this.guardian.getHealthScore();
+            const isProtectionActive = this.guardian.isProtectionActive();
+            const response = {
+                ...metrics,
+                healthScore,
+                isProtectionActive,
+            };
+            res.writeHead(200, {
+                'Content-Type': 'application/json',
+                'Cache-Control': 'no-cache',
+            });
+            res.end(JSON.stringify(response, null, 2));
+        }
+        catch (error) {
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                error: 'Internal server error',
+                message: error instanceof Error ? error.message : String(error),
+            }));
+        }
+    }
+}
+exports.MetricsServer = MetricsServer;
+//# sourceMappingURL=MetricsServer.js.map

package/dist/server/MetricsServer.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,104 @@
+import { RuntimeMetrics } from './metrics';
+/**
+ * Guardian configuration
+ */
+export interface GuardianConfig {
+    eventLoop?: EventLoopConfig;
+    memory?: MemoryConfig;
+    gc?: GCConfig;
+    threadPool?: ThreadPoolConfig;
+    protection?: ProtectionConfig;
+    metricsServer?: MetricsServerConfig;
+    workerPool?: WorkerPoolConfig;
+}
+/**
+ * Event loop monitoring configuration
+ */
+export interface EventLoopConfig {
+    enabled?: boolean;
+    thresholdMs?: number;
+    intervalMs?: number;
+}
+/**
+ * Memory monitoring configuration
+ */
+export interface MemoryConfig {
+    enabled?: boolean;
+    rssLimit?: number;
+    heapLimit?: number;
+    externalLimit?: number;
+    driftDetectionEnabled?: boolean;
+    driftThreshold?: number;
+}
+/**
+ * GC monitoring configuration
+ */
+export interface GCConfig {
+    enabled?: boolean;
+    pressureThreshold?: number;
+}
+/**
+ * Thread pool monitoring configuration
+ */
+export interface ThreadPoolConfig {
+    enabled?: boolean;
+    saturationThreshold?: number;
+}
+/**
+ * Protection layer configuration
+ */
+export interface ProtectionConfig {
+    enabled?: boolean;
+    loadShedding?: LoadSheddingConfig;
+}
+/**
+ * Load shedding configuration
+ */
+export interface LoadSheddingConfig {
+    enabled?: boolean;
+    eventLoopThreshold?: number;
+    memoryThreshold?: number;
+    responseCode?: number;
+    responseMessage?: string;
+}
+/**
+ * Metrics server configuration
+ */
+export interface MetricsServerConfig {
+    enabled?: boolean;
+    port?: number;
+    path?: string;
+}
+/**
+ * Worker pool configuration
+ */
+export interface WorkerPoolConfig {
+    enabled?: boolean;
+    poolSize?: number;
+    maxQueueSize?: number;
+}
+/**
+ * Guardian events
+ */
+export type GuardianEvent = 'metric' | 'warning' | 'error' | 'eventLoopBlocked' | 'memoryDrift' | 'gcPressure' | 'threadPoolSaturated';
+/**
+ * Event data for warnings
+ */
+export interface WarningEvent {
+    type: string;
+    message: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    metrics: RuntimeMetrics;
+    timestamp: number;
+}
+/**
+ * Event data for errors
+ */
+export interface ErrorEvent {
+    type: string;
+    message: string;
+    error?: Error;
+    timestamp: number;
+}
+export * from './metrics';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,kBAAkB,GAClB,aAAa,GACb,YAAY,GACZ,qBAAqB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,cAAc,WAAW,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Re-export metrics types
+__exportStar(require("./metrics"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AA0HA,0BAA0B;AAC1B,4CAA0B"}

package/dist/types/metrics.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Runtime metrics collected by the Guardian
+ */
+export interface RuntimeMetrics {
+    eventLoopDelay: EventLoopMetrics;
+    memory: MemoryMetrics;
+    gc: GCMetrics;
+    threadPool: ThreadPoolMetrics;
+    cpu: CPUMetrics;
+    activeRequests: number;
+    timestamp: number;
+}
+/**
+ * Event loop delay metrics
+ */
+export interface EventLoopMetrics {
+    mean: number;
+    max: number;
+    min: number;
+    p50: number;
+    p95: number;
+    p99: number;
+}
+/**
+ * Memory metrics
+ */
+export interface MemoryMetrics {
+    heapUsed: number;
+    heapTotal: number;
+    rss: number;
+    external: number;
+    arrayBuffers: number;
+}
+/**
+ * GC metrics
+ */
+export interface GCMetrics {
+    estimatedCycles: number;
+    minorGCCount: number;
+    majorGCCount: number;
+    gcPressure: number;
+}
+/**
+ * Thread pool metrics (inferred)
+ */
+export interface ThreadPoolMetrics {
+    saturationLevel: number;
+    estimatedQueueSize: number;
+    avgLatency: number;
+}
+/**
+ * CPU usage metrics
+ */
+export interface CPUMetrics {
+    user: number;
+    system: number;
+}
+/**
+ * Memory drift pattern
+ */
+export interface MemoryDrift {
+    rssGrowthRate: number;
+    heapGrowthRate: number;
+    externalGrowthRate: number;
+    isLeakSuspected: boolean;
+}
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/types/metrics.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,gBAAgB,CAAC;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,UAAU,EAAE,iBAAiB,CAAC;IAC9B,GAAG,EAAE,UAAU,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;CAC1B"}

package/dist/types/metrics.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=metrics.js.map

package/dist/types/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/types/metrics.ts"],"names":[],"mappings":""}

package/dist/worker/WorkerPool.d.ts

@@ -0,0 +1,44 @@
+import { WorkerPoolConfig } from '../types';
+/**
+ * Managed worker thread pool with queue management
+ */
+export declare class WorkerPool {
+    private workers;
+    private queue;
+    private activeTasks;
+    private workerTaskMap;
+    private config;
+    private workerScript;
+    private isShuttingDown;
+    constructor(workerScript: string, config?: WorkerPoolConfig);
+    /**
+     * Run a task in the worker pool
+     */
+    run<TResult>(data: unknown): Promise<TResult>;
+    /**
+     * Get current queue size
+     */
+    getQueueSize(): number;
+    /**
+     * Get number of active tasks
+     */
+    getActiveTasks(): number;
+    /**
+     * Get pool statistics
+     */
+    getStats(): {
+        poolSize: number;
+        activeTasks: number;
+        queueSize: number;
+        availableWorkers: number;
+    };
+    /**
+     * Shutdown the worker pool
+     */
+    shutdown(): Promise<void>;
+    private initializeWorkers;
+    private createWorker;
+    private processQueue;
+    private isWorkerBusy;
+}
+//# sourceMappingURL=WorkerPool.d.ts.map

package/dist/worker/WorkerPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerPool.d.ts","sourceRoot":"","sources":["../../src/worker/WorkerPool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAS5C;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,WAAW,CAAkD;IACrE,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAS;gBAEnB,YAAY,EAAE,MAAM,EAAE,MAAM,GAAE,gBAAqB;IAa/D;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA6BnD;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,QAAQ;;;;;;IAUR;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAuE/B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,YAAY;IAoDpB,OAAO,CAAC,YAAY;IA+BpB,OAAO,CAAC,YAAY;CAIrB"}