@microsoft/applicationinsights-web 2.8.0-beta.2203-02 → 2.8.0-beta.2203-03

package/dist/applicationinsights-web.rollup.d.ts

@@ -1,5 +1,5 @@
 /*
- * Microsoft.ApplicationInsights, 2.8.0-beta.2203-02
+ * Microsoft.ApplicationInsights, 2.8.0-beta.2203-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -423,11 +423,26 @@ export declare class BaseCore implements IAppInsightsCore {
      * @returns - A ITelemetryInitializerHandler to enable the initializer to be removed
      */
     addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
+    /**
+     * Unload and Tear down the SDK and any initialized plugins, after calling this the SDK will be considered
+     * to be un-initialized and non-operational, re-initializing the SDK should only be attempted if the previous
+     * unload call return `true` stating that all plugins reported that they also unloaded, the recommended
+     * approach is to create a new instance and initialize that instance.
+     * This is due to possible unexpected side effects caused by plugins not supporting unload / teardown, unable
+     * to successfully remove any global references or they may just be completing the unload process asynchronously.
+     */
+    unload(isAsync?: boolean, unloadComplete?: () => void): void;
     getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
+    addPlugin<T extends IPlugin = ITelemetryPlugin>(plugin: T, replaceExisting: boolean, doAsync: boolean, addCb?: (added?: boolean) => void): void;
     /**
      * Returns the unique event namespace that should be used
      */
     evtNamespace(): string;
+    /**
+     * Add an unload handler that will be called when the SDK is being unloaded
+     * @param handler - the handler
+     */
+    addUnloadCb(handler: UnloadHandler): void;
     protected releaseQueue(): void;
 }
 
@@ -497,6 +512,11 @@ export declare abstract class BaseTelemetryPlugin implements ITelemetryPlugin {
      */
     teardown(unloadCtx?: IProcessTelemetryUnloadContext, unloadState?: ITelemetryUnloadState): void | boolean;
     abstract processTelemetry(env: ITelemetryItem, itemCtx?: IProcessTelemetryContext): void;
+    /**
+     * Add an unload handler that will be called when the SDK is being unloaded
+     * @param handler - the handler
+     */
+    protected _addUnloadCb(handler: UnloadHandler): void;
     /**
      * Add this hook so that it is automatically removed during unloading
      * @param hooks - The single hook or an array of IInstrumentHook objects
@@ -1056,15 +1076,36 @@ export declare interface IAppInsightsCore extends IPerfManagerProvider {
      * Return a new instance of the IProcessTelemetryContext for processing events
      */
     getProcessTelContext(): IProcessTelemetryContext;
+    /**
+     * Unload and Tear down the SDK and any initialized plugins, after calling this the SDK will be considered
+     * to be un-initialized and non-operational, re-initializing the SDK should only be attempted if the previous
+     * unload call return `true` stating that all plugins reported that they also unloaded, the recommended
+     * approach is to create a new instance and initialize that instance.
+     * This is due to possible unexpected side effects caused by plugins not supporting unload / teardown, unable
+     * to successfully remove any global references or they may just be completing the unload process asynchronously.
+     */
+    unload(isAsync?: boolean, unloadComplete?: () => void): void;
     /**
      * Find and return the (first) plugin with the specified identifier if present
      * @param pluginIdentifier
      */
     getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
+    /**
+     * Add a new plugin to the installation
+     * @param plugin - The new plugin to add
+     * @param replaceExisting - should any existing plugin be replaced
+     * @param doAsync - Should the add be performed asynchronously
+     */
+    addPlugin<T extends IPlugin = ITelemetryPlugin>(plugin: T, replaceExisting: boolean, doAsync: boolean, addCb?: (added?: boolean) => void): void;
     /**
      * Returns the unique event namespace that should be used when registering events
      */
     evtNamespace(): string;
+    /**
+     * Add a handler that will be called when the SDK is being unloaded
+     * @param handler - the handler
+     */
+    addUnloadCb(handler: UnloadHandler): void;
 }
 
 export declare interface IAppInsightsDeprecated {
@@ -2742,6 +2783,7 @@ declare interface ILoadedPlugin<T extends IPlugin> {
      * (unless it's also been re-initialized)
      */
     setEnabled: (isEnabled: boolean) => void;
+    remove: (isAsync?: boolean, removeCb?: (removed?: boolean) => void) => void;
 }
 
 declare interface ILocation {
@@ -4610,6 +4652,10 @@ declare const enum SendRequestReason {
      * The event(s) being sent as a retry
      */
     Retry = 5,
+    /**
+     * The SDK is unloading
+     */
+    SdkUnload = 6,
     /**
      * Maximum batch size would be exceeded
      */
@@ -4795,7 +4841,19 @@ declare const enum TelemetryUnloadReason {
     /**
      * Teardown has been called without any context.
      */
-    ManualTeardown = 0
+    ManualTeardown = 0,
+    /**
+     * Just this plugin is being removed
+     */
+    PluginUnload = 1,
+    /**
+     * This instance of the plugin is being removed and replaced
+     */
+    PluginReplace = 2,
+    /**
+     * The entire SDK is being unloaded
+     */
+    SdkUnload = 50
 }
 
 export declare class Trace extends MessageData implements ISerializable {
@@ -4815,6 +4873,8 @@ export declare class Trace extends MessageData implements ISerializable {
     });
 }
 
+declare type UnloadHandler = (itemCtx: IProcessTelemetryUnloadContext, unloadState: ITelemetryUnloadState) => void;
+
 export declare const Util: IUtil;
 
 declare interface XDomainRequest extends XMLHttpRequestEventTarget {

package/dist-esm/ApplicationInsightsContainer.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Web, 2.8.0-beta.2203-02
+ * Application Insights JavaScript SDK - Web, 2.8.0-beta.2203-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 import { AppInsightsDeprecated } from "./ApplicationInsightsDeprecated";

package/dist-esm/ApplicationInsightsDeprecated.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Web, 2.8.0-beta.2203-02
+ * Application Insights JavaScript SDK - Web, 2.8.0-beta.2203-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 import { stringToBoolOrDefault, ProcessLegacy } from "@microsoft/applicationinsights-common";

package/dist-esm/Init.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Web, 2.8.0-beta.2203-02
+ * Application Insights JavaScript SDK - Web, 2.8.0-beta.2203-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-esm/Initialization.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Web, 2.8.0-beta.2203-02
+ * Application Insights JavaScript SDK - Web, 2.8.0-beta.2203-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-esm/applicationinsights-web.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Web, 2.8.0-beta.2203-02
+ * Application Insights JavaScript SDK - Web, 2.8.0-beta.2203-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 export { Initialization as ApplicationInsights, Telemetry } from "./Initialization";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@microsoft/applicationinsights-web",
-    "version": "2.8.0-beta.2203-02",
+    "version": "2.8.0-beta.2203-03",
     "description": "Microsoft Application Insights JavaScript SDK - Web",
     "homepage": "https://github.com/microsoft/ApplicationInsights-JS#readme",
     "author": "Microsoft Application Insights Team",
@@ -66,12 +66,12 @@
     "dependencies": {
         "@microsoft/dynamicproto-js": "^1.1.4",
         "@microsoft/applicationinsights-shims": "2.0.1",
-        "@microsoft/applicationinsights-analytics-js": "2.8.0-beta.2203-02",
-        "@microsoft/applicationinsights-channel-js": "2.8.0-beta.2203-02",
-        "@microsoft/applicationinsights-common": "2.8.0-beta.2203-02",
-        "@microsoft/applicationinsights-core-js": "2.8.0-beta.2203-02",
-        "@microsoft/applicationinsights-dependencies-js": "2.8.0-beta.2203-02",
-        "@microsoft/applicationinsights-properties-js": "2.8.0-beta.2203-02"
+        "@microsoft/applicationinsights-analytics-js": "2.8.0-beta.2203-03",
+        "@microsoft/applicationinsights-channel-js": "2.8.0-beta.2203-03",
+        "@microsoft/applicationinsights-common": "2.8.0-beta.2203-03",
+        "@microsoft/applicationinsights-core-js": "2.8.0-beta.2203-03",
+        "@microsoft/applicationinsights-dependencies-js": "2.8.0-beta.2203-03",
+        "@microsoft/applicationinsights-properties-js": "2.8.0-beta.2203-03"
     },
     "license": "MIT",
     "publishConfig": {