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,42 @@ def active(self):
         .. versionadded:: 2.4
         """
         return 1 << 24
+
+
+@fill_with_flags()
+class InviteFlags(BaseFlags):
+    r"""Wraps up the Invite 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 the 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 guest 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

@@ -21,6 +21,7 @@
     from typing_extensions import Self
 
     from .abc import GuildChannel
+    from .flags import InviteFlags
     from .guild import Guild
     from .state import ConnectionState
     from .types.channel import PartialChannel as InviteChannelPayload
@@ -313,6 +314,7 @@ class Invite(Hashable):
         "approximate_presence_count",
         "target_application",
         "expires_at",
+        "_flags",
     )
 
     BASE = "https://discord.gg"
@@ -363,6 +365,8 @@ def __init__(
             PartialAppInfo(data=application, state=state) if application else None
         )
 
+        self._flags = data.get("flags", 0)
+
     @classmethod
     def from_incomplete(cls, *, state: ConnectionState, data: InvitePayload) -> Self:
         guild: Optional[Union[Guild, PartialInviteGuild]]
@@ -486,3 +490,11 @@ async def delete(self, *, reason: Optional[str] = None) -> None:
             return
 
         await self._state.http.delete_invite(self.code, reason=reason)
+
+    @property
+    def flags(self) -> InviteFlags:
+        """:class:`InviteFlags`: The avaliable flags the invite has.
+
+        .. versionadded:: 2.6
+        """
+        return InviteFlags._from_value(self._flags)

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

@@ -40,6 +40,7 @@ class Invite(IncompleteInvite, total=False):
     target_user: PartialUser
     target_type: InviteTargetType
     target_application: PartialAppInfo
+    flags: int
 
 
 class InviteWithCounts(Invite, _GuildPreviewUnique):
@@ -59,6 +60,7 @@ class GatewayInviteCreate(TypedDict):
     target_type: NotRequired[InviteTargetType]
     target_user: NotRequired[PartialUser]
     target_application: NotRequired[PartialAppInfo]
+    flags: int
 
 
 class GatewayInviteDelete(TypedDict):