Update Guild.js

pls wait
This commit is contained in:
Elysia 2024-01-11 18:24:08 +07:00
parent 37d3b4aa33
commit 07c40b4003

View File

@ -11,13 +11,13 @@ const Webhook = require('./Webhook');
const WelcomeScreen = require('./WelcomeScreen'); const WelcomeScreen = require('./WelcomeScreen');
const { Error } = require('../errors'); const { Error } = require('../errors');
const AutoModerationRuleManager = require('../managers/AutoModerationRuleManager'); const AutoModerationRuleManager = require('../managers/AutoModerationRuleManager');
const GuildApplicationCommandManager = require('../managers/GuildApplicationCommandManager');
const GuildBanManager = require('../managers/GuildBanManager'); const GuildBanManager = require('../managers/GuildBanManager');
const GuildChannelManager = require('../managers/GuildChannelManager'); const GuildChannelManager = require('../managers/GuildChannelManager');
const GuildEmojiManager = require('../managers/GuildEmojiManager'); const GuildEmojiManager = require('../managers/GuildEmojiManager');
const GuildInviteManager = require('../managers/GuildInviteManager'); const GuildInviteManager = require('../managers/GuildInviteManager');
const GuildMemberManager = require('../managers/GuildMemberManager'); const GuildMemberManager = require('../managers/GuildMemberManager');
const GuildScheduledEventManager = require('../managers/GuildScheduledEventManager'); const GuildScheduledEventManager = require('../managers/GuildScheduledEventManager');
const GuildSettingManager = require('../managers/GuildSettingManager');
const GuildStickerManager = require('../managers/GuildStickerManager'); const GuildStickerManager = require('../managers/GuildStickerManager');
const PresenceManager = require('../managers/PresenceManager'); const PresenceManager = require('../managers/PresenceManager');
const RoleManager = require('../managers/RoleManager'); const RoleManager = require('../managers/RoleManager');
@ -33,7 +33,6 @@ const {
PremiumTiers, PremiumTiers,
} = require('../util/Constants'); } = require('../util/Constants');
const DataResolver = require('../util/DataResolver'); const DataResolver = require('../util/DataResolver');
const Permissions = require('../util/Permissions');
const SystemChannelFlags = require('../util/SystemChannelFlags'); const SystemChannelFlags = require('../util/SystemChannelFlags');
const Util = require('../util/Util'); const Util = require('../util/Util');
@ -60,55 +59,61 @@ class Guild extends AnonymousGuild {
super(client, data, false); super(client, data, false);
/** /**
* A manager of the members belonging to this guild. * A manager of the application commands belonging to this guild
* @type {GuildApplicationCommandManager}
*/
this.commands = new GuildApplicationCommandManager(this);
/**
* A manager of the members belonging to this guild
* @type {GuildMemberManager} * @type {GuildMemberManager}
*/ */
this.members = new GuildMemberManager(this); this.members = new GuildMemberManager(this);
/** /**
* A manager of the channels belonging to this guild. * A manager of the channels belonging to this guild
* @type {GuildChannelManager} * @type {GuildChannelManager}
*/ */
this.channels = new GuildChannelManager(this); this.channels = new GuildChannelManager(this);
/** /**
* A manager of the bans belonging to this guild. * A manager of the bans belonging to this guild
* @type {GuildBanManager} * @type {GuildBanManager}
*/ */
this.bans = new GuildBanManager(this); this.bans = new GuildBanManager(this);
/** /**
* A manager of the roles belonging to this guild. * A manager of the roles belonging to this guild
* @type {RoleManager} * @type {RoleManager}
*/ */
this.roles = new RoleManager(this); this.roles = new RoleManager(this);
/** /**
* A manager of the presences belonging to this guild. * A manager of the presences belonging to this guild
* @type {PresenceManager} * @type {PresenceManager}
*/ */
this.presences = new PresenceManager(this.client); this.presences = new PresenceManager(this.client);
/** /**
* A manager of the voice states of this guild. * A manager of the voice states of this guild
* @type {VoiceStateManager} * @type {VoiceStateManager}
*/ */
this.voiceStates = new VoiceStateManager(this); this.voiceStates = new VoiceStateManager(this);
/** /**
* A manager of the stage instances of this guild. * A manager of the stage instances of this guild
* @type {StageInstanceManager} * @type {StageInstanceManager}
*/ */
this.stageInstances = new StageInstanceManager(this); this.stageInstances = new StageInstanceManager(this);
/** /**
* A manager of the invites of this guild. * A manager of the invites of this guild
* @type {GuildInviteManager} * @type {GuildInviteManager}
*/ */
this.invites = new GuildInviteManager(this); this.invites = new GuildInviteManager(this);
/** /**
* A manager of the scheduled events of this guild. * A manager of the scheduled events of this guild
* @type {GuildScheduledEventManager} * @type {GuildScheduledEventManager}
*/ */
this.scheduledEvents = new GuildScheduledEventManager(this); this.scheduledEvents = new GuildScheduledEventManager(this);
@ -120,10 +125,9 @@ class Guild extends AnonymousGuild {
this.autoModerationRules = new AutoModerationRuleManager(this); this.autoModerationRules = new AutoModerationRuleManager(this);
if (!data) return; if (!data) return;
if (data.unavailable) { if (data.unavailable) {
/** /**
* Whether the guild is available to access. If it is not available, it indicates a server outage. * Whether the guild is available to access. If it is not available, it indicates a server outage
* @type {boolean} * @type {boolean}
*/ */
this.available = false; this.available = false;
@ -137,12 +141,10 @@ class Guild extends AnonymousGuild {
* @type {number} * @type {number}
*/ */
this.shardId = data.shardId; this.shardId = data.shardId;
this.settings = new GuildSettingManager(this.client, this.id);
} }
/** /**
* Whether or not the structure has been deleted. * Whether or not the structure has been deleted
* @type {boolean} * @type {boolean}
* @deprecated This will be removed in the next major version, see https://github.com/discordjs/discord.js/issues/7091 * @deprecated This will be removed in the next major version, see https://github.com/discordjs/discord.js/issues/7091
*/ */
@ -193,7 +195,7 @@ class Guild extends AnonymousGuild {
if ('discovery_splash' in data) { if ('discovery_splash' in data) {
/** /**
* The hash of the guild discovery splash image. * The hash of the guild discovery splash image
* @type {?string} * @type {?string}
*/ */
this.discoverySplash = data.discovery_splash; this.discoverySplash = data.discovery_splash;
@ -201,7 +203,7 @@ class Guild extends AnonymousGuild {
if ('member_count' in data) { if ('member_count' in data) {
/** /**
* The full amount of members in this guild. * The full amount of members in this guild
* @type {number} * @type {number}
*/ */
this.memberCount = data.member_count; this.memberCount = data.member_count;
@ -209,7 +211,7 @@ class Guild extends AnonymousGuild {
if ('large' in data) { if ('large' in data) {
/** /**
* Whether the guild is "large" (has more than {@link WebsocketOptions large_threshold} members, 50 by default). * Whether the guild is "large" (has more than {@link WebsocketOptions large_threshold} members, 50 by default)
* @type {boolean} * @type {boolean}
*/ */
this.large = Boolean(data.large); this.large = Boolean(data.large);
@ -217,7 +219,7 @@ class Guild extends AnonymousGuild {
if ('premium_progress_bar_enabled' in data) { if ('premium_progress_bar_enabled' in data) {
/** /**
* Whether this guild has its premium (boost) progress bar enabled. * Whether this guild has its premium (boost) progress bar enabled
* @type {boolean} * @type {boolean}
*/ */
this.premiumProgressBarEnabled = data.premium_progress_bar_enabled; this.premiumProgressBarEnabled = data.premium_progress_bar_enabled;
@ -228,9 +230,6 @@ class Guild extends AnonymousGuild {
* * ANIMATED_ICON * * ANIMATED_ICON
* * AUTO_MODERATION * * AUTO_MODERATION
* * BANNER * * BANNER
* * CLYDE_ENABLED
* <warn> `CLYDE_ENABLED` is now an experimental feature of Discord.
* See [this](https://rollouts.advaith.io/#2023-03_clyde_ai) for more information.</warn>
* * COMMERCE * * COMMERCE
* * COMMUNITY * * COMMUNITY
* * CREATOR_MONETIZABLE_PROVISIONAL * * CREATOR_MONETIZABLE_PROVISIONAL
@ -254,9 +253,9 @@ class Guild extends AnonymousGuild {
* * MORE_STICKERS * * MORE_STICKERS
* * THREE_DAY_THREAD_ARCHIVE * * THREE_DAY_THREAD_ARCHIVE
* * SEVEN_DAY_THREAD_ARCHIVE * * SEVEN_DAY_THREAD_ARCHIVE
* * RAID_ALERTS_DISABLED
* * PRIVATE_THREADS * * PRIVATE_THREADS
* * ROLE_ICONS * * ROLE_ICONS
* * RAID_ALERTS_DISABLED
* * ROLE_SUBSCRIPTIONS_AVAILABLE_FOR_PURCHASE * * ROLE_SUBSCRIPTIONS_AVAILABLE_FOR_PURCHASE
* * ROLE_SUBSCRIPTIONS_ENABLED * * ROLE_SUBSCRIPTIONS_ENABLED
* @typedef {string} Features * @typedef {string} Features
@ -265,7 +264,7 @@ class Guild extends AnonymousGuild {
if ('application_id' in data) { if ('application_id' in data) {
/** /**
* The id of the application that created this guild (if applicable). * The id of the application that created this guild (if applicable)
* @type {?Snowflake} * @type {?Snowflake}
*/ */
this.applicationId = data.application_id; this.applicationId = data.application_id;
@ -273,7 +272,7 @@ class Guild extends AnonymousGuild {
if ('afk_timeout' in data) { if ('afk_timeout' in data) {
/** /**
* The time in seconds before a user is counted as "away from keyboard". * The time in seconds before a user is counted as "away from keyboard"
* @type {?number} * @type {?number}
*/ */
this.afkTimeout = data.afk_timeout; this.afkTimeout = data.afk_timeout;
@ -281,7 +280,7 @@ class Guild extends AnonymousGuild {
if ('afk_channel_id' in data) { if ('afk_channel_id' in data) {
/** /**
* The id of the voice channel where AFK members are moved. * The id of the voice channel where AFK members are moved
* @type {?Snowflake} * @type {?Snowflake}
*/ */
this.afkChannelId = data.afk_channel_id; this.afkChannelId = data.afk_channel_id;
@ -289,7 +288,7 @@ class Guild extends AnonymousGuild {
if ('system_channel_id' in data) { if ('system_channel_id' in data) {
/** /**
* The system channel's id. * The system channel's id
* @type {?Snowflake} * @type {?Snowflake}
*/ */
this.systemChannelId = data.system_channel_id; this.systemChannelId = data.system_channel_id;
@ -297,7 +296,7 @@ class Guild extends AnonymousGuild {
if ('premium_tier' in data) { if ('premium_tier' in data) {
/** /**
* The premium tier of this guild. * The premium tier of this guild
* @type {PremiumTier} * @type {PremiumTier}
*/ */
this.premiumTier = PremiumTiers[data.premium_tier]; this.premiumTier = PremiumTiers[data.premium_tier];
@ -305,7 +304,7 @@ class Guild extends AnonymousGuild {
if ('widget_enabled' in data) { if ('widget_enabled' in data) {
/** /**
* Whether widget images are enabled on this guild. * Whether widget images are enabled on this guild
* @type {?boolean} * @type {?boolean}
*/ */
this.widgetEnabled = data.widget_enabled; this.widgetEnabled = data.widget_enabled;
@ -313,7 +312,7 @@ class Guild extends AnonymousGuild {
if ('widget_channel_id' in data) { if ('widget_channel_id' in data) {
/** /**
* The widget channel's id, if enabled. * The widget channel's id, if enabled
* @type {?string} * @type {?string}
*/ */
this.widgetChannelId = data.widget_channel_id; this.widgetChannelId = data.widget_channel_id;
@ -321,7 +320,7 @@ class Guild extends AnonymousGuild {
if ('explicit_content_filter' in data) { if ('explicit_content_filter' in data) {
/** /**
* The explicit content filter level of the guild. * The explicit content filter level of the guild
* @type {ExplicitContentFilterLevel} * @type {ExplicitContentFilterLevel}
*/ */
this.explicitContentFilter = ExplicitContentFilterLevels[data.explicit_content_filter]; this.explicitContentFilter = ExplicitContentFilterLevels[data.explicit_content_filter];
@ -329,7 +328,7 @@ class Guild extends AnonymousGuild {
if ('mfa_level' in data) { if ('mfa_level' in data) {
/** /**
* The required MFA level for this guild. * The required MFA level for this guild
* @type {MFALevel} * @type {MFALevel}
*/ */
this.mfaLevel = MFALevels[data.mfa_level]; this.mfaLevel = MFALevels[data.mfa_level];
@ -337,7 +336,7 @@ class Guild extends AnonymousGuild {
if ('joined_at' in data) { if ('joined_at' in data) {
/** /**
* The timestamp the client user joined the guild at. * The timestamp the client user joined the guild at
* @type {number} * @type {number}
*/ */
this.joinedTimestamp = new Date(data.joined_at).getTime(); this.joinedTimestamp = new Date(data.joined_at).getTime();
@ -345,7 +344,7 @@ class Guild extends AnonymousGuild {
if ('default_message_notifications' in data) { if ('default_message_notifications' in data) {
/** /**
* The default message notification level of the guild. * The default message notification level of the guild
* @type {DefaultMessageNotificationLevel} * @type {DefaultMessageNotificationLevel}
*/ */
this.defaultMessageNotifications = DefaultMessageNotificationLevels[data.default_message_notifications]; this.defaultMessageNotifications = DefaultMessageNotificationLevels[data.default_message_notifications];
@ -353,7 +352,7 @@ class Guild extends AnonymousGuild {
if ('system_channel_flags' in data) { if ('system_channel_flags' in data) {
/** /**
* The value set for the guild's system channel flags. * The value set for the guild's system channel flags
* @type {Readonly<SystemChannelFlags>} * @type {Readonly<SystemChannelFlags>}
*/ */
this.systemChannelFlags = new SystemChannelFlags(data.system_channel_flags).freeze(); this.systemChannelFlags = new SystemChannelFlags(data.system_channel_flags).freeze();
@ -361,7 +360,7 @@ class Guild extends AnonymousGuild {
if ('max_members' in data) { if ('max_members' in data) {
/** /**
* The maximum amount of members the guild can have. * The maximum amount of members the guild can have
* @type {?number} * @type {?number}
*/ */
this.maximumMembers = data.max_members; this.maximumMembers = data.max_members;
@ -371,8 +370,8 @@ class Guild extends AnonymousGuild {
if ('max_presences' in data) { if ('max_presences' in data) {
/** /**
* The maximum amount of presences the guild can have. * The maximum amount of presences the guild can have
* <info>You will need to fetch the guild using {@link Guild#fetch} if you want to receive this parameter.</info> * <info>You will need to fetch the guild using {@link Guild#fetch} if you want to receive this parameter</info>
* @type {?number} * @type {?number}
*/ */
this.maximumPresences = data.max_presences ?? 25_000; this.maximumPresences = data.max_presences ?? 25_000;
@ -402,8 +401,8 @@ class Guild extends AnonymousGuild {
if ('approximate_member_count' in data) { if ('approximate_member_count' in data) {
/** /**
* The approximate amount of members the guild has. * The approximate amount of members the guild has
* <info>You will need to fetch the guild using {@link Guild#fetch} if you want to receive this parameter.</info> * <info>You will need to fetch the guild using {@link Guild#fetch} if you want to receive this parameter</info>
* @type {?number} * @type {?number}
*/ */
this.approximateMemberCount = data.approximate_member_count; this.approximateMemberCount = data.approximate_member_count;
@ -413,8 +412,8 @@ class Guild extends AnonymousGuild {
if ('approximate_presence_count' in data) { if ('approximate_presence_count' in data) {
/** /**
* The approximate amount of presences the guild has. * The approximate amount of presences the guild has
* <info>You will need to fetch the guild using {@link Guild#fetch} if you want to receive this parameter.</info> * <info>You will need to fetch the guild using {@link Guild#fetch} if you want to receive this parameter</info>
* @type {?number} * @type {?number}
*/ */
this.approximatePresenceCount = data.approximate_presence_count; this.approximatePresenceCount = data.approximate_presence_count;
@ -423,15 +422,15 @@ class Guild extends AnonymousGuild {
} }
/** /**
* The use count of the vanity URL code of the guild, if any. * The use count of the vanity URL code of the guild, if any
* <info>You will need to fetch this parameter using {@link Guild#fetchVanityData} if you want to receive it.</info> * <info>You will need to fetch this parameter using {@link Guild#fetchVanityData} if you want to receive it</info>
* @type {?number} * @type {?number}
*/ */
this.vanityURLUses ??= null; this.vanityURLUses ??= null;
if ('rules_channel_id' in data) { if ('rules_channel_id' in data) {
/** /**
* The rules channel's id for the guild. * The rules channel's id for the guild
* @type {?Snowflake} * @type {?Snowflake}
*/ */
this.rulesChannelId = data.rules_channel_id; this.rulesChannelId = data.rules_channel_id;
@ -439,7 +438,7 @@ class Guild extends AnonymousGuild {
if ('public_updates_channel_id' in data) { if ('public_updates_channel_id' in data) {
/** /**
* The community updates channel's id for the guild. * The community updates channel's id for the guild
* @type {?Snowflake} * @type {?Snowflake}
*/ */
this.publicUpdatesChannelId = data.public_updates_channel_id; this.publicUpdatesChannelId = data.public_updates_channel_id;
@ -447,7 +446,7 @@ class Guild extends AnonymousGuild {
if ('preferred_locale' in data) { if ('preferred_locale' in data) {
/** /**
* The preferred locale of the guild, defaults to `en-US`. * The preferred locale of the guild, defaults to `en-US`
* @type {Locale} * @type {Locale}
* @see {@link https://discord.com/developers/docs/reference#locales} * @see {@link https://discord.com/developers/docs/reference#locales}
*/ */
@ -489,7 +488,7 @@ class Guild extends AnonymousGuild {
if ('owner_id' in data) { if ('owner_id' in data) {
/** /**
* The user id of this guild's owner. * The user id of this guild's owner
* @type {Snowflake} * @type {Snowflake}
*/ */
this.ownerId = data.owner_id; this.ownerId = data.owner_id;
@ -524,7 +523,7 @@ class Guild extends AnonymousGuild {
if (!this.emojis) { if (!this.emojis) {
/** /**
* A manager of the emojis belonging to this guild. * A manager of the emojis belonging to this guild
* @type {GuildEmojiManager} * @type {GuildEmojiManager}
*/ */
this.emojis = new GuildEmojiManager(this); this.emojis = new GuildEmojiManager(this);
@ -538,13 +537,11 @@ class Guild extends AnonymousGuild {
if (!this.stickers) { if (!this.stickers) {
/** /**
* A manager of the stickers belonging to this guild. * A manager of the stickers belonging to this guild
* @type {GuildStickerManager} * @type {GuildStickerManager}
*/ */
this.stickers = new GuildStickerManager(this); this.stickers = new GuildStickerManager(this);
if (data.stickers) { if (data.stickers) for (const sticker of data.stickers) this.stickers._add(sticker);
for (const sticker of data.stickers) this.stickers._add(sticker);
}
} else if (data.stickers) { } else if (data.stickers) {
this.client.actions.GuildStickersUpdate.handle({ this.client.actions.GuildStickersUpdate.handle({
guild_id: this.id, guild_id: this.id,
@ -554,7 +551,7 @@ class Guild extends AnonymousGuild {
} }
/** /**
* The time the client user joined the guild. * The time the client user joined the guild
* @type {Date} * @type {Date}
* @readonly * @readonly
*/ */
@ -582,7 +579,7 @@ class Guild extends AnonymousGuild {
} }
/** /**
* AFK voice channel for this guild. * AFK voice channel for this guild
* @type {?VoiceChannel} * @type {?VoiceChannel}
* @readonly * @readonly
*/ */
@ -591,7 +588,7 @@ class Guild extends AnonymousGuild {
} }
/** /**
* System channel for this guild. * System channel for this guild
* @type {?TextChannel} * @type {?TextChannel}
* @readonly * @readonly
*/ */
@ -609,7 +606,7 @@ class Guild extends AnonymousGuild {
} }
/** /**
* Widget channel for this guild. * Widget channel for this guild
* @type {?(TextChannel|NewsChannel|VoiceChannel|StageChannel|ForumChannel)} * @type {?(TextChannel|NewsChannel|VoiceChannel|StageChannel|ForumChannel)}
* @readonly * @readonly
*/ */
@ -618,7 +615,7 @@ class Guild extends AnonymousGuild {
} }
/** /**
* Rules channel for this guild. * Rules channel for this guild
* @type {?TextChannel} * @type {?TextChannel}
* @readonly * @readonly
*/ */
@ -627,7 +624,7 @@ class Guild extends AnonymousGuild {
} }
/** /**
* Public updates channel for this guild. * Public updates channel for this guild
* @type {?TextChannel} * @type {?TextChannel}
* @readonly * @readonly
*/ */
@ -636,7 +633,7 @@ class Guild extends AnonymousGuild {
} }
/** /**
* The client user as a GuildMember of this guild. * The client user as a GuildMember of this guild
* @type {?GuildMember} * @type {?GuildMember}
* @deprecated Use {@link GuildMemberManager#me} instead. * @deprecated Use {@link GuildMemberManager#me} instead.
* @readonly * @readonly
@ -651,7 +648,7 @@ class Guild extends AnonymousGuild {
} }
/** /**
* The maximum bitrate available for this guild. * The maximum bitrate available for this guild
* @type {number} * @type {number}
* @readonly * @readonly
*/ */
@ -672,30 +669,6 @@ class Guild extends AnonymousGuild {
} }
} }
/**
* Mute a guild
* @param {boolean} mute Weather or not you want to mute the guild
* @param {?number} time The amount of time you want to mute the server for in seconds
* @returns {boolean} true if it worked and false if it didn't
* @example
* guild.mute(true, 3600) // mutes the guild for an hour
* guild.mute(true, -1) // mutes the guild forever
* guild.mute(false); // unmutes the guild
*/
async mute(mute, time) {
if (mute && time == null) return false;
if (time == null && !mute) await this.client.api.guilds(this.id).settings.patch({ muted: false });
let ms = time * 1000;
let date = new Date(Date.now() + ms).toISOString();
return this.settings.edit({
mute_config: {
end_time: date,
selected_time_window: time,
},
muted: true,
});
}
/** /**
* Fetches a collection of integrations to this guild. * Fetches a collection of integrations to this guild.
* Resolves with a collection mapping integrations by their ids. * Resolves with a collection mapping integrations by their ids.
@ -762,7 +735,7 @@ class Guild extends AnonymousGuild {
/** /**
* Fetches the vanity URL invite object to this guild. * Fetches the vanity URL invite object to this guild.
* Resolves with an object containing the vanity URL invite code and the use count. * Resolves with an object containing the vanity URL invite code and the use count
* @returns {Promise<Vanity>} * @returns {Promise<Vanity>}
* @example * @example
* // Fetch invite data * // Fetch invite data
@ -792,9 +765,7 @@ class Guild extends AnonymousGuild {
async fetchWebhooks() { async fetchWebhooks() {
const apiHooks = await this.client.api.guilds(this.id).webhooks.get(); const apiHooks = await this.client.api.guilds(this.id).webhooks.get();
const hooks = new Collection(); const hooks = new Collection();
for (const hook of apiHooks) { for (const hook of apiHooks) hooks.set(hook.id, new Webhook(this.client, hook));
hooks.set(hook.id, new Webhook(this.client, hook));
}
return hooks; return hooks;
} }
@ -812,14 +783,14 @@ class Guild extends AnonymousGuild {
} }
/** /**
* Data for the Guild Widget Settings object. * Data for the Guild Widget Settings object
* @typedef {Object} GuildWidgetSettings * @typedef {Object} GuildWidgetSettings
* @property {boolean} enabled Whether the widget is enabled * @property {boolean} enabled Whether the widget is enabled
* @property {?GuildChannel} channel The widget invite channel * @property {?GuildChannel} channel The widget invite channel
*/ */
/** /**
* The Guild Widget Settings object. * The Guild Widget Settings object
* @typedef {Object} GuildWidgetSettingsData * @typedef {Object} GuildWidgetSettingsData
* @property {boolean} enabled Whether the widget is enabled * @property {boolean} enabled Whether the widget is enabled
* @property {?GuildChannelResolvable} channel The widget invite channel * @property {?GuildChannelResolvable} channel The widget invite channel
@ -874,6 +845,7 @@ class Guild extends AnonymousGuild {
action_type: typeof type === 'string' ? GuildAuditLogs.Actions[type] : type, action_type: typeof type === 'string' ? GuildAuditLogs.Actions[type] : type,
}, },
}); });
return GuildAuditLogs.build(this, data); return GuildAuditLogs.build(this, data);
} }
@ -891,8 +863,8 @@ class Guild extends AnonymousGuild {
* @property {?(BufferResolvable|Base64Resolvable)} [splash] The invite splash image of the guild * @property {?(BufferResolvable|Base64Resolvable)} [splash] The invite splash image of the guild
* @property {?(BufferResolvable|Base64Resolvable)} [discoverySplash] The discovery splash image of the guild * @property {?(BufferResolvable|Base64Resolvable)} [discoverySplash] The discovery splash image of the guild
* @property {?(BufferResolvable|Base64Resolvable)} [banner] The banner of the guild * @property {?(BufferResolvable|Base64Resolvable)} [banner] The banner of the guild
* @property {?(DefaultMessageNotificationLevel|number)} [defaultMessageNotifications] The default message notification * @property {?(DefaultMessageNotificationLevel|number)} [defaultMessageNotifications] The default message
* level of the guild * notification level of the guild
* @property {SystemChannelFlagsResolvable} [systemChannelFlags] The system channel flags of the guild * @property {SystemChannelFlagsResolvable} [systemChannelFlags] The system channel flags of the guild
* @property {?TextChannelResolvable} [rulesChannel] The rules channel of the guild * @property {?TextChannelResolvable} [rulesChannel] The rules channel of the guild
* @property {?TextChannelResolvable} [publicUpdatesChannel] The community updates channel of the guild * @property {?TextChannelResolvable} [publicUpdatesChannel] The community updates channel of the guild
@ -946,19 +918,13 @@ class Guild extends AnonymousGuild {
_data.system_channel_id = this.client.channels.resolveId(data.systemChannel); _data.system_channel_id = this.client.channels.resolveId(data.systemChannel);
} }
if (data.afkTimeout) _data.afk_timeout = Number(data.afkTimeout); if (data.afkTimeout) _data.afk_timeout = Number(data.afkTimeout);
if (typeof data.icon !== 'undefined') { if (typeof data.icon !== 'undefined') _data.icon = await DataResolver.resolveImage(data.icon);
_data.icon = await DataResolver.resolveImage(data.icon);
}
if (data.owner) _data.owner_id = this.client.users.resolveId(data.owner); if (data.owner) _data.owner_id = this.client.users.resolveId(data.owner);
if (typeof data.splash !== 'undefined') { if (typeof data.splash !== 'undefined') _data.splash = await DataResolver.resolveImage(data.splash);
_data.splash = await DataResolver.resolveImage(data.splash);
}
if (typeof data.discoverySplash !== 'undefined') { if (typeof data.discoverySplash !== 'undefined') {
_data.discovery_splash = await DataResolver.resolveImage(data.discoverySplash); _data.discovery_splash = await DataResolver.resolveImage(data.discoverySplash);
} }
if (typeof data.banner !== 'undefined') { if (typeof data.banner !== 'undefined') _data.banner = await DataResolver.resolveImage(data.banner);
_data.banner = await DataResolver.resolveImage(data.banner);
}
if (typeof data.explicitContentFilter !== 'undefined') { if (typeof data.explicitContentFilter !== 'undefined') {
_data.explicit_content_filter = _data.explicit_content_filter =
typeof data.explicitContentFilter === 'number' typeof data.explicitContentFilter === 'number'
@ -990,15 +956,13 @@ class Guild extends AnonymousGuild {
if (typeof data.safetyAlertsChannel !== 'undefined') { if (typeof data.safetyAlertsChannel !== 'undefined') {
_data.safety_alerts_channel_id = this.client.channels.resolveId(data.safetyAlertsChannel); _data.safety_alerts_channel_id = this.client.channels.resolveId(data.safetyAlertsChannel);
} }
if ('premiumProgressBarEnabled' in data) { if ('premiumProgressBarEnabled' in data) _data.premium_progress_bar_enabled = data.premiumProgressBarEnabled;
_data.premium_progress_bar_enabled = data.premiumProgressBarEnabled;
}
const newData = await this.client.api.guilds(this.id).patch({ data: _data, reason }); const newData = await this.client.api.guilds(this.id).patch({ data: _data, reason });
return this.client.actions.GuildUpdate.handle(newData).updated; return this.client.actions.GuildUpdate.handle(newData).updated;
} }
/** /**
* Welcome channel data. * Welcome channel data
* @typedef {Object} WelcomeChannelData * @typedef {Object} WelcomeChannelData
* @property {string} description The description to show for this welcome channel * @property {string} description The description to show for this welcome channel
* @property {TextChannel|NewsChannel|StoreChannel|Snowflake} channel The channel to link for this welcome channel * @property {TextChannel|NewsChannel|StoreChannel|Snowflake} channel The channel to link for this welcome channel
@ -1006,7 +970,7 @@ class Guild extends AnonymousGuild {
*/ */
/** /**
* Welcome screen edit data. * Welcome screen edit data
* @typedef {Object} WelcomeScreenEditData * @typedef {Object} WelcomeScreenEditData
* @property {boolean} [enabled] Whether the welcome screen is enabled * @property {boolean} [enabled] Whether the welcome screen is enabled
* @property {string} [description] The description for the welcome screen * @property {string} [description] The description for the welcome screen
@ -1030,7 +994,7 @@ class Guild extends AnonymousGuild {
*/ */
/** /**
* Updates the guild's welcome screen. * Updates the guild's welcome screen
* @param {WelcomeScreenEditData} data Data to edit the welcome screen with * @param {WelcomeScreenEditData} data Data to edit the welcome screen with
* @returns {Promise<WelcomeScreen>} * @returns {Promise<WelcomeScreen>}
* @example * @example
@ -1080,7 +1044,7 @@ class Guild extends AnonymousGuild {
/* eslint-disable max-len */ /* eslint-disable max-len */
/** /**
* Edits the setting of the default message notifications of the guild. * Edits the setting of the default message notifications of the guild.
* @param {DefaultMessageNotificationLevel|number} defaultMessageNotifications The new default message notification level of the guild * @param {?(DefaultMessageNotificationLevel|number)} defaultMessageNotifications The new default message notification level of the guild
* @param {string} [reason] Reason for changing the setting of the default message notifications * @param {string} [reason] Reason for changing the setting of the default message notifications
* @returns {Promise<Guild>} * @returns {Promise<Guild>}
*/ */
@ -1116,7 +1080,7 @@ class Guild extends AnonymousGuild {
/** /**
* Edits the verification level of the guild. * Edits the verification level of the guild.
* @param {(VerificationLevel|number)} verificationLevel The new verification level of the guild * @param {?(VerificationLevel|number)} verificationLevel The new verification level of the guild
* @param {string} [reason] Reason for changing the guild's verification level * @param {string} [reason] Reason for changing the guild's verification level
* @returns {Promise<Guild>} * @returns {Promise<Guild>}
* @example * @example
@ -1236,7 +1200,7 @@ class Guild extends AnonymousGuild {
} }
/** /**
* Sets a new guild's banner. * Sets a new guild banner.
* @param {?(Base64Resolvable|BufferResolvable)} banner The new banner of the guild * @param {?(Base64Resolvable|BufferResolvable)} banner The new banner of the guild
* @param {string} [reason] Reason for changing the guild's banner * @param {string} [reason] Reason for changing the guild's banner
* @returns {Promise<Guild>} * @returns {Promise<Guild>}
@ -1263,47 +1227,6 @@ class Guild extends AnonymousGuild {
setRulesChannel(rulesChannel, reason) { setRulesChannel(rulesChannel, reason) {
return this.edit({ rulesChannel }, reason); return this.edit({ rulesChannel }, reason);
} }
/**
* Change Guild Position (from * to Folder or Home).
* @param {number} position Guild Position
* * **WARNING**: Type = `FOLDER`, newPosition is the guild's index in the Folder.
* @param {string|number} type Move to folder or home
* * `FOLDER`: 1
* * `HOME`: 2
* @param {string|number|void|null} folderID If you want to move to folder
* @returns {Promise<Guild>}
* @example
* // Move guild to folderID 123456, index 1
* guild.setPosition(1, 'FOLDER', 123456)
* .then(guild => console.log(`Guild moved to folderID ${guild.folder.folderId}`));
*/
async setPosition(position, type, folderID) {
if (type == 1 || `${type}`.toUpperCase() === 'FOLDER') {
folderID = folderID || this.folder.folderId;
if (!['number', 'string'].includes(typeof folderID)) {
throw new TypeError('INVALID_TYPE', 'folderID', 'String | Number');
}
// Get Data from Folder ID
const folder = await this.client.settings.rawSetting.guild_folders.find(obj => obj.id == folderID);
if (!folder) throw new Error('FOLDER_NOT_FOUND');
if (folder.guild_ids.length - 1 < position || position < 0) {
throw new Error('FOLDER_POSITION_INVALID');
}
if (position !== folder.guild_ids.indexOf(this.id)) {
await this.client.settings.guildChangePosition(this.id, position, 1, folderID);
}
} else if (type == 2 || `${type}`.toUpperCase() === 'HOME') {
if (this.client.settings.guild_positions - 1 < position || position < 0) {
throw new Error('FOLDER_POSITION_INVALID');
}
if (position !== this.position) {
await this.client.settings.guildChangePosition(this.id, position, 2, null);
}
} else {
throw new TypeError('INVALID_TYPE', 'type', '`Folder`| `Home`');
}
return this;
}
/** /**
* Edits the community updates channel of the guild. * Edits the community updates channel of the guild.
@ -1351,7 +1274,7 @@ class Guild extends AnonymousGuild {
} }
/** /**
* Edits the enabled state of the guild's premium progress bar. * Edits the enabled state of the guild's premium progress bar
* @param {boolean} [enabled=true] The new enabled state of the guild's premium progress bar * @param {boolean} [enabled=true] The new enabled state of the guild's premium progress bar
* @param {string} [reason] Reason for changing the state of the guild's premium progress bar * @param {string} [reason] Reason for changing the state of the guild's premium progress bar
* @returns {Promise<Guild>} * @returns {Promise<Guild>}
@ -1378,7 +1301,7 @@ class Guild extends AnonymousGuild {
/** /**
* Batch-updates the guild's channels' positions. * Batch-updates the guild's channels' positions.
* <info>Only one channel's parent can be changed at a time.</info> * <info>Only one channel's parent can be changed at a time</info>
* @param {ChannelPosition[]} channelPositions Channel positions to update * @param {ChannelPosition[]} channelPositions Channel positions to update
* @returns {Promise<Guild>} * @returns {Promise<Guild>}
* @deprecated Use {@link GuildChannelManager#setPositions} instead * @deprecated Use {@link GuildChannelManager#setPositions} instead
@ -1401,14 +1324,14 @@ class Guild extends AnonymousGuild {
} }
/** /**
* The data needed for updating a guild role's position. * The data needed for updating a guild role's position
* @typedef {Object} GuildRolePosition * @typedef {Object} GuildRolePosition
* @property {RoleResolvable} role The role's id * @property {RoleResolvable} role The role's id
* @property {number} position The position to update * @property {number} position The position to update
*/ */
/** /**
* Batch-updates the guild's role positions. * Batch-updates the guild's role positions
* @param {GuildRolePosition[]} rolePositions Role positions to update * @param {GuildRolePosition[]} rolePositions Role positions to update
* @returns {Promise<Guild>} * @returns {Promise<Guild>}
* @deprecated Use {@link RoleManager#setPositions} instead * @deprecated Use {@link RoleManager#setPositions} instead
@ -1446,6 +1369,7 @@ class Guild extends AnonymousGuild {
}); });
return this; return this;
} }
/** /**
* Sets whether this guild's invites are disabled. * Sets whether this guild's invites are disabled.
* @param {boolean} [disabled=true] Whether the invites are disabled * @param {boolean} [disabled=true] Whether the invites are disabled
@ -1463,7 +1387,7 @@ class Guild extends AnonymousGuild {
* @example * @example
* // Leave a guild * // Leave a guild
* guild.leave() * guild.leave()
* .then(guild => console.log(`Left the guild ${guild.name}`)) * .then(guild => console.log(`Left the guild: ${guild.name}`))
* .catch(console.error); * .catch(console.error);
*/ */
async leave() { async leave() {
@ -1472,32 +1396,17 @@ class Guild extends AnonymousGuild {
return this.client.actions.GuildDelete.handle({ id: this.id }).guild; return this.client.actions.GuildDelete.handle({ id: this.id }).guild;
} }
/**
* Marks the guild as read.
* @returns {Promise<undefined>} nothing :)
* @example
* const guild = client.guilds.fetch('222078108977594368');
* guild.read();
*/
async read() {
await this.client.api.guilds(this.id).ack.post();
}
/** /**
* Deletes the guild. * Deletes the guild.
* @param {string} [mfaCode] The MFA code for the guild owner
* @returns {Promise<Guild>} * @returns {Promise<Guild>}
* @example * @example
* // Delete a guild * // Delete a guild
* guild.delete() * guild.delete()
* .then(guild => console.log(`Deleted the guild ${guild.name}`)) * .then(g => console.log(`Deleted the guild ${g}`))
* .catch(console.error); * .catch(console.error);
*/ */
async delete(mfaCode) { async delete() {
if ((!mfaCode || typeof mfaCode !== 'string' || mfaCode.length !== 6) && this.client.user.mfaEnabled) { await this.client.api.guilds(this.id).delete();
throw new Error('MFA_INVALID');
}
await this.client.api.guilds(this.id).delete({ data: mfaCode ? { code: mfaCode } : undefined });
return this.client.actions.GuildDelete.handle({ id: this.id }).guild; return this.client.actions.GuildDelete.handle({ id: this.id }).guild;
} }
@ -1528,14 +1437,41 @@ class Guild extends AnonymousGuild {
); );
} }
toJSON() {
const json = super.toJSON({
available: false,
createdTimestamp: true,
nameAcronym: true,
presences: false,
voiceStates: false,
});
json.iconURL = this.iconURL();
json.splashURL = this.splashURL();
json.discoverySplashURL = this.discoverySplashURL();
json.bannerURL = this.bannerURL();
return json;
}
/**
* Marks the guild as read.
* @returns {Promise<void>}
* @example
* const guild = client.guilds.cache.get('id');
* guild.markAsRead();
*/
markAsRead() {
return this.client.api.guilds(this.id).ack.post();
}
/** /**
* Set Community Feature. * Set Community Feature.
* @param {boolean} stats True / False to enable / disable Community Feature * @param {boolean} stats True / False to enable / disable Community Feature
* @param {TextChannelResolvable} publicUpdatesChannel The community updates channel of the guild * @param {GuildTextChannelResolvable} [publicUpdatesChannel] The community updates channel of the guild
* @param {TextChannelResolvable} rulesChannel The new rules channel * @param {GuildTextChannelResolvable} [rulesChannel] The new rules channel
* @param {string} reason Reason for changing the community feature * @param {string} [reason] Reason for changing the community feature
* @returns {Promise<Guild>}
*/ */
async setCommunity(stats = true, publicUpdatesChannel = '1', rulesChannel = '1', reason) { async setCommunity(stats = true, publicUpdatesChannel, rulesChannel, reason) {
if (stats) { if (stats) {
// Check everyone role // Check everyone role
const everyoneRole = this.roles.everyone; const everyoneRole = this.roles.everyone;
@ -1543,19 +1479,19 @@ class Guild extends AnonymousGuild {
await everyoneRole.setMentionable(false, reason); await everyoneRole.setMentionable(false, reason);
} }
// Setting // Setting
this.edit( return this.edit(
{ {
defaultMessageNotifications: 'ONLY_MENTIONS', defaultMessageNotifications: 'ONLY_MENTIONS',
explicitContentFilter: 'ALL_MEMBERS', explicitContentFilter: 'ALL_MEMBERS',
features: [...this.features, 'COMMUNITY'], features: [...this.features, 'COMMUNITY'],
publicUpdatesChannel, publicUpdatesChannel: this.channels.resolveId(publicUpdatesChannel) || '1',
rulesChannel, rulesChannel: this.channels.resolveId(rulesChannel) || '1',
verificationLevel: VerificationLevels[this.verificationLevel] < 1 ? 'LOW' : this.verificationLevel, // Email verificationLevel: VerificationLevels[this.verificationLevel] < 1 ? 'LOW' : this.verificationLevel, // Email
}, },
reason, reason,
); );
} else { } else {
this.edit( return this.edit(
{ {
publicUpdatesChannel: null, publicUpdatesChannel: null,
rulesChannel: null, rulesChannel: null,
@ -1569,60 +1505,23 @@ class Guild extends AnonymousGuild {
} }
/** /**
* Add Integrations to the guild. * Get the top emojis of this guild.
* @param {Snowflake} applicationId Application (ID) target * @returns {Promise<Collection<number, GuildEmoji>>}
* @returns {Promise<boolean>}
*/ */
addIntegration(applicationId) { topEmojis() {
if (!this.me.permissions.has('MANAGE_WEBHOOKS')) { return new Promise((resolve, reject) => {
throw new Error('MISSING_PERMISSIONS', 'MANAGE_WEBHOOKS'); this.client.api
} .guilds(this.id)
if (!this.me.permissions.has('MANAGE_GUILD')) { ['top-emojis'].get()
throw new Error('MISSING_PERMISSIONS', 'MANAGE_GUILD'); .then(data => {
} const emojis = new Collection();
if (!applicationId || typeof applicationId !== 'string') throw new TypeError('INVALID_APPLICATION_ID'); for (const emoji of data.items) {
return this.client.authorizeURL( emojis.set(emoji.emoji_rank, this.emojis.cache.get(emoji.emoji_id));
`https://discord.com/api/oauth2/authorize?client_id=${applicationId}&scope=applications.commands`, }
{ resolve(emojis);
guild_id: this.id, })
permissions: `0`, .catch(reject);
authorize: true, });
},
);
}
/**
* Add Bot to the guild.
* @param {UserResolvable} bot BotId / ApplicationId
* @param {?PermissionResolvable} permissions Permissions
* @returns {Promise<boolean>}
*/
addBot(bot, permissions) {
if (!this.me.permissions.has('MANAGE_WEBHOOKS')) {
throw new Error('MISSING_PERMISSIONS', 'MANAGE_WEBHOOKS');
}
if (!this.me.permissions.has('MANAGE_GUILD')) {
throw new Error('MISSING_PERMISSIONS', 'MANAGE_GUILD');
}
if (!this.client.options.captchaService) throw new Error('MISSING_CAPTCHA_SERVICE');
const botId = this.client.users.resolveId(bot);
const permission = new Permissions(Permissions.resolve(permissions ?? 0n));
if (!botId) throw new TypeError('INVALID_BOT_ID');
// Check permission
const selfPerm = this.me.permissions.toArray();
const missingPerms = permission.toArray().filter(x => !selfPerm.includes(x));
if (missingPerms.length) {
throw new Error('MISSING_PERMISSIONS', missingPerms.join(', '));
}
// Add bot
return this.client.authorizeURL(
`https://discord.com/api/oauth2/authorize?client_id=${botId}&permissions=${permission.bitfield}&scope=applications.commands%20bot`,
{
guild_id: this.id,
permissions: `${permission.bitfield}`,
authorize: true,
},
);
} }
/** /**
@ -1649,21 +1548,6 @@ class Guild extends AnonymousGuild {
return data; return data;
} }
toJSON() {
const json = super.toJSON({
available: false,
createdTimestamp: true,
nameAcronym: true,
presences: false,
voiceStates: false,
});
json.iconURL = this.iconURL();
json.splashURL = this.splashURL();
json.discoverySplashURL = this.discoverySplashURL();
json.bannerURL = this.bannerURL();
return json;
}
/** /**
* The voice state adapter for this guild that can be used with @discordjs/voice to play audio in voice * The voice state adapter for this guild that can be used with @discordjs/voice to play audio in voice
* and stage channels. * and stage channels.
@ -1686,26 +1570,6 @@ class Guild extends AnonymousGuild {
}; };
} }
/**
* Get the top emojis of this guild.
* @returns {Promise<Collection<number, GuildEmoji>>}
*/
topEmojis() {
return new Promise((resolve, reject) => {
this.client.api
.guilds(this.id)
['top-emojis'].get()
.then(data => {
const emojis = new Collection();
for (const emoji of data.items) {
emojis.set(emoji.emoji_rank, this.emojis.cache.get(emoji.emoji_id));
}
resolve(emojis);
})
.catch(reject);
});
}
/** /**
* Creates a collection of this guild's roles, sorted by their position and ids. * Creates a collection of this guild's roles, sorted by their position and ids.
* @returns {Collection<Snowflake, Role>} * @returns {Collection<Snowflake, Role>}