feat(GuildMember): add collectibles (#11468)

feat(GuildMember): add collectibles, fix partial update handling

Author: almeidx

packages/discord.js/src/structures/GuildMember.js

@@ -8,6 +8,7 @@ const { DiscordjsError, ErrorCodes } = require('../errors');
 const GuildMemberRoleManager = require('../managers/GuildMemberRoleManager');
 const { GuildMemberFlagsBitField } = require('../util/GuildMemberFlagsBitField');
 const PermissionsBitField = require('../util/PermissionsBitField');
+const { _transformCollectibles } = require('../util/Transformers.js');
 
 /**
  * Represents a member of a guild on Discord.
@@ -140,6 +141,17 @@ class GuildMember extends Base {
     } else {
       this.avatarDecorationData = null;
     }
+
+    if ('collectibles' in data) {
+      /**
+       * The member's collectibles
+       *
+       * @type {?Collectibles}
+       */
+      this.collectibles = data.collectibles ? _transformCollectibles(data.collectibles) : null;
+    } else {
+      this.collectibles ??= null;
+    }
   }
 
   _clone() {
@@ -541,7 +553,11 @@ class GuildMember extends Base {
         (this._roles.length === member._roles.length &&
           this._roles.every((role, index) => role === member._roles[index]))) &&
       this.avatarDecorationData?.asset === member.avatarDecorationData?.asset &&
-      this.avatarDecorationData?.skuId === member.avatarDecorationData?.skuId
+      this.avatarDecorationData?.skuId === member.avatarDecorationData?.skuId &&
+      this.collectibles?.nameplate?.skuId === member.collectibles?.nameplate?.skuId &&
+      this.collectibles?.nameplate?.asset === member.collectibles?.nameplate?.asset &&
+      this.collectibles?.nameplate?.label === member.collectibles?.nameplate?.label &&
+      this.collectibles?.nameplate?.palette === member.collectibles?.nameplate?.palette
     );
   }
 

packages/discord.js/src/structures/User.js

@@ -172,15 +172,15 @@ class User extends Base {
      * @property {?NameplateData} nameplate The user's nameplate data
      */
 
-    if (data.collectibles) {
+    if ('collectibles' in data) {
       /**
        * The user's collectibles
        *
        * @type {?Collectibles}
        */
-      this.collectibles = _transformCollectibles(data.collectibles);
+      this.collectibles = data.collectibles ? _transformCollectibles(data.collectibles) : null;
     } else {
-      this.collectibles = null;
+      this.collectibles ??= null;
     }
 
     /**

packages/discord.js/typings/index.d.ts

@@ -1879,6 +1879,7 @@ export class GuildMember extends Base {
   public avatarDecorationData: AvatarDecorationData | null;
   public banner: string | null;
   public get bannable(): boolean;
+  public collectibles: Collectibles | null;
   public get dmChannel(): DMChannel | null;
   public get displayColor(): number;
   public get displayHexColor(): HexColorString;