launchdarkly-server-sdk 8.14.0-java → 8.15.0-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6f092405b663bdca252bd2f617e1c81b8000860c5a711c6cfb3d0214f7d366d
-  data.tar.gz: 5915a81dd336f244663cda3c52a68329a1d35c3b71716b5a050929df685ea5aa
+  metadata.gz: dc18b4c7af16130b9f7e9f7c8d0a4acd8e562d16ebb7714fc7846c9ff96d1d3f
+  data.tar.gz: 2c9bfdff939fb1f11a9bc83e707aa0e550136004c4a2870b7220fb293ad268f2
 SHA512:
-  metadata.gz: 03b8f0e3c245e462e7de04adb9c9ea9a63d4f6c61eeb6564a7a668235c7a565aac296233a28079fefeff199b8b5dcb78baff34098180a7fd7c7d2fdb7ddf3c1c
-  data.tar.gz: 19e70edd5df9b330aa1a68e0faa6ab4453bb7772629fad7b3b79271fb41b7003028a84b4719c2250987cf2db41d31f3c39fdc94ef3459d10c3f622aa32ba2f94
+  metadata.gz: 0b23cf9eda9b570844be07e71831f19734881b72d08c464b109929b17d225ac2083d78ead046418bdfec68e67db82f940c344efd3ce408ad1a1ea49e0d3dcaf2
+  data.tar.gz: ceb93287c34afbbb2301d3991267a10b1349aa126bea72c028552c431dc3493ec5f136d06b79f21641363dd9bfa87cce1a5ceb225534ff98ab8ad3088c2d7fc0

data/lib/ldclient-rb/config.rb

@@ -399,6 +399,30 @@ module LaunchDarkly
     #
     attr_reader :wrapper_version
 
+    #
+    # Returns a copy of this configuration with different wrapper information.
+    #
+    # This is intended for use by wrapper libraries, such as the LaunchDarkly OpenFeature provider, which need to
+    # identify themselves rather than the application which created the configuration.
+    #
+    # The copy is shallow: it shares the objects the original configuration references, such as the feature store,
+    # the logger, and the socket factory. Mutating one of those objects affects both configurations.
+    #
+    # @param wrapper_name [String, nil] see {#wrapper_name}
+    # @param wrapper_version [String, nil] see {#wrapper_version}
+    #
+    # @return [LaunchDarkly::Config]
+    #
+    def with_wrapper_information(wrapper_name, wrapper_version = nil)
+      updated = dup
+      updated.wrapper_name = wrapper_name
+      updated.wrapper_version = wrapper_version
+
+      updated
+    end
+
+    protected attr_writer :wrapper_name, :wrapper_version
+
     #
     # The factory used to construct sockets for HTTP operations. The factory must
     # provide the method `open(uri, timeout)`. The `open` method must return a

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

@@ -70,15 +70,15 @@ module LaunchDarkly
         filtered[:anonymous] = true if anonymous
 
         redacted = []
-        private_attributes = @private_attributes.concat(context.private_attributes)
+        private_attributes = @private_attributes + context.private_attributes
 
         name = context.get_value(:name)
-        if !name.nil? && !check_whole_attribute_private(:name, private_attributes, redacted, anonymous && redact_anonymous)
+        if !name.nil? && !check_whole_attribute_private(Reference.create_literal(:name), private_attributes, redacted, anonymous && redact_anonymous)
           filtered[:name] = name
         end
 
         context.get_custom_attribute_names.each do |attribute|
-          unless check_whole_attribute_private(attribute, private_attributes, redacted, anonymous && redact_anonymous)
+          unless check_whole_attribute_private(Reference.create_literal(attribute), private_attributes, redacted, anonymous && redact_anonymous)
             value = context.get_value(attribute)
             filtered[attribute] = redact_json_value(nil, attribute, value, private_attributes, redacted)
           end
@@ -92,7 +92,7 @@ module LaunchDarkly
       #
       # Check if an entire attribute should be redacted.
       #
-      # @param attribute [Symbol]
+      # @param attribute [Reference]
       # @param private_attributes [Array<Reference>]
       # @param redacted [Array<Symbol>]
       # @param redact_all [Boolean]
@@ -100,13 +100,13 @@ module LaunchDarkly
       #
       private def check_whole_attribute_private(attribute, private_attributes, redacted, redact_all)
         if @all_attributes_private || redact_all
-          redacted << attribute
+          redacted << attribute.raw_path.to_sym
           return true
         end
 
         private_attributes.each do |private_attribute|
-          if private_attribute.component(0) == attribute && private_attribute.depth == 1
-            redacted << attribute
+          if private_attribute.component(0) == attribute.component(0) && private_attribute.depth == 1
+            redacted << attribute.raw_path.to_sym
             return true
           end
         end

data/lib/ldclient-rb/impl/data_source/polling.rb

@@ -1,3 +1,4 @@
+require "ldclient-rb/impl/data_source"
 require "ldclient-rb/impl/repeating_task"
 require "ldclient-rb/impl/util"
 
@@ -35,7 +36,8 @@ module LaunchDarkly
 
         def poll
           begin
-            all_data = @requestor.request_all_data
+            all_data, headers = request_all_data
+            DataSource.record_environment_id(@config.data_source_update_sink, headers)
             if all_data
               update_sink_or_data_store.init(all_data)
               if @initialized.make_true
@@ -92,6 +94,17 @@ module LaunchDarkly
           @config.data_source_update_sink || @config.feature_store
         end
 
+        #
+        # Requestors provided by application code may not be able to report the response headers.
+        #
+        # @return [Array(Hash, HTTP::Headers, nil)]
+        #
+        private def request_all_data
+          return @requestor.request_all_data_with_headers if @requestor.respond_to?(:request_all_data_with_headers)
+
+          [@requestor.request_all_data, nil]
+        end
+
         #
         # @param [LaunchDarkly::Interfaces::DataSource::ErrorInfo, nil] error_info
         #

data/lib/ldclient-rb/impl/data_source/requestor.rb

@@ -40,8 +40,18 @@ module LaunchDarkly
         end
 
         def request_all_data()
-          all_data = JSON.parse(make_request("/sdk/latest-all"), symbolize_names: true)
-          Impl::Model.make_all_store_data(all_data, @config.logger)
+          request_all_data_with_headers.first
+        end
+
+        #
+        # Requests the full data set, also returning the headers of the response it was retrieved from.
+        #
+        # @return [Array(Hash, HTTP::Headers)]
+        #
+        def request_all_data_with_headers
+          body, headers = make_request("/sdk/latest-all")
+          all_data = JSON.parse(body, symbolize_names: true)
+          [Impl::Model.make_all_store_data(all_data, @config.logger), headers]
         end
 
         def stop
@@ -80,7 +90,7 @@ module LaunchDarkly
             etag = response.headers["etag"]
             @cache.write(uri, CacheEntry.new(etag, body)) unless etag.nil?
           end
-          body
+          [body, response.headers]
         end
 
         def fix_encoding(body, content_type)

data/lib/ldclient-rb/impl/data_source/stream.rb

@@ -1,3 +1,4 @@
+require "ldclient-rb/impl/data_source"
 require "ldclient-rb/impl/model/serialization"
 require "ldclient-rb/impl/util"
 require "ldclient-rb/in_memory_store"
@@ -54,6 +55,7 @@ module LaunchDarkly
 
           uri = Impl::Util.add_payload_filter_key(@config.stream_uri + "/all", @config)
           @es = SSE::Client.new(uri, **opts) do |conn|
+            conn.on_connect { |response_headers| DataSource.record_environment_id(@data_source_update_sink, response_headers) }
             conn.on_event { |event| process_message(event) }
             conn.on_error { |err|
               log_connection_result(false)

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

@@ -7,6 +7,27 @@ require "set"
 module LaunchDarkly
   module Impl
     module DataSource
+      LD_ENVID_HEADER = "X-LD-EnvID"
+
+      #
+      # Records the environment ID reported by LaunchDarkly, when the response headers provide one and the sink is
+      # able to hold it. Externally implemented sinks are not required to support this.
+      #
+      # @param sink [LaunchDarkly::Interfaces::DataSource::UpdateSink, nil]
+      # @param headers [#[], nil]
+      # @return [void]
+      #
+      def self.record_environment_id(sink, headers)
+        return if headers.nil? || !sink.respond_to?(:set_environment_id)
+
+        environment_id = headers[LD_ENVID_HEADER]
+        # The http gem returns arrays for repeated headers; normalize to a string.
+        environment_id = environment_id.first if environment_id.is_a?(Array)
+        return unless environment_id.is_a?(String) && !environment_id.empty?
+
+        sink.set_environment_id(environment_id)
+      end
+
       class StatusProvider
         include LaunchDarkly::Interfaces::DataSource::StatusProvider
 
@@ -41,12 +62,28 @@ module LaunchDarkly
           @dependency_tracker = LaunchDarkly::Impl::DependencyTracker.new
 
           @mutex = Mutex.new
+          @environment_id = nil
           @current_status = LaunchDarkly::Interfaces::DataSource::Status.new(
             LaunchDarkly::Interfaces::DataSource::Status::INITIALIZING,
             Time.now,
             nil)
         end
 
+        #
+        # @return [String, nil] The environment ID reported by LaunchDarkly, if known
+        #
+        def environment_id
+          @mutex.synchronize { @environment_id }
+        end
+
+        #
+        # @param environment_id [String]
+        # @return [void]
+        #
+        def set_environment_id(environment_id)
+          @mutex.synchronize { @environment_id = environment_id }
+        end
+
         def init(all_data)
           old_data = nil
           monitor_store_update do

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

@@ -121,6 +121,11 @@ module LaunchDarkly
           @flag_change_broadcaster
         end
 
+        # (see DataSystem#environment_id)
+        def environment_id
+          @data_source_update_sink.environment_id
+        end
+
         #
         # (see DataSystem#data_availability)
         #

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

@@ -100,6 +100,9 @@ module LaunchDarkly
             @store.with_persistence(wrapper, writable, @data_store_status_provider)
           end
 
+          @environment_id = nil
+          @environment_id_lock = Mutex.new
+
           # Threading
           @stop_event = Concurrent::Event.new
           @ready_event = Concurrent::Event.new
@@ -185,6 +188,11 @@ module LaunchDarkly
           @flag_change_broadcaster
         end
 
+        # (see DataSystem#environment_id)
+        def environment_id
+          @environment_id_lock.synchronize { @environment_id }
+        end
+
         # (see DataSystem#data_availability)
         def data_availability
           return DataAvailability::REFRESHED if @store.selector.defined?
@@ -270,6 +278,7 @@ module LaunchDarkly
               if basis_result.success?
                 basis = basis_result.value
                 @logger.info { "[LDClient] Initialized via #{initializer.name}" }
+                record_environment_id(basis.environment_id)
 
                 # Apply the basis to the store regardless of whether fallback was signalled.
                 # If the server returned a valid payload alongside the directive we still want
@@ -460,7 +469,10 @@ module LaunchDarkly
               @store.apply(update.change_set, true) if update.change_set
 
               # Set ready event on valid update
-              @ready_event.set if update.state == LaunchDarkly::Interfaces::DataSource::Status::VALID
+              if update.state == LaunchDarkly::Interfaces::DataSource::Status::VALID
+                @ready_event.set
+                record_environment_id(update.environment_id)
+              end
 
               # Update status
               @data_source_status_provider.update_status(update.state, update.error)
@@ -481,6 +493,18 @@ module LaunchDarkly
           SyncResult::REMOVE
         end
 
+        #
+        # Retains the environment ID reported by a successful connection to LaunchDarkly.
+        #
+        # @param environment_id [String, nil]
+        # @return [void]
+        #
+        def record_environment_id(environment_id)
+          return unless environment_id.is_a?(String) && !environment_id.empty?
+
+          @environment_id_lock.synchronize { @environment_id = environment_id }
+        end
+
         #
         # Determine if we should fallback to the next synchronizer.
         #

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

@@ -313,7 +313,7 @@ module LaunchDarkly
           query_params << ["filter", @config.payload_filter_key] unless @config.payload_filter_key.nil?
 
           if selector && selector.defined?
-            query_params << ["selector", selector.state]
+            query_params << ["basis", selector.state]
           end
 
           uri = @poll_uri

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

@@ -119,6 +119,15 @@ module LaunchDarkly
         raise NotImplementedError, "#{self.class} must implement #set_diagnostic_accumulator"
       end
 
+      #
+      # Returns the ID of the environment the SDK is connected to, if LaunchDarkly has reported one.
+      #
+      # @return [String, nil]
+      #
+      def environment_id
+        raise NotImplementedError, "#{self.class} must implement #environment_id"
+      end
+
       #
       # Represents the availability of data in the SDK.
       #

data/lib/ldclient-rb/integrations/file_data.rb

@@ -50,7 +50,7 @@ module LaunchDarkly
     #       "segments": {
     #         "segment-key-1": {
     #           "key": "segment-key-1",
-    #           "includes": [ "user-key-1" ]
+    #           "included": [ "user-key-1" ]
     #         }
     #       }
     #     }

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

@@ -70,17 +70,27 @@ module LaunchDarkly
         attr_reader :default_value
         attr_reader :method
 
+        #
+        # The ID of the LaunchDarkly environment the SDK is connected to, if known. This is only available once the
+        # SDK has received data from LaunchDarkly.
+        #
+        # @return [String, nil]
+        #
+        attr_reader :environment_id
+
         #
         # @param key [String]
         # @param context [LaunchDarkly::LDContext]
         # @param default_value [any]
         # @param method [Symbol]
+        # @param environment_id [String, nil]
         #
-        def initialize(key, context, default_value, method)
+        def initialize(key, context, default_value, method, environment_id = nil)
           @key = key
           @context = context
           @default_value = default_value
           @method = method
+          @environment_id = environment_id
         end
       end
     end

data/lib/ldclient-rb/ldclient.rb

@@ -421,7 +421,7 @@ module LaunchDarkly
       # Hooks can be added and we want to ensure all correct stages for a given hook execute. For example, we do not
       # want to trigger the after_evaluation method without also triggering the before_evaluation method.
       hooks = @hooks.dup
-      evaluation_series_context = Interfaces::Hooks::EvaluationSeriesContext.new(key, context, default, method)
+      evaluation_series_context = Interfaces::Hooks::EvaluationSeriesContext.new(key, context, default, method, @data_system.environment_id)
 
       [hooks, evaluation_series_context]
     end

data/lib/ldclient-rb/version.rb

@@ -1,3 +1,3 @@
 module LaunchDarkly
-  VERSION = "8.14.0" # x-release-please-version
+  VERSION = "8.15.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.14.0
+  version: 8.15.0
 platform: java
 authors:
 - LaunchDarkly
 bindir: bin
 cert_chain: []
-date: 2026-06-01 00:00:00.000000000 Z
+date: 2026-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-dynamodb