@arcgis/toolkit 5.1.0-next.77 → 5.1.0-next.79

package/dist/promise/index.cjs

@@ -11,6 +11,20 @@ class Deferred {
     });
   }
 }
+async function forEachWithConcurrency(items, concurrency, callback) {
+  if (items.length === 0) {
+    return;
+  }
+  let index = 0;
+  async function consumeItems() {
+    while (index < items.length) {
+      const item = items[index];
+      index += 1;
+      await callback(item);
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, async () => await consumeItems()));
+}
 const devToolsAwareTimeout = (callback, timeout) => {
   const interval = timeout > longTimeoutThreshold ? longTimeoutInterval : timeout / shortTimeoutIntervals;
   let elapsed = 0;
@@ -28,3 +42,4 @@ const longTimeoutInterval = 2e3;
 const shortTimeoutIntervals = 4;
 exports.Deferred = Deferred;
 exports.devToolsAwareTimeout = devToolsAwareTimeout;
+exports.forEachWithConcurrency = forEachWithConcurrency;

package/dist/promise/index.d.cts

@@ -37,6 +37,20 @@ export interface Deferred<T> {
      */
     reject(_error: unknown): void;
 }
+/**
+ * Execute async callbacks against a list with a fixed number of in-flight
+ * operations.
+ * Useful for rate-limiting or to avoid overwhelming resources with too many concurrent operations.
+ *
+ * @example
+ * ```ts
+ * const items = [...lotsOfItems];
+ * await forEachWithConcurrency(items, 5, async (item) => {
+ *   await doSomethingAsync(item);
+ * });
+ * ```
+ */
+export declare function forEachWithConcurrency<T>(items: readonly T[], concurrency: number, callback: (item: T) => Promise<void>): Promise<void>;
 /**
  * Like setTimeout(), but does not advance the clock if the program is
  * stopped on a debugger breakpoint.

package/dist/promise/index.d.ts

@@ -37,6 +37,20 @@ export interface Deferred<T> {
      */
     reject(_error: unknown): void;
 }
+/**
+ * Execute async callbacks against a list with a fixed number of in-flight
+ * operations.
+ * Useful for rate-limiting or to avoid overwhelming resources with too many concurrent operations.
+ *
+ * @example
+ * ```ts
+ * const items = [...lotsOfItems];
+ * await forEachWithConcurrency(items, 5, async (item) => {
+ *   await doSomethingAsync(item);
+ * });
+ * ```
+ */
+export declare function forEachWithConcurrency<T>(items: readonly T[], concurrency: number, callback: (item: T) => Promise<void>): Promise<void>;
 /**
  * Like setTimeout(), but does not advance the clock if the program is
  * stopped on a debugger breakpoint.

package/dist/promise/index.js

@@ -9,6 +9,20 @@ class Deferred {
     });
   }
 }
+async function forEachWithConcurrency(items, concurrency, callback) {
+  if (items.length === 0) {
+    return;
+  }
+  let index = 0;
+  async function consumeItems() {
+    while (index < items.length) {
+      const item = items[index];
+      index += 1;
+      await callback(item);
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, async () => await consumeItems()));
+}
 const devToolsAwareTimeout = (callback, timeout) => {
   const interval = timeout > longTimeoutThreshold ? longTimeoutInterval : timeout / shortTimeoutIntervals;
   let elapsed = 0;
@@ -26,5 +40,6 @@ const longTimeoutInterval = 2e3;
 const shortTimeoutIntervals = 4;
 export {
   Deferred,
-  devToolsAwareTimeout
+  devToolsAwareTimeout,
+  forEachWithConcurrency
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/toolkit",
-  "version": "5.1.0-next.77",
+  "version": "5.1.0-next.79",
   "description": "Collection of common internal patterns and utilities for ArcGIS Maps SDK for JavaScript components.",
   "homepage": "https://developers.arcgis.com/javascript/latest/",
   "sideEffects": false,