simple_connect-client 0.4.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae7e0f3cdc244fc7c1712733d2133880ba990266836efc5c17cea62446c8404a
-  data.tar.gz: 707d4208287010cc457b55952a2fd2ad52ec571ec03f55aafde77877f3b1e933
+  metadata.gz: f2aad5a1e606ce7a4e0f6865b23dc9b47a4e51ca16798d54680274f1869a0be4
+  data.tar.gz: 2d795adb31a236e0fff6867d369e3d5613f417ddce877a3cd627822d6bacbced
 SHA512:
-  metadata.gz: 763c65eb40890daa5a3cf62591d83ae899cd54c1782da943b430d77190051f809bee18e5c0ac1f532920e8cc2d9832c567d6c2d8d3ae8739a71953027e16390f
-  data.tar.gz: e8c9b418b9761f6e714ccc50524d32beac29f16d396d1439ff20c742b8d9389b54987f121a33171eb0a9288680ed7b73aaa17cb763967a9b5fedde4e1448eb55
+  metadata.gz: 5dedfab83ea079979e6c896b39dc4b7cd54f7fc02ca494906ccec03cfc8cefd6b0dcc728b4146b4d62980dbab465f8178fdc39ff8c317d9b94c2d1e7027ed9e9
+  data.tar.gz: 721910c69f6eda24a7e7fc9fa4a57e777d1c776f7967383b15f8978fca0f25981f5574b4fe4f13a5786c180e68dff80b79f43130b5d442af7a688b6bd57af746

data/lib/simple_connect/messages_client.rb

@@ -31,17 +31,15 @@ module SimpleConnect
     # @param debug [Boolean] when true, log the complete outgoing request
     #   (method, URL, headers, body) and the full response (status, headers,
     #   body) for each message API call. Defaults to false.
+    # @param ip_version [Symbol, nil] pin the connection to a single IP
+    #   family — `:ipv4` or `:ipv6` (see Request::IPV4 / Request::IPV6).
+    #   Defaults to nil, which leaves resolution to the OS (dual-stack).
     def initialize(base_url:, api_key:,
                    timeout: DEFAULT_TIMEOUT, logger: nil,
                    max_attempts: nil, retryable: nil, user_agent: nil,
-                   debug: true)
-      raise ConfigurationError, "base_url is required" if base_url.to_s.strip.empty?
-      raise ConfigurationError, "api_key is required"  if api_key.to_s.strip.empty?
-
-      if max_attempts && retryable
-        raise ConfigurationError,
-              "pass either `max_attempts:` or `retryable:`, not both"
-      end
+                   debug: true, ip_version: nil)
+      validate_config!(base_url: base_url, api_key: api_key, max_attempts: max_attempts,
+                       retryable: retryable, ip_version: ip_version)
 
       base_uri = URI.parse(base_url)
       request = Request.new(
@@ -49,9 +47,27 @@ module SimpleConnect
         timeout: timeout,
         logger: logger,
         retryable: retryable || Retryable.new(max_attempts: max_attempts || Retryable::DEFAULT_MAX_ATTEMPTS),
-        debug: debug
+        debug: debug,
+        ip_version: ip_version
       )
       @messages = Api::Messages.new(request: request, base_uri: base_uri)
     end
+
+    private
+
+    def validate_config!(base_url:, api_key:, max_attempts:, retryable:, ip_version:)
+      raise ConfigurationError, "base_url is required" if base_url.to_s.strip.empty?
+      raise ConfigurationError, "api_key is required"  if api_key.to_s.strip.empty?
+
+      if max_attempts && retryable
+        raise ConfigurationError,
+              "pass either `max_attempts:` or `retryable:`, not both"
+      end
+
+      return unless ip_version && !Request::IP_FAMILIES.key?(ip_version)
+
+      raise ConfigurationError,
+            "ip_version: must be #{Request::IPV4.inspect} or #{Request::IPV6.inspect}"
+    end
   end
 end

data/lib/simple_connect/request.rb

@@ -6,12 +6,19 @@ module SimpleConnect
   # delegated to the injected Retryable; per-retry sleep / delay policy lives
   # there (see SimpleConnect::Retryable).
   class Request
-    def initialize(headers:, timeout:, retryable:, logger: nil, debug: false)
-      @headers   = headers
-      @timeout   = timeout
-      @logger    = logger
-      @retryable = retryable
-      @debug     = debug
+    # Force the connection onto a single IP family instead of the OS default
+    # dual-stack resolution. nil leaves resolution to the OS.
+    IPV4 = :ipv4
+    IPV6 = :ipv6
+    IP_FAMILIES = { IPV4 => Socket::AF_INET, IPV6 => Socket::AF_INET6 }.freeze
+
+    def initialize(headers:, timeout:, retryable:, logger: nil, debug: false, ip_version: nil)
+      @headers    = headers
+      @timeout    = timeout
+      @logger     = logger
+      @retryable  = retryable
+      @debug      = debug
+      @ip_version = ip_version
     end
 
     def get(uri, body: "")
@@ -66,9 +73,17 @@ module SimpleConnect
       http.use_ssl = uri.scheme == "https"
       http.read_timeout = @timeout
       http.open_timeout = @timeout
+      http.ipaddr = resolve_ip(uri.host) if @ip_version
       http
     end
 
+    # Pin the socket to the requested IP family while keeping the original
+    # host for the Host header and TLS SNI (Net::HTTP#ipaddr= preserves them).
+    def resolve_ip(host)
+      family = IP_FAMILIES.fetch(@ip_version)
+      Addrinfo.getaddrinfo(host, nil, family, :STREAM).first&.ip_address
+    end
+
     def build_net_http_request(http_method, uri, headers, body)
       case http_method
       when :get

data/lib/simple_connect/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SimpleConnect
-  VERSION = "0.4.1"
+  VERSION = "0.4.2"
 end

data/lib/simple_connect.rb

@@ -4,6 +4,7 @@ require "json"
 require "net/http"
 require "openssl"
 require "securerandom"
+require "socket"
 require "time"
 require "uri"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simple_connect-client
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.2
 platform: ruby
 authors:
 - Ramkrishan Patidar