feat!: reuse TCP connection by default

[figueredo]

Change TCP connection reuse to be default behavior so that clients have better performance with less configuration.

[Copilot]

Pull request overview

This PR changes the client’s default HTTP behavior to reuse TCP connections (persistent connections) without requiring explicit keep_alive: true, improving performance with reduced configuration.

Changes:

• Switch Configuration#configure default keep_alive from false to true.
• Update specs to reflect the new default and validate adapter selection.
• Update README to reflect that connection reuse is enabled by default and simplify the max_connections example.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File	Description
lib/incognia_api/configuration.rb	Changes default keep_alive to true, making persistent connections the default.
spec/incognia_spec.rb	Updates configuration specs to assert keep_alive defaults to true and adjusts the max_connections/keep_alive validation scenario.
spec/client_spec.rb	Adds a spec asserting the persistent adapter is selected by default.
README.md	Updates documentation to state connection reuse is enabled by default and removes keep_alive: true from the example.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

lib/incognia_api.rb:38

• format_message can return nil when errors is nil because the conditional append is the last expression in the method. That makes APIError#message/to_s potentially nil for cases like timeouts (where response_info is {}), which is surprising and can break consumers expecting a string. Consider explicitly returning message at the end of format_message (or using tap) so it always returns a String.

    def initialize(message, response_info = {})
      response_info ||= {}

      @status = response_info[:status]
      @errors = response_info[:body]
      @message = format_message(message)
    end

[ottony]

Can you bump the version, update the lock, and CHANGELOG, please?

https://github.com/inloco/incognia-ruby#development

update the version number in version.rb, run bundle to update the gemfile.lock, add one description on CHANGELOG.md if necessary

[ottony]

Was it sent as null?
As you're already treating nil, we can change the default to be nil, wdyt?

Suggested change

	def initialize(message, response_info = {})
	response_info ||= {}
	def initialize(message, response_info = nil)
	response_info ||= {}

[ottony]

Is it a breaking change, or is it okay to assume it as the default?

I'm asking so we can decide about the version.

[ottony]

Why did we need to mock it before the expect_any_instance_of? Does it have another call, with different params?