Add 'fetch-timeout' config

This gets passed down to dependencies as 'timeout', so that the HTTP
request libraries will all get the right value.

Fix: #1780

PR-URL: #1870
Credit: @isaacs
Close: #1870
Reviewed-by: @nlf

Author: isaacs

docs/content/using-npm/config.md

@@ -470,6 +470,13 @@ packages.
 The "maxTimeout" config for the `retry` module to use when fetching
 packages.
 
+#### fetch-timeout
+
+* Default: 300000 (5 minutes)
+* Type: Number
+
+The maximum amount of time to wait for HTTP requests to complete.
+
 #### fund
 
 * Default: true

lib/utils/config.js

@@ -88,6 +88,7 @@ const defaults = {
   'fetch-retry-factor': 10,
   'fetch-retry-mintimeout': 10000,
   'fetch-retry-maxtimeout': 60000,
+  'fetch-timeout': 5 * 60 * 1000,
 
   git: 'git',
   'git-tag-version': true,
@@ -221,6 +222,7 @@ const types = {
   'fetch-retry-factor': Number,
   'fetch-retry-mintimeout': Number,
   'fetch-retry-maxtimeout': Number,
+  'fetch-timeout': Number,
   git: String,
   'git-tag-version': Boolean,
   'commit-hooks': Boolean,

lib/utils/flat-options.js

@@ -147,6 +147,8 @@ const flatOptions = npm => npm.flatOptions || Object.freeze({
     minTimeout: npm.config.get('fetch-retry-mintimeout')
   },
 
+  timeout: npm.config.get('fetch-timeout'),
+
   force: npm.config.get('force'),
 
   formatPackageLock: npm.config.get('format-package-lock'),

tap-snapshots/test-lib-utils-config.js-TAP.test.js

@@ -42,6 +42,7 @@ Object {
     "fetch-retry-factor": 10,
     "fetch-retry-maxtimeout": 60000,
     "fetch-retry-mintimeout": 10000,
+    "fetch-timeout": 300000,
     "force": false,
     "format-package-lock": true,
     "fund": true,
@@ -339,6 +340,7 @@ Object {
     "fetch-retry-factor": "{Number TYPE}",
     "fetch-retry-maxtimeout": "{Number TYPE}",
     "fetch-retry-mintimeout": "{Number TYPE}",
+    "fetch-timeout": "{Number TYPE}",
     "force": "{Boolean TYPE}",
     "format-package-lock": "{Boolean TYPE}",
     "fund": "{Boolean TYPE}",
@@ -554,6 +556,7 @@ Object {
     "fetch-retry-factor": 10,
     "fetch-retry-maxtimeout": 60000,
     "fetch-retry-mintimeout": 10000,
+    "fetch-timeout": 300000,
     "force": false,
     "format-package-lock": true,
     "fund": true,
@@ -851,6 +854,7 @@ Object {
     "fetch-retry-factor": "{Number TYPE}",
     "fetch-retry-maxtimeout": "{Number TYPE}",
     "fetch-retry-mintimeout": "{Number TYPE}",
+    "fetch-timeout": "{Number TYPE}",
     "force": "{Boolean TYPE}",
     "format-package-lock": "{Boolean TYPE}",
     "fund": "{Boolean TYPE}",
@@ -1066,6 +1070,7 @@ Object {
     "fetch-retry-factor": 10,
     "fetch-retry-maxtimeout": 60000,
     "fetch-retry-mintimeout": 10000,
+    "fetch-timeout": 300000,
     "force": false,
     "format-package-lock": true,
     "fund": true,
@@ -1363,6 +1368,7 @@ Object {
     "fetch-retry-factor": "{Number TYPE}",
     "fetch-retry-maxtimeout": "{Number TYPE}",
     "fetch-retry-mintimeout": "{Number TYPE}",
+    "fetch-timeout": "{Number TYPE}",
     "force": "{Boolean TYPE}",
     "format-package-lock": "{Boolean TYPE}",
     "fund": "{Boolean TYPE}",

tap-snapshots/test-lib-utils-flat-options.js-TAP.test.js

@@ -115,6 +115,7 @@ Object {
   "strictSSL": "strict-ssl",
   "tag": "tag",
   "tagVersionPrefix": "tag-version-prefix",
+  "timeout": "fetch-timeout",
   "tmp": "/tmp",
   "umask": 18,
   "unicode": undefined,

test/lib/utils/flat-options.js

@@ -73,6 +73,7 @@ class MockConfig {
       'fetch-retry-factor': 'fetch-retry-factor',
       'fetch-retry-mintimeout': 'fetch-retry-mintimeout',
       'fetch-retry-maxtimeout': 'fetch-retry-maxtimeout',
+      'fetch-timeout': 'fetch-timeout',
       force: 'force',
       'format-package-lock': 'format-package-lock',
       fund: 'fund',