commandkit 0.1.10-dev.20231229094034 → 0.1.10-dev.20240108063947

package/dist/index.d.mts

@@ -1,50 +1,75 @@
-import { Client, ChatInputCommandInteraction, ContextMenuCommandInteraction, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, AutocompleteInteraction, PermissionsString, RESTPostAPIApplicationCommandsJSONBody, ButtonInteraction, Awaitable, Message, InteractionCollectorOptions, ButtonBuilder } from 'discord.js';
+import * as discord_js from 'discord.js';
+import { ChatInputCommandInteraction, ContextMenuCommandInteraction, AutocompleteInteraction, Client, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, PermissionsString, RESTPostAPIApplicationCommandsJSONBody, CacheType, Interaction, ButtonInteraction, Awaitable, Message, InteractionCollectorOptions, ButtonBuilder, PartialTextBasedChannelFields, TextBasedChannel, Guild, GuildMember, APIInteractionGuildMember, User } from 'discord.js';
+import { AsyncLocalStorage } from 'async_hooks';
 
 /**
- * Options for instantiating a CommandKit handler.
+ * Validation handler options (validationsPath).
  */
-interface CommandKitOptions {
+interface ValidationHandlerOptions {
+    validationsPath: string;
+}
+
+/**
+ * A handler for command validations.
+ */
+declare class ValidationHandler {
+    #private;
+    constructor({ ...options }: ValidationHandlerOptions);
+    init(): Promise<void>;
+    get validations(): Function[];
+    reloadValidations(): Promise<void>;
+}
+
+/**
+ * Command handler options.
+ * Similar to CommandKit options in structure.
+ */
+interface CommandHandlerOptions {
     /**
-     * The Discord.js client object to use with CommandKit.
+     * The client created by the user.
      */
     client: Client;
     /**
-     * The path to your commands directory.
+     * Path to the user's commands.
      */
-    commandsPath?: string;
+    commandsPath: string;
     /**
-     * The path to your events directory.
+     * An array of developer guild IDs.
      */
-    eventsPath?: string;
+    devGuildIds: string[];
     /**
-     * The path to the validations directory.
+     * An array of developer user IDs.
      */
-    validationsPath?: string;
+    devUserIds: string[];
     /**
-     * List of development guild IDs to restrict devOnly commands to.
+     * An array of developer role IDs.
      */
-    devGuildIds?: string[];
+    devRoleIds: string[];
     /**
-     * List of developer user IDs to restrict devOnly commands to.
+     * A validation handler instance to run validations before commands.
      */
-    devUserIds?: string[];
+    validationHandler?: ValidationHandler;
     /**
-     * List of developer role IDs to restrict devOnly commands to.
+     * A boolean indicating whether to skip CommandKit's built-in validations (permission checking, etc.)
      */
-    devRoleIds?: string[];
+    skipBuiltInValidations: boolean;
     /**
-     * Skip CommandKit's built-in validations (for devOnly commands).
+     * The CommandKit handler that instantiated this.
      */
-    skipBuiltInValidations?: boolean;
+    commandkitInstance: CommandKit;
     /**
-     * Bulk register application commands instead of one-by-one.
+     * A boolean indicating whether to register all commands in bulk.
      */
-    bulkRegister?: boolean;
+    bulkRegister: boolean;
+    /**
+     * Whether to enable hooks context.
+     */
+    enableHooks: boolean;
 }
 /**
- * A reload type for commands.
+ * Represents a command interaction.
  */
-type ReloadOptions = 'dev' | 'global' | ReloadType;
+type CommandKitInteraction = ChatInputCommandInteraction | ContextMenuCommandInteraction | AutocompleteInteraction;
 
 /**
  * Props for command run functions.
@@ -202,8 +227,110 @@ declare enum ReloadType {
     Global = "global"
 }
 
+interface hCommandContext {
+    interaction: CommandKitInteraction;
+    command: CommandData;
+}
+/**
+ * A handler for client application commands.
+ */
+declare class CommandHandler {
+    #private;
+    context: AsyncLocalStorage<hCommandContext> | null;
+    constructor({ ...options }: CommandHandlerOptions);
+    init(): Promise<void>;
+    handleCommands(): void;
+    get commands(): CommandFileObject[];
+    reloadCommands(type?: ReloadOptions): Promise<void>;
+}
+
+/**
+ * Options for instantiating a CommandKit handler.
+ */
+interface CommandKitOptions {
+    /**
+     * The Discord.js client object to use with CommandKit.
+     */
+    client: Client;
+    /**
+     * The path to your commands directory.
+     */
+    commandsPath?: string;
+    /**
+     * The path to your events directory.
+     */
+    eventsPath?: string;
+    /**
+     * The path to the validations directory.
+     */
+    validationsPath?: string;
+    /**
+     * List of development guild IDs to restrict devOnly commands to.
+     */
+    devGuildIds?: string[];
+    /**
+     * List of developer user IDs to restrict devOnly commands to.
+     */
+    devUserIds?: string[];
+    /**
+     * List of developer role IDs to restrict devOnly commands to.
+     */
+    devRoleIds?: string[];
+    /**
+     * Skip CommandKit's built-in validations (for devOnly commands).
+     */
+    skipBuiltInValidations?: boolean;
+    /**
+     * Bulk register application commands instead of one-by-one.
+     */
+    bulkRegister?: boolean;
+    /**
+     * Options for experimental features.
+     */
+    experimental?: {
+        /**
+         * Enable hooks. This allows you to utilize hooks such as `useInteraction()` to access the interaction object anywhere inside the command.
+         */
+        hooks?: boolean;
+    };
+}
+/**
+ * Represents a command context.
+ */
+interface CommandContext<T extends Interaction, Cached extends CacheType> {
+    /**
+     * The interaction that triggered this command.
+     */
+    interaction: Interaction<CacheType>;
+    /**
+     * The client that instantiated this command.
+     */
+    client: Client;
+    /**
+     * The command data.
+     */
+    handler: CommandKit;
+}
+/**
+ * Represents a command file.
+ */
+interface CommandFileObject {
+    data: CommandData;
+    options?: CommandOptions;
+    run: <Cached extends CacheType = CacheType>(ctx: CommandContext<Interaction, Cached>) => Awaited<void>;
+    autocomplete?: <Cached extends CacheType = CacheType>(ctx: CommandContext<Interaction, Cached>) => Awaited<void>;
+    filePath: string;
+    category: string | null;
+    [key: string]: any;
+}
+/**
+ * A reload type for commands.
+ */
+type ReloadOptions = 'dev' | 'global' | ReloadType;
+
 declare class CommandKit {
     #private;
+    static _instance: CommandKit | null;
     /**
      * Create a new command and event handler with CommandKit.
      *
@@ -211,6 +338,14 @@ declare class CommandKit {
      * @see {@link https://commandkit.js.org/docs/commandkit-setup}
      */
     constructor(options: CommandKitOptions);
+    /**
+     * Get the client attached to this CommandKit instance.
+     */
+    get client(): discord_js.Client<boolean>;
+    /**
+     * Get command handler instance.
+     */
+    get commandHandler(): CommandHandler | undefined;
     /**
      * Updates application commands with the latest from "commandsPath".
      */
@@ -376,4 +511,24 @@ declare function createSignal<T = unknown>(value?: CommandKitSignalInitializer<T
  */
 declare function createEffect(callback: CommandKitEffectCallback): void;
 
-export { AutocompleteProps, ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitButtonBuilderOnEnd, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, ContextMenuCommandProps, MessageContextMenuCommandProps, ReloadType, SlashCommandProps, UserContextMenuCommandProps, ValidationProps, createEffect, createSignal, defineConfig, getConfig };
+declare function useClient(): discord_js.Client<boolean>;
+
+declare function useCommandKit(): CommandKit;
+
+type ChatInputReplyData = Parameters<ChatInputCommandInteraction['reply']>[0];
+type MessageData = Parameters<PartialTextBasedChannelFields['send']>[0] | ChatInputReplyData;
+declare function response(data: MessageData): Promise<void>;
+
+declare function useChannel(): TextBasedChannel | null;
+
+declare function useCommandData(): discord_js.RESTPostAPIApplicationCommandsJSONBody;
+
+declare function useGuild(): Guild | null;
+
+declare function useInteraction<T extends CommandKitInteraction = CommandKitInteraction>(): T;
+
+declare function useMember(): GuildMember | APIInteractionGuildMember | null;
+
+declare function useUser(): User;
+
+export { AutocompleteProps, ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitButtonBuilderOnEnd, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, ContextMenuCommandProps, MessageContextMenuCommandProps, ReloadType, SlashCommandProps, UserContextMenuCommandProps, ValidationProps, createEffect, createSignal, defineConfig, getConfig, response, useChannel, useClient, useCommandData, useCommandKit, useGuild, useInteraction, useMember, useUser };

package/dist/index.d.ts

@@ -1,50 +1,75 @@
-import { Client, ChatInputCommandInteraction, ContextMenuCommandInteraction, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, AutocompleteInteraction, PermissionsString, RESTPostAPIApplicationCommandsJSONBody, ButtonInteraction, Awaitable, Message, InteractionCollectorOptions, ButtonBuilder } from 'discord.js';
+import * as discord_js from 'discord.js';
+import { ChatInputCommandInteraction, ContextMenuCommandInteraction, AutocompleteInteraction, Client, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, PermissionsString, RESTPostAPIApplicationCommandsJSONBody, CacheType, Interaction, ButtonInteraction, Awaitable, Message, InteractionCollectorOptions, ButtonBuilder, PartialTextBasedChannelFields, TextBasedChannel, Guild, GuildMember, APIInteractionGuildMember, User } from 'discord.js';
+import { AsyncLocalStorage } from 'async_hooks';
 
 /**
- * Options for instantiating a CommandKit handler.
+ * Validation handler options (validationsPath).
  */
-interface CommandKitOptions {
+interface ValidationHandlerOptions {
+    validationsPath: string;
+}
+
+/**
+ * A handler for command validations.
+ */
+declare class ValidationHandler {
+    #private;
+    constructor({ ...options }: ValidationHandlerOptions);
+    init(): Promise<void>;
+    get validations(): Function[];
+    reloadValidations(): Promise<void>;
+}
+
+/**
+ * Command handler options.
+ * Similar to CommandKit options in structure.
+ */
+interface CommandHandlerOptions {
     /**
-     * The Discord.js client object to use with CommandKit.
+     * The client created by the user.
      */
     client: Client;
     /**
-     * The path to your commands directory.
+     * Path to the user's commands.
      */
-    commandsPath?: string;
+    commandsPath: string;
     /**
-     * The path to your events directory.
+     * An array of developer guild IDs.
      */
-    eventsPath?: string;
+    devGuildIds: string[];
     /**
-     * The path to the validations directory.
+     * An array of developer user IDs.
      */
-    validationsPath?: string;
+    devUserIds: string[];
     /**
-     * List of development guild IDs to restrict devOnly commands to.
+     * An array of developer role IDs.
      */
-    devGuildIds?: string[];
+    devRoleIds: string[];
     /**
-     * List of developer user IDs to restrict devOnly commands to.
+     * A validation handler instance to run validations before commands.
      */
-    devUserIds?: string[];
+    validationHandler?: ValidationHandler;
     /**
-     * List of developer role IDs to restrict devOnly commands to.
+     * A boolean indicating whether to skip CommandKit's built-in validations (permission checking, etc.)
      */
-    devRoleIds?: string[];
+    skipBuiltInValidations: boolean;
     /**
-     * Skip CommandKit's built-in validations (for devOnly commands).
+     * The CommandKit handler that instantiated this.
      */
-    skipBuiltInValidations?: boolean;
+    commandkitInstance: CommandKit;
     /**
-     * Bulk register application commands instead of one-by-one.
+     * A boolean indicating whether to register all commands in bulk.
      */
-    bulkRegister?: boolean;
+    bulkRegister: boolean;
+    /**
+     * Whether to enable hooks context.
+     */
+    enableHooks: boolean;
 }
 /**
- * A reload type for commands.
+ * Represents a command interaction.
  */
-type ReloadOptions = 'dev' | 'global' | ReloadType;
+type CommandKitInteraction = ChatInputCommandInteraction | ContextMenuCommandInteraction | AutocompleteInteraction;
 
 /**
  * Props for command run functions.
@@ -202,8 +227,110 @@ declare enum ReloadType {
     Global = "global"
 }
 
+interface hCommandContext {
+    interaction: CommandKitInteraction;
+    command: CommandData;
+}
+/**
+ * A handler for client application commands.
+ */
+declare class CommandHandler {
+    #private;
+    context: AsyncLocalStorage<hCommandContext> | null;
+    constructor({ ...options }: CommandHandlerOptions);
+    init(): Promise<void>;
+    handleCommands(): void;
+    get commands(): CommandFileObject[];
+    reloadCommands(type?: ReloadOptions): Promise<void>;
+}
+
+/**
+ * Options for instantiating a CommandKit handler.
+ */
+interface CommandKitOptions {
+    /**
+     * The Discord.js client object to use with CommandKit.
+     */
+    client: Client;
+    /**
+     * The path to your commands directory.
+     */
+    commandsPath?: string;
+    /**
+     * The path to your events directory.
+     */
+    eventsPath?: string;
+    /**
+     * The path to the validations directory.
+     */
+    validationsPath?: string;
+    /**
+     * List of development guild IDs to restrict devOnly commands to.
+     */
+    devGuildIds?: string[];
+    /**
+     * List of developer user IDs to restrict devOnly commands to.
+     */
+    devUserIds?: string[];
+    /**
+     * List of developer role IDs to restrict devOnly commands to.
+     */
+    devRoleIds?: string[];
+    /**
+     * Skip CommandKit's built-in validations (for devOnly commands).
+     */
+    skipBuiltInValidations?: boolean;
+    /**
+     * Bulk register application commands instead of one-by-one.
+     */
+    bulkRegister?: boolean;
+    /**
+     * Options for experimental features.
+     */
+    experimental?: {
+        /**
+         * Enable hooks. This allows you to utilize hooks such as `useInteraction()` to access the interaction object anywhere inside the command.
+         */
+        hooks?: boolean;
+    };
+}
+/**
+ * Represents a command context.
+ */
+interface CommandContext<T extends Interaction, Cached extends CacheType> {
+    /**
+     * The interaction that triggered this command.
+     */
+    interaction: Interaction<CacheType>;
+    /**
+     * The client that instantiated this command.
+     */
+    client: Client;
+    /**
+     * The command data.
+     */
+    handler: CommandKit;
+}
+/**
+ * Represents a command file.
+ */
+interface CommandFileObject {
+    data: CommandData;
+    options?: CommandOptions;
+    run: <Cached extends CacheType = CacheType>(ctx: CommandContext<Interaction, Cached>) => Awaited<void>;
+    autocomplete?: <Cached extends CacheType = CacheType>(ctx: CommandContext<Interaction, Cached>) => Awaited<void>;
+    filePath: string;
+    category: string | null;
+    [key: string]: any;
+}
+/**
+ * A reload type for commands.
+ */
+type ReloadOptions = 'dev' | 'global' | ReloadType;
+
 declare class CommandKit {
     #private;
+    static _instance: CommandKit | null;
     /**
      * Create a new command and event handler with CommandKit.
      *
@@ -211,6 +338,14 @@ declare class CommandKit {
      * @see {@link https://commandkit.js.org/docs/commandkit-setup}
      */
     constructor(options: CommandKitOptions);
+    /**
+     * Get the client attached to this CommandKit instance.
+     */
+    get client(): discord_js.Client<boolean>;
+    /**
+     * Get command handler instance.
+     */
+    get commandHandler(): CommandHandler | undefined;
     /**
      * Updates application commands with the latest from "commandsPath".
      */
@@ -376,4 +511,24 @@ declare function createSignal<T = unknown>(value?: CommandKitSignalInitializer<T
  */
 declare function createEffect(callback: CommandKitEffectCallback): void;
 
-export { AutocompleteProps, ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitButtonBuilderOnEnd, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, ContextMenuCommandProps, MessageContextMenuCommandProps, ReloadType, SlashCommandProps, UserContextMenuCommandProps, ValidationProps, createEffect, createSignal, defineConfig, getConfig };
+declare function useClient(): discord_js.Client<boolean>;
+
+declare function useCommandKit(): CommandKit;
+
+type ChatInputReplyData = Parameters<ChatInputCommandInteraction['reply']>[0];
+type MessageData = Parameters<PartialTextBasedChannelFields['send']>[0] | ChatInputReplyData;
+declare function response(data: MessageData): Promise<void>;
+
+declare function useChannel(): TextBasedChannel | null;
+
+declare function useCommandData(): discord_js.RESTPostAPIApplicationCommandsJSONBody;
+
+declare function useGuild(): Guild | null;
+
+declare function useInteraction<T extends CommandKitInteraction = CommandKitInteraction>(): T;
+
+declare function useMember(): GuildMember | APIInteractionGuildMember | null;
+
+declare function useUser(): User;
+
+export { AutocompleteProps, ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitButtonBuilderOnEnd, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, ContextMenuCommandProps, MessageContextMenuCommandProps, ReloadType, SlashCommandProps, UserContextMenuCommandProps, ValidationProps, createEffect, createSignal, defineConfig, getConfig, response, useChannel, useClient, useCommandData, useCommandKit, useGuild, useInteraction, useMember, useUser };

package/dist/index.js

@@ -35,7 +35,16 @@ __export(src_exports, {
   createEffect: () => createEffect,
   createSignal: () => createSignal,
   defineConfig: () => defineConfig,
-  getConfig: () => getConfig
+  getConfig: () => getConfig,
+  response: () => response,
+  useChannel: () => useChannel,
+  useClient: () => useClient,
+  useCommandData: () => useCommandData,
+  useCommandKit: () => useCommandKit,
+  useGuild: () => useGuild,
+  useInteraction: () => useInteraction,
+  useMember: () => useMember,
+  useUser: () => useUser
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -470,8 +479,10 @@ function permissions_default({ interaction, targetCommand }) {
 var validations_default = [devOnly_default, permissions_default];
 
 // src/handlers/command-handler/CommandHandler.ts
+var import_async_hooks = require("async_hooks");
 var CommandHandler = class {
   #data;
+  context = null;
   constructor({ ...options }) {
     this.#data = {
       ...options,
@@ -480,6 +491,9 @@ var CommandHandler = class {
     };
   }
   async init() {
+    if (this.#data.enableHooks && !this.context) {
+      this.context = new import_async_hooks.AsyncLocalStorage();
+    }
     await this.#buildCommands();
     this.#buildBuiltInValidations();
     const devOnlyCommands = this.#data.commands.filter((cmd) => cmd.options?.devOnly);
@@ -579,6 +593,7 @@ var CommandHandler = class {
     }
   }
   handleCommands() {
+    const areHooksEnabled = this.#data.enableHooks;
     this.#data.client.on("interactionCreate", async (interaction) => {
       if (!interaction.isChatInputCommand() && !interaction.isContextMenuCommand() && !interaction.isAutocomplete())
         return;
@@ -591,50 +606,65 @@ var CommandHandler = class {
       const { data, options, run, autocomplete, ...rest } = targetCommand;
       if (isAutocomplete && !autocomplete)
         return;
-      const commandObj = {
-        data: targetCommand.data,
-        options: targetCommand.options,
-        ...rest
-      };
-      if (this.#data.validationHandler) {
-        let canRun2 = true;
-        for (const validationFunction of this.#data.validationHandler.validations) {
-          const stopValidationLoop = await validationFunction({
-            interaction,
-            commandObj,
-            client: this.#data.client,
-            handler: this.#data.commandkitInstance
-          });
-          if (stopValidationLoop) {
-            canRun2 = false;
-            break;
+      const executor = async () => {
+        const commandObj = {
+          data: targetCommand.data,
+          options: targetCommand.options,
+          ...rest
+        };
+        if (this.#data.validationHandler) {
+          let canRun2 = true;
+          for (const validationFunction of this.#data.validationHandler.validations) {
+            const stopValidationLoop = await validationFunction({
+              interaction,
+              commandObj,
+              client: this.#data.client,
+              handler: this.#data.commandkitInstance
+            });
+            if (stopValidationLoop) {
+              canRun2 = false;
+              break;
+            }
           }
+          if (!canRun2)
+            return;
         }
-        if (!canRun2)
+        let canRun = true;
+        if (!this.#data.skipBuiltInValidations) {
+          for (const validation of this.#data.builtInValidations) {
+            const stopValidationLoop = validation({
+              targetCommand,
+              interaction,
+              handlerData: this.#data
+            });
+            if (stopValidationLoop) {
+              canRun = false;
+              break;
+            }
+          }
+        }
+        if (!canRun)
           return;
-      }
-      let canRun = true;
-      if (!this.#data.skipBuiltInValidations) {
-        for (const validation of this.#data.builtInValidations) {
-          const stopValidationLoop = validation({
-            targetCommand,
+        const command = targetCommand[isAutocomplete ? "autocomplete" : "run"];
+        if (!areHooksEnabled) {
+          const context2 = {
             interaction,
-            handlerData: this.#data
-          });
-          if (stopValidationLoop) {
-            canRun = false;
-            break;
-          }
+            client: this.#data.client,
+            handler: this.#data.commandkitInstance
+          };
+          return await command(context2);
         }
-      }
-      if (!canRun)
-        return;
-      const context2 = {
-        interaction,
-        client: this.#data.client,
-        handler: this.#data.commandkitInstance
+        return command();
       };
-      await targetCommand[isAutocomplete ? "autocomplete" : "run"](context2);
+      if (this.context)
+        return this.context.run(
+          {
+            command: targetCommand.data,
+            interaction
+          },
+          executor
+        );
+      return executor();
     });
   }
   get commands() {
@@ -808,8 +838,9 @@ var ValidationHandler = class {
 };
 
 // src/CommandKit.ts
-var CommandKit = class {
+var CommandKit = class _CommandKit {
   #data;
+  static _instance = null;
   /**
    * Create a new command and event handler with CommandKit.
    *
@@ -826,8 +857,21 @@ var CommandKit = class {
       );
     }
     this.#data = options;
+    _CommandKit._instance = this;
     this.#init();
   }
+  /**
+   * Get the client attached to this CommandKit instance.
+   */
+  get client() {
+    return this.#data.client;
+  }
+  /**
+   * Get command handler instance.
+   */
+  get commandHandler() {
+    return this.#data.commandHandler;
+  }
   /**
    * (Private) Initialize CommandKit.
    */
@@ -858,7 +902,8 @@ var CommandKit = class {
         validationHandler: this.#data.validationHandler,
         skipBuiltInValidations: this.#data.skipBuiltInValidations || false,
         commandkitInstance: this,
-        bulkRegister: this.#data.bulkRegister || false
+        bulkRegister: this.#data.bulkRegister || false,
+        enableHooks: this.#data.experimental?.hooks ?? false
       });
       await commandHandler.init();
       this.#data.commandHandler = commandHandler;
@@ -1111,6 +1156,103 @@ function createEffect(callback) {
 function getCurrentObserver() {
   return context[context.length - 1];
 }
+
+// src/hooks/common.ts
+function getCommandKit() {
+  return CommandKit._instance;
+}
+function getCommandHandler() {
+  const handler = getCommandKit()?.commandHandler;
+  if (!handler) {
+    throw new Error("CommandKit is not initialized.");
+  }
+  return handler;
+}
+function getContext() {
+  const info = getCommandHandler().context;
+  if (!info) {
+    throw new Error("Context is not available, did you forget to enable hooks?");
+  }
+  return info;
+}
+function prepareHookInvocationError(name) {
+  return new Error(`Cannot invoke hook "${name}" outside of a command.`);
+}
+
+// src/hooks/useCommandKit.ts
+function useCommandKit() {
+  const kit = getCommandKit();
+  if (!kit)
+    throw new Error("CommandKit is not initialized.");
+  return kit;
+}
+
+// src/hooks/useClient.ts
+function useClient() {
+  return useCommandKit().client;
+}
+
+// src/hooks/useInteraction.ts
+function useInteraction() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useInteraction");
+  return data.interaction;
+}
+
+// src/hooks/response.ts
+async function response(data) {
+  const interaction = useInteraction();
+  if (interaction.isAutocomplete())
+    return;
+  if (interaction.replied || interaction.deferred) {
+    await interaction.editReply(data);
+  } else if (interaction.isMessageComponent()) {
+    await interaction.update(data);
+  } else {
+    await interaction.reply(data);
+  }
+}
+
+// src/hooks/useChannel.ts
+function useChannel() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useChannel");
+  return data.interaction.channel;
+}
+
+// src/hooks/useCommandData.ts
+function useCommandData() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useCommandData");
+  return data.command;
+}
+
+// src/hooks/useGuild.ts
+function useGuild() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useGuild");
+  return data.interaction.guild;
+}
+
+// src/hooks/useMember.ts
+function useMember() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useMember");
+  return data.interaction.member;
+}
+
+// src/hooks/useUser.ts
+function useUser() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useUser");
+  return data.interaction.user;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ButtonKit,
@@ -1118,5 +1260,14 @@ function getCurrentObserver() {
   createEffect,
   createSignal,
   defineConfig,
-  getConfig
+  getConfig,
+  response,
+  useChannel,
+  useClient,
+  useCommandData,
+  useCommandKit,
+  useGuild,
+  useInteraction,
+  useMember,
+  useUser
 });

package/dist/index.mjs

@@ -437,8 +437,10 @@ function permissions_default({ interaction, targetCommand }) {
 var validations_default = [devOnly_default, permissions_default];
 
 // src/handlers/command-handler/CommandHandler.ts
+import { AsyncLocalStorage } from "async_hooks";
 var CommandHandler = class {
   #data;
+  context = null;
   constructor({ ...options }) {
     this.#data = {
       ...options,
@@ -447,6 +449,9 @@ var CommandHandler = class {
     };
   }
   async init() {
+    if (this.#data.enableHooks && !this.context) {
+      this.context = new AsyncLocalStorage();
+    }
     await this.#buildCommands();
     this.#buildBuiltInValidations();
     const devOnlyCommands = this.#data.commands.filter((cmd) => cmd.options?.devOnly);
@@ -546,6 +551,7 @@ var CommandHandler = class {
     }
   }
   handleCommands() {
+    const areHooksEnabled = this.#data.enableHooks;
     this.#data.client.on("interactionCreate", async (interaction) => {
       if (!interaction.isChatInputCommand() && !interaction.isContextMenuCommand() && !interaction.isAutocomplete())
         return;
@@ -558,50 +564,65 @@ var CommandHandler = class {
       const { data, options, run, autocomplete, ...rest } = targetCommand;
       if (isAutocomplete && !autocomplete)
         return;
-      const commandObj = {
-        data: targetCommand.data,
-        options: targetCommand.options,
-        ...rest
-      };
-      if (this.#data.validationHandler) {
-        let canRun2 = true;
-        for (const validationFunction of this.#data.validationHandler.validations) {
-          const stopValidationLoop = await validationFunction({
-            interaction,
-            commandObj,
-            client: this.#data.client,
-            handler: this.#data.commandkitInstance
-          });
-          if (stopValidationLoop) {
-            canRun2 = false;
-            break;
+      const executor = async () => {
+        const commandObj = {
+          data: targetCommand.data,
+          options: targetCommand.options,
+          ...rest
+        };
+        if (this.#data.validationHandler) {
+          let canRun2 = true;
+          for (const validationFunction of this.#data.validationHandler.validations) {
+            const stopValidationLoop = await validationFunction({
+              interaction,
+              commandObj,
+              client: this.#data.client,
+              handler: this.#data.commandkitInstance
+            });
+            if (stopValidationLoop) {
+              canRun2 = false;
+              break;
+            }
           }
+          if (!canRun2)
+            return;
         }
-        if (!canRun2)
+        let canRun = true;
+        if (!this.#data.skipBuiltInValidations) {
+          for (const validation of this.#data.builtInValidations) {
+            const stopValidationLoop = validation({
+              targetCommand,
+              interaction,
+              handlerData: this.#data
+            });
+            if (stopValidationLoop) {
+              canRun = false;
+              break;
+            }
+          }
+        }
+        if (!canRun)
           return;
-      }
-      let canRun = true;
-      if (!this.#data.skipBuiltInValidations) {
-        for (const validation of this.#data.builtInValidations) {
-          const stopValidationLoop = validation({
-            targetCommand,
+        const command = targetCommand[isAutocomplete ? "autocomplete" : "run"];
+        if (!areHooksEnabled) {
+          const context2 = {
             interaction,
-            handlerData: this.#data
-          });
-          if (stopValidationLoop) {
-            canRun = false;
-            break;
-          }
+            client: this.#data.client,
+            handler: this.#data.commandkitInstance
+          };
+          return await command(context2);
         }
-      }
-      if (!canRun)
-        return;
-      const context2 = {
-        interaction,
-        client: this.#data.client,
-        handler: this.#data.commandkitInstance
+        return command();
       };
-      await targetCommand[isAutocomplete ? "autocomplete" : "run"](context2);
+      if (this.context)
+        return this.context.run(
+          {
+            command: targetCommand.data,
+            interaction
+          },
+          executor
+        );
+      return executor();
     });
   }
   get commands() {
@@ -775,8 +796,9 @@ var ValidationHandler = class {
 };
 
 // src/CommandKit.ts
-var CommandKit = class {
+var CommandKit = class _CommandKit {
   #data;
+  static _instance = null;
   /**
    * Create a new command and event handler with CommandKit.
    *
@@ -793,8 +815,21 @@ var CommandKit = class {
       );
     }
     this.#data = options;
+    _CommandKit._instance = this;
     this.#init();
   }
+  /**
+   * Get the client attached to this CommandKit instance.
+   */
+  get client() {
+    return this.#data.client;
+  }
+  /**
+   * Get command handler instance.
+   */
+  get commandHandler() {
+    return this.#data.commandHandler;
+  }
   /**
    * (Private) Initialize CommandKit.
    */
@@ -825,7 +860,8 @@ var CommandKit = class {
         validationHandler: this.#data.validationHandler,
         skipBuiltInValidations: this.#data.skipBuiltInValidations || false,
         commandkitInstance: this,
-        bulkRegister: this.#data.bulkRegister || false
+        bulkRegister: this.#data.bulkRegister || false,
+        enableHooks: this.#data.experimental?.hooks ?? false
       });
       await commandHandler.init();
       this.#data.commandHandler = commandHandler;
@@ -1082,11 +1118,117 @@ function createEffect(callback) {
 function getCurrentObserver() {
   return context[context.length - 1];
 }
+
+// src/hooks/common.ts
+function getCommandKit() {
+  return CommandKit._instance;
+}
+function getCommandHandler() {
+  const handler = getCommandKit()?.commandHandler;
+  if (!handler) {
+    throw new Error("CommandKit is not initialized.");
+  }
+  return handler;
+}
+function getContext() {
+  const info = getCommandHandler().context;
+  if (!info) {
+    throw new Error("Context is not available, did you forget to enable hooks?");
+  }
+  return info;
+}
+function prepareHookInvocationError(name) {
+  return new Error(`Cannot invoke hook "${name}" outside of a command.`);
+}
+
+// src/hooks/useCommandKit.ts
+function useCommandKit() {
+  const kit = getCommandKit();
+  if (!kit)
+    throw new Error("CommandKit is not initialized.");
+  return kit;
+}
+
+// src/hooks/useClient.ts
+function useClient() {
+  return useCommandKit().client;
+}
+
+// src/hooks/useInteraction.ts
+function useInteraction() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useInteraction");
+  return data.interaction;
+}
+
+// src/hooks/response.ts
+async function response(data) {
+  const interaction = useInteraction();
+  if (interaction.isAutocomplete())
+    return;
+  if (interaction.replied || interaction.deferred) {
+    await interaction.editReply(data);
+  } else if (interaction.isMessageComponent()) {
+    await interaction.update(data);
+  } else {
+    await interaction.reply(data);
+  }
+}
+
+// src/hooks/useChannel.ts
+function useChannel() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useChannel");
+  return data.interaction.channel;
+}
+
+// src/hooks/useCommandData.ts
+function useCommandData() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useCommandData");
+  return data.command;
+}
+
+// src/hooks/useGuild.ts
+function useGuild() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useGuild");
+  return data.interaction.guild;
+}
+
+// src/hooks/useMember.ts
+function useMember() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useMember");
+  return data.interaction.member;
+}
+
+// src/hooks/useUser.ts
+function useUser() {
+  const data = getContext().getStore();
+  if (!data)
+    throw prepareHookInvocationError("useUser");
+  return data.interaction.user;
+}
 export {
   ButtonKit,
   CommandKit,
   createEffect,
   createSignal,
   defineConfig,
-  getConfig
+  getConfig,
+  response,
+  useChannel,
+  useClient,
+  useCommandData,
+  useCommandKit,
+  useGuild,
+  useInteraction,
+  useMember,
+  useUser
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "commandkit",
   "description": "Beginner friendly command & event handler for Discord.js",
-  "version": "0.1.10-dev.20231229094034",
+  "version": "0.1.10-dev.20240108063947",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",