@signaldb/core 2.0.0-beta.13 → 2.0.0-beta.14

package/dist/index33.cjs.js

@@ -1,21 +1,72 @@
-//#region src/utils/compact.ts
+//#region src/utils/batchOnNextTick.ts
 /**
-* Checks if a value is truthy.
-* @template T - The type of the value.
-* @param value - The value to check.
-* @returns A boolean indicating if the value is truthy.
+* Groups multiple calls by key and flushes them on the next tick (macrotask).
+* @param onFlush - Function that will be called with the key and all queued items when flushing.
+* @returns An object with `enqueue` and `flush` methods.
+* @example
+*   const batcher = batchOnNextTick<string>(async (key, items) => {
+*     // items is an array of { args, resolve, reject }
+*     // do something once with all args...
+*   })
+*
+*   batcher.enqueue("my-key", [arg1, arg2])
 */
-function truthy(value) {
-	return !!value;
-}
-/**
-* Filters out falsy values (`false`, `''`, `0`, `null`, `undefined`) from an array.
-* @template T - The type of the elements in the array.
-* @param array - The array to filter.
-* @returns A new array containing only the truthy values from the input array.
-*/
-function compact(array) {
-	return array.filter(truthy);
+function batchOnNextTick(onFlush) {
+	const queues = /* @__PURE__ */ new Map();
+	/**
+	* Enqueue a call with the given key and arguments.
+	* @param key key to group calls
+	* @param args arguments for the call
+	* @returns A promise that resolves or rejects when the call is flushed.
+	*/
+	function enqueue(key, args) {
+		return new Promise((resolve, reject) => {
+			let q = queues.get(key);
+			if (!q) {
+				q = {
+					timer: null,
+					items: [],
+					flush: () => flush(key)
+				};
+				queues.set(key, q);
+			}
+			q.items.push({
+				args,
+				resolve,
+				reject
+			});
+			if (q.timer == null) q.timer = setTimeout(() => {
+				q.timer = null;
+				q.flush();
+			}, 0);
+		});
+	}
+	/**
+	* Flush the queue for the given key immediately.
+	* @param key key to flush
+	* @returns A promise that resolves when the flush is complete.
+	*/
+	async function flush(key) {
+		const q = queues.get(key);
+		if (!q || q.items.length === 0) return;
+		if (q.timer != null) {
+			clearTimeout(q.timer);
+			q.timer = null;
+		}
+		const items = q.items.splice(0);
+		onFlush(key, items.map((i) => i.args)).then((results) => {
+			for (const [index, result] of results.entries()) {
+				const { resolve } = items[index];
+				resolve(result);
+			}
+		}).catch((error) => {
+			for (const { reject } of items) reject(error);
+		});
+	}
+	return {
+		enqueue,
+		flush
+	};
 }
 //#endregion
-exports.default = compact;
+exports.default = batchOnNextTick;

package/dist/index33.mjs

@@ -1,21 +1,72 @@
-//#region src/utils/compact.ts
+//#region src/utils/batchOnNextTick.ts
 /**
-* Checks if a value is truthy.
-* @template T - The type of the value.
-* @param value - The value to check.
-* @returns A boolean indicating if the value is truthy.
+* Groups multiple calls by key and flushes them on the next tick (macrotask).
+* @param onFlush - Function that will be called with the key and all queued items when flushing.
+* @returns An object with `enqueue` and `flush` methods.
+* @example
+*   const batcher = batchOnNextTick<string>(async (key, items) => {
+*     // items is an array of { args, resolve, reject }
+*     // do something once with all args...
+*   })
+*
+*   batcher.enqueue("my-key", [arg1, arg2])
 */
-function truthy(value) {
-	return !!value;
-}
-/**
-* Filters out falsy values (`false`, `''`, `0`, `null`, `undefined`) from an array.
-* @template T - The type of the elements in the array.
-* @param array - The array to filter.
-* @returns A new array containing only the truthy values from the input array.
-*/
-function compact(array) {
-	return array.filter(truthy);
+function batchOnNextTick(onFlush) {
+	const queues = /* @__PURE__ */ new Map();
+	/**
+	* Enqueue a call with the given key and arguments.
+	* @param key key to group calls
+	* @param args arguments for the call
+	* @returns A promise that resolves or rejects when the call is flushed.
+	*/
+	function enqueue(key, args) {
+		return new Promise((resolve, reject) => {
+			let q = queues.get(key);
+			if (!q) {
+				q = {
+					timer: null,
+					items: [],
+					flush: () => flush(key)
+				};
+				queues.set(key, q);
+			}
+			q.items.push({
+				args,
+				resolve,
+				reject
+			});
+			if (q.timer == null) q.timer = setTimeout(() => {
+				q.timer = null;
+				q.flush();
+			}, 0);
+		});
+	}
+	/**
+	* Flush the queue for the given key immediately.
+	* @param key key to flush
+	* @returns A promise that resolves when the flush is complete.
+	*/
+	async function flush(key) {
+		const q = queues.get(key);
+		if (!q || q.items.length === 0) return;
+		if (q.timer != null) {
+			clearTimeout(q.timer);
+			q.timer = null;
+		}
+		const items = q.items.splice(0);
+		onFlush(key, items.map((i) => i.args)).then((results) => {
+			for (const [index, result] of results.entries()) {
+				const { resolve } = items[index];
+				resolve(result);
+			}
+		}).catch((error) => {
+			for (const { reject } of items) reject(error);
+		});
+	}
+	return {
+		enqueue,
+		flush
+	};
 }
 //#endregion
-export { compact as default };
+export { batchOnNextTick as default };