incognia_api 3.1.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b71c411cba337dac4e3ad7e0f16199ee99bc3ce6dc47858ee4b396a6e75b303
-  data.tar.gz: 68abfb412d0db671e1a98542f6179537745fbd395ec4b21b605b109133c91a42
+  metadata.gz: d68f4d6839a251feef3d35c6549916f85b61722d3d884c0f01088c55ffdad522
+  data.tar.gz: 94ceea8dfb16ace08e710082e511b724eb46e615f747bebcdad53283d58ababd
 SHA512:
-  metadata.gz: 2aa64e0525e09a97cca4dab86a0e2156822766884b0dda0905cc98806bc9ab3cfd761c612ecdd681cda460ced463f46694befe18b3fff49d12fc31062b2e3ade
-  data.tar.gz: f36e80da9184b5d65f72a2d2e0446fe3d383e6f90f791db041dc6ea56d6c81edcc4fd8009f5f82cd7c8084d1acb3531008cb8b97670448b83a1e6a294be161ae
+  metadata.gz: 2323ebadda00bfe03ce0d5fe15eb8bd8a504460a40170822c67f839c0785a942cb926fba49191236adfbbd7c88f60c7cc122372642fd8faf28d27459f65bff0b
+  data.tar.gz: 9c85a5715c2f295cd6072f41853fc3664f8624a575dbe78b0df09e333668ec9155d7b54b4a1599c6c6cb03f58b607effbdc8b2a0e2afa9b525329e42a9b6808b

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [4.0.0] - 2026-05-27
+- Reuse TCP connection by default
+
+## [3.2.0] - 2026-05-04
+- Add `county` support to structured addresses.
+
 ## [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.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    incognia_api (3.1.0)
+    incognia_api (4.0.0)
       faraday (~> 2.13)
       faraday-net_http_persistent (~> 2.3)
 

data/README.md

@@ -45,19 +45,29 @@ Incognia.configure(
 )
 ```
 
-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.
+HTTP connection reuse is enabled by default. When connection reuse is enabled,
+`max_connections` sets the maximum number of concurrent persistent connections
+used by the client.
 
 ```ruby
 Incognia.configure(
   client_id: ENV['INCOGNIA_CLIENT_ID'],
   client_secret: ENV['INCOGNIA_CLIENT_SECRET'],
-  keep_alive: true,
   max_connections: 5
 )
 ```
 
+To disable persistent connections, set `keep_alive: false`. `max_connections`
+can only be configured when `keep_alive` is enabled.
+
+```ruby
+Incognia.configure(
+  client_id: ENV['INCOGNIA_CLIENT_ID'],
+  client_secret: ENV['INCOGNIA_CLIENT_SECRET'],
+  keep_alive: false
+)
+```
+
 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`.

data/lib/incognia_api/address.rb

@@ -25,19 +25,20 @@ module Incognia
     end
 
     class Structured
-      attr_reader :locale, :country_name, :country_code, :state, :city, :borough,
-        :neighborhood, :state, :city, :borough, :neighborhood, :postal_code,
-        :street, :number, :complements
+      attr_reader :locale, :country_name, :country_code, :state, :city, :county,
+        :borough, :neighborhood, :postal_code, :street, :number, :complements
 
       def initialize(locale: nil, country_name: nil, country_code: nil, \
-                     state: nil, city: nil, borough: nil, neighborhood: nil, \
-                     postal_code: nil, street: nil, number: nil, complements: nil)
+                     state: nil, city: nil, county: nil, borough: nil, \
+                     neighborhood: nil, postal_code: nil, street: nil, \
+                     number: nil, complements: nil)
 
         @locale = locale
         @country_name = country_name
         @country_code = country_code
         @state = state
         @city = city
+        @county = county
         @borough = borough
         @neighborhood = neighborhood
         @postal_code = postal_code
@@ -54,6 +55,7 @@ module Incognia
             country_code: country_code,
             state: state,
             city: city,
+            county: county,
             borough: borough,
             neighborhood: neighborhood,
             street: street,

data/lib/incognia_api/configuration.rb

@@ -6,7 +6,7 @@ module Incognia
 
     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)
+    def configure(client_id:, client_secret:, host: nil, keep_alive: true, max_connections: nil)
       validate_connection_settings!(keep_alive: keep_alive, max_connections: max_connections)
 
       @client_id = client_id

data/lib/incognia_api/version.rb

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

data/lib/incognia_api.rb

@@ -29,7 +29,9 @@ module Incognia
   class APIError < StandardError
     attr_reader :message, :errors, :status
 
-    def initialize(message, response_info = {})
+    def initialize(message, response_info = nil)
+      response_info ||= {}
+
       @status = response_info[:status]
       @errors = response_info[:body]
       @message = format_message(message)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: incognia_api
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Guilherme Cavalcanti
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-17 00:00:00.000000000 Z
+date: 2026-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday