nodejs · targos · Sep 7, 2021 · Aug 30, 2021 · Aug 30, 2021 · Mar 27, 2019
diff --git a/.eslintrc.js b/.eslintrc.js
@@ -18,6 +18,7 @@ const hacks = [
   'eslint-plugin-markdown',
   '@babel/eslint-parser',
   '@babel/plugin-syntax-class-properties',
+  '@babel/plugin-syntax-import-assertions',
   '@babel/plugin-syntax-top-level-await',
 ];
 Module._findPath = (request, paths, isMain) => {
@@ -41,6 +42,7 @@ module.exports = {
     babelOptions: {
       plugins: [
         Module._findPath('@babel/plugin-syntax-class-properties'),
+        Module._findPath('@babel/plugin-syntax-import-assertions'),
         Module._findPath('@babel/plugin-syntax-top-level-await'),
       ],
     },

diff --git a/.github/workflows/authors.yml b/.github/workflows/authors.yml
@@ -12,11 +12,11 @@ jobs:
       - run: "tools/update-authors.js" # run the AUTHORS tool
       - uses: gr2m/create-or-update-pull-request-action@v1 # create a PR or update the Action's existing PR
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GH_USER_TOKEN }}
         with:
-          title: "meta: update AUTHORS"
+          author: Node.js GitHub Bot <[email protected]>
           body: "If this PR exists, there's presumably new additions to the AUTHORS file. This is an automatically generated PR by the `authors.yml` GitHub Action, which runs `tools/update-authors.js` and submits a new PR or updates an existing PR.\n\nPlease note that there might be duplicate entries. If there are, please remove them and add the duplicate emails to .mailmap directly to this PR."
           branch: "actions/authors-update" # custom branch *just* for this Action.
           commit-message: "meta: update AUTHORS"
-          author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
           labels: meta
+          title: "meta: update AUTHORS"
diff --git a/.github/workflows/find-inactive-collaborators.yml b/.github/workflows/find-inactive-collaborators.yml
@@ -32,9 +32,9 @@ jobs:
       - name: Open pull request
         uses: gr2m/create-or-update-pull-request-action@v1
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GH_USER_TOKEN }}
         with:
-          author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
+          author: Node.js GitHub Bot <github-bot@iojs.org>
           body: This PR was generated by tools/find-inactive-collaborators.yml.
           commit-message: "meta: move one or more collaborators to emeritus"
           labels: meta

diff --git a/.gitignore b/.gitignore
@@ -62,6 +62,7 @@ _UpgradeReport_Files/
 *.wixobj
 /tools/msvs/genfiles/
 /npm.wxs
+/corepack.wxs
 /tools/msvs/msi/Release/
 /tools/msvs/msi/obj/
 /tools/msvs/msi/x64/

diff --git a/.mailmap b/.mailmap
@@ -26,6 +26,7 @@ Andreas Offenhaeuser <[email protected]>
 Andrew Hughes <[email protected]> <[email protected]>
 Andy Bettisworth <[email protected]>
 Angel Stoyanov <[email protected]>
+Anna Henningsen <[email protected]> <[email protected]>
 Anna Henningsen <[email protected]> <[email protected]>
 Anna Henningsen <[email protected]> <[email protected]>
 Anna Magdalena Kedzierska <[email protected]> <[email protected]>
@@ -122,6 +123,7 @@ Elliott Cable <[email protected]>
 Eric Phetteplace <[email protected]>
 Ernesto Salazar <[email protected]>
 Erwin W. Ramadhan <[email protected]>
+Ethan Arrowood <[email protected]> <[email protected]>
 Eugene Obrezkov <[email protected]>
 Eugene Ostroukhov <[email protected]> <[email protected]>
 Eugene Ostroukhov <[email protected]> <[email protected]>
@@ -299,6 +301,8 @@ Nebu Pookins <[email protected]>
 Netto Farah <[email protected]>
 Nicholas Kinsey <[email protected]>
 Nick Soggin <[email protected]> <[email protected]>
+Nigel Kibodeaux <[email protected]> <[email protected]>
+Nikola Glavina <[email protected]> <[email protected]>
 Nikolai Vavilov <[email protected]>
 Nils Kuhnhenn <[email protected]>
 Nitzan Uziely <[email protected]> <[email protected]>

diff --git a/AUTHORS b/AUTHORS
@@ -1237,12 +1237,12 @@ Josh Mays <[email protected]>
 Matt Crummey <[email protected]>
 michael6 <[email protected]>
 Raja Panidepu <[email protected]>
-Ethan Arrowood <ethan[email protected]>
+Ethan Arrowood <ethan@arrowood.dev>
 Dan Villa <[email protected]>
 CodeTheInternet <[email protected]>
 Eric Gonzalez <[email protected]>
 rgoodwin <[email protected]>
-Nigel Kibodeaux <[email protected]>
+Nigel Kibodeaux <[email protected]>
 fmizzell <[email protected]>
 cdnadmin <[email protected]>
 Paul Lucas <[email protected]>
@@ -1772,7 +1772,6 @@ Guilherme Akio Sakae <[email protected]>
 Martin Michaelis <[email protected]>
 Christopher Sidebottom <[email protected]>
 Edward Andrew Robinson <[email protected]>
-Nigel Kibodeaux <[email protected]>
 Shakeel Mohamed <[email protected]>
 Tobias Kieslich <[email protected]>
 Ruy Adorno <[email protected]>
@@ -3088,7 +3087,7 @@ Anentropic <[email protected]>
 Saleem <[email protected]>
 Julien Poissonnier <[email protected]>
 zombieleet <[email protected]>
-Nikola Glavina <nikola.glavina@student.um.si>
+Nikola Glavina <glavina[email protected]>
 Johannes Schöpp <[email protected]>
 Francisco Ryan Tolmasky I <[email protected]>
 Ye-hyoung Kang <[email protected]>
@@ -3167,9 +3166,7 @@ FeelyChau <[email protected]>
 Darcy Clarke <[email protected]>
 mayank agarwal <[email protected]>
 woodfairy <[email protected]>
-Nikola Glavina <[email protected]>
 Rishabh Mehan <[email protected]>
-Anna Henningsen <[email protected]>
 Andrew Casey <[email protected]>
 Anders Kaseorg <[email protected]>
 Hollow Man <[email protected]>

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -32,7 +32,8 @@ release.
 </tr>
 <tr>
     <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V16.md#16.8.0">16.8.0</a></b><br/>
+<b><a href="doc/changelogs/CHANGELOG_V16.md#16.9.0">16.9.0</a></b><br/>
+<a href="doc/changelogs/CHANGELOG_V16.md#16.8.0">16.8.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V16.md#16.7.0">16.7.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V16.md#16.6.2">16.6.2</a><br/>
 <a href="doc/changelogs/CHANGELOG_V16.md#16.6.1">16.6.1</a><br/>

diff --git a/LICENSE b/LICENSE
@@ -625,6 +625,17 @@ The externally maintained libraries used by Node.js are:
     USE OR OTHER DEALINGS IN THE SOFTWARE.
   """
 
+- corepack, located at deps/corepack, is licensed as follows:
+  """
+    **Copyright © Corepack contributors**
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+  """
+
 - OpenSSL, located at deps/openssl, is licensed as follows:
   """
     Copyright (c) 1998-2019 The OpenSSL Project.  All rights reserved.

diff --git a/Makefile b/Makefile
@@ -1054,6 +1054,14 @@ endif
 # Builds the macOS installer for releases.
 pkg: $(PKG)
 
+corepack-update:
+	rm -rf /tmp/node-corepack-clone
+	git clone 'https://github.com/nodejs/corepack.git' /tmp/node-corepack-clone
+	cd /tmp/node-corepack-clone && yarn pack
+	rm -rf deps/corepack && mkdir -p deps/corepack
+	cd deps/corepack && tar xf /tmp/node-corepack-clone/package.tgz --strip-components=1
+	chmod +x deps/corepack/shims/*
+
 # Note: this is strictly for release builds on release machines only.
 pkg-upload: pkg
 	ssh $(STAGINGSERVER) "mkdir -p nodejs/$(DISTTYPEDIR)/$(FULLVERSION)"

diff --git a/README.md b/README.md
@@ -171,8 +171,6 @@ For information about the governance of the Node.js project, see
 **Colin Ihrig** &lt;[email protected]&gt; (he/him)
 * [codebytere](https://github.com/codebytere) -
 **Shelley Vohr** &lt;[email protected]&gt; (she/her)
-* [danbev](https://github.com/danbev) -
-**Daniel Bevenius** &lt;[email protected]&gt; (he/him)
 * [danielleadams](https://github.com/danielleadams) -
 **Danielle Adams** &lt;[email protected]&gt; (she/her)
 * [fhinkel](https://github.com/fhinkel) -
@@ -214,6 +212,8 @@ For information about the governance of the Node.js project, see
 **Ben Noordhuis** &lt;[email protected]&gt;
 * [chrisdickinson](https://github.com/chrisdickinson) -
 **Chris Dickinson** &lt;[email protected]&gt;
+* [danbev](https://github.com/danbev) -
+**Daniel Bevenius** &lt;[email protected]&gt; (he/him)
 * [evanlucas](https://github.com/evanlucas) -
 **Evan Lucas** &lt;[email protected]&gt; (he/him)
 * [Fishrock123](https://github.com/Fishrock123) -
@@ -622,12 +622,18 @@ maintaining the Node.js project.
 **Qingyu Deng** &lt;[email protected]&gt;
 * [himadriganguly](https://github.com/himadriganguly) -
 **Himadri Ganguly** &lt;[email protected]&gt; (he/him)
+* [iam-frankqiu](https://github.com/iam-frankqiu) -
+**Frank Qiu** &lt;[email protected]&gt; (he/him)
 * [marsonya](https://github.com/marsonya) -
 **Akhil Marsonya** &lt;[email protected]&gt; (he/him)
+* [Mesteery](https://github.com/Mesteery) -
+**Mestery** &lt;[email protected]&gt;
 * [PoojaDurgad](https://github.com/PoojaDurgad) -
 **Pooja Durgad** &lt;[email protected]&gt;
 * [RaisinTen](https://github.com/RaisinTen) -
 **Darshan Sen** &lt;[email protected]&gt;
+* [VoltrexMaster](https://github.com/VoltrexMaster) -
+**Voltrex** &lt;[email protected]&gt; (he/him)
 
 ### Release keys
 

diff --git a/benchmark/async_hooks/async-local-storage-run.js b/benchmark/async_hooks/async-local-storage-run.js
@@ -0,0 +1,21 @@
+'use strict';
+const common = require('../common.js');
+const { AsyncLocalStorage } = require('async_hooks');
+
+const bench = common.createBenchmark(main, {
+  n: [1e7]
+});
+
+async function run(store, n) {
+  for (let i = 0; i < n; i++) {
+    await new Promise((resolve) => store.run(i, resolve));
+  }
+}
+
+function main({ n }) {
+  const store = new AsyncLocalStorage();
+  bench.start();
+  run(store, n).then(() => {
+    bench.end(n);
+  });
+}
diff --git a/common.gypi b/common.gypi
@@ -36,7 +36,7 @@
 
     # Reset this number to 0 on major V8 upgrades.
     # Increment by one for each non-official patch applied to deps/v8.
-    'v8_embedder_string': '-node.20',
+    'v8_embedder_string': '-node.11',
 
     ##### V8 defaults for Node.js #####
 

diff --git a/deps/corepack/LICENSE.md b/deps/corepack/LICENSE.md
@@ -0,0 +1,7 @@
+**Copyright © Corepack contributors**
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/deps/corepack/README.md b/deps/corepack/README.md
@@ -0,0 +1,147 @@
+# <img src="./icon.svg" height="25" /> corepack
+
+Corepack is a zero-runtime-dependency Node script that acts as a bridge between Node projects and the package managers they are intended to be used with during development. In practical terms, **Corepack will let you use Yarn and pnpm without having to install them** - just like what currently happens with npm, which is shipped by Node by default.
+
+**Important:** At the moment, Corepack only covers Yarn and pnpm. Given that we have little control on the npm project, we prefer to focus on the Yarn and pnpm use cases. As a result, Corepack doesn't have any effect at all on the way you use npm.
+
+## How to Install
+
+### Default Installs
+
+Corepack isn't intended to be installed manually. While it's certainly possible, we're working with the Node TSC to provide Corepack by default starting from Node 15, thus ensuring that all package managers can be used with little to no friction.
+
+### Manual Installs
+
+<details>
+<summary>Click here to see how to install Corepack using npm</summary>
+
+First uninstall your global Yarn and pnpm binaries (just leave npm). In general, you'd do this by running the following command:
+
+```shell
+npm uninstall -g yarn pnpm
+
+# That should be enough, but if you installed Yarn without going through npm it might
+# be more tedious - for example, you might need to run `brew uninstall yarn` as well.
+```
+
+Then install Corepack:
+
+```shell
+npm install -g corepack
+```
+
+We do acknowledge the irony and overhead of using npm to install Corepack, which is at least part of why the preferred option is to use the Corepack version that will be distributed along with Node itself.
+
+</details>
+
+### Prebuilt Binaries
+
+<details>
+<summary>Click here to see how to download prebuilt Corepack Node distributions</summary>
+
+We have a few prebuilt Node binaries (based on the [following branch](https://github.com/arcanis/node/tree/mael/pmm)) that you can just download, unpack somewhere, and add to your `PATH` environment variable.
+
+1. Go to [this page](https://github.com/arcanis/pmm/actions?query=workflow%3ABuild)
+2. Open the latest build (the one at the top)
+3. Download the right artifact (Linux or Darwin)
+4. Unzip the artifact, then untar it
+5. Add the `node-v15.0.0-nightlyYYYY-MM-DDXXXX-linux-x64/bin` directory to your `$PATH`
+
+</details>
+
+## Usage
+
+Just use your package managers as you usually would. Run `yarn install` in Yarn projects, `pnpm install` in pnpm projects, and `npm` in npm projects. Corepack will catch these calls, and depending on the situation:
+
+- **If the local project is configured for the package manager you're using**, Corepack will silently download and cache the latest compatible version.
+
+- **If the local project is configured for a different package manager**, Corepack will request you to run the command again using the right package manager - thus avoiding corruptions of your install artifacts.
+
+- **If the local project isn't configured for any package manager**, Corepack will assume that you know what you're doing, and will use whatever package manager version has been pinned as "known good release". Check the relevant section for more details.
+
+## Known Good Releases
+
+When running Yarn or pnpm within projects that don't list a supported package manager, Corepack will default to a set of Known Good Releases. In a way, you can compare this to Node, where each version ships with a specific version of npm.
+
+The Known Good Releases can be updated system-wide using the `--activate` flag from the `corepack prepare` and `corepack hydrate` commands.
+
+## Offline Workflow
+
+The utility commands detailed in the next section.
+
+- Either you can use the network while building your container image, in which case you'll simply run `corepack prepare` to make sure that your image includes the Last Known Good release for the specified package manager.
+
+  - If you want to have *all* Last Known Good releases for all package managers, just use the `--all` flag which will do just that.
+
+- Or you're publishing your project to a system where the network is unavailable, in which case you'll preemptively generate a package manager archive from your local computer (using `corepack prepare -o`) before storing it somewhere your container will be able to access (for example within your repository). After that it'll just be a matter of running `corepack hydrate <path/to/corepack.tgz>` to setup the cache.
+
+## Utility Commands
+
+### `corepack <binary name>[@<version>] [... args]`
+
+This meta-command runs the specified package manager in the local folder. You can use it to force an install to run with a given version, which can be useful when looking for regressions.
+
+Note that those commands still check whether the local project is configured for the given package manager (ie you won't be able to run `corepack yarn install` on a project where the `packageManager` field references `pnpm`).
+
+### `corepack enable [... name]`
+
+| Option | Description |
+| --- | --- |
+| `--install-directory` | Add the shims to the specified location |
+
+This command will detect where Node is installed and will create shims next to it for each of the specified package managers (or all of them if the command is called without parameters). Note that the npm shims will not be installed unless explicitly requested, as npm is currently distributed with Node through other means.
+
+### `corepack disable [... name]`
+
+| Option | Description |
+| --- | --- |
+| `--install-directory` | Remove the shims to the specified location |
+
+This command will detect where Node is installed and will remove the shims from there.
+
+### `corepack prepare [... name@version]`
+
+| Option | Description |
+| --- | --- |
+| `--all` | Prepare the "Last Known Good" version of all supported package managers |
+| `-o,--output` | Also generate an archive containing the package managers |
+| `--activate` | Also update the "Last Known Good" release |
+
+This command will download the given package managers (or the one configured for the local project if no argument is passed in parameter) and store it within the Corepack cache. If the `-o,--output` flag is set (optionally with a path as parameter), an archive will also be generated that can be used by the `corepack hydrate` command.
+
+### `corepack hydrate <path/to/corepack.tgz>`
+
+| Option | Description |
+| --- | --- |
+| `--activate` | Also update the "Last Known Good" release |
+
+This command will retrieve the given package manager from the specified archive and will install it within the Corepack cache, ready to be used without further network interaction.
+
+## Environment Variables
+
+- `COREPACK_ENABLED` has no functional impact on Corepack itself; it's automatically being set in your environment by Corepack when it shells out to the underlying package managers, so that they can feature-detect its presence (useful for commands like `yarn init`).
+
+## Contributing
+
+If you want to build corepack yourself, you can build the project like this:
+
+1. Clone this repository
+2. Run `yarn build` (no need for `yarn install`)
+3. The `dist/` directory now contains the corepack build and the shims
+4. Call `node ./dist/corepack --help` and behold
+
+You can also run the tests with `yarn jest` (still no install needed).
+
+## Design
+
+Various tidbits about Corepack's design are explained in more details in [DESIGN.md](/DESIGN.md).
+
+## License (MIT)
+
+> **Copyright © Corepack contributors**
+>
+> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.