feat: support linked roles

Author: LordOfPolls

interactions/client/utils/__init__.py

@@ -12,6 +12,7 @@
     get_object_name,
     get_parameters,
     maybe_coroutine,
+    nulled_boolean_get,
     wrap_partial,
 )
 from .serializer import (
@@ -71,6 +72,7 @@
     "get_object_name",
     "get_parameters",
     "maybe_coroutine",
+    "nulled_boolean_get",
     "wrap_partial",
     "dict_filter",
     "dict_filter_none",

interactions/client/utils/misc_utils.py

@@ -21,6 +21,7 @@
     "get_event_name",
     "get_object_name",
     "maybe_coroutine",
+    "nulled_boolean_get",
 )
 
 mention_reg = re.compile(r"@(everyone|here|[!&]?[0-9]{17,20})")
@@ -245,3 +246,20 @@ def disable_components(*components: "BaseComponent") -> list["BaseComponent"]:
         else:
             component.disabled = True
     return list(components)
+
+
+def nulled_boolean_get(data: dict[str, Any], key: str) -> bool:
+    """
+    Gets a boolean value from a dictionary, but treats None as True.
+
+    Args:
+        data: The dictionary to get the value from
+        key: The key to get the value from
+
+    Returns:
+        The boolean value of the key
+    """
+    # discord tags are weird, when they are None they are True, when they are True they are True and when they are False they are False
+    if key in data:
+        return True if data[key] is None else bool(data[key])
+    return False

interactions/models/discord/role.py

@@ -4,6 +4,7 @@
 import attrs
 
 from interactions.client.const import MISSING, T, Missing
+from interactions.client.utils import nulled_boolean_get
 from interactions.client.utils.attr_converters import optional as optional_c
 from interactions.client.utils.serializer import dict_filter
 from interactions.models.discord.asset import Asset
@@ -55,6 +56,7 @@ class Role(DiscordObject):
     )
     _bot_id: "Snowflake_Type | None" = attrs.field(repr=False, default=None)
     _integration_id: "Snowflake_Type | None" = attrs.field(repr=False, default=None)  # todo integration object?
+    _guild_connections: bool = attrs.field(repr=False, default=False)
 
     def __lt__(self: "Role", other: "Role") -> bool:
         if not isinstance(self, Role) or not isinstance(other, Role):
@@ -85,13 +87,9 @@ def _process_dict(cls, data: dict[str, Any], client: "Client") -> dict[str, Any]
         if icon_hash := data.get("icon"):
             data["icon"] = Asset.from_path_hash(client, f"role-icons/{data['id']}/{{}}", icon_hash)
 
-        if "premium_subscriber" in data:
-            if data["premium_subscriber"] is None:
-                data["premium_subscriber"] = True
-            else:
-                data["premium_subscriber"] = bool(data["premium_subscriber"])
-        else:
-            data["premium_subscriber"] = False
+        data["premium_subscriber"] = nulled_boolean_get(data, "premium_subscriber")
+        data["guild_connections"] = nulled_boolean_get(data, "guild_connections")
+        data["available_for_purchase"] = nulled_boolean_get(data, "available_for_purchase")
 
         return data
 
@@ -134,6 +132,11 @@ def bot_managed(self) -> bool:
         """Is this role owned/managed by a bot."""
         return self._bot_id is not None
 
+    @property
+    def is_linked_role(self) -> bool:
+        """Is this role a linked role."""
+        return self._guild_connections
+
     @property
     def mention(self) -> str:
         """Returns a string that would mention the role."""