+import type { IPoolInternal } from '../pool-internal'
import type { IPoolWorker } from '../pool-worker'
/**
*/
ROUND_ROBIN: 'ROUND_ROBIN',
/**
- * Less recently used worker selection strategy.
+ * Less used worker selection strategy.
*/
- LESS_RECENTLY_USED: 'LESS_RECENTLY_USED',
+ LESS_USED: 'LESS_USED',
+ /**
+ * Less busy worker selection strategy.
+ */
+ LESS_BUSY: 'LESS_BUSY',
/**
* Fair share worker selection strategy.
*/
export type WorkerChoiceStrategy = keyof typeof WorkerChoiceStrategies
/**
- * Pool tasks usage statistics requirements.
+ * Pool worker tasks usage statistics requirements.
*/
-export type RequiredStatistics = {
+export interface RequiredStatistics {
runTime: boolean
+ avgRunTime: boolean
}
/**
* Worker choice strategy interface.
- *
- * @template Worker Type of worker which manages the strategy.
*/
-export interface IWorkerChoiceStrategy<Worker extends IPoolWorker> {
+export interface IWorkerChoiceStrategy<
+ Worker extends IPoolWorker,
+ Data = unknown,
+ Response = unknown
+> {
+ /**
+ * The pool instance.
+ * @readonly
+ */
+ readonly pool: IPoolInternal<Worker, Data, Response>
/**
* Is the pool attached to the strategy dynamic?.
+ * @readonly
*/
readonly isDynamicPool: boolean
/**
* Required pool tasks usage statistics.
+ * @readonly
*/
readonly requiredStatistics: RequiredStatistics
/**
- * Resets strategy internal statistics.
+ * Resets strategy internals (counters, statistics, etc.).
+ */
+ reset: () => boolean
+ /**
+ * Chooses a worker in the pool and returns its key.
*/
- resetStatistics(): boolean
+ choose: () => number
/**
- * Chooses a worker in the pool.
+ * Removes a worker reference from strategy internals.
+ *
+ * @param workerKey - The worker key.
*/
- choose(): Worker
+ remove: (workerKey: number) => boolean
}