@microsoft/applicationinsights-core-js 2.7.5-nightly.2204-03 → 2.7.6

package/types/JavaScriptSDK.Enums/LoggingEnums.d.ts

@@ -1,4 +1,4 @@
-export declare const enum eLoggingSeverity {
+export declare enum LoggingSeverity {
     /**
      * Error will be sent as internal telemetry
      */
@@ -8,95 +8,6 @@ export declare const enum eLoggingSeverity {
      */
     WARNING = 2
 }
-export declare const LoggingSeverity: {
-    CRITICAL: number;
-    WARNING: number;
-};
-export declare type LoggingSeverity = number | eLoggingSeverity;
-export declare 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,
-    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
-}
 /**
  * Internal message ID. Please create a new one for every conceptually different message. Please keep alphabetically ordered
  */
@@ -184,4 +95,4 @@ export declare const _InternalMessageId: {
     FailedAddingCustomDefinedRequestContext: number;
     InMemoryStorageBufferFull: number;
 };
-export declare type _InternalMessageId = number | _eInternalMessageId;
+export declare type _InternalMessageId = number | typeof _InternalMessageId;

package/types/JavaScriptSDK.Enums/SendRequestReason.d.ts

@@ -30,10 +30,6 @@ export declare const enum SendRequestReason {
      * The event(s) being sent as a retry
      */
     Retry = 5,
-    /**
-     * The SDK is unloading
-     */
-    SdkUnload = 6,
     /**
      * Maximum batch size would be exceeded
      */

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

@@ -1,6 +1,6 @@
 import { ITelemetryItem } from "./ITelemetryItem";
 import { IChannelControls } from "./IChannelControls";
-import { IPlugin, ITelemetryPlugin } from "./ITelemetryPlugin";
+import { IPlugin } from "./ITelemetryPlugin";
 import { IConfiguration } from "./IConfiguration";
 import { INotificationManager } from "./INotificationManager";
 import { INotificationListener } from "./INotificationListener";
@@ -8,27 +8,6 @@ import { IDiagnosticLogger } from "./IDiagnosticLogger";
 import { IProcessTelemetryContext } from "./IProcessTelemetryContext";
 import { IPerfManagerProvider } from "./IPerfManager";
 import { ICookieMgr } from "./ICookieMgr";
-import { ITelemetryInitializerHandler, TelemetryInitializerFunction } from "./ITelemetryInitializers";
-import { ITelemetryUnloadState } from "./ITelemetryUnloadState";
-import { UnloadHandler } from "../JavaScriptSDK/UnloadHandlerContainer";
-import { SendRequestReason } from "../JavaScriptSDK.Enums/SendRequestReason";
-export 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;
-}
 export interface IAppInsightsCore extends IPerfManagerProvider {
     config: IConfiguration;
     logger: IDiagnosticLogger;
@@ -64,60 +43,10 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
      * @param {INotificationListener} listener - INotificationListener to remove.
      */
     removeNotificationListener?(listener: INotificationListener): void;
-    /**
-     * Add a telemetry processor to decorate or drop telemetry events.
-     * @param telemetryInitializer - The Telemetry Initializer function
-     * @returns - A ITelemetryInitializerHandler to enable the initializer to be removed
-     */
-    addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
     pollInternalLogs?(eventName?: string): number;
     stopPollingInternalLogs?(): void;
     /**
      * Return a new instance of the IProcessTelemetryContext for processing events
      */
     getProcessTelContext(): IProcessTelemetryContext;
-    /**
-     * 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.
-     * @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.
-     */
-    unload(isAsync?: boolean, unloadComplete?: (unloadState: ITelemetryUnloadState) => void, cbTimeout?: number): void;
-    /**
-     * 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;
-    /**
-     * 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;
-    /**
-     * 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;
 }

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

@@ -1,7 +1,4 @@
-import { SendRequestReason } from "../JavaScriptSDK.Enums/SendRequestReason";
-import { IProcessTelemetryUnloadContext } from "./IProcessTelemetryContext";
 import { ITelemetryPlugin } from "./ITelemetryPlugin";
-import { ITelemetryUnloadState } from "./ITelemetryUnloadState";
 /**
  * Provides data transmission capabilities
  */
@@ -15,22 +12,14 @@ export interface IChannelControls extends ITelemetryPlugin {
      */
     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.
+     * Tear down transmission pipeline
      */
-    teardown: (unloadCtx?: IProcessTelemetryUnloadContext, unloadState?: ITelemetryUnloadState) => void | boolean;
+    teardown(): void;
     /**
      * Flush to send data immediately; channel should default to sending data asynchronously
-     * @param async - send data asynchronously when true
-     * @param callBack - if specified, notify caller when send is complete, the channel should return true to indicate to the caller that it will be called.
-     * If the caller doesn't return true the caller should assume that it may never be called.
-     * @param sendReason - specify the reason that you are calling "flush" defaults to ManualFlush (1) if not specified
-     * @returns - true if the callback will be return after the flush is complete otherwise the caller should assume that any provided callback will never be called
+     * @param async: send data asynchronously when true
+     * @param callBack: if specified, notify caller when send is complete
      */
-    flush(async: boolean, callBack?: (flushComplete?: boolean) => void, sendReason?: SendRequestReason): boolean | void;
+    flush(async: boolean, callBack?: () => void): void;
 }
 export declare const MinChannelPriorty: number;

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

@@ -8,11 +8,6 @@ export declare type InstrumentorHooksCallback = (funcArgs: IInstrumentCallDetail
  * You must always supply the error callback
  */
 export interface IInstrumentHooksCallbacks {
-    /**
-     * [Optional] Namespace details (same as the namespace used for events), useful for debugging and testing to
-     * identify the source of the instrumented hooks
-     */
-    ns?: string | string[];
     /**
      * The hook callback to call before the original function is called
      */
@@ -73,8 +68,4 @@ export interface IInstrumentCallDetails {
      * The error (exception) which occurred while executing the original method
      */
     err?: Error;
-    /**
-     * The Event object from (window.event) at the start of the original call
-     */
-    evt?: Event;
 }

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

@@ -1,17 +1,14 @@
 import { IAppInsightsCore } from "./IAppInsightsCore";
-import { IConfiguration } from "./IConfiguration";
 import { IDiagnosticLogger } from "./IDiagnosticLogger";
+import { IConfiguration } from "./IConfiguration";
 import { ITelemetryItem } from "./ITelemetryItem";
-import { IPlugin, ITelemetryPlugin } from "./ITelemetryPlugin";
+import { IPlugin } from "./ITelemetryPlugin";
 import { ITelemetryPluginChain } from "./ITelemetryPluginChain";
-import { ITelemetryUnloadState } from "./ITelemetryUnloadState";
-import { ITelemetryUpdateState } from "./ITelemetryUpdateState";
-export declare const enum GetExtCfgMergeType {
-    None = 0,
-    MergeDefaultOnly = 1,
-    MergeDefaultFromRootOrDefault = 2
-}
-export interface IBaseProcessingContext {
+/**
+ * The current context for the current call to processTelemetry(), used to support sharing the same plugin instance
+ * between multiple AppInsights instances
+ */
+export interface IProcessTelemetryContext {
     /**
      * The current core instance for the request
      */
@@ -27,7 +24,7 @@ export interface IBaseProcessingContext {
     /**
      * Gets the named extension config
      */
-    getExtCfg: <T>(identifier: string, defaultValue?: T | any, mergeDefault?: GetExtCfgMergeType) => T;
+    getExtCfg: <T>(identifier: string, defaultValue?: T | any) => T;
     /**
      * Gets the named config from either the named identifier extension or core config if neither exist then the
      * default value is returned
@@ -35,7 +32,7 @@ export interface IBaseProcessingContext {
      * @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;
+    getConfig: (identifier: string, field: string, defaultValue?: number | string | boolean) => number | string | boolean;
     /**
      * Helper to allow plugins to check and possibly shortcut executing code only
      * required if there is a nextPlugin
@@ -49,41 +46,13 @@ export interface IBaseProcessingContext {
      * 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;
-}
-/**
- * The current context for the current call to processTelemetry(), used to support sharing the same plugin instance
- * between multiple AppInsights instances
- */
-export 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;
+    processNext: (env: ITelemetryItem) => void;
     /**
-     * Create a new context using the core and config from the current instance, returns a new instance of the same type
+     * Create a new context using the core and config from the current instance
      * @param plugins - The execution order to process the plugins, if null or not supplied
      *                  then the current execution order will be copied.
      * @param startAt - The plugin to start processing from, if missing from the execution
@@ -91,43 +60,3 @@ export interface IProcessTelemetryContext extends IBaseProcessingContext {
      */
     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.
- */
-export 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.
- */
-export 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;
-}

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

@@ -1,11 +1,12 @@
 import { ITelemetryItem } from "./ITelemetryItem";
 import { IConfiguration } from "./IConfiguration";
 import { IAppInsightsCore } from "./IAppInsightsCore";
-import { IProcessTelemetryContext, IProcessTelemetryUnloadContext, IProcessTelemetryUpdateContext } from "./IProcessTelemetryContext";
+import { IProcessTelemetryContext } from "./IProcessTelemetryContext";
 import { ITelemetryPluginChain } from "./ITelemetryPluginChain";
-import { ITelemetryUnloadState } from "./ITelemetryUnloadState";
-import { ITelemetryUpdateState } from "./ITelemetryUpdateState";
-export interface ITelemetryProcessor {
+/**
+ * Configuration provided to SDK core
+ */
+export interface ITelemetryPlugin extends IPlugin {
     /**
      * Call back for telemetry processing before it it is sent
      * @param env - This is the current event being reported
@@ -14,20 +15,6 @@ export interface ITelemetryProcessor {
      * 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;
-}
-/**
- * Configuration provided to SDK core
- */
-export 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
@@ -55,14 +42,10 @@ export interface IPlugin {
      */
     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.
+     * Tear down the plugin and remove any hooked value, the plugin should remove that it is no longer initialized and
+     * therefore can be re-initialized after being torn down.
      */
-    teardown?: (unloadCtx: IProcessTelemetryUnloadContext, unloadState?: ITelemetryUnloadState) => void | boolean;
+    teardown?: () => void;
     /**
      * Extension name
      */

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

@@ -1,10 +1,10 @@
-import { IProcessTelemetryUnloadContext } from "./IProcessTelemetryContext";
-import { ITelemetryPlugin, ITelemetryProcessor } from "./ITelemetryPlugin";
-import { ITelemetryUnloadState } from "./ITelemetryUnloadState";
+import { ITelemetryItem } from "./ITelemetryItem";
+import { IProcessTelemetryContext } from "./IProcessTelemetryContext";
+import { ITelemetryPlugin } from "./ITelemetryPlugin";
 /**
  * Configuration provided to SDK core
  */
-export interface ITelemetryPluginChain extends ITelemetryProcessor {
+export interface ITelemetryPluginChain {
     /**
      * Returns the underlying plugin that is being proxied for the processTelemetry call
      */
@@ -14,10 +14,11 @@ export interface ITelemetryPluginChain extends ITelemetryProcessor {
      */
     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
+     * 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)
      */
-    unload?: (unloadCtx: IProcessTelemetryUnloadContext, unloadState: ITelemetryUnloadState) => void;
+    processTelemetry: (env: ITelemetryItem, itemCtx: IProcessTelemetryContext) => void;
 }

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

@@ -1,25 +1,21 @@
 export { IConfiguration } from "./JavaScriptSDK.Interfaces/IConfiguration";
 export { IChannelControls, MinChannelPriorty } from "./JavaScriptSDK.Interfaces/IChannelControls";
 export { ITelemetryPlugin, IPlugin } from "./JavaScriptSDK.Interfaces/ITelemetryPlugin";
-export { IAppInsightsCore, ILoadedPlugin } from "./JavaScriptSDK.Interfaces/IAppInsightsCore";
+export { IAppInsightsCore } from "./JavaScriptSDK.Interfaces/IAppInsightsCore";
 export { ITelemetryItem, ICustomProperties, Tags } from "./JavaScriptSDK.Interfaces/ITelemetryItem";
-export { IBaseProcessingContext, IProcessTelemetryContext, IProcessTelemetryUnloadContext, IProcessTelemetryUpdateContext, GetExtCfgMergeType } from "./JavaScriptSDK.Interfaces/IProcessTelemetryContext";
+export { IProcessTelemetryContext } from "./JavaScriptSDK.Interfaces/IProcessTelemetryContext";
 export { INotificationListener } from "./JavaScriptSDK.Interfaces/INotificationListener";
 export { ITelemetryPluginChain } from "./JavaScriptSDK.Interfaces/ITelemetryPluginChain";
 export { IDiagnosticLogger } from "./JavaScriptSDK.Interfaces/IDiagnosticLogger";
 export { InstrumentorHooksCallback, IInstrumentHooksCallbacks, IInstrumentHooks, IInstrumentHook, IInstrumentCallDetails } from "./JavaScriptSDK.Interfaces/IInstrumentHooks";
-export { IUnloadableComponent } from "./JavaScriptSDK.Interfaces/IUnloadableComponent";
 export { EventsDiscardedReason } from "./JavaScriptSDK.Enums/EventsDiscardedReason";
 export { SendRequestReason } from "./JavaScriptSDK.Enums/SendRequestReason";
-export { TelemetryUpdateReason } from "./JavaScriptSDK.Enums/TelemetryUpdateReason";
-export { TelemetryUnloadReason } from "./JavaScriptSDK.Enums/TelemetryUnloadReason";
 export { AppInsightsCore } from "./JavaScriptSDK/AppInsightsCore";
 export { BaseCore } from "./JavaScriptSDK/BaseCore";
 export { BaseTelemetryPlugin } from "./JavaScriptSDK/BaseTelemetryPlugin";
-export { randomValue, random32, mwcRandomSeed, mwcRandom32, newId } from "./JavaScriptSDK/RandomHelper";
-export { CoreUtils, ICoreUtils, EventHelper, IEventHelper, Undefined, newGuid, perfNow, generateW3CId, disableCookies, canUseCookies, getCookie, setCookie, deleteCookie, _legacyCookieMgr } from "./JavaScriptSDK/CoreUtils";
-export { isTypeof, isUndefined, isNullOrUndefined, hasOwnProperty, isObject, isFunction, normalizeJsName, objForEachKey, strEndsWith, strStartsWith, isDate, isArray, isError, isString, isNumber, isBoolean, toISOString, arrForEach, arrIndexOf, arrMap, arrReduce, strTrim, objKeys, objDefineAccessors, dateNow, getExceptionName, throwError, strContains, isSymbol, setValue, getSetValue, isNotTruthy, isTruthy, proxyAssign, proxyFunctions, proxyFunctionAs, createClassFromInterface, optimizeObject, isNotUndefined, isNotNullOrUndefined, objFreeze, objSeal, createEnumStyle, objExtend, objToString } from "./JavaScriptSDK/HelperFuncs";
-export { attachEvent, detachEvent, addEventHandler, addEventListeners, addPageUnloadEventListener, addPageHideEventListener, addPageShowEventListener, removeEventHandler, removeEventListeners, removePageUnloadEventListener, removePageHideEventListener, removePageShowEventListener, eventOn, eventOff, mergeEvtNamespace, _IRegisteredEvents, __getRegisteredEvents } from "./JavaScriptSDK/EventHelpers";
+export { randomValue, random32, mwcRandomSeed, mwcRandom32 } from "./JavaScriptSDK/RandomHelper";
+export { CoreUtils, ICoreUtils, EventHelper, IEventHelper, Undefined, addEventHandler, newGuid, perfNow, newId, generateW3CId, disableCookies, canUseCookies, getCookie, setCookie, deleteCookie, _legacyCookieMgr, addEventListeners, addPageUnloadEventListener, addPageHideEventListener, addPageShowEventListener } from "./JavaScriptSDK/CoreUtils";
+export { isTypeof, isUndefined, isNullOrUndefined, hasOwnProperty, isObject, isFunction, attachEvent, detachEvent, normalizeJsName, objForEachKey, strEndsWith, strStartsWith, isDate, isArray, isError, isString, isNumber, isBoolean, toISOString, arrForEach, arrIndexOf, arrMap, arrReduce, strTrim, objKeys, objDefineAccessors, dateNow, getExceptionName, throwError, strContains, isSymbol, setValue, getSetValue, isNotTruthy, isTruthy, proxyAssign, createClassFromInterface, optimizeObject, isNotUndefined, isNotNullOrUndefined, objFreeze, objSeal } from "./JavaScriptSDK/HelperFuncs";
 export { getGlobalInst, hasWindow, getWindow, hasDocument, getDocument, getCrypto, getMsCrypto, hasNavigator, getNavigator, hasHistory, getHistory, getLocation, getPerformance, hasJSON, getJSON, isReactNative, getConsole, dumpObj, isIE, getIEVersion, isSafari, setEnableEnvMocks, isBeaconsSupported, isFetchSupported, useXDomainRequest, isXhrSupported } from "./JavaScriptSDK/EnvUtils";
 export { getGlobal, objCreateFn as objCreate, strShimPrototype as strPrototype, strShimFunction as strFunction, strShimUndefined as strUndefined, strShimObject as strObject } from "@microsoft/applicationinsights-shims";
 export { NotificationManager } from "./JavaScriptSDK/NotificationManager";
@@ -27,18 +23,13 @@ export { INotificationManager } from "./JavaScriptSDK.Interfaces/INotificationMa
 export { IPerfEvent } from "./JavaScriptSDK.Interfaces/IPerfEvent";
 export { IPerfManager, IPerfManagerProvider } from "./JavaScriptSDK.Interfaces/IPerfManager";
 export { PerfEvent, PerfManager, doPerf, getGblPerfMgr, setGblPerfMgr } from "./JavaScriptSDK/PerfManager";
-export { safeGetLogger, DiagnosticLogger, _InternalLogMessage, _throwInternal } from "./JavaScriptSDK/DiagnosticLogger";
-export { ProcessTelemetryContext, createProcessTelemetryContext } from "./JavaScriptSDK/ProcessTelemetryContext";
-export { initializePlugins, sortPlugins, unloadComponents } from "./JavaScriptSDK/TelemetryHelpers";
-export { _InternalMessageId, _eInternalMessageId, LoggingSeverity, eLoggingSeverity } from "./JavaScriptSDK.Enums/LoggingEnums";
+export { safeGetLogger, DiagnosticLogger, _InternalLogMessage } from "./JavaScriptSDK/DiagnosticLogger";
+export { ProcessTelemetryContext } from "./JavaScriptSDK/ProcessTelemetryContext";
+export { initializePlugins, sortPlugins } from "./JavaScriptSDK/TelemetryHelpers";
+export { _InternalMessageId, LoggingSeverity } from "./JavaScriptSDK.Enums/LoggingEnums";
 export { InstrumentProto, InstrumentProtos, InstrumentFunc, InstrumentFuncs } from "./JavaScriptSDK/InstrumentHooks";
 export { ICookieMgr, ICookieMgrConfig } from "./JavaScriptSDK.Interfaces/ICookieMgr";
 export { createCookieMgr, safeGetCookieMgr, uaDisallowsSameSiteNone, areCookiesSupported } from "./JavaScriptSDK/CookieMgr";
 export { strIKey, strExtensionConfig } from "./JavaScriptSDK/Constants";
 export { IDbgExtension } from "./JavaScriptSDK.Interfaces/IDbgExtension";
 export { getDebugListener, getDebugExt } from "./JavaScriptSDK/DbgExtensionUtils";
-export { TelemetryInitializerFunction, ITelemetryInitializerHandler, ITelemetryInitializerContainer } from "./JavaScriptSDK.Interfaces/ITelemetryInitializers";
-export { createUniqueNamespace } from "./JavaScriptSDK/DataCacheHelper";
-export { UnloadHandler, IUnloadHandlerContainer, createUnloadHandlerContainer } from "./JavaScriptSDK/UnloadHandlerContainer";
-export { ITelemetryUpdateState } from "./JavaScriptSDK.Interfaces/ITelemetryUpdateState";
-export { ITelemetryUnloadState } from "./JavaScriptSDK.Interfaces/ITelemetryUnloadState";

package/types/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.19.5"
+      "packageVersion": "7.23.0"
     }
   ]
 }