@microsoft/applicationinsights-web-basic 2.7.4-nightly.2202-07 → 2.8.0-beta.2202-06

package/dist/applicationinsights-web-basic.rollup.d.ts

@@ -1,5 +1,5 @@
 /*
- * Microsoft.ApplicationInsights, 2.7.4-nightly.2202-07
+ * Microsoft.ApplicationInsights, 2.8.0-beta.2202-06
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -17,26 +17,6 @@ export declare class AppInsightsCore extends BaseCore implements IAppInsightsCor
     constructor();
     initialize(config: IConfiguration, extensions: IPlugin[], logger?: IDiagnosticLogger, notificationManager?: INotificationManager): void;
     track(telemetryItem: ITelemetryItem): 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 {INotificationListener} listener - An INotificationListener object.
-     */
-    addNotificationListener(listener: INotificationListener): void;
-    /**
-     * Removes all instances of the listener.
-     * @param {INotificationListener} listener - INotificationListener to remove.
-     */
-    removeNotificationListener(listener: INotificationListener): void;
-    /**
-     * Periodically check logger.queue for
-     */
-    pollInternalLogs(eventName?: string): number;
-    /**
-     * Periodically check logger.queue for
-     */
-    stopPollingInternalLogs(): void;
 }
 
 /**
@@ -88,6 +68,18 @@ declare class BaseCore implements IAppInsightsCore {
     track(telemetryItem: ITelemetryItem): void;
     getProcessTelContext(): IProcessTelemetryContext;
     getNotifyMgr(): INotificationManager;
+    /**
+     * 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 {INotificationListener} listener - An INotificationListener object.
+     */
+    addNotificationListener(listener: INotificationListener): void;
+    /**
+     * Removes all instances of the listener.
+     * @param {INotificationListener} listener - INotificationListener to remove.
+     */
+    removeNotificationListener(listener: INotificationListener): void;
     /**
      * Get the current cookie manager for this instance
      */
@@ -100,6 +92,21 @@ declare class BaseCore implements IAppInsightsCore {
     getPerfMgr(): IPerfManager;
     setPerfMgr(perfMgr: IPerfManager): void;
     eventCnt(): number;
+    /**
+     * Periodically check logger.queue for
+     */
+    pollInternalLogs(eventName?: string): number;
+    /**
+     * Periodically check logger.queue for
+     */
+    stopPollingInternalLogs(): 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;
+    getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
     protected releaseQueue(): void;
 }
 
@@ -109,6 +116,13 @@ declare class BaseCore implements IAppInsightsCore {
  * implementation so that new default implementations can be added without breaking all plugins.
  */
 declare abstract class BaseTelemetryPlugin implements ITelemetryPlugin {
+    identifier: string;
+    version?: string;
+    /**
+     * Holds the core instance that was used during initialization
+     */
+    core: IAppInsightsCore;
+    priority: number;
     /**
      * Call back for telemetry processing before it it is sent
      * @param env - This is the current event being reported
@@ -130,13 +144,6 @@ declare abstract class BaseTelemetryPlugin implements ITelemetryPlugin {
      * Returns whether the plugin has been initialized
      */
     isInitialized: () => boolean;
-    identifier: string;
-    version?: string;
-    /**
-     * Holds the core instance that was used during initialization
-     */
-    core: IAppInsightsCore;
-    priority: number;
     /**
      * Helper to return the current IProcessTelemetryContext, if the passed argument exists this just
      * returns that value (helps with minification for callers), otherwise it will return the configured
@@ -148,13 +155,14 @@ declare abstract class BaseTelemetryPlugin implements ITelemetryPlugin {
      * Internal helper to allow setting of the internal initialized setting for inherited instances and unit testing
      */
     protected setInitialized: (isInitialized: boolean) => void;
-    /**
-     * Internal helper to initialize the instance
-     */
-    private _baseTelInit;
     constructor();
     initialize(config: IConfiguration, core: IAppInsightsCore, extensions: IPlugin[], pluginChain?: ITelemetryPluginChain): void;
     abstract processTelemetry(env: ITelemetryItem, itemCtx?: IProcessTelemetryContext): void;
+    /**
+     * Add this hook so that it is automatically removed during unloading
+     * @param hooks - The single hook or an array of IInstrumentHook objects
+     */
+    protected _addHook(hooks: IInstrumentHook | IInstrumentHook[]): void;
 }
 
 /**
@@ -180,6 +188,12 @@ declare enum DistributedTracingModes {
     W3C = 2
 }
 
+declare const enum GetExtCfgMergeType {
+    None = 0,
+    MergeDefaultOnly = 1,
+    MergeDefaultFromRootOrDefault = 2
+}
+
 export declare interface IAppInsightsCore extends IPerfManagerProvider {
     config: IConfiguration;
     logger: IDiagnosticLogger;
@@ -215,12 +229,23 @@ export declare interface IAppInsightsCore extends IPerfManagerProvider {
      * @param {INotificationListener} listener - INotificationListener to remove.
      */
     removeNotificationListener?(listener: INotificationListener): void;
+    /**
+     * Add a telemetry processor to decorate or drop telemetry events.
+     * @param telemetryInitializer - The Telemetry Initializer function
+     * @returns - A ITelemetryInitializerHandler to enable the initializer to be removed
+     */
+    addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
     pollInternalLogs?(eventName?: string): number;
     stopPollingInternalLogs?(): void;
     /**
      * Return a new instance of the IProcessTelemetryContext for processing events
      */
     getProcessTelContext(): IProcessTelemetryContext;
+    /**
+     * Find and return the (first) plugin with the specified identifier if present
+     * @param pluginIdentifier
+     */
+    getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
 }
 
 /**
@@ -322,10 +347,13 @@ declare interface IChannelControls extends ITelemetryPlugin {
     teardown(): void;
     /**
      * Flush to send data immediately; channel should default to sending data asynchronously
-     * @param async: send data asynchronously when true
-     * @param callBack: if specified, notify caller when send is complete
+     * @param async - send data asynchronously when true
+     * @param callBack - if specified, notify caller when send is complete, the channel should return true to indicate to the caller that it will be called.
+     * If the caller doesn't return true the caller should assume that it may never be called.
+     * @param sendReason - specify the reason that you are calling "flush" defaults to ManualFlush (1) if not specified
+     * @returns - true if the callback will be return after the flush is complete otherwise the caller should assume that any provided callback will never be called
      */
-    flush(async: boolean, callBack?: () => void): void;
+    flush(async: boolean, callBack?: (flushComplete?: boolean) => void, sendReason?: SendRequestReason): boolean | void;
 }
 
 declare interface IChannelControlsAI extends IChannelControls {
@@ -1160,6 +1188,77 @@ export declare interface IEventTelemetry extends IPartC {
     iKey?: string;
 }
 
+declare interface IInstrumentCallDetails {
+    name: string;
+    inst: any;
+    /**
+     * This returns an object that the hook function can use to store hook specific
+     * context, it it not shared with any other hook instances and is unique for the
+     * current call.
+     * A hook implementation can use this to pass / share context between different
+     * hook callbacks eg. request/response requst/hookErrors etc.
+     */
+    ctx: () => any;
+    /**
+     * Allows the hook functions to replace the original arguments
+     * @param idx - The argument index (0 based)
+     * @param value - The new value for the argument
+     */
+    set: (idx: number, value: any) => void;
+    /**
+     * The result of the original method, only populated after the original method has returned
+     */
+    rslt?: any;
+    /**
+     * 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;
+}
+
+/**
+ * The holder of the specific instance callback
+ */
+declare interface IInstrumentHook {
+    /** Unique Id for this callback on the hooked method */
+    id: number;
+    /** Holds the callbacks */
+    cbks: IInstrumentHooksCallbacks;
+    /** Remove this hook from the function */
+    rm: () => void;
+}
+
+/**
+ * The callbacks to call for the instrumented function, you must provide at least the request and/or response callbacks, both are not required.
+ * You must always supply the error callback
+ */
+declare interface IInstrumentHooksCallbacks {
+    /**
+     * The hook callback to call before the original function is called
+     */
+    req?: InstrumentorHooksCallback;
+    /**
+     * The hook callback to call after the original function was called
+     */
+    rsp?: InstrumentorHooksCallback;
+    /**
+     * The callback to call if the hook function causes an exception
+     */
+    hkErr?: InstrumentorHooksCallback;
+    /**
+     * The callback to call if the original function causes an exception, even if you
+     * supply a callback the original exception will still be thrown
+     */
+    fnErr?: InstrumentorHooksCallback;
+}
+
+declare interface ILoadedPlugin<T extends IPlugin> {
+    plugin: T;
+}
+
 export declare interface IMetricTelemetry extends IPartC {
     /**
      * @description (required) - name of this metric
@@ -1278,6 +1377,12 @@ declare interface INotificationManager {
     perfEvent?(perfEvent: IPerfEvent): void;
 }
 
+/**
+ * A callback function that will be called for the wrapped instrumentation function
+ * before the original function is executed.
+ */
+declare type InstrumentorHooksCallback = (funcArgs: IInstrumentCallDetails, ...orgArgs: any[]) => void;
+
 declare class _InternalLogMessage {
     static dataType: string;
     message: string;
@@ -1622,7 +1727,7 @@ declare interface IProcessTelemetryContext {
     /**
      * Gets the named extension config
      */
-    getExtCfg: <T>(identifier: string, defaultValue?: T | any) => T;
+    getExtCfg: <T>(identifier: string, defaultValue?: T | any, mergeDefault?: GetExtCfgMergeType) => T;
     /**
      * Gets the named config from either the named identifier extension or core config if neither exist then the
      * default value is returned
@@ -1630,7 +1735,7 @@ declare interface IProcessTelemetryContext {
      * @param field The config field name
      * @param defaultValue The default value to return if no defined config exists
      */
-    getConfig: (identifier: string, field: string, defaultValue?: number | string | boolean) => number | string | boolean;
+    getConfig: (identifier: string, field: string, defaultValue?: number | string | boolean | string[] | RegExp[] | Function) => number | string | boolean | string[] | RegExp[] | Function;
     /**
      * Helper to allow plugins to check and possibly shortcut executing code only
      * required if there is a nextPlugin
@@ -1649,6 +1754,12 @@ declare interface IProcessTelemetryContext {
      * @param env - This is the current event being reported
      */
     processNext: (env: ITelemetryItem) => void;
+    /**
+     * Synchronously iterate over the context chain running the callback for each plugin, once
+     * every plugin has been executed via the callback, any associated onComplete will be called.
+     * @param callback - The function call for each plugin in the context chain
+     */
+    iterate: <T extends ITelemetryPlugin = ITelemetryPlugin>(callback: (plugin: T) => void) => void;
     /**
      * Create a new context using the core and config from the current instance
      * @param plugins - The execution order to process the plugins, if null or not supplied
@@ -1657,6 +1768,10 @@ declare interface IProcessTelemetryContext {
      *                  order then the next plugin will be NOT set.
      */
     createNew: (plugins?: IPlugin[] | ITelemetryPluginChain, startAt?: IPlugin) => IProcessTelemetryContext;
+    /**
+     * Set the function to call when the current chain has executed all processNext or unloadNext items.
+     */
+    onComplete: (onComplete: () => void) => void;
 }
 
 declare interface IRequestContext {
@@ -1798,6 +1913,10 @@ declare interface IStackDetails {
     obj: string[];
 }
 
+declare interface ITelemetryInitializerHandler {
+    remove(): void;
+}
+
 /**
  * Telemety item supported in Core
  */
@@ -2062,6 +2181,8 @@ declare interface Tags {
     [key: string]: any;
 }
 
+declare type TelemetryInitializerFunction = <T extends ITelemetryItem>(item: T) => boolean | void;
+
 declare interface XDomainRequest extends XMLHttpRequestEventTarget {
     readonly responseText: string;
     send(payload: string): void;

package/dist-esm/index.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript Web SDK - Basic, 2.7.4-nightly.2202-07
+ * Application Insights JavaScript Web SDK - Basic, 2.8.0-beta.2202-06
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@microsoft/applicationinsights-web-basic",
-    "version": "2.7.4-nightly.2202-07",
+    "version": "2.8.0-beta.2202-06",
     "description": "Microsoft Application Insights Javascript SDK core and channel",
     "homepage": "https://github.com/microsoft/ApplicationInsights-JS#readme",
     "author": "Microsoft Application Insights Team",
@@ -49,12 +49,12 @@
     "dependencies": {
         "@microsoft/dynamicproto-js": "^1.1.4",
         "@microsoft/applicationinsights-shims": "2.0.1",
-        "@microsoft/applicationinsights-common": "2.7.4-nightly.2202-07",
-        "@microsoft/applicationinsights-channel-js": "2.7.4-nightly.2202-07",
-        "@microsoft/applicationinsights-core-js": "2.7.4-nightly.2202-07"
+        "@microsoft/applicationinsights-common": "2.8.0-beta.2202-06",
+        "@microsoft/applicationinsights-channel-js": "2.8.0-beta.2202-06",
+        "@microsoft/applicationinsights-core-js": "2.8.0-beta.2202-06"
     },
     "license": "MIT",
     "publishConfig": {
-        "tag": "nightly"
+        "tag": "beta"
     }
 }

package/browser/aib.2.7.4-nightly.2202-07.integrity.json

@@ -1,26 +0,0 @@
-{
-    "name": "aib",
-    "version": "2.7.4-nightly.2202-07",
-    "ext": {
-        "@js": {
-            "file": "aib.2.7.4-nightly.2202-07.js",
-            "type": "text/javascript; charset=utf-8",
-            "integrity": "sha256-uZFixkFKDfp/yuASr5NCtxq+rADpKYtGz5+huJm8ioc= sha384-dsMjf5qDTsV5XktzwRip1XFM8v7vsrh+A5/+8yNvxZuRDaD34Ql8dYTa+XjZzACK sha512-msqcJ+9A4Wf2xQX/jsryL8c0JVlAjJ6jm5MEijsCzlUjjoiWsKS6fGdumhIj6QTYeAZSYW1kDSc71mDvTX7xAA==",
-            "hashes": {
-                "sha256": "uZFixkFKDfp/yuASr5NCtxq+rADpKYtGz5+huJm8ioc=",
-                "sha384": "dsMjf5qDTsV5XktzwRip1XFM8v7vsrh+A5/+8yNvxZuRDaD34Ql8dYTa+XjZzACK",
-                "sha512": "msqcJ+9A4Wf2xQX/jsryL8c0JVlAjJ6jm5MEijsCzlUjjoiWsKS6fGdumhIj6QTYeAZSYW1kDSc71mDvTX7xAA=="
-            }
-        },
-        "@min.js": {
-            "file": "aib.2.7.4-nightly.2202-07.min.js",
-            "type": "text/javascript; charset=utf-8",
-            "integrity": "sha256-3dUQEYCzw6rQG5padGI0LD4l84Ic66jVd9Re3DNDcf0= sha384-T6ikJZeqWP02OurjtHaGKXKcJOuQmSIbwaR996nWtNK8sPATArtmEPQMme420UpM sha512-3Fcha/TeduvnP20SXmUPxqYepiNDsvvUz3rCsxPN/VOQpefohTDCBib/ehAHjFOkc48sUkrlPicPJ2+pLDk7lw==",
-            "hashes": {
-                "sha256": "3dUQEYCzw6rQG5padGI0LD4l84Ic66jVd9Re3DNDcf0=",
-                "sha384": "T6ikJZeqWP02OurjtHaGKXKcJOuQmSIbwaR996nWtNK8sPATArtmEPQMme420UpM",
-                "sha512": "3Fcha/TeduvnP20SXmUPxqYepiNDsvvUz3rCsxPN/VOQpefohTDCBib/ehAHjFOkc48sUkrlPicPJ2+pLDk7lw=="
-            }
-        }
-    }
-}