poolifier 4.0.13 → 4.0.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/index.cjs CHANGED
@@ -1,2 +1,2 @@
1
- "use strict";var e=require("node:cluster"),t=require("node:fs"),r=require("node:process"),s=require("node:worker_threads"),i=require("node:crypto"),o=require("node:os"),n=require("node:async_hooks"),a=require("node:events"),u=require("node:perf_hooks");function h(e){var t=Object.create(null);return e&&Object.keys(e).forEach((function(r){if("default"!==r){var s=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,s.get?s:{enumerable:!0,get:function(){return e[r]}})}})),t.default=e,Object.freeze(t)}var k=h(o);const c=Object.freeze({fixed:"fixed",dynamic:"dynamic"}),d=Object.freeze({ready:"ready",busy:"busy",full:"full",empty:"empty",destroy:"destroy",error:"error",taskError:"taskError",backPressure:"backPressure"}),l="default",m=Object.freeze((()=>{})),g=e=>Array.isArray(e)&&0===e.length?0:Array.isArray(e)&&1===e.length?e[0]:e.reduce(((e,t)=>e+t),0)/e.length,w=e=>{if(Array.isArray(e)&&0===e.length)return 0;if(Array.isArray(e)&&1===e.length)return e[0];const t=e.slice().sort(((e,t)=>e-t));return(t[t.length-1>>1]+t[t.length>>1])/2},p=(e,t=2)=>{const r=Math.pow(10,t);return Math.round(e*r*(1+Number.EPSILON))/r},y=e=>"object"==typeof e&&null!==e&&e.constructor===Object&&"[object Object]"===Object.prototype.toString.call(e),f=(e,t)=>t===e,T=e=>"function"==typeof e&&"AsyncFunction"===e.constructor.name,N=()=>i.getRandomValues(new Uint32Array(1))[0]/4294967296,W=(...e)=>e.reduce(((e,t)=>e<t?e:t),Number.POSITIVE_INFINITY),S=(...e)=>e.reduce(((e,t)=>e>t?e:t),Number.NEGATIVE_INFINITY),x=(e,t)=>({name:e,...null!=t?.priority&&{priority:t.priority},...null!=t?.strategy&&{strategy:t.strategy}}),E=Object.freeze({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"}),v=Object.freeze({runTime:"runTime",waitTime:"waitTime",elu:"elu"}),I=386,b=Object.freeze({thread:"thread",cluster:"cluster"}),C={aggregate:!1,average:!1,median:!1},F=e=>({size:Math.pow(e,2),concurrency:1,taskStealing:!0,tasksStealingOnBackPressure:!1,tasksFinishedTimeout:2e3}),P=e=>{if(null==e)throw new TypeError("The worker file path must be specified");if("string"!=typeof e)throw new TypeError("The worker file path must be a string");if(!t.existsSync(e))throw new Error(`Cannot find the worker file '${e}'`)},O=(e,t)=>{if(null==t)throw new TypeError("Cannot instantiate a dynamic pool without specifying the maximum pool size");if(!Number.isSafeInteger(t))throw new TypeError("Cannot instantiate a dynamic pool with a non safe integer maximum pool size");if(e>t)throw new RangeError("Cannot instantiate a dynamic pool with a maximum pool size inferior to the minimum pool size");if(0===t)throw new RangeError("Cannot instantiate a dynamic pool with a maximum pool size equal to zero");if(e===t)throw new RangeError("Cannot instantiate a dynamic pool with a minimum pool size equal to the maximum pool size. Use a fixed pool instead")},R=e=>{if(null!=e&&!Number.isSafeInteger(e))throw new TypeError(`Invalid property 'priority': '${e}'`);if(null!=e&&Number.isSafeInteger(e)&&(e<-20||e>19))throw new RangeError("Property 'priority' must be between -20 and 19")},z=e=>{if(null!=e&&!Object.values(E).includes(e))throw new Error(`Invalid worker choice strategy '${e}'`)},q=e=>{if(null!=e&&!y(e))throw new TypeError("Invalid tasks queue options: must be a plain object");if(null!=e?.concurrency&&!Number.isSafeInteger(e.concurrency))throw new TypeError("Invalid worker node tasks concurrency: must be an integer");if(null!=e?.concurrency&&e.concurrency<=0)throw new RangeError(`Invalid worker node tasks concurrency: ${e.concurrency} is a negative integer or zero`);if(null!=e?.size&&!Number.isSafeInteger(e.size))throw new TypeError("Invalid worker node tasks queue size: must be an integer");if(null!=e?.size&&e.size<=0)throw new RangeError(`Invalid worker node tasks queue size: ${e.size} is a negative integer or zero`)},M=(e,t,r)=>{null!=t&&null!=r&&t.aggregate&&(e.aggregate=(e.aggregate??0)+r,e.minimum=W(r,e.minimum??Number.POSITIVE_INFINITY),e.maximum=S(r,e.maximum??Number.NEGATIVE_INFINITY),(t.average||t.median)&&(e.history.put(r),t.average?e.average=g(e.history.toArray()):null!=e.average&&delete e.average,t.median?e.median=w(e.history.toArray()):null!=e.median&&delete e.median))};"test"===r.env.NODE_ENV&&(exports.updateMeasurementStatistics=M);const A=(e,t,r)=>{const s=performance.now(),i=s-(r.timestamp??s);M(t.waitTime,e?.getTaskStatisticsRequirements().waitTime,i)},Q=(e,t)=>{const r=e.tasks;null!=r.executing&&r.executing>0&&--r.executing,null==t.workerError?++r.executed:++r.failed},K=(e,t,r)=>{null==r.workerError&&M(t.runTime,e?.getTaskStatisticsRequirements().runTime,r.taskPerformance?.runTime??0)},B=(e,t,r)=>{if(null!=r.workerError)return;const s=e?.getTaskStatisticsRequirements().elu;M(t.elu.active,s,r.taskPerformance?.elu?.active??0),M(t.elu.idle,s,r.taskPerformance?.elu?.idle??0),!0===s?.aggregate&&null!=r.taskPerformance?.elu&&(null!=t.elu.utilization?t.elu.utilization=(t.elu.utilization+r.taskPerformance.elu.utilization)/2:t.elu.utilization=r.taskPerformance.elu.utilization)},U=t=>t instanceof s.Worker?b.thread:t instanceof e.Worker?b.cluster:void 0,D=t=>t instanceof s.Worker?t.threadId:t instanceof e.Worker?t.id:void 0;class _{start;nodeArray;capacity;size;enablePriority;constructor(e=2048,t=!1){this.checkSize(e),this.capacity=e,this.enablePriority=t,this.nodeArray=new Array(this.capacity),this.clear()}empty(){return 0===this.size}full(){return this.size===this.capacity}enqueue(e,t){if(this.full())throw new Error("Priority queue is full");t=t??0;let r=!1;if(this.enablePriority){let s=this.start;for(let i=0;i<this.size;i++){if(this.nodeArray[s].priority>t){this.nodeArray.splice(s,0,{data:e,priority:t}),this.nodeArray.length!==this.capacity&&(this.nodeArray.length=this.capacity),r=!0;break}++s,s===this.capacity&&(s=0)}}if(!r){let r=this.start+this.size;r>=this.capacity&&(r-=this.capacity),this.nodeArray[r]={data:e,priority:t}}return++this.size}get(e){if(!(this.empty()||e>=this.size))return(e+=this.start)>=this.capacity&&(e-=this.capacity),this.nodeArray[e].data}dequeue(){if(this.empty())return;const e=this.start;return--this.size,++this.start,this.start===this.capacity&&(this.start=0),this.nodeArray[e].data}clear(){this.start=0,this.size=0}[Symbol.iterator](){let e=this.start,t=0;return{next:()=>{if(t>=this.size)return{value:void 0,done:!0};const r=this.nodeArray[e].data;return++e,++t,e===this.capacity&&(e=0),{value:r,done:!1}}}}checkSize(e){if(!Number.isSafeInteger(e))throw new TypeError(`Invalid fixed priority queue size: '${e}' is not an integer`);if(e<0)throw new RangeError(`Invalid fixed priority queue size: ${e} < 0`)}}class L{head;tail;bucketSize;maxSize;constructor(e=2048,t=!1){if(!Number.isSafeInteger(e))throw new TypeError(`Invalid bucket size: '${e}' is not an integer`);if(e<0)throw new RangeError(`Invalid bucket size: ${e} < 0`);this.bucketSize=e,this.head=this.tail=new _(this.bucketSize,t),this.maxSize=0}get size(){let e=this.tail,t=0;for(;null!=e;)t+=e.size,e=e.next;return t}get enablePriority(){return this.head.enablePriority}set enablePriority(e){if(this.head.enablePriority===e)return;let t=this.tail;for(;null!=t;)t.enablePriority=e,t=t.next}get buckets(){return Math.trunc(this.size/this.bucketSize)}enqueue(e,t){this.head.full()&&(this.head=this.head.next=new _(this.bucketSize,this.enablePriority)),this.head.enqueue(e,t);const r=this.size;return r>this.maxSize&&(this.maxSize=r),r}dequeue(e){let t=this.tail,r=!1;if(null!=e&&e>0){let s=1;for(;null!=t&&s!==e;)++s,t=t.next,r=!0}const s=t.dequeue();if(t.empty()&&null!=t.next){if(r){let e=this.tail;for(;null!=e;){if(e.next===t){e.next=t.next;break}e=e.next}}else this.tail=t.next;delete t.next}return s}clear(){this.head=this.tail=new _(this.bucketSize,this.enablePriority),this.maxSize=0}[Symbol.iterator](){let e=0,t=this.tail;return{next:()=>{const r=t.get(e);return null==r?{value:void 0,done:!0}:(++e,e===t.capacity&&null!=t.next&&(t=t.next,e=0),{value:r,done:!1})}}}}const V=Object.freeze({SOFT:"SOFT",HARD:"HARD"});class H{pool;opts;nextWorkerNodeKey=0;previousWorkerNodeKey=0;strategyPolicy={dynamicWorkerUsage:!1,dynamicWorkerReady:!0};taskStatisticsRequirements={runTime:C,waitTime:C,elu:C};constructor(e,t){this.pool=e,this.opts=t,this.choose=this.choose.bind(this),this.setOptions(this.opts)}setTaskStatisticsRequirements(e){se(this.taskStatisticsRequirements.runTime,e.runTime.median),se(this.taskStatisticsRequirements.waitTime,e.waitTime.median),se(this.taskStatisticsRequirements.elu,e.elu.median)}resetWorkerNodeKeyProperties(){this.nextWorkerNodeKey=0,this.previousWorkerNodeKey=0}setOptions(e){this.opts=re(this.pool,e),this.setTaskStatisticsRequirements(this.opts)}isWorkerNodeReady(e){return this.pool.workerNodes[e]?.info?.ready??!1}checkNextWorkerNodeKey(){null!=this.nextWorkerNodeKey&&(this.nextWorkerNodeKey<0||!this.isWorkerNodeReady(this.nextWorkerNodeKey))&&delete this.nextWorkerNodeKey}getWorkerNodeTaskRunTime(e){return this.taskStatisticsRequirements.runTime.median?this.pool.workerNodes[e].usage.runTime.median??0:this.pool.workerNodes[e].usage.runTime.average??0}getWorkerNodeTaskWaitTime(e){return this.taskStatisticsRequirements.waitTime.median?this.pool.workerNodes[e].usage.waitTime.median??0:this.pool.workerNodes[e].usage.waitTime.average??0}getWorkerNodeTaskElu(e){return this.taskStatisticsRequirements.elu.median?this.pool.workerNodes[e].usage.elu.active.median??0:this.pool.workerNodes[e].usage.elu.active.average??0}setPreviousWorkerNodeKey(e){this.previousWorkerNodeKey=null!=e&&e>=0?e:this.previousWorkerNodeKey}}class j extends H{taskStatisticsRequirements={runTime:{aggregate:!0,average:!0,median:!1},waitTime:{aggregate:!0,average:!0,median:!1},elu:{aggregate:!0,average:!0,median:!1}};constructor(e,t){super(e,t),this.setTaskStatisticsRequirements(this.opts)}reset(){for(const e of this.pool.workerNodes)delete e.strategyData?.virtualTaskEndTimestamp;return!0}update(e){return this.pool.workerNodes[e].strategyData={virtualTaskEndTimestamp:this.computeWorkerNodeVirtualTaskEndTimestamp(e)},!0}choose(){return this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.nextWorkerNodeKey=this.fairShareNextWorkerNodeKey(),this.nextWorkerNodeKey}remove(){return!0}fairShareNextWorkerNodeKey(){return this.pool.workerNodes.reduce(((e,t,r,s)=>(null==t.strategyData?.virtualTaskEndTimestamp&&(t.strategyData={virtualTaskEndTimestamp:this.computeWorkerNodeVirtualTaskEndTimestamp(r)}),this.isWorkerNodeReady(r)&&t.strategyData.virtualTaskEndTimestamp<s[e].strategyData.virtualTaskEndTimestamp?r:e)),0)}computeWorkerNodeVirtualTaskEndTimestamp(e){return this.getWorkerNodeVirtualTaskEndTimestamp(e,this.getWorkerNodeVirtualTaskStartTimestamp(e))}getWorkerNodeVirtualTaskEndTimestamp(e,t){return t+(this.getWorkerNodeTaskWaitTime(e)+(this.opts.measurement===v.elu?this.getWorkerNodeTaskElu(e):this.getWorkerNodeTaskRunTime(e)))}getWorkerNodeVirtualTaskStartTimestamp(e){const t=this.pool.workerNodes[e]?.strategyData?.virtualTaskEndTimestamp,r=performance.now();return r<(t??Number.NEGATIVE_INFINITY)?t:r}}class $ extends H{taskStatisticsRequirements={runTime:{aggregate:!0,average:!0,median:!1},waitTime:{aggregate:!0,average:!0,median:!1},elu:C};roundId=0;roundWeights;workerNodeId=0;workerNodeVirtualTaskExecutionTime=0;constructor(e,t){super(e,t),this.setTaskStatisticsRequirements(this.opts),this.roundWeights=this.getRoundWeights()}reset(){return this.resetWorkerNodeKeyProperties(),this.roundId=0,this.workerNodeId=0,this.workerNodeVirtualTaskExecutionTime=0,!0}update(){return!0}choose(){for(let e=this.roundId;e<this.roundWeights.length;e++){this.roundId=e;for(let t=this.workerNodeId;t<this.pool.workerNodes.length;t++){this.workerNodeId=t,this.workerNodeId!==this.nextWorkerNodeKey&&0!==this.workerNodeVirtualTaskExecutionTime&&(this.workerNodeVirtualTaskExecutionTime=0);const r=this.opts.weights[t];if(this.isWorkerNodeReady(t)&&r>=this.roundWeights[e]&&this.workerNodeVirtualTaskExecutionTime<r)return this.workerNodeVirtualTaskExecutionTime+=this.getWorkerNodeTaskWaitTime(t)+this.getWorkerNodeTaskRunTime(t),this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.nextWorkerNodeKey=t,this.nextWorkerNodeKey}}this.interleavedWeightedRoundRobinNextWorkerNodeId()}interleavedWeightedRoundRobinNextWorkerNodeId(){0===this.pool.workerNodes.length?this.workerNodeId=0:this.roundId===this.roundWeights.length-1&&this.workerNodeId===this.pool.workerNodes.length-1?(this.roundId=0,this.workerNodeId=0):this.workerNodeId===this.pool.workerNodes.length-1?(this.roundId=this.roundId+1,this.workerNodeId=0):this.workerNodeId=this.workerNodeId+1}remove(e){return 0===this.pool.workerNodes.length?(this.resetWorkerNodeKeyProperties(),this.workerNodeId=0,this.workerNodeVirtualTaskExecutionTime=0,!0):(this.workerNodeId===e&&this.workerNodeId>this.pool.workerNodes.length-1&&(this.workerNodeId=this.pool.workerNodes.length-1),this.previousWorkerNodeKey===e&&this.previousWorkerNodeKey>this.pool.workerNodes.length-1&&(this.previousWorkerNodeKey=this.pool.workerNodes.length-1),!0)}setOptions(e){super.setOptions(e),this.roundWeights=this.getRoundWeights()}getRoundWeights(){return[...new Set(Object.values(this.opts.weights).slice().sort(((e,t)=>e-t)))]}}class Y extends H{taskStatisticsRequirements={runTime:{aggregate:!0,average:!1,median:!1},waitTime:{aggregate:!0,average:!1,median:!1},elu:C};constructor(e,t){super(e,t),this.setTaskStatisticsRequirements(this.opts)}reset(){return!0}update(){return!0}choose(){return this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.nextWorkerNodeKey=this.leastBusyNextWorkerNodeKey(),this.nextWorkerNodeKey}remove(){return!0}leastBusyNextWorkerNodeKey(){return this.pool.workerNodes.reduce(((e,t,r,s)=>this.isWorkerNodeReady(r)&&(t.usage.waitTime.aggregate??0)+(t.usage.runTime.aggregate??0)<(s[e].usage.waitTime.aggregate??0)+(s[e].usage.runTime.aggregate??0)?r:e),0)}}class G extends H{taskStatisticsRequirements={runTime:C,waitTime:C,elu:{aggregate:!0,average:!1,median:!1}};constructor(e,t){super(e,t),this.setTaskStatisticsRequirements(this.opts)}reset(){return!0}update(){return!0}choose(){return this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.nextWorkerNodeKey=this.leastEluNextWorkerNodeKey(),this.nextWorkerNodeKey}remove(){return!0}leastEluNextWorkerNodeKey(){return this.pool.workerNodes.reduce(((e,t,r,s)=>this.isWorkerNodeReady(r)&&(t.usage.elu.active.aggregate??0)<(s[e].usage.elu.active.aggregate??0)?r:e),0)}}class J extends H{constructor(e,t){super(e,t)}reset(){return!0}update(){return!0}choose(){return this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.nextWorkerNodeKey=this.leastUsedNextWorkerNodeKey(),this.nextWorkerNodeKey}remove(){return!0}leastUsedNextWorkerNodeKey(){return this.pool.workerNodes.reduce(((e,t,r,s)=>this.isWorkerNodeReady(r)&&t.usage.tasks.executing+t.usage.tasks.queued<s[e].usage.tasks.executing+s[e].usage.tasks.queued?r:e),0)}}class X extends H{constructor(e,t){super(e,t)}reset(){return this.resetWorkerNodeKeyProperties(),!0}update(){return!0}choose(){const e=this.nextWorkerNodeKey;return this.setPreviousWorkerNodeKey(e),this.roundRobinNextWorkerNodeKey(),this.checkNextWorkerNodeKey(),e}remove(e){return 0===this.pool.workerNodes.length?(this.reset(),!0):(this.nextWorkerNodeKey===e&&this.nextWorkerNodeKey>this.pool.workerNodes.length-1&&(this.nextWorkerNodeKey=this.pool.workerNodes.length-1),this.previousWorkerNodeKey===e&&this.previousWorkerNodeKey>this.pool.workerNodes.length-1&&(this.previousWorkerNodeKey=this.pool.workerNodes.length-1),!0)}roundRobinNextWorkerNodeKey(){return this.nextWorkerNodeKey=this.nextWorkerNodeKey===this.pool.workerNodes.length-1?0:(this.nextWorkerNodeKey??this.previousWorkerNodeKey)+1,this.nextWorkerNodeKey}}class Z extends H{taskStatisticsRequirements={runTime:{aggregate:!0,average:!0,median:!1},waitTime:{aggregate:!0,average:!0,median:!1},elu:C};workerNodeVirtualTaskExecutionTime=0;constructor(e,t){super(e,t),this.setTaskStatisticsRequirements(this.opts)}reset(){return this.resetWorkerNodeKeyProperties(),this.workerNodeVirtualTaskExecutionTime=0,!0}update(){return!0}choose(){return this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.weightedRoundRobinNextWorkerNodeKey(),this.checkNextWorkerNodeKey(),this.nextWorkerNodeKey}remove(e){return 0===this.pool.workerNodes.length?(this.reset(),!0):(this.nextWorkerNodeKey===e&&(this.workerNodeVirtualTaskExecutionTime=0,this.nextWorkerNodeKey>this.pool.workerNodes.length-1&&(this.nextWorkerNodeKey=this.pool.workerNodes.length-1)),this.previousWorkerNodeKey===e&&this.previousWorkerNodeKey>this.pool.workerNodes.length-1&&(this.previousWorkerNodeKey=this.pool.workerNodes.length-1),!0)}weightedRoundRobinNextWorkerNodeKey(){const e=this.opts.weights[this.nextWorkerNodeKey??this.previousWorkerNodeKey];return this.workerNodeVirtualTaskExecutionTime<e?this.workerNodeVirtualTaskExecutionTime+=this.getWorkerNodeTaskWaitTime(this.nextWorkerNodeKey??this.previousWorkerNodeKey)+this.getWorkerNodeTaskRunTime(this.nextWorkerNodeKey??this.previousWorkerNodeKey):(this.nextWorkerNodeKey=this.nextWorkerNodeKey===this.pool.workerNodes.length-1?0:(this.nextWorkerNodeKey??this.previousWorkerNodeKey)+1,this.workerNodeVirtualTaskExecutionTime=0),this.nextWorkerNodeKey}}const ee=()=>{const e=o.cpus();let t;e.every((e=>null==e.speed||0===e.speed))&&(t=(()=>{const e=performance.now(),t=performance.now()-e;return Math.trunc(15e7/t/1e3)})());let r=0;for(const s of e){null!=s.speed&&0!==s.speed||(s.speed=e.find((e=>null!=e.speed&&0!==e.speed))?.speed??t??2e3);const i=s.speed.toString().length-1;r+=1/(s.speed/Math.pow(10,i))*Math.pow(10,i)}return Math.round(r/e.length)},te=(e,t)=>{t=t??ee();const r={};for(let s=0;s<e;s++)r[s]=t;return r},re=(e,t)=>((t=structuredClone(t??{})).weights=t.weights??te(e.info.maxSize),{runTime:{median:!1},waitTime:{median:!1},elu:{median:!1},...t}),se=(e,t)=>{e.average&&t&&(e.average=!1,e.median=t),e.median&&!t&&(e.average=!0,e.median=t)},ie=e=>{const t=Array.from(e,(([e,t])=>t.strategyPolicy));return{dynamicWorkerUsage:t.some((e=>e.dynamicWorkerUsage)),dynamicWorkerReady:t.some((e=>e.dynamicWorkerReady))}},oe=e=>{const t=Array.from(e,(([e,t])=>t.taskStatisticsRequirements));return{runTime:{aggregate:t.some((e=>e.runTime.aggregate)),average:t.some((e=>e.runTime.average)),median:t.some((e=>e.runTime.median))},waitTime:{aggregate:t.some((e=>e.waitTime.aggregate)),average:t.some((e=>e.waitTime.average)),median:t.some((e=>e.waitTime.median))},elu:{aggregate:t.some((e=>e.elu.aggregate)),average:t.some((e=>e.elu.average)),median:t.some((e=>e.elu.median))}}};class ne{pool;retriesCount;defaultWorkerChoiceStrategy;workerChoiceStrategies;workerChoiceStrategiesPolicy;workerChoiceStrategiesTaskStatisticsRequirements;retries;constructor(e,t=[E.ROUND_ROBIN],r){this.pool=e,this.execute=this.execute.bind(this),this.defaultWorkerChoiceStrategy=t[0],this.workerChoiceStrategies=new Map;for(const e of t)this.addWorkerChoiceStrategy(e,this.pool,r);this.workerChoiceStrategiesPolicy=ie(this.workerChoiceStrategies),this.workerChoiceStrategiesTaskStatisticsRequirements=oe(this.workerChoiceStrategies),this.retriesCount=0,this.retries=((e,t)=>e.info.maxSize+Object.keys(t?.weights??te(e.info.maxSize)).length)(this.pool,r)}getPolicy(){return this.workerChoiceStrategiesPolicy}getTaskStatisticsRequirements(){return this.workerChoiceStrategiesTaskStatisticsRequirements}setDefaultWorkerChoiceStrategy(e,t){e!==this.defaultWorkerChoiceStrategy&&(this.defaultWorkerChoiceStrategy=e,this.addWorkerChoiceStrategy(e,this.pool,t))}update(e){return Array.from(this.workerChoiceStrategies,(([t,r])=>r.update(e))).every((e=>e))}execute(e=this.defaultWorkerChoiceStrategy){return this.executeStrategy(this.workerChoiceStrategies.get(e))}executeStrategy(e){let t,r=0,s=0;do{t=e.choose(),null==t&&r>0&&(++s,++this.retriesCount),++r}while(null==t&&s<this.retries);if(null==t)throw new Error(`Worker node key chosen is null or undefined after ${s} retries`);return t}remove(e){return Array.from(this.workerChoiceStrategies,(([t,r])=>r.remove(e))).every((e=>e))}setOptions(e){for(const t of this.workerChoiceStrategies.values())t.setOptions(e)}syncWorkerChoiceStrategies(e,t){for(const t of this.workerChoiceStrategies.keys())e.has(t)||this.removeWorkerChoiceStrategy(t);for(const r of e)this.workerChoiceStrategies.has(r)||this.addWorkerChoiceStrategy(r,this.pool,t);this.workerChoiceStrategiesPolicy=ie(this.workerChoiceStrategies),this.workerChoiceStrategiesTaskStatisticsRequirements=oe(this.workerChoiceStrategies)}addWorkerChoiceStrategy(e,t,r){return this.workerChoiceStrategies.has(e)?this.workerChoiceStrategies:this.workerChoiceStrategies.set(e,((e,t,r,s)=>{switch(e){case E.ROUND_ROBIN:return new(X.bind(r))(t,s);case E.LEAST_USED:return new(J.bind(r))(t,s);case E.LEAST_BUSY:return new(Y.bind(r))(t,s);case E.LEAST_ELU:return new(G.bind(r))(t,s);case E.FAIR_SHARE:return new(j.bind(r))(t,s);case E.WEIGHTED_ROUND_ROBIN:return new(Z.bind(r))(t,s);case E.INTERLEAVED_WEIGHTED_ROUND_ROBIN:return new($.bind(r))(t,s);default:throw new Error(`Worker choice strategy '${e}' is not valid`)}})(e,t,this,r))}removeWorkerChoiceStrategy(e){return this.workerChoiceStrategies.delete(e)}}class ae{readIdx;writeIdx;items;maxArrayIdx;size;constructor(e=2048){this.checkSize(e),this.readIdx=0,this.writeIdx=0,this.maxArrayIdx=e-1,this.size=0,this.items=new Float32Array(e).fill(-1)}empty(){return 0===this.size}full(){return this.size===this.items.length}put(e){this.items[this.writeIdx]=e,this.writeIdx=this.writeIdx===this.maxArrayIdx?0:this.writeIdx+1,this.size<this.items.length&&++this.size}get(){const e=this.items[this.readIdx];if(-1!==e)return this.items[this.readIdx]=-1,this.readIdx=this.readIdx===this.maxArrayIdx?0:this.readIdx+1,--this.size,e}toArray(){return Array.from(this.items.filter((e=>-1!==e)))}checkSize(e){if(!Number.isSafeInteger(e))throw new TypeError(`Invalid circular buffer size: '${e}' is not an integer`);if(e<0)throw new RangeError(`Invalid circular buffer size: ${e} < 0`)}}class ue extends a.EventEmitter{worker;info;usage;strategyData;messageChannel;tasksQueueBackPressureSize;tasksQueue;setBackPressureFlag;taskFunctionsUsage;constructor(t,r,i){super(),((e,t,r)=>{if(null==e)throw new TypeError("Cannot construct a worker node without a worker type");if(!Object.values(b).includes(e))throw new TypeError(`Cannot construct a worker node with an invalid worker type '${e}'`);if(P(t),null==r)throw new TypeError("Cannot construct a worker node without worker node options");if(!y(r))throw new TypeError("Cannot construct a worker node with invalid worker node options: must be a plain object");if(null==r.tasksQueueBackPressureSize)throw new TypeError("Cannot construct a worker node without a tasks queue back pressure size option");if(!Number.isSafeInteger(r.tasksQueueBackPressureSize))throw new TypeError("Cannot construct a worker node with a tasks queue back pressure size option that is not an integer");if(r.tasksQueueBackPressureSize<=0)throw new RangeError("Cannot construct a worker node with a tasks queue back pressure size option that is not a positive integer");if(null==r.tasksQueueBucketSize)throw new TypeError("Cannot construct a worker node without a tasks queue bucket size option");if(!Number.isSafeInteger(r.tasksQueueBucketSize))throw new TypeError("Cannot construct a worker node with a tasks queue bucket size option that is not an integer");if(r.tasksQueueBucketSize<=0)throw new RangeError("Cannot construct a worker node with a tasks queue bucket size option that is not a positive integer");if(null==r.tasksQueuePriority)throw new TypeError("Cannot construct a worker node without a tasks queue priority option");if("boolean"!=typeof r.tasksQueuePriority)throw new TypeError("Cannot construct a worker node with a tasks queue priority option that is not a boolean")})(t,r,i),this.worker=((t,r,i)=>{switch(t){case b.thread:return new s.Worker(r,{env:s.SHARE_ENV,...i.workerOptions});case b.cluster:return e.fork(i.env);default:throw new Error(`Unknown worker type '${t}'`)}})(t,r,{env:i.env,workerOptions:i.workerOptions}),this.info=this.initWorkerInfo(this.worker),this.usage=this.initWorkerUsage(),this.info.type===b.thread&&(this.messageChannel=new s.MessageChannel),this.tasksQueueBackPressureSize=i.tasksQueueBackPressureSize,this.tasksQueue=new L(i.tasksQueueBucketSize,i.tasksQueuePriority),this.setBackPressureFlag=!1,this.taskFunctionsUsage=new Map}setTasksQueuePriority(e){this.tasksQueue.enablePriority=e}tasksQueueSize(){return this.tasksQueue.size}enqueueTask(e){const t=this.tasksQueue.enqueue(e,e.priority);return this.setBackPressureFlag||!this.hasBackPressure()||this.info.backPressure||(this.setBackPressureFlag=!0,this.info.backPressure=!0,this.emit("backPressure",{workerId:this.info.id}),this.setBackPressureFlag=!1),t}dequeueTask(e){const t=this.tasksQueue.dequeue(e);return this.setBackPressureFlag||this.hasBackPressure()||!this.info.backPressure||(this.setBackPressureFlag=!0,this.info.backPressure=!1,this.setBackPressureFlag=!1),t}dequeueLastPrioritizedTask(){return this.dequeueTask(this.tasksQueue.buckets+1)}clearTasksQueue(){this.tasksQueue.clear()}hasBackPressure(){return this.tasksQueue.size>=this.tasksQueueBackPressureSize}async terminate(){const e=new Promise((e=>{this.registerOnceWorkerEventHandler("exit",(()=>{e()}))}));switch(this.closeMessageChannel(),this.removeAllListeners(),this.info.type){case b.thread:this.worker.unref?.(),await(this.worker.terminate?.());break;case b.cluster:this.registerOnceWorkerEventHandler("disconnect",(()=>{this.worker.kill?.()})),this.worker.disconnect?.()}await e}registerWorkerEventHandler(e,t){this.worker.on(e,t)}registerOnceWorkerEventHandler(e,t){this.worker.once(e,t)}getTaskFunctionWorkerUsage(e){if(!Array.isArray(this.info.taskFunctionsProperties))throw new Error(`Cannot get task function worker usage for task function name '${e}' when task function properties list is not yet defined`);if(Array.isArray(this.info.taskFunctionsProperties)&&this.info.taskFunctionsProperties.length<3)throw new Error(`Cannot get task function worker usage for task function name '${e}' when task function properties list has less than 3 elements`);return e===l&&(e=this.info.taskFunctionsProperties[1].name),this.taskFunctionsUsage.has(e)||this.taskFunctionsUsage.set(e,this.initTaskFunctionWorkerUsage(e)),this.taskFunctionsUsage.get(e)}deleteTaskFunctionWorkerUsage(e){return this.taskFunctionsUsage.delete(e)}closeMessageChannel(){null!=this.messageChannel&&(this.messageChannel.port1.unref(),this.messageChannel.port2.unref(),this.messageChannel.port1.close(),this.messageChannel.port2.close(),delete this.messageChannel)}initWorkerInfo(e){return{id:D(e),type:U(e),dynamic:!1,ready:!1,stealing:!1,backPressure:!1}}initWorkerUsage(){const e=()=>this.tasksQueue.size,t=()=>this.tasksQueue.maxSize;return{tasks:{executed:0,executing:0,get queued(){return e()},get maxQueued(){return t()},sequentiallyStolen:0,stolen:0,failed:0},runTime:{history:new ae(I)},waitTime:{history:new ae(I)},elu:{idle:{history:new ae(I)},active:{history:new ae(I)}}}}initTaskFunctionWorkerUsage(e){const t=()=>{let t=0;for(const r of this.tasksQueue)(r.name===l&&e===this.info.taskFunctionsProperties[1].name||r.name!==l&&e===r.name)&&++t;return t};return{tasks:{executed:0,executing:0,get queued(){return t()},sequentiallyStolen:0,stolen:0,failed:0},runTime:{history:new ae(I)},waitTime:{history:new ae(I)},elu:{idle:{history:new ae(I)},active:{history:new ae(I)}}}}}class he{minimumNumberOfWorkers;filePath;opts;maximumNumberOfWorkers;workerNodes=[];emitter;promiseResponseMap=new Map;workerChoiceStrategiesContext;taskFunctions;started;starting;destroying;startingMinimumNumberOfWorkers;readyEventEmitted;startTimestamp;constructor(e,t,r,s){if(this.minimumNumberOfWorkers=e,this.filePath=t,this.opts=r,this.maximumNumberOfWorkers=s,!this.isMain())throw new Error("Cannot start a pool from a worker with the same type as the pool");this.checkPoolType(),P(this.filePath),this.checkMinimumNumberOfWorkers(this.minimumNumberOfWorkers),this.checkPoolOptions(this.opts),this.chooseWorkerNode=this.chooseWorkerNode.bind(this),this.executeTask=this.executeTask.bind(this),this.enqueueTask=this.enqueueTask.bind(this),!0===this.opts.enableEvents&&this.initEventEmitter(),this.workerChoiceStrategiesContext=new ne(this,[this.opts.workerChoiceStrategy],this.opts.workerChoiceStrategyOptions),this.setupHook(),this.taskFunctions=new Map,this.started=!1,this.starting=!1,this.destroying=!1,this.readyEventEmitted=!1,this.startingMinimumNumberOfWorkers=!1,!0===this.opts.startWorkers&&this.start()}checkPoolType(){if(this.type===c.fixed&&null!=this.maximumNumberOfWorkers)throw new Error("Cannot instantiate a fixed pool with a maximum number of workers specified at initialization")}checkMinimumNumberOfWorkers(e){if(null==e)throw new Error("Cannot instantiate a pool without specifying the number of workers");if(!Number.isSafeInteger(e))throw new TypeError("Cannot instantiate a pool with a non safe integer number of workers");if(e<0)throw new RangeError("Cannot instantiate a pool with a negative number of workers");if(this.type===c.fixed&&0===e)throw new RangeError("Cannot instantiate a fixed pool with zero worker")}checkPoolOptions(e){if(!y(e))throw new TypeError("Invalid pool options: must be a plain object");this.opts.startWorkers=e.startWorkers??!0,z(e.workerChoiceStrategy),this.opts.workerChoiceStrategy=e.workerChoiceStrategy??E.ROUND_ROBIN,this.checkValidWorkerChoiceStrategyOptions(e.workerChoiceStrategyOptions),null!=e.workerChoiceStrategyOptions&&(this.opts.workerChoiceStrategyOptions=e.workerChoiceStrategyOptions),this.opts.restartWorkerOnError=e.restartWorkerOnError??!0,this.opts.enableEvents=e.enableEvents??!0,this.opts.enableTasksQueue=e.enableTasksQueue??!1,this.opts.enableTasksQueue&&(q(e.tasksQueueOptions),this.opts.tasksQueueOptions=this.buildTasksQueueOptions(e.tasksQueueOptions))}checkValidWorkerChoiceStrategyOptions(e){if(null!=e&&!y(e))throw new TypeError("Invalid worker choice strategy options: must be a plain object");if(null!=e?.weights&&Object.keys(e.weights).length!==(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers))throw new Error("Invalid worker choice strategy options: must have a weight for each worker node");if(null!=e?.measurement&&!Object.values(v).includes(e.measurement))throw new Error(`Invalid worker choice strategy options: invalid measurement '${e.measurement}'`)}initEventEmitter(){this.emitter=new a.EventEmitterAsyncResource({name:`poolifier:${this.type}-${this.worker}-pool`})}get info(){return{version:"4.0.13",type:this.type,worker:this.worker,started:this.started,ready:this.ready,defaultStrategy:this.opts.workerChoiceStrategy,strategyRetries:this.workerChoiceStrategiesContext?.retriesCount??0,minSize:this.minimumNumberOfWorkers,maxSize:this.maximumNumberOfWorkers??this.minimumNumberOfWorkers,...!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().runTime.aggregate&&this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().waitTime.aggregate&&{utilization:p(this.utilization)},workerNodes:this.workerNodes.length,idleWorkerNodes:this.workerNodes.reduce(((e,t)=>0===t.usage.tasks.executing?e+1:e),0),...!0===this.opts.enableTasksQueue&&{stealingWorkerNodes:this.workerNodes.reduce(((e,t)=>t.info.stealing?e+1:e),0)},busyWorkerNodes:this.workerNodes.reduce(((e,t,r)=>this.isWorkerNodeBusy(r)?e+1:e),0),executedTasks:this.workerNodes.reduce(((e,t)=>e+t.usage.tasks.executed),0),executingTasks:this.workerNodes.reduce(((e,t)=>e+t.usage.tasks.executing),0),...!0===this.opts.enableTasksQueue&&{queuedTasks:this.workerNodes.reduce(((e,t)=>e+t.usage.tasks.queued),0)},...!0===this.opts.enableTasksQueue&&{maxQueuedTasks:this.workerNodes.reduce(((e,t)=>e+(t.usage.tasks.maxQueued??0)),0)},...!0===this.opts.enableTasksQueue&&{backPressure:this.hasBackPressure()},...!0===this.opts.enableTasksQueue&&{stolenTasks:this.workerNodes.reduce(((e,t)=>e+t.usage.tasks.stolen),0)},failedTasks:this.workerNodes.reduce(((e,t)=>e+t.usage.tasks.failed),0),...!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().runTime.aggregate&&{runTime:{minimum:p(W(...this.workerNodes.map((e=>e.usage.runTime.minimum??Number.POSITIVE_INFINITY)))),maximum:p(S(...this.workerNodes.map((e=>e.usage.runTime.maximum??Number.NEGATIVE_INFINITY)))),...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().runTime.average&&{average:p(g(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.runTime.history.toArray())),[])))},...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().runTime.median&&{median:p(w(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.runTime.history.toArray())),[])))}}},...!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().waitTime.aggregate&&{waitTime:{minimum:p(W(...this.workerNodes.map((e=>e.usage.waitTime.minimum??Number.POSITIVE_INFINITY)))),maximum:p(S(...this.workerNodes.map((e=>e.usage.waitTime.maximum??Number.NEGATIVE_INFINITY)))),...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().waitTime.average&&{average:p(g(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.waitTime.history.toArray())),[])))},...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().waitTime.median&&{median:p(w(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.waitTime.history.toArray())),[])))}}},...!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().elu.aggregate&&{elu:{idle:{minimum:p(W(...this.workerNodes.map((e=>e.usage.elu.idle.minimum??Number.POSITIVE_INFINITY)))),maximum:p(S(...this.workerNodes.map((e=>e.usage.elu.idle.maximum??Number.NEGATIVE_INFINITY)))),...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().elu.average&&{average:p(g(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.elu.idle.history.toArray())),[])))},...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().elu.median&&{median:p(w(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.elu.idle.history.toArray())),[])))}},active:{minimum:p(W(...this.workerNodes.map((e=>e.usage.elu.active.minimum??Number.POSITIVE_INFINITY)))),maximum:p(S(...this.workerNodes.map((e=>e.usage.elu.active.maximum??Number.NEGATIVE_INFINITY)))),...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().elu.average&&{average:p(g(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.elu.active.history.toArray())),[])))},...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().elu.median&&{median:p(w(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.elu.active.history.toArray())),[])))}},utilization:{average:p(g(this.workerNodes.map((e=>e.usage.elu.utilization??0)))),median:p(w(this.workerNodes.map((e=>e.usage.elu.utilization??0))))}}}}}get ready(){return!this.empty&&this.workerNodes.reduce(((e,t)=>!t.info.dynamic&&t.info.ready?e+1:e),0)>=this.minimumNumberOfWorkers}get empty(){return 0===this.minimumNumberOfWorkers&&0===this.workerNodes.length}get utilization(){if(null==this.startTimestamp)return 0;const e=(u.performance.now()-this.startTimestamp)*(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers);return(this.workerNodes.reduce(((e,t)=>e+(t.usage.runTime.aggregate??0)),0)+this.workerNodes.reduce(((e,t)=>e+(t.usage.waitTime.aggregate??0)),0))/e}checkMessageWorkerId(e){if(null==e.workerId)throw new Error("Worker message received without worker id");if(-1===this.getWorkerNodeKeyByWorkerId(e.workerId))throw new Error(`Worker message received from unknown worker '${e.workerId}'`)}getWorkerNodeKeyByWorkerId(e){return this.workerNodes.findIndex((t=>t.info.id===e))}setWorkerChoiceStrategy(e,t){let r=!1;if(z(e),null!=t&&(r=!this.setWorkerChoiceStrategyOptions(t)),e!==this.opts.workerChoiceStrategy&&(this.opts.workerChoiceStrategy=e,this.workerChoiceStrategiesContext?.setDefaultWorkerChoiceStrategy(this.opts.workerChoiceStrategy,this.opts.workerChoiceStrategyOptions),r=!0),r){this.workerChoiceStrategiesContext?.syncWorkerChoiceStrategies(this.getWorkerChoiceStrategies(),this.opts.workerChoiceStrategyOptions);for(const e of this.workerNodes.keys())this.sendStatisticsMessageToWorker(e)}}setWorkerChoiceStrategyOptions(e){if(this.checkValidWorkerChoiceStrategyOptions(e),null!=e){this.opts.workerChoiceStrategyOptions=e,this.workerChoiceStrategiesContext?.setOptions(this.opts.workerChoiceStrategyOptions),this.workerChoiceStrategiesContext?.syncWorkerChoiceStrategies(this.getWorkerChoiceStrategies(),this.opts.workerChoiceStrategyOptions);for(const e of this.workerNodes.keys())this.sendStatisticsMessageToWorker(e);return!0}return!1}enableTasksQueue(e,t){!0!==this.opts.enableTasksQueue||e||(this.unsetTaskStealing(),this.unsetTasksStealingOnBackPressure(),this.flushTasksQueues()),this.opts.enableTasksQueue=e,this.setTasksQueueOptions(t)}setTasksQueueOptions(e){!0===this.opts.enableTasksQueue?(q(e),this.opts.tasksQueueOptions=this.buildTasksQueueOptions(e),this.setTasksQueueSize(this.opts.tasksQueueOptions.size),!0===this.opts.tasksQueueOptions.taskStealing?(this.unsetTaskStealing(),this.setTaskStealing()):this.unsetTaskStealing(),!0===this.opts.tasksQueueOptions.tasksStealingOnBackPressure?(this.unsetTasksStealingOnBackPressure(),this.setTasksStealingOnBackPressure()):this.unsetTasksStealingOnBackPressure()):null!=this.opts.tasksQueueOptions&&delete this.opts.tasksQueueOptions}buildTasksQueueOptions(e){return{...F(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers),...e}}setTasksQueueSize(e){for(const t of this.workerNodes)t.tasksQueueBackPressureSize=e}setTaskStealing(){for(const e of this.workerNodes.keys())this.workerNodes[e].on("idle",this.handleWorkerNodeIdleEvent)}unsetTaskStealing(){for(const e of this.workerNodes.keys())this.workerNodes[e].off("idle",this.handleWorkerNodeIdleEvent)}setTasksStealingOnBackPressure(){for(const e of this.workerNodes.keys())this.workerNodes[e].on("backPressure",this.handleWorkerNodeBackPressureEvent)}unsetTasksStealingOnBackPressure(){for(const e of this.workerNodes.keys())this.workerNodes[e].off("backPressure",this.handleWorkerNodeBackPressureEvent)}get full(){return this.workerNodes.length>=(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers)}internalBusy(){return!0===this.opts.enableTasksQueue?-1===this.workerNodes.findIndex((e=>e.info.ready&&e.usage.tasks.executing<this.opts.tasksQueueOptions.concurrency)):-1===this.workerNodes.findIndex((e=>e.info.ready&&0===e.usage.tasks.executing))}isWorkerNodeBusy(e){return!0===this.opts.enableTasksQueue?this.workerNodes[e].usage.tasks.executing>=this.opts.tasksQueueOptions.concurrency:this.workerNodes[e].usage.tasks.executing>0}async sendTaskFunctionOperationToWorker(e,t){return await new Promise(((r,s)=>{const i=t=>{this.checkMessageWorkerId(t);const o=this.getWorkerInfo(e)?.id;null!=t.taskFunctionOperationStatus&&t.workerId===o&&(t.taskFunctionOperationStatus?r(!0):s(new Error(`Task function operation '${t.taskFunctionOperation}' failed on worker ${t.workerId} with error: '${t.workerError?.message}'`)),this.deregisterWorkerMessageListener(this.getWorkerNodeKeyByWorkerId(t.workerId),i))};this.registerWorkerMessageListener(e,i),this.sendToWorker(e,t)}))}async sendTaskFunctionOperationToWorkers(e){return await new Promise(((t,r)=>{const s=new Array,i=e=>{if(this.checkMessageWorkerId(e),null!=e.taskFunctionOperationStatus&&(s.push(e),s.length===this.workerNodes.length)){if(s.every((e=>!0===e.taskFunctionOperationStatus)))t(!0);else if(s.some((e=>!1===e.taskFunctionOperationStatus))){const t=s.find((e=>!1===e.taskFunctionOperationStatus));r(new Error(`Task function operation '${e.taskFunctionOperation}' failed on worker ${t?.workerId} with error: '${t?.workerError?.message}'`))}this.deregisterWorkerMessageListener(this.getWorkerNodeKeyByWorkerId(e.workerId),i)}};for(const t of this.workerNodes.keys())this.registerWorkerMessageListener(t,i),this.sendToWorker(t,e)}))}hasTaskFunction(e){return this.listTaskFunctionsProperties().some((t=>t.name===e))}async addTaskFunction(e,t){if("string"!=typeof e)throw new TypeError("name argument must be a string");if("string"==typeof e&&0===e.trim().length)throw new TypeError("name argument must not be an empty string");if("function"==typeof t&&(t={taskFunction:t}),"function"!=typeof t.taskFunction)throw new TypeError("taskFunction property must be a function");R(t.priority),z(t.strategy);const r=await this.sendTaskFunctionOperationToWorkers({taskFunctionOperation:"add",taskFunctionProperties:x(e,t),taskFunction:t.taskFunction.toString()});this.taskFunctions.set(e,t),this.workerChoiceStrategiesContext?.syncWorkerChoiceStrategies(this.getWorkerChoiceStrategies());for(const e of this.workerNodes.keys())this.sendStatisticsMessageToWorker(e);return r}async removeTaskFunction(e){if(!this.taskFunctions.has(e))throw new Error("Cannot remove a task function not handled on the pool side");const t=await this.sendTaskFunctionOperationToWorkers({taskFunctionOperation:"remove",taskFunctionProperties:x(e,this.taskFunctions.get(e))});for(const t of this.workerNodes)t.deleteTaskFunctionWorkerUsage(e);this.taskFunctions.delete(e),this.workerChoiceStrategiesContext?.syncWorkerChoiceStrategies(this.getWorkerChoiceStrategies());for(const e of this.workerNodes.keys())this.sendStatisticsMessageToWorker(e);return t}listTaskFunctionsProperties(){for(const e of this.workerNodes)if(Array.isArray(e.info.taskFunctionsProperties)&&e.info.taskFunctionsProperties.length>0)return e.info.taskFunctionsProperties;return[]}getTaskFunctionWorkerChoiceStrategy=e=>{e=e??l;const t=this.listTaskFunctionsProperties();return e===l&&(e=t[1]?.name),t.find((t=>t.name===e))?.strategy};getWorkerNodeTaskFunctionWorkerChoiceStrategy=(e,t)=>{const r=this.getWorkerInfo(e);if(null!=r)return(t=t??l)===l&&(t=r.taskFunctionsProperties?.[1]?.name),r.taskFunctionsProperties?.find((e=>e.name===t))?.strategy};getWorkerNodeTaskFunctionPriority=(e,t)=>{const r=this.getWorkerInfo(e);if(null!=r)return(t=t??l)===l&&(t=r.taskFunctionsProperties?.[1]?.name),r.taskFunctionsProperties?.find((e=>e.name===t))?.priority};getWorkerChoiceStrategies=()=>new Set([this.opts.workerChoiceStrategy,...this.listTaskFunctionsProperties().map((e=>e.strategy)).filter((e=>null!=e))]);async setDefaultTaskFunction(e){return await this.sendTaskFunctionOperationToWorkers({taskFunctionOperation:"default",taskFunctionProperties:x(e,this.taskFunctions.get(e))})}shallExecuteTask(e){return 0===this.tasksQueueSize(e)&&this.workerNodes[e].usage.tasks.executing<this.opts.tasksQueueOptions.concurrency}async execute(e,t,r){return await new Promise(((s,o)=>{if(!this.started)return void o(new Error("Cannot execute a task on not started pool"));if(this.destroying)return void o(new Error("Cannot execute a task on destroying pool"));if(null!=t&&"string"!=typeof t)return void o(new TypeError("name argument must be a string"));if(null!=t&&"string"==typeof t&&0===t.trim().length)return void o(new TypeError("name argument must not be an empty string"));if(null!=r&&!Array.isArray(r))return void o(new TypeError("transferList argument must be an array"));const a=u.performance.now(),h=this.chooseWorkerNode(t),k={name:t??l,data:e??{},priority:this.getWorkerNodeTaskFunctionPriority(h,t),strategy:this.getWorkerNodeTaskFunctionWorkerChoiceStrategy(h,t),transferList:r,timestamp:a,taskId:i.randomUUID()};this.promiseResponseMap.set(k.taskId,{resolve:s,reject:o,workerNodeKey:h,...null!=this.emitter&&{asyncResource:new n.AsyncResource("poolifier:task",{triggerAsyncId:this.emitter.asyncId,requireManualDestroy:!0})}}),!1===this.opts.enableTasksQueue||!0===this.opts.enableTasksQueue&&this.shallExecuteTask(h)?this.executeTask(h,k):this.enqueueTask(h,k)}))}startMinimumNumberOfWorkers(e=!1){for(this.startingMinimumNumberOfWorkers=!0;this.workerNodes.reduce(((e,t)=>t.info.dynamic?e:e+1),0)<this.minimumNumberOfWorkers;){const t=this.createAndSetupWorkerNode();e&&this.initWorkerNodeUsage(this.workerNodes[t])}this.startingMinimumNumberOfWorkers=!1}start(){if(this.started)throw new Error("Cannot start an already started pool");if(this.starting)throw new Error("Cannot start an already starting pool");if(this.destroying)throw new Error("Cannot start a destroying pool");this.starting=!0,this.startMinimumNumberOfWorkers(),this.startTimestamp=u.performance.now(),this.starting=!1,this.started=!0}async destroy(){if(!this.started)throw new Error("Cannot destroy an already destroyed pool");if(this.starting)throw new Error("Cannot destroy an starting pool");if(this.destroying)throw new Error("Cannot destroy an already destroying pool");this.destroying=!0,await Promise.all(this.workerNodes.map((async(e,t)=>{await this.destroyWorkerNode(t)}))),this.emitter?.emit(d.destroy,this.info),this.emitter?.emitDestroy(),this.readyEventEmitted=!1,delete this.startTimestamp,this.destroying=!1,this.started=!1}async sendKillMessageToWorker(e){await new Promise(((t,r)=>{if(null==this.workerNodes[e])return void t();this.registerWorkerMessageListener(e,(e=>{this.checkMessageWorkerId(e),"success"===e.kill?t():"failure"===e.kill&&r(new Error(`Kill message handling failed on worker ${e.workerId}`))})),this.sendToWorker(e,{kill:!0})}))}async destroyWorkerNode(e){this.flagWorkerNodeAsNotReady(e);const t=this.flushTasksQueue(e),r=this.workerNodes[e];await(async(e,t,r,s)=>await new Promise((i=>{let o=0;if(0!==r){switch(t){case"idle":case"backPressure":case"taskFinished":e.on(t,(()=>{++o,o===r&&i(o)}));break;default:throw new Error("Invalid worker node event")}s>=0&&setTimeout((()=>{i(o)}),s)}else i(o)})))(r,"taskFinished",t,this.opts.tasksQueueOptions?.tasksFinishedTimeout??F(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers).tasksFinishedTimeout),await this.sendKillMessageToWorker(e),await r.terminate()}setupHook(){}beforeTaskExecutionHook(e,t){if(null!=this.workerNodes[e]?.usage){const r=this.workerNodes[e].usage;++r.tasks.executing,A(this.workerChoiceStrategiesContext,r,t)}if(this.shallUpdateTaskFunctionWorkerUsage(e)&&null!=this.workerNodes[e].getTaskFunctionWorkerUsage(t.name)){const r=this.workerNodes[e].getTaskFunctionWorkerUsage(t.name);++r.tasks.executing,A(this.workerChoiceStrategiesContext,r,t)}}afterTaskExecutionHook(e,t){let r=!1;if(null!=this.workerNodes[e]?.usage){const s=this.workerNodes[e].usage;Q(s,t),K(this.workerChoiceStrategiesContext,s,t),B(this.workerChoiceStrategiesContext,s,t),r=!0}if(this.shallUpdateTaskFunctionWorkerUsage(e)&&null!=this.workerNodes[e].getTaskFunctionWorkerUsage(t.taskPerformance.name)){const s=this.workerNodes[e].getTaskFunctionWorkerUsage(t.taskPerformance.name);Q(s,t),K(this.workerChoiceStrategiesContext,s,t),B(this.workerChoiceStrategiesContext,s,t),r=!0}r&&this.workerChoiceStrategiesContext?.update(e)}shallUpdateTaskFunctionWorkerUsage(e){const t=this.getWorkerInfo(e);return null!=t&&Array.isArray(t.taskFunctionsProperties)&&t.taskFunctionsProperties.length>2}chooseWorkerNode(e){if(this.shallCreateDynamicWorker()){const e=this.createAndSetupDynamicWorkerNode();if(!0===this.workerChoiceStrategiesContext?.getPolicy().dynamicWorkerUsage)return e}return this.workerChoiceStrategiesContext.execute(this.getTaskFunctionWorkerChoiceStrategy(e))}initWorkerNodeUsage(e){!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().runTime.aggregate&&(e.usage.runTime.aggregate=W(...this.workerNodes.map((e=>e.usage.runTime.aggregate??Number.POSITIVE_INFINITY)))),!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().waitTime.aggregate&&(e.usage.waitTime.aggregate=W(...this.workerNodes.map((e=>e.usage.waitTime.aggregate??Number.POSITIVE_INFINITY)))),!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().elu.aggregate&&(e.usage.elu.active.aggregate=W(...this.workerNodes.map((e=>e.usage.elu.active.aggregate??Number.POSITIVE_INFINITY))))}createAndSetupWorkerNode(){const e=this.createWorkerNode();e.registerWorkerEventHandler("online",this.opts.onlineHandler??m),e.registerWorkerEventHandler("message",this.opts.messageHandler??m),e.registerWorkerEventHandler("error",this.opts.errorHandler??m),e.registerOnceWorkerEventHandler("error",(t=>{e.info.ready=!1,this.emitter?.emit(d.error,t),this.started&&!this.destroying&&!0===this.opts.restartWorkerOnError&&(e.info.dynamic?this.createAndSetupDynamicWorkerNode():this.startingMinimumNumberOfWorkers||this.startMinimumNumberOfWorkers(!0)),this.started&&!this.destroying&&!0===this.opts.enableTasksQueue&&this.redistributeQueuedTasks(this.workerNodes.indexOf(e)),e?.terminate().catch((e=>{this.emitter?.emit(d.error,e)}))})),e.registerWorkerEventHandler("exit",this.opts.exitHandler??m),e.registerOnceWorkerEventHandler("exit",(()=>{this.removeWorkerNode(e),!this.started||this.startingMinimumNumberOfWorkers||this.destroying||this.startMinimumNumberOfWorkers(!0)}));const t=this.addWorkerNode(e);return this.afterWorkerNodeSetup(t),t}createAndSetupDynamicWorkerNode(){const e=this.createAndSetupWorkerNode();if(this.registerWorkerMessageListener(e,(e=>{this.checkMessageWorkerId(e);const t=this.getWorkerNodeKeyByWorkerId(e.workerId),r=this.getWorkerInfo(t),s=this.workerNodes[t]?.usage;(f(V.HARD,e.kill)||f(V.SOFT,e.kill)&&(!1===this.opts.enableTasksQueue&&0===s.tasks.executing||!0===this.opts.enableTasksQueue&&null!=r&&!r.stealing&&0===s.tasks.executing&&0===this.tasksQueueSize(t)))&&(this.flagWorkerNodeAsNotReady(t),this.destroyWorkerNode(t).catch((e=>{this.emitter?.emit(d.error,e)})))})),this.sendToWorker(e,{checkActive:!0}),this.taskFunctions.size>0)for(const[t,r]of this.taskFunctions)this.sendTaskFunctionOperationToWorker(e,{taskFunctionOperation:"add",taskFunctionProperties:x(t,r),taskFunction:r.taskFunction.toString()}).catch((e=>{this.emitter?.emit(d.error,e)}));const t=this.workerNodes[e];return t.info.dynamic=!0,!0!==this.workerChoiceStrategiesContext?.getPolicy().dynamicWorkerReady&&!0!==this.workerChoiceStrategiesContext?.getPolicy().dynamicWorkerUsage||(t.info.ready=!0),this.initWorkerNodeUsage(t),this.checkAndEmitDynamicWorkerCreationEvents(),e}afterWorkerNodeSetup(e){this.registerWorkerMessageListener(e,this.workerMessageListener),this.sendStartupMessageToWorker(e),this.sendStatisticsMessageToWorker(e),!0===this.opts.enableTasksQueue&&(!0===this.opts.tasksQueueOptions?.taskStealing&&this.workerNodes[e].on("idle",this.handleWorkerNodeIdleEvent),!0===this.opts.tasksQueueOptions?.tasksStealingOnBackPressure&&this.workerNodes[e].on("backPressure",this.handleWorkerNodeBackPressureEvent))}sendStatisticsMessageToWorker(e){this.sendToWorker(e,{statistics:{runTime:this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().runTime.aggregate??!1,elu:this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().elu.aggregate??!1}})}cannotStealTask(){return this.workerNodes.length<=1||0===this.info.queuedTasks}handleTask(e,t){this.shallExecuteTask(e)?this.executeTask(e,t):this.enqueueTask(e,t)}redistributeQueuedTasks(e){if(-1!==e&&!this.cannotStealTask())for(;this.tasksQueueSize(e)>0;){const t=this.workerNodes.reduce(((t,r,s,i)=>e!==s&&r.info.ready&&r.usage.tasks.queued<i[t].usage.tasks.queued?s:t),0);this.handleTask(t,this.dequeueTask(e))}}updateTaskStolenStatisticsWorkerUsage(e,t){const r=this.workerNodes[e];null!=r?.usage&&++r.usage.tasks.stolen,this.shallUpdateTaskFunctionWorkerUsage(e)&&null!=r.getTaskFunctionWorkerUsage(t)&&++r.getTaskFunctionWorkerUsage(t).tasks.stolen}updateTaskSequentiallyStolenStatisticsWorkerUsage(e,t,r){const s=this.workerNodes[e];if(null!=s?.usage&&++s.usage.tasks.sequentiallyStolen,this.shallUpdateTaskFunctionWorkerUsage(e)&&null!=s.getTaskFunctionWorkerUsage(t)){const e=s.getTaskFunctionWorkerUsage(t);0===e.tasks.sequentiallyStolen||null!=r&&r===t&&e.tasks.sequentiallyStolen>0?++e.tasks.sequentiallyStolen:e.tasks.sequentiallyStolen>0&&(e.tasks.sequentiallyStolen=0)}}resetTaskSequentiallyStolenStatisticsWorkerUsage(e,t){const r=this.workerNodes[e];null!=r?.usage&&(r.usage.tasks.sequentiallyStolen=0),this.shallUpdateTaskFunctionWorkerUsage(e)&&null!=r.getTaskFunctionWorkerUsage(t)&&(r.getTaskFunctionWorkerUsage(t).tasks.sequentiallyStolen=0)}handleWorkerNodeIdleEvent=(e,t)=>{const{workerNodeKey:r}=e;if(null==r)throw new Error("WorkerNode event detail 'workerNodeKey' property must be defined");const s=this.getWorkerInfo(r);if(null==s)throw new Error(`Worker node with key '${r}' not found in pool`);if(this.cannotStealTask()||(this.info.stealingWorkerNodes??0)>Math.floor(this.workerNodes.length/2))return void(null!=t&&(s.stealing=!1,this.resetTaskSequentiallyStolenStatisticsWorkerUsage(r,t.name)));const i=this.workerNodes[r].usage.tasks;if(null!=t&&(i.executing>0||this.tasksQueueSize(r)>0))return s.stealing=!1,void this.resetTaskSequentiallyStolenStatisticsWorkerUsage(r,t.name);s.stealing=!0;const o=this.workerNodeStealTask(r);null!=o&&this.updateTaskSequentiallyStolenStatisticsWorkerUsage(r,o.name,t?.name),(async e=>{await new Promise((t=>{setTimeout(t,e)}))})(((e=0,t=100)=>{const r=Math.pow(2,e)*t;return r+.2*r*N()})(i.sequentiallyStolen)).then((()=>{this.handleWorkerNodeIdleEvent(e,o)})).catch((e=>{this.emitter?.emit(d.error,e)}))};workerNodeStealTask=e=>{const t=this.workerNodes.slice().sort(((e,t)=>t.usage.tasks.queued-e.usage.tasks.queued)).find(((t,r)=>t.info.ready&&!t.info.stealing&&r!==e&&t.usage.tasks.queued>0));if(null!=t){const r=t.dequeueLastPrioritizedTask();return this.handleTask(e,r),this.updateTaskStolenStatisticsWorkerUsage(e,r.name),r}};handleWorkerNodeBackPressureEvent=e=>{if(this.cannotStealTask()||this.hasBackPressure()||(this.info.stealingWorkerNodes??0)>Math.floor(this.workerNodes.length/2))return;if(this.opts.tasksQueueOptions.size<=1)return;const{workerId:t}=e,r=this.workerNodes[this.getWorkerNodeKeyByWorkerId(t)],s=this.workerNodes.slice().sort(((e,t)=>e.usage.tasks.queued-t.usage.tasks.queued));for(const[e,i]of s.entries())if(r.usage.tasks.queued>0&&i.info.ready&&!i.info.stealing&&i.info.id!==t&&i.usage.tasks.queued<this.opts.tasksQueueOptions.size-1){const t=this.getWorkerInfo(e);if(null==t)throw new Error(`Worker node with key '${e}' not found in pool`);t.stealing=!0;const s=r.dequeueLastPrioritizedTask();this.handleTask(e,s),this.updateTaskStolenStatisticsWorkerUsage(e,s.name),t.stealing=!1}};setTasksQueuePriority(e){this.workerNodes[e].setTasksQueuePriority(this.getTasksQueuePriority())}workerMessageListener=e=>{this.checkMessageWorkerId(e);const{workerId:t,ready:r,taskId:s,taskFunctionsProperties:i}=e;if(null!=r&&null!=i)this.handleWorkerReadyResponse(e);else if(null!=i){const e=this.getWorkerNodeKeyByWorkerId(t),r=this.getWorkerInfo(e);null!=r&&(r.taskFunctionsProperties=i,this.sendStatisticsMessageToWorker(e),this.setTasksQueuePriority(e))}else null!=s&&this.handleTaskExecutionResponse(e)};checkAndEmitReadyEvent(){!this.readyEventEmitted&&this.ready&&(this.emitter?.emit(d.ready,this.info),this.readyEventEmitted=!0)}handleWorkerReadyResponse(e){const{workerId:t,ready:r,taskFunctionsProperties:s}=e;if(null==r||!r)throw new Error(`Worker ${t} failed to initialize`);const i=this.getWorkerNodeKeyByWorkerId(t),o=this.workerNodes[i];o.info.ready=r,o.info.taskFunctionsProperties=s,this.sendStatisticsMessageToWorker(i),this.setTasksQueuePriority(i),this.checkAndEmitReadyEvent()}handleTaskExecutionResponse(e){const{workerId:t,taskId:r,workerError:s,data:i}=e,o=this.promiseResponseMap.get(r);if(null!=o){const{resolve:n,reject:a,workerNodeKey:u,asyncResource:h}=o,k=this.workerNodes[u];if(null!=s?(this.emitter?.emit(d.taskError,s),null!=h?h.runInAsyncScope(a,this.emitter,s.message):a(s.message)):null!=h?h.runInAsyncScope(n,this.emitter,i):n(i),h?.emitDestroy(),this.afterTaskExecutionHook(u,e),this.promiseResponseMap.delete(r),k?.emit("taskFinished",r),!0===this.opts.enableTasksQueue&&!this.destroying&&null!=k){const e=k.usage.tasks;this.tasksQueueSize(u)>0&&e.executing<this.opts.tasksQueueOptions.concurrency&&this.executeTask(u,this.dequeueTask(u)),0===e.executing&&0===this.tasksQueueSize(u)&&0===e.sequentiallyStolen&&k.emit("idle",{workerId:t,workerNodeKey:u})}}}checkAndEmitTaskExecutionEvents(){this.busy&&this.emitter?.emit(d.busy,this.info)}checkAndEmitTaskQueuingEvents(){this.hasBackPressure()&&this.emitter?.emit(d.backPressure,this.info)}getWorkerInfo(e){return this.workerNodes[e]?.info}getTasksQueuePriority(){return this.listTaskFunctionsProperties().some((e=>null!=e.priority))}createWorkerNode(){const e=new ue(this.worker,this.filePath,{env:this.opts.env,workerOptions:this.opts.workerOptions,tasksQueueBackPressureSize:this.opts.tasksQueueOptions?.size??F(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers).size,tasksQueueBucketSize:2048,tasksQueuePriority:this.getTasksQueuePriority()});return this.starting&&(e.info.ready=!0),e}addWorkerNode(e){this.workerNodes.push(e);const t=this.workerNodes.indexOf(e);if(-1===t)throw new Error("Worker added not found in worker nodes");return t}checkAndEmitEmptyEvent(){this.empty&&(this.emitter?.emit(d.empty,this.info),this.readyEventEmitted=!1)}removeWorkerNode(e){const t=this.workerNodes.indexOf(e);-1!==t&&(this.workerNodes.splice(t,1),this.workerChoiceStrategiesContext?.remove(t)),this.checkAndEmitEmptyEvent()}flagWorkerNodeAsNotReady(e){const t=this.getWorkerInfo(e);null!=t&&(t.ready=!1)}hasBackPressure(){return!0===this.opts.enableTasksQueue&&-1===this.workerNodes.findIndex((e=>!e.hasBackPressure()))}executeTask(e,t){this.beforeTaskExecutionHook(e,t),this.sendToWorker(e,t,t.transferList),this.checkAndEmitTaskExecutionEvents()}enqueueTask(e,t){const r=this.workerNodes[e].enqueueTask(t);return this.checkAndEmitTaskQueuingEvents(),r}dequeueTask(e){return this.workerNodes[e].dequeueTask()}tasksQueueSize(e){return this.workerNodes[e].tasksQueueSize()}flushTasksQueue(e){let t=0;for(;this.tasksQueueSize(e)>0;)this.executeTask(e,this.dequeueTask(e)),++t;return this.workerNodes[e].clearTasksQueue(),t}flushTasksQueues(){for(const e of this.workerNodes.keys())this.flushTasksQueue(e)}}class ke extends he{constructor(e,t,r={},s){super(e,t,r,s)}setupHook(){e.setupPrimary({...this.opts.settings,exec:this.filePath})}isMain(){return e.isPrimary}sendToWorker(e,t){this.workerNodes[e]?.worker.send({...t,workerId:this.getWorkerInfo(e)?.id})}sendStartupMessageToWorker(e){this.sendToWorker(e,{ready:!1})}registerWorkerMessageListener(e,t){this.workerNodes[e].worker.on("message",t)}registerOnceWorkerMessageListener(e,t){this.workerNodes[e].worker.once("message",t)}deregisterWorkerMessageListener(e,t){this.workerNodes[e].worker.off("message",t)}shallCreateDynamicWorker(){return!1}checkAndEmitDynamicWorkerCreationEvents(){}get type(){return c.fixed}get worker(){return b.cluster}get busy(){return this.internalBusy()}}class ce extends he{constructor(e,t,r={},s){super(e,t,r,s)}isMain(){return s.isMainThread}sendToWorker(e,t,r){this.workerNodes[e]?.messageChannel?.port1.postMessage({...t,workerId:this.getWorkerInfo(e)?.id},r)}sendStartupMessageToWorker(e){const t=this.workerNodes[e],r=t.messageChannel.port2;t.worker.postMessage({ready:!1,workerId:this.getWorkerInfo(e)?.id,port:r},[r])}registerWorkerMessageListener(e,t){this.workerNodes[e].messageChannel?.port1.on("message",t)}registerOnceWorkerMessageListener(e,t){this.workerNodes[e].messageChannel?.port1.once("message",t)}deregisterWorkerMessageListener(e,t){this.workerNodes[e].messageChannel?.port1.off("message",t)}shallCreateDynamicWorker(){return!1}checkAndEmitDynamicWorkerCreationEvents(){}get type(){return c.fixed}get worker(){return b.thread}get busy(){return this.internalBusy()}}const de=(e,t)=>{if("string"!=typeof e)throw new TypeError("A taskFunctions parameter object key is not a string");if("string"==typeof e&&0===e.trim().length)throw new TypeError("A taskFunctions parameter object key is an empty string");if("function"!=typeof t.taskFunction)throw new TypeError(`taskFunction object 'taskFunction' property '${t.taskFunction}' is not a function`);R(t.priority),z(t.strategy)},le=e=>{if("string"!=typeof e)throw new TypeError("name parameter is not a string");if("string"==typeof e&&0===e.trim().length)throw new TypeError("name parameter is an empty string")},me=6e4,ge={killBehavior:V.SOFT,maxInactiveTime:me,killHandler:m};class we{isMain;mainWorker;opts;taskFunctions;lastTaskTimestamp;statistics;activeInterval;constructor(e,t,r,s=ge){if(this.isMain=e,this.mainWorker=t,this.opts=s,null==this.isMain)throw new Error("isMain parameter is mandatory");this.checkTaskFunctions(r),this.checkWorkerOptions(this.opts),this.isMain||this.getMainWorker().on("message",this.handleReadyMessage.bind(this))}checkWorkerOptions(e){(e=>{if(null!=e&&!y(e))throw new TypeError("opts worker options parameter is not a plain object");if(null!=e?.killBehavior&&!Object.values(V).includes(e.killBehavior))throw new TypeError(`killBehavior option '${e.killBehavior}' is not valid`);if(null!=e?.maxInactiveTime&&!Number.isSafeInteger(e.maxInactiveTime))throw new TypeError("maxInactiveTime option is not an integer");if(null!=e?.maxInactiveTime&&e.maxInactiveTime<5)throw new TypeError("maxInactiveTime option is not a positive integer greater or equal than 5");if(null!=e?.killHandler&&"function"!=typeof e.killHandler)throw new TypeError("killHandler option is not a function")})(e),this.opts={...ge,...e}}checkTaskFunctions(e){if(null==e)throw new Error("taskFunctions parameter is mandatory");if(this.taskFunctions=new Map,"function"==typeof e){const t={taskFunction:e.bind(this)};this.taskFunctions.set(l,t),this.taskFunctions.set("string"==typeof e.name&&e.name.trim().length>0?e.name:"fn1",t)}else{if(!y(e))throw new TypeError("taskFunctions parameter is not a function or a plain object");{let t=!0;for(let[r,s]of Object.entries(e))"function"==typeof s&&(s={taskFunction:s}),de(r,s),s.taskFunction=s.taskFunction.bind(this),t&&(this.taskFunctions.set(l,s),t=!1),this.taskFunctions.set(r,s);if(t)throw new Error("taskFunctions parameter object is empty")}}}hasTaskFunction(e){try{le(e)}catch(e){return{status:!1,error:e}}return{status:this.taskFunctions.has(e)}}addTaskFunction(e,t){try{if(le(e),e===l)throw new Error("Cannot add a task function with the default reserved name");return"function"==typeof t&&(t={taskFunction:t}),de(e,t),t.taskFunction=t.taskFunction.bind(this),this.taskFunctions.get(e)===this.taskFunctions.get(l)&&this.taskFunctions.set(l,t),this.taskFunctions.set(e,t),this.sendTaskFunctionsPropertiesToMainWorker(),{status:!0}}catch(e){return{status:!1,error:e}}}removeTaskFunction(e){try{if(le(e),e===l)throw new Error("Cannot remove the task function with the default reserved name");if(this.taskFunctions.get(e)===this.taskFunctions.get(l))throw new Error("Cannot remove the task function used as the default task function");const t=this.taskFunctions.delete(e);return this.sendTaskFunctionsPropertiesToMainWorker(),{status:t}}catch(e){return{status:!1,error:e}}}listTaskFunctionsProperties(){let e=l;for(const[t,r]of this.taskFunctions)if(t!==l&&r===this.taskFunctions.get(l)){e=t;break}const t=[];for(const[r,s]of this.taskFunctions)r!==l&&r!==e&&t.push(x(r,s));return[x(l,this.taskFunctions.get(l)),x(e,this.taskFunctions.get(e)),...t]}setDefaultTaskFunction(e){try{if(le(e),e===l)throw new Error("Cannot set the default task function reserved name as the default task function");if(!this.taskFunctions.has(e))throw new Error("Cannot set the default task function to a non-existing task function");return this.taskFunctions.set(l,this.taskFunctions.get(e)),this.sendTaskFunctionsPropertiesToMainWorker(),{status:!0}}catch(e){return{status:!1,error:e}}}messageListener(e){this.checkMessageWorkerId(e);const{statistics:t,checkActive:r,taskFunctionOperation:s,taskId:i,data:o,kill:n}=e;null!=t?this.statistics=t:null!=r?r?this.startCheckActive():this.stopCheckActive():null!=s?this.handleTaskFunctionOperationMessage(e):null!=i&&null!=o?this.run(e):!0===n&&this.handleKillMessage(e)}handleTaskFunctionOperationMessage(e){const{taskFunctionOperation:t,taskFunctionProperties:r,taskFunction:s}=e;if(null==r)throw new Error("Cannot handle task function operation message without task function properties");let i;switch(t){case"add":i=this.addTaskFunction(r.name,{taskFunction:new Function(`return ${s}`)(),...null!=r.priority&&{priority:r.priority},...null!=r.strategy&&{strategy:r.strategy}});break;case"remove":i=this.removeTaskFunction(r.name);break;case"default":i=this.setDefaultTaskFunction(r.name);break;default:i={status:!1,error:new Error("Unknown task operation")}}this.sendToMainWorker({taskFunctionOperation:t,taskFunctionOperationStatus:i.status,taskFunctionProperties:r,...!i.status&&null!=i.error&&{workerError:{name:r.name,message:this.handleError(i.error)}}})}handleKillMessage(e){if(this.stopCheckActive(),T(this.opts.killHandler))this.opts.killHandler().then((()=>{this.sendToMainWorker({kill:"success"})})).catch((()=>{this.sendToMainWorker({kill:"failure"})}));else try{this.opts.killHandler?.(),this.sendToMainWorker({kill:"success"})}catch{this.sendToMainWorker({kill:"failure"})}}checkMessageWorkerId(e){if(null==e.workerId)throw new Error("Message worker id is not set");if(e.workerId!==this.id)throw new Error(`Message worker id ${e.workerId} does not match the worker id ${this.id}`)}startCheckActive(){this.lastTaskTimestamp=u.performance.now(),this.activeInterval=setInterval(this.checkActive.bind(this),(this.opts.maxInactiveTime??me)/2)}stopCheckActive(){null!=this.activeInterval&&(clearInterval(this.activeInterval),delete this.activeInterval)}checkActive(){u.performance.now()-this.lastTaskTimestamp>(this.opts.maxInactiveTime??me)&&this.sendToMainWorker({kill:this.opts.killBehavior})}getMainWorker(){if(null==this.mainWorker)throw new Error("Main worker not set");return this.mainWorker}sendTaskFunctionsPropertiesToMainWorker(){this.sendToMainWorker({taskFunctionsProperties:this.listTaskFunctionsProperties()})}handleError(e){return e instanceof Error?e.message:e}run=e=>{const{name:t,taskId:r,data:s}=e,i=t??l;if(!this.taskFunctions.has(i))return void this.sendToMainWorker({workerError:{name:t,message:`Task function '${t}' not found`,data:s},taskId:r});const o=this.taskFunctions.get(i)?.taskFunction;T(o)?this.runAsync(o,e):this.runSync(o,e)};runSync=(e,t)=>{const{name:r,taskId:s,data:i}=t;try{let t=this.beginTaskPerformance(r);const o=e(i);t=this.endTaskPerformance(t),this.sendToMainWorker({data:o,taskPerformance:t,taskId:s})}catch(e){this.sendToMainWorker({workerError:{name:r,message:this.handleError(e),data:i},taskId:s})}finally{this.updateLastTaskTimestamp()}};runAsync=(e,t)=>{const{name:r,taskId:s,data:i}=t;let o=this.beginTaskPerformance(r);e(i).then((e=>{o=this.endTaskPerformance(o),this.sendToMainWorker({data:e,taskPerformance:o,taskId:s})})).catch((e=>{this.sendToMainWorker({workerError:{name:r,message:this.handleError(e),data:i},taskId:s})})).finally((()=>{this.updateLastTaskTimestamp()})).catch(m)};beginTaskPerformance(e){if(null==this.statistics)throw new Error("Performance statistics computation requirements not set");return{name:e??l,timestamp:u.performance.now(),...this.statistics.elu&&{elu:u.performance.eventLoopUtilization()}}}endTaskPerformance(e){if(null==this.statistics)throw new Error("Performance statistics computation requirements not set");return{...e,...this.statistics.runTime&&{runTime:u.performance.now()-e.timestamp},...this.statistics.elu&&{elu:u.performance.eventLoopUtilization(e.elu)}}}updateLastTaskTimestamp(){null!=this.activeInterval&&(this.lastTaskTimestamp=u.performance.now())}}exports.ClusterWorker=class extends we{constructor(t,r={}){super(e.isPrimary,e.worker,t,r)}handleReadyMessage(e){if(e.workerId===this.id&&!1===e.ready)try{this.getMainWorker().on("message",this.messageListener.bind(this)),this.sendToMainWorker({ready:!0,taskFunctionsProperties:this.listTaskFunctionsProperties()})}catch{this.sendToMainWorker({ready:!1,taskFunctionsProperties:this.listTaskFunctionsProperties()})}}get id(){return this.getMainWorker().id}sendToMainWorker=e=>{this.getMainWorker().send({...e,workerId:this.id})}},exports.DynamicClusterPool=class extends ke{constructor(e,t,r,s={}){super(e,r,s,t),O(this.minimumNumberOfWorkers,this.maximumNumberOfWorkers)}shallCreateDynamicWorker(){return!this.full&&this.internalBusy()||this.empty}checkAndEmitDynamicWorkerCreationEvents(){this.full&&this.emitter?.emit(d.full,this.info)}get type(){return c.dynamic}get busy(){return this.full&&this.internalBusy()}},exports.DynamicThreadPool=class extends ce{constructor(e,t,r,s={}){super(e,r,s,t),O(this.minimumNumberOfWorkers,this.maximumNumberOfWorkers)}shallCreateDynamicWorker(){return!this.full&&this.internalBusy()||this.empty}checkAndEmitDynamicWorkerCreationEvents(){this.full&&this.emitter?.emit(d.full,this.info)}get type(){return c.dynamic}get busy(){return this.full&&this.internalBusy()}},exports.FixedClusterPool=ke,exports.FixedThreadPool=ce,exports.KillBehaviors=V,exports.Measurements=v,exports.PoolEvents=d,exports.PoolTypes=c,exports.ThreadWorker=class extends we{port;constructor(e,t={}){super(s.isMainThread,s.parentPort,e,t)}handleReadyMessage(e){if(e.workerId===this.id&&!1===e.ready&&null!=e.port)try{this.port=e.port,this.port.on("message",this.messageListener.bind(this)),this.sendToMainWorker({ready:!0,taskFunctionsProperties:this.listTaskFunctionsProperties()})}catch{this.sendToMainWorker({ready:!1,taskFunctionsProperties:this.listTaskFunctionsProperties()})}}handleKillMessage(e){super.handleKillMessage(e),this.port?.unref(),this.port?.close()}get id(){return s.threadId}sendToMainWorker=e=>{this.port?.postMessage({...e,workerId:this.id})};handleError(e){return e}},exports.WorkerChoiceStrategies=E,exports.WorkerTypes=b,exports.availableParallelism=()=>{let e=1;try{e=k.availableParallelism()}catch{const t=k.cpus();Array.isArray(t)&&t.length>0&&(e=t.length)}return e};
1
+ "use strict";var e=require("node:cluster"),t=require("node:fs"),r=require("node:process"),s=require("node:worker_threads"),i=require("node:crypto"),o=require("node:os"),n=require("node:async_hooks"),a=require("node:events"),u=require("node:perf_hooks");function h(e){var t=Object.create(null);return e&&Object.keys(e).forEach((function(r){if("default"!==r){var s=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,s.get?s:{enumerable:!0,get:function(){return e[r]}})}})),t.default=e,Object.freeze(t)}var k=h(o);const c=Object.freeze({fixed:"fixed",dynamic:"dynamic"}),d=Object.freeze({ready:"ready",busy:"busy",full:"full",empty:"empty",destroy:"destroy",error:"error",taskError:"taskError",backPressure:"backPressure"}),l="default",g=Object.freeze((()=>{})),m=e=>Array.isArray(e)&&0===e.length?0:Array.isArray(e)&&1===e.length?e[0]:e.reduce(((e,t)=>e+t),0)/e.length,w=e=>{if(Array.isArray(e)&&0===e.length)return 0;if(Array.isArray(e)&&1===e.length)return e[0];const t=e.slice().sort(((e,t)=>e-t));return(t[t.length-1>>1]+t[t.length>>1])/2},p=(e,t=2)=>{const r=Math.pow(10,t);return Math.round(e*r*(1+Number.EPSILON))/r},y=e=>"object"==typeof e&&null!==e&&e.constructor===Object&&"[object Object]"===Object.prototype.toString.call(e),f=(e,t)=>t===e,T=e=>"function"==typeof e&&"AsyncFunction"===e.constructor.name,N=()=>i.getRandomValues(new Uint32Array(1))[0]/4294967296,W=(...e)=>e.reduce(((e,t)=>e<t?e:t),Number.POSITIVE_INFINITY),S=(...e)=>e.reduce(((e,t)=>e>t?e:t),Number.NEGATIVE_INFINITY),x=(e,t)=>({name:e,...null!=t?.priority&&{priority:t.priority},...null!=t?.strategy&&{strategy:t.strategy}}),E=Object.freeze({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"}),v=Object.freeze({runTime:"runTime",waitTime:"waitTime",elu:"elu"}),I=386,b=Object.freeze({thread:"thread",cluster:"cluster"}),C={aggregate:!1,average:!1,median:!1},F=e=>({size:Math.pow(e,2),concurrency:1,taskStealing:!0,tasksStealingOnBackPressure:!1,tasksFinishedTimeout:2e3}),P=e=>{if(null==e)throw new TypeError("The worker file path must be specified");if("string"!=typeof e)throw new TypeError("The worker file path must be a string");if(!t.existsSync(e))throw new Error(`Cannot find the worker file '${e}'`)},O=(e,t)=>{if(null==t)throw new TypeError("Cannot instantiate a dynamic pool without specifying the maximum pool size");if(!Number.isSafeInteger(t))throw new TypeError("Cannot instantiate a dynamic pool with a non safe integer maximum pool size");if(e>t)throw new RangeError("Cannot instantiate a dynamic pool with a maximum pool size inferior to the minimum pool size");if(0===t)throw new RangeError("Cannot instantiate a dynamic pool with a maximum pool size equal to zero");if(e===t)throw new RangeError("Cannot instantiate a dynamic pool with a minimum pool size equal to the maximum pool size. Use a fixed pool instead")},R=e=>{if(null!=e&&!Number.isSafeInteger(e))throw new TypeError(`Invalid property 'priority': '${e.toString()}'`);if(null!=e&&Number.isSafeInteger(e)&&(e<-20||e>19))throw new RangeError("Property 'priority' must be between -20 and 19")},z=e=>{if(null!=e&&!Object.values(E).includes(e))throw new Error(`Invalid worker choice strategy '${e}'`)},q=e=>{if(null!=e&&!y(e))throw new TypeError("Invalid tasks queue options: must be a plain object");if(null!=e?.concurrency&&!Number.isSafeInteger(e.concurrency))throw new TypeError("Invalid worker node tasks concurrency: must be an integer");if(null!=e?.concurrency&&e.concurrency<=0)throw new RangeError(`Invalid worker node tasks concurrency: ${e.concurrency.toString()} is a negative integer or zero`);if(null!=e?.size&&!Number.isSafeInteger(e.size))throw new TypeError("Invalid worker node tasks queue size: must be an integer");if(null!=e?.size&&e.size<=0)throw new RangeError(`Invalid worker node tasks queue size: ${e.size.toString()} is a negative integer or zero`)},M=(e,t,r)=>{null!=t&&null!=r&&t.aggregate&&(e.aggregate=(e.aggregate??0)+r,e.minimum=W(r,e.minimum??Number.POSITIVE_INFINITY),e.maximum=S(r,e.maximum??Number.NEGATIVE_INFINITY),(t.average||t.median)&&(e.history.put(r),t.average?e.average=m(e.history.toArray()):null!=e.average&&delete e.average,t.median?e.median=w(e.history.toArray()):null!=e.median&&delete e.median))};"test"===r.env.NODE_ENV&&(exports.updateMeasurementStatistics=M);const A=(e,t,r)=>{const s=performance.now(),i=s-(r.timestamp??s);M(t.waitTime,e?.getTaskStatisticsRequirements().waitTime,i)},Q=(e,t)=>{const r=e.tasks;null!=r.executing&&r.executing>0&&--r.executing,null==t.workerError?++r.executed:++r.failed},K=(e,t,r)=>{null==r.workerError&&M(t.runTime,e?.getTaskStatisticsRequirements().runTime,r.taskPerformance?.runTime??0)},B=(e,t,r)=>{if(null!=r.workerError)return;const s=e?.getTaskStatisticsRequirements().elu;M(t.elu.active,s,r.taskPerformance?.elu?.active??0),M(t.elu.idle,s,r.taskPerformance?.elu?.idle??0),!0===s?.aggregate&&null!=r.taskPerformance?.elu&&(null!=t.elu.utilization?t.elu.utilization=(t.elu.utilization+r.taskPerformance.elu.utilization)/2:t.elu.utilization=r.taskPerformance.elu.utilization)},U=t=>t instanceof s.Worker?b.thread:t instanceof e.Worker?b.cluster:void 0,D=t=>t instanceof s.Worker?t.threadId:t instanceof e.Worker?t.id:void 0;class _{start;nodeArray;capacity;size;enablePriority;constructor(e=2048,t=!1){this.checkSize(e),this.capacity=e,this.enablePriority=t,this.nodeArray=new Array(this.capacity),this.clear()}empty(){return 0===this.size}full(){return this.size===this.capacity}enqueue(e,t){if(this.full())throw new Error("Priority queue is full");t=t??0;let r=!1;if(this.enablePriority){let s=this.start;for(let i=0;i<this.size;i++){if(this.nodeArray[s].priority>t){this.nodeArray.splice(s,0,{data:e,priority:t}),this.nodeArray.length!==this.capacity&&(this.nodeArray.length=this.capacity),r=!0;break}++s,s===this.capacity&&(s=0)}}if(!r){let r=this.start+this.size;r>=this.capacity&&(r-=this.capacity),this.nodeArray[r]={data:e,priority:t}}return++this.size}get(e){if(!(this.empty()||e>=this.size))return(e+=this.start)>=this.capacity&&(e-=this.capacity),this.nodeArray[e].data}dequeue(){if(this.empty())return;const e=this.start;return--this.size,++this.start,this.start===this.capacity&&(this.start=0),this.nodeArray[e].data}clear(){this.start=0,this.size=0}[Symbol.iterator](){let e=this.start,t=0;return{next:()=>{if(t>=this.size)return{value:void 0,done:!0};const r=this.nodeArray[e].data;return++e,++t,e===this.capacity&&(e=0),{value:r,done:!1}}}}checkSize(e){if(!Number.isSafeInteger(e))throw new TypeError(`Invalid fixed priority queue size: '${e.toString()}' is not an integer`);if(e<0)throw new RangeError(`Invalid fixed priority queue size: ${e.toString()} < 0`)}}class L{head;tail;bucketSize;maxSize;constructor(e=2048,t=!1){if(!Number.isSafeInteger(e))throw new TypeError(`Invalid bucket size: '${e.toString()}' is not an integer`);if(e<0)throw new RangeError(`Invalid bucket size: ${e.toString()} < 0`);this.bucketSize=e,this.head=this.tail=new _(this.bucketSize,t),this.maxSize=0}get size(){let e=this.tail,t=0;for(;null!=e;)t+=e.size,e=e.next;return t}get enablePriority(){return this.head.enablePriority}set enablePriority(e){if(this.head.enablePriority===e)return;let t=this.tail;for(;null!=t;)t.enablePriority=e,t=t.next}get buckets(){return Math.trunc(this.size/this.bucketSize)}enqueue(e,t){this.head.full()&&(this.head=this.head.next=new _(this.bucketSize,this.enablePriority)),this.head.enqueue(e,t);const r=this.size;return r>this.maxSize&&(this.maxSize=r),r}dequeue(e){let t=this.tail,r=!1;if(null!=e&&e>0){let s=1;for(;null!=t&&s!==e;)++s,t=t.next,r=!0}const s=t.dequeue();if(t.empty()&&null!=t.next){if(r){let e=this.tail;for(;null!=e;){if(e.next===t){e.next=t.next;break}e=e.next}}else this.tail=t.next;delete t.next}return s}clear(){this.head=this.tail=new _(this.bucketSize,this.enablePriority),this.maxSize=0}[Symbol.iterator](){let e=0,t=this.tail;return{next:()=>{const r=t.get(e);return null==r?{value:void 0,done:!0}:(++e,e===t.capacity&&null!=t.next&&(t=t.next,e=0),{value:r,done:!1})}}}}const V=Object.freeze({SOFT:"SOFT",HARD:"HARD"});class H{pool;opts;nextWorkerNodeKey=0;previousWorkerNodeKey=0;strategyPolicy={dynamicWorkerUsage:!1,dynamicWorkerReady:!0};taskStatisticsRequirements={runTime:C,waitTime:C,elu:C};constructor(e,t){this.pool=e,this.opts=t,this.choose=this.choose.bind(this),this.setOptions(this.opts)}setTaskStatisticsRequirements(e){se(this.taskStatisticsRequirements.runTime,e.runTime.median),se(this.taskStatisticsRequirements.waitTime,e.waitTime.median),se(this.taskStatisticsRequirements.elu,e.elu.median)}resetWorkerNodeKeyProperties(){this.nextWorkerNodeKey=0,this.previousWorkerNodeKey=0}setOptions(e){this.opts=re(this.pool,e),this.setTaskStatisticsRequirements(this.opts)}isWorkerNodeReady(e){return this.pool.workerNodes[e]?.info?.ready??!1}checkNextWorkerNodeKey(){null!=this.nextWorkerNodeKey&&(this.nextWorkerNodeKey<0||!this.isWorkerNodeReady(this.nextWorkerNodeKey))&&delete this.nextWorkerNodeKey}getWorkerNodeTaskRunTime(e){return this.taskStatisticsRequirements.runTime.median?this.pool.workerNodes[e].usage.runTime.median??0:this.pool.workerNodes[e].usage.runTime.average??0}getWorkerNodeTaskWaitTime(e){return this.taskStatisticsRequirements.waitTime.median?this.pool.workerNodes[e].usage.waitTime.median??0:this.pool.workerNodes[e].usage.waitTime.average??0}getWorkerNodeTaskElu(e){return this.taskStatisticsRequirements.elu.median?this.pool.workerNodes[e].usage.elu.active.median??0:this.pool.workerNodes[e].usage.elu.active.average??0}setPreviousWorkerNodeKey(e){this.previousWorkerNodeKey=null!=e&&e>=0?e:this.previousWorkerNodeKey}}class j extends H{taskStatisticsRequirements={runTime:{aggregate:!0,average:!0,median:!1},waitTime:{aggregate:!0,average:!0,median:!1},elu:{aggregate:!0,average:!0,median:!1}};constructor(e,t){super(e,t),this.setTaskStatisticsRequirements(this.opts)}reset(){for(const e of this.pool.workerNodes)delete e.strategyData?.virtualTaskEndTimestamp;return!0}update(e){return this.pool.workerNodes[e].strategyData={virtualTaskEndTimestamp:this.computeWorkerNodeVirtualTaskEndTimestamp(e)},!0}choose(){return this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.nextWorkerNodeKey=this.fairShareNextWorkerNodeKey(),this.nextWorkerNodeKey}remove(){return!0}fairShareNextWorkerNodeKey(){return this.pool.workerNodes.reduce(((e,t,r,s)=>(null==t.strategyData?.virtualTaskEndTimestamp&&(t.strategyData={virtualTaskEndTimestamp:this.computeWorkerNodeVirtualTaskEndTimestamp(r)}),this.isWorkerNodeReady(r)&&t.strategyData.virtualTaskEndTimestamp<s[e].strategyData.virtualTaskEndTimestamp?r:e)),0)}computeWorkerNodeVirtualTaskEndTimestamp(e){return this.getWorkerNodeVirtualTaskEndTimestamp(e,this.getWorkerNodeVirtualTaskStartTimestamp(e))}getWorkerNodeVirtualTaskEndTimestamp(e,t){return t+(this.getWorkerNodeTaskWaitTime(e)+(this.opts.measurement===v.elu?this.getWorkerNodeTaskElu(e):this.getWorkerNodeTaskRunTime(e)))}getWorkerNodeVirtualTaskStartTimestamp(e){const t=this.pool.workerNodes[e]?.strategyData?.virtualTaskEndTimestamp,r=performance.now();return r<(t??Number.NEGATIVE_INFINITY)?t:r}}class $ extends H{taskStatisticsRequirements={runTime:{aggregate:!0,average:!0,median:!1},waitTime:{aggregate:!0,average:!0,median:!1},elu:C};roundId=0;roundWeights;workerNodeId=0;workerNodeVirtualTaskExecutionTime=0;constructor(e,t){super(e,t),this.setTaskStatisticsRequirements(this.opts),this.roundWeights=this.getRoundWeights()}reset(){return this.resetWorkerNodeKeyProperties(),this.roundId=0,this.workerNodeId=0,this.workerNodeVirtualTaskExecutionTime=0,!0}update(){return!0}choose(){for(let e=this.roundId;e<this.roundWeights.length;e++){this.roundId=e;for(let t=this.workerNodeId;t<this.pool.workerNodes.length;t++){this.workerNodeId=t,this.workerNodeId!==this.nextWorkerNodeKey&&0!==this.workerNodeVirtualTaskExecutionTime&&(this.workerNodeVirtualTaskExecutionTime=0);const r=this.opts.weights[t];if(this.isWorkerNodeReady(t)&&r>=this.roundWeights[e]&&this.workerNodeVirtualTaskExecutionTime<r)return this.workerNodeVirtualTaskExecutionTime+=this.getWorkerNodeTaskWaitTime(t)+this.getWorkerNodeTaskRunTime(t),this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.nextWorkerNodeKey=t,this.nextWorkerNodeKey}}this.interleavedWeightedRoundRobinNextWorkerNodeId()}interleavedWeightedRoundRobinNextWorkerNodeId(){0===this.pool.workerNodes.length?this.workerNodeId=0:this.roundId===this.roundWeights.length-1&&this.workerNodeId===this.pool.workerNodes.length-1?(this.roundId=0,this.workerNodeId=0):this.workerNodeId===this.pool.workerNodes.length-1?(this.roundId=this.roundId+1,this.workerNodeId=0):this.workerNodeId=this.workerNodeId+1}remove(e){return 0===this.pool.workerNodes.length?(this.resetWorkerNodeKeyProperties(),this.workerNodeId=0,this.workerNodeVirtualTaskExecutionTime=0,!0):(this.workerNodeId===e&&this.workerNodeId>this.pool.workerNodes.length-1&&(this.workerNodeId=this.pool.workerNodes.length-1),this.previousWorkerNodeKey===e&&this.previousWorkerNodeKey>this.pool.workerNodes.length-1&&(this.previousWorkerNodeKey=this.pool.workerNodes.length-1),!0)}setOptions(e){super.setOptions(e),this.roundWeights=this.getRoundWeights()}getRoundWeights(){return[...new Set(Object.values(this.opts.weights).slice().sort(((e,t)=>e-t)))]}}class Y extends H{taskStatisticsRequirements={runTime:{aggregate:!0,average:!1,median:!1},waitTime:{aggregate:!0,average:!1,median:!1},elu:C};constructor(e,t){super(e,t),this.setTaskStatisticsRequirements(this.opts)}reset(){return!0}update(){return!0}choose(){return this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.nextWorkerNodeKey=this.leastBusyNextWorkerNodeKey(),this.nextWorkerNodeKey}remove(){return!0}leastBusyNextWorkerNodeKey(){return this.pool.workerNodes.reduce(((e,t,r,s)=>this.isWorkerNodeReady(r)&&(t.usage.waitTime.aggregate??0)+(t.usage.runTime.aggregate??0)<(s[e].usage.waitTime.aggregate??0)+(s[e].usage.runTime.aggregate??0)?r:e),0)}}class G extends H{taskStatisticsRequirements={runTime:C,waitTime:C,elu:{aggregate:!0,average:!1,median:!1}};constructor(e,t){super(e,t),this.setTaskStatisticsRequirements(this.opts)}reset(){return!0}update(){return!0}choose(){return this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.nextWorkerNodeKey=this.leastEluNextWorkerNodeKey(),this.nextWorkerNodeKey}remove(){return!0}leastEluNextWorkerNodeKey(){return this.pool.workerNodes.reduce(((e,t,r,s)=>this.isWorkerNodeReady(r)&&(t.usage.elu.active.aggregate??0)<(s[e].usage.elu.active.aggregate??0)?r:e),0)}}class J extends H{constructor(e,t){super(e,t)}reset(){return!0}update(){return!0}choose(){return this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.nextWorkerNodeKey=this.leastUsedNextWorkerNodeKey(),this.nextWorkerNodeKey}remove(){return!0}leastUsedNextWorkerNodeKey(){return this.pool.workerNodes.reduce(((e,t,r,s)=>this.isWorkerNodeReady(r)&&t.usage.tasks.executing+t.usage.tasks.queued<s[e].usage.tasks.executing+s[e].usage.tasks.queued?r:e),0)}}class X extends H{constructor(e,t){super(e,t)}reset(){return this.resetWorkerNodeKeyProperties(),!0}update(){return!0}choose(){const e=this.nextWorkerNodeKey;return this.setPreviousWorkerNodeKey(e),this.roundRobinNextWorkerNodeKey(),this.checkNextWorkerNodeKey(),e}remove(e){return 0===this.pool.workerNodes.length?(this.reset(),!0):(this.nextWorkerNodeKey===e&&this.nextWorkerNodeKey>this.pool.workerNodes.length-1&&(this.nextWorkerNodeKey=this.pool.workerNodes.length-1),this.previousWorkerNodeKey===e&&this.previousWorkerNodeKey>this.pool.workerNodes.length-1&&(this.previousWorkerNodeKey=this.pool.workerNodes.length-1),!0)}roundRobinNextWorkerNodeKey(){return this.nextWorkerNodeKey=this.nextWorkerNodeKey===this.pool.workerNodes.length-1?0:(this.nextWorkerNodeKey??this.previousWorkerNodeKey)+1,this.nextWorkerNodeKey}}class Z extends H{taskStatisticsRequirements={runTime:{aggregate:!0,average:!0,median:!1},waitTime:{aggregate:!0,average:!0,median:!1},elu:C};workerNodeVirtualTaskExecutionTime=0;constructor(e,t){super(e,t),this.setTaskStatisticsRequirements(this.opts)}reset(){return this.resetWorkerNodeKeyProperties(),this.workerNodeVirtualTaskExecutionTime=0,!0}update(){return!0}choose(){return this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey),this.weightedRoundRobinNextWorkerNodeKey(),this.checkNextWorkerNodeKey(),this.nextWorkerNodeKey}remove(e){return 0===this.pool.workerNodes.length?(this.reset(),!0):(this.nextWorkerNodeKey===e&&(this.workerNodeVirtualTaskExecutionTime=0,this.nextWorkerNodeKey>this.pool.workerNodes.length-1&&(this.nextWorkerNodeKey=this.pool.workerNodes.length-1)),this.previousWorkerNodeKey===e&&this.previousWorkerNodeKey>this.pool.workerNodes.length-1&&(this.previousWorkerNodeKey=this.pool.workerNodes.length-1),!0)}weightedRoundRobinNextWorkerNodeKey(){const e=this.opts.weights[this.nextWorkerNodeKey??this.previousWorkerNodeKey];return this.workerNodeVirtualTaskExecutionTime<e?this.workerNodeVirtualTaskExecutionTime+=this.getWorkerNodeTaskWaitTime(this.nextWorkerNodeKey??this.previousWorkerNodeKey)+this.getWorkerNodeTaskRunTime(this.nextWorkerNodeKey??this.previousWorkerNodeKey):(this.nextWorkerNodeKey=this.nextWorkerNodeKey===this.pool.workerNodes.length-1?0:(this.nextWorkerNodeKey??this.previousWorkerNodeKey)+1,this.workerNodeVirtualTaskExecutionTime=0),this.nextWorkerNodeKey}}const ee=()=>{const e=o.cpus();let t;e.every((e=>null==e.speed||0===e.speed))&&(t=(()=>{const e=performance.now(),t=performance.now()-e;return Math.trunc(15e7/t/1e3)})());let r=0;for(const s of e){null!=s.speed&&0!==s.speed||(s.speed=e.find((e=>null!=e.speed&&0!==e.speed))?.speed??t??2e3);const i=s.speed.toString().length-1;r+=1/(s.speed/Math.pow(10,i))*Math.pow(10,i)}return Math.round(r/e.length)},te=(e,t)=>{t=t??ee();const r={};for(let s=0;s<e;s++)r[s]=t;return r},re=(e,t)=>((t=structuredClone(t??{})).weights=t.weights??te(e.info.maxSize),{runTime:{median:!1},waitTime:{median:!1},elu:{median:!1},...t}),se=(e,t)=>{e.average&&t&&(e.average=!1,e.median=t),e.median&&!t&&(e.average=!0,e.median=t)},ie=e=>{const t=Array.from(e,(([e,t])=>t.strategyPolicy));return{dynamicWorkerUsage:t.some((e=>e.dynamicWorkerUsage)),dynamicWorkerReady:t.some((e=>e.dynamicWorkerReady))}},oe=e=>{const t=Array.from(e,(([e,t])=>t.taskStatisticsRequirements));return{runTime:{aggregate:t.some((e=>e.runTime.aggregate)),average:t.some((e=>e.runTime.average)),median:t.some((e=>e.runTime.median))},waitTime:{aggregate:t.some((e=>e.waitTime.aggregate)),average:t.some((e=>e.waitTime.average)),median:t.some((e=>e.waitTime.median))},elu:{aggregate:t.some((e=>e.elu.aggregate)),average:t.some((e=>e.elu.average)),median:t.some((e=>e.elu.median))}}};class ne{pool;retriesCount;defaultWorkerChoiceStrategy;workerChoiceStrategies;workerChoiceStrategiesPolicy;workerChoiceStrategiesTaskStatisticsRequirements;retries;constructor(e,t=[E.ROUND_ROBIN],r){this.pool=e,this.execute=this.execute.bind(this),this.defaultWorkerChoiceStrategy=t[0],this.workerChoiceStrategies=new Map;for(const e of t)this.addWorkerChoiceStrategy(e,this.pool,r);this.workerChoiceStrategiesPolicy=ie(this.workerChoiceStrategies),this.workerChoiceStrategiesTaskStatisticsRequirements=oe(this.workerChoiceStrategies),this.retriesCount=0,this.retries=((e,t)=>e.info.maxSize+Object.keys(t?.weights??te(e.info.maxSize)).length)(this.pool,r)}getPolicy(){return this.workerChoiceStrategiesPolicy}getTaskStatisticsRequirements(){return this.workerChoiceStrategiesTaskStatisticsRequirements}setDefaultWorkerChoiceStrategy(e,t){e!==this.defaultWorkerChoiceStrategy&&(this.defaultWorkerChoiceStrategy=e,this.addWorkerChoiceStrategy(e,this.pool,t))}update(e){return Array.from(this.workerChoiceStrategies,(([t,r])=>r.update(e))).every((e=>e))}execute(e=this.defaultWorkerChoiceStrategy){return this.executeStrategy(this.workerChoiceStrategies.get(e))}executeStrategy(e){let t,r=0,s=0;do{t=e.choose(),null==t&&r>0&&(++s,++this.retriesCount),++r}while(null==t&&s<this.retries);if(null==t)throw new Error(`Worker node key chosen is null or undefined after ${s.toString()} retries`);return t}remove(e){return Array.from(this.workerChoiceStrategies,(([t,r])=>r.remove(e))).every((e=>e))}setOptions(e){for(const t of this.workerChoiceStrategies.values())t.setOptions(e)}syncWorkerChoiceStrategies(e,t){for(const t of this.workerChoiceStrategies.keys())e.has(t)||this.removeWorkerChoiceStrategy(t);for(const r of e)this.workerChoiceStrategies.has(r)||this.addWorkerChoiceStrategy(r,this.pool,t);this.workerChoiceStrategiesPolicy=ie(this.workerChoiceStrategies),this.workerChoiceStrategiesTaskStatisticsRequirements=oe(this.workerChoiceStrategies)}addWorkerChoiceStrategy(e,t,r){return this.workerChoiceStrategies.has(e)?this.workerChoiceStrategies:this.workerChoiceStrategies.set(e,((e,t,r,s)=>{switch(e){case E.ROUND_ROBIN:return new(X.bind(r))(t,s);case E.LEAST_USED:return new(J.bind(r))(t,s);case E.LEAST_BUSY:return new(Y.bind(r))(t,s);case E.LEAST_ELU:return new(G.bind(r))(t,s);case E.FAIR_SHARE:return new(j.bind(r))(t,s);case E.WEIGHTED_ROUND_ROBIN:return new(Z.bind(r))(t,s);case E.INTERLEAVED_WEIGHTED_ROUND_ROBIN:return new($.bind(r))(t,s);default:throw new Error(`Worker choice strategy '${e}' is not valid`)}})(e,t,this,r))}removeWorkerChoiceStrategy(e){return this.workerChoiceStrategies.delete(e)}}class ae{readIdx;writeIdx;items;maxArrayIdx;size;constructor(e=2048){this.checkSize(e),this.readIdx=0,this.writeIdx=0,this.maxArrayIdx=e-1,this.size=0,this.items=new Float32Array(e).fill(-1)}empty(){return 0===this.size}full(){return this.size===this.items.length}put(e){this.items[this.writeIdx]=e,this.writeIdx=this.writeIdx===this.maxArrayIdx?0:this.writeIdx+1,this.size<this.items.length&&++this.size}get(){const e=this.items[this.readIdx];if(-1!==e)return this.items[this.readIdx]=-1,this.readIdx=this.readIdx===this.maxArrayIdx?0:this.readIdx+1,--this.size,e}toArray(){return Array.from(this.items.filter((e=>-1!==e)))}checkSize(e){if(!Number.isSafeInteger(e))throw new TypeError(`Invalid circular buffer size: '${e.toString()}' is not an integer`);if(e<0)throw new RangeError(`Invalid circular buffer size: ${e.toString()} < 0`)}}class ue extends a.EventEmitter{worker;info;usage;strategyData;messageChannel;tasksQueueBackPressureSize;tasksQueue;setBackPressureFlag;taskFunctionsUsage;constructor(t,r,i){super(),((e,t,r)=>{if(null==e)throw new TypeError("Cannot construct a worker node without a worker type");if(!Object.values(b).includes(e))throw new TypeError(`Cannot construct a worker node with an invalid worker type '${e}'`);if(P(t),null==r)throw new TypeError("Cannot construct a worker node without worker node options");if(!y(r))throw new TypeError("Cannot construct a worker node with invalid worker node options: must be a plain object");if(null==r.tasksQueueBackPressureSize)throw new TypeError("Cannot construct a worker node without a tasks queue back pressure size option");if(!Number.isSafeInteger(r.tasksQueueBackPressureSize))throw new TypeError("Cannot construct a worker node with a tasks queue back pressure size option that is not an integer");if(r.tasksQueueBackPressureSize<=0)throw new RangeError("Cannot construct a worker node with a tasks queue back pressure size option that is not a positive integer");if(null==r.tasksQueueBucketSize)throw new TypeError("Cannot construct a worker node without a tasks queue bucket size option");if(!Number.isSafeInteger(r.tasksQueueBucketSize))throw new TypeError("Cannot construct a worker node with a tasks queue bucket size option that is not an integer");if(r.tasksQueueBucketSize<=0)throw new RangeError("Cannot construct a worker node with a tasks queue bucket size option that is not a positive integer");if(null==r.tasksQueuePriority)throw new TypeError("Cannot construct a worker node without a tasks queue priority option");if("boolean"!=typeof r.tasksQueuePriority)throw new TypeError("Cannot construct a worker node with a tasks queue priority option that is not a boolean")})(t,r,i),this.worker=((t,r,i)=>{switch(t){case b.thread:return new s.Worker(r,{env:s.SHARE_ENV,...i.workerOptions});case b.cluster:return e.fork(i.env);default:throw new Error(`Unknown worker type '${t}'`)}})(t,r,{env:i.env,workerOptions:i.workerOptions}),this.info=this.initWorkerInfo(this.worker),this.usage=this.initWorkerUsage(),this.info.type===b.thread&&(this.messageChannel=new s.MessageChannel),this.tasksQueueBackPressureSize=i.tasksQueueBackPressureSize,this.tasksQueue=new L(i.tasksQueueBucketSize,i.tasksQueuePriority),this.setBackPressureFlag=!1,this.taskFunctionsUsage=new Map}setTasksQueuePriority(e){this.tasksQueue.enablePriority=e}tasksQueueSize(){return this.tasksQueue.size}enqueueTask(e){const t=this.tasksQueue.enqueue(e,e.priority);return this.setBackPressureFlag||!this.hasBackPressure()||this.info.backPressure||(this.setBackPressureFlag=!0,this.info.backPressure=!0,this.emit("backPressure",{workerId:this.info.id}),this.setBackPressureFlag=!1),t}dequeueTask(e){const t=this.tasksQueue.dequeue(e);return this.setBackPressureFlag||this.hasBackPressure()||!this.info.backPressure||(this.setBackPressureFlag=!0,this.info.backPressure=!1,this.setBackPressureFlag=!1),t}dequeueLastPrioritizedTask(){return this.dequeueTask(this.tasksQueue.buckets+1)}clearTasksQueue(){this.tasksQueue.clear()}hasBackPressure(){return this.tasksQueue.size>=this.tasksQueueBackPressureSize}async terminate(){const e=new Promise((e=>{this.registerOnceWorkerEventHandler("exit",(()=>{e()}))}));switch(this.closeMessageChannel(),this.removeAllListeners(),this.info.type){case b.thread:this.worker.unref?.(),await(this.worker.terminate?.());break;case b.cluster:this.registerOnceWorkerEventHandler("disconnect",(()=>{this.worker.kill?.()})),this.worker.disconnect?.()}await e}registerWorkerEventHandler(e,t){this.worker.on(e,t)}registerOnceWorkerEventHandler(e,t){this.worker.once(e,t)}getTaskFunctionWorkerUsage(e){if(!Array.isArray(this.info.taskFunctionsProperties))throw new Error(`Cannot get task function worker usage for task function name '${e}' when task function properties list is not yet defined`);if(Array.isArray(this.info.taskFunctionsProperties)&&this.info.taskFunctionsProperties.length<3)throw new Error(`Cannot get task function worker usage for task function name '${e}' when task function properties list has less than 3 elements`);return e===l&&(e=this.info.taskFunctionsProperties[1].name),this.taskFunctionsUsage.has(e)||this.taskFunctionsUsage.set(e,this.initTaskFunctionWorkerUsage(e)),this.taskFunctionsUsage.get(e)}deleteTaskFunctionWorkerUsage(e){return this.taskFunctionsUsage.delete(e)}closeMessageChannel(){null!=this.messageChannel&&(this.messageChannel.port1.unref(),this.messageChannel.port2.unref(),this.messageChannel.port1.close(),this.messageChannel.port2.close(),delete this.messageChannel)}initWorkerInfo(e){return{id:D(e),type:U(e),dynamic:!1,ready:!1,stealing:!1,backPressure:!1}}initWorkerUsage(){const e=()=>this.tasksQueue.size,t=()=>this.tasksQueue.maxSize;return{tasks:{executed:0,executing:0,get queued(){return e()},get maxQueued(){return t()},sequentiallyStolen:0,stolen:0,failed:0},runTime:{history:new ae(I)},waitTime:{history:new ae(I)},elu:{idle:{history:new ae(I)},active:{history:new ae(I)}}}}initTaskFunctionWorkerUsage(e){const t=()=>{let t=0;for(const r of this.tasksQueue)(r.name===l&&e===this.info.taskFunctionsProperties[1].name||r.name!==l&&e===r.name)&&++t;return t};return{tasks:{executed:0,executing:0,get queued(){return t()},sequentiallyStolen:0,stolen:0,failed:0},runTime:{history:new ae(I)},waitTime:{history:new ae(I)},elu:{idle:{history:new ae(I)},active:{history:new ae(I)}}}}}class he{minimumNumberOfWorkers;filePath;opts;maximumNumberOfWorkers;workerNodes=[];emitter;promiseResponseMap=new Map;workerChoiceStrategiesContext;taskFunctions;started;starting;destroying;startingMinimumNumberOfWorkers;readyEventEmitted;startTimestamp;constructor(e,t,r,s){if(this.minimumNumberOfWorkers=e,this.filePath=t,this.opts=r,this.maximumNumberOfWorkers=s,!this.isMain())throw new Error("Cannot start a pool from a worker with the same type as the pool");this.checkPoolType(),P(this.filePath),this.checkMinimumNumberOfWorkers(this.minimumNumberOfWorkers),this.checkPoolOptions(this.opts),this.chooseWorkerNode=this.chooseWorkerNode.bind(this),this.executeTask=this.executeTask.bind(this),this.enqueueTask=this.enqueueTask.bind(this),!0===this.opts.enableEvents&&this.initEventEmitter(),this.workerChoiceStrategiesContext=new ne(this,[this.opts.workerChoiceStrategy],this.opts.workerChoiceStrategyOptions),this.setupHook(),this.taskFunctions=new Map,this.started=!1,this.starting=!1,this.destroying=!1,this.readyEventEmitted=!1,this.startingMinimumNumberOfWorkers=!1,!0===this.opts.startWorkers&&this.start()}checkPoolType(){if(this.type===c.fixed&&null!=this.maximumNumberOfWorkers)throw new Error("Cannot instantiate a fixed pool with a maximum number of workers specified at initialization")}checkMinimumNumberOfWorkers(e){if(null==e)throw new Error("Cannot instantiate a pool without specifying the number of workers");if(!Number.isSafeInteger(e))throw new TypeError("Cannot instantiate a pool with a non safe integer number of workers");if(e<0)throw new RangeError("Cannot instantiate a pool with a negative number of workers");if(this.type===c.fixed&&0===e)throw new RangeError("Cannot instantiate a fixed pool with zero worker")}checkPoolOptions(e){if(!y(e))throw new TypeError("Invalid pool options: must be a plain object");this.opts.startWorkers=e.startWorkers??!0,z(e.workerChoiceStrategy),this.opts.workerChoiceStrategy=e.workerChoiceStrategy??E.ROUND_ROBIN,this.checkValidWorkerChoiceStrategyOptions(e.workerChoiceStrategyOptions),null!=e.workerChoiceStrategyOptions&&(this.opts.workerChoiceStrategyOptions=e.workerChoiceStrategyOptions),this.opts.restartWorkerOnError=e.restartWorkerOnError??!0,this.opts.enableEvents=e.enableEvents??!0,this.opts.enableTasksQueue=e.enableTasksQueue??!1,this.opts.enableTasksQueue&&(q(e.tasksQueueOptions),this.opts.tasksQueueOptions=this.buildTasksQueueOptions(e.tasksQueueOptions))}checkValidWorkerChoiceStrategyOptions(e){if(null!=e&&!y(e))throw new TypeError("Invalid worker choice strategy options: must be a plain object");if(null!=e?.weights&&Object.keys(e.weights).length!==(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers))throw new Error("Invalid worker choice strategy options: must have a weight for each worker node");if(null!=e?.measurement&&!Object.values(v).includes(e.measurement))throw new Error(`Invalid worker choice strategy options: invalid measurement '${e.measurement}'`)}initEventEmitter(){this.emitter=new a.EventEmitterAsyncResource({name:`poolifier:${this.type}-${this.worker}-pool`})}get info(){return{version:"4.0.14",type:this.type,worker:this.worker,started:this.started,ready:this.ready,defaultStrategy:this.opts.workerChoiceStrategy,strategyRetries:this.workerChoiceStrategiesContext?.retriesCount??0,minSize:this.minimumNumberOfWorkers,maxSize:this.maximumNumberOfWorkers??this.minimumNumberOfWorkers,...!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().runTime.aggregate&&this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().waitTime.aggregate&&{utilization:p(this.utilization)},workerNodes:this.workerNodes.length,idleWorkerNodes:this.workerNodes.reduce(((e,t)=>0===t.usage.tasks.executing?e+1:e),0),...!0===this.opts.enableTasksQueue&&{stealingWorkerNodes:this.workerNodes.reduce(((e,t)=>t.info.stealing?e+1:e),0)},busyWorkerNodes:this.workerNodes.reduce(((e,t,r)=>this.isWorkerNodeBusy(r)?e+1:e),0),executedTasks:this.workerNodes.reduce(((e,t)=>e+t.usage.tasks.executed),0),executingTasks:this.workerNodes.reduce(((e,t)=>e+t.usage.tasks.executing),0),...!0===this.opts.enableTasksQueue&&{queuedTasks:this.workerNodes.reduce(((e,t)=>e+t.usage.tasks.queued),0)},...!0===this.opts.enableTasksQueue&&{maxQueuedTasks:this.workerNodes.reduce(((e,t)=>e+(t.usage.tasks.maxQueued??0)),0)},...!0===this.opts.enableTasksQueue&&{backPressure:this.hasBackPressure()},...!0===this.opts.enableTasksQueue&&{stolenTasks:this.workerNodes.reduce(((e,t)=>e+t.usage.tasks.stolen),0)},failedTasks:this.workerNodes.reduce(((e,t)=>e+t.usage.tasks.failed),0),...!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().runTime.aggregate&&{runTime:{minimum:p(W(...this.workerNodes.map((e=>e.usage.runTime.minimum??Number.POSITIVE_INFINITY)))),maximum:p(S(...this.workerNodes.map((e=>e.usage.runTime.maximum??Number.NEGATIVE_INFINITY)))),...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().runTime.average&&{average:p(m(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.runTime.history.toArray())),[])))},...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().runTime.median&&{median:p(w(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.runTime.history.toArray())),[])))}}},...!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().waitTime.aggregate&&{waitTime:{minimum:p(W(...this.workerNodes.map((e=>e.usage.waitTime.minimum??Number.POSITIVE_INFINITY)))),maximum:p(S(...this.workerNodes.map((e=>e.usage.waitTime.maximum??Number.NEGATIVE_INFINITY)))),...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().waitTime.average&&{average:p(m(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.waitTime.history.toArray())),[])))},...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().waitTime.median&&{median:p(w(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.waitTime.history.toArray())),[])))}}},...!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().elu.aggregate&&{elu:{idle:{minimum:p(W(...this.workerNodes.map((e=>e.usage.elu.idle.minimum??Number.POSITIVE_INFINITY)))),maximum:p(S(...this.workerNodes.map((e=>e.usage.elu.idle.maximum??Number.NEGATIVE_INFINITY)))),...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().elu.average&&{average:p(m(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.elu.idle.history.toArray())),[])))},...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().elu.median&&{median:p(w(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.elu.idle.history.toArray())),[])))}},active:{minimum:p(W(...this.workerNodes.map((e=>e.usage.elu.active.minimum??Number.POSITIVE_INFINITY)))),maximum:p(S(...this.workerNodes.map((e=>e.usage.elu.active.maximum??Number.NEGATIVE_INFINITY)))),...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().elu.average&&{average:p(m(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.elu.active.history.toArray())),[])))},...this.workerChoiceStrategiesContext.getTaskStatisticsRequirements().elu.median&&{median:p(w(this.workerNodes.reduce(((e,t)=>e.concat(t.usage.elu.active.history.toArray())),[])))}},utilization:{average:p(m(this.workerNodes.map((e=>e.usage.elu.utilization??0)))),median:p(w(this.workerNodes.map((e=>e.usage.elu.utilization??0))))}}}}}get ready(){return!this.empty&&this.workerNodes.reduce(((e,t)=>!t.info.dynamic&&t.info.ready?e+1:e),0)>=this.minimumNumberOfWorkers}get empty(){return 0===this.minimumNumberOfWorkers&&0===this.workerNodes.length}get utilization(){if(null==this.startTimestamp)return 0;const e=(u.performance.now()-this.startTimestamp)*(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers);return(this.workerNodes.reduce(((e,t)=>e+(t.usage.runTime.aggregate??0)),0)+this.workerNodes.reduce(((e,t)=>e+(t.usage.waitTime.aggregate??0)),0))/e}checkMessageWorkerId(e){if(null==e.workerId)throw new Error("Worker message received without worker id");if(-1===this.getWorkerNodeKeyByWorkerId(e.workerId))throw new Error(`Worker message received from unknown worker '${e.workerId.toString()}'`)}getWorkerNodeKeyByWorkerId(e){return this.workerNodes.findIndex((t=>t.info.id===e))}setWorkerChoiceStrategy(e,t){let r=!1;if(z(e),null!=t&&(r=!this.setWorkerChoiceStrategyOptions(t)),e!==this.opts.workerChoiceStrategy&&(this.opts.workerChoiceStrategy=e,this.workerChoiceStrategiesContext?.setDefaultWorkerChoiceStrategy(this.opts.workerChoiceStrategy,this.opts.workerChoiceStrategyOptions),r=!0),r){this.workerChoiceStrategiesContext?.syncWorkerChoiceStrategies(this.getWorkerChoiceStrategies(),this.opts.workerChoiceStrategyOptions);for(const e of this.workerNodes.keys())this.sendStatisticsMessageToWorker(e)}}setWorkerChoiceStrategyOptions(e){if(this.checkValidWorkerChoiceStrategyOptions(e),null!=e){this.opts.workerChoiceStrategyOptions=e,this.workerChoiceStrategiesContext?.setOptions(this.opts.workerChoiceStrategyOptions),this.workerChoiceStrategiesContext?.syncWorkerChoiceStrategies(this.getWorkerChoiceStrategies(),this.opts.workerChoiceStrategyOptions);for(const e of this.workerNodes.keys())this.sendStatisticsMessageToWorker(e);return!0}return!1}enableTasksQueue(e,t){!0!==this.opts.enableTasksQueue||e||(this.unsetTaskStealing(),this.unsetTasksStealingOnBackPressure(),this.flushTasksQueues()),this.opts.enableTasksQueue=e,this.setTasksQueueOptions(t)}setTasksQueueOptions(e){!0===this.opts.enableTasksQueue?(q(e),this.opts.tasksQueueOptions=this.buildTasksQueueOptions(e),this.setTasksQueueSize(this.opts.tasksQueueOptions.size),!0===this.opts.tasksQueueOptions.taskStealing?(this.unsetTaskStealing(),this.setTaskStealing()):this.unsetTaskStealing(),!0===this.opts.tasksQueueOptions.tasksStealingOnBackPressure?(this.unsetTasksStealingOnBackPressure(),this.setTasksStealingOnBackPressure()):this.unsetTasksStealingOnBackPressure()):null!=this.opts.tasksQueueOptions&&delete this.opts.tasksQueueOptions}buildTasksQueueOptions(e){return{...F(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers),...e}}setTasksQueueSize(e){for(const t of this.workerNodes)t.tasksQueueBackPressureSize=e}setTaskStealing(){for(const e of this.workerNodes.keys())this.workerNodes[e].on("idle",this.handleWorkerNodeIdleEvent)}unsetTaskStealing(){for(const e of this.workerNodes.keys())this.workerNodes[e].off("idle",this.handleWorkerNodeIdleEvent)}setTasksStealingOnBackPressure(){for(const e of this.workerNodes.keys())this.workerNodes[e].on("backPressure",this.handleWorkerNodeBackPressureEvent)}unsetTasksStealingOnBackPressure(){for(const e of this.workerNodes.keys())this.workerNodes[e].off("backPressure",this.handleWorkerNodeBackPressureEvent)}get full(){return this.workerNodes.length>=(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers)}internalBusy(){return!0===this.opts.enableTasksQueue?-1===this.workerNodes.findIndex((e=>e.info.ready&&e.usage.tasks.executing<this.opts.tasksQueueOptions.concurrency)):-1===this.workerNodes.findIndex((e=>e.info.ready&&0===e.usage.tasks.executing))}isWorkerNodeBusy(e){return!0===this.opts.enableTasksQueue?this.workerNodes[e].usage.tasks.executing>=this.opts.tasksQueueOptions.concurrency:this.workerNodes[e].usage.tasks.executing>0}async sendTaskFunctionOperationToWorker(e,t){return await new Promise(((r,s)=>{const i=t=>{this.checkMessageWorkerId(t);const o=this.getWorkerInfo(e)?.id;null!=t.taskFunctionOperationStatus&&t.workerId===o&&(t.taskFunctionOperationStatus?r(!0):s(new Error(`Task function operation '${t.taskFunctionOperation?.toString()}' failed on worker ${t.workerId?.toString()} with error: '${t.workerError?.message}'`)),this.deregisterWorkerMessageListener(this.getWorkerNodeKeyByWorkerId(t.workerId),i))};this.registerWorkerMessageListener(e,i),this.sendToWorker(e,t)}))}async sendTaskFunctionOperationToWorkers(e){return await new Promise(((t,r)=>{const s=new Array,i=e=>{if(this.checkMessageWorkerId(e),null!=e.taskFunctionOperationStatus&&(s.push(e),s.length===this.workerNodes.length)){if(s.every((e=>!0===e.taskFunctionOperationStatus)))t(!0);else if(s.some((e=>!1===e.taskFunctionOperationStatus))){const t=s.find((e=>!1===e.taskFunctionOperationStatus));r(new Error(`Task function operation '${e.taskFunctionOperation}' failed on worker ${t?.workerId?.toString()} with error: '${t?.workerError?.message}'`))}this.deregisterWorkerMessageListener(this.getWorkerNodeKeyByWorkerId(e.workerId),i)}};for(const t of this.workerNodes.keys())this.registerWorkerMessageListener(t,i),this.sendToWorker(t,e)}))}hasTaskFunction(e){return this.listTaskFunctionsProperties().some((t=>t.name===e))}async addTaskFunction(e,t){if("string"!=typeof e)throw new TypeError("name argument must be a string");if("string"==typeof e&&0===e.trim().length)throw new TypeError("name argument must not be an empty string");if("function"==typeof t&&(t={taskFunction:t}),"function"!=typeof t.taskFunction)throw new TypeError("taskFunction property must be a function");R(t.priority),z(t.strategy);const r=await this.sendTaskFunctionOperationToWorkers({taskFunctionOperation:"add",taskFunctionProperties:x(e,t),taskFunction:t.taskFunction.toString()});this.taskFunctions.set(e,t),this.workerChoiceStrategiesContext?.syncWorkerChoiceStrategies(this.getWorkerChoiceStrategies());for(const e of this.workerNodes.keys())this.sendStatisticsMessageToWorker(e);return r}async removeTaskFunction(e){if(!this.taskFunctions.has(e))throw new Error("Cannot remove a task function not handled on the pool side");const t=await this.sendTaskFunctionOperationToWorkers({taskFunctionOperation:"remove",taskFunctionProperties:x(e,this.taskFunctions.get(e))});for(const t of this.workerNodes)t.deleteTaskFunctionWorkerUsage(e);this.taskFunctions.delete(e),this.workerChoiceStrategiesContext?.syncWorkerChoiceStrategies(this.getWorkerChoiceStrategies());for(const e of this.workerNodes.keys())this.sendStatisticsMessageToWorker(e);return t}listTaskFunctionsProperties(){for(const e of this.workerNodes)if(Array.isArray(e.info.taskFunctionsProperties)&&e.info.taskFunctionsProperties.length>0)return e.info.taskFunctionsProperties;return[]}getTaskFunctionWorkerChoiceStrategy=e=>{e=e??l;const t=this.listTaskFunctionsProperties();return e===l&&(e=t[1]?.name),t.find((t=>t.name===e))?.strategy};getWorkerNodeTaskFunctionWorkerChoiceStrategy=(e,t)=>{const r=this.getWorkerInfo(e);if(null!=r)return(t=t??l)===l&&(t=r.taskFunctionsProperties?.[1]?.name),r.taskFunctionsProperties?.find((e=>e.name===t))?.strategy};getWorkerNodeTaskFunctionPriority=(e,t)=>{const r=this.getWorkerInfo(e);if(null!=r)return(t=t??l)===l&&(t=r.taskFunctionsProperties?.[1]?.name),r.taskFunctionsProperties?.find((e=>e.name===t))?.priority};getWorkerChoiceStrategies=()=>new Set([this.opts.workerChoiceStrategy,...this.listTaskFunctionsProperties().map((e=>e.strategy)).filter((e=>null!=e))]);async setDefaultTaskFunction(e){return await this.sendTaskFunctionOperationToWorkers({taskFunctionOperation:"default",taskFunctionProperties:x(e,this.taskFunctions.get(e))})}shallExecuteTask(e){return 0===this.tasksQueueSize(e)&&this.workerNodes[e].usage.tasks.executing<this.opts.tasksQueueOptions.concurrency}async execute(e,t,r){return await new Promise(((s,o)=>{if(!this.started)return void o(new Error("Cannot execute a task on not started pool"));if(this.destroying)return void o(new Error("Cannot execute a task on destroying pool"));if(null!=t&&"string"!=typeof t)return void o(new TypeError("name argument must be a string"));if(null!=t&&"string"==typeof t&&0===t.trim().length)return void o(new TypeError("name argument must not be an empty string"));if(null!=r&&!Array.isArray(r))return void o(new TypeError("transferList argument must be an array"));const a=u.performance.now(),h=this.chooseWorkerNode(t),k={name:t??l,data:e??{},priority:this.getWorkerNodeTaskFunctionPriority(h,t),strategy:this.getWorkerNodeTaskFunctionWorkerChoiceStrategy(h,t),transferList:r,timestamp:a,taskId:i.randomUUID()};this.promiseResponseMap.set(k.taskId,{resolve:s,reject:o,workerNodeKey:h,...null!=this.emitter&&{asyncResource:new n.AsyncResource("poolifier:task",{triggerAsyncId:this.emitter.asyncId,requireManualDestroy:!0})}}),!1===this.opts.enableTasksQueue||!0===this.opts.enableTasksQueue&&this.shallExecuteTask(h)?this.executeTask(h,k):this.enqueueTask(h,k)}))}mapExecute(e,t,r){return Promise.all([...e].map((e=>this.execute(e,t,r))))}startMinimumNumberOfWorkers(e=!1){for(this.startingMinimumNumberOfWorkers=!0;this.workerNodes.reduce(((e,t)=>t.info.dynamic?e:e+1),0)<this.minimumNumberOfWorkers;){const t=this.createAndSetupWorkerNode();e&&this.initWorkerNodeUsage(this.workerNodes[t])}this.startingMinimumNumberOfWorkers=!1}start(){if(this.started)throw new Error("Cannot start an already started pool");if(this.starting)throw new Error("Cannot start an already starting pool");if(this.destroying)throw new Error("Cannot start a destroying pool");this.starting=!0,this.startMinimumNumberOfWorkers(),this.startTimestamp=u.performance.now(),this.starting=!1,this.started=!0}async destroy(){if(!this.started)throw new Error("Cannot destroy an already destroyed pool");if(this.starting)throw new Error("Cannot destroy an starting pool");if(this.destroying)throw new Error("Cannot destroy an already destroying pool");this.destroying=!0,await Promise.all(this.workerNodes.map((async(e,t)=>{await this.destroyWorkerNode(t)}))),this.emitter?.emit(d.destroy,this.info),this.emitter?.emitDestroy(),this.readyEventEmitted=!1,delete this.startTimestamp,this.destroying=!1,this.started=!1}async sendKillMessageToWorker(e){await new Promise(((t,r)=>{if(null==this.workerNodes[e])return void t();this.registerWorkerMessageListener(e,(e=>{this.checkMessageWorkerId(e),"success"===e.kill?t():"failure"===e.kill&&r(new Error(`Kill message handling failed on worker ${e.workerId?.toString()}`))})),this.sendToWorker(e,{kill:!0})}))}async destroyWorkerNode(e){this.flagWorkerNodeAsNotReady(e);const t=this.flushTasksQueue(e),r=this.workerNodes[e];await(async(e,t,r,s)=>await new Promise((i=>{let o=0;if(0!==r){switch(t){case"idle":case"backPressure":case"taskFinished":e.on(t,(()=>{++o,o===r&&i(o)}));break;default:throw new Error("Invalid worker node event")}s>=0&&setTimeout((()=>{i(o)}),s)}else i(o)})))(r,"taskFinished",t,this.opts.tasksQueueOptions?.tasksFinishedTimeout??F(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers).tasksFinishedTimeout),await this.sendKillMessageToWorker(e),await r.terminate()}setupHook(){}beforeTaskExecutionHook(e,t){if(null!=this.workerNodes[e]?.usage){const r=this.workerNodes[e].usage;++r.tasks.executing,A(this.workerChoiceStrategiesContext,r,t)}if(this.shallUpdateTaskFunctionWorkerUsage(e)&&null!=this.workerNodes[e].getTaskFunctionWorkerUsage(t.name)){const r=this.workerNodes[e].getTaskFunctionWorkerUsage(t.name);++r.tasks.executing,A(this.workerChoiceStrategiesContext,r,t)}}afterTaskExecutionHook(e,t){let r=!1;if(null!=this.workerNodes[e]?.usage){const s=this.workerNodes[e].usage;Q(s,t),K(this.workerChoiceStrategiesContext,s,t),B(this.workerChoiceStrategiesContext,s,t),r=!0}if(this.shallUpdateTaskFunctionWorkerUsage(e)&&null!=this.workerNodes[e].getTaskFunctionWorkerUsage(t.taskPerformance.name)){const s=this.workerNodes[e].getTaskFunctionWorkerUsage(t.taskPerformance.name);Q(s,t),K(this.workerChoiceStrategiesContext,s,t),B(this.workerChoiceStrategiesContext,s,t),r=!0}r&&this.workerChoiceStrategiesContext?.update(e)}shallUpdateTaskFunctionWorkerUsage(e){const t=this.getWorkerInfo(e);return null!=t&&Array.isArray(t.taskFunctionsProperties)&&t.taskFunctionsProperties.length>2}chooseWorkerNode(e){if(this.shallCreateDynamicWorker()){const e=this.createAndSetupDynamicWorkerNode();if(!0===this.workerChoiceStrategiesContext?.getPolicy().dynamicWorkerUsage)return e}return this.workerChoiceStrategiesContext.execute(this.getTaskFunctionWorkerChoiceStrategy(e))}initWorkerNodeUsage(e){!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().runTime.aggregate&&(e.usage.runTime.aggregate=W(...this.workerNodes.map((e=>e.usage.runTime.aggregate??Number.POSITIVE_INFINITY)))),!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().waitTime.aggregate&&(e.usage.waitTime.aggregate=W(...this.workerNodes.map((e=>e.usage.waitTime.aggregate??Number.POSITIVE_INFINITY)))),!0===this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().elu.aggregate&&(e.usage.elu.active.aggregate=W(...this.workerNodes.map((e=>e.usage.elu.active.aggregate??Number.POSITIVE_INFINITY))))}createAndSetupWorkerNode(){const e=this.createWorkerNode();e.registerWorkerEventHandler("online",this.opts.onlineHandler??g),e.registerWorkerEventHandler("message",this.opts.messageHandler??g),e.registerWorkerEventHandler("error",this.opts.errorHandler??g),e.registerOnceWorkerEventHandler("error",(t=>{e.info.ready=!1,this.emitter?.emit(d.error,t),this.started&&!this.destroying&&!0===this.opts.restartWorkerOnError&&(e.info.dynamic?this.createAndSetupDynamicWorkerNode():this.startingMinimumNumberOfWorkers||this.startMinimumNumberOfWorkers(!0)),this.started&&!this.destroying&&!0===this.opts.enableTasksQueue&&this.redistributeQueuedTasks(this.workerNodes.indexOf(e)),e?.terminate().catch((e=>{this.emitter?.emit(d.error,e)}))})),e.registerWorkerEventHandler("exit",this.opts.exitHandler??g),e.registerOnceWorkerEventHandler("exit",(()=>{this.removeWorkerNode(e),!this.started||this.startingMinimumNumberOfWorkers||this.destroying||this.startMinimumNumberOfWorkers(!0)}));const t=this.addWorkerNode(e);return this.afterWorkerNodeSetup(t),t}createAndSetupDynamicWorkerNode(){const e=this.createAndSetupWorkerNode();if(this.registerWorkerMessageListener(e,(e=>{this.checkMessageWorkerId(e);const t=this.getWorkerNodeKeyByWorkerId(e.workerId),r=this.getWorkerInfo(t),s=this.workerNodes[t]?.usage;(f(V.HARD,e.kill)||f(V.SOFT,e.kill)&&(!1===this.opts.enableTasksQueue&&0===s.tasks.executing||!0===this.opts.enableTasksQueue&&null!=r&&!r.stealing&&0===s.tasks.executing&&0===this.tasksQueueSize(t)))&&(this.flagWorkerNodeAsNotReady(t),this.destroyWorkerNode(t).catch((e=>{this.emitter?.emit(d.error,e)})))})),this.sendToWorker(e,{checkActive:!0}),this.taskFunctions.size>0)for(const[t,r]of this.taskFunctions)this.sendTaskFunctionOperationToWorker(e,{taskFunctionOperation:"add",taskFunctionProperties:x(t,r),taskFunction:r.taskFunction.toString()}).catch((e=>{this.emitter?.emit(d.error,e)}));const t=this.workerNodes[e];return t.info.dynamic=!0,!0!==this.workerChoiceStrategiesContext?.getPolicy().dynamicWorkerReady&&!0!==this.workerChoiceStrategiesContext?.getPolicy().dynamicWorkerUsage||(t.info.ready=!0),this.initWorkerNodeUsage(t),this.checkAndEmitDynamicWorkerCreationEvents(),e}afterWorkerNodeSetup(e){this.registerWorkerMessageListener(e,this.workerMessageListener),this.sendStartupMessageToWorker(e),this.sendStatisticsMessageToWorker(e),!0===this.opts.enableTasksQueue&&(!0===this.opts.tasksQueueOptions?.taskStealing&&this.workerNodes[e].on("idle",this.handleWorkerNodeIdleEvent),!0===this.opts.tasksQueueOptions?.tasksStealingOnBackPressure&&this.workerNodes[e].on("backPressure",this.handleWorkerNodeBackPressureEvent))}sendStatisticsMessageToWorker(e){this.sendToWorker(e,{statistics:{runTime:this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().runTime.aggregate??!1,elu:this.workerChoiceStrategiesContext?.getTaskStatisticsRequirements().elu.aggregate??!1}})}cannotStealTask(){return this.workerNodes.length<=1||0===this.info.queuedTasks}handleTask(e,t){this.shallExecuteTask(e)?this.executeTask(e,t):this.enqueueTask(e,t)}redistributeQueuedTasks(e){if(-1!==e&&!this.cannotStealTask())for(;this.tasksQueueSize(e)>0;){const t=this.workerNodes.reduce(((t,r,s,i)=>e!==s&&r.info.ready&&r.usage.tasks.queued<i[t].usage.tasks.queued?s:t),0);this.handleTask(t,this.dequeueTask(e))}}updateTaskStolenStatisticsWorkerUsage(e,t){const r=this.workerNodes[e];null!=r?.usage&&++r.usage.tasks.stolen,this.shallUpdateTaskFunctionWorkerUsage(e)&&null!=r.getTaskFunctionWorkerUsage(t)&&++r.getTaskFunctionWorkerUsage(t).tasks.stolen}updateTaskSequentiallyStolenStatisticsWorkerUsage(e,t,r){const s=this.workerNodes[e];if(null!=s?.usage&&++s.usage.tasks.sequentiallyStolen,this.shallUpdateTaskFunctionWorkerUsage(e)&&null!=s.getTaskFunctionWorkerUsage(t)){const e=s.getTaskFunctionWorkerUsage(t);0===e.tasks.sequentiallyStolen||null!=r&&r===t&&e.tasks.sequentiallyStolen>0?++e.tasks.sequentiallyStolen:e.tasks.sequentiallyStolen>0&&(e.tasks.sequentiallyStolen=0)}}resetTaskSequentiallyStolenStatisticsWorkerUsage(e,t){const r=this.workerNodes[e];null!=r?.usage&&(r.usage.tasks.sequentiallyStolen=0),this.shallUpdateTaskFunctionWorkerUsage(e)&&null!=r.getTaskFunctionWorkerUsage(t)&&(r.getTaskFunctionWorkerUsage(t).tasks.sequentiallyStolen=0)}handleWorkerNodeIdleEvent=(e,t)=>{const{workerNodeKey:r}=e;if(null==r)throw new Error("WorkerNode event detail 'workerNodeKey' property must be defined");const s=this.getWorkerInfo(r);if(null==s)throw new Error(`Worker node with key '${r.toString()}' not found in pool`);if(this.cannotStealTask()||(this.info.stealingWorkerNodes??0)>Math.floor(this.workerNodes.length/2))return void(null!=t&&(s.stealing=!1,this.resetTaskSequentiallyStolenStatisticsWorkerUsage(r,t.name)));const i=this.workerNodes[r].usage.tasks;if(null!=t&&(i.executing>0||this.tasksQueueSize(r)>0))return s.stealing=!1,void this.resetTaskSequentiallyStolenStatisticsWorkerUsage(r,t.name);s.stealing=!0;const o=this.workerNodeStealTask(r);null!=o&&this.updateTaskSequentiallyStolenStatisticsWorkerUsage(r,o.name,t?.name),(async e=>{await new Promise((t=>{setTimeout(t,e)}))})(((e=0,t=100)=>{const r=Math.pow(2,e)*t;return r+.2*r*N()})(i.sequentiallyStolen)).then((()=>{this.handleWorkerNodeIdleEvent(e,o)})).catch((e=>{this.emitter?.emit(d.error,e)}))};workerNodeStealTask=e=>{const t=this.workerNodes.slice().sort(((e,t)=>t.usage.tasks.queued-e.usage.tasks.queued)).find(((t,r)=>t.info.ready&&!t.info.stealing&&r!==e&&t.usage.tasks.queued>0));if(null!=t){const r=t.dequeueLastPrioritizedTask();return this.handleTask(e,r),this.updateTaskStolenStatisticsWorkerUsage(e,r.name),r}};handleWorkerNodeBackPressureEvent=e=>{if(this.cannotStealTask()||this.hasBackPressure()||(this.info.stealingWorkerNodes??0)>Math.floor(this.workerNodes.length/2))return;if(this.opts.tasksQueueOptions.size<=1)return;const{workerId:t}=e,r=this.workerNodes[this.getWorkerNodeKeyByWorkerId(t)],s=this.workerNodes.slice().sort(((e,t)=>e.usage.tasks.queued-t.usage.tasks.queued));for(const[e,i]of s.entries())if(r.usage.tasks.queued>0&&i.info.ready&&!i.info.stealing&&i.info.id!==t&&i.usage.tasks.queued<this.opts.tasksQueueOptions.size-1){const t=this.getWorkerInfo(e);if(null==t)throw new Error(`Worker node with key '${e.toString()}' not found in pool`);t.stealing=!0;const s=r.dequeueLastPrioritizedTask();this.handleTask(e,s),this.updateTaskStolenStatisticsWorkerUsage(e,s.name),t.stealing=!1}};setTasksQueuePriority(e){this.workerNodes[e].setTasksQueuePriority(this.getTasksQueuePriority())}workerMessageListener=e=>{this.checkMessageWorkerId(e);const{workerId:t,ready:r,taskId:s,taskFunctionsProperties:i}=e;if(null!=r&&null!=i)this.handleWorkerReadyResponse(e);else if(null!=i){const e=this.getWorkerNodeKeyByWorkerId(t),r=this.getWorkerInfo(e);null!=r&&(r.taskFunctionsProperties=i,this.sendStatisticsMessageToWorker(e),this.setTasksQueuePriority(e))}else null!=s&&this.handleTaskExecutionResponse(e)};checkAndEmitReadyEvent(){!this.readyEventEmitted&&this.ready&&(this.emitter?.emit(d.ready,this.info),this.readyEventEmitted=!0)}handleWorkerReadyResponse(e){const{workerId:t,ready:r,taskFunctionsProperties:s}=e;if(null==r||!r)throw new Error(`Worker ${t?.toString()} failed to initialize`);const i=this.getWorkerNodeKeyByWorkerId(t),o=this.workerNodes[i];o.info.ready=r,o.info.taskFunctionsProperties=s,this.sendStatisticsMessageToWorker(i),this.setTasksQueuePriority(i),this.checkAndEmitReadyEvent()}handleTaskExecutionResponse(e){const{workerId:t,taskId:r,workerError:s,data:i}=e,o=this.promiseResponseMap.get(r);if(null!=o){const{resolve:n,reject:a,workerNodeKey:u,asyncResource:h}=o,k=this.workerNodes[u];if(null!=s?(this.emitter?.emit(d.taskError,s),null!=h?h.runInAsyncScope(a,this.emitter,s.message):a(s.message)):null!=h?h.runInAsyncScope(n,this.emitter,i):n(i),h?.emitDestroy(),this.afterTaskExecutionHook(u,e),this.promiseResponseMap.delete(r),k?.emit("taskFinished",r),!0===this.opts.enableTasksQueue&&!this.destroying&&null!=k){const e=k.usage.tasks;this.tasksQueueSize(u)>0&&e.executing<this.opts.tasksQueueOptions.concurrency&&this.executeTask(u,this.dequeueTask(u)),0===e.executing&&0===this.tasksQueueSize(u)&&0===e.sequentiallyStolen&&k.emit("idle",{workerId:t,workerNodeKey:u})}}}checkAndEmitTaskExecutionEvents(){this.busy&&this.emitter?.emit(d.busy,this.info)}checkAndEmitTaskQueuingEvents(){this.hasBackPressure()&&this.emitter?.emit(d.backPressure,this.info)}getWorkerInfo(e){return this.workerNodes[e]?.info}getTasksQueuePriority(){return this.listTaskFunctionsProperties().some((e=>null!=e.priority))}createWorkerNode(){const e=new ue(this.worker,this.filePath,{env:this.opts.env,workerOptions:this.opts.workerOptions,tasksQueueBackPressureSize:this.opts.tasksQueueOptions?.size??F(this.maximumNumberOfWorkers??this.minimumNumberOfWorkers).size,tasksQueueBucketSize:2048,tasksQueuePriority:this.getTasksQueuePriority()});return this.starting&&(e.info.ready=!0),e}addWorkerNode(e){this.workerNodes.push(e);const t=this.workerNodes.indexOf(e);if(-1===t)throw new Error("Worker added not found in worker nodes");return t}checkAndEmitEmptyEvent(){this.empty&&(this.emitter?.emit(d.empty,this.info),this.readyEventEmitted=!1)}removeWorkerNode(e){const t=this.workerNodes.indexOf(e);-1!==t&&(this.workerNodes.splice(t,1),this.workerChoiceStrategiesContext?.remove(t)),this.checkAndEmitEmptyEvent()}flagWorkerNodeAsNotReady(e){const t=this.getWorkerInfo(e);null!=t&&(t.ready=!1)}hasBackPressure(){return!0===this.opts.enableTasksQueue&&-1===this.workerNodes.findIndex((e=>!e.hasBackPressure()))}executeTask(e,t){this.beforeTaskExecutionHook(e,t),this.sendToWorker(e,t,t.transferList),this.checkAndEmitTaskExecutionEvents()}enqueueTask(e,t){const r=this.workerNodes[e].enqueueTask(t);return this.checkAndEmitTaskQueuingEvents(),r}dequeueTask(e){return this.workerNodes[e].dequeueTask()}tasksQueueSize(e){return this.workerNodes[e].tasksQueueSize()}flushTasksQueue(e){let t=0;for(;this.tasksQueueSize(e)>0;)this.executeTask(e,this.dequeueTask(e)),++t;return this.workerNodes[e].clearTasksQueue(),t}flushTasksQueues(){for(const e of this.workerNodes.keys())this.flushTasksQueue(e)}}class ke extends he{constructor(e,t,r={},s){super(e,t,r,s)}setupHook(){e.setupPrimary({...this.opts.settings,exec:this.filePath})}isMain(){return e.isPrimary}sendToWorker(e,t){this.workerNodes[e]?.worker.send({...t,workerId:this.getWorkerInfo(e)?.id})}sendStartupMessageToWorker(e){this.sendToWorker(e,{ready:!1})}registerWorkerMessageListener(e,t){this.workerNodes[e].worker.on("message",t)}registerOnceWorkerMessageListener(e,t){this.workerNodes[e].worker.once("message",t)}deregisterWorkerMessageListener(e,t){this.workerNodes[e].worker.off("message",t)}shallCreateDynamicWorker(){return!1}checkAndEmitDynamicWorkerCreationEvents(){}get type(){return c.fixed}get worker(){return b.cluster}get busy(){return this.internalBusy()}}class ce extends he{constructor(e,t,r={},s){super(e,t,r,s)}isMain(){return s.isMainThread}sendToWorker(e,t,r){this.workerNodes[e]?.messageChannel?.port1.postMessage({...t,workerId:this.getWorkerInfo(e)?.id},r)}sendStartupMessageToWorker(e){const t=this.workerNodes[e],r=t.messageChannel.port2;t.worker.postMessage({ready:!1,workerId:this.getWorkerInfo(e)?.id,port:r},[r])}registerWorkerMessageListener(e,t){this.workerNodes[e].messageChannel?.port1.on("message",t)}registerOnceWorkerMessageListener(e,t){this.workerNodes[e].messageChannel?.port1.once("message",t)}deregisterWorkerMessageListener(e,t){this.workerNodes[e].messageChannel?.port1.off("message",t)}shallCreateDynamicWorker(){return!1}checkAndEmitDynamicWorkerCreationEvents(){}get type(){return c.fixed}get worker(){return b.thread}get busy(){return this.internalBusy()}}const de=(e,t)=>{if("string"!=typeof e)throw new TypeError("A taskFunctions parameter object key is not a string");if("string"==typeof e&&0===e.trim().length)throw new TypeError("A taskFunctions parameter object key is an empty string");if("function"!=typeof t.taskFunction)throw new TypeError(`taskFunction object 'taskFunction' property '${t.taskFunction}' is not a function`);R(t.priority),z(t.strategy)},le=e=>{if("string"!=typeof e)throw new TypeError("name parameter is not a string");if("string"==typeof e&&0===e.trim().length)throw new TypeError("name parameter is an empty string")},ge=6e4,me={killBehavior:V.SOFT,maxInactiveTime:ge,killHandler:g};class we{isMain;mainWorker;opts;taskFunctions;lastTaskTimestamp;statistics;activeInterval;constructor(e,t,r,s=me){if(this.isMain=e,this.mainWorker=t,this.opts=s,null==this.isMain)throw new Error("isMain parameter is mandatory");this.checkTaskFunctions(r),this.checkWorkerOptions(this.opts),this.isMain||this.getMainWorker().on("message",this.handleReadyMessage.bind(this))}checkWorkerOptions(e){(e=>{if(null!=e&&!y(e))throw new TypeError("opts worker options parameter is not a plain object");if(null!=e?.killBehavior&&!Object.values(V).includes(e.killBehavior))throw new TypeError(`killBehavior option '${e.killBehavior}' is not valid`);if(null!=e?.maxInactiveTime&&!Number.isSafeInteger(e.maxInactiveTime))throw new TypeError("maxInactiveTime option is not an integer");if(null!=e?.maxInactiveTime&&e.maxInactiveTime<5)throw new TypeError("maxInactiveTime option is not a positive integer greater or equal than 5");if(null!=e?.killHandler&&"function"!=typeof e.killHandler)throw new TypeError("killHandler option is not a function")})(e),this.opts={...me,...e}}checkTaskFunctions(e){if(null==e)throw new Error("taskFunctions parameter is mandatory");if(this.taskFunctions=new Map,"function"==typeof e){const t={taskFunction:e.bind(this)};this.taskFunctions.set(l,t),this.taskFunctions.set("string"==typeof e.name&&e.name.trim().length>0?e.name:"fn1",t)}else{if(!y(e))throw new TypeError("taskFunctions parameter is not a function or a plain object");{let t=!0;for(let[r,s]of Object.entries(e))"function"==typeof s&&(s={taskFunction:s}),de(r,s),s.taskFunction=s.taskFunction.bind(this),t&&(this.taskFunctions.set(l,s),t=!1),this.taskFunctions.set(r,s);if(t)throw new Error("taskFunctions parameter object is empty")}}}hasTaskFunction(e){try{le(e)}catch(e){return{status:!1,error:e}}return{status:this.taskFunctions.has(e)}}addTaskFunction(e,t){try{if(le(e),e===l)throw new Error("Cannot add a task function with the default reserved name");return"function"==typeof t&&(t={taskFunction:t}),de(e,t),t.taskFunction=t.taskFunction.bind(this),this.taskFunctions.get(e)===this.taskFunctions.get(l)&&this.taskFunctions.set(l,t),this.taskFunctions.set(e,t),this.sendTaskFunctionsPropertiesToMainWorker(),{status:!0}}catch(e){return{status:!1,error:e}}}removeTaskFunction(e){try{if(le(e),e===l)throw new Error("Cannot remove the task function with the default reserved name");if(this.taskFunctions.get(e)===this.taskFunctions.get(l))throw new Error("Cannot remove the task function used as the default task function");const t=this.taskFunctions.delete(e);return this.sendTaskFunctionsPropertiesToMainWorker(),{status:t}}catch(e){return{status:!1,error:e}}}listTaskFunctionsProperties(){let e=l;for(const[t,r]of this.taskFunctions)if(t!==l&&r===this.taskFunctions.get(l)){e=t;break}const t=[];for(const[r,s]of this.taskFunctions)r!==l&&r!==e&&t.push(x(r,s));return[x(l,this.taskFunctions.get(l)),x(e,this.taskFunctions.get(e)),...t]}setDefaultTaskFunction(e){try{if(le(e),e===l)throw new Error("Cannot set the default task function reserved name as the default task function");if(!this.taskFunctions.has(e))throw new Error("Cannot set the default task function to a non-existing task function");return this.taskFunctions.set(l,this.taskFunctions.get(e)),this.sendTaskFunctionsPropertiesToMainWorker(),{status:!0}}catch(e){return{status:!1,error:e}}}messageListener(e){this.checkMessageWorkerId(e);const{statistics:t,checkActive:r,taskFunctionOperation:s,taskId:i,data:o,kill:n}=e;null!=t?this.statistics=t:null!=r?r?this.startCheckActive():this.stopCheckActive():null!=s?this.handleTaskFunctionOperationMessage(e):null!=i&&null!=o?this.run(e):!0===n&&this.handleKillMessage(e)}handleTaskFunctionOperationMessage(e){const{taskFunctionOperation:t,taskFunctionProperties:r,taskFunction:s}=e;if(null==r)throw new Error("Cannot handle task function operation message without task function properties");let i;switch(t){case"add":i=this.addTaskFunction(r.name,{taskFunction:new Function(`return ${s}`)(),...null!=r.priority&&{priority:r.priority},...null!=r.strategy&&{strategy:r.strategy}});break;case"remove":i=this.removeTaskFunction(r.name);break;case"default":i=this.setDefaultTaskFunction(r.name);break;default:i={status:!1,error:new Error("Unknown task operation")}}const{status:o,error:n}=i;this.sendToMainWorker({taskFunctionOperation:t,taskFunctionOperationStatus:o,taskFunctionProperties:r,...!o&&null!=n&&{workerError:{name:r.name,message:this.handleError(n)}}})}handleKillMessage(e){if(this.stopCheckActive(),T(this.opts.killHandler))this.opts.killHandler().then((()=>{this.sendToMainWorker({kill:"success"})})).catch((()=>{this.sendToMainWorker({kill:"failure"})}));else try{this.opts.killHandler?.(),this.sendToMainWorker({kill:"success"})}catch{this.sendToMainWorker({kill:"failure"})}}checkMessageWorkerId(e){if(null==e.workerId)throw new Error("Message worker id is not set");if(e.workerId!==this.id)throw new Error(`Message worker id ${e.workerId.toString()} does not match the worker id ${this.id.toString()}`)}startCheckActive(){this.lastTaskTimestamp=u.performance.now(),this.activeInterval=setInterval(this.checkActive.bind(this),(this.opts.maxInactiveTime??ge)/2)}stopCheckActive(){null!=this.activeInterval&&(clearInterval(this.activeInterval),delete this.activeInterval)}checkActive(){u.performance.now()-this.lastTaskTimestamp>(this.opts.maxInactiveTime??ge)&&this.sendToMainWorker({kill:this.opts.killBehavior})}getMainWorker(){if(null==this.mainWorker)throw new Error("Main worker not set");return this.mainWorker}sendTaskFunctionsPropertiesToMainWorker(){this.sendToMainWorker({taskFunctionsProperties:this.listTaskFunctionsProperties()})}handleError(e){return e instanceof Error?e.message:e}run=e=>{const{name:t,taskId:r,data:s}=e,i=t??l;if(!this.taskFunctions.has(i))return void this.sendToMainWorker({workerError:{name:t,message:`Task function '${t}' not found`,data:s},taskId:r});const o=this.taskFunctions.get(i)?.taskFunction;T(o)?this.runAsync(o,e):this.runSync(o,e)};runSync=(e,t)=>{const{name:r,taskId:s,data:i}=t;try{let t=this.beginTaskPerformance(r);const o=e(i);t=this.endTaskPerformance(t),this.sendToMainWorker({data:o,taskPerformance:t,taskId:s})}catch(e){this.sendToMainWorker({workerError:{name:r,message:this.handleError(e),data:i},taskId:s})}finally{this.updateLastTaskTimestamp()}};runAsync=(e,t)=>{const{name:r,taskId:s,data:i}=t;let o=this.beginTaskPerformance(r);e(i).then((e=>{o=this.endTaskPerformance(o),this.sendToMainWorker({data:e,taskPerformance:o,taskId:s})})).catch((e=>{this.sendToMainWorker({workerError:{name:r,message:this.handleError(e),data:i},taskId:s})})).finally((()=>{this.updateLastTaskTimestamp()})).catch(g)};beginTaskPerformance(e){if(null==this.statistics)throw new Error("Performance statistics computation requirements not set");return{name:e??l,timestamp:u.performance.now(),...this.statistics.elu&&{elu:u.performance.eventLoopUtilization()}}}endTaskPerformance(e){if(null==this.statistics)throw new Error("Performance statistics computation requirements not set");return{...e,...this.statistics.runTime&&{runTime:u.performance.now()-e.timestamp},...this.statistics.elu&&{elu:u.performance.eventLoopUtilization(e.elu)}}}updateLastTaskTimestamp(){null!=this.activeInterval&&(this.lastTaskTimestamp=u.performance.now())}}exports.ClusterWorker=class extends we{constructor(t,r={}){super(e.isPrimary,e.worker,t,r)}handleReadyMessage(e){if(e.workerId===this.id&&!1===e.ready)try{this.getMainWorker().on("message",this.messageListener.bind(this)),this.sendToMainWorker({ready:!0,taskFunctionsProperties:this.listTaskFunctionsProperties()})}catch{this.sendToMainWorker({ready:!1,taskFunctionsProperties:this.listTaskFunctionsProperties()})}}get id(){return this.getMainWorker().id}sendToMainWorker=e=>{this.getMainWorker().send({...e,workerId:this.id})}},exports.DynamicClusterPool=class extends ke{constructor(e,t,r,s={}){super(e,r,s,t),O(this.minimumNumberOfWorkers,this.maximumNumberOfWorkers)}shallCreateDynamicWorker(){return!this.full&&this.internalBusy()||this.empty}checkAndEmitDynamicWorkerCreationEvents(){this.full&&this.emitter?.emit(d.full,this.info)}get type(){return c.dynamic}get busy(){return this.full&&this.internalBusy()}},exports.DynamicThreadPool=class extends ce{constructor(e,t,r,s={}){super(e,r,s,t),O(this.minimumNumberOfWorkers,this.maximumNumberOfWorkers)}shallCreateDynamicWorker(){return!this.full&&this.internalBusy()||this.empty}checkAndEmitDynamicWorkerCreationEvents(){this.full&&this.emitter?.emit(d.full,this.info)}get type(){return c.dynamic}get busy(){return this.full&&this.internalBusy()}},exports.FixedClusterPool=ke,exports.FixedThreadPool=ce,exports.KillBehaviors=V,exports.Measurements=v,exports.PoolEvents=d,exports.PoolTypes=c,exports.ThreadWorker=class extends we{port;constructor(e,t={}){super(s.isMainThread,s.parentPort,e,t)}handleReadyMessage(e){if(e.workerId===this.id&&!1===e.ready&&null!=e.port)try{this.port=e.port,this.port.on("message",this.messageListener.bind(this)),this.sendToMainWorker({ready:!0,taskFunctionsProperties:this.listTaskFunctionsProperties()})}catch{this.sendToMainWorker({ready:!1,taskFunctionsProperties:this.listTaskFunctionsProperties()})}}handleKillMessage(e){super.handleKillMessage(e),this.port?.unref(),this.port?.close()}get id(){return s.threadId}sendToMainWorker=e=>{this.port?.postMessage({...e,workerId:this.id})};handleError(e){return e}},exports.WorkerChoiceStrategies=E,exports.WorkerTypes=b,exports.availableParallelism=()=>{let e=1;try{e=k.availableParallelism()}catch{const t=k.cpus();Array.isArray(t)&&t.length>0&&(e=t.length)}return e};
2
2
  //# sourceMappingURL=index.cjs.map