@automattic/vip 2.11.2 → 2.13.1

package/CONTRIBUTING.md

@@ -10,6 +10,11 @@ Tests are powered by [Jest](https://jestjs.io).
 
 ## Developing
 
+### Node version
+
+To develop use the minimum supported node version. You can take a look in the `package.json` `engines` configuration
+or, if you use tools like `nvm` you can run `nvm use` to ensure you're running the right one.
+
 ### Local Dev
 
 To test against a local instance of Parker, you can use the `API_HOST` env var. You'll also want to nullify the `VIP_PROXY` env var as well.
@@ -91,7 +96,7 @@ Then, let's publish:
 1. Push the tag to GitHub (`git push --tags`)
 1. Push the master branch `git push`
 1. Make sure you're part of the Automattic organization in npm
-1. Publish the release to npm (`npm run publish-please --access public`)
+1. Publish the release to npm (`npm run publish-please --access public`) the script will do some extra checks (npm version, branch, etc) to ensure everything is correct. If all looks good, proceed.
 1. Edit [the release on GitHub](https://github.com/Automattic/vip/releases) to include a description of the changes and publish (this can just copy the details from the changelog).
 1. Push `master` changes (mostly the version bump) to `develop` (`git checkout develop && git merge master` )
 
@@ -127,4 +132,4 @@ Then, repeat for any additional versions that we need to patch.
 
 Some unit tests require some go-search-replace executable binary files to run. Binaries files for several OS architectures can be downloaded from https://github.com/Automattic/go-search-replace/releases/
 
-If, for some reason, you need to compile these binaries yourself, please follow instructions at https://github.com/Automattic/go-search-replace
+If, for some reason, you need to compile these binaries yourself, please follow instructions at https://github.com/Automattic/go-search-replace

package/README.md

@@ -14,7 +14,7 @@ Then, launch the command and follow the prompts:
 vip
 ```
 
-If you need more information, check out our [VIP CLI documentation](https://docs.wpvip.com/technical-references/vip-cli/).
+If you need more information, check out our [VIP-CLI documentation](https://docs.wpvip.com/technical-references/vip-cli/).
 
 ## Contributing
 
@@ -26,6 +26,34 @@ By default, we record information about the usage of this tool using an in-house
 
 ## Changelog
 
+### 2.13.1 (20 Jun 2022)
+
+- #1052 [dev-env] Update/lando compose version
+- #1045 README: Fix Typo `VIP CLI` => `VIP-CLI`
+- #1048 Switch to GitHub Actions
+
+### 2.13.0 (16 Jun 2022)
+
+- #1046	Add Cache Purge Command
+- #1050	[dev-env] Change docs link
+- #1047	[dev-env] Bump lando package
+- #1044	[dev-env] Fix healthchecks No. 2
+- #1043	[dev-env] add docker-compose v2 support
+- #1042	[dev-env] Fix search popup during wizard
+- #1038	[dev-env] Adds domain validation during sql import
+- #1040	[dev-env] track dev-env start time in seconds
+
+### 2.12.0 (19 May 2022)
+
+- #1035 and #1032 Improved publishing checks to publish on npm
+- #1037 [dev-env] only record the php version numbers   update/clean_php_version
+- #999  Add Feature to Support HTTPS/HTTP/NO_PROXY Settings
+- #1036 Move DO_NOT_TRACK handling to Analytics lib
+- #1033 [dev-env] Bump lando in order to support node 18
+
+#### Special thanks
+frank-cerny for the contribution on #999
+
 ### 2.11.2 (12 May 2022)
 
 - Hotfix to use correct production config.json in the NPM published package caused by a different NPM version in the build process.
@@ -201,7 +229,7 @@ Fixes:
 - #844 Expose DB and expose extra services in info table
 - #865 spawn WP-CLI as root to allow for FS operations
 - #895 Fix rmdir deprecation warning
-- #870 Add the VIP CLI release process and release schedule
+- #870 Add the VIP-CLI release process and release schedule
 
 Dependencies updates:
 

package/dist/bin/vip-cache-purge-url.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+
+/**
+ * Internal dependencies
+ */
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.cachePurgeCommand = cachePurgeCommand;
+
+var _cachePurge = require("../lib/api/cache-purge");
+
+var _command = _interopRequireDefault(require("../lib/cli/command"));
+
+var _tracker = require("../lib/tracker");
+
+var _readFile = require("../lib/read-file");
+
+var exit = _interopRequireWildcard(require("../lib/cli/exit"));
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const examples = [{
+  usage: 'vip cache purge-url <URL>',
+  description: 'Purge a URL from page cache'
+}, {
+  usage: 'vip cache purge-url --from-file=/dev/vip/urls.txt',
+  description: 'Purge multiple URLs from page cache'
+}];
+
+async function cachePurgeCommand(urls = [], opt = {}) {
+  const trackingParams = {
+    app_id: opt.app.id,
+    command: 'vip cache purge-url',
+    env_id: opt.env.id,
+    from_file: !!opt.fromFile
+  };
+  await (0, _tracker.trackEvent)('cache_purge_url_command_execute', trackingParams);
+
+  if (opt.fromFile) {
+    const value = await (0, _readFile.readFromFile)(opt.fromFile);
+
+    if (value) {
+      urls = value.split('\n').map(url => url.trim());
+    }
+  }
+
+  if (!urls.length) {
+    await (0, _tracker.trackEvent)('cache_purge_url_command_error', { ...trackingParams,
+      error: 'No URL provided'
+    });
+    exit.withError('Please supply at least one URL.');
+  }
+
+  let purgeCacheObject = {};
+
+  try {
+    purgeCacheObject = await (0, _cachePurge.purgeCache)(opt.app.id, opt.env.id, urls);
+  } catch (err) {
+    await (0, _tracker.trackEvent)('cache_purge_url_command_error', { ...trackingParams,
+      error: err.message
+    });
+    exit.withError(`Failed to purge URL(s) from page cache: ${err.message}`);
+  }
+
+  await (0, _tracker.trackEvent)('cache_purge_url_command_success', trackingParams);
+  purgeCacheObject.urls.forEach(url => {
+    console.log(`- Purged URL: ${url}`);
+  });
+}
+
+(0, _command.default)({
+  appContext: true,
+  appQuery: _cachePurge.appQuery,
+  envContext: true,
+  wildcardCommand: true,
+  usage: 'vip cache purge-url <URL>'
+}).option('from-file', 'Read URLs from file (useful to purge multiple URLs)').examples(examples).argv(process.argv, cachePurgeCommand);

package/{package/dist/bin/vip-config.js → dist/bin/vip-cache.js}

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
 
+/**
+ * 
+ * @format
+ */
+
 /**
  * External dependencies
  */
@@ -15,6 +20,4 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
 
 (0, _command.default)({
   requiredArgs: 2
-}).command('envvar', 'Manage environment variables for an application environment').argv(process.argv, async () => {
-  process.exit(0);
-});
+}).command('purge-url', 'Purge page cache').argv(process.argv);

package/dist/bin/vip-dev-env-import-sql.js

@@ -62,7 +62,14 @@ const examples = [{
     } = await (0, _devEnvironmentCore.resolveImportPath)(slug, fileName, searchReplace, inPlace);
 
     if (!opt.skipValidate) {
-      await (0, _sql.validate)(fileName, []);
+      const expectedDomain = `${slug}.vipdev.lndo.site`;
+      await (0, _sql.validate)(resolvedPath, {
+        isImport: false,
+        skipChecks: [],
+        extraCheckParams: {
+          siteHomeUrlLando: expectedDomain
+        }
+      });
     }
 
     const importArg = ['wp', 'db', 'import', inContainerPath];

package/dist/bin/vip-dev-env-start.js

@@ -66,7 +66,8 @@ const examples = [{
     }
 
     await (0, _devEnvironmentCore.startEnvironment)(slug, options);
-    const processingTime = new Date() - startProcessing;
+    const processingTime = Math.ceil((new Date() - startProcessing) / 1000); // in seconds
+
     const successTrackingInfo = { ...trackingInfo,
       processing_time: processingTime
     };

package/dist/bin/vip-dev-env-update.js

@@ -68,6 +68,7 @@ cmd.argv(process.argv, async (arg, opt) => {
       statsd: currentInstanceData.statsd,
       phpmyadmin: currentInstanceData.phpmyadmin,
       xdebug: currentInstanceData.xdebug,
+      enterpriseSearchEnabled: currentInstanceData.enterpriseSearchEnabled,
       mediaRedirectDomain: currentInstanceData.mediaRedirectDomain,
       multisite: false,
       title: ''

package/dist/bin/vip-wp.js

@@ -35,7 +35,7 @@ var _token = _interopRequireDefault(require("../lib/token"));
 
 var _rollbar = require("../lib/rollbar");
 
-var _socksProxyAgent = _interopRequireDefault(require("../lib/http/socks-proxy-agent"));
+var _proxyAgent = require("../lib/http/proxy-agent");
 
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 
@@ -487,7 +487,7 @@ const bindReconnectEvents = ({
           }
         }
       },
-      agent: (0, _socksProxyAgent.default)()
+      agent: (0, _proxyAgent.createProxyAgent)(_api.API_HOST)
     });
     currentJob = await launchCommandAndGetStreams({
       socket,

package/dist/bin/vip.js

@@ -13,7 +13,7 @@ var _chalk = _interopRequireDefault(require("chalk"));
 
 var _debug = _interopRequireDefault(require("debug"));
 
-var _config = _interopRequireDefault(require("../../config/config.json"));
+var _config = _interopRequireDefault(require("../lib/cli/config"));
 
 var _command = _interopRequireWildcard(require("../lib/cli/command"));
 
@@ -48,7 +48,7 @@ const runCmd = async function () {
     await _token.default.purge();
     await (0, _tracker.trackEvent)('logout_command_execute');
     console.log('You are successfully logged out.');
-  }).command('app', 'List and modify your VIP applications').command('config', 'Set configuration for your VIP applications').command('dev-env', 'Use local dev-environment').command('import', 'Import media or SQL files into your VIP applications').command('logs', 'Get logs from your VIP applications').command('search-replace', 'Perform search and replace tasks on files').command('sync', 'Sync production to a development environment').command('whoami', 'Display details about the currently logged-in user').command('wp', 'Run WP CLI commands against an environment');
+  }).command('app', 'List and modify your VIP applications').command('cache', 'Manage page cache for your VIP applications').command('config', 'Set configuration for your VIP applications').command('dev-env', 'Use local dev-environment').command('import', 'Import media or SQL files into your VIP applications').command('logs', 'Get logs from your VIP applications').command('search-replace', 'Perform search and replace tasks on files').command('sync', 'Sync production to a development environment').command('whoami', 'Display details about the currently logged-in user').command('wp', 'Run WP CLI commands against an environment');
   cmd.argv(process.argv);
 };
 

package/dist/lib/analytics/clients/stub.js

@@ -11,7 +11,7 @@ exports.default = void 0;
 class AnalyticsClientStub {
   // eslint-disable-next-line no-unused-vars
   trackEvent(name, props) {
-    return new Promise(resolve => resolve());
+    return new Promise(resolve => resolve(true));
   }
 
 }

package/dist/lib/analytics/clients/tracks.js

@@ -100,11 +100,6 @@ class Tracks {
   }
 
   send(extraParams) {
-    if (process.env.DO_NOT_TRACK) {
-      debug('send() => skipping per DO_NOT_TRACK variable');
-      return Promise.resolve('tracks disabled per DO_NOT_TRACK variable');
-    }
-
     const params = Object.assign({}, this.baseParams, extraParams);
     const method = 'POST';
 

package/dist/lib/analytics/index.js

@@ -5,6 +5,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 
+var _debug = _interopRequireDefault(require("debug"));
+
 var _stub = _interopRequireDefault(require("./clients/stub"));
 
 var _env = _interopRequireDefault(require("../env"));
@@ -12,10 +14,15 @@ var _env = _interopRequireDefault(require("../env"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 /**
- * Internal dependencies
+ * External dependencies
  */
 
+/**
+ * Internal dependencies
+ */
+const debug = (0, _debug.default)('@automattic/vip:analytics');
 /* eslint-disable camelcase */
+
 const client_info = {
   cli_version: _env.default.app.version,
   os_name: _env.default.os.name,
@@ -32,6 +39,11 @@ class Analytics {
   }
 
   async trackEvent(name, props = {}) {
+    if (process.env.DO_NOT_TRACK) {
+      debug(`trackEvent() for ${name} => skipping per DO_NOT_TRACK variable`);
+      return Promise.resolve(`Skipping trackEvent for ${name} (DO_NOT_TRACK)`);
+    }
+
     return Promise.all(this.clients.map(client => {
       return client.trackEvent(name, { // eslint-disable-next-line camelcase
         ...client_info,

package/dist/lib/api/cache-purge.js

@@ -0,0 +1,76 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.purgeCache = purgeCache;
+exports.appQuery = void 0;
+
+var _graphqlTag = _interopRequireDefault(require("graphql-tag"));
+
+var _api = _interopRequireDefault(require("../api"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * 
+ * @format
+ */
+
+/**
+ * External dependencies
+ */
+
+/**
+ * Internal dependencies
+ */
+const mutation = (0, _graphqlTag.default)`
+	mutation PurgePageCacheMutation(
+		$appId: Int!
+		$envId: Int!
+		$urls: [String!]!
+	) {
+		purgePageCache( input: {
+			appId: $appId
+			environmentId: $envId
+			urls: $urls
+		} ) {
+			success
+			urls
+		}
+	}
+`; // The subquery for environments lets users choose any environment, including production.
+
+const appQuery = `
+	id
+	name
+	environments {
+		id
+		appId
+		name
+		primaryDomain {
+			name
+		}
+		type
+	}
+`;
+exports.appQuery = appQuery;
+
+async function purgeCache(appId, envId, urls) {
+  const api = await (0, _api.default)();
+  const variables = {
+    appId,
+    envId,
+    urls
+  };
+  const response = await api.mutate({
+    mutation,
+    variables
+  });
+  const {
+    data: {
+      purgePageCache
+    }
+  } = response;
+  return purgePageCache;
+}

package/dist/lib/api.js

@@ -23,7 +23,7 @@ var _token = _interopRequireDefault(require("./token"));
 
 var _env = _interopRequireDefault(require("./env"));
 
-var _socksProxyAgent = _interopRequireDefault(require("./http/socks-proxy-agent"));
+var _proxyAgent = require("./http/proxy-agent");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
@@ -96,7 +96,7 @@ async function API({
     });
     return forward(operation);
   });
-  const proxyAgent = (0, _socksProxyAgent.default)();
+  const proxyAgent = (0, _proxyAgent.createProxyAgent)(API_URL);
   const httpLink = new _core.HttpLink({
     uri: API_URL,
     headers,

package/dist/lib/cli/config.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _debug = _interopRequireDefault(require("debug"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * External dependencies
+ */
+const debug = (0, _debug.default)('@automattic/vip:lib:cli:config');
+let configFromFile = {};
+
+try {
+  // Get `local` config first; this will only exist in dev as it's npmignore-d.
+  configFromFile = require("../../../config/config.local.json");
+  debug('Loaded config data from config.local.json');
+} catch {
+  // Fall back to `publish` config file.
+  configFromFile = require("../../../config/config.publish.json");
+  debug('Loaded config data from config.publish.json');
+}
+
+const config = Object.assign({}, configFromFile);
+var _default = config;
+exports.default = _default;

package/dist/lib/dev-environment/dev-environment-cli.js

@@ -487,6 +487,8 @@ async function getTagChoices() {
 
 function getEnvTrackingInfo(slug) {
   try {
+    var _result$php;
+
     const envData = (0, _devEnvironmentCore.readEnvironmentData)(slug);
     const result = {
       slug
@@ -499,6 +501,7 @@ function getEnvTrackingInfo(slug) {
       result[snakeCasedKey] = value;
     }
 
+    result.php = (_result$php = result.php) === null || _result$php === void 0 ? void 0 : _result$php.replace(/.*:/, '');
     return result;
   } catch (err) {
     return {

package/dist/lib/dev-environment/dev-environment-lando.js

@@ -110,14 +110,42 @@ function addHooks(app, lando) {
   app.events.on('post-start', 1, () => healthcheckHook(app, lando));
 }
 
+const healthChecks = {
+  database: 'mysql -uroot --silent --execute "SHOW DATABASES;"',
+  'vip-search': "curl -s --noproxy '*' -XGET localhost:9200",
+  php: '[[ -f /wp/wp-includes/pomo/mo.php ]]'
+};
+
 async function healthcheckHook(app, lando) {
   try {
     await lando.Promise.retry(async () => {
       const list = await lando.engine.list({
         project: app.project
       });
-      const containersWithHealthCheck = list.filter(container => container.status.includes('health'));
-      const notHealthyContainers = containersWithHealthCheck.filter(container => !container.status.includes('healthy'));
+      const notHealthyContainers = [];
+
+      for (const container of list) {
+        if (healthChecks[container.service]) {
+          try {
+            debug(`Testing ${container.service}: ${healthChecks[container.service]}`);
+            await app.engine.run({
+              id: container.id,
+              cmd: healthChecks[container.service],
+              compose: app.compose,
+              project: app.project,
+              opts: {
+                silent: true,
+                noTTY: true,
+                cstdio: 'pipe',
+                services: [container.service]
+              }
+            });
+          } catch (e) {
+            debug(`${container.service} Health check failed`);
+            notHealthyContainers.push(container);
+          }
+        }
+      }
 
       if (notHealthyContainers.length) {
         for (const container of notHealthyContainers) {
@@ -185,7 +213,7 @@ async function landoInfo(instancePath) {
   } // Add documentation link
 
 
-  appInfo.Documentation = 'https://docs.wpvip.com/technical-references/vip-local-development-environment/tips/';
+  appInfo.Documentation = 'https://docs.wpvip.com/technical-references/vip-local-development-environment/';
   return appInfo;
 }
 

package/dist/lib/envvar/read-file.js

@@ -5,15 +5,9 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.readVariableFromFile = readVariableFromFile;
 
-var _fs = require("fs");
-
-var exit = _interopRequireWildcard(require("../cli/exit"));
-
 var _logging = require("./logging");
 
-function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
-
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+var _readFile = require("../read-file");
 
 /**
  * 
@@ -29,15 +23,5 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
  */
 async function readVariableFromFile(path) {
   (0, _logging.debug)(`Loading variable value from file ${JSON.stringify(path)}`);
-  const data = await _fs.promises.readFile(path, 'binary').catch(({
-    message
-  }) => {
-    // Provide friendly version of common error.
-    if (message.startsWith('ENOENT: no such file or directory')) {
-      exit.withError(`Could not load file ${JSON.stringify(path)}.`);
-    }
-
-    exit.withError(message);
-  });
-  return Buffer.from(data).toString().trim();
+  return await (0, _readFile.readFromFile)(path);
 }

package/dist/lib/http/proxy-agent.js

@@ -0,0 +1,94 @@
+"use strict";
+
+var _socksProxyAgent = require("socks-proxy-agent");
+
+var _httpsProxyAgent = require("https-proxy-agent");
+
+var _httpProxyAgent = require("http-proxy-agent");
+
+var _proxyFromEnv = require("proxy-from-env");
+
+var _debug = _interopRequireDefault(require("debug"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * External dependencies
+ */
+const debug = (0, _debug.default)('vip:proxy-agent');
+/**
+ * Internal dependencies
+ */
+// Note: This module requires the use of a special environment variable "VIP_USE_SYSTEM_PROXY"
+// The setting of it to any value allows this module to create a proxy agent based on proxy environment variables
+// If not set, this module will revert back to the previous functionality (hence being fully backward compatible and non-breaking for users)
+// This function returns a proxy given a few scenarios (in order of precedence):
+// 1. VIP_PROXY is set: a SOCKS proxy is returned same as the previous version of this module
+// 2. No applicable variables are set: null is returned (thus, no proxy agent is returned)
+// 3. VIP_USE_SYSTEM_PROXY and SOCKS_PROXY are set: a SOCKS_PROXY is returned
+// 4. VIP_USE_SYSTEM_PROXY and HTTPS_PROXY are set: an HTTPS_PROXY is returned
+// 5. VIP_USE_SYSTEM_PROXY and HTTP_PROXY are set: an HTTP_PROXY is returned
+// 6. NO_PROXY is set along with VIP_USE_SYSTEM_PROXY and any system proxy: null is returned if the no proxy applies, otherwise the first active proxy is used
+// This allows near full customization by the client of what proxy should be used, instead of making assumptions based on the URL string
+
+function createProxyAgent(url) {
+  const VIP_PROXY = process.env.VIP_PROXY || process.env.vip_proxy || null;
+  const SOCKS_PROXY = process.env.SOCKS_PROXY || process.env.socks_proxy || null;
+  const HTTPS_PROXY = process.env.HTTPS_PROXY || process.env.https_proxy || null;
+  const HTTP_PROXY = process.env.HTTP_PROXY || process.env.http_proxy || null;
+  const NO_PROXY = process.env.NO_PROXY || process.env.no_proxy || null; // VIP Socks Proxy should take precedence and should be fully backward compatible
+
+  if (VIP_PROXY) {
+    debug(`Enabling VIP_PROXY proxy support using config: ${VIP_PROXY}`);
+    return new _socksProxyAgent.SocksProxyAgent(VIP_PROXY);
+  } // Now check for any system proxy usage
+
+
+  if (process.env.VIP_USE_SYSTEM_PROXY && !coveredInNoProxy(url, NO_PROXY)) {
+    if (SOCKS_PROXY) {
+      debug(`Enabling SOCKS proxy support using config: ${SOCKS_PROXY}`);
+      return new _socksProxyAgent.SocksProxyAgent(SOCKS_PROXY);
+    }
+
+    if (HTTPS_PROXY) {
+      debug(`Enabling HTTPS proxy support using config: ${HTTPS_PROXY}`);
+      return new _httpsProxyAgent.HttpsProxyAgent(HTTPS_PROXY);
+    }
+
+    if (HTTP_PROXY) {
+      debug(`Enabling HTTP proxy support using config: ${HTTP_PROXY}`);
+      return new _httpProxyAgent.HttpProxyAgent(HTTP_PROXY);
+    }
+  } // If no environment variables are set, the no proxy is in effect, or if the proxy enable is not set return null (equivilant of no Proxy agent)
+
+
+  return null;
+} // Determine if a NO_PROXY variable is applicable to a given URL
+// Parameters:
+//	- url (string): absolute desintation URL (including the protocol)
+//	- noProxyString (string | null): string representation of the environments current NO_PROXY or no_proxy variable (NO_PROXY takes precedence)
+// Returns:
+//	- (boolean) true/false depending on result
+// NO_PROXY Rules (based directly on underlying dependency):
+// 1. * (alone): proxy nothing
+// 2. *.site: do not proxy any subdomain of a domain (top level domain must still be given)
+//		Example: '.api' does NOT match wp.api.org, but '.api.org' does (see tests)
+// 3. abc.com: do not proxy www.abc.com, abc.com, etc.
+// See proxy-from-env on npmjs.org for full "ruleset"
+
+
+function coveredInNoProxy(url, noProxyString) {
+  // If the NO_PROXY env variable is not set, then the URL is not covered in the NO_PROXY (utility below does not handle this case)
+  if (!noProxyString) {
+    return false;
+  } // If getProxyForUrl returns an empty string, then the host should not be proxied
+  // This isn't the most straight forward way to determine if a NO_PROXY is applicable, but the only package I could find that is relatively new and maintained
+
+
+  return (0, _proxyFromEnv.getProxyForUrl)(url) === '';
+} // Exports
+
+
+module.exports = {
+  createProxyAgent
+};