maxmind-geoip2 1.5.1 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 101e87b30523d5d5ff9649bb1d379d0ea3d198a11ea4d989750c62bb15872cb2
-  data.tar.gz: 5c2580f874e9902dff611d5c408521f9486074db67d99ed68cbeb6d631ebe606
+  metadata.gz: e92b6c665a97ca75e8f8a8481758d9969b09bca5f186d6b54891ffdecd840fcd
+  data.tar.gz: c05a9af0e3d2d2520b55da9ac2b3dace158407c810ed6a26db457c2f72d0ad06
 SHA512:
-  metadata.gz: 609a302c0c3f4d7087df0531ce26c643412a2c7c4c2d92366ebe8cf26fae8b5bd04b8b15bc6b6a0f5285fcf15e3b74dbd92cc3e63e697e308431c9660598904f
-  data.tar.gz: 91115ba0d2bf0868bec4644c58ac12c26f94e5ee1b55b63592e05fb7e1a3461251ab078fa709f684cc3166db3509737f68edc67a3f536674d2b235325cad61b4
+  metadata.gz: a38c006f285a1f5029c9385f4d44fd2e2a15366964eb601ddeff07779598b9ee5b9375e3684c9d66c816591515a8a0baed5bfec47263348c23c94ac0618b8193
+  data.tar.gz: a217f1653b3c0acd622d1236b95f221afac74d9b73a65e30c7bff824a4e2cd57b54f99d6669d62f94d7db6c733d0b1f5d4e0b20a25380ef8a74b92097e74a9b7

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.6.0 (2026-07-16)
+
+* A new `residential` object has been added to the `anonymizer` object on
+  `MaxMind::GeoIP2::Model::Insights`. This object contains residential
+  proxy data for the network, including a confidence score, the provider
+  name, and the date the network was last seen. This is only available
+  from the GeoIP2 Insights web service.
+
 ## 1.5.1 (2026-01-19)
 
 * Re-release with a fix to the release process. This includes a bump of the

data/README.md

@@ -1,10 +1,10 @@
-# GeoIP2 Ruby API
+# GeoIP Ruby API
 
 ## Description
 
-This is the Ruby API for the GeoIP2 and GeoLite2
-[webservices](https://dev.maxmind.com/geoip/docs/web-services?lang=en)
-and [databases](https://dev.maxmind.com/geoip/docs/databases?lang=en).
+This is the Ruby API for the GeoIP and GeoLite
+[webservices](https://dev.maxmind.com/geoip/docs/web-services/?lang=en)
+and [databases](https://dev.maxmind.com/geoip/docs/databases/?lang=en).
 
 ## Installation
 
@@ -15,7 +15,7 @@ gem install maxmind-geoip2
 ## IP Geolocation Usage
 
 IP geolocation is inherently imprecise. Locations are often near the center
-of the population. Any location provided by a GeoIP2 database or web
+of the population. Any location provided by a GeoIP database or web
 service should not be used to identify a particular address or household.
 
 ## Database Reader
@@ -217,7 +217,7 @@ puts record.organization # University of Minnesota
 ### Usage
 
 To use this API, you must create a new `MaxMind::GeoIP2::Client` object
-with your account ID and license key. To use the GeoLite2 web service, you
+with your account ID and license key. To use the GeoLite web service, you
 may also set the `host` parameter to `geolite.info`. You may then you call
 the method corresponding to a specific end point, passing it the IP address
 you want to look up.
@@ -243,18 +243,18 @@ client = MaxMind::GeoIP2::Client.new(
   account_id: 42,
   license_key: 'license_key',
 
-  # To use the GeoLite2 web service instead of the GeoIP2 web service, set
+  # To use the GeoLite web service instead of the GeoIP web service, set
   # the host parameter to "geolite.info":
   # host: 'geolite.info',
 
-  # To use the Sandbox GeoIP2 web service instead of the production GeoIP2
+  # To use the Sandbox GeoIP web service instead of the production GeoIP
   # web service, set the host parameter to "sandbox.maxmind.com":
   # host: 'sandbox.maxmind.com',
 )
 
 # Replace "city" with the method corresponding to the web service that
 # you are using, e.g., "country", "insights". Please note that Insights
-# is only supported by the GeoIP2 web service and not the GeoLite2 web
+# is only supported by the GeoIP web service and not the GeoLite web
 # service.
 record = client.city('128.101.101.101')
 
@@ -299,8 +299,8 @@ which can be populated vary between end points. In addition, while an end
 point may offer a particular piece of data, MaxMind does not always have
 every piece of data for any given IP address.
 
-See the [GeoIP2 web service
-documentation](https://dev.maxmind.com/geoip/docs/web-services?lang=en) for details on
+See the [GeoIP web service
+documentation](https://dev.maxmind.com/geoip/docs/web-services/?lang=en) for details on
 what data each end point may return.
 
 The only piece of data which is always returned is the `ip_address`
@@ -313,7 +313,7 @@ databases with data on geographical features around the world, including
 populated places. They offer both free and paid premium data. Each feature
 is unique identified by a `geoname_id`, which is an integer.
 
-Many of the records returned by the GeoIP2 web services and databases
+Many of the records returned by the GeoIP web services and databases
 include a `geoname_id` property. This is the ID of a geographical feature
 (city, region, country, etc.) in the GeoNames database.
 
@@ -324,7 +324,7 @@ GeoNames premium data set.
 ## Reporting data problems
 
 If the problem you find is that an IP address is incorrectly mapped, please
-[submit your correction to MaxMind](https://www.maxmind.com/en/correction).
+[submit your correction to MaxMind](https://www.maxmind.com/en/geoip-data-correction-request).
 
 If you find some other sort of mistake, like an incorrect spelling, please
 check the [GeoNames site](https://www.geonames.org/) first. Once you've
@@ -335,7 +335,7 @@ will be automatically incorporated into future MaxMind releases.
 
 If you are a paying MaxMind customer and you're not sure where to submit a
 correction, please [contact MaxMind
-support](https://www.maxmind.com/en/support) for help.
+support](https://support.maxmind.com/knowledge-base) for help.
 
 ## Support
 
@@ -343,7 +343,7 @@ Please report all issues with this code using the [GitHub issue
 tracker](https://github.com/maxmind/GeoIP2-ruby/issues).
 
 If you are having an issue with a MaxMind service that is not specific to the
-client API, please see [our support page](https://www.maxmind.com/en/support).
+client API, please see [our support page](https://support.maxmind.com/knowledge-base).
 
 ## Requirements
 

data/lib/maxmind/geoip2/client.rb

@@ -13,7 +13,7 @@ require 'resolv'
 module MaxMind
   module GeoIP2
     # This class provides a client API for all the
-    # {https://dev.maxmind.com/geoip/docs/web-services?lang=en GeoIP2 web
+    # {https://dev.maxmind.com/geoip/docs/web-services/?lang=en GeoIP web
     # services}. The services are Country, City Plus, and Insights. Each service
     # returns a different set of data about an IP address, with Country returning
     # the least data and Insights the most.
@@ -60,7 +60,7 @@ module MaxMind
       # rubocop:disable Metrics/CyclomaticComplexity
       # rubocop:disable Metrics/PerceivedComplexity
 
-      # Create a Client that may be used to query a GeoIP2 web service.
+      # Create a Client that may be used to query a GeoIP web service.
       #
       # Once created, the Client is safe to use for lookups from multiple
       # threads.
@@ -73,8 +73,8 @@ module MaxMind
       #   property from most preferred to least preferred.
       #
       # @param host [String] the host to use when querying the web service. Set
-      #   this to "geolite.info" to use the GeoLite2 web service instead of the
-      #   GeoIP2 web service. Set this to "sandbox.maxmind.com" to use the
+      #   this to "geolite.info" to use the GeoLite web service instead of the
+      #   GeoIP web service. Set this to "sandbox.maxmind.com" to use the
       #   Sandbox environment. The sandbox allows you to experiment with the
       #   API without affecting your production data.
       #
@@ -132,26 +132,30 @@ module MaxMind
       #
       # @raise [JSON::ParserError] if there was invalid JSON in the response.
       #
-      # @raise [HTTPError] if there was a problem with the HTTP response, such as
-      #   an unexpected HTTP status code.
+      # @raise [MaxMind::GeoIP2::HTTPError] if there was a problem with the HTTP
+      #   response, such as an unexpected HTTP status code.
       #
-      # @raise [AddressInvalidError] if the web service believes the IP address
-      #   to be invalid or missing.
+      # @raise [MaxMind::GeoIP2::AddressInvalidError] if the web service believes
+      #   the IP address to be invalid or missing.
       #
-      # @raise [AddressNotFoundError] if the IP address was not found.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address was not
+      #   found.
       #
-      # @raise [AddressReservedError] if the IP address is reserved.
+      # @raise [MaxMind::GeoIP2::AddressReservedError] if the IP address is
+      #   reserved.
       #
-      # @raise [AuthenticationError] if there was a problem authenticating to the
-      #   web service, such as an invalid or missing license key.
+      # @raise [MaxMind::GeoIP2::AuthenticationError] if there was a problem
+      #   authenticating to the web service, such as an invalid or missing
+      #   license key.
       #
-      # @raise [InsufficientFundsError] if your account is out of credit.
+      # @raise [MaxMind::GeoIP2::InsufficientFundsError] if your account is out
+      #   of credit.
       #
-      # @raise [PermissionRequiredError] if your account does not have permission
-      #   to use the web service.
+      # @raise [MaxMind::GeoIP2::PermissionRequiredError] if your account does
+      #   not have permission to use the web service.
       #
-      # @raise [InvalidRequestError] if the web service responded with an error
-      #   and there is no more specific error to raise.
+      # @raise [MaxMind::GeoIP2::InvalidRequestError] if the web service
+      #   responded with an error and there is no more specific error to raise.
       #
       # @return [MaxMind::GeoIP2::Model::City]
       def city(ip_address = 'me')
@@ -169,26 +173,30 @@ module MaxMind
       #
       # @raise [JSON::ParserError] if there was invalid JSON in the response.
       #
-      # @raise [HTTPError] if there was a problem with the HTTP response, such as
-      #   an unexpected HTTP status code.
+      # @raise [MaxMind::GeoIP2::HTTPError] if there was a problem with the HTTP
+      #   response, such as an unexpected HTTP status code.
       #
-      # @raise [AddressInvalidError] if the web service believes the IP address
-      #   to be invalid or missing.
+      # @raise [MaxMind::GeoIP2::AddressInvalidError] if the web service believes
+      #   the IP address to be invalid or missing.
       #
-      # @raise [AddressNotFoundError] if the IP address was not found.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address was not
+      #   found.
       #
-      # @raise [AddressReservedError] if the IP address is reserved.
+      # @raise [MaxMind::GeoIP2::AddressReservedError] if the IP address is
+      #   reserved.
       #
-      # @raise [AuthenticationError] if there was a problem authenticating to the
-      #   web service, such as an invalid or missing license key.
+      # @raise [MaxMind::GeoIP2::AuthenticationError] if there was a problem
+      #   authenticating to the web service, such as an invalid or missing
+      #   license key.
       #
-      # @raise [InsufficientFundsError] if your account is out of credit.
+      # @raise [MaxMind::GeoIP2::InsufficientFundsError] if your account is out
+      #   of credit.
       #
-      # @raise [PermissionRequiredError] if your account does not have permission
-      #   to use the web service.
+      # @raise [MaxMind::GeoIP2::PermissionRequiredError] if your account does
+      #   not have permission to use the web service.
       #
-      # @raise [InvalidRequestError] if the web service responded with an error
-      #   and there is no more specific error to raise.
+      # @raise [MaxMind::GeoIP2::InvalidRequestError] if the web service
+      #   responded with an error and there is no more specific error to raise.
       #
       # @return [MaxMind::GeoIP2::Model::Country]
       def country(ip_address = 'me')
@@ -197,7 +205,7 @@ module MaxMind
 
       # This method calls the Insights web service.
       #
-      # Insights is only supported by the GeoIP2 web service. The GeoLite2 web
+      # Insights is only supported by the GeoIP web service. The GeoLite web
       # service does not support it.
       #
       # @param ip_address [String] IPv4 or IPv6 address as a string. If no
@@ -209,26 +217,30 @@ module MaxMind
       #
       # @raise [JSON::ParserError] if there was invalid JSON in the response.
       #
-      # @raise [HTTPError] if there was a problem with the HTTP response, such as
-      #   an unexpected HTTP status code.
+      # @raise [MaxMind::GeoIP2::HTTPError] if there was a problem with the HTTP
+      #   response, such as an unexpected HTTP status code.
       #
-      # @raise [AddressInvalidError] if the web service believes the IP address
-      #   to be invalid or missing.
+      # @raise [MaxMind::GeoIP2::AddressInvalidError] if the web service believes
+      #   the IP address to be invalid or missing.
       #
-      # @raise [AddressNotFoundError] if the IP address was not found.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address was not
+      #   found.
       #
-      # @raise [AddressReservedError] if the IP address is reserved.
+      # @raise [MaxMind::GeoIP2::AddressReservedError] if the IP address is
+      #   reserved.
       #
-      # @raise [AuthenticationError] if there was a problem authenticating to the
-      #   web service, such as an invalid or missing license key.
+      # @raise [MaxMind::GeoIP2::AuthenticationError] if there was a problem
+      #   authenticating to the web service, such as an invalid or missing
+      #   license key.
       #
-      # @raise [InsufficientFundsError] if your account is out of credit.
+      # @raise [MaxMind::GeoIP2::InsufficientFundsError] if your account is out
+      #   of credit.
       #
-      # @raise [PermissionRequiredError] if your account does not have permission
-      #   to use the web service.
+      # @raise [MaxMind::GeoIP2::PermissionRequiredError] if your account does
+      #   not have permission to use the web service.
       #
-      # @raise [InvalidRequestError] if the web service responded with an error
-      #   and there is no more specific error to raise.
+      # @raise [MaxMind::GeoIP2::InvalidRequestError] if the web service
+      #   responded with an error and there is no more specific error to raise.
       #
       # @return [MaxMind::GeoIP2::Model::Insights]
       def insights(ip_address = 'me')

data/lib/maxmind/geoip2/model/anonymous_plus.rb

@@ -27,6 +27,7 @@ module MaxMind
           date_string = get('network_last_seen')
 
           if !date_string
+            @network_last_seen = nil
             return nil
           end
 

data/lib/maxmind/geoip2/model/asn.rb

@@ -5,7 +5,7 @@ require 'maxmind/geoip2/model/abstract'
 module MaxMind
   module GeoIP2
     module Model
-      # Model class for the GeoLite2 ASN database.
+      # Model class for the GeoLite ASN database.
       class ASN < Abstract
         # The autonomous system number associated with the IP address.
         #

data/lib/maxmind/geoip2/model/city.rb

@@ -9,10 +9,10 @@ require 'maxmind/geoip2/record/subdivision'
 module MaxMind
   module GeoIP2
     module Model
-      # Model class for the data returned by the GeoIP2 City Plus web service
-      # and the City database. It is also used for GeoLite2 City lookups.
+      # Model class for the data returned by the GeoIP City Plus web service
+      # and the City database. It is also used for GeoLite City lookups.
       #
-      # See https://dev.maxmind.com/geoip/docs/web-services?lang=en for more
+      # See https://dev.maxmind.com/geoip/docs/web-services/?lang=en for more
       # details.
       #
       # See {MaxMind::GeoIP2::Model::Country} for inherited methods.

data/lib/maxmind/geoip2/model/connection_type.rb

@@ -5,7 +5,7 @@ require 'maxmind/geoip2/model/abstract'
 module MaxMind
   module GeoIP2
     module Model
-      # Model class for the GeoIP2 Connection Type database.
+      # Model class for the GeoIP Connection Type database.
       class ConnectionType < Abstract
         # The connection type may take the following values: "Dialup",
         # "Cable/DSL", "Corporate", "Cellular", and "Satellite". Additional

data/lib/maxmind/geoip2/model/country.rb

@@ -9,8 +9,8 @@ require 'maxmind/geoip2/record/traits'
 module MaxMind
   module GeoIP2
     module Model
-      # Model class for the data returned by the GeoIP2 Country web service and
-      # database. It is also used for GeoLite2 Country lookups.
+      # Model class for the data returned by the GeoIP Country web service and
+      # database. It is also used for GeoLite Country lookups.
       class Country
         # Continent data for the IP address.
         #

data/lib/maxmind/geoip2/model/domain.rb

@@ -5,7 +5,7 @@ require 'maxmind/geoip2/model/abstract'
 module MaxMind
   module GeoIP2
     module Model
-      # Model class for the GeoIP2 Domain database.
+      # Model class for the GeoIP Domain database.
       class Domain < Abstract
         # The second level domain associated with the IP address. This will be
         # something like "example.com" or "example.co.uk", not "foo.example.com".

data/lib/maxmind/geoip2/model/enterprise.rb

@@ -5,9 +5,9 @@ require 'maxmind/geoip2/model/city'
 module MaxMind
   module GeoIP2
     module Model
-      # Model class for the data returned by GeoIP2 Enterprise database lookups.
+      # Model class for the data returned by GeoIP Enterprise database lookups.
       #
-      # See https://dev.maxmind.com/geoip/docs/web-services?lang=en for more
+      # See https://dev.maxmind.com/geoip/docs/web-services/?lang=en for more
       # details.
       #
       # See {MaxMind::GeoIP2::Model::City} for inherited methods.

data/lib/maxmind/geoip2/model/insights.rb

@@ -6,9 +6,9 @@ require 'maxmind/geoip2/record/anonymizer'
 module MaxMind
   module GeoIP2
     module Model
-      # Model class for the data returned by the GeoIP2 Insights web service.
+      # Model class for the data returned by the GeoIP Insights web service.
       #
-      # See https://dev.maxmind.com/geoip/docs/web-services?lang=en for more
+      # See https://dev.maxmind.com/geoip/docs/web-services/?lang=en for more
       # details.
       class Insights < City
         # Data indicating whether the IP address is part of an anonymizing

data/lib/maxmind/geoip2/model/isp.rb

@@ -5,7 +5,7 @@ require 'maxmind/geoip2/model/abstract'
 module MaxMind
   module GeoIP2
     module Model
-      # Model class for the GeoIP2 ISP database.
+      # Model class for the GeoIP ISP database.
       class ISP < Abstract
         # The autonomous system number associated with the IP address.
         #

data/lib/maxmind/geoip2/reader.rb

@@ -14,7 +14,7 @@ require 'maxmind/geoip2/model/isp'
 
 module MaxMind
   module GeoIP2
-    # Reader is a reader for the GeoIP2/GeoLite2 database format. IP addresses
+    # Reader is a reader for the GeoIP/GeoLite database format. IP addresses
     # can be looked up using the database specific methods.
     #
     # == Example
@@ -31,7 +31,7 @@ module MaxMind
       # rubocop:disable Metrics/CyclomaticComplexity
       # rubocop:disable Metrics/PerceivedComplexity
 
-      # Create a Reader for looking up IP addresses in a GeoIP2/GeoLite2 database
+      # Create a Reader for looking up IP addresses in a GeoIP/GeoLite database
       # file.
       #
       # If you're performing multiple lookups, it's most efficient to create one
@@ -41,7 +41,7 @@ module MaxMind
       # threads. It is safe to use after forking.
       #
       # @overload initialize(database:, locales: ['en'], mode: MaxMind::DB::MODE_AUTO)
-      #   @param database [String] a path to a GeoIP2/GeoLite2 database file.
+      #   @param database [String] a path to a GeoIP/GeoLite database file.
       #   @param locales [Array<String>] a list of locale codes to use in the name
       #     property from most preferred to least preferred.
       #   @param mode [Symbol] Defines how to open the database. It may be one of
@@ -97,8 +97,8 @@ module MaxMind
       # @raise [ArgumentError] if used against a non-Anonymous IP database or if
       #   you attempt to look up an IPv6 address in an IPv4 only database.
       #
-      # @raise [AddressNotFoundError] if the IP address is not found in the
-      #   database.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address is not
+      #   found in the database.
       #
       # @raise [MaxMind::DB::InvalidDatabaseError] if the database appears
       #   corrupt.
@@ -121,8 +121,8 @@ module MaxMind
       # @raise [ArgumentError] if used against a non-Anonymous Plus database
       #   or if you attempt to look up an IPv6 address in an IPv4 only database.
       #
-      # @raise [AddressNotFoundError] if the IP address is not found in the
-      #   database.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address is not
+      #   found in the database.
       #
       # @raise [MaxMind::DB::InvalidDatabaseError] if the database appears
       #   corrupt.
@@ -145,8 +145,8 @@ module MaxMind
       # @raise [ArgumentError] if used against a non-ASN database or if you
       #   attempt to look up an IPv6 address in an IPv4 only database.
       #
-      # @raise [AddressNotFoundError] if the IP address is not found in the
-      #   database.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address is not
+      #   found in the database.
       #
       # @raise [MaxMind::DB::InvalidDatabaseError] if the database appears
       #   corrupt.
@@ -164,8 +164,8 @@ module MaxMind
       # @raise [ArgumentError] if used against a non-City database or if you
       #   attempt to look up an IPv6 address in an IPv4 only database.
       #
-      # @raise [AddressNotFoundError] if the IP address is not found in the
-      #   database.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address is not
+      #   found in the database.
       #
       # @raise [MaxMind::DB::InvalidDatabaseError] if the database appears
       #   corrupt.
@@ -183,8 +183,8 @@ module MaxMind
       # @raise [ArgumentError] if used against a non-Connection Type database or if
       #   you attempt to look up an IPv6 address in an IPv4 only database.
       #
-      # @raise [AddressNotFoundError] if the IP address is not found in the
-      #   database.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address is not
+      #   found in the database.
       #
       # @raise [MaxMind::DB::InvalidDatabaseError] if the database appears
       #   corrupt.
@@ -207,8 +207,8 @@ module MaxMind
       # @raise [ArgumentError] if used against a non-Country database or if you
       #   attempt to look up an IPv6 address in an IPv4 only database.
       #
-      # @raise [AddressNotFoundError] if the IP address is not found in the
-      #   database.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address is not
+      #   found in the database.
       #
       # @raise [MaxMind::DB::InvalidDatabaseError] if the database appears
       #   corrupt.
@@ -226,8 +226,8 @@ module MaxMind
       # @raise [ArgumentError] if used against a non-Domain database or if you
       #   attempt to look up an IPv6 address in an IPv4 only database.
       #
-      # @raise [AddressNotFoundError] if the IP address is not found in the
-      #   database.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address is not
+      #   found in the database.
       #
       # @raise [MaxMind::DB::InvalidDatabaseError] if the database appears
       #   corrupt.
@@ -245,8 +245,8 @@ module MaxMind
       # @raise [ArgumentError] if used against a non-Enterprise database or if
       #   you attempt to look up an IPv6 address in an IPv4 only database.
       #
-      # @raise [AddressNotFoundError] if the IP address is not found in the
-      #   database.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address is not
+      #   found in the database.
       #
       # @raise [MaxMind::DB::InvalidDatabaseError] if the database appears
       #   corrupt.
@@ -264,8 +264,8 @@ module MaxMind
       # @raise [ArgumentError] if used against a non-ISP database or if you
       #   attempt to look up an IPv6 address in an IPv4 only database.
       #
-      # @raise [AddressNotFoundError] if the IP address is not found in the
-      #   database.
+      # @raise [MaxMind::GeoIP2::AddressNotFoundError] if the IP address is not
+      #   found in the database.
       #
       # @raise [MaxMind::DB::InvalidDatabaseError] if the database appears
       #   corrupt.

data/lib/maxmind/geoip2/record/anonymizer.rb

@@ -2,6 +2,7 @@
 
 require 'date'
 require 'maxmind/geoip2/record/abstract'
+require 'maxmind/geoip2/record/anonymizer_feed'
 
 module MaxMind
   module GeoIP2
@@ -11,6 +12,20 @@ module MaxMind
       #
       # This record is returned by the Insights web service.
       class Anonymizer < Abstract
+        # Residential proxy data for the network. This may be populated even
+        # when no other anonymizer attributes are set. This property is only
+        # available from Insights.
+        #
+        # @return [MaxMind::GeoIP2::Record::AnonymizerFeed]
+        attr_reader :residential
+
+        # @!visibility private
+        def initialize(record)
+          super
+
+          @residential = AnonymizerFeed.new(record.nil? ? nil : record['residential'])
+        end
+
         # A score ranging from 1 to 99 that represents our percent confidence
         # that the network is currently part of an actively used VPN service.
         # This property is only available from Insights.
@@ -85,13 +100,14 @@ module MaxMind
           date_string = get('network_last_seen')
 
           if !date_string
+            @network_last_seen = nil
             return nil
           end
 
           @network_last_seen = Date.parse(date_string)
         end
 
-        # The name of the VPN provider (e.g., NordVPN, SurfShark, etc.)
+        # The name of the VPN provider (e.g., nordvpn, surfshark)
         # associated with the network. This property is only available from
         # Insights.
         #

data/lib/maxmind/geoip2/record/anonymizer_feed.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require 'date'
+require 'maxmind/geoip2/record/abstract'
+
+module MaxMind
+  module GeoIP2
+    module Record
+      # Contains data for one type of anonymizer detection, currently
+      # residential proxies. Additional feeds may be added in the future.
+      #
+      # This record is returned by the anonymizer object of the Insights web
+      # service.
+      class AnonymizerFeed < Abstract
+        # A score ranging from 1 to 99 that represents our percent confidence
+        # that the network is currently part of this anonymizer feed. This
+        # property is only available from Insights.
+        #
+        # @return [Integer, nil]
+        def confidence
+          get('confidence')
+        end
+
+        # The last day that the network was sighted in our analysis of this
+        # anonymizer feed. This value is parsed lazily. This property is only
+        # available from Insights.
+        #
+        # @return [Date, nil] A Date object representing the last seen date,
+        #   or nil if the date is not available.
+        def network_last_seen
+          return @network_last_seen if defined?(@network_last_seen)
+
+          date_string = get('network_last_seen')
+
+          if !date_string
+            @network_last_seen = nil
+            return nil
+          end
+
+          @network_last_seen = Date.parse(date_string)
+        end
+
+        # The name of the provider associated with the network in this
+        # anonymizer feed. This property is only available from Insights.
+        #
+        # @return [String, nil]
+        def provider_name
+          get('provider_name')
+        end
+      end
+    end
+  end
+end

data/lib/maxmind/geoip2/record/city.rb

@@ -14,7 +14,7 @@ module MaxMind
       class City < Place
         # A value from 0-100 indicating MaxMind's confidence that the city is
         # correct. This attribute is only available from the Insights service and
-        # the GeoIP2 Enterprise database.
+        # the GeoIP Enterprise database.
         #
         # @return [Integer, nil]
         def confidence

data/lib/maxmind/geoip2/record/country.rb

@@ -13,7 +13,7 @@ module MaxMind
       class Country < Place
         # A value from 0-100 indicating MaxMind's confidence that the country is
         # correct. This attribute is only available from the Insights service and
-        # the GeoIP2 Enterprise database.
+        # the GeoIP Enterprise database.
         #
         # @return [Integer, nil]
         def confidence

data/lib/maxmind/geoip2/record/location.rb

@@ -63,7 +63,7 @@ module MaxMind
           get('population_density')
         end
 
-        # The time zone associated with location, as specified by the IANA Time
+        # The time zone associated with the location, as specified by the IANA Time
         # Zone Database, e.g., "America/New_York". See
         # https://www.iana.org/time-zones.
         #

data/lib/maxmind/geoip2/record/postal.rb

@@ -22,7 +22,7 @@ module MaxMind
 
         # A value from 0-100 indicating MaxMind's confidence that the postal code
         # is correct. This attribute is only available from the Insights service
-        # and the GeoIP2 Enterprise database.
+        # and the GeoIP Enterprise database.
         #
         # @return [Integer, nil]
         def confidence

data/lib/maxmind/geoip2/record/subdivision.rb

@@ -14,7 +14,7 @@ module MaxMind
       class Subdivision < Place
         # This is a value from 0-100 indicating MaxMind's confidence that the
         # subdivision is correct. This attribute is only available from the
-        # Insights service and the GeoIP2 Enterprise database.
+        # Insights service and the GeoIP Enterprise database.
         #
         # @return [Integer, nil]
         def confidence

data/lib/maxmind/geoip2/record/traits.rb

@@ -41,9 +41,9 @@ module MaxMind
           get('autonomous_system_organization')
         end
 
-        # The connection type may take the following  values: "Dialup",
-        # "Cable/DSL", "Corporate", "Cellular", and "Satellite". Additional
-        # values may be added in the future. This attribute is only available
+        # The connection type may take the following values: "Cable/DSL",
+        # "Corporate", "Cellular", and "Satellite". Additional values may be
+        # added in the future. This attribute is only available
         # from the City Plus and Insights web services and the Enterprise
         # database.
         #
@@ -52,7 +52,7 @@ module MaxMind
           get('connection_type')
         end
 
-        # The second level domain associated with the IP address. This will be
+        # The second-level domain associated with the IP address. This will be
         # something like "example.com" or "example.co.uk", not "foo.example.com".
         # This attribute is only available from the City Plus and Insights web
         # services and the Enterprise database.
@@ -103,7 +103,7 @@ module MaxMind
         # {https://en.wikipedia.org/wiki/Anycast anycast network}.
         #
         # This property is only available from the Country, City Plus, and
-        # Insights web services and the GeoIP2 Country, City, and Enterprise
+        # Insights web services and the GeoIP Country, City, and Enterprise
         # databases.
         #
         # @return [Boolean]
@@ -266,7 +266,6 @@ module MaxMind
         # * college
         # * consumer_privacy_network
         # * content_delivery_network
-        # * dialup
         # * government
         # * hosting
         # * library

data/lib/maxmind/geoip2/version.rb

@@ -3,6 +3,6 @@
 module MaxMind
   module GeoIP2
     # The Gem version.
-    VERSION = '1.5.1'
+    VERSION = '1.6.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: maxmind-geoip2
 version: !ruby/object:Gem::Version
-  version: 1.5.1
+  version: 1.6.0
 platform: ruby
 authors:
 - William Storey
@@ -38,7 +38,7 @@ dependencies:
         version: '4.3'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '7.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -48,7 +48,7 @@ dependencies:
         version: '4.3'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '7.0'
 - !ruby/object:Gem::Dependency
   name: maxmind-db
   requirement: !ruby/object:Gem::Requirement
@@ -175,7 +175,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: A gem for interacting with the GeoIP2 webservices and databases. MaxMind
+description: A gem for interacting with the GeoIP webservices and databases. MaxMind
   provides geolocation data as downloadable databases as well as through a webservice.
 email: support@maxmind.com
 executables: []
@@ -203,6 +203,7 @@ files:
 - lib/maxmind/geoip2/reader.rb
 - lib/maxmind/geoip2/record/abstract.rb
 - lib/maxmind/geoip2/record/anonymizer.rb
+- lib/maxmind/geoip2/record/anonymizer_feed.rb
 - lib/maxmind/geoip2/record/city.rb
 - lib/maxmind/geoip2/record/continent.rb
 - lib/maxmind/geoip2/record/country.rb
@@ -239,7 +240,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.10
 specification_version: 4
-summary: A gem for interacting with the GeoIP2 webservices and databases.
+summary: A gem for interacting with the GeoIP webservices and databases.
 test_files: []