launchdarkly-js-sdk-common 3.5.0 → 4.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "launchdarkly-js-sdk-common",
-  "version": "3.5.0",
+  "version": "4.0.0",
   "description": "LaunchDarkly SDK for JavaScript - common code",
   "author": "LaunchDarkly <team@launchdarkly.com>",
   "license": "Apache-2.0",
@@ -73,7 +73,7 @@
   "dependencies": {
     "base64-js": "^1.3.0",
     "fast-deep-equal": "^2.0.1",
-    "uuid": "^3.3.2"
+    "uuid": "^8.0.0"
   },
   "repository": {
     "type": "git",

package/typings.d.ts

@@ -46,18 +46,6 @@ declare module 'launchdarkly-js-sdk-common' {
     error: (message: string) => void;
   }
 
-  /**
-   * A basic implementation of logging that uses the global `console` object. This is used by
-   * default in the browser SDK. It sends messages of "debug", "info", "warn", or "error"
-   * level (if enable) to `console.log()`, `console.info()`, `console.warn()`, and `console.error()`
-   * respectively.
-   *
-   * To make LDClient use this logger, put it in the `logger` property of [[LDOptions]].
-   * 
-   * @deprecated Please use `basicLogger` instead.
-   */
-  export function createConsoleLogger(minimumLevel: string): LDLogger;
-
   /**
    * LaunchDarkly initialization options that are supported by all variants of the JS client.
    * The browser SDK and Electron SDK may support additional options.
@@ -223,17 +211,6 @@ declare module 'launchdarkly-js-sdk-common' {
      */
     flushInterval?: number;
 
-    /**
-     * If specified, enables event sampling so that only some fraction of analytics events will be
-     * sent pseudo-randomly.
-     *
-     * When set to greater than zero, there is a 1 in `samplingInterval` chance that events will be
-     * sent: for example, a value of 20 means that on average 1 in 20, or 5%, of all events will be sent.
-     *
-     * @deprecated This feature will be removed in a future version.
-     */
-    samplingInterval?: number;
-
     /**
      * How long (in milliseconds) to wait after a failure of the stream connection before trying to
      * reconnect.
@@ -374,12 +351,8 @@ declare module 'launchdarkly-js-sdk-common' {
   /**
    * Describes the reason that a flag evaluation produced a particular value. This is
    * part of the [[LDEvaluationDetail]] object returned by [[LDClient.variationDetail]].
-   *
-   * This type is separate from `[[LDEvaluationReason]]` for backwards compatibility. In
-   * earlier versions of this SDK, `[[LDEvaluationReason]]` was incorrectly defined as
-   * being non-nullable.
    */
-  interface NonNullableLDEvaluationReason {
+  interface LDEvaluationReason {
     /**
      * The general category of the reason:
      *
@@ -415,14 +388,6 @@ declare module 'launchdarkly-js-sdk-common' {
     prerequisiteKey?: string;
   }
 
-  /**
-   * Describes the reason that a flag evaluation produced a particular value. This is
-   * part of the [[LDEvaluationDetail]] object returned by [[LDClient.variationDetail]].
-   *
-   * Will be null when `[[LDOptions.evaluationReasons]]` is `false`.
-   */
-  export type LDEvaluationReason = NonNullableLDEvaluationReason | null;
-
   /**
    * An object that combines the result of a feature flag evaluation with information about
    * how it was calculated.
@@ -446,8 +411,10 @@ declare module 'launchdarkly-js-sdk-common' {
 
     /**
      * An object describing the main factor that influenced the flag evaluation value.
+     * This will be `null`/`undefined` if the SDK was not configured to get evaluation
+     * reasons.
      */
-    reason: LDEvaluationReason;
+    reason?: LDEvaluationReason;
   }
 
   /**