incognia_api 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f17e031979fde13ac3ac30d9cc3ebf9369da407eef0aec67e0313dcfa9c1ecd3
-  data.tar.gz: ecbd6959f1546fa24d5d85d5f7e95e8980539ab2fddca46838e46076571bc8b4
+  metadata.gz: a57edb1d744307af54b8b03d93f7b607f919cf41a66f71d92e3df45db1569b13
+  data.tar.gz: e572c70ff386ddb53c47a7921ff4b9ad1439a27188322c23d2098af1d2f77e03
 SHA512:
-  metadata.gz: 0f9945bb733db1fb2015636f85b3342684635a027ff70d8bd493887365085b893877ca4ea77d3f8c4e937cccfd2c4cf580bcf8223505bbfdebf5b61ada4684fe
-  data.tar.gz: 4f85f0ab80d4f9ca47509a6ff9edf78514990de7d0d25a3cd6c8e2a90fdbc904516d554189ad29651aae120b20ee5afe61e7ecfa80bb3f0b511c0882664d0cdb
+  metadata.gz: 942653d86e52ced892b20eaf9684fc0ed43535742f6d265c5b886caa5491bfdaedc56521d38c5ae8ed142d4f8196a13ee117d632c3dd7906977e8bdc3ff2687a
+  data.tar.gz: 15f3d172105df2645d60f94850abee3e280eb5ae425431e9409fb782eb49de21f1003c8d8fe6f8b7ae19e870c9738da97e980631adf8133c12f29ff021578a59

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [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

data/Gemfile.lock

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

data/README.md

@@ -35,16 +35,18 @@ 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
@@ -55,7 +57,7 @@ This method registers a new signup for the given request token and address, retu
 address = Incognia::Address.new(line: "West 34th Street, New York City, NY 10001")
 request_token = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
 
-assessment = api.register_signup(
+assessment = Incognia::Api.register_signup(
   request_token: request_token,
   address: address
 )
@@ -71,7 +73,7 @@ address = Incognia::Address.new(line: "West 34th Street, New York City, NY 10001
 request_token = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
 external_id = "7b02736a-7718-4b83-8982-f68fb6f501fa"
 
-assessment = api.register_signup(
+assessment = Incognia::Api.register_signup(
   request_token: request_token,
   address: address,
   external_id: external_id
@@ -88,7 +90,7 @@ This method registers a new login for the given request token and account, retur
 request_token = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
 account_id = 'account-identifier-123'
 
-assessment = api.register_login(
+assessment = Incognia::Api.register_login(
   request_token: request_token,
   account_id: account_id,
 )
@@ -104,7 +106,7 @@ request_token = "WlMksW+jh5GPhqWBorsV8yDihoSHHpmt+DpjJ7eYxpHhuO/5tuHTuA..."
 account_id = 'account-identifier-123'
 external_id = 'some-external-identifier'
 
-assessment = api.register_login(
+assessment = Incognia::Api.register_login(
   request_token: request_token,
   account_id: account_id,
   external_id: external_id,
@@ -120,7 +122,7 @@ This method registers a new payment for the given request token and account, ret
 containing the risk assessment and supporting evidence.
 
 ```ruby
-assessment = api.register_payment(
+assessment = Incognia::Api.register_payment(
   request_token: 'request-token',
   account_id: 'account-id'
 )
@@ -180,7 +182,7 @@ payment_methods = [
   }
 ]
 
-assessment = api.register_payment(
+assessment = Incognia::Api.register_payment(
   request_token: 'request-token',
   account_id: 'account-id',
   external_id: 'external-id',
@@ -206,7 +208,7 @@ 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,
   request_token: request_token,
@@ -219,7 +221,7 @@ 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,
   request_token: request_token,

data/lib/incognia_api/api.rb

@@ -5,83 +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(request_token: nil, address: nil, **opts)
-      params = { request_token: request_token }.compact
-      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(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
+    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
 
-    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")
+        response = connection.request(
+          :post,
+          'v2/onboarding/signups',
+          params
+        )
+
+        SignupAssessment.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_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
 
-      params = { event: event, timestamp: timestamp&.to_i, occurred_at: occurred_at, expires_at: expires_at }.compact
-      params.merge!(ids)
+      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
 
-      response = connection.request(
-        :post,
-        '/api/v2/feedbacks',
-        params
-      )
+        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.success?
-    end
+        params = { event: event, timestamp: timestamp&.to_i, occurred_at: occurred_at, expires_at: expires_at }.compact
+        params.merge!(ids)
 
-    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?
+        response = connection.request(
+          :post,
+          '/api/v2/feedbacks',
+          params
+        )
+
+        response.success?
+      end
+
+      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
+
+      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.2.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.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Guilherme Cavalcanti
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-26 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
@@ -92,8 +93,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key: 
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: Official Ruby lib for communicating with Incognia API
 test_files: []