openfeature-ofrep-provider 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 78e2ea5f8ba1403a5bb51f2354bb097905ea42dc693240244e8352decf539f65
+  data.tar.gz: e9f74b87097be94c5333cd54eb64614db1a504e54b11e12750367f34664dcd5a
+SHA512:
+  metadata.gz: 0051e88d937bc94024faa6e4e95129fdd59daecf036fb7740f355a8bdf53da7c8dcfbfea06f17b5022a19ad300b8409561764615f242c789a35de9704fb9ecbb
+  data.tar.gz: e67b311a80efaca9ec882bd95b3afaafb4a77f88594bde3268a04bf925bb2748987eb096f9b1624b314b4d4f72db7d87c2688ff0a09b757fe8d6e763025de8f6

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,5 @@
+inherit_from: ../../shared_config/.rubocop.yml
+
+inherit_mode:
+  merge:
+    - Exclude

data/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## [0.1.2](https://github.com/open-feature/ruby-sdk-contrib/compare/openfeature-ofrep-provider/v0.1.1...openfeature-ofrep-provider/v0.1.2) (2026-03-18)
+
+
+### 🐛 Bug Fixes
+
+* **ofrep:** fix flaky rate limit test with date-based Retry-After ([#118](https://github.com/open-feature/ruby-sdk-contrib/issues/118)) ([0ecdf00](https://github.com/open-feature/ruby-sdk-contrib/commit/0ecdf003a9c1b3b2c5e4fcf853ccc3614355df94))
+
+## [0.1.1](https://github.com/open-feature/ruby-sdk-contrib/compare/openfeature-ofrep-provider-v0.1.0...openfeature-ofrep-provider/v0.1.1) (2026-03-09)
+
+
+### 🧹 Chore
+
+* add conformance tests, SimpleCov, version standardization, and README improvements ([#95](https://github.com/open-feature/ruby-sdk-contrib/issues/95)) ([1c430a9](https://github.com/open-feature/ruby-sdk-contrib/commit/1c430a92041a7841ac01a2642a66376b8259acd2))
+* improve repository maturity and contributor experience ([#91](https://github.com/open-feature/ruby-sdk-contrib/issues/91)) ([7e28025](https://github.com/open-feature/ruby-sdk-contrib/commit/7e280257e6f543bc46537f43aeac302be003b47b))
+
+## Changelog

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,174 @@
+PATH
+  remote: .
+  specs:
+    openfeature-ofrep-provider (0.1.2)
+      faraday-net_http_persistent (~> 2.3)
+      openfeature-sdk (~> 0.3.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.9)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    bigdecimal (4.0.1)
+    connection_pool (3.0.2)
+    crack (1.0.1)
+      bigdecimal
+      rexml
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    faraday (2.14.1)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    faraday-net_http_persistent (2.3.1)
+      faraday (~> 2.5)
+      net-http-persistent (>= 4.0.4, < 5)
+    hashdiff (1.2.1)
+    json (2.19.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    net-http-persistent (4.0.8)
+      connection_pool (>= 2.2.4, < 4)
+    openfeature-sdk (0.3.1)
+    parallel (1.27.0)
+    parser (3.3.10.2)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    public_suffix (7.0.5)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rexml (3.4.4)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.84.2)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
+    standard (1.54.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.84.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.9.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.26.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+    webmock (3.26.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  openfeature-ofrep-provider!
+  rake (~> 13.0)
+  rspec (~> 3.13.0)
+  rubocop
+  simplecov (~> 0.22)
+  standard (>= 1.35.1)
+  standard-performance
+  webmock
+
+CHECKSUMS
+  addressable (2.8.9) sha256=cc154fcbe689711808a43601dee7b980238ce54368d23e127421753e46895485
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  bigdecimal (4.0.1) sha256=8b07d3d065a9f921c80ceaea7c9d4ae596697295b584c296fe599dd0ad01c4a7
+  connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
+  crack (1.0.1) sha256=ff4a10390cd31d66440b7524eb1841874db86201d5b70032028553130b6d4c7e
+  diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
+  docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
+  faraday (2.14.1) sha256=a43cceedc1e39d188f4d2cdd360a8aaa6a11da0c407052e426ba8d3fb42ef61c
+  faraday-net_http (3.4.2) sha256=f147758260d3526939bf57ecf911682f94926a3666502e24c69992765875906c
+  faraday-net_http_persistent (2.3.1) sha256=23ffba37d6a27807a10f033d01918ec958aa73fa6ff0fccfbcd5ce2d2e68fca3
+  hashdiff (1.2.1) sha256=9c079dbc513dfc8833ab59c0c2d8f230fa28499cc5efb4b8dd276cf931457cd1
+  json (2.19.0) sha256=bc5202f083618b3af7aba3184146ec9d820f8f6de261838b577173475e499d9a
+  language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
+  net-http (0.9.1) sha256=25ba0b67c63e89df626ed8fac771d0ad24ad151a858af2cc8e6a716ca4336996
+  net-http-persistent (4.0.8) sha256=ef3de8319d691537b329053fae3a33195f8b070bbbfae8bf1a58c796081960e6
+  openfeature-ofrep-provider (0.1.2)
+  openfeature-sdk (0.3.1) sha256=17a930f52c66ee76a5d20f5bb68cfadbb8d86a4db5b1f99caab8c60ab577f9e5
+  parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
+  parser (3.3.10.2) sha256=6f60c84aa4bdcedb6d1a2434b738fe8a8136807b6adc8f7f53b97da9bc4e9357
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+  public_suffix (7.0.5) sha256=1a8bb08f1bbea19228d3bed6e5ed908d1cb4f7c2726d18bd9cadf60bc676f623
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
+  regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
+  rexml (3.4.4) sha256=19e0a2c3425dfbf2d4fc1189747bdb2f849b6c5e74180401b15734bc97b5d142
+  rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
+  rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
+  rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836
+  rspec-mocks (3.13.8) sha256=086ad3d3d17533f4237643de0b5c42f04b66348c28bf6b9c2d3f4a3b01af1d47
+  rspec-support (3.13.7) sha256=0640e5570872aafefd79867901deeeeb40b0c9875a36b983d85f54fb7381c47c
+  rubocop (1.84.2) sha256=5692cea54168f3dc8cb79a6fe95c5424b7ea893c707ad7a4307b0585e88dbf5f
+  rubocop-ast (1.49.0) sha256=49c3676d3123a0923d333e20c6c2dbaaae2d2287b475273fddee0c61da9f71fd
+  rubocop-performance (1.26.1) sha256=cd19b936ff196df85829d264b522fd4f98b6c89ad271fa52744a8c11b8f71834
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  simplecov (0.22.0) sha256=fe2622c7834ff23b98066bb0a854284b2729a569ac659f82621fc22ef36213a5
+  simplecov-html (0.13.2) sha256=bd0b8e54e7c2d7685927e8d6286466359b6f16b18cb0df47b508e8d73c777246
+  simplecov_json_formatter (0.1.4) sha256=529418fbe8de1713ac2b2d612aa3daa56d316975d307244399fa4838c601b428
+  standard (1.54.0) sha256=7a4b08f83d9893083c8f03bc486f0feeb6a84d48233b40829c03ef4767ea0100
+  standard-custom (1.0.2) sha256=424adc84179a074f1a2a309bb9cf7cd6bfdb2b6541f20c6bf9436c0ba22a652b
+  standard-performance (1.9.0) sha256=49483d31be448292951d80e5e67cdcb576c2502103c7b40aec6f1b6e9c88e3f2
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
+  uri (1.1.1) sha256=379fa58d27ffb1387eaada68c749d1426738bd0f654d812fcc07e7568f5c57c6
+  webmock (3.26.1) sha256=4f696fb57c90a827c20aadb2d4f9058bbff10f7f043bd0d4c3f58791143b1cd7
+
+BUNDLED WITH
+  4.0.6

data/README.md

@@ -0,0 +1,247 @@
+# OpenFeature OFREP Provider for Ruby
+
+An [OpenFeature](https://openfeature.dev/) provider for [OFREP](https://openfeature.dev/docs/reference/technologies/remote-evaluation-protocol) (OpenFeature Remote Evaluation Protocol) compliant feature flag servers.
+
+OFREP is a vendor-neutral protocol that allows any compliant server to be used with this provider, including [flagd](https://flagd.dev/), [GO Feature Flag](https://gofeatureflag.org/), and others.
+
+## Features
+
+| Status | Feature | Description |
+|--------|---------|-------------|
+| ✅ | Flag Evaluation | Support for all OpenFeature flag types |
+| ✅ | Boolean Flags | Evaluate boolean feature flags |
+| ✅ | String Flags | Evaluate string feature flags |
+| ✅ | Number Flags | Evaluate numeric feature flags (integer, float) |
+| ✅ | Object Flags | Evaluate JSON object/array flags |
+| ✅ | Evaluation Context | Support for targeting key and custom attributes |
+| ✅ | Custom Headers | Configurable HTTP headers for authentication |
+| ✅ | Error Handling | Comprehensive error handling with typed errors |
+| ✅ | Type Validation | Strict type checking for flag values |
+
+## Requirements
+
+- Ruby >= 3.4
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'openfeature-ofrep-provider'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself as:
+
+```bash
+gem install openfeature-ofrep-provider
+```
+
+## Usage
+
+### Basic Setup
+
+```ruby
+require "open_feature/sdk"
+require "openfeature/ofrep/provider"
+
+# Configure the OFREP provider
+configuration = OpenFeature::OFREP::Configuration.new(
+  base_url: "http://localhost:8080",
+  headers: { "Authorization" => "Bearer my-token" },
+  timeout: 10
+)
+
+provider = OpenFeature::OFREP::Provider.new(configuration: configuration)
+
+# Set the provider in OpenFeature
+OpenFeature::SDK.configure do |config|
+  config.set_provider(provider)
+end
+
+# Get a client
+client = OpenFeature::SDK.build_client
+```
+
+### Evaluating Flags
+
+#### Boolean Flags
+
+```ruby
+evaluation_context = OpenFeature::SDK::EvaluationContext.new(
+  targeting_key: "user_123"
+)
+
+enabled = client.fetch_boolean_value(
+  flag_key: "new_feature",
+  default_value: false,
+  evaluation_context: evaluation_context
+)
+```
+
+#### String Flags
+
+```ruby
+theme = client.fetch_string_value(
+  flag_key: "theme",
+  default_value: "light",
+  evaluation_context: evaluation_context
+)
+```
+
+#### Number Flags
+
+```ruby
+max_items = client.fetch_integer_value(
+  flag_key: "max_items",
+  default_value: 10,
+  evaluation_context: evaluation_context
+)
+
+rate_limit = client.fetch_float_value(
+  flag_key: "rate_limit",
+  default_value: 1.5,
+  evaluation_context: evaluation_context
+)
+```
+
+#### Object Flags
+
+```ruby
+config = client.fetch_object_value(
+  flag_key: "app_config",
+  default_value: { "timeout" => 30 },
+  evaluation_context: evaluation_context
+)
+```
+
+## Configuration Options
+
+The `Configuration` class accepts the following parameters:
+
+| Option | Type | Default | Required | Description |
+|--------|------|---------|----------|-------------|
+| `base_url` | String | - | **Yes** | Base URL of the OFREP-compliant server (must be a valid HTTP/HTTPS URL) |
+| `headers` | Hash | `{}` | No | Custom HTTP headers (e.g., for authentication) |
+| `timeout` | Integer | `10` | No | HTTP request timeout in seconds |
+
+### Configuration Examples
+
+#### Minimal Configuration
+
+```ruby
+configuration = OpenFeature::OFREP::Configuration.new(
+  base_url: "http://localhost:8080"
+)
+```
+
+#### With Authentication
+
+```ruby
+configuration = OpenFeature::OFREP::Configuration.new(
+  base_url: "https://flags.example.com",
+  headers: { "Authorization" => "Bearer your-api-key" }
+)
+```
+
+#### Custom Timeout
+
+```ruby
+configuration = OpenFeature::OFREP::Configuration.new(
+  base_url: "https://flags.example.com",
+  headers: { "Authorization" => "Bearer your-api-key" },
+  timeout: 30
+)
+```
+
+## Evaluation Context
+
+The OFREP provider requires a `targeting_key` in the evaluation context. If the `targeting_key` is missing or empty, an `INVALID_CONTEXT` error is returned.
+
+```ruby
+evaluation_context = OpenFeature::SDK::EvaluationContext.new(
+  targeting_key: "user_123",
+  email: "user@example.com",
+  plan: "premium"
+)
+```
+
+## Error Handling
+
+The provider handles errors gracefully and returns the default value with appropriate error codes:
+
+```ruby
+details = client.fetch_boolean_details(
+  flag_key: "unknown_flag",
+  default_value: false,
+  evaluation_context: evaluation_context
+)
+
+puts details.value          # => false (default value)
+puts details.error_code     # => FLAG_NOT_FOUND
+puts details.error_message  # => "Flag not found: unknown_flag"
+puts details.reason         # => ERROR
+```
+
+### Error Codes
+
+| Error Code | Description |
+|------------|-------------|
+| `FLAG_NOT_FOUND` | The requested flag does not exist on the server |
+| `TYPE_MISMATCH` | The flag value type does not match the requested type |
+| `PARSE_ERROR` | Failed to parse the server response |
+| `INVALID_CONTEXT` | The evaluation context is invalid (e.g., missing `targeting_key`) |
+| `GENERAL` | A general error occurred (unauthorized, internal server error, invalid flag key, or rate limited) |
+
+## Development
+
+### Running Tests
+
+```bash
+bundle install
+bundle exec rspec
+```
+
+### Running Linter
+
+```bash
+bundle exec rubocop
+```
+
+### Building the Gem
+
+```bash
+gem build openfeature-ofrep-provider.gemspec
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+Apache 2.0 - See [LICENSE](LICENSE) for more information.
+
+## Links
+
+- [OFREP Specification](https://openfeature.dev/docs/reference/technologies/remote-evaluation-protocol)
+- [OpenFeature Documentation](https://openfeature.dev/)
+- [OpenFeature Ruby SDK](https://github.com/open-feature/ruby-sdk)
+- [Ruby SDK Contrib Repository](https://github.com/open-feature/ruby-sdk-contrib)
+
+## Support
+
+For issues related to:
+- **This provider**: [GitHub Issues](https://github.com/open-feature/ruby-sdk-contrib/issues)
+- **OpenFeature**: [OpenFeature Community](https://openfeature.dev/community/)

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "standard/rake"
+
+task default: %i[standard spec]

data/bin/rake

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rake", "rake")

data/lib/openfeature/ofrep/provider/client.rb

@@ -0,0 +1,171 @@
+# frozen_string_literal: true
+
+require "cgi"
+require "json"
+require "open_feature/sdk"
+require "faraday/net_http_persistent"
+require_relative "errors"
+require_relative "response"
+
+module OpenFeature
+  module OFREP
+    class Client
+      REASON_MAP = {
+        "STATIC" => SDK::Provider::Reason::STATIC,
+        "DEFAULT" => SDK::Provider::Reason::DEFAULT,
+        "TARGETING_MATCH" => SDK::Provider::Reason::TARGETING_MATCH,
+        "SPLIT" => SDK::Provider::Reason::SPLIT,
+        "CACHED" => SDK::Provider::Reason::CACHED,
+        "DISABLED" => SDK::Provider::Reason::DISABLED,
+        "UNKNOWN" => SDK::Provider::Reason::UNKNOWN,
+        "STALE" => SDK::Provider::Reason::STALE,
+        "ERROR" => SDK::Provider::Reason::ERROR
+      }.freeze
+
+      ERROR_CODE_MAP = {
+        "PROVIDER_NOT_READY" => SDK::Provider::ErrorCode::PROVIDER_NOT_READY,
+        "FLAG_NOT_FOUND" => SDK::Provider::ErrorCode::FLAG_NOT_FOUND,
+        "PARSE_ERROR" => SDK::Provider::ErrorCode::PARSE_ERROR,
+        "TYPE_MISMATCH" => SDK::Provider::ErrorCode::TYPE_MISMATCH,
+        "TARGETING_KEY_MISSING" => SDK::Provider::ErrorCode::TARGETING_KEY_MISSING,
+        "INVALID_CONTEXT" => SDK::Provider::ErrorCode::INVALID_CONTEXT,
+        "GENERAL" => SDK::Provider::ErrorCode::GENERAL
+      }.freeze
+
+      def initialize(configuration:)
+        @configuration = configuration
+        @retry_lock = Mutex.new
+        request_options = {timeout: configuration.timeout}
+        @faraday_connection = Faraday.new(
+          url: configuration.base_url,
+          headers: build_headers,
+          request: request_options
+        ) do |f|
+          f.adapter :net_http_persistent do |http|
+            http.idle_timeout = 30
+          end
+        end
+      end
+
+      def evaluate(flag_key:, evaluation_context:)
+        check_retry_after
+        request = evaluation_request(evaluation_context)
+
+        response = @faraday_connection.post("/ofrep/v1/evaluate/flags/#{CGI.escape(flag_key)}") do |req|
+          req.body = request.to_json
+        end
+
+        case response.status
+        when 200
+          parse_success_response(response)
+        when 400
+          parse_error_response(response)
+        when 401, 403
+          raise OpenFeature::OFREP::UnauthorizedError.new(response)
+        when 404
+          raise OpenFeature::OFREP::FlagNotFoundError.new(response, flag_key)
+        when 429
+          parse_retry_later_header(response)
+          raise OpenFeature::OFREP::RateLimited.new(response)
+        else
+          raise OpenFeature::OFREP::InternalServerError.new(response)
+        end
+      end
+
+      private
+
+      def build_headers
+        {"Content-Type" => "application/json"}.merge(@configuration.headers || {})
+      end
+
+      def evaluation_request(evaluation_context)
+        ctx = evaluation_context
+        fields = ctx.fields.dup
+        fields["targetingKey"] = ctx.targeting_key
+        fields.delete("targeting_key")
+
+        {context: fields}
+      end
+
+      def check_retry_after
+        @retry_lock.synchronize do
+          return if @retry_after.nil?
+          if Time.now < @retry_after
+            raise OpenFeature::OFREP::RateLimited.new(nil)
+          else
+            @retry_after = nil
+          end
+        end
+      end
+
+      def parse_error_response(response)
+        required_keys = %w[key error_code]
+        parsed = JSON.parse(response.body)
+
+        missing_keys = required_keys - parsed.keys
+        unless missing_keys.empty?
+          raise OpenFeature::OFREP::ParseError.new(response)
+        end
+
+        OpenFeature::OFREP::Response.new(
+          value: nil,
+          key: parsed["key"],
+          reason: SDK::Provider::Reason::ERROR,
+          variant: nil,
+          error_code: error_code_mapper(parsed["error_code"]),
+          error_details: parsed["error_details"],
+          metadata: nil
+        )
+      end
+
+      def parse_success_response(response)
+        required_keys = %w[key value reason variant]
+        parsed = JSON.parse(response.body)
+
+        missing_keys = required_keys - parsed.keys
+        unless missing_keys.empty?
+          raise OpenFeature::OFREP::ParseError.new(response)
+        end
+
+        OpenFeature::OFREP::Response.new(
+          value: parsed["value"],
+          key: parsed["key"],
+          reason: reason_mapper(parsed["reason"]),
+          variant: parsed["variant"],
+          error_code: nil,
+          error_details: nil,
+          metadata: parsed["metadata"]
+        )
+      end
+
+      def reason_mapper(reason_str)
+        return SDK::Provider::Reason::UNKNOWN if reason_str.nil?
+        REASON_MAP[reason_str.upcase] || SDK::Provider::Reason::UNKNOWN
+      end
+
+      def error_code_mapper(error_code_str)
+        return SDK::Provider::ErrorCode::GENERAL if error_code_str.nil?
+        ERROR_CODE_MAP[error_code_str.upcase] || SDK::Provider::ErrorCode::GENERAL
+      end
+
+      def parse_retry_later_header(response)
+        retry_after = response["Retry-After"]
+        return nil if retry_after.nil?
+
+        begin
+          next_retry_time =
+            if /^\d+$/.match?(retry_after)
+              Time.now + Integer(retry_after)
+            else
+              Time.httpdate(retry_after)
+            end
+          @retry_lock.synchronize do
+            @retry_after = [@retry_after, next_retry_time].compact.max
+          end
+        rescue ArgumentError
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/openfeature/ofrep/provider/configuration.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module OpenFeature
+  module OFREP
+    class Configuration
+      attr_reader :base_url, :headers, :timeout
+
+      def initialize(base_url:, headers: {}, timeout: 10)
+        validate_base_url(base_url)
+        @base_url = base_url
+        @headers = headers
+        @timeout = timeout
+      end
+
+      private
+
+      def validate_base_url(base_url)
+        raise ArgumentError, "base_url is required" if base_url.nil? || base_url.empty?
+
+        uri = URI.parse(base_url)
+        raise ArgumentError, "Invalid URL for base_url: #{base_url}" unless uri.is_a?(URI::HTTP) || uri.is_a?(URI::HTTPS)
+      rescue URI::InvalidURIError
+        raise ArgumentError, "Invalid URL for base_url: #{base_url}"
+      end
+    end
+  end
+end

data/lib/openfeature/ofrep/provider/errors.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require "open_feature/sdk/provider/error_code"
+
+module OpenFeature
+  module OFREP
+    class FlagNotFoundError < StandardError
+      attr_reader :response, :error_code, :error_message
+
+      def initialize(response, flag_key)
+        error_message = "Flag not found: #{flag_key}"
+        @response = response
+        @error_code = SDK::Provider::ErrorCode::FLAG_NOT_FOUND
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+
+    class InternalServerError < StandardError
+      attr_reader :response, :error_code, :error_message
+
+      def initialize(response)
+        error_message = "Internal Server Error"
+        @response = response
+        @error_code = SDK::Provider::ErrorCode::GENERAL
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+
+    class InvalidOptionError < StandardError
+      attr_reader :error_code, :error_message
+
+      def initialize(error_code, error_message)
+        @error_code = error_code
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+
+    class UnauthorizedError < StandardError
+      attr_reader :response, :error_code, :error_message
+
+      def initialize(response)
+        error_message = "unauthorized"
+        @response = response
+        @error_code = SDK::Provider::ErrorCode::GENERAL
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+
+    class ParseError < StandardError
+      attr_reader :response, :error_code, :error_message
+
+      def initialize(response)
+        error_message = "Parse error"
+        @response = response
+        @error_code = SDK::Provider::ErrorCode::PARSE_ERROR
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+
+    class RateLimited < StandardError
+      attr_reader :response, :error_code, :error_message
+
+      def initialize(response)
+        error_message = "Rate limited"
+        error_message += ": #{response["Retry-After"]}" if response&.[]("Retry-After")
+        @response = response
+        @error_code = SDK::Provider::ErrorCode::GENERAL
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+  end
+end

data/lib/openfeature/ofrep/provider/response.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module OpenFeature
+  module OFREP
+    class Response
+      attr_reader :value, :key, :reason, :variant, :error_code, :error_details, :metadata
+
+      def initialize(value:, key:, reason:, variant:, error_code:, error_details:, metadata:)
+        @value = value
+        @key = key
+        @reason = reason
+        @variant = variant
+        @error_code = error_code
+        @error_details = error_details
+        @metadata = metadata
+      end
+
+      def error?
+        !@error_code.nil? && !@error_code.empty?
+      end
+
+      def eql?(other)
+        return false unless other.is_a?(OpenFeature::OFREP::Response)
+        key == other.key &&
+          value == other.value &&
+          reason == other.reason &&
+          variant == other.variant &&
+          error_code == other.error_code &&
+          error_details == other.error_details &&
+          metadata == other.metadata
+      end
+    end
+  end
+end

data/lib/openfeature/ofrep/provider/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module OpenFeature
+  module OFREP
+    VERSION = "0.1.2"
+  end
+end

data/lib/openfeature/ofrep/provider.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+require "openfeature/ofrep/provider/configuration"
+require "openfeature/ofrep/provider/client"
+require "openfeature/ofrep/provider/response"
+require "openfeature/ofrep/provider/errors"
+require "openfeature/ofrep/provider/version"
+
+module OpenFeature
+  module OFREP
+    class Provider
+      PROVIDER_NAME = "OFREP Provider"
+      attr_reader :metadata
+
+      def initialize(configuration:)
+        @metadata = SDK::Provider::ProviderMetadata.new(name: PROVIDER_NAME)
+        @configuration = configuration
+        @client = Client.new(configuration: configuration)
+      end
+
+      def fetch_boolean_value(flag_key:, default_value:, evaluation_context: nil)
+        evaluate(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context, allowed_classes: [TrueClass, FalseClass])
+      end
+
+      def fetch_string_value(flag_key:, default_value:, evaluation_context: nil)
+        evaluate(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context, allowed_classes: [String])
+      end
+
+      def fetch_number_value(flag_key:, default_value:, evaluation_context: nil)
+        evaluate(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context, allowed_classes: [Integer, Float])
+      end
+
+      def fetch_integer_value(flag_key:, default_value:, evaluation_context: nil)
+        evaluate(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context, allowed_classes: [Integer])
+      end
+
+      def fetch_float_value(flag_key:, default_value:, evaluation_context: nil)
+        evaluate(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context, allowed_classes: [Float])
+      end
+
+      def fetch_object_value(flag_key:, default_value:, evaluation_context: nil)
+        evaluate(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context, allowed_classes: [Array, Hash])
+      end
+
+      private
+
+      def evaluate(flag_key:, default_value:, allowed_classes:, evaluation_context: nil)
+        evaluation_context = OpenFeature::SDK::EvaluationContext.new if evaluation_context.nil?
+        validate_parameters(flag_key, evaluation_context)
+
+        parsed_response = @client.evaluate(flag_key: flag_key, evaluation_context: evaluation_context)
+
+        if parsed_response.error?
+          return SDK::Provider::ResolutionDetails.new(
+            value: default_value,
+            error_code: parsed_response.error_code,
+            error_message: parsed_response.error_details,
+            reason: parsed_response.reason
+          )
+        end
+
+        if parsed_response.reason == SDK::Provider::Reason::DISABLED
+          return SDK::Provider::ResolutionDetails.new(
+            value: default_value,
+            reason: SDK::Provider::Reason::DISABLED
+          )
+        end
+
+        unless allowed_classes.include?(parsed_response.value.class)
+          return SDK::Provider::ResolutionDetails.new(
+            value: default_value,
+            error_code: SDK::Provider::ErrorCode::TYPE_MISMATCH,
+            error_message: "flag type #{parsed_response.value.class} does not match allowed types #{allowed_classes}",
+            reason: SDK::Provider::Reason::ERROR
+          )
+        end
+
+        SDK::Provider::ResolutionDetails.new(
+          value: parsed_response.value,
+          reason: parsed_response.reason,
+          variant: parsed_response.variant,
+          flag_metadata: parsed_response.metadata
+        )
+      rescue UnauthorizedError,
+        InvalidOptionError,
+        FlagNotFoundError,
+        InternalServerError => e
+        SDK::Provider::ResolutionDetails.new(
+          value: default_value,
+          error_code: e.error_code,
+          error_message: e.error_message,
+          reason: SDK::Provider::Reason::ERROR
+        )
+      end
+
+      def validate_parameters(flag_key, evaluation_context)
+        if evaluation_context.targeting_key.nil? || evaluation_context.targeting_key.empty?
+          raise InvalidOptionError.new(SDK::Provider::ErrorCode::INVALID_CONTEXT, "invalid evaluation context provided")
+        end
+
+        if flag_key.nil? || flag_key.empty?
+          raise InvalidOptionError.new(SDK::Provider::ErrorCode::GENERAL, "invalid flag key provided")
+        end
+      end
+    end
+  end
+end

data/openfeature-ofrep-provider.gemspec

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative "lib/openfeature/ofrep/provider/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "openfeature-ofrep-provider"
+  spec.version = OpenFeature::OFREP::VERSION
+  spec.authors = ["OpenFeature Contributors"]
+  spec.email = ["cncf-openfeature-contributors@lists.cncf.io"]
+
+  spec.summary = "The OFREP provider for the OpenFeature Ruby SDK"
+  spec.description = "A vendor-neutral OFREP (OpenFeature Remote Evaluation Protocol) provider for the OpenFeature Ruby SDK"
+  spec.homepage = "https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-ofrep-provider"
+  spec.license = "Apache-2.0"
+  spec.required_ruby_version = ">= 3.4"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-ofrep-provider"
+  spec.metadata["changelog_uri"] = "https://github.com/open-feature/ruby-sdk-contrib/blob/main/providers/openfeature-ofrep-provider/CHANGELOG.md"
+  spec.metadata["bug_tracker_uri"] = "https://github.com/open-feature/ruby-sdk-contrib/issues"
+  spec.metadata["documentation_uri"] = "https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-ofrep-provider/README.md"
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "openfeature-sdk", "~> 0.3.1"
+  spec.add_runtime_dependency "faraday-net_http_persistent", "~> 2.3"
+
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.13.0"
+  spec.add_development_dependency "standard", ">= 1.35.1"
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "standard-performance"
+  spec.add_development_dependency "simplecov", "~> 0.22"
+  spec.add_development_dependency "webmock"
+end

metadata

@@ -0,0 +1,188 @@
+--- !ruby/object:Gem::Specification
+name: openfeature-ofrep-provider
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- OpenFeature Contributors
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: openfeature-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.1
+- !ruby/object:Gem::Dependency
+  name: faraday-net_http_persistent
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.13.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.13.0
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.35.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.35.1
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: standard-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A vendor-neutral OFREP (OpenFeature Remote Evaluation Protocol) provider
+  for the OpenFeature Ruby SDK
+email:
+- cncf-openfeature-contributors@lists.cncf.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/rake
+- lib/openfeature/ofrep/provider.rb
+- lib/openfeature/ofrep/provider/client.rb
+- lib/openfeature/ofrep/provider/configuration.rb
+- lib/openfeature/ofrep/provider/errors.rb
+- lib/openfeature/ofrep/provider/response.rb
+- lib/openfeature/ofrep/provider/version.rb
+- openfeature-ofrep-provider.gemspec
+homepage: https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-ofrep-provider
+licenses:
+- Apache-2.0
+metadata:
+  homepage_uri: https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-ofrep-provider
+  source_code_uri: https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-ofrep-provider
+  changelog_uri: https://github.com/open-feature/ruby-sdk-contrib/blob/main/providers/openfeature-ofrep-provider/CHANGELOG.md
+  bug_tracker_uri: https://github.com/open-feature/ruby-sdk-contrib/issues
+  documentation_uri: https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-ofrep-provider/README.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: The OFREP provider for the OpenFeature Ruby SDK
+test_files: []