node-runtime-guardian 0.1.0

package/dist/worker/WorkerPool.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerPool = void 0;
+const worker_threads_1 = require("worker_threads");
+/**
+ * Managed worker thread pool with queue management
+ */
+class WorkerPool {
+    constructor(workerScript, config = {}) {
+        this.workers = [];
+        this.queue = [];
+        this.activeTasks = new Map();
+        this.workerTaskMap = new Map(); // Track which worker handles which task
+        this.isShuttingDown = false;
+        this.workerScript = workerScript;
+        this.config = {
+            enabled: config.enabled ?? true,
+            poolSize: config.poolSize ?? 4,
+            maxQueueSize: config.maxQueueSize ?? 100,
+        };
+        if (this.config.enabled) {
+            this.initializeWorkers();
+        }
+    }
+    /**
+     * Run a task in the worker pool
+     */
+    async run(data) {
+        if (!this.config.enabled) {
+            throw new Error('Worker pool is not enabled');
+        }
+        if (this.isShuttingDown) {
+            throw new Error('Worker pool is shutting down');
+        }
+        // Check queue size
+        if (this.queue.length >= this.config.maxQueueSize) {
+            throw new Error(`Worker pool queue is full (${this.config.maxQueueSize} tasks)`);
+        }
+        return new Promise((resolve, reject) => {
+            const task = {
+                id: `${Date.now()}-${Math.random()}`,
+                data,
+                resolve,
+                reject,
+            };
+            this.queue.push(task);
+            this.processQueue();
+        });
+    }
+    /**
+     * Get current queue size
+     */
+    getQueueSize() {
+        return this.queue.length;
+    }
+    /**
+     * Get number of active tasks
+     */
+    getActiveTasks() {
+        return this.activeTasks.size;
+    }
+    /**
+     * Get pool statistics
+     */
+    getStats() {
+        return {
+            poolSize: this.workers.length,
+            activeTasks: this.activeTasks.size,
+            queueSize: this.queue.length,
+            availableWorkers: this.workers.filter((w) => !this.isWorkerBusy(w))
+                .length,
+        };
+    }
+    /**
+     * Shutdown the worker pool
+     */
+    async shutdown() {
+        this.isShuttingDown = true;
+        // Reject all queued tasks
+        while (this.queue.length > 0) {
+            const task = this.queue.shift();
+            if (task) {
+                task.reject(new Error('Worker pool is shutting down'));
+            }
+        }
+        // Wait for active tasks to complete (with timeout)
+        const activeTaskPromises = Array.from(this.activeTasks.values()).map((task) => new Promise((resolve) => {
+            let checkInterval = null;
+            let timeoutId = null;
+            const cleanup = () => {
+                if (checkInterval) {
+                    clearInterval(checkInterval);
+                    checkInterval = null;
+                }
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                    timeoutId = null;
+                }
+            };
+            checkInterval = setInterval(() => {
+                if (!this.activeTasks.has(task.id)) {
+                    cleanup();
+                    resolve();
+                }
+            }, 100);
+            // Timeout after 5 seconds (reduced from 30 for faster test cleanup)
+            timeoutId = setTimeout(() => {
+                cleanup();
+                resolve();
+            }, 5000);
+        }));
+        await Promise.all(activeTaskPromises);
+        // Terminate all workers with a timeout
+        const terminatePromises = this.workers.map((worker) => {
+            const terminatePromise = Promise.resolve(worker.terminate()).catch(() => {
+                // Ignore errors if worker is already terminated
+            });
+            return Promise.race([
+                terminatePromise,
+                new Promise((resolve) => {
+                    setTimeout(() => {
+                        // Timeout reached, resolve anyway (worker may still be terminating)
+                        resolve();
+                    }, 2000);
+                }),
+            ]);
+        });
+        await Promise.all(terminatePromises);
+        this.workers = [];
+        this.queue = [];
+        this.activeTasks.clear();
+        this.workerTaskMap.clear();
+    }
+    initializeWorkers() {
+        for (let i = 0; i < this.config.poolSize; i++) {
+            this.createWorker();
+        }
+    }
+    createWorker() {
+        const worker = new worker_threads_1.Worker(this.workerScript);
+        worker.on('message', (message) => {
+            const task = this.activeTasks.get(message.id);
+            if (task) {
+                this.activeTasks.delete(message.id);
+                this.workerTaskMap.delete(worker);
+                if (message.error) {
+                    const errorMessage = message.error instanceof Error
+                        ? message.error.message
+                        : String(message.error);
+                    task.reject(new Error(errorMessage));
+                }
+                else {
+                    task.resolve(message.result);
+                }
+                // Process next task in queue
+                this.processQueue();
+            }
+        });
+        worker.on('error', (error) => {
+            console.error('Worker error:', error);
+            // Remove worker and create a new one
+            const index = this.workers.indexOf(worker);
+            if (index > -1) {
+                this.workers.splice(index, 1);
+                this.createWorker();
+            }
+        });
+        worker.on('exit', (code) => {
+            if (code !== 0 && !this.isShuttingDown) {
+                // Worker crashed, replace it
+                const index = this.workers.indexOf(worker);
+                if (index > -1) {
+                    this.workers.splice(index, 1);
+                    this.createWorker();
+                }
+            }
+        });
+        this.workers.push(worker);
+        return worker;
+    }
+    processQueue() {
+        if (this.isShuttingDown || this.queue.length === 0) {
+            return;
+        }
+        const availableWorker = this.workers.find((w) => !this.isWorkerBusy(w));
+        if (!availableWorker) {
+            return; // All workers are busy
+        }
+        const task = this.queue.shift();
+        if (!task) {
+            return;
+        }
+        this.activeTasks.set(task.id, task);
+        this.workerTaskMap.set(availableWorker, task.id);
+        try {
+            availableWorker.postMessage({
+                id: task.id,
+                data: task.data,
+            });
+        }
+        catch (error) {
+            this.activeTasks.delete(task.id);
+            this.workerTaskMap.delete(availableWorker);
+            task.reject(error);
+            this.processQueue();
+        }
+    }
+    isWorkerBusy(worker) {
+        // A worker is busy if it has an active task assigned to it
+        return this.workerTaskMap.has(worker);
+    }
+}
+exports.WorkerPool = WorkerPool;
+//# sourceMappingURL=WorkerPool.js.map

package/dist/worker/WorkerPool.js.map

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "node-runtime-guardian",
+  "version": "0.1.0",
+  "description": "Production-grade runtime health and protection engine for Node.js applications",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src tests --ext .ts",
+    "lint:fix": "eslint src tests --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\" \"*.md\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\" \"*.md\""
+  },
+  "keywords": [
+    "nodejs",
+    "runtime",
+    "monitoring",
+    "performance",
+    "health",
+    "event-loop",
+    "memory",
+    "gc",
+    "thread-pool"
+  ],
+  "author": "Zeeshan Ashraf <https://github.com/Zeeshan-2k1>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Zeeshan-2k1/node-runtime-guardian"
+  },
+  "bugs": {
+    "url": "https://github.com/Zeeshan-2k1/node-runtime-guardian/issues"
+  },
+  "homepage": "https://github.com/Zeeshan-2k1/node-runtime-guardian#readme",
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^24.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-node": "^11.1.0",
+    "husky": "^9.0.11",
+    "jest": "^29.7.0",
+    "jest-util": "^30.2.0",
+    "lint-staged": "^15.2.0",
+    "prettier": "^3.2.5",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  }
+}