statsig 2.5.5 → 2.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c340de8172bac9c10e0af76b1b34dce4dc812b19f9e33fbf19e67b54ddb90f4a
-  data.tar.gz: a49b6298cc34ff28a2133ecc96518e66f4c622bb65f163a6468eb6310e53f027
+  metadata.gz: a17857d17823d2f8d7f6a13d01c4f3d117e4187233d377441c4e7be7a6499ef1
+  data.tar.gz: 34bb6a509d1fca2ab2973edf7ce0f76814440c5197649a68af8c573130ef13d5
 SHA512:
-  metadata.gz: f4182f35cff27c25b80d1add5f4e7482021f834711a9a31d99ade432b9366a0f56da18b8a5022797fd9105a87efee40ef19ed3e243ce9d17d94259613f34dec9
-  data.tar.gz: 456e3f74f8cbb17f0be3aa256381349214df363298603da260bae951b570c8ffe4eac9bf2bc8156af31e6a6c4404e349e3bbbb664606c81f4fc23b1265b99ea5
+  metadata.gz: eef23c96fefa5aff93eec2ce8562a45ccb59434bfb68d264f39b50df987689c402286895103295b701ba6f71db970f43bd8832f608a2da0622a5bde1717d9521
+  data.tar.gz: 7df3f01db686cf387e30b7d45be967be4d9376340d64506359c0df6a0a9b169f45ef310a7b727b34f87cb9c4ddb97f7ba0a80daf7e79d8102f256f83f32369cd

data/lib/api_config.rb

@@ -1,4 +1,4 @@
-require 'constants'
+require_relative 'constants'
 
 class UnsupportedConfigException < StandardError
 end

data/lib/client_initialize_helpers.rb

@@ -1,7 +1,6 @@
+require_relative 'constants'
 require_relative 'hash_utils'
 
-require 'constants'
-
 module Statsig
   class ResponseFormatter
     def self.get_responses(

data/lib/config_result.rb

@@ -21,6 +21,7 @@ module Statsig
     attr_accessor :forward_all_exposures
     attr_accessor :sampling_rate
     attr_accessor :has_seen_analytical_gates
+    attr_accessor :override_config_name
 
     def initialize(
       name:,
@@ -41,7 +42,8 @@ module Statsig
       include_local_overrides: true,
       forward_all_exposures: false,
       sampling_rate: nil,
-      has_seen_analytical_gates: false
+      has_seen_analytical_gates: false,
+      override_config_name: nil
     )
       @name = name
       @gate_value = gate_value
@@ -63,6 +65,7 @@ module Statsig
       @forward_all_exposures = forward_all_exposures
       @sampling_rate = sampling_rate
       @has_seen_analytical_gates = has_seen_analytical_gates
+      @override_config_name = override_config_name
     end
 
     def self.from_user_persisted_values(config_name, user_persisted_values)
@@ -82,7 +85,8 @@ module Statsig
         init_time: @init_time,
         group_name: @group_name,
         id_type: @id_type,
-        target_app_ids: @target_app_ids
+        target_app_ids: @target_app_ids,
+        override_config_name: @override_config_name
       }
     end
   end

data/lib/error_boundary.rb

@@ -1,4 +1,4 @@
-require 'statsig_errors'
+require_relative 'statsig_errors'
 
 $endpoint = 'https://statsigapi.net/v1/sdk_exception'
 

data/lib/evaluator.rb

@@ -1,15 +1,15 @@
-require 'config_result'
 require 'country_lookup'
 require 'digest'
-require 'evaluation_helpers'
-require 'client_initialize_helpers'
-require 'spec_store'
 require 'time'
-require 'ua_parser'
-require 'evaluation_details'
 require 'user_agent_parser/operating_system'
-require 'user_persistent_storage_utils'
-require 'constants'
+require_relative 'client_initialize_helpers'
+require_relative 'config_result'
+require_relative 'constants'
+require_relative 'evaluation_details'
+require_relative 'evaluation_helpers'
+require_relative 'spec_store'
+require_relative 'ua_parser'
+require_relative 'user_persistent_storage_utils'
 
 module Statsig
   class Evaluator
@@ -89,6 +89,50 @@ module Statsig
       nil
     end
 
+    def try_apply_config_mapping(gate_name, user, end_result, type, salt)
+      gate_name_sym = gate_name.to_sym
+      return false unless @spec_store.overrides.key?(gate_name_sym)
+
+      mapping_list = @spec_store.overrides[gate_name_sym]
+      mapping_list.each do |mapping|
+        rules = mapping[:rules]
+        rules.each do |rule|
+          start_time = rule[:start_time]
+          if !start_time.nil? && start_time > (Time.now.to_i * 1000)
+            next
+          end
+
+          rule_name = rule[:rule_name].to_sym
+          next unless @spec_store.override_rules.key?(rule_name)
+
+          override_rule = @spec_store.override_rules[rule_name]
+          eval_rule(user, override_rule, end_result)
+          unless end_result.gate_value
+            next
+          end
+
+          pass = eval_pass_percent(user, override_rule, salt)
+          unless pass
+            next
+          end
+
+          new_config_name = mapping[:new_config_name]
+          end_result.override_config_name = new_config_name
+          if type == Const::TYPE_FEATURE_GATE
+            check_gate(user, new_config_name, end_result)
+          end
+          if [Const::TYPE_EXPERIMENT, Const::TYPE_DYNAMIC_CONFIG, Const::TYPE_AUTOTUNE].include?(type)
+            get_config(user, new_config_name, end_result)
+          end
+          if type == Const::TYPE_LAYER
+            get_layer(user, new_config_name, end_result)
+          end
+          return true
+        end
+      end
+      false
+    end
+
     def check_gate(user, gate_name, end_result, ignore_local_overrides: false, is_nested: false)
       unless ignore_local_overrides
         local_override = lookup_gate_override(gate_name)
@@ -111,11 +155,20 @@ module Statsig
       end
 
       unless @spec_store.has_gate?(gate_name)
+        if try_apply_config_mapping(gate_name, user, end_result, Const::TYPE_FEATURE_GATE, Const::EMPTY_STR)
+          return
+        end
+
         unsupported_or_unrecognized(gate_name, end_result)
         return
       end
 
-      eval_spec(gate_name, user, @spec_store.get_gate(gate_name), end_result, is_nested: is_nested)
+      spec = @spec_store.get_gate(gate_name)
+      if try_apply_config_mapping(gate_name, user, end_result, spec[:entity], spec[:salt])
+        return
+      end
+
+      eval_spec(gate_name, user, spec, end_result, is_nested: is_nested)
     end
 
     def get_config(user, config_name, end_result, user_persisted_values: nil, ignore_local_overrides: false)
@@ -146,12 +199,20 @@ module Statsig
       end
 
       unless @spec_store.has_config?(config_name)
+        if try_apply_config_mapping(config_name, user, end_result, Const::TYPE_DYNAMIC_CONFIG, Const::EMPTY_STR)
+          return
+        end
+
         unsupported_or_unrecognized(config_name, end_result)
         return
       end
 
       config = @spec_store.get_config(config_name)
 
+      if try_apply_config_mapping(config_name, user, end_result, config[:entity], config[:salt])
+        return
+      end
+
       # If persisted values is provided and the experiment is active, return sticky values if exists.
       if !user_persisted_values.nil? && config[:isActive] == true
         sticky_values = user_persisted_values[config_name]
@@ -317,7 +378,7 @@ module Statsig
         unless config.nil?
           cur_count += config[:records]
         end
-        sum += 1.0 / (cur_count / total_records)
+        sum += 1.0 / cur_count / total_records
         next unless value < sum
 
         end_result.json_value = group[:parameterValues]
@@ -338,11 +399,20 @@ module Statsig
       end
 
       unless @spec_store.has_layer?(layer_name)
+        if try_apply_config_mapping(layer_name, user, end_result, Const::LAYER, Const::EMPTY_STR)
+          return
+        end
+
         unsupported_or_unrecognized(layer_name, end_result)
         return
       end
 
-      eval_spec(layer_name, user, @spec_store.get_layer(layer_name), end_result)
+      layer = @spec_store.get_layer(layer_name)
+      if try_apply_config_mapping(layer_name, user, end_result, layer[:entity], layer[:salt])
+        return
+      end
+
+      eval_spec(layer_name, user, layer, end_result)
     end
 
     def list_gates
@@ -479,7 +549,7 @@ module Statsig
             value: rule[:returnValue],
             group_name: rule[:groupName],
             rule_id: rule[:id],
-            evaluation_details: EvaluationDetails.local_override(@config_sync_time, @init_time)
+            evaluation_details: EvaluationDetails.local_override(@spec_store.last_config_sync_time, @spec_store.initial_config_sync_time)
           }
           return
         end
@@ -490,7 +560,7 @@ module Statsig
         value: {},
         group_name: group_name,
         rule_id: "#{experiment_name}:override",
-        evaluation_details: EvaluationDetails.local_override(@config_sync_time, @init_time)
+        evaluation_details: EvaluationDetails.local_override(@spec_store.last_config_sync_time, @spec_store.initial_config_sync_time)
       }
     end
 
@@ -498,6 +568,10 @@ module Statsig
       @experiment_overrides.clear
     end
 
+    def remove_experiment_override(experiment_name)
+      @experiment_overrides.delete(experiment_name.to_sym)
+    end
+
     def eval_spec(config_name, user, config, end_result, is_nested: false)
       config[:rules].each do |rule|
         end_result.sampling_rate = rule[:samplingRate]
@@ -525,7 +599,7 @@ module Statsig
       end_result.target_app_ids = config[:targetAppIDs]
       end_result.gate_value = did_pass
       end_result.forward_all_exposures = config[:forwardAllExposures]
-      if config[:entity] == Const::TYPE_FEATURE_GATE
+      if config[:entity] == Const::TYPE_FEATURE_GATE || config[:entity] == Const::TYPE_HOLDOUT
         end_result.gate_value = did_pass ? rule[:returnValue] == true : config[:defaultValue] == true
       end
       end_result.config_version = config[:version]
@@ -657,6 +731,10 @@ module Statsig
       when Const::CND_PUBLIC
         return true
       when Const::CND_PASS_GATE, Const::CND_FAIL_GATE
+        if !target.is_a?(String) || target.empty?
+          return type == Const::CND_FAIL_GATE
+        end
+
         result = eval_nested_gate(target, user, end_result)
         if end_result.sampling_rate == nil && !target.start_with?("segment")
           end_result.has_seen_analytical_gates = true

data/lib/hash_utils.rb

@@ -1,5 +1,5 @@
-require 'json'
 require 'digest'
+require 'json'
 
 TWO_TO_THE_63 = 1 << 63
 TWO_TO_THE_64 = 1 << 64

data/lib/network.rb

@@ -1,10 +1,9 @@
+require 'connection_pool'
 require 'http'
 require 'json'
 require 'securerandom'
 require 'zlib'
 
-require 'connection_pool'
-
 RETRY_CODES = [408, 500, 502, 503, 504, 522, 524, 599].freeze
 
 module Statsig
@@ -53,7 +52,11 @@ module Statsig
 
     def download_config_specs(since_time)
       url = @options.download_config_specs_url
-      get("#{url}#{@server_secret}.json?sinceTime=#{since_time}")
+      dcs_url = "#{url}#{@server_secret}.json"
+      if since_time.positive?
+        dcs_url += "?sinceTime=#{since_time}"
+      end
+      get(dcs_url)
     end
 
     def post_logs(events, error_boundary)
@@ -64,6 +67,10 @@ module Statsig
       gzip << json_body
 
       response, e = post(url, gzip.close.string, @post_logs_retry_limit, 1, true, event_count)
+
+      # Consume response body to ensure connection can be closed.
+      response&.flush
+
       unless e == nil
         message = "Failed to log #{event_count} events after #{@post_logs_retry_limit} retries"
         puts "[Statsig]: #{message}"

data/lib/spec_store.rb

@@ -1,10 +1,10 @@
+require 'concurrent-ruby'
 require 'net/http'
 require 'uri'
-require 'evaluation_details'
-require 'id_list'
-require 'concurrent-ruby'
-require 'hash_utils'
-require 'api_config'
+require_relative 'api_config'
+require_relative 'evaluation_details'
+require_relative 'hash_utils'
+require_relative 'id_list'
 
 module Statsig
   class SpecStore
@@ -20,6 +20,8 @@ module Statsig
     attr_accessor :hashed_sdk_keys_to_app_ids
     attr_accessor :unsupported_configs
     attr_accessor :cmab_configs
+    attr_accessor :overrides
+    attr_accessor :override_rules
 
     def initialize(network, options, error_callback, diagnostics, error_boundary, logger, secret_key, sdk_config)
       @init_reason = EvaluationReason::UNINITIALIZED
@@ -40,6 +42,8 @@ module Statsig
       @experiment_to_layer = {}
       @sdk_keys_to_app_ids = {}
       @hashed_sdk_keys_to_app_ids = {}
+      @overrides = {}
+      @override_rules = {}
       @diagnostics = diagnostics
       @error_boundary = error_boundary
       @logger = logger
@@ -361,6 +365,8 @@ module Statsig
         @hashed_sdk_keys_to_app_ids = specs_json[:hashed_sdk_keys_to_app_ids] || {}
         @sdk_configs.set_flags(specs_json[:sdk_flags])
         @sdk_configs.set_configs(specs_json[:sdk_configs])
+        @overrides = specs_json[:overrides] || {}
+        @override_rules = specs_json[:override_rules] || {}
 
         unless from_adapter
           save_rulesets_to_storage_adapter(specs_string)

data/lib/statsig.rb

@@ -1,6 +1,5 @@
-require 'statsig_driver'
-
-require 'statsig_errors'
+require_relative 'statsig_driver'
+require_relative 'statsig_errors'
 
 module Statsig
 
@@ -92,6 +91,11 @@ module Statsig
     @shared_instance&.manually_log_gate_exposure(user, gate_name)
   end
 
+  def self.get_fields_used_for_gate(gate_name)
+    ensure_initialized
+    @shared_instance&.get_fields_used_for_gate(gate_name)
+  end
+
   class GetConfigOptions
     attr_accessor :disable_log_exposure, :disable_evaluation_details, :ignore_local_overrides
 
@@ -136,6 +140,11 @@ module Statsig
     @shared_instance&.manually_log_config_exposure(user, dynamic_config)
   end
 
+  def self.get_fields_used_for_config(config_name)
+    ensure_initialized
+    @shared_instance&.get_fields_used_for_config(config_name)
+  end
+
   class GetExperimentOptions
     attr_accessor :disable_log_exposure, :user_persisted_values, :disable_evaluation_details, :ignore_local_overrides
 
@@ -184,6 +193,11 @@ module Statsig
     @shared_instance&.get_user_persisted_values(user, id_type)
   end
 
+  def self.get_fields_used_for_experiment(experiment_name)
+    ensure_initialized
+    @shared_instance&.get_fields_used_for_config(experiment_name)
+  end
+
   class GetLayerOptions
     attr_accessor :disable_log_exposure, :disable_evaluation_details
 
@@ -227,6 +241,11 @@ module Statsig
     @shared_instance&.manually_log_layer_parameter_exposure(user, layer_name, parameter_name)
   end
 
+  def self.get_fields_used_for_layer(layer_name)
+    ensure_initialized
+    @shared_instance&.get_fields_used_for_layer(layer_name)
+  end
+
   ##
   # Logs an event to Statsig with the provided values.
   #
@@ -354,6 +373,11 @@ module Statsig
     @shared_instance&.clear_experiment_overrides
   end
 
+  def self.remove_experiment_override(experiment_name)
+    ensure_initialized
+    @shared_instance&.remove_experiment_override(experiment_name)
+  end
+
   ##
   # @param [HashTable] debug information log with exposure events
   def self.set_debug_info(debug_info)
@@ -386,7 +410,7 @@ module Statsig
   def self.get_statsig_metadata
     {
       'sdkType' => 'ruby-server',
-      'sdkVersion' => '2.5.5',
+      'sdkVersion' => '2.8.3',
       'languageVersion' => RUBY_VERSION
     }
   end

data/lib/statsig_driver.rb

@@ -1,19 +1,20 @@
-require 'config_result'
-require 'evaluator'
-require 'network'
-require 'statsig_errors'
-require 'statsig_event'
-require 'statsig_logger'
-require 'statsig_options'
-require 'statsig_user'
-require 'spec_store'
-require 'dynamic_config'
-require 'feature_gate'
-require 'error_boundary'
-require 'layer'
-require 'memo'
-require 'diagnostics'
-require 'sdk_configs'
+require_relative 'api_config'
+require_relative 'config_result'
+require_relative 'diagnostics'
+require_relative 'dynamic_config'
+require_relative 'error_boundary'
+require_relative 'evaluator'
+require_relative 'feature_gate'
+require_relative 'layer'
+require_relative 'memo'
+require_relative 'network'
+require_relative 'sdk_configs'
+require_relative 'spec_store'
+require_relative 'statsig_errors'
+require_relative 'statsig_event'
+require_relative 'statsig_logger'
+require_relative 'statsig_options'
+require_relative 'statsig_user'
 
 class StatsigDriver
 
@@ -117,6 +118,15 @@ class StatsigDriver
     end
   end
 
+  def get_fields_used_for_gate(gate_name)
+    @err_boundary.capture(caller: __method__, recover: -> { [] }) do
+        gate = @store.get_gate(gate_name)
+        return [] if gate.nil?
+
+        gate[:fieldsUsed] || []
+    end
+  end
+
   def get_config(user, dynamic_config_name, options = nil)
     @err_boundary.capture(caller: __method__, recover: -> { DynamicConfig.new(dynamic_config_name) }) do
       run_with_diagnostics(caller: :get_config) do
@@ -132,6 +142,15 @@ class StatsigDriver
     end
   end
 
+  def get_fields_used_for_config(config_name)
+    @err_boundary.capture(caller: __method__, recover: -> { [] }) do
+        config = @store.get_config(config_name)
+        return [] if config.nil?
+
+        config[:fieldsUsed] || []
+    end
+  end
+
   def get_experiment(user, experiment_name, options = nil)
     @err_boundary.capture(caller: __method__, recover: -> { DynamicConfig.new(experiment_name) }) do
       run_with_diagnostics(caller: :get_experiment) do
@@ -201,6 +220,15 @@ class StatsigDriver
     end
   end
 
+  def get_fields_used_for_layer(layer_name)
+    @err_boundary.capture(caller: __method__, recover: -> { [] }) do
+        layer = @store.get_layer(layer_name)
+        return [] if layer.nil?
+
+        layer[:fieldsUsed] || []
+    end
+  end
+
   def log_event(user, event_name, value = nil, metadata = nil)
     @err_boundary.capture(caller: __method__) do
       if !user.nil? && !user.instance_of?(StatsigUser)
@@ -310,6 +338,12 @@ class StatsigDriver
     end
   end
 
+  def remove_experiment_override(experiment_name)
+    @err_boundary.capture(caller: __method__) do
+      @evaluator.remove_experiment_override(experiment_name)
+    end
+  end
+
   def set_debug_info(debug_info)
     @err_boundary.capture(caller: __method__) do
       @logger.set_debug_info(debug_info)

data/lib/statsig_logger.rb

@@ -1,8 +1,8 @@
-require 'constants'
-require 'statsig_event'
-require 'ttl_set'
 require 'concurrent-ruby'
-require 'hash_utils'
+require_relative 'constants'
+require_relative 'hash_utils'
+require_relative 'statsig_event'
+require_relative 'ttl_set'
 
 $gate_exposure_event = 'statsig::gate_exposure'
 $config_exposure_event = 'statsig::config_exposure'
@@ -65,6 +65,9 @@ module Statsig
       if @debug_info != nil
         metadata[:debugInfo] = @debug_info
       end
+      unless result.override_config_name.nil?
+        metadata[:overrideConfigName] = result.override_config_name
+      end
       return false if not is_unique_exposure(user, $gate_exposure_event, metadata)
       event.metadata = metadata
       event.statsig_metadata = {}
@@ -93,6 +96,9 @@ module Statsig
       if @debug_info != nil
         metadata[:debugInfo] = @debug_info
       end
+      unless result.override_config_name.nil?
+        metadata[:overrideConfigName] = result.override_config_name
+      end
       return false if not is_unique_exposure(user, $config_exposure_event, metadata)
       event.metadata = metadata
       event.secondary_exposures = result.secondary_exposures.is_a?(Array) ? result.secondary_exposures : []
@@ -195,7 +201,7 @@ module Statsig
         events_clone = @events
         @events = []
         serialized_events = events_clone.map { |e| e.serialize }
-        
+
         serialized_events.each_slice(@options.logging_max_buffer_size) do |batch|
           @network.post_logs(batch, @error_boundary)
         end

data/lib/statsig_user.rb

@@ -1,5 +1,5 @@
 require 'json'
-require 'constants'
+require_relative 'constants'
 ##
 #  The user object to be evaluated against your Statsig configurations (gates/experiments/dynamic configs).
 class StatsigUser

data/lib/user_persistent_storage_utils.rb

@@ -1,4 +1,4 @@
-require 'statsig_options'
+require_relative 'statsig_options'
 
 module Statsig
   class UserPersistentStorageUtils

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statsig
 version: !ruby/object:Gem::Version
-  version: 2.5.5
+  version: 2.8.3
 platform: ruby
 authors:
 - Statsig, Inc
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-11 00:00:00.000000000 Z
+date: 2026-01-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler