incognia_api 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a8273559cc0083cb3373809d8ecf76edd3f843cb40b49b450e6ec2fc2de4455
-  data.tar.gz: 598e1eeb493b7f9eba3882b032e33803d472181bfbb61a9e9b7e60f2fbf67512
+  metadata.gz: a57edb1d744307af54b8b03d93f7b607f919cf41a66f71d92e3df45db1569b13
+  data.tar.gz: e572c70ff386ddb53c47a7921ff4b9ad1439a27188322c23d2098af1d2f77e03
 SHA512:
-  metadata.gz: f7bb01031ef75a1dc426bff6ef8fec7d17dd9d0a7022db6c0ccac7a8bc1c2a552b30ebd779fe094eeed45b57d8d60f922fffb1ccae72430c992fd290118af627
-  data.tar.gz: 63e398c7600a573d4cbcf742953944a63e2c116382c976e7dcc819bc4e6908ea7d0fa42e98d0fadea2753bc2e187d2e198613e534be019ace70f176f8101c4cf
+  metadata.gz: 942653d86e52ced892b20eaf9684fc0ed43535742f6d265c5b886caa5491bfdaedc56521d38c5ae8ed142d4f8196a13ee117d632c3dd7906977e8bdc3ff2687a
+  data.tar.gz: 15f3d172105df2645d60f94850abee3e280eb5ae425431e9409fb782eb49de21f1003c8d8fe6f8b7ae19e870c9738da97e980631adf8133c12f29ff021578a59

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [1.3.0] - 2024-10-30
+
+- Add support for general configuration and use Incognia::Api as a static class
+
+## [1.2.0] - 2024-08-26
+
+- Removes the requirement to send installation id to register signup, login and payment
+
 ## [1.1.0] - 2024-07-24
 
 - Add support to passing request_token and occurred_at to #register_feedback

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    incognia_api (1.1.0)
+    incognia_api (1.3.0)
       faraday (~> 1.10)
       faraday_middleware (~> 1.2)
 

data/README.md

@@ -35,28 +35,30 @@ Or install it yourself as:
 
 ### Configuration
 
-Before using the API client, you must initialize it using credentials obtained
-from the [Incognia dashboard]():
+Before using the API client, you must configure it using credentials obtained
+from the [Incognia dashboard](https://dash.incognia.com/):
 
 ```ruby
-api = Incognia::Api.new(client_id: "your-client-id", client_secret:
-"your-client-secret")
+Incognia.configure(client_id: ENV['INCOGNIA_CLIENT_ID'], client_secret: ENV['INCOGNIA_CLIENT_SECRET'])
 
+# Incognia.configure(client_id: "your-client-id", client_secret: "your-client-secret")
 ```
 
-For sandbox credentials, refer to the [API testing guide]().
+For sandbox credentials, refer to the [API testing guide](https://developer.incognia.com/).
+
+:bulb: For Rails applications it's recommended to create an initializer file, for example `config/initializers/incognia.rb`.
 
 
 ### Registering a Signup
 
-This method registers a new signup for the given installation and address, returning a signup assessment, containing the risk assessment and supporting evidence:
+This method registers a new signup for the given request token and address, returning a signup assessment, containing the risk assessment and supporting evidence:
 
 ```ruby
 address = Incognia::Address.new(line: "West 34th Street, New York City, NY 10001")
-installation_id = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
+request_token = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
 
-assessment = api.register_signup(
-  installation_id: installation_id,
+assessment = Incognia::Api.register_signup(
+  request_token: request_token,
   address: address
 )
 
@@ -68,11 +70,11 @@ It also supports optional parameters, for example:
 
 ```ruby
 address = Incognia::Address.new(line: "West 34th Street, New York City, NY 10001")
-installation_id = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
+request_token = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
 external_id = "7b02736a-7718-4b83-8982-f68fb6f501fa"
 
-assessment = api.register_signup(
-  installation_id: installation_id,
+assessment = Incognia::Api.register_signup(
+  request_token: request_token,
   address: address,
   external_id: external_id
 )
@@ -82,14 +84,14 @@ assessment = api.register_signup(
 
 ### Registering a Login
 
-This method registers a new login for the given installation and account, returning a login assessment, containing the risk assessment and supporting evidence:
+This method registers a new login for the given request token and account, returning a login assessment, containing the risk assessment and supporting evidence:
 
 ```ruby
-installation_id = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
+request_token = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
 account_id = 'account-identifier-123'
 
-assessment = api.register_login(
-  installation_id: installation_id,
+assessment = Incognia::Api.register_login(
+  request_token: request_token,
   account_id: account_id,
 )
 
@@ -100,12 +102,12 @@ assessment = api.register_login(
 It also supports optional parameters, for example:
 
 ```ruby
-installation_id = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
+request_token = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
 account_id = 'account-identifier-123'
 external_id = 'some-external-identifier'
 
-assessment = api.register_login(
-  installation_id: installation_id,
+assessment = Incognia::Api.register_login(
+  request_token: request_token,
   account_id: account_id,
   external_id: external_id,
   eval: false # can be used to register a new login without evaluating it
@@ -116,12 +118,12 @@ assessment = api.register_login(
 
 ### Registering Payment
 
-This method registers a new payment for the given installation and account, returning a `hash`,
+This method registers a new payment for the given request token and account, returning a `hash`,
 containing the risk assessment and supporting evidence.
 
 ```ruby
-assessment = api.register_payment(
-  installation_id: 'installation-id',
+assessment = Incognia::Api.register_payment(
+  request_token: 'request-token',
   account_id: 'account-id'
 )
 
@@ -180,8 +182,8 @@ payment_methods = [
   }
 ]
 
-assessment = api.register_payment(
-  installation_id: 'installation-id',
+assessment = Incognia::Api.register_payment(
+  request_token: 'request-token',
   account_id: 'account-id',
   external_id: 'external-id',
   addresses: addresses,
@@ -202,14 +204,14 @@ The `expires_at` argument should be a _Time_, _DateTime_ or an date in **RFC 333
 
 
 ```ruby
-installation_id = 'installation-id'
+request_token = 'request-token'
 account_id = 'account-id'
 occurred_at = DateTime.parse('2024-07-22T15:20:00Z')
 
-success = api.register_feedback(
+success = Incognia::Api.register_feedback(
   event: Incognia::Constants::FeedbackEvent::ACCOUNT_TAKEOVER,
   occurred_at: occurred_at,
-  installation_id: installation_id,
+  request_token: request_token,
   account_id: account_id
 )
 
@@ -219,10 +221,10 @@ success = api.register_feedback(
 For custom fraud, set the value of `event` with the corresponding code:
 
 ```ruby
-success = api.register_feedback(
+success = Incognia::Api.register_feedback(
   event: 'custom_fraud_name',
   occurred_at: occurred_at,
-  installation_id: installation_id,
+  request_token: request_token,
   account_id: account_id
 )
 

data/lib/incognia_api/api.rb

@@ -5,79 +5,99 @@ require 'faraday_middleware'
 
 module Incognia
   class Api
-    # business layer: uses the Client to build domain objects
+    # business layer: uses the Client.instance to build domain objects
     # raises missing parameters errors
-    attr_accessor :connection
 
     def initialize(client_id:, client_secret:)
-      @connection = Client.new(client_id: client_id,
-                               client_secret: client_secret,
-                               host: "https://api.incognia.com/api")
-    end
+      Incognia.configure(client_id: client_id, client_secret: client_secret)
 
-    def register_signup(installation_id:, address: nil, **opts)
-      params = { installation_id: installation_id }
-      params.merge!(opts)
-      params.merge!(address&.to_hash) if address
+      warn("Deprecation warning: The Incognia::Api instance will be removed. " +
+           "Please set up with `Incognia.configure` and use class methods instead.")
+    end
 
-      response = connection.request(
-        :post,
-        'v2/onboarding/signups',
-        params
-      )
+    def register_signup(**args); self.class.register_signup(**args) end
+    def register_login(**args); self.class.register_login(**args) end
+    def register_feedback(**args); self.class.register_feedback(**args) end
+    def register_payment(**args); self.class.register_payment(**args) end
+    def connection
+      warn("Deprecation warning: #connection and .connection are deprecated and will be private.")
 
-      SignupAssessment.from_hash(response.body) if response.success?
+      self.class.connection
     end
 
-    def register_login(installation_id:, account_id:, **opts)
-      params = {
-        type: :login,
-        installation_id: installation_id,
-        account_id: account_id,
-      }
-      params.merge!(opts)
-
-      response = connection.request(
-        :post,
-        'v2/authentication/transactions',
-        params
-      )
-
-      LoginAssessment.from_hash(response.body) if response.success?
-    end
+    class << self
+      def register_signup(request_token: nil, address: nil, **opts)
+        params = { request_token: request_token }.compact
+        params.merge!(opts)
+        params.merge!(address&.to_hash) if address
+
+        response = connection.request(
+          :post,
+          'v2/onboarding/signups',
+          params
+        )
+
+        SignupAssessment.from_hash(response.body) if response.success?
+      end
 
-    def register_feedback(event:, occurred_at: nil, expires_at: nil, timestamp: nil, **ids)
-      if !timestamp.nil?
-        warn("Deprecation warning: use occurred_at instead of timestamp")
+      def register_login(account_id:, request_token: nil, **opts)
+        params = {
+          type: :login,
+          account_id: account_id,
+          request_token: request_token
+        }.compact
+        params.merge!(opts)
+
+        response = connection.request(
+          :post,
+          'v2/authentication/transactions',
+          params
+        )
+
+        LoginAssessment.from_hash(response.body) if response.success?
       end
 
-      timestamp = timestamp.strftime('%s%L') if timestamp.respond_to? :strftime
-      occurred_at = occurred_at.to_datetime.rfc3339 if occurred_at.respond_to? :to_datetime
-      expires_at = expires_at.to_datetime.rfc3339 if expires_at.respond_to? :to_datetime
+      def register_feedback(event:, occurred_at: nil, expires_at: nil, timestamp: nil, **ids)
+        if !timestamp.nil?
+          warn("Deprecation warning: use occurred_at instead of timestamp")
+        end
 
-      params = { event: event, timestamp: timestamp&.to_i, occurred_at: occurred_at, expires_at: expires_at }.compact
-      params.merge!(ids)
+        timestamp = timestamp.strftime('%s%L') if timestamp.respond_to? :strftime
+        occurred_at = occurred_at.to_datetime.rfc3339 if occurred_at.respond_to? :to_datetime
+        expires_at = expires_at.to_datetime.rfc3339 if expires_at.respond_to? :to_datetime
 
-      response = connection.request(
-        :post,
-        '/api/v2/feedbacks',
-        params
-      )
+        params = { event: event, timestamp: timestamp&.to_i, occurred_at: occurred_at, expires_at: expires_at }.compact
+        params.merge!(ids)
 
-      response.success?
-    end
+        response = connection.request(
+          :post,
+          '/api/v2/feedbacks',
+          params
+        )
 
-    def register_payment(installation_id:, account_id:, **opts)
-      params = { installation_id: installation_id, account_id: account_id, type: :payment }
-      params.merge!(opts)
+        response.success?
+      end
 
-      response = connection.request(
-        :post,
-        'v2/authentication/transactions',
-        params
-      )
+      def register_payment(account_id:, request_token: nil, **opts)
+        params = {
+          type: :payment,
+          account_id: account_id,
+          request_token: request_token
+        }.compact
+        params.merge!(opts)
+
+        response = connection.request(
+          :post,
+          'v2/authentication/transactions',
+          params
+        )
+
+        PaymentAssessment.from_hash(response.body) if response.success?
+      end
 
-      PaymentAssessment.from_hash(response.body) if response.success?
+      def connection
+        Client.instance
+      end
     end
   end
 end

data/lib/incognia_api/client.rb

@@ -1,32 +1,14 @@
 require "time"
+require "singleton"
 
 module Incognia
   class Client
+    include Singleton
     # TODO:
     # (ok) http/adapter specific code
     # (ok) raises network/authentication errors
     # (ok) handles token refreshing ok
     # future: handles retrying
-    attr_reader :connection
-
-    def initialize(client_id:, client_secret:, host:)
-      @client_id = client_id
-      @client_secret = client_secret
-      @host = host
-
-      headers = { 'User-Agent' => "incognia-ruby/#{Incognia::VERSION} " \
-                          "({#{RbConfig::CONFIG['host']}}) " \
-                          "{#{RbConfig::CONFIG['arch']}} " \
-                          "Ruby/#{RbConfig::CONFIG['ruby_version']}" }
-
-      @connection = Faraday.new(host, headers: headers) do |faraday|
-        faraday.request :json
-        faraday.response :json, content_type: /\bjson$/
-        faraday.response :raise_error
-
-        faraday.adapter Faraday.default_adapter
-      end
-    end
 
     def request(method, endpoint = nil, data = nil, headers = {})
       json_data = JSON.generate(data) if data
@@ -48,12 +30,29 @@ module Incognia
       @credentials
     end
 
+    def connection
+      return @connection if @connection
+
+      headers = { 'User-Agent' => "incognia-ruby/#{Incognia::VERSION} " \
+                          "({#{RbConfig::CONFIG['host']}}) " \
+                          "{#{RbConfig::CONFIG['arch']}} " \
+                          "Ruby/#{RbConfig::CONFIG['ruby_version']}" }
+
+      @connection = Faraday.new(Incognia.config.host, headers: headers) do |faraday|
+        faraday.request :json
+        faraday.response :json, content_type: /\bjson$/
+        faraday.response :raise_error
+
+        faraday.adapter Faraday.default_adapter
+      end
+    end
+
     protected
 
     def request_credentials
       basic_auth = Faraday::Request
         .lookup_middleware(:basic_auth)
-        .header(@client_id, @client_secret)
+        .header(Incognia.config.client_id, Incognia.config.client_secret)
 
       response = connection.send(:post, 'v2/token') do |r|
         r.headers[Faraday::Request::Authorization::KEY] = basic_auth

data/lib/incognia_api/configuration.rb

@@ -0,0 +1,17 @@
+require 'singleton'
+
+module Incognia
+  class Configuration
+    include Singleton
+
+    attr_accessor :client_id, :client_secret, :host
+
+    def configure(client_id:, client_secret:, host: nil)
+      @client_id = client_id
+      @client_secret = client_secret
+      @host = host || 'https://api.incognia.com/api'
+
+      self
+    end
+  end
+end

data/lib/incognia_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Incognia
-  VERSION = "1.1.0"
+  VERSION = "1.3.0"
 end

data/lib/incognia_api.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "incognia_api/configuration"
 require_relative "incognia_api/version"
 require_relative "incognia_api/client"
 require_relative "incognia_api/util"
@@ -15,6 +16,14 @@ require_relative "incognia_api/resources/credentials"
 require_relative "incognia_api/constants/feedback_event"
 
 module Incognia
+  def self.configure(**args)
+    config.configure(**args)
+  end
+
+  def self.config
+    Configuration.instance
+  end
+
   class APIError < StandardError
     attr_reader :message, :errors, :status
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: incognia_api
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Guilherme Cavalcanti
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-07-25 00:00:00.000000000 Z
+date: 2024-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -63,6 +63,7 @@ files:
 - lib/incognia_api/address.rb
 - lib/incognia_api/api.rb
 - lib/incognia_api/client.rb
+- lib/incognia_api/configuration.rb
 - lib/incognia_api/constants/feedback_event.rb
 - lib/incognia_api/resources/api_resource.rb
 - lib/incognia_api/resources/credentials.rb
@@ -77,7 +78,7 @@ metadata:
   homepage_uri: https://github.com/inloco/incognia-ruby
   source_code_uri: https://github.com/inloco/incognia-ruby
   changelog_uri: https://github.com/inloco/incognia-ruby/blob/master/
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -93,7 +94,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.4.19
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Official Ruby lib for communicating with Incognia API
 test_files: []