@microsoft/applicationinsights-web-basic 2.7.4-nightly.2202-07 → 2.8.0-beta.2202-06

package/dist/applicationinsights-web-basic.api.json

@@ -218,52 +218,6 @@
               "overloadIndex": 1,
               "parameters": []
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@microsoft/applicationinsights-web-basic!AppInsightsCore#addNotificationListener:member(1)",
-              "docComment": "/**\n * 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.\n *\n * @param listener - An INotificationListener object.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "addNotificationListener(listener: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "INotificationListener",
-                  "canonicalReference": "@microsoft/applicationinsights-web-basic!INotificationListener:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isOptional": false,
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
-              },
-              "releaseTag": "Public",
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "listener",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  }
-                }
-              ],
-              "name": "addNotificationListener"
-            },
             {
               "kind": "Method",
               "canonicalReference": "@microsoft/applicationinsights-web-basic!AppInsightsCore#initialize:member(1)",
@@ -362,126 +316,6 @@
               ],
               "name": "initialize"
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@microsoft/applicationinsights-web-basic!AppInsightsCore#pollInternalLogs:member(1)",
-              "docComment": "/**\n * Periodically check logger.queue for\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "pollInternalLogs(eventName?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "number"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isOptional": false,
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
-              },
-              "releaseTag": "Public",
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "eventName",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  }
-                }
-              ],
-              "name": "pollInternalLogs"
-            },
-            {
-              "kind": "Method",
-              "canonicalReference": "@microsoft/applicationinsights-web-basic!AppInsightsCore#removeNotificationListener:member(1)",
-              "docComment": "/**\n * Removes all instances of the listener.\n *\n * @param listener - INotificationListener to remove.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "removeNotificationListener(listener: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "INotificationListener",
-                  "canonicalReference": "@microsoft/applicationinsights-web-basic!INotificationListener:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isOptional": false,
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
-              },
-              "releaseTag": "Public",
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "listener",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  }
-                }
-              ],
-              "name": "removeNotificationListener"
-            },
-            {
-              "kind": "Method",
-              "canonicalReference": "@microsoft/applicationinsights-web-basic!AppInsightsCore#stopPollingInternalLogs:member(1)",
-              "docComment": "/**\n * Periodically check logger.queue for\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "stopPollingInternalLogs(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isOptional": false,
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Public",
-              "overloadIndex": 1,
-              "parameters": [],
-              "name": "stopPollingInternalLogs"
-            },
             {
               "kind": "Method",
               "canonicalReference": "@microsoft/applicationinsights-web-basic!AppInsightsCore#track:member(1)",
@@ -871,6 +705,56 @@
               ],
               "name": "addNotificationListener"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@microsoft/applicationinsights-web-basic!IAppInsightsCore#addTelemetryInitializer:member(1)",
+              "docComment": "/**\n * Add a telemetry processor to decorate or drop telemetry events.\n *\n * @param telemetryInitializer - The Telemetry Initializer function\n *\n * @returns - A ITelemetryInitializerHandler to enable the initializer to be removed\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "addTelemetryInitializer(telemetryInitializer: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "TelemetryInitializerFunction",
+                  "canonicalReference": "@microsoft/applicationinsights-web-basic!TelemetryInitializerFunction:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ITelemetryInitializerHandler",
+                  "canonicalReference": "@microsoft/applicationinsights-web-basic!ITelemetryInitializerHandler:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "telemetryInitializer",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  }
+                }
+              ],
+              "name": "addTelemetryInitializer"
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@microsoft/applicationinsights-web-basic!IAppInsightsCore#config:member",
@@ -956,6 +840,90 @@
               "parameters": [],
               "name": "getNotifyMgr"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@microsoft/applicationinsights-web-basic!IAppInsightsCore#getPlugin:member(1)",
+              "docComment": "/**\n * Find and return the (first) plugin with the specified identifier if present\n *\n * @param pluginIdentifier - \n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getPlugin<T extends "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IPlugin",
+                  "canonicalReference": "@microsoft/applicationinsights-web-basic!IPlugin:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " "
+                },
+                {
+                  "kind": "Content",
+                  "text": "= "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IPlugin",
+                  "canonicalReference": "@microsoft/applicationinsights-web-basic!IPlugin:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">(pluginIdentifier: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ILoadedPlugin",
+                  "canonicalReference": "@microsoft/applicationinsights-web-basic!ILoadedPlugin:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<T>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 8,
+                "endIndex": 10
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "pluginIdentifier",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 6,
+                    "endIndex": 7
+                  }
+                }
+              ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "T",
+                  "constraintTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 3
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 4,
+                    "endIndex": 5
+                  }
+                }
+              ],
+              "name": "getPlugin"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@microsoft/applicationinsights-web-basic!IAppInsightsCore#getProcessTelContext:member(1)",

package/dist/applicationinsights-web-basic.api.md

@@ -9,17 +9,12 @@
 // @public (undocumented)
 export class AppInsightsCore extends BaseCore implements IAppInsightsCore {
     constructor();
-    // Warning: (ae-forgotten-export) The symbol "INotificationListener" needs to be exported by the entry point index.d.ts
-    addNotificationListener(listener: INotificationListener): void;
     // Warning: (ae-forgotten-export) The symbol "IPlugin" needs to be exported by the entry point index.d.ts
     // Warning: (ae-forgotten-export) The symbol "IDiagnosticLogger" needs to be exported by the entry point index.d.ts
     // Warning: (ae-forgotten-export) The symbol "INotificationManager" needs to be exported by the entry point index.d.ts
     //
     // (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;
 }
@@ -47,12 +42,18 @@ export const CoreUtils: ICoreUtils;
 //
 // @public (undocumented)
 export interface IAppInsightsCore extends IPerfManagerProvider {
+    // Warning: (ae-forgotten-export) The symbol "INotificationListener" needs to be exported by the entry point index.d.ts
     addNotificationListener?(listener: INotificationListener): void;
+    // Warning: (ae-forgotten-export) The symbol "TelemetryInitializerFunction" needs to be exported by the entry point index.d.ts
+    // Warning: (ae-forgotten-export) The symbol "ITelemetryInitializerHandler" needs to be exported by the entry point index.d.ts
+    addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
     // (undocumented)
     config: IConfiguration;
     // Warning: (ae-forgotten-export) The symbol "ICookieMgr" needs to be exported by the entry point index.d.ts
     getCookieMgr(): ICookieMgr;
     getNotifyMgr(): INotificationManager;
+    // Warning: (ae-forgotten-export) The symbol "ILoadedPlugin" needs to be exported by the entry point index.d.ts
+    getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
     // Warning: (ae-forgotten-export) The symbol "IProcessTelemetryContext" needs to be exported by the entry point index.d.ts
     getProcessTelContext(): IProcessTelemetryContext;
     // Warning: (ae-forgotten-export) The symbol "IChannelControls" needs to be exported by the entry point index.d.ts

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

@@ -1,5 +1,5 @@
 /*
- * Microsoft.ApplicationInsights, 2.7.4-nightly.2202-07
+ * Microsoft.ApplicationInsights, 2.8.0-beta.2202-06
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -11,26 +11,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;
     }
 
     /**
@@ -82,6 +62,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
          */
@@ -94,6 +86,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;
     }
 
@@ -103,6 +110,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
@@ -124,13 +138,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
@@ -142,13 +149,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;
     }
 
     /**
@@ -174,6 +182,12 @@ declare namespace ApplicationInsights {
         W3C = 2
     }
 
+    const enum GetExtCfgMergeType {
+        None = 0,
+        MergeDefaultOnly = 1,
+        MergeDefaultFromRootOrDefault = 2
+    }
+
     interface IAppInsightsCore extends IPerfManagerProvider {
         config: IConfiguration;
         logger: IDiagnosticLogger;
@@ -209,12 +223,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>;
     }
 
     /**
@@ -316,10 +341,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;
     }
 
     interface IChannelControlsAI extends IChannelControls {
@@ -1154,6 +1182,77 @@ declare namespace ApplicationInsights {
         iKey?: string;
     }
 
+    interface IInstrumentCallDetails {
+        name: string;
+        inst: any;
+        /**
+         * This returns an object that the hook function can use to store hook specific
+         * context, it it not shared with any other hook instances and is unique for the
+         * current call.
+         * A hook implementation can use this to pass / share context between different
+         * hook callbacks eg. request/response requst/hookErrors etc.
+         */
+        ctx: () => any;
+        /**
+         * Allows the hook functions to replace the original arguments
+         * @param idx - The argument index (0 based)
+         * @param value - The new value for the argument
+         */
+        set: (idx: number, value: any) => void;
+        /**
+         * The result of the original method, only populated after the original method has returned
+         */
+        rslt?: any;
+        /**
+         * 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;
+    }
+
+    /**
+     * The holder of the specific instance callback
+     */
+    interface IInstrumentHook {
+        /** Unique Id for this callback on the hooked method */
+        id: number;
+        /** Holds the callbacks */
+        cbks: IInstrumentHooksCallbacks;
+        /** Remove this hook from the function */
+        rm: () => void;
+    }
+
+    /**
+     * The callbacks to call for the instrumented function, you must provide at least the request and/or response callbacks, both are not required.
+     * You must always supply the error callback
+     */
+    interface IInstrumentHooksCallbacks {
+        /**
+         * The hook callback to call before the original function is called
+         */
+        req?: InstrumentorHooksCallback;
+        /**
+         * The hook callback to call after the original function was called
+         */
+        rsp?: InstrumentorHooksCallback;
+        /**
+         * The callback to call if the hook function causes an exception
+         */
+        hkErr?: InstrumentorHooksCallback;
+        /**
+         * The callback to call if the original function causes an exception, even if you
+         * supply a callback the original exception will still be thrown
+         */
+        fnErr?: InstrumentorHooksCallback;
+    }
+
+    interface ILoadedPlugin<T extends IPlugin> {
+        plugin: T;
+    }
+
     interface IMetricTelemetry extends IPartC {
         /**
          * @description (required) - name of this metric
@@ -1272,6 +1371,12 @@ declare namespace ApplicationInsights {
         perfEvent?(perfEvent: IPerfEvent): void;
     }
 
+    /**
+     * A callback function that will be called for the wrapped instrumentation function
+     * before the original function is executed.
+     */
+    type InstrumentorHooksCallback = (funcArgs: IInstrumentCallDetails, ...orgArgs: any[]) => void;
+
     class _InternalLogMessage {
         static dataType: string;
         message: string;
@@ -1616,7 +1721,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
@@ -1624,7 +1729,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
@@ -1643,6 +1748,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
@@ -1651,6 +1762,10 @@ 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;
     }
 
     interface IRequestContext {
@@ -1792,6 +1907,10 @@ declare namespace ApplicationInsights {
         obj: string[];
     }
 
+    interface ITelemetryInitializerHandler {
+        remove(): void;
+    }
+
     /**
      * Telemety item supported in Core
      */
@@ -2056,6 +2175,8 @@ declare namespace ApplicationInsights {
         [key: string]: any;
     }
 
+    type TelemetryInitializerFunction = <T extends ITelemetryItem>(item: T) => boolean | void;
+
     interface XDomainRequest extends XMLHttpRequestEventTarget {
         readonly responseText: string;
         send(payload: string): void;