deps: upgrade npm to 7.12.1

PR-URL: https://github.com/nodejs/node/pull/38628
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Gireesh Punathil <gpunathi@in.ibm.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Myles Borins <myles.borins@gmail.com>

15 files changed, 30 insertions, 34 deletions

diff --git a/deps/npm/docs/output/commands/npm-cache.html b/deps/npm/docs/output/commands/npm-cache.html
index 22ca6f1999b..cb886d3c7be 100644
--- a/deps/npm/docs/output/commands/npm-cache.html
+++ b/deps/npm/docs/output/commands/npm-cache.html
@@ -145,10 +145,10 @@ npm command-line interface
 </section>
 
 <div id="_content"><h3 id="synopsis">Synopsis</h3>
-<pre lang="bash"><code>npm cache add &lt;tarball file&gt;
-npm cache add &lt;folder&gt;
-npm cache add &lt;tarball url&gt;
-npm cache add &lt;name&gt;@&lt;version&gt;
+<pre lang="bash"><code>npm cache add &lt;tarball file&gt;...
+npm cache add &lt;folder&gt;...
+npm cache add &lt;tarball url&gt;...
+npm cache add &lt;name&gt;@&lt;version&gt;...
 
 npm cache clean
 aliases: npm cache clear, npm cache rm
@@ -161,7 +161,7 @@ npm cache verify
 <ul>
 <li>
 <p>add:
-Add the specified package to the local cache.  This command is primarily
+Add the specified packages to the local cache.  This command is primarily
 intended to be used internally by npm, but it can provide a way to
 add data to the local installation cache explicitly.</p>
 </li>
diff --git a/deps/npm/docs/output/commands/npm-ci.html b/deps/npm/docs/output/commands/npm-ci.html
index 8361e995b3a..be6f8acb4c8 100644
--- a/deps/npm/docs/output/commands/npm-ci.html
+++ b/deps/npm/docs/output/commands/npm-ci.html
@@ -148,7 +148,7 @@ npm command-line interface
 <pre lang="bash"><code>npm ci
 </code></pre>
 <h3 id="description">Description</h3>
-<p>This command is similar to <a href="../cli-commands/install.html"><code>npm install</code></a>, except
+<p>This command is similar to <a href="../commands/npm-install.html"><code>npm install</code></a>, except
 it’s meant to be used in automated environments such as test platforms,
 continuous integration, and deployment – or any situation where you want
 to make sure you’re doing a clean install of your dependencies.</p>
diff --git a/deps/npm/docs/output/commands/npm-dedupe.html b/deps/npm/docs/output/commands/npm-dedupe.html
index ccd9a03f4d8..795659a6103 100644
--- a/deps/npm/docs/output/commands/npm-dedupe.html
+++ b/deps/npm/docs/output/commands/npm-dedupe.html
@@ -193,10 +193,10 @@ result in new modules being installed.</p>
 <p>Using <code>npm find-dupes</code> will run the command in <code>--dry-run</code> mode.</p>
 <h3 id="see-also">See Also</h3>
 <ul>
-<li><a href="../cli-commands/find-dupes.html">npm find-dupes</a></li>
-<li><a href="../cli-commands/ls.html">npm ls</a></li>
-<li><a href="../cli-commands/update.html">npm update</a></li>
-<li><a href="../cli-commands/install.html">npm install</a></li>
+<li><a href="../commands/npm-find-dupes.html">npm find-dupes</a></li>
+<li><a href="../commands/npm-ls.html">npm ls</a></li>
+<li><a href="../commands/npm-update.html">npm update</a></li>
+<li><a href="../commands/npm-install.html">npm install</a></li>
 </ul>
 </div>
 
diff --git a/deps/npm/docs/output/commands/npm-deprecate.html b/deps/npm/docs/output/commands/npm-deprecate.html
index 88299a80bcf..7f4409cd3ac 100644
--- a/deps/npm/docs/output/commands/npm-deprecate.html
+++ b/deps/npm/docs/output/commands/npm-deprecate.html
@@ -169,8 +169,8 @@ format an empty string.</p>
 <ul>
 <li><a href="../commands/npm-publish.html">npm publish</a></li>
 <li><a href="../using-npm/registry.html">npm registry</a></li>
-<li><a href="../cli-commands/owner.html">npm owner</a></li>
-<li><a href="../cli-commands/adduser.html">npm owner</a></li>
+<li><a href="../commands/npm-owner.html">npm owner</a></li>
+<li><a href="../commands/npm-adduser.html">npm owner</a></li>
 </ul>
 </div>
 
diff --git a/deps/npm/docs/output/commands/npm-explore.html b/deps/npm/docs/output/commands/npm-explore.html
index cd52ff96a68..8d1e2843d73 100644
--- a/deps/npm/docs/output/commands/npm-explore.html
+++ b/deps/npm/docs/output/commands/npm-explore.html
@@ -171,7 +171,6 @@ Windows</li>
 <li><a href="../configuring-npm/folders.html">npm folders</a></li>
 <li><a href="../commands/npm-edit.html">npm edit</a></li>
 <li><a href="../commands/npm-rebuild.html">npm rebuild</a></li>
-<li><a href="../commands/npm-build.html">npm build</a></li>
 <li><a href="../commands/npm-install.html">npm install</a></li>
 </ul>
 </div>
diff --git a/deps/npm/docs/output/commands/npm-find-dupes.html b/deps/npm/docs/output/commands/npm-find-dupes.html
index 32d8993b99c..7f7f3c101b2 100644
--- a/deps/npm/docs/output/commands/npm-find-dupes.html
+++ b/deps/npm/docs/output/commands/npm-find-dupes.html
@@ -152,10 +152,10 @@ npm command-line interface
 duplications, without actually changing the package tree.</p>
 <h3 id="see-also">See Also</h3>
 <ul>
-<li><a href="../cli-commands/dedupe.html">npm dedupe</a></li>
-<li><a href="../cli-commands/ls.html">npm ls</a></li>
-<li><a href="../cli-commands/update.html">npm update</a></li>
-<li><a href="../cli-commands/install.html">npm install</a></li>
+<li><a href="../commands/npm-dedupe.html">npm dedupe</a></li>
+<li><a href="../commands/npm-ls.html">npm ls</a></li>
+<li><a href="../commands/npm-update.html">npm update</a></li>
+<li><a href="../commands/npm-install.html">npm install</a></li>
 </ul>
 </div>
 
diff --git a/deps/npm/docs/output/commands/npm-install.html b/deps/npm/docs/output/commands/npm-install.html
index 2794b9a983d..8fff20fe836 100644
--- a/deps/npm/docs/output/commands/npm-install.html
+++ b/deps/npm/docs/output/commands/npm-install.html
@@ -614,7 +614,6 @@ the specific folder structures that npm creates.</p>
 <li><a href="../commands/npm-link.html">npm link</a></li>
 <li><a href="../commands/npm-rebuild.html">npm rebuild</a></li>
 <li><a href="../using-npm/scripts.html">npm scripts</a></li>
-<li><a href="../commands/npm-build.html">npm build</a></li>
 <li><a href="../commands/npm-config.html">npm config</a></li>
 <li><a href="../configuring-npm/npmrc.html">npmrc</a></li>
 <li><a href="../using-npm/registry.html">npm registry</a></li>
diff --git a/deps/npm/docs/output/commands/npm-ls.html b/deps/npm/docs/output/commands/npm-ls.html
index ede5cb04290..3d60f2baecd 100644
--- a/deps/npm/docs/output/commands/npm-ls.html
+++ b/deps/npm/docs/output/commands/npm-ls.html
@@ -159,7 +159,7 @@ tree at all, use <a href="../commands/npm-explain.html"><code>npm explain</code>
 the results to only the paths to the packages named.  Note that nested
 packages will <em>also</em> show the paths to the specified packages.  For
 example, running <code>npm ls promzard</code> in npm’s source tree will show:</p>
-<pre lang="bash"><code>npm@7.11.2 /path/to/npm
+<pre lang="bash"><code>npm@7.12.1 /path/to/npm
 └─┬ init-package-json@0.0.4
   └── promzard@0.1.5
 </code></pre>
diff --git a/deps/npm/docs/output/commands/npm-unpublish.html b/deps/npm/docs/output/commands/npm-unpublish.html
index 75751d3408c..737d5336c83 100644
--- a/deps/npm/docs/output/commands/npm-unpublish.html
+++ b/deps/npm/docs/output/commands/npm-unpublish.html
@@ -159,7 +159,7 @@ want to maintain a package.</p>
 <h3 id="description">Description</h3>
 <p>This removes a package version from the registry, deleting its entry and
 removing the tarball.</p>
-<p>The npm registry will return an error if you are not <a href="../commands/npm-login.html">logged
+<p>The npm registry will return an error if you are not <a href="../commands/npm-adduser.html">logged
 in</a>.</p>
 <p>If you do not specify a version or if you remove all of a package’s
 versions then the registry will remove the root package entry entirely.</p>
@@ -175,7 +175,7 @@ passed.</p>
 <li><a href="../using-npm/registry.html">npm registry</a></li>
 <li><a href="../commands/npm-adduser.html">npm adduser</a></li>
 <li><a href="../commands/npm-owner.html">npm owner</a></li>
-<li><a href="../commands/npm-login.html">npm login</a></li>
+<li><a href="../commands/npm-adduser.html">npm login</a></li>
 </ul>
 </div>
 
diff --git a/deps/npm/docs/output/commands/npm-view.html b/deps/npm/docs/output/commands/npm-view.html
index 7489b17b1cd..77786b74fd8 100644
--- a/deps/npm/docs/output/commands/npm-view.html
+++ b/deps/npm/docs/output/commands/npm-view.html
@@ -186,7 +186,7 @@ can do this:</p>
 </code></pre>
 <p>“Person” fields are shown as a string if they would be shown as an
 object.  So, for example, this will show the list of <code>npm</code> contributors in
-the shortened string format.  (See <a href="../configuring-npm/package.json.html"><code>package.json</code></a> for more on this.)</p>
+the shortened string format.  (See <a href="../configuring-npm/package-json.html"><code>package.json</code></a> for more on this.)</p>
 <pre lang="bash"><code>npm view npm contributors
 </code></pre>
 <p>If a version range is provided, then data will be printed for every
diff --git a/deps/npm/docs/output/commands/npm.html b/deps/npm/docs/output/commands/npm.html
index 311c581f681..445abd0d5ce 100644
--- a/deps/npm/docs/output/commands/npm.html
+++ b/deps/npm/docs/output/commands/npm.html
@@ -148,7 +148,7 @@ npm command-line interface
 <pre lang="bash"><code>npm &lt;command&gt; [args]
 </code></pre>
 <h3 id="version">Version</h3>
-<p>7.11.2</p>
+<p>7.12.1</p>
 <h3 id="description">Description</h3>
 <p>npm is the package manager for the Node JavaScript platform.  It puts
 modules in place so that node can find them, and manages dependency
@@ -222,7 +222,7 @@ done via <a href="../commands/npm-install.html"><code>npm install</code></a></li
 Create an account or log in.  When you do this, npm will store
 credentials in the user config file config file.</li>
 <li>publish:
-Use the <a href="../commands/npm-publish%60.html"><code>npm publish</code></a> command to upload your
+Use the <a href="../commands/npm-publish.html"><code>npm publish</code></a> command to upload your
 code to the registry.</li>
 </ul>
 <h4 id="configuration">Configuration</h4>
diff --git a/deps/npm/docs/output/configuring-npm/folders.html b/deps/npm/docs/output/configuring-npm/folders.html
index 20027ea3a9f..6cdae3cd1ec 100644
--- a/deps/npm/docs/output/configuring-npm/folders.html
+++ b/deps/npm/docs/output/configuring-npm/folders.html
@@ -292,7 +292,7 @@ the items there are not in the <code>bundledDependencies</code> array, then they
 not be included in the package tarball.</p>
 <p>This allows a package maintainer to install all of their dependencies
 (and dev dependencies) locally, but only re-publish those items that
-cannot be found elsewhere.  See <a href="../configuring-npm/package.json.html"><code>package.json</code></a> for more information.</p>
+cannot be found elsewhere.  See <a href="../configuring-npm/package-json.html"><code>package.json</code></a> for more information.</p>
 <h3 id="see-also">See also</h3>
 <ul>
 <li><a href="../configuring-npm/package-json.html">package.json</a></li>
diff --git a/deps/npm/docs/output/configuring-npm/package-json.html b/deps/npm/docs/output/configuring-npm/package-json.html
index 84956dede7d..f9c3ee6e4f5 100644
--- a/deps/npm/docs/output/configuring-npm/package-json.html
+++ b/deps/npm/docs/output/configuring-npm/package-json.html
@@ -567,7 +567,7 @@ space-separated descriptors.  Dependencies can also be identified with a
 tarball or git URL.</p>
 <p><strong>Please do not put test harnesses or transpilers or other “development”
 time tools in your <code>dependencies</code> object.</strong>  See <code>devDependencies</code>, below.</p>
-<p>See <a href="../using-npm/semver#versions.html">semver</a> for more details about specifying version ranges.</p>
+<p>See <a href="https://github.com/npm/node-semver#versions">semver</a> for more details about specifying version ranges.</p>
 <ul>
 <li><code>version</code> Must match <code>version</code> exactly</li>
 <li><code>&gt;version</code> Must be greater than <code>version</code></li>
diff --git a/deps/npm/docs/output/using-npm/config.html b/deps/npm/docs/output/using-npm/config.html
index 4435ce53bba..881080eb121 100644
--- a/deps/npm/docs/output/using-npm/config.html
+++ b/deps/npm/docs/output/using-npm/config.html
@@ -1193,7 +1193,8 @@ of npm than the latest.</p>
 <p>Show short usage output about the command specified.</p>
 <h4 id="user-agent"><code>user-agent</code></h4>
 <ul>
-<li>Default: “npm/{npm-version} node/{node-version} {platform} {arch} {ci}”</li>
+<li>Default: “npm/{npm-version} node/{node-version} {platform} {arch}
+workspaces/{workspaces} {ci}”</li>
 <li>Type: String</li>
 </ul>
 <p>Sets the User-Agent request header. The following fields are replaced with
@@ -1203,6 +1204,8 @@ their actual counterparts:</p>
 <li><code>{node-version}</code> - The Node.js version in use</li>
 <li><code>{platform}</code> - The value of <code>process.platform</code></li>
 <li><code>{arch}</code> - The value of <code>process.arch</code></li>
+<li><code>{workspaces}</code> - Set to <code>true</code> if the <code>workspaces</code> or <code>workspace</code> options
+are set.</li>
 <li><code>{ci}</code> - The value of the <code>ci-name</code> config, if set, prefixed with <code>ci/</code>, or
 an empty string if <code>ci-name</code> is empty.</li>
 </ul>
diff --git a/deps/npm/docs/output/using-npm/scripts.html b/deps/npm/docs/output/using-npm/scripts.html
index e231cfec2ab..dde9b1b75d7 100644
--- a/deps/npm/docs/output/using-npm/scripts.html
+++ b/deps/npm/docs/output/using-npm/scripts.html
@@ -141,7 +141,7 @@ npm command-line interface
 
 <section id="table_of_contents">
 <h2 id="table-of-contents">Table of contents</h2>
-<div id="_table_of_contents"><ul><li><a href="#description">Description</a></li><li><a href="#pre--post-scripts">Pre &amp; Post Scripts</a></li><li><a href="#life-cycle-scripts">Life Cycle Scripts</a></li><ul><li><a href="#prepare-and-prepublish">Prepare and Prepublish</a></li></ul><li><a href="#life-cycle-operation-order">Life Cycle Operation Order</a></li><ul><li><a href="#npm-cache-add"><a href="../commands/npm-cache.html"><code>npm cache add</code></a></a></li><li><a href="#npm-ci"><a href="../commands/npm-ci.html"><code>npm ci</code></a></a></li><li><a href="#npm-diff"><a href="../commands/npm-diff.html"><code>npm diff</code></a></a></li><li><a href="#npm-env"><a href="../commands/npm-env.html"><code>npm env</code></a></a></li><li><a href="#npm-install"><a href="../commands/npm-install.html"><code>npm install</code></a></a></li><li><a href="#npm-pack"><a href="../commands/npm-pack.html"><code>npm pack</code></a></a></li><li><a href="#npm-publish"><a href="../commands/npm-publish.html"><code>npm publish</code></a></a></li><li><a href="#npm-rebuild"><a href="../commands/npm-rebuild.html"><code>npm rebuild</code></a></a></li><li><a href="#npm-restart"><a href="../commands/npm-restart.html"><code>npm restart</code></a></a></li><li><a href="#npm-run-user-defined"><a href="../commands/npm-run.html"><code>npm run &lt;user defined&gt;</code></a></a></li><li><a href="#npm-start"><a href="../commands/npm-start.html"><code>npm start</code></a></a></li><li><a href="#npm-stop"><a href="../commands/npm-stop.html"><code>npm stop</code></a></a></li><li><a href="#npm-test"><a href="../commands/npm-test.html"><code>npm test</code></a></a></li></ul><li><a href="#user">User</a></li><li><a href="#environment">Environment</a></li><ul><li><a href="#path">path</a></li><li><a href="#packagejson-vars">package.json vars</a></li><li><a href="#configuration">configuration</a></li><li><a href="#special-packagejson-config-object">Special: package.json “config” object</a></li><li><a href="#current-lifecycle-event">current lifecycle event</a></li></ul><li><a href="#examples">Examples</a></li><li><a href="#exiting">Exiting</a></li><li><a href="#hook-scripts">Hook Scripts</a></li><li><a href="#best-practices">Best Practices</a></li><li><a href="#see-also">See Also</a></li></ul></div>
+<div id="_table_of_contents"><ul><li><a href="#description">Description</a></li><li><a href="#pre--post-scripts">Pre &amp; Post Scripts</a></li><li><a href="#life-cycle-scripts">Life Cycle Scripts</a></li><ul><li><a href="#prepare-and-prepublish">Prepare and Prepublish</a></li></ul><li><a href="#life-cycle-operation-order">Life Cycle Operation Order</a></li><ul><li><a href="#npm-cache-add"><a href="../commands/npm-cache.html"><code>npm cache add</code></a></a></li><li><a href="#npm-ci"><a href="../commands/npm-ci.html"><code>npm ci</code></a></a></li><li><a href="#npm-diff"><a href="../commands/npm-diff.html"><code>npm diff</code></a></a></li><li><a href="#npm-install"><a href="../commands/npm-install.html"><code>npm install</code></a></a></li><li><a href="#npm-pack"><a href="../commands/npm-pack.html"><code>npm pack</code></a></a></li><li><a href="#npm-publish"><a href="../commands/npm-publish.html"><code>npm publish</code></a></a></li><li><a href="#npm-rebuild"><a href="../commands/npm-rebuild.html"><code>npm rebuild</code></a></a></li><li><a href="#npm-restart"><a href="../commands/npm-restart.html"><code>npm restart</code></a></a></li><li><a href="#npm-run-user-defined"><a href="../commands/npm-run-script.html"><code>npm run &lt;user defined&gt;</code></a></a></li><li><a href="#npm-start"><a href="../commands/npm-start.html"><code>npm start</code></a></a></li><li><a href="#npm-stop"><a href="../commands/npm-stop.html"><code>npm stop</code></a></a></li><li><a href="#npm-test"><a href="../commands/npm-test.html"><code>npm test</code></a></a></li></ul><li><a href="#user">User</a></li><li><a href="#environment">Environment</a></li><ul><li><a href="#path">path</a></li><li><a href="#packagejson-vars">package.json vars</a></li><li><a href="#configuration">configuration</a></li><li><a href="#special-packagejson-config-object">Special: package.json “config” object</a></li><li><a href="#current-lifecycle-event">current lifecycle event</a></li></ul><li><a href="#examples">Examples</a></li><li><a href="#exiting">Exiting</a></li><li><a href="#hook-scripts">Hook Scripts</a></li><li><a href="#best-practices">Best Practices</a></li><li><a href="#see-also">See Also</a></li></ul></div>
 </section>
 
 <div id="_content"><h3 id="description">Description</h3>
@@ -260,11 +260,6 @@ other system tools on the target machines.</li>
 <ul>
 <li><code>prepare</code></li>
 </ul>
-<h4 id="npm-env"><a href="../commands/npm-env.html"><code>npm env</code></a></h4>
-<ul>
-<li><code>env</code> (You can override the default behavior of <code>npm env</code> by defining
-a custom <code>env</code> entry in your <code>scripts</code> object)</li>
-</ul>
 <h4 id="npm-install"><a href="../commands/npm-install.html"><code>npm install</code></a></h4>
 <p>These also run when you run <code>npm install -g &lt;pkg-name&gt;</code></p>
 <ul>
@@ -314,7 +309,7 @@ linked packages)</p>
 <li><code>restart</code></li>
 <li><code>postrestart</code></li>
 </ul>
-<h4 id="npm-run-user-defined"><a href="../commands/npm-run.html"><code>npm run &lt;user defined&gt;</code></a></h4>
+<h4 id="npm-run-user-defined"><a href="../commands/npm-run-script.html"><code>npm run &lt;user defined&gt;</code></a></h4>
 <ul>
 <li><code>pre&lt;user-defined&gt;</code></li>
 <li><code>&lt;user-defined&gt;</code></li>