add guest login detection to plugLogin() based on parameters

Author: René Kooi

README.md

@@ -23,6 +23,12 @@ plugLogin(
     console.log(result.body)
   }
 )
+
+// "logging in" as a guest
+plugLogin({ authToken: true }, (err, result) => {
+  if (err) throw err
+  else     console.log(result.token)
+})
 ```
 
 ## API
@@ -53,16 +59,22 @@ request('https://plug.dj/_/users/me', { json: true, jar: result.jar },
 let socket = require('plug-socket')(result.token)
 ```
 
-### plugLogin.guest(opts={}, cb)
+This method is also available as `plugLogin.user`, with the same
+parameters.
+
+### plugLogin(opts={}, cb)
 
 Gets a plug.dj session cookie and, optionally, WebSocket authentication token
 as a guest user.
 
-`opts` takes the same options as `plugLogin()`.
+`opts` takes the same options as user-style `plugLogin()`.
 
 `cb` is a node-style `(err, result)` callback. `result` is similar to what is
 returned by `plugLogin()`, minus the `body` property.
 
+This method is also available as `plugLogin.guest`, with the same
+parameters.
+
 ### plugLogin.getAuthToken(jar, cb)
 
 You can use the `getAuthToken` method separately, for example if you still have

src/index.js

@@ -67,10 +67,7 @@ function guest(opts, cb = null) {
   })
 }
 
-login.getAuthToken = getAuthToken
-login.guest = guest
-
-export default function login(email, password, opts, cb = null) {
+function user(email, password, opts, cb = null) {
   if (!cb) {
     [ cb, opts ] = [ opts, {} ]
   }
@@ -86,5 +83,18 @@ export default function login(email, password, opts, cb = null) {
     if (e) cb(e)
     else   cb(null, { body, token, jar: opts.jar })
   })
+}
 
+login.getAuthToken = getAuthToken
+login.guest = guest
+login.user = user
+
+export default function login(email, password, opts, cb = null) {
+  if (typeof email === 'string') {
+    return user(email, password, opts, cb)
+  }
+  else {
+    [ opts, cb ] = [ email, password ]
+    return guest(opts, cb)
+  }
 }