refactor: refine type definition
authorJérôme Benoit <jerome.benoit@piment-noir.org>
Tue, 30 Apr 2024 08:01:09 +0000 (10:01 +0200)
committerJérôme Benoit <jerome.benoit@piment-noir.org>
Tue, 30 Apr 2024 08:01:09 +0000 (10:01 +0200)
Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
SECURITY.md
src/index.ts
src/pools/abstract-pool.ts
src/priority-queue.ts
src/utility-types.ts

index da268313fdafce197f1e7ca4fc8d78d0813fbbac..d42dfb7aa7c9f9d4c99575e0b934fff6e0e6200f 100644 (file)
@@ -6,7 +6,8 @@ Security matrix, currently there are no security vulnerabilities.
 
 | Version | Supported          |
 | ------- | ------------------ |
-| 3.x.x   | :white_check_mark: |
+| 4.x.x   | :white_check_mark: |
+| 3.x.x   | :x:                |
 | 2.x.x   | :x:                |
 | 1.x.x   | :x:                |
 
index a0081a4784a9330683b68c09fd1766ef5034cd51..cba064140d08ba8912d516f3c4a9c70745def408 100644 (file)
@@ -54,6 +54,7 @@ export type {
   MessageValue,
   PromiseResponseWrapper,
   Task,
+  TaskFunctionProperties,
   TaskPerformance,
   WorkerError,
   WorkerStatistics,
@@ -65,6 +66,7 @@ export { ClusterWorker } from './worker/cluster-worker.js'
 export type {
   TaskAsyncFunction,
   TaskFunction,
+  TaskFunctionObject,
   TaskFunctionOperationResult,
   TaskFunctions,
   TaskSyncFunction
index 9a7199ec86da23415f976435900a8138c888afc7..ba632bb14210eaed19701ba79abe867a08396724 100644 (file)
@@ -1294,7 +1294,7 @@ export abstract class AbstractPool<
   }
 
   /**
-   * Chooses a worker node for the next task.
+   * 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
index 3c26ff35208b6f0ef599158ff6d446f47a1e8123..64b5a9248a804130107b810c412bf4c978ae8cd9 100644 (file)
@@ -29,7 +29,7 @@ export class PriorityQueue<T> {
   /**
    * Constructs a priority queue.
    *
-   * @param k - Prioritized bucket size.
+   * @param k - Prioritized bucket size. @defaultValue Infinity
    */
   public constructor (k = Infinity) {
     if (k !== Infinity && !Number.isSafeInteger(k)) {
@@ -121,7 +121,7 @@ export class PriorityQueue<T> {
   /**
    * Returns an iterator for the priority queue.
    *
-   * @returns An iterator for the deque.
+   * @returns An iterator for the priority queue.
    * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols
    */
   [Symbol.iterator] (): Iterator<T> {
index aa4e219853caba926bc74867a2089827f6f69765..82f79230accb88160ae612e9d5cc5ba7da57d157 100644 (file)
@@ -67,22 +67,20 @@ export interface WorkerStatistics {
 
 /**
  * Task function properties.
- *
- * @internal
  */
 export interface TaskFunctionProperties {
   /**
    * Task function name.
    */
-  name: string
+  readonly name: string
   /**
    * Task function priority. Lower values have higher priority.
    */
-  priority?: number
+  readonly priority?: number
   /**
    * Task function worker choice strategy.
    */
-  strategy?: WorkerChoiceStrategy
+  readonly strategy?: WorkerChoiceStrategy
 }
 
 /**