launchdarkly-server-sdk 8.11.2-java → 8.12.0-java

data/lib/ldclient-rb/interfaces/feature_store.rb

@@ -36,7 +36,7 @@ module LaunchDarkly
       # the correct order), storing each item, and then delete any leftover items at the very end.
       #
       # @param all_data [Hash]  a hash where each key is one of the data kind objects, and each
-      #   value is in turn a hash of string keys to entities
+      #   value is in turn a hash of symbol keys to entities
       # @return [void]
       #
       def init(all_data)
@@ -46,7 +46,7 @@ module LaunchDarkly
       # Returns the entity to which the specified key is mapped, if any.
       #
       # @param kind [Object]  the kind of entity to get
-      # @param key [String]  the unique key of the entity to get
+      # @param key [String, Symbol]  the unique key of the entity to get
       # @return [Hash]  the entity; nil if the key was not found, or if the stored entity's
       #   `:deleted` property was true
       #
@@ -103,6 +103,9 @@ module LaunchDarkly
       #
       # Performs any necessary cleanup to shut down the store when the client is being shut down.
       #
+      # This method should be idempotent - it is safe to call it multiple times, and subsequent
+      # calls after the first should have no effect.
+      #
       # @return [void]
       #
       def stop

data/lib/ldclient-rb/ldclient.rb

@@ -1,14 +1,17 @@
 require "ldclient-rb/impl/big_segments"
 require "ldclient-rb/impl/broadcaster"
+require "ldclient-rb/impl/context"
 require "ldclient-rb/impl/data_source"
 require "ldclient-rb/impl/data_store"
-require "ldclient-rb/impl/data_source/null_processor"
+require "ldclient-rb/impl/data_system/fdv1"
+require "ldclient-rb/impl/data_system/fdv2"
 require "ldclient-rb/impl/diagnostic_events"
-require "ldclient-rb/impl/evaluator"
 require "ldclient-rb/impl/evaluation_with_hook_result"
+require "ldclient-rb/impl/evaluator"
 require "ldclient-rb/impl/flag_tracker"
-require "ldclient-rb/impl/store_client_wrapper"
 require "ldclient-rb/impl/migrations/tracker"
+require "ldclient-rb/impl/util"
+require "ldclient-rb/events"
 require "concurrent"
 require "concurrent/atomics"
 require "digest/sha1"
@@ -30,6 +33,18 @@ module LaunchDarkly
 
     def_delegators :@config, :logger
 
+    # @!method flush
+    #   Delegates to {LaunchDarkly::EventProcessorMethods#flush}.
+    def_delegator :@event_processor, :flush
+
+    # @!method data_store_status_provider
+    #   Delegates to the data system {LaunchDarkly::Impl::DataSystem#data_store_status_provider}.
+    #   @return [LaunchDarkly::Interfaces::DataStore::StatusProvider]
+    # @!method data_source_status_provider
+    #   Delegates to the data system {LaunchDarkly::Impl::DataSystem#data_source_status_provider}.
+    #   @return [LaunchDarkly::Interfaces::DataSource::StatusProvider]
+    def_delegators :@data_system, :data_store_status_provider, :data_source_status_provider
+
     #
     # Creates a new client instance that connects to LaunchDarkly. A custom
     # configuration parameter can also supplied to specify advanced options,
@@ -48,13 +63,16 @@ module LaunchDarkly
     #
     def initialize(sdk_key, config = Config.default, wait_for_sec = 5)
       # Note that sdk_key is normally a required parameter, and a nil value would cause the SDK to
-      # fail in most configurations. However, there are some configurations where it would be OK
-      # (offline = true, *or* we are using LDD mode or the file data source and events are disabled
-      # so we're not connecting to any LD services) so rather than try to check for all of those
-      # up front, we will let the constructors for the data source implementations implement this
-      # fail-fast as appropriate, and just check here for the part regarding events.
-      if !config.offline? && config.send_events
-        raise ArgumentError, "sdk_key must not be nil" if sdk_key.nil?
+      # fail in most configurations. However, there are some configurations where it would be OK to
+      # not provide a SDK key.
+      #   * Offline mode
+      #   * Using LDD mode with events disabled
+      #   * Using a custom data source (like FileData) with events disabled
+      if !config.offline? && sdk_key.nil?
+        # If the data source is nil we create a default data source which requires the SDK key.
+        if config.send_events || (!config.use_ldd? && config.data_source.nil?)
+          raise ArgumentError, "sdk_key must not be nil"
+        end
       end
 
       @sdk_key = sdk_key
@@ -82,9 +100,10 @@ module LaunchDarkly
     # @param wait_for_sec [Float] maximum time (in seconds) to wait for initialization
     #
     def postfork(wait_for_sec = 5)
-      @data_source = nil
+      @data_system = nil
       @event_processor = nil
       @big_segment_store_manager = nil
+      @flag_tracker = nil
 
       start_up(wait_for_sec)
     end
@@ -95,32 +114,29 @@ module LaunchDarkly
 
       @hooks = Concurrent::Array.new(@config.hooks + plugin_hooks)
 
-      @shared_executor = Concurrent::SingleThreadExecutor.new
-
-      data_store_broadcaster = LaunchDarkly::Impl::Broadcaster.new(@shared_executor, @config.logger)
-      store_sink = LaunchDarkly::Impl::DataStore::UpdateSink.new(data_store_broadcaster)
-
-      # We need to wrap the feature store object with a FeatureStoreClientWrapper in order to add
-      # some necessary logic around updates. Unfortunately, we have code elsewhere that accesses
-      # the feature store through the Config object, so we need to make a new Config that uses
-      # the wrapped store.
-      @store = Impl::FeatureStoreClientWrapper.new(@config.feature_store, store_sink, @config.logger)
-      updated_config = @config.clone
-      updated_config.instance_variable_set(:@feature_store, @store)
-      @config = updated_config
-
-      @data_store_status_provider = LaunchDarkly::Impl::DataStore::StatusProvider.new(@store, store_sink)
+      # Initialize the data system - use FDv2 if configured, otherwise FDv1
+      data_system_config = @config.data_system_config
+      if data_system_config.nil?
+        # Use FDv1 for backwards compatibility
+        # Note: FDv1 will update @config.feature_store to use its wrapped store
+        @data_system = Impl::DataSystem::FDv1.new(@sdk_key, @config)
+      else
+        # Use FDv2 with the provided configuration
+        @data_system = Impl::DataSystem::FDv2.new(@sdk_key, @config, data_system_config)
+      end
 
+      # Components not managed by data system
       @big_segment_store_manager = Impl::BigSegmentStoreManager.new(@config.big_segments, @config.logger)
       @big_segment_store_status_provider = @big_segment_store_manager.status_provider
 
-      get_flag = lambda { |key| @store.get(FEATURES, key) }
-      get_segment = lambda { |key| @store.get(SEGMENTS, key) }
+      get_flag = lambda { |key| @data_system.store.get(Impl::DataStore::FEATURES, key) }
+      get_segment = lambda { |key| @data_system.store.get(Impl::DataStore::SEGMENTS, key) }
       get_big_segments_membership = lambda { |key| @big_segment_store_manager.get_context_membership(key) }
       @evaluator = LaunchDarkly::Impl::Evaluator.new(get_flag, get_segment, get_big_segments_membership, @config.logger)
 
       if !@config.offline? && @config.send_events && !@config.diagnostic_opt_out?
         diagnostic_accumulator = Impl::DiagnosticAccumulator.new(Impl::DiagnosticAccumulator.create_diagnostic_id(@sdk_key))
+        @data_system.set_diagnostic_accumulator(diagnostic_accumulator)
       else
         diagnostic_accumulator = nil
       end
@@ -131,38 +147,14 @@ module LaunchDarkly
         @event_processor = EventProcessor.new(@sdk_key, @config, nil, diagnostic_accumulator)
       end
 
-      if @config.use_ldd?
-        @config.logger.info { "[LDClient] Started LaunchDarkly Client in LDD mode" }
-        @data_source = LaunchDarkly::Impl::DataSource::NullUpdateProcessor.new
-        return  # requestor and update processor are not used in this mode
-      end
-
-      flag_tracker_broadcaster = LaunchDarkly::Impl::Broadcaster.new(@shared_executor, @config.logger)
-      @flag_tracker = LaunchDarkly::Impl::FlagTracker.new(flag_tracker_broadcaster, lambda { |key, context| variation(key, context, nil) })
-
-      data_source_broadcaster = LaunchDarkly::Impl::Broadcaster.new(@shared_executor, @config.logger)
-
-      # Make the update sink available on the config so that our data source factory can access the sink with a shared executor.
-      @config.data_source_update_sink = LaunchDarkly::Impl::DataSource::UpdateSink.new(@store, data_source_broadcaster, flag_tracker_broadcaster)
-
-      @data_source_status_provider = LaunchDarkly::Impl::DataSource::StatusProvider.new(data_source_broadcaster, @config.data_source_update_sink)
-
-      data_source_or_factory = @config.data_source || self.method(:create_default_data_source)
-      if data_source_or_factory.respond_to? :call
-        # Currently, data source factories take two parameters unless they need to be aware of diagnostic_accumulator, in
-        # which case they take three parameters. This will be changed in the future to use a less awkware mechanism.
-        if data_source_or_factory.arity == 3
-          @data_source = data_source_or_factory.call(@sdk_key, @config, diagnostic_accumulator)
-        else
-          @data_source = data_source_or_factory.call(@sdk_key, @config)
-        end
-      else
-        @data_source = data_source_or_factory
-      end
+      # Create the flag tracker using the broadcaster from the data system
+      eval_fn = lambda { |key, context| variation(key, context, nil) }
+      @flag_tracker = Impl::FlagTracker.new(@data_system.flag_change_broadcaster, eval_fn)
 
       register_plugins(environment_metadata)
 
-      ready = @data_source.start
+      # Start the data system
+      ready = @data_system.start
 
       return unless wait_for_sec > 0
 
@@ -173,7 +165,7 @@ module LaunchDarkly
       ok = ready.wait(wait_for_sec)
       if !ok
         @config.logger.error { "[LDClient] Timeout encountered waiting for LaunchDarkly client initialization" }
-      elsif !@data_source.initialized?
+      elsif !initialized?
         @config.logger.error { "[LDClient] LaunchDarkly client initialization failed" }
       end
     end
@@ -236,22 +228,6 @@ module LaunchDarkly
       @hooks.push(hook)
     end
 
-    #
-    # Tells the client that all pending analytics events should be delivered as soon as possible.
-    #
-    # When the LaunchDarkly client generates analytics events (from {#variation}, {#variation_detail},
-    # {#identify}, or {#track}), they are queued on a worker thread. The event thread normally
-    # sends all queued events to LaunchDarkly at regular intervals, controlled by the
-    # {Config#flush_interval} option. Calling `flush` triggers a send without waiting for the
-    # next interval.
-    #
-    # Flushing is asynchronous, so this method will return before it is complete. However, if you
-    # call {#close}, events are guaranteed to be sent before that method returns.
-    #
-    def flush
-      @event_processor.flush
-    end
-
     #
     # Creates a hash string that can be used by the JavaScript SDK to identify a context.
     # For more information, see [Secure mode](https://docs.launchdarkly.com/sdk/features/secure-mode#ruby).
@@ -288,7 +264,9 @@ module LaunchDarkly
     # @return [Boolean] true if the client has been initialized
     #
     def initialized?
-      @config.offline? || @config.use_ldd? || @data_source.initialized?
+      return true if @config.offline? || @config.use_ldd?
+
+      Impl::DataSystem::DataAvailability.at_least?(@data_system.data_availability, Impl::DataSystem::DataAvailability::CACHED)
     end
 
     #
@@ -594,7 +572,7 @@ module LaunchDarkly
       return FeatureFlagsState.new(false) if @config.offline?
 
       unless initialized?
-        if @store.initialized?
+        if @data_system.store.initialized?
             @config.logger.warn { "Called all_flags_state before client initialization; using last known values from data store" }
         else
             @config.logger.warn { "Called all_flags_state before client initialization. Data store not available; returning empty state" }
@@ -609,9 +587,9 @@ module LaunchDarkly
       end
 
       begin
-        features = @store.all(FEATURES)
+        features = @data_system.store.all(Impl::DataStore::FEATURES)
       rescue => exn
-        Util.log_exception(@config.logger, "Unable to read flags for all_flags_state", exn)
+        Impl::Util.log_exception(@config.logger, "Unable to read flags for all_flags_state", exn)
         return FeatureFlagsState.new(false)
       end
 
@@ -628,7 +606,7 @@ module LaunchDarkly
           detail = eval_result.detail
         rescue => exn
           detail = EvaluationDetail.new(nil, nil, EvaluationReason::error(EvaluationReason::ERROR_EXCEPTION))
-          Util.log_exception(@config.logger, "Error evaluating flag \"#{k}\" in all_flags_state", exn)
+          Impl::Util.log_exception(@config.logger, "Error evaluating flag \"#{k}\" in all_flags_state", exn)
         end
 
         requires_experiment_data = experiment?(f, detail.reason)
@@ -656,11 +634,9 @@ module LaunchDarkly
     # @return [void]
     def close
       @config.logger.info { "[LDClient] Closing LaunchDarkly client..." }
-      @data_source.stop
+      @data_system.stop
       @event_processor.stop
       @big_segment_store_manager.stop
-      @store.stop
-      @shared_executor.shutdown
     end
 
     #
@@ -671,33 +647,6 @@ module LaunchDarkly
     #
     attr_reader :big_segment_store_status_provider
 
-    #
-    # Returns an interface for tracking the status of a persistent data store.
-    #
-    # The {LaunchDarkly::Interfaces::DataStore::StatusProvider} has methods for
-    # checking whether the data store is (as far as the SDK knows) currently
-    # operational, tracking changes in this status, and getting cache
-    # statistics. These are only relevant for a persistent data store; if you
-    # are using an in-memory data store, then this method will return a stub
-    # object that provides no information.
-    #
-    # @return [LaunchDarkly::Interfaces::DataStore::StatusProvider]
-    #
-    attr_reader :data_store_status_provider
-
-    #
-    # Returns an interface for tracking the status of the data source.
-    #
-    # The data source is the mechanism that the SDK uses to get feature flag
-    # configurations, such as a streaming connection (the default) or poll
-    # requests. The {LaunchDarkly::Interfaces::DataSource::StatusProvider} has
-    # methods for checking whether the data source is (as far as the SDK knows)
-    # currently operational and tracking changes in this status.
-    #
-    # @return [LaunchDarkly::Interfaces::DataSource::StatusProvider]
-    #
-    attr_reader :data_source_status_provider
-
     #
     # Returns an interface for tracking changes in feature flag configurations.
     #
@@ -705,23 +654,8 @@ module LaunchDarkly
     # requesting notifications about feature flag changes using an event
     # listener model.
     #
-    attr_reader :flag_tracker
-
-    private
-
-    def create_default_data_source(sdk_key, config, diagnostic_accumulator)
-      if config.offline?
-        return LaunchDarkly::Impl::DataSource::NullUpdateProcessor.new
-      end
-      raise ArgumentError, "sdk_key must not be nil" if sdk_key.nil?  # see LDClient constructor comment on sdk_key
-      if config.stream?
-        StreamProcessor.new(sdk_key, config, diagnostic_accumulator)
-      else
-        config.logger.info { "Disabling streaming API" }
-        config.logger.warn { "You should only disable the streaming API if instructed to do so by LaunchDarkly support" }
-        requestor = Requestor.new(sdk_key, config)
-        PollingProcessor.new(config, requestor)
-      end
+    def flag_tracker
+      @flag_tracker
     end
 
     #
@@ -731,7 +665,7 @@ module LaunchDarkly
     #
     # @return [Array<EvaluationDetail, [LaunchDarkly::Impl::Model::FeatureFlag, nil], [String, nil]>]
     #
-    def variation_with_flag(key, context, default)
+    private def variation_with_flag(key, context, default)
       evaluate_internal(key, context, default, false)
     end
 
@@ -743,7 +677,7 @@ module LaunchDarkly
     #
     # @return [Array<EvaluationDetail, [LaunchDarkly::Impl::Model::FeatureFlag, nil], [String, nil]>]
     #
-    def evaluate_internal(key, context, default, with_reasons)
+    private def evaluate_internal(key, context, default, with_reasons)
       if @config.offline?
         return Evaluator.error_result(EvaluationReason::ERROR_CLIENT_NOT_READY, default), nil, nil
       end
@@ -760,8 +694,8 @@ module LaunchDarkly
         return detail, nil, context.error
       end
 
-      unless initialized?
-        if @store.initialized?
+      if @data_system.data_availability != Impl::DataSystem::DataAvailability::REFRESHED
+        if @data_system.data_availability == Impl::DataSystem::DataAvailability::CACHED
           @config.logger.warn { "[LDClient] Client has not finished initializing; using last known values from feature store" }
         else
           @config.logger.error { "[LDClient] Client has not finished initializing; feature store unavailable, returning default value" }
@@ -772,7 +706,7 @@ module LaunchDarkly
       end
 
       begin
-        feature = @store.get(FEATURES, key)
+        feature = @data_system.store.get(Impl::DataStore::FEATURES, key)
       rescue
         # Ignored
       end
@@ -798,7 +732,7 @@ module LaunchDarkly
         record_flag_eval(feature, context, detail, default, with_reasons)
         [detail, feature, nil]
       rescue => exn
-        Util.log_exception(@config.logger, "Error evaluating feature flag \"#{key}\"", exn)
+        Impl::Util.log_exception(@config.logger, "Error evaluating feature flag \"#{key}\"", exn)
         detail = Evaluator.error_result(EvaluationReason::ERROR_EXCEPTION, default)
         record_flag_eval_error(feature, context, default, detail.reason, with_reasons)
         [detail, feature, exn.to_s]

data/lib/ldclient-rb/util.rb

@@ -1,5 +1,4 @@
-require "uri"
-require "http"
+require "ldclient-rb/impl/util"
 
 module LaunchDarkly
   #
@@ -28,10 +27,11 @@ module LaunchDarkly
     #
     # @param error [String]
     # @param exception [Exception, nil]
+    # @param headers [Hash, nil]
     # @return [Result]
     #
-    def self.fail(error, exception = nil)
-      Result.new(nil, error, exception)
+    def self.fail(error, exception = nil, headers = nil)
+      Result.new(nil, error, exception, headers)
     end
 
     #
@@ -58,75 +58,16 @@ module LaunchDarkly
     #
     attr_reader :exception
 
-    private def initialize(value, error = nil, exception = nil)
-      @value = value
-      @error = error
-      @exception = exception
-    end
-  end
-
-  # @private
-  module Util
-    #
-    # Append the payload filter key query parameter to the provided URI.
     #
-    # @param uri [String]
-    # @param config [Config]
-    # @return [String]
+    # @return [Hash] Optional headers associated with the result
     #
-    def self.add_payload_filter_key(uri, config)
-      return uri if config.payload_filter_key.nil?
-
-      begin
-        parsed = URI.parse(uri)
-        new_query_params = URI.decode_www_form(String(parsed.query)) << ["filter", config.payload_filter_key]
-        parsed.query = URI.encode_www_form(new_query_params)
-        parsed.to_s
-      rescue URI::InvalidURIError
-        config.logger.warn { "[LDClient] URI could not be parsed. No filtering will be applied." }
-        uri
-      end
-    end
+    attr_reader :headers
 
-    def self.new_http_client(uri_s, config)
-      http_client_options = {}
-      if config.socket_factory
-        http_client_options["socket_class"] = config.socket_factory
-      end
-      proxy = URI.parse(uri_s).find_proxy
-      unless proxy.nil?
-        http_client_options["proxy"] = {
-          proxy_address: proxy.host,
-          proxy_port: proxy.port,
-          proxy_username: proxy.user,
-          proxy_password: proxy.password,
-        }
-      end
-      HTTP::Client.new(http_client_options)
-        .timeout({
-          read: config.read_timeout,
-          connect: config.connect_timeout,
-        })
-        .persistent(uri_s)
-    end
-
-    def self.log_exception(logger, message, exc)
-      logger.error { "[LDClient] #{message}: #{exc.inspect}" }
-      logger.debug { "[LDClient] Exception trace: #{exc.backtrace}" }
-    end
-
-    def self.http_error_recoverable?(status)
-      if status >= 400 && status < 500
-        status == 400 || status == 408 || status == 429
-      else
-        true
-      end
-    end
-
-    def self.http_error_message(status, context, recoverable_message)
-      desc = (status == 401 || status == 403) ? " (invalid SDK key)" : ""
-      message = Util.http_error_recoverable?(status) ? recoverable_message : "giving up permanently"
-      "HTTP error #{status}#{desc} for #{context} - #{message}"
+    private def initialize(value, error = nil, exception = nil, headers = nil)
+      @value = value
+      @error = error
+      @exception = exception
+      @headers = headers || {}
     end
   end
 end

data/lib/ldclient-rb/version.rb

@@ -1,3 +1,3 @@
 module LaunchDarkly
-  VERSION = "8.11.2" # x-release-please-version
+  VERSION = "8.12.0" # x-release-please-version
 end

data/lib/ldclient-rb.rb

@@ -5,23 +5,15 @@
 module LaunchDarkly
 end
 
-require "ldclient-rb/version"
-require "ldclient-rb/interfaces"
-require "ldclient-rb/util"
-require "ldclient-rb/flags_state"
-require "ldclient-rb/migrations"
-require "ldclient-rb/ldclient"
-require "ldclient-rb/cache_store"
-require "ldclient-rb/expiring_cache"
-require "ldclient-rb/memoized_value"
-require "ldclient-rb/in_memory_store"
+# Public APIs - these define the main interfaces users interact with
 require "ldclient-rb/config"
 require "ldclient-rb/context"
-require "ldclient-rb/reference"
-require "ldclient-rb/stream"
-require "ldclient-rb/polling"
-require "ldclient-rb/simple_lru_cache"
-require "ldclient-rb/non_blocking_thread_pool"
-require "ldclient-rb/events"
-require "ldclient-rb/requestor"
+require "ldclient-rb/data_system"
+require "ldclient-rb/flags_state"
 require "ldclient-rb/integrations"
+require "ldclient-rb/interfaces"
+require "ldclient-rb/ldclient"
+require "ldclient-rb/migrations"
+require "ldclient-rb/reference"
+require "ldclient-rb/util"
+require "ldclient-rb/version"