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

package/dist/esm/api/LDOptions.d.ts

@@ -0,0 +1,246 @@
+import type { LDLogger } from '@launchdarkly/js-sdk-common';
+import { Hook } from './integrations/Hooks';
+import { LDInspection } from './LDInspection';
+export interface LDOptions {
+    /**
+     * Whether all context attributes (except the context key) should be marked as private, and
+     * not sent to LaunchDarkly in analytics events.
+     *
+     * @defaultValue false.
+     */
+    allAttributesPrivate?: boolean;
+    /**
+     * Information about the application the LaunchDarkly SDK is running in.
+     *
+     * These properties are optional and informational. They may be used in LaunchDarkly
+     * analytics or other product features.
+     */
+    applicationInfo?: {
+        /**
+         * 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`
+         */
+        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)
+         */
+        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.
+         */
+        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.
+         */
+        versionName?: string;
+    };
+    /**
+     * The base uri for the LaunchDarkly server. Most users should use the default value.
+     *
+     * @defaultValue https://clientsdk.launchdarkly.com.
+     */
+    baseUri?: string;
+    /**
+     * The capacity of the analytics events queue.
+     *
+     * The client buffers up to this many events in memory before flushing. If the capacity is exceeded
+     * before the queue is flushed, events will be discarded. Increasing the capacity means that events
+     * are less likely to be discarded, at the cost of consuming more memory. Note that in regular usage
+     * flag evaluations do not produce individual events, only summary counts, so you only need a large
+     * capacity if you are generating a large number of click, pageview, or identify events (or if you
+     * are using the event debugger).
+     *
+     * @defaultValue 100.
+     */
+    capacity?: number;
+    /**
+     * Enables debug logging.
+     *
+     * @defaultValue false.
+     */
+    debug?: boolean;
+    /**
+     * Set to true to opt out of sending diagnostics data.
+     *
+     * Unless `diagnosticOptOut` is set to true, the client will send some diagnostics data to the LaunchDarkly
+     * servers in order to assist in the development of future SDK improvements. These diagnostics consist of
+     * an initial payload containing some details of SDK in use, the SDK's configuration, and the platform the
+     * SDK is being run on, as well as payloads sent periodically with information on irregular occurrences such
+     * as dropped events.
+     *
+     * @defaultValue false.
+     */
+    diagnosticOptOut?: boolean;
+    /**
+     * The interval at which periodic diagnostic data is sent, in seconds.
+     *
+     * The default is 900 (every 15 minutes) and the minimum value is 6. See {@link diagnosticOptOut}
+     * for more information on the diagnostics data being sent.
+     *
+     * @defaultValue 900s.
+     */
+    diagnosticRecordingInterval?: number;
+    /**
+     * The base uri for the LaunchDarkly events server. Most users should use the default value.
+     *
+     * @defaultValue https://events.launchdarkly.com.
+     */
+    eventsUri?: string;
+    /**
+     * The interval in between flushes of the analytics events queue, in seconds.
+     *
+     * @defaultValue 2s for browser implementations 30s for others.
+     */
+    flushInterval?: number;
+    /**
+     * An object that will perform logging for the client.
+     *
+     * @remarks
+     * Set a custom {@link LDLogger} if you want full control of logging behavior.
+     *
+     * @defaultValue A {@link BasicLogger} which outputs to the console at `info` level.
+     */
+    logger?: LDLogger;
+    /**
+     * The maximum number of locally cached contexts.  The cache is used to decrease initialization
+     * latency and to provide fallback when the SDK cannot reach LaunchDarkly services.
+     *
+     * @defaultValue 5
+     */
+    maxCachedContexts?: number;
+    /**
+     * Specifies a list of attribute names (either built-in or custom) which should be marked as
+     * private, and not sent to LaunchDarkly in analytics events. You can also specify this on a
+     * per-context basis with {@link LDContextMeta.privateAttributes}.
+     *
+     * Any contexts sent to LaunchDarkly with this configuration active will have attributes with
+     * these names removed in analytic events. This is in addition to any attributes that were
+     * marked as private for an individual context with {@link LDContextMeta.privateAttributes}.
+     * Setting {@link LDOptions.allAttributesPrivate} to true overrides this.
+     *
+     * If and only if a parameter starts with a slash, it is interpreted as a slash-delimited path
+     * that can denote a nested property within a JSON object. For instance, "/address/street" means
+     * that if there is an attribute called "address" that is a JSON object, and one of the object's
+     * properties is "street", the "street" property will be redacted from the analytics data but
+     * other properties within "address" will still be sent. This syntax also uses the JSON Pointer
+     * convention of escaping a literal slash character as "~1" and a tilde as "~0".
+     */
+    privateAttributes?: Array<string>;
+    /**
+     * Whether to send analytics events back to LaunchDarkly.
+     *
+     * @defaultValue true.
+     */
+    sendEvents?: boolean;
+    /**
+     * Sets the initial reconnect delay for the streaming connection, in seconds.
+     *
+     * The streaming service uses a backoff algorithm (with jitter) every time the connection needs
+     * to be reestablished. The delay for the first reconnection will start near this value, and then
+     * increase exponentially for any subsequent connection failures.
+     *
+     * @defaultValue 1s.
+     */
+    streamInitialReconnectDelay?: number;
+    /**
+     * The base uri for the LaunchDarkly streaming server. Most users should use the default value.
+     *
+     * @defaultValue https://clientstream.launchdarkly.com.
+     */
+    streamUri?: string;
+    /**
+     * The time between polling requests, in seconds. Ignored in streaming mode.
+     *
+     * The minimum polling interval is 30 seconds.
+     */
+    pollInterval?: number;
+    /**
+     * Directs the SDK to use the REPORT method for HTTP requests instead of GET. (Default: `false`)
+     *
+     * This setting applies both to requests to the streaming service, as well as flag requests when the SDK is in polling
+     * mode.
+     */
+    useReport?: boolean;
+    /**
+     * Whether LaunchDarkly should provide additional information about how flag values were
+     * calculated.
+     *
+     * The additional information will then be available through the client's
+     * {@link LDClient.variationDetail} method. Since this increases the size of network requests,
+     * such information is not sent unless you set this option to true.
+     *
+     * @defaultValue false.
+     */
+    withReasons?: boolean;
+    /**
+     * For use by wrapper libraries to set an identifying name for the wrapper being used.
+     *
+     * This will be sent as diagnostic information to the LaunchDarkly servers to allow recording
+     * metrics on the usage of these wrapper libraries.
+     */
+    wrapperName?: string;
+    /**
+     * For use by wrapper libraries to set version to be included alongside `wrapperName`.
+     *
+     * If `wrapperName` is unset, this field will be ignored.
+     */
+    wrapperVersion?: string;
+    /**
+     * LaunchDarkly Server SDKs historically downloaded all flag configuration and segments for a particular environment
+     * during initialization.
+     *
+     * For some customers, this is an unacceptably large amount of data, and has contributed to performance issues
+     * within their products.
+     *
+     * Filtered environments aim to solve this problem. By allowing customers to specify subsets of an environment's
+     * flags using a filter key, SDKs will initialize faster and use less memory.
+     *
+     * This payload filter key only applies to the default streaming and polling data sources. It will not affect
+     * TestData or FileData data sources, nor will it be applied to any data source provided through the featureStore
+     * config property.
+     */
+    payloadFilterKey?: string;
+    /**
+     * Initial set of hooks for the client.
+     *
+     * Hooks provide entrypoints which allow for observation of SDK functions.
+     *
+     * LaunchDarkly provides integration packages, and most applications will not
+     * need to implement their own hooks. Refer to the `@launchdarkly/node-server-sdk-otel`
+     * for instrumentation for the `@launchdarkly/node-server-sdk`.
+     *
+     * Example:
+     * ```typescript
+     * import { init } from '@launchdarkly/node-server-sdk';
+     * import { TheHook } from '@launchdarkly/some-hook';
+     *
+     * const client = init('my-sdk-key', { hooks: [new TheHook()] });
+     * ```
+     */
+    hooks?: Hook[];
+    /**
+     * Inspectors can be used for collecting information for monitoring, analytics, and debugging.
+     *
+     *
+     * @deprecated Hooks should be used instead of inspectors and inspectors will be removed in
+     * a future version. If you need functionality that is not exposed using hooks, then please
+     * let us know through a github issue or support.
+     */
+    inspectors?: LDInspection[];
+}
+//# sourceMappingURL=LDOptions.d.ts.map

package/dist/esm/api/LDOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LDOptions.d.ts","sourceRoot":"","sources":["../../src/api/LDOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;;OAKG;IACH,eAAe,CAAC,EAAE;QAChB;;;;;;;WAOG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ;;;;;;;WAOG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB;;;;;WAKG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;;;;WAKG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;;OAOG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;IAElB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;;;;;;;;OAgBG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAElC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;;;;OAQG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAEf;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B"}

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

@@ -0,0 +1,8 @@
+import ConnectionMode from './ConnectionMode';
+export * from './LDOptions';
+export * from './LDClient';
+export * from './LDEvaluationDetail';
+export * from './integrations';
+export { ConnectionMode };
+export * from './LDIdentifyOptions';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,133 @@
+import { LDContext } from '@launchdarkly/js-sdk-common';
+import { LDEvaluationDetail } from '../LDEvaluationDetail';
+/**
+ * Contextual information provided to evaluation stages.
+ */
+export interface EvaluationSeriesContext {
+    readonly flagKey: string;
+    /**
+     * Optional in case evaluations are performed before a context is set.
+     */
+    readonly context?: LDContext;
+    readonly defaultValue: unknown;
+}
+/**
+ * Implementation specific hook data for evaluation stages.
+ *
+ * Hook implementations can use this to store data needed between stages.
+ */
+export interface EvaluationSeriesData {
+    readonly [index: string]: unknown;
+}
+/**
+ * Meta-data about a hook implementation.
+ */
+export interface HookMetadata {
+    readonly name: string;
+}
+/**
+ * Contextual information provided to evaluation stages.
+ */
+export interface IdentifySeriesContext {
+    readonly context: LDContext;
+    /**
+     * The timeout, in seconds, associated with the identify operation.
+     */
+    readonly timeout?: number;
+}
+/**
+ * Implementation specific hook data for evaluation stages.
+ *
+ * Hook implementations can use this to store data needed between stages.
+ */
+export interface IdentifySeriesData {
+    readonly [index: string]: unknown;
+}
+/**
+ * The status an identify operation completed with.
+ */
+export type IdentifySeriesStatus = 'completed' | 'error';
+/**
+ * The result applies to a single identify operation. An operation may complete
+ * with an error and then later complete successfully. Only the first completion
+ * will be executed in the evaluation series.
+ */
+export interface IdentifySeriesResult {
+    status: IdentifySeriesStatus;
+}
+/**
+ * Interface for extending SDK functionality via hooks.
+ */
+export interface Hook {
+    /**
+     * Get metadata about the hook implementation.
+     */
+    getMetadata(): HookMetadata;
+    /**
+     * This method is called during the execution of a variation method
+     * before the flag value has been determined. The method is executed synchronously.
+     *
+     * @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
+     * the data of the previous stage for a series. The input record should not be modified.
+     * @returns Data to use when executing the next state of the hook in the evaluation series. It is
+     * recommended to expand the previous input into the return. This helps ensure your stage remains
+     * compatible moving forward as more stages are added.
+     * ```js
+     * return {...data, "my-new-field": /*my data/*}
+     * ```
+     */
+    beforeEvaluation?(hookContext: EvaluationSeriesContext, data: EvaluationSeriesData): EvaluationSeriesData;
+    /**
+     * This method is called during the execution of the variation method
+     * after the flag value has been determined. The method is executed synchronously.
+     *
+     * @param hookContext Contains read-only information about the evaluation
+     * being performed.
+     * @param data A record associated with each stage of hook invocations. Each
+     *  stage is called with the data of the previous stage for a series.
+     * @param detail The result of the evaluation. This value should not be
+     * modified.
+     * @returns Data to use when executing the next state of the hook in the evaluation series. It is
+     * recommended to expand the previous input into the return. This helps ensure your stage remains
+     * compatible moving forward as more stages are added.
+     * ```js
+     * return {...data, "my-new-field": /*my data/*}
+     * ```
+     */
+    afterEvaluation?(hookContext: EvaluationSeriesContext, data: EvaluationSeriesData, detail: LDEvaluationDetail): EvaluationSeriesData;
+    /**
+     * This method is called during the execution of the identify process before the operation
+     * completes, but after any context modifications are performed.
+     *
+     * @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
+     * the data of the previous stage for a series. The input record should not be modified.
+     * @returns Data to use when executing the next state of the hook in the evaluation series. It is
+     * recommended to expand the previous input into the return. This helps ensure your stage remains
+     * compatible moving forward as more stages are added.
+     * ```js
+     * return {...data, "my-new-field": /*my data/*}
+     * ```
+     */
+    beforeIdentify?(hookContext: IdentifySeriesContext, data: IdentifySeriesData): IdentifySeriesData;
+    /**
+     * This method is called during the execution of the identify process before the operation
+     * completes, but after any context modifications are performed.
+     *
+     * @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
+     * the data of the previous stage for a series. The input record should not be modified.
+     * @returns Data to use when executing the next state of the hook in the evaluation series. It is
+     * recommended to expand the previous input into the return. This helps ensure your stage remains
+     * compatible moving forward as more stages are added.
+     * ```js
+     * return {...data, "my-new-field": /*my data/*}
+     * ```
+     */
+    afterIdentify?(hookContext: IdentifySeriesContext, data: IdentifySeriesData, result: IdentifySeriesResult): IdentifySeriesData;
+}
+//# sourceMappingURL=Hooks.d.ts.map

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

@@ -0,0 +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,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAC7B,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,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,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;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,OAAO,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,oBAAoB,CAAC;CAC9B;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;CACvB"}

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

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

package/dist/esm/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,SAAS,CAAC"}

package/dist/esm/configuration/Configuration.d.ts

@@ -0,0 +1,86 @@
+import { ApplicationTags, internal, LDFlagSet, LDLogger, ServiceEndpoints } from '@launchdarkly/js-sdk-common';
+import { Hook, type LDOptions } from '../api';
+import { LDInspection } from '../api/LDInspection';
+export interface LDClientInternalOptions extends internal.LDInternalOptions {
+    trackEventModifier?: (event: internal.InputCustomEvent) => internal.InputCustomEvent;
+}
+export interface Configuration {
+    readonly logger: LDLogger;
+    readonly maxCachedContexts: number;
+    readonly capacity: number;
+    readonly diagnosticRecordingInterval: number;
+    readonly flushInterval: number;
+    readonly streamInitialReconnectDelay: number;
+    readonly allAttributesPrivate: boolean;
+    readonly debug: boolean;
+    readonly diagnosticOptOut: boolean;
+    readonly sendEvents: boolean;
+    readonly sendLDHeaders: boolean;
+    readonly useReport: boolean;
+    readonly withReasons: boolean;
+    readonly privateAttributes: string[];
+    readonly tags: ApplicationTags;
+    readonly applicationInfo?: {
+        id?: string;
+        version?: string;
+        name?: string;
+        versionName?: string;
+    };
+    readonly bootstrap?: LDFlagSet;
+    readonly requestHeaderTransform?: (headers: Map<string, string>) => Map<string, string>;
+    readonly stream?: boolean;
+    readonly hash?: string;
+    readonly wrapperName?: string;
+    readonly wrapperVersion?: string;
+    readonly serviceEndpoints: ServiceEndpoints;
+    readonly pollInterval: number;
+    readonly userAgentHeaderName: 'user-agent' | 'x-launchdarkly-user-agent';
+    readonly trackEventModifier: (event: internal.InputCustomEvent) => internal.InputCustomEvent;
+    readonly hooks: Hook[];
+    readonly inspectors: LDInspection[];
+}
+declare const DEFAULT_POLLING: string;
+declare const DEFAULT_STREAM: string;
+export { DEFAULT_POLLING, DEFAULT_STREAM };
+export default class ConfigurationImpl implements Configuration {
+    readonly logger: LDLogger;
+    private readonly baseUri;
+    private readonly eventsUri;
+    private readonly streamUri;
+    readonly maxCachedContexts = 5;
+    readonly capacity = 100;
+    readonly diagnosticRecordingInterval = 900;
+    readonly flushInterval = 30;
+    readonly streamInitialReconnectDelay = 1;
+    readonly allAttributesPrivate: boolean;
+    readonly debug: boolean;
+    readonly diagnosticOptOut: boolean;
+    readonly sendEvents: boolean;
+    readonly sendLDHeaders: boolean;
+    readonly useReport: boolean;
+    readonly withReasons: boolean;
+    readonly privateAttributes: string[];
+    readonly tags: ApplicationTags;
+    readonly applicationInfo?: {
+        id?: string;
+        version?: string;
+        name?: string;
+        versionName?: string;
+    };
+    readonly bootstrap?: LDFlagSet;
+    readonly requestHeaderTransform?: (headers: Map<string, string>) => Map<string, string>;
+    readonly stream?: boolean;
+    readonly hash?: string;
+    readonly wrapperName?: string;
+    readonly wrapperVersion?: string;
+    readonly serviceEndpoints: ServiceEndpoints;
+    readonly pollInterval: number;
+    readonly userAgentHeaderName: 'user-agent' | 'x-launchdarkly-user-agent';
+    readonly hooks: Hook[];
+    readonly inspectors: LDInspection[];
+    readonly trackEventModifier: (event: internal.InputCustomEvent) => internal.InputCustomEvent;
+    [index: string]: any;
+    constructor(pristineOptions?: LDOptions, internalOptions?: LDClientInternalOptions);
+    private _validateTypesAndNames;
+}
+//# sourceMappingURL=Configuration.d.ts.map

package/dist/esm/configuration/Configuration.d.ts.map

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

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

@@ -0,0 +1,3 @@
+import ConfigurationImpl, { Configuration, DEFAULT_POLLING, DEFAULT_STREAM, LDClientInternalOptions } from './Configuration';
+export { Configuration, ConfigurationImpl, LDClientInternalOptions, DEFAULT_POLLING, DEFAULT_STREAM, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configuration/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,EAAE,EACxB,aAAa,EACb,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,cAAc,GACf,CAAC"}

package/dist/esm/configuration/validators.d.ts

@@ -0,0 +1,5 @@
+import { TypeValidator } from '@launchdarkly/js-sdk-common';
+import { type LDOptions } from '../api';
+declare const validators: Record<keyof LDOptions, TypeValidator>;
+export default validators;
+//# sourceMappingURL=validators.d.ts.map

package/dist/esm/configuration/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/configuration/validators.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAkB,MAAM,6BAA6B,CAAC;AAE5E,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,QAAA,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,SAAS,EAAE,aAAa,CA+BtD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/esm/context/addAutoEnv.d.ts

@@ -0,0 +1,31 @@
+import { LDApplication, LDContext, LDDevice, LDSingleKindContext, Platform } from '@launchdarkly/js-sdk-common';
+import { Configuration } from '../configuration';
+export declare const toMulti: (c: LDSingleKindContext) => {
+    [x: string]: string | {
+        [attribute: string]: any;
+        key: string;
+        name?: string | undefined;
+        _meta?: import("@launchdarkly/js-sdk-common").LDContextMeta | undefined;
+        anonymous?: boolean | undefined;
+    };
+    kind: string;
+};
+/**
+ * Clones the LDApplication object and populates the key, envAttributesVersion, id and version fields.
+ *
+ * @param crypto
+ * @param info
+ * @param applicationInfo
+ * @param config
+ * @return An LDApplication object with populated key, envAttributesVersion, id and version.
+ */
+export declare const addApplicationInfo: ({ crypto, info }: Platform, { applicationInfo }: Configuration) => Promise<LDApplication | undefined>;
+/**
+ * Clones the LDDevice object and populates the key and envAttributesVersion field.
+ *
+ * @param platform
+ * @return An LDDevice object with populated key and envAttributesVersion.
+ */
+export declare const addDeviceInfo: (platform: Platform) => Promise<LDDevice | undefined>;
+export declare const addAutoEnv: (context: LDContext, platform: Platform, config: Configuration) => Promise<LDContext>;
+//# sourceMappingURL=addAutoEnv.d.ts.map

package/dist/esm/context/addAutoEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addAutoEnv.d.ts","sourceRoot":"","sources":["../../src/context/addAutoEnv.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,aAAa,EACb,SAAS,EACT,QAAQ,EAER,mBAAmB,EAEnB,QAAQ,EACT,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQjD,eAAO,MAAM,OAAO,MAAO,mBAAmB;;;;;;;;;CAO7C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,qBACX,QAAQ,uBACL,aAAa,KACjC,QAAQ,aAAa,GAAG,SAAS,CA0BnC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,aAAoB,QAAQ,kCA2BrD,CAAC;AAEF,eAAO,MAAM,UAAU,YACZ,SAAS,YACR,QAAQ,UACV,aAAa,KACpB,QAAQ,SAAS,CA2CnB,CAAC"}

package/dist/esm/context/ensureKey.d.ts

@@ -0,0 +1,10 @@
+import { LDContext, Platform } from '@launchdarkly/js-sdk-common';
+/**
+ * Ensure a key is always present in anonymous contexts. Non-anonymous contexts
+ * are not processed and will just be returned as is.
+ *
+ * @param context
+ * @param platform
+ */
+export declare const ensureKey: (context: LDContext, platform: Platform) => Promise<LDContext>;
+//# sourceMappingURL=ensureKey.d.ts.map

package/dist/esm/context/ensureKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureKey.d.ts","sourceRoot":"","sources":["../../src/context/ensureKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,SAAS,EAKT,QAAQ,EACT,MAAM,6BAA6B,CAAC;AAiDrC;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,YAAmB,SAAS,YAAY,QAAQ,KAAG,QAAQ,SAAS,CAgBzF,CAAC"}

package/dist/esm/crypto/digest.d.ts

@@ -0,0 +1,3 @@
+import { Hasher } from '@launchdarkly/js-sdk-common';
+export default function digest(hasher: Hasher, encoding: string): Promise<string>;
+//# sourceMappingURL=digest.d.ts.map

package/dist/esm/crypto/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/crypto/digest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,wBAA8B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAStF"}

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

@@ -0,0 +1,25 @@
+import { Encoding, LDHeaders, ServiceEndpoints } from '@launchdarkly/js-sdk-common';
+export interface DataSourceConfig {
+    credential: string;
+    serviceEndpoints: ServiceEndpoints;
+    baseHeaders: LDHeaders;
+    withReasons: boolean;
+    useReport: boolean;
+    paths: DataSourcePaths;
+    queryParameters?: {
+        key: string;
+        value: string;
+    }[];
+}
+export interface PollingDataSourceConfig extends DataSourceConfig {
+    pollInterval: number;
+}
+export interface StreamingDataSourceConfig extends DataSourceConfig {
+    initialRetryDelayMillis: number;
+}
+export interface DataSourcePaths {
+    pathGet(encoding: Encoding, plainContextString: string): string;
+    pathReport(encoding: Encoding, plainContextString: string): string;
+    pathPing(encoding: Encoding, plainContextString: string): string;
+}
+//# sourceMappingURL=DataSourceConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceConfig.d.ts","sourceRoot":"","sources":["../../src/datasource/DataSourceConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,SAAS,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,eAAe,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAE9B,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhE,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;CAClE"}

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

@@ -0,0 +1,16 @@
+import { Context, LDLogger, LDPollingError, LDStreamingError } from '@launchdarkly/js-sdk-common';
+import { FlagManager } from '../flag-manager/FlagManager';
+import { DeleteFlag, Flags, PatchFlag } from '../types';
+import DataSourceStatusManager from './DataSourceStatusManager';
+export default class DataSourceEventHandler {
+    private readonly _flagManager;
+    private readonly _statusManager;
+    private readonly _logger;
+    constructor(_flagManager: FlagManager, _statusManager: DataSourceStatusManager, _logger: LDLogger);
+    handlePut(context: Context, flags: Flags): Promise<void>;
+    handlePatch(context: Context, patchFlag: PatchFlag): Promise<void>;
+    handleDelete(context: Context, deleteFlag: DeleteFlag): Promise<void>;
+    handleStreamingError(error: LDStreamingError): void;
+    handlePollingError(error: LDPollingError): void;
+}
+//# sourceMappingURL=DataSourceEventHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceEventHandler.d.ts","sourceRoot":"","sources":["../../src/datasource/DataSourceEventHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAElG,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,uBAAuB,MAAM,2BAA2B,CAAC;AAEhE,MAAM,CAAC,OAAO,OAAO,sBAAsB;IAEvC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,YAAY,EAAE,WAAW,EACzB,cAAc,EAAE,uBAAuB,EACvC,OAAO,EAAE,QAAQ;IAG9B,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK;IAexC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS;IAQlD,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU;IAkB3D,oBAAoB,CAAC,KAAK,EAAE,gBAAgB;IAI5C,kBAAkB,CAAC,KAAK,EAAE,cAAc;CAGzC"}