discord-sb.js 1.0.0

package/src/errors/Messages.js

@@ -0,0 +1,217 @@
+'use strict';
+
+const { register } = require('./DJSError');
+
+const Messages = {
+  CLIENT_INVALID_OPTION: (prop, must) => `The ${prop} option must be ${must}`,
+  CLIENT_INVALID_PROVIDED_SHARDS: 'None of the provided shards were valid.',
+  CLIENT_MISSING_INTENTS: 'Valid intents must be provided for the Client.',
+  CLIENT_NOT_READY: action => `The client needs to be logged in to ${action}.`,
+
+  TOKEN_INVALID: 'An invalid token was provided.',
+  TOKEN_MISSING: 'Request to use token, but token was unavailable to the client.',
+  TOTPKEY_MISSING: 'Request to use mfa, but TOTPKey was not set in client options.',
+
+  WS_CLOSE_REQUESTED: 'WebSocket closed due to user request.',
+  WS_CONNECTION_EXISTS: 'There is already an existing WebSocket connection.',
+  WS_NOT_OPEN: (data = 'data') => `WebSocket not open to send ${data}`,
+  MANAGER_DESTROYED: 'Manager was destroyed.',
+
+  BITFIELD_INVALID: bit => `Invalid bitfield flag or number: ${bit}.`,
+
+  SHARDING_INVALID: '[Bot Token] Invalid shard settings were provided.',
+  SHARDING_REQUIRED: '[Bot Token] This session would have handled too many guilds - Sharding is required.',
+  INVALID_INTENTS: '[Bot Token] Invalid intent provided for WebSocket intents.',
+  DISALLOWED_INTENTS: '[Bot Token] Privileged intent provided is not enabled or whitelisted.',
+  SHARDING_NO_SHARDS: 'No shards have been spawned.',
+  SHARDING_IN_PROCESS: 'Shards are still being spawned.',
+  SHARDING_INVALID_EVAL_BROADCAST: 'Script to evaluate must be a function',
+  SHARDING_SHARD_NOT_FOUND: id => `Shard ${id} could not be found.`,
+  SHARDING_ALREADY_SPAWNED: count => `Already spawned ${count} shards.`,
+  SHARDING_PROCESS_EXISTS: id => `Shard ${id} already has an active process.`,
+  SHARDING_WORKER_EXISTS: id => `Shard ${id} already has an active worker.`,
+  SHARDING_READY_TIMEOUT: id => `Shard ${id}'s Client took too long to become ready.`,
+  SHARDING_READY_DISCONNECTED: id => `Shard ${id}'s Client disconnected before becoming ready.`,
+  SHARDING_READY_DIED: id => `Shard ${id}'s process exited before its Client became ready.`,
+  SHARDING_NO_CHILD_EXISTS: id => `Shard ${id} has no active process or worker.`,
+  SHARDING_SHARD_MISCALCULATION: (shard, guild, count) =>
+    `Calculated invalid shard ${shard} for guild ${guild} with ${count} shards.`,
+
+  COLOR_RANGE: 'Color must be within the range 0 - 16777215 (0xFFFFFF).',
+  COLOR_CONVERT: 'Unable to convert color to a number.',
+
+  INVITE_OPTIONS_MISSING_CHANNEL: 'A valid guild channel must be provided when GuildScheduledEvent is EXTERNAL.',
+
+  EMBED_TITLE: 'MessageEmbed title must be a string.',
+  EMBED_FIELD_NAME: 'MessageEmbed field names must be non-empty strings.',
+  EMBED_FIELD_VALUE: 'MessageEmbed field values must be non-empty strings.',
+  EMBED_FOOTER_TEXT: 'MessageEmbed footer text must be a string.',
+  EMBED_DESCRIPTION: 'MessageEmbed description must be a string.',
+  EMBED_AUTHOR_NAME: 'MessageEmbed author name must be a string.',
+
+  BUTTON_LABEL: 'MessageButton label must be a string',
+  BUTTON_URL: 'MessageButton URL must be a string',
+  BUTTON_CUSTOM_ID: 'MessageButton customId must be a string',
+
+  SELECT_MENU_CUSTOM_ID: 'MessageSelectMenu customId must be a string',
+  SELECT_MENU_PLACEHOLDER: 'MessageSelectMenu placeholder must be a string',
+  SELECT_OPTION_LABEL: 'MessageSelectOption label must be a string',
+  SELECT_OPTION_VALUE: 'MessageSelectOption value must be a string',
+  SELECT_OPTION_DESCRIPTION: 'MessageSelectOption description must be a string',
+
+  TEXT_INPUT_CUSTOM_ID: 'TextInputComponent customId must be a string',
+  TEXT_INPUT_LABEL: 'TextInputComponent label must be a string',
+  TEXT_INPUT_PLACEHOLDER: 'TextInputComponent placeholder must be a string',
+  TEXT_INPUT_VALUE: 'TextInputComponent value must be a string',
+
+  MODAL_CUSTOM_ID: 'Modal customId must be a string',
+  MODAL_TITLE: 'Modal title must be a string',
+
+  INTERACTION_COLLECTOR_ERROR: reason => `Collector received no interactions before ending with reason: ${reason}`,
+
+  FILE_NOT_FOUND: file => `File could not be found: ${file}`,
+
+  USER_BANNER_NOT_FETCHED: "You must fetch this user's banner before trying to generate its URL!",
+  USER_NO_DM_CHANNEL: 'No DM Channel exists!',
+
+  VOICE_NOT_STAGE_CHANNEL: 'You are only allowed to do this in stage channels.',
+
+  VOICE_STATE_NOT_OWN:
+    'You cannot self-deafen/mute/request to speak on VoiceStates that do not belong to the ClientUser.',
+  VOICE_STATE_INVALID_TYPE: name => `${name} must be a boolean.`,
+
+  REQ_RESOURCE_TYPE: 'The resource must be a string, Buffer or a valid file stream.',
+
+  IMAGE_FORMAT: format => `Invalid image format: ${format}`,
+  IMAGE_SIZE: size => `Invalid image size: ${size}`,
+
+  MESSAGE_BULK_DELETE_TYPE: 'The messages must be an Array, Collection, or number.',
+  MESSAGE_NONCE_TYPE: 'Message nonce must be an integer or a string.',
+  MESSAGE_CONTENT_TYPE: 'Message content must be a non-empty string.',
+
+  SPLIT_MAX_LEN: 'Chunk exceeds the max length and contains no split characters.',
+
+  BAN_RESOLVE_ID: (ban = false) => `Couldn't resolve the user id to ${ban ? 'ban' : 'unban'}.`,
+  FETCH_BAN_RESOLVE_ID: "Couldn't resolve the user id to fetch the ban.",
+
+  PRUNE_DAYS_TYPE: 'Days must be a number',
+
+  GUILD_CHANNEL_RESOLVE: 'Could not resolve channel to a guild channel.',
+  GUILD_VOICE_CHANNEL_RESOLVE: 'Could not resolve channel to a guild voice channel.',
+  GUILD_CHANNEL_ORPHAN: 'Could not find a parent to this guild channel.',
+  GUILD_CHANNEL_UNOWNED: "The fetched channel does not belong to this manager's guild.",
+  GUILD_OWNED: 'Guild is owned by the client.',
+  GUILD_MEMBERS_TIMEOUT: "Members didn't arrive in time.",
+  GUILD_UNCACHED_ME: 'The client user as a member of this guild is uncached.',
+  CHANNEL_NOT_CACHED: 'Could not find the channel where this message came from in the cache!',
+  STAGE_CHANNEL_RESOLVE: 'Could not resolve channel to a stage channel.',
+  GUILD_SCHEDULED_EVENT_RESOLVE: 'Could not resolve the guild scheduled event.',
+
+  INVALID_TYPE: (name, expected, an = false) => `Supplied ${name} is not a${an ? 'n' : ''} ${expected}.`,
+  INVALID_ELEMENT: (type, name, elem) => `Supplied ${type} ${name} includes an invalid element: ${elem}`,
+
+  MESSAGE_THREAD_PARENT: 'The message was not sent in a guild text or news channel',
+  MESSAGE_EXISTING_THREAD: 'The message already has a thread',
+  THREAD_INVITABLE_TYPE: type => `Invitable cannot be edited on ${type}`,
+
+  WEBHOOK_MESSAGE: 'The message was not sent by a webhook.',
+  WEBHOOK_TOKEN_UNAVAILABLE: 'This action requires a webhook token, but none is available.',
+  WEBHOOK_URL_INVALID: 'The provided webhook URL is not valid.',
+  WEBHOOK_APPLICATION: 'This message webhook belongs to an application and cannot be fetched.',
+  MESSAGE_REFERENCE_MISSING: 'The message does not reference another message',
+
+  EMOJI_TYPE: 'Emoji must be a string or GuildEmoji/ReactionEmoji',
+  EMOJI_MANAGED: 'Emoji is managed and has no Author.',
+  MISSING_MANAGE_EMOJIS_AND_STICKERS_PERMISSION: guild =>
+    `Client must have Manage Emojis and Stickers permission in guild ${guild} to see emoji authors.`,
+  NOT_GUILD_STICKER: 'Sticker is a standard (non-guild) sticker and has no author.',
+
+  REACTION_RESOLVE_USER: "Couldn't resolve the user id to remove from the reaction.",
+
+  VANITY_URL: 'This guild does not have the VANITY_URL feature enabled.',
+
+  INVITE_RESOLVE_CODE: 'Could not resolve the code to fetch the invite.',
+
+  INVITE_NOT_FOUND: 'Could not find the requested invite.',
+
+  DELETE_GROUP_DM_CHANNEL: "Bots don't have access to Group DM Channels and cannot delete them",
+  FETCH_GROUP_DM_CHANNEL: "Bots don't have access to Group DM Channels and cannot fetch them",
+
+  MEMBER_FETCH_NONCE_LENGTH: 'Nonce length must not exceed 32 characters.',
+
+  GLOBAL_COMMAND_PERMISSIONS:
+    'Permissions for global commands may only be fetched or modified by providing a GuildResolvable ' +
+    "or from a guild's application command manager.",
+  GUILD_UNCACHED_ROLE_RESOLVE: 'Cannot resolve roles from an arbitrary guild, provide an id instead',
+
+  INTERACTION_ALREADY_REPLIED: 'The reply to this interaction has already been sent or deferred.',
+  INTERACTION_NOT_REPLIED: 'The reply to this interaction has not been sent or deferred.',
+
+  COMMAND_INTERACTION_OPTION_NOT_FOUND: name => `Required option "${name}" not found.`,
+  COMMAND_INTERACTION_OPTION_TYPE: (name, type, expected) =>
+    `Option "${name}" is of type: ${type}; expected ${expected}.`,
+  COMMAND_INTERACTION_OPTION_EMPTY: (name, type) =>
+    `Required option "${name}" is of type: ${type}; expected a non-empty value.`,
+  COMMAND_INTERACTION_OPTION_NO_SUB_COMMAND: 'No subcommand specified for interaction.',
+  COMMAND_INTERACTION_OPTION_NO_SUB_COMMAND_GROUP: 'No subcommand group specified for interaction.',
+  AUTOCOMPLETE_INTERACTION_OPTION_NO_FOCUSED_OPTION: 'No focused option for autocomplete interaction.',
+
+  MODAL_SUBMIT_INTERACTION_FIELD_NOT_FOUND: customId => `Required field with custom id "${customId}" not found.`,
+  MODAL_SUBMIT_INTERACTION_FIELD_TYPE: (customId, type, expected) =>
+    `Field with custom id "${customId}" is of type: ${type}; expected ${expected}.`,
+
+  INVITE_MISSING_SCOPES: 'At least one valid scope must be provided for the invite',
+
+  NOT_IMPLEMENTED: (what, name) => `Method ${what} not implemented on ${name}.`,
+
+  SWEEP_FILTER_RETURN: 'The return value of the sweepFilter function was not false or a Function',
+
+  GUILD_FORUM_MESSAGE_REQUIRED: 'You must provide a message to create a guild forum thread',
+
+  // Selfbot
+  INVALID_USER_API: 'User accounts cannot use this endpoint',
+  INVALID_APPLICATION_COMMAND: id => `Could not find a valid command for this bot: ${id}`,
+  INVALID_COMMAND_NAME: allCMD => `Could not parse subGroupCommand and subCommand due to too long: ${allCMD.join(' ')}`,
+  INVALID_SLASH_COMMAND_CHOICES: (parentOptions, value) =>
+    `${value} is not a valid choice for this option (${parentOptions})`,
+  SLASH_COMMAND_REQUIRED_OPTIONS_MISSING: (req, opt) => `Value required (${req}) missing (Options: ${opt})`,
+  SLASH_COMMAND_SUB_COMMAND_GROUP_INVALID: n => `${n} is not a valid sub command group`,
+  SLASH_COMMAND_SUB_COMMAND_INVALID: n => `${n} is not a valid sub command`,
+  INTERACTION_FAILED: 'No responsed from Application',
+  USER_NOT_STREAMING: 'User is not streaming',
+  BULK_BAN_USERS_OPTION_EMPTY: 'Option "users" array or collection is empty',
+
+  // Djs v12
+  VOICE_INVALID_HEARTBEAT: 'Tried to set voice heartbeat but no valid interval was specified.',
+  VOICE_USER_MISSING: "Couldn't resolve the user to create stream.",
+  VOICE_JOIN_CHANNEL: (full = false) =>
+    `You do not have permission to join this voice channel${full ? '; it is full.' : '.'}`,
+  VOICE_CONNECTION_TIMEOUT: 'Connection not established within 15 seconds.',
+  VOICE_TOKEN_ABSENT: 'Token not provided from voice server packet.',
+  VOICE_SESSION_ABSENT: 'Session ID not supplied.',
+  VOICE_INVALID_ENDPOINT: 'Invalid endpoint received.',
+  VOICE_NO_BROWSER: 'Voice connections are not available in browsers.',
+  VOICE_CONNECTION_ATTEMPTS_EXCEEDED: attempts => `Too many connection attempts (${attempts}).`,
+  VOICE_JOIN_SOCKET_CLOSED: 'Tried to send join packet, but the WebSocket is not open.',
+  VOICE_PLAY_INTERFACE_NO_BROADCAST: 'A broadcast cannot be played in this context.',
+  VOICE_PLAY_INTERFACE_BAD_TYPE: 'Unknown stream type',
+  VOICE_PRISM_DEMUXERS_NEED_STREAM: 'To play a webm/ogg stream, you need to pass a ReadableStream.',
+
+  VOICE_STATE_UNCACHED_MEMBER: 'The member of this voice state is uncached.',
+
+  UDP_SEND_FAIL: 'Tried to send a UDP packet, but there is no socket available.',
+  UDP_ADDRESS_MALFORMED: 'Malformed UDP address or port.',
+  UDP_CONNECTION_EXISTS: 'There is already an existing UDP connection.',
+  UDP_WRONG_HANDSHAKE: 'Wrong handshake packet for UDP',
+
+  INVALID_VIDEO_CODEC: codecs => `Only these codecs are supported: ${codecs.join(', ')}`,
+
+  STREAM_CONNECTION_READONLY: 'Cannot send data to a read-only stream',
+  STREAM_CANNOT_JOIN: 'Cannot join a stream to itself',
+  VOICE_USER_NOT_STREAMING: 'User is not streaming',
+  POLL_ALREADY_EXPIRED: 'This poll has already expired.',
+  METHOD_WARNING:
+    'This method is flagged as it may lead to a temporary or permanent account ban. Do not use until further notice.',
+};
+
+for (const [name, message] of Object.entries(Messages)) register(name, message);

package/src/errors/index.js

@@ -0,0 +1,4 @@
+'use strict';
+
+module.exports = require('./DJSError');
+module.exports.Messages = require('./Messages');

package/src/index.js

@@ -0,0 +1,172 @@
+'use strict';
+
+// "Root" classes (starting points)
+exports.BaseClient = require('./client/BaseClient');
+exports.Client = require('./client/Client');
+/** @deprecated This will be removed in the next major version */
+exports.Shard = require('./sharding/Shard');
+/** @deprecated This will be removed in the next major version */
+exports.ShardClientUtil = require('./sharding/ShardClientUtil');
+/** @deprecated This will be removed in the next major version */
+exports.ShardingManager = require('./sharding/ShardingManager');
+exports.WebhookClient = require('./client/WebhookClient');
+
+// Utilities
+exports.ActivityFlags = require('./util/ActivityFlags');
+exports.ApplicationFlags = require('./util/ApplicationFlags');
+exports.AttachmentFlags = require('./util/AttachmentFlags');
+exports.BaseManager = require('./managers/BaseManager');
+exports.BitField = require('./util/BitField');
+exports.Collection = require('@discordjs/collection').Collection;
+exports.Constants = require('./util/Constants');
+exports.DataResolver = require('./util/DataResolver');
+exports.DiscordAPIError = require('./rest/DiscordAPIError');
+exports.Formatters = require('./util/Formatters');
+exports.GuildMemberFlags = require('./util/GuildMemberFlags');
+exports.HTTPError = require('./rest/HTTPError');
+exports.Intents = require('./util/Intents');
+exports.LimitedCollection = require('./util/LimitedCollection');
+exports.MessageFlags = require('./util/MessageFlags');
+exports.Options = require('./util/Options');
+exports.Permissions = require('./util/Permissions');
+exports.RateLimitError = require('./rest/RateLimitError');
+exports.RoleFlags = require('./util/RoleFlags');
+exports.SnowflakeUtil = require('./util/SnowflakeUtil');
+exports.Sweepers = require('./util/Sweepers');
+exports.SystemChannelFlags = require('./util/SystemChannelFlags');
+exports.ThreadMemberFlags = require('./util/ThreadMemberFlags');
+exports.UserFlags = require('./util/UserFlags');
+exports.Util = require('./util/Util');
+exports.version = require('../package.json').version;
+
+// Managers
+exports.ApplicationCommandManager = require('./managers/ApplicationCommandManager');
+exports.ApplicationCommandPermissionsManager = require('./managers/ApplicationCommandPermissionsManager');
+exports.AutoModerationRuleManager = require('./managers/AutoModerationRuleManager');
+exports.BaseGuildEmojiManager = require('./managers/BaseGuildEmojiManager');
+exports.CachedManager = require('./managers/CachedManager');
+exports.ChannelManager = require('./managers/ChannelManager');
+exports.ClientVoiceManager = require('./client/voice/ClientVoiceManager');
+exports.DataManager = require('./managers/DataManager');
+exports.GuildBanManager = require('./managers/GuildBanManager');
+exports.GuildChannelManager = require('./managers/GuildChannelManager');
+exports.GuildEmojiManager = require('./managers/GuildEmojiManager');
+exports.GuildEmojiRoleManager = require('./managers/GuildEmojiRoleManager');
+exports.GuildInviteManager = require('./managers/GuildInviteManager');
+exports.GuildManager = require('./managers/GuildManager');
+exports.GuildMemberManager = require('./managers/GuildMemberManager');
+exports.GuildMemberRoleManager = require('./managers/GuildMemberRoleManager');
+exports.GuildScheduledEventManager = require('./managers/GuildScheduledEventManager');
+exports.GuildStickerManager = require('./managers/GuildStickerManager');
+exports.MessageManager = require('./managers/MessageManager');
+exports.PermissionOverwriteManager = require('./managers/PermissionOverwriteManager');
+exports.PresenceManager = require('./managers/PresenceManager');
+exports.ReactionManager = require('./managers/ReactionManager');
+exports.ReactionUserManager = require('./managers/ReactionUserManager');
+exports.RoleManager = require('./managers/RoleManager');
+exports.SessionManager = require('./managers/SessionManager');
+exports.StageInstanceManager = require('./managers/StageInstanceManager');
+exports.ThreadManager = require('./managers/ThreadManager');
+exports.ThreadMemberManager = require('./managers/ThreadMemberManager');
+exports.UserManager = require('./managers/UserManager');
+exports.VoiceStateManager = require('./managers/VoiceStateManager');
+exports.WebSocketManager = require('./client/websocket/WebSocketManager');
+exports.WebSocketShard = require('./client/websocket/WebSocketShard');
+exports.RelationshipManager = require('./managers/RelationshipManager');
+exports.UserNoteManager = require('./managers/UserNoteManager');
+
+// Structures
+exports.Activity = require('./structures/Presence').Activity;
+exports.AnonymousGuild = require('./structures/AnonymousGuild');
+exports.Application = require('./structures/interfaces/Application');
+exports.ApplicationCommand = require('./structures/ApplicationCommand');
+exports.ApplicationRoleConnectionMetadata =
+  require('./structures/ApplicationRoleConnectionMetadata').ApplicationRoleConnectionMetadata;
+exports.AutoModerationActionExecution = require('./structures/AutoModerationActionExecution');
+exports.AutoModerationRule = require('./structures/AutoModerationRule');
+exports.Base = require('./structures/Base');
+exports.BaseGuild = require('./structures/BaseGuild');
+exports.BaseGuildEmoji = require('./structures/BaseGuildEmoji');
+exports.BaseGuildTextChannel = require('./structures/BaseGuildTextChannel');
+exports.BaseGuildVoiceChannel = require('./structures/BaseGuildVoiceChannel');
+exports.CategoryChannel = require('./structures/CategoryChannel');
+exports.Channel = require('./structures/Channel').Channel;
+exports.ClientPresence = require('./structures/ClientPresence');
+exports.ClientUser = require('./structures/ClientUser');
+exports.Collector = require('./structures/interfaces/Collector');
+exports.DirectoryChannel = require('./structures/DirectoryChannel');
+exports.DMChannel = require('./structures/DMChannel');
+exports.Emoji = require('./structures/Emoji').Emoji;
+exports.ForumChannel = require('./structures/ForumChannel');
+exports.Guild = require('./structures/Guild').Guild;
+exports.GuildAuditLogs = require('./structures/GuildAuditLogs');
+exports.GuildAuditLogsEntry = require('./structures/GuildAuditLogs').Entry;
+exports.GuildBan = require('./structures/GuildBan');
+exports.GuildChannel = require('./structures/GuildChannel');
+exports.GuildEmoji = require('./structures/GuildEmoji');
+exports.GuildMember = require('./structures/GuildMember').GuildMember;
+exports.GuildPreview = require('./structures/GuildPreview');
+exports.GuildPreviewEmoji = require('./structures/GuildPreviewEmoji');
+exports.GuildScheduledEvent = require('./structures/GuildScheduledEvent').GuildScheduledEvent;
+exports.GuildTemplate = require('./structures/GuildTemplate');
+exports.Integration = require('./structures/Integration');
+exports.IntegrationApplication = require('./structures/IntegrationApplication');
+exports.Invite = require('./structures/Invite');
+exports.InviteStageInstance = require('./structures/InviteStageInstance');
+exports.InviteGuild = require('./structures/InviteGuild');
+exports.MediaChannel = require('./structures/MediaChannel');
+exports.Message = require('./structures/Message').Message;
+exports.MessageActionRow = require('./structures/MessageActionRow');
+exports.MessageAttachment = require('./structures/MessageAttachment');
+exports.MessageButton = require('./structures/MessageButton');
+exports.MessageCollector = require('./structures/MessageCollector');
+exports.MessageEmbed = require('./structures/MessageEmbed');
+exports.MessageMentions = require('./structures/MessageMentions');
+exports.MessagePayload = require('./structures/MessagePayload');
+exports.MessageReaction = require('./structures/MessageReaction');
+exports.Modal = require('./structures/Modal');
+exports.NewsChannel = require('./structures/NewsChannel');
+exports.OAuth2Guild = require('./structures/OAuth2Guild');
+exports.GroupDMChannel = require('./structures/GroupDMChannel');
+exports.PermissionOverwrites = require('./structures/PermissionOverwrites');
+exports.Presence = require('./structures/Presence').Presence;
+exports.ReactionCollector = require('./structures/ReactionCollector');
+exports.ReactionEmoji = require('./structures/ReactionEmoji');
+exports.RichPresenceAssets = require('./structures/Presence').RichPresenceAssets;
+exports.Role = require('./structures/Role').Role;
+exports.Session = require('./structures/Session');
+exports.StageChannel = require('./structures/StageChannel');
+exports.StageInstance = require('./structures/StageInstance').StageInstance;
+exports.Sticker = require('./structures/Sticker').Sticker;
+exports.StickerPack = require('./structures/StickerPack');
+exports.StoreChannel = require('./structures/StoreChannel');
+exports.Team = require('./structures/Team');
+exports.TeamMember = require('./structures/TeamMember');
+exports.TextChannel = require('./structures/TextChannel');
+exports.TextInputComponent = require('./structures/TextInputComponent');
+exports.ThreadChannel = require('./structures/ThreadChannel');
+exports.ThreadOnlyChannel = require('./structures/ThreadOnlyChannel');
+exports.ThreadMember = require('./structures/ThreadMember');
+exports.Typing = require('./structures/Typing');
+exports.User = require('./structures/User');
+exports.VoiceChannel = require('./structures/VoiceChannel');
+exports.VoiceChannelEffect = require('./structures/VoiceChannelEffect');
+exports.VoiceRegion = require('./structures/VoiceRegion');
+exports.VoiceState = require('./structures/VoiceState');
+exports.Webhook = require('./structures/Webhook');
+exports.Widget = require('./structures/Widget');
+exports.WidgetMember = require('./structures/WidgetMember');
+exports.WelcomeChannel = require('./structures/WelcomeChannel');
+exports.WelcomeScreen = require('./structures/WelcomeScreen');
+
+exports.WebSocket = require('./WebSocket');
+
+exports.CustomStatus = require('./structures/Presence').CustomStatus;
+exports.RichPresence = require('./structures/Presence').RichPresence;
+exports.SpotifyRPC = require('./structures/Presence').SpotifyRPC;
+exports.WebEmbed = require('./structures/WebEmbed');
+exports.DiscordAuthWebsocket = require('./util/RemoteAuth');
+exports.PurchasedFlags = require('./util/PurchasedFlags');
+exports.Poll = require('./structures/Poll').Poll;
+exports.PollAnswer = require('./structures/PollAnswer').PollAnswer;
+exports.Recorder = require('./client/voice/receiver/Recorder');

package/src/managers/ApplicationCommandManager.js

@@ -0,0 +1,264 @@
+'use strict';
+
+const { isJSONEncodable } = require('@discordjs/builders');
+const { Collection } = require('@discordjs/collection');
+const ApplicationCommandPermissionsManager = require('./ApplicationCommandPermissionsManager');
+const CachedManager = require('./CachedManager');
+const { TypeError } = require('../errors');
+const ApplicationCommand = require('../structures/ApplicationCommand');
+const { ApplicationCommandTypes } = require('../util/Constants');
+const Permissions = require('../util/Permissions');
+
+/**
+ * Manages API methods for application commands and stores their cache.
+ * @extends {CachedManager}
+ */
+class ApplicationCommandManager extends CachedManager {
+  constructor(client, iterable) {
+    super(client, ApplicationCommand, iterable);
+
+    /**
+     * The manager for permissions of arbitrary commands on arbitrary guilds
+     * @type {ApplicationCommandPermissionsManager}
+     */
+    this.permissions = new ApplicationCommandPermissionsManager(this);
+  }
+
+  /**
+   * The cache of this manager
+   * @type {Collection<Snowflake, ApplicationCommand>}
+   * @name ApplicationCommandManager#cache
+   */
+
+  _add(data, cache, guildId) {
+    return super._add(data, cache, { extras: [this.guild, guildId] });
+  }
+
+  /**
+   * The APIRouter path to the commands
+   * @param {Snowflake} [options.id] The application command's id
+   * @param {Snowflake} [options.guildId] The guild's id to use in the path,
+   * ignored when using a {@link GuildApplicationCommandManager}
+   * @returns {Object}
+   * @private
+   */
+  commandPath({ id, guildId } = {}) {
+    let path = this.client.api.applications(this.client.application.id);
+    if (this.guild ?? guildId) path = path.guilds(this.guild?.id ?? guildId);
+    return id ? path.commands(id) : path.commands;
+  }
+
+  /**
+   * Data that resolves to give an ApplicationCommand object. This can be:
+   * * An ApplicationCommand object
+   * * A Snowflake
+   * @typedef {ApplicationCommand|Snowflake} ApplicationCommandResolvable
+   */
+
+  /* eslint-disable max-len */
+  /**
+   * Data that resolves to the data of an ApplicationCommand
+   * @typedef {ApplicationCommandData|APIApplicationCommand|SlashCommandBuilder|ContextMenuCommandBuilder} ApplicationCommandDataResolvable
+   */
+  /* eslint-enable max-len */
+
+  /**
+   * Options used to fetch data from Discord
+   * @typedef {Object} BaseFetchOptions
+   * @property {boolean} [cache=true] Whether to cache the fetched data if it wasn't already
+   * @property {boolean} [force=false] Whether to skip the cache check and request the API
+   */
+
+  /**
+   * Options used to fetch Application Commands from Discord
+   * @typedef {BaseFetchOptions} FetchApplicationCommandOptions
+   * @property {Snowflake} [guildId] The guild's id to fetch commands for, for when the guild is not cached
+   * @property {LocaleString} [locale] The locale to use when fetching this command
+   * @property {boolean} [withLocalizations] Whether to fetch all localization data
+   */
+
+  /**
+   * Obtains one or multiple application commands from Discord, or the cache if it's already available.
+   * @param {Snowflake} [id] The application command's id
+   * @param {FetchApplicationCommandOptions} [options] Additional options for this fetch
+   * @returns {Promise<ApplicationCommand|Collection<Snowflake, ApplicationCommand>>}
+   * @example
+   * // Fetch a single command
+   * client.application.commands.fetch('123456789012345678')
+   *   .then(command => console.log(`Fetched command ${command.name}`))
+   *   .catch(console.error);
+   * @example
+   * // Fetch all commands
+   * guild.commands.fetch()
+   *   .then(commands => console.log(`Fetched ${commands.size} commands`))
+   *   .catch(console.error);
+   */
+  async fetch(id, { guildId, cache = true, force = false, locale, withLocalizations } = {}) {
+    if (typeof id === 'object') {
+      ({ guildId, cache = true, locale, withLocalizations } = id);
+    } else if (id) {
+      if (!force) {
+        const existing = this.cache.get(id);
+        if (existing) return existing;
+      }
+      const command = await this.commandPath({ id, guildId }).get();
+      return this._add(command, cache);
+    }
+
+    const data = await this.commandPath({ guildId }).get({
+      headers: {
+        'X-Discord-Locale': locale,
+      },
+      query: typeof withLocalizations === 'boolean' ? { with_localizations: withLocalizations } : undefined,
+    });
+    return data.reduce((coll, command) => coll.set(command.id, this._add(command, cache, guildId)), new Collection());
+  }
+
+  /**
+   * Creates an application command.
+   * @param {ApplicationCommandDataResolvable} command The command
+   * @param {Snowflake} [guildId] The guild's id to create this command in,
+   * ignored when using a {@link GuildApplicationCommandManager}
+   * @returns {Promise<ApplicationCommand>}
+   * @example
+   * // Create a new command
+   * client.application.commands.create({
+   *   name: 'test',
+   *   description: 'A test command',
+   * })
+   *   .then(console.log)
+   *   .catch(console.error);
+   */
+  async create(command, guildId) {
+    const data = await this.commandPath({ guildId }).post({
+      data: this.constructor.transformCommand(command),
+    });
+    return this._add(data, true, guildId);
+  }
+
+  /**
+   * Sets all the commands for this application or guild.
+   * @param {ApplicationCommandDataResolvable[]} commands The commands
+   * @param {Snowflake} [guildId] The guild's id to create the commands in,
+   * ignored when using a {@link GuildApplicationCommandManager}
+   * @returns {Promise<Collection<Snowflake, ApplicationCommand>>}
+   * @example
+   * // Set all commands to just this one
+   * client.application.commands.set([
+   *   {
+   *     name: 'test',
+   *     description: 'A test command',
+   *   },
+   * ])
+   *   .then(console.log)
+   *   .catch(console.error);
+   * @example
+   * // Remove all commands
+   * guild.commands.set([])
+   *   .then(console.log)
+   *   .catch(console.error);
+   */
+  async set(commands, guildId) {
+    const data = await this.commandPath({ guildId }).put({
+      data: commands.map(c => this.constructor.transformCommand(c)),
+    });
+    return data.reduce((coll, command) => coll.set(command.id, this._add(command, true, guildId)), new Collection());
+  }
+
+  /**
+   * Edits an application command.
+   * @param {ApplicationCommandResolvable} command The command to edit
+   * @param {Partial<ApplicationCommandDataResolvable>} data The data to update the command with
+   * @param {Snowflake} [guildId] The guild's id where the command registered,
+   * ignored when using a {@link GuildApplicationCommandManager}
+   * @returns {Promise<ApplicationCommand>}
+   * @example
+   * // Edit an existing command
+   * client.application.commands.edit('123456789012345678', {
+   *   description: 'New description',
+   * })
+   *   .then(console.log)
+   *   .catch(console.error);
+   */
+  async edit(command, data, guildId) {
+    const id = this.resolveId(command);
+    if (!id) throw new TypeError('INVALID_TYPE', 'command', 'ApplicationCommandResolvable');
+
+    const patched = await this.commandPath({ id, guildId }).patch({
+      data: this.constructor.transformCommand(data),
+    });
+    return this._add(patched, true, guildId);
+  }
+
+  /**
+   * Deletes an application command.
+   * @param {ApplicationCommandResolvable} command The command to delete
+   * @param {Snowflake} [guildId] The guild's id where the command is registered,
+   * ignored when using a {@link GuildApplicationCommandManager}
+   * @returns {Promise<?ApplicationCommand>}
+   * @example
+   * // Delete a command
+   * guild.commands.delete('123456789012345678')
+   *   .then(console.log)
+   *   .catch(console.error);
+   */
+  async delete(command, guildId) {
+    const id = this.resolveId(command);
+    if (!id) throw new TypeError('INVALID_TYPE', 'command', 'ApplicationCommandResolvable');
+
+    await this.commandPath({ id, guildId }).delete();
+
+    const cached = this.cache.get(id);
+    this.cache.delete(id);
+    return cached ?? null;
+  }
+
+  /**
+   * Transforms an {@link ApplicationCommandData} object into something that can be used with the API.
+   * @param {ApplicationCommandDataResolvable} command The command to transform
+   * @returns {APIApplicationCommand}
+   * @private
+   */
+  static transformCommand(command) {
+    if (isJSONEncodable(command)) return command.toJSON();
+
+    let default_member_permissions;
+
+    if ('default_member_permissions' in command) {
+      default_member_permissions = command.default_member_permissions
+        ? new Permissions(BigInt(command.default_member_permissions)).bitfield.toString()
+        : command.default_member_permissions;
+    }
+
+    if ('defaultMemberPermissions' in command) {
+      default_member_permissions =
+        command.defaultMemberPermissions !== null
+          ? new Permissions(command.defaultMemberPermissions).bitfield.toString()
+          : command.defaultMemberPermissions;
+    }
+
+    return {
+      name: command.name,
+      name_localizations: command.nameLocalizations ?? command.name_localizations,
+      description: command.description,
+      description_localizations: command.descriptionLocalizations ?? command.description_localizations,
+      type: typeof command.type === 'number' ? command.type : ApplicationCommandTypes[command.type],
+      options: command.options?.map(o => ApplicationCommand.transformOption(o)),
+      default_permission: command.defaultPermission ?? command.default_permission,
+      default_member_permissions,
+      dm_permission: command.dmPermission ?? command.dm_permission,
+    };
+  }
+}
+
+module.exports = ApplicationCommandManager;
+
+/**
+ * @external SlashCommandBuilder
+ * @see {@link https://discord.js.org/docs/packages/builders/stable/SlashCommandBuilder:Class}
+ */
+
+/**
+ * @external ContextMenuCommandBuilder
+ * @see {@link https://discord.js.org/docs/packages/builders/stable/ContextMenuCommandBuilder:Class}
+ */