Client side auth urls

Author: Kai Wood

lib/pnut.js

@@ -56,10 +56,44 @@ const pnut = () => {
      * @param {string} method - HTTP verb, defaults to GET
      * @return {Promise}
      */
-     custom(endpoint, method = 'GET', data = {}) {
+    custom(endpoint, method = 'GET', data = {}) {
       endpoint = endpoint.startsWith('/') ? `${endpoint}` : `/${endpoint}`
-      return call(`${_base}${endpoint}`, {httpMethod: method, data: data})
-     },
+      return call(`${_base}${endpoint}`, { httpMethod: method, data: data })
+    },
+
+    /**
+    * Generate a URL for client side authentication
+    * @param {string} - Client ID token
+    * @param {string} redirectURI - URI you want to be redirected at
+    * @param {object} [scope] - The scope you want to request
+    * @returns {string}
+    */
+    authenticateClientURL(clientId = '', redirectURI = '', scope = {
+          basic: true,
+          stream: true,
+          write_post: true,
+          follow: true,
+          update_profile: true,
+          presence: true,
+          messages: true,
+          public_messages: true,
+
+    }) {
+
+      if (clientId.length < 1) {
+        throw new Error('You need a client ID for this request');
+      } else if (redirectURI.length < 1) {
+        throw new Error('You need a redirect URI for this request');
+      }
+
+      let url = `${_base}/authenticate?`;
+      url += `clientId=${clientId}`;
+      url += `&redirect_uri=${redirectURI}`
+      url += `&scope=${Object.keys(scope).join(',')}`
+      url += `&response_type=token`
+
+      return url
+    },
 
     /**
      * The global timeline

test/pnut.js

@@ -107,6 +107,25 @@ describe('The pnut API wrapper', function () {
     return pnut.custom('/somewhere', 'PATCH', {text: 'sometext'});
   })
 
+  /**
+   * Authentication
+   */
+  describe('When requesting an authentication url, it', () => {
+    it('should fail when no client id is given', () => {
+      expect(() => pnut.authenticateClientURL('', 'http://github.com')).to.throw(Error)
+    });
+
+    it('should fail if no redirect uri is given', () => {
+      expect(() => pnut.authenticateClientURL('sometoken', '')).to.throw(Error)
+    });
+
+    it('should give back a correct url where the client can authenticate', () => {
+      let expectedURL = 'https://api.pnut.io/v0/authenticate?clientId=mytoken&redirect_uri=http://github.com&scope=basic,stream,write_post,follow,update_profile,presence,messages,public_messages&response_type=token';
+
+      expect(pnut.authenticateClientURL('mytoken', 'http://github.com')).to.equal(expectedURL);
+    })
+  })
+
   /**
    * User context
    */