@n8n/utils 1.37.0 → 1.38.0

package/dist/assert.cjs

@@ -1,3 +1,12 @@
-const require_assert = require('./assert2.cjs');
 
-exports.assert = require_assert.assert;
+//#region src/assert.ts
+/**
+* Asserts given condition
+*/
+function assert(condition, message) {
+	if (!condition) throw new Error(message ?? "Assertion failed");
+}
+
+//#endregion
+exports.assert = assert;
+//# sourceMappingURL=assert.cjs.map

package/dist/assert.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.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/assert.d.cts

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

package/dist/assert.d.mts

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

package/dist/assert.mjs

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

package/dist/assert.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.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/client-assertion.cjs

@@ -0,0 +1,49 @@
+const require_format_pem_block = require('./format-pem-block2.cjs');
+let node_crypto = require("node:crypto");
+
+//#region src/client-assertion.ts
+const CLIENT_ASSERTION_TYPE = "urn:ietf:params:oauth:client-assertion-type:jwt-bearer";
+const ASSERTION_TTL_SECONDS = 300;
+function base64url(input) {
+	return Buffer.from(input).toString("base64url");
+}
+function certificateThumbprint(certificate) {
+	let parsed;
+	try {
+		parsed = new node_crypto.X509Certificate(require_format_pem_block.formatPemBlock(certificate));
+	} catch (error) {
+		throw new Error("The Certificate field must contain a PEM certificate (-----BEGIN CERTIFICATE-----).", { cause: error });
+	}
+	return Buffer.from(parsed.fingerprint.replace(/:/g, ""), "hex").toString("base64url");
+}
+function buildClientAssertion(options) {
+	const now = Math.floor(Date.now() / 1e3);
+	const header = {
+		alg: "RS256",
+		typ: "JWT",
+		x5t: certificateThumbprint(options.certificate)
+	};
+	const payload = {
+		aud: options.accessTokenUri,
+		iss: options.clientId,
+		sub: options.clientId,
+		jti: (0, node_crypto.randomUUID)(),
+		iat: now,
+		nbf: now,
+		exp: now + ASSERTION_TTL_SECONDS
+	};
+	let privateKey;
+	try {
+		privateKey = (0, node_crypto.createPrivateKey)(require_format_pem_block.formatPemBlock(options.privateKey));
+	} catch (error) {
+		throw new Error("The Private Key field must contain a PEM private key (-----BEGIN PRIVATE KEY-----).", { cause: error });
+	}
+	if (privateKey.asymmetricKeyType !== "rsa") throw new Error("Certificate authentication requires an RSA private key");
+	const signingInput = `${base64url(JSON.stringify(header))}.${base64url(JSON.stringify(payload))}`;
+	return `${signingInput}.${base64url((0, node_crypto.createSign)("RSA-SHA256").update(signingInput).sign(privateKey))}`;
+}
+
+//#endregion
+exports.CLIENT_ASSERTION_TYPE = CLIENT_ASSERTION_TYPE;
+exports.buildClientAssertion = buildClientAssertion;
+//# sourceMappingURL=client-assertion.cjs.map

package/dist/client-assertion.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-assertion.cjs","names":["parsed: X509Certificate","X509Certificate","formatPemBlock","privateKey: KeyObject"],"sources":["../src/client-assertion.ts"],"sourcesContent":["import {\n\tcreatePrivateKey,\n\tcreateSign,\n\trandomUUID,\n\tX509Certificate,\n\ttype KeyObject,\n} from 'node:crypto';\n\nimport { formatPemBlock } from './format-pem-block';\n\n// private_key_jwt (RFC 7521/7523): the client proves its identity with a JWT\n// signed by its private key instead of a shared secret. The `x5t` header (SHA-1\n// thumbprint of the certificate) tells the server which public key verifies it.\nexport const CLIENT_ASSERTION_TYPE = 'urn:ietf:params:oauth:client-assertion-type:jwt-bearer';\n\nconst ASSERTION_TTL_SECONDS = 300;\n\nfunction base64url(input: Buffer | string): string {\n\treturn Buffer.from(input).toString('base64url');\n}\n\nfunction certificateThumbprint(certificate: string): string {\n\tlet parsed: X509Certificate;\n\ttry {\n\t\tparsed = new X509Certificate(formatPemBlock(certificate));\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t'The Certificate field must contain a PEM certificate (-----BEGIN CERTIFICATE-----).',\n\t\t\t{ cause: error },\n\t\t);\n\t}\n\treturn Buffer.from(parsed.fingerprint.replace(/:/g, ''), 'hex').toString('base64url');\n}\n\nexport interface BuildClientAssertionOptions {\n\tclientId: string;\n\t/** Token endpoint; used as the JWT `aud`. */\n\taccessTokenUri: string;\n\t/** RSA private key (PEM). Signing is RS256-only; EC/Ed25519 keys are not supported. */\n\tprivateKey: string;\n\tcertificate: string;\n}\n\nexport function buildClientAssertion(options: BuildClientAssertionOptions): string {\n\tconst now = Math.floor(Date.now() / 1000);\n\tconst header = { alg: 'RS256', typ: 'JWT', x5t: certificateThumbprint(options.certificate) };\n\tconst payload = {\n\t\taud: options.accessTokenUri,\n\t\tiss: options.clientId,\n\t\tsub: options.clientId,\n\t\tjti: randomUUID(),\n\t\tiat: now,\n\t\tnbf: now,\n\t\texp: now + ASSERTION_TTL_SECONDS,\n\t};\n\n\tlet privateKey: KeyObject;\n\ttry {\n\t\tprivateKey = createPrivateKey(formatPemBlock(options.privateKey));\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t'The Private Key field must contain a PEM private key (-----BEGIN PRIVATE KEY-----).',\n\t\t\t{ cause: error },\n\t\t);\n\t}\n\n\t// `createSign('RSA-SHA256')` also signs EC/Ed25519 keys, producing a signature\n\t// that contradicts the pinned `alg: RS256` header. Reject non-RSA keys up front.\n\tif (privateKey.asymmetricKeyType !== 'rsa') {\n\t\tthrow new Error('Certificate authentication requires an RSA private key');\n\t}\n\n\tconst signingInput = `${base64url(JSON.stringify(header))}.${base64url(JSON.stringify(payload))}`;\n\tconst signature = createSign('RSA-SHA256').update(signingInput).sign(privateKey);\n\treturn `${signingInput}.${base64url(signature)}`;\n}\n"],"mappings":";;;;AAaA,MAAa,wBAAwB;AAErC,MAAM,wBAAwB;AAE9B,SAAS,UAAU,OAAgC;AAClD,QAAO,OAAO,KAAK,MAAM,CAAC,SAAS,YAAY;;AAGhD,SAAS,sBAAsB,aAA6B;CAC3D,IAAIA;AACJ,KAAI;AACH,WAAS,IAAIC,4BAAgBC,wCAAe,YAAY,CAAC;UACjD,OAAO;AACf,QAAM,IAAI,MACT,uFACA,EAAE,OAAO,OAAO,CAChB;;AAEF,QAAO,OAAO,KAAK,OAAO,YAAY,QAAQ,MAAM,GAAG,EAAE,MAAM,CAAC,SAAS,YAAY;;AAYtF,SAAgB,qBAAqB,SAA8C;CAClF,MAAM,MAAM,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;CACzC,MAAM,SAAS;EAAE,KAAK;EAAS,KAAK;EAAO,KAAK,sBAAsB,QAAQ,YAAY;EAAE;CAC5F,MAAM,UAAU;EACf,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,kCAAiB;EACjB,KAAK;EACL,KAAK;EACL,KAAK,MAAM;EACX;CAED,IAAIC;AACJ,KAAI;AACH,iDAA8BD,wCAAe,QAAQ,WAAW,CAAC;UACzD,OAAO;AACf,QAAM,IAAI,MACT,uFACA,EAAE,OAAO,OAAO,CAChB;;AAKF,KAAI,WAAW,sBAAsB,MACpC,OAAM,IAAI,MAAM,yDAAyD;CAG1E,MAAM,eAAe,GAAG,UAAU,KAAK,UAAU,OAAO,CAAC,CAAC,GAAG,UAAU,KAAK,UAAU,QAAQ,CAAC;AAE/F,QAAO,GAAG,aAAa,GAAG,sCADG,aAAa,CAAC,OAAO,aAAa,CAAC,KAAK,WAAW,CAClC"}

package/dist/client-assertion.d.cts

@@ -0,0 +1,12 @@
+//#region src/client-assertion.d.ts
+declare const CLIENT_ASSERTION_TYPE = "urn:ietf:params:oauth:client-assertion-type:jwt-bearer";
+interface BuildClientAssertionOptions {
+  clientId: string;
+  accessTokenUri: string;
+  privateKey: string;
+  certificate: string;
+}
+declare function buildClientAssertion(options: BuildClientAssertionOptions): string;
+//#endregion
+export { BuildClientAssertionOptions, CLIENT_ASSERTION_TYPE, buildClientAssertion };
+//# sourceMappingURL=client-assertion.d.cts.map

package/dist/client-assertion.d.mts

@@ -0,0 +1,12 @@
+//#region src/client-assertion.d.ts
+declare const CLIENT_ASSERTION_TYPE = "urn:ietf:params:oauth:client-assertion-type:jwt-bearer";
+interface BuildClientAssertionOptions {
+  clientId: string;
+  accessTokenUri: string;
+  privateKey: string;
+  certificate: string;
+}
+declare function buildClientAssertion(options: BuildClientAssertionOptions): string;
+//#endregion
+export { BuildClientAssertionOptions, CLIENT_ASSERTION_TYPE, buildClientAssertion };
+//# sourceMappingURL=client-assertion.d.mts.map

package/dist/client-assertion.mjs

@@ -0,0 +1,48 @@
+import { t as formatPemBlock } from "./format-pem-block2.mjs";
+import { X509Certificate, createPrivateKey, createSign, randomUUID } from "node:crypto";
+
+//#region src/client-assertion.ts
+const CLIENT_ASSERTION_TYPE = "urn:ietf:params:oauth:client-assertion-type:jwt-bearer";
+const ASSERTION_TTL_SECONDS = 300;
+function base64url(input) {
+	return Buffer.from(input).toString("base64url");
+}
+function certificateThumbprint(certificate) {
+	let parsed;
+	try {
+		parsed = new X509Certificate(formatPemBlock(certificate));
+	} catch (error) {
+		throw new Error("The Certificate field must contain a PEM certificate (-----BEGIN CERTIFICATE-----).", { cause: error });
+	}
+	return Buffer.from(parsed.fingerprint.replace(/:/g, ""), "hex").toString("base64url");
+}
+function buildClientAssertion(options) {
+	const now = Math.floor(Date.now() / 1e3);
+	const header = {
+		alg: "RS256",
+		typ: "JWT",
+		x5t: certificateThumbprint(options.certificate)
+	};
+	const payload = {
+		aud: options.accessTokenUri,
+		iss: options.clientId,
+		sub: options.clientId,
+		jti: randomUUID(),
+		iat: now,
+		nbf: now,
+		exp: now + ASSERTION_TTL_SECONDS
+	};
+	let privateKey;
+	try {
+		privateKey = createPrivateKey(formatPemBlock(options.privateKey));
+	} catch (error) {
+		throw new Error("The Private Key field must contain a PEM private key (-----BEGIN PRIVATE KEY-----).", { cause: error });
+	}
+	if (privateKey.asymmetricKeyType !== "rsa") throw new Error("Certificate authentication requires an RSA private key");
+	const signingInput = `${base64url(JSON.stringify(header))}.${base64url(JSON.stringify(payload))}`;
+	return `${signingInput}.${base64url(createSign("RSA-SHA256").update(signingInput).sign(privateKey))}`;
+}
+
+//#endregion
+export { CLIENT_ASSERTION_TYPE, buildClientAssertion };
+//# sourceMappingURL=client-assertion.mjs.map

package/dist/client-assertion.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-assertion.mjs","names":["parsed: X509Certificate","privateKey: KeyObject"],"sources":["../src/client-assertion.ts"],"sourcesContent":["import {\n\tcreatePrivateKey,\n\tcreateSign,\n\trandomUUID,\n\tX509Certificate,\n\ttype KeyObject,\n} from 'node:crypto';\n\nimport { formatPemBlock } from './format-pem-block';\n\n// private_key_jwt (RFC 7521/7523): the client proves its identity with a JWT\n// signed by its private key instead of a shared secret. The `x5t` header (SHA-1\n// thumbprint of the certificate) tells the server which public key verifies it.\nexport const CLIENT_ASSERTION_TYPE = 'urn:ietf:params:oauth:client-assertion-type:jwt-bearer';\n\nconst ASSERTION_TTL_SECONDS = 300;\n\nfunction base64url(input: Buffer | string): string {\n\treturn Buffer.from(input).toString('base64url');\n}\n\nfunction certificateThumbprint(certificate: string): string {\n\tlet parsed: X509Certificate;\n\ttry {\n\t\tparsed = new X509Certificate(formatPemBlock(certificate));\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t'The Certificate field must contain a PEM certificate (-----BEGIN CERTIFICATE-----).',\n\t\t\t{ cause: error },\n\t\t);\n\t}\n\treturn Buffer.from(parsed.fingerprint.replace(/:/g, ''), 'hex').toString('base64url');\n}\n\nexport interface BuildClientAssertionOptions {\n\tclientId: string;\n\t/** Token endpoint; used as the JWT `aud`. */\n\taccessTokenUri: string;\n\t/** RSA private key (PEM). Signing is RS256-only; EC/Ed25519 keys are not supported. */\n\tprivateKey: string;\n\tcertificate: string;\n}\n\nexport function buildClientAssertion(options: BuildClientAssertionOptions): string {\n\tconst now = Math.floor(Date.now() / 1000);\n\tconst header = { alg: 'RS256', typ: 'JWT', x5t: certificateThumbprint(options.certificate) };\n\tconst payload = {\n\t\taud: options.accessTokenUri,\n\t\tiss: options.clientId,\n\t\tsub: options.clientId,\n\t\tjti: randomUUID(),\n\t\tiat: now,\n\t\tnbf: now,\n\t\texp: now + ASSERTION_TTL_SECONDS,\n\t};\n\n\tlet privateKey: KeyObject;\n\ttry {\n\t\tprivateKey = createPrivateKey(formatPemBlock(options.privateKey));\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t'The Private Key field must contain a PEM private key (-----BEGIN PRIVATE KEY-----).',\n\t\t\t{ cause: error },\n\t\t);\n\t}\n\n\t// `createSign('RSA-SHA256')` also signs EC/Ed25519 keys, producing a signature\n\t// that contradicts the pinned `alg: RS256` header. Reject non-RSA keys up front.\n\tif (privateKey.asymmetricKeyType !== 'rsa') {\n\t\tthrow new Error('Certificate authentication requires an RSA private key');\n\t}\n\n\tconst signingInput = `${base64url(JSON.stringify(header))}.${base64url(JSON.stringify(payload))}`;\n\tconst signature = createSign('RSA-SHA256').update(signingInput).sign(privateKey);\n\treturn `${signingInput}.${base64url(signature)}`;\n}\n"],"mappings":";;;;AAaA,MAAa,wBAAwB;AAErC,MAAM,wBAAwB;AAE9B,SAAS,UAAU,OAAgC;AAClD,QAAO,OAAO,KAAK,MAAM,CAAC,SAAS,YAAY;;AAGhD,SAAS,sBAAsB,aAA6B;CAC3D,IAAIA;AACJ,KAAI;AACH,WAAS,IAAI,gBAAgB,eAAe,YAAY,CAAC;UACjD,OAAO;AACf,QAAM,IAAI,MACT,uFACA,EAAE,OAAO,OAAO,CAChB;;AAEF,QAAO,OAAO,KAAK,OAAO,YAAY,QAAQ,MAAM,GAAG,EAAE,MAAM,CAAC,SAAS,YAAY;;AAYtF,SAAgB,qBAAqB,SAA8C;CAClF,MAAM,MAAM,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;CACzC,MAAM,SAAS;EAAE,KAAK;EAAS,KAAK;EAAO,KAAK,sBAAsB,QAAQ,YAAY;EAAE;CAC5F,MAAM,UAAU;EACf,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,KAAK,YAAY;EACjB,KAAK;EACL,KAAK;EACL,KAAK,MAAM;EACX;CAED,IAAIC;AACJ,KAAI;AACH,eAAa,iBAAiB,eAAe,QAAQ,WAAW,CAAC;UACzD,OAAO;AACf,QAAM,IAAI,MACT,uFACA,EAAE,OAAO,OAAO,CAChB;;AAKF,KAAI,WAAW,sBAAsB,MACpC,OAAM,IAAI,MAAM,yDAAyD;CAG1E,MAAM,eAAe,GAAG,UAAU,KAAK,UAAU,OAAO,CAAC,CAAC,GAAG,UAAU,KAAK,UAAU,QAAQ,CAAC;AAE/F,QAAO,GAAG,aAAa,GAAG,UADR,WAAW,aAAa,CAAC,OAAO,aAAa,CAAC,KAAK,WAAW,CAClC"}

package/dist/create-event-queue.cjs

@@ -1,3 +1,41 @@
-const require_create_event_queue = require('./create-event-queue2.cjs');
 
-exports.createEventQueue = require_create_event_queue.createEventQueue;
+//#region src/create-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
+exports.createEventQueue = createEventQueue;
+//# sourceMappingURL=create-event-queue.cjs.map

package/dist/create-event-queue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-event-queue.cjs","names":["queue: T[]"],"sources":["../src/create-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/create-event-queue.d.cts

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

package/dist/create-event-queue.d.mts

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

package/dist/create-event-queue.mjs

@@ -1,3 +1,40 @@
-import { t as createEventQueue } from "./create-event-queue2.mjs";
+//#region src/create-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 };
+}
 
-export { createEventQueue };
+//#endregion
+export { createEventQueue };
+//# sourceMappingURL=create-event-queue.mjs.map

package/dist/create-event-queue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-event-queue.mjs","names":["queue: T[]"],"sources":["../src/create-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/ensure-error.cjs

@@ -0,0 +1,15 @@
+
+//#region src/errors/ensure-error.ts
+/** Ensures `error` is an `Error */
+function ensureError(error) {
+	return error instanceof Error ? error : new Error("Error that was not an instance of Error was thrown", { cause: error });
+}
+
+//#endregion
+Object.defineProperty(exports, 'ensureError', {
+  enumerable: true,
+  get: function () {
+    return ensureError;
+  }
+});
+//# sourceMappingURL=ensure-error.cjs.map

package/dist/ensure-error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-error.cjs","names":[],"sources":["../src/errors/ensure-error.ts"],"sourcesContent":["/** Ensures `error` is an `Error */\nexport function ensureError(error: unknown): Error {\n\treturn error instanceof Error\n\t\t? error\n\t\t: new Error('Error that was not an instance of Error was thrown', {\n\t\t\t\t// We should never throw anything except something that derives from Error\n\t\t\t\tcause: error,\n\t\t\t});\n}\n"],"mappings":";;;AACA,SAAgB,YAAY,OAAuB;AAClD,QAAO,iBAAiB,QACrB,QACA,IAAI,MAAM,sDAAsD,EAEhE,OAAO,OACP,CAAC"}

package/dist/ensure-error.mjs

@@ -0,0 +1,9 @@
+//#region src/errors/ensure-error.ts
+/** Ensures `error` is an `Error */
+function ensureError(error) {
+	return error instanceof Error ? error : new Error("Error that was not an instance of Error was thrown", { cause: error });
+}
+
+//#endregion
+export { ensureError as t };
+//# sourceMappingURL=ensure-error.mjs.map

package/dist/ensure-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-error.mjs","names":[],"sources":["../src/errors/ensure-error.ts"],"sourcesContent":["/** Ensures `error` is an `Error */\nexport function ensureError(error: unknown): Error {\n\treturn error instanceof Error\n\t\t? error\n\t\t: new Error('Error that was not an instance of Error was thrown', {\n\t\t\t\t// We should never throw anything except something that derives from Error\n\t\t\t\tcause: error,\n\t\t\t});\n}\n"],"mappings":";;AACA,SAAgB,YAAY,OAAuB;AAClD,QAAO,iBAAiB,QACrB,QACA,IAAI,MAAM,sDAAsD,EAEhE,OAAO,OACP,CAAC"}

package/dist/errors/ensure-error.cjs

@@ -0,0 +1,3 @@
+const require_ensure_error = require('../ensure-error.cjs');
+
+exports.ensureError = require_ensure_error.ensureError;

package/dist/errors/ensure-error.d.cts

@@ -0,0 +1,5 @@
+//#region src/errors/ensure-error.d.ts
+declare function ensureError(error: unknown): Error;
+//#endregion
+export { ensureError };
+//# sourceMappingURL=ensure-error.d.cts.map

package/dist/errors/ensure-error.d.mts

@@ -0,0 +1,5 @@
+//#region src/errors/ensure-error.d.ts
+declare function ensureError(error: unknown): Error;
+//#endregion
+export { ensureError };
+//# sourceMappingURL=ensure-error.d.mts.map

package/dist/errors/ensure-error.mjs

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

package/dist/event-bus.cjs

@@ -1,3 +1,44 @@
-const require_event_bus = require('./event-bus2.cjs');
 
-exports.createEventBus = require_event_bus.createEventBus;
+//#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
+exports.createEventBus = createEventBus;
+//# sourceMappingURL=event-bus.cjs.map

package/dist/event-bus.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.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-bus.d.cts

@@ -1,2 +1,14 @@
-import { n as EventBus, r as createEventBus, t as CallbackFn } from "./event-bus2.cjs";
-export { CallbackFn, EventBus, createEventBus };
+//#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 { CallbackFn, EventBus, createEventBus };
+//# sourceMappingURL=event-bus.d.cts.map

package/dist/event-bus.d.mts

@@ -1,2 +1,14 @@
-import { n as EventBus, r as createEventBus, t as CallbackFn } from "./event-bus2.mjs";
-export { CallbackFn, EventBus, createEventBus };
+//#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 { CallbackFn, EventBus, createEventBus };
+//# sourceMappingURL=event-bus.d.mts.map

package/dist/event-bus.mjs

@@ -1,3 +1,43 @@
-import { t as createEventBus } from "./event-bus2.mjs";
+//#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);
+			});
+		}
+	};
+}
 
-export { createEventBus };
+//#endregion
+export { createEventBus };
+//# sourceMappingURL=event-bus.mjs.map

package/dist/event-bus.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.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/files/is-windows-file-path.cjs

@@ -1,3 +1,12 @@
-const require_is_windows_file_path = require('../is-windows-file-path.cjs');
 
-exports.isWindowsFilePath = require_is_windows_file_path.isWindowsFilePath;
+//#region src/files/is-windows-file-path.ts
+/**
+* Fast check if file path starts with a windows drive letter, e.g. 'C:/' or 'C:\\'
+*/
+function isWindowsFilePath(str) {
+	return /^[a-zA-Z]:[\\/]/.test(str);
+}
+
+//#endregion
+exports.isWindowsFilePath = isWindowsFilePath;
+//# sourceMappingURL=is-windows-file-path.cjs.map

package/dist/files/is-windows-file-path.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-windows-file-path.cjs","names":[],"sources":["../../src/files/is-windows-file-path.ts"],"sourcesContent":["/**\n * Fast check if file path starts with a windows drive letter, e.g. 'C:/' or 'C:\\\\'\n */\nexport function isWindowsFilePath(str: string) {\n\treturn /^[a-zA-Z]:[\\\\/]/.test(str);\n}\n"],"mappings":";;;;;AAGA,SAAgB,kBAAkB,KAAa;AAC9C,QAAO,kBAAkB,KAAK,IAAI"}

package/dist/files/is-windows-file-path.d.cts

@@ -1,2 +1,5 @@
-import { t as isWindowsFilePath } from "../is-windows-file-path.cjs";
-export { isWindowsFilePath };
+//#region src/files/is-windows-file-path.d.ts
+declare function isWindowsFilePath(str: string): boolean;
+//#endregion
+export { isWindowsFilePath };
+//# sourceMappingURL=is-windows-file-path.d.cts.map

package/dist/files/is-windows-file-path.d.mts

@@ -1,2 +1,5 @@
-import { t as isWindowsFilePath } from "../is-windows-file-path.mjs";
-export { isWindowsFilePath };
+//#region src/files/is-windows-file-path.d.ts
+declare function isWindowsFilePath(str: string): boolean;
+//#endregion
+export { isWindowsFilePath };
+//# sourceMappingURL=is-windows-file-path.d.mts.map

package/dist/files/is-windows-file-path.mjs

@@ -1,3 +1,11 @@
-import { t as isWindowsFilePath } from "../is-windows-file-path.mjs";
+//#region src/files/is-windows-file-path.ts
+/**
+* Fast check if file path starts with a windows drive letter, e.g. 'C:/' or 'C:\\'
+*/
+function isWindowsFilePath(str) {
+	return /^[a-zA-Z]:[\\/]/.test(str);
+}
 
-export { isWindowsFilePath };
+//#endregion
+export { isWindowsFilePath };
+//# sourceMappingURL=is-windows-file-path.mjs.map

package/dist/files/is-windows-file-path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-windows-file-path.mjs","names":[],"sources":["../../src/files/is-windows-file-path.ts"],"sourcesContent":["/**\n * Fast check if file path starts with a windows drive letter, e.g. 'C:/' or 'C:\\\\'\n */\nexport function isWindowsFilePath(str: string) {\n\treturn /^[a-zA-Z]:[\\\\/]/.test(str);\n}\n"],"mappings":";;;;AAGA,SAAgB,kBAAkB,KAAa;AAC9C,QAAO,kBAAkB,KAAK,IAAI"}