minfraud 1.0.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 6a55c03cbdb1487ae09c4e1e8b0286b53f49ae98
-  data.tar.gz: 436b76d31314d1971fd511cce43e05d1cf80f1f4
+SHA256:
+  metadata.gz: 5523cb6babed5c559ba622141b2db65a2396cbb016c6215ec641ba765fc01d10
+  data.tar.gz: 54dbf8b2cc34be45a428da2017f09b7cb2d7445c94ff7f37dda0a26c28a3fbfe
 SHA512:
-  metadata.gz: febcdcdfc8828f99424d485f041f621ef9763b2eca5f2b7a401b5ad54b2f1b312711d47c782cd8f986848fdac46a749e17621e88f86bb98e9e6693cde3d8980a
-  data.tar.gz: 28279d249f2cc2495e4223337900f90c875eb48e6a667a75c994a8dc8ff19a9d0512b1914eac748e60a8a16a0d0973ee179f77c77657b4dad1185fdd2199cb3b
+  metadata.gz: 80142ac976fb6df365a3192a96dbf62c8ea7935f4ca9fea89333d0e2f2e64f5e4af402dc03814f58f268e354ed7adcb5c61134fb2d526c0a06b48581cad3fc54
+  data.tar.gz: a9b6caf26aaee87f5ebc479391cda46d3489cf591315772c481d722b343399edfc5ad40fca8eac0d740d826c0021bcf33d3aade2419247d26d1787328763599b

data/.github/workflows/test.yml

@@ -0,0 +1,46 @@
+name: ruby-versions
+on:
+  push:
+    paths-ignore:
+      - "**.md"
+  pull_request:
+    paths-ignore:
+      - "**.md"
+jobs:
+  run:
+    name: ruby
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        version:
+          [
+            "2.2",
+            "2.3",
+            "2.4",
+            "2.5",
+            "2.6",
+            "2.7",
+            "head",
+            "jruby",
+            "jruby-head",
+          ]
+        exclude:
+          - os: windows-latest
+            version: "jruby"
+          - os: windows-latest
+            version: "jruby-head"
+    steps:
+      - name: checkout
+        uses: actions/checkout@v2
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.version }}
+      - name: ruby version
+        run: ruby -v
+      - run: bundler install
+        name: install
+      - run: bundler exec rake -t
+        name: test

data/.gitignore

@@ -1,7 +1,9 @@
+/coverage
 pkg
 .project
 Gemfile.lock
 .rvmrc
 *.rbc
+.yardoc
 *~
 .DS_Store

data/.rubocop.yml

@@ -0,0 +1,127 @@
+Gemspec/RequiredRubyVersion:
+  Enabled: false # We support 1.9, but newer rubocops don't.
+
+# Metrics.
+
+Metrics/BlockLength:
+  Enabled: false # Default is true, but mostly hit in tests.
+
+Metrics/AbcSize:
+  Enabled: false # To allow for pre-existing code.
+
+Metrics/ClassLength:
+  Enabled: false # To allow for pre-existing code.
+
+Metrics/CyclomaticComplexity:
+  Enabled: false # To allow for pre-existing code.
+
+Metrics/MethodLength:
+  Enabled: false # To allow for pre-existing code.
+
+Metrics/PerceivedComplexity:
+  Enabled: false # To allow for pre-existing code.
+
+# Layout.
+
+Layout/LineLength:
+  Max: 150 # Default is 120.
+
+Layout/HashAlignment:
+  EnforcedHashRocketStyle: table # Default is key.
+  EnforcedColonStyle:      table # Default is key.
+
+Layout/ExtraSpacing:
+  ForceEqualSignAlignment: true # Default is false.
+
+Layout/IndentationStyle:
+  IndentationWidth: 2 # Default is <none>.
+
+# Style.
+
+Style/HashSyntax:
+  EnforcedStyle: ruby19_no_mixed_keys # Default is ruby19.
+
+Style/CollectionMethods:
+  Enabled: true # Default is false.
+
+Style/NumericLiterals:
+  MinDigits: 4 # Default is 5.
+
+Style/NegatedIf: # I disagree with this.
+  Enabled: false
+
+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
+Style/TrailingCommaInArrayLiteral:
+  Enabled: false
+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:
+  EnforcedStyle: empty
+
+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.
+
+# Naming.
+
+Naming/VariableNumber:
+  Enabled: false # Doesn't always make sense.
+
+# These are new and rubocop warns if you don't configure them.
+
+Layout/EmptyLinesAroundAttributeAccessor:
+  Enabled: true
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+Lint/DeprecatedOpenSSLConstant:
+  Enabled: true
+Lint/MixedRegexpCaptureTypes:
+  Enabled: true
+Lint/RaiseException:
+  Enabled: true
+Lint/StructNewOverride:
+  Enabled: true
+Style/ExponentialNotation:
+  Enabled: true
+Style/HashEachMethods:
+  Enabled: true
+Style/HashTransformKeys:
+  Enabled: true
+Style/HashTransformValues:
+  Enabled: true
+Style/RedundantFetchBlock:
+  Enabled: true
+Style/RedundantRegexpCharacterClass:
+  Enabled: true
+Style/RedundantRegexpEscape:
+  Enabled: true
+Style/SlicingWithRange:
+  Enabled: true

data/.travis.yml

@@ -1,5 +1,22 @@
-sudo: false
 language: ruby
+
 rvm:
-  - 2.3.1
-before_install: gem install bundler -v 1.12.5
+  - 1.9
+  - 2.0
+  - 2.1
+  - 2.2
+  - 2.3
+  - 2.4
+  - 2.5
+  - 2.6
+  - 2.7
+
+notifications:
+  email:
+    on_failure: always
+    on_success: change
+    recipients:
+      - dev-ci@maxmind.com
+  slack:
+    rooms:
+      secure: "wuwMo+BWnaBtkt1uGAi4Zd0EARX3B2TXDmBGCtn8r4PLfehh61S6nLQDASNXSk200PmniFM8PyOUNVGVJqWpYQAEMn32WWdy4vTK2c8CsjwfsMhgnOI2YDCzw+jiP+8EfIGBsPO4xA7yrzweP8gkzBtplb3LbaCiW83WfFo9+402yr0/0F9gfWi8qvuIw29XAS1XWhTY4itqGfkSPdOHQz/45ElpLkGlgreuRrih3tAgn9YLb/Uh/6McHfHkL74YwQU3p0NiZcoleWYM0CLpPzyrN8EsbmIT+L75nIVwXnh62Gx2jJWayj7ZzvyKtVKHtLb/LKRs4Dg0UEg65xX1EcBAkC5fn4KG1jQHvi/tdOx1Sfh3hO6OK+68q1R6cQQYy+uG84q8RUjpO6dzFcWpE1yMdbQ5XMKfTh56ZdhXJ803LD2gGeIgcMwJp6HK9tnf0vaPPI9kbr8fqJBUUkciUoqpYzFd5m0ZCUbJsMD0oPY19FSRtfCNQvCbmhYrLy1sQ5FeMzbF0bi2oaUv+JD/A5RKokNMrrwv3nnTtG4vN1hJklQk2VW3sZWl6UjYgzhrbmKABtvPuB+xcYywIu4+JSworpfDwM/PZAKOfd6n+r8OdNV256l8WaNeF6osvXkUR7yxYpytywdQPA0d/z8mxTVoATE3wat7pnmTrqI5fqw=\n"

data/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Minfraud Changelog
+
+## v1.2.0 (2020-07-15)
+
+* Adds new processor types to `Minfraud::Components::Payment`: `:cashfree`,
+  `:first_atlantic_commerce`, `:komoju`, `:paytm`, `:razorpay`, and
+  `:systempay`.
+* Adds support for three new Factors outputs: `/subscores/device` (the risk
+  associated with the device), `/subscores/email_local_part` (the risk
+  associated with the part of the email address before the @ symbol) and
+  `/subscores/shipping_address` (the risk associated with the shipping
+  address).
+* Adds support for providing your MaxMind account ID using the `account_id`
+  attribute instead of the `user_id` attribute. In a future release,
+  support for the `user_id` attribute will be removed.
+
+## v1.1.0 (2020-06-19)
+
+* Adds support for the minFraud Report Transaction API. Reporting
+  transactions to MaxMind helps us detect about 10-50% more fraud and
+  reduce false positives for you.
+* Adds support for the new credit card output `/credit_card/is_business`.
+  This indicates whether the card is a business card. It may be accessed
+  via `response.credit_credit.is_business` on the minFraud Insights and
+  Factors response objects.
+* Adds support for the new email domain output `/email/domain/first_seen`.
+  This may be accessed via `response.email.domain.first_seen` on the
+  minFraud Insights and Factors response objects.
+* Rename `ErrorHandler#inspect` to `ErrorHandler#examine` in order not to
+  break LSP.
+* Adds classes for the Score, Insights, and Factors responses. This allows
+  us to provide API documentation for the various response attributes.
+* Removes `hashie` as a required dependency.
+* Adds new processor types to `Minfraud::Components::Payment`: `:affirm`,
+  `:afterpay`, `:cardpay`, `:ccavenue`, `:cetelem`, `:ct_payments`,
+  `:dalenys`, `:datacash`, `:dotpay`, `:ecommpay`, `:epx`, `:g2a_pay`,
+  `:gocardless`, `:interac`, `:klarna`, `:mercanet`, `:oney`, `:payeezy`,
+  `:paylike`, `:payment_express`, `:paysafecard`, `:posconnect`,
+  `:smartdebit`, `:synapsefi`, and others.
+* Adds support for passing custom inputs to minFraud. GitHub #6.
+* Adds `:email_change`, `:password_reset`, and `:payout_change` as types to
+  `Minfraud::Components::Event`.
+* Adds support for the `session_id` and `session_age` inputs.
+
+## v1.0.4 (2016-12-23)
+
+* Prevents boolean value conversion to string to avoid warnings
+* 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
+
+## v1.0.2 (2016-10-11)
+
+* Adds support for Ruby >= 1.9

data/CODE_OF_CONDUCT.md

@@ -35,7 +35,7 @@ This code of conduct applies both within project spaces and in public spaces
 when an individual is representing the project or its community.
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting a project maintainer at kushnir.yb@gmail.com. All
+reported by contacting a project maintainer at support@maxmind.com. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. Maintainers are
 obligated to maintain confidentiality with regard to the reporter of an
@@ -43,7 +43,7 @@ incident.
 
 This Code of Conduct is adapted from the [Contributor Covenant][homepage],
 version 1.3.0, available at
-[http://contributor-covenant.org/version/1/3/0/][version]
+[https://contributor-covenant.org/version/1/3/0/][version]
 
-[homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/3/0/
+[homepage]: https://contributor-covenant.org
+[version]: https://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -1,5 +1,14 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
-# Specify your gem's dependencies in minfraud.gemspec
-gem 'coveralls', require: false
+# 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,6 +1,7 @@
 The MIT License (MIT)
 
-Copyright (c) 2016 kushnir.yb
+Copyright (c) 2016-2020 kushnir.yb
+Copyright (c) 2020 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

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

data/README.md

@@ -1,12 +1,18 @@
-# Simple Ruby Wrapper to the MaxMind minFraud API
+# Ruby API for MaxMind minFraud Services
 
-[![Code Climate](https://codeclimate.com/github/kushniryb/minfraud-api-v2/badges/gpa.svg)](https://codeclimate.com/github/kushniryb/minfraud-api-v2)
-[![Coverage Status](https://coveralls.io/repos/github/kushniryb/minfraud-api-v2/badge.svg?branch=master)](https://coveralls.io/github/kushniryb/minfraud-api-v2?branch=master)
-[![Build Status](https://travis-ci.org/kushniryb/minfraud-api-v2.svg?branch=master)](https://travis-ci.org/kushniryb/minfraud-api-v2)
+## Description
 
-Compatible with version minFraud API v2.0
+This package provides an API for the [MaxMind minFraud web
+services](https://dev.maxmind.com/minfraud/). This includes minFraud Score,
+Insights, and Factors. It also includes our [minFraud Report Transaction
+API](https://dev.maxmind.com/minfraud/report-transaction/).
 
-[minFraud API documentation](http://dev.maxmind.com/minfraud/)
+The legacy minFraud Standard and Premium services are not supported by this
+API.
+
+## Requirements
+
+This gem works with Ruby 1.9 and above.
 
 ## Installation
 
@@ -27,81 +33,146 @@ Or install it yourself as:
 $ gem install minfraud
 ```
 
-## Configuration
+## Usage
+
+### Configuration
 
-User Id and License Key are required to work with minFraud API
+An account ID and license key are required to work with the web services.
 
 ```ruby
 Minfraud.configure do |c|
+  c.account_id  = 12345
   c.license_key = 'your_license_key'
-  c.user_id     = 'your_user_id'
 end
-```
+````
+
+### Making a minFraud Score, Insights, or Factors Request
 
-## Usage
 ```ruby
-# You can either provide a hash of params to initializer
+# You can either provide a hash of parameters to the initializer
 assessment = Minfraud::Assessments.new(
   device: {
     ip_address: '1.2.3.4.5'
   }
 )
-# or create a component and assign them to assessments object directly, e.g
+# or create a component and assign them to the assessments object directly
 device = Minfraud::Components::Device.new(ip_address: '1.2.3.4.5')
 assessment = Minfraud::Assessments.new(device: device)
 # or
 assessment = Minfraud::Assessments.new
 assessment.device = device
-# There are multiple components that reflect minFraud request top level keys
 
-# Some components will raise an error if provided with the wrong values for attributes, e.g
+# There are multiple components that reflect the minFraud request top level
+# keys.
+
+# Some components will raise an error if provided with the wrong values for
+# attributes, e.g
 event = Minfraud::Components::Event.new(type: 'foobar') # => Minfraud::NotEnumValueError
-# You can check the list of permitted values for the attribute by calling a class method
+
+# You can check the list of permitted values for the attribute by calling a
+# class method
 Minfraud::Components::Event.type_values # => ["account_creation", "account_login", ....]
 
-# You can now call 3 different minFraud endpoints: score, insights, factors
+# You can now call 3 different minFraud endpoints: score, insights and factors
+assessment.score
 assessment.insights
 assessment.factors
 
 result = assessment.score # => Minfraud::Response instance
 
 result.status  # => Response status code
-result.code    # => minFraud specific response code
-result.body    # => Mashified body
+result.code    # => minFraud-specific response code
+result.body    # => Response body
 result.headers # => Response headers
 
-# You can also change data inbetween requests
+# You can change data between requests
 first_request = assessment.insights
 assessment.device.ip_address = '22.22.22.33'
 second_request = assessment.insights
 ```
 
-### Exception handling
+See the [API documentation](https://www.rubydoc.info/gems/minfraud) for
+more details.
 
-Gem is supplied with four different types of exceptions:
-```ruby
-# Raised if unpermitted key is provided to Minfraud::Assessments initializer
-class RequestFormatError < BaseError; end
+### Reporting a Transaction to MaxMind
+
+MaxMind encourages the use of this API, as data received through this
+channel is continually used to improve the accuracy of their fraud
+detection algorithms.
 
-# Raised if IP address is absent / it is reserved / JSON body can not be decoded
-class ClientError < BaseError; end
+To use the Report Transactions API, create a new
+`Minfraud::Components::Report::Transaction` object. An IP address and a
+valid tag are required arguments for this API. Additional params may also
+be set, as documented below.
 
-# Raised if there are some problems with the user id and / or license key
-class AuthorizationError < BaseError; end
+If the report is successful, nothing is returned. If the report fails, an
+exception with be thrown.
 
-# Raised if minFraud returns an error, or if there is an HTTP error
-class ServerError < BaseError; end
+See the API documentation for more details.
 
-# Raised if an attribute value doesn't belong to the predefined set of values
-class NotEnumValueError < BaseError; end
+```ruby
+# The report_transaction method only makes use of a transaction component:
+txn = Minfraud::Components::Report::Transaction.new(
+  ip_address:     '1.2.3.4',
+  tag:            :suspected_fraud,
+  maxmind_id:     '12345678',
+  minfraud_id:    '58fa38d8-4b87-458b-a22b-f00eda1aa20d',
+  notes:          'notes go here',
+  transaction_id: '1FA254yZ'
+)
+reporter = Minfraud::Report.new(transaction: txn)
+reporter.report_transaction
 ```
 
+See the [API documentation](https://www.rubydoc.info/gems/minfraud) for
+more details.
+
+### Exceptions
+
+The gem supplies several distinct exception-types:
+
+* `RequestFormatError` - Raised if unpermitted key is provided to the
+  `Minfraud::Assessments` initializer
+* `ClientError` - Raised if the IP address is absent, reserved or the JSON
+  body cannot be decoded
+* `AuthorizationError` - Raised if there are problems with the account ID
+  and/or license key
+* `ServerError` - Raised if minFraud returns an error or if there is an
+  HTTP error
+* `NotEnumValueError` - Raised if an attribute value doesn't belong to the
+  predefined set of values
+
+## Support
+
+Please report all issues with this code using the
+[GitHub issue tracker](https://github.com/maxmind/minfraud-api-ruby/issues).
+
+If you are having an issue with the minFraud service that is not specific
+to the client API, please see
+[our support page](https://www.maxmind.com/en/support).
+
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub [here](https://github.com/kushniryb/minfraud-api-v2). This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on
+[GitHub](https://github.com/maxmind/minfraud-api-ruby). This project is
+intended to be a safe, welcoming space for collaboration, and contributors
+are expected to adhere to the [Contributor
+Covenant](https://contributor-covenant.org) code of conduct.
+
+## Versioning
+
+This API uses [Semantic Versioning](https://semver.org/).
+
+## Copyright and License
+
+Copyright (c) 2016-2020 kushnir.yb.
 
+Copyright (c) 2020 MaxMind, Inc.
 
-## License
+The gem is available as open source under the terms of the [MIT
+License](https://opensource.org/licenses/MIT).
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+## Thank You
 
+This gem is the work of the creator and original maintainer kushnir.yb
+(@kushniryb).