statsig 2.9.1 → 2.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 800d73e16d593bd9c6b505f9d6207c47e51d8b700344b3c653a07ca8b257cd69
-  data.tar.gz: a3cad13252aff42d5eba3e4f9c9b478adb9ec0758633102f2ada9b3d3739052e
+  metadata.gz: cb1b471ac9aa8827bb59d3dd18801a1d7e663e8e3d25ea44be09753f02953ecf
+  data.tar.gz: 5d08845dba73c8af7978c38c8519e790361a27dd4ed10f940a8af61d6c1b13e2
 SHA512:
-  metadata.gz: f9a1df9789f61b60bb4d015da636b20bf081804b5c1c8d1f542afc3f494538fea68b3bc84ca65d7faf513c63d8d0d72bee94f2583a932c7d54ae0c3cdff560e7
-  data.tar.gz: a7d46bfa64e8a52c60eec3bc14c596ff9ffe41493ed68bda741d4171c75da407e7e7842ad63c76addff0c98314d95967b515801efba8f1f5486d8aabc793fc8e
+  metadata.gz: ca761ef81609cbd94bec7294109c893c683477c55c39f6475161269b65a7275e416253d8299e7f1995111d38d7bd7d09687aa8091bb90ffa0762daf609141f85
+  data.tar.gz: 29d1482c76a1d78be0fd6e7c80886068a23c1973683050db19a08fa4d6a0b855a2549f24ebbadb6bc391669e09085b0bedc263db76cee9ea736099cf58b5fd80

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
 
@@ -44,6 +45,14 @@ module Statsig
       get(dcs_url)
     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
+
     def post_logs(events, error_boundary)
       url = @options.log_event_url
       event_count = events.length

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.2',
       'languageVersion' => RUBY_VERSION
     }
   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.2
 platform: ruby
 authors:
 - Statsig, Inc
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-29 00:00:00.000000000 Z
+date: 2026-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler