Merge pull request #9 from JMPerez/add-follow-unfollow

Add Follow - Unfollow users and artists

Author: JMPerez

Gruntfile.js

@@ -13,8 +13,9 @@ module.exports = function(grunt) {
     watch: {
       test: {
         files: [
-          'tests/**/*.html',
-          '*.js'
+          'src/**/*.js',
+          'tests/**/*.js',
+          'tests/**/*.html'
         ],
         tasks: ['default']
       }

bower.json

@@ -1,7 +1,7 @@
 {
   "name": "spotify-web-api-js",
   "description": "A client-side JS wrapper for the Spotify Web API",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "homepage": "https://github.com/JMPerez/spotify-web-api-js",
   "author": {
     "name": "José M. Pérez"

package.json

@@ -1,7 +1,7 @@
 {
   "name": "spotify-web-api-js",
   "description": "A client-side JS wrapper for the Spotify Web API",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "homepage": "https://github.com/JMPerez/spotify-web-api-js",
   "author": {
     "name": "José M. Pérez"

src/spotify-web-api.js

@@ -59,7 +59,7 @@ var SpotifyWebApi = (function() {
             data = req.responseText ? JSON.parse(req.responseText) : '';
           } catch (e) {}
 
-          if (req.status === 200 || req.status === 201) {
+          if (req.status >= 200 && req.status < 300) {
             if (resolve) {
               resolve(data);
             }
@@ -230,6 +230,126 @@ var SpotifyWebApi = (function() {
     return _checkParamsAndPerformRequest(requestData, options, callback);
   };
 
+  /**
+   * Adds the current user as a follower of one or more other Spotify users.
+   * See [Follow Artists or Users](https://developer.spotify.com/web-api/follow-artists-users/) on
+   * the Spotify Developer site for more information about the endpoint.
+   * @param {function(Object, Object)} callback An optional callback that receives 2 parameters. The first
+   * one is the error object (null if no error), and the second is the value if the request succeeded.
+   * @return {Object} Null if a callback is provided, a `Promise` object otherwise
+   */
+  Constr.prototype.followUsers = function(userIds, callback) {
+    var requestData = {
+      url: _baseUri + '/me/following/',
+      type: 'PUT',
+      params: {
+        ids: userIds.join(','),
+        type: 'user'
+      }
+    };
+    return _checkParamsAndPerformRequest(requestData, callback);
+  };
+
+  /**
+   * Adds the current user as a follower of one or more artists.
+   * See [Follow Artists or Users](https://developer.spotify.com/web-api/follow-artists-users/) on
+   * the Spotify Developer site for more information about the endpoint.
+   * @param {function(Object, Object)} callback An optional callback that receives 2 parameters. The first
+   * one is the error object (null if no error), and the second is the value if the request succeeded.
+   * @return {Object} Null if a callback is provided, a `Promise` object otherwise
+   */
+  Constr.prototype.followArtists = function(artistIds, callback) {
+    var requestData = {
+      url: _baseUri + '/me/following/',
+      type: 'PUT',
+      params: {
+        ids: artistIds.join(','),
+        type: 'artist'
+      }
+    };
+    return _checkParamsAndPerformRequest(requestData, callback);
+  };
+
+  /**
+   * Removes the current user as a follower of one or more other Spotify users.
+   * See [Unfollow Artists or Users](https://developer.spotify.com/web-api/unfollow-artists-users/) on
+   * the Spotify Developer site for more information about the endpoint.
+   * @param {function(Object, Object)} callback An optional callback that receives 2 parameters. The first
+   * one is the error object (null if no error), and the second is the value if the request succeeded.
+   * @return {Object} Null if a callback is provided, a `Promise` object otherwise
+   */
+  Constr.prototype.unfollowUsers = function(userIds, callback) {
+    var requestData = {
+      url: _baseUri + '/me/following/',
+      type: 'DELETE',
+      params: {
+        ids: userIds.join(','),
+        type: 'user'
+      }
+    };
+    return _checkParamsAndPerformRequest(requestData, callback);
+  };
+
+  /**
+   * Removes the current user as a follower of one or more artists.
+   * See [Unfollow Artists or Users](https://developer.spotify.com/web-api/unfollow-artists-users/) on
+   * the Spotify Developer site for more information about the endpoint.
+   * @param {function(Object, Object)} callback An optional callback that receives 2 parameters. The first
+   * one is the error object (null if no error), and the second is the value if the request succeeded.
+   * @return {Object} Null if a callback is provided, a `Promise` object otherwise
+   */
+  Constr.prototype.unfollowArtists = function(artistIds, callback) {
+    var requestData = {
+      url: _baseUri + '/me/following/',
+      type: 'DELETE',
+      params: {
+        ids: artistIds.join(','),
+        type: 'artist'
+      }
+    };
+    return _checkParamsAndPerformRequest(requestData, callback);
+  };
+
+  /**
+   * Checks to see if the current user is following one or more other Spotify users.
+   * See [Check if Current User Follows](https://developer.spotify.com/web-api/check-current-user-follows/) on
+   * the Spotify Developer site for more information about the endpoint.
+   * @param {function(Object, Object)} callback An optional callback that receives 2 parameters. The first
+   * one is the error object (null if no error), and the second is the value if the request succeeded.
+   * @return {Object} Null if a callback is provided, a `Promise` object otherwise
+   */
+  Constr.prototype.isFollowingUsers = function(userIds, callback) {
+    var requestData = {
+      url: _baseUri + '/me/following/contains',
+      type: 'GET',
+      params: {
+        ids: userIds.join(','),
+        type: 'user'
+      }
+    };
+    return _checkParamsAndPerformRequest(requestData, callback);
+  };
+
+  /**
+   * Checks to see if the current user is following one or more artists.
+   * See [Check if Current User Follows](https://developer.spotify.com/web-api/check-current-user-follows/) on
+   * the Spotify Developer site for more information about the endpoint.
+   * @param {function(Object, Object)} callback An optional callback that receives 2 parameters. The first
+   * one is the error object (null if no error), and the second is the value if the request succeeded.
+   * @return {Object} Null if a callback is provided, a `Promise` object otherwise
+   */
+  Constr.prototype.isFollowingArtists = function(artistIds, callback) {
+    var requestData = {
+      url: _baseUri + '/me/following/contains',
+      type: 'GET',
+      params: {
+        ids: artistIds.join(','),
+        type: 'artist'
+      }
+    };
+    return _checkParamsAndPerformRequest(requestData, callback);
+  };
+
   /**
    * Fetches information about a specific user.
    * See [Get a User's Profile](https://developer.spotify.com/web-api/get-users-profile/) on

tests/fixtures/follow_is_following_artists.json

@@ -0,0 +1 @@
+[ true ]

tests/fixtures/follow_is_following_users.json

@@ -0,0 +1 @@
+[ true, false ]