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

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)",
@@ -4301,8 +4354,9 @@
                   "text": "): "
                 },
                 {
-                  "kind": "Content",
-                  "text": "number"
+                  "kind": "Reference",
+                  "text": "ITimerHandler",
+                  "canonicalReference": "@nevware21/ts-utils!ITimerHandler:interface"
                 },
                 {
                   "kind": "Content",
@@ -9445,6 +9499,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 +9764,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)",
@@ -9701,8 +9836,9 @@
                   "text": "): "
                 },
                 {
-                  "kind": "Content",
-                  "text": "number"
+                  "kind": "Reference",
+                  "text": "ITimerHandler",
+                  "canonicalReference": "@nevware21/ts-utils!ITimerHandler:interface"
                 },
                 {
                   "kind": "Content",
@@ -11589,6 +11725,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

@@ -39,6 +39,7 @@ import { isSymbol } from '@nevware21/ts-utils';
 import { isTruthy } from '@nevware21/ts-utils';
 import { isTypeof } from '@nevware21/ts-utils';
 import { isUndefined } from '@nevware21/ts-utils';
+import { ITimerHandler } from '@nevware21/ts-utils';
 import { objCreateFn as objCreate } from '@microsoft/applicationinsights-shims';
 import { objDefineAccessors } from '@nevware21/ts-utils';
 import { objForEachKey } from '@nevware21/ts-utils';
@@ -89,8 +90,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,14 +103,16 @@ 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;
-    pollInternalLogs(eventName?: string): number;
+    readonly pluginVersionString: string;
+    readonly pluginVersionStringArr: string[];
+    pollInternalLogs(eventName?: string): ITimerHandler;
     // (undocumented)
     protected releaseQueue(): void;
     removeNotificationListener(listener: INotificationListener): void;
@@ -540,14 +541,17 @@ 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;
+    pollInternalLogs?(eventName?: string): ITimerHandler;
     removeNotificationListener?(listener: INotificationListener): void;
     setCookieMgr(cookieMgr: ICookieMgr): void;
     setTraceCtx(newTraceCtx: IDistributedTraceContext | null | undefined): void;
@@ -618,6 +622,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-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -42,6 +42,7 @@ declare namespace ApplicationInsights {
     import { isTruthy } from '@nevware21/ts-utils';
     import { isTypeof } from '@nevware21/ts-utils';
     import { isUndefined } from '@nevware21/ts-utils';
+    import { ITimerHandler } from '@nevware21/ts-utils';
     import { objCreateFn as objCreate } from '@microsoft/applicationinsights-shims';
     import { objDefineAccessors } from '@nevware21/ts-utils';
     import { objForEachKey } from '@nevware21/ts-utils';
@@ -132,8 +133,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[][];
@@ -167,7 +182,7 @@ declare namespace ApplicationInsights {
         /**
          * Periodically check logger.queue for
          */
-        pollInternalLogs(eventName?: string): number;
+        pollInternalLogs(eventName?: string): ITimerHandler;
         /**
          * Periodically check logger.queue for
          */
@@ -826,6 +841,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.
          */
@@ -864,7 +887,7 @@ declare namespace ApplicationInsights {
          * @returns - A ITelemetryInitializerHandler to enable the initializer to be removed
          */
         addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler;
-        pollInternalLogs?(eventName?: string): number;
+        pollInternalLogs?(eventName?: string): ITimerHandler;
         stopPollingInternalLogs?(): void;
         /**
          * Return a new instance of the IProcessTelemetryContext for processing events
@@ -943,6 +966,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 +1248,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 {