diff --git a/CHANGELOG.md b/CHANGELOG.md index 65b697c7..f8092564 100644 --- a/CHANGELOG.md +++ b/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) ------------------ diff --git a/fixtures/insights.json b/fixtures/insights.json index 8f2ef903..2e0f8935 100644 --- a/fixtures/insights.json +++ b/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, diff --git a/src/response/models/insights.spec.ts b/src/response/models/insights.spec.ts index 65718fca..b4ea2918 100644 --- a/src/response/models/insights.spec.ts +++ b/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', + }, }); });