Add residential proxy data to anonymizer object

CHANGELOG.md

@@ -1,6 +1,26 @@
 CHANGELOG
 =========
 
+9.1.0 (unreleased)
+------------------
+
+* A new `residential` property has been added to the `anonymizer` object on
+  `IpAddress`. This is sourced from the GeoIP Residential Proxy database and
+  is available from the minFraud Insights and Factors web services only. As
+  the residential proxy feed is a superset of what is available in Anonymous
+  Plus, the `anonymizer` object may now contain only the `residential`
+  property. The `residential` object includes the following properties:
+  * `confidence`: A score (1-99) representing MaxMind's confidence that the
+    network is part of an actively used residential proxy
+  * `networkLastSeen`: The last day (YYYY-MM-DD) the network was sighted in
+    our analysis of the residential proxy feed
+  * `providerName`: The name of the residential proxy provider associated
+    with the network
+* This release requires `@maxmind/geoip2-node` 7.1.0 or greater, which adds
+  the `residential` property to the `AnonymizerRecord` type. The
+  `@maxmind/geoip2-node` dependency will be bumped to `^7.1.0` once that
+  version is released.
+
 9.0.0 (2026-06-29)
 ------------------
 

fixtures/insights.json

@@ -34,7 +34,12 @@
           "is_residential_proxy": false,
           "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": 25,

src/response/models/insights.spec.ts

@@ -76,6 +76,11 @@ describe('Insights()', () => {
       isTorExitNode: true,
       networkLastSeen: '2025-01-15',
       providerName: 'TestVPN',
+      residential: {
+        confidence: 82,
+        networkLastSeen: '2026-05-11',
+        providerName: 'quickshift',
+      },
     });
   });