files.com 1.0.222 → 1.0.223

package/_VERSION

@@ -1 +1 @@
-1.0.222
+1.0.223

package/docs/models/Bundle.md

@@ -19,9 +19,11 @@
   "skip_company": true,
   "id": 1,
   "created_at": "2000-01-01T01:00:00Z",
+  "dont_separate_submissions_by_folder": true,
   "expires_at": "2000-01-01T01:00:00Z",
   "max_uses": 1,
   "note": "The internal note on the bundle.",
+  "path_template": "{{name}}_{{ip}}",
   "user_id": 1,
   "username": "user",
   "clickwrap_id": 1,
@@ -52,9 +54,11 @@
 * `skip_company` (boolean): BundleRegistrations can be saved without providing company?
 * `id` (int64): Bundle ID
 * `created_at` (date-time): Bundle created at date/time
+* `dont_separate_submissions_by_folder` (boolean): Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
 * `expires_at` (date-time): Bundle expiration date/time
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `note` (string): Bundle internal note
+* `path_template` (string): Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
 * `user_id` (int64): Bundle creator user ID
 * `username` (string): Bundle creator username
 * `clickwrap_id` (int64): ID of the clickwrap to use with this bundle.
@@ -116,11 +120,13 @@ await Bundle.create({
   'paths': ["file.txt"],
   'password': "Password",
   'form_field_set_id': 1,
+  'dont_separate_submissions_by_folder': true,
   'expires_at': "2000-01-01T01:00:00Z",
   'max_uses': 1,
   'description': "The public description of the bundle.",
   'note': "The internal note on the bundle.",
   'code': "abc123",
+  'path_template': "{{name}}_{{ip}}",
   'permissions': "read",
   'preview_only': true,
   'require_registration': true,
@@ -140,11 +146,13 @@ await Bundle.create({
 * `paths` (array(string)): Required - A list of paths to include in this bundle.
 * `password` (string): Password for this bundle.
 * `form_field_set_id` (int64): Id of Form Field Set to use with this bundle
+* `dont_separate_submissions_by_folder` (boolean): Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
 * `expires_at` (string): Bundle expiration date/time
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `description` (string): Public description
 * `note` (string): Bundle internal note
 * `code` (string): Bundle code.  This code forms the end part of the Public URL.
+* `path_template` (string): Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
 * `permissions` (string): Permissions that apply to Folders in this Share Link.
 * `preview_only` (boolean): Restrict users to previewing files only?
 * `require_registration` (boolean): Show a registration page that captures the downloader's name and email address?
@@ -192,10 +200,12 @@ await bundle.update({
   'clickwrap_id': 1,
   'code': "abc123",
   'description': "The public description of the bundle.",
+  'dont_separate_submissions_by_folder': true,
   'expires_at': "2000-01-01T01:00:00Z",
   'inbox_id': 1,
   'max_uses': 1,
   'note': "The internal note on the bundle.",
+  'path_template': "{{name}}_{{ip}}",
   'permissions': "read",
   'preview_only': true,
   'require_registration': true,
@@ -216,10 +226,12 @@ await bundle.update({
 * `clickwrap_id` (int64): ID of the clickwrap to use with this bundle.
 * `code` (string): Bundle code.  This code forms the end part of the Public URL.
 * `description` (string): Public description
+* `dont_separate_submissions_by_folder` (boolean): Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
 * `expires_at` (string): Bundle expiration date/time
 * `inbox_id` (int64): ID of the associated inbox, if available.
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `note` (string): Bundle internal note
+* `path_template` (string): Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
 * `permissions` (string): Permissions that apply to Folders in this Share Link.
 * `preview_only` (boolean): Restrict users to previewing files only?
 * `require_registration` (boolean): Show a registration page that captures the downloader's name and email address?
@@ -249,9 +261,11 @@ await bundle.update({
   "skip_company": true,
   "id": 1,
   "created_at": "2000-01-01T01:00:00Z",
+  "dont_separate_submissions_by_folder": true,
   "expires_at": "2000-01-01T01:00:00Z",
   "max_uses": 1,
   "note": "The internal note on the bundle.",
+  "path_template": "{{name}}_{{ip}}",
   "user_id": 1,
   "username": "user",
   "clickwrap_id": 1,

package/lib/models/Bundle.js

@@ -117,6 +117,12 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
   (0, _defineProperty2.default)(this, "getCreatedAt", function () {
     return _this.attributes.created_at;
   });
+  (0, _defineProperty2.default)(this, "getDontSeparateSubmissionsByFolder", function () {
+    return _this.attributes.dont_separate_submissions_by_folder;
+  });
+  (0, _defineProperty2.default)(this, "setDontSeparateSubmissionsByFolder", function (value) {
+    _this.attributes.dont_separate_submissions_by_folder = value;
+  });
   (0, _defineProperty2.default)(this, "getExpiresAt", function () {
     return _this.attributes.expires_at;
   });
@@ -135,6 +141,12 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
   (0, _defineProperty2.default)(this, "setNote", function (value) {
     _this.attributes.note = value;
   });
+  (0, _defineProperty2.default)(this, "getPathTemplate", function () {
+    return _this.attributes.path_template;
+  });
+  (0, _defineProperty2.default)(this, "setPathTemplate", function (value) {
+    _this.attributes.path_template = value;
+  });
   (0, _defineProperty2.default)(this, "getUserId", function () {
     return _this.attributes.user_id;
   });
@@ -367,32 +379,38 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
             }
             throw new errors.InvalidParameterError("Bad parameter: note must be of type String, received ".concat((0, _utils.getType)(note)));
           case 28:
-            if (!(params['permissions'] && !(0, _utils.isString)(params['permissions']))) {
+            if (!(params['path_template'] && !(0, _utils.isString)(params['path_template']))) {
               _context2.next = 30;
               break;
             }
-            throw new errors.InvalidParameterError("Bad parameter: permissions must be of type String, received ".concat((0, _utils.getType)(permissions)));
+            throw new errors.InvalidParameterError("Bad parameter: path_template must be of type String, received ".concat((0, _utils.getType)(path_template)));
           case 30:
+            if (!(params['permissions'] && !(0, _utils.isString)(params['permissions']))) {
+              _context2.next = 32;
+              break;
+            }
+            throw new errors.InvalidParameterError("Bad parameter: permissions must be of type String, received ".concat((0, _utils.getType)(permissions)));
+          case 32:
             if (params['id']) {
-              _context2.next = 36;
+              _context2.next = 38;
               break;
             }
             if (!_this.attributes.id) {
-              _context2.next = 35;
+              _context2.next = 37;
               break;
             }
             params['id'] = _this.id;
-            _context2.next = 36;
+            _context2.next = 38;
             break;
-          case 35:
+          case 37:
             throw new errors.MissingParameterError('Parameter missing: id');
-          case 36:
-            _context2.next = 38;
-            return _Api.default.sendRequest("/bundles/".concat(encodeURIComponent(params['id'])), 'PATCH', params, _this.options);
           case 38:
+            _context2.next = 40;
+            return _Api.default.sendRequest("/bundles/".concat(encodeURIComponent(params['id'])), 'PATCH', params, _this.options);
+          case 40:
             response = _context2.sent;
             return _context2.abrupt("return", new Bundle(response === null || response === void 0 ? void 0 : response.data, _this.options));
-          case 40:
+          case 42:
           case "end":
             return _context2.stop();
         }
@@ -651,30 +669,36 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
           }
           throw new errors.InvalidParameterError("Bad parameter: code must be of type String, received ".concat((0, _utils.getType)(params['code'])));
         case 22:
-          if (!(params['permissions'] && !(0, _utils.isString)(params['permissions']))) {
+          if (!(params['path_template'] && !(0, _utils.isString)(params['path_template']))) {
             _context6.next = 24;
             break;
           }
-          throw new errors.InvalidParameterError("Bad parameter: permissions must be of type String, received ".concat((0, _utils.getType)(params['permissions'])));
+          throw new errors.InvalidParameterError("Bad parameter: path_template must be of type String, received ".concat((0, _utils.getType)(params['path_template'])));
         case 24:
-          if (!(params['clickwrap_id'] && !(0, _utils.isInt)(params['clickwrap_id']))) {
+          if (!(params['permissions'] && !(0, _utils.isString)(params['permissions']))) {
             _context6.next = 26;
             break;
           }
-          throw new errors.InvalidParameterError("Bad parameter: clickwrap_id must be of type Int, received ".concat((0, _utils.getType)(params['clickwrap_id'])));
+          throw new errors.InvalidParameterError("Bad parameter: permissions must be of type String, received ".concat((0, _utils.getType)(params['permissions'])));
         case 26:
-          if (!(params['inbox_id'] && !(0, _utils.isInt)(params['inbox_id']))) {
+          if (!(params['clickwrap_id'] && !(0, _utils.isInt)(params['clickwrap_id']))) {
             _context6.next = 28;
             break;
           }
-          throw new errors.InvalidParameterError("Bad parameter: inbox_id must be of type Int, received ".concat((0, _utils.getType)(params['inbox_id'])));
+          throw new errors.InvalidParameterError("Bad parameter: clickwrap_id must be of type Int, received ".concat((0, _utils.getType)(params['clickwrap_id'])));
         case 28:
-          _context6.next = 30;
-          return _Api.default.sendRequest("/bundles", 'POST', params, options);
+          if (!(params['inbox_id'] && !(0, _utils.isInt)(params['inbox_id']))) {
+            _context6.next = 30;
+            break;
+          }
+          throw new errors.InvalidParameterError("Bad parameter: inbox_id must be of type Int, received ".concat((0, _utils.getType)(params['inbox_id'])));
         case 30:
+          _context6.next = 32;
+          return _Api.default.sendRequest("/bundles", 'POST', params, options);
+        case 32:
           response = _context6.sent;
           return _context6.abrupt("return", new Bundle(response === null || response === void 0 ? void 0 : response.data, options));
-        case 32:
+        case 34:
         case "end":
           return _context6.stop();
       }

package/package.json

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

package/src/models/Bundle.js

@@ -124,6 +124,13 @@ class Bundle {
   // date-time # Bundle created at date/time
   getCreatedAt = () => this.attributes.created_at
 
+  // boolean # Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
+  getDontSeparateSubmissionsByFolder = () => this.attributes.dont_separate_submissions_by_folder
+
+  setDontSeparateSubmissionsByFolder = value => {
+    this.attributes.dont_separate_submissions_by_folder = value
+  }
+
   // date-time # Bundle expiration date/time
   getExpiresAt = () => this.attributes.expires_at
 
@@ -145,6 +152,13 @@ class Bundle {
     this.attributes.note = value
   }
 
+  // string # Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
+  getPathTemplate = () => this.attributes.path_template
+
+  setPathTemplate = value => {
+    this.attributes.path_template = value
+  }
+
   // int64 # Bundle creator user ID
   getUserId = () => this.attributes.user_id
 
@@ -279,10 +293,12 @@ class Bundle {
   //   clickwrap_id - int64 - ID of the clickwrap to use with this bundle.
   //   code - string - Bundle code.  This code forms the end part of the Public URL.
   //   description - string - Public description
+  //   dont_separate_submissions_by_folder - boolean - Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
   //   expires_at - string - Bundle expiration date/time
   //   inbox_id - int64 - ID of the associated inbox, if available.
   //   max_uses - int64 - Maximum number of times bundle can be accessed
   //   note - string - Bundle internal note
+  //   path_template - string - Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
   //   permissions - string - Permissions that apply to Folders in this Share Link.
   //   preview_only - boolean - Restrict users to previewing files only?
   //   require_registration - boolean - Show a registration page that captures the downloader's name and email address?
@@ -335,6 +351,9 @@ class Bundle {
     if (params['note'] && !isString(params['note'])) {
       throw new errors.InvalidParameterError(`Bad parameter: note must be of type String, received ${getType(note)}`)
     }
+    if (params['path_template'] && !isString(params['path_template'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: path_template must be of type String, received ${getType(path_template)}`)
+    }
     if (params['permissions'] && !isString(params['permissions'])) {
       throw new errors.InvalidParameterError(`Bad parameter: permissions must be of type String, received ${getType(permissions)}`)
     }
@@ -454,11 +473,13 @@ class Bundle {
   //   paths (required) - array(string) - A list of paths to include in this bundle.
   //   password - string - Password for this bundle.
   //   form_field_set_id - int64 - Id of Form Field Set to use with this bundle
+  //   dont_separate_submissions_by_folder - boolean - Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
   //   expires_at - string - Bundle expiration date/time
   //   max_uses - int64 - Maximum number of times bundle can be accessed
   //   description - string - Public description
   //   note - string - Bundle internal note
   //   code - string - Bundle code.  This code forms the end part of the Public URL.
+  //   path_template - string - Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
   //   permissions - string - Permissions that apply to Folders in this Share Link.
   //   preview_only - boolean - Restrict users to previewing files only?
   //   require_registration - boolean - Show a registration page that captures the downloader's name and email address?
@@ -510,6 +531,10 @@ class Bundle {
       throw new errors.InvalidParameterError(`Bad parameter: code must be of type String, received ${getType(params['code'])}`)
     }
 
+    if (params['path_template'] && !isString(params['path_template'])) {
+      throw new errors.InvalidParameterError(`Bad parameter: path_template must be of type String, received ${getType(params['path_template'])}`)
+    }
+
     if (params['permissions'] && !isString(params['permissions'])) {
       throw new errors.InvalidParameterError(`Bad parameter: permissions must be of type String, received ${getType(params['permissions'])}`)
     }