@microsoft/applicationinsights-web 2.8.0-beta.2202-07 → 2.8.0-beta.2203-03

package/dist/applicationinsights-web.api.md

@@ -157,15 +157,20 @@ export class ApplicationInsightsContainer {
 export class BaseCore implements IAppInsightsCore {
     constructor();
     addNotificationListener(listener: INotificationListener): void;
+    // (undocumented)
+    addPlugin<T extends IPlugin = ITelemetryPlugin>(plugin: T, replaceExisting: boolean, doAsync: boolean, addCb?: (added?: boolean) => void): void;
     // Warning: (ae-forgotten-export) The symbol "TelemetryInitializerFunction" needs to be exported by the entry point applicationinsights-web.d.ts
     // Warning: (ae-forgotten-export) The symbol "ITelemetryInitializerHandler" needs to be exported by the entry point applicationinsights-web.d.ts
     addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
+    // Warning: (ae-forgotten-export) The symbol "UnloadHandler" needs to be exported by the entry point applicationinsights-web.d.ts
+    addUnloadCb(handler: UnloadHandler): void;
     // (undocumented)
     config: IConfiguration;
     // (undocumented)
     static defaultConfig: IConfiguration;
     // (undocumented)
     eventCnt(): number;
+    evtNamespace(): string;
     // (undocumented)
     _extensions: IPlugin[];
     getCookieMgr(): ICookieMgr;
@@ -199,6 +204,7 @@ export class BaseCore implements IAppInsightsCore {
     stopPollingInternalLogs(): void;
     // (undocumented)
     track(telemetryItem: ITelemetryItem): void;
+    unload(isAsync?: boolean, unloadComplete?: () => void): void;
 }
 
 // @public
@@ -206,8 +212,12 @@ export abstract class BaseTelemetryPlugin implements ITelemetryPlugin {
     constructor();
     // Warning: (ae-forgotten-export) The symbol "IInstrumentHook" needs to be exported by the entry point applicationinsights-web.d.ts
     protected _addHook(hooks: IInstrumentHook | IInstrumentHook[]): void;
+    protected _addUnloadCb(handler: UnloadHandler): void;
     core: IAppInsightsCore;
     diagLog: (itemCtx?: IProcessTelemetryContext) => IDiagnosticLogger;
+    // Warning: (ae-forgotten-export) The symbol "IProcessTelemetryUnloadContext" needs to be exported by the entry point applicationinsights-web.d.ts
+    // Warning: (ae-forgotten-export) The symbol "ITelemetryUnloadState" needs to be exported by the entry point applicationinsights-web.d.ts
+    protected _doTeardown?: (unloadCtx?: IProcessTelemetryUnloadContext, unloadState?: ITelemetryUnloadState, asyncCallback?: () => void) => void | boolean;
     protected _getTelCtx: (currentCtx?: IProcessTelemetryContext) => IProcessTelemetryContext;
     // (undocumented)
     identifier: string;
@@ -221,6 +231,7 @@ export abstract class BaseTelemetryPlugin implements ITelemetryPlugin {
     abstract processTelemetry(env: ITelemetryItem, itemCtx?: IProcessTelemetryContext): void;
     protected setInitialized: (isInitialized: boolean) => void;
     setNextPlugin: (next: ITelemetryPlugin | ITelemetryPluginChain) => void;
+    teardown(unloadCtx?: IProcessTelemetryUnloadContext, unloadState?: ITelemetryUnloadState): void | boolean;
     // (undocumented)
     version?: string;
 }
@@ -254,8 +265,6 @@ export class DependenciesPlugin extends BaseTelemetryPlugin implements IDependen
     priority: number;
     // (undocumented)
     processTelemetry(item: ITelemetryItem, itemCtx?: IProcessTelemetryContext): void;
-    // (undocumented)
-    teardown(): void;
     trackDependencyData(dependency: IDependencyTelemetry, properties?: {
         [key: string]: any;
     }): void;
@@ -267,11 +276,16 @@ export class DependenciesPlugin extends BaseTelemetryPlugin implements IDependen
 }
 
 // @public (undocumented)
-export enum DistributedTracingModes {
-    AI = 0,
-    AI_AND_W3C = 1,
-    W3C = 2
-}
+export const DistributedTracingModes: {
+    AI: number;
+    AI_AND_W3C: number;
+    W3C: number;
+};
+
+// Warning: (ae-forgotten-export) The symbol "eDistributedTracingModes" needs to be exported by the entry point applicationinsights-web.d.ts
+//
+// @public (undocumented)
+export type DistributedTracingModes = number | eDistributedTracingModes;
 
 // @public
 export function doPerf<T>(mgrSource: IPerfManagerProvider | IPerfManager, getSource: () => string, func: (perfEvt?: IPerfEvent) => T, details?: () => any, isAsync?: boolean): T;
@@ -383,9 +397,12 @@ export interface IAppInsights {
 // @public (undocumented)
 export interface IAppInsightsCore extends IPerfManagerProvider {
     addNotificationListener?(listener: INotificationListener): void;
+    addPlugin<T extends IPlugin = ITelemetryPlugin>(plugin: T, replaceExisting: boolean, doAsync: boolean, addCb?: (added?: boolean) => void): void;
     addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
+    addUnloadCb(handler: UnloadHandler): void;
     // (undocumented)
     config: IConfiguration;
+    evtNamespace(): string;
     getCookieMgr(): ICookieMgr;
     getNotifyMgr(): INotificationManager;
     getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
@@ -405,6 +422,7 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
     stopPollingInternalLogs?(): void;
     // (undocumented)
     track(telemetryItem: ITelemetryItem): void;
+    unload(isAsync?: boolean, unloadComplete?: () => void): void;
 }
 
 // @public (undocumented)
@@ -604,7 +622,7 @@ export interface IConfiguration {
 
 // @public @deprecated
 export interface ICoreUtils {
-    addEventHandler: (eventName: string, callback: any) => boolean;
+    addEventHandler: (eventName: string, callback: any, evtNamespace?: string | string[]) => boolean;
     arrForEach: <T>(arr: T[], callbackfn: (value: T, index?: number, array?: T[]) => void | number, thisArg?: any) => void;
     arrIndexOf: <T>(arr: T[], searchElement: T, fromIndex?: number) => number;
     arrMap: <T, R>(arr: T[], callbackfn: (value: T, index?: number, array?: T[]) => R, thisArg?: any) => R[];
@@ -848,8 +866,10 @@ export const _InternalMessageId: {
     InMemoryStorageBufferFull: number;
 };
 
+// Warning: (ae-forgotten-export) The symbol "_eInternalMessageId" needs to be exported by the entry point applicationinsights-web.d.ts
+//
 // @public (undocumented)
-export type _InternalMessageId = number | typeof _InternalMessageId;
+export type _InternalMessageId = number | _eInternalMessageId;
 
 // @public (undocumented)
 export interface IPageViewPerformanceTelemetry extends IPartC {
@@ -912,25 +932,16 @@ export interface IPlugin {
     readonly identifier: string;
     initialize: (config: IConfiguration, core: IAppInsightsCore, extensions: IPlugin[], pluginChain?: ITelemetryPluginChain) => void;
     isInitialized?: () => boolean;
-    teardown?: () => void;
+    teardown?: (unloadCtx: IProcessTelemetryUnloadContext, unloadState?: ITelemetryUnloadState) => void | boolean;
     readonly version?: string;
 }
 
+// Warning: (ae-forgotten-export) The symbol "IBaseProcessingContext" needs to be exported by the entry point applicationinsights-web.d.ts
+//
 // @public
-export interface IProcessTelemetryContext {
-    core: () => IAppInsightsCore;
+export interface IProcessTelemetryContext extends IBaseProcessingContext {
     createNew: (plugins?: IPlugin[] | ITelemetryPluginChain, startAt?: IPlugin) => IProcessTelemetryContext;
-    diagLog: () => IDiagnosticLogger;
-    getCfg: () => IConfiguration;
-    getConfig: (identifier: string, field: string, defaultValue?: number | string | boolean | string[] | RegExp[] | Function) => number | string | boolean | string[] | RegExp[] | Function;
-    // Warning: (ae-forgotten-export) The symbol "GetExtCfgMergeType" needs to be exported by the entry point applicationinsights-web.d.ts
-    getExtCfg: <T>(identifier: string, defaultValue?: T | any, mergeDefault?: GetExtCfgMergeType) => T;
-    getNext: () => ITelemetryPluginChain;
-    hasNext: () => boolean;
-    iterate: <T extends ITelemetryPlugin = ITelemetryPlugin>(callback: (plugin: T) => void) => void;
-    onComplete: (onComplete: () => void) => void;
-    processNext: (env: ITelemetryItem) => void;
-    setNext: (nextCtx: ITelemetryPluginChain) => void;
+    processNext: (env: ITelemetryItem) => boolean | void;
 }
 
 // @public (undocumented)
@@ -964,18 +975,19 @@ export interface ITelemetryItem {
     ver?: string;
 }
 
+// Warning: (ae-forgotten-export) The symbol "ITelemetryProcessor" needs to be exported by the entry point applicationinsights-web.d.ts
+//
 // @public
-export interface ITelemetryPlugin extends IPlugin {
+export interface ITelemetryPlugin extends ITelemetryProcessor, IPlugin {
     readonly priority: number;
-    processTelemetry: (env: ITelemetryItem, itemCtx?: IProcessTelemetryContext) => void;
     setNextPlugin?: (next: ITelemetryPlugin | ITelemetryPluginChain) => void;
 }
 
 // @public
-export interface ITelemetryPluginChain {
+export interface ITelemetryPluginChain extends ITelemetryProcessor {
     getNext: () => ITelemetryPluginChain;
     getPlugin: () => ITelemetryPlugin;
-    processTelemetry: (env: ITelemetryItem, itemCtx: IProcessTelemetryContext) => void;
+    unload?: (unloadCtx: IProcessTelemetryUnloadContext, unloadState: ITelemetryUnloadState) => void;
 }
 
 // @public (undocumented)
@@ -1053,10 +1065,15 @@ export interface IUtil {
 }
 
 // @public (undocumented)
-export enum LoggingSeverity {
-    CRITICAL = 1,
-    WARNING = 2
-}
+export const LoggingSeverity: {
+    CRITICAL: number;
+    WARNING: number;
+};
+
+// Warning: (ae-forgotten-export) The symbol "eLoggingSeverity" needs to be exported by the entry point applicationinsights-web.d.ts
+//
+// @public (undocumented)
+export type LoggingSeverity = number | eLoggingSeverity;
 
 // Warning: (ae-forgotten-export) The symbol "MetricData" needs to be exported by the entry point applicationinsights-web.d.ts
 //
@@ -1361,7 +1378,11 @@ export const Telemetry: {
         SessionExt: string;
         SDKExt: string;
     };
-    DistributedTracingModes: typeof DistributedTracingModes;
+    DistributedTracingModes: {
+        AI: number;
+        AI_AND_W3C: number;
+        W3C: number;
+    };
 };
 
 // Warning: (ae-forgotten-export) The symbol "MessageData" needs to be exported by the entry point applicationinsights-web.d.ts