statsig 2.1.0 → 2.5.5

data/lib/spec_store.rb

@@ -19,8 +19,9 @@ module Statsig
     attr_accessor :sdk_keys_to_app_ids
     attr_accessor :hashed_sdk_keys_to_app_ids
     attr_accessor :unsupported_configs
+    attr_accessor :cmab_configs
 
-    def initialize(network, options, error_callback, diagnostics, error_boundary, logger, secret_key)
+    def initialize(network, options, error_callback, diagnostics, error_boundary, logger, secret_key, sdk_config)
       @init_reason = EvaluationReason::UNINITIALIZED
       @network = network
       @options = options
@@ -33,6 +34,7 @@ module Statsig
       @gates = {}
       @configs = {}
       @layers = {}
+      @cmab_configs = {}
       @condition_map = {}
       @id_lists = {}
       @experiment_to_layer = {}
@@ -43,6 +45,9 @@ module Statsig
       @logger = logger
       @secret_key = secret_key
       @unsupported_configs = Set.new
+      @sdk_configs = sdk_config
+
+      startTime = (Time.now.to_f * 1000).to_i
 
       @id_list_thread_pool = Concurrent::FixedThreadPool.new(
         options.idlist_threadpool_size,
@@ -57,7 +62,7 @@ module Statsig
         else
           tracker = @diagnostics.track('initialize','bootstrap', 'process')
           begin
-            if process_specs(options.bootstrap_values)
+            if process_specs(options.bootstrap_values).nil?
               @init_reason = EvaluationReason::BOOTSTRAP
             end
           rescue StandardError
@@ -68,13 +73,15 @@ module Statsig
         end
       end
 
+      failure_details = nil
+
       unless @options.data_store.nil?
         @options.data_store.init
-        load_config_specs_from_storage_adapter('initialize')
+        failure_details = load_config_specs_from_storage_adapter('initialize')
       end
 
       if @init_reason == EvaluationReason::UNINITIALIZED
-        download_config_specs('initialize')
+        failure_details = download_config_specs('initialize')
       end
 
       @initial_config_sync_time = @last_config_sync_time == 0 ? -1 : @last_config_sync_time
@@ -86,12 +93,18 @@ module Statsig
 
       @config_sync_thread = spawn_sync_config_specs_thread
       @id_lists_sync_thread = spawn_sync_id_lists_thread
+      endTime = (Time.now.to_f * 1000).to_i
+      @initialization_details = {duration: endTime - startTime, isSDKReady: true, configSpecReady: @init_reason != EvaluationReason::UNINITIALIZED, failureDetails: failure_details}
     end
 
     def is_ready_for_checks
       @last_config_sync_time != 0
     end
 
+    def get_initialization_details
+      @initialization_details
+    end
+
     def shutdown
       @config_sync_thread&.exit
       @id_lists_sync_thread&.exit
@@ -114,6 +127,13 @@ module Statsig
       @layers.key?(layer_name.to_sym)
     end
 
+    def has_cmab_config?(config_name)
+      if @cmab_configs.nil?
+        return false
+      end
+      @cmab_configs.key?(config_name.to_sym)
+    end
+
     def get_gate(gate_name)
       gate_sym = gate_name.to_sym
       return nil unless has_gate?(gate_sym)
@@ -134,6 +154,12 @@ module Statsig
       @layers[layer_sym]
     end
 
+    def get_cmab_config(config_name)
+      config_sym = config_name.to_sym
+      return nil unless has_cmab_config?(config_sym)
+      @cmab_configs[config_sym]
+    end
+
     def get_condition(condition_hash)
       @condition_map[condition_hash.to_sym]
     end
@@ -202,13 +228,19 @@ module Statsig
       return if cached_values.nil?
 
       tracker = @diagnostics.track(context, 'data_store_config_specs', 'process')
-      process_specs(cached_values, from_adapter: true)
-      @init_reason = EvaluationReason::DATA_ADAPTER
-      tracker.end(success: true)
+      failure_details = process_specs(cached_values, from_adapter: true)
+      if failure_details.nil?
+        @init_reason = EvaluationReason::DATA_ADAPTER
+        tracker.end(success: true)
+      else
+        tracker.end(success: false)
+        return download_config_specs(context)
+      end
+      return failure_details
     rescue StandardError
       # Fallback to network
       tracker.end(success: false)
-      download_config_specs(context)
+      return download_config_specs(context)
     end
 
     def save_rulesets_to_storage_adapter(rulesets_string)
@@ -253,18 +285,21 @@ module Statsig
       tracker = @diagnostics.track(context, 'download_config_specs', 'network_request')
 
       error = nil
+      failure_details = nil
       begin
         response, e = @network.download_config_specs(@last_config_sync_time)
         code = response&.status.to_i
         if e.is_a? NetworkError
           code = e.http_code
+          failure_details = {statusCode: code, exception: e, reason: "CONFIG_SPECS_NETWORK_ERROR"}
         end
         tracker.end(statusCode: code, success: e.nil?, sdkRegion: response&.headers&.[]('X-Statsig-Region'))
 
         if e.nil?
           unless response.nil?
             tracker = @diagnostics.track(context, 'download_config_specs', 'process')
-            if process_specs(response.body.to_s)
+            failure_details = process_specs(response.body.to_s)
+            if failure_details.nil?
               @init_reason = EvaluationReason::NETWORK
             end
             tracker.end(success: @init_reason == EvaluationReason::NETWORK)
@@ -274,59 +309,66 @@ module Statsig
                                            @last_config_sync_time)
             end
           end
-
-          nil
         else
           error = e
         end
       rescue StandardError => e
+        failure_details = {exception: e, reason: "INTERNAL_ERROR"}
         error = e
       end
 
       @error_callback.call(error) unless error.nil? or @error_callback.nil?
+      return failure_details
     end
 
     def process_specs(specs_string, from_adapter: false)
       if specs_string.nil?
-        return false
+        return {reason: "EMPTY_SPEC"}
       end
 
-      specs_json = JSON.parse(specs_string, { symbolize_names: true })
-      return false unless specs_json.is_a? Hash
+      begin
+        specs_json = JSON.parse(specs_string, { symbolize_names: true })
+        return {reason: "PARSE_RESPONSE_ERROR"} unless specs_json.is_a? Hash
 
-      hashed_sdk_key_used = specs_json[:hashed_sdk_key_used]
-      unless hashed_sdk_key_used.nil? or hashed_sdk_key_used == Statsig::HashUtils.djb2(@secret_key)
-        err_boundary.log_exception(Statsig::InvalidSDKKeyResponse.new)
-        return false
-      end
+        hashed_sdk_key_used = specs_json[:hashed_sdk_key_used]
+        unless hashed_sdk_key_used.nil? or hashed_sdk_key_used == Statsig::HashUtils.djb2(@secret_key)
+          err_boundary.log_exception(Statsig::InvalidSDKKeyResponse.new)
+          return {reason: "PARSE_RESPONSE_ERROR"}
+        end
 
-      new_specs_sync_time = specs_json[:time]
-      if new_specs_sync_time.nil? \
-        || new_specs_sync_time < @last_config_sync_time \
-        || specs_json[:has_updates] != true \
-        || specs_json[:feature_gates].nil? \
-        || specs_json[:dynamic_configs].nil? \
-        || specs_json[:layer_configs].nil?
-        return false
-      end
+        new_specs_sync_time = specs_json[:time]
+        if new_specs_sync_time.nil? \
+          || new_specs_sync_time < @last_config_sync_time \
+          || specs_json[:has_updates] != true \
+          || specs_json[:feature_gates].nil? \
+          || specs_json[:dynamic_configs].nil? \
+          || specs_json[:layer_configs].nil?
+          return {reason: "PARSE_RESPONSE_ERROR"}
+        end
 
-      @last_config_sync_time = new_specs_sync_time
-      @unsupported_configs.clear
+        @last_config_sync_time = new_specs_sync_time
+        @unsupported_configs.clear
 
-      specs_json[:diagnostics]&.each { |key, value| @diagnostics.sample_rates[key.to_s] = value }
+        specs_json[:diagnostics]&.each { |key, value| @diagnostics.sample_rates[key.to_s] = value }
 
-      @gates = specs_json[:feature_gates]
-      @configs = specs_json[:dynamic_configs]
-      @layers = specs_json[:layer_configs]
-      @condition_map = specs_json[:condition_map]
-      @experiment_to_layer = specs_json[:experiment_to_layer]
-      @sdk_keys_to_app_ids = specs_json[:sdk_keys_to_app_ids] || {}
-      @hashed_sdk_keys_to_app_ids = specs_json[:hashed_sdk_keys_to_app_ids] || {}
+        @gates = specs_json[:feature_gates]
+        @configs = specs_json[:dynamic_configs]
+        @layers = specs_json[:layer_configs]
+        @cmab_configs = specs_json[:cmab_configs]
+        @condition_map = specs_json[:condition_map]
+        @experiment_to_layer = specs_json[:experiment_to_layer]
+        @sdk_keys_to_app_ids = specs_json[:sdk_keys_to_app_ids] || {}
+        @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])
 
-      unless from_adapter
-        save_rulesets_to_storage_adapter(specs_string)
+        unless from_adapter
+          save_rulesets_to_storage_adapter(specs_string)
+        end
+      rescue StandardError => e
+        return {reason: "PARSE_RESPONSE_ERROR"}
       end
-      true
+      nil
     end
 
     def get_id_lists_from_adapter(context)

data/lib/statsig.rb

@@ -20,6 +20,13 @@ module Statsig
     @shared_instance = StatsigDriver.new(secret_key, options, error_callback)
   end
 
+  def self.get_initialization_details
+    if not defined? @shared_instance or @shared_instance.nil?
+      return {duration: 0, isSDKReady: false, configSpecReady: false, failure_details: {exception: Statsig::UninitializedError.new, reason: 'INTERNAL_ERROR'}}
+    end
+    @shared_instance.get_initialization_details
+  end
+
   class GetGateOptions
     attr_accessor :disable_log_exposure, :skip_evaluation, :disable_evaluation_details
 
@@ -65,7 +72,7 @@ module Statsig
   end
 
   ##
-  # @deprecated - use check_gate(user, gate, options) and disable_exposure_logging in options
+  # @deprecated - use check_gate(user, gate, options) with CheckGateOptions.new(disable_log_exposure: true) as options
   # Gets the boolean result of a gate, evaluated against the given user.
   #
   # @param user A StatsigUser object used for the evaluation
@@ -108,7 +115,7 @@ module Statsig
   end
 
   ##
-  # @deprecated - use get_config(user, config, options) and disable_exposure_logging in options
+  # @deprecated - use get_config(user, config, options) with GetConfigOptions.new(disable_log_exposure: true) as options
   # Get the values of a dynamic config, evaluated against the given user.
   #
   # @param [StatsigUser] user A StatsigUser object used for the evaluation
@@ -152,7 +159,7 @@ module Statsig
   end
 
   ##
-  # @deprecated - use get_experiment(user, experiment, options) and disable_exposure_logging in options
+  # @deprecated - use get_experiment(user, experiment, options) with GetExperimentOptions.new(disable_log_exposure: true) as options
   # Get the values of an experiment, evaluated against the given user.
   #
   # @param [StatsigUser] user A StatsigUser object used for the evaluation
@@ -199,7 +206,7 @@ module Statsig
   end
 
   ##
-  # @deprecated - use get_layer(user, gate, options) and disable_exposure_logging in options
+  # @deprecated - use get_layer(user, gate, options) with GetLayerOptions.new(disable_log_exposure: true) as options
   # Get the values of a layer, evaluated against the given user.
   #
   # @param user A StatsigUser object used for the evaluation
@@ -321,6 +328,17 @@ module Statsig
     @shared_instance&.override_config(config_name, config_value)
   end
 
+
+  ##
+  # Overrides an experiment to return the value for a specific group name.
+  #
+  # @param experiment_name The name of the experiment to be overridden
+  # @param group_name The name of the group whose value should be returned
+  def self.override_experiment_by_group_name(experiment_name, group_name)
+    ensure_initialized
+    @shared_instance&.override_experiment_by_group_name(experiment_name, group_name)
+  end
+
   def self.remove_config_override(config_name)
     ensure_initialized
     @shared_instance&.remove_config_override(config_name)
@@ -331,6 +349,11 @@ module Statsig
     @shared_instance&.clear_config_overrides
   end
 
+  def self.clear_experiment_overrides
+    ensure_initialized
+    @shared_instance&.clear_experiment_overrides
+  end
+
   ##
   # @param [HashTable] debug information log with exposure events
   def self.set_debug_info(debug_info)
@@ -363,11 +386,15 @@ module Statsig
   def self.get_statsig_metadata
     {
       'sdkType' => 'ruby-server',
-      'sdkVersion' => '2.1.0',
+      'sdkVersion' => '2.5.5',
       'languageVersion' => RUBY_VERSION
     }
   end
 
+  def self.get_options
+    @driver&.instance_variable_get(:@options)
+  end
+
   private
 
   def self.ensure_initialized

data/lib/statsig_driver.rb

@@ -13,6 +13,7 @@ require 'error_boundary'
 require 'layer'
 require 'memo'
 require 'diagnostics'
+require 'sdk_configs'
 
 class StatsigDriver
 
@@ -27,15 +28,16 @@ class StatsigDriver
 
     @err_boundary = Statsig::ErrorBoundary.new(secret_key, !options.nil? && options.local_mode)
     @err_boundary.capture(caller: __method__) do
-      @diagnostics = Statsig::Diagnostics.new()
+      @diagnostics = Statsig::Diagnostics.new
+      @sdk_configs = Statsig::SDKConfigs.new
       tracker = @diagnostics.track('initialize', 'overall')
       @options = options || StatsigOptions.new
       @shutdown = false
       @secret_key = secret_key
       @net = Statsig::Network.new(secret_key, @options)
-      @logger = Statsig::StatsigLogger.new(@net, @options, @err_boundary)
+      @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)
+      @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)
       tracker.end(success: true)
 
@@ -43,6 +45,10 @@ class StatsigDriver
     end
   end
 
+  def get_initialization_details
+    @store.get_initialization_details
+  end
+
   def get_gate_impl(
     user,
     gate_name,
@@ -59,7 +65,7 @@ class StatsigDriver
 
     user = verify_inputs(user, gate_name, 'gate_name')
 
-    Statsig::Memo.for(user.get_memo, :get_gate_impl, gate_name) do
+    Statsig::Memo.for(user.get_memo, :get_gate_impl, gate_name, disable_evaluation_memoization: @options.disable_evaluation_memoization) do
       res = Statsig::ConfigResult.new(
         name: gate_name,
         disable_exposures: disable_log_exposure,
@@ -68,9 +74,7 @@ class StatsigDriver
       @evaluator.check_gate(user, gate_name, res, ignore_local_overrides: ignore_local_overrides)
 
       unless disable_log_exposure
-        @logger.log_gate_exposure(
-          user, res.name, res.gate_value, res.rule_id, res.secondary_exposures, res.evaluation_details
-        )
+        @logger.log_gate_exposure(user, res)
       end
 
       FeatureGate.from_config_result(res)
@@ -109,7 +113,7 @@ class StatsigDriver
       res = Statsig::ConfigResult.new(name: gate_name)
       @evaluator.check_gate(user, gate_name, res)
       context = { :is_manual_exposure => true }
-      @logger.log_gate_exposure(user, gate_name, res.gate_value, res.rule_id, res.secondary_exposures, res.evaluation_details, context)
+      @logger.log_gate_exposure(user, res, context)
     end
   end
 
@@ -150,7 +154,7 @@ class StatsigDriver
       @evaluator.get_config(user, config_name, res)
 
       context = { :is_manual_exposure => true }
-      @logger.log_config_exposure(user, res.name, res.rule_id, res.secondary_exposures, res.evaluation_details, context)
+      @logger.log_config_exposure(user, res, context)
     end
   end
 
@@ -167,7 +171,7 @@ class StatsigDriver
     @err_boundary.capture(caller: __method__, recover: -> { Layer.new(layer_name) }) do
       run_with_diagnostics(caller: :get_layer) do
         user = verify_inputs(user, layer_name, "layer_name")
-        Statsig::Memo.for(user.get_memo, :get_layer, layer_name) do
+        Statsig::Memo.for(user.get_memo, :get_layer, layer_name, disable_evaluation_memoization: @options.disable_evaluation_memoization) do
           exposures_disabled = options&.disable_log_exposure == true
           res = Statsig::ConfigResult.new(
             name: layer_name,
@@ -300,6 +304,12 @@ class StatsigDriver
     end
   end
 
+  def clear_experiment_overrides
+    @err_boundary.capture(caller: __method__) do
+      @evaluator.clear_experiment_overrides
+    end
+  end
+
   def set_debug_info(debug_info)
     @err_boundary.capture(caller: __method__) do
       @logger.set_debug_info(debug_info)
@@ -333,6 +343,10 @@ class StatsigDriver
     end
   end
 
+  def override_experiment_by_group_name(experiment_name, group_name)
+    @evaluator.override_experiment_by_group_name(experiment_name, group_name)
+  end
+
   private
 
   def run_with_diagnostics(caller:)
@@ -357,7 +371,7 @@ class StatsigDriver
 
   def verify_inputs(user, config_name, variable_name)
     validate_user(user)
-    user = Statsig::Memo.for(user.get_memo(), :verify_inputs, 0) do
+    user = Statsig::Memo.for(user.get_memo(), :verify_inputs, 0, disable_evaluation_memoization: @options.disable_evaluation_memoization) do
       user = normalize_user(user)
       check_shutdown
       maybe_restart_background_threads
@@ -372,7 +386,7 @@ class StatsigDriver
   end
 
   def get_config_impl(user, config_name, disable_log_exposure, user_persisted_values: nil, disable_evaluation_details: false, ignore_local_overrides: false)
-    Statsig::Memo.for(user.get_memo, :get_config_impl, config_name) do
+    Statsig::Memo.for(user.get_memo, :get_config_impl, config_name, disable_evaluation_memoization: @options.disable_evaluation_memoization) do
       res = Statsig::ConfigResult.new(
         name: config_name,
         disable_exposures: disable_log_exposure,
@@ -381,7 +395,7 @@ class StatsigDriver
       @evaluator.get_config(user, config_name, res, user_persisted_values: user_persisted_values, ignore_local_overrides: ignore_local_overrides)
 
       unless disable_log_exposure
-        @logger.log_config_exposure(user, res.name, res.rule_id, res.secondary_exposures, res.evaluation_details)
+        @logger.log_config_exposure(user, res)
       end
 
       DynamicConfig.new(res.name, res.json_value, res.rule_id, res.group_name, res.id_type, res.evaluation_details)

data/lib/statsig_event.rb

@@ -1,4 +1,3 @@
-
 class StatsigEvent
   attr_accessor :value, :metadata, :statsig_metadata, :secondary_exposures
   attr_reader :user
@@ -15,7 +14,7 @@ class StatsigEvent
 
   def user=(value)
     if value.is_a?(StatsigUser)
-      @user = Statsig::Memo.for(value.get_memo(), :serialize, 0) do
+      @user = Statsig::Memo.for(value.get_memo(), :serialize, 0, disable_evaluation_memoization: Statsig.get_options&.disable_evaluation_memoization) do
         value.serialize(true)
       end
     end