quonfig-openfeature 1.1.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 518ef7e90608d00dc60292d93fa9c9b6a14037df9194597a1cc309a4c02ea166
-  data.tar.gz: bc52ae8cda109bd7aa20dcc5e0a235716a503d497987d4000d45a97ae6541bba
+  metadata.gz: 20da9ec1d24f20fa576a6430d8cd765b6d821a2cc052e0bfb8f59a5511b8447a
+  data.tar.gz: 333ea7e9395c479af7e7768bdb256c79860e7c495e009e9c51e8d14af51807e4
 SHA512:
-  metadata.gz: '080feecf4971e26beff1c05427d6ffa0d9c494c26696968502ae7fe8ea462e6eb770a1a57d6486bf8d39093133902b8672cebea3f3f4cd3fc4a92ed0355ba5ae'
-  data.tar.gz: e783174efaa4e7c8577259bec7ebaa7ccc3eb1f900a844fed68e1449cabffeada4b2925fc5d650f15c51c52d27da35a79380bec8d716e6cf4259bd4f5d93ee6b
+  metadata.gz: b3319e1dbd57f6bcfa125befb424e8c2f811dc3c01f921b94c3426a0e62eed5f3ab100a49c372236e68adaa1fde3ca5d259d55af09800c40e0a4043393915c2d
+  data.tar.gz: 5cc0aecc4fcd057d426ae31381572bb27e97160dea9e154cc84e85bf668849618d5a2def62c950f3713353aef3c6f1d0c8e386055bcc35cd58b0affd1e3e0321

data/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## 2.0.0 - 2026-10-27
+
+**BREAKING / UPGRADE (major, qfg-zvyy.6).** This release tracks sdk-ruby 2.0.0, the cross-SDK
+typed-getter contract. Require `quonfig` (sdk-ruby) `>= 2.0.0` (floor raised from `>= 1.11.0`). No
+change to this provider's code: it passes through the SDK's `*_details` results, so provider users
+inherit the contract below.
+
+### UPGRADE to 2.0
+
+A value a `fetch_*` method cannot read as its type returns your default with reason `ERROR` and
+error code `TYPE_MISMATCH`. Strings are never coerced, and the only number conversions are exact
+ones. What changes for provider users:
+
+- `fetch_float_value` on an int config now returns the value (`30` -> `30.0`). 1.x returned your
+  default with `TYPE_MISMATCH`.
+- `fetch_integer_value` on a double config returns the value when it is whole and within
+  +/-(2^53-1) (`3.0` -> `3`). 1.x returned your default for every double. `3.9`, `2^53` and `1e300`
+  still return your default with `TYPE_MISMATCH`, never truncated.
+- `fetch_number_value` on a `duration` config returns your default with `TYPE_MISMATCH`. 1.x
+  returned the duration in milliseconds (`30000`, reason `STATIC`). Durations are native-only: use
+  `provider.client.get_duration` (integer milliseconds). `fetch_float_value` on a duration already
+  returned your default.
+- A malformed stored int or double (for example `"twelve"`) or a malformed ENV_VAR value returns
+  your default with error code `TYPE_MISMATCH`, as in sdk-go. 1.x reported `GENERAL`. An unset
+  ENV_VAR still returns your default with `GENERAL`.
+- sdk-ruby logs one WARN per key per client when a read returns your default because of a type
+  mismatch, a malformed value, an unset ENV_VAR or a decryption failure. The line names the key and
+  types, never the value. A wrong decryption key now degrades to your defaults with these WARNs.
+- If you call the native client via `provider.client`: typed getters with a `default:` return the
+  default instead of raising, `enabled?` is true only for the bool `true` and never raises, and
+  `get_bool` on a stored string `"true"` is a type mismatch. See the sdk-ruby CHANGELOG
+  "UPGRADE to 2.0".
+
+These already held under 1.11.0 through the provider, and the new tests now pin them: a stored
+string `"true"` / `"false"` read as a boolean, a stored `"3"` read as a number, an int or bool read as
+a string, an int read as a boolean, and a string or bool read as an object all return your default
+with `TYPE_MISMATCH`.
+
+### Tests
+
+- New `test/integration/test_typed_getter_contract.rb` (31 tests) drives the real provider through
+  the OpenFeature client against the integration-test-data `getter.contract.*` fixtures. 7 of the 31
+  fail on sdk-ruby 1.11.0; all pass on 2.0.0.
+
 ## 1.1.0 - 2026-10-23
 
 - **UPGRADE: raise the `quonfig` floor from `>= 1.10.0` to `>= 1.11.0`. Requires sdk-ruby 1.11.0:

data/README.md

@@ -134,13 +134,30 @@ 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** -- exposed only via the native `get_duration` (returns milliseconds).
+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`.
 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.
 7. **`targeting_key` maps to `user.id` by default** -- configure
    `targeting_key_mapping` if you target a different namespace.
 
+## Typed reads
+
+Each `fetch_*` method reads only values of its type (the cross-SDK typed-getter contract,
+`quonfig` >= 2.0.0). A value of another type returns your default with reason `ERROR` and error
+code `TYPE_MISMATCH`:
+
+- A stored string is never coerced: `"false"` is not a boolean and `"3"` is not a number.
+- Numbers convert only when exact: `fetch_float_value` on an int config returns `30.0`, and
+  `fetch_integer_value` on a double config returns the value only when it is whole and within
+  +/-(2^53-1) (`3.0` -> `3`; `3.9` is a mismatch, never truncated).
+- A malformed stored or ENV_VAR value (an int `"twelve"`) also returns your default with
+  `TYPE_MISMATCH`. An unset ENV_VAR returns your default with `GENERAL`.
+
+sdk-ruby logs one WARN per key when a read returns your default for one of these reasons.
+
 ## Offline / test mode
 
 Pass `datadir:` to evaluate against a Quonfig workspace on disk -- the same

data/VERSION

@@ -1 +1 @@
-1.1.0
+2.0.0

metadata

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