chore(discord.js): release discord.js@13.17.1 (#9955)

* fix(ClientPresence): correctly set activity state on CUSTOM activity type

* Update ClientPresence.js

.cliff-jumperrc.json

@@ -0,0 +1,5 @@
+{
+  "name": "discord.js",
+  "packagePath": ".",
+  "tagTemplate": "{{new-version}}"
+}

.commitlintrc.json

@@ -1,12 +1,11 @@
 {
-	"$schema": "https://json.schemastore.org/commitlintrc.json",
-	"extends": ["@commitlint/config-angular"],
-	"rules": {
-		"type-enum": [
-			2,
-			"always",
-			["chore", "build", "ci", "docs", "feat", "fix", "perf", "refactor", "revert", "style", "test", "types", "typings"]
-		],
-		"scope-case": [0]
-	}
+  "extends": ["@commitlint/config-angular"],
+  "rules": {
+    "type-enum": [
+      2,
+      "always",
+      ["chore", "build", "ci", "docs", "feat", "fix", "perf", "refactor", "revert", "style", "test", "types", "typings"]
+    ],
+    "scope-case": [0]
+  }
 }

.dockerignore

@@ -1,67 +0,0 @@
-# Packages
-**/node_modules
-
-# Log files
-**/logs
-**/*.log
-**/npm-debug.log*
-
-# Runtime data
-**/pids
-**/*.pid
-**/*.seed
-
-# Env
-**/.env
-
-# Dist
-**/dist/
-**/dist-docs/
-
-# Miscellaneous
-**/.tmp
-**/.vscode
-**/.idea
-**/.DS_Store
-**/.turbo
-**/tsconfig.tsbuildinfo
-**/coverage
-**/__tests__
-**/out
-
-# yarn
-.pnp.*
-.yarn/*
-!.yarn/patches
-!.yarn/plugins
-!.yarn/releases
-!.yarn/sdks
-!.yarn/versions
-
-# Cache
-**/.prettiercache
-**/.eslintcache
-**/.vercel
-
-# Docker specific
-**/.cliff-jumperrc.json
-**/api-extractor.json
-**/api-extractor-docs.json
-**/.eslintignore
-**/.eslintrc.json
-**/.lintstagedrc.js
-**/.lintstagedrc.cjs
-**/.lintstagedrc.json
-**/.prettierignore
-**/.prettierrc.js
-**/.prettierrc.cjs
-**/.prettierrc.json
-**/cliff.toml
-**/CHANGELOG.md
-**/README.md
-**/LICENSE
-**/tsconfig.eslint.json
-**/tsconfig.docs.json
-**/docs/
-**/vitest.config.ts
-

.eslintignore

@@ -0,0 +1 @@
+/typings/**/*

.eslintrc.json

@@ -0,0 +1,200 @@
+{
+  "extends": ["eslint:recommended", "plugin:prettier/recommended"],
+  "plugins": ["import"],
+  "parserOptions": {
+    "ecmaVersion": 2021
+  },
+  "env": {
+    "es2021": true,
+    "node": true
+  },
+  "rules": {
+    "import/order": [
+      "error",
+      {
+        "groups": ["builtin", "external", "internal", "index", "sibling", "parent"],
+        "alphabetize": {
+          "order": "asc"
+        }
+      }
+    ],
+    "prettier/prettier": [
+      2,
+      {
+        "printWidth": 120,
+        "singleQuote": true,
+        "quoteProps": "as-needed",
+        "trailingComma": "all",
+        "endOfLine": "lf",
+        "arrowParens": "avoid"
+      }
+    ],
+    "strict": ["error", "global"],
+    "no-await-in-loop": "warn",
+    "no-compare-neg-zero": "error",
+    "no-template-curly-in-string": "error",
+    "no-unsafe-negation": "error",
+    "valid-jsdoc": [
+      "error",
+      {
+        "requireReturn": false,
+        "requireReturnDescription": false,
+        "prefer": {
+          "return": "returns",
+          "arg": "param"
+        },
+        "preferType": {
+          "String": "string",
+          "Number": "number",
+          "Boolean": "boolean",
+          "Symbol": "symbol",
+          "object": "Object",
+          "function": "Function",
+          "array": "Array",
+          "date": "Date",
+          "error": "Error",
+          "null": "void"
+        }
+      }
+    ],
+
+    "accessor-pairs": "warn",
+    "array-callback-return": "error",
+    "consistent-return": "error",
+    "curly": ["error", "multi-line", "consistent"],
+    "dot-location": ["error", "property"],
+    "dot-notation": "error",
+    "eqeqeq": "error",
+    "no-empty-function": "error",
+    "no-floating-decimal": "error",
+    "no-implied-eval": "error",
+    "no-invalid-this": "error",
+    "no-lone-blocks": "error",
+    "no-multi-spaces": "error",
+    "no-new-func": "error",
+    "no-new-wrappers": "error",
+    "no-new": "error",
+    "no-octal-escape": "error",
+    "no-return-assign": "error",
+    "no-return-await": "error",
+    "no-self-compare": "error",
+    "no-sequences": "error",
+    "no-throw-literal": "error",
+    "no-unmodified-loop-condition": "error",
+    "no-unused-expressions": "error",
+    "no-useless-call": "error",
+    "no-useless-concat": "error",
+    "no-useless-escape": "error",
+    "no-useless-return": "error",
+    "no-void": "error",
+    "no-warning-comments": "warn",
+    "prefer-promise-reject-errors": "error",
+    "require-await": "warn",
+    "wrap-iife": "error",
+    "yoda": "error",
+
+    "no-label-var": "error",
+    "no-shadow": "error",
+    "no-undef-init": "error",
+
+    "callback-return": "error",
+    "getter-return": "off",
+    "handle-callback-err": "error",
+    "no-mixed-requires": "error",
+    "no-new-require": "error",
+    "no-path-concat": "error",
+
+    "array-bracket-spacing": "error",
+    "block-spacing": "error",
+    "brace-style": ["error", "1tbs", { "allowSingleLine": true }],
+    "capitalized-comments": ["error", "always", { "ignoreConsecutiveComments": true }],
+    "comma-dangle": ["error", "always-multiline"],
+    "comma-spacing": "error",
+    "comma-style": "error",
+    "computed-property-spacing": "error",
+    "consistent-this": ["error", "$this"],
+    "eol-last": "error",
+    "func-names": "error",
+    "func-name-matching": "error",
+    "func-style": ["error", "declaration", { "allowArrowFunctions": true }],
+    "key-spacing": "error",
+    "keyword-spacing": "error",
+    "max-depth": "error",
+    "max-len": ["error", 120, 2],
+    "max-nested-callbacks": ["error", { "max": 4 }],
+    "max-statements-per-line": ["error", { "max": 2 }],
+    "new-cap": "off",
+    "newline-per-chained-call": ["error", { "ignoreChainWithDepth": 3 }],
+    "no-array-constructor": "error",
+    "no-inline-comments": "error",
+    "no-lonely-if": "error",
+    "no-multiple-empty-lines": ["error", { "max": 2, "maxEOF": 1, "maxBOF": 0 }],
+    "no-new-object": "error",
+    "no-spaced-func": "error",
+    "no-trailing-spaces": "error",
+    "no-unneeded-ternary": "error",
+    "no-whitespace-before-property": "error",
+    "nonblock-statement-body-position": "error",
+    "object-curly-spacing": ["error", "always"],
+    "operator-assignment": "error",
+    "padded-blocks": ["error", "never"],
+    "quote-props": ["error", "as-needed"],
+    "quotes": ["error", "single", { "avoidEscape": true, "allowTemplateLiterals": true }],
+    "semi-spacing": "error",
+    "semi": "error",
+    "space-before-blocks": "error",
+    "space-before-function-paren": [
+      "error",
+      {
+        "anonymous": "never",
+        "named": "never",
+        "asyncArrow": "always"
+      }
+    ],
+    "space-in-parens": "error",
+    "space-infix-ops": "error",
+    "space-unary-ops": "error",
+    "spaced-comment": "error",
+    "template-tag-spacing": "error",
+    "unicode-bom": "error",
+
+    "arrow-body-style": "error",
+    "arrow-parens": ["error", "as-needed"],
+    "arrow-spacing": "error",
+    "no-duplicate-imports": "error",
+    "no-useless-computed-key": "error",
+    "no-useless-constructor": "error",
+    "prefer-arrow-callback": "error",
+    "prefer-numeric-literals": "error",
+    "prefer-rest-params": "error",
+    "prefer-spread": "error",
+    "prefer-template": "error",
+    "rest-spread-spacing": "error",
+    "template-curly-spacing": "error",
+    "yield-star-spacing": "error",
+
+    "no-restricted-globals": [
+      "error",
+      {
+        "name": "Buffer",
+        "message": "Import Buffer from `node:buffer` instead"
+      },
+      {
+        "name": "process",
+        "message": "Import process from `node:process` instead"
+      },
+      {
+        "name": "setTimeout",
+        "message": "Import setTimeout from `node:timers` instead"
+      },
+      {
+        "name": "setInterval",
+        "message": "Import setInterval from `node:timers` instead"
+      },
+      {
+        "name": "setImmediate",
+        "message": "Import setImmediate from `node:timers` instead"
+      }
+    ]
+  }
+}

.github/CODEOWNERS

@@ -1,28 +0,0 @@
-# Learn how to add code owners here:
-# https://help.github.com/en/articles/about-code-owners
-
-* @iCrawl
-
-/apps/guide/ @discordjs/website @discordjs/guide
-/apps/guide/src/content/ @discordjs/guide
-/apps/website/ @discordjs/website
-
-/packages/actions/ @discordjs/actions
-/packages/api-extractor-utils/ @discordjs/api-extractor-utils
-/packages/brokers/ @discordjs/brokers
-/packages/builders/ @discordjs/builders
-/packages/collection/ @discordjs/collection
-/packages/core/ @discordjs/core
-/packages/create-discord-bot/ @discordjs/guide
-/packages/discord.js/ @discordjs/core
-/packages/docgen/ @iCrawl
-/packages/formatters/ @discordjs/formatters
-/packages/next/ @discordjs/core
-/packages/proxy/ @discordjs/proxy
-/packages/proxy-container/ @discordjs/proxy
-/packages/rest/ @discordjs/rest
-/packages/scripts/ @discordjs/scripts
-/packages/ui/ @discordjs/ui
-/packages/util/ @discordjs/util
-/packages/voice/ @discordjs/core
-/packages/ws/ @discordjs/ws

.github/COMMIT_CONVENTION.md

@@ -68,7 +68,7 @@ Other prefixes are up to your discretion. Suggested prefixes are `docs`, `chore`
 
 ### Scope
 
-The scope could be anything specifying the place of the commit change. For example `GuildMember`, `Guild`, `Message`, `TextChannel` etc...
+The scope could be anything specifying the place of the commit change. For example `GuildMember`, `Guild`, `Message`, `MessageEmbed` etc...
 
 ### Subject
 

.github/CONTRIBUTING.md

@@ -11,40 +11,7 @@ is a great boon to your development process.
 To get ready to work on the codebase, please do the following:
 
 1. Fork & clone the repository, and make sure you're on the **main** branch
-2. Run `pnpm install --frozen-lockfile` ([install](https://pnpm.io/installation))
-3. Run `pnpm run build` to build local packages
-4. Code your heart out!
-5. Run `pnpm run test` to run ESLint and ensure any JSDoc changes are valid
-6. [Submit a pull request](https://github.com/discordjs/discord.js/compare) (Make sure you follow the [conventional commit format](https://github.com/discordjs/discord.js/blob/main/.github/COMMIT_CONVENTION.md))
-
-## Testing changes locally
-
-If you want to test changes you've made locally, you can do so by using `pnpm link <package-you-want-to-link-to-your-current-package>`. This will create a symlink to your local copy of the discord.js libraries.
-
-1. Create a new directory `mkdir discordjs-test` and move into it `cd discordjs-test`
-2. Initialize a new pnpm project `pnpm init`
-3. Now link the local discord.js project you cloned earlier `pnpm link {PATH_TO_DISCORDJS_REPO}`
-4. Install packages you'd like to test locally `pnpm add discord.js@latest`, `pnpm add @discordjs/rest@latest`, etc. **Note: Make sure you use `latest` tag or else pnpm will try to install the remote package from npm**
-5. Import the package in your source code and test them out!
-
-### Working with TypeScript packages
-
-When testing local changes, you may notice you need to manually recompile TypeScript projects on every change in order to get the latest code changes to test locally.
-
-To avoid this you can use the `--watch` parameter in the package build script to automatically recompile the project when changes are detected.
-
-For example, to automatically recompile the `@discordjs/rest` project when changes are detected, run `pnpm turbo run build --filter='@discordjs/rest' -- --watch` in the root folder of where you cloned the discord.js repo.
-
-## Adding new packages
-
-If you'd like to create another package under the `@discordjs` organization run the following command:
-
-```sh
-pnpm run create-package <package-name> [package-description]
-```
-
-This will create new package directory under `packages/` with the required configuration files. You may begin
-to make changes within the `src/` directory. You may also need to:
-
-- Update workflows that utilize packages
-- Update the CODEOWNERS file
+2. Run `npm ci`
+3. Code your heart out!
+4. Run `npm test` to run ESLint and ensure any JSDoc changes are valid
+5. [Submit a pull request](https://github.com/discordjs/discord.js/compare) (Make sure you follow the [conventional commit format](https://github.com/discordjs/discord.js/blob/main/.github/COMMIT_CONVENTION.md))

.github/ISSUE_TEMPLATE/01-package_bug_report.yml

@@ -1,137 +0,0 @@
-name: Bug report
-description: Report an issue with discord.js or another package.
-labels: [bug, need repro]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thank you for filing an issue! If you are here to ask a question, use Discord instead: https://discord.gg/djs
-
-        This issue form is for discord.js, including other packages.
-  - type: dropdown
-    id: package
-    attributes:
-      label: Which package is this bug report for?
-      options:
-        - discord.js
-        - brokers
-        - builders
-        - collection
-        - core
-        - create-discord-bot
-        - formatters
-        - next
-        - proxy
-        - proxy-container
-        - rest
-        - ui
-        - util
-        - voice
-        - ws
-    validations:
-      required: true
-  - type: textarea
-    id: description
-    attributes:
-      label: Issue description
-      description: Describe the issue in as much detail as possible.
-      placeholder: |
-        Steps to reproduce with below code sample:
-        1. Do thing
-        2. Do thing in Discord client
-        3. Observe behavior
-        4. See error logs below
-    validations:
-      required: true
-  - type: textarea
-    id: code_sample
-    attributes:
-      label: Code sample
-      description: |
-        Your code sample should be:
-        1. Minimal - Use as little code as possible that still produces the same problem (and is understandable)
-        2. Complete - Provide all parts someone else needs to reproduce your problem
-        3. Reproducible - Test the code you're about to provide to make sure it reproduces the problem
-
-        This will be automatically formatted into code, so no need for backticks.
-      render: typescript
-  - type: textarea
-    id: versions
-    attributes:
-      label: Versions
-      description: List necessary versions here. This includes your package version, runtime version, operating system etc.
-      placeholder: |
-        - discord.js 14.12.1 (`npm ls discord.js` or another package)
-        - Node.js 16.11.0 (`node --version`)
-        - TypeScript 5.1.6 (`npm ls typescript` if you use it)
-        - macOS Ventura 13.3.1
-    validations:
-      required: true
-  - type: dropdown
-    id: priority
-    attributes:
-      label: Issue priority
-      description: Please be realistic. If you need to elaborate on your reasoning, please use the issue description field above.
-      options:
-        - Low (slightly annoying)
-        - Medium (should be fixed soon)
-        - High (immediate attention needed)
-    validations:
-      required: true
-  - type: dropdown
-    id: partials
-    attributes:
-      label: Which partials do you have configured?
-      description: Check your `Client` constructor for the `partials` key.
-      options:
-        - Not applicable
-        - No Partials
-        - User
-        - Channel
-        - GuildMember
-        - Message
-        - Reaction
-        - GuildScheduledEvent
-        - ThreadMember
-      multiple: true
-    validations:
-      required: true
-  - type: dropdown
-    id: intents
-    attributes:
-      label: Which gateway intents are you subscribing to?
-      description: Check your `Client` constructor for the `intents` key.
-      options:
-        - Not applicable
-        - No Intents
-        - Guilds
-        - GuildMembers
-        - GuildModeration
-        - GuildEmojisAndStickers
-        - GuildIntegrations
-        - GuildWebhooks
-        - GuildInvites
-        - GuildVoiceStates
-        - GuildPresences
-        - GuildMessages
-        - GuildMessageReactions
-        - GuildMessageTyping
-        - DirectMessages
-        - DirectMessageReactions
-        - DirectMessageTyping
-        - MessageContent
-        - GuildScheduledEvents
-        - AutoModerationConfiguration
-        - AutoModerationExecution
-      multiple: true
-    validations:
-      required: true
-  - type: input
-    id: dev_release
-    attributes:
-      label: I have tested this issue on a development release
-      placeholder: d23280c (commit hash)
-      description: |
-        The issue might already be fixed in a development release or main. This is not required, but helps us greatly.
-        [discord.js only] To install the latest development release run `npm i discord.js@dev` in your project directory.
-        Run `npm list discord.js` and use the last part of the printed information (`d23280c` for `discord.js@xx.x.x-dev.1530234593.d23280c`)

.github/ISSUE_TEMPLATE/02-application_bug_report.yml

@@ -1,58 +0,0 @@
-name: Websites bug report
-description: Report an issue with the documentation or guide websites.
-labels: [bug, need repro]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thank you for filing an issue! If you are here to ask a question, use Discord instead: https://discord.gg/djs
-
-        This issue form is for our documentation and guide websites.
-  - type: dropdown
-    id: application
-    attributes:
-      label: Which application is this bug report for?
-      options:
-        - Documentation
-        - Guide
-    validations:
-      required: true
-  - type: textarea
-    id: description
-    attributes:
-      label: Issue description
-      description: Describe the issue in as much detail as possible.
-    validations:
-      required: true
-  - type: textarea
-    id: steps_to_reproduce
-    attributes:
-      label: Steps to Reproduce
-      description: What steps must be taken to reproduce this issue?
-      placeholder: |
-        1. Visit a page
-        2. Click a link
-        3. ...
-    validations:
-      required: true
-  - type: textarea
-    id: versions
-    attributes:
-      label: Versions
-      description: List necessary versions here. This includes your browser, operating system etc.
-      placeholder: |
-        - Safari 16.4 (18615.1.26.11.23)
-        - macOS Ventura 13.3.1
-    validations:
-      required: true
-  - type: dropdown
-    id: priority
-    attributes:
-      label: Issue priority
-      description: Please be realistic. If you need to elaborate on your reasoning, please use the issue description field above.
-      options:
-        - Low (slightly annoying)
-        - Medium (should be fixed soon)
-        - High (immediate attention needed)
-    validations:
-      required: true

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,138 @@
+name: Bug report
+description: Report incorrect or unexpected behavior of discord.js
+labels: [bug, need repro]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use Discord for questions: https://discord.gg/djs
+        If you are reporting a voice issue, please post your issue at https://github.com/discordjs/voice/issues
+  - type: textarea
+    id: description
+    attributes:
+      label: Issue description
+      description: |
+        Describe the issue in as much detail as possible.
+
+        Tip: You can attach images or log files by clicking this area to highlight it and then dragging files into it.
+      placeholder: |
+        Steps to reproduce with below code sample:
+        1. do thing
+        2. do thing in Discord client
+        3. observe behavior
+        4. see error logs below
+    validations:
+      required: true
+  - type: textarea
+    id: codesample
+    attributes:
+      label: Code sample
+      description: Include a reproducible, minimal code sample. This will be automatically formatted into code, so no need for backticks.
+      render: typescript
+      placeholder: |
+        const { Client, Intents } = require('discord.js');
+        const client = new Client({ intents: [Intents.FLAGS.GUILDS] });
+
+        client.on('ready', () => {
+          console.log(`Logged in as ${client.user.tag}!`);
+        });
+
+        client.on('interactionCreate', async interaction => {
+          if (!interaction.isCommand()) return;
+
+          if (interaction.commandName === 'ping') {
+            await interaction.reply('Pong!');
+          }
+        });
+
+        client.login('token');
+  - type: input
+    id: djs-version
+    attributes:
+      label: discord.js version
+      description: Which version of discord.js are you using? Run `npm list discord.js` in your project directory and paste the output.
+      placeholder: 13.x.x (we no longer support version 12 or earlier)
+    validations:
+      required: true
+  - type: input
+    id: node-version
+    attributes:
+      label: Node.js version
+      description: |
+        Which version of Node.js are you using? Run `node --version` in your project directory and paste the output.
+        If you are using TypeScript, please include its version (`npm list typescript`) as well.
+      placeholder: Node.js version 16.6+ is required for version 13.0.0+
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      description: Which OS does your application run on?
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority this issue should have
+      description: Please be realistic. If you need to elaborate on your reasoning, please use the Issue description field above.
+      options:
+        - Low (slightly annoying)
+        - Medium (should be fixed soon)
+        - High (immediate attention needed)
+    validations:
+      required: true
+  - type: dropdown
+    id: partials
+    attributes:
+      label: Which partials do you have configured?
+      description: |
+        Check your Client constructor for the `partials` key.
+
+        Tip: you can select multiple items
+      options:
+        - No Partials
+        - USER
+        - CHANNEL
+        - GUILD_MEMBER
+        - MESSAGE
+        - REACTION
+        - GUILD_SCHEDULED_EVENT
+      multiple: true
+    validations:
+      required: true
+  - type: dropdown
+    id: intents
+    attributes:
+      label: Which gateway intents are you subscribing to?
+      description: |
+        Check your Client constructor for the `intents` key.
+
+        Tip: you can select multiple items
+      options:
+        - GUILDS
+        - GUILD_MEMBERS
+        - GUILD_BANS
+        - GUILD_EMOJIS_AND_STICKERS
+        - GUILD_INTEGRATIONS
+        - GUILD_WEBHOOKS
+        - GUILD_INVITES
+        - GUILD_VOICE_STATES
+        - GUILD_PRESENCES
+        - GUILD_MESSAGES
+        - GUILD_MESSAGE_REACTIONS
+        - GUILD_MESSAGE_TYPING
+        - DIRECT_MESSAGES
+        - DIRECT_MESSAGE_REACTIONS
+        - DIRECT_MESSAGE_TYPING
+        - GUILD_SCHEDULED_EVENTS
+      multiple: true
+    validations:
+      required: true
+  - type: input
+    id: dev-release
+    attributes:
+      label: I have tested this issue on a development release
+      placeholder: d23280c
+      description: |
+        The issue might already be fixed in a development release. This is not required, but helps us greatly.
+        To install the latest development release run `npm i discord.js@dev` in your project directory.
+        Run `npm list discord.js` and use the last part of the printed information (`d23280c` for `discord.js@xx.x.x-dev.1530234593.d23280c`)

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,37 +1,13 @@
 name: Feature request
-description: Request a new feature (discord.js accepts documented features of the official Discord developer API only!)
+description: Request a new feature (documented features of the official Discord developer API only!)
 labels: [feature request]
 body:
   - type: markdown
     attributes:
       value: |
-        We can only implement features that Discord publishes, documents, and merges into the Discord API documentation.
+        We can only implement features that Discord publishes, documents and merges into the Discord API documentation.
         We do not implement unreleased features.
         Use Discord for questions: https://discord.gg/djs
-  - type: dropdown
-    id: application_or_package
-    attributes:
-      label: Which application or package is this feature request for?
-      options:
-        - discord.js
-        - Documentation
-        - Guide
-        - brokers
-        - builders
-        - collection
-        - core
-        - create-discord-bot
-        - formatters
-        - next
-        - proxy
-        - proxy-container
-        - rest
-        - ui
-        - util
-        - voice
-        - ws
-    validations:
-      required: true
   - type: textarea
     id: description
     attributes:
@@ -53,7 +29,7 @@ body:
       label: Alternative solutions or implementations
       description: A clear and concise description of any alternative solutions or features you have considered.
   - type: textarea
-    id: additional_context
+    id: additional-context
     attributes:
       label: Other context
       description: Any other context, screenshots, or file uploads that help us understand your feature request.

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,5 +1,7 @@
 **Please describe the changes this PR makes and why it should be merged:**
 
+
+
 **Status and versioning classification:**
 
 <!--

.github/auto_assign.yml

@@ -0,0 +1,8 @@
+addReviewers: true
+reviewers:
+  - iCrawl
+  - SpaceEEC
+  - kyranet
+  - vladfrangu
+numberOfReviewers: 0
+runOnDraft: true

.github/check_deploy_branch.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+git diff HEAD^ HEAD --quiet .
+
+if [[ "$VERCEL_GIT_COMMIT_REF" == "main" && $? -eq 1 ]]; then
+	# Proceed with the build
+	echo "✅ - Proceed"
+	exit 1;
+else
+	# Don't build
+	echo "🛑 - Build cancelled"
+	exit 0;
+fi

.github/issue-labeler.yml

@@ -1,51 +0,0 @@
-apps:guide:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\nGuide\\n"
-apps:website:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\nDocumentation\\n"
-packages:brokers:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\nbrokers\\n"
-packages:builders:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\nbuilders\\n"
-packages:collection:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\ncollection\\n"
-packages:core:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\ncore\\n"
-packages:create-discord-bot:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\ncreate-discord-bot\\n"
-packages:discord.js:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\ndiscord.js\\n"
-packages:formatters:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\nformatters\\n"
-packages:next:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\nnext\\n"
-packages:proxy:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\nproxy\\n"
-packages:proxy-container:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\nproxy-container\\n"
-packages:rest:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\nrest\\n"
-packages:ui:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\ui\\n"
-packages:util:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\util\\n"
-packages:voice:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\nvoice\\n"
-packages:ws:
-  - "### Which (application|package|application or package) is this (bug
-    report|feature request) for\\?\\n\\nws\\n"

.github/labeler.yml

@@ -4,57 +4,12 @@ apps:guide:
 apps:website:
   - apps/website/*
   - apps/website/**/*
-packages:api-extractor:
-  - packages/api-extractor/*
-  - packages/api-extractor/**/*
-packages:api-extractor-model:
-  - packages/api-extractor-model/*
-  - packages/api-extractor-model/**/*
-packages:brokers:
-  - packages/brokers/*
-  - packages/brokers/**/*
-packages:builders:
-  - packages/builders/*
-  - packages/builders/**/*
-packages:collection:
-  - packages/collection/*
-  - packages/collection/**/*
-packages:core:
-  - packages/core/*
-  - packages/core/**/*
-packages:create-discord-bot:
-  - packages/create-discord-bot/*
-  - packages/create-discord-bot/**/*
 packages:discord.js:
-  - packages/discord.js/*
-  - packages/discord.js/**/*
-packages:docgen:
-  - packages/docgen/*
-  - packages/docgen/**/*
-packages:formatters:
-  - packages/formatters/*
-  - packages/formatters/**/*
-packages:next:
-  - packages/next/*
-  - packages/next/**/*
-packages:proxy:
-  - packages/proxy/*
-  - packages/proxy/**/*
-packages:proxy-container:
-  - packages/proxy-container/*
-  - packages/proxy-container/**/*
-packages:rest:
-  - packages/rest/*
-  - packages/rest/**/*
-packages:ui:
-  - packages/ui/*
-  - packages/ui/**/*
-packages:util:
-  - packages/util/*
-  - packages/util/**/*
-packages:voice:
-  - packages/voice/*
-  - packages/voice/**/*
-packages:ws:
-  - packages/ws/*
-  - packages/ws/**/*
+  - scripts/*
+  - scripts/**/*
+  - src/*
+  - src/**/*
+  - test/*
+  - test/**/*
+  - typings/*
+  - typings/**/*

.github/labels.yml

@@ -1,124 +1,80 @@
-- name: api changes
+- name: 'api changes'
   color: '5663e9'
-- name: api support
+- name: 'api support'
   color: '5663e9'
-- name: apps:guide
-  color: fbca04
-- name: apps:website
-  color: fbca04
-- name: backlog
-  color: 7ef7ef
-- name: backport
-  color: 88aabb
-- name: blocked
-  color: fc1423
-- name: bug
-  color: d73a4a
-- name: caching
-  color: 80c042
-- name: chore
-  color: ffffff
-- name: ci
-  color: 0075ca
-- name: dependencies
-  color: 276bd1
-- name: discord
+- name: 'backlog'
+  color: '7ef7ef'
+- name: 'bug'
+  color: 'd73a4a'
+- name: 'caching'
+  color: '80c042'
+- name: 'chore'
+  color: 'ffffff'
+- name: 'ci'
+  color: '0075ca'
+- name: 'dependencies'
+  color: '276bd1'
+- name: 'discussion'
+  color: 'b6b1f9'
+- name: 'discord'
   color: '5663e9'
-- name: discussion
-  color: b6b1f9
-- name: documentation
-  color: 0075ca
-- name: duplicate
-  color: cfd3d7
-- name: error handling
-  color: 80c042
-- name: feature request
-  color: fcf95a
-- name: gateway
-  color: 80c042
-- name: good first issue
-  color: 7057ff
-- name: has PR
-  color: 4b1f8e
-- name: help wanted
+- name: 'documentation'
+  color: '0075ca'
+- name: 'duplicate'
+  color: 'cfd3d7'
+- name: 'error handling'
+  color: '80c042'
+- name: 'feature request'
+  color: 'fcf95a'
+- name: 'gateway'
+  color: '80c042'
+- name: 'good first issue'
+  color: '7057ff'
+- name: 'has PR'
+  color: '4b1f8e'
+- name: 'help wanted'
   color: '008672'
-- name: in progress
-  color: ffccd7
-- name: in review
-  color: aed5fc
-- name: interactions
-  color: 80c042
-- name: invalid
-  color: e4e669
-- name: need repro
-  color: c66037
-- name: packages:api-extractor
-  color: fbca04
-- name: packages:api-extractor-model
-  color: fbca04
-- name: packages:brokers
-  color: fbca04
-- name: packages:builders
-  color: fbca04
-- name: packages:collection
-  color: fbca04
-- name: packages:core
-  color: fbca04
-- name: packages:create-discord-bot
-  color: fbca04
-- name: packages:discord.js
-  color: fbca04
-- name: packages:docgen
-  color: fbca04
-- name: packages:formatters
-  color: fbca04
-- name: packages:next
-  color: fbca04
-- name: packages:proxy
-  color: fbca04
-- name: packages:proxy-container
-  color: fbca04
-- name: packages:rest
-  color: fbca04
-- name: packages:ui
-  color: fbca04
-- name: packages:util
-  color: fbca04
-- name: packages:voice
-  color: fbca04
-- name: packages:ws
-  color: fbca04
-- name: performance
-  color: 80c042
-- name: permissions
-  color: 80c042
-- name: priority:high
-  color: fc1423
-- name: question (please use Discord instead)
-  color: d876e3
-- name: ratelimits
-  color: 80c042
-- name: refactor
-  color: 1d637f
-- name: regression
-  color: ea8785
-- name: REST
-  color: 80c042
-- name: semver:major
-  color: c10f47
-- name: semver:minor
-  color: e4f486
-- name: semver:patch
-  color: e8be8b
-- name: sharding
-  color: 80c042
-- name: tests
-  color: f06dff
-- name: threads
-  color: 80c042
-- name: typings
-  color: 80c042
-- name: utility
-  color: 80c042
-- name: wontfix
-  color: ffffff
+- name: 'interactions'
+  color: '80c042'
+- name: 'in progress'
+  color: 'ffccd7'
+- name: 'in review'
+  color: 'aed5fc'
+- name: 'invalid'
+  color: 'e4e669'
+- name: 'need repro'
+  color: 'c66037'
+- name: 'performance'
+  color: '80c042'
+- name: 'permissions'
+  color: '80c042'
+- name: 'priority:high'
+  color: 'fc1423'
+- name: 'question (please use Discord instead)'
+  color: 'd876e3'
+- name: 'ratelimits'
+  color: '80c042'
+- name: 'refactor'
+  color: '1d637f'
+- name: 'regression'
+  color: 'ea8785'
+- name: 'REST'
+  color: '80c042'
+- name: 'semver:major'
+  color: 'c10f47'
+- name: 'semver:minor'
+  color: 'e4f486'
+- name: 'semver:patch'
+  color: 'e8be8b'
+- name: 'sharding'
+  color: '80c042'
+- name: 'tests'
+  color: 'f06dff'
+- name: 'threads'
+  color: '80c042'
+- name: 'typings'
+  color: '80c042'
+- name: 'utility'
+  color: '80c042'
+- name: 'wontfix'
+  color: 'ffffff'

.github/tsc.json

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

.github/workflows/auto-deprecate.yml

@@ -0,0 +1,26 @@
+name: npm auto deprecate
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 1 * * *'
+jobs:
+  auto-deprecate:
+    name: npm auto deprecate
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Install Node v16
+        uses: actions/setup-node@v2
+        with:
+          node-version: 16
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci --ignore-scripts
+
+      - name: Deprecate versions
+        run: 'npm exec --no npm-deprecate -- --name "*dev*" --package "discord.js"'
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}

.github/workflows/cleanup-cache.yml

@@ -1,35 +0,0 @@
-# https://docs.github.com/en/actions/using-workflows/caching-dependencies-to-speed-up-workflows#force-deleting-cache-entries
-name: Cleanup caches
-on:
-  pull_request:
-    types:
-      - closed
-  workflow_dispatch:
-jobs:
-  cleanup:
-    name: Cleanup caches
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-
-      - name: Cleanup caches
-        run: |
-          gh extension install actions/gh-actions-cache
-
-          REPO=${{ github.repository }}
-          BRANCH="refs/pull/${{ github.event.pull_request.number }}/merge"
-
-          echo "Fetching list of cache key"
-          cacheKeysForPR=$(gh actions-cache list -R $REPO -B $BRANCH | cut -f 1 )
-
-          ## Setting this to not fail the workflow while deleting cache keys.
-          set +e
-          echo "Deleting caches..."
-          for cacheKey in $cacheKeysForPR
-          do
-              gh actions-cache delete $cacheKey -R $REPO -B $BRANCH --confirm
-          done
-          echo "Done"
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/deploy-website.yml

@@ -1,28 +0,0 @@
-name: Deploy website
-on:
-  workflow_dispatch:
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
-  cancel-in-progress: true
-jobs:
-  deploy-website:
-    name: Deploy website
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      deployments: write
-    if: github.repository_owner == 'discordjs'
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-
-      - name: Build & deploy website
-        uses: BetaHuhn/deploy-to-vercel-action@643bc80032ba62ca41d1a9aaba7b38b51c2b8646
-        with:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
-          VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
-          VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
-          VERCEL_SCOPE: 'discordjs'
-          GITHUB_DEPLOYMENT_ENV: 'Production – discord-js'
-          PRODUCTION: true

.github/workflows/deprecate-version.yml

@@ -1,50 +0,0 @@
-name: Deprecate version
-on:
-  workflow_dispatch:
-    inputs:
-      package:
-        description: Package
-        required: true
-        type: choice
-        options:
-          - '@discordjs/brokers'
-          - '@discordjs/builders'
-          - '@discordjs/collection'
-          - '@discordjs/core'
-          - 'create-discord-bot'
-          - '@discordjs/formatters'
-          - 'discord.js'
-          - '@discordjs/next'
-          - '@discordjs/proxy'
-          - '@discordjs/rest'
-          - '@discordjs/util'
-          - '@discordjs/voice'
-          - '@discordjs/ws'
-      version:
-        description: Version(s)
-        required: true
-        type: string
-      message:
-        description: Deprecation message
-        required: false
-        type: string
-jobs:
-  deprecate:
-    runs-on: ubuntu-latest
-    if: github.repository_owner == 'discordjs'
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-
-      - name: Install Node.js v18
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-
-      - name: Install dependencies
-        uses: ./packages/actions/src/pnpmCache
-
-      - name: Deprecate
-        run: pnpm exec npm-deprecate --name "${{inputs.version}}" --message "${{inputs.message || 'This version is deprecated. Please use a newer version.'}}" --package ${{inputs.package}}
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}

.github/workflows/documentation.yml

@@ -2,12 +2,8 @@ name: Documentation
 on:
   push:
     branches:
-      - 'main'
-    paths:
-      - 'packages/*/src/**'
-      - '!packages/create-discord-bot/**'
-      - '!packages/proxy-container/**'
-      - '!packages/ui/**'
+      - 'v13'
+      - '!docs'
     tags:
       - '**'
   workflow_dispatch:
@@ -15,43 +11,74 @@ on:
       ref:
         description: 'The branch, tag or SHA to checkout'
         required: true
-      ref_type:
-        type: choice
-        description: 'Branch or tag'
-        options:
-          - branch
-          - tag
-        required: true
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
-  cancel-in-progress: true
 jobs:
-  build-docs:
-    name: Build & upload documentation
+  build:
+    name: Build documentation
     runs-on: ubuntu-latest
-    env:
-      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
-      TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
     if: github.repository_owner == 'discordjs'
+    outputs:
+      BRANCH_NAME: ${{ steps.env.outputs.BRANCH_NAME }}
+      BRANCH_OR_TAG: ${{ steps.env.outputs.BRANCH_OR_TAG }}
+      SHA: ${{ steps.env.outputs.SHA }}
     steps:
       - name: Checkout repository
         uses: actions/checkout@v3
         with:
-          ref: ${{ inputs.ref || '' }}
+          ref: ${{ github.event.inputs.ref || '' }}
 
-      - name: Install node.js v18
+      - name: Install node.js v16
         uses: actions/setup-node@v3
         with:
-          node-version: 18
+          node-version: 16
+          cache: 'npm'
+          cache-dependency-path: package-lock.json
 
       - name: Install dependencies
-        uses: ./packages/actions/src/pnpmCache
-
-      - name: Build dependencies
-        run: pnpm run build
+        run: npm ci
 
       - name: Build docs
-        run: pnpm run docs
+        run: npm run docs
+
+      - name: Upload docgen artifacts
+        uses: actions/upload-artifact@v3
+        with:
+          name: docgen
+          path: docs/docs.json
+
+      - name: Set outputs for upload job
+        id: env
+        run: |
+          echo "::set-output name=BRANCH_NAME::${GITHUB_REF_NAME}"
+          echo "::set-output name=BRANCH_OR_TAG::${GITHUB_REF_TYPE}"
+          echo "::set-output name=SHA::${GITHUB_SHA}"
+
+  upload:
+    name: Upload Documentation
+    needs: build
+    runs-on: ubuntu-latest
+    env:
+      BRANCH_NAME: ${{ github.event.inputs.ref || needs.build.outputs.BRANCH_NAME }}
+      BRANCH_OR_TAG: ${{ needs.build.outputs.BRANCH_OR_TAG }}
+      SHA: ${{ needs.build.outputs.SHA }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Install node.js v16
+        uses: actions/setup-node@v3
+        with:
+          node-version: 16
+          cache: 'npm'
+          cache-dependency-path: package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Download docgen artifacts
+        uses: actions/download-artifact@v3
+        with:
+          name: docgen
+          path: docs
 
       - name: Checkout docs repository
         uses: actions/checkout@v3
@@ -60,56 +87,10 @@ jobs:
           token: ${{ secrets.DJS_DOCS }}
           path: 'out'
 
-      - name: Extract package and semver from tag
-        if: ${{ github.ref_type == 'tag' }}
-        id: extract-tag
-        uses: ./packages/actions/src/formatTag
-        with:
-          tag: ${{ github.ref_name }}
-
-      - name: Upload documentation to database
-        if: ${{ github.ref_type == 'tag' }}
-        env:
-          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-        uses: ./packages/actions/src/uploadDocumentation
-        with:
-          package: ${{ steps.extract-tag.outputs.package }}
-          version: ${{ steps.extract-tag.outputs.semver }}
-
       - name: Move docs to correct directory
-        if: ${{ github.ref_type == 'tag' }}
-        env:
-          PACKAGE: ${{ steps.extract-tag.outputs.package }}
-          SEMVER: ${{ steps.extract-tag.outputs.semver }}
         run: |
-          mkdir -p "out/${PACKAGE}"
-          if [[ "${PACKAGE}" == "discord.js" ]]; then
-            mv "packages/${PACKAGE}/docs/docs.json" "out/${PACKAGE}/${SEMVER}.json"
-            mv "packages/${PACKAGE}/docs/docs.api.json" "out/${PACKAGE}/${SEMVER}.api.json"
-          else
-            mv "packages/${PACKAGE}/docs/docs.api.json" "out/${PACKAGE}/${SEMVER}.api.json"
-          fi
-
-      - name: Upload documentation to database
-        if: ${{ github.ref_type == 'branch' }}
-        env:
-          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-        uses: ./packages/actions/src/uploadDocumentation
-
-      - name: Move docs to correct directory
-        if: ${{ github.ref_type == 'branch' }}
-        run: |
-          declare -a PACKAGES=("brokers" "builders" "collection" "core" "discord.js" "formatters" "next" "proxy" "rest" "util" "voice" "ws")
-          for PACKAGE in "${PACKAGES[@]}"; do
-            if [[ "${PACKAGE}" == "discord.js" ]]; then
-              mkdir -p "out/${PACKAGE}"
-              mv "packages/${PACKAGE}/docs/docs.json" "out/${PACKAGE}/${GITHUB_REF_NAME}.json"
-              mv "packages/${PACKAGE}/docs/docs.api.json" "out/${PACKAGE}/${GITHUB_REF_NAME}.api.json"
-            else
-              mkdir -p "out/${PACKAGE}"
-              mv "packages/${PACKAGE}/docs/docs.api.json" "out/${PACKAGE}/${GITHUB_REF_NAME}.api.json"
-            fi
-          done
+          mkdir -p out/discord.js
+          mv docs/docs.json out/discord.js/${BRANCH_NAME}.json
 
       - name: Commit and push
         run: |
@@ -117,58 +98,5 @@ jobs:
           git config user.name github-actions[bot]
           git config user.email 41898282+github-actions[bot]@users.noreply.github.com
           git add .
-          git commit -m "Docs build for ${GITHUB_REF_TYPE} ${GITHUB_REF_NAME}: ${GITHUB_SHA}" || true
+          git commit -m "Docs build for ${BRANCH_OR_TAG} ${BRANCH_NAME}: ${SHA}" || true
           git push
-
-  build-indices:
-    needs: build-docs
-    name: Build & upload search indices
-    runs-on: ubuntu-latest
-    env:
-      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
-      TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
-    if: github.repository_owner == 'discordjs'
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-
-      - name: Install dependencies
-        uses: ./packages/actions/src/pnpmCache
-
-      - name: Build dependencies
-        run: pnpm run build
-
-      - name: Upload search indices to meilisearch
-        env:
-          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-          SEARCH_API_URL: ${{ secrets.SEARCH_API_URL }}
-          SEARCH_API_KEY: ${{ secrets.SEARCH_API_KEY }}
-        uses: ./packages/actions/src/uploadSearchIndices
-
-  deploy-website:
-    needs: build-docs
-    name: Deploy website
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      deployments: write
-    if: github.repository_owner == 'discordjs'
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-
-      - name: Build & deploy website
-        uses: BetaHuhn/deploy-to-vercel-action@643bc80032ba62ca41d1a9aaba7b38b51c2b8646
-        with:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
-          VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
-          VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
-          VERCEL_SCOPE: 'discordjs'
-          GITHUB_DEPLOYMENT_ENV: 'Production – discord-js'
-          PRODUCTION: true

.github/workflows/issue-triage.yml

@@ -1,14 +0,0 @@
-name: 'Issue Labeler'
-on:
-  issues:
-    types: [opened]
-jobs:
-  issue-triage:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: github/issue-labeler@v3.2
-        with:
-          repo-token: '${{ secrets.GITHUB_TOKEN }}'
-          configuration-path: .github/issue-labeler.yml
-          not-before: 2023-01-13T10:25:03.847Z
-          enable-versioned-regex: 0

.github/workflows/labelsync.yml

@@ -1,4 +1,4 @@
-name: Label sync
+name: Label Sync
 on:
   schedule:
     - cron: '0 0 * * *'
@@ -9,15 +9,14 @@ on:
     paths:
       - '.github/labels.yml'
 jobs:
-  label-sync:
-    name: Label sync
+  labeler:
+    name: Labeler
     runs-on: ubuntu-latest
-    if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v2
 
-      - name: Label sync
-        uses: crazy-max/ghaction-github-labeler@v4
+      - name: Run Label Sync
+        uses: crazy-max/ghaction-github-labeler@v3
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/lock.yml

@@ -1,19 +0,0 @@
-name: Lock Ancient Issues
-on:
-  schedule:
-    - cron: '0 16 * * *'
-  workflow_dispatch:
-concurrency:
-  group: lock
-jobs:
-  action:
-    runs-on: ubuntu-latest
-    permissions:
-      issues: write
-    steps:
-      - uses: dessant/lock-threads@v4
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          issue-inactive-days: 365
-          issue-lock-reason: resolved
-          process-only: issues

.github/workflows/pr-triage.yml

@@ -11,3 +11,7 @@ jobs:
         with:
           repo-token: '${{ secrets.GITHUB_TOKEN }}'
           sync-labels: true
+
+      - name: Automatically assign reviewers
+        if: github.event.action == 'opened'
+        uses: kentaro-m/auto-assign-action@v1.2.4

.github/workflows/publish-dev-docker.yml

@@ -1,30 +0,0 @@
-name: Publish dev docker images
-on:
-  schedule:
-    - cron: '0 */12 * * *'
-  workflow_dispatch:
-jobs:
-  docker-publish:
-    name: Docker publish
-    runs-on: ubuntu-latest
-    if: github.repository_owner == 'discordjs'
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-
-      - name: Install dependencies
-        uses: ./packages/actions/src/pnpmCache
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
-
-      - name: Login to DockerHub
-        run: echo ${{ secrets.DOCKER_ACCESS_TOKEN }} | docker login -u ${{ secrets.DOCKER_USERNAME }} --password-stdin
-
-      - name: Build & push docker image
-        run: docker build -f packages/proxy-container/Dockerfile -t discordjs/proxy:latest --push .

.github/workflows/publish-dev.yml

@@ -1,82 +1,44 @@
 name: Publish dev
 on:
+  workflow_dispatch:
   schedule:
     - cron: '0 */12 * * *'
-  workflow_dispatch:
 jobs:
-  npm-publish:
-    name: npm publish
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - package: '@discordjs/brokers'
-            folder: 'brokers'
-          - package: '@discordjs/builders'
-            folder: 'builders'
-          - package: '@discordjs/collection'
-            folder: 'collection'
-          - package: '@discordjs/core'
-            folder: 'core'
-          - package: '@discordjs/formatters'
-            folder: 'formatters'
-          - package: 'discord.js'
-            folder: 'discord.js'
-          - package: '@discordjs/next'
-            folder: 'next'
-          - package: '@discordjs/proxy'
-            folder: 'proxy'
-          - package: '@discordjs/rest'
-            folder: 'rest'
-          - package: '@discordjs/util'
-            folder: 'util'
-          - package: '@discordjs/voice'
-            folder: 'voice'
-          - package: '@discordjs/ws'
-            folder: 'ws'
+  npm:
+    name: npm
     runs-on: ubuntu-latest
-    env:
-      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
-      TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
-    if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
+        uses: actions/checkout@v2
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node v16
+        uses: actions/setup-node@v2
         with:
-          node-version: 18
+          node-version: 16
           registry-url: https://registry.npmjs.org/
+          cache: npm
 
-      - name: Check the current development version
-        id: release-check
+      - name: Check previous released version
+        id: pre-release
         run: |
-          if [[ $(npm view ${{ matrix.package }}@dev version | grep -e "$(git rev-parse --short HEAD)") ]]; \
-            then echo "RELEASE=0" >> "$GITHUB_OUTPUT"; \
-            else echo "RELEASE=1" >> "$GITHUB_OUTPUT"; \
-          fi
+          if [[ $(npm view discord.js@dev version | grep -e "$(jq --raw-output '.version' package.json).*.$(git rev-parse --short HEAD | cut -b1-3)") ]]; \
+          then echo '::set-output name=release::false'; \
+          else echo '::set-output name=release::true'; fi
 
       - name: Install dependencies
-        if: steps.release-check.outputs.release == '1'
-        uses: ./packages/actions/src/pnpmCache
+        if: steps.pre-release.outputs.release == 'true'
+        run: npm ci --ignore-scripts
 
-      - name: Build dependencies
-        if: steps.release-check.outputs.release == '1'
-        run: pnpm run build
+      - name: Deprecate old versions
+        if: steps.pre-release.outputs.release == 'true'
+        run: npm deprecate discord.js@"~$(jq --raw-output '.version' package.json)" "no longer supported" || true
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}
 
-      - name: Publish package
-        if: steps.release-check.outputs.release == '1'
+      - name: Publish
+        if: steps.pre-release.outputs.release == 'true'
         run: |
-          pnpm --filter=${{ matrix.package }} run release --preid "dev.$(date +%s)-$(git rev-parse --short HEAD)"
-          pnpm --filter=${{ matrix.package }} publish --no-git-checks --tag dev || true
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}
-
-      - name: Deprecate prior development releases
-        if: steps.release-check.outputs.release == '1'
-        run: pnpm exec npm-deprecate --name "*dev*" --message "This version is deprecated. Please use a newer version." --package ${{ matrix.package }}
+          npm version --git-tag-version=false $(jq --raw-output '.version' package.json).$(date +%s).$(git rev-parse --short HEAD)
+          npm publish --tag dev || true
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}

.github/workflows/publish-docker.yml

@@ -1,27 +0,0 @@
-name: Publish docker images
-on:
-  workflow_dispatch:
-jobs:
-  docker-publish:
-    name: Docker publish
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-
-      - name: Install dependencies
-        uses: ./packages/actions/src/pnpmCache
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
-
-      - name: Login to DockerHub
-        run: echo ${{ secrets.DOCKER_ACCESS_TOKEN }} | docker login -u ${{ secrets.DOCKER_USERNAME }} --password-stdin
-
-      - name: Build & push docker image
-        run: docker build -f packages/proxy-container/Dockerfile -t discordjs/proxy:$(cut -d '.' -f1 <<< $(jq --raw-output '.version' packages/proxy-container/package.json)) --push .

.github/workflows/publish-release.yml

@@ -14,26 +14,17 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v3
 
-      - name: Install node.js v18
+      - name: Install node.js v16
         uses: actions/setup-node@v3
         with:
-          node-version: 18
+          node-version: 16
           registry-url: https://registry.npmjs.org/
+          cache: npm
 
       - name: Install dependencies
-        uses: ./packages/actions/src/pnpmCache
+        run: npm ci --ignore-scripts
 
-      - name: Build dependencies
-        run: pnpm run build
-
-      - name: Extract package and semver from tag
-        id: extract-tag
-        uses: ./packages/actions/src/formatTag
-        with:
-          tag: ${{ github.ref_name }}
-
-      - name: Publish package
-        run: |
-          pnpm --filter=${{ steps.extract-tag.outputs.subpackage == 'true' && '@discordjs/' || '' }}${{ steps.extract-tag.outputs.package }} publish --no-git-checks
+      - name: Publish package (v13)
+        run: npm publish --tag v13-lts
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}

.github/workflows/test.yml

@@ -0,0 +1,81 @@
+name: Tests
+on: [push, pull_request]
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Install Node v16
+        uses: actions/setup-node@v2
+        with:
+          node-version: 16
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run Prettier and ESLint
+        run: npm run lint
+
+  typings:
+    name: TSLint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Install Node v16
+        uses: actions/setup-node@v2
+        with:
+          node-version: 16
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run TSLint
+        run: npm run lint:typings
+
+  typescript:
+    name: TypeScript
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Install Node v16
+        uses: actions/setup-node@v2
+        with:
+          node-version: 16
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Register Problem Matcher
+        run: echo "##[add-matcher].github/tsc.json"
+
+      - name: Run Type Tests
+        run: npm run test:typescript
+
+  docs:
+    name: Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Install Node v16
+        uses: actions/setup-node@v2
+        with:
+          node-version: 16
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Test documentation
+        run: npm run docs:test

.github/workflows/tests.yml

@@ -1,64 +0,0 @@
-name: Tests
-on:
-  push:
-  pull_request:
-concurrency:
-  # Group based on workflow name and PR if it exists, if no PR, let it run so carryforward flags work
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: true
-jobs:
-  tests:
-    name: Tests
-    runs-on: ubuntu-latest
-    env:
-      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
-      TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-
-      - name: Install dependencies
-        uses: ./packages/actions/src/pnpmCache
-
-      - name: Build dependencies (PR)
-        if: ${{ github.event_name != 'push' }}
-        run: pnpm exec turbo run build --filter="...[origin/${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || 'main' }}]" --concurrency=4
-
-      - name: Build dependencies (Push)
-        if: ${{ github.event_name == 'push' }}
-        run: pnpm exec turbo run build --filter="...[HEAD^1]" --concurrency=4
-
-      - name: ESLint (PR)
-        if: ${{ github.event_name != 'push' }}
-        run: pnpm exec turbo run lint --filter="...[origin/${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || 'main' }}]" --concurrency=4 -- --format=compact
-
-      - name: ESLint (Push)
-        if: ${{ github.event_name == 'push' }}
-        run: pnpm exec turbo run lint --filter="...[HEAD^1]" --concurrency=4 -- --format=compact
-
-      - name: Tests (PR)
-        if: ${{ github.event_name != 'push' }}
-        run: pnpm exec turbo run test --filter="...[origin/${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || 'main' }}]" --concurrency=4
-
-      - name: Tests (Push)
-        if: ${{ github.event_name == 'push' }}
-        run: pnpm exec turbo run test --filter="...[HEAD^1]" --concurrency=4
-
-      - name: Docs (PR)
-        if: ${{ github.event_name != 'push' }}
-        run: pnpm exec turbo run docs --filter="...[origin/${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || 'main' }}]" --concurrency=4
-
-      - name: Docs (Push)
-        if: ${{ github.event_name == 'push' }}
-        run: pnpm exec turbo run docs --filter="...[HEAD^1]" --concurrency=4
-
-      - name: Upload Coverage
-        if: github.repository_owner == 'discordjs'
-        uses: ./packages/actions/src/uploadCoverage

.gitignore

@@ -1,8 +1,8 @@
 # Packages
-node_modules
+node_modules/
 
 # Log files
-logs
+logs/
 *.log
 npm-debug.log*
 
@@ -13,42 +13,21 @@ pids
 
 # Env
 .env
+test/auth.json
+test/auth.js
+docs/deploy/deploy_key
+docs/deploy/deploy_key.pub
+deploy/deploy_key
+deploy/deploy_key.pub
 
 # Dist
-dist
-dist-docs
+dist/
+docs/docs.json
 
 # Miscellaneous
-.tmp
-.vscode/*
-!.vscode/extensions.json
-!.vscode/settings.json
-.idea
+.tmp/
+.idea/
 .DS_Store
-.turbo
-tsconfig.tsbuildinfo
-coverage
-out
-package.tgz
-tsup.config.bundled*
-vitest.config.ts.timestamp*
-
-# Deno
-deno.lock
-
-# Bun
-bun.lockb
-
-# yarn
-.pnp.*
-.yarn/*
-!.yarn/patches
-!.yarn/plugins
-!.yarn/releases
-!.yarn/sdks
-!.yarn/versions
-
-# Cache
-.prettiercache
-.eslintcache
-.vercel
+.yarn/
+.turbo/
+.vercel/

.husky/commit-msg

@@ -1,4 +1,4 @@
 #!/bin/sh
 . "$(dirname "$0")/_/husky.sh"
 
-pnpm exec commitlint --edit $1
+npx --no-install commitlint --edit $1

.husky/pre-commit

@@ -1,4 +1,4 @@
 #!/bin/sh
 . "$(dirname "$0")/_/husky.sh"
 
-pnpm run build:affected && pnpm exec lint-staged
+npx --no-install lint-staged

.lintstagedrc.json

@@ -1,6 +1,4 @@
 {
-	"$schema": "https://json.schemastore.org/lintstagedrc.schema.json",
-	"*": "prettier --ignore-unknown --write",
-	"{src/**,__tests__/**}.{mjs,js,cjs,ts,tsx}": "eslint --fix",
-	"src/**.ts": "vitest related --run --config ../../vitest.config.ts"
+  "*.{mjs,js}": "eslint --fix --ext mjs,js,ts",
+  "*.{ts,json,yml,yaml}": "prettier --write"
 }

.npmrc

@@ -1,6 +1,5 @@
-auto-install-peers=false
-resolution-mode=highest
-public-hoist-pattern[]=*eslint*
-public-hoist-pattern[]=*prettier*
-public-hoist-pattern[]=*@rushstack/node-core-library*
-public-hoist-pattern[]=*jju*
+audit=false
+fund=false
+legacy-peer-deps=true
+tag-version-prefix=""
+message="chore(Release): %s"

.prettierignore

@@ -1,5 +0,0 @@
-CODEOWNERS
-CHANGELOG.md
-tsup.config.bundled*
-vitest.config.ts.timestamp*
-pnpm-lock.yaml

.prettierrc.json

@@ -1,9 +1,7 @@
 {
-	"$schema": "https://json.schemastore.org/prettierrc.json",
-	"printWidth": 120,
-	"useTabs": true,
-	"singleQuote": true,
-	"quoteProps": "as-needed",
-	"trailingComma": "all",
-	"endOfLine": "lf"
+  "singleQuote": true,
+  "printWidth": 120,
+  "trailingComma": "all",
+  "endOfLine": "lf",
+  "arrowParens": "avoid"
 }

.tern-project

@@ -0,0 +1,14 @@
+{
+  "ecmaVersion": 7,
+  "libs": [],
+  "loadEagerly": ["./src/*.js"],
+  "dontLoad": ["node_modules/**"],
+  "plugins": {
+    "es_modules": {},
+    "node": {},
+    "doc_comment": {
+      "fullDocs": true,
+      "strong": true
+    },
+  }
+}

.vscode/extensions.json

@@ -1,14 +0,0 @@
-{
-	"recommendations": [
-		"esbenp.prettier-vscode",
-		"dbaeumer.vscode-eslint",
-		"tamasfe.even-better-toml",
-		"github.vscode-pull-request-github",
-		"codezombiech.gitignore",
-		"eamodio.gitlens",
-		"christian-kohler.npm-intellisense",
-		"christian-kohler.path-intellisense",
-		"antfu.unocss",
-		"unifiedjs.vscode-mdx"
-	]
-}

.vscode/settings.json

@@ -1,34 +0,0 @@
-{
-	"eslint.validate": ["javascript", "javascriptreact", "typescript", "typescriptreact"],
-	"eslint.experimental.useFlatConfig": true,
-	"eslint.workingDirectories": [
-		{ "directory": "${workspaceFolder}" },
-		{ "pattern": "./apps/*/" },
-		{ "pattern": "./packages/*/" }
-	],
-	"editor.defaultFormatter": "esbenp.prettier-vscode",
-	"editor.formatOnSave": true,
-	"editor.codeActionsOnSave": {
-		"source.organizeImports": false,
-		"source.fixAll.eslint": true,
-		"source.fixAll": true
-	},
-	"editor.trimAutoWhitespace": false,
-	"files.associations": {
-		"api-extractor.json": "jsonc",
-		"api-extractor-docs.json": "jsonc",
-		"tsconfig.json": "jsonc",
-		"tsconfig.eslint.json": "jsonc",
-		"tsconfig.docs.json": "jsonc"
-	},
-	"files.insertFinalNewline": true,
-	"files.eol": "\n",
-	"npm.packageManager": "pnpm",
-	"typescript.tsdk": "node_modules/typescript/lib",
-	"typescript.enablePromptUseWorkspaceTsdk": true,
-	"deno.enable": false,
-	"deno.enablePaths": ["./packages/create-discord-bot/template/Deno"],
-	"deno.lint": false,
-	"deno.unstable": false,
-	"deno.config": "./packages/create-discord-bot/template/Deno/deno.jsonc"
-}

LICENSE

@@ -175,8 +175,8 @@
 
    END OF TERMS AND CONDITIONS
 
-   Copyright 2021 Noel Buechler
-   Copyright 2015 Amish Shah
+   Copyright 2015 - 2021 Noel Buechler
+   Copyright 2015 - 2021 Amish Shah
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

README.md

@@ -1,87 +1,125 @@
 <div align="center">
-	<br />
-	<p>
-		<a href="https://discord.js.org"><img src="https://discord.js.org/static/logo.svg" width="546" alt="discord.js" /></a>
-	</p>
-	<br />
-	<p>
-		<a href="https://discord.gg/djs"><img src="https://img.shields.io/discord/222078108977594368?color=5865F2&logo=discord&logoColor=white" alt="Discord server" /></a>
-		<a href="https://www.npmjs.com/package/discord.js"><img src="https://img.shields.io/npm/v/discord.js.svg?maxAge=3600" alt="npm version" /></a>
-		<a href="https://www.npmjs.com/package/discord.js"><img src="https://img.shields.io/npm/dt/discord.js.svg?maxAge=3600" alt="npm downloads" /></a>
-		<a href="https://github.com/discordjs/discord.js/actions"><img src="https://github.com/discordjs/discord.js/actions/workflows/test.yml/badge.svg" alt="Tests status" /></a>
-		<a href="https://codecov.io/gh/discordjs/discord.js" ><img src="https://codecov.io/gh/discordjs/discord.js/branch/main/graph/badge.svg?precision=2" alt="Code coverage" /></a>
-	</p>
-	<p>
-		<a href="https://vercel.com/?utm_source=discordjs&utm_campaign=oss"><img src="https://raw.githubusercontent.com/discordjs/discord.js/main/.github/powered-by-vercel.svg" alt="Vercel" /></a>
-		<a href="https://www.cloudflare.com"><img src="https://raw.githubusercontent.com/discordjs/discord.js/main/.github/powered-by-workers.png" alt="Cloudflare Workers" height="44" /></a>
-	</p>
+  <br />
+  <p>
+    <a href="https://discord.js.org"><img src="https://discord.js.org/static/logo.svg" width="546" alt="discord.js" /></a>
+  </p>
+  <br />
+  <p>
+    <a href="https://discord.gg/djs"><img src="https://img.shields.io/discord/222078108977594368?color=5865F2&logo=discord&logoColor=white" alt="Discord server" /></a>
+    <a href="https://www.npmjs.com/package/discord.js"><img src="https://img.shields.io/npm/v/discord.js.svg?maxAge=3600" alt="npm version" /></a>
+    <a href="https://www.npmjs.com/package/discord.js"><img src="https://img.shields.io/npm/dt/discord.js.svg?maxAge=3600" alt="npm downloads" /></a>
+    <a href="https://github.com/discordjs/discord.js/actions"><img src="https://github.com/discordjs/discord.js/actions/workflows/test.yml/badge.svg" alt="Tests status" /></a>
+  </p>
 </div>
 
 ## About
 
-This repository contains multiple packages with separate [releases][github-releases]. You can find the assembled Discord API wrapper at [`discord.js`][source]. It is a powerful [Node.js](https://nodejs.org/en) module that allows you to easily interact with the [Discord API](https://discord.com/developers/docs/intro).
+discord.js is a powerful [Node.js](https://nodejs.org) module that allows you to easily interact with the
+[Discord API](https://discord.com/developers/docs/intro).
 
-## Packages
+- Object-oriented
+- Predictable abstractions
+- Performant
+- 100% coverage of the Discord API
 
-- `discord.js` ([source][source]) - A powerful Node.js module for interacting with the Discord API
-- `@discordjs/brokers` ([source][brokers-source]) - A collection of brokers for use with discord.js
-- `@discordjs/builders` ([source][builders-source]) - A utility package for easily building Discord API payloads
-- `@discordjs/collection` ([source][collection-source]) - A powerful utility data structure
-- `@discordjs/core` ([source][core-source]) - A thinly abstracted wrapper around the core components of the Discord API
-- `@discordjs/formatters` ([source][formatters-source]) - A collection of functions for formatting strings
-- `@discordjs/proxy` ([source][proxy-source]) - A wrapper around `@discordjs/rest` for running an HTTP proxy
-- `@discordjs/rest` ([source][rest-source]) - A module for interacting with the Discord REST API
-- `@discordjs/voice` ([source][voice-source]) - A module for interacting with the Discord Voice API
-- `@discordjs/util` ([source][util-source]) - A collection of utility functions
-- `@discordjs/ws` ([source][ws-source]) - A wrapper around Discord's gateway
+## Installation
+
+**Node.js 16.6.0 or newer is required.**  
+
+```sh-session
+npm install discord.js
+yarn add discord.js
+pnpm add discord.js
+```
+
+### Optional packages
+
+- [zlib-sync](https://www.npmjs.com/package/zlib-sync) for WebSocket data compression and inflation (`npm install zlib-sync`)
+- [erlpack](https://github.com/discord/erlpack) for significantly faster WebSocket data (de)serialisation (`npm install discord/erlpack`)
+- [bufferutil](https://www.npmjs.com/package/bufferutil) for a much faster WebSocket connection (`npm install bufferutil`)
+- [utf-8-validate](https://www.npmjs.com/package/utf-8-validate) in combination with `bufferutil` for much faster WebSocket processing (`npm install utf-8-validate`)
+- [@discordjs/voice](https://github.com/discordjs/voice) for interacting with the Discord Voice API (`npm install @discordjs/voice`)
+
+## Example usage
+
+Install all required dependencies:
+```sh-session
+npm install discord.js @discordjs/rest discord-api-types
+yarn add discord.js @discordjs/rest discord-api-types
+pnpm add discord.js @discordjs/rest discord-api-types
+```
+
+Register a slash command against the Discord API:
+```js
+const { REST } = require('@discordjs/rest');
+const { Routes } = require('discord-api-types/v9');
+
+const commands = [{
+  name: 'ping',
+  description: 'Replies with Pong!'
+}]; 
+
+const rest = new REST({ version: '9' }).setToken('token');
+
+(async () => {
+  try {
+    console.log('Started refreshing application (/) commands.');
+
+    await rest.put(
+      Routes.applicationGuildCommands(CLIENT_ID, GUILD_ID),
+      { body: commands },
+    );
+
+    console.log('Successfully reloaded application (/) commands.');
+  } catch (error) {
+    console.error(error);
+  }
+})();
+```
+
+Afterwards we can create a quite simple example bot:
+```js
+const { Client, Intents } = require('discord.js');
+const client = new Client({ intents: [Intents.FLAGS.GUILDS] });
+
+client.on('ready', () => {
+  console.log(`Logged in as ${client.user.tag}!`);
+});
+
+client.on('interactionCreate', async interaction => {
+  if (!interaction.isCommand()) return;
+
+  if (interaction.commandName === 'ping') {
+    await interaction.reply('Pong!');
+  }
+});
+
+client.login('token');
+```
 
 ## Links
 
-- [Website][website] ([source][website-source])
-- [Documentation][documentation]
-- [Guide][guide] ([source][guide-source])
-  Also see the v13 to v14 [Update Guide][guide-update], which includes updated and removed items from the library.
-- [discord.js Discord server][discord]
-- [Discord API Discord server][discord-api]
-- [GitHub][source]
-- [npm][npm]
-- [Related libraries][related-libs]
+- [Website](https://discord.js.org/) ([source](https://github.com/discordjs/website))
+- [Documentation](https://old.discordjs.dev/#/docs)
+- [Guide](https://v13.discordjs.guide) ([source](https://github.com/discordjs/guide/tree/v13))
+  See also the [Update Guide](https://v13.discordjs.guide/additional-info/changes-in-v13.html), including updated and removed items in the library.
+- [discord.js Discord server](https://discord.gg/djs)
+- [Discord API Discord server](https://discord.gg/discord-api)
+- [GitHub](https://github.com/discordjs/discord.js)
+- [npm](https://www.npmjs.com/package/discord.js)
+- [Related libraries](https://discord.com/developers/docs/topics/community-resources#libraries)
 
 ### Extensions
 
-- [RPC][rpc] ([source][rpc-source])
+- [RPC](https://www.npmjs.com/package/discord-rpc) ([source](https://github.com/discordjs/RPC))
 
 ## Contributing
 
-Please read through our [contribution guidelines][contributing] before starting a pull request. We welcome contributions of all kinds, not just code! If you're stuck for ideas, look for the [good first issue][good-first-issue] label on issues in the repository. If you have any questions about the project, feel free to ask them on [Discord][discord]. Before creating your own issue or pull request, always check to see if one already exists! Don't rush contributions, take your time and ensure you're doing it correctly.
+Before creating an issue, please ensure that it hasn't already been reported/suggested, and double-check the
+[documentation](https://old.discordjs.dev/#/docs).  
+See [the contribution guide](https://github.com/discordjs/discord.js/blob/main/.github/CONTRIBUTING.md) if you'd like to submit a PR.
 
 ## Help
 
-If you don't understand something in the documentation, you are experiencing problems, or you just need a gentle nudge in the right direction, please join our [Discord server][discord].
-
-[website]: https://discord.js.org
-[website-source]: https://github.com/discordjs/discord.js/tree/main/apps/website
-[documentation]: https://discord.js.org/docs
-[guide]: https://discordjs.guide/
-[guide-source]: https://github.com/discordjs/guide
-[guide-update]: https://discordjs.guide/additional-info/changes-in-v14.html
-[discord]: https://discord.gg/djs
-[discord-api]: https://discord.gg/discord-api
-[source]: https://github.com/discordjs/discord.js/tree/main/packages/discord.js
-[npm]: https://www.npmjs.com/package/discord.js
-[related-libs]: https://discord.com/developers/docs/topics/community-resources#libraries
-[rpc]: https://www.npmjs.com/package/discord-rpc
-[rpc-source]: https://github.com/discordjs/RPC
-[contributing]: https://github.com/discordjs/discord.js/blob/main/.github/CONTRIBUTING.md
-[github-releases]: https://github.com/discordjs/discord.js/releases
-[brokers-source]: https://github.com/discordjs/discord.js/tree/main/packages/brokers
-[builders-source]: https://github.com/discordjs/discord.js/tree/main/packages/builders
-[collection-source]: https://github.com/discordjs/discord.js/tree/main/packages/collection
-[core-source]: https://github.com/discordjs/discord.js/tree/main/packages/core
-[formatters-source]: https://github.com/discordjs/discord.js/tree/main/packages/formatters
-[proxy-source]: https://github.com/discordjs/discord.js/tree/main/packages/proxy
-[rest-source]: https://github.com/discordjs/discord.js/tree/main/packages/rest
-[voice-source]: https://github.com/discordjs/discord.js/tree/main/packages/voice
-[util-source]: https://github.com/discordjs/discord.js/tree/main/packages/util
-[ws-source]: https://github.com/discordjs/discord.js/tree/main/packages/ws
-[good-first-issue]: https://github.com/discordjs/discord.js/contribute
+If you don't understand something in the documentation, you are experiencing problems, or you just need a gentle
+nudge in the right direction, please don't hesitate to join our official [discord.js Server](https://discord.gg/djs).

api-extractor.json

@@ -1,423 +0,0 @@
-/**
- * Config file for API Extractor.  For more info, please visit: https://api-extractor.com
- */
-{
-	"$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
-
-	/**
-	 * Optionally specifies another JSON config file that this file extends from.  This provides a way for
-	 * standard settings to be shared across multiple projects.
-	 *
-	 * If the path starts with "./" or "../", the path is resolved relative to the folder of the file that contains
-	 * the "extends" field.  Otherwise, the first path segment is interpreted as an NPM package name, and will be
-	 * resolved using NodeJS require().
-	 *
-	 * SUPPORTED TOKENS: none
-	 * DEFAULT VALUE: ""
-	 */
-	// "extends": "./shared/api-extractor-base.json"
-	// "extends": "my-package/include/api-extractor-base.json"
-
-	/**
-	 * Determines the "<projectFolder>" token that can be used with other config file settings.  The project folder
-	 * typically contains the tsconfig.json and package.json config files, but the path is user-defined.
-	 *
-	 * The path is resolved relative to the folder of the config file that contains the setting.
-	 *
-	 * The default value for "projectFolder" is the token "<lookup>", which means the folder is determined by traversing
-	 * parent folders, starting from the folder containing api-extractor.json, and stopping at the first folder
-	 * that contains a tsconfig.json file.  If a tsconfig.json file cannot be found in this way, then an error
-	 * will be reported.
-	 *
-	 * SUPPORTED TOKENS: <lookup>
-	 * DEFAULT VALUE: "<lookup>"
-	 */
-	// "projectFolder": "..",
-
-	/**
-	 * (REQUIRED) Specifies the .d.ts file to be used as the starting point for analysis.  API Extractor
-	 * analyzes the symbols exported by this module.
-	 *
-	 * The file extension must be ".d.ts" and not ".ts".
-	 *
-	 * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-	 * prepend a folder token such as "<projectFolder>".
-	 *
-	 * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-	 */
-	"mainEntryPointFilePath": "<projectFolder>/dist-docs/index.d.ts",
-
-	/**
-	 * A list of NPM package names whose exports should be treated as part of this package.
-	 *
-	 * For example, suppose that Webpack is used to generate a distributed bundle for the project "library1",
-	 * and another NPM package "library2" is embedded in this bundle.  Some types from library2 may become part
-	 * of the exported API for library1, but by default API Extractor would generate a .d.ts rollup that explicitly
-	 * imports library2.  To avoid this, we can specify:
-	 *
-	 *   "bundledPackages": [ "library2" ],
-	 *
-	 * This would direct API Extractor to embed those types directly in the .d.ts rollup, as if they had been
-	 * local files for library1.
-	 */
-	"bundledPackages": [],
-
-	/**
-	 * Determines how the TypeScript compiler engine will be invoked by API Extractor.
-	 */
-	"compiler": {
-		/**
-		 * Specifies the path to the tsconfig.json file to be used by API Extractor when analyzing the project.
-		 *
-		 * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-		 * prepend a folder token such as "<projectFolder>".
-		 *
-		 * Note: This setting will be ignored if "overrideTsconfig" is used.
-		 *
-		 * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-		 * DEFAULT VALUE: "<projectFolder>/tsconfig.json"
-		 */
-		// "tsconfigFilePath": "<projectFolder>/tsconfig.json",
-		/**
-		 * Provides a compiler configuration that will be used instead of reading the tsconfig.json file from disk.
-		 * The object must conform to the TypeScript tsconfig schema:
-		 *
-		 * http://json.schemastore.org/tsconfig
-		 *
-		 * If omitted, then the tsconfig.json file will be read from the "projectFolder".
-		 *
-		 * DEFAULT VALUE: no overrideTsconfig section
-		 */
-		"overrideTsconfig": {
-			// Type Checking
-			"allowUnreachableCode": false,
-			"allowUnusedLabels": false,
-			"exactOptionalPropertyTypes": true,
-			"noFallthroughCasesInSwitch": true,
-			"noImplicitOverride": true,
-			"noImplicitReturns": true,
-			"noPropertyAccessFromIndexSignature": false,
-			"noUncheckedIndexedAccess": true,
-			"noUnusedLocals": true,
-			"noUnusedParameters": true,
-			"strict": true,
-
-			// Modules
-			"allowArbitraryExtensions": false,
-			"allowImportingTsExtensions": false,
-			"module": "ESNext",
-			"moduleResolution": "node",
-			"resolveJsonModule": true,
-			"resolvePackageJsonExports": false,
-			"resolvePackageJsonImports": false,
-
-			// Emit
-			"declaration": true,
-			"declarationMap": true,
-			"importHelpers": false,
-			"newLine": "lf",
-			"noEmitHelpers": true,
-			"outDir": "dist",
-			"removeComments": false,
-			"sourceMap": true,
-
-			// Interop Constraints
-			"esModuleInterop": false,
-			"forceConsistentCasingInFileNames": true,
-			"isolatedModules": true,
-
-			// Language and Environment
-			"experimentalDecorators": true,
-			"lib": ["ESNext"],
-			"target": "ES2022",
-			"useDefineForClassFields": true
-		}
-		/**
-		 * This option causes the compiler to be invoked with the --skipLibCheck option. This option is not recommended
-		 * and may cause API Extractor to produce incomplete or incorrect declarations, but it may be required when
-		 * dependencies contain declarations that are incompatible with the TypeScript engine that API Extractor uses
-		 * for its analysis.  Where possible, the underlying issue should be fixed rather than relying on skipLibCheck.
-		 *
-		 * DEFAULT VALUE: false
-		 */
-		// "skipLibCheck": true,
-	},
-
-	/**
-	 * Configures how the API report file (*.api.md) will be generated.
-	 */
-	"apiReport": {
-		/**
-		 * (REQUIRED) Whether to generate an API report.
-		 */
-		"enabled": false
-
-		/**
-		 * The filename for the API report files.  It will be combined with "reportFolder" or "reportTempFolder" to produce
-		 * a full file path.
-		 *
-		 * The file extension should be ".api.md", and the string should not contain a path separator such as "\" or "/".
-		 *
-		 * SUPPORTED TOKENS: <packageName>, <unscopedPackageName>
-		 * DEFAULT VALUE: "<unscopedPackageName>.api.md"
-		 */
-		// "reportFileName": "<unscopedPackageName>.api.md",
-
-		/**
-		 * Specifies the folder where the API report file is written.  The file name portion is determined by
-		 * the "reportFileName" setting.
-		 *
-		 * The API report file is normally tracked by Git.  Changes to it can be used to trigger a branch policy,
-		 * e.g. for an API review.
-		 *
-		 * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-		 * prepend a folder token such as "<projectFolder>".
-		 *
-		 * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-		 * DEFAULT VALUE: "<projectFolder>/temp/"
-		 */
-		// "reportFolder": "<projectFolder>/temp/",
-
-		/**
-		 * Specifies the folder where the temporary report file is written.  The file name portion is determined by
-		 * the "reportFileName" setting.
-		 *
-		 * After the temporary file is written to disk, it is compared with the file in the "reportFolder".
-		 * If they are different, a production build will fail.
-		 *
-		 * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-		 * prepend a folder token such as "<projectFolder>".
-		 *
-		 * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-		 * DEFAULT VALUE: "<projectFolder>/temp/"
-		 */
-		// "reportTempFolder": "<projectFolder>/temp/"
-	},
-
-	/**
-	 * Configures how the doc model file (*.api.json) will be generated.
-	 */
-	"docModel": {
-		/**
-		 * (REQUIRED) Whether to generate a doc model file.
-		 */
-		"enabled": true,
-
-		/**
-		 * The output path for the doc model file.  The file extension should be ".api.json".
-		 *
-		 * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-		 * prepend a folder token such as "<projectFolder>".
-		 *
-		 * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-		 * DEFAULT VALUE: "<projectFolder>/temp/<unscopedPackageName>.api.json"
-		 */
-		"apiJsonFilePath": "<projectFolder>/docs/docs.api.json"
-	},
-
-	/**
-	 * Configures how the .d.ts rollup file will be generated.
-	 */
-	"dtsRollup": {
-		/**
-		 * (REQUIRED) Whether to generate the .d.ts rollup file.
-		 */
-		"enabled": false,
-
-		/**
-		 * Specifies the output path for a .d.ts rollup file to be generated without any trimming.
-		 * This file will include all declarations that are exported by the main entry point.
-		 *
-		 * If the path is an empty string, then this file will not be written.
-		 *
-		 * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-		 * prepend a folder token such as "<projectFolder>".
-		 *
-		 * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-		 * DEFAULT VALUE: "<projectFolder>/dist/<unscopedPackageName>.d.ts"
-		 */
-		"untrimmedFilePath": "<projectFolder>/dist-docs/index.d.ts"
-
-		/**
-		 * Specifies the output path for a .d.ts rollup file to be generated with trimming for an "alpha" release.
-		 * This file will include only declarations that are marked as "@public", "@beta", or "@alpha".
-		 *
-		 * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-		 * prepend a folder token such as "<projectFolder>".
-		 *
-		 * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-		 * DEFAULT VALUE: ""
-		 */
-		// "alphaTrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>-alpha.d.ts",
-
-		/**
-		 * Specifies the output path for a .d.ts rollup file to be generated with trimming for a "beta" release.
-		 * This file will include only declarations that are marked as "@public" or "@beta".
-		 *
-		 * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-		 * prepend a folder token such as "<projectFolder>".
-		 *
-		 * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-		 * DEFAULT VALUE: ""
-		 */
-		// "betaTrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>-beta.d.ts",
-
-		/**
-		 * Specifies the output path for a .d.ts rollup file to be generated with trimming for a "public" release.
-		 * This file will include only declarations that are marked as "@public".
-		 *
-		 * If the path is an empty string, then this file will not be written.
-		 *
-		 * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-		 * prepend a folder token such as "<projectFolder>".
-		 *
-		 * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-		 * DEFAULT VALUE: ""
-		 */
-		// "publicTrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>-public.d.ts",
-
-		/**
-		 * When a declaration is trimmed, by default it will be replaced by a code comment such as
-		 * "Excluded from this release type: exampleMember".  Set "omitTrimmingComments" to true to remove the
-		 * declaration completely.
-		 *
-		 * DEFAULT VALUE: false
-		 */
-		// "omitTrimmingComments": true
-	},
-
-	/**
-	 * Configures how the tsdoc-metadata.json file will be generated.
-	 */
-	"tsdocMetadata": {
-		/**
-		 * Whether to generate the tsdoc-metadata.json file.
-		 *
-		 * DEFAULT VALUE: true
-		 */
-		// "enabled": true,
-		/**
-		 * Specifies where the TSDoc metadata file should be written.
-		 *
-		 * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-		 * prepend a folder token such as "<projectFolder>".
-		 *
-		 * The default value is "<lookup>", which causes the path to be automatically inferred from the "tsdocMetadata",
-		 * "typings" or "main" fields of the project's package.json.  If none of these fields are set, the lookup
-		 * falls back to "tsdoc-metadata.json" in the package folder.
-		 *
-		 * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-		 * DEFAULT VALUE: "<lookup>"
-		 */
-		// "tsdocMetadataFilePath": "<projectFolder>/dist/tsdoc-metadata.json"
-	},
-
-	/**
-	 * Specifies what type of newlines API Extractor should use when writing output files.  By default, the output files
-	 * will be written with Windows-style newlines.  To use POSIX-style newlines, specify "lf" instead.
-	 * To use the OS's default newline kind, specify "os".
-	 *
-	 * DEFAULT VALUE: "crlf"
-	 */
-	"newlineKind": "lf",
-
-	/**
-	 * Configures how API Extractor reports error and warning messages produced during analysis.
-	 *
-	 * There are three sources of messages:  compiler messages, API Extractor messages, and TSDoc messages.
-	 */
-	"messages": {
-		/**
-		 * Configures handling of diagnostic messages reported by the TypeScript compiler engine while analyzing
-		 * the input .d.ts files.
-		 *
-		 * TypeScript message identifiers start with "TS" followed by an integer.  For example: "TS2551"
-		 *
-		 * DEFAULT VALUE:  A single "default" entry with logLevel=warning.
-		 */
-		"compilerMessageReporting": {
-			/**
-			 * Configures the default routing for messages that don't match an explicit rule in this table.
-			 */
-			"default": {
-				/**
-				 * Specifies whether the message should be written to the the tool's output log.  Note that
-				 * the "addToApiReportFile" property may supersede this option.
-				 *
-				 * Possible values: "error", "warning", "none"
-				 *
-				 * Errors cause the build to fail and return a nonzero exit code.  Warnings cause a production build fail
-				 * and return a nonzero exit code.  For a non-production build (e.g. when "api-extractor run" includes
-				 * the "--local" option), the warning is displayed but the build will not fail.
-				 *
-				 * DEFAULT VALUE: "warning"
-				 */
-				"logLevel": "warning"
-
-				/**
-				 * When addToApiReportFile is true:  If API Extractor is configured to write an API report file (.api.md),
-				 * then the message will be written inside that file; otherwise, the message is instead logged according to
-				 * the "logLevel" option.
-				 *
-				 * DEFAULT VALUE: false
-				 */
-				// "addToApiReportFile": false
-			}
-
-			// "TS2551": {
-			//   "logLevel": "warning",
-			//   "addToApiReportFile": true
-			// },
-			//
-			// . . .
-		},
-
-		/**
-		 * Configures handling of messages reported by API Extractor during its analysis.
-		 *
-		 * API Extractor message identifiers start with "ae-".  For example: "ae-extra-release-tag"
-		 *
-		 * DEFAULT VALUE: See api-extractor-defaults.json for the complete table of extractorMessageReporting mappings
-		 */
-		"extractorMessageReporting": {
-			"default": {
-				"logLevel": "warning"
-				// "addToApiReportFile": false
-			},
-
-			// Disable the following warning:
-			// (ae-missing-release-tag) "x" is part of the package's API, but it is missing a release tag (@alpha, @beta, @public, or @internal)
-			"ae-missing-release-tag": {
-				"logLevel": "none"
-			}
-
-			// "ae-extra-release-tag": {
-			//   "logLevel": "warning",
-			//   "addToApiReportFile": true
-			// },
-			//
-			// . . .
-		},
-
-		/**
-		 * Configures handling of messages reported by the TSDoc parser when analyzing code comments.
-		 *
-		 * TSDoc message identifiers start with "tsdoc-".  For example: "tsdoc-link-tag-unescaped-text"
-		 *
-		 * DEFAULT VALUE:  A single "default" entry with logLevel=warning.
-		 */
-		"tsdocMessageReporting": {
-			"default": {
-				"logLevel": "warning"
-				// "addToApiReportFile": false
-			}
-
-			// "tsdoc-link-tag-unescaped-text": {
-			//   "logLevel": "warning",
-			//   "addToApiReportFile": true
-			// },
-			//
-			// . . .
-		}
-	}
-}

apps/guide/.env.development

@@ -1 +0,0 @@
-METADATA_BASE_URL=http://localhost:3000

apps/guide/.gitignore

@@ -1,28 +0,0 @@
-# Packages
-node_modules
-
-# Log files
-logs
-*.log
-npm-debug.log*
-
-# Runtime data
-pids
-*.pid
-*.seed
-
-# Env
-.env
-.env*.local
-
-# Dist
-.contentlayer
-.next
-public/searchIndex
-src/styles/unocss.css
-
-# Miscellaneous
-.tmp
-.vscode
-lighthouse-results
-

apps/guide/.lintstagedrc.js

@@ -1 +0,0 @@
-module.exports = require('../../.lintstagedrc.json');

apps/guide/.prettierignore

@@ -1,7 +0,0 @@
-.contentlayer
-.next
-.turbo
-.vscode
-coverage
-src/styles/unocss.css
-next-env.d.ts

apps/guide/.prettierrc.js

@@ -1,2 +0,0 @@
-/** @type {import('prettier').Config} */
-module.exports = require('../../.prettierrc.json');

apps/guide/README.md

@@ -1,52 +0,0 @@
-<div align="center">
-	<br />
-	<p>
-		<a href="https://discord.js.org"><img src="https://discord.js.org/static/logo.svg" width="546" alt="discord.js" /></a>
-	</p>
-	<br />
-	<p>
-		<a href="https://discord.gg/djs"><img src="https://img.shields.io/discord/222078108977594368?color=5865F2&logo=discord&logoColor=white" alt="Discord server" /></a>
-		<a href="https://github.com/discordjs/discord.js/actions"><img src="https://github.com/discordjs/discord.js/actions/workflows/test.yml/badge.svg" alt="Build status" /></a>
-	</p>
-	<p>
-		<a href="https://vercel.com/?utm_source=discordjs&utm_campaign=oss"><img src="https://raw.githubusercontent.com/discordjs/discord.js/main/.github/powered-by-vercel.svg" alt="Vercel" /></a>
-		<a href="https://www.cloudflare.com"><img src="https://raw.githubusercontent.com/discordjs/discord.js/main/.github/powered-by-workers.png" alt="Cloudflare Workers" height="44" /></a>
-	</p>
-</div>
-
-## About
-
-The official guide for discord.js, made to help you get started easily with the library.
-
-## Links
-
-- [Website][website] ([source][website-source])
-- [Documentation][documentation]
-- [Guide][guide] ([source][guide-source])
-  Also see the v13 to v14 [Update Guide][guide-update], which includes updated and removed items from the library.
-- [discord.js Discord server][discord]
-- [Discord API Discord server][discord-api]
-- [GitHub][source]
-- [Related libraries][related-libs]
-
-## Contributing
-
-Before creating an issue, please ensure that it hasn't already been reported/suggested, and double-check the
-[documentation][documentation].  
-See [the contribution guide][contributing] if you'd like to submit a PR.
-
-## Help
-
-If you don't understand something in the documentation, you are experiencing problems, or you just need a gentle nudge in the right direction, please don't hesitate to join our official [discord.js Server][discord].
-
-[website]: https://discord.js.org
-[website-source]: https://github.com/discordjs/discord.js/tree/main/apps/website
-[documentation]: https://discord.js.org/docs
-[guide]: https://discordjs.guide/
-[guide-source]: https://github.com/discordjs/guide
-[guide-update]: https://discordjs.guide/additional-info/changes-in-v14.html
-[discord]: https://discord.gg/djs
-[discord-api]: https://discord.gg/discord-api
-[source]: https://github.com/discordjs/discord.js/tree/main/apps/guide
-[related-libs]: https://discord.com/developers/docs/topics/community-resources#libraries
-[contributing]: https://github.com/discordjs/discord.js/blob/main/.github/CONTRIBUTING.md

apps/guide/contentlayer.config.ts

@@ -1,94 +0,0 @@
-import { remarkCodeHike } from '@code-hike/mdx';
-import { defineDocumentType, makeSource } from 'contentlayer/source-files';
-import { type Node, toString } from 'hast-util-to-string';
-import { h } from 'hastscript';
-import { escape } from 'html-escaper';
-import rehypeAutolinkHeadings from 'rehype-autolink-headings';
-import rehypeSlug from 'rehype-slug';
-import remarkGfm from 'remark-gfm';
-import codeHikeThemeDarkPlus from './src/styles/code-hike-theme-dark-plus.json';
-
-export const Content = defineDocumentType(() => ({
-	name: 'Content',
-	filePathPattern: `**/*.mdx`,
-	contentType: 'mdx',
-	fields: {
-		title: {
-			type: 'string',
-			required: true,
-		},
-		category: {
-			type: 'string',
-			required: true,
-		},
-	},
-	computedFields: {
-		slug: {
-			type: 'string',
-			// eslint-disable-next-line unicorn/prefer-string-replace-all
-			resolve: (doc) => doc._raw.flattenedPath.replace(/\d+-/g, ''),
-		},
-		url: {
-			type: 'string',
-			// eslint-disable-next-line unicorn/prefer-string-replace-all
-			resolve: (doc) => `/guide/${doc._raw.flattenedPath.replace(/\d+-/g, '')}`,
-		},
-	},
-}));
-
-const LinkIcon = h(
-	'svg',
-	{
-		width: '1.25rem',
-		height: '1.25rem',
-		viewBox: '0 0 24 24',
-		fill: 'none',
-		stroke: 'currentColor',
-		strokeWidth: '2',
-		strokeLinecap: 'round',
-		strokeLinejoin: 'round',
-	},
-	h('path', {
-		// eslint-disable-next-line id-length
-		d: 'M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71',
-	}),
-	h('path', {
-		// eslint-disable-next-line id-length
-		d: 'M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71',
-	}),
-);
-
-const createSROnlyLabel = (text: any) => {
-	return h('span', { class: 'sr-only' }, `Section titled ${escape(text)}`);
-};
-
-export default makeSource({
-	contentDirPath: 'src/content',
-	documentTypes: [Content],
-	mdx: {
-		remarkPlugins: [remarkGfm, [remarkCodeHike, { theme: codeHikeThemeDarkPlus, lineNumbers: true }]],
-		rehypePlugins: [
-			rehypeSlug,
-			[
-				rehypeAutolinkHeadings,
-				{
-					properties: {
-						class:
-							'relative inline-flex place-items-center place-content-center outline-none text-black dark:text-white pr-2 -ml-8 opacity-0 group-hover:opacity-100',
-					},
-					behavior: 'prepend',
-					content: (heading: Node) => [
-						h(
-							`span.anchor-icon`,
-							{
-								ariaHidden: 'true',
-							},
-							LinkIcon,
-						),
-						createSROnlyLabel(toString(heading)),
-					],
-				},
-			],
-		],
-	},
-});

apps/guide/next-env.d.ts

@@ -1,5 +0,0 @@
-/// <reference types="next" />
-/// <reference types="next/image-types/global" />
-
-// NOTE: This file should not be edited
-// see https://nextjs.org/docs/basic-features/typescript for more information.

apps/guide/next.config.js

@@ -1,25 +0,0 @@
-/* eslint-disable @typescript-eslint/no-var-requires */
-/* eslint-disable @typescript-eslint/no-require-imports */
-// import bundleAnalyzer from '@next/bundle-analyzer';
-// import { withContentlayer } from 'next-contentlayer';
-const bundleAnalyzer = require('@next/bundle-analyzer');
-const { withContentlayer } = require('next-contentlayer');
-
-const withBundleAnalyzer = bundleAnalyzer({
-	enabled: process.env.ANALYZE === 'true',
-});
-
-module.exports = withBundleAnalyzer(
-	withContentlayer({
-		reactStrictMode: true,
-		experimental: {
-			typedRoutes: true,
-		},
-		images: {
-			dangerouslyAllowSVG: true,
-			contentDispositionType: 'attachment',
-			contentSecurityPolicy: "default-src 'self'; frame-src 'none'; sandbox;",
-		},
-		poweredByHeader: false,
-	}),
-);

apps/guide/package.json

@@ -1,99 +0,0 @@
-{
-	"$schema": "https://json.schemastore.org/package.json",
-	"name": "@discordjs/guide",
-	"version": "0.1.0",
-	"description": "Imagine a guide... that explores the many possibilities for your discord.js bot",
-	"private": true,
-	"scripts": {
-		"test": "vitest run",
-		"build:check": "tsc --noEmit",
-		"build:local": "pnpm run build:prod",
-		"build:prod": "next build",
-		"build:analyze": "cross-env ANALYZE=true pnpm run build:prod",
-		"preview": "next start",
-		"dev": "next dev",
-		"generate:contentlayer": "contentlayer build",
-		"lint": "pnpm run build:check && prettier --check . && cross-env TIMING=1 eslint --format=pretty src",
-		"format": "pnpm run build:check && prettier --write . && cross-env TIMING=1 eslint --fix --format=pretty src",
-		"fmt": "pnpm run format"
-	},
-	"type": "commonjs",
-	"directories": {
-		"lib": "src"
-	},
-	"contributors": [
-		"Crawl <icrawltogo@gmail.com>"
-	],
-	"license": "Apache-2.0",
-	"keywords": [
-		"discord",
-		"api",
-		"bot",
-		"client",
-		"node",
-		"discordapp",
-		"discordjs"
-	],
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/discordjs/discord.js.git",
-		"directory": "apps/guide"
-	},
-	"bugs": {
-		"url": "https://github.com/discordjs/discord.js/issues"
-	},
-	"homepage": "https://discord.js.org",
-	"dependencies": {
-		"@code-hike/mdx": "^0.9.0",
-		"@discordjs/ui": "workspace:^",
-		"@react-icons/all-files": "^4.1.0",
-		"@vercel/analytics": "^1.1.1",
-		"@vercel/edge-config": "^0.4.1",
-		"@vercel/og": "^0.5.20",
-		"ariakit": "2.0.0-next.44",
-		"cmdk": "^0.2.0",
-		"contentlayer": "^0.3.4",
-		"next": "14.0.3-canary.2",
-		"next-contentlayer": "^0.3.4",
-		"next-themes": "^0.2.1",
-		"react": "^18.2.0",
-		"react-custom-scrollbars-2": "^4.5.0",
-		"react-dom": "^18.2.0",
-		"rehype-autolink-headings": "^6.1.1",
-		"rehype-slug": "^5.1.0",
-		"remark-gfm": "^3.0.1",
-		"sharp": "^0.32.6"
-	},
-	"devDependencies": {
-		"@next/bundle-analyzer": "14.0.3-canary.2",
-		"@testing-library/react": "^14.1.0",
-		"@testing-library/user-event": "^14.5.1",
-		"@types/html-escaper": "^3.0.2",
-		"@types/node": "18.18.8",
-		"@types/react": "^18.2.37",
-		"@types/react-dom": "^18.2.15",
-		"@unocss/eslint-plugin": "^0.57.3",
-		"@unocss/postcss": "^0.57.3",
-		"@unocss/reset": "^0.57.3",
-		"@vitejs/plugin-react": "^4.1.1",
-		"@vitest/coverage-v8": "^0.34.6",
-		"cross-env": "^7.0.3",
-		"eslint": "^8.53.0",
-		"eslint-config-neon": "^0.1.57",
-		"eslint-formatter-pretty": "^5.0.0",
-		"happy-dom": "^12.10.3",
-		"hast-util-to-string": "^2.0.0",
-		"hastscript": "^8.0.0",
-		"html-escaper": "^3.0.3",
-		"postcss": "^8.4.31",
-		"prettier": "^3.0.3",
-		"turbo": "^1.10.17-canary.0",
-		"typescript": "^5.2.2",
-		"unocss": "^0.57.3",
-		"vercel": "^32.5.3",
-		"vitest": "^0.34.6"
-	},
-	"engines": {
-		"node": ">=18"
-	}
-}

apps/guide/postcss.config.cjs

@@ -1,5 +0,0 @@
-module.exports = {
-	plugins: {
-		'@unocss/postcss': {},
-	},
-};

apps/guide/public/browserconfig.xml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<browserconfig>
-    <msapplication>
-        <tile>
-            <square70x70logo src="/mstile-70x70.png"/>
-            <square150x150logo src="/mstile-150x150.png"/>
-            <square310x310logo src="/mstile-310x310.png"/>
-            <wide310x150logo src="/mstile-310x150.png"/>
-            <TileColor>#090a16</TileColor>
-        </tile>
-    </msapplication>
-</browserconfig>

apps/guide/public/safari-pinned-tab.svg

@@ -1,32 +0,0 @@
-<?xml version="1.0" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
- "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
-<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
- width="400.000000pt" height="400.000000pt" viewBox="0 0 400.000000 400.000000"
- preserveAspectRatio="xMidYMid meet">
-<metadata>
-Created by potrace 1.14, written by Peter Selinger 2001-2017
-</metadata>
-<g transform="translate(0.000000,400.000000) scale(0.100000,-0.100000)"
-fill="#000000" stroke="none">
-<path d="M0 2000 l0 -2000 2000 0 2000 0 0 2000 0 2000 -2000 0 -2000 0 0
--2000z m1305 795 c219 -47 373 -197 421 -411 24 -109 16 -315 -16 -399 l-23
--61 -59 -11 c-110 -21 -182 -92 -203 -202 -11 -56 -11 -56 -68 -79 -76 -30
--201 -42 -464 -42 l-223 0 0 610 0 610 283 0 c210 0 300 -4 352 -15z m890
--585 c0 -543 -2 -601 -18 -659 -56 -198 -190 -334 -365 -370 -176 -37 -349 5
--471 115 -48 44 -111 134 -111 161 0 6 19 14 43 18 23 4 73 18 110 32 l68 24
-50 -45 c56 -50 98 -66 175 -66 100 0 207 81 234 178 6 23 10 251 10 625 l0
-588 138 -3 137 -3 0 -595z m930 570 c93 -29 197 -84 252 -134 l44 -41 -61 -75
-c-34 -41 -67 -81 -74 -88 -10 -10 -25 -4 -78 32 -95 63 -154 81 -268 81 -79 0
--103 -4 -142 -23 -62 -31 -90 -71 -96 -137 -8 -94 28 -137 168 -202 157 -73
-172 -80 240 -108 236 -97 341 -215 356 -400 16 -193 -82 -363 -258 -449 -91
--45 -187 -66 -303 -66 -191 0 -390 74 -524 195 l-40 37 80 93 80 94 73 -53
-c168 -121 353 -155 491 -92 72 33 108 82 113 155 9 122 -37 162 -323 286 -258
-111 -350 179 -407 300 -69 148 -37 343 75 463 61 65 195 133 300 152 79 14
-222 4 302 -20z m-1367 -977 c45 -34 65 -69 70 -125 4 -61 -19 -106 -77 -145
--90 -60 -226 3 -238 111 -3 24 -3 56 1 70 8 34 54 86 91 102 40 19 120 12 153
--13z"/>
-<path d="M967 2543 c-4 -3 -7 -159 -7 -346 l0 -339 128 4 c101 3 136 8 172 24
-106 48 162 145 168 292 10 214 -69 334 -238 361 -73 12 -213 15 -223 4z"/>
-</g>
-</svg>