Deprecate methods related to Batch API (#433)

Author: Matt Willer

lib/box-client.js

@@ -612,16 +612,27 @@ BoxClient.prototype.upload = function(path, params, formData, callback) {
 /**
  * Puts the client into batch mode, which will queue calls instead of
  * immediately making the API request.
+ *
+ * DEPRECATED: Batch API is not supported and should not be used; make calls in parallel instead.
+ *
  * @returns {BoxClient} Current client object
  */
-BoxClient.prototype.batch = function() {
-
+BoxClient.prototype.batch = util.deprecate(function() {
+	/* eslint-disable no-invalid-this */
 	this._batch = [];
 	return this;
-};
-
-BoxClient.prototype.batchExec = function(callback) {
+	/* eslint-enable no-invalid-this */
+}, 'Batch API is not supported and should not be used; make calls in parallel instead.');
 
+/**
+ * Executes a batch of requests.
+ *
+ * DEPRECATED: Batch API is not supported and should not be used; make calls in parallel instead.
+ *
+ * @returns {Promise<Object>} Promise resolving to the collection of batch responses
+ */
+BoxClient.prototype.batchExec = util.deprecate(function(callback) {
+	/* eslint-disable no-invalid-this */
 	if (!this._batch) {
 		return Promise.reject(new Error('Must start a batch before executing'))
 			.asCallback(callback);
@@ -652,7 +663,8 @@ BoxClient.prototype.batchExec = function(callback) {
 			throw err;
 		})
 		.asCallback(callback);
-};
+	/* eslint-enable no-invalid-this */
+}, 'Batch API is not supported and should not be used; make calls in parallel instead.');
 
 /**
  * Build the 'BoxApi' Header used for authenticating access to a shared item