feat(Role): role tags

src/managers/GuildMemberRoleManager.js

@@ -72,6 +72,15 @@ class GuildMemberRoleManager {
     return this._roles.reduce((prev, role) => (role.comparePositionTo(prev) > 0 ? role : prev), this._roles.first());
   }
 
+  /**
+   * The premium subscriber role of the guild, if present on the member
+   * @type {?Role}
+   * @readonly
+   */
+  get premiumSubscriberRole() {
+    return this.cache.find(role => role.premiumSubscriberRole) || null;
+  }
+
   /**
    * Adds a role (or multiple roles) to the member.
    * @param {RoleResolvable|RoleResolvable[]|Collection<Snowflake, Role>} roleOrRoles The role or roles to add

src/managers/RoleManager.js

@@ -132,6 +132,24 @@ class RoleManager extends BaseManager {
     return this.cache.get(this.guild.id);
   }
 
+  /**
+   * The premium subscriber role of the guild, if any
+   * @type {?Role}
+   * @readonly
+   */
+  get premiumSubscriberRole() {
+    return this.cache.find(role => role.premiumSubscriberRole) || null;
+  }
+
+  /**
+   * The role associated with the client user of the guild, if any
+   * @type {?Role}
+   * @readonly
+   */
+  get myRole() {
+    return this.cache.find(role => role.isMyRole) || null;
+  }
+
   /**
    * The role with the highest position in the cache
    * @type {Role}

src/structures/Role.js

@@ -82,6 +82,44 @@ class Role extends Base {
      * @type {boolean}
      */
     this.deleted = false;
+
+    /**
+     * The tags this role has
+     * @type {?Object}
+     * @property {?Snowflake} botID The id of the bot this role belongs to
+     * @property {?Snowflake} integrationID The id of the integration this role belongs to
+     * @property {?boolean} premiumSubcriberRole Whether this is the guilds premium subscription role
+     */
+    this.tags = data.tags ? {} : null;
+    if (data.tags) {
+      if (Reflect.has(data.tags, 'bot_id')) {
+        this.tags.botID = data.tags.bot_id;
+      }
+      if (Reflect.has(data.tags, 'integration_id')) {
+        this.tags.integrationID = data.tags.integration_id;
+      }
+      if (Reflect.has(data.tags, 'premium_subscriber')) {
+        this.tags.premiumSubscriberRole = true;
+      }
+    }
+  }
+
+  /**
+   * Whether this role is the guilds premium subscription role
+   * @type {boolean}
+   * @readonly
+   */
+  get isPremiumSubscriberRole() {
+    return Boolean(this.tags && this.tags.premiumSubscriberRole);
+  }
+
+  /**
+   * Whether this role is the role associated with the logged in bot user
+   * @type {boolean}
+   * @readonly
+   */
+  get isMyRole() {
+    return Boolean(this.tags && this.tags.botID === this.client.user.id);
   }
 
   /**

typings/index.d.ts

@@ -1241,13 +1241,16 @@ declare module 'discord.js' {
     public readonly hexColor: string;
     public hoist: boolean;
     public id: Snowflake;
+    public readonly isMyRole: boolean;
+    public readonly isPremiumSubscriberRole: boolean;
     public managed: boolean;
     public readonly members: Collection<Snowflake, GuildMember>;
     public mentionable: boolean;
     public name: string;
     public permissions: Readonly<Permissions>;
     public readonly position: number;
     public rawPosition: number;
+    public tags: RoleTagData | null;
     public comparePositionTo(role: Role): number;
     public delete(reason?: string): Promise<Role>;
     public edit(data: RoleData, reason?: string): Promise<Role>;
@@ -1899,6 +1902,7 @@ declare module 'discord.js' {
     public readonly hoist: Role | null;
     public readonly color: Role | null;
     public readonly highest: Role;
+    public readonly premiumSubscriberRole?: Role;
     public member: GuildMember;
     public guild: Guild;
 
@@ -1955,6 +1959,8 @@ declare module 'discord.js' {
     public readonly everyone: Role;
     public readonly highest: Role;
     public guild: Guild;
+    public readonly myRole?: Role;
+    public readonly premiumSubscriberRole?: Role;
 
     public create(options?: { data?: RoleData; reason?: string }): Promise<Role>;
     public fetch(id: Snowflake, cache?: boolean): Promise<Role | null>;
@@ -2962,6 +2968,12 @@ declare module 'discord.js' {
 
   type RoleResolvable = Role | string;
 
+  interface RoleTagData {
+    botID?: Snowflake;
+    integrationID?: Snowflake;
+    premiumSubcriberRole?: boolean;
+  }
+
   type ShardingManagerMode = 'process' | 'worker';
 
   type Snowflake = string;