internetdata 2.3.1 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2733fa2507c4610501c4941ee66bd085f4eecee78491803742d7c796de693df2
-  data.tar.gz: af87a305689fbdba6d7c409944c6b7eeb8f7682ce9e1209829186b7b89a3faf7
+  metadata.gz: f63ce81a04c9374b72693f32c6c246ca19a77da3891980f40170c4065faafd14
+  data.tar.gz: 12aa236085aaebf96288876dac1a91c60e4947e6a5cb5fced7c0440f13d0ef8d
 SHA512:
-  metadata.gz: 6c4e6ac56b6baad950705defb63fad84e7f85f623cbbff479fc7702d4be222dc9c425e842d4344dbbe40e3e08dbad020c9b7b78b52565459be226b78742b0dec
-  data.tar.gz: 0a3609002009c1dff4daaed53a5957369d81a0dfa3806a7afc93f2ee2fd3f3ba3ede86e802139f6d8a81a4dfc75f9bf0e89ab7d607472d9c84488300d70139a1
+  metadata.gz: 367c9cfc6352638a61ae4249e67135e6ce794f5e59baa32eb9239ca17d891758e098d914fef6fb7460a2f4839746cc0171d2d15ab51bf186cf3cc1bf32b66798
+  data.tar.gz: a0bd89ba6440166e54e79d52e384b982799a3b4282ddbe492ab7a268d90396f1c8b931d6487903c983592185a78f2fee281ea55f88f7f7b1eeaa1595d6ff7d4a

data/README.md

@@ -100,7 +100,7 @@ client = InternetData::Client.new(api_key: ENV['INTERNETDATA_API_KEY'], timeout:
 catalog = client.database.list(timeout: 5)
 ```
 
-`timeout` is in seconds and bounds each attempt, body included, so a call that is retried can take longer in total. It defaults to 30 seconds. The client's value is the default: from 2.1.0, `list`, `metadata`, `checksums`, `downloads` and `download_url` each take `timeout:` for that call alone.
+`timeout` is in seconds and bounds each attempt, body included, so a call that is retried can take longer in total. It defaults to 30 seconds, and 0 means no bound. The client's value is the default: from 2.1.0, `list`, `metadata`, `checksums`, `downloads` and `download_url` each take `timeout:` for that call alone. A negative value, anything that isn't a number, and anything past 2147483.647 seconds (the longest curl holds) raise `ArgumentError` where you pass them, before any request.
 
 `download` and `download_bytes` take no `timeout:` and raise `ArgumentError` if handed one, rather than accepting it and quietly doing nothing: a transfer runs to gigabytes and minutes, so any bound that suits a JSON call would abandon a healthy download. They bound only their connection with the client's value. `download_url` does take one, because minting the link is an ordinary API request - it bounds that request, not whatever you do with the link afterwards.
 
@@ -118,7 +118,7 @@ end
 
 `kind` is one of `:bad_request`, `:unauthorized`, `:forbidden`, `:rate_limited`, `:quota_exceeded`, `:server_error` or `:network`. `rc` is the API's own result code, such as `NOT_LICENSED` or `LICENSE_EXPIRED`, which is usually the specific thing you want to read.
 
-Note that `:rate_limited` and `:quota_exceeded` both arrive as HTTP 429 and are not the same thing. A rate limit is the API facing a burst, so retrying later works; a spent quota needs your allowance raised or the window to roll over. The library retries the first for you and never the second.
+Note that `:rate_limited` and `:quota_exceeded` both arrive as HTTP 429 and are not the same thing. A rate limit is the API facing a burst, so retrying later works; a spent quota needs your allowance raised or the window to roll over. The library retries the first for you and never the second. It waits the `Retry-After` the API sent, or its own backoff from 250 ms when that's past about 24.8 days.
 
 ### Sign in with OAuth (device flow)
 
@@ -145,7 +145,7 @@ There are official InternetData client libraries available for many languages in
 
 IP intelligence databases: VPN, proxy, hosting, CDN and relay address space, provider catalogs and network metadata, published as CSV and MMDB.
 
-[<img src="https://s3.internetdata.io/internetdata-public/brand/mark.svg" alt="InternetData" width="96"/>](https://internetdata.io/)
+[<img src="https://s3.internetdata.io/internetdata-public/brand/mark.svg" alt="InternetData" height="64"/>](https://internetdata.io/)
 
 ## License
 

data/lib/internetdata/api/database_v2_api.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/api_client.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/api_error.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/api_model_base.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/client.rb

@@ -21,9 +21,13 @@ module InternetData
 
     # @param api_key [String, nil] a key carrying the `db.download` scope. Omit
     #   it and no credential is sent; every database published today answers 401.
-    # @param retries [Integer] extra attempts for a transient failure.
-    # @param timeout [Numeric] seconds allowed for one API call. It also bounds the
-    #   CONNECT phase of a transfer, which is otherwise unlimited.
+    # @param retries [Integer] extra attempts for a transient failure. Each waits
+    #   the server's `Retry-After` when it sent one of at most about 24.8 days,
+    #   and otherwise a backoff of 250 ms that doubles per retry.
+    # @param timeout [Numeric] seconds allowed for one API call, 0 for no bound. It
+    #   also bounds the CONNECT phase of a transfer, which is otherwise unlimited.
+    # @raise [ArgumentError] for a `timeout` that is negative, not a finite number,
+    #   or past 2147483.647 seconds (2**31 - 1 ms), the longest curl holds.
     # @param transport [Transport, nil] override the HTTP layer, mostly for tests.
     def initialize(api_key: nil, base_url: DEFAULT_BASE_URL, retries: DEFAULT_RETRIES,
                    timeout: DEFAULT_TIMEOUT, transport: nil)

data/lib/internetdata/configuration.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/database_api.rb

@@ -7,7 +7,8 @@ module InternetData
   # the generated {DatabaseV2Api} underneath, which speaks the wire.
   #
   # Every JSON call here takes `timeout:`, in seconds, bounding each ATTEMPT of
-  # that call alone and overriding the bound the client was built with. The two
+  # that call alone and overriding the bound the client was built with; one the
+  # client would refuse raises ArgumentError before any request. The two
   # transfers take none, and are refused it rather than ignoring it: a database
   # runs to gigabytes and minutes, so a bound that suits a JSON call would
   # abandon a healthy download.

data/lib/internetdata/models/database.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/models/database_checksums_response.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/models/database_format.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/models/database_list.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/models/database_metadata.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -36,6 +36,12 @@ module InternetData
     # Bytes per format.
     attr_accessor :size
 
+    # Bytes per format of the evaluation sample, where one is published.
+    attr_accessor :sample_size
+
+    # Row count in the evaluation sample.
+    attr_accessor :sample_entries
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -45,7 +51,9 @@ module InternetData
         :'entries' => :'entries',
         :'schema' => :'schema',
         :'sample' => :'sample',
-        :'size' => :'size'
+        :'size' => :'size',
+        :'sample_size' => :'sample_size',
+        :'sample_entries' => :'sample_entries'
       }
     end
 
@@ -68,7 +76,9 @@ module InternetData
         :'entries' => :'Integer',
         :'schema' => :'Hash<String, Array<DatabaseMetadataColumn>>',
         :'sample' => :'Hash<String, Array<Object>>',
-        :'size' => :'Hash<String, Integer>'
+        :'size' => :'Hash<String, Integer>',
+        :'sample_size' => :'Hash<String, Integer>',
+        :'sample_entries' => :'Integer'
       }
     end
 
@@ -137,6 +147,16 @@ module InternetData
       else
         self.size = nil
       end
+
+      if attributes.key?(:'sample_size')
+        if (value = attributes[:'sample_size']).is_a?(Hash)
+          self.sample_size = value
+        end
+      end
+
+      if attributes.key?(:'sample_entries')
+        self.sample_entries = attributes[:'sample_entries']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -240,7 +260,9 @@ module InternetData
           entries == o.entries &&
           schema == o.schema &&
           sample == o.sample &&
-          size == o.size
+          size == o.size &&
+          sample_size == o.sample_size &&
+          sample_entries == o.sample_entries
     end
 
     # @see the `==` method
@@ -252,7 +274,7 @@ module InternetData
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, update_freq, updated, entries, schema, sample, size].hash
+      [id, update_freq, updated, entries, schema, sample, size, sample_size, sample_entries].hash
     end
 
     # Builds the object from hash

data/lib/internetdata/models/database_metadata_column.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/models/database_version.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -25,13 +25,17 @@ module InternetData
     # The formats this version is BUILT in. Asking for another is a 400, not a gap - the `_provider` catalogs are keyed by provider id, so no MMDB exists for them. 
     attr_accessor :formats
 
+    # The formats an evaluation sample is published in, if any.
+    attr_accessor :sample_formats
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'id' => :'id',
         :'version' => :'version',
         :'summary' => :'summary',
-        :'formats' => :'formats'
+        :'formats' => :'formats',
+        :'sample_formats' => :'sample_formats'
       }
     end
 
@@ -51,7 +55,8 @@ module InternetData
         :'id' => :'String',
         :'version' => :'Integer',
         :'summary' => :'String',
-        :'formats' => :'Array<DatabaseFormat>'
+        :'formats' => :'Array<DatabaseFormat>',
+        :'sample_formats' => :'Array<DatabaseFormat>'
       }
     end
 
@@ -102,6 +107,12 @@ module InternetData
       else
         self.formats = nil
       end
+
+      if attributes.key?(:'sample_formats')
+        if (value = attributes[:'sample_formats']).is_a?(Array)
+          self.sample_formats = value
+        end
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -187,7 +198,8 @@ module InternetData
           id == o.id &&
           version == o.version &&
           summary == o.summary &&
-          formats == o.formats
+          formats == o.formats &&
+          sample_formats == o.sample_formats
     end
 
     # @see the `==` method
@@ -199,7 +211,7 @@ module InternetData
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, version, summary, formats].hash
+      [id, version, summary, formats, sample_formats].hash
     end
 
     # Builds the object from hash

data/lib/internetdata/models/db_checksums.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/models/device_authorization.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/models/download.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -22,6 +22,9 @@ module InternetData
 
     attr_accessor :outcome
 
+    # The evaluation sample rather than the database itself.
+    attr_accessor :sample
+
     # Object size at redirect time, NOT bytes delivered: the transfer is a presigned redirect straight to object storage, so we never observe how much of it was taken. 
     attr_accessor :bytes
 
@@ -64,6 +67,7 @@ module InternetData
         :'dataset_id' => :'dataset_id',
         :'format' => :'format',
         :'outcome' => :'outcome',
+        :'sample' => :'sample',
         :'bytes' => :'bytes',
         :'http_status' => :'http_status',
         :'apikey_id' => :'apikey_id',
@@ -89,6 +93,7 @@ module InternetData
         :'dataset_id' => :'String',
         :'format' => :'String',
         :'outcome' => :'String',
+        :'sample' => :'Boolean',
         :'bytes' => :'Integer',
         :'http_status' => :'Integer',
         :'apikey_id' => :'String',
@@ -143,6 +148,12 @@ module InternetData
         self.outcome = nil
       end
 
+      if attributes.key?(:'sample')
+        self.sample = attributes[:'sample']
+      else
+        self.sample = nil
+      end
+
       if attributes.key?(:'bytes')
         self.bytes = attributes[:'bytes']
       else
@@ -197,6 +208,10 @@ module InternetData
         invalid_properties.push('invalid value for "outcome", outcome cannot be nil.')
       end
 
+      if @sample.nil?
+        invalid_properties.push('invalid value for "sample", sample cannot be nil.')
+      end
+
       if @created.nil?
         invalid_properties.push('invalid value for "created", created cannot be nil.')
       end
@@ -213,6 +228,7 @@ module InternetData
       return false if @outcome.nil?
       outcome_validator = EnumAttributeValidator.new('String', ["ok", "unauthorized", "denied", "expired", "unknown", "unavailable"])
       return false unless outcome_validator.valid?(@outcome)
+      return false if @sample.nil?
       return false if @created.nil?
       true
     end
@@ -247,6 +263,16 @@ module InternetData
       @outcome = outcome
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] sample Value to be assigned
+    def sample=(sample)
+      if sample.nil?
+        fail ArgumentError, 'sample cannot be nil'
+      end
+
+      @sample = sample
+    end
+
     # Custom attribute writer method with validation
     # @param [Object] created Value to be assigned
     def created=(created)
@@ -265,6 +291,7 @@ module InternetData
           dataset_id == o.dataset_id &&
           format == o.format &&
           outcome == o.outcome &&
+          sample == o.sample &&
           bytes == o.bytes &&
           http_status == o.http_status &&
           apikey_id == o.apikey_id &&
@@ -282,7 +309,7 @@ module InternetData
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [dataset_id, format, outcome, bytes, http_status, apikey_id, client_ip, user_agent, created].hash
+      [dataset_id, format, outcome, sample, bytes, http_status, apikey_id, client_ip, user_agent, created].hash
     end
 
     # Builds the object from hash

data/lib/internetdata/models/download_list.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/models/error_envelope.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/models/oauth_metadata.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -33,6 +33,9 @@ module InternetData
 
     attr_accessor :code_challenge_methods_supported
 
+    # Any client may sign in with an https `client_id` serving its own metadata.
+    attr_accessor :client_id_metadata_document_supported
+
     # Always `none`. Every client is public and has no secret.
     attr_accessor :token_endpoint_auth_methods_supported
 
@@ -53,6 +56,7 @@ module InternetData
         :'response_types_supported' => :'response_types_supported',
         :'grant_types_supported' => :'grant_types_supported',
         :'code_challenge_methods_supported' => :'code_challenge_methods_supported',
+        :'client_id_metadata_document_supported' => :'client_id_metadata_document_supported',
         :'token_endpoint_auth_methods_supported' => :'token_endpoint_auth_methods_supported',
         :'authorization_response_iss_parameter_supported' => :'authorization_response_iss_parameter_supported',
         :'service_documentation' => :'service_documentation'
@@ -81,6 +85,7 @@ module InternetData
         :'response_types_supported' => :'Array<String>',
         :'grant_types_supported' => :'Array<String>',
         :'code_challenge_methods_supported' => :'Array<String>',
+        :'client_id_metadata_document_supported' => :'Boolean',
         :'token_endpoint_auth_methods_supported' => :'Array<String>',
         :'authorization_response_iss_parameter_supported' => :'Boolean',
         :'service_documentation' => :'String'
@@ -159,6 +164,10 @@ module InternetData
         end
       end
 
+      if attributes.key?(:'client_id_metadata_document_supported')
+        self.client_id_metadata_document_supported = attributes[:'client_id_metadata_document_supported']
+      end
+
       if attributes.key?(:'token_endpoint_auth_methods_supported')
         if (value = attributes[:'token_endpoint_auth_methods_supported']).is_a?(Array)
           self.token_endpoint_auth_methods_supported = value
@@ -248,6 +257,7 @@ module InternetData
           response_types_supported == o.response_types_supported &&
           grant_types_supported == o.grant_types_supported &&
           code_challenge_methods_supported == o.code_challenge_methods_supported &&
+          client_id_metadata_document_supported == o.client_id_metadata_document_supported &&
           token_endpoint_auth_methods_supported == o.token_endpoint_auth_methods_supported &&
           authorization_response_iss_parameter_supported == o.authorization_response_iss_parameter_supported &&
           service_documentation == o.service_documentation
@@ -262,7 +272,7 @@ module InternetData
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [issuer, authorization_endpoint, token_endpoint, device_authorization_endpoint, revocation_endpoint, scopes_supported, response_types_supported, grant_types_supported, code_challenge_methods_supported, token_endpoint_auth_methods_supported, authorization_response_iss_parameter_supported, service_documentation].hash
+      [issuer, authorization_endpoint, token_endpoint, device_authorization_endpoint, revocation_endpoint, scopes_supported, response_types_supported, grant_types_supported, code_challenge_methods_supported, client_id_metadata_document_supported, token_endpoint_auth_methods_supported, authorization_response_iss_parameter_supported, service_documentation].hash
     end
 
     # Builds the object from hash

data/lib/internetdata/models/standing.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/internetdata/models/token_response.rb

@@ -3,7 +3,7 @@
 
 #The InternetData API: download the databases your organization is licensed for, and manage the account behind them.  See https://docs.internetdata.io for guides and https://github.com/internetdata for the official client libraries. 
 
-The version of the OpenAPI document: 2026.09.21
+The version of the OpenAPI document: 2026.09.26
 Contact: support@internetdata.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -29,10 +29,10 @@ module InternetData
     # What was actually granted, which may be narrower than what was asked for.
     attr_accessor :scope
 
-    # Not part of OAuth. The ID of the API key the person picked when they approved, returned by every grant while this authorization may still read that key back. Absent when no key was picked, or when the person's role no longer allows reading keys back. 
+    # Not part of OAuth, and only for our own clients. The ID of the API key the person picked when they approved, returned by every grant while this authorization may still read that key back. Absent when no key was picked, or when the person's role no longer allows reading keys back. 
     attr_accessor :apikey_id
 
-    # Not part of OAuth. The API key itself, so a device ends up holding an ordinary key. Returned by the device code and authorization code grants only, never by a refresh, and only alongside `mslm:apikey_id`. Absent when that key's secret cannot be read back, which is the case for a key created before keys could be shown again in the console; a rotated key can be. 
+    # Not part of OAuth, and only for our own clients: a client that signed in with a Client ID Metadata Document never receives a key. The API key itself, so a device ends up holding an ordinary key. Returned by the device code and authorization code grants only, never by a refresh, and only alongside `mslm:apikey_id`. Absent when that key's secret cannot be read back, which is the case for a key created before keys could be shown again in the console; a rotated key can be. 
     attr_accessor :apikey
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/internetdata/oauth_api.rb

@@ -17,6 +17,8 @@ module InternetData
     TOKEN_PATH = '/oauth/token'
     REVOKE_PATH = '/oauth/revoke'
     DEVICE_CODE_GRANT = 'urn:ietf:params:oauth:grant-type:device_code'
+    # The longest single `sleep` the poll asks Ruby for, in seconds.
+    LONGEST_SLEEP = 2**31 - 1
 
     # The members a 2xx must carry for its type to mean anything.
     REQUIRED = {
@@ -29,7 +31,7 @@ module InternetData
       @transport = transport
       @retries = retries
       # The poll's wait and its monotonic clock, which a test replaces together.
-      @wait = ->(seconds) { sleep(seconds) }
+      @wait = ->(seconds) { sleep_in_parts(seconds) }
       @now = -> { Process.clock_gettime(Process::CLOCK_MONOTONIC) }
     end
 
@@ -96,7 +98,8 @@ module InternetData
     # Wait for the person to approve a device sign-in, and return its tokens.
     #
     # Waits `device.interval` seconds before EVERY exchange, the first included,
-    # and five seconds longer for good each time the server answers `slow_down`.
+    # and five seconds longer for good each time the server answers `slow_down`,
+    # but never past `device.expires_in`: a wait that would end later ends then.
     # Raises {OauthAccessDeniedError} when the person refuses and
     # {OauthExpiredTokenError} when the code expires, including locally, with no
     # status, once `device.expires_in` seconds have passed since this call. Any
@@ -109,10 +112,14 @@ module InternetData
     # @param timeout [Numeric, nil] bounds each exchange, never the whole wait.
     # @return [TokenResponse]
     def poll_device_token(client_id, device, timeout: nil)
+      Transport.checked_timeout(timeout) unless timeout.nil?
       interval = device.interval >= 1 ? device.interval : 5
       deadline = @now.call + device.expires_in
       loop do
-        @wait.call(interval)
+        # A wait that would end past the deadline waits only the time left, never
+        # a negative remainder, and the local expiry below follows with no request.
+        left = deadline - @now.call
+        @wait.call(interval < left ? interval : [left, 0].max)
         raise OauthExpiredTokenError, 'expired_token' if @now.call >= deadline
 
         begin
@@ -129,6 +136,17 @@ module InternetData
 
     private
 
+    # `sleep` raises RangeError for a Float from about 9.2e18 s and an Integer
+    # past 2**63 - 1, and a server's `expires_in` can leave a wait longer than
+    # either, so a long one is slept in parts rather than ending the poll.
+    def sleep_in_parts(seconds)
+      while seconds.positive?
+        part = [seconds, LONGEST_SLEEP].min
+        sleep(part)
+        seconds -= part
+      end
+    end
+
     def exchange(form, timeout)
       decode(TokenResponse, @transport.oauth_request(:POST, TOKEN_PATH, form: form, timeout: timeout).run)
     end

data/lib/internetdata/retries.rb

@@ -9,6 +9,10 @@ module InternetData
   module Retries
     BACKOFF_SECONDS = 0.25
 
+    # The longest `Retry-After` honored, in seconds: 2**31 - 1 ms, about 24.8
+    # days, the same bound as the .NET, erlang and perl SDKs'.
+    LONGEST_WAIT = 2_147_483.647
+
     module_function
 
     # `retry_if`, when given, is asked after each retryable failure, and a false
@@ -26,10 +30,16 @@ module InternetData
       end
     end
 
-    # A server-supplied delay always wins, including a `Retry-After: 0`, which
-    # is the server saying "immediately" rather than saying nothing.
+    # A server-supplied delay wins, including a `Retry-After: 0`, which is the
+    # server saying "immediately" rather than saying nothing. One past
+    # LONGEST_WAIT is waited out on the backoff instead, still rate_limited:
+    # honored, `2147483648` held the call for 68 years, and `sleep` raised a raw
+    # RangeError for `9223372036854775807`.
     def delay_for(error, attempt)
-      error.retry_after_seconds || BACKOFF_SECONDS * (2**(attempt - 1))
+      asked = error.retry_after_seconds
+      return asked if asked && asked <= LONGEST_WAIT
+
+      BACKOFF_SECONDS * (2**(attempt - 1))
     end
   end
 end

data/lib/internetdata/transport.rb

@@ -7,6 +7,23 @@ module InternetData
   # The generated wire client, with the three things it gets wrong for this API
   # corrected in one place.
   class Transport < ApiClient
+    # The longest `timeout` curl holds, in seconds: 2**31 - 1 ms, about 24.8 days.
+    # libcurl refuses a longer one, and any negative, and Ethon ignores the
+    # refusal, so the call would run with no bound at all.
+    LONGEST_TIMEOUT = 2_147_483.647
+
+    # `timeout`, once it is a bound curl can hold: seconds, 0 for none. Refused
+    # where it is set, because nothing downstream refuses it: a negative ran with
+    # no bound, and NaN, Infinity, a number past curl's ceiling or a string failed
+    # every call with an error from Ruby, FFI or Ethon that names none of this.
+    # NaN fails both comparisons, and an infinity one of them.
+    def self.checked_timeout(timeout)
+      return timeout if timeout.is_a?(Numeric) && timeout.real? && timeout >= 0 && timeout <= LONGEST_TIMEOUT
+
+      raise ArgumentError,
+            "timeout must be a number of seconds from 0 (no bound) to #{LONGEST_TIMEOUT}, not #{timeout.inspect}"
+    end
+
     # The generated Configuration applies a security scheme whatever it holds, so
     # a keyless client would send `Authorization: Bearer ` - an empty credential,
     # which the API answers 401 to rather than treating as no credential at all.
@@ -19,7 +36,7 @@ module InternetData
         self.host = uri.port == uri.default_port ? uri.host : "#{uri.host}:#{uri.port}"
         self.base_path = uri.path
         self.access_token = api_key
-        self.timeout = timeout
+        self.timeout = timeout.nil? ? nil : Transport.checked_timeout(timeout)
       end
 
       # ONLY the bearer scheme, never `super`.
@@ -59,7 +76,7 @@ module InternetData
     def build_request(http_method, path, opts = {})
       request = super
       request.options[:followlocation] = false
-      request.options[:timeout] = opts[:timeout] unless opts[:timeout].nil?
+      request.options[:timeout] = Transport.checked_timeout(opts[:timeout]) unless opts[:timeout].nil?
       request
     end
 

data/lib/internetdata/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module InternetData
-  VERSION = '2.3.1'
+  VERSION = '2.4.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: internetdata
 version: !ruby/object:Gem::Version
-  version: 2.3.1
+  version: 2.4.0
 platform: ruby
 authors:
 - Mslm Dev