@microsoft/applicationinsights-web-basic 2.8.0-nightly.2202-06 → 2.8.0-nightly.2204-06

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

@@ -9,17 +9,11 @@
 // @public (undocumented)
 export class AppInsightsCore extends BaseCore implements IAppInsightsCore {
     constructor();
-    // Warning: (ae-forgotten-export) The symbol "INotificationListener" needs to be exported by the entry point index.d.ts
-    addNotificationListener(listener: INotificationListener): void;
-    // Warning: (ae-forgotten-export) The symbol "IPlugin" needs to be exported by the entry point index.d.ts
     // Warning: (ae-forgotten-export) The symbol "IDiagnosticLogger" needs to be exported by the entry point index.d.ts
     // Warning: (ae-forgotten-export) The symbol "INotificationManager" needs to be exported by the entry point index.d.ts
     //
     // (undocumented)
     initialize(config: IConfiguration, extensions: IPlugin[], logger?: IDiagnosticLogger, notificationManager?: INotificationManager): void;
-    pollInternalLogs(eventName?: string): number;
-    removeNotificationListener(listener: INotificationListener): void;
-    stopPollingInternalLogs(): void;
     // (undocumented)
     track(telemetryItem: ITelemetryItem): void;
 }
@@ -27,32 +21,222 @@ export class AppInsightsCore extends BaseCore implements IAppInsightsCore {
 // @public
 export class ApplicationInsights {
     constructor(config: IConfiguration & IConfig);
+    addPlugin<T extends IPlugin = ITelemetryPlugin>(plugin: T, replaceExisting: boolean, doAsync: boolean, addCb?: (added?: boolean) => void): void;
+    // Warning: (ae-forgotten-export) The symbol "UnloadHandler" needs to be exported by the entry point index.d.ts
+    addUnloadCb(handler: UnloadHandler): void;
     // Warning: (ae-forgotten-export) The symbol "IConfig" needs to be exported by the entry point index.d.ts
     //
     // (undocumented)
     config: IConfiguration & IConfig;
+    evtNamespace(): string;
     flush(async?: boolean): void;
+    getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
+    // (undocumented)
+    getSKUDefaults(): void;
     initialize(): void;
     // (undocumented)
+    pollInternalLogs(): void;
+    // (undocumented)
     stopPollingInternalLogs(): void;
     track(item: ITelemetryItem): void;
+    unload(isAsync?: boolean, unloadComplete?: () => void): void;
 }
 
+// @public
+export function arrForEach<T = any>(arr: T[], callbackfn: (value: T, index?: number, array?: T[]) => undefined | void | number, thisArg?: any): void;
+
 // Warning: (ae-forgotten-export) The symbol "ICoreUtils" needs to be exported by the entry point index.d.ts
 //
 // @public @deprecated
 export const CoreUtils: ICoreUtils;
 
+// @public (undocumented)
+export const enum _eInternalMessageId {
+    // (undocumented)
+    BrowserCannotReadLocalStorage = 1,
+    // (undocumented)
+    BrowserCannotReadSessionStorage = 2,
+    // (undocumented)
+    BrowserCannotWriteLocalStorage = 3,
+    // (undocumented)
+    BrowserCannotWriteSessionStorage = 4,
+    // (undocumented)
+    BrowserDoesNotSupportLocalStorage = 0,
+    // (undocumented)
+    BrowserFailedRemovalFromLocalStorage = 5,
+    // (undocumented)
+    BrowserFailedRemovalFromSessionStorage = 6,
+    // (undocumented)
+    CannotAccessCookie = 68,
+    // (undocumented)
+    CannotParseAiBlobValue = 101,
+    // (undocumented)
+    CannotSendEmptyTelemetry = 7,
+    // (undocumented)
+    CannotSerializeObject = 48,
+    // (undocumented)
+    CannotSerializeObjectNonSerializable = 49,
+    // (undocumented)
+    CircularReferenceDetected = 50,
+    // (undocumented)
+    ClearAuthContextFailed = 51,
+    // (undocumented)
+    ClientPerformanceMathError = 8,
+    // (undocumented)
+    CreateEnvelopeError = 47,
+    // (undocumented)
+    ErrorParsingAISessionCookie = 9,
+    // (undocumented)
+    ErrorPVCalc = 10,
+    // (undocumented)
+    ExceptionTruncated = 52,
+    // (undocumented)
+    ExceptionWhileLoggingError = 11,
+    // (undocumented)
+    FailedAddingCustomDefinedRequestContext = 104,
+    // (undocumented)
+    FailedAddingTelemetryToBuffer = 12,
+    // (undocumented)
+    FailedMonitorAjaxAbort = 13,
+    // (undocumented)
+    FailedMonitorAjaxDur = 14,
+    // (undocumented)
+    FailedMonitorAjaxGetCorrelationHeader = 18,
+    // (undocumented)
+    FailedMonitorAjaxOpen = 15,
+    // (undocumented)
+    FailedMonitorAjaxRSC = 16,
+    // (undocumented)
+    FailedMonitorAjaxSend = 17,
+    // (undocumented)
+    FailedMonitorAjaxSetRequestHeader = 71,
+    // (undocumented)
+    FailedToAddHandlerForOnBeforeUnload = 19,
+    // (undocumented)
+    FailedToFixDepricatedValues = 44,
+    // (undocumented)
+    FailedToReportDataLoss = 21,
+    // (undocumented)
+    FailedToRestoreStorageBuffer = 42,
+    // (undocumented)
+    FailedToSendQueuedTelemetry = 20,
+    // (undocumented)
+    FailedToSetStorageBuffer = 41,
+    // (undocumented)
+    FlushFailed = 22,
+    // (undocumented)
+    IdTooLong = 69,
+    // (undocumented)
+    IllegalCharsInName = 53,
+    // (undocumented)
+    InMemoryStorageBufferFull = 105,
+    // (undocumented)
+    InvalidBackendResponse = 43,
+    // (undocumented)
+    InvalidContentBlob = 102,
+    // (undocumented)
+    InvalidDurationValue = 45,
+    // (undocumented)
+    InvalidEvent = 70,
+    // (undocumented)
+    InvalidInstrumentationKey = 100,
+    // (undocumented)
+    ItemNotInArray = 54,
+    // (undocumented)
+    MaxAjaxPerPVExceeded = 55,
+    // (undocumented)
+    MessageLimitPerPVExceeded = 23,
+    // (undocumented)
+    MessageTruncated = 56,
+    // (undocumented)
+    MissingRequiredFieldSpecification = 24,
+    // (undocumented)
+    NameTooLong = 57,
+    // (undocumented)
+    NavigationTimingNotSupported = 25,
+    // (undocumented)
+    NotificationException = 74,
+    // (undocumented)
+    OnError = 26,
+    // (undocumented)
+    PluginException = 73,
+    // (undocumented)
+    SampleRateOutOfRange = 58,
+    // (undocumented)
+    SendBrowserInfoOnUserInit = 72,
+    // (undocumented)
+    SenderNotInitialized = 28,
+    // (undocumented)
+    SessionRenewalDateIsZero = 27,
+    // (undocumented)
+    SessionStorageBufferFull = 67,
+    // (undocumented)
+    SetAuthContextFailed = 59,
+    // (undocumented)
+    SetAuthContextFailedAccountName = 60,
+    // (undocumented)
+    SnippetScriptLoadFailure = 99,
+    // (undocumented)
+    StartCalledMoreThanOnce = 62,
+    // (undocumented)
+    StartTrackEventFailed = 29,
+    // (undocumented)
+    StartTrackFailed = 31,
+    // (undocumented)
+    StopCalledWithoutStart = 63,
+    // (undocumented)
+    StopTrackEventFailed = 30,
+    // (undocumented)
+    StopTrackFailed = 32,
+    // (undocumented)
+    StringValueTooLong = 61,
+    // (undocumented)
+    TelemetryEnvelopeInvalid = 46,
+    // (undocumented)
+    TelemetryInitializerFailed = 64,
+    // (undocumented)
+    TelemetrySampledAndNotSent = 33,
+    // (undocumented)
+    TrackArgumentsNotSpecified = 65,
+    // (undocumented)
+    TrackEventFailed = 34,
+    // (undocumented)
+    TrackExceptionFailed = 35,
+    // (undocumented)
+    TrackMetricFailed = 36,
+    // (undocumented)
+    TrackPageActionEventFailed = 103,
+    // (undocumented)
+    TrackPVFailed = 37,
+    // (undocumented)
+    TrackPVFailedCalc = 38,
+    // (undocumented)
+    TrackTraceFailed = 39,
+    // (undocumented)
+    TransmissionFailed = 40,
+    // (undocumented)
+    UrlTooLong = 66
+}
+
 // Warning: (ae-forgotten-export) The symbol "IPerfManagerProvider" needs to be exported by the entry point index.d.ts
 //
 // @public (undocumented)
 export interface IAppInsightsCore extends IPerfManagerProvider {
+    // Warning: (ae-forgotten-export) The symbol "INotificationListener" needs to be exported by the entry point index.d.ts
     addNotificationListener?(listener: INotificationListener): void;
+    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 index.d.ts
+    // Warning: (ae-forgotten-export) The symbol "ITelemetryInitializerHandler" needs to be exported by the entry point index.d.ts
+    addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
+    addUnloadCb(handler: UnloadHandler): void;
     // (undocumented)
     config: IConfiguration;
+    evtNamespace(): string;
+    flush(isAsync?: boolean, callBack?: (flushComplete?: boolean) => void, sendReason?: SendRequestReason, cbTimeout?: number): boolean | void;
     // Warning: (ae-forgotten-export) The symbol "ICookieMgr" needs to be exported by the entry point index.d.ts
     getCookieMgr(): ICookieMgr;
     getNotifyMgr(): INotificationManager;
+    getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
     // Warning: (ae-forgotten-export) The symbol "IProcessTelemetryContext" needs to be exported by the entry point index.d.ts
     getProcessTelContext(): IProcessTelemetryContext;
     // Warning: (ae-forgotten-export) The symbol "IChannelControls" needs to be exported by the entry point index.d.ts
@@ -72,6 +256,8 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
     stopPollingInternalLogs?(): void;
     // (undocumented)
     track(telemetryItem: ITelemetryItem): void;
+    // Warning: (ae-forgotten-export) The symbol "ITelemetryUnloadState" needs to be exported by the entry point index.d.ts
+    unload(isAsync?: boolean, unloadComplete?: (unloadState: ITelemetryUnloadState) => void, cbTimeout?: number): void;
 }
 
 // @public
@@ -110,7 +296,6 @@ export interface IConfiguration {
     extensionConfig?: {
         [key: string]: any;
     };
-    // Warning: (ae-forgotten-export) The symbol "ITelemetryPlugin" needs to be exported by the entry point index.d.ts
     extensions?: ITelemetryPlugin[];
     idLength?: number;
     instrumentationKey?: string;
@@ -154,6 +339,16 @@ export interface IEventTelemetry extends IPartC {
     name: string;
 }
 
+// @public (undocumented)
+export interface ILoadedPlugin<T extends IPlugin> {
+    isEnabled: () => boolean;
+    // (undocumented)
+    plugin: T;
+    // (undocumented)
+    remove: (isAsync?: boolean, removeCb?: (removed?: boolean) => void) => void;
+    setEnabled: (isEnabled: boolean) => void;
+}
+
 // @public (undocumented)
 export interface IMetricTelemetry extends IPartC {
     average: number;
@@ -165,6 +360,14 @@ export interface IMetricTelemetry extends IPartC {
     stdDev?: number;
 }
 
+// Warning: (ae-forgotten-export) The symbol "EnumValue" needs to be exported by the entry point index.d.ts
+//
+// @public
+export const _InternalMessageId: EnumValue<typeof _eInternalMessageId>;
+
+// @public (undocumented)
+export type _InternalMessageId = number | _eInternalMessageId;
+
 // @public (undocumented)
 export interface IPageViewPerformanceTelemetry extends IPartC {
     domProcessing?: string;
@@ -191,6 +394,20 @@ export interface IPageViewTelemetry extends IPartC {
     uri?: string;
 }
 
+// @public (undocumented)
+export interface IPlugin {
+    readonly identifier: string;
+    // Warning: (ae-forgotten-export) The symbol "ITelemetryPluginChain" needs to be exported by the entry point index.d.ts
+    initialize: (config: IConfiguration, core: IAppInsightsCore, extensions: IPlugin[], pluginChain?: ITelemetryPluginChain) => void;
+    isInitialized?: () => boolean;
+    // Warning: (ae-forgotten-export) The symbol "IProcessTelemetryUnloadContext" needs to be exported by the entry point index.d.ts
+    teardown?: (unloadCtx: IProcessTelemetryUnloadContext, unloadState?: ITelemetryUnloadState) => void | boolean;
+    readonly version?: string;
+}
+
+// @public (undocumented)
+export function isNullOrUndefined(value: any): value is null | undefined;
+
 // @public
 export interface ITelemetryItem {
     baseData?: {
@@ -210,6 +427,14 @@ export interface ITelemetryItem {
     ver?: string;
 }
 
+// Warning: (ae-forgotten-export) The symbol "ITelemetryProcessor" needs to be exported by the entry point index.d.ts
+//
+// @public
+export interface ITelemetryPlugin extends ITelemetryProcessor, IPlugin {
+    readonly priority: number;
+    setNextPlugin?: (next: ITelemetryPlugin | ITelemetryPluginChain) => void;
+}
+
 // @public (undocumented)
 export interface ITraceTelemetry extends IPartC {
     iKey?: string;
@@ -217,6 +442,9 @@ export interface ITraceTelemetry extends IPartC {
     severityLevel?: SeverityLevel;
 }
 
+// @public
+export function proxyFunctions<T, S>(target: T, source: S | (() => S), functionsToProxy: (keyof S)[], overwriteTarget?: boolean): T;
+
 // Warning: (ae-forgotten-export) The symbol "BaseTelemetryPlugin" needs to be exported by the entry point index.d.ts
 // Warning: (ae-forgotten-export) The symbol "IChannelControlsAI" needs to be exported by the entry point index.d.ts
 //
@@ -234,8 +462,6 @@ export class Sender extends BaseTelemetryPlugin implements IChannelControlsAI {
     flush(): void;
     // (undocumented)
     readonly identifier: string;
-    // Warning: (ae-forgotten-export) The symbol "ITelemetryPluginChain" needs to be exported by the entry point index.d.ts
-    //
     // (undocumented)
     initialize(config: IConfiguration & IConfig, core: IAppInsightsCore, extensions: IPlugin[], pluginChain?: ITelemetryPluginChain): void;
     _onError(payload: string[], message: string, event?: ErrorEvent): void;
@@ -257,15 +483,26 @@ export class Sender extends BaseTelemetryPlugin implements IChannelControlsAI {
     _sender: SenderFunction;
     // Warning: (ae-forgotten-export) The symbol "ISenderConfig" needs to be exported by the entry point index.d.ts
     readonly _senderConfig: ISenderConfig;
-    // (undocumented)
-    teardown(): void;
-    // Warning: (ae-forgotten-export) The symbol "SendRequestReason" needs to be exported by the entry point index.d.ts
     triggerSend(async?: boolean, forcedSender?: SenderFunction, sendReason?: SendRequestReason): void;
     // Warning: (ae-forgotten-export) The symbol "XDomainRequest" needs to be exported by the entry point index.d.ts
     _xdrOnLoad(xdr: XDomainRequest, payload: string[]): void;
     _xhrReadyStateChange(xhr: XMLHttpRequest, payload: string[], countOfItemsInPayload: number): void;
 }
 
+// @public
+export const enum SendRequestReason {
+    ManualFlush = 1,
+    MaxBatchSize = 10,
+    MaxQueuedEvents = 20,
+    NormalSchedule = 1,
+    Resumed = 4,
+    Retry = 5,
+    SdkUnload = 6,
+    SyncEvent = 3,
+    Undefined = 0,
+    Unload = 2
+}
+
 // @public
 export enum SeverityLevel {
     // (undocumented)
@@ -280,6 +517,9 @@ export enum SeverityLevel {
     Warning = 2
 }
 
+// @public (undocumented)
+export function throwError(message: string): never;
+
 // (No @packageDocumentation comment for this package)
 
 ```