vpndetection 5.11.2 → 5.11.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1790fe45568e0bb346e2215405578d4b59201ed4ecff60fe742a47562c1d2c7e
-  data.tar.gz: 6ca815855814e7682b1411f6140855632260c47962441e122746be47998d6b08
+  metadata.gz: a47a7c7b2838b48e5c03f88bcf23f32aa5ded757e0a0456a690f7062d76f5246
+  data.tar.gz: 18d367fb37429592a2554219878de911142712c3a499b4b271c7830638eeed9e
 SHA512:
-  metadata.gz: 0fcd4b52863e0ca78417823d7df8aad76d717fe097036d90d4e37ead2c42900c6c23e6798e36e35d2d99200f66171e65655c506a501cd8d9f7d089a0ade96732
-  data.tar.gz: 5dd04eca217c3f2df8a6bd11a439368d4bdcab9af9264e49222fccbbd496fb4a627ed423c372c3dff2de0e2e9fdb99e2ff89fd79d87b3275d3e566f87aac061f
+  metadata.gz: c20ec207aef30b6204342f3fced3fc7d1a8c9cdafb79b071194a13c1fb6ce91ac3b43806ec258a1eb9028e7235ce8bfeeca3119ca498bbb07acc007bd27f642b
+  data.tar.gz: 9b15d2d5c30082b861b2e50c070d07a0b343662af736115b1fdfbcffd5359f67fa809c61e3956a7f5a80bef76a8b4cb7373e311806a88bb413a1a36f72418518

data/README.md

@@ -5,7 +5,7 @@
 
 The official Ruby client library for the [VPNDetection](https://vpndetection.io) API.
 
-The library helps you query VPNDetection's APIs for anonymity detection including VPNs, residential proxies, Tor nodes, hosting servers, CDNs, relays and more.
+It tells you whether an IP address is a VPN, residential proxy, Tor node, relay or hosting server.
 
 ## Getting Started
 
@@ -161,11 +161,11 @@ client = VPNDetection::Client.new(timeout: 10, retries: 4)
 result = client.lookup('45.83.91.1', timeout: 2, retries: 0)
 ```
 
-`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; before 5.2.0 the default was 10, so pass `timeout: 10` to keep that bound. The client's values are defaults: `lookup`, `lookup_batch`, `my_ip` and `my_entitlement` each take `timeout:` and `retries:` for that call alone, and every `client.oauth` method and every `client.database` call that is not a transfer takes `timeout:` (from 5.3.0). A database download bounds only its connection with it, because a whole transfer can take minutes. 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.
+`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; before 5.2.0 the default was 10, so pass `timeout: 10` to keep that bound. The client's values are defaults: `lookup`, `lookup_batch`, `my_ip` and `my_entitlement` each take `timeout:` and `retries:` for that call alone, and every `client.oauth` method and every `client.database` call that is not a transfer takes `timeout:` (from 5.3.0). A database download bounds only its connection with it, because a whole transfer can take minutes. 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. So does a `retries` that isn't an Integer from 0 (from 5.11.3), and a `concurrency` that isn't an Integer from 1 given to `Client.new`, which `lookup_batch` refuses as `:bad_request` (from 5.11.4).
 
 ### Database downloads
 
-If your key carries the `db.download` scope, the licensed databases are available through `client.database`. A license covers a database FAMILY and a download names one of its versions, so the id comes from `versions`:
+If your key carries the `db.download` scope, the licensed databases are available through `client.database`. A license covers a database FAMILY and a download names one of its versions, so the ID comes from `versions`:
 
 ```ruby
 family = client.database.list.first

data/lib/vpndetection/api/account_wire_api.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api/api_keys_wire_api.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -146,7 +146,7 @@ module VPNDetection
 
     # Reveal
     # Returns an existing key's secret.  Its own scope rather than part of `apikeys.manage`, because the two are different acts: rotating replaces a secret you never see, while this hands one over.  Refused with `NOT_RETRIEVABLE` for a key issued before this product stored secrets recoverably - that secret was never kept, so no retry will ever produce it. Rotate the key instead. 
-    # @param id [String] The key's id, as returned by the list endpoint. Never the key itself.
+    # @param id [String] The key's ID, as returned by the list endpoint. Never the key itself.
     # @param [Hash] opts the optional parameters
     # @return [AccountRevealedApikey]
     def account_reveal_apikey(id, opts = {})
@@ -156,7 +156,7 @@ module VPNDetection
 
     # Reveal
     # Returns an existing key's secret.  Its own scope rather than part of `apikeys.manage`, because the two are different acts: rotating replaces a secret you never see, while this hands one over.  Refused with `NOT_RETRIEVABLE` for a key issued before this product stored secrets recoverably - that secret was never kept, so no retry will ever produce it. Rotate the key instead. 
-    # @param id [String] The key's id, as returned by the list endpoint. Never the key itself.
+    # @param id [String] The key's ID, as returned by the list endpoint. Never the key itself.
     # @param [Hash] opts the optional parameters
     # @return [Array<(AccountRevealedApikey, Integer, Hash)>] AccountRevealedApikey data, response status code and response headers
     def account_reveal_apikey_with_http_info(id, opts = {})
@@ -209,7 +209,7 @@ module VPNDetection
 
     # Revoke
     # Stops the key working. Revocation is soft: the key stays listed with a `revoked_at`, because the organization still owns whatever it did while it was alive. 
-    # @param id [String] The key&#39;s id, as returned by the list endpoint. Never the key itself.
+    # @param id [String] The key&#39;s ID, as returned by the list endpoint. Never the key itself.
     # @param [Hash] opts the optional parameters
     # @return [AccountRc]
     def account_revoke_apikey(id, opts = {})
@@ -219,7 +219,7 @@ module VPNDetection
 
     # Revoke
     # Stops the key working. Revocation is soft: the key stays listed with a &#x60;revoked_at&#x60;, because the organization still owns whatever it did while it was alive. 
-    # @param id [String] The key&#39;s id, as returned by the list endpoint. Never the key itself.
+    # @param id [String] The key&#39;s ID, as returned by the list endpoint. Never the key itself.
     # @param [Hash] opts the optional parameters
     # @return [Array<(AccountRc, Integer, Hash)>] AccountRc data, response status code and response headers
     def account_revoke_apikey_with_http_info(id, opts = {})
@@ -271,8 +271,8 @@ module VPNDetection
     end
 
     # Rotate
-    # Replaces the secret behind a key, keeping its id, name and settings. The previous secret stops working immediately. The new secret comes back in the answer, so this needs `apikeys.reveal` as well as `apikeys.manage`. 
-    # @param id [String] The key&#39;s id, as returned by the list endpoint. Never the key itself.
+    # Replaces the secret behind a key, keeping its ID, name and settings. The previous secret stops working immediately. The new secret comes back in the answer, so this needs `apikeys.reveal` as well as `apikeys.manage`. 
+    # @param id [String] The key&#39;s ID, as returned by the list endpoint. Never the key itself.
     # @param [Hash] opts the optional parameters
     # @return [AccountCreatedApikey]
     def account_rotate_apikey(id, opts = {})
@@ -281,8 +281,8 @@ module VPNDetection
     end
 
     # Rotate
-    # Replaces the secret behind a key, keeping its id, name and settings. The previous secret stops working immediately. The new secret comes back in the answer, so this needs &#x60;apikeys.reveal&#x60; as well as &#x60;apikeys.manage&#x60;. 
-    # @param id [String] The key&#39;s id, as returned by the list endpoint. Never the key itself.
+    # Replaces the secret behind a key, keeping its ID, name and settings. The previous secret stops working immediately. The new secret comes back in the answer, so this needs &#x60;apikeys.reveal&#x60; as well as &#x60;apikeys.manage&#x60;. 
+    # @param id [String] The key&#39;s ID, as returned by the list endpoint. Never the key itself.
     # @param [Hash] opts the optional parameters
     # @return [Array<(AccountCreatedApikey, Integer, Hash)>] AccountCreatedApikey data, response status code and response headers
     def account_rotate_apikey_with_http_info(id, opts = {})

data/lib/vpndetection/api/authorization_wire_api.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api/database_wire_api.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -156,8 +156,8 @@ module VPNDetection
 
     # Download
     # Answers `302` with a time-limited URL pointing straight at object storage. Follow the redirect; the link authorizes the START of a transfer, so one already running is not interrupted when it lapses. 
-    # @param id [String] Dataset id, e.g. vpn_ip_extended_v1
-    # @param format [DatabaseFormat] Not every database is built in every format. The `_provider` catalogs are keyed by provider id rather than by IP range, so no MMDB exists for them. 
+    # @param id [String] Dataset ID, e.g. vpn_ip_extended_v1
+    # @param format [DatabaseFormat] Not every database is built in every format. The `_provider` catalogs are keyed by provider ID rather than by IP range, so no MMDB exists for them. 
     # @param [Hash] opts the optional parameters
     # @return [nil]
     def download_database(id, format, opts = {})
@@ -167,8 +167,8 @@ module VPNDetection
 
     # Download
     # Answers `302` with a time-limited URL pointing straight at object storage. Follow the redirect; the link authorizes the START of a transfer, so one already running is not interrupted when it lapses. 
-    # @param id [String] Dataset id, e.g. vpn_ip_extended_v1
-    # @param format [DatabaseFormat] Not every database is built in every format. The `_provider` catalogs are keyed by provider id rather than by IP range, so no MMDB exists for them. 
+    # @param id [String] Dataset ID, e.g. vpn_ip_extended_v1
+    # @param format [DatabaseFormat] Not every database is built in every format. The `_provider` catalogs are keyed by provider ID rather than by IP range, so no MMDB exists for them. 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def download_database_with_http_info(id, format, opts = {})

data/lib/vpndetection/api/entitlement_wire_api.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api/lookup_wire_api.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api/organization_wire_api.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api_client.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api_error.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api_model_base.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/client.rb

@@ -28,10 +28,10 @@ module VPNDetection
     #   address. It is trimmed, and a key of blanks alone is no key.
     # @param cache [Boolean] pass false to disable caching.
     # @param cache_ttl [Numeric] how long an answer stays fresh, in seconds.
-    # @param concurrency [Integer] batch requests - chunks of up to 1000 addresses - in flight during a batch.
-    # @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 concurrency [Integer] batch requests - chunks of up to 1000 addresses - in flight during a batch, from 1.
+    # @param retries [Integer] extra attempts for a transient failure, from 0. 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 one request may take before it is
     #   abandoned, 0 for no bound. Applies per ATTEMPT, so a retried call may take
     #   longer in total, and every call that takes `retries:` also takes
@@ -40,12 +40,19 @@ module VPNDetection
     # @raise [ArgumentError] for an `api_key` with a control character in it.
     # @raise [ArgumentError] for a `timeout`, here or on any call, that is
     #   negative, not a finite number, or past 2147483.647 seconds (2**31 - 1 ms),
-    #   the longest curl holds.
+    #   the longest curl holds, for a `retries`, here or on any call, that is
+    #   not an Integer from 0, and for a `concurrency` that is not an Integer
+    #   from 1.
     # @param transport [Transport, nil] override the HTTP layer, mostly for tests.
     def initialize(api_key: nil, base_url: DEFAULT_BASE_URL, cache: true,
                    cache_max_size: DEFAULT_CACHE_MAX_SIZE, cache_ttl: DEFAULT_CACHE_TTL,
                    concurrency: DEFAULT_CONCURRENCY, retries: DEFAULT_RETRIES,
                    timeout: DEFAULT_TIMEOUT, transport: nil)
+      retries = Retries.checked_count(retries)
+      # Refused where it is set: through 5.11.3 each batch refused it instead.
+      unless concurrency?(concurrency)
+        raise ArgumentError, "concurrency must be an Integer from 1, not #{concurrency.inspect}"
+      end
       @transport = transport || Transport.new(
         Transport::Config.new(api_key: api_key, base_url: base_url, timeout: timeout),
       )
@@ -80,6 +87,7 @@ module VPNDetection
     def lookup(ip, retries: nil, timeout: nil)
       # Here as well as in the transport: a bogon or a cached answer returns before any request.
       Transport.checked_timeout(timeout) unless timeout.nil?
+      Retries.checked_count(retries) unless retries.nil?
       # Judged, cached and sent as the IPv4 address it carries, if it is mapped.
       ip = Bogon.unmapped(ip)
       return Bogon.result(ip) if Bogon.bogon?(ip)
@@ -117,6 +125,7 @@ module VPNDetection
     # this is IS the question: a machine that moves between networks would
     # otherwise be told where it used to be.
     def my_ip(retries: nil, timeout: nil)
+      Retries.checked_count(retries) unless retries.nil?
       Retries.with_retries(retries || @retries) do
         Transport.lookup_result(@transport.myip_request(timeout: timeout).run)
       end
@@ -142,6 +151,7 @@ module VPNDetection
     #
     # @return [Entitlement]
     def my_entitlement(retries: nil, timeout: nil)
+      Retries.checked_count(retries) unless retries.nil?
       Retries.with_retries(retries || @retries) do
         Transport.entitlement_result(@transport.entitlement_request(timeout: timeout).run)
       end
@@ -158,17 +168,19 @@ module VPNDetection
     # per-entry failure with the status the single lookup would have answered,
     # and a chunk that fails as a whole marks every address in it.
     #
-    # @param concurrency [Integer, nil] chunks in flight, for THIS batch only. Below 1
-    #   is refused as `:bad_request` before any request, since nothing could ever run.
+    # @param concurrency [Integer, nil] chunks in flight, for THIS batch only.
+    #   Anything but an Integer from 1 is refused as `:bad_request` before any
+    #   request, and before a bogon or a cached answer is returned.
     # @param retries [Integer, nil] extra attempts for a failed chunk, for THIS batch only.
     # @param timeout [Numeric, nil] seconds each chunk's attempt may take, for THIS batch only.
     # @return [Hash{String => Result, Error}] in the order the addresses were given
     def lookup_batch(ips, concurrency: nil, retries: nil, timeout: nil)
       limit = concurrency || @concurrency
-      unless limit.is_a?(Numeric) && limit >= 1
-        raise Error.new(:bad_request, "concurrency must be at least 1, not #{limit.inspect}")
+      unless concurrency?(limit)
+        raise Error.new(:bad_request, "concurrency must be an Integer from 1, not #{limit.inspect}")
       end
       Transport.checked_timeout(timeout) unless timeout.nil?
+      Retries.checked_count(retries) unless retries.nil?
 
       # An IPv4-mapped address is sent as the address it carries, once however
       # many of its spellings were asked, and answered under each one asked.
@@ -210,6 +222,12 @@ module VPNDetection
 
     private
 
+    # Whether `value` can be a batch's concurrency: chunks in flight are counted
+    # whole, and a hydra allowed fewer than one runs nothing.
+    def concurrency?(value)
+      value.is_a?(Integer) && value >= 1
+    end
+
     # Concurrent misses for one address share ONE request: 5.4.2 sent one per
     # calling thread. The first miss boards the
     # address and every miss after it, a batch's included, waits on its Flight.

data/lib/vpndetection/configuration.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/database_api.rb

@@ -22,7 +22,7 @@ module VPNDetection
     # The database FAMILIES your organization is licensed to download.
     #
     # A license is held against the family, while a download names one version,
-    # so the ids {#download}, {#download_bytes}, {#download_url} and {#checksums}
+    # so the IDs {#download}, {#download_bytes}, {#download_url} and {#checksums}
     # take come from each family's `versions`, not from the family itself.
     #
     # @param timeout [Numeric, nil] seconds this attempt may take, for THIS call only.

data/lib/vpndetection/errors.rb

@@ -53,7 +53,7 @@ module VPNDetection
       when 401 then :unauthorized
       when 403 then :forbidden
       # Every other 4xx is a CLIENT error. Classifying on the RANGE rather than
-      # on an enumerated list is what keeps a 404 from a bad dataset id falling
+      # on an enumerated list is what keeps a 404 from a bad dataset ID falling
       # through to the retryable server_error default and being retried twice
       # before it fails.
       when 400..499 then :bad_request

data/lib/vpndetection/middleware/core.rb

@@ -40,6 +40,7 @@ module VPNDetection
         @skip = options[:skip]
         @on_warn = options[:on_warn]
         @retries = options.fetch(:retries, DEFAULT_RETRIES)
+        Retries.checked_count(@retries) unless @retries.nil?
         @warned = {}
         @client = options[:client] || Client.new(
           api_key: options[:api_key],

data/lib/vpndetection/models/account_create_apikey_request.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_created_apikey.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_org.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_org_ref.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_org_wrap.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_rc.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_revealed_apikey.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_user.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/apikey_detail.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/apikey_list.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/asn.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/batch_lookup_error.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/batch_lookup_request.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/batch_lookup_response.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/class_detail.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/client_registration.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/client_registration_request.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module VPNDetection
-  # One database FAMILY, with your organization's license beside it. A license covers the family, while a download names a specific version, so the ids you pass to the download and checksum endpoints come from `versions`. 
+  # One database FAMILY, with your organization's license beside it. A license covers the family, while a download names a specific version, so the IDs you pass to the download and checksum endpoints come from `versions`. 
   class Database < ApiModelBase
     # The database family, e.g. `vpn_ip`. What the license is held against.
     attr_accessor :base

data/lib/vpndetection/models/database_checksums_response.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_format.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_format_size.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_list.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_metadata.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_metadata_column.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_version.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -15,7 +15,7 @@ require 'time'
 
 module VPNDetection
   class DatabaseVersion < ApiModelBase
-    # The versioned database id, e.g. `vpn_ip_v1`. Pass this to download.
+    # The versioned database ID, e.g. `vpn_ip_v1`. Pass this to download.
     attr_accessor :id
 
     attr_accessor :version

data/lib/vpndetection/models/db_checksums.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/device_authorization.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/download.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/download_list.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/entitlement.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/entitlement_apikey.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module VPNDetection
-  # The credential itself. The key is never echoed - only its id, which is what the console shows and what you can act on. 
+  # The credential itself. The key is never echoed - only its ID, which is what the console shows and what you can act on. 
   class EntitlementApikey < ApiModelBase
     attr_accessor :id
 

data/lib/vpndetection/models/entitlement_error.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/entitlement_plan.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/entitlement_usage.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/error_envelope.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/identity.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/location.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/lookup_error.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/lookup_response.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/oauth_error.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/oauth_metadata.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/proxy_detail.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/pubproxy_detail.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/standing.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/token_response.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/vpn_detail.rb

@@ -3,7 +3,7 @@
 
 #The VPNDetection API: classify any IP address, and download the databases behind the answers.  See https://docs.vpndetection.io for guides and https://github.com/vpndetection-io for the official client libraries. 
 
-The version of the OpenAPI document: 2026.10.25
+The version of the OpenAPI document: 2026.11.02
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/retries.rb

@@ -5,7 +5,7 @@ module VPNDetection
   #
   # Only a 5xx, a transport failure and a 429 that carried `Retry-After` are
   # worth another attempt. Every other 4xx is a client error and fails on the
-  # first try, so a bad dataset id is not asked for three times.
+  # first try, so a bad dataset ID is not asked for three times.
   module Retries
     BACKOFF_SECONDS = 0.25
 
@@ -15,6 +15,15 @@ module VPNDetection
 
     module_function
 
+    # `retries`, once it is a count. Refused where it is set: unchecked, -1 and
+    # NaN read as none, 1.5 as two, Infinity retried a failing call for good, and
+    # a String or nil raised a raw ArgumentError out of every failing call.
+    def checked_count(retries)
+      return retries if retries.is_a?(Integer) && retries >= 0
+
+      raise ArgumentError, "retries must be an Integer from 0, not #{retries.inspect}"
+    end
+
     # `retry_if`, when given, is asked after each retryable failure, and a false
     # answer ends the attempts there.
     def with_retries(retries, retry_if: nil)

data/lib/vpndetection/transport.rb

@@ -367,7 +367,9 @@ module VPNDetection
         when 'Integer' then value.is_a?(Integer)
         when 'Float' then value.is_a?(Numeric)
         when 'Boolean' then [true, false].include?(value)
-        when 'Object' then true
+        # The spec's `type: object`, a sample row: through 5.11.2 a row of 1, "x"
+        # or [] came back as the answer.
+        when 'Object' then value.is_a?(Hash)
         when /\AArray<(?<inner>.+)>\z/
           inner = Regexp.last_match(:inner)
           value.is_a?(Array) && value.each_with_index.all? { |v, i| check_type!(v, inner, "#{where}[#{i}]") }

data/lib/vpndetection/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module VPNDetection
-  VERSION = '5.11.2'
+  VERSION = '5.11.4'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vpndetection
 version: !ruby/object:Gem::Version
-  version: 5.11.2
+  version: 5.11.4
 platform: ruby
 authors:
 - Mslm Dev