launchdarkly-server-sdk 8.12.2 → 8.12.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ee161dc0454e83d98fd98b05e4853856cabd2478958ed90543c516968165fea
-  data.tar.gz: 51086ed0c405546c21daf7c0df8bead73f57ab1951be7ba164f7fa4e50aad00a
+  metadata.gz: 57906761b3e8ac33ce67cb5fe508b930bced9dc76dc7627a11494ef30669cd31
+  data.tar.gz: 577eba2114e248f6c09e5d690d61a6213430c23a0edbef173c5ed60f4e3a0a58
 SHA512:
-  metadata.gz: 2ae14ab7c225a213a1e1e0b9af55bc8a2c5afbc323b6689456f6eaaa6236bbb2ad9e390fcb4929ea4882c0156b1799bd3c52676d3ca092ba17ed39954862339a
-  data.tar.gz: fdd3dd191f7c0ff949e4adef74aa484f89f7f15febb54eaa882f47c1301a833750f591686919c92410262c63440b98803f6c76112cced3a1035ccfa71e3c0705
+  metadata.gz: 3935eb8fbfee75a13469a4ebadf223654ac1116a8d5075948fa3f260ef35faaf0207c443b4af04f6ad1a71579db880790ea3506ec1c5591087e111c9b7659915
+  data.tar.gz: d3470ce5c0877f180aaafa35aa98cae50daef51148caeaaa8d61a9e3b3ca50770ec65a654d3fcc18f6069876eece3d51551b325ac988ba4c9fcc02f71ecc772b

data/lib/ldclient-rb/config.rb

@@ -468,7 +468,7 @@ module LaunchDarkly
     # @return [String] "https://sdk.launchdarkly.com"
     #
     def self.default_base_uri
-      Impl::DataSystem::PollingDataSourceBuilder::DEFAULT_BASE_URI
+      DataSystem::PollingDataSourceBuilder::DEFAULT_BASE_URI
     end
 
     #
@@ -476,7 +476,7 @@ module LaunchDarkly
     # @return [String] "https://stream.launchdarkly.com"
     #
     def self.default_stream_uri
-      Impl::DataSystem::StreamingDataSourceBuilder::DEFAULT_BASE_URI
+      DataSystem::StreamingDataSourceBuilder::DEFAULT_BASE_URI
     end
 
     #
@@ -516,7 +516,7 @@ module LaunchDarkly
     # @return [Float] 1
     #
     def self.default_initial_reconnect_delay
-      Impl::DataSystem::StreamingDataSourceBuilder::DEFAULT_INITIAL_RECONNECT_DELAY
+      DataSystem::StreamingDataSourceBuilder::DEFAULT_INITIAL_RECONNECT_DELAY
     end
 
     #
@@ -578,7 +578,7 @@ module LaunchDarkly
     # @return [Float] 30
     #
     def self.default_poll_interval
-      Impl::DataSystem::PollingDataSourceBuilder::DEFAULT_POLL_INTERVAL
+      DataSystem::PollingDataSourceBuilder::DEFAULT_POLL_INTERVAL
     end
 
     #

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

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require "ldclient-rb/interfaces/data_system"
+
+module LaunchDarkly
+  module DataSystem
+    #
+    # Builder for the data system configuration.
+    #
+    # This builder configures the overall data acquisition strategy for the SDK,
+    # including which data sources to use for initialization and synchronization,
+    # and how to interact with a persistent data store.
+    #
+    # @see DataSystem.default
+    # @see DataSystem.streaming
+    # @see DataSystem.polling
+    # @see DataSystem.custom
+    #
+    class ConfigBuilder
+      def initialize
+        @initializers = nil
+        @synchronizers = nil
+        @fdv1_fallback_synchronizer = nil
+        @data_store_mode = LaunchDarkly::Interfaces::DataSystem::DataStoreMode::READ_ONLY
+        @data_store = nil
+      end
+
+      #
+      # Sets the initializers for the data system.
+      #
+      # Initializers are used to fetch an initial set of data when the SDK starts.
+      # They are tried in order; if the first one fails, the next is tried, and so on.
+      #
+      # @param initializers [Array<#build(String, Config)>]
+      #   Array of builders that respond to build(sdk_key, config) and return an Initializer
+      # @return [ConfigBuilder] self for chaining
+      #
+      def initializers(initializers)
+        @initializers = initializers
+        self
+      end
+
+      #
+      # Sets the synchronizers for the data system.
+      #
+      # Synchronizers keep data up-to-date after initialization. Like initializers,
+      # they are tried in order. If the primary synchronizer fails, the next one
+      # takes over.
+      #
+      # @param synchronizers [Array<#build(String, Config)>]
+      #   Array of builders that respond to build(sdk_key, config) and return a Synchronizer
+      # @return [ConfigBuilder] self for chaining
+      #
+      def synchronizers(synchronizers)
+        @synchronizers = synchronizers
+        self
+      end
+
+      #
+      # Configures the SDK with a fallback synchronizer that is compatible with
+      # the Flag Delivery v1 API.
+      #
+      # This fallback is used when the server signals that the environment should
+      # revert to FDv1 protocol. Most users will not need to set this directly.
+      #
+      # @param fallback [#build(String, Config)] Builder that responds to build(sdk_key, config) and returns the fallback Synchronizer
+      # @return [ConfigBuilder] self for chaining
+      #
+      def fdv1_compatible_synchronizer(fallback)
+        @fdv1_fallback_synchronizer = fallback
+        self
+      end
+
+      #
+      # Sets the data store configuration for the data system.
+      #
+      # @param data_store [LaunchDarkly::Interfaces::FeatureStore] The data store
+      # @param store_mode [Symbol] The store mode (use constants from
+      #   {LaunchDarkly::Interfaces::DataSystem::DataStoreMode})
+      # @return [ConfigBuilder] self for chaining
+      #
+      def data_store(data_store, store_mode)
+        @data_store = data_store
+        @data_store_mode = store_mode
+        self
+      end
+
+      #
+      # Builds the data system configuration.
+      #
+      # @return [DataSystemConfig]
+      #
+      def build
+        DataSystemConfig.new(
+          initializers: @initializers,
+          synchronizers: @synchronizers,
+          data_store_mode: @data_store_mode,
+          data_store: @data_store,
+          fdv1_fallback_synchronizer: @fdv1_fallback_synchronizer
+        )
+      end
+    end
+  end
+end

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

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require "ldclient-rb/impl/data_system/http_config_options"
+
+module LaunchDarkly
+  module DataSystem
+    #
+    # Common HTTP configuration methods shared by all data source builders.
+    #
+    # This module is included by {PollingDataSourceBuilder},
+    # {FDv1PollingDataSourceBuilder}, and {StreamingDataSourceBuilder} to provide
+    # a consistent set of HTTP connection settings.
+    #
+    # Each builder that includes this module must define a +DEFAULT_BASE_URI+ constant
+    # which is used as the fallback when {#base_uri} has not been called.
+    #
+    module DataSourceBuilderCommon
+      #
+      # Sets the base URI for HTTP requests.
+      #
+      # Use this to point the SDK at a Relay Proxy instance or any other URI
+      # that implements the corresponding LaunchDarkly API.
+      #
+      # @param uri [String] The base URI (e.g. "https://relay.example.com")
+      # @return [self] the builder, for chaining
+      #
+      def base_uri(uri)
+        @base_uri = uri
+        self
+      end
+
+      #
+      # Sets a custom socket factory for HTTP connections.
+      #
+      # @param factory [#open] A socket factory that responds to +open+
+      # @return [self] the builder, for chaining
+      #
+      def socket_factory(factory)
+        @socket_factory = factory
+        self
+      end
+
+      #
+      # Sets the read timeout for HTTP connections.
+      #
+      # @param timeout [Float] Timeout in seconds
+      # @return [self] the builder, for chaining
+      #
+      def read_timeout(timeout)
+        @read_timeout = timeout
+        self
+      end
+
+      #
+      # Sets the connect timeout for HTTP connections.
+      #
+      # @param timeout [Float] Timeout in seconds
+      # @return [self] the builder, for chaining
+      #
+      def connect_timeout(timeout)
+        @connect_timeout = timeout
+        self
+      end
+
+      #
+      # Builds an HttpConfigOptions instance from the current builder settings.
+      # Uses +self.class::DEFAULT_BASE_URI+ if {#base_uri} was not explicitly set.
+      # Read/connect timeouts default to HttpConfigOptions defaults if not set.
+      #
+      # @return [LaunchDarkly::Impl::DataSystem::HttpConfigOptions]
+      #
+      private def build_http_config
+        LaunchDarkly::Impl::DataSystem::HttpConfigOptions.new(
+          base_uri: (@base_uri || self.class::DEFAULT_BASE_URI).chomp("/"),
+          socket_factory: @socket_factory,
+          read_timeout: @read_timeout,
+          connect_timeout: @connect_timeout
+        )
+      end
+    end
+  end
+end

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

@@ -0,0 +1,227 @@
+# frozen_string_literal: true
+
+require "ldclient-rb/data_system/data_source_builder_common"
+
+module LaunchDarkly
+  module DataSystem
+    #
+    # Interface for custom polling requesters.
+    #
+    # A Requester is responsible for fetching data from a data source. The SDK
+    # ships with built-in HTTP requesters for both FDv2 and FDv1 polling endpoints,
+    # but you can implement this interface to provide custom data fetching logic
+    # (e.g., reading from a file, a database, or a custom API).
+    #
+    # == Implementing a Custom Requester
+    #
+    # To create a custom requester, include this module and implement the {#fetch}
+    # method:
+    #
+    #   class MyCustomRequester
+    #     include LaunchDarkly::DataSystem::Requester
+    #
+    #     def fetch(selector)
+    #       # Fetch data and return a Result containing [ChangeSet, headers]
+    #       # ...
+    #       LaunchDarkly::Result.success([change_set, {}])
+    #     end
+    #
+    #     def stop
+    #       # Clean up resources
+    #     end
+    #   end
+    #
+    #   polling = LaunchDarkly::DataSystem.polling_ds_builder
+    #     .requester(MyCustomRequester.new)
+    #
+    # @see PollingDataSourceBuilder#requester
+    #
+    module Requester
+      #
+      # Fetches data for the given selector.
+      #
+      # @param selector [LaunchDarkly::Interfaces::DataSystem::Selector, nil]
+      #   The selector describing what data to fetch. May be nil if no
+      #   selector is available (e.g., on the first request).
+      # @return [LaunchDarkly::Result] A Result containing a tuple of
+      #   [ChangeSet, headers] on success, or an error message on failure.
+      #
+      def fetch(selector)
+        raise NotImplementedError
+      end
+
+      #
+      # Releases any resources held by this requester (e.g., persistent HTTP
+      # connections). Called when the requester is no longer needed.
+      #
+      # Implementations should handle being called multiple times gracefully.
+      # The default implementation is a no-op.
+      #
+      def stop
+        # Optional - implementations may override if they need cleanup
+      end
+    end
+
+    #
+    # Builder for a polling data source that communicates with LaunchDarkly's
+    # FDv2 polling endpoint.
+    #
+    # This builder can be used with {ConfigBuilder#initializers} or
+    # {ConfigBuilder#synchronizers} to create custom data system configurations.
+    #
+    # The polling data source periodically fetches data from LaunchDarkly. It
+    # supports conditional requests via ETags, so subsequent polls after the
+    # initial request only transfer data if changes have occurred.
+    #
+    # == Example
+    #
+    #   polling = LaunchDarkly::DataSystem.polling_ds_builder
+    #     .poll_interval(60)
+    #     .base_uri("https://custom-endpoint.example.com")
+    #
+    #   data_system = LaunchDarkly::DataSystem.custom
+    #     .synchronizers([polling])
+    #
+    # @see DataSystem.polling_ds_builder
+    #
+    class PollingDataSourceBuilder
+      include LaunchDarkly::DataSystem::DataSourceBuilderCommon
+
+      # @return [String] The default base URI for polling requests
+      DEFAULT_BASE_URI = "https://sdk.launchdarkly.com"
+
+      # @return [Float] The default polling interval in seconds
+      DEFAULT_POLL_INTERVAL = 30
+
+      def initialize
+        @requester = nil
+      end
+
+      #
+      # Sets the polling interval in seconds.
+      #
+      # This controls how frequently the SDK polls LaunchDarkly for updates.
+      # Lower values mean more frequent updates but higher network traffic.
+      # The default is {DEFAULT_POLL_INTERVAL} seconds.
+      #
+      # @param secs [Float] Polling interval in seconds
+      # @return [PollingDataSourceBuilder] self for chaining
+      #
+      def poll_interval(secs)
+        @poll_interval = secs
+        self
+      end
+
+      #
+      # Sets a custom {Requester} for this polling data source.
+      #
+      # By default, the builder uses an HTTP requester that communicates with
+      # LaunchDarkly's FDv2 polling endpoint. Use this method to provide a
+      # custom requester implementation for testing or non-standard environments.
+      #
+      # @param requester [Requester] A custom requester that implements the
+      #   {Requester} interface
+      # @return [PollingDataSourceBuilder] self for chaining
+      #
+      # @see Requester
+      #
+      def requester(requester)
+        @requester = requester
+        self
+      end
+
+      #
+      # Builds the polling data source with the configured parameters.
+      #
+      # This method is called internally by the SDK. You do not need to call it
+      # directly; instead, pass the builder to {ConfigBuilder#initializers} or
+      # {ConfigBuilder#synchronizers}.
+      #
+      # @param sdk_key [String] The SDK key
+      # @param config [LaunchDarkly::Config] The SDK configuration
+      # @return [LaunchDarkly::Impl::DataSystem::PollingDataSource]
+      #
+      def build(sdk_key, config)
+        http_opts = build_http_config
+        requester = @requester || LaunchDarkly::Impl::DataSystem::HTTPPollingRequester.new(sdk_key, http_opts, config)
+        LaunchDarkly::Impl::DataSystem::PollingDataSource.new(@poll_interval || DEFAULT_POLL_INTERVAL, requester, config.logger)
+      end
+    end
+
+    #
+    # Builder for a polling data source that communicates with LaunchDarkly's
+    # FDv1 (Flag Delivery v1) polling endpoint.
+    #
+    # This builder is typically used with {ConfigBuilder#fdv1_compatible_synchronizer}
+    # to provide a fallback when the server signals that the environment should
+    # revert to the FDv1 protocol.
+    #
+    # Most users will not need to interact with this builder directly, as the
+    # predefined strategies ({DataSystem.default}, {DataSystem.streaming},
+    # {DataSystem.polling}) already configure an appropriate FDv1 fallback.
+    #
+    # @see DataSystem.fdv1_fallback_ds_builder
+    #
+    class FDv1PollingDataSourceBuilder
+      include LaunchDarkly::DataSystem::DataSourceBuilderCommon
+
+      # @return [String] The default base URI for FDv1 polling requests
+      DEFAULT_BASE_URI = "https://sdk.launchdarkly.com"
+
+      # @return [Float] The default polling interval in seconds
+      DEFAULT_POLL_INTERVAL = 30
+
+      def initialize
+        @requester = nil
+      end
+
+      #
+      # Sets the polling interval in seconds.
+      #
+      # This controls how frequently the SDK polls LaunchDarkly for updates.
+      # The default is {DEFAULT_POLL_INTERVAL} seconds.
+      #
+      # @param secs [Float] Polling interval in seconds
+      # @return [FDv1PollingDataSourceBuilder] self for chaining
+      #
+      def poll_interval(secs)
+        @poll_interval = secs
+        self
+      end
+
+      #
+      # Sets a custom {Requester} for this polling data source.
+      #
+      # By default, the builder uses an HTTP requester that communicates with
+      # LaunchDarkly's FDv1 polling endpoint. Use this method to provide a
+      # custom requester implementation.
+      #
+      # @param requester [Requester] A custom requester that implements the
+      #   {Requester} interface
+      # @return [FDv1PollingDataSourceBuilder] self for chaining
+      #
+      # @see Requester
+      #
+      def requester(requester)
+        @requester = requester
+        self
+      end
+
+      #
+      # Builds the FDv1 polling data source with the configured parameters.
+      #
+      # This method is called internally by the SDK. You do not need to call it
+      # directly; instead, pass the builder to {ConfigBuilder#fdv1_compatible_synchronizer}.
+      #
+      # @param sdk_key [String] The SDK key
+      # @param config [LaunchDarkly::Config] The SDK configuration
+      # @return [LaunchDarkly::Impl::DataSystem::PollingDataSource]
+      #
+      def build(sdk_key, config)
+        http_opts = build_http_config
+        requester = @requester || LaunchDarkly::Impl::DataSystem::HTTPFDv1PollingRequester.new(sdk_key, http_opts, config)
+        LaunchDarkly::Impl::DataSystem::PollingDataSource.new(@poll_interval || DEFAULT_POLL_INTERVAL, requester, config.logger)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require "ldclient-rb/data_system/data_source_builder_common"
+
+module LaunchDarkly
+  module DataSystem
+    #
+    # Builder for a streaming data source that uses Server-Sent Events (SSE)
+    # to receive real-time updates from LaunchDarkly's Flag Delivery services.
+    #
+    # This builder can be used with {ConfigBuilder#synchronizers} to create
+    # custom data system configurations. Streaming provides the lowest latency
+    # for flag updates compared to polling.
+    #
+    # == Example
+    #
+    #   streaming = LaunchDarkly::DataSystem.streaming_ds_builder
+    #     .initial_reconnect_delay(2)
+    #     .base_uri("https://custom-stream.example.com")
+    #
+    #   data_system = LaunchDarkly::DataSystem.custom
+    #     .synchronizers([streaming])
+    #
+    # @see DataSystem.streaming_ds_builder
+    #
+    class StreamingDataSourceBuilder
+      include LaunchDarkly::DataSystem::DataSourceBuilderCommon
+
+      # @return [String] The default base URI for streaming connections
+      DEFAULT_BASE_URI = "https://stream.launchdarkly.com"
+
+      # @return [Float] The default initial reconnect delay in seconds
+      DEFAULT_INITIAL_RECONNECT_DELAY = 1
+
+      def initialize
+        # No initialization needed - defaults applied in build via nil-check
+      end
+
+      #
+      # Sets the initial delay before reconnecting after a stream connection error.
+      #
+      # The SDK uses an exponential backoff strategy starting from this delay.
+      # The default is {DEFAULT_INITIAL_RECONNECT_DELAY} second.
+      #
+      # @param delay [Float] Delay in seconds
+      # @return [StreamingDataSourceBuilder] self for chaining
+      #
+      def initial_reconnect_delay(delay)
+        @initial_reconnect_delay = delay
+        self
+      end
+
+      #
+      # Builds the streaming data source with the configured parameters.
+      #
+      # This method is called internally by the SDK. You do not need to call it
+      # directly; instead, pass the builder to {ConfigBuilder#synchronizers}.
+      #
+      # @param sdk_key [String] The SDK key
+      # @param config [LaunchDarkly::Config] The SDK configuration
+      # @return [LaunchDarkly::Impl::DataSystem::StreamingDataSource]
+      #
+      def build(sdk_key, config)
+        http_opts = build_http_config
+        LaunchDarkly::Impl::DataSystem::StreamingDataSource.new(
+          sdk_key, http_opts,
+          @initial_reconnect_delay || DEFAULT_INITIAL_RECONNECT_DELAY,
+          config
+        )
+      end
+    end
+  end
+end

data/lib/ldclient-rb/data_system.rb

@@ -4,100 +4,66 @@ require 'ldclient-rb/interfaces/data_system'
 require 'ldclient-rb/config'
 require 'ldclient-rb/impl/data_system/polling'
 require 'ldclient-rb/impl/data_system/streaming'
+require 'ldclient-rb/data_system/config_builder'
+require 'ldclient-rb/data_system/polling_data_source_builder'
+require 'ldclient-rb/data_system/streaming_data_source_builder'
 
 module LaunchDarkly
   #
   # Configuration for LaunchDarkly's data acquisition strategy.
   #
-  # This module provides factory methods for creating data system configurations.
+  # This module provides factory methods for creating data system configurations,
+  # as well as builder classes for constructing individual data sources (polling
+  # and streaming).
+  #
+  # == Quick Start
+  #
+  # For most users, the predefined strategies are sufficient:
+  #
+  #   # Use the default strategy (recommended)
+  #   config = LaunchDarkly::Config.new(
+  #     data_system: LaunchDarkly::DataSystem.default
+  #   )
+  #
+  #   # Use streaming only
+  #   config = LaunchDarkly::Config.new(
+  #     data_system: LaunchDarkly::DataSystem.streaming
+  #   )
+  #
+  #   # Use polling only
+  #   config = LaunchDarkly::Config.new(
+  #     data_system: LaunchDarkly::DataSystem.polling
+  #   )
+  #
+  # == Custom Configurations
+  #
+  # For advanced use cases, you can build custom configurations using the
+  # data source builders:
+  #
+  #   polling = LaunchDarkly::DataSystem.polling_ds_builder
+  #     .poll_interval(60)
+  #     .base_uri("https://custom-polling.example.com")
+  #
+  #   streaming = LaunchDarkly::DataSystem.streaming_ds_builder
+  #     .initial_reconnect_delay(2)
+  #     .base_uri("https://custom-streaming.example.com")
+  #
+  #   data_system = LaunchDarkly::DataSystem.custom
+  #     .initializers([polling])
+  #     .synchronizers([streaming, polling])
+  #
+  #   config = LaunchDarkly::Config.new(data_system: data_system)
   #
   module DataSystem
-    #
-    # Builder for the data system configuration.
-    #
-    class ConfigBuilder
-      def initialize
-        @initializers = nil
-        @synchronizers = nil
-        @fdv1_fallback_synchronizer = nil
-        @data_store_mode = LaunchDarkly::Interfaces::DataSystem::DataStoreMode::READ_ONLY
-        @data_store = nil
-      end
-
-      #
-      # Sets the initializers for the data system.
-      #
-      # @param initializers [Array<#build(String, Config)>]
-      #   Array of builders that respond to build(sdk_key, config) and return an Initializer
-      # @return [ConfigBuilder] self for chaining
-      #
-      def initializers(initializers)
-        @initializers = initializers
-        self
-      end
-
-      #
-      # Sets the synchronizers for the data system.
-      #
-      # @param synchronizers [Array<#build(String, Config)>]
-      #   Array of builders that respond to build(sdk_key, config) and return a Synchronizer
-      # @return [ConfigBuilder] self for chaining
-      #
-      def synchronizers(synchronizers)
-        @synchronizers = synchronizers
-        self
-      end
-
-      #
-      # Configures the SDK with a fallback synchronizer that is compatible with
-      # the Flag Delivery v1 API.
-      #
-      # @param fallback [#build(String, Config)] Builder that responds to build(sdk_key, config) and returns the fallback Synchronizer
-      # @return [ConfigBuilder] self for chaining
-      #
-      def fdv1_compatible_synchronizer(fallback)
-        @fdv1_fallback_synchronizer = fallback
-        self
-      end
-
-      #
-      # Sets the data store configuration for the data system.
-      #
-      # @param data_store [LaunchDarkly::Interfaces::FeatureStore] The data store
-      # @param store_mode [Symbol] The store mode
-      # @return [ConfigBuilder] self for chaining
-      #
-      def data_store(data_store, store_mode)
-        @data_store = data_store
-        @data_store_mode = store_mode
-        self
-      end
-
-      #
-      # Builds the data system configuration.
-      #
-      # @return [DataSystemConfig]
-      #
-      def build
-        DataSystemConfig.new(
-          initializers: @initializers,
-          synchronizers: @synchronizers,
-          data_store_mode: @data_store_mode,
-          data_store: @data_store,
-          fdv1_fallback_synchronizer: @fdv1_fallback_synchronizer
-        )
-      end
-    end
-
     #
     # Returns a builder for creating a polling data source.
     # This is a building block that can be used with {ConfigBuilder#initializers}
     # or {ConfigBuilder#synchronizers} to create custom data system configurations.
     #
-    # @return [LaunchDarkly::Impl::DataSystem::PollingDataSourceBuilder]
+    # @return [PollingDataSourceBuilder]
     #
     def self.polling_ds_builder
-      LaunchDarkly::Impl::DataSystem::PollingDataSourceBuilder.new
+      PollingDataSourceBuilder.new
     end
 
     #
@@ -105,10 +71,10 @@ module LaunchDarkly
     # This is a building block that can be used with {ConfigBuilder#fdv1_compatible_synchronizer}
     # to provide FDv1 compatibility in custom data system configurations.
     #
-    # @return [LaunchDarkly::Impl::DataSystem::FDv1PollingDataSourceBuilder]
+    # @return [FDv1PollingDataSourceBuilder]
     #
     def self.fdv1_fallback_ds_builder
-      LaunchDarkly::Impl::DataSystem::FDv1PollingDataSourceBuilder.new
+      FDv1PollingDataSourceBuilder.new
     end
 
     #
@@ -116,10 +82,10 @@ module LaunchDarkly
     # This is a building block that can be used with {ConfigBuilder#synchronizers}
     # to create custom data system configurations.
     #
-    # @return [LaunchDarkly::Impl::DataSystem::StreamingDataSourceBuilder]
+    # @return [StreamingDataSourceBuilder]
     #
     def self.streaming_ds_builder
-      LaunchDarkly::Impl::DataSystem::StreamingDataSourceBuilder.new
+      StreamingDataSourceBuilder.new
     end
 
     #
@@ -224,4 +190,3 @@ module LaunchDarkly
     end
   end
 end
-

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

@@ -178,7 +178,7 @@ module LaunchDarkly
         private def send_change_events(affected_items)
           affected_items.each do |item|
             if item[:kind] == Impl::DataStore::FEATURES
-              @flag_change_broadcaster.broadcast(LaunchDarkly::Interfaces::FlagChange.new(item[:key]))
+              @flag_change_broadcaster.broadcast(LaunchDarkly::Interfaces::FlagChange.new(item[:key].to_s))
             end
           end
         end

data/lib/ldclient-rb/impl/data_store/in_memory_feature_store.rb

@@ -58,7 +58,7 @@ module LaunchDarkly
         #
         # Initializes the store with a full set of data, replacing any existing data.
         #
-        # @param collections [Hash<LaunchDarkly::Impl::DataStore::DataKind, Hash<String, Hash>>] Hash of data kinds to collections of items
+        # @param collections [Hash<LaunchDarkly::Impl::DataStore::DataKind, Hash<Symbol, Hash>>] Hash of data kinds to collections of items
         # @return [Boolean] true if successful, false otherwise
         #
         def set_basis(collections)
@@ -80,7 +80,7 @@ module LaunchDarkly
         #
         # Applies a delta update to the store.
         #
-        # @param collections [Hash<LaunchDarkly::Impl::DataStore::DataKind, Hash<String, Hash>>] Hash of data kinds to collections with updates
+        # @param collections [Hash<LaunchDarkly::Impl::DataStore::DataKind, Hash<Symbol, Hash>>] Hash of data kinds to collections with updates
         # @return [Boolean] true if successful, false otherwise
         #
         def apply_delta(collections)
@@ -105,7 +105,7 @@ module LaunchDarkly
         #
         # Decodes a collection of items.
         #
-        # @param collections [Hash<LaunchDarkly::Impl::DataStore::DataKind, Hash<String, Hash>>] Hash of data kinds to collections
+        # @param collections [Hash<LaunchDarkly::Impl::DataStore::DataKind, Hash<Symbol, Hash>>] Hash of data kinds to collections
         # @return [Hash<LaunchDarkly::Impl::DataStore::DataKind, Hash<Symbol, Hash>>, nil] Decoded collection with symbol keys, or nil on error
         #
         private def decode_collection(collections)

data/lib/ldclient-rb/impl/data_store/store.rb

@@ -193,7 +193,7 @@ module LaunchDarkly
         #
         # Set the basis of the store. Any existing data is discarded.
         #
-        # @param collections [Hash{Object => Hash{String => Hash}}] Hash of data kinds to collections of items
+        # @param collections [Hash{Object => Hash{Symbol => Hash}}] Hash of data kinds to collections of items
         # @param selector [LaunchDarkly::Interfaces::DataSystem::Selector, nil] The selector
         # @param persist [Boolean] Whether to persist the data
         # @return [void]
@@ -234,7 +234,7 @@ module LaunchDarkly
         #
         # Apply a delta update to the store.
         #
-        # @param collections [Hash{Object => Hash{String => Hash}}] Hash of data kinds to collections with updates
+        # @param collections [Hash{Object => Hash{Symbol => Hash}}] Hash of data kinds to collections with updates
         # @param selector [LaunchDarkly::Interfaces::DataSystem::Selector, nil] The selector
         # @param persist [Boolean] Whether to persist the changes
         # @return [void]
@@ -328,7 +328,7 @@ module LaunchDarkly
         private def send_change_events(affected_items)
           affected_items.each do |item|
             if item[:kind] == FEATURES
-              @flag_change_broadcaster.broadcast(LaunchDarkly::Interfaces::FlagChange.new(item[:key]))
+              @flag_change_broadcaster.broadcast(LaunchDarkly::Interfaces::FlagChange.new(item[:key].to_s))
             end
           end
         end
@@ -336,8 +336,8 @@ module LaunchDarkly
         #
         # Compute which items changed between old and new data sets.
         #
-        # @param old_data [Hash{DataKind => Hash{String => Hash}}] Old data hash
-        # @param new_data [Hash{DataKind => Hash{String => Hash}}] New data hash
+        # @param old_data [Hash{DataKind => Hash{Symbol => Hash}}] Old data hash
+        # @param new_data [Hash{DataKind => Hash{Symbol => Hash}}] New data hash
         # @return [Set<Hash>] Set of {kind:, key:} hashes
         #
         private def compute_changed_items_for_full_data_set(old_data, new_data)

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

@@ -4,7 +4,7 @@ require "ldclient-rb/interfaces"
 require "ldclient-rb/interfaces/data_system"
 require "ldclient-rb/impl/data_system"
 require "ldclient-rb/impl/data_system/protocolv2"
-require "ldclient-rb/impl/data_system/data_source_builder_common"
+require "ldclient-rb/data_system/polling_data_source_builder"
 require "ldclient-rb/impl/data_source/requestor"
 require "ldclient-rb/impl/util"
 require "concurrent"
@@ -21,32 +21,6 @@ module LaunchDarkly
       LD_ENVID_HEADER = "X-LD-EnvID"
       LD_FD_FALLBACK_HEADER = "X-LD-FD-Fallback"
 
-      #
-      # Requester protocol for polling data source
-      #
-      module Requester
-        #
-        # Fetches the data for the given selector.
-        # Returns a Result containing a tuple of [ChangeSet, headers],
-        # or an error if the data could not be retrieved.
-        #
-        # @param selector [LaunchDarkly::Interfaces::DataSystem::Selector, nil]
-        # @return [Result]
-        #
-        def fetch(selector)
-          raise NotImplementedError
-        end
-
-        #
-        # Closes any persistent connections and releases resources.
-        # This method should be called when the requester is no longer needed.
-        # Implementations should handle being called multiple times gracefully.
-        #
-        def stop
-          # Optional - implementations may override if they need cleanup
-        end
-      end
-
       #
       # PollingDataSource is a data source that can retrieve information from
       # LaunchDarkly either as an Initializer or as a Synchronizer.
@@ -246,7 +220,7 @@ module LaunchDarkly
       # requests to the FDv2 polling endpoint.
       #
       class HTTPPollingRequester
-        include Requester
+        include LaunchDarkly::DataSystem::Requester
 
         #
         # @param sdk_key [String]
@@ -338,7 +312,7 @@ module LaunchDarkly
       # requests to the FDv1 polling endpoint.
       #
       class HTTPFDv1PollingRequester
-        include Requester
+        include LaunchDarkly::DataSystem::Requester
 
         #
         # @param sdk_key [String]
@@ -526,103 +500,6 @@ module LaunchDarkly
         LaunchDarkly::Result.success(builder.finish(selector))
       end
 
-      #
-      # Builder for a PollingDataSource.
-      #
-      class PollingDataSourceBuilder
-        include DataSourceBuilderCommon
-
-        DEFAULT_BASE_URI = "https://sdk.launchdarkly.com"
-        DEFAULT_POLL_INTERVAL = 30
-
-        def initialize
-          @requester = nil
-        end
-
-        #
-        # Sets the polling interval in seconds.
-        #
-        # @param secs [Float] Polling interval in seconds
-        # @return [PollingDataSourceBuilder]
-        #
-        def poll_interval(secs)
-          @poll_interval = secs
-          self
-        end
-
-        #
-        # Sets a custom Requester for the PollingDataSource.
-        #
-        # @param requester [Requester]
-        # @return [PollingDataSourceBuilder]
-        #
-        def requester(requester)
-          @requester = requester
-          self
-        end
-
-        #
-        # Builds the PollingDataSource with the configured parameters.
-        #
-        # @param sdk_key [String]
-        # @param config [LaunchDarkly::Config]
-        # @return [PollingDataSource]
-        #
-        def build(sdk_key, config)
-          http_opts = build_http_config
-          requester = @requester || HTTPPollingRequester.new(sdk_key, http_opts, config)
-          PollingDataSource.new(@poll_interval || DEFAULT_POLL_INTERVAL, requester, config.logger)
-        end
-      end
-
-      #
-      # Builder for an FDv1 PollingDataSource.
-      #
-      class FDv1PollingDataSourceBuilder
-        include DataSourceBuilderCommon
-
-        DEFAULT_BASE_URI = "https://sdk.launchdarkly.com"
-        DEFAULT_POLL_INTERVAL = 30
-
-        def initialize
-          @requester = nil
-        end
-
-        #
-        # Sets the polling interval in seconds.
-        #
-        # @param secs [Float] Polling interval in seconds
-        # @return [FDv1PollingDataSourceBuilder]
-        #
-        def poll_interval(secs)
-          @poll_interval = secs
-          self
-        end
-
-        #
-        # Sets a custom Requester for the PollingDataSource.
-        #
-        # @param requester [Requester]
-        # @return [FDv1PollingDataSourceBuilder]
-        #
-        def requester(requester)
-          @requester = requester
-          self
-        end
-
-        #
-        # Builds the PollingDataSource with the configured parameters.
-        #
-        # @param sdk_key [String]
-        # @param config [LaunchDarkly::Config]
-        # @return [PollingDataSource]
-        #
-        def build(sdk_key, config)
-          http_opts = build_http_config
-          requester = @requester || HTTPFDv1PollingRequester.new(sdk_key, http_opts, config)
-          PollingDataSource.new(@poll_interval || DEFAULT_POLL_INTERVAL, requester, config.logger)
-        end
-      end
     end
   end
 end

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

@@ -5,7 +5,7 @@ require "ldclient-rb/interfaces/data_system"
 require "ldclient-rb/impl/data_system"
 require "ldclient-rb/impl/data_system/protocolv2"
 require "ldclient-rb/impl/data_system/polling"  # For shared constants
-require "ldclient-rb/impl/data_system/data_source_builder_common"
+require "ldclient-rb/data_system/streaming_data_source_builder"
 require "ldclient-rb/impl/util"
 require "concurrent"
 require "json"
@@ -356,46 +356,6 @@ module LaunchDarkly
         end
       end
 
-      #
-      # Builder for a StreamingDataSource.
-      #
-      class StreamingDataSourceBuilder
-        include DataSourceBuilderCommon
-
-        DEFAULT_BASE_URI = "https://stream.launchdarkly.com"
-        DEFAULT_INITIAL_RECONNECT_DELAY = 1
-
-        def initialize
-          # No initialization needed - defaults applied in build via nil-check
-        end
-
-        #
-        # Sets the initial delay before reconnecting after an error.
-        #
-        # @param delay [Float] Delay in seconds
-        # @return [StreamingDataSourceBuilder]
-        #
-        def initial_reconnect_delay(delay)
-          @initial_reconnect_delay = delay
-          self
-        end
-
-        #
-        # Builds the StreamingDataSource with the configured parameters.
-        #
-        # @param sdk_key [String]
-        # @param config [LaunchDarkly::Config]
-        # @return [StreamingDataSource]
-        #
-        def build(sdk_key, config)
-          http_opts = build_http_config
-          StreamingDataSource.new(
-            sdk_key, http_opts,
-            @initial_reconnect_delay || DEFAULT_INITIAL_RECONNECT_DELAY,
-            config
-          )
-        end
-      end
     end
   end
 end

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

@@ -13,7 +13,7 @@ module LaunchDarkly
       # Updates the dependency graph when an item has changed.
       #
       # @param from_kind [Object] the changed item's kind
-      # @param from_key [String] the changed item's key
+      # @param from_key [Symbol] the changed item's key
       # @param from_item [Object] the changed item (can be a Hash, model object, or nil)
       #
       def update_dependencies_from(from_kind, from_key, from_item)

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

@@ -26,7 +26,7 @@ module LaunchDarkly
       # An adapter which turns a normal flag change listener into a flag value change listener.
       #
       class FlagValueChangeAdapter
-        # @param [Symbol] flag_key
+        # @param [String] flag_key
         # @param [LaunchDarkly::LDContext] context
         # @param [#update] listener
         # @param [#call] eval_fn

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

@@ -66,7 +66,7 @@ module LaunchDarkly
       # The returned listener represents the subscription that was created by this method
       # call; to unsubscribe, pass that object (not your listener) to {#remove_listener}.
       #
-      # @param key [Symbol]
+      # @param key [String]
       # @param context [LaunchDarkly::LDContext]
       # @param listener [#update]
       #
@@ -79,7 +79,7 @@ module LaunchDarkly
     class FlagChange
       attr_accessor :key
 
-      # @param [Symbol] key
+      # @param key [String]
       def initialize(key)
         @key = key
       end
@@ -93,9 +93,9 @@ module LaunchDarkly
       attr_accessor :old_value
       attr_accessor :new_value
 
-      # @param [Symbol] key
-      # @param [Object] old_value
-      # @param [Object] new_value
+      # @param key [String]
+      # @param old_value [Object]
+      # @param new_value [Object]
       def initialize(key, old_value, new_value)
         @key = key
         @old_value = old_value

data/lib/ldclient-rb/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: launchdarkly-server-sdk
 version: !ruby/object:Gem::Version
-  version: 8.12.2
+  version: 8.12.3
 platform: ruby
 authors:
 - LaunchDarkly
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-02 00:00:00.000000000 Z
+date: 2026-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-dynamodb
@@ -370,6 +370,10 @@ files:
 - lib/ldclient-rb/config.rb
 - lib/ldclient-rb/context.rb
 - lib/ldclient-rb/data_system.rb
+- lib/ldclient-rb/data_system/config_builder.rb
+- lib/ldclient-rb/data_system/data_source_builder_common.rb
+- lib/ldclient-rb/data_system/polling_data_source_builder.rb
+- lib/ldclient-rb/data_system/streaming_data_source_builder.rb
 - lib/ldclient-rb/evaluation_detail.rb
 - lib/ldclient-rb/events.rb
 - lib/ldclient-rb/flags_state.rb
@@ -392,7 +396,6 @@ 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

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

@@ -1,77 +0,0 @@
-# frozen_string_literal: true
-
-require "ldclient-rb/impl/data_system/http_config_options"
-
-module LaunchDarkly
-  module Impl
-    module DataSystem
-      #
-      # DataSourceBuilderCommon is a mixin that provides common HTTP configuration
-      # setters for data source builders (polling and streaming).
-      #
-      # Each builder that includes this module must define a DEFAULT_BASE_URI constant.
-      #
-      module DataSourceBuilderCommon
-        #
-        # Sets the base URI for HTTP requests.
-        #
-        # @param uri [String]
-        # @return [self]
-        #
-        def base_uri(uri)
-          @base_uri = uri
-          self
-        end
-
-        #
-        # Sets a custom socket factory for HTTP connections.
-        #
-        # @param factory [Object]
-        # @return [self]
-        #
-        def socket_factory(factory)
-          @socket_factory = factory
-          self
-        end
-
-        #
-        # Sets the read timeout for HTTP connections.
-        #
-        # @param timeout [Float] Timeout in seconds
-        # @return [self]
-        #
-        def read_timeout(timeout)
-          @read_timeout = timeout
-          self
-        end
-
-        #
-        # Sets the connect timeout for HTTP connections.
-        #
-        # @param timeout [Float] Timeout in seconds
-        # @return [self]
-        #
-        def connect_timeout(timeout)
-          @connect_timeout = timeout
-          self
-        end
-
-        #
-        # Builds an HttpConfigOptions instance from the current builder settings.
-        # Uses self.class::DEFAULT_BASE_URI if base_uri was not explicitly set.
-        # Read/connect timeouts default to HttpConfigOptions defaults if not set.
-        #
-        # @return [HttpConfigOptions]
-        #
-        private def build_http_config
-          HttpConfigOptions.new(
-            base_uri: (@base_uri || self.class::DEFAULT_BASE_URI).chomp("/"),
-            socket_factory: @socket_factory,
-            read_timeout: @read_timeout,
-            connect_timeout: @connect_timeout
-          )
-        end
-      end
-    end
-  end
-end