commandkit 0.1.6-dev.20231124165615 → 0.1.6-dev.20231124182258

package/dist/index.d.mts

@@ -1,202 +1,169 @@
-import { CommandInteraction, Client, ChatInputCommandInteraction, ContextMenuCommandInteraction, PermissionsString, APIApplicationCommandOption, ButtonInteraction, Awaitable, Message, InteractionCollectorOptions, ButtonBuilder } from 'discord.js';
+import { Client, ChatInputCommandInteraction, ContextMenuCommandInteraction, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, PermissionsString, RESTPostAPIApplicationCommandsJSONBody, ButtonInteraction, Awaitable, Message, InteractionCollectorOptions, ButtonBuilder } from 'discord.js';
 
 /**
- * Base props for commands.
+ * Options for instantiating a CommandKit handler.
  */
-interface CommandProps {
+interface CommandKitOptions {
     /**
-     * Represents the command's interaction.
+     * The Discord.js client object to use with CommandKit.
      */
-    interaction: CommandInteraction;
+    client: Client;
     /**
-     * The client created in your main file.
+     * The path to your commands directory.
      */
-    client: Client<true>;
+    commandsPath?: string;
     /**
-     * The main CommandKit handler that instantiated this.
+     * The path to your events directory.
      */
-    handler: CommandKit;
+    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;
 }
 /**
- * Props for slash command run functions.
+ * A reload type for commands.
  */
-interface SlashCommandProps {
+type ReloadOptions = 'dev' | 'global' | ReloadType;
+
+/**
+ * Props for command run functions.
+ */
+interface CommandProps {
     /**
-     * Represents the command's interaction.
+     * The current command interaction object.
      */
-    interaction: ChatInputCommandInteraction;
+    interaction: ChatInputCommandInteraction | ContextMenuCommandInteraction | UserContextMenuCommandInteraction | MessageContextMenuCommandInteraction;
     /**
-     * The client created in your main file.
+     * The Discord.js client object that CommandKit is handling.
      */
     client: Client<true>;
     /**
-     * The CommandKit handler that instantiated this.
+     * The current CommandKit handler instance.
      */
     handler: CommandKit;
 }
 /**
- * Props for context menu command run functions.
+ * Props for slash (chat input) command run functions.
  */
-interface ContextMenuCommandProps {
+interface SlashCommandProps extends CommandProps {
     /**
-     * Represents the command's interaction.
+     * The current slash (chat input) command interaction object.
      */
-    interaction: ContextMenuCommandInteraction;
-    /**
-     * The client created in your main file.
-     */
-    client: Client<true>;
+    interaction: ChatInputCommandInteraction;
+}
+/**
+ * Props for context menu command run functions.
+ */
+interface ContextMenuCommandProps extends CommandProps {
     /**
-     * The CommandKit handler that instantiated this.
+     * The current context menu command interaction object.
      */
-    handler: CommandKit;
+    interaction: ContextMenuCommandInteraction;
+}
+/**
+ * Props for user context menu command run functions.
+ */
+interface UserContextMenuCommandProps extends CommandProps {
+    interaction: UserContextMenuCommandInteraction;
 }
 /**
- * Props for command validations.
+ * Props for message context menu command run functions.
+ */
+interface MessageContextMenuCommandProps extends CommandProps {
+    interaction: MessageContextMenuCommandInteraction;
+}
+/**
+ * Props for command validation functions.
  */
 interface ValidationFunctionProps {
     /**
-     * Represents the command's interaction.
-     * Either a slash command or a context menu command interaction.
+     * The current command interaction object.
      */
     interaction: ChatInputCommandInteraction | ContextMenuCommandInteraction;
     /**
-     * The client created in your main file.
-     * Represented as a ready client (`Client<true>`).
+     * The Discord.js client object that CommandKit is handling.
      */
     client: Client<true>;
     /**
-     * The command object that is being validated.
+     * The current (local) target command object.
      */
     commandObj: CommandObject;
     /**
-     * The CommandKit handler that instantiated this.
+     * The current CommandKit handler instance.
      */
     handler: CommandKit;
 }
 /**
- * Configuration for commands.
+ * Additional command configuration options.
  */
 interface CommandOptions {
     /**
-     * Boolean indicating whether the command is guild-only.
-     * @deprecated - Use `dm_permission` in the command's data instead.
+     * A boolean indicating whether the command is guild-only.
+     * Used for built-in validation.
+     *
+     * @deprecated Use `dm_permission` in the command's `data` object instead.
      */
     guildOnly?: boolean;
     /**
-     * Boolean indicating whether the command is developer only.
+     * A boolean indicating whether the command is developer-only.
+     * Used for registration and built-in validation.
      */
     devOnly?: boolean;
     /**
-     * Boolean indicating whether the command is deleted and should not be registered.
+     * A boolean indicating whether the command is deleted/ignored on restart/reload.
      */
     deleted?: boolean;
     /**
-     * An array of user permissions.
+     * A string or array of permissions that a user needs for the current command to be executed.
+     * Used for built-in validation.
      *
      * @example
-     * userPermissions: ['BanMembers']
+     * userPermissions: 'BanMembers'
+     * or
+     * userPermissions: ['BanMembers', 'KickMembers']
      */
-    userPermissions?: PermissionsString[];
+    userPermissions?: PermissionsString | PermissionsString[];
     /**
-     * An array of bot permissions.
+     * A string or array of permissions that the bot needs to execute the current command.
+     * Used for built-in validation.
      *
      * @example
-     * botPermissions: ['BanMembers']
+     * botPermissions: 'BanMembers'
+     * or
+     * botPermissions: ['BanMembers', 'KickMembers']
      */
-    botPermissions?: PermissionsString[];
+    botPermissions?: PermissionsString | PermissionsString[];
     [key: string]: any;
 }
-declare enum CommandType {
-    /**
-     * Slash commands.
-     */
-    'ChatInput' = 1,
-    /**
-     * Message context menu commands.
-     */
-    'Message' = 3,
-    /**
-     * User context menu commands.
-     */
-    'User' = 2
-}
-type LocaleString = 'id' | `en-${'GB' | 'US'}` | 'bg' | `zh-${'CN' | 'TW'}` | 'hr' | 'cs' | 'da' | 'nl' | 'fi' | 'fr' | 'de' | 'el' | 'hi' | 'hu' | 'it' | 'ja' | 'ko' | 'lt' | 'no' | 'pl' | 'pt-BR' | 'ro' | 'ru' | 'es-ES' | 'sv-SE' | 'th' | 'tr' | 'uk' | 'vi';
-/**
- * Common items for command data.
- */
-type BaseCommandData = {
-    /**
-     * The name of the command.
-     */
-    name: string;
-    /**
-     * The type of the command.
-     */
-    type?: CommandType;
-    /**
-     * i18n for the command name.
-     */
-    name_localizations?: Partial<Record<LocaleString, string | null>>;
-    /**
-     * Whether to allow this command in DMs.
-     */
-    dm_permission?: boolean;
-    /**
-     * Default permissions for members for the command.
-     */
-    default_member_permissions?: string;
-    /**
-     * Whether the command is age-restricted.
-     */
-    nsfw?: boolean;
-};
-/**
- * Data for chat input commands.
- */
-type ChatInputCommandData = BaseCommandData & {
-    /**
-     * The command's type.
-     */
-    type?: CommandType.ChatInput;
-    /**
-     * The description of the command.
-     */
-    description: string;
-    /**
-     * i18n for the command description.
-     */
-    description_localizations?: Partial<Record<LocaleString, string | null>>;
-    /**
-     * Chat input command options.
-     */
-    options?: Array<APIApplicationCommandOption>;
-};
-/**
- * Represents any context menu command data.
- */
-type UserOrMessageCommandData = BaseCommandData & {
-    type: CommandType.User | CommandType.Message;
-};
-type CommandData = ChatInputCommandData | UserOrMessageCommandData;
+type CommandData = RESTPostAPIApplicationCommandsJSONBody;
 type CommandObject = {
     /**
-     * Command data which is a slash command builder or raw JSON data.
-     * @example
-     * {
-     *      name: 'ping',
-     *      description: 'Replies with Pong!'
-     * }
+     * An object which defines the structure of the application command.
      */
     data: CommandData;
     /**
-     * CommandKit command options.
-     * @example
-     * {
-     *      devOnly: true,
-     *      userPermissions: ['ManageGuild'],
-     *      botPermissions: ['ManageGuild'],
-     * }
+     * Additional command configuration options.
      */
     options?: CommandOptions;
     /**
@@ -204,7 +171,13 @@ type CommandObject = {
      */
     filePath: string;
     /**
-     * The command's category.
+     * The command's category. Determined based on the command folder.
+     *
+     * @example
+     * ```txt
+     * "/src/commands/ping.js" -> null
+     * "/src/commands/Misc/ping.js" -> "Misc"
+     * ```
      */
     category: string | null;
     [key: string]: any;
@@ -220,57 +193,12 @@ declare enum ReloadType {
     Global = "global"
 }
 
-/**
- * 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;
-}
-/**
- * A reload type for commands.
- */
-type ReloadOptions = 'dev' | 'global' | ReloadType;
-
 declare class CommandKit {
     #private;
     /**
-     * Create a new handler with CommandKit.
-     * @param options - Options to use (client, commandsPath, eventsPath, etc.)
+     * Create a new command and event handler with CommandKit.
+     *
+     * @param options - The default CommandKit configuration.
      * @see {@link https://commandkit.js.org/docs/commandkit-setup}
      */
     constructor(options: CommandKitOptions);
@@ -430,4 +358,4 @@ declare function createSignal<T = unknown>(value?: CommandKitSignalInitializer<T
  */
 declare function createEffect(callback: CommandKitEffectCallback): void;
 
-export { ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, CommandType, ContextMenuCommandProps, ReloadType, SlashCommandProps, ValidationFunctionProps, createEffect, createSignal, defineConfig, getConfig };
+export { ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, ContextMenuCommandProps, MessageContextMenuCommandProps, ReloadType, SlashCommandProps, UserContextMenuCommandProps, ValidationFunctionProps, createEffect, createSignal, defineConfig, getConfig };

package/dist/index.d.ts

@@ -1,202 +1,169 @@
-import { CommandInteraction, Client, ChatInputCommandInteraction, ContextMenuCommandInteraction, PermissionsString, APIApplicationCommandOption, ButtonInteraction, Awaitable, Message, InteractionCollectorOptions, ButtonBuilder } from 'discord.js';
+import { Client, ChatInputCommandInteraction, ContextMenuCommandInteraction, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, PermissionsString, RESTPostAPIApplicationCommandsJSONBody, ButtonInteraction, Awaitable, Message, InteractionCollectorOptions, ButtonBuilder } from 'discord.js';
 
 /**
- * Base props for commands.
+ * Options for instantiating a CommandKit handler.
  */
-interface CommandProps {
+interface CommandKitOptions {
     /**
-     * Represents the command's interaction.
+     * The Discord.js client object to use with CommandKit.
      */
-    interaction: CommandInteraction;
+    client: Client;
     /**
-     * The client created in your main file.
+     * The path to your commands directory.
      */
-    client: Client<true>;
+    commandsPath?: string;
     /**
-     * The main CommandKit handler that instantiated this.
+     * The path to your events directory.
      */
-    handler: CommandKit;
+    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;
 }
 /**
- * Props for slash command run functions.
+ * A reload type for commands.
  */
-interface SlashCommandProps {
+type ReloadOptions = 'dev' | 'global' | ReloadType;
+
+/**
+ * Props for command run functions.
+ */
+interface CommandProps {
     /**
-     * Represents the command's interaction.
+     * The current command interaction object.
      */
-    interaction: ChatInputCommandInteraction;
+    interaction: ChatInputCommandInteraction | ContextMenuCommandInteraction | UserContextMenuCommandInteraction | MessageContextMenuCommandInteraction;
     /**
-     * The client created in your main file.
+     * The Discord.js client object that CommandKit is handling.
      */
     client: Client<true>;
     /**
-     * The CommandKit handler that instantiated this.
+     * The current CommandKit handler instance.
      */
     handler: CommandKit;
 }
 /**
- * Props for context menu command run functions.
+ * Props for slash (chat input) command run functions.
  */
-interface ContextMenuCommandProps {
+interface SlashCommandProps extends CommandProps {
     /**
-     * Represents the command's interaction.
+     * The current slash (chat input) command interaction object.
      */
-    interaction: ContextMenuCommandInteraction;
-    /**
-     * The client created in your main file.
-     */
-    client: Client<true>;
+    interaction: ChatInputCommandInteraction;
+}
+/**
+ * Props for context menu command run functions.
+ */
+interface ContextMenuCommandProps extends CommandProps {
     /**
-     * The CommandKit handler that instantiated this.
+     * The current context menu command interaction object.
      */
-    handler: CommandKit;
+    interaction: ContextMenuCommandInteraction;
+}
+/**
+ * Props for user context menu command run functions.
+ */
+interface UserContextMenuCommandProps extends CommandProps {
+    interaction: UserContextMenuCommandInteraction;
 }
 /**
- * Props for command validations.
+ * Props for message context menu command run functions.
+ */
+interface MessageContextMenuCommandProps extends CommandProps {
+    interaction: MessageContextMenuCommandInteraction;
+}
+/**
+ * Props for command validation functions.
  */
 interface ValidationFunctionProps {
     /**
-     * Represents the command's interaction.
-     * Either a slash command or a context menu command interaction.
+     * The current command interaction object.
      */
     interaction: ChatInputCommandInteraction | ContextMenuCommandInteraction;
     /**
-     * The client created in your main file.
-     * Represented as a ready client (`Client<true>`).
+     * The Discord.js client object that CommandKit is handling.
      */
     client: Client<true>;
     /**
-     * The command object that is being validated.
+     * The current (local) target command object.
      */
     commandObj: CommandObject;
     /**
-     * The CommandKit handler that instantiated this.
+     * The current CommandKit handler instance.
      */
     handler: CommandKit;
 }
 /**
- * Configuration for commands.
+ * Additional command configuration options.
  */
 interface CommandOptions {
     /**
-     * Boolean indicating whether the command is guild-only.
-     * @deprecated - Use `dm_permission` in the command's data instead.
+     * A boolean indicating whether the command is guild-only.
+     * Used for built-in validation.
+     *
+     * @deprecated Use `dm_permission` in the command's `data` object instead.
      */
     guildOnly?: boolean;
     /**
-     * Boolean indicating whether the command is developer only.
+     * A boolean indicating whether the command is developer-only.
+     * Used for registration and built-in validation.
      */
     devOnly?: boolean;
     /**
-     * Boolean indicating whether the command is deleted and should not be registered.
+     * A boolean indicating whether the command is deleted/ignored on restart/reload.
      */
     deleted?: boolean;
     /**
-     * An array of user permissions.
+     * A string or array of permissions that a user needs for the current command to be executed.
+     * Used for built-in validation.
      *
      * @example
-     * userPermissions: ['BanMembers']
+     * userPermissions: 'BanMembers'
+     * or
+     * userPermissions: ['BanMembers', 'KickMembers']
      */
-    userPermissions?: PermissionsString[];
+    userPermissions?: PermissionsString | PermissionsString[];
     /**
-     * An array of bot permissions.
+     * A string or array of permissions that the bot needs to execute the current command.
+     * Used for built-in validation.
      *
      * @example
-     * botPermissions: ['BanMembers']
+     * botPermissions: 'BanMembers'
+     * or
+     * botPermissions: ['BanMembers', 'KickMembers']
      */
-    botPermissions?: PermissionsString[];
+    botPermissions?: PermissionsString | PermissionsString[];
     [key: string]: any;
 }
-declare enum CommandType {
-    /**
-     * Slash commands.
-     */
-    'ChatInput' = 1,
-    /**
-     * Message context menu commands.
-     */
-    'Message' = 3,
-    /**
-     * User context menu commands.
-     */
-    'User' = 2
-}
-type LocaleString = 'id' | `en-${'GB' | 'US'}` | 'bg' | `zh-${'CN' | 'TW'}` | 'hr' | 'cs' | 'da' | 'nl' | 'fi' | 'fr' | 'de' | 'el' | 'hi' | 'hu' | 'it' | 'ja' | 'ko' | 'lt' | 'no' | 'pl' | 'pt-BR' | 'ro' | 'ru' | 'es-ES' | 'sv-SE' | 'th' | 'tr' | 'uk' | 'vi';
-/**
- * Common items for command data.
- */
-type BaseCommandData = {
-    /**
-     * The name of the command.
-     */
-    name: string;
-    /**
-     * The type of the command.
-     */
-    type?: CommandType;
-    /**
-     * i18n for the command name.
-     */
-    name_localizations?: Partial<Record<LocaleString, string | null>>;
-    /**
-     * Whether to allow this command in DMs.
-     */
-    dm_permission?: boolean;
-    /**
-     * Default permissions for members for the command.
-     */
-    default_member_permissions?: string;
-    /**
-     * Whether the command is age-restricted.
-     */
-    nsfw?: boolean;
-};
-/**
- * Data for chat input commands.
- */
-type ChatInputCommandData = BaseCommandData & {
-    /**
-     * The command's type.
-     */
-    type?: CommandType.ChatInput;
-    /**
-     * The description of the command.
-     */
-    description: string;
-    /**
-     * i18n for the command description.
-     */
-    description_localizations?: Partial<Record<LocaleString, string | null>>;
-    /**
-     * Chat input command options.
-     */
-    options?: Array<APIApplicationCommandOption>;
-};
-/**
- * Represents any context menu command data.
- */
-type UserOrMessageCommandData = BaseCommandData & {
-    type: CommandType.User | CommandType.Message;
-};
-type CommandData = ChatInputCommandData | UserOrMessageCommandData;
+type CommandData = RESTPostAPIApplicationCommandsJSONBody;
 type CommandObject = {
     /**
-     * Command data which is a slash command builder or raw JSON data.
-     * @example
-     * {
-     *      name: 'ping',
-     *      description: 'Replies with Pong!'
-     * }
+     * An object which defines the structure of the application command.
      */
     data: CommandData;
     /**
-     * CommandKit command options.
-     * @example
-     * {
-     *      devOnly: true,
-     *      userPermissions: ['ManageGuild'],
-     *      botPermissions: ['ManageGuild'],
-     * }
+     * Additional command configuration options.
      */
     options?: CommandOptions;
     /**
@@ -204,7 +171,13 @@ type CommandObject = {
      */
     filePath: string;
     /**
-     * The command's category.
+     * The command's category. Determined based on the command folder.
+     *
+     * @example
+     * ```txt
+     * "/src/commands/ping.js" -> null
+     * "/src/commands/Misc/ping.js" -> "Misc"
+     * ```
      */
     category: string | null;
     [key: string]: any;
@@ -220,57 +193,12 @@ declare enum ReloadType {
     Global = "global"
 }
 
-/**
- * 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;
-}
-/**
- * A reload type for commands.
- */
-type ReloadOptions = 'dev' | 'global' | ReloadType;
-
 declare class CommandKit {
     #private;
     /**
-     * Create a new handler with CommandKit.
-     * @param options - Options to use (client, commandsPath, eventsPath, etc.)
+     * Create a new command and event handler with CommandKit.
+     *
+     * @param options - The default CommandKit configuration.
      * @see {@link https://commandkit.js.org/docs/commandkit-setup}
      */
     constructor(options: CommandKitOptions);
@@ -430,4 +358,4 @@ declare function createSignal<T = unknown>(value?: CommandKitSignalInitializer<T
  */
 declare function createEffect(callback: CommandKitEffectCallback): void;
 
-export { ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, CommandType, ContextMenuCommandProps, ReloadType, SlashCommandProps, ValidationFunctionProps, createEffect, createSignal, defineConfig, getConfig };
+export { ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, ContextMenuCommandProps, MessageContextMenuCommandProps, ReloadType, SlashCommandProps, UserContextMenuCommandProps, ValidationFunctionProps, createEffect, createSignal, defineConfig, getConfig };

package/dist/index.js

@@ -39,8 +39,15 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
-// src/utils/get-paths.ts
+// src/utils/resolve-file-url.ts
 var import_path = __toESM(require("path"));
+function toFileURL(filePath) {
+  const resolvedPath = import_path.default.resolve(filePath);
+  return "file://" + resolvedPath.replace(/\\\\|\\/g, "/");
+}
+
+// src/utils/get-paths.ts
+var import_path2 = __toESM(require("path"));
 var import_promises = __toESM(require("fs/promises"));
 async function getFilePaths(directory, nesting) {
   let filePaths = [];
@@ -48,7 +55,7 @@ async function getFilePaths(directory, nesting) {
     return filePaths;
   const files = await import_promises.default.readdir(directory, { withFileTypes: true });
   for (const file of files) {
-    const filePath = import_path.default.join(directory, file.name);
+    const filePath = import_path2.default.join(directory, file.name);
     if (file.isFile()) {
       filePaths.push(filePath);
     }
@@ -64,7 +71,7 @@ async function getFolderPaths(directory, nesting) {
     return folderPaths;
   const folders = await import_promises.default.readdir(directory, { withFileTypes: true });
   for (const folder of folders) {
-    const folderPath = import_path.default.join(directory, folder.name);
+    const folderPath = import_path2.default.join(directory, folder.name);
     if (folder.isDirectory()) {
       folderPaths.push(folderPath);
       if (nesting) {
@@ -75,13 +82,6 @@ async function getFolderPaths(directory, nesting) {
   return folderPaths;
 }
 
-// src/utils/resolve-file-url.ts
-var import_path2 = __toESM(require("path"));
-function toFileURL(filePath) {
-  const resolvedPath = import_path2.default.resolve(filePath);
-  return "file://" + resolvedPath.replace(/\\\\|\\/g, "/");
-}
-
 // src/utils/colors.ts
 var resetColor = "\x1B[0m";
 var colors_default = {
@@ -393,26 +393,21 @@ function devOnly_default({ interaction, targetCommand, handlerData }) {
   }
 }
 
-// src/handlers/command-handler/validations/guildOnly.ts
-function guildOnly_default({ interaction, targetCommand }) {
-  if (targetCommand.options?.guildOnly && !interaction.inGuild()) {
-    interaction.reply({
-      content: "\u274C This command can only be used inside a server.",
-      ephemeral: true
-    });
-    return true;
-  }
-}
-
 // src/handlers/command-handler/validations/permissions.ts
 var import_discord = require("discord.js");
 function permissions_default({ interaction, targetCommand }) {
   const userPermissions = interaction.memberPermissions;
   let userPermissionsRequired = targetCommand.options?.userPermissions;
   let missingUserPermissions = [];
+  if (typeof userPermissionsRequired === "string") {
+    userPermissionsRequired = [userPermissionsRequired];
+  }
   const botPermissions = interaction.guild?.members.me?.permissions;
   let botPermissionsRequired = targetCommand.options?.botPermissions;
   let missingBotPermissions = [];
+  if (typeof botPermissionsRequired === "string") {
+    botPermissionsRequired = [botPermissionsRequired];
+  }
   if (!userPermissionsRequired?.length && !botPermissionsRequired?.length) {
     return;
   }
@@ -463,7 +458,7 @@ function permissions_default({ interaction, targetCommand }) {
 }
 
 // src/handlers/command-handler/validations/index.ts
-var validations_default = [devOnly_default, guildOnly_default, permissions_default];
+var validations_default = [devOnly_default, permissions_default];
 
 // src/handlers/command-handler/CommandHandler.ts
 var import_rfdc = __toESM(require("rfdc"));
@@ -788,8 +783,9 @@ var ValidationHandler = class {
 var CommandKit = class {
   #data;
   /**
-   * Create a new handler with CommandKit.
-   * @param options - Options to use (client, commandsPath, eventsPath, etc.)
+   * Create a new command and event handler with CommandKit.
+   *
+   * @param options - The default CommandKit configuration.
    * @see {@link https://commandkit.js.org/docs/commandkit-setup}
    */
   constructor(options) {

package/dist/index.mjs

@@ -6,8 +6,15 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
-// src/utils/get-paths.ts
+// src/utils/resolve-file-url.ts
 import path from "path";
+function toFileURL(filePath) {
+  const resolvedPath = path.resolve(filePath);
+  return "file://" + resolvedPath.replace(/\\\\|\\/g, "/");
+}
+
+// src/utils/get-paths.ts
+import path2 from "path";
 import fs from "fs/promises";
 async function getFilePaths(directory, nesting) {
   let filePaths = [];
@@ -15,7 +22,7 @@ async function getFilePaths(directory, nesting) {
     return filePaths;
   const files = await fs.readdir(directory, { withFileTypes: true });
   for (const file of files) {
-    const filePath = path.join(directory, file.name);
+    const filePath = path2.join(directory, file.name);
     if (file.isFile()) {
       filePaths.push(filePath);
     }
@@ -31,7 +38,7 @@ async function getFolderPaths(directory, nesting) {
     return folderPaths;
   const folders = await fs.readdir(directory, { withFileTypes: true });
   for (const folder of folders) {
-    const folderPath = path.join(directory, folder.name);
+    const folderPath = path2.join(directory, folder.name);
     if (folder.isDirectory()) {
       folderPaths.push(folderPath);
       if (nesting) {
@@ -42,13 +49,6 @@ async function getFolderPaths(directory, nesting) {
   return folderPaths;
 }
 
-// src/utils/resolve-file-url.ts
-import path2 from "path";
-function toFileURL(filePath) {
-  const resolvedPath = path2.resolve(filePath);
-  return "file://" + resolvedPath.replace(/\\\\|\\/g, "/");
-}
-
 // src/utils/colors.ts
 var resetColor = "\x1B[0m";
 var colors_default = {
@@ -360,26 +360,21 @@ function devOnly_default({ interaction, targetCommand, handlerData }) {
   }
 }
 
-// src/handlers/command-handler/validations/guildOnly.ts
-function guildOnly_default({ interaction, targetCommand }) {
-  if (targetCommand.options?.guildOnly && !interaction.inGuild()) {
-    interaction.reply({
-      content: "\u274C This command can only be used inside a server.",
-      ephemeral: true
-    });
-    return true;
-  }
-}
-
 // src/handlers/command-handler/validations/permissions.ts
 import { EmbedBuilder } from "discord.js";
 function permissions_default({ interaction, targetCommand }) {
   const userPermissions = interaction.memberPermissions;
   let userPermissionsRequired = targetCommand.options?.userPermissions;
   let missingUserPermissions = [];
+  if (typeof userPermissionsRequired === "string") {
+    userPermissionsRequired = [userPermissionsRequired];
+  }
   const botPermissions = interaction.guild?.members.me?.permissions;
   let botPermissionsRequired = targetCommand.options?.botPermissions;
   let missingBotPermissions = [];
+  if (typeof botPermissionsRequired === "string") {
+    botPermissionsRequired = [botPermissionsRequired];
+  }
   if (!userPermissionsRequired?.length && !botPermissionsRequired?.length) {
     return;
   }
@@ -430,7 +425,7 @@ function permissions_default({ interaction, targetCommand }) {
 }
 
 // src/handlers/command-handler/validations/index.ts
-var validations_default = [devOnly_default, guildOnly_default, permissions_default];
+var validations_default = [devOnly_default, permissions_default];
 
 // src/handlers/command-handler/CommandHandler.ts
 import rdfc from "rfdc";
@@ -755,8 +750,9 @@ var ValidationHandler = class {
 var CommandKit = class {
   #data;
   /**
-   * Create a new handler with CommandKit.
-   * @param options - Options to use (client, commandsPath, eventsPath, etc.)
+   * Create a new command and event handler with CommandKit.
+   *
+   * @param options - The default CommandKit configuration.
    * @see {@link https://commandkit.js.org/docs/commandkit-setup}
    */
   constructor(options) {

package/package.json

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