@microsoft/applicationinsights-core-js 3.0.0-beta.2210-21 → 3.0.0-beta.2211-01

package/dist/applicationinsights-core-js.api.json

@@ -1,7 +1,7 @@
 {
   "metadata": {
     "toolPackage": "@microsoft/api-extractor",
-    "toolVersion": "7.33.4",
+    "toolVersion": "7.33.6",
     "schemaVersion": 1010,
     "oldestForwardsCompatibleVersion": 1001,
     "tsdocConfig": {
@@ -3043,40 +3043,6 @@
           "name": "AppInsightsCore",
           "preserveMemberOrder": false,
           "members": [
-            {
-              "kind": "Property",
-              "canonicalReference": "@microsoft/applicationinsights-core-js!AppInsightsCore#_extensions:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "_extensions: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "IPlugin",
-                  "canonicalReference": "@microsoft/applicationinsights-core-js!IPlugin:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": "[]"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "_extensions",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 3
-              },
-              "isStatic": false,
-              "isProtected": false
-            },
             {
               "kind": "Method",
               "canonicalReference": "@microsoft/applicationinsights-core-js!AppInsightsCore#_updateHook:member(1)",
@@ -4037,6 +4003,35 @@
               "isOptional": false,
               "name": "getTransmissionControls"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!AppInsightsCore#getWParam:member",
+              "docComment": "/**\n * Function used to identify the get w parameter used to identify status bit to some channels\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getWParam: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "() => number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "getWParam",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@microsoft/applicationinsights-core-js!AppInsightsCore#initialize:member(1)",
@@ -4143,7 +4138,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@microsoft/applicationinsights-core-js!AppInsightsCore#isInitialized:member",
-              "docComment": "",
+              "docComment": "/**\n * Returns a value that indicates whether the instance has already been previously initialized.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4283,6 +4278,64 @@
               "isOptional": false,
               "name": "onCfgChange"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!AppInsightsCore#pluginVersionString:member",
+              "docComment": "/**\n * The formatted string of the installed plugins that contain a version number\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly pluginVersionString: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "pluginVersionString",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!AppInsightsCore#pluginVersionStringArr:member",
+              "docComment": "/**\n * An array of the installed plugins that provide a version\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly pluginVersionStringArr: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "pluginVersionStringArr",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@microsoft/applicationinsights-core-js!AppInsightsCore#pollInternalLogs:member(1)",
@@ -9445,6 +9498,33 @@
               "parameters": [],
               "name": "getTransmissionControls"
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IAppInsightsCore#getWParam:member",
+              "docComment": "/**\n * Function used to identify the get w parameter used to identify status bit to some channels\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getWParam: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "() => number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "getWParam",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@microsoft/applicationinsights-core-js!IAppInsightsCore#initialize:member(1)",
@@ -9683,6 +9763,60 @@
               ],
               "name": "onCfgChange"
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IAppInsightsCore#pluginVersionString:member",
+              "docComment": "/**\n * The formatted string of the installed plugins that contain a version number\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly pluginVersionString: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "pluginVersionString",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IAppInsightsCore#pluginVersionStringArr:member",
+              "docComment": "/**\n * An array of the installed plugins that provide a version\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly pluginVersionStringArr: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "pluginVersionStringArr",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@microsoft/applicationinsights-core-js!IAppInsightsCore#pollInternalLogs:member(1)",
@@ -11589,6 +11723,33 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IConfiguration#enableWParam:member",
+              "docComment": "/**\n * Add \"&w=0\" parameter to support UA Parsing when web-workers don't have access to Document. Default is false\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "enableWParam?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "enableWParam",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@microsoft/applicationinsights-core-js!IConfiguration#endpointUrl:member",

package/dist/applicationinsights-core-js.api.md

@@ -89,8 +89,6 @@ export class AppInsightsCore implements IAppInsightsCore {
     // (undocumented)
     eventCnt(): number;
     evtNamespace(): string;
-    // (undocumented)
-    _extensions: IPlugin[];
     flush(isAsync?: boolean, callBack?: (flushComplete?: boolean) => void, sendReason?: SendRequestReason): void;
     getCookieMgr(): ICookieMgr;
     // (undocumented)
@@ -104,13 +102,15 @@ export class AppInsightsCore implements IAppInsightsCore {
     getTraceCtx(createNew?: boolean): IDistributedTraceContext | null;
     // (undocumented)
     getTransmissionControls(): IChannelControls[][];
+    getWParam: () => number;
     // (undocumented)
     initialize(config: IConfiguration, extensions: IPlugin[], logger?: IDiagnosticLogger, notificationManager?: INotificationManager): void;
-    // (undocumented)
     isInitialized: () => boolean;
     // (undocumented)
     logger: IDiagnosticLogger;
     onCfgChange<T extends IConfiguration = IConfiguration>(handler: WatcherFunction<T>): IUnloadHook;
+    readonly pluginVersionString: string;
+    readonly pluginVersionStringArr: string[];
     pollInternalLogs(eventName?: string): number;
     // (undocumented)
     protected releaseQueue(): void;
@@ -540,12 +540,15 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
     getTraceCtx(createNew?: boolean): IDistributedTraceContext | null;
     // (undocumented)
     getTransmissionControls(): IChannelControls[][];
+    getWParam: () => number;
     // (undocumented)
     initialize(config: IConfiguration, extensions: IPlugin[], logger?: IDiagnosticLogger, notificationManager?: INotificationManager): void;
     isInitialized?: () => boolean;
     // (undocumented)
     logger: IDiagnosticLogger;
     onCfgChange<T extends IConfiguration = IConfiguration>(handler: WatcherFunction<T>): IUnloadHook;
+    readonly pluginVersionString: string;
+    readonly pluginVersionStringArr: string[];
     // (undocumented)
     pollInternalLogs?(eventName?: string): number;
     removeNotificationListener?(listener: INotificationListener): void;
@@ -618,6 +621,7 @@ export interface IConfiguration {
     disablePageUnloadEvents?: string[];
     enableDebugExceptions?: boolean;
     enablePerfMgr?: boolean;
+    enableWParam?: boolean;
     endpointUrl?: string;
     extensionConfig?: {
         [key: string]: any;

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

@@ -1,5 +1,5 @@
 /*
- * Microsoft Application Insights Core Javascript SDK, 3.0.0-beta.2210-21
+ * Microsoft Application Insights Core Javascript SDK, 3.0.0-beta.2211-01
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -132,8 +132,22 @@ declare namespace ApplicationInsights {
         static defaultConfig: IConfiguration;
         config: IConfiguration;
         logger: IDiagnosticLogger;
-        _extensions: IPlugin[];
+        /**
+         * 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;
+        /**
+         * Function used to identify the get w parameter used to identify status bit to some channels
+         */
+        getWParam: () => number;
         constructor();
         initialize(config: IConfiguration, extensions: IPlugin[], logger?: IDiagnosticLogger, notificationManager?: INotificationManager): void;
         getTransmissionControls(): IChannelControls[][];
@@ -826,6 +840,14 @@ declare namespace ApplicationInsights {
     interface IAppInsightsCore extends IPerfManagerProvider {
         config: IConfiguration;
         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.
          */
@@ -943,6 +965,10 @@ declare namespace ApplicationInsights {
          * @returns A watcher handler instance that can be used to remove itself when being unloaded
          */
         onCfgChange<T extends IConfiguration = IConfiguration>(handler: WatcherFunction<T>): IUnloadHook;
+        /**
+         * Function used to identify the get w parameter used to identify status bit to some channels
+         */
+        getWParam: () => number;
     }
 
     interface IBaseProcessingContext {
@@ -1221,6 +1247,11 @@ declare namespace ApplicationInsights {
          * 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;
     }
 
     interface ICookieMgr {

package/dist/applicationinsights-core-js.js

@@ -1,5 +1,5 @@
 /*!
- * Application Insights JavaScript SDK - Core, 3.0.0-beta.2210-21
+ * Application Insights JavaScript SDK - Core, 3.0.0-beta.2211-01
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 (function (global, factory) {
@@ -820,8 +820,8 @@
     var _DYN_CALL = "call";
     var _DYN_GET_PLUGIN = "getPlugin";
     var _DYN_FLUSH = "flush";
+    var _DYN_VERSION = "version";
     var _DYN_LOGGING_LEVEL_CONSOL4 = "loggingLevelConsole";
-    var _DYN__EXTENSIONS = "_extensions";
     var _DYN_TEARDOWN = "teardown";
     var _DYN_MESSAGE_ID = "messageId";
     var _DYN_MESSAGE = "message";
@@ -850,7 +850,6 @@
     var _DYN_TRACE_ID = "traceId";
     var _DYN_SPAN_ID = "spanId";
     var _DYN_TRACE_FLAGS = "traceFlags";
-    var _DYN_VERSION = "version";
 
     var aggregationErrorType;
     function throwAggregationError(message, sourceErrors) {
@@ -1710,7 +1709,7 @@
     }
 
     var _objDefineProperty = ObjDefineProperty;
-    var version = "3.0.0-beta.2210-21";
+    var version = "3.0.0-beta.2211-01";
     var instanceName = "." + newId(6);
     var _dataUid = 0;
     function _createAccessor(target, prop, value) {
@@ -2645,11 +2644,10 @@
             match[3] === INVALID_SPAN_ID) {
             return null;
         }
-        return _a = {
-                version: (match[1] || STR_EMPTY)[_DYN_TO_LOWER_CASE ](),
-                traceId: (match[2] || STR_EMPTY)[_DYN_TO_LOWER_CASE ](),
-                spanId: (match[3] || STR_EMPTY)[_DYN_TO_LOWER_CASE ]()
-            },
+        return _a = {},
+            _a[_DYN_VERSION ] = (match[1] || STR_EMPTY)[_DYN_TO_LOWER_CASE ](),
+            _a.traceId = (match[2] || STR_EMPTY)[_DYN_TO_LOWER_CASE ](),
+            _a.spanId = (match[3] || STR_EMPTY)[_DYN_TO_LOWER_CASE ](),
             _a[_DYN_TRACE_FLAGS ] = parseInt(match[4], 16),
             _a;
     }
@@ -4100,9 +4098,15 @@
             var _traceCtx;
             var _instrumentationKey;
             var _cfgListeners;
+            var _extensions;
+            var _pluginVersionStringArr;
+            var _pluginVersionString;
             var _internalLogPoller = 0;
             dynamicProto(AppInsightsCore, this, function (_self) {
                 _initDefaults();
+                _self["_getDbgPlgTargets"] = function () {
+                    return [_extensions];
+                };
                 _self[_DYN_IS_INITIALIZED ] = function () { return _isInitialized; };
                 _self[_DYN_INITIALIZE ] = function (config, extensions, logger, notificationManager) {
                     if (_isUnloading) {
@@ -4394,8 +4398,34 @@
                         }
                     };
                 };
+                _self.getWParam = function () {
+                    return (hasDocument() || !!_configHandler.cfg.enableWParam) ? 0 : -1;
+                };
+                function _setPluginVersions() {
+                    _pluginVersionStringArr = [];
+                    if (_channelConfig) {
+                        arrForEach(_channelConfig, function (channels) {
+                            if (channels) {
+                                arrForEach(channels, function (channel) {
+                                    if (channel[_DYN_IDENTIFIER ] && channel[_DYN_VERSION ]) {
+                                        var ver = channel[_DYN_IDENTIFIER ] + "=" + channel[_DYN_VERSION ];
+                                        _pluginVersionStringArr[_DYN_PUSH ](ver);
+                                    }
+                                });
+                            }
+                        });
+                    }
+                    if (_configExtensions) {
+                        arrForEach(_configExtensions, function (ext) {
+                            if (ext && ext[_DYN_IDENTIFIER ] && ext[_DYN_VERSION ]) {
+                                var ver = ext[_DYN_IDENTIFIER ] + "=" + ext[_DYN_VERSION ];
+                                _pluginVersionStringArr[_DYN_PUSH ](ver);
+                            }
+                        });
+                    }
+                }
                 function _initDefaults() {
-                    var _a;
+                    var _a, _b, _c;
                     _isInitialized = false;
                     _configHandler = createDynamicConfig({}, defaultConfig, _self[_DYN_LOGGER ]);
                     _configHandler.cfg[_DYN_LOGGING_LEVEL_CONSOL4 ] = 1 ;
@@ -4407,8 +4437,31 @@
                             _self.updateCfg(newValue, false);
                         },
                         _a));
+                    objDefineProp(_self, "pluginVersionStringArr", (_b = {},
+                        _b[_DYN_CONFIGURABLE ] = true,
+                        _b[_DYN_ENUMERABLE ] = true,
+                        _b.get = function () {
+                            if (!_pluginVersionStringArr) {
+                                _setPluginVersions();
+                            }
+                            return _pluginVersionStringArr;
+                        },
+                        _b));
+                    objDefineProp(_self, "pluginVersionString", (_c = {},
+                        _c[_DYN_CONFIGURABLE ] = true,
+                        _c[_DYN_ENUMERABLE ] = true,
+                        _c.get = function () {
+                            if (!_pluginVersionString) {
+                                if (!_pluginVersionStringArr) {
+                                    _setPluginVersions();
+                                }
+                                _pluginVersionString = _pluginVersionStringArr.join(";");
+                            }
+                            return _pluginVersionString || STR_EMPTY;
+                        },
+                        _c));
                     _self[_DYN_LOGGER ] = new DiagnosticLogger(_configHandler.cfg);
-                    _self[_DYN__EXTENSIONS ] = [];
+                    _extensions = [];
                     _telemetryInitializerPlugin = new TelemetryInitializerPlugin();
                     _eventQueue = [];
                     _notificationManager = null;
@@ -4429,6 +4482,8 @@
                     _instrumentationKey = null;
                     _hooks = [];
                     _cfgListeners = [];
+                    _pluginVersionString = null;
+                    _pluginVersionStringArr = null;
                 }
                 function _createTelCtx() {
                     return createProcessTelemetryContext(_getPluginChain(), _configHandler.cfg, _self);
@@ -4437,6 +4492,8 @@
                     var theExtensions = _validateExtensions(_self[_DYN_LOGGER ], ChannelControllerPriority, _configExtensions);
                     _coreExtensions = theExtensions[STR_CORE ];
                     _pluginChain = null;
+                    _pluginVersionString = null;
+                    _pluginVersionStringArr = null;
                     var allExtensions = theExtensions.all;
                     _channelQueue = objFreeze(createChannelQueues(_channelConfig, allExtensions, _self));
                     if (_channelControl) {
@@ -4455,10 +4512,10 @@
                     }
                     allExtensions[_DYN_PUSH ](_channelControl);
                     _coreExtensions[_DYN_PUSH ](_channelControl);
-                    _self[_DYN__EXTENSIONS ] = sortPlugins(allExtensions);
+                    _extensions = sortPlugins(allExtensions);
                     _channelControl[_DYN_INITIALIZE ](_configHandler.cfg, _self, allExtensions);
                     initializePlugins(_createTelCtx(), allExtensions);
-                    _self[_DYN__EXTENSIONS ] = objFreeze(sortPlugins(_coreExtensions || [])).slice();
+                    _extensions = objFreeze(sortPlugins(_coreExtensions || [])).slice();
                     if (updateState) {
                         _doUpdate(updateState);
                     }
@@ -4466,7 +4523,7 @@
                 function _getPlugin(pluginIdentifier) {
                     var theExt = null;
                     var thePlugin = null;
-                    arrForEach(_self[_DYN__EXTENSIONS ], function (ext) {
+                    arrForEach(_extensions, function (ext) {
                         if (ext[_DYN_IDENTIFIER ] === pluginIdentifier && ext !== _channelControl && ext !== _telemetryInitializerPlugin) {
                             thePlugin = ext;
                             return -1;
@@ -4534,6 +4591,8 @@
                                 }
                             });
                             _configExtensions = newConfigExtensions;
+                            _pluginVersionString = null;
+                            _pluginVersionStringArr = null;
                             var newChannelConfig = [];
                             if (_channelConfig) {
                                 arrForEach(_channelConfig, function (queue, idx) {