statsig 1.8.4 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6b5d1c640eab6b3173784683e1e87c41c97410631aaea5e9e68306cd45df829
-  data.tar.gz: c78cb2b73b63f496672a2486a8fb7fe212dc4192838b4cf72a5e191f9b4d065f
+  metadata.gz: a832901a7d272c5b27408418836ded1042f720bfc0a374489ed0a81c476a1606
+  data.tar.gz: c89426f15ab949980299bfc21931466d076e8b23fbe26ddc290e13d1d92cb948
 SHA512:
-  metadata.gz: 2b4601bb00d1287c24aceca4e85d9e4c786225d6c42a8abb8bd70ab687d6d0ce508e3e762b302306617d3f17e81d693293509aa1f1550ab3ad670c4bca464737
-  data.tar.gz: d5518fc18cd937879281663b1592e286fbe45cd2a222e5ef6ab7659443fb5f5db4875ba7f29d7acbe28a5f81b8bec54195123617f58db09fa442b2ec224c1559
+  metadata.gz: c92f462bf372241bdd214a9a153b597792970b70631b8631be3df01b189953b6574016eedf437e397e07f62c8ef8f1c3e7ab7834f10080febe9843514cb059e0
+  data.tar.gz: 228deaad6a9c224c80321ddc6bd33ab13a4cd6eae86cc83f822f5d8325f25aaa13bfd0903369468b3664d28847b3239df27a446b32b349e5b3d987f77ef3fb74

data/lib/config_result.rb

@@ -6,13 +6,15 @@ module Statsig
     attr_accessor :json_value
     attr_accessor :rule_id
     attr_accessor :secondary_exposures
+    attr_accessor :config_delegate
 
-    def initialize(name, gate_value = false, json_value = {}, rule_id = '', secondary_exposures = [])
+    def initialize(name, gate_value = false, json_value = {}, rule_id = '', secondary_exposures = [], config_delegate = '')
       @name = name
       @gate_value = gate_value
       @json_value = json_value
       @rule_id = rule_id
       @secondary_exposures = secondary_exposures.is_a?(Array) ? secondary_exposures : []
+      @config_delegate = config_delegate
     end
   end
 end

data/lib/evaluator.rb

@@ -29,6 +29,11 @@ module Statsig
       eval_spec(user, @spec_store.get_config(config_name))
     end
 
+    def get_layer(user, layer_name)
+      return nil unless @initialized && @spec_store.has_layer?(layer_name)
+      eval_spec(user, @spec_store.get_layer(layer_name))
+    end
+
     def shutdown
       @spec_store.shutdown
     end
@@ -44,15 +49,16 @@ module Statsig
           rule = config['rules'][i]
           result = eval_rule(user, rule)
           return $fetch_from_server if result == $fetch_from_server
-          exposures = exposures + result['exposures'] if result['exposures'].is_a? Array
-          if result['value']
+          exposures = exposures + result.secondary_exposures
+          if result.gate_value
             pass = eval_pass_percent(user, rule, config['salt'])
             return Statsig::ConfigResult.new(
               config['name'],
               pass,
-              pass ? rule['returnValue'] : config['defaultValue'],
-              rule['id'],
-              exposures
+              pass ? result.json_value : config['defaultValue'],
+              result.rule_id,
+              exposures,
+              result.config_delegate
             )
           end
 
@@ -83,7 +89,16 @@ module Statsig
         end
         i += 1
       end
-      { 'value' => pass, 'exposures' => exposures }
+
+      delegate = rule['configDelegate']
+      if pass and @spec_store.get_config(delegate)
+        delegated_result = self.eval_spec(user, @spec_store.get_config(delegate))
+        delegated_result.config_delegate = delegate
+        delegated_result.secondary_exposures = exposures + delegated_result.secondary_exposures
+        return delegated_result
+      end
+
+      Statsig::ConfigResult.new('', pass, rule['returnValue'], rule['id'], exposures)
     end
 
     def eval_condition(user, condition)

data/lib/layer.rb

@@ -0,0 +1,15 @@
+class Layer
+  attr_accessor :name
+  attr_accessor :rule_id
+
+  def initialize(name, value = {}, rule_id = '')
+    @name = name
+    @value = value
+    @rule_id = rule_id
+  end
+
+  def get(index, default_value)
+    return default_value if @value.nil? || !@value.key?(index)
+    @value[index]
+  end
+end

data/lib/network.rb

@@ -1,6 +1,5 @@
 require 'http'
 require 'json'
-require 'dynamic_config'
 
 $retry_codes = [408, 500, 502, 503, 504, 522, 524, 599]
 

data/lib/spec_store.rb

@@ -11,6 +11,7 @@ module Statsig
       @store = {
         :gates => {},
         :configs => {},
+        :layers => {},
         :id_lists => {},
       }
       e = download_config_specs
@@ -34,6 +35,10 @@ module Statsig
       @store[:configs].key?(config_name)
     end
 
+    def has_layer?(layer_name)
+      @store[:layers].key?(layer_name)
+    end
+
     def get_gate(gate_name)
       return nil unless has_gate?(gate_name)
       @store[:gates][gate_name]
@@ -44,6 +49,11 @@ module Statsig
       @store[:configs][config_name]
     end
 
+    def get_layer(layer_name)
+      return nil unless has_layer?(layer_name)
+      @store[:layers][layer_name]
+    end
+
     def get_id_list(list_name)
       @store[:id_lists][list_name]
     end
@@ -89,15 +99,19 @@ module Statsig
       @last_sync_time = specs_json['time'] || @last_sync_time
       return unless specs_json['has_updates'] == true &&
         !specs_json['feature_gates'].nil? &&
-        !specs_json['dynamic_configs'].nil?
+        !specs_json['dynamic_configs'].nil? &&
+        !specs_json['layer_configs'].nil? 
 
       new_gates = {}
       new_configs = {}
+      new_layers = {}
 
       specs_json['feature_gates'].map{|gate|  new_gates[gate['name']] = gate }
       specs_json['dynamic_configs'].map{|config|  new_configs[config['name']] = config }
+      specs_json['layer_configs'].map{|layer|  new_layers[layer['name']] = layer }
       @store[:gates] = new_gates
       @store[:configs] = new_configs
+      @store[:layers] = new_layers
 
       new_id_lists = specs_json['id_lists']
       if new_id_lists.is_a? Hash

data/lib/statsig.rb

@@ -25,6 +25,11 @@ module Statsig
     @shared_instance&.get_config(user, experiment_name)
   end
 
+  def self.get_layer(user, layer_name)
+    ensure_initialized
+    @shared_instance&.get_config(user, layer_name)
+  end
+
   def self.log_event(user, event_name, value, metadata)
     ensure_initialized
     @shared_instance&.log_event(user, event_name, value, metadata)
@@ -40,7 +45,7 @@ module Statsig
   def self.get_statsig_metadata
     {
       'sdkType' => 'ruby-server',
-      'sdkVersion' => '1.8.4',
+      'sdkVersion' => '1.9.0',
     }
   end
 

data/lib/statsig_driver.rb

@@ -26,12 +26,7 @@ class StatsigDriver
   end
 
   def check_gate(user, gate_name)
-    validate_user(user)
-    user = normalize_user(user)
-    if !gate_name.is_a?(String) || gate_name.empty?
-      raise 'Invalid gate_name provided'
-    end
-    check_shutdown
+    user = verify_inputs(user, gate_name, "gate_name")
 
     res = @evaluator.check_gate(user, gate_name)
     if res.nil?
@@ -49,33 +44,34 @@ class StatsigDriver
   end
 
   def get_config(user, dynamic_config_name)
-    validate_user(user)
-    user = normalize_user(user)
-    if !dynamic_config_name.is_a?(String) || dynamic_config_name.empty?
-      raise "Invalid dynamic_config_name provided"
-    end
-    check_shutdown
+    user = verify_inputs(user, dynamic_config_name, "dynamic_config_name")
+    get_config_impl(user, dynamic_config_name)
+  end
 
-    res = @evaluator.get_config(user, dynamic_config_name)
+  def get_experiment(user, experiment_name)
+    user = verify_inputs(user, experiment_name, "experiment_name")
+    get_config_impl(user, experiment_name)
+  end
+
+  def get_layer(user, layer_name)
+    user = verify_inputs(user, layer_name, "layer_name")
+
+    res = @evaluator.get_layer(user, layer_name)
     if res.nil?
-      res = Statsig::ConfigResult.new(dynamic_config_name)
+      res = Statsig::ConfigResult.new(layer_name)
     end
 
     if res == $fetch_from_server
-      res = get_config_fallback(user, dynamic_config_name)
+      if res.config_delegate.empty?
+        return Layer.new(layer_name)
+      end
+      res = get_config_fallback(user, res.config_delegate)
       # exposure logged by the server
     else
-      @logger.log_config_exposure(user, res.name, res.rule_id, res.secondary_exposures)
+      @logger.log_layer_exposure(user, res.name, res.rule_id, res.secondary_exposures, res.config_delegate)
     end
 
-    DynamicConfig.new(res.name, res.json_value, res.rule_id)
-  end
-
-  def get_experiment(user, experiment_name)
-    if !experiment_name.is_a?(String) || experiment_name.empty?
-      raise "Invalid experiment_name provided"
-    end
-    get_config(user, experiment_name)
+    Layer.new(res.name, res.json_value, res.rule_id)
   end
 
   def log_event(user, event_name, value = nil, metadata = nil)
@@ -102,6 +98,32 @@ class StatsigDriver
 
   private
 
+  def verify_inputs(user, config_name, variable_name)
+    validate_user(user)
+    if !config_name.is_a?(String) || config_name.empty?
+      raise "Invalid " + variable_name +" provided"
+    end
+
+    check_shutdown
+    normalize_user(user)
+  end
+
+  def get_config_impl(user, config_name)
+    res = @evaluator.get_config(user, config_name)
+    if res.nil?
+      res = Statsig::ConfigResult.new(config_name)
+    end
+
+    if res == $fetch_from_server
+      res = get_config_fallback(user, config_name)
+      # exposure logged by the server
+    else
+      @logger.log_config_exposure(user, res.name, res.rule_id, res.secondary_exposures)
+    end
+
+    DynamicConfig.new(res.name, res.json_value, res.rule_id)
+  end
+
   def validate_user(user)
     if user.nil? || !user.instance_of?(StatsigUser) || !user.user_id.is_a?(String)
       raise 'Must provide a valid StatsigUser with a user_id to use the server SDK. See https://docs.statsig.com/messages/serverRequiredUserID/ for more details.'

data/lib/statsig_logger.rb

@@ -2,6 +2,7 @@ require 'statsig_event'
 
 $gate_exposure_event = 'statsig::gate_exposure'
 $config_exposure_event = 'statsig::config_exposure'
+$layer_exposure_event = 'statsig::layer_exposure'
 
 module Statsig
   class StatsigLogger
@@ -43,6 +44,19 @@ module Statsig
       log_event(event)
     end
 
+    def log_layer_exposure(user, config_name, rule_id, secondary_exposures, allocated_experiment)
+      event = StatsigEvent.new($layer_exposure_event)
+      event.user = user
+      event.metadata = {
+        'config' => config_name,
+        'ruleID' => rule_id,
+        'allocatedExperiment' => allocated_experiment
+      }
+      event.statsig_metadata = Statsig.get_statsig_metadata
+      event.secondary_exposures = secondary_exposures.is_a?(Array) ? secondary_exposures : []
+      log_event(event)
+    end
+
     def periodic_flush
       Thread.new do
         loop do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statsig
 version: !ruby/object:Gem::Version
-  version: 1.8.4
+  version: 1.9.0
 platform: ruby
 authors:
 - Statsig, Inc
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-02-11 00:00:00.000000000 Z
+date: 2022-03-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -118,6 +118,7 @@ files:
 - lib/dynamic_config.rb
 - lib/evaluation_helpers.rb
 - lib/evaluator.rb
+- lib/layer.rb
 - lib/network.rb
 - lib/spec_store.rb
 - lib/statsig.rb
@@ -145,7 +146,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Statsig server SDK for Ruby