feat(invite): Guest invites (#6247)

* feat(invite): Guest invites

* Apply suggestion

Co-authored-by: Ruairi O hUanachain <[email protected]>

* update flags docs

* fix link

* actually fix ci this time

---------

Co-authored-by: Ruairi O hUanachain <[email protected]>
Co-authored-by: advaith <[email protected]>

Author: 3 people

docs/resources/guild.mdx

@@ -159,6 +159,7 @@ Fields specific to the `GUILD_CREATE` event are listed in the [Gateway Events do
 | VERIFIED                                  | guild is verified                                                                                                             |
 | VIP_REGIONS                               | guild has access to set 384kbps bitrate in voice (previously VIP voice servers)                                               |
 | WELCOME_SCREEN_ENABLED                    | guild has enabled the welcome screen                                                                                          |
+| GUESTS_ENABLED                            | guild has access to guest invites                                                                                             |
 | ENHANCED_ROLE_COLORS                      | guild is able to set gradient colors to roles                                                                                 |
 
 ###### Mutable Guild Features
@@ -359,7 +360,7 @@ The fields `id`, `discriminator` and `avatar` are anonymized to prevent abuse.
 | avatar?                       | ?string                                                                              | the member's [guild avatar hash](/docs/reference#image-formatting)                                                                                                                                                                   |
 | banner?                       | ?string                                                                              | the member's [guild banner hash](/docs/reference#image-formatting)                                                                                                                                                                   |
 | roles                         | array of snowflakes                                                                  | array of [role](/docs/topics/permissions#role-object) object ids                                                                                                                                                                     |
-| joined_at                     | ISO8601 timestamp                                                                    | when the user joined the guild                                                                                                                                                                                                       |
+| joined_at                     | ?ISO8601 timestamp                                                                   | when the user joined the guild                                                                                                                                                                                                       |
 | premium_since?                | ?ISO8601 timestamp                                                                   | when the user started [boosting](https://support.discord.com/hc/en-us/articles/360028038352-Server-Boosting-) the guild                                                                                                              |
 | deaf                          | boolean                                                                              | whether the user is deafened in voice channels                                                                                                                                                                                       |
 | mute                          | boolean                                                                              | whether the user is muted in voice channels                                                                                                                                                                                          |
@@ -377,6 +378,9 @@ The field `user` won't be included in the member object attached to `MESSAGE_CRE
 In `GUILD_` events, `pending` will always be included as true or false. In non `GUILD_` events which can only be triggered by non-`pending` users, `pending` will not be included.
 :::
 
+> info
+> Member objects retrieved from `VOICE_STATE_UPDATE` events will have `joined_at` set as `null` if the member was invited as a guest.
+
 ###### Example Guild Member
 
 ```json
@@ -1511,4 +1515,4 @@ Both `invites_disabled_until` and `dms_disabled_until` can be enabled for a maxi
 | invites_disabled_until? | ?ISO8601 timestamp \* | when invites will be enabled again         |
 | dms_disabled_until?     | ?ISO8601 timestamp \* | when direct messages will be enabled again |
 
-\* Supplying `null` disables the action.
+\* Supplying `null` disables the action.

docs/resources/invite.mdx

@@ -25,6 +25,7 @@ Represents a code that when used, adds a user to a guild or group DM channel.
 | expires_at?                 | ?ISO8601 timestamp                                                                                 | the expiration date of this invite, returned from the `GET /invites/<code>` endpoint when `with_expiration` is `true`                          |
 | stage_instance?             | [invite stage instance](/docs/resources/invite#invite-stage-instance-object) object                | stage instance data if there is a [public Stage instance](/docs/resources/stage-instance) in the Stage channel this invite is for (deprecated) |
 | guild_scheduled_event?      | [guild scheduled event](/docs/resources/guild-scheduled-event#guild-scheduled-event-object) object | guild scheduled event data, only included if `guild_scheduled_event_id` contains a valid guild scheduled event id                              |
+| flags?                      | integer                                                                                            | [guild invite flags](/docs/resources/invite#invite-object-guild-invite-flags) for guild invites                                                |
 
 ###### Invite Types
 
@@ -41,6 +42,12 @@ Represents a code that when used, adds a user to a guild or group DM channel.
 | STREAM               | 1     |
 | EMBEDDED_APPLICATION | 2     |
 
+###### Guild Invite Flags
+
+| Flag            | Value    | Description                                       |
+|-----------------|----------|---------------------------------------------------|
+| IS_GUEST_INVITE | `1 << 0` | this invite is a guest invite for a voice channel |
+
 ###### Example Invite Object
 
 ```json