openfeature-sdk 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b8b6e8a5fd01205278fa44c809eb3c1ef578b56e5542aa94793a090e605458d
-  data.tar.gz: f85c7d0e8b804fb651e02cc3c59d14c21458f9fdb419d58df6d8fbb714a35b9b
+  metadata.gz: a637edf0b0a85dbfbaf655066912a64a21c1cd4a467b4fe557208c10184df3a9
+  data.tar.gz: 6fa0f3f6e534279a8e1b6296e1e8b524decd315c99e4bc6238575f3867a8a428
 SHA512:
-  metadata.gz: a7fef199498fb02863ed74cf76a6fbff8acf65df23e2e5d4baad90b6ed3da589b6ca98da1540443a7367456a527819eb2380979aa4f1a1ef8780c33ccf425d32
-  data.tar.gz: 71db2db0d85592861ebd5f117d7599e9d54374deb9a6eae5060716044abddb27a4bd10db7ca07314540a36adeb7c366afa1a8c21fb4f19824e05e15fd59a1a27
+  metadata.gz: d16e851abe52d3bbbac68aa9180a9c1ace7b7cf97ce3508c21e083d7780825b862a608a7f438598d6bcb44c50efeceb84148c2f5351d544cb5584546d2cb2c22
+  data.tar.gz: 18c44f236a822a02469a4ed66b297c607e7e59d440428266790ce1a95da21a549e122c605d7d1f9c70af9442d8f6ce8c0c7ff0242e1f69268ce242bb7dbb02b8

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.7.0"
+  ".": "0.8.0"
 }

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [0.8.0](https://github.com/open-feature/ruby-sdk/compare/v0.7.1...v0.8.0) (2026-10-23)
+
+
+### ⚠ BREAKING CHANGES
+
+* make hook inputs immutable ([#357](https://github.com/open-feature/ruby-sdk/issues/357))
+
+### Bug Fixes
+
+* do not mutate the provider's ResolutionDetails ([#358](https://github.com/open-feature/ruby-sdk/issues/358)) ([ec657a5](https://github.com/open-feature/ruby-sdk/commit/ec657a5fc7b1514828ea2fa1cb6bfe017029f5af))
+* make hook inputs immutable ([#357](https://github.com/open-feature/ruby-sdk/issues/357)) ([9e166fe](https://github.com/open-feature/ruby-sdk/commit/9e166fe09ec2a10d220295b600141cb351516b24))
+
+## [0.7.1](https://github.com/open-feature/ruby-sdk/compare/v0.7.0...v0.7.1) (2026-10-23)
+
+
+### Features
+
+* isolated API instances ([#354](https://github.com/open-feature/ruby-sdk/issues/354)) ([1c92b4a](https://github.com/open-feature/ruby-sdk/commit/1c92b4ad7550a6b345e7471f84cd5a7ff445591e))
+
+
+### Bug Fixes
+
+* key provider state by identity, default the NoOp reason, freeze client metadata ([#355](https://github.com/open-feature/ruby-sdk/issues/355)) ([d15bd84](https://github.com/open-feature/ruby-sdk/commit/d15bd84e1456b6200e29c12c3463c4f8ddfe693f))
+
 ## [0.7.0](https://github.com/open-feature/ruby-sdk/compare/v0.6.7...v0.7.0) (2026-10-23)
 
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    openfeature-sdk (0.7.0)
+    openfeature-sdk (0.8.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -17,8 +17,8 @@
   </a>
   <!-- x-release-please-start-version -->
 
-  <a href="https://github.com/open-feature/ruby-sdk/releases/tag/v0.7.0">
-    <img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.7.0&color=blue&style=for-the-badge" />
+  <a href="https://github.com/open-feature/ruby-sdk/releases/tag/v0.8.0">
+    <img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.8.0&color=blue&style=for-the-badge" />
   </a>
 
   <!-- x-release-please-end -->
@@ -443,6 +443,29 @@ class MyRequestScopedPropagator
 end
 ```
 
+### Isolated API instances
+
+`OpenFeature::SDK` is a global singleton. Some applications need more than one independent API in a process, for example separately developed modules that each need their own provider, or tests that run in parallel. Require the factory explicitly to create one:
+
+```ruby
+require "open_feature/sdk/isolated"
+
+api = OpenFeature::SDK::Isolated.create_api
+api.set_provider_and_wait(MyProvider.new)
+client = api.build_client
+client.fetch_boolean_value(flag_key: "my-flag", default_value: false)
+```
+
+Each instance has its own providers, hooks, evaluation context, event handlers, transaction context propagator and `shutdown`, and shares none of them with `OpenFeature::SDK` or other instances.
+Build its clients with `api.build_client`; `OpenFeature::SDK::Client.new` binds to the global API.
+Prefer the global API unless you need this.
+
+A provider instance should be registered with only one API at a time.
+Registering a provider that includes `OpenFeature::SDK::Provider::EventEmitter` with a second API raises `ArgumentError`; other providers can't be detected.
+Once the first API replaces the provider or shuts down, it can be registered with another.
+
+A `LoggingHook` created without `logger:` logs to the global API's logger, even when added to an isolated API. Pass `logger:` to use another.
+
 ## Extending
 
 ### Develop a provider
@@ -543,6 +566,11 @@ class MyLoggingHook
 end
 ```
 
+Hooks can read their inputs but not change them:
+
+- Only `before` hooks can change the evaluation context: return an `EvaluationContext` for the SDK to merge in, or assign `hook_context.evaluation_context`. By the time `after`, `error` and `finally` run, it's a frozen copy, so assigning it or writing to its `fields` raises `FrozenError`. Nested field values aren't frozen, because they belong to the caller.
+- The flag key, the default value, the hints, and the client and provider metadata are frozen copies. Your own objects aren't frozen.
+
 > Built a new hook? [Let us know](https://github.com/open-feature/openfeature.dev/issues/new?assignees=&labels=hook&projects=&template=document-hook.yaml&title=%5BHook%5D%3A+) so we can add it to the docs!
 
 <!-- x-hide-in-docs-start -->

data/lib/open_feature/sdk/api.rb

@@ -32,13 +32,15 @@ module OpenFeature
     #
     #   client = OpenFeature::SDK::API.instance.build_client(name: 'my-open-feature-client')
     class API
-      include Singleton # Satisfies Flag Evaluation API Requirement 1.1.1
+      include Singleton # Satisfies Flag Evaluation API Requirement 1.1.1; Isolated.create_api builds others (1.8.1)
       extend Forwardable
 
       def_delegators :configuration, :provider, :set_provider, :set_provider_and_wait, :hooks, :add_hooks, :evaluation_context
 
-      def configuration
-        @configuration ||= Configuration.new
+      attr_reader :configuration
+
+      def initialize
+        @configuration = Configuration.new
       end
 
       def configure(&block)
@@ -48,7 +50,7 @@ module OpenFeature
       end
 
       def build_client(domain: nil, evaluation_context: nil)
-        Client.new(domain:, evaluation_context:)
+        Client.new(domain:, evaluation_context:, configuration:)
       end
 
       def provider_metadata(domain: nil)

data/lib/open_feature/sdk/client.rb

@@ -21,8 +21,9 @@ module OpenFeature
 
       attr_accessor :hooks, :evaluation_context
 
-      def initialize(provider: nil, domain: nil, evaluation_context: nil)
+      def initialize(provider: nil, domain: nil, evaluation_context: nil, configuration: API.instance.configuration)
         @provider = provider
+        @configuration = configuration
         @metadata = ClientMetadata.new(domain:)
         @evaluation_context = evaluation_context
         @hooks = []
@@ -33,17 +34,17 @@ module OpenFeature
       end
 
       def provider_status
-        OpenFeature::SDK.configuration.provider_state(resolve_provider)
+        @configuration.provider_state(resolve_provider)
       end
 
       def add_handler(event_type, handler = nil, &block)
         actual_handler = handler || block
-        OpenFeature::SDK.configuration.add_client_handler(self, event_type, actual_handler)
+        @configuration.add_client_handler(self, event_type, actual_handler)
       end
 
       def remove_handler(event_type, handler = nil, &block)
         actual_handler = handler || block
-        OpenFeature::SDK.configuration.remove_client_handler(self, event_type, actual_handler)
+        @configuration.remove_client_handler(self, event_type, actual_handler)
       end
 
       # Tracking API (spec 6.1.1.1) — dynamic-context paradigm
@@ -81,13 +82,13 @@ module OpenFeature
 
         # Assemble ordered hooks: API → Client → Invocation → Provider (spec 4.4.2)
         provider_hooks = provider.respond_to?(:hooks) ? Array(provider.hooks) : []
-        ordered_hooks = [*OpenFeature::SDK.hooks, *@hooks, *invocation_hooks, *provider_hooks]
+        ordered_hooks = [*@configuration.hooks, *@hooks, *invocation_hooks, *provider_hooks]
 
         # Short-circuit NOT_READY/FATAL providers (required by evaluation_v2.feature). A provider resolved from the
         # configuration is tracked while bound, so one that isn't was replaced mid-call and reads NOT_READY.
         short_circuit_code = nil
-        if @provider ? OpenFeature::SDK.configuration.provider_tracked?(provider) : !provider.equal?(@fallback_provider)
-          short_circuit_code = short_circuit_error_code(OpenFeature::SDK.configuration.provider_state(provider))
+        if @provider ? @configuration.provider_tracked?(provider) : !provider.equal?(@fallback_provider)
+          short_circuit_code = short_circuit_error_code(@configuration.provider_state(provider))
         end
 
         # Fast path: skip hook ceremony when no hooks are registered
@@ -121,7 +122,7 @@ module OpenFeature
           EMPTY_HINTS
         end
 
-        executor = Hooks::HookExecutor.new(logger: OpenFeature::SDK.configuration.logger)
+        executor = Hooks::HookExecutor.new(logger: @configuration.logger)
 
         if short_circuit_code
           resolution = Provider::ResolutionDetails.new(
@@ -133,7 +134,7 @@ module OpenFeature
           executor.run_short_circuit(ordered_hooks: ordered_hooks, hook_context: hook_context, hints: hints, evaluation_details: evaluation_details)
           evaluation_details
         else
-          executor.execute(ordered_hooks: ordered_hooks, hook_context: hook_context, hints: hints) do |hctx|
+          executor.execute(ordered_hooks: ordered_hooks, hook_context: hook_context, hints: hints, default_value:) do |hctx|
             evaluate_flag(provider: provider, type: type, flag_key: flag_key, default_value: default_value, evaluation_context: hctx.evaluation_context)
           end
         end
@@ -156,11 +157,16 @@ module OpenFeature
           evaluation_context: evaluation_context
         )
 
-        if resolution_details.error_code || TYPE_CLASS_MAP[type].none? { |klass| resolution_details.value.is_a?(klass) }
-          resolution_details.value = default_value
-          resolution_details.error_code ||= Provider::ErrorCode::TYPE_MISMATCH
-          resolution_details.reason = Provider::Reason::ERROR
-          resolution_details.variant = nil
+        provider_error = resolution_details.error_code
+        if provider_error || TYPE_CLASS_MAP[type].none? { |klass| resolution_details.value.is_a?(klass) }
+          # A new struct, since a provider may cache and reuse the one it returned
+          resolution_details = Provider::ResolutionDetails.new(
+            value: default_value,
+            reason: Provider::Reason::ERROR,
+            error_code: provider_error || Provider::ErrorCode::TYPE_MISMATCH,
+            error_message: provider_error ? resolution_details.error_message : "Expected #{type}, got #{resolution_details.value.class}",
+            flag_metadata: resolution_details.flag_metadata
+          )
         end
 
         EvaluationDetails.new(flag_key: flag_key, resolution_details: resolution_details)
@@ -169,7 +175,7 @@ module OpenFeature
       # Callers resolve once per operation, so a rebinding mid-evaluation can't mix two providers.
       # The fallback NoOp is never registered: untracked, so not short-circuited, and its status reads NOT_READY.
       def resolve_provider
-        @provider || OpenFeature::SDK.configuration.provider(domain: @metadata.domain) || (@fallback_provider ||= Provider::NoOpProvider.new)
+        @provider || @configuration.provider(domain: @metadata.domain) || (@fallback_provider ||= Provider::NoOpProvider.new)
       end
 
       def short_circuit_error_code(state)
@@ -180,11 +186,11 @@ module OpenFeature
       end
 
       def build_evaluation_context(invocation_context)
-        propagator = OpenFeature::SDK.configuration.transaction_context_propagator
+        propagator = @configuration.transaction_context_propagator
         transaction_context = propagator&.get_transaction_context
 
         EvaluationContextBuilder.new.call(
-          api_context: OpenFeature::SDK.evaluation_context,
+          api_context: @configuration.evaluation_context,
           transaction_context: transaction_context,
           client_context: evaluation_context,
           invocation_context: invocation_context

data/lib/open_feature/sdk/client_metadata.rb

@@ -4,6 +4,11 @@ module OpenFeature
   module SDK
     ClientMetadata = Struct.new(:domain, keyword_init: true) do
       alias_method :name, :domain
+
+      def initialize(domain: nil)
+        super(domain: domain&.dup&.freeze)
+        freeze
+      end
     end
   end
 end

data/lib/open_feature/sdk/configuration.rb

@@ -162,9 +162,10 @@ module OpenFeature
           needs_init = attempt.nil? || attempt.state == :failed
 
           if needs_init
+            # First, so a provider registered with another API (1.8.4) leaves no state behind
+            provider.send(:attach, self) if provider.is_a?(Provider::EventEmitter)
             attempt = @init_attempts[provider] = InitAttempt.new(:running, nil, Thread::Queue.new)
             @provider_state_registry.set_initial_state(provider)
-            provider.send(:attach, self) if provider.is_a?(Provider::EventEmitter)
           end
 
           # Publish last: clients read @providers without the lock, and must not see an untracked provider
@@ -219,7 +220,7 @@ module OpenFeature
         end
       ensure
         # Fail an attempt no init took over (e.g. a Timeout hit first), or it would stay running forever
-        finish_init_attempt(attempt, :failed) if needs_init && !init_thread
+        finish_init_attempt(attempt, :failed) if needs_init && attempt && !init_thread
       end
 
       def init_provider(provider, context, domain:, attempt:, raise_on_error: false)

data/lib/open_feature/sdk/evaluation_context.rb

@@ -26,6 +26,16 @@ module OpenFeature
         )
       end
 
+      def initialize_copy(source)
+        super
+        @fields = @fields.dup
+      end
+
+      def freeze
+        fields.freeze
+        super
+      end
+
       def ==(other)
         fields == other.fields
       end

data/lib/open_feature/sdk/hooks/frozen_copy.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module OpenFeature
+  module SDK
+    module Hooks
+      # A deep-frozen copy of a hook input, so hooks can't change it and the caller's object isn't frozen (spec 4.1.3, 4.2.2)
+      def self.frozen_copy(value)
+        Ractor.make_shareable(value, copy: true)
+      rescue
+        value.dup.freeze # shortcut: when something inside can't be copied (a Mutex, Queue or Proc), only the top level is frozen
+      end
+    end
+  end
+end

data/lib/open_feature/sdk/hooks/hints.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "delegate"
+require_relative "frozen_copy"
 
 module OpenFeature
   module SDK
@@ -13,8 +14,7 @@ module OpenFeature
             assert_allowed_key(key)
             assert_allowed_value(value)
           end
-          @hash = hash.dup
-          super(@hash)
+          super(Hooks.frozen_copy(hash))
           freeze
         end
 

data/lib/open_feature/sdk/hooks/hook_context.rb

@@ -1,28 +1,45 @@
 # frozen_string_literal: true
 
+require_relative "frozen_copy"
+
 module OpenFeature
   module SDK
     module Hooks
       # Provides context to hook stages during flag evaluation.
       #
-      # Per spec 4.1.1-4.1.5:
+      # Per spec 4.1.1-4.1.5 and 4.2.2:
       # - flag_key, flag_value_type, default_value are immutable (4.1.3)
-      # - client_metadata, provider_metadata are optional (4.1.2)
-      # - evaluation_context is mutable (for before hooks to modify, 4.1.4.1)
+      # - client_metadata, provider_metadata are optional (4.1.2) and immutable (4.2.2.2, 4.2.2.3)
+      # - evaluation_context is mutable only in before hooks; HookExecutor freezes the hook context after them (4.1.4.1)
       class HookContext
-        attr_reader :flag_key, :flag_value_type, :default_value,
-          :client_metadata, :provider_metadata
+        attr_reader :flag_key, :flag_value_type, :client_metadata, :provider_metadata
         attr_accessor :evaluation_context
 
         def initialize(flag_key:, flag_value_type:, default_value:, evaluation_context:,
           client_metadata: nil, provider_metadata: nil)
-          @flag_key = flag_key.freeze
+          @flag_key = Hooks.frozen_copy(flag_key)
           @flag_value_type = flag_value_type.freeze
-          @default_value = default_value.freeze
+          @source_default_value = default_value
           @evaluation_context = evaluation_context
           @client_metadata = client_metadata
-          @provider_metadata = provider_metadata
+          @provider_metadata = Hooks.frozen_copy(provider_metadata)
           @hook_data = {}
+          @copies = {}
+        end
+
+        # Copied on first read: most hooks never read it, and the copy grows with the value
+        def default_value
+          @copies.fetch(:default_value) { @copies[:default_value] = Hooks.frozen_copy(@source_default_value) }
+        end
+
+        # Swaps in a frozen copy of the evaluation context, so neither the caller's nor a before hook's object is frozen.
+        # Top-level strings are copied too, so a hook can't edit a targeting key in place.
+        def freeze
+          return self if frozen?
+          @evaluation_context &&= @evaluation_context.dup.tap do |copy|
+            copy.fields.transform_values! { |value| (value.is_a?(String) && !value.frozen?) ? value.dup.freeze : value }
+          end.freeze
+          super
         end
 
         # Returns a mutable hash scoped to the given hook instance.

data/lib/open_feature/sdk/hooks/hook_executor.rb

@@ -13,6 +13,9 @@ module OpenFeature
       #   - Before/after hook error → stop remaining hooks, run error hooks, return default
       #   - Error hook error → log, continue remaining error hooks
       #   - Finally hook error → log, continue remaining finally hooks
+      #
+      # The hook context is frozen before after, error and finally hooks run, so only before hooks
+      # can change the evaluation context (spec 4.1.4.1). Not earlier: some providers write to it.
       class HookExecutor
         def initialize(logger: nil)
           @logger = logger
@@ -37,9 +40,10 @@ module OpenFeature
         # @param ordered_hooks [Array] hooks in before-order (API, Client, Invocation, Provider)
         # @param hook_context [HookContext] the hook context
         # @param hints [Hints] hook hints
+        # @param default_value [Object] returned if evaluation raises; the caller's own object, not the hooks' frozen copy
         # @param evaluate_block [Proc] the flag evaluation to wrap
         # @return [EvaluationDetails] the evaluation result
-        def execute(ordered_hooks:, hook_context:, hints:, &evaluate_block)
+        def execute(ordered_hooks:, hook_context:, hints:, default_value:, &evaluate_block)
           evaluation_details = nil
 
           begin
@@ -60,7 +64,7 @@ module OpenFeature
             evaluation_details = EvaluationDetails.new(
               flag_key: hook_context.flag_key,
               resolution_details: Provider::ResolutionDetails.new(
-                value: hook_context.default_value,
+                value: default_value,
                 error_code: EvaluationError.code_for(e),
                 reason: Provider::Reason::ERROR,
                 error_message: e.message
@@ -91,6 +95,7 @@ module OpenFeature
 
         # Spec 4.4.2: After hooks run in reverse order: Provider → Invocation → Client → API
         def run_after_hooks(hooks, hook_context, evaluation_details, hints)
+          hook_context.freeze
           hooks.reverse_each do |hook|
             next unless hook.respond_to?(:after)
             hook.after(hook_context: hook_context, evaluation_details: evaluation_details, hints: hints)
@@ -100,6 +105,7 @@ module OpenFeature
         # Spec 4.4.4: Error hooks run in reverse order.
         # If an error hook itself errors, log and continue remaining error hooks.
         def run_error_hooks(hooks, hook_context, exception, hints)
+          hook_context.freeze
           hooks.reverse_each do |hook|
             next unless hook.respond_to?(:error)
             hook.error(hook_context: hook_context, exception: exception, hints: hints)
@@ -111,6 +117,7 @@ module OpenFeature
         # Spec 4.4.3: Finally hooks run in reverse order unconditionally.
         # If a finally hook errors, log and continue remaining finally hooks.
         def run_finally_hooks(hooks, hook_context, evaluation_details, hints)
+          hook_context.freeze
           hooks.reverse_each do |hook|
             next unless hook.respond_to?(:finally)
             hook.finally(hook_context: hook_context, evaluation_details: evaluation_details, hints: hints)

data/lib/open_feature/sdk/isolated.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative "../sdk"
+
+module OpenFeature
+  module SDK
+    # Spec 1.8.3: a separate require, so isolated instances are an explicit opt-in
+    module Isolated
+      # Spec 1.8.1: a new API that shares no state with the global one or other isolated APIs
+      def self.create_api
+        API.send(:new)
+      end
+    end
+  end
+end

data/lib/open_feature/sdk/provider/event_emitter.rb

@@ -8,7 +8,7 @@ module OpenFeature
       # Mixin for providers that emit lifecycle events
       module EventEmitter
         def emit_event(event_type, details = {})
-          config = @configuration
+          config = @openfeature_configuration
           return unless config
 
           unless ::OpenFeature::SDK::ProviderEvent::ALL_EVENTS.include?(event_type)
@@ -19,17 +19,22 @@ module OpenFeature
         end
 
         def configuration_attached?
-          !@configuration.nil?
+          !@openfeature_configuration.nil?
         end
 
         private
 
         def attach(configuration)
-          @configuration = configuration
+          # Spec 1.8.4: only providers using this mixin know which API they're registered with
+          if @openfeature_configuration && !@openfeature_configuration.equal?(configuration)
+            raise ArgumentError, "Provider is already registered with another OpenFeature API instance"
+          end
+
+          @openfeature_configuration = configuration
         end
 
         def detach
-          @configuration = nil
+          @openfeature_configuration = nil
         end
       end
     end

data/lib/open_feature/sdk/provider/no_op_provider.rb

@@ -23,7 +23,7 @@ module OpenFeature
       # * <tt>fetch_object_value</tt> - Retrieve feature flag object value
       #
       class NoOpProvider
-        REASON_NO_OP = "No-op"
+        REASON_NO_OP = Reason::DEFAULT
         NAME = "No-op Provider"
 
         attr_reader :metadata

data/lib/open_feature/sdk/provider_initialization_error.rb

@@ -21,8 +21,8 @@ module OpenFeature
       # @param message [String] the error message
       # @param provider [Object] the provider that failed to initialize
       # @param original_error [Exception] the original error that caused the failure
-      # @param error_code [String] the OpenFeature error code (defaults to PROVIDER_FATAL)
-      def initialize(message, provider: nil, original_error: nil, error_code: Provider::ErrorCode::PROVIDER_FATAL)
+      # @param error_code [String] the OpenFeature error code (defaults to GENERAL)
+      def initialize(message, provider: nil, original_error: nil, error_code: Provider::ErrorCode::GENERAL)
         super(message)
         @provider = provider
         @original_error = original_error

data/lib/open_feature/sdk/provider_state_registry.rb

@@ -9,7 +9,7 @@ module OpenFeature
     # Tracks provider states
     class ProviderStateRegistry
       def initialize
-        @states = {}
+        @states = {}.compare_by_identity
         @mutex = Mutex.new
       end
 
@@ -17,7 +17,7 @@ module OpenFeature
         return unless provider
 
         @mutex.synchronize do
-          @states[provider.object_id] = {state: state, details: {}}
+          @states[provider] = {state: state, details: {}}
         end
       end
 
@@ -29,7 +29,7 @@ module OpenFeature
         # Only update state if the event should cause a state change
         if new_state
           @mutex.synchronize do
-            @states[provider.object_id] = {state: new_state, details: event_details || {}}
+            @states[provider] = {state: new_state, details: event_details || {}}
           end
           new_state
         else
@@ -42,7 +42,7 @@ module OpenFeature
         return ProviderState::NOT_READY unless provider
 
         @mutex.synchronize do
-          entry = @states[provider.object_id]
+          entry = @states[provider]
           entry ? entry[:state] : ProviderState::NOT_READY
         end
       end
@@ -51,7 +51,7 @@ module OpenFeature
         return {} unless provider
 
         @mutex.synchronize do
-          entry = @states[provider.object_id]
+          entry = @states[provider]
           entry ? entry[:details] : {}
         end
       end
@@ -60,7 +60,7 @@ module OpenFeature
         return unless provider
 
         @mutex.synchronize do
-          @states.delete(provider.object_id)
+          @states.delete(provider)
         end
       end
 
@@ -68,7 +68,7 @@ module OpenFeature
         return false unless provider
 
         @mutex.synchronize do
-          @states.key?(provider.object_id)
+          @states.key?(provider)
         end
       end
 

data/lib/open_feature/sdk/thread_local_transaction_context_propagator.rb

@@ -5,14 +5,19 @@ module OpenFeature
     class ThreadLocalTransactionContextPropagator
       include TransactionContextPropagator
 
+      # One context per propagator under this key, so separate APIs never share one (spec 1.8.2)
+      # while resetting the key still clears them all. Weak keys let discarded propagators be collected.
       THREAD_KEY = :openfeature_transaction_context
 
       def set_transaction_context(evaluation_context)
-        Thread.current[THREAD_KEY] = evaluation_context
+        contexts = Thread.current[THREAD_KEY]
+        contexts = Thread.current[THREAD_KEY] = ObjectSpace::WeakKeyMap.new unless contexts.is_a?(ObjectSpace::WeakKeyMap)
+        evaluation_context.nil? ? contexts.delete(self) : contexts[self] = evaluation_context
       end
 
       def get_transaction_context
-        Thread.current[THREAD_KEY]
+        contexts = Thread.current[THREAD_KEY]
+        contexts[self] if contexts.is_a?(ObjectSpace::WeakKeyMap)
       end
     end
   end

data/lib/open_feature/sdk/version.rb

@@ -2,6 +2,6 @@
 
 module OpenFeature
   module SDK
-    VERSION = "0.7.0"
+    VERSION = "0.8.0"
   end
 end

data/sig/open_feature/sdk/api.rbs

@@ -1,10 +1,13 @@
 module OpenFeature
   module SDK
     class API
-      include Singleton
       extend Forwardable
 
-      def configuration: () -> Configuration
+      include Singleton
+
+      attr_reader configuration: Configuration
+
+      def initialize: () -> void
 
       def configure: () { (Configuration) -> void } -> void
 

data/sig/open_feature/sdk/client.rbs

@@ -10,7 +10,7 @@ module OpenFeature
       attr_accessor evaluation_context: EvaluationContext?
       attr_accessor hooks: Array[untyped]
 
-      def initialize: (?provider: untyped, ?domain: String?, ?evaluation_context: EvaluationContext?) -> void
+      def initialize: (?provider: untyped, ?domain: String?, ?evaluation_context: EvaluationContext?, ?configuration: Configuration) -> void
 
       def add_hooks: (*Array[untyped] new_hooks) -> void
 

data/sig/open_feature/sdk/evaluation_context.rbs

@@ -13,6 +13,10 @@ module OpenFeature
 
       def merge: (EvaluationContext overriding_context) -> EvaluationContext
 
+      def initialize_copy: (EvaluationContext source) -> void
+
+      def freeze: () -> self
+
       def ==: (untyped other) -> bool
     end
   end

data/sig/open_feature/sdk/hooks/frozen_copy.rbs

@@ -0,0 +1,7 @@
+module OpenFeature
+  module SDK
+    module Hooks
+      def self.frozen_copy: [T] (T value) -> T
+    end
+  end
+end

data/sig/open_feature/sdk/hooks/hook_context.rbs

@@ -4,13 +4,16 @@ module OpenFeature
       class HookContext
         attr_reader flag_key: String
         attr_reader flag_value_type: Symbol
-        attr_reader default_value: untyped
         attr_reader client_metadata: ClientMetadata?
         attr_reader provider_metadata: Provider::ProviderMetadata?
         attr_accessor evaluation_context: EvaluationContext?
 
         def initialize: (flag_key: String, flag_value_type: Symbol, default_value: untyped, evaluation_context: EvaluationContext?, ?client_metadata: ClientMetadata?, ?provider_metadata: Provider::ProviderMetadata?) -> void
 
+        def default_value: () -> untyped
+
+        def freeze: () -> self
+
         def hook_data_for: (untyped hook) -> Hash[untyped, untyped]
       end
     end

data/sig/open_feature/sdk/hooks/hook_executor.rbs

@@ -6,7 +6,7 @@ module OpenFeature
 
         def run_short_circuit: (ordered_hooks: Array[untyped], hook_context: HookContext, hints: Hints, evaluation_details: EvaluationDetails) -> void
 
-        def execute: (ordered_hooks: Array[untyped], hook_context: HookContext, hints: Hints) { (HookContext) -> EvaluationDetails } -> EvaluationDetails?
+        def execute: (ordered_hooks: Array[untyped], hook_context: HookContext, hints: Hints, default_value: untyped) { (HookContext) -> EvaluationDetails } -> EvaluationDetails?
 
         private
 

data/sig/open_feature/sdk/isolated.rbs

@@ -0,0 +1,7 @@
+module OpenFeature
+  module SDK
+    module Isolated
+      def self.create_api: () -> API
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openfeature-sdk
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - OpenFeature Authors
@@ -50,11 +50,13 @@ files:
 - lib/open_feature/sdk/evaluation_error.rb
 - lib/open_feature/sdk/event_dispatcher.rb
 - lib/open_feature/sdk/hooks.rb
+- lib/open_feature/sdk/hooks/frozen_copy.rb
 - lib/open_feature/sdk/hooks/hints.rb
 - lib/open_feature/sdk/hooks/hook.rb
 - lib/open_feature/sdk/hooks/hook_context.rb
 - lib/open_feature/sdk/hooks/hook_executor.rb
 - lib/open_feature/sdk/hooks/logging_hook.rb
+- lib/open_feature/sdk/isolated.rb
 - lib/open_feature/sdk/provider.rb
 - lib/open_feature/sdk/provider/error_code.rb
 - lib/open_feature/sdk/provider/event_emitter.rb
@@ -87,11 +89,13 @@ files:
 - sig/open_feature/sdk/evaluation_details.rbs
 - sig/open_feature/sdk/evaluation_error.rbs
 - sig/open_feature/sdk/event_dispatcher.rbs
+- sig/open_feature/sdk/hooks/frozen_copy.rbs
 - sig/open_feature/sdk/hooks/hints.rbs
 - sig/open_feature/sdk/hooks/hook.rbs
 - sig/open_feature/sdk/hooks/hook_context.rbs
 - sig/open_feature/sdk/hooks/hook_executor.rbs
 - sig/open_feature/sdk/hooks/logging_hook.rbs
+- sig/open_feature/sdk/isolated.rbs
 - sig/open_feature/sdk/provider.rbs
 - sig/open_feature/sdk/provider/error_code.rbs
 - sig/open_feature/sdk/provider/event_emitter.rbs