feat-sdk 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f64fac3df2e3ba9d2dc9db569472dd8329bea2d4fb4f2117d44e65a45d9e652
-  data.tar.gz: 4d60e7877bc7df301aa90a96bd19b11c211d6941387ffe834793c84db04ad353
+  metadata.gz: 50c482a000c1e2ef525db051f580656d302cfbc0cb983c0241507615cd3d6b87
+  data.tar.gz: 1e52811533d9ba5d42805e2a9b665b626b984a1d30df61dfaa97fdacc90fe2f1
 SHA512:
-  metadata.gz: 2a990fc8a48b6176329fc664001c314b37fd5523122d91481700f804df7ec0d75f9705167eced27696627de0bfa25b895e0950b7aa69dd2d73785d917b7175b3
-  data.tar.gz: 8bbbed51ad214a26652743a15f036ea1936f431d74606c634f63282bfaaaee67310606e9110748a46385b9fa5786e441a6cd3690666a146c924ba4324420a1f2
+  metadata.gz: 40b5b6c2ab9fa985ac32c17bf39b4606c8e38a271e0e526383d2c7e1824348107f526d67350cc06dd60e5c4fd186a5df0ff41bad20f12353d1ddbf5cb3de583b
+  data.tar.gz: c41a41b359e9cd68664189fa9271b99346f67fbd4fa6286d56ec116d9cfeabf3788b16d68ad9c20bb5eb4e65f14a0760c05bacb06fc2fcd607435bb751fae213

data/README.md

@@ -1,4 +1,12 @@
-# feat-sdk
+<p align="center">
+  <a href="https://feat.so">
+    <img src="https://feat.so/logo/wordmark.png" alt="feat.so" width="320" />
+  </a>
+</p>
+
+---
+
+# feat Ruby SDK
 
 Server-side Ruby SDK for [feat](https://feat.so) feature flags. Local flag evaluation against a polled datafile. Standard library only - no gem dependencies.
 

data/lib/feat/client.rb

@@ -1,6 +1,8 @@
 require "json"
 require "net/http"
+require "socket"
 require "uri"
+require_relative "version"
 
 module Feat
   # Polling HTTP client. Uses stdlib only - zero gem dependencies.
@@ -8,6 +10,15 @@ module Feat
     DEFAULT_POLL_INTERVAL = 30.0
     MIN_POLL_INTERVAL = 5.0
     MAX_DATAFILE_BYTES = 10 * 1024 * 1024
+    OPEN_TIMEOUT_SECONDS = 3
+    READ_TIMEOUT_SECONDS = 10
+    RETRYABLE_CONNECT_ERRORS = [
+      Net::OpenTimeout,
+      Errno::ETIMEDOUT,
+      Errno::ECONNREFUSED,
+      Errno::EHOSTUNREACH,
+      Errno::ENETUNREACH,
+    ].freeze
 
     def initialize(api_key:, data_plane_url:, poll_interval: DEFAULT_POLL_INTERVAL, http_client: nil)
       raise ArgumentError, "api_key is required" if api_key.nil? || api_key.empty?
@@ -24,6 +35,7 @@ module Feat
       @mutex         = Mutex.new
       @stop          = false
       @thread        = nil
+      @sticky_ip     = nil
     end
 
     # Blocking initial fetch; spawns a background poller thread.
@@ -99,11 +111,10 @@ module Feat
       uri = URI.parse("#{@data_plane_url}/sdk/v1/datafile")
       req = Net::HTTP::Get.new(uri)
       req["Authorization"] = "Bearer #{@api_key}"
+      req["User-Agent"] = "feat-sdk-ruby/#{Feat::VERSION}"
       @mutex.synchronize { req["If-None-Match"] = @etag if @etag }
 
-      res = (@http_client || Net::HTTP).start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |http|
-        http.request(req)
-      end
+      res = with_http_connection(uri) { |http| http.request(req) }
 
       case res.code.to_i
       when 304, 404
@@ -124,5 +135,66 @@ module Feat
         raise "feat: fetch datafile failed: #{res.code}"
       end
     end
+
+    # Net::HTTP doesn't iterate getaddrinfo results on connect failure
+    # (Ruby 3.3 has no Happy Eyeballs); ipaddr= lets us pin each attempt
+    # to a specific IP while keeping the hostname for SNI.
+    def with_http_connection(uri, &block)
+      if @http_client
+        return @http_client.start(
+          uri.host, uri.port,
+          use_ssl: uri.scheme == "https",
+          open_timeout: OPEN_TIMEOUT_SECONDS,
+          read_timeout: READ_TIMEOUT_SECONDS,
+        ) { |h| block.call(h) }
+      end
+
+      sticky = @mutex.synchronize { @sticky_ip }
+      if sticky
+        begin
+          return attempt_request(uri, sticky, &block)
+        rescue *RETRYABLE_CONNECT_ERRORS
+          @mutex.synchronize { @sticky_ip = nil if @sticky_ip == sticky }
+        end
+      end
+
+      addresses = resolve_addresses(uri.host)
+      if addresses.empty?
+        return Net::HTTP.start(
+          uri.host, uri.port,
+          use_ssl: uri.scheme == "https",
+          open_timeout: OPEN_TIMEOUT_SECONDS,
+          read_timeout: READ_TIMEOUT_SECONDS,
+        ) { |h| block.call(h) }
+      end
+
+      last_error = nil
+      addresses.each do |ip|
+        next if ip == sticky
+        begin
+          result = attempt_request(uri, ip, &block)
+          @mutex.synchronize { @sticky_ip = ip }
+          return result
+        rescue *RETRYABLE_CONNECT_ERRORS => e
+          last_error = e
+        end
+      end
+      raise last_error
+    end
+
+    def attempt_request(uri, ip, &block)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.ipaddr = ip
+      http.use_ssl = (uri.scheme == "https")
+      http.open_timeout = OPEN_TIMEOUT_SECONDS
+      http.read_timeout = READ_TIMEOUT_SECONDS
+      http.start { |h| block.call(h) }
+    end
+
+    def resolve_addresses(host)
+      Addrinfo.getaddrinfo(host, nil, nil, :STREAM).map(&:ip_address).uniq
+    rescue StandardError
+      []
+    end
   end
 end

data/lib/feat/version.rb

@@ -1,3 +1,3 @@
 module Feat
-  VERSION = "0.1.0".freeze
+  VERSION = "0.1.1".freeze
 end

metadata

@@ -1,18 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: feat-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - feat HQ
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-06-04 00:00:00.000000000 Z
 dependencies: []
 description: Server-side Ruby SDK for feat. Polls a per-environment datafile and evaluates
   flags locally with no per-flag network call. Stdlib only.
 email:
-- engineering@feat.so
+- support@feat.so
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -36,6 +37,7 @@ metadata:
   source_code_uri: https://github.com/feathq/ruby-sdk
   bug_tracker_uri: https://github.com/feathq/ruby-sdk/issues
   changelog_uri: https://github.com/feathq/ruby-sdk/releases
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -50,7 +52,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: feat feature-flag SDK for Ruby (server-side, local evaluation)
 test_files: []