RubyGems - vpndetection - Versions diffs - 5.4.0 → 5.4.2 - Mend

vpndetection 5.4.0 → 5.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (61) hide show

checksums.yaml +4 -4
data/README.md +2 -2
data/lib/vpndetection/api/account_wire_api.rb +1 -1
data/lib/vpndetection/api/api_keys_wire_api.rb +1 -1
data/lib/vpndetection/api/authorization_wire_api.rb +1 -1
data/lib/vpndetection/api/database_wire_api.rb +3 -3
data/lib/vpndetection/api/entitlement_wire_api.rb +1 -1
data/lib/vpndetection/api/lookup_wire_api.rb +1 -1
data/lib/vpndetection/api/organization_wire_api.rb +1 -1
data/lib/vpndetection/api_client.rb +1 -1
data/lib/vpndetection/api_error.rb +1 -1
data/lib/vpndetection/api_model_base.rb +1 -1
data/lib/vpndetection/client.rb +13 -4
data/lib/vpndetection/configuration.rb +1 -1
data/lib/vpndetection/database_api.rb +2 -1
data/lib/vpndetection/models/account_create_apikey_request.rb +1 -1
data/lib/vpndetection/models/account_created_apikey.rb +1 -1
data/lib/vpndetection/models/account_org.rb +1 -1
data/lib/vpndetection/models/account_org_ref.rb +1 -1
data/lib/vpndetection/models/account_org_wrap.rb +1 -1
data/lib/vpndetection/models/account_rc.rb +1 -1
data/lib/vpndetection/models/account_revealed_apikey.rb +1 -1
data/lib/vpndetection/models/account_user.rb +1 -1
data/lib/vpndetection/models/apikey_detail.rb +1 -1
data/lib/vpndetection/models/apikey_list.rb +1 -1
data/lib/vpndetection/models/batch_lookup_error.rb +1 -1
data/lib/vpndetection/models/batch_lookup_request.rb +1 -1
data/lib/vpndetection/models/batch_lookup_response.rb +1 -1
data/lib/vpndetection/models/class_detail.rb +1 -1
data/lib/vpndetection/models/database.rb +2 -2
data/lib/vpndetection/models/database_checksums_response.rb +1 -1
data/lib/vpndetection/models/database_format.rb +1 -1
data/lib/vpndetection/models/database_format_size.rb +1 -1
data/lib/vpndetection/models/database_list.rb +1 -1
data/lib/vpndetection/models/database_metadata.rb +1 -1
data/lib/vpndetection/models/database_metadata_column.rb +1 -1
data/lib/vpndetection/models/database_version.rb +1 -1
data/lib/vpndetection/models/db_checksums.rb +1 -1
data/lib/vpndetection/models/device_authorization.rb +1 -1
data/lib/vpndetection/models/download.rb +1 -1
data/lib/vpndetection/models/download_list.rb +1 -1
data/lib/vpndetection/models/entitlement.rb +1 -1
data/lib/vpndetection/models/entitlement_apikey.rb +1 -1
data/lib/vpndetection/models/entitlement_error.rb +1 -1
data/lib/vpndetection/models/entitlement_plan.rb +1 -1
data/lib/vpndetection/models/entitlement_usage.rb +1 -1
data/lib/vpndetection/models/error_envelope.rb +1 -1
data/lib/vpndetection/models/identity.rb +1 -1
data/lib/vpndetection/models/lookup_error.rb +1 -1
data/lib/vpndetection/models/lookup_response.rb +1 -1
data/lib/vpndetection/models/oauth_error.rb +1 -1
data/lib/vpndetection/models/oauth_metadata.rb +1 -1
data/lib/vpndetection/models/proxy_detail.rb +1 -1
data/lib/vpndetection/models/standing.rb +1 -1
data/lib/vpndetection/models/token_response.rb +1 -1
data/lib/vpndetection/models/vpn_detail.rb +1 -1
data/lib/vpndetection/oauth_api.rb +21 -3
data/lib/vpndetection/retries.rb +13 -3
data/lib/vpndetection/transport.rb +19 -2
data/lib/vpndetection/version.rb +1 -1
metadata +1 -1

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1a72dc0f5b07ed01b35b61d0cc8a50fda1f1872a18af970690499e0823abc77
-  data.tar.gz: 96a2bbd19642f678ce5f60a8898662a84b27f50cd0d129bc8eaaafaea9fab59b
+  metadata.gz: 2ccf5841f50ec64ff7328341110f3ec6cd0affc6260a0588fe22cb746d5d62f1
+  data.tar.gz: 99459a01b5d0139a64d039a2259a08c965cd4319c9cae6283dbbc0b113ac5b2c
 SHA512:
-  metadata.gz: 7aa1e6b3fe0e4c2b210b9c0a61a28d5d997b794265eb8b40d64d0838834adf850f15854bf267d1b72aafee6af864b6b3c07f2c9b983c39be5d2993ae2c22bb2d
-  data.tar.gz: 42b9392f37d9baffbe6e8aa94d032c6173f1435fa5f0017122c9df8f422bfc6670712487a79617daea87ffd52d225ccc36cccae57cebfe2028f792c08ead26d0
+  metadata.gz: fbdbee3d38ba2e223be9fc4e1cb53193f71e1891f0e59351d4c59f2eb2a8cc418476f48e0b866fb7c0b6d36fbb166686c46c22049deae80403f8a9a0675ab797
+  data.tar.gz: 94d1e3c266372d5b7fe571ea2d370a38dbd91cd11f184f3f06ef7b3f231ddddbc6a261551185a9020453d0704d8911c6c8b21e6de569cb43d4a4cba562d6684f

data/README.md CHANGED Viewed

@@ -150,7 +150,7 @@ end
 `kind` is one of `:bad_request`, `:unauthorized`, `:forbidden`, `:rate_limited`, `:quota_exceeded`, `:server_error` or `:network`.
-Note that `:rate_limited` and `:quota_exceeded` both arrive as HTTP 429 and are not the same thing. A rate limit is when the API faces extreme traffic bursts and so retrying later works; but a spent quota needs your allowance raised or the window to roll over. The library retries rate limits for you, but not if your quota is exceeded.
+Note that `:rate_limited` and `:quota_exceeded` both arrive as HTTP 429 and are not the same thing. A rate limit is when the API faces extreme traffic bursts and so retrying later works; but a spent quota needs your allowance raised or the window to roll over. The library retries rate limits for you, but not if your quota is exceeded. It waits the `Retry-After` the API sent, or its own backoff from 250 ms when that's past about 24.8 days.
 ### Timeouts and retries
@@ -160,7 +160,7 @@ 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; 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.
+`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.
 ### Database downloads

data/lib/vpndetection/api/account_wire_api.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api/api_keys_wire_api.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api/authorization_wire_api.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api/database_wire_api.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -226,7 +226,7 @@ module VPNDetection
     end
     # List
-    # Every database this organization may SEE, with where its licence stands. Not just the ones you hold: a customer with one grant should be able to tell what else is published without asking. `standing` is the difference - `licensed`, `expired`, or `unlicensed` for one never bought.
+    # Every database this organization may SEE, with where its license stands. Not just the ones you hold: a customer with one grant should be able to tell what else is published without asking. `standing` is the difference - `licensed`, `expired`, or `unlicensed` for one never bought.
     # @param [Hash] opts the optional parameters
     # @return [DatabaseList]
     def list_databases(opts = {})
@@ -235,7 +235,7 @@ module VPNDetection
     end
     # List
-    # Every database this organization may SEE, with where its licence stands. Not just the ones you hold: a customer with one grant should be able to tell what else is published without asking. &#x60;standing&#x60; is the difference - &#x60;licensed&#x60;, &#x60;expired&#x60;, or &#x60;unlicensed&#x60; for one never bought.
+    # Every database this organization may SEE, with where its license stands. Not just the ones you hold: a customer with one grant should be able to tell what else is published without asking. &#x60;standing&#x60; is the difference - &#x60;licensed&#x60;, &#x60;expired&#x60;, or &#x60;unlicensed&#x60; for one never bought.
     # @param [Hash] opts the optional parameters
     # @return [Array<(DatabaseList, Integer, Hash)>] DatabaseList data, response status code and response headers
     def list_databases_with_http_info(opts = {})

data/lib/vpndetection/api/entitlement_wire_api.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api/lookup_wire_api.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api/organization_wire_api.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api_client.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api_error.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/api_model_base.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/client.rb CHANGED Viewed

@@ -29,11 +29,17 @@ module VPNDetection
     # @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.
+    # @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 one request may take before it is
-    #   abandoned. Applies per ATTEMPT, so a retried call may take longer in
-    #   total, and every call that takes `retries:` also takes `timeout:` to
-    #   override it. A dataset transfer bounds only its connect phase with it.
+    #   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
+    #   `timeout:` to override it. A dataset transfer bounds only its connect
+    #   phase with 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.
     # @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,
@@ -68,6 +74,8 @@ module VPNDetection
     # @param retries [Integer, nil] extra attempts, for THIS call only.
     # @param timeout [Numeric, nil] seconds each attempt may take, for THIS call only.
     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?
       return Bogon.result(ip) if Bogon.bogon?(ip)
       hit = @cache&.get(ip)
@@ -142,6 +150,7 @@ module VPNDetection
       unless limit.is_a?(Numeric) && limit >= 1
         raise Error.new(:bad_request, "concurrency must be at least 1, not #{limit.inspect}")
       end
+      Transport.checked_timeout(timeout) unless timeout.nil?
       addresses = ips.to_a.uniq
       answers = {}

data/lib/vpndetection/configuration.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/database_api.rb CHANGED Viewed

@@ -7,7 +7,8 @@ module VPNDetection
   # needs a key carrying the `db.download` scope.
   #
   # 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 dataset
   # runs to gigabytes and minutes, so a bound that suits a JSON call would
   # abandon a healthy download.

data/lib/vpndetection/models/account_create_apikey_request.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_created_apikey.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_org.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_org_ref.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_org_wrap.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_rc.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_revealed_apikey.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/account_user.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/apikey_detail.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/apikey_list.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/batch_lookup_error.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/batch_lookup_request.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/batch_lookup_response.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/class_detail.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 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 your organization is licensed for. 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 CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_format.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_format_size.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_list.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_metadata.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_metadata_column.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/database_version.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/db_checksums.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/device_authorization.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/download.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/download_list.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/entitlement.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/entitlement_apikey.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/entitlement_error.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/entitlement_plan.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/entitlement_usage.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/error_envelope.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/identity.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/lookup_error.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/lookup_response.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/oauth_error.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/oauth_metadata.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/proxy_detail.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/standing.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/token_response.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/models/vpn_detail.rb CHANGED Viewed

@@ -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.09.16
+The version of the OpenAPI document: 2026.09.21
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/oauth_api.rb CHANGED Viewed

@@ -17,6 +17,8 @@ module VPNDetection
     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 VPNDetection
       @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 VPNDetection
     # 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 VPNDetection
     # @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 VPNDetection
     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/vpndetection/retries.rb CHANGED Viewed

@@ -9,6 +9,10 @@ module VPNDetection
   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, perl and php 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 VPNDetection
       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, `2147484` held the call for 24.8 days, and `sleep` raised a raw
+    # RangeError for `9223372036854775807` and `1e400`.
     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/vpndetection/transport.rb CHANGED Viewed

@@ -17,6 +17,23 @@ module VPNDetection
     ENTITLEMENT_PATH = '/api/v1/entitlement'
     BATCH_PATH = '/batch'
+    # 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 EVERY security scheme the spec lists,
     # so a keyless client would send `Authorization: Bearer `, an empty
     # `X-Api-Key` and an empty `apikey` query parameter. The API answers 401 to
@@ -29,7 +46,7 @@ module VPNDetection
         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
       def auth_settings
@@ -59,7 +76,7 @@ module VPNDetection
     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/vpndetection/version.rb CHANGED Viewed

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

metadata CHANGED Viewed

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