dan/discord.js
1
0
Fork 0
mirror of https://github.com/danbulant/discord.js synced 2026-07-10 05:31:13 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Webpack build for branch master: 2aa2f73c74

Browse source
This commit is contained in:
Travis CI 2017-08-17 18:06:57 +00:00
parent 424fc775db
commit 5b2acce316
1 changed files with 309 additions and 307 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

426
discord.master.js
View file

@ -198,12 +198,12 @@ exports.Endpoints = {
/** /**
* The current status of the client. Here are the available statuses: * The current status of the client. Here are the available statuses:
* - READY * * READY
* - CONNECTING * * CONNECTING
* - RECONNECTING * * RECONNECTING
* - IDLE * * IDLE
* - NEARLY * * NEARLY
* - DISCONNECTED * * DISCONNECTED
* @typedef {number} Status * @typedef {number} Status
*/ */
exports.Status = { exports.Status = {
@ -217,11 +217,11 @@ exports.Status = {
/** /**
* The current status of a voice connection. Here are the available statuses: * The current status of a voice connection. Here are the available statuses:
* - CONNECTED * * CONNECTED
* - CONNECTING * * CONNECTING
* - AUTHENTICATING * * AUTHENTICATING
* - RECONNECTING * * RECONNECTING
* - DISCONNECTED * * DISCONNECTED
* @typedef {number} VoiceStatus * @typedef {number} VoiceStatus
*/ */
exports.VoiceStatus = { exports.VoiceStatus = {
@ -312,41 +312,41 @@ exports.Events = {
/** /**
* The type of a websocket message event, e.g. `MESSAGE_CREATE`. Here are the available events: * The type of a websocket message event, e.g. `MESSAGE_CREATE`. Here are the available events:
* - READY * * READY
* - RESUMED * * RESUMED
* - GUILD_SYNC * * GUILD_SYNC
* - GUILD_CREATE * * GUILD_CREATE
* - GUILD_DELETE * * GUILD_DELETE
* - GUILD_UPDATE * * GUILD_UPDATE
* - GUILD_MEMBER_ADD * * GUILD_MEMBER_ADD
* - GUILD_MEMBER_REMOVE * * GUILD_MEMBER_REMOVE
* - GUILD_MEMBER_UPDATE * * GUILD_MEMBER_UPDATE
* - GUILD_MEMBERS_CHUNK * * GUILD_MEMBERS_CHUNK
* - GUILD_ROLE_CREATE * * GUILD_ROLE_CREATE
* - GUILD_ROLE_DELETE * * GUILD_ROLE_DELETE
* - GUILD_ROLE_UPDATE * * GUILD_ROLE_UPDATE
* - GUILD_BAN_ADD * * GUILD_BAN_ADD
* - GUILD_BAN_REMOVE * * GUILD_BAN_REMOVE
* - CHANNEL_CREATE * * CHANNEL_CREATE
* - CHANNEL_DELETE * * CHANNEL_DELETE
* - CHANNEL_UPDATE * * CHANNEL_UPDATE
* - CHANNEL_PINS_UPDATE * * CHANNEL_PINS_UPDATE
* - MESSAGE_CREATE * * MESSAGE_CREATE
* - MESSAGE_DELETE * * MESSAGE_DELETE
* - MESSAGE_UPDATE * * MESSAGE_UPDATE
* - MESSAGE_DELETE_BULK * * MESSAGE_DELETE_BULK
* - MESSAGE_REACTION_ADD * * MESSAGE_REACTION_ADD
* - MESSAGE_REACTION_REMOVE * * MESSAGE_REACTION_REMOVE
* - MESSAGE_REACTION_REMOVE_ALL * * MESSAGE_REACTION_REMOVE_ALL
* - USER_UPDATE * * USER_UPDATE
* - USER_NOTE_UPDATE * * USER_NOTE_UPDATE
* - USER_SETTINGS_UPDATE * * USER_SETTINGS_UPDATE
* - PRESENCE_UPDATE * * PRESENCE_UPDATE
* - VOICE_STATE_UPDATE * * VOICE_STATE_UPDATE
* - TYPING_START * * TYPING_START
* - VOICE_SERVER_UPDATE * * VOICE_SERVER_UPDATE
* - RELATIONSHIP_ADD * * RELATIONSHIP_ADD
* - RELATIONSHIP_REMOVE * * RELATIONSHIP_REMOVE
* @typedef {string} WSEventType * @typedef {string} WSEventType
*/ */
exports.WSEvents = { exports.WSEvents = {
@ -391,14 +391,14 @@ exports.WSEvents = {
/** /**
* The type of a message, e.g. `DEFAULT`. Here are the available types: * The type of a message, e.g. `DEFAULT`. Here are the available types:
* - DEFAULT * * DEFAULT
* - RECIPIENT_ADD * * RECIPIENT_ADD
* - RECIPIENT_REMOVE * * RECIPIENT_REMOVE
* - CALL * * CALL
* - CHANNEL_NAME_CHANGE * * CHANNEL_NAME_CHANGE
* - CHANNEL_ICON_CHANGE * * CHANNEL_ICON_CHANGE
* - PINS_ADD * * PINS_ADD
* - GUILD_MEMBER_JOIN * * GUILD_MEMBER_JOIN
* @typedef {string} MessageType * @typedef {string} MessageType
*/ */
exports.MessageTypes = [ exports.MessageTypes = [
@ -414,10 +414,10 @@ exports.MessageTypes = [
/** /**
* The type of a game of a users presence, e.g. `PLAYING`. Here are the available types: * The type of a game of a users presence, e.g. `PLAYING`. Here are the available types:
* - PLAYING * * PLAYING
* - STREAMING * * STREAMING
* - LISTENING * * LISTENING
* - WATCHING * * WATCHING
* @typedef {string} GameType * @typedef {string} GameType
*/ */
exports.GameTypes = [ exports.GameTypes = [
@ -629,9 +629,9 @@ exports.UserChannelOverrideMap = {
/** /**
* All flags users can have: * All flags users can have:
* - STAFF * * STAFF
* - PARTNER * * PARTNER
* - HYPESQUAD * * HYPESQUAD
* @typedef {string} UserFlags * @typedef {string} UserFlags
*/ */
exports.UserFlags = { exports.UserFlags = {
@ -675,49 +675,49 @@ exports.Colors = {
/** /**
* An error encountered while performing an API request. Here are the potential errors: * An error encountered while performing an API request. Here are the potential errors:
* - UNKNOWN_ACCOUNT * * UNKNOWN_ACCOUNT
* - UNKNOWN_APPLICATION * * UNKNOWN_APPLICATION
* - UNKNOWN_CHANNEL * * UNKNOWN_CHANNEL
* - UNKNOWN_GUILD * * UNKNOWN_GUILD
* - UNKNOWN_INTEGRATION * * UNKNOWN_INTEGRATION
* - UNKNOWN_INVITE * * UNKNOWN_INVITE
* - UNKNOWN_MEMBER * * UNKNOWN_MEMBER
* - UNKNOWN_MESSAGE * * UNKNOWN_MESSAGE
* - UNKNOWN_OVERWRITE * * UNKNOWN_OVERWRITE
* - UNKNOWN_PROVIDER * * UNKNOWN_PROVIDER
* - UNKNOWN_ROLE * * UNKNOWN_ROLE
* - UNKNOWN_TOKEN * * UNKNOWN_TOKEN
* - UNKNOWN_USER * * UNKNOWN_USER
* - UNKNOWN_EMOJI * * UNKNOWN_EMOJI
* - BOT_PROHIBITED_ENDPOINT * * BOT_PROHIBITED_ENDPOINT
* - BOT_ONLY_ENDPOINT * * BOT_ONLY_ENDPOINT
* - MAXIMUM_GUILDS * * MAXIMUM_GUILDS
* - MAXIMUM_FRIENDS * * MAXIMUM_FRIENDS
* - MAXIMUM_PINS * * MAXIMUM_PINS
* - MAXIMUM_ROLES * * MAXIMUM_ROLES
* - MAXIMUM_REACTIONS * * MAXIMUM_REACTIONS
* - UNAUTHORIZED * * UNAUTHORIZED
* - MISSING_ACCESS * * MISSING_ACCESS
* - INVALID_ACCOUNT_TYPE * * INVALID_ACCOUNT_TYPE
* - CANNOT_EXECUTE_ON_DM * * CANNOT_EXECUTE_ON_DM
* - EMBED_DISABLED * * EMBED_DISABLED
* - CANNOT_EDIT_MESSAGE_BY_OTHER * * CANNOT_EDIT_MESSAGE_BY_OTHER
* - CANNOT_SEND_EMPTY_MESSAGE * * CANNOT_SEND_EMPTY_MESSAGE
* - CANNOT_MESSAGE_USER * * CANNOT_MESSAGE_USER
* - CANNOT_SEND_MESSAGES_IN_VOICE_CHANNEL * * CANNOT_SEND_MESSAGES_IN_VOICE_CHANNEL
* - CHANNEL_VERIFICATION_LEVEL_TOO_HIGH * * CHANNEL_VERIFICATION_LEVEL_TOO_HIGH
* - OAUTH2_APPLICATION_BOT_ABSENT * * OAUTH2_APPLICATION_BOT_ABSENT
* - MAXIMUM_OAUTH2_APPLICATIONS * * MAXIMUM_OAUTH2_APPLICATIONS
* - INVALID_OAUTH_STATE * * INVALID_OAUTH_STATE
* - MISSING_PERMISSIONS * * MISSING_PERMISSIONS
* - INVALID_AUTHENTICATION_TOKEN * * INVALID_AUTHENTICATION_TOKEN
* - NOTE_TOO_LONG * * NOTE_TOO_LONG
* - INVALID_BULK_DELETE_QUANTITY * * INVALID_BULK_DELETE_QUANTITY
* - CANNOT_PIN_MESSAGE_IN_OTHER_CHANNEL * * CANNOT_PIN_MESSAGE_IN_OTHER_CHANNEL
* - CANNOT_EXECUTE_ON_SYSTEM_MESSAGE * * CANNOT_EXECUTE_ON_SYSTEM_MESSAGE
* - BULK_DELETE_MESSAGE_TOO_OLD * * BULK_DELETE_MESSAGE_TOO_OLD
* - INVITE_ACCEPTED_TO_GUILD_NOT_CONTANING_BOT * * INVITE_ACCEPTED_TO_GUILD_NOT_CONTANING_BOT
* - REACTION_BLOCKED * * REACTION_BLOCKED
* @typedef {string} APIError * @typedef {string} APIError
*/ */
exports.APIErrors = { exports.APIErrors = {
@ -1330,9 +1330,9 @@ class Util {
/** /**
* Parses emoji info out of a string. The string must be one of: * Parses emoji info out of a string. The string must be one of:
* - A UTF-8 emoji (no ID) * * A UTF-8 emoji (no ID)
* - A URL-encoded UTF-8 emoji (no ID) * * A URL-encoded UTF-8 emoji (no ID)
* - A Discord custom emoji (`<:name:id>`) * * A Discord custom emoji (`<:name:id>`)
* @param {string} text Emoji string to parse * @param {string} text Emoji string to parse
* @returns {Object} Object with `name` and `id` properties * @returns {Object} Object with `name` and `id` properties
* @private * @private
@ -3716,8 +3716,8 @@ class Message {
this.author = this.client.dataManager.newUser(data.author); this.author = this.client.dataManager.newUser(data.author);
/** /**
* Represents the author of the message as a guild member. Only available if the message comes from a guild * Represents the author of the message as a guild member
* where the author is still a member. * Only available if the message comes from a guild where the author is still a member
* @type {?GuildMember} * @type {?GuildMember}
*/ */
this.member = this.guild ? this.guild.member(this.author) || null : null; this.member = this.guild ? this.guild.member(this.author) || null : null;
@ -3883,8 +3883,8 @@ class Message {
} }
/** /**
* The message contents with all mentions replaced by the equivalent text. If mentions cannot be resolved to a name, * The message contents with all mentions replaced by the equivalent text.
* the relevant mention in the message content will not be converted * If mentions cannot be resolved to a name, the relevant mention in the message content will not be converted.
* @type {string} * @type {string}
* @readonly * @readonly
*/ */
@ -3945,8 +3945,8 @@ class Message {
*/ */
/** /**
* Similar to createCollector but in promise form. Resolves with a collection of reactions that pass the specified * Similar to createCollector but in promise form.
* filter. * Resolves with a collection of reactions that pass the specified filter.
* @param {CollectorFilter} filter The filter function to use * @param {CollectorFilter} filter The filter function to use
* @param {AwaitReactionsOptions} [options={}] Optional options to pass to the internal collector * @param {AwaitReactionsOptions} [options={}] Optional options to pass to the internal collector
* @returns {Promise<Collection<string, MessageReaction>>} * @returns {Promise<Collection<string, MessageReaction>>}
@ -4326,7 +4326,7 @@ class Permissions {
} }
/** /**
* Gets an object mapping permission name (like `READ_MESSAGES`) to a {@link boolean} indicating whether the * Gets an object mapping permission name (like `VIEW_CHANNEL`) to a {@link boolean} indicating whether the
* permission is available. * permission is available.
* @param {boolean} [checkAdmin=true] Whether to allow the administrator permission to override * @param {boolean} [checkAdmin=true] Whether to allow the administrator permission to override
* @returns {Object} * @returns {Object}
@ -4339,8 +4339,8 @@ class Permissions {
/** /**
* Data that can be resolved to give a permission number. This can be: * Data that can be resolved to give a permission number. This can be:
* - A string (see {@link Permissions.FLAGS}) * * A string (see {@link Permissions.FLAGS})
* - A permission number * * A permission number
* @typedef {string|number} PermissionResolvable * @typedef {string|number} PermissionResolvable
*/ */
@ -4359,34 +4359,34 @@ class Permissions {
/** /**
* Numeric permission flags. All available properties: * Numeric permission flags. All available properties:
* - `ADMINISTRATOR` (implicitly has *all* permissions, and bypasses all channel overwrites) * * `ADMINISTRATOR` (implicitly has *all* permissions, and bypasses all channel overwrites)
* - `CREATE_INSTANT_INVITE` (create invitations to the guild) * * `CREATE_INSTANT_INVITE` (create invitations to the guild)
* - `KICK_MEMBERS` * * `KICK_MEMBERS`
* - `BAN_MEMBERS` * * `BAN_MEMBERS`
* - `MANAGE_CHANNELS` (edit and reorder channels) * * `MANAGE_CHANNELS` (edit and reorder channels)
* - `MANAGE_GUILD` (edit the guild information, region, etc.) * * `MANAGE_GUILD` (edit the guild information, region, etc.)
* - `ADD_REACTIONS` (add new reactions to messages) * * `ADD_REACTIONS` (add new reactions to messages)
* - `VIEW_AUDIT_LOG` * * `VIEW_AUDIT_LOG`
* - `VIEW_CHANNELS` * * `VIEW_CHANNEL`
* - `SEND_MESSAGES` * * `SEND_MESSAGES`
* - `SEND_TTS_MESSAGES` * * `SEND_TTS_MESSAGES`
* - `MANAGE_MESSAGES` (delete messages and reactions) * * `MANAGE_MESSAGES` (delete messages and reactions)
* - `EMBED_LINKS` (links posted will have a preview embedded) * * `EMBED_LINKS` (links posted will have a preview embedded)
* - `ATTACH_FILES` * * `ATTACH_FILES`
* - `READ_MESSAGE_HISTORY` (view messages that were posted prior to opening Discord) * * `READ_MESSAGE_HISTORY` (view messages that were posted prior to opening Discord)
* - `MENTION_EVERYONE` * * `MENTION_EVERYONE`
* - `USE_EXTERNAL_EMOJIS` (use emojis from different guilds) * * `USE_EXTERNAL_EMOJIS` (use emojis from different guilds)
* - `CONNECT` (connect to a voice channel) * * `CONNECT` (connect to a voice channel)
* - `SPEAK` (speak in a voice channel) * * `SPEAK` (speak in a voice channel)
* - `MUTE_MEMBERS` (mute members across all voice channels) * * `MUTE_MEMBERS` (mute members across all voice channels)
* - `DEAFEN_MEMBERS` (deafen members across all voice channels) * * `DEAFEN_MEMBERS` (deafen members across all voice channels)
* - `MOVE_MEMBERS` (move members between voice channels) * * `MOVE_MEMBERS` (move members between voice channels)
* - `USE_VAD` (use voice activity detection) * * `USE_VAD` (use voice activity detection)
* - `CHANGE_NICKNAME` * * `CHANGE_NICKNAME`
* - `MANAGE_NICKNAMES` (change other members' nicknames) * * `MANAGE_NICKNAMES` (change other members' nicknames)
* - `MANAGE_ROLES` * * `MANAGE_ROLES`
* - `MANAGE_WEBHOOKS` * * `MANAGE_WEBHOOKS`
* - `MANAGE_EMOJIS` * * `MANAGE_EMOJIS`
* @type {Object} * @type {Object}
* @see {@link https://discordapp.com/developers/docs/topics/permissions} * @see {@link https://discordapp.com/developers/docs/topics/permissions}
*/ */
@ -5017,7 +5017,7 @@ class User {
} }
/** /**
* A link to the user's avatar * A link to the user's avatar.
* @param {Object} [options={}] Options for the avatar url * @param {Object} [options={}] Options for the avatar url
* @param {string} [options.format='webp'] One of `webp`, `png`, `jpg`, `gif`. If no format is provided, * @param {string} [options.format='webp'] One of `webp`, `png`, `jpg`, `gif`. If no format is provided,
* it will be `gif` for animated avatars or otherwise `webp` * it will be `gif` for animated avatars or otherwise `webp`
@ -5039,7 +5039,8 @@ class User {
} }
/** /**
* A link to the user's avatar if they have one. Otherwise a link to their default avatar will be returned * A link to the user's avatar if they have one.
* Otherwise a link to their default avatar will be returned.
* @param {Object} [options={}] Options for the avatar url * @param {Object} [options={}] Options for the avatar url
* @param {string} [options.format='webp'] One of `webp`, `png`, `jpg`, `gif`. If no format is provided, * @param {string} [options.format='webp'] One of `webp`, `png`, `jpg`, `gif`. If no format is provided,
* it will be `gif` for animated avatars or otherwise `webp` * it will be `gif` for animated avatars or otherwise `webp`
@ -5866,7 +5867,7 @@ class Role {
} }
/** /**
* Get an object mapping permission names to whether or not the role enables that permission * Get an object mapping permission names to whether or not the role enables that permission.
* @returns {Object<string, boolean>} * @returns {Object<string, boolean>}
* @example * @example
* // Print the serialized role permissions * // Print the serialized role permissions
@ -6451,7 +6452,7 @@ class MessageEmbed {
this.fields = data.fields || []; this.fields = data.fields || [];
/** /**
* The thumbnail of this embed, if there is one * The thumbnail of this embed (if there is one)
* @type {?Object} * @type {?Object}
* @property {string} url URL for this thumbnail * @property {string} url URL for this thumbnail
* @property {string} proxyURL ProxyURL for this thumbnail * @property {string} proxyURL ProxyURL for this thumbnail
@ -6481,7 +6482,7 @@ class MessageEmbed {
} : null; } : null;
/** /**
* The video of this embed, if there is one * The video of this embed (if there is one)
* @type {?Object} * @type {?Object}
* @property {string} url URL of this video * @property {string} url URL of this video
* @property {number} height Height of this video * @property {number} height Height of this video
@ -6490,7 +6491,7 @@ class MessageEmbed {
this.video = data.video; this.video = data.video;
/** /**
* The author of this embed, if there is one * The author of this embed (if there is one)
* @type {?Object} * @type {?Object}
* @property {string} name The name of this author * @property {string} name The name of this author
* @property {string} url URL of this author * @property {string} url URL of this author
@ -6505,7 +6506,7 @@ class MessageEmbed {
} : null; } : null;
/** /**
* The provider of this embed, if there is one * The provider of this embed (if there is one)
* @type {?Object} * @type {?Object}
* @property {string} name The name of this provider * @property {string} name The name of this provider
* @property {string} url URL of this provider * @property {string} url URL of this provider
@ -6531,9 +6532,7 @@ class MessageEmbed {
* @property {Array<FileOptions|string|Attachment>} files Files to attach * @property {Array<FileOptions|string|Attachment>} files Files to attach
*/ */
if (data.files) { if (data.files) {
for (let file of data.files) { for (let file of data.files) if (file instanceof Attachment) file = file.file;
if (file instanceof Attachment) file = file.file;
}
} else { data.files = null; } } else { data.files = null; }
} }
@ -6560,7 +6559,7 @@ class MessageEmbed {
* @param {StringResolvable} name The name of the field * @param {StringResolvable} name The name of the field
* @param {StringResolvable} value The value of the field * @param {StringResolvable} value The value of the field
* @param {boolean} [inline=false] Set the field to display inline * @param {boolean} [inline=false] Set the field to display inline
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
addField(name, value, inline = false) { addField(name, value, inline = false) {
if (this.fields.length >= 25) throw new RangeError('EMBED_FIELD_COUNT'); if (this.fields.length >= 25) throw new RangeError('EMBED_FIELD_COUNT');
@ -6575,7 +6574,7 @@ class MessageEmbed {
/** /**
* Convenience function for `<MessageEmbed>.addField('\u200B', '\u200B', inline)`. * Convenience function for `<MessageEmbed>.addField('\u200B', '\u200B', inline)`.
* @param {boolean} [inline=false] Set the field to display inline * @param {boolean} [inline=false] Set the field to display inline
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
addBlankField(inline = false) { addBlankField(inline = false) {
return this.addField('\u200B', '\u200B', inline); return this.addField('\u200B', '\u200B', inline);
@ -6585,7 +6584,7 @@ class MessageEmbed {
* Sets the file to upload alongside the embed. This file can be accessed via `attachment://fileName.extension` when * Sets the file to upload alongside the embed. This file can be accessed via `attachment://fileName.extension` when
* setting an embed image or author/footer icons. Only one file may be attached. * setting an embed image or author/footer icons. Only one file may be attached.
* @param {Array<FileOptions|string|Attachment>} files Files to attach * @param {Array<FileOptions|string|Attachment>} files Files to attach
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
attachFiles(files) { attachFiles(files) {
if (this.files) this.files = this.files.concat(files); if (this.files) this.files = this.files.concat(files);
@ -6601,7 +6600,7 @@ class MessageEmbed {
* @param {StringResolvable} name The name of the author * @param {StringResolvable} name The name of the author
* @param {string} [iconURL] The icon URL of the author * @param {string} [iconURL] The icon URL of the author
* @param {string} [url] The URL of the author * @param {string} [url] The URL of the author
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
setAuthor(name, iconURL, url) { setAuthor(name, iconURL, url) {
this.author = { name: Util.resolveString(name), iconURL, url }; this.author = { name: Util.resolveString(name), iconURL, url };
@ -6611,7 +6610,7 @@ class MessageEmbed {
/** /**
* Sets the color of this embed. * Sets the color of this embed.
* @param {ColorResolvable} color The color of the embed * @param {ColorResolvable} color The color of the embed
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
setColor(color) { setColor(color) {
this.color = Util.resolveColor(color); this.color = Util.resolveColor(color);
@ -6621,7 +6620,7 @@ class MessageEmbed {
/** /**
* Sets the description of this embed. * Sets the description of this embed.
* @param {StringResolvable} description The description * @param {StringResolvable} description The description
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
setDescription(description) { setDescription(description) {
description = Util.resolveString(description); description = Util.resolveString(description);
@ -6634,7 +6633,7 @@ class MessageEmbed {
* Sets the footer of this embed. * Sets the footer of this embed.
* @param {StringResolvable} text The text of the footer * @param {StringResolvable} text The text of the footer
* @param {string} [iconURL] The icon URL of the footer * @param {string} [iconURL] The icon URL of the footer
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
setFooter(text, iconURL) { setFooter(text, iconURL) {
text = Util.resolveString(text); text = Util.resolveString(text);
@ -6646,7 +6645,7 @@ class MessageEmbed {
/** /**
* Set the image of this embed. * Set the image of this embed.
* @param {string} url The URL of the image * @param {string} url The URL of the image
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
setImage(url) { setImage(url) {
this.image = { url }; this.image = { url };
@ -6656,7 +6655,7 @@ class MessageEmbed {
/** /**
* Set the thumbnail of this embed. * Set the thumbnail of this embed.
* @param {string} url The URL of the thumbnail * @param {string} url The URL of the thumbnail
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
setThumbnail(url) { setThumbnail(url) {
this.thumbnail = { url }; this.thumbnail = { url };
@ -6666,7 +6665,7 @@ class MessageEmbed {
/** /**
* Sets the timestamp of this embed. * Sets the timestamp of this embed.
* @param {Date} [timestamp=current date] The timestamp * @param {Date} [timestamp=current date] The timestamp
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
setTimestamp(timestamp = new Date()) { setTimestamp(timestamp = new Date()) {
this.timestamp = timestamp.getTime(); this.timestamp = timestamp.getTime();
@ -6676,7 +6675,7 @@ class MessageEmbed {
/** /**
* Sets the title of this embed. * Sets the title of this embed.
* @param {StringResolvable} title The title * @param {StringResolvable} title The title
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
setTitle(title) { setTitle(title) {
title = Util.resolveString(title); title = Util.resolveString(title);
@ -6688,7 +6687,7 @@ class MessageEmbed {
/** /**
* Sets the URL of this embed. * Sets the URL of this embed.
* @param {string} url The URL * @param {string} url The URL
* @returns {MessageEmbed} This embed * @returns {MessageEmbed}
*/ */
setURL(url) { setURL(url) {
this.url = url; this.url = url;
@ -6801,7 +6800,7 @@ class Game {
} }
/** /**
* Whether this game is equal to another game * Whether this game is equal to another game.
* @param {Game} game The game to compare with * @param {Game} game The game to compare with
* @returns {boolean} * @returns {boolean}
*/ */
@ -7403,7 +7402,8 @@ class Guild {
if (!this.emojis) { if (!this.emojis) {
/** /**
* A collection of emojis that are in this guild. The key is the emoji's ID, the value is the emoji. * A collection of emojis that are in this guild
* The key is the emoji's ID, the value is the emoji
* @type {Collection<Snowflake, Emoji>} * @type {Collection<Snowflake, Emoji>}
*/ */
this.emojis = new Collection(); this.emojis = new Collection();
@ -7444,7 +7444,7 @@ class Guild {
} }
/** /**
* Gets the URL to this guild's icon * The URL to this guild's icon.
* @param {Object} [options={}] Options for the icon url * @param {Object} [options={}] Options for the icon url
* @param {string} [options.format='webp'] One of `webp`, `png`, `jpg` * @param {string} [options.format='webp'] One of `webp`, `png`, `jpg`
* @param {number} [options.size=128] One of `128`, '256', `512`, `1024`, `2048` * @param {number} [options.size=128] One of `128`, '256', `512`, `1024`, `2048`
@ -7456,7 +7456,7 @@ class Guild {
} }
/** /**
* Gets the acronym that shows up in place of a guild icon * The acronym that shows up in place of a guild icon.
* @type {string} * @type {string}
* @readonly * @readonly
*/ */
@ -7465,7 +7465,7 @@ class Guild {
} }
/** /**
* The URL to this guild's splash * The URL to this guild's splash.
* @param {Object} [options={}] Options for the splash url * @param {Object} [options={}] Options for the splash url
* @param {string} [options.format='webp'] One of `webp`, `png`, `jpg` * @param {string} [options.format='webp'] One of `webp`, `png`, `jpg`
* @param {number} [options.size=128] One of `128`, '256', `512`, `1024`, `2048` * @param {number} [options.size=128] One of `128`, '256', `512`, `1024`, `2048`
@ -7626,7 +7626,8 @@ class Guild {
} }
/** /**
* Fetch a collection of invites to this guild. Resolves with a collection mapping invites by their codes. * Fetch a collection of invites to this guild.
* Resolves with a collection mapping invites by their codes.
* @returns {Promise<Collection<string, Invite>>} * @returns {Promise<Collection<string, Invite>>}
*/ */
fetchInvites() { fetchInvites() {
@ -7749,7 +7750,7 @@ class Guild {
fetchMembers({ query = '', limit = 0 } = {}) { fetchMembers({ query = '', limit = 0 } = {}) {
return new Promise((resolve, reject) => { return new Promise((resolve, reject) => {
if (this.memberCount === this.members.size) { if (this.memberCount === this.members.size) {
resolve((query || limit) ? new Collection() : this.members); resolve(query || limit ? new Collection() : this.members);
return; return;
} }
this.client.ws.send({ this.client.ws.send({
@ -7768,7 +7769,7 @@ class Guild {
} }
if (this.memberCount === this.members.size || ((query || limit) && members.size < 1000)) { if (this.memberCount === this.members.size || ((query || limit) && members.size < 1000)) {
this.client.removeListener(Constants.Events.GUILD_MEMBERS_CHUNK, handler); this.client.removeListener(Constants.Events.GUILD_MEMBERS_CHUNK, handler);
resolve((query || limit) ? fetchedMembers : this.members); resolve(query || limit ? fetchedMembers : this.members);
} }
}; };
this.client.on(Constants.Events.GUILD_MEMBERS_CHUNK, handler); this.client.on(Constants.Events.GUILD_MEMBERS_CHUNK, handler);
@ -9485,7 +9486,7 @@ class GuildMember {
} }
/** /**
* Ban this guild member * Ban this guild member.
* @param {Object|number|string} [options] Ban options. If a number, the number of days to delete messages for, if a * @param {Object|number|string} [options] Ban options. If a number, the number of days to delete messages for, if a
* string, the ban reason. Supplying an object allows you to do both. * string, the ban reason. Supplying an object allows you to do both.
* @param {number} [options.days=0] Number of days of messages to delete * @param {number} [options.days=0] Number of days of messages to delete
@ -9641,7 +9642,7 @@ class Emoji {
* @param {string} [reason] Reason for editing this emoji * @param {string} [reason] Reason for editing this emoji
* @returns {Promise<Emoji>} * @returns {Promise<Emoji>}
* @example * @example
* // Edit a emoji * // Edit an emoji
* emoji.edit({name: 'newemoji'}) * emoji.edit({name: 'newemoji'})
* .then(e => console.log(`Edited emoji ${e}`)) * .then(e => console.log(`Edited emoji ${e}`))
* .catch(console.error); * .catch(console.error);
@ -10040,7 +10041,7 @@ module.exports = Invite;
/***/ (function(module, exports) { /***/ (function(module, exports) {
/** /**
* Represents an attachment in a message * Represents an attachment in a message.
*/ */
class Attachment { class Attachment {
constructor(file, name) { constructor(file, name) {
@ -13144,7 +13145,7 @@ class GroupDMChannel extends Channel {
} }
/** /**
* Gets the URL to this Group DM's icon * Gets the URL to this Group DM's icon.
* @param {Object} [options={}] Options for the icon url * @param {Object} [options={}] Options for the icon url
* @param {string} [options.format='webp'] One of `webp`, `png`, `jpg` * @param {string} [options.format='webp'] One of `webp`, `png`, `jpg`
* @param {number} [options.size=128] One of `128`, '256', `512`, `1024`, `2048` * @param {number} [options.size=128] One of `128`, '256', `512`, `1024`, `2048`
@ -13468,7 +13469,7 @@ class ClientApplication {
} }
/** /**
* A link to the application's icon * A link to the application's icon.
* @param {Object} [options={}] Options for the icon url * @param {Object} [options={}] Options for the icon url
* @param {string} [options.format='webp'] One of `webp`, `png`, `jpg` * @param {string} [options.format='webp'] One of `webp`, `png`, `jpg`
* @param {number} [options.size=128] One of `128`, '256', `512`, `1024`, `2048` * @param {number} [options.size=128] One of `128`, '256', `512`, `1024`, `2048`
@ -13480,7 +13481,7 @@ class ClientApplication {
} }
/** /**
* A link to this application's cover image * A link to this application's cover image.
* @param {Object} [options={}] Options for the cover image url * @param {Object} [options={}] Options for the cover image url
* @param {string} [options.format='webp'] One of `webp`, `png`, `jpg` * @param {string} [options.format='webp'] One of `webp`, `png`, `jpg`
* @param {number} [options.size=128] One of `128`, '256', `512`, `1024`, `2048` * @param {number} [options.size=128] One of `128`, '256', `512`, `1024`, `2048`
@ -13494,7 +13495,7 @@ class ClientApplication {
} }
/** /**
* Get rich presence assets * Get rich presence assets.
* @returns {Promise<Object>} * @returns {Promise<Object>}
*/ */
fetchAssets() { fetchAssets() {
@ -13507,7 +13508,7 @@ class ClientApplication {
} }
/** /**
* Create a rich presence asset * Create a rich presence asset.
* @param {string} name Name of the asset * @param {string} name Name of the asset
* @param {Base64Resolvable} data Data of the asset * @param {Base64Resolvable} data Data of the asset
* @param {string} type Type of the asset. `big`, or `small` * @param {string} type Type of the asset. `big`, or `small`
@ -16050,7 +16051,7 @@ const assert = __webpack_require__(108);
const util = __webpack_require__(39); const util = __webpack_require__(39);
/** /**
* Extend an error of some sort into a DiscordjsError * Extend an error of some sort into a DiscordjsError.
* @param {Error} Base Base error to extend * @param {Error} Base Base error to extend
* @returns {DiscordjsError} * @returns {DiscordjsError}
*/ */
@ -16073,7 +16074,7 @@ function makeDiscordjsError(Base) {
} }
/** /**
* Format the message for an error * Format the message for an error.
* @param {string} key Error key * @param {string} key Error key
* @param {Array<*>} args Arguments to pass for util format or as function args * @param {Array<*>} args Arguments to pass for util format or as function args
* @returns {string} Formatted string * @returns {string} Formatted string
@ -16093,7 +16094,7 @@ function message(key, args) {
} }
/** /**
* Register an error code and message * Register an error code and message.
* @param {string} sym Unique name for the error * @param {string} sym Unique name for the error
* @param {*} val Value of the error * @param {*} val Value of the error
*/ */
@ -16256,7 +16257,8 @@ class MessageCollector extends Collector {
super(channel.client, filter, options); super(channel.client, filter, options);
/** /**
* @type {TextBasedChannel} channel The channel * The channel
* @type {TextBasedChannel}
*/ */
this.channel = channel; this.channel = channel;
@ -16284,7 +16286,7 @@ class MessageCollector extends Collector {
/** /**
* Handle a message for possible collection. * Handle a message for possible collection.
* @param {Message} message The message that could be collected * @param {Message} message The message that could be collected
* @returns {?{key: Snowflake, value: Message}} Message data to collect * @returns {?{key: Snowflake, value: Message}}
* @private * @private
*/ */
collect(message) { collect(message) {
@ -16299,7 +16301,7 @@ class MessageCollector extends Collector {
/** /**
* Handle a message for possible disposal. * Handle a message for possible disposal.
* @param {Message} message The message that could be disposed * @param {Message} message The message that could be disposed
* @returns {?string} The message ID. * @returns {?string}
*/ */
dispose(message) { dispose(message) {
return message.channel.id === this.channel.id ? message.id : null; return message.channel.id === this.channel.id ? message.id : null;
@ -16307,7 +16309,7 @@ class MessageCollector extends Collector {
/** /**
* Check after un/collection to see if the collector is done. * Check after un/collection to see if the collector is done.
* @returns {?string} Reason to end the collector, if any * @returns {?string}
* @private * @private
*/ */
endReason() { endReason() {
@ -16454,7 +16456,7 @@ class TextChannel extends GuildChannel {
* @param {string} [reason] Reason for creating this webhook * @param {string} [reason] Reason for creating this webhook
* @returns {Promise<Webhook>} webhook The created webhook * @returns {Promise<Webhook>} webhook The created webhook
* @example * @example
* channel.createWebhook('Snek', 'http://snek.s3.amazonaws.com/topSnek.png') * channel.createWebhook('Snek', 'https://i.imgur.com/mI8XcpG.jpg')
* .then(webhook => console.log(`Created webhook ${webhook}`)) * .then(webhook => console.log(`Created webhook ${webhook}`))
* .catch(console.error) * .catch(console.error)
*/ */
@ -16789,8 +16791,8 @@ class MessageMentions {
} }
/** /**
* Check if a user is mentioned. Takes into account user mentions, role * Check if a user is mentioned.
* mentions, and @everyone/@here mentions. * Takes into account user mentions, role mentions, and @everyone/@here mentions.
* @param {UserResolvable|GuildMember|Role|GuildChannel} data User/GuildMember/Role/Channel to check * @param {UserResolvable|GuildMember|Role|GuildChannel} data User/GuildMember/Role/Channel to check
* @param {boolean} [strict=true] If role mentions and everyone/here mentions should be included * @param {boolean} [strict=true] If role mentions and everyone/here mentions should be included
* @returns {boolean} * @returns {boolean}
@ -17085,7 +17087,7 @@ class ReactionCollector extends Collector {
/** /**
* Handle an incoming reaction for possible collection. * Handle an incoming reaction for possible collection.
* @param {MessageReaction} reaction The reaction to possibly collect * @param {MessageReaction} reaction The reaction to possibly collect
* @returns {?{key: Snowflake, value: MessageReaction}} Reaction data to collect * @returns {?{key: Snowflake, value: MessageReaction}}
* @private * @private
*/ */
collect(reaction) { collect(reaction) {
@ -17099,7 +17101,7 @@ class ReactionCollector extends Collector {
/** /**
* Handle a reaction deletion for possible disposal. * Handle a reaction deletion for possible disposal.
* @param {MessageReaction} reaction The reaction to possibly dispose * @param {MessageReaction} reaction The reaction to possibly dispose
* @returns {?Snowflake|string} The reaction key * @returns {?Snowflake|string}
*/ */
dispose(reaction) { dispose(reaction) {
return reaction.message.id === this.message.id && !reaction.count ? ReactionCollector.key(reaction) : null; return reaction.message.id === this.message.id && !reaction.count ? ReactionCollector.key(reaction) : null;
@ -17125,7 +17127,7 @@ class ReactionCollector extends Collector {
/** /**
* Get the collector key for a reaction. * Get the collector key for a reaction.
* @param {MessageReaction} reaction The message reaction to get the key for * @param {MessageReaction} reaction The message reaction to get the key for
* @returns {Snowflake|string} The emoji ID (if custom) or the emoji name (if native; will be unicode) * @returns {Snowflake|string}
*/ */
static key(reaction) { static key(reaction) {
return reaction.emoji.id || reaction.emoji.name; return reaction.emoji.id || reaction.emoji.name;
@ -17466,7 +17468,7 @@ class GuildAuditLogsEntry {
this.executor = guild.client.users.get(data.user_id); this.executor = guild.client.users.get(data.user_id);
/** /**
* An entry in the audit log representing a specific change * An entry in the audit log representing a specific change.
* @typedef {object} AuditLogChange * @typedef {object} AuditLogChange
* @property {string} key The property that was changed, e.g. `nick` for nickname changes * @property {string} key The property that was changed, e.g. `nick` for nickname changes
* @property {*} [old] The old value of the change, e.g. for nicknames, the old nickname * @property {*} [old] The old value of the change, e.g. for nicknames, the old nickname
@ -17670,12 +17672,12 @@ const WebSocket = (function findWebSocket() {
class WebSocketConnection extends EventEmitter { class WebSocketConnection extends EventEmitter {
/** /**
* @param {WebSocketManager} manager The WebSocket manager * @param {WebSocketManager} manager The WebSocket manager
* @param {string} gateway WebSocket gateway to connect to * @param {string} gateway The WebSocket gateway to connect to
*/ */
constructor(manager, gateway) { constructor(manager, gateway) {
super(); super();
/** /**
* WebSocket Manager of this connection * The WebSocket Manager of this connection
* @type {WebSocketManager} * @type {WebSocketManager}
*/ */
this.manager = manager; this.manager = manager;
@ -17874,7 +17876,7 @@ class WebSocketConnection extends EventEmitter {
/** /**
* Creates a connection to a gateway. * Creates a connection to a gateway.
* @param {string} gateway Gateway to connect to * @param {string} gateway The gateway to connect to
* @param {number} [after=0] How long to wait before connecting * @param {number} [after=0] How long to wait before connecting
* @param {boolean} [force=false] Whether or not to force a new connection even if one already exists * @param {boolean} [force=false] Whether or not to force a new connection even if one already exists
* @returns {boolean} * @returns {boolean}
@ -17999,7 +18001,7 @@ class WebSocketConnection extends EventEmitter {
/** /**
* Called whenever an error occurs with the WebSocket. * Called whenever an error occurs with the WebSocket.
* @param {Error} error Error that occurred * @param {Error} error The error that occurred
*/ */
onError(error) { onError(error) {
if (error && error.message === 'uWs client connection error') { if (error && error.message === 'uWs client connection error') {
@ -18236,7 +18238,7 @@ class ClientUser extends User {
/** /**
* All of the user's guild settings * All of the user's guild settings
* @type {Collection<Snowflake, ClientUserGuildSettings>} * @type {Collection<Snowflake, ClientUserGuildSettings>}
* <warn>This is only filled when using a user account</warn> * <warn>This is only filled when using a user account.</warn>
*/ */
this.guildSettings = new Collection(); this.guildSettings = new Collection();
if (data.user_guild_settings) { if (data.user_guild_settings) {
@ -18406,10 +18408,10 @@ class ClientUser extends User {
/** /**
* A user's status. Must be one of: * A user's status. Must be one of:
* - `online` * * `online`
* - `idle` * * `idle`
* - `invisible` * * `invisible`
* - `dnd` (do not disturb) * * `dnd` (do not disturb)
* @typedef {string} PresenceStatus * @typedef {string} PresenceStatus
*/ */
@ -18656,7 +18658,7 @@ class ClientDataResolver {
/** /**
* Data that resolves to give a User object. This can be: * Data that resolves to give a User object. This can be:
* * A User object * * A User object
* * A user ID * * A Snowflake
* * A Message object (resolves to the message author) * * A Message object (resolves to the message author)
* * A Guild object (owner of the guild) * * A Guild object (owner of the guild)
* * A GuildMember object * * A GuildMember object
@ -18693,7 +18695,7 @@ class ClientDataResolver {
/** /**
* Data that resolves to give a Guild object. This can be: * Data that resolves to give a Guild object. This can be:
* * A Guild object * * A Guild object
* * A Guild ID * * A Snowflake
* @typedef {Guild|Snowflake} GuildResolvable * @typedef {Guild|Snowflake} GuildResolvable
*/ */
@ -18755,7 +18757,7 @@ class ClientDataResolver {
* * A Channel object * * A Channel object
* * A Message object (the channel the message was sent in) * * A Message object (the channel the message was sent in)
* * A Guild object (the #general channel) * * A Guild object (the #general channel)
* * A channel ID * * A Snowflake
* @typedef {Channel|Guild|Message|Snowflake} ChannelResolvable * @typedef {Channel|Guild|Message|Snowflake} ChannelResolvable
*/ */
@ -23935,7 +23937,7 @@ class UserProfile {
this.user = user; this.user = user;
/** /**
* The client that created the instance of the UserProfile. * The client that created the instance of the UserProfile
* @name UserProfile#client * @name UserProfile#client
* @type {Client} * @type {Client}
* @readonly * @readonly
@ -25425,7 +25427,7 @@ const Constants = __webpack_require__(0);
const WebSocketConnection = __webpack_require__(73); const WebSocketConnection = __webpack_require__(73);
/** /**
* WebSocket Manager of the client * WebSocket Manager of the client.
* @private * @private
*/ */
class WebSocketManager extends EventEmitter { class WebSocketManager extends EventEmitter {
@ -25445,7 +25447,7 @@ class WebSocketManager extends EventEmitter {
} }
/** /**
* Sends a heartbeat on the available connection * Sends a heartbeat on the available connection.
* @returns {void} * @returns {void}
*/ */
heartbeat() { heartbeat() {
@ -25489,7 +25491,7 @@ class WebSocketManager extends EventEmitter {
/** /**
* Connects the client to a gateway. * Connects the client to a gateway.
* @param {string} gateway Gateway to connect to * @param {string} gateway The gateway to connect to
* @returns {boolean} * @returns {boolean}
*/ */
connect(gateway) { connect(gateway) {