@n-dx/core 0.1.0

package/packages/hench/dist/process/pool.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Runtime process pool — reusable Node.js worker management.
+ *
+ * Maintains warm Node.js runtimes that can be borrowed for task
+ * execution and returned for reuse, avoiding V8 startup overhead
+ * and reducing memory consumption by 60%+ for sequential tasks.
+ *
+ * The pool follows an acquire/release pattern:
+ *
+ * ```ts
+ * const pool = new RuntimePool(workerFactory, { maxWorkers: 3 });
+ * const runtime = pool.acquire();
+ * try {
+ *   // dispatch work to runtime.handle
+ * } finally {
+ *   pool.release(runtime);
+ * }
+ * await pool.shutdown();
+ * ```
+ *
+ * Features:
+ * - Warm runtime reuse (avoids V8 + module loading per task)
+ * - Configurable idle timeout (auto-terminates unused workers)
+ * - Max tasks per worker recycling (prevents memory leaks)
+ * - Graceful shutdown (drains busy workers)
+ *
+ * @module hench/process/pool
+ */
+/**
+ * Configuration for the runtime process pool.
+ *
+ * All fields are optional when constructing — unset fields take
+ * their defaults from {@link DEFAULT_RUNTIME_POOL_CONFIG}.
+ */
+export interface RuntimePoolConfig {
+    /** Whether the pool is enabled. Defaults to true. */
+    enabled: boolean;
+    /** Maximum number of warm workers in the pool. Defaults to 2. */
+    maxWorkers: number;
+    /** Idle timeout in ms before terminating unused workers. 0 = no timeout. Defaults to 300000 (5 min). */
+    idleTimeoutMs: number;
+    /** Maximum tasks a worker handles before being recycled. Defaults to 10. */
+    maxTasksPerWorker: number;
+}
+export declare const DEFAULT_RUNTIME_POOL_CONFIG: Readonly<RuntimePoolConfig>;
+/**
+ * Minimal interface for a managed worker process.
+ *
+ * Satisfied by `child_process.ChildProcess` and `worker_threads.Worker`.
+ * Kept minimal so tests can provide lightweight stubs without mocking
+ * the full Node.js process API.
+ */
+export interface WorkerHandle {
+    /** Process ID, or undefined if not yet spawned. */
+    readonly pid: number | undefined;
+    /** Whether the IPC channel / message port is connected. */
+    readonly connected: boolean;
+    /** Terminate the worker process. */
+    kill(signal?: NodeJS.Signals): boolean;
+}
+/**
+ * Factory function that creates a new worker process.
+ *
+ * The pool calls this when it needs a fresh runtime. The factory
+ * must return a connected WorkerHandle (e.g. via `child_process.fork()`
+ * or `worker_threads.Worker`).
+ */
+export type WorkerFactory = () => WorkerHandle;
+/** Lifecycle state of a pooled worker. */
+export type WorkerState = "idle" | "busy" | "draining";
+/**
+ * Opaque token returned by {@link RuntimePool.acquire}.
+ *
+ * Callers use `handle` to dispatch work to the underlying process,
+ * then pass the token back to {@link RuntimePool.release} when done.
+ */
+export interface PooledRuntime {
+    /** Unique identifier for this runtime instance. */
+    readonly id: string;
+    /** Underlying worker process handle. */
+    readonly handle: WorkerHandle;
+    /** Number of tasks this runtime has completed so far. */
+    readonly tasksCompleted: number;
+    /** ISO timestamp when this runtime was first created. */
+    readonly createdAt: string;
+}
+/** Snapshot of a single worker's state, suitable for status display. */
+export interface PooledRuntimeInfo {
+    id: string;
+    state: WorkerState;
+    pid: number | undefined;
+    tasksCompleted: number;
+    createdAt: string;
+    lastUsedAt: string;
+}
+/** Snapshot of pool state for monitoring and display. */
+export interface RuntimePoolStatus {
+    /** Maximum workers the pool will maintain. */
+    maxWorkers: number;
+    /** Total workers currently alive (idle + busy). */
+    totalWorkers: number;
+    /** Workers waiting to be reused. */
+    idleCount: number;
+    /** Workers currently executing tasks. */
+    busyCount: number;
+    /** Cumulative tasks completed across all workers since pool creation. */
+    totalTasksCompleted: number;
+    /** Cumulative workers created since pool creation. */
+    totalWorkersCreated: number;
+    /** Cumulative workers recycled (terminated after use) since pool creation. */
+    totalWorkersRecycled: number;
+    /** Whether the pool is accepting new acquire requests. */
+    accepting: boolean;
+    /** Per-worker state snapshots. */
+    workers: PooledRuntimeInfo[];
+}
+/**
+ * Thrown when all pool workers are busy and no new workers can be created.
+ *
+ * Callers should either wait and retry, or use {@link ExecutionQueue}
+ * in front of the pool to queue requests.
+ */
+export declare class PoolExhaustedError extends Error {
+    readonly maxWorkers: number;
+    readonly busyCount: number;
+    constructor(maxWorkers: number, busyCount: number);
+}
+/**
+ * Manages a pool of warm Node.js runtimes for task execution reuse.
+ *
+ * Callers {@link acquire} a runtime before starting a task and
+ * {@link release} it when the task completes (regardless of outcome).
+ * If no idle runtime is available and the pool is under capacity,
+ * a new one is created via the factory. If the pool is full,
+ * {@link PoolExhaustedError} is thrown.
+ *
+ * Workers are automatically recycled after {@link RuntimePoolConfig.maxTasksPerWorker}
+ * tasks and terminated after {@link RuntimePoolConfig.idleTimeoutMs}
+ * of inactivity. Task isolation is maintained by recycling workers
+ * that have accumulated state, and callers can enforce additional
+ * isolation by using the pool in combination with environment resets.
+ *
+ * @example
+ * ```ts
+ * const pool = new RuntimePool(() => fork("worker.js"), {
+ *   maxWorkers: 3,
+ *   idleTimeoutMs: 60_000,
+ *   maxTasksPerWorker: 5,
+ * });
+ *
+ * const runtime = pool.acquire();
+ * try {
+ *   await executeTask(runtime.handle);
+ * } finally {
+ *   pool.release(runtime);
+ * }
+ *
+ * await pool.shutdown();
+ * ```
+ */
+export declare class RuntimePool {
+    private readonly _config;
+    private readonly _factory;
+    private readonly _idle;
+    private readonly _busy;
+    private readonly _idleTimers;
+    private readonly _registry;
+    private _nextWorkerId;
+    private _shuttingDown;
+    private _totalCreated;
+    private _totalRecycled;
+    private _totalTasksCompleted;
+    constructor(factory: WorkerFactory, config?: Partial<RuntimePoolConfig>);
+    /** Pool configuration (frozen copy). */
+    get config(): Readonly<RuntimePoolConfig>;
+    /** Total live workers (idle + busy). */
+    get size(): number;
+    /** Number of idle workers waiting for reuse. */
+    get idleCount(): number;
+    /** Number of workers currently executing tasks. */
+    get busyCount(): number;
+    /** Whether the pool is accepting new acquire requests. */
+    get accepting(): boolean;
+    /**
+     * Acquire a warm runtime from the pool.
+     *
+     * Returns an idle runtime if available, otherwise creates a new one
+     * via the factory (up to maxWorkers). Throws {@link PoolExhaustedError}
+     * if all workers are busy and no new workers can be created.
+     *
+     * @returns A pooled runtime token. Must be passed to {@link release}
+     *          when done, regardless of task outcome.
+     * @throws {PoolExhaustedError} when the pool is at capacity and all busy.
+     * @throws {Error} when the pool is shutting down.
+     */
+    acquire(): PooledRuntime;
+    /**
+     * Release a runtime back to the pool after task completion.
+     *
+     * The runtime is returned to the idle pool for reuse, or recycled
+     * if it has exceeded {@link RuntimePoolConfig.maxTasksPerWorker}.
+     * Starts an idle timeout timer for the returned worker.
+     *
+     * Must be called exactly once per successful {@link acquire}, typically
+     * in a `finally` block to guarantee cleanup.
+     *
+     * @param runtime  The runtime token returned by {@link acquire}.
+     * @throws {Error} if the runtime is not currently busy in this pool.
+     */
+    release(runtime: PooledRuntime): void;
+    /**
+     * Terminate all workers and prevent new acquisitions.
+     *
+     * Idle workers are terminated immediately. Busy workers are marked
+     * for draining — they will be terminated when released. After
+     * shutdown, all subsequent {@link acquire} calls will throw.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Return a snapshot of pool state for monitoring.
+     *
+     * The returned object is a plain data structure suitable for JSON
+     * serialization and display (no functions or promises).
+     */
+    status(): RuntimePoolStatus;
+    private _createWorker;
+    private _startIdleTimer;
+    private _clearIdleTimer;
+    private _evictIdle;
+    private _terminateWorker;
+}

package/packages/hench/dist/process/pool.js

@@ -0,0 +1,344 @@
+/**
+ * Runtime process pool — reusable Node.js worker management.
+ *
+ * Maintains warm Node.js runtimes that can be borrowed for task
+ * execution and returned for reuse, avoiding V8 startup overhead
+ * and reducing memory consumption by 60%+ for sequential tasks.
+ *
+ * The pool follows an acquire/release pattern:
+ *
+ * ```ts
+ * const pool = new RuntimePool(workerFactory, { maxWorkers: 3 });
+ * const runtime = pool.acquire();
+ * try {
+ *   // dispatch work to runtime.handle
+ * } finally {
+ *   pool.release(runtime);
+ * }
+ * await pool.shutdown();
+ * ```
+ *
+ * Features:
+ * - Warm runtime reuse (avoids V8 + module loading per task)
+ * - Configurable idle timeout (auto-terminates unused workers)
+ * - Max tasks per worker recycling (prevents memory leaks)
+ * - Graceful shutdown (drains busy workers)
+ *
+ * @module hench/process/pool
+ */
+export const DEFAULT_RUNTIME_POOL_CONFIG = Object.freeze({
+    enabled: true,
+    maxWorkers: 2,
+    idleTimeoutMs: 300_000, // 5 minutes
+    maxTasksPerWorker: 10,
+});
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+/**
+ * Thrown when all pool workers are busy and no new workers can be created.
+ *
+ * Callers should either wait and retry, or use {@link ExecutionQueue}
+ * in front of the pool to queue requests.
+ */
+export class PoolExhaustedError extends Error {
+    maxWorkers;
+    busyCount;
+    constructor(maxWorkers, busyCount) {
+        super(`Process pool exhausted: all ${maxWorkers} worker(s) are busy. ` +
+            `Wait for a worker to be released, or increase pool.maxWorkers.`);
+        this.name = "PoolExhaustedError";
+        this.maxWorkers = maxWorkers;
+        this.busyCount = busyCount;
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal worker wrapper
+// ---------------------------------------------------------------------------
+class InternalWorker {
+    id;
+    handle;
+    createdAt;
+    state = "idle";
+    tasksCompleted = 0;
+    lastUsedAt;
+    constructor(id, handle) {
+        this.id = id;
+        this.handle = handle;
+        this.createdAt = new Date().toISOString();
+        this.lastUsedAt = this.createdAt;
+    }
+    info() {
+        return {
+            id: this.id,
+            state: this.state,
+            pid: this.handle.pid,
+            tasksCompleted: this.tasksCompleted,
+            createdAt: this.createdAt,
+            lastUsedAt: this.lastUsedAt,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// RuntimePool
+// ---------------------------------------------------------------------------
+/**
+ * Manages a pool of warm Node.js runtimes for task execution reuse.
+ *
+ * Callers {@link acquire} a runtime before starting a task and
+ * {@link release} it when the task completes (regardless of outcome).
+ * If no idle runtime is available and the pool is under capacity,
+ * a new one is created via the factory. If the pool is full,
+ * {@link PoolExhaustedError} is thrown.
+ *
+ * Workers are automatically recycled after {@link RuntimePoolConfig.maxTasksPerWorker}
+ * tasks and terminated after {@link RuntimePoolConfig.idleTimeoutMs}
+ * of inactivity. Task isolation is maintained by recycling workers
+ * that have accumulated state, and callers can enforce additional
+ * isolation by using the pool in combination with environment resets.
+ *
+ * @example
+ * ```ts
+ * const pool = new RuntimePool(() => fork("worker.js"), {
+ *   maxWorkers: 3,
+ *   idleTimeoutMs: 60_000,
+ *   maxTasksPerWorker: 5,
+ * });
+ *
+ * const runtime = pool.acquire();
+ * try {
+ *   await executeTask(runtime.handle);
+ * } finally {
+ *   pool.release(runtime);
+ * }
+ *
+ * await pool.shutdown();
+ * ```
+ */
+export class RuntimePool {
+    _config;
+    _factory;
+    // Worker tracking
+    _idle = [];
+    _busy = new Set();
+    _idleTimers = new Map();
+    // Worker-to-internal mapping (for release validation)
+    _registry = new Map();
+    // Metrics
+    _nextWorkerId = 0;
+    _shuttingDown = false;
+    _totalCreated = 0;
+    _totalRecycled = 0;
+    _totalTasksCompleted = 0;
+    constructor(factory, config) {
+        this._factory = factory;
+        this._config = { ...DEFAULT_RUNTIME_POOL_CONFIG, ...config };
+        if (this._config.maxWorkers < 1) {
+            throw new RangeError("RuntimePool maxWorkers must be >= 1");
+        }
+        if (this._config.idleTimeoutMs < 0) {
+            throw new RangeError("RuntimePool idleTimeoutMs must be >= 0");
+        }
+        if (this._config.maxTasksPerWorker < 1) {
+            throw new RangeError("RuntimePool maxTasksPerWorker must be >= 1");
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Public getters
+    // -----------------------------------------------------------------------
+    /** Pool configuration (frozen copy). */
+    get config() {
+        return this._config;
+    }
+    /** Total live workers (idle + busy). */
+    get size() {
+        return this._idle.length + this._busy.size;
+    }
+    /** Number of idle workers waiting for reuse. */
+    get idleCount() {
+        return this._idle.length;
+    }
+    /** Number of workers currently executing tasks. */
+    get busyCount() {
+        return this._busy.size;
+    }
+    /** Whether the pool is accepting new acquire requests. */
+    get accepting() {
+        return !this._shuttingDown;
+    }
+    // -----------------------------------------------------------------------
+    // acquire / release
+    // -----------------------------------------------------------------------
+    /**
+     * Acquire a warm runtime from the pool.
+     *
+     * Returns an idle runtime if available, otherwise creates a new one
+     * via the factory (up to maxWorkers). Throws {@link PoolExhaustedError}
+     * if all workers are busy and no new workers can be created.
+     *
+     * @returns A pooled runtime token. Must be passed to {@link release}
+     *          when done, regardless of task outcome.
+     * @throws {PoolExhaustedError} when the pool is at capacity and all busy.
+     * @throws {Error} when the pool is shutting down.
+     */
+    acquire() {
+        if (this._shuttingDown) {
+            throw new Error("RuntimePool is shutting down; not accepting new requests");
+        }
+        // Try to reuse an idle worker
+        if (this._idle.length > 0) {
+            const worker = this._idle.shift();
+            this._clearIdleTimer(worker.id);
+            worker.state = "busy";
+            this._busy.add(worker);
+            return worker;
+        }
+        // Create a new worker if under capacity
+        if (this.size < this._config.maxWorkers) {
+            const worker = this._createWorker();
+            worker.state = "busy";
+            this._busy.add(worker);
+            return worker;
+        }
+        // Pool exhausted
+        throw new PoolExhaustedError(this._config.maxWorkers, this._busy.size);
+    }
+    /**
+     * Release a runtime back to the pool after task completion.
+     *
+     * The runtime is returned to the idle pool for reuse, or recycled
+     * if it has exceeded {@link RuntimePoolConfig.maxTasksPerWorker}.
+     * Starts an idle timeout timer for the returned worker.
+     *
+     * Must be called exactly once per successful {@link acquire}, typically
+     * in a `finally` block to guarantee cleanup.
+     *
+     * @param runtime  The runtime token returned by {@link acquire}.
+     * @throws {Error} if the runtime is not currently busy in this pool.
+     */
+    release(runtime) {
+        const worker = this._registry.get(runtime.id);
+        if (!worker || !this._busy.has(worker)) {
+            throw new Error("Cannot release a runtime that is not busy in this pool");
+        }
+        this._busy.delete(worker);
+        worker.tasksCompleted++;
+        worker.lastUsedAt = new Date().toISOString();
+        this._totalTasksCompleted++;
+        // Recycle if at task limit or pool is shutting down
+        if (worker.tasksCompleted >= this._config.maxTasksPerWorker ||
+            this._shuttingDown) {
+            this._terminateWorker(worker);
+            this._totalRecycled++;
+            return;
+        }
+        // Return to idle pool
+        worker.state = "idle";
+        this._idle.push(worker);
+        this._startIdleTimer(worker);
+    }
+    // -----------------------------------------------------------------------
+    // Shutdown
+    // -----------------------------------------------------------------------
+    /**
+     * Terminate all workers and prevent new acquisitions.
+     *
+     * Idle workers are terminated immediately. Busy workers are marked
+     * for draining — they will be terminated when released. After
+     * shutdown, all subsequent {@link acquire} calls will throw.
+     */
+    async shutdown() {
+        this._shuttingDown = true;
+        // Clear all idle timers
+        for (const [, timer] of this._idleTimers) {
+            clearTimeout(timer);
+        }
+        this._idleTimers.clear();
+        // Terminate idle workers immediately
+        while (this._idle.length > 0) {
+            const worker = this._idle.shift();
+            this._terminateWorker(worker);
+        }
+        // Mark busy workers for draining (terminated on release)
+        for (const worker of this._busy) {
+            worker.state = "draining";
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Status
+    // -----------------------------------------------------------------------
+    /**
+     * Return a snapshot of pool state for monitoring.
+     *
+     * The returned object is a plain data structure suitable for JSON
+     * serialization and display (no functions or promises).
+     */
+    status() {
+        const workers = [
+            ...this._idle.map((w) => w.info()),
+            ...[...this._busy].map((w) => w.info()),
+        ];
+        return {
+            maxWorkers: this._config.maxWorkers,
+            totalWorkers: this.size,
+            idleCount: this._idle.length,
+            busyCount: this._busy.size,
+            totalTasksCompleted: this._totalTasksCompleted,
+            totalWorkersCreated: this._totalCreated,
+            totalWorkersRecycled: this._totalRecycled,
+            accepting: !this._shuttingDown,
+            workers,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Internal helpers
+    // -----------------------------------------------------------------------
+    _createWorker() {
+        const handle = this._factory();
+        const id = `worker-${++this._nextWorkerId}`;
+        const worker = new InternalWorker(id, handle);
+        this._registry.set(id, worker);
+        this._totalCreated++;
+        return worker;
+    }
+    _startIdleTimer(worker) {
+        if (this._config.idleTimeoutMs === 0)
+            return;
+        const timer = setTimeout(() => {
+            this._evictIdle(worker);
+        }, this._config.idleTimeoutMs);
+        // Unref so the timer doesn't keep the Node.js event loop alive
+        if (typeof timer.unref === "function")
+            timer.unref();
+        this._idleTimers.set(worker.id, timer);
+    }
+    _clearIdleTimer(id) {
+        const timer = this._idleTimers.get(id);
+        if (timer) {
+            clearTimeout(timer);
+            this._idleTimers.delete(id);
+        }
+    }
+    _evictIdle(worker) {
+        const idx = this._idle.indexOf(worker);
+        if (idx !== -1) {
+            this._idle.splice(idx, 1);
+            this._clearIdleTimer(worker.id);
+            this._terminateWorker(worker);
+            this._totalRecycled++;
+        }
+    }
+    _terminateWorker(worker) {
+        worker.state = "draining";
+        this._registry.delete(worker.id);
+        try {
+            if (worker.handle.connected || worker.handle.pid) {
+                worker.handle.kill();
+            }
+        }
+        catch {
+            // Worker already dead — that's fine
+        }
+    }
+}
+//# sourceMappingURL=pool.js.map

package/packages/hench/dist/process/pool.js.map

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