Add residential property to anonymizer object

Surface the residential sub-object added to the anonymizer object in
the underlying GeoIP2 library (since 3.4.0). The IpAddress model
already exposes GeoIp2\Record\Anonymizer directly, so this is a test
fixture and CHANGELOG update only; no model code changes are needed.

STF-997

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: oschwald

CHANGELOG.md

@@ -4,6 +4,13 @@ CHANGELOG
 3.7.0
 ------------------
 
+* Added the `residential` property to the `anonymizer` object on
+  `MaxMind\MinFraud\Model\IpAddress`. This is a `GeoIp2\Record\AnonymizerFeed`
+  object providing residential proxy data for the network: `confidence`,
+  `networkLastSeen`, and `providerName`. It may be populated even when no
+  other anonymizer properties are set. This data is available from the
+  minFraud Insights and Factors web services. This requires
+  `geoip2/geoip2` 3.4.0 or greater.
 * Added `tracking_token` to the `/device` request object. This is the
   token generated by the
   [Device Tracking Add-on](https://dev.maxmind.com/minfraud/track-devices)

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

@@ -4,6 +4,7 @@
 
 namespace MaxMind\Test\MinFraud\Model;
 
+use GeoIp2\Record\AnonymizerFeed;
 use MaxMind\MinFraud\Model\Insights;
 use MaxMind\MinFraud\Model\Score;
 use MaxMind\Test\MinFraudData as Data;
@@ -156,6 +157,30 @@ public function testInsightsProperties(): void
             'correct anonymizer network last seen'
         );
 
+        $this->assertInstanceOf(
+            AnonymizerFeed::class,
+            $insights->ipAddress->anonymizer->residential,
+            'anonymizer residential is an AnonymizerFeed'
+        );
+
+        $this->assertSame(
+            $array['ip_address']['anonymizer']['residential']['confidence'],
+            $insights->ipAddress->anonymizer->residential->confidence,
+            'correct anonymizer residential confidence'
+        );
+
+        $this->assertSame(
+            $array['ip_address']['anonymizer']['residential']['network_last_seen'],
+            $insights->ipAddress->anonymizer->residential->networkLastSeen,
+            'correct anonymizer residential network last seen'
+        );
+
+        $this->assertSame(
+            $array['ip_address']['anonymizer']['residential']['provider_name'],
+            $insights->ipAddress->anonymizer->residential->providerName,
+            'correct anonymizer residential provider name'
+        );
+
         $this->assertSame(
             $array['billing_phone']['country'],
             $insights->billingPhone->country,

tests/data/minfraud/factors-response.json

@@ -120,7 +120,12 @@
       "is_public_proxy": true,
       "is_tor_exit_node": true,
       "network_last_seen": "2025-01-15",
-      "provider_name": "TestVPN"
+      "provider_name": "TestVPN",
+      "residential": {
+        "confidence": 82,
+        "network_last_seen": "2026-05-11",
+        "provider_name": "quickshift"
+      }
     }
   },
   "billing_address": {

tests/data/minfraud/insights-response.json

@@ -120,7 +120,12 @@
       "is_public_proxy": true,
       "is_tor_exit_node": true,
       "network_last_seen": "2025-01-15",
-      "provider_name": "TestVPN"
+      "provider_name": "TestVPN",
+      "residential": {
+        "confidence": 82,
+        "network_last_seen": "2026-05-11",
+        "provider_name": "quickshift"
+      }
     }
   },
   "billing_address": {