featureflip 2.13.0 → 2.13.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c41498d43abe3f592e70ef93178a39bbabfc481072cf1862b3a18399ad3972db
-  data.tar.gz: 00b9495f23ece99027e3c03c647616cd240a11338f8376511ac4bbd2ce46e826
+  metadata.gz: c4c086d9a3b50763d562f2a79ef07aa449ddbdb1b88446d8fee98948d7c3933c
+  data.tar.gz: bf96d5faeb953a5219f1de18d5ff85d404b5fbf3daa783550b3b64837b0c72bc
 SHA512:
-  metadata.gz: 3c397937ed703003e47e5999a9ffd0cd6004ce0ee02e0b216ba6c99c06dec2b03a37ceb9163b8fba36cc413747782fc13ccd84ed7218e307cd21f92ded5566da
-  data.tar.gz: ca65db25d697572ceae8f048bb5672407639fd9aeebf0bc3e0f691cfd08e3993983d78c80f80ad9997852725ebd319ca0b19c069c455fde3b8b43c4c54f73e41
+  metadata.gz: 2a2a87d48a71704a9b2885885a55c74f664497be27703bb4dcb83463756347f771803cfa6608f2c2512b8cff19a982a21ab72d76c52ec53a45fd3d5187f02f45
+  data.tar.gz: be23805658d9ce4f0ba3c4a49f0fde25ea8e2e05e0da8497ab4ec94b557ee9d554b1ed870782acf6df2cbe8476bc5691ae8728eb4438a1259b304c09d91fc4fa

data/lib/featureflip/evaluation/condition_evaluator.rb

@@ -1,3 +1,4 @@
+require_relative "context_attribute"
 require "time"
 
 module Featureflip
@@ -10,7 +11,7 @@ module Featureflip
       REGEX_TIMEOUT_SECONDS = 0.1
 
       def evaluate_condition(condition, context)
-        attr_value = context[condition.attribute]
+        attr_value = ContextAttribute.resolve(context, condition.attribute)
 
         return condition.negate if attr_value.nil?
 

data/lib/featureflip/evaluation/context_attribute.rb

@@ -0,0 +1,24 @@
+module Featureflip
+  module Evaluation
+    # Looks an attribute up in an evaluation context hash.
+    #
+    # "user_id" is the canonical spelling of the user identifier and "userId" is
+    # accepted as an alias (#4518). A lookup of exactly one of the two returns
+    # "user_id" when it is non-nil, else "userId" when it is non-nil, else nil.
+    # An empty string is a value and does not fall through. Every other key,
+    # including other casings, is an ordinary attribute.
+    module ContextAttribute
+      module_function
+
+      def resolve(context, attribute)
+        if attribute == "user_id" || attribute == "userId"
+          value = context["user_id"]
+          value = context["userId"] if value.nil?
+          value
+        else
+          context[attribute]
+        end
+      end
+    end
+  end
+end

data/lib/featureflip/evaluation/evaluator.rb

@@ -1,3 +1,4 @@
+require_relative "context_attribute"
 require_relative "condition_evaluator"
 require_relative "bucketing"
 require_relative "canonical_number"
@@ -164,7 +165,7 @@ module Featureflip
       end
 
       def warn_unbucketable(flag, rule_id, serve)
-        UnbucketableWarnings.warn(@logger, flag.key, rule_id, serve.bucket_by || "userId")
+        UnbucketableWarnings.warn(@logger, flag.key, rule_id, serve.bucket_by || "user_id")
       end
 
       # Returns the variation key to serve, or nil when a Rollout serve can't bucket
@@ -178,13 +179,13 @@ module Featureflip
       end
 
       def resolve_rollout(serve, context)
-        bucket_by = serve.bucket_by || "userId"
-        bucket_value = context[bucket_by]
-        # Alias "userId" <-> "user_id" for the built-in user identifier
-        bucket_value = context["user_id"] if bucket_value.nil? && bucket_by == "userId"
-        bucket_value = context["userId"] if bucket_value.nil? && bucket_by == "user_id"
+        bucket_by = serve.bucket_by || "user_id"
+        # "user_id" and "userId" resolve the same identity (user_id first).
+        bucket_value = ContextAttribute.resolve(context, bucket_by)
         bucket_value_str =
-          if bucket_value.nil? then ""
+          # An Array or Hash (a JSON array or object, empty or not) has no spelling every
+          # SDK shares, so it can't be bucketed, like a missing value (#4572).
+          if bucket_value.nil? || bucket_value.is_a?(Array) || bucket_value.is_a?(Hash) then ""
           elsif bucket_value.is_a?(Float) then CanonicalNumber.format(bucket_value)
           elsif defined?(::BigDecimal) && bucket_value.is_a?(::BigDecimal) then CanonicalNumber.format_big_decimal(bucket_value)
           else bucket_value.to_s
@@ -196,7 +197,7 @@ module Featureflip
         # empty key. Mirrors the engine + C#/Java SDK evaluators.
         return serve.variation || "" if (serve.variations || []).empty?
 
-        # A missing, nil or empty bucket value can't be bucketed: return nil so the caller
+        # A missing, nil, empty or non-scalar bucket value can't be bucketed: return nil so the caller
         # skips the rule (or serves the fallthrough's variation) instead of hashing the empty
         # string into an arbitrary bucket. Whitespace, "0", 0 and false bucket normally (#4236).
         return nil if bucket_value_str == ""

data/lib/featureflip/version.rb

@@ -1,3 +1,3 @@
 module Featureflip
-  VERSION = "2.13.0"
+  VERSION = "2.13.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: featureflip
 version: !ruby/object:Gem::Version
-  version: 2.13.0
+  version: 2.13.1
 platform: ruby
 authors:
 - Featureflip
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-27 00:00:00.000000000 Z
+date: 2026-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logger
@@ -81,6 +81,7 @@ files:
 - lib/featureflip/evaluation/bucketing.rb
 - lib/featureflip/evaluation/canonical_number.rb
 - lib/featureflip/evaluation/condition_evaluator.rb
+- lib/featureflip/evaluation/context_attribute.rb
 - lib/featureflip/evaluation/evaluator.rb
 - lib/featureflip/evaluation/unbucketable_warnings.rb
 - lib/featureflip/events/event.rb