fix: add workerNodeKeys validation and remove misleading JSDoc

Author: jerome-benoit

src/pools/abstract-pool.ts

@@ -2212,6 +2212,14 @@ export abstract class AbstractPool<
     if (ready == null || !ready) {
       throw new Error(`Worker ${workerId?.toString()} failed to initialize`)
     }
+    const maxPoolSize =
+      this.maximumNumberOfWorkers ?? this.minimumNumberOfWorkers
+    for (const taskFunctionProperties of taskFunctionsProperties ?? []) {
+      checkValidWorkerNodeKeys(
+        taskFunctionProperties.workerNodeKeys,
+        maxPoolSize,
+      )
+    }
     const workerNodeKey = this.getWorkerNodeKeyByWorkerId(workerId)
     const workerNode = this.workerNodes[workerNodeKey]
     workerNode.info.ready = ready

src/worker/task-functions.ts

@@ -62,8 +62,6 @@ export interface TaskFunctionObject<Data = unknown, Response = unknown> {
    * Restricts task execution to specified worker nodes by their indices.
    * Must contain valid indices within [0, pool max size - 1].
    * If undefined, task can execute on any worker node.
-   * @remarks `null` is not accepted here. Use `null` only via
-   * {@link TaskFunctionProperties.workerNodeKeys} to clear affinity at runtime.
    */
   workerNodeKeys?: number[]
 }