Add anonymizer property to IpAddress model

Expose the GeoIP2 Insights anonymizer data in the minFraud IpAddress
model. This was previously available in the underlying GeoIP2 library
(since 3.3.0) but not exposed in minFraud responses.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: oschwald

CHANGELOG.md

@@ -4,6 +4,11 @@ CHANGELOG
 3.6.0
 ------------------
 
+* Added the `anonymizer` property to `MaxMind\MinFraud\Model\IpAddress`. This
+  contains anonymizer data from the GeoIP2 Insights response, including VPN
+  detection confidence, provider name, and network last seen date. This was
+  previously available in the GeoIP2 library but not exposed in minFraud
+  responses.
 * Added `banquest`, `summit_payments`, and `yaadpay` to the payment processor
   validation.
 

src/MinFraud/Model/IpAddress.php

@@ -5,6 +5,7 @@
 namespace MaxMind\MinFraud\Model;
 
 use GeoIp2\Model\Insights;
+use GeoIp2\Record\Anonymizer;
 use GeoIp2\Record\City;
 use GeoIp2\Record\Continent;
 use GeoIp2\Record\Country;
@@ -103,6 +104,13 @@ class IpAddress implements \JsonSerializable
      */
     public readonly Traits $traits;
 
+    /**
+     * @var Anonymizer data for the anonymizer status of the requested IP
+     *                 address. This object contains information about whether
+     *                 the IP address belongs to an anonymous network.
+     */
+    public readonly Anonymizer $anonymizer;
+
     /**
      * @param array<string, mixed>|null $response
      * @param list<string>              $locales
@@ -123,6 +131,7 @@ public function __construct(?array $response, array $locales = ['en'])
         $this->representedCountry = $insights->representedCountry;
         $this->subdivisions = $insights->subdivisions;
         $this->traits = $insights->traits;
+        $this->anonymizer = $insights->anonymizer;
 
         $this->location = new GeoIp2Location($response['location'] ?? []);
         $this->risk = $response['risk'] ?? null;
@@ -178,6 +187,11 @@ public function jsonSerialize(): ?array
             $js['traits'] = $traits;
         }
 
+        $anonymizer = $this->anonymizer->jsonSerialize();
+        if (!empty($anonymizer)) {
+            $js['anonymizer'] = $anonymizer;
+        }
+
         $postal = $this->postal->jsonSerialize();
         if (!empty($postal)) {
             $js['postal'] = $postal;

tests/MaxMind/Test/MinFraud/Model/InsightsTest.php

@@ -124,6 +124,38 @@ public function testInsightsProperties(): void
             'correct mobile network code'
         );
 
+        // Test anonymizer object
+        foreach ([
+            'isAnonymous',
+            'isAnonymousVpn',
+            'isHostingProvider',
+            'isPublicProxy',
+            'isTorExitNode',
+        ] as $property) {
+            $this->assertTrue(
+                $insights->ipAddress->anonymizer->{$property},
+                "anonymizer {$property} is true"
+            );
+        }
+
+        $this->assertSame(
+            $array['ip_address']['anonymizer']['confidence'],
+            $insights->ipAddress->anonymizer->confidence,
+            'correct anonymizer confidence'
+        );
+
+        $this->assertSame(
+            $array['ip_address']['anonymizer']['provider_name'],
+            $insights->ipAddress->anonymizer->providerName,
+            'correct anonymizer provider name'
+        );
+
+        $this->assertSame(
+            $array['ip_address']['anonymizer']['network_last_seen'],
+            $insights->ipAddress->anonymizer->networkLastSeen,
+            'correct anonymizer network last seen'
+        );
+
         $this->assertSame(
             $array['billing_phone']['country'],
             $insights->billingPhone->country,

tests/data/minfraud/factors-response.json

@@ -111,6 +111,16 @@
       "network": "152.216.7.0/24",
       "organization": "STONEHOUSE office network",
       "user_type": "government"
+    },
+    "anonymizer": {
+      "confidence": 99,
+      "is_anonymous": true,
+      "is_anonymous_vpn": true,
+      "is_hosting_provider": true,
+      "is_public_proxy": true,
+      "is_tor_exit_node": true,
+      "network_last_seen": "2025-01-15",
+      "provider_name": "TestVPN"
     }
   },
   "billing_address": {

tests/data/minfraud/insights-response.json

@@ -111,6 +111,16 @@
       "network": "152.216.7.0/24",
       "organization": "STONEHOUSE office network",
       "user_type": "government"
+    },
+    "anonymizer": {
+      "confidence": 99,
+      "is_anonymous": true,
+      "is_anonymous_vpn": true,
+      "is_hosting_provider": true,
+      "is_public_proxy": true,
+      "is_tor_exit_node": true,
+      "network_last_seen": "2025-01-15",
+      "provider_name": "TestVPN"
     }
   },
   "billing_address": {