minfraud 1.4.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa255a8f579aa729b4ceeb84db99f283bafdc2276fc6eba3d52e6133a8e2d4ea
-  data.tar.gz: 1d9717004f0f07eadf3d986f4f697f4d2c41ef7c08c21b9b1f3b7e6291c36286
+  metadata.gz: e2805f5d3d40b2d325926a4a5614b86248bba07f905ffb37ec7dfa9589e97103
+  data.tar.gz: 6d70e15b76a295c376232e6bf277e619ed783c23e46460e89e527458813b44ec
 SHA512:
-  metadata.gz: a57eac0733d6c1d64319c80f458f00585897030433414ab0b4888606fedafac833e5fd1298fe608f8a343b87536ad2974bc794bba9317a5043980aa689c2e0cd
-  data.tar.gz: 0ef9a279e2ed6d9a08b3f972338f7ade34ecf1f2c409e6777333c9a6afcf1dbab3c03927b8e6a350c54ed4dd2c86bdd64672a36f51caa2087bfb8e53ab824b2a
+  metadata.gz: 7a4e77f3d92e6173426e5151b234badc9fbe2503e41178d104eeda51c016835c6459308eaaa810063666030369e89828f1919731add25be6b51e0bf50821704a
+  data.tar.gz: a07520d278d5191c2ac5dc9684d9d52ca670a494b088b56b4f8b920a0198ad53469e473d8114e9d33a891e4daa3f5ffa3573cf2190284dfb993b7e57742f9ca3

data/.github/dependabot.yml

@@ -0,0 +1,7 @@
+version: 2
+updates:
+- package-ecosystem: bundler
+  directory: "/"
+  schedule:
+    interval: daily
+  open-pull-requests-limit: 10

data/.github/workflows/rubocop.yml

@@ -7,6 +7,6 @@ jobs:
       - uses: actions/checkout@v2
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 2.7
+          ruby-version: 3.1
       - run: bundle install
       - run: bundle exec rake -t rubocop

data/.github/workflows/test.yml

@@ -9,13 +9,11 @@ jobs:
         os: [ubuntu-latest, windows-latest, macos-latest]
         version:
           [
-            2.1,
-            2.2,
-            2.3,
-            2.4,
             2.5,
             2.6,
             2.7,
+            '3.0',
+            3.1,
             jruby,
           ]
         exclude:

data/.rubocop.yml

@@ -1,5 +1,6 @@
-Gemspec/RequiredRubyVersion:
-  Enabled: false # We support 2.1+, but rubocop supports 2.4+.
+AllCops:
+    TargetRubyVersion: 2.5
+    NewCops: enable
 
 # Metrics.
 
@@ -39,7 +40,7 @@ Layout/IndentationStyle:
 # Style.
 
 Style/HashSyntax:
-  EnforcedStyle: ruby19_no_mixed_keys # Default is ruby19.
+  EnforcedStyle: ruby19_no_mixed_keys # Default is ruby19. This one is better.
 
 Style/CollectionMethods:
   Enabled: true # Default is false.
@@ -53,9 +54,6 @@ Style/NegatedIf: # I disagree with this.
 Style/IfUnlessModifier: # This doesn't always make sense.
   Enabled: false
 
-Style/SymbolArray:
-  EnforcedStyle: brackets # Default is percent, but 1.9 doesn't support that.
-
 # Trailing commas are often good.
 Style/TrailingCommaInArguments:
   Enabled: false
@@ -64,9 +62,6 @@ Style/TrailingCommaInArrayLiteral:
 Style/TrailingCommaInHashLiteral:
   Enabled: false
 
-Style/SafeNavigation:
-  Enabled: false # Default is true, but this 1.9 doesn't support it.
-
 # Default is both which is probably fine, but it changes code and I don't want
 # to investigate any possible behavior change right now.
 Style/EmptyElse:
@@ -75,25 +70,12 @@ Style/EmptyElse:
 Style/ConditionalAssignment:
   Enabled: false # This produces kind of strange results.
 
-Style/Dir:
-  Enabled: false # This is good, but not supported on 1.9.
-
-Style/ExpandPathArguments:
-  Enabled: false # This causes us to use __dir__ which 1.9 doesn't support.
-
 Style/GuardClause:
   Enabled: false # Doesn't always make sense.
 
-Style/Documentation:
-  Enabled: false # We should enable this, but allow for pre-existing code.
-
 Style/FormatStringToken:
   Enabled: false # Seems unnecessary.
 
-# Asks to use x.negative? instead of x < 0. But this isn't available until 2.3.
-Style/NumericPredicate:
-  Enabled: false
-
 # Seems unnecessary. Asks us to call super in a bunch of places when there's no
 # need.
 Lint/MissingSuper:
@@ -103,6 +85,3 @@ Lint/MissingSuper:
 
 Naming/VariableNumber:
   Enabled: false # Doesn't always make sense.
-
-AllCops:
-  NewCops: enable

data/CHANGELOG.md

@@ -1,4 +1,98 @@
-# Minfraud Changelog
+# Changelog
+
+## v2.1.0 (2022-01-25)
+
+* Adds the following new processor to `Minfraud::Components::Payment`:
+  * `:windcave`
+* The `last_4_digits` input to `Minfraud::Components::CreditCard` has been
+  deprecated in favor of `last_digits` and will be removed in a future
+  release. `last_digits`/`last_4_digits` also now supports two digit values
+  in addition to the previous four digit values.
+* Eight digit `issuer_id_number` inputs are now supported by
+  `Minfraud::Components::CreditCard` in addition to the previously accepted
+  six digit `issuer_id_number`. In most cases, you should send the last four
+  digits for `last_digits`. If you send an `issuer_id_number` that contains
+  an eight digit IIN, and if the credit card brand is not one of the
+  following, you should send the last two digits for `last_digits`:
+  * `Discover`
+  * `JCB`
+  * `Mastercard`
+  * `UnionPay`
+  * `Visa`
+
+## v2.0.0 (2021-12-06)
+
+* Breaking change from 1.x: Removed deprecated methods
+  `is_in_european_union`, `is_anonymous`, `is_anonymous_vpn`,
+  `is_hosting_provider`, `is_public_proxy`, and `is_tor_exit_node`. The
+  non-deprecated equivalents are `in_european_union?`, `anonymous?`,
+  `anonymous_vpn?`, `hosting_provider?`, `public_proxy?`, and
+  `tor_exit_node?`.
+* Breaking change from 1.x: Removed deprecated methods for deprecated
+  subscores: `email_tenure` and `ip_tenure`. For `email_tenure`, please use
+  the `email_address` subscore instead. For `ip_tenure`, please use
+  `risk_score` instead.
+* Breaking change from 1.x: Removed deprecated method for deprecated
+  attribute `ip_address.country.is_high_risk`.
+* Breaking change from 1.x: Switches HTTP client from faraday to http.rb.
+  There should be no behavior change for most users, but this is
+  technically a breaking change from the perspective of semver. Most users
+  should not be affected as the changes are limited to attributes and
+  classes that would not normally be accessed outside the gem.
+* Breaking change from 1.x: `user_id` is no longer supported as a way to
+  configure your MaxMind account ID. Use `account_id` instead.
+* Breaking change from 1.x: Removed the `Minfraud.configuration` method.
+* Breaking change from 1.x: Localized names are no longer exposed via
+  methods on `names` objects, only as hash keys. For example, use
+  `response.ip_address.country.names['en']` instead of
+  `response.ip_address.country.names.en`. The latter was deprecated.
+* Adds mobile country code (MCC) and mobile network code (MNC) to minFraud
+  Insights and Factors responses. These are available at
+  `response.ip_address.traits.mobile_country_code` and
+  `response.ip_address.traits.mobile_network_code`. We expect this data to
+  be available by late January, 2022.
+* Adds the following new processors to `Minfraud::Components::Payment`:
+  * `:boacompra`
+  * `:boku`
+  * `:coregateway`
+  * `:fiserv`
+  * `:neopay`
+  * `:neosurf`
+  * `:openbucks`
+  * `:paysera`
+  * `:payvision`
+  * `:trustly`
+* Depend on the `maxmind-geoip2` gem. This allows us to delete classes from
+  that gem that we previously had included in this gem. There is no
+  functional difference.
+
+## v1.6.0 (2021-08-19)
+
+* Adds new processor to `Minfraud::Components::Payment`: `:cardknox`,
+  `:creditguard`, `:credorax`, `:datacap`, `:dlocal`, `:onpay`, and
+  `:safecharge`.
+* Adds `rule_label` to minFraud output `/disposition`.
+* Adds support for the `/credit_card/was_3d_secure_successful` input. This is
+  available by setting the `was_3d_secure_successful` attribute on
+  `Minfraud::Components::CreditCard`.
+* Ruby 2.5+ is now required. If you're using Ruby 2.1, 2.2, 2.3, or 2.4,
+  please use version 1.5.0 of this gem.
+
+## v1.5.0 (2021-02-02)
+
+* Adds the `hash_address` attribute to `Minfraud::Components::Email`. If
+  this is `true`, the MD5 hash of the `address` will be sent instead of the
+  plain text `address`. Use this if you prefer to send the hash of the
+  `address` rather than the plain text. Note that this normalizes the
+  `address`, so we recommend using it as opposed to hashing the `address`
+  manually.
+* The email `domain` input is now automatically set if the email `address`
+  input is set but the `domain` is not.
+* Adds new payment processors `:apple_pay` and `:aps_payments` to
+  `Minfraud::Components::Payment`.
+* Adds support for the IP address risk reasons in the minFraud Insights
+  and Factors responses. This is available at `.ip_address.risk_reasons`.
+  It is an array of `IPRiskReason` objects.
 
 ## v1.4.1 (2020-12-01)
 
@@ -10,7 +104,7 @@
 
 * IMPORTANT: Ruby 2.0 is no longer supported. If you're using Ruby 2.0,
   please use version 1.3.0.
-* Add handling for the `REQUEST_INVALID` error code.
+* Adds handling for the `REQUEST_INVALID` error code.
 * The IP address is no longer a required input.
 * Adds new payment processor `:tsys` to `Minfraud::Components::Payment`.
 
@@ -75,6 +169,7 @@
 * Adds `amount` attribute to the `Minfraud::Components::Order` instances
 
 ## v1.0.3 (2016-11-24)
+
 * Adds `token` attribute to the `Minfraud::Components::CreditCard` instances
 according to the MinFraud Release Notes introduced on November 17, 2016
 

data/Gemfile

@@ -2,13 +2,4 @@
 
 source 'https://rubygems.org'
 
-# coveralls fails on Ruby 1.9. My understanding is we don't need to run this on
-# more than one version anyway, so restrict to the current latest.
-version_pieces = RUBY_VERSION.split('.')
-major_version  = version_pieces[0]
-minor_version  = version_pieces[1]
-if major_version == '2' && minor_version == '7'
-  gem 'coveralls', require: false
-end
-
 gemspec

data/LICENSE.txt

@@ -1,7 +1,7 @@
 The MIT License (MIT)
 
 Copyright (c) 2016-2020 kushnir.yb
-Copyright (c) 2020 MaxMind, Inc.
+Copyright (c) 2020-2022 MaxMind, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.dev.md

@@ -1,4 +1,4 @@
 # How to release
 
 See
-[here](https://github.com/maxmind/MaxMind-DB-Reader-ruby/blob/master/README.dev.md).
+[here](https://github.com/maxmind/MaxMind-DB-Reader-ruby/blob/main/README.dev.md).

data/README.md

@@ -3,9 +3,9 @@
 ## Description
 
 This package provides an API for the [MaxMind minFraud web
-services](https://dev.maxmind.com/minfraud/). This includes minFraud Score,
+services](https://dev.maxmind.com/minfraud?lang=en). This includes minFraud Score,
 Insights, and Factors. It also includes our [minFraud Report Transaction
-API](https://dev.maxmind.com/minfraud/report-transaction/).
+API](https://dev.maxmind.com/minfraud/report-a-transaction?lang=en).
 
 The legacy minFraud Standard and Premium services are not supported by this
 API.
@@ -122,14 +122,15 @@ assessment = Minfraud::Assessments.new(
     decline_code:   'invalid number',
   },
   credit_card: {
-    issuer_id_number:        '411111',
-    last_4_digits:           '7643',
-    bank_name:               'Bank of No Hope',
-    bank_phone_country_code: '1',
-    bank_phone_number:       '123-456-1234',
-    token:                   'abcd',
-    avs_result:              'Y',
-    cvv_result:              'N',
+    issuer_id_number:         '411111',
+    last_digits:              '7643',
+    bank_name:                'Bank of No Hope',
+    bank_phone_country_code:  '1',
+    bank_phone_number:        '123-456-1234',
+    token:                    'abcd',
+    avs_result:               'Y',
+    cvv_result:               'N',
+    was_3d_secure_successful: true,
   },
   order: {
     amount:           323.21,
@@ -264,7 +265,7 @@ to the client API, please see
 
 ## Requirements
 
-This gem works with Ruby 2.1 and above.
+This gem works with Ruby 2.5 and above.
 
 ## Contributing
 
@@ -282,7 +283,7 @@ This API uses [Semantic Versioning](https://semver.org/).
 
 Copyright (c) 2016-2020 kushnir.yb.
 
-Copyright (c) 2020 MaxMind, Inc.
+Copyright (c) 2020-2022 MaxMind, Inc.
 
 The gem is available as open source under the terms of the [MIT
 License](https://opensource.org/licenses/MIT).

data/lib/minfraud/assessments.rb

@@ -4,9 +4,8 @@ module Minfraud
   # Assessments is used to perform minFraud Score, Insights, and Factors
   # requests.
   #
-  # @see https://dev.maxmind.com/minfraud/
+  # @see https://dev.maxmind.com/minfraud?lang=en
   class Assessments
-    include ::Minfraud::HTTPService
     include ::Minfraud::Resolver
 
     # The Account component.
@@ -82,6 +81,8 @@ module Minfraud
     #
     # @return [Minfraud::HTTPService::Response]
     #
+    # @raise [JSON::ParserError] if there was invalid JSON in the response.
+    #
     # @raise [Minfraud::AuthorizationError] If there was an authentication
     #   problem.
     #
@@ -98,6 +99,8 @@ module Minfraud
     #
     # @return [Minfraud::HTTPService::Response]
     #
+    # @raise [JSON::ParserError] if there was invalid JSON in the response.
+    #
     # @raise [Minfraud::AuthorizationError] If there was an authentication
     #   problem.
     #
@@ -114,6 +117,8 @@ module Minfraud
     #
     # @return [Minfraud::HTTPService::Response]
     #
+    # @raise [JSON::ParserError] if there was invalid JSON in the response.
+    #
     # @raise [Minfraud::AuthorizationError] If there was an authentication
     #   problem.
     #
@@ -129,18 +134,22 @@ module Minfraud
     private
 
     def perform_request(endpoint)
-      raw = request.perform(
-        verb:     :post,
-        endpoint: endpoint.to_s,
-        body:     request_body,
-      )
+      response = nil
+      body     = nil
+      Minfraud.connection_pool.with do |client|
+        response = client.post(
+          "/minfraud/v2.0/#{endpoint}",
+          json: request_body,
+        )
+
+        body = response.to_s
+      end
 
       response = ::Minfraud::HTTPService::Response.new(
-        endpoint: endpoint,
-        locales:  @locales,
-        status:   raw.status.to_i,
-        body:     raw.body,
-        headers:  raw.headers
+        endpoint,
+        @locales,
+        response,
+        body,
       )
 
       ::Minfraud::ErrorHandler.examine(response)
@@ -153,9 +162,5 @@ module Minfraud
         mem.merge!(e.to_s => value.to_json)
       end
     end
-
-    def request
-      @request ||= Request.new(::Minfraud::HTTPService.configuration)
-    end
   end
 end

data/lib/minfraud/components/account.rb

@@ -4,7 +4,7 @@ module Minfraud
   module Components
     # Account corresponds to the account object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/#Account_(/account)
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--account
     class Account < Base
       include Minfraud::Validates
 

data/lib/minfraud/components/billing.rb

@@ -4,7 +4,7 @@ module Minfraud
   module Components
     # Billing corresponds to the billing object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/#Billing_(/billing)
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--billing
     class Billing < Addressable; end
   end
 end

data/lib/minfraud/components/credit_card.rb

@@ -4,20 +4,22 @@ module Minfraud
   module Components
     # CreditCard corresponds to the credit_card object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/#Credit_Card_(/creditcard)
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--credit-card
     class CreditCard < Base
       include Minfraud::Validates
 
-      # The issuer ID number for the credit card. This is the first 6 digits of
-      # the credit card number. It identifies the issuing bank.
+      # The issuer ID number for the credit card. This is the first 6 or 8
+      # digits of the credit card number. It identifies the issuing bank.
       #
       # @return [String, nil]
       attr_accessor :issuer_id_number
 
-      # The last four digits of the credit card number.
+      # The last two or four digits of the credit card number.
+      #
+      # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--credit-card__last_digits
       #
       # @return [String, nil]
-      attr_accessor :last_4_digits
+      attr_accessor :last_digits
 
       # The name of the issuing bank as provided by the end user.
       #
@@ -62,17 +64,46 @@ module Minfraud
       # @return [String, nil]
       attr_accessor :cvv_result
 
+      # Whether the outcome of 3-D Secure verification (e.g. Safekey,
+      # SecureCode, Verified by Visa) was successful. +true+ if customer
+      # verification was successful, or +false+ if the customer failed
+      # verification. If 3-D Secure verification was not used, was unavailable,
+      # or resulted in an outcome other than success or failure, do not
+      # include this field.
+      #
+      # @return [Boolean, nil]
+      attr_accessor :was_3d_secure_successful
+
+      # Get the last digits of the credit card number.
+      #
+      # @deprecated Use {::last_digits} instead.
+      #
+      # @return [String, nil]
+      def last_4_digits
+        @last_digits
+      end
+
+      # Set the last digits of the credit card number.
+      #
+      # @deprecated Use {::last_digits} instead.
+      #
+      # @return [String, nil]
+      def last_4_digits=(last4)
+        @last_digits = last4
+      end
+
       # @param params [Hash] Hash of parameters. Each key/value should
       #   correspond to one of the available attributes.
       def initialize(params = {})
-        @bank_phone_country_code = params[:bank_phone_country_code]
-        @issuer_id_number        = params[:issuer_id_number]
-        @last_4_digits           = params[:last_4_digits]
-        @bank_name               = params[:bank_name]
-        @bank_phone_number       = params[:bank_phone_number]
-        @avs_result              = params[:avs_result]
-        @cvv_result              = params[:cvv_result]
-        @token                   = params[:token]
+        @bank_phone_country_code  = params[:bank_phone_country_code]
+        @issuer_id_number         = params[:issuer_id_number]
+        @last_digits              = params[:last_digits] || params[:last_4_digits]
+        @bank_name                = params[:bank_name]
+        @bank_phone_number        = params[:bank_phone_number]
+        @avs_result               = params[:avs_result]
+        @cvv_result               = params[:cvv_result]
+        @token                    = params[:token]
+        @was_3d_secure_successful = params[:was_3d_secure_successful]
 
         validate
       end
@@ -83,13 +114,14 @@ module Minfraud
         return if !Minfraud.enable_validation
 
         validate_telephone_country_code('bank_phone_country_code', @bank_phone_country_code)
-        validate_regex('issuer_id_number', /\A[0-9]{6}\z/, @issuer_id_number)
-        validate_regex('last_4_digits', /\A[0-9]{4}\z/, @last_4_digits)
+        validate_regex('issuer_id_number', /\A(?:[0-9]{6}|[0-9]{8})\z/, @issuer_id_number)
+        validate_regex('last_digits', /\A(?:[0-9]{2}|[0-9]{4})\z/, @last_digits)
         validate_string('bank_name', 255, @bank_name)
         validate_string('bank_phone_number', 255, @bank_phone_number)
         validate_string('avs_result', 1, @avs_result)
         validate_string('cvv_result', 1, @cvv_result)
         validate_credit_card_token('token', @token)
+        validate_boolean('was_3d_secure_successful', @was_3d_secure_successful)
       end
     end
   end

data/lib/minfraud/components/custom_inputs.rb

@@ -5,7 +5,7 @@ module Minfraud
     # CustomInputs corresponds to the custom_inputs object of a minFraud
     # request.
     #
-    # @see https://dev.maxmind.com/minfraud/#Custom_Inputs_(/custominputs)
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--custom-inputs
     class CustomInputs < Base
       include Minfraud::Validates
 

data/lib/minfraud/components/device.rb

@@ -4,7 +4,7 @@ module Minfraud
   module Components
     # Device corresponds to the device object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/#Device_(/device)
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--device
     class Device < Base
       include Minfraud::Validates
 

data/lib/minfraud/components/email.rb

@@ -1,17 +1,21 @@
 # frozen_string_literal: true
 
+require 'digest/md5'
+require 'simpleidn'
+
 module Minfraud
   module Components
     # Email corresponds to the email object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/#Email_(/email)
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--email
     class Email < Base
       include Minfraud::Validates
 
       # This field must be either be a valid email address or an MD5 of the
       # lowercased email used in the transaction. Important: if using the MD5
       # hash, please be sure to convert the email address to lowercase before
-      # calculating its MD5 hash.
+      # calculating its MD5 hash. Instead of converting an address to an MD5
+      # hash yourself, please use the hash_address attribute in this class.
       #
       # @return [String, nil]
       attr_accessor :address
@@ -21,15 +25,46 @@ module Minfraud
       # @return [String, nil]
       attr_accessor :domain
 
+      # By default, the address will be sent in plain text. If this is set
+      # true, the address will instead be sent as an MD5 hash.
+      #
+      # @return [Boolean, nil]
+      attr_accessor :hash_address
+
       # @param params [Hash] Hash of parameters. Each key/value should
       #   correspond to one of the available attributes.
       def initialize(params = {})
-        @address = params[:address]
-        @domain  = params[:domain]
+        @address      = params[:address]
+        @domain       = params[:domain]
+        @hash_address = params[:hash_address]
 
         validate
       end
 
+      # A JSON representation of Minfraud::Components::Email.
+      #
+      # @return [Hash]
+      def to_json(*_args)
+        json = super
+
+        if json['address'] && !json['domain']
+          _, domain = address.split('@', 2)
+          if domain
+            domain         = clean_domain(domain)
+            json['domain'] = domain if domain
+          end
+        end
+
+        if json.delete('hash_address') && json['address']
+          hash = hash_email_address(json['address'])
+
+          # We could consider clearing the key if !hash.
+          json['address'] = hash if hash
+        end
+
+        json
+      end
+
       private
 
       def validate
@@ -38,6 +73,60 @@ module Minfraud
         validate_email('email', @address)
         validate_string('domain', 255, @domain)
       end
+
+      def hash_email_address(address)
+        address = clean_email_address(address)
+        return nil if !address
+
+        Digest::MD5.hexdigest(address)
+      end
+
+      def clean_email_address(address)
+        address = address.strip
+        address.downcase!
+
+        local_part, domain = address.split('@', 2)
+        return nil if !local_part || !domain
+
+        domain = clean_domain(domain)
+
+        if domain == 'yahoo.com'
+          local_part.sub!(/\A([^-]+)-.*\z/, '\1')
+        else
+          local_part.sub!(/\A([^+]+)\+.*\z/, '\1')
+        end
+
+        "#{local_part}@#{domain}"
+      end
+
+      TYPO_DOMAINS = {
+        # gmail.com
+        '35gmai.com'     => 'gmail.com',
+        '636gmail.com'   => 'gmail.com',
+        'gamil.com'      => 'gmail.com',
+        'gmail.comu'     => 'gmail.com',
+        'gmial.com'      => 'gmail.com',
+        'gmil.com'       => 'gmail.com',
+        'yahoogmail.com' => 'gmail.com',
+        # outlook.com
+        'putlook.com'    => 'outlook.com',
+      }.freeze
+      private_constant :TYPO_DOMAINS
+
+      def clean_domain(domain)
+        domain = domain.strip
+
+        # We could use delete_suffix!, but that is in Ruby 2.5+ only.
+        domain.sub!(/\.\z/, '')
+
+        domain = SimpleIDN.to_ascii(domain)
+
+        if TYPO_DOMAINS.key?(domain)
+          domain = TYPO_DOMAINS[domain]
+        end
+
+        domain
+      end
     end
   end
 end