djs-selfbot-v13 3.7.22 → 3.7.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "djs-selfbot-v13",
-  "version": "3.7.22",
+  "version": "3.7.24",
   "description": "An unofficial discord.js fork for creating selfbots",
   "main": "./src/index.js",
   "types": "./typings/index.d.ts",

package/src/structures/Message.js

@@ -606,6 +606,15 @@ class Message extends Base {
    * @readonly
    */
   get editable() {
+    const permissions = this.channel?.permissionsFor(this.client.user);
+    if (!permissions) return false;
+
+    const hasPermission = this.channel?.isThread?.()
+      ? permissions.has(Permissions.FLAGS.SEND_MESSAGES_IN_THREADS, false)
+      : permissions.has(Permissions.FLAGS.SEND_MESSAGES, false);
+
+    if (!hasPermission) return false;
+
     const precheck = Boolean(
       this.author.id === this.client.user.id &&
         !deletedMessages.has(this) &&
@@ -618,7 +627,6 @@ class Message extends Base {
     if (this.channel?.isThread()) {
       if (this.channel.archived) return false;
       if (this.channel.locked) {
-        const permissions = this.channel.permissionsFor(this.client.user);
         if (!permissions?.has(Permissions.FLAGS.MANAGE_THREADS, true)) return false;
       }
     }

package/src/structures/MessagePayload.js

@@ -172,6 +172,16 @@ class MessagePayload {
       allowedMentions = Util.cloneObject(allowedMentions);
       allowedMentions.replied_user = allowedMentions.repliedUser;
       delete allowedMentions.repliedUser;
+
+      const guild = this.target.guild ?? this.target.channel?.guild;
+      if (guild && !this.isWebhook) {
+        const permissions = this.target.channel?.permissionsFor(this.target.client.user);
+        if (permissions) {
+          if (allowedMentions.parse?.includes('everyone') && !permissions.has(Permissions.FLAGS.MENTION_EVERYONE, false)) {
+            allowedMentions.parse = allowedMentions.parse.filter(p => p !== 'everyone');
+          }
+        }
+      }
     }
 
     let message_reference;

package/src/structures/User.js

@@ -25,9 +25,7 @@ class User extends Base {
     this.id = data.id;
 
     this.bot = null;
-
     this.system = null;
-
     this.flags = null;
 
     this._patch(data);
@@ -98,7 +96,7 @@ class User extends Base {
 
     if ('banner_color' in data) {
       /**
-       * The user banner's hex
+       * The user banner's hex color
        * <info>The user must be force fetched for this property to be present or be updated</info>
        * @type {?string}
        */
@@ -136,16 +134,25 @@ class User extends Base {
       this.flags = new UserFlags(data.public_flags);
     }
 
-    if (data.display_name_styles) {
+    // ─── Display Name Styles ────────────────────────────────────────────────
+
+    /**
+     * @typedef {Object} DisplayNameStyles
+     * @property {number} fontId   The font ID used for the display name
+     * @property {number} effectId The effect ID applied to the display name
+     * @property {number[]} colors  Array of decimal color values (1 for solid, 2 for gradient)
+     */
+
+    if ('display_name_styles' in data) {
       if (data.display_name_styles) {
         /**
-         * The user avatar decoration's data
-         * @type {?AvatarDecorationData}
+         * The display name style of this user (font, effect, colors)
+         * @type {?DisplayNameStyles}
          */
         this.displayNameStyles = {
-          fontId: data.display_name_styles.fontId,
-          effectId: data.display_name_styles.effectId,
-          colors: data.display_name_styles.colors
+          fontId:   data.display_name_styles.font_id   ?? data.display_name_styles.fontId   ?? null,
+          effectId: data.display_name_styles.effect_id ?? data.display_name_styles.effectId ?? null,
+          colors:   data.display_name_styles.colors    ?? [],
         };
       } else {
         this.displayNameStyles = null;
@@ -154,13 +161,15 @@ class User extends Base {
       this.displayNameStyles ??= null;
     }
 
+    // ─── Avatar Decoration ──────────────────────────────────────────────────
+
     /**
      * @typedef {Object} AvatarDecorationData
-     * @property {string} asset The avatar decoration hash
+     * @property {string}    asset The avatar decoration hash
      * @property {Snowflake} skuId The id of the avatar decoration's SKU
      */
 
-    if (data.avatar_decoration_data) {
+    if ('avatar_decoration_data' in data) {
       if (data.avatar_decoration_data) {
         /**
          * The user avatar decoration's data
@@ -177,12 +186,14 @@ class User extends Base {
       this.avatarDecorationData ??= null;
     }
 
+    // ─── Primary Guild / Clan ───────────────────────────────────────────────
+
     /**
      * @typedef {Object} UserPrimaryGuild
-     * @property {?Snowflake} identityGuildId The id of the user's primary guild
-     * @property {?boolean} identityEnabled Whether the user is displaying the primary guild's tag
-     * @property {?string} tag The user's guild tag. Limited to 4 characters
-     * @property {?string} badge The guild tag badge hash
+     * @property {?Snowflake} identityGuildId  The id of the user's primary guild
+     * @property {?boolean}   identityEnabled  Whether the user is displaying the primary guild's tag
+     * @property {?string}    tag              The user's guild tag (max 4 characters)
+     * @property {?string}    badge            The guild tag badge hash
      */
 
     if ('primary_guild' in data) {
@@ -194,8 +205,8 @@ class User extends Base {
         this.primaryGuild = {
           identityGuildId: data.primary_guild.identity_guild_id,
           identityEnabled: data.primary_guild.identity_enabled,
-          tag: data.primary_guild.tag,
-          badge: data.primary_guild.badge,
+          tag:             data.primary_guild.tag,
+          badge:           data.primary_guild.badge,
         };
       } else {
         this.primaryGuild = null;
@@ -204,12 +215,23 @@ class User extends Base {
       this.primaryGuild ??= null;
     }
 
+    // ─── Collectibles ───────────────────────────────────────────────────────
+
+    /**
+     * @typedef {Object} NameplatePalette
+     * @property {string} [backgroundPrimary]   Primary background color
+     * @property {string} [backgroundSecondary] Secondary background color
+     * @property {string} [bodyTextNormal]       Normal body text color
+     * @property {string} [bodyTextMuted]        Muted body text color
+     * @property {string} [bodyTextStrong]       Strong body text color
+     */
+
     /**
      * @typedef {Object} NameplateData
-     * @property {Snowflake} skuId The id of the nameplate's SKU
-     * @property {string} asset The nameplate's asset path
-     * @property {string} label The nameplate's label
-     * @property {NameplatePalette} palette Background color of the nameplate
+     * @property {Snowflake}        skuId   The id of the nameplate's SKU
+     * @property {string}           asset   The nameplate's asset path
+     * @property {string}           label   The nameplate's label
+     * @property {NameplatePalette} palette Background color palette of the nameplate
      */
 
     /**
@@ -217,31 +239,225 @@ class User extends Base {
      * @property {?NameplateData} nameplate The user's nameplate data
      */
 
-    if (data.collectibles) {
-      if (data.collectibles.nameplate) {
+    if ('collectibles' in data) {
+      if (data.collectibles?.nameplate) {
         /**
          * The user's collectibles
          * @type {?Collectibles}
          */
         this.collectibles = {
           nameplate: {
-            skuId: data.collectibles.nameplate.sku_id,
-            asset: data.collectibles.nameplate.asset,
-            label: data.collectibles.nameplate.label,
+            skuId:   data.collectibles.nameplate.sku_id,
+            asset:   data.collectibles.nameplate.asset,
+            label:   data.collectibles.nameplate.label,
             palette: data.collectibles.nameplate.palette,
           },
         };
       } else {
-        this.collectibles = { nameplate: null };
+        this.collectibles = data.collectibles ? { nameplate: null } : null;
       }
     } else {
       this.collectibles ??= null;
     }
+
+    // ─── Bio ────────────────────────────────────────────────────────────────
+
+    if ('bio' in data) {
+      /**
+       * The bio of the user (self-introduction)
+       * @type {?string}
+       */
+      this.bio = data.bio ?? null;
+    } else {
+      this.bio ??= null;
+    }
+
+    // ─── Pronouns ───────────────────────────────────────────────────────────
+
+    if ('pronouns' in data) {
+      /**
+       * The pronouns of the user
+       * @type {?string}
+       */
+      this.pronouns = data.pronouns ?? null;
+    } else {
+      this.pronouns ??= null;
+    }
+
+    // ─── Premium (Nitro) ────────────────────────────────────────────────────
+
+    /**
+     * @typedef {Object} PremiumInfo
+     * @property {?number} type  The Nitro subscription type (1 = Classic, 2 = Nitro, 3 = Basic)
+     * @property {?Date}   since The date the subscription started
+     */
+
+    if ('premium_type' in data) {
+      /**
+       * The Nitro subscription type of the user
+       * 0 = None, 1 = Classic, 2 = Nitro, 3 = Basic
+       * @type {?number}
+       */
+      this.premiumType = data.premium_type ?? null;
+    } else {
+      this.premiumType ??= null;
+    }
+
+    if ('premium_since' in data) {
+      /**
+       * The date the user's Nitro subscription started
+       * @type {?Date}
+       */
+      this.premiumSince = data.premium_since ? new Date(data.premium_since) : null;
+    } else {
+      this.premiumSince ??= null;
+    }
+
+    if ('premium_guild_since' in data) {
+      /**
+       * The date the user boosted a guild
+       * @type {?Date}
+       */
+      this.premiumGuildSince = data.premium_guild_since ? new Date(data.premium_guild_since) : null;
+    } else {
+      this.premiumGuildSince ??= null;
+    }
+
+    // ─── Profile Effect ─────────────────────────────────────────────────────
+
+    /**
+     * @typedef {Object} ProfileEffect
+     * @property {Snowflake} id        The effect's id
+     * @property {Snowflake} skuId     The SKU id of the effect
+     * @property {?Date}     expiresAt The expiration date of the effect, or null if permanent
+     */
+
+    if (data.user_profile?.profile_effect) {
+      /**
+       * The profile effect of the user
+       * @type {?ProfileEffect}
+       */
+      this.profileEffect = {
+        id:        data.user_profile.profile_effect.id,
+        skuId:     data.user_profile.profile_effect.sku_id,
+        expiresAt: data.user_profile.profile_effect.expires_at
+          ? new Date(data.user_profile.profile_effect.expires_at)
+          : null,
+      };
+    } else {
+      this.profileEffect ??= null;
+    }
+
+    // ─── Theme Colors ────────────────────────────────────────────────────────
+
+    if (data.user_profile && 'theme_colors' in data.user_profile) {
+      /**
+       * The theme colors used on this user's profile (array of 2 decimal color ints)
+       * @type {?number[]}
+       */
+      this.themeColors = data.user_profile.theme_colors ?? null;
+    } else {
+      this.themeColors ??= null;
+    }
+
+    // ─── Badges ─────────────────────────────────────────────────────────────
+
+    /**
+     * @typedef {Object} Badge
+     * @property {string}  id          The badge identifier (e.g. `'premium_tenure_1_month_v2'`)
+     * @property {string}  description Human-readable description of the badge
+     * @property {string}  icon        The badge icon hash
+     * @property {?string} link        An optional URL linked to the badge
+     */
+
+    if ('badges' in data) {
+      /**
+       * The profile badges of the user
+       * @type {Badge[]}
+       */
+      this.badges = data.badges ?? [];
+    } else {
+      this.badges ??= [];
+    }
+
+    if ('guild_badges' in data) {
+      /**
+       * The guild-specific badges of the user
+       * @type {Object[]}
+       */
+      this.guildBadges = data.guild_badges ?? [];
+    } else {
+      this.guildBadges ??= [];
+    }
+
+    // ─── Mutual guilds & friends ─────────────────────────────────────────────
+
+    /**
+     * @typedef {Object} MutualGuild
+     * @property {Snowflake} id   The guild's id
+     * @property {?string}   nick The user's nickname in that guild
+     */
+
+    if ('mutual_guilds' in data) {
+      /**
+       * Mutual guilds shared with the client user (only populated after `getProfile()`)
+       * @type {MutualGuild[]}
+       */
+      this.mutualGuilds = data.mutual_guilds ?? [];
+    } else {
+      this.mutualGuilds ??= [];
+    }
+
+    if ('mutual_friends_count' in data) {
+      /**
+       * Number of mutual friends with the client user
+       * @type {?number}
+       */
+      this.mutualFriendsCount = data.mutual_friends_count ?? null;
+    } else {
+      this.mutualFriendsCount ??= null;
+    }
+
+    // ─── Connected Accounts ──────────────────────────────────────────────────
+
+    /**
+     * @typedef {Object} ConnectedAccount
+     * @property {string}  type     The service type (e.g. `'spotify'`, `'github'`)
+     * @property {string}  id       The account id on that service
+     * @property {string}  name     The account name/username on that service
+     * @property {boolean} verified Whether the connection is verified
+     */
+
+    if ('connected_accounts' in data) {
+      /**
+       * The connected accounts of the user (only populated after `getProfile()`)
+       * @type {ConnectedAccount[]}
+       */
+      this.connectedAccounts = data.connected_accounts ?? [];
+    } else {
+      this.connectedAccounts ??= [];
+    }
+
+    // ─── Legacy username ─────────────────────────────────────────────────────
+
+    if ('legacy_username' in data) {
+      /**
+       * The user's legacy username (before the username migration), if any
+       * @type {?string}
+       */
+      this.legacyUsername = data.legacy_username ?? null;
+    } else {
+      this.legacyUsername ??= null;
+    }
   }
 
+  // ═══════════════════════════════════════════════════════════════════════════
+  //  Getters
+  // ═══════════════════════════════════════════════════════════════════════════
+
   /**
    * The primary clan the user is in
-   * @type {?PrimaryGuild}
+   * @type {?UserPrimaryGuild}
    * @deprecated Use `primaryGuild` instead
    */
   get clan() {
@@ -252,10 +468,9 @@ class User extends Base {
    * The user avatar decoration's hash
    * @type {?string}
    * @deprecated Use `avatarDecorationData` instead
-   * Removed in v4
    */
   get avatarDecoration() {
-    return this.avatarDecorationData?.asset || null;
+    return this.avatarDecorationData?.asset ?? null;
   }
 
   /**
@@ -286,40 +501,96 @@ class User extends Base {
   }
 
   /**
-   * A link to the user's avatar.
-   * @param {ImageURLOptions} [options={}] Options for the Image URL
-   * @returns {?string}
+   * The hexadecimal version of the user accent color, with a leading hash
+   * @type {?string}
+   * @readonly
    */
-  avatarURL({ format, size, dynamic } = {}) {
-    if (!this.avatar) return null;
-    return this.client.rest.cdn.Avatar(this.id, this.avatar, format, size, dynamic);
+  get hexAccentColor() {
+    if (typeof this.accentColor !== 'number') return this.accentColor;
+    return `#${this.accentColor.toString(16).padStart(6, '0')}`;
   }
 
   /**
-   * A link to the user's avatar decoration.
-   * @returns {?string}
+   * The tag of this user
+   * <info>This user's username, or their legacy tag (e.g. `hydrabolt#0001`)
+   * if they're using the legacy username system</info>
+   * @type {?string}
+   * @readonly
    */
-  avatarDecorationURL() {
-    if (!this.avatarDecorationData) return null;
-    return this.client.rest.cdn.AvatarDecoration(this.avatarDecorationData.asset);
+  get tag() {
+    return typeof this.username === 'string'
+      ? this.discriminator === '0' || this.discriminator === '0000'
+        ? this.username
+        : `${this.username}#${this.discriminator}`
+      : null;
   }
 
   /**
-   * A link to the user's guild tag badge.
-   * @returns {?string}
-   * @deprecated
+   * The global name of this user, or their username if they don't have one
+   * @type {?string}
+   * @readonly
    */
-  clanBadgeURL() {
-    return this.guildTagBadgeURL();
+  get displayName() {
+    return this.globalName ?? this.username;
   }
 
   /**
-   * A link to the user's guild tag badge.
-   * @returns {?string}
+   * Whether the user has an active Nitro subscription
+   * @type {boolean}
+   * @readonly
    */
-  guildTagBadgeURL() {
-    if (!this.primaryGuild || !this.primaryGuild.identityGuildId || !this.primaryGuild.badge) return null;
-    return this.client.rest.cdn.GuildTagBadge(this.primaryGuild.identityGuildId, this.primaryGuild.badge);
+  get nitro() {
+    return this.premiumType !== null && this.premiumType > 0;
+  }
+
+  /**
+   * The DM between the client's user and this user
+   * @type {?DMChannel}
+   * @readonly
+   */
+  get dmChannel() {
+    return this.client.users.dmChannel(this.id);
+  }
+
+  /**
+   * The note set for this user by the client
+   * @type {?string}
+   * @readonly
+   */
+  get note() {
+    return this.client.notes.cache.get(this.id) ?? null;
+  }
+
+  /**
+   * The voice state of this user
+   * @type {VoiceState}
+   * @readonly
+   */
+  get voice() {
+    return (
+      this.client.voiceStates.cache.get(this.id) ??
+      this.client.guilds.cache.find(g => g?.voiceStates?.cache?.get(this.id))?.voiceStates?.cache?.get(this.id) ??
+      new VoiceState({ client: this.client }, { user_id: this.id })
+    );
+  }
+
+  /**
+   * Check relationship status (Client → User)
+   * @type {RelationshipType}
+   * @readonly
+   */
+  get relationship() {
+    const i = this.client.relationships.cache.get(this.id) ?? 0;
+    return RelationshipTypes[parseInt(i)];
+  }
+
+  /**
+   * Get friend nickname
+   * @type {?string}
+   * @readonly
+   */
+  get friendNickname() {
+    return this.client.relationships.friendNicknames.get(this.id) ?? null;
   }
 
   /**
@@ -335,9 +606,22 @@ class User extends Base {
     return this.client.rest.cdn.DefaultAvatar(index);
   }
 
+  // ═══════════════════════════════════════════════════════════════════════════
+  //  URL helpers
+  // ═══════════════════════════════════════════════════════════════════════════
+
+  /**
+   * A link to the user's avatar.
+   * @param {ImageURLOptions} [options={}] Options for the Image URL
+   * @returns {?string}
+   */
+  avatarURL({ format, size, dynamic } = {}) {
+    if (!this.avatar) return null;
+    return this.client.rest.cdn.Avatar(this.id, this.avatar, format, size, dynamic);
+  }
+
   /**
-   * 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 their default avatar.
    * @param {ImageURLOptions} [options={}] Options for the Image URL
    * @returns {string}
    */
@@ -346,20 +630,17 @@ class User extends Base {
   }
 
   /**
-   * The hexadecimal version of the user accent color, with a leading hash
-   * <info>The user must be force fetched for this property to be present</info>
-   * @type {?string}
-   * @readonly
+   * A link to the user's avatar decoration.
+   * @returns {?string}
    */
-  get hexAccentColor() {
-    if (typeof this.accentColor !== 'number') return this.accentColor;
-    return `#${this.accentColor.toString(16).padStart(6, '0')}`;
+  avatarDecorationURL() {
+    if (!this.avatarDecorationData) return null;
+    return this.client.rest.cdn.AvatarDecoration(this.avatarDecorationData.asset);
   }
 
   /**
    * A link to the user's banner.
-   * <info>This method will throw an error if called before the user is force fetched.
-   * See {@link User#banner} for more info</info>
+   * <info>This method will throw an error if called before the user is force fetched.</info>
    * @param {ImageURLOptions} [options={}] Options for the Image URL
    * @returns {?string}
    */
@@ -370,37 +651,24 @@ class User extends Base {
   }
 
   /**
-   * The tag of this user
-   * <info>This user's username, or their legacy tag (e.g. `hydrabolt#0001`)
-   * if they're using the legacy username system</info>
-   * @type {?string}
-   * @readonly
+   * A link to the user's guild tag badge.
+   * @returns {?string}
    */
-  get tag() {
-    return typeof this.username === 'string'
-      ? this.discriminator === '0' || this.discriminator === '0000'
-        ? this.username
-        : `${this.username}#${this.discriminator}`
-      : null;
+  guildTagBadgeURL() {
+    if (!this.primaryGuild?.identityGuildId || !this.primaryGuild?.badge) return null;
+    return this.client.rest.cdn.GuildTagBadge(this.primaryGuild.identityGuildId, this.primaryGuild.badge);
   }
 
   /**
-   * The global name of this user, or their username if they don't have one
-   * @type {?string}
-   * @readonly
+   * @deprecated Use `guildTagBadgeURL()` instead
    */
-  get displayName() {
-    return this.globalName ?? this.username;
+  clanBadgeURL() {
+    return this.guildTagBadgeURL();
   }
 
-  /**
-   * The DM between the client's user and this user
-   * @type {?DMChannel}
-   * @readonly
-   */
-  get dmChannel() {
-    return this.client.users.dmChannel(this.id);
-  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  //  Actions
+  // ═══════════════════════════════════════════════════════════════════════════
 
   /**
    * Creates a DM channel between the client and the user.
@@ -412,80 +680,13 @@ class User extends Base {
   }
 
   /**
-   * Deletes a DM channel (if one exists) between the client and the user. Resolves with the channel if successful.
+   * Deletes a DM channel (if one exists) between the client and the user.
    * @returns {Promise<DMChannel>}
    */
   deleteDM() {
     return this.client.users.deleteDM(this.id);
   }
 
-  /**
-   * Checks if the user is equal to another.
-   * It compares id, username, discriminator, avatar, banner, accent color, and bot flags.
-   * It is recommended to compare equality by using `user.id === user2.id` unless you want to compare all properties.
-   * @param {User} user User to compare with
-   * @returns {boolean}
-   */
-  equals(user) {
-    return (
-      user &&
-      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 &&
-      this.accentColor === user.accentColor &&
-      this.avatarDecorationData?.asset === user.avatarDecorationData?.asset &&
-      this.avatarDecorationData?.skuId === user.avatarDecorationData?.skuId &&
-      this.collectibles?.nameplate?.skuId === user.collectibles?.nameplate?.skuId &&
-      this.collectibles?.nameplate?.asset === user.collectibles?.nameplate?.asset &&
-      this.collectibles?.nameplate?.label === user.collectibles?.nameplate?.label &&
-      this.collectibles?.nameplate?.palette === user.collectibles?.nameplate?.palette &&
-      this.primaryGuild?.identityGuildId === user.primaryGuild?.identityGuildId &&
-      this.primaryGuild?.identityEnabled === user.primaryGuild?.identityEnabled &&
-      this.primaryGuild?.tag === user.primaryGuild?.tag &&
-      this.primaryGuild?.badge === user.primaryGuild?.badge
-    );
-  }
-
-  /**
-   * Compares the user with an API user object
-   * @param {APIUser} user The API user object to compare
-   * @returns {boolean}
-   * @private
-   */
-  _equals(user) {
-    return (
-      user &&
-      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) &&
-      ('accent_color' in user ? this.accentColor === user.accent_color : true) &&
-      ('avatar_decoration_data' in user
-        ? this.avatarDecorationData?.asset === user.avatar_decoration_data?.asset &&
-          this.avatarDecorationData?.skuId === user.avatar_decoration_data?.sku_id
-        : true) &&
-      ('collectibles' in user
-        ? this.collectibles?.nameplate?.skuId === user.collectibles?.nameplate?.sku_id &&
-          this.collectibles?.nameplate?.asset === user.collectibles?.nameplate?.asset &&
-          this.collectibles?.nameplate?.label === user.collectibles?.nameplate?.label &&
-          this.collectibles?.nameplate?.palette === user.collectibles?.nameplate?.palette
-        : true) &&
-      ('primary_guild' in user
-        ? this.primaryGuild?.identityGuildId === user.primary_guild?.identity_guild_id &&
-          this.primaryGuild?.identityEnabled === user.primary_guild?.identity_enabled &&
-          this.primaryGuild?.tag === user.primary_guild?.tag &&
-          this.primaryGuild?.badge === user.primary_guild?.badge
-        : true)
-    );
-  }
-
   /**
    * Fetches this user.
    * @param {boolean} [force=true] Whether to skip the cache check and request the API
@@ -510,109 +711,205 @@ class User extends Base {
   getProfile(guildId) {
     return this.client.api.users(this.id).profile.get({
       query: {
-        with_mutual_guilds: true,
-        with_mutual_friends: true,
+        with_mutual_guilds:        true,
+        with_mutual_friends:       true,
         with_mutual_friends_count: true,
-        guild_id: guildId,
+        guild_id:                  guildId,
       },
     });
   }
 
   /**
-   * When concatenated with a string, this automatically returns the user's mention instead of the User object.
-   * @returns {string}
-   * @example
-   * // Logs: Hello from <@123456789012345678>!
-   * console.log(`Hello from ${user}!`);
+   * Updates the note of this user.
+   * @param {string|null} [note=null] The new note value
+   * @returns {Promise<User>}
    */
-  toString() {
-    return `<@${this.id}>`;
+  async setNote(note = null) {
+    await this.client.notes.updateNote(this.id, note);
+    return this;
   }
 
-  toJSON(...props) {
-    const json = super.toJSON(
-      {
-        createdTimestamp: true,
-        defaultAvatarURL: true,
-        hexAccentColor: true,
-        tag: true,
-      },
-      ...props,
-    );
-    json.avatarURL = this.avatarURL();
-    json.displayAvatarURL = this.displayAvatarURL();
-    json.bannerURL = this.banner ? this.bannerURL() : this.banner;
-    json.guildTagBadgeURL = this.guildTagBadgeURL();
-    return json;
+  /**
+   * Send a friend request to this user.
+   * @returns {Promise<boolean>}
+   */
+  sendFriendRequest() {
+    return this.client.relationships.sendFriendRequest(this);
   }
 
   /**
-   * The function updates the note of a user and returns the updated user.
-   * @param {string|null|undefined} [note=null] - The `note` parameter is the new value that you want to set for the note of the
-   * user. It is an optional parameter and its default value is `null`.
-   * @returns {Promise<User>} The `setNote` method is returning the `User` object.
+   * Unblock / unfriend / cancel a friend request for this user.
+   * @returns {Promise<boolean>}
    */
-  async setNote(note = null) {
-    await this.client.notes.updateNote(this.id, note);
-    return this;
+  deleteRelationship() {
+    return this.client.relationships.deleteRelationship(this);
   }
 
+  // ═══════════════════════════════════════════════════════════════════════════
+  //  Display Name Style
+  // ═══════════════════════════════════════════════════════════════════════════
+
   /**
-   * The function returns the note associated with a specific client ID from a cache.
-   * @type {?string} The note that corresponds to the given id.
+   * Font name → ID mapping for display name styles.
+   * @type {Object<string, number>}
+   * @readonly
+   * @static
    */
-  get note() {
-    return this.client.notes.cache.get(this.id);
+  static get FONT_MAP() {
+    return {
+      Sans:      11,
+      Tempo:     12,
+      Sakura:    3,
+      JellyBean: 4,
+      Modern:    6,
+      Medieval:  7,
+      '8Bit':    8,
+      Vampire:   10,
+    };
   }
 
   /**
-   * The voice state of this member
-   * @type {VoiceState}
+   * Effect name → ID mapping for display name styles.
+   * @type {Object<string, number>}
    * @readonly
+   * @static
    */
-  get voice() {
-    return (
-      this.client.voiceStates.cache.get(this.id) ??
-      this.client.guilds.cache.find(g => g?.voiceStates?.cache?.get(this.id))?.voiceStates?.cache?.get(this.id) ??
-      new VoiceState({ client: this.client }, { user_id: this.id })
-    );
+  static get EFFECT_MAP() {
+    return {
+      Solid:    1,
+      Gradient: 2,
+      Neon:     3,
+      Toon:     4,
+      Pop:      5,
+    };
   }
 
   /**
-   * Send Friend Request to the user
-   * @type {boolean}
-   * @returns {Promise<boolean>}
+   * Resolves a decimal color integer from a hex string or number.
+   * @param {string|number} color Hex string (`'#RRGGBB'` / `'RRGGBB'`) or decimal number
+   * @returns {number}
+   * @static
    */
-  sendFriendRequest() {
-    return this.client.relationships.sendFriendRequest(this);
+  static resolveColor(color) {
+    if (typeof color === 'string') {
+      return parseInt(color.startsWith('#') ? color.slice(1) : color, 16);
+    }
+    return color;
   }
 
+  // ═══════════════════════════════════════════════════════════════════════════
+  //  Equality / serialisation
+  // ═══════════════════════════════════════════════════════════════════════════
+
   /**
-   * Unblock / Unfriend / Cancels a friend request
-   * @type {boolean}
-   * @returns {Promise<boolean>}
+   * Checks if the user is equal to another User instance.
+   * @param {User} user User to compare with
+   * @returns {boolean}
    */
-  deleteRelationship() {
-    return this.client.relationships.deleteRelationship(this);
+  equals(user) {
+    return (
+      user &&
+      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 &&
+      this.accentColor                         === user.accentColor &&
+      this.bio                                 === user.bio &&
+      this.pronouns                            === user.pronouns &&
+      this.premiumType                         === user.premiumType &&
+      this.avatarDecorationData?.asset         === user.avatarDecorationData?.asset &&
+      this.avatarDecorationData?.skuId         === user.avatarDecorationData?.skuId &&
+      this.collectibles?.nameplate?.skuId      === user.collectibles?.nameplate?.skuId &&
+      this.collectibles?.nameplate?.asset      === user.collectibles?.nameplate?.asset &&
+      this.collectibles?.nameplate?.label      === user.collectibles?.nameplate?.label &&
+      this.collectibles?.nameplate?.palette    === user.collectibles?.nameplate?.palette &&
+      this.primaryGuild?.identityGuildId       === user.primaryGuild?.identityGuildId &&
+      this.primaryGuild?.identityEnabled       === user.primaryGuild?.identityEnabled &&
+      this.primaryGuild?.tag                   === user.primaryGuild?.tag &&
+      this.primaryGuild?.badge                 === user.primaryGuild?.badge &&
+      this.displayNameStyles?.fontId           === user.displayNameStyles?.fontId &&
+      this.displayNameStyles?.effectId         === user.displayNameStyles?.effectId &&
+      JSON.stringify(this.displayNameStyles?.colors) === JSON.stringify(user.displayNameStyles?.colors) &&
+      this.profileEffect?.id                   === user.profileEffect?.id &&
+      JSON.stringify(this.themeColors)         === JSON.stringify(user.themeColors)
+    );
   }
 
   /**
-   * Check relationship status (Client -> User)
-   * @type {RelationshipType}
-   * @readonly
+   * Compares the user with a raw API user object.
+   * @param {APIUser} user The API user object to compare
+   * @returns {boolean}
+   * @private
    */
-  get relationship() {
-    const i = this.client.relationships.cache.get(this.id) ?? 0;
-    return RelationshipTypes[parseInt(i)];
+  _equals(user) {
+    return (
+      user &&
+      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) &&
+      ('accent_color' in user ? this.accentColor  === user.accent_color : true) &&
+      ('bio'          in user ? this.bio          === user.bio          : true) &&
+      ('pronouns'     in user ? this.pronouns     === user.pronouns     : true) &&
+      ('premium_type' in user ? this.premiumType  === user.premium_type : true) &&
+      ('avatar_decoration_data' in user
+        ? this.avatarDecorationData?.asset  === user.avatar_decoration_data?.asset &&
+          this.avatarDecorationData?.skuId  === user.avatar_decoration_data?.sku_id
+        : true) &&
+      ('collectibles' in user
+        ? this.collectibles?.nameplate?.skuId   === user.collectibles?.nameplate?.sku_id &&
+          this.collectibles?.nameplate?.asset   === user.collectibles?.nameplate?.asset &&
+          this.collectibles?.nameplate?.label   === user.collectibles?.nameplate?.label &&
+          this.collectibles?.nameplate?.palette === user.collectibles?.nameplate?.palette
+        : true) &&
+      ('primary_guild' in user
+        ? this.primaryGuild?.identityGuildId === user.primary_guild?.identity_guild_id &&
+          this.primaryGuild?.identityEnabled === user.primary_guild?.identity_enabled &&
+          this.primaryGuild?.tag             === user.primary_guild?.tag &&
+          this.primaryGuild?.badge           === user.primary_guild?.badge
+        : true) &&
+      ('display_name_styles' in user
+        ? this.displayNameStyles?.fontId   === (user.display_name_styles?.font_id ?? user.display_name_styles?.fontId) &&
+          this.displayNameStyles?.effectId === (user.display_name_styles?.effect_id ?? user.display_name_styles?.effectId) &&
+          JSON.stringify(this.displayNameStyles?.colors) === JSON.stringify(user.display_name_styles?.colors)
+        : true)
+    );
   }
 
   /**
-   * Get friend nickname
-   * @type {?string}
-   * @readonly
+   * When concatenated with a string, returns the user's mention.
+   * @returns {string}
+   * @example
+   * console.log(`Hello from ${user}!`); // Hello from <@123456789012345678>!
    */
-  get friendNickname() {
-    return this.client.relationships.friendNicknames.get(this.id);
+  toString() {
+    return `<@${this.id}>`;
+  }
+
+  toJSON(...props) {
+    const json = super.toJSON(
+      {
+        createdTimestamp:  true,
+        defaultAvatarURL:  true,
+        hexAccentColor:    true,
+        tag:               true,
+        displayName:       true,
+        nitro:             true,
+      },
+      ...props,
+    );
+    json.avatarURL          = this.avatarURL();
+    json.displayAvatarURL   = this.displayAvatarURL();
+    json.bannerURL          = this.banner ? this.bannerURL() : this.banner;
+    json.guildTagBadgeURL   = this.guildTagBadgeURL();
+    json.avatarDecorationURL = this.avatarDecorationURL();
+    return json;
   }
 }
 
@@ -624,12 +921,10 @@ class User extends Base {
  * @param {string|MessagePayload|MessageOptions} options The options to provide
  * @returns {Promise<Message>}
  * @example
- * // Send a direct message
  * user.send('Hello!')
  *   .then(message => console.log(`Sent message: ${message.content} to ${user.tag}`))
  *   .catch(console.error);
  */
-
 TextBasedChannel.applyToClass(User);
 
 module.exports = User;
@@ -637,4 +932,4 @@ module.exports = User;
 /**
  * @external APIUser
  * @see {@link https://discord.com/developers/docs/resources/user#user-object}
- */
+ */

package/typings/index.d.ts

@@ -3919,6 +3919,37 @@ export interface Collectibles {
   nameplate: NameplateData | null;
 }
 
+export interface DisplayNameStyles {
+  fontId: number | null;
+  effectId: number | null;
+  colors: number[];
+}
+
+export interface ProfileEffect {
+  id: Snowflake;
+  skuId: Snowflake;
+  expiresAt: Date | null;
+}
+
+export interface UserBadge {
+  id: string;
+  description: string;
+  icon: string;
+  link?: string;
+}
+
+export interface MutualGuild {
+  id: Snowflake;
+  nick: string | null;
+}
+
+export interface ConnectedAccount {
+  type: string;
+  id: string;
+  name: string;
+  verified: boolean;
+}
+
 export type WidgetType = 'favorite_games' | 'current_games' | 'played_games' | 'want_to_play_games';
 
 export interface WidgetGameData {
@@ -4062,6 +4093,20 @@ export class User extends PartialTextBasedChannel(Base) {
   public readonly voice?: VoiceState;
   public readonly relationship: RelationshipTypes;
   public readonly friendNickname: string | null | undefined;
+  public displayNameStyles: DisplayNameStyles | null;
+  public pronouns: string | null;
+  public themeColors: number[] | null;
+  public profileEffect: ProfileEffect | null;
+  public premiumType: number | null;
+  public premiumSince: Date | null;
+  public premiumGuildSince: Date | null;
+  public badges: UserBadge[];
+  public guildBadges: unknown[];
+  public mutualGuilds: MutualGuild[];
+  public mutualFriendsCount: number | null;
+  public connectedAccounts: ConnectedAccount[];
+  public legacyUsername: string | null;
+  public readonly nitro: boolean;
   public primaryGuild: UserPrimaryGuild | null;
   /** @deprecated Use {@link User.primaryGuild} instead */
   public clan: PrimaryGuild | null;
@@ -4078,7 +4123,7 @@ export class User extends PartialTextBasedChannel(Base) {
   public fetch(force?: boolean): Promise<User>;
   public setNote(note: string | null | undefined): Promise<this>;
   public toString(): UserMention;
-  public getProfile(guildId?: Snowflake): Promise<any>;
+  public getProfile(guildId?: Snowflake): Promise<UserProfile>;
   public sendFriendRequest(): Promise<boolean>;
   public deleteRelationship(): Promise<boolean>;
 }
@@ -4130,7 +4175,9 @@ export class Util extends null {
   public static mergeDefault(def: unknown, given: unknown): unknown;
   public static moveElementInArray(array: unknown[], element: unknown, newIndex: number, offset?: boolean): number;
   public static parseEmoji(text: string): { animated: boolean; name: string; id: Snowflake | null } | null;
-  public static resolveColor(color: ColorResolvable): number;
+  public static readonly FONT_MAP: Record<FontName, number>;
+  public static readonly EFFECT_MAP: Record<EffectName, number>;
+  public static resolveColor(color: string | number): number;
   public static resolvePartialEmoji(emoji: EmojiIdentifierResolvable): Partial<APIPartialEmoji> | null;
   public static verifyString(data: string, error?: typeof Error, errorMessage?: string, allowEmpty?: boolean): string;
   public static setPosition<T extends AnyChannel | Role>(