@launchdarkly/js-client-sdk-common 1.19.1 → 1.21.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## [1.21.0](https://github.com/launchdarkly/js-core/compare/js-client-sdk-common-v1.20.0...js-client-sdk-common-v1.21.0) (2026-03-04)
+
+
+### Features
+
+* Add fdv2 mode configuration types and validation. ([#1135](https://github.com/launchdarkly/js-core/issues/1135)) ([6ee156c](https://github.com/launchdarkly/js-core/commit/6ee156c4e7055266d5e9d81afb43f4dd7d85f02d))
+* Add FDv2 polling initializer/synchronizer ([#1130](https://github.com/launchdarkly/js-core/issues/1130)) ([6777fc6](https://github.com/launchdarkly/js-core/commit/6777fc6f7b501dd0547f6eb7cd8e0f26c72aad9d))
+* Add FDv2 State Debouncer ([#1148](https://github.com/launchdarkly/js-core/issues/1148)) ([da3f72e](https://github.com/launchdarkly/js-core/commit/da3f72e2da800953582311fa640b7a63f166a35d))
+* Add FDv2 streaming initializer/synchronizer ([#1131](https://github.com/launchdarkly/js-core/issues/1131)) ([6602bbc](https://github.com/launchdarkly/js-core/commit/6602bbc54ddb40ce9a2a3af7722a204d813144ed))
+* Add FDv2DataSource composite data source orchestrator ([#1141](https://github.com/launchdarkly/js-core/issues/1141)) ([f02ae5a](https://github.com/launchdarkly/js-core/commit/f02ae5a3189d73022fb81221d532e95659da9f01))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @launchdarkly/js-sdk-common bumped from 2.22.0 to 2.23.0
+
+## [1.20.0](https://github.com/launchdarkly/js-core/compare/js-client-sdk-common-v1.19.1...js-client-sdk-common-v1.20.0) (2026-02-25)
+
+
+### Features
+
+* Add flag eval model for FDv2. ([#1124](https://github.com/launchdarkly/js-core/issues/1124)) ([028e63f](https://github.com/launchdarkly/js-core/commit/028e63f34eb0f11c5c0d8d078baf0ec378b9e8e0))
+* Consolidate endpoint paths. Add FDv2 endpoints. ([#1125](https://github.com/launchdarkly/js-core/issues/1125)) ([297ef9d](https://github.com/launchdarkly/js-core/commit/297ef9d2793cdd750a9050674137257d6e18c809))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @launchdarkly/js-sdk-common bumped from 2.21.0 to 2.22.0
+
 ## [1.19.1](https://github.com/launchdarkly/js-core/compare/js-client-sdk-common-v1.19.0...js-client-sdk-common-v1.19.1) (2026-02-25)
 
 

package/dist/cjs/api/datasource/DataSourceEntry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Endpoint overrides for a network data source entry. Allows routing specific
+ * sources to different infrastructure (e.g., a relay proxy as a fallback).
+ *
+ * When not specified, the SDK uses `baseUri` for polling and `streamUri` for
+ * streaming from the base SDK configuration.
+ */
+export interface EndpointConfig {
+    /** Override for the polling base URI. Defaults to `baseUri` from SDK configuration. */
+    readonly pollingBaseUri?: string;
+    /** Override for the streaming base URI. Defaults to `streamUri` from SDK configuration. */
+    readonly streamingBaseUri?: string;
+}
+/**
+ * Configuration for a cache data source entry.
+ */
+export interface CacheDataSourceEntry {
+    readonly type: 'cache';
+}
+/**
+ * Configuration for a polling data source entry.
+ */
+export interface PollingDataSourceEntry {
+    readonly type: 'polling';
+    /** Override for the polling interval, in seconds. */
+    readonly pollInterval?: number;
+    /** Endpoint overrides for this polling source. */
+    readonly endpoints?: EndpointConfig;
+}
+/**
+ * Configuration for a streaming data source entry.
+ */
+export interface StreamingDataSourceEntry {
+    readonly type: 'streaming';
+    /** Override for the initial reconnect delay, in seconds. */
+    readonly initialReconnectDelay?: number;
+    /** Endpoint overrides for this streaming source. */
+    readonly endpoints?: EndpointConfig;
+}
+/**
+ * A data source entry in a mode table. Each entry identifies a data source type
+ * and carries type-specific configuration overrides.
+ */
+export type DataSourceEntry = CacheDataSourceEntry | PollingDataSourceEntry | StreamingDataSourceEntry;
+//# sourceMappingURL=DataSourceEntry.d.ts.map

package/dist/cjs/api/datasource/DataSourceEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceEntry.d.ts","sourceRoot":"","sources":["../../../src/api/datasource/DataSourceEntry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,uFAAuF;IACvF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B,4DAA4D;IAC5D,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAExC,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,sBAAsB,GACtB,wBAAwB,CAAC"}

package/dist/cjs/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/cjs/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/cjs/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/cjs/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/cjs/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/cjs/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/cjs/api/datasource/index.d.ts

@@ -0,0 +1,5 @@
+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';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/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"}

package/dist/cjs/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/cjs/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/cjs/configuration/Configuration.d.ts

@@ -88,6 +88,5 @@ export default class ConfigurationImpl implements Configuration {
     readonly getImplementationHooks: (environmentMetadata: LDPluginEnvironmentMetadata) => Hook[];
     [index: string]: any;
     constructor(pristineOptions?: LDOptions, internalOptions?: LDClientInternalOptions);
-    private _validateTypesAndNames;
 }
 //# sourceMappingURL=Configuration.d.ts.map

package/dist/cjs/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/cjs/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>): 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/cjs/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,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,iBAAiB,CAsBxF;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/cjs/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/cjs/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/cjs/datasource/DataSourceConfig.d.ts

@@ -20,6 +20,7 @@ export interface StreamingDataSourceConfig extends DataSourceConfig {
 export interface DataSourcePaths {
     pathGet(encoding: Encoding, plainContextString: string): string;
     pathReport(encoding: Encoding, plainContextString: string): string;
+    pathPost(encoding: Encoding, plainContextString: string): string;
     pathPing(encoding: Encoding, plainContextString: string): string;
 }
 //# sourceMappingURL=DataSourceConfig.d.ts.map

package/dist/cjs/datasource/DataSourceConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataSourceConfig.d.ts","sourceRoot":"","sources":["../../src/datasource/DataSourceConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,SAAS,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,eAAe,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAE9B,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhE,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;CAClE"}
+{"version":3,"file":"DataSourceConfig.d.ts","sourceRoot":"","sources":["../../src/datasource/DataSourceConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,SAAS,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,eAAe,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAE9B,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhE,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;CAClE"}

package/dist/cjs/datasource/Endpoints.d.ts

@@ -0,0 +1,21 @@
+import { DataSourcePaths } from './DataSourceConfig';
+export interface DataSourceEndpoints {
+    polling: () => DataSourcePaths;
+    streaming: () => DataSourcePaths;
+}
+/**
+ * Creates endpoint paths for browser (client-side ID) FDv1 evaluation.
+ *
+ * @param clientSideId The client-side ID for this environment.
+ */
+export declare function browserFdv1Endpoints(clientSideId: string): DataSourceEndpoints;
+/**
+ * Creates endpoint paths for mobile (mobile key) FDv1 evaluation.
+ */
+export declare function mobileFdv1Endpoints(): DataSourceEndpoints;
+/**
+ * Creates endpoint paths for FDv2 evaluation.
+ * Unified for all client-side platforms per CSFDV2 Requirement 2.1.1.
+ */
+export declare function fdv2Endpoints(): DataSourceEndpoints;
+//# sourceMappingURL=Endpoints.d.ts.map

package/dist/cjs/datasource/Endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Endpoints.d.ts","sourceRoot":"","sources":["../../src/datasource/Endpoints.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,eAAe,CAAC;IAC/B,SAAS,EAAE,MAAM,eAAe,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,CA+B9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,CA+BzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CA+BnD"}

package/dist/cjs/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/cjs/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/cjs/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/cjs/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/cjs/datasource/fdv2/AsyncQueue.d.ts

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

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

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