Adding getAccessToken method to api.

.jshintrc

@@ -0,0 +1,37 @@
+{
+  "node": true,
+  "esnext": true,
+  "bitwise": true,
+  "curly": true,
+  "eqeqeq": true,
+  "immed": true,
+  "indent": 2,
+  "latedef": true,
+  "newcap": true,
+  "noarg": true,
+  "quotmark": "single",
+  "regexp": true,
+  "undef": true,
+  "strict": false,
+  "smarttabs": true,
+  "expr": true,
+
+
+  "evil": true,
+  "browser": true,
+  "regexdash": true,
+  "wsh": true,
+  "trailing": true,
+  "sub": true,
+  "unused": true,
+  "laxcomma": true,
+
+  "globals": {
+    "after": false,
+    "before": false,
+    "afterEach": false,
+    "beforeEach": false,
+    "describe": false,
+    "it": false
+  }
+}

README.md

@@ -95,6 +95,24 @@ api.getUsers({connection: 'a-waad-connection'}, function (err, firstPageOfResult
 
 The same than ```getUsers``` but this method returns users for all social connections, ie: not enterprise connections.
 
+
+### api.getAccessToken(callback)
+
+Retrieves an Access Token to make direct HTTP calls to Auth0 API.
+```js
+
+api.getAccessToken(function (err, token) {
+  if (err) {
+    console.log('Error fetching token: ' + err);
+    return;
+  }
+
+  // Do something with token
+  ...
+});
+
+```
+
 ### api.updateUserMetadata(userId, metadata, callback)
 
 This method updates the metadata for a user. `metadata` is an object, and the fields in that object will be set on the user referenced by `userId`.

lib/Client.js

@@ -43,7 +43,7 @@ Client.getAccessToken = function (options, done) {
   });
 };
 
-Client.prototype._getAccessToken = function(done){
+Client.prototype.getAccessToken = function(done){
   var self = this;
 
   if (this._currentAccessToken) return done(null, this._currentAccessToken);
@@ -56,7 +56,7 @@ Client.prototype._getAccessToken = function(done){
     setTimeout(function () {
       delete self._currentAccessToken;
     }, 1000 * 60 * 3); //~ 3 hours
-    
+
     done(null, token);
   });
 };
@@ -65,17 +65,17 @@ Object.keys(api).forEach(function (m) {
   Client.prototype[m] = function (){
     var args = [].slice.call(arguments);
     var callback = args[args.length - 1];
-    
+
     if (this.options.accessToken) {
       api[m].apply(this, [this.options.accessToken].concat(args));
     }
     else {
-      this._getAccessToken(function (err, accessToken) {
+      this.getAccessToken(function (err, accessToken) {
         if (err) return callback(err);
         api[m].apply(this, [accessToken].concat(args));
       }.bind(this));
     }
   };
 });
 
-module.exports = Client;
+module.exports = Client;

package.json

@@ -4,7 +4,7 @@
   "description": "Client library for the Auth0 platform",
   "main": "lib/index.js",
   "scripts": {
-    "test": "mocha"
+    "test": "mocha test"
   },
   "repository": {
     "type": "git",
@@ -20,8 +20,9 @@
   ],
   "license": "MIT",
   "devDependencies": {
-    "mocha": "~1.7.0",
-    "should": "~1.2.1"
+    "mocha": "~1.17.1",
+    "chai": "~1.9.0",
+    "nock": "~0.27.2"
   },
   "dependencies": {
     "xtend": "~1.0.3",

test/api.js

@@ -0,0 +1,80 @@
+var expect = require('chai').expect;
+
+var nock        = require('nock');
+var querystring = require('querystring');
+
+var Auth0 = require('../lib');
+
+
+describe('API', function () {
+
+  describe('getAccessToken', function () {
+    it('should work on request success', function (done) {
+      var scope;
+
+      var domain        = 'mydomain.auth0.com',
+          clientID      = 'SOME_SECRET_ID',
+          clientSecret  = 'SOME_SECRET_SHHHH',
+          accessToken   = 'OMG_SO_TOKEN_SUCH_CRYPTO';
+
+      var qs = querystring.stringify({
+          client_id:      clientID,
+          client_secret:  clientSecret,
+          grant_type:     'client_credentials'
+        });
+
+      scope = nock('https://' + domain)
+        .post('/oauth/token', qs)
+        .reply(200, {
+          'access_token': accessToken,
+          'token_type':   'bearer'
+        });
+
+      var api = new Auth0({
+        domain:       domain,
+        clientID:     clientID,
+        clientSecret: clientSecret
+      });
+
+      api.getAccessToken(function (err, token) {
+        expect(err).to.not.exist;
+        expect(token).to.be.equal(accessToken);
+        done();
+      });
+    });
+
+    it('should fail when request fails', function (done) {
+      var scope;
+
+      var error = 'Error: Token could not be retrieved';
+
+      var domain        = 'mydomain.auth0.com',
+          clientID      = 'SOME_SECRET_ID',
+          clientSecret  = 'SOME_SECRET_SHHHH';
+
+      var qs = querystring.stringify({
+          client_id:      clientID,
+          client_secret:  clientSecret,
+          grant_type:     'client_credentials'
+        });
+
+      scope = nock('https://' + domain)
+        .post('/oauth/token', qs)
+        .reply(401, error);
+
+      var api = new Auth0({
+        domain:       domain,
+        clientID:     clientID,
+        clientSecret: clientSecret
+      });
+
+      api.getAccessToken(function (err, token) {
+        expect(err).not.to.be.equal(null);
+        expect(err.name).to.be.equal('ApiError');
+        expect(err.statusCode).to.be.equal(401);
+        expect(token).to.not.exist;
+        done();
+      });
+    });
+  });
+});