files.com 1.0.288 → 1.0.290

package/_VERSION

@@ -1 +1 @@
-1.0.288
+1.0.290

package/docs/models/ShareGroup.md

@@ -0,0 +1,132 @@
+# ShareGroup
+
+## Example ShareGroup Object
+
+```
+{
+  "id": 1,
+  "name": "Test group 1",
+  "notes": "This group is defined for testing purposes",
+  "user_id": 1,
+  "share_group_members": [
+    {
+      "name": "John Doe",
+      "company": "Acme Ltd",
+      "email": "johndoe@gmail.com"
+    }
+  ]
+}
+```
+
+* `id` (int64): Share Group ID
+* `name` (string): Name of the share group
+* `notes` (string): Additional notes of the share group
+* `user_id` (int64): Owner User ID
+* `share_group_members` (array): A list of share group members
+* `members` (array(object)): A list of share group members.
+
+---
+
+## List Share Groups
+
+```
+await ShareGroup.list({
+  'user_id': 1,
+  'per_page': 1,
+})
+```
+
+
+### Parameters
+
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+* `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
+* `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+
+---
+
+## Show Share Group
+
+```
+await ShareGroup.find(id)
+```
+
+
+### Parameters
+
+* `id` (int64): Required - Share Group ID.
+
+---
+
+## Create Share Group
+
+```
+await ShareGroup.create({
+  'user_id': 1,
+  'notes': "This group is defined for testing purposes",
+  'name': "Test group 1",
+  'members': [{"name":"John Doe","company":"Acme Ltd","email":"johndoe@gmail.com"}],
+})
+```
+
+
+### Parameters
+
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+* `notes` (string): Additional notes of the share group
+* `name` (string): Required - Name of the share group
+* `members` (array(object)): Required - A list of share group members.
+
+---
+
+## Update Share Group
+
+```
+const [share_group] = await ShareGroup.list()
+
+await share_group.update({
+  'notes': "This group is defined for testing purposes",
+  'name': "Test group 1",
+  'members': [{"name":"John Doe","company":"Acme Ltd","email":"johndoe@gmail.com"}],
+})
+```
+
+### Parameters
+
+* `id` (int64): Required - Share Group ID.
+* `notes` (string): Additional notes of the share group
+* `name` (string): Name of the share group
+* `members` (array(object)): A list of share group members.
+
+### Example Response
+
+```json
+{
+  "id": 1,
+  "name": "Test group 1",
+  "notes": "This group is defined for testing purposes",
+  "user_id": 1,
+  "share_group_members": [
+    {
+      "name": "John Doe",
+      "company": "Acme Ltd",
+      "email": "johndoe@gmail.com"
+    }
+  ]
+}
+```
+
+---
+
+## Delete Share Group
+
+```
+const [share_group] = await ShareGroup.list()
+
+await share_group.delete()
+```
+
+### Parameters
+
+* `id` (int64): Required - Share Group ID.
+

package/docs/models/ShareGroupMember.md

@@ -0,0 +1,15 @@
+# ShareGroupMember
+
+## Example ShareGroupMember Object
+
+```
+{
+  "name": "John Doe",
+  "company": "Acme Ltd",
+  "email": "johndoe@gmail.com"
+}
+```
+
+* `name` (string): Name of the share group member
+* `company` (string): Company of the share group member
+* `email` (string): Email of the share group member

package/lib/models/File.js

@@ -902,6 +902,9 @@ var File = /*#__PURE__*/(0, _createClass2.default)(function File() {
     return _ref16.apply(this, arguments);
   };
 }());
+(0, _defineProperty2.default)(File, "_determinePartUploadUri", function (fileUploadPart) {
+  return fileUploadPart.upload_uri;
+});
 /**
  * @note see File.copy() for list of supported params
  */
@@ -933,7 +936,7 @@ var File = /*#__PURE__*/(0, _createClass2.default)(function File() {
             });
             readableStream.on('data', /*#__PURE__*/function () {
               var _ref18 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee15(chunk) {
-                var nextLength, excessLength, chunkBuffer, tailLength, lastChunkForPart, firstChunkForNextPart, buffer, nextFileUploadPart, uploadPromise;
+                var nextLength, excessLength, chunkBuffer, tailLength, lastChunkForPart, firstChunkForNextPart, buffer, nextFileUploadPart, upload_uri, uploadPromise;
                 return _regenerator.default.wrap(function _callee15$(_context15) {
                   while (1) switch (_context15.prev = _context15.next) {
                     case 0:
@@ -942,7 +945,7 @@ var File = /*#__PURE__*/(0, _createClass2.default)(function File() {
                       excessLength = nextLength - firstFileUploadPart.partsize;
                       chunkBuffer = _safeBuffer.Buffer.from(chunk);
                       if (!(excessLength > 0)) {
-                        _context15.next = 26;
+                        _context15.next = 27;
                         break;
                       }
                       readableStream.pause();
@@ -957,51 +960,52 @@ var File = /*#__PURE__*/(0, _createClass2.default)(function File() {
                       return File._continueUpload(destinationPath, ++part, firstFileUploadPart, options);
                     case 13:
                       nextFileUploadPart = _context15.sent;
-                      uploadPromise = _Api.default.sendFilePart(nextFileUploadPart.upload_uri, 'PUT', buffer);
+                      upload_uri = File._determinePartUploadUri(nextFileUploadPart);
+                      uploadPromise = _Api.default.sendFilePart(upload_uri, 'PUT', buffer);
                       if (!firstFileUploadPart.parallel_parts) {
-                        _context15.next = 19;
+                        _context15.next = 20;
                         break;
                       }
                       concurrentUploads.push(uploadPromise);
-                      _context15.next = 21;
+                      _context15.next = 22;
                       break;
-                    case 19:
-                      _context15.next = 21;
+                    case 20:
+                      _context15.next = 22;
                       return uploadPromise;
-                    case 21:
+                    case 22:
                       chunks = [firstChunkForNextPart];
                       length = firstChunkForNextPart.length;
                       readableStream.resume();
-                      _context15.next = 28;
+                      _context15.next = 29;
                       break;
-                    case 26:
+                    case 27:
                       chunks.push(chunkBuffer);
                       length += chunk.length;
-                    case 28:
-                      _context15.next = 33;
+                    case 29:
+                      _context15.next = 34;
                       break;
-                    case 30:
-                      _context15.prev = 30;
+                    case 31:
+                      _context15.prev = 31;
                       _context15.t0 = _context15["catch"](0);
                       reject(_context15.t0);
-                    case 33:
+                    case 34:
                     case "end":
                       return _context15.stop();
                   }
-                }, _callee15, null, [[0, 30]]);
+                }, _callee15, null, [[0, 31]]);
               }));
               return function (_x20) {
                 return _ref18.apply(this, arguments);
               };
             }());
             readableStream.on('end', /*#__PURE__*/(0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee16() {
-              var buffer, nextFileUploadPart, response, createdFile;
+              var buffer, nextFileUploadPart, upload_uri, response, createdFile;
               return _regenerator.default.wrap(function _callee16$(_context16) {
                 while (1) switch (_context16.prev = _context16.next) {
                   case 0:
                     _context16.prev = 0;
                     if (!(chunks.length > 0)) {
-                      _context16.next = 7;
+                      _context16.next = 8;
                       break;
                     }
                     buffer = _safeBuffer.Buffer.concat(chunks);
@@ -1009,28 +1013,29 @@ var File = /*#__PURE__*/(0, _createClass2.default)(function File() {
                     return File._continueUpload(destinationPath, ++part, firstFileUploadPart, options);
                   case 5:
                     nextFileUploadPart = _context16.sent;
-                    concurrentUploads.push(_Api.default.sendFilePart(nextFileUploadPart.upload_uri, 'PUT', buffer));
-                  case 7:
-                    _context16.next = 9;
+                    upload_uri = File._determinePartUploadUri(nextFileUploadPart);
+                    concurrentUploads.push(_Api.default.sendFilePart(upload_uri, 'PUT', buffer));
+                  case 8:
+                    _context16.next = 10;
                     return Promise.all(concurrentUploads);
-                  case 9:
-                    _context16.next = 11;
+                  case 10:
+                    _context16.next = 12;
                     return File._completeUpload(firstFileUploadPart, options);
-                  case 11:
+                  case 12:
                     response = _context16.sent;
                     createdFile = new File(response.data, options);
                     resolve(createdFile);
-                    _context16.next = 19;
+                    _context16.next = 20;
                     break;
-                  case 16:
-                    _context16.prev = 16;
+                  case 17:
+                    _context16.prev = 17;
                     _context16.t0 = _context16["catch"](0);
                     reject(_context16.t0);
-                  case 19:
+                  case 20:
                   case "end":
                     return _context16.stop();
                 }
-              }, _callee16, null, [[0, 16]]);
+              }, _callee16, null, [[0, 17]]);
             })));
           });
         case 8:

package/lib/models/ShareGroup.js

@@ -0,0 +1,394 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+exports.__esModule = true;
+exports.default = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _Api = _interopRequireDefault(require("../Api"));
+var errors = _interopRequireWildcard(require("../Errors"));
+var _Logger = _interopRequireDefault(require("../Logger"));
+var _utils = require("../utils");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+/**
+ * Class ShareGroup
+ */
+var ShareGroup = /*#__PURE__*/(0, _createClass2.default)(function ShareGroup() {
+  var _this = this;
+  var attributes = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  (0, _classCallCheck2.default)(this, ShareGroup);
+  (0, _defineProperty2.default)(this, "attributes", {});
+  (0, _defineProperty2.default)(this, "options", {});
+  (0, _defineProperty2.default)(this, "isLoaded", function () {
+    return !!_this.attributes.id;
+  });
+  // int64 # Share Group ID
+  (0, _defineProperty2.default)(this, "getId", function () {
+    return _this.attributes.id;
+  });
+  (0, _defineProperty2.default)(this, "setId", function (value) {
+    _this.attributes.id = value;
+  });
+  // string # Name of the share group
+  (0, _defineProperty2.default)(this, "getName", function () {
+    return _this.attributes.name;
+  });
+  (0, _defineProperty2.default)(this, "setName", function (value) {
+    _this.attributes.name = value;
+  });
+  // string # Additional notes of the share group
+  (0, _defineProperty2.default)(this, "getNotes", function () {
+    return _this.attributes.notes;
+  });
+  (0, _defineProperty2.default)(this, "setNotes", function (value) {
+    _this.attributes.notes = value;
+  });
+  // int64 # Owner User ID
+  (0, _defineProperty2.default)(this, "getUserId", function () {
+    return _this.attributes.user_id;
+  });
+  (0, _defineProperty2.default)(this, "setUserId", function (value) {
+    _this.attributes.user_id = value;
+  });
+  // array # A list of share group members
+  (0, _defineProperty2.default)(this, "getShareGroupMembers", function () {
+    return _this.attributes.share_group_members;
+  });
+  (0, _defineProperty2.default)(this, "setShareGroupMembers", function (value) {
+    _this.attributes.share_group_members = value;
+  });
+  // array(object) # A list of share group members.
+  (0, _defineProperty2.default)(this, "getMembers", function () {
+    return _this.attributes.members;
+  });
+  (0, _defineProperty2.default)(this, "setMembers", function (value) {
+    _this.attributes.members = value;
+  });
+  // Parameters:
+  //   notes - string - Additional notes of the share group
+  //   name - string - Name of the share group
+  //   members - array(object) - A list of share group members.
+  (0, _defineProperty2.default)(this, "update", /*#__PURE__*/(0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee() {
+    var params,
+      response,
+      _args = arguments;
+    return _regenerator.default.wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          params = _args.length > 0 && _args[0] !== undefined ? _args[0] : {};
+          if (_this.attributes.id) {
+            _context.next = 3;
+            break;
+          }
+          throw new errors.EmptyPropertyError('Current object has no id');
+        case 3:
+          if ((0, _utils.isObject)(params)) {
+            _context.next = 5;
+            break;
+          }
+          throw new errors.InvalidParameterError("Bad parameter: params must be of type object, received ".concat((0, _utils.getType)(params)));
+        case 5:
+          params.id = _this.attributes.id;
+          if (!(params['id'] && !(0, _utils.isInt)(params['id']))) {
+            _context.next = 8;
+            break;
+          }
+          throw new errors.InvalidParameterError("Bad parameter: id must be of type Int, received ".concat((0, _utils.getType)(id)));
+        case 8:
+          if (!(params['notes'] && !(0, _utils.isString)(params['notes']))) {
+            _context.next = 10;
+            break;
+          }
+          throw new errors.InvalidParameterError("Bad parameter: notes must be of type String, received ".concat((0, _utils.getType)(notes)));
+        case 10:
+          if (!(params['name'] && !(0, _utils.isString)(params['name']))) {
+            _context.next = 12;
+            break;
+          }
+          throw new errors.InvalidParameterError("Bad parameter: name must be of type String, received ".concat((0, _utils.getType)(name)));
+        case 12:
+          if (!(params['members'] && !(0, _utils.isArray)(params['members']))) {
+            _context.next = 14;
+            break;
+          }
+          throw new errors.InvalidParameterError("Bad parameter: members must be of type Array, received ".concat((0, _utils.getType)(members)));
+        case 14:
+          if (params['id']) {
+            _context.next = 20;
+            break;
+          }
+          if (!_this.attributes.id) {
+            _context.next = 19;
+            break;
+          }
+          params['id'] = _this.id;
+          _context.next = 20;
+          break;
+        case 19:
+          throw new errors.MissingParameterError('Parameter missing: id');
+        case 20:
+          _context.next = 22;
+          return _Api.default.sendRequest("/share_groups/".concat(encodeURIComponent(params['id'])), 'PATCH', params, _this.options);
+        case 22:
+          response = _context.sent;
+          return _context.abrupt("return", new ShareGroup(response === null || response === void 0 ? void 0 : response.data, _this.options));
+        case 24:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  })));
+  (0, _defineProperty2.default)(this, "delete", /*#__PURE__*/(0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2() {
+    var params,
+      response,
+      _args2 = arguments;
+    return _regenerator.default.wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          params = _args2.length > 0 && _args2[0] !== undefined ? _args2[0] : {};
+          if (_this.attributes.id) {
+            _context2.next = 3;
+            break;
+          }
+          throw new errors.EmptyPropertyError('Current object has no id');
+        case 3:
+          if ((0, _utils.isObject)(params)) {
+            _context2.next = 5;
+            break;
+          }
+          throw new errors.InvalidParameterError("Bad parameter: params must be of type object, received ".concat((0, _utils.getType)(params)));
+        case 5:
+          params.id = _this.attributes.id;
+          if (!(params['id'] && !(0, _utils.isInt)(params['id']))) {
+            _context2.next = 8;
+            break;
+          }
+          throw new errors.InvalidParameterError("Bad parameter: id must be of type Int, received ".concat((0, _utils.getType)(id)));
+        case 8:
+          if (params['id']) {
+            _context2.next = 14;
+            break;
+          }
+          if (!_this.attributes.id) {
+            _context2.next = 13;
+            break;
+          }
+          params['id'] = _this.id;
+          _context2.next = 14;
+          break;
+        case 13:
+          throw new errors.MissingParameterError('Parameter missing: id');
+        case 14:
+          _context2.next = 16;
+          return _Api.default.sendRequest("/share_groups/".concat(encodeURIComponent(params['id'])), 'DELETE', params, _this.options);
+        case 16:
+          response = _context2.sent;
+          return _context2.abrupt("return", response === null || response === void 0 ? void 0 : response.data);
+        case 18:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  })));
+  (0, _defineProperty2.default)(this, "destroy", function () {
+    var params = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+    return _this.delete(params);
+  });
+  (0, _defineProperty2.default)(this, "save", function () {
+    if (_this.attributes['id']) {
+      return _this.update(_this.attributes);
+    } else {
+      var newObject = ShareGroup.create(_this.attributes, _this.options);
+      _this.attributes = _objectSpread({}, newObject.attributes);
+      return true;
+    }
+  });
+  Object.entries(attributes).forEach(function (_ref3) {
+    var _ref4 = (0, _slicedToArray2.default)(_ref3, 2),
+      key = _ref4[0],
+      value = _ref4[1];
+    var normalizedKey = key.replace('?', '');
+    _this.attributes[normalizedKey] = value;
+    Object.defineProperty(_this, normalizedKey, {
+      value: value,
+      writable: false
+    });
+  });
+  this.options = _objectSpread({}, options);
+});
+// Parameters:
+//   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
+//   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
+//   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+(0, _defineProperty2.default)(ShareGroup, "list", /*#__PURE__*/(0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee3() {
+  var _response$data;
+  var params,
+    options,
+    response,
+    _args3 = arguments;
+  return _regenerator.default.wrap(function _callee3$(_context3) {
+    while (1) switch (_context3.prev = _context3.next) {
+      case 0:
+        params = _args3.length > 0 && _args3[0] !== undefined ? _args3[0] : {};
+        options = _args3.length > 1 && _args3[1] !== undefined ? _args3[1] : {};
+        if (!(params['user_id'] && !(0, _utils.isInt)(params['user_id']))) {
+          _context3.next = 4;
+          break;
+        }
+        throw new errors.InvalidParameterError("Bad parameter: user_id must be of type Int, received ".concat((0, _utils.getType)(params['user_id'])));
+      case 4:
+        if (!(params['cursor'] && !(0, _utils.isString)(params['cursor']))) {
+          _context3.next = 6;
+          break;
+        }
+        throw new errors.InvalidParameterError("Bad parameter: cursor must be of type String, received ".concat((0, _utils.getType)(params['cursor'])));
+      case 6:
+        if (!(params['per_page'] && !(0, _utils.isInt)(params['per_page']))) {
+          _context3.next = 8;
+          break;
+        }
+        throw new errors.InvalidParameterError("Bad parameter: per_page must be of type Int, received ".concat((0, _utils.getType)(params['per_page'])));
+      case 8:
+        _context3.next = 10;
+        return _Api.default.sendRequest("/share_groups", 'GET', params, options);
+      case 10:
+        response = _context3.sent;
+        return _context3.abrupt("return", (response === null || response === void 0 ? void 0 : (_response$data = response.data) === null || _response$data === void 0 ? void 0 : _response$data.map(function (obj) {
+          return new ShareGroup(obj, options);
+        })) || []);
+      case 12:
+      case "end":
+        return _context3.stop();
+    }
+  }, _callee3);
+})));
+(0, _defineProperty2.default)(ShareGroup, "all", function () {
+  var params = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  return ShareGroup.list(params, options);
+});
+// Parameters:
+//   id (required) - int64 - Share Group ID.
+(0, _defineProperty2.default)(ShareGroup, "find", /*#__PURE__*/function () {
+  var _ref6 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee4(id) {
+    var params,
+      options,
+      response,
+      _args4 = arguments;
+    return _regenerator.default.wrap(function _callee4$(_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
+        case 0:
+          params = _args4.length > 1 && _args4[1] !== undefined ? _args4[1] : {};
+          options = _args4.length > 2 && _args4[2] !== undefined ? _args4[2] : {};
+          if ((0, _utils.isObject)(params)) {
+            _context4.next = 4;
+            break;
+          }
+          throw new errors.InvalidParameterError("Bad parameter: params must be of type object, received ".concat((0, _utils.getType)(params)));
+        case 4:
+          params['id'] = id;
+          if (params['id']) {
+            _context4.next = 7;
+            break;
+          }
+          throw new errors.MissingParameterError('Parameter missing: id');
+        case 7:
+          if (!(params['id'] && !(0, _utils.isInt)(params['id']))) {
+            _context4.next = 9;
+            break;
+          }
+          throw new errors.InvalidParameterError("Bad parameter: id must be of type Int, received ".concat((0, _utils.getType)(params['id'])));
+        case 9:
+          _context4.next = 11;
+          return _Api.default.sendRequest("/share_groups/".concat(encodeURIComponent(params['id'])), 'GET', params, options);
+        case 11:
+          response = _context4.sent;
+          return _context4.abrupt("return", new ShareGroup(response === null || response === void 0 ? void 0 : response.data, options));
+        case 13:
+        case "end":
+          return _context4.stop();
+      }
+    }, _callee4);
+  }));
+  return function (_x) {
+    return _ref6.apply(this, arguments);
+  };
+}());
+(0, _defineProperty2.default)(ShareGroup, "get", function (id) {
+  var params = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  return ShareGroup.find(id, params, options);
+});
+// Parameters:
+//   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
+//   notes - string - Additional notes of the share group
+//   name (required) - string - Name of the share group
+//   members (required) - array(object) - A list of share group members.
+(0, _defineProperty2.default)(ShareGroup, "create", /*#__PURE__*/(0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee5() {
+  var params,
+    options,
+    response,
+    _args5 = arguments;
+  return _regenerator.default.wrap(function _callee5$(_context5) {
+    while (1) switch (_context5.prev = _context5.next) {
+      case 0:
+        params = _args5.length > 0 && _args5[0] !== undefined ? _args5[0] : {};
+        options = _args5.length > 1 && _args5[1] !== undefined ? _args5[1] : {};
+        if (params['name']) {
+          _context5.next = 4;
+          break;
+        }
+        throw new errors.MissingParameterError('Parameter missing: name');
+      case 4:
+        if (params['members']) {
+          _context5.next = 6;
+          break;
+        }
+        throw new errors.MissingParameterError('Parameter missing: members');
+      case 6:
+        if (!(params['user_id'] && !(0, _utils.isInt)(params['user_id']))) {
+          _context5.next = 8;
+          break;
+        }
+        throw new errors.InvalidParameterError("Bad parameter: user_id must be of type Int, received ".concat((0, _utils.getType)(params['user_id'])));
+      case 8:
+        if (!(params['notes'] && !(0, _utils.isString)(params['notes']))) {
+          _context5.next = 10;
+          break;
+        }
+        throw new errors.InvalidParameterError("Bad parameter: notes must be of type String, received ".concat((0, _utils.getType)(params['notes'])));
+      case 10:
+        if (!(params['name'] && !(0, _utils.isString)(params['name']))) {
+          _context5.next = 12;
+          break;
+        }
+        throw new errors.InvalidParameterError("Bad parameter: name must be of type String, received ".concat((0, _utils.getType)(params['name'])));
+      case 12:
+        if (!(params['members'] && !(0, _utils.isArray)(params['members']))) {
+          _context5.next = 14;
+          break;
+        }
+        throw new errors.InvalidParameterError("Bad parameter: members must be of type Array, received ".concat((0, _utils.getType)(params['members'])));
+      case 14:
+        _context5.next = 16;
+        return _Api.default.sendRequest("/share_groups", 'POST', params, options);
+      case 16:
+        response = _context5.sent;
+        return _context5.abrupt("return", new ShareGroup(response === null || response === void 0 ? void 0 : response.data, options));
+      case 18:
+      case "end":
+        return _context5.stop();
+    }
+  }, _callee5);
+})));
+var _default = ShareGroup;
+exports.default = _default;

package/lib/models/ShareGroupMember.js

@@ -0,0 +1,58 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+exports.__esModule = true;
+exports.default = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _Api = _interopRequireDefault(require("../Api"));
+var errors = _interopRequireWildcard(require("../Errors"));
+var _Logger = _interopRequireDefault(require("../Logger"));
+var _utils = require("../utils");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+/**
+ * Class ShareGroupMember
+ */
+var ShareGroupMember = /*#__PURE__*/(0, _createClass2.default)(function ShareGroupMember() {
+  var _this = this;
+  var attributes = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  (0, _classCallCheck2.default)(this, ShareGroupMember);
+  (0, _defineProperty2.default)(this, "attributes", {});
+  (0, _defineProperty2.default)(this, "options", {});
+  (0, _defineProperty2.default)(this, "isLoaded", function () {
+    return !!_this.attributes.id;
+  });
+  // string # Name of the share group member
+  (0, _defineProperty2.default)(this, "getName", function () {
+    return _this.attributes.name;
+  });
+  // string # Company of the share group member
+  (0, _defineProperty2.default)(this, "getCompany", function () {
+    return _this.attributes.company;
+  });
+  // string # Email of the share group member
+  (0, _defineProperty2.default)(this, "getEmail", function () {
+    return _this.attributes.email;
+  });
+  Object.entries(attributes).forEach(function (_ref) {
+    var _ref2 = (0, _slicedToArray2.default)(_ref, 2),
+      key = _ref2[0],
+      value = _ref2[1];
+    var normalizedKey = key.replace('?', '');
+    _this.attributes[normalizedKey] = value;
+    Object.defineProperty(_this, normalizedKey, {
+      value: value,
+      writable: false
+    });
+  });
+  this.options = _objectSpread({}, options);
+});
+var _default = ShareGroupMember;
+exports.default = _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "files.com",
-  "version": "1.0.288",
+  "version": "1.0.290",
   "description": "Files.com SDK for JavaScript",
   "keywords": [
     "files.com",

package/src/models/File.js

@@ -76,6 +76,10 @@ class File {
     return Api.sendRequest(`/files/${encodeURIComponent(firstFileUploadPart.path)}`, 'POST', params, options)
   }
 
+  static _determinePartUploadUri = fileUploadPart => {
+    return fileUploadPart.upload_uri
+  }
+
   /**
    * @note see File.copy() for list of supported params
    */
@@ -116,7 +120,8 @@ class File {
               const buffer = Buffer.concat(chunks)
               const nextFileUploadPart = await File._continueUpload(destinationPath, ++part, firstFileUploadPart, options)
 
-              const uploadPromise = Api.sendFilePart(nextFileUploadPart.upload_uri, 'PUT', buffer)
+              const upload_uri = File._determinePartUploadUri(nextFileUploadPart)
+              const uploadPromise = Api.sendFilePart(upload_uri, 'PUT', buffer)
 
               if (firstFileUploadPart.parallel_parts) {
                 concurrentUploads.push(uploadPromise)
@@ -143,7 +148,8 @@ class File {
               const buffer = Buffer.concat(chunks)
               const nextFileUploadPart = await File._continueUpload(destinationPath, ++part, firstFileUploadPart, options)
 
-              concurrentUploads.push(Api.sendFilePart(nextFileUploadPart.upload_uri, 'PUT', buffer))
+              const upload_uri = File._determinePartUploadUri(nextFileUploadPart)
+              concurrentUploads.push(Api.sendFilePart(upload_uri, 'PUT', buffer))
             }
 
             await Promise.all(concurrentUploads)

package/src/models/ShareGroup.js

@@ -0,0 +1,235 @@
+import Api from '../Api'
+import * as errors from '../Errors'
+import Logger from '../Logger'
+import { getType, isArray, isBrowser, isInt, isObject, isString } from '../utils'
+
+/**
+ * Class ShareGroup
+ */
+class ShareGroup {
+  attributes = {}
+  options = {}
+
+  constructor(attributes = {}, options = {}) {
+    Object.entries(attributes).forEach(([key, value]) => {
+      const normalizedKey = key.replace('?', '')
+
+      this.attributes[normalizedKey] = value
+
+      Object.defineProperty(this, normalizedKey, { value, writable: false })
+    })
+
+    this.options = { ...options }
+  }
+
+  isLoaded = () => !!this.attributes.id
+  // int64 # Share Group ID
+  getId = () => this.attributes.id
+
+  setId = value => {
+    this.attributes.id = value
+  }
+
+  // string # Name of the share group
+  getName = () => this.attributes.name
+
+  setName = value => {
+    this.attributes.name = value
+  }
+
+  // string # Additional notes of the share group
+  getNotes = () => this.attributes.notes
+
+  setNotes = value => {
+    this.attributes.notes = value
+  }
+
+  // int64 # Owner User ID
+  getUserId = () => this.attributes.user_id
+
+  setUserId = value => {
+    this.attributes.user_id = value
+  }
+
+  // array # A list of share group members
+  getShareGroupMembers = () => this.attributes.share_group_members
+
+  setShareGroupMembers = value => {
+    this.attributes.share_group_members = value
+  }
+
+  // array(object) # A list of share group members.
+  getMembers = () => this.attributes.members
+
+  setMembers = value => {
+    this.attributes.members = value
+  }
+
+
+  // Parameters:
+  //   notes - string - Additional notes of the share group
+  //   name - string - Name of the share group
+  //   members - array(object) - A list of share group members.
+  update = async (params = {}) => {
+    if (!this.attributes.id) {
+      throw new errors.EmptyPropertyError('Current object has no id')
+    }
+
+    if (!isObject(params)) {
+      throw new errors.InvalidParameterError(`Bad parameter: params must be of type object, received ${getType(params)}`)
+    }
+
+    params.id = this.attributes.id
+    if (params['id'] && !isInt(params['id'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: id must be of type Int, received ${getType(id)}`)
+    }
+    if (params['notes'] && !isString(params['notes'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: notes must be of type String, received ${getType(notes)}`)
+    }
+    if (params['name'] && !isString(params['name'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: name must be of type String, received ${getType(name)}`)
+    }
+    if (params['members'] && !isArray(params['members'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: members must be of type Array, received ${getType(members)}`)
+    }
+
+    if (!params['id']) {
+      if (this.attributes.id) {
+        params['id'] = this.id
+      } else {
+        throw new errors.MissingParameterError('Parameter missing: id')
+      }
+    }
+
+    const response = await Api.sendRequest(`/share_groups/${encodeURIComponent(params['id'])}`, 'PATCH', params, this.options)
+
+    return new ShareGroup(response?.data, this.options)
+  }
+
+  delete = async (params = {}) => {
+    if (!this.attributes.id) {
+      throw new errors.EmptyPropertyError('Current object has no id')
+    }
+
+    if (!isObject(params)) {
+      throw new errors.InvalidParameterError(`Bad parameter: params must be of type object, received ${getType(params)}`)
+    }
+
+    params.id = this.attributes.id
+    if (params['id'] && !isInt(params['id'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: id must be of type Int, received ${getType(id)}`)
+    }
+
+    if (!params['id']) {
+      if (this.attributes.id) {
+        params['id'] = this.id
+      } else {
+        throw new errors.MissingParameterError('Parameter missing: id')
+      }
+    }
+
+    const response = await Api.sendRequest(`/share_groups/${encodeURIComponent(params['id'])}`, 'DELETE', params, this.options)
+
+    return response?.data
+  }
+
+  destroy = (params = {}) =>
+    this.delete(params)
+
+  save = () => {
+      if (this.attributes['id']) {
+        return this.update(this.attributes)
+      } else {
+        const newObject = ShareGroup.create(this.attributes, this.options)
+        this.attributes = { ...newObject.attributes }
+        return true
+      }
+  }
+
+  // Parameters:
+  //   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
+  //   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
+  //   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+  static list = async (params = {}, options = {}) => {
+    if (params['user_id'] && !isInt(params['user_id'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: user_id must be of type Int, received ${getType(params['user_id'])}`)
+    }
+
+    if (params['cursor'] && !isString(params['cursor'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: cursor must be of type String, received ${getType(params['cursor'])}`)
+    }
+
+    if (params['per_page'] && !isInt(params['per_page'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: per_page must be of type Int, received ${getType(params['per_page'])}`)
+    }
+
+    const response = await Api.sendRequest(`/share_groups`, 'GET', params, options)
+
+    return response?.data?.map(obj => new ShareGroup(obj, options)) || []
+  }
+
+  static all = (params = {}, options = {}) =>
+    ShareGroup.list(params, options)
+
+  // Parameters:
+  //   id (required) - int64 - Share Group ID.
+  static find = async (id, params = {}, options = {}) => {
+    if (!isObject(params)) {
+      throw new errors.InvalidParameterError(`Bad parameter: params must be of type object, received ${getType(params)}`)
+    }
+
+    params['id'] = id
+
+    if (!params['id']) {
+      throw new errors.MissingParameterError('Parameter missing: id')
+    }
+
+    if (params['id'] && !isInt(params['id'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: id must be of type Int, received ${getType(params['id'])}`)
+    }
+
+    const response = await Api.sendRequest(`/share_groups/${encodeURIComponent(params['id'])}`, 'GET', params, options)
+
+    return new ShareGroup(response?.data, options)
+  }
+
+  static get = (id, params = {}, options = {}) =>
+    ShareGroup.find(id, params, options)
+
+  // Parameters:
+  //   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
+  //   notes - string - Additional notes of the share group
+  //   name (required) - string - Name of the share group
+  //   members (required) - array(object) - A list of share group members.
+  static create = async (params = {}, options = {}) => {
+    if (!params['name']) {
+      throw new errors.MissingParameterError('Parameter missing: name')
+    }
+
+    if (!params['members']) {
+      throw new errors.MissingParameterError('Parameter missing: members')
+    }
+
+    if (params['user_id'] && !isInt(params['user_id'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: user_id must be of type Int, received ${getType(params['user_id'])}`)
+    }
+
+    if (params['notes'] && !isString(params['notes'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: notes must be of type String, received ${getType(params['notes'])}`)
+    }
+
+    if (params['name'] && !isString(params['name'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: name must be of type String, received ${getType(params['name'])}`)
+    }
+
+    if (params['members'] && !isArray(params['members'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: members must be of type Array, received ${getType(params['members'])}`)
+    }
+
+    const response = await Api.sendRequest(`/share_groups`, 'POST', params, options)
+
+    return new ShareGroup(response?.data, options)
+  }
+}
+
+export default ShareGroup

package/src/models/ShareGroupMember.js

@@ -0,0 +1,37 @@
+import Api from '../Api'
+import * as errors from '../Errors'
+import Logger from '../Logger'
+import { getType, isArray, isBrowser, isInt, isObject, isString } from '../utils'
+
+/**
+ * Class ShareGroupMember
+ */
+class ShareGroupMember {
+  attributes = {}
+  options = {}
+
+  constructor(attributes = {}, options = {}) {
+    Object.entries(attributes).forEach(([key, value]) => {
+      const normalizedKey = key.replace('?', '')
+
+      this.attributes[normalizedKey] = value
+
+      Object.defineProperty(this, normalizedKey, { value, writable: false })
+    })
+
+    this.options = { ...options }
+  }
+
+  isLoaded = () => !!this.attributes.id
+  // string # Name of the share group member
+  getName = () => this.attributes.name
+
+  // string # Company of the share group member
+  getCompany = () => this.attributes.company
+
+  // string # Email of the share group member
+  getEmail = () => this.attributes.email
+
+}
+
+export default ShareGroupMember