@launchdarkly/js-sdk-common 2.11.0 → 2.13.0

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to `@launchdarkly/js-sdk-common` will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org).
 
+## [2.13.0](https://github.com/launchdarkly/js-core/compare/js-sdk-common-v2.12.0...js-sdk-common-v2.13.0) (2025-01-22)
+
+
+### Features
+
+* Adds StreamingProcessor for FDv2 to sdk-server package. ([#707](https://github.com/launchdarkly/js-core/issues/707)) ([7f5c275](https://github.com/launchdarkly/js-core/commit/7f5c2750dcc8341d049d7e736ca21ec36e168703))
+
+
+### Bug Fixes
+
+* Remove outdated reference to geolocation. ([#719](https://github.com/launchdarkly/js-core/issues/719)) ([0eeb3b6](https://github.com/launchdarkly/js-core/commit/0eeb3b6472419d257bf52c4ab3ae33864eae1902))
+
+## [2.12.0](https://github.com/launchdarkly/js-core/compare/js-sdk-common-v2.11.0...js-sdk-common-v2.12.0) (2024-11-04)
+
+
+### Features
+
+* Enhance basic logger destination support. ([#650](https://github.com/launchdarkly/js-core/issues/650)) ([21670c4](https://github.com/launchdarkly/js-core/commit/21670c4acd629f7ccfeb7abbe94fe89723533600))
+
 ## [2.11.0](https://github.com/launchdarkly/js-core/compare/js-sdk-common-v2.10.0...js-sdk-common-v2.11.0) (2024-10-17)
 
 

package/dist/cjs/api/context/LDContext.d.ts

@@ -2,7 +2,22 @@ import { LDMultiKindContext } from './LDMultiKindContext';
 import { LDSingleKindContext } from './LDSingleKindContext';
 import { LDUser } from './LDUser';
 /**
- * A LaunchDarkly context object.
+ * A LaunchDarkly context object.  LaunchDarkly contexts are objects representing users, devices, organizations, and
+ * other entities that feature flags serve different variations to according to your flag targeting rules. These data
+ * objects contain context attributes that describe what you know about that context, such as their name, location,
+ * device type, or organization they are associated with.
+ *
+ * You can manage how contexts interact with your app by targeting flag variations to specific contexts, based on
+ * their context attributes. When a flag evaluation occurs, the feature flag uses the evaluation context to understand
+ * what variation to serve. You can be as specific as targeting a flag to a single end context, or as broad as targeting
+ * your entire customer base. You can even use anonymous contexts and private attributes to control what data to
+ * include or exclude in the information you collect about your end users.
+ *
+ * LDContext is the newer replacement for the previous, less flexible LDUser type. The current SDK still supports
+ * LDUser, but LDContext is now the preferred model.
+ *
+ * See {@link LDSingleKindContext} and {@link LDMultiKindContext} for examples.  {@link LDContextCommon} includes
+ * additional propert
  */
 export type LDContext = LDUser | LDSingleKindContext | LDMultiKindContext;
 //# sourceMappingURL=LDContext.d.ts.map

package/dist/cjs/api/context/LDContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LDContext.d.ts","sourceRoot":"","sources":["../../../src/api/context/LDContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,mBAAmB,GAAG,kBAAkB,CAAC"}
+{"version":3,"file":"LDContext.d.ts","sourceRoot":"","sources":["../../../src/api/context/LDContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,mBAAmB,GAAG,kBAAkB,CAAC"}

package/dist/cjs/api/context/LDContextCommon.d.ts

@@ -1,4 +1,7 @@
 import { LDContextMeta } from './LDContextMeta';
+/**
+ * Common attributes shared by the various context types.
+ */
 export interface LDContextCommon {
     /**
      * A unique string identifying a context.

package/dist/cjs/api/context/LDContextCommon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LDContextCommon.d.ts","sourceRoot":"","sources":["../../../src/api/context/LDContextCommon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;CAC1B"}
+{"version":3,"file":"LDContextCommon.d.ts","sourceRoot":"","sources":["../../../src/api/context/LDContextCommon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;CAC1B"}

package/dist/cjs/api/context/LDUser.d.ts

@@ -35,10 +35,6 @@ export interface LDUser {
     avatar?: string;
     /**
      * The user's IP address.
-     *
-     * If you provide an IP, LaunchDarkly will use a geolocation service to
-     * automatically infer a `country` for the user, unless you've already
-     * specified one.
      */
     ip?: string;
     /**

package/dist/cjs/api/context/LDUser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LDUser.d.ts","sourceRoot":"","sources":["../../../src/api/context/LDUser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;KAC7E,CAAC;IAEF;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACvC"}
+{"version":3,"file":"LDUser.d.ts","sourceRoot":"","sources":["../../../src/api/context/LDUser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;KAC7E,CAAC;IAEF;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACvC"}

package/dist/cjs/api/logging/BasicLoggerOptions.d.ts

@@ -18,18 +18,21 @@ export interface BasicLoggerOptions {
      */
     name?: string;
     /**
-     * An optional function to use to print each log line.
+     * An optional function, or map of levels to functions, to use to print each log line.
      *
-     * If this is specified, `basicLogger` calls it to write each line of output. The
+     * If not specified, the default is `console.error`.
+     *
+     * If a function is specified, `basicLogger` calls it to write each line of output. The
      * argument is a fully formatted log line, not including a linefeed. The function
      * is only called for log levels that are enabled.
      *
-     * If not specified, the default is `console.error`.
+     * If a map is specified, then each entry will be used as the destination for the corresponding
+     * log level. Any level that is not specified will use the default of `console.error`.
      *
      * Setting this property to anything other than a function will cause SDK
      * initialization to fail.
      */
-    destination?: (line: string) => void;
+    destination?: ((line: string) => void) | Record<'debug' | 'info' | 'warn' | 'error', (line: string) => void>;
     /**
      * An optional formatter to use. The formatter should be compatible
      * with node-style format strings like those used with `util.format`.

package/dist/cjs/api/logging/BasicLoggerOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BasicLoggerOptions.d.ts","sourceRoot":"","sources":["../../../src/api/logging/BasicLoggerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAErC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC;CACxC"}
+{"version":3,"file":"BasicLoggerOptions.d.ts","sourceRoot":"","sources":["../../../src/api/logging/BasicLoggerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,EACR,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GACxB,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC;IAExE;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC;CACxC"}

package/dist/cjs/api/platform/AutoEnv.d.ts

@@ -5,8 +5,6 @@
  * model, operating system, locale, and so on. We recommend enabling this when you configure the SDK. To learn more,
  * read [Automatic environment attributes](https://docs.launchdarkly.com/sdk/features/environment-attributes).
  * for more documentation.
- *
- * The default is disabled.
  */
 export declare enum AutoEnvAttributes {
     Disabled = 0,

package/dist/cjs/api/platform/AutoEnv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AutoEnv.d.ts","sourceRoot":"","sources":["../../../src/api/platform/AutoEnv.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AACH,oBAAY,iBAAiB;IAC3B,QAAQ,IAAA;IACR,OAAO,IAAA;CACR;AAED,UAAU,aAAa;IACrB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAS,SAAQ,aAAa;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE;QACH;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH"}
+{"version":3,"file":"AutoEnv.d.ts","sourceRoot":"","sources":["../../../src/api/platform/AutoEnv.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AACH,oBAAY,iBAAiB;IAC3B,QAAQ,IAAA;IACR,OAAO,IAAA;CACR;AAED,UAAU,aAAa;IACrB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAS,SAAQ,aAAa;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE;QACH;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH"}

package/dist/cjs/api/platform/EventSource.d.ts

@@ -1,5 +1,5 @@
 import type { HttpErrorResponse } from './Requests';
-export type EventName = 'delete' | 'patch' | 'ping' | 'put';
+export type EventName = string;
 export type EventListener = (event?: {
     data?: any;
 }) => void;

package/dist/cjs/api/platform/EventSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventSource.d.ts","sourceRoot":"","sources":["../../../src/api/platform/EventSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,GAAG,CAAA;CAAE,KAAK,IAAI,CAAC;AAC7D,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC;IACvC,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACzD,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAE/D,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IACjE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC;IACjD,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,EAAE,MAAM,CAAC;CAClC"}
+{"version":3,"file":"EventSource.d.ts","sourceRoot":"","sources":["../../../src/api/platform/EventSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAC/B,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,GAAG,CAAA;CAAE,KAAK,IAAI,CAAC;AAC7D,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC;IACvC,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACzD,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAE/D,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IACjE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC;IACjD,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,EAAE,MAAM,CAAC;CAClC"}

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

@@ -14,4 +14,5 @@ export declare class LDStreamingError extends Error {
     readonly recoverable: boolean;
     constructor(kind: DataSourceErrorKind, message: string, code?: number, recoverable?: boolean);
 }
+export type StreamingErrorHandler = (err: LDStreamingError) => void;
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/datasource/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAEzB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,UAAO;CAO5F;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAEzB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,UAAO;CAO1F"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/datasource/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAEzB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,UAAO;CAO5F;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAEzB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,UAAO;CAO1F;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,CAAC"}

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

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

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

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

package/dist/cjs/index.cjs

@@ -860,8 +860,6 @@ class LDStreamingError extends Error {
  * model, operating system, locale, and so on. We recommend enabling this when you configure the SDK. To learn more,
  * read [Automatic environment attributes](https://docs.launchdarkly.com/sdk/features/environment-attributes).
  * for more documentation.
- *
- * The default is disabled.
  */
 exports.AutoEnvAttributes = void 0;
 (function (AutoEnvAttributes) {
@@ -1039,14 +1037,15 @@ function format(...args) {
     return args.map(tryStringify).join(' ');
 }
 
-const LogPriority = {
-    debug: 0,
-    info: 1,
-    warn: 2,
-    error: 3,
-    none: 4,
-};
-const LevelNames = ['debug', 'info', 'warn', 'error', 'none'];
+var LogPriority;
+(function (LogPriority) {
+    LogPriority[LogPriority["debug"] = 0] = "debug";
+    LogPriority[LogPriority["info"] = 1] = "info";
+    LogPriority[LogPriority["warn"] = 2] = "warn";
+    LogPriority[LogPriority["error"] = 3] = "error";
+    LogPriority[LogPriority["none"] = 4] = "none";
+})(LogPriority || (LogPriority = {}));
+const LEVEL_NAMES = ['debug', 'info', 'warn', 'error', 'none'];
 /**
  * A basic logger which handles filtering by level.
  *
@@ -1070,9 +1069,24 @@ class BasicLogger {
     constructor(options) {
         this._logLevel = LogPriority[options.level ?? 'info'] ?? LogPriority.info;
         this._name = options.name ?? 'LaunchDarkly';
-        // eslint-disable-next-line no-console
-        this._destination = options.destination;
         this._formatter = options.formatter;
+        if (typeof options.destination === 'object') {
+            this._destinations = {
+                [LogPriority.debug]: options.destination.debug,
+                [LogPriority.info]: options.destination.info,
+                [LogPriority.warn]: options.destination.warn,
+                [LogPriority.error]: options.destination.error,
+            };
+        }
+        else if (typeof options.destination === 'function') {
+            const { destination } = options;
+            this._destinations = {
+                [LogPriority.debug]: destination,
+                [LogPriority.info]: destination,
+                [LogPriority.warn]: destination,
+                [LogPriority.error]: destination,
+            };
+        }
     }
     _tryFormat(...args) {
         try {
@@ -1086,9 +1100,9 @@ class BasicLogger {
             return format(...args);
         }
     }
-    _tryWrite(msg) {
+    _tryWrite(destination, msg) {
         try {
-            this._destination(msg);
+            destination(msg);
         }
         catch {
             // eslint-disable-next-line no-console
@@ -1097,10 +1111,11 @@ class BasicLogger {
     }
     _log(level, args) {
         if (level >= this._logLevel) {
-            const prefix = `${LevelNames[level]}: [${this._name}]`;
+            const prefix = `${LEVEL_NAMES[level]}: [${this._name}]`;
             try {
-                if (this._destination) {
-                    this._tryWrite(`${prefix} ${this._tryFormat(...args)}`);
+                const destination = this._destinations?.[level];
+                if (destination) {
+                    this._tryWrite(destination, `${prefix} ${this._tryFormat(...args)}`);
                 }
                 else {
                     // `console.error` has its own formatter.
@@ -2311,104 +2326,155 @@ class EventFactoryBase {
     }
 }
 
-const reportJsonError = (type, data, logger, errorHandler) => {
-    logger?.error(`Stream received invalid data in "${type}" message`);
-    logger?.debug(`Invalid JSON follows: ${data}`);
-    errorHandler?.(new LDStreamingError(exports.DataSourceErrorKind.InvalidData, 'Malformed JSON data in event stream'));
-};
-// TODO: SDK-156 - Move to Server SDK specific location
-class StreamingProcessor {
-    constructor(clientContext, streamUriPath, parameters, _listeners, baseHeaders, _diagnosticsManager, _errorHandler, _streamInitialReconnectDelay = 1) {
-        this._listeners = _listeners;
-        this._diagnosticsManager = _diagnosticsManager;
-        this._errorHandler = _errorHandler;
-        this._streamInitialReconnectDelay = _streamInitialReconnectDelay;
-        const { basicConfiguration, platform } = clientContext;
-        const { logger } = basicConfiguration;
-        const { requests } = platform;
-        this._headers = { ...baseHeaders };
-        this._logger = logger;
-        this._requests = requests;
-        this._streamUri = getStreamingUri(basicConfiguration.serviceEndpoints, streamUriPath, 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;
-    }
+/**
+ * A FDv2 PayloadReader can be used to parse payloads from a stream of FDv2 events. It will send payloads
+ * to the PayloadListeners as the payloads are received. Invalid series of events may be dropped silently,
+ * but the payload reader will continue to operate.
+ */
+class PayloadReader {
     /**
-     * This is a wrapper around the passed errorHandler which adds additional
-     * diagnostics and logging logic.
+     * Creates a PayloadReader
      *
-     * @param err The error to be logged and handled.
-     * @return boolean whether to retry the connection.
-     *
-     * @private
+     * @param eventStream event stream of FDv2 events
+     * @param _objProcessors defines object processors for each object kind.
+     * @param _errorHandler that will be called with errors as they are encountered
+     * @param _logger for logging
      */
-    _retryAndHandleError(err) {
-        if (!shouldRetry(err)) {
-            this._logConnectionResult(false);
-            this._errorHandler?.(new LDStreamingError(exports.DataSourceErrorKind.ErrorResponse, err.message, err.status));
-            this._logger?.error(httpErrorMessage(err, 'streaming request'));
-            return false;
-        }
-        this._logger?.warn(httpErrorMessage(err, 'streaming request', 'will retry'));
-        this._logConnectionResult(false);
-        this._logConnectionStarted();
-        return true;
-    }
-    start() {
-        this._logConnectionStarted();
-        // TLS is handled by the platform implementation.
-        const eventSource = this._requests.createEventSource(this._streamUri, {
-            headers: this._headers,
-            errorFilter: (error) => this._retryAndHandleError(error),
-            initialRetryDelayMillis: 1000 * this._streamInitialReconnectDelay,
-            readTimeoutMillis: 5 * 60 * 1000,
-            retryResetIntervalMillis: 60 * 1000,
-        });
-        this._eventSource = eventSource;
-        eventSource.onclose = () => {
-            this._logger?.info('Closed LaunchDarkly stream connection');
+    constructor(eventStream, _objProcessors, _errorHandler, _logger) {
+        this._objProcessors = _objProcessors;
+        this._errorHandler = _errorHandler;
+        this._logger = _logger;
+        this._listeners = [];
+        this._tempId = undefined;
+        this._tempBasis = undefined;
+        this._tempUpdates = [];
+        this._processServerIntent = (data) => {
+            // clear state in prep for handling data
+            this._resetState();
+            // if there's no payloads, return
+            if (!data.payloads.length) {
+                return;
+            }
+            // at the time of writing this, it was agreed upon that SDKs could assume exactly 1 element in this list.  In the future, a negotiation of protocol version will be required to remove this assumption.
+            const payload = data.payloads[0];
+            switch (payload?.code) {
+                case 'xfer-full':
+                    this._tempBasis = true;
+                    break;
+                case 'xfer-changes':
+                case 'none':
+                    this._tempBasis = false;
+                    break;
+                default:
+                    // unrecognized intent code, return
+                    return;
+            }
+            this._tempId = payload?.id;
         };
-        eventSource.onerror = () => {
-            // The work is done by `errorFilter`.
+        this._processPutObject = (data) => {
+            // if the following properties haven't been provided by now, we should ignore the event
+            if (!this._tempId || // server intent hasn't been recieved yet.
+                !data.kind ||
+                !data.key ||
+                !data.version ||
+                !data.object) {
+                return;
+            }
+            const obj = this._processObj(data.kind, data.object);
+            if (!obj) {
+                this._logger?.warn(`Unable to prcoess object for kind: '${data.kind}'`);
+                // ignore unrecognized kinds
+                return;
+            }
+            this._tempUpdates.push({
+                kind: data.kind,
+                key: data.key,
+                version: data.version,
+                object: obj,
+                // intentionally omit deleted for this put
+            });
         };
-        eventSource.onopen = () => {
-            this._logger?.info('Opened LaunchDarkly stream connection');
+        this._processDeleteObject = (data) => {
+            // if the following properties haven't been provided by now, we should ignore the event
+            if (!this._tempId || !data.kind || !data.key || !data.version) {
+                return;
+            }
+            this._tempUpdates.push({
+                kind: data.kind,
+                key: data.key,
+                version: data.version,
+                // intentionally omit object for this delete
+                deleted: true,
+            });
         };
-        eventSource.onretrying = (e) => {
-            this._logger?.info(`Will retry stream connection in ${e.delayMillis} milliseconds`);
+        this._processPayloadTransferred = (data) => {
+            // if the following properties haven't been provided by now, we should reset
+            if (!this._tempId || // server intent hasn't been recieved yet.
+                !data.state ||
+                !data.version ||
+                this._tempBasis === undefined) {
+                this._resetState(); // a reset is best defensive action since payload transferred terminates a payload
+                return;
+            }
+            const payload = {
+                id: this._tempId,
+                version: data.version,
+                state: data.state,
+                basis: this._tempBasis,
+                updates: this._tempUpdates,
+            };
+            this._listeners.forEach((it) => it(payload));
+            this._resetState();
         };
-        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);
+        this._processGoodbye = (data) => {
+            this._logger?.info(`Goodbye was received from the LaunchDarkly connection with reason: ${data.reason}.`);
+            this._resetState();
+        };
+        this._processError = (data) => {
+            this._logger?.info(`An issue was encountered receiving updates for payload ${this._tempId} with reason: ${data.reason}. Automatic retry will occur.`);
+            this._resetState();
+        };
+        this._attachHandler(eventStream, 'server-intent', this._processServerIntent);
+        this._attachHandler(eventStream, 'put-object', this._processPutObject);
+        this._attachHandler(eventStream, 'delete-object', this._processDeleteObject);
+        this._attachHandler(eventStream, 'payload-transferred', this._processPayloadTransferred);
+        this._attachHandler(eventStream, 'goodbye', this._processGoodbye);
+        this._attachHandler(eventStream, 'error', this._processError);
+    }
+    addPayloadListener(listener) {
+        this._listeners.push(listener);
+    }
+    removePayloadListener(listener) {
+        const index = this._listeners.indexOf(listener, 0);
+        if (index > -1) {
+            this._listeners.splice(index, 1);
+        }
+    }
+    _attachHandler(stream, eventName, processor) {
+        stream.addEventListener(eventName, async (event) => {
+            if (event?.data) {
+                this._logger?.debug(`Received ${eventName} event.  Data is ${event.data}`);
+                try {
+                    processor(JSON.parse(event.data));
                 }
-                else {
-                    this._errorHandler?.(new LDStreamingError(exports.DataSourceErrorKind.Unknown, 'Unexpected payload from event stream'));
+                catch {
+                    this._logger?.error(`Stream received data that was unable to be processed in "${eventName}" message`);
+                    this._logger?.debug(`Data follows: ${event.data}`);
+                    this._errorHandler?.(exports.DataSourceErrorKind.InvalidData, 'Malformed data in event stream');
                 }
-            });
+            }
+            else {
+                this._errorHandler?.(exports.DataSourceErrorKind.Unknown, 'Unexpected message from event stream');
+            }
         });
     }
-    stop() {
-        this._eventSource?.close();
-        this._eventSource = undefined;
+    _processObj(kind, jsonObj) {
+        return this._objProcessors[kind]?.(jsonObj);
     }
-    close() {
-        this.stop();
+    _resetState() {
+        this._tempId = undefined;
+        this._tempBasis = undefined;
+        this._tempUpdates = [];
     }
 }
 
@@ -2423,7 +2489,7 @@ var index = /*#__PURE__*/Object.freeze({
     InputEvalEvent: InputEvalEvent,
     InputIdentifyEvent: InputIdentifyEvent,
     NullEventProcessor: NullEventProcessor,
-    StreamingProcessor: StreamingProcessor,
+    PayloadReader: PayloadReader,
     isLegacyUser: isLegacyUser,
     isMultiKind: isMultiKind,
     isSingleKind: isSingleKind,