email_domain_checker 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 946d5e9368662216b21d1dfa1434edbdbe992b6c1354d3b53b73a62e8d262a06
-  data.tar.gz: 9e47f0583115b145f461d7fcbc2cda5a4db3abe263a8edab82df98d160242431
+  metadata.gz: 0cfee88066764e2eb7e65860751c532baa42fad3066ea868245d57786c826a8d
+  data.tar.gz: 04c3ae92d49eddf9979755d2d60e1c2e3bfd77d7f8acb762beefd4bcb6eb01e9
 SHA512:
-  metadata.gz: c333b2f6dd62889860581493a2453ee0f16db2f9db024f3f3ff8db88c2496e4d438221ff31a55d8fc2fd3174d5aec834615e221a2e49b377c22dc4bc3c569ed3
-  data.tar.gz: 2fd79606ecdf91e1c665b71ccb343f2b3703082db2c5d63085919435fabc7955f89cae73d2a66a8fefb9c8d4d26611b25346e06c4b69f6e1958852f2228f8b0e
+  metadata.gz: be4b1fc7445f80308a1ca93af0d068c4ded227ad59b630cb374c1c63e8a7bcf2d8b5ed8c75ef0ff09dfae937eaaec205358e637b0e4f0bb72dc6e4a46bb79553
+  data.tar.gz: e4b1ed6439c71e06918488023a94d99334015af247846ab611076db9caf9c66a4ad4a1263562720ba1f54c6ae1cf0fec6329e636d5d8b1a420865cfacad9d130

data/README.md

@@ -73,6 +73,51 @@ checker = EmailDomainChecker::Checker.new("user@example.com")
 checker.redacted_email # => "{hash}@example.com"
 ```
 
+### ActiveModel/ActiveRecord Integration
+
+When ActiveModel is available, you can use the `DomainCheckValidator` for easy validation and normalization in your models:
+
+```ruby
+class User < ActiveRecord::Base
+  validates :email, domain_check: { check_mx: true, timeout: 3 }, normalize: true
+end
+```
+
+#### Options
+
+- `domain_check`: Hash of options for domain validation
+  - `check_mx`: Check MX records (default: `true`)
+  - `check_a`: Check A records (default: `false`)
+  - `timeout`: DNS query timeout in seconds (default: `5`)
+  - `validate_format`: Validate email format (default: `true`)
+  - `validate_domain`: Validate domain (default: `true`)
+- `normalize`: Normalize email before validation (default: `false`)
+- `message`: Custom error message
+
+#### Examples
+
+```ruby
+# Basic validation with domain check
+class User < ActiveRecord::Base
+  validates :email, domain_check: { check_mx: true, timeout: 3 }
+end
+
+# Format validation only (skip domain check)
+class User < ActiveRecord::Base
+  validates :email, domain_check: { validate_domain: false }
+end
+
+# With automatic normalization
+class User < ActiveRecord::Base
+  validates :email, domain_check: { check_mx: true }, normalize: true
+end
+
+# With custom error message
+class User < ActiveRecord::Base
+  validates :email, domain_check: { check_mx: true }, message: "Invalid email address"
+end
+```
+
 ### Configuration Options
 
 - `validate_format`: Validate email format using email_address gem (default: true)

data/lib/email_domain_checker/active_model_validator.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+require "active_model"
+
+require_relative "checker"
+require_relative "normalizer"
+
+module EmailDomainChecker
+  # ActiveModel validator for email domain checking
+  #
+  # Usage:
+  #   class User < ActiveRecord::Base
+  #     validates :email, domain_check: { check_mx: true, timeout: 3 }, normalize: true
+  #   end
+  #
+  # Options:
+  #   - domain_check: Hash of options for domain validation
+  #     * check_mx: Boolean (default: true) - Check MX records
+  #     * check_a: Boolean (default: false) - Check A records
+  #     * timeout: Integer (default: 5) - DNS query timeout in seconds
+  #     * validate_format: Boolean (default: true) - Validate email format
+  #     * validate_domain: Boolean (default: true) - Validate domain
+  #   - normalize: Boolean (default: false) - Normalize email before validation
+  #   - message: String or Symbol - Custom error message
+  class DomainCheckValidator < ActiveModel::EachValidator
+    def validate_each(record, attribute, value)
+      return if value.blank?
+
+      # ActiveModel passes domain_check hash contents directly to options
+      # when using validates :email, domain_check: { normalize: false }
+      # So options will be { validate_domain: false, normalize: false } etc.
+      normalize_option = options[:normalize] == true
+
+      original_value = value.is_a?(String) ? value : value.to_s
+      normalized_value = normalize_option ? Normalizer.normalize(original_value) : original_value
+
+      if normalize_option && normalized_value != original_value
+        record.public_send("#{attribute}=", normalized_value)
+      end
+
+      validation_options = build_validation_options(record, attribute)
+      value_for_checker = normalize_option ? normalized_value : original_value
+      checker = Checker.new(value_for_checker, validation_options)
+
+      unless checker.valid?
+        error_message = error_message_for(record, attribute, checker)
+        record.errors.add(attribute, error_message[:key], message: error_message[:message])
+      end
+    end
+
+    private
+
+    def build_validation_options(record, attribute)
+      default_options = {
+        validate_format: true,
+        validate_domain: true,
+        check_mx: true,
+        check_a: false,
+        timeout: 5
+      }
+
+      # ActiveModel passes domain_check hash contents directly to options
+      # Exclude normalize and message from validation options
+      domain_check_options = options.reject { |k, _v| k == :normalize || k == :message }
+      default_options.merge(domain_check_options)
+    end
+
+    def error_message_for(record, attribute, checker)
+      message_option = options[:message]
+      if message_option
+        return {
+          key: :invalid,
+          message: message_option.is_a?(Symbol) ? record.errors.generate_message(attribute, message_option) : message_option
+        }
+      end
+
+      unless checker.format_valid?
+        return {
+          key: :invalid_format,
+          message: i18n_message("errors.messages.invalid_email_format", "is not a valid email format")
+        }
+      end
+
+      unless checker.domain_valid?
+        return {
+          key: :invalid_domain,
+          message: i18n_message("errors.messages.invalid_email_domain", "has an invalid domain")
+        }
+      end
+
+      {
+        key: :invalid,
+        message: i18n_message("errors.messages.invalid_email", "is not a valid email address")
+      }
+    end
+
+    def i18n_message(key, default)
+      return default unless defined?(I18n)
+
+      I18n.t(key, default: default)
+    rescue StandardError
+      default
+    end
+  end
+end
+
+DomainCheckValidator = EmailDomainChecker::DomainCheckValidator unless defined?(DomainCheckValidator)

data/lib/email_domain_checker/version.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
 module EmailDomainChecker
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end
-

data/lib/email_domain_checker.rb

@@ -8,6 +8,17 @@ require_relative "email_domain_checker/domain_validator"
 require_relative "email_domain_checker/email_address_adapter"
 require_relative "email_domain_checker/checker"
 
+# Conditionally load ActiveModel integration if ActiveModel is available
+begin
+  # Require logger gem for older Rails/ActiveModel versions on Ruby 3.4+
+  # This is needed because logger was removed from Ruby standard library in 3.4+
+  require "logger" if RUBY_VERSION >= "3.4"
+  require "active_model"
+  require_relative "email_domain_checker/active_model_validator"
+rescue LoadError
+  # ActiveModel is not available, skip integration
+end
+
 module EmailDomainChecker
   class Error < StandardError; end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: email_domain_checker
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Koki Tatematsu
@@ -79,6 +79,7 @@ files:
 - Rakefile
 - email_domain_checker.gemspec
 - lib/email_domain_checker.rb
+- lib/email_domain_checker/active_model_validator.rb
 - lib/email_domain_checker/checker.rb
 - lib/email_domain_checker/config.rb
 - lib/email_domain_checker/dns_resolver.rb