litecraft-yggdrasil/lib/Client.js

Mojang authentication (Yggdrasil) client

'use strict'

var uuid = require('uuid')
var utils = require('./utils')

var Client = {}

var defaultHost = 'https://authserver.mojang.com'

/**
 * Attempts to authenticate a user.
 * @param  {Object}   options Config object
 * @param  {Function} cb      Callback
 */
Client.auth = function (options, cb) {
  var host = this.host || defaultHost

  if (options.token === null) {
    delete options.token
  } else {
    options.token = options.token || uuid.v4()
  }

  options.agent = options.agent || 'Minecraft'
  utils.call(host, 'authenticate', {
    agent: {
      name: options.agent,
      version: options.agent === 'Minecraft' ? 1 : options.version
    },
    username: options.user,
    password: options.pass,
    clientToken: options.token,
    requestUser: options.requestUser === true
  }, function (err, data) {
    cb(err, data)
  })
}

/**
 * Refreshes a accessToken.
 * @param  {String}   access Old Access Token
 * @param  {String}   client Client Token
 * @param  {Function} cb     (err, new token, full response body)
 */
Client.refresh = function (access, client, cb) {
  var host = this.host || defaultHost
  utils.call(host, 'refresh', {
    accessToken: access,
    clientToken: client
  }, function (err, data) {
    if (data && data.clientToken !== client) {
      cb(new Error('clientToken assertion failed'))
    } else {
      cb(err, data ? data.accessToken : null, data)
    }
  })
}

/**
 * Validates an access token
 * @param  {String}   token Token to validate
 * @param  {Function} cb    (isValid)
 */
Client.validate = function (token, cb) {
  var host = this.host || defaultHost
  utils.post(host, 'validate', {
    accessToken: token
  }, function (err, data) {
    cb(!err && data.statusCode === 204)
  })
}

/**
 * Invalidates all access tokens.
 * @param  {String}   user User's user
 * @param  {String}   pass User's pass
 * @param  {Function} cb   (error)
 */
Client.signout = function (user, pass, cb) {
  var host = this.host || defaultHost
  utils.call(host, 'signout', {
    username: user,
    password: pass
  }, function (err, data) {
    cb(err)
  })
}

module.exports = Client