Add residential field to Anonymizer response

The minFraud Insights and Factors responses now include a residential
object inside the ip_address anonymizer object. This is surfaced via
the AnonymizerFeed record on the geoip2 Anonymizer record, which
IpAddress reuses, so no model changes are needed here. Update the test
fixtures and assertions to cover the new field and document the
required geoip2 dependency bump in the changelog.

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

Author: oschwald

CHANGELOG.md

@@ -1,6 +1,15 @@
 CHANGELOG
 =========
 
+4.4.0 (unreleased)
+------------------
+
+* Added `residential` field to the `Anonymizer` response record. This is
+  an `AnonymizerFeed` record containing `confidence`, `networkLastSeen`,
+  and `providerName` fields with residential proxy data for the network.
+  `residential` may be populated even when none of the other fields on
+  `Anonymizer` are set.
+
 4.3.0 (2026-05-12)
 ------------------
 

src/test/java/com/maxmind/minfraud/response/InsightsResponseTest.java

@@ -6,6 +6,7 @@
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
 import com.fasterxml.jackson.jr.ob.JSON;
+import com.maxmind.geoip2.record.AnonymizerFeed;
 import java.time.LocalDate;
 import java.util.UUID;
 import org.junit.jupiter.api.Test;
@@ -39,6 +40,11 @@ public void testInsights() throws Exception {
                 .put("is_tor_exit_node", true)
                 .put("network_last_seen", "2025-01-15")
                 .put("provider_name", "TestVPN")
+                .startObjectField("residential")
+                .put("confidence", 82)
+                .put("network_last_seen", "2026-05-11")
+                .put("provider_name", "quickshift")
+                .end()
                 .end()
                 .startObjectField("country")
                 .put("iso_code", "US")
@@ -152,5 +158,24 @@ public void testInsights() throws Exception {
             "correct networkLastSeen"
         );
         assertEquals("TestVPN", insights.ipAddress().anonymizer().providerName(), "correct providerName");
+
+        AnonymizerFeed residential = insights.ipAddress().anonymizer().residential();
+
+        assertNotNull(residential, "anonymizer.residential() returns null");
+        assertEquals(
+            Integer.valueOf(82),
+            residential.confidence(),
+            "correct anonymizer.residential().confidence()"
+        );
+        assertEquals(
+            LocalDate.parse("2026-05-11"),
+            residential.networkLastSeen(),
+            "correct anonymizer.residential().networkLastSeen()"
+        );
+        assertEquals(
+            "quickshift",
+            residential.providerName(),
+            "correct anonymizer.residential().providerName()"
+        );
     }
 }

src/test/resources/test-data/factors-response.json

@@ -24,7 +24,12 @@
       "is_residential_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"
+      }
     },
     "city": {
       "confidence": 42,

src/test/resources/test-data/insights-response.json

@@ -24,7 +24,12 @@
       "is_residential_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"
+      }
     },
     "city": {
       "confidence": 42,