ee-core 4.1.5 → 5.0.0-beta.5

package/dist/esm/jobs/child/jobProcess.js

@@ -0,0 +1,196 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobProcess = void 0;
+/**
+ * @module jobs/child/jobProcess
+ * @description Child process manager. Encapsulates child_process.fork() creation and communication logic,
+ * providing the main process with the ability to create child processes, send messages, and terminate processes.
+ *
+ * Communication mechanism:
+ * - Main process sends JobMessage to child process via child.send()
+ * - Child process sends ProcessMessage to main process via process.send()
+ * - Messages are categorized by channel: showException (exception), sendToMain (business message)
+ * - Messages are dispatched by eventReceiver: childJob (global), forkProcess (per-process), all (both)
+ */
+const path_1 = __importDefault(require("path"));
+const events_1 = require("events");
+const child_process_1 = require("child_process");
+const serialize_javascript_1 = __importDefault(require("serialize-javascript"));
+const index_js_1 = require("../../log/index.js");
+const index_js_2 = require("../../ps/index.js");
+const index_js_3 = require("../../config/index.js");
+const channel_js_1 = require("../../const/channel.js");
+const helper_js_1 = require("../../utils/helper.js");
+const index_js_4 = require("../../loader/index.js");
+const extend_js_1 = require("../../utils/extend.js");
+/**
+ * JobProcess - Child process manager
+ *
+ * Encapsulates the complete logic of forking a child process:
+ * 1. Determine app.js entry path (child process entry within node_modules/ee-core)
+ * 2. Configure working directory and environment variables
+ * 3. Fork the child process and register event listeners
+ * 4. Provide dispatch() and callFunc() for sending messages
+ * 5. Provide kill() for terminating the process
+ */
+class JobProcess {
+    constructor(host, opt = {}, config = { messageLog: false }) {
+        let cwd = (0, index_js_2.getBaseDir)();
+        // Locate app.js entry: child process startup file within the ee-core package
+        const currentFilePath = typeof __filename !== 'undefined' ? __filename : '';
+        const appPath = path_1.default.join(path_1.default.dirname(currentFilePath), 'app.js');
+        // After packaging, cwd must be outside app.asar (child processes need access to node_modules)
+        if ((0, index_js_2.isPackaged)()) {
+            cwd = path_1.default.join((0, index_js_2.getBaseDir)(), '..');
+        }
+        const defaultOptions = {
+            processArgs: {
+                type: 'childJob',
+                // Pass main process config to child process so it doesn't need to load from filesystem
+                eeConfig: (0, index_js_3.getConfig)(),
+            },
+            processOptions: {
+                cwd,
+                env: (0, index_js_2.allEnv)(),
+                stdio: ['ignore', 'pipe', 'pipe', 'ipc'],
+            },
+        };
+        const options = (0, extend_js_1.extend)(true, defaultOptions, opt);
+        this.emitter = new events_1.EventEmitter();
+        this.host = host;
+        this.args = [];
+        this.sleeping = false;
+        this.config = config;
+        // Serialize arguments and pass them to the child process
+        this.args.push(JSON.stringify(options.processArgs));
+        this.child = (0, child_process_1.fork)(appPath, this.args, options.processOptions ?? {});
+        this.pid = this.child.pid;
+        this._init();
+    }
+    /**
+     * Initialize child process event listeners
+     *
+     * Listens for three types of events:
+     * - message: Process messages from the child process (exception display, business message forwarding)
+     * - exit: Child process exited, notify host to clean up
+     * - error: Child process error, notify host to clean up
+     */
+    _init() {
+        const { messageLog } = this.config;
+        this.child.on('message', (m) => {
+            if (messageLog) {
+                index_js_1.coreLogger.info(`[jobs/child] received a message from child-process, message: ${(0, serialize_javascript_1.default)(m)}`);
+            }
+            // Exception message: log it
+            if (m.channel === channel_js_1.Processes.showException) {
+                index_js_1.coreLogger.error(`${m.data}`);
+            }
+            // Business message: dispatch based on eventReceiver
+            if (m.channel === channel_js_1.Processes.sendToMain) {
+                this._eventEmit(m);
+            }
+        });
+        // Capture child process stdout/stderr for debugging
+        const stdout = this.child.stdout;
+        const stderr = this.child.stderr;
+        if (stdout) {
+            stdout.on('data', (data) => {
+                index_js_1.coreLogger.info(`[jobs/child] stdout: ${data.toString().trim()}`);
+            });
+        }
+        if (stderr) {
+            stderr.on('data', (data) => {
+                index_js_1.coreLogger.error(`[jobs/child] stderr: ${data.toString().trim()}`);
+            });
+        }
+        this.child.on('exit', (code, signal) => {
+            const data = { pid: this.pid };
+            this.host.emit(channel_js_1.Events.childProcessExit, data);
+            index_js_1.coreLogger.info(`[jobs/child] received a exit from child-process, code:${code}, signal:${signal}, pid:${this.pid}`);
+        });
+        this.child.on('error', (err) => {
+            const data = { pid: this.pid };
+            this.host.emit(channel_js_1.Events.childProcessError, data);
+            index_js_1.coreLogger.error(`[jobs/child] received a error from child-process, error: ${err}, pid:${this.pid}`);
+        });
+    }
+    /**
+     * Dispatch messages to different event emitters based on eventReceiver
+     *
+     * - forkProcess: send only to in-process emitter
+     * - childJob: send only to host emitter
+     * - all / others: send to both
+     */
+    _eventEmit(m) {
+        switch (m.eventReceiver) {
+            case channel_js_1.Receiver.forkProcess:
+                this.emitter.emit(m.event, m.data);
+                break;
+            case channel_js_1.Receiver.childJob:
+                this.host.emit(m.event, m.data);
+                break;
+            default:
+                this.host.emit(m.event, m.data);
+                this.emitter.emit(m.event, m.data);
+                break;
+        }
+    }
+    /**
+     * Send a dispatch message to the child process
+     *
+     * @param cmd - Command (e.g. 'run')
+     * @param jobPath - Task file path
+     * @param params - Task parameters
+     */
+    dispatch(cmd, jobPath = '', ...params) {
+        const mid = (0, helper_js_1.getRandomString)();
+        const msg = {
+            mid,
+            cmd,
+            jobPath,
+            jobParams: params,
+        };
+        this.child.send(msg);
+    }
+    /**
+     * Call a specified method on the task instance in the child process
+     *
+     * Resolves the task file path, then sends a run command with the specified function name.
+     *
+     * @param jobPath - Task file path (relative paths are resolved to absolute paths)
+     * @param funcName - Method name to call
+     * @param params - Method arguments
+     */
+    callFunc(jobPath = '', funcName = '', ...params) {
+        const fullPath = (0, index_js_4.getFullpath)(jobPath);
+        const mid = (0, helper_js_1.getRandomString)();
+        const msg = {
+            mid,
+            cmd: 'run',
+            jobPath: fullPath,
+            jobFunc: funcName,
+            jobFuncParams: params,
+        };
+        this.child.send(msg);
+    }
+    /**
+     * Terminate the child process
+     *
+     * First sends SIGINT for graceful exit, then sends SIGKILL to force termination after timeout.
+     *
+     * @param timeout - Timeout in milliseconds to wait for graceful exit
+     */
+    kill(timeout = 1000) {
+        this.child.kill('SIGINT');
+        setTimeout(() => {
+            if (this.child.killed)
+                return;
+            this.child.kill('SIGKILL');
+        }, timeout);
+    }
+}
+exports.JobProcess = JobProcess;
+//# sourceMappingURL=jobProcess.js.map

package/dist/esm/jobs/child/jobProcess.js.map

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

package/dist/esm/jobs/child-pool/index.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @module jobs/child-pool
+ * @description Child process pool manager. Maintains a set of child processes, distributes tasks
+ * through a load balancing algorithm, avoiding the overhead of frequent process creation and destruction.
+ *
+ * Core features:
+ * - Pool size: min=3, max=6, configurable
+ * - Load balancing: supports multiple algorithms (polling/weights/random, etc.), default is polling
+ * - Process binding: binds specific IDs to fixed processes via boundMap (e.g. session binding)
+ * - Auto cleanup: child processes are automatically removed from the pool on exit/error
+ *
+ * Usage:
+ * ```ts
+ * const pool = new ChildPoolJob();
+ * await pool.create(3); // Create 3 child processes
+ * await pool.run('service/job'); // Load balancer selects a process to execute
+ * ```
+ */
+import { EventEmitter } from 'events';
+import { LoadBalancer } from '../load-balancer/index.js';
+import { JobProcess } from '../child/jobProcess.js';
+import type { JobsConfig } from '../../types/index.js';
+/** Child process pool options */
+export interface ChildPoolOptions {
+    /** Weight values for each process (used by weighted load balancing algorithms) */
+    weights?: number[];
+}
+/**
+ * ChildPoolJob - Child process pool
+ *
+ * Manages a set of child processes, distributes tasks through LoadBalancer.
+ * Inherits EventEmitter, listens for child process exit/error events for auto cleanup.
+ */
+export declare class ChildPoolJob extends EventEmitter {
+    /** Task configuration */
+    config: JobsConfig;
+    /** Binding map: boundId -> pid (binds specific IDs to fixed processes) */
+    boundMap: Map<string | number, number>;
+    /** Child process pool: pid -> JobProcess */
+    children: Record<number, JobProcess>;
+    /** Minimum number of processes */
+    min: number;
+    /** Maximum number of processes */
+    max: number;
+    /** Load balancing strategy name */
+    strategy: string;
+    /** Weight array for each process */
+    weights: number[];
+    /** Load balancer instance */
+    LB: LoadBalancer;
+    constructor(opt?: ChildPoolOptions);
+    /**
+     * Initialize event listeners
+     *
+     * Automatically removes child processes from the pool and load balancer on exit or error.
+     */
+    _initEvents(): void;
+    /**
+     * Remove a child process from the pool
+     *
+     * Removes from both children map and load balancer.
+     */
+    _removeChild(pid: number): void;
+    /**
+     * Create a specified number of child processes
+     *
+     * New processes are added to the pool and load balancer.
+     * The count is limited by max; excess processes will not be created.
+     *
+     * @param number - Number of processes to create
+     * @returns List of all process PIDs after creation
+     * @throws Throws an error if the count is invalid or exceeds the maximum limit
+     */
+    create(number?: number): Promise<string[]>;
+    /**
+     * Registration handling after child process creation
+     *
+     * Adds the process to the children map and load balancer.
+     */
+    _childCreated(childProcess: JobProcess): void;
+    /**
+     * Execute a task file
+     *
+     * Selects a child process via the load balancer and sends a run command to execute the task.
+     *
+     * @param filepath - Task file path
+     * @param params - Task parameters
+     * @returns The child process instance executing the task
+     */
+    run(filepath: string, params?: Record<string, unknown>): Promise<JobProcess>;
+    /**
+     * Asynchronously execute a task file (alias for run)
+     */
+    runPromise(filepath: string, params?: Record<string, unknown>): Promise<JobProcess>;
+    /**
+     * Get a bound child process
+     *
+     * The same boundId is always assigned to the same child process, suitable for session binding scenarios.
+     * If the bound process no longer exists, a new process is reassigned.
+     *
+     * @param boundId - Binding identifier (e.g. user ID, session ID)
+     * @returns Child process instance
+     */
+    getBoundChild(boundId: string | number): Promise<JobProcess>;
+    /** Get a child process by PID */
+    getChildByPid(pid: number): JobProcess | null;
+    /**
+     * Get an available child process
+     *
+     * If the pool is empty, automatically creates one.
+     * Uses the load balancer to select a process.
+     *
+     * @returns Child process instance
+     * @throws Throws an error if retrieval fails
+     */
+    getChild(): Promise<JobProcess>;
+    /** Get PID list of all child processes */
+    getPids(): string[];
+    /**
+     * Kill all child processes
+     *
+     * @param type - Kill mode: 'parallel' kills all at once, 'sequence' kills one per second
+     */
+    killAll(type?: 'sequence' | 'parallel'): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/jobs/child-pool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/jobs/child-pool/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,UAAU,EAA0B,MAAM,wBAAwB,CAAC;AAI5E,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,sBAAsB,CAAC;AAE7E,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,0EAA0E;IAC1E,QAAQ,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6BAA6B;IAC7B,EAAE,EAAE,YAAY,CAAC;gBAEL,GAAG,GAAE,gBAAqB;IAiCtC;;;;OAIG;IACH,WAAW,IAAI,IAAI;IAanB;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAU/B;;;;;;;;;OASG;IACG,MAAM,CAAC,MAAM,SAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA2B3C;;;;OAIG;IACH,aAAa,CAAC,YAAY,EAAE,UAAU,GAAG,IAAI;IAc7C;;;;;;;;OAQG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQtF;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI7F;;;;;;;;OAQG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAelE,iCAAiC;IACjC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAI7C;;;;;;;;OAQG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IA0BrC,0CAA0C;IAC1C,OAAO,IAAI,MAAM,EAAE;IAInB;;;;OAIG;IACH,OAAO,CAAC,IAAI,GAAE,UAAU,GAAG,UAAuB,GAAG,IAAI;CAgB1D"}

package/dist/esm/jobs/child-pool/index.js

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChildPoolJob = void 0;
+/**
+ * @module jobs/child-pool
+ * @description Child process pool manager. Maintains a set of child processes, distributes tasks
+ * through a load balancing algorithm, avoiding the overhead of frequent process creation and destruction.
+ *
+ * Core features:
+ * - Pool size: min=3, max=6, configurable
+ * - Load balancing: supports multiple algorithms (polling/weights/random, etc.), default is polling
+ * - Process binding: binds specific IDs to fixed processes via boundMap (e.g. session binding)
+ * - Auto cleanup: child processes are automatically removed from the pool on exit/error
+ *
+ * Usage:
+ * ```ts
+ * const pool = new ChildPoolJob();
+ * await pool.create(3); // Create 3 child processes
+ * await pool.run('service/job'); // Load balancer selects a process to execute
+ * ```
+ */
+const events_1 = require("events");
+const index_js_1 = require("../load-balancer/index.js");
+const index_js_2 = require("../../loader/index.js");
+const jobProcess_js_1 = require("../child/jobProcess.js");
+const channel_js_1 = require("../../const/channel.js");
+const helper_js_1 = require("../../utils/helper.js");
+const index_js_3 = require("../../config/index.js");
+/**
+ * ChildPoolJob - Child process pool
+ *
+ * Manages a set of child processes, distributes tasks through LoadBalancer.
+ * Inherits EventEmitter, listens for child process exit/error events for auto cleanup.
+ */
+class ChildPoolJob extends events_1.EventEmitter {
+    constructor(opt = {}) {
+        super();
+        const options = {
+            weights: [],
+            ...opt,
+        };
+        this.config = { messageLog: false };
+        this.boundMap = new Map();
+        this.children = {};
+        this.min = 3;
+        this.max = 6;
+        this.strategy = 'polling';
+        // Default weight is 1, can be customized via configuration
+        this.weights = new Array(this.max).fill(0).map((_v, i) => {
+            const w = options.weights[i];
+            return (0, helper_js_1.validValue)(w) ? w : 1;
+        });
+        const lbOpt = {
+            algorithm: index_js_1.LoadBalancer.Algorithm.polling,
+            targets: [],
+        };
+        this.LB = new index_js_1.LoadBalancer(lbOpt);
+        const cfg = (0, index_js_3.getConfig)().jobs;
+        if (cfg) {
+            this.config = cfg;
+        }
+        this._initEvents();
+    }
+    /**
+     * Initialize event listeners
+     *
+     * Automatically removes child processes from the pool and load balancer on exit or error.
+     */
+    _initEvents() {
+        this.on(channel_js_1.Events.childProcessExit, (data) => {
+            if (data.pid !== undefined) {
+                this._removeChild(data.pid);
+            }
+        });
+        this.on(channel_js_1.Events.childProcessError, (data) => {
+            if (data.pid !== undefined) {
+                this._removeChild(data.pid);
+            }
+        });
+    }
+    /**
+     * Remove a child process from the pool
+     *
+     * Removes from both children map and load balancer.
+     */
+    _removeChild(pid) {
+        const length = Object.keys(this.children).length;
+        const lbOpt = {
+            id: pid,
+            weight: this.weights[length - 1] || 1,
+        };
+        this.LB.del(lbOpt);
+        delete this.children[pid];
+    }
+    /**
+     * Create a specified number of child processes
+     *
+     * New processes are added to the pool and load balancer.
+     * The count is limited by max; excess processes will not be created.
+     *
+     * @param number - Number of processes to create
+     * @returns List of all process PIDs after creation
+     * @throws Throws an error if the count is invalid or exceeds the maximum limit
+     */
+    async create(number = 3) {
+        if (number < 0 || number > this.max) {
+            throw new Error('[ee-core] [jobs/child-pool] The number is invalid !');
+        }
+        const currentNumber = Object.keys(this.children).length;
+        if (currentNumber > this.max) {
+            throw new Error(`[ee-core] [jobs/child-pool] The number of current processes number: ${currentNumber} is greater than the maximum: ${this.max} !`);
+        }
+        // Adjust creation count to not exceed maximum limit
+        if (number + currentNumber > this.max) {
+            number = this.max - currentNumber;
+        }
+        const options = {
+            processArgs: {
+                type: 'childPoolJob',
+            },
+        };
+        for (let i = 1; i <= number; i++) {
+            const task = new jobProcess_js_1.JobProcess(this, options, this.config);
+            this._childCreated(task);
+        }
+        return Object.keys(this.children);
+    }
+    /**
+     * Registration handling after child process creation
+     *
+     * Adds the process to the children map and load balancer.
+     */
+    _childCreated(childProcess) {
+        const pid = childProcess.pid;
+        if (pid === undefined)
+            return;
+        this.children[pid] = childProcess;
+        const length = Object.keys(this.children).length;
+        const lbTask = {
+            id: pid,
+            weight: this.weights[length - 1] || 1,
+        };
+        this.LB.add(lbTask);
+    }
+    /**
+     * Execute a task file
+     *
+     * Selects a child process via the load balancer and sends a run command to execute the task.
+     *
+     * @param filepath - Task file path
+     * @param params - Task parameters
+     * @returns The child process instance executing the task
+     */
+    async run(filepath, params = {}) {
+        const jobPath = (0, index_js_2.getFullpath)(filepath);
+        const childProcess = await this.getChild();
+        childProcess.dispatch('run', jobPath, params);
+        return childProcess;
+    }
+    /**
+     * Asynchronously execute a task file (alias for run)
+     */
+    async runPromise(filepath, params = {}) {
+        return this.run(filepath, params);
+    }
+    /**
+     * Get a bound child process
+     *
+     * The same boundId is always assigned to the same child process, suitable for session binding scenarios.
+     * If the bound process no longer exists, a new process is reassigned.
+     *
+     * @param boundId - Binding identifier (e.g. user ID, session ID)
+     * @returns Child process instance
+     */
+    async getBoundChild(boundId) {
+        let proc;
+        const boundPid = this.boundMap.get(boundId);
+        if (boundPid !== undefined) {
+            proc = this.children[boundPid];
+            if (proc)
+                return proc;
+        }
+        // Bound process does not exist, retrieve and bind a new one
+        proc = await this.getChild();
+        this.boundMap.set(boundId, proc.pid ?? 0);
+        return proc;
+    }
+    /** Get a child process by PID */
+    getChildByPid(pid) {
+        return this.children[pid] || null;
+    }
+    /**
+     * Get an available child process
+     *
+     * If the pool is empty, automatically creates one.
+     * Uses the load balancer to select a process.
+     *
+     * @returns Child process instance
+     * @throws Throws an error if retrieval fails
+     */
+    async getChild() {
+        let proc;
+        const currentPids = Object.keys(this.children);
+        if (currentPids.length === 0) {
+            // Pool is empty, auto-create
+            const subIds = await this.create(1);
+            const firstId = subIds[0];
+            if (firstId) {
+                proc = this.children[parseInt(firstId, 10)];
+            }
+        }
+        else {
+            // Select via load balancer
+            const picked = this.LB.pickOne();
+            if (picked && typeof picked.id === 'number') {
+                proc = this.children[picked.id];
+            }
+        }
+        if (!proc) {
+            throw new Error('[ee-core] [jobs/child-pool] Failed to obtain the child process !');
+        }
+        return proc;
+    }
+    /** Get PID list of all child processes */
+    getPids() {
+        return Object.keys(this.children);
+    }
+    /**
+     * Kill all child processes
+     *
+     * @param type - Kill mode: 'parallel' kills all at once, 'sequence' kills one per second
+     */
+    killAll(type = 'parallel') {
+        let i = 1;
+        Object.keys(this.children).forEach(key => {
+            const proc = this.children[parseInt(key, 10)];
+            if (proc) {
+                if (type === 'sequence') {
+                    setTimeout(() => {
+                        proc.kill();
+                    }, i * 1000);
+                    i++;
+                }
+                else {
+                    proc.kill();
+                }
+            }
+        });
+    }
+}
+exports.ChildPoolJob = ChildPoolJob;
+//# sourceMappingURL=index.js.map

package/dist/esm/jobs/child-pool/index.js.map

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

package/dist/esm/jobs/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module jobs
+ * @description Background task module entry. Provides child process task management and load balancing capabilities.
+ *
+ * Core components:
+ * - ChildJob: Single task execution, creates a new child process each time
+ * - ChildPoolJob: Process pool, reuses child processes, distributes tasks via load balancing
+ * - LoadBalancer: Load balancer, supports multiple scheduling algorithms
+ * - AlgorithmType: Algorithm type constants
+ */
+export { ChildJob } from './child/index.js';
+export { ChildPoolJob } from './child-pool/index.js';
+export { LoadBalancer } from './load-balancer/index.js';
+export { AlgorithmType } from './load-balancer/consts.js';
+export type { LoadBalancerTarget, LoadBalancerParams, LoadBalancerOptions } from './load-balancer/types.js';
+export type { JobProcessOptions, JobMessage, ProcessMessage } from './child/jobProcess.js';
+export type { ChildPoolOptions } from './child-pool/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/jobs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/jobs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC5G,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC3F,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/esm/jobs/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlgorithmType = exports.LoadBalancer = exports.ChildPoolJob = exports.ChildJob = void 0;
+/**
+ * @module jobs
+ * @description Background task module entry. Provides child process task management and load balancing capabilities.
+ *
+ * Core components:
+ * - ChildJob: Single task execution, creates a new child process each time
+ * - ChildPoolJob: Process pool, reuses child processes, distributes tasks via load balancing
+ * - LoadBalancer: Load balancer, supports multiple scheduling algorithms
+ * - AlgorithmType: Algorithm type constants
+ */
+var index_js_1 = require("./child/index.js");
+Object.defineProperty(exports, "ChildJob", { enumerable: true, get: function () { return index_js_1.ChildJob; } });
+var index_js_2 = require("./child-pool/index.js");
+Object.defineProperty(exports, "ChildPoolJob", { enumerable: true, get: function () { return index_js_2.ChildPoolJob; } });
+var index_js_3 = require("./load-balancer/index.js");
+Object.defineProperty(exports, "LoadBalancer", { enumerable: true, get: function () { return index_js_3.LoadBalancer; } });
+var consts_js_1 = require("./load-balancer/consts.js");
+Object.defineProperty(exports, "AlgorithmType", { enumerable: true, get: function () { return consts_js_1.AlgorithmType; } });
+//# sourceMappingURL=index.js.map

package/dist/esm/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/jobs/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,6CAA4C;AAAnC,oGAAA,QAAQ,OAAA;AACjB,kDAAqD;AAA5C,wGAAA,YAAY,OAAA;AACrB,qDAAwD;AAA/C,wGAAA,YAAY,OAAA;AACrB,uDAA0D;AAAjD,0GAAA,aAAa,OAAA"}

package/dist/esm/jobs/load-balancer/algorithm/index.d.ts

@@ -0,0 +1,7 @@
+import type { LoadBalancerTarget } from '../types.js';
+/** Algorithm function type */
+export type AlgorithmFn = (tasks: LoadBalancerTarget[], ...args: unknown[]) => LoadBalancerTarget | null;
+/** Algorithm name -> algorithm function mapping */
+declare const algorithms: Record<string, AlgorithmFn>;
+export default algorithms;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/jobs/load-balancer/algorithm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/jobs/load-balancer/algorithm/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,kBAAkB,EAAE,EAC3B,GAAG,IAAI,EAAE,OAAO,EAAE,KACf,kBAAkB,GAAG,IAAI,CAAC;AAE/B,mDAAmD;AACnD,QAAA,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAS3C,CAAC;AAEF,eAAe,UAAU,CAAC"}