@warlock.js/core 2.1.1 → 2.2.1

package/esm/utils/queue.js

@@ -0,0 +1,89 @@
+/**
+ * A utility class for managing a queue of operations.
+ * Allows enqueuing values and executing a function when the queue reaches a certain size or after a specified interval.
+ * Supports both parallel and sequential execution of the queued operations.
+ */
+class Queue {
+    /** The items currently in the queue. */
+    items = [];
+    /** The maximum size of the queue before triggering execution. */
+    maxSize;
+    /** The interval in milliseconds after which the queue will be executed if not already triggered by size. */
+    interval;
+    /** The function to execute with the items in the queue. */
+    executeFn;
+    /** Timer for managing the interval-based execution. */
+    timer = null;
+    /** Flag to determine if execution should be parallel or sequential. */
+    executeInParallel;
+    /** The batch size for processing items. */
+    batchSize;
+    /** Whether the current queue is busy executing */
+    isExecuting = false;
+    /**
+     * Constructs a new Queue instance.
+     * @param executeFn - The function to execute with the items in the queue.
+     * @param maxSize - The maximum number of items before the queue is executed.
+     * @param executeEvery - The time in milliseconds after which the queue is executed if not already triggered.
+     * @param executeInParallel - Whether to execute the function in parallel or sequentially.
+     * @param batchSize - The number of items to process in each batch.
+     */
+    constructor(executeFn, executeInParallel = true, executeEvery = 5000, batchSize, maxSize) {
+        this.executeFn = executeFn;
+        this.maxSize = maxSize;
+        this.interval = executeEvery;
+        this.executeInParallel = executeInParallel;
+        this.batchSize = batchSize;
+    }
+    /**
+     * Adds an item to the queue.
+     * Triggers execution if the queue reaches the maximum size.
+     * Starts a timer if not already running.
+     * @param item - The item to add to the queue.
+     */
+    enqueue(item) {
+        this.items.push(item);
+        if (this.maxSize && this.items.length >= this.maxSize) {
+            this.execute();
+        }
+        if (!this.timer) {
+            this.startTimer();
+        }
+    }
+    /**
+     * Starts a timer to execute the queue after the specified interval.
+     */
+    startTimer() {
+        this.timer = setInterval(() => {
+            if (this.items.length > 0) {
+                this.execute();
+            }
+        }, this.interval);
+    }
+    /**
+     * Executes the function with the current items in the queue.
+     * Processes items in batches and resets the timer.
+     */
+    async execute() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.isExecuting = true;
+        // Now there are couple scenarios:
+        // 1. Batch size has value, we need to check if its going to be executed in parallel or sequentially
+        // 2. Batch size is not provided, we will execute all items in a single call
+        if (this.batchSize) {
+            const itemsToProcess = this.items.splice(0, this.batchSize);
+            if (this.executeInParallel) {
+                await Promise.all(itemsToProcess.map(item => this.executeFn([item])));
+            }
+            else {
+                for (const item of itemsToProcess) {
+                    await this.executeFn([item]);
+                }
+            }
+        }
+        this.isExecuting = false;
+    }
+}export{Queue};//# sourceMappingURL=queue.js.map

package/esm/utils/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sources":["../../src/utils/queue.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;AAIG;MACU,KAAK,CAAA;;IAER,KAAK,GAAQ,EAAE,CAAC;;AAGP,IAAA,OAAO,CAAU;;AAGjB,IAAA,QAAQ,CAAS;;AAGjB,IAAA,SAAS,CAAgC;;IAGlD,KAAK,GAA0B,IAAI,CAAC;;AAG3B,IAAA,iBAAiB,CAAU;;AAG3B,IAAA,SAAS,CAAS;;IAG3B,WAAW,GAAG,KAAK,CAAC;AAE5B;;;;;;;AAOG;IACH,WACE,CAAA,SAAwC,EACxC,iBAAA,GAA6B,IAAI,EACjC,eAAuB,IAAI,EAC3B,SAAiB,EACjB,OAAgB,EAAA;AAEhB,QAAA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;AAC3B,QAAA,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;AACvB,QAAA,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC;AAC7B,QAAA,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;AAC3C,QAAA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;KAC5B;AAED;;;;;AAKG;AACI,IAAA,OAAO,CAAC,IAAO,EAAA;AACpB,QAAA,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtB,QAAA,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE;YACrD,IAAI,CAAC,OAAO,EAAE,CAAC;AAChB,SAAA;AAED,QAAA,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE;YACf,IAAI,CAAC,UAAU,EAAE,CAAC;AACnB,SAAA;KACF;AAED;;AAEG;IACK,UAAU,GAAA;AAChB,QAAA,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,MAAK;AAC5B,YAAA,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;gBACzB,IAAI,CAAC,OAAO,EAAE,CAAC;AAChB,aAAA;AACH,SAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;KACnB;AAED;;;AAGG;AACK,IAAA,MAAM,OAAO,GAAA;QACnB,IAAI,IAAI,CAAC,KAAK,EAAE;AACd,YAAA,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1B,YAAA,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;AACnB,SAAA;AAED,QAAA,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;;;;QAKxB,IAAI,IAAI,CAAC,SAAS,EAAE;AAClB,YAAA,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5D,IAAI,IAAI,CAAC,iBAAiB,EAAE;gBAC1B,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,aAAA;AAAM,iBAAA;AACL,gBAAA,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE;oBACjC,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9B,iBAAA;AACF,aAAA;AACF,SAAA;AAED,QAAA,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;KAC1B;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@warlock.js/core",
-    "version": "2.1.1",
+    "version": "2.2.1",
     "description": "A robust nodejs framework for building blazing fast applications",
     "main": "./cjs/index.js",
     "bin": {
@@ -27,8 +27,8 @@
         "@mongez/fs": "^3.0.5",
         "@mongez/http": "^2.2.10",
         "@mongez/localization": "^3.0.0",
-        "@warlock.js/logger": "2.1.1",
-        "@warlock.js/cascade": "2.1.1",
+        "@warlock.js/logger": "2.2.1",
+        "@warlock.js/cascade": "2.2.1",
         "@mongez/reinforcements": "^2.3.10",
         "commander": "^12.0.0",
         "@mongez/slug": "^1.0.7",