box-node-sdk 1.35.0 → 1.36.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.36.0 (2020-01-27)
+
+**New Features and Enhancements:**
+
+- Add folder lock functionality ([#560](https://github.com/box/box-node-sdk/pull/560))
+- Add support for filtering groups by name ([#561](https://github.com/box/box-node-sdk/pull/561))
+
+**Bug Fixes:**
+
+- Update proxy-agent to patch proxy support issue ([#563](https://github.com/box/box-node-sdk/pull/563))
+- Update dependencies to patch security vulnerabilities ([#566](https://github.com/box/box-node-sdk/pull/566))
+
 ## 1.35.0 (2020-11-02)
 
 **New Features and Enhancements:**

package/lib/managers/folders.js

@@ -15,6 +15,7 @@ var urlPath = require('../util/url-path'),
 // Private
 // ------------------------------------------------------------------------------
 var BASE_PATH = '/folders',
+	FOLDER_LOCK = '/folder_locks',
 	WATERMARK_SUBRESOURCE = '/watermark';
 
 
@@ -577,6 +578,68 @@ Folders.prototype.removeWatermark = function(folderID, callback) {
 
 	return this.client.wrapWithDefaultHandler(this.client.del)(apiPath, null, callback);
 };
+
+/**
+ * Used to lock a Box folder.
+ *
+ * API Endpoint: '/folder_locks'
+ * Method: POST
+ *
+ * @param {string} folderID - The Box ID of the folder to lock
+ * @param {Function} [callback] - Passed the folder lock object if successful, error otherwise
+ * @returns {Promise<void>} A promise resolving to a folder lock object
+ */
+Folders.prototype.lock = function(folderID, callback) {
+	var params = {
+		body: {
+			folder: {
+				type: 'folder',
+				id: folderID
+			},
+			locked_operations: {
+				move: true,
+				delete: true
+			}
+		}
+	};
+	return this.client.wrapWithDefaultHandler(this.client.post)(FOLDER_LOCK, params, callback);
+};
+
+/**
+ * Used to get all locks on a folder.
+ *
+ * API Endpoint: '/folder_locks'
+ * Method: GET
+ *
+ * @param {string} folderID - The Box ID of the folder to lock
+ * @param {Function} [callback] - Passed a collection of folder lock objects if successful, error otherwise
+ * @returns {Promise<void>} A promise resolving to a collection of folder lock objects
+ */
+Folders.prototype.getLocks = function(folderID, callback) {
+	var params = {
+		qs: {
+			folder_id: folderID
+		}
+	};
+	return this.client.wrapWithDefaultHandler(this.client.get)(FOLDER_LOCK, params, callback);
+};
+
+/**
+ * Used to delete a lock on a folder.
+ *
+ * API Endpoint: '/folder_locks/:folderLockID'
+ * Method: DELETE
+ *
+ * @param {string} folderLockID - The Box ID of the folder lock
+ * @param {Function} [callback] - Empty response body passed if successful, error otherwise
+ * @returns {Promise<void>} A promise resolving to nothing
+ */
+Folders.prototype.deleteLock = function(folderLockID, callback) {
+
+	var apiPath = urlPath(FOLDER_LOCK, folderLockID);
+
+	return this.client.wrapWithDefaultHandler(this.client.del)(apiPath, null, callback);
+};
 /**
  * @module box-node-sdk/lib/managers/folders
  * @see {@Link Folders}

package/lib/managers/groups.js

@@ -279,6 +279,7 @@ Groups.prototype.getMemberships = function(groupID, options, callback) {
  * Method: GET
  *
  * @param {Object} [options] - Optional parameters, can be left null in most cases
+ * @param {string} [options.filter_term] - Limits the results to only groups whose name starts with the search term
  * @param {int} [options.limit] - The number of memberships to retrieve
  * @param {int} [options.offset] - Paging marker, retrieve records starting at this position in the list
  * @param {Function} [callback] - Passed a list of groups if successful, error otherwise

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "box-node-sdk",
   "author": "Box <oss@box.com>",
-  "version": "1.35.0",
+  "version": "1.36.0",
   "description": "Official SDK for Box Plaform APIs",
   "license": "Apache-2.0",
   "repository": {
@@ -38,14 +38,14 @@
     "jsonwebtoken": "^8.5.1",
     "merge-options": "^1.0.1",
     "promise-queue": "^2.2.3",
-    "proxy-agent": "^3.1.1",
+    "proxy-agent": "^4.0.0",
     "request": "^2.88.0",
     "url-template": "^2.0.8",
     "uuid": "^3.3.3"
   },
   "devDependencies": {
     "chai": "^4.2.0",
-    "coveralls": "^3.0.8",
+    "coveralls": "^3.1.0",
     "eslint": "^4.19.1",
     "eslint-plugin-node": "^6.0.1",
     "eslint-plugin-promise": "^3.8.0",
@@ -54,12 +54,13 @@
     "jsdoc": "^3.6.3",
     "jsonlint2": "^1.7.1",
     "leche": "^2.3.0",
-    "mocha": "^5.2.0",
+    "mocha": "^6.0.0",
     "mockery": "^2.1.0",
     "nock": "^9.6.1",
-    "np": "^5.1.3",
+    "np": "^7.2.0",
+    "npm-force-resolutions": "0.0.3",
     "npm-upgrade": "^2.0.3",
-    "nyc": "^11.9.0",
+    "nyc": "^14.0.0",
     "shelljs": "^0.8.3",
     "shelljs-nodecli": "^0.1.1",
     "sinon": "^7.5.0"
@@ -67,5 +68,9 @@
   "files": [
     "config",
     "lib"
-  ]
+  ],
+  "resolutions": {
+    "handlebars": "4.5.3",
+    "minimist": "1.2.5"
+  }
 }