Add email domain outputs support

Add support for new email domain outputs in minFraud Insights and Factors:
- New EmailDomainVisit model with status, last_visited_on, and has_redirect
- New EmailDomain fields: classification, risk, volume, and visit
- Updated test fixtures and integration tests
- Updated HISTORY.rst and CLAUDE.md documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

Author: oschwald

CLAUDE.md

@@ -318,7 +318,7 @@ When adding email normalization rules to `request.py`:
 
 Always update `HISTORY.rst` for user-facing changes.
 
-**Important**: Do not add a date to changelog entries until release time. Version numbers are added but without dates.
+**Important**: Do not add a date to changelog entries until release time. A version number without a date indicates an unreleased version. Only add the date when the version is actually released.
 
 Format:
 ```rst

HISTORY.rst

@@ -17,6 +17,17 @@ History
   transaction.
 * Added the input ``/payment/method``. This is the payment method associated
   with the transaction.
+* Added new ``EmailDomainVisit`` model class with ``status``,
+  ``last_visited_on``, and ``has_redirect`` attributes. This class provides
+  information from automated visits to email domains.
+* Added new attributes to ``minfraud.models.EmailDomain``:
+  * ``classification`` - A classification of the email domain (``business``,
+    ``education``, ``government``, or ``isp_email``).
+  * ``risk`` - The risk associated with the domain (0.01 to 99).
+  * ``volume`` - Activity on the email domain across the minFraud network,
+    expressed in sightings per million (0.001 to 1,000,000).
+  * ``visit`` - An ``EmailDomainVisit`` object containing information from
+    an automated visit to the email domain.
 
 3.1.0 (2025-05-23)
 ++++++++++++++++++

src/minfraud/models.py

@@ -285,6 +285,39 @@ def __init__(
         self.rule_label = rule_label
 
 
+class EmailDomainVisit(_Serializable):
+    """Information from an automated visit to the email domain."""
+
+    status: str | None
+    """A classification of the status of the domain based on an automated visit.
+    This will be one of the following values: ``live``, ``dns_error``,
+    ``network_error``, ``http_error``, ``parked``, or ``pre_development``.
+    Additional values may be added in the future."""
+
+    last_visited_on: str | None
+    """A date string (e.g. 2019-01-01) to identify the date when the automated
+    visit to the domain was completed. This is expressed using the ISO 8601 date
+    format YYYY-MM-DD."""
+
+    has_redirect: bool | None
+    """This is ``True`` if the domain in the request has redirects (configured
+    to automatically send visitors to another URL). Otherwise the key is omitted.
+    When ``True``, the ``status`` corresponds to the final redirected domain."""
+
+    def __init__(
+        self,
+        *,
+        status: str | None = None,
+        last_visited_on: str | None = None,
+        has_redirect: bool | None = None,
+        **_: Any,
+    ) -> None:
+        """Initialize an EmailDomainVisit instance."""
+        self.status = status
+        self.last_visited_on = last_visited_on
+        self.has_redirect = has_redirect
+
+
 class EmailDomain(_Serializable):
     """Information about the email domain passed in the request."""
 
@@ -293,9 +326,42 @@ class EmailDomain(_Serializable):
     was first seen by MaxMind. This is expressed using the ISO 8601 date
     format."""
 
-    def __init__(self, *, first_seen: str | None = None, **_: Any) -> None:
+    classification: str | None
+    """A classification of the domain. This will be one of the following values:
+    ``business``, ``education``, ``government``, or ``isp_email``. Additional
+    values may be added in the future."""
+
+    risk: float | None
+    """This field contains the risk associated with the domain. The value ranges
+    from 0.01 to 99. A higher score indicates higher risk."""
+
+    volume: float | None
+    """This field indicates the activity on an email domain across the minFraud
+    network, expressed in sightings per million. The value ranges from 0.001 to
+    1,000,000. Values are rounded to 2 significant figures."""
+
+    visit: EmailDomainVisit
+    """An object containing information from an automated visit to the email
+    domain. This object may be populated after an automated visit has been
+    completed. For newly sighted domains, the visit information may take some
+    time to appear. Visit information is limited to low-volume domains only."""
+
+    def __init__(
+        self,
+        *,
+        first_seen: str | None = None,
+        classification: str | None = None,
+        risk: float | None = None,
+        volume: float | None = None,
+        visit: dict[str, Any] | None = None,
+        **_: Any,
+    ) -> None:
         """Initialize an EmailDomain instance."""
         self.first_seen = first_seen
+        self.classification = classification
+        self.risk = risk
+        self.volume = volume
+        self.visit = EmailDomainVisit(**(visit or {}))
 
 
 class Email(_Serializable):

tests/data/factors-response.json

@@ -150,7 +150,15 @@
   },
   "email": {
     "domain": {
-      "first_seen": "2014-02-23"
+      "first_seen": "2014-02-23",
+      "classification": "business",
+      "risk": 1.23,
+      "volume": 37000,
+      "visit": {
+        "status": "live",
+        "last_visited_on": "2024-01-15",
+        "has_redirect": false
+      }
     },
     "first_seen": "2017-01-02",
     "is_disposable": true,

tests/data/insights-response.json

@@ -150,7 +150,15 @@
   },
   "email": {
     "domain": {
-      "first_seen": "2014-02-23"
+      "first_seen": "2014-02-23",
+      "classification": "business",
+      "risk": 1.23,
+      "volume": 37000,
+      "visit": {
+        "status": "live",
+        "last_visited_on": "2024-01-15",
+        "has_redirect": false
+      }
     },
     "first_seen": "2017-01-02",
     "is_disposable": true,

tests/test_models.py

@@ -10,6 +10,7 @@
     Disposition,
     Email,
     EmailDomain,
+    EmailDomainVisit,
     Factors,
     GeoIP2Location,
     Insights,
@@ -108,6 +109,18 @@ def test_disposition(self) -> None:
         self.assertEqual("default", disposition.reason)
         self.assertEqual("custom rule label", disposition.rule_label)
 
+    def test_email_domain_visit(self) -> None:
+        last_visited_on = "2024-01-15"
+        visit = EmailDomainVisit(
+            status="live",
+            last_visited_on=last_visited_on,
+            has_redirect=True,
+        )
+
+        self.assertEqual("live", visit.status)
+        self.assertEqual(last_visited_on, visit.last_visited_on)
+        self.assertEqual(True, visit.has_redirect)
+
     def test_email(self) -> None:
         first_seen = "2016-01-01"
         email = Email(
@@ -124,11 +137,26 @@ def test_email(self) -> None:
 
     def test_email_domain(self) -> None:
         first_seen = "2016-01-01"
+        last_visited_on = "2024-01-15"
         domain = EmailDomain(
             first_seen=first_seen,
+            classification="business",
+            risk=1.23,
+            volume=37000,
+            visit={
+                "status": "live",
+                "last_visited_on": last_visited_on,
+                "has_redirect": False,
+            },
         )
 
         self.assertEqual(first_seen, domain.first_seen)
+        self.assertEqual("business", domain.classification)
+        self.assertEqual(1.23, domain.risk)
+        self.assertEqual(37000, domain.volume)
+        self.assertEqual("live", domain.visit.status)
+        self.assertEqual(last_visited_on, domain.visit.last_visited_on)
+        self.assertEqual(False, domain.visit.has_redirect)
 
     def test_geoip2_location(self) -> None:
         time = "2015-04-19T12:59:23-01:00"
@@ -357,7 +385,20 @@ def factors_response(self) -> dict[str, Any]:
                 "type": "debit",
             },
             "device": {"id": "b643d445-18b2-4b9d-bad4-c9c4366e402a"},
-            "email": {"domain": {"first_seen": "2014-02-23"}, "is_free": True},
+            "email": {
+                "domain": {
+                    "first_seen": "2014-02-23",
+                    "classification": "business",
+                    "risk": 1.23,
+                    "volume": 37000,
+                    "visit": {
+                        "status": "live",
+                        "last_visited_on": "2024-01-15",
+                        "has_redirect": False,
+                    },
+                },
+                "is_free": True,
+            },
             "shipping_address": {"is_in_ip_country": True},
             "shipping_phone": {"is_voip": True},
             "billing_address": {"is_in_ip_country": True},
@@ -412,6 +453,12 @@ def check_insights_data(self, insights: Insights | Factors, uuid: str) -> None:
         self.assertEqual("reject", insights.disposition.action)
         self.assertEqual(True, insights.email.is_free)
         self.assertEqual("2014-02-23", insights.email.domain.first_seen)
+        self.assertEqual("business", insights.email.domain.classification)
+        self.assertEqual(1.23, insights.email.domain.risk)
+        self.assertEqual(37000, insights.email.domain.volume)
+        self.assertEqual("live", insights.email.domain.visit.status)
+        self.assertEqual("2024-01-15", insights.email.domain.visit.last_visited_on)
+        self.assertEqual(False, insights.email.domain.visit.has_redirect)
         self.assertEqual(True, insights.shipping_phone.is_voip)
         self.assertEqual(True, insights.shipping_address.is_in_ip_country)
         self.assertEqual(True, insights.billing_address.is_in_ip_country)