toggly 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d728557cdb56574a22377e85047ec649a801532f9cea3574ae66ccba703e320e
-  data.tar.gz: 5054b15ad5ad1b48fde5c6fb174698c701bd8fa38b6054cc8afd6ff015e196ce
+  metadata.gz: 810c3cb9858347a1cb79212512e006bf2362ee97cd09c7a528eb334c0bf949cc
+  data.tar.gz: 7f6ef5ce376a28c1101ce65c1d82080c02e6b254487ed0908479c1a622adffeb
 SHA512:
-  metadata.gz: 8871e715209c606026d37367ec46522c3bbcc7925633f9f511bad51179f141924cb4b7e123978212e1a1697050072d0bfacff0463e53cf02510012cb28531db1
-  data.tar.gz: c3536488d775b49aeefa375f72f3c6b88a993fb4b6464a19e8c5ae73bde75222c310bc820e563f94039509bd6dbbc698ddb04c33cd89de6beba2e7c1ac29dd56
+  metadata.gz: e0c8fbd59c7cfa8baafd73f580da168fe0fe4114e802f0e55bec3c406994e8a4a169b773dbf6e97862f831157d7b011df18f6210cda33740a56a6f515c05fcfc
+  data.tar.gz: 92d791902d6bf591f9731647caa1963b2c589bf12255afe376b1f1fa9591437d9af10388503b54bbbf06e911afb41fb2b557be60c9564dd09eec423037fcbdab

data/CHANGELOG.md

@@ -5,6 +5,15 @@ 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.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

@@ -166,8 +166,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 +355,34 @@ module Toggly
 
     private
 
+    def decode_variant_configuration(value, as, &block)
+      return block.call(value) if block
+      return nil if as.nil?
+
+      # Scalars / :boolean before Class#new — String.new({}) would soft-fail to "".
+      if as == String
+        return value.is_a?(String) ? value : nil
+      end
+      if as == Integer
+        return value.is_a?(Integer) && !value.is_a?(TrueClass) && !value.is_a?(FalseClass) ? value : nil
+      end
+      if as == Float
+        return value.is_a?(Numeric) && !value.is_a?(TrueClass) && !value.is_a?(FalseClass) ? value.to_f : nil
+      end
+      if [TrueClass, FalseClass, :boolean].include?(as)
+        return [true, false].include?(value) ? value : nil
+      end
+
+      # is_a? requires a Module; symbols like :boolean are handled above.
+      return value if as.is_a?(Module) && value.is_a?(as)
+      return as.new(**value.transform_keys(&:to_sym)) if as.respond_to?(:new) && value.is_a?(Hash)
+      return as.json_create(value) if as.respond_to?(:json_create) && value.is_a?(Hash)
+
+      nil
+    rescue StandardError
+      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/version.rb

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

data/lib/toggly.rb

@@ -123,10 +123,10 @@ module Toggly
     # @param feature_key [String, Symbol]
     # @param context [Context, nil]
     # @return [Object, nil]
-    def get_variant_value(feature_key, context: nil)
+    def get_variant_value(feature_key, context: nil, as: nil, &)
       raise Error, "Toggly not configured. Call Toggly.configure first." 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.0
 platform: ruby
 authors:
 - Ops.ai
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-24 00:00:00.000000000 Z
+date: 2026-09-25 00:00:00.000000000 Z
 dependencies: []
 description: High-performance Ruby SDK for Toggly feature flag management. Works with
   or without Toggly.io.