@guardbot/framework 1.0.0

package/README.md

@@ -0,0 +1,106 @@
+![Framework](https://raw.githubusercontent.com/guardbotgg/.github/master/assets/framework.png)
+
+<br/>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/guardbotgg/assets/master/made-with-typescript.svg" alt="badge" />
+  <img src="https://raw.githubusercontent.com/guardbotgg/assets/master/made-with-love.svg" alt="badge" />
+</p>
+<br/>
+
+# @guardbot/framework
+> **A simple framework made for building discord bots with discord.js.**
+
+## **📦 Installation**
+```sh
+$ npm install @guardbot/framework # via npm
+$ yarn add @guardbot/framework # yarn
+$ pnpm add @guardbot/framework # pnpm
+```
+
+## **✨ Features**
+- Easy to use.
+- Beginner friendly.
+- Supports Intellisense.
+
+## **🪴 Quick Start**
+
+### 1. Initialize the Client
+Create your main entry file (e.g., `index.ts`) and initialize the `FrameworkClient`.
+
+```typescript
+import { FrameworkClient } from '@guardbot/framework';
+import { GatewayIntentBits } from 'discord.js';
+import path from 'path';
+
+const client = new FrameworkClient({
+  clientOptions: {
+    intents: [
+      GatewayIntentBits.Guilds,
+      GatewayIntentBits.GuildMessages,
+      GatewayIntentBits.MessageContent
+    ]
+  },
+  rootDir: path.join(__dirname),
+  registerOnStart: true, 
+  prefix: '!', 
+});
+
+client.login('DISCORD_BOT_TOKEN');
+```
+
+### 2. Create a Slash Command
+Create a file in your commands directory (e.g., `src/commands/general/ping.ts`).
+
+```typescript
+import { SlashCommand } from '@guardbot/framework';
+
+export default SlashCommand({
+  name: 'ping',
+  description: 'Replies with Pong!',
+  commandScope: 'default',
+  cooldown: 5000,
+
+  async execute(client, interaction) {
+    await interaction.reply({ content: `Pong! 🏓 (${client.ws.ping}ms)` });
+  },
+});
+```
+
+### 3. Create a Message Command
+Create a file for prefix-based commands (e.g., `src/commands/general/ping.ts`).
+
+```typescript
+import { MessageCommand } from '@guardbot/framework';
+
+export default MessageCommand({
+  name: 'ping',
+  description: 'Replies with Pong!',
+  aliases: ['latency'],
+  cooldown: 5000,
+
+  async execute(client, message, args) {
+    await message.reply({ content: `Pong! 🏓 (${client.ws.ping}ms)` });
+  },
+});
+```
+
+### 4. Create an Event Listener
+Create an event file (e.g., `src/listeners/client/ready.ts`).
+
+```typescript
+import { Listener } from '@guardbot/framework';
+
+export default Listener({
+  name: 'clientReady',
+  once: true,
+
+  async execute(client) {
+    console.log(`Logged in as ${client.user.tag}!`);
+    console.log(`Loaded ${client.commands.size} commands.`);
+    return true;
+  }
+})
+```
+
+## **🎐 Support Server**
+<a href="https://discord.gg/invite/GaczkwfgV9"><img src="https://invidget.switchblade.xyz/GaczkwfgV9" alt="Discord"></a>

package/build/index.d.mts

@@ -0,0 +1,284 @@
+import * as discord_js from 'discord.js';
+import { Client, PermissionResolvable, InteractionContextType, ApplicationIntegrationType, LocalizationMap, ApplicationCommandOptionData, ChatInputCommandInteraction, AutocompleteInteraction, Message, ContextMenuCommandInteraction, CommandInteraction, PermissionsString, Interaction, Collection, ClientEvents, ModalSubmitInteraction, ClientOptions, MessageCollectorOptions, InteractionCollectorOptions } from 'discord.js';
+export { SlashCommandAttachmentOption as AttachmentOption, SlashCommandBooleanOption as BooleanOption, SlashCommandChannelOption as ChannelOption, SlashCommandIntegerOption as IntegerOption, SlashCommandMentionableOption as MentionableOption, SlashCommandNumberOption as NumberOption, SlashCommandRoleOption as RoleOption, SlashCommandOptionsOnlyBuilder as SlashCommandOptionsBuilder, SlashCommandStringOption as StringOption, SlashCommandSubcommandBuilder as SubcommandBuilder, SlashCommandSubcommandGroupBuilder as SubcommandGroupBuilder } from 'discord.js';
+import EventEmitter from 'events';
+
+declare class FrameworkClient<Ready extends boolean = boolean> extends Client<Ready> {
+    rootDir: string;
+    prefix: string;
+    developers: string[];
+    constructor(frameworkOptions: FrameworkClientOptions);
+    start(token: string): Promise<void>;
+}
+
+interface BaseCommandOptions {
+    /** The Name of the Command */
+    name: string;
+    /** The Description of the Command */
+    description: string;
+    /** The Type of the Command */
+    commandType: 'Slash' | 'Message' | 'ContextMessage' | 'ContextUser';
+    /** The Cooldown of the Command (in MS) */
+    cooldown?: number;
+    /** Permissions required by the User to use this Command */
+    memberPermissions?: PermissionResolvable;
+    /** Permissions required by the Application Client to execute this Command */
+    clientPermissions?: PermissionResolvable;
+    /** Whether this command is Disbaled */
+    disabled?: boolean;
+}
+interface BaseAppCommandOptions extends BaseCommandOptions {
+    /**
+     * Where this Application Command can be registered
+     * - `default` - In both Guild & Global Commands
+     * - `guild` - In only Guild Commands
+     * - `global` - In only Global Commands
+     */
+    commandScope: 'default' | 'guild' | 'global';
+    /**
+     * Where this Application Command can be used
+     * - `Guild` | `(0)` - In Guilds
+     * - `BotDM` | `(1)` - In Application DMs
+     * - `PrivateChannel` | `(2)` - In Other's DMs & Group DMs
+     */
+    commandContexts?: (InteractionContextType | keyof typeof InteractionContextType)[];
+    /**
+     * Where this Application Command can be integrated
+     * - `GuildInstall` | `(0)` - App is installable to servers
+     * - `UserInstall` | `(1)` - App is installable to users
+     */
+    integrationTypes?: (ApplicationIntegrationType | keyof typeof ApplicationIntegrationType)[];
+    /** The Name Localizations of the Command */
+    nameLocalizations?: LocalizationMap;
+    /** The Description Localizations of the Command */
+    descriptionLocalizations?: LocalizationMap;
+}
+interface MessageCommandOptions$1 extends BaseCommandOptions {
+    commandType: 'Message';
+    /** The Aliases of the Command */
+    aliases?: string[];
+    /** The Usage of the Command */
+    usage?: string;
+    /** Whether the command is Developer Only */
+    devOnly?: boolean;
+    /**
+     * Where this Application Command can be used
+     * - `BotDM` - In Application DMs
+     * - `Guild` - In Guilds
+     */
+    contexts?: ('BotDM' | 'Guild')[];
+    execute: (client: FrameworkClient<true>, message: Message, args: string[]) => Promise<unknown>;
+}
+interface SlashCommandOptions$1 extends BaseAppCommandOptions {
+    commandType: 'Slash';
+    /** The Application Command Options of this Command */
+    options?: ApplicationCommandOptionData[];
+    execute: (client: FrameworkClient<true>, interaction: ChatInputCommandInteraction) => Promise<unknown>;
+    autocomplete?: (client: FrameworkClient<true>, interaction: AutocompleteInteraction) => Promise<unknown>;
+}
+interface ContextCommandOptions extends BaseAppCommandOptions {
+    commandType: 'ContextMessage' | 'ContextUser';
+    execute: (client: FrameworkClient<true>, interaction: ContextMenuCommandInteraction) => Promise<unknown>;
+}
+interface BaseCommand {
+    id: string;
+    filepath: string;
+    disabled: boolean;
+}
+type FrameworkSlashCommand = SlashCommandOptions$1 & BaseCommand;
+type FrameworkContextCommand = ContextCommandOptions & BaseCommand;
+type FrameworkMessageCommand = MessageCommandOptions$1 & BaseCommand & {
+    devOnly: boolean;
+    contexts: ('BotDM' | 'Guild')[];
+};
+type FrameworkCommand = (FrameworkSlashCommand | FrameworkMessageCommand | FrameworkContextCommand);
+interface CommandModuleHandler {
+    onCooldown?: (context: Message | CommandInteraction, command: FrameworkCommand, expirationTime: Date) => any;
+    onMemberPermissions?: (context: Message, command: FrameworkCommand, missingPermissions: PermissionsString[]) => any;
+    onClientPermissions?: (context: Message | CommandInteraction, command: FrameworkCommand, missingPermissions: PermissionsString[]) => any;
+    MessageCommandInterceptor?: (message: Message) => Promise<boolean>;
+    InteractionCommandInterceptor?: (interaction: Interaction) => Promise<boolean>;
+}
+type CommandHandlerName = keyof Omit<CommandModuleHandler, 'MessageCommandInterceptor' | 'InteractionCommandInterceptor'>;
+
+/**
+ * @class AutocompleteModule
+ * @fires AutocompleteModule#execute
+ * @fires AutocompleteModule#success
+ * @fires AutocompleteModule#error
+ * @fires AutocompleteModule#unknown
+ */
+declare class AutocompleteModule extends EventEmitter {
+    private client;
+    constructor(client: FrameworkClient);
+    load(filepath: string, reload?: boolean): Promise<boolean>;
+    loadAll(): Promise<void>;
+    reload(id: string): void;
+    private unload;
+    private _handleInteraction;
+}
+
+declare class ListenerModule {
+    private client;
+    constructor(client: FrameworkClient);
+    load(filepath: string, reload?: boolean): Promise<boolean>;
+    loadAll(): Promise<void>;
+    reload(id: string): void;
+    private unload;
+}
+
+/**
+ * @class CommandsModule
+ * @fires CommandsModule#execute
+ * @fires CommandsModule#success
+ * @fires CommandsModule#error
+ * @fires CommandsModule#unknown
+ */
+declare class CommandsModule extends EventEmitter {
+    private client;
+    private handler;
+    constructor(client: FrameworkClient);
+    setHandler<K extends CommandHandlerName>(key: K, callback: NonNullable<CommandModuleHandler[K]>): NonNullable<CommandModuleHandler[K]>;
+    setMessageInterceptor(callback: (message: Message) => Promise<boolean>): (message: Message) => Promise<boolean>;
+    setInteractionInterceptor(callback: (interaction: Interaction) => Promise<boolean>): (interaction: Interaction) => Promise<boolean>;
+    load(filepath: string, reload?: boolean): Promise<boolean>;
+    loadAll(): Promise<void>;
+    reload(id: string): void;
+    private unload;
+    registerOnStart(guildIds: string[], commands?: Collection<string, FrameworkCommand>): Promise<void>;
+    publishGlobal(commands?: Collection<string, FrameworkCommand>): Promise<false | Collection<string, discord_js.ApplicationCommand<{
+        guild: discord_js.GuildResolvable;
+    }>>>;
+    publishGuild(guildId: string, commands?: Collection<string, FrameworkCommand>): Promise<void>;
+    private _handleMessage;
+    private _handleInteraction;
+    private _getCommandId;
+    private _getCommandData;
+}
+
+interface ListenerOptions<T extends keyof ClientEvents = keyof ClientEvents> {
+    /** Name of the Listener. */
+    name: T;
+    /** Wheather to execute the function only Once. */
+    once?: boolean;
+    /** Whether the Listener is disabled. */
+    disabled?: boolean;
+    /** Handles the execution of the Listener */
+    execute: (...args: ClientEvents[T]) => Promise<boolean>;
+}
+interface FrameworkListener<T extends keyof ClientEvents = keyof ClientEvents> {
+    id: string;
+    filepath: string;
+    name: T;
+    once: boolean;
+    disabled: boolean;
+    execute: (...args: ClientEvents[T]) => Promise<boolean>;
+    _execute?: (...args: ClientEvents[T]) => Promise<boolean>;
+}
+
+interface FrameworkClientOptions {
+    clientOptions: ClientOptions;
+    rootDir?: string;
+    developers?: string[];
+    prefix?: string;
+    registerOnStart?: boolean;
+    guildsToRegister?: string[];
+}
+interface AutocompleterOptions {
+    /** Name of the Autocompleter. */
+    name: string;
+    /** Whether the Autocompleter is disabled. */
+    disabled?: boolean;
+    /** Handle the execution of the Autocompleter. */
+    execute: (client: FrameworkClient<true>, interaction: AutocompleteInteraction, command: FrameworkSlashCommand, value: string) => Promise<unknown>;
+}
+interface FrameworkAutocompleter {
+    id: string;
+    filepath: string;
+    name: string;
+    disabled: boolean;
+    execute: (client: FrameworkClient<true>, interaction: AutocompleteInteraction, command: FrameworkSlashCommand, value: string) => Promise<unknown>;
+}
+type ModalCollectorOptions = InteractionCollectorOptions<ModalSubmitInteraction>;
+interface AwaitMemberResponseOptions extends MessageCollectorOptions {
+    deleteMessage?: boolean;
+}
+
+declare module 'discord.js' {
+    interface ClientEvents {
+        buttonInteraction: [interaction: ButtonInteraction];
+        selectMenuInteraction: [interaction: AnySelectMenuInteraction];
+        modalSubmitInteraction: [interaction: ModalSubmitInteraction];
+    }
+    interface Client {
+        prefix: string;
+        developers: string[];
+        autocomplete: Collection<string, FrameworkAutocompleter>;
+        aliases: Collection<string, string>;
+        commands: Collection<string, FrameworkCommand>;
+        cooldowns: Collection<string, Collection<string, number>>;
+        events: Collection<string, FrameworkListener<keyof ClientEvents>>;
+        autocompleteModule: AutocompleteModule;
+        commandsModule: CommandsModule;
+        listenerModule: ListenerModule;
+    }
+    interface Message {
+        prefix: string;
+        isDeveloper(): boolean;
+        awaitMemberResponse(options?: AwaitMemberResponseOptions): Promise<Message>;
+        createModalSubmitCollector(options?: ModalCollectorOptions): InteractionCollector<ModalSubmitInteraction>;
+        awaitModalSubmitComponent(options?: ModalCollectorOptions): Promise<ModalSubmitInteraction>;
+    }
+}
+
+declare function Autocompleter(options: AutocompleterOptions): {
+    id: string;
+    name: string;
+    disabled: boolean;
+    execute: (client: FrameworkClient<true>, interaction: discord_js.AutocompleteInteraction, command: FrameworkSlashCommand, value: string) => Promise<unknown>;
+};
+
+declare function ContextCommand(options: ContextCommandOptions): {
+    id: string;
+    name: string;
+    description: string;
+    commandType: "Slash" | "Message" | "ContextUser" | "ContextMessage";
+    memberPermissions: discord_js.PermissionResolvable | undefined;
+    clientPermissions: discord_js.PermissionResolvable | undefined;
+    cooldown: number | undefined;
+    disabled: boolean;
+};
+
+type MessageCommandOptions = Omit<MessageCommandOptions$1, 'commandType'>;
+declare function MessageCommand(options: MessageCommandOptions): {
+    id: string;
+    name: string;
+    description: string;
+    commandType: "Slash" | "Message" | "ContextUser" | "ContextMessage";
+    memberPermissions: discord_js.PermissionResolvable | undefined;
+    clientPermissions: discord_js.PermissionResolvable | undefined;
+    cooldown: number | undefined;
+    disabled: boolean;
+};
+
+type SlashCommandOptions = Omit<SlashCommandOptions$1, 'commandType'>;
+declare function SlashCommand(options: SlashCommandOptions): {
+    id: string;
+    name: string;
+    description: string;
+    commandType: "Slash" | "Message" | "ContextUser" | "ContextMessage";
+    memberPermissions: discord_js.PermissionResolvable | undefined;
+    clientPermissions: discord_js.PermissionResolvable | undefined;
+    cooldown: number | undefined;
+    disabled: boolean;
+};
+
+declare function Listener<T extends keyof ClientEvents>(options: ListenerOptions<T>): {
+    id: string;
+    name: T;
+    once: boolean;
+    disabled: boolean;
+    execute: (...args: ClientEvents[T]) => Promise<boolean>;
+};
+
+export { Autocompleter, type CommandHandlerName, type CommandModuleHandler, ContextCommand, type FrameworkAutocompleter, FrameworkClient, type FrameworkCommand, type FrameworkContextCommand, type FrameworkListener, type FrameworkMessageCommand, type FrameworkSlashCommand, Listener, MessageCommand, SlashCommand };

package/build/index.d.ts

@@ -0,0 +1,284 @@
+import * as discord_js from 'discord.js';
+import { Client, PermissionResolvable, InteractionContextType, ApplicationIntegrationType, LocalizationMap, ApplicationCommandOptionData, ChatInputCommandInteraction, AutocompleteInteraction, Message, ContextMenuCommandInteraction, CommandInteraction, PermissionsString, Interaction, Collection, ClientEvents, ModalSubmitInteraction, ClientOptions, MessageCollectorOptions, InteractionCollectorOptions } from 'discord.js';
+export { SlashCommandAttachmentOption as AttachmentOption, SlashCommandBooleanOption as BooleanOption, SlashCommandChannelOption as ChannelOption, SlashCommandIntegerOption as IntegerOption, SlashCommandMentionableOption as MentionableOption, SlashCommandNumberOption as NumberOption, SlashCommandRoleOption as RoleOption, SlashCommandOptionsOnlyBuilder as SlashCommandOptionsBuilder, SlashCommandStringOption as StringOption, SlashCommandSubcommandBuilder as SubcommandBuilder, SlashCommandSubcommandGroupBuilder as SubcommandGroupBuilder } from 'discord.js';
+import EventEmitter from 'events';
+
+declare class FrameworkClient<Ready extends boolean = boolean> extends Client<Ready> {
+    rootDir: string;
+    prefix: string;
+    developers: string[];
+    constructor(frameworkOptions: FrameworkClientOptions);
+    start(token: string): Promise<void>;
+}
+
+interface BaseCommandOptions {
+    /** The Name of the Command */
+    name: string;
+    /** The Description of the Command */
+    description: string;
+    /** The Type of the Command */
+    commandType: 'Slash' | 'Message' | 'ContextMessage' | 'ContextUser';
+    /** The Cooldown of the Command (in MS) */
+    cooldown?: number;
+    /** Permissions required by the User to use this Command */
+    memberPermissions?: PermissionResolvable;
+    /** Permissions required by the Application Client to execute this Command */
+    clientPermissions?: PermissionResolvable;
+    /** Whether this command is Disbaled */
+    disabled?: boolean;
+}
+interface BaseAppCommandOptions extends BaseCommandOptions {
+    /**
+     * Where this Application Command can be registered
+     * - `default` - In both Guild & Global Commands
+     * - `guild` - In only Guild Commands
+     * - `global` - In only Global Commands
+     */
+    commandScope: 'default' | 'guild' | 'global';
+    /**
+     * Where this Application Command can be used
+     * - `Guild` | `(0)` - In Guilds
+     * - `BotDM` | `(1)` - In Application DMs
+     * - `PrivateChannel` | `(2)` - In Other's DMs & Group DMs
+     */
+    commandContexts?: (InteractionContextType | keyof typeof InteractionContextType)[];
+    /**
+     * Where this Application Command can be integrated
+     * - `GuildInstall` | `(0)` - App is installable to servers
+     * - `UserInstall` | `(1)` - App is installable to users
+     */
+    integrationTypes?: (ApplicationIntegrationType | keyof typeof ApplicationIntegrationType)[];
+    /** The Name Localizations of the Command */
+    nameLocalizations?: LocalizationMap;
+    /** The Description Localizations of the Command */
+    descriptionLocalizations?: LocalizationMap;
+}
+interface MessageCommandOptions$1 extends BaseCommandOptions {
+    commandType: 'Message';
+    /** The Aliases of the Command */
+    aliases?: string[];
+    /** The Usage of the Command */
+    usage?: string;
+    /** Whether the command is Developer Only */
+    devOnly?: boolean;
+    /**
+     * Where this Application Command can be used
+     * - `BotDM` - In Application DMs
+     * - `Guild` - In Guilds
+     */
+    contexts?: ('BotDM' | 'Guild')[];
+    execute: (client: FrameworkClient<true>, message: Message, args: string[]) => Promise<unknown>;
+}
+interface SlashCommandOptions$1 extends BaseAppCommandOptions {
+    commandType: 'Slash';
+    /** The Application Command Options of this Command */
+    options?: ApplicationCommandOptionData[];
+    execute: (client: FrameworkClient<true>, interaction: ChatInputCommandInteraction) => Promise<unknown>;
+    autocomplete?: (client: FrameworkClient<true>, interaction: AutocompleteInteraction) => Promise<unknown>;
+}
+interface ContextCommandOptions extends BaseAppCommandOptions {
+    commandType: 'ContextMessage' | 'ContextUser';
+    execute: (client: FrameworkClient<true>, interaction: ContextMenuCommandInteraction) => Promise<unknown>;
+}
+interface BaseCommand {
+    id: string;
+    filepath: string;
+    disabled: boolean;
+}
+type FrameworkSlashCommand = SlashCommandOptions$1 & BaseCommand;
+type FrameworkContextCommand = ContextCommandOptions & BaseCommand;
+type FrameworkMessageCommand = MessageCommandOptions$1 & BaseCommand & {
+    devOnly: boolean;
+    contexts: ('BotDM' | 'Guild')[];
+};
+type FrameworkCommand = (FrameworkSlashCommand | FrameworkMessageCommand | FrameworkContextCommand);
+interface CommandModuleHandler {
+    onCooldown?: (context: Message | CommandInteraction, command: FrameworkCommand, expirationTime: Date) => any;
+    onMemberPermissions?: (context: Message, command: FrameworkCommand, missingPermissions: PermissionsString[]) => any;
+    onClientPermissions?: (context: Message | CommandInteraction, command: FrameworkCommand, missingPermissions: PermissionsString[]) => any;
+    MessageCommandInterceptor?: (message: Message) => Promise<boolean>;
+    InteractionCommandInterceptor?: (interaction: Interaction) => Promise<boolean>;
+}
+type CommandHandlerName = keyof Omit<CommandModuleHandler, 'MessageCommandInterceptor' | 'InteractionCommandInterceptor'>;
+
+/**
+ * @class AutocompleteModule
+ * @fires AutocompleteModule#execute
+ * @fires AutocompleteModule#success
+ * @fires AutocompleteModule#error
+ * @fires AutocompleteModule#unknown
+ */
+declare class AutocompleteModule extends EventEmitter {
+    private client;
+    constructor(client: FrameworkClient);
+    load(filepath: string, reload?: boolean): Promise<boolean>;
+    loadAll(): Promise<void>;
+    reload(id: string): void;
+    private unload;
+    private _handleInteraction;
+}
+
+declare class ListenerModule {
+    private client;
+    constructor(client: FrameworkClient);
+    load(filepath: string, reload?: boolean): Promise<boolean>;
+    loadAll(): Promise<void>;
+    reload(id: string): void;
+    private unload;
+}
+
+/**
+ * @class CommandsModule
+ * @fires CommandsModule#execute
+ * @fires CommandsModule#success
+ * @fires CommandsModule#error
+ * @fires CommandsModule#unknown
+ */
+declare class CommandsModule extends EventEmitter {
+    private client;
+    private handler;
+    constructor(client: FrameworkClient);
+    setHandler<K extends CommandHandlerName>(key: K, callback: NonNullable<CommandModuleHandler[K]>): NonNullable<CommandModuleHandler[K]>;
+    setMessageInterceptor(callback: (message: Message) => Promise<boolean>): (message: Message) => Promise<boolean>;
+    setInteractionInterceptor(callback: (interaction: Interaction) => Promise<boolean>): (interaction: Interaction) => Promise<boolean>;
+    load(filepath: string, reload?: boolean): Promise<boolean>;
+    loadAll(): Promise<void>;
+    reload(id: string): void;
+    private unload;
+    registerOnStart(guildIds: string[], commands?: Collection<string, FrameworkCommand>): Promise<void>;
+    publishGlobal(commands?: Collection<string, FrameworkCommand>): Promise<false | Collection<string, discord_js.ApplicationCommand<{
+        guild: discord_js.GuildResolvable;
+    }>>>;
+    publishGuild(guildId: string, commands?: Collection<string, FrameworkCommand>): Promise<void>;
+    private _handleMessage;
+    private _handleInteraction;
+    private _getCommandId;
+    private _getCommandData;
+}
+
+interface ListenerOptions<T extends keyof ClientEvents = keyof ClientEvents> {
+    /** Name of the Listener. */
+    name: T;
+    /** Wheather to execute the function only Once. */
+    once?: boolean;
+    /** Whether the Listener is disabled. */
+    disabled?: boolean;
+    /** Handles the execution of the Listener */
+    execute: (...args: ClientEvents[T]) => Promise<boolean>;
+}
+interface FrameworkListener<T extends keyof ClientEvents = keyof ClientEvents> {
+    id: string;
+    filepath: string;
+    name: T;
+    once: boolean;
+    disabled: boolean;
+    execute: (...args: ClientEvents[T]) => Promise<boolean>;
+    _execute?: (...args: ClientEvents[T]) => Promise<boolean>;
+}
+
+interface FrameworkClientOptions {
+    clientOptions: ClientOptions;
+    rootDir?: string;
+    developers?: string[];
+    prefix?: string;
+    registerOnStart?: boolean;
+    guildsToRegister?: string[];
+}
+interface AutocompleterOptions {
+    /** Name of the Autocompleter. */
+    name: string;
+    /** Whether the Autocompleter is disabled. */
+    disabled?: boolean;
+    /** Handle the execution of the Autocompleter. */
+    execute: (client: FrameworkClient<true>, interaction: AutocompleteInteraction, command: FrameworkSlashCommand, value: string) => Promise<unknown>;
+}
+interface FrameworkAutocompleter {
+    id: string;
+    filepath: string;
+    name: string;
+    disabled: boolean;
+    execute: (client: FrameworkClient<true>, interaction: AutocompleteInteraction, command: FrameworkSlashCommand, value: string) => Promise<unknown>;
+}
+type ModalCollectorOptions = InteractionCollectorOptions<ModalSubmitInteraction>;
+interface AwaitMemberResponseOptions extends MessageCollectorOptions {
+    deleteMessage?: boolean;
+}
+
+declare module 'discord.js' {
+    interface ClientEvents {
+        buttonInteraction: [interaction: ButtonInteraction];
+        selectMenuInteraction: [interaction: AnySelectMenuInteraction];
+        modalSubmitInteraction: [interaction: ModalSubmitInteraction];
+    }
+    interface Client {
+        prefix: string;
+        developers: string[];
+        autocomplete: Collection<string, FrameworkAutocompleter>;
+        aliases: Collection<string, string>;
+        commands: Collection<string, FrameworkCommand>;
+        cooldowns: Collection<string, Collection<string, number>>;
+        events: Collection<string, FrameworkListener<keyof ClientEvents>>;
+        autocompleteModule: AutocompleteModule;
+        commandsModule: CommandsModule;
+        listenerModule: ListenerModule;
+    }
+    interface Message {
+        prefix: string;
+        isDeveloper(): boolean;
+        awaitMemberResponse(options?: AwaitMemberResponseOptions): Promise<Message>;
+        createModalSubmitCollector(options?: ModalCollectorOptions): InteractionCollector<ModalSubmitInteraction>;
+        awaitModalSubmitComponent(options?: ModalCollectorOptions): Promise<ModalSubmitInteraction>;
+    }
+}
+
+declare function Autocompleter(options: AutocompleterOptions): {
+    id: string;
+    name: string;
+    disabled: boolean;
+    execute: (client: FrameworkClient<true>, interaction: discord_js.AutocompleteInteraction, command: FrameworkSlashCommand, value: string) => Promise<unknown>;
+};
+
+declare function ContextCommand(options: ContextCommandOptions): {
+    id: string;
+    name: string;
+    description: string;
+    commandType: "Slash" | "Message" | "ContextUser" | "ContextMessage";
+    memberPermissions: discord_js.PermissionResolvable | undefined;
+    clientPermissions: discord_js.PermissionResolvable | undefined;
+    cooldown: number | undefined;
+    disabled: boolean;
+};
+
+type MessageCommandOptions = Omit<MessageCommandOptions$1, 'commandType'>;
+declare function MessageCommand(options: MessageCommandOptions): {
+    id: string;
+    name: string;
+    description: string;
+    commandType: "Slash" | "Message" | "ContextUser" | "ContextMessage";
+    memberPermissions: discord_js.PermissionResolvable | undefined;
+    clientPermissions: discord_js.PermissionResolvable | undefined;
+    cooldown: number | undefined;
+    disabled: boolean;
+};
+
+type SlashCommandOptions = Omit<SlashCommandOptions$1, 'commandType'>;
+declare function SlashCommand(options: SlashCommandOptions): {
+    id: string;
+    name: string;
+    description: string;
+    commandType: "Slash" | "Message" | "ContextUser" | "ContextMessage";
+    memberPermissions: discord_js.PermissionResolvable | undefined;
+    clientPermissions: discord_js.PermissionResolvable | undefined;
+    cooldown: number | undefined;
+    disabled: boolean;
+};
+
+declare function Listener<T extends keyof ClientEvents>(options: ListenerOptions<T>): {
+    id: string;
+    name: T;
+    once: boolean;
+    disabled: boolean;
+    execute: (...args: ClientEvents[T]) => Promise<boolean>;
+};
+
+export { Autocompleter, type CommandHandlerName, type CommandModuleHandler, ContextCommand, type FrameworkAutocompleter, FrameworkClient, type FrameworkCommand, type FrameworkContextCommand, type FrameworkListener, type FrameworkMessageCommand, type FrameworkSlashCommand, Listener, MessageCommand, SlashCommand };