@squiz/optimization-utils 4.8.0 → 4.9.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './types/class-utilities-types';
 export * from './retries/Retries';
+export * from './promises/PromiseMaxConcurrency';
 export * from './object/getProperty';
 export * from './metadata/CopyReflection';
 export * from './measurement/performance';

package/dist/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types/class-utilities-types"), exports);
 __exportStar(require("./retries/Retries"), exports);
+__exportStar(require("./promises/PromiseMaxConcurrency"), exports);
 __exportStar(require("./object/getProperty"), exports);
 __exportStar(require("./metadata/CopyReflection"), exports);
 __exportStar(require("./measurement/performance"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,oDAAkC;AAClC,uDAAqC;AACrC,4DAA0C;AAC1C,4DAA0C;AAC1C,gDAA8B;AAC9B,2DAAyC;AACzC,iEAA+C;AAC/C,mDAAiC;AACjC,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,oDAAkC;AAClC,mEAAiD;AACjD,uDAAqC;AACrC,4DAA0C;AAC1C,4DAA0C;AAC1C,gDAA8B;AAC9B,2DAAyC;AACzC,iEAA+C;AAC/C,mDAAiC;AACjC,iDAA+B"}

package/dist/promises/PromiseMaxConcurrency.d.ts

@@ -0,0 +1,24 @@
+export type MaxConcurrencyOptions = {
+    maxConcurrency: number;
+};
+/**
+ * A utility class that executes promises with controlled concurrency.
+ * This class helps to limit the number of promises running simultaneously,
+ * preventing potential memory or performance issues when dealing with large arrays.
+ */
+export declare class PromiseMaxConcurrency<T> {
+    private readonly items;
+    private options;
+    /**
+     * Creates a new instance of PromiseMaxConcurrency.
+     * @param items - Array of items to process
+     * @param options - Configuration options for controlling concurrency
+     * @param options.maxConcurrency - Maximum number of promises to run simultaneously (defaults to 3)
+     */
+    constructor(items: Array<T>, options?: MaxConcurrencyOptions);
+    handle<R>(handler: (value: T, index: number, array: Array<T>) => Promise<R>): Promise<Array<R>>;
+}
+export declare class PromiseMaxConcurrencyFactory {
+    constructor();
+    create<T>(items: Array<T>, options?: MaxConcurrencyOptions): PromiseMaxConcurrency<T>;
+}

package/dist/promises/PromiseMaxConcurrency.js

@@ -0,0 +1,67 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromiseMaxConcurrencyFactory = exports.PromiseMaxConcurrency = void 0;
+const inversify_1 = require("inversify");
+/**
+ * A utility class that executes promises with controlled concurrency.
+ * This class helps to limit the number of promises running simultaneously,
+ * preventing potential memory or performance issues when dealing with large arrays.
+ */
+let PromiseMaxConcurrency = class PromiseMaxConcurrency {
+    items;
+    options;
+    /**
+     * Creates a new instance of PromiseMaxConcurrency.
+     * @param items - Array of items to process
+     * @param options - Configuration options for controlling concurrency
+     * @param options.maxConcurrency - Maximum number of promises to run simultaneously (defaults to 3)
+     */
+    constructor(items, options) {
+        this.items = items;
+        this.options = options ?? {
+            maxConcurrency: 3,
+        };
+    }
+    async handle(handler) {
+        let promises = [];
+        const results = [];
+        const maxConcurrency = this.options.maxConcurrency;
+        for (let i = 0; i < this.items.length; i++) {
+            promises.push(handler(this.items[i], i, this.items));
+            if (promises.length === maxConcurrency) {
+                const result = await Promise.all(promises);
+                results.push(...result);
+                promises = [];
+            }
+        }
+        const result = await Promise.all(promises);
+        results.push(...result);
+        return results;
+    }
+};
+exports.PromiseMaxConcurrency = PromiseMaxConcurrency;
+exports.PromiseMaxConcurrency = PromiseMaxConcurrency = __decorate([
+    (0, inversify_1.injectable)(),
+    __metadata("design:paramtypes", [Array, Object])
+], PromiseMaxConcurrency);
+let PromiseMaxConcurrencyFactory = class PromiseMaxConcurrencyFactory {
+    constructor() { }
+    create(items, options) {
+        return new PromiseMaxConcurrency(items, options);
+    }
+};
+exports.PromiseMaxConcurrencyFactory = PromiseMaxConcurrencyFactory;
+exports.PromiseMaxConcurrencyFactory = PromiseMaxConcurrencyFactory = __decorate([
+    (0, inversify_1.injectable)(),
+    __metadata("design:paramtypes", [])
+], PromiseMaxConcurrencyFactory);
+//# sourceMappingURL=PromiseMaxConcurrency.js.map

package/dist/promises/PromiseMaxConcurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromiseMaxConcurrency.js","sourceRoot":"","sources":["../../src/promises/PromiseMaxConcurrency.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAuC;AAMvC;;;;GAIG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAUb;IATX,OAAO,CAAwB;IAEvC;;;;;OAKG;IACH,YACmB,KAAe,EAChC,OAA+B;QADd,UAAK,GAAL,KAAK,CAAU;QAGhC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI;YACxB,cAAc,EAAE,CAAC;SAClB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,OAAiE;QAEjE,IAAI,QAAQ,GAAsB,EAAE,CAAC;QACrC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QAEnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAErD,IAAI,QAAQ,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;gBACvC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAE3C,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;gBACxB,QAAQ,GAAG,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE3C,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAExB,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAA;AA1CY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,sBAAU,GAAE;qCAWe,KAAK;GAVpB,qBAAqB,CA0CjC;AAGM,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IACvC,gBAAe,CAAC;IAEhB,MAAM,CACJ,KAAe,EACf,OAA+B;QAE/B,OAAO,IAAI,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACF,CAAA;AATY,oEAA4B;uCAA5B,4BAA4B;IADxC,IAAA,sBAAU,GAAE;;GACA,4BAA4B,CASxC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squiz/optimization-utils",
-  "version": "4.8.0",
+  "version": "4.9.0",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -34,8 +34,8 @@
   "dependencies": {},
   "devDependencies": {},
   "peerDependencies": {
-    "inversify": "^7.6.1",
-    "@squiz/optimization-logger": "^1.8.2"
+    "inversify": "^7.9.1",
+    "@squiz/optimization-logger": "^1.8.4"
   },
   "author": "",
   "license": "ISC"