feat: add guest invites

docs/api.rst

@@ -4629,6 +4629,14 @@ ApplicationFlags
 .. autoclass:: ApplicationFlags
     :members:
 
+InviteFlags
+~~~~~~~~~~~
+
+.. attributetable:: InviteFlags
+
+.. autoclass:: InviteFlags
+    :members:
+
 File
 ~~~~
 

nextcord/flags.py

@@ -31,6 +31,7 @@
     "MemberCacheFlags",
     "ApplicationFlags",
     "ChannelFlags",
+    "InviteFlags",
 )
 
 BF = TypeVar("BF", bound="BaseFlags")
@@ -1297,3 +1298,41 @@ def active(self):
         .. versionadded:: 2.4
         """
         return 1 << 24
+
+
+@fill_with_flags()
+class InviteFlags(BaseFlags):
+    r"""Wraps up the Discord Guild Flags.
+
+    .. container:: operations
+
+        .. describe:: x == y
+
+            Checks if two InviteFlags are equal.
+        .. describe:: x != y
+
+            Checks if two InviteFlags are not equal.
+        .. describe:: hash(x)
+
+            Return the flag's hash.
+        .. describe:: iter(x)
+
+            Returns an iterator of ``(name, value)`` pairs. This allows it
+            to be, for example, constructed as a dict or a list of pairs.
+            Note that aliases are not shown.
+
+    .. versionadded:: 2.6
+
+    Attributes
+    ----------
+    value: :class:`int`
+        The raw value. You should query flags via the properties
+        rather than using this raw value.
+    """
+
+    @flag_value
+    def guest(self):
+        """:class:`bool`: Returns ``True`` if invite is a guest invite.
+
+        .. versionadded:: 2.6"""
+        return 1 << 0

nextcord/guild.py

@@ -209,6 +209,7 @@ class Guild(Hashable):
         - ``DEVELOPER_SUPPORT_SERVER``: Guild has been set as a support server on the App Directory.
         - ``DISCOVERABLE``: Guild shows up in Server Discovery.
         - ``FEATURABLE``: Guild is able to be featured in Server Discovery.
+        - ``GUESTS_ENABLED``: Guild has access to guild invites
         - ``INVITES_DISABLED``: Guild has paused invites, preventing new users from joining.
         - ``INVITE_SPLASH``: Guild's invite page can have a special splash.
         - ``MEMBER_VERIFICATION_GATE_ENABLED``: Guild has Membership Screening enabled.

nextcord/invite.py

@@ -27,6 +27,7 @@
     from .types.invite import (
         GatewayInvite as GatewayInvitePayload,
         Invite as InvitePayload,
+        InviteFlags as InviteFlagsPayload,
         InviteGuild as InviteGuildPayload,
         VanityInvite as VanityInvitePayload,
     )
@@ -293,6 +294,10 @@ class Invite(Hashable):
         The embedded application the invite targets, if any.
 
         .. versionadded:: 2.0
+    flags: Optional[:class:`InviteFlags`]
+        The invite's flags.
+
+        .. versionadded:: 2.6
     """
 
     __slots__ = (
@@ -313,6 +318,7 @@ class Invite(Hashable):
         "approximate_presence_count",
         "target_application",
         "expires_at",
+        "flags",
     )
 
     BASE = "https://discord.gg"
@@ -363,6 +369,8 @@ def __init__(
             PartialAppInfo(data=application, state=state) if application else None
         )
 
+        self.flags: Optional[InviteFlagsPayload] = data.get("flags")
+
     @classmethod
     def from_incomplete(cls, *, state: ConnectionState, data: InvitePayload) -> Self:
         guild: Optional[Union[Guild, PartialInviteGuild]]

nextcord/types/guild.py

@@ -44,6 +44,7 @@ class UnavailableGuild(TypedDict):
     "DEVELOPER_SUPPORT_SERVER",
     "DISCOVERABLE",
     "FEATURABLE",
+    "GUESTS_ENABLED",
     "INVITES_DISABLED",
     "INVITE_SPLASH",
     "MEMBER_VERIFICATION_GATE_ENABLED",

nextcord/types/invite.py

@@ -6,6 +6,7 @@
 
 from typing_extensions import NotRequired
 
+from ..flags import InviteFlags
 from .appinfo import PartialAppInfo
 from .channel import PartialChannel
 from .guild import InviteGuild, _GuildPreviewUnique
@@ -40,6 +41,7 @@ class Invite(IncompleteInvite, total=False):
     target_user: PartialUser
     target_type: InviteTargetType
     target_application: PartialAppInfo
+    flags: InviteFlags
 
 
 class InviteWithCounts(Invite, _GuildPreviewUnique):
@@ -59,6 +61,7 @@ class GatewayInviteCreate(TypedDict):
     target_type: NotRequired[InviteTargetType]
     target_user: NotRequired[PartialUser]
     target_application: NotRequired[PartialAppInfo]
+    flags: InviteFlags
 
 
 class GatewayInviteDelete(TypedDict):