openfeature-sdk 0.6.4 → 0.6.6

data/renovate.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://docs.renovatebot.com/renovate-schema.json",
   "extends": [
-    "config:recommended",
+    "github>open-feature/community-tooling",
     ":automergeStableNonMajor",
     "security:minimumReleaseAgeNpm"
   ],

data/sig/open_feature/sdk/api.rbs

@@ -0,0 +1,35 @@
+module OpenFeature
+  module SDK
+    class API
+      include Singleton
+      extend Forwardable
+
+      def configuration: () -> Configuration
+
+      def configure: () { (Configuration) -> void } -> void
+
+      def build_client: (?domain: String?, ?evaluation_context: EvaluationContext?) -> Client
+
+      def provider_metadata: (?domain: String?) -> Provider::ProviderMetadata?
+
+      # Delegated from Configuration
+      def provider: (?domain: String?) -> untyped?
+      def set_provider: (untyped provider, ?domain: String?) -> void
+      def set_provider_and_wait: (untyped provider, ?domain: String?) -> void
+      def hooks: () -> Array[untyped]
+      def add_hooks: (*Array[untyped] new_hooks) -> void
+      def evaluation_context: () -> EvaluationContext?
+
+      def add_handler: (String event_type, _ToProc handler) -> void
+      def remove_handler: (String event_type, _ToProc handler) -> void
+
+      def logger: () -> untyped?
+      def logger=: (untyped? new_logger) -> void
+
+      def set_transaction_context_propagator: (_TransactionContextPropagator propagator) -> void
+      def set_transaction_context: (EvaluationContext evaluation_context) -> void
+
+      def shutdown: () -> void
+    end
+  end
+end

data/sig/open_feature/sdk/client.rbs

@@ -0,0 +1,49 @@
+module OpenFeature
+  module SDK
+    class Client
+      TYPE_CLASS_MAP: Hash[Symbol, Array[Class]]
+      RESULT_TYPE: Array[Symbol]
+      SUFFIXES: Array[Symbol]
+      EMPTY_HINTS: Hooks::Hints
+
+      attr_reader metadata: ClientMetadata
+      attr_reader evaluation_context: EvaluationContext?
+      attr_accessor hooks: Array[untyped]
+
+      def initialize: (provider: untyped, ?domain: String?, ?evaluation_context: EvaluationContext?) -> void
+
+      def add_hooks: (*Array[untyped] new_hooks) -> void
+
+      def provider_status: () -> String
+
+      def add_handler: (String event_type, ?_ToProc? handler) ?{ (Hash[Symbol, untyped]) -> void } -> void
+      def remove_handler: (String event_type, ?_ToProc? handler) ?{ (Hash[Symbol, untyped]) -> void } -> void
+
+      def track: (String tracking_event_name, ?evaluation_context: EvaluationContext?, ?tracking_event_details: TrackingEventDetails?) -> void
+
+      # Dynamically generated fetch_*_value methods (6 types)
+      def fetch_boolean_value: (flag_key: String, default_value: bool, ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> bool
+      def fetch_string_value: (flag_key: String, default_value: String, ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> String
+      def fetch_number_value: (flag_key: String, default_value: Numeric, ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> Numeric
+      def fetch_integer_value: (flag_key: String, default_value: Integer, ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> Integer
+      def fetch_float_value: (flag_key: String, default_value: Float, ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> Float
+      def fetch_object_value: (flag_key: String, default_value: Array[untyped] | Hash[untyped, untyped], ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> (Array[untyped] | Hash[untyped, untyped])
+
+      # Dynamically generated fetch_*_details methods (6 types)
+      def fetch_boolean_details: (flag_key: String, default_value: bool, ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> EvaluationDetails
+      def fetch_string_details: (flag_key: String, default_value: String, ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> EvaluationDetails
+      def fetch_number_details: (flag_key: String, default_value: Numeric, ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> EvaluationDetails
+      def fetch_integer_details: (flag_key: String, default_value: Integer, ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> EvaluationDetails
+      def fetch_float_details: (flag_key: String, default_value: Float, ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> EvaluationDetails
+      def fetch_object_details: (flag_key: String, default_value: Array[untyped] | Hash[untyped, untyped], ?evaluation_context: EvaluationContext?, ?hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> EvaluationDetails
+
+      private
+
+      def fetch_details: (type: Symbol, flag_key: String, default_value: untyped, ?evaluation_context: EvaluationContext?, ?invocation_hooks: Array[untyped], ?hook_hints: Hooks::Hints?) -> EvaluationDetails?
+      def evaluate_flag: (type: Symbol, flag_key: String, default_value: untyped, evaluation_context: EvaluationContext?) -> EvaluationDetails
+      def short_circuit_error_code: (String state) -> String?
+      def build_evaluation_context: (EvaluationContext? invocation_context) -> EvaluationContext?
+      def validate_default_value_type: (Symbol type, untyped default_value) -> void
+    end
+  end
+end

data/sig/open_feature/sdk/client_metadata.rbs

@@ -0,0 +1,11 @@
+module OpenFeature
+  module SDK
+    class ClientMetadata < Struct[untyped]
+      attr_accessor domain: String?
+
+      def initialize: (?domain: String?) -> void
+
+      alias name domain
+    end
+  end
+end

data/sig/open_feature/sdk/configuration.rbs

@@ -0,0 +1,44 @@
+module OpenFeature
+  module SDK
+    class Configuration
+      extend Forwardable
+
+      attr_accessor evaluation_context: EvaluationContext?
+      attr_accessor hooks: Array[untyped]
+      attr_accessor transaction_context_propagator: _TransactionContextPropagator?
+      attr_reader logger: untyped?
+
+      def initialize: () -> void
+
+      def add_hooks: (*Array[untyped] new_hooks) -> void
+      def provider: (?domain: String?) -> untyped?
+      def logger=: (untyped? new_logger) -> void
+
+      def add_handler: (String event_type, _ToProc handler) -> void
+      def remove_handler: (String event_type, _ToProc handler) -> void
+
+      def add_client_handler: (Client client, String event_type, _ToProc handler) -> void
+      def remove_client_handler: (Client client, String event_type, _ToProc handler) -> void
+
+      def set_provider: (untyped provider, ?domain: String?) -> void
+      def set_provider_and_wait: (untyped provider, ?domain: String?) -> void
+
+      def provider_state: (untyped provider) -> String
+      def provider_tracked?: (untyped provider) -> bool
+
+      def shutdown: () -> void
+
+      private
+
+      def reset: () -> void
+      def set_provider_internal: (untyped provider, domain: String?, wait_for_init: bool) -> void
+      def init_provider: (untyped provider, EvaluationContext? context, ?raise_on_error: bool) -> void
+      def dispatch_provider_event: (untyped provider, String event_type, ?Hash[Symbol, untyped] details) -> void
+      def provider_bound?: (untyped provider) -> bool
+      def extract_provider_name: (untyped provider) -> String
+      def run_handlers_for_provider: (untyped provider, String event_type, Hash[Symbol, untyped] event_details) -> void
+      def run_immediate_handler: (String event_type, _ToProc handler, Client? client) -> void
+      def build_event_details: (untyped provider) -> Hash[Symbol, untyped]
+    end
+  end
+end

data/sig/open_feature/sdk/evaluation_context.rbs

@@ -0,0 +1,19 @@
+module OpenFeature
+  module SDK
+    class EvaluationContext
+      TARGETING_KEY: String
+
+      attr_reader fields: Hash[String, untyped]
+
+      def initialize: (**untyped fields) -> void
+
+      def targeting_key: () -> untyped
+
+      def field: (String key) -> untyped
+
+      def merge: (EvaluationContext overriding_context) -> EvaluationContext
+
+      def ==: (untyped other) -> bool
+    end
+  end
+end

data/sig/open_feature/sdk/evaluation_context_builder.rbs

@@ -0,0 +1,7 @@
+module OpenFeature
+  module SDK
+    class EvaluationContextBuilder
+      def call: (api_context: EvaluationContext?, client_context: EvaluationContext?, invocation_context: EvaluationContext?, ?transaction_context: EvaluationContext?) -> EvaluationContext?
+    end
+  end
+end

data/sig/open_feature/sdk/evaluation_details.rbs

@@ -0,0 +1,19 @@
+module OpenFeature
+  module SDK
+    class EvaluationDetails < Struct[untyped]
+      extend Forwardable
+
+      attr_accessor flag_key: String
+      attr_accessor resolution_details: Provider::ResolutionDetails
+
+      def initialize: (?flag_key: String, ?resolution_details: Provider::ResolutionDetails) -> void
+
+      def value: () -> untyped
+      def reason: () -> String?
+      def variant: () -> String?
+      def error_code: () -> String?
+      def error_message: () -> String?
+      def flag_metadata: () -> Hash[String, untyped]
+    end
+  end
+end

data/sig/open_feature/sdk/evaluation_error.rbs

@@ -0,0 +1,11 @@
+module OpenFeature
+  module SDK
+    class EvaluationError < StandardError
+      attr_reader error_code: String
+
+      def initialize: (?String? message, ?error_code: String) -> void
+
+      def self.code_for: (Exception exception) -> String
+    end
+  end
+end

data/sig/open_feature/sdk/event_dispatcher.rbs

@@ -0,0 +1,24 @@
+module OpenFeature
+  module SDK
+    class EventDispatcher
+      attr_writer logger: untyped?
+
+      def initialize: (?untyped? logger) -> void
+
+      def add_handler: (String event_type, _ToProc handler) -> void
+      def remove_handler: (String event_type, _ToProc handler) -> void
+      def remove_all_handlers: (String event_type) -> void
+      def trigger_event: (String event_type, ?Hash[Symbol, untyped] event_details) -> void
+      def handler_count: (String event_type) -> Integer
+      def clear_all_handlers: () -> void
+
+      private
+
+      def valid_event?: (String event_type) -> bool
+    end
+
+    interface _ToProc
+      def call: (Hash[Symbol, untyped]) -> void
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+module OpenFeature
+  module SDK
+    module Hooks
+      class Hints
+        ALLOWED_TYPES: Array[Class]
+
+        def initialize: (?Hash[String | Symbol, untyped] hash) -> void
+
+        def []: (String | Symbol key) -> untyped
+        def fetch: (String | Symbol key, ?untyped default) -> untyped
+               | (String | Symbol key) { (String | Symbol) -> untyped } -> untyped
+        def key?: (String | Symbol key) -> bool
+        def each: () { (String | Symbol, untyped) -> void } -> Hash[String | Symbol, untyped]
+                | () -> Enumerator[[String | Symbol, untyped], Hash[String | Symbol, untyped]]
+        def size: () -> Integer
+        def empty?: () -> bool
+        def keys: () -> Array[String | Symbol]
+        def values: () -> Array[untyped]
+        def freeze: () -> self
+        def frozen?: () -> bool
+        def to_hash: () -> Hash[String | Symbol, untyped]
+
+        private
+
+        def assert_allowed_key: (untyped key) -> void
+        def assert_allowed_value: (untyped value) -> void
+      end
+    end
+  end
+end

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

@@ -0,0 +1,19 @@
+module OpenFeature
+  module SDK
+    module Hooks
+      interface _Hook
+        def before: (hook_context: HookContext, hints: Hints) -> EvaluationContext?
+        def after: (hook_context: HookContext, evaluation_details: EvaluationDetails, hints: Hints) -> void
+        def error: (hook_context: HookContext, exception: Exception, hints: Hints) -> void
+        def finally: (hook_context: HookContext, evaluation_details: EvaluationDetails?, hints: Hints) -> void
+      end
+
+      module Hook
+        def before: (hook_context: HookContext, hints: Hints) -> EvaluationContext?
+        def after: (hook_context: HookContext, evaluation_details: EvaluationDetails, hints: Hints) -> nil
+        def error: (hook_context: HookContext, exception: Exception, hints: Hints) -> nil
+        def finally: (hook_context: HookContext, evaluation_details: EvaluationDetails?, hints: Hints) -> nil
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+module OpenFeature
+  module SDK
+    module Hooks
+      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 hook_data_for: (untyped hook) -> Hash[untyped, untyped]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,20 @@
+module OpenFeature
+  module SDK
+    module Hooks
+      class HookExecutor
+        def initialize: (?logger: untyped?) -> void
+
+        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?
+
+        private
+
+        def run_before_hooks: (Array[untyped] hooks, HookContext hook_context, Hints hints) -> void
+        def run_after_hooks: (Array[untyped] hooks, HookContext hook_context, EvaluationDetails evaluation_details, Hints hints) -> void
+        def run_error_hooks: (Array[untyped] hooks, HookContext hook_context, Exception exception, Hints hints) -> void
+        def run_finally_hooks: (Array[untyped] hooks, HookContext hook_context, EvaluationDetails? evaluation_details, Hints hints) -> void
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+module OpenFeature
+  module SDK
+    module Hooks
+      class LoggingHook
+        include Hook
+
+        def initialize: (?logger: untyped?, ?include_evaluation_context: bool) -> void
+
+        def before: (hook_context: HookContext, hints: Hints) -> nil
+        def after: (hook_context: HookContext, evaluation_details: EvaluationDetails, hints: Hints) -> nil
+        def error: (hook_context: HookContext, exception: Exception, hints: Hints) -> nil
+
+        private
+
+        def logger: () -> untyped?
+        def build_before_message: (HookContext hook_context) -> String
+        def build_after_message: (HookContext hook_context, EvaluationDetails evaluation_details) -> String
+        def build_error_message: (HookContext hook_context, Exception exception) -> String
+        def base_parts: (String stage, HookContext hook_context) -> Array[String]
+        def format_context: (EvaluationContext? evaluation_context) -> String
+        def sanitize: (untyped value) -> String
+      end
+    end
+  end
+end

data/sig/open_feature/sdk/provider/error_code.rbs

@@ -0,0 +1,16 @@
+module OpenFeature
+  module SDK
+    module Provider
+      module ErrorCode
+        PROVIDER_NOT_READY: String
+        FLAG_NOT_FOUND: String
+        PARSE_ERROR: String
+        TYPE_MISMATCH: String
+        TARGETING_KEY_MISSING: String
+        INVALID_CONTEXT: String
+        PROVIDER_FATAL: String
+        GENERAL: String
+      end
+    end
+  end
+end

data/sig/open_feature/sdk/provider/event_emitter.rbs

@@ -0,0 +1,16 @@
+module OpenFeature
+  module SDK
+    module Provider
+      module EventEmitter
+        def emit_event: (String event_type, ?Hash[Symbol, untyped] details) -> void
+
+        def configuration_attached?: () -> bool
+
+        private
+
+        def attach: (Configuration configuration) -> void
+        def detach: () -> void
+      end
+    end
+  end
+end

data/sig/open_feature/sdk/provider/in_memory_provider.rbs

@@ -0,0 +1,46 @@
+module OpenFeature
+  module SDK
+    module Provider
+      class InMemoryProvider
+        include Provider::EventEmitter
+
+        NAME: String
+
+        class Flag < Struct[untyped]
+          attr_accessor variants: Hash[String, untyped]?
+          attr_accessor default_variant: String?
+          attr_accessor context_evaluator: (^(EvaluationContext?) -> String?)?
+          attr_accessor flag_metadata: Hash[String, untyped]?
+          attr_accessor disabled: bool?
+
+          def initialize: (?variants: Hash[String, untyped]?, ?default_variant: String?, ?context_evaluator: (^(EvaluationContext?) -> String?)?, ?flag_metadata: Hash[String, untyped]?, ?disabled: bool?) -> void
+        end
+
+        attr_reader metadata: ProviderMetadata
+
+        def initialize: (?Hash[String, untyped] flags) -> void
+
+        def init: (?EvaluationContext? evaluation_context) -> void
+        def shutdown: () -> void
+
+        def add_flag: (flag_key: String, value: untyped) -> void
+        def update_flags: (Hash[String, untyped] new_flags) -> void
+
+        def fetch_boolean_value: (flag_key: String, default_value: bool, ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+        def fetch_string_value: (flag_key: String, default_value: String, ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+        def fetch_number_value: (flag_key: String, default_value: Numeric, ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+        def fetch_integer_value: (flag_key: String, default_value: Integer, ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+        def fetch_float_value: (flag_key: String, default_value: Float, ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+        def fetch_object_value: (flag_key: String, default_value: Array[untyped] | Hash[untyped, untyped], ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+
+        private
+
+        attr_reader flags: Hash[String, untyped]
+
+        def fetch_value: (flag_key: String, default_value: untyped, evaluation_context: EvaluationContext?) -> ResolutionDetails
+        def resolve_variant_flag: (Flag flag, untyped default_value, EvaluationContext? evaluation_context) -> ResolutionDetails
+        def emit_provider_changed: (Array[String] flag_keys) -> void
+      end
+    end
+  end
+end

data/sig/open_feature/sdk/provider/no_op_provider.rbs

@@ -0,0 +1,25 @@
+module OpenFeature
+  module SDK
+    module Provider
+      class NoOpProvider
+        REASON_NO_OP: String
+        NAME: String
+
+        attr_reader metadata: ProviderMetadata
+
+        def initialize: () -> void
+
+        def fetch_boolean_value: (flag_key: String, default_value: bool, ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+        def fetch_string_value: (flag_key: String, default_value: String, ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+        def fetch_number_value: (flag_key: String, default_value: Numeric, ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+        def fetch_integer_value: (flag_key: String, default_value: Integer, ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+        def fetch_float_value: (flag_key: String, default_value: Float, ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+        def fetch_object_value: (flag_key: String, default_value: Array[untyped] | Hash[untyped, untyped], ?evaluation_context: EvaluationContext?) -> ResolutionDetails
+
+        private
+
+        def no_op: (untyped default_value) -> ResolutionDetails
+      end
+    end
+  end
+end

data/sig/open_feature/sdk/provider/provider_metadata.rbs

@@ -0,0 +1,11 @@
+module OpenFeature
+  module SDK
+    module Provider
+      class ProviderMetadata < Struct[untyped]
+        attr_accessor name: String?
+
+        def initialize: (?name: String?) -> void
+      end
+    end
+  end
+end

data/sig/open_feature/sdk/provider/reason.rbs

@@ -0,0 +1,17 @@
+module OpenFeature
+  module SDK
+    module Provider
+      module Reason
+        STATIC: String
+        DEFAULT: String
+        TARGETING_MATCH: String
+        SPLIT: String
+        CACHED: String
+        DISABLED: String
+        UNKNOWN: String
+        STALE: String
+        ERROR: String
+      end
+    end
+  end
+end

data/sig/open_feature/sdk/provider/resolution_details.rbs

@@ -0,0 +1,19 @@
+module OpenFeature
+  module SDK
+    module Provider
+      EMPTY_FLAG_METADATA: Hash[String, untyped]
+
+      class ResolutionDetails < Struct[untyped]
+        attr_accessor value: untyped
+        attr_accessor reason: String?
+        attr_accessor variant: String?
+        attr_accessor error_code: String?
+        attr_accessor error_message: String?
+
+        def initialize: (?value: untyped, ?reason: String?, ?variant: String?, ?error_code: String?, ?error_message: String?, ?flag_metadata: Hash[String, untyped]?) -> void
+
+        def flag_metadata: () -> Hash[String, untyped]
+      end
+    end
+  end
+end

data/sig/open_feature/sdk/provider.rbs

@@ -0,0 +1,24 @@
+module OpenFeature
+  module SDK
+    module Provider
+      interface _Provider
+        def fetch_boolean_value: (flag_key: String, default_value: bool, ?evaluation_context: EvaluationContext?) -> Provider::ResolutionDetails
+        def fetch_string_value: (flag_key: String, default_value: String, ?evaluation_context: EvaluationContext?) -> Provider::ResolutionDetails
+        def fetch_number_value: (flag_key: String, default_value: Numeric, ?evaluation_context: EvaluationContext?) -> Provider::ResolutionDetails
+        def fetch_integer_value: (flag_key: String, default_value: Integer, ?evaluation_context: EvaluationContext?) -> Provider::ResolutionDetails
+        def fetch_float_value: (flag_key: String, default_value: Float, ?evaluation_context: EvaluationContext?) -> Provider::ResolutionDetails
+        def fetch_object_value: (flag_key: String, default_value: Array[untyped] | Hash[untyped, untyped], ?evaluation_context: EvaluationContext?) -> Provider::ResolutionDetails
+      end
+
+      interface _LifecycleProvider
+        def init: (?EvaluationContext? evaluation_context) -> void
+        def shutdown: () -> void
+        def metadata: () -> ProviderMetadata
+      end
+
+      interface _TrackableProvider
+        def track: (String tracking_event_name, ?evaluation_context: EvaluationContext?, ?tracking_event_details: TrackingEventDetails?) -> void
+      end
+    end
+  end
+end

data/sig/open_feature/sdk/provider_event.rbs

@@ -0,0 +1,14 @@
+module OpenFeature
+  module SDK
+    module ProviderEvent
+      PROVIDER_READY: String
+      PROVIDER_ERROR: String
+      PROVIDER_CONFIGURATION_CHANGED: String
+      PROVIDER_STALE: String
+      PROVIDER_RECONCILING: String
+      PROVIDER_CONTEXT_CHANGED: String
+
+      ALL_EVENTS: Array[String]
+    end
+  end
+end

data/sig/open_feature/sdk/provider_initialization_error.rbs

@@ -0,0 +1,11 @@
+module OpenFeature
+  module SDK
+    class ProviderInitializationError < StandardError
+      attr_reader provider: untyped
+      attr_reader original_error: Exception?
+      attr_reader error_code: String
+
+      def initialize: (String message, ?provider: untyped, ?original_error: Exception?, ?error_code: String) -> void
+    end
+  end
+end

data/sig/open_feature/sdk/provider_state.rbs

@@ -0,0 +1,13 @@
+module OpenFeature
+  module SDK
+    module ProviderState
+      NOT_READY: String
+      READY: String
+      ERROR: String
+      STALE: String
+      FATAL: String
+
+      ALL_STATES: Array[String]
+    end
+  end
+end

data/sig/open_feature/sdk/provider_state_registry.rbs

@@ -0,0 +1,22 @@
+module OpenFeature
+  module SDK
+    class ProviderStateRegistry
+      def initialize: () -> void
+
+      def set_initial_state: (untyped provider, ?String state) -> void
+      def update_state_from_event: (untyped provider, String event_type, ?Hash[Symbol, untyped]? event_details) -> String
+      def get_state: (untyped provider) -> String
+      def get_details: (untyped provider) -> Hash[Symbol, untyped]
+      def remove_provider: (untyped provider) -> void
+      def tracked?: (untyped provider) -> bool
+      def ready?: (untyped provider) -> bool
+      def error?: (untyped provider) -> bool
+      def clear: () -> void
+
+      private
+
+      def state_from_event: (String event_type, ?Hash[Symbol, untyped]? event_details) -> String?
+      def state_from_error_event: (Hash[Symbol, untyped]? event_details) -> String
+    end
+  end
+end

data/sig/open_feature/sdk/telemetry.rbs

@@ -0,0 +1,29 @@
+module OpenFeature
+  module SDK
+    module Telemetry
+      EVENT_NAME: String
+
+      FLAG_KEY: String
+      CONTEXT_ID_KEY: String
+      ERROR_MESSAGE_KEY: String
+      ERROR_TYPE_KEY: String
+      PROVIDER_NAME_KEY: String
+      RESULT_REASON_KEY: String
+      RESULT_VALUE_KEY: String
+      RESULT_VARIANT_KEY: String
+      FLAG_SET_ID_KEY: String
+      VERSION_KEY: String
+
+      METADATA_KEY_MAP: Hash[String, String]
+
+      class EvaluationEvent < Struct[untyped]
+        attr_accessor name: String
+        attr_accessor attributes: Hash[String, untyped]
+
+        def initialize: (?name: String, ?attributes: Hash[String, untyped]) -> void
+      end
+
+      def self.create_evaluation_event: (hook_context: Hooks::HookContext, evaluation_details: EvaluationDetails?) -> EvaluationEvent
+    end
+  end
+end

data/sig/open_feature/sdk/thread_local_transaction_context_propagator.rbs

@@ -0,0 +1,12 @@
+module OpenFeature
+  module SDK
+    class ThreadLocalTransactionContextPropagator
+      include TransactionContextPropagator
+
+      THREAD_KEY: Symbol
+
+      def set_transaction_context: (EvaluationContext evaluation_context) -> void
+      def get_transaction_context: () -> EvaluationContext?
+    end
+  end
+end