commandkit 1.2.0-rc.12 → 1.2.0-rc.13

package/{COPYING.md → LICENSE.md}

@@ -639,8 +639,8 @@ attach them to the start of each source file to most effectively state
 the exclusion of warranty; and each file should have at least the
 "copyright" line and a pointer to where the full notice is found.
 
-    <one line to give the program's name and a brief idea of what it does.>
-    Copyright (C) <year>  <name of author>
+    CommandKit is a discord.js metaframework
+    Copyright (C) 2026  Neplex
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
@@ -661,7 +661,7 @@ mail.
 If the program does terminal interaction, make it output a short
 notice like this when it starts in an interactive mode:
 
-    <program>  Copyright (C) <year>  <name of author>
+    CommandKit  Copyright (C) 2026  Neplex
     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
     This is free software, and you are welcome to redistribute it
     under certain conditions; type `show c' for details.

package/README.md

@@ -1,7 +1,7 @@
 <div align="center">
-    <img src="https://raw.githubusercontent.com/underctrl-io/commandkit/main/apps/website/static/img/ckit_logo.svg" width="75%" />
+    <img src="https://raw.githubusercontent.com/neplextech/commandkit/main/apps/website/static/img/ckit_logo.svg" width="75%" />
     <br />
-    <a href="https://ctrl.lol/discord"><img src="https://img.shields.io/discord/1055188344188973066?color=5865F2&logo=discord&logoColor=white" alt="support server" /></a>
+    <a href="https://commandkit.dev/discord"><img src="https://img.shields.io/discord/1055188344188973066?color=5865F2&logo=discord&logoColor=white" alt="support server" /></a>
     <a href="https://www.npmjs.com/package/commandkit"><img src="https://img.shields.io/npm/v/commandkit?maxAge=3600" alt="npm version" /></a>
     <a href="https://www.npmjs.com/package/commandkit"><img src="https://img.shields.io/npm/dt/commandkit?maxAge=3600" alt="npm downloads" /></a>
 </div>
@@ -46,4 +46,4 @@ This will prompt you to enter few details about your project. Once you have ente
 
 ## Support and Suggestions
 
-Submit any queries or suggestions in our [Discord community](https://ctrl.lol/discord).
+Submit any queries or suggestions in our [Discord community](https://commandkit.dev/discord).

package/bin/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 
-import { bootstrapCommandkitCLI } from '../dist/index.js';
+import { bootstrapCommandkitCLI } from '../dist/cli/init.js';
 
 await bootstrapCommandkitCLI(process.argv);

package/cli.d.ts

@@ -0,0 +1,19 @@
+import * as development from './dist/cli/development.js';
+import * as production from './dist/cli/production.js';
+import * as env from './dist/cli/env.js';
+import * as cli from './dist/cli/init.js';
+import * as compiler from './dist/cli/build.js';
+import * as appProcess from './dist/cli/app-process.js';
+import * as typeChecker from './dist/cli/type-checker.js';
+import * as utilities from './dist/cli/common.js';
+
+export {
+  development,
+  production,
+  env,
+  cli,
+  compiler,
+  appProcess,
+  typeChecker,
+  utilities,
+};

package/config.cjs

@@ -1,5 +1,8 @@
 const { defineConfig } = require('./dist/config/config.js');
+const { buildOnly, noBuildOnly } = require('./dist/utils/utilities.js');
 
 module.exports = {
   defineConfig,
+  buildOnly,
+  noBuildOnly,
 };

package/config.d.ts

@@ -1 +1,2 @@
 export { defineConfig, CommandKitConfiguration as Config } from './dist/index';
+export { buildOnly, noBuildOnly } from './dist/utils/utilities';

package/dist/{ActionRow-B-7n9MMr.d.ts → ActionRow-B-CGmjDp.d.ts}

@@ -1,7 +1,6 @@
-import { AnyCommandKitElement, CommandKitElement } from "./element-CvNhvLZ8.js";
+import { n as CommandKitElement, t as AnyCommandKitElement } from "./element-wQo0heGj.js";
 
 //#region src/components/interactive/action-row/ActionRow.d.ts
-
 /**
  * The properties for the action row component.
  */
@@ -16,5 +15,5 @@ interface ActionRowProps {
  */
 declare function ActionRow(props: ActionRowProps): CommandKitElement<'action-row'>;
 //#endregion
-export { ActionRow, ActionRowProps };
-//# sourceMappingURL=ActionRow-B-7n9MMr.d.ts.map
+export { ActionRowProps as n, ActionRow as t };
+//# sourceMappingURL=ActionRow-B-CGmjDp.d.ts.map

package/dist/{ActionRow-uJxU4UGo.js → ActionRow-CSN_UKmM.js}

@@ -1,6 +1,5 @@
-const require_chunk = require('./chunk-nOFOJqeH.js');
+const require_chunk = require('./chunk-kSYXY2_d.js');
 let discord_js = require("discord.js");
-discord_js = require_chunk.__toESM(discord_js);
 
 //#region src/components/interactive/action-row/ActionRow.ts
 /**
@@ -23,4 +22,4 @@ Object.defineProperty(exports, 'ActionRow', {
     return ActionRow;
   }
 });
-//# sourceMappingURL=ActionRow-uJxU4UGo.js.map
+//# sourceMappingURL=ActionRow-CSN_UKmM.js.map

package/dist/{ActionRow-uJxU4UGo.js.map → ActionRow-CSN_UKmM.js.map}

@@ -1 +1 @@
-{"version":3,"file":"ActionRow-uJxU4UGo.js","names":[],"sources":["../src/components/interactive/action-row/ActionRow.ts"],"sourcesContent":["import { ActionRowBuilder } from 'discord.js';\nimport { AnyCommandKitElement, CommandKitElement } from '../../common/element';\n\n/**\n * The properties for the action row component.\n */\nexport interface ActionRowProps {\n  children?: AnyCommandKitElement[] | AnyCommandKitElement;\n}\n\n/**\n * The action row component.\n * @param props The action row properties.\n * @returns The commandkit element.\n * @example <ActionRow><Button label=\"Click me\" style={ButtonStyle.Primary} customId=\"click_me\" /></ActionRow>\n */\nexport function ActionRow(\n  props: ActionRowProps,\n): CommandKitElement<'action-row'> {\n  const row = new ActionRowBuilder();\n\n  if (Array.isArray(props.children)) {\n    // @ts-ignore\n    row.setComponents(...props.children);\n  } else if (props.children) {\n    // @ts-ignore\n    row.setComponents(props.children);\n  }\n\n  return row;\n}\n"],"mappings":";;;;;;;;;;;AAgBA,SAAgB,UAChB,OACkC;CAChC,MAAM,MAAM,IAAI,6BAAkB;AAElC,KAAI,MAAM,QAAQ,MAAM,SAAS,CAE/B,KAAI,cAAc,GAAG,MAAM,SAAS;UAC3B,MAAM,SAEf,KAAI,cAAc,MAAM,SAAS;AAGnC,QAAO"}
+{"version":3,"file":"ActionRow-CSN_UKmM.js","names":[],"sources":["../src/components/interactive/action-row/ActionRow.ts"],"sourcesContent":["import { ActionRowBuilder } from 'discord.js';\nimport { AnyCommandKitElement, CommandKitElement } from '../../common/element';\n\n/**\n * The properties for the action row component.\n */\nexport interface ActionRowProps {\n  children?: AnyCommandKitElement[] | AnyCommandKitElement;\n}\n\n/**\n * The action row component.\n * @param props The action row properties.\n * @returns The commandkit element.\n * @example <ActionRow><Button label=\"Click me\" style={ButtonStyle.Primary} customId=\"click_me\" /></ActionRow>\n */\nexport function ActionRow(\n  props: ActionRowProps,\n): CommandKitElement<'action-row'> {\n  const row = new ActionRowBuilder();\n\n  if (Array.isArray(props.children)) {\n    // @ts-ignore\n    row.setComponents(...props.children);\n  } else if (props.children) {\n    // @ts-ignore\n    row.setComponents(props.children);\n  }\n\n  return row;\n}\n"],"mappings":";;;;;;;;;;AAgBA,SAAgB,UAChB,OACkC;CAChC,MAAM,MAAM,IAAI,6BAAkB;AAElC,KAAI,MAAM,QAAQ,MAAM,SAAS,CAE/B,KAAI,cAAc,GAAG,MAAM,SAAS;UAC3B,MAAM,SAEf,KAAI,cAAc,MAAM,SAAS;AAGnC,QAAO"}

package/dist/{Button-RMp-w8HV.d.ts → Button-C-GPeFA3.d.ts}

@@ -1,11 +1,10 @@
-import { EventInterceptorErrorHandler } from "./EventInterceptor-x-R2qshQ.js";
-import { CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitButtonBuilderOnEnd } from "./ButtonKit-9k4yfhYD.js";
-import { CommandKitElement } from "./element-CvNhvLZ8.js";
-import { MaybeArray } from "./types-CJ-XvOFN.js";
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-CZmWpS08.js";
+import { a as CommandKitButtonBuilderOnEnd, i as CommandKitButtonBuilderInteractionCollectorDispatchContextData, r as CommandKitButtonBuilderInteractionCollectorDispatch } from "./ButtonKit-DKu0VAe4.js";
+import { n as CommandKitElement } from "./element-wQo0heGj.js";
+import { t as MaybeArray } from "./types-BywA9d2Z.js";
 import { ButtonStyle, ComponentEmojiResolvable } from "discord.js";
 
 //#region src/components/interactive/button/Button.d.ts
-
 /**
  * The button children type.
  */
@@ -35,5 +34,5 @@ interface ButtonProps {
  */
 declare function Button(props: ButtonProps): CommandKitElement<'button-kit'>;
 //#endregion
-export { Button, ButtonChildrenLike, ButtonProps };
-//# sourceMappingURL=Button-RMp-w8HV.d.ts.map
+export { ButtonChildrenLike as n, ButtonProps as r, Button as t };
+//# sourceMappingURL=Button-C-GPeFA3.d.ts.map

package/dist/{ButtonKit-9k4yfhYD.d.ts → ButtonKit-DKu0VAe4.d.ts}

@@ -1,8 +1,7 @@
-import { EventInterceptorContextData, EventInterceptorErrorHandler } from "./EventInterceptor-x-R2qshQ.js";
+import { n as EventInterceptorContextData, r as EventInterceptorErrorHandler } from "./EventInterceptor-CZmWpS08.js";
 import { Awaitable, ButtonBuilder, ButtonInteraction, Events } from "discord.js";
 
 //#region src/components/interactive/button/ButtonKit.d.ts
-
 /**
  * The predicate function that filters button interactions.
  * It receives a ButtonInteraction and returns a boolean or a Promise that resolves to a boolean.
@@ -39,49 +38,49 @@ type CommandKitButtonBuilderInteractionCollectorDispatchContextData = EventInter
 declare class ButtonKit extends ButtonBuilder {
   #private;
   /**
-   * Sets up an inline interaction collector for this button. This collector by default allows as many interactions as possible if it is actively used.
-   * If unused, this expires after 24 hours or custom time if specified.
-   * @param handler The handler to run when the button is clicked
-   * @param data The context data to use for the interaction collector
-   * @returns This button
-   * @example
-   * ```ts
-   * const button = new ButtonKit()
-   *   .setLabel('Click me')
-   *   .setStyle(ButtonStyle.Primary)
-   *   .setCustomId('click_me')
-   *   .filter((interaction) => interaction.user.id === '1234567890')
-   *   .onClick(async (interaction) => {
-   *     await interaction.reply('You clicked me!');
-   *   });
-   *
-   * const row = new ActionRowBuilder().addComponents(button);
-   *
-   * const message = await channel.send({ content: 'Click the button', components: [row] });
-   *
-   * // Remove onClick handler and destroy the interaction collector
-   * button.onClick(null);
-   * ```
-   */
+       * Sets up an inline interaction collector for this button. This collector by default allows as many interactions as possible if it is actively used.
+       * If unused, this expires after 24 hours or custom time if specified.
+       * @param handler The handler to run when the button is clicked
+       * @param data The context data to use for the interaction collector
+       * @returns This button
+       * @example
+       * ```ts
+       * const button = new ButtonKit()
+       *   .setLabel('Click me')
+       *   .setStyle(ButtonStyle.Primary)
+       *   .setCustomId('click_me')
+       *   .filter((interaction) => interaction.user.id === '1234567890')
+       *   .onClick(async (interaction) => {
+       *     await interaction.reply('You clicked me!');
+       *   });
+       *
+       * const row = new ActionRowBuilder().addComponents(button);
+       *
+       * const message = await channel.send({ content: 'Click the button', components: [row] });
+       *
+       * // Remove onClick handler and destroy the interaction collector
+       * button.onClick(null);
+       * ```
+       */
   onClick(handler: CommandKitButtonBuilderInteractionCollectorDispatch, data?: CommandKitButtonBuilderInteractionCollectorDispatchContextData): this;
   onEnd(handler: CommandKitButtonBuilderOnEnd): this;
   /**
-   * Sets the handler to run when the interaction collector ends.
-   * @param handler - The handler to run when the interaction collector ends.
-   * @returns This instance of the modal builder.
-   */
+       * Sets the handler to run when the interaction collector ends.
+       * @param handler - The handler to run when the interaction collector ends.
+       * @returns This instance of the modal builder.
+       */
   onError(handler: EventInterceptorErrorHandler): this;
   /**
-   * Sets a filter for the interaction collector.
-   * @param predicate The filter to use for the interaction collector
-   */
+       * Sets a filter for the interaction collector.
+       * @param predicate The filter to use for the interaction collector
+       */
   filter(predicate: ButtonKitPredicate): this;
   private get customId();
   /**
-   * Disposes of the button collector and cleans up resources.
-   */
+       * Disposes of the button collector and cleans up resources.
+       */
   dispose(): this;
 }
 //#endregion
-export { ButtonKit, ButtonKitPredicate, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitButtonBuilderOnEnd, OnButtonKitClick, OnButtonKitEnd };
-//# sourceMappingURL=ButtonKit-9k4yfhYD.d.ts.map
+export { CommandKitButtonBuilderOnEnd as a, CommandKitButtonBuilderInteractionCollectorDispatchContextData as i, ButtonKitPredicate as n, OnButtonKitClick as o, CommandKitButtonBuilderInteractionCollectorDispatch as r, OnButtonKitEnd as s, ButtonKit as t };
+//# sourceMappingURL=ButtonKit-DKu0VAe4.d.ts.map

package/dist/ChannelSelectMenuKit-HQZ4hH5s.d.ts

@@ -0,0 +1,66 @@
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-CZmWpS08.js";
+import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-DnwCYit8.js";
+import { ChannelSelectMenuBuilder, ChannelSelectMenuInteraction } from "discord.js";
+
+//#region src/components/interactive/select-menu/ChannelSelectMenuKit.d.ts
+/**
+ * Type for the handler function that is called when the channel select menu is submitted.
+ */
+type OnChannelSelectMenuKitSubmit = OnSelectMenuKitSubmit<ChannelSelectMenuInteraction, ChannelSelectMenuKit>;
+/**
+ * Type for the predicate function that filters channel select menu interactions.
+ * It receives a ChannelSelectMenuInteraction and returns a boolean or a Promise that resolves to a boolean.
+ */
+type ChannelSelectMenuKitPredicate = SelectMenuKitPredicate<ChannelSelectMenuInteraction>;
+/**
+ * A builder for creating channel select menus with additional features like interaction collectors and event handling.
+ * This class extends the ChannelSelectMenuBuilder from discord.js and adds methods for handling interactions.
+ * It allows you to set a handler for when the channel select menu is submitted, filter interactions, and handle the end of the interaction collector.
+ */
+declare class ChannelSelectMenuKit extends ChannelSelectMenuBuilder {
+  #private;
+  /**
+       * Sets the handler to run when the modal is submitted.
+       * @param handler - The handler to run when the modal is submitted.
+       * @param data - The context data for the interaction collector.
+       * @returns This instance of the modal builder.
+       * @example
+       * ```ts
+       * const modal = new ChannelSelectMenuKit()
+       *  .setTitle('My Modal')
+       *  .setCustomId('my-modal')
+       *  .filter((interaction) => interaction.Channel.id === '1234567890')
+       *  .onSelect(async (interaction) => {
+       *     await interaction.reply('You submitted the modal!');
+       *   })
+       *   .addComponents(actionRow1, actionRow2);
+       * ```
+       */
+  onSelect(handler: CommandKitSelectMenuBuilderInteractionCollectorDispatch<ChannelSelectMenuInteraction, ChannelSelectMenuKit>, data?: CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData): this;
+  /**
+       * Sets the handler to run when the interaction collector ends.
+       * @param handler - The handler to run when the interaction collector ends.
+       * @returns This instance of the modal builder.
+       */
+  onEnd(handler: CommandKitSelectMenuBuilderOnEnd): this;
+  /**
+       * Sets the handler to run when the interaction collector ends.
+       * @param handler - The handler to run when the interaction collector ends.
+       * @returns This instance of the modal builder.
+       */
+  onError(handler: EventInterceptorErrorHandler): this;
+  /**
+       * Sets a filter for the interaction collector.
+       * @param predicate - The filter to use for the interaction collector.
+       * @returns This instance of the modal builder.
+       */
+  filter(predicate: SelectMenuKitPredicate<ChannelSelectMenuInteraction>): this;
+  private get customId();
+  /**
+       * Cleans up the interaction collector and removes the handler.
+       */
+  dispose(): this;
+}
+//#endregion
+export { ChannelSelectMenuKitPredicate as n, OnChannelSelectMenuKitSubmit as r, ChannelSelectMenuKit as t };
+//# sourceMappingURL=ChannelSelectMenuKit-HQZ4hH5s.d.ts.map

package/dist/{CommandKitEventsChannel-2l9Za-le.js → CommandKitEventsChannel-CnT5ymYe.js}

@@ -1,4 +1,4 @@
-const require_chunk = require('./chunk-nOFOJqeH.js');
+const require_chunk = require('./chunk-kSYXY2_d.js');
 let node_events = require("node:events");
 node_events = require_chunk.__toESM(node_events);
 
@@ -85,4 +85,4 @@ Object.defineProperty(exports, 'CommandKitEventsChannel', {
     return CommandKitEventsChannel;
   }
 });
-//# sourceMappingURL=CommandKitEventsChannel-2l9Za-le.js.map
+//# sourceMappingURL=CommandKitEventsChannel-CnT5ymYe.js.map

package/dist/{CommandKitEventsChannel-2l9Za-le.js.map → CommandKitEventsChannel-CnT5ymYe.js.map}

@@ -1 +1 @@
-{"version":3,"file":"CommandKitEventsChannel-2l9Za-le.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,qBAAc;;;;;CAMpC,AAAO,YAAY,AAAgB,YAAwB;EAAxB;;;;;;;;;;CAUnC,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;GAClE;;;;;;;;CASH,AAAO,GAAG,WAAmB,OAAe,UAA4B;AACtE,OAAK,QAAQ,GAAG,GAAG,UAAU,GAAG,SAAS,SAAS;;;;;;;;CASpD,AAAO,IAAI,WAAmB,OAAe,UAA4B;AACvE,OAAK,QAAQ,IAAI,GAAG,UAAU,GAAG,SAAS,SAAS;;;;;;;;;CAUrD,AAAO,KAAK,WAAmB,OAAe,UAA4B;AACxE,OAAK,QAAQ,KAAK,GAAG,UAAU,GAAG,SAAS,SAAS;;;;;;;;;CAUtD,AAAO,KAAK,WAAmB,OAAe,GAAG,MAAa;AAC5D,SAAO,KAAK,QAAQ,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK;;CAU5D,AAAO,mBAAmB,WAAmB,OAAsB;AACjE,MAAI,MACF,MAAK,QAAQ,mBAAmB,GAAG,UAAU,GAAG,QAAQ;MAExD,MAAK,QAAQ,mBAAmB,UAAU"}
+{"version":3,"file":"CommandKitEventsChannel-CnT5ymYe.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,qBAAc;;;;;CAMpC,AAAO,YAAY,AAAgB,YAAwB;EAAxB;;;;;;;;;;CAUnC,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;GAClE;;;;;;;;CASH,AAAO,GAAG,WAAmB,OAAe,UAA4B;AACtE,OAAK,QAAQ,GAAG,GAAG,UAAU,GAAG,SAAS,SAAS;;;;;;;;CASpD,AAAO,IAAI,WAAmB,OAAe,UAA4B;AACvE,OAAK,QAAQ,IAAI,GAAG,UAAU,GAAG,SAAS,SAAS;;;;;;;;;CAUrD,AAAO,KAAK,WAAmB,OAAe,UAA4B;AACxE,OAAK,QAAQ,KAAK,GAAG,UAAU,GAAG,SAAS,SAAS;;;;;;;;;CAUtD,AAAO,KAAK,WAAmB,OAAe,GAAG,MAAa;AAC5D,SAAO,KAAK,QAAQ,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK;;CAU5D,AAAO,mBAAmB,WAAmB,OAAsB;AACjE,MAAI,MACF,MAAK,QAAQ,mBAAmB,GAAG,UAAU,GAAG,QAAQ;MAExD,MAAK,QAAQ,mBAAmB,UAAU"}

package/dist/{CommandsRouter-CBdsqaWK.d.ts → CommandsRouter-C7dZEepB.d.ts}

@@ -1,7 +1,6 @@
 import { Collection } from "discord.js";
 
 //#region src/app/router/CommandsRouter.d.ts
-
 /**
  * Represents a command with its metadata and middleware associations.
  */
@@ -45,53 +44,53 @@ interface CommandsRouterOptions {
 declare class CommandsRouter {
   private readonly options;
   /**
-   * @private
-   * @internal
-   */
+       * @private
+       * @internal
+       */
   private commands;
   /**
-   * @private
-   * @internal
-   */
+       * @private
+       * @internal
+       */
   private middlewares;
   /**
-   * Creates a new CommandsRouter instance.
-   * @param options - Configuration options for the router
-   */
+       * 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
-   */
+       * 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
-   */
+       * Checks if the configured entrypoint path exists.
+       * @returns True if the path exists
+       */
   isValidPath(): boolean;
   /**
-   * @private
-   * @internal
-   */
+       * @private
+       * @internal
+       */
   private isCommand;
   /**
-   * @private
-   * @internal
-   */
+       * @private
+       * @internal
+       */
   private isMiddleware;
   /**
-   * @private
-   * @internal
-   */
+       * @private
+       * @internal
+       */
   private isCategory;
   /**
-   * Clears all loaded commands and middleware.
-   */
+       * Clears all loaded commands and middleware.
+       */
   clear(): void;
   /**
-   * Scans the filesystem for commands and middleware files.
-   * @returns Parsed command data
-   */
+       * Scans the filesystem for commands and middleware files.
+       * @returns Parsed command data
+       */
   scan(): Promise<{
     commands: {
       [k: string]: Command;
@@ -101,17 +100,17 @@ declare class CommandsRouter {
     };
   }>;
   /**
-   * Gets the raw command and middleware collections.
-   * @returns Object containing commands and middlewares collections
-   */
+       * 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
-   */
+       * Converts the loaded data to a JSON-serializable format.
+       * @returns Plain object with commands and middlewares
+       */
   toJSON(): {
     commands: {
       [k: string]: Command;
@@ -121,26 +120,26 @@ declare class CommandsRouter {
     };
   };
   /**
-   * @private
-   * @internal
-   */
+       * @private
+       * @internal
+       */
   private traverse;
   /**
-   * @private
-   * @internal
-   */
+       * @private
+       * @internal
+       */
   private handle;
   /**
-   * @private
-   * @internal
-   */
+       * @private
+       * @internal
+       */
   private applyMiddlewares;
   /**
-   * @private
-   * @internal
-   */
+       * @private
+       * @internal
+       */
   private replaceEntrypoint;
 }
 //#endregion
-export { Command, CommandsRouter, CommandsRouterOptions, Middleware, ParsedCommandData };
-//# sourceMappingURL=CommandsRouter-CBdsqaWK.d.ts.map
+export { ParsedCommandData as a, Middleware as i, CommandsRouter as n, CommandsRouterOptions as r, Command as t };
+//# sourceMappingURL=CommandsRouter-C7dZEepB.d.ts.map

package/dist/{CommandsRouter-CWMipIis.js → CommandsRouter-C_HLsrGX.js}

@@ -1,12 +1,8 @@
-const require_chunk = require('./chunk-nOFOJqeH.js');
+const require_chunk = require('./chunk-kSYXY2_d.js');
 let discord_js = require("discord.js");
-discord_js = require_chunk.__toESM(discord_js);
 let node_fs = require("node:fs");
-node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");
-node_path = require_chunk.__toESM(node_path);
 let node_fs_promises = require("node:fs/promises");
-node_fs_promises = require_chunk.__toESM(node_fs_promises);
 
 //#region src/app/router/CommandsRouter.ts
 /**
@@ -216,4 +212,4 @@ Object.defineProperty(exports, 'CommandsRouter', {
     return CommandsRouter;
   }
 });
-//# sourceMappingURL=CommandsRouter-CWMipIis.js.map
+//# sourceMappingURL=CommandsRouter-C_HLsrGX.js.map

package/dist/{CommandsRouter-CWMipIis.js.map → CommandsRouter-C_HLsrGX.js.map}

@@ -1 +1 @@
-{"version":3,"file":"CommandsRouter-CWMipIis.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.match(COMMAND_MIDDLEWARE_PATTERN)?.[1] || 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 allMiddlewares = Array.from(this.middlewares.values());\n\n      const commandSpecificMiddlewares = allMiddlewares\n        .filter((middleware) => middleware.command === command.name)\n        .map((middleware) => middleware.id);\n\n      const directorySpecificMiddlewares = allMiddlewares\n        .filter(\n          (middleware) =>\n            !middleware.global &&\n            !middleware.command &&\n            middleware.parentPath === commandPath,\n        )\n        .map((middleware) => middleware.id);\n\n      const globalMiddlewares = allMiddlewares\n        .filter((middleware) => middleware.global)\n        .map((middleware) => middleware.id);\n\n      command.middlewares = [\n        ...globalMiddlewares,\n        ...directorySpecificMiddlewares,\n        ...commandSpecificMiddlewares,\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":";;;;;;;;;;;;;;;AAkDA,MAAM,qBAAqB;;;;;AAM3B,MAAM,6BACN;;;;;AAMA,MAAM,4BAA4B;;;;;AAMlC,MAAM,kBAAkB;;;;;AAMxB,MAAM,mBAAmB;;;;AAKzB,IAAa,iBAAb,MAA4B;;;;;CAK1B,AAAQ,WAAW,IAAI,uBAA6B;;;;;CAMpD,AAAQ,cAAc,IAAI,uBAAgC;;;;;CAM1D,AAAO,YAAY,AAAiB,SAAgC;EAAhC;;;;;;CAMpC,AAAO,SAAS,MAAyB;AACvC,OAAK,MAAM,CAAC,IAAI,YAAY,OAAO,QAAQ,KAAK,SAAS,CACvD,MAAK,SAAS,IAAI,IAAI,QAAQ;AAGhC,OAAK,MAAM,CAAC,IAAI,eAAe,OAAO,QAAQ,KAAK,YAAY,CAC7D,MAAK,YAAY,IAAI,IAAI,WAAW;;;;;;CAQxC,AAAO,cAAuB;AAC5B,iCAAkB,KAAK,QAAQ,WAAW;;;;;;CAO5C,AAAQ,UAAU,MAAuB;AACvC,SAAO,gBAAgB,KAAK,KAAK;;;;;;CAOnC,AAAQ,aAAa,MAAuB;AAC1C,SACE,mBAAmB,KAAK,KAAK,IAC7B,0BAA0B,KAAK,KAAK,IACpC,2BAA2B,KAAK,KAAI;;;;;;CAQxC,AAAQ,WAAW,MAAuB;AACxC,SAAO,iBAAiB,KAAK,KAAK;;;;;CAMpC,AAAO,QAAQ;AACb,OAAK,SAAS,OAAO;AACrB,OAAK,YAAY,OAAO;;;;;;CAO1B,MAAa,OAAO;EAClB,MAAM,UAAU,oCAAc,KAAK,QAAQ,YAAY,EACrD,eAAe,MAChB,CAAC;AAEF,OAAK,MAAM,SAAS,SAAS;AAE3B,OAAI,MAAM,KAAK,WAAW,IAAI,CAAE;GAEhC,MAAM,+BAAgB,KAAK,QAAQ,YAAY,MAAM,KAAK;AAE1D,OAAI,MAAM,aAAa,EAAE;IACvB,MAAM,WAAW,KAAK,WAAW,MAAM,KAAI,GAC3C,MAAM,KAAK,MAAM,GAAG,GAAG,GACvB;AAEA,UAAM,KAAK,SAAS,UAAU,SAAS;SAEvC,OAAM,KAAK,OAAO,MAAM;;AAI5B,QAAM,KAAK,kBAAkB;AAE7B,SAAO,KAAK,QAAQ;;;;;;CAOtB,AAAO,UAAU;AACf,SAAO;GACL,UAAU,KAAK;GACf,aAAa,KAAK;GACnB;;;;;;CAOH,AAAO,SAAS;AACd,SAAO;GACL,UAAU,OAAO,YAAY,KAAK,SAAS,SAAS,CAAC;GACrD,aAAa,OAAO,YAAY,KAAK,YAAY,SAAS,CAAC;GAC5D;;;;;;CAOH,MAAc,SAAS,MAAc,UAAyB;EAC5D,MAAM,UAAU,oCAAc,MAAM,EAClC,eAAe,MAChB,CAAC;AAEF,OAAK,MAAM,SAAS,SAAS;AAE3B,OAAI,MAAM,KAAK,WAAW,IAAI,CAAE;AAEhC,OAAI,MAAM,QAAQ,EAChB;QAAI,KAAK,UAAU,MAAM,KAAK,IAAI,KAAK,aAAa,MAAM,KAAK,CAC7D,OAAM,KAAK,OAAO,OAAO,SAAS;cAGtC,MAAM,aAAa,IACnB,KAAK,WAAW,MAAM,KAAK,IAC3B,UACA;IAEE,MAAM,iBAAiB,KAAK,WAAW,MAAM,KAAI,GACjD,GAAG,SAAS,GAAG,MAAM,KAAK,MAAM,GAAG,GAAG,KACtC;AACA,UAAM,KAAK,6BAAc,MAAM,MAAM,KAAK,EAAE,eAAe;;;;;;;;CAWjE,MAAc,OAAO,OAAe,WAA0B,MAAM;EAClE,MAAM,OAAO,MAAM;EACnB,MAAM,2BAAY,MAAM,YAAY,MAAM,KAAK;AAE/C,MAAI,KAAK,UAAU,KAAK,EAAE;GACxB,MAAM,UAAmB;IACvB,IAAI,OAAO,YAAY;IACvB,8BAAe,6BAAc,KAAK,CAAC;IACnC;IACA;IACA,YAAY,MAAM;IAClB,cAAc,KAAK,kBAAkB,KAAK;IAC1C,aAAa,EAAE;IAChB;AAED,QAAK,SAAS,IAAI,QAAQ,IAAI,QAAQ;aAC7B,KAAK,aAAa,KAAK,EAAE;;GAClC,MAAM,aAAyB;IAC7B,IAAI,OAAO,YAAY;IACvB,8BAAe,6BAAc,KAAK,CAAC;IACnC;IACA,cAAc,KAAK,kBAAkB,KAAK;IAC1C,YAAY,MAAM;IAClB,QAAQ,0BAA0B,KAAK,KAAK;IAC5C,SAAS,2BAA2B,KAAK,KAAI,mBAC7C,KAAK,MAAM,2BAA2B,4DAAG,OAAM,OAC/C;IACD;AAED,QAAK,YAAY,IAAI,WAAW,IAAI,WAAW;;;;;;;CAQnD,AAAQ,mBAAmB;AACzB,OAAK,SAAS,SAAS,YAAY;GACjC,MAAM,cAAc,QAAQ;GAC5B,MAAM,iBAAiB,MAAM,KAAK,KAAK,YAAY,QAAQ,CAAC;GAE5D,MAAM,6BAA6B,eACnC,QAAQ,eAAe,WAAW,YAAY,QAAQ,KAAK,CAC3D,KAAK,eAAe,WAAW,GAAG;GAElC,MAAM,+BAA+B,eACrC,QACG,eACD,CAAC,WAAW,UACZ,CAAC,WAAW,WACZ,WAAW,eAAe,YAC3B,CACD,KAAK,eAAe,WAAW,GAAG;AAMlC,WAAQ,cAAc;IACtB,GAL0B,eAC1B,QAAQ,eAAe,WAAW,OAAO,CACzC,KAAK,eAAe,WAAW,GAAG;IAIlC,GAAG;IACH,GAAG;IAA2B;IAE9B;;;;;;CAOJ,AAAQ,kBAAkB,MAAc;AAEtC,kCAD6B,KAAK,CAChB,QAAQ,KAAK,QAAQ,YAAY,GAAG"}
+{"version":3,"file":"CommandsRouter-C_HLsrGX.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.match(COMMAND_MIDDLEWARE_PATTERN)?.[1] || 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 allMiddlewares = Array.from(this.middlewares.values());\n\n      const commandSpecificMiddlewares = allMiddlewares\n        .filter((middleware) => middleware.command === command.name)\n        .map((middleware) => middleware.id);\n\n      const directorySpecificMiddlewares = allMiddlewares\n        .filter(\n          (middleware) =>\n            !middleware.global &&\n            !middleware.command &&\n            middleware.parentPath === commandPath,\n        )\n        .map((middleware) => middleware.id);\n\n      const globalMiddlewares = allMiddlewares\n        .filter((middleware) => middleware.global)\n        .map((middleware) => middleware.id);\n\n      command.middlewares = [\n        ...globalMiddlewares,\n        ...directorySpecificMiddlewares,\n        ...commandSpecificMiddlewares,\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-CZ4412Zm.js → CompilerPlugin-CUsGAfgl.js}

@@ -1,4 +1,4 @@
-const require_PluginCommon = require('./PluginCommon-CPWV5xuX.js');
+const require_PluginCommon = require('./PluginCommon-BLxWww5u.js');
 
 //#region src/plugins/CompilerPlugin.ts
 /**
@@ -40,4 +40,4 @@ Object.defineProperty(exports, 'isCompilerPlugin', {
     return isCompilerPlugin;
   }
 });
-//# sourceMappingURL=CompilerPlugin-CZ4412Zm.js.map
+//# sourceMappingURL=CompilerPlugin-CUsGAfgl.js.map

package/dist/{CompilerPlugin-CZ4412Zm.js.map → CompilerPlugin-CUsGAfgl.js.map}

@@ -1 +1 @@
-{"version":3,"file":"CompilerPlugin-CZ4412Zm.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;;;;;;;;AASX,SAAgB,iBAAiB,QAA2C;AAC1E,QACE,kBAAkB,kBAClB,8BAAS,OAAO,IAAI,OAAO,SAAS,gCAAW"}
+{"version":3,"file":"CompilerPlugin-CUsGAfgl.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,kCAA0B;;;;CAIxB,AAAgB,OAAO,gCAAW;;;;;;CAOlC,MAAa,UACb,QAC0C;AACxC,SAAO;;;;;;;;AASX,SAAgB,iBAAiB,QAA2C;AAC1E,QACE,kBAAkB,kBAClB,8BAAS,OAAO,IAAI,OAAO,SAAS,gCAAW"}