@launchdarkly/js-client-sdk-common 1.17.2 → 1.18.1

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

@@ -1,26 +1,13 @@
 import { DataSourceErrorKind } from '@launchdarkly/js-sdk-common';
 import LDEmitter from '../LDEmitter';
-import DataSourceStatus, { DataSourceState } from './DataSourceStatus';
+import DataSourceStatus, { type DataSourceState } from './DataSourceStatus';
 /**
  * Tracks the current data source status and emits updates when the status changes.
  */
-export default class DataSourceStatusManager {
-    private readonly _emitter;
-    private _state;
-    private _stateSinceMillis;
-    private _errorInfo?;
-    private _timeStamper;
-    constructor(_emitter: LDEmitter, timeStamper?: () => number);
-    get status(): DataSourceStatus;
+export interface DataSourceStatusManager {
+    readonly status: DataSourceStatus;
     /**
-     * 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.
-     */
-    private _updateState;
-    /**
-     * Requests the manager move to the provided state.  This request may be ignored
+     * 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
      */
@@ -37,4 +24,6 @@ export default class DataSourceStatusManager {
      */
     reportError(kind: DataSourceErrorKind, message: string, statusCode?: number, recoverable?: boolean): void;
 }
+export declare function createDataSourceStatusManager(emitter: LDEmitter, timeStamper?: () => number): DataSourceStatusManager;
+export default DataSourceStatusManager;
 //# sourceMappingURL=DataSourceStatusManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"DataSourceStatusManager.d.ts","sourceRoot":"","sources":["../../src/datasource/DataSourceStatusManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,SAAS,MAAM,cAAc,CAAC;AACrC,OAAO,gBAAgB,EAAE,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGvE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAuB;IAOxC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,UAAU,CAAC,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAAe;gBAGhB,QAAQ,EAAE,SAAS,EACpC,WAAW,GAAE,MAAM,MAAyB;IAO9C,IAAI,MAAM,IAAI,gBAAgB,CAM7B;IAED;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,eAAe;IAIzC;;;;;;;;;OASG;IACH,WAAW,CACT,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,GAAE,OAAe;CAgB/B"}
+{"version":3,"file":"DataSourceStatusManager.d.ts","sourceRoot":"","sources":["../../src/datasource/DataSourceStatusManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,SAAS,MAAM,cAAc,CAAC;AACrC,OAAO,gBAAgB,EAAE,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG5E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAElC;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAEjD;;;;;;;;;OASG;IACH,WAAW,CACT,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,OAAO,GACpB,IAAI,CAAC;CAIT;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,SAAS,EAClB,WAAW,GAAE,MAAM,MAAyB,GAC3C,uBAAuB,CA2DzB;AAED,eAAe,uBAAuB,CAAC"}

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

@@ -8,19 +8,12 @@ export declare class LDRequestError extends Error implements HttpErrorResponse {
  * Note: The requestor is implemented independently from polling such that it can be used to
  * make a one-off request.
  */
-export default class Requestor {
-    private _requests;
-    private readonly _uri;
-    private readonly _headers;
-    private readonly _method;
-    private readonly _body?;
-    constructor(_requests: Requests, _uri: string, _headers: {
-        [key: string]: string;
-    }, _method: string, _body?: string | undefined);
+export interface Requestor {
     requestPayload(): Promise<string>;
 }
 export declare function makeRequestor(plainContextString: string, serviceEndpoints: ServiceEndpoints, paths: DataSourcePaths, requests: Requests, encoding: Encoding, baseHeaders?: LDHeaders, baseQueryParams?: {
     key: string;
     value: string;
 }[], withReasons?: boolean, useReport?: boolean, secureModeHash?: string): Requestor;
+export default Requestor;
 //# sourceMappingURL=Requestor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Requestor.d.ts","sourceRoot":"","sources":["../../src/datasource/Requestor.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EAER,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMrD,qBAAa,cAAe,SAAQ,KAAM,YAAW,iBAAiB;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAK7C;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAE1B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAJf,SAAS,EAAE,QAAQ,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EACnC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,oBAAQ;IAG3B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CAkBxC;AAED,wBAAgB,aAAa,CAC3B,kBAAkB,EAAE,MAAM,EAC1B,gBAAgB,EAAE,gBAAgB,EAClC,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,WAAW,CAAC,EAAE,SAAS,EACvB,eAAe,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EAClD,WAAW,CAAC,EAAE,OAAO,EACrB,SAAS,CAAC,EAAE,OAAO,EACnB,cAAc,CAAC,EAAE,MAAM,aA0BxB"}
+{"version":3,"file":"Requestor.d.ts","sourceRoot":"","sources":["../../src/datasource/Requestor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAER,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMrD,qBAAa,cAAe,SAAQ,KAAM,YAAW,iBAAiB;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAK7C;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,wBAAgB,aAAa,CAC3B,kBAAkB,EAAE,MAAM,EAC1B,gBAAgB,EAAE,gBAAgB,EAClC,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,WAAW,CAAC,EAAE,SAAS,EACvB,eAAe,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EAClD,WAAW,CAAC,EAAE,OAAO,EACrB,SAAS,CAAC,EAAE,OAAO,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,SAAS,CA6CX;AAED,eAAe,SAAS,CAAC"}

package/dist/esm/flag-manager/bootstrap.d.ts

@@ -0,0 +1,6 @@
+import { LDLogger } from '@launchdarkly/js-sdk-common';
+import { ItemDescriptor } from './ItemDescriptor';
+export declare function readFlagsFromBootstrap(logger: LDLogger, data: any): {
+    [key: string]: ItemDescriptor;
+};
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/esm/flag-manager/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/flag-manager/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,GAAG,GACR;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;CAAE,CAyCnC"}

package/dist/esm/index.d.ts

@@ -1,7 +1,7 @@
 import { LDClientInternalOptions } from './configuration/Configuration';
 import DataSourceStatus, { DataSourceState } from './datasource/DataSourceStatus';
 import DataSourceStatusErrorInfo from './datasource/DataSourceStatusErrorInfo';
-import Requestor, { makeRequestor } from './datasource/Requestor';
+import { makeRequestor, Requestor } from './datasource/Requestor';
 import LDClientImpl from './LDClientImpl';
 import LDEmitter, { EventName } from './LDEmitter';
 export * from '@launchdarkly/js-sdk-common';
@@ -14,6 +14,7 @@ export type { Configuration } from './configuration/Configuration';
 export type { LDEmitter };
 export type { ItemDescriptor } from './flag-manager/ItemDescriptor';
 export type { Flag } from './types';
+export { readFlagsFromBootstrap } from './flag-manager/bootstrap';
 export { DataSourcePaths } from './streaming';
 export { BaseDataManager } from './DataManager';
 export { makeRequestor, Requestor };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,gBAAgB,EAAE,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,yBAAyB,MAAM,wCAAwC,CAAC;AAC/E,OAAO,SAAS,EAAE,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD,cAAc,6BAA6B,CAAC;AAE5C,OAAO,KAAK,QAAQ,MAAM,6BAA6B,CAAC;AAMxD,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,QAAQ,EACR,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,IAAI,EACJ,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,8BAA8B,EAC9B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,SAAS,EACT,eAAe,GAChB,MAAM,OAAO,CAAC;AAEf,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,gCAAgC,EAAE,MAAM,4CAA4C,CAAC;AAC9F,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,YAAY,EAAE,SAAS,EAAE,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAEpC,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,SAAS,IAAI,kBAAkB,GAChC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,gBAAgB,EAAE,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,yBAAyB,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD,cAAc,6BAA6B,CAAC;AAE5C,OAAO,KAAK,QAAQ,MAAM,6BAA6B,CAAC;AAMxD,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,QAAQ,EACR,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,IAAI,EACJ,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,8BAA8B,EAC9B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,SAAS,EACT,eAAe,GAChB,MAAM,OAAO,CAAC;AAEf,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,gCAAgC,EAAE,MAAM,4CAA4C,CAAC;AAC9F,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,YAAY,EAAE,SAAS,EAAE,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAEpC,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,SAAS,IAAI,kBAAkB,GAChC,CAAC"}

package/dist/esm/index.mjs

@@ -3,18 +3,17 @@ export * from '@launchdarkly/js-sdk-common';
 import * as jsSdkCommon from '@launchdarkly/js-sdk-common';
 export { jsSdkCommon as platform };
 
-var DataSourceState;
-(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,
-})(DataSourceState || (DataSourceState = {}));
+// This is a temporary compat for react native. We should remove this once we
+// major version react native SDK.
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+const DataSourceState = {
+    Initializing: 'INITIALIZING',
+    Valid: 'VALID',
+    Interrupted: 'INTERRUPTED',
+    SetOffline: 'SET_OFFLINE',
+    Closed: 'CLOSED',
+};
 
-// eslint-disable-next-line max-classes-per-file
 function isOk(status) {
     return status >= 200 && status <= 299;
 }
@@ -25,38 +24,6 @@ class LDRequestError extends Error {
         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);
-    }
-}
 function makeRequestor(plainContextString, serviceEndpoints, paths, requests, encoding, baseHeaders, baseQueryParams, withReasons, useReport, secureModeHash) {
     let body;
     let method = 'GET';
@@ -77,7 +44,27 @@ function makeRequestor(plainContextString, serviceEndpoints, paths, requests, en
         parameters.push({ key: 'h', value: secureModeHash });
     }
     const uri = getPollingUri(serviceEndpoints, path, parameters);
-    return new Requestor(requests, uri, headers, method, body);
+    return {
+        async requestPayload() {
+            let status;
+            try {
+                const res = await requests.fetch(uri, {
+                    method,
+                    headers,
+                    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);
+        },
+    };
 }
 
 const duplicateExecutionError = new Error('Task has already been executed or shed. This is likely an implementation error. The task will not be executed again.');
@@ -1321,6 +1308,10 @@ class LDEmitter {
         this._listeners = new Map();
     }
     on(name, listener) {
+        if (typeof name !== 'string') {
+            this._logger?.warn('Only string event names are supported.');
+            return;
+        }
         if (!this._listeners.has(name)) {
             this._listeners.set(name, [listener]);
         }
@@ -1931,117 +1922,135 @@ function safeRegisterDebugOverridePlugins(logger, debugOverride, plugins) {
     });
 }
 
-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(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);
-    }
+function readFlagsFromBootstrap(logger, data) {
+    // If the bootstrap data came from an older server-side SDK, we'll have just a map of keys to values.
+    // Newer SDKs that have an allFlagsState method will provide an extra "$flagsState" key that contains
+    // the rest of the metadata we want. We do it this way for backward compatibility with older JS SDKs.
+    const keys = Object.keys(data);
+    const metadataKey = '$flagsState';
+    const validKey = '$valid';
+    const metadata = data[metadataKey];
+    if (!metadata && keys.length) {
+        logger.warn('LaunchDarkly client was initialized with bootstrap data that did not include flag' +
+            ' metadata. Events may not be sent correctly.');
+    }
+    if (data[validKey] === false) {
+        logger.warn('LaunchDarkly bootstrap data is not available because the back end could not read the flags.');
+    }
+    const ret = {};
+    keys.forEach((key) => {
+        if (key !== metadataKey && key !== validKey) {
+            let flag;
+            if (metadata && metadata[key]) {
+                flag = {
+                    value: data[key],
+                    ...metadata[key],
+                };
+            }
+            else {
+                flag = {
+                    value: data[key],
+                    version: 0,
+                };
+            }
+            ret[key] = {
+                version: flag.version,
+                flag,
+            };
+        }
+    });
+    return ret;
 }
 
-/**
- * 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 = DataSourceState.Closed;
-        this._stateSinceMillis = timeStamper();
-        this._timeStamper = timeStamper;
-    }
-    get status() {
+function createDataSourceEventHandler(flagManager, statusManager, logger) {
+    return {
+        async handlePut(context, flags) {
+            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 flagManager.init(context, descriptors);
+            statusManager.requestStateUpdate('VALID');
+        },
+        async handlePatch(context, patchFlag) {
+            logger.debug(`Got PATCH ${JSON.stringify(patchFlag, null, 2)}`);
+            flagManager.upsert(context, patchFlag.key, {
+                version: patchFlag.version,
+                flag: patchFlag,
+            });
+        },
+        async handleDelete(context, deleteFlag) {
+            logger.debug(`Got DELETE ${JSON.stringify(deleteFlag, null, 2)}`);
+            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) {
+            statusManager.reportError(error.kind, error.message, error.code, error.recoverable);
+        },
+        handlePollingError(error) {
+            statusManager.reportError(error.kind, error.message, error.status, error.recoverable);
+        },
+    };
+}
+
+function createDataSourceStatusManager(emitter, timeStamper = () => Date.now()) {
+    let state = 'CLOSED';
+    let stateSinceMillis = timeStamper();
+    let errorInfo;
+    function getStatus() {
         return {
-            state: this._state,
-            stateSince: this._stateSinceMillis,
-            lastError: this._errorInfo,
+            state,
+            stateSince: stateSinceMillis,
+            lastError: 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 === DataSourceState.Interrupted && this._state === DataSourceState.Initializing // don't go to interrupted from initializing (recoverable errors when initializing are not noteworthy)
-            ? DataSourceState.Initializing
+    function updateState(requestedState, isError = false) {
+        const newState = requestedState === 'INTERRUPTED' && state === 'INITIALIZING' // don't go to interrupted from initializing (recoverable errors when initializing are not noteworthy)
+            ? 'INITIALIZING'
             : requestedState;
-        const changedState = this._state !== newState;
+        const changedState = state !== newState;
         if (changedState) {
-            this._state = newState;
-            this._stateSinceMillis = this._timeStamper();
+            state = newState;
+            stateSinceMillis = timeStamper();
         }
         if (changedState || isError) {
-            this._emitter.emit('dataSourceStatus', this.status);
+            emitter.emit('dataSourceStatus', getStatus());
         }
     }
-    /**
-     * 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 ? DataSourceState.Interrupted : DataSourceState.Closed, true);
-    }
+    return {
+        get status() {
+            return getStatus();
+        },
+        requestStateUpdate(requestedState) {
+            updateState(requestedState);
+        },
+        reportError(kind, message, statusCode, recoverable = false) {
+            errorInfo = {
+                kind,
+                message,
+                statusCode,
+                time: timeStamper(),
+            };
+            updateState(recoverable ? 'INTERRUPTED' : 'CLOSED', true);
+        },
+        // TODO: SDK-702 - Implement network availability behaviors
+        // setNetworkUnavailable() {
+        //   updateState(DataSourceState.NetworkUnavailable);
+        // },
+    };
 }
 
 function reportClosed(logger) {
@@ -2323,8 +2332,8 @@ class BaseDataManager {
         this.diagnosticsManager = diagnosticsManager;
         this.closed = false;
         this.logger = config.logger;
-        this.dataSourceStatusManager = new DataSourceStatusManager(emitter);
-        this._dataSourceEventHandler = new DataSourceEventHandler(flagManager, this.dataSourceStatusManager, this.config.logger);
+        this.dataSourceStatusManager = createDataSourceStatusManager(emitter);
+        this._dataSourceEventHandler = createDataSourceEventHandler(flagManager, this.dataSourceStatusManager, this.config.logger);
     }
     /**
      * Set additional connection parameters for requests polling/streaming.
@@ -2387,16 +2396,16 @@ class BaseDataManager {
         return {
             start: () => {
                 // update status before starting processor to ensure potential errors are reported after initializing
-                statusManager.requestStateUpdate(DataSourceState.Initializing);
+                statusManager.requestStateUpdate('INITIALIZING');
                 processor.start();
             },
             stop: () => {
                 processor.stop();
-                statusManager.requestStateUpdate(DataSourceState.Closed);
+                statusManager.requestStateUpdate('CLOSED');
             },
             close: () => {
                 processor.close();
-                statusManager.requestStateUpdate(DataSourceState.Closed);
+                statusManager.requestStateUpdate('CLOSED');
             },
         };
     }
@@ -2406,5 +2415,5 @@ class BaseDataManager {
     }
 }
 
-export { BaseDataManager, DataSourceState, LDClientImpl, Requestor, makeRequestor, safeRegisterDebugOverridePlugins };
+export { BaseDataManager, DataSourceState, LDClientImpl, makeRequestor, readFlagsFromBootstrap, safeRegisterDebugOverridePlugins };
 //# sourceMappingURL=index.mjs.map