confidence-openfeature-provider 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 263d2c0dec4c14ba879db7f5d83c35119fdb53dc6798f6e1ce670d86b39fd704
+  data.tar.gz: 2b4c07c13b16992a554fbf15e4ae71bad4a6b5f4ffe3d3378fd99311f45de60b
+SHA512:
+  metadata.gz: 5b0552399f0eb550c0eb3bf7838e9cdec8b5c9b843c34e06a722609f038c91af13e082e36fd7b11a1d8575cef2d0ca73618ef81c0abbd63493758c42b1fa8fbc
+  data.tar.gz: cd99ca08f2f0b49178e5e7e74ab008375b36dd4bcb40458aab53bb3af3d546464b0df5b5f151e5ecb0ebbebf5daeb5e2ea16a5cb9d8d89504cbd8f761fc628a7

data/lib/confidence/openfeature/api_client.rb

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+
+require_relative "errors"
+require_relative "version"
+require "json"
+require "uri"
+require "net/http"
+require "net/https"
+
+module Confidence
+  module OpenFeature
+    class Region
+      attr_reader :uri
+
+      def initialize(uri)
+        @uri = uri
+      end
+
+      EU = new("https://resolver.eu.confidence.dev/v1")
+      US = new("https://resolver.us.confidence.dev/v1")
+    end
+
+    class APIClient
+      def initialize(client_secret:, region: Region::EU)
+        uri = URI.parse(region.uri)
+        @client_secret = client_secret
+        @agent = Net::HTTP.new(uri.host, uri.port)
+        @agent.use_ssl = uri.scheme == "https"
+      end
+
+      def resolve_one(flag:, context: {}, apply: true)
+        result = resolve(flags: [flag], context: context, apply: apply)
+        if result.empty?
+          raise FlagNotFoundError.new("No active flag '#{flag}' found was found")
+        end
+        result = result[0]
+        if result.flag != flag
+          raise FlagNotFoundError.new("Unexpected flag '#{flag}' from remote")
+        end
+        result
+      end
+
+      def resolve(flags: [], context: {}, apply: true)
+        result = post_json("/v1/flags:resolve", {
+          clientSecret: @client_secret,
+          evaluationContext: context || {},
+          apply: apply,
+          flags: flags,
+          sdk: {id: "SDK_ID_PYTHON_PROVIDER", version: VERSION}
+        })
+
+        resolved_flags = result["resolvedFlags"] || []
+        resolved_flags.map do |flag|
+          ResolvedFlag.new(
+            flag: flag["flag"],
+            variant: nil_if_empty(flag["variant"]),
+            value: nil_if_empty(flag["value"])
+          )
+        end
+      end
+
+      private
+
+      def post_json(path, body)
+        headers = {"Content-Type" => "application/json"}
+        request = Net::HTTP::Post.new(path, headers)
+        request.body = JSON.dump(body)
+        response = @agent.request(request)
+
+        code = response.code.to_i
+        if code != 200
+          raise APIError.new("flags:resolve HTTP #{response.code} #{response.message}")
+        end
+
+        begin
+          JSON.parse(response.body)
+        rescue JSON::ParserError => ex
+          raise APIError.new("flags:resolve malformed JSON: #{ex}")
+        end
+      end
+
+      def nil_if_empty(value)
+        (value.nil? || value == "") ? nil : value
+      end
+    end
+
+    ResolvedFlag = Struct.new(:flag, :variant, :value, keyword_init: true) do
+      def empty?
+        variant.nil? || value.nil?
+      end
+    end
+  end
+end
+
+if __FILE__ == $0
+  require "optparse"
+  context = {}
+  secret = nil
+  OptionParser.new do |opts|
+    opts.on("--secret=VALUE") do |v|
+      secret = v
+    end
+    opts.on("--context=VALUE") do |v|
+      context.merge!(JSON.parse(v))
+    end
+    opts.on("--targeting_key=VALUE") do |v|
+      context["targeting_key"] = v
+    end
+  end.parse!
+
+  client = Confidence::OpenFeature::APIClient.new(client_secret: secret)
+  client.resolve(flags: ARGV, context: context).each do |flag|
+    puts flag.to_h
+  end
+end

data/lib/confidence/openfeature/errors.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Confidence
+  module OpenFeature
+    class BaseError < StandardError
+    end
+
+    class APIError < BaseError
+    end
+
+    class FlagNotFoundError < BaseError
+    end
+
+    class TypeMismatchError < BaseError
+    end
+  end
+end

data/lib/confidence/openfeature/provider.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+require_relative "api_client"
+require "open_feature/sdk"
+
+module Confidence
+  module OpenFeature
+    # See NoOpProvider in the OpenFeature Ruby SDK for the interface
+    class Provider
+      attr_reader :metadata
+
+      # Error_code and error_message seemingly not used by OpenFeature SDK.
+      # Including here for compatibility.
+      ResolutionDetails = Struct.new(
+        :value, :reason, :variant, :error_code, :error_message,
+        keyword_init: true
+      )
+
+      def initialize(api_client:, apply_on_resolve: true)
+        @api_client = api_client
+        @apply_on_resolve = apply_on_resolve
+        @metadata = ::OpenFeature::SDK::Provider::ProviderMetadata.new(name: "Confidence").freeze
+      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,
+          validator: lambda { |v| (v === true || v === false) }
+        )
+      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,
+          validator: lambda { |v| v.is_a?(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,
+          validator: lambda { |v| v.is_a?(Numeric) }
+        )
+      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
+        )
+      end
+
+      private
+
+      def evaluate(flag_key:, default_value:, evaluation_context: nil, validator: nil)
+        parts = flag_key.split(".")
+        flag_id = parts.shift
+        value_path = parts
+        context = context_hash(evaluation_context)
+
+        result = @api_client.resolve_one(
+          flag: "flags/#{flag_id}",
+          context: context,
+          apply: @apply_on_resolve
+        )
+        if result.empty?
+          return ResolutionDetails.new(
+            value: default_value,
+            reason: "DEFAULT"
+          )
+        end
+
+        value = value_at_path(flag_key, result.value, value_path)
+        if !value.nil? && validator && !validator.call(value)
+          raise TypeMismatchError.new("value did not match expected type")
+        end
+        value = default_value if value.nil?
+
+        ResolutionDetails.new(
+          value: value,
+          variant: Confidence::OpenFeature.parse_variant(result.variant),
+          reason: "TARGETING_MATCH"
+        )
+      end
+
+      def value_at_path(flag, value, path)
+        return value if path.empty?
+        the_value = value
+        path.each do |key|
+          if the_value.is_a?(Hash) && the_value.has_key?(key)
+            the_value = the_value[key]
+          else
+            raise TypeMismatchError.new("#{flag}: invalid path: #{path.join(".")}")
+          end
+        end
+        the_value
+      end
+
+      def context_hash(evaluation_context)
+        return {} if evaluation_context.nil?
+
+        # In SDK 0.4+, EvaluationContext stores all fields in a hash
+        # targeting_key is a special field that can be accessed via .targeting_key
+        evaluation_context.fields.dup
+      end
+    end
+
+    def self.parse_variant(value)
+      components = value.split("/", 4)
+      if components.length != 4 || components[0] != "flags" || components[2] != "variants"
+        raise ArgumentError.new("Invalid variant name: #{value}")
+      end
+      components[3]
+    end
+  end
+end

data/lib/confidence/openfeature/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Confidence
+  module OpenFeature
+    VERSION = "0.1.0" # x-release-please-version
+  end
+end

data/lib/confidence/openfeature.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require_relative "openfeature/api_client"
+require_relative "openfeature/errors"
+require_relative "openfeature/provider"
+require_relative "openfeature/version"

metadata

@@ -0,0 +1,165 @@
+--- !ruby/object:Gem::Specification
+name: confidence-openfeature-provider
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Confidence Team
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-11-12 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.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: openssl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.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.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.12.0
+- !ruby/object:Gem::Dependency
+  name: standard
+  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.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.22.0
+- !ruby/object:Gem::Dependency
+  name: simplecov-cobertura
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+description:
+email:
+- TBD@TBD.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/confidence/openfeature.rb
+- lib/confidence/openfeature/api_client.rb
+- lib/confidence/openfeature/errors.rb
+- lib/confidence/openfeature/provider.rb
+- lib/confidence/openfeature/version.rb
+homepage: https://github.com/spotify/confidence-openfeature-provider-ruby
+licenses:
+- Apache-2.0'
+metadata:
+  homepage_uri: https://github.com/spotify/confidence-openfeature-provider-ruby
+  source_code_uri: https://github.com/spotify/confidence-openfeature-provider-ruby
+  changelog_uri: https://github.com/spotify/confidence-openfeature-provider-ruby/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/spotify/confidence-openfeature-provider-ruby/issues
+  documentation_uri: https://github.com/spotify/confidence-openfeature-provider-ruby/README.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Confidence provider for the OpenFeature SDK
+test_files: []