node-events-batcher 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Egor Kushnarev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,134 @@
+# node-events-batcher
+
+Universal events batcher for NodeJS. Collects events and flushes them in batches via configurable strategies (size-based or time-based) with array or set accumulation.
+
+## Install
+
+> [!NOTE] 
+> It's highly recommended to use with [volta.sh](https://volta.sh).
+
+```bash
+npm install node-events-batcher
+```
+
+## Quick start
+
+```ts
+import { EventsBatcher } from 'node-events-batcher';
+
+const batcher = new EventsBatcher<string>(
+	(events) => {
+		console.log('Flushed:', events);
+	},
+	(err) => console.error(err),
+	{ size: 5, accumulatorType: 'array', timeoutMs: 5000 }
+);
+
+batcher.add('a');
+batcher.add('b');
+batcher.add('c');
+batcher.add('d');
+batcher.add('e'); // callback runs with ['a','b','c','d','e']
+
+batcher.flush(); // flush any remaining events manually
+```
+
+## API
+
+### `EventsBatcher<EventType>`
+
+**Constructor**
+
+```ts
+new EventsBatcher<EventType>(
+	callback: (events: ReadonlyArray<EventType>) => void | Promise<void>,
+	errorHandler?: ((error: unknown) => void) | null,
+	options?: SizeOptions | DebounceOptions
+)
+```
+
+- **callback** — Called with the batched events when a flush occurs. May return a Promise; rejections are passed to `errorHandler`.
+- **errorHandler** — Optional. If provided, callback errors are passed here; otherwise they are rethrown.
+- **options** — Flush strategy and accumulator. Defaults to `{ accumulatorType: 'array', timeoutMs: 2000, debounceMs: 50 }` (debounce strategy).
+
+**Methods**
+
+- **`add(event: EventType): void`** — Add an event. May trigger a flush depending on the strategy.
+- **`flush(): void`** — Flush all accumulated events immediately.
+
+### Options
+
+Two strategy types:
+
+| Option | Type | Description |
+|--------|------|-------------|
+| **Size strategy** | `SizeOptions` | Flush when the batch reaches `size` events. |
+| **Debounce strategy** | `DebounceOptions` | Flush after `debounceMs` ms of no new events. |
+
+**Common options**
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `accumulatorType` | `'array'` \| `'set'` | `'array'` — order preserved, duplicates allowed. `'set'` — unique events only, order not guaranteed. |
+| `timeoutMs` | `number` \| `null` | Max wait (ms) before flushing; `null` disables. |
+
+**Size strategy** (`SizeOptions`)
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `size` | `number` | Flush when batch size reaches this value. |
+
+**Debounce strategy** (`DebounceOptions`)
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `debounceMs` | `number` | Flush after this many ms without a new event. Must be &lt; `timeoutMs` when `timeoutMs` is set. |
+
+### Examples
+
+**Size-based batching (e.g. send when 10 items):**
+
+```ts
+const batcher = new EventsBatcher<Payload>(
+	sendToServer,
+	null,
+	{
+		size: 10,
+		accumulatorType: 'array',
+		timeoutMs: 3000,
+	}
+);
+```
+
+**Time-based debounce (e.g. persist after 100 ms idle):**
+
+```ts
+const batcher = new EventsBatcher<WindowId>(
+	persistWindowState,
+	console.error,
+	{
+		debounceMs: 100,
+		timeoutMs: 2000,
+		accumulatorType: 'set',
+	}
+);
+```
+
+**Exports**
+
+```ts
+import { EventsBatcher } from 'node-events-batcher';
+import type { SizeOptions, DebounceOptions } from 'node-events-batcher';
+```
+
+## Example app
+
+The `example/` folder contains an Electron app that uses the batcher to persist window state when windows are closed. Run it from the repo root:
+
+```bash
+cd example && pnpm install && pnpm start
+```
+
+## License
+
+MIT

package/accumulator.js

@@ -0,0 +1,92 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Accumulator = void 0;
+const Errors = __importStar(require("./errors"));
+class Accumulator {
+    addWrapper;
+    cleatWrapper;
+    lengthWrapper;
+    getWrapper;
+    constructor(type) {
+        if (type === 'array') {
+            const accumulator = new Array();
+            this.addWrapper = function (value) {
+                accumulator.push(value);
+            };
+            this.cleatWrapper = function () {
+                accumulator.splice(0, accumulator.length);
+            };
+            this.lengthWrapper = function () {
+                return accumulator.length;
+            };
+            this.getWrapper = function () {
+                return Array.from(accumulator);
+            };
+            return;
+        }
+        if (type === 'set') {
+            const accumulator = new Set();
+            this.addWrapper = function (value) {
+                accumulator.add(value);
+            };
+            this.cleatWrapper = function () {
+                accumulator.clear();
+            };
+            this.lengthWrapper = function () {
+                return accumulator.size;
+            };
+            this.getWrapper = function () {
+                return Array.from(accumulator.values());
+            };
+            return;
+        }
+        throw Errors.unsupportedAccumulatorType(type);
+    }
+    add(value) {
+        this.addWrapper(value);
+    }
+    clear() {
+        this.cleatWrapper();
+    }
+    length() {
+        return this.lengthWrapper();
+    }
+    get() {
+        return this.getWrapper();
+    }
+}
+exports.Accumulator = Accumulator;
+//# sourceMappingURL=accumulator.js.map

package/accumulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accumulator.js","sourceRoot":"","sources":["../src/accumulator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iDAAmC;AAInC,MAAa,WAAW;IACf,UAAU,CAAqB;IAC/B,YAAY,CAAa;IACzB,aAAa,CAAe;IAC5B,UAAU,CAAyB;IAE3C,YAAY,IAAqB;QAChC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACtB,MAAM,WAAW,GAAG,IAAI,KAAK,EAAK,CAAC;YAEnC,IAAI,CAAC,UAAU,GAAG,UAAS,KAAQ;gBAClC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC,CAAC;YAEF,IAAI,CAAC,YAAY,GAAG;gBACnB,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC,CAAC;YAEF,IAAI,CAAC,aAAa,GAAG;gBACpB,OAAO,WAAW,CAAC,MAAM,CAAC;YAC3B,CAAC,CAAC;YAEF,IAAI,CAAC,UAAU,GAAG;gBACjB,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChC,CAAC,CAAC;YAEF,OAAO;QACR,CAAC;QAED,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACpB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAK,CAAC;YAEjC,IAAI,CAAC,UAAU,GAAG,UAAS,KAAQ;gBAClC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC,CAAC;YAEF,IAAI,CAAC,YAAY,GAAG;gBACnB,WAAW,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC,CAAC;YAEF,IAAI,CAAC,aAAa,GAAG;gBACpB,OAAO,WAAW,CAAC,IAAI,CAAC;YACzB,CAAC,CAAC;YAEF,IAAI,CAAC,UAAU,GAAG;gBACjB,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;YACzC,CAAC,CAAC;YAEF,OAAO;QACR,CAAC;QAED,MAAM,MAAM,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,GAAG,CAAC,KAAQ;QACX,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,YAAY,EAAE,CAAC;IACrB,CAAC;IAED,MAAM;QACL,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED,GAAG;QACF,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC1B,CAAC;CACD;AArED,kCAqEC"}

package/errors.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unknownOptionsType = unknownOptionsType;
+exports.unsupportedAccumulatorType = unsupportedAccumulatorType;
+exports.nonPositiveTimeout = nonPositiveTimeout;
+exports.nonPositiveSize = nonPositiveSize;
+exports.nonPositiveDebounce = nonPositiveDebounce;
+exports.debounceGreaterThanTimeout = debounceGreaterThanTimeout;
+exports.shouldNotBeExecuted = shouldNotBeExecuted;
+function unknownOptionsType() {
+    return Error('EventsBatcher: unknown options type');
+}
+function unsupportedAccumulatorType(type) {
+    return Error(`EventsBatcher: unsupported accumulator type '${type}'. 'set' or 'array' expected`);
+}
+function nonPositiveTimeout(timeout) {
+    return Error(`EventsBatcher: 'timeout' must be positive. Got timeoutMs=${timeout}`);
+}
+function nonPositiveSize(size) {
+    return Error(`EventsBatcher: 'size' must be positive. Got size=${size}`);
+}
+function nonPositiveDebounce(debounce) {
+    return Error(`EventsBatcher: 'debounce' must be positive. Got debounceMs=${debounce}`);
+}
+function debounceGreaterThanTimeout(debounce, timeout) {
+    return Error(`EventsBatcher: 'debounce' must be less than 'timeout'. Got debounceMs=${debounce}, timeoutMs=${timeout}`);
+}
+function shouldNotBeExecuted() {
+    return Error('EventsBatcher: this should not be executed. Check your configuration');
+}
+//# sourceMappingURL=errors.js.map

package/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;AAAA,gDAEC;AAED,gEAEC;AAED,gDAEC;AAED,0CAEC;AAED,kDAEC;AAED,gEAEC;AAED,kDAEC;AA1BD,SAAgB,kBAAkB;IACjC,OAAO,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,0BAA0B,CAAC,IAAY;IACtD,OAAO,KAAK,CAAC,gDAAiD,IAAK,8BAA8B,CAAC,CAAC;AACpG,CAAC;AAED,SAAgB,kBAAkB,CAAC,OAAe;IACjD,OAAO,KAAK,CAAC,4DAA6D,OAAQ,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,SAAgB,eAAe,CAAC,IAAY;IAC3C,OAAO,KAAK,CAAC,oDAAqD,IAAK,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,SAAgB,mBAAmB,CAAC,QAAgB;IACnD,OAAO,KAAK,CAAC,8DAA+D,QAAS,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,SAAgB,0BAA0B,CAAC,QAAgB,EAAE,OAAe;IAC3E,OAAO,KAAK,CAAC,yEAA0E,QAAS,eAAgB,OAAQ,EAAE,CAAC,CAAC;AAC7H,CAAC;AAED,SAAgB,mBAAmB;IAClC,OAAO,KAAK,CAAC,sEAAsE,CAAC,CAAC;AACtF,CAAC"}

package/events-batcher.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsBatcher = void 0;
+const accumulator_1 = require("./accumulator");
+const options_1 = require("./options");
+const strategy_1 = require("./strategy");
+class EventsBatcher {
+    cb;
+    errorHandler;
+    options;
+    accumulator;
+    strategy;
+    constructor(cb, errorHandler = null, options = options_1.defaultOptions) {
+        this.cb = cb;
+        this.errorHandler = errorHandler;
+        this.options = options;
+        const err = (0, options_1.validateOptions)(options);
+        if (err !== null) {
+            throw err;
+        }
+        this.accumulator = new accumulator_1.Accumulator(this.options.accumulatorType);
+        this.strategy = (0, strategy_1.NewStrategy)(options, this.accumulator, this.fire.bind(this));
+    }
+    add(object) {
+        this.strategy.add(object);
+    }
+    flush() {
+        this.fire();
+    }
+    fire() {
+        const events = this.accumulator.get();
+        if (events.length === 0) {
+            this.strategy.reset();
+            return;
+        }
+        try {
+            const mayBePromise = this.cb(events);
+            if (mayBePromise instanceof Promise) {
+                mayBePromise.catch(error => {
+                    this.handleError(error);
+                });
+            }
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+        finally {
+            this.strategy.reset();
+        }
+    }
+    handleError(error) {
+        if (this.errorHandler !== null) {
+            this.errorHandler(error);
+        }
+        else {
+            throw error;
+        }
+    }
+}
+exports.EventsBatcher = EventsBatcher;
+//# sourceMappingURL=events-batcher.js.map

package/events-batcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-batcher.js","sourceRoot":"","sources":["../src/events-batcher.ts"],"names":[],"mappings":";;;AAAA,+CAA4C;AAC5C,uCAA0F;AAC1F,yCAAmD;AAKnD,MAAa,aAAa;IAKP;IACA;IACA;IANV,WAAW,CAAyB;IACpC,QAAQ,CAAsB;IAEtC,YACkB,EAA2B,EAC3B,eAAoC,IAAI,EACxC,UAAyC,wBAAc;QAFvD,OAAE,GAAF,EAAE,CAAyB;QAC3B,iBAAY,GAAZ,YAAY,CAA4B;QACxC,YAAO,GAAP,OAAO,CAAgD;QACxE,MAAM,GAAG,GAAG,IAAA,yBAAe,EAAC,OAAO,CAAC,CAAC;QAErC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,GAAG,CAAC;QACX,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,yBAAW,CAAY,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC5E,IAAI,CAAC,QAAQ,GAAG,IAAA,sBAAW,EAAY,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzF,CAAC;IAEM,GAAG,CAAC,MAAiB;QAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAEM,KAAK;QACX,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAEO,IAAI;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QAEtC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO;QACR,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YAErC,IAAI,YAAY,YAAY,OAAO,EAAE,CAAC;gBACrC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;oBAC1B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;gBACzB,CAAC,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACd,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;gBACO,CAAC;YACR,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACF,CAAC;IAEO,WAAW,CAAC,KAAc;QACjC,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAChC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;aACI,CAAC;YACL,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;CACD;AA3DD,sCA2DC"}

package/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsBatcher = void 0;
+var events_batcher_1 = require("./events-batcher");
+Object.defineProperty(exports, "EventsBatcher", { enumerable: true, get: function () { return events_batcher_1.EventsBatcher; } });
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}

package/make-awaiter.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeAwaiter = makeAwaiter;
+function makeAwaiter() {
+    let resolver = null;
+    let rejecter = null;
+    const awaiter = new Promise((resolve, reject) => {
+        resolver = resolve;
+        rejecter = reject;
+    });
+    if (resolver && rejecter) {
+        return [resolver, awaiter, rejecter];
+    }
+    throw Error('MakeAwaiter: should not be executed');
+}
+//# sourceMappingURL=make-awaiter.js.map

package/make-awaiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-awaiter.js","sourceRoot":"","sources":["../src/make-awaiter.ts"],"names":[],"mappings":";;AAAA,kCAcC;AAdD,SAAgB,WAAW;IAC1B,IAAI,QAAQ,GAAiD,IAAI,CAAC;IAClE,IAAI,QAAQ,GAAwC,IAAI,CAAC;IAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAClD,QAAQ,GAAG,OAAO,CAAC;QACnB,QAAQ,GAAG,MAAM,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAC1B,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACpD,CAAC"}

package/options.js

@@ -0,0 +1,98 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultOptions = void 0;
+exports.isSizeOptions = isSizeOptions;
+exports.isDebounceOptions = isDebounceOptions;
+exports.validateOptions = validateOptions;
+exports.validateBaseOptions = validateBaseOptions;
+const Errors = __importStar(require("./errors"));
+function isSizeOptions(options) {
+    return options !== null &&
+        typeof options === 'object' &&
+        'size' in options &&
+        options.size !== null &&
+        typeof options.size === 'number';
+}
+function isDebounceOptions(options) {
+    return options !== null &&
+        typeof options === 'object' &&
+        'debounceMs' in options &&
+        options.debounceMs !== null &&
+        typeof options.debounceMs === 'number';
+}
+function validateOptions(options) {
+    const err = validateBaseOptions(options);
+    if (err !== null) {
+        return err;
+    }
+    if (isSizeOptions(options)) {
+        return validateSizeOptions(options);
+    }
+    if (isDebounceOptions(options)) {
+        return validateDebounceOptions(options);
+    }
+    throw Errors.unknownOptionsType();
+}
+function validateBaseOptions(options) {
+    if (options.accumulatorType !== 'array' && options.accumulatorType !== 'set') {
+        return Errors.unsupportedAccumulatorType(options.accumulatorType);
+    }
+    if (options.timeoutMs !== null && options.timeoutMs <= 0) {
+        return Errors.nonPositiveTimeout(options.timeoutMs);
+    }
+    return null;
+}
+function validateSizeOptions(options) {
+    if (options.size <= 0) {
+        return Errors.nonPositiveSize(options.size);
+    }
+    return null;
+}
+function validateDebounceOptions(options) {
+    if (options.debounceMs <= 0) {
+        return Errors.nonPositiveDebounce(options.debounceMs);
+    }
+    if (options.timeoutMs !== null && options.debounceMs >= options.timeoutMs) {
+        return Errors.debounceGreaterThanTimeout(options.debounceMs, options.timeoutMs);
+    }
+    return null;
+}
+exports.defaultOptions = {
+    accumulatorType: 'array',
+    timeoutMs: 2000,
+    debounceMs: 50,
+};
+//# sourceMappingURL=options.js.map

package/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,sCAMC;AAED,8CAMC;AAED,0CAgBC;AAED,kDAUC;AA3DD,iDAAmC;AAenC,SAAgB,aAAa,CAAC,OAAgB;IAC7C,OAAO,OAAO,KAAK,IAAI;QACtB,OAAO,OAAO,KAAK,QAAQ;QAC3B,MAAM,IAAI,OAAO;QACjB,OAAO,CAAC,IAAI,KAAK,IAAI;QACrB,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,SAAgB,iBAAiB,CAAC,OAAgB;IACjD,OAAO,OAAO,KAAK,IAAI;QACtB,OAAO,OAAO,KAAK,QAAQ;QAC3B,YAAY,IAAI,OAAO;QACvB,OAAO,CAAC,UAAU,KAAK,IAAI;QAC3B,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC;AACzC,CAAC;AAED,SAAgB,eAAe,CAAC,OAAsC;IACrE,MAAM,GAAG,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAEzC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,CAAC,kBAAkB,EAAE,CAAC;AACnC,CAAC;AAED,SAAgB,mBAAmB,CAAC,OAAoB;IACvD,IAAI,OAAO,CAAC,eAAe,KAAK,OAAO,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;QAC9E,OAAO,MAAM,CAAC,0BAA0B,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAoB;IAChD,IAAI,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAwB;IACxD,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAC3E,OAAO,MAAM,CAAC,0BAA0B,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAEY,QAAA,cAAc,GAAoB;IAC9C,eAAe,EAAE,OAAO;IACxB,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,EAAE;CACd,CAAC"}

package/package.json

@@ -0,0 +1,18 @@
+{
+	"name": "node-events-batcher",
+	"version": "1.0.0",
+	"author": "Egor Kushnarev",
+	"description": "Universal events batcher for NodeJS",
+	"license": "MIT",
+	"keywords": [
+		"events-batcher",
+		"batcher",
+		"nodejs"
+	],
+	"homepage": "https://github.com/origin-yaropolk/node-events-batcher",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/origin-yaropolk/node-events-batcher"
+	},
+	"exports": "./index.js"
+}

package/strategy.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SizeStrategy = exports.DebounceStrategy = void 0;
+exports.NewStrategy = NewStrategy;
+const Errors = __importStar(require("./errors"));
+const options_1 = require("./options");
+function NewStrategy(options, accumulator, fire) {
+    if ((0, options_1.isDebounceOptions)(options)) {
+        return new DebounceStrategy(options, accumulator, fire);
+    }
+    if ((0, options_1.isSizeOptions)(options)) {
+        return new SizeStrategy(options, accumulator, fire);
+    }
+    throw Errors.shouldNotBeExecuted();
+}
+class DebounceStrategy {
+    options;
+    accumulator;
+    fire;
+    debounceTimeout = null;
+    timeout = null;
+    constructor(options, accumulator, fire) {
+        this.options = options;
+        this.accumulator = accumulator;
+        this.fire = fire;
+    }
+    reset() {
+        if (this.debounceTimeout) {
+            clearTimeout(this.debounceTimeout);
+            this.debounceTimeout = null;
+        }
+        if (this.timeout) {
+            clearTimeout(this.timeout);
+            this.timeout = null;
+        }
+        this.accumulator.clear();
+    }
+    add(event) {
+        this.accumulator.add(event);
+        if (this.debounceTimeout !== null) {
+            this.debounceTimeout.refresh();
+            return;
+        }
+        if (this.timeout === null && this.options.timeoutMs !== null) {
+            this.timeout = setTimeout(this.fire, this.options.timeoutMs);
+        }
+        this.debounceTimeout = setTimeout(this.fire, this.options.debounceMs);
+    }
+}
+exports.DebounceStrategy = DebounceStrategy;
+class SizeStrategy {
+    options;
+    accumulator;
+    fire;
+    timeout = null;
+    constructor(options, accumulator, fire) {
+        this.options = options;
+        this.accumulator = accumulator;
+        this.fire = fire;
+    }
+    reset() {
+        if (this.timeout) {
+            clearTimeout(this.timeout);
+            this.timeout = null;
+        }
+        this.accumulator.clear();
+    }
+    add(event) {
+        this.accumulator.add(event);
+        if (this.accumulator.length() >= this.options.size) {
+            this.fire();
+            return;
+        }
+        if (this.timeout === null && this.options.timeoutMs !== null) {
+            this.timeout = setTimeout(this.fire, this.options.timeoutMs);
+        }
+    }
+}
+exports.SizeStrategy = SizeStrategy;
+//# sourceMappingURL=strategy.js.map

package/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../src/strategy.ts"],"names":[],"mappings":"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"}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/accumulator.ts","../src/errors.ts","../src/events-batcher.ts","../src/index.ts","../src/make-awaiter.ts","../src/options.ts","../src/strategy.ts"],"version":"5.9.3"}