launchdarkly-js-sdk-common 3.6.0 → 3.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "launchdarkly-js-sdk-common",
-  "version": "3.6.0",
+  "version": "3.8.0",
   "description": "LaunchDarkly SDK for JavaScript - common code",
   "author": "LaunchDarkly <team@launchdarkly.com>",
   "license": "Apache-2.0",

package/typings.d.ts

@@ -191,10 +191,13 @@ declare module 'launchdarkly-js-sdk-common' {
     inlineUsersInEvents?: boolean;
 
     /**
-     * Whether or not to send an analytics event for a flag evaluation even if the same flag was
-     * evaluated with the same value within the last five minutes.
+     * This option is deprecated, and setting it has no effect.
      *
-     * By default, this is false (duplicate events within five minutes will be dropped).
+     * The behavior is now to allow frequent duplicate events.
+     *
+     * This is not a problem because most events will be summarized, and
+     * events which are not summarized are important to the operation of features such as
+     * experimentation.
      */
     allowFrequentDuplicateEvents?: boolean;
 
@@ -313,6 +316,11 @@ declare module 'launchdarkly-js-sdk-common' {
        */
       version?: string;
     }
+
+    /**
+     * Inspectors can be used for collecting information for monitoring, analytics, and debugging.
+     */
+    inspectors?: LDInspection[];
   }
 
   /**
@@ -856,4 +864,105 @@ declare module 'launchdarkly-js-sdk-common' {
    * You can also specify `'none'` instead to disable all logging.
    */
   export type LDLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';
+
+  /**
+   * Callback interface for collecting information about the SDK at runtime.
+   * 
+   * This interface is used to collect information about flag usage.
+   * 
+   * This interface should not be used by the application to access flags for the purpose of controlling application
+   * flow. It is intended for monitoring, analytics, or debugging purposes.
+   */
+  interface LDInspectionFlagUsedHandler {
+    type: 'flag-used',
+
+    /**
+     * Name of the inspector. Will be used for logging issues with the inspector.
+     */
+    name: string,
+
+    /**
+     * This method is called when a flag is accessed via a variation method, or it can be called based on actions in
+     * wrapper SDKs which have different methods of tracking when a flag was accessed. It is not called when a call is made
+     * to allFlags.
+     */
+    method: (flagKey: string, flagDetail: LDEvaluationDetail, user: LDUser) => void;
+  }
+  
+  /**
+   * Callback interface for collecting information about the SDK at runtime.
+   * 
+   * This interface is used to collect information about flag data. In order to understand the
+   * current flag state it should be combined with {@link LDInspectionFlagValueChangedHandler}.
+   * This interface will get the initial flag information, and 
+   * {@link LDInspectionFlagValueChangedHandler} will provide changes to individual flags.
+   * 
+   * This interface should not be used by the application to access flags for the purpose of controlling application
+   * flow. It is intended for monitoring, analytics, or debugging purposes.
+   */
+  interface LDInspectionFlagDetailsChangedHandler {
+    type: 'flag-details-changed',
+
+    /**
+     * Name of the inspector. Will be used for logging issues with the inspector.
+     */
+    name: string,
+    
+    /**
+     * This method is called when the flags in the store are replaced with new flags. It will contain all flags
+     * regardless of if they have been evaluated.
+     */
+    method: (details: Record<string, LDEvaluationDetail>) => void;
+  }
+  
+    
+  /**
+   * Callback interface for collecting information about the SDK at runtime.
+   * 
+   * This interface is used to collect changes to flag data, but does not provide the initial
+   * data. It can be combined with {@link LDInspectionFlagValuesChangedHandler} to track the
+   * entire flag state.
+   * 
+   * This interface should not be used by the application to access flags for the purpose of controlling application
+   * flow. It is intended for monitoring, analytics, or debugging purposes.
+   */
+  interface LDInspectionFlagDetailChangedHandler {
+    type: 'flag-detail-changed',
+
+    /**
+     * Name of the inspector. Will be used for logging issues with the inspector.
+     */
+    name: string,
+  
+    /**
+     * This method is called when a flag is updated. It will not be called
+     * when all flags are updated.
+     */
+    method: (flagKey: string, detail: LDEvaluationDetail) => void;
+  }
+
+  /**
+   * Callback interface for collecting information about the SDK at runtime.
+   * 
+   * This interface is used to track current identity state of the SDK.
+   * 
+   * This interface should not be used by the application to access flags for the purpose of controlling application
+   * flow. It is intended for monitoring, analytics, or debugging purposes.
+   */
+  interface LDInspectionIdentifyHandler {
+    type: 'client-identity-changed',
+
+    /**
+     * Name of the inspector. Will be used for logging issues with the inspector.
+     */
+    name: string,
+  
+    /**
+     * This method will be called when an identify operation completes.
+     */
+    method: (user: LDUser) => void;
+  }
+
+  type LDInspection = LDInspectionFlagUsedHandler | LDInspectionFlagDetailsChangedHandler
+    | LDInspectionFlagDetailChangedHandler | LDInspectionIdentifyHandler;
 }