@microsoft/applicationinsights-common 3.0.8 → 3.0.9

package/types/applicationinsights-common.namespaced.d.ts

@@ -1,5 +1,5 @@
 /*
- * Microsoft Application Insights Common JavaScript Library, 3.0.8
+ * Microsoft Application Insights Common JavaScript Library, 3.0.9
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -7,28 +7,6 @@
  */
 
 declare namespace ApplicationInsights {
-    import { createTraceParent } from '@microsoft/applicationinsights-core-js';
-    import { _eInternalMessageId } from '@microsoft/applicationinsights-core-js';
-    import { eLoggingSeverity } from '@microsoft/applicationinsights-core-js';
-    import { EnumValue } from '@microsoft/applicationinsights-core-js';
-    import { findW3cTraceParent } from '@microsoft/applicationinsights-core-js';
-    import { formatTraceParent } from '@microsoft/applicationinsights-core-js';
-    import { IAppInsightsCore } from '@microsoft/applicationinsights-core-js';
-    import { IConfiguration } from '@microsoft/applicationinsights-core-js';
-    import { ICookieMgr } from '@microsoft/applicationinsights-core-js';
-    import { ICustomProperties } from '@microsoft/applicationinsights-core-js';
-    import { IDiagnosticLogger } from '@microsoft/applicationinsights-core-js';
-    import { IDistributedTraceContext } from '@microsoft/applicationinsights-core-js';
-    import { IPlugin } from '@microsoft/applicationinsights-core-js';
-    import { isBeaconsSupported as isBeaconApiSupported } from '@microsoft/applicationinsights-core-js';
-    import { isSampledFlag } from '@microsoft/applicationinsights-core-js';
-    import { isValidSpanId } from '@microsoft/applicationinsights-core-js';
-    import { isValidTraceId } from '@microsoft/applicationinsights-core-js';
-    import { isValidTraceParent } from '@microsoft/applicationinsights-core-js';
-    import { ITelemetryItem } from '@microsoft/applicationinsights-core-js';
-    import { ITraceParent } from '@microsoft/applicationinsights-core-js';
-    import { parseTraceParent } from '@microsoft/applicationinsights-core-js';
-
     /**
      * Data struct to contain only C section with custom fields.
      */
@@ -125,7 +103,16 @@ declare namespace ApplicationInsights {
         [key: string]: any;
     }): ITelemetryItem;
 
-    
+    /**
+     * Create a new ITraceParent instance using the provided values.
+     * @param traceId - The traceId to use, when invalid a new random W3C id will be generated.
+     * @param spanId - The parent/span id to use, a new random value will be generated if it is invalid.
+     * @param flags - The traceFlags to use, defaults to zero (0) if not supplied or invalid
+     * @param version - The version to used, defaults to version "01" if not supplied or invalid.
+     * @returns
+     */
+    function createTraceParent(traceId?: string, spanId?: string, flags?: number, version?: string): ITraceParent;
+
     let CtxTagKeys: ContextTagKeys;
 
     class Data<TDomain> implements AIData<TDomain>, ISerializable {
@@ -290,6 +277,133 @@ declare namespace ApplicationInsights {
         W3C = 2
     }
 
+    const enum _eInternalMessageId {
+        BrowserDoesNotSupportLocalStorage = 0,
+        BrowserCannotReadLocalStorage = 1,
+        BrowserCannotReadSessionStorage = 2,
+        BrowserCannotWriteLocalStorage = 3,
+        BrowserCannotWriteSessionStorage = 4,
+        BrowserFailedRemovalFromLocalStorage = 5,
+        BrowserFailedRemovalFromSessionStorage = 6,
+        CannotSendEmptyTelemetry = 7,
+        ClientPerformanceMathError = 8,
+        ErrorParsingAISessionCookie = 9,
+        ErrorPVCalc = 10,
+        ExceptionWhileLoggingError = 11,
+        FailedAddingTelemetryToBuffer = 12,
+        FailedMonitorAjaxAbort = 13,
+        FailedMonitorAjaxDur = 14,
+        FailedMonitorAjaxOpen = 15,
+        FailedMonitorAjaxRSC = 16,
+        FailedMonitorAjaxSend = 17,
+        FailedMonitorAjaxGetCorrelationHeader = 18,
+        FailedToAddHandlerForOnBeforeUnload = 19,
+        FailedToSendQueuedTelemetry = 20,
+        FailedToReportDataLoss = 21,
+        FlushFailed = 22,
+        MessageLimitPerPVExceeded = 23,
+        MissingRequiredFieldSpecification = 24,
+        NavigationTimingNotSupported = 25,
+        OnError = 26,
+        SessionRenewalDateIsZero = 27,
+        SenderNotInitialized = 28,
+        StartTrackEventFailed = 29,
+        StopTrackEventFailed = 30,
+        StartTrackFailed = 31,
+        StopTrackFailed = 32,
+        TelemetrySampledAndNotSent = 33,
+        TrackEventFailed = 34,
+        TrackExceptionFailed = 35,
+        TrackMetricFailed = 36,
+        TrackPVFailed = 37,
+        TrackPVFailedCalc = 38,
+        TrackTraceFailed = 39,
+        TransmissionFailed = 40,
+        FailedToSetStorageBuffer = 41,
+        FailedToRestoreStorageBuffer = 42,
+        InvalidBackendResponse = 43,
+        FailedToFixDepricatedValues = 44,
+        InvalidDurationValue = 45,
+        TelemetryEnvelopeInvalid = 46,
+        CreateEnvelopeError = 47,
+        MaxUnloadHookExceeded = 48,
+        CannotSerializeObject = 48,
+        CannotSerializeObjectNonSerializable = 49,
+        CircularReferenceDetected = 50,
+        ClearAuthContextFailed = 51,
+        ExceptionTruncated = 52,
+        IllegalCharsInName = 53,
+        ItemNotInArray = 54,
+        MaxAjaxPerPVExceeded = 55,
+        MessageTruncated = 56,
+        NameTooLong = 57,
+        SampleRateOutOfRange = 58,
+        SetAuthContextFailed = 59,
+        SetAuthContextFailedAccountName = 60,
+        StringValueTooLong = 61,
+        StartCalledMoreThanOnce = 62,
+        StopCalledWithoutStart = 63,
+        TelemetryInitializerFailed = 64,
+        TrackArgumentsNotSpecified = 65,
+        UrlTooLong = 66,
+        SessionStorageBufferFull = 67,
+        CannotAccessCookie = 68,
+        IdTooLong = 69,
+        InvalidEvent = 70,
+        FailedMonitorAjaxSetRequestHeader = 71,
+        SendBrowserInfoOnUserInit = 72,
+        PluginException = 73,
+        NotificationException = 74,
+        SnippetScriptLoadFailure = 99,
+        InvalidInstrumentationKey = 100,
+        CannotParseAiBlobValue = 101,
+        InvalidContentBlob = 102,
+        TrackPageActionEventFailed = 103,
+        FailedAddingCustomDefinedRequestContext = 104,
+        InMemoryStorageBufferFull = 105,
+        InstrumentationKeyDeprecation = 106,
+        ConfigWatcherException = 107,
+        DynamicConfigException = 108,
+        DefaultThrottleMsgKey = 109,
+        CdnDeprecation = 110,
+        SdkLdrUpdate = 111
+    }
+
+    const enum eLoggingSeverity {
+        /**
+         * No Logging will be enabled
+         */
+        DISABLED = 0,
+        /**
+         * Error will be sent as internal telemetry
+         */
+        CRITICAL = 1,
+        /**
+         * Error will NOT be sent as internal telemetry, and will only be shown in browser console
+         */
+        WARNING = 2,
+        /**
+         * The Error will NOT be sent as an internal telemetry, and will only be shown in the browser
+         * console if the logging level allows it.
+         */
+        DEBUG = 3
+    }
+
+    /**
+     * A type that identifies an enum class generated from a constant enum.
+     * @group Enum
+     * @typeParam E - The constant enum type
+     *
+     * Returned from {@link createEnum}
+     */
+    type EnumCls<E = any> = {
+        readonly [key in keyof E extends string | number | symbol ? keyof E : never]: key extends string ? E[key] : key;
+    } & {
+        readonly [key in keyof E]: E[key];
+    };
+
+    type EnumValue<E = any> = EnumCls<E>;
+
     class Envelope implements IEnvelope {
         /**
          * The data contract for serializing this object.
@@ -452,6 +566,21 @@ declare namespace ApplicationInsights {
         SDKExt: string;
     };
 
+    const enum FeatureOptInMode {
+        /**
+         * not set, completely depends on cdn cfg
+         */
+        none = 1,
+        /**
+         * try to not apply config from cdn
+         */
+        disable = 2,
+        /**
+         * try to apply config from cdn
+         */
+        enable = 3
+    }
+
     /**
      * Enum is used in aiDataContract to describe how fields are serialized.
      * For instance: (Fieldtype.Required | FieldType.Array) will mark the field as required and indicate it's an array
@@ -463,14 +592,34 @@ declare namespace ApplicationInsights {
         Hidden = 4
     }
 
-    
+    /**
+     * This defines the handler function that is called via the finally when the promise is resolved or rejected
+     */
+    type FinallyPromiseHandler = (() => void) | undefined | null;
+
+    /**
+     * Helper function to fetch the passed traceparent from the page, looking for it as a meta-tag or a Server-Timing header.
+     * @param selectIdx - If the found value is comma separated which is the preferred entry to select, defaults to the first
+     * @returns
+     */
+    function findW3cTraceParent(selectIdx?: number): ITraceParent;
+
     /**
      * Formats the provided errorObj for display and reporting, it may be a String, Object, integer or undefined depending on the browser.
      * @param errorObj - The supplied errorObj
      */
     function _formatErrorCode(errorObj: any): any;
 
-    
+    /**
+     * Format the ITraceParent value as a string using the supported and know version formats.
+     * So even if the passed traceParent is a later version the string value returned from this
+     * function will convert it to only the known version formats.
+     * This currently only supports version "00" and invalid "ff"
+     * @param value - The parsed traceParent value
+     * @returns
+     */
+    function formatTraceParent(value: ITraceParent): string;
+
     function getExtensionByName(extensions: IPlugin[], identifier: string): IPlugin | null;
 
     const HttpMethod = "http.method";
@@ -506,6 +655,150 @@ declare namespace ApplicationInsights {
         }): void;
     }
 
+    interface IAppInsightsCore<CfgType extends IConfiguration = IConfiguration> extends IPerfManagerProvider {
+        readonly config: CfgType;
+        /**
+         * The current logger instance for this instance.
+         */
+        readonly logger: IDiagnosticLogger;
+        /**
+         * An array of the installed plugins that provide a version
+         */
+        readonly pluginVersionStringArr: string[];
+        /**
+         * The formatted string of the installed plugins that contain a version number
+         */
+        readonly pluginVersionString: string;
+        /**
+         * Returns a value that indicates whether the instance has already been previously initialized.
+         */
+        isInitialized?: () => boolean;
+        initialize(config: CfgType, extensions: IPlugin[], logger?: IDiagnosticLogger, notificationManager?: INotificationManager): void;
+        getChannels(): IChannelControls[];
+        track(telemetryItem: ITelemetryItem): void;
+        /**
+         * Get the current notification manager
+         */
+        getNotifyMgr(): INotificationManager;
+        /**
+         * Get the current cookie manager for this instance
+         */
+        getCookieMgr(): ICookieMgr;
+        /**
+         * Set the current cookie manager for this instance
+         * @param cookieMgr - The manager, if set to null/undefined will cause the default to be created
+         */
+        setCookieMgr(cookieMgr: ICookieMgr): 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 listener - An INotificationListener object.
+         */
+        addNotificationListener?(listener: INotificationListener): void;
+        /**
+         * Removes all instances of the listener.
+         * @param 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;
+        pollInternalLogs?(eventName?: string): ITimerHandler;
+        stopPollingInternalLogs?(): void;
+        /**
+         * Return a new instance of the IProcessTelemetryContext for processing events
+         */
+        getProcessTelContext(): IProcessTelemetryContext;
+        /**
+         * Unload and Tear down the SDK and any initialized plugins, after calling this the SDK will be considered
+         * to be un-initialized and non-operational, re-initializing the SDK should only be attempted if the previous
+         * unload call return `true` stating that all plugins reported that they also unloaded, the recommended
+         * approach is to create a new instance and initialize that instance.
+         * This is due to possible unexpected side effects caused by plugins not supporting unload / teardown, unable
+         * to successfully remove any global references or they may just be completing the unload process asynchronously.
+         * If you pass isAsync as `true` (also the default) and DO NOT pass a callback function then an [IPromise](https://nevware21.github.io/ts-async/typedoc/interfaces/IPromise.html)
+         * will be returned which will resolve once the unload is complete. The actual implementation of the `IPromise`
+         * will be a native Promise (if supported) or the default as supplied by [ts-async library](https://github.com/nevware21/ts-async)
+         * @param isAsync - Can the unload be performed asynchronously (default)
+         * @param unloadComplete - An optional callback that will be called once the unload has completed
+         * @param cbTimeout - An optional timeout to wait for any flush operations to complete before proceeding with the
+         * unload. Defaults to 5 seconds.
+         * @return Nothing or if occurring asynchronously a [IPromise](https://nevware21.github.io/ts-async/typedoc/interfaces/IPromise.html)
+         * which will be resolved once the unload is complete, the [IPromise](https://nevware21.github.io/ts-async/typedoc/interfaces/IPromise.html)
+         * will only be returned when no callback is provided and isAsync is true
+         */
+        unload(isAsync?: boolean, unloadComplete?: (unloadState: ITelemetryUnloadState) => void, cbTimeout?: number): void | IPromise<ITelemetryUnloadState>;
+        /**
+         * Find and return the (first) plugin with the specified identifier if present
+         * @param pluginIdentifier
+         */
+        getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
+        /**
+         * Add a new plugin to the installation
+         * @param plugin - The new plugin to add
+         * @param replaceExisting - should any existing plugin be replaced, default is false
+         * @param doAsync - Should the add be performed asynchronously
+         * @param addCb - [Optional] callback to call after the plugin has been added
+         */
+        addPlugin<T extends IPlugin = ITelemetryPlugin>(plugin: T, replaceExisting?: boolean, doAsync?: boolean, addCb?: (added?: boolean) => void): void;
+        /**
+         * Update the configuration used and broadcast the changes to all loaded plugins, this does NOT support updating, adding or removing
+         * any the plugins (extensions or channels). It will notify each plugin (if supported) that the configuration has changed but it will
+         * not remove or add any new plugins, you need to call addPlugin or getPlugin(identifier).remove();
+         * @param newConfig - The new configuration is apply
+         * @param mergeExisting - Should the new configuration merge with the existing or just replace it. Default is to merge.
+         */
+        updateCfg(newConfig: CfgType, mergeExisting?: boolean): void;
+        /**
+         * Returns the unique event namespace that should be used when registering events
+         */
+        evtNamespace(): string;
+        /**
+         * Add a handler that will be called when the SDK is being unloaded
+         * @param handler - the handler
+         */
+        addUnloadCb(handler: UnloadHandler): void;
+        /**
+         * Add this hook so that it is automatically removed during unloading
+         * @param hooks - The single hook or an array of IInstrumentHook objects
+         */
+        addUnloadHook(hooks: IUnloadHook | IUnloadHook[] | Iterator<IUnloadHook> | ILegacyUnloadHook | ILegacyUnloadHook[] | Iterator<ILegacyUnloadHook>): void;
+        /**
+         * Flush and send any batched / cached data immediately
+         * @param async - send data asynchronously when true (defaults to 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
+         * @param cbTimeout - An optional timeout to wait for any flush operations to complete before proceeding with the unload. Defaults to 5 seconds.
+         * @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(isAsync?: boolean, callBack?: (flushComplete?: boolean) => void, sendReason?: SendRequestReason, cbTimeout?: number): boolean | void;
+        /**
+         * Gets the current distributed trace context for this instance if available
+         * @param createNew - Optional flag to create a new instance if one doesn't currently exist, defaults to true
+         */
+        getTraceCtx(createNew?: boolean): IDistributedTraceContext | null;
+        /**
+         * Sets the current distributed trace context for this instance if available
+         */
+        setTraceCtx(newTraceCtx: IDistributedTraceContext | null | undefined): void;
+        /**
+         * Watches and tracks changes for accesses to the current config, and if the accessed config changes the
+         * handler will be recalled.
+         * @param handler
+         * @returns A watcher handler instance that can be used to remove itself when being unloaded
+         */
+        onCfgChange(handler: WatcherFunction<CfgType>): IUnloadHook;
+        /**
+         * Function used to identify the get w parameter used to identify status bit to some channels
+         */
+        getWParam: () => number;
+    }
+
     interface IApplication {
         /**
          * The application version.
@@ -579,6 +872,106 @@ declare namespace ApplicationInsights {
         errorSrc?: string;
     }
 
+    interface IBaseProcessingContext {
+        /**
+         * The current core instance for the request
+         */
+        core: () => IAppInsightsCore;
+        /**
+         * THe current diagnostic logger for the request
+         */
+        diagLog: () => IDiagnosticLogger;
+        /**
+         * Gets the current core config instance
+         */
+        getCfg: () => IConfiguration;
+        /**
+         * Gets the named extension config
+         */
+        getExtCfg: <T>(identifier: string, defaultValue?: IConfigDefaults<T>) => T;
+        /**
+         * Gets the named config from either the named identifier extension or core config if neither exist then the
+         * default value is returned
+         * @param identifier - The named extension identifier
+         * @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 | 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
+         */
+        hasNext: () => boolean;
+        /**
+         * Returns the next configured plugin proxy
+         */
+        getNext: () => ITelemetryPluginChain;
+        /**
+         * Helper to set the next plugin proxy
+         */
+        setNext: (nextCtx: ITelemetryPluginChain) => 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;
+        /**
+         * Set the function to call when the current chain has executed all processNext or unloadNext items.
+         * @param onComplete - The onComplete to call
+         * @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: () => 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
+         * @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) => IBaseProcessingContext;
+    }
+
+    /**
+     * Provides data transmission capabilities
+     */
+    interface IChannelControls extends ITelemetryPlugin {
+        /**
+         * Pause sending data
+         */
+        pause?(): void;
+        /**
+         * Resume sending data
+         */
+        resume?(): void;
+        /**
+         * Tear down the plugin and remove any hooked value, the plugin should be removed so that it is no longer initialized and
+         * therefore could be re-initialized after being torn down. The plugin should ensure that once this has been called any further
+         * processTelemetry calls are ignored and it just calls the processNext() with the provided context.
+         * @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.
+         * @returns boolean - true if the plugin has or will call processNext(), this for backward compatibility as previously teardown was synchronous and returned nothing.
+         */
+        teardown?: (unloadCtx?: IProcessTelemetryUnloadContext, unloadState?: ITelemetryUnloadState) => void | boolean;
+        /**
+         * Flush to send data immediately; channel should default to sending data asynchronously. If executing asynchronously and
+         * you DO NOT pass a callback function then a [IPromise](https://nevware21.github.io/ts-async/typedoc/interfaces/IPromise.html)
+         * will be returned which will resolve once the flush is complete. The actual implementation of the `IPromise`
+         * will be a native Promise (if supported) or the default as supplied by [ts-async library](https://github.com/nevware21/ts-async)
+         * @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 - If a callback is provided `true` to indicate that callback will be called after the flush is complete otherwise the caller
+         * should assume that any provided callback will never be called, Nothing or if occurring asynchronously a
+         * [IPromise](https://nevware21.github.io/ts-async/typedoc/interfaces/IPromise.html) which will be resolved once the unload is complete,
+         * the [IPromise](https://nevware21.github.io/ts-async/typedoc/interfaces/IPromise.html) will only be returned when no callback is provided
+         * and async is true.
+         */
+        flush?(async: boolean, callBack?: (flushComplete?: boolean) => void, sendReason?: SendRequestReason): boolean | void | IPromise<boolean>;
+    }
+
     /**
      * Configuration settings for how telemetry is sent
      * @export
@@ -894,6 +1287,237 @@ declare namespace ApplicationInsights {
         };
     }
 
+    /**
+     * The type to identify whether the default value should be applied in preference to the provided value.
+     */
+    type IConfigCheckFn<V> = (value: V) => boolean;
+
+    /**
+     * The default values with a check function
+     */
+    interface IConfigDefaultCheck<T, V, C = IConfiguration> {
+        /**
+         * Callback function to check if the user-supplied value is valid, if not the default will be applied
+         */
+        isVal?: IConfigCheckFn<V>;
+        /**
+         * Optional function to allow converting and setting of the default value
+         */
+        set?: IConfigSetFn<T, V>;
+        /**
+         * The default value to apply if the user-supplied value is not valid
+         */
+        v?: V | IConfigDefaults<V, T>;
+        /**
+         *  The default fallback key if the main key is not present, this is the key value from the config
+         */
+        fb?: keyof T | keyof C | Array<keyof T | keyof C>;
+        /**
+         * Use this check to determine the default fallback, default only checked whether the property isDefined,
+         * therefore `null`; `""` are considered to be valid values.
+         */
+        dfVal?: (value: any) => boolean;
+        /**
+         * Specify that any provided value should have the default value(s) merged into the value rather than
+         * just using either the default of user provided values. Mergeed objects will automatically be marked
+         * as referenced.
+         */
+        mrg?: boolean;
+        /**
+         * Set this field of the target as referenced, which will cause any object or array instance
+         * to be updated in-place rather than being entirely replaced. All other values will continue to be replaced.
+         * This is required for nested default objects to avoid multiple repetitive updates to listeners
+         * @returns The referenced properties current value
+         */
+        ref?: boolean;
+        /**
+         * Set this field of the target as read-only, which will block this single named property from
+         * ever being changed for the target instance.
+         * This does NOT freeze or seal the instance, it just stops the direct re-assignment of the named property,
+         * if the value is a non-primitive (ie. an object or array) it's properties will still be mutable.
+         * @returns The referenced properties current value
+         */
+        rdOnly?: boolean;
+        /**
+         * Block the value associated with this property from having it's properties / values converted into
+         * dynamic properties, this is generally used to block objects or arrays provided by external libraries
+         * which may be a plain object with readonly (non-configurable) or const properties.
+         */
+        blkVal?: boolean;
+    }
+
+    /**
+     * The Type definition to define default values to be applied to the config
+     * The value may be either the direct value or a ConfigDefaultCheck definition
+     */
+    type IConfigDefaults<T, C = IConfiguration> = {
+        [key in keyof T]: T[key] | IConfigDefaultCheck<T, T[key], C>;
+    };
+
+    /**
+     * The type which identifies the function use to validate the user supplied value
+     */
+    type IConfigSetFn<T, V> = (value: any, defValue: V, theConfig: T) => V;
+
+    /**
+     * Configuration provided to SDK core
+     */
+    interface IConfiguration {
+        /**
+         * Instrumentation key of resource. Either this or connectionString must be specified.
+         */
+        instrumentationKey?: string;
+        /**
+         * Connection string of resource. Either this or instrumentationKey must be specified.
+         */
+        connectionString?: string;
+        /**
+         * Set the timer interval (in ms) for internal logging queue, this is the
+         * amount of time to wait after logger.queue messages are detected to be sent.
+         * Note: since 3.0.1 and 2.8.13 the diagnostic logger timer is a normal timeout timer
+         * and not an interval timer. So this now represents the timer "delay" and not
+         * the frequency at which the events are sent.
+         */
+        diagnosticLogInterval?: number;
+        /**
+         * Maximum number of iKey transmitted logging telemetry per page view
+         */
+        maxMessageLimit?: number;
+        /**
+         * Console logging level. All logs with a severity level higher
+         * than the configured level will be printed to console. Otherwise
+         * they are suppressed. ie Level 2 will print both CRITICAL and
+         * WARNING logs to console, level 1 prints only CRITICAL.
+         *
+         * Note: Logs sent as telemetry to instrumentation key will also
+         * be logged to console if their severity meets the configured loggingConsoleLevel
+         *
+         * 0: ALL console logging off
+         * 1: logs to console: severity >= CRITICAL
+         * 2: logs to console: severity >= WARNING
+         */
+        loggingLevelConsole?: number;
+        /**
+         * Telemtry logging level to instrumentation key. All logs with a severity
+         * level higher than the configured level will sent as telemetry data to
+         * the configured instrumentation key.
+         *
+         * 0: ALL iKey logging off
+         * 1: logs to iKey: severity >= CRITICAL
+         * 2: logs to iKey: severity >= WARNING
+         */
+        loggingLevelTelemetry?: number;
+        /**
+         * If enabled, uncaught exceptions will be thrown to help with debugging
+         */
+        enableDebug?: boolean;
+        /**
+         * Endpoint where telemetry data is sent
+         */
+        endpointUrl?: string;
+        /**
+         * Extension configs loaded in SDK
+         */
+        extensionConfig?: {
+            [key: string]: any;
+        };
+        /**
+         * Additional plugins that should be loaded by core at runtime
+         */
+        readonly extensions?: ITelemetryPlugin[];
+        /**
+         * Channel queues that is setup by caller in desired order.
+         * If channels are provided here, core will ignore any channels that are already setup, example if there is a SKU with an initialized channel
+         */
+        readonly channels?: IChannelControls[][];
+        /**
+         * @type {boolean}
+         * Flag that disables the Instrumentation Key validation.
+         */
+        disableInstrumentationKeyValidation?: boolean;
+        /**
+         * [Optional] When enabled this will create local perfEvents based on sections of the code that have been instrumented
+         * to emit perfEvents (via the doPerf()) when this is enabled. This can be used to identify performance issues within
+         * the SDK, the way you are using it or optionally your own instrumented code.
+         * The provided IPerfManager implementation does NOT send any additional telemetry events to the server it will only fire
+         * the new perfEvent() on the INotificationManager which you can listen to.
+         * This also does not use the window.performance API, so it will work in environments where this API is not supported.
+         */
+        enablePerfMgr?: boolean;
+        /**
+         * [Optional] Callback function that will be called to create a the IPerfManager instance when required and ```enablePerfMgr```
+         * is enabled, this enables you to override the default creation of a PerfManager() without needing to ```setPerfMgr()```
+         * after initialization.
+         */
+        createPerfMgr?: (core: IAppInsightsCore, notificationManager: INotificationManager) => IPerfManager;
+        /**
+         * [Optional] Fire every single performance event not just the top level root performance event. Defaults to false.
+         */
+        perfEvtsSendAll?: boolean;
+        /**
+         * [Optional] Identifies the default length used to generate random session and user id's if non currently exists for the user / session.
+         * Defaults to 22, previous default value was 5, if you need to keep the previous maximum length you should set this value to 5.
+         */
+        idLength?: number;
+        /**
+         * @description Custom cookie domain. This is helpful if you want to share Application Insights cookies across subdomains. It
+         * can be set here or as part of the cookieCfg.domain, the cookieCfg takes precedence if both are specified.
+         * @type {string}
+         * @defaultValue ""
+         */
+        cookieDomain?: string;
+        /**
+         * @description Custom cookie path. This is helpful if you want to share Application Insights cookies behind an application
+         * gateway. It can be set here or as part of the cookieCfg.domain, the cookieCfg takes precedence if both are specified.
+         * @type {string}
+         * @defaultValue ""
+         */
+        cookiePath?: string;
+        /**
+         * [Optional] A boolean that indicated whether to disable the use of cookies by the SDK. If true, the SDK will not store or
+         * read any data from cookies. Cookie usage can be re-enabled after initialization via the core.getCookieMgr().enable().
+         */
+        disableCookiesUsage?: boolean;
+        /**
+         * [Optional] A Cookie Manager configuration which includes hooks to allow interception of the get, set and delete cookie
+         * operations. If this configuration is specified any specified enabled and domain properties will take precedence over the
+         * cookieDomain and disableCookiesUsage values.
+         */
+        cookieCfg?: ICookieMgrConfig;
+        /**
+         * [Optional] An array of the page unload events that you would like to be ignored, special note there must be at least one valid unload
+         * event hooked, if you list all or the runtime environment only supports a listed "disabled" event it will still be hooked, if required by the SDK.
+         * Unload events include "beforeunload", "unload", "visibilitychange" (with 'hidden' state) and "pagehide"
+         */
+        disablePageUnloadEvents?: string[];
+        /**
+         * [Optional] An array of page show events that you would like to be ignored, special note there must be at lease one valid show event
+         * hooked, if you list all or the runtime environment only supports a listed (disabled) event it will STILL be hooked, if required by the SDK.
+         * Page Show events include "pageshow" and "visibilitychange" (with 'visible' state)
+         */
+        disablePageShowEvents?: string[];
+        /**
+         * [Optional] A flag for performance optimization to disable attempting to use the Chrome Debug Extension, if disabled and the extension is installed
+         * this will not send any notifications.
+         */
+        disableDbgExt?: boolean;
+        /**
+         * Add "&w=0" parameter to support UA Parsing when web-workers don't have access to Document.
+         * Default is false
+         */
+        enableWParam?: boolean;
+        /**
+         * Custom optional value that will be added as a prefix for storage name.
+         * @defaultValue undefined
+         */
+        storagePrefix?: string;
+        /**
+         * Custom optional value to opt in features
+         * @defaultValue undefined
+         */
+        featureOptIn?: IFeatureOptIn;
+    }
+
     interface IContextTagKeys {
         /**
          * Application version. Information in the application context fields is always about the application that is sending the telemetry.
@@ -1065,46 +1689,154 @@ declare namespace ApplicationInsights {
         readonly internalSdkSrc: string;
     }
 
-    interface ICorrelationConfig {
-        enableCorsCorrelation: boolean;
-        correlationHeaderExcludedDomains: string[];
-        correlationHeaderExcludePatterns?: RegExp[];
-        disableCorrelationHeaders: boolean;
-        distributedTracingMode: DistributedTracingModes;
-        maxAjaxCallsPerView: number;
-        disableAjaxTracking: boolean;
-        disableFetchTracking: boolean;
-        appId?: string;
-        enableRequestHeaderTracking?: boolean;
-        enableResponseHeaderTracking?: boolean;
-        enableAjaxErrorStatusText?: boolean;
+    interface ICookieMgr {
         /**
-         * Flag to enable looking up and including additional browser window.performance timings
-         * in the reported ajax (XHR and fetch) reported metrics.
-         * Defaults to false.
+         * Enable or Disable the usage of cookies
          */
-        enableAjaxPerfTracking?: boolean;
+        setEnabled(value: boolean): void;
         /**
-         * The maximum number of times to look for the window.performance timings (if available), this
-         * is required as not all browsers populate the window.performance before reporting the
-         * end of the XHR request and for fetch requests this is added after its complete
-         * Defaults to 3
+         * Can the system use cookies, if this returns false then all cookie setting and access functions will return nothing
          */
-        maxAjaxPerfLookupAttempts?: number;
+        isEnabled(): boolean;
         /**
-         * The amount of time to wait before re-attempting to find the windows.performance timings
-         * for an ajax request, time is in milliseconds and is passed directly to setTimeout()
-         * Defaults to 25.
+         * Set the named cookie with the value and optional domain and optional
+         * @param name - The name of the cookie
+         * @param value - The value of the cookie (Must already be encoded)
+         * @param maxAgeSec - [optional] The maximum number of SECONDS that this cookie should survive
+         * @param domain - [optional] The domain to set for the cookie
+         * @param path - [optional] Path to set for the cookie, if not supplied will default to "/"
+         * @returns - True if the cookie was set otherwise false (Because cookie usage is not enabled or available)
          */
-        ajaxPerfLookupDelay?: number;
-        correlationHeaderDomains?: string[];
+        set(name: string, value: string, maxAgeSec?: number, domain?: string, path?: string): boolean;
         /**
-         * Response and request headers to be excluded from ajax tracking data.
+         * Get the value of the named cookie
+         * @param name - The name of the cookie
          */
-        ignoreHeaders?: string[];
+        get(name: string): string;
         /**
-         * Provide a way to exclude specific route from automatic tracking for XMLHttpRequest or Fetch request.
-         * For an ajax / fetch request that the request url matches with the regex patterns, auto tracking is turned off.
+         * Delete/Remove the named cookie if cookie support is available and enabled.
+         * Note: Not using "delete" as the name because it's a reserved word which would cause issues on older browsers
+         * @param name - The name of the cookie
+         * @param path - [optional] Path to set for the cookie, if not supplied will default to "/"
+         * @returns - True if the cookie was marked for deletion otherwise false (Because cookie usage is not enabled or available)
+         */
+        del(name: string, path?: string): boolean;
+        /**
+         * Purge the cookie from the system if cookie support is available, this function ignores the enabled setting of the manager
+         * so any cookie will be removed.
+         * Note: Not using "delete" as the name because it's a reserved word which would cause issues on older browsers
+         * @param name - The name of the cookie
+         * @param path - [optional] Path to set for the cookie, if not supplied will default to "/"
+         * @returns - True if the cookie was marked for deletion otherwise false (Because cookie usage is not available)
+         */
+        purge(name: string, path?: string): boolean;
+        /**
+         * Optional Callback hook to allow the cookie manager to update it's configuration, not generally implemented now that
+         * dynamic configuration is supported
+         * @param updateState
+         */
+        update?(updateState: ITelemetryUpdateState): void;
+        /**
+         * Unload and remove any state that this ICookieMgr may be holding, this is generally called when the
+         * owning SDK is being unloaded.
+         * @param isAsync - Can the unload be performed asynchronously (default)
+         * @return If the unload occurs synchronously then nothing should be returned, if happening asynchronously then
+         * the function should return an [IPromise](https://nevware21.github.io/ts-async/typedoc/interfaces/IPromise.html)
+         * / Promise to allow any listeners to wait for the operation to complete.
+         */
+        unload?(isAsync?: boolean): void | IPromise<void>;
+    }
+
+    /**
+     * Configuration definition for instance based cookie management configuration
+     */
+    interface ICookieMgrConfig {
+        /**
+         * Defaults to true, A boolean that indicates whether the use of cookies by the SDK is enabled by the current instance.
+         * If false, the instance of the SDK initialized by this configuration will not store or read any data from cookies
+         */
+        enabled?: boolean;
+        /**
+         * Custom cookie domain. This is helpful if you want to share Application Insights cookies across subdomains.
+         */
+        domain?: string;
+        /**
+         * Specifies the path to use for the cookie, defaults to '/'
+         */
+        path?: string;
+        /**
+         * Specify the cookie name(s) to be ignored, this will cause any matching cookie name to never be read or written.
+         * They may still be explicitly purged or deleted. You do not need to repeat the name in the `blockedCookies`
+         * configuration.(Since v2.8.8)
+         */
+        ignoreCookies?: string[];
+        /**
+         * Specify the cookie name(s) to never be written, this will cause any cookie name to never be created or updated,
+         * they will still be read unless also included in the ignoreCookies and may still be explicitly purged or deleted.
+         * If not provided defaults to the same list provided in ignoreCookies. (Since v2.8.8)
+         */
+        blockedCookies?: string[];
+        /**
+         * Hook function to fetch the named cookie value.
+         * @param name - The name of the cookie
+         */
+        getCookie?: (name: string) => string;
+        /**
+         * Hook function to set the named cookie with the specified value.
+         * @param name - The name of the cookie
+         * @param value - The value to set for the cookie
+         */
+        setCookie?: (name: string, value: string) => void;
+        /**
+         * Hook function to delete the named cookie with the specified value, separated from
+         * setCookie to avoid the need to parse the value to determine whether the cookie is being
+         * added or removed.
+         * @param name - The name of the cookie
+         * @param cookieValue - The value to set to expire the cookie
+         */
+        delCookie?: (name: string, cookieValue: string) => void;
+    }
+
+    interface ICorrelationConfig {
+        enableCorsCorrelation: boolean;
+        correlationHeaderExcludedDomains: string[];
+        correlationHeaderExcludePatterns?: RegExp[];
+        disableCorrelationHeaders: boolean;
+        distributedTracingMode: DistributedTracingModes;
+        maxAjaxCallsPerView: number;
+        disableAjaxTracking: boolean;
+        disableFetchTracking: boolean;
+        appId?: string;
+        enableRequestHeaderTracking?: boolean;
+        enableResponseHeaderTracking?: boolean;
+        enableAjaxErrorStatusText?: boolean;
+        /**
+         * Flag to enable looking up and including additional browser window.performance timings
+         * in the reported ajax (XHR and fetch) reported metrics.
+         * Defaults to false.
+         */
+        enableAjaxPerfTracking?: boolean;
+        /**
+         * The maximum number of times to look for the window.performance timings (if available), this
+         * is required as not all browsers populate the window.performance before reporting the
+         * end of the XHR request and for fetch requests this is added after its complete
+         * Defaults to 3
+         */
+        maxAjaxPerfLookupAttempts?: number;
+        /**
+         * The amount of time to wait before re-attempting to find the windows.performance timings
+         * for an ajax request, time is in milliseconds and is passed directly to setTimeout()
+         * Defaults to 25.
+         */
+        ajaxPerfLookupDelay?: number;
+        correlationHeaderDomains?: string[];
+        /**
+         * Response and request headers to be excluded from ajax tracking data.
+         */
+        ignoreHeaders?: string[];
+        /**
+         * Provide a way to exclude specific route from automatic tracking for XMLHttpRequest or Fetch request.
+         * For an ajax / fetch request that the request url matches with the regex patterns, auto tracking is turned off.
          * Default is undefined.
          */
         excludeRequestFromAutoTrackingPatterns?: string[] | RegExp[];
@@ -1122,6 +1854,10 @@ declare namespace ApplicationInsights {
         addIntEndpoints?: boolean;
     }
 
+    interface ICustomProperties {
+        [key: string]: any;
+    }
+
     /**
      * Metric data single measurement.
      */
@@ -1196,6 +1932,110 @@ declare namespace ApplicationInsights {
         ip: string;
     }
 
+    interface IDiagnosticLogger {
+        /**
+         * 0: OFF
+         * 1: only critical (default)
+         * 2: critical + info
+         */
+        consoleLoggingLevel: () => number;
+        /**
+         * The internal logging queue
+         */
+        queue: _InternalLogMessage[];
+        /**
+         * This method will throw exceptions in debug mode or attempt to log the error as a console warning.
+         * @param severity - The severity of the log message
+         * @param message - The log message.
+         */
+        throwInternal(severity: LoggingSeverity, msgId: _InternalMessageId, msg: string, properties?: Object, isUserAct?: boolean): void;
+        /**
+         * This will write a debug message to the console if possible
+         * @param message - {string} - The debug message
+         */
+        debugToConsole?(message: string): void;
+        /**
+         * This will write a warning to the console if possible
+         * @param message - The warning message
+         */
+        warnToConsole(message: string): void;
+        /**
+         * This will write an error to the console if possible.
+         * Provided by the default DiagnosticLogger instance, and internally the SDK will fall back to warnToConsole, however,
+         * direct callers MUST check for its existence on the logger as you can provide your own IDiagnosticLogger instance.
+         * @param message - The error message
+         */
+        errorToConsole?(message: string): void;
+        /**
+         * Resets the internal message count
+         */
+        resetInternalMessageCount(): void;
+        /**
+         * Logs a message to the internal queue.
+         * @param severity - The severity of the log message
+         * @param message - The message to log.
+         */
+        logInternalMessage?(severity: LoggingSeverity, message: _InternalLogMessage): void;
+        /**
+         * Optional Callback hook to allow the diagnostic logger to update it's configuration
+         * @param updateState
+         */
+        update?(updateState: ITelemetryUpdateState): void;
+        /**
+         * Unload and remove any state that this IDiagnosticLogger may be holding, this is generally called when the
+         * owning SDK is being unloaded.
+         * @param isAsync - Can the unload be performed asynchronously (default)
+         * @return If the unload occurs synchronously then nothing should be returned, if happening asynchronously then
+         * the function should return an [IPromise](https://nevware21.github.io/ts-async/typedoc/interfaces/IPromise.html)
+         * / Promise to allow any listeners to wait for the operation to complete.
+         */
+        unload?(isAsync?: boolean): void | IPromise<void>;
+    }
+
+    interface IDistributedTraceContext {
+        /**
+         * Returns the current name of the page
+         */
+        getName(): string;
+        /**
+         * Sets the current name of the page
+         * @param pageName
+         */
+        setName(pageName: string): void;
+        /**
+         * Returns the unique identifier for a trace. All requests / spans from the same trace share the same traceId.
+         * Must be read from incoming headers or generated according to the W3C TraceContext specification,
+         * in a hex representation of 16-byte array. A.k.a. trace-id, TraceID or Distributed TraceID
+         */
+        getTraceId(): string;
+        /**
+         * Set the unique identifier for a trace. All requests / spans from the same trace share the same traceId.
+         * Must be conform to the W3C TraceContext specification, in a hex representation of 16-byte array.
+         * A.k.a. trace-id, TraceID or Distributed TraceID https://www.w3.org/TR/trace-context/#trace-id
+         */
+        setTraceId(newValue: string): void;
+        /**
+         * Self-generated 8-bytes identifier of the incoming request. Must be a hex representation of 8-byte array.
+         * Also know as the parentId, used to link requests together
+         */
+        getSpanId(): string;
+        /**
+         * Self-generated 8-bytes identifier of the incoming request. Must be a hex representation of 8-byte array.
+         * Also know as the parentId, used to link requests together
+         * https://www.w3.org/TR/trace-context/#parent-id
+         */
+        setSpanId(newValue: string): void;
+        /**
+         * An integer representation of the W3C TraceContext trace-flags.
+         */
+        getTraceFlags(): number | undefined;
+        /**
+         * https://www.w3.org/TR/trace-context/#trace-flags
+         * @param newValue
+         */
+        setTraceFlags(newValue?: number): void;
+    }
+
     /**
      * The abstract common base of all domains.
      */
@@ -1396,6 +2236,41 @@ declare namespace ApplicationInsights {
         severityLevel?: SeverityLevel | number;
     }
 
+    interface IFeatureOptIn {
+        [feature: string]: IFeatureOptInDetails;
+    }
+
+    interface IFeatureOptInDetails {
+        /**
+         * sets feature opt-in mode
+         * @default undefined
+         */
+        mode?: FeatureOptInMode;
+        /**
+         * Identifies configuration override values when given feature is enabled
+         * NOTE: should use flat string for fields, for example, if you want to set value for extensionConfig.Ananlytics.disableAjaxTrackig in configurations,
+         * you should use "extensionConfig.Ananlytics.disableAjaxTrackig" as field name: {["extensionConfig.Analytics.disableAjaxTrackig"]:1}
+         * Default: undefined
+         */
+        onCfg?: {
+            [field: string]: any;
+        };
+        /**
+         * Identifies configuration override values when given feature is disabled
+         * NOTE: should use flat string for fields, for example, if you want to set value for extensionConfig.Ananlytics.disableAjaxTrackig in configurations,
+         * you should use "extensionConfig.Ananlytics.disableAjaxTrackig" as field name: {["extensionConfig.Analytics.disableAjaxTrackig"]:1}
+         * Default: undefined
+         */
+        offCfg?: {
+            [field: string]: any;
+        };
+        /**
+         * define if should block any changes from cdn cfg, if set to true, cfgValue will be applied under all scenarios
+         * @default false
+         */
+        blockCdnCfg?: boolean;
+    }
+
     interface IInternal {
         /**
          * The SDK version used to create this telemetry item.
@@ -1420,6 +2295,34 @@ declare namespace ApplicationInsights {
         sdkSrc: string;
     }
 
+    /**
+     * An alternate interface which provides automatic removal during unloading of the component
+     */
+    interface ILegacyUnloadHook {
+        /**
+         * Legacy Self remove the referenced component
+         */
+        remove: () => void;
+    }
+
+    interface ILoadedPlugin<T extends IPlugin> {
+        plugin: T;
+        /**
+         * Identifies whether the plugin is enabled and can process events. This is slightly different from isInitialized as the plugin may be initialized but disabled
+         * via the setEnabled() or it may be a shared plugin which has had it's teardown function called from another instance..
+         * @returns boolean = true if the plugin is in a state where it is operational.
+         */
+        isEnabled: () => boolean;
+        /**
+         * You can optionally enable / disable a plugin from processing events.
+         * Setting enabled to true will not necessarily cause the `isEnabled()` to also return true
+         * as the plugin must also have been successfully initialized and not had it's `teardown` method called
+         * (unless it's also been re-initialized)
+         */
+        setEnabled: (isEnabled: boolean) => void;
+        remove: (isAsync?: boolean, removeCb?: (removed?: boolean) => void) => void;
+    }
+
     interface ILocation {
         /**
          * Client IP address for reverse lookup
@@ -1521,6 +2424,105 @@ declare namespace ApplicationInsights {
         iKey?: string;
     }
 
+    /**
+     * An interface used for the notification listener.
+     * @interface
+     */
+    interface INotificationListener {
+        /**
+         * [Optional] A function called when events are sent.
+         * @param events - The array of events that have been sent.
+         */
+        eventsSent?: (events: ITelemetryItem[]) => void;
+        /**
+         * [Optional] A function called when events are discarded.
+         * @param events - The array of events that have been discarded.
+         * @param reason - The reason for discarding the events. The EventsDiscardedReason
+         * constant should be used to check the different values.
+         */
+        eventsDiscarded?: (events: ITelemetryItem[], reason: number) => void;
+        /**
+         * [Optional] A function called when the events have been requested to be sent to the sever.
+         * @param sendReason - The reason why the event batch is being sent.
+         * @param isAsync - A flag which identifies whether the requests are being sent in an async or sync manner.
+         */
+        eventsSendRequest?: (sendReason: number, isAsync?: boolean) => void;
+        /**
+         * [Optional] This event is sent if you have enabled perf events, they are primarily used to track internal performance testing and debugging
+         * the event can be displayed via the debug plugin extension.
+         * @param perfEvent
+         */
+        perfEvent?: (perfEvent: IPerfEvent) => void;
+        /**
+         * Unload and remove any state that this INotificationListener may be holding, this is generally called when the
+         * owning Manager is being unloaded.
+         * @param isAsync - Can the unload be performed asynchronously (default)
+         * @return If the unload occurs synchronously then nothing should be returned, if happening asynchronously then
+         * the function should return an [IPromise](https://nevware21.github.io/ts-async/typedoc/interfaces/IPromise.html)
+         * / Promise to allow any listeners to wait for the operation to complete.
+         */
+        unload?(isAsync?: boolean): void | IPromise<void>;
+    }
+
+    /**
+     * Class to manage sending notifications to all the listeners.
+     */
+    interface INotificationManager {
+        listeners: INotificationListener[];
+        /**
+         * Adds a notification listener.
+         * @param listener - The notification listener to be added.
+         */
+        addNotificationListener(listener: INotificationListener): void;
+        /**
+         * Removes all instances of the listener.
+         * @param listener - AWTNotificationListener to remove.
+         */
+        removeNotificationListener(listener: INotificationListener): void;
+        /**
+         * Notification for events sent.
+         * @param events - The array of events that have been sent.
+         */
+        eventsSent(events: ITelemetryItem[]): void;
+        /**
+         * Notification for events being discarded.
+         * @param events - The array of events that have been discarded by the SDK.
+         * @param reason - The reason for which the SDK discarded the events. The EventsDiscardedReason
+         * constant should be used to check the different values.
+         */
+        eventsDiscarded(events: ITelemetryItem[], reason: number): void;
+        /**
+         * [Optional] A function called when the events have been requested to be sent to the sever.
+         * @param sendReason - The reason why the event batch is being sent.
+         * @param isAsync - A flag which identifies whether the requests are being sent in an async or sync manner.
+         */
+        eventsSendRequest?(sendReason: number, isAsync: boolean): void;
+        /**
+         * [Optional] This event is sent if you have enabled perf events, they are primarily used to track internal performance testing and debugging
+         * the event can be displayed via the debug plugin extension.
+         * @param perfEvent - The perf event details
+         */
+        perfEvent?(perfEvent: IPerfEvent): void;
+        /**
+         * Unload and remove any state that this INotificationManager may be holding, this is generally called when the
+         * owning SDK is being unloaded.
+         * @param isAsync - Can the unload be performed asynchronously (default)
+         * @return If the unload occurs synchronously then nothing should be returned, if happening asynchronously then
+         * the function should return an [IPromise](https://nevware21.github.io/ts-async/typedoc/interfaces/IPromise.html)
+         * / Promise to allow any listeners to wait for the operation to complete.
+         */
+        unload?(isAsync?: boolean): void | IPromise<void>;
+    }
+
+    class _InternalLogMessage {
+        static dataType: string;
+        message: string;
+        messageId: _InternalMessageId;
+        constructor(msgId: _InternalMessageId, msg: string, isUserAct?: boolean, properties?: Object);
+    }
+
+    type _InternalMessageId = number | _eInternalMessageId;
+
     interface IOperatingSystem {
         name: string;
     }
@@ -1701,6 +2703,420 @@ declare namespace ApplicationInsights {
         };
     }
 
+    /**
+     * This interface identifies the details of an internal performance event - it does not represent an outgoing reported event
+     */
+    interface IPerfEvent {
+        /**
+         * The name of the performance event
+         */
+        name: string;
+        /**
+         * The start time of the performance event
+         */
+        start: number;
+        /**
+         * The payload (contents) of the perfEvent, may be null or only set after the event has completed depending on
+         * the runtime environment.
+         */
+        payload: any;
+        /**
+         * Is this occurring from an asynchronous event
+         */
+        isAsync: boolean;
+        /**
+         * Identifies the total inclusive time spent for this event, including the time spent for child events,
+         * this will be undefined until the event is completed
+         */
+        time?: number;
+        /**
+         * Identifies the exclusive time spent in for this event (not including child events),
+         * this will be undefined until the event is completed.
+         */
+        exTime?: number;
+        /**
+         * The Parent event that was started before this event was created
+         */
+        parent?: IPerfEvent;
+        /**
+         * The child perf events that are contained within the total time of this event.
+         */
+        childEvts?: IPerfEvent[];
+        /**
+         * Identifies whether this event is a child event of a parent
+         */
+        isChildEvt: () => boolean;
+        /**
+         * Get the names additional context associated with this perf event
+         */
+        getCtx?: (key: string) => any;
+        /**
+         * Set the named additional context to be associated with this perf event, this will replace any existing value
+         */
+        setCtx?: (key: string, value: any) => void;
+        /**
+         * Mark this event as completed, calculating the total execution time.
+         */
+        complete: () => void;
+    }
+
+    /**
+     * This defines an internal performance manager for tracking and reporting the internal performance of the SDK -- It does
+     * not represent or report any event to the server.
+     */
+    interface IPerfManager {
+        /**
+         * 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.
+         * @param src - The source name of the event
+         * @param payloadDetails - An optional callback function to fetch the payload details for the event.
+         * @param isAsync - Is the event occurring from a async event
+         */
+        create(src: string, payloadDetails?: () => any, isAsync?: boolean): IPerfEvent | null | undefined;
+        /**
+         * Complete the perfEvent and fire any notifications.
+         * @param perfEvent - Fire the event which will also complete the passed event
+         */
+        fire(perfEvent: IPerfEvent): void;
+        /**
+         * Set an execution context value
+         * @param key - The context key name
+         * @param value - The value
+         */
+        setCtx(key: string, value: any): void;
+        /**
+         * Get the execution context value
+         * @param key - The context key
+         */
+        getCtx(key: string): any;
+    }
+
+    /**
+     * Identifies an interface to a host that can provide an IPerfManager implementation
+     */
+    interface IPerfManagerProvider {
+        /**
+         * Get the current performance manager
+         */
+        getPerfMgr(): IPerfManager;
+        /**
+         * Set the current performance manager
+         * @param perfMgr - The performance manager
+         */
+        setPerfMgr(perfMgr: IPerfManager): void;
+    }
+
+    interface IPlugin {
+        /**
+         * Initialize plugin loaded by SDK
+         * @param config - The config for the plugin to use
+         * @param core - The current App Insights core to use for initializing this plugin instance
+         * @param extensions - The complete set of extensions to be used for initializing the plugin
+         * @param pluginChain - [Optional] specifies the current plugin chain which identifies the
+         * set of plugins and the order they should be executed for the current request.
+         */
+        initialize: (config: IConfiguration, core: IAppInsightsCore, extensions: IPlugin[], pluginChain?: ITelemetryPluginChain) => void;
+        /**
+         * Returns a value that indicates whether the plugin has already been previously initialized.
+         * New plugins should implement this method to avoid being initialized more than once.
+         */
+        isInitialized?: () => boolean;
+        /**
+         * Tear down the plugin and remove any hooked value, the plugin should be removed so that it is no longer initialized and
+         * therefore could be re-initialized after being torn down. The plugin should ensure that once this has been called any further
+         * processTelemetry calls are ignored and it just calls the processNext() with the provided context.
+         * @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.
+         * @returns boolean - true if the plugin has or will call processNext(), this for backward compatibility as previously teardown was synchronous and returned nothing.
+         */
+        teardown?: (unloadCtx: IProcessTelemetryUnloadContext, unloadState?: ITelemetryUnloadState) => void | boolean;
+        /**
+         * Extension name
+         */
+        readonly identifier: string;
+        /**
+         * Plugin version (available in data.properties.version in common schema)
+         */
+        readonly version?: string;
+        /**
+         * The App Insights core to use for backward compatibility.
+         * Therefore the interface will be able to access the core without needing to cast to "any".
+         * [optional] any 3rd party plugins which are already implementing this interface don't fail to compile.
+         */
+        core?: IAppInsightsCore;
+    }
+
+    /**
+     * The current context for the current call to processTelemetry(), used to support sharing the same plugin instance
+     * between multiple AppInsights instances
+     */
+    interface IProcessTelemetryContext extends IBaseProcessingContext {
+        /**
+         * Call back for telemetry processing before it it is sent
+         * @param env - This is the current event being reported
+         * @returns boolean (true) if there is no more plugins to process otherwise false or undefined (void)
+         */
+        processNext: (env: ITelemetryItem) => boolean | void;
+        /**
+         * Create a new context using the core and config from the current instance, returns a new instance of the same type
+         * @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;
+    }
+
+    /**
+     * The current context for the current call to teardown() implementations, used to support when plugins are being removed
+     * or the SDK is being unloaded.
+     */
+    interface IProcessTelemetryUnloadContext extends IBaseProcessingContext {
+        /**
+         * This Plugin has finished unloading, so unload the next one
+         * @param uploadState - The state of the unload process
+         * @returns boolean (true) if there is no more plugins to process otherwise false or undefined (void)
+         */
+        processNext: (unloadState: ITelemetryUnloadState) => boolean | void;
+        /**
+         * Create a new context using the core and config from the current instance, returns a new instance of the same type
+         * @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) => IProcessTelemetryUnloadContext;
+    }
+
+    /**
+     * The current context for the current call to the plugin update() implementations, used to support the notifications
+     * for when plugins are added, removed or the configuration was changed.
+     */
+    interface IProcessTelemetryUpdateContext extends IBaseProcessingContext {
+        /**
+         * This Plugin has finished unloading, so unload the next one
+         * @param updateState - The update State
+         * @returns boolean (true) if there is no more plugins to process otherwise false or undefined (void)
+         */
+        processNext: (updateState: ITelemetryUpdateState) => boolean | void;
+        /**
+         * Create a new context using the core and config from the current instance, returns a new instance of the same type
+         * @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) => IProcessTelemetryUpdateContext;
+    }
+
+    /**
+     * Create a Promise object that represents the eventual completion (or failure) of an asynchronous operation and its resulting value.
+     * This interface definition, closely mirrors the typescript / javascript PromiseLike<T> and Promise<T> definitions as well as providing
+     * simular functions as that provided by jQuery deferred objects.
+     *
+     * The returned Promise is a proxy for a value not necessarily known when the promise is created. It allows you to associate handlers
+     * with an asynchronous action's eventual success value or failure reason. This lets asynchronous methods return values like synchronous
+     * methods: instead of immediately returning the final value, the asynchronous method returns a promise to supply the value at some point
+     * in the future.
+     *
+     * A Promise is in one of these states:
+     * <ul>
+     * <li> pending: initial state, neither fulfilled nor rejected.
+     * <li> fulfilled: meaning that the operation was completed successfully.
+     * <li> rejected: meaning that the operation failed.
+     * </ul>
+     *
+     * A pending promise can either be fulfilled with a value or rejected with a reason (error). When either of these options happens, the
+     * associated handlers queued up by a promise's then method are called synchronously. If the promise has already been fulfilled or rejected
+     * when a corresponding handler is attached, the handler will be called synchronously, so there is no race condition between an asynchronous
+     * operation completing and its handlers being attached.
+     *
+     * As the `then()` and `catch()` methods return promises, they can be chained.
+     * @typeParam T - Identifies the expected return type from the promise
+     */
+    interface IPromise<T> extends PromiseLike<T>, Promise<T> {
+        /**
+         * Returns a string representation of the current state of the promise. The promise can be in one of four states.
+         * <ul>
+         * <li> <b>"pending"</b>: The promise is not yet in a completed state (neither "rejected"; or "resolved").</li>
+         * <li> <b>"resolved"</b>: The promise is in the resolved state.</li>
+         * <li> <b>"rejected"</b>: The promise is in the rejected state.</li>
+         * </ul>
+         * @example
+         * ```ts
+         * let doResolve;
+         * let promise: IPromise<any> = createSyncPromise((resolve) => {
+         *  doResolve = resolve;
+         * });
+         *
+         * let state: string = promise.state();
+         * console.log("State: " + state);      // State: pending
+         * doResolve(true);                     // Promise will resolve synchronously as it's a synchronous promise
+         * console.log("State: " + state);      // State: resolved
+         * ```
+         */
+        state?: string;
+        /**
+         * Attaches callbacks for the resolution and/or rejection of the Promise.
+         * @param onResolved The callback to execute when the Promise is resolved.
+         * @param onRejected The callback to execute when the Promise is rejected.
+         * @returns A Promise for the completion of which ever callback is executed.
+         * @example
+         * ```ts
+         * const promise1 = createPromise((resolve, reject) => {
+         *   resolve('Success!');
+         * });
+         *
+         * promise1.then((value) => {
+         *   console.log(value);
+         *   // expected output: "Success!"
+         * });
+         * ```
+         */
+        then<TResult1 = T, TResult2 = never>(onResolved?: ResolvedPromiseHandler<T, TResult1>, onRejected?: RejectedPromiseHandler<TResult2>): IPromise<TResult1 | TResult2>;
+        /**
+         * Attaches callbacks for the resolution and/or rejection of the Promise.
+         * @param onResolved The callback to execute when the Promise is resolved.
+         * @param onRejected The callback to execute when the Promise is rejected.
+         * @returns A Promise for the completion of which ever callback is executed.
+         * @example
+         * ```ts
+         * const promise1 = createPromise((resolve, reject) => {
+         *   resolve('Success!');
+         * });
+         *
+         * promise1.then((value) => {
+         *   console.log(value);
+         *   // expected output: "Success!"
+         * });
+         * ```
+         */
+        then<TResult1 = T, TResult2 = never>(onResolved?: ResolvedPromiseHandler<T, TResult1>, onRejected?: RejectedPromiseHandler<TResult2>): PromiseLike<TResult1 | TResult2>;
+        /**
+         * Attaches callbacks for the resolution and/or rejection of the Promise.
+         * @param onResolved The callback to execute when the Promise is resolved.
+         * @param onRejected The callback to execute when the Promise is rejected.
+         * @returns A Promise for the completion of which ever callback is executed.
+         * @example
+         * ```ts
+         * const promise1 = createPromise((resolve, reject) => {
+         *   resolve('Success!');
+         * });
+         *
+         * promise1.then((value) => {
+         *   console.log(value);
+         *   // expected output: "Success!"
+         * });
+         * ```
+         */
+        then<TResult1 = T, TResult2 = never>(onResolved?: ResolvedPromiseHandler<T, TResult1>, onRejected?: RejectedPromiseHandler<TResult2>): Promise<TResult1 | TResult2>;
+        /**
+         * Attaches a callback for only the rejection of the Promise.
+         * @param onRejected The callback to execute when the Promise is rejected.
+         * @returns A Promise for the completion of the callback.
+         * @example
+         * ```ts
+         * const promise1 = createPromise((resolve, reject) => {
+         *   throw 'Uh-oh!';
+         * });
+         *
+         * promise1.catch((error) => {
+         *   console.error(error);
+         * });
+         * // expected output: Uh-oh!
+         * ```
+         */
+        catch<TResult = never>(onRejected?: ((reason: any) => TResult | IPromise<TResult>) | undefined | null): IPromise<T | TResult>;
+        /**
+         * Attaches a callback for only the rejection of the Promise.
+         * @param onRejected The callback to execute when the Promise is rejected.
+         * @returns A Promise for the completion of the callback.
+         * @example
+         * ```ts
+         * const promise1 = createPromise((resolve, reject) => {
+         *   throw 'Uh-oh!';
+         * });
+         *
+         * promise1.catch((error) => {
+         *   console.error(error);
+         * });
+         * // expected output: Uh-oh!
+         * ```
+         */
+        catch<TResult = never>(onRejected?: ((reason: any) => TResult | IPromise<TResult>) | undefined | null): PromiseLike<T | TResult>;
+        /**
+         * Attaches a callback for only the rejection of the Promise.
+         * @param onRejected The callback to execute when the Promise is rejected.
+         * @returns A Promise for the completion of the callback.
+         * @example
+         * ```ts
+         * const promise1 = createPromise((resolve, reject) => {
+         *   throw 'Uh-oh!';
+         * });
+         *
+         * promise1.catch((error) => {
+         *   console.error(error);
+         * });
+         * // expected output: Uh-oh!
+         * ```
+         */
+        catch<TResult = never>(onRejected?: ((reason: any) => TResult | IPromise<TResult>) | undefined | null): Promise<T | TResult>;
+        /**
+         * Attaches a callback that is invoked when the Promise is settled (fulfilled or rejected). The
+         * resolved value cannot be modified from the callback.
+         * @param onfinally The callback to execute when the Promise is settled (fulfilled or rejected).
+         * @returns A Promise for the completion of the callback.
+         * @example
+         * ```ts
+         * function doFunction() {
+         *   return createPromise((resolve, reject) => {
+         *     if (Math.random() > 0.5) {
+         *       resolve('Function has completed');
+         *     } else {
+         *       reject(new Error('Function failed to process'));
+         *     }
+         *   });
+         * }
+         *
+         * doFunction().then((data) => {
+         *     console.log(data);
+         * }).catch((err) => {
+         *     console.error(err);
+         * }).finally(() => {
+         *     console.log('Function processing completed');
+         * });
+         * ```
+         */
+        finally(onfinally?: FinallyPromiseHandler): IPromise<T>;
+        /**
+         * Attaches a callback that is invoked when the Promise is settled (fulfilled or rejected). The
+         * resolved value cannot be modified from the callback.
+         * @param onfinally The callback to execute when the Promise is settled (fulfilled or rejected).
+         * @returns A Promise for the completion of the callback.
+         * @example
+         * ```ts
+         * function doFunction() {
+         *   return createPromise((resolve, reject) => {
+         *     if (Math.random() > 0.5) {
+         *       resolve('Function has completed');
+         *     } else {
+         *       reject(new Error('Function failed to process'));
+         *     }
+         *   });
+         * }
+         *
+         * doFunction().then((data) => {
+         *     console.log(data);
+         * }).catch((err) => {
+         *     console.error(err);
+         * }).finally(() => {
+         *     console.log('Function processing completed');
+         * });
+         * ```
+         */
+        finally(onFinally?: FinallyPromiseHandler): Promise<T>;
+    }
+
     interface IPropertiesPlugin {
         readonly context: ITelemetryContext;
     }
@@ -1808,7 +3224,14 @@ declare namespace ApplicationInsights {
         isSampledIn(envelope: ITelemetryItem): boolean;
     }
 
-    
+    /**
+     * Checks if HTML5 Beacons are supported in the current environment.
+     * @param useCached - [Optional] used for testing to bypass the cached lookup, when `true` this will
+     * cause the cached global to be reset.
+     * @returns True if supported, false otherwise.
+     */
+    function isBeaconApiSupported(useCached?: boolean): boolean;
+
     function isCrossOriginError(message: string | Event, url: string, lineNumber: number, columnNumber: number, error: Error | Event): boolean;
 
     interface ISerializable {
@@ -1862,7 +3285,13 @@ declare namespace ApplicationInsights {
 
     function isInternalApplicationInsightsEndpoint(endpointUrl: string): boolean;
 
-    
+    /**
+     * Is the parsed traceParent indicating that the trace is currently sampled.
+     * @param value - The parsed traceParent value
+     * @returns
+     */
+    function isSampledFlag(value: ITraceParent): boolean;
+
     interface IStackDetails {
         src: string;
         obj: string[];
@@ -1911,9 +3340,31 @@ declare namespace ApplicationInsights {
         setItem(logger: IDiagnosticLogger, name: string, data: string): boolean;
     }
 
-    
-    
-    
+    /**
+     * Is the provided W3c span id (aka. parent id) a valid string representation, it must be a 16-character
+     * string of lowercase hexadecimal characters, for example, 00f067aa0ba902b7.
+     * If all characters are zero (0000000000000000) this is considered an invalid value.
+     * @param value - The W3c span id to be validated
+     * @returns true if valid otherwise false
+     */
+    function isValidSpanId(value: string): boolean;
+
+    /**
+     * Is the provided W3c Trace Id a valid string representation, it must be a 32-character string
+     * of lowercase hexadecimal characters for example, 4bf92f3577b34da6a3ce929d0e0e4736.
+     * If all characters as zero (00000000000000000000000000000000) it will be considered an invalid value.
+     * @param value - The W3c trace Id to be validated
+     * @returns true if valid otherwise false
+     */
+    function isValidTraceId(value: string): boolean;
+
+    /**
+     * Validates that the provided ITraceParent instance conforms to the currently supported specifications
+     * @param value
+     * @returns
+     */
+    function isValidTraceParent(value: ITraceParent): boolean;
+
     interface ITelemetryContext {
         /**
          * The object describing a component tracked by this object.
@@ -1965,6 +3416,113 @@ declare namespace ApplicationInsights {
         getSessionId: () => string;
     }
 
+    interface ITelemetryInitializerHandler extends ILegacyUnloadHook {
+        remove(): void;
+    }
+
+    /**
+     * Telemety item supported in Core
+     */
+    interface ITelemetryItem {
+        /**
+         * CommonSchema Version of this SDK
+         */
+        ver?: string;
+        /**
+         * Unique name of the telemetry item
+         */
+        name: string;
+        /**
+         * Timestamp when item was sent
+         */
+        time?: string;
+        /**
+         * Identifier of the resource that uniquely identifies which resource data is sent to
+         */
+        iKey?: string;
+        /**
+         * System context properties of the telemetry item, example: ip address, city etc
+         */
+        ext?: {
+            [key: string]: any;
+        };
+        /**
+         * System context property extensions that are not global (not in ctx)
+         */
+        tags?: Tags & Tags[];
+        /**
+         * Custom data
+         */
+        data?: ICustomProperties;
+        /**
+         * Telemetry type used for part B
+         */
+        baseType?: string;
+        /**
+         * Based on schema for part B
+         */
+        baseData?: {
+            [key: string]: any;
+        };
+    }
+
+    /**
+     * Configuration provided to SDK core
+     */
+    interface ITelemetryPlugin extends ITelemetryProcessor, IPlugin {
+        /**
+         * Set next extension for telemetry processing, this is not optional as plugins should use the
+         * processNext() function of the passed IProcessTelemetryContext instead. It is being kept for
+         * now for backward compatibility only.
+         */
+        setNextPlugin?: (next: ITelemetryPlugin | ITelemetryPluginChain) => void;
+        /**
+         * Priority of the extension
+         */
+        readonly priority: number;
+    }
+
+    /**
+     * Configuration provided to SDK core
+     */
+    interface ITelemetryPluginChain extends ITelemetryProcessor {
+        /**
+         * Returns the underlying plugin that is being proxied for the processTelemetry call
+         */
+        getPlugin: () => ITelemetryPlugin;
+        /**
+         * Returns the next plugin
+         */
+        getNext: () => ITelemetryPluginChain;
+        /**
+         * 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 unloadCtx - The unload context to use for this call.
+         * @param unloadState - The details of the unload operation
+         */
+        unload?: (unloadCtx: IProcessTelemetryUnloadContext, unloadState: ITelemetryUnloadState) => void;
+    }
+
+    interface ITelemetryProcessor {
+        /**
+         * 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;
+        /**
+         * The the plugin should re-evaluate configuration and update any cached configuration settings or
+         * plugins. If implemented this method will be called whenever a plugin is added or removed and if
+         * the configuration has bee updated.
+         * @param updateCtx - This is the context that should be used during updating.
+         * @param updateState - The details / state of the update process, it holds details like the current and previous configuration.
+         * @returns boolean - true if the plugin has or will call updateCtx.processNext(), this allows the plugin to perform any asynchronous operations.
+         */
+        update?: (updateCtx: IProcessTelemetryUpdateContext, updateState: ITelemetryUpdateState) => void | boolean;
+    }
+
     interface ITelemetryTrace {
         /**
          * Trace id
@@ -1989,6 +3547,43 @@ declare namespace ApplicationInsights {
         name?: string;
     }
 
+    interface ITelemetryUnloadState {
+        reason: TelemetryUnloadReason;
+        isAsync: boolean;
+        flushComplete?: boolean;
+    }
+
+    interface ITelemetryUpdateState {
+        /**
+         * Identifies the reason for the update notification, this is a bitwise numeric value
+         */
+        reason: TelemetryUpdateReason;
+        /**
+         * This is a new active configuration that should be used
+         */
+        cfg?: IConfiguration;
+        /**
+         * The detected changes
+         */
+        oldCfg?: IConfiguration;
+        /**
+         * If this is a configuration update this was the previous configuration that was used
+         */
+        newConfig?: IConfiguration;
+        /**
+         * Was the new config requested to be merged with the existing config
+         */
+        merge?: boolean;
+        /**
+         * This holds a collection of plugins that have been added (if the reason identifies that one or more plugins have been added)
+         */
+        added?: IPlugin[];
+        /**
+         * This holds a collection of plugins that have been removed (if the reason identifies that one or more plugins have been removed)
+         */
+        removed?: IPlugin[];
+    }
+
     /**
      * Identifies frequency of items sent
      * Default: send data on 28th every 3 month each year
@@ -2084,7 +3679,153 @@ declare namespace ApplicationInsights {
         throttleNum: number;
     }
 
-    
+    /**
+     * A Timer handler which is returned from {@link scheduleTimeout} which contains functions to
+     * cancel or restart (refresh) the timeout function.
+     *
+     * @since 0.4.4
+     * @group Timer
+     */
+    interface ITimerHandler {
+        /**
+         * Cancels a timeout that was previously scheduled, after calling this function any previously
+         * scheduled timer will not execute.
+         * @example
+         * ```ts
+         * let theTimer = scheduleTimeout(...);
+         * theTimer.cancel();
+         * ```
+         */
+        cancel(): void;
+        /**
+         * Reschedules the timer to call its callback at the previously specified duration
+         * adjusted to the current time. This is useful for refreshing a timer without allocating
+         * a new JavaScript object.
+         *
+         * Using this on a timer that has already called its callback will reactivate the timer.
+         * Calling on a timer that has not yet executed will just reschedule the current timer.
+         * @example
+         * ```ts
+         * let theTimer = scheduleTimeout(...);
+         * // The timer will be restarted (if already executed) or rescheduled (if it has not yet executed)
+         * theTimer.refresh();
+         * ```
+         */
+        refresh(): ITimerHandler;
+        /**
+         * When called, requests that the event loop not exit so long when the ITimerHandler is active.
+         * Calling timer.ref() multiple times will have no effect. By default, all ITimerHandler objects
+         * will create "ref'ed" instances, making it normally unnecessary to call timer.ref() unless
+         * timer.unref() had been called previously.
+         * @since 0.7.0
+         * @returns the ITimerHandler instance
+         * @example
+         * ```ts
+         * let theTimer = createTimeout(...);
+         *
+         * // Make sure the timer is referenced (the default) so that the runtime (Node) does not terminate
+         * // if there is a waiting referenced timer.
+         * theTimer.ref();
+         * ```
+         */
+        ref(): this;
+        /**
+         * When called, the any active ITimerHandler instance will not require the event loop to remain
+         * active (Node.js). If there is no other activity keeping the event loop running, the process may
+         * exit before the ITimerHandler instance callback is invoked. Calling timer.unref() multiple times
+         * will have no effect.
+         * @since 0.7.0
+         * @returns the ITimerHandler instance
+         * @example
+         * ```ts
+         * let theTimer = createTimeout(...);
+         *
+         * // Unreference the timer so that the runtime (Node) may terminate if nothing else is running.
+         * theTimer.unref();
+         * ```
+         */
+        unref(): this;
+        /**
+         * If true, any running referenced `ITimerHandler` instance will keep the Node.js event loop active.
+         * @since 0.7.0
+         * @example
+         * ```ts
+         * let theTimer = createTimeout(...);
+         *
+         * // Unreference the timer so that the runtime (Node) may terminate if nothing else is running.
+         * theTimer.unref();
+         * let hasRef = theTimer.hasRef(); // false
+         *
+         * theTimer.ref();
+         * hasRef = theTimer.hasRef(); // true
+         * ```
+         */
+        hasRef(): boolean;
+        /**
+         * Gets or Sets a flag indicating if the underlying timer is currently enabled and running.
+         * Setting the enabled flag to the same as it's current value has no effect, setting to `true`
+         * when already `true` will not {@link ITimerHandler.refresh | refresh}() the timer.
+         * And setting to 'false` will {@link ITimerHandler.cancel | cancel}() the timer.
+         * @since 0.8.1
+         * @example
+         * ```ts
+         * let theTimer = createTimeout(...);
+         *
+         * // Check if enabled
+         * theTimer.enabled; // false
+         *
+         * // Start the timer
+         * theTimer.enabled = true;     // Same as calling refresh()
+         * theTimer.enabled; //true
+         *
+         * // Has no effect as it's already running
+         * theTimer.enabled = true;
+         *
+         * // Will refresh / restart the time
+         * theTimer.refresh()
+         *
+         * let theTimer = scheduleTimeout(...);
+         *
+         * // Check if enabled
+         * theTimer.enabled; // true
+         * ```
+         */
+        enabled: boolean;
+    }
+
+    /**
+     * This interface represents the components of a W3C traceparent header
+     */
+    interface ITraceParent {
+        /**
+         * The version of the definition, this MUST be a string with a length of 2 and only contain lowercase
+         * hexadecimal characters. A value of 'ff' is considered to be an invalid version.
+         */
+        version: string;
+        /**
+         * This is the ID of the whole trace forest and is used to uniquely identify a distributed trace
+         * through a system. It is represented as a 32-character string of lowercase hexadecimal characters,
+         * for example, 4bf92f3577b34da6a3ce929d0e0e4736.
+         * All characters as zero (00000000000000000000000000000000) is considered an invalid value.
+         */
+        traceId: string;
+        /**
+         * This is the ID of the current request as known by the caller (in some tracing systems, this is also
+         * known as the parent-id, where a span is the execution of a client request). It is represented as an
+         * 16-character string of lowercase hexadecimal characters, for example, 00f067aa0ba902b7.
+         * All bytes as zero (0000000000000000) is considered an invalid value.
+         */
+        spanId: string;
+        /**
+         * An 8-bit value of flags that controls tracing such as sampling, trace level, etc. These flags are
+         * recommendations given by the caller rather than strict rules to follow.
+         * As this is a bit field, you cannot interpret flags by decoding the hex value and looking at the resulting
+         * number. For example, a flag 00000001 could be encoded as 01 in hex, or 09 in hex if present with the flag
+         * 00001000. A common mistake in bit fields is forgetting to mask when interpreting flags.
+         */
+        traceFlags: number;
+    }
+
     interface ITraceState {
     }
 
@@ -2109,6 +3850,16 @@ declare namespace ApplicationInsights {
         iKey?: string;
     }
 
+    /**
+     * An interface which provides automatic removal during unloading of the component
+     */
+    interface IUnloadHook {
+        /**
+         * Self remove the referenced component
+         */
+        rm: () => void;
+    }
+
     interface IUser {
         /**
          * The telemetry configuration.
@@ -2150,6 +3901,40 @@ declare namespace ApplicationInsights {
         update(userId?: string): void;
     }
 
+    interface IWatchDetails<T = IConfiguration> {
+        /**
+         * The current config object
+         */
+        cfg: T;
+        /**
+         * Set the value against the provided config/name with the value, the property
+         * will be converted to be dynamic (if not already) as long as the provided config
+         * is already a tracked dynamic object.
+         * @throws TypeError if the provided config is not a monitored dynamic config
+         */
+        set: <C, V>(theConfig: C, name: string, value: V) => V;
+        /**
+         * Set default values for the config if not present.
+         * @param theConfig - The configuration object to set default on (if missing)
+         * @param defaultValues - The default values to apply to the config
+         */
+        setDf: <C>(theConfig: C, defaultValues: IConfigDefaults<C>) => C;
+        /**
+         * Set this named property of the target as referenced, which will cause any object or array instance
+         * to be updated in-place rather than being entirely replaced. All other values will continue to be replaced.
+         * @returns The referenced properties current value
+         */
+        ref: <C, V = any>(target: C, name: string) => V;
+        /**
+         * Set this named property of the target as read-only, which will block this single named property from
+         * ever being changed for the target instance.
+         * This does NOT freeze or seal the instance, it just stops the direct re-assignment of the named property,
+         * if the value is a non-primitive (ie. an object or array) it's properties will still be mutable.
+         * @returns The referenced properties current value
+         */
+        rdOnly: <C, V = any>(target: C, name: string) => V;
+    }
+
     interface IWeb {
         /**
          * Browser name, set at ingestion
@@ -2181,6 +3966,10 @@ declare namespace ApplicationInsights {
         domain: string;
     }
 
+    const LoggingSeverity: EnumValue<typeof eLoggingSeverity>;
+
+    type LoggingSeverity = number | eLoggingSeverity;
+
     class Metric implements IMetricData, ISerializable {
         static envelopeType: string;
         static dataType: string;
@@ -2344,11 +4133,26 @@ declare namespace ApplicationInsights {
 
     function parseConnectionString(connectionString?: string): ConnectionString;
 
-    
+    /**
+     * Attempt to parse the provided string as a W3C TraceParent header value (https://www.w3.org/TR/trace-context/#traceparent-header)
+     *
+     * @param value - The value to be parsed
+     * @param selectIdx - If the found value is comma separated which is the preferred entry to select, defaults to the first
+     * @returns
+     */
+    function parseTraceParent(value: string, selectIdx?: number): ITraceParent;
+
     const ProcessLegacy = "ProcessLegacy";
 
     const PropertiesPluginIdentifier = "AppInsightsPropertiesPlugin";
 
+    /**
+     * This defines the handler function for when a promise is rejected.
+     * @param value This is the value passed as part of resolving the Promise
+     * @return This may return a value, another Promise or void. @see {@link IPromise.then} for how the value is handled.
+     */
+    type RejectedPromiseHandler<T = never> = (((reason: any) => T | IPromise<T> | PromiseLike<T>) | undefined | null);
+
     class RemoteDependencyData implements IRemoteDependencyData, ISerializable {
         static envelopeType: string;
         static dataType: string;
@@ -2446,8 +4250,61 @@ declare namespace ApplicationInsights {
         8: "request-context";
     };
 
+    /**
+     * This defines the handler function for when a promise is resolved.
+     * @param value This is the value passed as part of resolving the Promise
+     * @return This may return a value, another Promise or void. @see {@link IPromise.then} for how the value is handled.
+     */
+    type ResolvedPromiseHandler<T, TResult1 = T> = (((value: T) => TResult1 | IPromise<TResult1> | PromiseLike<TResult1>) | undefined | null);
+
     const SampleRate = "sampleRate";
 
+    /**
+     * The EventsDiscardedReason enumeration contains a set of values that specify the reason for discarding an event.
+     */
+    const enum SendRequestReason {
+        /**
+         * No specific reason was specified
+         */
+        Undefined = 0,
+        /**
+         * Events are being sent based on the normal event schedule / timer.
+         */
+        NormalSchedule = 1,
+        /**
+         * A manual flush request was received
+         */
+        ManualFlush = 1,
+        /**
+         * Unload event is being processed
+         */
+        Unload = 2,
+        /**
+         * The event(s) being sent are sync events
+         */
+        SyncEvent = 3,
+        /**
+         * The Channel was resumed
+         */
+        Resumed = 4,
+        /**
+         * The event(s) being sent as a retry
+         */
+        Retry = 5,
+        /**
+         * The SDK is unloading
+         */
+        SdkUnload = 6,
+        /**
+         * Maximum batch size would be exceeded
+         */
+        MaxBatchSize = 10,
+        /**
+         * The Maximum number of events have already been queued
+         */
+        MaxQueuedEvents = 20
+    }
+
     /**
      * Defines the level of severity for the event.
      */
@@ -2459,6 +4316,12 @@ declare namespace ApplicationInsights {
 
     const strNotSpecified = "not_specified";
 
+    interface Tags {
+        [key: string]: any;
+    }
+
+    type TelemetryInitializerFunction = <T extends ITelemetryItem>(item: T) => boolean | void;
+
     class TelemetryItemCreator {
         /**
          * Create a telemetry item that the 1DS channel understands
@@ -2472,6 +4335,50 @@ declare namespace ApplicationInsights {
         static create: typeof createTelemetryItem;
     }
 
+    /**
+     * The TelemetryUnloadReason enumeration contains the possible reasons for why a plugin is being unloaded / torndown().
+     */
+    const enum TelemetryUnloadReason {
+        /**
+         * Teardown has been called without any context.
+         */
+        ManualTeardown = 0,
+        /**
+         * Just this plugin is being removed
+         */
+        PluginUnload = 1,
+        /**
+         * This instance of the plugin is being removed and replaced
+         */
+        PluginReplace = 2,
+        /**
+         * The entire SDK is being unloaded
+         */
+        SdkUnload = 50
+    }
+
+    /**
+     * The TelemetryUpdateReason enumeration contains a set of bit-wise values that specify the reason for update request.
+     */
+    const enum TelemetryUpdateReason {
+        /**
+         * Unknown.
+         */
+        Unknown = 0,
+        /**
+         * The configuration has ben updated or changed
+         */
+        ConfigurationChanged = 1,
+        /**
+         * One or more plugins have been added
+         */
+        PluginAdded = 16,
+        /**
+         * One or more plugins have been removed
+         */
+        PluginRemoved = 32
+    }
+
     class ThrottleMgr {
         canThrottle: (msgId: _eInternalMessageId | number) => boolean;
         sendMessage: (msgId: _eInternalMessageId, message: string, severity?: eLoggingSeverity) => IThrottleResult | null;
@@ -2522,6 +4429,8 @@ declare namespace ApplicationInsights {
         });
     }
 
+    type UnloadHandler = (itemCtx: IProcessTelemetryUnloadContext, unloadState: ITelemetryUnloadState) => void;
+
     function urlGetAbsoluteUrl(url: string): string;
 
     function urlGetCompleteUrl(method: string, absoluteUrl: string): string;
@@ -2569,5 +4478,6 @@ declare namespace ApplicationInsights {
 
     function utlSetStoragePrefix(storagePrefix: string): void;
 
-    
+    type WatcherFunction<T = IConfiguration> = (details: IWatchDetails<T>) => void;
+
 }