@comake/skl-js-engine 1.5.4 → 1.5.5

package/dist/JsExecutor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/JsExecutor/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,sBAAsB;AACtB,YAAY;AACZ,yCAA6E;AAApE,sHAAA,yBAAyB,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AACvD,gBAAgB;AAChB,mCAA4G;AAAnG,4GAAA,kBAAkB,OAAA;AAAE,+GAAA,qBAAqB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AACzF,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,yCAAyC;AACzC,yDAAqF;AAA5E,yHAAA,oBAAoB,OAAA;AAAE,6HAAA,wBAAwB,OAAA;AACvD,8CAA4B","sourcesContent":["// Main executor class\n// Constants\nexport { DEFAULT_EXECUTION_OPTIONS, EXECUTION_CONSTANTS } from './constants';\n// Error classes\nexport { CodeExecutionError, ExecutionTimeoutError, OutputParsingError, ProcessSpawnError } from './errors';\nexport { JSExecutor } from './jsExecutor';\n// Utility functions (for advanced usage)\nexport { buildDenoPermissions, validatePermissionConfig } from './PermissionBuilder';\nexport * from './transport';\n// Types and interfaces\nexport type {\n  ExecutionOptions,\n  ExecutionResult,\n  ExecutorInput,\n  ExecutorOutput,\n  PermissionConfig,\n  ProcessCommunicationData\n} from './types';\n\n"]}

package/dist/JsExecutor/jsExecutor.d.ts

@@ -0,0 +1,68 @@
+import type { TransportConfig } from './transport';
+import type { ExecutionOptions, IShutdownOptions } from './types';
+export declare type IJSCallbacks = Record<string, (...args: any[]) => any>;
+/**
+ * JSExecutor V2 with enhanced abort control for immediate shutdown
+ *
+ * @example Writing abort-aware callbacks:
+ * ```typescript
+ * const jsExecutor = new JSExecutorV2(scriptPath, {
+ *   async myCallback(): Promise<string> {
+ *     return new Promise((resolve, reject) => {
+ *       const timeoutId = setTimeout(() => resolve('done'), 5000);
+ *
+ *       // Listen to the global abort signal to clean up resources
+ *       const abortSignal = JSExecutorV2.getGlobalAbortSignal();
+ *       const onAbort = () => {
+ *         clearTimeout(timeoutId);
+ *         reject(new Error('Operation aborted'));
+ *       };
+ *
+ *       if (abortSignal.aborted) {
+ *         onAbort();
+ *         return;
+ *       }
+ *
+ *       abortSignal.addEventListener('abort', onAbort);
+ *     });
+ *   }
+ * });
+ * ```
+ */
+export declare class JSExecutor {
+    private readonly executorScriptPath;
+    private readonly callbacks;
+    private isInitialized;
+    private server?;
+    private transport?;
+    private readonly abortController;
+    private static readonly globalAbortController;
+    private shutdownTimeout?;
+    constructor(executorScriptPath: string, callbacks: Record<string, (...args: any[]) => any>);
+    /**
+     * Static method to check if any JSExecutor instance is being shut down
+     * Callbacks can use this to check if they should abort their operations
+     */
+    static isShuttingDown(): boolean;
+    /**
+     * Get the global abort signal that callbacks can listen to
+     * This allows callbacks to immediately abort when any JSExecutor shuts down
+     */
+    static getGlobalAbortSignal(): AbortSignal;
+    initialize(config?: TransportConfig, executionOptions?: ExecutionOptions): Promise<void>;
+    shutdown(options?: IShutdownOptions): Promise<void>;
+    private shutdownCore;
+    private rpcComplaintCallback;
+    /**
+     * Wrap a callback with abort functionality
+     * The callback will be automatically aborted if JSExecutor is shut down
+     */
+    private wrapCallbackWithAbort;
+    execute(code: string, args: Record<string, any>, executionOptions: ExecutionOptions): Promise<any>;
+    /**
+     * Legacy method for backward compatibility
+     * @deprecated Use execute() instead
+     */
+    call(methodName: string, ...args: any[]): Promise<any>;
+}
+//# sourceMappingURL=jsExecutor.d.ts.map

package/dist/JsExecutor/jsExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsExecutor.d.ts","sourceRoot":"","sources":["../../src/JsExecutor/jsExecutor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAElE,oBAAY,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,UAAU;IASnB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAT5B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAgB;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAyB;IACtE,OAAO,CAAC,eAAe,CAAC,CAAiB;gBAGtB,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IAGrE;;;OAGG;WACW,cAAc,IAAI,OAAO;IAIvC;;;OAGG;WACW,oBAAoB,IAAI,WAAW;IAIpC,UAAU,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBxF,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YAgBlD,YAAY;YAgBZ,oBAAoB;IAMlC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAqChB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAwB/G;;;OAGG;IACU,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;CAMpE"}

package/dist/JsExecutor/jsExecutor.js

@@ -0,0 +1,171 @@
+"use strict";
+/* eslint-disable @typescript-eslint/naming-convention */
+/* eslint-disable callback-return */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSExecutor = void 0;
+const errors_1 = require("./errors");
+const transport_1 = require("./transport");
+/**
+ * JSExecutor V2 with enhanced abort control for immediate shutdown
+ *
+ * @example Writing abort-aware callbacks:
+ * ```typescript
+ * const jsExecutor = new JSExecutorV2(scriptPath, {
+ *   async myCallback(): Promise<string> {
+ *     return new Promise((resolve, reject) => {
+ *       const timeoutId = setTimeout(() => resolve('done'), 5000);
+ *
+ *       // Listen to the global abort signal to clean up resources
+ *       const abortSignal = JSExecutorV2.getGlobalAbortSignal();
+ *       const onAbort = () => {
+ *         clearTimeout(timeoutId);
+ *         reject(new Error('Operation aborted'));
+ *       };
+ *
+ *       if (abortSignal.aborted) {
+ *         onAbort();
+ *         return;
+ *       }
+ *
+ *       abortSignal.addEventListener('abort', onAbort);
+ *     });
+ *   }
+ * });
+ * ```
+ */
+class JSExecutor {
+    constructor(executorScriptPath, callbacks) {
+        this.executorScriptPath = executorScriptPath;
+        this.callbacks = callbacks;
+        this.isInitialized = false;
+        this.abortController = new AbortController();
+    }
+    /**
+     * Static method to check if any JSExecutor instance is being shut down
+     * Callbacks can use this to check if they should abort their operations
+     */
+    static isShuttingDown() {
+        return JSExecutor.globalAbortController.signal.aborted;
+    }
+    /**
+     * Get the global abort signal that callbacks can listen to
+     * This allows callbacks to immediately abort when any JSExecutor shuts down
+     */
+    static getGlobalAbortSignal() {
+        return JSExecutor.globalAbortController.signal;
+    }
+    async initialize(config, executionOptions) {
+        if (this.isInitialized) {
+            return;
+        }
+        this.server = new transport_1.JsonRpcServer({
+            // 1 hour
+            requestTimeout: 60 * 60 * 1000
+        });
+        // Register callbacks with the server
+        Object.entries(this.callbacks).forEach(([methodName, callback]) => {
+            this.server.registerMethod(methodName, this.wrapCallbackWithAbort(callback));
+        });
+        // Create and initialize the transport once
+        this.transport = new transport_1.ParentStdioTransport(this.executorScriptPath, this.server);
+        await this.transport.initialize(config, executionOptions);
+        this.isInitialized = true;
+    }
+    async shutdown(options) {
+        // Clear any existing shutdown timeout
+        if (this.shutdownTimeout) {
+            clearTimeout(this.shutdownTimeout);
+            this.shutdownTimeout = undefined;
+        }
+        if (options?.afterTimeout) {
+            this.shutdownTimeout = setTimeout(async () => {
+                await this.shutdownCore();
+            }, options.afterTimeout);
+        }
+        else {
+            await this.shutdownCore();
+        }
+    }
+    async shutdownCore() {
+        // // Signal global abort first
+        // JSExecutor.globalAbortController.abort();
+        // Then signal this instance's abort
+        this.abortController.abort();
+        if (this.transport) {
+            await this.transport.close();
+            this.transport = undefined;
+        }
+        this.isInitialized = false;
+        this.server = undefined;
+    }
+    async rpcComplaintCallback(callback, args) {
+        const result = await callback(...args);
+        // RPC expects a result object
+        return result ?? {};
+    }
+    /**
+     * Wrap a callback with abort functionality
+     * The callback will be automatically aborted if JSExecutor is shut down
+     */
+    wrapCallbackWithAbort(callback) {
+        return ((...args) => {
+            // Check if we're shutting down before executing
+            if (this.abortController.signal.aborted || JSExecutor.globalAbortController.signal.aborted) {
+                return Promise.reject(new Error('JSExecutor is shutting down'));
+            }
+            const callbackPromise = Promise.resolve(this.rpcComplaintCallback(callback, args));
+            const instanceAbortSignal = this.abortController.signal;
+            const globalAbortSignal = JSExecutor.globalAbortController.signal;
+            let onAbort;
+            // Create an abort promise
+            const abortPromise = new Promise((_, reject) => {
+                onAbort = () => {
+                    reject(new Error('JSExecutor is shutting down'));
+                };
+                // Listen to both instance and global abort signals
+                // NOTE: `{ once: true }` removes listeners only if abort fires. In normal request flow,
+                // abort rarely happens, so these listeners would otherwise accumulate per-call.
+                instanceAbortSignal.addEventListener('abort', onAbort, { once: true });
+                globalAbortSignal.addEventListener('abort', onAbort, { once: true });
+            });
+            // Race the callback against the abort signal
+            return Promise.race([callbackPromise, abortPromise]).finally(() => {
+                // If the callback completes, remove abort listeners to prevent a listener leak.
+                if (onAbort) {
+                    instanceAbortSignal.removeEventListener('abort', onAbort);
+                    globalAbortSignal.removeEventListener('abort', onAbort);
+                }
+            });
+        });
+    }
+    async execute(code, args, executionOptions) {
+        if (!this.isInitialized) {
+            throw new errors_1.NotInitializedError('JSExecutor is not initialized, please call initialize() first');
+        }
+        if (!this.transport || !this.transport.isReady()) {
+            throw new Error('Transport is not ready');
+        }
+        const response = await this.transport.request(transport_1.STANDARD_METHODS.executeCode, {
+            code,
+            args,
+            functionName: executionOptions.functionName
+        }, {
+            timeout: executionOptions.timeout,
+            retries: executionOptions.retries ?? 0
+        });
+        return response;
+    }
+    /**
+     * Legacy method for backward compatibility
+     * @deprecated Use execute() instead
+     */
+    async call(methodName, ...args) {
+        if (!this.transport || !this.transport.isReady()) {
+            throw new Error('Transport is not ready');
+        }
+        return this.transport.request(methodName, args);
+    }
+}
+exports.JSExecutor = JSExecutor;
+JSExecutor.globalAbortController = new AbortController();
+//# sourceMappingURL=jsExecutor.js.map

package/dist/JsExecutor/jsExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsExecutor.js","sourceRoot":"","sources":["../../src/JsExecutor/jsExecutor.ts"],"names":[],"mappings":";AAAA,yDAAyD;AACzD,oCAAoC;;;AAIpC,qCAA+C;AAE/C,2CAAoF;AAKpF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAa,UAAU;IAQrB,YACmB,kBAA0B,EAC1B,SAAkD;QADlD,uBAAkB,GAAlB,kBAAkB,CAAQ;QAC1B,cAAS,GAAT,SAAS,CAAyC;QAT7D,kBAAa,GAAG,KAAK,CAAC;QAGb,oBAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAOtD,CAAC;IAEJ;;;OAGG;IACI,MAAM,CAAC,cAAc;QAC1B,OAAO,UAAU,CAAC,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC;IACzD,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,oBAAoB;QAChC,OAAO,UAAU,CAAC,qBAAqB,CAAC,MAAM,CAAC;IACjD,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,MAAwB,EAAE,gBAAmC;QACnF,IAAI,IAAI,CAAC,aAAa,EAAE;YACtB,OAAO;SACR;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,yBAAa,CAAC;YAC9B,SAAS;YACT,cAAc,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;SAC/B,CAAC,CAAC;QAEH,qCAAqC;QACrC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,UAAU,EAAE,QAAQ,CAAE,EAAE,EAAE;YAClE,IAAI,CAAC,MAAO,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;QAEH,2CAA2C;QAC3C,IAAI,CAAC,SAAS,GAAG,IAAI,gCAAoB,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhF,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAE1D,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,OAA0B;QAC9C,sCAAsC;QACtC,IAAI,IAAI,CAAC,eAAe,EAAE;YACxB,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACnC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;SAClC;QAED,IAAI,OAAO,EAAE,YAAY,EAAE;YACzB,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,KAAK,IAAG,EAAE;gBAC1C,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC5B,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;SAC1B;aAAM;YACL,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;SAC3B;IACH,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,+BAA+B;QAC/B,4CAA4C;QAE5C,oCAAoC;QACpC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAE7B,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;SAC5B;QAED,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAAC,QAAiC,EAAE,IAAW;QAC/E,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACvC,8BAA8B;QAC9B,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;IAED;;;OAGG;IACK,qBAAqB,CAAoC,QAAW;QAC1E,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE;YACzB,gDAAgD;YAChD,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,IAAI,UAAU,CAAC,qBAAqB,CAAC,MAAM,CAAC,OAAO,EAAE;gBAC1F,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;aACjE;YAED,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YAEnF,MAAM,mBAAmB,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;YACxD,MAAM,iBAAiB,GAAG,UAAU,CAAC,qBAAqB,CAAC,MAAM,CAAC;YAClE,IAAI,OAAiC,CAAC;YAEtC,0BAA0B;YAC1B,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC7C,OAAO,GAAG,GAAS,EAAE;oBACnB,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;gBACnD,CAAC,CAAC;gBAEF,mDAAmD;gBACnD,wFAAwF;gBACxF,gFAAgF;gBAChF,mBAAmB,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvE,iBAAiB,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,CAAC,CAAC,CAAC;YAEH,6CAA6C;YAC7C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAE,eAAe,EAAE,YAAY,CAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;gBAClE,gFAAgF;gBAChF,IAAI,OAAO,EAAE;oBACX,mBAAmB,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC1D,iBAAiB,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;iBACzD;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAM,CAAC;IACV,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAyB,EAAE,gBAAkC;QAC9F,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;YACvB,MAAM,IAAI,4BAAmB,CAAC,+DAA+D,CAAC,CAAC;SAChG;QAED,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE;YAChD,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;SAC3C;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAC3C,4BAAgB,CAAC,WAAW,EAC5B;YACE,IAAI;YACJ,IAAI;YACJ,YAAY,EAAE,gBAAgB,CAAC,YAAY;SAC5C,EACD;YACE,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,OAAO,EAAE,gBAAgB,CAAC,OAAO,IAAI,CAAC;SACvC,CACF,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,GAAG,IAAW;QAClD,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE;YAChD,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;SAC3C;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;;AApKH,gCAqKC;AAhKyB,gCAAqB,GAAG,IAAI,eAAe,EAAE,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention */\n/* eslint-disable callback-return */\n\n \n\nimport { NotInitializedError } from './errors';\nimport type { TransportConfig } from './transport';\nimport { JsonRpcServer, ParentStdioTransport, STANDARD_METHODS } from './transport';\nimport type { ExecutionOptions, IShutdownOptions } from './types';\n\nexport type IJSCallbacks = Record<string, (...args: any[]) => any>;\n\n/**\n * JSExecutor V2 with enhanced abort control for immediate shutdown\n *\n * @example Writing abort-aware callbacks:\n * ```typescript\n * const jsExecutor = new JSExecutorV2(scriptPath, {\n *   async myCallback(): Promise<string> {\n *     return new Promise((resolve, reject) => {\n *       const timeoutId = setTimeout(() => resolve('done'), 5000);\n *\n *       // Listen to the global abort signal to clean up resources\n *       const abortSignal = JSExecutorV2.getGlobalAbortSignal();\n *       const onAbort = () => {\n *         clearTimeout(timeoutId);\n *         reject(new Error('Operation aborted'));\n *       };\n *\n *       if (abortSignal.aborted) {\n *         onAbort();\n *         return;\n *       }\n *\n *       abortSignal.addEventListener('abort', onAbort);\n *     });\n *   }\n * });\n * ```\n */\nexport class JSExecutor {\n  private isInitialized = false;\n  private server?: JsonRpcServer;\n  private transport?: ParentStdioTransport;\n  private readonly abortController = new AbortController();\n  private static readonly globalAbortController = new AbortController();\n  private shutdownTimeout?: NodeJS.Timeout;\n\n  public constructor(\n    private readonly executorScriptPath: string,\n    private readonly callbacks: Record<string, (...args: any[]) => any>\n  ) {}\n\n  /**\n   * Static method to check if any JSExecutor instance is being shut down\n   * Callbacks can use this to check if they should abort their operations\n   */\n  public static isShuttingDown(): boolean {\n    return JSExecutor.globalAbortController.signal.aborted;\n  }\n\n  /**\n   * Get the global abort signal that callbacks can listen to\n   * This allows callbacks to immediately abort when any JSExecutor shuts down\n   */\n  public static getGlobalAbortSignal(): AbortSignal {\n    return JSExecutor.globalAbortController.signal;\n  }\n\n  public async initialize(config?: TransportConfig, executionOptions?: ExecutionOptions): Promise<void> {\n    if (this.isInitialized) {\n      return;\n    }\n\n    this.server = new JsonRpcServer({\n      // 1 hour\n      requestTimeout: 60 * 60 * 1000\n    });\n\n    // Register callbacks with the server\n    Object.entries(this.callbacks).forEach(([ methodName, callback ]) => {\n      this.server!.registerMethod(methodName, this.wrapCallbackWithAbort(callback));\n    });\n\n    // Create and initialize the transport once\n    this.transport = new ParentStdioTransport(this.executorScriptPath, this.server);\n\n    await this.transport.initialize(config, executionOptions);\n\n    this.isInitialized = true;\n  }\n\n  public async shutdown(options?: IShutdownOptions): Promise<void> {\n    // Clear any existing shutdown timeout\n    if (this.shutdownTimeout) {\n      clearTimeout(this.shutdownTimeout);\n      this.shutdownTimeout = undefined;\n    }\n\n    if (options?.afterTimeout) {\n      this.shutdownTimeout = setTimeout(async() => {\n        await this.shutdownCore();\n      }, options.afterTimeout);\n    } else {\n      await this.shutdownCore();\n    }\n  }\n\n  private async shutdownCore(): Promise<void> {\n    // // Signal global abort first\n    // JSExecutor.globalAbortController.abort();\n\n    // Then signal this instance's abort\n    this.abortController.abort();\n\n    if (this.transport) {\n      await this.transport.close();\n      this.transport = undefined;\n    }\n\n    this.isInitialized = false;\n    this.server = undefined;\n  }\n\n  private async rpcComplaintCallback(callback: (...args: any[]) => any, args: any[]): Promise<any> {\n    const result = await callback(...args);\n    // RPC expects a result object\n    return result ?? {};\n  }\n\n  /**\n   * Wrap a callback with abort functionality\n   * The callback will be automatically aborted if JSExecutor is shut down\n   */\n  private wrapCallbackWithAbort<T extends (...args: any[]) => any>(callback: T): T {\n    return ((...args: any[]) => {\n      // Check if we're shutting down before executing\n      if (this.abortController.signal.aborted || JSExecutor.globalAbortController.signal.aborted) {\n        return Promise.reject(new Error('JSExecutor is shutting down'));\n      }\n\n      const callbackPromise = Promise.resolve(this.rpcComplaintCallback(callback, args));\n\n      const instanceAbortSignal = this.abortController.signal;\n      const globalAbortSignal = JSExecutor.globalAbortController.signal;\n      let onAbort: (() => void) | undefined;\n\n      // Create an abort promise\n      const abortPromise = new Promise((_, reject) => {\n        onAbort = (): void => {\n          reject(new Error('JSExecutor is shutting down'));\n        };\n\n        // Listen to both instance and global abort signals\n        // NOTE: `{ once: true }` removes listeners only if abort fires. In normal request flow,\n        // abort rarely happens, so these listeners would otherwise accumulate per-call.\n        instanceAbortSignal.addEventListener('abort', onAbort, { once: true });\n        globalAbortSignal.addEventListener('abort', onAbort, { once: true });\n      });\n\n      // Race the callback against the abort signal\n      return Promise.race([ callbackPromise, abortPromise ]).finally(() => {\n        // If the callback completes, remove abort listeners to prevent a listener leak.\n        if (onAbort) {\n          instanceAbortSignal.removeEventListener('abort', onAbort);\n          globalAbortSignal.removeEventListener('abort', onAbort);\n        }\n      });\n    }) as T;\n  }\n\n  public async execute(code: string, args: Record<string, any>, executionOptions: ExecutionOptions): Promise<any> {\n    if (!this.isInitialized) {\n      throw new NotInitializedError('JSExecutor is not initialized, please call initialize() first');\n    }\n\n    if (!this.transport || !this.transport.isReady()) {\n      throw new Error('Transport is not ready');\n    }\n\n    const response = await this.transport.request(\n      STANDARD_METHODS.executeCode,\n      {\n        code,\n        args,\n        functionName: executionOptions.functionName\n      },\n      {\n        timeout: executionOptions.timeout,\n        retries: executionOptions.retries ?? 0\n      }\n    );\n    return response;\n  }\n\n  /**\n   * Legacy method for backward compatibility\n   * @deprecated Use execute() instead\n   */\n  public async call(methodName: string, ...args: any[]): Promise<any> {\n    if (!this.transport || !this.transport.isReady()) {\n      throw new Error('Transport is not ready');\n    }\n    return this.transport.request(methodName, args);\n  }\n}\n"]}

package/dist/JsExecutor/jsonRpc/JsonRpcClient.d.ts

@@ -0,0 +1,165 @@
+import type { JsonRpcClientConfig, JsonRpcId, JsonRpcParams, JsonRpcRequest, JsonRpcResponse } from './types';
+/**
+ * Event emitter interface for JSON-RPC client events
+ */
+export interface JsonRpcClientEvents {
+    request: (request: JsonRpcRequest) => void;
+    response: (response: JsonRpcResponse) => void;
+    error: (error: Error) => void;
+    timeout: (request: JsonRpcRequest) => void;
+}
+/**
+ * Transport interface for sending messages
+ */
+export interface ClientTransport {
+    send: (message: string) => Promise<void>;
+    onMessage: (handler: (message: string) => void) => void;
+    close: () => Promise<void>;
+}
+/**
+ * JSON-RPC 2.0 Client implementation
+ */
+export declare class JsonRpcClient {
+    private readonly config;
+    private readonly pendingRequests;
+    private readonly listeners;
+    private requestIdCounter;
+    private transport?;
+    constructor(config?: JsonRpcClientConfig);
+    /**
+     * Set the transport for sending messages
+     * @param transport - Transport implementation
+     */
+    setTransport(transport: ClientTransport): void;
+    /**
+     * Send a JSON-RPC request and wait for response
+     * @param method - Method name
+     * @param params - Method parameters
+     * @param options - Request options
+     * @returns Promise resolving to the response result
+     */
+    request<TParams = JsonRpcParams, TResult = any>(method: string, params?: TParams, options?: {
+        timeout?: number;
+        retries?: number;
+    }): Promise<TResult>;
+    /**
+     * Send a JSON-RPC notification (no response expected)
+     * @param method - Method name
+     * @param params - Method parameters
+     */
+    notify<TParams = JsonRpcParams>(method: string, params?: TParams): Promise<void>;
+    /**
+     * Send a batch of requests
+     * @param requests - Array of request specifications
+     * @returns Promise resolving to array of results
+     */
+    batch(requests: {
+        method: string;
+        params?: any;
+        id?: JsonRpcId;
+    }[]): Promise<any[]>;
+    /**
+     * Handle incoming message from transport
+     * @param messageData - Raw message data
+     */
+    handleIncomingMessage(messageData: string): Promise<void>;
+    /**
+     * Handle a single response message
+     * @param response - JSON-RPC response
+     */
+    private handleResponse;
+    /**
+     * Send a request with timeout handling
+     * @param request - JSON-RPC request
+     * @param timeout - Timeout in milliseconds
+     * @returns Promise resolving to the result
+     */
+    private sendRequestWithTimeout;
+    /**
+     * Create a pending request promise with timeout
+     * @param request - JSON-RPC request
+     * @param timeout - Timeout in milliseconds
+     * @returns Promise resolving to the result
+     */
+    private createPendingRequest;
+    /**
+     * Create a JSON-RPC request
+     * @param method - Method name
+     * @param params - Method parameters
+     * @param id - Optional request ID
+     * @returns JSON-RPC request object
+     */
+    private createRequest;
+    /**
+     * Create a JSON-RPC notification
+     * @param method - Method name
+     * @param params - Method parameters
+     * @returns JSON-RPC notification object
+     */
+    private createNotification;
+    /**
+     * Generate a unique request ID
+     * @returns Unique request ID
+     */
+    private generateId;
+    /**
+     * Check if response is a success response
+     * @param response - JSON-RPC response
+     * @returns True if success response
+     */
+    private isSuccessResponse;
+    /**
+     * Check if an error should not be retried
+     * @param error - Error to check
+     * @returns True if error should not be retried
+     */
+    private shouldNotRetry;
+    /**
+     * Delay execution for specified milliseconds
+     * @param ms - Delay in milliseconds
+     * @returns Promise that resolves after delay
+     */
+    private delay;
+    /**
+     * Register event listener
+     * @param event - Event name
+     * @param listener - Event listener
+     */
+    on<TKey extends keyof JsonRpcClientEvents>(event: TKey, listener: JsonRpcClientEvents[TKey]): void;
+    /**
+     * Remove event listener
+     * @param event - Event name
+     * @param listener - Event listener
+     */
+    off<TKey extends keyof JsonRpcClientEvents>(event: TKey, listener: JsonRpcClientEvents[TKey]): void;
+    /**
+     * Emit event
+     * @param event - Event name
+     * @param args - Event arguments
+     */
+    private emit;
+    /**
+     * Get client statistics
+     * @returns Client statistics
+     */
+    getStats(): {
+        pendingRequests: number;
+        totalRequests: number;
+        config: Required<JsonRpcClientConfig>;
+    };
+    /**
+     * Cancel all pending requests
+     */
+    cancelAllRequests(): void;
+    /**
+     * Cancel a specific request
+     * @param id - Request ID to cancel
+     * @returns True if request was cancelled
+     */
+    cancelRequest(id: JsonRpcId): boolean;
+    /**
+     * Close the client and cleanup resources
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=JsonRpcClient.d.ts.map

package/dist/JsExecutor/jsonRpc/JsonRpcClient.d.ts.map

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