statsig 2.9.3 → 2.9.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5371899fd2582b8e213db4bfc0c0c9252e2a7e16ff1303c94fa7e1cecc43cfda
-  data.tar.gz: 786baba109ff66e4c38ffc4c71995fdf5fde54910ac0d7712cdfb9b85ac584f4
+  metadata.gz: 96c137e20d5bc087e6b3108ad346f3882a8f981c2fc18e95270af8511230f932
+  data.tar.gz: daeaec468e9fa579f7a5ef80085bf19a49175d25985ae7d2128ed1c767e073bb
 SHA512:
-  metadata.gz: e4dc2ad08e71c883d41ecfa012f9e592c6ece9e18e8e14b9f0df9c5ef0732140dddf7cd0f6b88e27516efdbfa89e0d7309e2763fb634b73da0de082eb78b84f3
-  data.tar.gz: 9fc9b841b4d3f6020b9ea71a87203155a5eef84641ac1f7ff52a1e8913ef1735e3f49ef3730575d67050b1c00b7e61d0953a00b4cfc001af8e5b31277499f6d1
+  metadata.gz: 76055e14d07eab81f94c6ad559e3378da16860a8c60fc3dc6a1118fa7621c61f53d7b4921e0a70856e1195aa954b23fb188812fe9ba16f4c6db3059c3ad59f1c
+  data.tar.gz: ad835e17a3ee00318cbf3ee7ccbcf94b7ef09dd05a08163b6ff1308d79040593175fb3d08b44d716c015edeae55d5949f1ad3515c74eed13ae16c5c709b84069

data/lib/client_initialize_helpers.rb

@@ -51,7 +51,8 @@ module Statsig
           name: config_name,
           disable_evaluation_details: true,
           disable_exposures: !include_exposures,
-          include_local_overrides: include_local_overrides
+          include_local_overrides: include_local_overrides,
+          disable_nested_experiment_evaluation: true
         )
         evaluator.eval_spec(config_name_str, user, config_spec, eval_result)
       else

data/lib/config_result.rb

@@ -22,6 +22,7 @@ module Statsig
     attr_accessor :sampling_rate
     attr_accessor :has_seen_analytical_gates
     attr_accessor :override_config_name
+    attr_accessor :disable_nested_experiment_evaluation
 
     def initialize(
       name:,
@@ -43,7 +44,8 @@ module Statsig
       forward_all_exposures: false,
       sampling_rate: nil,
       has_seen_analytical_gates: false,
-      override_config_name: nil
+      override_config_name: nil,
+      disable_nested_experiment_evaluation: false
     )
       @name = name
       @gate_value = gate_value
@@ -66,6 +68,7 @@ module Statsig
       @sampling_rate = sampling_rate
       @has_seen_analytical_gates = has_seen_analytical_gates
       @override_config_name = override_config_name
+      @disable_nested_experiment_evaluation = disable_nested_experiment_evaluation
     end
 
     def self.from_user_persisted_values(config_name, user_persisted_values)

data/lib/constants.rb

@@ -7,6 +7,7 @@ module Statsig
     SUPPORTED_CONDITION_TYPES = Set.new(%i[
                                           public fail_gate pass_gate ip_based ua_based user_field
                                           environment_field current_time user_bucket unit_id
+                                          experiment_group
                                         ]).freeze
 
     SUPPORTED_OPERATORS = Set.new(%i[
@@ -87,6 +88,7 @@ module Statsig
     CND_MULTI_PASS_GATE = 'multi_pass_gate'.freeze
     CND_MULTI_FAIL_GATE = 'multi_fail_gate'.freeze
     CND_CURRENT_TIME = 'current_time'.freeze
+    CND_EXPERIMENT_GROUP = 'experiment_group'.freeze
     CND_ENVIRONMENT_FIELD = 'environment_field'.freeze
     CND_USER_BUCKET = 'user_bucket'.freeze
     CND_UNIT_ID = 'unit_id'.freeze

data/lib/evaluator.rb

@@ -14,6 +14,12 @@ require_relative 'user_persistent_storage_utils'
 module Statsig
   class Evaluator
 
+    EXPOSURE_LOGGING_CONDITION_TYPES = [
+      Const::CND_PASS_GATE,
+      Const::CND_FAIL_GATE,
+      Const::CND_EXPERIMENT_GROUP
+    ].freeze
+
     attr_accessor :spec_store
 
     attr_accessor :gate_overrides
@@ -26,7 +32,7 @@ module Statsig
 
     attr_accessor :persistent_storage_utils
 
-    def initialize(store, options, persistent_storage_utils)
+    def initialize(store, options, persistent_storage_utils, logger = nil)
       UAParser.initialize_async
       CountryLookup.initialize_async
 
@@ -36,6 +42,7 @@ module Statsig
       @experiment_overrides = {}
       @options = options
       @persistent_storage_utils = persistent_storage_utils
+      @logger = logger
     end
 
     def maybe_restart_background_threads
@@ -689,8 +696,10 @@ module Statsig
           eval_condition(user, condition, end_result)
         end
 
+        # Conditions that log an exposure as a side effect are never memoized, or the
+        # repeat evaluations would silently drop their exposures.
         if !@options.disable_evaluation_memoization &&
-          condition && condition[:type] != Const::CND_PASS_GATE && condition[:type] != Const::CND_FAIL_GATE
+          condition && !EXPOSURE_LOGGING_CONDITION_TYPES.include?(condition[:type])
           eval_rule_memo[condition_hash] = result
         end
 
@@ -742,6 +751,8 @@ module Statsig
         return type == Const::CND_PASS_GATE ? result : !result
       when Const::CND_MULTI_PASS_GATE, Const::CND_MULTI_FAIL_GATE
         return eval_nested_gates(target, type, user, end_result)
+      when Const::CND_EXPERIMENT_GROUP
+        value = eval_experiment_group(field, user, end_result)
       when Const::CND_IP_BASED
         value = get_value_from_user(user, field) || get_value_from_ip(user, field)
       when Const::CND_UA_BASED
@@ -921,6 +932,29 @@ module Statsig
       gate_value
     end
 
+    # The condition's field carries the name of a parent experiment. The user's group
+    # in that experiment becomes the value the operator compares against. Mirrors
+    # statsig-rust's evaluate_experiment_group, which evaluates the parent through the
+    # public get_experiment API: a full evaluation that logs its own experiment
+    # exposure and contributes nothing to the outer result's secondary exposures.
+    def eval_experiment_group(experiment_name, user, end_result)
+      return nil if end_result.disable_nested_experiment_evaluation
+      return nil unless experiment_name.is_a?(String) && !experiment_name.empty?
+
+      nested_result = ConfigResult.new(
+        name: experiment_name,
+        disable_exposures: end_result.disable_exposures,
+        disable_evaluation_details: end_result.disable_evaluation_details
+      )
+      get_config(user, experiment_name, nested_result)
+
+      unless end_result.disable_exposures
+        @logger&.log_config_exposure(user, nested_result)
+      end
+
+      nested_result.group_name
+    end
+
     def eval_nested_gates(gate_names, condition_type, user, end_result)
       has_passing_gate = false
       is_multi_pass_gate_type = condition_type == Const::CND_MULTI_PASS_GATE

data/lib/statsig.rb

@@ -410,7 +410,7 @@ module Statsig
   def self.get_statsig_metadata
     {
       'sdkType' => 'ruby-server',
-      'sdkVersion' => '2.9.3',
+      'sdkVersion' => '2.9.4',
       'languageVersion' => RUBY_VERSION
     }
   end

data/lib/statsig_driver.rb

@@ -40,7 +40,7 @@ class StatsigDriver
       @logger = Statsig::StatsigLogger.new(@net, @options, @err_boundary, @sdk_configs)
       @persistent_storage_utils = Statsig::UserPersistentStorageUtils.new(@options)
       @store = Statsig::SpecStore.new(@net, @options, error_callback, @diagnostics, @err_boundary, @logger, secret_key, @sdk_configs)
-      @evaluator = Statsig::Evaluator.new(@store, @options, @persistent_storage_utils)
+      @evaluator = Statsig::Evaluator.new(@store, @options, @persistent_storage_utils, @logger)
       tracker.end(success: true)
 
       @logger.log_diagnostics_event(@diagnostics, 'initialize')

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statsig
 version: !ruby/object:Gem::Version
-  version: 2.9.3
+  version: 2.9.4
 platform: ruby
 authors:
 - Statsig, Inc
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-08 00:00:00.000000000 Z
+date: 2026-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler