feat(authentication): handle providers

Method to retrieve the connect provider URL
Method to authenticate the user

Closes #3

Author: lucaperret

package.json

@@ -59,6 +59,7 @@
     "@types/qs": "^6.5.1",
     "@types/sinon": "^4.3.1",
     "ava": "^1.0.0-beta.4",
+    "browser-env": "^3.2.5",
     "codecov": "^3.0.0",
     "cz-conventional-changelog": "^2.1.0",
     "gh-pages": "^1.0.0",

src/lib/sdk.spec.ts

@@ -1,4 +1,5 @@
 import anyTest, { TestInterface } from 'ava';
+import browserEnv from 'browser-env';
 import * as sinon from 'sinon';
 import Strapi from './sdk';
 
@@ -27,6 +28,8 @@ test('Create an instance', t => {
       'login',
       'forgotPassword',
       'resetPassword',
+      'getProviderAuthenticationUrl',
+      'authenticateProvider',
       'getEntries',
       'getEntry',
       'createEntry',
@@ -203,6 +206,73 @@ test('Reset password', async t => {
   );
 });
 
+test('Provider authentication url', t => {
+  t.is(
+    t.context.strapi.getProviderAuthenticationUrl('facebook'),
+    'http://strapi-host/connect/facebook'
+  );
+});
+
+test('Provider authentication on Node.js', async t => {
+  t.context.axiosRequest.resolves({
+    data: {
+      jwt: 'foo',
+      user: {}
+    }
+  });
+  const authentication = await t.context.strapi.authenticateProvider(
+    'facebook',
+    {
+      code: 'XXX'
+    }
+  );
+
+  t.true(
+    t.context.axiosRequest.calledWithExactly({
+      method: 'get',
+      params: {
+        code: 'XXX'
+      },
+      url: '/auth/facebook/callback'
+    })
+  );
+  t.deepEqual(authentication, {
+    jwt: 'foo',
+    user: {}
+  });
+});
+
+test.serial('Provider authentication on browser', async t => {
+  const globalAny: any = global;
+  browserEnv(['window'], {
+    url: 'http://localhost?access_token=XXX'
+  });
+  t.context.axiosRequest.resolves({
+    data: {
+      jwt: 'foo',
+      user: {}
+    }
+  });
+  const authentication = await t.context.strapi.authenticateProvider(
+    'github'
+  );
+
+  t.true(
+    t.context.axiosRequest.calledWithExactly({
+      method: 'get',
+      params: {
+        access_token: 'XXX'
+      },
+      url: '/auth/github/callback'
+    })
+  );
+  t.deepEqual(authentication, {
+    jwt: 'foo',
+    user: {}
+  });
+  delete globalAny.window;
+});
+
 test('Get entries', async t => {
   await t.context.strapi.getEntries('user', {
     _sort: 'email:asc'

src/lib/sdk.ts

@@ -6,6 +6,14 @@ export interface Authentication {
   jwt: string;
 }
 
+export type Provider = 'facebook' | 'google' | 'github' | 'twitter';
+
+export interface Token {
+  access_token?: string;
+  code?: string;
+  oauth_token?: string;
+}
+
 export default class Strapi {
   public axios: AxiosInstance;
 
@@ -136,6 +144,30 @@ export default class Strapi {
     });
   }
 
+  public getProviderAuthenticationUrl(provider: Provider): string {
+    return `${this.axios.defaults.baseURL}/connect/${provider}`;
+  }
+
+  public async authenticateProvider(
+    provider: Provider,
+    params?: Token
+  ): Promise<Authentication> {
+    this.clearToken();
+    // Handling browser query
+    if (typeof window !== 'undefined') {
+      params = qs.parse(window.location.search, { ignoreQueryPrefix: true });
+    }
+    const authentication: Authentication = await this.request(
+      'get',
+      `/auth/${provider}/callback`,
+      {
+        params
+      }
+    );
+    this.setToken(authentication.jwt);
+    return authentication;
+  }
+
   /**
    * List entries
    * @param contentType

src/types/browser-env.d.ts

@@ -0,0 +1 @@
+declare module 'browser-env';