statsig 2.0.1 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '059ef73434d227fde96790307f75b6922f1dbd840f3e7afca68c4600f217263d'
-  data.tar.gz: 7eb241bdd104280ee49117094859ba9b9801747c32a2b4e8ed043b96e336a812
+  metadata.gz: 3870c3be99d3f7295c21311a6e938599bbd0ebd260d4b2c2cb814b48d22bd7f4
+  data.tar.gz: 618400ee2baa54a9e4bc18ee7e6e1a1cb017349a513919dd5f5e6caa380fb154
 SHA512:
-  metadata.gz: b0b92e135f883955bd187971886822959656c644a9573f96de043c342f2930787152c0c16b293d8ed33cda25559dcd1298f9578056fc049a2042752a168ef0b1
-  data.tar.gz: c0103fd2da0b70705540e391aa6afc2bfcd81a37a1dfa01791032aeb43b258ff782caf6eba8c8e4188b15d8676a643d8764a2bc9b6f2e9a022b07455fec221c3
+  metadata.gz: 47fdd678ef31a026f84bf81a184b39fc171c4d35cb7fb9229ecc2ec835051645cd9ed7b4f6ec2c0bfb92c2b59fe6cd9e742afaff176b438192f6d7b8d07f7ceb
+  data.tar.gz: 6db827709c35c1005a22dbf07e81f3ee8d6f316c89ba760beea2ba4adf2a35ae1d5ad2ea97604411733f61e4d167a6ebcbfa1e0dcef05986aacde37aab76dcf0

data/lib/client_initialize_helpers.rb

@@ -92,12 +92,26 @@ module Statsig
       result[:rule_id] = eval_result.rule_id
 
       if include_exposures
-        result[:secondary_exposures] = eval_result.secondary_exposures
+        result[:secondary_exposures] = hash_exposures(eval_result.secondary_exposures, hash_algo)
       end
 
       [hashed_name, result]
     end
 
+    def self.hash_exposures(exposures, hash_algo)
+      return nil if exposures.nil?
+      hashed_exposures = []
+      exposures.each do |exp|
+        hashed_exposures << {
+          gate: hash_name(exp[:gate], hash_algo),
+          gateValue: exp[:gateValue],
+          ruleID: exp[:ruleID]
+        }
+      end
+
+      hashed_exposures
+    end
+
     def self.populate_experiment_fields(config_name, config_spec, eval_result, result, evaluator)
       result[:is_user_in_experiment] = eval_result.is_experiment_group
       result[:is_experiment_active] = config_spec[:isActive] == true
@@ -132,7 +146,7 @@ module Statsig
       end
 
       if include_exposures
-        result[:undelegated_secondary_exposures] = eval_result.undelegated_sec_exps || []
+        result[:undelegated_secondary_exposures] = hash_exposures(eval_result.undelegated_sec_exps || [], hash_algo)
       end
     end
 

data/lib/constants.rb

@@ -123,5 +123,11 @@ module Statsig
     # API Operators (Segments)
     OP_IN_SEGMENT_LIST = 'in_segment_list'.freeze
     OP_NOT_IN_SEGMENT_LIST = 'not_in_segment_list'.freeze
+
+    # API Operators (Array)
+    OP_ARRAY_CONTAINS_ANY = 'array_contains_any'.freeze
+    OP_ARRAY_CONTAINS_NONE = 'array_contains_none'.freeze
+    OP_ARRAY_CONTAINS_ALL = 'array_contains_all'.freeze
+    OP_NOT_ARRAY_CONTAINS_ALL = 'not_array_contains_all'.freeze
   end
 end

data/lib/dynamic_config.rb

@@ -53,7 +53,19 @@ class DynamicConfig
     index_sym = index.to_sym
     return default_value unless @value.key?(index_sym)
 
-    return default_value if @value[index_sym].class != default_value.class and default_value.class != TrueClass and default_value.class != FalseClass
-    @value[index_sym]
+    value = @value[index_sym]
+
+    case default_value
+    when Integer
+      return value.to_i if value.is_a?(Numeric) && default_value.is_a?(Integer)
+    when Float
+      return value.to_f if value.is_a?(Numeric) && default_value.is_a?(Float)
+    when TrueClass, FalseClass
+      return value if [true, false].include?(value)
+    else
+      return value if value.class == default_value.class
+    end
+
+    default_value
   end
 end

data/lib/evaluation_helpers.rb

@@ -58,6 +58,18 @@ module EvaluationHelpers
     end
   end
 
+  def self.array_contains_any(value, target)
+    return false if value.nil? || target.nil?
+    value_set = value.to_set
+    return target.any? { |item| value_set.include?(item) || value_set.include?(item.to_i) }
+  end
+
+  def self.array_contains_all(value, target)
+    return false if value.nil? || target.nil?
+    value_set = value.to_set
+    return target.all? { |item| value_set.include?(item) || value_set.include?(item.to_i) }
+  end
+
   private
 
   def self.is_numeric(v)
@@ -73,4 +85,4 @@ module EvaluationHelpers
     end
     return time.to_i
   end
-end
+end

data/lib/evaluator.rb

@@ -542,6 +542,24 @@ module Statsig
           a.year == b.year && a.month == b.month && a.day == b.day
         })
 
+        # array
+      when Const::OP_ARRAY_CONTAINS_ANY
+        if value.is_a?(Array) && target.is_a?(Array)
+          return EvaluationHelpers.array_contains_any(value, target)
+        end
+      when Const::OP_ARRAY_CONTAINS_NONE
+        if value.is_a?(Array) && target.is_a?(Array)
+          return !EvaluationHelpers.array_contains_any(value, target)
+        end
+      when Const::OP_ARRAY_CONTAINS_ALL
+        if value.is_a?(Array) && target.is_a?(Array)
+          return EvaluationHelpers.array_contains_all(value, target)
+        end
+      when Const::OP_NOT_ARRAY_CONTAINS_ALL
+        if value.is_a?(Array) && target.is_a?(Array)
+          return !EvaluationHelpers.array_contains_all(value, target)
+        end
+
         # segments
       when Const::OP_IN_SEGMENT_LIST, Const::OP_NOT_IN_SEGMENT_LIST
         begin
@@ -670,10 +688,14 @@ module Statsig
     end
 
     def eval_pass_percent(user, rule, config_salt)
+      pass_percentage = rule[:passPercentage]
+      return true if pass_percentage == 100.0
+      return false if pass_percentage == 0.0
+    
       unit_id = user.get_unit_id(rule[:idType]) || Const::EMPTY_STR
       rule_salt = rule[:salt] || rule[:id] || Const::EMPTY_STR
       hash = compute_user_hash("#{config_salt}.#{rule_salt}.#{unit_id}")
-      return (hash % 10_000) < (rule[:passPercentage] * 100)
+      return (hash % 10_000) < (pass_percentage * 100)
     end
 
     def compute_user_hash(user_hash)

data/lib/layer.rb

@@ -52,12 +52,31 @@ class Layer
     index_sym = index.to_sym
     return default_value unless @value.key?(index_sym)
 
-    return default_value if @value[index_sym].class != default_value.class and default_value.class != TrueClass and default_value.class != FalseClass
+    value = @value[index_sym]
 
-    if @exposure_log_func.is_a? Proc
-      @exposure_log_func.call(self, index)
+    case default_value
+    when Integer
+      if @exposure_log_func.is_a? Proc
+        @exposure_log_func.call(self, index)
+      end
+      return value.to_i if value.is_a?(Numeric) && default_value.is_a?(Integer)
+    when Float
+      if @exposure_log_func.is_a? Proc
+        @exposure_log_func.call(self, index)
+      end
+      return value.to_f if value.is_a?(Numeric) && default_value.is_a?(Float)
+    when TrueClass, FalseClass
+      if @exposure_log_func.is_a? Proc
+        @exposure_log_func.call(self, index)
+      end
+      return value if [true, false].include?(value)
+    else
+      if @exposure_log_func.is_a? Proc
+        @exposure_log_func.call(self, index)
+      end
+      return value if value.class == default_value.class
     end
 
-    @value[index_sym]
+    default_value
   end
 end

data/lib/spec_store.rb

@@ -44,6 +44,8 @@ module Statsig
       @secret_key = secret_key
       @unsupported_configs = Set.new
 
+      startTime = (Time.now.to_f * 1000).to_i
+
       @id_list_thread_pool = Concurrent::FixedThreadPool.new(
         options.idlist_threadpool_size,
         name: 'statsig-idlist',
@@ -57,7 +59,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 +70,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 +90,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
@@ -202,13 +212,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 +269,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 +293,63 @@ 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]
+        @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] || {}
 
-      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
@@ -363,7 +370,7 @@ module Statsig
   def self.get_statsig_metadata
     {
       'sdkType' => 'ruby-server',
-      'sdkVersion' => '2.0.1',
+      'sdkVersion' => '2.2.0',
       'languageVersion' => RUBY_VERSION
     }
   end

data/lib/statsig_driver.rb

@@ -43,6 +43,10 @@ class StatsigDriver
     end
   end
 
+  def get_initialization_details
+    @store.get_initialization_details
+  end
+
   def get_gate_impl(
     user,
     gate_name,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statsig
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.2.0
 platform: ruby
 authors:
 - Statsig, Inc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-08-06 00:00:00.000000000 Z
+date: 2024-10-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler