files.com 1.1.786 → 1.1.787

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

@@ -161,15 +161,19 @@ module Files
     #   user_tag - string - If provided, only users with this tag will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
     #   workspace_id - int64 - Workspace whose users the rule applies to. `0` means the Default Workspace. A Custom Workspace rule applies only to users who belong to that Workspace, regardless of access granted to other users.
     def update(params = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = @attributes[:id]
       raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: action must be an String") if !params[:action].nil? and !params[:action].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: apply_to_all_workspaces must be a single value, not #{params[:apply_to_all_workspaces].class}") if [ Array, Hash ].any? { |klass| params[:apply_to_all_workspaces].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: authentication_method must be an String") if !params[:authentication_method].nil? and !params[:authentication_method].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: group_ids must be an Array") if !params[:group_ids].nil? and !params[:group_ids].is_a?(Array)
       raise InvalidParameterError.new("Bad parameter: inactivity_days must be an Integer") if !params[:inactivity_days].nil? and !params[:inactivity_days].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: include_site_admins must be a single value, not #{params[:include_site_admins].class}") if [ Array, Hash ].any? { |klass| params[:include_site_admins].is_a?(klass) }
+      raise InvalidParameterError.new("Bad parameter: include_folder_admins must be a single value, not #{params[:include_folder_admins].class}") if [ Array, Hash ].any? { |klass| params[:include_folder_admins].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: name must be an String") if !params[:name].nil? and !params[:name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: notify_users must be a single value, not #{params[:notify_users].class}") if [ Array, Hash ].any? { |klass| params[:notify_users].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: partner_tag must be an String") if !params[:partner_tag].nil? and !params[:partner_tag].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: user_state must be an String") if !params[:user_state].nil? and !params[:user_state].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: user_tag must be an String") if !params[:user_tag].nil? and !params[:user_tag].is_a?(String)
@@ -178,18 +182,21 @@ module Files
 
       response, options = Api.send_request("/user_lifecycle_rules/#{@attributes[:id]}", :patch, params, @options) { |reply| reply.require_object("UserLifecycleRule") }
       @attributes = response.data
+      @options = @options.merge(options)
       [ response, options ]
     end
 
     # Returns the [response, options] pair from Files::Api.send_request.
     def delete(params = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = @attributes[:id]
       raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") if params[:id].nil?
 
-      Api.send_request("/user_lifecycle_rules/#{@attributes[:id]}", :delete, params, @options)
+      response, options = Api.send_request("/user_lifecycle_rules/#{@attributes[:id]}", :delete, params, @options)
+      @options = @options.merge(options)
+      [ response, options ]
     end
 
     # Alias for #delete. Returns nil.
@@ -204,6 +211,7 @@ module Files
       else
         new_obj = UserLifecycleRule.create(@attributes, @options)
         @attributes = new_obj.attributes
+        @options = @options.merge(new_obj.options)
       end
 
       true
@@ -225,8 +233,11 @@ module Files
       raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if !params[:sort_by].nil? and !params[:sort_by].is_a?(Hash)
       raise InvalidParameterError.new("Bad parameter: filter must be an Hash") if !params[:filter].nil? and !params[:filter].is_a?(Hash)
 
+      list_options = options.dup
       List.new(UserLifecycleRule, params) do |page_params, &check_page|
-        Api.send_request("/user_lifecycle_rules", :get, page_params, options, &check_page)
+        response, page_options = Api.send_request("/user_lifecycle_rules", :get, page_params, list_options, &check_page)
+        list_options = list_options.merge(page_options)
+        [ response, page_options ]
       end
     end
 
@@ -242,7 +253,7 @@ module Files
     #
     # Returns a Files::UserLifecycleRule.
     def self.find(id, params = {}, options = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") if params[:id].nil?
@@ -276,10 +287,14 @@ module Files
     # Returns a Files::UserLifecycleRule.
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: action must be an String") if !params[:action].nil? and !params[:action].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: apply_to_all_workspaces must be a single value, not #{params[:apply_to_all_workspaces].class}") if [ Array, Hash ].any? { |klass| params[:apply_to_all_workspaces].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: authentication_method must be an String") if !params[:authentication_method].nil? and !params[:authentication_method].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: group_ids must be an Array") if !params[:group_ids].nil? and !params[:group_ids].is_a?(Array)
       raise InvalidParameterError.new("Bad parameter: inactivity_days must be an Integer") if !params[:inactivity_days].nil? and !params[:inactivity_days].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: include_site_admins must be a single value, not #{params[:include_site_admins].class}") if [ Array, Hash ].any? { |klass| params[:include_site_admins].is_a?(klass) }
+      raise InvalidParameterError.new("Bad parameter: include_folder_admins must be a single value, not #{params[:include_folder_admins].class}") if [ Array, Hash ].any? { |klass| params[:include_folder_admins].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: name must be an String") if !params[:name].nil? and !params[:name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: notify_users must be a single value, not #{params[:notify_users].class}") if [ Array, Hash ].any? { |klass| params[:notify_users].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: partner_tag must be an String") if !params[:partner_tag].nil? and !params[:partner_tag].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: user_state must be an String") if !params[:user_state].nil? and !params[:user_state].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: user_tag must be an String") if !params[:user_tag].nil? and !params[:user_tag].is_a?(String)
@@ -309,14 +324,18 @@ module Files
     #
     # Returns a Files::UserLifecycleRule.
     def self.update(id, params = {}, options = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: action must be an String") if !params[:action].nil? and !params[:action].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: apply_to_all_workspaces must be a single value, not #{params[:apply_to_all_workspaces].class}") if [ Array, Hash ].any? { |klass| params[:apply_to_all_workspaces].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: authentication_method must be an String") if !params[:authentication_method].nil? and !params[:authentication_method].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: group_ids must be an Array") if !params[:group_ids].nil? and !params[:group_ids].is_a?(Array)
       raise InvalidParameterError.new("Bad parameter: inactivity_days must be an Integer") if !params[:inactivity_days].nil? and !params[:inactivity_days].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: include_site_admins must be a single value, not #{params[:include_site_admins].class}") if [ Array, Hash ].any? { |klass| params[:include_site_admins].is_a?(klass) }
+      raise InvalidParameterError.new("Bad parameter: include_folder_admins must be a single value, not #{params[:include_folder_admins].class}") if [ Array, Hash ].any? { |klass| params[:include_folder_admins].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: name must be an String") if !params[:name].nil? and !params[:name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: notify_users must be a single value, not #{params[:notify_users].class}") if [ Array, Hash ].any? { |klass| params[:notify_users].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: partner_tag must be an String") if !params[:partner_tag].nil? and !params[:partner_tag].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: user_state must be an String") if !params[:user_state].nil? and !params[:user_state].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: user_tag must be an String") if !params[:user_tag].nil? and !params[:user_tag].is_a?(String)
@@ -332,7 +351,7 @@ module Files
     #
     # Returns nil.
     def self.delete(id, params = {}, options = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") if params[:id].nil?

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

@@ -58,13 +58,15 @@ module Files
 
     # Returns the [response, options] pair from Files::Api.send_request.
     def delete(params = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = @attributes[:id]
       raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") if params[:id].nil?
 
-      Api.send_request("/user_requests/#{@attributes[:id]}", :delete, params, @options)
+      response, options = Api.send_request("/user_requests/#{@attributes[:id]}", :delete, params, @options)
+      @options = @options.merge(options)
+      [ response, options ]
     end
 
     # Alias for #delete. Returns nil.
@@ -79,6 +81,7 @@ module Files
       else
         new_obj = UserRequest.create(@attributes, @options)
         @attributes = new_obj.attributes
+        @options = @options.merge(new_obj.options)
       end
 
       true
@@ -96,8 +99,11 @@ module Files
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if !params[:cursor].nil? and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if !params[:per_page].nil? and !params[:per_page].is_a?(Integer)
 
+      list_options = options.dup
       List.new(UserRequest, params) do |page_params, &check_page|
-        Api.send_request("/user_requests", :get, page_params, options, &check_page)
+        response, page_options = Api.send_request("/user_requests", :get, page_params, list_options, &check_page)
+        list_options = list_options.merge(page_options)
+        [ response, page_options ]
       end
     end
 
@@ -113,7 +119,7 @@ module Files
     #
     # Returns a Files::UserRequest.
     def self.find(id, params = {}, options = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") if params[:id].nil?
@@ -154,7 +160,7 @@ module Files
     #
     # Returns nil.
     def self.delete(id, params = {}, options = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") if params[:id].nil?

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

@@ -70,8 +70,11 @@ module Files
       raise InvalidParameterError.new("Bad parameter: filter_lt must be an Hash") if !params[:filter_lt].nil? and !params[:filter_lt].is_a?(Hash)
       raise InvalidParameterError.new("Bad parameter: filter_lteq must be an Hash") if !params[:filter_lteq].nil? and !params[:filter_lteq].is_a?(Hash)
 
+      list_options = options.dup
       List.new(UserSecurityEvent, params) do |page_params, &check_page|
-        Api.send_request("/user_security_events", :get, page_params, options, &check_page)
+        response, page_options = Api.send_request("/user_security_events", :get, page_params, list_options, &check_page)
+        list_options = list_options.merge(page_options)
+        [ response, page_options ]
       end
     end
 
@@ -87,7 +90,7 @@ module Files
     #
     # Returns a Files::UserSecurityEvent.
     def self.find(id, params = {}, options = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") if params[:id].nil?

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

@@ -52,8 +52,11 @@ module Files
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if !params[:per_page].nil? and !params[:per_page].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if !params[:sort_by].nil? and !params[:sort_by].is_a?(Hash)
 
+      list_options = options.dup
       List.new(UserSftpClientUse, params) do |page_params, &check_page|
-        Api.send_request("/user_sftp_client_uses", :get, page_params, options, &check_page)
+        response, page_options = Api.send_request("/user_sftp_client_uses", :get, page_params, list_options, &check_page)
+        list_options = list_options.merge(page_options)
+        [ response, page_options ]
       end
     end
 

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

@@ -125,8 +125,11 @@ module Files
       raise InvalidParameterError.new("Bad parameter: filter_lt must be an Hash") if !params[:filter_lt].nil? and !params[:filter_lt].is_a?(Hash)
       raise InvalidParameterError.new("Bad parameter: filter_lteq must be an Hash") if !params[:filter_lteq].nil? and !params[:filter_lteq].is_a?(Hash)
 
+      list_options = options.dup
       List.new(WebDavActionLog, params) do |page_params, &check_page|
-        Api.send_request("/web_dav_action_logs", :get, page_params, options, &check_page)
+        response, page_options = Api.send_request("/web_dav_action_logs", :get, page_params, list_options, &check_page)
+        list_options = list_options.merge(page_options)
+        [ response, page_options ]
       end
     end
 

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

@@ -152,6 +152,7 @@ module Files
       else
         new_obj = WebhookTest.create(@attributes, @options)
         @attributes = new_obj.attributes
+        @options = @options.merge(new_obj.options)
       end
 
       true
@@ -180,8 +181,10 @@ module Files
       raise InvalidParameterError.new("Bad parameter: headers must be an Hash") if !params[:headers].nil? and !params[:headers].is_a?(Hash)
       raise InvalidParameterError.new("Bad parameter: body must be an Hash") if !params[:body].nil? and !params[:body].is_a?(Hash)
       raise InvalidParameterError.new("Bad parameter: raw_body must be an String") if !params[:raw_body].nil? and !params[:raw_body].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: file_as_body must be a single value, not #{params[:file_as_body].class}") if [ Array, Hash ].any? { |klass| params[:file_as_body].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: file_form_field must be an String") if !params[:file_form_field].nil? and !params[:file_form_field].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: action must be an String") if !params[:action].nil? and !params[:action].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: use_dedicated_ips must be a single value, not #{params[:use_dedicated_ips].class}") if [ Array, Hash ].any? { |klass| params[:use_dedicated_ips].is_a?(klass) }
       raise MissingParameterError.new("Parameter missing: url") if params[:url].nil?
 
       response, options = Api.send_request("/webhook_tests", :post, params, options) { |reply| reply.require_object("WebhookTest") }

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

@@ -32,7 +32,7 @@ module Files
     # Parameters:
     #   name - string - Workspace name
     def update(params = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = @attributes[:id]
       raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
@@ -41,18 +41,21 @@ module Files
 
       response, options = Api.send_request("/workspaces/#{@attributes[:id]}", :patch, params, @options) { |reply| reply.require_object("Workspace") }
       @attributes = response.data
+      @options = @options.merge(options)
       [ response, options ]
     end
 
     # Returns the [response, options] pair from Files::Api.send_request.
     def delete(params = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = @attributes[:id]
       raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") if params[:id].nil?
 
-      Api.send_request("/workspaces/#{@attributes[:id]}", :delete, params, @options)
+      response, options = Api.send_request("/workspaces/#{@attributes[:id]}", :delete, params, @options)
+      @options = @options.merge(options)
+      [ response, options ]
     end
 
     # Alias for #delete. Returns nil.
@@ -67,6 +70,7 @@ module Files
       else
         new_obj = Workspace.create(@attributes, @options)
         @attributes = new_obj.attributes
+        @options = @options.merge(new_obj.options)
       end
 
       true
@@ -90,8 +94,11 @@ module Files
       raise InvalidParameterError.new("Bad parameter: filter must be an Hash") if !params[:filter].nil? and !params[:filter].is_a?(Hash)
       raise InvalidParameterError.new("Bad parameter: filter_prefix must be an Hash") if !params[:filter_prefix].nil? and !params[:filter_prefix].is_a?(Hash)
 
+      list_options = options.dup
       List.new(Workspace, params) do |page_params, &check_page|
-        Api.send_request("/workspaces", :get, page_params, options, &check_page)
+        response, page_options = Api.send_request("/workspaces", :get, page_params, list_options, &check_page)
+        list_options = list_options.merge(page_options)
+        [ response, page_options ]
       end
     end
 
@@ -107,7 +114,7 @@ module Files
     #
     # Returns a Files::Workspace.
     def self.find(id, params = {}, options = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") if params[:id].nil?
@@ -142,7 +149,7 @@ module Files
     #
     # Returns a Files::Workspace.
     def self.update(id, params = {}, options = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: name must be an String") if !params[:name].nil? and !params[:name].is_a?(String)
@@ -157,7 +164,7 @@ module Files
     #
     # Returns nil.
     def self.delete(id, params = {}, options = {})
-      params ||= {}
+      params = (params || {}).dup
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if !params[:id].nil? and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") if params[:id].nil?

data/lib/files.com/util.rb

@@ -2,7 +2,7 @@
 
 module Files
   module Util
-    OPTS = Set[:api_key, :client, :session_id, :workspace_id].freeze
+    OPTS = Set[:api_key, :base_url, :client, :region_http_pairs, :session_id, :workspace_id].freeze
     COLOR_CODES = {
       black:   0, light_black:   60,
       red:     1, light_red:     61,
@@ -53,6 +53,37 @@ module Files
       val
     end
 
+    # The http:// origin +value+ names, written as http://, its lowercase host and a port only when it is not 80, or
+    # nil when +value+ is not a plain http:// origin: a host name or IP address with an empty or "/" path and no
+    # credentials, query, fragment, spaces or backslashes.
+    def self.http_origin(value)
+      return unless value.is_a?(String) && !value.match?(/[[:space:][:cntrl:]\\]/) && value.match?(/\Ahttp:\/\/[^\/?#@]+\/?\z/i)
+
+      uri = Addressable::URI.parse(value)
+      host = uri.normalized_host.to_s
+      port = uri.port || 80
+      return unless port.between?(1, 65_535) && host.match?(/\A(\[[0-9a-f:.]+\]|[a-z0-9]([a-z0-9.-]*[a-z0-9])?)\z/)
+
+      port == 80 ? "http://#{host}" : "http://#{host}:#{port}"
+    rescue Addressable::URI::InvalidURIError, ArgumentError
+      nil
+    end
+
+    # A frozen copy of +pairs+ for Files.region_http_pairs= and the region_http_pairs option of a Files::ApiClient or a
+    # request, made of new Arrays and Strings, so the caller's are neither kept nor changed. Raises ArgumentError unless
+    # +pairs+ is an Array of [source, destination] Arrays of two origins already written the way http_origin writes them.
+    def self.checked_region_http_pairs(pairs)
+      message = "region_http_pairs should be an Array of [source, destination] Arrays of http:// origins, each with a lowercase host, a port only when it is not 80 and no path"
+      raise ArgumentError, message unless pairs.is_a?(Array)
+
+      pairs.map do |pair|
+        origins = pair.is_a?(Array) ? pair.map { |origin| http_origin(origin) } : []
+        raise ArgumentError, message unless origins.length == 2 && origins.all? && origins == pair
+
+        origins.each(&:freeze).freeze
+      end.freeze
+    end
+
     def self.log_error(message, data = {}, settings = global_log_settings)
       if !settings.logger.nil? ||
          (!settings.log_level.nil? && settings.log_level <= Files::LEVEL_ERROR)

data/lib/files.com.rb

@@ -190,6 +190,9 @@ module Files
   @log_level = nil
   @logger = nil
   @proxy = nil
+  @region_handler = nil
+  @region_http_pairs = [].freeze
+  @region_policy = :automatic
   @session_id = nil
   @workspace_id = nil
   @default_headers = nil
@@ -203,7 +206,7 @@ module Files
 
   class << self
     attr_accessor :api_key, :base_url, :default_headers, :initial_network_retry_delay, :language, :max_network_retry_delay, :proxy, :session_id, :workspace_id
-    attr_reader :open_timeout, :read_timeout
+    attr_reader :open_timeout, :read_timeout, :region_handler, :region_http_pairs, :region_policy
   end
 
   # map to the same values as the standard library's logger
@@ -281,6 +284,56 @@ module Files
     raise ArgumentError, "#{name} should be nil or a number of seconds from 0 to #{MAX_TIMEOUT}"
   end
 
+  # What a request does when the API answers that the site must be reached through another origin, such as its
+  # region or its custom domain (Files::LockoutRegionMismatchError, with that origin in data[:host]).
+  #
+  # :automatic (the default) sends the same request once more to that origin, within the same retry count, and keeps
+  # using it for the records and pages the request returns. Other requests still start at Files.base_url. It does so
+  # only for an error that came over verified HTTPS from the configured base URL through the SDK's own connection, and
+  # only to an https:// origin on a DNS name at port 443 that is not a local or Files.com development name, unless
+  # region_handler approves another. The only exception is plain HTTP from the source to the destination of a
+  # region_http_pairs pair. :disabled raises the error instead, so you can update your own settings and retry.
+  def self.region_policy=(policy)
+    raise ArgumentError, "region_policy should be :automatic or :disabled" unless %i[automatic disabled].include?(policy)
+
+    @region_policy = policy
+  end
+
+  # Pairs of http:// origins, each letting a lockout region mismatch move a request from the first to the second over
+  # plain HTTP, for your own local development servers only. Plain HTTP is intentionally insecure: it sends the API key
+  # or session unencrypted to whatever answers, and a pair is your explicit choice, never a verified or trusted origin.
+  # Each pair is [source, destination], such as [["http://localhost:3000", "http://site.localhost:3000"]].
+  #
+  # With region_policy :automatic, a request to the source (Files.base_url, or the request's own base_url) that gets
+  # the error with data[:host] naming the destination, as that full http:// origin or as its bare host (with its port
+  # when it is not 80), is sent once more to the destination, within the same retry count, and the records and pages
+  # it returns keep using it. region_handler, when set, is still asked first and can decline. Nothing else continues
+  # over plain HTTP, a request to an https:// origin never does, and :disabled still raises the error.
+  #
+  # Write each origin as http://, a lowercase host name or IP address, a port only when it is not 80 and no path.
+  # The default, [], allows none. The SDK keeps a frozen copy, so changing the Arrays or Strings you passed has no
+  # effect. Each request fixes its pairs before it starts: its own region_http_pairs option if it has one, otherwise
+  # those of a Files::ApiClient created with its own region_http_pairs, otherwise this setting. The records and pages
+  # it returns keep those pairs in their options, so their own requests use them even after this setting changes;
+  # other requests use the setting as it is when they start.
+  def self.region_http_pairs=(pairs)
+    @region_http_pairs = Util.checked_region_http_pairs(pairs)
+  end
+
+  # An optional object with a call method that decides each move to another origin. It receives a frozen Hash with
+  # :reason (:lockout_region_mismatch), :original_origin, :target_origin and :approval_required (true for an IP
+  # address, a localhost, .local, files.test or filesrails.test name, a name without a dot or a port other than 443).
+  # It returns true to continue at the target origin; another https:// origin in the same form (lowercase host, a port
+  # only when it is not 443, no path) to continue there instead, which the SDK checks like the target; or false or nil
+  # to raise the error. An error it raises stops the request. It cannot make a request continue from an error the SDK
+  # does not trust. For a move between region_http_pairs origins, :approval_required is false, since the pair already
+  # allows it, and another origin it returns must be a destination paired with the same source, written as in the pairs.
+  def self.region_handler=(handler)
+    raise ArgumentError, "region_handler should be nil or respond to call" unless handler.nil? || handler.respond_to?(:call)
+
+    @region_handler = handler
+  end
+
   def self.session=(session)
     session.save unless session.id
     self.session_id = session.id