@launchdarkly/js-sdk-common 2.16.0 → 2.17.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to `@launchdarkly/js-sdk-common` will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org).
 
+## [2.17.0](https://github.com/launchdarkly/js-core/compare/js-sdk-common-v2.16.0...js-sdk-common-v2.17.0) (2025-04-29)
+
+
+### Features
+
+* Add client-side SDK plugin support. ([#834](https://github.com/launchdarkly/js-core/issues/834)) ([a843a33](https://github.com/launchdarkly/js-core/commit/a843a33e97dcab706a0034bd1fd1e3d2f78a9262))
+
 ## [2.16.0](https://github.com/launchdarkly/js-core/compare/js-sdk-common-v2.15.0...js-sdk-common-v2.16.0) (2025-04-16)
 
 

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

@@ -4,4 +4,5 @@ export * from './data';
 export * from './options';
 export * from './platform';
 export * as subsystem from './subsystem';
+export * from './integrations';
 //# 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,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,cAAc,gBAAgB,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from './plugins';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/integrations/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

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

@@ -0,0 +1,128 @@
+/**
+ * Meta-data about a plugin implementation.
+ *
+ * May be used in logs and analytics to identify the plugin.
+ */
+export interface LDPluginMetadata {
+    /**
+     * The name of the plugin.
+     */
+    readonly name: string;
+}
+/**
+ * Metadata about the SDK that is running the plugin.
+ */
+export interface LDPluginSdkMetadata {
+    /**
+     * The name of the SDK.
+     */
+    readonly name: string;
+    /**
+     * The version of the SDK.
+     */
+    readonly version: string;
+    /**
+     * If this is a wrapper SDK, then this is the name of the wrapper.
+     */
+    readonly wrapperName?: string;
+    /**
+     * If this is a wrapper SDK, then this is the version of the wrapper.
+     */
+    readonly wrapperVersion?: string;
+}
+/**
+ * Metadata about the application where the LaunchDarkly SDK is running.
+ */
+export interface LDPluginApplicationMetadata {
+    /**
+     * A unique identifier representing the application where the LaunchDarkly SDK is running.
+     *
+     * This can be specified as any string value as long as it only uses the following characters: ASCII letters,
+     * ASCII digits, period, hyphen, underscore. A string containing any other characters will be ignored.
+     *
+     * Example: `authentication-service`
+     */
+    readonly id?: string;
+    /**
+     * A unique identifier representing the version of the application where the LaunchDarkly SDK is running.
+     *
+     * This can be specified as any string value as long as it only uses the following characters: ASCII letters,
+     * ASCII digits, period, hyphen, underscore. A string containing any other characters will be ignored.
+     *
+     * Example: `1.0.0` (standard version string) or `abcdef` (sha prefix)
+     */
+    readonly version?: string;
+    /**
+     * A human-friendly application name representing the application where the LaunchDarkly SDK is running.
+     *
+     * This can be specified as any string value as long as it only uses the following characters: ASCII letters,
+     * ASCII digits, period, hyphen, underscore. A string containing any other characters will be ignored.
+     */
+    readonly name?: string;
+    /**
+     * A human-friendly name representing the version of the application where the LaunchDarkly SDK is running.
+     *
+     * This can be specified as any string value as long as it only uses the following characters: ASCII letters,
+     * ASCII digits, period, hyphen, underscore. A string containing any other characters will be ignored.
+     */
+    readonly versionName?: string;
+}
+/**
+ * Metadata about the environment where the plugin is running.
+ */
+export interface LDPluginEnvironmentMetadata {
+    /**
+     * Metadata about the SDK that is running the plugin.
+     */
+    readonly sdk: LDPluginSdkMetadata;
+    /**
+     * Metadata about the application where the LaunchDarkly SDK is running.
+     *
+     * Only present if any application information is available.
+     */
+    readonly application?: LDPluginApplicationMetadata;
+    /**
+     * Present if the SDK is a client-side SDK running in a web environment.
+     */
+    readonly clientSideId?: string;
+    /**
+     * Present if the SDK is a client-side SDK running in a mobile environment.
+     */
+    readonly mobileKey?: string;
+    /**
+     * Present if the SDK is a server-side SDK.
+     */
+    readonly sdkKey?: string;
+}
+/**
+ * Interface for plugins to the LaunchDarkly SDK.
+ *
+ * This is the base interface common to client-side and server-side SDKs. This interface should be re-exported by SDKs
+ * using the specific SDK's client type for the `TClient` parameter, and the specific SDK's hook type for the `THook` parameter.
+ */
+export interface LDPluginBase<TClient, THook> {
+    /**
+     * Get metadata about the plugin.
+     */
+    getMetadata(): LDPluginMetadata;
+    /**
+     * Registers the plugin with the SDK. Called once during SDK initialization.
+     *
+     * The SDK initialization will typically not have been completed at this point, so the plugin should take appropriate
+     * actions to ensure the SDK is ready before sending track events or evaluating flags.
+     *
+     * @param client The SDK client instance.
+     * @param environmentMetadata Information about the environment where the plugin is running.
+     */
+    register(client: TClient, environmentMetadata: LDPluginEnvironmentMetadata): void;
+    /**
+     * Gets a list of hooks that the plugin wants to register.
+     *
+     * This method will be called once during SDK initialization before the register method is called.
+     *
+     * If the plugin does not need to register any hooks, this method doesn't need to be implemented.
+     * @param metadata
+     */
+    getHooks?(metadata: LDPluginEnvironmentMetadata): THook[];
+}
+//# sourceMappingURL=plugins.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../src/api/integrations/plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC;IAElC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAEnD;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY,CAAC,OAAO,EAAE,KAAK;IAC1C;;OAEG;IACH,WAAW,IAAI,gBAAgB,CAAC;IAEhC;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAElF;;;;;;;OAOG;IACH,QAAQ,CAAC,CAAC,QAAQ,EAAE,2BAA2B,GAAG,KAAK,EAAE,CAAC;CAC3D"}

package/dist/cjs/api/subsystem/DataSystem/CallbackHandler.d.ts

@@ -0,0 +1,16 @@
+import { DataSourceState } from './DataSource';
+/**
+ * Handler that connects the current {@link DataSource} to the {@link CompositeDataSource}.  A single
+ * {@link CallbackHandler} should only be given to one {@link DataSource}.  Use {@link disable()} to
+ * prevent additional callback events.
+ */
+export declare class CallbackHandler {
+    private readonly _dataCallback;
+    private readonly _statusCallback;
+    private _disabled;
+    constructor(_dataCallback: (basis: boolean, data: any) => void, _statusCallback: (status: DataSourceState, err?: any) => void);
+    disable(): void;
+    dataHandler(basis: boolean, data: any): Promise<void>;
+    statusHandler(status: DataSourceState, err?: any): Promise<void>;
+}
+//# sourceMappingURL=CallbackHandler.d.ts.map

package/dist/cjs/api/subsystem/DataSystem/CallbackHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallbackHandler.d.ts","sourceRoot":"","sources":["../../../../src/api/subsystem/DataSystem/CallbackHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAJlC,OAAO,CAAC,SAAS,CAAkB;gBAGhB,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,EAClD,eAAe,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI;IAGhF,OAAO;IAID,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG;IAUrC,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG;CAOvD"}

package/dist/cjs/api/subsystem/DataSystem/DataSource.d.ts

@@ -0,0 +1,21 @@
+export declare enum DataSourceState {
+    Valid = 0,
+    Initializing = 1,
+    Interrupted = 2,
+    Closed = 3
+}
+export interface DataSource {
+    /**
+     * May be called any number of times, if already started, has no effect
+     * @param dataCallback that will be called when data arrives, may be called multiple times.
+     * @param statusCallback that will be called when data source state changes or an unrecoverable error
+     * has been encountered.
+     */
+    start(dataCallback: (basis: boolean, data: any) => void, statusCallback: (status: DataSourceState, err?: any) => void): void;
+    /**
+     * May be called any number of times, if already stopped, has no effect.
+     */
+    stop(): void;
+}
+export type LDDataSourceFactory = () => DataSource;
+//# sourceMappingURL=DataSource.d.ts.map

package/dist/cjs/api/subsystem/DataSystem/DataSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataSource.d.ts","sourceRoot":"","sources":["../../../../src/api/subsystem/DataSystem/DataSource.ts"],"names":[],"mappings":"AACA,oBAAY,eAAe;IAEzB,KAAK,IAAA;IAEL,YAAY,IAAA;IAEZ,WAAW,IAAA;IAEX,MAAM,IAAA;CACP;AAED,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,KAAK,CACH,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,EACjD,cAAc,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,GAC3D,IAAI,CAAC;IAER;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,2 @@
+export { DataSource, DataSourceState, LDDataSourceFactory } from './DataSource';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/api/subsystem/DataSystem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/subsystem/DataSystem/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

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

@@ -1,6 +1,7 @@
+import { DataSource, DataSourceState, LDDataSourceFactory } from './DataSystem';
 import LDContextDeduplicator from './LDContextDeduplicator';
 import LDEventProcessor from './LDEventProcessor';
 import LDEventSender, { LDDeliveryStatus, LDEventSenderResult, LDEventType } from './LDEventSender';
 import { LDStreamProcessor } from './LDStreamProcessor';
-export { LDEventProcessor, LDContextDeduplicator, LDEventSender, LDDeliveryStatus, LDEventType, LDEventSenderResult, LDStreamProcessor, };
+export { DataSource, DataSourceState, LDDataSourceFactory, LDEventProcessor, LDContextDeduplicator, LDEventSender, LDDeliveryStatus, LDEventType, LDEventSenderResult, LDStreamProcessor, };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/subsystem/index.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAClD,OAAO,aAAa,EAAE,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,iBAAiB,GAClB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/subsystem/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,qBAAqB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAClD,OAAO,aAAa,EAAE,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EACL,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,iBAAiB,GAClB,CAAC"}

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

@@ -0,0 +1,46 @@
+export interface Backoff {
+    success(): void;
+    fail(): number;
+}
+/**
+ * Implements exponential backoff and jitter. This class tracks successful connections and failures
+ * and produces a retry delay.
+ *
+ * It does not start any timers or directly control a connection.
+ *
+ * The backoff follows an exponential backoff scheme with 50% jitter starting at
+ * initialRetryDelayMillis and capping at MAX_RETRY_DELAY.  If RESET_INTERVAL has elapsed after a
+ * success, without an intervening faulure, then the backoff is reset to initialRetryDelayMillis.
+ */
+export declare class DefaultBackoff {
+    private readonly _retryResetIntervalMillis;
+    private readonly _random;
+    private _retryCount;
+    private _activeSince?;
+    private _initialRetryDelayMillis;
+    /**
+     * The exponent at which the backoff delay will exceed the maximum.
+     * Beyond this limit the backoff can be set to the max.
+     */
+    private readonly _maxExponent;
+    constructor(initialRetryDelayMillis: number, _retryResetIntervalMillis: number, _random?: () => number);
+    private _backoff;
+    private _jitter;
+    /**
+     * This function should be called when a connection attempt is successful.
+     *
+     * @param timeStampMs The time of the success. Used primarily for testing, when not provided
+     * the current time is used.
+     */
+    success(timeStampMs?: number): void;
+    /**
+     * This function should be called when a connection fails. It returns the a delay, in
+     * milliseconds, after which a reconnection attempt should be made.
+     *
+     * @param timeStampMs The time of the success. Used primarily for testing, when not provided
+     * the current time is used.
+     * @returns The delay before the next connection attempt.
+     */
+    fail(timeStampMs?: number): number;
+}
+//# sourceMappingURL=Backoff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Backoff.d.ts","sourceRoot":"","sources":["../../src/datasource/Backoff.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,OAAO,IAAI,IAAI,CAAC;IAChB,IAAI,IAAI,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IAYvB,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ1B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,wBAAwB,CAAS;IACzC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAGpC,uBAAuB,EAAE,MAAM,EACd,yBAAyB,EAAE,MAAM,EACjC,OAAO,eAAc;IAOxC,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,OAAO;IAIf;;;;;OAKG;IACH,OAAO,CAAC,WAAW,GAAE,MAAmB,GAAG,IAAI;IAI/C;;;;;;;OAOG;IACH,IAAI,CAAC,WAAW,GAAE,MAAmB,GAAG,MAAM;CAc/C"}

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

@@ -0,0 +1,62 @@
+import { LDLogger } from '../api/logging';
+import { DataSource, DataSourceState, LDDataSourceFactory } from '../api/subsystem/DataSystem/DataSource';
+import { Backoff } from './Backoff';
+/**
+ * Represents a transition between data sources.
+ */
+export type Transition = 'switchToSync' | 'fallback' | 'recover' | 'stop';
+/**
+ * Given a {@link DataSourceState}, how long to wait before transitioning.
+ */
+export type TransitionConditions = {
+    [k in DataSourceState]?: {
+        durationMS: number;
+        transition: Transition;
+    };
+};
+/**
+ * The {@link CompositeDataSource} can combine a number of {@link DataSystemInitializer}s and {@link DataSystemSynchronizer}s
+ * into a single {@link DataSource}, implementing fallback and recovery logic internally to choose where data is sourced from.
+ */
+export declare class CompositeDataSource implements DataSource {
+    private readonly _logger?;
+    private readonly _transitionConditions;
+    private readonly _backoff;
+    private _initPhaseActive;
+    private _initFactories;
+    private _syncFactories;
+    private _stopped;
+    private _externalTransitionPromise;
+    private _externalTransitionResolve?;
+    private _cancelTokens;
+    /**
+     * @param initializers factories to create {@link DataSystemInitializer}s, in priority order.
+     * @param synchronizers factories to create  {@link DataSystemSynchronizer}s, in priority order.
+     */
+    constructor(initializers: LDDataSourceFactory[], synchronizers: LDDataSourceFactory[], _logger?: LDLogger | undefined, _transitionConditions?: TransitionConditions, _backoff?: Backoff);
+    start(dataCallback: (basis: boolean, data: any) => void, statusCallback: (status: DataSourceState, err?: any) => void): Promise<void>;
+    stop(): Promise<void>;
+    private _reset;
+    /**
+     * Determines the next datasource and returns that datasource as well as a closure to cull the
+     * datasource from the datasource lists. One example where the cull closure is invoked is if the
+     * datasource has an unrecoverable error.
+     */
+    private _pickDataSource;
+    /**
+     * @returns the transition condition for the provided data source state or undefined
+     * if there is no transition condition
+     */
+    private _lookupTransitionCondition;
+    private _cancellableDelay;
+    private _consumeCancelToken;
+    /**
+     * This wrapper will ensure the following:
+     *
+     * Don't report DataSourceState.Initializing except as first status callback.
+     * Map underlying DataSourceState.Closed to interrupted.
+     * Don't report the same status and error twice in a row.
+     */
+    private _wrapStatusCallbackWithSanitizer;
+}
+//# sourceMappingURL=CompositeDataSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeDataSource.d.ts","sourceRoot":"","sources":["../../src/datasource/CompositeDataSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EACL,UAAU,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAMpD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;KAChC,CAAC,IAAI,eAAe,CAAC,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE;CACxE,CAAC;AAOF;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,UAAU;IAoBlD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAUtC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IA3B3B,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,cAAc,CAAsC;IAE5D,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,0BAA0B,CAAC,CAAqC;IACxE,OAAO,CAAC,aAAa,CAAsB;IAE3C;;;OAGG;gBAED,YAAY,EAAE,mBAAmB,EAAE,EACnC,aAAa,EAAE,mBAAmB,EAAE,EACnB,OAAO,CAAC,sBAAU,EAClB,qBAAqB,GAAE,oBASvC,EACgB,QAAQ,GAAE,OAAyC;IAUhE,KAAK,CACT,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,EACjD,cAAc,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,GAC3D,OAAO,CAAC,IAAI,CAAC;IAgJV,IAAI;IAMV,OAAO,CAAC,MAAM;IAWd;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAoDvB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAclC,OAAO,CAAC,iBAAiB,CAcvB;IAEF,OAAO,CAAC,mBAAmB;IAQ3B;;;;;;OAMG;IACH,OAAO,CAAC,gCAAgC;CAgCzC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Helper class for {@link CompositeDataSource} to manage iterating on data sources and removing them on the fly.
+ */
+export declare class DataSourceList<T> {
+    private _list;
+    private _circular;
+    private _pos;
+    /**
+     * @param circular whether to loop off the end of the list back to the start
+     * @param initialList of content
+     */
+    constructor(circular: boolean, initialList?: T[]);
+    /**
+     * Returns the current head and then iterates.
+     */
+    next(): T | undefined;
+    /**
+     * Replaces all elements with the provided list and resets the position of head to the start.
+     *
+     * @param input that will replace existing list
+     */
+    replace(input: T[]): void;
+    /**
+     * Removes the provided element from the list. If the removed element was the head, head moves to next. Consider head may be undefined if list is empty after removal.
+     *
+     * @param element to remove
+     * @returns true if element was removed
+     */
+    remove(element: T): boolean;
+    /**
+     * Reset the head position to the start of the list.
+     */
+    reset(): void;
+    /**
+     * @returns the current head position in the list, 0 indexed.
+     */
+    pos(): number;
+    /**
+     * @returns the current length of the list
+     */
+    length(): number;
+    /**
+     * Clears the list and resets head.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=dataSourceList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataSourceList.d.ts","sourceRoot":"","sources":["../../src/datasource/dataSourceList.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAc,CAAC,CAAC;IAC3B,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,IAAI,CAAS;IAErB;;;OAGG;gBACS,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE;IAMhD;;OAEG;IACH,IAAI,IAAI,CAAC,GAAG,SAAS;IAgBrB;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAKzB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO;IAoB3B;;OAEG;IACH,KAAK;IAIL;;OAEG;IACH,GAAG;IAIH;;OAEG;IACH,MAAM;IAIN;;OAEG;IACH,KAAK;CAIN"}

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

@@ -1,4 +1,6 @@
+import { Backoff, DefaultBackoff } from './Backoff';
+import { CompositeDataSource } from './CompositeDataSource';
 import { DataSourceErrorKind } from './DataSourceErrorKinds';
 import { LDFileDataSourceError, LDPollingError, LDStreamingError, StreamingErrorHandler } from './errors';
-export { DataSourceErrorKind, LDFileDataSourceError, LDPollingError, LDStreamingError, StreamingErrorHandler, };
+export { Backoff, CompositeDataSource, DefaultBackoff, DataSourceErrorKind, LDFileDataSourceError, LDPollingError, LDStreamingError, StreamingErrorHandler, };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/datasource/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,GACtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/datasource/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,GACtB,CAAC"}