files.com 1.1.332 → 1.1.334

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 984d635563ca89b4137c74426794516fb9177f3276673060cca3f6222ea078ef
-  data.tar.gz: 5aa462ecdfce87550c51bf4c3e49f3eaab88d29f2e8194b784e512745cdcfe18
+  metadata.gz: f9488cfb5b22f57a1844d34b93def327e31405e10072458227754a4282ccd7bb
+  data.tar.gz: ad460ec7456e52ae77ab04bfb2ba4f3ac6d4acad893f9c6e5e8db19efe87148d
 SHA512:
-  metadata.gz: 54085ffc42a5207339586a51fea923416c324f8aa59c0479be835da934cc9c8e9339961a3b6eac62772953b08b19f2da4ecd84ef2c22708a554ba31a6558244a
-  data.tar.gz: 949a44a8d0e4314f3ee4fca6fe2e84770114fb3bd62e247758693e663917c67fc00ae757bbda5db0ef90d4a5be1427caf1eaf9cf7d3912c7595eae9bf844952c
+  metadata.gz: 6b39d39032a8d48a88a8cef3c897e4ba0be8af21a526dc7783a86ab69eb493d18518d2f1bcfc186009ae700d16c61202e8dcd4f156617f2b0da06b7c68929004
+  data.tar.gz: 111dc8e5298f71d990bd7923cb67680880872ce4dc94423935abadce07fa4df127d21ad68a4c73b2ae25feff86c5f76d3f02fef341f4e1561a6149beee8f5a3d

data/_VERSION

@@ -1 +1 @@
-1.1.332
+1.1.334

data/docs/file.md

@@ -97,6 +97,7 @@ may places where a Ruby File object can be used.
 * `restart` (int64): File byte offset to restart from.
 * `structure` (string): If copying folder, copy just the structure?
 * `with_rename` (boolean): Allow file rename instead of overwrite?
+* `buffered_upload` (boolean): If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
 
 
 ---
@@ -132,7 +133,8 @@ Files::File.create(path,
   provided_mtime: "2000-01-01T01:00:00Z", 
   restart: 1, 
   size: 1, 
-  with_rename: false
+  with_rename: false, 
+  buffered_upload: false
 )
 ```
 
@@ -152,6 +154,7 @@ Files::File.create(path,
 * `size` (int64): Size of file.
 * `structure` (string): If copying folder, copy just the structure?
 * `with_rename` (boolean): Allow file rename instead of overwrite?
+* `buffered_upload` (boolean): If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
 
 
 ---

data/docs/remote_server.md

@@ -11,6 +11,7 @@
   "remote_home_path": "/home/user1",
   "name": "My Remote server",
   "port": 1,
+  "buffer_uploads_always": true,
   "max_connections": 1,
   "pin_to_site_region": true,
   "pinned_region": "us-east-1",
@@ -69,6 +70,7 @@
 * `remote_home_path` (string): Initial home folder on remote server
 * `name` (string): Internal name for your reference
 * `port` (int64): Port for remote server.  Not needed for S3.
+* `buffer_uploads_always` (boolean): If true, uploads to this server will be uploaded first to Files.com before being sent to the remote server. This can improve performance in certain access patterns, such as high-latency connections.  It will cause data to be temporarily stored in Files.com.
 * `max_connections` (int64): Max number of parallel connections.  Ignored for S3 connections (we will parallelize these as much as possible).
 * `pin_to_site_region` (boolean): If true, we will ensure that all communications with this remote server are made through the primary region of the site.  This setting can also be overridden by a site-wide setting which will force it to true.
 * `pinned_region` (string): If set, all communications with this remote server are made through the provided region.
@@ -198,6 +200,7 @@ Files::RemoteServer.create(
   azure_files_storage_share_name: "share-name", 
   backblaze_b2_bucket: "my-bucket", 
   backblaze_b2_s3_endpoint: "s3.us-west-001.backblazeb2.com", 
+  buffer_uploads_always: true, 
   cloudflare_access_key: "example", 
   cloudflare_bucket: "my-bucket", 
   cloudflare_endpoint: "https://<ACCOUNT_ID>.r2.cloudflarestorage.com", 
@@ -268,6 +271,7 @@ Files::RemoteServer.create(
 * `azure_files_storage_share_name` (string): Azure Files:  Storage Share name
 * `backblaze_b2_bucket` (string): Backblaze B2 Cloud Storage: Bucket name
 * `backblaze_b2_s3_endpoint` (string): Backblaze B2 Cloud Storage: S3 Endpoint
+* `buffer_uploads_always` (boolean): If true, uploads to this server will be uploaded first to Files.com before being sent to the remote server. This can improve performance in certain access patterns, such as high-latency connections.  It will cause data to be temporarily stored in Files.com.
 * `cloudflare_access_key` (string): Cloudflare: Access Key.
 * `cloudflare_bucket` (string): Cloudflare: Bucket name
 * `cloudflare_endpoint` (string): Cloudflare: endpoint
@@ -359,6 +363,7 @@ Files::RemoteServer.update(id,
   azure_files_storage_share_name: "share-name", 
   backblaze_b2_bucket: "my-bucket", 
   backblaze_b2_s3_endpoint: "s3.us-west-001.backblazeb2.com", 
+  buffer_uploads_always: true, 
   cloudflare_access_key: "example", 
   cloudflare_bucket: "my-bucket", 
   cloudflare_endpoint: "https://<ACCOUNT_ID>.r2.cloudflarestorage.com", 
@@ -430,6 +435,7 @@ Files::RemoteServer.update(id,
 * `azure_files_storage_share_name` (string): Azure Files:  Storage Share name
 * `backblaze_b2_bucket` (string): Backblaze B2 Cloud Storage: Bucket name
 * `backblaze_b2_s3_endpoint` (string): Backblaze B2 Cloud Storage: S3 Endpoint
+* `buffer_uploads_always` (boolean): If true, uploads to this server will be uploaded first to Files.com before being sent to the remote server. This can improve performance in certain access patterns, such as high-latency connections.  It will cause data to be temporarily stored in Files.com.
 * `cloudflare_access_key` (string): Cloudflare: Access Key.
 * `cloudflare_bucket` (string): Cloudflare: Bucket name
 * `cloudflare_endpoint` (string): Cloudflare: endpoint
@@ -538,6 +544,7 @@ remote_server.update(
   azure_files_storage_share_name: "share-name",
   backblaze_b2_bucket: "my-bucket",
   backblaze_b2_s3_endpoint: "s3.us-west-001.backblazeb2.com",
+  buffer_uploads_always: true,
   cloudflare_access_key: "example",
   cloudflare_bucket: "my-bucket",
   cloudflare_endpoint: "https://<ACCOUNT_ID>.r2.cloudflarestorage.com",
@@ -609,6 +616,7 @@ remote_server.update(
 * `azure_files_storage_share_name` (string): Azure Files:  Storage Share name
 * `backblaze_b2_bucket` (string): Backblaze B2 Cloud Storage: Bucket name
 * `backblaze_b2_s3_endpoint` (string): Backblaze B2 Cloud Storage: S3 Endpoint
+* `buffer_uploads_always` (boolean): If true, uploads to this server will be uploaded first to Files.com before being sent to the remote server. This can improve performance in certain access patterns, such as high-latency connections.  It will cause data to be temporarily stored in Files.com.
 * `cloudflare_access_key` (string): Cloudflare: Access Key.
 * `cloudflare_bucket` (string): Cloudflare: Bucket name
 * `cloudflare_endpoint` (string): Cloudflare: endpoint

data/docs/site.md

@@ -237,6 +237,7 @@
     "disabled": true,
     "disabled_expired_or_inactive": true,
     "email": "john.doe@files.com",
+    "filesystem_layout": "site_root",
     "first_login_at": "2000-01-01T01:00:00Z",
     "ftp_permission": true,
     "group_ids": "example",

data/docs/sso_strategy.md

@@ -20,7 +20,7 @@
   "scim_username": "example",
   "scim_oauth_access_token": "example",
   "scim_oauth_access_token_expires_at": "example",
-  "subdomain": "my-site",
+  "subdomain": "",
   "provision_users": true,
   "provision_groups": true,
   "deprovision_users": true,
@@ -41,6 +41,7 @@
   "provision_time_zone": "Eastern Time (US & Canada)",
   "provision_company": "ACME Corp.",
   "provision_require_2fa": "always_require",
+  "provision_filesystem_layout": "integration_centric",
   "provider_identifier": "",
   "ldap_base_dn": "example",
   "ldap_domain": "mysite.com",
@@ -71,7 +72,7 @@
 * `scim_username` (string): SCIM username.
 * `scim_oauth_access_token` (string): SCIM OAuth Access Token.
 * `scim_oauth_access_token_expires_at` (string): SCIM OAuth Access Token Expiration Time.
-* `subdomain` (string): Subdomain
+* `subdomain` (string): Subdomain or domain name for your auth provider.   Example: `https://[subdomain].okta.com/`
 * `provision_users` (boolean): Auto-provision users?
 * `provision_groups` (boolean): Auto-provision group membership based on group memberships on the SSO side?
 * `deprovision_users` (boolean): Auto-deprovision users?
@@ -92,6 +93,7 @@
 * `provision_time_zone` (string): Default time zone for auto provisioned users.
 * `provision_company` (string): Default company for auto provisioned users.
 * `provision_require_2fa` (string): 2FA required setting for auto provisioned users.
+* `provision_filesystem_layout` (string): File System layout to use for auto provisioned users.
 * `provider_identifier` (string): URL-friendly, unique identifier for Azure SAML configuration
 * `ldap_base_dn` (string): Base DN for looking up users in LDAP server
 * `ldap_domain` (string): Domain name that will be appended to LDAP usernames

data/docs/user.md

@@ -24,6 +24,7 @@
   "disabled": true,
   "disabled_expired_or_inactive": true,
   "email": "john.doe@files.com",
+  "filesystem_layout": "site_root",
   "first_login_at": "2000-01-01T01:00:00Z",
   "ftp_permission": true,
   "group_ids": "example",
@@ -93,6 +94,7 @@
 * `disabled` (boolean): Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting or schedule to be deactivated after specific date.
 * `disabled_expired_or_inactive` (boolean): Computed property that returns true if user disabled or expired or inactive.
 * `email` (email): User email address
+* `filesystem_layout` (string): File system layout
 * `first_login_at` (date-time): User's first login time
 * `ftp_permission` (boolean): Can the user access with FTP/FTPS?
 * `group_ids` (string): Comma-separated list of group IDs of which this user is a member
@@ -213,6 +215,7 @@ Files::User.create(
   bypass_site_allowed_ips: false, 
   dav_permission: true, 
   disabled: true, 
+  filesystem_layout: "site_root", 
   ftp_permission: true, 
   header_text: "User-specific message.", 
   language: "en", 
@@ -265,6 +268,7 @@ Files::User.create(
 * `bypass_site_allowed_ips` (boolean): Allow this user to skip site-wide IP blacklists?
 * `dav_permission` (boolean): Can the user connect with WebDAV?
 * `disabled` (boolean): Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting or schedule to be deactivated after specific date.
+* `filesystem_layout` (string): File system layout
 * `ftp_permission` (boolean): Can the user access with FTP/FTPS?
 * `header_text` (string): Text to display to the user in the header of the UI
 * `language` (string): Preferred language
@@ -352,6 +356,7 @@ Files::User.update(id,
   bypass_site_allowed_ips: false, 
   dav_permission: true, 
   disabled: true, 
+  filesystem_layout: "site_root", 
   ftp_permission: true, 
   header_text: "User-specific message.", 
   language: "en", 
@@ -406,6 +411,7 @@ Files::User.update(id,
 * `bypass_site_allowed_ips` (boolean): Allow this user to skip site-wide IP blacklists?
 * `dav_permission` (boolean): Can the user connect with WebDAV?
 * `disabled` (boolean): Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting or schedule to be deactivated after specific date.
+* `filesystem_layout` (string): File system layout
 * `ftp_permission` (boolean): Can the user access with FTP/FTPS?
 * `header_text` (string): Text to display to the user in the header of the UI
 * `language` (string): Preferred language
@@ -518,6 +524,7 @@ user.update(
   bypass_site_allowed_ips: false,
   dav_permission: true,
   disabled: true,
+  filesystem_layout: "site_root",
   ftp_permission: true,
   header_text: "User-specific message.",
   language: "en",
@@ -572,6 +579,7 @@ user.update(
 * `bypass_site_allowed_ips` (boolean): Allow this user to skip site-wide IP blacklists?
 * `dav_permission` (boolean): Can the user connect with WebDAV?
 * `disabled` (boolean): Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting or schedule to be deactivated after specific date.
+* `filesystem_layout` (string): File system layout
 * `ftp_permission` (boolean): Can the user access with FTP/FTPS?
 * `header_text` (string): Text to display to the user in the header of the UI
 * `language` (string): Preferred language

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

@@ -958,6 +958,15 @@ module Files
       @attributes[:with_rename] = value
     end
 
+    # boolean - If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
+    def buffered_upload
+      @attributes[:buffered_upload]
+    end
+
+    def buffered_upload=(value)
+      @attributes[:buffered_upload] = value
+    end
+
     # Download File
     #
     # Parameters:
@@ -1110,6 +1119,7 @@ module Files
     #   size - int64 - Size of file.
     #   structure - string - If copying folder, copy just the structure?
     #   with_rename - boolean - Allow file rename instead of overwrite?
+    #   buffered_upload - boolean - If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
     def self.create(path, params = {}, options = {})
       params ||= {}
       params[:path] = path

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

@@ -72,6 +72,15 @@ module Files
       @attributes[:port] = value
     end
 
+    # boolean - If true, uploads to this server will be uploaded first to Files.com before being sent to the remote server. This can improve performance in certain access patterns, such as high-latency connections.  It will cause data to be temporarily stored in Files.com.
+    def buffer_uploads_always
+      @attributes[:buffer_uploads_always]
+    end
+
+    def buffer_uploads_always=(value)
+      @attributes[:buffer_uploads_always] = value
+    end
+
     # int64 - Max number of parallel connections.  Ignored for S3 connections (we will parallelize these as much as possible).
     def max_connections
       @attributes[:max_connections]
@@ -740,6 +749,7 @@ module Files
     #   azure_files_storage_share_name - string - Azure Files:  Storage Share name
     #   backblaze_b2_bucket - string - Backblaze B2 Cloud Storage: Bucket name
     #   backblaze_b2_s3_endpoint - string - Backblaze B2 Cloud Storage: S3 Endpoint
+    #   buffer_uploads_always - boolean - If true, uploads to this server will be uploaded first to Files.com before being sent to the remote server. This can improve performance in certain access patterns, such as high-latency connections.  It will cause data to be temporarily stored in Files.com.
     #   cloudflare_access_key - string - Cloudflare: Access Key.
     #   cloudflare_bucket - string - Cloudflare: Bucket name
     #   cloudflare_endpoint - string - Cloudflare: endpoint
@@ -952,6 +962,7 @@ module Files
     #   azure_files_storage_share_name - string - Azure Files:  Storage Share name
     #   backblaze_b2_bucket - string - Backblaze B2 Cloud Storage: Bucket name
     #   backblaze_b2_s3_endpoint - string - Backblaze B2 Cloud Storage: S3 Endpoint
+    #   buffer_uploads_always - boolean - If true, uploads to this server will be uploaded first to Files.com before being sent to the remote server. This can improve performance in certain access patterns, such as high-latency connections.  It will cause data to be temporarily stored in Files.com.
     #   cloudflare_access_key - string - Cloudflare: Access Key.
     #   cloudflare_bucket - string - Cloudflare: Bucket name
     #   cloudflare_endpoint - string - Cloudflare: endpoint
@@ -1119,6 +1130,7 @@ module Files
     #   azure_files_storage_share_name - string - Azure Files:  Storage Share name
     #   backblaze_b2_bucket - string - Backblaze B2 Cloud Storage: Bucket name
     #   backblaze_b2_s3_endpoint - string - Backblaze B2 Cloud Storage: S3 Endpoint
+    #   buffer_uploads_always - boolean - If true, uploads to this server will be uploaded first to Files.com before being sent to the remote server. This can improve performance in certain access patterns, such as high-latency connections.  It will cause data to be temporarily stored in Files.com.
     #   cloudflare_access_key - string - Cloudflare: Access Key.
     #   cloudflare_bucket - string - Cloudflare: Bucket name
     #   cloudflare_endpoint - string - Cloudflare: endpoint

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

@@ -89,7 +89,7 @@ module Files
       @attributes[:scim_oauth_access_token_expires_at]
     end
 
-    # string - Subdomain
+    # string - Subdomain or domain name for your auth provider.   Example: `https://[subdomain].okta.com/`
     def subdomain
       @attributes[:subdomain]
     end
@@ -194,6 +194,11 @@ module Files
       @attributes[:provision_require_2fa]
     end
 
+    # string - File System layout to use for auto provisioned users.
+    def provision_filesystem_layout
+      @attributes[:provision_filesystem_layout]
+    end
+
     # string - URL-friendly, unique identifier for Azure SAML configuration
     def provider_identifier
       @attributes[:provider_identifier]

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

@@ -167,6 +167,15 @@ module Files
       @attributes[:email] = value
     end
 
+    # string - File system layout
+    def filesystem_layout
+      @attributes[:filesystem_layout]
+    end
+
+    def filesystem_layout=(value)
+      @attributes[:filesystem_layout] = value
+    end
+
     # date-time - User's first login time
     def first_login_at
       @attributes[:first_login_at]
@@ -753,6 +762,7 @@ module Files
     #   bypass_site_allowed_ips - boolean - Allow this user to skip site-wide IP blacklists?
     #   dav_permission - boolean - Can the user connect with WebDAV?
     #   disabled - boolean - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting or schedule to be deactivated after specific date.
+    #   filesystem_layout - string - File system layout
     #   ftp_permission - boolean - Can the user access with FTP/FTPS?
     #   header_text - string - Text to display to the user in the header of the UI
     #   language - string - Preferred language
@@ -797,6 +807,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: allowed_ips must be an String") if params[:allowed_ips] and !params[:allowed_ips].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: authenticate_until must be an String") if params[:authenticate_until] and !params[:authenticate_until].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: authentication_method must be an String") if params[:authentication_method] and !params[:authentication_method].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: filesystem_layout must be an String") if params[:filesystem_layout] and !params[:filesystem_layout].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: header_text must be an String") if params[:header_text] and !params[:header_text].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: language must be an String") if params[:language] and !params[:language].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: notification_daily_send_time must be an Integer") if params[:notification_daily_send_time] and !params[:notification_daily_send_time].is_a?(Integer)
@@ -919,6 +930,7 @@ module Files
     #   bypass_site_allowed_ips - boolean - Allow this user to skip site-wide IP blacklists?
     #   dav_permission - boolean - Can the user connect with WebDAV?
     #   disabled - boolean - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting or schedule to be deactivated after specific date.
+    #   filesystem_layout - string - File system layout
     #   ftp_permission - boolean - Can the user access with FTP/FTPS?
     #   header_text - string - Text to display to the user in the header of the UI
     #   language - string - Preferred language
@@ -958,6 +970,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: allowed_ips must be an String") if params[:allowed_ips] and !params[:allowed_ips].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: authenticate_until must be an String") if params[:authenticate_until] and !params[:authenticate_until].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: authentication_method must be an String") if params[:authentication_method] and !params[:authentication_method].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: filesystem_layout must be an String") if params[:filesystem_layout] and !params[:filesystem_layout].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: header_text must be an String") if params[:header_text] and !params[:header_text].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: language must be an String") if params[:language] and !params[:language].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: notification_daily_send_time must be an Integer") if params[:notification_daily_send_time] and !params[:notification_daily_send_time].is_a?(Integer)
@@ -1034,6 +1047,7 @@ module Files
     #   bypass_site_allowed_ips - boolean - Allow this user to skip site-wide IP blacklists?
     #   dav_permission - boolean - Can the user connect with WebDAV?
     #   disabled - boolean - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting or schedule to be deactivated after specific date.
+    #   filesystem_layout - string - File system layout
     #   ftp_permission - boolean - Can the user access with FTP/FTPS?
     #   header_text - string - Text to display to the user in the header of the UI
     #   language - string - Preferred language
@@ -1077,6 +1091,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: allowed_ips must be an String") if params[:allowed_ips] and !params[:allowed_ips].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: authenticate_until must be an String") if params[:authenticate_until] and !params[:authenticate_until].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: authentication_method must be an String") if params[:authentication_method] and !params[:authentication_method].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: filesystem_layout must be an String") if params[:filesystem_layout] and !params[:filesystem_layout].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: header_text must be an String") if params[:header_text] and !params[:header_text].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: language must be an String") if params[:language] and !params[:language].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: notification_daily_send_time must be an Integer") if params[:notification_daily_send_time] and !params[:notification_daily_send_time].is_a?(Integer)

data/lib/files.com/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Files
-  VERSION = "1.1.332"
+  VERSION = "1.1.334"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.332
+  version: 1.1.334
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-10-08 00:00:00.000000000 Z
+date: 2025-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable