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

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/index.d.ts

@@ -11,6 +11,7 @@ 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';
@@ -21,4 +22,6 @@ 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,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"}
+{"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"}

package/dist/esm/index.mjs

@@ -1,4 +1,4 @@
-import { getPollingUri, TypeValidators, createSafeLogger, ServiceEndpoints, ApplicationTags, OptionMessages, NumberWithMinimum, SafeLogger, internal, deepCompact, clone, secondsToMillis, ClientContext, fastDeepEqual, defaultHeaders, Context, LDTimeoutError, AutoEnvAttributes, cancelableTimedPromise, LDClientError, base64UrlEncode, isHttpRecoverable, httpErrorMessage, LDPollingError, DataSourceErrorKind, getStreamingUri, shouldRetry, LDStreamingError } from '@launchdarkly/js-sdk-common';
+import { getPollingUri, isNullish, TypeValidators, OptionMessages, NumberWithMinimum, createSafeLogger, ServiceEndpoints, ApplicationTags, SafeLogger, internal, deepCompact, clone, secondsToMillis, ClientContext, fastDeepEqual, defaultHeaders, Context, LDTimeoutError, AutoEnvAttributes, cancelableTimedPromise, LDClientError, base64UrlEncode, isHttpRecoverable, httpErrorMessage, LDPollingError, DataSourceErrorKind, getStreamingUri, shouldRetry, LDStreamingError } from '@launchdarkly/js-sdk-common';
 export * from '@launchdarkly/js-sdk-common';
 import * as jsSdkCommon from '@launchdarkly/js-sdk-common';
 export { jsSdkCommon as platform };
@@ -204,6 +204,74 @@ function createAsyncTaskQueue(logger) {
     };
 }
 
+function isCompoundValidator(v) {
+    return 'validate' in v;
+}
+/**
+ * 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
+ */
+function validateOptions(input, validatorMap, defaults, logger, prefix) {
+    const result = { ...defaults };
+    if (isNullish(input)) {
+        return result;
+    }
+    if (!TypeValidators.Object.is(input)) {
+        logger?.warn(OptionMessages.wrongOptionType(prefix ?? 'config', 'object', typeof input));
+        return result;
+    }
+    Object.entries(input).forEach(([key, value]) => {
+        const validator = validatorMap[key];
+        const name = prefix ? `${prefix}.${key}` : key;
+        if (!validator) {
+            logger?.warn(OptionMessages.unknownOption(name));
+            return;
+        }
+        if (isNullish(value)) {
+            return;
+        }
+        if (isCompoundValidator(validator)) {
+            const validated = validator.validate(value, name, logger, defaults[key]);
+            if (validated !== undefined) {
+                result[key] = validated.value;
+            }
+            return;
+        }
+        if (validator.is(value)) {
+            result[key] = value;
+            return;
+        }
+        // Validation failed — apply correction or fall back to default.
+        const validatorType = validator.getType();
+        if (validatorType === 'boolean') {
+            logger?.warn(OptionMessages.wrongOptionTypeBoolean(name, typeof value));
+            result[key] = !!value;
+        }
+        else if (validatorType === 'boolean | undefined | null') {
+            logger?.warn(OptionMessages.wrongOptionTypeBoolean(name, typeof value));
+            if (typeof value !== 'boolean' && typeof value !== 'undefined' && value !== null) {
+                result[key] = !!value;
+            }
+        }
+        else if (validator instanceof NumberWithMinimum && TypeValidators.Number.is(value)) {
+            logger?.warn(OptionMessages.optionBelowMinimum(name, value, validator.min));
+            result[key] = validator.min;
+        }
+        else {
+            logger?.warn(OptionMessages.wrongOptionType(name, validatorType, typeof value));
+        }
+    });
+    return result;
+}
+
 // eslint-disable-next-line max-classes-per-file
 const validators = {
     logger: TypeValidators.Object,
@@ -273,8 +341,12 @@ class ConfigurationImpl {
         this.hooks = [];
         this.inspectors = [];
         this.logger = ensureSafeLogger(pristineOptions.logger);
-        const errors = this._validateTypesAndNames(pristineOptions);
-        errors.forEach((e) => this.logger.warn(e));
+        const validated = validateOptions(pristineOptions, validators, {}, this.logger);
+        Object.entries(validated).forEach(([k, v]) => {
+            if (k !== 'logger') {
+                this[k] = v;
+            }
+        });
         this.serviceEndpoints = new ServiceEndpoints(this.streamUri, this.baseUri, this.eventsUri, internalOptions.analyticsEventPath, internalOptions.diagnosticEventPath, internalOptions.includeAuthorizationHeader, pristineOptions.payloadFilterKey);
         this.useReport = pristineOptions.useReport ?? false;
         this.tags = new ApplicationTags({ application: this.applicationInfo, logger: this.logger });
@@ -283,44 +355,6 @@ class ConfigurationImpl {
         this.credentialType = internalOptions.credentialType;
         this.getImplementationHooks = internalOptions.getImplementationHooks;
     }
-    _validateTypesAndNames(pristineOptions) {
-        const errors = [];
-        Object.entries(pristineOptions).forEach(([k, v]) => {
-            const validator = validators[k];
-            if (validator) {
-                if (!validator.is(v)) {
-                    const validatorType = validator.getType();
-                    if (validatorType === 'boolean') {
-                        errors.push(OptionMessages.wrongOptionTypeBoolean(k, typeof v));
-                        this[k] = !!v;
-                    }
-                    else if (validatorType === 'boolean | undefined | null') {
-                        errors.push(OptionMessages.wrongOptionTypeBoolean(k, typeof v));
-                        if (typeof v !== 'boolean' && typeof v !== 'undefined' && v !== null) {
-                            this[k] = !!v;
-                        }
-                    }
-                    else if (validator instanceof NumberWithMinimum && TypeValidators.Number.is(v)) {
-                        const { min } = validator;
-                        errors.push(OptionMessages.optionBelowMinimum(k, v, min));
-                        this[k] = min;
-                    }
-                    else {
-                        errors.push(OptionMessages.wrongOptionType(k, validator.getType(), typeof v));
-                    }
-                }
-                else if (k === 'logger') ;
-                else {
-                    // if an option is explicitly null, coerce to undefined
-                    this[k] = v ?? undefined;
-                }
-            }
-            else {
-                errors.push(OptionMessages.unknownOption(k));
-            }
-        });
-        return errors;
-    }
 }
 
 async function digest(hasher, encoding) {
@@ -2524,5 +2558,5 @@ class BaseDataManager {
     }
 }
 
-export { BaseDataManager, DataSourceState, LDClientImpl, browserFdv1Endpoints, fdv2Endpoints, makeRequestor, mobileFdv1Endpoints, readFlagsFromBootstrap, safeRegisterDebugOverridePlugins };
+export { BaseDataManager, DataSourceState, LDClientImpl, browserFdv1Endpoints, fdv2Endpoints, makeRequestor, mobileFdv1Endpoints, readFlagsFromBootstrap, safeRegisterDebugOverridePlugins, validateOptions };
 //# sourceMappingURL=index.mjs.map