@launchdarkly/js-client-sdk-common 1.14.1 → 1.15.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.15.0](https://github.com/launchdarkly/js-core/compare/js-client-sdk-common-v1.14.1...js-client-sdk-common-v1.15.0) (2025-06-17)
+
+
+### Features
+
+* Add support for an identify queue. ([#842](https://github.com/launchdarkly/js-core/issues/842)) ([78e9a5e](https://github.com/launchdarkly/js-core/commit/78e9a5e93cb4c06a19c0d7d63307dfd3407d4505))
+
 ## [1.14.1](https://github.com/launchdarkly/js-core/compare/js-client-sdk-common-v1.14.0...js-client-sdk-common-v1.14.1) (2025-06-03)
 
 

package/dist/cjs/LDClientImpl.d.ts

@@ -1,11 +1,11 @@
 import { AutoEnvAttributes, Context, internal, LDContext, LDFlagSet, LDFlagValue, LDLogger, LDPluginEnvironmentMetadata, Platform } from '@launchdarkly/js-sdk-common';
-import { Hook, LDClient, type LDOptions } from './api';
+import { Hook, LDClient, LDClientIdentifyResult, LDIdentifyResult, type LDOptions } from './api';
 import { LDEvaluationDetail, LDEvaluationDetailTyped } from './api/LDEvaluationDetail';
 import { LDIdentifyOptions } from './api/LDIdentifyOptions';
 import { LDClientInternalOptions } from './configuration';
 import { DataManager, DataManagerFactory } from './DataManager';
 import LDEmitter, { EventName } from './LDEmitter';
-export default class LDClientImpl implements LDClient {
+export default class LDClientImpl implements LDClient, LDClientIdentifyResult {
     readonly sdkKey: string;
     readonly autoEnvAttributes: AutoEnvAttributes;
     readonly platform: Platform;
@@ -26,6 +26,7 @@ export default class LDClientImpl implements LDClient {
     protected readonly environmentMetadata: LDPluginEnvironmentMetadata;
     private _hookRunner;
     private _inspectorManager;
+    private _identifyQueue;
     /**
      * Creates the client object synchronously. No async, no network calls.
      */
@@ -42,6 +43,13 @@ export default class LDClientImpl implements LDClient {
     /**
      * Identifies a context to LaunchDarkly. See {@link LDClient.identify}.
      *
+     * If used with the `sheddable` option set to true, then the identify operation will be sheddable. This means that if
+     * multiple identify operations are done, without waiting for the previous one to complete, then intermediate
+     * operations may be discarded.
+     *
+     * It is recommended to use the `identifyResult` method instead when the operation is sheddable. In a future release,
+     * all identify operations will default to being sheddable.
+     *
      * @param pristineContext The LDContext object to be identified.
      * @param identifyOptions Optional configuration. See {@link LDIdentifyOptions}.
      * @returns A Promise which resolves when the flag values for the specified
@@ -55,6 +63,7 @@ export default class LDClientImpl implements LDClient {
      * 3. A network error is encountered during initialization.
      */
     identify(pristineContext: LDContext, identifyOptions?: LDIdentifyOptions): Promise<void>;
+    identifyResult(pristineContext: LDContext, identifyOptions?: LDIdentifyOptions): Promise<LDIdentifyResult>;
     on(eventName: EventName, listener: Function): void;
     off(eventName: EventName, listener: Function): void;
     track(key: string, data?: any, metricValue?: number): void;

package/dist/cjs/LDClientImpl.d.ts.map

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

package/dist/cjs/api/LDClient.d.ts

@@ -2,6 +2,7 @@ import { LDContext, LDFlagSet, LDFlagValue, LDLogger } from '@launchdarkly/js-sd
 import { Hook } from './integrations/Hooks';
 import { LDEvaluationDetail, LDEvaluationDetailTyped } from './LDEvaluationDetail';
 import { LDIdentifyOptions } from './LDIdentifyOptions';
+import { LDIdentifyResult } from './LDIdentifyResult';
 /**
  * The basic interface for the LaunchDarkly client. Platform-specific SDKs may add some methods of their own.
  *
@@ -87,6 +88,10 @@ export interface LDClient {
      * finished, calls to {@link variation} will still return flag values for the previous context. You can
      * await the Promise to determine when the new flag values are available.
      *
+     * If used with the `sheddable` option set to true, then the identify operation will be sheddable. This means that if
+     * multiple identify operations are done, without waiting for the previous one to complete, then intermediate
+     * operations may be discarded.
+     *
      * @param context
      *    The LDContext object.
      * @param identifyOptions
@@ -311,4 +316,36 @@ export interface LDClient {
      */
     addHook(hook: Hook): void;
 }
+/**
+ * Interface that extends the LDClient interface to include the identifyResult method.
+ *
+ * This is an independent interface for backwards compatibility. Adding this to the LDClient interface would require
+ * a breaking change.
+ */
+export interface LDClientIdentifyResult {
+    /**
+     * Identifies a context to LaunchDarkly and returns a promise which resolves to an object containing the result of
+     * the identify operation.
+     *
+     * Unlike the server-side SDKs, the client-side JavaScript SDKs maintain a current context state,
+     * which is set when you call `identify()`.
+     *
+     * Changing the current context also causes all feature flag values to be reloaded. Until that has
+     * finished, calls to {@link variation} will still return flag values for the previous context. You can
+     * await the Promise to determine when the new flag values are available.
+     *
+     * If used with the `sheddable` option set to true, then the identify operation will be sheddable. This means that if
+     * multiple identify operations are done, without waiting for the previous one to complete, then intermediate
+     * operations may be discarded.
+     *
+     * @param context
+     *    The LDContext object.
+     * @param identifyOptions
+     *    Optional configuration. Please see {@link LDIdentifyOptions}.
+     * @returns
+     *    A promise which resolves to an object containing the result of the identify operation.
+     *    The promise returned from this method will not be rejected.
+     */
+    identifyResult(context: LDContext, identifyOptions?: LDIdentifyOptions): Promise<LDIdentifyResult>;
+}
 //# sourceMappingURL=LDClient.d.ts.map

package/dist/cjs/api/LDClient.d.ts.map

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

package/dist/cjs/api/LDIdentifyOptions.d.ts

@@ -31,5 +31,15 @@ export interface LDIdentifyOptions {
      * not be required.
      */
     noTimeout?: boolean;
+    /**
+     * If true, the identify operation will be sheddable. This means that if multiple identify operations are started without
+     * waiting for the previous one to complete, then intermediate results will be discarded. When false, identify
+     * operations will be queued and completed sequentially.
+     *
+     * By default operations will be queued and completed sequentially.
+     *
+     * Defaults to false.
+     */
+    sheddable?: boolean;
 }
 //# sourceMappingURL=LDIdentifyOptions.d.ts.map

package/dist/cjs/api/LDIdentifyOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LDIdentifyOptions.d.ts","sourceRoot":"","sources":["../../src/api/LDIdentifyOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;OASG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"LDIdentifyOptions.d.ts","sourceRoot":"","sources":["../../src/api/LDIdentifyOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;OASG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/cjs/api/LDIdentifyResult.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The identify operation completed successfully.
+ */
+export interface LDIdentifySuccess {
+    status: 'completed';
+}
+/**
+ * The identify operation encountered an error. This could include a malformed context, or a network error.
+ */
+export interface LDIdentifyError {
+    status: 'error';
+    error: Error;
+}
+/**
+ * The identify operation timed out.
+ */
+export interface LDIdentifyTimeout {
+    status: 'timeout';
+    timeout: number;
+}
+/**
+ * The identify operation was shed.
+ */
+export interface LDIdentifyShed {
+    status: 'shed';
+}
+export type LDIdentifyResult = LDIdentifySuccess | LDIdentifyError | LDIdentifyTimeout | LDIdentifyShed;
+//# sourceMappingURL=LDIdentifyResult.d.ts.map

package/dist/cjs/api/LDIdentifyResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LDIdentifyResult.d.ts","sourceRoot":"","sources":["../../src/api/LDIdentifyResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,cAAc,CAAC"}

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

@@ -6,4 +6,5 @@ export * from './integrations';
 export { ConnectionMode };
 export * from './LDIdentifyOptions';
 export * from './LDInspection';
+export * from './LDIdentifyResult';
 //# 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"}
+{"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"}

package/dist/cjs/api/integrations/Hooks.d.ts

@@ -60,8 +60,12 @@ export interface IdentifySeriesData {
  *
  * An example in which an error may occur is lack of network connectivity
  * preventing the SDK from functioning.
+ *
+ * The SDK may also shed an identify operation if it is not needed. In which case
+ * the status will be 'shed'. For SDKs that default to non-sheddable, the status
+ * will only ever be 'shed' if the user has opted into a sheddable identify.
  */
-export type IdentifySeriesStatus = 'completed' | 'error';
+export type IdentifySeriesStatus = 'completed' | 'error' | 'shed';
 /**
  * The result applies to a single identify operation. An operation may complete
  * with an error and then later complete successfully. Only the first completion
@@ -157,6 +161,11 @@ export interface Hook {
      * This method is called during the execution of the identify process, after the operation
      * completes.
      *
+     * The beforeIdentify methods will be called in the order of the identify calls to the SDK,
+     * but afterIdentify may not be in the same order. This is because the SDK may shed an identify
+     * operation if it is not needed. This will result in the afterIdentify method potentially being
+     * called in a different order than beforeIdentify.
+     *
      * @param hookContext Contains information about the evaluation being performed. This is not
      *  mutable.
      * @param data A record associated with each stage of hook invocations. Each stage is called with

package/dist/cjs/api/integrations/Hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Hooks.d.ts","sourceRoot":"","sources":["../../../src/api/integrations/Hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAOhC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,OAAO,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,WAAW,IAAI,YAAY,CAAC;IAE5B;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,CACf,WAAW,EAAE,uBAAuB,EACpC,IAAI,EAAE,oBAAoB,GACzB,oBAAoB,CAAC;IAExB;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,CACd,WAAW,EAAE,uBAAuB,EACpC,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,kBAAkB,GACzB,oBAAoB,CAAC;IAExB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,CAAC,WAAW,EAAE,qBAAqB,EAAE,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;IAElG;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,CACZ,WAAW,EAAE,qBAAqB,EAClC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,oBAAoB,GAC3B,kBAAkB,CAAC;IAEtB;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACpD"}
+{"version":3,"file":"Hooks.d.ts","sourceRoot":"","sources":["../../../src/api/integrations/Hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAOhC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,WAAW,IAAI,YAAY,CAAC;IAE5B;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,CACf,WAAW,EAAE,uBAAuB,EACpC,IAAI,EAAE,oBAAoB,GACzB,oBAAoB,CAAC;IAExB;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,CACd,WAAW,EAAE,uBAAuB,EACpC,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,kBAAkB,GACzB,oBAAoB,CAAC;IAExB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,CAAC,WAAW,EAAE,qBAAqB,EAAE,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;IAElG;;;;;;;;;;;;;;;;;;;OAmBG;IACH,aAAa,CAAC,CACZ,WAAW,EAAE,qBAAqB,EAClC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,oBAAoB,GAC3B,kBAAkB,CAAC;IAEtB;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACpD"}

package/dist/cjs/async/AsyncTaskQueue.d.ts

@@ -24,6 +24,22 @@ export interface ErroredTask {
  * Represents the result of a task.
  */
 export type TaskResult<TTaskResult> = CompletedTask<TTaskResult> | ErroredTask | ShedTask;
+export interface Task<TTaskResult, TBeforeResult> {
+    /**
+     * Method ran before the task is executed or shed.
+     */
+    before?: () => Promise<TBeforeResult>;
+    /**
+     * Execute the task. This is not ran if the task is shed.
+     * @returns The result of the task.
+     */
+    execute: (beforeResult?: TBeforeResult) => Promise<TTaskResult>;
+    /**
+     * Method ran after the task is executed or shed.
+     * @param result The result of the task.
+     */
+    after?: (result: TaskResult<TTaskResult>, beforeResult?: TBeforeResult) => void;
+}
 /**
  * An asynchronous task queue with the ability to replace pending tasks.
  *
@@ -33,7 +49,7 @@ export type TaskResult<TTaskResult> = CompletedTask<TTaskResult> | ErroredTask |
  * For instance, the SDK can only have one active context at a time, if you request identification of many contexts,
  * then the ultimate state will be based on the last request. The intermediate identifies can be discarded.
  *
- * This class will always begin execution of the first item added to the queue, at that point the item itself is not
+ * This queue will always begin execution of the first item added to the queue, at that point the item itself is not
  * queued, but active. If another request is made while that item is still active, then it is added to the queue.
  * A third request would then replace the second request if the second request had not yet become active, and it was
  * sheddable.
@@ -49,11 +65,7 @@ export type TaskResult<TTaskResult> = CompletedTask<TTaskResult> | ErroredTask |
  * Queue management should be done synchronously. There should not be asynchronous operations between checking the queue
  * and acting on the results of said check.
  */
-export declare class AsyncTaskQueue<TTaskResult> {
-    private readonly _logger?;
-    private _activeTask?;
-    private _queue;
-    constructor(_logger?: LDLogger | undefined);
+export declare function createAsyncTaskQueue<TTaskResult>(logger?: LDLogger): {
     /**
      * Execute a task using the queue.
      *
@@ -61,7 +73,14 @@ export declare class AsyncTaskQueue<TTaskResult> {
      * @param sheddable Whether the task can be shed from the queue.
      * @returns A promise that resolves to the result of the task.
      */
-    execute(task: () => Promise<TTaskResult>, sheddable?: boolean): Promise<TaskResult<TTaskResult>>;
-    private _checkPending;
-}
+    execute<TBeforeResult>(task: Task<TTaskResult, TBeforeResult>, sheddable?: boolean): Promise<TaskResult<TTaskResult>>;
+    /**
+     * Returns the number of pending tasks in the queue.
+     * Intended for testing purposes only.
+     *
+     * @internal
+     * @returns The number of pending tasks in the queue.
+     */
+    pendingCount(): number;
+};
 //# sourceMappingURL=AsyncTaskQueue.d.ts.map

package/dist/cjs/async/AsyncTaskQueue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncTaskQueue.d.ts","sourceRoot":"","sources":["../../src/async/AsyncTaskQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,WAAW;IACxC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,WAAW,IAAI,aAAa,CAAC,WAAW,CAAC,GAAG,WAAW,GAAG,QAAQ,CAAC;AA2D1F;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,cAAc,CAAC,WAAW;IAIzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAHrC,OAAO,CAAC,WAAW,CAAC,CAAmC;IACvD,OAAO,CAAC,MAAM,CAAkC;gBAEnB,OAAO,CAAC,sBAAU;IAE/C;;;;;;OAMG;IACH,OAAO,CACL,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,EAChC,SAAS,GAAE,OAAe,GACzB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAoBnC,OAAO,CAAC,aAAa;CA6BtB"}
+{"version":3,"file":"AsyncTaskQueue.d.ts","sourceRoot":"","sources":["../../src/async/AsyncTaskQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,WAAW;IACxC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,WAAW,IAAI,aAAa,CAAC,WAAW,CAAC,GAAG,WAAW,GAAG,QAAQ,CAAC;AAa1F,MAAM,WAAW,IAAI,CAAC,WAAW,EAAE,aAAa;IAC9C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IAEtC;;;OAGG;IAEH,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAEhE;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;CACjF;AAoED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,QAAQ;IAwB/D;;;;;;OAMG;+EAGU,OAAO,GACjB,QAAQ,WAAW,WAAW,CAAC,CAAC;IAoBnC;;;;;;OAMG;oBACa,MAAM;EAIzB"}

package/dist/cjs/index.cjs

@@ -98,6 +98,143 @@ function makeRequestor(plainContextString, serviceEndpoints, paths, requests, en
     return new Requestor(requests, uri, headers, method, body);
 }
 
+const duplicateExecutionError = new Error('Task has already been executed or shed. This is likely an implementation error. The task will not be executed again.');
+/**
+ * Creates a pending task.
+ * @param task The async function to execute.
+ * @param sheddable Whether the task can be shed from the queue.
+ * @returns A pending task.
+ */
+function makePending(task, _logger, sheddable = false) {
+    let resolveTask;
+    const promise = new Promise((resolve) => {
+        resolveTask = (result, beforeResult) => {
+            try {
+                task.after?.(result, beforeResult);
+            }
+            catch (error) {
+                _logger?.error(`Error in after callback: ${error}`);
+            }
+            resolve(result);
+        };
+    });
+    const beforePromise = task.before ? task.before() : Promise.resolve(undefined);
+    let executedOrShed = false;
+    return {
+        execute: () => {
+            if (executedOrShed) {
+                // This should never happen. If it does, then it represents an implementation error in the SDK.
+                _logger?.error(duplicateExecutionError);
+            }
+            executedOrShed = true;
+            beforePromise
+                .then((beforeResult) => {
+                task
+                    .execute(beforeResult)
+                    .then((result) => resolveTask({ status: 'complete', result }, beforeResult))
+                    .catch((error) => resolveTask({ status: 'error', error }, beforeResult));
+            })
+                .catch((error) => {
+                _logger?.error(error);
+                resolveTask({ status: 'error', error }, undefined);
+            });
+        },
+        shed: () => {
+            if (executedOrShed) {
+                // This should never happen. If it does, then it represents an implementation error in the SDK.
+                _logger?.error(duplicateExecutionError);
+            }
+            executedOrShed = true;
+            beforePromise.then((beforeResult) => {
+                resolveTask({ status: 'shed' }, beforeResult);
+            });
+        },
+        promise,
+        sheddable,
+    };
+}
+/**
+ * An asynchronous task queue with the ability to replace pending tasks.
+ *
+ * This is useful when you have asynchronous operations which much execute in order, and for cases where intermediate
+ * operations can be discarded.
+ *
+ * For instance, the SDK can only have one active context at a time, if you request identification of many contexts,
+ * then the ultimate state will be based on the last request. The intermediate identifies can be discarded.
+ *
+ * This queue will always begin execution of the first item added to the queue, at that point the item itself is not
+ * queued, but active. If another request is made while that item is still active, then it is added to the queue.
+ * A third request would then replace the second request if the second request had not yet become active, and it was
+ * sheddable.
+ *
+ * Once a task is active the queue will complete it. It doesn't cancel tasks that it has started, but it can shed tasks
+ * that have not started.
+ *
+ * TTaskResult Is the return type of the task to be executed. Tasks accept no parameters. So if you need parameters
+ * you should use a lambda to capture them.
+ *
+ * Exceptions from tasks are always handled and the execute method will never reject a promise.
+ *
+ * Queue management should be done synchronously. There should not be asynchronous operations between checking the queue
+ * and acting on the results of said check.
+ */
+function createAsyncTaskQueue(logger) {
+    let activeTask;
+    const queue = [];
+    function checkPending() {
+        // There is an existing active task, so we don't need to do anything.
+        if (activeTask) {
+            return;
+        }
+        // There are pending tasks, so we need to execute the next one.
+        if (queue.length > 0) {
+            const nextTask = queue.shift();
+            activeTask = nextTask.promise.finally(() => {
+                activeTask = undefined;
+                checkPending();
+            });
+            nextTask.execute();
+        }
+    }
+    return {
+        /**
+         * Execute a task using the queue.
+         *
+         * @param task The async function to execute.
+         * @param sheddable Whether the task can be shed from the queue.
+         * @returns A promise that resolves to the result of the task.
+         */
+        execute(task, sheddable = false) {
+            const pending = makePending(task, logger, sheddable);
+            if (!activeTask) {
+                activeTask = pending.promise.finally(() => {
+                    activeTask = undefined;
+                    checkPending();
+                });
+                pending.execute();
+            }
+            else {
+                // If the last pending task is sheddable, we need to shed it before adding the new task.
+                if (queue[queue.length - 1]?.sheddable) {
+                    queue.pop()?.shed();
+                }
+                queue.push(pending);
+            }
+            return pending.promise;
+        },
+        /**
+         * Returns the number of pending tasks in the queue.
+         * Intended for testing purposes only.
+         *
+         * @internal
+         * @returns The number of pending tasks in the queue.
+         */
+        pendingCount() {
+            return queue.length;
+        },
+    };
+}
+
 // eslint-disable-next-line max-classes-per-file
 const validators = {
     logger: jsSdkCommon.TypeValidators.Object,
@@ -1212,6 +1349,7 @@ class LDClientImpl {
         this._eventFactoryDefault = new EventFactory(false);
         this._eventFactoryWithReasons = new EventFactory(true);
         this._eventSendingEnabled = false;
+        this._identifyQueue = createAsyncTaskQueue();
         if (!sdkKey) {
             throw new Error('You must configure the client with a client-side SDK key');
         }
@@ -1277,7 +1415,7 @@ class LDClientImpl {
     }
     getContext() {
         // The LDContext returned here may have been modified by the SDK (for example: adding auto env attributes).
-        // We are returning an LDContext here to maintain a consistent represetnation of context to the consuming
+        // We are returning an LDContext here to maintain a consistent representation of context to the consuming
         // code.  We are returned the unchecked context so that if a consumer identifies with an invalid context
         // and then calls getContext, they get back the same context they provided, without any assertion about
         // validity.
@@ -1286,28 +1424,25 @@ class LDClientImpl {
     getInternalContext() {
         return this._checkedContext;
     }
-    _createIdentifyPromise(timeout, noTimeout) {
+    _createIdentifyPromise() {
         let res;
         let rej;
         const basePromise = new Promise((resolve, reject) => {
             res = resolve;
             rej = reject;
         });
-        if (noTimeout) {
-            return { identifyPromise: basePromise, identifyResolve: res, identifyReject: rej };
-        }
-        const timed = jsSdkCommon.timedPromise(timeout, 'identify');
-        const raced = Promise.race([timed, basePromise]).catch((e) => {
-            if (e.message.includes('timed out')) {
-                this.logger.error(`identify error: ${e}`);
-            }
-            throw e;
-        });
-        return { identifyPromise: raced, identifyResolve: res, identifyReject: rej };
+        return { identifyPromise: basePromise, identifyResolve: res, identifyReject: rej };
     }
     /**
      * Identifies a context to LaunchDarkly. See {@link LDClient.identify}.
      *
+     * If used with the `sheddable` option set to true, then the identify operation will be sheddable. This means that if
+     * multiple identify operations are done, without waiting for the previous one to complete, then intermediate
+     * operations may be discarded.
+     *
+     * It is recommended to use the `identifyResult` method instead when the operation is sheddable. In a future release,
+     * all identify operations will default to being sheddable.
+     *
      * @param pristineContext The LDContext object to be identified.
      * @param identifyOptions Optional configuration. See {@link LDIdentifyOptions}.
      * @returns A Promise which resolves when the flag values for the specified
@@ -1321,39 +1456,95 @@ class LDClientImpl {
      * 3. A network error is encountered during initialization.
      */
     async identify(pristineContext, identifyOptions) {
+        // In order to manage customization in the derived classes it is important that `identify` MUST be implemented in
+        // terms of `identifyResult`. So that the logic of the identification process can be extended in one place.
+        const result = await this.identifyResult(pristineContext, identifyOptions);
+        if (result.status === 'error') {
+            throw result.error;
+        }
+        else if (result.status === 'timeout') {
+            const timeoutError = new jsSdkCommon.LDTimeoutError(`identify timed out after ${result.timeout} seconds.`);
+            this.logger.error(timeoutError.message);
+            throw timeoutError;
+        }
+        // If completed or shed, then we are done.
+    }
+    async identifyResult(pristineContext, identifyOptions) {
         const identifyTimeout = identifyOptions?.timeout ?? DEFAULT_IDENTIFY_TIMEOUT_SECONDS;
         const noTimeout = identifyOptions?.timeout === undefined && identifyOptions?.noTimeout === true;
-        // When noTimeout is specified, and a timeout is not secified, then this condition cannot
+        // When noTimeout is specified, and a timeout is not specified, then this condition cannot
         // be encountered. (Our default would need to be greater)
         if (identifyTimeout > this._highTimeoutThreshold) {
             this.logger.warn('The identify function was called with a timeout greater than ' +
                 `${this._highTimeoutThreshold} seconds. We recommend a timeout of less than ` +
                 `${this._highTimeoutThreshold} seconds.`);
         }
-        let context = await ensureKey(pristineContext, this.platform);
-        if (this.autoEnvAttributes === jsSdkCommon.AutoEnvAttributes.Enabled) {
-            context = await addAutoEnv(context, this.platform, this._config);
-        }
-        const checkedContext = jsSdkCommon.Context.fromLDContext(context);
-        if (!checkedContext.valid) {
-            const error = new Error('Context was unspecified or had no key');
-            this.emitter.emit('error', context, error);
-            return Promise.reject(error);
-        }
-        this._uncheckedContext = context;
-        this._checkedContext = checkedContext;
-        this._eventProcessor?.sendEvent(this._eventFactoryDefault.identifyEvent(this._checkedContext));
-        const { identifyPromise, identifyResolve, identifyReject } = this._createIdentifyPromise(identifyTimeout, noTimeout);
-        this.logger.debug(`Identifying ${JSON.stringify(this._checkedContext)}`);
-        const afterIdentify = this._hookRunner.identify(context, identifyOptions?.timeout);
-        await this.dataManager.identify(identifyResolve, identifyReject, checkedContext, identifyOptions);
-        return identifyPromise.then((res) => {
-            afterIdentify({ status: 'completed' });
-            return res;
-        }, (e) => {
-            afterIdentify({ status: 'error' });
-            throw e;
+        const callSitePromise = this._identifyQueue
+            .execute({
+            before: async () => {
+                let context = await ensureKey(pristineContext, this.platform);
+                if (this.autoEnvAttributes === jsSdkCommon.AutoEnvAttributes.Enabled) {
+                    context = await addAutoEnv(context, this.platform, this._config);
+                }
+                const checkedContext = jsSdkCommon.Context.fromLDContext(context);
+                if (checkedContext.valid) {
+                    const afterIdentify = this._hookRunner.identify(context, identifyOptions?.timeout);
+                    return {
+                        context,
+                        checkedContext,
+                        afterIdentify,
+                    };
+                }
+                return {
+                    context,
+                    checkedContext,
+                };
+            },
+            execute: async (beforeResult) => {
+                const { context, checkedContext } = beforeResult;
+                if (!checkedContext.valid) {
+                    const error = new Error('Context was unspecified or had no key');
+                    this.emitter.emit('error', context, error);
+                    return Promise.reject(error);
+                }
+                this._uncheckedContext = context;
+                this._checkedContext = checkedContext;
+                this._eventProcessor?.sendEvent(this._eventFactoryDefault.identifyEvent(this._checkedContext));
+                const { identifyPromise, identifyResolve, identifyReject } = this._createIdentifyPromise();
+                this.logger.debug(`Identifying ${JSON.stringify(this._checkedContext)}`);
+                await this.dataManager.identify(identifyResolve, identifyReject, checkedContext, identifyOptions);
+                return identifyPromise;
+            },
+            after: async (res, beforeResult) => {
+                if (res.status === 'complete') {
+                    beforeResult?.afterIdentify?.({ status: 'completed' });
+                }
+                else if (res.status === 'shed') {
+                    beforeResult?.afterIdentify?.({ status: 'shed' });
+                }
+                else if (res.status === 'error') {
+                    beforeResult?.afterIdentify?.({ status: 'error' });
+                }
+            },
+        }, identifyOptions?.sheddable ?? false)
+            .then((res) => {
+            if (res.status === 'error') {
+                return { status: 'error', error: res.error };
+            }
+            if (res.status === 'shed') {
+                return { status: 'shed' };
+            }
+            return { status: 'completed' };
+        });
+        if (noTimeout) {
+            return callSitePromise;
+        }
+        const timeoutPromise = new Promise((resolve) => {
+            setTimeout(() => {
+                resolve({ status: 'timeout', timeout: identifyTimeout });
+            }, identifyTimeout * 1000);
         });
+        return Promise.race([callSitePromise, timeoutPromise]);
     }
     on(eventName, listener) {
         this.emitter.on(eventName, listener);