featureflip 2.12.0 → 2.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f9ade6e604108bf5c72e9b0d69dee554ef6c929004db80b56e4d184980de4ee1
-  data.tar.gz: 32c424cf3af497320ad75dc8f23baf336b086f3e8bdf867da20e8e7ce4f96e70
+  metadata.gz: c41498d43abe3f592e70ef93178a39bbabfc481072cf1862b3a18399ad3972db
+  data.tar.gz: 00b9495f23ece99027e3c03c647616cd240a11338f8376511ac4bbd2ce46e826
 SHA512:
-  metadata.gz: 5e5d545c1410cac76b7603008f9708a40e6c257e82e8142b1d799fcfc2b5475500072e764a6828b43300fade2cbede2936b82bf1e3e043131606317600ea2985
-  data.tar.gz: b8727a3ddf735c16c4d0094472721ba2ad53fb5bca323024a7d3291b993730efb583cc1683375aea9ba8d3235b523dac252ddac1f82fcc0799718d49337b5065
+  metadata.gz: 3c397937ed703003e47e5999a9ffd0cd6004ce0ee02e0b216ba6c99c06dec2b03a37ceb9163b8fba36cc413747782fc13ccd84ed7218e307cd21f92ded5566da
+  data.tar.gz: ca65db25d697572ceae8f048bb5672407639fd9aeebf0bc3e0f691cfd08e3993983d78c80f80ad9997852725ebd319ca0b19c069c455fde3b8b43c4c54f73e41

data/lib/featureflip/evaluation/canonical_number.rb

@@ -5,11 +5,14 @@ module Featureflip
     # BucketValueFormatter.CanonicalNumber, so every SDK hashes one number to one
     # bucket. Used only on the bucket path; condition evaluation is unaffected.
     module CanonicalNumber
-      # A BigDecimal with no fractional part keeps its exact integer digits (like the
-      # engine's raw integer text); anything else goes through Float (#4236).
+      # A BigDecimal below 1e21 with no fractional part keeps its exact integer digits (like
+      # the engine's raw integer text); anything else goes through Float (#4236). The 1e21
+      # cap is where ECMAScript spelling turns exponential, and stops BigDecimal("1E+999999999")
+      # expanding to a billion digits per evaluation (#4246). BigDecimal#exponent is n in
+      # 0.ddd * 10**n, so |d| < 1e21 is exponent <= 21.
       def self.format_big_decimal(d)
         return format(d.to_f) unless d.finite?
-        return d.to_i.to_s if d.frac.zero?
+        return d.to_i.to_s if d.exponent <= 21 && d.frac.zero?
 
         format(d.to_f)
       end

data/lib/featureflip/shared_core.rb

@@ -185,7 +185,7 @@ module Featureflip
 
       flag = @store.get_flag(key)
       unless flag
-        record_evaluation(key, context, nil)
+        record_evaluation(key, context, nil, reason: "FlagNotFound")
         notify_inspectors(key, context, default_value, reason: "FlagNotFound")
         return Models::EvaluationDetail.new(value: default_value, reason: "FlagNotFound")
       end
@@ -224,7 +224,10 @@ module Featureflip
         reason = "Error"
       end
 
-      record_evaluation(key, context, result.variation_key)
+      record_evaluation(
+        key, context, result.variation_key,
+        reason: reason, rule_id: result.rule_id, prerequisite_key: result.prerequisite_key
+      )
       notify_inspectors(
         key, context, value,
         reason: reason,
@@ -244,6 +247,7 @@ module Featureflip
       # Prerequisite-resolution failures return PrerequisiteFailed cleanly through
       # the evaluator; this rescue only fires on unexpected exceptions (malformed
       # config, programming errors), so prerequisite_key has no defined value.
+      record_evaluation(key, context, nil, reason: "Error")
       notify_inspectors(key, context, default_value, reason: "Error")
       Models::EvaluationDetail.new(value: default_value, reason: "Error", prerequisite_key: nil)
     end
@@ -521,16 +525,36 @@ module Featureflip
       event
     end
 
-    def record_evaluation(key, context, variation_key)
+    # The kebab-case reason categories the Evaluation event carries (#4268), so
+    # the source of traffic reads the same whichever SDK reported it. The
+    # PascalCase names stay the public EvaluationDetail API; only the event is
+    # translated.
+    WIRE_REASONS = {
+      "RuleMatch" => "rule-match",
+      "Fallthrough" => "fallthrough",
+      "FlagDisabled" => "flag-disabled",
+      "FlagNotFound" => "flag-not-found",
+      "PrerequisiteFailed" => "prerequisite-failed",
+      "Error" => "error"
+    }.freeze
+
+    # +ruleId+ rides only on a rule match: an Error read can still carry the rule
+    # that selected a malformed variation, and that rule did not serve the
+    # traffic. Absent optionals are compacted away so they are omitted, never null.
+    def record_evaluation(key, context, variation_key, reason:, rule_id: nil, prerequisite_key: nil)
       return unless @event_processor
 
-      @event_processor.queue_event(compact_event({
+      event = {
         type: "Evaluation",
         flagKey: key,
         userId: resolve_event_user_id(context),
         variation: variation_key,
-        timestamp: Time.now.utc.iso8601
-      }))
+        timestamp: Time.now.utc.iso8601,
+        prerequisiteKey: prerequisite_key,
+        reason: WIRE_REASONS[reason],
+        ruleId: reason == "RuleMatch" ? rule_id : nil
+      }
+      @event_processor.queue_event(event.compact)
     end
 
     # Fire the registered evaluation inspectors. Called once per variation call

data/lib/featureflip/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: featureflip
 version: !ruby/object:Gem::Version
-  version: 2.12.0
+  version: 2.13.0
 platform: ruby
 authors:
 - Featureflip
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-22 00:00:00.000000000 Z
+date: 2026-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logger