dfx 0.0.1 → 0.0.4

package/discord-api-docs/docs/topics/Opcodes_and_Status_Codes.md

@@ -1,306 +0,0 @@
-# Opcodes and Status Codes
-
-## Gateway
-
-All gateway events in Discord are tagged with an opcode that denotes the payload type. Your connection to our gateway may also sometimes close. When it does, you will receive a close code that tells you what happened.
-
-###### Gateway Opcodes
-
-| Code | Name                  | Client Action | Description                                                                             |
-|------|-----------------------|---------------|-----------------------------------------------------------------------------------------|
-| 0    | Dispatch              | Receive       | An event was dispatched.                                                                |
-| 1    | Heartbeat             | Send/Receive  | Fired periodically by the client to keep the connection alive.                          |
-| 2    | Identify              | Send          | Starts a new session during the initial handshake.                                      |
-| 3    | Presence Update       | Send          | Update the client's presence.                                                           |
-| 4    | Voice State Update    | Send          | Used to join/leave or move between voice channels.                                      |
-| 6    | Resume                | Send          | Resume a previous session that was disconnected.                                        |
-| 7    | Reconnect             | Receive       | You should attempt to reconnect and resume immediately.                                 |
-| 8    | Request Guild Members | Send          | Request information about offline guild members in a large guild.                       |
-| 9    | Invalid Session       | Receive       | The session has been invalidated. You should reconnect and identify/resume accordingly. |
-| 10   | Hello                 | Receive       | Sent immediately after connecting, contains the `heartbeat_interval` to use.            |
-| 11   | Heartbeat ACK         | Receive       | Sent in response to receiving a heartbeat to acknowledge that it has been received.     |
-
-###### Gateway Close Event Codes
-
-In order to prevent broken reconnect loops, you should consider some close codes as a signal to stop reconnnecting. This can be because your token expired, or your identification is invalid. This table explains what the application defined close codes for the gateway are, and which close codes you should not attempt to reconnect.
-
-
-| Code | Description           | Explanation                                                                                                                                                                                                                      | Reconnect |
-|------|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|
-| 4000 | Unknown error         | We're not sure what went wrong. Try reconnecting?                                                                                                                                                                                | true      |
-| 4001 | Unknown opcode        | You sent an invalid [Gateway opcode](#DOCS_TOPICS_OPCODES_AND_STATUS_CODES/gateway-gateway-opcodes) or an invalid payload for an opcode. Don't do that!                                                                          | true      |
-| 4002 | Decode error          | You sent an invalid [payload](#DOCS_TOPICS_GATEWAY/sending-payloads) to us. Don't do that!                                                                                                                                       | true      |
-| 4003 | Not authenticated     | You sent us a payload prior to [identifying](#DOCS_TOPICS_GATEWAY/identify).                                                                                                                                                     | true      |
-| 4004 | Authentication failed | The account token sent with your [identify payload](#DOCS_TOPICS_GATEWAY/identify) is incorrect.                                                                                                                                 | false     |
-| 4005 | Already authenticated | You sent more than one identify payload. Don't do that!                                                                                                                                                                          | true      |
-| 4007 | Invalid `seq`         | The sequence sent when [resuming](#DOCS_TOPICS_GATEWAY/resume) the session was invalid. Reconnect and start a new session.                                                                                                       | true      |
-| 4008 | Rate limited          | Woah nelly! You're sending payloads to us too quickly. Slow it down! You will be disconnected on receiving this.                                                                                                                 | true      |
-| 4009 | Session timed out     | Your session timed out. Reconnect and start a new one.                                                                                                                                                                           | true      |
-| 4010 | Invalid shard         | You sent us an invalid [shard when identifying](#DOCS_TOPICS_GATEWAY/sharding).                                                                                                                                                  | false     |
-| 4011 | Sharding required     | The session would have handled too many guilds - you are required to [shard](#DOCS_TOPICS_GATEWAY/sharding) your connection in order to connect.                                                                                 | false     |
-| 4012 | Invalid API version   | You sent an invalid version for the gateway.                                                                                                                                                                                     | false     |
-| 4013 | Invalid intent(s)     | You sent an invalid intent for a [Gateway Intent](#DOCS_TOPICS_GATEWAY/gateway-intents). You may have incorrectly calculated the bitwise value.                                                                                  | false     |
-| 4014 | Disallowed intent(s)  | You sent a disallowed intent for a [Gateway Intent](#DOCS_TOPICS_GATEWAY/gateway-intents). You may have tried to specify an intent that you [have not enabled or are not approved for](#DOCS_TOPICS_GATEWAY/privileged-intents). | false     |
-
-## Voice
-
-Our voice gateways have their own set of opcodes and close codes.
-
-###### Voice Opcodes
-
-| Code | Name                | Sent By           | Description                                              |
-|------|---------------------|-------------------|----------------------------------------------------------|
-| 0    | Identify            | client            | Begin a voice websocket connection.                      |
-| 1    | Select Protocol     | client            | Select the voice protocol.                               |
-| 2    | Ready               | server            | Complete the websocket handshake.                        |
-| 3    | Heartbeat           | client            | Keep the websocket connection alive.                     |
-| 4    | Session Description | server            | Describe the session.                                    |
-| 5    | Speaking            | client and server | Indicate which users are speaking.                       |
-| 6    | Heartbeat ACK       | server            | Sent to acknowledge a received client heartbeat.         |
-| 7    | Resume              | client            | Resume a connection.                                     |
-| 8    | Hello               | server            | Time to wait between sending heartbeats in milliseconds. |
-| 9    | Resumed             | server            | Acknowledge a successful session resume.                 |
-| 13   | Client Disconnect   | server            | A client has disconnected from the voice channel         |
-
-###### Voice Close Event Codes
-
-| Code | Description              | Explanation                                                                                                                                      |
-|------|--------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|
-| 4001 | Unknown opcode           | You sent an invalid [opcode](#DOCS_TOPICS_OPCODES_AND_STATUS_CODES/voice-voice-opcodes).                                                         |
-| 4002 | Failed to decode payload | You sent a invalid payload in your [identifying](#DOCS_TOPICS_GATEWAY/identify) to the Gateway.                                                  |
-| 4003 | Not authenticated        | You sent a payload before [identifying](#DOCS_TOPICS_GATEWAY/identify) with the Gateway.                                                         |
-| 4004 | Authentication failed    | The token you sent in your [identify](#DOCS_TOPICS_GATEWAY/identify) payload is incorrect.                                                       |
-| 4005 | Already authenticated    | You sent more than one [identify](#DOCS_TOPICS_GATEWAY/identify) payload. Stahp.                                                                 |
-| 4006 | Session no longer valid  | Your session is no longer valid.                                                                                                                 |
-| 4009 | Session timeout          | Your session has timed out.                                                                                                                      |
-| 4011 | Server not found         | We can't find the server you're trying to connect to.                                                                                            |
-| 4012 | Unknown protocol         | We didn't recognize the [protocol](#DOCS_TOPICS_VOICE_CONNECTIONS/establishing-a-voice-udp-connection-example-select-protocol-payload) you sent. |
-| 4014 | Disconnected             | Channel was deleted, you were kicked, voice server changed, or the main gateway session was dropped. Should not reconnect.                       |
-| 4015 | Voice server crashed     | The server crashed. Our bad! Try [resuming](#DOCS_TOPICS_VOICE_CONNECTIONS/resuming-voice-connection).                                           |
-| 4016 | Unknown encryption mode  | We didn't recognize your [encryption](#DOCS_TOPICS_VOICE_CONNECTIONS/encrypting-and-sending-voice).                                              |
-
-## HTTP
-
-Our API will return semantically valid HTTP response codes based on the success of your request. The following table can be used as a reference for response codes it will return.
-
-###### HTTP Response Codes
-
-| Code                      | Meaning                                                                          |
-|---------------------------|----------------------------------------------------------------------------------|
-| 200 (OK)                  | The request completed successfully.                                              |
-| 201 (CREATED)             | The entity was created successfully.                                             |
-| 204 (NO CONTENT)          | The request completed successfully but returned no content.                      |
-| 304 (NOT MODIFIED)        | The entity was not modified (no action was taken).                               |
-| 400 (BAD REQUEST)         | The request was improperly formatted, or the server couldn't understand it.      |
-| 401 (UNAUTHORIZED)        | The `Authorization` header was missing or invalid.                               |
-| 403 (FORBIDDEN)           | The `Authorization` token you passed did not have permission to the resource.    |
-| 404 (NOT FOUND)           | The resource at the location specified doesn't exist.                            |
-| 405 (METHOD NOT ALLOWED)  | The HTTP method used is not valid for the location specified.                    |
-| 429 (TOO MANY REQUESTS)   | You are being rate limited, see [Rate Limits](#DOCS_TOPICS_RATE_LIMITS).         |
-| 502 (GATEWAY UNAVAILABLE) | There was not a gateway available to process your request. Wait a bit and retry. |
-| 5xx (SERVER ERROR)        | The server had an error processing your request (these are rare).                |
-
-## JSON
-
-Along with the HTTP error code, our API can also return more detailed error codes through a `code` key in the JSON error response. The response will also contain a `message` key containing a more friendly error string. Some of these errors may include additional details in the form of [Error Messages](#DOCS_REFERENCE/error-messages) provided by an `errors` object.
-
-###### JSON Error Codes
-
-| Code   | Meaning                                                                                                                       |
-|--------|-------------------------------------------------------------------------------------------------------------------------------|
-| 0      | General error (such as a malformed request body, amongst other things)                                                        |
-| 10001  | Unknown account                                                                                                               |
-| 10002  | Unknown application                                                                                                           |
-| 10003  | Unknown channel                                                                                                               |
-| 10004  | Unknown guild                                                                                                                 |
-| 10005  | Unknown integration                                                                                                           |
-| 10006  | Unknown invite                                                                                                                |
-| 10007  | Unknown member                                                                                                                |
-| 10008  | Unknown message                                                                                                               |
-| 10009  | Unknown permission overwrite                                                                                                  |
-| 10010  | Unknown provider                                                                                                              |
-| 10011  | Unknown role                                                                                                                  |
-| 10012  | Unknown token                                                                                                                 |
-| 10013  | Unknown user                                                                                                                  |
-| 10014  | Unknown emoji                                                                                                                 |
-| 10015  | Unknown webhook                                                                                                               |
-| 10016  | Unknown webhook service                                                                                                       |
-| 10020  | Unknown session                                                                                                               |
-| 10026  | Unknown ban                                                                                                                   |
-| 10027  | Unknown SKU                                                                                                                   |
-| 10028  | Unknown Store Listing                                                                                                         |
-| 10029  | Unknown entitlement                                                                                                           |
-| 10030  | Unknown build                                                                                                                 |
-| 10031  | Unknown lobby                                                                                                                 |
-| 10032  | Unknown branch                                                                                                                |
-| 10033  | Unknown store directory layout                                                                                                |
-| 10036  | Unknown redistributable                                                                                                       |
-| 10038  | Unknown gift code                                                                                                             |
-| 10049  | Unknown stream                                                                                                                |
-| 10050  | Unknown premium server subscribe cooldown                                                                                     |
-| 10057  | Unknown guild template                                                                                                        |
-| 10059  | Unknown discoverable server category                                                                                          |
-| 10060  | Unknown sticker                                                                                                               |
-| 10062  | Unknown interaction                                                                                                           |
-| 10063  | Unknown application command                                                                                                   |
-| 10065  | Unknown voice state                                                                                                           |
-| 10066  | Unknown application command permissions                                                                                       |
-| 10067  | Unknown Stage Instance                                                                                                        |
-| 10068  | Unknown Guild Member Verification Form                                                                                        |
-| 10069  | Unknown Guild Welcome Screen                                                                                                  |
-| 10070  | Unknown Guild Scheduled Event                                                                                                 |
-| 10071  | Unknown Guild Scheduled Event User                                                                                            |
-| 20001  | Bots cannot use this endpoint                                                                                                 |
-| 20002  | Only bots can use this endpoint                                                                                               |
-| 20009  | Explicit content cannot be sent to the desired recipient(s)                                                                   |
-| 20012  | You are not authorized to perform this action on this application                                                             |
-| 20016  | This action cannot be performed due to slowmode rate limit                                                                    |
-| 20018  | Only the owner of this account can perform this action                                                                        |
-| 20022  | This message cannot be edited due to announcement rate limits                                                                 |
-| 20028  | The channel you are writing has hit the write rate limit                                                                      |
-| 20029  | The write action you are performing on the server has hit the write rate limit                                                |
-| 20031  | Your Stage topic, server name, server description, or channel names contain words that are not allowed                        |
-| 20035  | Guild premium subscription level too low                                                                                      |
-| 30001  | Maximum number of guilds reached (100)                                                                                        |
-| 30002  | Maximum number of friends reached (1000)                                                                                      |
-| 30003  | Maximum number of pins reached for the channel (50)                                                                           |
-| 30004  | Maximum number of recipients reached (10)                                                                                     |
-| 30005  | Maximum number of guild roles reached (250)                                                                                   |
-| 30007  | Maximum number of webhooks reached (10)                                                                                       |
-| 30008  | Maximum number of emojis reached                                                                                              |
-| 30010  | Maximum number of reactions reached (20)                                                                                      |
-| 30013  | Maximum number of guild channels reached (500)                                                                                |
-| 30015  | Maximum number of attachments in a message reached (10)                                                                       |
-| 30016  | Maximum number of invites reached (1000)                                                                                      |
-| 30018  | Maximum number of animated emojis reached                                                                                     |
-| 30019  | Maximum number of server members reached                                                                                      |
-| 30030  | Maximum number of server categories has been reached (5)                                                                      |
-| 30031  | Guild already has a template                                                                                                  |
-| 30033  | Max number of thread participants has been reached (1000)                                                                     |
-| 30035  | Maximum number of bans for non-guild members have been exceeded                                                               |
-| 30037  | Maximum number of bans fetches has been reached                                                                               |
-| 30038  | Maximum number of uncompleted guild scheduled events reached (100)                                                            |
-| 30039  | Maximum number of stickers reached                                                                                            |
-| 30040  | Maximum number of prune requests has been reached. Try again later                                                            |
-| 30042  | Maximum number of guild widget settings updates has been reached. Try again later                                             |
-| 30046  | Maximum number of edits to messages older than 1 hour reached. Try again later                                                |
-| 40001  | Unauthorized. Provide a valid token and try again                                                                             |
-| 40002  | You need to verify your account in order to perform this action                                                               |
-| 40003  | You are opening direct messages too fast                                                                                      |
-| 40004  | Send messages has been temporarily disabled                                                                                   |
-| 40005  | Request entity too large. Try sending something smaller in size                                                               |
-| 40006  | This feature has been temporarily disabled server-side                                                                        |
-| 40007  | The user is banned from this guild                                                                                            |
-| 40032  | Target user is not connected to voice                                                                                         |
-| 40033  | This message has already been crossposted                                                                                     |
-| 40041  | An application command with that name already exists                                                                          |
-| 40060  | Interaction has already been acknowledged                                                                                     |
-| 50001  | Missing access                                                                                                                |
-| 50002  | Invalid account type                                                                                                          |
-| 50003  | Cannot execute action on a DM channel                                                                                         |
-| 50004  | Guild widget disabled                                                                                                         |
-| 50005  | Cannot edit a message authored by another user                                                                                |
-| 50006  | Cannot send an empty message                                                                                                  |
-| 50007  | Cannot send messages to this user                                                                                             |
-| 50008  | Cannot send messages in a non-text channel                                                                                    |
-| 50009  | Channel verification level is too high for you to gain access                                                                 |
-| 50010  | OAuth2 application does not have a bot                                                                                        |
-| 50011  | OAuth2 application limit reached                                                                                              |
-| 50012  | Invalid OAuth2 state                                                                                                          |
-| 50013  | You lack permissions to perform that action                                                                                   |
-| 50014  | Invalid authentication token provided                                                                                         |
-| 50015  | Note was too long                                                                                                             |
-| 50016  | Provided too few or too many messages to delete. Must provide at least 2 and fewer than 100 messages to delete                |
-| 50019  | A message can only be pinned to the channel it was sent in                                                                    |
-| 50020  | Invite code was either invalid or taken                                                                                       |
-| 50021  | Cannot execute action on a system message                                                                                     |
-| 50024  | Cannot execute action on this channel type                                                                                    |
-| 50025  | Invalid OAuth2 access token provided                                                                                          |
-| 50026  | Missing required OAuth2 scope                                                                                                 |
-| 50027  | Invalid webhook token provided                                                                                                |
-| 50028  | Invalid role                                                                                                                  |
-| 50033  | Invalid Recipient(s)                                                                                                          |
-| 50034  | A message provided was too old to bulk delete                                                                                 |
-| 50035  | Invalid form body (returned for both `application/json` and `multipart/form-data` bodies), or invalid `Content-Type` provided |
-| 50036  | An invite was accepted to a guild the application's bot is not in                                                             |
-| 50041  | Invalid API version provided                                                                                                  |
-| 50045  | File uploaded exceeds the maximum size                                                                                        |
-| 50046  | Invalid file uploaded                                                                                                         |
-| 50054  | Cannot self-redeem this gift                                                                                                  |
-| 50055  | Invalid Guild                                                                                                                 |
-| 50068  | Invalid message type                                                                                                          |
-| 50070  | Payment source required to redeem gift                                                                                        |
-| 50074  | Cannot delete a channel required for Community guilds                                                                         |
-| 50081  | Invalid sticker sent                                                                                                          |
-| 50083  | Tried to perform an operation on an archived thread, such as editing a message or adding a user to the thread                 |
-| 50084  | Invalid thread notification settings                                                                                          |
-| 50085  | `before` value is earlier than the thread creation date                                                                       |
-| 50086  | Community server channels must be text channels                                                                               |
-| 50095  | This server is not available in your location                                                                                 |
-| 50097  | This server needs monetization enabled in order to perform this action                                                        |
-| 50101  | This server needs more boosts to perform this action                                                                          |
-| 50109  | The request body contains invalid JSON.                                                                                       |
-| 60003  | Two factor is required for this operation                                                                                     |
-| 80004  | No users with DiscordTag exist                                                                                                |
-| 90001  | Reaction was blocked                                                                                                          |
-| 130000 | API resource is currently overloaded. Try again a little later                                                                |
-| 150006 | The Stage is already open                                                                                                     |
-| 160002 | Cannot reply without permission to read message history                                                                       |
-| 160004 | A thread has already been created for this message                                                                            |
-| 160005 | Thread is locked                                                                                                              |
-| 160006 | Maximum number of active threads reached                                                                                      |
-| 160007 | Maximum number of active announcement threads reached                                                                         |
-| 170001 | Invalid JSON for uploaded Lottie file                                                                                         |
-| 170002 | Uploaded Lotties cannot contain rasterized images such as PNG or JPEG                                                         |
-| 170003 | Sticker maximum framerate exceeded                                                                                            |
-| 170004 | Sticker frame count exceeds maximum of 1000 frames                                                                            |
-| 170005 | Lottie animation maximum dimensions exceeded                                                                                  |
-| 170006 | Sticker frame rate is either too small or too large                                                                           |
-| 170007 | Sticker animation duration exceeds maximum of 5 seconds                                                                       |
-| 180000 | Cannot update a finished event                                                                                                |
-| 180002 | Failed to create stage needed for stage event                                                                                 |
-
-###### Example JSON Error Response
-
-```json
-{
-  "message": "Invalid authentication token",
-  "code": 50014
-}
-```
-
-## RPC
-
-RPC is the [local Discord server](#DOCS_TOPICS_RPC/) running on localhost. Access to the RPC server requires approval from Discord.
-
-###### RPC Error Codes
-
-| Code | Name                               | Description                                                                           |
-|------|------------------------------------|---------------------------------------------------------------------------------------|
-| 1000 | Unknown error                      | An unknown error occurred.                                                            |
-| 4000 | Invalid payload                    | You sent an invalid payload.                                                          |
-| 4002 | Invalid command                    | Invalid command name specified.                                                       |
-| 4003 | Invalid guild                      | Invalid guild ID specified.                                                           |
-| 4004 | Invalid event                      | Invalid event name specified.                                                         |
-| 4005 | Invalid channel                    | Invalid channel ID specified.                                                         |
-| 4006 | Invalid permissions                | You lack permissions to access the given resource.                                    |
-| 4007 | Invalid client ID                  | An invalid OAuth2 application ID was used to authorize or authenticate with.          |
-| 4008 | Invalid origin                     | An invalid OAuth2 application origin was used to authorize or authenticate with.      |
-| 4009 | Invalid token                      | An invalid OAuth2 token was used to authorize or authenticate with.                   |
-| 4010 | Invalid user                       | The specified user ID was invalid.                                                    |
-| 5000 | OAuth2 error                       | A standard OAuth2 error occurred; check the data object for the OAuth2 error details. |
-| 5001 | Select channel timed out           | An asynchronous `SELECT_TEXT_CHANNEL`/`SELECT_VOICE_CHANNEL` command timed out.       |
-| 5002 | `GET_GUILD` timed out              | An asynchronous `GET_GUILD` command timed out.                                        |
-| 5003 | Select voice force required        | You tried to join a user to a voice channel but the user was already in one.          |
-| 5004 | Capture shortcut already listening | You tried to capture more than one shortcut key at once.                              |
-
-###### RPC Close Event Codes
-
-| Code | Name              | Description                                                               |
-|------|-------------------|---------------------------------------------------------------------------|
-| 4000 | Invalid client ID | You connected to the RPC server with an invalid client ID.                |
-| 4001 | Invalid origin    | You connected to the RPC server with an invalid origin.                   |
-| 4002 | Rate limited      | You are being rate limited.                                               |
-| 4003 | Token revoked     | The OAuth2 token associated with a connection was revoked, get a new one! |
-| 4004 | Invalid version   | The RPC Server version specified in the connection string was not valid.  |
-| 4005 | Invalid encoding  | The encoding specified in the connection string was not valid.            |

package/discord-api-docs/docs/topics/Permissions.md

@@ -1,229 +0,0 @@
-# Permissions
-
-Permissions in Discord are a way to limit and grant certain abilities to users. A set of base permissions can be configured at the guild level for different roles. When these roles are attached to users, they grant or revoke specific privileges within the guild. Along with the guild-level permissions, Discord also supports permission overwrites that can be assigned to individual guild roles or guild members on a per-channel basis.
-
-Permissions are stored within a variable-length integer serialized into a string, and are calculated using bitwise operations. For example, the permission value `123` will be serialized as `"123"`. For long-term stability, we recommend deserializing the permissions using your languages' Big Integer libraries. The total permissions integer can be determined by ORing together each individual value, and flags can be checked using AND operations.
-
-In API v8, all permissions—including `allow` and `deny` fields in overwrites—are serialized as strings. There are also no longer `_new` permission fields; all new permissions are rolled back into the base field.
-
-In API v6, the `permissions`, `allow`, and `deny` fields in roles and overwrites are still serialized as a number; however, these numbers shall not grow beyond 31 bits. During the remaining lifetime of API v6, all new permission bits will only be introduced in `permissions_new`, `allow_new`, and `deny_new`. These `_new` fields are just for response serialization; requests with these fields should continue to use the original `permissions`, `allow`, and `deny` fields, which accept both string or number values.
-
-```python
-# Permissions value that can Send Messages (0x800) and Add Reactions (0x40):
-permissions = 0x40 | 0x800 # 2112
-
-# Checking for flags that are set:
-(permissions & 0x40) == 0x40   # True
-(permissions & 0x800) == 0x800 # True
-
-# Kick Members (0x2) was not set:
-(permissions & 0x2) == 0x2 # False
-```
-
-Additional logic is required when permission overwrites are involved; this is further explained below. For more information about bitwise operations and flags, see [this page](https://en.wikipedia.org/wiki/Bit_field).
-
-Below is a table of all current permissions, their integer values in hexadecimal, brief descriptions of the privileges that they grant, and the channel type they apply to, if applicable.
-
-###### Bitwise Permission Flags
-
-| Permission                    | Value                            | Description                                                                                                                                         | Channel Type |
-| ----------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
-| CREATE_INSTANT_INVITE         | `0x0000000000000001` `(1 << 0)`  | Allows creation of instant invites                                                                                                                  | T, V, S      |
-| KICK_MEMBERS \*               | `0x0000000000000002` `(1 << 1)`  | Allows kicking members                                                                                                                              |              |
-| BAN_MEMBERS \*                | `0x0000000000000004` `(1 << 2)`  | Allows banning members                                                                                                                              |              |
-| ADMINISTRATOR \*              | `0x0000000000000008` `(1 << 3)`  | Allows all permissions and bypasses channel permission overwrites                                                                                   |              |
-| MANAGE_CHANNELS \*            | `0x0000000000000010` `(1 << 4)`  | Allows management and editing of channels                                                                                                           | T, V, S      |
-| MANAGE_GUILD \*               | `0x0000000000000020` `(1 << 5)`  | Allows management and editing of the guild                                                                                                          |              |
-| ADD_REACTIONS                 | `0x0000000000000040` `(1 << 6)`  | Allows for the addition of reactions to messages                                                                                                    | T            |
-| VIEW_AUDIT_LOG                | `0x0000000000000080` `(1 << 7)`  | Allows for viewing of audit logs                                                                                                                    |              |
-| PRIORITY_SPEAKER              | `0x0000000000000100` `(1 << 8)`  | Allows for using priority speaker in a voice channel                                                                                                | V            |
-| STREAM                        | `0x0000000000000200` `(1 << 9)`  | Allows the user to go live                                                                                                                          | V            |
-| VIEW_CHANNEL                  | `0x0000000000000400` `(1 << 10)` | Allows guild members to view a channel, which includes reading messages in text channels and joining voice channels                                 | T, V, S      |
-| SEND_MESSAGES                 | `0x0000000000000800` `(1 << 11)` | Allows for sending messages in a channel (does not allow sending messages in threads)                                                               | T            |
-| SEND_TTS_MESSAGES             | `0x0000000000001000` `(1 << 12)` | Allows for sending of `/tts` messages                                                                                                               | T            |
-| MANAGE_MESSAGES \*            | `0x0000000000002000` `(1 << 13)` | Allows for deletion of other users messages                                                                                                         | T            |
-| EMBED_LINKS                   | `0x0000000000004000` `(1 << 14)` | Links sent by users with this permission will be auto-embedded                                                                                      | T            |
-| ATTACH_FILES                  | `0x0000000000008000` `(1 << 15)` | Allows for uploading images and files                                                                                                               | T            |
-| READ_MESSAGE_HISTORY          | `0x0000000000010000` `(1 << 16)` | Allows for reading of message history                                                                                                               | T            |
-| MENTION_EVERYONE              | `0x0000000000020000` `(1 << 17)` | Allows for using the `@everyone` tag to notify all users in a channel, and the `@here` tag to notify all online users in a channel                  | T            |
-| USE_EXTERNAL_EMOJIS           | `0x0000000000040000` `(1 << 18)` | Allows the usage of custom emojis from other servers                                                                                                | T            |
-| VIEW_GUILD_INSIGHTS           | `0x0000000000080000` `(1 << 19)` | Allows for viewing guild insights                                                                                                                   |              |
-| CONNECT                       | `0x0000000000100000` `(1 << 20)` | Allows for joining of a voice channel                                                                                                               | V, S         |
-| SPEAK                         | `0x0000000000200000` `(1 << 21)` | Allows for speaking in a voice channel                                                                                                              | V            |
-| MUTE_MEMBERS                  | `0x0000000000400000` `(1 << 22)` | Allows for muting members in a voice channel                                                                                                        | V, S         |
-| DEAFEN_MEMBERS                | `0x0000000000800000` `(1 << 23)` | Allows for deafening of members in a voice channel                                                                                                  | V, S         |
-| MOVE_MEMBERS                  | `0x0000000001000000` `(1 << 24)` | Allows for moving of members between voice channels                                                                                                 | V, S         |
-| USE_VAD                       | `0x0000000002000000` `(1 << 25)` | Allows for using voice-activity-detection in a voice channel                                                                                        | V            |
-| CHANGE_NICKNAME               | `0x0000000004000000` `(1 << 26)` | Allows for modification of own nickname                                                                                                             |              |
-| MANAGE_NICKNAMES              | `0x0000000008000000` `(1 << 27)` | Allows for modification of other users nicknames                                                                                                    |              |
-| MANAGE_ROLES \*               | `0x0000000010000000` `(1 << 28)` | Allows management and editing of roles                                                                                                              | T, V, S      |
-| MANAGE_WEBHOOKS \*            | `0x0000000020000000` `(1 << 29)` | Allows management and editing of webhooks                                                                                                           | T            |
-| MANAGE_EMOJIS_AND_STICKERS \* | `0x0000000040000000` `(1 << 30)` | Allows management and editing of emojis and stickers                                                                                                |              |
-| USE_APPLICATION_COMMANDS      | `0x0000000080000000` `(1 << 31)` | Allows members to use application commands, including slash commands and context menu commands.                                                     | T            |
-| REQUEST_TO_SPEAK              | `0x0000000100000000` `(1 << 32)` | Allows for requesting to speak in stage channels. (_This permission is under active development and may be changed or removed._)                    | S            |
-| MANAGE_EVENTS                 | `0x0000000200000000` `(1 << 33)` | Allows for creating, editing, and deleting scheduled events                                                                                         | V, S         |
-| MANAGE_THREADS \*             | `0x0000000400000000` `(1 << 34)` | Allows for deleting and archiving threads, and viewing all private threads                                                                          | T            |
-| CREATE_PUBLIC_THREADS         | `0x0000000800000000` `(1 << 35)` | Allows for creating public and announcement threads                                                                                                 | T            |
-| CREATE_PRIVATE_THREADS        | `0x0000001000000000` `(1 << 36)` | Allows for creating private threads                                                                                                                 | T            |
-| USE_EXTERNAL_STICKERS         | `0x0000002000000000` `(1 << 37)` | Allows the usage of custom stickers from other servers                                                                                              | T            |
-| SEND_MESSAGES_IN_THREADS      | `0x0000004000000000` `(1 << 38)` | Allows for sending messages in threads                                                                                                              | T            |
-| USE_EMBEDDED_ACTIVITIES       | `0x0000008000000000` `(1 << 39)` | Allows for using Activities (applications with the `EMBEDDED` flag) in a voice channel                                                              | V            |
-| MODERATE_MEMBERS \*\*         | `0x0000010000000000` `(1 << 40)` | Allows for timing out users to prevent them from sending or reacting to messages in chat and threads, and from speaking in voice and stage channels |              |
-
-**\* These permissions require the owner account to use [two-factor authentication](#DOCS_TOPICS_OAUTH2/twofactor-authentication-requirement) when used on a guild that has server-wide 2FA enabled.**
-
-**\*\* See [Permissions for Timed Out Members](#DOCS_TOPICS_PERMISSIONS/permissions-for-timed-out-members) to understand how permissions are temporarily modified for timed out users.**
-
-Note that these internal permission names may be referred to differently by the Discord client. For example, "Manage Permissions" refers to MANAGE_ROLES, "Use Voice Activity" refers to USE_VAD, and "Timeout Members" refers to MODERATE_MEMBERS.
-
-## Permission Hierarchy
-
-How permissions apply may at first seem intuitive, but there are some hidden restrictions that prevent bots from performing certain inappropriate actions based on a bot's highest role compared to its target's highest role. A bot's or user's highest role is its role that has the greatest position value in the guild, with the default @everyone role starting at 0. Permissions follow a hierarchy with the following rules:
-
-- A bot can grant roles to other users that are of a lower position than its own highest role.
-- A bot can edit roles of a lower position than its highest role, but it can only grant permissions it has to those roles.
-- A bot can only sort roles lower than its highest role.
-- A bot can only kick, ban, and edit nicknames for users whose highest role is lower than the bot's highest role.
-
-Otherwise, permissions do not obey the role hierarchy. For example, a user has two roles: A and B. A denies the `VIEW_CHANNEL` permission on a #coolstuff channel. B allows the `VIEW_CHANNEL` permission on the same #coolstuff channel. The user would ultimately be able to view the #coolstuff channel, regardless of the role positions.
-
-## Permission Overwrites
-
-Certain permissions can be applied to roles or directly to members on a channel-level by using permission overwrites. Applicable permissions are indicated by a **T** for text channels, **V** for voice channels, or **S** for stage channels in the table above.
-
-When using overwrites, there are cases where permission collisions could occur for a user; that is to say, the user may have certain overwrites with permissions that contradict each other or their guild-level role permissions. With this in mind, permissions are applied to users in the following hierarchy:
-
-1. Base permissions given to @everyone are applied at a guild level
-2. Permissions allowed to a user by their roles are applied at a guild level
-3. Overwrites that deny permissions for @everyone are applied at a channel level
-4. Overwrites that allow permissions for @everyone are applied at a channel level
-5. Overwrites that deny permissions for specific roles are applied at a channel level
-6. Overwrites that allow permissions for specific roles are applied at a channel level
-7. Member-specific overwrites that deny permissions are applied at a channel level
-8. Member-specific overwrites that allow permissions are applied at a channel level
-
-The following pseudocode demonstrates this process programmatically:
-
-```python
-def compute_base_permissions(member, guild):
-    if guild.is_owner(member):
-        return ALL
-
-    role_everyone = guild.get_role(guild.id)  # get @everyone role
-    permissions = role_everyone.permissions
-
-    for role in member.roles:
-        permissions |= role.permissions
-
-    if permissions & ADMINISTRATOR == ADMINISTRATOR:
-        return ALL
-
-    return permissions
-
-def compute_overwrites(base_permissions, member, channel):
-    # ADMINISTRATOR overrides any potential permission overwrites, so there is nothing to do here.
-    if base_permissions & ADMINISTRATOR == ADMINISTRATOR:
-        return ALL
-
-    permissions = base_permissions
-    overwrite_everyone = overwrites.get(channel.guild_id)  # Find (@everyone) role overwrite and apply it.
-    if overwrite_everyone:
-        permissions &= ~overwrite_everyone.deny
-        permissions |= overwrite_everyone.allow
-
-    # Apply role specific overwrites.
-    overwrites = channel.permission_overwrites
-    allow = NONE
-    deny = NONE
-    for role_id in member.roles:
-        overwrite_role = overwrites.get(role_id)
-        if overwrite_role:
-            allow |= overwrite_role.allow
-            deny |= overwrite_role.deny
-
-    permissions &= ~deny
-    permissions |= allow
-
-    # Apply member specific overwrite if it exist.
-    overwrite_member = overwrites.get(member.user_id)
-    if overwrite_member:
-        permissions &= ~overwrite_member.deny
-        permissions |= overwrite_member.allow
-
-    return permissions
-
-def compute_permissions(member, channel):
-    base_permissions = compute_base_permissions(member, channel.guild)
-    return compute_overwrites(base_permissions, member, channel)
-```
-
-## Implicit Permissions
-
-Permissions in Discord are sometimes implicitly denied or allowed based on logical use. The two main cases are `VIEW_CHANNEL` and `SEND_MESSAGES` for text channels. Denying a user or a role `VIEW_CHANNEL` on a channel implicitly denies other permissions on the channel. Though permissions like `SEND_MESSAGES` are not explicitly denied for the user, they are ignored because the user cannot read messages in the channel.
-
-Denying `SEND_MESSAGES` implicitly denies `MENTION_EVERYONE`, `SEND_TTS_MESSAGES`, `ATTACH_FILES`, and `EMBED_LINKS`. Again, they are not explicitly denied when doing permissions calculations, but they are ignored because the user cannot do the base action of sending messages.
-
-For voice and stage channels, denying the `CONNECT` permission also implicitly denies other permissions such as `MANAGE_CHANNEL`.
-
-There may be other cases in which certain permissions implicitly deny or allow other permissions. In all cases, it is based on logical conclusions about how a user with certain permissions should or should not interact with Discord.
-
-## Inherited Permissions (Threads)
-
-Threads inherit permissions from the parent channel (the channel they were created in), with one exception: The `SEND_MESSAGES` permission is not inherited; users must have `SEND_MESSAGES_IN_THREADS` to send a message in a thread, which allows for users to participate in threads in places like announcement channels.
-
-Users must have the `VIEW_CHANNEL` permission to view _any_ threads in the channel, even if they are directly mentioned or added to the thread.
-
-## Permission Syncing
-
-Permissions with regards to categories and channels within categories are a bit tricky. Rather than inheritance, permissions are calculated by means of what we call Permission Syncing. If a child channel has the same permissions and overwrites (or lack thereof) as its parent category, the channel is considered "synced" to the category. Any further changes to a **parent category** will be reflected in its synced child channels. Any further changes to a **child channel** will cause it to become de-synced from its parent category, and its permissions will no longer change with changes to its parent category.
-
-### Role Object
-
-Roles represent a set of permissions attached to a group of users. Roles have names, colors, and can be "pinned" to the side bar, causing their members to be listed separately. Roles can have separate permission profiles for the global context (guild) and channel context. The `@everyone` role has the same ID as the guild it belongs to.
-
-###### Role Structure
-
-| Field          | Type                                                                         | Description                                       |
-| -------------- | ---------------------------------------------------------------------------- | ------------------------------------------------- |
-| id             | snowflake                                                                    | role id                                           |
-| name           | string                                                                       | role name                                         |
-| color          | integer                                                                      | integer representation of hexadecimal color code  |
-| hoist          | boolean                                                                      | if this role is pinned in the user listing        |
-| icon?          | ?string                                                                      | role [icon hash](#DOCS_REFERENCE/image-formatting)|
-| unicode_emoji? | ?string                                                                      | role unicode emoji                                |
-| position       | integer                                                                      | position of this role                             |
-| permissions    | string                                                                       | permission bit set                                |
-| managed        | boolean                                                                      | whether this role is managed by an integration    |
-| mentionable    | boolean                                                                      | whether this role is mentionable                  |
-| tags?          | [role tags](#DOCS_TOPICS_PERMISSIONS/role-object-role-tags-structure) object | the tags this role has                            |
-
-Roles without colors (`color == 0`) do not count towards the final computed color in the user list.
-
-###### Role Tags Structure
-
-| Field               | Type      | Description                                         |
-| ------------------- | --------- | --------------------------------------------------- |
-| bot_id?             | snowflake | the id of the bot this role belongs to              |
-| integration_id?     | snowflake | the id of the integration this role belongs to      |
-| premium_subscriber? | null      | whether this is the guild's premium subscriber role |
-
-###### Example Role
-
-```json
-{
-  "id": "41771983423143936",
-  "name": "WE DEM BOYZZ!!!!!!",
-  "color": 3447003,
-  "hoist": true,
-  "icon": "cf3ced8600b777c9486c6d8d84fb4327",
-  "unicode_emoji": null,
-  "position": 1,
-  "permissions": "66321471",
-  "managed": false,
-  "mentionable": false
-}
-```
-
-## Permissions For Timed Out Members
-
-Timed out members will temporarily lose all permissions except `VIEW_CHANNEL` and `READ_MESSAGE_HISTORY`. Owners and admin users with `ADMINISTRATOR` permissions are exempt.