@dereekb/util 10.0.9 → 10.0.11

package/fetch/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [10.0.11](https://github.com/dereekb/dbx-components/compare/v10.0.10-dev...v10.0.11) (2024-01-25)
+
+
+
+## [10.0.10](https://github.com/dereekb/dbx-components/compare/v10.0.9-dev...v10.0.10) (2024-01-21)
+
+
+
 ## [10.0.9](https://github.com/dereekb/dbx-components/compare/v10.0.8-dev...v10.0.9) (2024-01-15)
 
 

package/fetch/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util/fetch",
-  "version": "10.0.9",
+  "version": "10.0.11",
   "type": "commonjs",
   "peerDependencies": {
     "@dereekb/util": "*"

package/index.cjs.js

@@ -2213,6 +2213,49 @@ function filterFromIterable(values, fn) {
   }
   return keep;
 }
+/**
+ * Wraps the input tuple values as an array. The tuples should all be the same length in order to wrap them properly, and the tuple value cannot consist of only arrays of the same length.
+ *
+ * This is used to prevent functions from treating the tuple itself as an array.
+ *
+ * @param input
+ */
+function wrapTuples(input) {
+  if (Array.isArray(input)) {
+    // check if the first item is an array. Tuples can contain arrays as the first value.
+    if (input.length > 0) {
+      const firstValueInPotentialTupleOrArray = input[0];
+      let inputIsSingleTuple = false;
+      if (Array.isArray(firstValueInPotentialTupleOrArray)) {
+        // if the first nested value is an array then the top-level value may be an array and not a tuple. Check the length of all the other values in the array to see if they have the same length.
+        const expectedLength = firstValueInPotentialTupleOrArray.length;
+        // if it is an array of tuples, all values should be the same length and be arrays. If not an array, then we're looking at a tuple.
+        const firstNonUniformTupleValueIndex = input.findIndex(x => {
+          if (Array.isArray(x)) {
+            return x.length !== expectedLength;
+          } else {
+            return true; // non-array value. The input is a tuple.
+          }
+        });
+
+        inputIsSingleTuple = firstNonUniformTupleValueIndex !== -1;
+      } else {
+        inputIsSingleTuple = true;
+        return [input];
+      }
+      // first value of the tuple could also be an array. If it is, check the other tuples all have the same length.
+      if (inputIsSingleTuple) {
+        return [input];
+      } else {
+        return input;
+      }
+    } else {
+      return input; // is an empty array.
+    }
+  } else {
+    throw new Error('Input is not an array/tuple...');
+  }
+}
 
 /**
  * Creates a ReadKeysFromFunction using a ReadKeyFunction.
@@ -3880,19 +3923,6 @@ function makeValuesGroupMap(values, groupKeyFn) {
   return map;
 }
 
-/**
- * map utility function for an iterable that maps and places the results into an array.
- *
- * @param values
- * @param fn
- * @returns
- */
-function mapIterable(values, fn) {
-  const mapping = [];
-  forEachInIterable(values, value => mapping.push(fn(value)));
-  return mapping;
-}
-
 /**
  *
  * @param maps
@@ -4013,20 +4043,29 @@ function readMultipleKeysToMap(values, read) {
  */
 function multiValueMapBuilder() {
   const map = new Map();
+  const add = (key, value) => {
+    let array = map.get(key);
+    if (array == null) {
+      array = [];
+      map.set(key, array);
+    }
+    useIterableOrValue(value, x => array.push(x));
+  };
   const builder = {
     map: () => map,
     entries: () => mapToTuples(map),
     tuples: () => expandArrayMapTuples(map),
     delete: key => {
-      map.delete(key);
+      return map.delete(key);
     },
-    add: (key, value) => {
-      let array = map.get(key);
-      if (array == null) {
-        array = [];
-        map.set(key, array);
-      }
-      useIterableOrValue(value, x => array.push(x));
+    add,
+    addTuples: (key, value) => add(key, wrapTuples(value)),
+    has: key => {
+      return map.has(key);
+    },
+    get: key => {
+      var _a;
+      return (_a = map.get(key)) !== null && _a !== void 0 ? _a : [];
     }
   };
   return builder;
@@ -4996,6 +5035,11 @@ function sortByNumberFunction(readNumberFn) {
 }
 const sortNumbersAscendingFunction = sortByNumberFunction(a => a);
 
+function transformNumberFunctionConfig(config) {
+  return config ? typeof config === 'function' ? {
+    transform: config
+  } : config : undefined;
+}
 function transformNumberFunction(config) {
   const transformFunctions = [config.transform];
   if (config.roundToStep) {
@@ -6586,6 +6630,19 @@ function repeatString(string, reapeat) {
   return result;
 }
 
+/**
+ * map utility function for an iterable that maps and places the results into an array.
+ *
+ * @param values
+ * @param fn
+ * @returns
+ */
+function mapIterable(values, fn) {
+  const mapping = [];
+  forEachInIterable(values, value => mapping.push(fn(value)));
+  return mapping;
+}
+
 var isRegExp$1 = isRegexp;
 
 var $TypeError$5 = TypeError;
@@ -6685,6 +6742,11 @@ function stringToUppercaseFunction(input) {
 function stringToLowercaseFunction(input) {
   return input.toLowerCase();
 }
+function transformStringFunctionConfig(config) {
+  return config ? typeof config === 'function' ? {
+    transform: config
+  } : config : undefined;
+}
 function transformStringFunction(config) {
   let baseTransform;
   if (config.transform) {
@@ -12058,6 +12120,17 @@ function mapPromiseOrValue(input, mapFn) {
   }
 }
 
+/**
+ * Wraps another factory with a ToStringFactory function to generate strings from the original factory.
+ *
+ * @param factory
+ * @param toStringFunction
+ * @returns
+ */
+function stringFactoryFromFactory(factory, toStringFunction) {
+  return () => toStringFunction(factory());
+}
+
 /**
  * Runs the task using the input config, and returns the value. Is always configured to throw the error if it fails.
  */
@@ -12099,10 +12172,12 @@ function performAsyncTasks(input, taskFn, config = {
     const {
       sequential,
       maxParallelTasks,
-      waitBetweenTasks
+      waitBetweenTasks,
+      nonConcurrentTaskKeyFactory
     } = config;
     const taskResults = [];
     yield performTasksInParallelFunction({
+      nonConcurrentTaskKeyFactory,
       taskFactory: (value, i) => _performAsyncTask(value, taskFn, config).then(x => {
         taskResults[i] = x;
       }),
@@ -12209,17 +12284,19 @@ function performTasksInParallel(input, config) {
  * @param config
  */
 function performTasksInParallelFunction(config) {
+  const defaultNonConcurrentTaskKeyFactory = stringFactoryFromFactory(incrementingNumberFactory(), x => x.toString());
   const {
     taskFactory,
     sequential,
+    nonConcurrentTaskKeyFactory,
     maxParallelTasks: inputMaxParallelTasks,
     waitBetweenTasks
   } = config;
   const maxParallelTasks = inputMaxParallelTasks !== null && inputMaxParallelTasks !== void 0 ? inputMaxParallelTasks : sequential ? 1 : undefined;
-  if (!maxParallelTasks) {
-    // if the max number of parallel tasks is not defined, then run all tasks at once
+  if (!maxParallelTasks && !nonConcurrentTaskKeyFactory) {
+    // if the max number of parallel tasks is not defined, then run all tasks at once, unless there is a nonConcurrentTaskKeyFactory
     return input => __awaiter(this, void 0, void 0, function* () {
-      yield Promise.all(input.map((value, i) => taskFactory(value, i)));
+      yield Promise.all(input.map((value, i) => taskFactory(value, i, defaultNonConcurrentTaskKeyFactory())));
     });
   } else {
     return input => {
@@ -12227,29 +12304,99 @@ function performTasksInParallelFunction(config) {
         return Promise.resolve();
       }
       return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
-        const maxPromisesToRunAtOneTime = Math.min(maxParallelTasks, input.length);
-        const endIndex = input.length;
-        let i = 0;
+        const taskKeyFactory = nonConcurrentTaskKeyFactory !== null && nonConcurrentTaskKeyFactory !== void 0 ? nonConcurrentTaskKeyFactory : defaultNonConcurrentTaskKeyFactory;
+        const maxPromisesToRunAtOneTime = Math.min(maxParallelTasks !== null && maxParallelTasks !== void 0 ? maxParallelTasks : 100, input.length);
+        const incompleteTasks = input.map((x, i) => [x, asArray(taskKeyFactory(x)), i]).reverse(); // reverse to use push/pop
+        let currentRunIndex = 0;
         let finishedParallels = 0;
         let hasEncounteredFailure = false;
+        /**
+         * Set of tasks keys that are currently running.
+         */
+        const currentParellelTaskKeys = new Set();
+        const visitedTaskIndexes = new Set();
+        const waitingConcurrentTasks = multiValueMapBuilder();
+        function getNextTask() {
+          let nextTask = undefined;
+          while (!nextTask) {
+            nextTask = incompleteTasks.pop();
+            if (nextTask != null) {
+              const nextTaskTuple = nextTask;
+              const nextTaskTupleIndex = nextTaskTuple[2];
+              if (visitedTaskIndexes.has(nextTaskTupleIndex)) {
+                // already run. Ignore.
+                nextTask = undefined;
+              } else {
+                const keys = nextTaskTuple[1];
+                const keyOfTaskCurrentlyInUse = setContainsAnyValue(currentParellelTaskKeys, keys);
+                if (keyOfTaskCurrentlyInUse) {
+                  keys.forEach(key => waitingConcurrentTasks.addTuples(key, nextTaskTuple)); // add to each key as waiting
+                  nextTask = undefined; // clear to continue loop
+                } else {
+                  addToSet(currentParellelTaskKeys, keys); // add to the current task keys, exit loop
+                  break;
+                }
+              }
+            } else {
+              break; // no tasks remaining, break.
+            }
+          }
+
+          if (nextTask) {
+            // mark to prevent running again/concurrent runs
+            visitedTaskIndexes.add(nextTask[2]);
+          }
+          return nextTask;
+        }
+        function onTaskCompleted(task) {
+          const keys = task[1];
+          const indexesPushed = new Set();
+          keys.forEach(key => {
+            // un-reserve the key from each parallel task
+            currentParellelTaskKeys.delete(key);
+            const waitingForKey = waitingConcurrentTasks.get(key);
+            while (true) {
+              const nextWaitingTask = waitingForKey.shift(); // take from the front to retain unique task order
+              if (nextWaitingTask) {
+                const nextWaitingTaskIndex = nextWaitingTask[2];
+                if (visitedTaskIndexes.has(nextWaitingTaskIndex) || indexesPushed.has(nextWaitingTaskIndex)) {
+                  // if the task has already been visited, then don't push back onto incomplete tasks.
+                  continue;
+                } else {
+                  // push to front for the next dispatch to take for this key
+                  incompleteTasks.push(nextWaitingTask);
+                  // mark to prevent pushing this one again since it will not get run
+                  indexesPushed.add(nextWaitingTaskIndex);
+                  break;
+                }
+              } else {
+                break;
+              }
+            }
+          });
+        }
         // start initial promises
         function dispatchNextPromise() {
-          const hasNext = i < endIndex;
-          if (hasNext && !hasEncounteredFailure) {
-            const value = input[i];
-            const promise = taskFactory(value, i);
-            i += 1;
-            promise.then(() => {
-              setTimeout(dispatchNextPromise, waitBetweenTasks);
-            }, e => {
-              hasEncounteredFailure = true;
-              reject(e);
-            });
-          } else if (!hasNext) {
-            finishedParallels += 1;
-            // only resolve after the last parallel is complete
-            if (finishedParallels === maxPromisesToRunAtOneTime) {
-              resolve();
+          // if a failure has been encountered then the promise has already been rejected.
+          if (!hasEncounteredFailure) {
+            const nextTask = getNextTask();
+            if (nextTask) {
+              // build/start promise
+              const promise = taskFactory(nextTask[0], currentRunIndex, nextTask[1]);
+              currentRunIndex += 1;
+              promise.then(() => {
+                onTaskCompleted(nextTask);
+                setTimeout(dispatchNextPromise, waitBetweenTasks);
+              }, e => {
+                hasEncounteredFailure = true;
+                reject(e);
+              });
+            } else {
+              finishedParallels += 1;
+              // only resolve after the last parallel is complete
+              if (finishedParallels === maxPromisesToRunAtOneTime) {
+                resolve();
+              }
             }
           }
         }
@@ -14310,6 +14457,7 @@ exports.splitStringAtFirstCharacterOccurenceFunction = splitStringAtFirstCharact
 exports.splitStringAtIndex = splitStringAtIndex;
 exports.stepsFromIndex = stepsFromIndex;
 exports.stepsFromIndexFunction = stepsFromIndexFunction;
+exports.stringFactoryFromFactory = stringFactoryFromFactory;
 exports.stringToLowercaseFunction = stringToLowercaseFunction;
 exports.stringToUppercaseFunction = stringToUppercaseFunction;
 exports.stringTrimFunction = stringTrimFunction;
@@ -14333,7 +14481,9 @@ exports.toRelativeSlashPathStartType = toRelativeSlashPathStartType;
 exports.toggleInSet = toggleInSet;
 exports.toggleInSetCopy = toggleInSetCopy;
 exports.transformNumberFunction = transformNumberFunction;
+exports.transformNumberFunctionConfig = transformNumberFunctionConfig;
 exports.transformStringFunction = transformStringFunction;
+exports.transformStringFunctionConfig = transformStringFunctionConfig;
 exports.transformStrings = transformStrings;
 exports.trimArray = trimArray;
 exports.typedServiceRegistry = typedServiceRegistry;
@@ -14371,5 +14521,6 @@ exports.wrapLatLngPoint = wrapLatLngPoint;
 exports.wrapLngValue = wrapLngValue;
 exports.wrapMapFunctionOutput = wrapMapFunctionOutput;
 exports.wrapNumberFunction = wrapNumberFunction;
+exports.wrapTuples = wrapTuples;
 exports.wrapUseAsyncFunction = wrapUseAsyncFunction;
 exports.wrapUseFunction = wrapUseFunction;

package/index.esm.js

@@ -2244,6 +2244,52 @@ function filterFromIterable(values, fn) {
   return keep;
 }
 
+/**
+ * Wraps the input tuple values as an array. The tuples should all be the same length in order to wrap them properly, and the tuple value cannot consist of only arrays of the same length.
+ *
+ * This is used to prevent functions from treating the tuple itself as an array.
+ *
+ * @param input
+ */
+function wrapTuples(input) {
+  if (Array.isArray(input)) {
+    // check if the first item is an array. Tuples can contain arrays as the first value.
+    if (input.length > 0) {
+      const firstValueInPotentialTupleOrArray = input[0];
+      let inputIsSingleTuple = false;
+      if (Array.isArray(firstValueInPotentialTupleOrArray)) {
+        // if the first nested value is an array then the top-level value may be an array and not a tuple. Check the length of all the other values in the array to see if they have the same length.
+        const expectedLength = firstValueInPotentialTupleOrArray.length;
+
+        // if it is an array of tuples, all values should be the same length and be arrays. If not an array, then we're looking at a tuple.
+        const firstNonUniformTupleValueIndex = input.findIndex(x => {
+          if (Array.isArray(x)) {
+            return x.length !== expectedLength;
+          } else {
+            return true; // non-array value. The input is a tuple.
+          }
+        });
+
+        inputIsSingleTuple = firstNonUniformTupleValueIndex !== -1;
+      } else {
+        inputIsSingleTuple = true;
+        return [input];
+      }
+
+      // first value of the tuple could also be an array. If it is, check the other tuples all have the same length.
+      if (inputIsSingleTuple) {
+        return [input];
+      } else {
+        return input;
+      }
+    } else {
+      return input; // is an empty array.
+    }
+  } else {
+    throw new Error('Input is not an array/tuple...');
+  }
+}
+
 /**
  * A key made up of either a string or number value.
  */
@@ -2256,6 +2302,10 @@ function filterFromIterable(values, fn) {
  * Reads a key from the input object.
  */
 
+/**
+ * Reads one or more keys from the input object.
+ */
+
 /**
  * Reads multiple keys from the input object.
  */
@@ -4212,19 +4262,6 @@ function makeValuesGroupMap(values, groupKeyFn) {
   return map;
 }
 
-/**
- * map utility function for an iterable that maps and places the results into an array.
- *
- * @param values
- * @param fn
- * @returns
- */
-function mapIterable(values, fn) {
-  const mapping = [];
-  forEachInIterable(values, value => mapping.push(fn(value)));
-  return mapping;
-}
-
 /**
  *
  * @param maps
@@ -4365,20 +4402,29 @@ function readMultipleKeysToMap(values, read) {
  */
 function multiValueMapBuilder() {
   const map = new Map();
+  const add = (key, value) => {
+    let array = map.get(key);
+    if (array == null) {
+      array = [];
+      map.set(key, array);
+    }
+    useIterableOrValue(value, x => array.push(x));
+  };
   const builder = {
     map: () => map,
     entries: () => mapToTuples(map),
     tuples: () => expandArrayMapTuples(map),
     delete: key => {
-      map.delete(key);
+      return map.delete(key);
     },
-    add: (key, value) => {
-      let array = map.get(key);
-      if (array == null) {
-        array = [];
-        map.set(key, array);
-      }
-      useIterableOrValue(value, x => array.push(x));
+    add,
+    addTuples: (key, value) => add(key, wrapTuples(value)),
+    has: key => {
+      return map.has(key);
+    },
+    get: key => {
+      var _map$get;
+      return (_map$get = map.get(key)) != null ? _map$get : [];
     }
   };
   return builder;
@@ -5707,6 +5753,11 @@ function sortByNumberFunction(readNumberFn) {
 }
 const sortNumbersAscendingFunction = sortByNumberFunction(a => a);
 
+function transformNumberFunctionConfig(config) {
+  return config ? typeof config === 'function' ? {
+    transform: config
+  } : config : undefined;
+}
 function transformNumberFunction(config) {
   const transformFunctions = [config.transform];
   if (config.roundToStep) {
@@ -7521,6 +7572,19 @@ function repeatString(string, reapeat) {
   return result;
 }
 
+/**
+ * map utility function for an iterable that maps and places the results into an array.
+ *
+ * @param values
+ * @param fn
+ * @returns
+ */
+function mapIterable(values, fn) {
+  const mapping = [];
+  forEachInIterable(values, value => mapping.push(fn(value)));
+  return mapping;
+}
+
 var isRegExp$1 = isRegexp;
 
 var $TypeError$5 = TypeError;
@@ -7620,6 +7684,11 @@ function stringToUppercaseFunction(input) {
 function stringToLowercaseFunction(input) {
   return input.toLowerCase();
 }
+function transformStringFunctionConfig(config) {
+  return config ? typeof config === 'function' ? {
+    transform: config
+  } : config : undefined;
+}
 function transformStringFunction(config) {
   let baseTransform;
   if (config.transform) {
@@ -13854,6 +13923,17 @@ function mapPromiseOrValue(input, mapFn) {
   }
 }
 
+/**
+ * Wraps another factory with a ToStringFactory function to generate strings from the original factory.
+ *
+ * @param factory
+ * @param toStringFunction
+ * @returns
+ */
+function stringFactoryFromFactory(factory, toStringFunction) {
+  return () => toStringFunction(factory());
+}
+
 /**
  * Runs the task using the input config, and returns the value. Is always configured to throw the error if it fails.
  */
@@ -13894,10 +13974,12 @@ async function performAsyncTasks(input, taskFn, config = {
   const {
     sequential,
     maxParallelTasks,
-    waitBetweenTasks
+    waitBetweenTasks,
+    nonConcurrentTaskKeyFactory
   } = config;
   const taskResults = [];
   await performTasksInParallelFunction({
+    nonConcurrentTaskKeyFactory,
     taskFactory: (value, i) => _performAsyncTask(value, taskFn, config).then(x => {
       taskResults[i] = x;
     }),
@@ -13979,6 +14061,9 @@ async function _performAsyncTask(value, taskFn, config = {}) {
 }
 
 // MARK: Parallel
+/**
+ * Used as a key to identify the "group" that a task belongs to to prevent other concurrent tasks from that group from running in parallel when parallel execution is desired.
+ */
 
 /**
  * Function that awaits a promise generate from each of the input values.
@@ -14003,17 +14088,19 @@ function performTasksInParallel(input, config) {
  * @param config
  */
 function performTasksInParallelFunction(config) {
+  const defaultNonConcurrentTaskKeyFactory = stringFactoryFromFactory(incrementingNumberFactory(), x => x.toString());
   const {
     taskFactory,
     sequential,
+    nonConcurrentTaskKeyFactory,
     maxParallelTasks: inputMaxParallelTasks,
     waitBetweenTasks
   } = config;
   const maxParallelTasks = inputMaxParallelTasks != null ? inputMaxParallelTasks : sequential ? 1 : undefined;
-  if (!maxParallelTasks) {
-    // if the max number of parallel tasks is not defined, then run all tasks at once
+  if (!maxParallelTasks && !nonConcurrentTaskKeyFactory) {
+    // if the max number of parallel tasks is not defined, then run all tasks at once, unless there is a nonConcurrentTaskKeyFactory
     return async input => {
-      await Promise.all(input.map((value, i) => taskFactory(value, i)));
+      await Promise.all(input.map((value, i) => taskFactory(value, i, defaultNonConcurrentTaskKeyFactory())));
     };
   } else {
     return input => {
@@ -14021,31 +14108,104 @@ function performTasksInParallelFunction(config) {
         return Promise.resolve();
       }
       return new Promise(async (resolve, reject) => {
-        const maxPromisesToRunAtOneTime = Math.min(maxParallelTasks, input.length);
-        const endIndex = input.length;
-        let i = 0;
+        const taskKeyFactory = nonConcurrentTaskKeyFactory != null ? nonConcurrentTaskKeyFactory : defaultNonConcurrentTaskKeyFactory;
+        const maxPromisesToRunAtOneTime = Math.min(maxParallelTasks != null ? maxParallelTasks : 100, input.length);
+        const incompleteTasks = input.map((x, i) => [x, asArray(taskKeyFactory(x)), i]).reverse(); // reverse to use push/pop
+
+        let currentRunIndex = 0;
         let finishedParallels = 0;
         let hasEncounteredFailure = false;
 
+        /**
+         * Set of tasks keys that are currently running.
+         */
+        const currentParellelTaskKeys = new Set();
+        const visitedTaskIndexes = new Set();
+        const waitingConcurrentTasks = multiValueMapBuilder();
+        function getNextTask() {
+          let nextTask = undefined;
+          while (!nextTask) {
+            nextTask = incompleteTasks.pop();
+            if (nextTask != null) {
+              const nextTaskTuple = nextTask;
+              const nextTaskTupleIndex = nextTaskTuple[2];
+              if (visitedTaskIndexes.has(nextTaskTupleIndex)) {
+                // already run. Ignore.
+                nextTask = undefined;
+              } else {
+                const keys = nextTaskTuple[1];
+                const keyOfTaskCurrentlyInUse = setContainsAnyValue(currentParellelTaskKeys, keys);
+                if (keyOfTaskCurrentlyInUse) {
+                  keys.forEach(key => waitingConcurrentTasks.addTuples(key, nextTaskTuple)); // add to each key as waiting
+                  nextTask = undefined; // clear to continue loop
+                } else {
+                  addToSet(currentParellelTaskKeys, keys); // add to the current task keys, exit loop
+                  break;
+                }
+              }
+            } else {
+              break; // no tasks remaining, break.
+            }
+          }
+
+          if (nextTask) {
+            // mark to prevent running again/concurrent runs
+            visitedTaskIndexes.add(nextTask[2]);
+          }
+          return nextTask;
+        }
+        function onTaskCompleted(task) {
+          const keys = task[1];
+          const indexesPushed = new Set();
+          keys.forEach(key => {
+            // un-reserve the key from each parallel task
+            currentParellelTaskKeys.delete(key);
+            const waitingForKey = waitingConcurrentTasks.get(key);
+            while (true) {
+              const nextWaitingTask = waitingForKey.shift(); // take from the front to retain unique task order
+
+              if (nextWaitingTask) {
+                const nextWaitingTaskIndex = nextWaitingTask[2];
+                if (visitedTaskIndexes.has(nextWaitingTaskIndex) || indexesPushed.has(nextWaitingTaskIndex)) {
+                  // if the task has already been visited, then don't push back onto incomplete tasks.
+                  continue;
+                } else {
+                  // push to front for the next dispatch to take for this key
+                  incompleteTasks.push(nextWaitingTask);
+                  // mark to prevent pushing this one again since it will not get run
+                  indexesPushed.add(nextWaitingTaskIndex);
+                  break;
+                }
+              } else {
+                break;
+              }
+            }
+          });
+        }
+
         // start initial promises
         function dispatchNextPromise() {
-          const hasNext = i < endIndex;
-          if (hasNext && !hasEncounteredFailure) {
-            const value = input[i];
-            const promise = taskFactory(value, i);
-            i += 1;
-            promise.then(() => {
-              setTimeout(dispatchNextPromise, waitBetweenTasks);
-            }, e => {
-              hasEncounteredFailure = true;
-              reject(e);
-            });
-          } else if (!hasNext) {
-            finishedParallels += 1;
-
-            // only resolve after the last parallel is complete
-            if (finishedParallels === maxPromisesToRunAtOneTime) {
-              resolve();
+          // if a failure has been encountered then the promise has already been rejected.
+          if (!hasEncounteredFailure) {
+            const nextTask = getNextTask();
+            if (nextTask) {
+              // build/start promise
+              const promise = taskFactory(nextTask[0], currentRunIndex, nextTask[1]);
+              currentRunIndex += 1;
+              promise.then(() => {
+                onTaskCompleted(nextTask);
+                setTimeout(dispatchNextPromise, waitBetweenTasks);
+              }, e => {
+                hasEncounteredFailure = true;
+                reject(e);
+              });
+            } else {
+              finishedParallels += 1;
+
+              // only resolve after the last parallel is complete
+              if (finishedParallels === maxPromisesToRunAtOneTime) {
+                resolve();
+              }
             }
           }
         }
@@ -15740,4 +15900,4 @@ async function iterateFilteredPages(inputPage, loadFn, iterFn) {
   return count;
 }
 
-export { ALL_DOUBLE_SLASHES_REGEX, ALL_SLASHES_REGEX, ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX, ASSERTION_ERROR_CODE, ASSERTION_HANDLER, AUTH_ADMIN_ROLE, AUTH_ONBOARDED_ROLE, AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE, AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE, AUTH_TOS_SIGNED_ROLE, AUTH_USER_ROLE, AbstractUniqueModel, Assert, AssertMax, AssertMin, AssertionError, AssertionIssueHandler, BooleanKeyArrayUtilityInstance, BooleanStringKeyArrayUtilityInstance, CATCH_ALL_HANDLE_RESULT_KEY, CUT_VALUE_TO_ZERO_PRECISION, DATE_NOW_VALUE, DEFAULT_LAT_LNG_STRING_VALUE, DEFAULT_RANDOM_EMAIL_FACTORY_CONFIG, DEFAULT_RANDOM_PHONE_NUMBER_FACTORY_CONFIG, DEFAULT_READABLE_ERROR_CODE, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT, DEFAULT_UNKNOWN_MODEL_TYPE_STRING, DOLLAR_AMOUNT_PRECISION, DOLLAR_AMOUNT_STRING_REGEX, DataDoesNotExistError, DataIsExpiredError, Day, DestroyFunctionObject, E164PHONE_NUMBER_REGEX, E164PHONE_NUMBER_WITH_EXTENSION_REGEX, E164PHONE_NUMBER_WITH_OPTIONAL_EXTENSION_REGEX, FINAL_PAGE, FIRST_PAGE, FRACTIONAL_HOURS_PRECISION_FUNCTION, FullStorageObject, HAS_WEBSITE_DOMAIN_NAME_REGEX, HOURS_IN_DAY, HTTP_OR_HTTPS_REGEX, HashSet, ISO8601_DAY_STRING_REGEX, ISO8601_DAY_STRING_START_REGEX, ISO_8601_DATE_STRING_REGEX, KeyValueTypleValueFilter, LAT_LNG_PATTERN, LAT_LNG_PATTERN_MAX_PRECISION, LAT_LONG_100KM_PRECISION, LAT_LONG_100M_PRECISION, LAT_LONG_10CM_PRECISION, LAT_LONG_10KM_PRECISION, LAT_LONG_10M_PRECISION, LAT_LONG_1CM_PRECISION, LAT_LONG_1KM_PRECISION, LAT_LONG_1MM_PRECISION, LAT_LONG_1M_PRECISION, LAT_LONG_GRAINS_OF_SAND_PRECISION, LEADING_SLASHES_REGEX, MAP_IDENTITY, MAX_BITWISE_SET_SIZE, MAX_LATITUDE_VALUE, MAX_LONGITUDE_VALUE, MINUTES_IN_DAY, MINUTES_IN_HOUR, MIN_LATITUDE_VALUE, MIN_LONGITUDE_VALUE, MONTH_DAY_SLASH_DATE_STRING_REGEX, MS_IN_DAY, MS_IN_HOUR, MS_IN_MINUTE, MS_IN_SECOND, MemoryStorageInstance, ModelRelationUtility, NOOP_MODIFIER, PHONE_EXTENSION_NUMBER_REGEX, PRIMATIVE_KEY_DENCODER_VALUE, PageCalculator, PropertyDescriptorUtility, REGEX_SPECIAL_CHARACTERS, REGEX_SPECIAL_CHARACTERS_SET, RelationChange, SECONDS_IN_MINUTE, SHARED_MEMORY_STORAGE, SLASH_PATH_FILE_TYPE_SEPARATOR, SLASH_PATH_SEPARATOR, SORT_VALUE_EQUAL, SORT_VALUE_GREATER_THAN, SORT_VALUE_LESS_THAN, ServerErrorResponse, SetDeltaChange, SimpleStorageObject, StorageObject, StorageObjectUtility, StoredDataError, SyncState, TOTAL_LATITUDE_RANGE, TOTAL_LONGITUDE_RANGE, TOTAL_SPAN_OF_LONGITUDE, TRAILING_FILE_TYPE_SEPARATORS_REGEX, TRAILING_SLASHES_REGEX, TimeAM, TypedServiceRegistryInstance, UNLOADED_PAGE, US_STATE_CODE_STRING_REGEX, UTC_DATE_STRING_REGEX, UTC_TIMEZONE_STRING, UTF_8_START_CHARACTER, UTF_PRIVATE_USAGE_AREA_START, UnauthorizedServerErrorResponse, WEB_PROTOCOL_PREFIX_REGEX, ZIP_CODE_STRING_REGEX, addHttpToUrl, addLatLngPoints, addModifiers, addPlusPrefixToNumber, addPrefix, addPrefixFunction, addSuffix, addSuffixFunction, addToSet, addToSetCopy, allFalsyOrEmptyKeys, allIndexesInIndexRange, allKeyValueTuples, allMaybeSoKeys, allNonUndefinedKeys, allObjectsAreEqual, allValuesAreMaybeNot, allValuesAreNotMaybe, applyBestFit, applyToMultipleFields, areEqualContext, areEqualPOJOValues, arrayContainsDuplicateValue, arrayContentsDiffer, arrayDecision, arrayDecisionFunction, arrayFactory, arrayInputFactory, arrayToLowercase, arrayToMap, arrayToObject, arrayToUppercase, asArray, asDecisionFunction, asGetter, asIndexRangeCheckFunctionConfig, asIterable, asNumber, asObjectCopyFactory, asPromise, asSet, assignValuesToPOJO, assignValuesToPOJOFunction, authClaims, authRoleClaimsService, authRolesSetHasRoles, baseWebsiteUrl, batch, batchCalc, bitwiseObjectDencoder, bitwiseObjectEncoder, bitwiseObjectdecoder, bitwiseSetDecoder, bitwiseSetDencoder, booleanFactory, boundNumber, boundNumberFunction, boundToRectangle, build, cachedGetter, capLatValue, capitalizeFirstLetter, caseInsensitiveFilterByIndexOfDecisionFactory, caseInsensitiveString, catchAllHandlerKey, chainMapFunction, chainMapSameFunctions, coerceToEmailParticipants, combineMaps, compareEqualityWithValueFromItemsFunction, compareEqualityWithValueFromItemsFunctionFactory, compareFnOrder, computeNextFractionalHour, computeNextFreeIndexFunction, concatArrays, concatArraysUnique, containsAllStringsAnyCase, containsAllValues, containsAnyStringAnyCase, containsAnyValue, containsAnyValueFromSet, containsNoValueFromSet, containsNoneOfValue, containsStringAnyCase, convertEmailParticipantStringToParticipant, convertMaybeToArray, convertParticipantToEmailParticipantString, convertToArray, copyArray, copyField, copyLatLngBound, copyLatLngPoint, copyObject, copySetAndDo, countPOJOKeys, countPOJOKeysFunction, cronExpressionRepeatingEveryNMinutes, cssClassesSet, cutToPrecision, cutValueToInteger, cutValueToPrecision, cutValueToPrecisionFunction, dateFromLogicalDate, dayOfWeek, daysOfWeekArray, daysOfWeekFromEnabledDays, daysOfWeekNameFunction, daysOfWeekNameMap, decisionFunction, decodeHashedValues, decodeHashedValuesWithDecodeMap, decodeModelKeyTypePair, defaultFilterFromPOJOFunctionNoCopy, defaultForwardFunctionFactory, defaultLatLngPoint, defaultLatLngString, dencodeBitwiseSet, diffLatLngBoundPoints, diffLatLngPoints, dollarAmountString, e164PhoneNumberExtensionPair, e164PhoneNumberFromE164PhoneNumberExtensionPair, enabledDaysFromDaysOfWeek, encodeBitwiseSet, encodeModelKeyTypePair, errorMessageContainsString, errorMessageContainsStringFunction, escapeStringForRegex, excludeValues, excludeValuesFromArray, excludeValuesFromSet, existsInIterable, expandArrayMapTuples, expandArrayValueTuples, expandFlattenTreeFunction, expandIndexSet, expandTreeFunction, expandTrees, extendLatLngBound, filterAndMapFunction, filterEmptyValues, filterFalsyAndEmptyValues, filterFromIterable, filterFromPOJO, filterFromPOJOFunction, filterKeyValueTupleFunction, filterKeyValueTuples, filterKeyValueTuplesFunction, filterKeyValueTuplesInputToFilter, filterMaybeValues, filterNullAndUndefinedValues, filterOnlyUndefinedValues, filterUndefinedValues, filterUniqueCaseInsensitiveStrings, filterUniqueFunction, filterUniqueTransform, filterUniqueValues, filterValuesByDistance, filterValuesByDistanceNoOrder, filterValuesToSet, filterValuesUsingSet, filteredPage, findAllCharacterOccurences, findAllCharacterOccurencesFunction, findBest, findBestIndexMatch, findBestIndexMatchFunction, findBestIndexSetPair, findFirstCharacterOccurence, findInIterable, findIndexOfFirstDuplicateValue, findItemsByIndex, findNext, findPOJOKeys, findPOJOKeysFunction, findStringsRegexString, findToIndexSet, findValuesFrom, firstAndLastCharacterOccurrence, firstAndLastValue, firstValue, firstValueFromIterable, fitToIndexRangeFunction, fixExtraQueryParameters, fixMultiSlashesInSlashPath, flattenArray, flattenArrayOrValueArray, flattenArrayToSet, flattenArrayUnique, flattenArrayUniqueCaseInsensitiveStrings, flattenTree, flattenTreeToArray, flattenTreeToArrayFunction, flattenTrees, forEachInIterable, forEachKeyValue, forEachKeyValueOnPOJOFunction, forEachWithArray, forwardFunction, fractionalHoursToMinutes, generateIfDoesNotExist, getArrayNextIndex, getDayOffset, getDayTomorrow, getDayYesterday, getDaysOfWeekNames, getFunctionType, getNextDay, getNextPageNumber, getOverlappingRectangle, getPageNumber, getPreviousDay, getValueFromGetter, groupValues, handlerBindAccessor, handlerConfigurerFactory, handlerFactory, handlerMappedSetFunction, handlerMappedSetFunctionFactory, handlerSetFunction, hasDifferentStringsNoCase, hasDifferentValues, hasHttpPrefix, hasNonNullValue, hasSameTimezone, hasSameValues, hasValueFunction, hasValueOrNotEmpty, hasValueOrNotEmptyObject, hasWebsiteDomain, hashSetForIndexed, hourToFractionalHour, idBatchFactory, incrementingNumberFactory, indexDeltaGroup, indexDeltaGroupFunction, indexRange, indexRangeCheckFunction, indexRangeCheckReaderFunction, indexRangeForArray, indexRangeOverlapsIndexRange, indexRangeOverlapsIndexRangeFunction, indexRangeReaderPairFactory, indexedValuesArrayAccessorFactory, insertIntoBooleanKeyArray, invertBooleanReturnFunction, invertDecision, invertFilter, isAllowed, isClassLikeType, isCompleteUnitedStatesAddress, isConsideredUtcTimezoneString, isDate, isDefaultLatLngPoint, isDefaultLatLngPointValue, isDefaultReadableError, isDefinedAndNotFalse, isDollarAmountString, isE164PhoneNumber, isE164PhoneNumberWithExtension, isEmptyIterable, isEqualContext, isEvenNumber, isFalseBooleanKeyArray, isFinalPage, isGetter, isISO8601DateString, isISO8601DayString, isISO8601DayStringStart, isInAllowedDaysOfWeekSet, isInNumberBoundFunction, isInSetDecisionFunction, isIndexNumberInIndexRange, isIndexNumberInIndexRangeFunction, isIndexRangeInIndexRange, isIndexRangeInIndexRangeFunction, isIterable, isLatLngBound, isLatLngBoundWithinLatLngBound, isLatLngPoint, isLatLngPointWithinLatLngBound, isLatLngString, isLogicalDateStringCode, isMapIdentityFunction, isMaybeNot, isMaybeNotOrTrue, isMaybeSo, isModelKey, isMonthDaySlashDate, isNonClassFunction, isNotNullOrEmptyString, isNumberDivisibleBy, isObjectWithConstructor, isOddNumber, isPromise, isPromiseLike, isSameLatLngBound, isSameLatLngPoint, isSameNonNullValue, isSameVector, isSelectedDecisionFunctionFactory, isSelectedIndexDecisionFunction, isServerError, isSlashPathFile, isSlashPathFolder, isSlashPathTypedFile, isStringOrTrue, isTrueBooleanKeyArray, isUTCDateString, isUsStateCodeString, isValidLatLngPoint, isValidLatitude, isValidLongitude, isValidNumberBound, isValidPhoneExtensionNumber, isValidSlashPath, isWebsiteUrl, isWebsiteUrlWithPrefix, isWithinLatLngBoundFunction, isolateSlashPath, isolateSlashPathFunction, isolateWebsitePathFunction, itemCountForBatchIndex, iterableToArray, iterableToMap, iterablesAreSetEquivalent, iterate, iterateFilteredPages, joinHostAndPort, joinStringsWithSpaces, keepCharactersAfterFirstCharacterOccurence, keepCharactersAfterFirstCharacterOccurenceFunction, keepFromSetCopy, keepValuesFromArray, keepValuesFromSet, keyValueMapFactory, lastValue, latLngBound, latLngBoundCenterPoint, latLngBoundEastBound, latLngBoundFromInput, latLngBoundFullyWrapsMap, latLngBoundFunction, latLngBoundNorthBound, latLngBoundNorthEastPoint, latLngBoundNorthWestPoint, latLngBoundOverlapsLatLngBound, latLngBoundSouthBound, latLngBoundSouthEastPoint, latLngBoundSouthWestPoint, latLngBoundStrictlyWrapsMap, latLngBoundTuple, latLngBoundTupleFunction, latLngBoundWestBound, latLngBoundWrapsMap, latLngDataPointFunction, latLngPoint, latLngPointFromString, latLngPointFunction, latLngPointPrecisionFunction, latLngString, latLngStringFunction, latLngTuple, latLngTupleFunction, limitArray, lonLatTuple, lowercaseFirstLetter, mailToUrlString, makeBestFit, makeCopyModelFieldFunction, makeDateMonthForMonthOfYear, makeGetter, makeHandler, makeHashDecodeMap, makeKeyPairs, makeModelConversionFieldValuesFunction, makeModelMap, makeModelMapFunctions, makeMultiModelKeyMap, makeValuesGroupMap, makeWithFactory, makeWithFactoryInput, mapArrayFunction, mapFunctionOutput, mapFunctionOutputPair, mapGetter, mapGetterFactory, mapIdentityFunction, mapIterable, mapKeysIntersectionObjectToArray, mapMaybeFunction, mapObjectMap, mapObjectMapFunction, mapObjectToTargetObject, mapPromiseOrValue, mapToObject, mapToTuples, mapValuesToSet, mappedUseAsyncFunction, mappedUseFunction, mapsHaveSameKeys, maybeMergeModelModifiers, maybeMergeModifiers, maybeModifierMapToFunction, maybeSet, mergeArrayIntoArray, mergeArrayOrValueIntoArray, mergeArrays, mergeArraysIntoArray, mergeFilterFunctions, mergeIntoArray, mergeModifiers, mergeObjects, mergeObjectsFunction, mergeSlashPaths, messageFromError, minAndMaxFunction, minAndMaxIndex, minAndMaxIndexFunction, minAndMaxIndexItemsFunction, minAndMaxNumber, minutesToFractionalHours, modelFieldConversions, modelFieldMapFunction, modelFieldMapFunctions, modelTypeDataPairFactory, modifier, modifierMapToFunction, modifyModelMapFunction, modifyModelMapFunctions, monthDaySlashDateToDateString, monthOfYearFromDate, monthOfYearFromDateMonth, multiKeyValueMapFactory, multiValueMapBuilder, neMostLatLngPoint, nearestDivisibleValues, objectCopyFactory, objectDeltaArrayCompressor, objectFieldEqualityChecker, objectFlatMergeMatrix, objectHasKey, objectHasKeys, objectHasNoKeys, objectIsEmpty, objectKeyEqualityComparatorFunction, objectKeysEqualityComparatorFunction, objectMergeMatrix, objectToMap, objectToTuples, overlapsLatLngBoundFunction, overrideInObject, overrideInObjectFunctionFactory, pairGroupValues, parseISO8601DayStringToUTCDate, partialServerError, passThrough, percentNumberFromDecimal, percentNumberToDecimal, performAsyncTask, performAsyncTasks, performBatchLoop, performMakeLoop, performTaskCountLoop, performTaskLoop, performTasksInParallel, performTasksInParallelFunction, pickOneRandomly, poll, primativeKeyDencoder, primativeKeyDencoderMap, primativeKeyStringDencoder, primativeValuesDelta, promiseReference, protectedFactory, pushArrayItemsIntoArray, pushElementOntoArray, pushItemOrArrayItemsIntoArray, randomArrayFactory, randomArrayIndex, randomBoolean, randomEmailFactory, randomFromArrayFactory, randomLatLngFactory, randomLatLngFromCenterFactory, randomNumber, randomNumberFactory, randomPhoneNumberFactory, randomPickFactory, range, rangedIndexedValuesArrayAccessorFactory, rangedIndexedValuesArrayAccessorInfoFactory, readBooleanKeySafetyWrap, readDomainFromEmailAddress, readDomainsFromEmailAddresses, readEmailDomainFromUrlOrEmailAddress, readIndexNumber, readKeysFrom, readKeysFromFilterUniqueFunctionAdditionalKeys, readKeysFromFilterUniqueFunctionAdditionalKeysInput, readKeysFunction, readKeysSetFrom, readKeysSetFunction, readKeysToMap, readModelKey, readModelKeyFromObject, readModelKeys, readModelKeysFromObjects, readMultipleKeysToMap, readUniqueModelKey, readableError, readableStreamToBase64, readableStreamToBuffer, readableStreamToStringFunction, rectangleOverlapsRectangle, reduceBooleansFn, reduceBooleansWithAnd, reduceBooleansWithAndFn, reduceBooleansWithOr, reduceBooleansWithOrFn, reduceNumbers, reduceNumbersFn, reduceNumbersWithAdd, reduceNumbersWithAddFn, reduceNumbersWithMax, reduceNumbersWithMaxFn, reduceNumbersWithMin, reduceNumbersWithMinFn, removeByKeyFromBooleanKeyArray, removeCharactersAfterFirstCharacterOccurence, removeCharactersAfterFirstCharacterOccurenceFunction, removeExtensionFromPhoneNumber, removeFromBooleanKeyArray, removeFromSet, removeFromSetCopy, removeHttpFromUrl, removeModelsWithKey, removeModelsWithSameKey, removeModifiers, removeTrailingFileTypeSeparators, removeTrailingSlashes, removeWebProtocolPrefix, repeatString, replaceCharacterAtIndexIf, replaceCharacterAtIndexWith, replaceInvalidFilePathTypeSeparatorsInSlashPath, replaceInvalidFilePathTypeSeparatorsInSlashPathFunction, replaceLastCharacterIf, replaceLastCharacterIfIsFunction, replaceMultipleFilePathsInSlashPath, replaceStringsFunction, requireModelKey, restoreOrder, restoreOrderWithValues, reverseCompareFn, roundNumberToStepFunction, roundNumberUpToStep, roundToPrecision, roundToPrecisionFunction, roundingFunction, runAsyncTaskForValue, runAsyncTasksForValues, safeCompareEquality, safeEqualityComparatorFunction, safeFindBestIndexMatch, searchStringFilterFunction, separateValues, separateValuesToSets, serverError, setContainsAllValues, setContainsAnyValue, setContainsNoneOfValue, setDeltaChangeKeys, setDeltaFunction, setHasValueFunction, setIncludes, setIncludesFunction, setKeysOnMap, setWebProtocolPrefix, setsAreEquivalent, simpleSortValuesFunctionWithSortRef, slashPathFactory, slashPathInvalidError, slashPathName, slashPathParts, slashPathStartTypeFactory, slashPathType, slashPathValidationFactory, sliceIndexRangeFunction, sortAscendingIndexNumberRefFunction, sortByIndexAscendingCompareFunction, sortByIndexRangeAscendingCompareFunction, sortByLabelFunction, sortByNumberFunction, sortByStringFunction, sortCompareNumberFunction, sortNumbersAscendingFunction, sortValues, sortValuesFunctionOrMapIdentityWithSortRef, sortValuesFunctionWithSortRef, spaceSeparatedCssClasses, splitCommaSeparatedString, splitCommaSeparatedStringToSet, splitJoinNameString, splitJoinRemainder, splitStringAtFirstCharacterOccurence, splitStringAtFirstCharacterOccurenceFunction, splitStringAtIndex, stepsFromIndex, stepsFromIndexFunction, stringToLowercaseFunction, stringToUppercaseFunction, stringTrimFunction, sumOfIntegersBetween, swMostLatLngPoint, symmetricDifferenceArray, symmetricDifferenceArrayBetweenSets, symmetricDifferenceWithModels, takeFront, takeLast, takeValuesFromIterable, telUrlString, telUrlStringForE164PhoneNumberPair, throwKeyIsRequired, toAbsoluteSlashPathStartType, toCaseInsensitiveStringArray, toModelFieldConversions, toModelMapFunctions, toReadableError, toRelativeSlashPathStartType, toggleInSet, toggleInSetCopy, transformNumberFunction, transformStringFunction, transformStrings, trimArray, typedServiceRegistry, unique, uniqueCaseInsensitiveStrings, uniqueCaseInsensitiveStringsSet, uniqueKeys, uniqueModels, unitedStatesAddressString, urlWithoutParameters, useAsync, useCallback, useContextFunction, useIterableOrValue, useModelOrKey, usePromise, useValue, validLatLngPoint, validLatLngPointFunction, valueAtIndex, valuesAreBothNullishOrEquivalent, valuesFromPOJO, valuesFromPOJOFunction, vectorMinimumSizeResizeFunction, vectorsAreEqual, waitForMs, websiteDomainAndPathPair, websiteDomainAndPathPairFromWebsiteUrl, websitePathAndQueryPair, websitePathFromWebsiteDomainAndPath, websitePathFromWebsiteUrl, websiteUrlFromPaths, wrapIndexRangeFunction, wrapLatLngPoint, wrapLngValue, wrapMapFunctionOutput, wrapNumberFunction, wrapUseAsyncFunction, wrapUseFunction };
+export { ALL_DOUBLE_SLASHES_REGEX, ALL_SLASHES_REGEX, ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX, ASSERTION_ERROR_CODE, ASSERTION_HANDLER, AUTH_ADMIN_ROLE, AUTH_ONBOARDED_ROLE, AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE, AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE, AUTH_TOS_SIGNED_ROLE, AUTH_USER_ROLE, AbstractUniqueModel, Assert, AssertMax, AssertMin, AssertionError, AssertionIssueHandler, BooleanKeyArrayUtilityInstance, BooleanStringKeyArrayUtilityInstance, CATCH_ALL_HANDLE_RESULT_KEY, CUT_VALUE_TO_ZERO_PRECISION, DATE_NOW_VALUE, DEFAULT_LAT_LNG_STRING_VALUE, DEFAULT_RANDOM_EMAIL_FACTORY_CONFIG, DEFAULT_RANDOM_PHONE_NUMBER_FACTORY_CONFIG, DEFAULT_READABLE_ERROR_CODE, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT, DEFAULT_UNKNOWN_MODEL_TYPE_STRING, DOLLAR_AMOUNT_PRECISION, DOLLAR_AMOUNT_STRING_REGEX, DataDoesNotExistError, DataIsExpiredError, Day, DestroyFunctionObject, E164PHONE_NUMBER_REGEX, E164PHONE_NUMBER_WITH_EXTENSION_REGEX, E164PHONE_NUMBER_WITH_OPTIONAL_EXTENSION_REGEX, FINAL_PAGE, FIRST_PAGE, FRACTIONAL_HOURS_PRECISION_FUNCTION, FullStorageObject, HAS_WEBSITE_DOMAIN_NAME_REGEX, HOURS_IN_DAY, HTTP_OR_HTTPS_REGEX, HashSet, ISO8601_DAY_STRING_REGEX, ISO8601_DAY_STRING_START_REGEX, ISO_8601_DATE_STRING_REGEX, KeyValueTypleValueFilter, LAT_LNG_PATTERN, LAT_LNG_PATTERN_MAX_PRECISION, LAT_LONG_100KM_PRECISION, LAT_LONG_100M_PRECISION, LAT_LONG_10CM_PRECISION, LAT_LONG_10KM_PRECISION, LAT_LONG_10M_PRECISION, LAT_LONG_1CM_PRECISION, LAT_LONG_1KM_PRECISION, LAT_LONG_1MM_PRECISION, LAT_LONG_1M_PRECISION, LAT_LONG_GRAINS_OF_SAND_PRECISION, LEADING_SLASHES_REGEX, MAP_IDENTITY, MAX_BITWISE_SET_SIZE, MAX_LATITUDE_VALUE, MAX_LONGITUDE_VALUE, MINUTES_IN_DAY, MINUTES_IN_HOUR, MIN_LATITUDE_VALUE, MIN_LONGITUDE_VALUE, MONTH_DAY_SLASH_DATE_STRING_REGEX, MS_IN_DAY, MS_IN_HOUR, MS_IN_MINUTE, MS_IN_SECOND, MemoryStorageInstance, ModelRelationUtility, NOOP_MODIFIER, PHONE_EXTENSION_NUMBER_REGEX, PRIMATIVE_KEY_DENCODER_VALUE, PageCalculator, PropertyDescriptorUtility, REGEX_SPECIAL_CHARACTERS, REGEX_SPECIAL_CHARACTERS_SET, RelationChange, SECONDS_IN_MINUTE, SHARED_MEMORY_STORAGE, SLASH_PATH_FILE_TYPE_SEPARATOR, SLASH_PATH_SEPARATOR, SORT_VALUE_EQUAL, SORT_VALUE_GREATER_THAN, SORT_VALUE_LESS_THAN, ServerErrorResponse, SetDeltaChange, SimpleStorageObject, StorageObject, StorageObjectUtility, StoredDataError, SyncState, TOTAL_LATITUDE_RANGE, TOTAL_LONGITUDE_RANGE, TOTAL_SPAN_OF_LONGITUDE, TRAILING_FILE_TYPE_SEPARATORS_REGEX, TRAILING_SLASHES_REGEX, TimeAM, TypedServiceRegistryInstance, UNLOADED_PAGE, US_STATE_CODE_STRING_REGEX, UTC_DATE_STRING_REGEX, UTC_TIMEZONE_STRING, UTF_8_START_CHARACTER, UTF_PRIVATE_USAGE_AREA_START, UnauthorizedServerErrorResponse, WEB_PROTOCOL_PREFIX_REGEX, ZIP_CODE_STRING_REGEX, addHttpToUrl, addLatLngPoints, addModifiers, addPlusPrefixToNumber, addPrefix, addPrefixFunction, addSuffix, addSuffixFunction, addToSet, addToSetCopy, allFalsyOrEmptyKeys, allIndexesInIndexRange, allKeyValueTuples, allMaybeSoKeys, allNonUndefinedKeys, allObjectsAreEqual, allValuesAreMaybeNot, allValuesAreNotMaybe, applyBestFit, applyToMultipleFields, areEqualContext, areEqualPOJOValues, arrayContainsDuplicateValue, arrayContentsDiffer, arrayDecision, arrayDecisionFunction, arrayFactory, arrayInputFactory, arrayToLowercase, arrayToMap, arrayToObject, arrayToUppercase, asArray, asDecisionFunction, asGetter, asIndexRangeCheckFunctionConfig, asIterable, asNumber, asObjectCopyFactory, asPromise, asSet, assignValuesToPOJO, assignValuesToPOJOFunction, authClaims, authRoleClaimsService, authRolesSetHasRoles, baseWebsiteUrl, batch, batchCalc, bitwiseObjectDencoder, bitwiseObjectEncoder, bitwiseObjectdecoder, bitwiseSetDecoder, bitwiseSetDencoder, booleanFactory, boundNumber, boundNumberFunction, boundToRectangle, build, cachedGetter, capLatValue, capitalizeFirstLetter, caseInsensitiveFilterByIndexOfDecisionFactory, caseInsensitiveString, catchAllHandlerKey, chainMapFunction, chainMapSameFunctions, coerceToEmailParticipants, combineMaps, compareEqualityWithValueFromItemsFunction, compareEqualityWithValueFromItemsFunctionFactory, compareFnOrder, computeNextFractionalHour, computeNextFreeIndexFunction, concatArrays, concatArraysUnique, containsAllStringsAnyCase, containsAllValues, containsAnyStringAnyCase, containsAnyValue, containsAnyValueFromSet, containsNoValueFromSet, containsNoneOfValue, containsStringAnyCase, convertEmailParticipantStringToParticipant, convertMaybeToArray, convertParticipantToEmailParticipantString, convertToArray, copyArray, copyField, copyLatLngBound, copyLatLngPoint, copyObject, copySetAndDo, countPOJOKeys, countPOJOKeysFunction, cronExpressionRepeatingEveryNMinutes, cssClassesSet, cutToPrecision, cutValueToInteger, cutValueToPrecision, cutValueToPrecisionFunction, dateFromLogicalDate, dayOfWeek, daysOfWeekArray, daysOfWeekFromEnabledDays, daysOfWeekNameFunction, daysOfWeekNameMap, decisionFunction, decodeHashedValues, decodeHashedValuesWithDecodeMap, decodeModelKeyTypePair, defaultFilterFromPOJOFunctionNoCopy, defaultForwardFunctionFactory, defaultLatLngPoint, defaultLatLngString, dencodeBitwiseSet, diffLatLngBoundPoints, diffLatLngPoints, dollarAmountString, e164PhoneNumberExtensionPair, e164PhoneNumberFromE164PhoneNumberExtensionPair, enabledDaysFromDaysOfWeek, encodeBitwiseSet, encodeModelKeyTypePair, errorMessageContainsString, errorMessageContainsStringFunction, escapeStringForRegex, excludeValues, excludeValuesFromArray, excludeValuesFromSet, existsInIterable, expandArrayMapTuples, expandArrayValueTuples, expandFlattenTreeFunction, expandIndexSet, expandTreeFunction, expandTrees, extendLatLngBound, filterAndMapFunction, filterEmptyValues, filterFalsyAndEmptyValues, filterFromIterable, filterFromPOJO, filterFromPOJOFunction, filterKeyValueTupleFunction, filterKeyValueTuples, filterKeyValueTuplesFunction, filterKeyValueTuplesInputToFilter, filterMaybeValues, filterNullAndUndefinedValues, filterOnlyUndefinedValues, filterUndefinedValues, filterUniqueCaseInsensitiveStrings, filterUniqueFunction, filterUniqueTransform, filterUniqueValues, filterValuesByDistance, filterValuesByDistanceNoOrder, filterValuesToSet, filterValuesUsingSet, filteredPage, findAllCharacterOccurences, findAllCharacterOccurencesFunction, findBest, findBestIndexMatch, findBestIndexMatchFunction, findBestIndexSetPair, findFirstCharacterOccurence, findInIterable, findIndexOfFirstDuplicateValue, findItemsByIndex, findNext, findPOJOKeys, findPOJOKeysFunction, findStringsRegexString, findToIndexSet, findValuesFrom, firstAndLastCharacterOccurrence, firstAndLastValue, firstValue, firstValueFromIterable, fitToIndexRangeFunction, fixExtraQueryParameters, fixMultiSlashesInSlashPath, flattenArray, flattenArrayOrValueArray, flattenArrayToSet, flattenArrayUnique, flattenArrayUniqueCaseInsensitiveStrings, flattenTree, flattenTreeToArray, flattenTreeToArrayFunction, flattenTrees, forEachInIterable, forEachKeyValue, forEachKeyValueOnPOJOFunction, forEachWithArray, forwardFunction, fractionalHoursToMinutes, generateIfDoesNotExist, getArrayNextIndex, getDayOffset, getDayTomorrow, getDayYesterday, getDaysOfWeekNames, getFunctionType, getNextDay, getNextPageNumber, getOverlappingRectangle, getPageNumber, getPreviousDay, getValueFromGetter, groupValues, handlerBindAccessor, handlerConfigurerFactory, handlerFactory, handlerMappedSetFunction, handlerMappedSetFunctionFactory, handlerSetFunction, hasDifferentStringsNoCase, hasDifferentValues, hasHttpPrefix, hasNonNullValue, hasSameTimezone, hasSameValues, hasValueFunction, hasValueOrNotEmpty, hasValueOrNotEmptyObject, hasWebsiteDomain, hashSetForIndexed, hourToFractionalHour, idBatchFactory, incrementingNumberFactory, indexDeltaGroup, indexDeltaGroupFunction, indexRange, indexRangeCheckFunction, indexRangeCheckReaderFunction, indexRangeForArray, indexRangeOverlapsIndexRange, indexRangeOverlapsIndexRangeFunction, indexRangeReaderPairFactory, indexedValuesArrayAccessorFactory, insertIntoBooleanKeyArray, invertBooleanReturnFunction, invertDecision, invertFilter, isAllowed, isClassLikeType, isCompleteUnitedStatesAddress, isConsideredUtcTimezoneString, isDate, isDefaultLatLngPoint, isDefaultLatLngPointValue, isDefaultReadableError, isDefinedAndNotFalse, isDollarAmountString, isE164PhoneNumber, isE164PhoneNumberWithExtension, isEmptyIterable, isEqualContext, isEvenNumber, isFalseBooleanKeyArray, isFinalPage, isGetter, isISO8601DateString, isISO8601DayString, isISO8601DayStringStart, isInAllowedDaysOfWeekSet, isInNumberBoundFunction, isInSetDecisionFunction, isIndexNumberInIndexRange, isIndexNumberInIndexRangeFunction, isIndexRangeInIndexRange, isIndexRangeInIndexRangeFunction, isIterable, isLatLngBound, isLatLngBoundWithinLatLngBound, isLatLngPoint, isLatLngPointWithinLatLngBound, isLatLngString, isLogicalDateStringCode, isMapIdentityFunction, isMaybeNot, isMaybeNotOrTrue, isMaybeSo, isModelKey, isMonthDaySlashDate, isNonClassFunction, isNotNullOrEmptyString, isNumberDivisibleBy, isObjectWithConstructor, isOddNumber, isPromise, isPromiseLike, isSameLatLngBound, isSameLatLngPoint, isSameNonNullValue, isSameVector, isSelectedDecisionFunctionFactory, isSelectedIndexDecisionFunction, isServerError, isSlashPathFile, isSlashPathFolder, isSlashPathTypedFile, isStringOrTrue, isTrueBooleanKeyArray, isUTCDateString, isUsStateCodeString, isValidLatLngPoint, isValidLatitude, isValidLongitude, isValidNumberBound, isValidPhoneExtensionNumber, isValidSlashPath, isWebsiteUrl, isWebsiteUrlWithPrefix, isWithinLatLngBoundFunction, isolateSlashPath, isolateSlashPathFunction, isolateWebsitePathFunction, itemCountForBatchIndex, iterableToArray, iterableToMap, iterablesAreSetEquivalent, iterate, iterateFilteredPages, joinHostAndPort, joinStringsWithSpaces, keepCharactersAfterFirstCharacterOccurence, keepCharactersAfterFirstCharacterOccurenceFunction, keepFromSetCopy, keepValuesFromArray, keepValuesFromSet, keyValueMapFactory, lastValue, latLngBound, latLngBoundCenterPoint, latLngBoundEastBound, latLngBoundFromInput, latLngBoundFullyWrapsMap, latLngBoundFunction, latLngBoundNorthBound, latLngBoundNorthEastPoint, latLngBoundNorthWestPoint, latLngBoundOverlapsLatLngBound, latLngBoundSouthBound, latLngBoundSouthEastPoint, latLngBoundSouthWestPoint, latLngBoundStrictlyWrapsMap, latLngBoundTuple, latLngBoundTupleFunction, latLngBoundWestBound, latLngBoundWrapsMap, latLngDataPointFunction, latLngPoint, latLngPointFromString, latLngPointFunction, latLngPointPrecisionFunction, latLngString, latLngStringFunction, latLngTuple, latLngTupleFunction, limitArray, lonLatTuple, lowercaseFirstLetter, mailToUrlString, makeBestFit, makeCopyModelFieldFunction, makeDateMonthForMonthOfYear, makeGetter, makeHandler, makeHashDecodeMap, makeKeyPairs, makeModelConversionFieldValuesFunction, makeModelMap, makeModelMapFunctions, makeMultiModelKeyMap, makeValuesGroupMap, makeWithFactory, makeWithFactoryInput, mapArrayFunction, mapFunctionOutput, mapFunctionOutputPair, mapGetter, mapGetterFactory, mapIdentityFunction, mapIterable, mapKeysIntersectionObjectToArray, mapMaybeFunction, mapObjectMap, mapObjectMapFunction, mapObjectToTargetObject, mapPromiseOrValue, mapToObject, mapToTuples, mapValuesToSet, mappedUseAsyncFunction, mappedUseFunction, mapsHaveSameKeys, maybeMergeModelModifiers, maybeMergeModifiers, maybeModifierMapToFunction, maybeSet, mergeArrayIntoArray, mergeArrayOrValueIntoArray, mergeArrays, mergeArraysIntoArray, mergeFilterFunctions, mergeIntoArray, mergeModifiers, mergeObjects, mergeObjectsFunction, mergeSlashPaths, messageFromError, minAndMaxFunction, minAndMaxIndex, minAndMaxIndexFunction, minAndMaxIndexItemsFunction, minAndMaxNumber, minutesToFractionalHours, modelFieldConversions, modelFieldMapFunction, modelFieldMapFunctions, modelTypeDataPairFactory, modifier, modifierMapToFunction, modifyModelMapFunction, modifyModelMapFunctions, monthDaySlashDateToDateString, monthOfYearFromDate, monthOfYearFromDateMonth, multiKeyValueMapFactory, multiValueMapBuilder, neMostLatLngPoint, nearestDivisibleValues, objectCopyFactory, objectDeltaArrayCompressor, objectFieldEqualityChecker, objectFlatMergeMatrix, objectHasKey, objectHasKeys, objectHasNoKeys, objectIsEmpty, objectKeyEqualityComparatorFunction, objectKeysEqualityComparatorFunction, objectMergeMatrix, objectToMap, objectToTuples, overlapsLatLngBoundFunction, overrideInObject, overrideInObjectFunctionFactory, pairGroupValues, parseISO8601DayStringToUTCDate, partialServerError, passThrough, percentNumberFromDecimal, percentNumberToDecimal, performAsyncTask, performAsyncTasks, performBatchLoop, performMakeLoop, performTaskCountLoop, performTaskLoop, performTasksInParallel, performTasksInParallelFunction, pickOneRandomly, poll, primativeKeyDencoder, primativeKeyDencoderMap, primativeKeyStringDencoder, primativeValuesDelta, promiseReference, protectedFactory, pushArrayItemsIntoArray, pushElementOntoArray, pushItemOrArrayItemsIntoArray, randomArrayFactory, randomArrayIndex, randomBoolean, randomEmailFactory, randomFromArrayFactory, randomLatLngFactory, randomLatLngFromCenterFactory, randomNumber, randomNumberFactory, randomPhoneNumberFactory, randomPickFactory, range, rangedIndexedValuesArrayAccessorFactory, rangedIndexedValuesArrayAccessorInfoFactory, readBooleanKeySafetyWrap, readDomainFromEmailAddress, readDomainsFromEmailAddresses, readEmailDomainFromUrlOrEmailAddress, readIndexNumber, readKeysFrom, readKeysFromFilterUniqueFunctionAdditionalKeys, readKeysFromFilterUniqueFunctionAdditionalKeysInput, readKeysFunction, readKeysSetFrom, readKeysSetFunction, readKeysToMap, readModelKey, readModelKeyFromObject, readModelKeys, readModelKeysFromObjects, readMultipleKeysToMap, readUniqueModelKey, readableError, readableStreamToBase64, readableStreamToBuffer, readableStreamToStringFunction, rectangleOverlapsRectangle, reduceBooleansFn, reduceBooleansWithAnd, reduceBooleansWithAndFn, reduceBooleansWithOr, reduceBooleansWithOrFn, reduceNumbers, reduceNumbersFn, reduceNumbersWithAdd, reduceNumbersWithAddFn, reduceNumbersWithMax, reduceNumbersWithMaxFn, reduceNumbersWithMin, reduceNumbersWithMinFn, removeByKeyFromBooleanKeyArray, removeCharactersAfterFirstCharacterOccurence, removeCharactersAfterFirstCharacterOccurenceFunction, removeExtensionFromPhoneNumber, removeFromBooleanKeyArray, removeFromSet, removeFromSetCopy, removeHttpFromUrl, removeModelsWithKey, removeModelsWithSameKey, removeModifiers, removeTrailingFileTypeSeparators, removeTrailingSlashes, removeWebProtocolPrefix, repeatString, replaceCharacterAtIndexIf, replaceCharacterAtIndexWith, replaceInvalidFilePathTypeSeparatorsInSlashPath, replaceInvalidFilePathTypeSeparatorsInSlashPathFunction, replaceLastCharacterIf, replaceLastCharacterIfIsFunction, replaceMultipleFilePathsInSlashPath, replaceStringsFunction, requireModelKey, restoreOrder, restoreOrderWithValues, reverseCompareFn, roundNumberToStepFunction, roundNumberUpToStep, roundToPrecision, roundToPrecisionFunction, roundingFunction, runAsyncTaskForValue, runAsyncTasksForValues, safeCompareEquality, safeEqualityComparatorFunction, safeFindBestIndexMatch, searchStringFilterFunction, separateValues, separateValuesToSets, serverError, setContainsAllValues, setContainsAnyValue, setContainsNoneOfValue, setDeltaChangeKeys, setDeltaFunction, setHasValueFunction, setIncludes, setIncludesFunction, setKeysOnMap, setWebProtocolPrefix, setsAreEquivalent, simpleSortValuesFunctionWithSortRef, slashPathFactory, slashPathInvalidError, slashPathName, slashPathParts, slashPathStartTypeFactory, slashPathType, slashPathValidationFactory, sliceIndexRangeFunction, sortAscendingIndexNumberRefFunction, sortByIndexAscendingCompareFunction, sortByIndexRangeAscendingCompareFunction, sortByLabelFunction, sortByNumberFunction, sortByStringFunction, sortCompareNumberFunction, sortNumbersAscendingFunction, sortValues, sortValuesFunctionOrMapIdentityWithSortRef, sortValuesFunctionWithSortRef, spaceSeparatedCssClasses, splitCommaSeparatedString, splitCommaSeparatedStringToSet, splitJoinNameString, splitJoinRemainder, splitStringAtFirstCharacterOccurence, splitStringAtFirstCharacterOccurenceFunction, splitStringAtIndex, stepsFromIndex, stepsFromIndexFunction, stringFactoryFromFactory, stringToLowercaseFunction, stringToUppercaseFunction, stringTrimFunction, sumOfIntegersBetween, swMostLatLngPoint, symmetricDifferenceArray, symmetricDifferenceArrayBetweenSets, symmetricDifferenceWithModels, takeFront, takeLast, takeValuesFromIterable, telUrlString, telUrlStringForE164PhoneNumberPair, throwKeyIsRequired, toAbsoluteSlashPathStartType, toCaseInsensitiveStringArray, toModelFieldConversions, toModelMapFunctions, toReadableError, toRelativeSlashPathStartType, toggleInSet, toggleInSetCopy, transformNumberFunction, transformNumberFunctionConfig, transformStringFunction, transformStringFunctionConfig, transformStrings, trimArray, typedServiceRegistry, unique, uniqueCaseInsensitiveStrings, uniqueCaseInsensitiveStringsSet, uniqueKeys, uniqueModels, unitedStatesAddressString, urlWithoutParameters, useAsync, useCallback, useContextFunction, useIterableOrValue, useModelOrKey, usePromise, useValue, validLatLngPoint, validLatLngPointFunction, valueAtIndex, valuesAreBothNullishOrEquivalent, valuesFromPOJO, valuesFromPOJOFunction, vectorMinimumSizeResizeFunction, vectorsAreEqual, waitForMs, websiteDomainAndPathPair, websiteDomainAndPathPairFromWebsiteUrl, websitePathAndQueryPair, websitePathFromWebsiteDomainAndPath, websitePathFromWebsiteUrl, websiteUrlFromPaths, wrapIndexRangeFunction, wrapLatLngPoint, wrapLngValue, wrapMapFunctionOutput, wrapNumberFunction, wrapTuples, wrapUseAsyncFunction, wrapUseFunction };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util",
-  "version": "10.0.9",
+  "version": "10.0.11",
   "exports": {
     ".": {
       "types": "./src/index.d.ts",

package/src/lib/iterable/iterable.d.ts

@@ -79,3 +79,11 @@ export declare function existsInIterable<T>(values: Iterable<T>, fn: DecisionFun
  * @returns
  */
 export declare function filterFromIterable<T>(values: Iterable<T>, fn: DecisionFunction<T>): T[];
+/**
+ * Wraps the input tuple values as an array. The tuples should all be the same length in order to wrap them properly, and the tuple value cannot consist of only arrays of the same length.
+ *
+ * This is used to prevent functions from treating the tuple itself as an array.
+ *
+ * @param input
+ */
+export declare function wrapTuples<T>(input: IterableOrValue<T>): T[];

package/src/lib/key.d.ts

@@ -13,6 +13,10 @@ export type FieldOfType<T> = keyof T;
  * Reads a key from the input object.
  */
 export type ReadKeyFunction<T, K extends PrimativeKey = PrimativeKey> = MapFunction<T, Maybe<K>>;
+/**
+ * Reads one or more keys from the input object.
+ */
+export type ReadOneOrMoreKeysFunction<T, K extends PrimativeKey = PrimativeKey> = MapFunction<T, ArrayOrValue<K>>;
 /**
  * Reads multiple keys from the input object.
  */

package/src/lib/map/map.key.d.ts

@@ -1,5 +1,5 @@
 import { type PrimativeKey, type ReadKeyFunction, type ReadMultipleKeysFunction } from '../key';
-import { type IterableOrValue } from '../iterable';
+import { type IterableOrValue } from '../iterable/iterable';
 import { type Maybe } from '../value/maybe.type';
 /**
  * Creates a map by reading keys from the input values. Values without a key are ignored.
@@ -46,8 +46,42 @@ export interface MultiValueMapBuilder<T, K extends PrimativeKey = PrimativeKey>
     map(): MultiValueMap<T, K>;
     entries(): [Maybe<K>, T[]][];
     tuples(): [Maybe<K>, T][];
-    delete(key: Maybe<K>): void;
+    /**
+     * Deletes all values from the map with the input key.
+     *
+     * Returns true if a value was deleted.
+     *
+     * @param key
+     */
+    delete(key: Maybe<K>): boolean;
+    /**
+     * Adds the input key/value pair to the map. Use for inserting all Tuple values.
+     *
+     * @param key
+     * @param value
+     */
+    addTuples(key: Maybe<K>, value: IterableOrValue<T>): void;
+    /**
+     * Adds the input key/value(s) pair to the map.
+     *
+     * Use the addTuple() function if adding a single tuple value to the array.
+     *
+     * @param key
+     * @param value
+     */
     add(key: Maybe<K>, value: IterableOrValue<T>): void;
+    /**
+     * Returns true if the map contains the input key.
+     *
+     * @param key
+     */
+    has(key: Maybe<K>): boolean;
+    /**
+     * Returns all current values for the input key. If no values are found,
+     *
+     * @param key
+     */
+    get(key: Maybe<K>): T[];
 }
 /**
  * Creates a new MultiValueMapBuilder

package/src/lib/number/transform.d.ts

@@ -1,4 +1,5 @@
 import { type MapFunction } from '../value/map';
+import { type Maybe } from '../value/maybe.type';
 import { type BoundNumberFunctionConfig } from './bound';
 import { type NumberPrecision, type RoundNumberToStepFunctionInput } from './round';
 export type TransformNumberFunctionConfig<N extends number = number> = {
@@ -23,4 +24,6 @@ export interface TransformNumberFunctionConfigRef<N extends number = number> {
     transform: TransformNumberFunctionConfig<N>;
 }
 export type TransformNumberFunction<N extends number = number> = MapFunction<N, N>;
+export type TransformNumberFunctionConfigInput<S extends number = number> = TransformNumberFunctionConfig<S> | TransformNumberFunction<S>;
+export declare function transformNumberFunctionConfig<S extends number = number>(config?: TransformNumberFunctionConfigInput<S>): Maybe<TransformNumberFunctionConfig<S>>;
 export declare function transformNumberFunction<N extends number = number>(config: TransformNumberFunctionConfig<N>): TransformNumberFunction<N>;

package/src/lib/promise/promise.d.ts

@@ -1,4 +1,5 @@
 import { type Milliseconds } from '../date/date';
+import { type PrimativeKey, type ReadOneOrMoreKeysFunction } from '../key';
 import { type IndexNumber } from '../value';
 import { type Maybe } from '../value/maybe.type';
 export type RunAsyncTaskForValueConfig<T = unknown> = Omit<PerformAsyncTaskConfig<T>, 'throwError'>;
@@ -47,20 +48,30 @@ export interface PerformAsyncTaskConfig<I = unknown> {
      */
     readonly beforeRetry?: (value: I, tryNumber?: number) => void | Promise<void>;
 }
-export interface PerformAsyncTasksConfig<I = unknown> extends PerformAsyncTaskConfig<I>, Omit<PerformTasksInParallelFunctionConfig<I>, 'taskFactory'> {
+export interface PerformAsyncTasksConfig<I = unknown, K extends PrimativeKey = PerformTasksInParallelTaskUniqueKey> extends PerformAsyncTaskConfig<I>, Omit<PerformTasksInParallelFunctionConfig<I, K>, 'taskFactory'> {
 }
 /**
  * Performs the input tasks, and will retry tasks if they fail, up to a certain point.
  *
  * This is useful for retrying sections that may experience optimistic concurrency collisions.
  */
-export declare function performAsyncTasks<I, O = unknown>(input: I[], taskFn: PromiseAsyncTaskFn<I, O>, config?: PerformAsyncTasksConfig<I>): Promise<PerformAsyncTasksResult<I, O>>;
+export declare function performAsyncTasks<I, O = unknown, K extends PrimativeKey = PerformTasksInParallelTaskUniqueKey>(input: I[], taskFn: PromiseAsyncTaskFn<I, O>, config?: PerformAsyncTasksConfig<I, K>): Promise<PerformAsyncTasksResult<I, O>>;
 export declare function performAsyncTask<O>(taskFn: () => Promise<O>, config?: PerformAsyncTaskConfig<0>): Promise<PerformAsyncTaskResult<O>>;
-export interface PerformTasksInParallelFunctionConfig<I> {
+/**
+ * Used as a key to identify the "group" that a task belongs to to prevent other concurrent tasks from that group from running in parallel when parallel execution is desired.
+ */
+export type PerformTasksInParallelTaskUniqueKey = string;
+export interface PerformTasksInParallelFunctionConfig<I, K extends PrimativeKey = PerformTasksInParallelTaskUniqueKey> {
     /**
      * Creates a promise from the input.
      */
-    readonly taskFactory: (input: I, value: IndexNumber) => Promise<void>;
+    readonly taskFactory: (input: I, value: IndexNumber, taskKeys: K[]) => Promise<void>;
+    /**
+     * This function is used to uniquely identify tasks that may use the same resources to prevent such tasks from running concurrently.
+     *
+     * When in use the order is not guranteed.
+     */
+    readonly nonConcurrentTaskKeyFactory?: ReadOneOrMoreKeysFunction<I, K>;
     /**
      * Whether or not tasks are performed sequentially or if tasks are all done in "parellel".
      *
@@ -89,10 +100,10 @@ export type PerformTasksInParallelFunction<I> = (input: I[]) => Promise<void>;
  * @param config
  * @returns
  */
-export declare function performTasksInParallel<I>(input: I[], config: PerformTasksInParallelFunctionConfig<I>): Promise<void>;
+export declare function performTasksInParallel<I, K extends PrimativeKey = PerformTasksInParallelTaskUniqueKey>(input: I[], config: PerformTasksInParallelFunctionConfig<I, K>): Promise<void>;
 /**
  * Creates a function that performs tasks in parallel.
  *
  * @param config
  */
-export declare function performTasksInParallelFunction<I>(config: PerformTasksInParallelFunctionConfig<I>): PerformTasksInParallelFunction<I>;
+export declare function performTasksInParallelFunction<I, K extends PrimativeKey = PerformTasksInParallelTaskUniqueKey>(config: PerformTasksInParallelFunctionConfig<I, K>): PerformTasksInParallelFunction<I>;

package/src/lib/string/factory.d.ts

@@ -0,0 +1,11 @@
+import { type Factory, type FactoryWithRequiredInput } from '../getter';
+export type StringFactory<K extends string = string> = Factory<K>;
+export type ToStringFunction<T, K extends string = string> = FactoryWithRequiredInput<K, T>;
+/**
+ * Wraps another factory with a ToStringFactory function to generate strings from the original factory.
+ *
+ * @param factory
+ * @param toStringFunction
+ * @returns
+ */
+export declare function stringFactoryFromFactory<T, K extends string = string>(factory: Factory<T>, toStringFunction: ToStringFunction<T, K>): StringFactory<K>;

package/src/lib/string/index.d.ts

@@ -1,5 +1,6 @@
 export * from './char';
 export * from './dencoder';
+export * from './factory';
 export * from './html';
 export * from './password';
 export * from './string';

package/src/lib/string/transform.d.ts

@@ -1,4 +1,5 @@
 import { type MapFunction } from '../value/map';
+import { type Maybe } from '../value/maybe.type';
 export declare function stringTrimFunction(input: string): string;
 export declare function stringToUppercaseFunction(input: string): string;
 export declare function stringToLowercaseFunction(input: string): string;
@@ -24,7 +25,9 @@ export interface TransformStringFunctionConfigRef<S extends string = string> {
     transform: TransformStringFunctionConfig<S>;
 }
 export type TransformStringFunction<S extends string = string> = MapFunction<S, S>;
-export declare function transformStringFunction<S extends string = string>(config: TransformStringFunctionConfig): TransformStringFunction<S>;
+export type TransformStringFunctionConfigInput<S extends string = string> = TransformStringFunctionConfig<S> | TransformStringFunction<S>;
+export declare function transformStringFunctionConfig<S extends string = string>(config?: TransformStringFunctionConfigInput<S>): Maybe<TransformStringFunctionConfig<S>>;
+export declare function transformStringFunction<S extends string = string>(config: TransformStringFunctionConfig<S>): TransformStringFunction<S>;
 export declare function addPrefix(prefix: string, input: string): string;
 /**
  * Function that adds a configured prefix to the input string if it does not exist on that string.

package/test/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [10.0.11](https://github.com/dereekb/dbx-components/compare/v10.0.10-dev...v10.0.11) (2024-01-25)
+
+
+
+## [10.0.10](https://github.com/dereekb/dbx-components/compare/v10.0.9-dev...v10.0.10) (2024-01-21)
+
+
+
 ## [10.0.9](https://github.com/dereekb/dbx-components/compare/v10.0.8-dev...v10.0.9) (2024-01-15)
 
 

package/test/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util/test",
-  "version": "10.0.9",
+  "version": "10.0.11",
   "type": "commonjs",
   "peerDependencies": {
     "@dereekb/util": "*"