Merge pull request #52 from kuzzleio/KUZ-378-whoami

KUZ-378 OMG Who Am I? (identity crisis)

Author: AnthonySendra

dist/kuzzle.js

@@ -541,7 +541,7 @@ module.exports = Kuzzle = function (url, options, cb) {
       filter: function (name, func, target, passes) {
         var whitelist = ['getAllStatistics', 'getServerInfo', 'getStatistics',
           'listCollections', 'listIndexes', 'login', 'logout', 'now', 'query',
-          'checkToken'];
+          'checkToken', 'whoAmI'];
 
         return passes && whitelist.indexOf(name) !== -1;
       }
@@ -753,6 +753,23 @@ Kuzzle.prototype.checkToken = function (token, callback) {
   return self;
 };
 
+/**
+ * Fetches the current user.
+ *
+ * @param  {function} callback  The callback to be called when the response is
+ *                              available. The signature is `function(error, response)`.
+ * @return {Kuzzle}             The Kuzzle instance to enable chaining.
+ */
+Kuzzle.prototype.whoAmI = function (callback) {
+  var self = this;
+
+  this.callbackRequired('Kuzzle.whoAmI', callback);
+
+  this.query({controller: 'auth', action: 'getCurrentUser'}, {}, {}, callback);
+
+  return self;
+};
+
 /**
  * Clean up the queue, ensuring the queryTTL and queryMaxSize properties are respected
  */

dist/kuzzle.min.js

@@ -266,7 +266,7 @@ module.exports = Kuzzle = function (url, options, cb) {
       filter: function (name, func, target, passes) {
         var whitelist = ['getAllStatistics', 'getServerInfo', 'getStatistics',
           'listCollections', 'listIndexes', 'login', 'logout', 'now', 'query',
-          'checkToken'];
+          'checkToken', 'whoAmI'];
 
         return passes && whitelist.indexOf(name) !== -1;
       }
@@ -478,6 +478,23 @@ Kuzzle.prototype.checkToken = function (token, callback) {
   return self;
 };
 
+/**
+ * Fetches the current user.
+ *
+ * @param  {function} callback  The callback to be called when the response is
+ *                              available. The signature is `function(error, response)`.
+ * @return {Kuzzle}             The Kuzzle instance to enable chaining.
+ */
+Kuzzle.prototype.whoAmI = function (callback) {
+  var self = this;
+
+  this.callbackRequired('Kuzzle.whoAmI', callback);
+
+  this.query({controller: 'auth', action: 'getCurrentUser'}, {}, {}, callback);
+
+  return self;
+};
+
 /**
  * Clean up the queue, ensuring the queryTTL and queryMaxSize properties are respected
  */

dist/kuzzle.min.map

@@ -186,6 +186,7 @@ describe('Kuzzle constructor', () => {
       should.exist(kuzzle.nowPromise);
       should.exist(kuzzle.queryPromise);
       should.exist(kuzzle.checkTokenPromise);
+      should.exist(kuzzle.whoAmIPromise);
       should.not.exist(kuzzle.removeAllListenersPromise);
       should.not.exist(kuzzle.removeListenerPromise);
       should.not.exist(kuzzle.replayQueuePromise);

src/kuzzle.js

@@ -542,4 +542,24 @@ describe('Kuzzle methods', function () {
       }
     });
   });
+
+  describe('#whoAmI', function () {
+    it('should send the getCurrentUser after call', function () {
+      var kuzzle;
+
+      this.timeout(200);
+
+      kuzzle = new Kuzzle('nowhere', {
+        connect: 'manual'
+      });
+
+      kuzzle.queuing = true;
+
+      kuzzle.whoAmI(function (err, res) {});
+
+      should(kuzzle.offlineQueue.length).be.exactly(1);
+      should(kuzzle.offlineQueue[0].query.action).be.exactly('getCurrentUser');
+      should(kuzzle.offlineQueue[0].query.controller).be.exactly('auth');
+    });
+  });
 });