dce-reactkit 3.1.5 → 3.1.8

package/src/helpers/parallelLimit.ts

@@ -0,0 +1,63 @@
+/**
+ * Run tasks in parallel with a limit on how many tasks can execute at once.
+ *   No guarantees are made about the order of task execution
+ * @author Gabe Abrams
+ * @param taskFunctions functions that start asynchronous tasks and optionally
+ *   resolve with values
+ * @param [limit=no limit] maximum number of asynchronous tasks to permit to run at
+ *   once
+ * @returns array of resolved values in the same order as the task functions
+ */
+const parallelLimit = async (
+  taskFunctions: (() => Promise<any>)[],
+  limit?: number,
+): Promise<any[]> => {
+  const results: any[] = [];
+
+  // Wait until finished with all tasks
+  await new Promise<void>((resolve) => {
+    /* ------------- Helpers ------------ */
+
+    let nextTaskIndex = 0;
+    let numFinishedTasks = 0;
+    /**
+     * Start the next task
+     * @author Gabe Abrams
+     */
+    const startTask = async () => {
+      const taskIndex = nextTaskIndex++;
+
+      // Get the task
+      const taskFunction = taskFunctions[taskIndex];
+      if (!taskFunction) {
+        return;
+      }
+
+      // Execute task
+      const result = await taskFunction();
+
+      // Add results
+      results[taskIndex] = result;
+
+      // Tally and finish
+      if (++numFinishedTasks === taskFunctions.length) {
+        return resolve();
+      }
+
+      // Not finished! Start another task
+      startTask();
+    };
+
+    /* ----------- Start Tasks ---------- */
+    
+    // If no limit, start all tasks. At least start 1 task
+    const numTasks = Math.max((limit || taskFunctions.length), 1);
+    for (let i = 0; i < numTasks; i++) {
+      startTask();
+    }
+  });
+
+  return results;
+};
+
+export default parallelLimit;

package/src/index.ts

@@ -47,6 +47,7 @@ import getHumanReadableDate from './helpers/getHumanReadableDate';
 import getPartOfDay from './helpers/getPartOfDay';
 import stringsToHumanReadableList from './helpers/stringsToHumanReadableList';
 import onlyKeepLetters from './helpers/onlyKeepLetters';
+import parallelLimit from './helpers/parallelLimit';
 
 // Import types
 import ModalButtonType from './types/ModalButtonType';
@@ -104,6 +105,7 @@ export {
   getPartOfDay,
   stringsToHumanReadableList,
   onlyKeepLetters,
+  parallelLimit,
   // Client helpers
   visitServerEndpoint,
   // Server helpers