splitclient-rb 8.4.0 → 8.11.0

data/lib/splitclient-rb/engine/api/splits.rb

@@ -5,58 +5,134 @@ module SplitIoClient
     # Retrieves split definitions from the Split Backend
     class Splits < Client
 
+      PROXY_CHECK_INTERVAL_SECONDS = 24 * 60 * 60
+      SPEC_1_1 = "1.1"
+
       def initialize(api_key, config, telemetry_runtime_producer)
         super(config)
         @api_key = api_key
         @telemetry_runtime_producer = telemetry_runtime_producer
         @flag_sets_filter = @config.flag_sets_filter
+        @spec_version = SplitIoClient::Spec::FeatureFlags::SPEC_VERSION
+        @last_proxy_check_timestamp = 0
+        @clear_storage = false
+        @old_spec_since = nil
       end
 
-      def since(since, fetch_options = { cache_control_headers: false, till: nil, sets: nil})
+      def since(since, since_rbs, fetch_options = { cache_control_headers: false, till: nil, sets: nil})
         start = Time.now
+        
+        if check_last_proxy_check_timestamp
+            @spec_version = SplitIoClient::Spec::FeatureFlags::SPEC_VERSION
+            @config.logger.debug("Switching to new Feature flag spec #{@spec_version} and fetching.") if @config.debug_enabled
+            @old_spec_since = since
+            since = -1
+            since_rbs = -1
+            fetch_options = { cache_control_headers: false, till: nil, sets: nil}
+        end
+
+        if @spec_version == Splits::SPEC_1_1
+          since = @old_spec_since unless @old_spec_since.nil?
+          params = { s: @spec_version, since: since }
+          @old_spec_since = nil
+        else
+          params = { s: @spec_version, since: since, rbSince: since_rbs }
+        end
 
-        params = { s: SplitIoClient::Spec::FeatureFlags::SPEC_VERSION, since: since }
         params[:sets] = @flag_sets_filter.join(",") unless @flag_sets_filter.empty?
         params[:till] = fetch_options[:till] unless fetch_options[:till].nil?
-        @config.logger.debug("Fetching from splitChanges with #{params}: ")
+        @config.logger.debug("Fetching from splitChanges with #{params}: ") if @config.debug_enabled
         response = get_api("#{@config.base_uri}/splitChanges", @api_key, params, fetch_options[:cache_control_headers])
         if response.status == 414
           @config.logger.error("Error fetching feature flags; the amount of flag sets provided are too big, causing uri length error.")
           raise ApiException.new response.body, 414
         end
+
+        if response.status == 400 and sdk_url_overriden? and @spec_version == SplitIoClient::Spec::FeatureFlags::SPEC_VERSION
+            @config.logger.warn("Detected proxy response error, changing spec version from #{@spec_version} to #{Splits::SPEC_1_1} and re-fetching.")
+            @spec_version = Splits::SPEC_1_1
+            @last_proxy_check_timestamp = Time.now
+            return since(since, 0, fetch_options = {cache_control_headers: fetch_options[:cache_control_headers], till: fetch_options[:till],
+                sets: fetch_options[:sets]})          
+        end
         if response.success?
-          result = splits_with_segment_names(response.body)
-          unless result[:splits].empty?
-            @config.split_logger.log_if_debug("#{result[:splits].length} feature flags retrieved. since=#{since}")
-          end
-          @config.split_logger.log_if_transport("Feature flag changes response: #{result.to_s}")
+          result = JSON.parse(response.body, symbolize_names: true)
 
-          bucket = BinarySearchLatencyTracker.get_bucket((Time.now - start) * 1000.0)
-          @telemetry_runtime_producer.record_sync_latency(Telemetry::Domain::Constants::SPLIT_SYNC, bucket)
-          @telemetry_runtime_producer.record_successful_sync(Telemetry::Domain::Constants::SPLIT_SYNC, (Time.now.to_f * 1000.0).to_i)
+          return process_result(result, since, since_rbs, start)
+        end
+        @telemetry_runtime_producer.record_sync_error(Telemetry::Domain::Constants::SPLIT_SYNC, response.status)
 
-          result
-        else
-          @telemetry_runtime_producer.record_sync_error(Telemetry::Domain::Constants::SPLIT_SYNC, response.status)
+        @config.logger.error("Unexpected status code while fetching feature flags: #{response.status}. " \
+        'Check your API key and base URI')
 
-          @config.logger.error("Unexpected status code while fetching feature flags: #{response.status}. " \
-          'Check your API key and base URI')
+        raise 'Split SDK failed to connect to backend to fetch feature flags definitions'
+      end
 
-          raise 'Split SDK failed to connect to backend to fetch feature flags definitions'
-        end
+      def clear_storage
+        @clear_storage
       end
 
       private
 
-      def splits_with_segment_names(splits_json)
-        parsed_splits = JSON.parse(splits_json, symbolize_names: true)
+      def process_result(result, since, since_rbs, start)
+        if @spec_version == Splits::SPEC_1_1
+          result = convert_to_new_spec(result)
+        end
+        
+        result[:rbs][:d] = check_rbs_data(result[:rbs][:d])
+        result = objects_with_segment_names(result)
+        
+        if @spec_version == SplitIoClient::Spec::FeatureFlags::SPEC_VERSION
+          @clear_storage = @last_proxy_check_timestamp != 0
+          @last_proxy_check_timestamp = 0
+        end
+
+        unless result[:ff][:d].empty?
+          @config.split_logger.log_if_debug("#{result[:ff][:d].length} feature flags retrieved. since=#{since}")
+        end
+        @config.split_logger.log_if_transport("Feature flag changes response: #{result[:ff].to_s}")
+
+        unless result[:rbs][:d].empty?
+          @config.split_logger.log_if_debug("#{result[:rbs][:d].length} rule based segments retrieved. since=#{since_rbs}")
+        end
+        @config.split_logger.log_if_transport("rule based segments changes response: #{result[:rbs].to_s}")
+
+        bucket = BinarySearchLatencyTracker.get_bucket((Time.now - start) * 1000.0)
+        @telemetry_runtime_producer.record_sync_latency(Telemetry::Domain::Constants::SPLIT_SYNC, bucket)
+        @telemetry_runtime_producer.record_successful_sync(Telemetry::Domain::Constants::SPLIT_SYNC, (Time.now.to_f * 1000.0).to_i)
+
+        result
+      end
+
+      def check_rbs_data(rbs_data)
+        rbs_data.each do |rb_segment|
+          rb_segment[:excluded] = {:keys => [], :segments => []} if rb_segment[:excluded].nil?
+          rb_segment[:excluded][:keys] = [] if rb_segment[:excluded][:keys].nil?
+          rb_segment[:excluded][:segments] = [] if rb_segment[:excluded][:segments].nil?
+        end
+        rbs_data
+      end
 
-        parsed_splits[:segment_names] =
-          parsed_splits[:splits].each_with_object(Set.new) do |split, splits|
-            splits << Helpers::Util.segment_names_by_feature_flag(split)
+      def objects_with_segment_names(parsed_objects)
+        parsed_objects[:segment_names] = Set.new
+        parsed_objects[:segment_names] =
+          parsed_objects[:ff][:d].each_with_object(Set.new) do |split, splits|
+            splits << Helpers::Util.segment_names_by_object(split, "IN_SEGMENT")
           end.flatten
 
-        parsed_splits
+        parsed_objects[:rbs][:d].each do |rule_based_segment|
+          parsed_objects[:segment_names].merge Helpers::Util.segment_names_in_rb_segment(rule_based_segment, "IN_SEGMENT")
+        end
+        
+        parsed_objects
+      end
+
+      def check_last_proxy_check_timestamp
+        @spec_version == Splits::SPEC_1_1 and ((Time.now - @last_proxy_check_timestamp) >= Splits::PROXY_CHECK_INTERVAL_SECONDS)
+      end
+
+      def convert_to_new_spec(body)
+        {:ff => {:d => body[:splits], :s => body[:since], :t => body[:till]}, :rbs => {:d => [], :s => -1, :t => -1}}
       end
     end
   end

data/lib/splitclient-rb/engine/auth_api_client.rb

@@ -21,10 +21,10 @@ module SplitIoClient
         return process_error(response) if response.status >= 400 && response.status < 500
 
         @telemetry_runtime_producer.record_sync_error(Telemetry::Domain::Constants::TOKEN_SYNC, response.status.to_i)
-        @config.logger.debug("Error connecting to: #{@config.auth_service_url}. Response status: #{response.status}")
+        @config.logger.debug("Error connecting to: #{@config.auth_service_url}. Response status: #{response.status}") if @config.debug_enabled
         { push_enabled: false, retry: true }
       rescue StandardError => e
-        @config.logger.debug("AuthApiClient error: #{e.inspect}.")
+        @config.logger.debug("AuthApiClient error: #{e.inspect}.") if @config.debug_enabled
         { push_enabled: false, retry: false }
       end
 
@@ -51,7 +51,7 @@ module SplitIoClient
       end
 
       def process_error(response)
-        @config.logger.debug("Error connecting to: #{@config.auth_service_url}. Response status: #{response.status}")
+        @config.logger.debug("Error connecting to: #{@config.auth_service_url}. Response status: #{response.status}") if @config.debug_enabled
         @telemetry_runtime_producer.record_auth_rejections if response.status == 401
 
         { push_enabled: false, retry: false }

data/lib/splitclient-rb/engine/common/impressions_manager.rb

@@ -18,20 +18,24 @@ module SplitIoClient
           @unique_keys_tracker = unique_keys_tracker
         end
 
-        def build_impression(matching_key, bucketing_key, split_name, treatment, params = {})
-          impression_data = impression_data(matching_key, bucketing_key, split_name, treatment, params[:time])
+        def build_impression(matching_key, bucketing_key, split_name, treatment_data, impressions_disabled, params = {},
+                             evaluation_options = nil)
+          properties = get_properties(evaluation_options)
+          impression_data = impression_data(matching_key, bucketing_key, split_name, treatment_data, params[:time], properties)
+          return impression(impression_data, params[:attributes]) if check_return_conditions(properties)
 
           begin
-            case @config.impressions_mode
-            when :debug #  In DEBUG mode we should calculate the pt only.
-              impression_data[:pt] = @impression_observer.test_and_set(impression_data)
-            when :none # In NONE mode we should track the total amount of evaluations and the unique keys.
+            if check_none_mode(impressions_disabled)
               @impression_counter.inc(split_name, impression_data[:m])
               @unique_keys_tracker.track(split_name, matching_key)
-            else # In OPTIMIZED mode we should track the total amount of evaluations and deduplicate the impressions.
+            end
+            if check_observe_impressions
+              # In DEBUG mode we should calculate the pt only.
               impression_data[:pt] = @impression_observer.test_and_set(impression_data)
-
-              @impression_counter.inc(split_name, impression_data[:m]) unless impression_data[:pt].nil?
+            end
+            if check_impression_counter(impression_data)
+              # In OPTIMIZED mode we should track the total amount of evaluations and deduplicate the impressions.
+              @impression_counter.inc(split_name, impression_data[:m])
             end
           rescue StandardError => e
             @config.log_found_exception(__method__.to_s, e)
@@ -40,29 +44,50 @@ module SplitIoClient
           impression(impression_data, params[:attributes])
         end
 
-        def track(impressions)
-          return if impressions.empty?
-
-          stats = { dropped: 0, queued: 0, dedupe: 0 }
-          begin
-            case @config.impressions_mode
-            when :none
-              return
-            when :debug
-              track_debug_mode(impressions, stats)
-            when :optimized
-              track_optimized_mode(impressions, stats)
+        def track(impressions_decorator)
+          return if impressions_decorator.empty?
+
+          impressions_decorator.each do |impression_decorator|
+            impression_router.add_bulk([impression_decorator[:impression]])
+            stats = { dropped: 0, queued: 0, dedupe: 0 }
+            begin
+              next if @config.impressions_mode == :none || impression_decorator[:disabled]
+
+              if @config.impressions_mode == :debug
+                track_debug_mode([impression_decorator[:impression]], stats)
+              else
+                track_optimized_mode([impression_decorator[:impression]], stats)
+              end
+            rescue StandardError => e
+              @config.log_found_exception(__method__.to_s, e)
+            ensure
+              record_stats(stats)
             end
-          rescue StandardError => e
-            @config.log_found_exception(__method__.to_s, e)
-          ensure
-            record_stats(stats)
-            impression_router.add_bulk(impressions)
           end
         end
 
         private
 
+        def check_return_conditions(properties)
+          return (@config.impressions_mode == :debug || @config.impressions_mode == :optimized) && !properties.nil?
+        end
+
+        def check_none_mode(impressions_disabled)
+          return @config.impressions_mode == :none || impressions_disabled
+        end
+
+        def check_observe_impressions
+          return @config.impressions_mode == :debug || @config.impressions_mode == :optimized
+        end
+
+        def check_impression_counter(impression_data)
+          return @config.impressions_mode == :optimized && !impression_data[:pt].nil?
+        end
+
+        def get_properties(evaluation_options)
+          return evaluation_options.nil? ? nil : evaluation_options.properties
+        end
+
         def impression_router
           @impression_router ||= SplitIoClient::ImpressionRouter.new(@config)
         rescue StandardError => e
@@ -81,7 +106,8 @@ module SplitIoClient
         end
 
         # added param time for test
-        def impression_data(matching_key, bucketing_key, split_name, treatment, time = nil)
+        def impression_data(matching_key, bucketing_key, split_name, treatment, time = nil,
+                            properties = nil)
           {
             k: matching_key,
             b: bucketing_key,
@@ -90,7 +116,8 @@ module SplitIoClient
             r: applied_rule(treatment[:label]),
             c: treatment[:change_number],
             m: time || (Time.now.to_f * 1000.0).to_i,
-            pt: nil
+            pt: nil,
+            properties: properties
           }
         end
 
@@ -126,11 +153,10 @@ module SplitIoClient
 
         def track_optimized_mode(impressions, stats)
           optimized_impressions = impressions.select { |imp| should_queue_impression?(imp[:i]) }
-
+          stats[:dedupe] = impressions.length - optimized_impressions.length
           return if optimized_impressions.empty?
 
           stats[:dropped] = @impressions_repository.add_bulk(optimized_impressions)
-          stats[:dedupe] = impressions.length - optimized_impressions.length
           stats[:queued] = optimized_impressions.length - stats[:dropped]
         end
       end

data/lib/splitclient-rb/engine/events/events_delivery.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module SplitIoClient
+  module Engine
+    module Events
+      class EventsDelivery
+        def initialize(config)
+          @config = config
+        end
+
+        def deliver(sdk_event, event_metadata, event_handler)
+          event_handler.call(event_metadata)
+        rescue StandardError => e
+          @config.logger.error("Exception when calling handler for Sdk Event #{sdk_event}")
+          @config.log_found_exception(__method__.to_s, e)
+        end
+      end
+    end
+  end
+end

data/lib/splitclient-rb/engine/events/events_manager.rb

@@ -0,0 +1,194 @@
+# frozen_string_literal: true
+
+module SplitIoClient
+  module Engine
+    module Events
+      class EventsManager
+        def initialize(events_manager_config, events_delivery, config)
+          @manager_config = events_manager_config
+          @events_delivery = events_delivery
+          @active_subscriptions = {}
+          @internal_events_status = {}
+          @mutex = Mutex.new
+          @config = config
+        end
+
+        def register(sdk_event, event_handler)
+          return if @active_subscriptions.key?(sdk_event) && !get_event_handler(sdk_event).nil?
+
+          @mutex.synchronize do
+            # SDK ready already fired
+            if sdk_event == SplitIoClient::Engine::Models::SdkEvent::SDK_READY && event_already_triggered(sdk_event)
+              @active_subscriptions[sdk_event] = SplitIoClient::Engine::Models::EventActiveSubscriptions.new(true, event_handler)
+              @config.logger.debug('EventsManager: Firing SDK_READY event for new subscription') if @config.debug_enabled
+              fire_sdk_event(sdk_event, nil)
+              return
+            end
+
+            @config.logger.debug("EventsManager: Register event: #{sdk_event}") if @config.debug_enabled
+            @active_subscriptions[sdk_event] = SplitIoClient::Engine::Models::EventActiveSubscriptions.new(false, event_handler)
+          end
+        end
+
+        def unregister(sdk_event)
+          return unless @active_subscriptions.key?(sdk_event)
+
+          @mutex.synchronize do
+            @active_subscriptions.delete(sdk_event)
+          end
+        end
+
+        def notify_internal_event(sdk_internal_event, event_metadata)
+          @mutex.synchronize do
+            update_internal_event_status(sdk_internal_event, true)
+            @manager_config.evaluation_order.each do |sorted_event|
+              if get_sdk_event_if_applicable(sdk_internal_event).include?(sorted_event) &&
+                 !get_event_handler(sorted_event).nil?
+                fire_sdk_event(sorted_event, event_metadata)
+              end
+
+              # if client is not subscribed to SDK_READY
+              if check_if_register_needed(sorted_event)
+                @config.logger.debug('EventsManager: Registering SDK_READY event as fired') if @config.debug_enabled
+                @active_subscriptions[Engine::Models::SdkEvent::SDK_READY] = Engine::Models::EventActiveSubscriptions.new(true, nil)
+              end
+            end
+          end
+        end
+
+        def destroy
+          @mutex.synchronize do
+            @active_subscriptions = {}
+            @internal_events_status = {}
+          end
+        end
+
+        private
+
+        def check_if_register_needed(sorted_event)
+          sorted_event == SplitIoClient::Engine::Models::SdkEvent::SDK_READY &&
+            get_event_handler(sorted_event).nil? &&
+            !@active_subscriptions.include?(sorted_event)
+        end
+
+        def fire_sdk_event(sdk_event, event_metadata)
+          @config.logger.debug("EventsManager: Firing Sdk event: #{sdk_event}") if @config.debug_enabled
+          @config.threads[:sdk_event_notify] = Thread.new do
+            @events_delivery.deliver(sdk_event, event_metadata, get_event_handler(sdk_event))
+          end
+          sdk_event_triggered(sdk_event)
+        end
+
+        def event_already_triggered(sdk_event)
+          return @active_subscriptions[sdk_event].triggered if @active_subscriptions.key?(sdk_event)
+
+          false
+        end
+
+        def get_internal_event_status(sdk_internal_event)
+          return @internal_events_status[sdk_internal_event] if @internal_events_status.key?(sdk_internal_event)
+
+          false
+        end
+
+        def update_internal_event_status(sdk_internal_event, status)
+          @internal_events_status[sdk_internal_event] = status
+        end
+
+        def sdk_event_triggered(sdk_event)
+          return unless @active_subscriptions.key?(sdk_event)
+
+          return if @active_subscriptions[sdk_event].triggered
+
+          @active_subscriptions[sdk_event].triggered = true
+        end
+
+        def get_event_handler(sdk_event)
+          return nil unless @active_subscriptions.key?(sdk_event)
+
+          @active_subscriptions[sdk_event].handler
+        end
+
+        def get_sdk_event_if_applicable(sdk_internal_event)
+          final_sdk_event = SplitIoClient::Engine::Models::ValidSdkEvent.new(nil, false)
+
+          events_to_fire = []
+          require_any_sdk_event = check_require_any(sdk_internal_event)
+          if require_any_sdk_event.valid
+            if (!event_already_triggered(require_any_sdk_event.sdk_event) &&
+               execution_limit(require_any_sdk_event.sdk_event) == 1) ||
+               execution_limit(require_any_sdk_event.sdk_event) == -1
+              final_sdk_event = SplitIoClient::Engine::Models::ValidSdkEvent.new(
+                require_any_sdk_event.sdk_event,
+                check_prerequisites(require_any_sdk_event.sdk_event) &&
+                check_suppressed_by(require_any_sdk_event.sdk_event)
+              )
+            end
+            events_to_fire.push(final_sdk_event.sdk_event) if final_sdk_event.valid
+          end
+          check_require_all.each { |sdk_event| events_to_fire.push(sdk_event) }
+
+          events_to_fire
+        end
+
+        def check_require_all
+          events = []
+          @manager_config.require_all.each do |require_name, require_value|
+            final_status = true
+            require_value.each { |val| final_status &= get_internal_event_status(val) }
+            events.push(require_name) if check_event_eligible_conditions(final_status, require_name, require_value)
+          end
+
+          events
+        end
+
+        def check_event_eligible_conditions(final_status, require_name, require_value)
+          final_status &&
+            check_prerequisites(require_name) &&
+            ((!event_already_triggered(require_name) &&
+            execution_limit(require_name) == 1) ||
+            execution_limit(require_name) == -1) &&
+            require_value.length.positive?
+        end
+
+        def check_prerequisites(sdk_event)
+          @manager_config.prerequisites.each do |name, value|
+            value.each do |val|
+              return false if name == sdk_event && !event_already_triggered(val)
+            end
+          end
+
+          true
+        end
+
+        def check_suppressed_by(sdk_event)
+          @manager_config.suppressed_by.each do |name, value|
+            value.each do |val|
+              return false if name == sdk_event && event_already_triggered(val)
+            end
+          end
+
+          true
+        end
+
+        def execution_limit(sdk_event)
+          return -1 unless @manager_config.execution_limits.key?(sdk_event)
+
+          @manager_config.execution_limits[sdk_event]
+        end
+
+        def check_require_any(sdk_internal_event)
+          valid_sdk_event = SplitIoClient::Engine::Models::ValidSdkEvent.new(nil, false)
+          @manager_config.require_any.each do |name, val|
+            if val.include?(sdk_internal_event)
+              valid_sdk_event = SplitIoClient::Engine::Models::ValidSdkEvent.new(name, true)
+              return valid_sdk_event
+            end
+          end
+
+          valid_sdk_event
+        end
+      end
+    end
+  end
+end

data/lib/splitclient-rb/engine/events/events_manager_config.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module SplitIoClient
+  module Engine
+    module Events
+      class EventsManagerConfig
+        attr_accessor :require_all, :prerequisites, :require_any, :suppressed_by, :execution_limits, :evaluation_order
+
+        def initialize
+          @require_all = construct_require_all
+          @prerequisites = construct_prerequisites
+          @require_any = construct_require_any
+          @suppressed_by = construct_suppressed_by
+          @execution_limits = construct_execution_limits
+          @evaluation_order = construct_sorted_events
+        end
+
+        private
+
+        def construct_require_all
+          {
+            SplitIoClient::Engine::Models::SdkEvent::SDK_READY => Set.new([SplitIoClient::Engine::Models::SdkInternalEvent::SDK_READY])
+          }
+        end
+
+        def construct_prerequisites
+          {
+            SplitIoClient::Engine::Models::SdkEvent::SDK_UPDATE => Set.new([SplitIoClient::Engine::Models::SdkEvent::SDK_READY])
+          }
+        end
+
+        def construct_require_any
+          {
+            SplitIoClient::Engine::Models::SdkEvent::SDK_UPDATE => Set.new(
+              [
+                SplitIoClient::Engine::Models::SdkInternalEvent::FLAG_KILLED_NOTIFICATION,
+                SplitIoClient::Engine::Models::SdkInternalEvent::FLAGS_UPDATED,
+                SplitIoClient::Engine::Models::SdkInternalEvent::RB_SEGMENTS_UPDATED,
+                SplitIoClient::Engine::Models::SdkInternalEvent::SEGMENTS_UPDATED
+              ]
+            )
+          }
+        end
+
+        def construct_suppressed_by
+          {}
+        end
+
+        def construct_execution_limits
+          {
+            SplitIoClient::Engine::Models::SdkEvent::SDK_READY => 1,
+            SplitIoClient::Engine::Models::SdkEvent::SDK_UPDATE => -1
+          }
+        end
+
+        def construct_sorted_events
+          sorted_events = []
+          [SplitIoClient::Engine::Models::SdkEvent::SDK_READY, SplitIoClient::Engine::Models::SdkEvent::SDK_UPDATE].each do |sdk_event|
+            sorted_events = dfs_recursive(sdk_event, sorted_events)
+          end
+
+          sorted_events
+        end
+
+        def dfs_recursive(sdk_event, added)
+          return added if added.include?(sdk_event)
+
+          get_dependencies(sdk_event).each do |dependent_event|
+            added = dfs_recursive(dependent_event, added)
+          end
+
+          added.push(sdk_event)
+
+          added
+        end
+
+        def get_dependencies(sdk_event)
+          dependencies = Set.new
+          @prerequisites.each do |prerequisites_event_name, prerequisites_event_value|
+            next unless prerequisites_event_name == sdk_event
+
+            prerequisites_event_value.each do |prereq_event|
+              dependencies.add(prereq_event)
+            end
+          end
+
+          @suppressed_by.each do |suppressed_event_name, suppressed_event_value|
+            dependencies.add(suppressed_event_name) if suppressed_event_value.include?(sdk_event)
+          end
+
+          dependencies
+        end
+      end
+    end
+  end
+end

data/lib/splitclient-rb/engine/events/events_task.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module SplitIoClient
+  module Engine
+    module Events
+      class EventsTask
+        attr_accessor :running
+
+        def initialize(notify_internal_events, internal_events_queue, config)
+          @notify_internal_events = notify_internal_events
+          @internal_events_queue = internal_events_queue
+          @config = config
+          @running = false
+        end
+
+        def start
+          return if @running
+
+          @config.logger.info('Starting Internal Events Task.')
+          @running = true
+          @config.threads[:internal_events_task] = Thread.new do
+            worker_thread
+          end
+        end
+
+        def stop
+          return unless @running
+
+          @config.logger.info('Stopping Internal Events Task.')
+          @running = false
+        end
+
+        private
+
+        def worker_thread
+          while (event = @internal_events_queue.pop)
+            break unless @running
+
+            @config.logger.debug("Processing sdk internal event: #{event.internal_event}") if @config.debug_enabled
+            begin
+              @notify_internal_events.call(event.internal_event, event.metadata)
+            rescue StandardError => e
+              @config.log_found_exception(__method__.to_s, e)
+            end
+          end
+        end
+      end
+    end
+  end
+end