feat: Role connections & subscriptions

index.d.ts

@@ -86,6 +86,7 @@ declare namespace Eris {
   type TextVoiceChannelTypes = Constants["ChannelTypes"][keyof Pick<Constants["ChannelTypes"], "GUILD_VOICE">];
 
   // Client
+  type ApplicationRoleConnectionMetadataTypes = Constants["RoleConnectionMetadataTypes"][keyof Constants["RoleConnectionMetadataTypes"]];
   type MembershipStates = Constants["MembershipState"][keyof Constants["MembershipState"]];
   type OAuthTeamMemberRoleTypes = Constants["OAuthTeamMemberRoleTypes"][keyof Constants["OAuthTeamMemberRoleTypes"]];
 
@@ -529,6 +530,14 @@ declare namespace Eris {
   }
 
   // Client
+  interface ApplicationRoleConnectionMetadata {
+    description: string;
+    description_localizations?: Record<string, string> | null;
+    key: string;
+    name: string;
+    name_localizations?: Record<string, string> | null;
+    type: ApplicationRoleConnectionMetadataTypes;
+  }
   interface ClientOptions {
     /** @deprecated */
     agent?: HTTPSAgent;
@@ -1340,12 +1349,10 @@ declare namespace Eris {
     roles?: Collection<Role>;
     users?: Collection<User>;
   }
-
   interface ComponentInteractionButtonData {
     component_type: Constants["ComponentTypes"]["BUTTON"];
     custom_id: string;
   }
-
   interface ComponentInteractionSelectMenuData {
     component_type: Constants["ComponentTypes"]["SELECT_MENU"];
     custom_id: string;
@@ -1693,6 +1700,12 @@ declare namespace Eris {
     permissions?: bigint | number | string | Permission;
     unicodeEmoji?: string;
   }
+  interface RoleSubscriptionData {
+    is_renewal: boolean;
+    role_subscription_listing_id: string;
+    tier_name: string;
+    total_months_subscribed: number;
+  }
   interface RoleTags {
     bot_id?: string;
     integration_id?: string;
@@ -2108,7 +2121,8 @@ declare namespace Eris {
     GuildIntegrationTypes: [
       "twitch",
       "youtube",
-      "discord"
+      "discord",
+      "guild_subscription"
     ];
     GuildNSFWLevels: {
       DEFAULT:        0;
@@ -2414,6 +2428,16 @@ declare namespace Eris {
       NITRO_CLASSIC: 1;
       NITRO:         2;
     };
+    RoleConnectionMetadataTypes: {
+      INTEGER_LESS_THAN_OR_EQUAL:     1,
+      INTEGER_GREATER_THAN_OR_EQUAL:  2,
+      INTEGER_EQUAL:                  3,
+      INTEGER_NOT_EQUAL:              4,
+      DATETIME_LESS_THAN_OR_EQUAL:    5,
+      DATETIME_GREATER_THAN_OR_EQUAL: 6,
+      BOOLEAN_EQUAL:                  7,
+      BOOLEAN_NOT_EQUAL:              8
+    };
     RoleFlags: {
       IN_PROMPT: 1;
     };
@@ -2538,6 +2562,7 @@ declare namespace Eris {
     name: string;
     owner: PartialUser;
     privacy_policy_url?: string;
+    role_connections_verification_url?: string;
     rpc_origins?: string[];
     /** @deprecated */
     summary: "";
@@ -2877,6 +2902,7 @@ declare namespace Eris {
     /** @deprecated */
     editNickname(guildID: string, nick: string, reason?: string): Promise<void>;
     editRole(guildID: string, roleID: string, options: RoleOptions, reason?: string): Promise<Role>; // TODO not all options are available?
+    editRoleConnectionMetadataRecords(data: ApplicationRoleConnectionMetadata): Promise<ApplicationRoleConnectionMetadata[]>
     editRolePosition(guildID: string, roleID: string, position: number): Promise<void>;
     editSelf(options: { avatar?: string; username?: string }): Promise<ExtendedUser>;
     editSelfConnection(
@@ -2985,6 +3011,7 @@ declare namespace Eris {
     getRESTGuildStickers(guildID: string): Promise<Sticker[]>;
     getRESTSticker(stickerID: string): Promise<Sticker>;
     getRESTUser(userID: string): Promise<User>;
+    getRoleConnectionMetadataRecords(): Promise<ApplicationRoleConnectionMetadata[]>;
     getSelf(): Promise<ExtendedUser>;
     getSelfBilling(): Promise<{
       payment_gateway?: string;
@@ -3774,6 +3801,7 @@ declare namespace Eris {
     reactions: { [s: string]: { count: number; me: boolean } };
     referencedMessage?: Message | null;
     roleMentions: string[];
+    roleSubscriptionData?: RoleSubscriptionData;
     stickerItems?: StickerItems[];
     /** @deprecated */
     stickers?: Sticker[];

lib/Client.js

@@ -2172,6 +2172,15 @@ class Client extends EventEmitter {
         return this.requestHandler.request("PATCH", Endpoints.GUILD_ROLE(guildID, roleID), true, options).then((role) => new Role(role, this.guilds.get(guildID)));
     }
 
+    /**
+     * Update the role connection metadata for the application
+     * @arg {Array<Object>} data An array of role connection metadata objects. See [the official Discord API documentation entry](https://discord.com/developers/docs/resources/application-role-connection-metadata#application-role-connection-metadata-object) for object structure
+     * @returns {Promise<Array<Object>>} An array of role connection metadata objects
+     */
+    editRoleConnectionMetadataRecords(data) {
+        return this.requestHandler.request("PUT", Endpoints.ROLE_CONNECTION_METADATA_RECORDS(this.application.id), true, data);
+    }
+
     /**
      * Edit a guild role's position. Note that role position numbers are highest on top and lowest at the bottom.
      * @arg {String} guildID The ID of the guild the role is in
@@ -3421,6 +3430,14 @@ class Client extends EventEmitter {
         return this.requestHandler.request("GET", Endpoints.USER(userID), true).then((user) => new User(user, this));
     }
 
+    /**
+     * Get the role connection metadata for the application
+     * @returns {Promise<Array<Object>>} An array of role connection metadata objects. See [the official Discord API documentation entry](https://discord.com/developers/docs/resources/application-role-connection-metadata#application-role-connection-metadata-object) for object structure
+     */
+    getRoleConnectionMetadataRecords() {
+        return this.requestHandler.request("GET", Endpoints.ROLE_CONNECTION_METADATA_RECORDS(this.application.id), true);
+    }
+
     /**
      * Get properties of the bot user
      * @returns {Promise<ExtendedUser>}

lib/Constants.js

@@ -278,7 +278,8 @@ module.exports.GuildIntegrationExpireBehavior = {
 module.exports.GuildIntegrationTypes = [
     "twitch",
     "youtube",
-    "discord"
+    "discord",
+    "guild_subscription"
 ];
 
 module.exports.GuildNSFWLevels = {
@@ -646,6 +647,17 @@ module.exports.PremiumTypes = {
     NITRO:         2
 };
 
+module.exports.RoleConnectionMetadataTypes = {
+    INTEGER_LESS_THAN_OR_EQUAL:     1,
+    INTEGER_GREATER_THAN_OR_EQUAL:  2,
+    INTEGER_EQUAL:                  3,
+    INTEGER_NOT_EQUAL:              4,
+    DATETIME_LESS_THAN_OR_EQUAL:    5,
+    DATETIME_GREATER_THAN_OR_EQUAL: 6,
+    BOOLEAN_EQUAL:                  7,
+    BOOLEAN_NOT_EQUAL:              8
+};
+
 module.exports.RoleFlags = {
     IN_PROMPT: 1 << 0
 };

lib/structures/Message.js

@@ -44,6 +44,7 @@ const User = require("./User");
  * @prop {Object} reactions An object containing the reactions on the message. Each key is a reaction emoji and each value is an object with properties `me` (Boolean) and `count` (Number) for that specific reaction emoji.
  * @prop {Message?} referencedMessage The message that was replied to. If undefined, message data was not received. If null, the message was deleted.
  * @prop {Array<String>} roleMentions Array of mentioned roles' ids
+ * @prop {Object?} roleSubscriptionData An object containing the data of the role subscription purchase or renewal that prompted this `ROLE_SUBSCRIPTION_PURCHASE` message. See [the official Discord API documentation entry](https://discord.com/developers/docs/resources/channel#role-subscription-data-object) for object structure
  * @prop {Array<Object>?} stickers [DEPRECATED] The stickers sent with the message
  * @prop {Array<Object>?} stickerItems The stickers sent with the message
  * @prop {Number} timestamp Timestamp of message creation
@@ -140,6 +141,10 @@ class Message extends Base {
             this.member = null;
         }
 
+        if(data.role_subscription_data !== undefined) {
+            this.roleSubscriptionData = data.role_subscription_data;
+        }
+
         switch(this.type) {
             case MessageTypes.DEFAULT: {
                 break;
@@ -244,6 +249,10 @@ class Message extends Base {
             case MessageTypes.AUTO_MODERATION_ACTION: {
                 break;
             }
+            case MessageTypes.ROLE_SUBSCRIPTION_PURCHASE: {
+                // I have no clue what the message content is for this, any help would be appreciated
+                break;
+            }
             default: {
                 this._client.emit("warn", `Unhandled MESSAGE_CREATE type: ${JSON.stringify(data, null, 2)}`);
                 break;