diff --git a/src/structures/GuildMember.js b/src/structures/GuildMember.js index 0e9aa30..ab2cc34 100644 --- a/src/structures/GuildMember.js +++ b/src/structures/GuildMember.js @@ -321,12 +321,12 @@ class GuildMember extends Base { } /** - * The nickname of this member, or their username if they don't have one + * The nickname of this member, or their user display name if they don't have one * @type {?string} * @readonly */ get displayName() { - return this.nickname ?? this.user.username; + return this.nickname ?? this.user.displayName; } /** diff --git a/src/structures/User.js b/src/structures/User.js index 14f9141..a2de2ea 100644 --- a/src/structures/User.js +++ b/src/structures/User.js @@ -1,5 +1,6 @@ 'use strict'; +const process = require('node:process'); const { Collection } = require('@discordjs/collection'); const Base = require('./Base'); const ClientApplication = require('./ClientApplication'); @@ -9,6 +10,9 @@ const { Error } = require('../errors'); const { RelationshipTypes, NitroType } = require('../util/Constants'); const SnowflakeUtil = require('../util/SnowflakeUtil'); const UserFlags = require('../util/UserFlags'); +const Util = require('../util/Util'); + +let tagDeprecationEmitted = false; /** * Represents a user on Discord. @@ -94,6 +98,16 @@ class User extends Base { this.username ??= null; } + if ('global_name' in data) { + /** + * The global name of this user + * @type {?string} + */ + this.globalName = data.global_name; + } else { + this.globalName ??= null; + } + if ('bot' in data) { /** * Whether or not the user is a bot @@ -110,7 +124,8 @@ class User extends Base { if ('discriminator' in data) { /** - * A discriminator based on username for the user + * The discriminator of this user + * `'0'`, or a 4-digit stringified number if they're using the legacy username system * @type {?string} */ this.discriminator = data.discriminator; @@ -453,7 +468,8 @@ class User extends Base { * @readonly */ get defaultAvatarURL() { - return this.client.rest.cdn.DefaultAvatar(this.discriminator % 5); + const index = this.discriminator === '0' ? Util.calculateUserDefaultAvatarIndex(this.id) : this.discriminator % 5; + return this.client.rest.cdn.DefaultAvatar(index); } /** @@ -527,12 +543,32 @@ class User extends Base { } /** - * The Discord "tag" (e.g. `hydrabolt#0001`) for this user + * The tag of this user + * This user's username, or their legacy tag (e.g. `hydrabolt#0001`) + * if they're using the legacy username system * @type {?string} + * @deprecated Use {@link User#username} instead. * @readonly */ get tag() { - return typeof this.username === 'string' ? `${this.username}#${this.discriminator}` : null; + if (!tagDeprecationEmitted) { + process.emitWarning('User#tag is deprecated. Use User#username instead.', 'DeprecationWarning'); + tagDeprecationEmitted = true; + } + return typeof this.username === 'string' + ? this.discriminator === '0' + ? this.username + : `${this.username}#${this.discriminator}` + : null; + } + + /** + * The global name of this user, or their username if they don't have one + * @type {?string} + * @readonly + */ + get displayName() { + return this.globalName ?? this.username; } /** @@ -574,6 +610,7 @@ class User extends Base { this.id === user.id && this.username === user.username && this.discriminator === user.discriminator && + this.globalName === user.globalName && this.avatar === user.avatar && this.flags?.bitfield === user.flags?.bitfield && this.banner === user.banner && @@ -594,6 +631,7 @@ class User extends Base { this.id === user.id && this.username === user.username && this.discriminator === user.discriminator && + this.globalName === user.global_name && this.avatar === user.avatar && this.flags?.bitfield === user.public_flags && ('banner' in user ? this.banner === user.banner : true) && diff --git a/src/util/Constants.js b/src/util/Constants.js index cc01053..f944065 100644 --- a/src/util/Constants.js +++ b/src/util/Constants.js @@ -186,7 +186,7 @@ exports.Endpoints = { return { Emoji: (emojiId, format = 'webp') => `${root}/emojis/${emojiId}.${format}`, Asset: name => `${root}/assets/${name}`, - DefaultAvatar: discriminator => `${root}/embed/avatars/${discriminator}.png`, + DefaultAvatar: index => `${root}/embed/avatars/${index}.png`, Avatar: (userId, hash, format, size, dynamic = false) => { if (dynamic && hash.startsWith('a_')) format = 'gif'; return makeImageUrl(`${root}/avatars/${userId}/${hash}`, { format, size }); diff --git a/src/util/Util.js b/src/util/Util.js index e14f333..52d6b3b 100644 --- a/src/util/Util.js +++ b/src/util/Util.js @@ -709,8 +709,8 @@ class Util extends null { if (!files.length) return []; files = files.map((file, i) => ({ filename: file.name ?? file.attachment?.name ?? file.attachment?.filename ?? 'file.jpg', - // 8MB = 8388608 bytes - file_size: Math.floor((8_388_608 / 10) * Math.random()), + // 25MB = 26_214_400bytes + file_size: Math.floor((26_214_400 / 10) * Math.random()), id: `${i}`, })); const { attachments } = await client.api.channels[channelId].attachments.post({ @@ -733,6 +733,15 @@ class Util extends null { return false; } } + + /** + * Calculates the default avatar index for a given user id. + * @param {Snowflake} userId - The user id to calculate the default avatar index for + * @returns {number} + */ + static calculateUserDefaultAvatarIndex(userId) { + return Number(BigInt(userId) >> 22n) % 6; + } } module.exports = Util; diff --git a/typings/index.d.ts b/typings/index.d.ts index 9734d10..f8cd148 100644 --- a/typings/index.d.ts +++ b/typings/index.d.ts @@ -3260,14 +3260,17 @@ export class User extends PartialTextBasedChannel(Base) { public readonly relationships: RelationshipTypes; public readonly createdTimestamp: number; public discriminator: string; + public readonly displayName: string; public readonly defaultAvatarURL: string; public readonly dmChannel: DMChannel | null; public flags: Readonly | null; + public globalName: string | null; public botInGuildsCount: number | null | undefined; public readonly hexAccentColor: HexColorString | null | undefined; public id: Snowflake; public readonly partial: false; public system: boolean; + /** @deprecated Use {@link User#username} instead. */ public readonly tag: string; public username: string; public readonly note: string | null; @@ -3363,6 +3366,7 @@ export class Util extends null { public static splitMessage(text: string, options?: SplitOptions): string[]; /** @deprecated This will be removed in the next major version. */ public static resolveAutoArchiveMaxLimit(guild: Guild): Exclude; + public static calculateUserDefaultAvatarIndex(userId: Snowflake): number; } export class Formatters extends null { @@ -3658,7 +3662,7 @@ export const Constants: { dynamic: boolean, ): string; Banner(id: Snowflake, hash: string, format: DynamicImageFormat, size: AllowedImageSize, dynamic: boolean): string; - DefaultAvatar(discriminator: number): string; + DefaultAvatar(index: number): string; DiscoverySplash(guildId: Snowflake, hash: string, format: AllowedImageFormat, size: AllowedImageSize): string; Emoji(emojiId: Snowflake, format: DynamicImageFormat): string; GDMIcon(channelId: Snowflake, hash: string, format: AllowedImageFormat, size: AllowedImageSize): string;