commandkit 1.2.0-dev.20260228005229 → 1.2.0-dev.20260301010539

package/dist/utils/constants.js

@@ -1,9 +1,51 @@
-const require_constants = require('../constants-CeIMhMD0.js');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-exports.COMMANDKIT_BOOTSTRAP_MODE = require_constants.COMMANDKIT_BOOTSTRAP_MODE;
-exports.COMMANDKIT_CWD = require_constants.COMMANDKIT_CWD;
-exports.COMMANDKIT_IS_CLI = require_constants.COMMANDKIT_IS_CLI;
-exports.COMMANDKIT_IS_DEV = require_constants.COMMANDKIT_IS_DEV;
-exports.COMMANDKIT_IS_TEST = require_constants.COMMANDKIT_IS_TEST;
-exports.HMREventType = require_constants.HMREventType;
-exports.isBuildLikeEnvironment = require_constants.isBuildLikeEnvironment;
+//#region src/utils/constants.ts
+/**
+* The current working directory of the CommandKit instance.
+*/
+const COMMANDKIT_CWD = process.env.COMMANDKIT_CWD || process.cwd();
+/**
+* Indicates whether CommandKit is running in development mode.
+*/
+const COMMANDKIT_IS_DEV = process.env.COMMANDKIT_IS_DEV === "true";
+/**
+* Indicates whether CommandKit is running in CLI thread.
+*/
+const COMMANDKIT_IS_CLI = process.env.COMMANDKIT_IS_CLI === "true";
+/**
+* Indicates whether CommandKit is running in test mode.
+*/
+const COMMANDKIT_IS_TEST = process.env.COMMANDKIT_IS_TEST === "true";
+/**
+* Indicates that CommandKit is running in a build-like environment.
+* @private
+* @internal
+*/
+function isBuildLikeEnvironment() {
+	if (process.env.COMMANDKIT_INTERNAL_IS_CLI_PROCESS === "true") return true;
+	return process.env.COMMANDKIT_IS_BUILD === "true";
+}
+/**
+* The current bootstrap mode of CommandKit.
+* This can be 'development' or 'production'.
+*/
+const COMMANDKIT_BOOTSTRAP_MODE = process.env.COMMANDKIT_BOOTSTRAP_MODE || "development";
+/**
+* Types of Hot Module Replacement events
+*/
+const HMREventType = {
+	ReloadCommands: "reload-commands",
+	ReloadEvents: "reload-events",
+	Unknown: "unknown"
+};
+
+//#endregion
+exports.COMMANDKIT_BOOTSTRAP_MODE = COMMANDKIT_BOOTSTRAP_MODE;
+exports.COMMANDKIT_CWD = COMMANDKIT_CWD;
+exports.COMMANDKIT_IS_CLI = COMMANDKIT_IS_CLI;
+exports.COMMANDKIT_IS_DEV = COMMANDKIT_IS_DEV;
+exports.COMMANDKIT_IS_TEST = COMMANDKIT_IS_TEST;
+exports.HMREventType = HMREventType;
+exports.isBuildLikeEnvironment = isBuildLikeEnvironment;
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../../src/utils/constants.ts"],"sourcesContent":["/**\n * The current working directory of the CommandKit instance.\n */\nexport const COMMANDKIT_CWD = process.env.COMMANDKIT_CWD || process.cwd();\n\n/**\n * Indicates whether CommandKit is running in development mode.\n */\nexport const COMMANDKIT_IS_DEV = process.env.COMMANDKIT_IS_DEV === 'true';\n\n/**\n * Indicates whether CommandKit is running in CLI thread.\n */\nexport const COMMANDKIT_IS_CLI = process.env.COMMANDKIT_IS_CLI === 'true';\n\n/**\n * Indicates whether CommandKit is running in test mode.\n */\nexport const COMMANDKIT_IS_TEST = process.env.COMMANDKIT_IS_TEST === 'true';\n\n/**\n * Indicates that CommandKit is running in a build-like environment.\n * @private\n * @internal\n */\nexport function isBuildLikeEnvironment() {\n  const isCLI = process.env.COMMANDKIT_INTERNAL_IS_CLI_PROCESS === 'true';\n  if (isCLI) return true;\n\n  return process.env.COMMANDKIT_IS_BUILD === 'true';\n}\n\n/**\n * The current bootstrap mode of CommandKit.\n * This can be 'development' or 'production'.\n */\nexport const COMMANDKIT_BOOTSTRAP_MODE = (process.env\n  .COMMANDKIT_BOOTSTRAP_MODE || 'development') as 'development' | 'production';\n\n/**\n * Types of Hot Module Replacement events\n */\nexport const HMREventType = {\n  /**\n   * HMR event for reloading commands.\n   */\n  ReloadCommands: 'reload-commands',\n  /**\n   * HMR event for reloading events.\n   */\n  ReloadEvents: 'reload-events',\n  /**\n   * HMR event for reloading unknown path, typically used by the plugins.\n   */\n  Unknown: 'unknown',\n} as const;\n\n/**\n * The type for HMR events.\n */\nexport type HMREventType = (typeof HMREventType)[keyof typeof HMREventType];\n"],"mappings":";;;;;;AAGA,MAAa,iBAAiB,QAAQ,IAAI,kBAAkB,QAAQ,KAAK;;;;AAKzE,MAAa,oBAAoB,QAAQ,IAAI,sBAAsB;;;;AAKnE,MAAa,oBAAoB,QAAQ,IAAI,sBAAsB;;;;AAKnE,MAAa,qBAAqB,QAAQ,IAAI,uBAAuB;;;;;;AAOrE,SAAgB,yBAAyB;AAEvC,KADc,QAAQ,IAAI,uCAAuC,OACtD,QAAO;AAElB,QAAO,QAAQ,IAAI,wBAAwB;;;;;;AAO7C,MAAa,4BAA6B,QAAQ,IAClD,6BAA6B;;;;AAK7B,MAAa,eAAe;CAI1B,gBAAgB;CAIhB,cAAc;CAId,SAAS;CACV"}

package/dist/utils/dev-hooks.d.ts

@@ -1,2 +1,2 @@
-import { et as CommandKitHMREvent, nt as registerDevHooks, tt as IpcMessageCommand } from "../analytics-engine-_urJ5QTH.js";
+import { et as CommandKitHMREvent, nt as registerDevHooks, tt as IpcMessageCommand } from "../analytics-engine-DnRsHBId.js";
 export { CommandKitHMREvent, IpcMessageCommand, registerDevHooks };

package/dist/utils/dev-hooks.js

@@ -1,21 +1,4 @@
-require('../colors-Csc0X4QJ.js');
-require('../ActionRow-CSN_UKmM.js');
-const require_commandkit = require('../commandkit-B1_NP74k.js');
-require('../constants-CeIMhMD0.js');
-require('../types-package-Bjh_ap0V.js');
-require('../constants-BA0TJU6e.js');
-require('../EventWorkerContext-CfqamFWu.js');
-require('../signals-ewEPW2cO.js');
-require('../helpers-DSy7EjzP.js');
-require('../MessageCommandParser-VMFFGs0R.js');
-require('../CommandsRouter-D5mGRFEr.js');
-require('../EventsRouter-Be5NDOX4.js');
-require('../router-CtcApqrw.js');
-require('../file-DqI3v90P.js');
-require('../separator-DGwA_b1J.js');
-require('../text-display-BVuG7dT-.js');
-require('../poll-ziQQQbMU.js');
-require('../common-zQwj90Nz.js');
-require('../store-DK4JA-fQ.js');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_commandkit = require('../commandkit--k6yDJEr.js');
 
 exports.registerDevHooks = require_commandkit.registerDevHooks;

package/dist/utils/error-codes.d.ts

@@ -4,24 +4,24 @@
  */
 declare const CommandKitErrorCodes: {
   /**
-       * Error code for exiting middleware.
-       */
+   * Error code for exiting middleware.
+   */
   readonly StopMiddlewares: symbol;
   /**
-       * Error code for forwarded commands.
-       */
+   * Error code for forwarded commands.
+   */
   readonly ForwardedCommand: symbol;
   /**
-       * Error code for invalid command prefix.
-       */
+   * Error code for invalid command prefix.
+   */
   readonly InvalidCommandPrefix: symbol;
   /**
-       * Error code for plugin capture handle.
-       */
+   * Error code for plugin capture handle.
+   */
   readonly PluginCaptureHandle: symbol;
   /**
-       * Error code for event interruption signal
-       */
+   * Error code for event interruption signal
+   */
   readonly StopEvents: symbol;
 };
 /**

package/dist/utils/error-codes.js

@@ -1,6 +1,54 @@
-const require_error_codes = require('../error-codes-Ds0bnPvT.js');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-exports.CommandKitErrorCodes = require_error_codes.CommandKitErrorCodes;
-exports.createCommandKitError = require_error_codes.createCommandKitError;
-exports.isCommandKitError = require_error_codes.isCommandKitError;
-exports.isErrorType = require_error_codes.isErrorType;
+//#region src/utils/error-codes.ts
+/**
+* The error codes used by CommandKit.
+*/
+const CommandKitErrorCodes = {
+	StopMiddlewares: Symbol("kStopMiddlewares"),
+	ForwardedCommand: Symbol("kForwardedCommand"),
+	InvalidCommandPrefix: Symbol("kInvalidCommandPrefix"),
+	PluginCaptureHandle: Symbol("kPluginCaptureHandle"),
+	StopEvents: Symbol("kStopEvents")
+};
+/**
+* Creates a new CommandKit error with the specified code.
+* @param code The error code to assign to the error.
+* @returns A new CommandKit error instance.
+*/
+function createCommandKitError(code) {
+	const error = /* @__PURE__ */ new Error();
+	Reflect.set(error, "code", code);
+	return error;
+}
+/**
+* Checks if the given error is a CommandKit error.
+* @param error The error to check.
+* @returns True if the error is a CommandKit error, false otherwise.
+*/
+function isCommandKitError(error) {
+	if (!(error instanceof Error)) return false;
+	const code = Reflect.get(error, "code");
+	for (const key in CommandKitErrorCodes) if (CommandKitErrorCodes[key] === code) return true;
+	return false;
+}
+/**
+* Checks if the given error is of a specific CommandKit error type.
+* @param error The error to check.
+* @param code The error code or an array of error codes to check against.
+* @returns True if the error matches the specified code(s), false otherwise.
+*/
+function isErrorType(error, code) {
+	if (!isCommandKitError(error)) return false;
+	const errorCode = Reflect.get(error, "code");
+	if (!errorCode) return false;
+	if (Array.isArray(code)) return code.includes(errorCode);
+	return errorCode === code;
+}
+
+//#endregion
+exports.CommandKitErrorCodes = CommandKitErrorCodes;
+exports.createCommandKitError = createCommandKitError;
+exports.isCommandKitError = isCommandKitError;
+exports.isErrorType = isErrorType;
+//# sourceMappingURL=error-codes.js.map

package/dist/utils/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","names":[],"sources":["../../src/utils/error-codes.ts"],"sourcesContent":["/**\n * The error codes used by CommandKit.\n */\nexport const CommandKitErrorCodes = {\n  /**\n   * Error code for exiting middleware.\n   */\n  StopMiddlewares: Symbol('kStopMiddlewares'),\n  /**\n   * Error code for forwarded commands.\n   */\n  ForwardedCommand: Symbol('kForwardedCommand'),\n  /**\n   * Error code for invalid command prefix.\n   */\n  InvalidCommandPrefix: Symbol('kInvalidCommandPrefix'),\n  /**\n   * Error code for plugin capture handle.\n   */\n  PluginCaptureHandle: Symbol('kPluginCaptureHandle'),\n  /**\n   * Error code for event interruption signal\n   */\n  StopEvents: Symbol('kStopEvents'),\n} as const;\n\n/**\n * The type for CommandKit errors.\n */\nexport type CommandKitError = Error & { code: symbol };\n\n/**\n * Creates a new CommandKit error with the specified code.\n * @param code The error code to assign to the error.\n * @returns A new CommandKit error instance.\n */\nexport function createCommandKitError(code: symbol): CommandKitError {\n  const error = new Error() as CommandKitError;\n\n  Reflect.set(error, 'code', code);\n\n  return error;\n}\n\n/**\n * Checks if the given error is a CommandKit error.\n * @param error The error to check.\n * @returns True if the error is a CommandKit error, false otherwise.\n */\nexport function isCommandKitError(error: unknown): error is CommandKitError {\n  if (!(error instanceof Error)) return false;\n  const code = Reflect.get(error, 'code');\n\n  for (const key in CommandKitErrorCodes) {\n    if (CommandKitErrorCodes[key as keyof typeof CommandKitErrorCodes] === code)\n      return true;\n  }\n\n  return false;\n}\n\n/**\n * Checks if the given error is of a specific CommandKit error type.\n * @param error The error to check.\n * @param code The error code or an array of error codes to check against.\n * @returns True if the error matches the specified code(s), false otherwise.\n */\nexport function isErrorType(error: unknown, code: symbol | symbol[]): boolean {\n  if (!isCommandKitError(error)) return false;\n  const errorCode = Reflect.get(error, 'code');\n\n  if (!errorCode) return false;\n\n  if (Array.isArray(code)) return code.includes(errorCode);\n\n  return errorCode === code;\n}\n"],"mappings":";;;;;;AAGA,MAAa,uBAAuB;CAIlC,iBAAiB,OAAO,mBAAmB;CAI3C,kBAAkB,OAAO,oBAAoB;CAI7C,sBAAsB,OAAO,wBAAwB;CAIrD,qBAAqB,OAAO,uBAAuB;CAInD,YAAY,OAAO,cAAc;CAClC;;;;;;AAYD,SAAgB,sBAAsB,MAA+B;CACnE,MAAM,wBAAQ,IAAI,OAAO;AAEzB,SAAQ,IAAI,OAAO,QAAQ,KAAK;AAEhC,QAAO;;;;;;;AAQT,SAAgB,kBAAkB,OAA0C;AAC1E,KAAI,EAAE,iBAAiB,OAAQ,QAAO;CACtC,MAAM,OAAO,QAAQ,IAAI,OAAO,OAAO;AAEvC,MAAK,MAAM,OAAO,qBAChB,KAAI,qBAAqB,SAA8C,KACvE,QAAE;AAGJ,QAAO;;;;;;;;AAST,SAAgB,YAAY,OAAgB,MAAkC;AAC5E,KAAI,CAAC,kBAAkB,MAAM,CAAE,QAAO;CACtC,MAAM,YAAY,QAAQ,IAAI,OAAO,OAAO;AAE5C,KAAI,CAAC,UAAW,QAAO;AAEvB,KAAI,MAAM,QAAQ,KAAK,CAAE,QAAO,KAAK,SAAS,UAAU;AAExD,QAAO,cAAc"}

package/dist/utils/resolve-file-url.js

@@ -1,3 +1,19 @@
-const require_resolve_file_url = require('../resolve-file-url-BmjHzIKe.js');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_chunk = require('../chunk-BE-pF4vm.js');
+let path = require("path");
+path = require_chunk.__toESM(path);
 
-exports.toFileURL = require_resolve_file_url.toFileURL;
+//#region src/utils/resolve-file-url.ts
+/**
+* Convert a local file path to a file URL.
+* @param filePath - The local file's path.
+* @param withTs - Whether to append a timestamp to the URL.
+* @returns - The converted file URL.
+*/
+function toFileURL(filePath, withTs = false) {
+	return `${"file://" + path.default.resolve(filePath).replace(/\\\\|\\/g, "/")}${withTs ? `?ts=${Date.now()}` : ""}`;
+}
+
+//#endregion
+exports.toFileURL = toFileURL;
+//# sourceMappingURL=resolve-file-url.js.map

package/dist/utils/resolve-file-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-file-url.js","names":[],"sources":["../../src/utils/resolve-file-url.ts"],"sourcesContent":["import path from 'path';\n\n/**\n * Convert a local file path to a file URL.\n * @param filePath - The local file's path.\n * @param withTs - Whether to append a timestamp to the URL.\n * @returns - The converted file URL.\n */\nexport function toFileURL(filePath: string, withTs = false) {\n  const resolvedPath = path.resolve(filePath);\n  return `${'file://' + resolvedPath.replace(/\\\\\\\\|\\\\/g, '/')}${withTs ? `?ts=${Date.now()}` : ''}`;\n}\n"],"mappings":";;;;;;;;;;;;AAQA,SAAgB,UAAU,UAAkB,SAAS,OAAO;AAE1D,QAAO,GAAG,YADW,aAAK,QAAQ,SAAS,CACR,QAAQ,YAAY,IAAI,GAAG,SAAS,OAAO,KAAK,KAAK,KAAK"}

package/dist/utils/types-package.js

@@ -1,5 +1,62 @@
-require('../constants-CeIMhMD0.js');
-const require_types_package = require('../types-package-Bjh_ap0V.js');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_chunk = require('../chunk-BE-pF4vm.js');
+const require_utils_constants = require('./constants.js');
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let node_fs_promises = require("node:fs/promises");
 
-exports.generateTypesPackage = require_types_package.generateTypesPackage;
-exports.rewriteCommandDeclaration = require_types_package.rewriteCommandDeclaration;
+//#region src/utils/types-package.ts
+/**
+* @private
+*/
+async function generateTypesPackage(force = false) {
+	const location = (0, node_path.join)(require_utils_constants.COMMANDKIT_CWD, "node_modules", "commandkit-types");
+	if (!require_utils_constants.COMMANDKIT_IS_DEV && !force) return location;
+	const packageJSON = (0, node_path.join)(location, "package.json");
+	const index = (0, node_path.join)(location, "index.js");
+	const types = (0, node_path.join)(location, "index.d.ts");
+	const command = (0, node_path.join)(location, "command.d.ts");
+	const packageJSONContent = {
+		name: "commandkit-types",
+		version: "1.0.0",
+		description: "CommandKit types package",
+		type: "commonjs",
+		main: "index.js",
+		types: "index.d.ts"
+	};
+	const indexContent = `module.exports = {};`;
+	const typesContent = `// Main types index file - imports all type declarations
+import './command';
+export {};
+`;
+	const commandTypesContent = `// Auto-generated command types
+  export {};
+declare module 'commandkit' {
+   type CommandTypeData = string
+}`;
+	await (0, node_fs_promises.mkdir)(location, { recursive: true }).catch(() => {});
+	await (0, node_fs_promises.writeFile)(packageJSON, JSON.stringify(packageJSONContent, null, 2));
+	await (0, node_fs_promises.writeFile)(index, indexContent);
+	await (0, node_fs_promises.writeFile)(types, typesContent);
+	await (0, node_fs_promises.writeFile)(command, commandTypesContent);
+	return location;
+}
+/**
+* @private
+*/
+async function rewriteCommandDeclaration(data) {
+	const commandTypesContent = `// Auto-generated command types
+  declare module 'commandkit' {
+    ${data}
+}
+    export {};
+`;
+	const location = (0, node_path.join)(require_utils_constants.COMMANDKIT_CWD, "node_modules", "commandkit-types");
+	if (!(0, node_fs.existsSync)(location)) return;
+	await (0, node_fs_promises.writeFile)((0, node_path.join)(location, "command.d.ts"), commandTypesContent, { encoding: "utf-8" });
+}
+
+//#endregion
+exports.generateTypesPackage = generateTypesPackage;
+exports.rewriteCommandDeclaration = rewriteCommandDeclaration;
+//# sourceMappingURL=types-package.js.map

package/dist/utils/types-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-package.js","names":[],"sources":["../../src/utils/types-package.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { COMMANDKIT_CWD, COMMANDKIT_IS_DEV } from './constants';\nimport { existsSync } from 'node:fs';\n\n/**\n * @private\n */\nexport async function generateTypesPackage(force = false) {\n  const location = join(COMMANDKIT_CWD, 'node_modules', 'commandkit-types');\n  if (!COMMANDKIT_IS_DEV && !force) return location;\n  const packageJSON = join(location, 'package.json');\n  const index = join(location, 'index.js');\n  const types = join(location, 'index.d.ts');\n  const command = join(location, 'command.d.ts');\n\n  const packageJSONContent = {\n    name: 'commandkit-types',\n    version: '1.0.0',\n    description: 'CommandKit types package',\n    type: 'commonjs',\n    main: 'index.js',\n    types: 'index.d.ts',\n  };\n\n  const indexContent = `module.exports = {};`;\n\n  // Restructuring the type declarations to properly extend rather than replace types\n  const typesContent = `// Main types index file - imports all type declarations\nimport './command';\nexport {};\n`;\n\n  // Properly set up command types to extend the CommandTypeData interface\n  const commandTypesContent = `// Auto-generated command types\n  export {};\ndeclare module 'commandkit' {\n   type CommandTypeData = string\n}`;\n\n  await mkdir(location, { recursive: true }).catch(() => {});\n  await writeFile(packageJSON, JSON.stringify(packageJSONContent, null, 2));\n  await writeFile(index, indexContent);\n  await writeFile(types, typesContent);\n  await writeFile(command, commandTypesContent);\n\n  return location;\n}\n\n/**\n * @private\n */\nexport async function rewriteCommandDeclaration(data: string) {\n  const commandTypesContent = `// Auto-generated command types\n  declare module 'commandkit' {\n    ${data}\n}\n    export {};\n`;\n\n  const location = join(COMMANDKIT_CWD, 'node_modules', 'commandkit-types');\n\n  if (!existsSync(location)) return;\n\n  const type = join(location, 'command.d.ts');\n\n  await writeFile(type, commandTypesContent, { encoding: 'utf-8' });\n}\n"],"mappings":";;;;;;;;;;;AAQA,eAAsB,qBAAqB,QAAQ,OAAO;CACxD,MAAM,+BAAgB,wCAAgB,gBAAgB,mBAAmB;AACzE,KAAI,CAAC,6CAAqB,CAAC,MAAO,QAAO;CACzC,MAAM,kCAAmB,UAAU,eAAe;CAClD,MAAM,4BAAa,UAAU,WAAW;CACxC,MAAM,4BAAa,UAAU,aAAa;CAC1C,MAAM,8BAAe,UAAU,eAAe;CAE9C,MAAM,qBAAqB;EACzB,MAAM;EACN,SAAS;EACT,aAAa;EACb,MAAM;EACN,MAAM;EACN,OAAO;EACR;CAED,MAAM,eAAe;CAGrB,MAAM,eAAe;;;;CAMrB,MAAM,sBAAsB;;;;;AAM5B,mCAAY,UAAU,EAAE,WAAW,MAAM,CAAC,CAAC,YAAY,GAAG;AAC1D,uCAAgB,aAAa,KAAK,UAAU,oBAAoB,MAAM,EAAE,CAAC;AACzE,uCAAgB,OAAO,aAAa;AACpC,uCAAgB,OAAO,aAAa;AACpC,uCAAgB,SAAS,oBAAoB;AAE7C,QAAO;;;;;AAMT,eAAsB,0BAA0B,MAAc;CAC5D,MAAM,sBAAsB;;MAExB,KAAI;;;;CAKR,MAAM,+BAAgB,wCAAgB,gBAAgB,mBAAmB;AAEzE,KAAI,yBAAY,SAAS,CAAE;AAI3B,2DAFkB,UAAU,eAAe,EAErB,qBAAqB,EAAE,UAAU,SAAS,CAAC"}

package/dist/utils/useful-stuff/async-queue.d.ts

@@ -22,43 +22,43 @@ declare class AsyncQueue {
   private queue;
   constructor(options?: AsyncQueueOptions);
   /**
-       * Adds a task to the queue.
-       * @param task - The async function to execute.
-       * @param signal - Optional AbortSignal for cancelling this specific task.
-       * @returns Promise resolving to the result of the task.
-       */
+   * Adds a task to the queue.
+   * @param task - The async function to execute.
+   * @param signal - Optional AbortSignal for cancelling this specific task.
+   * @returns Promise resolving to the result of the task.
+   */
   add<T>(task: AsyncQueueTask<T>, signal?: AbortSignal): Promise<T>;
   /**
-       * Pauses the queue. No new tasks will be started until resumed.
-       */
+   * Pauses the queue. No new tasks will be started until resumed.
+   */
   pause(): void;
   /**
-       * Resumes the queue and processes pending tasks.
-       */
+   * Resumes the queue and processes pending tasks.
+   */
   resume(): void;
   /**
-       * Aborts the queue, rejecting all pending tasks.
-       */
+   * Aborts the queue, rejecting all pending tasks.
+   */
   abort(): void;
   /**
-       * Clears all pending tasks from the queue.
-       */
+   * Clears all pending tasks from the queue.
+   */
   clear(): void;
   /**
-       * Returns the number of running tasks.
-       */
+   * Returns the number of running tasks.
+   */
   getRunning(): number;
   /**
-       * Returns the number of pending tasks in the queue.
-       */
+   * Returns the number of pending tasks in the queue.
+   */
   getPending(): number;
   /**
-       * Returns true if the queue is currently paused.
-       */
+   * Returns true if the queue is currently paused.
+   */
   isPaused(): boolean;
   /**
-       * Returns true if the queue has been aborted.
-       */
+   * Returns true if the queue has been aborted.
+   */
   isAborted(): boolean;
   private next;
 }

package/dist/utils/useful-stuff/async-queue.js

@@ -1,3 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 //#region src/utils/useful-stuff/async-queue.ts
 var AsyncQueue = class {

package/dist/utils/useful-stuff/async-queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"async-queue.js","names":[],"sources":["../../../src/utils/useful-stuff/async-queue.ts"],"sourcesContent":["/**\n * Async queue implementation for processing tasks sequentially or with limited concurrency.\n * Useful for rate-limiting, batching, or controlling resource usage.\n */\n\nexport interface AsyncQueueOptions {\n  /** Maximum number of concurrent tasks. Default: 1 (sequential) */\n  concurrency?: number;\n  /** Optional callback invoked when all tasks are completed */\n  onDrain?: () => void | Promise<void>;\n  /** Optional AbortSignal for cancelling the queue */\n  signal?: AbortSignal;\n}\n\nexport type AsyncQueueTask<T> = () => Promise<T>;\n\nexport class AsyncQueue {\n  private readonly concurrency: number;\n  private readonly onDrain?: () => void | Promise<void>;\n  private readonly signal?: AbortSignal;\n  private running = 0;\n  private paused = false;\n  private aborted = false;\n  private queue: Array<() => void> = [];\n\n  constructor(options: AsyncQueueOptions = {}) {\n    this.concurrency = options.concurrency ?? 1;\n    this.onDrain = options.onDrain;\n    this.signal = options.signal;\n\n    if (this.signal) {\n      this.signal.addEventListener('abort', () => {\n        this.abort();\n      });\n    }\n  }\n\n  /**\n   * Adds a task to the queue.\n   * @param task - The async function to execute.\n   * @param signal - Optional AbortSignal for cancelling this specific task.\n   * @returns Promise resolving to the result of the task.\n   */\n  public add<T>(task: AsyncQueueTask<T>, signal?: AbortSignal): Promise<T> {\n    if (this.aborted) {\n      return Promise.reject(new Error('Queue has been aborted'));\n    }\n\n    return new Promise<T>((resolve, reject) => {\n      const run = async () => {\n        if (this.paused || this.aborted) {\n          if (this.aborted) {\n            reject(new Error('Queue has been aborted'));\n          } else {\n            this.queue.push(run);\n          }\n          return;\n        }\n\n        // Check if task-specific signal is aborted\n        if (signal?.aborted) {\n          reject(new Error('Task was aborted'));\n          return;\n        }\n\n        this.running++;\n        try {\n          const result = await task();\n          resolve(result);\n        } catch (err) {\n          reject(err);\n        } finally {\n          this.running--;\n          this.next();\n        }\n      };\n\n      if (this.running < this.concurrency && !this.paused && !this.aborted) {\n        run();\n      } else {\n        this.queue.push(run);\n      }\n    });\n  }\n\n  /**\n   * Pauses the queue. No new tasks will be started until resumed.\n   */\n  public pause() {\n    this.paused = true;\n  }\n\n  /**\n   * Resumes the queue and processes pending tasks.\n   */\n  public resume() {\n    if (!this.paused) return;\n    this.paused = false;\n    this.next();\n  }\n\n  /**\n   * Aborts the queue, rejecting all pending tasks.\n   */\n  public abort() {\n    this.aborted = true;\n    this.clear();\n  }\n\n  /**\n   * Clears all pending tasks from the queue.\n   */\n  public clear() {\n    this.queue = [];\n  }\n\n  /**\n   * Returns the number of running tasks.\n   */\n  public getRunning(): number {\n    return this.running;\n  }\n\n  /**\n   * Returns the number of pending tasks in the queue.\n   */\n  public getPending(): number {\n    return this.queue.length;\n  }\n\n  /**\n   * Returns true if the queue is currently paused.\n   */\n  public isPaused(): boolean {\n    return this.paused;\n  }\n\n  /**\n   * Returns true if the queue has been aborted.\n   */\n  public isAborted(): boolean {\n    return this.aborted;\n  }\n\n  private next() {\n    if (this.paused || this.aborted) return;\n    while (this.running < this.concurrency && this.queue.length > 0) {\n      const fn = this.queue.shift();\n      if (fn) fn();\n    }\n    if (this.running === 0 && this.queue.length === 0 && this.onDrain) {\n      this.onDrain();\n    }\n  }\n}\n\n/**\n * Creates a new async queue instance with the specified configuration.\n * @param options - Configuration options for the async queue.\n * @returns New AsyncQueue instance.\n *\n * @example\n * ```typescript\n * const controller = new AbortController();\n * const queue = createAsyncQueue({\n *   concurrency: 2,\n *   signal: controller.signal\n * });\n * queue.add(async () => await doSomething());\n * controller.abort(); // Aborts the queue\n * ```\n */\nexport function createAsyncQueue(options?: AsyncQueueOptions): AsyncQueue {\n  return new AsyncQueue(options);\n}\n"],"mappings":";;AAgBA,IAAa,aAAb,MAAwB;CACtB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAQ,UAAU;CAClB,AAAQ,SAAS;CACjB,AAAQ,UAAU;CAClB,AAAQ,QAA2B,EAAE;CAErC,YAAY,UAA6B,EAAE,EAAE;AAC3C,OAAK,cAAc,QAAQ,eAAe;AAC1C,OAAK,UAAU,QAAQ;AACvB,OAAK,SAAS,QAAQ;AAEtB,MAAI,KAAK,OACP,MAAK,OAAO,iBAAiB,eAAe;AAC1C,QAAK,OAAO;IACZ;;;;;;;;CAUN,AAAO,IAAO,MAAyB,QAAkC;AACvE,MAAI,KAAK,QACP,QAAO,QAAQ,uBAAO,IAAI,MAAM,yBAAyB,CAAC;AAG5D,SAAO,IAAI,SAAY,SAAS,WAAW;GACzC,MAAM,MAAM,YAAY;AACtB,QAAI,KAAK,UAAU,KAAK,SAAS;AAC/B,SAAI,KAAK,QACP,wBAAO,IAAI,MAAM,yBAAyB,CAAC;SAE3C,MAAK,MAAM,KAAK,IAAI;AAEtB;;AAIF,wDAAI,OAAQ,SAAS;AACnB,4BAAO,IAAI,MAAM,mBAAmB,CAAC;AACrC;;AAGF,SAAK;AACL,QAAI;AAEF,aADe,MAAM,MAAM,CACZ;aACR,KAAK;AACZ,YAAO,IAAI;cACH;AACR,UAAK;AACL,UAAK,MAAM;;;AAIf,OAAI,KAAK,UAAU,KAAK,eAAe,CAAC,KAAK,UAAU,CAAC,KAAK,QAC3D,MAAK;OAEL,MAAK,MAAM,KAAK,IAAI;IAEtB;;;;;CAMJ,AAAO,QAAQ;AACb,OAAK,SAAS;;;;;CAMhB,AAAO,SAAS;AACd,MAAI,CAAC,KAAK,OAAQ;AAClB,OAAK,SAAS;AACd,OAAK,MAAM;;;;;CAMb,AAAO,QAAQ;AACb,OAAK,UAAU;AACf,OAAK,OAAO;;;;;CAMd,AAAO,QAAQ;AACb,OAAK,QAAQ,EAAE;;;;;CAMjB,AAAO,aAAqB;AAC1B,SAAO,KAAK;;;;;CAMd,AAAO,aAAqB;AAC1B,SAAO,KAAK,MAAM;;;;;CAMpB,AAAO,WAAoB;AACzB,SAAO,KAAK;;;;;CAMd,AAAO,YAAqB;AAC1B,SAAO,KAAK;;CAGd,AAAQ,OAAO;AACb,MAAI,KAAK,UAAU,KAAK,QAAS;AACjC,SAAO,KAAK,UAAU,KAAK,eAAe,KAAK,MAAM,SAAS,GAAG;GAC/D,MAAM,KAAK,KAAK,MAAM,OAAO;AAC7B,OAAI,GAAI,KAAI;;AAEd,MAAI,KAAK,YAAY,KAAK,KAAK,MAAM,WAAW,KAAK,KAAK,QACxD,MAAK,SAAS;;;;;;;;;;;;;;;;;;;AAqBpB,SAAgB,iBAAiB,SAAyC;AACxE,QAAO,IAAI,WAAW,QAAQ"}
+{"version":3,"file":"async-queue.js","names":[],"sources":["../../../src/utils/useful-stuff/async-queue.ts"],"sourcesContent":["/**\n * Async queue implementation for processing tasks sequentially or with limited concurrency.\n * Useful for rate-limiting, batching, or controlling resource usage.\n */\n\nexport interface AsyncQueueOptions {\n  /** Maximum number of concurrent tasks. Default: 1 (sequential) */\n  concurrency?: number;\n  /** Optional callback invoked when all tasks are completed */\n  onDrain?: () => void | Promise<void>;\n  /** Optional AbortSignal for cancelling the queue */\n  signal?: AbortSignal;\n}\n\nexport type AsyncQueueTask<T> = () => Promise<T>;\n\nexport class AsyncQueue {\n  private readonly concurrency: number;\n  private readonly onDrain?: () => void | Promise<void>;\n  private readonly signal?: AbortSignal;\n  private running = 0;\n  private paused = false;\n  private aborted = false;\n  private queue: Array<() => void> = [];\n\n  constructor(options: AsyncQueueOptions = {}) {\n    this.concurrency = options.concurrency ?? 1;\n    this.onDrain = options.onDrain;\n    this.signal = options.signal;\n\n    if (this.signal) {\n      this.signal.addEventListener('abort', () => {\n        this.abort();\n      });\n    }\n  }\n\n  /**\n   * Adds a task to the queue.\n   * @param task - The async function to execute.\n   * @param signal - Optional AbortSignal for cancelling this specific task.\n   * @returns Promise resolving to the result of the task.\n   */\n  public add<T>(task: AsyncQueueTask<T>, signal?: AbortSignal): Promise<T> {\n    if (this.aborted) {\n      return Promise.reject(new Error('Queue has been aborted'));\n    }\n\n    return new Promise<T>((resolve, reject) => {\n      const run = async () => {\n        if (this.paused || this.aborted) {\n          if (this.aborted) {\n            reject(new Error('Queue has been aborted'));\n          } else {\n            this.queue.push(run);\n          }\n          return;\n        }\n\n        // Check if task-specific signal is aborted\n        if (signal?.aborted) {\n          reject(new Error('Task was aborted'));\n          return;\n        }\n\n        this.running++;\n        try {\n          const result = await task();\n          resolve(result);\n        } catch (err) {\n          reject(err);\n        } finally {\n          this.running--;\n          this.next();\n        }\n      };\n\n      if (this.running < this.concurrency && !this.paused && !this.aborted) {\n        run();\n      } else {\n        this.queue.push(run);\n      }\n    });\n  }\n\n  /**\n   * Pauses the queue. No new tasks will be started until resumed.\n   */\n  public pause() {\n    this.paused = true;\n  }\n\n  /**\n   * Resumes the queue and processes pending tasks.\n   */\n  public resume() {\n    if (!this.paused) return;\n    this.paused = false;\n    this.next();\n  }\n\n  /**\n   * Aborts the queue, rejecting all pending tasks.\n   */\n  public abort() {\n    this.aborted = true;\n    this.clear();\n  }\n\n  /**\n   * Clears all pending tasks from the queue.\n   */\n  public clear() {\n    this.queue = [];\n  }\n\n  /**\n   * Returns the number of running tasks.\n   */\n  public getRunning(): number {\n    return this.running;\n  }\n\n  /**\n   * Returns the number of pending tasks in the queue.\n   */\n  public getPending(): number {\n    return this.queue.length;\n  }\n\n  /**\n   * Returns true if the queue is currently paused.\n   */\n  public isPaused(): boolean {\n    return this.paused;\n  }\n\n  /**\n   * Returns true if the queue has been aborted.\n   */\n  public isAborted(): boolean {\n    return this.aborted;\n  }\n\n  private next() {\n    if (this.paused || this.aborted) return;\n    while (this.running < this.concurrency && this.queue.length > 0) {\n      const fn = this.queue.shift();\n      if (fn) fn();\n    }\n    if (this.running === 0 && this.queue.length === 0 && this.onDrain) {\n      this.onDrain();\n    }\n  }\n}\n\n/**\n * Creates a new async queue instance with the specified configuration.\n * @param options - Configuration options for the async queue.\n * @returns New AsyncQueue instance.\n *\n * @example\n * ```typescript\n * const controller = new AbortController();\n * const queue = createAsyncQueue({\n *   concurrency: 2,\n *   signal: controller.signal\n * });\n * queue.add(async () => await doSomething());\n * controller.abort(); // Aborts the queue\n * ```\n */\nexport function createAsyncQueue(options?: AsyncQueueOptions): AsyncQueue {\n  return new AsyncQueue(options);\n}\n"],"mappings":";;;AAgBA,IAAa,aAAb,MAAwB;CACtB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAQ,UAAU;CAClB,AAAQ,SAAS;CACjB,AAAQ,UAAU;CAClB,AAAQ,QAA2B,EAAE;CAErC,YAAY,UAA6B,EAAE,EAAE;AAC3C,OAAK,cAAc,QAAQ,eAAe;AAC1C,OAAK,UAAU,QAAQ;AACvB,OAAK,SAAS,QAAQ;AAEtB,MAAI,KAAK,OACP,MAAK,OAAO,iBAAiB,eAAe;AAC1C,QAAK,OAAO;IACZ;;;;;;;;CAUN,AAAO,IAAO,MAAyB,QAAkC;AACvE,MAAI,KAAK,QACP,QAAO,QAAQ,uBAAO,IAAI,MAAM,yBAAyB,CAAC;AAG5D,SAAO,IAAI,SAAY,SAAS,WAAW;GACzC,MAAM,MAAM,YAAY;AACtB,QAAI,KAAK,UAAU,KAAK,SAAS;AAC/B,SAAI,KAAK,QACP,wBAAO,IAAI,MAAM,yBAAyB,CAAC;SAE3C,MAAK,MAAM,KAAK,IAAI;AAEtB;;AAIF,wDAAI,OAAQ,SAAS;AACnB,4BAAO,IAAI,MAAM,mBAAmB,CAAC;AACrC;;AAGF,SAAK;AACL,QAAI;AAEF,aADe,MAAM,MAAM,CACZ;aACR,KAAK;AACZ,YAAO,IAAI;cACH;AACR,UAAK;AACL,UAAK,MAAM;;;AAIf,OAAI,KAAK,UAAU,KAAK,eAAe,CAAC,KAAK,UAAU,CAAC,KAAK,QAC3D,MAAK;OAEL,MAAK,MAAM,KAAK,IAAI;IAEtB;;;;;CAMJ,AAAO,QAAQ;AACb,OAAK,SAAS;;;;;CAMhB,AAAO,SAAS;AACd,MAAI,CAAC,KAAK,OAAQ;AAClB,OAAK,SAAS;AACd,OAAK,MAAM;;;;;CAMb,AAAO,QAAQ;AACb,OAAK,UAAU;AACf,OAAK,OAAO;;;;;CAMd,AAAO,QAAQ;AACb,OAAK,QAAQ,EAAE;;;;;CAMjB,AAAO,aAAqB;AAC1B,SAAO,KAAK;;;;;CAMd,AAAO,aAAqB;AAC1B,SAAO,KAAK,MAAM;;;;;CAMpB,AAAO,WAAoB;AACzB,SAAO,KAAK;;;;;CAMd,AAAO,YAAqB;AAC1B,SAAO,KAAK;;CAGd,AAAQ,OAAO;AACb,MAAI,KAAK,UAAU,KAAK,QAAS;AACjC,SAAO,KAAK,UAAU,KAAK,eAAe,KAAK,MAAM,SAAS,GAAG;GAC/D,MAAM,KAAK,KAAK,MAAM,OAAO;AAC7B,OAAI,GAAI,KAAI;;AAEd,MAAI,KAAK,YAAY,KAAK,KAAK,MAAM,WAAW,KAAK,KAAK,QACxD,MAAK,SAAS;;;;;;;;;;;;;;;;;;;AAqBpB,SAAgB,iBAAiB,SAAyC;AACxE,QAAO,IAAI,WAAW,QAAQ"}

package/dist/utils/useful-stuff/mutex.d.ts

@@ -9,24 +9,24 @@
  */
 interface MutexStorage {
   /**
-       * Attempts to acquire a lock for a given key
-       * @param key - The unique identifier for the mutex lock
-       * @param timeout - Optional timeout in milliseconds for the lock
-       * @param signal - Optional AbortSignal for cancelling the acquisition
-       * @returns Promise resolving to true if lock was acquired, false if timeout or already locked
-       */
+   * Attempts to acquire a lock for a given key
+   * @param key - The unique identifier for the mutex lock
+   * @param timeout - Optional timeout in milliseconds for the lock
+   * @param signal - Optional AbortSignal for cancelling the acquisition
+   * @returns Promise resolving to true if lock was acquired, false if timeout or already locked
+   */
   acquire(key: string, timeout?: number, signal?: AbortSignal): Promise<boolean>;
   /**
-       * Releases the lock for a given key
-       * @param key - The unique identifier for the mutex lock
-       * @returns Promise that resolves when the lock is released
-       */
+   * Releases the lock for a given key
+   * @param key - The unique identifier for the mutex lock
+   * @returns Promise that resolves when the lock is released
+   */
   release(key: string): Promise<void>;
   /**
-       * Checks if a lock is currently held for a given key
-       * @param key - The unique identifier for the mutex lock
-       * @returns Promise resolving to true if the lock is held, false otherwise
-       */
+   * Checks if a lock is currently held for a given key
+   * @param key - The unique identifier for the mutex lock
+   * @returns Promise resolving to true if the lock is held, false otherwise
+   */
   isLocked(key: string): Promise<boolean>;
 }
 /**
@@ -45,24 +45,24 @@ interface MutexOptions {
 declare class MemoryMutexStorage implements MutexStorage {
   private readonly locks;
   /**
-       * Attempts to acquire a lock for a given key
-       * @param key - The unique identifier for the mutex lock
-       * @param timeout - Optional timeout in milliseconds for the lock
-       * @param signal - Optional AbortSignal for cancelling the acquisition
-       * @returns Promise resolving to true if lock was acquired, false if timeout or already locked
-       */
+   * Attempts to acquire a lock for a given key
+   * @param key - The unique identifier for the mutex lock
+   * @param timeout - Optional timeout in milliseconds for the lock
+   * @param signal - Optional AbortSignal for cancelling the acquisition
+   * @returns Promise resolving to true if lock was acquired, false if timeout or already locked
+   */
   acquire(key: string, timeout?: number, signal?: AbortSignal): Promise<boolean>;
   /**
-       * Releases the lock for a given key
-       * @param key - The unique identifier for the mutex lock
-       * @returns Promise that resolves when the lock is released
-       */
+   * Releases the lock for a given key
+   * @param key - The unique identifier for the mutex lock
+   * @returns Promise that resolves when the lock is released
+   */
   release(key: string): Promise<void>;
   /**
-       * Checks if a lock is currently held for a given key
-       * @param key - The unique identifier for the mutex lock
-       * @returns Promise resolving to true if the lock is held, false otherwise
-       */
+   * Checks if a lock is currently held for a given key
+   * @param key - The unique identifier for the mutex lock
+   * @returns Promise resolving to true if the lock is held, false otherwise
+   */
   isLocked(key: string): Promise<boolean>;
   private generateHolderId;
   private delay;
@@ -75,54 +75,54 @@ declare class Mutex {
   private storage;
   private readonly defaultTimeout;
   /**
-       * Creates a new mutex instance
-       * @param options - Configuration options for the mutex
-       */
+   * Creates a new mutex instance
+   * @param options - Configuration options for the mutex
+   */
   constructor(options?: MutexOptions);
   /**
-       * Sets the storage implementation for the mutex
-       * @param storage - The storage implementation to use
-       */
+   * Sets the storage implementation for the mutex
+   * @param storage - The storage implementation to use
+   */
   setStorage(storage: MutexStorage): void;
   /**
-       * Gets the storage implementation for the mutex
-       * @returns The storage implementation
-       */
+   * Gets the storage implementation for the mutex
+   * @returns The storage implementation
+   */
   getStorage(): MutexStorage;
   /**
-       * Acquires a lock for the given key
-       * @param key - The unique identifier for the mutex lock
-       * @param timeout - Optional timeout in milliseconds for lock acquisition
-       * @param signal - Optional AbortSignal for cancelling the acquisition
-       * @returns Promise resolving to true if lock was acquired, false if timeout
-       */
+   * Acquires a lock for the given key
+   * @param key - The unique identifier for the mutex lock
+   * @param timeout - Optional timeout in milliseconds for lock acquisition
+   * @param signal - Optional AbortSignal for cancelling the acquisition
+   * @returns Promise resolving to true if lock was acquired, false if timeout
+   */
   acquire(key: string, timeout?: number, signal?: AbortSignal): Promise<boolean>;
   /**
-       * Releases the lock for the given key
-       * @param key - The unique identifier for the mutex lock
-       * @returns Promise that resolves when the lock is released
-       */
+   * Releases the lock for the given key
+   * @param key - The unique identifier for the mutex lock
+   * @returns Promise that resolves when the lock is released
+   */
   release(key: string): Promise<void>;
   /**
-       * Checks if a lock is currently held for the given key
-       * @param key - The unique identifier for the mutex lock
-       * @returns Promise resolving to true if the lock is held, false otherwise
-       */
+   * Checks if a lock is currently held for the given key
+   * @param key - The unique identifier for the mutex lock
+   * @returns Promise resolving to true if the lock is held, false otherwise
+   */
   isLocked(key: string): Promise<boolean>;
   /**
-       * Executes a function with exclusive access to the resource
-       * @param key - The unique identifier for the mutex lock
-       * @param fn - The function to execute with exclusive access
-       * @param timeout - Optional timeout in milliseconds for lock acquisition
-       * @param signal - Optional AbortSignal for cancelling the lock acquisition
-       * @returns Promise resolving to the result of the function execution
-       * @throws Error if lock acquisition fails or function execution fails
-       */
+   * Executes a function with exclusive access to the resource
+   * @param key - The unique identifier for the mutex lock
+   * @param fn - The function to execute with exclusive access
+   * @param timeout - Optional timeout in milliseconds for lock acquisition
+   * @param signal - Optional AbortSignal for cancelling the lock acquisition
+   * @returns Promise resolving to the result of the function execution
+   * @throws Error if lock acquisition fails or function execution fails
+   */
   withLock<T>(key: string, fn: () => Promise<T> | T, timeout?: number, signal?: AbortSignal): Promise<T>;
   /**
-       * Gets the current configuration of the mutex
-       * @returns Object containing the current timeout value
-       */
+   * Gets the current configuration of the mutex
+   * @returns Object containing the current timeout value
+   */
   getConfig(): Omit<MutexOptions, 'storage'>;
 }
 /**

package/dist/utils/useful-stuff/mutex.js

@@ -1,3 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 //#region src/utils/useful-stuff/mutex.ts
 /**