discord-bot-shared 0.13.0 → 0.14.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 adamhl8
+Copyright (c) 2025 adamhl8
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,171 +1,288 @@
 # discord-bot-shared
 
-**This readme is currently out of date.**
+A small package that makes creating [discord.js](https://github.com/discordjs/discord.js) bots a bit easier. It allows you easily create and register bot commands/events, handle runtime errors, and more.
 
-A module that makes creating discord.js bots a bit easier.
-
-## Installation/Usage
+---
 
-```
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Creating a `Bot` instance](#creating-a-bot-instance)
+- [Commands](#commands)
+  - [Creating a slash command](#creating-a-slash-command)
+  - [Adding and registering commands](#adding-and-registering-commands)
+  - [Unregistering commands](#unregistering-commands)
+  - [Global Command Hook](#global-command-hook)
+- [Events](#events)
+  - [Listening for events](#listening-for-events)
+  - [Adding and registering events](#adding-and-registering-events)
+- [Error Handling](#error-handling)
+  - [Commands](#commands-1)
+  - [Events](#events-1)
+- [Utilities](#utilities)
+  - [getChannel](#getchannel)
+
+## Installation
+
+```sh
 npm install discord-bot-shared
 ```
 
-- This module expects a `BOT_TOKEN` and `CLIENT_ID` environment variable to login.
-  - By default, commands are registered globally. To register commands to a specific guild, you can optionally provide `GUILD_ID`.
+## Quick Start
 
-```
-// index.ts
-import login from 'discord-bot-shared'
-import { ClientOptions, GatewayIntentBits as Intents, Partials } from 'discord.js'
+Let's create a simple bot with one slash command.
 
-const botIntents: ClientOptions = {
-  intents: [Intents.Guilds],
-  partials: [Partials.Reaction],
-}
+In **`ping.ts`:**
 
-const bot = await login(botIntents, import.meta.url)
+```ts
+import { Command } from "discord-bot-shared"
+import { SlashCommandBuilder } from "discord.js"
 
-export default bot
+const ping: Command = {
+  command: new SlashCommandBuilder().setName("ping").setDescription("I'll respond with pong!").toJSON(),
+  async run(interaction) {
+    await interaction.reply("Pong!")
+  },
+}
+
+export default ping
 ```
 
-**You must have a directory names `events` and `commands` next to your `index.ts` (or wherever you are importing `login()` from).**
+In **`index.ts`:**
 
-```
-.
-└── src/
-    ├── events/
-    │   └── someEvent.ts
-    ├── commands/
-    │   └── someCommand.ts
-    └── index.ts
+```ts
+import Bot from "discord-bot-shared"
+import { ClientOptions, GatewayIntentBits } from "discord.js"
+
+import ping from "./ping"
+
+// Get applicationId and token from environment variables
+const applicationId = process.env.APPLICATION_ID ?? ""
+const token = process.env.BOT_TOKEN ?? ""
+
+const clientOptions: ClientOptions = {
+  intents: [GatewayIntentBits.Guilds],
+}
+
+const bot = new Bot({ applicationId, token, clientOptions })
+
+bot.commands.add(ping)
+
+await bot.commands.register()
+await bot.login()
 ```
 
-### Events
+That's it! You now have bot that will respond to the slash command `/ping` with "Pong!".
 
-This module registers your bot's events by `import`ing each file under your `events` directory. Events are registered as a side-effect of the import.
+## Creating a `Bot` instance
 
+The `Bot` constructor takes an object that contains your bot's `applicationId`, secret `token`, and Discord `clientOptions`. See this [discord.js guide page](https://discordjs.guide/popular-topics/intents.html) for more info on setting up bot intents.
+
+```ts
+const bot = new Bot({ applicationId, token, clientOptions })
 ```
-// guildMemberAdd.ts
-import bot from '../index.js'
 
-bot.on('guildMemberAdd', (member) => {
-  // do stuff
-})
+Once you have your bot setup and are ready for it to start listening for the commands and events you've added:
+
+```ts
+await bot.login()
 ```
 
-### Commands
+## Commands
 
-Your commands are registered by `import`ing the default export of each command file.
+### Creating a slash command
 
-```
-// myCommand.ts
-import { Command } from 'discord-bot-shared'
-import { SlashCommandBuilder } from 'discord.js'
+Commands can be created by constructing `Command` objects that will be added to the bot later.
+
+```ts
+import { Command } from "discord-bot-shared"
+import { SlashCommandBuilder } from "discord.js"
 
-const myCommand: Command = {
-  command: new SlashCommandBuilder()
-    .setName('my-command')
-    .setDescription('This command does stuff.') as SlashCommandBuilder,
-  run: (interaction) => {
-    // do stuff
+const ping: Command = {
+  command: new SlashCommandBuilder().setName("ping").setDescription("I'll respond with pong!").toJSON(),
+  async run(interaction) {
+    await interaction.reply("Pong!")
   },
 }
 
-export default myCommand
+export default ping
 ```
 
-Your `run` function is passed the command interaction that initiated the command.
+Make sure to call `.toJSON()` on `SlashCommandBuilder`.
 
-### Exports
+You can optionally provide a `requiredRoles` string array. If the member initiating the command has _any_ of the roles provided in this array, they will be allowed to run the command.
 
-The following functions and interfaces/types are exported by this module:
+```ts
+const ping: Command = {
+  requiredRoles: ["cool guy", "cooler guy"], // Only members that have a role with the name "cool guy" OR "cooler guy" can run this command.
+  command: // ...
+  run: // ...
+}
+```
 
----
+### Adding and registering commands
 
-#### `function login`
+You can add commands to the bot like so:
 
-```
-async function login(
-  botIntents: ClientOptions,
-  projectMetaURL: string,
-  interactionCheck?: InteractionCheck,
-): Promise<Client>
+```ts
+bot.commands.add(ping)
 ```
 
-- `botIntents` is a discord.js `ClientOptions` object.
-- `projectMetaURL` should always be passed `import.meta.url`. This is used to find and register your events and commands.
-- Optionally provide an `interactionCheck` function that returns a boolean. This function is called right before trying to run a command. The command will only run if `interactionCheck` returns true.
-  - The `InteractionCheck` type is also exported by this module.
+Commands must be registered before they will appear in Discord.
 
----
+```ts
+await bot.commands.register()
+```
 
-#### `function getGuildCache`
+This registers commands globally (for all servers). It's not really recommended to register commands every time your bot starts up as you may get rate-limited by Discord.
 
-Returns an object that contains the guild and the following freshly fetched guild collections: `channels, emojis, members, roles`.
+### Unregistering commands
 
+```ts
+await bot.commands.unregisterApplicationCommands()
 ```
-async function getGuildCache()
+
+This will unregister all commands globally.
+
+### Global Command Hook
+
+You can optionally add a global command hook to your bot. This is a function that will be called before your command's `run` function.
+
+- The global command hook function must return a `boolean`.
+- If `true` is returned, the initiated command will run.
+
+```ts
+bot.commands.setGlobalCommandHook(commandHook)
 ```
 
-- For example, a common pattern I use is something like this:
+This allows you to perform certain actions or make checks before _any_ command runs. For example, you could do something like this:
 
+```ts
+function commandHook(interaction: ChatInputCommandInteraction<"cached">) {
+  if (interaction.channelId === "123456789") {
+    return true
+  } else {
+    throwUserError("This command was not initiated in the right channel.")
+  }
+}
+
+bot.commands.setGlobalCommandHook(commandHook)
 ```
-const { members } = await getGuildCache()
-// do stuff with members
+
+It's intended that you throw an error in the case you don't want the command to run rather than returning `false`. Otherwise, a generic error message will be displayed: `The global command hook returned false.`
+
+`throwUserError` is a special helper function. See [Error Handling](#error-handling) for more info.
+
+## Events
+
+### Listening for events
+
+You can create an `Event` object that will be added to the bot later.
+
+```ts
+import { Event } from "discord-bot-shared"
+import { Events } from "discord.js"
+
+const logNewMember: Event = {
+  event: Events.GuildMemberAdd,
+  handler(client, member) {
+    console.log(`${member.user.username} joined the server.`)
+  },
+}
+
+export default logNewMember
 ```
 
----
+The `Client` instance is always passed as the first argument to the `handler`. The rest of the arguments will be correctly typed based on the event you specify. Also, the `handler` can be `async` if needed.
 
-#### `interface Command`
+### Adding and registering events
 
-This interface defines the structure of your bot's commands. See above for an example of a command.
+You can add events to the bot like so:
 
+```ts
+bot.events.add(logNewMember)
 ```
-interface Command {
-  requiredRoles?: string[]
-  command: SlashCommandBuilder
-  run: (interaction: ChatInputCommandInteraction) => void | Promise<void>
+
+Unlike commands, events do not need to be registered separately. They will be listened for once the bot is logged in.
+
+## Error Handling
+
+This package makes it much easier to handle errors that are thrown during a command or event.
+
+There are two helper functions you can import for throwing errors: `throwError` and `throwUserError`. (These also conveniently allow you to throw an error as an expression.)
+
+- `throwError(message: string)`: Throw a `new Error` with `message`.
+- `throwUserError(message: string)`: Throw a `new UserError` with `message`.
+
+The usage of these is explained below.
+
+### Commands
+
+**TLDR:** Use `throwError` to display an error **with the stack trace** in the interaction reply. Use `throwUserError` to display the error message **only** in the interaction reply. That means by default, any instance of `Error` thrown (say by some function you don't own), will be displayed in the interaction reply with its stack trace (which is probably what you want).
+
+When an error is thrown during a command, the interaction is replied to with the error message. For example:
+
+```ts
+import { Command, throwError } from "discord-bot-shared"
+import { SlashCommandBuilder } from "discord.js"
+
+const ping: Command = {
+  command: new SlashCommandBuilder().setName("ping").setDescription("I'll respond with pong!").toJSON(),
+  async run(interaction) {
+    if (interaction.member.id === "12345") {
+      await interaction.reply("Pong!")
+    } else {
+      throwError("Expected member with ID: 12345")
+    }
+  },
 }
 ```
 
-- Optionally provide `requiredRoles` string array. If the member initiating the command has _any_ of the roles provided in this array, they will be allowed to run the command.
-- **You may have to type cast your command `as SlashCommandBuilder` due to the way discord.js' `SlashCommandBuilder` works.**
-- `run` is the final function that will be called to run your command.
+If a member with an ID of `12345` does not initiate this command, the bot will respond with `There was an error while running this command.` along with the error **and stack trace**.
 
----
+In most cases, you probably want to display a clean (i.e. without the stack trace) error message. That's where `throwUserError` comes in. If this type of error is thrown, only the provided error message is displayed.
 
-#### `function getChannel`
+As a more complete example, let's say we have some command that allows a member to level up when they have enough XP:
 
-Returns the guild channel of the given name/ID and type, otherwise returns `undefined`.
+```ts
+import { Command, throwUserError } from "discord-bot-shared"
+import { SlashCommandBuilder } from "discord.js"
 
-```
-async function getChannel<T extends NonThreadGuildBasedChannel>(
-  channelNameOrId: string,
-  channelType: NonThreadGuildBasedChannelType,
-): Promise<T | undefined>
+const levelUp: Command = {
+  command: new SlashCommandBuilder().setName("level-up").setDescription("Level up if you have enough XP.").toJSON(),
+  async run(interaction) {
+    const memberXP = getMemberXP(interaction.member.id) // This might throw!
+
+    if (memberXP >= 100) {
+      levelUpMember(interaction.member.id)
+      await interaction.reply("Level up!")
+    } else {
+      throwUserError("You don't have enough XP to level up!")
+    }
+  },
+}
 ```
 
-- `T` can be one of `TextChannel | VoiceChannel | NewsChannel | StageChannel | CategoryChannel`.
-- `channelType` is a discord.js `ChannelType`. Can be one of `GuildText | GuildVoice | GuildNews | GuildStageVoice | GuildCategory` (prepended with `ChannelType`).
-- It is intended that you pass in a type for `T` that matches `channelType`. The returned channel is cast as whatever type is passed in.
-- For example:
+- Say `getMemberXP` throws because the underlying database call fails. The member that initiated the command will get a response with the error message and stack trace (which they can then send to you so you can debug the error).
+- If the member doesn't have enough XP, they will receive the message about not having enough XP (no stack trace).
 
-```
-const someTextChannel = await getChannel<TextChannel>('some-text-channel', ChannelType.GuildText)
-```
+**This means that you should generally _not_ try to catch/handle errors in your commands and let it be handled by the bot.**
 
----
+### Events
 
-#### Channel Type Guards
+For events, all errors are caught and logged with `console.error`.
 
-These are channel type guards that you may need to use.
+## Utilities
 
-```
-function isTextChannel(channel: BaseChannel | APIPartialChannel): channel is TextChannel
-```
+### getChannel
 
-```
-function isCategoryChannel(channel: BaseChannel): channel is CategoryChannel
+Returns the guild channel of the given name/ID and type, otherwise throws.
+
+```ts
+import { getChannel } from "discord-bot-shared"
+import { ChannelType } from "discord.js"
+
+// guild is of type Guild from discord.js
+const someTextChannel = await getChannel(guild, "some-text-channel", ChannelType.GuildText)
 ```
 
-- Almost every channel type in discord.js extends `BaseChannel`, so you should be able to pass in whatever channel you need to here.
+Getting a properly typed channel with discord.js can be a bit of a pain, so this is an alternative.

package/dist/bot.js

@@ -1,6 +1,6 @@
 import { Client, Events, REST } from "discord.js";
-import CommandManager from "./command-manager.js";
-import EventManager from "./event-manager.js";
+import { CommandManager } from "./command-manager.js";
+import { EventManager } from "./event-manager.js";
 class Bot {
     #discord;
     commands;
@@ -24,5 +24,5 @@ class Bot {
         await this.#discord.client.login(this.#discord.token);
     }
 }
-export default Bot;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYm90LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2JvdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsTUFBTSxFQUFpQixNQUFNLEVBQUUsSUFBSSxFQUFFLE1BQU0sWUFBWSxDQUFBO0FBQ2hFLE9BQU8sY0FBYyxNQUFNLHNCQUFzQixDQUFBO0FBQ2pELE9BQU8sWUFBWSxNQUFNLG9CQUFvQixDQUFBO0FBZTdDLE1BQU0sR0FBRztJQUNQLFFBQVEsQ0FBZ0I7SUFFZixRQUFRLENBQWdCO0lBQ3hCLE1BQU0sQ0FBYztJQUU3QixZQUFZLE9BQW1CO1FBQzdCLElBQUksQ0FBQyxRQUFRLEdBQUc7WUFDZCxhQUFhLEVBQUUsT0FBTyxDQUFDLGFBQWE7WUFDcEMsS0FBSyxFQUFFLE9BQU8sQ0FBQyxLQUFLO1lBQ3BCLE1BQU0sRUFBRSxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUMsYUFBYSxDQUFDO1lBQ3pDLElBQUksRUFBRSxJQUFJLElBQUksRUFBRSxDQUFDLFFBQVEsQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDO1NBQ3pDLENBQUE7UUFFRCxJQUFJLENBQUMsUUFBUSxHQUFHLElBQUksY0FBYyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQTtRQUNqRCxJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksWUFBWSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQTtJQUMvQyxDQUFDO0lBRUQsS0FBSyxDQUFDLEtBQUs7UUFDVCxJQUFJLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLFdBQVcsRUFBRSxHQUFHLEVBQUU7WUFDakQsT0FBTyxDQUFDLEdBQUcsQ0FBQyxrQkFBa0IsQ0FBQyxDQUFBO1FBQ2pDLENBQUMsQ0FBQyxDQUFBO1FBRUYsSUFBSSxDQUFDLFFBQVEsQ0FBQyxPQUFPLEVBQUUsQ0FBQTtRQUN2QixJQUFJLENBQUMsTUFBTSxDQUFDLE9BQU8sRUFBRSxDQUFBO1FBQ3JCLE1BQU0sSUFBSSxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLENBQUE7SUFDdkQsQ0FBQztDQUNGO0FBRUQsZUFBZSxHQUFHLENBQUEifQ==
+export { Bot };
+//# sourceMappingURL=bot.js.map

package/dist/bot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.js","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAsB,MAAM,YAAY,CAAA;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAejD,MAAM,GAAG;IACE,QAAQ,CAAgB;IAEjB,QAAQ,CAAgB;IACxB,MAAM,CAAc;IAEpC,YAAmB,OAAmB;QACpC,IAAI,CAAC,QAAQ,GAAG;YACd,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;YACzC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;SACzC,CAAA;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/C,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE;YACjD,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;QACjC,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAA;QACvB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;QACrB,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACvD,CAAC;CACF;AAED,OAAO,EAAE,GAAG,EAAE,CAAA"}

package/dist/command-manager.js

@@ -1,8 +1,8 @@
 import { Collection, Events, Routes, } from "discord.js";
-import { UserError } from "./util.js";
+import { throwUserError, UserError } from "./util.js";
 class CommandManager {
     #commands = new Collection();
-    #globalPreRunHook;
+    #globalCommandHook;
     #discord;
     constructor(discord) {
         this.#discord = discord;
@@ -13,24 +13,20 @@ class CommandManager {
     add(command) {
         this.#commands.set(command.command.name, command);
     }
-    setGlobalPreRunHook(hook) {
-        this.#globalPreRunHook = hook;
+    setGlobalCommandHook(commandHook) {
+        this.#globalCommandHook = commandHook;
     }
     async register() {
         const payload = this.#commands.map((c) => c.command);
         const route = Routes.applicationCommands(this.#discord.applicationId);
         await this.#discord.rest.put(route, { body: payload });
-        console.log(`Registered ${this.#commands.size} (/) commands.`);
+        console.log(`Registered ${this.#commands.size.toString()} (/) commands.`);
     }
     async unregisterGuildCommands() {
-        if (this.#discord.client.readyAt) {
-            await this._unregisterGuildCommands().catch(console.error);
-        }
-        else {
-            this.#discord.client.once(Events.ClientReady, async () => {
-                await this._unregisterGuildCommands().catch(console.error);
-            });
-        }
+        if (this.#discord.client.readyAt)
+            await this._unregisterGuildCommands();
+        else
+            this.#discord.client.once(Events.ClientReady, () => void this._unregisterGuildCommands());
     }
     async _unregisterGuildCommands() {
         let guilds;
@@ -41,11 +37,16 @@ class CommandManager {
             console.error("Unable to unregister guild commands. Failed to fetch guilds.");
             throw error;
         }
+        const unregisterPromises = [];
         for (const guild of guilds.values()) {
             const route = Routes.applicationGuildCommands(this.#discord.applicationId, guild.id);
-            await this.#discord.rest.put(route, { body: [] });
-            console.log(`Unregistered commands from guild: ${guild.name}`);
+            const unregisterGuildCommands = async () => {
+                await this.#discord.rest.put(route, { body: [] });
+                console.log(`Unregistered commands from guild: ${guild.name}`);
+            };
+            unregisterPromises.push(unregisterGuildCommands());
         }
+        await Promise.all(unregisterPromises);
     }
     async unregisterApplicationCommands() {
         const route = Routes.applicationCommands(this.#discord.applicationId);
@@ -53,7 +54,7 @@ class CommandManager {
         console.log("Unregistered application commands.");
     }
     _listen() {
-        this.#discord.client.on(Events.InteractionCreate, async (interaction) => {
+        const listen = async (interaction) => {
             if (!interaction.isChatInputCommand())
                 return;
             if (!interaction.guildId)
@@ -61,31 +62,32 @@ class CommandManager {
             if (!interaction.inCachedGuild())
                 await interaction.client.guilds.fetch(interaction.guildId).catch(console.error);
             if (!interaction.inCachedGuild()) {
-                this.interactionReply(interaction, "Guild is not cached. Try again.");
+                CommandManager.interactionReply(interaction, "Guild is not cached. Try again.");
                 return;
             }
             const command = this.#commands.get(interaction.commandName);
             if (!command) {
-                this.interactionReply(interaction, `Failed to get command with name: ${interaction.commandName}`);
+                CommandManager.interactionReply(interaction, `Failed to get command with name: ${interaction.commandName}`);
                 return;
             }
-            if (!(await this.checkRoles(command, interaction))) {
-                this.interactionReply(interaction, "You do not have one of the required roles to run this command.");
+            if (!(await CommandManager.checkRoles(command, interaction))) {
+                CommandManager.interactionReply(interaction, "You do not have one of the required roles to run this command.");
                 return;
             }
             try {
-                const shouldContinue = this.#globalPreRunHook ? await this.#globalPreRunHook(interaction) : true;
+                const shouldContinue = this.#globalCommandHook ? await this.#globalCommandHook(interaction) : true;
                 if (!shouldContinue)
-                    return;
+                    throwUserError("The global command hook returned false.");
                 await command.run(interaction);
             }
             catch (error) {
-                this.interactionReply(interaction, error);
+                CommandManager.interactionReply(interaction, error);
             }
-        });
+        };
+        this.#discord.client.on(Events.InteractionCreate, (interaction) => void listen(interaction));
         console.log("Listening for commands.");
     }
-    async checkRoles(command, interaction) {
+    static async checkRoles(command, interaction) {
         if (!command.requiredRoles)
             return true;
         if (command.requiredRoles.length > 0) {
@@ -96,8 +98,8 @@ class CommandManager {
         }
         return false;
     }
-    interactionReply(interaction, error) {
-        let errorMessage = "";
+    static interactionReply(interaction, error) {
+        let errorMessage;
         if (error instanceof UserError)
             errorMessage = error.message;
         else if (error instanceof Error && error.stack)
@@ -105,10 +107,13 @@ class CommandManager {
         else
             errorMessage = String(error);
         const message = `There was an error while running this command.\n\`\`\`${errorMessage}\`\`\``;
-        interaction.deferred
-            ? void interaction.editReply(message).catch(console.error)
-            : void interaction.reply({ content: message, ephemeral: true }).catch(console.error);
+        const handleInteractionReply = async () => {
+            await (interaction.deferred
+                ? interaction.editReply(message).catch(console.error)
+                : interaction.reply({ content: message, ephemeral: true }).catch(console.error));
+        };
+        void handleInteractionReply();
     }
 }
-export default CommandManager;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tbWFuZC1tYW5hZ2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbW1hbmQtbWFuYWdlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBRUwsVUFBVSxFQUNWLE1BQU0sRUFFTixNQUFNLEdBQ1AsTUFBTSxZQUFZLENBQUE7QUFFbkIsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLFdBQVcsQ0FBQTtBQVVyQyxNQUFNLGNBQWM7SUFDbEIsU0FBUyxHQUFHLElBQUksVUFBVSxFQUFtQixDQUFBO0lBQzdDLGlCQUFpQixDQUFjO0lBQy9CLFFBQVEsQ0FBZ0I7SUFFeEIsWUFBWSxPQUF1QjtRQUNqQyxJQUFJLENBQUMsUUFBUSxHQUFHLE9BQU8sQ0FBQTtJQUN6QixDQUFDO0lBRUQ7O09BRUc7SUFDSCxHQUFHLENBQUMsT0FBZ0I7UUFDbEIsSUFBSSxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUUsT0FBTyxDQUFDLENBQUE7SUFDbkQsQ0FBQztJQUVELG1CQUFtQixDQUFDLElBQWlCO1FBQ25DLElBQUksQ0FBQyxpQkFBaUIsR0FBRyxJQUFJLENBQUE7SUFDL0IsQ0FBQztJQUVELEtBQUssQ0FBQyxRQUFRO1FBQ1osTUFBTSxPQUFPLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQTtRQUNwRCxNQUFNLEtBQUssR0FBRyxNQUFNLENBQUMsbUJBQW1CLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxhQUFhLENBQUMsQ0FBQTtRQUNyRSxNQUFNLElBQUksQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxLQUFLLEVBQUUsRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFLENBQUMsQ0FBQTtRQUV0RCxPQUFPLENBQUMsR0FBRyxDQUFDLGNBQWMsSUFBSSxD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
+export { CommandManager };
+//# sourceMappingURL=command-manager.js.map

package/dist/command-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-manager.js","sourceRoot":"","sources":["../src/command-manager.ts"],"names":[],"mappings":"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"}

package/dist/event-manager.js

@@ -12,12 +12,20 @@ class EventManager {
     }
     _listen() {
         for (const event of this.#events) {
-            this.#discord.client.on(event.event, async (...args) => {
-                await event.handler(this.#discord.client, ...args).catch(console.error);
-            });
+            const listen = async (...args) => {
+                try {
+                    // TS Error: Expression produces a union type that is too complex to represent.
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+                    await event.handler(this.#discord.client, ...args);
+                }
+                catch (error) {
+                    console.error(error);
+                }
+            };
+            this.#discord.client.on(event.event, (...args) => void listen(...args));
         }
-        console.log(`Listening for (${this.#events.length}) events.`);
+        console.log(`Listening for (${this.#events.length.toString()}) events.`);
     }
 }
-export default EventManager;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXZlbnQtbWFuYWdlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9ldmVudC1tYW5hZ2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQWdCQSxNQUFNLFlBQVk7SUFDaEIsT0FBTyxHQUFrQixFQUFFLENBQUE7SUFDM0IsUUFBUSxDQUFnQjtJQUV4QixZQUFZLE9BQXVCO1FBQ2pDLElBQUksQ0FBQyxRQUFRLEdBQUcsT0FBTyxDQUFBO0lBQ3pCLENBQUM7SUFFRDs7T0FFRztJQUNILEdBQUcsQ0FBd0IsS0FBcUI7UUFDOUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUE7SUFDMUIsQ0FBQztJQUVELE9BQU87UUFDTCxLQUFLLE1BQU0sS0FBSyxJQUFJLElBQUksQ0FBQyxPQUFPLEVBQUU7WUFDaEMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxLQUFLLEVBQUUsS0FBSyxFQUFFLEdBQUcsSUFBSSxFQUFFLEVBQUU7Z0JBQ3JELE1BQU8sS0FBSyxDQUFDLE9BQXdCLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxNQUFNLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFBO1lBQzNGLENBQUMsQ0FBQyxDQUFBO1NBQ0g7UUFDRCxPQUFPLENBQUMsR0FBRyxDQUFDLGtCQUFrQixJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU0sV0FBVyxDQUFDLENBQUE7SUFDL0QsQ0FBQztDQUNGO0FBTUQsZUFBZSxZQUFZLENBQUEifQ==
+export { EventManager };
+//# sourceMappingURL=event-manager.js.map

package/dist/event-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-manager.js","sourceRoot":"","sources":["../src/event-manager.ts"],"names":[],"mappings":"AAoBA,MAAM,YAAY;IACP,OAAO,GAAkB,EAAE,CAAA;IAC3B,QAAQ,CAAgB;IAEjC,YAAmB,OAAuB;QACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;IACzB,CAAC;IAED;;OAEG;IACI,GAAG,CAAwB,KAAqB;QACrD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;IAEM,OAAO;QACZ,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,KAAK,EAAE,GAAG,IAAsC,EAAE,EAAE;gBACjE,IAAI,CAAC;oBACH,+EAA+E;oBAC/E,uEAAuE;oBACvE,MAAO,KAAK,CAAC,OAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAA;gBACtE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;gBACtB,CAAC;YACH,CAAC,CAAA;YAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;QACzE,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IAC1E,CAAC;CACF;AAMD,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/index.js

@@ -1,3 +1,3 @@
-export { default } from "./bot.js";
+export { Bot } from "./bot.js";
 export { getChannel, throwError, throwUserError } from "./util.js";
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLFVBQVUsQ0FBQTtBQUdsQyxPQUFPLEVBQUUsVUFBVSxFQUFFLFVBQVUsRUFBRSxjQUFjLEVBQUUsTUFBTSxXQUFXLENBQUEifQ==
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAG9B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA"}

package/dist/types/bot.d.ts

@@ -1,6 +1,6 @@
-import { Client, ClientOptions, REST } from "discord.js";
-import CommandManager from "./command-manager.js";
-import EventManager from "./event-manager.js";
+import { Client, REST, type ClientOptions } from "discord.js";
+import { CommandManager } from "./command-manager.js";
+import { EventManager } from "./event-manager.js";
 interface BotOptions {
     applicationId: string;
     token: string;
@@ -19,5 +19,5 @@ declare class Bot {
     constructor(options: BotOptions);
     login(): Promise<void>;
 }
-export default Bot;
+export { Bot };
 export type { BotOptions, DiscordContext };

package/dist/types/command-manager.d.ts

@@ -1,23 +1,23 @@
-import { ChatInputCommandInteraction, RESTPostAPIChatInputApplicationCommandsJSONBody } from "discord.js";
-import { DiscordContext } from "./bot.js";
+import { type ChatInputCommandInteraction, type RESTPostAPIChatInputApplicationCommandsJSONBody } from "discord.js";
+import type { DiscordContext } from "./bot.js";
 interface Command {
     requiredRoles?: string[];
     command: RESTPostAPIChatInputApplicationCommandsJSONBody;
     run: (interaction: ChatInputCommandInteraction<"cached">) => void | Promise<void>;
 }
-type CommandHook = (interaction: ChatInputCommandInteraction<"cached">) => Promise<boolean>;
+type CommandHook = (interaction: ChatInputCommandInteraction<"cached">) => boolean | Promise<boolean>;
 declare class CommandManager {
     #private;
     constructor(discord: DiscordContext);
     add(command: Command): void;
-    setGlobalPreRunHook(hook: CommandHook): void;
+    setGlobalCommandHook(commandHook: CommandHook): void;
     register(): Promise<void>;
     unregisterGuildCommands(): Promise<void>;
     private _unregisterGuildCommands;
     unregisterApplicationCommands(): Promise<void>;
     _listen(): void;
-    private checkRoles;
-    private interactionReply;
+    private static checkRoles;
+    private static interactionReply;
 }
-export default CommandManager;
+export { CommandManager };
 export type { Command, CommandHook };

package/dist/types/event-manager.d.ts

@@ -1,7 +1,7 @@
-import { Client, ClientEvents, Events } from "discord.js";
-import { DiscordContext } from "./bot.js";
-type ValidEvents = Exclude<Events, Events.VoiceServerUpdate | Events.Raw>;
-type EventHandler<E extends ValidEvents = ValidEvents> = (client: Client, ...args: ClientEvents[E]) => Promise<void>;
+import type { Client, ClientEvents } from "discord.js";
+import type { DiscordContext } from "./bot.js";
+type ValidEvents = keyof ClientEvents;
+type EventHandler<E extends ValidEvents = ValidEvents> = (client: Client, ...args: ClientEvents[E]) => void | Promise<void>;
 type EventHandlerMap = {
     [E in ValidEvents]: EventHandler<E>;
 };
@@ -18,5 +18,5 @@ declare class EventManager {
 type Event = {
     [E in ValidEvents]: SingleEvent<E>;
 }[ValidEvents];
-export default EventManager;
+export { EventManager };
 export type { Event };

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { default } from "./bot.js";
+export { Bot } from "./bot.js";
 export type { Command, CommandHook } from "./command-manager.js";
 export type { Event } from "./event-manager.js";
 export { getChannel, throwError, throwUserError } from "./util.js";

package/dist/types/util.d.ts

@@ -1,4 +1,4 @@
-import { CategoryChannel, ChannelType, ForumChannel, Guild, NewsChannel, StageChannel, TextChannel, VoiceChannel } from "discord.js";
+import type { CategoryChannel, ChannelType, ForumChannel, Guild, NewsChannel, StageChannel, TextChannel, VoiceChannel } from "discord.js";
 interface ChannelTypeToChannelMap {
     [ChannelType.GuildCategory]: CategoryChannel;
     [ChannelType.GuildAnnouncement]: NewsChannel;
@@ -7,9 +7,39 @@ interface ChannelTypeToChannelMap {
     [ChannelType.GuildVoice]: VoiceChannel;
     [ChannelType.GuildForum]: ForumChannel;
 }
+/**
+ * Returns the guild channel of the given name/ID and type, otherwise throws.
+ *
+ * @param guild The Guild to fetch the channel from
+ * @param channelNameOrId The name or ID of the channel to fetch
+ * @param channelType The type of channel to fetch
+ * @returns The channel of the given name/ID and type
+ * @example
+ * ```ts
+ * import { getChannel } from "discord-bot-shared"
+ * import { ChannelType } from "discord.js"
+ *
+ * // guild is of type Guild from discord.js
+ * const someTextChannel = await getChannel(guild, "some-text-channel", ChannelType.GuildText)
+ * ```
+ *
+ * Getting a properly typed channel with discord.js can be a bit of a pain, so this is an alternative.
+ */
 declare function getChannel<T extends keyof ChannelTypeToChannelMap>(guild: Guild, channelNameOrId: string, channelType: T): Promise<ChannelTypeToChannelMap[T]>;
-declare function throwError(error: string): never;
-declare function throwUserError(error: string): never;
+/**
+ * Throws an error with the given message.
+ *
+ * @param message The message to throw
+ * @throws Error
+ */
+declare function throwError(message: string): never;
+/**
+ * Throws a UserError with the given message.
+ *
+ * @param message The message to throw
+ * @throws UserError
+ */
+declare function throwUserError(message: string): never;
 declare class UserError extends Error {
     constructor(message: string);
 }

package/dist/util.js

@@ -1,27 +1,58 @@
-import { ChannelType, } from "discord.js";
+/**
+ * Returns the guild channel of the given name/ID and type, otherwise throws.
+ *
+ * @param guild The Guild to fetch the channel from
+ * @param channelNameOrId The name or ID of the channel to fetch
+ * @param channelType The type of channel to fetch
+ * @returns The channel of the given name/ID and type
+ * @example
+ * ```ts
+ * import { getChannel } from "discord-bot-shared"
+ * import { ChannelType } from "discord.js"
+ *
+ * // guild is of type Guild from discord.js
+ * const someTextChannel = await getChannel(guild, "some-text-channel", ChannelType.GuildText)
+ * ```
+ *
+ * Getting a properly typed channel with discord.js can be a bit of a pain, so this is an alternative.
+ */
 async function getChannel(guild, channelNameOrId, channelType) {
     const channels = await guild.channels.fetch();
     let channel;
-    channel = channels.find((channel) => (channel ? channel.name === channelNameOrId : false));
+    channel = channels.find((chan) => (chan ? chan.name === channelNameOrId : false));
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
     if (channel && channel.type === channelType)
         return channel;
     channel = channels.get(channelNameOrId);
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
     if (channel && channel.type === channelType)
         return channel;
     throwError(`Failed to get channel: ${channelNameOrId}`);
 }
-function throwError(error) {
-    throw new Error(error);
+/**
+ * Throws an error with the given message.
+ *
+ * @param message The message to throw
+ * @throws Error
+ */
+function throwError(message) {
+    throw new Error(message);
 }
-function throwUserError(error) {
-    throw new UserError(error);
+/**
+ * Throws a UserError with the given message.
+ *
+ * @param message The message to throw
+ * @throws UserError
+ */
+function throwUserError(message) {
+    throw new UserError(message);
 }
 class UserError extends Error {
     constructor(message) {
         super(message);
-        this.name = this.constructor.name;
+        this.name = "UserError";
         Object.setPrototypeOf(this, new.target.prototype);
     }
 }
 export { UserError, getChannel, throwError, throwUserError };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy91dGlsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFFTCxXQUFXLEdBUVosTUFBTSxZQUFZLENBQUE7QUFXbkIsS0FBSyxVQUFVLFVBQVUsQ0FDdkIsS0FBWSxFQUNaLGVBQXVCLEVBQ3ZCLFdBQWM7SUFFZCxNQUFNLFFBQVEsR0FBRyxNQUFNLEtBQUssQ0FBQyxRQUFRLENBQUMsS0FBSyxFQUFFLENBQUE7SUFFN0MsSUFBSSxPQUFzRCxDQUFBO0lBQzFELE9BQU8sR0FBRyxRQUFRLENBQUMsSUFBSSxDQUFDLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLElBQUksS0FBSyxlQUFlLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUE7SUFDMUYsSUFBSSxPQUFPLElBQUksT0FBTyxDQUFDLElBQUksS0FBSyxXQUFXO1FBQUUsT0FBTyxPQUFxQyxDQUFBO0lBRXpGLE9BQU8sR0FBRyxRQUFRLENBQUMsR0FBRyxDQUFDLGVBQWUsQ0FBQyxDQUFBO0lBQ3ZDLElBQUksT0FBTyxJQUFJLE9BQU8sQ0FBQyxJQUFJLEtBQUssV0FBVztRQUFFLE9BQU8sT0FBcUMsQ0FBQTtJQUV6RixVQUFVLENBQUMsMEJBQTBCLGVBQWUsRUFBRSxDQUFDLENBQUE7QUFDekQsQ0FBQztBQUVELFNBQVMsVUFBVSxDQUFDLEtBQWE7SUFDL0IsTUFBTSxJQUFJLEtBQUssQ0FBQyxLQUFLLENBQUMsQ0FBQTtBQUN4QixDQUFDO0FBRUQsU0FBUyxjQUFjLENBQUMsS0FBYTtJQUNuQyxNQUFNLElBQUksU0FBUyxDQUFDLEtBQUssQ0FBQyxDQUFBO0FBQzVCLENBQUM7QUFFRCxNQUFNLFNBQVUsU0FBUSxLQUFLO0lBQzNCLFlBQVksT0FBZTtRQUN6QixLQUFLLENBQUMsT0FBTyxDQUFDLENBQUE7UUFDZCxJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQyxXQUFXLENBQUMsSUFBSSxDQUFBO1FBRWpDLE1BQU0sQ0FBQyxjQUFjLENBQUMsSUFBSSxFQUFFLEdBQUcsQ0FBQyxNQUFNLENBQUMsU0FBUyxDQUFDLENBQUE7SUFDbkQsQ0FBQztDQUNGO0FBRUQsT0FBTyxFQUFFLFNBQVMsRUFBRSxVQUFVLEVBQUUsVUFBVSxFQUFFLGNBQWMsRUFBRSxDQUFBIn0=
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;;GAiBG;AACH,KAAK,UAAU,UAAU,CACvB,KAAY,EACZ,eAAuB,EACvB,WAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;IAE7C,IAAI,OAAsD,CAAA;IAC1D,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IACjF,uEAAuE;IACvE,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,OAAqC,CAAA;IAEzF,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;IACvC,uEAAuE;IACvE,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,OAAqC,CAAA;IAEzF,UAAU,CAAC,0BAA0B,eAAe,EAAE,CAAC,CAAA;AACzD,CAAC;AAED;;;;;GAKG;AACH,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;AAC1B,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,IAAI,SAAS,CAAC,OAAO,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,SAAU,SAAQ,KAAK;IAC3B,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;QAEvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACnD,CAAC;CACF;AAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,CAAA"}

package/package.json

@@ -1,40 +1,47 @@
 {
   "name": "discord-bot-shared",
-  "version": "0.13.0",
+  "version": "0.14.1",
   "type": "module",
   "description": "Modules for creating discord bots.",
-  "repository": "github:adamhl8/discord-bot-shared",
-  "author": "adamhl8",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adamhl8/discord-bot-shared"
+  },
+  "homepage": "https://github.com/adamhl8/discord-bot-shared",
+  "bugs": {
+    "url": "https://github.com/adamhl8/discord-bot-shared/issues"
+  },
+  "author": {
+    "email": "adamhl@pm.me",
+    "name": "Adam Langbert",
+    "url": "https://github.com/adamhl8"
+  },
   "license": "MIT",
-  "main": "dist/index.js",
-  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
   "files": [
-    "dist/",
-    "README.md",
-    "LICENSE"
+    "dist/"
   ],
+  "scripts": {
+    "bundle": "bun lint && rm -rf ./dist && tsc -p ./tsconfig.build.json",
+    "lint": "tsc --noEmit && prettier --write . && eslint .",
+    "prepare": "find .githooks -type f -exec ln -srf {} .git/hooks/ \\;",
+    "prepublish": "bun bundle"
+  },
   "peerDependencies": {
     "discord.js": "^14.0.0"
   },
   "devDependencies": {
-    "@types/node": "^20.6.2",
-    "@typescript-eslint/eslint-plugin": "^6.7.0",
-    "@typescript-eslint/parser": "^6.7.0",
-    "discord.js": "^14.13.0",
-    "eslint": "^8.49.0",
-    "eslint-config-prettier": "^9.0.0",
-    "eslint-plugin-sonarjs": "^0.21.0",
-    "eslint-plugin-unicorn": "^48.0.1",
-    "prettier": "^3.0.3",
-    "prettier-plugin-organize-imports": "^3.2.3",
-    "prettier-plugin-pkg": "^0.18.0",
-    "prettier-plugin-sh": "^0.13.1",
-    "typescript": "^5.2.2"
-  },
-  "scripts": {
-    "build": "rm -rf dist && tsc",
-    "format": "prettier --write .",
-    "lint": "eslint ./src/",
-    "prepublish": "pnpm build"
+    "@types/bun": "^1.2.17",
+    "discord.js": "^14.20.0",
+    "eslint": "^9.29.0",
+    "eslint-config-builder": "^0.21.2",
+    "prettier": "^3.6.1",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.35.0"
   }
-}
+}