feat: add member flags (#1252)

* feat: add member flags

* ci: correct from checks.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: Damego

interactions/api/models/flags.py

@@ -2,7 +2,15 @@
 
 from ...client.enums import StrEnum
 
-__all__ = ("Intents", "AppFlags", "StatusType", "UserFlags", "Permissions", "MessageFlags")
+__all__ = (
+    "Intents",
+    "AppFlags",
+    "StatusType",
+    "UserFlags",
+    "Permissions",
+    "MessageFlags",
+    "MemberFlags",
+)
 
 
 class Intents(IntFlag):
@@ -216,3 +224,21 @@ class MessageFlags(IntFlag):
     EPHEMERAL = 1 << 6
     LOADING = 1 << 7
     FAILED_TO_MENTION_SOME_ROLES_IN_THREAD = 1 << 8
+
+
+class MemberFlags(IntFlag):
+    """
+    .. versionadded:: 4.4.0
+
+    An integer flag bitshift object representing member flags on the guild.
+
+    :ivar int DID_REJOIN: Member has left and rejoined the guild
+    :ivar int COMPLETED_ONBOARDING: Member has completed onboarding
+    :ivar int BYPASSES_VERIFICATION: Member bypasses guild verification requirements
+    :ivar int STARTED_ONBOARDING: Member has started onboarding
+    """
+
+    DID_REJOIN = 1 << 0
+    COMPLETED_ONBOARDING = 1 << 1
+    BYPASSES_VERIFICATION = 1 << 2
+    STARTED_ONBOARDING = 1 << 3

interactions/api/models/member.py

@@ -6,7 +6,7 @@
 from ...utils.utils import search_iterable
 from ..error import LibraryException
 from .channel import Channel
-from .flags import Permissions
+from .flags import MemberFlags, Permissions
 from .misc import AllowedMentions, File, IDMixin, Snowflake
 from .role import Role
 from .user import User
@@ -38,6 +38,7 @@ class Member(ClientSerializerMixin, IDMixin):
     :ivar datetime premium_since: The timestamp the member has been a server booster since.
     :ivar bool deaf: Whether the member is deafened.
     :ivar bool mute: Whether the member is muted.
+    :ivar MemberFlags flags: The guild member flags. Default to 0.
     :ivar Optional[bool] pending: Whether the member is pending to pass membership screening.
     :ivar Optional[Permissions] permissions: Whether the member has permissions.
     :ivar Optional[str] communication_disabled_until: How long until they're unmuted, if any.
@@ -53,6 +54,7 @@ class Member(ClientSerializerMixin, IDMixin):
     )
     deaf: bool = field()
     mute: bool = field()
+    flags: MemberFlags = field(converter=convert_int(MemberFlags), repr=False)
     is_pending: Optional[bool] = field(default=None, repr=False)
     pending: Optional[bool] = field(default=None, repr=False)
     permissions: Optional[Permissions] = field(
@@ -64,7 +66,6 @@ class Member(ClientSerializerMixin, IDMixin):
     hoisted_role: Optional[Any] = field(
         default=None, repr=False
     )  # TODO: Investigate what this is for when documented by Discord.
-    flags: int = field(repr=False)  # TODO: Investigate what this is for when documented by Discord.
 
     def __getattr__(self, name):
         # Forward any attributes the user has to make it easier for devs