feat(server): Log the service and reason parameters for `/account…

…/login`.

This is the first step to determine the volume of notificatione mails that will be sent.

issue #875

docs/api.md

@@ -272,6 +272,8 @@ ___Parameters___
 
 * email - the primary email for this account
 * authPW - the PBKDF2/HKDF stretched password as a hex string
+* service - (optional) opaque alphanumeric token to be included in verification links
+* reason - (optional) alphanumeric string indicating the reason for establishing a new session; may be "login" (the default) or "reconnect"
 
 ### Request
 

lib/log.js

@@ -85,6 +85,7 @@ Lug.prototype.summary = function (request, response) {
     request.auth.credentials.uid :
     payload.uid || query.uid || '00'
   line.service = payload.service || query.service
+  line.reason = payload.reason || query.reason
   line.redirectTo = payload.redirectTo || query.redirectTo
   line.keys = query.keys
   line.email = payload.email || query.email

lib/routes/account.js

@@ -200,7 +200,9 @@ module.exports = function (
         validate: {
           payload: {
             email: validators.email().required(),
-            authPW: isA.string().min(64).max(64).regex(HEX_STRING).required()
+            authPW: isA.string().min(64).max(64).regex(HEX_STRING).required(),
+            service: isA.string().max(16).alphanum().optional(),
+            reason: isA.string().max(16).optional()
           }
         },
         response: {

test/client/api.js

@@ -120,7 +120,9 @@ ClientApi.prototype.accountLogin = function (email, authPW, opts) {
     null,
     {
       email: email,
-      authPW: authPW.toString('hex')
+      authPW: authPW.toString('hex'),
+      service: opts.service || undefined,
+      reason: opts.reason || undefined
     }
   )
 }

test/remote/account_login_tests.js

@@ -95,6 +95,24 @@ TestServer.start(config)
     }
   )
 
+  test(
+    'accepts a `reason` and `service`',
+    function (t) {
+      var email = server.uniqueEmail()
+      var password = 'abcdef'
+      return Client.createAndVerify(config.publicUrl, email, password, server.mailbox)
+        .then(
+          function (c) {
+            return Client.login(config.publicUrl, email, password, { service: 'sync', reason: 'signin' })
+          }
+        )
+        .then(
+          function (c) {
+          }
+        )
+    }
+  )
+
   test(
     'teardown',
     function (t) {