statsig 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd554df4ba15f0d1addaecc5e76502c1218c1b08842152eeeffd0f6e121dbcba
-  data.tar.gz: b1d19d91608685488db9705e213559c4a36c21731b0822137b55fab0693a871d
+  metadata.gz: 3870c3be99d3f7295c21311a6e938599bbd0ebd260d4b2c2cb814b48d22bd7f4
+  data.tar.gz: 618400ee2baa54a9e4bc18ee7e6e1a1cb017349a513919dd5f5e6caa380fb154
 SHA512:
-  metadata.gz: b360f7fb18b06e87b538eb005ce0f7344f8a633a1cb9915d3e6f74e5b0fab3b7d87d46ab4b4498548e66766d00a4f60a9bb5f502c270e09925e67c24575da7ca
-  data.tar.gz: 337e0fd5ecfc11fa5565980df91d21ee17cc6586d49f1a18b333eaa4de1da29094c453a00daf1671ce8e6872d03882b85c169df6709aa41e543500cdc5c78057
+  metadata.gz: 47fdd678ef31a026f84bf81a184b39fc171c4d35cb7fb9229ecc2ec835051645cd9ed7b4f6ec2c0bfb92c2b59fe6cd9e742afaff176b438192f6d7b8d07f7ceb
+  data.tar.gz: 6db827709c35c1005a22dbf07e81f3ee8d6f316c89ba760beea2ba4adf2a35ae1d5ad2ea97604411733f61e4d167a6ebcbfa1e0dcef05986aacde37aab76dcf0

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.1.0',
+      '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.1.0
+  version: 2.2.0
 platform: ruby
 authors:
 - Statsig, Inc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-09-26 00:00:00.000000000 Z
+date: 2024-10-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler