featureflip 2.10.0 → 2.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 33b15e24100b214989443fd146e3b5a4ef29c92ee28f457419c4ef0816e01efa
-  data.tar.gz: f638de9e949664b629c35771bce31f2dff71eb018133eeecc3a1d952ba037992
+  metadata.gz: 7dbbc4e1eefae9adf8a818fc31905e674ee68369be22f6d558f1838604a34fba
+  data.tar.gz: 91ddda08b1eb8015d297c4a6206d8df48704cde620908634bdc7c5415b6e3cb4
 SHA512:
-  metadata.gz: 0c3da771ddf9cb78f4a73f890d03d178047f78dfdf0a1347a52ca82dd1e3721f79b3249856ea1413068aa924b1f5d9acf9a8c2449b79731134508b9f4701714f
-  data.tar.gz: f73db84108ad650e6812868b217fc3b981ba0cdbc2985de312ef94d2fc88d8fdb2d24cc638a5c24837b3598271f7a49005ed5ba1b9f428778099909042b5457b
+  metadata.gz: 1c77f14b1245ebd4453d878c41fbadbea5051cee8b86eb5a9aed6fb210714b71275792b19cf571e62ccacce985babf303db5eeb81875fd6a18009bb169ef5506
+  data.tar.gz: 0ea6aba2d012d330c976e2fee16be73aee7d3ec1392a7bc0677147b2e1d7bac1a33b7048b59afaad82fd72339e984421ddb358339bedb220bacb66b8fa572e55

data/lib/featureflip/config.rb

@@ -4,6 +4,15 @@ module Featureflip
                   :flush_batch_size, :init_timeout, :connect_timeout, :read_timeout,
                   :max_stream_retries, :send_events, :logger
 
+    # Identifies a library that wraps this SDK, such as the OpenFeature provider. Its
+    # token is sent after the SDK's own in the User-Agent
+    # (`featureflip-ruby/<version> my-wrapper/1.0.0`) so usage through the wrapper can be
+    # counted. Both parts must be valid HTTP tokens; an invalid wrapper is ignored with a
+    # logged warning. wrapper_version may be nil. Leave unset when calling the SDK
+    # directly. Excluded from SharedCore._configs_equal: it identifies the caller rather
+    # than changing behavior.
+    attr_accessor :wrapper_name, :wrapper_version
+
     # Evaluation inspectors -- callables invoked once per variation call with a
     # Models::EvaluationEvent. Always an Array; non-callable entries are dropped
     # on assignment rather than blowing up on the evaluation hot path.
@@ -22,7 +31,9 @@ module Featureflip
       max_stream_retries: 5,
       send_events: true,
       logger: nil,
-      inspectors: nil
+      inspectors: nil,
+      wrapper_name: nil,
+      wrapper_version: nil
     )
       @sdk_key = sdk_key
       @base_url = base_url
@@ -37,6 +48,8 @@ module Featureflip
       @send_events = send_events
       @logger = logger || default_logger
       self.inspectors = inspectors
+      @wrapper_name = wrapper_name
+      @wrapper_version = wrapper_version
 
       validate!
     end
@@ -53,6 +66,13 @@ module Featureflip
       @inspectors = list.select { |i| i.respond_to?(:call) }.freeze
     end
 
+    # The User-Agent for every request: the SDK token, then the wrapper's (#4154). Built
+    # on first use and memoized, so the HTTP client and the stream share one value and an
+    # invalid wrapper is warned about once.
+    def user_agent
+      @user_agent ||= SdkIdentity.user_agent(self)
+    end
+
     def validate!
       finalize!
       validate_positive_fields!

data/lib/featureflip/data_source/streaming.rb

@@ -160,7 +160,9 @@ module Featureflip
         req = Net::HTTP::Get.new(uri.request_uri)
         req["Authorization"] = @sdk_key
         req["Accept"] = "text/event-stream"
-        req["User-Agent"] = "featureflip-ruby/#{Featureflip::VERSION}"
+        # Same memoized value as the HTTP client, so an invalid wrapper is warned about
+        # once rather than on every reconnect.
+        req["User-Agent"] = @config.user_agent
 
         http.request(req) do |response|
           unless response.is_a?(Net::HTTPSuccess)

data/lib/featureflip/http/client.rb

@@ -83,7 +83,7 @@ module Featureflip
 
         req["Authorization"] = @sdk_key
         req["Content-Type"] = "application/json"
-        req["User-Agent"] = "featureflip-ruby/#{Featureflip::VERSION}"
+        req["User-Agent"] = @config.user_agent
 
         response = http.request(req)
 

data/lib/featureflip/sdk_identity.rb

@@ -0,0 +1,27 @@
+module Featureflip
+  # The User-Agent every request carries so the Evaluation API can count SDK usage by
+  # name and version (#4154, contract in #4138): `featureflip-ruby/<version>`, then the
+  # configured wrapper's token. VERSION is the constant the publish workflow rewrites,
+  # never a second literal (#2141).
+  module SdkIdentity
+    # RFC 9110 product token: tchars.
+    TOKEN = /\A[!#$%&'*+.^_`|~0-9A-Za-z-]+\z/
+
+    def self.user_agent(config)
+      sdk = "featureflip-ruby/#{Featureflip::VERSION}"
+      name = config.wrapper_name
+      return sdk if name.nil? || name.to_s.empty?
+
+      version = config.wrapper_version
+      unless TOKEN.match?(name.to_s) && (version.nil? || TOKEN.match?(version.to_s))
+        # Dropped rather than raised: identity metadata must never stop the client starting.
+        config.logger.warn(
+          "Featureflip: ignoring wrapper '#{name}/#{version}': not a valid User-Agent product token"
+        )
+        return sdk
+      end
+
+      version.nil? ? "#{sdk} #{name}" : "#{sdk} #{name}/#{version}"
+    end
+  end
+end

data/lib/featureflip/shared_core.rb

@@ -595,6 +595,8 @@ module Featureflip
       @update_listeners_mutex = Mutex.new
     end
 
+    # wrapper_name/wrapper_version are deliberately excluded: they identify the caller
+    # rather than change behavior (see Config).
     def self._configs_equal(a, b)
       a.base_url == b.base_url &&
         a.streaming == b.streaming &&

data/lib/featureflip/version.rb

@@ -1,3 +1,3 @@
 module Featureflip
-  VERSION = "2.10.0"
+  VERSION = "2.11.0"
 end

data/lib/featureflip.rb

@@ -1,6 +1,7 @@
 require_relative "featureflip/version"
 require_relative "featureflip/errors"
 require_relative "featureflip/config"
+require_relative "featureflip/sdk_identity"
 require_relative "featureflip/models/flag"
 require_relative "featureflip/models/segment"
 require_relative "featureflip/models/evaluation_detail"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: featureflip
 version: !ruby/object:Gem::Version
-  version: 2.10.0
+  version: 2.11.0
 platform: ruby
 authors:
 - Featureflip
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-10 00:00:00.000000000 Z
+date: 2026-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logger
@@ -88,6 +88,7 @@ files:
 - lib/featureflip/models/evaluation_event.rb
 - lib/featureflip/models/flag.rb
 - lib/featureflip/models/segment.rb
+- lib/featureflip/sdk_identity.rb
 - lib/featureflip/shared_core.rb
 - lib/featureflip/store/flag_store.rb
 - lib/featureflip/store/update_diff.rb