@launchdarkly/js-client-sdk-common 1.20.0 → 1.22.0

package/dist/esm/api/datasource/FDv2ConnectionMode.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Connection modes for the FDv2 data system.
+ *
+ * This defines the full set of named connection modes available in FDv2.
+ * Each mode maps to a specific initializer/synchronizer pipeline via the
+ * mode table.
+ *
+ * @remarks
+ * The following connection modes are supported:
+ *
+ * streaming - Initializes from cache then polling. Synchronizes via streaming
+ * with polling fallback. Designed for mobile foreground and desktop use.
+ *
+ * polling - Initializes from cache. Synchronizes via polling at the configured
+ * interval.
+ *
+ * offline - Initializes from cache only. No synchronizers run. The SDK will not
+ * receive updates or send analytic/diagnostic events.
+ *
+ * one-shot - Initializes from cache, then polling, then streaming. No
+ * synchronizers run after initialization. Designed for browser SDKs where
+ * a single flag fetch at page load is sufficient.
+ *
+ * background - Initializes from cache. Synchronizes via polling at a reduced
+ * frequency (1 hour by default). Designed for mobile SDKs when the application
+ * is in the background.
+ */
+type FDv2ConnectionMode = 'streaming' | 'polling' | 'offline' | 'one-shot' | 'background';
+export default FDv2ConnectionMode;
+//# sourceMappingURL=FDv2ConnectionMode.d.ts.map

package/dist/esm/api/datasource/FDv2ConnectionMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FDv2ConnectionMode.d.ts","sourceRoot":"","sources":["../../../src/api/datasource/FDv2ConnectionMode.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,KAAK,kBAAkB,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AAE1F,eAAe,kBAAkB,CAAC"}

package/dist/esm/api/datasource/LDClientDataSystemOptions.d.ts

@@ -0,0 +1,75 @@
+import FDv2ConnectionMode from './FDv2ConnectionMode';
+/**
+ * Configuration for the FDv2 client-side data system.
+ */
+export interface LDClientDataSystemOptions {
+    /**
+     * The initial connection mode the SDK should use.
+     *
+     * If not specified, the platform SDK provides a default:
+     * - Browser: 'one-shot'
+     * - React Native: 'streaming'
+     * - Electron: 'streaming'
+     *
+     * See {@link FDv2ConnectionMode} for the available modes.
+     */
+    initialConnectionMode?: FDv2ConnectionMode;
+    /**
+     * The connection mode to use when the application transitions to the background.
+     *
+     * This is primarily used by mobile SDKs (React Native). When the application
+     * enters the background, the SDK switches to this mode. When returning to
+     * the foreground, it switches back to the foreground mode.
+     *
+     * Set to undefined or omit to disable automatic background mode switching.
+     * Set to 'background' to use the built-in background mode (polling @ 1hr).
+     * Set to 'offline' to stop all connections in the background.
+     */
+    backgroundConnectionMode?: FDv2ConnectionMode;
+    /**
+     * Controls automatic mode switching in response to platform events.
+     *
+     * - `true` — enable all automatic switching (lifecycle + network)
+     * - `false` — disable all automatic switching; the user manages modes manually
+     * - `{ lifecycle?: boolean, network?: boolean }` — granular control over
+     *   which platform events trigger automatic mode switches
+     *
+     * `lifecycle` controls foreground/background transitions (mobile) and
+     * visibility changes (browser). `network` controls pause/resume of data
+     * sources when network availability changes.
+     *
+     * Default is true for mobile SDKs, false/ignored for browser.
+     */
+    automaticModeSwitching?: boolean | AutomaticModeSwitchingConfig;
+}
+/**
+ * Granular control over which platform events trigger automatic mode switches.
+ */
+export interface AutomaticModeSwitchingConfig {
+    /**
+     * Whether to automatically switch modes in response to application lifecycle
+     * events (foreground/background on mobile, visibility changes on browser).
+     *
+     * @defaultValue true on mobile, false on browser/desktop
+     */
+    readonly lifecycle?: boolean;
+    /**
+     * Whether to automatically pause/resume data sources in response to
+     * network availability changes.
+     *
+     * @defaultValue true on mobile, false on desktop
+     */
+    readonly network?: boolean;
+}
+/**
+ * Platform-specific default configuration for the FDv2 data system.
+ */
+export interface PlatformDataSystemDefaults {
+    /** The default initial connection mode for this platform. */
+    readonly initialConnectionMode: FDv2ConnectionMode;
+    /** The default background connection mode, if any. */
+    readonly backgroundConnectionMode?: FDv2ConnectionMode;
+    /** Whether automatic mode switching is enabled by default. */
+    readonly automaticModeSwitching: boolean | AutomaticModeSwitchingConfig;
+}
+//# sourceMappingURL=LDClientDataSystemOptions.d.ts.map

package/dist/esm/api/datasource/LDClientDataSystemOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LDClientDataSystemOptions.d.ts","sourceRoot":"","sources":["../../../src/api/datasource/LDClientDataSystemOptions.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAKtD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;;OASG;IACH,qBAAqB,CAAC,EAAE,kBAAkB,CAAC;IAE3C;;;;;;;;;;OAUG;IACH,wBAAwB,CAAC,EAAE,kBAAkB,CAAC;IAE9C;;;;;;;;;;;;;OAaG;IACH,sBAAsB,CAAC,EAAE,OAAO,GAAG,4BAA4B,CAAC;CAIjE;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;IACnD,sDAAsD;IACtD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,kBAAkB,CAAC;IACvD,8DAA8D;IAC9D,QAAQ,CAAC,sBAAsB,EAAE,OAAO,GAAG,4BAA4B,CAAC;CACzE"}

package/dist/esm/api/datasource/ModeDefinition.d.ts

@@ -0,0 +1,21 @@
+import { DataSourceEntry } from './DataSourceEntry';
+/**
+ * Defines the data pipeline for a connection mode: which data sources
+ * are used during initialization and which are used for ongoing synchronization.
+ */
+export interface ModeDefinition {
+    /**
+     * Ordered list of data sources to attempt during initialization.
+     * Sources are tried in order; the first that successfully provides a full
+     * data set transitions the SDK out of the initialization phase.
+     */
+    readonly initializers: ReadonlyArray<DataSourceEntry>;
+    /**
+     * Ordered list of data sources for ongoing synchronization after
+     * initialization completes. Sources are in priority order with automatic
+     * failover to the next source if the primary fails.
+     * An empty array means no synchronization occurs (e.g., offline, one-shot).
+     */
+    readonly synchronizers: ReadonlyArray<DataSourceEntry>;
+}
+//# sourceMappingURL=ModeDefinition.d.ts.map

package/dist/esm/api/datasource/ModeDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModeDefinition.d.ts","sourceRoot":"","sources":["../../../src/api/datasource/ModeDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CACxD"}

package/dist/esm/api/datasource/ModeResolution.d.ts

@@ -0,0 +1,75 @@
+import type FDv2ConnectionMode from './FDv2ConnectionMode';
+/**
+ * The lifecycle state of the application.
+ *
+ * - `'foreground'` — The application is in the foreground (visible, active).
+ *   Browser and desktop platforms always use this value.
+ * - `'background'` — The application is in the background (not visible).
+ *   Only applicable to mobile platforms.
+ */
+type LifecycleState = 'foreground' | 'background';
+/**
+ * Input state used by the mode resolution table to determine the connection
+ * mode. The caller is responsible for computing the effective `foregroundMode`
+ * before consulting the table — for example, browser listener-driven streaming
+ * logic modifies `foregroundMode` externally.
+ */
+export interface ModeState {
+    /** Application lifecycle state. */
+    readonly lifecycle: LifecycleState;
+    /** Whether the device has network connectivity. */
+    readonly networkAvailable: boolean;
+    /**
+     * The effective foreground connection mode. This is the mode the SDK should
+     * use when in the foreground and online. The caller computes this from
+     * user configuration, platform defaults, and any platform-specific logic
+     * (e.g., browser listener-driven streaming promotion).
+     */
+    readonly foregroundMode: FDv2ConnectionMode;
+    /**
+     * The effective background connection mode. This is the mode the SDK should
+     * use when in the background and online. Only meaningful on mobile platforms.
+     */
+    readonly backgroundMode: FDv2ConnectionMode;
+}
+/**
+ * A reference to a configured mode slot in the {@link ModeState}. Used in
+ * table entries to defer the mode decision to the caller's configuration.
+ *
+ * - `{ configured: 'foreground' }` — Resolve to `input.foregroundMode`.
+ * - `{ configured: 'background' }` — Resolve to `input.backgroundMode`.
+ */
+export interface ConfiguredMode {
+    readonly configured: 'foreground' | 'background';
+}
+/**
+ * The result of a mode resolution entry. Either:
+ * - A literal {@link FDv2ConnectionMode} string (e.g., `'offline'`).
+ * - A {@link ConfiguredMode} object referencing a configured mode slot.
+ */
+type ModeResolution = FDv2ConnectionMode | ConfiguredMode;
+/**
+ * A single entry in a mode resolution table. Entries are evaluated in order;
+ * the first entry whose conditions all match the input state determines the
+ * connection mode.
+ */
+export interface ModeResolutionEntry {
+    /**
+     * Conditions to match against the input state. All specified fields must
+     * match for this entry to apply. Unspecified fields match any value. An
+     * empty object matches all inputs (catch-all).
+     */
+    readonly conditions: Partial<ModeState>;
+    /**
+     * The mode to resolve to when this entry matches.
+     */
+    readonly mode: ModeResolution;
+}
+/**
+ * An ordered list of mode resolution entries. The first matching entry
+ * determines the connection mode. Tables should end with a catch-all
+ * entry (empty conditions) to guarantee a match.
+ */
+type ModeResolutionTable = ReadonlyArray<ModeResolutionEntry>;
+export type { LifecycleState, ModeResolution, ModeResolutionTable };
+//# sourceMappingURL=ModeResolution.d.ts.map

package/dist/esm/api/datasource/ModeResolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModeResolution.d.ts","sourceRoot":"","sources":["../../../src/api/datasource/ModeResolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,kBAAkB,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;GAOG;AACH,KAAK,cAAc,GAAG,YAAY,GAAG,YAAY,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IAEnC,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEnC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,YAAY,GAAG,YAAY,CAAC;CAClD;AAED;;;;GAIG;AACH,KAAK,cAAc,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CAC/B;AAED;;;;GAIG;AACH,KAAK,mBAAmB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;AAE9D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/esm/api/datasource/index.d.ts

@@ -0,0 +1,6 @@
+export type { default as FDv2ConnectionMode } from './FDv2ConnectionMode';
+export type { EndpointConfig, CacheDataSourceEntry, PollingDataSourceEntry, StreamingDataSourceEntry, DataSourceEntry, } from './DataSourceEntry';
+export type { ModeDefinition } from './ModeDefinition';
+export type { LDClientDataSystemOptions, AutomaticModeSwitchingConfig, PlatformDataSystemDefaults, } from './LDClientDataSystemOptions';
+export type { LifecycleState, ModeState, ConfiguredMode, ModeResolution, ModeResolutionEntry, ModeResolutionTable, } from './ModeResolution';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/api/datasource/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/datasource/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EACV,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/esm/api/index.d.ts

@@ -10,4 +10,5 @@ export * from './LDIdentifyResult';
 export * from './LDPlugin';
 export * from './LDWaitForInitialization';
 export * from './LDContext';
+export * from './datasource';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/esm/configuration/Configuration.d.ts

@@ -1,15 +1,18 @@
 import { ApplicationTags, internal, LDFlagSet, LDLogger, LDPluginEnvironmentMetadata, ServiceEndpoints } from '@launchdarkly/js-sdk-common';
 import { Hook, type LDOptions } from '../api';
+import type { LDClientDataSystemOptions, PlatformDataSystemDefaults } from '../api/datasource/LDClientDataSystemOptions';
 import { LDInspection } from '../api/LDInspection';
 export interface LDClientInternalOptions extends internal.LDInternalOptions {
     trackEventModifier?: (event: internal.InputCustomEvent) => internal.InputCustomEvent;
     getImplementationHooks: (environmentMetadata: LDPluginEnvironmentMetadata) => Hook[];
     credentialType: 'clientSideId' | 'mobileKey';
     getLegacyStorageKeys?: () => string[];
+    dataSystemDefaults?: PlatformDataSystemDefaults;
 }
 export interface Configuration {
     readonly logger: LDLogger;
     readonly maxCachedContexts: number;
+    readonly disableCache?: boolean;
     readonly capacity: number;
     readonly diagnosticRecordingInterval: number;
     readonly flushInterval: number;
@@ -43,6 +46,7 @@ export interface Configuration {
     readonly inspectors: LDInspection[];
     readonly credentialType: 'clientSideId' | 'mobileKey';
     readonly getImplementationHooks: (environmentMetadata: LDPluginEnvironmentMetadata) => Hook[];
+    readonly dataSystem?: LDClientDataSystemOptions;
 }
 declare const DEFAULT_POLLING: string;
 declare const DEFAULT_STREAM: string;
@@ -53,6 +57,7 @@ export default class ConfigurationImpl implements Configuration {
     private readonly eventsUri;
     private readonly streamUri;
     readonly maxCachedContexts = 5;
+    readonly disableCache: boolean;
     readonly capacity = 100;
     readonly diagnosticRecordingInterval = 900;
     readonly flushInterval = 30;
@@ -86,8 +91,8 @@ export default class ConfigurationImpl implements Configuration {
     readonly trackEventModifier: (event: internal.InputCustomEvent) => internal.InputCustomEvent;
     readonly credentialType: 'clientSideId' | 'mobileKey';
     readonly getImplementationHooks: (environmentMetadata: LDPluginEnvironmentMetadata) => Hook[];
+    readonly dataSystem?: LDClientDataSystemOptions;
     [index: string]: any;
     constructor(pristineOptions?: LDOptions, internalOptions?: LDClientInternalOptions);
-    private _validateTypesAndNames;
 }
 //# sourceMappingURL=Configuration.d.ts.map

package/dist/esm/configuration/Configuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Configuration.d.ts","sourceRoot":"","sources":["../../src/configuration/Configuration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Configuration.d.ts","sourceRoot":"","sources":["../../src/configuration/Configuration.ts"],"names":[],"mappings":"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"}

package/dist/esm/configuration/validateOptions.d.ts

@@ -0,0 +1,95 @@
+import { LDLogger, TypeValidator } from '@launchdarkly/js-sdk-common';
+/**
+ * A validator that performs structured validation on compound values
+ * (objects, arrays, records, or union types). Returns the validated value
+ * on success, or undefined to preserve the default.
+ *
+ * @param defaults - The current default value for this field, passed from
+ *   `validateOptions` so nested defaults propagate without hand-written wrappers.
+ */
+export interface CompoundValidator extends TypeValidator {
+    validate(value: unknown, name: string, logger?: LDLogger, defaults?: unknown): {
+        value: unknown;
+    } | undefined;
+}
+/**
+ * Validates an options object against a map of validators and defaults.
+ *
+ * If `input` is null, undefined, or not an object the defaults are returned
+ * (with a warning for non-nullish non-objects).
+ *
+ * Supports special validator types created by:
+ * - {@link validatorOf}: recursively validates nested objects
+ * - {@link arrayOf}: validates arrays with per-item validation
+ * - {@link anyOf}: accepts the first matching validator from a list
+ * - {@link recordOf}: validates objects with dynamic keys
+ */
+export default function validateOptions(input: unknown, validatorMap: Record<string, TypeValidator>, defaults: Record<string, unknown>, logger?: LDLogger, prefix?: string): Record<string, unknown>;
+/**
+ * Creates a validator for nested objects. When used in a validator map,
+ * `validateOptions` will recursively validate the nested object's properties.
+ * Defaults for nested fields are passed through from the parent.
+ */
+export declare function validatorOf(validators: Record<string, TypeValidator>, builtInDefaults?: Record<string, unknown>): CompoundValidator;
+/**
+ * Creates a validator for arrays of discriminated objects. Each item in the
+ * array must be an object containing a `discriminant` field whose value
+ * selects which validator map to apply. The valid discriminant values are
+ * the keys of `validatorsByType`. Items that are not objects, or whose
+ * discriminant value is missing or unrecognized, are filtered out with a
+ * warning.
+ *
+ * @param discriminant - The field name used to determine each item's type.
+ * @param validatorsByType - A mapping from discriminant values to the
+ *   validator maps used to validate items of that type. Each validator map
+ *   should include a validator for the discriminant field itself.
+ *
+ * @example
+ * ```ts
+ * // Validates an array like:
+ * //   [{ type: 'polling', pollInterval: 60 }, { type: 'cache' }]
+ *
+ * const validator = arrayOf('type', {
+ *   cache: { type: TypeValidators.String },
+ *   polling: { type: TypeValidators.String, pollInterval: TypeValidators.numberWithMin(30) },
+ *   streaming: { type: TypeValidators.String, initialReconnectDelay: TypeValidators.numberWithMin(1) },
+ * });
+ * ```
+ */
+export declare function arrayOf(discriminant: string, validatorsByType: Record<string, Record<string, TypeValidator>>): CompoundValidator;
+/**
+ * Creates a validator that tries each provided validator in order and uses the
+ * first one whose `is()` check passes. For compound validators the value is
+ * processed through `validate()`; for simple validators the value is accepted
+ * as-is. If no validator matches, a warning is logged and the default is
+ * preserved.
+ *
+ * @example
+ * ```ts
+ * // Accepts either a boolean or a nested object with specific fields:
+ * anyOf(TypeValidators.Boolean, validatorOf({ lifecycle: TypeValidators.Boolean }))
+ * ```
+ */
+export declare function anyOf(...validators: TypeValidator[]): CompoundValidator;
+/**
+ * Creates a validator for objects with dynamic keys. Each key in the input
+ * object is checked against `keyValidator`; unrecognized keys produce a
+ * warning. Each value is validated by `valueValidator`. Defaults for
+ * individual entries are passed through from the parent so partial overrides
+ * preserve non-overridden entries.
+ *
+ * @param keyValidator - Validates that each key is an allowed value.
+ * @param valueValidator - Validates each value in the record.
+ *
+ * @example
+ * ```ts
+ * // Validates a record like { streaming: { ... }, polling: { ... } }
+ * // where keys must be valid connection modes:
+ * recordOf(
+ *   TypeValidators.oneOf('streaming', 'polling', 'offline'),
+ *   validatorOf({ initializers: arrayValidator, synchronizers: arrayValidator }),
+ * )
+ * ```
+ */
+export declare function recordOf(keyValidator: TypeValidator, valueValidator: TypeValidator): CompoundValidator;
+//# sourceMappingURL=validateOptions.d.ts.map

package/dist/esm/configuration/validateOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateOptions.d.ts","sourceRoot":"","sources":["../../src/configuration/validateOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAGR,aAAa,EAEd,MAAM,6BAA6B,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,QAAQ,CACN,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,QAAQ,EACjB,QAAQ,CAAC,EAAE,OAAO,GACjB;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;CACnC;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CACrC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,CAAC,EAAE,QAAQ,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0DzB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACzC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,iBAAiB,CAsBnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CACrB,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,GAC9D,iBAAiB,CAuCnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,GAAG,UAAU,EAAE,aAAa,EAAE,GAAG,iBAAiB,CAevE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CACtB,YAAY,EAAE,aAAa,EAC3B,cAAc,EAAE,aAAa,GAC5B,iBAAiB,CAkCnB"}

package/dist/esm/configuration/validators.d.ts

@@ -1,5 +1,8 @@
 import { TypeValidator } from '@launchdarkly/js-sdk-common';
 import { type LDOptions } from '../api';
-declare const validators: Record<keyof LDOptions, TypeValidator>;
-export default validators;
+import type { PlatformDataSystemDefaults } from '../api/datasource/LDClientDataSystemOptions';
+export interface ValidatorOptions {
+    dataSystemDefaults?: PlatformDataSystemDefaults;
+}
+export default function createValidators(options?: ValidatorOptions): Record<keyof LDOptions, TypeValidator>;
 //# sourceMappingURL=validators.d.ts.map

package/dist/esm/configuration/validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/configuration/validators.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAkB,MAAM,6BAA6B,CAAC;AAE5E,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,QAAA,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,SAAS,EAAE,aAAa,CAgCtD,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/configuration/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,6BAA6B,CAAC;AAE5E,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAI9F,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,CAAC,EAAE,0BAA0B,CAAC;CACjD;AAED,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,OAAO,CAAC,EAAE,gBAAgB,GACzB,MAAM,CAAC,MAAM,SAAS,EAAE,aAAa,CAAC,CAyCxC"}

package/dist/esm/datasource/ConnectionModeConfig.d.ts

@@ -0,0 +1,19 @@
+import type { FDv2ConnectionMode, ModeDefinition } from '../api/datasource';
+/**
+ * A read-only mapping from each FDv2ConnectionMode to its ModeDefinition.
+ */
+type ModeTable = {
+    readonly [K in FDv2ConnectionMode]: ModeDefinition;
+};
+declare const BACKGROUND_POLL_INTERVAL_SECONDS = 3600;
+declare const connectionModeValidator: import("@launchdarkly/js-sdk-common").OneOf;
+declare const modeDefinitionValidators: {
+    initializers: import("../configuration/validateOptions").CompoundValidator;
+    synchronizers: import("../configuration/validateOptions").CompoundValidator;
+};
+declare const MODE_DEFINITION_DEFAULTS: Record<string, unknown>;
+declare const connectionModesValidator: import("../configuration/validateOptions").CompoundValidator;
+declare const MODE_TABLE: ModeTable;
+export type { ModeTable };
+export { MODE_TABLE, MODE_DEFINITION_DEFAULTS, BACKGROUND_POLL_INTERVAL_SECONDS, connectionModeValidator, modeDefinitionValidators, connectionModesValidator, };
+//# sourceMappingURL=ConnectionModeConfig.d.ts.map

package/dist/esm/datasource/ConnectionModeConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionModeConfig.d.ts","sourceRoot":"","sources":["../../src/datasource/ConnectionModeConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAG5E;;GAEG;AACH,KAAK,SAAS,GAAG;IACf,QAAQ,EAAE,CAAC,IAAI,kBAAkB,GAAG,cAAc;CACnD,CAAC;AAEF,QAAA,MAAM,gCAAgC,OAAO,CAAC;AAG9C,QAAA,MAAM,uBAAuB,6CAM5B,CAAC;AA6BF,QAAA,MAAM,wBAAwB;;;CAG7B,CAAC;AAEF,QAAA,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAGrD,CAAC;AAEF,QAAA,MAAM,wBAAwB,8DAG7B,CAAC;AAEF,QAAA,MAAM,UAAU,EAAE,SAqBjB,CAAC;AAEF,YAAY,EAAE,SAAS,EAAE,CAAC;AAC1B,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,gCAAgC,EAChC,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,GACzB,CAAC"}

package/dist/esm/datasource/LDClientDataSystemOptions.d.ts

@@ -0,0 +1,20 @@
+import type { PlatformDataSystemDefaults } from '../api/datasource';
+declare const dataSystemValidators: {
+    initialConnectionMode: import("@launchdarkly/js-sdk-common").OneOf;
+    backgroundConnectionMode: import("@launchdarkly/js-sdk-common").OneOf;
+    automaticModeSwitching: import("../configuration/validateOptions").CompoundValidator;
+};
+/**
+ * Default FDv2 data system configuration for browser SDKs.
+ */
+declare const BROWSER_DATA_SYSTEM_DEFAULTS: PlatformDataSystemDefaults;
+/**
+ * Default FDv2 data system configuration for mobile (React Native) SDKs.
+ */
+declare const MOBILE_DATA_SYSTEM_DEFAULTS: PlatformDataSystemDefaults;
+/**
+ * Default FDv2 data system configuration for desktop SDKs (Electron, etc.).
+ */
+declare const DESKTOP_DATA_SYSTEM_DEFAULTS: PlatformDataSystemDefaults;
+export { dataSystemValidators, BROWSER_DATA_SYSTEM_DEFAULTS, MOBILE_DATA_SYSTEM_DEFAULTS, DESKTOP_DATA_SYSTEM_DEFAULTS, };
+//# sourceMappingURL=LDClientDataSystemOptions.d.ts.map

package/dist/esm/datasource/LDClientDataSystemOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LDClientDataSystemOptions.d.ts","sourceRoot":"","sources":["../../src/datasource/LDClientDataSystemOptions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AASpE,QAAA,MAAM,oBAAoB;;;;CAIzB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,4BAA4B,EAAE,0BAInC,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,2BAA2B,EAAE,0BAIlC,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,4BAA4B,EAAE,0BAInC,CAAC;AAEF,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,GAC7B,CAAC"}

package/dist/esm/datasource/ModeResolver.d.ts

@@ -0,0 +1,30 @@
+import type { FDv2ConnectionMode, ModeResolutionTable, ModeState } from '../api/datasource';
+declare function resolveConnectionMode(table: ModeResolutionTable, input: ModeState): FDv2ConnectionMode;
+/**
+ * Mode resolution table for mobile platforms (React Native, etc.).
+ *
+ * - No network → offline.
+ * - Background → configured background mode.
+ * - Foreground → configured foreground mode.
+ */
+declare const MOBILE_TRANSITION_TABLE: ModeResolutionTable;
+/**
+ * Mode resolution table for browser platforms.
+ *
+ * - No network → offline.
+ * - Otherwise → configured foreground mode.
+ *
+ * Browser listener-driven streaming (auto-promotion to streaming when change
+ * listeners are registered) is handled externally by the caller modifying
+ * `foregroundMode` before consulting this table.
+ */
+declare const BROWSER_TRANSITION_TABLE: ModeResolutionTable;
+/**
+ * Mode resolution table for desktop platforms (Electron, etc.).
+ *
+ * - No network → offline.
+ * - Otherwise → configured foreground mode.
+ */
+declare const DESKTOP_TRANSITION_TABLE: ModeResolutionTable;
+export { resolveConnectionMode, MOBILE_TRANSITION_TABLE, BROWSER_TRANSITION_TABLE, DESKTOP_TRANSITION_TABLE, };
+//# sourceMappingURL=ModeResolver.d.ts.map

package/dist/esm/datasource/ModeResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModeResolver.d.ts","sourceRoot":"","sources":["../../src/datasource/ModeResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACV,MAAM,mBAAmB,CAAC;AAqB3B,iBAAS,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,SAAS,GAAG,kBAAkB,CAU/F;AAED;;;;;;GAMG;AACH,QAAA,MAAM,uBAAuB,EAAE,mBAI9B,CAAC;AAEF;;;;;;;;;GASG;AACH,QAAA,MAAM,wBAAwB,EAAE,mBAG/B,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,wBAAwB,EAAE,mBAG/B,CAAC;AAEF,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,GACzB,CAAC"}

package/dist/esm/datasource/StateDebounceManager.d.ts

@@ -0,0 +1,92 @@
+import FDv2ConnectionMode from '../api/datasource/FDv2ConnectionMode';
+/**
+ * Network availability as reported by the platform.
+ * - `'available'`: network is reachable
+ * - `'unavailable'`: network is not reachable
+ */
+export type NetworkState = 'available' | 'unavailable';
+/**
+ * Application lifecycle state as reported by the platform.
+ * - `'foreground'`: application is in the foreground / visible
+ * - `'background'`: application is in the background / hidden
+ */
+export type LifecycleState = 'foreground' | 'background';
+/**
+ * The composite pending state tracked by the debounce manager.
+ * Each field represents one dimension of state that can change
+ * independently. This state accumulates during the debounce window
+ * and is delivered to the reconciliation callback when the timer fires.
+ */
+export interface PendingState {
+    readonly networkState: NetworkState;
+    readonly lifecycleState: LifecycleState;
+    readonly requestedMode: FDv2ConnectionMode;
+}
+/**
+ * Callback invoked when the debounce timer fires. Receives the
+ * final accumulated pending state after the debounce window closes.
+ */
+export type ReconciliationCallback = (pendingState: PendingState) => void;
+/** Default debounce window duration in milliseconds. */
+export declare const DEFAULT_DEBOUNCE_MS = 1000;
+/**
+ * Manages debouncing of network availability, lifecycle, and
+ * connection mode change events. Each event updates the relevant
+ * component of the pending state and resets the debounce timer.
+ * When the timer fires, the reconciliation callback is invoked
+ * with the final combined pending state.
+ *
+ * `identify()` does NOT participate in the debounce window
+ * (CONNMODE spec 3.5.6). Consumers must handle identify separately.
+ */
+export interface StateDebounceManager {
+    /**
+     * Update the pending network state. Resets the debounce timer.
+     */
+    setNetworkState(state: NetworkState): void;
+    /**
+     * Update the pending lifecycle state. Resets the debounce timer.
+     */
+    setLifecycleState(state: LifecycleState): void;
+    /**
+     * Update the pending connection mode. Resets the debounce timer.
+     * This is how `setConnectionMode()` participates in debouncing
+     * (CONNMODE spec 3.5.5).
+     */
+    setRequestedMode(mode: FDv2ConnectionMode): void;
+    /**
+     * Cancel any pending debounce timer and release resources.
+     * After close(), further calls to set* methods will not
+     * trigger reconciliation.
+     */
+    close(): void;
+}
+/**
+ * Configuration for creating a {@link StateDebounceManager}.
+ */
+export interface StateDebounceManagerConfig {
+    /** The initial pending state at construction time. */
+    initialState: PendingState;
+    /**
+     * Callback invoked when the debounce timer fires with the
+     * final resolved pending state.
+     */
+    onReconcile: ReconciliationCallback;
+    /**
+     * Debounce window duration in milliseconds.
+     * @default 1000 (1 second, per CONNMODE spec 3.5.4)
+     */
+    debounceMs?: number;
+}
+/**
+ * Creates a {@link StateDebounceManager}.
+ *
+ * The manager accumulates state changes from network, lifecycle, and
+ * connection mode events. Each event updates the relevant component
+ * of the pending state and resets the debounce timer. When the timer
+ * fires, the reconciliation callback receives the final combined state.
+ *
+ * @param config Configuration for the debounce manager.
+ */
+export declare function createStateDebounceManager(config: StateDebounceManagerConfig): StateDebounceManager;
+//# sourceMappingURL=StateDebounceManager.d.ts.map

package/dist/esm/datasource/StateDebounceManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateDebounceManager.d.ts","sourceRoot":"","sources":["../../src/datasource/StateDebounceManager.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,sCAAsC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,aAAa,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,YAAY,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;AAE1E,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAE/C;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEjD;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,sDAAsD;IACtD,YAAY,EAAE,YAAY,CAAC;IAE3B;;;OAGG;IACH,WAAW,EAAE,sBAAsB,CAAC;IAEpC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,0BAA0B,GACjC,oBAAoB,CA8DtB"}

package/dist/esm/datasource/fdv2/AsyncQueue.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AsyncQueue.d.ts.map

package/dist/esm/datasource/fdv2/AsyncQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncQueue.d.ts","sourceRoot":"","sources":["../../../src/datasource/fdv2/AsyncQueue.ts"],"names":[],"mappings":""}

package/dist/esm/datasource/fdv2/CacheInitializer.d.ts

@@ -0,0 +1,17 @@
+import { Context, Crypto, LDLogger, Storage } from '@launchdarkly/js-sdk-common';
+/**
+ * Configuration for creating a cache initializer.
+ */
+export interface CacheInitializerConfig {
+    /** Platform storage for reading cached data. */
+    storage: Storage | undefined;
+    /** Platform crypto for computing storage keys. */
+    crypto: Crypto;
+    /** Environment namespace (hashed SDK key). */
+    environmentNamespace: string;
+    /** The context to load cached data for. */
+    context: Context;
+    /** Optional logger. */
+    logger?: LDLogger;
+}
+//# sourceMappingURL=CacheInitializer.d.ts.map