minfraud 1.4.1 → 2.1.0

data/lib/minfraud/model/ip_risk_reason.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'minfraud/model/abstract'
+
+module Minfraud
+  module Model
+    # Reason for the IP risk.
+    #
+    # This class provides both a machine-readable code and a human-readable
+    # explanation of the reason for the IP risk score.
+    #
+    # Although more codes may be added in the future, the current codes are:
+    #
+    # * ANONYMOUS_IP - The IP address belongs to an anonymous network. See the
+    #   object at ip_address.traits for more details.
+    # * BILLING_POSTAL_VELOCITY - Many different billing postal codes have been
+    #   seen on this IP address.
+    # * EMAIL_VELOCITY - Many different email addresses have been seen on this
+    #   IP address.
+    # * HIGH_RISK_DEVICE - A high risk device was seen on this IP address.
+    # * HIGH_RISK_EMAIL - A high risk email address was seen on this IP address
+    #   in your past transactions.
+    # * ISSUER_ID_NUMBER_VELOCITY - Many different issuer ID numbers have been
+    #   seen on this IP address.
+    # * MINFRAUD_NETWORK_ACTIVITY - Suspicious activity has been seen on this
+    #   IP address across minFraud customers.
+    class IPRiskReason < Abstract
+      # This value is a machine-readable code identifying the reason.
+      #
+      # @return [String, nil]
+      attr_reader :code
+
+      # This field provides a human-readable explanation of the reason. The
+      # text may change at any time and should not be matched against.
+      #
+      # @return [String, nil]
+      attr_reader :reason
+
+      # @!visibility private
+      def initialize(record)
+        super(record)
+
+        @code   = get('code')
+        @reason = get('reason')
+      end
+    end
+  end
+end

data/lib/minfraud/model/score.rb

@@ -65,7 +65,7 @@ module Minfraud
         @queries_remaining = get('queries_remaining')
         @risk_score        = get('risk_score')
         @warnings          = []
-        if record && record.key?('warnings')
+        if record&.key?('warnings')
           record['warnings'].each do |w|
             @warnings << Minfraud::Model::Warning.new(w)
           end

data/lib/minfraud/model/subscores.rb

@@ -4,7 +4,7 @@ require 'minfraud/model/abstract'
 
 module Minfraud
   module Model
-    # Subscores for components that are used in calculating the riskScore.
+    # Score for risk factors that are used in calculating the riskScore.
     class Subscores < Abstract
       # The risk associated with the AVS result. If present, this is a value in
       # the range 0.01 to 99.
@@ -84,26 +84,6 @@ module Minfraud
       # @return [Float, nil]
       attr_reader :email_local_part
 
-      # The risk associated with the issuer ID number on the email domain. If
-      # present, this is a value in the range 0.01 to 99.
-      #
-      # Deprecated effective August 29, 2019. This subscore will default to 1
-      # and will be removed in a future release. The user tenure on email is
-      # reflected in the /subscores/email_address output.
-      #
-      # @return [Float, nil]
-      attr_reader :email_tenure
-
-      # The risk associated with the issuer ID number on the IP address. If
-      # present, this is a value in the range 0.01 to 99.
-      #
-      # Deprecated effective August 29, 2019. This subscore will default to 1
-      # and will be removed in a future release. The IP tenure is reflected in
-      # the overall risk score.
-      #
-      # @return [Float, nil]
-      attr_reader :ip_tenure
-
       # The risk associated with the particular issuer ID number (IIN) given
       # the billing location and the history of usage of the IIN on your
       # account and shop ID. If present, this is a value in the range 0.01 to
@@ -162,8 +142,6 @@ module Minfraud
         @email_address                            = get('email_address')
         @email_domain                             = get('email_domain')
         @email_local_part                         = get('email_local_part')
-        @email_tenure                             = get('email_tenure')
-        @ip_tenure                                = get('ip_tenure')
         @issuer_id_number                         = get('issuer_id_number')
         @order_amount                             = get('order_amount')
         @phone_number                             = get('phone_number')

data/lib/minfraud/report.rb

@@ -3,10 +3,8 @@
 module Minfraud
   # Report is used to perform minFraud Report Transaction API requests.
   #
-  # @see https://dev.maxmind.com/minfraud/report-transaction/
+  # @see https://dev.maxmind.com/minfraud/report-a-transaction?lang=en
   class Report
-    include ::Minfraud::HTTPService
-
     # The Report::Transaction component.
     #
     # @return [Minfraud::Components::Report::Transaction, nil]
@@ -23,6 +21,8 @@ module Minfraud
     #
     # @return [nil]
     #
+    # @raise [JSON::ParserError] if there was invalid JSON in the response.
+    #
     # @raise [Minfraud::AuthorizationError] If there was an authentication
     #   problem.
     #
@@ -32,16 +32,24 @@ module Minfraud
     # @raise [Minfraud::ServerError] If the server reported an error of some
     #   kind.
     def report_transaction
-      raw = request.perform(
-        verb:     :post,
-        endpoint: 'transactions/report',
-        body:     @transaction.to_json,
-      )
+      response = nil
+      body     = nil
+      Minfraud.connection_pool.with do |client|
+        response = client.post(
+          '/minfraud/v2.0/transactions/report',
+          json: @transaction.to_json,
+        )
+
+        body = response.to_s
+      end
 
+      endpoint = nil
+      locales  = nil
       response = ::Minfraud::HTTPService::Response.new(
-        status:  raw.status.to_i,
-        body:    raw.body,
-        headers: raw.headers
+        endpoint,
+        locales,
+        response,
+        body,
       )
 
       ::Minfraud::ErrorHandler.examine(response)

data/lib/minfraud/validates.rb

@@ -114,7 +114,7 @@ module Minfraud
         raise InvalidInputError, "The #{field} value is not valid. It must be numeric."
       end
 
-      if value < 0 || value > 1e13 - 1
+      if value.negative? || value > 1e13 - 1
         raise InvalidInputError, "The #{field} value is not valid. It must be at least 0 and at most 1e13 - 1."
       end
     end
@@ -126,7 +126,7 @@ module Minfraud
         raise InvalidInputError, "The #{field} is not valid. It must be an integer."
       end
 
-      if value < 0 || value > 1e13 - 1
+      if value.negative? || value > 1e13 - 1
         raise InvalidInputError, "The #{field} is not valid. It must be at least 0 and at most 1e13 - 1."
       end
     end

data/lib/minfraud/version.rb

@@ -2,5 +2,5 @@
 
 module Minfraud
   # The Gem version.
-  VERSION = '1.4.1'
+  VERSION = '2.1.0'
 end

data/lib/minfraud.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
-require 'faraday'
+require 'connection_pool'
+require 'http'
 require 'minfraud'
 require 'minfraud/enum'
 require 'minfraud/validates'
@@ -22,8 +23,6 @@ require 'minfraud/components/shopping_cart_item'
 require 'minfraud/resolver'
 require 'minfraud/version'
 require 'minfraud/errors'
-require 'minfraud/http_service'
-require 'minfraud/http_service/request'
 require 'minfraud/http_service/response'
 require 'minfraud/error_handler'
 require 'minfraud/assessments'
@@ -48,21 +47,13 @@ module Minfraud
     # @return [String, nil]
     attr_accessor :host
 
-    # The MaxMind account ID that is used for authorization.
-    #
-    # @deprecated Use {::account_id} instead. This will be removed in the next
-    #   major version.
-    #
-    # @return [Integer, nil]
-    attr_accessor :user_id
-
     # The MaxMind license key that is used for authorization.
     #
     # @return [String, nil]
     attr_accessor :license_key
 
     # @!visibility private
-    attr_reader :connection
+    attr_reader :connection_pool
 
     # Yield self to accept configuration settings.
     #
@@ -70,20 +61,23 @@ module Minfraud
     def configure
       yield self
 
-      config      = Minfraud::HTTPService.configuration
-      @connection = Faraday.new(config[:server], {}, &config[:middleware])
+      pool_size        = 5
+      host             = @host.nil? ? 'minfraud.maxmind.com' : @host
+      @connection_pool = ConnectionPool.new(size: pool_size) do
+        make_http_client.persistent("https://#{host}")
+      end
     end
 
-    # The current Minfraud configuration.
-    #
-    # @deprecated This will be removed in the next major version.
-    #
-    # @return [Hash]
-    def configuration
-      {
-        user_id:     @user_id,
-        license_key: @license_key
-      }
+    private
+
+    def make_http_client
+      HTTP.basic_auth(
+        user: @account_id,
+        pass: @license_key,
+      ).headers(
+        accept:     'application/json',
+        user_agent: "minfraud-api-ruby/#{Minfraud::VERSION}",
+      )
     end
   end
 end

data/minfraud.gemspec

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-lib = File.expand_path('lib', File.dirname(File.realpath(__FILE__)))
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 require 'minfraud/version'
@@ -8,27 +8,31 @@ require 'minfraud/version'
 Gem::Specification.new do |spec|
   spec.name          = 'minfraud'
   spec.version       = Minfraud::VERSION
-  spec.authors       = ['kushnir.yb']
+  spec.authors       = ['kushnir.yb', 'William Storey']
   spec.email         = ['support@maxmind.com']
 
   spec.summary       = 'Ruby API for the minFraud Score, Insights, Factors, and Report Transactions services'
   spec.homepage      = 'https://github.com/maxmind/minfraud-api-ruby'
   spec.license       = 'MIT'
 
-  spec.required_ruby_version = '>= 2.1'
+  spec.required_ruby_version = '>= 2.5.0'
 
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_runtime_dependency 'faraday', '>= 0.9.1', '< 2.0'
-  spec.add_runtime_dependency 'faraday_middleware', '>= 0.9.1', '< 2.0'
-  spec.add_runtime_dependency 'net-http-persistent', '>= 2.0.0', '< 5.0'
+  spec.add_runtime_dependency 'connection_pool', '~> 2.2'
+  spec.add_runtime_dependency 'http', '>= 4.3', '< 6.0'
+  spec.add_runtime_dependency 'maxmind-geoip2', '~> 1.1'
+  spec.add_runtime_dependency 'simpleidn', '~> 0.1', '>= 0.1.1'
 
-  spec.add_development_dependency 'bundler', '>= 1.16'
-  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'bundler', '~> 2.2'
+  spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'rubocop'
-  spec.add_development_dependency 'webmock'
+  spec.add_development_dependency 'rubocop', '~> 1.23'
+  spec.add_development_dependency 'webmock', '~> 3.14'
+  spec.metadata = {
+    'rubygems_mfa_required' => 'true'
+  }
 end

metadata

@@ -1,103 +1,112 @@
 --- !ruby/object:Gem::Specification
 name: minfraud
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 2.1.0
 platform: ruby
 authors:
 - kushnir.yb
+- William Storey
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-12-01 00:00:00.000000000 Z
+date: 2022-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: faraday
+  name: connection_pool
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.9.1
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.9.1
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
-  name: faraday_middleware
+  name: http
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.1
+        version: '4.3'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '6.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.1
+        version: '4.3'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '6.0'
 - !ruby/object:Gem::Dependency
-  name: net-http-persistent
+  name: maxmind-geoip2
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.0.0
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: simpleidn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.0
-    - - "<"
+        version: 0.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.1
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -116,30 +125,30 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.23'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.23'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.14'
 description:
 email:
 - support@maxmind.com
@@ -147,6 +156,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/dependabot.yml"
 - ".github/workflows/rubocop.yml"
 - ".github/workflows/test.yml"
 - ".gitignore"
@@ -161,20 +171,6 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
-- lib/maxmind/geoip2/model/city.rb
-- lib/maxmind/geoip2/model/country.rb
-- lib/maxmind/geoip2/model/insights.rb
-- lib/maxmind/geoip2/record/abstract.rb
-- lib/maxmind/geoip2/record/city.rb
-- lib/maxmind/geoip2/record/continent.rb
-- lib/maxmind/geoip2/record/country.rb
-- lib/maxmind/geoip2/record/location.rb
-- lib/maxmind/geoip2/record/maxmind.rb
-- lib/maxmind/geoip2/record/place.rb
-- lib/maxmind/geoip2/record/postal.rb
-- lib/maxmind/geoip2/record/represented_country.rb
-- lib/maxmind/geoip2/record/subdivision.rb
-- lib/maxmind/geoip2/record/traits.rb
 - lib/minfraud.rb
 - lib/minfraud/assessments.rb
 - lib/minfraud/components/account.rb
@@ -195,8 +191,6 @@ files:
 - lib/minfraud/enum.rb
 - lib/minfraud/error_handler.rb
 - lib/minfraud/errors.rb
-- lib/minfraud/http_service.rb
-- lib/minfraud/http_service/request.rb
 - lib/minfraud/http_service/response.rb
 - lib/minfraud/model/abstract.rb
 - lib/minfraud/model/address.rb
@@ -211,6 +205,7 @@ files:
 - lib/minfraud/model/geoip2_location.rb
 - lib/minfraud/model/insights.rb
 - lib/minfraud/model/ip_address.rb
+- lib/minfraud/model/ip_risk_reason.rb
 - lib/minfraud/model/issuer.rb
 - lib/minfraud/model/score.rb
 - lib/minfraud/model/score_ip_address.rb
@@ -225,7 +220,8 @@ files:
 homepage: https://github.com/maxmind/minfraud-api-ruby
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -234,15 +230,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.1'
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project:
-rubygems_version: 2.7.6.2
+rubygems_version: 3.2.22
 signing_key:
 specification_version: 4
 summary: Ruby API for the minFraud Score, Insights, Factors, and Report Transactions

data/lib/maxmind/geoip2/model/city.rb

@@ -1,99 +0,0 @@
-# Copyright (c) 2020 by 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
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
-# frozen_string_literal: true
-
-require 'maxmind/geoip2/model/country'
-require 'maxmind/geoip2/record/city'
-require 'maxmind/geoip2/record/location'
-require 'maxmind/geoip2/record/postal'
-require 'maxmind/geoip2/record/subdivision'
-
-module MaxMind
-  module GeoIP2
-    module Model
-      # Model class for the data returned by the GeoIP2 City web service and
-      # database. It is also used for GeoLite2 City lookups.
-      #
-      # The only difference between the City and Insights model classes is which
-      # fields in each record may be populated. See
-      # https://dev.maxmind.com/geoip/geoip2/web-services for more details.
-      #
-      # See {MaxMind::GeoIP2::Model::Country} for inherited methods.
-      class City < Country
-        # City data for the IP address.
-        #
-        # @return [MaxMind::GeoIP2::Record::City]
-        attr_reader :city
-
-        # Location data for the IP address.
-        #
-        # @return [MaxMind::GeoIP2::Record::Location]
-        attr_reader :location
-
-        # Postal data for the IP address.
-        #
-        # @return [MaxMind::GeoIP2::Record::Postal]
-        attr_reader :postal
-
-        # The country subdivisions for the IP address.
-        #
-        # The number and type of subdivisions varies by country, but a subdivision
-        # is typically a state, province, country, etc. Subdivisions are ordered
-        # from most general (largest) to most specific (smallest).
-        #
-        # If the response did not contain any subdivisions, this attribute will be
-        # an empty array.
-        #
-        # @return [Array<MaxMind::GeoIP2::Record::Subdivision>]
-        attr_reader :subdivisions
-
-        # @!visibility private
-        def initialize(record, locales)
-          super(record, locales)
-          @city         = MaxMind::GeoIP2::Record::City.new(record['city'], locales)
-          @location     = MaxMind::GeoIP2::Record::Location.new(record['location'])
-          @postal       = MaxMind::GeoIP2::Record::Postal.new(record['postal'])
-          @subdivisions = create_subdivisions(record['subdivisions'], locales)
-        end
-
-        # The most specific subdivision returned.
-        #
-        # If the response did not contain any subdivisions, this method returns
-        # nil.
-        #
-        # @return [MaxMind::GeoIP2::Record::Subdivision, nil]
-        def most_specific_subdivision
-          @subdivisions.last
-        end
-
-        private
-
-        def create_subdivisions(subdivisions, locales)
-          return [] if subdivisions.nil?
-
-          subdivisions.map do |s|
-            MaxMind::GeoIP2::Record::Subdivision.new(s, locales)
-          end
-        end
-      end
-    end
-  end
-end