statsig 2.9.5 → 2.9.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 586f005d7a1af26a5d438108db857f5ecda9d1878731b0fc84ff45af1535883d
-  data.tar.gz: 05b8a59f87064567595cd24822aca41c32c6072eea1913472de6361b91e740c6
+  metadata.gz: '0652683b8a04c0258b6d37d076ac8ae2d44523fdb52d042d992dcc948693e1e7'
+  data.tar.gz: c7fd0cf211bcfdb60164f988109ee155f18dd534f6b8e97c767b9a1d68cfd3f9
 SHA512:
-  metadata.gz: 0d478c616bf28da46254cfe1b0a4759a7f9ab2dc41528824ecd27418d17d04b19727bd24dc34d0b3b377a4c1fc0615ae3676d3d17445f7eaf4e5ae7c29747c53
-  data.tar.gz: 1d44a8ad76811956dd5a963e741ab1eb805a615945da3a03f6ea440763c245dc3ff3afdc01af52d01dae5996d57c48de596e87f98341d8eaedbeb4a9a05550ae
+  metadata.gz: 295de37f1befbfe8e627a2d70e34597dae27791b4850433ab61295120fb15aefd4cfee1f311872ee183254364cbcf8c10746eddd878db24459470ed9654f4be6
+  data.tar.gz: d84fa2839e8a55e1b029d932b30c381172dd75190380d37b6750d7716593bb5dc9ea849ebbb94b3c58c237daffe4718f7987bbfdb2a2e9054d6f64d62eb2743c

data/lib/network.rb

@@ -53,8 +53,8 @@ module Statsig
       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"
+    def download_config_specs_fallback(base_url, since_time, context)
+      dcs_url = "#{base_url}#{@server_secret}.json"
       if since_time.positive?
         dcs_url += "?sinceTime=#{since_time}"
       end

data/lib/spec_store.rb

@@ -87,8 +87,8 @@ 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')
+        if !failure_details.nil?
+          failure_details = download_config_specs_fallbacks('initialize', failure_details)
         end
       end
 
@@ -220,8 +220,8 @@ module Statsig
         @sync_failure_count = 0
       else
         @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')
+        if @sync_failure_count % STATSIG_NETWORK_FALLBACK_THRESHOLD == 0
+          download_config_specs_fallbacks('config_sync', failure_details)
         end
       end
 
@@ -243,9 +243,27 @@ module Statsig
       !@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)
+    def fallback_urls
+      configured = @options.download_config_specs_fallback_urls
+      if configured.nil?
+        return [] unless @options.fallback_to_statsig_api && using_proxy_for_dcs?
+        configured = ["#{STATSIG_CDN_DCS_BASE}/download_config_specs/"]
+      end
+
+      primary = @options.download_config_specs_url
+      primary = "#{primary}/" unless primary.end_with?('/')
+      configured.map { |url| url.end_with?('/') ? url : "#{url}/" }
+                .reject { |url| url == primary }
+                .uniq
+    end
+
+    def download_config_specs_fallbacks(context, failure_details)
+      fallback_urls.each do |base_url|
+        response, e = @network.download_config_specs_fallback(base_url, @last_config_sync_time, context)
+        failure_details = handle_config_specs_response(context, 'download_config_specs_fallback', 'CONFIG_SPECS_FALLBACK', response, e)
+        break if failure_details.nil?
+      end
+      failure_details
     end
 
     def handle_config_specs_response(context, diagnostic_key, error_prefix, response, e)

data/lib/statsig.rb

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

data/lib/statsig_options.rb

@@ -13,6 +13,11 @@ class StatsigOptions
   # The url used specifically to call download_config_specs.
   attr_accessor :download_config_specs_url
 
+  # Ordered full download_config_specs endpoint bases to try after the primary fails.
+  # nil preserves fallback_to_statsig_api behavior; [] disables fallback. An explicit
+  # list takes precedence over fallback_to_statsig_api, including when it is false.
+  attr_accessor :download_config_specs_fallback_urls
+
   # The url used specifically to call log_event.
   attr_accessor :log_event_url
 
@@ -127,7 +132,8 @@ class StatsigOptions
     user_persistent_storage: nil,
     disable_evaluation_memoization: false,
     initialize_retry_limit: 0,
-    fallback_to_statsig_api: false
+    fallback_to_statsig_api: false,
+    download_config_specs_fallback_urls: nil
   )
     @environment = environment.is_a?(Hash) ? environment : nil
 
@@ -136,6 +142,9 @@ class StatsigOptions
       dcs_url += '/'
     end
     @download_config_specs_url = dcs_url
+    @download_config_specs_fallback_urls = download_config_specs_fallback_urls&.map do |url|
+      url.end_with?('/') ? url : "#{url}/"
+    end
 
     @log_event_url = log_event_url || 'https://statsigapi.net/v1/log_event'
     @get_id_lists_url = get_id_lists_url || 'https://statsigapi.net/v1/get_id_lists'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statsig
 version: !ruby/object:Gem::Version
-  version: 2.9.5
+  version: 2.9.6
 platform: ruby
 authors:
 - Statsig, Inc
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-22 00:00:00.000000000 Z
+date: 2026-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler