@stryke/helpers 0.9.48 → 0.10.0

package/CHANGELOG.md

@@ -2,6 +2,50 @@
 
 # Changelog for Stryke - Helpers
 
+## [0.10.0](https://github.com/storm-software/stryke/releases/tag/helpers%400.10.0) (03/08/2026)
+
+### Features
+
+- **helpers:** Added the `runParallel` helper function ([e833fa16](https://github.com/storm-software/stryke/commit/e833fa16))
+
+### Updated Dependencies
+
+- Updated **type-checks** to **v0.5.35**
+- Updated **convert** to **v0.6.50**
+- Updated **types** to **v0.10.49**
+
+## [0.9.51](https://github.com/storm-software/stryke/releases/tag/helpers%400.9.51) (03/06/2026)
+
+### Updated Dependencies
+
+- Updated **type-checks** to **v0.5.34**
+- Updated **convert** to **v0.6.49**
+- Updated **types** to **v0.10.48**
+
+## [0.9.50](https://github.com/storm-software/stryke/releases/tag/helpers%400.9.50) (03/06/2026)
+
+### Updated Dependencies
+
+- Updated **type-checks** to **v0.5.33**
+- Updated **convert** to **v0.6.48**
+- Updated **types** to **v0.10.47**
+
+## [0.9.49](https://github.com/storm-software/stryke/releases/tag/helpers%400.9.49) (03/06/2026)
+
+### Updated Dependencies
+
+- Updated **type-checks** to **v0.5.32**
+- Updated **convert** to **v0.6.47**
+- Updated **types** to **v0.10.46**
+
+## [0.9.48](https://github.com/storm-software/stryke/releases/tag/helpers%400.9.48) (03/03/2026)
+
+### Updated Dependencies
+
+- Updated **type-checks** to **v0.5.31**
+- Updated **convert** to **v0.6.46**
+- Updated **types** to **v0.10.45**
+
 ## [0.9.47](https://github.com/storm-software/stryke/releases/tag/helpers%400.9.47) (03/03/2026)
 
 ### Updated Dependencies

package/dist/index.cjs

@@ -20,6 +20,7 @@ const require_mutex = require('./mutex.cjs');
 const require_noop = require('./noop.cjs');
 const require_omit = require('./omit.cjs');
 const require_once = require('./once.cjs');
+const require_parallel = require('./parallel.cjs');
 const require_pick = require('./pick.cjs');
 const require_remove_empty_items = require('./remove-empty-items.cjs');
 const require_set_field = require('./set-field.cjs');
@@ -59,6 +60,7 @@ exports.pick = require_pick.pick;
 exports.rankings = require_match_sorter.rankings;
 exports.removeAccents = require_remove_accents.removeAccents;
 exports.removeEmptyItems = require_remove_empty_items.removeEmptyItems;
+exports.runParallel = require_parallel.runParallel;
 exports.safeFunctionCast = require_once.safeFunctionCast;
 exports.setField = require_set_field.setField;
 exports.sleep = require_delay.sleep;

package/dist/index.d.cts

@@ -17,6 +17,7 @@ import { Mutex } from "./mutex.cjs";
 import { asyncNoop, noop } from "./noop.cjs";
 import { omit } from "./omit.cjs";
 import { once, safeFunctionCast } from "./once.cjs";
+import { RunParallelOptions, runParallel } from "./parallel.cjs";
 import { pick } from "./pick.cjs";
 import { characterMap, removeAccents } from "./remove-accents.cjs";
 import { removeEmptyItems } from "./remove-empty-items.cjs";
@@ -29,4 +30,4 @@ import { toPath } from "./to-path.cjs";
 import { unflattenObject } from "./unflatten-object.cjs";
 import { union } from "./union.cjs";
 import { withTimeout } from "./with-timeout.cjs";
-export { DebounceOptions, DeepMergeOptions, GetField, KeyAttributes, KeyAttributesOptions, KeyOption, LRUCache, MatchSorterOptions, Mutex, RankingInfo, Resolved, Semaphore, ValueGetterKey, addPathToDeepKey, argIdentity, asyncNoop, characterMap, debounce, deepClone, deepMerge, defaultBaseSortFn, delay, filterEmpty, flattenObject, getField, getOrderedBy, getUnique, getUniqueBy, identity, isEqual, matchSorter, memoizeOnId, noop, omit, once, pick, rankings, removeAccents, removeEmptyItems, safeFunctionCast, setField, sleep, throttle, timeout, toDeepKey, toPath, unflattenObject, union, withTimeout };
+export { DebounceOptions, DeepMergeOptions, GetField, KeyAttributes, KeyAttributesOptions, KeyOption, LRUCache, MatchSorterOptions, Mutex, RankingInfo, Resolved, RunParallelOptions, Semaphore, ValueGetterKey, addPathToDeepKey, argIdentity, asyncNoop, characterMap, debounce, deepClone, deepMerge, defaultBaseSortFn, delay, filterEmpty, flattenObject, getField, getOrderedBy, getUnique, getUniqueBy, identity, isEqual, matchSorter, memoizeOnId, noop, omit, once, pick, rankings, removeAccents, removeEmptyItems, runParallel, safeFunctionCast, setField, sleep, throttle, timeout, toDeepKey, toPath, unflattenObject, union, withTimeout };

package/dist/index.d.mts

@@ -17,6 +17,7 @@ import { Mutex } from "./mutex.mjs";
 import { asyncNoop, noop } from "./noop.mjs";
 import { omit } from "./omit.mjs";
 import { once, safeFunctionCast } from "./once.mjs";
+import { RunParallelOptions, runParallel } from "./parallel.mjs";
 import { pick } from "./pick.mjs";
 import { characterMap, removeAccents } from "./remove-accents.mjs";
 import { removeEmptyItems } from "./remove-empty-items.mjs";
@@ -29,4 +30,4 @@ import { toPath } from "./to-path.mjs";
 import { unflattenObject } from "./unflatten-object.mjs";
 import { union } from "./union.mjs";
 import { withTimeout } from "./with-timeout.mjs";
-export { DebounceOptions, DeepMergeOptions, GetField, KeyAttributes, KeyAttributesOptions, KeyOption, LRUCache, MatchSorterOptions, Mutex, RankingInfo, Resolved, Semaphore, ValueGetterKey, addPathToDeepKey, argIdentity, asyncNoop, characterMap, debounce, deepClone, deepMerge, defaultBaseSortFn, delay, filterEmpty, flattenObject, getField, getOrderedBy, getUnique, getUniqueBy, identity, isEqual, matchSorter, memoizeOnId, noop, omit, once, pick, rankings, removeAccents, removeEmptyItems, safeFunctionCast, setField, sleep, throttle, timeout, toDeepKey, toPath, unflattenObject, union, withTimeout };
+export { DebounceOptions, DeepMergeOptions, GetField, KeyAttributes, KeyAttributesOptions, KeyOption, LRUCache, MatchSorterOptions, Mutex, RankingInfo, Resolved, RunParallelOptions, Semaphore, ValueGetterKey, addPathToDeepKey, argIdentity, asyncNoop, characterMap, debounce, deepClone, deepMerge, defaultBaseSortFn, delay, filterEmpty, flattenObject, getField, getOrderedBy, getUnique, getUniqueBy, identity, isEqual, matchSorter, memoizeOnId, noop, omit, once, pick, rankings, removeAccents, removeEmptyItems, runParallel, safeFunctionCast, setField, sleep, throttle, timeout, toDeepKey, toPath, unflattenObject, union, withTimeout };

package/dist/index.mjs

@@ -20,6 +20,7 @@ import { Mutex } from "./mutex.mjs";
 import { asyncNoop, noop } from "./noop.mjs";
 import { omit } from "./omit.mjs";
 import { once, safeFunctionCast } from "./once.mjs";
+import { runParallel } from "./parallel.mjs";
 import { pick } from "./pick.mjs";
 import { removeEmptyItems } from "./remove-empty-items.mjs";
 import { setField } from "./set-field.mjs";
@@ -30,4 +31,4 @@ import { unflattenObject } from "./unflatten-object.mjs";
 import { union } from "./union.mjs";
 import { withTimeout } from "./with-timeout.mjs";
 
-export { LRUCache, Mutex, Semaphore, addPathToDeepKey, argIdentity, asyncNoop, characterMap, debounce, deepClone, deepMerge, defaultBaseSortFn, delay, filterEmpty, flattenObject, getField, getOrderedBy, getUnique, getUniqueBy, identity, isEqual, matchSorter, memoizeOnId, noop, omit, once, pick, rankings, removeAccents, removeEmptyItems, safeFunctionCast, setField, sleep, throttle, timeout, toDeepKey, toPath, unflattenObject, union, withTimeout };
+export { LRUCache, Mutex, Semaphore, addPathToDeepKey, argIdentity, asyncNoop, characterMap, debounce, deepClone, deepMerge, defaultBaseSortFn, delay, filterEmpty, flattenObject, getField, getOrderedBy, getUnique, getUniqueBy, identity, isEqual, matchSorter, memoizeOnId, noop, omit, once, pick, rankings, removeAccents, removeEmptyItems, runParallel, safeFunctionCast, setField, sleep, throttle, timeout, toDeepKey, toPath, unflattenObject, union, withTimeout };

package/dist/parallel.cjs

@@ -0,0 +1,39 @@
+
+//#region src/parallel.ts
+/**
+* Executes a callback function on a set of inputs in parallel, with a specified concurrency limit and optional interval between task executions.
+*
+* @param inputs - A set of inputs to process.
+* @param cb - A callback function that takes an input and returns a value or a promise. This function will be executed for each input in the set.
+* @param options - An object containing options for the parallel execution
+* @returns A promise that resolves to an object containing an array of errors that occurred during the execution of the tasks. If no errors occurred, the array will be empty.
+*/
+async function runParallel(inputs, cb, options) {
+	const errors = [];
+	const tasks = /* @__PURE__ */ new Set();
+	function queueNext() {
+		const route = inputs.values().next().value;
+		if (!route) return;
+		inputs.delete(route);
+		const task = (options.interval ? new Promise((resolve) => {
+			setTimeout(resolve, options.interval);
+		}) : Promise.resolve()).then(() => cb(route)).catch((error) => {
+			console.error(error);
+			errors.push(error);
+		});
+		tasks.add(task);
+		return task.then(async () => {
+			tasks.delete(task);
+			if (inputs.size > 0) return refillQueue();
+		});
+	}
+	async function refillQueue() {
+		const workers = Math.min(options.concurrency - tasks.size, inputs.size);
+		return Promise.all(Array.from({ length: workers }, async () => queueNext()));
+	}
+	await refillQueue();
+	return { errors };
+}
+
+//#endregion
+exports.runParallel = runParallel;

package/dist/parallel.d.cts

@@ -0,0 +1,25 @@
+//#region src/parallel.d.ts
+interface RunParallelOptions {
+  /**
+   * The maximum number of tasks to run concurrently. This option is required and must be a positive integer.
+   */
+  concurrency: number;
+  /**
+   * An optional interval (in milliseconds) to wait between the execution of each task. If specified, the function will wait for the specified interval before starting the next task. If not specified, tasks will be executed immediately one after another without any delay.
+   */
+  interval?: number;
+}
+/**
+ * Executes a callback function on a set of inputs in parallel, with a specified concurrency limit and optional interval between task executions.
+ *
+ * @param inputs - A set of inputs to process.
+ * @param cb - A callback function that takes an input and returns a value or a promise. This function will be executed for each input in the set.
+ * @param options - An object containing options for the parallel execution
+ * @returns A promise that resolves to an object containing an array of errors that occurred during the execution of the tasks. If no errors occurred, the array will be empty.
+ */
+declare function runParallel<T>(inputs: Set<T>, cb: (input: T) => unknown | Promise<unknown>, options: RunParallelOptions): Promise<{
+  errors: unknown[];
+}>;
+//#endregion
+export { RunParallelOptions, runParallel };
+//# sourceMappingURL=parallel.d.cts.map

package/dist/parallel.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.cts","names":[],"sources":["../src/parallel.ts"],"sourcesContent":[],"mappings":";UAkBiB,kBAAA;EAAA;AAmBjB;;EACU,WAAA,EAAA,MAAA;EACI;;;EAEX,QAAA,CAAA,EAAA,MAAA;;;;;;;;;;iBAJmB,uBACZ,IAAI,gBACA,gBAAgB,2BACnB,qBACR"}

package/dist/parallel.d.mts

@@ -0,0 +1,25 @@
+//#region src/parallel.d.ts
+interface RunParallelOptions {
+  /**
+   * The maximum number of tasks to run concurrently. This option is required and must be a positive integer.
+   */
+  concurrency: number;
+  /**
+   * An optional interval (in milliseconds) to wait between the execution of each task. If specified, the function will wait for the specified interval before starting the next task. If not specified, tasks will be executed immediately one after another without any delay.
+   */
+  interval?: number;
+}
+/**
+ * Executes a callback function on a set of inputs in parallel, with a specified concurrency limit and optional interval between task executions.
+ *
+ * @param inputs - A set of inputs to process.
+ * @param cb - A callback function that takes an input and returns a value or a promise. This function will be executed for each input in the set.
+ * @param options - An object containing options for the parallel execution
+ * @returns A promise that resolves to an object containing an array of errors that occurred during the execution of the tasks. If no errors occurred, the array will be empty.
+ */
+declare function runParallel<T>(inputs: Set<T>, cb: (input: T) => unknown | Promise<unknown>, options: RunParallelOptions): Promise<{
+  errors: unknown[];
+}>;
+//#endregion
+export { RunParallelOptions, runParallel };
+//# sourceMappingURL=parallel.d.mts.map

package/dist/parallel.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.mts","names":[],"sources":["../src/parallel.ts"],"sourcesContent":[],"mappings":";UAkBiB,kBAAA;EAAA;AAmBjB;;EACU,WAAA,EAAA,MAAA;EACI;;;EAEX,QAAA,CAAA,EAAA,MAAA;;;;;;;;;;iBAJmB,uBACZ,IAAI,gBACA,gBAAgB,2BACnB,qBACR"}

package/dist/parallel.mjs

@@ -0,0 +1,39 @@
+//#region src/parallel.ts
+/**
+* Executes a callback function on a set of inputs in parallel, with a specified concurrency limit and optional interval between task executions.
+*
+* @param inputs - A set of inputs to process.
+* @param cb - A callback function that takes an input and returns a value or a promise. This function will be executed for each input in the set.
+* @param options - An object containing options for the parallel execution
+* @returns A promise that resolves to an object containing an array of errors that occurred during the execution of the tasks. If no errors occurred, the array will be empty.
+*/
+async function runParallel(inputs, cb, options) {
+	const errors = [];
+	const tasks = /* @__PURE__ */ new Set();
+	function queueNext() {
+		const route = inputs.values().next().value;
+		if (!route) return;
+		inputs.delete(route);
+		const task = (options.interval ? new Promise((resolve) => {
+			setTimeout(resolve, options.interval);
+		}) : Promise.resolve()).then(() => cb(route)).catch((error) => {
+			console.error(error);
+			errors.push(error);
+		});
+		tasks.add(task);
+		return task.then(async () => {
+			tasks.delete(task);
+			if (inputs.size > 0) return refillQueue();
+		});
+	}
+	async function refillQueue() {
+		const workers = Math.min(options.concurrency - tasks.size, inputs.size);
+		return Promise.all(Array.from({ length: workers }, async () => queueNext()));
+	}
+	await refillQueue();
+	return { errors };
+}
+
+//#endregion
+export { runParallel };
+//# sourceMappingURL=parallel.mjs.map

package/dist/parallel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.mjs","names":["errors: unknown[]"],"sources":["../src/parallel.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport interface RunParallelOptions {\n  /**\n   * The maximum number of tasks to run concurrently. This option is required and must be a positive integer.\n   */\n  concurrency: number;\n  /**\n   * An optional interval (in milliseconds) to wait between the execution of each task. If specified, the function will wait for the specified interval before starting the next task. If not specified, tasks will be executed immediately one after another without any delay.\n   */\n  interval?: number;\n}\n\n/**\n * Executes a callback function on a set of inputs in parallel, with a specified concurrency limit and optional interval between task executions.\n *\n * @param inputs - A set of inputs to process.\n * @param cb - A callback function that takes an input and returns a value or a promise. This function will be executed for each input in the set.\n * @param options - An object containing options for the parallel execution\n * @returns A promise that resolves to an object containing an array of errors that occurred during the execution of the tasks. If no errors occurred, the array will be empty.\n */\nexport async function runParallel<T>(\n  inputs: Set<T>,\n  cb: (input: T) => unknown | Promise<unknown>,\n  options: RunParallelOptions\n): Promise<{ errors: unknown[] }> {\n  const errors: unknown[] = [];\n  const tasks = new Set<Promise<unknown>>();\n\n  function queueNext(): undefined | Promise<unknown> {\n    const route = inputs.values().next().value;\n    if (!route) {\n      return;\n    }\n\n    inputs.delete(route);\n    const task = (\n      options.interval\n        ? new Promise(resolve => {\n            setTimeout(resolve, options.interval);\n          })\n        : Promise.resolve()\n    )\n      .then(() => cb(route))\n      .catch(error => {\n        // eslint-disable-next-line no-console\n        console.error(error);\n        errors.push(error);\n      });\n\n    tasks.add(task);\n    return task.then(async () => {\n      tasks.delete(task);\n      if (inputs.size > 0) {\n        return refillQueue();\n      }\n\n      return void 0;\n    });\n  }\n\n  async function refillQueue(): Promise<unknown> {\n    const workers = Math.min(options.concurrency - tasks.size, inputs.size);\n\n    return Promise.all(\n      Array.from({ length: workers }, async () => queueNext())\n    );\n  }\n\n  await refillQueue();\n  return { errors };\n}\n"],"mappings":";;;;;;;;;AAqCA,eAAsB,YACpB,QACA,IACA,SACgC;CAChC,MAAMA,SAAoB,EAAE;CAC5B,MAAM,wBAAQ,IAAI,KAAuB;CAEzC,SAAS,YAA0C;EACjD,MAAM,QAAQ,OAAO,QAAQ,CAAC,MAAM,CAAC;AACrC,MAAI,CAAC,MACH;AAGF,SAAO,OAAO,MAAM;EACpB,MAAM,QACJ,QAAQ,WACJ,IAAI,SAAQ,YAAW;AACrB,cAAW,SAAS,QAAQ,SAAS;IACrC,GACF,QAAQ,SAAS,EAEpB,WAAW,GAAG,MAAM,CAAC,CACrB,OAAM,UAAS;AAEd,WAAQ,MAAM,MAAM;AACpB,UAAO,KAAK,MAAM;IAClB;AAEJ,QAAM,IAAI,KAAK;AACf,SAAO,KAAK,KAAK,YAAY;AAC3B,SAAM,OAAO,KAAK;AAClB,OAAI,OAAO,OAAO,EAChB,QAAO,aAAa;IAItB;;CAGJ,eAAe,cAAgC;EAC7C,MAAM,UAAU,KAAK,IAAI,QAAQ,cAAc,MAAM,MAAM,OAAO,KAAK;AAEvE,SAAO,QAAQ,IACb,MAAM,KAAK,EAAE,QAAQ,SAAS,EAAE,YAAY,WAAW,CAAC,CACzD;;AAGH,OAAM,aAAa;AACnB,QAAO,EAAE,QAAQ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stryke/helpers",
-  "version": "0.9.48",
+  "version": "0.10.0",
   "type": "module",
   "description": "A package containing miscellaneous helper functions that are used across many different Storm Software projects.",
   "repository": {
@@ -78,6 +78,10 @@
     "./noop": { "require": "./dist/noop.cjs", "import": "./dist/noop.mjs" },
     "./omit": { "require": "./dist/omit.cjs", "import": "./dist/omit.mjs" },
     "./once": { "require": "./dist/once.cjs", "import": "./dist/once.mjs" },
+    "./parallel": {
+      "require": "./dist/parallel.cjs",
+      "import": "./dist/parallel.mjs"
+    },
     "./pick": { "require": "./dist/pick.cjs", "import": "./dist/pick.mjs" },
     "./remove-accents": {
       "require": "./dist/remove-accents.cjs",
@@ -125,5 +129,5 @@
   "types": "./dist/index.d.cts",
   "devDependencies": { "tsdown": "^0.17.2" },
   "publishConfig": { "access": "public" },
-  "gitHead": "7d12d78184a0812114d762186fe34f82d9e9083d"
+  "gitHead": "ddf54318bd81f6321233db8cfef8b991eb161413"
 }