vpndetection 5.9.1 → 5.10.1

data/lib/vpndetection/result.rb

@@ -24,6 +24,15 @@ module VPNDetection
 
     DETAILS = %w[vpn hosting relay tor cdn resproxy dcproxy mobproxy pubproxy].freeze
 
+    # Where the address is, and the AS announcing it: every keyed answer carries
+    # both, each member present, an empty string or AS 0 where nothing is known.
+    LOCATION = %w[
+      continent continent_name country country_name timezone currency_code currency_name currency_symbol
+      flag_emoji flag_unicode
+    ].freeze
+
+    ASN = %w[asn name domain type prefix].freeze
+
     # The response exactly as it came off the wire, with its original names.
     # Frozen, because the cache hands this same object to every later caller of
     # the address.
@@ -66,7 +75,7 @@ module VPNDetection
     end
 
     # Whether the address belongs to a hosting or cloud provider, or nil when
-    # your plan does not include it. Starter and above.
+    # your plan does not include it. Every paid plan.
     def is_hosting
       @raw['is_hosting']
     end
@@ -77,7 +86,7 @@ module VPNDetection
     end
 
     # Whether the address is a privacy relay egress, or nil when your plan does
-    # not include it. Starter and above.
+    # not include it. Free and paid plans.
     def is_relay
       @raw['is_relay']
     end
@@ -88,7 +97,7 @@ module VPNDetection
     end
 
     # Whether the address is a Tor node, or nil when your plan does not include
-    # it. Starter and above.
+    # it. Free and paid plans.
     def is_tor
       @raw['is_tor']
     end
@@ -99,7 +108,7 @@ module VPNDetection
     end
 
     # Whether the address belongs to a CDN, or nil when your plan does not
-    # include it. Starter and above.
+    # include it. Every paid plan.
     def is_cdn
       @raw['is_cdn']
     end
@@ -110,7 +119,7 @@ module VPNDetection
     end
 
     # Whether the address was seen in a residential proxy pool, or nil when your
-    # plan does not include it. Scale and above.
+    # plan does not include it. Every paid plan.
     def is_resproxy
       @raw['is_resproxy']
     end
@@ -121,7 +130,7 @@ module VPNDetection
     end
 
     # Whether the address was seen in a datacenter proxy pool, or nil when your
-    # plan does not include it. Scale and above.
+    # plan does not include it. Every paid plan.
     def is_dcproxy
       @raw['is_dcproxy']
     end
@@ -132,7 +141,7 @@ module VPNDetection
     end
 
     # Whether the address was seen in a mobile proxy pool, or nil when your plan
-    # does not include it. Scale and above.
+    # does not include it. Every paid plan.
     def is_mobproxy
       @raw['is_mobproxy']
     end
@@ -144,7 +153,7 @@ module VPNDetection
 
     # Whether a public proxy, one anyone can connect through, listens on the
     # address or sends its traffic out from it, or nil when your plan does not
-    # include it. Scale and above.
+    # include it. Every paid plan.
     def is_pubproxy
       @raw['is_pubproxy']
     end
@@ -154,42 +163,43 @@ module VPNDetection
       @raw['is_pubproxy'] == true
     end
 
-    # Detail for `is_vpn`: provider, last_seen, and on max confidence and method.
+    # Detail for `is_vpn`: provider, last_seen and confidence. Every paid plan.
+    # `method` is deprecated: no plan is answered with it since 2026-10-20.
     def vpn
       @raw['vpn']
     end
 
-    # Detail for `is_hosting`. Scale and above.
+    # Detail for `is_hosting`. Every paid plan.
     def hosting
       @raw['hosting']
     end
 
-    # Detail for `is_relay`. Scale and above.
+    # Detail for `is_relay`. Free and paid plans.
     def relay
       @raw['relay']
     end
 
-    # Detail for `is_tor`. Scale and above.
+    # Detail for `is_tor`. Free and paid plans.
     def tor
       @raw['tor']
     end
 
-    # Detail for `is_cdn`. Scale and above.
+    # Detail for `is_cdn`. Every paid plan.
     def cdn
       @raw['cdn']
     end
 
-    # Detail for `is_resproxy`. Max only.
+    # Detail for `is_resproxy`. Every paid plan.
     def resproxy
       @raw['resproxy']
     end
 
-    # Detail for `is_dcproxy`. Max only.
+    # Detail for `is_dcproxy`. Every paid plan.
     def dcproxy
       @raw['dcproxy']
     end
 
-    # Detail for `is_mobproxy`. Max only.
+    # Detail for `is_mobproxy`. Every paid plan.
     def mobproxy
       @raw['mobproxy']
     end
@@ -198,11 +208,25 @@ module VPNDetection
     # num_proxies, last_seen and last_usable. num_ports is 0 when the address
     # is only an exit and num_proxies 0 when it is only an entry; last_usable is
     # an empty string when no request through a proxy on the address was
-    # answered. Max only.
+    # answered. Every paid plan.
     def pubproxy
       @raw['pubproxy']
     end
 
+    # Where the address is: continent, country, timezone, the country's
+    # currency and flag, as a wire hash (`result.location['country']`). Free and
+    # paid plans.
+    def location
+      @raw['location']
+    end
+
+    # The AS announcing the address: asn, name, domain, type and prefix, as a
+    # wire hash (`result.asn['name']`), with asn 0 where none does. Free and paid
+    # plans.
+    def asn
+      @raw['asn']
+    end
+
     def to_h
       @raw
     end

data/lib/vpndetection/transport.rb

@@ -295,6 +295,9 @@ module VPNDetection
       'ClassDetail' => [],
       'ProxyDetail' => [],
       'PubproxyDetail' => [],
+      'Location' => %i[continent continent_name country country_name timezone currency_code currency_name
+                       currency_symbol flag_emoji flag_unicode],
+      'Asn' => %i[asn name domain type prefix],
       'BatchLookupError' => %i[status error],
       'Entitlement' => %i[org_id apikey plan usage],
       'EntitlementApikey' => %i[id expires allowed_cidrs],
@@ -302,7 +305,7 @@ module VPNDetection
       'EntitlementUsage' => %i[requests quota hard_limit window_start window_end],
       'DatabaseList' => %i[databases],
       'Database' => %i[base name summary license_type starts expires renews_at notice_due_at in_term standing
-                       versions],
+                       open versions],
       'DatabaseVersion' => %i[id version formats],
       'DatabaseFormatSize' => %i[format bytes],
       'DatabaseMetadata' => %i[id updated entries schema],
@@ -310,9 +313,27 @@ module VPNDetection
       'DatabaseChecksumsResponse' => %i[id format checksums],
       'DbChecksums' => %i[md5 sha1 sha256 sha512],
       'DownloadList' => %i[downloads],
-      'Download' => %i[dataset_id format outcome sample bytes http_status apikey_id client_ip user_agent created],
+      'Download' => %i[dataset_id format outcome sample open bytes http_status apikey_id client_ip user_agent
+                       created],
     }.freeze
 
+    # RFC 3339's full-date, the spec's `date`, and its date-time, the spec's
+    # `date-time`, in the upper case the API sends. Anything else reached the
+    # generated reader's Date.parse or Time.parse, which read "monday" as this
+    # week's, "10:00" as today in the process's zone and 30 February as 2 March,
+    # or a lookup's detail handed it back as served (5.10.0, measured 2026-10-21).
+    RFC3339_DATE = /\A(\d{4})-(\d{2})-(\d{2})\z/
+    RFC3339_DATE_TIME = /\A(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(?:Z|[+-](\d{2}):(\d{2}))\z/
+
+    # A date in the form its type names, on a day and at a time that exist: an
+    # hour of 24 rolls over the way a missing day does.
+    def self.date?(value, type)
+      m = (type == 'Date' ? RFC3339_DATE : RFC3339_DATE_TIME).match(value)
+      return false unless m && Date.valid_date?(m[1].to_i, m[2].to_i, m[3].to_i)
+
+      type == 'Date' || (m[4].to_i < 24 && m[5].to_i < 60 && m[6].to_i < 60 && m[7].to_i < 24 && m[8].to_i < 60)
+    end
+
     # True when the parsed `value` has the generated `type`, a model's members
     # recursively; raises TypeError naming where it does not. No list entry or
     # map value the spec describes may be null: through 5.9.0 one came back as
@@ -323,7 +344,8 @@ module VPNDetection
 
       typed =
         case type
-        when 'String', 'Date', 'Time' then value.is_a?(String)
+        when 'String' then value.is_a?(String)
+        when 'Date', 'Time' then value.is_a?(String) && date?(value, type)
         when 'Integer' then value.is_a?(Integer)
         when 'Float' then value.is_a?(Numeric)
         when 'Boolean' then [true, false].include?(value)

data/lib/vpndetection/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vpndetection
 version: !ruby/object:Gem::Version
-  version: 5.9.1
+  version: 5.10.1
 platform: ruby
 authors:
 - Mslm Dev
@@ -78,6 +78,7 @@ files:
 - lib/vpndetection/models/account_user.rb
 - lib/vpndetection/models/apikey_detail.rb
 - lib/vpndetection/models/apikey_list.rb
+- lib/vpndetection/models/asn.rb
 - lib/vpndetection/models/batch_lookup_error.rb
 - lib/vpndetection/models/batch_lookup_request.rb
 - lib/vpndetection/models/batch_lookup_response.rb
@@ -103,6 +104,7 @@ files:
 - lib/vpndetection/models/entitlement_usage.rb
 - lib/vpndetection/models/error_envelope.rb
 - lib/vpndetection/models/identity.rb
+- lib/vpndetection/models/location.rb
 - lib/vpndetection/models/lookup_error.rb
 - lib/vpndetection/models/lookup_response.rb
 - lib/vpndetection/models/oauth_error.rb