openfeature-sdk-sorbet 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5c2231f2741a4d89cde28735ddfd5c509bba978559bb732a98a1864bb65dd30
-  data.tar.gz: 54d011f1a7bc30a14647632914440ea2814eee934773996d4e70ce9119ec52bc
+  metadata.gz: c15c80725be63842d38491ff9c0addddcf29d063a191eadb44fe957e059ab520
+  data.tar.gz: 7a263495564db2fee7cb4805d82458ee70951a30ebe15bb470f205c97c32b529
 SHA512:
-  metadata.gz: 11643994331234597fc371c44162f95445ba7e3c5b347a0af614206ebf82df2b884dae463727f68011268a9250bedd00c9c161f3428bcc1f48aeb3090d815236
-  data.tar.gz: ee4e892b17b5661ccbab5260a32fa8c460be9ee711f83d99ddc1451e29bdf6edb23e96ef1925aad0bc57c3f77f13b6c44154d24338e591b3a5d3b49987fbf571
+  metadata.gz: 6cb5f8413afe5a94866d456e841fabc092c09058d0117df0847e33111cd1020b313f45c5ad512200f19e463557369eca2a846f6eb0b28b6e4f8c7fff898ce1e7
+  data.tar.gz: 6279c0be67ad089ee53201d451cf6349cc976e59d016c850a1d74711a47bc890aad6ba5e11ff92ec343c8277555a81834bf238d7a487275db33cd224400272e1

data/.rubocop.yml

@@ -10,7 +10,7 @@ require:
 
 AllCops:
   NewCops: enable
-  TargetRubyVersion: 2.7
+  TargetRubyVersion: 3.1
   Exclude:
     - sorbet/**/*.rbi
 
@@ -25,6 +25,7 @@ Lint/UnusedMethodArgument:
 Metrics/ClassLength:
   Exclude:
     - lib/open_feature/client.rb
+    - lib/open_feature/multiple_source_provider.rb
     - test/open_feature/client_test.rb
     - test/open_feature/multiple_source_provider_test.rb
 

data/.ruby-version

@@ -1 +1 @@
-3.2.2
+3.3.0

data/.tool-versions

@@ -1 +1 @@
-ruby 3.2.2
+ruby 3.3.0

data/CHANGELOG.md

@@ -6,11 +6,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.2.1] - 2023-07-27
+## [0.3.0] - 2024-01-24
 
-### Fixed
+### Added
+
+- Added `OpenFeature::Provider#status` reader that returns an `OpenFeature::ProviderStatus`.
+- Added `OpenFeature::Provider#init` as an overridable method on `Provider`s that can perform any initialization work for the given provider. This method accepts the global `EvaluationContext` and has a `void` return type. The default implementation is a no-op.
+- Added `OpenFeature::Provider#shutdown` as an overridable method on `Provider`s that can perform any cleanup work for the given provider. This method has a `void` return type and the default implementation is a no-op.
+- Added `OpenFeature.shutdown` to invoke the current provider's `shutdown` method.
+
+### Changed
 
-- Fixed an issue where the `OpenFeature::MultipleSourceProvider` did not properly pass evaluation context to the internal providers.
+- *Breaking* Changed minimum supported Ruby version to 3.1.
+- *Breaking* `OpenFeature::Provider` changed from a module interface to an abstract class to support default method implementations.
+- *Breaking* `OpenFeature::Provider.initialize` now must accept an `OpenFeature::ProviderStatus`. Any providers may pass this in during initialization. If you need to do additional setup in `Provider.init`, we recommend you pass `OpenFeature::ProviderStatus::NotReady` here.
 
 ## [0.2.0] - 2023-05-17
 

data/Gemfile

@@ -13,7 +13,7 @@ group :development do
   gem "rubocop-rake"
   gem "rubocop-sorbet"
   gem "sorbet"
-  gem "spoom"
+  gem "spoom", "1.2.1" # remove once we go to Ruby 3+
   gem "tapioca", require: false
 end
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    openfeature-sdk-sorbet (0.2.1)
+    openfeature-sdk-sorbet (0.3.0)
       sorbet-runtime (~> 0.5)
       sorbet-struct-comparable (~> 1.3)
       zeitwerk (~> 2.6)
@@ -10,88 +10,94 @@ GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.2)
-    debug (1.8.0)
-      irb (>= 1.5.0)
-      reline (>= 0.3.1)
-    diff-lcs (1.5.0)
-    io-console (0.6.0)
-    irb (1.6.4)
-      reline (>= 0.3.0)
-    json (2.6.3)
-    minitest (5.18.0)
+    debug (1.9.1)
+      irb (~> 1.10)
+      reline (>= 0.3.8)
+    io-console (0.7.2)
+    irb (1.11.1)
+      rdoc
+      reline (>= 0.4.2)
+    json (2.7.1)
+    language_server-protocol (3.17.0.3)
+    minitest (5.21.2)
     netrc (0.11.0)
-    parallel (1.23.0)
-    parser (3.2.2.1)
+    parallel (1.24.0)
+    parser (3.3.0.5)
       ast (~> 2.4.1)
+      racc
+    prism (0.19.0)
+    psych (5.1.2)
+      stringio
+    racc (1.7.3)
     rainbow (3.1.1)
-    rake (13.0.6)
-    rbi (0.0.16)
-      ast
-      parser (>= 2.6.4.0)
+    rake (13.1.0)
+    rbi (0.1.6)
+      prism (>= 0.18.0, < 0.20)
       sorbet-runtime (>= 0.5.9204)
-      unparser
-    regexp_parser (2.8.0)
-    reline (0.3.3)
+    rdoc (6.6.2)
+      psych (>= 4.0.0)
+    regexp_parser (2.9.0)
+    reline (0.4.2)
       io-console (~> 0.5)
-    rexml (3.2.5)
-    rubocop (1.51.0)
+    rexml (3.2.6)
+    rubocop (1.60.2)
       json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 3.2.0.0)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.28.0, < 2.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.28.1)
+    rubocop-ast (1.30.0)
       parser (>= 3.2.1.0)
-    rubocop-minitest (0.31.0)
+    rubocop-minitest (0.34.5)
       rubocop (>= 1.39, < 2.0)
-    rubocop-performance (1.17.1)
-      rubocop (>= 1.7.0, < 2.0)
-      rubocop-ast (>= 0.4.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
+    rubocop-performance (1.20.2)
+      rubocop (>= 1.48.1, < 2.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
     rubocop-rake (0.6.0)
       rubocop (~> 1.0)
-    rubocop-sorbet (0.7.0)
+    rubocop-sorbet (0.7.6)
       rubocop (>= 0.90.0)
     ruby-progressbar (1.13.0)
-    sorbet (0.5.10830)
-      sorbet-static (= 0.5.10830)
-    sorbet-runtime (0.5.10830)
-    sorbet-static (0.5.10830-universal-darwin-22)
-    sorbet-static (0.5.10830-x86_64-linux)
-    sorbet-static-and-runtime (0.5.10830)
-      sorbet (= 0.5.10830)
-      sorbet-runtime (= 0.5.10830)
+    sorbet (0.5.11218)
+      sorbet-static (= 0.5.11218)
+    sorbet-runtime (0.5.11218)
+    sorbet-static (0.5.11218-universal-darwin)
+    sorbet-static (0.5.11218-x86_64-linux)
+    sorbet-static-and-runtime (0.5.11218)
+      sorbet (= 0.5.11218)
+      sorbet-runtime (= 0.5.11218)
     sorbet-struct-comparable (1.3.0)
       sorbet-runtime (>= 0.5)
     spoom (1.2.1)
       sorbet (>= 0.5.10187)
       sorbet-runtime (>= 0.5.9204)
       thor (>= 0.19.2)
-    tapioca (0.11.6)
+    stringio (3.1.0)
+    tapioca (0.11.17)
       bundler (>= 2.2.25)
       netrc (>= 0.11.0)
       parallel (>= 1.21.0)
-      rbi (~> 0.0.0, >= 0.0.16)
-      sorbet-static-and-runtime (>= 0.5.10187)
+      rbi (>= 0.1.4, < 0.2)
+      sorbet-static-and-runtime (>= 0.5.10820)
       spoom (~> 1.2.0, >= 1.2.0)
       thor (>= 1.2.0)
       yard-sorbet
-    thor (1.2.2)
-    unicode-display_width (2.4.2)
-    unparser (0.6.7)
-      diff-lcs (~> 1.3)
-      parser (>= 3.2.0)
+    thor (1.3.0)
+    unicode-display_width (2.5.0)
     yard (0.9.34)
     yard-sorbet (0.8.1)
       sorbet-runtime (>= 0.5)
       yard (>= 0.9)
-    zeitwerk (2.6.8)
+    zeitwerk (2.6.12)
 
 PLATFORMS
-  arm64-darwin-22
+  arm64-darwin
   x86_64-linux
 
 DEPENDENCIES
@@ -106,8 +112,8 @@ DEPENDENCIES
   rubocop-sorbet
   sorbet
   sorbet-runtime
-  spoom
+  spoom (= 1.2.1)
   tapioca
 
 BUNDLED WITH
-   2.4.12
+   2.5.5

data/README.md

@@ -5,7 +5,7 @@
 If an organization is not already using Sorbet, you probably don't want to introduce a dependency on `sorbet-runtime`, which this gem does. As such, this will always be a distinct implementation, separate from the official [Ruby SDK](https://github.com/open-feature/ruby-sdk).
 
 Current OpenFeature specification target version: `0.5.2`
-Current supported Ruby versions: `2.7.X`, `3.0.X`, `3.1.X`, `3.2.X`
+Current supported Ruby versions: `3.1.X`, `3.2.X`
 Support for Evaluation Context and Hooks is not complete.
 
 ## Installation
@@ -53,7 +53,7 @@ The OpenFeature specification defines [Structure as a potential return type](htt
 
 We support global evaluation context (set on the `OpenFeature` module), client evaluation context (set on client instances or during client initialization) and invocation evaluation context (passed in during flag evaluation). In compliance with the specification, the invocation context merges into the client context which merges into the global context. Fields in invocation context take precedence over fields in the client context which take precedence over fields in the global context.
 
-### Provider Interface
+### Provider Abstract Class
 
 By default, this implementation sets the provider to the `OpenFeature::NoOpProvider` which always returns the default value. It's up to the individual teams to define their own providers based on their flag source (in the future, I'll release open-source providers based on various, common vendors).
 
@@ -72,13 +72,26 @@ OpenFeature.set_provider(provider)
 
 #### Implementing Custom Providers
 
-Thanks to Sorbet interfaces, it's fairly straightforward to implement a new provider. Here is an example for a JSON-based flag format on disk:
+Thanks to Sorbet abstract classes, it's fairly straightforward to implement a new provider. Here is an example for a JSON-based flag format on disk:
 
 ```ruby
-class JsonFileFlagProvider
+class JsonFileFlagProvider < OpenFeature::Provider
   extend T::Sig
 
-  include OpenFeature::Provider
+  sig { void }
+  def initialize
+    super(OpenFeature::ProviderStatus::NotReady)
+  end
+
+  def init(context)
+    @file = File.open(context.file || "flags.json")
+    @status = OpenFeature::ProviderStatus::Ready
+  end
+
+  sig { overridable.void }
+  def shutdown
+    @file.close
+  end
 
   sig { override.returns(OpenFeature::ProviderMetadata) }
   def metadata
@@ -113,7 +126,11 @@ class JsonFileFlagProvider
 end
 ```
 
-By including the `OpenFeature::Provider` module, Sorbet will indicate what methods it's expecting and what their type signatures should be.
+By inheriting from the `OpenFeature::Provider` class, Sorbet will indicate what methods it's expecting and what their type signatures should be.
+
+##### A note on `initialize` versus `init`
+
+The Ruby `initialize` method is the best place to do any direct construction logic for an object, such as setting configuration values. `init` is called by OpenFeature when setting a provider and is the best place to make any HTTP requests, establish persistent connections, or any other connection logic that could potentially fail. By the end of this method, `@status` must be set to either `Ready` or `Error`.
 
 ## Development
 

data/lib/open_feature/client.rb

@@ -25,7 +25,7 @@ module OpenFeature
     end
     def initialize(provider:, name: nil, evaluation_context: nil, hooks: [])
       @provider = provider
-      @client_metadata = T.let(ClientMetadata.new(name: name), ClientMetadata)
+      @client_metadata = T.let(ClientMetadata.new(name:), ClientMetadata)
       @evaluation_context = evaluation_context
       @hooks = hooks
     end
@@ -43,10 +43,12 @@ module OpenFeature
         options: T.nilable(EvaluationOptions)
       ).returns(T::Boolean)
     end
-    def fetch_boolean_value(flag_key:, default_value:, context: nil, options: nil) # rubocop:disable Lint/UnusedMethodArgument
-      provider
-        .resolve_boolean_value(flag_key: flag_key, default_value: default_value, context: build_context(context))
-        .value
+    def fetch_boolean_value(flag_key:, default_value:, context: nil, options: nil)
+      evaluated_context = build_context_with_before_hooks(flag_key:, default_value:,
+                                                          invocation_context: context, options:,
+                                                          flag_type: "Boolean")
+      provider.resolve_boolean_value(flag_key:, default_value:, context: evaluated_context)
+              .value
     rescue StandardError
       default_value
     end
@@ -61,14 +63,14 @@ module OpenFeature
     end
     def fetch_boolean_details(flag_key:, default_value:, context: nil, options: nil) # rubocop:disable Lint/UnusedMethodArgument
       details = provider.resolve_boolean_value(
-        flag_key: flag_key,
-        default_value: default_value,
+        flag_key:,
+        default_value:,
         context: build_context(context)
       )
 
-      EvaluationDetails.from_resolution_details(details, flag_key: flag_key)
+      EvaluationDetails.from_resolution_details(details, flag_key:)
     rescue StandardError => e
-      EvaluationDetails.from_error(e.message, flag_key: flag_key, default_value: default_value)
+      EvaluationDetails.from_error(e.message, flag_key:, default_value:)
     end
 
     sig do
@@ -79,9 +81,12 @@ module OpenFeature
         options: T.nilable(EvaluationOptions)
       ).returns(String)
     end
-    def fetch_string_value(flag_key:, default_value:, context: nil, options: nil) # rubocop:disable Lint/UnusedMethodArgument
+    def fetch_string_value(flag_key:, default_value:, context: nil, options: nil)
+      evaluated_context = build_context_with_before_hooks(flag_key:, default_value:,
+                                                          invocation_context: context, options:,
+                                                          flag_type: "String")
       provider
-        .resolve_string_value(flag_key: flag_key, default_value: default_value, context: build_context(context))
+        .resolve_string_value(flag_key:, default_value:, context: evaluated_context)
         .value
     rescue StandardError
       default_value
@@ -97,14 +102,14 @@ module OpenFeature
     end
     def fetch_string_details(flag_key:, default_value:, context: nil, options: nil) # rubocop:disable Lint/UnusedMethodArgument
       details = provider.resolve_string_value(
-        flag_key: flag_key,
-        default_value: default_value,
+        flag_key:,
+        default_value:,
         context: build_context(context)
       )
 
-      EvaluationDetails.from_resolution_details(details, flag_key: flag_key)
+      EvaluationDetails.from_resolution_details(details, flag_key:)
     rescue StandardError => e
-      EvaluationDetails.from_error(e.message, flag_key: flag_key, default_value: default_value)
+      EvaluationDetails.from_error(e.message, flag_key:, default_value:)
     end
 
     sig do
@@ -115,9 +120,12 @@ module OpenFeature
         options: T.nilable(EvaluationOptions)
       ).returns(Numeric)
     end
-    def fetch_number_value(flag_key:, default_value:, context: nil, options: nil) # rubocop:disable Lint/UnusedMethodArgument
+    def fetch_number_value(flag_key:, default_value:, context: nil, options: nil)
+      evaluated_context = build_context_with_before_hooks(flag_key:, default_value:,
+                                                          invocation_context: context, options:,
+                                                          flag_type: "Number")
       provider
-        .resolve_number_value(flag_key: flag_key, default_value: default_value, context: build_context(context))
+        .resolve_number_value(flag_key:, default_value:, context: evaluated_context)
         .value
     rescue StandardError
       default_value
@@ -133,14 +141,14 @@ module OpenFeature
     end
     def fetch_number_details(flag_key:, default_value:, context: nil, options: nil) # rubocop:disable Lint/UnusedMethodArgument
       details = provider.resolve_number_value(
-        flag_key: flag_key,
-        default_value: default_value,
+        flag_key:,
+        default_value:,
         context: build_context(context)
       )
 
-      EvaluationDetails.from_resolution_details(details, flag_key: flag_key)
+      EvaluationDetails.from_resolution_details(details, flag_key:)
     rescue StandardError => e
-      EvaluationDetails.from_error(e.message, flag_key: flag_key, default_value: default_value)
+      EvaluationDetails.from_error(e.message, flag_key:, default_value:)
     end
 
     sig do
@@ -151,9 +159,12 @@ module OpenFeature
         options: T.nilable(EvaluationOptions)
       ).returns(Integer)
     end
-    def fetch_integer_value(flag_key:, default_value:, context: nil, options: nil) # rubocop:disable Lint/UnusedMethodArgument
+    def fetch_integer_value(flag_key:, default_value:, context: nil, options: nil)
+      evaluated_context = build_context_with_before_hooks(flag_key:, default_value:,
+                                                          invocation_context: context, options:,
+                                                          flag_type: "Integer")
       provider
-        .resolve_number_value(flag_key: flag_key, default_value: default_value, context: build_context(context))
+        .resolve_number_value(flag_key:, default_value:, context: evaluated_context)
         .value
         .to_i
     rescue StandardError
@@ -168,9 +179,12 @@ module OpenFeature
         options: T.nilable(EvaluationOptions)
       ).returns(Float)
     end
-    def fetch_float_value(flag_key:, default_value:, context: nil, options: nil) # rubocop:disable Lint/UnusedMethodArgument
+    def fetch_float_value(flag_key:, default_value:, context: nil, options: nil)
+      evaluated_context = build_context_with_before_hooks(flag_key:, default_value:,
+                                                          invocation_context: context, options:,
+                                                          flag_type: "Float")
       provider
-        .resolve_number_value(flag_key: flag_key, default_value: default_value, context: build_context(context))
+        .resolve_number_value(flag_key:, default_value:, context: evaluated_context)
         .value
         .to_f
     rescue StandardError
@@ -185,9 +199,12 @@ module OpenFeature
         options: T.nilable(EvaluationOptions)
       ).returns(Structure)
     end
-    def fetch_structure_value(flag_key:, default_value:, context: nil, options: nil) # rubocop:disable Lint/UnusedMethodArgument
+    def fetch_structure_value(flag_key:, default_value:, context: nil, options: nil)
+      evaluated_context = build_context_with_before_hooks(flag_key:, default_value:,
+                                                          invocation_context: context, options:,
+                                                          flag_type: "Structure")
       provider
-        .resolve_structure_value(flag_key: flag_key, default_value: default_value, context: build_context(context))
+        .resolve_structure_value(flag_key:, default_value:, context: evaluated_context)
         .value
     rescue StandardError
       default_value
@@ -203,14 +220,14 @@ module OpenFeature
     end
     def fetch_structure_details(flag_key:, default_value:, context: nil, options: nil) # rubocop:disable Lint/UnusedMethodArgument
       details = provider.resolve_structure_value(
-        flag_key: flag_key,
-        default_value: default_value,
+        flag_key:,
+        default_value:,
         context: build_context(context)
       )
 
-      EvaluationDetails.from_resolution_details(details, flag_key: flag_key)
+      EvaluationDetails.from_resolution_details(details, flag_key:)
     rescue StandardError => e
-      EvaluationDetails.from_error(e.message, flag_key: flag_key, default_value: default_value)
+      EvaluationDetails.from_error(e.message, flag_key:, default_value:)
     end
 
     private
@@ -218,12 +235,53 @@ module OpenFeature
     sig { returns(Provider) }
     attr_reader :provider
 
+    sig do
+      type_parameters(:U).params(
+        flag_key: String,
+        default_value: T.type_parameter(:U),
+        invocation_context: T.nilable(EvaluationContext),
+        options: T.nilable(EvaluationOptions),
+        flag_type: String
+      ).returns(EvaluationContext)
+    end
+    def build_context_with_before_hooks(flag_key:, default_value:, invocation_context:, options:, flag_type:)
+      hook_context = build_hook_context(flag_key:, default_value:,
+                                        invocation_context:, flag_type:)
+      OpenFeature::Hook::BeforeHook.call(hooks: build_hooks(options), context: hook_context,
+                                         hints: {})
+    end
+
+    sig { params(options: T.nilable(EvaluationOptions)).returns(Hooks) }
+    def build_hooks(options)
+      Hooks.new(
+        global: OpenFeature.configuration.hooks,
+        client: hooks,
+        invocation: (options ? options.hooks : []),
+        provider: provider.hooks
+      )
+    end
+
+    sig do
+      type_parameters(:U).params(
+        flag_key: String,
+        default_value: T.type_parameter(:U),
+        invocation_context: T.nilable(EvaluationContext),
+        flag_type: String
+      ).returns(HookContext[T.type_parameter(:U)])
+    end
+    def build_hook_context(flag_key:, default_value:, invocation_context:, flag_type:)
+      evaluation_context = build_context(invocation_context) || OpenFeature::EvaluationContext.new
+      HookContext.new(flag_key:, default_value:,
+                      evaluation_context:, flag_type:,
+                      client_metadata:, provider_metadata: provider.metadata)
+    end
+
     sig { params(invocation_context: T.nilable(EvaluationContext)).returns(T.nilable(EvaluationContext)) }
     def build_context(invocation_context)
       EvaluationContextBuilder.new.call(
         global_context: OpenFeature.configuration.evaluation_context,
         client_context: evaluation_context,
-        invocation_context: invocation_context
+        invocation_context:
       )
     end
   end

data/lib/open_feature/client_metadata.rb

@@ -4,6 +4,7 @@
 module OpenFeature
   # Defines information about a Client.
   class ClientMetadata < T::Struct
+    include T::Struct::ActsAsComparable
     const :name, T.nilable(String)
   end
 end

data/lib/open_feature/evaluation_context.rb

@@ -13,7 +13,7 @@ module OpenFeature
 
     FieldValueType = T.type_alias { T.any(T::Boolean, String, Numeric, DateTime, Structure) }
 
-    const :targeting_key, T.nilable(String)
+    const :targeting_key, T.nilable(String), default: nil
     const :fields, T::Hash[String, FieldValueType], default: {}
 
     sig { params(method_name: Symbol).returns(T::Boolean) }
@@ -29,7 +29,7 @@ module OpenFeature
     sig { params(key: String, value: FieldValueType).returns(EvaluationContext) }
     def add_field(key, value)
       EvaluationContext.new(
-        targeting_key: targeting_key,
+        targeting_key:,
         fields: fields.merge({ key => value })
       )
     end

data/lib/open_feature/evaluation_details.rb

@@ -25,7 +25,7 @@ module OpenFeature
       sig { params(details: ResolutionDetails[SelfValue], flag_key: String).returns(EvaluationDetails[SelfValue]) }
       def from_resolution_details(details, flag_key:)
         EvaluationDetails.new(
-          flag_key: flag_key,
+          flag_key:,
           value: details.value,
           error_code: details.error_code,
           error_message: details.error_message,
@@ -44,7 +44,7 @@ module OpenFeature
       end
       def from_error(error_message, flag_key:, default_value:)
         EvaluationDetails.new(
-          flag_key: flag_key,
+          flag_key:,
           value: default_value,
           error_code: ErrorCode::General,
           error_message: "Provider raised error: #{error_message}",

data/lib/open_feature/hook.rb

@@ -2,5 +2,45 @@
 # frozen_string_literal: true
 
 module OpenFeature
-  class Hook < T::Struct; end
+  # See https://openfeature.dev/specification/sections/hooks
+  # We model Hooks as a simple ADT
+  module Hook
+    extend T::Sig
+    extend T::Helpers
+    interface!
+    sealed!
+
+    # See Requirement 4.3.2 - 4.3.4
+    class BeforeHook
+      include Hook
+      extend T::Sig
+      extend T::Helpers
+      include OpenFeature::Hook
+      abstract!
+      sig do
+        abstract.params(context: OpenFeature::HookContext[T.untyped],
+                        hints: T::Hash[String, T.untyped]).returns(OpenFeature::EvaluationContext)
+      end
+      def call(context:, hints:); end
+
+      class << self
+        extend T::Sig
+
+        sig do
+          params(hooks: Hooks, context: OpenFeature::HookContext[T.untyped],
+                 hints: T::Hash[String, T.untyped]).returns(OpenFeature::EvaluationContext)
+        end
+        def call(hooks:, context:, hints:)
+          context.evaluation_context.merge(
+            hooks.before.reduce(context.evaluation_context) do |evaluation_context, hook|
+              hook.call(
+                context: context.with_new_evaluation_context(evaluation_context),
+                hints:
+              )
+            end
+          )
+        end
+      end
+    end
+  end
 end

data/lib/open_feature/hook_context.rb

@@ -0,0 +1,30 @@
+# typed: strict
+# frozen_string_literal: true
+
+module OpenFeature
+  # See https://openfeature.dev/specification/sections/hooks#41-hook-context
+  # See Requirement 4.1.1, 4.1.3, 4.1.4
+  # TODO: Requirement 4.1.2
+  class HookContext < T::Struct
+    extend T::Generic
+    extend T::Sig
+
+    include T::Struct::ActsAsComparable
+
+    Value = type_member
+    const :flag_key, String
+    const :flag_type, String
+    const :evaluation_context, EvaluationContext
+    const :default_value, Value
+    const :client_metadata, ClientMetadata
+    const :provider_metadata, ProviderMetadata
+
+    # Needed as opposed to .with due to https://sorbet.org/docs/tstruct#from_hash-gotchas
+    sig { params(new_context: EvaluationContext).returns(HookContext[Value]) }
+    def with_new_evaluation_context(new_context)
+      OpenFeature::HookContext.new(flag_key:, flag_type:, default_value:,
+                                   evaluation_context: new_context, client_metadata:,
+                                   provider_metadata:)
+    end
+  end
+end