statsig 2.5.4 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18141eb6b0169f1e1f2a1cb9fac6a249b49c422bab8ced2c7dc09de0a023c2ce
-  data.tar.gz: 7328411125b434f4e90c8e9900f2f6a9cd5fb811a9089ed677e3cf248f23bb73
+  metadata.gz: 2e43e289ee71055ef26a191a9daf4d54eb4f6a5dbacb8eb6a9160d1f66c07470
+  data.tar.gz: 7c457bd018afe66c60c7ba2d1091b6b0c3054487d50cae69c02ebf640d367acf
 SHA512:
-  metadata.gz: a022ec077aa7ae5e661add0ba003cca65b74521de6f2da467322913a267a47376c2e6a52474b97bab634be0a00e7a0a0cbc9d385a8b8718f3478a46d28fc4045
-  data.tar.gz: b33efac15e9d651b47140fdeb299188fd0df2a23865014de309f13178e33f11363da0bf766c08b7b8ec2f941984d800929e1ed69b7543286a89e7f7aeecc5bbd
+  metadata.gz: 80cf6fe68efe3a458f2e9c6637ea6433d7f6ed93110da01fb0c771ea5cd409623b0f721ecc651810e9146d3796b19c23931396407aae64357795dab6424e7d1d
+  data.tar.gz: 496ead0234ed956e4d2077cfea9cd95d755a0f7e036c32c7c9504c727f153a511771465c4a0774b94e4243805c6002056fe96f8434257401770622ff7ae5fe4a

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/evaluator.rb

@@ -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]
@@ -231,7 +292,7 @@ module Statsig
         group_size = 10_000.0 / cmab[:groups].length
         group = cmab[:groups][(hash % 10_000) / group_size]
         end_result.json_value = group[:parameterValues]
-        end_result.rule_id = group[:id]
+        end_result.rule_id = group[:id] + Const::EXPLORE
         end_result.group_name = group[:name]
         end_result.is_experiment_group = true
         finalize_cmab_eval_result(cmab, end_result, did_pass: true)
@@ -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
@@ -657,6 +727,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/network.rb

@@ -53,7 +53,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)

data/lib/spec_store.rb

@@ -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

@@ -386,7 +386,7 @@ module Statsig
   def self.get_statsig_metadata
     {
       'sdkType' => 'ruby-server',
-      'sdkVersion' => '2.5.4',
+      'sdkVersion' => '2.6.0',
       'languageVersion' => RUBY_VERSION
     }
   end

data/lib/statsig_logger.rb

@@ -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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statsig
 version: !ruby/object:Gem::Version
-  version: 2.5.4
+  version: 2.6.0
 platform: ruby
 authors:
 - Statsig, Inc
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-25 00:00:00.000000000 Z
+date: 2025-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -226,14 +226,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.15.0
+        version: 2.18.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.15.0
+        version: 2.18.0
 - !ruby/object:Gem::Dependency
   name: http
   requirement: !ruby/object:Gem::Requirement