feat: role subscriptions

docs/api.rst

@@ -1440,6 +1440,12 @@ of :class:`enum.Enum`.
 
         .. versionadded:: 2.1
 
+    .. attribute:: role_subscription_purchase
+
+        The system message denoting that a role subscription was purchased.
+
+        .. versionadded:: 2.4
+
 .. class:: UserFlags
 
     Represents Discord User flags.

nextcord/enums.py

@@ -178,6 +178,7 @@ class MessageType(IntEnum):
     guild_invite_reminder = 22
     context_menu_command = 23
     auto_moderation_action = 24
+    role_subscription_purchase = 25
 
 
 class VoiceRegion(StrEnum):

nextcord/message.py

@@ -1269,6 +1269,9 @@ def system_content(self):
         if self.type is MessageType.guild_invite_reminder:
             return "Wondering who to invite?\nStart by inviting anyone who can help you build the server!"
 
+        if self.type is MessageType.role_subscription_purchase:
+            ...  # TODO: implement this
+
     async def delete(self, *, delay: Optional[float] = None) -> None:
         """|coro|
 

nextcord/role.py

@@ -47,22 +47,32 @@ class RoleTags:
         The bot's user ID that manages this role.
     integration_id: Optional[:class:`int`]
         The integration ID that manages the role.
+    subscription_listing_id: Optional[:class:`int`]
+        The id of this role's subscription sku and listing
+
+        .. versionadded:: 2.4
     """
 
     __slots__ = (
         "bot_id",
         "integration_id",
+        "subscription_listing_id",
         "_premium_subscriber",
+        "_available_for_purchase",
     )
 
     def __init__(self, data: RoleTagPayload):
         self.bot_id: Optional[int] = get_as_snowflake(data, "bot_id")
         self.integration_id: Optional[int] = get_as_snowflake(data, "integration_id")
+        self.subscription_listing_id: Optional[int] = get_as_snowflake(
+            data, "subscription_listing_id"
+        )
         # NOTE: The API returns "null" for this if it's valid, which corresponds to None.
         # This is different from other fields where "null" means "not there".
         # So in this case, a value of None is the same as True.
         # Which means we would need a different sentinel.
         self._premium_subscriber: Optional[Any] = data.get("premium_subscriber", MISSING)
+        self._available_for_purchase: Optional[Any] = data.get("available_for_purchase", MISSING)
 
     def is_bot_managed(self) -> bool:
         """:class:`bool`: Whether the role is associated with a bot."""
@@ -72,6 +82,13 @@ def is_premium_subscriber(self) -> bool:
         """:class:`bool`: Whether the role is the premium subscriber, AKA "boost", role for the guild."""
         return self._premium_subscriber is None
 
+    def is_available_for_purchase(self) -> bool:
+        """:class:`bool`: Whether the role is available for purchase.
+
+        .. versionadded:: 2.4
+        """
+        return self._available_for_purchase is None
+
     def is_integration(self) -> bool:
         """:class:`bool`: Whether the role is managed by an integration."""
         return self.integration_id is not None

nextcord/types/guild.py

@@ -58,6 +58,8 @@ class UnavailableGuild(TypedDict):
     "VERIFIED",
     "VIP_REGIONS",
     "WELCOME_SCREEN_ENABLED",
+    "ROLE_SUBSCRIPTIONS_AVAILABLE_FOR_PURCHASE",
+    "ROLE_SUBSCRIPTIONS_ENABLED",
 ]
 
 

nextcord/types/role.py

@@ -27,3 +27,5 @@ class RoleTags(TypedDict, total=False):
     bot_id: Snowflake
     integration_id: Snowflake
     premium_subscriber: None
+    subscription_listing_id: Snowflake
+    available_for_purchase: None