feat: add npm-command HTTP header

README.md

@@ -398,6 +398,15 @@ If provided, will be sent in the `npm-session` header. This header is used by
 the npm registry to identify individual user sessions (usually individual
 invocations of the CLI).
 
+##### <a name="opts-npmCommand"></a> `opts.npmCommand`
+
+* Type: String
+* Default: null
+
+If provided, it will be sent in the `npm-command` header.  This yeader is
+used by the npm registry to identify the npm command that caused this
+request to be made.
+
 ##### <a name="opts-offline"></a> `opts.offline`
 
 * Type: Boolean

index.js

@@ -186,6 +186,10 @@ function getHeaders (registry, uri, opts) {
     headers['npm-session'] = opts.npmSession
   }
 
+  if (opts.npmCommand) {
+    headers['npm-command'] = opts.npmCommand
+  }
+
   const auth = getAuth(registry, opts)
   // If a tarball is hosted on a different place than the manifest, only send
   // credentials on `alwaysAuth`

test/index.js

@@ -494,10 +494,6 @@ test('npm-in-ci header with forced CI=false', t => {
     })
 })
 
-// TODO
-// * npm-session
-// * npm-scope
-// * user-agent
 test('miscellaneous headers', t => {
   tnock(t, OPTS.registry)
     .matchHeader('npm-session', session =>
@@ -508,14 +504,17 @@ test('miscellaneous headers', t => {
       t.strictSame(ua, ['agent of use'], 'UA set from options'))
     .matchHeader('npm-in-ci', ci =>
       t.strictSame(ci, ['false'], 'CI set from options'))
+    .matchHeader('npm-command', cmd =>
+      t.strictSame(cmd, ['hello-world'], 'command set from options'))
     .get('/hello')
     .reply(200, { hello: 'world' })
 
   return fetch('/hello', {
     ...OPTS,
     npmSession: 'foobarbaz',
     projectScope: '@foo',
-    userAgent: 'agent of use'
+    userAgent: 'agent of use',
+    npmCommand: 'hello-world'
   }).then(res => {
     t.equal(res.status, 200, 'got successful response')
   })