@ovencord/discord.js 14.16.3

package/src/util/Components.ts

@@ -0,0 +1,285 @@
+import { lazy  } from '@ovencord/util';
+import { ComponentType  } from 'discord-api-types/v10';
+
+// Fixes circular dependencies.
+const getActionRow = lazy(() => require('../structures/ActionRow.js').ActionRow);
+const getButtonComponent = lazy(() => require('../structures/ButtonComponent.js').ButtonComponent);
+const getChannelSelectMenuComponent = lazy(
+  () => require('../structures/ChannelSelectMenuComponent.js').ChannelSelectMenuComponent,
+);
+const getComponent = lazy(() => require('../structures/Component.js').Component);
+const getContainerComponent = lazy(() => require('../structures/ContainerComponent.js').ContainerComponent);
+const getFileComponent = lazy(() => require('../structures/FileComponent.js').FileComponent);
+const getLabelComponent = lazy(() => require('../structures/LabelComponent.js').LabelComponent);
+const getMediaGalleryComponent = lazy(() => require('../structures/MediaGalleryComponent.js').MediaGalleryComponent);
+const getMentionableSelectMenuComponent = lazy(
+  () => require('../structures/MentionableSelectMenuComponent.js').MentionableSelectMenuComponent,
+);
+const getRoleSelectMenuComponent = lazy(
+  () => require('../structures/RoleSelectMenuComponent.js').RoleSelectMenuComponent,
+);
+const getSectionComponent = lazy(() => require('../structures/SectionComponent.js').SectionComponent);
+const getSeparatorComponent = lazy(() => require('../structures/SeparatorComponent.js').SeparatorComponent);
+const getStringSelectMenuComponent = lazy(
+  () => require('../structures/StringSelectMenuComponent.js').StringSelectMenuComponent,
+);
+const getTextDisplayComponent = lazy(() => require('../structures/TextDisplayComponent.js').TextDisplayComponent);
+const getTextInputComponent = lazy(() => require('../structures/TextInputComponent.js').TextInputComponent);
+const getThumbnailComponent = lazy(() => require('../structures/ThumbnailComponent.js').ThumbnailComponent);
+const getUserSelectMenuComponent = lazy(
+  () => require('../structures/UserSelectMenuComponent.js').UserSelectMenuComponent,
+);
+
+/**
+ * @typedef {Object} BaseComponentData
+ * @property {number} [id] the id of this component
+ * @property {ComponentType} type The type of component
+ */
+
+/**
+ * @typedef {BaseComponentData} ActionRowData
+ * @property {ComponentData[]} components The components in this action row
+ */
+
+/**
+ * @typedef {Object} ModalComponentData
+ * @property {string} title The title of the modal
+ * @property {string} customId The custom id of the modal
+ * @property {Array<TextDisplayComponentData|LabelData>} components The components within this modal
+ */
+
+/**
+ * @typedef {StringSelectMenuComponentData|TextInputComponentData|UserSelectMenuComponentData|
+ * RoleSelectMenuComponentData|MentionableSelectMenuComponentData|ChannelSelectMenuComponentData|FileUploadComponentData} ComponentInLabelData
+ */
+
+/**
+ * @typedef {BaseComponentData} LabelData
+ * @property {string} label The label to use
+ * @property {string} [description] The optional description for the label
+ * @property {ComponentInLabelData} component The component within the label
+ */
+
+/**
+ * @typedef {BaseComponentData} ButtonComponentData
+ * @property {ButtonStyle} style The style of the button
+ * @property {boolean} [disabled] Whether this button is disabled
+ * @property {string} label The label of this button
+ * @property {APIMessageComponentEmoji} [emoji] The emoji on this button
+ * @property {string} [customId] The custom id of the button
+ * @property {string} [url] The URL of the button
+ */
+
+/**
+ * @typedef {BaseComponentData} FileUploadComponentData
+ * @property {string} customId The custom id of the file upload
+ * @property {number} [minValues] The minimum number of files that must be uploaded (0-10)
+ * @property {number} [maxValues] The maximum number of files that can be uploaded (1-10)
+ * @property {boolean} [required] Whether this component is required in modals
+ */
+
+/**
+ * @typedef {BaseComponentData} BaseSelectMenuComponentData
+ * @property {string} customId The custom id of the select menu
+ * @property {boolean} [disabled] Whether the select menu is disabled or not
+ * @property {number} [maxValues] The maximum amount of options that can be selected
+ * @property {number} [minValues] The minimum amount of options that must be selected
+ * @property {string} [placeholder] The placeholder of the select menu
+ * @property {boolean} [required] Whether this component is required in modals
+ */
+
+/**
+ * @typedef {BaseSelectMenuComponentData} StringSelectMenuComponentData
+ * @property {SelectMenuComponentOptionData[]} [options] The options in this select menu
+ */
+
+/**
+ * @typedef {BaseSelectMenuComponentData} UserSelectMenuComponentData
+ * @property {APISelectMenuDefaultValue[]} [defaultValues] The default selected values in this select menu
+ */
+
+/**
+ * @typedef {BaseSelectMenuComponentData} RoleSelectMenuComponentData
+ * @property {APISelectMenuDefaultValue[]} [defaultValues] The default selected values in this select menu
+ */
+
+/**
+ * @typedef {BaseSelectMenuComponentData} MentionableSelectMenuComponentData
+ * @property {APISelectMenuDefaultValue[]} [defaultValues] The default selected values in this select menu
+ */
+
+/**
+ * @typedef {BaseSelectMenuComponentData} ChannelSelectMenuComponentData
+ * @property {APISelectMenuDefaultValue[]} [defaultValues] The default selected values in this select menu
+ * @property {ChannelType[]} [channelTypes] The types of channels that can be selected
+ */
+
+/**
+ * @typedef {Object} SelectMenuComponentOptionData
+ * @property {string} label The label of the option
+ * @property {string} value The value of the option
+ * @property {string} [description] The description of the option
+ * @property {APIMessageComponentEmoji} [emoji] The emoji on the option
+ * @property {boolean} [default] Whether this option is selected by default
+ */
+
+/**
+ * @typedef {BaseComponentData} SelectMenuComponentData
+ * @property {string} customId The custom id of the select menu
+ * @property {boolean} [disabled] Whether the select menu is disabled or not
+ * @property {number} [maxValues] The maximum amount of options that can be selected
+ * @property {number} [minValues] The minimum amount of options that can be selected
+ * @property {SelectMenuComponentOptionData[]} [options] The options in this select menu
+ * @property {string} [placeholder] The placeholder of the select menu
+ */
+
+/**
+ * @typedef {ActionRowData|ButtonComponentData|SelectMenuComponentData} MessageComponentData
+ */
+
+/**
+ * @typedef {BaseComponentData} TextInputComponentData
+ * @property {string} customId The custom id of the text input
+ * @property {TextInputStyle} style The style of the text input
+ * @property {number} [minLength] The minimum number of characters that can be entered in the text input
+ * @property {number} [maxLength] The maximum number of characters that can be entered in the text input
+ * @property {boolean} [required] Whether or not the text input is required or not
+ * @property {string} [value] The pre-filled text in the text input
+ * @property {string} [placeholder] Placeholder for the text input
+ */
+
+/**
+ * @typedef {Object} UnfurledMediaItemData
+ * @property {string} url The url of this media item. Accepts either http:, https: or attachment: protocol
+ */
+
+/**
+ * @typedef {BaseComponentData} ThumbnailComponentData
+ * @property {UnfurledMediaItemData} media The media for the thumbnail
+ * @property {string} [description] The description of the thumbnail
+ * @property {boolean} [spoiler] Whether the thumbnail should be spoilered
+ */
+
+/**
+ * @typedef {BaseComponentData} FileComponentData
+ * @property {UnfurledMediaItemData} file The file media in this component
+ * @property {boolean} [spoiler] Whether the file should be spoilered
+ */
+
+/**
+ * @typedef {Object} MediaGalleryItemData
+ * @property {UnfurledMediaItemData} media The media for the media gallery item
+ * @property {string} [description] The description of the media gallery item
+ * @property {boolean} [spoiler] Whether the media gallery item should be spoilered
+ */
+
+/**
+ * @typedef {BaseComponentData} MediaGalleryComponentData
+ * @property {MediaGalleryItemData[]} items The media gallery items in this media gallery component
+ */
+
+/**
+ * @typedef {BaseComponentData} SeparatorComponentData
+ * @property {SeparatorSpacingSize} [spacing] The spacing size of this component
+ * @property {boolean} [divider] Whether the separator shows as a divider
+ */
+
+/**
+ * @typedef {BaseComponentData} SectionComponentData
+ * @property {Components[]} components The components in this section
+ * @property {ButtonComponentData|ThumbnailComponentData} accessory The accessory shown next to this section
+ */
+
+/**
+ * @typedef {BaseComponentData} TextDisplayComponentData
+ * @property {string} content The content displayed in this component
+ */
+
+/**
+ * @typedef {ActionRowData|FileComponentData|MediaGalleryComponentData|SectionComponentData|
+ * SeparatorComponentData|TextDisplayComponentData} ComponentInContainerData
+ */
+
+/**
+ * @typedef {BaseComponentData} ContainerComponentData
+ * @property {ComponentInContainerData} components The components in this container
+ * @property {?number} [accentColor] The accent color of this container
+ * @property {boolean} [spoiler] Whether the container should be spoilered
+ */
+
+/**
+ * @typedef {ActionRowData|ButtonComponentData|SelectMenuComponentData|TextInputComponentData|
+ * ThumbnailComponentData|FileComponentData|MediaGalleryComponentData|SeparatorComponentData|
+ * SectionComponentData|TextDisplayComponentData|ContainerComponentData} ComponentData
+ */
+
+/**
+ * @typedef {ActionRow|ContainerComponent|FileComponent|MediaGalleryComponent|
+ * SectionComponent|SeparatorComponent|TextDisplayComponent} MessageTopLevelComponent
+ */
+
+const ComponentTypeToClass = {
+  [ComponentType.ActionRow]: getActionRow,
+  [ComponentType.Button]: getButtonComponent,
+  [ComponentType.StringSelect]: getStringSelectMenuComponent,
+  [ComponentType.TextInput]: getTextInputComponent,
+  [ComponentType.UserSelect]: getUserSelectMenuComponent,
+  [ComponentType.RoleSelect]: getRoleSelectMenuComponent,
+  [ComponentType.MentionableSelect]: getMentionableSelectMenuComponent,
+  [ComponentType.ChannelSelect]: getChannelSelectMenuComponent,
+  [ComponentType.Container]: getContainerComponent,
+  [ComponentType.TextDisplay]: getTextDisplayComponent,
+  [ComponentType.File]: getFileComponent,
+  [ComponentType.MediaGallery]: getMediaGalleryComponent,
+  [ComponentType.Section]: getSectionComponent,
+  [ComponentType.Separator]: getSeparatorComponent,
+  [ComponentType.Thumbnail]: getThumbnailComponent,
+  [ComponentType.Label]: getLabelComponent,
+};
+
+/**
+ * Transforms API data into a component
+ *
+ * @param {APIMessageComponent|Component} data The data to create the component from
+ * @returns {Component}
+ * @ignore
+ */
+export function createComponent(data) {
+  return data instanceof getComponent() ? data : new (ComponentTypeToClass[data.type]?.() ?? getComponent())(data);
+}
+
+/**
+ * Extracts all interactive components from the component tree
+ *
+ * @param {Component|APIMessageComponent} component The component to find all interactive components in
+ * @returns {Array<Component|APIMessageComponent>}
+ * @ignore
+ */
+export function extractInteractiveComponents(component) {
+  switch (component.type) {
+    case ComponentType.ActionRow:
+      return component.components;
+    case ComponentType.Section:
+      return [...component.components, component.accessory];
+    case ComponentType.Container:
+      return component.components.flatMap(extractInteractiveComponents);
+    default:
+      return [component];
+  }
+}
+
+/**
+ * Finds a component by customId in nested components
+ *
+ * @param {Array<Component|APIMessageComponent>} components The components to search in
+ * @param {string} customId The customId to search for
+ * @returns {Component|APIMessageComponent}
+ * @ignore
+ */
+export function findComponentByCustomId(components, customId) {
+  return (
+    components
+      .flatMap(extractInteractiveComponents)
+      .find(component => (component.customId ?? component.custom_id) === customId) ?? null
+  );
+}

package/src/util/Constants.ts

@@ -0,0 +1,251 @@
+import { ChannelType, MessageType, ComponentType, ImageFormat, StickerFormatType  } from 'discord-api-types/v10';
+
+/**
+ * Max bulk deletable message age
+ *
+ * @typedef {number} MaxBulkDeletableMessageAge
+ */
+
+
+/**
+ * The name of an item to be swept in Sweepers
+ * - `autoModerationRules`
+ * - `applicationCommands` - both global and guild commands
+ * - `bans`
+ * - `emojis`
+ * - `entitlements`
+ * - `invites` - accepts the `lifetime` property, using it will sweep based on expires timestamp
+ * - `guildMembers`
+ * - `messages` - accepts the `lifetime` property, using it will sweep based on edited or created timestamp
+ * - `presences`
+ * - `reactions`
+ * - `stageInstances`
+ * - `stickers`
+ * - `threadMembers`
+ * - `threads` - accepts the `lifetime` property, using it will sweep archived threads based on archived timestamp
+ * - `users`
+ * - `voiceStates`
+ *
+ * @typedef {string} SweeperKey
+ */
+exports.SweeperKeys = [
+  'autoModerationRules',
+  'applicationCommands',
+  'bans',
+  'emojis',
+  'entitlements',
+  'invites',
+  'guildMembers',
+  'messages',
+  'presences',
+  'reactions',
+  'stageInstances',
+  'stickers',
+  'threadMembers',
+  'threads',
+  'users',
+  'voiceStates',
+];
+
+/**
+ * The types of messages that are not `System`. The available types are:
+ * - {@link MessageType.Default}
+ * - {@link MessageType.Reply}
+ * - {@link MessageType.ChatInputCommand}
+ * - {@link MessageType.ContextMenuCommand}
+ *
+ * @typedef {MessageType[]} NonSystemMessageTypes
+ */
+exports.NonSystemMessageTypes = [
+  MessageType.Default,
+  MessageType.Reply,
+  MessageType.ChatInputCommand,
+  MessageType.ContextMenuCommand,
+];
+
+/**
+ * The guild channels that are text-based.
+ * - TextChannel
+ * - AnnouncementChannel
+ * - ThreadChannel
+ * - VoiceChannel
+ * - StageChannel
+ *
+ * @typedef {TextChannel|AnnouncementChannel|ThreadChannel|VoiceChannel|StageChannel} GuildTextBasedChannel
+ */
+
+/**
+ * The types of guild channels that are text-based. The available types are:
+ * - {@link ChannelType.GuildText}
+ * - {@link ChannelType.GuildAnnouncement}
+ * - {@link ChannelType.AnnouncementThread}
+ * - {@link ChannelType.PublicThread}
+ * - {@link ChannelType.PrivateThread}
+ * - {@link ChannelType.GuildVoice}
+ * - {@link ChannelType.GuildStageVoice}
+ *
+ * @typedef {ChannelType[]} GuildTextBasedChannelTypes
+ */
+exports.GuildTextBasedChannelTypes = [
+  ChannelType.GuildText,
+  ChannelType.GuildAnnouncement,
+  ChannelType.AnnouncementThread,
+  ChannelType.PublicThread,
+  ChannelType.PrivateThread,
+  ChannelType.GuildVoice,
+  ChannelType.GuildStageVoice,
+];
+
+/**
+ * The channels that are text-based.
+ * - {@link DMChannel}
+ * - {@link GuildTextBasedChannel}
+ *
+ * @typedef {DMChannel|GuildTextBasedChannel} TextBasedChannels
+ */
+
+/**
+ * Data that resolves to give a text-based channel. This can be:
+ * - A {@link TextBasedChannel}
+ * - A {@link Snowflake}
+ *
+ * @typedef {TextBasedChannels|Snowflake} TextBasedChannelsResolvable
+ */
+
+/**
+ * The types of channels that are text-based. The available types are:
+ * - {@link ChannelType.DM}
+ * - {@link ChannelType.GuildText}
+ * - {@link ChannelType.GuildAnnouncement}
+ * - {@link ChannelType.AnnouncementThread}
+ * - {@link ChannelType.PublicThread}
+ * - {@link ChannelType.PrivateThread}
+ * - {@link ChannelType.GuildVoice}
+ * - {@link ChannelType.GuildStageVoice}
+ * - {@link ChannelType.GroupDM}
+ *
+ * @typedef {ChannelType[]} TextBasedChannelTypes
+ */
+exports.TextBasedChannelTypes = [...exports.GuildTextBasedChannelTypes, ChannelType.DM, ChannelType.GroupDM];
+
+/**
+ * The types of channels that are text-based and can have messages sent into. The available types are:
+ * - {@link ChannelType.DM}
+ * - {@link ChannelType.GuildText}
+ * - {@link ChannelType.GuildAnnouncement}
+ * - {@link ChannelType.AnnouncementThread}
+ * - {@link ChannelType.PublicThread}
+ * - {@link ChannelType.PrivateThread}
+ * - {@link ChannelType.GuildVoice}
+ * - {@link ChannelType.GuildStageVoice}
+ *
+ * @typedef {ChannelType[]} SendableChannels
+ */
+exports.SendableChannels = [...exports.GuildTextBasedChannelTypes, ChannelType.DM];
+
+/**
+ * The types of channels that are threads. The available types are:
+ * - {@link ChannelType.AnnouncementThread}
+ * - {@link ChannelType.PublicThread}
+ * - {@link ChannelType.PrivateThread}
+ *
+ * @typedef {ChannelType[]} ThreadChannelTypes
+ */
+exports.ThreadChannelTypes = [ChannelType.AnnouncementThread, ChannelType.PublicThread, ChannelType.PrivateThread];
+
+/**
+ * The types of channels that are voice-based. The available types are:
+ * - {@link ChannelType.GuildVoice}
+ * - {@link ChannelType.GuildStageVoice}
+ *
+ * @typedef {ChannelType[]} VoiceBasedChannelTypes
+ */
+exports.VoiceBasedChannelTypes = [ChannelType.GuildVoice, ChannelType.GuildStageVoice];
+
+/**
+ * The types of select menus. The available types are:
+ * - {@link ComponentType.StringSelect}
+ * - {@link ComponentType.UserSelect}
+ * - {@link ComponentType.RoleSelect}
+ * - {@link ComponentType.MentionableSelect}
+ * - {@link ComponentType.ChannelSelect}
+ *
+ * @typedef {ComponentType[]} SelectMenuTypes
+ */
+exports.SelectMenuTypes = [
+  ComponentType.StringSelect,
+  ComponentType.UserSelect,
+  ComponentType.RoleSelect,
+  ComponentType.MentionableSelect,
+  ComponentType.ChannelSelect,
+];
+
+/**
+ * The types of messages that cannot be deleted. The available types are:
+ * - {@link MessageType.RecipientAdd}
+ * - {@link MessageType.RecipientRemove}
+ * - {@link MessageType.Call}
+ * - {@link MessageType.ChannelNameChange}
+ * - {@link MessageType.ChannelIconChange}
+ * - {@link MessageType.ThreadStarterMessage}
+ *
+ * @typedef {MessageType[]} UndeletableMessageTypes
+ */
+exports.UndeletableMessageTypes = [
+  MessageType.RecipientAdd,
+  MessageType.RecipientRemove,
+  MessageType.Call,
+  MessageType.ChannelNameChange,
+  MessageType.ChannelIconChange,
+  MessageType.ThreadStarterMessage,
+];
+
+/* eslint-disable jsdoc/valid-types */
+/**
+ * A mapping between sticker formats and their respective image formats.
+ * - {@link StickerFormatType.PNG} -> {@link ImageFormat.PNG}
+ * - {@link StickerFormatType.APNG} -> {@link ImageFormat.PNG}
+ * - {@link StickerFormatType.Lottie} -> {@link ImageFormat.Lottie}
+ * - {@link StickerFormatType.GIF} -> {@link ImageFormat.GIF}
+ *
+ * @typedef {Object} StickerFormatExtensionMap
+ * @property {"png"} 1 PNG
+ * @property {"png"} 2 APNG
+ * @property {"json"} 3 Lottie
+ * @property {"gif"} 4 GIF
+ */
+exports.StickerFormatExtensionMap = {
+  [StickerFormatType.PNG]: ImageFormat.PNG,
+  [StickerFormatType.APNG]: ImageFormat.PNG,
+  [StickerFormatType.Lottie]: ImageFormat.Lottie,
+  [StickerFormatType.GIF]: ImageFormat.GIF,
+};
+/* eslint-enable jsdoc/valid-types */
+
+/**
+ * Holographic color values for role styling.
+ * When using `tertiaryColor`, the API enforces these specific values for holographic effect.
+ *
+ * @typedef {Object} HolographicStyle
+ * @property {number} Primary 11127295 (0xA9FFFF)
+ * @property {number} Secondary 16759788 (0xFFCCCC)
+ * @property {number} Tertiary 16761760 (0xFFE0A0)
+ */
+exports.HolographicStyle = {
+  Primary: 11_127_295,
+  Secondary: 16_759_788,
+  Tertiary: 16_761_760,
+};
+
+/**
+ * @typedef {Object} Constants Constants that can be used in an enum or object-like way.
+ * @property {number} MaxBulkDeletableMessageAge Max bulk deletable message age
+ * @property {SweeperKey[]} SweeperKeys The possible names of items that can be swept in sweepers
+ * @property {NonSystemMessageTypes} NonSystemMessageTypes The types of messages that are not deemed a system type
+ * @property {TextBasedChannelTypes} TextBasedChannelTypes The types of channels that are text-based
+ * @property {ThreadChannelTypes} ThreadChannelTypes The types of channels that are threads
+ * @property {VoiceBasedChannelTypes} VoiceBasedChannelTypes The types of channels that are voice-based
+ * @property {SelectMenuTypes} SelectMenuTypes The types of components that are select menus.
+ * @property {Object} StickerFormatExtensionMap A mapping between sticker formats and their respective image formats.
+ * @property {HolographicStyle} HolographicStyle Holographic color values for role styling.
+ */

package/src/util/DataResolver.ts

@@ -0,0 +1,146 @@
+
+import { Buffer } from 'node:buffer';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { lazy } from '@ovencord/util';
+import { DiscordjsError, DiscordjsTypeError, ErrorCodes } from '../errors/index.js';
+import { BaseInvite } from '../structures/BaseInvite.js';
+
+// Fixes circular dependencies.
+const getGuildTemplate = lazy(() => require('../structures/GuildTemplate.js').GuildTemplate);
+
+/**
+ * Data that can be resolved to give an invite code. This can be:
+ * - An invite code
+ * - An invite URL
+ *
+ * @typedef {string} InviteResolvable
+ */
+
+/**
+ * Data that can be resolved to give a template code. This can be:
+ * - A template code
+ * - A template URL
+ *
+ * @typedef {string} GuildTemplateResolvable
+ */
+
+/**
+ * Resolves the string to a code based on the passed regex.
+ *
+ * @param {string} data The string to resolve
+ * @param {RegExp} regex The RegExp used to extract the code
+ * @returns {string}
+ */
+export function resolveCode(data, regex) {
+  return regex.exec(data)?.[1] ?? data;
+}
+
+/**
+ * Resolves InviteResolvable to an invite code.
+ *
+ * @param {InviteResolvable} data The invite resolvable to resolve
+ * @returns {string}
+ */
+export function resolveInviteCode(data) {
+  return resolveCode(data, BaseInvite.InvitesPattern);
+}
+
+/**
+ * Resolves GuildTemplateResolvable to a template code.
+ *
+ * @param {GuildTemplateResolvable} data The template resolvable to resolve
+ * @returns {string}
+ */
+export function resolveGuildTemplateCode(data) {
+  return resolveCode(data, getGuildTemplate().GuildTemplatesPattern);
+}
+
+/**
+ * Data that can be resolved to give a Buffer. This can be:
+ * - A Buffer
+ * - The path to a local file
+ * - A URL <warn>When provided a URL, discord.js will fetch the URL internally in order to create a Buffer.
+ *   This can pose a security risk when the URL has not been sanitized</warn>
+ *
+ * @typedef {string|Buffer} BufferResolvable
+ */
+
+/**
+ * @external Stream
+ * @see {@link https://nodejs.org/api/stream.html}
+ */
+
+/**
+ * @typedef {Object} ResolvedFile
+ * @property {Buffer} data Buffer containing the file data
+ * @property {string} [contentType] Content-Type of the file
+ * @private
+ */
+
+/**
+ * Resolves a BufferResolvable to a Buffer.
+ *
+ * @param {BufferResolvable|Stream} resource The buffer or stream resolvable to resolve
+ * @returns {Promise<ResolvedFile>}
+ */
+export async function resolveFile(resource) {
+  if (Buffer.isBuffer(resource)) return { data: resource };
+
+  if (typeof resource[Symbol.asyncIterator] === 'function') {
+    const buffers = [];
+    for await (const data of resource) buffers.push(Buffer.from(data));
+    return { data: Buffer.concat(buffers) };
+  }
+
+  if (typeof resource === 'string') {
+    if (/^https?:\/\//.test(resource)) {
+      const res = await fetch(resource);
+      return { data: Buffer.from(await res.arrayBuffer()), contentType: res.headers.get('content-type') };
+    }
+
+    const file = path.resolve(resource);
+
+    const stats = await fs.stat(file);
+    if (!stats.isFile()) throw new DiscordjsError(ErrorCodes.FileNotFound, file);
+    return { data: await fs.readFile(file) };
+  }
+
+  throw new DiscordjsTypeError(ErrorCodes.ReqResourceType);
+}
+
+/**
+ * Data that resolves to give a Base64 string, typically for image uploading. This can be:
+ * - A Buffer
+ * - A base64 string
+ *
+ * @typedef {Buffer|string} Base64Resolvable
+ */
+
+/**
+ * Resolves a Base64Resolvable to a Base 64 string.
+ *
+ * @param {Base64Resolvable} data The base 64 resolvable you want to resolve
+ * @param {string} [contentType='image/jpg'] The content type of the data
+ * @returns {string}
+ */
+export function resolveBase64(data, contentType = 'image/jpg') {
+  if (Buffer.isBuffer(data)) return `data:${contentType};base64,${data.toString('base64')}`;
+  return data;
+}
+
+/**
+ * Resolves a Base64Resolvable, a string, or a BufferResolvable to a Base 64 image.
+ *
+ * @param {BufferResolvable|Base64Resolvable} image The image to be resolved
+ * @returns {Promise<?string>}
+ */
+export async function resolveImage(image) {
+  if (!image) return null;
+  if (typeof image === 'string' && image.startsWith('data:')) {
+    return image;
+  }
+
+  const file = await resolveFile(image);
+  return resolveBase64(file.data);
+}

package/src/util/Enums.ts

@@ -0,0 +1,10 @@
+export function createEnum(keys) {
+  const obj = {};
+  for (const [index, key] of keys.entries()) {
+    if (key === null) continue;
+    obj[key] = index;
+    obj[index] = key;
+  }
+
+  return obj;
+}