launchdarkly-server-sdk 8.13.0-java → 8.15.0-java

data/lib/ldclient-rb/impl/integrations/test_data/test_data_source_v2.rb

@@ -46,56 +46,61 @@ module LaunchDarkly
           # Implementation of the Initializer.fetch method.
           #
           # Returns the current test data as a Basis for initial data loading.
+          # Test data sources never request the FDv1 Fallback Directive, so the
+          # returned {FetchResult} always reports `fallback_to_fdv1: false`.
           #
           # @param selector_store [LaunchDarkly::Interfaces::DataSystem::SelectorStore] Provides the Selector (unused for test data)
-          # @return [LaunchDarkly::Result] A Result containing either a Basis or an error message
+          # @return [LaunchDarkly::Interfaces::DataSystem::FetchResult]
           #
           def fetch(selector_store)
-            begin
-              @lock.synchronize do
-                if @closed
-                  return LaunchDarkly::Result.fail('TestDataV2 source has been closed')
-                end
-
-                # Get all current flags and segments from test data
-                init_data = @test_data.make_init_data
-                version = @test_data.get_version
-
-                # Build a full transfer changeset
-                builder = LaunchDarkly::Interfaces::DataSystem::ChangeSetBuilder.new
-                builder.start(LaunchDarkly::Interfaces::DataSystem::IntentCode::TRANSFER_FULL)
-
-                # Add all flags to the changeset
-                init_data[:flags].each do |key, flag_data|
-                  builder.add_put(
-                    LaunchDarkly::Interfaces::DataSystem::ObjectKind::FLAG,
-                    key,
-                    flag_data[:version] || 1,
-                    flag_data
-                  )
-                end
-
-                # Add all segments to the changeset
-                init_data[:segments].each do |key, segment_data|
-                  builder.add_put(
-                    LaunchDarkly::Interfaces::DataSystem::ObjectKind::SEGMENT,
-                    key,
-                    segment_data[:version] || 1,
-                    segment_data
-                  )
+            result =
+              begin
+                @lock.synchronize do
+                  if @closed
+                    next LaunchDarkly::Result.fail('TestDataV2 source has been closed')
+                  end
+
+                  # Get all current flags and segments from test data
+                  init_data = @test_data.make_init_data
+                  version = @test_data.get_version
+
+                  # Build a full transfer changeset
+                  builder = LaunchDarkly::Interfaces::DataSystem::ChangeSetBuilder.new
+                  builder.start(LaunchDarkly::Interfaces::DataSystem::IntentCode::TRANSFER_FULL)
+
+                  # Add all flags to the changeset
+                  init_data[:flags].each do |key, flag_data|
+                    builder.add_put(
+                      LaunchDarkly::Interfaces::DataSystem::ObjectKind::FLAG,
+                      key,
+                      flag_data[:version] || 1,
+                      flag_data
+                    )
+                  end
+
+                  # Add all segments to the changeset
+                  init_data[:segments].each do |key, segment_data|
+                    builder.add_put(
+                      LaunchDarkly::Interfaces::DataSystem::ObjectKind::SEGMENT,
+                      key,
+                      segment_data[:version] || 1,
+                      segment_data
+                    )
+                  end
+
+                  # Create selector for this version
+                  selector = LaunchDarkly::Interfaces::DataSystem::Selector.new_selector(version.to_s, version)
+                  change_set = builder.finish(selector)
+
+                  basis = LaunchDarkly::Interfaces::DataSystem::Basis.new(change_set: change_set, persist: false, environment_id: nil)
+
+                  LaunchDarkly::Result.success(basis)
                 end
-
-                # Create selector for this version
-                selector = LaunchDarkly::Interfaces::DataSystem::Selector.new_selector(version.to_s, version)
-                change_set = builder.finish(selector)
-
-                basis = LaunchDarkly::Interfaces::DataSystem::Basis.new(change_set: change_set, persist: false, environment_id: nil)
-
-                LaunchDarkly::Result.success(basis)
+              rescue => e
+                LaunchDarkly::Result.fail("Error fetching test data: #{e.message}", e)
               end
-            rescue => e
-              LaunchDarkly::Result.fail("Error fetching test data: #{e.message}", e)
-            end
+
+            LaunchDarkly::Interfaces::DataSystem::FetchResult.new(result: result, fallback_to_fdv1: false)
           end
 
           #
@@ -109,14 +114,14 @@ module LaunchDarkly
           #
           def sync(selector_store)
             # First yield initial data
-            initial_result = fetch(selector_store)
-            unless initial_result.success?
+            initial_fetch = fetch(selector_store)
+            unless initial_fetch.success?
               yield LaunchDarkly::Interfaces::DataSystem::Update.new(
                 state: LaunchDarkly::Interfaces::DataSource::Status::OFF,
                 error: LaunchDarkly::Interfaces::DataSource::ErrorInfo.new(
                   LaunchDarkly::Interfaces::DataSource::ErrorInfo::STORE_ERROR,
                   0,
-                  initial_result.error,
+                  initial_fetch.error,
                   Time.now
                 )
               )
@@ -126,7 +131,7 @@ module LaunchDarkly
             # Yield the initial successful state
             yield LaunchDarkly::Interfaces::DataSystem::Update.new(
               state: LaunchDarkly::Interfaces::DataSource::Status::VALID,
-              change_set: initial_result.value.change_set
+              change_set: initial_fetch.value.change_set
             )
 
             # Continue yielding updates as they arrive

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

@@ -32,8 +32,12 @@ module LaunchDarkly
       # @option opts [String] :url   shortcut for setting the `url` property of the Consul client configuration
       # @option opts [String] :prefix  namespace prefix to add to all keys used by LaunchDarkly
       # @option opts [Logger] :logger  a `Logger` instance; defaults to `Config.default_logger`
-      # @option opts [Integer] :expiration (15)  expiration time for the in-memory cache, in seconds; 0 for no local caching
-      # @option opts [Integer] :capacity (1000)  maximum number of items in the cache
+      # @option opts [Integer] :expiration (15)  expiration time for the in-memory cache, in seconds; 0 for no local caching.
+      #   When the SDK is configured to use FDv2, the persistent-store cache is automatically
+      #   dropped once the in-memory store has been initialized, so this setting only affects
+      #   the brief bootstrap window before the first set of flag data has been received.
+      # @option opts [Integer] :capacity (1000)  maximum number of items in the cache.
+      #   Same FDv2 caveat as `:expiration` applies.
       # @return [LaunchDarkly::Interfaces::FeatureStore]  a feature store object
       #
       def self.new_feature_store(opts = {})

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

@@ -42,8 +42,12 @@ module LaunchDarkly
       # @option opts [Object] :existing_client  an already-constructed DynamoDB client for the feature store to use
       # @option opts [String] :prefix  namespace prefix to add to all keys used by LaunchDarkly
       # @option opts [Logger] :logger  a `Logger` instance; defaults to `Config.default_logger`
-      # @option opts [Integer] :expiration (15)  expiration time for the in-memory cache, in seconds; 0 for no local caching
-      # @option opts [Integer] :capacity (1000)  maximum number of items in the cache
+      # @option opts [Integer] :expiration (15)  expiration time for the in-memory cache, in seconds; 0 for no local caching.
+      #   When the SDK is configured to use FDv2, the persistent-store cache is automatically
+      #   dropped once the in-memory store has been initialized, so this setting only affects
+      #   the brief bootstrap window before the first set of flag data has been received.
+      # @option opts [Integer] :capacity (1000)  maximum number of items in the cache.
+      #   Same FDv2 caveat as `:expiration` applies.
       # @return [LaunchDarkly::Interfaces::FeatureStore]  a feature store object
       #
       def self.new_feature_store(table_name, opts = {})

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" ]
     #         }
     #       }
     #     }
@@ -108,9 +108,6 @@ module LaunchDarkly
       #
       # Returns a builder for the FDv2-compatible file data source.
       #
-      # This method is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       # This method returns a builder proc that can be used with the FDv2 data system
       # configuration as both an Initializer and a Synchronizer. When used as an Initializer
       # (via `fetch`), it reads files once. When used as a Synchronizer (via `sync`), it

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

@@ -50,8 +50,12 @@ module LaunchDarkly
       # @option opts [String] :prefix (default_prefix)  namespace prefix to add to all hash keys used by LaunchDarkly
       # @option opts [Logger] :logger  a `Logger` instance; defaults to `Config.default_logger`
       # @option opts [Integer] :max_connections  size of the Redis connection pool
-      # @option opts [Integer] :expiration (15)  expiration time for the in-memory cache, in seconds; 0 for no local caching
-      # @option opts [Integer] :capacity (1000)  maximum number of items in the cache
+      # @option opts [Integer] :expiration (15)  expiration time for the in-memory cache, in seconds; 0 for no local caching.
+      #   When the SDK is configured to use FDv2, the persistent-store cache is automatically
+      #   dropped once the in-memory store has been initialized, so this setting only affects
+      #   the brief bootstrap window before the first set of flag data has been received.
+      # @option opts [Integer] :capacity (1000)  maximum number of items in the cache.
+      #   Same FDv2 caveat as `:expiration` applies.
       # @option opts [Object] :pool  custom connection pool, if desired
       # @option opts [Boolean] :pool_shutdown_on_close whether calling `close` should shutdown the custom connection pool;
       #   this is true by default, and should be set to false only if you are managing the pool yourself and want its

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

@@ -9,9 +9,6 @@ module LaunchDarkly
     # A mechanism for providing dynamically updatable feature flag state in a
     # simplified form to an SDK client in test scenarios using the FDv2 protocol.
     #
-    # This class is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-    # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-    #
     # Unlike {LaunchDarkly::Integrations::FileData}, this mechanism does not use any external resources. It
     # provides only the data that the application has put into it using the {#update} method.
     #

data/lib/ldclient-rb/integrations/util/store_wrapper.rb

@@ -61,50 +61,52 @@ module LaunchDarkly
           @core.init_internal(all_data)
           @inited.make_true
 
-          unless @cache.nil?
-            @cache.clear
+          cache = @cache
+          unless cache.nil?
+            cache.clear
             all_data.each do |kind, items|
-              @cache[kind] = items_if_not_deleted(items)
+              cache[kind] = items_if_not_deleted(items)
               items.each do |key, item|
-                @cache[item_cache_key(kind, key)] = [item]
+                cache[item_cache_key(kind, key)] = [item]
               end
             end
           end
         end
 
         def get(kind, key)
-          unless @cache.nil?
-            cache_key = item_cache_key(kind, key)
-            cached = @cache[cache_key] # note, item entries in the cache are wrapped in an array so we can cache nil values
+          cache = @cache
+          cache_key = item_cache_key(kind, key)
+          unless cache.nil?
+            cached = cache[cache_key] # note, item entries in the cache are wrapped in an array so we can cache nil values
             return item_if_not_deleted(cached[0]) unless cached.nil?
           end
 
           item = @core.get_internal(kind, key)
 
-          unless @cache.nil?
-            @cache[cache_key] = [item]
-          end
+          cache[cache_key] = [item] unless cache.nil?
 
           item_if_not_deleted(item)
         end
 
         def all(kind)
-          unless @cache.nil?
-            items = @cache[all_cache_key(kind)]
+          cache = @cache
+          unless cache.nil?
+            items = cache[all_cache_key(kind)]
             return items unless items.nil?
           end
 
           items = items_if_not_deleted(@core.get_all_internal(kind))
-          @cache[all_cache_key(kind)] = items unless @cache.nil?
+          cache[all_cache_key(kind)] = items unless cache.nil?
           items
         end
 
         def upsert(kind, item)
           new_state = @core.upsert_internal(kind, item)
 
-          unless @cache.nil?
-            @cache[item_cache_key(kind, item[:key])] = [new_state]
-            @cache.delete(all_cache_key(kind))
+          cache = @cache
+          unless cache.nil?
+            cache[item_cache_key(kind, item[:key])] = [new_state]
+            cache.delete(all_cache_key(kind))
           end
         end
 
@@ -115,13 +117,14 @@ module LaunchDarkly
         def initialized?
           return true if @inited.value
 
-          if @cache.nil?
+          cache = @cache
+          if cache.nil?
             result = @core.initialized_internal?
           else
-            result = @cache[inited_cache_key]
+            result = cache[inited_cache_key]
             if result.nil?
               result = @core.initialized_internal?
-              @cache[inited_cache_key] = result
+              cache[inited_cache_key] = result
             end
           end
 
@@ -129,6 +132,23 @@ module LaunchDarkly
           result
         end
 
+        #
+        # Disable the in-memory cache. Releases the cache reference so subsequent operations
+        # bypass it and go directly to the underlying core. Safe to call multiple times.
+        #
+        # Called by the FDv2 store coordinator once the in-memory store has become the
+        # source of truth and the persistent-store cache is no longer useful. Internal --
+        # not part of the public API.
+        #
+        # @return [void]
+        #
+        def disable_cache
+          cache = @cache
+          return if cache.nil?
+          @cache = nil
+          cache.clear
+        end
+
         def stop
           @core.stop
         end

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

@@ -6,9 +6,6 @@ module LaunchDarkly
       #
       # EventName represents the name of an event that can be sent by the server for FDv2.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       module EventName
         # Specifies that an object should be added to the data set with upsert semantics.
         PUT_OBJECT = :"put-object"
@@ -35,9 +32,6 @@ module LaunchDarkly
       #
       # ObjectKind represents the kind of object.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       module ObjectKind
         # Represents a feature flag.
         FLAG = "flag"
@@ -49,9 +43,6 @@ module LaunchDarkly
       #
       # ChangeType specifies if an object is being upserted or deleted.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       module ChangeType
         # Represents an object being upserted.
         PUT = "put"
@@ -63,9 +54,6 @@ module LaunchDarkly
       #
       # IntentCode represents the various intents that can be sent by the server.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       module IntentCode
         # The server intends to send a full data set.
         TRANSFER_FULL = "xfer-full"
@@ -80,9 +68,6 @@ module LaunchDarkly
       #
       # DataStoreMode represents the mode of operation of a Data Store in FDV2 mode.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       module DataStoreMode
         # Indicates that the data store is read-only. Data will never be written back to the store by the SDK.
         READ_ONLY = :read_only
@@ -95,9 +80,6 @@ module LaunchDarkly
       #
       # Selector represents a particular snapshot of data.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       class Selector
         # @return [String] The state
         attr_reader :state
@@ -196,9 +178,6 @@ module LaunchDarkly
       #
       # Change represents a change to a piece of data, such as an update or deletion.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       class Change
         # @return [String] The action ({ChangeType})
         attr_reader :action
@@ -234,9 +213,6 @@ module LaunchDarkly
       #
       # ChangeSet represents a list of changes to be applied.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       class ChangeSet
         # @return [String] The intent code ({IntentCode})
         attr_reader :intent_code
@@ -262,9 +238,6 @@ module LaunchDarkly
       #
       # Basis represents the initial payload of data that a data source can provide.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       class Basis
         # @return [ChangeSet] The change set
         attr_reader :change_set
@@ -290,9 +263,6 @@ module LaunchDarkly
       #
       # Payload represents a payload delivered in a streaming response.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       class Payload
         # @return [String] The payload ID
         attr_reader :id
@@ -357,9 +327,6 @@ module LaunchDarkly
       #
       # ServerIntent represents the type of change associated with the payload.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       class ServerIntent
         # @return [Payload] The payload
         attr_reader :payload
@@ -405,9 +372,6 @@ module LaunchDarkly
       #
       # ChangeSetBuilder is a helper for constructing a ChangeSet.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       class ChangeSetBuilder
         # @return [String, nil] The current intent ({IntentCode})
         attr_accessor :intent
@@ -546,9 +510,6 @@ module LaunchDarkly
       #
       # Update represents the results of a synchronizer's ongoing sync method.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       class Update
         # @return [Symbol] The data source state ({LaunchDarkly::Interfaces::DataSource::Status})
         attr_reader :state
@@ -559,8 +520,9 @@ module LaunchDarkly
         # @return [LaunchDarkly::Interfaces::DataSource::ErrorInfo, nil] Error information
         attr_reader :error
 
-        # @return [Boolean] Whether to revert to FDv1
-        attr_reader :revert_to_fdv1
+        # @return [Boolean] Whether the LaunchDarkly server has instructed the SDK to fall
+        #   back to the FDv1 protocol (signalled via the `X-LD-FD-Fallback` response header).
+        attr_reader :fallback_to_fdv1
 
         # @return [String, nil] The environment ID
         attr_reader :environment_id
@@ -569,23 +531,67 @@ module LaunchDarkly
         # @param state [Symbol] The data source state ({LaunchDarkly::Interfaces::DataSource::Status})
         # @param change_set [ChangeSet, nil] The change set
         # @param error [LaunchDarkly::Interfaces::DataSource::ErrorInfo, nil] Error information
-        # @param revert_to_fdv1 [Boolean] Whether to revert to FDv1
+        # @param fallback_to_fdv1 [Boolean] Whether to fall back to FDv1
         # @param environment_id [String, nil] The environment ID
         #
-        def initialize(state:, change_set: nil, error: nil, revert_to_fdv1: false, environment_id: nil)
+        def initialize(state:, change_set: nil, error: nil, fallback_to_fdv1: false, environment_id: nil)
           @state = state
           @change_set = change_set
           @error = error
-          @revert_to_fdv1 = revert_to_fdv1
+          @fallback_to_fdv1 = fallback_to_fdv1
           @environment_id = environment_id
         end
       end
 
       #
-      # SelectorStore represents a component capable of providing Selectors for data retrieval.
+      # FetchResult pairs the result of an {Initializer#fetch} call with the
+      # server-directed FDv1 Fallback Directive signal.
+      #
+      # When the LaunchDarkly server returns the `X-LD-FD-Fallback: true`
+      # response header on an initializer response, the SDK must apply any
+      # accompanying payload and then switch to the FDv1 Fallback Synchronizer.
+      # Surfacing this signal alongside the {LaunchDarkly::Result} ensures
+      # callers cannot silently drop it.
+      #
+      class FetchResult
+        # @return [LaunchDarkly::Result] A Result containing either a {Basis} or an error.
+        attr_reader :result
+
+        # @return [Boolean] Whether the server has instructed the SDK to fall back to the FDv1 protocol.
+        attr_reader :fallback_to_fdv1
+
+        #
+        # @param result [LaunchDarkly::Result] A Result containing either a Basis or an error.
+        # @param fallback_to_fdv1 [Boolean] Whether to fall back to FDv1.
+        #
+        def initialize(result:, fallback_to_fdv1: false)
+          @result = result
+          @fallback_to_fdv1 = fallback_to_fdv1
+        end
+
+        # @return [Boolean] true when the underlying Result was successful.
+        def success?
+          @result.success?
+        end
+
+        # @return [Object, nil] The {Basis} returned from a successful fetch, or nil.
+        def value
+          @result.value
+        end
+
+        # @return [String, nil] An error description, or nil on success.
+        def error
+          @result.error
+        end
+
+        # @return [Exception, nil] An optional exception describing the failure.
+        def exception
+          @result.exception
+        end
+      end
+
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
+      # SelectorStore represents a component capable of providing Selectors for data retrieval.
       #
       module SelectorStore
         #
@@ -601,9 +607,6 @@ module LaunchDarkly
       #
       # ReadOnlyStore represents a read-only store interface for retrieving data.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       module ReadOnlyStore
         #
         # Retrieves an item by kind and key.
@@ -639,9 +642,6 @@ module LaunchDarkly
       #
       # Initializer represents a component capable of retrieving a single data result.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       module Initializer
         #
         # Returns the name of the initializer.
@@ -655,8 +655,14 @@ module LaunchDarkly
         #
         # Retrieves the initial data set for the data source.
         #
+        # If the LaunchDarkly server has instructed the SDK to fall back to
+        # the FDv1 protocol, the returned {FetchResult#fallback_to_fdv1} is
+        # true. The wrapped result may still carry a successful {Basis} when
+        # the directive accompanied a valid payload, in which case callers
+        # should apply the payload before switching protocols.
+        #
         # @param selector_store [SelectorStore] Provides the Selector
-        # @return [LaunchDarkly::Result<Basis, String>]
+        # @return [FetchResult]
         #
         def fetch(selector_store)
           raise NotImplementedError, "#{self.class} must implement #fetch"
@@ -666,9 +672,6 @@ module LaunchDarkly
       #
       # Synchronizer represents a component capable of synchronizing data from an external source.
       #
-      # This type is not stable, and not subject to any backwards compatibility guarantees or semantic versioning.
-      # It is in early access. If you want access to this feature please join the EAP. https://launchdarkly.com/docs/sdk/features/data-saving-mode
-      #
       module Synchronizer
         #
         # Returns the name of the synchronizer.

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/util.rb

@@ -16,10 +16,11 @@ module LaunchDarkly
     # Create a successful result with the provided value.
     #
     # @param value [Object, nil]
+    # @param headers [Hash, nil] Optional headers associated with the result
     # @return [Result]
     #
-    def self.success(value)
-      Result.new(value)
+    def self.success(value, headers = nil)
+      Result.new(value, nil, nil, headers)
     end
 
     #

data/lib/ldclient-rb/version.rb

@@ -1,3 +1,3 @@
 module LaunchDarkly
-  VERSION = "8.13.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.13.0
+  version: 8.15.0
 platform: java
 authors:
 - LaunchDarkly
 bindir: bin
 cert_chain: []
-date: 2026-03-27 00:00:00.000000000 Z
+date: 2026-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-dynamodb