mixpanel-ruby-openfeature 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c55b0da96c5ff5418242aa05d02ace4cc3df3f56045ea320aa076f1e3d714191
+  data.tar.gz: 4ed81d9dd91eb0be8b1bb1c6fdb77107189c20ace63b47d387d1cda02799d4be
+SHA512:
+  metadata.gz: 4a69d07836c9366924801df9d947b7e3c6d4a2c62376d66e23a5404db49feefff4b4d80a9156c7fc25e566e1e57c7f8dcaba035391a234f67027501998a17f9b
+  data.tar.gz: 7056a897f579fbae9f1261289a8a7178a1b6bd35952bcb67312dbf803fa9d630621d05eed5f7d2739d5a00791e54f1b13ce5a456b3faf16e859cc9ca0dea07a0

data/lib/mixpanel/openfeature/provider.rb

@@ -0,0 +1,170 @@
+# frozen_string_literal: true
+
+require 'open_feature/sdk'
+
+module Mixpanel
+  module OpenFeature
+    class Provider
+      attr_reader :metadata, :mixpanel
+
+      def self.from_local(token, config, error_handler: nil)
+        tracker = ::Mixpanel::Tracker.new(token, error_handler, local_flags_config: config)
+        flags_provider = tracker.local_flags
+        flags_provider.start_polling_for_definitions!
+        provider = new(flags_provider)
+        provider.instance_variable_set(:@mixpanel, tracker)
+        provider
+      end
+
+      def self.from_remote(token, config, error_handler: nil)
+        tracker = ::Mixpanel::Tracker.new(token, error_handler, remote_flags_config: config)
+        flags_provider = tracker.remote_flags
+        provider = new(flags_provider)
+        provider.instance_variable_set(:@mixpanel, tracker)
+        provider
+      end
+
+      def initialize(flags_provider)
+        @flags_provider = flags_provider
+        @metadata = ::OpenFeature::SDK::Provider::ProviderMetadata.new(name: 'mixpanel-provider').freeze
+      end
+
+      def shutdown
+        @flags_provider.shutdown if @flags_provider.respond_to?(:shutdown)
+      end
+
+      def fetch_boolean_value(flag_key:, default_value:, evaluation_context: nil)
+        resolve(flag_key, default_value, :boolean, evaluation_context)
+      end
+
+      def fetch_string_value(flag_key:, default_value:, evaluation_context: nil)
+        resolve(flag_key, default_value, :string, evaluation_context)
+      end
+
+      def fetch_number_value(flag_key:, default_value:, evaluation_context: nil)
+        resolve(flag_key, default_value, :number, evaluation_context)
+      end
+
+      def fetch_integer_value(flag_key:, default_value:, evaluation_context: nil)
+        resolve(flag_key, default_value, :integer, evaluation_context)
+      end
+
+      def fetch_float_value(flag_key:, default_value:, evaluation_context: nil)
+        resolve(flag_key, default_value, :float, evaluation_context)
+      end
+
+      def fetch_object_value(flag_key:, default_value:, evaluation_context: nil)
+        resolve(flag_key, default_value, :object, evaluation_context)
+      end
+
+      private
+
+      def resolve(flag_key, default_value, expected_type, evaluation_context)
+        unless flags_ready?
+          return error_result(default_value, ::OpenFeature::SDK::Provider::ErrorCode::PROVIDER_NOT_READY)
+        end
+
+        context = build_context(evaluation_context)
+        fallback = ::Mixpanel::Flags::SelectedVariant.new(variant_value: default_value)
+
+        begin
+          result = @flags_provider.get_variant(flag_key, fallback, context, report_exposure: true)
+        rescue StandardError
+          return error_result(default_value, ::OpenFeature::SDK::Provider::ErrorCode::GENERAL)
+        end
+
+        if result.equal?(fallback)
+          return ::OpenFeature::SDK::Provider::ResolutionDetails.new(
+            value: default_value,
+            error_code: ::OpenFeature::SDK::Provider::ErrorCode::FLAG_NOT_FOUND,
+            reason: ::OpenFeature::SDK::Provider::Reason::DEFAULT
+          )
+        end
+
+        value = result.variant_value
+
+        if value.nil? && expected_type != :object
+          return error_result(default_value, ::OpenFeature::SDK::Provider::ErrorCode::TYPE_MISMATCH)
+        end
+
+        coerced = coerce_value(value, expected_type)
+        if coerced.nil? && !value.nil?
+          return error_result(default_value, ::OpenFeature::SDK::Provider::ErrorCode::TYPE_MISMATCH)
+        end
+
+        ::OpenFeature::SDK::Provider::ResolutionDetails.new(
+          value: coerced.nil? ? value : coerced,
+          variant: result.variant_key,
+          reason: ::OpenFeature::SDK::Provider::Reason::TARGETING_MATCH
+        )
+      end
+
+      def coerce_value(value, expected_type)
+        case expected_type
+        when :boolean
+          value == true || value == false ? value : nil
+        when :string
+          value.is_a?(String) ? value : nil
+        when :integer
+          if value.is_a?(Integer)
+            value
+          elsif value.is_a?(Float) && value.finite? && value == value.floor
+            value.to_i
+          end
+        when :float
+          if value.is_a?(Float)
+            value
+          elsif value.is_a?(Integer)
+            value.to_f
+          end
+        when :number
+          value.is_a?(Numeric) ? value : nil
+        when :object
+          value
+        end
+      end
+
+      def build_context(evaluation_context)
+        return {} if evaluation_context.nil?
+
+        ctx = {}
+        if evaluation_context.respond_to?(:fields)
+          evaluation_context.fields.each { |k, v| ctx[k] = unwrap_value(v) }
+        end
+        if evaluation_context.respond_to?(:targeting_key) && evaluation_context.targeting_key
+          ctx['targetingKey'] = unwrap_value(evaluation_context.targeting_key)
+        end
+        ctx
+      end
+
+      def unwrap_value(value)
+        case value
+        when Float
+          value.finite? && value == value.floor ? value.to_i : value
+        when Array
+          value.map { |v| unwrap_value(v) }
+        when Hash
+          value.transform_values { |v| unwrap_value(v) }
+        else
+          value
+        end
+      end
+
+      def flags_ready?
+        if @flags_provider.respond_to?(:are_flags_ready)
+          @flags_provider.are_flags_ready
+        else
+          true
+        end
+      end
+
+      def error_result(default_value, error_code)
+        ::OpenFeature::SDK::Provider::ResolutionDetails.new(
+          value: default_value,
+          error_code: error_code,
+          reason: ::OpenFeature::SDK::Provider::Reason::ERROR
+        )
+      end
+    end
+  end
+end

data/lib/mixpanel/openfeature.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'openfeature/provider'

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification
+name: mixpanel-ruby-openfeature
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Mixpanel
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-04-09 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.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: mixpanel-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  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-cobertura
+  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: An OpenFeature provider that wraps the Mixpanel Ruby SDK feature flags
+email: support@mixpanel.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/mixpanel/openfeature.rb
+- lib/mixpanel/openfeature/provider.rb
+homepage: https://mixpanel.com
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+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: OpenFeature provider for Mixpanel feature flags
+test_files: []