vpndetection 5.11.3 → 5.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb13e51eaae8cf5af6b2eed52cac37486bf9399727527f7afa3884d46b4853ca
-  data.tar.gz: 1bfccf0c65a221a3ea8858c29c2b9815378c3a3695ca919cb6df57b5a2613074
+  metadata.gz: dc7966b57c12cebae2f064198cd2864cdee0c8ef3650bf7800697ee661e0137b
+  data.tar.gz: d747ad89b39de9d6b71f633dff7f1f66642676a22e8183761fb48ba001099b31
 SHA512:
-  metadata.gz: de0cbd1d51f8f72629daec0959d85384f30aa61567b882e377e9a05120bea4c92b48df6b216e98c24a9bf7dc2bb063fdb589783b3840915318ea272e49c1224a
-  data.tar.gz: dbc4652065381fa5d7df6eea1daa5d458047b69a42a015928306a9ddddb8aef81990d719107661cd9a5ac2f5301d01e75e6788e7b9a4fc1a5fef97d4737e5ab2
+  metadata.gz: 5b0e62f8199cef49cb582bd417f7d6b5645f2f270002b590ded58dcafbf4382f6365454b89c22b06bbb14d6c03e90e453fa3a82ba657e2d9cf22598bee3d12bd
+  data.tar.gz: a7ce50c6510a9065dc23ce7c347905527ac3655b5425b89b83db537884d7784bc299aac2f57b7ff839d669a6fa8c766885735677221680348ff5e74e491efb9d

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. So does a `retries` that isn't an Integer from 0 (from 5.11.3).
+`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
@@ -178,6 +178,13 @@ bytes = client.database.download_bytes('cdn_ip_v1', 'csvgz')
 
 `download` streams straight to disk, so nothing bigger than a chunk is ever held in memory whatever the database weighs, and it writes through a neighboring `.part` file so a transfer that dies half way leaves no truncated copy behind. `download_url` hands back the time-limited link and follows nothing, for when you want to run the transfer yourself. `download_bytes` holds the whole file in memory, and the catalog runs from `cdn_ip_v1` at 10 KB to `resproxy_ip_90d_v1` at 1.79 GB, so reach for `download` for anything you have not measured.
 
+From 5.12.0, each of the three takes `build:`, the build a `database.updated` webhook names, so the file is the one whose `sha256` the webhook carries rather than whatever is live by the time you ask. Without it you get the live build. A build is kept 7 days, and one pruned since is a `:bad_request` with status 410; a value that is no build's name raises `ArgumentError` before any request:
+
+```ruby
+data = event.fetch('data') # a database.updated webhook's
+client.database.download(data['dataset'], 'mmdb', "./#{data['dataset']}.mmdb", build: data['build'])
+```
+
 From 5.3.0, `list`, `metadata`, `checksums`, `downloads` and `download_url` each take `timeout:` in seconds for that call alone, overriding the client's for one attempt of it:
 
 ```ruby

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.05
 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.05
 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.05
 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.05
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -156,9 +156,10 @@ 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
+    # @option opts [String] :build One build of the database, by the name a `database.updated` webhook gives it, so the file is the one whose `sha256` the webhook carries. Without it, the build that is live. 
     # @return [nil]
     def download_database(id, format, opts = {})
       download_database_with_http_info(id, format, opts)
@@ -167,9 +168,10 @@ 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
+    # @option opts [String] :build One build of the database, by the name a `database.updated` webhook gives it, so the file is the one whose `sha256` the webhook carries. Without it, the build that is live. 
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def download_database_with_http_info(id, format, opts = {})
       if @api_client.config.debugging
@@ -183,6 +185,11 @@ module VPNDetection
       if @api_client.config.client_side_validation && format.nil?
         fail ArgumentError, "Missing the required parameter 'format' when calling DatabaseWireApi.download_database"
       end
+      pattern = Regexp.new(/^[0-9]{8}\.[a-z0-9]{6}$/)
+      if @api_client.config.client_side_validation && !opts[:'build'].nil? && opts[:'build'] !~ pattern
+        fail ArgumentError, "invalid value for 'opts[:\"build\"]' when calling DatabaseWireApi.download_database, must conform to the pattern #{pattern}."
+      end
+
       # resource path
       local_var_path = '/api/v1/database/download'
 
@@ -190,6 +197,7 @@ module VPNDetection
       query_params = opts[:query_params] || {}
       query_params[:'id'] = id
       query_params[:'format'] = format
+      query_params[:'build'] = opts[:'build'] if !opts[:'build'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}

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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0

data/lib/vpndetection/client.rb

@@ -28,7 +28,7 @@ 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 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.
@@ -40,14 +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, and for a `retries`, here or on any call, that is
-    #   not an Integer from 0.
+    #   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),
       )
@@ -163,15 +168,16 @@ 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?
@@ -216,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.05
 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.
@@ -63,12 +63,16 @@ module VPNDetection
     # START of a transfer, so one already running is not interrupted when it
     # lapses.
     #
+    # @param build [String, nil] one build of the dataset, by the name a
+    #   `database.updated` webhook gives it, so the file is the one whose
+    #   `sha256` the webhook carries; nil, the build that is live. A build is
+    #   kept 7 days, and one pruned since is a `bad_request` with status 410.
     # @param timeout [Numeric, nil] seconds this attempt may take, for THIS call
     #   only. It bounds the request that MINTS the link, which is an ordinary
     #   JSON call, and says nothing about the transfer you then run with it.
-    def download_url(id, format, timeout: nil)
+    def download_url(id, format, build: nil, timeout: nil)
       check_format!(format)
-      call { redirect_location(id, format, timeout) }
+      call { redirect_location(id, format, build, timeout) }
     end
 
     # Download one dataset file to `path`, and return the bytes written.
@@ -77,11 +81,11 @@ module VPNDetection
     # so a transfer that dies half way leaves no truncated file that reads as a
     # whole dataset, and a refresh that fails does not destroy the copy already
     # there. Nothing beyond one chunk is ever held in memory, whatever the
-    # dataset weighs.
-    def download(id, format, path)
+    # dataset weighs. `build` asks for one build, as in {#download_url}.
+    def download(id, format, path, build: nil)
       partial = "#{path}.part"
       begin
-        url = download_url(id, format)
+        url = download_url(id, format, build: build)
         written = File.open(partial, 'wb') { |file| transfer(url) { |chunk| file.write(chunk) } }
         File.rename(partial, path)
       rescue StandardError
@@ -96,9 +100,10 @@ module VPNDetection
     # **This holds the entire file in memory**, and the catalog spans five orders
     # of magnitude: `cdn_ip_v1` is 10 KB while `resproxy_ip_90d_v1` is 1.79 GB.
     # Reach for it at the small end, where the bytes go straight into a parser,
-    # and use {#download} for anything you have not measured.
-    def download_bytes(id, format)
-      url = download_url(id, format)
+    # and use {#download} for anything you have not measured. `build` asks for
+    # one build, as in {#download_url}.
+    def download_bytes(id, format, build: nil)
+      url = download_url(id, format, build: build)
       bytes = String.new(encoding: Encoding::BINARY)
       transfer(url) { |chunk| bytes << chunk }
       bytes
@@ -180,8 +185,8 @@ module VPNDetection
     # The 302 is this operation's SUCCESS case, but the generated client treats
     # every non-2xx as a failure, so it arrives as an ApiError carrying the
     # Location header.
-    def redirect_location(id, format, timeout)
-      _, status, = @api.download_database_with_http_info(id, format, timeout: timeout)
+    def redirect_location(id, format, build, timeout)
+      _, status, = @api.download_database_with_http_info(id, format, build: build, timeout: timeout)
       raise Error.new(:server_error, 'expected a redirect to object storage', status: status)
     rescue ApiError => e
       raise unless e.code == 302

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/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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 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.05
 Contact: support@vpndetection.io
 Generated by: https://openapi-generator.tech
 Generator version: 7.25.0
@@ -14,21 +14,21 @@ require 'date'
 require 'time'
 
 module VPNDetection
-  # The shared detail shape for the residential, datacenter and mobile proxy families, measured over a rolling 90 day window. Every key is present when the object is populated; the object is `{}` when its flag is false. 
+  # The shared detail shape for the residential, datacenter and mobile proxy families, measured over a rolling 90 day window. An address that leaves the window keeps its flag and the values of its last day in it, so `last_seen` is what says how recent they are. Every key is present when the object is populated; the object is `{}` when its flag is false. 
   class ProxyDetail < ApiModelBase
     # The proxy network, or an empty string where unattributed.
     attr_accessor :provider
 
-    # The earliest date within the window this address was seen in the pool.
+    # The earliest date within the window this address was seen in the pool, as of its last day in the window once it has left. 
     attr_accessor :first_seen
 
-    # The most recent date within the window this address was seen in the pool.
+    # The most recent date this address was seen in the pool. An address that leaves the window keeps its flag, so this date is what says how recent the sighting is. 
     attr_accessor :last_seen
 
-    # How many times the address was observed in the pool during the window.
+    # How many times the address was observed in the pool during the window, as of its last day in it once it has left. 
     attr_accessor :hits
 
-    # The share of days in the window on which the address was seen, as a percentage. A high value means a stable pool member rather than a one-off sighting. 
+    # The percentage of days in the window on which the address was seen, as of its last day in it once it has left. A high value means a stable pool member rather than a one-off sighting. 
     attr_accessor :hits_days_pct
 
     # How many distinct proxy networks this address was seen in.

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.05
 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 address in Public Proxy IP, open proxies anyone can connect through, measured over a rolling 90 day window. An address is either end of a proxy, or both: where it listens, and where its traffic leaves from. Every key is present when the object is populated; the object is `{}` when `is_pubproxy` is false. 
+  # The address in Public Proxy IP, open proxies anyone can connect through, measured over a rolling 90 day window. An address that leaves the window keeps its flag and the values of its last day in it, so `last_seen` is what says how recent they are. An address is either end of a proxy, or both: where it listens, and where its traffic leaves from. Every key is present when the object is populated; the object is `{}` when `is_pubproxy` is false. 
   class PubproxyDetail < ApiModelBase
     # Whether a public proxy listens on this address.
     attr_accessor :entry
@@ -31,10 +31,10 @@ module VPNDetection
     # How many distinct public proxies' traffic left from this address; 0 when it is only an entry. 
     attr_accessor :num_proxies
 
-    # The most recent date within the window a proxy on this address was seen.
+    # The most recent date a proxy on this address was seen. An address that leaves the window keeps its flag, so this date is what says how recent the sighting is. 
     attr_accessor :last_seen
 
-    # The most recent date within the window a request through a proxy on this address was answered, as YYYY-MM-DD, or an empty string when none was. 
+    # The most recent date within the window a request through a proxy on this address was answered, as YYYY-MM-DD, or an empty string when none was, as of its last day in the window once it has left. 
     attr_accessor :last_usable
 
     # Attribute mapping from ruby-style variable name to JSON key.

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.05
 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.05
 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.05
 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
 

data/lib/vpndetection/version.rb

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

metadata

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