commandkit 0.1.11-dev.20250404110151 → 0.1.11-dev.20250405091951

package/dist/index.d.ts

@@ -731,6 +731,36 @@ declare function rethrow(error: unknown): void;
  */
 declare function redirect(): never;
 
+interface PreRegisterCommandsEvent {
+    preventDefault(): void;
+    commands: CommandData[];
+}
+declare class CommandRegistrar {
+    readonly commandkit: CommandKit;
+    private api;
+    /**
+     * Creates an instance of CommandRegistrar.
+     * @param commandkit The commandkit instance.
+     */
+    constructor(commandkit: CommandKit);
+    /**
+     * Gets the commands data.
+     */
+    getCommandsData(): CommandData[];
+    /**
+     * Registers loaded commands.
+     */
+    register(): Promise<void>;
+    /**
+     * Updates the global commands.
+     */
+    updateGlobalCommands(commands: CommandData[]): Promise<void>;
+    /**
+     * Updates the guild commands.
+     */
+    updateGuildCommands(commands: CommandData[]): Promise<void>;
+}
+
 type CommandSource = Interaction | Message$1;
 declare function isMessageSource(source: CommandSource): source is Message$1;
 declare function isInteractionSource(source: CommandSource): source is Interaction;
@@ -1035,32 +1065,6 @@ declare class MiddlewareContext<T extends CommandExecutionMode = CommandExecutio
     setCommandRunner(fn: RunCommand): void;
 }
 
-declare class CommandRegistrar {
-    readonly commandkit: CommandKit;
-    private api;
-    /**
-     * Creates an instance of CommandRegistrar.
-     * @param commandkit The commandkit instance.
-     */
-    constructor(commandkit: CommandKit);
-    /**
-     * Gets the commands data.
-     */
-    getCommandsData(): CommandData[];
-    /**
-     * Registers loaded commands.
-     */
-    register(): Promise<void>;
-    /**
-     * Updates the global commands.
-     */
-    updateGlobalCommands(commands: CommandData[]): Promise<void>;
-    /**
-     * Updates the guild commands.
-     */
-    updateGuildCommands(commands: CommandData[]): Promise<void>;
-}
-
 declare class MemoryCache extends CacheProvider {
     #private;
     get<T>(key: string): Promise<CacheEntry<T> | undefined>;
@@ -1664,6 +1668,33 @@ declare abstract class RuntimePlugin<T extends PluginOptions = PluginOptions> ex
      * @param commands The command that is being loaded. This is a CommandBuilderLike object which represents Discord's command
      */
     prepareCommand(ctx: CommandKitPluginRuntime, commands: CommandBuilderLike): Promise<CommandBuilderLike | null>;
+    /**
+     * Called before command is registered to discord. This method can cancel the registration of the command and handle it manually.
+     * @param ctx The context
+     * @param data The command registration data
+     */
+    onBeforeRegisterCommands(ctx: CommandKitPluginRuntime, event: PreRegisterCommandsEvent): Promise<void>;
+    /**
+     * Called before global commands registration. This method can cancel the registration of the command and handle it manually.
+     * This method is called after `onBeforeRegisterCommands` if that stage was not handled.
+     * @param ctx The context
+     * @param event The command registration data
+     */
+    onBeforeRegisterGlobalCommands(ctx: CommandKitPluginRuntime, event: PreRegisterCommandsEvent): Promise<void>;
+    /**
+     * Called before guild commands registration. This method can cancel the registration of the command and handle it manually.
+     * This method is called before guilds of the command are resolved. It is called after `onBeforeRegisterCommands` if that stage was not handled.
+     * @param ctx The context
+     * @param event The command registration data
+     */
+    onBeforePrepareGuildCommandsRegistration(ctx: CommandKitPluginRuntime, event: PreRegisterCommandsEvent): Promise<void>;
+    /**
+     * Called before guild commands registration. This method can cancel the registration of the command and handle it manually.
+     * This method is called after guilds of the command are resolved. It is called after `onBeforePrepareGuildCommandsRegistration` if that stage was not handled.
+     * @param ctx The context
+     * @param event The command registration data
+     */
+    onBeforeRegisterGuildCommands(ctx: CommandKitPluginRuntime, event: PreRegisterCommandsEvent): Promise<void>;
 }
 declare function isRuntimePlugin(plugin: unknown): plugin is RuntimePlugin;
 
@@ -1772,7 +1803,7 @@ interface CommandKitConfig {
     /**
      * The plugins to use with CommandKit.
      */
-    plugins?: CommandKitPlugin[];
+    plugins?: MaybeArray<CommandKitPlugin[]>;
     /**
      * The esbuild plugins to use with CommandKit.
      */
@@ -1938,4 +1969,4 @@ declare function devOnly<T extends (...args: any[]) => any>(fn: T): T;
  */
 declare function bootstrapCommandkitCLI(argv: string[], options?: commander.ParseOptions | undefined): Promise<void>;
 
-export { ActionRow, type ActionRowProps, type AnyCommandExecute, type AnyCommandKitElement, AppCommandHandler, type AsyncFunction, type AutocompleteCommand, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, COMMANDKIT_CACHE_TAG, COMMANDKIT_IS_DEV, COMMANDKIT_IS_TEST, type CacheContext, type CacheEntry, type CacheMetadata, CacheProvider, ChannelSelectMenu, ChannelSelectMenuKit, type ChannelSelectMenuKitPredicate, type ChannelSelectMenuProps, type Command, type CommandBuilderLike, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfiguration, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitHMREvent, type CommandKitLoggerOptions, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandKitPlugin, CommandKitPluginRuntime, type CommandKitSelectMenuBuilderInteractionCollectorDispatch, type CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, type CommandKitSelectMenuBuilderOnEnd, type CommandSource, type CommandTypeData, CommandsRouter, type CommandsRouterOptions, type CommonBuilderKit, type CommonPluginRuntime, type CommonSelectMenuProps, CompilerPlugin, CompilerPluginRuntime, Context, type ContextParameters, DefaultLogger, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, EventsRouter, type EventsRouterOptions, type EventsTree, Fragment, type FragmentElementProps, type GenericFunction, HMREventType, type ILogger, type InteractionCommandContext, type InteractionCommandMiddlewareContext, type LoadedCommand, type Loader, type Location, Logger, type LoggerImpl, type MaybeArray, type MaybeFalsey, MemoryCache, MentionableSelectMenu, MentionableSelectMenuKit, type MentionableSelectMenuKitPredicate, type MentionableSelectMenuProps, type Message, type MessageCommand, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommand, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type Middleware, MiddlewareContext, type MiddlewareContextArgs, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnChannelSelectMenuKitSubmit, type OnLoadArgs, type OnLoadOptions, type OnLoadResult, type OnMentionableSelectMenuKitSubmit, type OnModalKitEnd, type OnModalKitSubmit, type OnResolveArgs, type OnResolveOptions, type OnResolveResult, type OnRoleSelectMenuKitSubmit, type OnSelectMenuKitEnd, type OnSelectMenuKitSubmit, type OnStringSelectMenuKitSubmit, type OnUserSelectMenuKitSubmit, ParagraphInput, type ParsedCommandData, type ParsedEvent, type ParsedMessageCommand, type PluginTransformParameters, type PreparedAppCommandExecution, type ResolvableCommand, type ResolveBuilderInteraction, type ResolveKind, type ResolveResult, RoleSelectMenu, RoleSelectMenuKit, type RoleSelectMenuKitPredicate, type RoleSelectMenuProps, type RunCommand, RuntimePlugin, type SelectMenuKitPredicate, type SelectMenuProps, type Setup, ShortInput, type SlashCommand, type SlashCommandContext, type SlashCommandMiddlewareContext, StringSelectMenu, StringSelectMenuKit, type StringSelectMenuKitPredicate, StringSelectMenuOption, type StringSelectMenuOptionProps, type StringSelectMenuProps, TextInput, type TextInputProps, type TransformedResult, type UserContextMenuCommand, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, UserSelectMenu, UserSelectMenuKit, type UserSelectMenuKitPredicate, type UserSelectMenuProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, commandkit, createElement, createLogger, debounce, CommandKit as default, defineConfig, devOnly, exitContext, exitMiddleware, fromEsbuildPlugin, getCommandKit, getConfig, getContext, getCurrentDirectory, getElement, getSourceDirectories, invalidate, isCachedFunction, isCommandKitElement, isCompilerPlugin, isInteractionSource, isMessageSource, isRuntimePlugin, makeContextAwareFunction, provideContext, redirect, rethrow, revalidate, useEnvironment, version, zzz_commandkit_secret_internal_use_cache_wrapper_do_not_use_or_you_will_be_fired };
+export { ActionRow, type ActionRowProps, type AnyCommandExecute, type AnyCommandKitElement, AppCommandHandler, type AsyncFunction, type AutocompleteCommand, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, COMMANDKIT_CACHE_TAG, COMMANDKIT_IS_DEV, COMMANDKIT_IS_TEST, type CacheContext, type CacheEntry, type CacheMetadata, CacheProvider, ChannelSelectMenu, ChannelSelectMenuKit, type ChannelSelectMenuKitPredicate, type ChannelSelectMenuProps, type Command, type CommandBuilderLike, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfiguration, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitHMREvent, type CommandKitLoggerOptions, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandKitPlugin, CommandKitPluginRuntime, type CommandKitSelectMenuBuilderInteractionCollectorDispatch, type CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, type CommandKitSelectMenuBuilderOnEnd, CommandRegistrar, type CommandSource, type CommandTypeData, CommandsRouter, type CommandsRouterOptions, type CommonBuilderKit, type CommonPluginRuntime, type CommonSelectMenuProps, CompilerPlugin, CompilerPluginRuntime, Context, type ContextParameters, DefaultLogger, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, EventsRouter, type EventsRouterOptions, type EventsTree, Fragment, type FragmentElementProps, type GenericFunction, HMREventType, type ILogger, type InteractionCommandContext, type InteractionCommandMiddlewareContext, type LoadedCommand, type Loader, type Location, Logger, type LoggerImpl, type MaybeArray, type MaybeFalsey, MemoryCache, MentionableSelectMenu, MentionableSelectMenuKit, type MentionableSelectMenuKitPredicate, type MentionableSelectMenuProps, type Message, type MessageCommand, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommand, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type Middleware, MiddlewareContext, type MiddlewareContextArgs, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnChannelSelectMenuKitSubmit, type OnLoadArgs, type OnLoadOptions, type OnLoadResult, type OnMentionableSelectMenuKitSubmit, type OnModalKitEnd, type OnModalKitSubmit, type OnResolveArgs, type OnResolveOptions, type OnResolveResult, type OnRoleSelectMenuKitSubmit, type OnSelectMenuKitEnd, type OnSelectMenuKitSubmit, type OnStringSelectMenuKitSubmit, type OnUserSelectMenuKitSubmit, ParagraphInput, type ParsedCommandData, type ParsedEvent, type ParsedMessageCommand, type PluginTransformParameters, type PreRegisterCommandsEvent, type PreparedAppCommandExecution, type ResolvableCommand, type ResolveBuilderInteraction, type ResolveKind, type ResolveResult, RoleSelectMenu, RoleSelectMenuKit, type RoleSelectMenuKitPredicate, type RoleSelectMenuProps, type RunCommand, RuntimePlugin, type SelectMenuKitPredicate, type SelectMenuProps, type Setup, ShortInput, type SlashCommand, type SlashCommandContext, type SlashCommandMiddlewareContext, StringSelectMenu, StringSelectMenuKit, type StringSelectMenuKitPredicate, StringSelectMenuOption, type StringSelectMenuOptionProps, type StringSelectMenuProps, TextInput, type TextInputProps, type TransformedResult, type UserContextMenuCommand, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, UserSelectMenu, UserSelectMenuKit, type UserSelectMenuKitPredicate, type UserSelectMenuProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, commandkit, createElement, createLogger, debounce, CommandKit as default, defineConfig, devOnly, exitContext, exitMiddleware, fromEsbuildPlugin, getCommandKit, getConfig, getContext, getCurrentDirectory, getElement, getSourceDirectories, invalidate, isCachedFunction, isCommandKitElement, isCompilerPlugin, isInteractionSource, isMessageSource, isRuntimePlugin, makeContextAwareFunction, provideContext, redirect, rethrow, revalidate, useEnvironment, version, zzz_commandkit_secret_internal_use_cache_wrapper_do_not_use_or_you_will_be_fired };

package/dist/index.js

@@ -2053,6 +2053,37 @@ var init_RuntimePlugin = __esm({
       async prepareCommand(ctx, commands) {
         return null;
       }
+      /**
+       * Called before command is registered to discord. This method can cancel the registration of the command and handle it manually.
+       * @param ctx The context
+       * @param data The command registration data
+       */
+      async onBeforeRegisterCommands(ctx, event) {
+      }
+      /**
+       * Called before global commands registration. This method can cancel the registration of the command and handle it manually.
+       * This method is called after `onBeforeRegisterCommands` if that stage was not handled.
+       * @param ctx The context
+       * @param event The command registration data
+       */
+      async onBeforeRegisterGlobalCommands(ctx, event) {
+      }
+      /**
+       * Called before guild commands registration. This method can cancel the registration of the command and handle it manually.
+       * This method is called before guilds of the command are resolved. It is called after `onBeforeRegisterCommands` if that stage was not handled.
+       * @param ctx The context
+       * @param event The command registration data
+       */
+      async onBeforePrepareGuildCommandsRegistration(ctx, event) {
+      }
+      /**
+       * Called before guild commands registration. This method can cancel the registration of the command and handle it manually.
+       * This method is called after guilds of the command are resolved. It is called after `onBeforePrepareGuildCommandsRegistration` if that stage was not handled.
+       * @param ctx The context
+       * @param event The command registration data
+       */
+      async onBeforeRegisterGuildCommands(ctx, event) {
+      }
     };
     __name(_RuntimePlugin, "RuntimePlugin");
     RuntimePlugin = _RuntimePlugin;
@@ -2810,7 +2841,10 @@ function defineConfig(config = {}) {
       ...config.esbuildPlugins ?? [],
       ...defaultConfig.esbuildPlugins ?? []
     ],
-    plugins: [...config.plugins ?? [], ...defaultConfig.plugins ?? []],
+    plugins: [
+      ...config.plugins ?? [],
+      ...defaultConfig.plugins ?? []
+    ],
     sourceMap: {
       ...defaultConfig.sourceMap,
       ...config.sourceMap
@@ -3201,10 +3235,22 @@ var init_CommandRegistrar = __esm({
        * Registers loaded commands.
        */
       async register() {
+        const commands = this.getCommandsData();
+        let preRegistrationPrevented = false;
+        const preRegisterEvent = {
+          preventDefault() {
+            preRegistrationPrevented = true;
+          },
+          commands
+        };
+        await this.commandkit.plugins.execute(async (ctx, plugin) => {
+          if (preRegistrationPrevented) return;
+          return plugin.onBeforeRegisterCommands(ctx, preRegisterEvent);
+        });
+        if (preRegistrationPrevented) return;
         if (!this.commandkit.client.isReady()) {
           throw new Error("Cannot register commands before the client is ready");
         }
-        const commands = this.getCommandsData();
         const guildCommands = commands.filter((command) => {
           var _a;
           return (_a = command.guilds) == null ? void 0 : _a.filter(Boolean).length;
@@ -3229,6 +3275,17 @@ var init_CommandRegistrar = __esm({
        */
       async updateGlobalCommands(commands) {
         if (!commands.length) return;
+        let prevented = false;
+        const preRegisterEvent = {
+          preventDefault() {
+            prevented = true;
+          },
+          commands
+        };
+        await this.commandkit.plugins.execute(async (ctx, plugin) => {
+          if (prevented) return;
+          return plugin.onBeforeRegisterGlobalCommands(ctx, preRegisterEvent);
+        });
         try {
           const data = await this.api.put(
             import_discord14.Routes.applicationCommands(this.commandkit.client.user.id),
@@ -3250,6 +3307,22 @@ var init_CommandRegistrar = __esm({
        * Updates the guild commands.
        */
       async updateGuildCommands(commands) {
+        if (!commands.length) return;
+        let prevented = false;
+        const preRegisterEvent = {
+          preventDefault() {
+            prevented = true;
+          },
+          commands
+        };
+        await this.commandkit.plugins.execute(async (ctx, plugin) => {
+          if (prevented) return;
+          return plugin.onBeforePrepareGuildCommandsRegistration(
+            ctx,
+            preRegisterEvent
+          );
+        });
+        if (prevented) return;
         try {
           const guildCommandsMap = /* @__PURE__ */ new Map();
           commands.forEach((command) => {
@@ -3265,6 +3338,18 @@ var init_CommandRegistrar = __esm({
           if (!guildCommandsMap.size) return;
           let count = 0;
           for (const [guild, guildCommands] of guildCommandsMap) {
+            let prevented2 = false;
+            const preRegisterEvent2 = {
+              preventDefault() {
+                prevented2 = true;
+              },
+              commands: guildCommands
+            };
+            await this.commandkit.plugins.execute(async (ctx, plugin) => {
+              if (prevented2) return;
+              return plugin.onBeforeRegisterGuildCommands(ctx, preRegisterEvent2);
+            });
+            if (prevented2) continue;
             const data = await this.api.put(
               import_discord14.Routes.applicationGuildCommands(
                 this.commandkit.client.user.id,
@@ -5330,7 +5415,7 @@ var init_CommandKit = __esm({
             return (_a = plugin.onBeforeClientLogin) == null ? void 0 : _a.call(plugin, ctx);
           });
           await this.options.client.login(
-            token ?? process.env.TOKEN ?? process.env.DISCORD_TOKEN
+            token ?? this.options.client.token ?? process.env.TOKEN ?? process.env.DISCORD_TOKEN
           );
           await this.plugins.execute((ctx, plugin) => {
             var _a;
@@ -5346,7 +5431,7 @@ var init_CommandKit = __esm({
        */
       async loadPlugins() {
         const config = await loadConfigFile();
-        const plugins = config.plugins.filter((p) => isRuntimePlugin(p));
+        const plugins = config.plugins.flat(2).filter((p) => isRuntimePlugin(p));
         if (!plugins.length) return;
         for (const plugin of plugins) {
           await this.plugins.softRegisterPlugin(plugin);
@@ -5510,7 +5595,7 @@ var init_version = __esm({
     "use strict";
     init_cjs_shims();
     version = /* @__MACRO__ $version */
-    "0.1.11-dev.20250404110151";
+    "0.1.11-dev.20250405091951";
   }
 });
 
@@ -5861,7 +5946,7 @@ async function buildAndStart(configPath, skipStart = false) {
   await buildApplication({
     configPath,
     isDev: true,
-    plugins: config.plugins.filter((p) => isCompilerPlugin(p)),
+    plugins: config.plugins.flat(2).filter((p) => isCompilerPlugin(p)),
     esbuildPlugins: config.esbuildPlugins
   });
   if (skipStart) return null;
@@ -6389,6 +6474,7 @@ __export(index_exports, {
   CommandKitEnvironment: () => CommandKitEnvironment,
   CommandKitEnvironmentType: () => CommandKitEnvironmentType,
   CommandKitPluginRuntime: () => CommandKitPluginRuntime,
+  CommandRegistrar: () => CommandRegistrar,
   CommandsRouter: () => CommandsRouter,
   CompilerPlugin: () => CompilerPlugin,
   CompilerPluginRuntime: () => CompilerPluginRuntime,
@@ -6473,6 +6559,7 @@ init_AppCommandHandler();
 init_Context();
 init_MessageCommandParser();
 init_signals();
+init_CommandRegistrar();
 
 // src/app/commands/helpers.ts
 init_cjs_shims();
@@ -6574,6 +6661,7 @@ var index_default = CommandKit;
   CommandKitEnvironment,
   CommandKitEnvironmentType,
   CommandKitPluginRuntime,
+  CommandRegistrar,
   CommandsRouter,
   CompilerPlugin,
   CompilerPluginRuntime,