subflag-openfeature-provider 0.1.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40e8537098d52a561735926123fc60c1ad200f3762151588e101f815447cf822
-  data.tar.gz: 42821e1d8a10786803898a2d17d1c82002f24a314351cb3b61aa7b43c0cca2ba
+  metadata.gz: 9914622ce4a7e664e18441f4c979ad8c9a9f90a9335efc437523b1695fa0823d
+  data.tar.gz: a1b4dd15bd439397c2da8b38c90b8f81e98d4de040189c8b68e62a68e202ec3a
 SHA512:
-  metadata.gz: 8ae9b2658c93632d4cbcbee3af96c27fccda6c099f8f144a225b79961298f5851f7757c7404583bc235fc643f510ce0175fb579def7ebf285f9d97bb3f14cf67
-  data.tar.gz: e59f3c5b24a9a3f18fad1ceb09fb1d0dda9084f355abfd8d2862f3da81fcf4dc564dbf7143cbfa4fc948482a0efe69c8a94444f1b47c19d076ba5c0605fd0cd4
+  metadata.gz: e1a8d3e652e1c54d5154e14d2e7ac6a2701e64868c25ad119f91bec8783274f1bbc530e43f898b2b6b627deed2e15f5d3010053c9994ebbba1cf59848b43c238
+  data.tar.gz: 94e5f871a6485caa293980078c29a06c33aad49eecdd4409a846b4288d021a6eaf728b0ea85a577f83d6eacf8ebf172e9185417fbcdcef7dc7e50280e2c348b5

data/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.3.1] - 2025-12-07
+
+### Fixed
+
+- `EvaluationResult.from_response` now accepts both camelCase (API format) and snake_case (Ruby format) keys, making `to_h` output compatible with `from_response`
+
+## [0.2.1] - 2025-11-30
+
+### Fixed
+
+- Fixed Gemfile.lock sync issue
+
+## [0.2.0] - 2025-11-30
+
+### Changed
+
+- **Breaking**: Provider now returns `OpenFeature::SDK::Provider::ResolutionDetails` instead of plain Hash
+- Added `require "open_feature/sdk"` for proper SDK integration
+
+### Fixed
+
+- Fixed compatibility with OpenFeature Ruby SDK 0.4.x
+
+## [0.1.0] - 2025-11-30
+
+### Added
+
+- Initial release
+- OpenFeature provider implementation for Subflag
+- Support for boolean, string, integer, float, and object flag types
+- Evaluation context support with targeting key
+- Error handling with proper OpenFeature error codes
+- Direct client usage without OpenFeature SDK

data/README.md

@@ -19,7 +19,7 @@ bundle add subflag-openfeature-provider
 ### With OpenFeature SDK
 
 ```ruby
-require "openfeature/sdk"
+require "open_feature/sdk"
 require "subflag"
 
 # Configure the provider

data/lib/subflag/evaluation_result.rb

@@ -13,17 +13,22 @@ module Subflag
       ERROR
     ].freeze
 
-    attr_reader :flag_key, :value, :variant, :reason
+    # Valid flag statuses
+    FLAG_STATUSES = %w[ACTIVE DEPRECATED].freeze
+
+    attr_reader :flag_key, :value, :variant, :reason, :flag_status
 
     # @param flag_key [String] The key of the evaluated flag
     # @param value [Object] The evaluated value (type depends on flag configuration)
     # @param variant [String] The name of the selected variant
     # @param reason [String] Why this value was selected (one of REASONS)
-    def initialize(flag_key:, value:, variant:, reason:)
+    # @param flag_status [String, nil] Lifecycle status of the flag (ACTIVE, DEPRECATED)
+    def initialize(flag_key:, value:, variant:, reason:, flag_status: nil)
       @flag_key = flag_key
       @value = value
       @variant = variant
       @reason = reason
+      @flag_status = flag_status
     end
 
     # Create from API response hash
@@ -34,14 +39,23 @@ module Subflag
         flag_key: fetch_key(data, "flagKey"),
         value: fetch_key(data, "value"),
         variant: fetch_key(data, "variant"),
-        reason: fetch_key(data, "reason")
+        reason: fetch_key(data, "reason"),
+        flag_status: fetch_key(data, "flagStatus")
       )
     end
 
-    # Fetch a key from hash, checking both string and symbol keys
+    # Fetch a key from hash, checking string, symbol, and snake_case variants
     # Can't use || because false values would be skipped
     def self.fetch_key(data, key)
-      data.key?(key) ? data[key] : data[key.to_sym]
+      # Try camelCase string (API format)
+      return data[key] if data.key?(key)
+      # Try camelCase symbol
+      return data[key.to_sym] if data.key?(key.to_sym)
+      # Try snake_case symbol (from to_h)
+      snake_key = key.gsub(/([a-z])([A-Z])/, '\1_\2').downcase.to_sym
+      return data[snake_key] if data.key?(snake_key)
+      # Try snake_case string
+      data[snake_key.to_s]
     end
 
     # Check if evaluation was successful (not an error)
@@ -50,6 +64,12 @@ module Subflag
       reason != "ERROR"
     end
 
+    # Check if the flag is deprecated
+    # @return [Boolean]
+    def deprecated?
+      @flag_status == "DEPRECATED"
+    end
+
     # Convert to hash
     # @return [Hash]
     def to_h
@@ -57,7 +77,8 @@ module Subflag
         flag_key: @flag_key,
         value: @value,
         variant: @variant,
-        reason: @reason
+        reason: @reason,
+        flag_status: @flag_status
       }
     end
   end

data/lib/subflag/provider.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "open_feature/sdk"
+
 module Subflag
   # OpenFeature provider for Subflag feature flag management.
   #
@@ -124,6 +126,9 @@ module Subflag
       context = EvaluationContext.from_openfeature(evaluation_context)
       result = @client.evaluate(flag_key, context: context)
 
+      # Warn if flag is deprecated
+      warn_if_deprecated(result)
+
       # Validate type matches
       unless type_matches?(result.value, expected_type)
         return error_result(
@@ -136,12 +141,12 @@ module Subflag
       # Convert value if needed (e.g., number -> integer)
       converted_value = convert_value(result.value, expected_type)
 
-      {
+      OpenFeature::SDK::Provider::ResolutionDetails.new(
         value: converted_value,
         reason: map_reason(result.reason),
         variant: result.variant,
         flag_metadata: { flag_key: result.flag_key }
-      }
+      )
     rescue FlagNotFoundError => e
       error_result(default_value, error_code: :flag_not_found, error_message: e.message)
     rescue AuthenticationError => e
@@ -200,14 +205,22 @@ module Subflag
       end
     end
 
-    # Build error result hash
+    # Build error result
     def error_result(default_value, error_code:, error_message:)
-      {
+      OpenFeature::SDK::Provider::ResolutionDetails.new(
         value: default_value,
         reason: :error,
         error_code: error_code,
         error_message: error_message
-      }
+      )
+    end
+
+    # Log a warning if the flag is deprecated
+    def warn_if_deprecated(result)
+      return unless result.deprecated?
+
+      warn "[Subflag] Flag \"#{result.flag_key}\" is deprecated and scheduled for removal. " \
+           "Please migrate away from this flag."
     end
   end
 end

data/lib/subflag/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Subflag
-  VERSION = "0.1.0"
+  VERSION = "0.3.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: subflag-openfeature-provider
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Subflag
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-30 00:00:00.000000000 Z
+date: 2025-12-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -132,6 +132,7 @@ files:
 - ".rspec"
 - ".rspec_status"
 - ".rubocop.yml"
+- CHANGELOG.md
 - README.md
 - Rakefile
 - lib/subflag.rb