@microsoft/applicationinsights-core-js 2.8.0-beta.2203-10 → 2.8.0-beta.2203-11

package/src/JavaScriptSDK/BaseCore.ts

@@ -41,7 +41,7 @@ const strValidationError = "Plugins must provide initialize method";
 const strNotificationManager = "_notificationManager";
 const strSdkUnloadingError = "SDK is still unloading...";
 const strSdkNotInitialized = "SDK is not initialized";
-const strPluginUnloadFailed = "Failed to unload plugin";
+// const strPluginUnloadFailed = "Failed to unload plugin";
 
 /**
  * Helper to create the default performance manager
@@ -126,22 +126,22 @@ export class BaseCore implements IAppInsightsCore {
         // NOTE!: DON'T set default values here, instead set them in the _initDefaults() function as it is also called during teardown()
         let _isInitialized: boolean;
         let _eventQueue: ITelemetryItem[];
-        let _notificationManager: INotificationManager;
-        let _perfManager: IPerfManager;
-        let _cfgPerfManager: IPerfManager;
-        let _cookieManager: ICookieMgr;
-        let _pluginChain: ITelemetryPluginChain;
+        let _notificationManager: INotificationManager | null | undefined;
+        let _perfManager: IPerfManager | null;
+        let _cfgPerfManager: IPerfManager | null;
+        let _cookieManager: ICookieMgr | null;
+        let _pluginChain: ITelemetryPluginChain | null;
         let _configExtensions: IPlugin[];
-        let _coreExtensions: ITelemetryPlugin[];
-        let _channelControl: IChannelController;
-        let _channelConfig: IChannelControls[][];
-        let _channelQueue: _IInternalChannels[];
+        let _coreExtensions: ITelemetryPlugin[] | null;
+        let _channelControl: IChannelController | null;
+        let _channelConfig: IChannelControls[][] | null | undefined;
+        let _channelQueue: _IInternalChannels[] | null;
         let _isUnloading: boolean;
         let _telemetryInitializerPlugin: TelemetryInitializerPlugin;
-        let _internalLogsEventName: string;
+        let _internalLogsEventName: string | null;
         let _evtNamespace: string;
         let _unloadHandlers: IUnloadHandlerContainer;
-        let _debugListener: INotificationListener;
+        let _debugListener: INotificationListener | null;
 
         /**
          * Internal log poller
@@ -204,9 +204,11 @@ export class BaseCore implements IAppInsightsCore {
         
             _self.getTransmissionControls = (): IChannelControls[][] => {
                 let controls: IChannelControls[][] = [];
-                arrForEach(_channelQueue, (channels) => {
-                    controls.push(channels.queue);
-                });
+                if (_channelQueue) {
+                    arrForEach(_channelQueue, (channels) => {
+                        controls.push(channels.queue);
+                    });
+                }
 
                 return objFreeze(controls);
             };
@@ -311,7 +313,7 @@ export class BaseCore implements IAppInsightsCore {
              * Periodically check logger.queue for log messages to be flushed
              */
             _self.pollInternalLogs = (eventName?: string): number => {
-                _internalLogsEventName = eventName;
+                _internalLogsEventName = eventName || null;
 
                 let interval = _self.config.diagnosticLogInterval;
                 if (!interval || !(interval > 0)) {
@@ -418,7 +420,7 @@ export class BaseCore implements IAppInsightsCore {
                     let removedPlugins: IPlugin[] = [existingPlugin.plugin];
                     let unloadState: ITelemetryUnloadState = {
                         reason: TelemetryUnloadReason.PluginReplace,
-                        isAsync: isAsync
+                        isAsync: !!isAsync
                     };
 
                     _removePlugins(removedPlugins, unloadState, (removed) => {
@@ -450,7 +452,7 @@ export class BaseCore implements IAppInsightsCore {
 
                 // Use a default logger so initialization errors are not dropped on the floor with full logging
                 _self.logger = new DiagnosticLogger({ loggingLevelConsole: eLoggingSeverity.CRITICAL });
-                _self.config = null;
+                _self.config = {};
                 _self._extensions = [];
 
                 _telemetryInitializerPlugin = new TelemetryInitializerPlugin();
@@ -461,7 +463,7 @@ export class BaseCore implements IAppInsightsCore {
                 _cookieManager = null;
                 _pluginChain = null;
                 _coreExtensions = null;
-                _configExtensions = null;
+                _configExtensions = [];
                 _channelControl = null;
                 _channelConfig = null;
                 _channelQueue = null;
@@ -476,7 +478,7 @@ export class BaseCore implements IAppInsightsCore {
             }
 
             // Initialize or Re-initialize the plugins
-            function _initPluginChain(config: IConfiguration, updateState: ITelemetryUpdateState) {
+            function _initPluginChain(config: IConfiguration, updateState: ITelemetryUpdateState | null) {
                 // Extension validation
                 let theExtensions = _validateExtensions(_self.logger, ChannelControllerPriority, _configExtensions);
             

package/src/JavaScriptSDK/ChannelController.ts

@@ -61,7 +61,7 @@ export function createChannelControllerPlugin(channelQueue: _IInternalChannels[]
         return createProcessTelemetryContext(null, core.config, core, null)
     }
 
-    function _processChannelQueue<T extends IBaseProcessingContext>(theChannels: _IInternalChannels[], itemCtx: T, processFn: (chainCtx: T) => void, onComplete: () => void) {
+    function _processChannelQueue<T extends IBaseProcessingContext>(theChannels: _IInternalChannels[], itemCtx: T, processFn: (chainCtx: T) => void, onComplete: (() => void) | null) {
         let waiting = theChannels ? (theChannels.length + 1) : 1;
 
         function _runChainOnComplete() {

package/src/JavaScriptSDK/DataCacheHelper.ts

@@ -7,7 +7,7 @@ import { newId } from "./RandomHelper";
 
 const _objDefineProperty = ObjDefineProperty;
 
-const version = "2.7.3";
+const version = "2.8.0-beta.2203-11";
 let instanceName = "." + newId(6);
 let _dataUid = 0;
 

package/src/JavaScriptSDK/EventHelpers.ts

@@ -52,7 +52,7 @@ function _normalizeNamespace(name: string) {
     return name;
 }
 
-function _getEvtNamespace(eventName: string, evtNamespace?: string | string[]): IEventDetails {
+function _getEvtNamespace(eventName: string | undefined, evtNamespace?: string | string[] | null): IEventDetails {
     if (evtNamespace) {
         let theNamespace: string = "";
         if (isArray(evtNamespace)) {
@@ -81,7 +81,7 @@ function _getEvtNamespace(eventName: string, evtNamespace?: string | string[]):
         }
     }
 
-    let parsedEvent: any[] = (eventNamespace.exec(eventName) || []);
+    let parsedEvent: any[] = (eventNamespace.exec(eventName || "") || []);
 
     return {
         type: parsedEvent[1],
@@ -195,7 +195,7 @@ function _unregisterEvents(target: any, evtName: IEventDetails, unRegFn: (regEve
     }
 }
 
-export function mergeEvtNamespace(theNamespace: string, namespaces: string | string[]): string | string[] {
+export function mergeEvtNamespace(theNamespace: string, namespaces?: string | string[] | null): string | string[] {
     let newNamespaces: string | string[];
 
     if (namespaces) {
@@ -225,7 +225,7 @@ export function mergeEvtNamespace(theNamespace: string, namespaces: string | str
  * @param useCapture [Optional] Defaults to false
  * @returns True if the function was bound successfully to the event, otherwise false
  */
-export function eventOn<T>(target: T, eventName: string, handlerRef: any, evtNamespace?: string | string[], useCapture: boolean = false) {
+export function eventOn<T>(target: T, eventName: string, handlerRef: any, evtNamespace?: string | string[] | null, useCapture: boolean = false) {
     let result = false;
 
     if (target) {
@@ -263,7 +263,7 @@ export function eventOn<T>(target: T, eventName: string, handlerRef: any, evtNam
  * if the eventName also includes a namespace the namespace(s) are merged into a single namespace
  * @param useCapture [Optional] Defaults to false
  */
-export function eventOff<T>(target: T, eventName: string, handlerRef: any, evtNamespace?: string | string[], useCapture: boolean = false) {
+export function eventOff<T>(target: T, eventName: string, handlerRef: any, evtNamespace?: string | string[] | null, useCapture: boolean = false) {
     if (target) {
         try {
             let evtName = _getEvtNamespace(eventName, evtNamespace);
@@ -321,7 +321,7 @@ export function detachEvent(obj: any, eventNameWithoutOn: string, handlerRef: an
  * @param evtNamespace - [Optional] Namespace(s) to append to the event listeners so they can be uniquely identified and removed based on this namespace.
  * @return {boolean} - true if the handler was successfully added
  */
-export function addEventHandler(eventName: string, callback: any, evtNamespace?: string | string[]): boolean {
+export function addEventHandler(eventName: string, callback: any, evtNamespace?: string | string[] | null): boolean {
     let result = false;
     let w = getWindow();
     if (w) {
@@ -346,7 +346,7 @@ export function addEventHandler(eventName: string, callback: any, evtNamespace?:
  * otherwise this will only remove events with this specific handler.
  * @param evtNamespace - [Optional] Namespace(s) to append to the event listeners so they can be uniquely identified and removed based on this namespace.
  */
-export function removeEventHandler(eventName: string, callback: any, evtNamespace?: string | string[]) {
+export function removeEventHandler(eventName: string, callback: any, evtNamespace?: string | string[] | null) {
     let w = getWindow();
     if (w) {
         eventOff(w, eventName, callback, evtNamespace);
@@ -367,7 +367,7 @@ export function removeEventHandler(eventName: string, callback: any, evtNamespac
  * @param evtNamespace - [Optional] Namespace(s) to append to the event listeners so they can be uniquely identified and removed based on this namespace.
  * @returns true - when at least one of the events was registered otherwise false
  */
-function _addEventListeners(events: string[], listener: any, excludeEvents: string[], evtNamespace: string | string[]): boolean {
+function _addEventListeners(events: string[], listener: any, excludeEvents?: string[] | null, evtNamespace?: string | string[] | null): boolean {
     let added = false;
 
     if (listener && events && events.length > 0) {
@@ -391,7 +391,6 @@ function _addEventListeners(events: string[], listener: any, excludeEvents: stri
  * @param evtNamespace - [Optional] Namespace(s) to append to the event listeners so they can be uniquely identified and removed based on this namespace.
  * @returns true - when at least one of the events was registered otherwise false
  */
-// export function addEventListeners(events: string[], listener: any, excludeEvents?: string[], evtNamespace?: string): boolean {
 export function addEventListeners(events: string[], listener: any, excludeEvents?: string[], evtNamespace?: string | string[]): boolean {
     let added = false;
 
@@ -434,8 +433,7 @@ export function removeEventListeners(events: string[], listener: any, evtNamespa
  * @param evtNamespace - [Optional] Namespace(s) to append to the event listeners so they can be uniquely identified and removed based on this namespace.
  * @returns true - when at least one of the events was registered otherwise false
  */
-//export function addPageUnloadEventListener(listener: any, excludeEvents?: string[], evtNamespace?: string): boolean {
-export function addPageUnloadEventListener(listener: any, excludeEvents: string[], evtNamespace?: string | string[]): boolean {
+export function addPageUnloadEventListener(listener: any, excludeEvents?: string[], evtNamespace?: string | string[]): boolean {
     // Hook the unload event for the document, window and body to ensure that the client events are flushed to the server
     // As just hooking the window does not always fire (on chrome) for page navigation's.
     return addEventListeners([strBeforeUnload, strUnload, strPageHide], listener, excludeEvents, evtNamespace);
@@ -464,8 +462,7 @@ export function removePageUnloadEventListener(listener: any, evtNamespace?: stri
  * Suggestion: pass as true if you are also calling addPageUnloadEventListener as that also hooks pagehide
  * @returns true - when at least one of the events was registered otherwise false
  */
-//export function addPageHideEventListener(listener: any, excludeEvents?: string[], evtNamespace?: string): boolean {
-export function addPageHideEventListener(listener: any, excludeEvents: string[], evtNamespace?: string | string[]): boolean {
+export function addPageHideEventListener(listener: any, excludeEvents?: string[] | null, evtNamespace?: string | string[] | null): boolean {
 
     function _handlePageVisibility(evt: any) {
         let doc = getDocument();
@@ -498,7 +495,7 @@ export function addPageHideEventListener(listener: any, excludeEvents: string[],
  * @param evtNamespace - The unique namespace used when calling addPageShowEventListener
  */
 
-export function removePageHideEventListener(listener: any, evtNamespace?: string | string[]) {
+export function removePageHideEventListener(listener: any, evtNamespace?: string | string[] | null) {
     // add the unique page show namespace to any provided namespace so we only remove the ones added by "pagehide"
     let newNamespaces = mergeEvtNamespace(strPageHideNamespace, evtNamespace);
     removeEventListeners([strPageHide], listener, newNamespaces);
@@ -516,8 +513,7 @@ export function removePageHideEventListener(listener: any, evtNamespace?: string
  * so that only the matching "removePageShowEventListener" can remove these events.
  * @returns true - when at least one of the events was registered otherwise false
  */
-//export function addPageShowEventListener(listener: any, excludeEvents?: string[], evtNamespace?: string): boolean {
-export function addPageShowEventListener(listener: any, excludeEvents: string[], evtNamespace?: string | string[]): boolean {
+export function addPageShowEventListener(listener: any, excludeEvents?: string[] | null, evtNamespace?: string | string[] | null): boolean {
 
     function _handlePageVisibility(evt: any) {
         let doc = getDocument();
@@ -546,7 +542,7 @@ export function addPageShowEventListener(listener: any, excludeEvents: string[],
  * @param listener - The specific listener to remove for the 'pageshow' event only (ignored for 'visibilitychange')
  * @param evtNamespace - The unique namespace used when calling addPageShowEventListener
  */
-export function removePageShowEventListener(listener: any, evtNamespace?: string | string[]) {
+export function removePageShowEventListener(listener: any, evtNamespace?: string | string[] | null) {
     // add the unique page show namespace to any provided namespace so we only remove the ones added by "pageshow"
     let newNamespaces = mergeEvtNamespace(strPageShowNamespace, evtNamespace);
     removeEventListeners([strPageShow], listener, newNamespaces);

package/src/JavaScriptSDK/HelperFuncs.ts

@@ -89,19 +89,19 @@ export function isTypeof(value: any, theType: string): boolean {
     return typeof value === theType;
 }
 
-export function isUndefined(value: any): boolean {
+export function isUndefined(value: any): value is undefined {
     return value === undefined || typeof value === strShimUndefined;
 }
 
-export function isNotUndefined(value: any): boolean {
+export function isNotUndefined<T>(value: T): value is T {
     return !isUndefined(value);
 }
 
-export function isNullOrUndefined(value: any): boolean {
+export function isNullOrUndefined(value: any): value is null | undefined {
     return (value === null || isUndefined(value));
 }
 
-export function isNotNullOrUndefined(value: any): boolean {
+export function isNotNullOrUndefined<T>(value: T): value is T {
     return !isNullOrUndefined(value);
 }
 
@@ -109,7 +109,7 @@ export function hasOwnProperty(obj: any, prop: string): boolean {
     return !!(obj && ObjHasOwnProperty.call(obj, prop));
 }
 
-export function isObject(value: any): boolean {
+export function isObject<T>(value: T): value is T {
     // Changing to inline for performance
     return !!(value && typeof value === strShimObject);
 }
@@ -389,7 +389,7 @@ export function _toISOStringPoly(date: Date) {
  * @param callbackfn  A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the array. It can return -1 to break out of the loop
  * @param thisArg  [Optional] An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.
  */
-export function arrForEach<T = any>(arr: T[], callbackfn: (value: T, index?: number, array?: T[]) => void|number, thisArg?: any): void {
+export function arrForEach<T = any>(arr: T[], callbackfn: (value: T, index?: number, array?: T[]) => undefined | void | number, thisArg?: any): void {
     let len = arr.length;
     try {
         for (let idx = 0; idx < len; idx++) {
@@ -661,7 +661,7 @@ export function getExceptionName(object: any): string {
  * @param srcChk - [Optional] Callback to check to original value that if supplied will be called if the new value should be set (if allowed)
  * @returns The existing or new value, depending what was set
  */
-export function setValue<T, K extends keyof T>(target: T, field: K, value: T[K], valChk?: (value: T[K]) => boolean, srcChk?: (value: T[K]) => boolean) {
+export function setValue<T, K extends keyof T>(target: T, field: K, value: T[K], valChk?: ((value: T[K]) => boolean) | null, srcChk?: ((value: T[K]) => boolean) | null) {
     let theValue = value;
     if (target) {
         theValue = target[field];

package/src/JavaScriptSDK/InstrumentHooks.ts

@@ -73,7 +73,7 @@ function _doCallbacks(hooks:IInstrumentHook[], callDetails: IInstrumentCallDetai
 function _createFunctionHook(aiHook:IInstrumentHooks) {
 
     // Define a temporary method that queues-up a the real method call
-    return function () {
+    return function (this: any) {
         let funcThis = this;
         // Capture the original arguments passed to the method
         let orgArgs = arguments as any;

package/src/JavaScriptSDK/PerfManager.ts

@@ -143,7 +143,7 @@ export class PerfManager implements IPerfManager  {
      */
     private ctx: { [key: string] : any } = {};
 
-    constructor(manager: INotificationManager) {
+    constructor(manager?: INotificationManager) {
 
         dynamicProto(PerfManager, this, (_self) => {
 

package/src/JavaScriptSDK/ProcessTelemetryContext.ts

@@ -26,7 +26,7 @@ const strGetTelCtx = "_getTelCtx";
 let _chainId = 0;
 
 interface OnCompleteCallback {
-    func: Function;
+    func: () => void;
     self: any;      // This for the function
     args: any[];    // Additional arguments for the function
 }
@@ -67,7 +67,7 @@ function _getNextProxyStart(proxy: ITelemetryPluginChain, config: IConfiguration
 function _createInternalContext<T extends IBaseProcessingContext>(telemetryChain: ITelemetryPluginChain, config: IConfiguration, core:IAppInsightsCore, startAt?: IPlugin): IInternalContext<T> {
     // We have a special case where we want to start execution from this specific plugin
     // or we simply reuse the existing telemetry plugin chain (normal execution case)
-    let _nextProxy: ITelemetryPluginChain = null;  // By Default set as no next plugin
+    let _nextProxy: ITelemetryPluginChain | null = null;  // By Default set as no next plugin
     let _onComplete: OnCompleteCallback[] = [];
 
     if (startAt !== null) {
@@ -103,7 +103,7 @@ function _createInternalContext<T extends IBaseProcessingContext>(telemetryChain
         } as T
     };
 
-    function _addOnComplete(onComplete: Function, that?: any, ...args: any[]) {
+    function _addOnComplete(onComplete: () => void, that?: any, ...args: any[]) {
         if (onComplete) {
             _onComplete.push({
                 func: onComplete,
@@ -211,7 +211,7 @@ function _createInternalContext<T extends IBaseProcessingContext>(telemetryChain
  * @param core - The current core instance
  * @param startAt - Identifies the next plugin to execute, if null there is no "next" plugin and if undefined it should assume the start of the chain
  */
-export function createProcessTelemetryContext(telemetryChain: ITelemetryPluginChain, config: IConfiguration, core:IAppInsightsCore, startAt?: IPlugin): IProcessTelemetryContext {
+export function createProcessTelemetryContext(telemetryChain: ITelemetryPluginChain | null, config: IConfiguration, core:IAppInsightsCore, startAt?: IPlugin): IProcessTelemetryContext {
     let internalContext: IInternalContext<IProcessTelemetryContext> = _createInternalContext<IProcessTelemetryContext>(telemetryChain, config, core, startAt);
     let context = internalContext.ctx;
 
@@ -223,7 +223,7 @@ export function createProcessTelemetryContext(telemetryChain: ITelemetryPluginCh
         return !nextPlugin;
     }
 
-    function _createNew(plugins: IPlugin[] | ITelemetryPluginChain = null, startAt?: IPlugin) {
+    function _createNew(plugins: IPlugin[] | ITelemetryPluginChain | null = null, startAt?: IPlugin) {
         if (isArray(plugins)) {
             plugins = createTelemetryProxyChain(plugins, config, core, startAt);
         }
@@ -562,7 +562,7 @@ export class ProcessTelemetryContext implements IProcessTelemetryContext {
 
     public getExtCfg: <T>(identifier:string, defaultValue?:T|any) => T;
                         
-    public getConfig: (identifier:string, field: string, defaultValue?: number | string | boolean) => number | string | boolean;
+    public getConfig: (identifier:string, field: string, defaultValue?: number | string | boolean | string[] | RegExp[] | Function) => number | string | boolean | string[] | RegExp[] | Function;
 
     /**
      * Returns the IAppInsightsCore instance for the current request

package/src/JavaScriptSDK/TelemetryHelpers.ts

@@ -3,13 +3,16 @@
 "use strict";
 
 import { IPlugin, ITelemetryPlugin } from "../JavaScriptSDK.Interfaces/ITelemetryPlugin";
-import { IProcessTelemetryContext } from "../JavaScriptSDK.Interfaces/IProcessTelemetryContext";
+import { IProcessTelemetryContext, IProcessTelemetryUnloadContext } from "../JavaScriptSDK.Interfaces/IProcessTelemetryContext";
 import { ITelemetryPluginChain } from "../JavaScriptSDK.Interfaces/ITelemetryPluginChain";
 import { arrForEach, isFunction } from "./HelperFuncs";
-import { strCore, strIsInitialized, strPriority, strProcessTelemetry, strSetNextPlugin, strTeardown } from "./InternalConstants";
+import { strCore, strDoTeardown, strIsInitialized, strPriority, strProcessTelemetry, strSetNextPlugin, strTeardown } from "./InternalConstants";
 import { createElmNodeData } from "./DataCacheHelper";
 import { IAppInsightsCore } from "../JavaScriptSDK.Interfaces/IAppInsightsCore";
+import { IUnloadableComponent } from "../JavaScriptSDK.Interfaces/IUnloadableComponent";
+import { ITelemetryUnloadState } from "../JavaScriptSDK.Interfaces/ITelemetryUnloadState";
 
+const strDoUnload = "_doUnload";
 export interface IPluginState {
     core?: IAppInsightsCore;
     isInitialized?: boolean;
@@ -100,4 +103,33 @@ export function sortPlugins<T = IPlugin>(plugins:T[]) {
         return result;
     });
     // sort complete
+}
+
+/**
+ * Teardown / Unload helper to perform teardown/unloading operations for the provided components synchronously or asynchronously, this will call any
+ * _doTeardown() or _doUnload() functions on the provided components to allow them to finish removal.
+ * @param components - The components you want to unload
+ * @param unloadCtx - This is the context that should be used during unloading.
+ * @param unloadState - The details / state of the unload process, it holds details like whether it should be unloaded synchronously or asynchronously and the reason for the unload.
+ * @param asyncCallback - An optional callback that the plugin must call if it returns true to inform the caller that it has completed any async unload/teardown operations.
+ * @returns boolean - true if the plugin has or will call asyncCallback, this allows the plugin to perform any asynchronous operations.
+ */
+export function unloadComponents(components: any | IUnloadableComponent[], unloadCtx?: IProcessTelemetryUnloadContext, unloadState?: ITelemetryUnloadState, asyncCallback?: () => void): void | boolean {
+    let idx = 0;
+
+    function _doUnload(): void | boolean {
+        while (idx < components.length) {
+            let component = components[idx++];
+            if (component) {
+                let func = component[strDoUnload] || component[strDoTeardown];
+                if (isFunction(func)) {
+                    if (func.call(component, unloadCtx, unloadState, _doUnload) === true) {
+                        return true;
+                    }
+                }
+            }
+        }
+    }
+
+    return _doUnload();
 }

package/src/JavaScriptSDK.Interfaces/IProcessTelemetryContext.ts

@@ -76,7 +76,7 @@ export interface IBaseProcessingContext {
      * @param that - The "this" value to use for the onComplete call, if not provided or undefined defaults to the current context
      * @param args - Any additional arguments to pass to the onComplete function
      */
-    onComplete: (onComplete: Function, that?: any, ...args: any[]) => void;
+    onComplete: (onComplete: () => void, that?: any, ...args: any[]) => void;
 
     /**
      * Create a new context using the core and config from the current instance, returns a new instance of the same type

package/src/JavaScriptSDK.Interfaces/ITelemetryUpdateState.ts

@@ -2,7 +2,7 @@
 // Licensed under the MIT License.
 
 import { TelemetryUpdateReason } from "../JavaScriptSDK.Enums/TelemetryUpdateReason";
-import { IConfiguration } from "./IConfiguration";
+//import { IConfiguration } from "./IConfiguration";
 import { IPlugin } from "./ITelemetryPlugin";
 
 export interface ITelemetryUpdateState {

package/src/JavaScriptSDK.Interfaces/IUnloadableComponent.ts

@@ -0,0 +1,17 @@
+import { IProcessTelemetryUnloadContext } from "./IProcessTelemetryContext";
+import { ITelemetryUnloadState } from "./ITelemetryUnloadState";
+
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+export interface IUnloadableComponent {
+    /**
+    * Teardown / Unload hook to allow implementations to perform some additional unload operations before the BaseTelemetryPlugin
+    * finishes it's removal.
+    * @param unloadCtx - This is the context that should be used during unloading.
+    * @param unloadState - The details / state of the unload process, it holds details like whether it should be unloaded synchronously or asynchronously and the reason for the unload.
+    * @param asyncCallback - An optional callback that the plugin must call if it returns true to inform the caller that it has completed any async unload/teardown operations.
+    * @returns boolean - true if the plugin has or will call asyncCallback, this allows the plugin to perform any asynchronous operations.
+    */
+    _doUnload?: (unloadCtx?: IProcessTelemetryUnloadContext, unloadState?: ITelemetryUnloadState, asyncCallback?: () => void) => void | boolean;
+}

package/types/JavaScriptSDK/EventHelpers.d.ts

@@ -11,7 +11,7 @@ export interface _IRegisteredEvents {
  * if the eventName also includes a namespace the namespace(s) are merged into a single namespace
  */
 export declare function __getRegisteredEvents(target: any, eventName?: string, evtNamespace?: string | string[]): _IRegisteredEvents[];
-export declare function mergeEvtNamespace(theNamespace: string, namespaces: string | string[]): string | string[];
+export declare function mergeEvtNamespace(theNamespace: string, namespaces?: string | string[] | null): string | string[];
 /**
  * Binds the specified function to an event, so that the function gets called whenever the event fires on the object
  * @param obj Object to add the event too.
@@ -23,7 +23,7 @@ export declare function mergeEvtNamespace(theNamespace: string, namespaces: stri
  * @param useCapture [Optional] Defaults to false
  * @returns True if the function was bound successfully to the event, otherwise false
  */
-export declare function eventOn<T>(target: T, eventName: string, handlerRef: any, evtNamespace?: string | string[], useCapture?: boolean): boolean;
+export declare function eventOn<T>(target: T, eventName: string, handlerRef: any, evtNamespace?: string | string[] | null, useCapture?: boolean): boolean;
 /**
  * Removes an event handler for the specified event
  * @param Object to remove the event from
@@ -36,7 +36,7 @@ export declare function eventOn<T>(target: T, eventName: string, handlerRef: any
  * if the eventName also includes a namespace the namespace(s) are merged into a single namespace
  * @param useCapture [Optional] Defaults to false
  */
-export declare function eventOff<T>(target: T, eventName: string, handlerRef: any, evtNamespace?: string | string[], useCapture?: boolean): void;
+export declare function eventOff<T>(target: T, eventName: string, handlerRef: any, evtNamespace?: string | string[] | null, useCapture?: boolean): void;
 /**
  * Binds the specified function to an event, so that the function gets called whenever the event fires on the object
  * @param obj Object to add the event too.
@@ -64,7 +64,7 @@ export declare function detachEvent(obj: any, eventNameWithoutOn: string, handle
  * @param evtNamespace - [Optional] Namespace(s) to append to the event listeners so they can be uniquely identified and removed based on this namespace.
  * @return {boolean} - true if the handler was successfully added
  */
-export declare function addEventHandler(eventName: string, callback: any, evtNamespace?: string | string[]): boolean;
+export declare function addEventHandler(eventName: string, callback: any, evtNamespace?: string | string[] | null): boolean;
 /**
  * Trys to remove event handler(s) for the specified event/namespace to the window, body and document
  * @param eventName {string} - The name of the event, with optional namespaces or just the namespaces,
@@ -74,7 +74,7 @@ export declare function addEventHandler(eventName: string, callback: any, evtNam
  * otherwise this will only remove events with this specific handler.
  * @param evtNamespace - [Optional] Namespace(s) to append to the event listeners so they can be uniquely identified and removed based on this namespace.
  */
-export declare function removeEventHandler(eventName: string, callback: any, evtNamespace?: string | string[]): void;
+export declare function removeEventHandler(eventName: string, callback: any, evtNamespace?: string | string[] | null): void;
 /**
  * Bind the listener to the array of events
  * @param events An string array of event names to bind the listener to
@@ -102,7 +102,7 @@ export declare function removeEventListeners(events: string[], listener: any, ev
  * @param evtNamespace - [Optional] Namespace(s) to append to the event listeners so they can be uniquely identified and removed based on this namespace.
  * @returns true - when at least one of the events was registered otherwise false
  */
-export declare function addPageUnloadEventListener(listener: any, excludeEvents: string[], evtNamespace?: string | string[]): boolean;
+export declare function addPageUnloadEventListener(listener: any, excludeEvents?: string[], evtNamespace?: string | string[]): boolean;
 /**
  * Remove any matching 'beforeunload', 'unload' and 'pagehide' events that may have been added via addEventListener,
  * addEventListeners, addPageUnloadEventListener or addPageHideEventListener.
@@ -123,7 +123,7 @@ export declare function removePageUnloadEventListener(listener: any, evtNamespac
  * Suggestion: pass as true if you are also calling addPageUnloadEventListener as that also hooks pagehide
  * @returns true - when at least one of the events was registered otherwise false
  */
-export declare function addPageHideEventListener(listener: any, excludeEvents: string[], evtNamespace?: string | string[]): boolean;
+export declare function addPageHideEventListener(listener: any, excludeEvents?: string[] | null, evtNamespace?: string | string[] | null): boolean;
 /**
  * Removes the pageHide event listeners added by addPageHideEventListener, because the 'visibilitychange' uses
  * an internal proxy to detect the visibility state you SHOULD use a unique namespace when calling addPageHideEventListener
@@ -131,7 +131,7 @@ export declare function addPageHideEventListener(listener: any, excludeEvents: s
  * @param listener - The specific listener to remove for the 'pageshow' event only (ignored for 'visibilitychange')
  * @param evtNamespace - The unique namespace used when calling addPageShowEventListener
  */
-export declare function removePageHideEventListener(listener: any, evtNamespace?: string | string[]): void;
+export declare function removePageHideEventListener(listener: any, evtNamespace?: string | string[] | null): void;
 /**
  * Listen to the pageshow and visibility changing to 'visible' events, because the 'visibilitychange' uses
  * an internal proxy to detect the visibility state you SHOULD use a unique namespace when if you plan to call
@@ -143,7 +143,7 @@ export declare function removePageHideEventListener(listener: any, evtNamespace?
  * so that only the matching "removePageShowEventListener" can remove these events.
  * @returns true - when at least one of the events was registered otherwise false
  */
-export declare function addPageShowEventListener(listener: any, excludeEvents: string[], evtNamespace?: string | string[]): boolean;
+export declare function addPageShowEventListener(listener: any, excludeEvents?: string[] | null, evtNamespace?: string | string[] | null): boolean;
 /**
  * Removes the pageShow event listeners added by addPageShowEventListener, because the 'visibilitychange' uses
  * an internal proxy to detect the visibility state you SHOULD use a unique namespace when calling addPageShowEventListener
@@ -151,4 +151,4 @@ export declare function addPageShowEventListener(listener: any, excludeEvents: s
  * @param listener - The specific listener to remove for the 'pageshow' event only (ignored for 'visibilitychange')
  * @param evtNamespace - The unique namespace used when calling addPageShowEventListener
  */
-export declare function removePageShowEventListener(listener: any, evtNamespace?: string | string[]): void;
+export declare function removePageShowEventListener(listener: any, evtNamespace?: string | string[] | null): void;

package/types/JavaScriptSDK/HelperFuncs.d.ts

@@ -5,12 +5,12 @@
 export declare function _getObjProto(target: any): any;
 export declare function objToString(obj: any): any;
 export declare function isTypeof(value: any, theType: string): boolean;
-export declare function isUndefined(value: any): boolean;
-export declare function isNotUndefined(value: any): boolean;
-export declare function isNullOrUndefined(value: any): boolean;
-export declare function isNotNullOrUndefined(value: any): boolean;
+export declare function isUndefined(value: any): value is undefined;
+export declare function isNotUndefined<T>(value: T): value is T;
+export declare function isNullOrUndefined(value: any): value is null | undefined;
+export declare function isNotNullOrUndefined<T>(value: T): value is T;
 export declare function hasOwnProperty(obj: any, prop: string): boolean;
-export declare function isObject(value: any): boolean;
+export declare function isObject<T>(value: T): value is T;
 export declare function isFunction(value: any): value is Function;
 export declare function isPromiseLike<T>(value: any): value is PromiseLike<T>;
 /**
@@ -121,7 +121,7 @@ export declare function _toISOStringPoly(date: Date): string;
  * @param callbackfn  A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the array. It can return -1 to break out of the loop
  * @param thisArg  [Optional] An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.
  */
-export declare function arrForEach<T = any>(arr: T[], callbackfn: (value: T, index?: number, array?: T[]) => void | number, thisArg?: any): void;
+export declare function arrForEach<T = any>(arr: T[], callbackfn: (value: T, index?: number, array?: T[]) => undefined | void | number, thisArg?: any): void;
 /**
  * Returns the index of the first occurrence of a value in an array. This helper exists to avoid adding a polyfil for older browsers
  * that do not define Array.prototype.xxxx (eg. ES3 only, IE8) just in case any page checks for presence/absence of the prototype
@@ -193,7 +193,7 @@ export declare function getExceptionName(object: any): string;
  * @param srcChk - [Optional] Callback to check to original value that if supplied will be called if the new value should be set (if allowed)
  * @returns The existing or new value, depending what was set
  */
-export declare function setValue<T, K extends keyof T>(target: T, field: K, value: T[K], valChk?: (value: T[K]) => boolean, srcChk?: (value: T[K]) => boolean): T[K];
+export declare function setValue<T, K extends keyof T>(target: T, field: K, value: T[K], valChk?: ((value: T[K]) => boolean) | null, srcChk?: ((value: T[K]) => boolean) | null): T[K];
 /**
  * Returns the current value from the target object if not null or undefined otherwise sets the new value and returns it
  * @param target - The target object to return or set the default value

package/types/JavaScriptSDK/PerfManager.d.ts

@@ -46,7 +46,7 @@ export declare class PerfManager implements IPerfManager {
      * Defined as private so it can be visualized via the DebugPlugin
      */
     private ctx;
-    constructor(manager: INotificationManager);
+    constructor(manager?: INotificationManager);
     /**
      * Create a new event and start timing, the manager may return null/undefined to indicate that it does not
      * want to monitor this source event.

package/types/JavaScriptSDK/ProcessTelemetryContext.d.ts

@@ -12,7 +12,7 @@ import { IDiagnosticLogger } from "../JavaScriptSDK.Interfaces/IDiagnosticLogger
  * @param core - The current core instance
  * @param startAt - Identifies the next plugin to execute, if null there is no "next" plugin and if undefined it should assume the start of the chain
  */
-export declare function createProcessTelemetryContext(telemetryChain: ITelemetryPluginChain, config: IConfiguration, core: IAppInsightsCore, startAt?: IPlugin): IProcessTelemetryContext;
+export declare function createProcessTelemetryContext(telemetryChain: ITelemetryPluginChain | null, config: IConfiguration, core: IAppInsightsCore, startAt?: IPlugin): IProcessTelemetryContext;
 /**
  * Creates a new Telemetry Item context with the current config, core and plugin execution chain for handling the unloading of the chain
  * @param plugins - The plugin instances that will be executed
@@ -59,7 +59,7 @@ export declare class ProcessTelemetryContext implements IProcessTelemetryContext
      */
     getCfg: () => IConfiguration;
     getExtCfg: <T>(identifier: string, defaultValue?: T | any) => T;
-    getConfig: (identifier: string, field: string, defaultValue?: number | string | boolean) => number | string | boolean;
+    getConfig: (identifier: string, field: string, defaultValue?: number | string | boolean | string[] | RegExp[] | Function) => number | string | boolean | string[] | RegExp[] | Function;
     /**
      * Returns the IAppInsightsCore instance for the current request
      */