launchdarkly-server-sdk 8.13.0-java → 8.14.0-java

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/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.14.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.14.0
 platform: java
 authors:
 - LaunchDarkly
 bindir: bin
 cert_chain: []
-date: 2026-03-27 00:00:00.000000000 Z
+date: 2026-06-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-dynamodb