statsig 2.9.1 → 2.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 800d73e16d593bd9c6b505f9d6207c47e51d8b700344b3c653a07ca8b257cd69
-  data.tar.gz: a3cad13252aff42d5eba3e4f9c9b478adb9ec0758633102f2ada9b3d3739052e
+  metadata.gz: 5371899fd2582b8e213db4bfc0c0c9252e2a7e16ff1303c94fa7e1cecc43cfda
+  data.tar.gz: 786baba109ff66e4c38ffc4c71995fdf5fde54910ac0d7712cdfb9b85ac584f4
 SHA512:
-  metadata.gz: f9a1df9789f61b60bb4d015da636b20bf081804b5c1c8d1f542afc3f494538fea68b3bc84ca65d7faf513c63d8d0d72bee94f2583a932c7d54ae0c3cdff560e7
-  data.tar.gz: a7d46bfa64e8a52c60eec3bc14c596ff9ffe41493ed68bda741d4171c75da407e7e7842ad63c76addff0c98314d95967b515801efba8f1f5486d8aabc793fc8e
+  metadata.gz: e4dc2ad08e71c883d41ecfa012f9e592c6ece9e18e8e14b9f0df9c5ef0732140dddf7cd0f6b88e27516efdbfa89e0d7309e2763fb634b73da0de082eb78b84f3
+  data.tar.gz: 9fc9b841b4d3f6020b9ea71a87203155a5eef84641ac1f7ff52a1e8913ef1735e3f49ef3730575d67050b1c00b7e61d0953a00b4cfc001af8e5b31277499f6d1

data/lib/network.rb

@@ -7,6 +7,7 @@ require 'zlib'
 RETRY_CODES = [408, 500, 502, 503, 504, 522, 524, 599].freeze
 
 module Statsig
+  STATSIG_CDN_DCS_BASE = 'https://api.statsigcdn.com/v2'.freeze
   class NetworkError < StandardError
     attr_reader :http_code
 
@@ -18,6 +19,14 @@ module Statsig
 
   class Network
 
+    # Background config-spec sync retries transient failures with a short, bounded
+    # exponential backoff, matching statsig-server-core's background sync strategy
+    # (3 retries; 2^n * 100ms => 200ms, 400ms, 800ms). These are fixed rather than
+    # user-configurable, mirroring server-core where the values are hardcoded.
+    CONFIG_SYNC_RETRY_LIMIT = 3
+    CONFIG_SYNC_RETRY_BACKOFF_SECONDS = 0.2
+    CONFIG_SYNC_RETRY_BACKOFF_MULTIPLIER = 2
+
     def initialize(server_secret, options, backoff_mult = 10)
       super()
       @options = options
@@ -41,6 +50,14 @@ module Statsig
       if context == 'initialize'
         return get(dcs_url, @options.initialize_retry_limit)
       end
+      get(dcs_url, CONFIG_SYNC_RETRY_LIMIT, CONFIG_SYNC_RETRY_BACKOFF_SECONDS, CONFIG_SYNC_RETRY_BACKOFF_MULTIPLIER)
+    end
+
+    def download_config_specs_fallback(since_time, context)
+      dcs_url = "#{STATSIG_CDN_DCS_BASE}/download_config_specs/#{@server_secret}.json"
+      if since_time.positive?
+        dcs_url += "?sinceTime=#{since_time}"
+      end
       get(dcs_url)
     end
 
@@ -75,8 +92,8 @@ module Statsig
       request(:GET, url, nil, 0, 1, false, 0, { 'Range' => "bytes=#{start_byte}-" }, false)
     end
 
-    def get(url, retries = 0, backoff = 1)
-      request(:GET, url, nil, retries, backoff)
+    def get(url, retries = 0, backoff = 1, backoff_multiplier = @backoff_multiplier)
+      request(:GET, url, nil, retries, backoff, false, 0, {}, true, backoff_multiplier)
     end
 
     def post(url, body, retries = 0, backoff = 1, zipped = false, event_count = 0)
@@ -97,7 +114,7 @@ module Statsig
       end
     end
 
-    def request(method, url, body, retries = 0, backoff = 1, zipped = false, event_count = 0, extra_headers = {}, use_statsig_headers = true)
+    def request(method, url, body, retries = 0, backoff = 1, zipped = false, event_count = 0, extra_headers = {}, use_statsig_headers = true, backoff_multiplier = @backoff_multiplier)
       if @local_mode
         return nil, nil
       end
@@ -137,7 +154,7 @@ module Statsig
         return nil, e unless retries.positive?
 
         sleep backoff_adjusted
-        return request(method, url, body, retries - 1, backoff * @backoff_multiplier, zipped, event_count, extra_headers, use_statsig_headers)
+        return request(method, url, body, retries - 1, backoff * backoff_multiplier, zipped, event_count, extra_headers, use_statsig_headers, backoff_multiplier)
       end
       return res, nil if res.status.success?
 
@@ -148,7 +165,7 @@ module Statsig
 
       ## status code retry
       sleep backoff_adjusted
-      request(method, url, body, retries - 1, backoff * @backoff_multiplier, zipped, event_count, extra_headers, use_statsig_headers)
+      request(method, url, body, retries - 1, backoff * backoff_multiplier, zipped, event_count, extra_headers, use_statsig_headers, backoff_multiplier)
     end
 
     private

data/lib/spec_store.rb

@@ -6,6 +6,8 @@ require_relative 'id_list'
 
 module Statsig
   class SpecStore
+    STATSIG_NETWORK_FALLBACK_THRESHOLD = 5
+
     attr_accessor :last_config_sync_time
     attr_accessor :initial_config_sync_time
     attr_accessor :init_reason
@@ -48,6 +50,7 @@ module Statsig
       @secret_key = secret_key
       @unsupported_configs = Set.new
       @sdk_configs = sdk_config
+      @sync_failure_count = 0
 
       startTime = (Time.now.to_f * 1000).to_i
 
@@ -84,6 +87,9 @@ module Statsig
 
       if @init_reason == EvaluationReason::UNINITIALIZED
         failure_details = download_config_specs('initialize')
+        if !failure_details.nil? && @options.fallback_to_statsig_api && using_proxy_for_dcs?
+          failure_details = download_config_specs_fallback('initialize')
+        end
       end
 
       @initial_config_sync_time = @last_config_sync_time == 0 ? -1 : @last_config_sync_time
@@ -205,10 +211,20 @@ module Statsig
 
     def sync_config_specs
       if @options.data_store&.should_be_used_for_querying_updates(Interfaces::IDataStore::CONFIG_SPECS_V2_KEY)
-        load_config_specs_from_storage_adapter('config_sync')
+        failure_details = load_config_specs_from_storage_adapter('config_sync')
+      else
+        failure_details = download_config_specs('config_sync')
+      end
+
+      if failure_details.nil?
+        @sync_failure_count = 0
       else
-        download_config_specs('config_sync')
+        @sync_failure_count += 1
+        if @options.fallback_to_statsig_api && using_proxy_for_dcs? && (@sync_failure_count % STATSIG_NETWORK_FALLBACK_THRESHOLD == 0)
+          download_config_specs_fallback('config_sync')
+        end
       end
+
       @logger.log_diagnostics_event(@diagnostics, 'config_sync')
     end
 
@@ -223,6 +239,58 @@ module Statsig
 
     private
 
+    def using_proxy_for_dcs?
+      !@options.download_config_specs_url.start_with?(STATSIG_CDN_DCS_BASE)
+    end
+
+    def download_config_specs_fallback(context)
+      response, e = @network.download_config_specs_fallback(@last_config_sync_time, context)
+      handle_config_specs_response(context, 'download_config_specs_fallback', 'CONFIG_SPECS_FALLBACK', response, e)
+    end
+
+    def handle_config_specs_response(context, diagnostic_key, error_prefix, response, e)
+      tracker = @diagnostics.track(context, diagnostic_key, 'network_request')
+
+      error = nil
+      failure_details = nil
+      begin
+        code = response&.status.to_i
+        if e.is_a? NetworkError
+          code = e.http_code
+          failure_details = {statusCode: code, exception: e, reason: "#{error_prefix}_NETWORK_ERROR"}
+        elsif !e.nil?
+          # Transport-level errors (ECONNREFUSED, timeout, DNS, SSL) are caught and returned as values
+          # by network.rb. Without this, failure_details stays nil and the caller treats it as success.
+          failure_details = {exception: e, reason: "#{error_prefix}_CONNECTION_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, diagnostic_key, 'process')
+            body = response.body.to_s
+            failure_details = process_specs(body)
+            if failure_details.nil?
+              @init_reason = EvaluationReason::NETWORK
+            end
+            tracker.end(success: @init_reason == EvaluationReason::NETWORK)
+
+            unless response.body.nil? or @rules_updated_callback.nil?
+              @rules_updated_callback.call(body, @last_config_sync_time)
+            end
+          end
+        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 load_config_specs_from_storage_adapter(context)
       tracker = @diagnostics.track(context, 'data_store_config_specs', 'fetch')
       cached_values = @options.data_store.get(Interfaces::IDataStore::CONFIG_SPECS_V2_KEY)
@@ -284,44 +352,8 @@ module Statsig
     end
 
     def download_config_specs(context)
-      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, context)
-        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')
-            body = response.body.to_s
-            failure_details = process_specs(body)
-            if failure_details.nil?
-              @init_reason = EvaluationReason::NETWORK
-            end
-            tracker.end(success: @init_reason == EvaluationReason::NETWORK)
-
-            unless response.body.nil? or @rules_updated_callback.nil?
-              @rules_updated_callback.call(body,
-                                           @last_config_sync_time)
-            end
-          end
-        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
+      response, e = @network.download_config_specs(@last_config_sync_time, context)
+      handle_config_specs_response(context, 'download_config_specs', 'CONFIG_SPECS', response, e)
     end
 
     def process_specs(specs_string, from_adapter: false)

data/lib/statsig.rb

@@ -410,7 +410,7 @@ module Statsig
   def self.get_statsig_metadata
     {
       'sdkType' => 'ruby-server',
-      'sdkVersion' => '2.9.1',
+      'sdkVersion' => '2.9.3',
       'languageVersion' => RUBY_VERSION
     }
   end

data/lib/statsig_driver.rb

@@ -34,6 +34,7 @@ class StatsigDriver
       tracker = @diagnostics.track('initialize', 'overall')
       @options = options || StatsigOptions.new
       @shutdown = false
+      @shutdown_message_logged = false
       @secret_key = secret_key
       @net = Statsig::Network.new(secret_key, @options)
       @logger = Statsig::StatsigLogger.new(@net, @options, @err_boundary, @sdk_configs)
@@ -460,8 +461,10 @@ class StatsigDriver
   end
 
   def check_shutdown
-    if @shutdown
-      puts 'SDK has been shutdown.  Updates in the Statsig Console will no longer reflect.'
-    end
+    return unless @shutdown
+    return if @shutdown_message_logged
+
+    @shutdown_message_logged = true
+    puts '[Statsig]: SDK has been shutdown.  Updates in the Statsig Console will no longer reflect.'
   end
 end

data/lib/statsig_options.rb

@@ -96,6 +96,12 @@ class StatsigOptions
   # default: 0
   attr_accessor :initialize_retry_limit
 
+  # When true, if the configured download_config_specs_url fails, the SDK will
+  # automatically fall back to the Statsig CDN to fetch config specs.
+  # Only effective when a custom download_config_specs_url is configured.
+  # default: false
+  attr_accessor :fallback_to_statsig_api
+
   def initialize(
     environment = nil,
     download_config_specs_url: nil,
@@ -120,7 +126,8 @@ class StatsigOptions
     post_logs_retry_backoff: nil,
     user_persistent_storage: nil,
     disable_evaluation_memoization: false,
-    initialize_retry_limit: 0
+    initialize_retry_limit: 0,
+    fallback_to_statsig_api: false
   )
     @environment = environment.is_a?(Hash) ? environment : nil
 
@@ -152,5 +159,6 @@ class StatsigOptions
     @user_persistent_storage = user_persistent_storage
     @disable_evaluation_memoization = disable_evaluation_memoization
     @initialize_retry_limit = initialize_retry_limit
+    @fallback_to_statsig_api = fallback_to_statsig_api
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statsig
 version: !ruby/object:Gem::Version
-  version: 2.9.1
+  version: 2.9.3
 platform: ruby
 authors:
 - Statsig, Inc
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-29 00:00:00.000000000 Z
+date: 2026-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler