feat: rpc

.github/CODEOWNERS

@@ -26,6 +26,7 @@ pnpm-lock.yaml @discordjs/core
 /packages/proxy/ @discordjs/proxy
 /packages/proxy-container/ @discordjs/proxy
 /packages/rest/ @discordjs/rest
+/packages/rpc/ @discordjs/rpc
 /packages/scripts/ @discordjs/scripts
 /packages/structures/ @discordjs/structures
 /packages/ui/ @discordjs/ui

.github/ISSUE_TEMPLATE/01-package_bug_report.yml

@@ -24,6 +24,7 @@ body:
         - proxy
         - proxy-container
         - rest
+        - rpc
         - structures
         - ui
         - util

.github/ISSUE_TEMPLATE/03-feature_request.yml

@@ -26,6 +26,7 @@ body:
         - proxy
         - proxy-container
         - rest
+        - rpc
         - structures
         - ui
         - util

.github/issue-labeler.yml

@@ -37,6 +37,9 @@ packages:proxy-container:
 packages:rest:
   - "### Which (application|package|application or package) is this (bug
     report|feature request) for\\?\\n\\nrest\\n"
+packages:rpc:
+  - "### Which (application|package|application or package) is this (bug
+    report|feature request) for\\?\\n\\nrpc\\n"
 packages:structures:
   - "### Which (application|package|application or package) is this (bug
     report|feature request) for\\?\\n\\nstructures\\n"

.github/labeler.yml

@@ -78,6 +78,11 @@ packages:rest:
       - any-glob-to-any-file:
           - packages/rest/*
           - packages/rest/**/*
+packages:rpc:
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/rpc/*
+          - packages/rpc/**/*
 packages:structures:
   - changed-files:
       - any-glob-to-any-file:

.github/labels.yml

@@ -80,6 +80,8 @@
   color: fbca04
 - name: packages:rest
   color: fbca04
+- name: packages:rpc
+  color: fbca04
 - name: packages:structures
   color: fbca04
 - name: packages:ui

.github/workflows/deprecate-version.yml

@@ -17,6 +17,7 @@ on:
           - '@discordjs/next'
           - '@discordjs/proxy'
           - '@discordjs/rest'
+          - '@discordjs/rpc'
           - '@discordjs/structures'
           - '@discordjs/util'
           - '@discordjs/voice'

.github/workflows/documentation.yml

@@ -86,7 +86,7 @@ jobs:
       - name: Build docs with main api-extractor
         if: ${{ inputs.ref && inputs.ref != 'main' }}
         run: |
-          declare -a PACKAGES=("brokers" "builders" "collection" "core" "discord.js" "formatters" "next" "proxy" "rest" "structures" "util" "voice" "ws")
+          declare -a PACKAGES=("brokers" "builders" "collection" "core" "discord.js" "formatters" "next" "proxy" "rest" "rpc" "structures" "util" "voice" "ws")
           for PACKAGE in "${PACKAGES[@]}"; do
             cd "packages/${PACKAGE}"
             sed -i 's!https://github.com/discordjs/discord.js/tree/main!https://github.com/discordjs/discord.js/tree/${{ inputs.ref }}!' api-extractor.json
@@ -219,7 +219,7 @@ jobs:
       - name: Move docs to correct directory
         if: ${{ env.REF_TYPE == 'branch' }}
         run: |
-          declare -a PACKAGES=("brokers" "builders" "collection" "core" "discord.js" "formatters" "next" "proxy" "rest" "structures" "util" "voice" "ws")
+          declare -a PACKAGES=("brokers" "builders" "collection" "core" "discord.js" "formatters" "next" "proxy" "rest" "rpc" "structures" "util" "voice" "ws")
           for PACKAGE in "${PACKAGES[@]}"; do
             if [[ "${PACKAGE}" == "discord.js" ]]; then
               mkdir -p "out/${PACKAGE}"

.github/workflows/release.yml

@@ -23,6 +23,7 @@ on:
           - '@discordjs/next'
           - '@discordjs/proxy'
           - '@discordjs/rest'
+          - '@discordjs/rpc'
           - '@discordjs/structures'
           - '@discordjs/util'
           - '@discordjs/voice'

README.md

@@ -33,6 +33,7 @@ This repository contains multiple packages with separate [releases][github-relea
 - `@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/rpc` ([source][rpc-source]) - A simple RPC client for Discord
 - `@discordjs/structures` ([source][structures-source]) - A wrapper around Discord's structures
 - `@discordjs/voice` ([source][voice-source]) - A module for interacting with the Discord Voice API
 - `@discordjs/util` ([source][util-source]) - A collection of utility functions
@@ -50,10 +51,6 @@ This repository contains multiple packages with separate [releases][github-relea
 - [npm][npm]
 - [Related libraries][related-libs]
 
-### Extensions
-
-- [RPC][rpc] ([source][rpc-source])
-
 ## 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.
@@ -73,8 +70,6 @@ If you don't understand something in the documentation, you are experiencing pro
 [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
@@ -84,6 +79,7 @@ If you don't understand something in the documentation, you are experiencing pro
 [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
+[rpc-source]: https://github.com/discordjs/discord.js/tree/main/packages/rpc
 [structures-source]: https://github.com/discordjs/discord.js/tree/main/packages/structures
 [voice-source]: https://github.com/discordjs/discord.js/tree/main/packages/voice
 [util-source]: https://github.com/discordjs/discord.js/tree/main/packages/util

apps/website/package.json

@@ -5,7 +5,7 @@
 	"description": "Imagine a bot... the most popular way to build discord bots",
 	"private": true,
 	"scripts": {
-		"build:copy_readme": "cpy \"../../packages/(discord.js|brokers|builders|collection|core|formatters|next|proxy|rest|structures|util|voice|ws)/README.md\" \"src/assets/readme\" --rename='home-{{basename}}'",
+		"build:copy_readme": "cpy \"../../packages/(discord.js|brokers|builders|collection|core|formatters|next|proxy|rest|rpc|structures|util|voice|ws)/README.md\" \"src/assets/readme\" --rename='home-{{basename}}'",
 		"build:check": "tsc --noEmit",
 		"build:local": "cross-env NEXT_PUBLIC_LOCAL_DEV=true pnpm run build:prod",
 		"build:prod": "pnpm run build:copy_readme && pnpm run build:next",

apps/website/src/util/constants.ts

@@ -9,6 +9,7 @@ export const PACKAGES = [
 	{ name: 'next' },
 	{ name: 'proxy' },
 	{ name: 'rest' },
+	{ name: 'rpc' },
 	{ name: 'structures' },
 	{ name: 'util' },
 	{ name: 'voice' },

packages/actions/src/uploadCoverage/action.yml

@@ -88,6 +88,15 @@ runs:
         flags: rest
         token: ${{ inputs.CODECOV_TOKEN }}
 
+    - name: Upload RPC Coverage
+      if: ${{ hashFiles('packages/rpc/coverage/cobertura-coverage.xml') != '' }}
+      uses: codecov/codecov-action@v4
+      with:
+        files: ./packages/rpc/coverage/cobertura-coverage.xml
+        disable_search: true
+        flags: rpc
+        token: ${{ inputs.CODECOV_TOKEN }}
+
     - name: Upload Structures Coverage
       if: ${{ hashFiles('packages/structures/coverage/cobertura-coverage.xml') != '' }}
       uses: codecov/codecov-action@v4

packages/discord.js/README.md

@@ -142,6 +142,6 @@ If you don't understand something in the documentation, you are experiencing pro
 [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
+[rpc]: https://www.npmjs.com/package/@discordjs/rpc
+[rpc-source]: https://github.com/discordjs/discord.js/tree/main/packages/rpc
 [contributing]: https://github.com/discordjs/discord.js/blob/main/.github/CONTRIBUTING.md

packages/rpc/.cliff-jumperrc.json

@@ -0,0 +1,6 @@
+{
+	"name": "rpc",
+	"org": "discordjs",
+	"packagePath": "packages/rpc",
+	"identifierBase": false
+}

packages/rpc/.gitignore

@@ -0,0 +1,28 @@
+# Packages
+node_modules
+
+# Log files
+logs
+*.log
+npm-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+
+# Env
+.env
+
+# Dist
+dist
+dist-docs
+
+# Docs
+docs/**/*
+!docs/README.md
+
+# Miscellaneous
+.turbo
+.tmp
+coverage

packages/rpc/.lintstagedrc.js

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

packages/rpc/.prettierignore

@@ -0,0 +1,7 @@
+.turbo
+coverage
+dist
+dist-docs
+docs/docs.api.json
+CHANGELOG.md
+tsup.config.bundled*

packages/rpc/.prettierrc.js

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

packages/rpc/LICENSE

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

packages/rpc/api-extractor.json

@@ -0,0 +1,6 @@
+{
+	"extends": "../../api-extractor.json",
+	"docModel": {
+		"projectFolderUrl": "https://github.com/discordjs/discord.js/tree/main/packages/rpc"
+	}
+}

packages/rpc/cliff.toml

@@ -0,0 +1,79 @@
+[changelog]
+header = """
+# Changelog
+
+All notable changes to this project will be documented in this file.\n
+"""
+body = """
+{%- macro remote_url() -%}
+  https://github.com/{{ remote.github.owner }}/{{ remote.github.repo }}
+{%- endmacro -%}
+{% if version %}\
+	# [{{ version | trim_start_matches(pat="v") }}]\
+	{% if previous %}\
+		{% if previous.version %}\
+			({{ self::remote_url() }}/compare/{{ previous.version }}...{{ version }})\
+		{% else %}\
+			({{ self::remote_url() }}/tree/{{ version }})\
+		{% endif %}\
+	{% endif %} \
+	- ({{ timestamp | date(format="%Y-%m-%d") }})
+{% else %}\
+	# [unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+	## {{ group | upper_first }}
+	{% for commit in commits %}
+		- {% if commit.scope %}\
+			**{{commit.scope}}:** \
+		  {% endif %}\
+			{{ commit.message | upper_first }} ([{{ commit.id | truncate(length=7, end="") }}]({{ self::remote_url() }}/commit/{{ commit.id }}))\
+			{% if commit.github.username %} by @{{ commit.github.username }}{%- endif %}\
+		{% if commit.breaking %}\
+			{% for footer in commit.footers %}\
+				{% if footer.breaking %}\
+					\n{% raw %}  {% endraw %}- **{{ footer.token }}{{ footer.separator }}** {{ footer.value }}\
+				{% endif %}\
+			{% endfor %}\
+		{% endif %}\
+	{% endfor %}
+{% endfor %}\
+{% if github.contributors | filter(attribute="is_first_time", value=true) | length %}\
+	\n### New Contributors\n
+	{% for contributor in github.contributors | filter(attribute="is_first_time", value=true) %}\
+		* @{{ contributor.username }} made their first contribution in #{{ contributor.pr_number }}
+	{% endfor %}\
+{% endif %}\n
+"""
+trim = true
+footer = ""
+
+[git]
+conventional_commits = true
+filter_unconventional = true
+commit_parsers = [
+	{ message = "^feat", group = "Features"},
+	{ message = "^fix", group = "Bug Fixes"},
+	{ message = "^docs", group = "Documentation"},
+	{ message = "^perf", group = "Performance"},
+	{ message = "^refactor", group = "Refactor"},
+	{ message = "^types", group = "Typings"},
+	{ message = ".*deprecated", body = ".*deprecated", group = "Deprecation"},
+	{ message = "^revert", skip = true},
+	{ message = "^style", group = "Styling"},
+	{ message = "^test", group = "Testing"},
+	{ message = "^chore", skip = true},
+	{ message = "^ci", skip = true},
+	{ message = "^build", skip = true},
+	{ body = ".*security", group = "Security"},
+]
+filter_commits = true
+protect_breaking_commits = true
+tag_pattern = "@discordjs/rpc@[0-9]*"
+ignore_tags = ""
+topo_order = false
+sort_commits = "newest"
+
+[remote.github]
+owner = "discordjs"
+repo = "discord.js"

packages/rpc/docs/README.md

@@ -0,0 +1 @@
+## [View the documentation here.](https://discord.js.org/docs/packages/rpc/main)

packages/rpc/examples/boops-javascript/.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true

packages/rpc/examples/boops-javascript/.eslintignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+out
+.gitignore

packages/rpc/examples/boops-javascript/.eslintrc.cjs

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: ['eslint:recommended', '@electron-toolkit', '@electron-toolkit/eslint-config-prettier']
+}

packages/rpc/examples/boops-javascript/.gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+out
+.DS_Store
+*.log*

packages/rpc/examples/boops-javascript/.npmrc

@@ -0,0 +1 @@
+shamefully-hoist=true

packages/rpc/examples/boops-javascript/.prettierignore

@@ -0,0 +1,6 @@
+out
+dist
+pnpm-lock.yaml
+LICENSE.md
+tsconfig.json
+tsconfig.*.json

packages/rpc/examples/boops-javascript/.prettierrc.yaml

@@ -0,0 +1,4 @@
+singleQuote: true
+semi: false
+printWidth: 100
+trailingComma: none