discord-bot-shared 0.3.3 → 0.4.1

package/README.md

@@ -78,6 +78,10 @@ Your `run` function is passed the command interaction that initiated the command
 
 The following functions and interfaces/types are exported by this module:
 
+---
+
+#### `function login`
+
 ```
 async function login(
   botIntents: ClientOptions,
@@ -93,13 +97,14 @@ async function login(
 
 ---
 
+#### `function getGuildCache`
+
 Returns an object that contains the guild and the following freshly fetched guild collections: `channels, emojis, members, roles`.
 
 ```
-async function getGuildCache(baseGuild?: Guild)
+async function getGuildCache()
 ```
 
-- Optionally provide a Guild to retrieve the caches from. Otherwise, the first guild on the bot is used.
 - For example, a common pattern I use is something like this:
 
 ```
@@ -109,6 +114,8 @@ const { members } = await getGuildCache()
 
 ---
 
+#### `interface Command`
+
 This interface defines the structure of your bot's commands. See above for an example of a command.
 
 ```
@@ -125,7 +132,31 @@ interface Command {
 
 ---
 
-These are type guards that you will likely need to use.
+#### `function getChannelByName`
+
+Returns a guild channel of the given name and type, otherwise returns `undefined`.
+
+```
+async function getChannelByName<T extends NonThreadGuildBasedChannel>(
+  channelName: string,
+  channelType: NonThreadGuildBasedChannelType,
+): Promise<T | undefined>
+```
+
+- `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:
+
+```
+const someTextChannel = await getChannelByName<TextChannel>('some-text-channel', ChannelType.GuildText)
+```
+
+---
+
+#### Channel Type Guards
+
+These are channel type guards that you may need to use.
 
 ```
 function isTextChannel(channel: BaseChannel | APIPartialChannel): channel is TextChannel

package/dist/commands.d.ts

@@ -1,10 +1,10 @@
-import { ChatInputCommandInteraction, Collection, SlashCommandBuilder } from 'discord.js';
+import { ChatInputCommandInteraction, Collection, SlashCommandBuilder } from 'discord.js'
 interface Command {
-    requiredRoles?: string[];
-    command: SlashCommandBuilder;
-    run: (interaction: ChatInputCommandInteraction) => void | Promise<void>;
+  requiredRoles?: string[]
+  command: SlashCommandBuilder
+  run: (interaction: ChatInputCommandInteraction) => void | Promise<void>
 }
-declare type CommandsCollection = Collection<string, Command>;
-declare function registerCommands(botToken: string, clientId: string, projectMetaURL: string, guildId?: string): Promise<CommandsCollection>;
-export default registerCommands;
-export { Command, CommandsCollection };
+declare type CommandsCollection = Collection<string, Command>
+declare function registerCommands(botToken: string, clientId: string, projectMetaURL: string, guildId?: string): Promise<CommandsCollection>
+export default registerCommands
+export { Command, CommandsCollection }

package/dist/commands.js

@@ -1,26 +1,25 @@
-import { REST } from '@discordjs/rest';
-import { Routes } from 'discord-api-types/v10';
-import { Collection } from 'discord.js';
-import { readdir } from 'node:fs/promises';
-import { fileURLToPath } from 'node:url';
+import { REST } from '@discordjs/rest'
+import { Routes } from 'discord-api-types/v10'
+import { Collection } from 'discord.js'
+import { readdir } from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
 async function registerCommands(botToken, clientId, projectMetaURL, guildId) {
-    const commands = new Collection();
-    const commandData = [];
-    const commandsDirectory = fileURLToPath(new URL('commands', projectMetaURL));
-    const commandFiles = await readdir(commandsDirectory);
-    if (!commandFiles)
-        return commands;
-    for (const file of commandFiles) {
-        const { default: command } = (await import(`${commandsDirectory}/${file}`));
-        commands.set(command.command.name, command);
-        commandData.push(command.command.toJSON());
-    }
-    const rest = new REST().setToken(botToken);
-    guildId
-        ? await rest.put(Routes.applicationGuildCommands(clientId, guildId), { body: commandData })
-        : await rest.put(Routes.applicationCommands(clientId), { body: commandData });
-    console.log('Registered application (/) commands.');
-    return commands;
+  const commands = new Collection()
+  const commandData = []
+  const commandsDirectory = fileURLToPath(new URL('commands', projectMetaURL))
+  const commandFiles = await readdir(commandsDirectory)
+  if (!commandFiles) return commands
+  for (const file of commandFiles) {
+    const { default: command } = await import(`${commandsDirectory}/${file}`)
+    commands.set(command.command.name, command)
+    commandData.push(command.command.toJSON())
+  }
+  const rest = new REST().setToken(botToken)
+  guildId
+    ? await rest.put(Routes.applicationGuildCommands(clientId, guildId), { body: commandData })
+    : await rest.put(Routes.applicationCommands(clientId), { body: commandData })
+  console.log('Registered application (/) commands.')
+  return commands
 }
-export default registerCommands;
-//# sourceMappingURL=commands.js.map
+export default registerCommands
+//# sourceMappingURL=commands.js.map

package/dist/events.d.ts

@@ -1,2 +1,2 @@
-declare function registerEvents(projectMetaURL: string): Promise<void>;
-export default registerEvents;
+declare function registerEvents(projectMetaURL: string): Promise<void>
+export default registerEvents

package/dist/events.js

@@ -1,13 +1,12 @@
-import { readdir } from 'node:fs/promises';
-import { fileURLToPath } from 'node:url';
+import { readdir } from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
 async function registerEvents(projectMetaURL) {
-    const eventsDirectory = fileURLToPath(new URL('events', projectMetaURL));
-    const eventFiles = await readdir(eventsDirectory).catch(console.error);
-    if (!eventFiles)
-        return;
-    for (const file of eventFiles) {
-        await import(`${eventsDirectory}/${file}`);
-    }
+  const eventsDirectory = fileURLToPath(new URL('events', projectMetaURL))
+  const eventFiles = await readdir(eventsDirectory).catch(console.error)
+  if (!eventFiles) return
+  for (const file of eventFiles) {
+    await import(`${eventsDirectory}/${file}`)
+  }
 }
-export default registerEvents;
-//# sourceMappingURL=events.js.map
+export default registerEvents
+//# sourceMappingURL=events.js.map

package/dist/guildCache.d.ts

@@ -1,11 +1,14 @@
-import { Client, Guild } from 'discord.js';
-declare function setBot(botClient: Client): void;
-declare function getGuildCache(baseGuild?: Guild): Promise<{
-    guild: Guild;
-    channels: import("discord.js").Collection<string, import("discord.js").NonThreadGuildBasedChannel>;
-    emojis: import("discord.js").Collection<string, import("discord.js").GuildEmoji>;
-    members: import("discord.js").Collection<string, import("discord.js").GuildMember>;
-    roles: import("discord.js").Collection<string, import("discord.js").Role>;
-} | undefined>;
-export default getGuildCache;
-export { setBot };
+import { Client } from 'discord.js'
+declare function setBot(botClient: Client): void
+declare function getGuildCache(): Promise<
+  | {
+      guild: import('discord.js').Guild
+      channels: import('discord.js').Collection<string, import('discord.js').NonThreadGuildBasedChannel>
+      emojis: import('discord.js').Collection<string, import('discord.js').GuildEmoji>
+      members: import('discord.js').Collection<string, import('discord.js').GuildMember>
+      roles: import('discord.js').Collection<string, import('discord.js').Role>
+    }
+  | undefined
+>
+export default getGuildCache
+export { setBot }

package/dist/guildCache.js

@@ -1,36 +1,29 @@
-let bot;
+let bot
 function setBot(botClient) {
-    bot = botClient;
+  bot = botClient
 }
-async function getGuildCache(baseGuild) {
-    if (!bot)
-        return;
-    const guilds = await bot.guilds.fetch();
-    if (!guilds)
-        return;
-    const guild = baseGuild ? await baseGuild.fetch() : await guilds.first()?.fetch();
-    if (!guild)
-        return;
-    const channels = await guild.channels.fetch();
-    if (!channels)
-        return;
-    const emojis = await guild.emojis.fetch();
-    if (!emojis)
-        return;
-    const members = await guild.members.fetch();
-    if (!members)
-        return;
-    const roles = await guild.roles.fetch();
-    if (!roles)
-        return;
-    return {
-        guild,
-        channels,
-        emojis,
-        members,
-        roles,
-    };
+async function getGuildCache() {
+  if (!bot) return
+  const guilds = await bot.guilds.fetch()
+  if (!guilds) return
+  const guild = await guilds.first()?.fetch()
+  if (!guild) return
+  const channels = await guild.channels.fetch()
+  if (!channels) return
+  const emojis = await guild.emojis.fetch()
+  if (!emojis) return
+  const members = await guild.members.fetch()
+  if (!members) return
+  const roles = await guild.roles.fetch()
+  if (!roles) return
+  return {
+    guild,
+    channels,
+    emojis,
+    members,
+    roles,
+  }
 }
-export default getGuildCache;
-export { setBot };
-//# sourceMappingURL=guildCache.js.map
+export default getGuildCache
+export { setBot }
+//# sourceMappingURL=guildCache.js.map

package/dist/guildCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"guildCache.js","sourceRoot":"","sources":["../src/guildCache.ts"],"names":[],"mappings":"AAEA,IAAI,GAAW,CAAA;AAEf,SAAS,MAAM,CAAC,SAAiB;IAC/B,GAAG,GAAG,SAAS,CAAA;AACjB,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,SAAiB;IAC5C,IAAI,CAAC,GAAG;QAAE,OAAM;IAEhB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACvC,IAAI,CAAC,MAAM;QAAE,OAAM;IACnB,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAA;IACjF,IAAI,CAAC,KAAK;QAAE,OAAM;IAElB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;IAC7C,IAAI,CAAC,QAAQ;QAAE,OAAM;IAErB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACzC,IAAI,CAAC,MAAM;QAAE,OAAM;IAEnB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IAC3C,IAAI,CAAC,OAAO;QAAE,OAAM;IAEpB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACvC,IAAI,CAAC,KAAK;QAAE,OAAM;IAElB,OAAO;QACL,KAAK;QACL,QAAQ;QACR,MAAM;QACN,OAAO;QACP,KAAK;KACN,CAAA;AACH,CAAC;AAED,eAAe,aAAa,CAAA;AAC5B,OAAO,EAAE,MAAM,EAAE,CAAA"}
+{"version":3,"file":"guildCache.js","sourceRoot":"","sources":["../src/guildCache.ts"],"names":[],"mappings":"AAEA,IAAI,GAAW,CAAA;AAEf,SAAS,MAAM,CAAC,SAAiB;IAC/B,GAAG,GAAG,SAAS,CAAA;AACjB,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,IAAI,CAAC,GAAG;QAAE,OAAM;IAEhB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACvC,IAAI,CAAC,MAAM;QAAE,OAAM;IACnB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAA;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAM;IAElB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;IAC7C,IAAI,CAAC,QAAQ;QAAE,OAAM;IAErB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACzC,IAAI,CAAC,MAAM;QAAE,OAAM;IAEnB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IAC3C,IAAI,CAAC,OAAO;QAAE,OAAM;IAEpB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACvC,IAAI,CAAC,KAAK;QAAE,OAAM;IAElB,OAAO;QACL,KAAK;QACL,QAAQ;QACR,MAAM;QACN,OAAO;QACP,KAAK;KACN,CAAA;AACH,CAAC;AAED,eAAe,aAAa,CAAA;AAC5B,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { Client, ClientOptions } from 'discord.js';
-import { InteractionCheck } from './interactionCreate.js';
-declare function login(botIntents: ClientOptions, projectMetaURL: string, interactionCheck?: InteractionCheck): Promise<Client>;
-export default login;
-export { Command } from './commands.js';
-export { default as getGuildCache } from './guildCache.js';
-export { InteractionCheck } from './interactionCreate.js';
-export { isCategoryChannel, isTextChannel, throwError } from './util.js';
+import { Client, ClientOptions } from 'discord.js'
+import { InteractionCheck } from './interactionCreate.js'
+declare function login(botIntents: ClientOptions, projectMetaURL: string, interactionCheck?: InteractionCheck): Promise<Client>
+export default login
+export { Command } from './commands.js'
+export { default as getGuildCache } from './guildCache.js'
+export { InteractionCheck } from './interactionCreate.js'
+export { getChannelByName, isCategoryChannel, isTextChannel, throwError } from './util.js'

package/dist/index.js

@@ -1,23 +1,23 @@
-import { Client } from 'discord.js';
-import registerCommands from './commands.js';
-import registerEvents from './events.js';
-import { setBot } from './guildCache.js';
-import registerInteractionCreate from './interactionCreate.js';
-import registerReady from './ready.js';
-const botToken = process.env.BOT_TOKEN || '';
-const clientId = process.env.CLIENT_ID || '';
-const guildId = process.env.GUILD_ID || '';
+import { Client } from 'discord.js'
+import registerCommands from './commands.js'
+import registerEvents from './events.js'
+import { setBot } from './guildCache.js'
+import registerInteractionCreate from './interactionCreate.js'
+import registerReady from './ready.js'
+const botToken = process.env.BOT_TOKEN || ''
+const clientId = process.env.CLIENT_ID || ''
+const guildId = process.env.GUILD_ID || ''
 async function login(botIntents, projectMetaURL, interactionCheck) {
-    const bot = new Client(botIntents);
-    const commands = await registerCommands(botToken, clientId, projectMetaURL, guildId);
-    registerReady(bot);
-    registerInteractionCreate(bot, commands, interactionCheck);
-    void registerEvents(projectMetaURL);
-    setBot(bot);
-    void bot.login(botToken);
-    return bot;
+  const bot = new Client(botIntents)
+  const commands = await registerCommands(botToken, clientId, projectMetaURL, guildId)
+  registerReady(bot)
+  registerInteractionCreate(bot, commands, interactionCheck)
+  void registerEvents(projectMetaURL)
+  setBot(bot)
+  void bot.login(botToken)
+  return bot
 }
-export default login;
-export { default as getGuildCache } from './guildCache.js';
-export { isCategoryChannel, isTextChannel, throwError } from './util.js';
-//# sourceMappingURL=index.js.map
+export default login
+export { default as getGuildCache } from './guildCache.js'
+export { getChannelByName, isCategoryChannel, isTextChannel, throwError } from './util.js'
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAA;AAClD,OAAO,gBAAgB,MAAM,eAAe,CAAA;AAC5C,OAAO,cAAc,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,yBAA+C,MAAM,wBAAwB,CAAA;AACpF,OAAO,aAAa,MAAM,YAAY,CAAA;AAEtC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAA;AAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAA;AAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAA;AAE1C,KAAK,UAAU,KAAK,CAClB,UAAyB,EACzB,cAAsB,EACtB,gBAAmC;IAEnC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,CAAA;IAClC,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,CAAA;IAEpF,aAAa,CAAC,GAAG,CAAC,CAAA;IAClB,yBAAyB,CAAC,GAAG,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAA;IAC1D,KAAK,cAAc,CAAC,cAAc,CAAC,CAAA;IAEnC,MAAM,CAAC,GAAG,CAAC,CAAA;IAEX,KAAK,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACxB,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,eAAe,KAAK,CAAA;AAEpB,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE1D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAA;AAClD,OAAO,gBAAgB,MAAM,eAAe,CAAA;AAC5C,OAAO,cAAc,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,yBAA+C,MAAM,wBAAwB,CAAA;AACpF,OAAO,aAAa,MAAM,YAAY,CAAA;AAEtC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAA;AAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAA;AAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAA;AAE1C,KAAK,UAAU,KAAK,CAAC,UAAyB,EAAE,cAAsB,EAAE,gBAAmC;IACzG,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,CAAA;IAClC,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,CAAA;IAEpF,aAAa,CAAC,GAAG,CAAC,CAAA;IAClB,yBAAyB,CAAC,GAAG,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAA;IAC1D,KAAK,cAAc,CAAC,cAAc,CAAC,CAAA;IAEnC,MAAM,CAAC,GAAG,CAAC,CAAA;IAEX,KAAK,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACxB,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,eAAe,KAAK,CAAA;AAEpB,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE1D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA"}

package/dist/interactionCreate.d.ts

@@ -1,6 +1,6 @@
-import { ChatInputCommandInteraction, Client } from 'discord.js';
-import { CommandsCollection } from './commands.js';
-declare type InteractionCheck = (interaction: ChatInputCommandInteraction) => Promise<boolean | void>;
-declare function registerInteractionCreate(bot: Client, commands: CommandsCollection, interactionCheck?: InteractionCheck): void;
-export default registerInteractionCreate;
-export { InteractionCheck };
+import { ChatInputCommandInteraction, Client } from 'discord.js'
+import { CommandsCollection } from './commands.js'
+declare type InteractionCheck = (interaction: ChatInputCommandInteraction) => Promise<boolean | void>
+declare function registerInteractionCreate(bot: Client, commands: CommandsCollection, interactionCheck?: InteractionCheck): void
+export default registerInteractionCreate
+export { InteractionCheck }

package/dist/interactionCreate.js

@@ -1,39 +1,33 @@
 function registerInteractionCreate(bot, commands, interactionCheck) {
-    bot.on('interactionCreate', async (interaction) => {
-        if (!interaction.isChatInputCommand())
-            return;
-        const command = commands.get(interaction.commandName);
-        if (!command)
-            return interactionReply(interaction, 'Unable to get command.');
-        if (!(await checkRoles(command, interaction)))
-            return interactionReply(interaction, 'You do not have one of the required roles to run this command.');
-        try {
-            const interactionCheckPassed = interactionCheck ? await interactionCheck(interaction) : true;
-            if (!interactionCheckPassed)
-                return;
-            await command.run(interaction);
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : '';
-            interactionReply(interaction, `There was an error while running this command.\n${errorMessage}`);
-        }
-    });
+  bot.on('interactionCreate', async (interaction) => {
+    if (!interaction.isChatInputCommand()) return
+    const command = commands.get(interaction.commandName)
+    if (!command) return interactionReply(interaction, 'Unable to get command.')
+    if (!(await checkRoles(command, interaction)))
+      return interactionReply(interaction, 'You do not have one of the required roles to run this command.')
+    try {
+      const interactionCheckPassed = interactionCheck ? await interactionCheck(interaction) : true
+      if (!interactionCheckPassed) return
+      await command.run(interaction)
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : ''
+      interactionReply(interaction, `There was an error while running this command.\n${errorMessage}`)
+    }
+  })
 }
 async function checkRoles(command, interaction) {
-    if (!command.requiredRoles)
-        return true;
-    if (command.requiredRoles.length > 0) {
-        const member = await interaction.guild?.members.fetch(interaction.user).catch(console.error);
-        if (!member)
-            return;
-        return member.roles.cache.some((role) => command.requiredRoles ? command.requiredRoles.includes(role.name) : false);
-    }
-    return false;
+  if (!command.requiredRoles) return true
+  if (command.requiredRoles.length > 0) {
+    const member = await interaction.guild?.members.fetch(interaction.user).catch(console.error)
+    if (!member) return
+    return member.roles.cache.some((role) => (command.requiredRoles ? command.requiredRoles.includes(role.name) : false))
+  }
+  return false
 }
 function interactionReply(interaction, message) {
-    interaction.deferred
-        ? void interaction.editReply(message).catch(console.error)
-        : void interaction.reply({ content: message, ephemeral: true }).catch(console.error);
+  interaction.deferred
+    ? void interaction.editReply(message).catch(console.error)
+    : void interaction.reply({ content: message, ephemeral: true }).catch(console.error)
 }
-export default registerInteractionCreate;
-//# sourceMappingURL=interactionCreate.js.map
+export default registerInteractionCreate
+//# sourceMappingURL=interactionCreate.js.map

package/dist/interactionCreate.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactionCreate.js","sourceRoot":"","sources":["../src/interactionCreate.ts"],"names":[],"mappings":"AAKA,SAAS,yBAAyB,CAAC,GAAW,EAAE,QAA4B,EAAE,gBAAmC;IAC/G,GAAG,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE;QAChD,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE;YAAE,OAAM;QAE7C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,CAAA;QACrD,IAAI,CAAC,OAAO;YAAE,OAAO,gBAAgB,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAA;QAE5E,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC3C,OAAO,gBAAgB,CAAC,WAAW,EAAE,gEAAgE,CAAC,CAAA;QAExG,IAAI;YACF,MAAM,sBAAsB,GAAG,gBAAgB,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YAC5F,IAAI,CAAC,sBAAsB;gBAAE,OAAM;YAEnC,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;SAC/B;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;YAChE,gBAAgB,CAAC,WAAW,EAAE,mDAAmD,YAAY,EAAE,CAAC,CAAA;SACjG;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAAgB,EAAE,WAAwC;IAClF,IAAI,CAAC,OAAO,CAAC,aAAa;QAAE,OAAO,IAAI,CAAA;IAEvC,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE;QACpC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC5F,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACtC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAC1E,CAAA;KACF;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAwC,EAAE,OAAe;IACjF,WAAW,CAAC,QAAQ;QAClB,CAAC,CAAC,KAAK,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC1D,CAAC,CAAC,KAAK,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AACxF,CAAC;AAED,eAAe,yBAAyB,CAAA"}
+{"version":3,"file":"interactionCreate.js","sourceRoot":"","sources":["../src/interactionCreate.ts"],"names":[],"mappings":"AAKA,SAAS,yBAAyB,CAAC,GAAW,EAAE,QAA4B,EAAE,gBAAmC;IAC/G,GAAG,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE;QAChD,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE;YAAE,OAAM;QAE7C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,CAAA;QACrD,IAAI,CAAC,OAAO;YAAE,OAAO,gBAAgB,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAA;QAE5E,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC3C,OAAO,gBAAgB,CAAC,WAAW,EAAE,gEAAgE,CAAC,CAAA;QAExG,IAAI;YACF,MAAM,sBAAsB,GAAG,gBAAgB,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YAC5F,IAAI,CAAC,sBAAsB;gBAAE,OAAM;YAEnC,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;SAC/B;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;YAChE,gBAAgB,CAAC,WAAW,EAAE,mDAAmD,YAAY,EAAE,CAAC,CAAA;SACjG;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAAgB,EAAE,WAAwC;IAClF,IAAI,CAAC,OAAO,CAAC,aAAa;QAAE,OAAO,IAAI,CAAA;IAEvC,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE;QACpC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC5F,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;KACtH;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAwC,EAAE,OAAe;IACjF,WAAW,CAAC,QAAQ;QAClB,CAAC,CAAC,KAAK,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC1D,CAAC,CAAC,KAAK,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AACxF,CAAC;AAED,eAAe,yBAAyB,CAAA"}

package/dist/ready.d.ts

@@ -1,3 +1,3 @@
-import { Client } from 'discord.js';
-declare function registerReady(bot: Client): void;
-export default registerReady;
+import { Client } from 'discord.js'
+declare function registerReady(bot: Client): void
+export default registerReady

package/dist/ready.js

@@ -1,7 +1,7 @@
 function registerReady(bot) {
-    bot.once('ready', () => {
-        console.log('I am ready!');
-    });
+  bot.once('ready', () => {
+    console.log('I am ready!')
+  })
 }
-export default registerReady;
-//# sourceMappingURL=ready.js.map
+export default registerReady
+//# sourceMappingURL=ready.js.map

package/dist/util.d.ts

@@ -1,5 +1,15 @@
-import { APIPartialChannel, BaseChannel, CategoryChannel, TextChannel } from 'discord.js';
-declare function isTextChannel(channel: BaseChannel | APIPartialChannel): channel is TextChannel;
-declare function isCategoryChannel(channel: BaseChannel): channel is CategoryChannel;
-declare function throwError(error: string): never;
-export { isTextChannel, isCategoryChannel, throwError };
+import { APIPartialChannel, BaseChannel, CategoryChannel, ChannelType, NonThreadGuildBasedChannel, TextChannel } from 'discord.js'
+declare type NonThreadGuildBasedChannelType =
+  | ChannelType.GuildText
+  | ChannelType.GuildVoice
+  | ChannelType.GuildNews
+  | ChannelType.GuildStageVoice
+  | ChannelType.GuildCategory
+declare function getChannelByName<T extends NonThreadGuildBasedChannel>(
+  channelName: string,
+  channelType: NonThreadGuildBasedChannelType,
+): Promise<T | undefined>
+declare function isTextChannel(channel: BaseChannel | APIPartialChannel): channel is TextChannel
+declare function isCategoryChannel(channel: BaseChannel): channel is CategoryChannel
+declare function throwError(error: string): never
+export { getChannelByName, isTextChannel, isCategoryChannel, throwError }

package/dist/util.js

@@ -1,12 +1,18 @@
-import { ChannelType } from 'discord.js';
+import { ChannelType } from 'discord.js'
+import getGuildCache from './guildCache.js'
+async function getChannelByName(channelName, channelType) {
+  const { channels } = (await getGuildCache()) || throwError('Unable to get guild cache.')
+  const channel = channels.find((channel) => channel.name === channelName)
+  return channel && channel.type === channelType ? channel : undefined
+}
 function isTextChannel(channel) {
-    return channel.type === ChannelType.GuildText;
+  return channel.type === ChannelType.GuildText
 }
 function isCategoryChannel(channel) {
-    return channel.type === ChannelType.GuildCategory;
+  return channel.type === ChannelType.GuildCategory
 }
 function throwError(error) {
-    throw new Error(error);
+  throw new Error(error)
 }
-export { isTextChannel, isCategoryChannel, throwError };
-//# sourceMappingURL=util.js.map
+export { getChannelByName, isTextChannel, isCategoryChannel, throwError }
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,WAAW,EAAe,MAAM,YAAY,CAAA;AAEtG,SAAS,aAAa,CAAC,OAAwC;IAC7D,OAAO,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,SAAS,CAAA;AAC/C,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAoB;IAC7C,OAAO,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,aAAa,CAAA;AACnD,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAA"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,WAAW,EAA2C,MAAM,YAAY,CAAA;AAClI,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAS3C,KAAK,UAAU,gBAAgB,CAC7B,WAAmB,EACnB,WAA2C;IAE3C,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,aAAa,EAAE,CAAC,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAA;IACxF,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,CAAA;IAExE,OAAO,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAE,OAAa,CAAC,CAAC,CAAC,SAAS,CAAA;AAC7E,CAAC;AAED,SAAS,aAAa,CAAC,OAAwC;IAC7D,OAAO,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,SAAS,CAAA;AAC/C,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAoB;IAC7C,OAAO,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,aAAa,CAAA;AACnD,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discord-bot-shared",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "type": "module",
   "description": "Modules for creating discord bots.",
   "repository": "github:adamhl8/discord-bot-shared",
@@ -19,24 +19,24 @@
   },
   "dependencies": {
     "@discordjs/rest": "^1.0.1",
-    "discord-api-types": "^0.37.1",
-    "discord.js": "^14.1.2"
+    "discord-api-types": "^0.37.3",
+    "discord.js": "^14.2.0"
   },
   "devDependencies": {
-    "@types/eslint": "^8.4.5",
-    "@types/node": "^18.6.5",
+    "@types/eslint": "^8.4.6",
+    "@types/node": "^18.7.9",
     "@types/prettier": "^2.7.0",
-    "@typescript-eslint/eslint-plugin": "^5.33.0",
-    "@typescript-eslint/parser": "^5.33.0",
-    "eslint": "^8.21.0",
+    "@typescript-eslint/eslint-plugin": "^5.33.1",
+    "@typescript-eslint/parser": "^5.33.1",
+    "eslint": "^8.22.0",
     "eslint-config-prettier": "^8.5.0",
     "eslint-formatter-pretty": "^4.1.0",
     "eslint-plugin-eslint-comments": "^3.2.0",
     "eslint-plugin-sonarjs": "^0.15.0",
     "eslint-plugin-unicorn": "^43.0.2",
     "prettier": "^2.7.1",
-    "prettier-plugin-organize-imports": "^3.0.3",
-    "prettier-plugin-pkg": "^0.16.1",
+    "prettier-plugin-organize-imports": "^3.1.0",
+    "prettier-plugin-pkg": "^0.17.0",
     "prettier-plugin-sh": "^0.12.8",
     "typescript": "^4.7.4"
   }