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

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

@@ -0,0 +1,82 @@
+import { internal } from '@launchdarkly/js-sdk-common';
+import DataSourceStatusErrorInfo from '../DataSourceStatusErrorInfo';
+/**
+ * Possible states for a status result from an FDv2 data source.
+ *
+ * - `interrupted`: Transient error; synchronizer will retry automatically.
+ * - `shutdown`: Graceful shutdown; no further results will be produced.
+ * - `terminal_error`: Unrecoverable error; no further results will be produced.
+ * - `goodbye`: Server-initiated disconnect; no further results will be produced.
+ */
+export type SourceState = 'interrupted' | 'shutdown' | 'terminal_error' | 'goodbye';
+/**
+ * A change set result containing a processed FDv2 payload.
+ */
+export interface ChangeSetResult {
+    type: 'changeSet';
+    payload: internal.Payload;
+    fdv1Fallback: boolean;
+    environmentId?: string;
+}
+/**
+ * A status result indicating a state transition (error, shutdown, goodbye).
+ */
+export interface StatusResult {
+    type: 'status';
+    state: SourceState;
+    errorInfo?: DataSourceStatusErrorInfo;
+    reason?: string;
+    fdv1Fallback: boolean;
+}
+/**
+ * The result type for FDv2 initializers and synchronizers.
+ *
+ * An initializer produces a single result, while a synchronizer produces a
+ * stream of results. Each result is either a change set (containing a payload
+ * of flag data) or a status (indicating a state transition like an error or
+ * shutdown).
+ */
+export type FDv2SourceResult = ChangeSetResult | StatusResult;
+/**
+ * Creates a change set result containing processed flag data.
+ */
+export declare function changeSet(payload: internal.Payload, fdv1Fallback: boolean, environmentId?: string): FDv2SourceResult;
+/**
+ * Creates an interrupted status result. Indicates a transient error; the
+ * synchronizer will attempt to recover automatically.
+ *
+ * When used with an initializer, this is still a terminal state.
+ */
+export declare function interrupted(errorInfo: DataSourceStatusErrorInfo, fdv1Fallback: boolean): FDv2SourceResult;
+/**
+ * Creates a shutdown status result. Indicates the data source was closed
+ * gracefully and will not produce any further results.
+ */
+export declare function shutdown(): FDv2SourceResult;
+/**
+ * Creates a terminal error status result. Indicates an unrecoverable error;
+ * the data source will not produce any further results.
+ */
+export declare function terminalError(errorInfo: DataSourceStatusErrorInfo, fdv1Fallback: boolean): FDv2SourceResult;
+/**
+ * Creates a goodbye status result. Indicates the server has instructed the
+ * client to disconnect.
+ */
+export declare function goodbye(reason: string, fdv1Fallback: boolean): FDv2SourceResult;
+/**
+ * Helper to create a {@link DataSourceStatusErrorInfo} from an HTTP status code.
+ */
+export declare function errorInfoFromHttpError(statusCode: number): DataSourceStatusErrorInfo;
+/**
+ * Helper to create a {@link DataSourceStatusErrorInfo} from a network error.
+ */
+export declare function errorInfoFromNetworkError(message: string): DataSourceStatusErrorInfo;
+/**
+ * Helper to create a {@link DataSourceStatusErrorInfo} from invalid data.
+ */
+export declare function errorInfoFromInvalidData(message: string): DataSourceStatusErrorInfo;
+/**
+ * Helper to create a {@link DataSourceStatusErrorInfo} for unknown errors.
+ */
+export declare function errorInfoFromUnknown(message: string): DataSourceStatusErrorInfo;
+//# sourceMappingURL=FDv2SourceResult.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FDv2SourceResult.d.ts","sourceRoot":"","sources":["../../../src/datasource/fdv2/FDv2SourceResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5E,OAAO,yBAAyB,MAAM,8BAA8B,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,UAAU,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,YAAY,CAAC;AAE9D;;GAEG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,QAAQ,CAAC,OAAO,EACzB,YAAY,EAAE,OAAO,EACrB,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,CAElB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,yBAAyB,EACpC,YAAY,EAAE,OAAO,GACpB,gBAAgB,CAElB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,gBAAgB,CAE3C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,yBAAyB,EACpC,YAAY,EAAE,OAAO,GACpB,gBAAgB,CAElB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,gBAAgB,CAE/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,yBAAyB,CAOpF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,yBAAyB,CAMpF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,yBAAyB,CAMnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,yBAAyB,CAM/E"}

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

@@ -0,0 +1,40 @@
+import { FDv2SourceResult } from './FDv2SourceResult';
+/**
+ * Interface for an asynchronous data source initializer.
+ *
+ * An initializer runs once and produces a single result. If successful, the
+ * result contains a change set with flag data. If it fails, the result
+ * contains a status describing the error.
+ *
+ * Once `run()` resolves, the initializer is complete and should not be
+ * called again. Use `close()` to cancel a pending run.
+ *
+ * ```
+ *     [START]
+ *        │
+ *        ▼
+ *   ┌─────────┐
+ *   │ RUNNING │──┐
+ *   └─────────┘  │
+ *    │  │  │  │  └──► SHUTDOWN ──► [END]
+ *    │  │  │  └─────► INTERRUPTED ──► [END]
+ *    │  │  └────────► CHANGESET ──► [END]
+ *    │  └───────────► TERMINAL_ERROR ──► [END]
+ *    └──────────────► GOODBYE ──► [END]
+ * ```
+ */
+export interface Initializer {
+    /**
+     * Run the initializer to completion.
+     *
+     * This method is intended to be called only a single time for an instance.
+     * @returns The result of the initializer.
+     */
+    run(): Promise<FDv2SourceResult>;
+    /**
+     * Close the initializer. If `run()` is in progress, it will resolve with
+     * a shutdown result.
+     */
+    close(): void;
+}
+//# sourceMappingURL=Initializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Initializer.d.ts","sourceRoot":"","sources":["../../../src/datasource/fdv2/Initializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEjC;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,88 @@
+import { Initializer } from './Initializer';
+import { Synchronizer } from './Synchronizer';
+/**
+ * Factory function that creates an {@link Initializer} instance.
+ *
+ * @param selectorGetter Returns the current selector (basis) string, or
+ *   `undefined` if no selector is available.
+ */
+export type InitializerFactory = (selectorGetter: () => string | undefined) => Initializer;
+/**
+ * Factory function that creates a {@link Synchronizer} instance.
+ *
+ * @param selectorGetter Returns the current selector (basis) string, or
+ *   `undefined` if no selector is available.
+ */
+export type SynchronizerFactory = (selectorGetter: () => string | undefined) => Synchronizer;
+/**
+ * State of a synchronizer slot.
+ * - `'available'`: can be selected for use.
+ * - `'blocked'`: has been blocked (e.g., terminal error or not yet activated).
+ */
+export type SynchronizerSlotState = 'available' | 'blocked';
+/**
+ * A slot in the synchronizer list, wrapping a factory with state metadata.
+ */
+export interface SynchronizerSlot {
+    readonly factory: SynchronizerFactory;
+    readonly isFDv1Fallback: boolean;
+    state: SynchronizerSlotState;
+}
+/**
+ * Creates a {@link SynchronizerSlot}.
+ *
+ * @param factory The synchronizer factory function.
+ * @param options Optional configuration.
+ * @param options.isFDv1Fallback Whether this slot is the FDv1 fallback adapter.
+ *   FDv1 slots start `'blocked'` by default.
+ * @param options.initialState Override the initial state (defaults to
+ *   `'blocked'` for FDv1 slots, `'available'` otherwise).
+ */
+export declare function createSynchronizerSlot(factory: SynchronizerFactory, options?: {
+    isFDv1Fallback?: boolean;
+    initialState?: SynchronizerSlotState;
+}): SynchronizerSlot;
+/**
+ * Manages the state of initializers and synchronizers, tracks which source
+ * is active, and handles source transitions.
+ */
+export interface SourceManager {
+    /**
+     * Get the next initializer and set it as the active source.
+     * Closes the previous active source. Returns `undefined` when all
+     * initializers are exhausted.
+     */
+    getNextInitializerAndSetActive(): Initializer | undefined;
+    /**
+     * Get the next available (non-blocked) synchronizer and set it as the
+     * active source. Closes the previous active source. Returns `undefined`
+     * when all available synchronizers have been visited.
+     */
+    getNextAvailableSynchronizerAndSetActive(): Synchronizer | undefined;
+    /** Mark the current synchronizer as blocked (e.g., after terminal error). */
+    blockCurrentSynchronizer(): void;
+    /** Reset the synchronizer index to -1 so the next call starts from the beginning. */
+    resetSourceIndex(): void;
+    /** Block all non-FDv1 synchronizers and unblock FDv1 synchronizers. */
+    fdv1Fallback(): void;
+    /** True if the current synchronizer is the first available (primary). */
+    isPrimeSynchronizer(): boolean;
+    /** Count of synchronizers in `'available'` state. */
+    getAvailableSynchronizerCount(): number;
+    /** True if any synchronizer slot is marked as an FDv1 fallback. */
+    hasFDv1Fallback(): boolean;
+    /** Close the active source and mark the manager as shut down. */
+    close(): void;
+    /** True if {@link close} has been called. */
+    readonly isShutdown: boolean;
+}
+/**
+ * Creates a {@link SourceManager} that coordinates initializer and
+ * synchronizer lifecycle.
+ *
+ * @param initializerFactories Ordered list of initializer factories.
+ * @param synchronizerSlots Ordered list of synchronizer slots with state.
+ * @param selectorGetter Closure that returns the current selector string.
+ */
+export declare function createSourceManager(initializerFactories: InitializerFactory[], synchronizerSlots: SynchronizerSlot[], selectorGetter: () => string | undefined): SourceManager;
+//# sourceMappingURL=SourceManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SourceManager.d.ts","sourceRoot":"","sources":["../../../src/datasource/fdv2/SourceManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,KAAK,WAAW,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,KAAK,YAAY,CAAC;AAE7F;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC,GACA,gBAAgB,CAIlB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,8BAA8B,IAAI,WAAW,GAAG,SAAS,CAAC;IAE1D;;;;OAIG;IACH,wCAAwC,IAAI,YAAY,GAAG,SAAS,CAAC;IAErE,6EAA6E;IAC7E,wBAAwB,IAAI,IAAI,CAAC;IAEjC,qFAAqF;IACrF,gBAAgB,IAAI,IAAI,CAAC;IAEzB,uEAAuE;IACvE,YAAY,IAAI,IAAI,CAAC;IAErB,yEAAyE;IACzE,mBAAmB,IAAI,OAAO,CAAC;IAE/B,qDAAqD;IACrD,6BAA6B,IAAI,MAAM,CAAC;IAExC,mEAAmE;IACnE,eAAe,IAAI,OAAO,CAAC;IAE3B,iEAAiE;IACjE,KAAK,IAAI,IAAI,CAAC;IAEd,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,oBAAoB,EAAE,kBAAkB,EAAE,EAC1C,iBAAiB,EAAE,gBAAgB,EAAE,EACrC,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,GACvC,aAAa,CAsGf"}

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

@@ -0,0 +1,11 @@
+import { FDv2SourceResult } from './FDv2SourceResult';
+/**
+ * Handler invoked when a legacy `"ping"` event is received on the stream.
+ * The implementation should perform an FDv2 poll request (e.g. via
+ * {@link poll} from PollingBase) and return the processed result.
+ */
+export interface PingHandler {
+    /** Perform a poll and return the processed result. */
+    handlePing(): Promise<FDv2SourceResult>;
+}
+//# sourceMappingURL=StreamingFDv2Base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingFDv2Base.d.ts","sourceRoot":"","sources":["../../../src/datasource/fdv2/StreamingFDv2Base.ts"],"names":[],"mappings":"AAeA,OAAO,EAML,gBAAgB,EAKjB,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACzC"}

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,49 @@
+import { FDv2SourceResult } from './FDv2SourceResult';
+/**
+ * Interface for an asynchronous data source synchronizer.
+ *
+ * A synchronizer runs continuously and produces a stream of results via
+ * successive calls to `next()`. When it experiences a temporary failure,
+ * it emits an INTERRUPTED result while attempting to recover. When it
+ * receives data, it emits a CHANGESET result. When shut down gracefully,
+ * it emits a SHUTDOWN result.
+ *
+ * `next()` is intended to be driven by a single caller, with one outstanding
+ * call at a time. Once SHUTDOWN or TERMINAL_ERROR has been produced, no
+ * further calls to `next()` should be made.
+ *
+ * ```
+ *       [START]
+ *          │
+ *          ▼
+ *    ┌─────────┐
+ * ┌─►│ RUNNING │──┐
+ * │  └─────────┘  │
+ * │   │  │  │  │  └──► SHUTDOWN ──────► [END]
+ * │   │  │  │  └─────► TERMINAL_ERROR ► [END]
+ * │   │  │  └────────► GOODBYE ───────┐
+ * │   │  └───────────► CHANGESET ─────┤
+ * │   └──────────────► INTERRUPTED ───┤
+ * └───────────────────────────────────┘
+ * ```
+ */
+export interface Synchronizer {
+    /**
+     * Get the next result from the stream.
+     *
+     * This method is intended to be driven by a single caller, and for there
+     * to be a single outstanding call at any given time.
+     *
+     * Once SHUTDOWN or TERMINAL_ERROR has been produced, no further calls to
+     * `next()` should be made.
+     *
+     * @returns A promise that resolves when the next result is available.
+     */
+    next(): Promise<FDv2SourceResult>;
+    /**
+     * Close the synchronizer. The next call to `next()` will resolve with a
+     * shutdown result.
+     */
+    close(): void;
+}
+//# sourceMappingURL=Synchronizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Synchronizer.d.ts","sourceRoot":"","sources":["../../../src/datasource/fdv2/Synchronizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;OAUG;IACH,IAAI,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAElC;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

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

@@ -0,0 +1,16 @@
+export type { AsyncQueue } from './AsyncQueue';
+export { createAsyncQueue } from './AsyncQueue';
+export type { FDv2PollResponse, FDv2Requestor } from './FDv2Requestor';
+export { makeFDv2Requestor } from './FDv2Requestor';
+export type { ChangeSetResult, FDv2SourceResult, SourceState, StatusResult, } from './FDv2SourceResult';
+export { changeSet, errorInfoFromHttpError, errorInfoFromInvalidData, errorInfoFromNetworkError, errorInfoFromUnknown, goodbye, interrupted, shutdown, terminalError, } from './FDv2SourceResult';
+export type { Initializer } from './Initializer';
+export type { Synchronizer } from './Synchronizer';
+export { poll } from './PollingBase';
+export { createPollingInitializer } from './PollingInitializer';
+export { createPollingSynchronizer } from './PollingSynchronizer';
+export type { PingHandler, StreamingFDv2Base } from './StreamingFDv2Base';
+export { createStreamingBase } from './StreamingFDv2Base';
+export { createStreamingInitializer } from './StreamingInitializerFDv2';
+export { createStreamingSynchronizer } from './StreamingSynchronizerFDv2';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/datasource/fdv2/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,OAAO,EACP,WAAW,EACX,QAAQ,EACR,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { internal } from '@launchdarkly/js-sdk-common';
+import { ItemDescriptor } from '../flag-manager/ItemDescriptor';
+import { FlagEvaluationResult } from '../types';
+/**
+ * ObjProcessor for the `flagEval` object kind. Used by the protocol handler to
+ * process objects received in `put-object` events.
+ *
+ * Client-side evaluation results are already in their final form (pre-evaluated
+ * by the server), so no transformation is needed — this is a passthrough.
+ */
+export declare function processFlagEval(object: unknown): FlagEvaluationResult;
+/**
+ * Converts an FDv2 {@link internal.Update} with `kind: 'flagEval'` into an
+ * {@link ItemDescriptor} suitable for {@link FlagManager}.
+ *
+ * For put updates the envelope `version` is used as the {@link ItemDescriptor.version}
+ * and as {@link Flag.version}. The rest of the fields are spread from the
+ * {@link FlagEvaluationResult} object.
+ *
+ * For delete updates a tombstone descriptor is created with `deleted: true`.
+ */
+export declare function flagEvalUpdateToItemDescriptor(update: internal.Update): ItemDescriptor;
+/**
+ * Converts an array of FDv2 payload updates into a map of flag key to
+ * {@link ItemDescriptor}. Only `flagEval` kind updates are processed;
+ * unrecognized kinds are silently ignored.
+ */
+export declare function flagEvalPayloadToItemDescriptors(updates: internal.Update[]): {
+    [key: string]: ItemDescriptor;
+};
+//# sourceMappingURL=flagEvalMapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flagEvalMapper.d.ts","sourceRoot":"","sources":["../../src/datasource/flagEvalMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,oBAAoB,CAErE;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,cAAc,CAqBtF;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG;IAC5E,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC;CAC/B,CAUA"}

package/dist/esm/index.d.ts

@@ -11,12 +11,17 @@ export type { DataManager, DataManagerFactory, ConnectionParams } from './DataMa
 export type { FlagManager, LDDebugOverride } from './flag-manager/FlagManager';
 export { safeRegisterDebugOverridePlugins } from './plugins/safeRegisterDebugOverridePlugins';
 export type { Configuration } from './configuration/Configuration';
+export { default as validateOptions } from './configuration/validateOptions';
 export type { LDEmitter };
 export type { ItemDescriptor } from './flag-manager/ItemDescriptor';
 export type { Flag } from './types';
 export { readFlagsFromBootstrap } from './flag-manager/bootstrap';
 export { DataSourcePaths } from './streaming';
+export { browserFdv1Endpoints, mobileFdv1Endpoints, fdv2Endpoints } from './datasource/Endpoints';
+export type { DataSourceEndpoints } from './datasource/Endpoints';
 export { BaseDataManager } from './DataManager';
 export { makeRequestor, Requestor };
 export { DataSourceStatus, DataSourceStatusErrorInfo, LDClientImpl, LDClientInternalOptions, DataSourceState, EventName as LDEmitterEventName, };
+export type { FDv2ConnectionMode, EndpointConfig, CacheDataSourceEntry, PollingDataSourceEntry, StreamingDataSourceEntry, DataSourceEntry, ModeDefinition, LDClientDataSystemOptions, AutomaticModeSwitchingConfig, PlatformDataSystemDefaults, } from './api/datasource';
+export type { ModeTable } from './datasource/ConnectionModeConfig';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,gBAAgB,EAAE,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,yBAAyB,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD,cAAc,6BAA6B,CAAC;AAE5C,OAAO,KAAK,QAAQ,MAAM,6BAA6B,CAAC;AAMxD,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,QAAQ,EACR,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,IAAI,EACJ,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,8BAA8B,EAC9B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,SAAS,EACT,eAAe,GAChB,MAAM,OAAO,CAAC;AAEf,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,gCAAgC,EAAE,MAAM,4CAA4C,CAAC;AAC9F,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,YAAY,EAAE,SAAS,EAAE,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAEpC,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,SAAS,IAAI,kBAAkB,GAChC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,gBAAgB,EAAE,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,yBAAyB,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD,cAAc,6BAA6B,CAAC;AAE5C,OAAO,KAAK,QAAQ,MAAM,6BAA6B,CAAC;AAMxD,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,QAAQ,EACR,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,IAAI,EACJ,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,8BAA8B,EAC9B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,SAAS,EACT,eAAe,GAChB,MAAM,OAAO,CAAC;AAEf,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,gCAAgC,EAAE,MAAM,4CAA4C,CAAC;AAC9F,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAE7E,YAAY,EAAE,SAAS,EAAE,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClG,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAEpC,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,SAAS,IAAI,kBAAkB,GAChC,CAAC;AAKF,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC"}