commandkit 1.0.0-dev.20250611020404 → 1.0.0-dev.20250611125312

package/dist/CommandKit.d.ts

@@ -1,32 +1,32 @@
-import { BootstrapFunction, CommandKit, CommandKitConfiguration, commandkit, onApplicationBootstrap, onBootstrap } from "./CommandKit-B-mjdP5x.js";
-import "./EventInterceptor-D_oEWSnF.js";
-import "./ButtonKit-BSI7lCI0.js";
-import "./ModalKit-CKtQ8eXW.js";
-import "./element-D_nyVwgB.js";
-import "./ActionRow-D0wafJhZ.js";
+import { BootstrapFunction, CommandKit, CommandKitConfiguration, commandkit, onApplicationBootstrap, onBootstrap } from "./CommandKit-BkMUDbou.js";
+import "./EventInterceptor-x-R2qshQ.js";
+import "./ButtonKit-C7r7RPNf.js";
+import "./ModalKit-Btz58KYn.js";
+import "./element-CAXu1XtK.js";
+import "./ActionRow-DKnFVDME.js";
 import "./types-CJ-XvOFN.js";
-import "./Button-Bl5nbwTS.js";
-import "./Modal-Cxm6cs5c.js";
-import "./common-pvPJVTfe.js";
-import "./StringSelectMenuKit-B9FHTe48.js";
-import "./ChannelSelectMenuKit-L15A2jpT.js";
-import "./MentionableSelectMenuKit-BiUSKUtZ.js";
-import "./UserSelectMenuKit-DiP0imyo.js";
-import "./RoleSelectMenuKit-BSMKkru2.js";
-import "./SelectMenu-b7jgrkjO.js";
-import "./container-CwEATQy2.js";
-import "./file-BdyYwkaI.js";
-import "./media-gallery-DCu02VXc.js";
-import "./section-fktaECHL.js";
-import "./separator-CuesaLrC.js";
-import "./text-display-DNMwmGHJ.js";
+import "./Button-4ZUXdA56.js";
+import "./Modal-C6UTRdYQ.js";
+import "./common-DOCvOVC4.js";
+import "./StringSelectMenuKit-Bhs8U6WI.js";
+import "./ChannelSelectMenuKit-BrXvBYNH.js";
+import "./MentionableSelectMenuKit-CPTKqx-O.js";
+import "./UserSelectMenuKit-CfqFJdxz.js";
+import "./RoleSelectMenuKit-C26lU3sN.js";
+import "./SelectMenu-Diy87_ba.js";
+import "./container-DaUKKPm-.js";
+import "./file-DTrr-p09.js";
+import "./media-gallery-BMsXSot3.js";
+import "./section-Dh_FhPeC.js";
+import "./separator-CMf6Cyy5.js";
+import "./text-display-DRw3r_lK.js";
 import "./index-Dw5cCt-A.js";
 import "./index-E7Wvm5uX.js";
-import "./MessageCommandParser-tzroBwij.js";
+import "./MessageCommandParser-ROLibZPX.js";
 import "./signals-DUoWkeZ7.js";
-import "./helpers-DAmE106r.js";
-import "./CommandsRouter-C7X-eXE2.js";
+import "./helpers-Wg6P5fRQ.js";
+import "./CommandsRouter-CoOA7hkf.js";
 import "./EventsRouter-BacqK6z3.js";
 import "./index-CUPkUUOR.js";
-import "./constants-BPWSrMkn.js";
+import "./constants-BTttfrm3.js";
 export { BootstrapFunction, CommandKit, CommandKitConfiguration, commandkit, onApplicationBootstrap, onBootstrap };

package/dist/CommandKit.js

@@ -1,39 +1,39 @@
 require('./colors-Cd4Oz-r-.js');
 require('./ActionRow-CmTHbo2t.js');
-require('./error-codes-C_UO39jz.js');
-const require_CommandKit = require('./CommandKit-CnLBu_7m.js');
+require('./error-codes-CxlUBdF6.js');
+const require_CommandKit = require('./CommandKit-C0W3U6jh.js');
 require('./common-CcfjYnPG.js');
-require('./common-CeO-vn8Y.js');
-require('./container-CpuiLsZM.js');
-require('./file-DE69SSOP.js');
-require('./media-gallery-nUEHqKVF.js');
-require('./section-D6t7tyEZ.js');
-require('./separator-DYAFK-Jj.js');
-require('./text-display-Dy6JHB5X.js');
+require('./common-vnMIelAE.js');
+require('./container-DCjIgp-B.js');
+require('./file-DVZC0QXI.js');
+require('./media-gallery-CIKypjbJ.js');
+require('./section-CuYr0Inu.js');
+require('./separator-DLdWBjSN.js');
+require('./text-display--p2-BoUa.js');
 require('./v2-DofkPKHs.js');
-require('./warn-unstable-DHLaxPC8.js');
-require('./element-DcqNz1dV.js');
+require('./warn-unstable-CttBdmlS.js');
+require('./element-Cq-LoDjk.js');
 require('./types-B5VPP9ig.js');
-require('./EventInterceptor-Bvh05z7n.js');
-require('./constants-CCqS_v55.js');
-require('./PluginCommon-DPqnQngK.js');
-require('./CompilerPlugin-DrnhOC1c.js');
-require('./RuntimePlugin-BJoDa8ZR.js');
+require('./EventInterceptor-DWCHCGRh.js');
+require('./constants-DDRctWlU.js');
+require('./PluginCommon-D_Z8Oiic.js');
+require('./CompilerPlugin-Bmy4izKz.js');
+require('./RuntimePlugin-CehKbceZ.js');
 require('./types-Bq0EWaM3.js');
-require('./CompilerPluginRuntime-C9wmPMQf.js');
+require('./CompilerPluginRuntime-CgVU_gU0.js');
 require('./runtime-D0JnztkU.js');
-require('./EventWorkerContext-BAKiTqJz.js');
+require('./EventWorkerContext-DxfS_0fJ.js');
 require('./resolve-file-url-ifwdwqmq.js');
-require('./MessageCommandParser-D02-wpZN.js');
-require('./signals-scJdEbly.js');
-require('./constants-DWe181uQ.js');
-require('./types-package-CTSNSM93.js');
-require('./CommandsRouter-BHaPno8o.js');
+require('./MessageCommandParser-Cz-3I-wL.js');
+require('./signals-CSSSZAZ6.js');
+require('./constants-CXwjhIYH.js');
+require('./types-package-BpY3acyl.js');
+require('./CommandsRouter-DFRh47qD.js');
 require('./EventsRouter-CqnrlbjN.js');
 require('./router-Dn35v30f.js');
-require('./common-CW8v7gAn.js');
-require('./CommandKitEventsChannel-B6LKgxmv.js');
-require('./store-Ci6ib2C9.js');
+require('./common-Dasi9oKU.js');
+require('./CommandKitEventsChannel-BL_YN3Rm.js');
+require('./store-x93NXUy_.js');
 
 exports.CommandKit = require_CommandKit.CommandKit;
 exports.commandkit = require_CommandKit.commandkit;

package/dist/CommandKitEventsChannel-BL_YN3Rm.js

@@ -0,0 +1,87 @@
+const require_chunk = require('./chunk-nOFOJqeH.js');
+const node_events = require_chunk.__toESM(require("node:events"));
+
+//#region src/events/CommandKitEventsChannel.ts
+/**
+* Represents a channel for emitting and listening to events in CommandKit.
+* This class provides methods to manage event listeners and emit events
+* within a specific namespace.
+*/
+var CommandKitEventsChannel = class {
+	emitter = new node_events.default();
+	/**
+	* Creates a new instance of CommandKitEventsChannel.
+	* @param commandkit The CommandKit instance that this channel belongs to.
+	*/
+	constructor(commandkit) {
+		this.commandkit = commandkit;
+	}
+	/**
+	* Creates a namespaced event channel. This allows you to manage events
+	* within a specific namespace, preventing conflicts with other event channels.
+	* This is useful for organizing events related to different parts of your application.
+	* @param namespace The namespace for the event channel.
+	* @returns An object containing methods for managing events within the namespace.
+	* @example commandkit.events.to('customNamespace').emit('eventName', data);
+	*/
+	to(namespace) {
+		return {
+			on: this.on.bind(this, namespace),
+			off: this.off.bind(this, namespace),
+			once: this.once.bind(this, namespace),
+			emit: this.emit.bind(this, namespace),
+			removeAllListeners: this.removeAllListeners.bind(this, namespace)
+		};
+	}
+	/**
+	* Register an event listener for a specific event within the namespace.
+	* @param namespace The namespace for the event channel.
+	* @param event The name of the event to listen for.
+	* @param listener The function to call when the event is emitted.
+	*/
+	on(namespace, event, listener) {
+		this.emitter.on(`${namespace}:${event}`, listener);
+	}
+	/**
+	* Unregister an event listener for a specific event within the namespace.
+	* @param namespace The namespace for the event channel.
+	* @param event The name of the event to stop listening for.
+	* @param listener The function that was registered as the listener.
+	*/
+	off(namespace, event, listener) {
+		this.emitter.off(`${namespace}:${event}`, listener);
+	}
+	/**
+	* Register an event listener that will be called only once for a specific event
+	* within the namespace.
+	* @param namespace The namespace for the event channel.
+	* @param event The name of the event to listen for.
+	* @param listener The function to call when the event is emitted.
+	*/
+	once(namespace, event, listener) {
+		this.emitter.once(`${namespace}:${event}`, listener);
+	}
+	/**
+	* Emit an event within the specified namespace, calling all registered listeners.
+	* @param namespace The namespace for the event channel.
+	* @param event The name of the event to emit.
+	* @param args The arguments to pass to the listeners.
+	* @returns A boolean indicating whether any listeners were called.
+	*/
+	emit(namespace, event, ...args) {
+		return this.emitter.emit(`${namespace}:${event}`, ...args);
+	}
+	removeAllListeners(namespace, event) {
+		if (event) this.emitter.removeAllListeners(`${namespace}:${event}`);
+		else this.emitter.removeAllListeners(namespace);
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'CommandKitEventsChannel', {
+  enumerable: true,
+  get: function () {
+    return CommandKitEventsChannel;
+  }
+});
+//# sourceMappingURL=CommandKitEventsChannel-BL_YN3Rm.js.map

package/dist/CommandKitEventsChannel-BL_YN3Rm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandKitEventsChannel-BL_YN3Rm.js","names":[],"sources":["../src/events/CommandKitEventsChannel.ts"],"sourcesContent":["import EventEmitter from 'node:events';\nimport type { CommandKit } from '../CommandKit';\nimport type { AsyncFunction, GenericFunction } from '../context/async-context';\n\n/**\n * The function type for event listeners.\n */\nexport type ListenerFunction = GenericFunction | AsyncFunction;\n\n/**\n * Represents a channel for emitting and listening to events in CommandKit.\n * This class provides methods to manage event listeners and emit events\n * within a specific namespace.\n */\nexport class CommandKitEventsChannel {\n  private emitter = new EventEmitter();\n\n  /**\n   * Creates a new instance of CommandKitEventsChannel.\n   * @param commandkit The CommandKit instance that this channel belongs to.\n   */\n  public constructor(public readonly commandkit: CommandKit) {}\n\n  /**\n   * Creates a namespaced event channel. This allows you to manage events\n   * within a specific namespace, preventing conflicts with other event channels.\n   * This is useful for organizing events related to different parts of your application.\n   * @param namespace The namespace for the event channel.\n   * @returns An object containing methods for managing events within the namespace.\n   * @example commandkit.events.to('customNamespace').emit('eventName', data);\n   */\n  public to(namespace: string) {\n    return {\n      on: this.on.bind(this, namespace),\n      off: this.off.bind(this, namespace),\n      once: this.once.bind(this, namespace),\n      emit: this.emit.bind(this, namespace),\n      removeAllListeners: this.removeAllListeners.bind(this, namespace),\n    };\n  }\n\n  /**\n   * Register an event listener for a specific event within the namespace.\n   * @param namespace The namespace for the event channel.\n   * @param event The name of the event to listen for.\n   * @param listener The function to call when the event is emitted.\n   */\n  public on(namespace: string, event: string, listener: ListenerFunction) {\n    this.emitter.on(`${namespace}:${event}`, listener);\n  }\n\n  /**\n   * Unregister an event listener for a specific event within the namespace.\n   * @param namespace The namespace for the event channel.\n   * @param event The name of the event to stop listening for.\n   * @param listener The function that was registered as the listener.\n   */\n  public off(namespace: string, event: string, listener: ListenerFunction) {\n    this.emitter.off(`${namespace}:${event}`, listener);\n  }\n\n  /**\n   * Register an event listener that will be called only once for a specific event\n   * within the namespace.\n   * @param namespace The namespace for the event channel.\n   * @param event The name of the event to listen for.\n   * @param listener The function to call when the event is emitted.\n   */\n  public once(namespace: string, event: string, listener: ListenerFunction) {\n    this.emitter.once(`${namespace}:${event}`, listener);\n  }\n\n  /**\n   * Emit an event within the specified namespace, calling all registered listeners.\n   * @param namespace The namespace for the event channel.\n   * @param event The name of the event to emit.\n   * @param args The arguments to pass to the listeners.\n   * @returns A boolean indicating whether any listeners were called.\n   */\n  public emit(namespace: string, event: string, ...args: any[]) {\n    return this.emitter.emit(`${namespace}:${event}`, ...args);\n  }\n\n  /**\n   * Remove all listeners for a specific event or all events within the namespace.\n   * @param namespace The namespace for the event channel.\n   * @param event The name of the event to remove listeners for. If not provided, all listeners for all events in the namespace will be removed.\n   */\n  public removeAllListeners(namespace: string): void;\n  public removeAllListeners(namespace: string, event: string): void;\n  public removeAllListeners(namespace: string, event?: string): void {\n    if (event) {\n      this.emitter.removeAllListeners(`${namespace}:${event}`);\n    } else {\n      this.emitter.removeAllListeners(namespace);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AAcA,IAAa,0BAAb,MAAqC;CACnC,AAAQ,UAAU,IAAI;;;;;CAMtB,AAAO,YAA4B,YAAwB;EAAxB;CAAyB;;;;;;;;;CAU5D,AAAO,GAAG,WAAmB;AAC3B,SAAO;GACL,IAAI,KAAK,GAAG,KAAK,MAAM,UAAU;GACjC,KAAK,KAAK,IAAI,KAAK,MAAM,UAAU;GACnC,MAAM,KAAK,KAAK,KAAK,MAAM,UAAU;GACrC,MAAM,KAAK,KAAK,KAAK,MAAM,UAAU;GACrC,oBAAoB,KAAK,mBAAmB,KAAK,MAAM,UAAU;EAClE;CACH;;;;;;;CAQA,AAAO,GAAG,WAAmB,OAAe,UAA4B;AACtE,OAAK,QAAQ,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS;CACpD;;;;;;;CAQA,AAAO,IAAI,WAAmB,OAAe,UAA4B;AACvE,OAAK,QAAQ,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS;CACrD;;;;;;;;CASA,AAAO,KAAK,WAAmB,OAAe,UAA4B;AACxE,OAAK,QAAQ,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS;CACtD;;;;;;;;CASA,AAAO,KAAK,WAAmB,OAAe,GAAG,MAAa;AAC5D,SAAO,KAAK,QAAQ,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,GAAG,KAAK;CAC5D;CASA,AAAO,mBAAmB,WAAmB,OAAsB;AACjE,MAAI,MACF,MAAK,QAAQ,oBAAoB,EAAE,UAAU,GAAG,MAAM,EAAE;MAExD,MAAK,QAAQ,mBAAmB,UAAU;CAE9C;AACF"}

package/dist/CommandsRouter-CoOA7hkf.d.ts

@@ -0,0 +1,146 @@
+import { Collection } from "discord.js";
+
+//#region src/app/router/CommandsRouter.d.ts
+
+/**
+ * Represents a command with its metadata and middleware associations.
+ */
+interface Command {
+  id: string;
+  name: string;
+  path: string;
+  relativePath: string;
+  parentPath: string;
+  middlewares: Array<string>;
+  category: string | null;
+}
+/**
+ * Represents a middleware with its metadata and scope.
+ */
+interface Middleware {
+  id: string;
+  name: string;
+  path: string;
+  relativePath: string;
+  parentPath: string;
+  global: boolean;
+  command: string | null;
+}
+/**
+ * Data structure containing parsed commands and middleware.
+ */
+interface ParsedCommandData {
+  commands: Record<string, Command>;
+  middlewares: Record<string, Middleware>;
+}
+/**
+ * Configuration options for the commands router.
+ */
+interface CommandsRouterOptions {
+  entrypoint: string;
+}
+/**
+ * Handles discovery and parsing of command and middleware files in the filesystem.
+ */
+declare class CommandsRouter {
+  private readonly options;
+  /**
+   * @private
+   * @internal
+   */
+  private commands;
+  /**
+   * @private
+   * @internal
+   */
+  private middlewares;
+  /**
+   * Creates a new CommandsRouter instance.
+   * @param options - Configuration options for the router
+   */
+  constructor(options: CommandsRouterOptions);
+  /**
+   * Populates the router with existing command and middleware data.
+   * @param data - Parsed command data to populate with
+   */
+  populate(data: ParsedCommandData): void;
+  /**
+   * Checks if the configured entrypoint path exists.
+   * @returns True if the path exists
+   */
+  isValidPath(): boolean;
+  /**
+   * @private
+   * @internal
+   */
+  private isCommand;
+  /**
+   * @private
+   * @internal
+   */
+  private isMiddleware;
+  /**
+   * @private
+   * @internal
+   */
+  private isCategory;
+  /**
+   * Clears all loaded commands and middleware.
+   */
+  clear(): void;
+  /**
+   * Scans the filesystem for commands and middleware files.
+   * @returns Parsed command data
+   */
+  scan(): Promise<{
+    commands: {
+      [k: string]: Command;
+    };
+    middlewares: {
+      [k: string]: Middleware;
+    };
+  }>;
+  /**
+   * Gets the raw command and middleware collections.
+   * @returns Object containing commands and middlewares collections
+   */
+  getData(): {
+    commands: Collection<string, Command>;
+    middlewares: Collection<string, Middleware>;
+  };
+  /**
+   * Converts the loaded data to a JSON-serializable format.
+   * @returns Plain object with commands and middlewares
+   */
+  toJSON(): {
+    commands: {
+      [k: string]: Command;
+    };
+    middlewares: {
+      [k: string]: Middleware;
+    };
+  };
+  /**
+   * @private
+   * @internal
+   */
+  private traverse;
+  /**
+   * @private
+   * @internal
+   */
+  private handle;
+  /**
+   * @private
+   * @internal
+   */
+  private applyMiddlewares;
+  /**
+   * @private
+   * @internal
+   */
+  private replaceEntrypoint;
+}
+//#endregion
+export { Command, CommandsRouter, CommandsRouterOptions, Middleware, ParsedCommandData };
+//# sourceMappingURL=CommandsRouter-CoOA7hkf.d.ts.map

package/dist/{CommandsRouter-BHaPno8o.js → CommandsRouter-DFRh47qD.js}

@@ -5,37 +5,99 @@ const node_path = require_chunk.__toESM(require("node:path"));
 const node_fs_promises = require_chunk.__toESM(require("node:fs/promises"));
 
 //#region src/app/router/CommandsRouter.ts
+/**
+* @private
+* @internal
+*/
 const MIDDLEWARE_PATTERN = /^\+middleware\.(m|c)?(j|t)sx?$/;
+/**
+* @private
+* @internal
+*/
 const COMMAND_MIDDLEWARE_PATTERN = /^\+([^+().][^().]*)\.middleware\.(m|c)?(j|t)sx?$/;
+/**
+* @private
+* @internal
+*/
 const GLOBAL_MIDDLEWARE_PATTERN = /^\+global-middleware\.(m|c)?(j|t)sx?$/;
+/**
+* @private
+* @internal
+*/
 const COMMAND_PATTERN = /^([^+().][^().]*)\.(m|c)?(j|t)sx?$/;
+/**
+* @private
+* @internal
+*/
 const CATEGORY_PATTERN = /^\(.+\)$/;
+/**
+* Handles discovery and parsing of command and middleware files in the filesystem.
+*/
 var CommandsRouter = class {
+	/**
+	* @private
+	* @internal
+	*/
 	commands = new discord_js.Collection();
+	/**
+	* @private
+	* @internal
+	*/
 	middlewares = new discord_js.Collection();
+	/**
+	* Creates a new CommandsRouter instance.
+	* @param options - Configuration options for the router
+	*/
 	constructor(options) {
 		this.options = options;
 	}
+	/**
+	* Populates the router with existing command and middleware data.
+	* @param data - Parsed command data to populate with
+	*/
 	populate(data) {
 		for (const [id, command] of Object.entries(data.commands)) this.commands.set(id, command);
 		for (const [id, middleware] of Object.entries(data.middlewares)) this.middlewares.set(id, middleware);
 	}
+	/**
+	* Checks if the configured entrypoint path exists.
+	* @returns True if the path exists
+	*/
 	isValidPath() {
 		return (0, node_fs.existsSync)(this.options.entrypoint);
 	}
+	/**
+	* @private
+	* @internal
+	*/
 	isCommand(name) {
 		return COMMAND_PATTERN.test(name);
 	}
+	/**
+	* @private
+	* @internal
+	*/
 	isMiddleware(name) {
 		return MIDDLEWARE_PATTERN.test(name) || GLOBAL_MIDDLEWARE_PATTERN.test(name) || COMMAND_MIDDLEWARE_PATTERN.test(name);
 	}
+	/**
+	* @private
+	* @internal
+	*/
 	isCategory(name) {
 		return CATEGORY_PATTERN.test(name);
 	}
+	/**
+	* Clears all loaded commands and middleware.
+	*/
 	clear() {
 		this.commands.clear();
 		this.middlewares.clear();
 	}
+	/**
+	* Scans the filesystem for commands and middleware files.
+	* @returns Parsed command data
+	*/
 	async scan() {
 		const entries = await (0, node_fs_promises.readdir)(this.options.entrypoint, { withFileTypes: true });
 		for (const entry of entries) {
@@ -49,18 +111,30 @@ var CommandsRouter = class {
 		await this.applyMiddlewares();
 		return this.toJSON();
 	}
+	/**
+	* Gets the raw command and middleware collections.
+	* @returns Object containing commands and middlewares collections
+	*/
 	getData() {
 		return {
 			commands: this.commands,
 			middlewares: this.middlewares
 		};
 	}
+	/**
+	* Converts the loaded data to a JSON-serializable format.
+	* @returns Plain object with commands and middlewares
+	*/
 	toJSON() {
 		return {
 			commands: Object.fromEntries(this.commands.entries()),
 			middlewares: Object.fromEntries(this.middlewares.entries())
 		};
 	}
+	/**
+	* @private
+	* @internal
+	*/
 	async traverse(path, category) {
 		const entries = await (0, node_fs_promises.readdir)(path, { withFileTypes: true });
 		for (const entry of entries) {
@@ -73,6 +147,10 @@ var CommandsRouter = class {
 			}
 		}
 	}
+	/**
+	* @private
+	* @internal
+	*/
 	async handle(entry, category = null) {
 		const name = entry.name;
 		const path = (0, node_path.join)(entry.parentPath, entry.name);
@@ -100,6 +178,10 @@ var CommandsRouter = class {
 			this.middlewares.set(middleware.id, middleware);
 		}
 	}
+	/**
+	* @private
+	* @internal
+	*/
 	applyMiddlewares() {
 		this.commands.forEach((command) => {
 			const commandPath = command.parentPath;
@@ -111,6 +193,10 @@ var CommandsRouter = class {
 			command.middlewares = Array.from(new Set([...command.middlewares, ...samePathMiddlewares]));
 		});
 	}
+	/**
+	* @private
+	* @internal
+	*/
 	replaceEntrypoint(path) {
 		const normalized = (0, node_path.normalize)(path);
 		return normalized.replace(this.options.entrypoint, "");
@@ -124,4 +210,4 @@ Object.defineProperty(exports, 'CommandsRouter', {
     return CommandsRouter;
   }
 });
-//# sourceMappingURL=CommandsRouter-BHaPno8o.js.map
+//# sourceMappingURL=CommandsRouter-DFRh47qD.js.map

package/dist/CommandsRouter-DFRh47qD.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandsRouter-DFRh47qD.js","names":[],"sources":["../src/app/router/CommandsRouter.ts"],"sourcesContent":["import { Collection } from 'discord.js';\nimport { Dirent, existsSync } from 'node:fs';\nimport { readdir } from 'node:fs/promises';\nimport { basename, extname, join, normalize } from 'node:path';\n\n/**\n * Represents a command with its metadata and middleware associations.\n */\nexport interface Command {\n  id: string;\n  name: string;\n  path: string;\n  relativePath: string;\n  parentPath: string;\n  middlewares: Array<string>;\n  category: string | null;\n}\n\n/**\n * Represents a middleware with its metadata and scope.\n */\nexport interface Middleware {\n  id: string;\n  name: string;\n  path: string;\n  relativePath: string;\n  parentPath: string;\n  global: boolean;\n  command: string | null;\n}\n\n/**\n * Data structure containing parsed commands and middleware.\n */\nexport interface ParsedCommandData {\n  commands: Record<string, Command>;\n  middlewares: Record<string, Middleware>;\n}\n\n/**\n * Configuration options for the commands router.\n */\nexport interface CommandsRouterOptions {\n  entrypoint: string;\n}\n\n/**\n * @private\n * @internal\n */\nconst MIDDLEWARE_PATTERN = /^\\+middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst COMMAND_MIDDLEWARE_PATTERN =\n  /^\\+([^+().][^().]*)\\.middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst GLOBAL_MIDDLEWARE_PATTERN = /^\\+global-middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst COMMAND_PATTERN = /^([^+().][^().]*)\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst CATEGORY_PATTERN = /^\\(.+\\)$/;\n\n/**\n * Handles discovery and parsing of command and middleware files in the filesystem.\n */\nexport class CommandsRouter {\n  /**\n   * @private\n   * @internal\n   */\n  private commands = new Collection<string, Command>();\n\n  /**\n   * @private\n   * @internal\n   */\n  private middlewares = new Collection<string, Middleware>();\n\n  /**\n   * Creates a new CommandsRouter instance.\n   * @param options - Configuration options for the router\n   */\n  public constructor(private readonly options: CommandsRouterOptions) {}\n\n  /**\n   * Populates the router with existing command and middleware data.\n   * @param data - Parsed command data to populate with\n   */\n  public populate(data: ParsedCommandData) {\n    for (const [id, command] of Object.entries(data.commands)) {\n      this.commands.set(id, command);\n    }\n\n    for (const [id, middleware] of Object.entries(data.middlewares)) {\n      this.middlewares.set(id, middleware);\n    }\n  }\n\n  /**\n   * Checks if the configured entrypoint path exists.\n   * @returns True if the path exists\n   */\n  public isValidPath(): boolean {\n    return existsSync(this.options.entrypoint);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isCommand(name: string): boolean {\n    return COMMAND_PATTERN.test(name);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isMiddleware(name: string): boolean {\n    return (\n      MIDDLEWARE_PATTERN.test(name) ||\n      GLOBAL_MIDDLEWARE_PATTERN.test(name) ||\n      COMMAND_MIDDLEWARE_PATTERN.test(name)\n    );\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isCategory(name: string): boolean {\n    return CATEGORY_PATTERN.test(name);\n  }\n\n  /**\n   * Clears all loaded commands and middleware.\n   */\n  public clear() {\n    this.commands.clear();\n    this.middlewares.clear();\n  }\n\n  /**\n   * Scans the filesystem for commands and middleware files.\n   * @returns Parsed command data\n   */\n  public async scan() {\n    const entries = await readdir(this.options.entrypoint, {\n      withFileTypes: true,\n    });\n\n    for (const entry of entries) {\n      // ignore _ prefixed files\n      if (entry.name.startsWith('_')) continue;\n\n      const fullPath = join(this.options.entrypoint, entry.name);\n\n      if (entry.isDirectory()) {\n        const category = this.isCategory(entry.name)\n          ? entry.name.slice(1, -1)\n          : null;\n\n        await this.traverse(fullPath, category);\n      } else {\n        await this.handle(entry);\n      }\n    }\n\n    await this.applyMiddlewares();\n\n    return this.toJSON();\n  }\n\n  /**\n   * Gets the raw command and middleware collections.\n   * @returns Object containing commands and middlewares collections\n   */\n  public getData() {\n    return {\n      commands: this.commands,\n      middlewares: this.middlewares,\n    };\n  }\n\n  /**\n   * Converts the loaded data to a JSON-serializable format.\n   * @returns Plain object with commands and middlewares\n   */\n  public toJSON() {\n    return {\n      commands: Object.fromEntries(this.commands.entries()),\n      middlewares: Object.fromEntries(this.middlewares.entries()),\n    };\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private async traverse(path: string, category: string | null) {\n    const entries = await readdir(path, {\n      withFileTypes: true,\n    });\n\n    for (const entry of entries) {\n      // ignore _ prefixed files\n      if (entry.name.startsWith('_')) continue;\n\n      if (entry.isFile()) {\n        if (this.isCommand(entry.name) || this.isMiddleware(entry.name)) {\n          await this.handle(entry, category);\n        }\n      } else if (\n        entry.isDirectory() &&\n        this.isCategory(entry.name) &&\n        category\n      ) {\n        // nested category\n        const nestedCategory = this.isCategory(entry.name)\n          ? `${category}:${entry.name.slice(1, -1)}`\n          : null;\n        await this.traverse(join(path, entry.name), nestedCategory);\n      }\n\n      // TODO: handle subcommands\n    }\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private async handle(entry: Dirent, category: string | null = null) {\n    const name = entry.name;\n    const path = join(entry.parentPath, entry.name);\n\n    if (this.isCommand(name)) {\n      const command: Command = {\n        id: crypto.randomUUID(),\n        name: basename(path, extname(path)),\n        path,\n        category,\n        parentPath: entry.parentPath,\n        relativePath: this.replaceEntrypoint(path),\n        middlewares: [],\n      };\n\n      this.commands.set(command.id, command);\n    } else if (this.isMiddleware(name)) {\n      const middleware: Middleware = {\n        id: crypto.randomUUID(),\n        name: basename(path, extname(path)),\n        path,\n        relativePath: this.replaceEntrypoint(path),\n        parentPath: entry.parentPath,\n        global: GLOBAL_MIDDLEWARE_PATTERN.test(name),\n        command: COMMAND_MIDDLEWARE_PATTERN.test(name)\n          ? name.split('.')[0] || null\n          : null,\n      };\n\n      this.middlewares.set(middleware.id, middleware);\n    }\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private applyMiddlewares() {\n    this.commands.forEach((command) => {\n      const commandPath = command.parentPath;\n      const samePathMiddlewares = Array.from(this.middlewares.values())\n        .filter((middleware) => {\n          if (middleware.global) return true;\n          if (middleware.command) return middleware.command === command.name;\n          return middleware.parentPath === commandPath;\n        })\n        .map((middleware) => middleware.id);\n\n      command.middlewares = Array.from(\n        new Set([...command.middlewares, ...samePathMiddlewares]),\n      );\n    });\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private replaceEntrypoint(path: string) {\n    const normalized = normalize(path);\n    return normalized.replace(this.options.entrypoint, '');\n  }\n}\n"],"mappings":"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"}

package/dist/{CompilerPlugin-DrnhOC1c.js → CompilerPlugin-Bmy4izKz.js}

@@ -1,7 +1,13 @@
-const require_PluginCommon = require('./PluginCommon-DPqnQngK.js');
+const require_PluginCommon = require('./PluginCommon-D_Z8Oiic.js');
 
 //#region src/plugins/CompilerPlugin.ts
+/**
+* CommandKit plugin that runs at compile time.
+*/
 var CompilerPlugin = class extends require_PluginCommon.PluginCommon {
+	/**
+	* The type of the plugin, which is Compiler.
+	*/
 	type = require_PluginCommon.PluginType.Compiler;
 	/**
 	* Called when transformation is requested to this plugin
@@ -12,6 +18,11 @@ var CompilerPlugin = class extends require_PluginCommon.PluginCommon {
 		return null;
 	}
 };
+/**
+* Type guard to check if the given object is a CompilerPlugin.
+* @param plugin The object to check.
+* @returns Boolean indicating whether the object is a CompilerPlugin.
+*/
 function isCompilerPlugin(plugin) {
 	return plugin instanceof CompilerPlugin || require_PluginCommon.isPlugin(plugin) && plugin.type === require_PluginCommon.PluginType.Compiler;
 }
@@ -29,4 +40,4 @@ Object.defineProperty(exports, 'isCompilerPlugin', {
     return isCompilerPlugin;
   }
 });
-//# sourceMappingURL=CompilerPlugin-DrnhOC1c.js.map
+//# sourceMappingURL=CompilerPlugin-Bmy4izKz.js.map

package/dist/CompilerPlugin-Bmy4izKz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompilerPlugin-Bmy4izKz.js","names":[],"sources":["../src/plugins/CompilerPlugin.ts"],"sourcesContent":["import {\n  isPlugin,\n  PluginCommon,\n  PluginOptions,\n  PluginType,\n} from './PluginCommon';\nimport { MaybeFalsey } from './types';\nimport { CompilerPluginRuntime } from './plugin-runtime/CompilerPluginRuntime';\n\n/**\n * The parameters for the transformation function of a compiler plugin.\n */\nexport interface PluginTransformParameters {\n  /**\n   * The code to be transformed.\n   */\n  code: string;\n  /**\n   * The filename of the code being transformed.\n   */\n  id: string;\n}\n\nexport interface TransformedResult {\n  /**\n   * The transformed code.\n   */\n  code?: string;\n  /**\n   * The source map for the transformed code, if applicable.\n   */\n  map?: string | null;\n}\n\n/**\n * CommandKit plugin that runs at compile time.\n */\nexport abstract class CompilerPlugin<\n  T extends PluginOptions = PluginOptions,\n> extends PluginCommon<T, CompilerPluginRuntime> {\n  /**\n   * The type of the plugin, which is Compiler.\n   */\n  public readonly type = PluginType.Compiler;\n\n  /**\n   * Called when transformation is requested to this plugin\n   * @param params The parameters for the transformation\n   * @returns The transformed result\n   */\n  public async transform(\n    params: PluginTransformParameters,\n  ): Promise<MaybeFalsey<TransformedResult>> {\n    return null;\n  }\n}\n\n/**\n * Type guard to check if the given object is a CompilerPlugin.\n * @param plugin The object to check.\n * @returns Boolean indicating whether the object is a CompilerPlugin.\n */\nexport function isCompilerPlugin(plugin: unknown): plugin is CompilerPlugin {\n  return (\n    plugin instanceof CompilerPlugin ||\n    (isPlugin(plugin) && plugin.type === PluginType.Compiler)\n  );\n}\n"],"mappings":";;;;;;AAqCA,IAAsB,iBAAtB,cAEA,kCAAuC;;;;CAIrC,AAAgB,OAAO,gCAAW;;;;;;CAOlC,MAAa,UACb,QAC0C;AACxC,SAAO;CACT;AACF;;;;;;AAOA,SAAgB,iBAAiB,QAA2C;AAC1E,QACE,kBAAkB,kBAClB,8BAAS,OAAO,IAAI,OAAO,SAAS,gCAAW;AAEnD"}