@launchdarkly/js-client-sdk-common 1.9.1-beta.1 → 1.10.0

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

@@ -0,0 +1,39 @@
+import DataSourceStatusErrorInfo from './DataSourceStatusErrorInfo';
+export declare enum DataSourceState {
+    Initializing = "INITIALIZING",
+    Valid = "VALID",
+    Interrupted = "INTERRUPTED",
+    SetOffline = "SET_OFFLINE",
+    Closed = "CLOSED"
+}
+export default interface DataSourceStatus {
+    /**
+     * An enumerated value representing the overall current state of the data source.
+     */
+    readonly state: DataSourceState;
+    /**
+     * The UNIX epoch timestamp in milliseconds that the value of State most recently changed.
+     *
+     * The meaning of this depends on the current state:
+     * For {@link DataSourceState.Initializing}, it is the time that the datasource started
+     * attempting to retrieve data.
+     *
+     * For {@link DataSourceState.Valid}, it is the time that the data source most
+     * recently entered a valid state, after previously having been
+     * {@link DataSourceStatus.Initializing} or an invalid state such as
+     * {@link DataSourceState.Interrupted}.
+     *
+     * - For {@link DataSourceState.interrupted}, it is the time that the data source
+     * most recently entered an error state, after previously having been
+     * {@link DataSourceState.valid}.
+     *
+     * For {@link DataSourceState.Closed}, it is the time that the data source
+     * encountered an unrecoverable error or that the datasource was explicitly closed.
+     */
+    readonly stateSince: number;
+    /**
+     * The last error encountered. May be absent after application restart.
+     */
+    readonly lastError?: DataSourceStatusErrorInfo;
+}
+//# sourceMappingURL=DataSourceStatus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceStatus.d.ts","sourceRoot":"","sources":["../../src/datasource/DataSourceStatus.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,MAAM,6BAA6B,CAAC;AAEpE,oBAAY,eAAe;IACzB,YAAY,iBAAiB;IAC7B,KAAK,UAAU;IACf,WAAW,gBAAgB;IAC3B,UAAU,gBAAgB;IAC1B,MAAM,WAAW;CAGlB;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB;IACvC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAEhC;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,yBAAyB,CAAC;CAChD"}

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

@@ -0,0 +1,8 @@
+import { DataSourceErrorKind } from '@launchdarkly/js-sdk-common';
+export default interface DataSourceStatusErrorInfo {
+    readonly kind: DataSourceErrorKind;
+    readonly message: string;
+    readonly time: number;
+    readonly statusCode?: number;
+}
+//# sourceMappingURL=DataSourceStatusErrorInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceStatusErrorInfo.d.ts","sourceRoot":"","sources":["../../src/datasource/DataSourceStatusErrorInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGlE,MAAM,CAAC,OAAO,WAAW,yBAAyB;IAEhD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAMnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAGzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

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

@@ -0,0 +1,40 @@
+import { DataSourceErrorKind } from '@launchdarkly/js-sdk-common';
+import LDEmitter from '../LDEmitter';
+import DataSourceStatus, { DataSourceState } from './DataSourceStatus';
+/**
+ * Tracks the current data source status and emits updates when the status changes.
+ */
+export default class DataSourceStatusManager {
+    private readonly _emitter;
+    private _state;
+    private _stateSinceMillis;
+    private _errorInfo?;
+    private _timeStamper;
+    constructor(_emitter: LDEmitter, timeStamper?: () => number);
+    get status(): DataSourceStatus;
+    /**
+     * Updates the state of the manager.
+     *
+     * @param requestedState to track
+     * @param isError to indicate that the state update is a result of an error occurring.
+     */
+    private _updateState;
+    /**
+     * Requests the manager move to the provided state.  This request may be ignored
+     * if the current state cannot transition to the requested state.
+     * @param state that is requested
+     */
+    requestStateUpdate(state: DataSourceState): void;
+    /**
+     * Reports a datasource error to this manager. Since the {@link DataSourceStatus} includes error
+     * information, it is possible that that a {@link DataSourceStatus} update is emitted with
+     * the same {@link DataSourceState}.
+     *
+     * @param kind of the error
+     * @param message for the error
+     * @param statusCode of the error if there was one
+     * @param recoverable to indicate that the error is anticipated to be recoverable
+     */
+    reportError(kind: DataSourceErrorKind, message: string, statusCode?: number, recoverable?: boolean): void;
+}
+//# sourceMappingURL=DataSourceStatusManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceStatusManager.d.ts","sourceRoot":"","sources":["../../src/datasource/DataSourceStatusManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,SAAS,MAAM,cAAc,CAAC;AACrC,OAAO,gBAAgB,EAAE,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGvE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAuB;IAOxC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,UAAU,CAAC,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAAe;gBAGhB,QAAQ,EAAE,SAAS,EACpC,WAAW,GAAE,MAAM,MAAyB;IAO9C,IAAI,MAAM,IAAI,gBAAgB,CAM7B;IAED;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,eAAe;IAIzC;;;;;;;;;OASG;IACH,WAAW,CACT,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,GAAE,OAAe;CAgB/B"}

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

@@ -0,0 +1,26 @@
+import { Encoding, HttpErrorResponse, LDHeaders, Requests, ServiceEndpoints } from '@launchdarkly/js-sdk-common';
+import { DataSourcePaths } from './DataSourceConfig';
+export declare class LDRequestError extends Error implements HttpErrorResponse {
+    status?: number;
+    constructor(message: string, status?: number);
+}
+/**
+ * Note: The requestor is implemented independently from polling such that it can be used to
+ * make a one-off request.
+ */
+export default class Requestor {
+    private _requests;
+    private readonly _uri;
+    private readonly _headers;
+    private readonly _method;
+    private readonly _body?;
+    constructor(_requests: Requests, _uri: string, _headers: {
+        [key: string]: string;
+    }, _method: string, _body?: string | undefined);
+    requestPayload(): Promise<string>;
+}
+export declare function makeRequestor(plainContextString: string, serviceEndpoints: ServiceEndpoints, paths: DataSourcePaths, requests: Requests, encoding: Encoding, baseHeaders?: LDHeaders, baseQueryParams?: {
+    key: string;
+    value: string;
+}[], withReasons?: boolean, useReport?: boolean, secureModeHash?: string): Requestor;
+//# sourceMappingURL=Requestor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Requestor.d.ts","sourceRoot":"","sources":["../../src/datasource/Requestor.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EAER,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMrD,qBAAa,cAAe,SAAQ,KAAM,YAAW,iBAAiB;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAK7C;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAE1B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAJf,SAAS,EAAE,QAAQ,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EACnC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,oBAAQ;IAG3B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CAkBxC;AAED,wBAAgB,aAAa,CAC3B,kBAAkB,EAAE,MAAM,EAC1B,gBAAgB,EAAE,gBAAgB,EAClC,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,WAAW,CAAC,EAAE,SAAS,EACvB,eAAe,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EAClD,WAAW,CAAC,EAAE,OAAO,EACrB,SAAS,CAAC,EAAE,OAAO,EACnB,cAAc,CAAC,EAAE,MAAM,aA0BxB"}

package/dist/esm/diagnostics/createDiagnosticsInitConfig.d.ts

@@ -0,0 +1,16 @@
+import { Configuration } from '../configuration';
+export type DiagnosticsInitConfig = {
+    customBaseURI: boolean;
+    customStreamURI: boolean;
+    customEventsURI: boolean;
+    eventsCapacity: number;
+    eventsFlushIntervalMillis: number;
+    reconnectTimeMillis: number;
+    diagnosticRecordingIntervalMillis: number;
+    allAttributesPrivate: boolean;
+    usingSecureMode: boolean;
+    bootstrapMode: boolean;
+};
+declare const createDiagnosticsInitConfig: (config: Configuration) => DiagnosticsInitConfig;
+export default createDiagnosticsInitConfig;
+//# sourceMappingURL=createDiagnosticsInitConfig.d.ts.map

package/dist/esm/diagnostics/createDiagnosticsInitConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDiagnosticsInitConfig.d.ts","sourceRoot":"","sources":["../../src/diagnostics/createDiagnosticsInitConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAmC,MAAM,kBAAkB,CAAC;AAElF,MAAM,MAAM,qBAAqB,GAAG;IAElC,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB,EAAE,MAAM,CAAC;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iCAAiC,EAAE,MAAM,CAAC;IAC1C,oBAAoB,EAAE,OAAO,CAAC;IAG9B,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AACF,QAAA,MAAM,2BAA2B,WAAY,aAAa,KAAG,qBAY3D,CAAC;AAEH,eAAe,2BAA2B,CAAC"}

package/dist/esm/diagnostics/createDiagnosticsManager.d.ts

@@ -0,0 +1,5 @@
+import { internal, Platform } from '@launchdarkly/js-sdk-common';
+import { Configuration } from '../configuration';
+declare const createDiagnosticsManager: (clientSideID: string, config: Configuration, platform: Platform) => internal.DiagnosticsManager | undefined;
+export default createDiagnosticsManager;
+//# sourceMappingURL=createDiagnosticsManager.d.ts.map

package/dist/esm/diagnostics/createDiagnosticsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDiagnosticsManager.d.ts","sourceRoot":"","sources":["../../src/diagnostics/createDiagnosticsManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,QAAA,MAAM,wBAAwB,iBACd,MAAM,UACZ,aAAa,YACX,QAAQ,4CAWnB,CAAC;AAEF,eAAe,wBAAwB,CAAC"}

package/dist/esm/evaluation/evaluationDetail.d.ts

@@ -0,0 +1,5 @@
+import { internal, LDEvaluationReason, LDFlagValue } from '@launchdarkly/js-sdk-common';
+import { LDEvaluationDetail } from '../api';
+export declare function createErrorEvaluationDetail(errorKind: internal.ErrorKinds, def?: LDFlagValue): LDEvaluationDetail;
+export declare function createSuccessEvaluationDetail(value: LDFlagValue, variationIndex?: number, reason?: LDEvaluationReason): LDEvaluationDetail;
+//# sourceMappingURL=evaluationDetail.d.ts.map

package/dist/esm/evaluation/evaluationDetail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluationDetail.d.ts","sourceRoot":"","sources":["../../src/evaluation/evaluationDetail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAExF,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAE5C,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,QAAQ,CAAC,UAAU,EAC9B,GAAG,CAAC,EAAE,WAAW,GAChB,kBAAkB,CAMpB;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,WAAW,EAClB,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,kBAAkB,CAOpB"}

package/dist/esm/events/EventFactory.d.ts

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

package/dist/esm/events/EventFactory.d.ts.map

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

package/dist/esm/events/createEventProcessor.d.ts

@@ -0,0 +1,5 @@
+import { internal, LDHeaders, Platform } from '@launchdarkly/js-sdk-common';
+import { Configuration } from '../configuration';
+declare const createEventProcessor: (clientSideID: string, config: Configuration, platform: Platform, baseHeaders: LDHeaders, diagnosticsManager?: internal.DiagnosticsManager) => internal.EventProcessor | undefined;
+export default createEventProcessor;
+//# sourceMappingURL=createEventProcessor.d.ts.map

package/dist/esm/events/createEventProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEventProcessor.d.ts","sourceRoot":"","sources":["../../src/events/createEventProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE3F,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,QAAA,MAAM,oBAAoB,iBACV,MAAM,UACZ,aAAa,YACX,QAAQ,eACL,SAAS,uBACD,SAAS,kBAAkB,KAC/C,SAAS,cAAc,GAAG,SAa5B,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/esm/flag-manager/ContextIndex.d.ts

@@ -0,0 +1,39 @@
+/**
+ * An index for tracking the most recently used contexts by timestamp with the ability to
+ * update entry timestamps and prune out least used contexts above a max capacity provided.
+ */
+export default class ContextIndex {
+    container: IndexContainer;
+    /**
+     * Creates a {@link ContextIndex} from its JSON representation (likely retrieved from persistence).
+     * @param json representation of the {@link ContextIndex}
+     * @returns the {@link ContextIndex}
+     */
+    static fromJson(json: string): ContextIndex;
+    /**
+     * @returns the JSON representation of the {@link ContextIndex} (like for saving to persistence)
+     */
+    toJson(): string;
+    /**
+     * Notice that a context has been used and when it was used.  This will update an existing record
+     * with the given timestamp, or create a new record if one doesn't exist.
+     * @param id of the corresponding context
+     * @param timestamp in millis since epoch
+     */
+    notice(id: string, timestamp: number): void;
+    /**
+     * Prune the index to the specified max size and then return the IDs
+     * @param maxContexts the maximum number of contexts to retain after this prune
+     * @returns an array of removed entries
+     */
+    prune(maxContexts: number): Array<IndexEntry>;
+}
+export interface IndexContainer {
+    index: Array<IndexEntry>;
+}
+interface IndexEntry {
+    id: string;
+    timestamp: number;
+}
+export {};
+//# sourceMappingURL=ContextIndex.d.ts.map

package/dist/esm/flag-manager/ContextIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextIndex.d.ts","sourceRoot":"","sources":["../../src/flag-manager/ContextIndex.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,SAAS,EAAE,cAAc,CAAsC;IAE/D;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAW3C;;OAEG;IACH,MAAM,IAAI,MAAM;IAIhB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IASpC;;;;OAIG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC;CAU9C;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;CAC1B;AAED,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/esm/flag-manager/FlagManager.d.ts

@@ -0,0 +1,81 @@
+import { Context, LDLogger, Platform } from '@launchdarkly/js-sdk-common';
+import { FlagsChangeCallback } from './FlagUpdater';
+import { ItemDescriptor } from './ItemDescriptor';
+/**
+ * Top level manager of flags for the client. LDClient should be using this
+ * interface and not any of the specific instances managed by it. Updates from
+ * data sources should be directed to the [init] and [upsert] methods of this
+ * interface.
+ */
+export interface FlagManager {
+    /**
+     * Attempts to get a flag by key from the current flags.
+     */
+    get(key: string): ItemDescriptor | undefined;
+    /**
+     * Gets all the current flags.
+     */
+    getAll(): {
+        [key: string]: ItemDescriptor;
+    };
+    /**
+     * Initializes the flag manager with data from a data source.
+     * Persistence initialization is handled by {@link FlagPersistence}
+     */
+    init(context: Context, newFlags: {
+        [key: string]: ItemDescriptor;
+    }): Promise<void>;
+    /**
+     * Attempt to update a flag. If the flag is for the wrong context, or
+     * it is of an older version, then an update will not be performed.
+     */
+    upsert(context: Context, key: string, item: ItemDescriptor): Promise<boolean>;
+    /**
+     * Asynchronously load cached values from persistence.
+     */
+    loadCached(context: Context): Promise<boolean>;
+    /**
+     * Update in-memory storage with the specified flags, but do not persistent them to cache
+     * storage.
+     */
+    setBootstrap(context: Context, newFlags: {
+        [key: string]: ItemDescriptor;
+    }): void;
+    /**
+     * Register a flag change callback.
+     */
+    on(callback: FlagsChangeCallback): void;
+    /**
+     * Unregister a flag change callback.
+     */
+    off(callback: FlagsChangeCallback): void;
+}
+export default class DefaultFlagManager implements FlagManager {
+    private _flagStore;
+    private _flagUpdater;
+    private _flagPersistencePromise;
+    /**
+     * @param platform implementation of various platform provided functionality
+     * @param sdkKey that will be used to distinguish different environments
+     * @param maxCachedContexts that specifies the max number of contexts that will be cached in persistence
+     * @param logger used for logging various messages
+     * @param timeStamper exists for testing purposes
+     */
+    constructor(platform: Platform, sdkKey: string, maxCachedContexts: number, logger: LDLogger, timeStamper?: () => number);
+    private _initPersistence;
+    get(key: string): ItemDescriptor | undefined;
+    getAll(): {
+        [key: string]: ItemDescriptor;
+    };
+    setBootstrap(context: Context, newFlags: {
+        [key: string]: ItemDescriptor;
+    }): void;
+    init(context: Context, newFlags: {
+        [key: string]: ItemDescriptor;
+    }): Promise<void>;
+    upsert(context: Context, key: string, item: ItemDescriptor): Promise<boolean>;
+    loadCached(context: Context): Promise<boolean>;
+    on(callback: FlagsChangeCallback): void;
+    off(callback: FlagsChangeCallback): void;
+}
+//# sourceMappingURL=FlagManager.d.ts.map

package/dist/esm/flag-manager/FlagManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlagManager.d.ts","sourceRoot":"","sources":["../../src/flag-manager/FlagManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAK1E,OAAoB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAE7C;;OAEG;IACH,MAAM,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE,CAAC;IAE5C;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnF;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9E;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/C;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IAElF;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,CAAC,OAAO,OAAO,kBAAmB,YAAW,WAAW;IAC5D,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,uBAAuB,CAA2B;IAE1D;;;;;;OAMG;gBAED,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,QAAQ,EAChB,WAAW,GAAE,MAAM,MAAyB;YAYhC,gBAAgB;IAoB9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI5C,MAAM,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE;IAI3C,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE,GAAG,IAAI;IAM3E,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7E,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,EAAE,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIvC,GAAG,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;CAGzC"}

package/dist/esm/flag-manager/FlagPersistence.d.ts

@@ -0,0 +1,43 @@
+import { Context, LDLogger, Platform } from '@launchdarkly/js-sdk-common';
+import FlagStore from './FlagStore';
+import FlagUpdater from './FlagUpdater';
+import { ItemDescriptor } from './ItemDescriptor';
+/**
+ * This class handles persisting and loading flag values from a persistent
+ * store. It intercepts updates and forwards them to the flag updater and
+ * then persists changes after the updater has completed.
+ */
+export default class FlagPersistence {
+    private readonly _platform;
+    private readonly _environmentNamespace;
+    private readonly _maxCachedContexts;
+    private readonly _flagStore;
+    private readonly _flagUpdater;
+    private readonly _logger;
+    private readonly _timeStamper;
+    private _contextIndex;
+    private _indexKey?;
+    private _indexKeyPromise;
+    constructor(_platform: Platform, _environmentNamespace: string, _maxCachedContexts: number, _flagStore: FlagStore, _flagUpdater: FlagUpdater, _logger: LDLogger, _timeStamper?: () => number);
+    /**
+     * Inits flag persistence for the provided context with the provided flags.  This will result
+     * in the underlying {@link FlagUpdater} switching its active context.
+     */
+    init(context: Context, newFlags: {
+        [key: string]: ItemDescriptor;
+    }): Promise<void>;
+    /**
+     * Upserts a flag into the {@link FlagUpdater} and stores that to persistence if the upsert
+     * was successful / accepted.  An upsert may be rejected if the provided context is not
+     * the active context.
+     */
+    upsert(context: Context, key: string, item: ItemDescriptor): Promise<boolean>;
+    /**
+     * Loads the flags from persistence for the provided context and gives those to the
+     * {@link FlagUpdater} this {@link FlagPersistence} was constructed with.
+     */
+    loadCached(context: Context): Promise<boolean>;
+    private _loadIndex;
+    private _storeCache;
+}
+//# sourceMappingURL=FlagPersistence.d.ts.map

package/dist/esm/flag-manager/FlagPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlagPersistence.d.ts","sourceRoot":"","sources":["../../src/flag-manager/FlagPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAK1E,OAAO,SAAS,MAAM,aAAa,CAAC;AACpC,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAMhC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAX/B,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,gBAAgB,CAAkB;gBAGvB,SAAS,EAAE,QAAQ,EACnB,qBAAqB,EAAE,MAAM,EAC7B,kBAAkB,EAAE,MAAM,EAC1B,UAAU,EAAE,SAAS,EACrB,YAAY,EAAE,WAAW,EACzB,OAAO,EAAE,QAAQ,EACjB,YAAY,GAAE,MAAM,MAAyB;IAKhE;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxF;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAQnF;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YA4CtC,UAAU;YAqBV,WAAW;CA4B1B"}

package/dist/esm/flag-manager/FlagStore.d.ts

@@ -0,0 +1,29 @@
+import { ItemDescriptor } from './ItemDescriptor';
+/**
+ * This interface exists for testing purposes
+ */
+export default interface FlagStore {
+    init(newFlags: {
+        [key: string]: ItemDescriptor;
+    }): void;
+    insertOrUpdate(key: string, update: ItemDescriptor): void;
+    get(key: string): ItemDescriptor | undefined;
+    getAll(): {
+        [key: string]: ItemDescriptor;
+    };
+}
+/**
+ * In memory flag store.
+ */
+export declare class DefaultFlagStore implements FlagStore {
+    private _flags;
+    init(newFlags: {
+        [key: string]: ItemDescriptor;
+    }): void;
+    insertOrUpdate(key: string, update: ItemDescriptor): void;
+    get(key: string): ItemDescriptor | undefined;
+    getAll(): {
+        [key: string]: ItemDescriptor;
+    };
+}
+//# sourceMappingURL=FlagStore.d.ts.map

package/dist/esm/flag-manager/FlagStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlagStore.d.ts","sourceRoot":"","sources":["../../src/flag-manager/FlagStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,SAAS;IAChC,IAAI,CAAC,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IACxD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC7C,MAAM,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE,CAAC;CAC7C;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAChD,OAAO,CAAC,MAAM,CAAyC;IAEvD,IAAI,CAAC,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE;IAUhD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc;IAIlD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAO5C,MAAM,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE;CAG5C"}

package/dist/esm/flag-manager/FlagUpdater.d.ts

@@ -0,0 +1,40 @@
+import { Context, LDLogger } from '@launchdarkly/js-sdk-common';
+import FlagStore from './FlagStore';
+import { ItemDescriptor } from './ItemDescriptor';
+export type FlagChangeType = 'init' | 'patch';
+/**
+ * This callback indicates that the details associated with one or more flags
+ * have changed.
+ *
+ * This could be the value of the flag, but it could also include changes
+ * to the evaluation reason, such as being included in an experiment.
+ *
+ * It can include new or deleted flags as well, so an evaluation may result
+ * in a FLAG_NOT_FOUND reason.
+ *
+ * This event does not include the value of the flag. It is expected that you
+ * will call a variation method for flag values which you require.
+ */
+export type FlagsChangeCallback = (context: Context, flagKeys: Array<string>, type: FlagChangeType) => void;
+/**
+ * The flag updater handles logic required during the flag update process.
+ * It handles versions checking to handle out of order flag updates and
+ * also handles flag comparisons for change notification.
+ */
+export default class FlagUpdater {
+    private _flagStore;
+    private _logger;
+    private _activeContextKey;
+    private _changeCallbacks;
+    constructor(flagStore: FlagStore, logger: LDLogger);
+    init(context: Context, newFlags: {
+        [key: string]: ItemDescriptor;
+    }): void;
+    initCached(context: Context, newFlags: {
+        [key: string]: ItemDescriptor;
+    }): void;
+    upsert(context: Context, key: string, item: ItemDescriptor): boolean;
+    on(callback: FlagsChangeCallback): void;
+    off(callback: FlagsChangeCallback): void;
+}
+//# sourceMappingURL=FlagUpdater.d.ts.map

package/dist/esm/flag-manager/FlagUpdater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlagUpdater.d.ts","sourceRoot":"","sources":["../../src/flag-manager/FlagUpdater.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,SAAS,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EACvB,IAAI,EAAE,cAAc,KACjB,IAAI,CAAC;AAEV;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,gBAAgB,CAAoC;gBAEhD,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ;IAKlD,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE;IAgBlE,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE;IAQxE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IAuBpE,EAAE,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIvC,GAAG,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;CAMzC"}

package/dist/esm/flag-manager/ItemDescriptor.d.ts

@@ -0,0 +1,10 @@
+import { Flag } from '../types';
+/**
+ * An item descriptor is an abstraction that allows for Flag data to be
+ * handled using the same type in both a put or a patch.
+ */
+export interface ItemDescriptor {
+    version: number;
+    flag: Flag;
+}
+//# sourceMappingURL=ItemDescriptor.d.ts.map

package/dist/esm/flag-manager/ItemDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemDescriptor.d.ts","sourceRoot":"","sources":["../../src/flag-manager/ItemDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;CACZ"}

package/dist/esm/flag-manager/calculateChangedKeys.d.ts

@@ -0,0 +1,6 @@
+export default function calculateChangedKeys(existingObject: {
+    [k: string]: any;
+}, newObject: {
+    [k: string]: any;
+}): string[];
+//# sourceMappingURL=calculateChangedKeys.d.ts.map

package/dist/esm/flag-manager/calculateChangedKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculateChangedKeys.d.ts","sourceRoot":"","sources":["../../src/flag-manager/calculateChangedKeys.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,cAAc,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EACpC,SAAS,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,YAoBhC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,20 @@
+import { LDClientInternalOptions } from './configuration/Configuration';
+import DataSourceStatus, { DataSourceState } from './datasource/DataSourceStatus';
+import DataSourceStatusErrorInfo from './datasource/DataSourceStatusErrorInfo';
+import Requestor, { makeRequestor } from './datasource/Requestor';
+import LDClientImpl from './LDClientImpl';
+import LDEmitter, { EventName } from './LDEmitter';
+export * from '@launchdarkly/js-sdk-common';
+export * as platform from '@launchdarkly/js-sdk-common';
+export type { LDEvaluationDetail, LDEvaluationDetailTyped, LDClient, LDOptions, ConnectionMode, LDIdentifyOptions, Hook, HookMetadata, EvaluationSeriesContext, EvaluationSeriesData, IdentifySeriesContext, IdentifySeriesData, IdentifySeriesResult, IdentifySeriesStatus, } from './api';
+export type { DataManager, DataManagerFactory, ConnectionParams } from './DataManager';
+export type { FlagManager } from './flag-manager/FlagManager';
+export type { Configuration } from './configuration/Configuration';
+export type { LDEmitter };
+export type { ItemDescriptor } from './flag-manager/ItemDescriptor';
+export type { Flag } from './types';
+export { DataSourcePaths } from './streaming';
+export { BaseDataManager } from './DataManager';
+export { makeRequestor, Requestor };
+export { DataSourceStatus, DataSourceStatusErrorInfo, LDClientImpl, LDClientInternalOptions, DataSourceState, EventName as LDEmitterEventName, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,SAAS,EAAE,EAAE,aAAa,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,GACrB,MAAM,OAAO,CAAC;AAEf,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,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;AAEpC,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"}

package/dist/{index.mjs → esm/index.mjs}

@@ -1314,7 +1314,7 @@ class LDClientImpl {
             successDetail.value = defaultValue;
         }
         prerequisites?.forEach((prereqKey) => {
-            this.variation(prereqKey, undefined);
+            this._variationInternal(prereqKey, undefined, this._eventFactoryDefault);
         });
         this._eventProcessor?.sendEvent(eventFactory.evalEventClient(flagKey, value, defaultValue, foundItem.flag, evalContext, reason));
         return successDetail;