Add email domain outputs

This adds support for new email domain outputs including classification,
risk score, volume, and automated visit information. These outputs are
available on the Insights and Factors responses.

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

Co-Authored-By: Claude <[email protected]>

Author: oschwald

CHANGELOG.md

@@ -15,6 +15,25 @@
 * Added the input `/payment/method`. This is the payment method associated
   with the transaction. You may provide this using the `method` attribute
   on `Minfraud::Components::Payment`.
+* Added support for new email domain outputs on `Minfraud::Model::EmailDomain`:
+  * `/email/domain/classification` - The domain type (e.g., business,
+    education, government, isp_email). Available as the `classification`
+    attribute.
+  * `/email/domain/risk` - A risk score from 0.01 to 99 for the domain.
+    Available as the `risk` attribute.
+  * `/email/domain/volume` - Activity across the minFraud network expressed
+    as sightings per million. Available as the `volume` attribute.
+  * `/email/domain/visit` - Information from an automated visit to the
+    domain. Available as the `visit` attribute, which returns a
+    `Minfraud::Model::EmailDomainVisit` object.
+* Added support for email domain visit outputs on
+  `Minfraud::Model::EmailDomainVisit`:
+  * `/email/domain/visit/has_redirect` - Whether the domain redirects to
+    another URL. Available as the `has_redirect` attribute.
+  * `/email/domain/visit/last_visited_on` - The date the automated visit
+    was completed. Available as the `last_visited_on` attribute.
+  * `/email/domain/visit/status` - The status of the domain (e.g., live,
+    dns_error, parked). Available as the `status` attribute.
 
 ## v2.8.0 (2025-05-23)
 

lib/minfraud/model/email_domain.rb

@@ -1,23 +1,55 @@
 # frozen_string_literal: true
 
 require 'minfraud/model/abstract'
+require 'minfraud/model/email_domain_visit'
 
 module Minfraud
   module Model
     # Model containing information about the email domain.
     class EmailDomain < Abstract
+      # A classification of the domain. Possible values are:
+      # * business
+      # * education
+      # * government
+      # * isp_email
+      #
+      # @return [String, nil]
+      attr_reader :classification
+
       # A date string (e.g. 2017-04-24) to identify the date an email domain
       # was first seen by MaxMind. This is expressed using the ISO 8601 date
       # format.
       #
       # @return [String, nil]
       attr_reader :first_seen
 
+      # A risk score ranging from 0.01 to 99. Higher values indicate greater
+      # risk.
+      #
+      # @return [Float, nil]
+      attr_reader :risk
+
+      # An object containing information about an automated visit to the email
+      # domain.
+      #
+      # @return [Minfraud::Model::EmailDomainVisit, nil]
+      attr_reader :visit
+
+      # Activity across the minFraud network expressed as sightings per
+      # million. The value ranges from 0.001 to 1,000,000.
+      #
+      # @return [Float, nil]
+      attr_reader :volume
+
       # @!visibility private
       def initialize(record)
         super
 
-        @first_seen = get('first_seen')
+        @classification = get('classification')
+        @first_seen     = get('first_seen')
+        @risk           = get('risk')
+        @visit          = EmailDomainVisit.new(get('visit'))
+        @volume         = get('volume')
       end
     end
   end

lib/minfraud/model/email_domain_visit.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'minfraud/model/abstract'
+
+module Minfraud
+  module Model
+    # Model containing information about an automated visit to the email
+    # domain.
+    class EmailDomainVisit < Abstract
+      # Whether the domain redirects to another URL.
+      #
+      # @return [Boolean, nil]
+      attr_reader :has_redirect
+
+      # A date string (e.g. 2025-11-15) identifying the date the automated
+      # visit was completed. This is expressed using the ISO 8601 date format.
+      #
+      # @return [String, nil]
+      attr_reader :last_visited_on
+
+      # The status of the domain. Possible values are:
+      # * live - The domain is operational and serving content.
+      # * dns_error - The domain has missing, expired, or misconfigured DNS.
+      # * network_error - The domain is offline or unreachable.
+      # * http_error - The domain is reachable, but has an application error.
+      # * parked - The domain is reachable and in a parked state.
+      # * pre_development - The domain is reachable and in a pre-development
+      #   state.
+      #
+      # @return [String, nil]
+      attr_reader :status
+
+      # @!visibility private
+      def initialize(record)
+        super
+
+        @has_redirect    = get('has_redirect')
+        @last_visited_on = get('last_visited_on')
+        @status          = get('status')
+      end
+    end
+  end
+end

spec/fixtures/files/factors-response1.json

@@ -159,6 +159,17 @@
     "local_time": "2017-06-08T14:16:38Z"
   },
   "email": {
+    "domain": {
+      "classification": "education",
+      "first_seen": "2019-05-20",
+      "risk": 2.5,
+      "visit": {
+        "has_redirect": false,
+        "last_visited_on": "2025-11-10",
+        "status": "parked"
+      },
+      "volume": 150.75
+    },
     "first_seen": "2017-01-02",
     "is_disposable": true,
     "is_free": true,

spec/fixtures/files/insights-response1.json

@@ -180,7 +180,15 @@
   },
   "email": {
     "domain": {
-      "first_seen": "2016-01-03"
+      "classification": "business",
+      "first_seen": "2016-01-03",
+      "risk": 1.23,
+      "visit": {
+        "has_redirect": true,
+        "last_visited_on": "2025-11-15",
+        "status": "live"
+      },
+      "volume": 6.5
     },
     "first_seen": "2017-01-02",
     "is_disposable": true,

spec/model/insights_spec.rb

@@ -118,7 +118,13 @@
       expect(m.device.last_seen).to eq '2016-06-08T14:16:38Z'
       expect(m.device.local_time).to eq '2017-06-08T14:16:38Z'
 
+      expect(m.email.domain.classification).to eq 'business'
       expect(m.email.domain.first_seen).to eq '2016-01-03'
+      expect(m.email.domain.risk).to eq 1.23
+      expect(m.email.domain.visit.has_redirect).to be true
+      expect(m.email.domain.visit.last_visited_on).to eq '2025-11-15'
+      expect(m.email.domain.visit.status).to eq 'live'
+      expect(m.email.domain.volume).to eq 6.5
       expect(m.email.first_seen).to eq '2017-01-02'
       expect(m.email.is_disposable).to be true
       expect(m.email.is_free).to be true
@@ -197,7 +203,13 @@
       expect(m.device.confidence).to be_nil
       expect(m.device.id).to eq '7835b099-d385-4e5b-969e-7df26181d73b'
 
+      expect(m.email.domain.classification).to be_nil
       expect(m.email.domain.first_seen).to be_nil
+      expect(m.email.domain.risk).to be_nil
+      expect(m.email.domain.visit.has_redirect).to be_nil
+      expect(m.email.domain.visit.last_visited_on).to be_nil
+      expect(m.email.domain.visit.status).to be_nil
+      expect(m.email.domain.volume).to be_nil
       expect(m.email.first_seen).to be_nil
       expect(m.email.is_disposable).to be true