@launchdarkly/js-client-sdk-common 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [1.3.0](https://github.com/launchdarkly/js-core/compare/js-client-sdk-common-v1.2.0...js-client-sdk-common-v1.3.0) (2024-08-12)
+
+
+### Features
+
+* Add connection mananger. ([#522](https://github.com/launchdarkly/js-core/issues/522)) ([5bf8b16](https://github.com/launchdarkly/js-core/commit/5bf8b16e26e7d8cbbd18524f1c13f773de457b82))
+* Implement polling support. ([#524](https://github.com/launchdarkly/js-core/issues/524)) ([a99048e](https://github.com/launchdarkly/js-core/commit/a99048e0cebaafd536f79114c4727524b8f7357d))
+* Refactor application state handling. ([#523](https://github.com/launchdarkly/js-core/issues/523)) ([f5b81e6](https://github.com/launchdarkly/js-core/commit/f5b81e6fc571dc9d97a18d07f382c77cd938fd65))
+* refactors the implementation of context caching.  You can now s… ([#531](https://github.com/launchdarkly/js-core/issues/531)) ([8ab2ee4](https://github.com/launchdarkly/js-core/commit/8ab2ee425a35350a4f1c50e608c39fa3527da513))
+
+
+### Bug Fixes
+
+* Fix field visibility. ([#530](https://github.com/launchdarkly/js-core/issues/530)) ([21fb18b](https://github.com/launchdarkly/js-core/commit/21fb18b40139583b44a4185fb689b043547641ab))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @launchdarkly/js-sdk-common bumped from 2.5.0 to 2.6.0
+
 ## [1.2.0](https://github.com/launchdarkly/js-core/compare/js-client-sdk-common-v1.1.5...js-client-sdk-common-v1.2.0) (2024-07-31)
 
 

package/dist/LDClientImpl.d.ts

@@ -2,24 +2,27 @@ import { AutoEnvAttributes, internal, LDContext, LDEvaluationDetail, LDEvaluatio
 import { ConnectionMode, LDClient, type LDOptions } from './api';
 import { EventName } from './api/LDEmitter';
 import { LDIdentifyOptions } from './api/LDIdentifyOptions';
-import Configuration from './configuration';
 export default class LDClientImpl implements LDClient {
     readonly sdkKey: string;
     readonly autoEnvAttributes: AutoEnvAttributes;
     readonly platform: Platform;
-    config: Configuration;
-    context?: LDContext;
-    diagnosticsManager?: internal.DiagnosticsManager;
-    eventProcessor?: internal.EventProcessor;
-    identifyTimeout: number;
-    logger: LDLogger;
-    streamer?: internal.StreamingProcessor;
-    readonly highTimeoutThreshold: number;
+    private readonly config;
+    private uncheckedContext?;
+    private checkedContext?;
+    private readonly diagnosticsManager?;
+    private eventProcessor?;
+    private identifyTimeout;
+    readonly logger: LDLogger;
+    private updateProcessor?;
+    private readonly highTimeoutThreshold;
     private eventFactoryDefault;
     private eventFactoryWithReasons;
     private emitter;
-    private flags;
+    private flagManager;
     private readonly clientContext;
+    private eventSendingEnabled;
+    private networkAvailable;
+    private connectionMode;
     /**
      * Creates the client object synchronously. No async, no network calls.
      */
@@ -44,20 +47,23 @@ export default class LDClientImpl implements LDClient {
     getContext(): LDContext | undefined;
     private createStreamListeners;
     /**
-     * Generates the url path for streamer.
+     * Generates the url path for streaming.
      *
-     * For mobile key: /meval/${base64-encoded-context}
-     * For clientSideId: /eval/${envId}/${base64-encoded-context}
-     *
-     * the path.
-     *
-     * @protected This function must be overridden in subclasses for streamer
+     * @protected This function must be overridden in subclasses for streaming
      * to work.
      * @param _context The LDContext object
      */
     protected createStreamUriPath(_context: LDContext): string;
+    /**
+     * Generates the url path for polling.
+     * @param _context
+     *
+     * @protected This function must be overridden in subclasses for polling
+     * to work.
+     * @param _context The LDContext object
+     */
+    protected createPollUriPath(_context: LDContext): string;
     private createIdentifyPromise;
-    private getFlagsFromStorage;
     /**
      * Identifies a context to LaunchDarkly. See {@link LDClient.identify}.
      *
@@ -74,20 +80,8 @@ export default class LDClientImpl implements LDClient {
      * 3. A network error is encountered during initialization.
      */
     identify(pristineContext: LDContext, identifyOptions?: LDIdentifyOptions): Promise<void>;
-    /**
-     * Performs common tasks when resolving the identify promise:
-     *  - resolve the promise
-     *  - update in memory context
-     *  - update in memory flags
-     *  - emit change event if needed
-     *
-     * @param resolve
-     * @param flags
-     * @param context
-     * @param source For logging purposes
-     * @private
-     */
-    private onIdentifyResolve;
+    private createPollingProcessor;
+    private createStreamingProcessor;
     off(eventName: EventName, listener: Function): void;
     on(eventName: EventName, listener: Function): void;
     track(key: string, data?: any, metricValue?: number): void;
@@ -103,5 +97,19 @@ export default class LDClientImpl implements LDClient {
     numberVariationDetail(key: string, defaultValue: number): LDEvaluationDetailTyped<number>;
     stringVariationDetail(key: string, defaultValue: string): LDEvaluationDetailTyped<string>;
     jsonVariationDetail(key: string, defaultValue: unknown): LDEvaluationDetailTyped<unknown>;
+    /**
+     * Inform the client of the network state. Can be used to modify connection behavior.
+     *
+     * For instance the implementation may choose to suppress errors from connections if the client
+     * knows that there is no network available.
+     * @param _available True when there is an available network.
+     */
+    protected setNetworkAvailability(available: boolean): void;
+    /**
+     * 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.
+     */
+    protected setEventSendingEnabled(enabled: boolean, flush: boolean): void;
 }
 //# sourceMappingURL=LDClientImpl.d.ts.map

package/dist/LDClientImpl.d.ts.map

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

package/dist/LDClientImpl.js

@@ -3,10 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const js_sdk_common_1 = require("@launchdarkly/js-sdk-common");
 const LDEmitter_1 = require("./api/LDEmitter");
 const configuration_1 = require("./configuration");
+const addAutoEnv_1 = require("./context/addAutoEnv");
+const ensureKey_1 = require("./context/ensureKey");
 const createDiagnosticsManager_1 = require("./diagnostics/createDiagnosticsManager");
 const createEventProcessor_1 = require("./events/createEventProcessor");
 const EventFactory_1 = require("./events/EventFactory");
-const utils_1 = require("./utils");
+const FlagManager_1 = require("./flag-manager/FlagManager");
+const PollingProcessor_1 = require("./polling/PollingProcessor");
 const { createErrorEvaluationDetail, createSuccessEvaluationDetail, ClientMessages, ErrorKinds } = js_sdk_common_1.internal;
 class LDClientImpl {
     /**
@@ -20,7 +23,8 @@ class LDClientImpl {
         this.highTimeoutThreshold = 15;
         this.eventFactoryDefault = new EventFactory_1.default(false);
         this.eventFactoryWithReasons = new EventFactory_1.default(true);
-        this.flags = {};
+        this.eventSendingEnabled = true;
+        this.networkAvailable = true;
         if (!sdkKey) {
             throw new Error('You must configure the client with a client-side SDK key');
         }
@@ -28,8 +32,10 @@ class LDClientImpl {
             throw new Error('Platform must implement Encoding because btoa is required.');
         }
         this.config = new configuration_1.default(options, internalOptions);
+        this.connectionMode = this.config.initialConnectionMode;
         this.clientContext = new js_sdk_common_1.ClientContext(sdkKey, this.config, platform);
         this.logger = this.config.logger;
+        this.flagManager = new FlagManager_1.default(this.platform, sdkKey, this.config.maxCachedContexts, this.config.logger);
         this.diagnosticsManager = (0, createDiagnosticsManager_1.default)(sdkKey, this.config, platform);
         this.eventProcessor = (0, createEventProcessor_1.default)(sdkKey, this.config, platform, this.diagnosticsManager, !this.isOffline());
         this.emitter = new LDEmitter_1.default();
@@ -39,6 +45,10 @@ class LDClientImpl {
         this.emitter.on('error', (c, err) => {
             this.logger.error(`error: ${err}, context: ${JSON.stringify(c)}`);
         });
+        this.flagManager.on((context, flagKeys) => {
+            const ldContext = js_sdk_common_1.Context.toLDContext(context);
+            this.emitter.emit('change', ldContext, flagKeys);
+        });
     }
     /**
      * Sets the SDK connection mode.
@@ -47,24 +57,25 @@ class LDClientImpl {
      */
     async setConnectionMode(mode) {
         var _a;
-        if (this.config.connectionMode === mode) {
+        if (this.connectionMode === mode) {
             this.logger.debug(`setConnectionMode ignored. Mode is already '${mode}'.`);
             return Promise.resolve();
         }
-        this.config.connectionMode = mode;
+        this.connectionMode = mode;
         this.logger.debug(`setConnectionMode ${mode}.`);
         switch (mode) {
             case 'offline':
-                return this.close();
+                (_a = this.updateProcessor) === null || _a === void 0 ? void 0 : _a.close();
+                break;
+            case 'polling':
             case 'streaming':
-                (_a = this.eventProcessor) === null || _a === void 0 ? void 0 : _a.start();
-                if (this.context) {
-                    // identify will start streamer
-                    return this.identify(this.context, { timeout: this.identifyTimeout });
+                if (this.uncheckedContext) {
+                    // identify will start the update processor
+                    return this.identify(this.uncheckedContext, { timeout: this.identifyTimeout });
                 }
                 break;
             default:
-                this.logger.warn(`Unknown ConnectionMode: ${mode}. Only 'offline' and 'streaming' are supported.`);
+                this.logger.warn(`Unknown ConnectionMode: ${mode}. Only 'offline', 'streaming', and 'polling' are supported.`);
                 break;
         }
         return Promise.resolve();
@@ -73,104 +84,107 @@ class LDClientImpl {
      * Gets the SDK connection mode.
      */
     getConnectionMode() {
-        return this.config.connectionMode;
+        return this.connectionMode;
     }
     isOffline() {
-        return this.config.connectionMode === 'offline';
+        return this.connectionMode === 'offline';
     }
     allFlags() {
-        const result = {};
-        Object.entries(this.flags).forEach(([k, r]) => {
-            if (!r.deleted) {
-                result[k] = r.value;
+        // 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() {
         var _a, _b;
         await this.flush();
         (_a = this.eventProcessor) === null || _a === void 0 ? void 0 : _a.close();
-        (_b = this.streamer) === null || _b === void 0 ? void 0 : _b.close();
-        this.logger.debug('Closed eventProcessor and streamer.');
+        (_b = this.updateProcessor) === null || _b === void 0 ? void 0 : _b.close();
+        this.logger.debug('Closed event processor and data source.');
     }
     async flush() {
         var _a;
         try {
             await ((_a = this.eventProcessor) === null || _a === void 0 ? void 0 : _a.flush());
-            this.logger.debug('Successfully flushed eventProcessor.');
+            this.logger.debug('Successfully flushed event processor.');
         }
         catch (e) {
-            this.logger.error(`Error flushing eventProcessor: ${e}.`);
+            this.logger.error(`Error flushing event processor: ${e}.`);
             return { error: e, result: false };
         }
         return { result: true };
     }
     getContext() {
-        return this.context ? (0, js_sdk_common_1.clone)(this.context) : undefined;
+        // 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 ? (0, js_sdk_common_1.clone)(this.uncheckedContext) : undefined;
     }
-    createStreamListeners(context, canonicalKey, identifyResolve) {
+    createStreamListeners(context, identifyResolve) {
         const listeners = new Map();
         listeners.set('put', {
             deserializeData: JSON.parse,
-            processJson: async (dataJson) => {
-                var _a;
-                this.logger.debug(`Streamer PUT: ${Object.keys(dataJson)}`);
-                this.onIdentifyResolve(identifyResolve, dataJson, context, 'streamer PUT');
-                await ((_a = this.platform.storage) === null || _a === void 0 ? void 0 : _a.set(canonicalKey, JSON.stringify(this.flags)));
+            processJson: async (evalResults) => {
+                this.logger.debug(`Stream PUT: ${Object.keys(evalResults)}`);
+                // mapping flags to item descriptors
+                const descriptors = Object.entries(evalResults).reduce((acc, [key, flag]) => {
+                    acc[key] = { version: flag.version, flag };
+                    return acc;
+                }, {});
+                await this.flagManager.init(context, descriptors).then(identifyResolve());
             },
         });
         listeners.set('patch', {
             deserializeData: JSON.parse,
-            processJson: async (dataJson) => {
-                var _a;
-                this.logger.debug(`Streamer PATCH ${JSON.stringify(dataJson, null, 2)}`);
-                const existing = this.flags[dataJson.key];
-                // add flag if it doesn't exist or update it if version is newer
-                if (!existing || (existing && dataJson.version > existing.version)) {
-                    this.flags[dataJson.key] = dataJson;
-                    await ((_a = this.platform.storage) === null || _a === void 0 ? void 0 : _a.set(canonicalKey, JSON.stringify(this.flags)));
-                    const changedKeys = [dataJson.key];
-                    this.logger.debug(`Emitting changes from PATCH: ${changedKeys}`);
-                    this.emitter.emit('change', context, changedKeys);
-                }
+            processJson: async (patchFlag) => {
+                this.logger.debug(`Stream PATCH ${JSON.stringify(patchFlag, null, 2)}`);
+                this.flagManager.upsert(context, patchFlag.key, {
+                    version: patchFlag.version,
+                    flag: patchFlag,
+                });
             },
         });
         listeners.set('delete', {
             deserializeData: JSON.parse,
-            processJson: async (dataJson) => {
-                var _a;
-                this.logger.debug(`Streamer DELETE ${JSON.stringify(dataJson, null, 2)}`);
-                const existing = this.flags[dataJson.key];
-                // the deleted flag is saved as tombstoned
-                if (!existing || existing.version < dataJson.version) {
-                    this.flags[dataJson.key] = Object.assign(Object.assign({}, dataJson), { deleted: true, 
+            processJson: async (deleteFlag) => {
+                this.logger.debug(`Stream DELETE ${JSON.stringify(deleteFlag, null, 2)}`);
+                this.flagManager.upsert(context, deleteFlag.key, {
+                    version: deleteFlag.version,
+                    flag: Object.assign(Object.assign({}, 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 });
-                    await ((_a = this.platform.storage) === null || _a === void 0 ? void 0 : _a.set(canonicalKey, JSON.stringify(this.flags)));
-                    const changedKeys = [dataJson.key];
-                    this.logger.debug(`Emitting changes from DELETE: ${changedKeys}`);
-                    this.emitter.emit('change', context, changedKeys);
-                }
+                        flagVersion: 0, value: undefined, variation: 0, trackEvents: false }),
+                });
             },
         });
         return listeners;
     }
     /**
-     * Generates the url path for streamer.
-     *
-     * For mobile key: /meval/${base64-encoded-context}
-     * For clientSideId: /eval/${envId}/${base64-encoded-context}
+     * Generates the url path for streaming.
      *
-     * the path.
-     *
-     * @protected This function must be overridden in subclasses for streamer
+     * @protected This function must be overridden in subclasses for streaming
      * to work.
      * @param _context The LDContext object
      */
     createStreamUriPath(_context) {
-        throw new Error('createStreamUriPath not implemented. Client sdks must implement createStreamUriPath for streamer to work.');
+        throw new Error('createStreamUriPath not implemented. Client sdks must implement createStreamUriPath for streaming to work.');
+    }
+    /**
+     * Generates the url path for polling.
+     * @param _context
+     *
+     * @protected This function must be overridden in subclasses for polling
+     * to work.
+     * @param _context The LDContext object
+     */
+    createPollUriPath(_context) {
+        throw new Error('createPollUriPath not implemented. Client sdks must implement createPollUriPath for polling to work.');
     }
     createIdentifyPromise(timeout) {
         let res;
@@ -188,11 +202,6 @@ class LDClientImpl {
         });
         return { identifyPromise: raced, identifyResolve: res, identifyReject: rej };
     }
-    async getFlagsFromStorage(canonicalKey) {
-        var _a;
-        const f = await ((_a = this.platform.storage) === null || _a === void 0 ? void 0 : _a.get(canonicalKey));
-        return f ? JSON.parse(f) : undefined;
-    }
     /**
      * Identifies a context to LaunchDarkly. See {@link LDClient.identify}.
      *
@@ -214,13 +223,13 @@ class LDClientImpl {
             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.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 (0, utils_1.ensureKey)(pristineContext, this.platform);
+        let context = await (0, ensureKey_1.ensureKey)(pristineContext, this.platform);
         if (this.autoEnvAttributes === js_sdk_common_1.AutoEnvAttributes.Enabled) {
-            context = await (0, utils_1.addAutoEnv)(context, this.platform, this.config);
+            context = await (0, addAutoEnv_1.addAutoEnv)(context, this.platform, this.config);
         }
         const checkedContext = js_sdk_common_1.Context.fromLDContext(context);
         if (!checkedContext.valid) {
@@ -228,64 +237,67 @@ class LDClientImpl {
             this.emitter.emit('error', context, error);
             return Promise.reject(error);
         }
-        (_a = this.eventProcessor) === null || _a === void 0 ? void 0 : _a.sendEvent(this.eventFactoryDefault.identifyEvent(checkedContext));
+        this.uncheckedContext = context;
+        this.checkedContext = checkedContext;
+        (_a = this.eventProcessor) === null || _a === void 0 ? void 0 : _a.sendEvent(this.eventFactoryDefault.identifyEvent(this.checkedContext));
         const { identifyPromise, identifyResolve, identifyReject } = this.createIdentifyPromise(this.identifyTimeout);
-        this.logger.debug(`Identifying ${JSON.stringify(context)}`);
-        const flagsStorage = await this.getFlagsFromStorage(checkedContext.canonicalKey);
-        if (flagsStorage) {
-            this.logger.debug('Using storage');
-            this.onIdentifyResolve(identifyResolve, flagsStorage, context, 'identify storage');
+        this.logger.debug(`Identifying ${JSON.stringify(this.checkedContext)}`);
+        const loadedFromCache = await this.flagManager.loadCached(this.checkedContext);
+        if (loadedFromCache) {
+            identifyResolve();
         }
         if (this.isOffline()) {
-            if (flagsStorage) {
+            if (loadedFromCache) {
                 this.logger.debug('Offline identify using storage flags.');
             }
             else {
                 this.logger.debug('Offline identify no storage. Defaults will be used.');
-                this.context = context;
-                this.flags = {};
                 identifyResolve();
             }
         }
         else {
-            (_b = this.streamer) === null || _b === void 0 ? void 0 : _b.close();
-            let streamUri = this.createStreamUriPath(context);
-            if (this.config.withReasons) {
-                streamUri = `${streamUri}?withReasons=true`;
+            (_b = this.updateProcessor) === null || _b === void 0 ? void 0 : _b.close();
+            switch (this.getConnectionMode()) {
+                case 'streaming':
+                    this.createStreamingProcessor(context, checkedContext, identifyResolve, identifyReject);
+                    break;
+                case 'polling':
+                    this.createPollingProcessor(context, checkedContext, identifyResolve, identifyReject);
+                    break;
+                default:
+                    break;
             }
-            this.streamer = new js_sdk_common_1.internal.StreamingProcessor(this.sdkKey, this.clientContext, streamUri, this.createStreamListeners(context, checkedContext.canonicalKey, identifyResolve), this.diagnosticsManager, (e) => {
-                identifyReject(e);
-                this.emitter.emit('error', context, e);
-            });
-            this.streamer.start();
+            this.updateProcessor.start();
         }
         return identifyPromise;
     }
-    /**
-     * Performs common tasks when resolving the identify promise:
-     *  - resolve the promise
-     *  - update in memory context
-     *  - update in memory flags
-     *  - emit change event if needed
-     *
-     * @param resolve
-     * @param flags
-     * @param context
-     * @param source For logging purposes
-     * @private
-     */
-    onIdentifyResolve(resolve, flags, context, source) {
-        resolve();
-        const changedKeys = (0, utils_1.calculateFlagChanges)(this.flags, flags);
-        this.context = context;
-        this.flags = flags;
-        if (changedKeys.length > 0) {
-            this.emitter.emit('change', context, changedKeys);
-            this.logger.debug(`OnIdentifyResolve emitting changes from: ${source}.`);
+    createPollingProcessor(context, checkedContext, identifyResolve, identifyReject) {
+        let pollingPath = this.createPollUriPath(context);
+        if (this.config.withReasons) {
+            pollingPath = `${pollingPath}?withReasons=true`;
         }
-        else {
-            this.logger.debug(`OnIdentifyResolve no changes to emit from: ${source}.`);
+        this.updateProcessor = new PollingProcessor_1.default(this.sdkKey, this.clientContext.platform.requests, this.clientContext.platform.info, pollingPath, this.config, async (flags) => {
+            this.logger.debug(`Handling polling result: ${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(checkedContext, descriptors).then(identifyResolve());
+        }, (err) => {
+            identifyReject(err);
+            this.emitter.emit('error', context, err);
+        });
+    }
+    createStreamingProcessor(context, checkedContext, identifyResolve, identifyReject) {
+        let streamingPath = this.createStreamUriPath(context);
+        if (this.config.withReasons) {
+            streamingPath = `${streamingPath}?withReasons=true`;
         }
+        this.updateProcessor = new js_sdk_common_1.internal.StreamingProcessor(this.sdkKey, this.clientContext, streamingPath, this.createStreamListeners(checkedContext, identifyResolve), this.diagnosticsManager, (e) => {
+            identifyReject(e);
+            this.emitter.emit('error', context, e);
+        });
     }
     off(eventName, listener) {
         this.emitter.off(eventName, listener);
@@ -295,12 +307,7 @@ class LDClientImpl {
     }
     track(key, data, metricValue) {
         var _a, _b;
-        if (!this.context) {
-            this.logger.warn(ClientMessages.missingContextKeyNoEvent);
-            return;
-        }
-        const checkedContext = js_sdk_common_1.Context.fromLDContext(this.context);
-        if (!checkedContext.valid) {
+        if (!this.checkedContext || !this.checkedContext.valid) {
             this.logger.warn(ClientMessages.missingContextKeyNoEvent);
             return;
         }
@@ -308,31 +315,31 @@ class LDClientImpl {
         if (metricValue !== undefined && !js_sdk_common_1.TypeValidators.Number.is(metricValue)) {
             (_a = this.logger) === null || _a === void 0 ? void 0 : _a.warn(ClientMessages.invalidMetricValue(typeof metricValue));
         }
-        (_b = this.eventProcessor) === null || _b === void 0 ? void 0 : _b.sendEvent(this.eventFactoryDefault.customEvent(key, checkedContext, data, metricValue));
+        (_b = this.eventProcessor) === null || _b === void 0 ? void 0 : _b.sendEvent(this.eventFactoryDefault.customEvent(key, this.checkedContext, data, metricValue));
     }
     variationInternal(flagKey, defaultValue, eventFactory, typeChecker) {
         var _a, _b, _c;
-        if (!this.context) {
+        if (!this.uncheckedContext) {
             this.logger.debug(ClientMessages.missingContextKeyNoEvent);
             return createErrorEvaluationDetail(ErrorKinds.UserNotSpecified, defaultValue);
         }
-        const evalContext = js_sdk_common_1.Context.fromLDContext(this.context);
-        const found = this.flags[flagKey];
-        if (!found || found.deleted) {
+        const evalContext = js_sdk_common_1.Context.fromLDContext(this.uncheckedContext);
+        const foundItem = this.flagManager.get(flagKey);
+        if (foundItem === undefined || foundItem.flag.deleted) {
             const defVal = defaultValue !== null && defaultValue !== void 0 ? defaultValue : null;
             const error = new js_sdk_common_1.LDClientError(`Unknown feature flag "${flagKey}"; returning default value ${defVal}.`);
-            this.emitter.emit('error', this.context, error);
+            this.emitter.emit('error', this.uncheckedContext, error);
             (_a = this.eventProcessor) === null || _a === void 0 ? void 0 : _a.sendEvent(this.eventFactoryDefault.unknownFlagEvent(flagKey, defVal, evalContext));
             return createErrorEvaluationDetail(ErrorKinds.FlagNotFound, defaultValue);
         }
-        const { reason, value, variation } = found;
+        const { reason, value, variation } = foundItem.flag;
         if (typeChecker) {
             const [matched, type] = typeChecker(value);
             if (!matched) {
                 (_b = this.eventProcessor) === null || _b === void 0 ? void 0 : _b.sendEvent(eventFactory.evalEventClient(flagKey, defaultValue, // track default value on type errors
-                defaultValue, found, evalContext, reason));
+                defaultValue, foundItem.flag, evalContext, reason));
                 const error = new js_sdk_common_1.LDClientError(`Wrong type "${type}" for feature flag "${flagKey}"; returning default value`);
-                this.emitter.emit('error', this.context, error);
+                this.emitter.emit('error', this.uncheckedContext, error);
                 return createErrorEvaluationDetail(ErrorKinds.WrongType, defaultValue);
             }
         }
@@ -341,7 +348,7 @@ class LDClientImpl {
             this.logger.debug('Result value is null in variation');
             successDetail.value = defaultValue;
         }
-        (_c = this.eventProcessor) === null || _c === void 0 ? void 0 : _c.sendEvent(eventFactory.evalEventClient(flagKey, value, defaultValue, found, evalContext, reason));
+        (_c = this.eventProcessor) === null || _c === void 0 ? void 0 : _c.sendEvent(eventFactory.evalEventClient(flagKey, value, defaultValue, foundItem.flag, evalContext, reason));
         return successDetail;
     }
     variation(flagKey, defaultValue) {
@@ -396,6 +403,51 @@ class LDClientImpl {
     jsonVariationDetail(key, defaultValue) {
         return this.variationDetail(key, defaultValue);
     }
+    /**
+     * Inform the client of the network state. Can be used to modify connection behavior.
+     *
+     * For instance the implementation may choose to suppress errors from connections if the client
+     * knows that there is no network available.
+     * @param _available True when there is an available network.
+     */
+    setNetworkAvailability(available) {
+        this.networkAvailable = available;
+        // Not yet supported.
+    }
+    /**
+     * 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) {
+        var _a, _b, _c, _d;
+        if (this.eventSendingEnabled === enabled) {
+            return;
+        }
+        this.eventSendingEnabled = enabled;
+        if (enabled) {
+            this.logger.debug('Starting event processor');
+            (_a = this.eventProcessor) === null || _a === void 0 ? void 0 : _a.start();
+        }
+        else if (flush) {
+            (_b = this.logger) === null || _b === void 0 ? void 0 : _b.debug('Flushing event processor before disabling.');
+            // Disable and flush.
+            this.flush().then(() => {
+                var _a, _b;
+                // 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) {
+                    (_a = this.logger) === null || _a === void 0 ? void 0 : _a.debug('Stopping event processor.');
+                    (_b = this.eventProcessor) === null || _b === void 0 ? void 0 : _b.close();
+                }
+            });
+        }
+        else {
+            // Just disabled.
+            (_c = this.logger) === null || _c === void 0 ? void 0 : _c.debug('Stopping event processor.');
+            (_d = this.eventProcessor) === null || _d === void 0 ? void 0 : _d.close();
+        }
+    }
 }
 exports.default = LDClientImpl;
 //# sourceMappingURL=LDClientImpl.js.map