poolifier 3.1.30 → 4.0.0

package/lib/index.d.ts

@@ -29,86 +29,177 @@ declare class CircularArray<T> extends Array<T> {
 }
 
 /**
- * Linked list node interface.
- *
- * @typeParam T - Type of linked list node data.
- * @internal
+ * Enumeration of worker choice strategies.
  */
-interface ILinkedListNode<T> {
-    data: T;
-    next?: ILinkedListNode<T>;
-    prev?: ILinkedListNode<T>;
+declare const WorkerChoiceStrategies: Readonly<{
+    ROUND_ROBIN: 'ROUND_ROBIN';
+    LEAST_USED: 'LEAST_USED';
+    LEAST_BUSY: 'LEAST_BUSY';
+    LEAST_ELU: 'LEAST_ELU';
+    FAIR_SHARE: 'FAIR_SHARE';
+    WEIGHTED_ROUND_ROBIN: 'WEIGHTED_ROUND_ROBIN';
+    INTERLEAVED_WEIGHTED_ROUND_ROBIN: 'INTERLEAVED_WEIGHTED_ROUND_ROBIN';
+}>;
+/**
+ * Worker choice strategy.
+ */
+type WorkerChoiceStrategy = keyof typeof WorkerChoiceStrategies;
+/**
+ * Enumeration of measurements.
+ */
+declare const Measurements: Readonly<{
+    runTime: 'runTime';
+    waitTime: 'waitTime';
+    elu: 'elu';
+}>;
+/**
+ * Measurement.
+ */
+type Measurement = keyof typeof Measurements;
+/**
+ * Measurement options.
+ */
+interface MeasurementOptions {
+    /**
+     * Set measurement median.
+     */
+    readonly median: boolean;
 }
 /**
- * Deque.
- * Implemented with a doubly linked list.
- *
- * @typeParam T - Type of deque data.
- * @internal
+ * Worker choice strategy options.
  */
-declare class Deque<T> {
-    private head?;
-    private tail?;
-    /** The size of the deque. */
-    size: number;
-    /** The maximum size of the deque. */
-    maxSize: number;
-    constructor();
+interface WorkerChoiceStrategyOptions {
     /**
-     * Appends data to the deque.
+     * Measurement to use in worker choice strategy supporting it.
+     */
+    readonly measurement?: Measurement;
+    /**
+     * Runtime options.
      *
-     * @param data - Data to append.
-     * @returns The new size of the deque.
+     * @defaultValue \{ median: false \}
      */
-    push(data: T): number;
+    readonly runTime?: MeasurementOptions;
     /**
-     * Prepends data to the deque.
+     * Wait time options.
      *
-     * @param data - Data to prepend.
-     * @returns The new size of the deque.
+     * @defaultValue \{ median: false \}
      */
-    unshift(data: T): number;
+    readonly waitTime?: MeasurementOptions;
     /**
-     * Pops data from the deque.
+     * Event loop utilization options.
      *
-     * @returns The popped data or `undefined` if the deque is empty.
+     * @defaultValue \{ median: false \}
      */
-    pop(): T | undefined;
+    readonly elu?: MeasurementOptions;
     /**
-     * Shifts data from the deque.
+     * Worker weights to use for weighted round robin worker selection strategies.
+     * A weight is tasks maximum execution time in milliseconds for a worker node.
      *
-     * @returns The shifted data or `undefined` if the deque is empty.
+     * @defaultValue Weights computed automatically given the CPU performance.
      */
-    shift(): T | undefined;
+    weights?: Record<number, number>;
+}
+/**
+ * Measurement statistics requirements.
+ *
+ * @internal
+ */
+interface MeasurementStatisticsRequirements {
     /**
-     * Peeks at the first data.
-     * @returns The first data or `undefined` if the deque is empty.
+     * Requires measurement aggregate.
      */
-    peekFirst(): T | undefined;
+    aggregate: boolean;
     /**
-     * Peeks at the last data.
-     * @returns The last data or `undefined` if the deque is empty.
+     * Requires measurement average.
      */
-    peekLast(): T | undefined;
+    average: boolean;
     /**
-     * Clears the deque.
+     * Requires measurement median.
      */
-    clear(): void;
+    median: boolean;
+}
+/**
+ * Pool worker node worker usage statistics requirements.
+ *
+ * @internal
+ */
+interface TaskStatisticsRequirements {
+    /**
+     * Tasks runtime requirements.
+     */
+    readonly runTime: MeasurementStatisticsRequirements;
+    /**
+     * Tasks wait time requirements.
+     */
+    readonly waitTime: MeasurementStatisticsRequirements;
     /**
-     * Returns an iterator for the deque.
+     * Tasks event loop utilization requirements.
+     */
+    readonly elu: MeasurementStatisticsRequirements;
+}
+/**
+ * Strategy policy.
+ *
+ * @internal
+ */
+interface StrategyPolicy {
+    /**
+     * Expects tasks execution on the newly created dynamic worker.
+     */
+    readonly dynamicWorkerUsage: boolean;
+    /**
+     * Expects the newly created dynamic worker to be flagged as ready.
+     */
+    readonly dynamicWorkerReady: boolean;
+}
+/**
+ * Worker choice strategy interface.
+ *
+ * @internal
+ */
+interface IWorkerChoiceStrategy {
+    /**
+     * Strategy policy.
+     */
+    readonly strategyPolicy: StrategyPolicy;
+    /**
+     * Tasks statistics requirements.
+     */
+    readonly taskStatisticsRequirements: TaskStatisticsRequirements;
+    /**
+     * Resets strategy internals.
      *
-     * @returns An iterator for the deque.
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols
+     * @returns `true` if the reset is successful, `false` otherwise.
      */
-    [Symbol.iterator](): Iterator<T>;
+    readonly reset: () => boolean;
     /**
-     * Returns an backward iterator for the deque.
+     * Updates the worker node key strategy internals.
+     * This is called after a task has been executed on a worker node.
      *
-     * @returns An backward iterator for the deque.
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols
+     * @returns `true` if the update is successful, `false` otherwise.
      */
-    backward(): Iterable<T>;
-    private incrementSize;
+    readonly update: (workerNodeKey: number) => boolean;
+    /**
+     * Chooses a worker node in the pool and returns its key.
+     * If no worker nodes are not eligible, `undefined` is returned.
+     * If `undefined` is returned, the caller retry.
+     *
+     * @returns The worker node key or `undefined`.
+     */
+    readonly choose: () => number | undefined;
+    /**
+     * Removes the worker node key from strategy internals.
+     *
+     * @param workerNodeKey - The worker node key.
+     * @returns `true` if the worker node key is removed, `false` otherwise.
+     */
+    readonly remove: (workerNodeKey: number) => boolean;
+    /**
+     * Sets the worker choice strategy options.
+     *
+     * @param opts - The worker choice strategy options.
+     */
+    readonly setOptions: (opts: WorkerChoiceStrategyOptions | undefined) => void;
 }
 
 /**
@@ -219,6 +310,23 @@ interface WorkerStatistics {
      */
     readonly elu: boolean;
 }
+/**
+ * Task function properties.
+ */
+interface TaskFunctionProperties {
+    /**
+     * Task function name.
+     */
+    readonly name: string;
+    /**
+     * Task function priority. Lower values have higher priority.
+     */
+    readonly priority?: number;
+    /**
+     * Task function worker choice strategy.
+     */
+    readonly strategy?: WorkerChoiceStrategy;
+}
 /**
  * Message object that is passed as a task between main worker and worker.
  *
@@ -234,6 +342,16 @@ interface Task<Data = unknown> {
      * Task input data that will be passed to the worker.
      */
     readonly data?: Data;
+    /**
+     * Task priority. Lower values have higher priority.
+     *
+     * @defaultValue 0
+     */
+    readonly priority?: number;
+    /**
+     * Task worker choice strategy.
+     */
+    readonly strategy?: WorkerChoiceStrategy;
     /**
      * Array of transferable objects.
      */
@@ -245,7 +363,7 @@ interface Task<Data = unknown> {
     /**
      * Task UUID.
      */
-    readonly taskId?: string;
+    readonly taskId?: `${string}-${string}-${string}-${string}-${string}`;
 }
 /**
  * Message object that is passed between main worker and worker.
@@ -283,17 +401,17 @@ interface MessageValue<Data = unknown, ErrorData = unknown> extends Task<Data> {
      */
     readonly taskFunctionOperationStatus?: boolean;
     /**
-     * Task function serialized to string.
+     * Task function properties.
      */
-    readonly taskFunction?: string;
+    readonly taskFunctionProperties?: TaskFunctionProperties;
     /**
-     * Task function name.
+     * Task function serialized to string.
      */
-    readonly taskFunctionName?: string;
+    readonly taskFunction?: string;
     /**
-     * Task function names.
+     * Task functions properties.
      */
-    readonly taskFunctionNames?: string[];
+    readonly taskFunctionsProperties?: TaskFunctionProperties[];
     /**
      * Whether the worker computes the given statistics or not.
      */
@@ -369,195 +487,40 @@ type TaskAsyncFunction<Data = unknown, Response = unknown> = (data?: Data) => Pr
  */
 type TaskFunction<Data = unknown, Response = unknown> = TaskSyncFunction<Data, Response> | TaskAsyncFunction<Data, Response>;
 /**
- * Tasks functions that can be executed.
- * This object can contain synchronous or asynchronous functions.
- * The key is the name of the function.
- * The value is the function itself.
+ * Task function object.
  *
  * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data.
  * @typeParam Response - Type of execution response. This can only be structured-cloneable data.
  */
-type TaskFunctions<Data = unknown, Response = unknown> = Record<string, TaskFunction<Data, Response>>;
-/**
- * Task function operation result.
- */
-interface TaskFunctionOperationResult {
-    status: boolean;
-    error?: Error;
-}
-
-/**
- * Enumeration of worker choice strategies.
- */
-declare const WorkerChoiceStrategies: Readonly<{
-    ROUND_ROBIN: 'ROUND_ROBIN';
-    LEAST_USED: 'LEAST_USED';
-    LEAST_BUSY: 'LEAST_BUSY';
-    LEAST_ELU: 'LEAST_ELU';
-    FAIR_SHARE: 'FAIR_SHARE';
-    WEIGHTED_ROUND_ROBIN: 'WEIGHTED_ROUND_ROBIN';
-    INTERLEAVED_WEIGHTED_ROUND_ROBIN: 'INTERLEAVED_WEIGHTED_ROUND_ROBIN';
-}>;
-/**
- * Worker choice strategy.
- */
-type WorkerChoiceStrategy = keyof typeof WorkerChoiceStrategies;
-/**
- * Enumeration of measurements.
- */
-declare const Measurements: Readonly<{
-    runTime: 'runTime';
-    waitTime: 'waitTime';
-    elu: 'elu';
-}>;
-/**
- * Measurement.
- */
-type Measurement = keyof typeof Measurements;
-/**
- * Measurement options.
- */
-interface MeasurementOptions {
-    /**
-     * Set measurement median.
-     */
-    readonly median: boolean;
-}
-/**
- * Worker choice strategy options.
- */
-interface WorkerChoiceStrategyOptions {
-    /**
-     * Measurement to use in worker choice strategy supporting it.
-     */
-    readonly measurement?: Measurement;
-    /**
-     * Runtime options.
-     *
-     * @defaultValue \{ median: false \}
-     */
-    readonly runTime?: MeasurementOptions;
-    /**
-     * Wait time options.
-     *
-     * @defaultValue \{ median: false \}
-     */
-    readonly waitTime?: MeasurementOptions;
-    /**
-     * Event loop utilization options.
-     *
-     * @defaultValue \{ median: false \}
-     */
-    readonly elu?: MeasurementOptions;
-    /**
-     * Worker weights to use for weighted round robin worker selection strategies.
-     * A weight is tasks maximum execution time in milliseconds for a worker node.
-     *
-     * @defaultValue Weights computed automatically given the CPU performance.
-     */
-    weights?: Record<number, number>;
-}
-/**
- * Measurement statistics requirements.
- *
- * @internal
- */
-interface MeasurementStatisticsRequirements {
+interface TaskFunctionObject<Data = unknown, Response = unknown> {
     /**
-     * Requires measurement aggregate.
+     * Task function.
      */
-    aggregate: boolean;
+    taskFunction: TaskFunction<Data, Response>;
     /**
-     * Requires measurement average.
+     * Task function priority. Lower values have higher priority.
      */
-    average: boolean;
+    priority?: number;
     /**
-     * Requires measurement median.
+     * Task function worker choice strategy.
      */
-    median: boolean;
+    strategy?: WorkerChoiceStrategy;
 }
 /**
- * Pool worker node worker usage statistics requirements.
- *
- * @internal
- */
-interface TaskStatisticsRequirements {
-    /**
-     * Tasks runtime requirements.
-     */
-    readonly runTime: MeasurementStatisticsRequirements;
-    /**
-     * Tasks wait time requirements.
-     */
-    readonly waitTime: MeasurementStatisticsRequirements;
-    /**
-     * Tasks event loop utilization requirements.
-     */
-    readonly elu: MeasurementStatisticsRequirements;
-}
-/**
- * Strategy policy.
+ * Tasks functions that can be executed.
+ * The key is the name of the task function or task function object.
+ * The value is the function or task function object.
  *
- * @internal
+ * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data.
+ * @typeParam Response - Type of execution response. This can only be structured-cloneable data.
  */
-interface StrategyPolicy {
-    /**
-     * Expects tasks execution on the newly created dynamic worker.
-     */
-    readonly dynamicWorkerUsage: boolean;
-    /**
-     * Expects the newly created dynamic worker to be flagged as ready.
-     */
-    readonly dynamicWorkerReady: boolean;
-}
+type TaskFunctions<Data = unknown, Response = unknown> = Record<string, TaskFunction<Data, Response> | TaskFunctionObject<Data, Response>>;
 /**
- * Worker choice strategy interface.
- *
- * @internal
+ * Task function operation result.
  */
-interface IWorkerChoiceStrategy {
-    /**
-     * Strategy policy.
-     */
-    readonly strategyPolicy: StrategyPolicy;
-    /**
-     * Tasks statistics requirements.
-     */
-    readonly taskStatisticsRequirements: TaskStatisticsRequirements;
-    /**
-     * Resets strategy internals.
-     *
-     * @returns `true` if the reset is successful, `false` otherwise.
-     */
-    readonly reset: () => boolean;
-    /**
-     * Updates the worker node key strategy internals.
-     * This is called after a task has been executed on a worker node.
-     *
-     * @returns `true` if the update is successful, `false` otherwise.
-     */
-    readonly update: (workerNodeKey: number) => boolean;
-    /**
-     * Chooses a worker node in the pool and returns its key.
-     * If no worker nodes are not eligible, `undefined` is returned.
-     * If `undefined` is returned, the caller retry.
-     *
-     * @returns The worker node key or `undefined`.
-     */
-    readonly choose: () => number | undefined;
-    /**
-     * Removes the worker node key from strategy internals.
-     *
-     * @param workerNodeKey - The worker node key.
-     * @returns `true` if the worker node key is removed, `false` otherwise.
-     */
-    readonly remove: (workerNodeKey: number) => boolean;
-    /**
-     * Sets the worker choice strategy options.
-     *
-     * @param opts - The worker choice strategy options.
-     */
-    readonly setOptions: (opts: WorkerChoiceStrategyOptions | undefined) => void;
+interface TaskFunctionOperationResult {
+    status: boolean;
+    error?: Error;
 }
 
 /**
@@ -705,9 +668,9 @@ interface WorkerInfo {
      */
     stealing: boolean;
     /**
-     * Task function names.
+     * Task functions properties.
      */
-    taskFunctionNames?: string[];
+    taskFunctionsProperties?: TaskFunctionProperties[];
 }
 /**
  * Worker usage statistics.
@@ -795,6 +758,7 @@ interface WorkerNodeOptions {
     workerOptions?: WorkerOptions$1;
     env?: Record<string, unknown>;
     tasksQueueBackPressureSize: number | undefined;
+    tasksQueueBucketSize: number | undefined;
 }
 /**
  * Worker node interface.
@@ -843,25 +807,13 @@ interface IWorkerNode<Worker extends IWorker, Data = unknown> extends EventEmitt
      * @returns The tasks queue size.
      */
     readonly enqueueTask: (task: Task<Data>) => number;
-    /**
-     * Prepends a task to the tasks queue.
-     *
-     * @param task - The task to prepend.
-     * @returns The tasks queue size.
-     */
-    readonly unshiftTask: (task: Task<Data>) => number;
     /**
      * Dequeue task.
      *
+     * @param bucket - The prioritized bucket to dequeue from. @defaultValue 0
      * @returns The dequeued task.
      */
-    readonly dequeueTask: () => Task<Data> | undefined;
-    /**
-     * Pops a task from the tasks queue.
-     *
-     * @returns The popped task.
-     */
-    readonly popTask: () => Task<Data> | undefined;
+    readonly dequeueTask: (bucket?: number) => Task<Data> | undefined;
     /**
      * Clears tasks queue.
      */
@@ -872,10 +824,6 @@ interface IWorkerNode<Worker extends IWorker, Data = unknown> extends EventEmitt
      * @returns `true` if the worker node has back pressure, `false` otherwise.
      */
     readonly hasBackPressure: () => boolean;
-    /**
-     * Resets usage statistics.
-     */
-    readonly resetUsage: () => void;
     /**
      * Terminates the worker node.
      */
@@ -956,7 +904,7 @@ interface PoolInfo {
     readonly worker: WorkerType;
     readonly started: boolean;
     readonly ready: boolean;
-    readonly strategy: WorkerChoiceStrategy;
+    readonly defaultStrategy: WorkerChoiceStrategy;
     readonly strategyRetries: number;
     readonly minSize: number;
     readonly maxSize: number;
@@ -1062,7 +1010,7 @@ interface PoolOptions<Worker extends IWorker> {
      */
     startWorkers?: boolean;
     /**
-     * The worker choice strategy to use in this pool.
+     * The default worker choice strategy to use in this pool.
      *
      * @defaultValue WorkerChoiceStrategies.ROUND_ROBIN
      */
@@ -1187,11 +1135,11 @@ interface IPool<Worker extends IWorker, Data = unknown, Response = unknown> {
      */
     readonly removeTaskFunction: (name: string) => Promise<boolean>;
     /**
-     * Lists the names of task function available in this pool.
+     * Lists the properties of task functions available in this pool.
      *
-     * @returns The names of task function available in this pool.
+     * @returns The properties of task functions available in this pool.
      */
-    readonly listTaskFunctionNames: () => string[];
+    readonly listTaskFunctionsProperties: () => TaskFunctionProperties[];
     /**
      * Sets the default task function in this pool.
      *
@@ -1200,9 +1148,9 @@ interface IPool<Worker extends IWorker, Data = unknown, Response = unknown> {
      */
     readonly setDefaultTaskFunction: (name: string) => Promise<boolean>;
     /**
-     * Sets the worker choice strategy in this pool.
+     * Sets the default worker choice strategy in this pool.
      *
-     * @param workerChoiceStrategy - The worker choice strategy.
+     * @param workerChoiceStrategy - The default worker choice strategy.
      * @param workerChoiceStrategyOptions - The worker choice strategy options.
      */
     readonly setWorkerChoiceStrategy: (workerChoiceStrategy: WorkerChoiceStrategy, workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions) => void;
@@ -1210,8 +1158,9 @@ interface IPool<Worker extends IWorker, Data = unknown, Response = unknown> {
      * Sets the worker choice strategy options in this pool.
      *
      * @param workerChoiceStrategyOptions - The worker choice strategy options.
+     * @returns `true` if the worker choice strategy options were set, `false` otherwise.
      */
-    readonly setWorkerChoiceStrategyOptions: (workerChoiceStrategyOptions: WorkerChoiceStrategyOptions) => void;
+    readonly setWorkerChoiceStrategyOptions: (workerChoiceStrategyOptions: WorkerChoiceStrategyOptions) => boolean;
     /**
      * Enables/disables the worker node tasks queue in this pool.
      *
@@ -1228,65 +1177,79 @@ interface IPool<Worker extends IWorker, Data = unknown, Response = unknown> {
 }
 
 /**
- * The worker choice strategy context.
+ * The worker choice strategies context.
  *
  * @typeParam Worker - Type of worker.
  * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data.
  * @typeParam Response - Type of execution response. This can only be structured-cloneable data.
  */
-declare class WorkerChoiceStrategyContext<Worker extends IWorker, Data = unknown, Response = unknown> {
-    private workerChoiceStrategy;
+declare class WorkerChoiceStrategiesContext<Worker extends IWorker, Data = unknown, Response = unknown> {
+    private readonly pool;
     /**
-     * The number of worker choice strategy execution retries.
+     * The number of worker choice strategies execution retries.
      */
     retriesCount: number;
     /**
-     * The worker choice strategy instances registered in the context.
+     * The default worker choice strategy in the context.
+     */
+    private defaultWorkerChoiceStrategy;
+    /**
+     * The worker choice strategies registered in the context.
      */
     private readonly workerChoiceStrategies;
     /**
-     * The maximum number of worker choice strategy execution retries.
+     * The active worker choice strategies in the context policy.
+     */
+    private workerChoiceStrategiesPolicy;
+    /**
+     * The active worker choice strategies in the context task statistics requirements.
+     */
+    private workerChoiceStrategiesTaskStatisticsRequirements;
+    /**
+     * The maximum number of worker choice strategies execution retries.
      */
     private readonly retries;
     /**
-     * Worker choice strategy context constructor.
+     * Worker choice strategies context constructor.
      *
      * @param pool - The pool instance.
-     * @param workerChoiceStrategy - The worker choice strategy.
+     * @param workerChoiceStrategies - The worker choice strategies. @defaultValue [WorkerChoiceStrategies.ROUND_ROBIN]
      * @param opts - The worker choice strategy options.
      */
-    constructor(pool: IPool<Worker, Data, Response>, workerChoiceStrategy?: WorkerChoiceStrategy, opts?: WorkerChoiceStrategyOptions);
+    constructor(pool: IPool<Worker, Data, Response>, workerChoiceStrategies?: WorkerChoiceStrategy[], opts?: WorkerChoiceStrategyOptions);
     /**
-     * Gets the strategy policy in the context.
+     * Gets the active worker choice strategies in the context policy.
      *
-     * @returns The strategy policy.
+     * @returns The strategies policy.
      */
-    getStrategyPolicy(): StrategyPolicy;
+    getPolicy(): StrategyPolicy;
     /**
-     * Gets the worker choice strategy in the context task statistics requirements.
+     * Gets the active worker choice strategies in the context task statistics requirements.
      *
-     * @returns The task statistics requirements.
+     * @returns The strategies task statistics requirements.
      */
     getTaskStatisticsRequirements(): TaskStatisticsRequirements;
     /**
-     * Sets the worker choice strategy to use in the context.
+     * Sets the default worker choice strategy to use in the context.
      *
-     * @param workerChoiceStrategy - The worker choice strategy to set.
+     * @param workerChoiceStrategy - The default worker choice strategy to set.
+     * @param opts - The worker choice strategy options.
      */
-    setWorkerChoiceStrategy(workerChoiceStrategy: WorkerChoiceStrategy): void;
+    setDefaultWorkerChoiceStrategy(workerChoiceStrategy: WorkerChoiceStrategy, opts?: WorkerChoiceStrategyOptions): void;
     /**
-     * Updates the worker node key in the worker choice strategy in the context internals.
+     * Updates the worker node key in the active worker choice strategies in the context internals.
      *
      * @returns `true` if the update is successful, `false` otherwise.
      */
     update(workerNodeKey: number): boolean;
     /**
-     * Executes the worker choice strategy in the context algorithm.
+     * Executes the given worker choice strategy in the context algorithm.
      *
+     * @param workerChoiceStrategy - The worker choice strategy algorithm to execute. @defaultValue this.defaultWorkerChoiceStrategy
      * @returns The key of the worker node.
      * @throws {@link https://nodejs.org/api/errors.html#class-error} If after computed retries the worker node key is null or undefined.
      */
-    execute(): number;
+    execute(workerChoiceStrategy?: WorkerChoiceStrategy): number;
     /**
      * Executes the given worker choice strategy.
      *
@@ -1296,18 +1259,40 @@ declare class WorkerChoiceStrategyContext<Worker extends IWorker, Data = unknown
      */
     private executeStrategy;
     /**
-     * Removes the worker node key from the worker choice strategy in the context.
+     * Removes the worker node key from the active worker choice strategies in the context.
      *
      * @param workerNodeKey - The worker node key.
      * @returns `true` if the removal is successful, `false` otherwise.
      */
     remove(workerNodeKey: number): boolean;
     /**
-     * Sets the worker choice strategies in the context options.
+     * Sets the active worker choice strategies in the context options.
      *
      * @param opts - The worker choice strategy options.
      */
     setOptions(opts: WorkerChoiceStrategyOptions | undefined): void;
+    /**
+     * Synchronizes the active worker choice strategies in the context with the given worker choice strategies.
+     *
+     * @param workerChoiceStrategies - The worker choice strategies to synchronize.
+     * @param opts - The worker choice strategy options.
+     */
+    syncWorkerChoiceStrategies(workerChoiceStrategies: Set<WorkerChoiceStrategy>, opts?: WorkerChoiceStrategyOptions): void;
+    /**
+     * Adds a worker choice strategy to the context.
+     *
+     * @param workerChoiceStrategy - The worker choice strategy to add.
+     * @param opts - The worker choice strategy options.
+     * @returns The worker choice strategies.
+     */
+    private addWorkerChoiceStrategy;
+    /**
+     * Removes a worker choice strategy from the context.
+     *
+     * @param workerChoiceStrategy - The worker choice strategy to remove.
+     * @returns `true` if the worker choice strategy is removed, `false` otherwise.
+     */
+    private removeWorkerChoiceStrategy;
 }
 
 /**
@@ -1329,19 +1314,19 @@ declare abstract class AbstractPool<Worker extends IWorker, Data = unknown, Resp
     /**
      * The task execution response promise map:
      * - `key`: The message id of each submitted task.
-     * - `value`: An object that contains the worker, the execution response promise resolve and reject callbacks.
+     * - `value`: An object that contains task's worker node key, execution response promise resolve and reject callbacks, async resource.
      *
      * When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.
      */
     protected promiseResponseMap: Map<string, PromiseResponseWrapper<Response>>;
     /**
-     * Worker choice strategy context referencing a worker choice algorithm implementation.
+     * Worker choice strategies context referencing worker choice algorithms implementation.
      */
-    protected workerChoiceStrategyContext?: WorkerChoiceStrategyContext<Worker, Data, Response>;
+    protected workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>;
     /**
      * The task functions added at runtime map:
      * - `key`: The task function name.
-     * - `value`: The task function itself.
+     * - `value`: The task function object.
      */
     private readonly taskFunctions;
     /**
@@ -1367,7 +1352,7 @@ declare abstract class AbstractPool<Worker extends IWorker, Data = unknown, Resp
     /**
      * The start timestamp of the pool.
      */
-    private readonly startTimestamp;
+    private startTimestamp?;
     /**
      * Constructs a new poolifier pool.
      *
@@ -1425,7 +1410,7 @@ declare abstract class AbstractPool<Worker extends IWorker, Data = unknown, Resp
     /** @inheritDoc */
     setWorkerChoiceStrategy(workerChoiceStrategy: WorkerChoiceStrategy, workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions): void;
     /** @inheritDoc */
-    setWorkerChoiceStrategyOptions(workerChoiceStrategyOptions: WorkerChoiceStrategyOptions | undefined): void;
+    setWorkerChoiceStrategyOptions(workerChoiceStrategyOptions: WorkerChoiceStrategyOptions | undefined): boolean;
     /** @inheritDoc */
     enableTasksQueue(enable: boolean, tasksQueueOptions?: TasksQueueOptions): void;
     /** @inheritDoc */
@@ -1460,11 +1445,32 @@ declare abstract class AbstractPool<Worker extends IWorker, Data = unknown, Resp
     /** @inheritDoc */
     hasTaskFunction(name: string): boolean;
     /** @inheritDoc */
-    addTaskFunction(name: string, fn: TaskFunction<Data, Response>): Promise<boolean>;
+    addTaskFunction(name: string, fn: TaskFunction<Data, Response> | TaskFunctionObject<Data, Response>): Promise<boolean>;
     /** @inheritDoc */
     removeTaskFunction(name: string): Promise<boolean>;
     /** @inheritDoc */
-    listTaskFunctionNames(): string[];
+    listTaskFunctionsProperties(): TaskFunctionProperties[];
+    /**
+     * Gets task function strategy, if any.
+     *
+     * @param name - The task function name.
+     * @returns The task function worker choice strategy if the task function worker choice strategy is defined, `undefined` otherwise.
+     */
+    private readonly getTaskFunctionWorkerWorkerChoiceStrategy;
+    /**
+     * Gets worker node task function priority, if any.
+     *
+     * @param workerNodeKey - The worker node key.
+     * @param name - The task function name.
+     * @returns The task function worker choice priority if the task function worker choice priority is defined, `undefined` otherwise.
+     */
+    private readonly getWorkerNodeTaskFunctionPriority;
+    /**
+     * Gets the worker choice strategies registered in this pool.
+     *
+     * @returns The worker choice strategies.
+     */
+    private readonly getWorkerWorkerChoiceStrategies;
     /** @inheritDoc */
     setDefaultTaskFunction(name: string): Promise<boolean>;
     private deleteTaskFunctionWorkerUsages;
@@ -1523,10 +1529,9 @@ declare abstract class AbstractPool<Worker extends IWorker, Data = unknown, Resp
      */
     private shallUpdateTaskFunctionWorkerUsage;
     /**
-     * Chooses a worker node for the next task.
-     *
-     * The default worker choice strategy uses a round robin algorithm to distribute the tasks.
+     * Chooses a worker node for the next task given the worker choice strategy.
      *
+     * @param workerChoiceStrategy - The worker choice strategy.
      * @returns The chosen worker node key
      */
     private chooseWorkerNode;
@@ -1818,6 +1823,80 @@ declare class DynamicThreadPool<Data = unknown, Response = unknown> extends Fixe
     protected get busy(): boolean;
 }
 
+/**
+ * Priority queue node.
+ *
+ * @typeParam T - Type of priority queue node data.
+ * @internal
+ */
+interface PriorityQueueNode<T> {
+    data: T;
+    priority: number;
+}
+/**
+ * Priority queue.
+ *
+ * @typeParam T - Type of priority queue data.
+ * @internal
+ */
+declare class PriorityQueue<T> {
+    private nodeArray;
+    /** Prioritized bucket size. */
+    private readonly k;
+    /** The size of the priority queue. */
+    size: number;
+    /** The maximum size of the priority queue. */
+    maxSize: number;
+    /**
+     * Constructs a priority queue.
+     *
+     * @param k - Prioritized bucket size. @defaultValue Infinity
+     */
+    constructor(k?: number);
+    /**
+     * Enqueue data into the priority queue.
+     *
+     * @param data - Data to enqueue.
+     * @param priority - Priority of the data. Lower values have higher priority.
+     * @returns The new size of the priority queue.
+     */
+    enqueue(data: T, priority?: number): number;
+    /**
+     * Dequeue data from the priority queue.
+     *
+     * @param bucket - The prioritized bucket to dequeue from. @defaultValue 0
+     * @returns The dequeued data or `undefined` if the priority queue is empty.
+     */
+    dequeue(bucket?: number): T | undefined;
+    /**
+     * Peeks at the first data.
+     * @returns The first data or `undefined` if the priority queue is empty.
+     */
+    peekFirst(): T | undefined;
+    /**
+     * Peeks at the last data.
+     * @returns The last data or `undefined` if the priority queue is empty.
+     */
+    peekLast(): T | undefined;
+    /**
+     * Clears the priority queue.
+     */
+    clear(): void;
+    /**
+     * Returns an iterator for the priority queue.
+     *
+     * @returns An iterator for the priority queue.
+     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols
+     */
+    [Symbol.iterator](): Iterator<T>;
+    /**
+     * Increments the size of the priority queue.
+     *
+     * @returns The new size of the priority queue.
+     */
+    private incrementSize;
+}
+
 /**
  * Returns safe host OS optimized estimate of the default amount of parallelism a pool should use.
  * Always returns a value greater than zero.
@@ -1842,9 +1921,9 @@ declare abstract class AbstractWorker<MainWorker extends Worker | MessagePort, D
      */
     protected abstract id: number;
     /**
-     * Task function(s) processed by the worker when the pool's `execution` function is invoked.
+     * Task function object(s) processed by the worker when the pool's `execution` function is invoked.
      */
-    protected taskFunctions: Map<string, TaskFunction<Data, Response>>;
+    protected taskFunctions: Map<string, TaskFunctionObject<Data, Response>>;
     /**
      * Timestamp of the last task processed by this worker.
      */
@@ -1888,7 +1967,7 @@ declare abstract class AbstractWorker<MainWorker extends Worker | MessagePort, D
      * @param fn - The task function to add.
      * @returns Whether the task function was added or not.
      */
-    addTaskFunction(name: string, fn: TaskFunction<Data, Response>): TaskFunctionOperationResult;
+    addTaskFunction(name: string, fn: TaskFunction<Data, Response> | TaskFunctionObject<Data, Response>): TaskFunctionOperationResult;
     /**
      * Removes a task function from the worker.
      *
@@ -1897,11 +1976,11 @@ declare abstract class AbstractWorker<MainWorker extends Worker | MessagePort, D
      */
     removeTaskFunction(name: string): TaskFunctionOperationResult;
     /**
-     * Lists the names of the worker's task functions.
+     * Lists the properties of the worker's task functions.
      *
-     * @returns The names of the worker's task functions.
+     * @returns The properties of the worker's task functions.
      */
-    listTaskFunctionNames(): string[];
+    listTaskFunctionsProperties(): TaskFunctionProperties[];
     /**
      * Sets the default task function to use in the worker.
      *
@@ -1961,9 +2040,9 @@ declare abstract class AbstractWorker<MainWorker extends Worker | MessagePort, D
      */
     protected abstract sendToMainWorker(message: MessageValue<Response, Data>): void;
     /**
-     * Sends task function names to the main worker.
+     * Sends task functions properties to the main worker.
      */
-    protected sendTaskFunctionNamesToMainWorker(): void;
+    protected sendTaskFunctionsPropertiesToMainWorker(): void;
     /**
      * Handles an error and convert it to a string so it can be sent back to the main worker.
      *
@@ -2067,4 +2146,4 @@ declare class ThreadWorker<Data = unknown, Response = unknown> extends AbstractW
     protected handleError(error: Error | string): string;
 }
 
-export { AbstractPool, AbstractWorker, CircularArray, type ClusterPoolOptions, ClusterWorker, Deque, DynamicClusterPool, DynamicThreadPool, type ErrorHandler, type EventHandler, type EventLoopUtilizationMeasurementStatistics, type ExitHandler, FixedClusterPool, FixedThreadPool, type ILinkedListNode, type IPool, type IWorker, type IWorkerChoiceStrategy, type IWorkerNode, type KillBehavior, KillBehaviors, type KillHandler, type Measurement, type MeasurementOptions, type MeasurementStatistics, type MeasurementStatisticsRequirements, Measurements, type MessageHandler, type MessageValue, type OnlineHandler, type PoolEvent, PoolEvents, type PoolInfo, type PoolOptions, type PoolType, PoolTypes, type PromiseResponseWrapper, type StrategyData, type StrategyPolicy, type Task, type TaskAsyncFunction, type TaskFunction, type TaskFunctionOperationResult, type TaskFunctions, type TaskPerformance, type TaskStatistics, type TaskStatisticsRequirements, type TaskSyncFunction, type TasksQueueOptions, type ThreadPoolOptions, ThreadWorker, WorkerChoiceStrategies, type WorkerChoiceStrategy, WorkerChoiceStrategyContext, type WorkerChoiceStrategyOptions, type WorkerError, type WorkerInfo, type WorkerNodeEventDetail, type WorkerNodeOptions, type WorkerOptions, type WorkerStatistics, type WorkerType, WorkerTypes, type WorkerUsage, type Writable, availableParallelism };
+export { AbstractPool, AbstractWorker, CircularArray, type ClusterPoolOptions, ClusterWorker, DynamicClusterPool, DynamicThreadPool, type ErrorHandler, type EventHandler, type EventLoopUtilizationMeasurementStatistics, type ExitHandler, FixedClusterPool, FixedThreadPool, type IPool, type IWorker, type IWorkerChoiceStrategy, type IWorkerNode, type KillBehavior, KillBehaviors, type KillHandler, type Measurement, type MeasurementOptions, type MeasurementStatistics, type MeasurementStatisticsRequirements, Measurements, type MessageHandler, type MessageValue, type OnlineHandler, type PoolEvent, PoolEvents, type PoolInfo, type PoolOptions, type PoolType, PoolTypes, PriorityQueue, type PriorityQueueNode, type PromiseResponseWrapper, type StrategyData, type StrategyPolicy, type Task, type TaskAsyncFunction, type TaskFunction, type TaskFunctionObject, type TaskFunctionOperationResult, type TaskFunctionProperties, type TaskFunctions, type TaskPerformance, type TaskStatistics, type TaskStatisticsRequirements, type TaskSyncFunction, type TasksQueueOptions, type ThreadPoolOptions, ThreadWorker, WorkerChoiceStrategies, WorkerChoiceStrategiesContext, type WorkerChoiceStrategy, type WorkerChoiceStrategyOptions, type WorkerError, type WorkerInfo, type WorkerNodeEventDetail, type WorkerNodeOptions, type WorkerOptions, type WorkerStatistics, type WorkerType, WorkerTypes, type WorkerUsage, type Writable, availableParallelism };