chore(release): 0.35.0 🎉 (#503)

Build ran for fc3aa1c911

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

.github/labeler.yml

@@ -20,6 +20,8 @@ ci:
 dependencies:
   - package.json
   - package-lock.json
+  - website/package.json
+  - website/package-lock.json
 
 'topic:deno':
   - scripts/deno.mjs

.github/problemMatchers/eslint.json

@@ -0,0 +1,22 @@
+{
+	"problemMatcher": [
+		{
+			"owner": "eslint-stylish",
+			"pattern": [
+				{
+					"regexp": "^([^\\s].*)$",
+					"file": 1
+				},
+				{
+					"regexp": "^\\s+(\\d+):(\\d+)\\s+(error|warning|info)\\s+(.*)\\s\\s+(.*)$",
+					"line": 1,
+					"column": 2,
+					"severity": 3,
+					"message": 4,
+					"code": 5,
+					"loop": true
+				}
+			]
+		}
+	]
+}

.github/problemMatchers/tsc.json

@@ -0,0 +1,17 @@
+{
+	"problemMatcher": [
+		{
+			"owner": "tsc",
+			"pattern": [
+				{
+					"regexp": "^(?:\\s+\\d+\\>)?([^\\s].*)\\((\\d+|\\d+,\\d+|\\d+,\\d+,\\d+,\\d+)\\)\\s*:\\s+(error|warning|info)\\s+(\\w{1,2}\\d+)\\s*:\\s*(.*)$",
+					"file": 1,
+					"location": 2,
+					"severity": 3,
+					"code": 4,
+					"message": 5
+				}
+			]
+		}
+	]
+}

.github/workflows/cicd.yml

@@ -14,15 +14,20 @@ jobs:
       - name: Checkout Project
         uses: actions/checkout@v2
 
+      - name: Add problem matcher
+        run: echo "::add-matcher::.github/problemMatchers/eslint.json" && echo "::add-matcher::.github/problemMatchers/tsc.json"
+
       - name: Use Node.js v16
         uses: actions/setup-node@v2
         with:
           node-version: 16
+          cache: npm
+          registry-url: https://registry.npmjs.org/
 
-      - name: Install Dependencies
+      - name: Install dependencies
         run: npm ci
 
-      - name: Run ESLint
+      - name: Check lint on discord-api-types
         run: npm run test:lint
 
       - name: Run TSC

.github/workflows/create-pr-for-release-and-publish.yml

@@ -30,6 +30,9 @@ jobs:
       - name: Install dependencies
         run: npm ci --ignore-scripts
 
+      - name: Install website dependencies
+        run: pushd website && npm ci --ignore-scripts && popd
+
       - name: Set Git User and Email
         run: |
           git config user.name "github-actions[bot]"
@@ -44,13 +47,15 @@ jobs:
         run: |
           git checkout -b "chore/release/$(jq --raw-output '.version' package.json)"
 
-          # Run changelog generation and deno scripts
+          # Run changelog generation, deno script, website version bump
           npm run ci:pr
 
           # Add all changes, commit and push
           git add --all .
           git commit -m "chore(release): $(jq --raw-output '.version' package.json) 🎉" -m "Build ran for ${GITHUB_SHA}"
           git push -u origin "chore/release/$(jq --raw-output '.version' package.json)"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Create Pull Request
         run: node ./scripts/actions/create-pr.mjs

.prettierignore

@@ -1 +1,13 @@
+
+# Node modules
+node_modules/
+
+# Generated data
 deno/
+
+# Versioned json
+website/versioned_sidebars/
+website/versioned_docs/
+website/versions.json
+website/.docusaurus/
+website/build

.vscode/settings.json

@@ -5,5 +5,6 @@
 		"source.organizeImports": false,
 		"source.fixAll": true,
 		"source.fixAll.eslint": true
-	}
+	},
+	"cSpell.enableFiletypes": ["mdx"]
 }

CHANGELOG.md

@@ -1,3 +1,115 @@
+# [0.35.0](https://github.com/discordjs/discord-api-types/compare/0.34.0...0.35.0) (2022-06-23)
+
+### Code Refactoring
+
+- **GatewayIdentifyProperties:** remove `$` prefix from keys ([#493](https://github.com/discordjs/discord-api-types/issues/493)) ([3b10c60](https://github.com/discordjs/discord-api-types/commit/3b10c60faa5943501ab1f7cfa0d5f3c5317cdbbd))
+
+### Features
+
+- **APIEmbedVideo:** add missing `proxy_url` property ([#496](https://github.com/discordjs/discord-api-types/issues/496)) ([56d491f](https://github.com/discordjs/discord-api-types/commit/56d491fa6808d9a8762bff606ca8feb5e11f13a4))
+- **REST:** add `CDNRoutes` ([#502](https://github.com/discordjs/discord-api-types/issues/502)) ([0609886](https://github.com/discordjs/discord-api-types/commit/06098869d552139fadcc204b5ce4e1a7e5352b68))
+- **UserFlags:** add `Quarantined` flag ([#495](https://github.com/discordjs/discord-api-types/issues/495)) ([fc3aa1c](https://github.com/discordjs/discord-api-types/commit/fc3aa1c9110e4730c6b8ba3e36815ecd2da66c68))
+
+### BREAKING CHANGES
+
+- **GatewayIdentifyProperties:** The fields for identify no longer use the `$` prefix for the values.
+
+# [0.34.0](https://github.com/discordjs/discord-api-types/compare/0.33.5...0.34.0) (2022-06-13)
+
+### Code Refactoring
+
+- separate `MESSAGE_CREATE` fields from `APIMessage` object ([#434](https://github.com/discordjs/discord-api-types/issues/434)) ([0bb2204](https://github.com/discordjs/discord-api-types/commit/0bb2204b5ddd32b791641a33d52669bc739bc208))
+
+### Features
+
+- add guild mfa endpoint and error `50017` ([#476](https://github.com/discordjs/discord-api-types/issues/476)) ([292c6b5](https://github.com/discordjs/discord-api-types/commit/292c6b58ee9384db2ce06addb80d2ea2bcd32de2))
+- **RESTJSONErrorCodes:** add 220003 error ([#466](https://github.com/discordjs/discord-api-types/issues/466)) ([20653b3](https://github.com/discordjs/discord-api-types/commit/20653b34819f6adf8116bef2a1e5edc3233c4117))
+
+### BREAKING CHANGES
+
+- Certain fields that come only through the gateway are now correctly typed as such
+
+## [0.33.5](https://github.com/discordjs/discord-api-types/compare/0.33.4...0.33.5) (2022-06-07)
+
+### Bug Fixes
+
+- **GatewayGuildCreateDispatch:** add missing `GatewayGuildCreateDispatch` ([#477](https://github.com/discordjs/discord-api-types/issues/477)) ([d268e0b](https://github.com/discordjs/discord-api-types/commit/d268e0bff7429e1cde43174fdf6d2342569860d5))
+- **RESTPostAPIWebhookWithTokenJSONBody:** `thread_name` should be optional ([#479](https://github.com/discordjs/discord-api-types/issues/479)) ([eff8892](https://github.com/discordjs/discord-api-types/commit/eff8892b03656cfc2b709c6c30edb98e38bf2a1e))
+
+### Features
+
+- **RESTJSONErrorCodes:** add error `30052` ([#469](https://github.com/discordjs/discord-api-types/issues/469)) ([d854317](https://github.com/discordjs/discord-api-types/commit/d8543177cd978a19daa32fbb183892b6f8c24772))
+
+## [0.33.4](https://github.com/discordjs/discord-api-types/compare/0.33.3...0.33.4) (2022-06-06)
+
+### Features
+
+- **RESTPostAPIWebhookWithTokenJSONBody:** add `thread_name` ([#463](https://github.com/discordjs/discord-api-types/issues/463)) ([8e5f07e](https://github.com/discordjs/discord-api-types/commit/8e5f07e2eebc14e5777dbfb932ef54f252165524))
+
+## [0.33.3](https://github.com/discordjs/discord-api-types/compare/0.33.2...0.33.3) (2022-06-04)
+
+### Bug Fixes
+
+- **AddUndefinedToPossiblyUndefinedProperties:** recurse down objects ([#471](https://github.com/discordjs/discord-api-types/issues/471)) ([43c372d](https://github.com/discordjs/discord-api-types/commit/43c372d81722e48b105d5121a2cfdf614f1e7704))
+
+## [0.33.2](https://github.com/discordjs/discord-api-types/compare/0.33.1...0.33.2) (2022-06-01)
+
+### Bug Fixes
+
+- **docs-site:** website link colors ([#457](https://github.com/discordjs/discord-api-types/issues/457)) ([51e664d](https://github.com/discordjs/discord-api-types/commit/51e664d8e826e7f0aa467c000f3a1707fc283a36))
+- **GatewayGuildCreateDispatch:** add extra fields that were missing ([#458](https://github.com/discordjs/discord-api-types/issues/458)) ([15fcd1b](https://github.com/discordjs/discord-api-types/commit/15fcd1b2a85e8d1e136416a66326a4aadcc301fb))
+- **RestPostAPIBaseApplicationJSONBody:** make `default_member_permissions` optional ([#460](https://github.com/discordjs/discord-api-types/issues/460)) ([6a813be](https://github.com/discordjs/discord-api-types/commit/6a813be83382e1606f1921cf00179fe1ce75c04f))
+
+## [0.33.1](https://github.com/discordjs/discord-api-types/compare/0.33.0...0.33.1) (2022-05-26)
+
+### Bug Fixes
+
+- **RESTPostAPIApplicationGuildCommands:** correct types due to unions ([#447](https://github.com/discordjs/discord-api-types/issues/447)) ([6d85ad6](https://github.com/discordjs/discord-api-types/commit/6d85ad6b1d707b980f9897ea68dd4b7573b3a770))
+
+### Features
+
+- **RESTJSONErrorCodes:** add error `50600` ([#444](https://github.com/discordjs/discord-api-types/issues/444)) ([5ef49f4](https://github.com/discordjs/discord-api-types/commit/5ef49f41cecaa1d5937428a5c58f1d88bfc61266))
+- **RESTPostAPIGuildChannels:** update post body fields ([#419](https://github.com/discordjs/discord-api-types/issues/419)) ([748db34](https://github.com/discordjs/discord-api-types/commit/748db34e30338cf4a9fd8ce7b86d1d5c7dde63b1))
+
+# [0.33.0](https://github.com/discordjs/discord-api-types/compare/0.32.1...0.33.0) (2022-05-16)
+
+### Code Refactoring
+
+- **GuildFeature:** thread archive durations are no longer boost locked ([#412](https://github.com/discordjs/discord-api-types/issues/412)) ([1737ade](https://github.com/discordjs/discord-api-types/commit/1737adea1fc3d5050db30266e49c63277b7a77fc))
+- separate `GUILD_CREATE` fields from `APIGuild` object ([#423](https://github.com/discordjs/discord-api-types/issues/423)) ([17f5caa](https://github.com/discordjs/discord-api-types/commit/17f5caa671da50a79d61393f5a970ce59c5d875e))
+
+### Features
+
+- add support for application command permissions v2 ([#415](https://github.com/discordjs/discord-api-types/issues/415)) ([d3163ca](https://github.com/discordjs/discord-api-types/commit/d3163ca22e5b7d8292f9f6ccd444aa5c93771d92))
+- **OAuth2Scopes:** add new OAuth2 scopes ([#435](https://github.com/discordjs/discord-api-types/issues/435)) ([8f16f45](https://github.com/discordjs/discord-api-types/commit/8f16f452ac7dc8988617d1211fc6a9547d254795))
+- **rest:** add missing guild routes results ([#438](https://github.com/discordjs/discord-api-types/issues/438)) ([1afce87](https://github.com/discordjs/discord-api-types/commit/1afce87fbef8e43ee040010e36019a4ebc6fecfe))
+
+### BREAKING CHANGES
+
+- APIGuild now correctly shows just the properties that are obtainable through rest/GUILD_UPDATE, while the extra fields have been moved to GatewayGuildCreateDispatchData to correctly represent the data received
+- **GuildFeature:** `SevenDayThreadArchive` and `ThreeDayThreadArchive` have been removed as they are no longer valid
+
+## [0.32.1](https://github.com/discordjs/discord-api-types/compare/0.32.0...0.32.1) (2022-05-05)
+
+### Features
+
+- **RESTJSONErrorCodes:** add error `50080` ([#408](https://github.com/discordjs/discord-api-types/issues/408)) ([43cfbcb](https://github.com/discordjs/discord-api-types/commit/43cfbcba284a96de6bde101b866ad9ac306992b5))
+- **RESTPostAPIGuildForumThreads:** add `message` field ([#416](https://github.com/discordjs/discord-api-types/issues/416)) ([a28c824](https://github.com/discordjs/discord-api-types/commit/a28c824f82014b15a715b51b4426356428bb4ba2))
+
+# [0.32.0](https://github.com/discordjs/discord-api-types/compare/0.31.2...0.32.0) (2022-04-25)
+
+### Bug Fixes
+
+- add `position` property to create channel options ([#409](https://github.com/discordjs/discord-api-types/issues/409)) ([3fe53ce](https://github.com/discordjs/discord-api-types/commit/3fe53ced9f0e61473a8b92d0503c51084e6a58f3))
+
+### Code Refactoring
+
+- **APIGuildIntegration:** make `enabled` optional ([#406](https://github.com/discordjs/discord-api-types/issues/406)) ([1212eb9](https://github.com/discordjs/discord-api-types/commit/1212eb933e6bf1d82b1b41164030bd317e9c59eb))
+
+### BREAKING CHANGES
+
+- **APIGuildIntegration:** `enabled` is now properly marked as optional
+
 ## [0.31.2](https://github.com/discordjs/discord-api-types/compare/0.31.1...0.31.2) (2022-04-18)
 
 ### Features

README.md

@@ -1,11 +1,14 @@
 # Discord API Types
 
+[![discord-api-types](https://raw.githubusercontent.com/discordjs/discord-api-types/main/website/static/svgs/logo_long_blurple.svg)](https://github.com/discordjs/discord-api-types)
+
 [![GitHub](https://img.shields.io/github/license/discordjs/discord-api-types)](https://github.com/discordjs/discord-api-types/blob/main/LICENSE.md)
 [![npm](https://img.shields.io/npm/v/discord-api-types?color=crimson&logo=npm)](https://www.npmjs.com/package/discord-api-types)
 [![deno](https://img.shields.io/npm/v/discord-api-types?color=blue&label=deno&logo=deno)](https://deno.land/x/discord_api_types)
 [![Patreon Donate](https://img.shields.io/badge/patreon-donate-brightgreen.svg?label=Donate%20with%20Patreon&logo=patreon&colorB=F96854&link=https://www.patreon.com/vladfrangu)](https://www.patreon.com/vladfrangu)
 [![Ko-fi Donate](https://img.shields.io/badge/kofi-donate-brightgreen.svg?label=Donate%20with%20Ko-fi&logo=ko-fi&colorB=F16061&link=https://ko-fi.com/wolfgalvlad&logoColor=FFFFFF)](https://ko-fi.com/wolfgalvlad)
 [![GitHub Sponsors](https://img.shields.io/badge/patreon-donate-brightgreen.svg?label=Sponsor%20through%20GitHub&logo=github&colorB=F96854&link=https://github.com/sponsors/vladfrangu)](https://github.com/sponsors/vladfrangu)
+[![Powered by Vercel](https://raw.githubusercontent.com/discordjs/discord-api-types/main/website/static/powered-by-vercel.svg)](https://vercel.com?utm_source=discordjs&utm_campaign=oss)
 
 Simple type definitions for the [Discord API](https://discord.com/developers/docs/intro).
 
@@ -43,7 +46,7 @@ const { GatewayVersion } = require('discord-api-types/gateway/v10');
 import { GatewayVersion } from 'discord-api-types/gateway/v10';
 ```
 
-> _**Note:** The `v*` exports (`discord-api-type/v*`) include the appropriate version of `gateway`, `payloads`, `rest`, `rpc`, and `utils` you specified, alongside the `globals` exports_
+> _**Note:** The `v*` exports (`discord-api-types/v*`) include the appropriate version of `gateway`, `payloads`, `rest`, `rpc`, and `utils` you specified, alongside the `globals` exports_
 
 ### Deno
 
@@ -94,4 +97,9 @@ The exports of each API version is split into three main parts:
 
 - There may be types exported that are identical for all versions. These will be exported as is and can be found in the `globals` file. They will still be prefixed accordingly as described above.
 
-**Warning**: This package documents just KNOWN (and documented) properties. Anything that isn't documented will NOT be added to this package (unless said properties are in an open Pull Request to Discord's [API Documentation repository](https://github.com/discord/discord-api-docs) or known through other means _and have received the green light to be used_). For clarification's sake, this means that properties that are only known through the process of data mining and have not yet been confirmed in a way as described will **NOT** be included.
+**A note about how types are documented**: This package will add types only for known and documented properties that are present in Discord's [API Documentation repository](https://github.com/discord/discord-api-docs),
+that are mentioned in an open pull request, or known through other means _and have received the green light to be used_.
+Anything else will not be documented (for example client only types).
+
+With that aside, we may allow certain types that are not documented in the [API Documentation repository](https://github.com/discord/discord-api-docs) on a case by case basis.
+They will be documented with an `@unstable` tag and are not subject with the same versioning rules.

deno/CHANGELOG.md

@@ -1,3 +1,115 @@
+# [0.35.0](https://github.com/discordjs/discord-api-types/compare/0.34.0...0.35.0) (2022-06-23)
+
+### Code Refactoring
+
+- **GatewayIdentifyProperties:** remove `$` prefix from keys ([#493](https://github.com/discordjs/discord-api-types/issues/493)) ([3b10c60](https://github.com/discordjs/discord-api-types/commit/3b10c60faa5943501ab1f7cfa0d5f3c5317cdbbd))
+
+### Features
+
+- **APIEmbedVideo:** add missing `proxy_url` property ([#496](https://github.com/discordjs/discord-api-types/issues/496)) ([56d491f](https://github.com/discordjs/discord-api-types/commit/56d491fa6808d9a8762bff606ca8feb5e11f13a4))
+- **REST:** add `CDNRoutes` ([#502](https://github.com/discordjs/discord-api-types/issues/502)) ([0609886](https://github.com/discordjs/discord-api-types/commit/06098869d552139fadcc204b5ce4e1a7e5352b68))
+- **UserFlags:** add `Quarantined` flag ([#495](https://github.com/discordjs/discord-api-types/issues/495)) ([fc3aa1c](https://github.com/discordjs/discord-api-types/commit/fc3aa1c9110e4730c6b8ba3e36815ecd2da66c68))
+
+### BREAKING CHANGES
+
+- **GatewayIdentifyProperties:** The fields for identify no longer use the `$` prefix for the values.
+
+# [0.34.0](https://github.com/discordjs/discord-api-types/compare/0.33.5...0.34.0) (2022-06-13)
+
+### Code Refactoring
+
+- separate `MESSAGE_CREATE` fields from `APIMessage` object ([#434](https://github.com/discordjs/discord-api-types/issues/434)) ([0bb2204](https://github.com/discordjs/discord-api-types/commit/0bb2204b5ddd32b791641a33d52669bc739bc208))
+
+### Features
+
+- add guild mfa endpoint and error `50017` ([#476](https://github.com/discordjs/discord-api-types/issues/476)) ([292c6b5](https://github.com/discordjs/discord-api-types/commit/292c6b58ee9384db2ce06addb80d2ea2bcd32de2))
+- **RESTJSONErrorCodes:** add 220003 error ([#466](https://github.com/discordjs/discord-api-types/issues/466)) ([20653b3](https://github.com/discordjs/discord-api-types/commit/20653b34819f6adf8116bef2a1e5edc3233c4117))
+
+### BREAKING CHANGES
+
+- Certain fields that come only through the gateway are now correctly typed as such
+
+## [0.33.5](https://github.com/discordjs/discord-api-types/compare/0.33.4...0.33.5) (2022-06-07)
+
+### Bug Fixes
+
+- **GatewayGuildCreateDispatch:** add missing `GatewayGuildCreateDispatch` ([#477](https://github.com/discordjs/discord-api-types/issues/477)) ([d268e0b](https://github.com/discordjs/discord-api-types/commit/d268e0bff7429e1cde43174fdf6d2342569860d5))
+- **RESTPostAPIWebhookWithTokenJSONBody:** `thread_name` should be optional ([#479](https://github.com/discordjs/discord-api-types/issues/479)) ([eff8892](https://github.com/discordjs/discord-api-types/commit/eff8892b03656cfc2b709c6c30edb98e38bf2a1e))
+
+### Features
+
+- **RESTJSONErrorCodes:** add error `30052` ([#469](https://github.com/discordjs/discord-api-types/issues/469)) ([d854317](https://github.com/discordjs/discord-api-types/commit/d8543177cd978a19daa32fbb183892b6f8c24772))
+
+## [0.33.4](https://github.com/discordjs/discord-api-types/compare/0.33.3...0.33.4) (2022-06-06)
+
+### Features
+
+- **RESTPostAPIWebhookWithTokenJSONBody:** add `thread_name` ([#463](https://github.com/discordjs/discord-api-types/issues/463)) ([8e5f07e](https://github.com/discordjs/discord-api-types/commit/8e5f07e2eebc14e5777dbfb932ef54f252165524))
+
+## [0.33.3](https://github.com/discordjs/discord-api-types/compare/0.33.2...0.33.3) (2022-06-04)
+
+### Bug Fixes
+
+- **AddUndefinedToPossiblyUndefinedProperties:** recurse down objects ([#471](https://github.com/discordjs/discord-api-types/issues/471)) ([43c372d](https://github.com/discordjs/discord-api-types/commit/43c372d81722e48b105d5121a2cfdf614f1e7704))
+
+## [0.33.2](https://github.com/discordjs/discord-api-types/compare/0.33.1...0.33.2) (2022-06-01)
+
+### Bug Fixes
+
+- **docs-site:** website link colors ([#457](https://github.com/discordjs/discord-api-types/issues/457)) ([51e664d](https://github.com/discordjs/discord-api-types/commit/51e664d8e826e7f0aa467c000f3a1707fc283a36))
+- **GatewayGuildCreateDispatch:** add extra fields that were missing ([#458](https://github.com/discordjs/discord-api-types/issues/458)) ([15fcd1b](https://github.com/discordjs/discord-api-types/commit/15fcd1b2a85e8d1e136416a66326a4aadcc301fb))
+- **RestPostAPIBaseApplicationJSONBody:** make `default_member_permissions` optional ([#460](https://github.com/discordjs/discord-api-types/issues/460)) ([6a813be](https://github.com/discordjs/discord-api-types/commit/6a813be83382e1606f1921cf00179fe1ce75c04f))
+
+## [0.33.1](https://github.com/discordjs/discord-api-types/compare/0.33.0...0.33.1) (2022-05-26)
+
+### Bug Fixes
+
+- **RESTPostAPIApplicationGuildCommands:** correct types due to unions ([#447](https://github.com/discordjs/discord-api-types/issues/447)) ([6d85ad6](https://github.com/discordjs/discord-api-types/commit/6d85ad6b1d707b980f9897ea68dd4b7573b3a770))
+
+### Features
+
+- **RESTJSONErrorCodes:** add error `50600` ([#444](https://github.com/discordjs/discord-api-types/issues/444)) ([5ef49f4](https://github.com/discordjs/discord-api-types/commit/5ef49f41cecaa1d5937428a5c58f1d88bfc61266))
+- **RESTPostAPIGuildChannels:** update post body fields ([#419](https://github.com/discordjs/discord-api-types/issues/419)) ([748db34](https://github.com/discordjs/discord-api-types/commit/748db34e30338cf4a9fd8ce7b86d1d5c7dde63b1))
+
+# [0.33.0](https://github.com/discordjs/discord-api-types/compare/0.32.1...0.33.0) (2022-05-16)
+
+### Code Refactoring
+
+- **GuildFeature:** thread archive durations are no longer boost locked ([#412](https://github.com/discordjs/discord-api-types/issues/412)) ([1737ade](https://github.com/discordjs/discord-api-types/commit/1737adea1fc3d5050db30266e49c63277b7a77fc))
+- separate `GUILD_CREATE` fields from `APIGuild` object ([#423](https://github.com/discordjs/discord-api-types/issues/423)) ([17f5caa](https://github.com/discordjs/discord-api-types/commit/17f5caa671da50a79d61393f5a970ce59c5d875e))
+
+### Features
+
+- add support for application command permissions v2 ([#415](https://github.com/discordjs/discord-api-types/issues/415)) ([d3163ca](https://github.com/discordjs/discord-api-types/commit/d3163ca22e5b7d8292f9f6ccd444aa5c93771d92))
+- **OAuth2Scopes:** add new OAuth2 scopes ([#435](https://github.com/discordjs/discord-api-types/issues/435)) ([8f16f45](https://github.com/discordjs/discord-api-types/commit/8f16f452ac7dc8988617d1211fc6a9547d254795))
+- **rest:** add missing guild routes results ([#438](https://github.com/discordjs/discord-api-types/issues/438)) ([1afce87](https://github.com/discordjs/discord-api-types/commit/1afce87fbef8e43ee040010e36019a4ebc6fecfe))
+
+### BREAKING CHANGES
+
+- APIGuild now correctly shows just the properties that are obtainable through rest/GUILD_UPDATE, while the extra fields have been moved to GatewayGuildCreateDispatchData to correctly represent the data received
+- **GuildFeature:** `SevenDayThreadArchive` and `ThreeDayThreadArchive` have been removed as they are no longer valid
+
+## [0.32.1](https://github.com/discordjs/discord-api-types/compare/0.32.0...0.32.1) (2022-05-05)
+
+### Features
+
+- **RESTJSONErrorCodes:** add error `50080` ([#408](https://github.com/discordjs/discord-api-types/issues/408)) ([43cfbcb](https://github.com/discordjs/discord-api-types/commit/43cfbcba284a96de6bde101b866ad9ac306992b5))
+- **RESTPostAPIGuildForumThreads:** add `message` field ([#416](https://github.com/discordjs/discord-api-types/issues/416)) ([a28c824](https://github.com/discordjs/discord-api-types/commit/a28c824f82014b15a715b51b4426356428bb4ba2))
+
+# [0.32.0](https://github.com/discordjs/discord-api-types/compare/0.31.2...0.32.0) (2022-04-25)
+
+### Bug Fixes
+
+- add `position` property to create channel options ([#409](https://github.com/discordjs/discord-api-types/issues/409)) ([3fe53ce](https://github.com/discordjs/discord-api-types/commit/3fe53ced9f0e61473a8b92d0503c51084e6a58f3))
+
+### Code Refactoring
+
+- **APIGuildIntegration:** make `enabled` optional ([#406](https://github.com/discordjs/discord-api-types/issues/406)) ([1212eb9](https://github.com/discordjs/discord-api-types/commit/1212eb933e6bf1d82b1b41164030bd317e9c59eb))
+
+### BREAKING CHANGES
+
+- **APIGuildIntegration:** `enabled` is now properly marked as optional
+
 ## [0.31.2](https://github.com/discordjs/discord-api-types/compare/0.31.1...0.31.2) (2022-04-18)
 
 ### Features

deno/README.md

@@ -1,11 +1,14 @@
 # Discord API Types
 
+[![discord-api-types](https://raw.githubusercontent.com/discordjs/discord-api-types/main/website/static/svgs/logo_long_blurple.svg)](https://github.com/discordjs/discord-api-types)
+
 [![GitHub](https://img.shields.io/github/license/discordjs/discord-api-types)](https://github.com/discordjs/discord-api-types/blob/main/LICENSE.md)
 [![npm](https://img.shields.io/npm/v/discord-api-types?color=crimson&logo=npm)](https://www.npmjs.com/package/discord-api-types)
 [![deno](https://img.shields.io/npm/v/discord-api-types?color=blue&label=deno&logo=deno)](https://deno.land/x/discord_api_types)
 [![Patreon Donate](https://img.shields.io/badge/patreon-donate-brightgreen.svg?label=Donate%20with%20Patreon&logo=patreon&colorB=F96854&link=https://www.patreon.com/vladfrangu)](https://www.patreon.com/vladfrangu)
 [![Ko-fi Donate](https://img.shields.io/badge/kofi-donate-brightgreen.svg?label=Donate%20with%20Ko-fi&logo=ko-fi&colorB=F16061&link=https://ko-fi.com/wolfgalvlad&logoColor=FFFFFF)](https://ko-fi.com/wolfgalvlad)
 [![GitHub Sponsors](https://img.shields.io/badge/patreon-donate-brightgreen.svg?label=Sponsor%20through%20GitHub&logo=github&colorB=F96854&link=https://github.com/sponsors/vladfrangu)](https://github.com/sponsors/vladfrangu)
+[![Powered by Vercel](https://raw.githubusercontent.com/discordjs/discord-api-types/main/website/static/powered-by-vercel.svg)](https://vercel.com?utm_source=discordjs&utm_campaign=oss)
 
 Simple type definitions for the [Discord API](https://discord.com/developers/docs/intro).
 
@@ -43,7 +46,7 @@ const { GatewayVersion } = require('discord-api-types/gateway/v10');
 import { GatewayVersion } from 'discord-api-types/gateway/v10';
 ```
 
-> _**Note:** The `v*` exports (`discord-api-type/v*`) include the appropriate version of `gateway`, `payloads`, `rest`, `rpc`, and `utils` you specified, alongside the `globals` exports_
+> _**Note:** The `v*` exports (`discord-api-types/v*`) include the appropriate version of `gateway`, `payloads`, `rest`, `rpc`, and `utils` you specified, alongside the `globals` exports_
 
 ### Deno
 
@@ -94,4 +97,9 @@ The exports of each API version is split into three main parts:
 
 - There may be types exported that are identical for all versions. These will be exported as is and can be found in the `globals` file. They will still be prefixed accordingly as described above.
 
-**Warning**: This package documents just KNOWN (and documented) properties. Anything that isn't documented will NOT be added to this package (unless said properties are in an open Pull Request to Discord's [API Documentation repository](https://github.com/discord/discord-api-docs) or known through other means _and have received the green light to be used_). For clarification's sake, this means that properties that are only known through the process of data mining and have not yet been confirmed in a way as described will **NOT** be included.
+**A note about how types are documented**: This package will add types only for known and documented properties that are present in Discord's [API Documentation repository](https://github.com/discord/discord-api-docs),
+that are mentioned in an open pull request, or known through other means _and have received the green light to be used_.
+Anything else will not be documented (for example client only types).
+
+With that aside, we may allow certain types that are not documented in the [API Documentation repository](https://github.com/discord/discord-api-docs) on a case by case basis.
+They will be documented with an `@unstable` tag and are not subject with the same versioning rules.

deno/gateway/v10.ts

@@ -3,6 +3,7 @@
  */
 
 import type { Snowflake } from '../globals.ts';
+import type { GatewayPresenceUpdate } from '../payloads/v10/gateway.ts';
 import type {
 	APIApplication,
 	APIChannel,
@@ -195,6 +196,7 @@ export enum GatewayIntentBits {
  * https://discord.com/developers/docs/topics/gateway#commands-and-events-gateway-events
  */
 export enum GatewayDispatchEvents {
+	ApplicationCommandPermissionsUpdate = 'APPLICATION_COMMAND_PERMISSIONS_UPDATE',
 	ChannelCreate = 'CHANNEL_CREATE',
 	ChannelDelete = 'CHANNEL_DELETE',
 	ChannelPinsUpdate = 'CHANNEL_PINS_UPDATE',
@@ -272,6 +274,7 @@ export type GatewayDispatchPayload =
 	| GatewayChannelModifyDispatch
 	| GatewayChannelPinsUpdateDispatch
 	| GatewayGuildBanModifyDispatch
+	| GatewayGuildCreateDispatch
 	| GatewayGuildDeleteDispatch
 	| GatewayGuildEmojisUpdateDispatch
 	| GatewayGuildIntegrationsUpdateDispatch
@@ -500,15 +503,10 @@ export interface GatewayChannelPinsUpdateDispatchData {
 
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-create
- * https://discord.com/developers/docs/topics/gateway#guild-update
  */
-export type GatewayGuildModifyDispatch = DataPayload<
-	GatewayDispatchEvents.GuildCreate | GatewayDispatchEvents.GuildUpdate,
-	GatewayGuildModifyDispatchData
->;
+export type GatewayGuildModifyDispatch = DataPayload<GatewayDispatchEvents.GuildUpdate, GatewayGuildModifyDispatchData>;
 
 /**
- * https://discord.com/developers/docs/topics/gateway#guild-create
  * https://discord.com/developers/docs/topics/gateway#guild-update
  */
 export type GatewayGuildModifyDispatchData = APIGuild;
@@ -516,12 +514,88 @@ export type GatewayGuildModifyDispatchData = APIGuild;
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-create
  */
-export type GatewayGuildCreateDispatch = GatewayGuildModifyDispatch;
+export type GatewayGuildCreateDispatch = DataPayload<GatewayDispatchEvents.GuildCreate, GatewayGuildCreateDispatchData>;
 
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-create
+ * https://discord.com/developers/docs/topics/gateway#guild-create-guild-create-extra-fields
  */
-export type GatewayGuildCreateDispatchData = GatewayGuildModifyDispatchData;
+export interface GatewayGuildCreateDispatchData extends APIGuild {
+	/**
+	 * When this guild was joined at
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	joined_at: string;
+	/**
+	 * `true` if this is considered a large guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	large: boolean;
+	/**
+	 * Total number of members in this guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	member_count: number;
+	/**
+	 * States of members currently in voice channels; lacks the `guild_id` key
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/voice#voice-state-object
+	 */
+	voice_states: Omit<GatewayVoiceState, 'guild_id'>[];
+	/**
+	 * Users in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	members: APIGuildMember[];
+	/**
+	 * Channels in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/channel#channel-object
+	 */
+	channels: APIChannel[];
+	/**
+	 * Threads in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/channel#channel-object
+	 */
+	threads: APIChannel[];
+	/**
+	 * Presences of the members in the guild, will only include non-offline members if the size is greater than `large_threshold`
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway#presence-update
+	 */
+	presences: GatewayPresenceUpdate[];
+	/**
+	 * The stage instances in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-stage-instance-structure
+	 */
+	stage_instances: APIStageInstance[];
+	/**
+	 * The scheduled events in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object
+	 */
+	guild_scheduled_events: APIGuildScheduledEvent[];
+}
 
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-update
@@ -1051,7 +1125,7 @@ export type GatewayMessageCreateDispatch = DataPayload<
 /**
  * https://discord.com/developers/docs/topics/gateway#message-create
  */
-export type GatewayMessageCreateDispatchData = APIMessage;
+export type GatewayMessageCreateDispatchData = Omit<APIMessage, 'mentions'> & GatewayMessageEventExtraFields;
 
 /**
  * https://discord.com/developers/docs/topics/gateway#message-update
@@ -1064,10 +1138,43 @@ export type GatewayMessageUpdateDispatch = DataPayload<
 /**
  * https://discord.com/developers/docs/topics/gateway#message-update
  */
-export type GatewayMessageUpdateDispatchData = {
-	id: Snowflake;
-	channel_id: Snowflake;
-} & Partial<APIMessage>;
+export type GatewayMessageUpdateDispatchData = Omit<Partial<APIMessage>, 'mentions'> &
+	GatewayMessageEventExtraFields & {
+		/**
+		 * ID of the message
+		 */
+		id: Snowflake;
+		/**
+		 * ID of the channel the message was sent in
+		 */
+		channel_id: Snowflake;
+	};
+
+export interface GatewayMessageEventExtraFields {
+	/**
+	 * ID of the guild the message was sent in
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * Member properties for this message's author
+	 *
+	 * The member object exists in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
+	 * from text-based guild channels
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	member?: APIGuildMember;
+	/**
+	 * Users specifically mentioned in the message
+	 *
+	 * The `member` field is only present in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
+	 * from text-based guild channels
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	mentions: (APIUser & { member?: Omit<APIGuildMember, 'user'> })[];
+}
 
 /**
  * https://discord.com/developers/docs/topics/gateway#message-delete
@@ -1495,15 +1602,15 @@ export interface GatewayIdentifyProperties {
 	/**
 	 * Your operating system
 	 */
-	$os: string;
+	os: string;
 	/**
 	 * Your library name
 	 */
-	$browser: string;
+	browser: string;
 	/**
 	 * Your library name
 	 */
-	$device: string;
+	device: string;
 }
 
 /**

deno/gateway/v9.ts

@@ -3,6 +3,7 @@
  */
 
 import type { Snowflake } from '../globals.ts';
+import type { GatewayPresenceUpdate } from '../payloads/v9/gateway.ts';
 import type {
 	APIApplication,
 	APIChannel,
@@ -194,6 +195,7 @@ export enum GatewayIntentBits {
  * https://discord.com/developers/docs/topics/gateway#commands-and-events-gateway-events
  */
 export enum GatewayDispatchEvents {
+	ApplicationCommandPermissionsUpdate = 'APPLICATION_COMMAND_PERMISSIONS_UPDATE',
 	ChannelCreate = 'CHANNEL_CREATE',
 	ChannelDelete = 'CHANNEL_DELETE',
 	ChannelPinsUpdate = 'CHANNEL_PINS_UPDATE',
@@ -271,6 +273,7 @@ export type GatewayDispatchPayload =
 	| GatewayChannelModifyDispatch
 	| GatewayChannelPinsUpdateDispatch
 	| GatewayGuildBanModifyDispatch
+	| GatewayGuildCreateDispatch
 	| GatewayGuildDeleteDispatch
 	| GatewayGuildEmojisUpdateDispatch
 	| GatewayGuildIntegrationsUpdateDispatch
@@ -498,16 +501,11 @@ export interface GatewayChannelPinsUpdateDispatchData {
 }
 
 /**
- * https://discord.com/developers/docs/topics/gateway#guild-create
  * https://discord.com/developers/docs/topics/gateway#guild-update
  */
-export type GatewayGuildModifyDispatch = DataPayload<
-	GatewayDispatchEvents.GuildCreate | GatewayDispatchEvents.GuildUpdate,
-	GatewayGuildModifyDispatchData
->;
+export type GatewayGuildModifyDispatch = DataPayload<GatewayDispatchEvents.GuildUpdate, GatewayGuildModifyDispatchData>;
 
 /**
- * https://discord.com/developers/docs/topics/gateway#guild-create
  * https://discord.com/developers/docs/topics/gateway#guild-update
  */
 export type GatewayGuildModifyDispatchData = APIGuild;
@@ -515,12 +513,88 @@ export type GatewayGuildModifyDispatchData = APIGuild;
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-create
  */
-export type GatewayGuildCreateDispatch = GatewayGuildModifyDispatch;
+export type GatewayGuildCreateDispatch = DataPayload<GatewayDispatchEvents.GuildCreate, GatewayGuildCreateDispatchData>;
 
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-create
+ * https://discord.com/developers/docs/topics/gateway#guild-create-guild-create-extra-fields
  */
-export type GatewayGuildCreateDispatchData = GatewayGuildModifyDispatchData;
+export interface GatewayGuildCreateDispatchData extends APIGuild {
+	/**
+	 * When this guild was joined at
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	joined_at: string;
+	/**
+	 * `true` if this is considered a large guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	large: boolean;
+	/**
+	 * Total number of members in this guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	member_count: number;
+	/**
+	 * States of members currently in voice channels; lacks the `guild_id` key
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/voice#voice-state-object
+	 */
+	voice_states: Omit<GatewayVoiceState, 'guild_id'>[];
+	/**
+	 * Users in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	members: APIGuildMember[];
+	/**
+	 * Channels in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/channel#channel-object
+	 */
+	channels: APIChannel[];
+	/**
+	 * Threads in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/channel#channel-object
+	 */
+	threads: APIChannel[];
+	/**
+	 * Presences of the members in the guild, will only include non-offline members if the size is greater than `large_threshold`
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway#presence-update
+	 */
+	presences: GatewayPresenceUpdate[];
+	/**
+	 * The stage instances in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-stage-instance-structure
+	 */
+	stage_instances: APIStageInstance[];
+	/**
+	 * The scheduled events in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object
+	 */
+	guild_scheduled_events: APIGuildScheduledEvent[];
+}
 
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-update
@@ -1050,7 +1124,7 @@ export type GatewayMessageCreateDispatch = DataPayload<
 /**
  * https://discord.com/developers/docs/topics/gateway#message-create
  */
-export type GatewayMessageCreateDispatchData = APIMessage;
+export type GatewayMessageCreateDispatchData = Omit<APIMessage, 'mentions'> & GatewayMessageEventExtraFields;
 
 /**
  * https://discord.com/developers/docs/topics/gateway#message-update
@@ -1063,10 +1137,43 @@ export type GatewayMessageUpdateDispatch = DataPayload<
 /**
  * https://discord.com/developers/docs/topics/gateway#message-update
  */
-export type GatewayMessageUpdateDispatchData = {
-	id: Snowflake;
-	channel_id: Snowflake;
-} & Partial<APIMessage>;
+export type GatewayMessageUpdateDispatchData = Omit<Partial<APIMessage>, 'mentions'> &
+	GatewayMessageEventExtraFields & {
+		/**
+		 * ID of the message
+		 */
+		id: Snowflake;
+		/**
+		 * ID of the channel the message was sent in
+		 */
+		channel_id: Snowflake;
+	};
+
+export interface GatewayMessageEventExtraFields {
+	/**
+	 * ID of the guild the message was sent in
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * Member properties for this message's author
+	 *
+	 * The member object exists in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
+	 * from text-based guild channels
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	member?: APIGuildMember;
+	/**
+	 * Users specifically mentioned in the message
+	 *
+	 * The `member` field is only present in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
+	 * from text-based guild channels
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	mentions: (APIUser & { member?: Omit<APIGuildMember, 'user'> })[];
+}
 
 /**
  * https://discord.com/developers/docs/topics/gateway#message-delete
@@ -1494,15 +1601,15 @@ export interface GatewayIdentifyProperties {
 	/**
 	 * Your operating system
 	 */
-	$os: string;
+	os: string;
 	/**
 	 * Your library name
 	 */
-	$browser: string;
+	browser: string;
 	/**
 	 * Your library name
 	 */
-	$device: string;
+	device: string;
 }
 
 /**

deno/payloads/common.ts

@@ -1,4 +1,4 @@
-import type { LocaleString } from '../v10.ts';
+import type { LocaleString } from '../rest/common.ts';
 
 /**
  * https://discord.com/developers/docs/topics/permissions#permissions-bitwise-permission-flags

deno/payloads/v10/_interactions/_applicationCommands/permissions.ts

@@ -5,7 +5,7 @@ import type { Snowflake } from '../../../../globals.ts';
  */
 export interface APIGuildApplicationCommandPermissions {
 	/**
-	 * The id of the command
+	 * The id of the command or the application id if that permission applies to all commands
 	 */
 	id: Snowflake;
 	/**
@@ -27,11 +27,11 @@ export interface APIGuildApplicationCommandPermissions {
  */
 export interface APIApplicationCommandPermission {
 	/**
-	 * The id of the role or user
+	 * The id of the role, user or channel. Can also be a permission constant
 	 */
 	id: Snowflake;
 	/**
-	 * Role or user
+	 * Role, user or channel
 	 */
 	type: ApplicationCommandPermissionType;
 	/**
@@ -46,4 +46,13 @@ export interface APIApplicationCommandPermission {
 export enum ApplicationCommandPermissionType {
 	Role = 1,
 	User,
+	Channel,
 }
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-application-command-permissions-constants
+ */
+export const APIApplicationCommandPermissionsConstant = {
+	Everyone: (guildId: string | bigint): Snowflake => String(guildId),
+	AllChannels: (guildId: string | bigint): Snowflake => String(BigInt(guildId) - 1n),
+};

deno/payloads/v10/_interactions/applicationCommands.ts

@@ -70,10 +70,19 @@ export interface APIApplicationCommand {
 	 * The parameters for the `CHAT_INPUT` command, max 25
 	 */
 	options?: APIApplicationCommandOption[];
+	/**
+	 * Set of permissions represented as a bitset
+	 */
+	default_member_permissions: Permissions | null;
+	/**
+	 * Indicates whether the command is available in DMs with the app, only for globally-scoped commands. By default, commands are visible
+	 */
+	dm_permission?: boolean;
 	/**
 	 * Whether the command is enabled by default when the app is added to a guild
 	 *
 	 * If missing, this property should be assumed as `true`
+	 * @deprecated Use `dm_permission` and/or `default_member_permissions` instead
 	 */
 	default_permission?: boolean;
 	/**

deno/payloads/v10/application.ts

@@ -53,6 +53,12 @@ export interface APIApplication {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 */
 	owner?: APIUser;
+	/**
+	 * An empty string
+	 *
+	 * @deprecated This field will be removed in v11
+	 */
+	summary: string;
 	/**
 	 * The hexadecimal encoded key for verification in interactions and the GameSDK's GetTicket function
 	 *

deno/payloads/v10/auditLog.ts

@@ -16,6 +16,7 @@ import type {
 	GuildScheduledEventEntityType,
 	GuildScheduledEventStatus,
 } from './guildScheduledEvent.ts';
+import type { APIApplicationCommand } from './interactions.ts';
 import type { APIRole } from './permissions.ts';
 import type { StageInstancePrivacyLevel } from './stageInstance.ts';
 import type { StickerFormatType } from './sticker.ts';
@@ -27,6 +28,12 @@ import type { Snowflake } from '../../globals.ts';
  * https://discord.com/developers/docs/resources/audit-log#audit-log-object-audit-log-structure
  */
 export interface APIAuditLog {
+	/**
+	 * List of application commands found in the audit log
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands#application-command-object
+	 */
+	application_commands: APIApplicationCommand[];
 	/**
 	 * Webhooks found in the audit log
 	 *
@@ -171,6 +178,8 @@ export enum AuditLogEvent {
 	ThreadCreate = 110,
 	ThreadUpdate,
 	ThreadDelete,
+
+	ApplicationCommandPermissionUpdate = 121,
 }
 
 /**
@@ -517,6 +526,12 @@ export type APIAuditLogChangeKeyPermissions = AuditLogChangeData<'permissions',
  */
 export type APIAuditLogChangeKeyColor = AuditLogChangeData<'color', number>;
 
+/**
+ * Represents a change where the key is a snowflake.
+ * Currently, the only known instance of this is returned when permissions for a command were updated (<insert name of object here>)
+ */
+export type APIAuditLogChangeKeySnowflake = AuditLogChangeData<Snowflake, unknown>;
+
 /**
  * Returned when a role's hoist status is changed
  */

deno/payloads/v10/channel.ts

@@ -4,7 +4,6 @@
 
 import type { APIApplication } from './application.ts';
 import type { APIPartialEmoji } from './emoji.ts';
-import type { APIGuildMember } from './guild.ts';
 import type { APIMessageInteraction } from './interactions.ts';
 import type { APIRole } from './permissions.ts';
 import type { APISticker, APIStickerItem } from './sticker.ts';
@@ -326,10 +325,6 @@ export interface APIMessage {
 	 * ID of the channel the message was sent in
 	 */
 	channel_id: Snowflake;
-	/**
-	 * ID of the guild the message was sent in
-	 */
-	guild_id?: Snowflake;
 	/**
 	 * The author of this message (only a valid user in the case where the message is generated by a user or bot user)
 	 *
@@ -339,15 +334,6 @@ export interface APIMessage {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 */
 	author: APIUser;
-	/**
-	 * Member properties for this message's author
-	 *
-	 * The member object exists in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
-	 * from text-based guild channels
-	 *
-	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
-	 */
-	member?: APIGuildMember;
 	/**
 	 * Contents of the message
 	 */
@@ -377,7 +363,7 @@ export interface APIMessage {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
 	 */
-	mentions: (APIUser & { member?: Omit<APIGuildMember, 'user'> })[];
+	mentions: APIUser[];
 	/**
 	 * Roles specifically mentioned in this message
 	 *
@@ -770,10 +756,6 @@ export interface APIThreadList {
 	 * The members for the client user in each of the fetched threads
 	 */
 	members: APIThreadMember[];
-	/**
-	 * Whether there are potentially additional threads
-	 */
-	has_more?: boolean;
 }
 
 /**
@@ -921,6 +903,10 @@ export interface APIEmbedVideo {
 	 * Source url of video
 	 */
 	url?: string;
+	/**
+	 * A proxied url of the video
+	 */
+	proxy_url?: string;
 	/**
 	 * Height of video
 	 */

deno/payloads/v10/gateway.ts

@@ -127,6 +127,7 @@ export interface GatewayPresenceClientStatus {
 export interface GatewayActivity {
 	/**
 	 * The activity's id
+	 * @unstable
 	 */
 	id: string;
 	/**
@@ -151,8 +152,16 @@ export interface GatewayActivity {
 	 * Unix timestamps for start and/or end of the game
 	 */
 	timestamps?: GatewayActivityTimestamps;
+	/**
+	 * The Spotify song id
+	 * @unstable
+	 */
 	sync_id?: string;
-	platform?: ActivityPlatform;
+	/**
+	 * The platform this activity is being done on
+	 * @unstable You can use {@link ActivityPlatform} as a stepping stone, but this might be inaccurate
+	 */
+	platform?: string;
 	/**
 	 * Application id for the game
 	 */
@@ -171,6 +180,9 @@ export interface GatewayActivity {
 	 * See https://discord.com/developers/docs/topics/gateway#activity-object-activity-emoji
 	 */
 	emoji?: GatewayActivityEmoji;
+	/**
+	 * @unstable
+	 */
 	session_id?: string;
 	/**
 	 * Information for the current party of the player
@@ -208,10 +220,19 @@ export interface GatewayActivity {
 	buttons?: string[] | GatewayActivityButton[];
 }
 
+/**
+ * @unstable This enum is currently not documented by Discord but has known values which we will try to keep up to date.
+ * Values might be added or removed without a major version bump.
+ */
 export enum ActivityPlatform {
 	Desktop = 'desktop',
-	Samsung = 'samsung',
 	Xbox = 'xbox',
+	Samsung = 'samsung',
+	IOS = 'ios',
+	Android = 'android',
+	Embedded = 'embedded',
+	PS4 = 'ps4',
+	PS5 = 'ps5',
 }
 
 /**

deno/payloads/v10/guild.ts

@@ -2,15 +2,11 @@
  * Types extracted from https://discord.com/developers/docs/resources/guild
  */
 
-import type { APIChannel } from './channel.ts';
 import type { APIEmoji } from './emoji.ts';
-import type { GatewayPresenceUpdate, PresenceUpdateStatus } from './gateway.ts';
-import type { APIGuildScheduledEvent } from './guildScheduledEvent.ts';
+import type { PresenceUpdateStatus } from './gateway.ts';
 import type { APIRole } from './permissions.ts';
-import type { APIStageInstance } from './stageInstance.ts';
 import type { APISticker } from './sticker.ts';
 import type { APIUser } from './user.ts';
-import type { GatewayVoiceState } from './voice.ts';
 import type { Permissions, Snowflake } from '../../globals.ts';
 
 /**
@@ -196,64 +192,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * The id of the channel where Community guilds can display rules and/or guidelines
 	 */
 	rules_channel_id: Snowflake | null;
-	/**
-	 * When this guild was joined at
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	joined_at?: string;
-	/**
-	 * `true` if this is considered a large guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	large?: boolean;
-	/**
-	 * Total number of members in this guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	member_count?: number;
-	/**
-	 * States of members currently in voice channels; lacks the `guild_id` key
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/voice#voice-state-object
-	 */
-	voice_states?: Omit<GatewayVoiceState, 'guild_id'>[];
-	/**
-	 * Users in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
-	 */
-	members?: APIGuildMember[];
-	/**
-	 * Channels in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/channel#channel-object
-	 */
-	channels?: APIChannel[];
-	/**
-	 * Threads in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/channel#channel-object
-	 */
-	threads?: APIChannel[];
-	/**
-	 * Presences of the members in the guild, will only include non-offline members if the size is greater than `large_threshold`
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/topics/gateway#presence-update
-	 */
-	presences?: GatewayPresenceUpdate[];
 	/**
 	 * The maximum number of presences for the guild (`null` is always returned, apart from the largest of guilds)
 	 */
@@ -320,14 +258,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * See https://discord.com/developers/docs/resources/guild#guild-object-guild-nsfw-level
 	 */
 	nsfw_level: GuildNSFWLevel;
-	/**
-	 * The stage instances in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-stage-instance-structure
-	 */
-	stage_instances?: APIStageInstance[];
 	/**
 	 * Custom guild stickers
 	 *
@@ -338,14 +268,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * Whether the guild has the boost progress bar enabled.
 	 */
 	premium_progress_bar_enabled: boolean;
-	/**
-	 * The scheduled events in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object
-	 */
-	guild_scheduled_events?: APIGuildScheduledEvent[];
 	/**
 	 * The type of Student Hub the guild is
 	 */
@@ -536,14 +458,6 @@ export enum GuildFeature {
 	 * Guild is able to set role icons
 	 */
 	RoleIcons = 'ROLE_ICONS',
-	/**
-	 * Guild has access to the seven day archive time for threads
-	 */
-	SevenDayThreadArchive = 'SEVEN_DAY_THREAD_ARCHIVE',
-	/**
-	 * Guild has access to the three day archive time for threads
-	 */
-	ThreeDayThreadArchive = 'THREE_DAY_THREAD_ARCHIVE',
 	/**
 	 * Guild has enabled ticketed events
 	 */
@@ -715,7 +629,7 @@ export interface APIGuildIntegration {
 	/**
 	 * Is this integration enabled
 	 */
-	enabled: boolean;
+	enabled?: boolean;
 	/**
 	 * Is this integration syncing
 	 *

deno/payloads/v10/oauth2.ts

@@ -14,6 +14,10 @@ export enum OAuth2Scopes {
 	 * See https://discord.com/developers/docs/resources/user#get-user-connections
 	 */
 	Connections = 'connections',
+	/**
+	 * Allows your app to see information about the user's DMs and group DMs - requires Discord approval
+	 */
+	DMChannelsRead = 'dm_channels.read',
 	/**
 	 * Enables [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) to return an `email`
 	 *
@@ -69,6 +73,10 @@ export enum OAuth2Scopes {
 	 * This generates a webhook that is returned in the oauth token response for authorization code grants
 	 */
 	WebhookIncoming = 'webhook.incoming',
+	/**
+	 * Allows your app to connect to voice on user's behalf and see all the voice members - requires Discord approval
+	 */
+	Voice = 'voice',
 	/**
 	 * Allows your app to upload/update builds for a user's applications - requires Discord approval
 	 */
@@ -111,4 +119,10 @@ export enum OAuth2Scopes {
 	 * See https://discord.com/developers/docs/interactions/application-commands
 	 */
 	ApplicationsCommandsUpdate = 'applications.commands.update',
+	/**
+	 * Allows your app to update permissions for its commands using a Bearer token - client credentials grant only
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
+	 */
+	ApplicationCommandsPermissionsUpdate = 'applications.commands.permissions.update',
 }

deno/payloads/v10/user.ts

@@ -143,8 +143,16 @@ export enum UserFlags {
 	BotHTTPInteractions = 1 << 19,
 	/**
 	 * User has been identified as spammer
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
 	 */
 	Spammer = 1 << 20,
+	/**
+	 * User's account has been quarantined based on recent activity
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
+	 */
+	Quarantined = Math.pow(2, 44),
 }
 
 /**

deno/payloads/v8/user.ts

@@ -145,8 +145,16 @@ export enum UserFlags {
 	BotHTTPInteractions = 1 << 19,
 	/**
 	 * User has been identified as spammer
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
 	 */
 	Spammer = 1 << 20,
+	/**
+	 * User's account has been quarantined based on recent activity
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
+	 */
+	Quarantined = Math.pow(2, 44),
 }
 
 /**

deno/payloads/v9/_interactions/_applicationCommands/permissions.ts

@@ -5,7 +5,7 @@ import type { Snowflake } from '../../../../globals.ts';
  */
 export interface APIGuildApplicationCommandPermissions {
 	/**
-	 * The id of the command
+	 * The id of the command or the application id if that permission applies to all commands
 	 */
 	id: Snowflake;
 	/**
@@ -27,11 +27,11 @@ export interface APIGuildApplicationCommandPermissions {
  */
 export interface APIApplicationCommandPermission {
 	/**
-	 * The id of the role or user
+	 * The id of the role, user or channel. Can also be a permission constant
 	 */
 	id: Snowflake;
 	/**
-	 * Role or user
+	 * Role, user or channel
 	 */
 	type: ApplicationCommandPermissionType;
 	/**
@@ -46,4 +46,13 @@ export interface APIApplicationCommandPermission {
 export enum ApplicationCommandPermissionType {
 	Role = 1,
 	User,
+	Channel,
 }
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-application-command-permissions-constants
+ */
+export const APIApplicationCommandPermissionsConstant = {
+	Everyone: (guildId: string | bigint): Snowflake => String(guildId),
+	AllChannels: (guildId: string | bigint): Snowflake => String(BigInt(guildId) - 1n),
+};

deno/payloads/v9/_interactions/applicationCommands.ts

@@ -70,10 +70,19 @@ export interface APIApplicationCommand {
 	 * The parameters for the `CHAT_INPUT` command, max 25
 	 */
 	options?: APIApplicationCommandOption[];
+	/**
+	 * Set of permissions represented as a bitset
+	 */
+	default_member_permissions: Permissions | null;
+	/**
+	 * Indicates whether the command is available in DMs with the app, only for globally-scoped commands. By default, commands are visible
+	 */
+	dm_permission?: boolean;
 	/**
 	 * Whether the command is enabled by default when the app is added to a guild
 	 *
 	 * If missing, this property should be assumed as `true`
+	 * @deprecated Use `dm_permission` and/or `default_member_permissions` instead
 	 */
 	default_permission?: boolean;
 	/**

deno/payloads/v9/application.ts

@@ -53,6 +53,12 @@ export interface APIApplication {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 */
 	owner?: APIUser;
+	/**
+	 * An empty string
+	 *
+	 * @deprecated This field will be removed in v11
+	 */
+	summary: string;
 	/**
 	 * The hexadecimal encoded key for verification in interactions and the GameSDK's GetTicket function
 	 *

deno/payloads/v9/auditLog.ts

@@ -16,6 +16,7 @@ import type {
 	GuildScheduledEventEntityType,
 	GuildScheduledEventStatus,
 } from './guildScheduledEvent.ts';
+import type { APIApplicationCommand } from './interactions.ts';
 import type { APIRole } from './permissions.ts';
 import type { StageInstancePrivacyLevel } from './stageInstance.ts';
 import type { StickerFormatType } from './sticker.ts';
@@ -27,6 +28,12 @@ import type { Snowflake } from '../../globals.ts';
  * https://discord.com/developers/docs/resources/audit-log#audit-log-object-audit-log-structure
  */
 export interface APIAuditLog {
+	/**
+	 * List of application commands found in the audit log
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands#application-command-object
+	 */
+	application_commands: APIApplicationCommand[];
 	/**
 	 * Webhooks found in the audit log
 	 *
@@ -171,6 +178,8 @@ export enum AuditLogEvent {
 	ThreadCreate = 110,
 	ThreadUpdate,
 	ThreadDelete,
+
+	ApplicationCommandPermissionUpdate = 121,
 }
 
 /**
@@ -517,6 +526,12 @@ export type APIAuditLogChangeKeyPermissions = AuditLogChangeData<'permissions',
  */
 export type APIAuditLogChangeKeyColor = AuditLogChangeData<'color', number>;
 
+/**
+ * Represents a change where the key is a snowflake.
+ * Currently, the only known instance of this is returned when permissions for a command were updated (<insert name of object here>)
+ */
+export type APIAuditLogChangeKeySnowflake = AuditLogChangeData<Snowflake, unknown>;
+
 /**
  * Returned when a role's hoist status is changed
  */

deno/payloads/v9/channel.ts

@@ -4,7 +4,6 @@
 
 import type { APIApplication } from './application.ts';
 import type { APIPartialEmoji } from './emoji.ts';
-import type { APIGuildMember } from './guild.ts';
 import type { APIMessageInteraction } from './interactions.ts';
 import type { APIRole } from './permissions.ts';
 import type { APISticker, APIStickerItem } from './sticker.ts';
@@ -326,10 +325,6 @@ export interface APIMessage {
 	 * ID of the channel the message was sent in
 	 */
 	channel_id: Snowflake;
-	/**
-	 * ID of the guild the message was sent in
-	 */
-	guild_id?: Snowflake;
 	/**
 	 * The author of this message (only a valid user in the case where the message is generated by a user or bot user)
 	 *
@@ -339,15 +334,6 @@ export interface APIMessage {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 */
 	author: APIUser;
-	/**
-	 * Member properties for this message's author
-	 *
-	 * The member object exists in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
-	 * from text-based guild channels
-	 *
-	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
-	 */
-	member?: APIGuildMember;
 	/**
 	 * Contents of the message
 	 */
@@ -377,7 +363,7 @@ export interface APIMessage {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
 	 */
-	mentions: (APIUser & { member?: Omit<APIGuildMember, 'user'> })[];
+	mentions: APIUser[];
 	/**
 	 * Roles specifically mentioned in this message
 	 *
@@ -921,6 +907,10 @@ export interface APIEmbedVideo {
 	 * Source url of video
 	 */
 	url?: string;
+	/**
+	 * A proxied url of the video
+	 */
+	proxy_url?: string;
 	/**
 	 * Height of video
 	 */

deno/payloads/v9/gateway.ts

@@ -152,7 +152,10 @@ export interface GatewayActivity {
 	 */
 	timestamps?: GatewayActivityTimestamps;
 	sync_id?: string;
-	platform?: ActivityPlatform;
+	/**
+	 * {@link ActivityPlatform}
+	 */
+	platform?: string;
 	/**
 	 * Application id for the game
 	 */
@@ -208,10 +211,19 @@ export interface GatewayActivity {
 	buttons?: string[] | GatewayActivityButton[];
 }
 
+/**
+ * @unstable This enum is currently not documented by Discord but has known values which we will try to keep up to date.
+ * Values might be added or removed without a major version bump.
+ */
 export enum ActivityPlatform {
 	Desktop = 'desktop',
-	Samsung = 'samsung',
 	Xbox = 'xbox',
+	Samsung = 'samsung',
+	IOS = 'ios',
+	Android = 'android',
+	Embedded = 'embedded',
+	PS4 = 'ps4',
+	PS5 = 'ps5',
 }
 
 /**

deno/payloads/v9/guild.ts

@@ -2,15 +2,11 @@
  * Types extracted from https://discord.com/developers/docs/resources/guild
  */
 
-import type { APIChannel } from './channel.ts';
 import type { APIEmoji } from './emoji.ts';
-import type { GatewayPresenceUpdate, PresenceUpdateStatus } from './gateway.ts';
-import type { APIGuildScheduledEvent } from './guildScheduledEvent.ts';
+import type { PresenceUpdateStatus } from './gateway.ts';
 import type { APIRole } from './permissions.ts';
-import type { APIStageInstance } from './stageInstance.ts';
 import type { APISticker } from './sticker.ts';
 import type { APIUser } from './user.ts';
-import type { GatewayVoiceState } from './voice.ts';
 import type { Permissions, Snowflake } from '../../globals.ts';
 
 /**
@@ -196,64 +192,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * The id of the channel where Community guilds can display rules and/or guidelines
 	 */
 	rules_channel_id: Snowflake | null;
-	/**
-	 * When this guild was joined at
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	joined_at?: string;
-	/**
-	 * `true` if this is considered a large guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	large?: boolean;
-	/**
-	 * Total number of members in this guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	member_count?: number;
-	/**
-	 * States of members currently in voice channels; lacks the `guild_id` key
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/voice#voice-state-object
-	 */
-	voice_states?: Omit<GatewayVoiceState, 'guild_id'>[];
-	/**
-	 * Users in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
-	 */
-	members?: APIGuildMember[];
-	/**
-	 * Channels in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/channel#channel-object
-	 */
-	channels?: APIChannel[];
-	/**
-	 * Threads in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/channel#channel-object
-	 */
-	threads?: APIChannel[];
-	/**
-	 * Presences of the members in the guild, will only include non-offline members if the size is greater than `large_threshold`
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/topics/gateway#presence-update
-	 */
-	presences?: GatewayPresenceUpdate[];
 	/**
 	 * The maximum number of presences for the guild (`null` is always returned, apart from the largest of guilds)
 	 */
@@ -320,14 +258,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * See https://discord.com/developers/docs/resources/guild#guild-object-guild-nsfw-level
 	 */
 	nsfw_level: GuildNSFWLevel;
-	/**
-	 * The stage instances in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-stage-instance-structure
-	 */
-	stage_instances?: APIStageInstance[];
 	/**
 	 * Custom guild stickers
 	 *
@@ -338,14 +268,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * Whether the guild has the boost progress bar enabled.
 	 */
 	premium_progress_bar_enabled: boolean;
-	/**
-	 * The scheduled events in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object
-	 */
-	guild_scheduled_events?: APIGuildScheduledEvent[];
 	/**
 	 * The type of Student Hub the guild is
 	 */
@@ -536,14 +458,6 @@ export enum GuildFeature {
 	 * Guild is able to set role icons
 	 */
 	RoleIcons = 'ROLE_ICONS',
-	/**
-	 * Guild has access to the seven day archive time for threads
-	 */
-	SevenDayThreadArchive = 'SEVEN_DAY_THREAD_ARCHIVE',
-	/**
-	 * Guild has access to the three day archive time for threads
-	 */
-	ThreeDayThreadArchive = 'THREE_DAY_THREAD_ARCHIVE',
 	/**
 	 * Guild has enabled ticketed events
 	 */
@@ -715,7 +629,7 @@ export interface APIGuildIntegration {
 	/**
 	 * Is this integration enabled
 	 */
-	enabled: boolean;
+	enabled?: boolean;
 	/**
 	 * Is this integration syncing
 	 *

deno/payloads/v9/oauth2.ts

@@ -14,6 +14,10 @@ export enum OAuth2Scopes {
 	 * See https://discord.com/developers/docs/resources/user#get-user-connections
 	 */
 	Connections = 'connections',
+	/**
+	 * Allows your app to see information about the user's DMs and group DMs - requires Discord approval
+	 */
+	DMChannelsRead = 'dm_channels.read',
 	/**
 	 * Enables [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) to return an `email`
 	 *
@@ -69,6 +73,10 @@ export enum OAuth2Scopes {
 	 * This generates a webhook that is returned in the oauth token response for authorization code grants
 	 */
 	WebhookIncoming = 'webhook.incoming',
+	/**
+	 * Allows your app to connect to voice on user's behalf and see all the voice members - requires Discord approval
+	 */
+	Voice = 'voice',
 	/**
 	 * Allows your app to upload/update builds for a user's applications - requires Discord approval
 	 */
@@ -111,4 +119,10 @@ export enum OAuth2Scopes {
 	 * See https://discord.com/developers/docs/interactions/application-commands
 	 */
 	ApplicationsCommandsUpdate = 'applications.commands.update',
+	/**
+	 * Allows your app to update permissions for its commands using a Bearer token - client credentials grant only
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
+	 */
+	ApplicationCommandsPermissionsUpdate = 'applications.commands.permissions.update',
 }

deno/payloads/v9/user.ts

@@ -143,8 +143,16 @@ export enum UserFlags {
 	BotHTTPInteractions = 1 << 19,
 	/**
 	 * User has been identified as spammer
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
 	 */
 	Spammer = 1 << 20,
+	/**
+	 * User's account has been quarantined based on recent activity
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
+	 */
+	Quarantined = Math.pow(2, 44),
 }
 
 /**

deno/rest/common.ts

@@ -116,6 +116,8 @@ export enum RESTJSONErrorCodes {
 	MaximumNumberOfPinnedThreadsInForumHasBeenReached,
 	MaximumNumberOfTagsInForumHasBeenReached,
 
+	BitrateIsTooHighForChannelOfThisType = 30052,
+
 	Unauthorized = 40001,
 	VerifyYourAccount,
 	OpeningDirectMessagesTooFast,
@@ -148,6 +150,7 @@ export enum RESTJSONErrorCodes {
 	InvalidToken,
 	NoteWasTooLong,
 	ProvidedTooFewOrTooManyMessagesToDelete,
+	InvalidMFALevel,
 
 	MessageCanOnlyBePinnedInTheChannelItWasSentIn = 50019,
 	InviteCodeInvalidOrTaken,
@@ -179,7 +182,8 @@ export enum RESTJSONErrorCodes {
 
 	CannotDeleteChannelRequiredForCommunityGuilds = 50074,
 
-	InvalidStickerSent = 50081,
+	CannotEditStickersWithinMessage = 50080,
+	InvalidStickerSent,
 
 	InvalidActionOnArchivedThread = 50083,
 	InvalidThreadNotificationSettings,
@@ -194,6 +198,8 @@ export enum RESTJSONErrorCodes {
 
 	RequestBodyContainsInvalidJSON = 50109,
 
+	YouDoNotHavePermissionToSendThisSticker = 50600,
+
 	TwoFactorAuthenticationIsRequired = 60003,
 
 	NoUsersWithDiscordTagExist = 80004,
@@ -222,6 +228,8 @@ export enum RESTJSONErrorCodes {
 	CannotUpdateAFinishedEvent = 180000,
 
 	FailedToCreateStageNeededForStageEvent = 180002,
+
+	WebhooksCanOnlyCreateThreadsInForumChannels = 220003,
 }
 
 /**

deno/rest/v10/channel.ts

@@ -64,7 +64,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	/**
 	 * Whether the channel is nsfw
 	 *
-	 * Channel types: text, news
+	 * Channel types: text, voice, news
 	 */
 	nsfw?: boolean | null;
 	/**
@@ -96,7 +96,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	/**
 	 * ID of the new parent category for a channel
 	 *
-	 * Channel types: text, news, voice
+	 * Channel types: text, voice, news
 	 */
 	parent_id?: Snowflake | null;
 	/**
@@ -584,13 +584,22 @@ export type RESTPostAPIChannelMessagesThreadsJSONBody = AddUndefinedToPossiblyUn
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-in-forum-channel
  */
-export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThreadsJSONBody &
-	RESTPostAPIChannelMessageJSONBody;
+export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThreadsJSONBody & {
+	/**
+	 * First message in the forum thread
+	 */
+	message: RESTPostAPIChannelMessageJSONBody;
+};
 
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-in-forum-channel
  */
-export type RESTPostAPIGuildForumThreadsFormDataBody = RESTPostAPIChannelMessageFormDataBody;
+export type RESTPostAPIGuildForumThreadsFormDataBody = RESTPostAPIChannelMessagesThreadsJSONBody & {
+	/**
+	 * First message in the forum thread
+	 */
+	message: string;
+};
 
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-from-message

deno/rest/v10/guild.ts

@@ -20,6 +20,7 @@ import type {
 	GuildDefaultMessageNotifications,
 	GuildExplicitContentFilter,
 	GuildFeature,
+	GuildMFALevel,
 	GuildSystemChannelFlags,
 	GuildVerificationLevel,
 	GuildWidgetStyle,
@@ -41,7 +42,17 @@ export type APIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGr
 export type APIGuildCreatePartialChannel = StrictPartial<
 	DistributivePick<
 		APIGuildChannelResolvable,
-		'type' | 'topic' | 'nsfw' | 'bitrate' | 'user_limit' | 'rate_limit_per_user' | 'default_auto_archive_duration'
+		| 'type'
+		| 'topic'
+		| 'nsfw'
+		| 'bitrate'
+		| 'user_limit'
+		| 'rate_limit_per_user'
+		| 'default_auto_archive_duration'
+		| 'position'
+		| 'rtc_region'
+		| 'video_quality_mode'
+		| 'flags'
 	>
 > &
 	AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
@@ -148,6 +159,23 @@ export type RESTPostAPIGuildsJSONBody = AddUndefinedToPossiblyUndefinedPropertie
  */
 export type RESTPostAPIGuildsResult = APIGuild;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level
+ */
+export interface RESTPostAPIGuildsMFAJSONBody {
+	/**
+	 * MFA level
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-object-mfa-level
+	 */
+	level: GuildMFALevel;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level
+ */
+export type RESTPostAPIGuildsMFAResult = RESTPostAPIGuildsMFAJSONBody;
+
 /**
  * https://discord.com/developers/docs/resources/guild#get-guild
  */
@@ -331,7 +359,7 @@ export type RESTPatchAPIGuildChannelPositionsResult = never;
 /**
  * https://discord.com/developers/docs/resources/guild#list-active-threads
  */
-export type RESTGetAPIGuildThreadsResult = Omit<APIThreadList, 'has_more'>;
+export type RESTGetAPIGuildThreadsResult = APIThreadList;
 
 /**
  * https://discord.com/developers/docs/resources/guild#get-guild-member
@@ -820,6 +848,9 @@ export type RESTPatchAPIGuildMemberVerificationJSONBody = AddUndefinedToPossibly
 
 export type RESTPatchAPIGuildMemberVerificationResult = APIGuildMembershipScreening;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-current-user-voice-state
+ */
 export type RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
 	/**
 	 * The id of the channel the user is currently in
@@ -835,6 +866,14 @@ export type RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody = AddUndefinedToPos
 	request_to_speak_timestamp?: string | null;
 }>;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-current-user-voice-state
+ */
+export type RESTPatchAPIGuildVoiceStateCurrentMemberResult = never;
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-user-voice-state
+ */
 export type RESTPatchAPIGuildVoiceStateUserJSONBody = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
 	/**
 	 * The id of the channel the user is currently in
@@ -861,3 +900,8 @@ export type RESTPatchAPIGuildWelcomeScreenJSONBody = Nullable<StrictPartial<APIG
 		 */
 		enabled?: boolean | null;
 	}>;
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-welcome-screen
+ */
+export type RESTPatchAPIGuildWelcomeScreenResult = APIGuildWelcomeScreen;

deno/rest/v10/interactions.ts

@@ -37,7 +37,9 @@ type RESTPostAPIBaseApplicationCommandsJSONBody = AddUndefinedToPossiblyUndefine
 		| 'guild_id'
 		| 'name_localized'
 		| 'description_localized'
-	>
+		| 'default_member_permissions'
+	> &
+		Partial<Pick<APIApplicationCommand, 'default_member_permissions'>>
 >;
 
 /**
@@ -91,42 +93,50 @@ export type RESTPutAPIApplicationCommandsResult = APIApplicationCommand[];
 /**
  * https://discord.com/developers/docs/interactions/application-commands#get-guild-application-commands
  */
-export type RESTGetAPIApplicationGuildCommandsResult = APIApplicationCommand[];
+export type RESTGetAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>[];
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#get-guild-application-commands
  */
-export type RESTGetAPIApplicationGuildCommandResult = APIApplicationCommand;
+export type RESTGetAPIApplicationGuildCommandResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#create-guild-application-command
  */
-export type RESTPostAPIApplicationGuildCommandsJSONBody = RESTPostAPIApplicationCommandsJSONBody;
+export type RESTPostAPIApplicationGuildCommandsJSONBody =
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#create-guild-application-command
  */
-export type RESTPostAPIApplicationGuildCommandsResult = APIApplicationCommand;
+export type RESTPostAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command
  */
-export type RESTPatchAPIApplicationGuildCommandJSONBody = StrictPartial<RESTPostAPIApplicationCommandsJSONBody>;
+export type RESTPatchAPIApplicationGuildCommandJSONBody = StrictPartial<
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>
+>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command
  */
-export type RESTPatchAPIApplicationGuildCommandResult = APIApplicationCommand;
+export type RESTPatchAPIApplicationGuildCommandResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-guild-application-commands
  */
-export type RESTPutAPIApplicationGuildCommandsJSONBody = RESTPostAPIApplicationCommandsJSONBody[];
+export type RESTPutAPIApplicationGuildCommandsJSONBody = (
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>
+)[];
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-guild-application-commands
  */
-export type RESTPutAPIApplicationGuildCommandsResult = APIApplicationCommand[];
+export type RESTPutAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>[];
 
 /**
  * https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response

deno/rest/v10/mod.ts

@@ -274,6 +274,14 @@ export const Routes = {
 		return `/guilds/${guildId}/members/${memberId}/roles/${roleId}` as const;
 	},
 
+	/**
+	 * Route for:
+	 * - POST `/guilds/{guild.id}/mfa`
+	 */
+	guildMFA(guildId: Snowflake) {
+		return `/guilds/${guildId}/mfa` as const;
+	},
+
 	/**
 	 * Route for:
 	 * - GET `/guilds/{guild.id}/bans`
@@ -836,6 +844,262 @@ export const Routes = {
 	},
 };
 
+export const StickerPackApplicationId = '710982414301790216';
+
+export const CDNRoutes = {
+	/**
+	 * Route for:
+	 * - GET `/emojis/{emoji.id}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	emoji(emojiId: Snowflake, format: EmojiFormat) {
+		return `/emojis/${emojiId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/{guild.id}/icons/{guild.id}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildIcon(guildId: Snowflake, guildIcon: string, format: GuildIconFormat) {
+		return `icons/${guildId}/${guildIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/splashes/{guild.id}/{guild.splash}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildSplash(guildId: Snowflake, guildSplash: string, format: GuildSplashFormat) {
+		return `/splashes/${guildId}/${guildSplash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/discovery-splashes/{guild.id}/{guild.discovery_splash}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildDiscoverySplash(guildId: Snowflake, guildDiscoverySplash: string, format: GuildDiscoverySplashFormat) {
+		return `/discovery-splashes/${guildId}/${guildDiscoverySplash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/banners/{guild.id}/{guild.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildBanner(guildId: Snowflake, guildBanner: string, format: GuildBannerFormat) {
+		return `/banners/${guildId}/${guildBanner}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/banners/{user.id}/{user.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	userBanner(userId: Snowflake, userBanner: string, format: UserBannerFormat) {
+		return `/banners/${userId}/${userBanner}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/embed/avatars/{user.discriminator % 5}.png`
+	 *
+	 * The `userDiscriminator` parameter should be the user discriminator modulo 5 (e.g. 1337 % 5 = 2)
+	 *
+	 * This route supports the extension: PNG
+	 */
+	defaultUserAvatar(userDiscriminator: DefaultUserAvatarAssets) {
+		return `/embed/avatars/${userDiscriminator}.png` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/avatars/{user.id}/{user.avatar}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	userAvatar(userId: Snowflake, userAvatar: string, format: UserAvatarFormat) {
+		return `/avatars/${userId}/${userAvatar}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/{guild.id}/users/{user.id}/{guild_member.avatar}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildMemberAvatar(guildId: Snowflake, userId: Snowflake, memberAvatar: string, format: GuildMemberAvatarFormat) {
+		return `/guilds/${guildId}/users/${userId}/avatars/${memberAvatar}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationIcon(applicationId: Snowflake, applicationIcon: string, format: ApplicationIconFormat) {
+		return `/app-icons/${applicationId}/${applicationIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.cover_image}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationCover(applicationId: Snowflake, applicationCoverImage: string, format: ApplicationCoverFormat) {
+		return `/app-icons/${applicationId}/${applicationCoverImage}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.asset_id}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationAsset(applicationId: Snowflake, applicationAssetId: string, format: ApplicationAssetFormat) {
+		return `/app-icons/${applicationId}/${applicationAssetId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-assets/{application.id}/achievements/{achievement.id}/icons/{achievement.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	achievementIcon(
+		applicationId: Snowflake,
+		achievementId: Snowflake,
+		achievementIconHash: string,
+		format: AchievementIconFormat,
+	) {
+		return `/app-assets/${applicationId}/achievements/${achievementId}/icons/${achievementIconHash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-assets/710982414301790216/store/{sticker_pack.banner.asset_id}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	stickerPackBanner(stickerPackBannerAssetId: Snowflake, format: StickerPackBannerFormat) {
+		return `/app-assets/${StickerPackApplicationId}/store/${stickerPackBannerAssetId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `team-icons/{team.id}/{team.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	teamIcon(teamId: Snowflake, teamIcon: string, format: TeamIconFormat) {
+		return `/team-icons/${teamId}/${teamIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/stickers/{sticker.id}.{png|json}`
+	 *
+	 * This route supports the extensions: PNG, Lottie
+	 */
+	sticker(stickerId: Snowflake, format: StickerFormat) {
+		return `/stickers/${stickerId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/role-icons/{role.id}/{role.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	roleIcon(roleId: Snowflake, roleIcon: string, format: RoleIconFormat) {
+		return `/role-icons/${roleId}/${roleIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guild-events/{guild_scheduled_event.id}/{guild_scheduled_event.image}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildScheduledEventCover(
+		guildScheduledEventId: Snowflake,
+		guildScheduledEventCoverImage: string,
+		format: GuildScheduledEventCoverFormat,
+	) {
+		return `/guild-events/${guildScheduledEventId}/${guildScheduledEventCoverImage}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/${guild.id}/users/${user.id}/banners/${guild_member.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildMemberBanner(guildId: Snowflake, userId: Snowflake, guildMemberBanner: string, format: GuildMemberBannerFormat) {
+		return `/guilds/${guildId}/users/${userId}/banners/${guildMemberBanner}.${format}` as const;
+	},
+};
+
+export type DefaultUserAvatarAssets = 0 | 1 | 2 | 3 | 4 | 5;
+
+export type EmojiFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildIconFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildSplashFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildDiscoverySplashFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type UserBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type DefaultUserAvatar = Extract<ImageFormat, ImageFormat.PNG>;
+export type UserAvatarFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildMemberAvatarFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type ApplicationIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type ApplicationCoverFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type ApplicationAssetFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type AchievementIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type StickerPackBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type TeamIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type StickerFormat = Extract<ImageFormat, ImageFormat.PNG | ImageFormat.Lottie>;
+export type RoleIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildScheduledEventCoverFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildMemberBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+
+export enum ImageFormat {
+	JPEG = 'jpeg',
+	PNG = 'png',
+	WebP = 'webp',
+	GIF = 'gif',
+	Lottie = 'json',
+}
+
+export interface CDNQuery {
+	/**
+	 * The returned image can have the size changed by using this query parameter
+	 *
+	 * Image size can be any power of two between 16 and 4096
+	 */
+	size?: number;
+}
+
 export const RouteBases = {
 	api: `https://discord.com/api/v${APIVersion}`,
 	cdn: 'https://cdn.discordapp.com',

deno/rest/v10/webhook.ts

@@ -144,6 +144,12 @@ export type RESTPostAPIWebhookWithTokenJSONBody = AddUndefinedToPossiblyUndefine
 	 * Message flags combined as a bitfield
 	 */
 	flags?: MessageFlags;
+	/**
+	 * Name of thread to create
+	 *
+	 * Available only if the webhook is in a forum channel and a thread is not specified in {@link RESTPostAPIWebhookWithTokenQuery.thread_id} query parameter
+	 */
+	thread_name?: string;
 }>;
 
 /**
@@ -171,6 +177,8 @@ export interface RESTPostAPIWebhookWithTokenQuery {
 	wait?: boolean;
 	/**
 	 * Send a message to the specified thread within a webhook's channel. The thread will automatically be unarchived.
+	 *
+	 * Available only if the {@link RESTPostAPIWebhookWithTokenJSONBody.thread_name} JSON body property is not specified
 	 */
 	thread_id?: Snowflake;
 }

deno/rest/v9/channel.ts

@@ -64,7 +64,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	/**
 	 * Whether the channel is nsfw
 	 *
-	 * Channel types: text, news
+	 * Channel types: text, voice, news
 	 */
 	nsfw?: boolean | null;
 	/**
@@ -96,7 +96,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	/**
 	 * ID of the new parent category for a channel
 	 *
-	 * Channel types: text, news, voice
+	 * Channel types: text, voice, news
 	 */
 	parent_id?: Snowflake | null;
 	/**
@@ -598,13 +598,22 @@ export type RESTPostAPIChannelMessagesThreadsJSONBody = AddUndefinedToPossiblyUn
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-in-forum-channel
  */
-export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThreadsJSONBody &
-	RESTPostAPIChannelMessageJSONBody;
+export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThreadsJSONBody & {
+	/**
+	 * First message in the forum thread
+	 */
+	message: RESTPostAPIChannelMessageJSONBody;
+};
 
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-in-forum-channel
  */
-export type RESTPostAPIGuildForumThreadsFormDataBody = RESTPostAPIChannelMessageFormDataBody;
+export type RESTPostAPIGuildForumThreadsFormDataBody = RESTPostAPIChannelMessagesThreadsJSONBody & {
+	/**
+	 * First message in the forum thread
+	 */
+	message: string;
+};
 
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-from-message

deno/rest/v9/guild.ts

@@ -18,6 +18,7 @@ import type {
 	GuildDefaultMessageNotifications,
 	GuildExplicitContentFilter,
 	GuildFeature,
+	GuildMFALevel,
 	GuildSystemChannelFlags,
 	GuildVerificationLevel,
 	GuildWidgetStyle,
@@ -41,7 +42,17 @@ export type APIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGr
 export type APIGuildCreatePartialChannel = StrictPartial<
 	DistributivePick<
 		APIGuildChannelResolvable,
-		'type' | 'topic' | 'nsfw' | 'bitrate' | 'user_limit' | 'rate_limit_per_user' | 'default_auto_archive_duration'
+		| 'type'
+		| 'topic'
+		| 'nsfw'
+		| 'bitrate'
+		| 'user_limit'
+		| 'rate_limit_per_user'
+		| 'default_auto_archive_duration'
+		| 'position'
+		| 'rtc_region'
+		| 'video_quality_mode'
+		| 'flags'
 	>
 > &
 	AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
@@ -148,6 +159,23 @@ export type RESTPostAPIGuildsJSONBody = AddUndefinedToPossiblyUndefinedPropertie
  */
 export type RESTPostAPIGuildsResult = APIGuild;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level
+ */
+export interface RESTPostAPIGuildsMFAJSONBody {
+	/**
+	 * MFA level
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-object-mfa-level
+	 */
+	level: GuildMFALevel;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level
+ */
+export type RESTPostAPIGuildsMFAResult = RESTPostAPIGuildsMFAJSONBody;
+
 /**
  * https://discord.com/developers/docs/resources/guild#get-guild
  */
@@ -826,6 +854,9 @@ export type RESTPatchAPIGuildMemberVerificationJSONBody = AddUndefinedToPossibly
 
 export type RESTPatchAPIGuildMemberVerificationResult = APIGuildMembershipScreening;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-current-user-voice-state
+ */
 export type RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
 	/**
 	 * The id of the channel the user is currently in
@@ -841,6 +872,14 @@ export type RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody = AddUndefinedToPos
 	request_to_speak_timestamp?: string | null;
 }>;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-current-user-voice-state
+ */
+export type RESTPatchAPIGuildVoiceStateCurrentMemberResult = never;
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-user-voice-state
+ */
 export type RESTPatchAPIGuildVoiceStateUserJSONBody = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
 	/**
 	 * The id of the channel the user is currently in
@@ -867,3 +906,8 @@ export type RESTPatchAPIGuildWelcomeScreenJSONBody = Nullable<StrictPartial<APIG
 		 */
 		enabled?: boolean | null;
 	}>;
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-welcome-screen
+ */
+export type RESTPatchAPIGuildWelcomeScreenResult = APIGuildWelcomeScreen;

deno/rest/v9/interactions.ts

@@ -37,7 +37,9 @@ type RESTPostAPIBaseApplicationCommandsJSONBody = AddUndefinedToPossiblyUndefine
 		| 'guild_id'
 		| 'name_localized'
 		| 'description_localized'
-	>
+		| 'default_member_permissions'
+	> &
+		Partial<Pick<APIApplicationCommand, 'default_member_permissions'>>
 >;
 
 /**
@@ -91,42 +93,50 @@ export type RESTPutAPIApplicationCommandsResult = APIApplicationCommand[];
 /**
  * https://discord.com/developers/docs/interactions/application-commands#get-guild-application-commands
  */
-export type RESTGetAPIApplicationGuildCommandsResult = APIApplicationCommand[];
+export type RESTGetAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>[];
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#get-guild-application-commands
  */
-export type RESTGetAPIApplicationGuildCommandResult = APIApplicationCommand;
+export type RESTGetAPIApplicationGuildCommandResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#create-guild-application-command
  */
-export type RESTPostAPIApplicationGuildCommandsJSONBody = RESTPostAPIApplicationCommandsJSONBody;
+export type RESTPostAPIApplicationGuildCommandsJSONBody =
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#create-guild-application-command
  */
-export type RESTPostAPIApplicationGuildCommandsResult = APIApplicationCommand;
+export type RESTPostAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command
  */
-export type RESTPatchAPIApplicationGuildCommandJSONBody = StrictPartial<RESTPostAPIApplicationCommandsJSONBody>;
+export type RESTPatchAPIApplicationGuildCommandJSONBody = StrictPartial<
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>
+>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command
  */
-export type RESTPatchAPIApplicationGuildCommandResult = APIApplicationCommand;
+export type RESTPatchAPIApplicationGuildCommandResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-guild-application-commands
  */
-export type RESTPutAPIApplicationGuildCommandsJSONBody = RESTPostAPIApplicationCommandsJSONBody[];
+export type RESTPutAPIApplicationGuildCommandsJSONBody = (
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>
+)[];
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-guild-application-commands
  */
-export type RESTPutAPIApplicationGuildCommandsResult = APIApplicationCommand[];
+export type RESTPutAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>[];
 
 /**
  * https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response

deno/rest/v9/mod.ts

@@ -274,6 +274,14 @@ export const Routes = {
 		return `/guilds/${guildId}/members/${memberId}/roles/${roleId}` as const;
 	},
 
+	/**
+	 * Route for:
+	 * - POST `/guilds/{guild.id}/mfa`
+	 */
+	guildMFA(guildId: Snowflake) {
+		return `/guilds/${guildId}/mfa` as const;
+	},
+
 	/**
 	 * Route for:
 	 * - GET `/guilds/{guild.id}/bans`
@@ -845,6 +853,262 @@ export const Routes = {
 	},
 };
 
+export const StickerPackApplicationId = '710982414301790216';
+
+export const CDNRoutes = {
+	/**
+	 * Route for:
+	 * - GET `/emojis/{emoji.id}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	emoji(emojiId: Snowflake, format: EmojiFormat) {
+		return `/emojis/${emojiId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/{guild.id}/icons/{guild.id}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildIcon(guildId: Snowflake, guildIcon: string, format: GuildIconFormat) {
+		return `icons/${guildId}/${guildIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/splashes/{guild.id}/{guild.splash}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildSplash(guildId: Snowflake, guildSplash: string, format: GuildSplashFormat) {
+		return `/splashes/${guildId}/${guildSplash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/discovery-splashes/{guild.id}/{guild.discovery_splash}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildDiscoverySplash(guildId: Snowflake, guildDiscoverySplash: string, format: GuildDiscoverySplashFormat) {
+		return `/discovery-splashes/${guildId}/${guildDiscoverySplash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/banners/{guild.id}/{guild.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildBanner(guildId: Snowflake, guildBanner: string, format: GuildBannerFormat) {
+		return `/banners/${guildId}/${guildBanner}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/banners/{user.id}/{user.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	userBanner(userId: Snowflake, userBanner: string, format: UserBannerFormat) {
+		return `/banners/${userId}/${userBanner}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/embed/avatars/{user.discriminator % 5}.png`
+	 *
+	 * The `userDiscriminator` parameter should be the user discriminator modulo 5 (e.g. 1337 % 5 = 2)
+	 *
+	 * This route supports the extension: PNG
+	 */
+	defaultUserAvatar(userDiscriminator: DefaultUserAvatarAssets) {
+		return `/embed/avatars/${userDiscriminator}.png` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/avatars/{user.id}/{user.avatar}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	userAvatar(userId: Snowflake, userAvatar: string, format: UserAvatarFormat) {
+		return `/avatars/${userId}/${userAvatar}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/{guild.id}/users/{user.id}/{guild_member.avatar}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildMemberAvatar(guildId: Snowflake, userId: Snowflake, memberAvatar: string, format: GuildMemberAvatarFormat) {
+		return `/guilds/${guildId}/users/${userId}/avatars/${memberAvatar}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationIcon(applicationId: Snowflake, applicationIcon: string, format: ApplicationIconFormat) {
+		return `/app-icons/${applicationId}/${applicationIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.cover_image}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationCover(applicationId: Snowflake, applicationCoverImage: string, format: ApplicationCoverFormat) {
+		return `/app-icons/${applicationId}/${applicationCoverImage}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.asset_id}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationAsset(applicationId: Snowflake, applicationAssetId: string, format: ApplicationAssetFormat) {
+		return `/app-icons/${applicationId}/${applicationAssetId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-assets/{application.id}/achievements/{achievement.id}/icons/{achievement.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	achievementIcon(
+		applicationId: Snowflake,
+		achievementId: Snowflake,
+		achievementIconHash: string,
+		format: AchievementIconFormat,
+	) {
+		return `/app-assets/${applicationId}/achievements/${achievementId}/icons/${achievementIconHash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-assets/710982414301790216/store/{sticker_pack.banner.asset_id}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	stickerPackBanner(stickerPackBannerAssetId: Snowflake, format: StickerPackBannerFormat) {
+		return `/app-assets/${StickerPackApplicationId}/store/${stickerPackBannerAssetId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `team-icons/{team.id}/{team.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	teamIcon(teamId: Snowflake, teamIcon: string, format: TeamIconFormat) {
+		return `/team-icons/${teamId}/${teamIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/stickers/{sticker.id}.{png|json}`
+	 *
+	 * This route supports the extensions: PNG, Lottie
+	 */
+	sticker(stickerId: Snowflake, format: StickerFormat) {
+		return `/stickers/${stickerId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/role-icons/{role.id}/{role.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	roleIcon(roleId: Snowflake, roleIcon: string, format: RoleIconFormat) {
+		return `/role-icons/${roleId}/${roleIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guild-events/{guild_scheduled_event.id}/{guild_scheduled_event.image}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildScheduledEventCover(
+		guildScheduledEventId: Snowflake,
+		guildScheduledEventCoverImage: string,
+		format: GuildScheduledEventCoverFormat,
+	) {
+		return `/guild-events/${guildScheduledEventId}/${guildScheduledEventCoverImage}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/${guild.id}/users/${user.id}/banners/${guild_member.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildMemberBanner(guildId: Snowflake, userId: Snowflake, guildMemberBanner: string, format: GuildMemberBannerFormat) {
+		return `/guilds/${guildId}/users/${userId}/banners/${guildMemberBanner}.${format}` as const;
+	},
+};
+
+export type DefaultUserAvatarAssets = 0 | 1 | 2 | 3 | 4 | 5;
+
+export type EmojiFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildIconFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildSplashFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildDiscoverySplashFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type UserBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type DefaultUserAvatar = Extract<ImageFormat, ImageFormat.PNG>;
+export type UserAvatarFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildMemberAvatarFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type ApplicationIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type ApplicationCoverFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type ApplicationAssetFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type AchievementIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type StickerPackBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type TeamIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type StickerFormat = Extract<ImageFormat, ImageFormat.PNG | ImageFormat.Lottie>;
+export type RoleIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildScheduledEventCoverFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildMemberBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+
+export enum ImageFormat {
+	JPEG = 'jpeg',
+	PNG = 'png',
+	WebP = 'webp',
+	GIF = 'gif',
+	Lottie = 'json',
+}
+
+export interface CDNQuery {
+	/**
+	 * The returned image can have the size changed by using this query parameter
+	 *
+	 * Image size can be any power of two between 16 and 4096
+	 */
+	size?: number;
+}
+
 export const RouteBases = {
 	api: `https://discord.com/api/v${APIVersion}`,
 	cdn: 'https://cdn.discordapp.com',

deno/rest/v9/webhook.ts

@@ -144,6 +144,12 @@ export type RESTPostAPIWebhookWithTokenJSONBody = AddUndefinedToPossiblyUndefine
 	 * Message flags combined as a bitfield
 	 */
 	flags?: MessageFlags;
+	/**
+	 * Name of thread to create
+	 *
+	 * Available only if the webhook is in a forum channel and a thread is not specified in {@link RESTPostAPIWebhookWithTokenQuery.thread_id} query parameter
+	 */
+	thread_name?: string;
 }>;
 
 /**
@@ -171,6 +177,8 @@ export interface RESTPostAPIWebhookWithTokenQuery {
 	wait?: boolean;
 	/**
 	 * Send a message to the specified thread within a webhook's channel. The thread will automatically be unarchived.
+	 *
+	 * Available only if the {@link RESTPostAPIWebhookWithTokenJSONBody.thread_name} JSON body property is not specified
 	 */
 	thread_id?: Snowflake;
 }

deno/utils/internals.ts

@@ -7,7 +7,9 @@ export type Nullable<T> = {
  * (since JSON.stringify ignores undefined properties)
  */
 export type AddUndefinedToPossiblyUndefinedPropertiesOfInterface<Base> = {
-	[K in keyof Base]: Base[K] extends Exclude<Base[K], undefined> ? Base[K] : Base[K] | undefined;
+	[K in keyof Base]: Base[K] extends Exclude<Base[K], undefined>
+		? AddUndefinedToPossiblyUndefinedPropertiesOfInterface<Base[K]>
+		: AddUndefinedToPossiblyUndefinedPropertiesOfInterface<Base[K]> | undefined;
 };
 
 export type StrictPartial<Base> = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<Partial<Base>>;

gateway/v10.ts

@@ -3,6 +3,7 @@
  */
 
 import type { Snowflake } from '../globals';
+import type { GatewayPresenceUpdate } from '../payloads/v10/gateway';
 import type {
 	APIApplication,
 	APIChannel,
@@ -195,6 +196,7 @@ export enum GatewayIntentBits {
  * https://discord.com/developers/docs/topics/gateway#commands-and-events-gateway-events
  */
 export enum GatewayDispatchEvents {
+	ApplicationCommandPermissionsUpdate = 'APPLICATION_COMMAND_PERMISSIONS_UPDATE',
 	ChannelCreate = 'CHANNEL_CREATE',
 	ChannelDelete = 'CHANNEL_DELETE',
 	ChannelPinsUpdate = 'CHANNEL_PINS_UPDATE',
@@ -272,6 +274,7 @@ export type GatewayDispatchPayload =
 	| GatewayChannelModifyDispatch
 	| GatewayChannelPinsUpdateDispatch
 	| GatewayGuildBanModifyDispatch
+	| GatewayGuildCreateDispatch
 	| GatewayGuildDeleteDispatch
 	| GatewayGuildEmojisUpdateDispatch
 	| GatewayGuildIntegrationsUpdateDispatch
@@ -500,15 +503,10 @@ export interface GatewayChannelPinsUpdateDispatchData {
 
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-create
- * https://discord.com/developers/docs/topics/gateway#guild-update
  */
-export type GatewayGuildModifyDispatch = DataPayload<
-	GatewayDispatchEvents.GuildCreate | GatewayDispatchEvents.GuildUpdate,
-	GatewayGuildModifyDispatchData
->;
+export type GatewayGuildModifyDispatch = DataPayload<GatewayDispatchEvents.GuildUpdate, GatewayGuildModifyDispatchData>;
 
 /**
- * https://discord.com/developers/docs/topics/gateway#guild-create
  * https://discord.com/developers/docs/topics/gateway#guild-update
  */
 export type GatewayGuildModifyDispatchData = APIGuild;
@@ -516,12 +514,88 @@ export type GatewayGuildModifyDispatchData = APIGuild;
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-create
  */
-export type GatewayGuildCreateDispatch = GatewayGuildModifyDispatch;
+export type GatewayGuildCreateDispatch = DataPayload<GatewayDispatchEvents.GuildCreate, GatewayGuildCreateDispatchData>;
 
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-create
+ * https://discord.com/developers/docs/topics/gateway#guild-create-guild-create-extra-fields
  */
-export type GatewayGuildCreateDispatchData = GatewayGuildModifyDispatchData;
+export interface GatewayGuildCreateDispatchData extends APIGuild {
+	/**
+	 * When this guild was joined at
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	joined_at: string;
+	/**
+	 * `true` if this is considered a large guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	large: boolean;
+	/**
+	 * Total number of members in this guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	member_count: number;
+	/**
+	 * States of members currently in voice channels; lacks the `guild_id` key
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/voice#voice-state-object
+	 */
+	voice_states: Omit<GatewayVoiceState, 'guild_id'>[];
+	/**
+	 * Users in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	members: APIGuildMember[];
+	/**
+	 * Channels in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/channel#channel-object
+	 */
+	channels: APIChannel[];
+	/**
+	 * Threads in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/channel#channel-object
+	 */
+	threads: APIChannel[];
+	/**
+	 * Presences of the members in the guild, will only include non-offline members if the size is greater than `large_threshold`
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway#presence-update
+	 */
+	presences: GatewayPresenceUpdate[];
+	/**
+	 * The stage instances in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-stage-instance-structure
+	 */
+	stage_instances: APIStageInstance[];
+	/**
+	 * The scheduled events in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object
+	 */
+	guild_scheduled_events: APIGuildScheduledEvent[];
+}
 
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-update
@@ -1051,7 +1125,7 @@ export type GatewayMessageCreateDispatch = DataPayload<
 /**
  * https://discord.com/developers/docs/topics/gateway#message-create
  */
-export type GatewayMessageCreateDispatchData = APIMessage;
+export type GatewayMessageCreateDispatchData = Omit<APIMessage, 'mentions'> & GatewayMessageEventExtraFields;
 
 /**
  * https://discord.com/developers/docs/topics/gateway#message-update
@@ -1064,10 +1138,43 @@ export type GatewayMessageUpdateDispatch = DataPayload<
 /**
  * https://discord.com/developers/docs/topics/gateway#message-update
  */
-export type GatewayMessageUpdateDispatchData = {
-	id: Snowflake;
-	channel_id: Snowflake;
-} & Partial<APIMessage>;
+export type GatewayMessageUpdateDispatchData = Omit<Partial<APIMessage>, 'mentions'> &
+	GatewayMessageEventExtraFields & {
+		/**
+		 * ID of the message
+		 */
+		id: Snowflake;
+		/**
+		 * ID of the channel the message was sent in
+		 */
+		channel_id: Snowflake;
+	};
+
+export interface GatewayMessageEventExtraFields {
+	/**
+	 * ID of the guild the message was sent in
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * Member properties for this message's author
+	 *
+	 * The member object exists in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
+	 * from text-based guild channels
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	member?: APIGuildMember;
+	/**
+	 * Users specifically mentioned in the message
+	 *
+	 * The `member` field is only present in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
+	 * from text-based guild channels
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	mentions: (APIUser & { member?: Omit<APIGuildMember, 'user'> })[];
+}
 
 /**
  * https://discord.com/developers/docs/topics/gateway#message-delete
@@ -1495,15 +1602,15 @@ export interface GatewayIdentifyProperties {
 	/**
 	 * Your operating system
 	 */
-	$os: string;
+	os: string;
 	/**
 	 * Your library name
 	 */
-	$browser: string;
+	browser: string;
 	/**
 	 * Your library name
 	 */
-	$device: string;
+	device: string;
 }
 
 /**

gateway/v9.ts

@@ -3,6 +3,7 @@
  */
 
 import type { Snowflake } from '../globals';
+import type { GatewayPresenceUpdate } from '../payloads/v9/gateway';
 import type {
 	APIApplication,
 	APIChannel,
@@ -194,6 +195,7 @@ export enum GatewayIntentBits {
  * https://discord.com/developers/docs/topics/gateway#commands-and-events-gateway-events
  */
 export enum GatewayDispatchEvents {
+	ApplicationCommandPermissionsUpdate = 'APPLICATION_COMMAND_PERMISSIONS_UPDATE',
 	ChannelCreate = 'CHANNEL_CREATE',
 	ChannelDelete = 'CHANNEL_DELETE',
 	ChannelPinsUpdate = 'CHANNEL_PINS_UPDATE',
@@ -271,6 +273,7 @@ export type GatewayDispatchPayload =
 	| GatewayChannelModifyDispatch
 	| GatewayChannelPinsUpdateDispatch
 	| GatewayGuildBanModifyDispatch
+	| GatewayGuildCreateDispatch
 	| GatewayGuildDeleteDispatch
 	| GatewayGuildEmojisUpdateDispatch
 	| GatewayGuildIntegrationsUpdateDispatch
@@ -498,16 +501,11 @@ export interface GatewayChannelPinsUpdateDispatchData {
 }
 
 /**
- * https://discord.com/developers/docs/topics/gateway#guild-create
  * https://discord.com/developers/docs/topics/gateway#guild-update
  */
-export type GatewayGuildModifyDispatch = DataPayload<
-	GatewayDispatchEvents.GuildCreate | GatewayDispatchEvents.GuildUpdate,
-	GatewayGuildModifyDispatchData
->;
+export type GatewayGuildModifyDispatch = DataPayload<GatewayDispatchEvents.GuildUpdate, GatewayGuildModifyDispatchData>;
 
 /**
- * https://discord.com/developers/docs/topics/gateway#guild-create
  * https://discord.com/developers/docs/topics/gateway#guild-update
  */
 export type GatewayGuildModifyDispatchData = APIGuild;
@@ -515,12 +513,88 @@ export type GatewayGuildModifyDispatchData = APIGuild;
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-create
  */
-export type GatewayGuildCreateDispatch = GatewayGuildModifyDispatch;
+export type GatewayGuildCreateDispatch = DataPayload<GatewayDispatchEvents.GuildCreate, GatewayGuildCreateDispatchData>;
 
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-create
+ * https://discord.com/developers/docs/topics/gateway#guild-create-guild-create-extra-fields
  */
-export type GatewayGuildCreateDispatchData = GatewayGuildModifyDispatchData;
+export interface GatewayGuildCreateDispatchData extends APIGuild {
+	/**
+	 * When this guild was joined at
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	joined_at: string;
+	/**
+	 * `true` if this is considered a large guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	large: boolean;
+	/**
+	 * Total number of members in this guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 */
+	member_count: number;
+	/**
+	 * States of members currently in voice channels; lacks the `guild_id` key
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/voice#voice-state-object
+	 */
+	voice_states: Omit<GatewayVoiceState, 'guild_id'>[];
+	/**
+	 * Users in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	members: APIGuildMember[];
+	/**
+	 * Channels in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/channel#channel-object
+	 */
+	channels: APIChannel[];
+	/**
+	 * Threads in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/channel#channel-object
+	 */
+	threads: APIChannel[];
+	/**
+	 * Presences of the members in the guild, will only include non-offline members if the size is greater than `large_threshold`
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway#presence-update
+	 */
+	presences: GatewayPresenceUpdate[];
+	/**
+	 * The stage instances in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * See https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-stage-instance-structure
+	 */
+	stage_instances: APIStageInstance[];
+	/**
+	 * The scheduled events in the guild
+	 *
+	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
+	 *
+	 * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object
+	 */
+	guild_scheduled_events: APIGuildScheduledEvent[];
+}
 
 /**
  * https://discord.com/developers/docs/topics/gateway#guild-update
@@ -1050,7 +1124,7 @@ export type GatewayMessageCreateDispatch = DataPayload<
 /**
  * https://discord.com/developers/docs/topics/gateway#message-create
  */
-export type GatewayMessageCreateDispatchData = APIMessage;
+export type GatewayMessageCreateDispatchData = Omit<APIMessage, 'mentions'> & GatewayMessageEventExtraFields;
 
 /**
  * https://discord.com/developers/docs/topics/gateway#message-update
@@ -1063,10 +1137,43 @@ export type GatewayMessageUpdateDispatch = DataPayload<
 /**
  * https://discord.com/developers/docs/topics/gateway#message-update
  */
-export type GatewayMessageUpdateDispatchData = {
-	id: Snowflake;
-	channel_id: Snowflake;
-} & Partial<APIMessage>;
+export type GatewayMessageUpdateDispatchData = Omit<Partial<APIMessage>, 'mentions'> &
+	GatewayMessageEventExtraFields & {
+		/**
+		 * ID of the message
+		 */
+		id: Snowflake;
+		/**
+		 * ID of the channel the message was sent in
+		 */
+		channel_id: Snowflake;
+	};
+
+export interface GatewayMessageEventExtraFields {
+	/**
+	 * ID of the guild the message was sent in
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * Member properties for this message's author
+	 *
+	 * The member object exists in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
+	 * from text-based guild channels
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	member?: APIGuildMember;
+	/**
+	 * Users specifically mentioned in the message
+	 *
+	 * The `member` field is only present in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
+	 * from text-based guild channels
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	mentions: (APIUser & { member?: Omit<APIGuildMember, 'user'> })[];
+}
 
 /**
  * https://discord.com/developers/docs/topics/gateway#message-delete
@@ -1494,15 +1601,15 @@ export interface GatewayIdentifyProperties {
 	/**
 	 * Your operating system
 	 */
-	$os: string;
+	os: string;
 	/**
 	 * Your library name
 	 */
-	$browser: string;
+	browser: string;
 	/**
 	 * Your library name
 	 */
-	$device: string;
+	device: string;
 }
 
 /**

package.json

@@ -1,7 +1,8 @@
 {
 	"name": "discord-api-types",
-	"version": "0.31.2",
+	"version": "0.35.0",
 	"description": "Discord API typings that are kept up to date for use in bot library creation.",
+	"homepage": "https://discord-api-types.dev",
 	"exports": {
 		"./globals": {
 			"require": "./globals.js",
@@ -94,7 +95,7 @@
 		"build:deno": "node ./scripts/deno.mjs",
 		"build:node": "tsc && run-p esm:*",
 		"changelog": "conventional-changelog -p angular -i CHANGELOG.md -s",
-		"ci:pr": "run-s changelog lint build:deno",
+		"ci:pr": "run-s changelog lint build:deno && node ./scripts/bump-website-version.mjs",
 		"clean:deno": "rimraf deno/",
 		"clean:node": "rimraf {gateway,payloads,rest,rpc,voice,utils}/**/*.{js,mjs,d.ts,*map} {globals,v*}.{js,mjs,d.ts,*map}",
 		"clean": "run-p clean:*",
@@ -106,11 +107,11 @@
 		"esm:utils": "gen-esm-wrapper ./utils/index.js ./utils/index.mjs",
 		"esm:versions": "node ./scripts/versions.mjs",
 		"esm:voice": "gen-esm-wrapper ./voice/index.js ./voice/index.mjs",
-		"lint": "prettier --write . && eslint --fix --ext mjs,ts {gateway,payloads,rest,rpc,voice,utils}/**/*.ts {globals,v*}.ts scripts/**/*.{mjs,ts}",
+		"lint": "prettier --write . && eslint --fix --ext mjs,ts {gateway,payloads,rest,rpc,voice,utils}/**/*.ts {globals,v*}.ts scripts/**/*.mjs",
 		"postpublish": "run-s clean:node build:deno",
 		"prepare": "is-ci || husky install",
 		"prepublishOnly": "run-s clean test:lint build:node",
-		"test:lint": "prettier --check . && eslint --ext mjs,ts {gateway,payloads,rest,rpc,voice,utils}/**/*.ts {globals,v*}.ts scripts/**/*.{mjs,ts}",
+		"test:lint": "prettier --check . && eslint --ext mjs,ts {gateway,payloads,rest,rpc,voice,utils}/**/*.ts {globals,v*}.ts scripts/**/*.mjs",
 		"pretest:types": "tsc",
 		"test:types": "node ./scripts/run-tsd.mjs",
 		"posttest:types": "npm run clean:node"
@@ -128,32 +129,37 @@
 		"{globals,v*}.{js,js.map,d.ts,d.ts.map,mjs}"
 	],
 	"devDependencies": {
-		"@commitlint/cli": "^16.2.3",
-		"@commitlint/config-angular": "^16.2.3",
+		"@babel/runtime-corejs3": "^7.18.0",
+		"@commitlint/cli": "^17.0.0",
+		"@commitlint/config-angular": "^17.0.0",
 		"@favware/npm-deprecate": "^1.0.4",
-		"@octokit/action": "^3.18.0",
-		"@octokit/webhooks-types": "^5.5.1",
+		"@octokit/action": "^3.18.1",
+		"@octokit/webhooks-types": "^5.6.0",
+		"@sapphire/prettier-config": "^1.4.3",
 		"@types/conventional-recommended-bump": "^6.1.0",
-		"@types/node": "^17.0.23",
-		"@typescript-eslint/eslint-plugin": "^5.18.0",
-		"@typescript-eslint/parser": "^5.18.0",
+		"@types/node": "^17.0.35",
+		"@typescript-eslint/eslint-plugin": "^5.26.0",
+		"@typescript-eslint/parser": "^5.26.0",
 		"conventional-changelog-cli": "^2.2.2",
 		"conventional-recommended-bump": "^6.1.0",
-		"eslint": "^8.12.0",
+		"eslint": "^8.16.0",
 		"eslint-config-marine": "^9.4.1",
 		"eslint-config-prettier": "^8.5.0",
 		"eslint-import-resolver-typescript": "^2.7.1",
-		"eslint-plugin-import": "^2.25.4",
+		"eslint-plugin-import": "^2.26.0",
+		"eslint-plugin-jsx-a11y": "^6.5.1",
+		"eslint-plugin-react": "^7.30.0",
+		"eslint-plugin-react-hooks": "^4.5.0",
 		"gen-esm-wrapper": "^1.1.3",
-		"husky": "^7.0.4",
+		"husky": "^8.0.1",
 		"is-ci": "^3.0.1",
-		"lint-staged": "^12.3.7",
+		"lint-staged": "^12.4.1",
 		"npm-run-all": "^4.1.5",
 		"prettier": "^2.6.2",
 		"pretty-quick": "^3.1.3",
 		"rimraf": "^3.0.2",
 		"tsd": "^0.20.0",
-		"typescript": "^4.6.3"
+		"typescript": "^4.6.4"
 	},
 	"repository": {
 		"type": "git",

payloads/common.ts

@@ -1,4 +1,4 @@
-import type { LocaleString } from '../v10';
+import type { LocaleString } from '../rest/common';
 
 /**
  * https://discord.com/developers/docs/topics/permissions#permissions-bitwise-permission-flags

payloads/v10/_interactions/_applicationCommands/permissions.ts

@@ -5,7 +5,7 @@ import type { Snowflake } from '../../../../globals';
  */
 export interface APIGuildApplicationCommandPermissions {
 	/**
-	 * The id of the command
+	 * The id of the command or the application id if that permission applies to all commands
 	 */
 	id: Snowflake;
 	/**
@@ -27,11 +27,11 @@ export interface APIGuildApplicationCommandPermissions {
  */
 export interface APIApplicationCommandPermission {
 	/**
-	 * The id of the role or user
+	 * The id of the role, user or channel. Can also be a permission constant
 	 */
 	id: Snowflake;
 	/**
-	 * Role or user
+	 * Role, user or channel
 	 */
 	type: ApplicationCommandPermissionType;
 	/**
@@ -46,4 +46,13 @@ export interface APIApplicationCommandPermission {
 export enum ApplicationCommandPermissionType {
 	Role = 1,
 	User,
+	Channel,
 }
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-application-command-permissions-constants
+ */
+export const APIApplicationCommandPermissionsConstant = {
+	Everyone: (guildId: string | bigint): Snowflake => String(guildId),
+	AllChannels: (guildId: string | bigint): Snowflake => String(BigInt(guildId) - 1n),
+};

payloads/v10/_interactions/applicationCommands.ts

@@ -70,10 +70,19 @@ export interface APIApplicationCommand {
 	 * The parameters for the `CHAT_INPUT` command, max 25
 	 */
 	options?: APIApplicationCommandOption[];
+	/**
+	 * Set of permissions represented as a bitset
+	 */
+	default_member_permissions: Permissions | null;
+	/**
+	 * Indicates whether the command is available in DMs with the app, only for globally-scoped commands. By default, commands are visible
+	 */
+	dm_permission?: boolean;
 	/**
 	 * Whether the command is enabled by default when the app is added to a guild
 	 *
 	 * If missing, this property should be assumed as `true`
+	 * @deprecated Use `dm_permission` and/or `default_member_permissions` instead
 	 */
 	default_permission?: boolean;
 	/**

payloads/v10/application.ts

@@ -53,6 +53,12 @@ export interface APIApplication {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 */
 	owner?: APIUser;
+	/**
+	 * An empty string
+	 *
+	 * @deprecated This field will be removed in v11
+	 */
+	summary: string;
 	/**
 	 * The hexadecimal encoded key for verification in interactions and the GameSDK's GetTicket function
 	 *

payloads/v10/auditLog.ts

@@ -16,6 +16,7 @@ import type {
 	GuildScheduledEventEntityType,
 	GuildScheduledEventStatus,
 } from './guildScheduledEvent';
+import type { APIApplicationCommand } from './interactions';
 import type { APIRole } from './permissions';
 import type { StageInstancePrivacyLevel } from './stageInstance';
 import type { StickerFormatType } from './sticker';
@@ -27,6 +28,12 @@ import type { Snowflake } from '../../globals';
  * https://discord.com/developers/docs/resources/audit-log#audit-log-object-audit-log-structure
  */
 export interface APIAuditLog {
+	/**
+	 * List of application commands found in the audit log
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands#application-command-object
+	 */
+	application_commands: APIApplicationCommand[];
 	/**
 	 * Webhooks found in the audit log
 	 *
@@ -171,6 +178,8 @@ export enum AuditLogEvent {
 	ThreadCreate = 110,
 	ThreadUpdate,
 	ThreadDelete,
+
+	ApplicationCommandPermissionUpdate = 121,
 }
 
 /**
@@ -517,6 +526,12 @@ export type APIAuditLogChangeKeyPermissions = AuditLogChangeData<'permissions',
  */
 export type APIAuditLogChangeKeyColor = AuditLogChangeData<'color', number>;
 
+/**
+ * Represents a change where the key is a snowflake.
+ * Currently, the only known instance of this is returned when permissions for a command were updated (<insert name of object here>)
+ */
+export type APIAuditLogChangeKeySnowflake = AuditLogChangeData<Snowflake, unknown>;
+
 /**
  * Returned when a role's hoist status is changed
  */

payloads/v10/channel.ts

@@ -4,7 +4,6 @@
 
 import type { APIApplication } from './application';
 import type { APIPartialEmoji } from './emoji';
-import type { APIGuildMember } from './guild';
 import type { APIMessageInteraction } from './interactions';
 import type { APIRole } from './permissions';
 import type { APISticker, APIStickerItem } from './sticker';
@@ -326,10 +325,6 @@ export interface APIMessage {
 	 * ID of the channel the message was sent in
 	 */
 	channel_id: Snowflake;
-	/**
-	 * ID of the guild the message was sent in
-	 */
-	guild_id?: Snowflake;
 	/**
 	 * The author of this message (only a valid user in the case where the message is generated by a user or bot user)
 	 *
@@ -339,15 +334,6 @@ export interface APIMessage {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 */
 	author: APIUser;
-	/**
-	 * Member properties for this message's author
-	 *
-	 * The member object exists in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
-	 * from text-based guild channels
-	 *
-	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
-	 */
-	member?: APIGuildMember;
 	/**
 	 * Contents of the message
 	 */
@@ -377,7 +363,7 @@ export interface APIMessage {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
 	 */
-	mentions: (APIUser & { member?: Omit<APIGuildMember, 'user'> })[];
+	mentions: APIUser[];
 	/**
 	 * Roles specifically mentioned in this message
 	 *
@@ -770,10 +756,6 @@ export interface APIThreadList {
 	 * The members for the client user in each of the fetched threads
 	 */
 	members: APIThreadMember[];
-	/**
-	 * Whether there are potentially additional threads
-	 */
-	has_more?: boolean;
 }
 
 /**
@@ -921,6 +903,10 @@ export interface APIEmbedVideo {
 	 * Source url of video
 	 */
 	url?: string;
+	/**
+	 * A proxied url of the video
+	 */
+	proxy_url?: string;
 	/**
 	 * Height of video
 	 */

payloads/v10/gateway.ts

@@ -127,6 +127,7 @@ export interface GatewayPresenceClientStatus {
 export interface GatewayActivity {
 	/**
 	 * The activity's id
+	 * @unstable
 	 */
 	id: string;
 	/**
@@ -151,8 +152,16 @@ export interface GatewayActivity {
 	 * Unix timestamps for start and/or end of the game
 	 */
 	timestamps?: GatewayActivityTimestamps;
+	/**
+	 * The Spotify song id
+	 * @unstable
+	 */
 	sync_id?: string;
-	platform?: ActivityPlatform;
+	/**
+	 * The platform this activity is being done on
+	 * @unstable You can use {@link ActivityPlatform} as a stepping stone, but this might be inaccurate
+	 */
+	platform?: string;
 	/**
 	 * Application id for the game
 	 */
@@ -171,6 +180,9 @@ export interface GatewayActivity {
 	 * See https://discord.com/developers/docs/topics/gateway#activity-object-activity-emoji
 	 */
 	emoji?: GatewayActivityEmoji;
+	/**
+	 * @unstable
+	 */
 	session_id?: string;
 	/**
 	 * Information for the current party of the player
@@ -208,10 +220,19 @@ export interface GatewayActivity {
 	buttons?: string[] | GatewayActivityButton[];
 }
 
+/**
+ * @unstable This enum is currently not documented by Discord but has known values which we will try to keep up to date.
+ * Values might be added or removed without a major version bump.
+ */
 export enum ActivityPlatform {
 	Desktop = 'desktop',
-	Samsung = 'samsung',
 	Xbox = 'xbox',
+	Samsung = 'samsung',
+	IOS = 'ios',
+	Android = 'android',
+	Embedded = 'embedded',
+	PS4 = 'ps4',
+	PS5 = 'ps5',
 }
 
 /**

payloads/v10/guild.ts

@@ -2,15 +2,11 @@
  * Types extracted from https://discord.com/developers/docs/resources/guild
  */
 
-import type { APIChannel } from './channel';
 import type { APIEmoji } from './emoji';
-import type { GatewayPresenceUpdate, PresenceUpdateStatus } from './gateway';
-import type { APIGuildScheduledEvent } from './guildScheduledEvent';
+import type { PresenceUpdateStatus } from './gateway';
 import type { APIRole } from './permissions';
-import type { APIStageInstance } from './stageInstance';
 import type { APISticker } from './sticker';
 import type { APIUser } from './user';
-import type { GatewayVoiceState } from './voice';
 import type { Permissions, Snowflake } from '../../globals';
 
 /**
@@ -196,64 +192,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * The id of the channel where Community guilds can display rules and/or guidelines
 	 */
 	rules_channel_id: Snowflake | null;
-	/**
-	 * When this guild was joined at
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	joined_at?: string;
-	/**
-	 * `true` if this is considered a large guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	large?: boolean;
-	/**
-	 * Total number of members in this guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	member_count?: number;
-	/**
-	 * States of members currently in voice channels; lacks the `guild_id` key
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/voice#voice-state-object
-	 */
-	voice_states?: Omit<GatewayVoiceState, 'guild_id'>[];
-	/**
-	 * Users in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
-	 */
-	members?: APIGuildMember[];
-	/**
-	 * Channels in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/channel#channel-object
-	 */
-	channels?: APIChannel[];
-	/**
-	 * Threads in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/channel#channel-object
-	 */
-	threads?: APIChannel[];
-	/**
-	 * Presences of the members in the guild, will only include non-offline members if the size is greater than `large_threshold`
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/topics/gateway#presence-update
-	 */
-	presences?: GatewayPresenceUpdate[];
 	/**
 	 * The maximum number of presences for the guild (`null` is always returned, apart from the largest of guilds)
 	 */
@@ -320,14 +258,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * See https://discord.com/developers/docs/resources/guild#guild-object-guild-nsfw-level
 	 */
 	nsfw_level: GuildNSFWLevel;
-	/**
-	 * The stage instances in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-stage-instance-structure
-	 */
-	stage_instances?: APIStageInstance[];
 	/**
 	 * Custom guild stickers
 	 *
@@ -338,14 +268,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * Whether the guild has the boost progress bar enabled.
 	 */
 	premium_progress_bar_enabled: boolean;
-	/**
-	 * The scheduled events in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object
-	 */
-	guild_scheduled_events?: APIGuildScheduledEvent[];
 	/**
 	 * The type of Student Hub the guild is
 	 */
@@ -536,14 +458,6 @@ export enum GuildFeature {
 	 * Guild is able to set role icons
 	 */
 	RoleIcons = 'ROLE_ICONS',
-	/**
-	 * Guild has access to the seven day archive time for threads
-	 */
-	SevenDayThreadArchive = 'SEVEN_DAY_THREAD_ARCHIVE',
-	/**
-	 * Guild has access to the three day archive time for threads
-	 */
-	ThreeDayThreadArchive = 'THREE_DAY_THREAD_ARCHIVE',
 	/**
 	 * Guild has enabled ticketed events
 	 */
@@ -715,7 +629,7 @@ export interface APIGuildIntegration {
 	/**
 	 * Is this integration enabled
 	 */
-	enabled: boolean;
+	enabled?: boolean;
 	/**
 	 * Is this integration syncing
 	 *

payloads/v10/oauth2.ts

@@ -14,6 +14,10 @@ export enum OAuth2Scopes {
 	 * See https://discord.com/developers/docs/resources/user#get-user-connections
 	 */
 	Connections = 'connections',
+	/**
+	 * Allows your app to see information about the user's DMs and group DMs - requires Discord approval
+	 */
+	DMChannelsRead = 'dm_channels.read',
 	/**
 	 * Enables [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) to return an `email`
 	 *
@@ -69,6 +73,10 @@ export enum OAuth2Scopes {
 	 * This generates a webhook that is returned in the oauth token response for authorization code grants
 	 */
 	WebhookIncoming = 'webhook.incoming',
+	/**
+	 * Allows your app to connect to voice on user's behalf and see all the voice members - requires Discord approval
+	 */
+	Voice = 'voice',
 	/**
 	 * Allows your app to upload/update builds for a user's applications - requires Discord approval
 	 */
@@ -111,4 +119,10 @@ export enum OAuth2Scopes {
 	 * See https://discord.com/developers/docs/interactions/application-commands
 	 */
 	ApplicationsCommandsUpdate = 'applications.commands.update',
+	/**
+	 * Allows your app to update permissions for its commands using a Bearer token - client credentials grant only
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
+	 */
+	ApplicationCommandsPermissionsUpdate = 'applications.commands.permissions.update',
 }

payloads/v10/user.ts

@@ -143,8 +143,16 @@ export enum UserFlags {
 	BotHTTPInteractions = 1 << 19,
 	/**
 	 * User has been identified as spammer
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
 	 */
 	Spammer = 1 << 20,
+	/**
+	 * User's account has been quarantined based on recent activity
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
+	 */
+	Quarantined = Math.pow(2, 44),
 }
 
 /**

payloads/v8/user.ts

@@ -145,8 +145,16 @@ export enum UserFlags {
 	BotHTTPInteractions = 1 << 19,
 	/**
 	 * User has been identified as spammer
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
 	 */
 	Spammer = 1 << 20,
+	/**
+	 * User's account has been quarantined based on recent activity
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
+	 */
+	Quarantined = Math.pow(2, 44),
 }
 
 /**

payloads/v9/_interactions/_applicationCommands/permissions.ts

@@ -5,7 +5,7 @@ import type { Snowflake } from '../../../../globals';
  */
 export interface APIGuildApplicationCommandPermissions {
 	/**
-	 * The id of the command
+	 * The id of the command or the application id if that permission applies to all commands
 	 */
 	id: Snowflake;
 	/**
@@ -27,11 +27,11 @@ export interface APIGuildApplicationCommandPermissions {
  */
 export interface APIApplicationCommandPermission {
 	/**
-	 * The id of the role or user
+	 * The id of the role, user or channel. Can also be a permission constant
 	 */
 	id: Snowflake;
 	/**
-	 * Role or user
+	 * Role, user or channel
 	 */
 	type: ApplicationCommandPermissionType;
 	/**
@@ -46,4 +46,13 @@ export interface APIApplicationCommandPermission {
 export enum ApplicationCommandPermissionType {
 	Role = 1,
 	User,
+	Channel,
 }
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-application-command-permissions-constants
+ */
+export const APIApplicationCommandPermissionsConstant = {
+	Everyone: (guildId: string | bigint): Snowflake => String(guildId),
+	AllChannels: (guildId: string | bigint): Snowflake => String(BigInt(guildId) - 1n),
+};

payloads/v9/_interactions/applicationCommands.ts

@@ -70,10 +70,19 @@ export interface APIApplicationCommand {
 	 * The parameters for the `CHAT_INPUT` command, max 25
 	 */
 	options?: APIApplicationCommandOption[];
+	/**
+	 * Set of permissions represented as a bitset
+	 */
+	default_member_permissions: Permissions | null;
+	/**
+	 * Indicates whether the command is available in DMs with the app, only for globally-scoped commands. By default, commands are visible
+	 */
+	dm_permission?: boolean;
 	/**
 	 * Whether the command is enabled by default when the app is added to a guild
 	 *
 	 * If missing, this property should be assumed as `true`
+	 * @deprecated Use `dm_permission` and/or `default_member_permissions` instead
 	 */
 	default_permission?: boolean;
 	/**

payloads/v9/application.ts

@@ -53,6 +53,12 @@ export interface APIApplication {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 */
 	owner?: APIUser;
+	/**
+	 * An empty string
+	 *
+	 * @deprecated This field will be removed in v11
+	 */
+	summary: string;
 	/**
 	 * The hexadecimal encoded key for verification in interactions and the GameSDK's GetTicket function
 	 *

payloads/v9/auditLog.ts

@@ -16,6 +16,7 @@ import type {
 	GuildScheduledEventEntityType,
 	GuildScheduledEventStatus,
 } from './guildScheduledEvent';
+import type { APIApplicationCommand } from './interactions';
 import type { APIRole } from './permissions';
 import type { StageInstancePrivacyLevel } from './stageInstance';
 import type { StickerFormatType } from './sticker';
@@ -27,6 +28,12 @@ import type { Snowflake } from '../../globals';
  * https://discord.com/developers/docs/resources/audit-log#audit-log-object-audit-log-structure
  */
 export interface APIAuditLog {
+	/**
+	 * List of application commands found in the audit log
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands#application-command-object
+	 */
+	application_commands: APIApplicationCommand[];
 	/**
 	 * Webhooks found in the audit log
 	 *
@@ -171,6 +178,8 @@ export enum AuditLogEvent {
 	ThreadCreate = 110,
 	ThreadUpdate,
 	ThreadDelete,
+
+	ApplicationCommandPermissionUpdate = 121,
 }
 
 /**
@@ -517,6 +526,12 @@ export type APIAuditLogChangeKeyPermissions = AuditLogChangeData<'permissions',
  */
 export type APIAuditLogChangeKeyColor = AuditLogChangeData<'color', number>;
 
+/**
+ * Represents a change where the key is a snowflake.
+ * Currently, the only known instance of this is returned when permissions for a command were updated (<insert name of object here>)
+ */
+export type APIAuditLogChangeKeySnowflake = AuditLogChangeData<Snowflake, unknown>;
+
 /**
  * Returned when a role's hoist status is changed
  */

payloads/v9/channel.ts

@@ -4,7 +4,6 @@
 
 import type { APIApplication } from './application';
 import type { APIPartialEmoji } from './emoji';
-import type { APIGuildMember } from './guild';
 import type { APIMessageInteraction } from './interactions';
 import type { APIRole } from './permissions';
 import type { APISticker, APIStickerItem } from './sticker';
@@ -326,10 +325,6 @@ export interface APIMessage {
 	 * ID of the channel the message was sent in
 	 */
 	channel_id: Snowflake;
-	/**
-	 * ID of the guild the message was sent in
-	 */
-	guild_id?: Snowflake;
 	/**
 	 * The author of this message (only a valid user in the case where the message is generated by a user or bot user)
 	 *
@@ -339,15 +334,6 @@ export interface APIMessage {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 */
 	author: APIUser;
-	/**
-	 * Member properties for this message's author
-	 *
-	 * The member object exists in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events
-	 * from text-based guild channels
-	 *
-	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
-	 */
-	member?: APIGuildMember;
 	/**
 	 * Contents of the message
 	 */
@@ -377,7 +363,7 @@ export interface APIMessage {
 	 * See https://discord.com/developers/docs/resources/user#user-object
 	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
 	 */
-	mentions: (APIUser & { member?: Omit<APIGuildMember, 'user'> })[];
+	mentions: APIUser[];
 	/**
 	 * Roles specifically mentioned in this message
 	 *
@@ -921,6 +907,10 @@ export interface APIEmbedVideo {
 	 * Source url of video
 	 */
 	url?: string;
+	/**
+	 * A proxied url of the video
+	 */
+	proxy_url?: string;
 	/**
 	 * Height of video
 	 */

payloads/v9/gateway.ts

@@ -152,7 +152,10 @@ export interface GatewayActivity {
 	 */
 	timestamps?: GatewayActivityTimestamps;
 	sync_id?: string;
-	platform?: ActivityPlatform;
+	/**
+	 * {@link ActivityPlatform}
+	 */
+	platform?: string;
 	/**
 	 * Application id for the game
 	 */
@@ -208,10 +211,19 @@ export interface GatewayActivity {
 	buttons?: string[] | GatewayActivityButton[];
 }
 
+/**
+ * @unstable This enum is currently not documented by Discord but has known values which we will try to keep up to date.
+ * Values might be added or removed without a major version bump.
+ */
 export enum ActivityPlatform {
 	Desktop = 'desktop',
-	Samsung = 'samsung',
 	Xbox = 'xbox',
+	Samsung = 'samsung',
+	IOS = 'ios',
+	Android = 'android',
+	Embedded = 'embedded',
+	PS4 = 'ps4',
+	PS5 = 'ps5',
 }
 
 /**

payloads/v9/guild.ts

@@ -2,15 +2,11 @@
  * Types extracted from https://discord.com/developers/docs/resources/guild
  */
 
-import type { APIChannel } from './channel';
 import type { APIEmoji } from './emoji';
-import type { GatewayPresenceUpdate, PresenceUpdateStatus } from './gateway';
-import type { APIGuildScheduledEvent } from './guildScheduledEvent';
+import type { PresenceUpdateStatus } from './gateway';
 import type { APIRole } from './permissions';
-import type { APIStageInstance } from './stageInstance';
 import type { APISticker } from './sticker';
 import type { APIUser } from './user';
-import type { GatewayVoiceState } from './voice';
 import type { Permissions, Snowflake } from '../../globals';
 
 /**
@@ -196,64 +192,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * The id of the channel where Community guilds can display rules and/or guidelines
 	 */
 	rules_channel_id: Snowflake | null;
-	/**
-	 * When this guild was joined at
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	joined_at?: string;
-	/**
-	 * `true` if this is considered a large guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	large?: boolean;
-	/**
-	 * Total number of members in this guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 */
-	member_count?: number;
-	/**
-	 * States of members currently in voice channels; lacks the `guild_id` key
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/voice#voice-state-object
-	 */
-	voice_states?: Omit<GatewayVoiceState, 'guild_id'>[];
-	/**
-	 * Users in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
-	 */
-	members?: APIGuildMember[];
-	/**
-	 * Channels in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/channel#channel-object
-	 */
-	channels?: APIChannel[];
-	/**
-	 * Threads in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/channel#channel-object
-	 */
-	threads?: APIChannel[];
-	/**
-	 * Presences of the members in the guild, will only include non-offline members if the size is greater than `large_threshold`
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/topics/gateway#presence-update
-	 */
-	presences?: GatewayPresenceUpdate[];
 	/**
 	 * The maximum number of presences for the guild (`null` is always returned, apart from the largest of guilds)
 	 */
@@ -320,14 +258,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * See https://discord.com/developers/docs/resources/guild#guild-object-guild-nsfw-level
 	 */
 	nsfw_level: GuildNSFWLevel;
-	/**
-	 * The stage instances in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * See https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-stage-instance-structure
-	 */
-	stage_instances?: APIStageInstance[];
 	/**
 	 * Custom guild stickers
 	 *
@@ -338,14 +268,6 @@ export interface APIGuild extends APIPartialGuild {
 	 * Whether the guild has the boost progress bar enabled.
 	 */
 	premium_progress_bar_enabled: boolean;
-	/**
-	 * The scheduled events in the guild
-	 *
-	 * **This field is only sent within the [GUILD_CREATE](https://discord.com/developers/docs/topics/gateway#guild-create) event**
-	 *
-	 * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object
-	 */
-	guild_scheduled_events?: APIGuildScheduledEvent[];
 	/**
 	 * The type of Student Hub the guild is
 	 */
@@ -536,14 +458,6 @@ export enum GuildFeature {
 	 * Guild is able to set role icons
 	 */
 	RoleIcons = 'ROLE_ICONS',
-	/**
-	 * Guild has access to the seven day archive time for threads
-	 */
-	SevenDayThreadArchive = 'SEVEN_DAY_THREAD_ARCHIVE',
-	/**
-	 * Guild has access to the three day archive time for threads
-	 */
-	ThreeDayThreadArchive = 'THREE_DAY_THREAD_ARCHIVE',
 	/**
 	 * Guild has enabled ticketed events
 	 */
@@ -715,7 +629,7 @@ export interface APIGuildIntegration {
 	/**
 	 * Is this integration enabled
 	 */
-	enabled: boolean;
+	enabled?: boolean;
 	/**
 	 * Is this integration syncing
 	 *

payloads/v9/oauth2.ts

@@ -14,6 +14,10 @@ export enum OAuth2Scopes {
 	 * See https://discord.com/developers/docs/resources/user#get-user-connections
 	 */
 	Connections = 'connections',
+	/**
+	 * Allows your app to see information about the user's DMs and group DMs - requires Discord approval
+	 */
+	DMChannelsRead = 'dm_channels.read',
 	/**
 	 * Enables [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) to return an `email`
 	 *
@@ -69,6 +73,10 @@ export enum OAuth2Scopes {
 	 * This generates a webhook that is returned in the oauth token response for authorization code grants
 	 */
 	WebhookIncoming = 'webhook.incoming',
+	/**
+	 * Allows your app to connect to voice on user's behalf and see all the voice members - requires Discord approval
+	 */
+	Voice = 'voice',
 	/**
 	 * Allows your app to upload/update builds for a user's applications - requires Discord approval
 	 */
@@ -111,4 +119,10 @@ export enum OAuth2Scopes {
 	 * See https://discord.com/developers/docs/interactions/application-commands
 	 */
 	ApplicationsCommandsUpdate = 'applications.commands.update',
+	/**
+	 * Allows your app to update permissions for its commands using a Bearer token - client credentials grant only
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
+	 */
+	ApplicationCommandsPermissionsUpdate = 'applications.commands.permissions.update',
 }

payloads/v9/user.ts

@@ -143,8 +143,16 @@ export enum UserFlags {
 	BotHTTPInteractions = 1 << 19,
 	/**
 	 * User has been identified as spammer
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
 	 */
 	Spammer = 1 << 20,
+	/**
+	 * User's account has been quarantined based on recent activity
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
+	 */
+	Quarantined = Math.pow(2, 44),
 }
 
 /**

rest/common.ts

@@ -116,6 +116,8 @@ export enum RESTJSONErrorCodes {
 	MaximumNumberOfPinnedThreadsInForumHasBeenReached,
 	MaximumNumberOfTagsInForumHasBeenReached,
 
+	BitrateIsTooHighForChannelOfThisType = 30052,
+
 	Unauthorized = 40001,
 	VerifyYourAccount,
 	OpeningDirectMessagesTooFast,
@@ -148,6 +150,7 @@ export enum RESTJSONErrorCodes {
 	InvalidToken,
 	NoteWasTooLong,
 	ProvidedTooFewOrTooManyMessagesToDelete,
+	InvalidMFALevel,
 
 	MessageCanOnlyBePinnedInTheChannelItWasSentIn = 50019,
 	InviteCodeInvalidOrTaken,
@@ -179,7 +182,8 @@ export enum RESTJSONErrorCodes {
 
 	CannotDeleteChannelRequiredForCommunityGuilds = 50074,
 
-	InvalidStickerSent = 50081,
+	CannotEditStickersWithinMessage = 50080,
+	InvalidStickerSent,
 
 	InvalidActionOnArchivedThread = 50083,
 	InvalidThreadNotificationSettings,
@@ -194,6 +198,8 @@ export enum RESTJSONErrorCodes {
 
 	RequestBodyContainsInvalidJSON = 50109,
 
+	YouDoNotHavePermissionToSendThisSticker = 50600,
+
 	TwoFactorAuthenticationIsRequired = 60003,
 
 	NoUsersWithDiscordTagExist = 80004,
@@ -222,6 +228,8 @@ export enum RESTJSONErrorCodes {
 	CannotUpdateAFinishedEvent = 180000,
 
 	FailedToCreateStageNeededForStageEvent = 180002,
+
+	WebhooksCanOnlyCreateThreadsInForumChannels = 220003,
 }
 
 /**

rest/v10/channel.ts

@@ -64,7 +64,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	/**
 	 * Whether the channel is nsfw
 	 *
-	 * Channel types: text, news
+	 * Channel types: text, voice, news
 	 */
 	nsfw?: boolean | null;
 	/**
@@ -96,7 +96,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	/**
 	 * ID of the new parent category for a channel
 	 *
-	 * Channel types: text, news, voice
+	 * Channel types: text, voice, news
 	 */
 	parent_id?: Snowflake | null;
 	/**
@@ -584,13 +584,22 @@ export type RESTPostAPIChannelMessagesThreadsJSONBody = AddUndefinedToPossiblyUn
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-in-forum-channel
  */
-export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThreadsJSONBody &
-	RESTPostAPIChannelMessageJSONBody;
+export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThreadsJSONBody & {
+	/**
+	 * First message in the forum thread
+	 */
+	message: RESTPostAPIChannelMessageJSONBody;
+};
 
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-in-forum-channel
  */
-export type RESTPostAPIGuildForumThreadsFormDataBody = RESTPostAPIChannelMessageFormDataBody;
+export type RESTPostAPIGuildForumThreadsFormDataBody = RESTPostAPIChannelMessagesThreadsJSONBody & {
+	/**
+	 * First message in the forum thread
+	 */
+	message: string;
+};
 
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-from-message

rest/v10/guild.ts

@@ -20,6 +20,7 @@ import type {
 	GuildDefaultMessageNotifications,
 	GuildExplicitContentFilter,
 	GuildFeature,
+	GuildMFALevel,
 	GuildSystemChannelFlags,
 	GuildVerificationLevel,
 	GuildWidgetStyle,
@@ -41,7 +42,17 @@ export type APIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGr
 export type APIGuildCreatePartialChannel = StrictPartial<
 	DistributivePick<
 		APIGuildChannelResolvable,
-		'type' | 'topic' | 'nsfw' | 'bitrate' | 'user_limit' | 'rate_limit_per_user' | 'default_auto_archive_duration'
+		| 'type'
+		| 'topic'
+		| 'nsfw'
+		| 'bitrate'
+		| 'user_limit'
+		| 'rate_limit_per_user'
+		| 'default_auto_archive_duration'
+		| 'position'
+		| 'rtc_region'
+		| 'video_quality_mode'
+		| 'flags'
 	>
 > &
 	AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
@@ -148,6 +159,23 @@ export type RESTPostAPIGuildsJSONBody = AddUndefinedToPossiblyUndefinedPropertie
  */
 export type RESTPostAPIGuildsResult = APIGuild;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level
+ */
+export interface RESTPostAPIGuildsMFAJSONBody {
+	/**
+	 * MFA level
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-object-mfa-level
+	 */
+	level: GuildMFALevel;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level
+ */
+export type RESTPostAPIGuildsMFAResult = RESTPostAPIGuildsMFAJSONBody;
+
 /**
  * https://discord.com/developers/docs/resources/guild#get-guild
  */
@@ -331,7 +359,7 @@ export type RESTPatchAPIGuildChannelPositionsResult = never;
 /**
  * https://discord.com/developers/docs/resources/guild#list-active-threads
  */
-export type RESTGetAPIGuildThreadsResult = Omit<APIThreadList, 'has_more'>;
+export type RESTGetAPIGuildThreadsResult = APIThreadList;
 
 /**
  * https://discord.com/developers/docs/resources/guild#get-guild-member
@@ -820,6 +848,9 @@ export type RESTPatchAPIGuildMemberVerificationJSONBody = AddUndefinedToPossibly
 
 export type RESTPatchAPIGuildMemberVerificationResult = APIGuildMembershipScreening;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-current-user-voice-state
+ */
 export type RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
 	/**
 	 * The id of the channel the user is currently in
@@ -835,6 +866,14 @@ export type RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody = AddUndefinedToPos
 	request_to_speak_timestamp?: string | null;
 }>;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-current-user-voice-state
+ */
+export type RESTPatchAPIGuildVoiceStateCurrentMemberResult = never;
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-user-voice-state
+ */
 export type RESTPatchAPIGuildVoiceStateUserJSONBody = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
 	/**
 	 * The id of the channel the user is currently in
@@ -861,3 +900,8 @@ export type RESTPatchAPIGuildWelcomeScreenJSONBody = Nullable<StrictPartial<APIG
 		 */
 		enabled?: boolean | null;
 	}>;
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-welcome-screen
+ */
+export type RESTPatchAPIGuildWelcomeScreenResult = APIGuildWelcomeScreen;

rest/v10/index.ts

@@ -274,6 +274,14 @@ export const Routes = {
 		return `/guilds/${guildId}/members/${memberId}/roles/${roleId}` as const;
 	},
 
+	/**
+	 * Route for:
+	 * - POST `/guilds/{guild.id}/mfa`
+	 */
+	guildMFA(guildId: Snowflake) {
+		return `/guilds/${guildId}/mfa` as const;
+	},
+
 	/**
 	 * Route for:
 	 * - GET `/guilds/{guild.id}/bans`
@@ -836,6 +844,262 @@ export const Routes = {
 	},
 };
 
+export const StickerPackApplicationId = '710982414301790216';
+
+export const CDNRoutes = {
+	/**
+	 * Route for:
+	 * - GET `/emojis/{emoji.id}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	emoji(emojiId: Snowflake, format: EmojiFormat) {
+		return `/emojis/${emojiId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/{guild.id}/icons/{guild.id}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildIcon(guildId: Snowflake, guildIcon: string, format: GuildIconFormat) {
+		return `icons/${guildId}/${guildIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/splashes/{guild.id}/{guild.splash}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildSplash(guildId: Snowflake, guildSplash: string, format: GuildSplashFormat) {
+		return `/splashes/${guildId}/${guildSplash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/discovery-splashes/{guild.id}/{guild.discovery_splash}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildDiscoverySplash(guildId: Snowflake, guildDiscoverySplash: string, format: GuildDiscoverySplashFormat) {
+		return `/discovery-splashes/${guildId}/${guildDiscoverySplash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/banners/{guild.id}/{guild.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildBanner(guildId: Snowflake, guildBanner: string, format: GuildBannerFormat) {
+		return `/banners/${guildId}/${guildBanner}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/banners/{user.id}/{user.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	userBanner(userId: Snowflake, userBanner: string, format: UserBannerFormat) {
+		return `/banners/${userId}/${userBanner}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/embed/avatars/{user.discriminator % 5}.png`
+	 *
+	 * The `userDiscriminator` parameter should be the user discriminator modulo 5 (e.g. 1337 % 5 = 2)
+	 *
+	 * This route supports the extension: PNG
+	 */
+	defaultUserAvatar(userDiscriminator: DefaultUserAvatarAssets) {
+		return `/embed/avatars/${userDiscriminator}.png` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/avatars/{user.id}/{user.avatar}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	userAvatar(userId: Snowflake, userAvatar: string, format: UserAvatarFormat) {
+		return `/avatars/${userId}/${userAvatar}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/{guild.id}/users/{user.id}/{guild_member.avatar}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildMemberAvatar(guildId: Snowflake, userId: Snowflake, memberAvatar: string, format: GuildMemberAvatarFormat) {
+		return `/guilds/${guildId}/users/${userId}/avatars/${memberAvatar}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationIcon(applicationId: Snowflake, applicationIcon: string, format: ApplicationIconFormat) {
+		return `/app-icons/${applicationId}/${applicationIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.cover_image}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationCover(applicationId: Snowflake, applicationCoverImage: string, format: ApplicationCoverFormat) {
+		return `/app-icons/${applicationId}/${applicationCoverImage}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.asset_id}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationAsset(applicationId: Snowflake, applicationAssetId: string, format: ApplicationAssetFormat) {
+		return `/app-icons/${applicationId}/${applicationAssetId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-assets/{application.id}/achievements/{achievement.id}/icons/{achievement.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	achievementIcon(
+		applicationId: Snowflake,
+		achievementId: Snowflake,
+		achievementIconHash: string,
+		format: AchievementIconFormat,
+	) {
+		return `/app-assets/${applicationId}/achievements/${achievementId}/icons/${achievementIconHash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-assets/710982414301790216/store/{sticker_pack.banner.asset_id}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	stickerPackBanner(stickerPackBannerAssetId: Snowflake, format: StickerPackBannerFormat) {
+		return `/app-assets/${StickerPackApplicationId}/store/${stickerPackBannerAssetId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `team-icons/{team.id}/{team.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	teamIcon(teamId: Snowflake, teamIcon: string, format: TeamIconFormat) {
+		return `/team-icons/${teamId}/${teamIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/stickers/{sticker.id}.{png|json}`
+	 *
+	 * This route supports the extensions: PNG, Lottie
+	 */
+	sticker(stickerId: Snowflake, format: StickerFormat) {
+		return `/stickers/${stickerId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/role-icons/{role.id}/{role.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	roleIcon(roleId: Snowflake, roleIcon: string, format: RoleIconFormat) {
+		return `/role-icons/${roleId}/${roleIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guild-events/{guild_scheduled_event.id}/{guild_scheduled_event.image}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildScheduledEventCover(
+		guildScheduledEventId: Snowflake,
+		guildScheduledEventCoverImage: string,
+		format: GuildScheduledEventCoverFormat,
+	) {
+		return `/guild-events/${guildScheduledEventId}/${guildScheduledEventCoverImage}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/${guild.id}/users/${user.id}/banners/${guild_member.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildMemberBanner(guildId: Snowflake, userId: Snowflake, guildMemberBanner: string, format: GuildMemberBannerFormat) {
+		return `/guilds/${guildId}/users/${userId}/banners/${guildMemberBanner}.${format}` as const;
+	},
+};
+
+export type DefaultUserAvatarAssets = 0 | 1 | 2 | 3 | 4 | 5;
+
+export type EmojiFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildIconFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildSplashFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildDiscoverySplashFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type UserBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type DefaultUserAvatar = Extract<ImageFormat, ImageFormat.PNG>;
+export type UserAvatarFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildMemberAvatarFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type ApplicationIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type ApplicationCoverFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type ApplicationAssetFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type AchievementIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type StickerPackBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type TeamIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type StickerFormat = Extract<ImageFormat, ImageFormat.PNG | ImageFormat.Lottie>;
+export type RoleIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildScheduledEventCoverFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildMemberBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+
+export enum ImageFormat {
+	JPEG = 'jpeg',
+	PNG = 'png',
+	WebP = 'webp',
+	GIF = 'gif',
+	Lottie = 'json',
+}
+
+export interface CDNQuery {
+	/**
+	 * The returned image can have the size changed by using this query parameter
+	 *
+	 * Image size can be any power of two between 16 and 4096
+	 */
+	size?: number;
+}
+
 export const RouteBases = {
 	api: `https://discord.com/api/v${APIVersion}`,
 	cdn: 'https://cdn.discordapp.com',

rest/v10/interactions.ts

@@ -37,7 +37,9 @@ type RESTPostAPIBaseApplicationCommandsJSONBody = AddUndefinedToPossiblyUndefine
 		| 'guild_id'
 		| 'name_localized'
 		| 'description_localized'
-	>
+		| 'default_member_permissions'
+	> &
+		Partial<Pick<APIApplicationCommand, 'default_member_permissions'>>
 >;
 
 /**
@@ -91,42 +93,50 @@ export type RESTPutAPIApplicationCommandsResult = APIApplicationCommand[];
 /**
  * https://discord.com/developers/docs/interactions/application-commands#get-guild-application-commands
  */
-export type RESTGetAPIApplicationGuildCommandsResult = APIApplicationCommand[];
+export type RESTGetAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>[];
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#get-guild-application-commands
  */
-export type RESTGetAPIApplicationGuildCommandResult = APIApplicationCommand;
+export type RESTGetAPIApplicationGuildCommandResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#create-guild-application-command
  */
-export type RESTPostAPIApplicationGuildCommandsJSONBody = RESTPostAPIApplicationCommandsJSONBody;
+export type RESTPostAPIApplicationGuildCommandsJSONBody =
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#create-guild-application-command
  */
-export type RESTPostAPIApplicationGuildCommandsResult = APIApplicationCommand;
+export type RESTPostAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command
  */
-export type RESTPatchAPIApplicationGuildCommandJSONBody = StrictPartial<RESTPostAPIApplicationCommandsJSONBody>;
+export type RESTPatchAPIApplicationGuildCommandJSONBody = StrictPartial<
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>
+>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command
  */
-export type RESTPatchAPIApplicationGuildCommandResult = APIApplicationCommand;
+export type RESTPatchAPIApplicationGuildCommandResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-guild-application-commands
  */
-export type RESTPutAPIApplicationGuildCommandsJSONBody = RESTPostAPIApplicationCommandsJSONBody[];
+export type RESTPutAPIApplicationGuildCommandsJSONBody = (
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>
+)[];
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-guild-application-commands
  */
-export type RESTPutAPIApplicationGuildCommandsResult = APIApplicationCommand[];
+export type RESTPutAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>[];
 
 /**
  * https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response

rest/v10/webhook.ts

@@ -144,6 +144,12 @@ export type RESTPostAPIWebhookWithTokenJSONBody = AddUndefinedToPossiblyUndefine
 	 * Message flags combined as a bitfield
 	 */
 	flags?: MessageFlags;
+	/**
+	 * Name of thread to create
+	 *
+	 * Available only if the webhook is in a forum channel and a thread is not specified in {@link RESTPostAPIWebhookWithTokenQuery.thread_id} query parameter
+	 */
+	thread_name?: string;
 }>;
 
 /**
@@ -171,6 +177,8 @@ export interface RESTPostAPIWebhookWithTokenQuery {
 	wait?: boolean;
 	/**
 	 * Send a message to the specified thread within a webhook's channel. The thread will automatically be unarchived.
+	 *
+	 * Available only if the {@link RESTPostAPIWebhookWithTokenJSONBody.thread_name} JSON body property is not specified
 	 */
 	thread_id?: Snowflake;
 }

rest/v9/channel.ts

@@ -64,7 +64,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	/**
 	 * Whether the channel is nsfw
 	 *
-	 * Channel types: text, news
+	 * Channel types: text, voice, news
 	 */
 	nsfw?: boolean | null;
 	/**
@@ -96,7 +96,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	/**
 	 * ID of the new parent category for a channel
 	 *
-	 * Channel types: text, news, voice
+	 * Channel types: text, voice, news
 	 */
 	parent_id?: Snowflake | null;
 	/**
@@ -598,13 +598,22 @@ export type RESTPostAPIChannelMessagesThreadsJSONBody = AddUndefinedToPossiblyUn
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-in-forum-channel
  */
-export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThreadsJSONBody &
-	RESTPostAPIChannelMessageJSONBody;
+export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThreadsJSONBody & {
+	/**
+	 * First message in the forum thread
+	 */
+	message: RESTPostAPIChannelMessageJSONBody;
+};
 
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-in-forum-channel
  */
-export type RESTPostAPIGuildForumThreadsFormDataBody = RESTPostAPIChannelMessageFormDataBody;
+export type RESTPostAPIGuildForumThreadsFormDataBody = RESTPostAPIChannelMessagesThreadsJSONBody & {
+	/**
+	 * First message in the forum thread
+	 */
+	message: string;
+};
 
 /**
  * https://discord.com/developers/docs/resources/channel#start-thread-from-message

rest/v9/guild.ts

@@ -18,6 +18,7 @@ import type {
 	GuildDefaultMessageNotifications,
 	GuildExplicitContentFilter,
 	GuildFeature,
+	GuildMFALevel,
 	GuildSystemChannelFlags,
 	GuildVerificationLevel,
 	GuildWidgetStyle,
@@ -41,7 +42,17 @@ export type APIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGr
 export type APIGuildCreatePartialChannel = StrictPartial<
 	DistributivePick<
 		APIGuildChannelResolvable,
-		'type' | 'topic' | 'nsfw' | 'bitrate' | 'user_limit' | 'rate_limit_per_user' | 'default_auto_archive_duration'
+		| 'type'
+		| 'topic'
+		| 'nsfw'
+		| 'bitrate'
+		| 'user_limit'
+		| 'rate_limit_per_user'
+		| 'default_auto_archive_duration'
+		| 'position'
+		| 'rtc_region'
+		| 'video_quality_mode'
+		| 'flags'
 	>
 > &
 	AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
@@ -148,6 +159,23 @@ export type RESTPostAPIGuildsJSONBody = AddUndefinedToPossiblyUndefinedPropertie
  */
 export type RESTPostAPIGuildsResult = APIGuild;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level
+ */
+export interface RESTPostAPIGuildsMFAJSONBody {
+	/**
+	 * MFA level
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-object-mfa-level
+	 */
+	level: GuildMFALevel;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level
+ */
+export type RESTPostAPIGuildsMFAResult = RESTPostAPIGuildsMFAJSONBody;
+
 /**
  * https://discord.com/developers/docs/resources/guild#get-guild
  */
@@ -826,6 +854,9 @@ export type RESTPatchAPIGuildMemberVerificationJSONBody = AddUndefinedToPossibly
 
 export type RESTPatchAPIGuildMemberVerificationResult = APIGuildMembershipScreening;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-current-user-voice-state
+ */
 export type RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
 	/**
 	 * The id of the channel the user is currently in
@@ -841,6 +872,14 @@ export type RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody = AddUndefinedToPos
 	request_to_speak_timestamp?: string | null;
 }>;
 
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-current-user-voice-state
+ */
+export type RESTPatchAPIGuildVoiceStateCurrentMemberResult = never;
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-user-voice-state
+ */
 export type RESTPatchAPIGuildVoiceStateUserJSONBody = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{
 	/**
 	 * The id of the channel the user is currently in
@@ -867,3 +906,8 @@ export type RESTPatchAPIGuildWelcomeScreenJSONBody = Nullable<StrictPartial<APIG
 		 */
 		enabled?: boolean | null;
 	}>;
+
+/**
+ * https://discord.com/developers/docs/resources/guild#modify-guild-welcome-screen
+ */
+export type RESTPatchAPIGuildWelcomeScreenResult = APIGuildWelcomeScreen;

rest/v9/index.ts

@@ -274,6 +274,14 @@ export const Routes = {
 		return `/guilds/${guildId}/members/${memberId}/roles/${roleId}` as const;
 	},
 
+	/**
+	 * Route for:
+	 * - POST `/guilds/{guild.id}/mfa`
+	 */
+	guildMFA(guildId: Snowflake) {
+		return `/guilds/${guildId}/mfa` as const;
+	},
+
 	/**
 	 * Route for:
 	 * - GET `/guilds/{guild.id}/bans`
@@ -845,6 +853,262 @@ export const Routes = {
 	},
 };
 
+export const StickerPackApplicationId = '710982414301790216';
+
+export const CDNRoutes = {
+	/**
+	 * Route for:
+	 * - GET `/emojis/{emoji.id}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	emoji(emojiId: Snowflake, format: EmojiFormat) {
+		return `/emojis/${emojiId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/{guild.id}/icons/{guild.id}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildIcon(guildId: Snowflake, guildIcon: string, format: GuildIconFormat) {
+		return `icons/${guildId}/${guildIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/splashes/{guild.id}/{guild.splash}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildSplash(guildId: Snowflake, guildSplash: string, format: GuildSplashFormat) {
+		return `/splashes/${guildId}/${guildSplash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/discovery-splashes/{guild.id}/{guild.discovery_splash}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildDiscoverySplash(guildId: Snowflake, guildDiscoverySplash: string, format: GuildDiscoverySplashFormat) {
+		return `/discovery-splashes/${guildId}/${guildDiscoverySplash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/banners/{guild.id}/{guild.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildBanner(guildId: Snowflake, guildBanner: string, format: GuildBannerFormat) {
+		return `/banners/${guildId}/${guildBanner}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/banners/{user.id}/{user.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	userBanner(userId: Snowflake, userBanner: string, format: UserBannerFormat) {
+		return `/banners/${userId}/${userBanner}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/embed/avatars/{user.discriminator % 5}.png`
+	 *
+	 * The `userDiscriminator` parameter should be the user discriminator modulo 5 (e.g. 1337 % 5 = 2)
+	 *
+	 * This route supports the extension: PNG
+	 */
+	defaultUserAvatar(userDiscriminator: DefaultUserAvatarAssets) {
+		return `/embed/avatars/${userDiscriminator}.png` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/avatars/{user.id}/{user.avatar}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	userAvatar(userId: Snowflake, userAvatar: string, format: UserAvatarFormat) {
+		return `/avatars/${userId}/${userAvatar}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/{guild.id}/users/{user.id}/{guild_member.avatar}.{png|jpeg|webp|gif}`
+	 *
+	 * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildMemberAvatar(guildId: Snowflake, userId: Snowflake, memberAvatar: string, format: GuildMemberAvatarFormat) {
+		return `/guilds/${guildId}/users/${userId}/avatars/${memberAvatar}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationIcon(applicationId: Snowflake, applicationIcon: string, format: ApplicationIconFormat) {
+		return `/app-icons/${applicationId}/${applicationIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.cover_image}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationCover(applicationId: Snowflake, applicationCoverImage: string, format: ApplicationCoverFormat) {
+		return `/app-icons/${applicationId}/${applicationCoverImage}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-icons/{application.id}/{application.asset_id}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	applicationAsset(applicationId: Snowflake, applicationAssetId: string, format: ApplicationAssetFormat) {
+		return `/app-icons/${applicationId}/${applicationAssetId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-assets/{application.id}/achievements/{achievement.id}/icons/{achievement.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	achievementIcon(
+		applicationId: Snowflake,
+		achievementId: Snowflake,
+		achievementIconHash: string,
+		format: AchievementIconFormat,
+	) {
+		return `/app-assets/${applicationId}/achievements/${achievementId}/icons/${achievementIconHash}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/app-assets/710982414301790216/store/{sticker_pack.banner.asset_id}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	stickerPackBanner(stickerPackBannerAssetId: Snowflake, format: StickerPackBannerFormat) {
+		return `/app-assets/${StickerPackApplicationId}/store/${stickerPackBannerAssetId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `team-icons/{team.id}/{team.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	teamIcon(teamId: Snowflake, teamIcon: string, format: TeamIconFormat) {
+		return `/team-icons/${teamId}/${teamIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/stickers/{sticker.id}.{png|json}`
+	 *
+	 * This route supports the extensions: PNG, Lottie
+	 */
+	sticker(stickerId: Snowflake, format: StickerFormat) {
+		return `/stickers/${stickerId}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/role-icons/{role.id}/{role.icon}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	roleIcon(roleId: Snowflake, roleIcon: string, format: RoleIconFormat) {
+		return `/role-icons/${roleId}/${roleIcon}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guild-events/{guild_scheduled_event.id}/{guild_scheduled_event.image}.{png|jpeg|webp}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP
+	 */
+	guildScheduledEventCover(
+		guildScheduledEventId: Snowflake,
+		guildScheduledEventCoverImage: string,
+		format: GuildScheduledEventCoverFormat,
+	) {
+		return `/guild-events/${guildScheduledEventId}/${guildScheduledEventCoverImage}.${format}` as const;
+	},
+
+	/**
+	 * Route for:
+	 * - GET `/guilds/${guild.id}/users/${user.id}/banners/${guild_member.banner}.{png|jpeg|webp|gif}`
+	 *
+	 * This route supports the extensions: PNG, JPEG, WebP, GIF
+	 */
+	guildMemberBanner(guildId: Snowflake, userId: Snowflake, guildMemberBanner: string, format: GuildMemberBannerFormat) {
+		return `/guilds/${guildId}/users/${userId}/banners/${guildMemberBanner}.${format}` as const;
+	},
+};
+
+export type DefaultUserAvatarAssets = 0 | 1 | 2 | 3 | 4 | 5;
+
+export type EmojiFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildIconFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildSplashFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildDiscoverySplashFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type UserBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type DefaultUserAvatar = Extract<ImageFormat, ImageFormat.PNG>;
+export type UserAvatarFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type GuildMemberAvatarFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+export type ApplicationIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type ApplicationCoverFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type ApplicationAssetFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type AchievementIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type StickerPackBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type TeamIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type StickerFormat = Extract<ImageFormat, ImageFormat.PNG | ImageFormat.Lottie>;
+export type RoleIconFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildScheduledEventCoverFormat = Exclude<ImageFormat, ImageFormat.Lottie | ImageFormat.GIF>;
+export type GuildMemberBannerFormat = Exclude<ImageFormat, ImageFormat.Lottie>;
+
+export enum ImageFormat {
+	JPEG = 'jpeg',
+	PNG = 'png',
+	WebP = 'webp',
+	GIF = 'gif',
+	Lottie = 'json',
+}
+
+export interface CDNQuery {
+	/**
+	 * The returned image can have the size changed by using this query parameter
+	 *
+	 * Image size can be any power of two between 16 and 4096
+	 */
+	size?: number;
+}
+
 export const RouteBases = {
 	api: `https://discord.com/api/v${APIVersion}`,
 	cdn: 'https://cdn.discordapp.com',

rest/v9/interactions.ts

@@ -37,7 +37,9 @@ type RESTPostAPIBaseApplicationCommandsJSONBody = AddUndefinedToPossiblyUndefine
 		| 'guild_id'
 		| 'name_localized'
 		| 'description_localized'
-	>
+		| 'default_member_permissions'
+	> &
+		Partial<Pick<APIApplicationCommand, 'default_member_permissions'>>
 >;
 
 /**
@@ -91,42 +93,50 @@ export type RESTPutAPIApplicationCommandsResult = APIApplicationCommand[];
 /**
  * https://discord.com/developers/docs/interactions/application-commands#get-guild-application-commands
  */
-export type RESTGetAPIApplicationGuildCommandsResult = APIApplicationCommand[];
+export type RESTGetAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>[];
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#get-guild-application-commands
  */
-export type RESTGetAPIApplicationGuildCommandResult = APIApplicationCommand;
+export type RESTGetAPIApplicationGuildCommandResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#create-guild-application-command
  */
-export type RESTPostAPIApplicationGuildCommandsJSONBody = RESTPostAPIApplicationCommandsJSONBody;
+export type RESTPostAPIApplicationGuildCommandsJSONBody =
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#create-guild-application-command
  */
-export type RESTPostAPIApplicationGuildCommandsResult = APIApplicationCommand;
+export type RESTPostAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command
  */
-export type RESTPatchAPIApplicationGuildCommandJSONBody = StrictPartial<RESTPostAPIApplicationCommandsJSONBody>;
+export type RESTPatchAPIApplicationGuildCommandJSONBody = StrictPartial<
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>
+>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command
  */
-export type RESTPatchAPIApplicationGuildCommandResult = APIApplicationCommand;
+export type RESTPatchAPIApplicationGuildCommandResult = Omit<APIApplicationCommand, 'dm_permission'>;
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-guild-application-commands
  */
-export type RESTPutAPIApplicationGuildCommandsJSONBody = RESTPostAPIApplicationCommandsJSONBody[];
+export type RESTPutAPIApplicationGuildCommandsJSONBody = (
+	| Omit<RESTPostAPIChatInputApplicationCommandsJSONBody, 'dm_permission'>
+	| Omit<RESTPostAPIContextMenuApplicationCommandsJSONBody, 'dm_permission'>
+)[];
 
 /**
  * https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-guild-application-commands
  */
-export type RESTPutAPIApplicationGuildCommandsResult = APIApplicationCommand[];
+export type RESTPutAPIApplicationGuildCommandsResult = Omit<APIApplicationCommand, 'dm_permission'>[];
 
 /**
  * https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response

rest/v9/webhook.ts

@@ -144,6 +144,12 @@ export type RESTPostAPIWebhookWithTokenJSONBody = AddUndefinedToPossiblyUndefine
 	 * Message flags combined as a bitfield
 	 */
 	flags?: MessageFlags;
+	/**
+	 * Name of thread to create
+	 *
+	 * Available only if the webhook is in a forum channel and a thread is not specified in {@link RESTPostAPIWebhookWithTokenQuery.thread_id} query parameter
+	 */
+	thread_name?: string;
 }>;
 
 /**
@@ -171,6 +177,8 @@ export interface RESTPostAPIWebhookWithTokenQuery {
 	wait?: boolean;
 	/**
 	 * Send a message to the specified thread within a webhook's channel. The thread will automatically be unarchived.
+	 *
+	 * Available only if the {@link RESTPostAPIWebhookWithTokenJSONBody.thread_name} JSON body property is not specified
 	 */
 	thread_id?: Snowflake;
 }

scripts/actions/create-release.mjs

@@ -5,6 +5,10 @@ import { Octokit } from '@octokit/action';
 const packageJson = JSON.parse(await readFile(new URL('../../package.json', import.meta.url), { encoding: 'utf8' }));
 const octokit = new Octokit();
 const [OWNER, REPOSITORY] = process.env.GITHUB_REPOSITORY.split('/');
+const prPattern = new RegExp(
+	`\\(\\[#(?<prNumber>\\d+)\\]\\(https:\\/\\/github\\.com\\/${OWNER}\\/${REPOSITORY}\\/(?:issues|pulls)\\/(?:\\d+)\\)\\)`,
+	'gi',
+);
 
 console.log('👀 Getting the previous release version');
 const previousReleases = await octokit.repos.listReleases({
@@ -19,6 +23,8 @@ console.log('👀 Previous release version:', previousRelease?.tag_name);
 const releaseChangelog = [];
 const changelogContent = await readFile(new URL('../../CHANGELOG.md', import.meta.url), { encoding: 'utf8' });
 
+let contentToParseAndAdd = '';
+
 if (previousRelease) {
 	// find difference between previous release and current version
 	const maybeMinorIndex = changelogContent.indexOf(`## [${previousRelease.tag_name}](https://github.com`);
@@ -26,14 +32,32 @@ if (previousRelease) {
 	if (maybeMinorIndex === -1) {
 		// find major version
 		const maybeMajorIndex = changelogContent.indexOf(`# [${previousRelease.tag_name}](https://github.com`);
-		releaseChangelog.push(changelogContent.slice(0, maybeMajorIndex));
+		contentToParseAndAdd = changelogContent.slice(0, maybeMajorIndex);
 	} else {
-		releaseChangelog.push(changelogContent.slice(0, maybeMinorIndex));
+		contentToParseAndAdd = changelogContent.slice(0, maybeMinorIndex);
 	}
 } else {
-	releaseChangelog.push(changelogContent);
+	contentToParseAndAdd = changelogContent;
 }
 
+for (const [input, prNumber] of contentToParseAndAdd.matchAll(prPattern)) {
+	try {
+		const prData = await octokit.pulls.get({
+			owner: OWNER,
+			repo: REPOSITORY,
+			pull_number: Number(prNumber),
+		});
+
+		const replaced = input.replace('))', `) by @${prData.data.user?.login ?? 'ghost'})`);
+
+		contentToParseAndAdd = contentToParseAndAdd.replace(input, replaced);
+	} catch (err) {
+		console.error(`Failed to fetch PR #${prNumber}`, err);
+	}
+}
+
+releaseChangelog.push(contentToParseAndAdd);
+
 const { data } = await octokit.repos.generateReleaseNotes({
 	owner: OWNER,
 	repo: REPOSITORY,

scripts/bump-website-version.mjs

@@ -0,0 +1,36 @@
+/* eslint-disable @typescript-eslint/restrict-template-expressions, @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+import { execSync } from 'node:child_process';
+import { readFile, rm, writeFile } from 'node:fs/promises';
+
+const cwd = new URL('../website/', import.meta.url);
+const json = JSON.parse(await readFile(new URL('../package.json', import.meta.url), { encoding: 'utf8' }));
+
+console.log(`⌛ Creating website version for ${json.version}`);
+
+execSync(`npm run docusaurus docs:version ${json.version}`, { cwd, encoding: 'utf8' });
+execSync(`npm run docusaurus api:version ${json.version}`, { cwd, encoding: 'utf8' });
+
+const bigJsonPath = new URL(`../website/versioned_docs/version-${json.version}/api-typedoc.json`, import.meta.url);
+
+const parsed = JSON.parse(await readFile(bigJsonPath, { encoding: 'utf8' }));
+
+await writeFile(bigJsonPath, JSON.stringify(parsed));
+
+console.log(`✅ Website version created for ${json.version}`);
+
+const versionsJsonPath = new URL('./versions.json', cwd);
+
+/** @type {string[]} */
+const allVersions = JSON.parse(await readFile(versionsJsonPath, 'utf8'));
+
+const versionToDelete = allVersions.pop();
+
+await writeFile(versionsJsonPath, JSON.stringify(allVersions, null, 2));
+
+await rm(new URL(`./versioned_docs/version-${versionToDelete}`, cwd), { force: true, recursive: true });
+await rm(new URL(`./versioned_sidebars/version-${versionToDelete}-sidebars.json`, cwd), {
+	force: true,
+	recursive: true,
+});
+
+console.log(`♻️ Removed old website version ${versionToDelete}`);

tsconfig.eslint.json

@@ -17,6 +17,7 @@
 		"voice/**/*.ts",
 		"scripts",
 		"deno",
-		"tests/**/*.ts"
+		"tests/**/*.ts",
+		"website"
 	]
 }

utils/internals.ts

@@ -7,7 +7,9 @@ export type Nullable<T> = {
  * (since JSON.stringify ignores undefined properties)
  */
 export type AddUndefinedToPossiblyUndefinedPropertiesOfInterface<Base> = {
-	[K in keyof Base]: Base[K] extends Exclude<Base[K], undefined> ? Base[K] : Base[K] | undefined;
+	[K in keyof Base]: Base[K] extends Exclude<Base[K], undefined>
+		? AddUndefinedToPossiblyUndefinedPropertiesOfInterface<Base[K]>
+		: AddUndefinedToPossiblyUndefinedPropertiesOfInterface<Base[K]> | undefined;
 };
 
 export type StrictPartial<Base> = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<Partial<Base>>;

website/.editorconfig

@@ -0,0 +1,22 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{js,mjs,ts}]
+indent_size = 4
+indent_style = tab
+block_comment_start = /*
+block_comment = *
+block_comment_end = */
+
+[*.{yml,yaml}]
+indent_size = 2
+indent_style = space
+
+[*.{md,rmd,mkd,mkdn,mdwn,mdown,markdown,litcoffee}]
+tab_width = 4
+trim_trailing_whitespace = false

website/.eslintignore

@@ -0,0 +1,13 @@
+# Node modules
+node_modules/
+
+# Submodules
+projects/
+
+# Generated data
+docs/Documentation/
+.docusaurus/
+
+src/index.d.ts
+
+docs/Guide/code/

website/.eslintrc

@@ -0,0 +1,141 @@
+{
+	"root": true,
+	"extends": ["marine/prettier/react", "plugin:import/typescript"],
+	"parserOptions": {
+		"ecmaVersion": 2020,
+		"sourceType": "module",
+		"ecmaFeatures": {
+			"jsx": true
+		},
+		"jsx": true,
+		"project": "./tsconfig.eslint.json"
+	},
+	"plugins": ["import", "jsx-a11y", "react", "react-hooks"],
+	"settings": {
+		"react": {
+			"version": "detect"
+		}
+	},
+	"overrides": [
+		{
+			"files": ["docusaurus.config.js", "babel.config.js", "sidebars.js"],
+			"rules": {
+				"@typescript-eslint/no-var-requires": "off",
+				"@typescript-eslint/ban-ts-comment": "off",
+				"@typescript-eslint/no-require-imports": "off"
+			}
+		}
+	],
+	"rules": {
+		"no-extra-label": "warn",
+		"no-iterator": "warn",
+		"no-label-var": "warn",
+		"no-labels": [
+			"warn",
+			{
+				"allowLoop": true,
+				"allowSwitch": true
+			}
+		],
+		"no-lone-blocks": "warn",
+		"no-loop-func": "warn",
+		"no-mixed-operators": [
+			"warn",
+			{
+				"groups": [
+					["&", "|", "^", "~", "<<", ">>", ">>>"],
+					["==", "!=", "===", "!==", ">", ">=", "<", "<="],
+					["&&", "||"],
+					["in", "instanceof"]
+				],
+				"allowSamePrecedence": false
+			}
+		],
+		"no-multi-str": "warn",
+		"rest-spread-spacing": ["warn", "never"],
+		"no-restricted-properties": [
+			"error",
+			{
+				"object": "require",
+				"property": "ensure",
+				"message": "Please use import() instead. More info: https://facebook.github.io/create-react-app/docs/code-splitting"
+			},
+			{
+				"object": "System",
+				"property": "import",
+				"message": "Please use import() instead. More info: https://facebook.github.io/create-react-app/docs/code-splitting"
+			}
+		],
+		"getter-return": "warn",
+		"import/first": "error",
+		"import/no-amd": "error",
+		"import/no-webpack-loader-syntax": "error",
+		"react/forbid-foreign-prop-types": [
+			"warn",
+			{
+				"allowInPropTypes": true
+			}
+		],
+		"react/jsx-no-comment-textnodes": "warn",
+		"react/jsx-no-duplicate-props": "warn",
+		"react/jsx-no-target-blank": "warn",
+		"react/jsx-no-undef": "error",
+		"react/jsx-pascal-case": [
+			"warn",
+			{
+				"allowAllCaps": true,
+				"ignore": []
+			}
+		],
+		"react/jsx-uses-react": "warn",
+		"react/jsx-uses-vars": "warn",
+		"react/no-children-prop": "warn",
+		"react/no-access-state-in-setstate": "warn",
+		"react/no-danger": "error",
+		"react/no-danger-with-children": "warn",
+		"react/no-direct-mutation-state": "warn",
+		"react/no-is-mounted": "warn",
+		"react/no-this-in-sfc": "warn",
+		"react/no-typos": "error",
+		"react/react-in-jsx-scope": "error",
+		"react/require-render-return": "error",
+		"react/style-prop-object": "warn",
+		"react/void-dom-elements-no-children": "warn",
+		"react/jsx-filename-extension": [
+			"error",
+			{
+				"extensions": [".jsx", ".tsx"]
+			}
+		],
+		"jsx-a11y/accessible-emoji": "warn",
+		"jsx-a11y/alt-text": "warn",
+		"jsx-a11y/anchor-has-content": "warn",
+		"jsx-a11y/anchor-is-valid": [
+			"warn",
+			{
+				"aspects": ["noHref", "invalidHref"]
+			}
+		],
+		"jsx-a11y/aria-activedescendant-has-tabindex": "warn",
+		"jsx-a11y/aria-props": "warn",
+		"jsx-a11y/aria-proptypes": "warn",
+		"jsx-a11y/aria-role": [
+			"warn",
+			{
+				"ignoreNonDOM": true
+			}
+		],
+		"jsx-a11y/aria-unsupported-elements": "warn",
+		"jsx-a11y/heading-has-content": "warn",
+		"jsx-a11y/iframe-has-title": "warn",
+		"jsx-a11y/img-redundant-alt": "warn",
+		"jsx-a11y/no-access-key": "warn",
+		"jsx-a11y/no-distracting-elements": "warn",
+		"jsx-a11y/no-redundant-roles": "warn",
+		"jsx-a11y/role-has-required-aria-props": "warn",
+		"jsx-a11y/role-supports-aria-props": "warn",
+		"jsx-a11y/scope": "warn",
+		"react-hooks/exhaustive-deps": "warn",
+		"react-hooks/rules-of-hooks": "error"
+	}
+}

website/.gitignore

@@ -0,0 +1,33 @@
+# Dependencies
+node_modules/
+.pnp/
+
+# Yarn files
+.yarn/install-state.gz
+.yarn/build-state.yml
+
+# Production
+build/
+
+# Generated Files
+.docusaurus/
+.cache-loader/
+docs/Documentation/
+tsconfig.tsbuildinfo
+
+# misc
+.DS_Store
+Thumbs.db
+
+# Local env vars
+.env
+
+# IDE Settings
+.idea/
+.vs/
+
+# Log files
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+*.log

website/.markdownlint-cli2.jsonc

@@ -0,0 +1,14 @@
+{
+	"config": {
+		"default": false,
+		"MD001": true,
+		"MD003": true,
+		"MD009": true,
+		"MD011": true,
+		"MD012": true,
+		"MD013": {
+			"line_length": 120
+		}
+	},
+	"globs": ["docs/**/*.{md,mdx}"]
+}

website/.npmrc

@@ -0,0 +1,2 @@
+# REMOVE ME ONCE NEXT BETA OF DOCUSAURUS IS OUT
+force=true

website/.prettierignore

@@ -0,0 +1,10 @@
+# Node modules
+node_modules/
+
+# Generated data
+.docusaurus/
+
+# Versioned json
+versioned_sidebars/
+versioned_docs/
+versions.json

website/.prettierrc.js

@@ -0,0 +1,17 @@
+const sapphirePrettierConfig = require('@sapphire/prettier-config');
+
+module.exports = {
+	...sapphirePrettierConfig,
+	overrides: [
+		...sapphirePrettierConfig.overrides,
+		{
+			files: ['README.md', 'docs/**/*.mdx', 'docs/**/*.md'],
+			options: {
+				tabWidth: 2,
+				useTabs: false,
+				printWidth: 120,
+				proseWrap: 'always'
+			}
+		}
+	]
+};

website/.vscode/extensions.json

@@ -0,0 +1,13 @@
+{
+	"recommendations": [
+		"bierner.github-markdown-preview",
+		"christian-kohler.path-intellisense",
+		"davidanson.vscode-markdownlint",
+		"dbaeumer.vscode-eslint",
+		"esbenp.prettier-vscode",
+		"mdickin.markdown-shortcuts",
+		"silvenon.mdx",
+		"streetsidesoftware.code-spell-checker",
+		"usernamehw.errorlens"
+	]
+}

website/.vscode/settings.json

@@ -0,0 +1,19 @@
+{
+	"editor.detectIndentation": true,
+	"files.eol": "\n",
+	"files.associations": {
+		"*.mdx": "markdown"
+	},
+	"cSpell.language": "en-US",
+	"cSpell.maxNumberOfProblems": 8,
+	"cSpell.numSuggestions": 24,
+	"search.exclude": {
+		"**/.docusaurus/": true,
+		"**/.git/": true,
+		"**/.yarn": true,
+		"**/*.code-search": true,
+		"**/bower_components": true,
+		"**/node_modules": true,
+		"**/projects/": true
+	}
+}

website/LICENSE.md

@@ -0,0 +1,24 @@
+# The MIT License (MIT)
+
+Copyright © `2020` `The Sapphire Community and its contributors`
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the “Software”), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

website/README.md

@@ -0,0 +1,27 @@
+<div align="center">
+
+# Discord API Types Website
+
+**Source code for the Discord API Types website.**
+
+_Code is forked from the Sapphire Community's Website under the MIT license_
+
+[![GitHub](https://img.shields.io/github/license/discordjs/discord-api-types)](https://github.com/discordjs/discord-api-types/blob/main/website/LICENSE.md)
+
+</div>
+
+## Running locally
+
+After forking/cloning this repo to a folder locally:
+
+1. Install dependencies with `npm ci`.
+2. Run `npm run start` to start the dev server
+
+## Special thanks
+
+This project is being hosted by the amazing team at [Vercel]. We use their service to ensure you always get the latest
+version of the documentation, as well as being able to preview builds internally. Thank you [Vercel]!
+
+[![Vercel](./static/powered-by-vercel.svg)][vercel]
+
+[vercel]: https://vercel.com?utm_source=discordjs&utm_campaign=oss

website/THIRD_PARTY_LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Facebook, Inc. and its affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

website/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+	presets: [require.resolve('@docusaurus/core/lib/babel/preset')]
+};

website/docs/Contributing.mdx

@@ -0,0 +1,263 @@
+---
+id: contributing_to_discord-api-types
+title: How to Contribute
+sidebar_position: 1
+---
+
+So, you'd like to contribute to `discord-api-types` but don't know where to start or what to do? Here are some of the
+things you need to keep in mind before opening a pull request!
+
+:::tip Before you begin
+
+We recommend you contribute either through locally editing the files on your desktop (which means also installing
+[`npm`](https://www.npmjs.com/) dependencies as this will ensure not only a consistent code style, but also that the
+`deno` types stay in sync automatically) or through a service like
+[`GitHub Codespaces`](https://github.com/features/codespaces).
+
+:::
+
+:::info Still can't figure it out?
+
+No problem! We await you with open hands in our [`Discord Server`](https://discord.gg/djs) in the `#discord-api-types`
+channel (under the `Miscellaneous` category)
+
+:::
+
+### Install npm dependencies first
+
+One of the most crucial steps is installing [`npm`](https://www.npmjs.com/) dependencies via `npm ci`. This ensures that
+linting can be done, and it also sets up the `git` hooks for building the `deno` types and automatically
+formatting/linting the code when you commit it.
+
+If you forget to install [`npm`](https://www.npmjs.com/) dependencies, or are doing the contributions through other
+means (like directly from GitHub web), you might see a comment like this one being sent as a review to your pull
+request:
+
+![An image showing the style of comment the automatic deno checker reports](./images/deno_types_out_of_sync.png)
+
+The easiest way to solve this is to run the `build:deno` script (`npm run build:deno`) and pushing the results.
+
+### Figure out if the update you want to contribute respects our rules about documentation
+
+:::danger
+
+We will not document client-only / client related types. If you plan on contributing, make sure the types you want to
+document can be used by bots and are _intended_ for usage by bots. This is a hard rule that will never change.
+
+:::
+
+Not every single update to the API is valid to be documented here. Our main stance for documentation is that properties
+must be known and documented on [`Discord's API Documentation repository`](https://github.com/discord/discord-api-docs),
+must be mentioned in an open pull request or must have received the green light to be used.
+
+With that aside, there are times where documentation for certain types is not approved/merged by Discord on the grounds
+that `it isn't helpful for bots` (or similar), but it would actually benefit bot developers to have it documented (one
+good example is the UserFlags `SPAMMER` flag). As such, if you think your update should still be merged, please propose
+it and we will be handled on a case by case basis. If approved, your update will be documented with an `@unstable` tag.
+It will also not be subject to the same versioning rules as the rest of the types.
+
+### Figure out what API versions need to receive the update
+
+`discord-api-types` has multiple API versions in the repository, some of which may be considered `deprecated` or
+`discontinued` as we keep them till the version is completely dead before removing them. This is a good time to figure
+out which API versions need to be updated, and you can use the table below to guide you.
+
+You can also check [`Discord's API versioning table`](https://discord.com/developers/docs/reference#api-versioning) if
+you want to be 1000% sure.
+
+| **API Version** | **Should receive updates** |
+| :-------------: | :------------------------: |
+|       10        |            Yes             |
+|        9        |            Yes             |
+|        8        |             No             |
+|        7        |             No             |
+|        6        |             No             |
+
+If the version you want to contribute to is not listed above (for instance if a new API version rolls out) or if the
+version you want to contribute to is for a different part of the API (for instance `voice`), feel free to submit it and
+we will review it accordingly.
+
+### Figure out where exactly are the files you need to modify to make the update
+
+The file structure might seem confusing at first, especially if it's your first time contributing, but we're here to
+guide you through it.
+
+When you clone the repository for the first time, you'll see a folder structure like this (we've not mentioned some
+tooling specific files like `.eslintrc.json` to keep the structure clean). We've highlighted the important folders and
+files you need to keep in mind when contributing.
+
+```bash {2,4-6,9-10,12-16}
+├── deno
+├── gateway
+├── node_modules (once you ran `npm ci`)
+├── payloads
+├── rest
+├── rpc
+├── scripts
+├── tests
+├── utils
+├── voice
+├── website
+├── globals.ts
+├── v6.ts
+├── v8.ts
+├── v9.ts
+├── v10.ts
+└── package.json
+```
+
+#### `deno`
+
+This folder stores the [`deno`](https://deno.land/) compatible typings for Discord's API.
+
+:::danger
+
+This folder should not be manually modified. Any manual changes will be overwritten by the `build:deno` script.
+
+Any changes that need to be done to this folder need to be done through the `scripts/deno.mjs` file.
+
+:::
+
+#### `gateway`
+
+This folder holds types that are strictly received from
+[`Discord's gateway`](https://discord.com/developers/docs/topics/gateway). It stores the gateway version the types are
+for, the intents and opcodes, and any data that can be received/sent through the gateway.
+
+Each file in the folder represents a gateway version. It references types from the versioned [`payloads`](#payloads)
+folder unless the payloads come _only_ through the gateway. There is also a `common.ts` file which represents shared
+types across all versions, as well as an `index.ts` file that exports the recommended gateway version's types.
+
+:::info
+
+Types created here must start with the `Gateway` prefix (for instance `GatewayGuildCreateDispatchData` which is an
+extension of the `APIGuild` type with extra fields received only through the gateway).
+
+:::
+
+#### `payloads`
+
+This folder holds the bulk of type definitions for Discord's APIs. Each API version receives its own folder. Inside of
+each folder there is always an `index.ts` file that exports every type available in that version, as well as the common
+types that can be found in `payloads/common.ts`. At the root of the `payloads` folder is also an `index.ts` file which
+exports the recommended API version's types.
+
+Inside of each versioned folder, the files are defined from the structure in
+[`Discord's API Documentation`](https://discord.dev), under the `Resources` category. Depending on the complexity of the
+resource, you may opt for splitting it up into multiple files. If you want to do so, please create a folder named
+`_{resource_name}` where the `resource_name` is the same name as the resource you're splitting up (a good example is the
+`_interactions` folder which stores all the types for interactions in a neater structure), and create a
+`{resource_name}.ts` file which exports everything from that folder). If you feel like you need to split it up even
+more, just repeat the same structure of creating an `_{file_name}` folder and exporting everything from it in the
+`{file_name}.ts` file (you can see an example
+[here](https://github.com/discordjs/discord-api-types/tree/85802f1/payloads/v10/_interactions)).
+
+:::info
+
+Types created here must start with the `API` prefix (for instance `APIUser`), **except** for enums, which should have a
+normal name (for instance `UserFlags`).
+
+:::
+
+#### `rest`
+
+This folder holds all the types that are related to Discord's REST API. Just like [`payloads`](#payloads), it is split
+into folders that have an `index.ts` file, from the structure in [`Discord's API Documentation`](https://discord.dev),
+under the `Resources` category.
+
+:::info
+
+Types created here must start with the `REST` prefix (for instance `RESTGetAPIUserResult`) unless they are objects or
+enums (for instance `Routes`).
+
+They must also follow the following structure: `REST{http_method}{type_name}{Query|(JSON|FormData)Body|Result}`, where:
+
+- `http_method` is the PascalCase HTTP method name (for instance `Get`, `Post`, and so on)
+- `type_name` is the actual name of the type it returns (for instance `APIUser`)
+- `Query|(JSON|FormData)Body|Result` should be used depending on what the route takes or returns
+  - If a route doesn't take in any parameters, be it query, JSON or FormData, it shouldn't define any of those types
+  - A route should always define a `Result` type, and should reference an `API*` type unless the data returned is only
+    received through a REST call
+  - If a route returns a `204 No Content` response, it should define a `Result` type with `never` as its value (this
+    does not account for errors)
+
+This structure should be followed whenever possible, however that might not always be doable. Specifically, types for
+OAuth2 may not follow the structure exactly, but should aim to follow it as much as possible.
+
+:::
+
+#### `rpc`
+
+This folder holds types that are strictly related to
+[`Discord's RPC API`](https://discord.com/developers/docs/topics/rpc). Just like [`gateway`](#gateway), each RPC API
+version receives its own file.
+
+:::info
+
+Types created here must start with the `RPC` prefix (for instance `RPCErrorCodes`).
+
+:::
+
+#### `scripts`
+
+This folder holds the module's scripts that empower our Continuous Integration / Deployment pipelines, as well as other
+miscellaneous scripts we might need. There's really not much to say about these really...
+
+#### `tests`
+
+This folder holds tests for certain complex types that the module might have, and is especially useful for validating
+unions.
+
+:::info
+
+Files created here **must** end in `.test-d.ts`, as otherwise they will not be picked up by
+[`tsd`](https://www.npmjs.com/package/tsd).
+
+:::
+
+#### `utils`
+
+This folder holds certain utility functions which can be used while working with some complicated types (for instance
+for more complicated unions). Each API version gets its own file with utility functions, but a folder can be created if
+a lot of methods are created.
+
+:::info
+
+The `internals.ts` file stores types that are strictly used inside the module to help build out our strict types. These
+types should never be exported from the module.
+
+:::
+
+#### `voice`
+
+This folder holds types that are strictly related to
+[`Discord's Voice API`](https://discord.com/developers/docs/topics/voice-connections). It follows the same folder
+structure as [`gateway`](#gateway).
+
+:::info
+
+Types in this folder must start with the `Voice` prefix (for instance `VoiceOpcodes`).
+
+:::
+
+#### `website`
+
+This folder holds...well...this very site you are reading this page from! For the most part, you do not need to alter
+its contents, except if you're contributing a new API version to the module.
+
+To add the new version to this very website, edit the `docusaurus.config.js` file, and in the `plugins` array, for the
+`docusaurus-plugin-typedoc-api` plugin, you need to add an entry similar to the ones already present.
+
+#### `globals.ts`
+
+This file stores types that are present regardless of the API version you use.
+
+#### `v*.ts`
+
+These files export everything from the previously mentioned folders that match the version the file is named after. It
+serves as the entry point for importing types from the module (for example by importing `discord-api-types/v10`).
+
+#### `package.json`
+
+This is the entry point of the package for [`npm`](https://www.npmjs.com/). You won't need to edit this file unless
+you're adding a new API version, in which case you should follow the same structure as seen in the `exports` field.

website/docs/Introduction.mdx

@@ -0,0 +1,167 @@
+---
+id: introduction_to_discord-api-types
+title: Introduction
+sidebar_position: 0
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+<div align="center">
+
+<img src="/svgs/logo_long_blurple.svg" className="markdown__logo" />
+
+[![Discord server](https://img.shields.io/discord/222078108977594368?color=5865F2&logo=discord&logoColor=white)](https://discord-api-types.dev/discord)
+[![Patreon Donate](https://img.shields.io/badge/patreon-donate-brightgreen.svg?label=Donate%20with%20Patreon&logo=patreon&colorB=F96854&link=https://www.patreon.com/vladfrangu)](https://www.patreon.com/vladfrangu)
+[![Ko-fi Donate](https://img.shields.io/badge/kofi-donate-brightgreen.svg?label=Donate%20with%20Ko-fi&logo=ko-fi&colorB=F16061&link=https://ko-fi.com/wolfgalvlad&logoColor=FFFFFF)](https://ko-fi.com/wolfgalvlad)
+[![GitHub Sponsors](https://img.shields.io/badge/patreon-donate-brightgreen.svg?label=Sponsor%20through%20GitHub&logo=github&colorB=F96854&link=https://github.com/sponsors/vladfrangu)](https://github.com/sponsors/vladfrangu)
+
+[![npm version](https://img.shields.io/npm/v/discord-api-types?color=crimson&label=NPM%20Version&logo=npm)](https://www.npmjs.com/package/discord-api-types)
+[![npm downloads](https://img.shields.io/npm/dt/discord-api-types.svg?label=NPM%20Downloads&logo=npm)](https://www.npmjs.com/package/discord-api-types)
+[![deno](https://img.shields.io/npm/v/discord-api-types?color=blue&label=deno&logo=deno)](https://deno.land/x/discord_api_types)
+
+</div>
+
+## About
+
+Discord API Types is a community-maintained project that brings API types for Discord's REST, Gateway and Voice APIs.
+
+## Installation
+
+Install with [`npm`](https://www.npmjs.com/) / [`yarn`](https://yarnpkg.com) / [`pnpm`](https://pnpm.js.org/):
+
+```bash npm2yarn2pnpm
+npm install discord-api-types
+```
+
+### Usage
+
+You can only import this module by specifying the API version you want to target. Append `/v*` to the import path, where
+the `*` represents the API version. Below are some examples
+
+<Tabs groupId="ts2esm2cjs">
+<TabItem value="javascript" label="JavaScript">
+
+```typescript showLineNumbers
+/**
+ * @type {import('discord-api-types/v10').APIUser}
+ */
+```
+
+</TabItem>
+
+<TabItem value="esm" label="ESM">
+
+```typescript showLineNumbers
+/**
+ * @type {import('discord-api-types/v10').APIUser}
+ */
+```
+
+</TabItem>
+
+<TabItem value="typescript" label="TypeScript">
+
+```typescript showLineNumbers
+import { type APIUser } from 'discord-api-types/v10';
+```
+
+</TabItem>
+
+</Tabs>
+
+:::info
+
+You may also import just certain parts of the module that you need. The possible values are: `globals`, `gateway`,
+`gateway/v*`, `payloads`, `payloads/v*`, `rest`, `rest/v*`, `rpc`, `rpc/v*`, `utils`, `utils/v*`, `voice`, and
+`voice/v*`. Below is an example of importing directly from the gateway submodule
+
+```typescript ts2esm2cjs
+import { GatewayVersion } from 'discord-api-types/gateway/v10';
+
+console.log(`Let's connect to wss://gateway.discord.gg/?v=${GatewayVersion}`);
+```
+
+> _**Note:** The `v*` exports (`discord-api-types/v*`) include the appropriate version of `gateway`, `payloads`, `rest`,
+> `rpc`, and `utils` you specified, alongside the `globals` exports_
+
+:::
+
+### Deno
+
+We also provide typings compatible with the [deno](https://deno.land/) runtime. Here are 3 examples of how you can
+import them:
+
+<Tabs>
+<TabItem value="github" label="From GitHub">
+
+```typescript showLineNumbers
+// Importing a specific API version
+import { APIUser } from 'https://raw.githubusercontent.com/discordjs/discord-api-types/main/deno/v10.ts';
+```
+
+</TabItem>
+
+<TabItem value="deno" label="From deno.land/x" default>
+
+```typescript showLineNumbers
+// Importing a specific API version
+import { APIUser } from 'https://deno.land/x/discord_api_types/v10.ts';
+```
+
+</TabItem>
+
+<TabItem value="skypack" label="From skypack.dev">
+
+```typescript showLineNumbers
+// Importing a specific API version
+import { APIUser } from 'https://cdn.skypack.dev/discord-api-types/v10?dts';
+```
+
+</TabItem>
+
+</Tabs>
+
+## Project Structure
+
+The exports of each API version is split into three main parts:
+
+- Everything exported with the `API` prefix represents a payload you may get from the REST API _or_ the Gateway.
+
+- Everything exported with the `Gateway` prefix represents data that ONLY comes from or is directly related to the
+  Gateway.
+
+- Everything exported with the `REST` prefix represents data that ONLY comes from or is directly related to the REST
+  API.
+
+  - For endpoint options, they will follow the following structure:
+    `REST<HTTP Method><Type><Query|(JSON|FormData)Body|Result>` where the type represents what it will return.
+
+    - For example, `RESTPostAPIChannelMessageJSONBody` or `RESTGetAPIGatewayBotInfoResult`.
+
+    - Some exported types (specifically OAuth2 related ones) may not respect this entire structure due to the nature of
+      the fields. They will start with either `RESTOAuth2` or with something similar to `REST<HTTP Method>OAuth2`
+
+  - If a type ends with `Result`, then it represents the expected result by calling its accompanying route.
+
+    - Types that are exported as `never` usually mean the result will be a `204 No Content`, so you can safely ignore
+      it. This does **not** account for errors.
+
+- Anything else that is miscellaneous will be exported based on what it represents (for example the `REST` route
+  object).
+
+- There may be types exported that are identical for all versions. These will be exported as is and can be found in the
+  `globals` file. They will still be prefixed accordingly as described above.
+
+:::danger A note about how types are documented
+
+This package will add types only for known and documented properties that are present in Discord's
+[API Documentation repository](https://github.com/discord/discord-api-docs), that are mentioned in an open pull request,
+or known through other means _and have received the green light to be used_. Anything else will not be documented (for
+example client only types).
+
+With that aside, we may allow certain types that are not documented in the
+[API Documentation repository](https://github.com/discord/discord-api-docs) on a case by case basis. They will be
+documented with an `@unstable` tag and are not subject with the same versioning rules.
+
+:::