@zajno/common 1.6.1 → 1.6.3

package/coverage/lcov-report/viewModels/index.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">77.91% </span>
+                <span class="strong">95.24% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>127/163</span>
+                <span class='fraction'>20/21</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">59.32% </span>
+                <span class="strong">87.5% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>35/59</span>
+                <span class='fraction'>7/8</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">65% </span>
+                <span class="strong">85.71% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>39/60</span>
+                <span class='fraction'>6/7</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">78.29% </span>
+                <span class="strong">100% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>119/152</span>
+                <span class='fraction'>20/20</span>
             </div>
         
             
@@ -54,8 +54,14 @@
         <p class="quiet">
             Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
         </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input oninput="onInput()" type="search" id="fileSearch">
+            </div>
+        </template>
     </div>
-    <div class='status-line medium'></div>
+    <div class='status-line high'></div>
     <div class="pad1">
 <table class="coverage-summary">
 <thead>
@@ -73,65 +79,20 @@
 </tr>
 </thead>
 <tbody><tr>
-	<td class="file high" data-value="CommonModel.ts"><a href="CommonModel.ts.html">CommonModel.ts</a></td>
-	<td data-value="100" class="pic high">
-	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
-	</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="19" class="abs high">19/19</td>
-	<td data-value="50" class="pct medium">50%</td>
-	<td data-value="8" class="abs medium">4/8</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="6" class="abs high">6/6</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="19" class="abs high">19/19</td>
-	</tr>
-
-<tr>
 	<td class="file high" data-value="LoadingModel.ts"><a href="LoadingModel.ts.html">LoadingModel.ts</a></td>
 	<td data-value="95.24" class="pic high">
 	<div class="chart"><div class="cover-fill" style="width: 95%"></div><div class="cover-empty" style="width: 5%"></div></div>
 	</td>
 	<td data-value="95.24" class="pct high">95.24%</td>
 	<td data-value="21" class="abs high">20/21</td>
-	<td data-value="90" class="pct high">90%</td>
-	<td data-value="10" class="abs high">9/10</td>
+	<td data-value="87.5" class="pct high">87.5%</td>
+	<td data-value="8" class="abs high">7/8</td>
 	<td data-value="85.71" class="pct high">85.71%</td>
 	<td data-value="7" class="abs high">6/7</td>
 	<td data-value="100" class="pct high">100%</td>
 	<td data-value="20" class="abs high">20/20</td>
 	</tr>
 
-<tr>
-	<td class="file high" data-value="SelectModel.ts"><a href="SelectModel.ts.html">SelectModel.ts</a></td>
-	<td data-value="90.91" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 90%"></div><div class="cover-empty" style="width: 10%"></div></div>
-	</td>
-	<td data-value="90.91" class="pct high">90.91%</td>
-	<td data-value="66" class="abs high">60/66</td>
-	<td data-value="83.33" class="pct high">83.33%</td>
-	<td data-value="18" class="abs high">15/18</td>
-	<td data-value="84.62" class="pct high">84.62%</td>
-	<td data-value="26" class="abs high">22/26</td>
-	<td data-value="90.16" class="pct high">90.16%</td>
-	<td data-value="61" class="abs high">55/61</td>
-	</tr>
-
-<tr>
-	<td class="file low" data-value="TextModel.ts"><a href="TextModel.ts.html">TextModel.ts</a></td>
-	<td data-value="49.12" class="pic low">
-	<div class="chart"><div class="cover-fill" style="width: 49%"></div><div class="cover-empty" style="width: 51%"></div></div>
-	</td>
-	<td data-value="49.12" class="pct low">49.12%</td>
-	<td data-value="57" class="abs low">28/57</td>
-	<td data-value="30.43" class="pct low">30.43%</td>
-	<td data-value="23" class="abs low">7/23</td>
-	<td data-value="23.81" class="pct low">23.81%</td>
-	<td data-value="21" class="abs low">5/21</td>
-	<td data-value="48.08" class="pct low">48.08%</td>
-	<td data-value="52" class="abs low">25/52</td>
-	</tr>
-
 </tbody>
 </table>
 </div>
@@ -139,10 +100,9 @@
             </div><!-- /wrapper -->
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
-                <a href="https://istanbul.js.org/" target="_blank">istanbul</a>
-                at Sat Jun 04 2022 17:01:00 GMT+0000 (Coordinated Universal Time)
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at 2022-10-29T12:13:47.151Z
             </div>
-        </div>
         <script src="../prettify.js"></script>
         <script>
             window.onload = function () {

package/coverage/lcov.info

@@ -518,15 +518,15 @@ SF:src/functions.ts
 FN:10,safeCall
 FNF:1
 FNH:1
-FNDA:17,safeCall
-DA:10,1
-DA:11,17
-DA:12,0
+FNDA:21,safeCall
+DA:10,2
+DA:11,21
+DA:12,3
 LF:3
-LH:2
-BRDA:11,0,0,0
+LH:3
+BRDA:11,0,0,3
 BRF:1
-BRH:0
+BRH:1
 end_of_record
 TN:
 SF:src/observersMap.ts
@@ -1101,9 +1101,9 @@ FN:75,(anonymous_12)
 FN:79,(anonymous_13)
 FNF:14
 FNH:10
-FNDA:18,setTimeoutAsync
-FNDA:18,(anonymous_1)
-FNDA:18,(anonymous_2)
+FNDA:22,setTimeoutAsync
+FNDA:22,(anonymous_1)
+FNDA:22,(anonymous_2)
 FNDA:0,(anonymous_3)
 FNDA:0,setTimeoutFramesAsync
 FNDA:0,(anonymous_5)
@@ -1115,23 +1115,23 @@ FNDA:4,(anonymous_10)
 FNDA:3,(anonymous_11)
 FNDA:1,(anonymous_12)
 FNDA:3,(anonymous_13)
-DA:2,6
-DA:3,18
-DA:6,18
-DA:7,18
-DA:8,18
-DA:9,18
-DA:10,18
-DA:11,18
-DA:16,18
+DA:2,7
+DA:3,22
+DA:6,22
+DA:7,22
+DA:8,22
+DA:9,22
+DA:10,22
+DA:11,22
+DA:16,22
 DA:17,0
 DA:18,0
 DA:19,0
 DA:20,0
 DA:21,0
 DA:24,0
-DA:27,18
-DA:32,6
+DA:27,22
+DA:32,7
 DA:33,0
 DA:34,0
 DA:37,0
@@ -1141,7 +1141,7 @@ DA:41,0
 DA:42,0
 DA:44,0
 DA:48,0
-DA:52,6
+DA:52,7
 DA:53,3
 DA:55,3
 DA:56,3
@@ -1162,8 +1162,8 @@ DA:80,3
 DA:81,3
 LF:45
 LH:30
-BRDA:2,0,0,18
-BRDA:10,1,0,18
+BRDA:2,0,0,22
+BRDA:10,1,0,22
 BRDA:16,2,0,0
 BRDA:20,3,0,0
 BRDA:33,4,0,0
@@ -3135,6 +3135,94 @@ BRF:54
 BRH:24
 end_of_record
 TN:
+SF:src/queue/tasks.ts
+FN:17,(anonymous_0)
+FN:64,(anonymous_1)
+FN:78,(anonymous_2)
+FN:23,(anonymous_3)
+FN:24,(anonymous_4)
+FN:26,(anonymous_5)
+FN:31,(anonymous_6)
+FN:44,(anonymous_7)
+FN:45,(anonymous_8)
+FNF:9
+FNH:8
+FNDA:6,(anonymous_0)
+FNDA:4,(anonymous_1)
+FNDA:4,(anonymous_2)
+FNDA:9,(anonymous_3)
+FNDA:6,(anonymous_4)
+FNDA:0,(anonymous_5)
+FNDA:5,(anonymous_6)
+FNDA:2,(anonymous_7)
+FNDA:2,(anonymous_8)
+DA:11,1
+DA:13,6
+DA:14,6
+DA:15,6
+DA:17,6
+DA:18,6
+DA:19,2
+DA:23,9
+DA:24,6
+DA:27,0
+DA:28,0
+DA:32,5
+DA:33,1
+DA:36,4
+DA:38,2
+DA:44,2
+DA:45,2
+DA:46,2
+DA:47,2
+DA:48,2
+DA:49,2
+DA:51,0
+DA:52,0
+DA:57,2
+DA:58,2
+DA:61,2
+DA:64,6
+DA:65,4
+DA:66,4
+DA:67,4
+DA:68,4
+DA:70,0
+DA:71,0
+DA:73,4
+DA:74,4
+DA:78,6
+DA:79,4
+DA:80,2
+DA:83,2
+DA:84,2
+DA:85,0
+DA:88,2
+LF:42
+LH:35
+BRDA:70,0,0,0
+BRDA:70,0,1,0
+BRDA:70,1,0,0
+BRDA:70,1,1,0
+BRDA:70,2,0,0
+BRDA:70,2,1,0
+BRDA:70,2,2,0
+BRDA:79,3,0,2
+BRDA:79,4,0,4
+BRDA:79,4,1,2
+BRDA:84,5,0,0
+BRDA:84,6,0,2
+BRDA:84,6,1,2
+BRDA:84,6,2,2
+BRDA:18,7,0,2
+BRDA:18,8,0,6
+BRDA:18,8,1,5
+BRDA:32,9,0,1
+BRDA:36,10,0,2
+BRF:19
+BRH:11
+end_of_record
+TN:
 SF:src/validation/ValidationErrors.ts
 FN:3,(anonymous_0)
 FN:24,(anonymous_1)

package/lib/assert.d.ts

@@ -0,0 +1,3 @@
+import { Getter } from './types';
+export declare function assert(condition: boolean, error: Getter<string | Error>, objectToLog?: Getter<any>): asserts condition;
+//# sourceMappingURL=assert.d.ts.map

package/lib/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../src/assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,SAAS,CAetH"}

package/lib/assert.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assert = void 0;
+const tslib_1 = require("tslib");
+const types_1 = require("./types");
+const logger_1 = tslib_1.__importDefault(require("./logger"));
+function assert(condition, error, objectToLog) {
+    if (condition) {
+        return;
+    }
+    const e = types_1.Getter.getValue(error);
+    if (objectToLog) {
+        logger_1.default.error('Assertion failed:', e, types_1.Getter.getValue(objectToLog));
+    }
+    if (typeof e === 'string') {
+        throw new Error(e);
+    }
+    throw e;
+}
+exports.assert = assert;
+//# sourceMappingURL=assert.js.map

package/lib/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../src/assert.ts"],"names":[],"mappings":";;;;AAAA,mCAAiC;AACjC,8DAA8B;AAE9B,SAAgB,MAAM,CAAC,SAAkB,EAAE,KAA6B,EAAE,WAAyB;IAC/F,IAAI,SAAS,EAAE;QACX,OAAO;KACV;IAED,MAAM,CAAC,GAAG,cAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,WAAW,EAAE;QACb,gBAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,EAAE,cAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;KACtE;IAED,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE;QACvB,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;KACtB;IAED,MAAM,CAAC,CAAC;AACZ,CAAC;AAfD,wBAeC"}

package/lib/queue/tasks.d.ts

@@ -0,0 +1,17 @@
+import type { ILogger } from '../logger';
+declare type Factory<T> = () => Promise<T>;
+export declare class TasksQueue<T> {
+    readonly limit: number;
+    private readonly _items;
+    private _running;
+    private _logger;
+    constructor(limit: number);
+    get isFull(): boolean;
+    get running(): number;
+    addLogger(logger: ILogger): this;
+    enqueue(factory: Factory<T>, name?: string): Promise<T>;
+    private _runFactory;
+    private _tryRunNext;
+}
+export {};
+//# sourceMappingURL=tasks.d.ts.map

package/lib/queue/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/queue/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,aAAK,OAAO,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAQnC,qBAAa,UAAU,CAAC,CAAC;IAMT,QAAQ,CAAC,KAAK,EAAE,MAAM;IAJlC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAAwB;gBAElB,KAAK,EAAE,MAAM;IAMlC,IAAW,MAAM,YAA0C;IAC3D,IAAW,OAAO,WAA4B;IAE9C,SAAS,CAAC,MAAM,EAAE,OAAO;IAKlB,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAiC9D,OAAO,CAAC,WAAW,CAYjB;IAEF,OAAO,CAAC,WAAW,CAWjB;CAEL"}

package/lib/queue/tasks.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TasksQueue = void 0;
+class TasksQueue {
+    constructor(limit) {
+        this.limit = limit;
+        this._items = [];
+        this._running = 0;
+        this._logger = null;
+        this._runFactory = async (factory, name) => {
+            var _a;
+            this._running++;
+            try {
+                const result = await factory();
+                return result;
+            }
+            catch (err) {
+                (_a = this._logger) === null || _a === void 0 ? void 0 : _a.warn(`Factory "${name || factory.name || '<unknown>'}" thrown. Rethrowing...`);
+                throw err;
+            }
+            finally {
+                this._running--;
+                this._tryRunNext();
+            }
+        };
+        this._tryRunNext = async () => {
+            if (!this._items.length || this.isFull) {
+                return;
+            }
+            const next = this._items.shift();
+            if (!next || !next.finish || !next.factory) {
+                return;
+            }
+            await next.finish(this._runFactory(next.factory));
+        };
+        if (!limit || limit < 0) {
+            throw new Error('TasksQueue: limit should be a positive number');
+        }
+    }
+    get isFull() { return this._running >= this.limit; }
+    get running() { return this._running; }
+    addLogger(logger) {
+        this._logger = logger;
+        return this;
+    }
+    enqueue(factory, name) {
+        if (typeof factory !== 'function') {
+            throw new Error('Invalid arg: factory not a function');
+        }
+        if (this.isFull) {
+            const item = {
+                factory,
+                finish: undefined,
+                name,
+            };
+            const waitPromise = new Promise((resolve, reject) => {
+                item.finish = async (res) => {
+                    try {
+                        const rr = await res;
+                        resolve(rr);
+                        return rr;
+                    }
+                    catch (err) {
+                        reject(err);
+                        throw err;
+                    }
+                };
+            });
+            this._items.push(item);
+            return waitPromise;
+        }
+        return this._runFactory(factory);
+    }
+}
+exports.TasksQueue = TasksQueue;
+//# sourceMappingURL=tasks.js.map

package/lib/queue/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/queue/tasks.ts"],"names":[],"mappings":";;;AAUA,MAAa,UAAU;IAMnB,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;QAJjB,WAAM,GAAmB,EAAE,CAAC;QACrC,aAAQ,GAAG,CAAC,CAAC;QACb,YAAO,GAAmB,IAAI,CAAC;QAiD/B,gBAAW,GAAG,KAAK,EAAE,OAAmB,EAAE,IAAa,EAAc,EAAE;;YAC3E,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI;gBACA,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC;aACjB;YAAC,OAAO,GAAG,EAAE;gBACV,MAAA,IAAI,CAAC,OAAO,0CAAE,IAAI,CAAC,YAAY,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,WAAW,yBAAyB,CAAC,CAAC;gBAC7F,MAAM,GAAG,CAAC;aACb;oBAAS;gBACN,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,IAAI,CAAC,WAAW,EAAE,CAAC;aACtB;QACL,CAAC,CAAC;QAEM,gBAAW,GAAG,KAAK,IAAI,EAAE;YAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE;gBACpC,OAAO;aACV;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;gBACxC,OAAO;aACV;YAED,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC;QAvEE,IAAI,CAAC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;SACpE;IACL,CAAC;IAED,IAAW,MAAM,KAAK,OAAO,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,IAAW,OAAO,KAAK,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE9C,SAAS,CAAC,MAAe;QACrB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,OAAO,CAAC,OAAmB,EAAE,IAAa;QAC7C,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE;YAC/B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;SAC1D;QAED,IAAI,IAAI,CAAC,MAAM,EAAE;YAEb,MAAM,IAAI,GAAiB;gBACvB,OAAO;gBACP,MAAM,EAAE,SAAS;gBACjB,IAAI;aACP,CAAC;YAEF,MAAM,WAAW,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACnD,IAAI,CAAC,MAAM,GAAG,KAAK,EAAE,GAAG,EAAE,EAAE;oBACxB,IAAI;wBACA,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC;wBACrB,OAAO,CAAC,EAAE,CAAC,CAAC;wBACZ,OAAO,EAAE,CAAC;qBACb;oBAAC,OAAO,GAAG,EAAE;wBACV,MAAM,CAAC,GAAG,CAAC,CAAC;wBACZ,MAAM,GAAG,CAAC;qBACb;gBACL,CAAC,CAAC;YACN,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,OAAO,WAAW,CAAC;SACtB;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;CA6BJ;AAhFD,gCAgFC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zajno/common",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Zajno's re-usable utilities for JS/TS projects",
   "repository": {
     "type": "git",

package/src/assert.ts

@@ -0,0 +1,19 @@
+import { Getter } from './types';
+import logger from './logger';
+
+export function assert(condition: boolean, error: Getter<string | Error>, objectToLog?: Getter<any>): asserts condition {
+    if (condition) {
+        return;
+    }
+
+    const e = Getter.getValue(error);
+    if (objectToLog) {
+        logger.error('Assertion failed:', e, Getter.getValue(objectToLog));
+    }
+
+    if (typeof e === 'string') {
+        throw new Error(e);
+    }
+
+    throw e;
+}

package/src/queue/__tests__/tasks.test.ts

@@ -0,0 +1,87 @@
+import { TasksQueue } from '../tasks';
+import { setTimeoutAsync } from '../../async/timeout';
+import { safeCall } from '../../functions';
+import 'jest-extended';
+
+describe('TasksQueue', () => {
+
+    const createFactory = <T>(res: T, cb?: () => void) => {
+        return async () => {
+            await setTimeoutAsync(50);
+            safeCall(cb);
+            return res;
+        };
+    };
+
+    it('correctly initializes', async () => {
+        const fnZero = async () => {
+            return new TasksQueue(0);
+        };
+        const fnNegative = async () => {
+            return new TasksQueue(-12);
+        };
+        const fnPositive = async () => {
+            return new TasksQueue(12);
+        };
+
+        await expect(fnZero()).rejects.toThrow();
+        await expect(fnNegative()).rejects.toThrow();
+        await expect(fnPositive()).resolves.not.toBeNull();
+
+        const failEnqueue = async () => {
+            const q = new TasksQueue<number>(123);
+            q.enqueue(null as any);
+        };
+
+        await expect(failEnqueue()).rejects.toThrow();
+    });
+
+    it('runs without limit', async () => {
+        const queue = new TasksQueue(5);
+
+        expect(queue.isFull).toBeFalsy();
+        expect(queue.running).toBe(0);
+
+        const val1 = 123;
+
+        const res1 = queue.enqueue(createFactory(val1));
+
+        expect(queue.isFull).toBeFalsy();
+        expect(queue.running).toBe(1);
+
+        await expect(res1).resolves.toBe(val1);
+    });
+
+    it('runs with limit 1', async () => {
+        const queue = new TasksQueue(1);
+
+        const val1 = 123;
+        const cb1 = jest.fn();
+        const res1 = queue.enqueue(createFactory(val1, cb1));
+
+        const val2 = 321;
+        const cb2 = jest.fn();
+        const res2 = queue.enqueue(createFactory(val2, cb2));
+
+        const val3 = 111;
+        const cb3 = jest.fn();
+        const res3 = queue.enqueue(createFactory(val3, cb3));
+
+        expect(queue.isFull).toBeTruthy();
+        expect(queue.running).toBe(1);
+
+        await expect(res1).resolves.toBe(val1);
+        expect(queue.running).toBe(1);
+
+        await expect(res2).resolves.toBe(val2);
+
+        expect(queue.running).toBe(1);
+        await expect(res3).resolves.toBe(val3);
+
+        expect(queue.running).toBe(0);
+
+        expect(cb1).toHaveBeenCalledBefore(cb2);
+        expect(cb2).toHaveBeenCalledBefore(cb3);
+        expect(cb3).toHaveBeenCalled();
+    });
+});

package/src/queue/tasks.ts

@@ -0,0 +1,91 @@
+import type { ILogger } from '../logger';
+
+type Factory<T> = () => Promise<T>;
+
+type QueueItem<T> = {
+    factory: Factory<T>;
+    finish?: (res: Promise<T>) => Promise<T>;
+    name?: string;
+};
+
+export class TasksQueue<T> {
+
+    private readonly _items: QueueItem<T>[] = [];
+    private _running = 0;
+    private _logger: ILogger | null = null;
+
+    constructor(readonly limit: number) {
+        if (!limit || limit < 0) {
+            throw new Error('TasksQueue: limit should be a positive number');
+        }
+    }
+
+    public get isFull() { return this._running >= this.limit; }
+    public get running() { return this._running; }
+
+    addLogger(logger: ILogger) {
+        this._logger = logger;
+        return this;
+    }
+
+    public enqueue(factory: Factory<T>, name?: string): Promise<T> {
+        if (typeof factory !== 'function') {
+            throw new Error('Invalid arg: factory not a function');
+        }
+
+        if (this.isFull) {
+
+            const item: QueueItem<T> = {
+                factory,
+                finish: undefined,
+                name,
+            };
+
+            const waitPromise = new Promise<T>((resolve, reject) => {
+                item.finish = async (res) => {
+                    try {
+                        const rr = await res;
+                        resolve(rr);
+                        return rr;
+                    } catch (err) {
+                        reject(err);
+                        throw err;
+                    }
+                };
+            });
+
+            this._items.push(item);
+            return waitPromise;
+        }
+
+        return this._runFactory(factory);
+    }
+
+    private _runFactory = async (factory: Factory<T>, name?: string): Promise<T> => {
+        this._running++;
+        try {
+            const result = await factory();
+            return result;
+        } catch (err) {
+            this._logger?.warn(`Factory "${name || factory.name || '<unknown>'}" thrown. Rethrowing...`);
+            throw err;
+        } finally {
+            this._running--;
+            this._tryRunNext();
+        }
+    };
+
+    private _tryRunNext = async () => {
+        if (!this._items.length || this.isFull) {
+            return;
+        }
+
+        const next = this._items.shift();
+        if (!next || !next.finish || !next.factory) {
+            return;
+        }
+
+        await next.finish(this._runFactory(next.factory));
+    };
+
+}