incognia_api 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 823c5ab4bca2a8fd1d856482906971073d95a1f55e378c6d812da69d205f689e
-  data.tar.gz: 26e4f368b891e14cab04a69b1de02342bf48e2b5f0eea474a1947bf5103fd773
+  metadata.gz: 8b71c411cba337dac4e3ad7e0f16199ee99bc3ce6dc47858ee4b396a6e75b303
+  data.tar.gz: 68abfb412d0db671e1a98542f6179537745fbd395ec4b21b605b109133c91a42
 SHA512:
-  metadata.gz: 3e34fe28af027501b6e4f907d4c9973c930fc86b2ce3ae565fce72979c3a55098a0c3700b91f62d00d7c8ab2d350440e89caf11b0a716c053d6e5f7f89ca2731
-  data.tar.gz: 07ece7a29b0fe8dcb88b1e7df6817d83ab13c42c751bdcb83877912df9f4c94c54d401368c549e0f4cce3e28ffcdfb19a28df5abb27823d9f012ecd6a0f8ec2b
+  metadata.gz: 2aa64e0525e09a97cca4dab86a0e2156822766884b0dda0905cc98806bc9ab3cfd761c612ecdd681cda460ced463f46694befe18b3fff49d12fc31062b2e3ade
+  data.tar.gz: f36e80da9184b5d65f72a2d2e0446fe3d383e6f90f791db041dc6ea56d6c81edcc4fd8009f5f82cd7c8084d1acb3531008cb8b97670448b83a1e6a294be161ae

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+## [3.1.0] - 2026-04-17
+- Add optional `keep_alive` support with configurable `max_connections` for persistent HTTP connections.
+- Add `X-Incognia-Latency` support by sending the previous successful request latency on subsequent API calls.
+- Refresh locked dependencies, including `faraday` 2.14.1 and `json` 2.15.2.1.
+
 ## [3.0.0] - 2025-09-22
 - Update `faraday` dependency to version 2.13.4
 - Remove `faraday_middleware` dependency

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    incognia_api (3.0.0)
+    incognia_api (3.1.0)
       faraday (~> 2.13)
+      faraday-net_http_persistent (~> 2.3)
 
 GEM
   remote: https://rubygems.org/
@@ -10,21 +11,27 @@ GEM
     addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
     coderay (1.1.3)
+    connection_pool (3.0.2)
     crack (0.4.5)
       rexml
     diff-lcs (1.4.4)
-    faraday (2.13.4)
+    faraday (2.14.1)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
-    faraday-net_http (3.4.1)
-      net-http (>= 0.5.0)
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    faraday-net_http_persistent (2.3.1)
+      faraday (~> 2.5)
+      net-http-persistent (>= 4.0.4, < 5)
     hashdiff (1.0.1)
-    json (2.14.0)
+    json (2.15.2.1)
     logger (1.7.0)
     method_source (1.0.0)
-    net-http (0.6.0)
-      uri
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    net-http-persistent (4.0.8)
+      connection_pool (>= 2.2.4, < 4)
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
@@ -45,15 +52,16 @@ GEM
       rspec-support (~> 3.10.0)
     rspec-support (3.10.2)
     timecop (0.9.4)
-    uri (1.0.3)
+    uri (1.1.1)
     webmock (3.14.0)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
 
 PLATFORMS
-  ruby
+  arm64-darwin-24
   x86_64-darwin-20
+  x86_64-linux-gnu
 
 DEPENDENCIES
   incognia_api!

data/README.md

@@ -39,9 +39,23 @@ Before using the API client, you must configure it using credentials obtained
 from the [Incognia dashboard](https://dash.incognia.com/):
 
 ```ruby
-Incognia.configure(client_id: ENV['INCOGNIA_CLIENT_ID'], client_secret: ENV['INCOGNIA_CLIENT_SECRET'])
+Incognia.configure(
+  client_id: ENV['INCOGNIA_CLIENT_ID'],
+  client_secret: ENV['INCOGNIA_CLIENT_SECRET']
+)
+```
+
+To reuse HTTP connections between requests, enable `keep_alive`. When enabled,
+`max_connections` sets the maximum number of concurrent persistent
+connections used by the client.
 
-# Incognia.configure(client_id: "your-client-id", client_secret: "your-client-secret")
+```ruby
+Incognia.configure(
+  client_id: ENV['INCOGNIA_CLIENT_ID'],
+  client_secret: ENV['INCOGNIA_CLIENT_SECRET'],
+  keep_alive: true,
+  max_connections: 5
+)
 ```
 
 For sandbox credentials, refer to the [API testing guide](https://developer.incognia.com/).

data/incognia_api.gemspec

@@ -29,6 +29,7 @@ Gem::Specification.new do |spec|
   # Uncomment to register a new dependency of your gem
   # spec.add_dependency "example-gem", "~> 1.0"
   spec.add_dependency('faraday', '~> 2.13')
+  spec.add_dependency('faraday-net_http_persistent', '~> 2.3')
 
   # For more information and examples about making a new gem, checkout our
   # guide at: https://bundler.io/guides/creating_gem.html

data/lib/incognia_api/client.rb

@@ -1,21 +1,34 @@
 require "time"
 require "singleton"
+require "faraday/net_http_persistent"
 
 module Incognia
   class Client
     include Singleton
+    LATENCY_HEADER = "X-Incognia-Latency".freeze
+
     # TODO:
     # (ok) http/adapter specific code
     # (ok) raises network/authentication errors
     # (ok) handles token refreshing ok
     # future: handles retrying
 
+    def initialize
+      @last_latency_ms = nil
+      @last_latency_mutex = Mutex.new
+    end
+
     def request(method, endpoint = nil, data = nil, headers = {})
       json_data = JSON.generate(data) if data
+      request_headers = Faraday::Utils::Headers.new.update(headers)
+      request_headers[Faraday::Request::Authorization::KEY] ||= "Bearer #{credentials.access_token}"
+      request_headers[LATENCY_HEADER] = last_latency_ms&.to_s
 
-      connection.send(method, endpoint, json_data, headers) do |r|
-        r.headers[Faraday::Request::Authorization::KEY] ||= "Bearer #{credentials.access_token}"
-      end
+      start = Process.clock_gettime(Process::CLOCK_MONOTONIC, :millisecond)
+      response = connection.send(method, endpoint, json_data, request_headers.compact)
+      store_last_latency(Process.clock_gettime(Process::CLOCK_MONOTONIC, :millisecond) - start) if response.success?
+
+      response
     rescue Faraday::ClientError, Faraday::ServerError => e
       raise APIError.new(e.to_s, e.response)
     rescue Faraday::Error => e
@@ -28,6 +41,12 @@ module Incognia
       @credentials
     end
 
+    def reset!
+      @connection&.close
+      @connection = nil
+      @credentials = nil
+    end
+
     def connection
       return @connection if @connection
 
@@ -41,7 +60,15 @@ module Incognia
         faraday.response :json, content_type: /\bjson$/
         faraday.response :raise_error
 
-        faraday.adapter Faraday.default_adapter
+        if Incognia.config.keep_alive
+          adapter_options = {
+            pool_size: Incognia.config.max_connections
+          }.compact
+
+          faraday.adapter :net_http_persistent, **adapter_options
+        else
+          faraday.adapter Faraday.default_adapter
+        end
       end
     end
 
@@ -73,5 +100,13 @@ module Incognia
       Credentials.from_hash(properties)
     end
 
+    def last_latency_ms
+      @last_latency_mutex.synchronize { @last_latency_ms }
+    end
+
+    def store_last_latency(latency_ms)
+      @last_latency_mutex.synchronize { @last_latency_ms = latency_ms }
+    end
+
   end
 end

data/lib/incognia_api/configuration.rb

@@ -4,14 +4,27 @@ module Incognia
   class Configuration
     include Singleton
 
-    attr_accessor :client_id, :client_secret, :host
+    attr_accessor :client_id, :client_secret, :host, :keep_alive, :max_connections
+
+    def configure(client_id:, client_secret:, host: nil, keep_alive: false, max_connections: nil)
+      validate_connection_settings!(keep_alive: keep_alive, max_connections: max_connections)
 
-    def configure(client_id:, client_secret:, host: nil)
       @client_id = client_id
       @client_secret = client_secret
       @host = host || 'https://api.incognia.com/api'
+      @keep_alive = keep_alive
+      @max_connections = max_connections
 
       self
     end
+
+    private
+
+    def validate_connection_settings!(keep_alive:, max_connections:)
+      return if max_connections.nil?
+
+      raise ArgumentError, 'max_connections requires keep_alive: true' unless keep_alive
+      raise ArgumentError, 'max_connections must be a positive Integer' unless max_connections.is_a?(Integer) && max_connections.positive?
+    end
   end
 end

data/lib/incognia_api/version.rb

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

data/lib/incognia_api.rb

@@ -19,7 +19,7 @@ require_relative "incognia_api/constants/feedback_event"
 
 module Incognia
   def self.configure(**args)
-    config.configure(**args)
+    config.configure(**args).tap { Client.instance.reset! }
   end
 
   def self.config

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: incognia_api
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Guilherme Cavalcanti
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-22 00:00:00.000000000 Z
+date: 2026-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.13'
+- !ruby/object:Gem::Dependency
+  name: faraday-net_http_persistent
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
 description: Official Ruby lib for communicating with Incognia API
 email:
 - guiocavalcanti@gmail.com