Implement security:getUserStrategies (#612)

## What does this PR do?

As the title suggests, this **PR** implements the recently added [security:getUserStrategies](https://docs.kuzzle.io/core/2/api/controllers/security/get-user-strategies/) _(@ Kuzzle Backend)_
So it can be used directly, instead of having to use **query** to access it.

Closes #611

Author: Leodau

doc/7/controllers/security/get-user-strategies/index.md

@@ -0,0 +1,40 @@
+---
+code: true
+type: page
+title: getUserStrategies
+description: Gets all the available authentication strategies of a user
+---
+
+# getUserStrategies
+
+<SinceBadge version="Kuzzle 2.9.0"/>
+<SinceBadge version="auto-version"/>
+
+Gets all the available authentication strategies of a user.
+
+<br />
+
+```js
+getUserStrategies(kuid, [options]);
+```
+
+<br />
+
+| Property | Type | Description |
+|--- |--- |--- |
+| `kuid` | <pre>string</pre> | User [kuid](/core/2/guides/main-concepts/authentication#kuzzle-user-identifier-kuid) |
+| `options` | <pre>object</pre> | Query options |
+
+### options
+
+| Property | Type<br />(default) | Description |
+| --- | --- | --- |
+| `queuable` | <pre>boolean</pre><br />(`true`) | If true, queues the request during downtime, until connected to Kuzzle again |
+
+## Resolves
+
+Resolves to an array of strings containing all the authentication strategies available for the requested user.
+
+## Usage
+
+<<< ./snippets/get-user-strategies.js

doc/7/controllers/security/get-user-strategies/snippets/get-user-strategies.js

@@ -0,0 +1,4 @@
+const strategies = await kuzzle.security.getUserStrategies('john.doe');
+
+console.log(strategies);
+// [ 'local' ]

doc/7/controllers/security/get-user-strategies/snippets/get-user-strategies.test.yml

@@ -0,0 +1,20 @@
+name: security#getUserStrategies
+description: get user strategies
+hooks:
+  before: >
+    curl --fail -H "Content-type: application/json" -d '{
+      "content": {
+        "profileIds": [ "default" ],
+        "fullName": "John Doe"
+      },
+      "credentials": {
+        "local": {
+          "username": "jdoe",
+          "password": "password"
+        }
+      }
+    }' kuzzle:7512/users/john.doe/_create
+  after: curl -XDELETE kuzzle:7512/users/john.doe
+template: catch
+expected:
+  - "[ 'local' ]"

src/controllers/Security.js

@@ -330,6 +330,14 @@ class SecurityController extends BaseController {
       .then(response => response.result.hits);
   }
 
+  getUserStrategies (_id, options = {}) {
+    return this.query({
+      _id,
+      action: 'getUserStrategies'
+    }, options)
+      .then(response => response.result.strategies);
+  }
+
   hasCredentials (strategy, _id, options = {}) {
     return this.query({
       strategy,

src/protocols/routes.json

@@ -250,6 +250,10 @@
       "url": "/users/:_id/_rights",
       "verb": "GET"
     },
+    "getUserStrategies": {
+      "url": "/users/:_id/_strategies",
+      "verb": "GET"
+    },
     "searchUsers": {
       "url": "/users/_search",
       "verb": "POST"

test/controllers/security.test.js

@@ -760,6 +760,28 @@ describe('Security Controller', () => {
     });
   });
 
+  describe('getUserStrategies', () => {
+    it('should call security/getUserStrategies query with the user id return a Promise which resolves the list of strategies', () => {
+      const result = {
+        strategies: ['local']
+      };
+      kuzzle.query.resolves({result});
+
+      return kuzzle.security.getUserStrategies('kuid', options)
+        .then(res => {
+          should(kuzzle.query)
+            .be.calledOnce()
+            .be.calledWith({
+              _id: 'kuid',
+              controller: 'security',
+              action: 'getUserStrategies'
+            }, options);
+
+          should(res).be.eql(result.strategies);
+        });
+    });
+  });
+
   describe('hasCredentials', () => {
     it('should call security/hasCredentials query and return a Promise which resolves a boolean', () => {
       kuzzle.query.resolves({result: true});