Tweaks

Author: arcanis

.pnp.cjs

@@ -104,8 +104,14 @@ This command will retrieve the given package manager from the specified archive
 
 ## Environment Variables
 
+- `COREPACK_ENABLE_NETWORK` can be set to `0` to prevent it from downloading code from remote locations. In that case, you're expected to have already setup your local package managers via the `corepack prepare` / `corepack hydrate` workflow.
+
+- `COREPACK_HOME` is the location where the Corepack files will be stored. By default its value is `$HOME/.node/corepack`.
+
 - `COREPACK_ROOT` 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`).
 
+- `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` are supported through [`global-agent`](https://github.com/gajus/global-agent).
+
 ## Contributing
 
 If you want to build corepack yourself, you can build the project like this:

.yarn/cache/@types-global-agent-npm-2.1.1-d5b2345c3b-33fddd8378.zip

@@ -26,6 +26,7 @@
     "@babel/plugin-transform-modules-commonjs": "^7.14.0",
     "@babel/preset-typescript": "^7.13.0",
     "@types/debug": "^4.1.5",
+    "@types/global-agent": "^2.1.1",
     "@types/jest": "^26.0.23",
     "@types/node": "^13.9.2",
     "@types/semver": "^7.1.0",

README.md

@@ -2,11 +2,23 @@ import {UsageError}      from 'clipanion';
 import {RequestOptions}  from 'https';
 import {IncomingMessage} from 'http';
 
+let globalAgentBootstrapped = false;
+
+async function setupGlobalAgent() {
+  if (globalAgentBootstrapped)
+    return;
+
+  const {bootstrap} = await import(`global-agent`);
+  bootstrap({environmentVariableNamespace: ``});
+
+  globalAgentBootstrapped = true;
+}
+
 export async function fetchUrlStream(url: string, options: RequestOptions = {}) {
   if (process.env.COREPACK_ENABLE_NETWORK === `0`)
     throw new UsageError(`Network access disabled by the environment; can't reach ${url}`);
 
-  await setupProxy();
+  await setupGlobalAgent();
 
   const {default: https} = await import(`https`);
 
@@ -25,19 +37,6 @@ export async function fetchUrlStream(url: string, options: RequestOptions = {})
   });
 }
 
-let globalAgentBootstrapped = false;
-
-async function setupProxy() {
-  if (globalAgentBootstrapped) {
-    return;
-  }
-  const {bootstrap} = await import('global-agent');
-  bootstrap({
-    environmentVariableNamespace: ''
-  });
-  globalAgentBootstrapped = true;
-}
-
 export async function fetchAsBuffer(url: string, options?: RequestOptions) {
   const response = await fetchUrlStream(url, options);
 

package.json

@@ -1065,6 +1065,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/global-agent@npm:^2.1.1":
+  version: 2.1.1
+  resolution: "@types/global-agent@npm:2.1.1"
+  checksum: 33fddd83781706b60996d42e6e60a8a96b4163f5b54f5052c97b448edf8e7c834e9395613cec37a39da8d1d5286382e85ec09ba6b908fab5638055f7d6f76397
+  languageName: node
+  linkType: hard
+
 "@types/graceful-fs@npm:^4.1.2":
   version: 4.1.5
   resolution: "@types/graceful-fs@npm:4.1.5"
@@ -2371,6 +2378,7 @@ __metadata:
     "@babel/plugin-transform-modules-commonjs": ^7.14.0
     "@babel/preset-typescript": ^7.13.0
     "@types/debug": ^4.1.5
+    "@types/global-agent": ^2.1.1
     "@types/jest": ^26.0.23
     "@types/node": ^13.9.2
     "@types/semver": ^7.1.0