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

package/types/JavaScriptSDK/TelemetryInitializerPlugin.d.ts

@@ -0,0 +1,23 @@
+import { IProcessTelemetryContext } from "../JavaScriptSDK.Interfaces/IProcessTelemetryContext";
+import { ITelemetryInitializerContainer, ITelemetryInitializerHandler, TelemetryInitializerFunction } from "../JavaScriptSDK.Interfaces/ITelemetryInitializers";
+import { ITelemetryItem } from "../JavaScriptSDK.Interfaces/ITelemetryItem";
+import { BaseTelemetryPlugin } from "./BaseTelemetryPlugin";
+export declare class TelemetryInitializerPlugin extends BaseTelemetryPlugin implements ITelemetryInitializerContainer {
+    identifier: string;
+    priority: number;
+    constructor();
+    /**
+     * 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;
+    processTelemetry(env: ITelemetryItem, itemCtx?: IProcessTelemetryContext): void;
+    /**
+     * This plugin is being unloaded and should remove any hooked events and cleanup any global/scoped values, after this
+     * call the plugin will be removed from the telemetry processing chain and will no longer receive any events..
+     * @param itemCtx - This is the context that should be used during unloading if required to flush any cached events.
+     * @param isAsync - Should the plugin attempt to unload synchronously or can it complete asynchronously
+     */
+    unload(itemCtx: IProcessTelemetryContext, isAsync: boolean): void;
+}

package/types/JavaScriptSDK.Interfaces/IAppInsightsCore.d.ts

@@ -8,6 +8,10 @@ import { IDiagnosticLogger } from "./IDiagnosticLogger";
 import { IProcessTelemetryContext } from "./IProcessTelemetryContext";
 import { IPerfManagerProvider } from "./IPerfManager";
 import { ICookieMgr } from "./ICookieMgr";
+import { ITelemetryInitializerHandler, TelemetryInitializerFunction } from "./ITelemetryInitializers";
+export interface ILoadedPlugin<T extends IPlugin> {
+    plugin: T;
+}
 export interface IAppInsightsCore extends IPerfManagerProvider {
     config: IConfiguration;
     logger: IDiagnosticLogger;
@@ -43,10 +47,21 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
      * @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>;
 }

package/types/JavaScriptSDK.Interfaces/IChannelControls.d.ts

@@ -1,3 +1,4 @@
+import { SendRequestReason } from "../JavaScriptSDK.Enums/SendRequestReason";
 import { ITelemetryPlugin } from "./ITelemetryPlugin";
 /**
  * Provides data transmission capabilities
@@ -17,9 +18,12 @@ export interface IChannelControls extends ITelemetryPlugin {
     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;
 }
 export declare const MinChannelPriorty: number;

package/types/JavaScriptSDK.Interfaces/IInstrumentHooks.d.ts

@@ -68,4 +68,8 @@ export interface IInstrumentCallDetails {
      * 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;
 }

package/types/JavaScriptSDK.Interfaces/IProcessTelemetryContext.d.ts

@@ -2,8 +2,13 @@ import { IAppInsightsCore } from "./IAppInsightsCore";
 import { IDiagnosticLogger } from "./IDiagnosticLogger";
 import { IConfiguration } from "./IConfiguration";
 import { ITelemetryItem } from "./ITelemetryItem";
-import { IPlugin } from "./ITelemetryPlugin";
+import { IPlugin, ITelemetryPlugin } from "./ITelemetryPlugin";
 import { ITelemetryPluginChain } from "./ITelemetryPluginChain";
+export declare const enum GetExtCfgMergeType {
+    None = 0,
+    MergeDefaultOnly = 1,
+    MergeDefaultFromRootOrDefault = 2
+}
 /**
  * The current context for the current call to processTelemetry(), used to support sharing the same plugin instance
  * between multiple AppInsights instances
@@ -24,7 +29,7 @@ export interface IProcessTelemetryContext {
     /**
      * 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
@@ -32,7 +37,7 @@ export interface IProcessTelemetryContext {
      * @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
@@ -51,6 +56,12 @@ export interface IProcessTelemetryContext {
      * @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
@@ -59,4 +70,8 @@ export interface IProcessTelemetryContext {
      *                  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;
 }

package/types/JavaScriptSDK.Interfaces/ITelemetryInitializers.d.ts

@@ -0,0 +1,13 @@
+import { ITelemetryItem } from "./ITelemetryItem";
+export declare type TelemetryInitializerFunction = <T extends ITelemetryItem>(item: T) => boolean | void;
+export interface ITelemetryInitializerHandler {
+    remove(): void;
+}
+export 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;
+}

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

@@ -3,7 +3,7 @@ export { IChannelControls, MinChannelPriorty } from "./JavaScriptSDK.Interfaces/
 export { ITelemetryPlugin, IPlugin } from "./JavaScriptSDK.Interfaces/ITelemetryPlugin";
 export { IAppInsightsCore } from "./JavaScriptSDK.Interfaces/IAppInsightsCore";
 export { ITelemetryItem, ICustomProperties, Tags } from "./JavaScriptSDK.Interfaces/ITelemetryItem";
-export { IProcessTelemetryContext } from "./JavaScriptSDK.Interfaces/IProcessTelemetryContext";
+export { IProcessTelemetryContext, GetExtCfgMergeType } from "./JavaScriptSDK.Interfaces/IProcessTelemetryContext";
 export { INotificationListener } from "./JavaScriptSDK.Interfaces/INotificationListener";
 export { ITelemetryPluginChain } from "./JavaScriptSDK.Interfaces/ITelemetryPluginChain";
 export { IDiagnosticLogger } from "./JavaScriptSDK.Interfaces/IDiagnosticLogger";
@@ -13,8 +13,8 @@ export { SendRequestReason } from "./JavaScriptSDK.Enums/SendRequestReason";
 export { AppInsightsCore } from "./JavaScriptSDK/AppInsightsCore";
 export { BaseCore } from "./JavaScriptSDK/BaseCore";
 export { BaseTelemetryPlugin } from "./JavaScriptSDK/BaseTelemetryPlugin";
-export { randomValue, random32, mwcRandomSeed, mwcRandom32 } from "./JavaScriptSDK/RandomHelper";
-export { CoreUtils, ICoreUtils, EventHelper, IEventHelper, Undefined, addEventHandler, newGuid, perfNow, newId, generateW3CId, disableCookies, canUseCookies, getCookie, setCookie, deleteCookie, _legacyCookieMgr, addEventListeners, addPageUnloadEventListener, addPageHideEventListener, addPageShowEventListener } from "./JavaScriptSDK/CoreUtils";
+export { randomValue, random32, mwcRandomSeed, mwcRandom32, newId } from "./JavaScriptSDK/RandomHelper";
+export { CoreUtils, ICoreUtils, EventHelper, IEventHelper, Undefined, addEventHandler, newGuid, perfNow, generateW3CId, disableCookies, canUseCookies, getCookie, setCookie, deleteCookie, _legacyCookieMgr, addEventListeners, addPageUnloadEventListener, addPageHideEventListener, addPageShowEventListener } from "./JavaScriptSDK/CoreUtils";
 export { isTypeof, isUndefined, isNullOrUndefined, hasOwnProperty, isObject, isFunction, attachEvent, detachEvent, normalizeJsName, objForEachKey, strEndsWith, strStartsWith, isDate, isArray, isError, isString, isNumber, isBoolean, toISOString, arrForEach, arrIndexOf, arrMap, arrReduce, strTrim, objKeys, objDefineAccessors, dateNow, getExceptionName, throwError, strContains, isSymbol, setValue, getSetValue, isNotTruthy, isTruthy, proxyAssign, createClassFromInterface, optimizeObject, isNotUndefined, isNotNullOrUndefined, objFreeze, objSeal } from "./JavaScriptSDK/HelperFuncs";
 export { getGlobalInst, hasWindow, getWindow, hasDocument, getDocument, getCrypto, getMsCrypto, hasNavigator, getNavigator, hasHistory, getHistory, getLocation, getPerformance, hasJSON, getJSON, isReactNative, getConsole, dumpObj, isIE, getIEVersion, isSafari, setEnableEnvMocks, isBeaconsSupported, isFetchSupported, useXDomainRequest, isXhrSupported } from "./JavaScriptSDK/EnvUtils";
 export { getGlobal, objCreateFn as objCreate, strShimPrototype as strPrototype, strShimFunction as strFunction, strShimUndefined as strUndefined, strShimObject as strObject } from "@microsoft/applicationinsights-shims";
@@ -24,7 +24,7 @@ export { IPerfEvent } from "./JavaScriptSDK.Interfaces/IPerfEvent";
 export { IPerfManager, IPerfManagerProvider } from "./JavaScriptSDK.Interfaces/IPerfManager";
 export { PerfEvent, PerfManager, doPerf, getGblPerfMgr, setGblPerfMgr } from "./JavaScriptSDK/PerfManager";
 export { safeGetLogger, DiagnosticLogger, _InternalLogMessage } from "./JavaScriptSDK/DiagnosticLogger";
-export { ProcessTelemetryContext } from "./JavaScriptSDK/ProcessTelemetryContext";
+export { ProcessTelemetryContext, createProcessTelemetryContext } from "./JavaScriptSDK/ProcessTelemetryContext";
 export { initializePlugins, sortPlugins } from "./JavaScriptSDK/TelemetryHelpers";
 export { _InternalMessageId, LoggingSeverity } from "./JavaScriptSDK.Enums/LoggingEnums";
 export { InstrumentProto, InstrumentProtos, InstrumentFunc, InstrumentFuncs } from "./JavaScriptSDK/InstrumentHooks";
@@ -33,3 +33,4 @@ export { createCookieMgr, safeGetCookieMgr, uaDisallowsSameSiteNone, areCookiesS
 export { strIKey, strExtensionConfig } from "./JavaScriptSDK/Constants";
 export { IDbgExtension } from "./JavaScriptSDK.Interfaces/IDbgExtension";
 export { getDebugListener, getDebugExt } from "./JavaScriptSDK/DbgExtensionUtils";
+export { TelemetryInitializerFunction, ITelemetryInitializerHandler, ITelemetryInitializerContainer } from "./JavaScriptSDK.Interfaces/ITelemetryInitializers";

package/dist-esm/JavaScriptSDK/TelemetryPluginChain.js

@@ -1,76 +0,0 @@
-/*
- * Application Insights JavaScript SDK - Core, 2.7.4-nightly.2202-07
- * Copyright (c) Microsoft and contributors. All rights reserved.
- */
-
-
-"use strict";
-import { doPerf } from "./PerfManager";
-import { LoggingSeverity, _InternalMessageId } from "../JavaScriptSDK.Enums/LoggingEnums";
-import { isFunction } from "./HelperFuncs";
-import { dumpObj } from "./EnvUtils";
-var TelemetryPluginChain = /** @class */ (function () {
-    function TelemetryPluginChain(plugin, defItemCtx) {
-        var _self = this;
-        var _nextProxy = null;
-        var _hasProcessTelemetry = isFunction(plugin.processTelemetry);
-        var _hasSetNext = isFunction(plugin.setNextPlugin);
-        _self._hasRun = false;
-        _self.getPlugin = function () {
-            return plugin;
-        };
-        _self.getNext = function () {
-            return _nextProxy;
-        };
-        _self.setNext = function (nextPlugin) {
-            _nextProxy = nextPlugin;
-        };
-        _self.processTelemetry = function (env, itemCtx) {
-            if (!itemCtx) {
-                // Looks like a plugin didn't pass the (optional) context, so restore to the default
-                itemCtx = defItemCtx;
-            }
-            var identifier = plugin ? plugin.identifier : "TelemetryPluginChain";
-            doPerf(itemCtx ? itemCtx.core() : null, function () { return identifier + ":processTelemetry"; }, function () {
-                if (plugin && _hasProcessTelemetry) {
-                    _self._hasRun = true;
-                    try {
-                        // Ensure that we keep the context in sync (for processNext()), just in case a plugin
-                        // doesn't calls processTelemetry() instead of itemContext.processNext() or some
-                        // other form of error occurred
-                        itemCtx.setNext(_nextProxy);
-                        if (_hasSetNext) {
-                            // Backward compatibility setting the next plugin on the instance
-                            plugin.setNextPlugin(_nextProxy);
-                        }
-                        // Set a flag on the next plugin so we know if it was attempted to be executed
-                        _nextProxy && (_nextProxy._hasRun = false);
-                        plugin.processTelemetry(env, itemCtx);
-                    }
-                    catch (error) {
-                        var hasRun = _nextProxy && _nextProxy._hasRun;
-                        if (!_nextProxy || !hasRun) {
-                            // Either we have no next plugin or the current one did not attempt to call the next plugin
-                            // Which means the current one is the root of the failure so log/report this failure
-                            itemCtx.diagLog().throwInternal(LoggingSeverity.CRITICAL, _InternalMessageId.PluginException, "Plugin [" + plugin.identifier + "] failed during processTelemetry - " + dumpObj(error));
-                        }
-                        if (_nextProxy && !hasRun) {
-                            // As part of the failure the current plugin did not attempt to call the next plugin in the cahin
-                            // So rather than leave the pipeline dead in the water we call the next plugin
-                            _nextProxy.processTelemetry(env, itemCtx);
-                        }
-                    }
-                }
-                else if (_nextProxy) {
-                    _self._hasRun = true;
-                    // The underlying plugin is either not defined or does not have a processTelemetry implementation
-                    // so we still want the next plugin to be executed.
-                    _nextProxy.processTelemetry(env, itemCtx);
-                }
-            }, function () { return ({ item: env }); }, !(env.sync));
-        };
-    }
-    return TelemetryPluginChain;
-}());
-export { TelemetryPluginChain };
-//# sourceMappingURL=TelemetryPluginChain.js.map

package/dist-esm/JavaScriptSDK/TelemetryPluginChain.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TelemetryPluginChain.js.map","sources":["TelemetryPluginChain.js"],"sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved.\r\n// Licensed under the MIT License.\r\n\"use strict\";\r\nimport { doPerf } from \"./PerfManager\";\r\nimport { LoggingSeverity, _InternalMessageId } from \"../JavaScriptSDK.Enums/LoggingEnums\";\r\nimport { isFunction } from \"./HelperFuncs\";\r\nimport { dumpObj } from \"./EnvUtils\";\r\nvar TelemetryPluginChain = /** @class */ (function () {\r\n    function TelemetryPluginChain(plugin, defItemCtx) {\r\n        var _self = this;\r\n        var _nextProxy = null;\r\n        var _hasProcessTelemetry = isFunction(plugin.processTelemetry);\r\n        var _hasSetNext = isFunction(plugin.setNextPlugin);\r\n        _self._hasRun = false;\r\n        _self.getPlugin = function () {\r\n            return plugin;\r\n        };\r\n        _self.getNext = function () {\r\n            return _nextProxy;\r\n        };\r\n        _self.setNext = function (nextPlugin) {\r\n            _nextProxy = nextPlugin;\r\n        };\r\n        _self.processTelemetry = function (env, itemCtx) {\r\n            if (!itemCtx) {\r\n                // Looks like a plugin didn't pass the (optional) context, so restore to the default\r\n                itemCtx = defItemCtx;\r\n            }\r\n            var identifier = plugin ? plugin.identifier : \"TelemetryPluginChain\";\r\n            doPerf(itemCtx ? itemCtx.core() : null, function () { return identifier + \":processTelemetry\"; }, function () {\r\n                if (plugin && _hasProcessTelemetry) {\r\n                    _self._hasRun = true;\r\n                    try {\r\n                        // Ensure that we keep the context in sync (for processNext()), just in case a plugin\r\n                        // doesn't calls processTelemetry() instead of itemContext.processNext() or some\r\n                        // other form of error occurred\r\n                        itemCtx.setNext(_nextProxy);\r\n                        if (_hasSetNext) {\r\n                            // Backward compatibility setting the next plugin on the instance\r\n                            plugin.setNextPlugin(_nextProxy);\r\n                        }\r\n                        // Set a flag on the next plugin so we know if it was attempted to be executed\r\n                        _nextProxy && (_nextProxy._hasRun = false);\r\n                        plugin.processTelemetry(env, itemCtx);\r\n                    }\r\n                    catch (error) {\r\n                        var hasRun = _nextProxy && _nextProxy._hasRun;\r\n                        if (!_nextProxy || !hasRun) {\r\n                            // Either we have no next plugin or the current one did not attempt to call the next plugin\r\n                            // Which means the current one is the root of the failure so log/report this failure\r\n                            itemCtx.diagLog().throwInternal(LoggingSeverity.CRITICAL, _InternalMessageId.PluginException, \"Plugin [\" + plugin.identifier + \"] failed during processTelemetry - \" + dumpObj(error));\r\n                        }\r\n                        if (_nextProxy && !hasRun) {\r\n                            // As part of the failure the current plugin did not attempt to call the next plugin in the cahin\r\n                            // So rather than leave the pipeline dead in the water we call the next plugin\r\n                            _nextProxy.processTelemetry(env, itemCtx);\r\n                        }\r\n                    }\r\n                }\r\n                else if (_nextProxy) {\r\n                    _self._hasRun = true;\r\n                    // The underlying plugin is either not defined or does not have a processTelemetry implementation\r\n                    // so we still want the next plugin to be executed.\r\n                    _nextProxy.processTelemetry(env, itemCtx);\r\n                }\r\n            }, function () { return ({ item: env }); }, !(env.sync));\r\n        };\r\n    }\r\n    return TelemetryPluginChain;\r\n}());\r\nexport { TelemetryPluginChain };\r\n//# sourceMappingURL=TelemetryPluginChain.js.map"],"names":[],"mappings":";;;;AAA4D;AAC1B;AAClC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}

package/src/JavaScriptSDK/TelemetryPluginChain.ts

@@ -1,120 +0,0 @@
-// Copyright (c) Microsoft Corporation. All rights reserved.
-// Licensed under the MIT License.
-"use strict";
-
-import { ITelemetryItem } from "../JavaScriptSDK.Interfaces/ITelemetryItem";
-import { IProcessTelemetryContext } from "../JavaScriptSDK.Interfaces/IProcessTelemetryContext";
-import { ITelemetryPluginChain } from "../JavaScriptSDK.Interfaces/ITelemetryPluginChain";
-import { ITelemetryPlugin } from "../JavaScriptSDK.Interfaces/ITelemetryPlugin";
-import { _InternalLogMessage } from "./DiagnosticLogger";
-import { doPerf } from "./PerfManager";
-import { LoggingSeverity, _InternalMessageId } from "../JavaScriptSDK.Enums/LoggingEnums";
-import { isFunction } from "./HelperFuncs";
-import { dumpObj } from "./EnvUtils";
-
-export class TelemetryPluginChain implements ITelemetryPluginChain {
-
-    /**
-     * Returns the underlying plugin that is being proxied for the processTelemetry call
-     */
-    getPlugin: () => ITelemetryPlugin;
-
-    /**
-     * Returns the next plugin
-     */
-    getNext: () => ITelemetryPluginChain;
-
-    /**
-     * Sets the next proxy to be executed as the next plugin
-     * (Should only be used during initialization, which is why it's not defined on the interface)
-     */
-    setNext: (nextPlugin:ITelemetryPluginChain) => void;
-
-    /**
-     * Call back for telemetry processing before it it is sent
-     * @param env - This is the current event being reported
-     * @param itemCtx - This is the context for the current request, ITelemetryPlugin instances
-     * can optionally use this to access the current core instance or define / pass additional information
-     * to later plugins (vs appending items to the telemetry item)
-     */
-    processTelemetry: (env: ITelemetryItem, itemCtx: IProcessTelemetryContext) => void;
-
-    /**
-     * Internal flag used to try and identify root cause failures
-     */
-    private _hasRun: boolean;
-
-    constructor(plugin:ITelemetryPlugin, defItemCtx:IProcessTelemetryContext) {
-        let _self = this;
-        let _nextProxy:ITelemetryPluginChain = null;
-        let _hasProcessTelemetry = isFunction(plugin.processTelemetry);
-        let _hasSetNext = isFunction(plugin.setNextPlugin);
-
-        _self._hasRun = false;
-
-        _self.getPlugin = () => {
-            return plugin;
-        };
-
-        _self.getNext = () => {
-            return _nextProxy;
-        };
-
-        _self.setNext = (nextPlugin:ITelemetryPluginChain) => {
-            _nextProxy = nextPlugin;
-        }
-
-        _self.processTelemetry = (env: ITelemetryItem, itemCtx:IProcessTelemetryContext) => {
-            if (!itemCtx) {
-                // Looks like a plugin didn't pass the (optional) context, so restore to the default
-                itemCtx = defItemCtx;
-            }
-
-            let identifier = plugin ? plugin.identifier : "TelemetryPluginChain";
-
-            doPerf(itemCtx ? itemCtx.core() : null, () => identifier + ":processTelemetry", () => {
-                if (plugin && _hasProcessTelemetry) {
-                    _self._hasRun = true;
-                    try {
-    
-                        // Ensure that we keep the context in sync (for processNext()), just in case a plugin
-                        // doesn't calls processTelemetry() instead of itemContext.processNext() or some
-                        // other form of error occurred
-                        itemCtx.setNext(_nextProxy);
-                        if (_hasSetNext) {
-                            // Backward compatibility setting the next plugin on the instance
-                            plugin.setNextPlugin(_nextProxy);
-                        }
-    
-                        // Set a flag on the next plugin so we know if it was attempted to be executed
-                        _nextProxy && ((_nextProxy as TelemetryPluginChain)._hasRun = false);
-    
-                        plugin.processTelemetry(env, itemCtx);
-                    } catch (error) {
-                        let hasRun = _nextProxy && (_nextProxy as TelemetryPluginChain)._hasRun;
-                        if (!_nextProxy || !hasRun) {
-                            // Either we have no next plugin or the current one did not attempt to call the next plugin
-                            // Which means the current one is the root of the failure so log/report this failure
-                            itemCtx.diagLog().throwInternal(
-                                LoggingSeverity.CRITICAL,
-                                _InternalMessageId.PluginException,
-                                "Plugin [" + plugin.identifier + "] failed during processTelemetry - " + dumpObj(error));
-                        }
-    
-                        if (_nextProxy && !hasRun) {
-                            // As part of the failure the current plugin did not attempt to call the next plugin in the cahin
-                            // So rather than leave the pipeline dead in the water we call the next plugin
-                            _nextProxy.processTelemetry(env, itemCtx);
-                        }
-                    }
-                } else if (_nextProxy) {
-                    _self._hasRun = true;
-    
-                    // The underlying plugin is either not defined or does not have a processTelemetry implementation
-                    // so we still want the next plugin to be executed.
-                    _nextProxy.processTelemetry(env, itemCtx);
-                }
-            }, () => ({ item: env }), !((env as any).sync));
-        };
-    }
-}

package/types/JavaScriptSDK/TelemetryPluginChain.d.ts

@@ -1,32 +0,0 @@
-import { ITelemetryItem } from "../JavaScriptSDK.Interfaces/ITelemetryItem";
-import { IProcessTelemetryContext } from "../JavaScriptSDK.Interfaces/IProcessTelemetryContext";
-import { ITelemetryPluginChain } from "../JavaScriptSDK.Interfaces/ITelemetryPluginChain";
-import { ITelemetryPlugin } from "../JavaScriptSDK.Interfaces/ITelemetryPlugin";
-export declare class TelemetryPluginChain implements ITelemetryPluginChain {
-    /**
-     * Returns the underlying plugin that is being proxied for the processTelemetry call
-     */
-    getPlugin: () => ITelemetryPlugin;
-    /**
-     * Returns the next plugin
-     */
-    getNext: () => ITelemetryPluginChain;
-    /**
-     * Sets the next proxy to be executed as the next plugin
-     * (Should only be used during initialization, which is why it's not defined on the interface)
-     */
-    setNext: (nextPlugin: ITelemetryPluginChain) => void;
-    /**
-     * Call back for telemetry processing before it it is sent
-     * @param env - This is the current event being reported
-     * @param itemCtx - This is the context for the current request, ITelemetryPlugin instances
-     * can optionally use this to access the current core instance or define / pass additional information
-     * to later plugins (vs appending items to the telemetry item)
-     */
-    processTelemetry: (env: ITelemetryItem, itemCtx: IProcessTelemetryContext) => void;
-    /**
-     * Internal flag used to try and identify root cause failures
-     */
-    private _hasRun;
-    constructor(plugin: ITelemetryPlugin, defItemCtx: IProcessTelemetryContext);
-}