feat: Implement barebones Linked Roles support. (#1203)

* docs, feat: Implement barebones Linked Roles support.

* chore: Revert accidental file change on role dispatching.

(not sure what happened)

* docs: Typehint HTTP methods.

Author: FayeDel

interactions/api/http/client.py

@@ -1,4 +1,4 @@
-from typing import TYPE_CHECKING, Any, Optional, Tuple
+from typing import TYPE_CHECKING, Any, List, Optional, Tuple
 
 from .channel import ChannelRequest
 from .emoji import EmojiRequest
@@ -120,3 +120,25 @@ async def get_current_authorisation_information(self) -> dict:
         Returns info about the current authorization of the bot user
         """
         return await self._req.request(Route("GET", "/oauth2/@me"))
+
+    # ---- Role connection metadata endpoints
+
+    async def get_application_role_connection_metadata(self, application_id: int) -> List[dict]:
+        """
+        Returns a list of application role connection metadata objects for an application.
+        """
+        return await self._req.request(
+            Route("GET", f"/applications/{application_id}/role-connections/metadata")
+        )
+
+    async def update_application_role_connection_metadata(
+        self, application_id: int, payload: List[dict]
+    ) -> List[dict]:
+        """
+        Updates and returns a list of application role connection metadata objects for an application.
+
+        .. note:: The maximum metadata objects supported via the API is five.
+        """
+        return await self._req.request(
+            Route("PUT", f"/applications/{application_id}/role-connections/metadata"), json=payload
+        )

interactions/api/models/team.py

@@ -1,7 +1,15 @@
 from datetime import datetime
-from typing import Any, List, Optional
-
-from ...utils.attrs_utils import ClientSerializerMixin, convert_list, define, field
+from enum import IntEnum
+from typing import Any, Dict, List, Optional, Union
+
+from ...client.enums import Locale
+from ...utils.attrs_utils import (
+    ClientSerializerMixin,
+    DictSerializerMixin,
+    convert_list,
+    define,
+    field,
+)
 from .flags import AppFlags
 from .misc import IDMixin, Snowflake
 from .user import User
@@ -10,6 +18,8 @@
     "Team",
     "TeamMember",
     "Application",
+    "ApplicationRoleConnectionMetadataType",
+    "ApplicationRoleConnectionMetadata",
 )
 
 
@@ -79,6 +89,7 @@ class Application(ClientSerializerMixin, IDMixin):
     :ivar Optional[str] slug: URL slug that links to the store page, if this app is a game sold on Discord
     :ivar Optional[str] cover_image: The app's default rich presence invite cover image
     :ivar Optional[AppFlags] flags: The application's public flags
+    :ivar Optional[str] role_connections_verification_url: The application's role connection verification URL, if given.
     """
 
     id: Snowflake = field(converter=Snowflake)
@@ -101,6 +112,7 @@ class Application(ClientSerializerMixin, IDMixin):
     flags: Optional[AppFlags] = field(converter=AppFlags, default=None)
     type: Optional[Any] = field(default=None)
     hook: Optional[Any] = field(default=None)
+    role_connections_verification_url: Optional[str] = field(default=None, repr=False)
 
     @property
     def icon_url(self) -> Optional[str]:
@@ -127,3 +139,38 @@ def created_at(self) -> datetime:
         Returns when the application was created.
         """
         return self.id.timestamp
+
+
+class ApplicationRoleConnectionMetadataType(IntEnum):
+    """
+    .. versionadded:: 4.4.0
+
+    An enumerable object representing the app role connection metadata types
+    """
+
+    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
+
+
+@define()
+class ApplicationRoleConnectionMetadata(DictSerializerMixin):
+    """
+    .. versionadded:: 4.4.0
+
+    A class object representing role connection metadata for the application/bot/client.
+    """
+
+    type: ApplicationRoleConnectionMetadataType = field(
+        converter=ApplicationRoleConnectionMetadataType
+    )
+    key: str = field()
+    name: str = field()
+    name_localizations: Optional[Dict[Union[str, Locale], str]] = field(default=None)
+    description: str = field()
+    description_localizations: Optional[Dict[Union[str, Locale], str]] = field(default=None)