launchdarkly-server-sdk 8.11.3-java → 8.12.0-java

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

@@ -9,11 +9,8 @@ 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 type is not stable, and not subject to any backwards
-    # compatibility guarantees or semantic versioning. It is not suitable for production usage.
-    #
-    # Do not use it.
-    # You have been warned.
+    # 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.
@@ -32,7 +29,7 @@ module LaunchDarkly
     #
     #     # config = LaunchDarkly::Config.new(
     #     #   sdk_key,
-    #     #   datasystem_config: data_config.build
+    #     #   data_system_config: data_config.build
     #     # )
     #
     #     # flags can be updated at any time:
@@ -117,12 +114,13 @@ module LaunchDarkly
         instances_copy = []
         new_flag = nil
         @lock.with_write_lock do
-          old_flag = @current_flags[flag_builder._key]
+          flag_key = flag_builder._key.to_sym
+          old_flag = @current_flags[flag_key]
           old_version = old_flag ? old_flag[:version] : 0
 
           new_flag = flag_builder.build(old_version + 1)
 
-          @current_flags[flag_builder._key] = new_flag
+          @current_flags[flag_key] = new_flag
           @flag_builders[flag_builder._key] = flag_builder.clone
 
           # Create a copy of instances while holding the lock to avoid race conditions
@@ -200,7 +198,7 @@ module LaunchDarkly
           else
             segment.as_json
           end
-          segment_key = segment_hash[:key]
+          segment_key = segment_hash[:key].to_sym
 
           old_segment = @current_segments[segment_key]
           old_version = old_segment ? old_segment[:version] : 0
@@ -222,25 +220,33 @@ module LaunchDarkly
       end
 
       #
-      # Creates an initializer that can be used with the FDv2 data system.
+      # Returns a builder for creating a data source that can be used with the FDv2 data system
+      # as either an initializer or synchronizer.
       #
-      # @param sdk_key [String] the SDK key
-      # @param config [LaunchDarkly::Config] the SDK configuration
-      # @return [LaunchDarkly::Impl::Integrations::TestData::TestDataSourceV2] a test data initializer
+      # @return [TestDataV2Builder] a builder for a test data source
       #
-      def build_initializer(sdk_key, config)
-        LaunchDarkly::Impl::Integrations::TestData::TestDataSourceV2.new(self)
+      def test_data_ds_builder
+        TestDataV2Builder.new(self)
+      end
+    end
+
+    #
+    # Builder for TestDataV2 data sources (works for both initializers and synchronizers).
+    #
+    class TestDataV2Builder
+      def initialize(test_data)
+        @test_data = test_data
       end
 
       #
-      # Creates a synchronizer that can be used with the FDv2 data system.
+      # Builds the data source.
       #
-      # @param sdk_key [String] the SDK key
-      # @param config [LaunchDarkly::Config] the SDK configuration
-      # @return [LaunchDarkly::Impl::Integrations::TestData::TestDataSourceV2] a test data synchronizer
+      # @param sdk_key [String] the SDK key (unused, for interface compatibility)
+      # @param config [LaunchDarkly::Config] the SDK configuration (unused, for interface compatibility)
+      # @return [LaunchDarkly::Impl::Integrations::TestData::TestDataSourceV2] a test data source
       #
-      def build_synchronizer(sdk_key, config)
-        LaunchDarkly::Impl::Integrations::TestData::TestDataSourceV2.new(self)
+      def build(sdk_key, config)
+        LaunchDarkly::Impl::Integrations::TestData::TestDataSourceV2.new(@test_data)
       end
     end
   end

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

@@ -6,43 +6,37 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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"
+        PUT_OBJECT = :"put-object"
 
         # Specifies that an object should be removed from the data set.
-        DELETE_OBJECT = "delete-object"
+        DELETE_OBJECT = :"delete-object"
 
         # Specifies the server's intent.
-        SERVER_INTENT = "server-intent"
+        SERVER_INTENT = :"server-intent"
 
         # Specifies that all data required to bring the existing data set to a new version has been transferred.
-        PAYLOAD_TRANSFERRED = "payload-transferred"
+        PAYLOAD_TRANSFERRED = :"payload-transferred"
 
         # Keeps the connection alive.
-        HEARTBEAT = "heart-beat"
+        HEARTBEAT = :"heart-beat"
 
         # Specifies that the server is about to close the connection.
-        GOODBYE = "goodbye"
+        GOODBYE = :goodbye
 
         # Specifies that an error occurred while serving the connection.
-        ERROR = "error"
+        ERROR = :error
       end
 
       #
       # ObjectKind represents the kind of object.
       #
-      # This type is not stable, and not subject to any backwards
-      # compatibility guarantees or semantic versioning. It is not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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.
@@ -55,11 +49,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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.
@@ -72,11 +63,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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.
@@ -92,11 +80,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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.
@@ -110,11 +95,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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
@@ -153,7 +135,7 @@ module LaunchDarkly
         #
         # Returns the event name for payload transfer.
         #
-        # @return [String]
+        # @return [Symbol]
         #
         def name
           EventName::PAYLOAD_TRANSFERRED
@@ -214,11 +196,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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})
@@ -227,7 +206,7 @@ module LaunchDarkly
         # @return [String] The kind ({ObjectKind})
         attr_reader :kind
 
-        # @return [String] The key
+        # @return [Symbol] The key
         attr_reader :key
 
         # @return [Integer] The version
@@ -239,7 +218,7 @@ module LaunchDarkly
         #
         # @param action [String] The action type ({ChangeType})
         # @param kind [String] The object kind ({ObjectKind})
-        # @param key [String] The key
+        # @param key [Symbol] The key
         # @param version [Integer] The version
         # @param object [Hash, nil] The object data
         #
@@ -255,11 +234,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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})
@@ -286,11 +262,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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
@@ -317,11 +290,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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
@@ -387,11 +357,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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
@@ -438,11 +405,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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})
@@ -546,7 +510,7 @@ module LaunchDarkly
         # Adds a new object to the changeset.
         #
         # @param kind [String] The object kind ({ObjectKind})
-        # @param key [String] The key
+        # @param key [Symbol] The key
         # @param version [Integer] The version
         # @param obj [Hash] The object data
         # @return [void]
@@ -565,7 +529,7 @@ module LaunchDarkly
         # Adds a deletion to the changeset.
         #
         # @param kind [String] The object kind ({ObjectKind})
-        # @param key [String] The key
+        # @param key [Symbol] The key
         # @param version [Integer] The version
         # @return [void]
         #
@@ -582,11 +546,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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})
@@ -623,11 +584,8 @@ module LaunchDarkly
       #
       # SelectorStore represents a component capable of providing Selectors for data retrieval.
       #
-      # This type is not stable, and not subject to any backwards
-      # compatibility guarantees or semantic versioning. It is not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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 SelectorStore
         #
@@ -643,11 +601,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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
         #
@@ -684,11 +639,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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
         #
@@ -714,11 +666,8 @@ 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 not suitable for production usage.
-      #
-      # Do not use it.
-      # You have been warned.
+      # 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
         #

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
       #

data/lib/ldclient-rb/ldclient.rb

@@ -4,6 +4,7 @@ require "ldclient-rb/impl/context"
 require "ldclient-rb/impl/data_source"
 require "ldclient-rb/impl/data_store"
 require "ldclient-rb/impl/data_system/fdv1"
+require "ldclient-rb/impl/data_system/fdv2"
 require "ldclient-rb/impl/diagnostic_events"
 require "ldclient-rb/impl/evaluation_with_hook_result"
 require "ldclient-rb/impl/evaluator"
@@ -113,9 +114,16 @@ module LaunchDarkly
 
       @hooks = Concurrent::Array.new(@config.hooks + plugin_hooks)
 
-      # Initialize the data system (FDv1 for now, will support FDv2 in the future)
-      # Note: FDv1 will update @config.feature_store to use its wrapped store
-      @data_system = Impl::DataSystem::FDv1.new(@sdk_key, @config)
+      # 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)
@@ -256,7 +264,9 @@ module LaunchDarkly
     # @return [Boolean] true if the client has been initialized
     #
     def initialized?
-      @data_system.data_availability == @data_system.target_availability
+      return true if @config.offline? || @config.use_ldd?
+
+      Impl::DataSystem::DataAvailability.at_least?(@data_system.data_availability, Impl::DataSystem::DataAvailability::CACHED)
     end
 
     #
@@ -684,8 +694,8 @@ module LaunchDarkly
         return detail, nil, context.error
       end
 
-      unless initialized?
-        if @data_system.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" }

data/lib/ldclient-rb/version.rb

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

data/lib/ldclient-rb.rb

@@ -8,6 +8,7 @@ end
 # Public APIs - these define the main interfaces users interact with
 require "ldclient-rb/config"
 require "ldclient-rb/context"
+require "ldclient-rb/data_system"
 require "ldclient-rb/flags_state"
 require "ldclient-rb/integrations"
 require "ldclient-rb/interfaces"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: launchdarkly-server-sdk
 version: !ruby/object:Gem::Version
-  version: 8.11.3
+  version: 8.12.0
 platform: java
 authors:
 - LaunchDarkly
 bindir: bin
 cert_chain: []
-date: 2026-01-20 00:00:00.000000000 Z
+date: 2026-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-dynamodb
@@ -271,14 +271,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.2.6
+        version: 2.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.2.6
+        version: 2.5.0
 - !ruby/object:Gem::Dependency
   name: observer
   requirement: !ruby/object:Gem::Requirement
@@ -397,10 +397,13 @@ files:
 - lib/ldclient-rb/impl/data_store/status_provider.rb
 - lib/ldclient-rb/impl/data_store/store.rb
 - lib/ldclient-rb/impl/data_system.rb
+- lib/ldclient-rb/impl/data_system/data_source_builder_common.rb
 - lib/ldclient-rb/impl/data_system/fdv1.rb
 - lib/ldclient-rb/impl/data_system/fdv2.rb
+- lib/ldclient-rb/impl/data_system/http_config_options.rb
 - lib/ldclient-rb/impl/data_system/polling.rb
 - lib/ldclient-rb/impl/data_system/protocolv2.rb
+- lib/ldclient-rb/impl/data_system/streaming.rb
 - lib/ldclient-rb/impl/dependency_tracker.rb
 - lib/ldclient-rb/impl/diagnostic_events.rb
 - lib/ldclient-rb/impl/evaluation_with_hook_result.rb
@@ -416,6 +419,7 @@ files:
 - lib/ldclient-rb/impl/integrations/consul_impl.rb
 - lib/ldclient-rb/impl/integrations/dynamodb_impl.rb
 - lib/ldclient-rb/impl/integrations/file_data_source.rb
+- lib/ldclient-rb/impl/integrations/file_data_source_v2.rb
 - lib/ldclient-rb/impl/integrations/redis_impl.rb
 - lib/ldclient-rb/impl/integrations/test_data/test_data_source.rb
 - lib/ldclient-rb/impl/integrations/test_data/test_data_source_v2.rb