toggly 1.1.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d728557cdb56574a22377e85047ec649a801532f9cea3574ae66ccba703e320e
-  data.tar.gz: 5054b15ad5ad1b48fde5c6fb174698c701bd8fa38b6054cc8afd6ff015e196ce
+  metadata.gz: a484fa27dd7cc53210f2af73984c93d9109205f797172203aea42c44c4722569
+  data.tar.gz: 79a64ed42c9497e8ce8ca0f59d4dc3c21e52e68ba5e24b3b76680767d2a4787b
 SHA512:
-  metadata.gz: 8871e715209c606026d37367ec46522c3bbcc7925633f9f511bad51179f141924cb4b7e123978212e1a1697050072d0bfacff0463e53cf02510012cb28531db1
-  data.tar.gz: c3536488d775b49aeefa375f72f3c6b88a993fb4b6464a19e8c5ae73bde75222c310bc820e563f94039509bd6dbbc698ddb04c33cd89de6beba2e7c1ac29dd56
+  metadata.gz: 07f924fb8addc26c7af35f31f0a023680201f097cfa6b26826c333a2dc3a2086c07ae094ca23413daf176546a886dbd39598914a79c0ae6cd35c8c0aeb5df564
+  data.tar.gz: 353559ba9d83853a589d843f01b52cbdb9287074b7be77505784515df99b2505317d54225456b7818c210d050b5cd170abe1a8bc315545dad5f534f9a7537244

data/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.1] - 2026-09-28
+
+### Fixed
+
+- Always apply HTTP 200 definition bodies when the storage revision matches.
+  Same-revision responses still count as cache hits for telemetry after the
+  body is applied [OPS-1568].
+
+## [1.2.0] - 2026-09-24
+
+### Added
+
+- Soft-typed `get_variant_value(feature, as: Klass)` (and optional block form).
+  Missing assignment or bind failure returns `nil` — never raises solely for
+  shape mismatch. Untyped `get_variant_value` (no `as:`) is unchanged
+  [OPS-1365].
+
 ## [1.1.0] - 2026-09-23
 
 ### Added

data/lib/toggly/client.rb

@@ -24,6 +24,8 @@ module Toggly
   #   )
   #   client = Toggly::Client.new(config)
   class Client
+    UNHANDLED_VARIANT_VALUE = Object.new.freeze
+
     include CacheTelemetry
     include SnapshotSupport
 
@@ -166,8 +168,13 @@ module Toggly
     # @param feature_key [String, Symbol] The feature key
     # @param context [Context, nil] Optional targeting context (userId + groups)
     # @return [Object, nil]
-    def get_variant_value(feature_key, context: nil)
-      get_variant(feature_key, context: context)&.configuration_value
+    def get_variant_value(feature_key, context: nil, as: nil, &block)
+      value = get_variant(feature_key, context: context)&.configuration_value
+      return value if as.nil? && !block
+
+      return nil if value.nil?
+
+      decode_variant_configuration(value, as, &block)
     end
 
     # Default targeting userId used by {#get_variant} / {#get_variant_value}
@@ -350,6 +357,47 @@ module Toggly
 
     private
 
+    def decode_variant_configuration(value, as, &block)
+      return block.call(value) if block
+      return nil if as.nil?
+
+      scalar_value = decode_scalar_variant_value(value, as)
+      return scalar_value unless scalar_value.equal?(UNHANDLED_VARIANT_VALUE)
+
+      # is_a? requires a Module; symbols like :boolean are handled above.
+      return value if as.is_a?(Module) && value.is_a?(as)
+
+      decode_variant_object(value, as)
+    rescue StandardError
+      nil
+    end
+
+    # Scalars / :boolean before Class#new — String.new({}) would soft-fail to "".
+    def decode_scalar_variant_value(value, as)
+      return value.is_a?(String) ? value : nil if as == String
+      return numeric_variant_value(value, Integer) if as == Integer
+      return numeric_variant_value(value, Float) if as == Float
+      return [true, false].include?(value) ? value : nil if [TrueClass, FalseClass, :boolean].include?(as)
+
+      UNHANDLED_VARIANT_VALUE
+    end
+
+    def numeric_variant_value(value, type)
+      return nil if value.is_a?(TrueClass) || value.is_a?(FalseClass)
+      return value if type == Integer && value.is_a?(Integer)
+      return value.to_f if type == Float && value.is_a?(Numeric)
+
+      nil
+    end
+
+    def decode_variant_object(value, as)
+      return nil unless value.is_a?(Hash)
+      return as.new(**value.transform_keys(&:to_sym)) if as.respond_to?(:new)
+      return as.json_create(value) if as.respond_to?(:json_create)
+
+      nil
+    end
+
     # `definitions` / `definitions-signed` → local rule eval. The sole
     # source of truth for `enabled?`; also carries `variants` / `allocation`
     # for the catalog-local `get_variant` assignment.

data/lib/toggly/definitions_provider.rb

@@ -189,9 +189,11 @@ module Toggly
         log_debug("Definitions not modified")
         FetchResult.new(definitions: nil, cache_outcome: :hit)
       when :same_revision
-        log_debug("Definitions revision matches existing (ETag or Last-Modified)")
-        store_revision_headers(response_etag, response_lm)
-        FetchResult.new(definitions: nil, cache_outcome: :hit)
+        # Same storage revision is a telemetry hit, but HTTP 200 still carries
+        # an authoritative body — apply it (parity with Go/Rust/Python).
+        log_debug("Definitions revision matches existing; applying HTTP 200 body")
+        result = handle_new_content(response, response_etag, response_lm)
+        FetchResult.new(definitions: result.definitions, cache_outcome: :hit)
       when :new_content
         handle_new_content(response, response_etag, response_lm)
       when :error_status

data/lib/toggly/variant_allocator.rb

@@ -112,13 +112,12 @@ module Toggly
       return nil if list.empty?
 
       pct = compute_percentile(identity, seed, feature_key, ignore_case)
-      list.each do |entry|
+      matching_entry = list.find do |entry|
         from = entry[:from].to_f
         to = entry[:to].to_f
-        matched = to >= 100.0 ? pct >= from : (pct >= from && pct < to)
-        return entry[:variant] if matched
+        to >= 100.0 ? pct >= from : (pct >= from && pct < to)
       end
-      nil
+      matching_entry&.fetch(:variant, nil)
     end
 
     # MF-parity percentile hash.

data/lib/toggly/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Toggly
-  VERSION = "1.1.0"
+  VERSION = "1.2.1"
 end

data/lib/toggly.rb

@@ -71,6 +71,8 @@ require_relative "toggly/client"
 #     }
 #   )
 module Toggly
+  NOT_CONFIGURED_ERROR = "Toggly not configured. Call Toggly.configure first."
+
   class << self
     # Global client instance
     attr_accessor :client
@@ -92,7 +94,7 @@ module Toggly
     # @param context [Context, nil] Optional evaluation context
     # @return [Boolean]
     def enabled?(feature_key, context: nil)
-      raise Error, "Toggly not configured. Call Toggly.configure first." unless @client
+      raise Error, NOT_CONFIGURED_ERROR unless @client
 
       @client.enabled?(feature_key, context: context)
     end
@@ -113,7 +115,7 @@ module Toggly
     # @param context [Context, nil]
     # @return [VariantResult, nil]
     def get_variant(feature_key, context: nil)
-      raise Error, "Toggly not configured. Call Toggly.configure first." unless @client
+      raise Error, NOT_CONFIGURED_ERROR unless @client
 
       @client.get_variant(feature_key, context: context)
     end
@@ -123,10 +125,10 @@ module Toggly
     # @param feature_key [String, Symbol]
     # @param context [Context, nil]
     # @return [Object, nil]
-    def get_variant_value(feature_key, context: nil)
-      raise Error, "Toggly not configured. Call Toggly.configure first." unless @client
+    def get_variant_value(feature_key, context: nil, as: nil, &)
+      raise Error, NOT_CONFIGURED_ERROR unless @client
 
-      @client.get_variant_value(feature_key, context: context)
+      @client.get_variant_value(feature_key, context: context, as: as, &)
     end
 
     # Reset the global client (mainly for testing)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: toggly
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Ops.ai
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-24 00:00:00.000000000 Z
+date: 2026-10-04 00:00:00.000000000 Z
 dependencies: []
 description: High-performance Ruby SDK for Toggly feature flag management. Works with
   or without Toggly.io.