quonfig-openfeature 2.1.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd942b88517b56c8ff6d676684e0f1c27fbd5fd62c96c15964af1239d0ac2fe6
-  data.tar.gz: bff802046f4d1ec5c0422e93f7c13a28edeb98178f2703354511976dc4c3384e
+  metadata.gz: 43b628f81214e3ced11ab61bcce6a2a84d9dfe8abd1aaec2f90590466c8b5b5c
+  data.tar.gz: 53464b81651916ed49c83ed88a95a94829e278ccbff56bfaa5236c4e89ab56a0
 SHA512:
-  metadata.gz: 57db850f4f8384be2cc8b47e690ff363876d9ab51a5c7e80468880b3cf9b4607b7263f9081b965feef1dc6cc3e3c0594180153cb67cf9a5317fb7025562e70a9
-  data.tar.gz: 56bb8b4420465725dd15303de581c254abae3d5f27a98205463dbed394f9cc9848ae47c61d97f7ac89962d707fa35ae8ed6d8c05fb66c2f9e0a50050c434123f
+  metadata.gz: 2db151d762fa6ae6be9c4197790153deba4b3a083b66101d24524de19c19952fbe6ba247dbf70a3504137c7c9c66243d3f6a144e6a6f8e97ef015352dea484b8
+  data.tar.gz: f8434a2390cfd3d55848383562b874d2fd81e1353247df49c35262a76bed642e09d2adcca9c0fe5daf859fed4b3bd5c3c55321e661f9c997a2f19784feddc7f7

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 2.3.0 - 2026-10-29
+
+When sdk-ruby reports error code `PARSE_ERROR` for a value that did not parse (qfg-wg1n), the
+provider now returns it as OpenFeature `PARSE_ERROR` in one read: your default, reason `ERROR`, and
+the SDK's message, variant and flag metadata. Before, an SDK `PARSE_ERROR` came back as `GENERAL`.
+
+Nothing changes with the sdk-ruby you run today. sdk-ruby 2.1.0 reports a malformed value as
+`TYPE_MISMATCH`, and the provider still tells the two apart as in 2.1.0: it checks the stored
+`valueType` and reads the config again with the getter for that type. The `quonfig` floor stays
+`>= 2.1.0`.
+
+## 2.2.0 - 2026-10-29
+
+`fetch_string_value` on a `duration` config returns its stored ISO 8601 text again (reason
+`STATIC`), as in openfeature-go and the shared OpenFeature cases (qfg-177f). The text comes back
+unchanged: `"PT90S"` stays `"PT90S"`, not `"PT1M30S"`. 2.x returned your default with
+`TYPE_MISMATCH`. Number reads of a duration still return your default. A malformed stored duration
+such as `"30s"` still returns your default with `PARSE_ERROR`, and so does a duration ENV_VAR set
+to a malformed value.
+
+Requires quonfig (sdk-ruby) 2.1.0: the text is read with its new public `evaluate_details`, in one
+evaluation, and checked against the shared duration grammar with `Quonfig::Duration.valid?`.
+
 ## 2.1.0 - 2026-10-28
 
 A malformed value now resolves with error code `PARSE_ERROR` instead of `TYPE_MISMATCH`

data/README.md

@@ -134,9 +134,9 @@ Quonfig features require the native `quonfig` SDK:
 
 1. **Log levels** -- `should_log?` and the `semantic_logger_filter` are native-only.
 2. **`string_list` configs** -- accessed via `fetch_object_value` and used as `Array<String>`.
-3. **`duration` configs** -- native-only: read them with `provider.client.get_duration` (integer
-   milliseconds). `fetch_float_value` and `fetch_number_value` on a duration config return your
-   default with `TYPE_MISMATCH`.
+3. **`duration` configs** -- `fetch_string_value` returns the stored ISO 8601 text unchanged
+   (`"PT90S"`). For integer milliseconds use `provider.client.get_duration`. `fetch_float_value`
+   and `fetch_number_value` on a duration config return your default with `TYPE_MISMATCH`.
 4. **`bytes` configs** -- not accessible via OpenFeature (no binary type in OF).
 5. **`keys` / raw config inspection** -- native-only via `provider.client`.
 6. **Context keys use dot-notation** -- `"user.email"`, not nested hashes.

data/VERSION

@@ -1 +1 @@
-2.1.0
+2.3.0

data/lib/quonfig/openfeature/provider.rb

@@ -80,7 +80,12 @@ module Quonfig
         'string_list' => :get_string_list_details,
         'json' => :get_json_details
       }.freeze
-      private_constant :READABLE_VALUE_TYPES, :NATIVE_DETAILS_GETTER
+      # sdk-ruby's error code for a value that did not parse (a malformed
+      # stored value or ENV_VAR value, qfg-wg1n). Matched as a string: the
+      # quonfig floor (2.1.0) defines no constant for it and never emits it,
+      # so with that SDK the TYPE_MISMATCH re-read in #malformed? still applies.
+      SDK_PARSE_ERROR = 'PARSE_ERROR'
+      private_constant :READABLE_VALUE_TYPES, :NATIVE_DETAILS_GETTER, :SDK_PARSE_ERROR
 
       attr_reader :metadata, :targeting_key_mapping
 
@@ -148,8 +153,12 @@ module Quonfig
         end
       end
 
+      # A +duration+ config reads as its stored ISO 8601 text, unchanged
+      # ("PT90S" stays "PT90S"): OpenFeature has no duration type (qfg-177f).
       def fetch_string_value(flag_key:, default_value:, evaluation_context: nil)
         evaluate(flag_key, default_value, evaluation_context) do |client, mapped_ctx|
+          next duration_iso_resolution(client, flag_key, mapped_ctx, default_value) if stored_value_type(client, flag_key) == 'duration'
+
           details = client.get_string_details(flag_key, context: mapped_ctx)
           to_resolution(details, default_value, parse_error: malformed?(client, flag_key, mapped_ctx, :string, details))
         end
@@ -247,6 +256,38 @@ module Quonfig
         native.error_code == ::Quonfig::EvaluationDetails::ERROR_TYPE_MISMATCH
       end
 
+      # Read a duration config as its ISO 8601 text with one evaluation:
+      # sdk-ruby's evaluate_details (quonfig >= 2.1.0) returns the resolved
+      # value in stored form, so the text is the stored text, or an ENV_VAR's
+      # text for a provided duration. evaluate_details does no type check, so
+      # the text is validated here with Quonfig::Duration.valid?, the grammar
+      # get_duration uses:
+      #
+      #   * valid text: the text, with the evaluation's reason, variant and
+      #     flag_metadata.
+      #   * malformed stored text ("30s"): the default with PARSE_ERROR.
+      #   * malformed ENV_VAR: evaluate_details reports ERROR / TYPE_MISMATCH,
+      #     which on a duration config can only mean a value that did not
+      #     parse, so it is PARSE_ERROR too.
+      #   * the structured { seconds, nanos } shape has no ISO text: the
+      #     default with TYPE_MISMATCH.
+      def duration_iso_resolution(client, flag_key, mapped_ctx, default_value)
+        details = client.evaluate_details(flag_key, context: mapped_ctx)
+        if details.reason == ::Quonfig::EvaluationDetails::REASON_ERROR
+          parse_error = details.error_code == ::Quonfig::EvaluationDetails::ERROR_TYPE_MISMATCH
+          return to_resolution(details, default_value, parse_error: parse_error)
+        end
+        return to_resolution(details, default_value) if details.reason == ::Quonfig::EvaluationDetails::REASON_DEFAULT
+
+        value = details.value
+        return to_resolution(details, default_value) if value.is_a?(String) && ::Quonfig::Duration.valid?(value)
+
+        error_code = value.is_a?(String) ? ErrorCode::PARSE_ERROR : ErrorCode::TYPE_MISMATCH
+        ResolutionDetails.new(value: default_value, reason: Reason::ERROR, error_code: error_code,
+                              error_message: "duration #{flag_key.inspect} has no valid ISO 8601 text",
+                              variant: details.variant, flag_metadata: details.flag_metadata || {})
+      end
+
       def stored_value_type(client, flag_key)
         config = client.store.get(flag_key)
         return nil unless config.is_a?(Hash)
@@ -257,7 +298,8 @@ module Quonfig
       # Map a Quonfig::EvaluationDetails to the OpenFeature ResolutionDetails
       # the SDK consumes. The Quonfig SDK's *_details methods don't raise, so
       # this is a pure mapping layer. +parse_error+ reports an ERROR as
-      # PARSE_ERROR (see #malformed?).
+      # PARSE_ERROR (see #malformed?); an SDK PARSE_ERROR passes straight
+      # through in #map_error_code.
       def to_resolution(details, default_value, parse_error: false)
         variant = details.variant
         flag_metadata = details.flag_metadata || {}
@@ -302,6 +344,7 @@ module Quonfig
         when ::Quonfig::EvaluationDetails::ERROR_FLAG_NOT_FOUND then ErrorCode::FLAG_NOT_FOUND
         when ::Quonfig::EvaluationDetails::ERROR_TYPE_MISMATCH  then ErrorCode::TYPE_MISMATCH
         when ::Quonfig::EvaluationDetails::ERROR_PROVIDER_NOT_READY then ErrorCode::PROVIDER_NOT_READY
+        when SDK_PARSE_ERROR then ErrorCode::PARSE_ERROR
         else ErrorCode::GENERAL
         end
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: quonfig-openfeature
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.3.0
 platform: ruby
 authors:
 - Jeff Dwyer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-28 00:00:00.000000000 Z
+date: 2026-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: openfeature-sdk
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 2.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 2.1.0
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement