kameleoon-client-ruby 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f3e0c8012bf2bcd5f9369eb5783106ed1a9075d0c5c8e0ae96f0f794bafdc3d9
-  data.tar.gz: 7b6b7695d09d04469a3981ab5c39157956c39697bedd38b5f53408c95a232496
+  metadata.gz: ba4f943be2e686ba2cca810ef8f456622e25733eda03808c7b3d81e2d72b1ee3
+  data.tar.gz: cef2edf8ef8e449f3150f73c5df9d76477342a52e49fbf90885b458fd6aa1b57
 SHA512:
-  metadata.gz: de92a19e0202c6eebfb1477749298ee1948220250eb28b4b786c06558efa1acb86bf6e8afd2c4008bf78197536864fb300ca28d4b8d540cb3d1d2a5eefb146c3
-  data.tar.gz: 9867186ac652c09e7d46b669afbe20df5718027c4e4139629f3282562675b4b40ccc289a7289b812089fdd1dadfca9ac30740b7b1ac5f699e10dc2179f761267
+  metadata.gz: 5b4e8f09c36222e08e9b426e90db6fb05476aa0e9bcd53036de31a8d7819db7b95ea5960adc6cc059494eb5355d9d912dd73a507923904723cf9ca63887adb4a
+  data.tar.gz: 7f7f9d409053f873d9f7daa9b281b7c926d3b314fe5a2e7bd0814d3a7b5fdf4f8c5f61c6eed9f65a5fd4c3d11665a0efc5464164636e9affd0bac96f95d3798f

data/lib/kameleoon/client.rb

@@ -6,8 +6,11 @@ require 'kameleoon/exceptions'
 require 'kameleoon/cookie'
 require 'kameleoon/configuration/feature_flag'
 require 'kameleoon/configuration/variation'
-require 'kameleoon/configuration/feature_flag_v2'
+require 'kameleoon/configuration/settings'
+require 'kameleoon/real_time/real_time_configuration_service'
 require 'kameleoon/storage/variation_storage'
+require 'kameleoon/hybrid/manager'
+require 'kameleoon/storage/cache_factory'
 require 'rufus/scheduler'
 require 'yaml'
 require 'json'
@@ -36,19 +39,29 @@ module Kameleoon
       @default_timeout = config['default_timeout'] || default_timeout # in ms
       refresh_interval = config['actions_configuration_refresh_interval']
       @interval = refresh_interval.nil? ? interval : "#{refresh_interval}m"
-      @tracking_url = config['tracking_url'] || "https://api-ssx.kameleoon.com"
-      @api_data_url = "https://api-data.kameleoon.com"
+      @tracking_url = config['tracking_url'] || API_SSX_URL
+      @api_data_url = 'https://api-data.kameleoon.com'
+      @events_url = 'https://events.kameleoon.com:8110/'
+      @real_time_configuration_service = nil
+      @update_configuration_handler = nil
+      @fetch_configuration_update_job = nil
       @client_id = client_id || config['client_id']
       @client_secret = client_secret || config['client_secret']
       @data_maximum_size = config['visitor_data_maximum_size'] || 500 # mb
       @environment = config['environment'] || DEFAULT_ENVIRONMENT
+      @settings = Kameleoon::Configuration::Settings.new
       @verbose_mode = config['verbose_mode'] || false
       @experiments = []
       @feature_flags = []
-      @feature_flags_v2 = []
       @data = {}
       @user_agents = {}
       @variation_storage = Kameleoon::Storage::VariationStorage.new
+      @hybrid_manager = Kameleoon::Hybrid::ManagerImpl.new(
+        CACHE_EXPIRATION_TIMEOUT,
+        CACHE_EXPIRATION_TIMEOUT * 3,
+        Kameleoon::Storage::CacheFactoryImpl.new,
+        method(:log)
+      )
     end
 
     ##
@@ -112,16 +125,17 @@ module Kameleoon
       check_visitor_code(visitor_code)
       experiment = @experiments.find { |exp| exp.id.to_s == experiment_id.to_s }
       if experiment.nil?
-        raise Exception::ExperimentConfigurationNotFound.new(experiment_id)
+        raise Exception::ExperimentConfigurationNotFound.new(experiment_id),
+              "Experiment #{experiment_id} is not found"
       end
       check_site_code_enable(experiment)
       if check_targeting(visitor_code, experiment_id, experiment)
-        saved_variation = get_valid_saved_variation(visitor_code, experiment)
-        variation_key = saved_variation || variation_for_experiment(visitor_code, experiment)
-        if !variation_key.nil?
-          track_experiment(visitor_code, experiment_id, variation_key)
-          @variation_storage.update_variation(visitor_code, experiment_id, variation_key) if saved_variation.nil?
-          variation_key
+        # saved_variation = get_valid_saved_variation(visitor_code, experiment)
+        variation_id = calculate_variation_for_experiment(visitor_code, experiment)
+        if !variation_id.nil?
+          track_experiment(visitor_code, experiment_id, variation_id)
+          save_variation(visitor_code, experiment_id, variation_id)
+          variation_id
         else
           track_experiment(visitor_code, experiment_id, REFERENCE, true)
           raise Exception::NotAllocated.new(visitor_code),
@@ -148,9 +162,7 @@ module Kameleoon
     #
     def add_data(visitor_code, *args)
       check_visitor_code(visitor_code)
-      while ObjectSpace.memsize_of(@data) > @data_maximum_size * (2**20) do
-        @data.shift
-      end
+      @data.shift while ObjectSpace.memsize_of(@data) > @data_maximum_size * (2**20)
       args.each do |data_element|
         if data_element.is_a?(UserAgent)
           add_user_agent_data(visitor_code, data_element)
@@ -252,28 +264,11 @@ module Kameleoon
     # @raise [Kameleoon::Exception::NotTargeted] The visitor is not targeted by the experiment, as the
     # associated targeting segment conditions were not fulfilled. He should see the reference variation
     # @raise [Kameleoon::Exception::VisitorCodeNotValid] If the visitor code is empty or longer than 255 chars
-
+    #
+    # DEPRECATED. Please use `is_feature_active` instead.
     def activate_feature(visitor_code, feature_key)
-      check_visitor_code(visitor_code)
-      feature_flag = find_feature_flag(feature_key)
-      check_site_code_enable(feature_flag)
-      unless check_targeting(visitor_code, feature_flag.id.to_i, feature_flag)
-        raise Exception::NotTargeted.new(visitor_code),
-              "Visitor '#{visitor_code}' is not targeted for FF with key '#{feature_key}'"
-      end
-
-      if feature_flag.is_scheduled_active(Time.now.to_i)
-        threshold = obtain_hash_double(visitor_code, {}, feature_flag.id)
-        if threshold >= 1 - feature_flag.exposition_rate
-          track_experiment(visitor_code, feature_flag.id, feature_flag.variations.first['id'])
-          true
-        else
-          track_experiment(visitor_code, feature_flag.id, REFERENCE, none_variation: true)
-          false
-        end
-      else
-        false
-      end
+      warn '[DEPRECATION] `activate_feature` is deprecated.  Please use `feature_active?` instead.'
+      feature_active?(visitor_code, feature_key)
     end
 
     ##
@@ -356,7 +351,7 @@ module Kameleoon
     # @raise [Kameleoon::Exception::VariationConfigurationNotFound]
     #
     def get_feature_all_variables(feature_key, variation_key)
-      feature_flag = find_feature_flag_v2(feature_key)
+      feature_flag = find_feature_flag(feature_key)
       variation = feature_flag.get_variation_key(variation_key)
       if variation.nil?
         raise Exception::VariationConfigurationNotFound.new(variation_key),
@@ -381,54 +376,47 @@ module Kameleoon
     # DEPRECATED. Please use `get_feature_variable` instead.
     def obtain_feature_variable(feature_key, variable_key)
       warn '[DEPRECATION] `obtain_feature_variable` is deprecated.  Please use `get_feature_variable` instead.'
-      feature_flag = find_feature_flag(feature_key)
-      custom_json = JSON.parse(feature_flag.variations.first['customJson'])[variable_key.to_s]
-      if custom_json.nil?
-        raise Exception::FeatureVariableNotFound.new('Feature variable not found')
-      end
-      case custom_json['type']
-      when 'Boolean'
-        custom_json['value']
-      when 'String'
-        custom_json['value']
-      when 'Number'
-        custom_json['value'].to_i
-      when 'JSON'
-        JSON.parse(custom_json['value'])
-      else
-        raise TypeError.new('Unknown type for feature variable')
-      end
+      all_variables = get_feature_all_variables(
+        feature_key,
+        Configuration::VariationType::VARIATION_OFF
+      )
+      all_variables[variable_key]
     end
 
     ##
-    # The retrieved_data_from_remote_source method allows you to retrieve data (according to a key passed as argument)
-    # stored on a remote Kameleoon server. Usually data will be stored on our remote servers via the use of our Data API.
-    # This method, along with the availability of our highly scalable servers for this purpose, provides a convenient way
-    # to quickly store massive amounts of data that can be later retrieved for each of your visitors / users.
+    # The get_remote_date method allows you to retrieve data (according to a key passed as argument)
+    # stored on a remote Kameleoon server. Usually data will be stored on our remote
+    # servers via the use of our Data API.
+    # This method, along with the availability of our highly scalable servers for this purpose, provides a convenient
+    # way to quickly store massive amounts of data that can be later retrieved for each of your visitors / users.
     #
     # @param [String] key Key you want to retrieve data. This field is mandatory.
-    # @param [Int] timeout Timeout for request. Equals default_timeout in a config file. This field is optional.
+    # @param [Int] timeout Timeout for request (in milliseconds). Equals default_timeout in a config file.
+    # This field is optional.
     #
     # @return [Hash] Hash object of the json object.
-    #
-    #
-    def retrieve_data_from_remote_source(key, timeout = @default_timeout)
+    def get_remote_date(key, timeout = @default_timeout)
       connexion_options = { connect_timeout: (timeout.to_f / 1000.0) }
       path = get_api_data_request_url(key)
       log "Retrieve API Data connexion: #{connexion_options.inspect}"
       response = get_sync(@api_data_url + path, connexion_options)
-      if successful_sync?(response)
-        JSON.parse(response.body) unless response.nil?
-      else
-        return nil
-      end
+      return nil unless successful_sync?(response)
+
+      JSON.parse(response.body) unless response.nil?
+    end
+
+    ##
+    # DEPRECATED. Please use `get_feature_variable` instead.
+    def retrieve_data_from_remote_source(key, timeout = @default_timeout)
+      warn '[DEPRECATION] `retrieve_data_from_remote_source` is deprecated.  Please use `get_remote_date` instead.'
+      get_remote_date(key, timeout)
     end
 
     ##
     # Returns a list of all experiment ids
     #
     # @return [Array] array of all experiment ids
-    def get_experiment_list
+    def get_experiment_list # rubocop:disable Naming/AccessorMethodName
       @experiments.map { |it| it.id.to_i }
     end
 
@@ -443,7 +431,7 @@ module Kameleoon
       list_ids = []
       @experiments.each do |experiment|
         next unless check_targeting(visitor_code, experiment.id.to_i, experiment)
-        next if only_allocated && variation_for_experiment(visitor_code, experiment).nil?
+        next if only_allocated && calculate_variation_for_experiment(visitor_code, experiment).nil?
 
         list_ids.push(experiment.id.to_i)
       end
@@ -454,8 +442,8 @@ module Kameleoon
     # Returns a list of all feature flag keys
     #
     # @return [Array] array of all feature flag keys
-    def get_feature_list
-      @feature_flags_v2.map(&:feature_key)
+    def get_feature_list # rubocop:disable Naming/AccessorMethodName
+      @feature_flags.map(&:feature_key)
     end
 
     ##
@@ -467,40 +455,114 @@ module Kameleoon
     def get_active_feature_list_for_visitor(visitor_code)
       check_visitor_code(visitor_code)
       list_keys = []
-      @feature_flags_v2.each do |feature_flag|
-        variation_key, = _calculate_variation_key_for_feature(visitor_code, feature_flag)
-        list_keys.push(feature_flag.feature_key) if variation_key != Kameleoon::Configuration::VariationType::VARIATION_OFF
+      @feature_flags.each do |feature_flag|
+        variation, rule, = _calculate_variation_key_for_feature(visitor_code, feature_flag)
+        variation_key = _get_variation_key(variation, rule, feature_flag)
+        if variation_key != Kameleoon::Configuration::VariationType::VARIATION_OFF
+          list_keys.push(feature_flag.feature_key)
+        end
       end
       list_keys
     end
 
+    ##
+    # The `on_update_configuration()` method allows you to handle the event when configuration
+    # has updated data. It takes one input parameter: callable **handler**. The handler
+    # that will be called when the configuration is updated using a real-time configuration event.
+    #
+    # @param handler [Callable | NilClass] The handler that will be called when the configuration
+    # is updated using a real-time configuration event.
+    def on_update_configuration(handler)
+      @update_configuration_handler = handler
+    end
+
+    ##
+    # The `get_engine_tracking_code` returns the JavasScript code to be inserted in your page
+    # to send automatically the exposure events to the analytics solution you are using.
+    #
+    # @param [String] visitor_code The user's unique identifier. This field is mandatory.
+    #
+    # @return [String] JavasScript code to be inserted in your page to send automatically
+    # the exposure events to the analytics solution you are using.
+    def get_engine_tracking_code(visitor_code)
+      @hybrid_manager.get_engine_tracking_code(visitor_code)
+    end
+
     private
 
     API_SSX_URL = 'https://api-ssx.kameleoon.com'
     REFERENCE = 0
     DEFAULT_ENVIRONMENT = 'production'
-    attr :site_code, :client_id, :client_secret, :access_token, :experiments, :feature_flags, :feature_flags_v2, :scheduler, :data,
+    CACHE_EXPIRATION_TIMEOUT = 5
+    attr :site_code, :client_id, :client_secret, :access_token, :experiments, :feature_flags, :scheduler, :data,
          :tracking_url, :default_timeout, :interval, :memory_limit, :verbose_mode
 
     def fetch_configuration
-      @scheduler = Rufus::Scheduler.singleton
-      @scheduler.every @interval do
-        log('Scheduled job to fetch configuration is starting.')
-        fetch_configuration_job
-      end
-      @scheduler.schedule '0s' do
-        log('Start-up, fetching is starting')
+      Rufus::Scheduler.singleton.in '0s' do
+        log('Initial configuration fetch is started.')
         fetch_configuration_job
       end
     end
 
-    def fetch_configuration_job
+    def fetch_configuration_job(time_stamp = nil)
       EM.synchrony do
-        obtain_configuration(@site_code, @environment)
+        begin
+          ok = obtain_configuration(@site_code, @environment, time_stamp)
+          if !ok && @settings.real_time_update
+            @settings.real_time_update = false
+            log('Switching to polling mode due to failed fetch')
+          end
+        rescue StandardError => e
+          log("Error occurred during configuration fetching: #{e}")
+        end
+        manage_configuration_update(@settings.real_time_update)
         EM.stop
       end
     end
 
+    def start_configuration_update_job_if_needed
+      return unless @fetch_configuration_update_job.nil?
+
+      @fetch_configuration_update_job = Rufus::Scheduler.singleton.schedule_every @interval do
+        log('Scheduled job to fetch configuration is started.')
+        fetch_configuration_job
+      end
+    end
+
+    def stop_configuration_update_job_if_needed
+      return if @fetch_configuration_update_job.nil?
+
+      @fetch_configuration_update_job.unschedule
+      @fetch_configuration_update_job = nil
+      log('Scheduled job to fetch configuration is stopped.')
+    end
+
+    def start_real_time_configuration_service_if_needed
+      return unless @real_time_configuration_service.nil?
+
+      events_url = "#{@events_url}sse?siteCode=#{@site_code}"
+      fetch_func = proc { |real_time_event| fetch_configuration_job(real_time_event.time_stamp) }
+      @real_time_configuration_service =
+        Kameleoon::RealTime::RealTimeConfigurationService.new(events_url, fetch_func, method(:log))
+    end
+
+    def stop_real_time_configuration_service_if_needed
+      return if @real_time_configuration_service.nil?
+
+      @real_time_configuration_service.close
+      @real_time_configuration_service = nil
+    end
+
+    def manage_configuration_update(is_real_time_update)
+      if is_real_time_update
+        stop_configuration_update_job_if_needed
+        start_real_time_configuration_service_if_needed
+      else
+        stop_real_time_configuration_service_if_needed
+        start_configuration_update_job_if_needed
+      end
+    end
+
     # def hash_headers
     #   if @access_token.nil?
     #     CredentialsNotFound.new
@@ -515,26 +577,37 @@ module Kameleoon
     #   { 'field' => field, 'operator' => operator, 'parameters' => parameters }
     # end
 
-    def obtain_configuration(site_code, environment = @environment)
-      log "Fetching configuration from Client-Config service"
+    def obtain_configuration(site_code, environment = @environment, time_stamp = nil)
+      log 'Fetching configuration from Client-Config service'
       request_path = "mobile?siteCode=#{site_code}"
       request_path += "&environment=#{environment}" unless environment.nil?
+      request_path += "&ts=#{time_stamp}" unless time_stamp.nil?
       request = request_configuration(request_path)
-      return unless request
+      return false unless request
 
       configuration = JSON.parse(request.response)
       @experiments = Kameleoon::Configuration::Experiment.create_from_array(configuration['experiments']) ||
                      @experiments
-      @feature_flags = Kameleoon::Configuration::FeatureFlag.create_from_array(configuration['featureFlags']) ||
-                       @feature_flags
-      feature_flags_v2_new = Kameleoon::Configuration::FeatureFlagV2.create_from_array(
+      @feature_flags = Kameleoon::Configuration::FeatureFlag.create_from_array(
         configuration['featureFlagConfigurations']
       )
-      @feature_flags_v2 = feature_flags_v2_new || @feature_flags_v2
+      @settings.update(configuration['configuration'])
+      call_update_handler_if_needed(!time_stamp.nil?)
       log "Feature flags are fetched: #{request.inspect}"
+      true
+    end
+
+    ##
+    # Call the handler when configuraiton was updated with new time stamp.
+    #
+    # @param need_call [Bool] Indicates if we need to call handler or not.
+    def call_update_handler_if_needed(need_call)
+      return if !need_call || @update_configuration_handler.nil?
+
+      @update_configuration_handler.call
     end
 
-    def variation_for_experiment(visitor_code, experiment)
+    def calculate_variation_for_experiment(visitor_code, experiment)
       threshold = obtain_hash_double(visitor_code, experiment.respool_time, experiment.id)
       experiment.deviations.each do |key, value|
         threshold -= value
@@ -563,13 +636,11 @@ module Kameleoon
     def get_experiment_register_url(visitor_code, experiment_id, variation_id = nil, none_variation = false)
       url = "/experimentTracking?#{URI.encode_www_form(get_common_ssx_parameters(visitor_code))}"
       url += "&experimentId=#{experiment_id}"
-      if variation_id.nil?
-        return url
-      end
+      return url if variation_id.nil?
+
       url += "&variationId=#{variation_id}"
-      if none_variation
-        url += '&noneVariation=true'
-      end
+      url += '&noneVariation=true' if none_variation
+
       url
     end
 
@@ -586,26 +657,8 @@ module Kameleoon
     end
 
     def find_feature_flag(feature_key)
-      case feature_key
-      when String
-        feature_flag = @feature_flags.select { |ff| ff.identification_key == feature_key }.first
-      when Integer
-        feature_flag = @feature_flags.select { |ff| ff.id.to_i == feature_key }.first
-        print "\nPassing `feature_key` with type of `int` to `activate_feature` or `obtain_feature_variable` "\
-        "is deprecated, it will be removed in next releases. This is necessary to support multi-environment feature\n"
-      else
-        raise TypeError.new('Feature key should be a String or an Integer.'),
-              'Feature key should be a String or an Integer.'
-      end
-      error_message = "Feature #{feature_key} not found"
-      raise Exception::FeatureConfigurationNotFound.new(feature_key), error_message if feature_flag.nil?
-
-      feature_flag
-    end
-
-    def find_feature_flag_v2(feature_key)
       if feature_key.is_a?(String)
-        feature_flag = @feature_flags_v2.select { |ff| ff.feature_key == feature_key }.first
+        feature_flag = @feature_flags.select { |ff| ff.feature_key == feature_key }.first
       else
         raise TypeError.new('Feature key should be a String or an Integer.'),
               'Feature key should be a String or an Integer.'
@@ -686,7 +739,7 @@ module Kameleoon
     end
 
     def log(text)
-      print "Kameleoon Log: #{text}\n" if @verbose_mode
+      print "Kameleoon SDK Log: #{text}\n" if @verbose_mode
     end
 
     def add_user_agent_data(visitor_code, user_agent)
@@ -698,15 +751,16 @@ module Kameleoon
       headers['User-Agent'] = user_agent.value unless user_agent.nil?
     end
 
-    def get_valid_saved_variation(visitor_code, experiment)
-      variation_id = @variation_storage.get_variation_id(visitor_code, experiment.id.to_i)
-      unless variation_id.nil?
-        return @variation_storage.variation_valid?(visitor_code,
-                                                   experiment.id.to_i,
-                                                   experiment.respool_time[variation_id])
-      end
-      nil
-    end
+    # Uncomment when using storage
+    # def get_valid_saved_variation(visitor_code, experiment)
+    #   variation_id = @variation_storage.get_variation_id(visitor_code, experiment.id.to_i)
+    #   unless variation_id.nil?
+    #     return @variation_storage.variation_valid?(visitor_code,
+    #                                                experiment.id.to_i,
+    #                                                experiment.respool_time[variation_id])
+    #   end
+    #   nil
+    # end
 
     def check_targeting(visitor_code, campaign_id, exp_ff_rule)
       segment = exp_ff_rule.targeting_segment
@@ -732,10 +786,13 @@ module Kameleoon
     # helper method for getting variation key for feature flag
     def _get_feature_variation_key(visitor_code, feature_key)
       check_visitor_code(visitor_code)
-      feature_flag = find_feature_flag_v2(feature_key)
-      variation_key, rule = _calculate_variation_key_for_feature(visitor_code, feature_flag)
-      if !rule.nil? && rule.type == Kameleoon::Configuration::RuleType::EXPERIMENTATION
-        _send_tracking_request(visitor_code, variation_key, rule)
+      feature_flag = find_feature_flag(feature_key)
+      variation, rule = _calculate_variation_key_for_feature(visitor_code, feature_flag)
+      variation_key = _get_variation_key(variation, rule, feature_flag)
+      unless rule.nil?
+        save_variation(visitor_code, rule.experiment_id, variation.variation_id) unless variation.nil?
+        variation_id = variation.variation_id unless variation.nil?
+        _send_tracking_request(visitor_code, rule.experiment_id, variation_id)
       end
       [feature_flag, variation_key]
     end
@@ -744,35 +801,49 @@ module Kameleoon
     # helper method for calculate variation key for feature flag
     def _calculate_variation_key_for_feature(visitor_code, feature_flag)
       # no rules -> return default_variation_key
-      unless feature_flag.rules.empty?
+      feature_flag.rules.each do |rule|
+        # check if visitor is targeted for rule, else next rule
+        next unless check_targeting(visitor_code, feature_flag.id, rule)
+
         # uses for rule exposition
-        hash_rule = obtain_hash_double_v2(visitor_code, feature_flag.id)
-        # uses for variation's expositions
-        hash_variation = obtain_hash_double_v2(visitor_code, feature_flag.id, 'variation')
-        feature_flag.rules.each do |rule|
-          # check if visitor is targeted for rule, else next rule
-          next unless check_targeting(visitor_code, feature_flag.id, rule)
-
-          # check main expostion for rule with hashRule
-          if hash_rule < rule.exposition
-            # get variation key with new hashVariation
-            variation_key = rule.get_variation_key(hash_variation)
-            # variation_key can be nil for experiment rules only, for targeted rule will be always exist
-            return [variation_key, rule] unless variation_key.nil?
-          # if visitor is targeted for targeted rule then break cycle -> return default
-          elsif rule.type == Kameleoon::Configuration::RuleType::TARGETED_DELIVERY
-            break
-          end
+        hash_rule = obtain_hash_double_rule(visitor_code, rule.id, rule.respool_time)
+        # check main expostion for rule with hashRule
+        if hash_rule <= rule.exposition
+          # uses for variation's expositions
+          hash_variation = obtain_hash_double_rule(visitor_code, rule.experiment_id, rule.respool_time)
+          # get variation key with new hashVariation
+          variation = rule.get_variation(hash_variation)
+          # variation_key can be nil for experiment rules only, for targeted rule will be always exist
+          return [variation, rule] unless variation.nil?
+        # if visitor is targeted for targeted rule then break cycle -> return default
+        elsif rule.targeted_delivery_type?
+          break
         end
       end
-      [feature_flag.default_variation_key, nil]
+      [nil, nil]
+    end
+
+    def save_variation(visitor_code, experiment_id, variation_id)
+      return if experiment_id.nil? || variation_id.nil?
+
+      @variation_storage.update_variation(visitor_code, experiment_id, variation_id)
+      @hybrid_manager.add_variation(visitor_code, experiment_id, variation_id)
+    end
+
+    def _get_variation_key(var_by_exp, rule, feature_flag)
+      return var_by_exp.variation_key unless var_by_exp.nil?
+
+      return Kameleoon::Configuration::VariationType::VARIATION_OFF if !rule.nil? && rule.experiment_type?
+
+      feature_flag.default_variation_key
     end
 
     ##
-    # helper method for sending tracking requests for new FF v2
-    def _send_tracking_request(visitor_code, variation_key, rule)
-      if !rule.experiment_id.nil?
-        track_experiment(visitor_code, rule.experiment_id, rule.get_variation_id_by_key(variation_key))
+    # helper method for sending tracking requests for new FF
+    def _send_tracking_request(visitor_code, experiment_id, variation_id)
+      if !experiment_id.nil?
+        variation_reference_id = variation_id || 0
+        track_experiment(visitor_code, experiment_id, variation_reference_id)
       else
         log 'An attempt to send a request with null experimentId was blocked'
       end

data/lib/kameleoon/configuration/feature_flag.rb

@@ -1,40 +1,29 @@
 # frozen_string_literal: true
 
-require_relative 'experiment'
+require_relative 'rule'
+require_relative 'variation'
 
 module Kameleoon
   # Module which contains all internal data of SDK
   module Configuration
-    # Class for manage all experiments and old feature flags
-    class FeatureFlag < Experiment
-      STATUS_ACTIVE = 'ACTIVE'
-      FEATURE_STATUS_DEACTIVATED = 'DEACTIVATED'
-      attr_accessor :identification_key, :feature_status, :schedules, :exposition_rate
+    # Class for manage all feature flags with rules
+    class FeatureFlag
+      attr_accessor :id, :feature_key, :variations, :default_variation_key, :rules
 
       def self.create_from_array(array)
         array&.map { |it| FeatureFlag.new(it) }
       end
 
-      def initialize(feature_flag_hash)
-        super(feature_flag_hash)
-        @feature_status = feature_flag_hash['featureStatus']
-        @identification_key = feature_flag_hash['identificationKey'] if feature_flag_hash['identificationKey']
-        @exposition_rate = feature_flag_hash['expositionRate']
-        @schedules = feature_flag_hash['schedules'] unless feature_flag_hash['schedules'].nil?
+      def initialize(hash)
+        @id = hash['id']
+        @feature_key = hash['featureKey']
+        @default_variation_key = hash['defaultVariationKey']
+        @variations = Variation.create_from_array(hash['variations'])
+        @rules = Rule.create_from_array(hash['rules'])
       end
 
-      def is_scheduled_active(date)
-        current_status = @status == STATUS_ACTIVE
-        if @feature_status == FEATURE_STATUS_DEACTIVATED || @schedules.empty?
-          return current_status
-        end
-        @schedules.each do |schedule|
-          if (schedule['dateStart'].nil? || Time.parse(schedule['dateStart']).to_i < date) &&
-             (schedule['dateEnd'].nil? || Time.parse(schedule['dateEnd']).to_i > date)
-            return true
-          end
-        end
-        false
+      def get_variation_key(key)
+        variations.select { |v| v.key == key }.first
       end
     end
   end