files.com 1.0.299 → 1.0.300

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 923974c1d23789f6c98fd3fbcab9ee69d52b4f8320725b74cdc3c32cd27d0322
-  data.tar.gz: 01674ce406972fc249056ddf3d8a756d105c791aead79d0246744391d6ed1b4e
+  metadata.gz: d254f2d5da5d785a5be384cc526a1697a3774a8a31df315dfba7dfc689c115b8
+  data.tar.gz: 3303a48addebc1b06e1a0a16a9019254b1dfea5733f74adeeac7c9e53aeed0de
 SHA512:
-  metadata.gz: b5ac4950ca394fb43a32a8c43c3d5bc7d4babdd1396a82e77315a4e1ba3548ec4b0f6dae773b93cd4b81ca89a7f4ed36328eb8682134545b16ff089585a43b5c
-  data.tar.gz: 565be58bf59dbbf0658131fb3dd2435fbae2ef6ce7229f008765d3fdb8b8364f0129a3e095360f9a0c2d3faed7d41c490da69022ba965df5e9f6a70fe2aaf55a
+  metadata.gz: 9e5f9056389ef70a9b40e56f167e1c02959fd182a69ce214191d0920f2a7f5df7917b75e739aafb53a1ffa8464a5956ac1de3aa34792e764493418b5478487f2
+  data.tar.gz: 0b563cf3388670d93ed033108464e2be0f4fbec633c6be0476d6fe9be48243047bb77f543e87d0a6639cbe71aaa4559c5f0aca414b4a27d37512022e4a33c571

data/_VERSION

@@ -1 +1 @@
-1.0.299
+1.0.300

data/docs/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.
@@ -117,11 +121,13 @@ Files::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 @@ Files::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?
@@ -189,10 +197,12 @@ Files::Bundle.update(id,
   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, 
@@ -213,10 +223,12 @@ Files::Bundle.update(id,
 * `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?
@@ -277,10 +289,12 @@ 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,
@@ -301,10 +315,12 @@ 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?

data/lib/files.com/models/bundle.rb

@@ -140,6 +140,15 @@ module Files
       @attributes[:created_at]
     end
 
+    # 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.
+    def dont_separate_submissions_by_folder
+      @attributes[:dont_separate_submissions_by_folder]
+    end
+
+    def dont_separate_submissions_by_folder=(value)
+      @attributes[:dont_separate_submissions_by_folder] = value
+    end
+
     # date-time - Bundle expiration date/time
     def expires_at
       @attributes[:expires_at]
@@ -167,6 +176,15 @@ module Files
       @attributes[:note] = value
     end
 
+    # string - Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
+    def path_template
+      @attributes[:path_template]
+    end
+
+    def path_template=(value)
+      @attributes[:path_template] = value
+    end
+
     # int64 - Bundle creator user ID
     def user_id
       @attributes[:user_id]
@@ -301,10 +319,12 @@ module Files
     #   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?
@@ -329,6 +349,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: inbox_id must be an Integer") if params[:inbox_id] and !params[:inbox_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: max_uses must be an Integer") if params[:max_uses] and !params[:max_uses].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: note must be an String") if params[:note] and !params[:note].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: path_template must be an String") if params[:path_template] and !params[:path_template].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: permissions must be an String") if params[:permissions] and !params[:permissions].is_a?(String)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
@@ -411,11 +432,13 @@ module Files
     #   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?
@@ -436,6 +459,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: description must be an String") if params[:description] and !params[:description].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: note must be an String") if params[:note] and !params[:note].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: code must be an String") if params[:code] and !params[:code].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: path_template must be an String") if params[:path_template] and !params[:path_template].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: permissions must be an String") if params[:permissions] and !params[:permissions].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: clickwrap_id must be an Integer") if params[:clickwrap_id] and !params[:clickwrap_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: inbox_id must be an Integer") if params[:inbox_id] and !params[:inbox_id].is_a?(Integer)
@@ -471,10 +495,12 @@ module Files
     #   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?
@@ -498,6 +524,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: inbox_id must be an Integer") if params[:inbox_id] and !params[:inbox_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: max_uses must be an Integer") if params[:max_uses] and !params[:max_uses].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: note must be an String") if params[:note] and !params[:note].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: path_template must be an String") if params[:path_template] and !params[:path_template].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: permissions must be an String") if params[:permissions] and !params[:permissions].is_a?(String)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.0.299
+  version: 1.0.300
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-06 00:00:00.000000000 Z
+date: 2022-10-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable