statsig 0.1.3 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f41a1d20b9c249d023d561e447fc4f7dc746107e4215074596b405a3c22598bc
-  data.tar.gz: 3a285af817ab26710aff500afe493d7d79153d652fc62cb1c36b993e98812fb4
+  metadata.gz: 3ac164a57fadf37c1c9ce2b978df30da43901cc3b53e03e1b3e52a72e19981cb
+  data.tar.gz: aad0387cd6a80bfd3cbf501118466f444790ec387b45a96d562a3256331ae034
 SHA512:
-  metadata.gz: e29c7d17b69110935f96141a98faff6fa4644a795c4b7fd6600c04fe3835ad97cbf8928d1acc43742491d0c0c61d3247243c695cadbecf3ec618748377774b90
-  data.tar.gz: 0dc599774ade558878168fd121c3ceb4df2ca88e51b1bca16c2eb0fce52b8d1b0f23237215e49c92b11b6e07edd1a8d01788bbfe8e251c227fb4d59b35e59ebd
+  metadata.gz: f7eeefd82a45217becadee9783d2616de5e6997d29236fecea526947a34e54f921125fbf018f57a1fbf2f7560c00d80721f632a9498e0f065b6914b035beef5f
+  data.tar.gz: 24b8c55535b7656109b669d898351e536953c83ecc6858e94eabacbdb36f8c9e600b55bb9cd06fc8b043a84305f351e645c07a673a85c1688668de6181c125f3

data/lib/dynamic_config.rb

@@ -9,8 +9,8 @@ class DynamicConfig
     @rule_id = rule_id
   end
 
-  def get(index)
-    return nil if @value.nil?
-    value[index]
+  def get(index, default_value)
+    return default_value if @value.nil? || !@value.key?(index)
+    @value[index]
   end
 end

data/lib/evaluation_helpers.rb

@@ -1,3 +1,5 @@
+require 'time'
+
 module EvaluationHelpers
   def self.compare_numbers(a, b, func)
     return false unless self.is_numeric(a) && self.is_numeric(b)
@@ -5,16 +7,28 @@ module EvaluationHelpers
   end
 
   # returns true if array contains value, ignoring case when comparing strings
-  def self.array_contains(array, value)
+  def self.array_contains(array, value, ignore_case)
     return false unless array.is_a?(Array) && !value.nil?
-    return array.include?(value) unless value.is_a?(String)
-    array.any?{ |s| s.is_a?(String) && s.casecmp(value) == 0 } rescue false
+    if value.is_a?(String) && match_string_in_array(array, value, ignore_case, ->(a, b) { a == b })
+      return true
+    end
+    return array.include?(value)
   end
 
   # returns true if array has any element that evaluates to true with value using func lambda, ignoring case
-  def self.match_string_in_array(array, value, func)
+  def self.match_string_in_array(array, value, ignore_case, func)
     return false unless array.is_a?(Array) && value.is_a?(String)
-    array.any?{ |s| s.is_a?(String) && func.call(value.downcase, s.downcase) } rescue false
+    array.any?{ |s| s.is_a?(String) && ((ignore_case && func.call(value.downcase, s.downcase)) || func.call(value, s)) } rescue false
+  end
+
+  def self.compare_times(a, b, func)
+    begin
+      time_1 = self.get_epoch_time(a)
+      time_2 = self.get_epoch_time(b)
+      func.call(time_1, time_2)
+    rescue
+      false
+    end
   end
 
   private
@@ -22,4 +36,13 @@ module EvaluationHelpers
   def self.is_numeric(v)
     !(v.to_s =~ /\A[-+]?\d*\.?\d+\z/).nil?
   end
+
+  def self.get_epoch_time(v)
+    time = self.is_numeric(v) ? Time.at(v.to_f) : Time.parse(v)
+    if time.year > Time.now.year + 100
+      # divide by 1000 when the epoch time is in milliseconds instead of seconds
+      return time.to_i / 1000
+    end
+    return time.to_i
+  end
 end

data/lib/evaluator.rb

@@ -1,8 +1,11 @@
-require 'browser'
 require 'config_result'
+require 'country_lookup'
 require 'digest'
 require 'evaluation_helpers'
 require 'spec_store'
+require 'time'
+require 'user_agent_parser'
+require 'user_agent_parser/operating_system'
 
 $fetch_from_server = :fetch_from_server
 $type_dynamic_config = 'dynamic_config'
@@ -11,6 +14,8 @@ class Evaluator
   def initialize(store)
     @spec_store = store
     @initialized = true
+    @ua_parser = UserAgentParser::Parser.new
+    CountryLookup.initialize
   end
 
   def check_gate(user, gate_name)
@@ -65,36 +70,45 @@ class Evaluator
     target = condition['targetValue']
     type = condition['type']
     operator = condition['operator']
+    additional_values = condition['additionalValues']
+    additional_values = Hash.new unless additional_values.is_a? Hash
 
-    return $fetch_from_server unless type.is_a?(String)
+    return $fetch_from_server unless type.is_a? String
     type = type.downcase
 
     case type
     when 'public'
       return true
-    when 'fail_gate'
-    when 'pass_gate'
+    when 'fail_gate', 'pass_gate'
       other_gate_result = self.check_gate(user, target)
       return $fetch_from_server if other_gate_result == $fetch_from_server
-      return type == 'pass_gate' ? other_gate_result[:gate_value] : !other_gate_result[:gate_value]
+      return type == 'pass_gate' ? other_gate_result.gate_value : !other_gate_result.gate_value
     when 'ip_based'
-      value = get_value_from_user(user, field) || get_value_from_ip(user['ip'], field)
+      value = get_value_from_user(user, field) || get_value_from_ip(user&.value_lookup['ip'], field)
       return $fetch_from_server if value == $fetch_from_server
     when 'ua_based'
-      value = get_value_from_user(user, field) || get_value_from_ua(user['userAgent'], field)
+      value = get_value_from_user(user, field) || get_value_from_ua(user&.value_lookup['userAgent'], field)
       return $fetch_from_server if value == $fetch_from_server
     when 'user_field'
       value = get_value_from_user(user, field)
+    when 'environment_field'
+      value = get_value_from_environment(user, field)
     when 'current_time'
       value = Time.now.to_f # epoch time in seconds
+    when 'user_bucket'
+      begin
+        salt = additional_values['salt']
+        user_id = user.user_id || ''
+        # there are only 1000 user buckets as opposed to 10k for gate pass %
+        value = compute_user_hash("#{salt}.#{user_id}") % 1000
+      rescue
+        return false
+      end
     else
       return $fetch_from_server
     end
 
-    return $fetch_from_server if value == $fetch_from_server
-    return false if value.nil?
-
-    return $fetch_from_server unless operator.is_a?(String)
+    return $fetch_from_server if value == $fetch_from_server || !operator.is_a?(String)
     operator = operator.downcase
 
     case operator
@@ -124,17 +138,21 @@ class Evaluator
 
       # array operations
     when 'any'
-      return EvaluationHelpers::array_contains(target, value)
+      return EvaluationHelpers::array_contains(target, value, true)
     when 'none'
-      return !EvaluationHelpers::array_contains(target, value)
+      return !EvaluationHelpers::array_contains(target, value, true)
+    when 'any_case_sensitive'
+      return EvaluationHelpers::array_contains(target, value, false)
+    when 'none_case_sensitive'
+      return !EvaluationHelpers::array_contains(target, value, false)
 
       #string
     when 'str_starts_with_any'
-      return EvaluationHelpers::match_string_in_array(target, value, ->(a, b) { a.start_with?(b) })
+      return EvaluationHelpers::match_string_in_array(target, value, true, ->(a, b) { a.start_with?(b) })
     when 'str_ends_with_any'
-      return EvaluationHelpers::match_string_in_array(target, value, ->(a, b) { a.end_with?(b) })
+      return EvaluationHelpers::match_string_in_array(target, value, true, ->(a, b) { a.end_with?(b) })
     when 'str_contains_any'
-      return EvaluationHelpers::match_string_in_array(target, value, ->(a, b) { a.include?(b) })
+      return EvaluationHelpers::match_string_in_array(target, value, true, ->(a, b) { a.include?(b) })
     when 'str_matches'
       return (value.is_a?(String) && !(value =~ Regexp.new(target)).nil? rescue false)
     when 'eq'
@@ -144,11 +162,11 @@ class Evaluator
 
       # dates
     when 'before'
-      # TODO - planned future conditions
+      return EvaluationHelpers::compare_times(value, target, ->(a, b) { a < b })
     when 'after'
-      # TODO - planned future conditions
+      return EvaluationHelpers::compare_times(value, target, ->(a, b) { a > b })
     when 'on'
-      # TODO - planned future conditions
+      return EvaluationHelpers::compare_times(value, target, ->(a, b) { a.year == b.year && a.month == b.month && a.day == b.day })
     else
       return $fetch_from_server
     end
@@ -164,47 +182,61 @@ class Evaluator
     user_custom = user_lookup_table['custom']
     return nil unless user_custom.is_a?(Hash)
     user_custom.each do |key, value|
-      return value if key.downcase.casecmp(field.downcase)
+      return value if key.downcase.casecmp?(field.downcase)
+    end
+    nil
+  end
+
+  def get_value_from_environment(user, field)
+    return nil unless user.instance_of?(StatsigUser) && field.is_a?(String)
+    field = field.downcase
+    return nil unless user.statsig_environment.is_a? Hash
+    user.statsig_environment.each do |key, value|
+      return value if key.downcase == (field)
     end
+    nil
   end
 
   def get_value_from_ip(ip, field)
     return nil unless ip.is_a?(String) && field.is_a?(String)
-    # TODO
-    $fetch_from_server
+
+    if field.downcase != 'country'
+      return $fetch_from_server
+    end
+    CountryLookup.lookup_ip_string(ip)
   end
 
   def get_value_from_ua(ua, field)
     return nil unless ua.is_a?(String) && field.is_a?(String)
-    b = Browser.new(ua)
+    parsed = @ua_parser.parse ua
+    os = parsed.os
     case field.downcase
-    when 'os_name'
-      os_name = b.platform.name
-      # special case for iOS because value is 'iOS (iPhone)'
-      if os_name.include?('iOS') || os_name.include?('ios')
-        return 'iOS'
-      else
-        return os_name
-      end
-    when 'os_version'
-      return b.platform.version
-    when 'browser_name'
-      return b.name
-    when 'browser_version'
-      return b.full_version
+    when 'os_name', 'osname'
+      return os&.family
+    when 'os_version', 'osversion'
+      return os&.version unless os&.version.nil?
+    when 'browser_name', 'browsername'
+      return parsed.family
+    when 'browser_version', 'browserversion'
+      return parsed.version.to_s
     else
       nil
     end
   end
 
-  def eval_pass_percent(user, rule, salt)
-    return false unless salt.is_a?(String) && !rule['passPercentage'].nil?
+  def eval_pass_percent(user, rule, config_salt)
+    return false unless config_salt.is_a?(String) && !rule['passPercentage'].nil?
     begin
       user_id = user.user_id || ''
-      hash = Digest::SHA256.digest("#{salt}.#{rule['name']}.#{user_id}").unpack('Q>')[0]
-      return hash % 10000 < rule['passPercentage'].to_f * 100
+      rule_salt = rule['salt'] || rule['id'] || ''
+      hash = compute_user_hash("#{config_salt}.#{rule_salt}.#{user_id}")
+      return (hash % 10000) < (rule['passPercentage'].to_f * 100)
     rescue
       return false
     end
   end
+
+  def compute_user_hash(user_hash)
+    Digest::SHA256.digest(user_hash).unpack('Q>')[0]
+  end
 end

data/lib/network.rb

@@ -2,24 +2,47 @@ require 'http'
 require 'json'
 require 'dynamic_config'
 
+$retry_codes = [408, 500, 502, 503, 504, 522, 524, 599]
+
 class Network
-  def initialize(server_secret, api)
+  def initialize(server_secret, api, backoff_mult = 10)
     super()
     unless api.end_with?('/')
       api += '/'
     end
-    @http = HTTP
-        .headers({"STATSIG-API-KEY" => server_secret, "Content-Type" => "application/json; charset=UTF-8"})
-        .accept(:json)
+    @server_secret = server_secret
     @api = api
     @last_sync_time = 0
+    @backoff_multiplier = backoff_mult
+  end
+
+  def post_helper(endpoint, body, retries = 0, backoff = 1)
+    http = HTTP.headers(
+      {"STATSIG-API-KEY" => @server_secret,
+       "STATSIG-CLIENT-TIME" => (Time.now.to_f * 1000).to_s,
+       "Content-Type" => "application/json; charset=UTF-8"
+      }).accept(:json)
+    begin
+      res = http.post(@api + endpoint, body: body)
+    rescue
+      ## network error retry
+      return nil unless retries > 0
+      sleep backoff
+      return post_helper(endpoint, body, retries - 1, backoff * @backoff_multiplier)
+    end
+    return res unless !res.status.success?
+    return nil unless retries > 0 && $retry_codes.include?(res.code)
+    ## status code retry
+    sleep backoff
+    post_helper(endpoint, body, retries - 1, backoff * @backoff_multiplier)
   end
 
   def check_gate(user, gate_name)
     begin
       request_body = JSON.generate({'user' => user&.serialize, 'gateName' => gate_name})
-      response = @http.post(@api + 'check_gate', body: request_body)
-      return JSON.parse(response.body)
+      response = post_helper('check_gate', request_body)
+      return JSON.parse(response.body) unless response.nil?
+      false
     rescue
       return false
     end
@@ -28,8 +51,9 @@ class Network
   def get_config(user, dynamic_config_name)
     begin
       request_body = JSON.generate({'user' => user&.serialize, 'configName' => dynamic_config_name})
-      response = @http.post(@api + 'get_config', body: request_body)
-      return JSON.parse(response.body)
+      response = post_helper('get_config', request_body)
+      return JSON.parse(response.body) unless response.nil?
+      nil
     rescue
       return nil
     end
@@ -37,7 +61,8 @@ class Network
 
   def download_config_specs
     begin
-      response = @http.post(@api + 'download_config_specs', body: JSON.generate({'sinceTime' => @last_sync_time}))
+      response = post_helper('download_config_specs', JSON.generate({'sinceTime' => @last_sync_time}))
+      return nil unless !response.nil?
       json_body = JSON.parse(response.body)
       @last_sync_time = json_body['time']
       return json_body
@@ -61,9 +86,8 @@ class Network
   def post_logs(events, statsig_metadata)
     begin
       json_body = JSON.generate({'events' => events, 'statsigMetadata' => statsig_metadata})
-      @http.post(@api + 'log_event', body: json_body)
+      post_helper('log_event', body: json_body, retries: 5)
     rescue
-      # TODO: retries
     end
   end
 end

data/lib/statsig.rb

@@ -1,28 +1,33 @@
 require 'statsig_driver'
 
 module Statsig
-  def self.initialize(secret_key)
+  def self.initialize(secret_key, options = nil)
     unless @shared_instance.nil?
       puts 'Statsig already initialized.'
       return @shared_instance
     end
 
-    @shared_instance = StatsigDriver.new(secret_key)
+    @shared_instance = StatsigDriver.new(secret_key, options)
   end
 
   def self.check_gate(user, gate_name)
     self.ensure_initialized
-    @shared_instance.check_gate(user, gate_name)
+    @shared_instance&.check_gate(user, gate_name)
   end
 
   def self.get_config(user, dynamic_config_name)
     self.ensure_initialized
-    @shared_instance.get_config(user, dynamic_config_name)
+    @shared_instance&.get_config(user, dynamic_config_name)
+  end
+
+  def self.get_experiment(user, experiment_name)
+    self.ensure_initialized
+    @shared_instance&.get_config(user, experiment_name)
   end
 
   def self.log_event(user, event_name, value, metadata)
     self.ensure_initialized
-    @shared_instance.log_event(user, event_name, value, metadata)
+    @shared_instance&.log_event(user, event_name, value, metadata)
   end
 
   def self.shutdown

data/lib/statsig_driver.rb

@@ -3,18 +3,24 @@ require 'evaluator'
 require 'network'
 require 'statsig_event'
 require 'statsig_logger'
+require 'statsig_options'
 require 'statsig_user'
 require 'spec_store'
 
 class StatsigDriver
-  def initialize(secret_key)
+  def initialize(secret_key, options = nil)
     super()
     if !secret_key.is_a?(String) || !secret_key.start_with?('secret-')
       raise 'Invalid secret key provided. Provide your project secret key from the Statsig console'
     end
+    if !options.nil? && !options.instance_of?(StatsigOptions)
+      raise 'Invalid options provided. Either provide a valid StatsigOptions object or nil'
+    end
+
+    @options = options || StatsigOptions.new()
     @shutdown = false
     @secret_key = secret_key
-    @net = Network.new(secret_key, 'https://api.statsig.com/v1/')
+    @net = Network.new(secret_key, @options.api_url_base)
     @statsig_metadata = {
       'sdkType' => 'ruby-server',
       'sdkVersion' => Gem::Specification::load('statsig.gemspec')&.version,
@@ -33,9 +39,8 @@ class StatsigDriver
   end
 
   def check_gate(user, gate_name)
-    if !user.nil? && !user.instance_of?(StatsigUser)
-      raise 'Must provide a valid StatsigUser'
-    end
+    validate_user(user)
+    user = normalize_user(user)
     if !gate_name.is_a?(String) || gate_name.empty?
       raise 'Invalid gate_name provided'
     end
@@ -58,9 +63,8 @@ class StatsigDriver
   end
 
   def get_config(user, dynamic_config_name)
-    if !user.nil? && !user.instance_of?(StatsigUser)
-      raise 'Must provide a valid StatsigUser or nil'
-    end
+    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
@@ -89,6 +93,8 @@ class StatsigDriver
     end
     check_shutdown
 
+    user = normalize_user(user)
+
     event = StatsigEvent.new(event_name)
     event.user = user&.serialize
     event.value = value
@@ -99,12 +105,25 @@ class StatsigDriver
 
   def shutdown
     @shutdown = true
-    @logger.flush
+    @logger.flush(true)
     @polling_thread&.exit
   end
 
   private
 
+  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.'
+    end
+  end
+
+  def normalize_user(user)
+    if !@options&.environment.nil?
+      user.statsig_environment = @options.environment
+    end
+    user
+  end
+
   def check_shutdown
     if @shutdown
       puts 'SDK has been shutdown.  Updates in the Statsig Console will no longer reflect.'

data/lib/statsig_event.rb

@@ -5,7 +5,7 @@ class StatsigEvent
   attr_accessor :statsig_metadata
   def initialize(event_name)
     @event_name = event_name
-    @time = Time.now.to_i * 1000
+    @time = Time.now.to_f * 1000
   end
 
   def serialize

data/lib/statsig_logger.rb

@@ -8,6 +8,10 @@ class StatsigLogger
     @network = network
     @statsig_metadata = statsig_metadata
     @events = []
+    @background_flush = Thread.new do
+      sleep 60
+      flush
+    end
   end
 
   def log_event(event)
@@ -40,13 +44,18 @@ class StatsigLogger
     log_event(event)
   end
 
-  def flush
+  def flush(closing = false)
+    if closing
+      @background_flush.exit
+    end
     if @events.length == 0
       return
     end
     flush_events = @events.map { |e| e.serialize() }
     @events = []
 
-    @network.post_logs(flush_events, @statsig_metadata)
+    Thread.new do
+      @network.post_logs(flush_events, @statsig_metadata)
+    end
   end
 end

data/lib/statsig_options.rb

@@ -0,0 +1,9 @@
+class StatsigOptions
+  attr_reader :environment
+  attr_reader :api_url_base
+
+  def initialize(environment = nil, api_url_base = 'https://api.statsig.com/v1')
+    @environment = environment.is_a?(Hash) ? environment : nil
+    @api_url_base = api_url_base
+  end
+end

data/lib/statsig_user.rb

@@ -5,7 +5,8 @@ class StatsigUser
   attr_accessor :user_agent
   attr_accessor :country
   attr_accessor :locale
-  attr_accessor :client_version
+  attr_accessor :app_version
+  attr_accessor :statsig_environment
 
   def custom
     @custom
@@ -15,16 +16,19 @@ class StatsigUser
     @custom = value.is_a?(Hash) ? value : Hash.new
   end
 
-  def initialize(user_hash = nil)
+  def initialize(user_hash)
+    @statsig_environment = Hash.new
     if user_hash.is_a?(Hash)
-      @user_id = user_hash['user_id']
+      @user_id = user_hash['userID'] || user_hash['user_id']
+      @user_id = @user_id.to_s unless @user_id.nil?
       @email = user_hash['email']
       @ip = user_hash['ip']
-      @user_agent = user_hash['user_agent']
+      @user_agent = user_hash['userAgent'] || user_hash['user_agent']
       @country = user_hash['country']
       @locale = user_hash['locale']
-      @client_version = user_hash['client_version']
+      @app_version = user_hash['appVersion'] || user_hash['app_version']
       @custom = user_hash['custom']
+      @statsig_environment = user_hash['statsigEnvironment']
     end
   end
 
@@ -36,8 +40,9 @@ class StatsigUser
       'userAgent' => @user_agent,
       'country' => @country,
       'locale' => @locale,
-      'clientVersion' => @client_version,
+      'appVersion' => @app_version,
       'custom' => @custom,
+      'statsigEnvironment' => @statsig_environment,
     }
   end
 
@@ -53,9 +58,9 @@ class StatsigUser
       'user_agent' => @user_agent,
       'country' => @country,
       'locale' => @locale,
-      'clientVersion' => @client_version,
-      'clientversion' => @client_version,
-      'client_version' => @client_version,
+      'appVersion' => @app_version,
+      'appversion' => @app_version,
+      'app_version' => @app_version,
       'custom' => @custom,
     }
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statsig
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 1.4.0
 platform: ruby
 authors:
 - Statsig, Inc
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-06-04 00:00:00.000000000 Z
+date: 2021-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -25,25 +25,61 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.1'
 - !ruby/object:Gem::Dependency
-  name: browser
+  name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.3'
-    - - ">="
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.3.1
-  type: :runtime
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.14'
+- !ruby/object:Gem::Dependency
+  name: spy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.3'
-    - - ">="
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: user_agent_parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.3.1
+        version: '2.7'
 - !ruby/object:Gem::Dependency
   name: http
   requirement: !ruby/object:Gem::Requirement
@@ -51,9 +87,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.4'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.4.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -61,9 +94,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.4'
-    - - ">="
+- !ruby/object:Gem::Dependency
+  name: ip3country
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.4.1
+        version: '0.1'
 description: Statsig server SDK for feature gates and experimentation in Ruby
 email: support@statsig.com
 executables: []
@@ -80,6 +124,7 @@ files:
 - lib/statsig_driver.rb
 - lib/statsig_event.rb
 - lib/statsig_logger.rb
+- lib/statsig_options.rb
 - lib/statsig_user.rb
 homepage: https://rubygems.org/gems/statsig
 licenses: