@microsoft/applicationinsights-core-js 2.8.4-nightly.2205-07 → 2.8.4-nightly.2205-10

package/dist-esm/JavaScriptSDK.Interfaces/ITelemetryInitializers.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-07
+ * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-10
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 export {};

package/dist-esm/JavaScriptSDK.Interfaces/ITelemetryItem.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-07
+ * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-10
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-esm/JavaScriptSDK.Interfaces/ITelemetryPlugin.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-07
+ * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-10
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-esm/JavaScriptSDK.Interfaces/ITelemetryPluginChain.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-07
+ * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-10
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-esm/JavaScriptSDK.Interfaces/ITelemetryUnloadState.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-07
+ * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-10
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-esm/JavaScriptSDK.Interfaces/ITelemetryUpdateState.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-07
+ * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-10
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-esm/JavaScriptSDK.Interfaces/ITraceParent.js

@@ -0,0 +1,8 @@
+/*
+ * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-10
+ * Copyright (c) Microsoft and contributors. All rights reserved.
+ */
+
+
+export {};
+//# sourceMappingURL=ITraceParent.js.map

package/dist-esm/JavaScriptSDK.Interfaces/ITraceParent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITraceParent.js.map","sources":["ITraceParent.js"],"sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved.\r\n// Licensed under the MIT License.\r\nexport {};\r\n//# sourceMappingURL=ITraceParent.js.map"],"names":[],"mappings":";;;;AAA4D;AAC1B;AAClC;AACA"}

package/dist-esm/JavaScriptSDK.Interfaces/IUnloadableComponent.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-07
+ * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-10
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 export {};

package/dist-esm/applicationinsights-core-js.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-07
+ * Application Insights JavaScript SDK - Core, 2.8.4-nightly.2205-10
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 export { MinChannelPriorty } from "./JavaScriptSDK.Interfaces/IChannelControls";
@@ -12,7 +12,7 @@ export { CoreUtils, EventHelper, Undefined, newGuid, perfNow, generateW3CId, dis
 export { isTypeof, isUndefined, isNullOrUndefined, hasOwnProperty, isObject, isFunction, normalizeJsName, objForEachKey, strEndsWith, strStartsWith, isDate, isArray, isError, isString, isNumber, isBoolean, toISOString, arrForEach, arrIndexOf, arrMap, arrReduce, strTrim, objKeys, objDefineAccessors, dateNow, getExceptionName, throwError, strContains, isSymbol, setValue, getSetValue, isNotTruthy, isTruthy, proxyAssign, proxyFunctions, proxyFunctionAs, createClassFromInterface, optimizeObject, isNotUndefined, isNotNullOrUndefined, objFreeze, objSeal, objExtend, objToString, deepFreeze } from "./JavaScriptSDK/HelperFuncs";
 export { createEnumStyle, createEnumMap, createValueMap } from "./JavaScriptSDK.Enums/EnumHelperFuncs";
 export { attachEvent, detachEvent, addEventHandler, addEventListeners, addPageUnloadEventListener, addPageHideEventListener, addPageShowEventListener, removeEventHandler, removeEventListeners, removePageUnloadEventListener, removePageHideEventListener, removePageShowEventListener, eventOn, eventOff, mergeEvtNamespace, __getRegisteredEvents } from "./JavaScriptSDK/EventHelpers";
-export { getGlobalInst, hasWindow, getWindow, hasDocument, getDocument, getCrypto, getMsCrypto, hasNavigator, getNavigator, hasHistory, getHistory, getLocation, getPerformance, hasJSON, getJSON, isReactNative, getConsole, dumpObj, isIE, getIEVersion, isSafari, setEnableEnvMocks, isBeaconsSupported, isFetchSupported, useXDomainRequest, isXhrSupported } from "./JavaScriptSDK/EnvUtils";
+export { getGlobalInst, hasWindow, getWindow, hasDocument, getDocument, getCrypto, getMsCrypto, hasNavigator, getNavigator, hasHistory, getHistory, getLocation, getPerformance, hasJSON, getJSON, isReactNative, getConsole, dumpObj, isIE, getIEVersion, isSafari, setEnableEnvMocks, isBeaconsSupported, isFetchSupported, useXDomainRequest, isXhrSupported, findMetaTag, findNamedServerTiming } from "./JavaScriptSDK/EnvUtils";
 export { getGlobal, objCreateFn as objCreate, strShimPrototype as strPrototype, strShimFunction as strFunction, strShimUndefined as strUndefined, strShimObject as strObject } from "@microsoft/applicationinsights-shims";
 export { NotificationManager } from "./JavaScriptSDK/NotificationManager";
 export { PerfEvent, PerfManager, doPerf, getGblPerfMgr, setGblPerfMgr } from "./JavaScriptSDK/PerfManager";
@@ -27,4 +27,5 @@ export { createCookieMgr, safeGetCookieMgr, uaDisallowsSameSiteNone, areCookiesS
 export { getDebugListener, getDebugExt } from "./JavaScriptSDK/DbgExtensionUtils";
 export { createUniqueNamespace } from "./JavaScriptSDK/DataCacheHelper";
 export { createUnloadHandlerContainer } from "./JavaScriptSDK/UnloadHandlerContainer";
+export { createTraceParent, parseTraceParent, isValidTraceId, isValidSpanId, isValidTraceParent, isSampledFlag, formatTraceParent, findW3cTraceParent } from "./JavaScriptSDK/W3cTraceParent";
 //# sourceMappingURL=applicationinsights-core-js.js.map

package/dist-esm/applicationinsights-core-js.js.map

@@ -1 +1 @@
-{"version":3,"file":"applicationinsights-core-js.js.map","sources":["applicationinsights-core-js.js"],"sourcesContent":["export { MinChannelPriorty } from \"./JavaScriptSDK.Interfaces/IChannelControls\";\r\nexport { EventsDiscardedReason } from \"./JavaScriptSDK.Enums/EventsDiscardedReason\";\r\nexport { AppInsightsCore } from \"./JavaScriptSDK/AppInsightsCore\";\r\nexport { BaseCore } from \"./JavaScriptSDK/BaseCore\";\r\nexport { BaseTelemetryPlugin } from \"./JavaScriptSDK/BaseTelemetryPlugin\";\r\nexport { randomValue, random32, mwcRandomSeed, mwcRandom32, newId } from \"./JavaScriptSDK/RandomHelper\";\r\nexport { CoreUtils, EventHelper, Undefined, newGuid, perfNow, generateW3CId, disableCookies, canUseCookies, getCookie, setCookie, deleteCookie, _legacyCookieMgr } from \"./JavaScriptSDK/CoreUtils\";\r\nexport { isTypeof, isUndefined, isNullOrUndefined, hasOwnProperty, isObject, isFunction, normalizeJsName, objForEachKey, strEndsWith, strStartsWith, isDate, isArray, isError, isString, isNumber, isBoolean, toISOString, arrForEach, arrIndexOf, arrMap, arrReduce, strTrim, objKeys, objDefineAccessors, dateNow, getExceptionName, throwError, strContains, isSymbol, setValue, getSetValue, isNotTruthy, isTruthy, proxyAssign, proxyFunctions, proxyFunctionAs, createClassFromInterface, optimizeObject, isNotUndefined, isNotNullOrUndefined, objFreeze, objSeal, objExtend, objToString, deepFreeze } from \"./JavaScriptSDK/HelperFuncs\";\r\nexport { createEnumStyle, createEnumMap, createValueMap } from \"./JavaScriptSDK.Enums/EnumHelperFuncs\";\r\nexport { attachEvent, detachEvent, addEventHandler, addEventListeners, addPageUnloadEventListener, addPageHideEventListener, addPageShowEventListener, removeEventHandler, removeEventListeners, removePageUnloadEventListener, removePageHideEventListener, removePageShowEventListener, eventOn, eventOff, mergeEvtNamespace, __getRegisteredEvents } from \"./JavaScriptSDK/EventHelpers\";\r\nexport { getGlobalInst, hasWindow, getWindow, hasDocument, getDocument, getCrypto, getMsCrypto, hasNavigator, getNavigator, hasHistory, getHistory, getLocation, getPerformance, hasJSON, getJSON, isReactNative, getConsole, dumpObj, isIE, getIEVersion, isSafari, setEnableEnvMocks, isBeaconsSupported, isFetchSupported, useXDomainRequest, isXhrSupported } from \"./JavaScriptSDK/EnvUtils\";\r\nexport { getGlobal, objCreateFn as objCreate, strShimPrototype as strPrototype, strShimFunction as strFunction, strShimUndefined as strUndefined, strShimObject as strObject } from \"@microsoft/applicationinsights-shims\";\r\nexport { NotificationManager } from \"./JavaScriptSDK/NotificationManager\";\r\nexport { PerfEvent, PerfManager, doPerf, getGblPerfMgr, setGblPerfMgr } from \"./JavaScriptSDK/PerfManager\";\r\nexport { safeGetLogger, DiagnosticLogger, _InternalLogMessage, _throwInternal, _warnToConsole, _logInternalMessage } from \"./JavaScriptSDK/DiagnosticLogger\";\r\nexport { ProcessTelemetryContext, createProcessTelemetryContext\r\n// Explicitly NOT exporting createProcessTelemetryUnloadContext() and createProcessTelemetryUpdateContext() as these should only be created internally\r\n } from \"./JavaScriptSDK/ProcessTelemetryContext\";\r\nexport { initializePlugins, sortPlugins, unloadComponents } from \"./JavaScriptSDK/TelemetryHelpers\";\r\nexport { _InternalMessageId, LoggingSeverity } from \"./JavaScriptSDK.Enums/LoggingEnums\";\r\nexport { InstrumentProto, InstrumentProtos, InstrumentFunc, InstrumentFuncs, InstrumentEvent } from \"./JavaScriptSDK/InstrumentHooks\";\r\nexport { createCookieMgr, safeGetCookieMgr, uaDisallowsSameSiteNone, areCookiesSupported } from \"./JavaScriptSDK/CookieMgr\";\r\nexport { getDebugListener, getDebugExt } from \"./JavaScriptSDK/DbgExtensionUtils\";\r\nexport { createUniqueNamespace } from \"./JavaScriptSDK/DataCacheHelper\";\r\nexport { createUnloadHandlerContainer } from \"./JavaScriptSDK/UnloadHandlerContainer\";\r\n//# sourceMappingURL=applicationinsights-core-js.js.map"],"names":[],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}
+{"version":3,"file":"applicationinsights-core-js.js.map","sources":["applicationinsights-core-js.js"],"sourcesContent":["export { MinChannelPriorty } from \"./JavaScriptSDK.Interfaces/IChannelControls\";\r\nexport { EventsDiscardedReason } from \"./JavaScriptSDK.Enums/EventsDiscardedReason\";\r\nexport { AppInsightsCore } from \"./JavaScriptSDK/AppInsightsCore\";\r\nexport { BaseCore } from \"./JavaScriptSDK/BaseCore\";\r\nexport { BaseTelemetryPlugin } from \"./JavaScriptSDK/BaseTelemetryPlugin\";\r\nexport { randomValue, random32, mwcRandomSeed, mwcRandom32, newId } from \"./JavaScriptSDK/RandomHelper\";\r\nexport { CoreUtils, EventHelper, Undefined, newGuid, perfNow, generateW3CId, disableCookies, canUseCookies, getCookie, setCookie, deleteCookie, _legacyCookieMgr } from \"./JavaScriptSDK/CoreUtils\";\r\nexport { isTypeof, isUndefined, isNullOrUndefined, hasOwnProperty, isObject, isFunction, normalizeJsName, objForEachKey, strEndsWith, strStartsWith, isDate, isArray, isError, isString, isNumber, isBoolean, toISOString, arrForEach, arrIndexOf, arrMap, arrReduce, strTrim, objKeys, objDefineAccessors, dateNow, getExceptionName, throwError, strContains, isSymbol, setValue, getSetValue, isNotTruthy, isTruthy, proxyAssign, proxyFunctions, proxyFunctionAs, createClassFromInterface, optimizeObject, isNotUndefined, isNotNullOrUndefined, objFreeze, objSeal, objExtend, objToString, deepFreeze } from \"./JavaScriptSDK/HelperFuncs\";\r\nexport { createEnumStyle, createEnumMap, createValueMap } from \"./JavaScriptSDK.Enums/EnumHelperFuncs\";\r\nexport { attachEvent, detachEvent, addEventHandler, addEventListeners, addPageUnloadEventListener, addPageHideEventListener, addPageShowEventListener, removeEventHandler, removeEventListeners, removePageUnloadEventListener, removePageHideEventListener, removePageShowEventListener, eventOn, eventOff, mergeEvtNamespace, __getRegisteredEvents } from \"./JavaScriptSDK/EventHelpers\";\r\nexport { getGlobalInst, hasWindow, getWindow, hasDocument, getDocument, getCrypto, getMsCrypto, hasNavigator, getNavigator, hasHistory, getHistory, getLocation, getPerformance, hasJSON, getJSON, isReactNative, getConsole, dumpObj, isIE, getIEVersion, isSafari, setEnableEnvMocks, isBeaconsSupported, isFetchSupported, useXDomainRequest, isXhrSupported, findMetaTag, findNamedServerTiming } from \"./JavaScriptSDK/EnvUtils\";\r\nexport { getGlobal, objCreateFn as objCreate, strShimPrototype as strPrototype, strShimFunction as strFunction, strShimUndefined as strUndefined, strShimObject as strObject } from \"@microsoft/applicationinsights-shims\";\r\nexport { NotificationManager } from \"./JavaScriptSDK/NotificationManager\";\r\nexport { PerfEvent, PerfManager, doPerf, getGblPerfMgr, setGblPerfMgr } from \"./JavaScriptSDK/PerfManager\";\r\nexport { safeGetLogger, DiagnosticLogger, _InternalLogMessage, _throwInternal, _warnToConsole, _logInternalMessage } from \"./JavaScriptSDK/DiagnosticLogger\";\r\nexport { ProcessTelemetryContext, createProcessTelemetryContext\r\n// Explicitly NOT exporting createProcessTelemetryUnloadContext() and createProcessTelemetryUpdateContext() as these should only be created internally\r\n } from \"./JavaScriptSDK/ProcessTelemetryContext\";\r\nexport { initializePlugins, sortPlugins, unloadComponents } from \"./JavaScriptSDK/TelemetryHelpers\";\r\nexport { _InternalMessageId, LoggingSeverity } from \"./JavaScriptSDK.Enums/LoggingEnums\";\r\nexport { InstrumentProto, InstrumentProtos, InstrumentFunc, InstrumentFuncs, InstrumentEvent } from \"./JavaScriptSDK/InstrumentHooks\";\r\nexport { createCookieMgr, safeGetCookieMgr, uaDisallowsSameSiteNone, areCookiesSupported } from \"./JavaScriptSDK/CookieMgr\";\r\nexport { getDebugListener, getDebugExt } from \"./JavaScriptSDK/DbgExtensionUtils\";\r\nexport { createUniqueNamespace } from \"./JavaScriptSDK/DataCacheHelper\";\r\nexport { createUnloadHandlerContainer } from \"./JavaScriptSDK/UnloadHandlerContainer\";\r\nexport { createTraceParent, parseTraceParent, isValidTraceId, isValidSpanId, isValidTraceParent, isSampledFlag, formatTraceParent, findW3cTraceParent } from \"./JavaScriptSDK/W3cTraceParent\";\r\n//# sourceMappingURL=applicationinsights-core-js.js.map"],"names":[],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@microsoft/applicationinsights-core-js",
     "author": "Microsoft Application Insights Team",
-    "version": "2.8.4-nightly.2205-07",
+    "version": "2.8.4-nightly.2205-10",
     "description": "Microsoft Application Insights Core Javascript SDK",
     "homepage": "https://github.com/microsoft/ApplicationInsights-JS#readme",
     "keywords": [
@@ -39,7 +39,7 @@
         "@microsoft/applicationinsights-rollup-plugin-uglify3-js": "1.0.0",
         "@microsoft/applicationinsights-rollup-es3": "1.1.3",
         "@microsoft/api-extractor": "^7.18.1",
-        "grunt": "^1.4.1",
+        "grunt": "^1.5.3",
         "grunt-cli": "^1.4.3",
         "grunt-contrib-qunit": "^5.0.1",
         "@nevware21/grunt-ts-plugin": "^0.4.3",

package/src/JavaScriptSDK/BaseCore.ts

@@ -14,7 +14,7 @@ import { INotificationListener } from "../JavaScriptSDK.Interfaces/INotification
 import { IDiagnosticLogger } from "../JavaScriptSDK.Interfaces/IDiagnosticLogger";
 import { IProcessTelemetryContext, IProcessTelemetryUpdateContext } from "../JavaScriptSDK.Interfaces/IProcessTelemetryContext";
 import { createProcessTelemetryContext, createProcessTelemetryUnloadContext, createProcessTelemetryUpdateContext, createTelemetryProxyChain } from "./ProcessTelemetryContext";
-import { initializePlugins, sortPlugins, _getPluginState } from "./TelemetryHelpers";
+import { createDistributedTraceContext, initializePlugins, sortPlugins, _getPluginState } from "./TelemetryHelpers";
 import { eLoggingSeverity, _eInternalMessageId } from "../JavaScriptSDK.Enums/LoggingEnums";
 import { IPerfManager } from "../JavaScriptSDK.Interfaces/IPerfManager";
 import { getGblPerfMgr, PerfManager } from "./PerfManager";
@@ -40,6 +40,7 @@ import { ITelemetryUnloadState } from "../JavaScriptSDK.Interfaces/ITelemetryUnl
 import { TelemetryUnloadReason } from "../JavaScriptSDK.Enums/TelemetryUnloadReason";
 import { SendRequestReason } from "../JavaScriptSDK.Enums/SendRequestReason";
 import { strAddNotificationListener, strDisabled, strEventsDiscarded, strEventsSendRequest, strEventsSent, strRemoveNotificationListener, strTeardown } from "./InternalConstants";
+import { IDistributedTraceContext } from "../JavaScriptSDK.Interfaces/IDistributedTraceContext";
 
 const strValidationError = "Plugins must provide initialize method";
 const strNotificationManager = "_notificationManager";
@@ -151,6 +152,7 @@ export class BaseCore implements IAppInsightsCore {
         let _evtNamespace: string;
         let _unloadHandlers: IUnloadHandlerContainer;
         let _debugListener: INotificationListener | null;
+        let _traceCtx: IDistributedTraceContext | null;
 
         /**
          * Internal log poller
@@ -453,6 +455,18 @@ export class BaseCore implements IAppInsightsCore {
 
             _self.flush = _flushChannels;
         
+            _self.getTraceCtx = (createNew?: boolean): IDistributedTraceContext | null => {
+                if (!_traceCtx) {
+                    _traceCtx = createDistributedTraceContext();
+                }
+
+                return _traceCtx;
+            };
+
+            _self.setTraceCtx = (traceCtx: IDistributedTraceContext): void => {
+                _traceCtx = traceCtx || null;
+            };
+
             // Create the addUnloadCb
             proxyFunctionAs(_self, "addUnloadCb", () => _unloadHandlers, "add");
 
@@ -480,6 +494,7 @@ export class BaseCore implements IAppInsightsCore {
                 _internalLogsEventName = null;
                 _evtNamespace = createUniqueNamespace("AIBaseCore", true);
                 _unloadHandlers = createUnloadHandlerContainer();
+                _traceCtx = null;
             }
 
             function _createTelCtx(): IProcessTelemetryContext {
@@ -886,6 +901,22 @@ export class BaseCore implements IAppInsightsCore {
     public flush(isAsync?: boolean, callBack?: (flushComplete?: boolean) => void, sendReason?: SendRequestReason): void {
         // @DynamicProtoStub -- DO NOT add any code as this will be removed during packaging
     }
+    
+    /**
+     * Gets the current distributed trace context for this instance if available
+     * @param createNew - Optional flag to create a new instance if one doesn't currently exist, defaults to true
+     */
+    public getTraceCtx(createNew?: boolean): IDistributedTraceContext | null {
+        // @DynamicProtoStub -- DO NOT add any code as this will be removed during packaging
+        return null;
+    }
+
+    /**
+     * Sets the current distributed trace context for this instance if available
+     */
+    public setTraceCtx(newTracectx: IDistributedTraceContext): void {
+        // @DynamicProtoStub -- DO NOT add any code as this will be removed during packaging
+    }
 
     protected releaseQueue() {
         // @DynamicProtoStub -- DO NOT add any code as this will be removed during packaging

package/src/JavaScriptSDK/DataCacheHelper.ts

@@ -7,7 +7,7 @@ import { newId } from "./RandomHelper";
 
 const _objDefineProperty = ObjDefineProperty;
 
-const version = "2.8.4-nightly.2205-07";
+const version = "2.8.4-nightly.2205-10";
 let instanceName = "." + newId(6);
 let _dataUid = 0;
 

package/src/JavaScriptSDK/EnvUtils.ts

@@ -411,3 +411,48 @@ export function isXhrSupported(): boolean {
 
     return isSupported;
 }
+
+function _getNamedValue(values: any, name: string) {
+    if (values) {
+        for (var i = 0; i < values.length; i++) {
+            var value = values[i] as any;
+            if (value.name) {
+                if(value.name === name) {
+                    return value;
+                }
+            }
+        }
+    }
+
+    return {};
+}
+
+/**
+ * Helper function to fetch the named meta-tag from the page.
+ * @param name
+ */
+export function findMetaTag(name: string): any {
+    let doc = getDocument();
+    if (doc && name) {
+        // Look for a meta-tag
+        return _getNamedValue(doc.querySelectorAll("meta"), name).content;
+    }
+
+    return null;
+}
+
+/**
+ * Helper function to fetch the named server timing value from the page response (first navigation event).
+ * @param name
+ */
+export function findNamedServerTiming(name: string): any {
+    let value: any;
+    let perf = getPerformance();
+    if (perf) {
+        // Try looking for a server-timing header
+        let navPerf = perf.getEntriesByType("navigation") || [];
+        value = _getNamedValue((navPerf.length > 0 ? navPerf[0] : {} as any).serverTiming, name).description;
+    }
+
+    return value;
+}

package/src/JavaScriptSDK/TelemetryHelpers.ts

@@ -11,6 +11,9 @@ import { createElmNodeData } from "./DataCacheHelper";
 import { IAppInsightsCore } from "../JavaScriptSDK.Interfaces/IAppInsightsCore";
 import { IUnloadableComponent } from "../JavaScriptSDK.Interfaces/IUnloadableComponent";
 import { ITelemetryUnloadState } from "../JavaScriptSDK.Interfaces/ITelemetryUnloadState";
+import { IDistributedTraceContext } from "../JavaScriptSDK.Interfaces/IDistributedTraceContext";
+import { ITraceParent } from "../JavaScriptSDK.Interfaces/ITraceParent";
+import { isValidSpanId, isValidTraceId } from "./W3cTraceParent";
 
 const strDoUnload = "_doUnload";
 export interface IPluginState {
@@ -93,11 +96,15 @@ export function sortPlugins<T = IPlugin>(plugins:T[]) {
     // Sort by priority
     return plugins.sort((extA, extB) => {
         let result = 0;
-        let bHasProcess = isFunction(extB[strProcessTelemetry]);
-        if (isFunction(extA[strProcessTelemetry])) {
-            result = bHasProcess ? extA[strPriority] - extB[strPriority] : 1;
-        } else if (bHasProcess) {
-            result = -1;
+        if (extB) {
+            let bHasProcess = isFunction(extB[strProcessTelemetry]);
+            if (isFunction(extA[strProcessTelemetry])) {
+                result = bHasProcess ? extA[strPriority] - extB[strPriority] : 1;
+            } else if (bHasProcess) {
+                result = -1;
+            }
+        } else {
+            result = extA ? 1 : -1;
         }
 
         return result;
@@ -132,4 +139,49 @@ export function unloadComponents(components: any | IUnloadableComponent[], unloa
     }
 
     return _doUnload();
+}
+
+
+/**
+ * Creates a IDistributedTraceContext which optionally also "sets" the value on a parent
+ * @param parentCtx - An optional parent distributed trace instance
+ * @returns A new IDistributedTraceContext instance that uses an internal temporary object
+ */
+export function createDistributedTraceContext(parentCtx?: IDistributedTraceContext): IDistributedTraceContext {
+    let trace: ITraceParent = {} as ITraceParent;
+
+    return {
+        getName: (): string => {
+            return (trace as any).name;
+        },
+        setName: (newValue: string): void => {
+            parentCtx && parentCtx.setName(newValue);
+            (trace as any).name = newValue;
+        },
+        getTraceId: (): string => {
+            return trace.traceId;
+        },
+        setTraceId: (newValue: string): void => {
+            parentCtx && parentCtx.setTraceId(newValue);
+            if (isValidTraceId(newValue)) {
+                trace.traceId = newValue
+            }
+        },
+        getSpanId: (): string => {
+            return trace.spanId;
+        },
+        setSpanId: (newValue: string): void => {
+            parentCtx && parentCtx.setSpanId(newValue);
+            if (isValidSpanId(newValue)) {
+                trace.spanId = newValue
+            }
+        },
+        getTraceFlags: (): number => {
+            return trace.traceFlags;
+        },
+        setTraceFlags: (newTraceFlags?: number): void => {
+            parentCtx && parentCtx.setTraceFlags(newTraceFlags);
+            trace.traceFlags = newTraceFlags
+        }
+    };
 }

package/src/JavaScriptSDK/W3cTraceParent.ts

@@ -0,0 +1,196 @@
+import { ITraceParent } from "../JavaScriptSDK.Interfaces/ITraceParent";
+import { generateW3CId } from "./CoreUtils";
+import { findMetaTag, findNamedServerTiming } from "./EnvUtils";
+import { isArray, isString, strTrim } from "./HelperFuncs";
+
+// using {0,16} for leading and trailing whitespace just to constrain the possible runtime of a random string
+const TRACE_PARENT_REGEX = /^([\da-f]{2})-([\da-f]{32})-([\da-f]{16})-([\da-f]{2})(-[^\s]*)?$/;
+const DEFAULT_VERSION = "00";
+const INVALID_VERSION = "ff";
+const INVALID_TRACE_ID = "00000000000000000000000000000000";
+const INVALID_SPAN_ID = "0000000000000000";
+const SAMPLED_FLAG = 0x01;
+
+function _isValid(value: string, len: number, invalidValue?: string): boolean {
+    if (value && value.length === len && value !== invalidValue) {
+        return !!value.match(/^[\da-f]*$/);
+    }
+
+    return false;
+}
+
+function _formatValue(value: string, len: number, defValue: string): string {
+    if (_isValid(value, len)) {
+        return value;
+    }
+
+    return defValue;
+}
+
+function _formatFlags(value: number): string {
+    if (isNaN(value) || value < 0 || value > 255) {
+        value = 0x01;
+    }
+
+    let result = value.toString(16);
+    while (result.length < 2) {
+        result = "0" + result;
+    }
+
+    return result;
+}
+
+/**
+ * Create a new ITraceParent instance using the provided values.
+ * @param traceId - The traceId to use, when invalid a new random W3C id will be generated.
+ * @param spanId - The parent/span id to use, a new random value will be generated if it is invalid.
+ * @param flags - The traceFlags to use, defaults to zero (0) if not supplied or invalid
+ * @param version - The version to used, defaults to version "01" if not supplied or invalid.
+ * @returns
+ */
+export function createTraceParent(traceId?: string, spanId?: string, flags?: number, version?: string): ITraceParent {
+
+    return {
+        version: _isValid(version, 2, INVALID_VERSION) ? version : DEFAULT_VERSION,
+        traceId: isValidTraceId(traceId) ? traceId : generateW3CId(),
+        spanId: isValidSpanId(spanId) ? spanId : generateW3CId().substr(0, 16),
+        traceFlags: flags >= 0 && flags <= 0xFF ? flags : 1
+    };
+}
+
+/**
+ * Attempt to parse the provided string as a W3C TraceParent header value (https://www.w3.org/TR/trace-context/#traceparent-header)
+ *
+ * @param value
+ * @returns
+ */
+export function parseTraceParent(value: string): ITraceParent {
+    if (!value) {
+        // Don't pass a null/undefined or empty string
+        return null;
+    }
+
+    if (isArray(value)) {
+        // The value may have been encoded on the page into an array so handle this automatically
+        value = value[0] || "";
+    }
+
+    if (!value || !isString(value) || value.length > 8192) {
+        // limit potential processing based on total length
+        return null;
+    }
+
+    // See https://www.w3.org/TR/trace-context/#versioning-of-traceparent
+    const match = TRACE_PARENT_REGEX.exec(strTrim(value));
+    if (!match ||                               // No match
+            match[1] === INVALID_VERSION ||     // version ff is forbidden
+            match[2] === INVALID_TRACE_ID ||    // All zeros is considered to be invalid
+            match[3] === INVALID_SPAN_ID) {     // All zeros is considered to be invalid
+        return null;
+    }
+
+    return {
+        version: match[1],
+        traceId: match[2],
+        spanId: match[3],
+        traceFlags: parseInt(match[4], 16)
+    }
+}
+
+/**
+ * Is the provided W3c Trace Id a valid string representation, it must be a 32-character string
+ * of lowercase hexadecimal characters for example, 4bf92f3577b34da6a3ce929d0e0e4736.
+ * If all characters as zero (00000000000000000000000000000000) it will be considered an invalid value.
+ * @param value - The W3c trace Id to be validated
+ * @returns true if valid otherwise false
+ */
+export function isValidTraceId(value: string): boolean {
+    return _isValid(value, 32, INVALID_TRACE_ID);
+}
+
+/**
+ * Is the provided W3c span id (aka. parent id) a valid string representation, it must be a 16-character
+ * string of lowercase hexadecimal characters, for example, 00f067aa0ba902b7.
+ * If all characters are zero (0000000000000000) this is considered an invalid value.
+ * @param value - The W3c span id to be validated
+ * @returns true if valid otherwise false
+ */
+export function isValidSpanId(value: string): boolean {
+    return _isValid(value, 16, INVALID_SPAN_ID);
+}
+
+/**
+ * Validates that the provided ITraceParent instance conforms to the currently supported specifications
+ * @param value
+ * @returns
+ */
+export function isValidTraceParent(value: ITraceParent) {
+    if (!value ||
+            !_isValid(value.version, 2, INVALID_VERSION) ||
+            !_isValid(value.traceId, 32, INVALID_TRACE_ID) ||
+            !_isValid(value.spanId, 16, INVALID_SPAN_ID) ||
+            !_isValid(_formatFlags(value.traceFlags), 2)) {
+
+        // Each known field must contain a valid value
+        return false;
+    }
+
+    return true;
+}
+
+/**
+ * Is the parsed traceParent indicating that the trace is currently sampled.
+ * @param value - The parsed traceParent value
+ * @returns
+ */
+export function isSampledFlag(value: ITraceParent) {
+    if (isValidTraceParent(value)) {
+        return (value.traceFlags & SAMPLED_FLAG) === SAMPLED_FLAG;
+    }
+
+    return false;
+}
+
+/**
+ * Format the ITraceParent value as a string using the supported and know version formats.
+ * So even if the passed traceParent is a later version the string value returned from this
+ * function will convert it to only the known version formats.
+ * This currently only supports version "00" and invalid "ff"
+ * @param value - The parsed traceParent value
+ * @returns
+ */
+export function formatTraceParent(value: ITraceParent) {
+    if (value) {
+        // Special Note: This only supports formatting as version 00, future versions should encode any known supported version
+        // So parsing a future version will populate the correct version value but reformatting will reduce it to version 00.
+        let flags = _formatFlags(value.traceFlags);
+        if (!_isValid(flags, 2)) {
+            flags = "01";
+        }
+
+        let version = value.version || DEFAULT_VERSION;
+        if (version !== "00" && version !== "ff") {
+            // Reduce version to "00"
+            version = DEFAULT_VERSION;
+        }
+
+        // Format as version 00
+        return `${version}-${_formatValue(value.traceId, 32, INVALID_TRACE_ID)}-${_formatValue(value.spanId, 16, INVALID_SPAN_ID)}-${flags}`;
+    }
+
+    return "";
+}
+
+/**
+ * Helper function to fetch the passed traceparent from the page, looking for it as a meta-tag or a Server-Timing header.
+ * @returns
+ */
+export function findW3cTraceParent(): ITraceParent {
+    const name = "traceparent";
+    let traceParent: ITraceParent = parseTraceParent(findMetaTag(name));
+    if (!traceParent) {
+        traceParent = parseTraceParent(findNamedServerTiming(name))
+    }
+
+    return traceParent;
+}

package/src/JavaScriptSDK.Interfaces/IAppInsightsCore.ts

@@ -14,6 +14,7 @@ import { ITelemetryInitializerHandler, TelemetryInitializerFunction } from "./IT
 import { ITelemetryUnloadState } from "./ITelemetryUnloadState";
 import { UnloadHandler } from "../JavaScriptSDK/UnloadHandlerContainer";
 import { SendRequestReason } from "../JavaScriptSDK.Enums/SendRequestReason";
+import { IDistributedTraceContext } from "./IDistributedTraceContext";
 
 export interface ILoadedPlugin<T extends IPlugin> {
     plugin: T;
@@ -160,4 +161,15 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
      * @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(isAsync?: boolean, callBack?: (flushComplete?: boolean) => void, sendReason?: SendRequestReason, cbTimeout?: number): boolean | void;
+
+    /**
+     * Gets the current distributed trace context for this instance if available
+     * @param createNew - Optional flag to create a new instance if one doesn't currently exist, defaults to true
+     */
+    getTraceCtx(createNew?: boolean): IDistributedTraceContext | null;
+
+    /**
+     * Sets the current distributed trace context for this instance if available
+     */
+    setTraceCtx(newTraceCtx: IDistributedTraceContext | null | undefined): void;
 }

package/src/JavaScriptSDK.Interfaces/IDistributedTraceContext.ts

@@ -0,0 +1,54 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+export interface IDistributedTraceContext {
+
+    /**
+     * Returns the current name of the page
+     */
+    getName(): string;
+
+    /**
+     * Sets the current name of the page
+     * @param pageName
+     */
+    setName(pageName: string): void;
+
+    /**
+     * Returns the unique identifier for a trace. All requests / spans from the same trace share the same traceId.
+     * Must be read from incoming headers or generated according to the W3C TraceContext specification,
+     * in a hex representation of 16-byte array. A.k.a. trace-id, TraceID or Distributed TraceID
+     */
+    getTraceId(): string;
+
+    /**
+     * Set the unique identifier for a trace. All requests / spans from the same trace share the same traceId.
+     * Must be conform to the W3C TraceContext specification, in a hex representation of 16-byte array.
+     * A.k.a. trace-id, TraceID or Distributed TraceID https://www.w3.org/TR/trace-context/#trace-id
+     */
+    setTraceId(newValue: string): void;
+
+    /**
+     * Self-generated 8-bytes identifier of the incoming request. Must be a hex representation of 8-byte array.
+     * Also know as the parentId, used to link requests together
+     */
+    getSpanId(): string;
+
+    /**
+     * Self-generated 8-bytes identifier of the incoming request. Must be a hex representation of 8-byte array.
+     * Also know as the parentId, used to link requests together
+     * https://www.w3.org/TR/trace-context/#parent-id
+     */
+    setSpanId(newValue: string): void;
+
+    /**
+     * An integer representation of the W3C TraceContext trace-flags.
+     */
+    getTraceFlags(): number | undefined;
+
+    /**
+     * https://www.w3.org/TR/trace-context/#trace-flags
+     * @param newValue
+     */
+    setTraceFlags(newValue?: number): void;
+}