commandkit 1.2.0-rc.1 → 1.2.0-rc.11

package/dist/MessageCommandParser-Dl0xxtdr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageCommandParser-Dl0xxtdr.js","names":[],"sources":["../src/app/commands/MessageCommandParser.ts"],"sourcesContent":["import { Channel } from 'diagnostics_channel';\nimport {\n  Message,\n  ApplicationCommandOptionType,\n  GuildMember,\n  Attachment,\n  User,\n  Role,\n  CommandInteractionOption,\n} from 'discord.js';\nimport {\n  CommandKitErrorCodes,\n  createCommandKitError,\n} from '../../utils/error-codes';\n\n/**\n * Represents a parsed message command with its components.\n */\nexport interface ParsedMessageCommand {\n  command: string;\n  options: { name: string; value: unknown }[];\n  subcommand?: string;\n  subcommandGroup?: string;\n}\n\n/**\n * Schema defining the types of options for a message command.\n */\nexport type MessageCommandOptionsSchema = Record<\n  string,\n  ApplicationCommandOptionType\n>;\n\n/**\n * Parses message content into structured command data with options and subcommands.\n */\nexport class MessageCommandParser {\n  /**\n   * @private\n   * @internal\n   */\n  #parsed: ParsedMessageCommand | null = null;\n\n  /**\n   * @private\n   * @internal\n   */\n  #options: MessageCommandOptions | null = null;\n\n  /**\n   * @private\n   * @internal\n   */\n  #args: string[] = [];\n\n  /**\n   * Creates a new message command parser.\n   * @param message - The Discord message to parse\n   * @param prefix - Array of valid command prefixes or a regular expression\n   * @param schema - Function that returns the options schema for a command\n   */\n  public constructor(\n    public message: Message,\n    private prefix: string[] | RegExp,\n    private schema: (command: string) => MessageCommandOptionsSchema,\n  ) {}\n\n  /**\n   * Gets the parsed command arguments.\n   * @returns Array of command arguments\n   */\n  public getArgs() {\n    void this.parse();\n    return this.#args;\n  }\n\n  /**\n   * Gets the message command options object for easy access to typed option values.\n   */\n  public get options() {\n    if (!this.#options) {\n      this.#options = new MessageCommandOptions(this);\n    }\n\n    return this.#options;\n  }\n\n  /**\n   * Gets a specific option value by name.\n   * @param name - The option name\n   * @returns The option value or undefined if not found\n   */\n  public getOption<T>(name: string): T | undefined {\n    return this.parse().options.find((o) => o.name === name)?.value as T;\n  }\n\n  /**\n   * Gets the main command name.\n   * @returns The command name\n   */\n  public getCommand(): string {\n    return this.parse().command;\n  }\n\n  /**\n   * Gets the subcommand name if present.\n   * @returns The subcommand name or undefined\n   */\n  public getSubcommand(): string | undefined {\n    return this.parse().subcommand;\n  }\n\n  /**\n   * Gets the subcommand group name if present.\n   * @returns The subcommand group name or undefined\n   */\n  public getSubcommandGroup(): string | undefined {\n    return this.parse().subcommandGroup;\n  }\n\n  /**\n   * Gets the prefix used in the message.\n   * @returns The matched prefix or undefined\n   */\n  public getPrefix() {\n    if (this.prefix instanceof RegExp) {\n      const match = this.message.content.match(this.prefix);\n      return match?.[0];\n    }\n\n    for (const p of this.prefix) {\n      if (this.message.content.startsWith(p)) {\n        return p;\n      }\n    }\n  }\n\n  /**\n   * Gets the full command including subcommand group and subcommand.\n   * @returns The complete command string\n   */\n  public getFullCommand() {\n    return [this.getCommand(), this.getSubcommandGroup(), this.getSubcommand()]\n      .filter((v) => v)\n      .join(' ');\n  }\n\n  /**\n   * Parses the message content into structured command data.\n   * @returns The parsed command data\n   */\n  public parse(): ParsedMessageCommand {\n    if (this.#parsed) {\n      return this.#parsed;\n    }\n\n    const content = this.message.content;\n\n    const prefix = this.getPrefix();\n\n    if (!prefix) {\n      throw createCommandKitError(CommandKitErrorCodes.InvalidCommandPrefix);\n    }\n\n    const parts = content.slice(prefix.length).trim().split(' ');\n    const command = parts.shift();\n\n    this.#args = parts;\n\n    let subcommandGroup: string | undefined;\n    let subcommand: string | undefined;\n\n    if (command?.includes(':')) {\n      const [, group, cmd] = command.split(':');\n\n      if (!cmd && group) {\n        subcommand = group;\n      } else if (cmd && group) {\n        subcommandGroup = group;\n        subcommand = cmd;\n      }\n    }\n\n    const schema = this.schema(\n      [command, subcommandGroup, subcommand].filter(Boolean).join(' ').trim(),\n    );\n\n    const options = parts\n      .map((part) => {\n        try {\n          const [name, value] = part.split(':');\n\n          if (!(name in schema)) return null;\n\n          switch (schema[name]) {\n            case ApplicationCommandOptionType.Boolean:\n              return { name, value: value === 'true' };\n            case ApplicationCommandOptionType.Integer:\n              return { name, value: parseInt(value, 10) };\n            case ApplicationCommandOptionType.Number:\n              return { name, value: parseFloat(value) };\n            case ApplicationCommandOptionType.String:\n              return { name, value };\n            case ApplicationCommandOptionType.User:\n              return {\n                name,\n                value: this.message.mentions.users.find((u) => {\n                  return u.id === value.replace(/[<@!>]/g, '');\n                }),\n              };\n            case ApplicationCommandOptionType.Channel:\n              return {\n                name,\n                value: this.message.mentions.channels.find((c) => {\n                  return c.id === value.replace(/[<#>]/g, '');\n                }),\n              };\n            case ApplicationCommandOptionType.Role:\n              return {\n                name,\n                value: this.message.mentions.roles.find((r) => {\n                  return r.id === value.replace(/[<@&>]/g, '');\n                }),\n              };\n            case ApplicationCommandOptionType.Attachment:\n              return {\n                name,\n                value: this.message.attachments.find((a) => {\n                  return a.name === value;\n                }),\n              };\n            default:\n              return null;\n          }\n        } catch {\n          // Invalid option\n          return null;\n        }\n      })\n      .filter((v) => v !== null);\n\n    this.#parsed = {\n      command: command!,\n      options,\n      subcommand,\n      subcommandGroup,\n    };\n\n    return this.#parsed;\n  }\n}\n\n/**\n * Provides typed access to message command options with methods similar to Discord.js interaction options.\n */\nexport class MessageCommandOptions {\n  /**\n   * Creates a new message command options instance.\n   * @param parser - The message command parser instance\n   */\n  public constructor(private parser: MessageCommandParser) {}\n\n  /**\n   * @private\n   * @internal\n   */\n  private assertOption<T>(name: string, required = false) {\n    const option = this.parser.getOption<T>(name);\n\n    if (required && option === undefined) {\n      throw new Error(`Option \"${name}\" is required.`);\n    }\n\n    return option ?? null;\n  }\n\n  /**\n   * Gets a guild member from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The guild member or null if not found\n   */\n  getMember(name: string): GuildMember | null;\n  getMember(name: string, required: true): GuildMember;\n  getMember(name: string, required = false) {\n    const user = this.assertOption<User>(name, required);\n    const member = this.parser.message.guild?.members.cache.get(user?.id!);\n\n    if (required && !member) {\n      throw new Error(`Member \"${name}\" is required.`);\n    }\n\n    return member ?? null;\n  }\n\n  /**\n   * Gets an attachment from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The attachment or null if not found\n   */\n  getAttachment(name: string): Attachment | null;\n  getAttachment(name: string, required: true): Attachment;\n  getAttachment(name: string, required = false) {\n    return this.assertOption<Attachment>(name, required);\n  }\n\n  /**\n   * Gets a boolean value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The boolean value or null if not found\n   */\n  getBoolean(name: string): boolean | null;\n  getBoolean(name: string, required: true): boolean;\n  getBoolean(name: string, required = false) {\n    return this.assertOption<boolean>(name, required);\n  }\n\n  /**\n   * Gets a number value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The number value or null if not found\n   */\n  getNumber(name: string): number | null;\n  getNumber(name: string, required: true): number;\n  getNumber(name: string, required = false) {\n    return this.assertOption<number>(name, required);\n  }\n\n  /**\n   * Gets a string value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The string value or null if not found\n   */\n  getString(name: string): string | null;\n  getString(name: string, required: true): string;\n  getString(name: string, required = false) {\n    return this.assertOption<string>(name, required);\n  }\n\n  /**\n   * Gets an integer value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The integer value or null if not found\n   */\n  getInteger(name: string): number | null;\n  getInteger(name: string, required: true): number;\n  getInteger(name: string, required = false) {\n    return this.assertOption<number>(name, required);\n  }\n\n  /**\n   * Gets a user from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The user or null if not found\n   */\n  getUser(name: string): User | null;\n  getUser(name: string, required: true): User;\n  getUser(name: string, required = false) {\n    return this.assertOption<User>(name, required);\n  }\n\n  /**\n   * Gets a channel from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The channel or null if not found\n   */\n  getChannel(name: string): Channel | null;\n  getChannel(name: string, required: true): Channel;\n  getChannel(name: string, required = false) {\n    return this.assertOption<Channel>(name, required);\n  }\n\n  /**\n   * Gets a role from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The role or null if not found\n   */\n  getRole(name: string): Role | null;\n  getRole(name: string, required: true): Role;\n  getRole(name: string, required = false) {\n    return this.assertOption<Role>(name, required);\n  }\n\n  /**\n   * Gets a mentionable (user, member, or role) from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The mentionable or null if not found\n   */\n  getMentionable(\n    name: string,\n  ): NonNullable<CommandInteractionOption['member' | 'role' | 'user']> | null;\n  getMentionable(\n    name: string,\n    required: true,\n  ): NonNullable<CommandInteractionOption['member' | 'role' | 'user']>;\n  getMentionable(\n    name: string,\n    required = false,\n  ): NonNullable<CommandInteractionOption['member' | 'role' | 'user']> | null {\n    const target = this.assertOption(name, required);\n\n    if (\n      target instanceof GuildMember ||\n      target instanceof User ||\n      target instanceof Role\n    ) {\n      return target;\n    }\n\n    if (required) {\n      throw new Error(`Mentionable \"${name}\" is required.`);\n    }\n\n    return null;\n  }\n\n  /**\n   * Gets the subcommand name from the command.\n   * @param required - Whether the subcommand is required\n   * @returns The subcommand name or null if not found\n   */\n  getSubcommand(): string | null;\n  getSubcommand(required: true): string;\n  getSubcommand(required = false) {\n    const sub = this.parser.getSubcommand();\n\n    if (required && sub === undefined) {\n      throw new Error('Subcommand is required.');\n    }\n\n    return sub ?? null;\n  }\n\n  /**\n   * Gets the subcommand group name from the command.\n   * @param required - Whether the subcommand group is required\n   * @returns The subcommand group name or null if not found\n   */\n  getSubcommandGroup(): string | null;\n  getSubcommandGroup(required: true): string;\n  getSubcommandGroup(required = false) {\n    const sub = this.parser.getSubcommandGroup();\n\n    if (required && sub === undefined) {\n      throw new Error('Subcommand group is required.');\n    }\n\n    return sub ?? null;\n  }\n}\n"],"mappings":"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"}

package/dist/{PluginCommon-Di1xIa8d.js → PluginCommon-Cvl5yYM_.js}

@@ -1,5 +1,6 @@
 const require_chunk = require('./chunk-nOFOJqeH.js');
-const node_crypto = require_chunk.__toESM(require("node:crypto"));
+let node_crypto = require("node:crypto");
+node_crypto = require_chunk.__toESM(node_crypto);
 
 //#region src/plugins/PluginCommon.ts
 /**
@@ -67,4 +68,4 @@ Object.defineProperty(exports, 'isPlugin', {
     return isPlugin;
   }
 });
-//# sourceMappingURL=PluginCommon-Di1xIa8d.js.map
+//# sourceMappingURL=PluginCommon-Cvl5yYM_.js.map

package/dist/{PluginCommon-Di1xIa8d.js.map → PluginCommon-Cvl5yYM_.js.map}

@@ -1 +1 @@
-{"version":3,"file":"PluginCommon-Di1xIa8d.js","names":[],"sources":["../src/plugins/PluginCommon.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { CommonPluginRuntime } from './plugin-runtime/runtime';\n\n/**\n * The options for a CommandKit plugin.\n */\nexport type PluginOptions = Record<string, any>;\n\n/**\n * Enum representing the type of plugin.\n * - Compiler: A plugin that runs at compile time.\n * - Runtime: A plugin that runs at runtime.\n */\nexport enum PluginType {\n  Compiler = 'compiler',\n  Runtime = 'runtime',\n}\n\n/**\n * Base class for CommandKit plugins.\n */\nexport abstract class PluginCommon<\n  T extends PluginOptions = PluginOptions,\n  C extends CommonPluginRuntime = CommonPluginRuntime,\n> {\n  /**\n   * The type of the plugin, either Compiler or Runtime.\n   */\n  public abstract readonly type: PluginType;\n  /**\n   * Unique identifier for the plugin instance.\n   */\n  public readonly id = randomUUID();\n  /**\n   * The time when the plugin was loaded, in milliseconds since the Unix epoch.\n   */\n  public readonly loadedAt = Date.now();\n  /**\n   * The name of the plugin.\n   */\n  public abstract readonly name: string;\n\n  /**\n   * Creates a new instance of the plugin.\n   */\n  public constructor(protected readonly options: T) {}\n\n  /**\n   * Called when this plugin is activated\n   */\n  public async activate(ctx: C): Promise<void> {}\n\n  /**\n   * Called when this plugin is deactivated\n   */\n  public async deactivate(ctx: C): Promise<void> {}\n}\n\n/**\n * Whether the given object is a CommandKit plugin.\n * @param plugin The object to check.\n * @returns Boolean indicating whether the object is a plugin.\n */\nexport function isPlugin(\n  plugin: unknown,\n): plugin is PluginCommon<PluginOptions> {\n  return plugin instanceof PluginCommon;\n}\n"],"mappings":";;;;;;;;;AAaA,IAAY,oDAAL;AACL;AACA;;AACF;;;;AAKA,IAAsB,eAAtB,MAGA;;;;CAQE,AAAgB;;;;CAIhB,AAAgB,WAAW,KAAK;;;;CAShC,AAAO,YAAY,AAAmB,SAAY;EAAZ;CAAa;;;;CAKnD,MAAa,SAAS,KAAuB,CAAC;;;;CAK9C,MAAa,WAAW,KAAuB,CAAC;AAClD;;;;;;AAOA,SAAgB,SAChB,QACwC;AACtC,QAAO,kBAAkB;AAC3B"}
+{"version":3,"file":"PluginCommon-Cvl5yYM_.js","names":[],"sources":["../src/plugins/PluginCommon.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { CommonPluginRuntime } from './plugin-runtime/runtime';\n\n/**\n * The options for a CommandKit plugin.\n */\nexport type PluginOptions = Record<string, any>;\n\n/**\n * Enum representing the type of plugin.\n * - Compiler: A plugin that runs at compile time.\n * - Runtime: A plugin that runs at runtime.\n */\nexport enum PluginType {\n  Compiler = 'compiler',\n  Runtime = 'runtime',\n}\n\n/**\n * Base class for CommandKit plugins.\n */\nexport abstract class PluginCommon<\n  T extends PluginOptions = PluginOptions,\n  C extends CommonPluginRuntime = CommonPluginRuntime,\n> {\n  /**\n   * The type of the plugin, either Compiler or Runtime.\n   */\n  public abstract readonly type: PluginType;\n  /**\n   * Unique identifier for the plugin instance.\n   */\n  public readonly id = randomUUID();\n  /**\n   * The time when the plugin was loaded, in milliseconds since the Unix epoch.\n   */\n  public readonly loadedAt = Date.now();\n  /**\n   * The name of the plugin.\n   */\n  public abstract readonly name: string;\n\n  /**\n   * Creates a new instance of the plugin.\n   */\n  public constructor(protected readonly options: T) {}\n\n  /**\n   * Called when this plugin is activated\n   */\n  public async activate(ctx: C): Promise<void> {}\n\n  /**\n   * Called when this plugin is deactivated\n   */\n  public async deactivate(ctx: C): Promise<void> {}\n}\n\n/**\n * Whether the given object is a CommandKit plugin.\n * @param plugin The object to check.\n * @returns Boolean indicating whether the object is a plugin.\n */\nexport function isPlugin(\n  plugin: unknown,\n): plugin is PluginCommon<PluginOptions> {\n  return plugin instanceof PluginCommon;\n}\n"],"mappings":";;;;;;;;;;AAaA,IAAY,oDAAL;AACL;AACA;;;;;;AAMF,IAAsB,eAAtB,MAGA;;;;CAQE,AAAgB,kCAAiB;;;;CAIjC,AAAgB,WAAW,KAAK,KAAK;;;;CASrC,AAAO,YAAY,AAAmB,SAAY;EAAZ;;;;;CAKtC,MAAa,SAAS,KAAuB;;;;CAK7C,MAAa,WAAW,KAAuB;;;;;;;AAQjD,SAAgB,SAChB,QACwC;AACtC,QAAO,kBAAkB"}

package/dist/{RuntimePlugin-CBgBLXTG.js → RuntimePlugin-BUecuBIU.js}

@@ -1,4 +1,4 @@
-const require_PluginCommon = require('./PluginCommon-Di1xIa8d.js');
+const require_PluginCommon = require('./PluginCommon-Cvl5yYM_.js');
 
 //#region src/plugins/RuntimePlugin.ts
 /**
@@ -6,6 +6,7 @@ const require_PluginCommon = require('./PluginCommon-Di1xIa8d.js');
 */
 var RuntimePlugin = class extends require_PluginCommon.PluginCommon {
 	type = require_PluginCommon.PluginType.Runtime;
+	preload = /* @__PURE__ */ new Set();
 	/**
 	* Called before commands are loaded
 	*/
@@ -130,4 +131,4 @@ Object.defineProperty(exports, 'isRuntimePlugin', {
     return isRuntimePlugin;
   }
 });
-//# sourceMappingURL=RuntimePlugin-CBgBLXTG.js.map
+//# sourceMappingURL=RuntimePlugin-BUecuBIU.js.map

package/dist/RuntimePlugin-BUecuBIU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimePlugin-BUecuBIU.js","names":[],"sources":["../src/plugins/RuntimePlugin.ts"],"sourcesContent":["import { Interaction, Message } from 'discord.js';\nimport {\n  isPlugin,\n  PluginCommon,\n  PluginOptions,\n  PluginType,\n} from './PluginCommon';\nimport type { CommandKitPluginRuntime } from './plugin-runtime/CommandKitPluginRuntime';\nimport { CommandBuilderLike, PreparedAppCommandExecution } from '../app';\nimport { CommandKitEnvironment } from '../context/environment';\nimport { CommandKitHMREvent } from '../utils/dev-hooks';\nimport { PreRegisterCommandsEvent } from '../app/register/CommandRegistrar';\nimport { CommandKitEventDispatch } from './types';\n\n/**\n * CommandKit plugin that runs at the runtime.\n */\nexport abstract class RuntimePlugin<\n  T extends PluginOptions = PluginOptions,\n> extends PluginCommon<T, CommandKitPluginRuntime> {\n  public readonly type = PluginType.Runtime;\n  public readonly preload = new Set<string>();\n\n  /**\n   * Called before commands are loaded\n   */\n  public async onBeforeCommandsLoad(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after commands are loaded\n   */\n  public async onAfterCommandsLoad(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called before events are loaded\n   */\n  public async onBeforeEventsLoad(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after events are loaded\n   */\n  public async onAfterEventsLoad(ctx: CommandKitPluginRuntime): Promise<void> {}\n\n  /**\n   * Called before the client logs in\n   */\n  public async onBeforeClientLogin(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after the client logs in\n   */\n  public async onAfterClientLogin(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called before interaction is handled\n   * @param interaction The interaction\n   */\n  public async onBeforeInteraction(\n    ctx: CommandKitPluginRuntime,\n    interaction: Interaction,\n  ): Promise<void> {}\n\n  /**\n   * Called before message command is processed\n   * @param message The message\n   */\n  public async onBeforeMessageCommand(\n    ctx: CommandKitPluginRuntime,\n    message: Message,\n  ): Promise<void> {}\n\n  /**\n   * Called before command is executed. This method can execute the command itself.\n   * @param source The source that triggered the command\n   * @param command The command\n   * @param execute The function that executes the command\n   */\n  public async executeCommand(\n    ctx: CommandKitPluginRuntime,\n    env: CommandKitEnvironment,\n    source: Interaction | Message,\n    command: PreparedAppCommandExecution,\n    execute: () => Promise<any>,\n  ): Promise<boolean> {\n    return false;\n  }\n\n  /**\n   * Called after events router is initialized\n   * @param ctx The context\n   */\n  public async onEventsRouterInit(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after commands router is initialized\n   * @param ctx The context\n   */\n  public async onCommandsRouterInit(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called when HMR event is received\n   * @param ctx The context\n   * @param event The event\n   */\n  public async performHMR(\n    ctx: CommandKitPluginRuntime,\n    event: CommandKitHMREvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before command is loaded for registration. This method can be used to modify the command data before it is loaded.\n   * @param ctx The context\n   * @param commands The command that is being loaded. This is a CommandBuilderLike object which represents Discord's command\n   */\n  async prepareCommand(\n    ctx: CommandKitPluginRuntime,\n    commands: CommandBuilderLike,\n  ): Promise<CommandBuilderLike | null> {\n    return null;\n  }\n\n  /**\n   * Called before command is registered to discord. This method can cancel the registration of the command and handle it manually.\n   * @param ctx The context\n   * @param data The command registration data\n   */\n  async onBeforeRegisterCommands(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before global commands registration. This method can cancel the registration of the command and handle it manually.\n   * This method is called after `onBeforeRegisterCommands` if that stage was not handled.\n   * @param ctx The context\n   * @param event The command registration data\n   */\n  async onBeforeRegisterGlobalCommands(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before guild commands registration. This method can cancel the registration of the command and handle it manually.\n   * This method is called before guilds of the command are resolved. It is called after `onBeforeRegisterCommands` if that stage was not handled.\n   * @param ctx The context\n   * @param event The command registration data\n   */\n  async onBeforePrepareGuildCommandsRegistration(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before guild commands registration. This method can cancel the registration of the command and handle it manually.\n   * This method is called after guilds of the command are resolved. It is called after `onBeforePrepareGuildCommandsRegistration` if that stage was not handled.\n   * @param ctx The context\n   * @param event The command registration data\n   */\n  async onBeforeRegisterGuildCommands(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called after command and all of its deferred functions are executed.\n   * @param ctx The context\n   * @param env The environment of the command. This environment contains the command execution data such as command context and more.\n   */\n  async onAfterCommand(\n    ctx: CommandKitPluginRuntime,\n    env: CommandKitEnvironment,\n  ) {}\n\n  /**\n   * Called before emitting an event\n   * @param ctx The context\n   * @param event The event that is being emitted\n   */\n  public async willEmitEvent(\n    ctx: CommandKitPluginRuntime,\n    event: CommandKitEventDispatch,\n  ) {}\n}\n\nexport function isRuntimePlugin(plugin: unknown): plugin is RuntimePlugin {\n  return (\n    plugin instanceof RuntimePlugin ||\n    (isPlugin(plugin) && plugin.type === PluginType.Runtime)\n  );\n}\n"],"mappings":";;;;;;AAiBA,IAAsB,gBAAtB,cAEA,kCAAyC;CACvC,AAAgB,OAAO,gCAAW;CAClC,AAAgB,0BAAU,IAAI,KAAa;;;;CAK3C,MAAa,qBACb,KACgB;;;;CAKhB,MAAa,oBACb,KACgB;;;;CAKhB,MAAa,mBACb,KACgB;;;;CAKhB,MAAa,kBAAkB,KAA6C;;;;CAK5E,MAAa,oBACb,KACgB;;;;CAKhB,MAAa,mBACb,KACgB;;;;;CAMhB,MAAa,oBACb,KACA,aACgB;;;;;CAMhB,MAAa,uBACb,KACA,SACgB;;;;;;;CAQhB,MAAa,eACb,KACA,KACA,QACA,SACA,SACmB;AACjB,SAAO;;;;;;CAOT,MAAa,mBACb,KACgB;;;;;CAMhB,MAAa,qBACb,KACgB;;;;;;CAOhB,MAAa,WACb,KACA,OACgB;;;;;;CAOhB,MAAM,eACN,KACA,UACqC;AACnC,SAAO;;;;;;;CAQT,MAAM,yBACN,KACA,OACgB;;;;;;;CAQhB,MAAM,+BACN,KACA,OACgB;;;;;;;CAQhB,MAAM,yCACN,KACA,OACgB;;;;;;;CAQhB,MAAM,8BACN,KACA,OACgB;;;;;;CAOhB,MAAM,eACN,KACA,KACA;;;;;;CAOA,MAAa,cACb,KACA,OACA;;AAGF,SAAgB,gBAAgB,QAA0C;AACxE,QACE,kBAAkB,iBAClB,8BAAS,OAAO,IAAI,OAAO,SAAS,gCAAW"}

package/dist/analytics/analytics-engine.d.ts

@@ -1,4 +1,4 @@
-import { AnalyticsEngine, FilterFunction } from "../analytics-engine-vA4MaJYx.js";
+import { AnalyticsEngine, FilterFunction } from "../analytics-engine-AaAl3kQM.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";
@@ -20,13 +20,13 @@ import "../media-gallery-BMsXSot3.js";
 import "../section-Dh_FhPeC.js";
 import "../separator-CMf6Cyy5.js";
 import "../text-display-DRw3r_lK.js";
-import "../index-DSBMRX9A.js";
-import "../index-DdqikUQD.js";
-import "../MessageCommandParser-ROLibZPX.js";
-import "../signals-BQbEfy3X.js";
+import "../index-Dw5cCt-A.js";
+import "../index-E7Wvm5uX.js";
+import "../MessageCommandParser-BsGMOTDo.js";
+import "../signals-SHg7J1U_.js";
 import "../helpers-Wg6P5fRQ.js";
 import "../CommandsRouter-CoOA7hkf.js";
 import "../EventsRouter-BacqK6z3.js";
-import "../index-DKcmsWXw.js";
+import "../index-CUPkUUOR.js";
 import "../constants-MKu-Q1jh.js";
 export { AnalyticsEngine, FilterFunction };

package/dist/analytics/analytics-engine.js

@@ -1,37 +1,38 @@
-require('../colors-Cd4Oz-r-.js');
-require('../ActionRow-CmTHbo2t.js');
-require('../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../commandkit-DMEW0kJg.js');
+require('../colors-DL3ucTiT.js');
+require('../ActionRow-CbdGFWMT.js');
+require('../error-codes-Ds0bnPvT.js');
+const require_commandkit = require('../commandkit-ZoBBh0Q_.js');
 require('../common-CcfjYnPG.js');
 require('../common-vnMIelAE.js');
-require('../container-z621KfH5.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('../container-C6GtfAPW.js');
+require('../file-DVOELoNv.js');
+require('../media-gallery-zDtJ3kxb.js');
+require('../section-DlvrDoJK.js');
+require('../separator-DL6QH5H1.js');
+require('../text-display-DbMumig_.js');
 require('../v2-DofkPKHs.js');
 require('../element-Bak9llw_.js');
 require('../types-CUZOquUl.js');
-require('../EventInterceptor-CQ4PBpBJ.js');
+require('../EventInterceptor-CQEXyUTp.js');
 require('../constants-B5_Ta7PR.js');
-require('../PluginCommon-Di1xIa8d.js');
-require('../CompilerPlugin-CjoZAAR8.js');
-require('../RuntimePlugin-CBgBLXTG.js');
+require('../PluginCommon-Cvl5yYM_.js');
+require('../CompilerPlugin-M8r3yNAl.js');
+require('../RuntimePlugin-BUecuBIU.js');
 require('../types-q0Nm882H.js');
-require('../runtime-5fxB4uhe.js');
-require('../utils-BnXM4eKk.js');
-require('../resolve-file-url-DHTQj2mU.js');
-require('../types-package-DrnIdWLg.js');
-require('../EventWorkerContext-CSlD9rbx.js');
-require('../signals-DHdYrd-n.js');
-require('../constants-CUND8XkG.js');
-require('../MessageCommandParser-B_BEQ3p8.js');
-require('../CommandsRouter-Ci1Pe8Vd.js');
-require('../EventsRouter-C_J0M3uO.js');
-require('../router-DHnFRADH.js');
-require('../common-DNADUU3_.js');
-require('../CommandKitEventsChannel-Bgw0XCOl.js');
-require('../store-CiqLHedg.js');
+require('../resolve-file-url-ChIyw-Vf.js');
+require('../runtime-DB9CiPfe.js');
+require('../utils-KsNof0Xz.js');
+require('../types-package-BWArjyBF.js');
+require('../constants-BOOGN85p.js');
+require('../EventWorkerContext-Dq29tieI.js');
+require('../signals-ChFMD7mB.js');
+require('../helpers-Dl8wW6aO.js');
+require('../MessageCommandParser-Dl0xxtdr.js');
+require('../CommandsRouter-Dmzw-ikm.js');
+require('../EventsRouter-3Gygh-km.js');
+require('../router-Dn35v30f.js');
+require('../common-CrqwC-sx.js');
+require('../CommandKitEventsChannel-BtRzr3Tz.js');
+require('../store-CM6pWVZh.js');
 
 exports.AnalyticsEngine = require_commandkit.AnalyticsEngine;

package/dist/analytics/analytics-provider.d.ts

@@ -1,4 +1,4 @@
-import { AnalyticsEvent, AnalyticsProvider, IdentifyEvent } from "../analytics-engine-vA4MaJYx.js";
+import { AnalyticsEvent, AnalyticsProvider, IdentifyEvent } from "../analytics-engine-AaAl3kQM.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";
@@ -20,13 +20,13 @@ import "../media-gallery-BMsXSot3.js";
 import "../section-Dh_FhPeC.js";
 import "../separator-CMf6Cyy5.js";
 import "../text-display-DRw3r_lK.js";
-import "../index-DSBMRX9A.js";
-import "../index-DdqikUQD.js";
-import "../MessageCommandParser-ROLibZPX.js";
-import "../signals-BQbEfy3X.js";
+import "../index-Dw5cCt-A.js";
+import "../index-E7Wvm5uX.js";
+import "../MessageCommandParser-BsGMOTDo.js";
+import "../signals-SHg7J1U_.js";
 import "../helpers-Wg6P5fRQ.js";
 import "../CommandsRouter-CoOA7hkf.js";
 import "../EventsRouter-BacqK6z3.js";
-import "../index-DKcmsWXw.js";
+import "../index-CUPkUUOR.js";
 import "../constants-MKu-Q1jh.js";
 export { AnalyticsEvent, AnalyticsProvider, IdentifyEvent };

package/dist/analytics/constants.js

@@ -1,4 +1,4 @@
-const require_constants = require('../constants-CUND8XkG.js');
+const require_constants = require('../constants-BOOGN85p.js');
 
 exports.AnalyticsEvents = require_constants.AnalyticsEvents;
 exports.DO_NOT_TRACK_KEY = require_constants.DO_NOT_TRACK_KEY;

package/dist/analytics/utils.js

@@ -1,38 +1,39 @@
-require('../colors-Cd4Oz-r-.js');
-require('../ActionRow-CmTHbo2t.js');
-require('../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../commandkit-DMEW0kJg.js');
+require('../colors-DL3ucTiT.js');
+require('../ActionRow-CbdGFWMT.js');
+require('../error-codes-Ds0bnPvT.js');
+const require_commandkit = require('../commandkit-ZoBBh0Q_.js');
 require('../common-CcfjYnPG.js');
 require('../common-vnMIelAE.js');
-require('../container-z621KfH5.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('../container-C6GtfAPW.js');
+require('../file-DVOELoNv.js');
+require('../media-gallery-zDtJ3kxb.js');
+require('../section-DlvrDoJK.js');
+require('../separator-DL6QH5H1.js');
+require('../text-display-DbMumig_.js');
 require('../v2-DofkPKHs.js');
 require('../element-Bak9llw_.js');
 require('../types-CUZOquUl.js');
-require('../EventInterceptor-CQ4PBpBJ.js');
+require('../EventInterceptor-CQEXyUTp.js');
 require('../constants-B5_Ta7PR.js');
-require('../PluginCommon-Di1xIa8d.js');
-require('../CompilerPlugin-CjoZAAR8.js');
-require('../RuntimePlugin-CBgBLXTG.js');
+require('../PluginCommon-Cvl5yYM_.js');
+require('../CompilerPlugin-M8r3yNAl.js');
+require('../RuntimePlugin-BUecuBIU.js');
 require('../types-q0Nm882H.js');
-require('../runtime-5fxB4uhe.js');
-require('../utils-BnXM4eKk.js');
-require('../resolve-file-url-DHTQj2mU.js');
-require('../types-package-DrnIdWLg.js');
-require('../EventWorkerContext-CSlD9rbx.js');
-require('../signals-DHdYrd-n.js');
-require('../constants-CUND8XkG.js');
-require('../MessageCommandParser-B_BEQ3p8.js');
-require('../CommandsRouter-Ci1Pe8Vd.js');
-require('../EventsRouter-C_J0M3uO.js');
-require('../router-DHnFRADH.js');
-require('../common-DNADUU3_.js');
-require('../CommandKitEventsChannel-Bgw0XCOl.js');
-require('../store-CiqLHedg.js');
+require('../resolve-file-url-ChIyw-Vf.js');
+require('../runtime-DB9CiPfe.js');
+require('../utils-KsNof0Xz.js');
+require('../types-package-BWArjyBF.js');
+require('../constants-BOOGN85p.js');
+require('../EventWorkerContext-Dq29tieI.js');
+require('../signals-ChFMD7mB.js');
+require('../helpers-Dl8wW6aO.js');
+require('../MessageCommandParser-Dl0xxtdr.js');
+require('../CommandsRouter-Dmzw-ikm.js');
+require('../EventsRouter-3Gygh-km.js');
+require('../router-Dn35v30f.js');
+require('../common-CrqwC-sx.js');
+require('../CommandKitEventsChannel-BtRzr3Tz.js');
+require('../store-CM6pWVZh.js');
 
 exports.getDoNotTrack = require_commandkit.getDoNotTrack;
 exports.noAnalytics = require_commandkit.noAnalytics;

package/dist/{analytics-engine-vA4MaJYx.d.ts → analytics-engine-AaAl3kQM.d.ts}

@@ -1,12 +1,12 @@
 import { EventInterceptor } from "./EventInterceptor-x-R2qshQ.js";
 import { Fragment, createElement } from "./element-CAXu1XtK.js";
 import { MaybeArray } from "./types-CJ-XvOFN.js";
-import { MessageCommandOptions, MessageCommandParser } from "./MessageCommandParser-ROLibZPX.js";
+import { MessageCommandOptions, MessageCommandParser } from "./MessageCommandParser-BsGMOTDo.js";
 import { Command, CommandsRouter, Middleware } from "./CommandsRouter-CoOA7hkf.js";
 import { EventsRouter, ParsedEvent } from "./EventsRouter-BacqK6z3.js";
 import { HMREventType } from "./constants-MKu-Q1jh.js";
 import EventEmitter from "node:events";
-import { AutocompleteInteraction, Awaitable, CacheType, ChatInputCommandInteraction, Client, ClientEvents, Collection, Constructable, ContextMenuCommandBuilder, ContextMenuCommandInteraction, Guild, Interaction, Locale, Message, MessageContextMenuCommandInteraction, RESTPostAPIApplicationCommandsJSONBody, SlashCommandBuilder, TextBasedChannel, UserContextMenuCommandInteraction } from "discord.js";
+import { AutocompleteInteraction, Awaitable, CacheType, ChatInputCommandInteraction, Client, ClientEvents, Collection, Constructable, ContextMenuCommandBuilder, ContextMenuCommandInteraction, Guild, Interaction, Locale, Message, MessageContextMenuCommandInteraction, PermissionsString, RESTPostAPIApplicationCommandsJSONBody, SlashCommandBuilder, TextBasedChannel, UserContextMenuCommandInteraction } from "discord.js";
 import { DirectiveTransformerOptions } from "directive-to-hof";
 import { Options } from "tsdown";
 
@@ -38,18 +38,48 @@ interface CommandContext<T extends Interaction, Cached extends CacheType> {
    */
   handler: CommandKit;
 }
+/**
+ * Represents the command metadata.
+ */
+interface CommandMetadata {
+  /**
+   * The guilds that the command is available in.
+   */
+  guilds?: string[];
+  /**
+   * The aliases of the command.
+   */
+  aliases?: string[];
+  /**
+   * The user permissions required to execute the command.
+   */
+  userPermissions?: PermissionsString | PermissionsString[];
+  /**
+   * The bot permissions required to execute the command.
+   */
+  botPermissions?: PermissionsString | PermissionsString[];
+  /**
+   * The name aliases for the `user` and `message` context menu commands. When i18n plugin is in use, this option will be ignored if the translation for the context menu command name is provided.
+   */
+  nameAliases?: Record<'user' | 'message', string>;
+}
 /**
  * Represents a command that can be executed by CommandKit.
  */
 type CommandData = Prettify<Omit<RESTPostAPIApplicationCommandsJSONBody, 'description'> & {
+  /**
+   * The description of the command.
+   */
   description?: string;
-  guilds?: string[];
-  aliases?: string[];
 }>;
 /**
  * Represents an event handler for a specific event.
  */
-type EventHandler<K extends keyof ClientEvents> = (...args: ClientEvents[K]) => void | Promise<void>;
+type EventHandler<K extends keyof ClientEvents> = (...args: [...ClientEvents[K], Client<true>, CommandKit]) => void | Promise<void>;
+/**
+ * The command metadata function
+ */
+type CommandMetadataFunction = () => Promise<CommandMetadata> | CommandMetadata;
 //#endregion
 //#region src/app/commands/Context.d.ts
 /**
@@ -77,7 +107,7 @@ interface ContextParameters<T extends CommandExecutionMode, Args = Record<string
   message: T extends 'message' ? Message : never;
   forwarded?: boolean;
   messageCommandParser?: T extends 'message' ? MessageCommandParser : never;
-  store?: Map<string, any>;
+  store?: Collection<string, any>;
   customArgs?: Args;
 }
 /**
@@ -217,7 +247,7 @@ declare class Context<ExecutionMode extends CommandExecutionMode = CommandExecut
    * The shared key-value store for this context. This can be used to store data that needs to be shared between middlewares or commands.
    * This store is shared across all contexts in the same command execution, including the cloned contexts and middleware contexts.
    */
-  get store(): Map<string, any>;
+  get store(): Collection<any, any>;
   /**
    * Gets the name of the current command.
    */
@@ -300,27 +330,11 @@ declare class Context<ExecutionMode extends CommandExecutionMode = CommandExecut
    * @returns Array of command arguments
    */
   args(): string[];
-  /**
-   * Stops upcoming middleware or current command execution.
-   * If this is called inside pre-stage middleware, the next run will be the actual command, skipping all other pre-stage middlewares.
-   * If this is called inside a command itself, it will skip all post-stage middlewares.
-   * If this is called inside post-stage middleware, it will skip all other post-stage middlewares.
-   */
-  exit(): never;
 }
 /**
  * Extended context class for middleware execution with additional control methods.
  */
 declare class MiddlewareContext<T extends CommandExecutionMode = CommandExecutionMode> extends Context<T, MiddlewareContextArgs> {
-  #private;
-  /**
-   * Whether the command execution was cancelled.
-   */
-  get cancelled(): boolean;
-  /**
-   * Cancels the command execution.
-   */
-  cancel(): void;
   /**
    * Sets command runner function to wrap the command execution.
    * @param fn The function to set.
@@ -359,7 +373,9 @@ declare class CommandRegistrar {
   /**
    * Gets the commands data.
    */
-  getCommandsData(): CommandData[];
+  getCommandsData(): (CommandData & {
+    __metadata?: CommandMetadata;
+  })[];
   /**
    * Registers loaded commands.
    */
@@ -367,11 +383,15 @@ declare class CommandRegistrar {
   /**
    * Updates the global commands.
    */
-  updateGlobalCommands(commands: CommandData[]): Promise<void>;
+  updateGlobalCommands(commands: (CommandData & {
+    __metadata?: CommandMetadata;
+  })[]): Promise<void>;
   /**
    * Updates the guild commands.
    */
-  updateGuildCommands(commands: CommandData[]): Promise<void>;
+  updateGuildCommands(commands: (CommandData & {
+    __metadata?: CommandMetadata;
+  })[]): Promise<void>;
 }
 //#endregion
 //#region src/context/environment.d.ts
@@ -417,6 +437,10 @@ interface CommandKitEnvironmentInternalData {
    * This can be used to access request-specific data or application state.
    */
   context: Context | null;
+  /**
+   * Shared collection instance for arbitrary data storage
+   */
+  store: Collection<any, any>;
 }
 /**
  * Represents the execution environment for CommandKit commands.
@@ -464,6 +488,10 @@ declare class CommandKitEnvironment {
    * The variables store for this environment.
    */
   get variables(): Map<string, any>;
+  /**
+   * The shared store for this environment
+   */
+  get store(): Collection<any, any>;
   /**
    * Register a deferred function.
    * @param fn - The deferred function to register.
@@ -594,6 +622,10 @@ declare function getContext(): CommandKitEnvironment | undefined;
  * Use current commandkit context. Throws an error if no context is found.
  */
 declare function useEnvironment(): CommandKitEnvironment;
+/**
+ * Use the shared data store in the current environment. Throws an error if no context is found.
+ */
+declare function useStore(): Collection<any, any>;
 //#endregion
 //#region src/app/commands/AppCommandRunner.d.ts
 /**
@@ -631,6 +663,7 @@ declare class AppCommandRunner {
    * Handles the complete command lifecycle including before/after middleware execution.
    * @param prepared - The prepared command execution data
    * @param source - The source interaction or message that triggered the command
+   * @param options - The options for running the command
    */
   runCommand(prepared: PreparedAppCommandExecution, source: Interaction | Message, options?: RunCommandOptions): Promise<any>;
   /**
@@ -653,6 +686,8 @@ type RunCommand = <T extends AsyncFunction>(fn: T) => T;
  */
 interface AppCommandNative {
   command: CommandData | Record<string, any>;
+  generateMetadata?: CommandMetadataFunction;
+  metadata?: CommandMetadata;
   chatInput?: (ctx: Context) => Awaitable<unknown>;
   autocomplete?: (ctx: Context) => Awaitable<unknown>;
   message?: (ctx: Context) => Awaitable<unknown>;
@@ -684,8 +719,8 @@ interface AppCommandMiddleware {
  */
 interface LoadedCommand {
   command: Command;
+  metadata: CommandMetadata;
   data: AppCommand;
-  guilds?: string[];
 }
 /**
  * Type representing command data identifier.
@@ -727,8 +762,20 @@ declare const commandDataSchema: {
   messageContextMenu: (c: unknown) => c is Function;
   userContextMenu: (c: unknown) => c is Function;
 };
+/**
+ * @private
+ * @internal
+ */
 type CommandDataSchema = typeof commandDataSchema;
+/**
+ * @private
+ * @internal
+ */
 type CommandDataSchemaKey = keyof CommandDataSchema;
+/**
+ * @private
+ * @internal
+ */
 type CommandDataSchemaValue = CommandDataSchema[CommandDataSchemaKey];
 /**
  * Handles application commands for CommandKit, including loading, registration, and execution.
@@ -800,6 +847,7 @@ declare class AppCommandHandler {
   /**
    * Finds a command by name.
    * @param name - The command name to search for
+   * @param hint - The hint for the command type (user or message)
    * @returns The loaded command or null if not found
    */
   private findCommandByName;
@@ -841,6 +889,13 @@ declare class AppCommandHandler {
    * @internal
    */
   private loadCommand;
+  /**
+   * Gets the metadata for a command.
+   * @param command - The command name to get metadata for
+   * @param hint - The hint for the command type (user or message)
+   * @returns The command metadata or null if not found
+   */
+  getMetadataFor(command: string, hint?: 'user' | 'message'): CommandMetadata | null;
 }
 //#endregion
 //#region src/events/CommandKitEventsChannel.d.ts
@@ -1039,6 +1094,7 @@ declare function registerDevHooks(commandkit: CommandKit): void;
  */
 declare abstract class RuntimePlugin<T extends PluginOptions = PluginOptions> extends PluginCommon<T, CommandKitPluginRuntime> {
   readonly type = PluginType.Runtime;
+  readonly preload: Set<string>;
   /**
    * Called before commands are loaded
    */
@@ -1426,6 +1482,11 @@ declare class CommandKitPluginRuntime {
    * @param plugin The plugin to be fetched.
    */
   get<T extends Constructable<any>>(plugin: T): InstanceType<T> | null;
+  /**
+   * Pre-loads the specified entrypoints for the given plugin.
+   * @param plugin The plugin to pre-load.
+   */
+  preload(plugin: RuntimePlugin): Promise<void>;
   /**
    * Soft registers a plugin in the runtime.
    * @param plugin The plugin to be registered.
@@ -1864,6 +1925,11 @@ interface CommandKitConfig {
    * @default false
    */
   disablePrefixCommands?: boolean;
+  /**
+   * Whether or not to disable the built-in permissions middleware. This only affects `botPermissions` and `userPermissions` in the command metadata.
+   * @default false
+   */
+  disablePermissionsMiddleware?: boolean;
   /**
    * Whether or not to show a warning when a prefix command is not found. This only affects development mode.
    * @default true
@@ -1909,7 +1975,7 @@ interface CommandKitConfiguration {
    * @param message The message to get the command prefix for.
    * @returns The command prefix or an array of prefixes.
    */
-  getMessageCommandPrefix: (message: Message) => Awaitable<string | string[]>;
+  getMessageCommandPrefix: (message: Message) => Awaitable<string | string[] | RegExp>;
 }
 /**
  * Represents the function executed during the bootstrap phase of CommandKit.
@@ -2014,7 +2080,6 @@ declare class CommandKit extends EventEmitter {
   /**
    * Create a new command and event handler with CommandKit.
    * @param options - The default CommandKit configuration.
-   * @see {@link https://commandkit.js.org/docs/guide/commandkit-setup}
    */
   constructor(options?: CommandKitOptions);
   /**
@@ -2034,7 +2099,7 @@ declare class CommandKit extends EventEmitter {
    * Sets the prefix resolver for the command handler.
    * @param resolver The resolver function.
    */
-  setPrefixResolver(resolver: (message: Message) => Awaitable<string | string[]>): this;
+  setPrefixResolver(resolver: (message: Message) => Awaitable<string | string[] | RegExp>): this;
   /**
    * Sets the default locale for the command handler.
    * @param locale The default locale.
@@ -2179,5 +2244,5 @@ declare class AnalyticsEngine {
   track(event: AnalyticsEvent): Promise<void>;
 }
 //#endregion
-export { AnalyticsEngine, AnalyticsEvent, AnalyticsProvider, AnyCommandExecute, AppCommand, AppCommandHandler, AppCommandNative, AppCommandRunner, AppEventsHandler, AppEventsHandlerLoadedData, AsyncFunction, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, BootstrapFunction, ChatInputCommand, ChatInputCommandContext, CommandBuilderLike, CommandContext, CommandContextOptions, CommandData, CommandDataSchema, CommandDataSchemaKey, CommandDataSchemaValue, CommandExecutionMode, CommandFlagContext, CommandKit, CommandKitCompilerOptions, CommandKitConfig, CommandKitConfiguration, CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, CommandKitEventDispatch, CommandKitEventsChannel, CommandKitHMREvent, CommandKitOptions, CommandKitPlugin, CommandKitPluginRuntime, CommandRegistrar, CommandTypeData, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CompilerPlugin, CompilerPluginRuntime, Context, ContextParameters, CustomAppCommandProps, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, DeepPartial, DeepRequired, EvaluationContext, EventFlagContext, EventHandler, EventListener, FeatureFlag, FeatureFlagDefinition, FilterFunction, FlagConfiguration, FlagProvider, FlagRunner, FlagStore, GenericFunction, IdentifyEvent, IdentifyFunction, InteractionCommandContext, InteractionCommandMiddlewareContext, IpcMessageCommand, JsonFlagProvider, ListenerFunction, LoadedCommand, LoadedEvent, MaybeFalsey, MaybePromise, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, MiddlewareContext, MiddlewareContextArgs, PluginCommon, PluginOptions, PluginTransformParameters, PluginType, PreRegisterCommandsEvent, PreparedAppCommandExecution, ResolvableCommand, ResolvedCommandKitConfig, RunCommand, RunCommandOptions, RuntimePlugin, SlashCommandMiddlewareContext, TemplateHandler, TransformedResult, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext, after, cancelAfter, commandkit, exitContext, flag, getCommandKit, getContext, isCommandWorkerContext, isCompilerPlugin, isPlugin, isRuntimePlugin, makeContextAwareFunction, mergeDeep, onApplicationBootstrap, onBootstrap, provideContext, registerDevHooks, setFlagProvider, useEnvironment };
-//# sourceMappingURL=analytics-engine-vA4MaJYx.d.ts.map
+export { AnalyticsEngine, AnalyticsEvent, AnalyticsProvider, AnyCommandExecute, AppCommand, AppCommandHandler, AppCommandNative, AppCommandRunner, AppEventsHandler, AppEventsHandlerLoadedData, AsyncFunction, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, BootstrapFunction, ChatInputCommand, ChatInputCommandContext, CommandBuilderLike, CommandContext, CommandContextOptions, CommandData, CommandDataSchema, CommandDataSchemaKey, CommandDataSchemaValue, CommandExecutionMode, CommandFlagContext, CommandKit, CommandKitCompilerOptions, CommandKitConfig, CommandKitConfiguration, CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, CommandKitEventDispatch, CommandKitEventsChannel, CommandKitHMREvent, CommandKitOptions, CommandKitPlugin, CommandKitPluginRuntime, CommandMetadata, CommandMetadataFunction, CommandRegistrar, CommandTypeData, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CompilerPlugin, CompilerPluginRuntime, Context, ContextParameters, CustomAppCommandProps, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, DeepPartial, DeepRequired, EvaluationContext, EventFlagContext, EventHandler, EventListener, FeatureFlag, FeatureFlagDefinition, FilterFunction, FlagConfiguration, FlagProvider, FlagRunner, FlagStore, GenericFunction, IdentifyEvent, IdentifyFunction, InteractionCommandContext, InteractionCommandMiddlewareContext, IpcMessageCommand, JsonFlagProvider, ListenerFunction, LoadedCommand, LoadedEvent, MaybeFalsey, MaybePromise, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, MiddlewareContext, MiddlewareContextArgs, PluginCommon, PluginOptions, PluginTransformParameters, PluginType, PreRegisterCommandsEvent, PreparedAppCommandExecution, ResolvableCommand, ResolvedCommandKitConfig, RunCommand, RunCommandOptions, RuntimePlugin, SlashCommandMiddlewareContext, TemplateHandler, TransformedResult, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext, after, cancelAfter, commandkit, exitContext, flag, getCommandKit, getContext, isCommandWorkerContext, isCompilerPlugin, isPlugin, isRuntimePlugin, makeContextAwareFunction, mergeDeep, onApplicationBootstrap, onBootstrap, provideContext, registerDevHooks, setFlagProvider, useEnvironment, useStore };
+//# sourceMappingURL=analytics-engine-AaAl3kQM.d.ts.map

package/dist/app/commands/AppCommandRunner.d.ts

@@ -1,4 +1,4 @@
-import { AppCommandRunner, RunCommandOptions } from "../../analytics-engine-vA4MaJYx.js";
+import { AppCommandRunner, RunCommandOptions } from "../../analytics-engine-AaAl3kQM.js";
 import "../../EventInterceptor-x-R2qshQ.js";
 import "../../ButtonKit-C7r7RPNf.js";
 import "../../ModalKit-Btz58KYn.js";
@@ -20,13 +20,13 @@ import "../../media-gallery-BMsXSot3.js";
 import "../../section-Dh_FhPeC.js";
 import "../../separator-CMf6Cyy5.js";
 import "../../text-display-DRw3r_lK.js";
-import "../../index-DSBMRX9A.js";
-import "../../index-DdqikUQD.js";
-import "../../MessageCommandParser-ROLibZPX.js";
-import "../../signals-BQbEfy3X.js";
+import "../../index-Dw5cCt-A.js";
+import "../../index-E7Wvm5uX.js";
+import "../../MessageCommandParser-BsGMOTDo.js";
+import "../../signals-SHg7J1U_.js";
 import "../../helpers-Wg6P5fRQ.js";
 import "../../CommandsRouter-CoOA7hkf.js";
 import "../../EventsRouter-BacqK6z3.js";
-import "../../index-DKcmsWXw.js";
+import "../../index-CUPkUUOR.js";
 import "../../constants-MKu-Q1jh.js";
 export { AppCommandRunner, RunCommandOptions };