@launchdarkly/js-client-sdk-common 1.7.0 → 1.9.0

package/dist/index.cjs

@@ -0,0 +1,1686 @@
+'use strict';
+
+var jsSdkCommon = require('@launchdarkly/js-sdk-common');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var jsSdkCommon__namespace = /*#__PURE__*/_interopNamespaceDefault(jsSdkCommon);
+
+exports.DataSourceState = void 0;
+(function (DataSourceState) {
+    DataSourceState["Initializing"] = "INITIALIZING";
+    DataSourceState["Valid"] = "VALID";
+    DataSourceState["Interrupted"] = "INTERRUPTED";
+    DataSourceState["SetOffline"] = "SET_OFFLINE";
+    DataSourceState["Closed"] = "CLOSED";
+    // TODO: SDK-702 - Implement network availability behaviors
+    // NetworkUnavailable,
+})(exports.DataSourceState || (exports.DataSourceState = {}));
+
+// eslint-disable-next-line max-classes-per-file
+const validators = {
+    logger: jsSdkCommon.TypeValidators.Object,
+    maxCachedContexts: jsSdkCommon.TypeValidators.numberWithMin(0),
+    baseUri: jsSdkCommon.TypeValidators.String,
+    streamUri: jsSdkCommon.TypeValidators.String,
+    eventsUri: jsSdkCommon.TypeValidators.String,
+    capacity: jsSdkCommon.TypeValidators.numberWithMin(1),
+    diagnosticRecordingInterval: jsSdkCommon.TypeValidators.numberWithMin(2),
+    flushInterval: jsSdkCommon.TypeValidators.numberWithMin(2),
+    streamInitialReconnectDelay: jsSdkCommon.TypeValidators.numberWithMin(0),
+    allAttributesPrivate: jsSdkCommon.TypeValidators.Boolean,
+    debug: jsSdkCommon.TypeValidators.Boolean,
+    diagnosticOptOut: jsSdkCommon.TypeValidators.Boolean,
+    withReasons: jsSdkCommon.TypeValidators.Boolean,
+    sendEvents: jsSdkCommon.TypeValidators.Boolean,
+    pollInterval: jsSdkCommon.TypeValidators.numberWithMin(30),
+    useReport: jsSdkCommon.TypeValidators.Boolean,
+    privateAttributes: jsSdkCommon.TypeValidators.StringArray,
+    applicationInfo: jsSdkCommon.TypeValidators.Object,
+    wrapperName: jsSdkCommon.TypeValidators.String,
+    wrapperVersion: jsSdkCommon.TypeValidators.String,
+    payloadFilterKey: jsSdkCommon.TypeValidators.stringMatchingRegex(/^[a-zA-Z0-9](\w|\.|-)*$/),
+    hooks: jsSdkCommon.TypeValidators.createTypeArray('Hook[]', {}),
+};
+
+const DEFAULT_POLLING_INTERVAL = 60 * 5;
+const DEFAULT_POLLING = 'https://clientsdk.launchdarkly.com';
+const DEFAULT_STREAM = 'https://clientstream.launchdarkly.com';
+function ensureSafeLogger(logger) {
+    if (logger instanceof jsSdkCommon.SafeLogger) {
+        return logger;
+    }
+    // Even if logger is not defined this will produce a valid logger.
+    return jsSdkCommon.createSafeLogger(logger);
+}
+class ConfigurationImpl {
+    constructor(pristineOptions = {}, internalOptions = {}) {
+        this.logger = jsSdkCommon.createSafeLogger();
+        this.baseUri = DEFAULT_POLLING;
+        this.eventsUri = jsSdkCommon.ServiceEndpoints.DEFAULT_EVENTS;
+        this.streamUri = DEFAULT_STREAM;
+        this.maxCachedContexts = 5;
+        this.capacity = 100;
+        this.diagnosticRecordingInterval = 900;
+        this.flushInterval = 30;
+        this.streamInitialReconnectDelay = 1;
+        this.allAttributesPrivate = false;
+        this.debug = false;
+        this.diagnosticOptOut = false;
+        this.sendEvents = true;
+        this.sendLDHeaders = true;
+        this.useReport = false;
+        this.withReasons = false;
+        this.privateAttributes = [];
+        this.pollInterval = DEFAULT_POLLING_INTERVAL;
+        this.hooks = [];
+        this.logger = ensureSafeLogger(pristineOptions.logger);
+        const errors = this.validateTypesAndNames(pristineOptions);
+        errors.forEach((e) => this.logger.warn(e));
+        this.serviceEndpoints = new jsSdkCommon.ServiceEndpoints(this.streamUri, this.baseUri, this.eventsUri, internalOptions.analyticsEventPath, internalOptions.diagnosticEventPath, internalOptions.includeAuthorizationHeader, pristineOptions.payloadFilterKey);
+        this.useReport = pristineOptions.useReport ?? false;
+        this.tags = new jsSdkCommon.ApplicationTags({ application: this.applicationInfo, logger: this.logger });
+        this.userAgentHeaderName = internalOptions.userAgentHeaderName ?? 'user-agent';
+        this.trackEventModifier = internalOptions.trackEventModifier ?? ((event) => event);
+    }
+    validateTypesAndNames(pristineOptions) {
+        const errors = [];
+        Object.entries(pristineOptions).forEach(([k, v]) => {
+            const validator = validators[k];
+            if (validator) {
+                if (!validator.is(v)) {
+                    const validatorType = validator.getType();
+                    if (validatorType === 'boolean') {
+                        errors.push(jsSdkCommon.OptionMessages.wrongOptionTypeBoolean(k, typeof v));
+                        this[k] = !!v;
+                    }
+                    else if (validatorType === 'boolean | undefined | null') {
+                        errors.push(jsSdkCommon.OptionMessages.wrongOptionTypeBoolean(k, typeof v));
+                        if (typeof v !== 'boolean' && typeof v !== 'undefined' && v !== null) {
+                            this[k] = !!v;
+                        }
+                    }
+                    else if (validator instanceof jsSdkCommon.NumberWithMinimum && jsSdkCommon.TypeValidators.Number.is(v)) {
+                        const { min } = validator;
+                        errors.push(jsSdkCommon.OptionMessages.optionBelowMinimum(k, v, min));
+                        this[k] = min;
+                    }
+                    else {
+                        errors.push(jsSdkCommon.OptionMessages.wrongOptionType(k, validator.getType(), typeof v));
+                    }
+                }
+                else if (k === 'logger') ;
+                else {
+                    // if an option is explicitly null, coerce to undefined
+                    this[k] = v ?? undefined;
+                }
+            }
+            else {
+                errors.push(jsSdkCommon.OptionMessages.unknownOption(k));
+            }
+        });
+        return errors;
+    }
+}
+
+async function digest(hasher, encoding) {
+    if (hasher.digest) {
+        return hasher.digest(encoding);
+    }
+    if (hasher.asyncDigest) {
+        return hasher.asyncDigest(encoding);
+    }
+    // This represents an error in platform implementation.
+    throw new Error('Platform must implement digest or asyncDigest');
+}
+
+/**
+ * This function will retrieve a previously generated key for the given {@link storageKey} if it
+ * exists or generate and store one on the fly if it does not already exist.
+ * @param storageKey keyed storage location where the generated key should live.  See {@link namespaceForGeneratedContextKey}
+ * for related exmaples of generating a storage key and usage.
+ * @param platform crypto and storage implementations for necessary operations
+ * @returns the generated key
+ */
+const getOrGenerateKey = async (storageKey, { crypto, storage }) => {
+    let generatedKey = await storage?.get(storageKey);
+    if (!generatedKey) {
+        generatedKey = crypto.randomUUID();
+        await storage?.set(storageKey, generatedKey);
+    }
+    return generatedKey;
+};
+
+/**
+ * Hashes the input and encodes it as base64
+ */
+function hashAndBase64Encode(crypto) {
+    return async (input) => digest(crypto.createHash('sha256').update(input), 'base64');
+}
+const noop = async (input) => input; // no-op transform
+async function concatNamespacesAndValues(parts) {
+    const processedParts = await Promise.all(parts.map((part) => part.transform(part.value))); // use the transform from each part to transform the value
+    return processedParts.join('_');
+}
+async function namespaceForEnvironment(crypto, sdkKey) {
+    return concatNamespacesAndValues([
+        { value: 'LaunchDarkly', transform: noop },
+        { value: sdkKey, transform: hashAndBase64Encode(crypto) }, // hash sdk key and encode it
+    ]);
+}
+/**
+ * @deprecated prefer {@link namespaceForGeneratedContextKey}. At one time we only generated keys for
+ * anonymous contexts and they were namespaced in LaunchDarkly_AnonymousKeys.  Eventually we started
+ * generating context keys for non-anonymous contexts such as for the Auto Environment Attributes
+ * feature and those were namespaced in LaunchDarkly_ContextKeys.  This function can be removed
+ * when the data under the LaunchDarkly_AnonymousKeys namespace is merged with data under the
+ * LaunchDarkly_ContextKeys namespace.
+ */
+async function namespaceForAnonymousGeneratedContextKey(kind) {
+    return concatNamespacesAndValues([
+        { value: 'LaunchDarkly', transform: noop },
+        { value: 'AnonymousKeys', transform: noop },
+        { value: kind, transform: noop }, // existing SDKs are not hashing or encoding this kind, though they should have
+    ]);
+}
+async function namespaceForGeneratedContextKey(kind) {
+    return concatNamespacesAndValues([
+        { value: 'LaunchDarkly', transform: noop },
+        { value: 'ContextKeys', transform: noop },
+        { value: kind, transform: noop }, // existing SDKs are not hashing or encoding this kind, though they should have
+    ]);
+}
+async function namespaceForContextIndex(environmentNamespace) {
+    return concatNamespacesAndValues([
+        { value: environmentNamespace, transform: noop },
+        { value: 'ContextIndex', transform: noop },
+    ]);
+}
+async function namespaceForContextData(crypto, environmentNamespace, context) {
+    return concatNamespacesAndValues([
+        { value: environmentNamespace, transform: noop },
+        { value: context.canonicalKey, transform: hashAndBase64Encode(crypto) }, // hash and encode canonical key
+    ]);
+}
+
+/* eslint-disable @typescript-eslint/naming-convention */
+const { isLegacyUser: isLegacyUser$1, isSingleKind: isSingleKind$1, isMultiKind: isMultiKind$1 } = jsSdkCommon.internal;
+const defaultAutoEnvSchemaVersion = '1.0';
+const toMulti = (c) => {
+    const { kind, ...contextCommon } = c;
+    return {
+        kind: 'multi',
+        [kind]: contextCommon,
+    };
+};
+/**
+ * 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.
+ */
+const addApplicationInfo = async ({ crypto, info }, { applicationInfo }) => {
+    const { ld_application } = info.platformData();
+    let app = jsSdkCommon.deepCompact(ld_application) ?? {};
+    const id = applicationInfo?.id || app?.id;
+    if (id) {
+        const version = applicationInfo?.version || app?.version;
+        const name = applicationInfo?.name || app?.name;
+        const versionName = applicationInfo?.versionName || app?.versionName;
+        app = {
+            ...app,
+            id,
+            // only add props if they are defined
+            ...(version ? { version } : {}),
+            ...(name ? { name } : {}),
+            ...(versionName ? { versionName } : {}),
+        };
+        app.key = await digest(crypto.createHash('sha256').update(id), 'base64');
+        app.envAttributesVersion = app.envAttributesVersion || defaultAutoEnvSchemaVersion;
+        return app;
+    }
+    return undefined;
+};
+/**
+ * Clones the LDDevice object and populates the key and envAttributesVersion field.
+ *
+ * @param platform
+ * @return An LDDevice object with populated key and envAttributesVersion.
+ */
+const addDeviceInfo = async (platform) => {
+    const { ld_device, os } = platform.info.platformData();
+    const device = jsSdkCommon.deepCompact(ld_device) ?? {};
+    const name = os?.name || device.os?.name;
+    const version = os?.version || device.os?.version;
+    const family = device.os?.family;
+    // only add device.os if there's data
+    if (name || version || family) {
+        device.os = {
+            // only add props if they are defined
+            ...(name ? { name } : {}),
+            ...(version ? { version } : {}),
+            ...(family ? { family } : {}),
+        };
+    }
+    // Check if device has any meaningful data before we return it.
+    if (Object.keys(device).filter((k) => k !== 'key' && k !== 'envAttributesVersion').length) {
+        const ldDeviceNamespace = await namespaceForGeneratedContextKey('ld_device');
+        device.key = await getOrGenerateKey(ldDeviceNamespace, platform);
+        device.envAttributesVersion = device.envAttributesVersion || defaultAutoEnvSchemaVersion;
+        return device;
+    }
+    return undefined;
+};
+const addAutoEnv = async (context, platform, config) => {
+    // LDUser is not supported for auto env reporting
+    if (isLegacyUser$1(context)) {
+        return context;
+    }
+    let ld_application;
+    let ld_device;
+    // Check if customer contexts exist. Only override if they are not provided.
+    if ((isSingleKind$1(context) && context.kind !== 'ld_application') ||
+        (isMultiKind$1(context) && !context.ld_application)) {
+        ld_application = await addApplicationInfo(platform, config);
+    }
+    else {
+        config.logger.warn('Not adding ld_application environment attributes because it already exists.');
+    }
+    if ((isSingleKind$1(context) && context.kind !== 'ld_device') ||
+        (isMultiKind$1(context) && !context.ld_device)) {
+        ld_device = await addDeviceInfo(platform);
+    }
+    else {
+        config.logger.warn('Not adding ld_device environment attributes because it already exists.');
+    }
+    // Unable to automatically add environment attributes for kind: {}.  {} already exists.
+    if (ld_application || ld_device) {
+        const multi = isSingleKind$1(context) ? toMulti(context) : context;
+        return {
+            ...multi,
+            ...(ld_application ? { ld_application } : {}),
+            ...(ld_device ? { ld_device } : {}),
+        };
+    }
+    return context;
+};
+
+const { isLegacyUser, isMultiKind, isSingleKind } = jsSdkCommon.internal;
+/**
+ * This is the root ensureKey function. All other ensureKey functions reduce to this.
+ *
+ * - ensureKeyCommon // private root function
+ *  - ensureKeySingle
+ *  - ensureKeyMulti
+ *  - ensureKeyLegacy
+ *    - ensureKey // exported for external use
+ *
+ * @param kind The LDContext kind
+ * @param c The LDContext object
+ * @param platform Platform containing crypto and storage needed for storing and querying keys.
+ */
+const ensureKeyCommon = async (kind, c, platform) => {
+    const { anonymous, key } = c;
+    if (anonymous && !key) {
+        const storageKey = await namespaceForAnonymousGeneratedContextKey(kind);
+        // This mutates a cloned copy of the original context from ensureyKey so this is safe.
+        // eslint-disable-next-line no-param-reassign
+        c.key = await getOrGenerateKey(storageKey, platform);
+    }
+};
+const ensureKeySingle = async (c, platform) => {
+    await ensureKeyCommon(c.kind, c, platform);
+};
+const ensureKeyMulti = async (multiContext, platform) => {
+    const { kind, ...singleContexts } = multiContext;
+    return Promise.all(Object.entries(singleContexts).map(([k, c]) => ensureKeyCommon(k, c, platform)));
+};
+const ensureKeyLegacy = async (c, platform) => {
+    await ensureKeyCommon('user', c, platform);
+};
+/**
+ * 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
+ */
+const ensureKey = async (context, platform) => {
+    const cloned = jsSdkCommon.clone(context);
+    if (isSingleKind(cloned)) {
+        await ensureKeySingle(cloned, platform);
+    }
+    if (isMultiKind(cloned)) {
+        await ensureKeyMulti(cloned, platform);
+    }
+    if (isLegacyUser(cloned)) {
+        await ensureKeyLegacy(cloned, platform);
+    }
+    return cloned;
+};
+
+const createDiagnosticsInitConfig = (config) => ({
+    customBaseURI: config.serviceEndpoints.polling !== DEFAULT_POLLING,
+    customStreamURI: config.serviceEndpoints.streaming !== DEFAULT_STREAM,
+    customEventsURI: config.serviceEndpoints.events !== jsSdkCommon.ServiceEndpoints.DEFAULT_EVENTS,
+    eventsCapacity: config.capacity,
+    eventsFlushIntervalMillis: jsSdkCommon.secondsToMillis(config.flushInterval),
+    reconnectTimeMillis: jsSdkCommon.secondsToMillis(config.streamInitialReconnectDelay),
+    diagnosticRecordingIntervalMillis: jsSdkCommon.secondsToMillis(config.diagnosticRecordingInterval),
+    allAttributesPrivate: config.allAttributesPrivate,
+    // TODO: Implement when corresponding features are implemented.
+    usingSecureMode: false,
+    bootstrapMode: false,
+});
+
+const createDiagnosticsManager = (clientSideID, config, platform) => {
+    if (config.sendEvents && !config.diagnosticOptOut) {
+        return new jsSdkCommon.internal.DiagnosticsManager(clientSideID, platform, createDiagnosticsInitConfig(config));
+    }
+    return undefined;
+};
+
+function createErrorEvaluationDetail(errorKind, def) {
+    return {
+        value: def ?? null,
+        variationIndex: null,
+        reason: { kind: 'ERROR', errorKind },
+    };
+}
+function createSuccessEvaluationDetail(value, variationIndex, reason) {
+    return {
+        value,
+        variationIndex: variationIndex ?? null,
+        reason: reason ?? null,
+    };
+}
+
+const createEventProcessor = (clientSideID, config, platform, baseHeaders, diagnosticsManager) => {
+    if (config.sendEvents) {
+        return new jsSdkCommon.internal.EventProcessor({ ...config, eventsCapacity: config.capacity }, new jsSdkCommon.ClientContext(clientSideID, config, platform), baseHeaders, undefined, diagnosticsManager, false);
+    }
+    return undefined;
+};
+
+/**
+ * @internal
+ */
+class EventFactory extends jsSdkCommon.internal.EventFactoryBase {
+    evalEventClient(flagKey, value, defaultVal, flag, context, reason) {
+        const { trackEvents, debugEventsUntilDate, trackReason, flagVersion, version, variation } = flag;
+        return super.evalEvent({
+            addExperimentData: trackReason,
+            context,
+            debugEventsUntilDate,
+            defaultVal,
+            flagKey,
+            reason,
+            trackEvents: !!trackEvents,
+            value,
+            variation,
+            version: flagVersion ?? version,
+        });
+    }
+}
+
+/**
+ * An index for tracking the most recently used contexts by timestamp with the ability to
+ * update entry timestamps and prune out least used contexts above a max capacity provided.
+ */
+class ContextIndex {
+    constructor() {
+        this.container = { index: new Array() };
+    }
+    /**
+     * Creates a {@link ContextIndex} from its JSON representation (likely retrieved from persistence).
+     * @param json representation of the {@link ContextIndex}
+     * @returns the {@link ContextIndex}
+     */
+    static fromJson(json) {
+        const contextIndex = new ContextIndex();
+        try {
+            contextIndex.container = JSON.parse(json);
+        }
+        catch (e) {
+            /* ignoring error and returning empty index */
+        }
+        return contextIndex;
+    }
+    /**
+     * @returns the JSON representation of the {@link ContextIndex} (like for saving to persistence)
+     */
+    toJson() {
+        return JSON.stringify(this.container);
+    }
+    /**
+     * Notice that a context has been used and when it was used.  This will update an existing record
+     * with the given timestamp, or create a new record if one doesn't exist.
+     * @param id of the corresponding context
+     * @param timestamp in millis since epoch
+     */
+    notice(id, timestamp) {
+        const entry = this.container.index.find((it) => it.id === id);
+        if (entry === undefined) {
+            this.container.index.push({ id, timestamp });
+        }
+        else {
+            entry.timestamp = timestamp;
+        }
+    }
+    /**
+     * Prune the index to the specified max size and then return the IDs
+     * @param maxContexts the maximum number of contexts to retain after this prune
+     * @returns an array of removed entries
+     */
+    prune(maxContexts) {
+        const clampedMax = Math.max(maxContexts, 0); // clamp to [0, infinity)
+        if (this.container.index.length > clampedMax) {
+            // sort by timestamp so that older timestamps appear first in the array
+            this.container.index.sort((a, b) => a.timestamp - b.timestamp);
+            // delete the first N many elements above capacity.  splice returns removed elements
+            return this.container.index.splice(0, this.container.index.length - clampedMax);
+        }
+        return [];
+    }
+}
+
+/**
+ * This class handles persisting and loading flag values from a persistent
+ * store. It intercepts updates and forwards them to the flag updater and
+ * then persists changes after the updater has completed.
+ */
+class FlagPersistence {
+    constructor(platform, environmentNamespace, maxCachedContexts, flagStore, flagUpdater, logger, timeStamper = () => Date.now()) {
+        this.platform = platform;
+        this.environmentNamespace = environmentNamespace;
+        this.maxCachedContexts = maxCachedContexts;
+        this.flagStore = flagStore;
+        this.flagUpdater = flagUpdater;
+        this.logger = logger;
+        this.timeStamper = timeStamper;
+        this.indexKeyPromise = namespaceForContextIndex(this.environmentNamespace);
+    }
+    /**
+     * Inits flag persistence for the provided context with the provided flags.  This will result
+     * in the underlying {@link FlagUpdater} switching its active context.
+     */
+    async init(context, newFlags) {
+        this.flagUpdater.init(context, newFlags);
+        await this.storeCache(context);
+    }
+    /**
+     * Upserts a flag into the {@link FlagUpdater} and stores that to persistence if the upsert
+     * was successful / accepted.  An upsert may be rejected if the provided context is not
+     * the active context.
+     */
+    async upsert(context, key, item) {
+        if (this.flagUpdater.upsert(context, key, item)) {
+            await this.storeCache(context);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Loads the flags from persistence for the provided context and gives those to the
+     * {@link FlagUpdater} this {@link FlagPersistence} was constructed with.
+     */
+    async loadCached(context) {
+        const storageKey = await namespaceForContextData(this.platform.crypto, this.environmentNamespace, context);
+        let flagsJson = await this.platform.storage?.get(storageKey);
+        if (flagsJson === null || flagsJson === undefined) {
+            // Fallback: in version <10.3.1 flag data was stored under the canonical key, check
+            // to see if data is present and migrate the data if present.
+            flagsJson = await this.platform.storage?.get(context.canonicalKey);
+            if (flagsJson === null || flagsJson === undefined) {
+                // return false indicating cache did not load if flag json is still absent
+                return false;
+            }
+            // migrate data from version <10.3.1 and cleanup data that was under canonical key
+            await this.platform.storage?.set(storageKey, flagsJson);
+            await this.platform.storage?.clear(context.canonicalKey);
+        }
+        try {
+            const flags = JSON.parse(flagsJson);
+            // mapping flags to item descriptors
+            const descriptors = Object.entries(flags).reduce((acc, [key, flag]) => {
+                acc[key] = { version: flag.version, flag };
+                return acc;
+            }, {});
+            this.flagUpdater.initCached(context, descriptors);
+            this.logger.debug('Loaded cached flag evaluations from persistent storage');
+            return true;
+        }
+        catch (e) {
+            this.logger.warn(`Could not load cached flag evaluations from persistent storage: ${e.message}`);
+            return false;
+        }
+    }
+    async loadIndex() {
+        if (this.contextIndex !== undefined) {
+            return this.contextIndex;
+        }
+        const json = await this.platform.storage?.get(await this.indexKeyPromise);
+        if (!json) {
+            this.contextIndex = new ContextIndex();
+            return this.contextIndex;
+        }
+        try {
+            this.contextIndex = ContextIndex.fromJson(json);
+            this.logger.debug('Loaded context index from persistent storage');
+        }
+        catch (e) {
+            this.logger.warn(`Could not load index from persistent storage: ${e.message}`);
+            this.contextIndex = new ContextIndex();
+        }
+        return this.contextIndex;
+    }
+    async storeCache(context) {
+        const index = await this.loadIndex();
+        const storageKey = await namespaceForContextData(this.platform.crypto, this.environmentNamespace, context);
+        index.notice(storageKey, this.timeStamper());
+        const pruned = index.prune(this.maxCachedContexts);
+        await Promise.all(pruned.map(async (it) => this.platform.storage?.clear(it.id)));
+        // store index
+        await this.platform.storage?.set(await this.indexKeyPromise, index.toJson());
+        const allFlags = this.flagStore.getAll();
+        // mapping item descriptors to flags
+        const flags = Object.entries(allFlags).reduce((acc, [key, descriptor]) => {
+            if (descriptor.flag !== null && descriptor.flag !== undefined) {
+                acc[key] = descriptor.flag;
+            }
+            return acc;
+        }, {});
+        const jsonAll = JSON.stringify(flags);
+        // store flag data
+        await this.platform.storage?.set(storageKey, jsonAll);
+    }
+}
+
+/**
+ * In memory flag store.
+ */
+class DefaultFlagStore {
+    constructor() {
+        this.flags = {};
+    }
+    init(newFlags) {
+        this.flags = Object.entries(newFlags).reduce((acc, [key, flag]) => {
+            acc[key] = flag;
+            return acc;
+        }, {});
+    }
+    insertOrUpdate(key, update) {
+        this.flags[key] = update;
+    }
+    get(key) {
+        if (Object.prototype.hasOwnProperty.call(this.flags, key)) {
+            return this.flags[key];
+        }
+        return undefined;
+    }
+    getAll() {
+        return this.flags;
+    }
+}
+
+function calculateChangedKeys(existingObject, newObject) {
+    const changedKeys = [];
+    // property deleted or updated
+    Object.entries(existingObject).forEach(([k, f]) => {
+        const subObject = newObject[k];
+        if (!subObject || !jsSdkCommon.fastDeepEqual(f, subObject)) {
+            changedKeys.push(k);
+        }
+    });
+    // property added
+    Object.keys(newObject).forEach((k) => {
+        if (!existingObject[k]) {
+            changedKeys.push(k);
+        }
+    });
+    return changedKeys;
+}
+
+/**
+ * The flag updater handles logic required during the flag update process.
+ * It handles versions checking to handle out of order flag updates and
+ * also handles flag comparisons for change notification.
+ */
+class FlagUpdater {
+    constructor(flagStore, logger) {
+        this.changeCallbacks = new Array();
+        this.flagStore = flagStore;
+        this.logger = logger;
+    }
+    init(context, newFlags) {
+        this.activeContextKey = context.canonicalKey;
+        const oldFlags = this.flagStore.getAll();
+        this.flagStore.init(newFlags);
+        const changed = calculateChangedKeys(oldFlags, newFlags);
+        if (changed.length > 0) {
+            this.changeCallbacks.forEach((callback) => {
+                try {
+                    callback(context, changed);
+                }
+                catch (err) {
+                    /* intentionally empty */
+                }
+            });
+        }
+    }
+    initCached(context, newFlags) {
+        if (this.activeContextKey === context.canonicalKey) {
+            return;
+        }
+        this.init(context, newFlags);
+    }
+    upsert(context, key, item) {
+        if (this.activeContextKey !== context.canonicalKey) {
+            this.logger.warn('Received an update for an inactive context.');
+            return false;
+        }
+        const currentValue = this.flagStore.get(key);
+        if (currentValue !== undefined && currentValue.version >= item.version) {
+            // this is an out of order update that can be ignored
+            return false;
+        }
+        this.flagStore.insertOrUpdate(key, item);
+        this.changeCallbacks.forEach((callback) => {
+            try {
+                callback(context, [key]);
+            }
+            catch (err) {
+                /* intentionally empty */
+            }
+        });
+        return true;
+    }
+    on(callback) {
+        this.changeCallbacks.push(callback);
+    }
+    off(callback) {
+        const index = this.changeCallbacks.indexOf(callback);
+        if (index > -1) {
+            this.changeCallbacks.splice(index, 1);
+        }
+    }
+}
+
+class DefaultFlagManager {
+    /**
+     * @param platform implementation of various platform provided functionality
+     * @param sdkKey that will be used to distinguish different environments
+     * @param maxCachedContexts that specifies the max number of contexts that will be cached in persistence
+     * @param logger used for logging various messages
+     * @param timeStamper exists for testing purposes
+     */
+    constructor(platform, sdkKey, maxCachedContexts, logger, timeStamper = () => Date.now()) {
+        this.timeStamper = timeStamper;
+        this.flagStore = new DefaultFlagStore();
+        this.flagUpdater = new FlagUpdater(this.flagStore, logger);
+        this.flagPersistencePromise = this.initPersistence(platform, sdkKey, maxCachedContexts, logger, timeStamper);
+    }
+    async initPersistence(platform, sdkKey, maxCachedContexts, logger, timeStamper = () => Date.now()) {
+        const environmentNamespace = await namespaceForEnvironment(platform.crypto, sdkKey);
+        return new FlagPersistence(platform, environmentNamespace, maxCachedContexts, this.flagStore, this.flagUpdater, logger, timeStamper);
+    }
+    get(key) {
+        return this.flagStore.get(key);
+    }
+    getAll() {
+        return this.flagStore.getAll();
+    }
+    setBootstrap(context, newFlags) {
+        // Bypasses the persistence as we do not want to put these flags into any cache.
+        // Generally speaking persistence likely *SHOULD* be disabled when using bootstrap.
+        this.flagUpdater.init(context, newFlags);
+    }
+    async init(context, newFlags) {
+        return (await this.flagPersistencePromise).init(context, newFlags);
+    }
+    async upsert(context, key, item) {
+        return (await this.flagPersistencePromise).upsert(context, key, item);
+    }
+    async loadCached(context) {
+        return (await this.flagPersistencePromise).loadCached(context);
+    }
+    on(callback) {
+        this.flagUpdater.on(callback);
+    }
+    off(callback) {
+        this.flagUpdater.off(callback);
+    }
+}
+
+const UNKNOWN_HOOK_NAME = 'unknown hook';
+const BEFORE_EVALUATION_STAGE_NAME = 'beforeEvaluation';
+const AFTER_EVALUATION_STAGE_NAME = 'afterEvaluation';
+function tryExecuteStage(logger, method, hookName, stage, def) {
+    try {
+        return stage();
+    }
+    catch (err) {
+        logger?.error(`An error was encountered in "${method}" of the "${hookName}" hook: ${err}`);
+        return def;
+    }
+}
+function getHookName(logger, hook) {
+    try {
+        return hook.getMetadata().name || UNKNOWN_HOOK_NAME;
+    }
+    catch {
+        logger.error(`Exception thrown getting metadata for hook. Unable to get hook name.`);
+        return UNKNOWN_HOOK_NAME;
+    }
+}
+function executeBeforeEvaluation(logger, hooks, hookContext) {
+    return hooks.map((hook) => tryExecuteStage(logger, BEFORE_EVALUATION_STAGE_NAME, getHookName(logger, hook), () => hook?.beforeEvaluation?.(hookContext, {}) ?? {}, {}));
+}
+function executeAfterEvaluation(logger, hooks, hookContext, updatedData, result) {
+    // This iterates in reverse, versus reversing a shallow copy of the hooks,
+    // for efficiency.
+    for (let hookIndex = hooks.length - 1; hookIndex >= 0; hookIndex -= 1) {
+        const hook = hooks[hookIndex];
+        const data = updatedData[hookIndex];
+        tryExecuteStage(logger, AFTER_EVALUATION_STAGE_NAME, getHookName(logger, hook), () => hook?.afterEvaluation?.(hookContext, data, result) ?? {}, {});
+    }
+}
+function executeBeforeIdentify(logger, hooks, hookContext) {
+    return hooks.map((hook) => tryExecuteStage(logger, BEFORE_EVALUATION_STAGE_NAME, getHookName(logger, hook), () => hook?.beforeIdentify?.(hookContext, {}) ?? {}, {}));
+}
+function executeAfterIdentify(logger, hooks, hookContext, updatedData, result) {
+    // This iterates in reverse, versus reversing a shallow copy of the hooks,
+    // for efficiency.
+    for (let hookIndex = hooks.length - 1; hookIndex >= 0; hookIndex -= 1) {
+        const hook = hooks[hookIndex];
+        const data = updatedData[hookIndex];
+        tryExecuteStage(logger, AFTER_EVALUATION_STAGE_NAME, getHookName(logger, hook), () => hook?.afterIdentify?.(hookContext, data, result) ?? {}, {});
+    }
+}
+class HookRunner {
+    constructor(logger, initialHooks) {
+        this.logger = logger;
+        this.hooks = [];
+        this.hooks.push(...initialHooks);
+    }
+    withEvaluation(key, context, defaultValue, method) {
+        if (this.hooks.length === 0) {
+            return method();
+        }
+        const hooks = [...this.hooks];
+        const hookContext = {
+            flagKey: key,
+            context,
+            defaultValue,
+        };
+        const hookData = executeBeforeEvaluation(this.logger, hooks, hookContext);
+        const result = method();
+        executeAfterEvaluation(this.logger, hooks, hookContext, hookData, result);
+        return result;
+    }
+    identify(context, timeout) {
+        const hooks = [...this.hooks];
+        const hookContext = {
+            context,
+            timeout,
+        };
+        const hookData = executeBeforeIdentify(this.logger, hooks, hookContext);
+        return (result) => {
+            executeAfterIdentify(this.logger, hooks, hookContext, hookData, result);
+        };
+    }
+    addHook(hook) {
+        this.hooks.push(hook);
+    }
+}
+
+/**
+ * Implementation Note: There should not be any default listeners for change events in a client
+ * implementation. Default listeners mean a client cannot determine when there are actual
+ * application developer provided listeners. If we require default listeners, then we should add
+ * a system to allow listeners which have counts independent of the primary listener counts.
+ */
+class LDEmitter {
+    constructor(logger) {
+        this.logger = logger;
+        this.listeners = new Map();
+    }
+    on(name, listener) {
+        if (!this.listeners.has(name)) {
+            this.listeners.set(name, [listener]);
+        }
+        else {
+            this.listeners.get(name)?.push(listener);
+        }
+    }
+    /**
+     * Unsubscribe one or all events.
+     *
+     * @param name
+     * @param listener Optional. If unspecified, all listeners for the event will be removed.
+     */
+    off(name, listener) {
+        const existingListeners = this.listeners.get(name);
+        if (!existingListeners) {
+            return;
+        }
+        if (listener) {
+            // remove from internal cache
+            const updated = existingListeners.filter((fn) => fn !== listener);
+            if (updated.length === 0) {
+                this.listeners.delete(name);
+            }
+            else {
+                this.listeners.set(name, updated);
+            }
+            return;
+        }
+        // listener was not specified, so remove them all for that event
+        this.listeners.delete(name);
+    }
+    invokeListener(listener, name, ...detail) {
+        try {
+            listener(...detail);
+        }
+        catch (err) {
+            this.logger?.error(`Encountered error invoking handler for "${name}", detail: "${err}"`);
+        }
+    }
+    emit(name, ...detail) {
+        const listeners = this.listeners.get(name);
+        listeners?.forEach((listener) => this.invokeListener(listener, name, ...detail));
+    }
+    eventNames() {
+        return [...this.listeners.keys()];
+    }
+    listenerCount(name) {
+        return this.listeners.get(name)?.length ?? 0;
+    }
+}
+
+const { ClientMessages, ErrorKinds } = jsSdkCommon.internal;
+class LDClientImpl {
+    /**
+     * Creates the client object synchronously. No async, no network calls.
+     */
+    constructor(sdkKey, autoEnvAttributes, platform, options, dataManagerFactory, internalOptions) {
+        this.sdkKey = sdkKey;
+        this.autoEnvAttributes = autoEnvAttributes;
+        this.platform = platform;
+        this.identifyTimeout = 5;
+        this.highTimeoutThreshold = 15;
+        this.eventFactoryDefault = new EventFactory(false);
+        this.eventFactoryWithReasons = new EventFactory(true);
+        this.eventSendingEnabled = false;
+        if (!sdkKey) {
+            throw new Error('You must configure the client with a client-side SDK key');
+        }
+        if (!platform.encoding) {
+            throw new Error('Platform must implement Encoding because btoa is required.');
+        }
+        this.config = new ConfigurationImpl(options, internalOptions);
+        this.logger = this.config.logger;
+        this.baseHeaders = jsSdkCommon.defaultHeaders(this.sdkKey, this.platform.info, this.config.tags, this.config.serviceEndpoints.includeAuthorizationHeader, this.config.userAgentHeaderName);
+        this.flagManager = new DefaultFlagManager(this.platform, sdkKey, this.config.maxCachedContexts, this.config.logger);
+        this.diagnosticsManager = createDiagnosticsManager(sdkKey, this.config, platform);
+        this.eventProcessor = createEventProcessor(sdkKey, this.config, platform, this.baseHeaders, this.diagnosticsManager);
+        this.emitter = new LDEmitter();
+        this.emitter.on('error', (c, err) => {
+            this.logger.error(`error: ${err}, context: ${JSON.stringify(c)}`);
+        });
+        this.flagManager.on((context, flagKeys) => {
+            const ldContext = jsSdkCommon.Context.toLDContext(context);
+            this.emitter.emit('change', ldContext, flagKeys);
+            flagKeys.forEach((it) => {
+                this.emitter.emit(`change:${it}`, ldContext);
+            });
+        });
+        this.dataManager = dataManagerFactory(this.flagManager, this.config, this.baseHeaders, this.emitter, this.diagnosticsManager);
+        this.hookRunner = new HookRunner(this.logger, this.config.hooks);
+    }
+    allFlags() {
+        // extracting all flag values
+        const result = Object.entries(this.flagManager.getAll()).reduce((acc, [key, descriptor]) => {
+            if (descriptor.flag !== null && descriptor.flag !== undefined && !descriptor.flag.deleted) {
+                acc[key] = descriptor.flag.value;
+            }
+            return acc;
+        }, {});
+        return result;
+    }
+    async close() {
+        await this.flush();
+        this.eventProcessor?.close();
+        this.updateProcessor?.close();
+        this.logger.debug('Closed event processor and data source.');
+    }
+    async flush() {
+        try {
+            await this.eventProcessor?.flush();
+            this.logger.debug('Successfully flushed event processor.');
+        }
+        catch (e) {
+            this.logger.error(`Error flushing event processor: ${e}.`);
+            return { error: e, result: false };
+        }
+        return { result: true };
+    }
+    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
+        // 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.
+        return this.uncheckedContext ? jsSdkCommon.clone(this.uncheckedContext) : undefined;
+    }
+    getInternalContext() {
+        return this.checkedContext;
+    }
+    createIdentifyPromise(timeout) {
+        let res;
+        let rej;
+        const slow = new Promise((resolve, reject) => {
+            res = resolve;
+            rej = reject;
+        });
+        const timed = jsSdkCommon.timedPromise(timeout, 'identify');
+        const raced = Promise.race([timed, slow]).catch((e) => {
+            if (e.message.includes('timed out')) {
+                this.logger.error(`identify error: ${e}`);
+            }
+            throw e;
+        });
+        return { identifyPromise: raced, identifyResolve: res, identifyReject: rej };
+    }
+    /**
+     * Identifies a context to LaunchDarkly. See {@link LDClient.identify}.
+     *
+     * @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
+     * context are available. It rejects when:
+     *
+     * 1. The context is unspecified or has no key.
+     *
+     * 2. The identify timeout is exceeded. In client SDKs this defaults to 5s.
+     * You can customize this timeout with {@link LDIdentifyOptions | identifyOptions}.
+     *
+     * 3. A network error is encountered during initialization.
+     */
+    async identify(pristineContext, identifyOptions) {
+        if (identifyOptions?.timeout) {
+            this.identifyTimeout = identifyOptions.timeout;
+        }
+        if (this.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(this.identifyTimeout);
+        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;
+        });
+    }
+    on(eventName, listener) {
+        this.emitter.on(eventName, listener);
+    }
+    off(eventName, listener) {
+        this.emitter.off(eventName, listener);
+    }
+    track(key, data, metricValue) {
+        if (!this.checkedContext || !this.checkedContext.valid) {
+            this.logger.warn(ClientMessages.missingContextKeyNoEvent);
+            return;
+        }
+        // 0 is valid, so do not truthy check the metric value
+        if (metricValue !== undefined && !jsSdkCommon.TypeValidators.Number.is(metricValue)) {
+            this.logger?.warn(ClientMessages.invalidMetricValue(typeof metricValue));
+        }
+        this.eventProcessor?.sendEvent(this.config.trackEventModifier(this.eventFactoryDefault.customEvent(key, this.checkedContext, data, metricValue)));
+    }
+    variationInternal(flagKey, defaultValue, eventFactory, typeChecker) {
+        if (!this.uncheckedContext) {
+            this.logger.debug(ClientMessages.missingContextKeyNoEvent);
+            return createErrorEvaluationDetail(ErrorKinds.UserNotSpecified, defaultValue);
+        }
+        const evalContext = jsSdkCommon.Context.fromLDContext(this.uncheckedContext);
+        const foundItem = this.flagManager.get(flagKey);
+        if (foundItem === undefined || foundItem.flag.deleted) {
+            const defVal = defaultValue ?? null;
+            const error = new jsSdkCommon.LDClientError(`Unknown feature flag "${flagKey}"; returning default value ${defVal}.`);
+            this.emitter.emit('error', this.uncheckedContext, error);
+            this.eventProcessor?.sendEvent(this.eventFactoryDefault.unknownFlagEvent(flagKey, defVal, evalContext));
+            return createErrorEvaluationDetail(ErrorKinds.FlagNotFound, defaultValue);
+        }
+        const { reason, value, variation } = foundItem.flag;
+        if (typeChecker) {
+            const [matched, type] = typeChecker(value);
+            if (!matched) {
+                this.eventProcessor?.sendEvent(eventFactory.evalEventClient(flagKey, defaultValue, // track default value on type errors
+                defaultValue, foundItem.flag, evalContext, reason));
+                const error = new jsSdkCommon.LDClientError(`Wrong type "${type}" for feature flag "${flagKey}"; returning default value`);
+                this.emitter.emit('error', this.uncheckedContext, error);
+                return createErrorEvaluationDetail(ErrorKinds.WrongType, defaultValue);
+            }
+        }
+        const successDetail = createSuccessEvaluationDetail(value, variation, reason);
+        if (value === undefined || value === null) {
+            this.logger.debug('Result value is null. Providing default value.');
+            successDetail.value = defaultValue;
+        }
+        this.eventProcessor?.sendEvent(eventFactory.evalEventClient(flagKey, value, defaultValue, foundItem.flag, evalContext, reason));
+        return successDetail;
+    }
+    variation(flagKey, defaultValue) {
+        const { value } = this.hookRunner.withEvaluation(flagKey, this.uncheckedContext, defaultValue, () => this.variationInternal(flagKey, defaultValue, this.eventFactoryDefault));
+        return value;
+    }
+    variationDetail(flagKey, defaultValue) {
+        return this.hookRunner.withEvaluation(flagKey, this.uncheckedContext, defaultValue, () => this.variationInternal(flagKey, defaultValue, this.eventFactoryWithReasons));
+    }
+    typedEval(key, defaultValue, eventFactory, typeChecker) {
+        return this.hookRunner.withEvaluation(key, this.uncheckedContext, defaultValue, () => this.variationInternal(key, defaultValue, eventFactory, typeChecker));
+    }
+    boolVariation(key, defaultValue) {
+        return this.typedEval(key, defaultValue, this.eventFactoryDefault, (value) => [
+            jsSdkCommon.TypeValidators.Boolean.is(value),
+            jsSdkCommon.TypeValidators.Boolean.getType(),
+        ]).value;
+    }
+    jsonVariation(key, defaultValue) {
+        return this.variation(key, defaultValue);
+    }
+    numberVariation(key, defaultValue) {
+        return this.typedEval(key, defaultValue, this.eventFactoryDefault, (value) => [
+            jsSdkCommon.TypeValidators.Number.is(value),
+            jsSdkCommon.TypeValidators.Number.getType(),
+        ]).value;
+    }
+    stringVariation(key, defaultValue) {
+        return this.typedEval(key, defaultValue, this.eventFactoryDefault, (value) => [
+            jsSdkCommon.TypeValidators.String.is(value),
+            jsSdkCommon.TypeValidators.String.getType(),
+        ]).value;
+    }
+    boolVariationDetail(key, defaultValue) {
+        return this.typedEval(key, defaultValue, this.eventFactoryWithReasons, (value) => [
+            jsSdkCommon.TypeValidators.Boolean.is(value),
+            jsSdkCommon.TypeValidators.Boolean.getType(),
+        ]);
+    }
+    numberVariationDetail(key, defaultValue) {
+        return this.typedEval(key, defaultValue, this.eventFactoryWithReasons, (value) => [
+            jsSdkCommon.TypeValidators.Number.is(value),
+            jsSdkCommon.TypeValidators.Number.getType(),
+        ]);
+    }
+    stringVariationDetail(key, defaultValue) {
+        return this.typedEval(key, defaultValue, this.eventFactoryWithReasons, (value) => [
+            jsSdkCommon.TypeValidators.String.is(value),
+            jsSdkCommon.TypeValidators.String.getType(),
+        ]);
+    }
+    jsonVariationDetail(key, defaultValue) {
+        return this.variationDetail(key, defaultValue);
+    }
+    addHook(hook) {
+        this.hookRunner.addHook(hook);
+    }
+    /**
+     * Enable/Disable event sending.
+     * @param enabled True to enable event processing, false to disable.
+     * @param flush True to flush while disabling. Useful to flush on certain state transitions.
+     */
+    setEventSendingEnabled(enabled, flush) {
+        if (this.eventSendingEnabled === enabled) {
+            return;
+        }
+        this.eventSendingEnabled = enabled;
+        if (enabled) {
+            this.logger.debug('Starting event processor');
+            this.eventProcessor?.start();
+        }
+        else if (flush) {
+            this.logger?.debug('Flushing event processor before disabling.');
+            // Disable and flush.
+            this.flush().then(() => {
+                // While waiting for the flush event sending could be re-enabled, in which case
+                // we do not want to close the event processor.
+                if (!this.eventSendingEnabled) {
+                    this.logger?.debug('Stopping event processor.');
+                    this.eventProcessor?.close();
+                }
+            });
+        }
+        else {
+            // Just disabled.
+            this.logger?.debug('Stopping event processor.');
+            this.eventProcessor?.close();
+        }
+    }
+    sendEvent(event) {
+        this.eventProcessor?.sendEvent(event);
+    }
+}
+
+function isOk(status) {
+    return status >= 200 && status <= 299;
+}
+class LDRequestError extends Error {
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = 'LaunchDarklyRequestError';
+    }
+}
+/**
+ * Note: The requestor is implemented independently from polling such that it can be used to
+ * make a one-off request.
+ */
+class Requestor {
+    constructor(requests, uri, headers, method, body) {
+        this.requests = requests;
+        this.uri = uri;
+        this.headers = headers;
+        this.method = method;
+        this.body = body;
+    }
+    async requestPayload() {
+        let status;
+        try {
+            const res = await this.requests.fetch(this.uri, {
+                method: this.method,
+                headers: this.headers,
+                body: this.body,
+            });
+            if (isOk(res.status)) {
+                return await res.text();
+            }
+            // Assigning so it can be thrown after the try/catch.
+            status = res.status;
+        }
+        catch (err) {
+            throw new LDRequestError(err?.message);
+        }
+        throw new LDRequestError(`Unexpected status code: ${status}`, status);
+    }
+}
+
+class DataSourceEventHandler {
+    constructor(flagManager, statusManager, logger) {
+        this.flagManager = flagManager;
+        this.statusManager = statusManager;
+        this.logger = logger;
+    }
+    async handlePut(context, flags) {
+        this.logger.debug(`Got PUT: ${Object.keys(flags)}`);
+        // mapping flags to item descriptors
+        const descriptors = Object.entries(flags).reduce((acc, [key, flag]) => {
+            acc[key] = { version: flag.version, flag };
+            return acc;
+        }, {});
+        await this.flagManager.init(context, descriptors);
+        this.statusManager.requestStateUpdate(exports.DataSourceState.Valid);
+    }
+    async handlePatch(context, patchFlag) {
+        this.logger.debug(`Got PATCH ${JSON.stringify(patchFlag, null, 2)}`);
+        this.flagManager.upsert(context, patchFlag.key, {
+            version: patchFlag.version,
+            flag: patchFlag,
+        });
+    }
+    async handleDelete(context, deleteFlag) {
+        this.logger.debug(`Got DELETE ${JSON.stringify(deleteFlag, null, 2)}`);
+        this.flagManager.upsert(context, deleteFlag.key, {
+            version: deleteFlag.version,
+            flag: {
+                ...deleteFlag,
+                deleted: true,
+                // props below are set to sensible defaults. they are irrelevant
+                // because this flag has been deleted.
+                flagVersion: 0,
+                value: undefined,
+                variation: 0,
+                trackEvents: false,
+            },
+        });
+    }
+    handleStreamingError(error) {
+        this.statusManager.reportError(error.kind, error.message, error.code, error.recoverable);
+    }
+    handlePollingError(error) {
+        this.statusManager.reportError(error.kind, error.message, error.status, error.recoverable);
+    }
+}
+
+/**
+ * Tracks the current data source status and emits updates when the status changes.
+ */
+class DataSourceStatusManager {
+    constructor(emitter, timeStamper = () => Date.now()) {
+        this.emitter = emitter;
+        this.state = exports.DataSourceState.Closed;
+        this.stateSinceMillis = timeStamper();
+        this.timeStamper = timeStamper;
+    }
+    get status() {
+        return {
+            state: this.state,
+            stateSince: this.stateSinceMillis,
+            lastError: this.errorInfo,
+        };
+    }
+    /**
+     * Updates the state of the manager.
+     *
+     * @param requestedState to track
+     * @param isError to indicate that the state update is a result of an error occurring.
+     */
+    updateState(requestedState, isError = false) {
+        const newState = requestedState === exports.DataSourceState.Interrupted && this.state === exports.DataSourceState.Initializing // don't go to interrupted from initializing (recoverable errors when initializing are not noteworthy)
+            ? exports.DataSourceState.Initializing
+            : requestedState;
+        const changedState = this.state !== newState;
+        if (changedState) {
+            this.state = newState;
+            this.stateSinceMillis = this.timeStamper();
+        }
+        if (changedState || isError) {
+            this.emitter.emit('dataSourceStatus', this.status);
+        }
+    }
+    /**
+     * Requests the manager move to the provided state.  This request may be ignored
+     * if the current state cannot transition to the requested state.
+     * @param state that is requested
+     */
+    requestStateUpdate(state) {
+        this.updateState(state);
+    }
+    /**
+     * Reports a datasource error to this manager. Since the {@link DataSourceStatus} includes error
+     * information, it is possible that that a {@link DataSourceStatus} update is emitted with
+     * the same {@link DataSourceState}.
+     *
+     * @param kind of the error
+     * @param message for the error
+     * @param statusCode of the error if there was one
+     * @param recoverable to indicate that the error is anticipated to be recoverable
+     */
+    reportError(kind, message, statusCode, recoverable = false) {
+        const errorInfo = {
+            kind,
+            message,
+            statusCode,
+            time: this.timeStamper(),
+        };
+        this.errorInfo = errorInfo;
+        this.updateState(recoverable ? exports.DataSourceState.Interrupted : exports.DataSourceState.Closed, true);
+    }
+}
+
+/**
+ * @internal
+ */
+class PollingProcessor {
+    constructor(plainContextString, dataSourceConfig, requests, encoding, dataHandler, errorHandler, logger) {
+        this.plainContextString = plainContextString;
+        this.dataSourceConfig = dataSourceConfig;
+        this.dataHandler = dataHandler;
+        this.errorHandler = errorHandler;
+        this.logger = logger;
+        this.stopped = false;
+        const path = dataSourceConfig.useReport
+            ? dataSourceConfig.paths.pathReport(encoding, plainContextString)
+            : dataSourceConfig.paths.pathGet(encoding, plainContextString);
+        const parameters = [
+            ...(dataSourceConfig.queryParameters ?? []),
+        ];
+        if (this.dataSourceConfig.withReasons) {
+            parameters.push({ key: 'withReasons', value: 'true' });
+        }
+        const uri = jsSdkCommon.getPollingUri(dataSourceConfig.serviceEndpoints, path, parameters);
+        this.pollInterval = dataSourceConfig.pollInterval;
+        let method = 'GET';
+        const headers = { ...dataSourceConfig.baseHeaders };
+        let body;
+        if (dataSourceConfig.useReport) {
+            method = 'REPORT';
+            headers['content-type'] = 'application/json';
+            body = plainContextString; // context is in body for REPORT
+        }
+        this.requestor = new Requestor(requests, uri, headers, method, body);
+    }
+    async poll() {
+        if (this.stopped) {
+            return;
+        }
+        const reportJsonError = (data) => {
+            this.logger?.error('Polling received invalid data');
+            this.logger?.debug(`Invalid JSON follows: ${data}`);
+            this.errorHandler?.(new jsSdkCommon.LDPollingError(jsSdkCommon.DataSourceErrorKind.InvalidData, 'Malformed JSON data in polling response'));
+        };
+        this.logger?.debug('Polling LaunchDarkly for feature flag updates');
+        const startTime = Date.now();
+        try {
+            const res = await this.requestor.requestPayload();
+            try {
+                const flags = JSON.parse(res);
+                try {
+                    this.dataHandler?.(flags);
+                }
+                catch (err) {
+                    this.logger?.error(`Exception from data handler: ${err}`);
+                }
+            }
+            catch {
+                reportJsonError(res);
+            }
+        }
+        catch (err) {
+            const requestError = err;
+            if (requestError.status !== undefined) {
+                if (!jsSdkCommon.isHttpRecoverable(requestError.status)) {
+                    this.logger?.error(jsSdkCommon.httpErrorMessage(err, 'polling request'));
+                    this.errorHandler?.(new jsSdkCommon.LDPollingError(jsSdkCommon.DataSourceErrorKind.ErrorResponse, requestError.message, requestError.status));
+                    return;
+                }
+            }
+            this.logger?.error(jsSdkCommon.httpErrorMessage(err, 'polling request', 'will retry'));
+        }
+        const elapsed = Date.now() - startTime;
+        const sleepFor = Math.max(this.pollInterval * 1000 - elapsed, 0);
+        this.logger?.debug('Elapsed: %d ms, sleeping for %d ms', elapsed, sleepFor);
+        this.timeoutHandle = setTimeout(() => {
+            this.poll();
+        }, sleepFor);
+    }
+    start() {
+        this.poll();
+    }
+    stop() {
+        if (this.timeoutHandle) {
+            clearTimeout(this.timeoutHandle);
+            this.timeoutHandle = undefined;
+        }
+        this.stopped = true;
+    }
+    close() {
+        this.stop();
+    }
+}
+
+const reportJsonError = (type, data, logger, errorHandler) => {
+    logger?.error(`Stream received invalid data in "${type}" message`);
+    logger?.debug(`Invalid JSON follows: ${data}`);
+    errorHandler?.(new jsSdkCommon.LDStreamingError(jsSdkCommon.DataSourceErrorKind.InvalidData, 'Malformed JSON data in event stream'));
+};
+class StreamingProcessor {
+    constructor(plainContextString, dataSourceConfig, listeners, requests, encoding, diagnosticsManager, errorHandler, logger) {
+        this.plainContextString = plainContextString;
+        this.dataSourceConfig = dataSourceConfig;
+        this.listeners = listeners;
+        this.requests = requests;
+        this.diagnosticsManager = diagnosticsManager;
+        this.errorHandler = errorHandler;
+        this.logger = logger;
+        // TODO: SC-255969 Implement better REPORT fallback logic
+        if (dataSourceConfig.useReport && !requests.getEventSourceCapabilities().customMethod) {
+            logger?.error("Configuration option useReport is true, but platform's EventSource does not support custom HTTP methods. Streaming may not work.");
+        }
+        const path = dataSourceConfig.useReport
+            ? dataSourceConfig.paths.pathReport(encoding, plainContextString)
+            : dataSourceConfig.paths.pathGet(encoding, plainContextString);
+        const parameters = [
+            ...(dataSourceConfig.queryParameters ?? []),
+        ];
+        if (this.dataSourceConfig.withReasons) {
+            parameters.push({ key: 'withReasons', value: 'true' });
+        }
+        this.requests = requests;
+        this.headers = { ...dataSourceConfig.baseHeaders };
+        this.logger = logger;
+        this.streamUri = jsSdkCommon.getStreamingUri(dataSourceConfig.serviceEndpoints, path, parameters);
+    }
+    logConnectionStarted() {
+        this.connectionAttemptStartTime = Date.now();
+    }
+    logConnectionResult(success) {
+        if (this.connectionAttemptStartTime && this.diagnosticsManager) {
+            this.diagnosticsManager.recordStreamInit(this.connectionAttemptStartTime, !success, Date.now() - this.connectionAttemptStartTime);
+        }
+        this.connectionAttemptStartTime = undefined;
+    }
+    /**
+     * This is a wrapper around the passed errorHandler which adds additional
+     * diagnostics and logging logic.
+     *
+     * @param err The error to be logged and handled.
+     * @return boolean whether to retry the connection.
+     *
+     * @private
+     */
+    retryAndHandleError(err) {
+        if (!jsSdkCommon.shouldRetry(err)) {
+            this.logConnectionResult(false);
+            this.errorHandler?.(new jsSdkCommon.LDStreamingError(jsSdkCommon.DataSourceErrorKind.ErrorResponse, err.message, err.status, false));
+            this.logger?.error(jsSdkCommon.httpErrorMessage(err, 'streaming request'));
+            return false;
+        }
+        this.logger?.warn(jsSdkCommon.httpErrorMessage(err, 'streaming request', 'will retry'));
+        this.logConnectionResult(false);
+        this.logConnectionStarted();
+        return true;
+    }
+    start() {
+        this.logConnectionStarted();
+        let methodAndBodyOverrides;
+        if (this.dataSourceConfig.useReport) {
+            // REPORT will include a body, so content type is required.
+            this.headers['content-type'] = 'application/json';
+            // orverrides default method with REPORT and adds body.
+            methodAndBodyOverrides = { method: 'REPORT', body: this.plainContextString };
+        }
+        else {
+            // no method or body override
+            methodAndBodyOverrides = {};
+        }
+        // TLS is handled by the platform implementation.
+        const eventSource = this.requests.createEventSource(this.streamUri, {
+            headers: this.headers,
+            ...methodAndBodyOverrides,
+            errorFilter: (error) => this.retryAndHandleError(error),
+            initialRetryDelayMillis: this.dataSourceConfig.initialRetryDelayMillis,
+            readTimeoutMillis: 5 * 60 * 1000,
+            retryResetIntervalMillis: 60 * 1000,
+        });
+        this.eventSource = eventSource;
+        eventSource.onclose = () => {
+            this.logger?.info('Closed LaunchDarkly stream connection');
+        };
+        eventSource.onerror = () => {
+            // The work is done by `errorFilter`.
+        };
+        eventSource.onopen = () => {
+            this.logger?.info('Opened LaunchDarkly stream connection');
+        };
+        eventSource.onretrying = (e) => {
+            this.logger?.info(`Will retry stream connection in ${e.delayMillis} milliseconds`);
+        };
+        this.listeners.forEach(({ deserializeData, processJson }, eventName) => {
+            eventSource.addEventListener(eventName, (event) => {
+                this.logger?.debug(`Received ${eventName} event`);
+                if (event?.data) {
+                    this.logConnectionResult(true);
+                    const { data } = event;
+                    const dataJson = deserializeData(data);
+                    if (!dataJson) {
+                        reportJsonError(eventName, data, this.logger, this.errorHandler);
+                        return;
+                    }
+                    processJson(dataJson);
+                }
+                else {
+                    this.errorHandler?.(new jsSdkCommon.LDStreamingError(jsSdkCommon.DataSourceErrorKind.InvalidData, 'Unexpected payload from event stream'));
+                }
+            });
+        });
+    }
+    stop() {
+        this.eventSource?.close();
+        this.eventSource = undefined;
+    }
+    close() {
+        this.stop();
+    }
+}
+
+class BaseDataManager {
+    constructor(platform, flagManager, credential, config, getPollingPaths, getStreamingPaths, baseHeaders, emitter, diagnosticsManager) {
+        this.platform = platform;
+        this.flagManager = flagManager;
+        this.credential = credential;
+        this.config = config;
+        this.getPollingPaths = getPollingPaths;
+        this.getStreamingPaths = getStreamingPaths;
+        this.baseHeaders = baseHeaders;
+        this.emitter = emitter;
+        this.diagnosticsManager = diagnosticsManager;
+        this.logger = config.logger;
+        this.dataSourceStatusManager = new DataSourceStatusManager(emitter);
+        this.dataSourceEventHandler = new DataSourceEventHandler(flagManager, this.dataSourceStatusManager, this.config.logger);
+    }
+    /**
+     * Set additional connection parameters for requests polling/streaming.
+     */
+    setConnectionParams(connectionParams) {
+        this.connectionParams = connectionParams;
+    }
+    createPollingProcessor(context, checkedContext, identifyResolve, identifyReject) {
+        const processor = new PollingProcessor(JSON.stringify(context), {
+            credential: this.credential,
+            serviceEndpoints: this.config.serviceEndpoints,
+            paths: this.getPollingPaths(),
+            baseHeaders: this.baseHeaders,
+            pollInterval: this.config.pollInterval,
+            withReasons: this.config.withReasons,
+            useReport: this.config.useReport,
+            queryParameters: this.connectionParams?.queryParameters,
+        }, this.platform.requests, this.platform.encoding, async (flags) => {
+            await this.dataSourceEventHandler.handlePut(checkedContext, flags);
+            identifyResolve?.();
+        }, (err) => {
+            this.emitter.emit('error', context, err);
+            this.dataSourceEventHandler.handlePollingError(err);
+            identifyReject?.(err);
+        });
+        this.updateProcessor = this.decorateProcessorWithStatusReporting(processor, this.dataSourceStatusManager);
+    }
+    createStreamingProcessor(context, checkedContext, identifyResolve, identifyReject) {
+        const processor = new StreamingProcessor(JSON.stringify(context), {
+            credential: this.credential,
+            serviceEndpoints: this.config.serviceEndpoints,
+            paths: this.getStreamingPaths(),
+            baseHeaders: this.baseHeaders,
+            initialRetryDelayMillis: this.config.streamInitialReconnectDelay * 1000,
+            withReasons: this.config.withReasons,
+            useReport: this.config.useReport,
+            queryParameters: this.connectionParams?.queryParameters,
+        }, this.createStreamListeners(checkedContext, identifyResolve), this.platform.requests, this.platform.encoding, this.diagnosticsManager, (e) => {
+            this.emitter.emit('error', context, e);
+            this.dataSourceEventHandler.handleStreamingError(e);
+            identifyReject?.(e);
+        });
+        this.updateProcessor = this.decorateProcessorWithStatusReporting(processor, this.dataSourceStatusManager);
+    }
+    createStreamListeners(context, identifyResolve) {
+        const listeners = new Map();
+        listeners.set('put', {
+            deserializeData: JSON.parse,
+            processJson: async (flags) => {
+                await this.dataSourceEventHandler.handlePut(context, flags);
+                identifyResolve?.();
+            },
+        });
+        listeners.set('patch', {
+            deserializeData: JSON.parse,
+            processJson: async (patchFlag) => {
+                this.dataSourceEventHandler.handlePatch(context, patchFlag);
+            },
+        });
+        listeners.set('delete', {
+            deserializeData: JSON.parse,
+            processJson: async (deleteFlag) => {
+                this.dataSourceEventHandler.handleDelete(context, deleteFlag);
+            },
+        });
+        return listeners;
+    }
+    decorateProcessorWithStatusReporting(processor, statusManager) {
+        return {
+            start: () => {
+                // update status before starting processor to ensure potential errors are reported after initializing
+                statusManager.requestStateUpdate(exports.DataSourceState.Initializing);
+                processor.start();
+            },
+            stop: () => {
+                processor.stop();
+                statusManager.requestStateUpdate(exports.DataSourceState.Closed);
+            },
+            close: () => {
+                processor.close();
+                statusManager.requestStateUpdate(exports.DataSourceState.Closed);
+            },
+        };
+    }
+}
+
+exports.platform = jsSdkCommon__namespace;
+exports.BaseDataManager = BaseDataManager;
+exports.LDClientImpl = LDClientImpl;
+exports.Requestor = Requestor;
+Object.keys(jsSdkCommon).forEach(function (k) {
+    if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+        enumerable: true,
+        get: function () { return jsSdkCommon[k]; }
+    });
+});
+//# sourceMappingURL=index.cjs.map