@creejs/commons-lang 2.1.25 → 2.1.27

package/dist/cjs/index-dev.cjs

@@ -2045,11 +2045,15 @@ async function parallelAllSettled (tasks, maxParallel = 5) {
  * 2. Maybe multiple tasks are executed as a bulk block, and all of them resolved.
  *    * only the first fulfilled value is returned
  *    * other results are dropped
+ * 3. Notice:
+ *    * In Beginning, we start bulk(maxParallel) of tasks
+ *    * One task failed, it will start next task immediately, Not Wait for the bulk(maxParallel) to complete
  * @param {Array<Function|Promise<any>>} tasks - Array of async functions to execute
  * @param {number} [maxParallel=5] - Maximum number of tasks to run in parallel
+ * @param {string} [failureMessage] - Error message when all tasks failed
  * @returns {Promise<any>} Resolves with the result of the first successfully completed task
  */
-async function parallelAny (tasks, maxParallel = 5) {
+async function parallelAny (tasks, maxParallel = 5, failureMessage) {
   assertArray(tasks, 'tasks');
   assertNumber(maxParallel);
   if (tasks.length === 0) {
@@ -2082,28 +2086,29 @@ async function parallelAny (tasks, maxParallel = 5) {
       // @ts-ignore
       taskPromise = returnValuePromised(task);
     } else {
-      errors.push(new TypeError(`Invalid task: ${task}`));
-      takeTaskAndRun();
-      return
+      taskPromise = Promise.reject(new TypeError(`Invalid task: ${typeof task}, Only Promise or Function allowed`));
     }
+
     taskPromise.then(/** @type {any} */ rtnVal => {
-      deferred.resolve(rtnVal);
+      runningTasksCount--; // DO Not put in finally
+      // any task resolved,  whole parallelAny resolved
+      deferred.resolve(rtnVal); // This may be called many times: In worst case, "maxParallel" times
     }).catch(e => {
       errors.push(e);
       // No task left, and No successful execution, reject with errors
       if (errors.length >= tasks.length) {
         if (deferred.pending) {
-          deferred.reject(new AggregatedError('All Tasks Failed', errors));
+          deferred.reject(new AggregatedError(failureMessage ?? 'All Tasks Failed', errors));
           return
         }
       }
-      takeTaskAndRun();
-    }).finally(() => {
-      runningTasksCount--;
+      runningTasksCount--; // DO Not put in finally, must reduce before takeTaskAndRun()
+      takeTaskAndRun(); // start next task
     });
   }
-  // start tasks until maxParallel
-  while (runningTasksCount < maxParallel) {
+  // start tasks until maxParallel or no more task
+  const parallelCount = Math.min(tasks.length, maxParallel);
+  for (let i = 0; i < parallelCount; i++) {
     takeTaskAndRun();
   }
   return deferred.promise
@@ -2531,6 +2536,7 @@ const s2ns = 1_000_000_000;
 var TimeUtils = {
   s2ns,
   ms2ns,
+  timestamp,
   timestamp64,
   lapseNano,
   lapseMillis,
@@ -2539,8 +2545,9 @@ var TimeUtils = {
 };
 
 /**
- * Gets the current timestamp in nanoseconds (if running in Node.js) or milliseconds (in browser).
- * Uses `process.hrtime.bigint()` for high-resolution timestamps in Node.js, falls back to `Date.now()` in browsers.
+ * Gets the current timestamp in nanoseconds
+ * * If "performance" API is available, uses performance timeOrigin + now()
+ * * Else fall back to `Date.now()` to get milliseconds and convert to nanoseconds
  * @returns {bigint} Current timestamp as a BigInt
  */
 function timestamp64 () {
@@ -2555,6 +2562,24 @@ function timestamp64 () {
   return BigInt(Date.now() * ms2ns)
 }
 
+/**
+ * Gets the current timestamp in milliseconds
+ * * If "performance" API is available, uses performance timeOrigin + now(), then convert to milliseconds
+ * * Else fall back to `Date.now()`
+ * @returns {number} Current timestamp in milliseconds
+ */
+function timestamp () {
+  // sinon can not fake performance.timeOrigin, so we have to check it
+  if (typeof performance !== 'undefined' && typeof performance.timeOrigin === 'number') {
+    // timeOrigin specifies the high resolution millisecond timestamp, eg. 1756350801931.159
+    const base = performance.timeOrigin;
+    // the current high resolution millisecond timestamp, eg.31767926.416357
+    const now = performance.now();
+    return Math.ceil((base + now) / ms2ns)
+  }
+  return Date.now()
+}
+
 /**
  * Calculates the time elapsed in nanoseconds between the given timestamp and now.
  * @param {bigint} start - start timestamp64, in nanoseconds.