@jshookmcp/jshook 0.1.2

package/dist/utils/WorkerPool.js

@@ -0,0 +1,273 @@
+import { Worker } from 'node:worker_threads';
+import { WORKER_POOL_MIN_WORKERS, WORKER_POOL_MAX_WORKERS, WORKER_POOL_IDLE_TIMEOUT_MS, WORKER_POOL_JOB_TIMEOUT_MS, } from '../constants.js';
+const DEFAULT_MIN_WORKERS = WORKER_POOL_MIN_WORKERS;
+const DEFAULT_MAX_WORKERS = WORKER_POOL_MAX_WORKERS;
+const DEFAULT_IDLE_TIMEOUT_MS = WORKER_POOL_IDLE_TIMEOUT_MS;
+const DEFAULT_JOB_TIMEOUT_MS = WORKER_POOL_JOB_TIMEOUT_MS;
+export class WorkerPool {
+    name;
+    workerScript;
+    minWorkers;
+    maxWorkers;
+    idleTimeoutMs;
+    resourceLimits;
+    workers = new Map();
+    queuedJobs = [];
+    activeJobs = new Map();
+    nextWorkerId = 1;
+    nextJobId = 1;
+    closed = false;
+    constructor(options) {
+        this.name = options.name ?? 'worker-pool';
+        this.workerScript = options.workerScript;
+        this.minWorkers = options.minWorkers ?? DEFAULT_MIN_WORKERS;
+        this.maxWorkers = options.maxWorkers ?? DEFAULT_MAX_WORKERS;
+        this.idleTimeoutMs = options.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS;
+        this.resourceLimits = options.resourceLimits;
+        if (!this.workerScript || this.workerScript.trim().length === 0) {
+            throw this.toError('workerScript must be a non-empty string');
+        }
+        if (!Number.isInteger(this.minWorkers) || this.minWorkers < 0) {
+            throw this.toError('minWorkers must be an integer >= 0');
+        }
+        if (!Number.isInteger(this.maxWorkers) || this.maxWorkers < 1) {
+            throw this.toError('maxWorkers must be an integer >= 1');
+        }
+        if (this.minWorkers > this.maxWorkers) {
+            throw this.toError('minWorkers cannot be greater than maxWorkers');
+        }
+        this.ensureMinWorkers();
+    }
+    submit(payload, timeoutMs = DEFAULT_JOB_TIMEOUT_MS) {
+        if (this.closed) {
+            return Promise.reject(this.toError('pool is closed'));
+        }
+        return new Promise((resolve, reject) => {
+            const job = {
+                id: this.nextJobId++,
+                payload,
+                timeoutMs,
+                resolve,
+                reject,
+            };
+            this.queuedJobs.push(job);
+            this.pumpQueue();
+        });
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const closeError = this.toError('pool is closed');
+        while (this.queuedJobs.length > 0) {
+            const job = this.queuedJobs.shift();
+            job?.reject(closeError);
+        }
+        for (const activeJob of this.activeJobs.values()) {
+            if (activeJob.timeoutHandle) {
+                clearTimeout(activeJob.timeoutHandle);
+            }
+            activeJob.reject(closeError);
+        }
+        this.activeJobs.clear();
+        const workerIds = Array.from(this.workers.keys());
+        await Promise.all(workerIds.map((workerId) => this.terminateWorker(workerId)));
+    }
+    ensureMinWorkers() {
+        if (this.closed)
+            return;
+        while (this.workers.size < this.minWorkers) {
+            this.spawnWorker();
+        }
+    }
+    pumpQueue() {
+        if (this.closed)
+            return;
+        while (this.queuedJobs.length > 0) {
+            let worker = this.findIdleWorker();
+            if (!worker) {
+                if (this.workers.size < this.maxWorkers) {
+                    worker = this.spawnWorker();
+                }
+                else {
+                    return;
+                }
+            }
+            const job = this.queuedJobs.shift();
+            if (!job)
+                return;
+            this.dispatchJob(worker, job);
+        }
+    }
+    findIdleWorker() {
+        for (const worker of this.workers.values()) {
+            if (!worker.busy)
+                return worker;
+        }
+        return undefined;
+    }
+    spawnWorker() {
+        const id = this.nextWorkerId++;
+        const worker = new Worker(this.workerScript, {
+            eval: true,
+            resourceLimits: this.resourceLimits,
+        });
+        const pooled = {
+            id,
+            worker,
+            busy: false,
+            activeJobId: null,
+            idleTimer: null,
+        };
+        worker.on('message', (message) => this.handleWorkerMessage(id, message));
+        worker.on('error', (error) => this.handleWorkerFailure(id, error));
+        worker.on('exit', (code) => this.handleWorkerExit(id, code));
+        this.workers.set(id, pooled);
+        return pooled;
+    }
+    dispatchJob(worker, job) {
+        worker.busy = true;
+        worker.activeJobId = job.id;
+        if (worker.idleTimer) {
+            clearTimeout(worker.idleTimer);
+            worker.idleTimer = null;
+        }
+        const timeoutHandle = setTimeout(() => {
+            this.handleJobTimeout(job.id, job.timeoutMs);
+        }, job.timeoutMs);
+        this.activeJobs.set(job.id, {
+            ...job,
+            workerId: worker.id,
+            timeoutHandle,
+        });
+        try {
+            worker.worker.postMessage({
+                jobId: job.id,
+                payload: job.payload,
+            });
+        }
+        catch (error) {
+            const activeJob = this.activeJobs.get(job.id);
+            if (activeJob?.timeoutHandle)
+                clearTimeout(activeJob.timeoutHandle);
+            this.activeJobs.delete(job.id);
+            worker.busy = false;
+            worker.activeJobId = null;
+            job.reject(this.toError(error instanceof Error ? error.message : String(error)));
+            void this.terminateWorker(worker.id).then(() => {
+                this.ensureMinWorkers();
+                this.pumpQueue();
+            });
+        }
+    }
+    handleWorkerMessage(workerId, message) {
+        const envelope = message;
+        if (!envelope || typeof envelope !== 'object' || typeof envelope.jobId !== 'number') {
+            return;
+        }
+        const activeJob = this.activeJobs.get(envelope.jobId);
+        if (!activeJob)
+            return;
+        if (activeJob.timeoutHandle)
+            clearTimeout(activeJob.timeoutHandle);
+        this.activeJobs.delete(envelope.jobId);
+        const worker = this.workers.get(workerId);
+        if (worker) {
+            worker.busy = false;
+            worker.activeJobId = null;
+            this.armIdleTimer(worker);
+        }
+        if (!envelope.ok) {
+            activeJob.reject(this.toError(envelope.error ?? 'worker task failed'));
+        }
+        else if (typeof envelope.result === 'undefined') {
+            activeJob.reject(this.toError('worker returned empty result'));
+        }
+        else {
+            activeJob.resolve(envelope.result);
+        }
+        this.pumpQueue();
+    }
+    handleWorkerFailure(workerId, error) {
+        const worker = this.workers.get(workerId);
+        if (!worker)
+            return;
+        const activeJobId = worker.activeJobId;
+        if (activeJobId !== null) {
+            const activeJob = this.activeJobs.get(activeJobId);
+            if (activeJob) {
+                if (activeJob.timeoutHandle)
+                    clearTimeout(activeJob.timeoutHandle);
+                this.activeJobs.delete(activeJobId);
+                activeJob.reject(this.toError(error.message));
+            }
+        }
+        void this.terminateWorker(workerId).then(() => {
+            this.ensureMinWorkers();
+            this.pumpQueue();
+        });
+    }
+    handleWorkerExit(workerId, code) {
+        const worker = this.workers.get(workerId);
+        if (!worker)
+            return;
+        const activeJobId = worker.activeJobId;
+        this.workers.delete(workerId);
+        if (worker.idleTimer)
+            clearTimeout(worker.idleTimer);
+        if (activeJobId !== null) {
+            const activeJob = this.activeJobs.get(activeJobId);
+            if (activeJob) {
+                if (activeJob.timeoutHandle)
+                    clearTimeout(activeJob.timeoutHandle);
+                this.activeJobs.delete(activeJobId);
+                activeJob.reject(this.toError(`worker exited unexpectedly with code ${code}`));
+            }
+        }
+        this.ensureMinWorkers();
+        this.pumpQueue();
+    }
+    handleJobTimeout(jobId, timeoutMs) {
+        const activeJob = this.activeJobs.get(jobId);
+        if (!activeJob)
+            return;
+        this.activeJobs.delete(jobId);
+        activeJob.reject(this.toError(`worker task timed out after ${timeoutMs}ms`));
+        void this.terminateWorker(activeJob.workerId).then(() => {
+            this.ensureMinWorkers();
+            this.pumpQueue();
+        });
+    }
+    armIdleTimer(worker) {
+        if (this.idleTimeoutMs <= 0 || this.workers.size <= this.minWorkers)
+            return;
+        if (worker.idleTimer)
+            clearTimeout(worker.idleTimer);
+        worker.idleTimer = setTimeout(() => {
+            const current = this.workers.get(worker.id);
+            if (!current || current.busy || this.workers.size <= this.minWorkers)
+                return;
+            void this.terminateWorker(worker.id);
+        }, this.idleTimeoutMs);
+    }
+    async terminateWorker(workerId) {
+        const worker = this.workers.get(workerId);
+        if (!worker)
+            return;
+        this.workers.delete(workerId);
+        if (worker.idleTimer)
+            clearTimeout(worker.idleTimer);
+        worker.worker.removeAllListeners('message');
+        worker.worker.removeAllListeners('error');
+        worker.worker.removeAllListeners('exit');
+        try {
+            await worker.worker.terminate();
+        }
+        catch {
+        }
+    }
+    toError(message) {
+        return new Error(`[${this.name}] ${message}`);
+    }
+}
+//# sourceMappingURL=WorkerPool.js.map

package/dist/utils/WorkerPool.js.map

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

package/dist/utils/artifacts.d.ts

@@ -0,0 +1,14 @@
+export type ArtifactCategory = 'wasm' | 'traces' | 'profiles' | 'dumps' | 'reports' | 'har' | 'sessions' | 'tmp';
+export declare function resolveArtifactPath(options: {
+    category: ArtifactCategory;
+    toolName: string;
+    target?: string;
+    ext: string;
+    customDir?: string;
+}): Promise<{
+    absolutePath: string;
+    displayPath: string;
+}>;
+export declare function getArtifactsRoot(): string;
+export declare function getArtifactDir(category: ArtifactCategory): string;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/utils/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/utils/artifacts.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,QAAQ,GACR,UAAU,GACV,OAAO,GACP,SAAS,GACT,KAAK,GACL,UAAU,GACV,KAAK,CAAC;AAaV,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA4BzD;AAKD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAKD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEjE"}

package/dist/utils/artifacts.js

@@ -0,0 +1,40 @@
+import { mkdir } from 'node:fs/promises';
+import { resolve, relative, normalize, sep } from 'node:path';
+import { getProjectRoot } from './outputPaths.js';
+const ARTIFACT_BASE = 'artifacts';
+export async function resolveArtifactPath(options) {
+    const { category, toolName, target, ext, customDir } = options;
+    const root = getProjectRoot();
+    const dir = customDir
+        ? resolve(root, customDir)
+        : resolve(root, ARTIFACT_BASE, category);
+    const normalizedRoot = normalize(root);
+    const normalizedDir = normalize(dir);
+    if (normalizedDir !== normalizedRoot && !normalizedDir.startsWith(`${normalizedRoot}${sep}`)) {
+        throw new Error(`Path traversal blocked: artifact directory "${customDir}" escapes project root`);
+    }
+    await mkdir(dir, { recursive: true });
+    const ts = new Date().toISOString().replace(/[:.]/g, '-').replace('T', '_').slice(0, 19);
+    const shortId = Math.random().toString(36).substring(2, 8);
+    const safeName = sanitizeFilename(toolName);
+    const safeTarget = target ? `-${sanitizeFilename(target)}` : '';
+    const safeExt = ext.replace(/^\./, '');
+    const filename = `${safeName}${safeTarget}-${ts}-${shortId}.${safeExt}`;
+    const absolutePath = resolve(dir, filename);
+    const displayPath = relative(root, absolutePath).replace(/\\/g, '/');
+    return { absolutePath, displayPath };
+}
+export function getArtifactsRoot() {
+    return resolve(getProjectRoot(), ARTIFACT_BASE);
+}
+export function getArtifactDir(category) {
+    return resolve(getProjectRoot(), ARTIFACT_BASE, category);
+}
+function sanitizeFilename(name) {
+    return name
+        .replace(/[^a-zA-Z0-9_-]/g, '_')
+        .replace(/_+/g, '_')
+        .replace(/^_|_$/g, '')
+        .substring(0, 60);
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/utils/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/utils/artifacts.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAYpD,MAAM,aAAa,GAAG,WAAW,CAAC;AAWlC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAMzC;IACC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC/D,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAE9B,MAAM,GAAG,GAAG,SAAS;QACnB,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;QAC1B,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;IAG3C,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,aAAa,KAAK,cAAc,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,cAAc,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC;QAC7F,MAAM,IAAI,KAAK,CAAC,+CAA+C,SAAS,wBAAwB,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAG,GAAG,QAAQ,GAAG,UAAU,IAAI,EAAE,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;IACxE,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAErE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AACvC,CAAC;AAKD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,cAAc,EAAE,EAAE,aAAa,CAAC,CAAC;AAClD,CAAC;AAKD,MAAM,UAAU,cAAc,CAAC,QAA0B;IACvD,OAAO,OAAO,CAAC,cAAc,EAAE,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAKD,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC"}

package/dist/utils/browserExecutable.d.ts

@@ -0,0 +1,5 @@
+export declare function findBrowserExecutable(): string | undefined;
+export declare function clearBrowserPathCache(): void;
+export declare function getCachedBrowserPath(): string | undefined;
+export declare const resolveBrowserExecutablePath: typeof findBrowserExecutable;
+//# sourceMappingURL=browserExecutable.d.ts.map

package/dist/utils/browserExecutable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserExecutable.d.ts","sourceRoot":"","sources":["../../src/utils/browserExecutable.ts"],"names":[],"mappings":"AA2CA,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAU1D;AAKD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAKD,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAEzD;AAKD,eAAO,MAAM,4BAA4B,8BAAwB,CAAC"}

package/dist/utils/browserExecutable.js

@@ -0,0 +1,42 @@
+import { existsSync } from 'fs';
+import puppeteer from 'rebrowser-puppeteer-core';
+const ENV_KEYS = ['CHROME_PATH', 'PUPPETEER_EXECUTABLE_PATH', 'BROWSER_EXECUTABLE_PATH'];
+let cachedBrowserPath = null;
+function resolveFromEnvironment() {
+    for (const key of ENV_KEYS) {
+        const candidate = process.env[key]?.trim();
+        if (candidate && existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+function resolveFromPuppeteer() {
+    try {
+        const candidate = puppeteer.executablePath('chrome');
+        if (candidate && existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    catch {
+    }
+    return undefined;
+}
+export function findBrowserExecutable() {
+    if (cachedBrowserPath !== null) {
+        if (!cachedBrowserPath || existsSync(cachedBrowserPath)) {
+            return cachedBrowserPath;
+        }
+        cachedBrowserPath = null;
+    }
+    cachedBrowserPath = resolveFromEnvironment() ?? resolveFromPuppeteer();
+    return cachedBrowserPath;
+}
+export function clearBrowserPathCache() {
+    cachedBrowserPath = null;
+}
+export function getCachedBrowserPath() {
+    return cachedBrowserPath ?? undefined;
+}
+export const resolveBrowserExecutablePath = findBrowserExecutable;
+//# sourceMappingURL=browserExecutable.js.map

package/dist/utils/browserExecutable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserExecutable.js","sourceRoot":"","sources":["../../src/utils/browserExecutable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,SAAS,MAAM,0BAA0B,CAAC;AASjD,MAAM,QAAQ,GAAG,CAAC,aAAa,EAAE,2BAA2B,EAAE,yBAAyB,CAAU,CAAC;AAGlG,IAAI,iBAAiB,GAA8B,IAAI,CAAC;AAExD,SAAS,sBAAsB;IAC7B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QAC3C,IAAI,SAAS,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,oBAAoB;IAC3B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,SAAS,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;IAET,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAQD,MAAM,UAAU,qBAAqB;IACnC,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,iBAAiB,IAAI,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACxD,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QACD,iBAAiB,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,iBAAiB,GAAG,sBAAsB,EAAE,IAAI,oBAAoB,EAAE,CAAC;IACvE,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAKD,MAAM,UAAU,qBAAqB;IACnC,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC;AAKD,MAAM,UAAU,oBAAoB;IAClC,OAAO,iBAAiB,IAAI,SAAS,CAAC;AACxC,CAAC;AAKD,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,CAAC"}

package/dist/utils/cache.d.ts

@@ -0,0 +1,13 @@
+import type { CacheConfig } from '../types/index.js';
+export declare class CacheManager {
+    private config;
+    constructor(config: CacheConfig);
+    init(): Promise<void>;
+    private generateKey;
+    private getCachePath;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAIzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;IAKd,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAuBtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB7B"}

package/dist/utils/cache.js

@@ -0,0 +1,98 @@
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { createHash } from 'crypto';
+import { logger } from './logger.js';
+export class CacheManager {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async init() {
+        if (!this.config.enabled) {
+            return;
+        }
+        try {
+            await fs.mkdir(this.config.dir, { recursive: true });
+            logger.debug(`Cache directory initialized: ${this.config.dir}`);
+        }
+        catch (error) {
+            logger.error('Failed to initialize cache directory', error);
+        }
+    }
+    generateKey(key) {
+        return createHash('md5').update(key).digest('hex');
+    }
+    getCachePath(key) {
+        const hashedKey = this.generateKey(key);
+        return join(this.config.dir, `${hashedKey}.json`);
+    }
+    async get(key) {
+        if (!this.config.enabled) {
+            return null;
+        }
+        try {
+            const cachePath = this.getCachePath(key);
+            const data = await fs.readFile(cachePath, 'utf-8');
+            const cached = JSON.parse(data);
+            if (Date.now() - cached.timestamp > this.config.ttl * 1000) {
+                await this.delete(key);
+                return null;
+            }
+            logger.debug(`Cache hit: ${key}`);
+            return cached.value;
+        }
+        catch {
+            logger.debug(`Cache miss: ${key}`);
+            return null;
+        }
+    }
+    async set(key, value) {
+        if (!this.config.enabled) {
+            return;
+        }
+        try {
+            const cachePath = this.getCachePath(key);
+            const data = {
+                timestamp: Date.now(),
+                value,
+            };
+            await fs.writeFile(cachePath, JSON.stringify(data), 'utf-8');
+            logger.debug(`Cache set: ${key}`);
+        }
+        catch (error) {
+            logger.error('Failed to set cache', error);
+        }
+    }
+    async delete(key) {
+        if (!this.config.enabled) {
+            return;
+        }
+        try {
+            const cachePath = this.getCachePath(key);
+            await fs.unlink(cachePath);
+            logger.debug(`Cache deleted: ${key}`);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                logger.warn('Cache delete failed:', error);
+            }
+        }
+    }
+    async clear() {
+        if (!this.config.enabled) {
+            return;
+        }
+        try {
+            const files = await fs.readdir(this.config.dir);
+            await Promise.all(files.map((file) => fs.unlink(join(this.config.dir, file))));
+            logger.info('Cache cleared');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return;
+            }
+            logger.error('Failed to clear cache', error);
+        }
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

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

package/dist/utils/concurrency.d.ts

@@ -0,0 +1,6 @@
+type LimitFunction = <T>(fn: () => Promise<T> | T) => Promise<T>;
+export declare const ioLimit: LimitFunction;
+export declare const cpuLimit: LimitFunction;
+export declare const cdpLimit: LimitFunction;
+export {};
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/utils/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAYA,KAAK,aAAa,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AA2CjE,eAAO,MAAM,OAAO,eAEnB,CAAC;AAGF,eAAO,MAAM,QAAQ,eAEpB,CAAC;AAGF,eAAO,MAAM,QAAQ,eAEpB,CAAC"}

package/dist/utils/concurrency.js

@@ -0,0 +1,42 @@
+function pLimit(concurrency) {
+    if (concurrency < 1)
+        throw new RangeError('concurrency must be >= 1');
+    let activeCount = 0;
+    const queue = [];
+    function next() {
+        if (queue.length > 0 && activeCount < concurrency) {
+            activeCount++;
+            const resolve = queue.shift();
+            resolve();
+        }
+    }
+    function run(fn) {
+        return new Promise((resolve, reject) => {
+            const execute = async () => {
+                try {
+                    const result = await fn();
+                    resolve(result);
+                }
+                catch (err) {
+                    reject(err);
+                }
+                finally {
+                    activeCount--;
+                    next();
+                }
+            };
+            if (activeCount < concurrency) {
+                activeCount++;
+                execute();
+            }
+            else {
+                queue.push(() => { execute(); });
+            }
+        });
+    }
+    return run;
+}
+export const ioLimit = pLimit(parseInt(process.env.jshook_IO_CONCURRENCY || '4', 10));
+export const cpuLimit = pLimit(parseInt(process.env.jshook_CPU_CONCURRENCY || '2', 10));
+export const cdpLimit = pLimit(parseInt(process.env.jshook_CDP_CONCURRENCY || '2', 10));
+//# sourceMappingURL=concurrency.js.map

package/dist/utils/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAcA,SAAS,MAAM,CAAC,WAAmB;IACjC,IAAI,WAAW,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,0BAA0B,CAAC,CAAC;IAEtE,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,KAAK,GAAsB,EAAE,CAAC;IAEpC,SAAS,IAAI;QACX,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,GAAG,WAAW,EAAE,CAAC;YAClD,WAAW,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,SAAS,GAAG,CAAI,EAAwB;QACtC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;gBACzB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;oBAC1B,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;wBAAS,CAAC;oBACT,WAAW,EAAE,CAAC;oBACd,IAAI,EAAE,CAAC;gBACT,CAAC;YACH,CAAC,CAAC;YAEF,IAAI,WAAW,GAAG,WAAW,EAAE,CAAC;gBAC9B,WAAW,EAAE,CAAC;gBACd,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAGD,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAC3B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,GAAG,EAAE,EAAE,CAAC,CACvD,CAAC;AAGF,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAC5B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,GAAG,EAAE,EAAE,CAAC,CACxD,CAAC;AAGF,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAC5B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,GAAG,EAAE,EAAE,CAAC,CACxD,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,8 @@
+import type { Config } from '../types/index.js';
+export declare const projectRoot: string;
+export declare function getConfig(): Config;
+export declare function validateConfig(config: Config): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIpD,eAAO,MAAM,WAAW,QAAmC,CAAC;AAuD5D,wBAAgB,SAAS,IAAI,MAAM,CA0DlC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAoBnF"}