launchdarkly-server-sdk 8.15.1-java → 8.17.0-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b11944b433bea0b0d731f8640f8fd4e83499e9bb3e6f80d480b21d90f1a40cfd
-  data.tar.gz: 16cdb4c8fd88ae05176d515405692e0a7f00bf438391a8a306b52d670c0fcd78
+  metadata.gz: 2ae14db1c781b4710d0d0f9487ee7eb0453c81cec33d48deff97ed189fdb864a
+  data.tar.gz: d8b6ed68295b5ca5bec082bfe6a638e9b2b840e5d72764ca3e53fd5f347a589e
 SHA512:
-  metadata.gz: aab9b715aa8d7dd4de84c4d766bb4353b2ea0acf329b6e6c412c6602729791ea00f0125bb90e1f82a721cf8f0f3560d66856490d0449c261443ac18ad601fd30
-  data.tar.gz: cff21015700458dac3bf4aceb3442ba1c84f139bf9df733fb3417b5676458ecf27af4ef7c4890f4c517a6095affc6f25fab0c6ceb651a816a8886d5c283f8ed8
+  metadata.gz: 163471afe99cdb36fcba1a63cea9d7ba31cfddaa052684f16e8b0d5f847450fc4e127e88ca6d91244d68c42946d05205cf23b100dc8942ad2406004f2dfcb8c1
+  data.tar.gz: 39d3fb3d49c3506130b0cc26c8299867fa30e1c1bb946c8f961cec131b4b2f02f21d3c372bbfa6558ab26ade14ba12a9643a308434400b354b03e2d566eb2da2

data/lib/ldclient-rb/config.rb

@@ -362,6 +362,9 @@ module LaunchDarkly
     # This payload filter key only applies to the default streaming and polling data sources. It will not affect TestData or FileData
     # data sources, nor will it be applied to any data source provided through the {#data_source} config property.
     #
+    # Payload filtering is not supported with the FDv2 data system, so this key has no effect on requests made by FDv2
+    # data sources.
+    #
     attr_reader :payload_filter_key
 
     #

data/lib/ldclient-rb/impl/data_system/fdv2.rb

@@ -54,6 +54,11 @@ module LaunchDarkly
           @config = config
           @data_system_config = data_system_config
           @logger = config.logger
+
+          unless config.payload_filter_key.nil?
+            @logger.warn { "[LDClient] Payload filtering is not supported with the FDv2 data system; the configured payload filter has no effect on FDv2 requests" }
+          end
+
           @synchronizer_builders = data_system_config.synchronizers || []
           @fdv1_fallback_synchronizer_builder = data_system_config.fdv1_fallback_synchronizer
           @disabled = @config.offline?

data/lib/ldclient-rb/impl/repeating_task.rb

@@ -4,22 +4,39 @@ require "concurrent/atomics"
 
 module LaunchDarkly
   module Impl
+    #
+    # Runs a task again and again on a worker thread, with a fixed interval
+    # between runs.
+    #
+    # The worker waits on an event instead of calling `sleep`, so `stop` can
+    # wake it at once even if `stop` runs before the worker starts waiting.
+    #
+    # @private
+    #
     class RepeatingTask
       attr_reader :name
 
+      #
+      # @param interval [Numeric] seconds between the start of one run and the start of the next
+      # @param start_delay [Numeric, nil] seconds to wait before the first run
+      # @param task [Proc] the code to run
+      # @param logger [Logger]
+      # @param name [String] the name given to the worker thread
+      #
       def initialize(interval, start_delay, task, logger, name)
         @interval = interval
         @start_delay = start_delay
         @task = task
         @logger = logger
         @stopped = Concurrent::AtomicBoolean.new(false)
+        @stop_event = Concurrent::Event.new
         @worker = nil
         @name = name
       end
 
       def start
         @worker = Thread.new do
-          sleep(@start_delay) unless @start_delay.nil? || @start_delay == 0
+          @stop_event.wait(@start_delay) unless @start_delay.nil? || @start_delay == 0
 
           until @stopped.value do
             started_at = Time.now
@@ -29,19 +46,23 @@ module LaunchDarkly
               Impl::Util.log_exception(@logger, "Uncaught exception from repeating task", e)
             end
             delta = @interval - (Time.now - started_at)
-            if delta > 0
-              sleep(delta)
-            end
+            @stop_event.wait(delta) if delta > 0
           end
         end
 
         @worker.name = @name
       end
 
+      #
+      # Stops the worker thread and waits for it to finish.
+      #
+      # This method is safe to call more than once, before `start`, and from
+      # inside the task itself.
+      #
       def stop
         if @stopped.make_true
+          @stop_event.set
           if @worker && @worker.alive? && @worker != Thread.current
-            @worker.run  # causes the thread to wake up if it's currently in a sleep
             @worker.join
           end
         end

data/lib/ldclient-rb/integrations/test_data/flag_builder.rb

@@ -487,7 +487,7 @@ module LaunchDarkly
         #
         class FlagRuleBuilder
           # @api private
-          FlagRuleClause = Struct.new(:contextKind, :attribute, :op, :values, :negate, keyword_init: true) # rubocop:disable Naming/MethodName:
+          FlagRuleClause = Struct.new(:contextKind, :attribute, :op, :values, :negate, keyword_init: true) # rubocop:disable Naming/MethodName
 
           # @api private
           def initialize(flag_builder)

data/lib/ldclient-rb/ldclient.rb

@@ -33,10 +33,6 @@ 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]
@@ -79,6 +75,12 @@ module LaunchDarkly
       config.instance_id = SecureRandom.uuid
       @config = config
 
+      # The pid of the process that owns this client's background threads. A child process that
+      # inherits this client after a fork has a different pid. See #check_forked.
+      @owner_pid = Process.pid
+      # The pid of the process in which the fork warning was last logged, or nil.
+      @fork_warned_pid = Concurrent::AtomicReference.new(nil)
+
       start_up(wait_for_sec)
     end
 
@@ -97,6 +99,10 @@ module LaunchDarkly
     # reason, it is recommended that any listener or hook integrations be added postfork unless you are certain it can
     # survive the forking process.
     #
+    # If the SDK is used in a forked child process before this method is called, it logs a warning once per process.
+    # The warning says that flag updates and analytics events will not work until `postfork` is called. Calling this
+    # method clears that condition for the current process.
+    #
     # @param wait_for_sec [Float] maximum time (in seconds) to wait for initialization
     #
     def postfork(wait_for_sec = 5)
@@ -105,9 +111,51 @@ module LaunchDarkly
       @big_segment_store_manager = nil
       @flag_tracker = nil
 
+      @owner_pid = Process.pid
+      @fork_warned_pid.set(nil)
+
       start_up(wait_for_sec)
     end
 
+    FORK_WARNING_MESSAGE = "[LDClient] This process was forked after the LDClient was created. Background threads do not " +
+      "survive a fork, so flag updates and analytics events will not work in this process. Call LDClient#postfork after forking."
+    private_constant :FORK_WARNING_MESSAGE
+
+    #
+    # Log a warning once per process if this client is used in a process that was forked after the client was created.
+    #
+    # Ruby threads do not survive a fork. A child process that inherits a client has no stream thread, no event
+    # dispatcher thread, and no timer tasks, so flag updates and analytics events stop working. The SDK does not
+    # repair this by itself; the application must call {#postfork}.
+    #
+    # The check compares the current pid with the pid recorded in the constructor or in {#postfork}. It is a single
+    # `getpid` call, which is cheap compared to a flag evaluation. The "already warned" state is stored as the pid in
+    # which the warning was logged, not as a boolean. A boolean would be copied into every child on fork, so a
+    # grandchild process would inherit "already warned" from its parent and never get its own warning.
+    #
+    private def check_forked
+      pid = Process.pid
+      return if pid == @owner_pid
+      return unless fork_breaks_client?
+
+      if @fork_warned_pid.get_and_set(pid) != pid
+        @config.logger.warn { FORK_WARNING_MESSAGE }
+      end
+    end
+
+    #
+    # Return true if this configuration needs background threads. Offline mode has none. LDD mode with events
+    # disabled reads flags from the persistent store and sends nothing, so a fork does not break it.
+    #
+    # @return [Boolean]
+    #
+    private def fork_breaks_client?
+      return false if @config.offline?
+      return false if @config.use_ldd? && !@config.send_events
+
+      true
+    end
+
     private def start_up(wait_for_sec)
       environment_metadata = get_environment_metadata
       plugin_hooks = get_plugin_hooks(environment_metadata)
@@ -281,6 +329,7 @@ module LaunchDarkly
     # @return the variation for the provided context, or the default value if there's an error
     #
     def variation(key, context, default)
+      check_forked
       context = Impl::Context::make_context(context)
       result = evaluate_with_hooks(key, context, default, :variation) do
         detail, _, _ = variation_with_flag(key, context, default)
@@ -314,6 +363,7 @@ module LaunchDarkly
     # @return [EvaluationDetail] an object describing the result
     #
     def variation_detail(key, context, default)
+      check_forked
       context = Impl::Context::make_context(context)
       result = evaluate_with_hooks(key, context, default, :variation_detail) do
         detail, _, _ = evaluate_internal(key, context, default, true)
@@ -439,6 +489,7 @@ module LaunchDarkly
     # @return [Array<Symbol, Interfaces::Migrations::OpTracker>]
     #
     def migration_variation(key, context, default_stage)
+      check_forked
       unless Migrations::VALID_STAGES.include? default_stage
         @config.logger.error { "[LDClient] default_stage #{default_stage} is not a valid stage; continuing with 'off' as default" }
         default_stage = Migrations::STAGE_OFF
@@ -480,6 +531,7 @@ module LaunchDarkly
     # @return [void]
     #
     def identify(context)
+      check_forked
       context = LaunchDarkly::Impl::Context.make_context(context)
       unless context.valid?
         @config.logger.warn("Identify called with invalid context: #{context.error}")
@@ -516,6 +568,7 @@ module LaunchDarkly
     # @return [void]
     #
     def track(event_name, context, data = nil, metric_value = nil)
+      check_forked
       context = LaunchDarkly::Impl::Context.make_context(context)
       unless context.valid?
         @config.logger.warn("Track called with invalid context: #{context.error}")
@@ -536,6 +589,7 @@ module LaunchDarkly
     # @param tracker [LaunchDarkly::Interfaces::Migrations::OpTracker]
     #
     def track_migration_op(tracker)
+      check_forked
       unless tracker.is_a? LaunchDarkly::Interfaces::Migrations::OpTracker
         @config.logger.error { "invalid op tracker received in track_migration_op" }
         return
@@ -571,6 +625,8 @@ module LaunchDarkly
     def all_flags_state(context, options={})
       return FeatureFlagsState.new(false) if @config.offline?
 
+      check_forked
+
       unless initialized?
         if @data_system.store.initialized?
             @config.logger.warn { "Called all_flags_state before client initialization; using last known values from data store" }
@@ -628,11 +684,24 @@ module LaunchDarkly
       state
     end
 
+    #
+    # Tells the client that all pending analytics events should be delivered as soon as possible.
+    #
+    # Delegates to {LaunchDarkly::EventProcessorMethods#flush}.
+    #
+    # @return [void]
+    #
+    def flush
+      check_forked
+      @event_processor.flush
+    end
+
     #
     # Releases all network connections and other resources held by the client, making it no longer usable.
     #
     # @return [void]
     def close
+      check_forked
       @config.logger.info { "[LDClient] Closing LaunchDarkly client..." }
       @data_system.stop
       @event_processor.stop

data/lib/ldclient-rb/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: launchdarkly-server-sdk
 version: !ruby/object:Gem::Version
-  version: 8.15.1
+  version: 8.17.0
 platform: java
 authors:
 - LaunchDarkly
 bindir: bin
 cert_chain: []
-date: 2026-08-28 00:00:00.000000000 Z
+date: 2026-09-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-dynamodb