statsig 2.9.2 → 2.9.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb1b471ac9aa8827bb59d3dd18801a1d7e663e8e3d25ea44be09753f02953ecf
-  data.tar.gz: 5d08845dba73c8af7978c38c8519e790361a27dd4ed10f940a8af61d6c1b13e2
+  metadata.gz: 96c137e20d5bc087e6b3108ad346f3882a8f981c2fc18e95270af8511230f932
+  data.tar.gz: daeaec468e9fa579f7a5ef80085bf19a49175d25985ae7d2128ed1c767e073bb
 SHA512:
-  metadata.gz: ca761ef81609cbd94bec7294109c893c683477c55c39f6475161269b65a7275e416253d8299e7f1995111d38d7bd7d09687aa8091bb90ffa0762daf609141f85
-  data.tar.gz: 29d1482c76a1d78be0fd6e7c80886068a23c1973683050db19a08fa4d6a0b855a2549f24ebbadb6bc391669e09085b0bedc263db76cee9ea736099cf58b5fd80
+  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/network.rb

@@ -19,6 +19,14 @@ module Statsig
 
   class Network
 
+    # Background config-spec sync retries transient failures with a short, bounded
+    # exponential backoff, matching statsig-server-core's background sync strategy
+    # (3 retries; 2^n * 100ms => 200ms, 400ms, 800ms). These are fixed rather than
+    # user-configurable, mirroring server-core where the values are hardcoded.
+    CONFIG_SYNC_RETRY_LIMIT = 3
+    CONFIG_SYNC_RETRY_BACKOFF_SECONDS = 0.2
+    CONFIG_SYNC_RETRY_BACKOFF_MULTIPLIER = 2
+
     def initialize(server_secret, options, backoff_mult = 10)
       super()
       @options = options
@@ -42,7 +50,7 @@ module Statsig
       if context == 'initialize'
         return get(dcs_url, @options.initialize_retry_limit)
       end
-      get(dcs_url)
+      get(dcs_url, CONFIG_SYNC_RETRY_LIMIT, CONFIG_SYNC_RETRY_BACKOFF_SECONDS, CONFIG_SYNC_RETRY_BACKOFF_MULTIPLIER)
     end
 
     def download_config_specs_fallback(since_time, context)
@@ -84,8 +92,8 @@ module Statsig
       request(:GET, url, nil, 0, 1, false, 0, { 'Range' => "bytes=#{start_byte}-" }, false)
     end
 
-    def get(url, retries = 0, backoff = 1)
-      request(:GET, url, nil, retries, backoff)
+    def get(url, retries = 0, backoff = 1, backoff_multiplier = @backoff_multiplier)
+      request(:GET, url, nil, retries, backoff, false, 0, {}, true, backoff_multiplier)
     end
 
     def post(url, body, retries = 0, backoff = 1, zipped = false, event_count = 0)
@@ -106,7 +114,7 @@ module Statsig
       end
     end
 
-    def request(method, url, body, retries = 0, backoff = 1, zipped = false, event_count = 0, extra_headers = {}, use_statsig_headers = true)
+    def request(method, url, body, retries = 0, backoff = 1, zipped = false, event_count = 0, extra_headers = {}, use_statsig_headers = true, backoff_multiplier = @backoff_multiplier)
       if @local_mode
         return nil, nil
       end
@@ -146,7 +154,7 @@ module Statsig
         return nil, e unless retries.positive?
 
         sleep backoff_adjusted
-        return request(method, url, body, retries - 1, backoff * @backoff_multiplier, zipped, event_count, extra_headers, use_statsig_headers)
+        return request(method, url, body, retries - 1, backoff * backoff_multiplier, zipped, event_count, extra_headers, use_statsig_headers, backoff_multiplier)
       end
       return res, nil if res.status.success?
 
@@ -157,7 +165,7 @@ module Statsig
 
       ## status code retry
       sleep backoff_adjusted
-      request(method, url, body, retries - 1, backoff * @backoff_multiplier, zipped, event_count, extra_headers, use_statsig_headers)
+      request(method, url, body, retries - 1, backoff * backoff_multiplier, zipped, event_count, extra_headers, use_statsig_headers, backoff_multiplier)
     end
 
     private

data/lib/statsig.rb

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

data/lib/statsig_driver.rb

@@ -34,12 +34,13 @@ class StatsigDriver
       tracker = @diagnostics.track('initialize', 'overall')
       @options = options || StatsigOptions.new
       @shutdown = false
+      @shutdown_message_logged = false
       @secret_key = secret_key
       @net = Statsig::Network.new(secret_key, @options)
       @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')
@@ -460,8 +461,10 @@ class StatsigDriver
   end
 
   def check_shutdown
-    if @shutdown
-      puts 'SDK has been shutdown.  Updates in the Statsig Console will no longer reflect.'
-    end
+    return unless @shutdown
+    return if @shutdown_message_logged
+
+    @shutdown_message_logged = true
+    puts '[Statsig]: SDK has been shutdown.  Updates in the Statsig Console will no longer reflect.'
   end
 end

metadata

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