featureflip-openfeature 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6fa5f7d072f5f820620ac950eda71f01af344681916c8fd152229a881a0f142
-  data.tar.gz: bc9efccb44950cc991d5aabf9594f245075fb205ecc3a0c48f8ba34de2198f87
+  metadata.gz: f200fca2c00afb3109431bc224e6f49fac272f43fdbfde00b9a33e52d1f4c83f
+  data.tar.gz: c7e7e399ae3945b3444137f33d93ae44a8e903f92bd9962404bd2ad6a7ec7b4b
 SHA512:
-  metadata.gz: 7dda6c5cf1cb568b1632b8d8d4fe4af625ccf917236cb0f3ce4cdd4040c01f6ea5ebf07d0670d6ce8170484429eeb3984176cfdab6d701f66f6c9e5a97ae9e83
-  data.tar.gz: 754d476ea0e98b5421f21b4e786ce10efaf2acf8664dfce812fdb849e8811e6e593f04d198ebe6758a19ae2ff688b3bc140fe01316988b5ffd0bf66a18576532
+  metadata.gz: 0fd9682f0998b58d6b107626f1634c155d72a128cd9dc865b33f1ad92723697e2ce572ea89e509870777ee0b4ea10e0ec4bd0b10b7dbc5fd12e7b928d4404f3f
+  data.tar.gz: 78bcd49889185f9715703d096af2f510eeb6221d48f2644670efe29c92a75a0b323bd3fa96ddd292588a6d7a74aceb7b3e94e36428c41968b8ba062e2d8fefa8

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.2.1 — 2026-10-26
+
+### Changed
+
+- Requires the `featureflip` gem 2.13 or later, so the evaluation events behind every flag the provider resolves carry the evaluation reason (`rule-match`, `fallthrough`, `flag-disabled`, `prerequisite-failed`, `error` or `flag-not-found`) and the matched rule id. Featureflip's flag Analytics tab uses them to show which part of the targeting served the traffic. (#4268)
+
+## 0.2.0 — 2026-10-20
+
+### Added
+
+- Requests made through the provider now identify it: `User-Agent: featureflip-ruby/<version> featureflip-openfeature-ruby/<version>`, so Featureflip can count OpenFeature usage apart from direct SDK use. This applies when the provider builds its own client from `sdk_key:`; it works on a copy of your `Featureflip::Config`, so the config you passed is unchanged. A `client:` you pass in was built before the provider saw it, so its requests are unchanged, and a `wrapper_name:` already set on your config is kept. (#4154)
+
+### Changed
+
+- Requires `featureflip` `~> 2.11`, the release that added `wrapper_name:`.
+
 ## 0.1.0 — 2026-10-10
 
 ### Added

data/README.md

@@ -59,6 +59,12 @@ fork leaves each worker with dead polling and streaming threads, so it serves
 the boot snapshot and never emits `PROVIDER_CONFIGURATION_CHANGED`. If you pass
 your own `client:`, call `client.restart` in that hook instead.
 
+The SDK keeps one client core per SDK key in each process. So if your app also
+builds a client for the same key before the fork, say with
+`Featureflip.configure` in a Rails initializer, the provider registered after
+the fork picks up that inherited core, dead threads and all. Call
+`Featureflip.restart` in the same hook to bring it back to life.
+
 Full documentation: https://featureflip.io/docs/integrations/openfeature/#ruby
 
 ## License

data/lib/featureflip/open_feature/provider.rb

@@ -60,7 +60,7 @@ module Featureflip
           generation = @state_mutex.synchronize { @shut_down ? nil : @generation }
           return nil if generation.nil?
 
-          @client ||= Featureflip::Client.get(@sdk_key, config: @config)
+          @client ||= Featureflip::Client.get(@sdk_key, config: identified_config)
           # Subscribed after the client is ready, so the initial load is never a
           # "change" (OpenFeature signals it with PROVIDER_READY). Guarded because
           # OpenFeature may initialize a provider more than once. The listener can
@@ -118,7 +118,8 @@ module Featureflip
         resolve(:object, flag_key, default_value, evaluation_context)
       end
 
-      # Called by openfeature-sdk 0.6.1+; 0.5 has no tracking API and never calls it.
+      # Called by openfeature-sdk 0.6.1+, the release that added the tracking API.
+      # Earlier versions never call it.
       def track(tracking_event_name, evaluation_context: nil, tracking_event_details: nil)
         client = @client
         return if client.nil?
@@ -133,6 +134,25 @@ module Featureflip
 
       private
 
+      WRAPPER_NAME = "featureflip-openfeature-ruby"
+
+      # The caller's config (or a default one) naming this provider as the SDK's
+      # wrapper, so requests read "featureflip-ruby/<v> featureflip-openfeature-ruby/<v>"
+      # (#4154). A copy, so a config the caller reuses for direct SDK clients is not
+      # relabelled, with the SDK's memoized user agent cleared so the copy does not
+      # inherit the caller's. A wrapper the caller already set is kept: the SDK
+      # carries one, and theirs is the more specific. Only the sdk_key: form gets
+      # here; a borrowed client was built before the provider saw it.
+      def identified_config
+        return @config if @config&.wrapper_name
+
+        copy = @config ? @config.dup : Featureflip::Config.new
+        copy.remove_instance_variable(:@user_agent) if copy.instance_variable_defined?(:@user_agent)
+        copy.wrapper_name = WRAPPER_NAME
+        copy.wrapper_version = VERSION
+        copy
+      end
+
       # Reads UNTYPED via variation_detail and applies the type guard here. The
       # SDK's typed accessors report a wrong-typed value as reason "Error", the
       # same reason a real failure carries, so TYPE_MISMATCH could not be told

data/lib/featureflip/open_feature/version.rb

@@ -2,6 +2,6 @@ module Featureflip
   module OpenFeature
     # Rewritten from the release tag at publish time; the committed value is
     # convention, the tag is what ships.
-    VERSION = "0.1.0"
+    VERSION = "0.2.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: featureflip-openfeature
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Featureflip
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-11 00:00:00.000000000 Z
+date: 2026-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: featureflip
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.10'
+        version: '2.13'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.10'
+        version: '2.13'
 - !ruby/object:Gem::Dependency
   name: openfeature-sdk
   requirement: !ruby/object:Gem::Requirement