User-Based Authentication Capabilities

[sha1sum]

This provides support for user-based authentication with email and password credentials, where either credentials with publicKey/privateKey or email/password are supported when creating the API. .on('auth', ...) still functions properly, and clients must call api.auth() in order to authenticate. Example:

import createApi from 'forte-api'
import os from 'os'

const scope = {
  hostname : os.hostname(),
  trunk    : trunkID,
}
const creds = {
  email    : 'some@body.com',
  password : 'mysupersecretpassword',
}

const api = createApi(creds, scope, {url: 'http://api.powerchord.io'})

api.on('auth', (err, token) => {
  if (err) {
    // ...
  }
  creds.bearerToken = token
})

api.auth().then(() => {
  // ...
})

Some of the documentation was also inaccurate and has been fixed to the best of my ability. Most of it was replacing ForteApi with createApi.