@microsoft/applicationinsights-core-js 2.7.4-nightly.2202-07 → 2.8.0-beta.2202-06

package/dist/applicationinsights-core-js.api.md

@@ -29,12 +29,8 @@ export function addPageUnloadEventListener(listener: any, excludeEvents?: string
 // @public (undocumented)
 export class AppInsightsCore extends BaseCore implements IAppInsightsCore {
     constructor();
-    addNotificationListener(listener: INotificationListener): void;
     // (undocumented)
     initialize(config: IConfiguration, extensions: IPlugin[], logger?: IDiagnosticLogger, notificationManager?: INotificationManager): void;
-    pollInternalLogs(eventName?: string): number;
-    removeNotificationListener(listener: INotificationListener): void;
-    stopPollingInternalLogs(): void;
     // (undocumented)
     track(telemetryItem: ITelemetryItem): void;
 }
@@ -43,7 +39,7 @@ export class AppInsightsCore extends BaseCore implements IAppInsightsCore {
 export function areCookiesSupported(logger?: IDiagnosticLogger): any;
 
 // @public
-export function arrForEach<T>(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[]) => void | number, thisArg?: any): void;
 
 // @public
 export function arrIndexOf<T>(arr: T[], searchElement: T, fromIndex?: number): number;
@@ -60,6 +56,8 @@ export function attachEvent(obj: any, eventNameWithoutOn: string, handlerRef: an
 // @public (undocumented)
 export class BaseCore implements IAppInsightsCore {
     constructor();
+    addNotificationListener(listener: INotificationListener): void;
+    addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
     // (undocumented)
     config: IConfiguration;
     // (undocumented)
@@ -73,6 +71,10 @@ export class BaseCore implements IAppInsightsCore {
     getNotifyMgr(): INotificationManager;
     // (undocumented)
     getPerfMgr(): IPerfManager;
+    // Warning: (ae-forgotten-export) The symbol "ILoadedPlugin" needs to be exported by the entry point applicationinsights-core-js.d.ts
+    //
+    // (undocumented)
+    getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
     // (undocumented)
     getProcessTelContext(): IProcessTelemetryContext;
     // (undocumented)
@@ -83,11 +85,14 @@ export class BaseCore implements IAppInsightsCore {
     isInitialized: () => boolean;
     // (undocumented)
     logger: IDiagnosticLogger;
+    pollInternalLogs(eventName?: string): number;
     // (undocumented)
     protected releaseQueue(): void;
+    removeNotificationListener(listener: INotificationListener): void;
     setCookieMgr(cookieMgr: ICookieMgr): void;
     // (undocumented)
     setPerfMgr(perfMgr: IPerfManager): void;
+    stopPollingInternalLogs(): void;
     // (undocumented)
     track(telemetryItem: ITelemetryItem): void;
 }
@@ -95,6 +100,7 @@ export class BaseCore implements IAppInsightsCore {
 // @public
 export abstract class BaseTelemetryPlugin implements ITelemetryPlugin {
     constructor();
+    protected _addHook(hooks: IInstrumentHook | IInstrumentHook[]): void;
     core: IAppInsightsCore;
     diagLog: (itemCtx?: IProcessTelemetryContext) => IDiagnosticLogger;
     protected _getTelCtx: (currentCtx?: IProcessTelemetryContext) => IProcessTelemetryContext;
@@ -126,6 +132,9 @@ export function createClassFromInterface<T>(defaults?: T): new () => T;
 // @public (undocumented)
 export function createCookieMgr(rootConfig?: IConfiguration, logger?: IDiagnosticLogger): ICookieMgr;
 
+// @public
+export function createProcessTelemetryContext(telemetryChain: ITelemetryPluginChain, config: IConfiguration, core: IAppInsightsCore, startAt?: IPlugin): IProcessTelemetryContext;
+
 // @public
 export function dateNow(): number;
 
@@ -198,6 +207,16 @@ export function getDocument(): Document | null;
 // @public
 export function getExceptionName(object: any): string;
 
+// @public (undocumented)
+export const enum GetExtCfgMergeType {
+    // (undocumented)
+    MergeDefaultFromRootOrDefault = 2,
+    // (undocumented)
+    MergeDefaultOnly = 1,
+    // (undocumented)
+    None = 0
+}
+
 // @public
 export function getGblPerfMgr(): IPerfManager;
 
@@ -254,10 +273,12 @@ export function hasWindow(): boolean;
 // @public (undocumented)
 export interface IAppInsightsCore extends IPerfManagerProvider {
     addNotificationListener?(listener: INotificationListener): void;
+    addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
     // (undocumented)
     config: IConfiguration;
     getCookieMgr(): ICookieMgr;
     getNotifyMgr(): INotificationManager;
+    getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
     getProcessTelContext(): IProcessTelemetryContext;
     // (undocumented)
     getTransmissionControls(): IChannelControls[][];
@@ -278,7 +299,7 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
 
 // @public
 export interface IChannelControls extends ITelemetryPlugin {
-    flush(async: boolean, callBack?: () => void): void;
+    flush(async: boolean, callBack?: (flushComplete?: boolean) => void, sendReason?: SendRequestReason): boolean | void;
     pause(): void;
     resume(): void;
     teardown(): void;
@@ -430,6 +451,7 @@ export interface IEventHelper {
 export interface IInstrumentCallDetails {
     ctx: () => any;
     err?: Error;
+    evt?: Event;
     // (undocumented)
     inst: any;
     // (undocumented)
@@ -466,7 +488,7 @@ export interface IInstrumentHooksCallbacks {
 }
 
 // @public
-export function initializePlugins(processContext: ProcessTelemetryContext, extensions: IPlugin[]): void;
+export function initializePlugins(processContext: IProcessTelemetryContext, extensions: IPlugin[]): void;
 
 // @public
 export interface INotificationListener {
@@ -648,10 +670,12 @@ export interface IProcessTelemetryContext {
     createNew: (plugins?: IPlugin[] | ITelemetryPluginChain, startAt?: IPlugin) => IProcessTelemetryContext;
     diagLog: () => IDiagnosticLogger;
     getCfg: () => IConfiguration;
-    getConfig: (identifier: string, field: string, defaultValue?: number | string | boolean) => number | string | boolean;
-    getExtCfg: <T>(identifier: string, defaultValue?: T | any) => T;
+    getConfig: (identifier: string, field: string, defaultValue?: number | string | boolean | string[] | RegExp[] | Function) => number | string | boolean | string[] | RegExp[] | Function;
+    getExtCfg: <T>(identifier: string, defaultValue?: T | any, mergeDefault?: GetExtCfgMergeType) => T;
     getNext: () => ITelemetryPluginChain;
     hasNext: () => boolean;
+    iterate: <T extends ITelemetryPlugin = ITelemetryPlugin>(callback: (plugin: T) => void) => void;
+    onComplete: (onComplete: () => void) => void;
     processNext: (env: ITelemetryItem) => void;
     setNext: (nextCtx: ITelemetryPluginChain) => void;
 }
@@ -722,6 +746,17 @@ export function isUndefined(value: any): boolean;
 // @public
 export function isXhrSupported(): boolean;
 
+// @public (undocumented)
+export interface ITelemetryInitializerContainer {
+    addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
+}
+
+// @public (undocumented)
+export interface ITelemetryInitializerHandler {
+    // (undocumented)
+    remove(): void;
+}
+
 // @public
 export interface ITelemetryItem {
     baseData?: {
@@ -799,7 +834,7 @@ export { objCreate }
 export function objDefineAccessors<T>(target: any, prop: string, getProp?: () => T, setProp?: (v: T) => void): boolean;
 
 // @public
-export function objForEachKey(target: any, callbackfn: (name: string, value: any) => void): void;
+export function objForEachKey<T = any>(target: T, callbackfn: (name: string, value: T[keyof T]) => void): void;
 
 // @public (undocumented)
 export const objFreeze: <T>(value: T) => T;
@@ -847,9 +882,9 @@ export class PerfManager implements IPerfManager {
 // @public
 export function perfNow(): number;
 
-// @public (undocumented)
+// @public @deprecated
 export class ProcessTelemetryContext implements IProcessTelemetryContext {
-    constructor(plugins: IPlugin[] | ITelemetryPluginChain, config: IConfiguration, core: IAppInsightsCore, startAt?: IPlugin);
+    constructor(pluginChain: ITelemetryPluginChain, config: IConfiguration, core: IAppInsightsCore, startAt?: IPlugin);
     core: () => IAppInsightsCore;
     createNew: (plugins?: IPlugin[] | ITelemetryPluginChain, startAt?: IPlugin) => IProcessTelemetryContext;
     diagLog: () => IDiagnosticLogger;
@@ -860,12 +895,14 @@ export class ProcessTelemetryContext implements IProcessTelemetryContext {
     getExtCfg: <T>(identifier: string, defaultValue?: T | any) => T;
     getNext: () => ITelemetryPluginChain;
     hasNext: () => boolean;
+    iterate: <T extends ITelemetryPlugin = ITelemetryPlugin>(callback: (plugin: T) => void) => void;
+    onComplete: (onComplete: () => void) => void;
     processNext: (env: ITelemetryItem) => void;
     setNext: (nextCtx: ITelemetryPluginChain) => void;
 }
 
 // @public
-export function proxyAssign(target: any, source: any, chkSet?: (name: string, isFunc?: boolean, source?: any, target?: any) => boolean): any;
+export function proxyAssign<T, S>(target: T, source: S, chkSet?: (name: string, isFunc?: boolean, source?: S, target?: T) => boolean): T;
 
 // @public
 export function random32(signed?: boolean): number;
@@ -905,7 +942,7 @@ export function setGblPerfMgr(perfManager: IPerfManager): void;
 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): T[K];
 
 // @public (undocumented)
-export function sortPlugins(plugins: IPlugin[]): IPlugin[];
+export function sortPlugins<T = IPlugin>(plugins: T[]): T[];
 
 // @public
 export function strContains(value: string, search: string): boolean;
@@ -939,6 +976,9 @@ export interface Tags {
     [key: string]: any;
 }
 
+// @public (undocumented)
+export type TelemetryInitializerFunction = <T extends ITelemetryItem>(item: T) => boolean | void;
+
 // @public (undocumented)
 export function throwError(message: string): never;
 

package/dist/applicationinsights-core-js.d.ts

@@ -1,5 +1,5 @@
 /*
- * Microsoft Application Insights Core Javascript SDK, 2.7.4-nightly.2202-07
+ * Microsoft Application Insights Core Javascript SDK, 2.8.0-beta.2202-06
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -64,26 +64,6 @@ declare namespace ApplicationInsights {
         constructor();
         initialize(config: IConfiguration, extensions: IPlugin[], logger?: IDiagnosticLogger, notificationManager?: INotificationManager): void;
         track(telemetryItem: ITelemetryItem): void;
-        /**
-         * Adds a notification listener. The SDK calls methods on the listener when an appropriate notification is raised.
-         * The added plugins must raise notifications. If the plugins do not implement the notifications, then no methods will be
-         * called.
-         * @param {INotificationListener} listener - An INotificationListener object.
-         */
-        addNotificationListener(listener: INotificationListener): void;
-        /**
-         * Removes all instances of the listener.
-         * @param {INotificationListener} listener - INotificationListener to remove.
-         */
-        removeNotificationListener(listener: INotificationListener): void;
-        /**
-         * Periodically check logger.queue for
-         */
-        pollInternalLogs(eventName?: string): number;
-        /**
-         * Periodically check logger.queue for
-         */
-        stopPollingInternalLogs(): void;
     }
 
     function areCookiesSupported(logger?: IDiagnosticLogger): any;
@@ -96,7 +76,7 @@ declare namespace ApplicationInsights {
      * @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.
      */
-    function arrForEach<T>(arr: T[], callbackfn: (value: T, index?: number, array?: T[]) => void | number, thisArg?: any): void;
+    function arrForEach<T = any>(arr: T[], callbackfn: (value: T, index?: number, array?: T[]) => 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
@@ -150,6 +130,18 @@ declare namespace ApplicationInsights {
         track(telemetryItem: ITelemetryItem): void;
         getProcessTelContext(): IProcessTelemetryContext;
         getNotifyMgr(): INotificationManager;
+        /**
+         * Adds a notification listener. The SDK calls methods on the listener when an appropriate notification is raised.
+         * The added plugins must raise notifications. If the plugins do not implement the notifications, then no methods will be
+         * called.
+         * @param {INotificationListener} listener - An INotificationListener object.
+         */
+        addNotificationListener(listener: INotificationListener): void;
+        /**
+         * Removes all instances of the listener.
+         * @param {INotificationListener} listener - INotificationListener to remove.
+         */
+        removeNotificationListener(listener: INotificationListener): void;
         /**
          * Get the current cookie manager for this instance
          */
@@ -162,6 +154,21 @@ declare namespace ApplicationInsights {
         getPerfMgr(): IPerfManager;
         setPerfMgr(perfMgr: IPerfManager): void;
         eventCnt(): number;
+        /**
+         * Periodically check logger.queue for
+         */
+        pollInternalLogs(eventName?: string): number;
+        /**
+         * Periodically check logger.queue for
+         */
+        stopPollingInternalLogs(): void;
+        /**
+         * Add a telemetry processor to decorate or drop telemetry events.
+         * @param telemetryInitializer - The Telemetry Initializer function
+         * @returns - A ITelemetryInitializerHandler to enable the initializer to be removed
+         */
+        addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
+        getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
         protected releaseQueue(): void;
     }
 
@@ -171,6 +178,13 @@ declare namespace ApplicationInsights {
      * implementation so that new default implementations can be added without breaking all plugins.
      */
     abstract class BaseTelemetryPlugin implements ITelemetryPlugin {
+        identifier: string;
+        version?: string;
+        /**
+         * Holds the core instance that was used during initialization
+         */
+        core: IAppInsightsCore;
+        priority: number;
         /**
          * Call back for telemetry processing before it it is sent
          * @param env - This is the current event being reported
@@ -192,13 +206,6 @@ declare namespace ApplicationInsights {
          * Returns whether the plugin has been initialized
          */
         isInitialized: () => boolean;
-        identifier: string;
-        version?: string;
-        /**
-         * Holds the core instance that was used during initialization
-         */
-        core: IAppInsightsCore;
-        priority: number;
         /**
          * Helper to return the current IProcessTelemetryContext, if the passed argument exists this just
          * returns that value (helps with minification for callers), otherwise it will return the configured
@@ -210,13 +217,14 @@ declare namespace ApplicationInsights {
          * Internal helper to allow setting of the internal initialized setting for inherited instances and unit testing
          */
         protected setInitialized: (isInitialized: boolean) => void;
-        /**
-         * Internal helper to initialize the instance
-         */
-        private _baseTelInit;
         constructor();
         initialize(config: IConfiguration, core: IAppInsightsCore, extensions: IPlugin[], pluginChain?: ITelemetryPluginChain): void;
         abstract processTelemetry(env: ITelemetryItem, itemCtx?: IProcessTelemetryContext): void;
+        /**
+         * Add this hook so that it is automatically removed during unloading
+         * @param hooks - The single hook or an array of IInstrumentHook objects
+         */
+        protected _addHook(hooks: IInstrumentHook | IInstrumentHook[]): void;
     }
 
     /**
@@ -242,6 +250,14 @@ declare namespace ApplicationInsights {
 
     function createCookieMgr(rootConfig?: IConfiguration, logger?: IDiagnosticLogger): ICookieMgr;
 
+    /**
+     * Creates a new Telemetry Item context with the current config, core and plugin execution chain
+     * @param plugins - The plugin instances that will be executed
+     * @param config - The current config
+     * @param core - The current core instance
+     */
+    function createProcessTelemetryContext(telemetryChain: ITelemetryPluginChain, config: IConfiguration, core: IAppInsightsCore, startAt?: IPlugin): IProcessTelemetryContext;
+
     /**
      * Return the current time via the Date now() function (if available) and falls back to (new Date()).getTime() if now() is unavailable (IE8 or less)
      * https://caniuse.com/#search=Date.now
@@ -411,6 +427,12 @@ declare namespace ApplicationInsights {
      */
     function getExceptionName(object: any): string;
 
+    const enum GetExtCfgMergeType {
+        None = 0,
+        MergeDefaultOnly = 1,
+        MergeDefaultFromRootOrDefault = 2
+    }
+
     /**
      * Get the current global performance manager that will be used with no performance manager is supplied.
      * @returns - The current default manager
@@ -569,12 +591,23 @@ declare namespace ApplicationInsights {
          * @param {INotificationListener} listener - INotificationListener to remove.
          */
         removeNotificationListener?(listener: INotificationListener): void;
+        /**
+         * Add a telemetry processor to decorate or drop telemetry events.
+         * @param telemetryInitializer - The Telemetry Initializer function
+         * @returns - A ITelemetryInitializerHandler to enable the initializer to be removed
+         */
+        addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
         pollInternalLogs?(eventName?: string): number;
         stopPollingInternalLogs?(): void;
         /**
          * Return a new instance of the IProcessTelemetryContext for processing events
          */
         getProcessTelContext(): IProcessTelemetryContext;
+        /**
+         * Find and return the (first) plugin with the specified identifier if present
+         * @param pluginIdentifier
+         */
+        getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
     }
 
     /**
@@ -595,10 +628,13 @@ declare namespace ApplicationInsights {
         teardown(): void;
         /**
          * Flush to send data immediately; channel should default to sending data asynchronously
-         * @param async: send data asynchronously when true
-         * @param callBack: if specified, notify caller when send is complete
+         * @param async - send data asynchronously when true
+         * @param callBack - if specified, notify caller when send is complete, the channel should return true to indicate to the caller that it will be called.
+         * If the caller doesn't return true the caller should assume that it may never be called.
+         * @param sendReason - specify the reason that you are calling "flush" defaults to ManualFlush (1) if not specified
+         * @returns - true if the callback will be return after the flush is complete otherwise the caller should assume that any provided callback will never be called
          */
-        flush(async: boolean, callBack?: () => void): void;
+        flush(async: boolean, callBack?: (flushComplete?: boolean) => void, sendReason?: SendRequestReason): boolean | void;
     }
 
     /**
@@ -1143,6 +1179,10 @@ declare namespace ApplicationInsights {
          * The error (exception) which occurred while executing the original method
          */
         err?: Error;
+        /**
+         * The Event object from (window.event) at the start of the original call
+         */
+        evt?: Event;
     }
 
     /**
@@ -1188,6 +1228,10 @@ declare namespace ApplicationInsights {
         fnErr?: InstrumentorHooksCallback;
     }
 
+    interface ILoadedPlugin<T extends IPlugin> {
+        plugin: T;
+    }
+
     /**
      * Initialize the queue of plugins
      * @param plugins - The array of plugins to initialize and setting of the next plugin
@@ -1195,7 +1239,7 @@ declare namespace ApplicationInsights {
      * @param core THe current core instance
      * @param extensions The extensions
      */
-    function initializePlugins(processContext: ProcessTelemetryContext, extensions: IPlugin[]): void;
+    function initializePlugins(processContext: IProcessTelemetryContext, extensions: IPlugin[]): void;
 
     /**
      * An interface used for the notification listener.
@@ -1559,7 +1603,7 @@ declare namespace ApplicationInsights {
         /**
          * Gets the named extension config
          */
-        getExtCfg: <T>(identifier: string, defaultValue?: T | any) => T;
+        getExtCfg: <T>(identifier: string, defaultValue?: T | any, mergeDefault?: GetExtCfgMergeType) => T;
         /**
          * Gets the named config from either the named identifier extension or core config if neither exist then the
          * default value is returned
@@ -1567,7 +1611,7 @@ declare namespace ApplicationInsights {
          * @param field The config field name
          * @param defaultValue The default value to return if no defined config exists
          */
-        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;
         /**
          * Helper to allow plugins to check and possibly shortcut executing code only
          * required if there is a nextPlugin
@@ -1586,6 +1630,12 @@ declare namespace ApplicationInsights {
          * @param env - This is the current event being reported
          */
         processNext: (env: ITelemetryItem) => void;
+        /**
+         * Synchronously iterate over the context chain running the callback for each plugin, once
+         * every plugin has been executed via the callback, any associated onComplete will be called.
+         * @param callback - The function call for each plugin in the context chain
+         */
+        iterate: <T extends ITelemetryPlugin = ITelemetryPlugin>(callback: (plugin: T) => void) => void;
         /**
          * Create a new context using the core and config from the current instance
          * @param plugins - The execution order to process the plugins, if null or not supplied
@@ -1594,10 +1644,15 @@ declare namespace ApplicationInsights {
          *                  order then the next plugin will be NOT set.
          */
         createNew: (plugins?: IPlugin[] | ITelemetryPluginChain, startAt?: IPlugin) => IProcessTelemetryContext;
+        /**
+         * Set the function to call when the current chain has executed all processNext or unloadNext items.
+         */
+        onComplete: (onComplete: () => void) => void;
     }
 
     /**
-     * Check if an object is of type Array
+     * Check if an object is of type Array with optional generic T, the generic type is not validated
+     * and exists to help with TypeScript validation only.
      */
     let isArray: <T = any>(obj: any) => obj is Array<T>;
 
@@ -1689,6 +1744,19 @@ declare namespace ApplicationInsights {
      */
     function isXhrSupported(): boolean;
 
+    interface ITelemetryInitializerContainer {
+        /**
+         * Add a telemetry processor to decorate or drop telemetry events.
+         * @param telemetryInitializer - The Telemetry Initializer function
+         * @returns - A ITelemetryInitializerHandler to enable the initializer to be removed
+         */
+        addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
+    }
+
+    interface ITelemetryInitializerHandler {
+        remove(): void;
+    }
+
     /**
      * Telemety item supported in Core
      */
@@ -1900,7 +1968,7 @@ declare namespace ApplicationInsights {
      * @param target The target object to find and process the keys
      * @param callbackfn The function to call with the details
      */
-    function objForEachKey(target: any, callbackfn: (name: string, value: any) => void): void;
+    function objForEachKey<T = any>(target: T, callbackfn: (name: string, value: T[keyof T]) => void): void;
 
     const objFreeze: <T>(value: T) => T;
 
@@ -2002,6 +2070,10 @@ declare namespace ApplicationInsights {
      */
     function perfNow(): number;
 
+    /**
+     * This class will be removed!
+     * @deprecated use createProcessTelemetryContext() instead
+     */
     class ProcessTelemetryContext implements IProcessTelemetryContext {
         /**
          * Gets the current core config instance
@@ -2039,16 +2111,31 @@ declare namespace ApplicationInsights {
          */
         processNext: (env: ITelemetryItem) => void;
         /**
+         * Synchronously iterate over the context chain running the callback for each plugin, once
+         * every plugin has been executed via the callback, any associated onComplete will be called.
+         * @param callback - The function call for each plugin in the context chain
+         */
+        iterate: <T extends ITelemetryPlugin = ITelemetryPlugin>(callback: (plugin: T) => void) => void;
+        /**
+         /**
          * Create a new context using the core and config from the current instance
+         * @param plugins - The execution order to process the plugins, if null or not supplied
+         *                  then the current execution order will be copied.
+         * @param startAt - The plugin to start processing from, if missing from the execution
+         *                  order then the next plugin will be NOT set.
          */
         createNew: (plugins?: IPlugin[] | ITelemetryPluginChain, startAt?: IPlugin) => IProcessTelemetryContext;
+        /**
+         * Set the function to call when the current chain has executed all processNext or unloadNext items.
+         */
+        onComplete: (onComplete: () => void) => void;
         /**
          * Creates a new Telemetry Item context with the current config, core and plugin execution chain
          * @param plugins - The plugin instances that will be executed
          * @param config - The current config
          * @param core - The current core instance
          */
-        constructor(plugins: IPlugin[] | ITelemetryPluginChain, config: IConfiguration, core: IAppInsightsCore, startAt?: IPlugin);
+        constructor(pluginChain: ITelemetryPluginChain, config: IConfiguration, core: IAppInsightsCore, startAt?: IPlugin);
     }
 
     /**
@@ -2065,9 +2152,8 @@ declare namespace ApplicationInsights {
      * @param target - The target object to be assigned with the source properties and functions
      * @param source - The source object which will be assigned / called by setting / calling the targets proxies
      * @param chkSet - An optional callback to determine whether a specific property/function should be proxied
-     * @memberof Initialization
      */
-    function proxyAssign(target: any, source: any, chkSet?: (name: string, isFunc?: boolean, source?: any, target?: any) => boolean): any;
+    function proxyAssign<T, S>(target: T, source: S, chkSet?: (name: string, isFunc?: boolean, source?: S, target?: T) => boolean): T;
 
     /**
      * generate a random 32-bit number (0x000000..0xFFFFFFFF) or (-0x80000000..0x7FFFFFFF), defaults un-unsigned.
@@ -2165,7 +2251,7 @@ declare namespace ApplicationInsights {
      */
     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];
 
-    function sortPlugins(plugins: IPlugin[]): IPlugin[];
+    function sortPlugins<T = IPlugin>(plugins: T[]): T[];
 
     /**
      * A simple wrapper (for minification support) to check if the value contains the search string.
@@ -2211,6 +2297,8 @@ declare namespace ApplicationInsights {
         [key: string]: any;
     }
 
+    type TelemetryInitializerFunction = <T extends ITelemetryItem>(item: T) => boolean | void;
+
     function throwError(message: string): never;
 
     /**