@atom8n/utils 1.21.0

package/README.md

@@ -0,0 +1,25 @@
+# @n8n/utils
+
+A collection of utility functions that provide common functionality for both Front-End and Back-End packages.
+
+## Table of Contents
+
+- [Features](#features)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Features
+
+- **Reusable Logic**: Build complex, stateful functionality using modular composable functions that you can easily reuse.
+- **Consistent Patterns**: Enjoy a unified approach across n8n packages, making integration and maintenance a breeze.
+- **Type-Safe & Reliable**: Benefit from TypeScript support, which improves the developer experience and code robustness.
+- **Universal Functionality**: Designed to work seamlessly on both the front-end and back-end.
+- **Easily Testable**: A modular design that simplifies testing, maintenance, and rapid development.
+
+## Contributing
+
+For more details, please read our [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+For more details, please read our [LICENSE.md](LICENSE.md).

package/dist/assert.cjs

@@ -0,0 +1,3 @@
+const require_assert = require('./assert2.cjs');
+
+exports.assert = require_assert.assert;

package/dist/assert.d.cts

@@ -0,0 +1,2 @@
+import { t as assert } from "./assert2.cjs";
+export { assert };

package/dist/assert.d.mts

@@ -0,0 +1,2 @@
+import { t as assert } from "./assert2.mjs";
+export { assert };

package/dist/assert.mjs

@@ -0,0 +1,3 @@
+import { t as assert } from "./assert2.mjs";
+
+export { assert };

package/dist/assert2.cjs

@@ -0,0 +1,17 @@
+
+//#region src/assert.ts
+/**
+* Asserts given condition
+*/
+function assert(condition, message) {
+	if (!condition) throw new Error(message ?? "Assertion failed");
+}
+
+//#endregion
+Object.defineProperty(exports, 'assert', {
+  enumerable: true,
+  get: function () {
+    return assert;
+  }
+});
+//# sourceMappingURL=assert2.cjs.map

package/dist/assert2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert2.cjs","names":[],"sources":["../src/assert.ts"],"sourcesContent":["/**\n * Asserts given condition\n */\nexport function assert(condition: unknown, message?: string): asserts condition {\n\tif (!condition) {\n\t\t// eslint-disable-next-line n8n-local-rules/no-plain-errors\n\t\tthrow new Error(message ?? 'Assertion failed');\n\t}\n}\n"],"mappings":";;;;;AAGA,SAAgB,OAAO,WAAoB,SAAqC;AAC/E,KAAI,CAAC,UAEJ,OAAM,IAAI,MAAM,WAAW,mBAAmB"}

package/dist/assert2.d.cts

@@ -0,0 +1,5 @@
+//#region src/assert.d.ts
+declare function assert(condition: unknown, message?: string): asserts condition;
+//#endregion
+export { assert as t };
+//# sourceMappingURL=assert2.d.cts.map

package/dist/assert2.d.mts

@@ -0,0 +1,5 @@
+//#region src/assert.d.ts
+declare function assert(condition: unknown, message?: string): asserts condition;
+//#endregion
+export { assert as t };
+//# sourceMappingURL=assert2.d.mts.map

package/dist/assert2.mjs

@@ -0,0 +1,11 @@
+//#region src/assert.ts
+/**
+* Asserts given condition
+*/
+function assert(condition, message) {
+	if (!condition) throw new Error(message ?? "Assertion failed");
+}
+
+//#endregion
+export { assert as t };
+//# sourceMappingURL=assert2.mjs.map

package/dist/assert2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert2.mjs","names":[],"sources":["../src/assert.ts"],"sourcesContent":["/**\n * Asserts given condition\n */\nexport function assert(condition: unknown, message?: string): asserts condition {\n\tif (!condition) {\n\t\t// eslint-disable-next-line n8n-local-rules/no-plain-errors\n\t\tthrow new Error(message ?? 'Assertion failed');\n\t}\n}\n"],"mappings":";;;;AAGA,SAAgB,OAAO,WAAoB,SAAqC;AAC/E,KAAI,CAAC,UAEJ,OAAM,IAAI,MAAM,WAAW,mBAAmB"}

package/dist/event-bus.cjs

@@ -0,0 +1,3 @@
+const require_event_bus = require('./event-bus2.cjs');
+
+exports.createEventBus = require_event_bus.createEventBus;

package/dist/event-bus.d.cts

@@ -0,0 +1,2 @@
+import { n as EventBus, r as createEventBus, t as CallbackFn } from "./event-bus2.cjs";
+export { CallbackFn, EventBus, createEventBus };

package/dist/event-bus.d.mts

@@ -0,0 +1,2 @@
+import { n as EventBus, r as createEventBus, t as CallbackFn } from "./event-bus2.mjs";
+export { CallbackFn, EventBus, createEventBus };

package/dist/event-bus.mjs

@@ -0,0 +1,3 @@
+import { t as createEventBus } from "./event-bus2.mjs";
+
+export { createEventBus };

package/dist/event-bus2.cjs

@@ -0,0 +1,49 @@
+
+//#region src/event-bus.ts
+/**
+* Creates an event bus with the given listener map.
+*
+* @example
+* ```ts
+* const eventBus = createEventBus<{
+*   'user-logged-in': { username: string };
+*   'user-logged-out': never;
+* }>();
+*/
+function createEventBus() {
+	const handlers = /* @__PURE__ */ new Map();
+	return {
+		on(eventName, fn) {
+			let eventFns = handlers.get(eventName);
+			if (!eventFns) eventFns = [fn];
+			else eventFns.push(fn);
+			handlers.set(eventName, eventFns);
+		},
+		once(eventName, fn) {
+			const handler = (payload) => {
+				this.off(eventName, handler);
+				fn(payload);
+			};
+			this.on(eventName, handler);
+		},
+		off(eventName, fn) {
+			const eventFns = handlers.get(eventName);
+			if (eventFns) eventFns.splice(eventFns.indexOf(fn) >>> 0, 1);
+		},
+		emit(eventName, event) {
+			const eventFns = handlers.get(eventName);
+			if (eventFns) eventFns.slice().forEach((handler) => {
+				handler(event);
+			});
+		}
+	};
+}
+
+//#endregion
+Object.defineProperty(exports, 'createEventBus', {
+  enumerable: true,
+  get: function () {
+    return createEventBus;
+  }
+});
+//# sourceMappingURL=event-bus2.cjs.map

package/dist/event-bus2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus2.cjs","names":["handler: typeof fn"],"sources":["../src/event-bus.ts"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type CallbackFn = (...args: any[]) => any;\n\ntype Payloads<ListenerMap> = {\n\t[E in keyof ListenerMap]: unknown;\n};\n\ntype Listener<Payload> = (payload: Payload) => void;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface EventBus<ListenerMap extends Payloads<ListenerMap> = Record<string, any>> {\n\ton<EventName extends keyof ListenerMap & string>(\n\t\teventName: EventName,\n\t\tfn: Listener<ListenerMap[EventName]>,\n\t): void;\n\n\tonce<EventName extends keyof ListenerMap & string>(\n\t\teventName: EventName,\n\t\tfn: Listener<ListenerMap[EventName]>,\n\t): void;\n\n\toff<EventName extends keyof ListenerMap & string>(\n\t\teventName: EventName,\n\t\tfn: Listener<ListenerMap[EventName]>,\n\t): void;\n\n\temit<EventName extends keyof ListenerMap & string>(\n\t\teventName: EventName,\n\t\tevent?: ListenerMap[EventName],\n\t): void;\n}\n\n/**\n * Creates an event bus with the given listener map.\n *\n * @example\n * ```ts\n * const eventBus = createEventBus<{\n *   'user-logged-in': { username: string };\n *   'user-logged-out': never;\n * }>();\n */\nexport function createEventBus<\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tListenerMap extends Payloads<ListenerMap> = Record<string, any>,\n>(): EventBus<ListenerMap> {\n\tconst handlers = new Map<string, CallbackFn[]>();\n\n\treturn {\n\t\ton(eventName, fn) {\n\t\t\tlet eventFns = handlers.get(eventName);\n\t\t\tif (!eventFns) {\n\t\t\t\teventFns = [fn];\n\t\t\t} else {\n\t\t\t\teventFns.push(fn);\n\t\t\t}\n\t\t\thandlers.set(eventName, eventFns);\n\t\t},\n\n\t\tonce(eventName, fn) {\n\t\t\tconst handler: typeof fn = (payload) => {\n\t\t\t\tthis.off(eventName, handler);\n\t\t\t\tfn(payload);\n\t\t\t};\n\t\t\tthis.on(eventName, handler);\n\t\t},\n\n\t\toff(eventName, fn) {\n\t\t\tconst eventFns = handlers.get(eventName);\n\t\t\tif (eventFns) {\n\t\t\t\teventFns.splice(eventFns.indexOf(fn) >>> 0, 1);\n\t\t\t}\n\t\t},\n\n\t\temit(eventName, event) {\n\t\t\tconst eventFns = handlers.get(eventName);\n\t\t\tif (eventFns) {\n\t\t\t\teventFns.slice().forEach((handler) => {\n\t\t\t\t\thandler(event);\n\t\t\t\t});\n\t\t\t}\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;AA0CA,SAAgB,iBAGW;CAC1B,MAAM,2BAAW,IAAI,KAA2B;AAEhD,QAAO;EACN,GAAG,WAAW,IAAI;GACjB,IAAI,WAAW,SAAS,IAAI,UAAU;AACtC,OAAI,CAAC,SACJ,YAAW,CAAC,GAAG;OAEf,UAAS,KAAK,GAAG;AAElB,YAAS,IAAI,WAAW,SAAS;;EAGlC,KAAK,WAAW,IAAI;GACnB,MAAMA,WAAsB,YAAY;AACvC,SAAK,IAAI,WAAW,QAAQ;AAC5B,OAAG,QAAQ;;AAEZ,QAAK,GAAG,WAAW,QAAQ;;EAG5B,IAAI,WAAW,IAAI;GAClB,MAAM,WAAW,SAAS,IAAI,UAAU;AACxC,OAAI,SACH,UAAS,OAAO,SAAS,QAAQ,GAAG,KAAK,GAAG,EAAE;;EAIhD,KAAK,WAAW,OAAO;GACtB,MAAM,WAAW,SAAS,IAAI,UAAU;AACxC,OAAI,SACH,UAAS,OAAO,CAAC,SAAS,YAAY;AACrC,YAAQ,MAAM;KACb;;EAGJ"}

package/dist/event-bus2.d.cts

@@ -0,0 +1,14 @@
+//#region src/event-bus.d.ts
+type CallbackFn = (...args: any[]) => any;
+type Payloads<ListenerMap> = { [E in keyof ListenerMap]: unknown };
+type Listener<Payload> = (payload: Payload) => void;
+interface EventBus<ListenerMap extends Payloads<ListenerMap> = Record<string, any>> {
+  on<EventName extends keyof ListenerMap & string>(eventName: EventName, fn: Listener<ListenerMap[EventName]>): void;
+  once<EventName extends keyof ListenerMap & string>(eventName: EventName, fn: Listener<ListenerMap[EventName]>): void;
+  off<EventName extends keyof ListenerMap & string>(eventName: EventName, fn: Listener<ListenerMap[EventName]>): void;
+  emit<EventName extends keyof ListenerMap & string>(eventName: EventName, event?: ListenerMap[EventName]): void;
+}
+declare function createEventBus<ListenerMap extends Payloads<ListenerMap> = Record<string, any>>(): EventBus<ListenerMap>;
+//#endregion
+export { EventBus as n, createEventBus as r, CallbackFn as t };
+//# sourceMappingURL=event-bus2.d.cts.map

package/dist/event-bus2.d.mts

@@ -0,0 +1,14 @@
+//#region src/event-bus.d.ts
+type CallbackFn = (...args: any[]) => any;
+type Payloads<ListenerMap> = { [E in keyof ListenerMap]: unknown };
+type Listener<Payload> = (payload: Payload) => void;
+interface EventBus<ListenerMap extends Payloads<ListenerMap> = Record<string, any>> {
+  on<EventName extends keyof ListenerMap & string>(eventName: EventName, fn: Listener<ListenerMap[EventName]>): void;
+  once<EventName extends keyof ListenerMap & string>(eventName: EventName, fn: Listener<ListenerMap[EventName]>): void;
+  off<EventName extends keyof ListenerMap & string>(eventName: EventName, fn: Listener<ListenerMap[EventName]>): void;
+  emit<EventName extends keyof ListenerMap & string>(eventName: EventName, event?: ListenerMap[EventName]): void;
+}
+declare function createEventBus<ListenerMap extends Payloads<ListenerMap> = Record<string, any>>(): EventBus<ListenerMap>;
+//#endregion
+export { EventBus as n, createEventBus as r, CallbackFn as t };
+//# sourceMappingURL=event-bus2.d.mts.map

package/dist/event-bus2.mjs

@@ -0,0 +1,43 @@
+//#region src/event-bus.ts
+/**
+* Creates an event bus with the given listener map.
+*
+* @example
+* ```ts
+* const eventBus = createEventBus<{
+*   'user-logged-in': { username: string };
+*   'user-logged-out': never;
+* }>();
+*/
+function createEventBus() {
+	const handlers = /* @__PURE__ */ new Map();
+	return {
+		on(eventName, fn) {
+			let eventFns = handlers.get(eventName);
+			if (!eventFns) eventFns = [fn];
+			else eventFns.push(fn);
+			handlers.set(eventName, eventFns);
+		},
+		once(eventName, fn) {
+			const handler = (payload) => {
+				this.off(eventName, handler);
+				fn(payload);
+			};
+			this.on(eventName, handler);
+		},
+		off(eventName, fn) {
+			const eventFns = handlers.get(eventName);
+			if (eventFns) eventFns.splice(eventFns.indexOf(fn) >>> 0, 1);
+		},
+		emit(eventName, event) {
+			const eventFns = handlers.get(eventName);
+			if (eventFns) eventFns.slice().forEach((handler) => {
+				handler(event);
+			});
+		}
+	};
+}
+
+//#endregion
+export { createEventBus as t };
+//# sourceMappingURL=event-bus2.mjs.map

package/dist/event-bus2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus2.mjs","names":["handler: typeof fn"],"sources":["../src/event-bus.ts"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type CallbackFn = (...args: any[]) => any;\n\ntype Payloads<ListenerMap> = {\n\t[E in keyof ListenerMap]: unknown;\n};\n\ntype Listener<Payload> = (payload: Payload) => void;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface EventBus<ListenerMap extends Payloads<ListenerMap> = Record<string, any>> {\n\ton<EventName extends keyof ListenerMap & string>(\n\t\teventName: EventName,\n\t\tfn: Listener<ListenerMap[EventName]>,\n\t): void;\n\n\tonce<EventName extends keyof ListenerMap & string>(\n\t\teventName: EventName,\n\t\tfn: Listener<ListenerMap[EventName]>,\n\t): void;\n\n\toff<EventName extends keyof ListenerMap & string>(\n\t\teventName: EventName,\n\t\tfn: Listener<ListenerMap[EventName]>,\n\t): void;\n\n\temit<EventName extends keyof ListenerMap & string>(\n\t\teventName: EventName,\n\t\tevent?: ListenerMap[EventName],\n\t): void;\n}\n\n/**\n * Creates an event bus with the given listener map.\n *\n * @example\n * ```ts\n * const eventBus = createEventBus<{\n *   'user-logged-in': { username: string };\n *   'user-logged-out': never;\n * }>();\n */\nexport function createEventBus<\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tListenerMap extends Payloads<ListenerMap> = Record<string, any>,\n>(): EventBus<ListenerMap> {\n\tconst handlers = new Map<string, CallbackFn[]>();\n\n\treturn {\n\t\ton(eventName, fn) {\n\t\t\tlet eventFns = handlers.get(eventName);\n\t\t\tif (!eventFns) {\n\t\t\t\teventFns = [fn];\n\t\t\t} else {\n\t\t\t\teventFns.push(fn);\n\t\t\t}\n\t\t\thandlers.set(eventName, eventFns);\n\t\t},\n\n\t\tonce(eventName, fn) {\n\t\t\tconst handler: typeof fn = (payload) => {\n\t\t\t\tthis.off(eventName, handler);\n\t\t\t\tfn(payload);\n\t\t\t};\n\t\t\tthis.on(eventName, handler);\n\t\t},\n\n\t\toff(eventName, fn) {\n\t\t\tconst eventFns = handlers.get(eventName);\n\t\t\tif (eventFns) {\n\t\t\t\teventFns.splice(eventFns.indexOf(fn) >>> 0, 1);\n\t\t\t}\n\t\t},\n\n\t\temit(eventName, event) {\n\t\t\tconst eventFns = handlers.get(eventName);\n\t\t\tif (eventFns) {\n\t\t\t\teventFns.slice().forEach((handler) => {\n\t\t\t\t\thandler(event);\n\t\t\t\t});\n\t\t\t}\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;AA0CA,SAAgB,iBAGW;CAC1B,MAAM,2BAAW,IAAI,KAA2B;AAEhD,QAAO;EACN,GAAG,WAAW,IAAI;GACjB,IAAI,WAAW,SAAS,IAAI,UAAU;AACtC,OAAI,CAAC,SACJ,YAAW,CAAC,GAAG;OAEf,UAAS,KAAK,GAAG;AAElB,YAAS,IAAI,WAAW,SAAS;;EAGlC,KAAK,WAAW,IAAI;GACnB,MAAMA,WAAsB,YAAY;AACvC,SAAK,IAAI,WAAW,QAAQ;AAC5B,OAAG,QAAQ;;AAEZ,QAAK,GAAG,WAAW,QAAQ;;EAG5B,IAAI,WAAW,IAAI;GAClB,MAAM,WAAW,SAAS,IAAI,UAAU;AACxC,OAAI,SACH,UAAS,OAAO,SAAS,QAAQ,GAAG,KAAK,GAAG,EAAE;;EAIhD,KAAK,WAAW,OAAO;GACtB,MAAM,WAAW,SAAS,IAAI,UAAU;AACxC,OAAI,SACH,UAAS,OAAO,CAAC,SAAS,YAAY;AACrC,YAAQ,MAAM;KACb;;EAGJ"}

package/dist/event-queue.cjs

@@ -0,0 +1,3 @@
+const require_event_queue = require('./event-queue2.cjs');
+
+exports.createEventQueue = require_event_queue.createEventQueue;

package/dist/event-queue.d.cts

@@ -0,0 +1,2 @@
+import { t as createEventQueue } from "./event-queue2.cjs";
+export { createEventQueue };

package/dist/event-queue.d.mts

@@ -0,0 +1,2 @@
+import { t as createEventQueue } from "./event-queue2.mjs";
+export { createEventQueue };

package/dist/event-queue.mjs

@@ -0,0 +1,3 @@
+import { t as createEventQueue } from "./event-queue2.mjs";
+
+export { createEventQueue };

package/dist/event-queue2.cjs

@@ -0,0 +1,46 @@
+
+//#region src/event-queue.ts
+/**
+* Create an event queue that processes events sequentially.
+*
+* @param processEvent - Async function that processes a single event.
+* @returns A function that enqueues events for processing.
+*/
+function createEventQueue(processEvent) {
+	const queue = [];
+	let processing = false;
+	/**
+	* Process the next event in the queue (if not already processing).
+	*/
+	async function processNext() {
+		if (processing || queue.length === 0) return;
+		processing = true;
+		const currentEvent = queue.shift();
+		if (currentEvent !== void 0) try {
+			await processEvent(currentEvent);
+		} catch (error) {
+			console.error("Error processing event:", error);
+		}
+		processing = false;
+		await processNext();
+	}
+	/**
+	* Enqueue an event and trigger processing.
+	*
+	* @param event - The event to enqueue.
+	*/
+	function enqueue(event) {
+		queue.push(event);
+		processNext();
+	}
+	return { enqueue };
+}
+
+//#endregion
+Object.defineProperty(exports, 'createEventQueue', {
+  enumerable: true,
+  get: function () {
+    return createEventQueue;
+  }
+});
+//# sourceMappingURL=event-queue2.cjs.map

package/dist/event-queue2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-queue2.cjs","names":["queue: T[]"],"sources":["../src/event-queue.ts"],"sourcesContent":["/**\n * Create an event queue that processes events sequentially.\n *\n * @param processEvent - Async function that processes a single event.\n * @returns A function that enqueues events for processing.\n */\nexport function createEventQueue<T>(processEvent: (event: T) => Promise<void>) {\n\t// The internal queue holding events.\n\tconst queue: T[] = [];\n\n\t// Flag to indicate whether an event is currently being processed.\n\tlet processing = false;\n\n\t/**\n\t * Process the next event in the queue (if not already processing).\n\t */\n\tasync function processNext(): Promise<void> {\n\t\tif (processing || queue.length === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tprocessing = true;\n\t\tconst currentEvent = queue.shift();\n\n\t\tif (currentEvent !== undefined) {\n\t\t\ttry {\n\t\t\t\tawait processEvent(currentEvent);\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error('Error processing event:', error);\n\t\t\t}\n\t\t}\n\n\t\tprocessing = false;\n\n\t\t// Recursively process the next event.\n\t\tawait processNext();\n\t}\n\n\t/**\n\t * Enqueue an event and trigger processing.\n\t *\n\t * @param event - The event to enqueue.\n\t */\n\tfunction enqueue(event: T): void {\n\t\tqueue.push(event);\n\t\tvoid processNext();\n\t}\n\n\treturn { enqueue };\n}\n"],"mappings":";;;;;;;;AAMA,SAAgB,iBAAoB,cAA2C;CAE9E,MAAMA,QAAa,EAAE;CAGrB,IAAI,aAAa;;;;CAKjB,eAAe,cAA6B;AAC3C,MAAI,cAAc,MAAM,WAAW,EAClC;AAGD,eAAa;EACb,MAAM,eAAe,MAAM,OAAO;AAElC,MAAI,iBAAiB,OACpB,KAAI;AACH,SAAM,aAAa,aAAa;WACxB,OAAO;AACf,WAAQ,MAAM,2BAA2B,MAAM;;AAIjD,eAAa;AAGb,QAAM,aAAa;;;;;;;CAQpB,SAAS,QAAQ,OAAgB;AAChC,QAAM,KAAK,MAAM;AACjB,EAAK,aAAa;;AAGnB,QAAO,EAAE,SAAS"}

package/dist/event-queue2.d.cts

@@ -0,0 +1,7 @@
+//#region src/event-queue.d.ts
+declare function createEventQueue<T>(processEvent: (event: T) => Promise<void>): {
+  enqueue: (event: T) => void;
+};
+//#endregion
+export { createEventQueue as t };
+//# sourceMappingURL=event-queue2.d.cts.map

package/dist/event-queue2.d.mts

@@ -0,0 +1,7 @@
+//#region src/event-queue.d.ts
+declare function createEventQueue<T>(processEvent: (event: T) => Promise<void>): {
+  enqueue: (event: T) => void;
+};
+//#endregion
+export { createEventQueue as t };
+//# sourceMappingURL=event-queue2.d.mts.map

package/dist/event-queue2.mjs

@@ -0,0 +1,40 @@
+//#region src/event-queue.ts
+/**
+* Create an event queue that processes events sequentially.
+*
+* @param processEvent - Async function that processes a single event.
+* @returns A function that enqueues events for processing.
+*/
+function createEventQueue(processEvent) {
+	const queue = [];
+	let processing = false;
+	/**
+	* Process the next event in the queue (if not already processing).
+	*/
+	async function processNext() {
+		if (processing || queue.length === 0) return;
+		processing = true;
+		const currentEvent = queue.shift();
+		if (currentEvent !== void 0) try {
+			await processEvent(currentEvent);
+		} catch (error) {
+			console.error("Error processing event:", error);
+		}
+		processing = false;
+		await processNext();
+	}
+	/**
+	* Enqueue an event and trigger processing.
+	*
+	* @param event - The event to enqueue.
+	*/
+	function enqueue(event) {
+		queue.push(event);
+		processNext();
+	}
+	return { enqueue };
+}
+
+//#endregion
+export { createEventQueue as t };
+//# sourceMappingURL=event-queue2.mjs.map

package/dist/event-queue2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-queue2.mjs","names":["queue: T[]"],"sources":["../src/event-queue.ts"],"sourcesContent":["/**\n * Create an event queue that processes events sequentially.\n *\n * @param processEvent - Async function that processes a single event.\n * @returns A function that enqueues events for processing.\n */\nexport function createEventQueue<T>(processEvent: (event: T) => Promise<void>) {\n\t// The internal queue holding events.\n\tconst queue: T[] = [];\n\n\t// Flag to indicate whether an event is currently being processed.\n\tlet processing = false;\n\n\t/**\n\t * Process the next event in the queue (if not already processing).\n\t */\n\tasync function processNext(): Promise<void> {\n\t\tif (processing || queue.length === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tprocessing = true;\n\t\tconst currentEvent = queue.shift();\n\n\t\tif (currentEvent !== undefined) {\n\t\t\ttry {\n\t\t\t\tawait processEvent(currentEvent);\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error('Error processing event:', error);\n\t\t\t}\n\t\t}\n\n\t\tprocessing = false;\n\n\t\t// Recursively process the next event.\n\t\tawait processNext();\n\t}\n\n\t/**\n\t * Enqueue an event and trigger processing.\n\t *\n\t * @param event - The event to enqueue.\n\t */\n\tfunction enqueue(event: T): void {\n\t\tqueue.push(event);\n\t\tvoid processNext();\n\t}\n\n\treturn { enqueue };\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,iBAAoB,cAA2C;CAE9E,MAAMA,QAAa,EAAE;CAGrB,IAAI,aAAa;;;;CAKjB,eAAe,cAA6B;AAC3C,MAAI,cAAc,MAAM,WAAW,EAClC;AAGD,eAAa;EACb,MAAM,eAAe,MAAM,OAAO;AAElC,MAAI,iBAAiB,OACpB,KAAI;AACH,SAAM,aAAa,aAAa;WACxB,OAAO;AACf,WAAQ,MAAM,2BAA2B,MAAM;;AAIjD,eAAa;AAGb,QAAM,aAAa;;;;;;;CAQpB,SAAS,QAAQ,OAAgB;AAChC,QAAM,KAAK,MAAM;AACjB,EAAK,aAAa;;AAGnB,QAAO,EAAE,SAAS"}

package/dist/files/sanitize.cjs

@@ -0,0 +1,3 @@
+const require_sanitize = require('../sanitize.cjs');
+
+exports.sanitizeFilename = require_sanitize.sanitizeFilename;

package/dist/files/sanitize.d.cts

@@ -0,0 +1,2 @@
+import { t as sanitizeFilename } from "../sanitize.cjs";
+export { sanitizeFilename };

package/dist/files/sanitize.d.mts

@@ -0,0 +1,2 @@
+import { t as sanitizeFilename } from "../sanitize.mjs";
+export { sanitizeFilename };

package/dist/files/sanitize.mjs

@@ -0,0 +1,3 @@
+import { t as sanitizeFilename } from "../sanitize.mjs";
+
+export { sanitizeFilename };

package/dist/index.cjs

@@ -0,0 +1,23 @@
+const require_assert = require('./assert2.cjs');
+const require_event_bus = require('./event-bus2.cjs');
+const require_event_queue = require('./event-queue2.cjs');
+const require_retry = require('./retry2.cjs');
+const require_smartDecimal = require('./smartDecimal.cjs');
+const require_reRankSearchResults = require('./reRankSearchResults.cjs');
+const require_sublimeSearch = require('./sublimeSearch.cjs');
+const require_sortByProperty = require('./sortByProperty.cjs');
+const require_truncate = require('./truncate.cjs');
+const require_sanitize = require('./sanitize.cjs');
+
+exports.DEFAULT_KEYS = require_sublimeSearch.DEFAULT_KEYS;
+exports.assert = require_assert.assert;
+exports.createEventBus = require_event_bus.createEventBus;
+exports.createEventQueue = require_event_queue.createEventQueue;
+exports.reRankSearchResults = require_reRankSearchResults.reRankSearchResults;
+exports.retry = require_retry.retry;
+exports.sanitizeFilename = require_sanitize.sanitizeFilename;
+exports.smartDecimal = require_smartDecimal.smartDecimal;
+exports.sortByProperty = require_sortByProperty.sortByProperty;
+exports.sublimeSearch = require_sublimeSearch.sublimeSearch;
+exports.truncate = require_truncate.truncate;
+exports.truncateBeforeLast = require_truncate.truncateBeforeLast;

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+import { t as assert } from "./assert2.cjs";
+import { n as EventBus, r as createEventBus, t as CallbackFn } from "./event-bus2.cjs";
+import { t as createEventQueue } from "./event-queue2.cjs";
+import { t as sanitizeFilename } from "./sanitize.cjs";
+import { t as retry } from "./retry2.cjs";
+import { t as smartDecimal } from "./smartDecimal.cjs";
+import { t as reRankSearchResults } from "./reRankSearchResults.cjs";
+import { n as sublimeSearch, t as DEFAULT_KEYS } from "./sublimeSearch.cjs";
+import { t as sortByProperty } from "./sortByProperty.cjs";
+import { n as truncateBeforeLast, t as truncate } from "./truncate.cjs";
+export { CallbackFn, DEFAULT_KEYS, EventBus, assert, createEventBus, createEventQueue, reRankSearchResults, retry, sanitizeFilename, smartDecimal, sortByProperty, sublimeSearch, truncate, truncateBeforeLast };

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+import { t as assert } from "./assert2.mjs";
+import { n as EventBus, r as createEventBus, t as CallbackFn } from "./event-bus2.mjs";
+import { t as createEventQueue } from "./event-queue2.mjs";
+import { t as sanitizeFilename } from "./sanitize.mjs";
+import { t as retry } from "./retry2.mjs";
+import { t as smartDecimal } from "./smartDecimal.mjs";
+import { t as reRankSearchResults } from "./reRankSearchResults.mjs";
+import { n as sublimeSearch, t as DEFAULT_KEYS } from "./sublimeSearch.mjs";
+import { t as sortByProperty } from "./sortByProperty.mjs";
+import { n as truncateBeforeLast, t as truncate } from "./truncate.mjs";
+export { CallbackFn, DEFAULT_KEYS, EventBus, assert, createEventBus, createEventQueue, reRankSearchResults, retry, sanitizeFilename, smartDecimal, sortByProperty, sublimeSearch, truncate, truncateBeforeLast };

package/dist/index.mjs

@@ -0,0 +1,12 @@
+import { t as assert } from "./assert2.mjs";
+import { t as createEventBus } from "./event-bus2.mjs";
+import { t as createEventQueue } from "./event-queue2.mjs";
+import { t as retry } from "./retry2.mjs";
+import { t as smartDecimal } from "./smartDecimal.mjs";
+import { t as reRankSearchResults } from "./reRankSearchResults.mjs";
+import { n as sublimeSearch, t as DEFAULT_KEYS } from "./sublimeSearch.mjs";
+import { t as sortByProperty } from "./sortByProperty.mjs";
+import { n as truncateBeforeLast, t as truncate } from "./truncate.mjs";
+import { t as sanitizeFilename } from "./sanitize.mjs";
+
+export { DEFAULT_KEYS, assert, createEventBus, createEventQueue, reRankSearchResults, retry, sanitizeFilename, smartDecimal, sortByProperty, sublimeSearch, truncate, truncateBeforeLast };

package/dist/number/smartDecimal.cjs

@@ -0,0 +1,3 @@
+const require_smartDecimal = require('../smartDecimal.cjs');
+
+exports.smartDecimal = require_smartDecimal.smartDecimal;

package/dist/number/smartDecimal.d.cts

@@ -0,0 +1,2 @@
+import { t as smartDecimal } from "../smartDecimal.cjs";
+export { smartDecimal };

package/dist/number/smartDecimal.d.mts

@@ -0,0 +1,2 @@
+import { t as smartDecimal } from "../smartDecimal.mjs";
+export { smartDecimal };

package/dist/number/smartDecimal.mjs

@@ -0,0 +1,3 @@
+import { t as smartDecimal } from "../smartDecimal.mjs";
+
+export { smartDecimal };

package/dist/reRankSearchResults.cjs

@@ -0,0 +1,25 @@
+
+//#region src/search/reRankSearchResults.ts
+function reRankSearchResults(searchResults, additionalFactors) {
+	return searchResults.map(({ score, item }) => {
+		return {
+			score: score + Object.entries(additionalFactors).reduce((acc, [_, factorScores]) => {
+				const factorScore = factorScores[item.key];
+				if (factorScore) return acc + factorScore;
+				return acc;
+			}, 0),
+			item
+		};
+	}).sort((a, b) => {
+		return b.score - a.score;
+	});
+}
+
+//#endregion
+Object.defineProperty(exports, 'reRankSearchResults', {
+  enumerable: true,
+  get: function () {
+    return reRankSearchResults;
+  }
+});
+//# sourceMappingURL=reRankSearchResults.cjs.map

package/dist/reRankSearchResults.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reRankSearchResults.cjs","names":[],"sources":["../src/search/reRankSearchResults.ts"],"sourcesContent":["export function reRankSearchResults<T extends { key: string }>(\n\tsearchResults: Array<{ score: number; item: T }>,\n\tadditionalFactors: Record<string, Record<string, number>>,\n): Array<{ score: number; item: T }> {\n\treturn searchResults\n\t\t.map(({ score, item }) => {\n\t\t\t// For each additional factor, we check if it exists for the item and type,\n\t\t\t// and if so, we add the score to the item's score.\n\t\t\tconst additionalScore = Object.entries(additionalFactors).reduce((acc, [_, factorScores]) => {\n\t\t\t\tconst factorScore = factorScores[item.key];\n\t\t\t\tif (factorScore) {\n\t\t\t\t\treturn acc + factorScore;\n\t\t\t\t}\n\n\t\t\t\treturn acc;\n\t\t\t}, 0);\n\n\t\t\treturn {\n\t\t\t\tscore: score + additionalScore,\n\t\t\t\titem,\n\t\t\t};\n\t\t})\n\t\t.sort((a, b) => {\n\t\t\treturn b.score - a.score;\n\t\t});\n}\n"],"mappings":";;AAAA,SAAgB,oBACf,eACA,mBACoC;AACpC,QAAO,cACL,KAAK,EAAE,OAAO,WAAW;AAYzB,SAAO;GACN,OAAO,QAVgB,OAAO,QAAQ,kBAAkB,CAAC,QAAQ,KAAK,CAAC,GAAG,kBAAkB;IAC5F,MAAM,cAAc,aAAa,KAAK;AACtC,QAAI,YACH,QAAO,MAAM;AAGd,WAAO;MACL,EAAE;GAIJ;GACA;GACA,CACD,MAAM,GAAG,MAAM;AACf,SAAO,EAAE,QAAQ,EAAE;GAClB"}

package/dist/reRankSearchResults.d.cts

@@ -0,0 +1,13 @@
+//#region src/search/reRankSearchResults.d.ts
+declare function reRankSearchResults<T extends {
+  key: string;
+}>(searchResults: Array<{
+  score: number;
+  item: T;
+}>, additionalFactors: Record<string, Record<string, number>>): Array<{
+  score: number;
+  item: T;
+}>;
+//#endregion
+export { reRankSearchResults as t };
+//# sourceMappingURL=reRankSearchResults.d.cts.map

package/dist/reRankSearchResults.d.mts

@@ -0,0 +1,13 @@
+//#region src/search/reRankSearchResults.d.ts
+declare function reRankSearchResults<T extends {
+  key: string;
+}>(searchResults: Array<{
+  score: number;
+  item: T;
+}>, additionalFactors: Record<string, Record<string, number>>): Array<{
+  score: number;
+  item: T;
+}>;
+//#endregion
+export { reRankSearchResults as t };
+//# sourceMappingURL=reRankSearchResults.d.mts.map

package/dist/reRankSearchResults.mjs

@@ -0,0 +1,19 @@
+//#region src/search/reRankSearchResults.ts
+function reRankSearchResults(searchResults, additionalFactors) {
+	return searchResults.map(({ score, item }) => {
+		return {
+			score: score + Object.entries(additionalFactors).reduce((acc, [_, factorScores]) => {
+				const factorScore = factorScores[item.key];
+				if (factorScore) return acc + factorScore;
+				return acc;
+			}, 0),
+			item
+		};
+	}).sort((a, b) => {
+		return b.score - a.score;
+	});
+}
+
+//#endregion
+export { reRankSearchResults as t };
+//# sourceMappingURL=reRankSearchResults.mjs.map

package/dist/reRankSearchResults.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reRankSearchResults.mjs","names":[],"sources":["../src/search/reRankSearchResults.ts"],"sourcesContent":["export function reRankSearchResults<T extends { key: string }>(\n\tsearchResults: Array<{ score: number; item: T }>,\n\tadditionalFactors: Record<string, Record<string, number>>,\n): Array<{ score: number; item: T }> {\n\treturn searchResults\n\t\t.map(({ score, item }) => {\n\t\t\t// For each additional factor, we check if it exists for the item and type,\n\t\t\t// and if so, we add the score to the item's score.\n\t\t\tconst additionalScore = Object.entries(additionalFactors).reduce((acc, [_, factorScores]) => {\n\t\t\t\tconst factorScore = factorScores[item.key];\n\t\t\t\tif (factorScore) {\n\t\t\t\t\treturn acc + factorScore;\n\t\t\t\t}\n\n\t\t\t\treturn acc;\n\t\t\t}, 0);\n\n\t\t\treturn {\n\t\t\t\tscore: score + additionalScore,\n\t\t\t\titem,\n\t\t\t};\n\t\t})\n\t\t.sort((a, b) => {\n\t\t\treturn b.score - a.score;\n\t\t});\n}\n"],"mappings":";AAAA,SAAgB,oBACf,eACA,mBACoC;AACpC,QAAO,cACL,KAAK,EAAE,OAAO,WAAW;AAYzB,SAAO;GACN,OAAO,QAVgB,OAAO,QAAQ,kBAAkB,CAAC,QAAQ,KAAK,CAAC,GAAG,kBAAkB;IAC5F,MAAM,cAAc,aAAa,KAAK;AACtC,QAAI,YACH,QAAO,MAAM;AAGd,WAAO;MACL,EAAE;GAIJ;GACA;GACA,CACD,MAAM,GAAG,MAAM;AACf,SAAO,EAAE,QAAQ,EAAE;GAClB"}

package/dist/retry.cjs

@@ -0,0 +1,3 @@
+const require_retry = require('./retry2.cjs');
+
+exports.retry = require_retry.retry;

package/dist/retry.d.cts

@@ -0,0 +1,2 @@
+import { t as retry } from "./retry2.cjs";
+export { retry };

package/dist/retry.d.mts

@@ -0,0 +1,2 @@
+import { t as retry } from "./retry2.mjs";
+export { retry };

package/dist/retry.mjs

@@ -0,0 +1,3 @@
+import { t as retry } from "./retry2.mjs";
+
+export { retry };