feat(setUserToken): Add functionality to manually set auth token

docs/api/auth.md

@@ -63,6 +63,19 @@ this.$auth.login(/* .... */)
   .then(() => this.$toast.success('Logged In!'))
 ```
 
+### `setUserToken(token)`
+
+- Returns: `Promise`
+
+Set the auth token and fetch the user using the new token and current strategy. 
+
+> **TIP:** This function can properly set the user after registration
+
+```js
+this.$auth.setUserToken(token)
+  .then(() => this.$toast.success('User set!'))
+```
+
 ## `logout()`
 
 - Returns: `Promise`

lib/core/auth.js

@@ -44,7 +44,7 @@ export default class Auth {
         return Promise.resolve()
       }
     }
-    
+
     try {
       // Call mounted for active strategy on initial load
       await this.mounted()
@@ -156,6 +156,18 @@ export default class Auth {
     })
   }
 
+  setUserToken (token) {
+    if (!this.strategy.setUserToken) {
+      this.setToken(this.strategy.name, token)
+      return Promise.resolve()
+    }
+
+    return Promise.resolve(this.strategy.setUserToken(token)).catch(error => {
+      this.callOnError(error, { method: 'setUserToken' })
+      return Promise.reject(error)
+    })
+  }
+
   reset () {
     if (!this.strategy.reset) {
       this.setUser(false)

lib/schemes/local.js

@@ -54,6 +54,22 @@ export default class LocalScheme {
     return this.fetchUser()
   }
 
+  async setUserToken (tokenValue) {
+    // Ditch any leftover local tokens before attempting to log in
+    await this._logoutLocally()
+
+    if (this.options.tokenRequired) {
+      const token = this.options.tokenType
+        ? this.options.tokenType + ' ' + tokenValue
+        : tokenValue
+
+      this.$auth.setToken(this.name, token)
+      this._setToken(token)
+    }
+
+    return this.fetchUser()
+  }
+
   async fetchUser (endpoint) {
     // User endpoint is disabled.
     if (!this.options.endpoints.user) {