feat(adds-assign-user-ids): adds assignUserIDs method and tests (#783)

src/AlgoliaSearch.js

@@ -546,6 +546,31 @@ AlgoliaSearch.prototype.assignUserID = function(data, callback) {
   });
 };
 
+/**
+ * Assign a array of userIDs to a cluster.
+ *
+ * @param {Array} data.userIDs The array of userIDs to assign to a new cluster
+ * @param {string} data.cluster The cluster to assign the user to
+ * @return {Promise|undefined} Returns a promise if no callback given
+ * @example
+ * client.assignUserIDs({ cluster: 'c1-test', userIDs: ['some-user-1', 'some-user-2'] });
+ */
+AlgoliaSearch.prototype.assignUserIDs = function(data, callback) {
+  if (!data.userIDs || !data.cluster) {
+    throw new errors.AlgoliaSearchError('You have to provide both an array of userIDs and cluster', data);
+  }
+  return this._jsonRequest({
+    method: 'POST',
+    url: '/1/clusters/mapping/batch',
+    hostType: 'write',
+    body: {
+      cluster: data.cluster,
+      users: data.userIDs
+    },
+    callback: callback
+  });
+};
+
 /**
  * Get the top userIDs
  *

test/spec/common/client/interface.js

@@ -25,6 +25,7 @@ test('AlgoliaSearch client API spec', function(t) {
     'addUserKey',
     'addUserKeyWithValidity',
     'assignUserID',
+    'assignUserIDs',
     'batch',
     'clearCache',
     'copyIndex',

test/spec/common/client/test-cases/assignUserIDs.js

@@ -0,0 +1,35 @@
+'use strict';
+
+var testCases = [];
+
+if (process.browser) {
+  if (require('faux-jax').support.xhr.cors) {
+    testCases.push({
+      testName: 'client.assignUserIDs({userID, cluster}, cb)',
+      object: 'client',
+      methodName: 'assignUserIDs',
+      callArguments: [{userIDs: ['one', 'two'], cluster: 'the big one'}],
+      action: 'write',
+      expectedRequest: {
+        method: 'POST',
+        body: {cluster: 'the big one', users: ['one', 'two']},
+        URL: {pathname: '/1/clusters/mapping/batch'}
+      }
+    });
+  }
+} else {
+  testCases.push({
+    testName: 'client.assignUserIDs({userID, cluster}, cb)',
+    object: 'client',
+    methodName: 'assignUserIDs',
+    callArguments: [{userIDs: ['one', 'two'], cluster: 'the big one'}],
+    action: 'write',
+    expectedRequest: {
+      method: 'POST',
+      body: {cluster: 'the big one', users: ['one', 'two']},
+      URL: {pathname: '/1/clusters/mapping/batch'}
+    }
+  });
+}
+
+module.exports = testCases;