@terrygonguet/utils 0.4.1 → 0.5.0

package/dist/async.d.ts

@@ -5,11 +5,21 @@ interface RetryOptions {
 }
 declare function retry(options: RetryOptions): <T>(provider: () => Promise<T>) => Promise<T>;
 declare function retry<T>(provider: () => Promise<T>, options?: RetryOptions): Promise<T>;
-interface AsyncMapOptions {
+interface AsyncMapOptions<FailFast extends boolean = false, WithSourceIndexes extends boolean = false> {
     concurrent?: number;
+    failFast?: FailFast;
+    withSourceIndexes?: WithSourceIndexes;
+}
+interface AsyncMapResultWithIndexes<U> {
+    results: [i: number, value: U][];
+    errors: [i: number, error: unknown][];
+}
+interface AsyncMapResult<U> {
+    results: U[];
+    errors: unknown[];
 }
-declare function asyncMap<T, U>(f: AsyncMapFn<T, U>, options?: AsyncMapOptions): (data: T[]) => Promise<U[]>;
-declare function asyncMap<T, U>(data: T[], f: AsyncMapFn<T, U>, options?: AsyncMapOptions): Promise<U[]>;
 type AsyncMapFn<T, U> = (el: T, i: number, data: T[]) => Promise<U>;
+declare function asyncMap<T, U, FailFast extends boolean = false, WithSourceIndexes extends boolean = false>(f: AsyncMapFn<T, U>, options?: AsyncMapOptions<FailFast, WithSourceIndexes>): (data: T[]) => Promise<FailFast extends true ? WithSourceIndexes extends true ? [i: number, value: U][] : U[] : WithSourceIndexes extends true ? AsyncMapResultWithIndexes<U> : AsyncMapResult<U>>;
+declare function asyncMap<T, U, FailFast extends boolean = false, WithSourceIndexes extends boolean = false>(data: T[], f: AsyncMapFn<T, U>, options?: AsyncMapOptions<FailFast, WithSourceIndexes>): Promise<FailFast extends true ? WithSourceIndexes extends true ? [i: number, value: U][] : U[] : WithSourceIndexes extends true ? AsyncMapResultWithIndexes<U> : AsyncMapResult<U>>;
 
 export { asyncMap, pause, retry };

package/dist/async.js

@@ -40,34 +40,62 @@ function asyncMap(dataOrF, ForOptions, options) {
     return asyncMap_(data, f, options);
   } else throw new Error("Invalid arguments passed to asyncMap");
 }
-async function asyncMap_(data, f, { concurrent = 5 } = {}) {
+async function asyncMap_(data, f, {
+  concurrent = 5,
+  failFast = false,
+  withSourceIndexes = false
+} = {}) {
   return new Promise((resolve, reject) => {
     const resolved = [];
-    const inFlight = [];
+    const errors = [];
+    const inFlight = /* @__PURE__ */ new Map();
     let next = 0;
+    let stop = false;
     function queue(i) {
-      if (resolved.length == data.length && inFlight.length == 0)
-        return finish();
-      if (i >= data.length) return;
-      const el = data[i];
-      inFlight.push([
+      if (!stop && i > 0 && inFlight.size == 0) return finish();
+      if (stop || i >= data.length) return;
+      inFlight.set(
         i,
-        f(el, i, data).then((result) => {
-          resolved.push([i, result]);
-          const j = inFlight.findIndex(([j2]) => i == j2);
-          inFlight.splice(j, 1);
+        f(data[i], i, data).then(
+          (result) => void resolved.push([i, result]),
+          (error) => {
+            if (!failFast) errors.push([i, error]);
+            else {
+              stop = true;
+              reject(error);
+            }
+          }
+        ).finally(() => {
+          inFlight.delete(i);
           queue(next);
-        }, reject)
-      ]);
+        })
+      );
       next++;
     }
     function finish() {
-      const sorted = resolved.sort(([a], [b]) => a - b);
-      resolve(sorted.map(([, value]) => value));
-    }
-    for (let i = 0; i < concurrent; i++) {
-      queue(next);
+      resolved.sort(([a], [b]) => a - b);
+      if (failFast) {
+        if (withSourceIndexes) resolve(resolved);
+        else resolve(resolved.map(([, value]) => value));
+      } else {
+        errors.sort(([a], [b]) => a - b);
+        if (withSourceIndexes)
+          resolve({
+            results: resolved,
+            errors
+          });
+        else
+          resolve({
+            results: resolved.map(([, value]) => value),
+            errors: errors.map(([, error]) => error)
+          });
+      }
     }
+    if (data.length == 0) finish();
+    else
+      for (let i = 0; i < concurrent; i++) {
+        queue(next);
+      }
   });
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@terrygonguet/utils",
-	"version": "0.4.1",
+	"version": "0.5.0",
 	"type": "module",
 	"license": "MIT",
 	"scripts": {
@@ -34,11 +34,11 @@
 		}
 	},
 	"devDependencies": {
-		"prettier": "^2.8.8",
-		"tsup": "^8.1.0",
-		"typescript": "^5.0.2",
-		"vite": "^5.4.8",
-		"vitest": "^2.1.2"
+		"prettier": "^3.5.2",
+		"tsup": "^8.3.6",
+		"typescript": "^5.7.3",
+		"vite": "^6.1.1",
+		"vitest": "^3.0.6"
 	},
 	"author": {
 		"email": "terry@gonguet.com",