@microsoft/applicationinsights-core-js 3.0.0-beta.2209-03 → 3.0.0-beta.2210-02

package/src/JavaScriptSDK/ProcessTelemetryContext.ts

@@ -2,15 +2,17 @@
 // Licensed under the MIT License.
 "use strict";
 
-import {
-    arrForEach, dumpObj, isArray, isFunction, isNullOrUndefined, isObject, isUndefined, objForEachKey, objFreeze, objKeys
-} from "@nevware21/ts-utils";
+import { arrForEach, dumpObj, isArray, isFunction, isNullOrUndefined, isUndefined, objFreeze, objKeys } from "@nevware21/ts-utils";
+import { _applyDefaultValue, applyDefaults } from "../Config/ConfigDefaults";
+import { createDynamicConfig } from "../Config/DynamicConfig";
+import { IConfigDefaults } from "../Config/IConfigDefaults";
+import { IDynamicConfigHandler } from "../Config/IDynamicConfigHandler";
 import { _eInternalMessageId, eLoggingSeverity } from "../JavaScriptSDK.Enums/LoggingEnums";
 import { IAppInsightsCore } from "../JavaScriptSDK.Interfaces/IAppInsightsCore";
 import { IConfiguration } from "../JavaScriptSDK.Interfaces/IConfiguration";
 import { IDiagnosticLogger } from "../JavaScriptSDK.Interfaces/IDiagnosticLogger";
 import {
-    GetExtCfgMergeType, IBaseProcessingContext, IProcessTelemetryContext, IProcessTelemetryUnloadContext, IProcessTelemetryUpdateContext
+    IBaseProcessingContext, IProcessTelemetryContext, IProcessTelemetryUnloadContext, IProcessTelemetryUpdateContext
 } from "../JavaScriptSDK.Interfaces/IProcessTelemetryContext";
 import { ITelemetryItem } from "../JavaScriptSDK.Interfaces/ITelemetryItem";
 import { IPlugin, ITelemetryPlugin } from "../JavaScriptSDK.Interfaces/ITelemetryPlugin";
@@ -18,7 +20,7 @@ import { ITelemetryPluginChain } from "../JavaScriptSDK.Interfaces/ITelemetryPlu
 import { ITelemetryUnloadState } from "../JavaScriptSDK.Interfaces/ITelemetryUnloadState";
 import { ITelemetryUpdateState } from "../JavaScriptSDK.Interfaces/ITelemetryUpdateState";
 import { _throwInternal, safeGetLogger } from "./DiagnosticLogger";
-import { objExtend, proxyFunctions } from "./HelperFuncs";
+import { objForEachKey, proxyFunctions } from "./HelperFuncs";
 import { STR_CORE, STR_DISABLED, STR_EMPTY } from "./InternalConstants";
 import { doPerf } from "./PerfManager";
 import { _getPluginState } from "./TelemetryHelpers";
@@ -47,7 +49,7 @@ interface IInternalContext<T extends IBaseProcessingContext> {
     ctx: T
 }
 
-function _getNextProxyStart<T, C = IConfiguration>(proxy: ITelemetryPluginChain, core: IAppInsightsCore, startAt: IPlugin): ITelemetryPluginChain {
+function _getNextProxyStart(proxy: ITelemetryPluginChain, core: IAppInsightsCore, startAt: IPlugin): ITelemetryPluginChain {
     while (proxy) {
         if (proxy.getPlugin() === startAt) {
             return proxy;
@@ -63,17 +65,21 @@ function _getNextProxyStart<T, C = IConfiguration>(proxy: ITelemetryPluginChain,
 /**
  * @ignore
  * @param telemetryChain
- * @param config
+ * @param dynamicConfig
  * @param core
  * @param startAt - Identifies the next plugin to execute, if null there is no "next" plugin and if undefined it should assume the start of the chain
  * @returns
  */
-function _createInternalContext<T extends IBaseProcessingContext>(telemetryChain: ITelemetryPluginChain, config: IConfiguration, core: IAppInsightsCore, startAt?: IPlugin): IInternalContext<T> {
+function _createInternalContext<T extends IBaseProcessingContext>(telemetryChain: ITelemetryPluginChain, dynamicConfig: IDynamicConfigHandler<IConfiguration>, core: IAppInsightsCore, startAt?: IPlugin): IInternalContext<T> {
     // We have a special case where we want to start execution from this specific plugin
     // or we simply reuse the existing telemetry plugin chain (normal execution case)
     let _nextProxy: ITelemetryPluginChain | null = null;  // By Default set as no next plugin
     let _onComplete: OnCompleteCallback[] = [];
 
+    if (!dynamicConfig) {
+        dynamicConfig = createDynamicConfig({}, null, core.logger);
+    }
+
     if (startAt !== null) {
         // There is no next element (null) vs not defined (undefined) so use the full chain
         _nextProxy = startAt ? _getNextProxyStart(telemetryChain, core, startAt) : telemetryChain;
@@ -86,12 +92,12 @@ function _createInternalContext<T extends IBaseProcessingContext>(telemetryChain
                 return core
             },
             diagLog: () => {
-                return safeGetLogger(core, config);
+                return safeGetLogger(core, dynamicConfig.cfg);
             },
             getCfg: () => {
-                return config;
+                return dynamicConfig.cfg;
             },
-            getExtCfg: _getExtCfg,
+            getExtCfg: _resolveExtCfg,
             getConfig: _getConfig,
             hasNext: () => {
                 return !!_nextProxy;
@@ -145,54 +151,61 @@ function _createInternalContext<T extends IBaseProcessingContext>(telemetryChain
         return nextProxy;
     }
 
-    function _getExtCfg<T>(identifier: string, defaultValue: T|any = {}, mergeDefault: GetExtCfgMergeType = GetExtCfgMergeType.None) {
-        let theConfig: T;
-        if (config) {
-            let extConfig = config.extensionConfig;
-            if (extConfig && identifier) {
-                theConfig = extConfig[identifier];
+    function _getExtCfg<T>(identifier: string, createIfMissing: boolean) {
+        let idCfg: T = null;
+        if (dynamicConfig.cfg && identifier) {
+            let extCfg = dynamicConfig.cfg.extensionConfig;
+            if (!extCfg && createIfMissing) {
+                dynamicConfig.set(dynamicConfig.cfg, "extensionConfig", {});
+                extCfg = dynamicConfig.cfg.extensionConfig;
+            }
+            
+            if (extCfg) {
+                idCfg = extCfg[identifier];
+                if (!idCfg && createIfMissing) {
+                    dynamicConfig.set(extCfg, identifier, {});
+                    idCfg = extCfg[identifier];
+                }
             }
         }
 
-        if (!theConfig) {
-            // Just use the defaults
-            theConfig = defaultValue as T;
-        } else if (isObject(defaultValue)) {
-            if (mergeDefault !== GetExtCfgMergeType.None) {
-                // Merge the defaults and configured values
-                let newConfig = objExtend(true, defaultValue, theConfig);
-
-                if (config && mergeDefault === GetExtCfgMergeType.MergeDefaultFromRootOrDefault) {
-                    // Enumerate over the defaultValues and if not already populated attempt to
-                    // find a value from the root config
-                    objForEachKey(defaultValue, (field) => {
-                        // for each unspecified field, set the default value
-                        if (isNullOrUndefined(newConfig[field])) {
-                            let cfgValue = config[field];
-                            if (!isNullOrUndefined(cfgValue)) {
-                                newConfig[field] = cfgValue;
-                            }
-                        }
-                    });
+        return idCfg;
+    }
+
+    function _resolveExtCfg<T>(identifier: string, defaultValues: IConfigDefaults<T>): T {
+        let newConfig: T = _getExtCfg(identifier, true);
+
+        if (defaultValues) {
+            // Enumerate over the defaultValues and if not already populated attempt to
+            // find a value from the root config or use the default value
+            objForEachKey(defaultValues, (field, defaultValue) => {
+                // for each unspecified field, set the default value
+                if (isNullOrUndefined(newConfig[field])) {
+                    let cfgValue = dynamicConfig.cfg[field];
+                    if (cfgValue || !isNullOrUndefined(cfgValue)) {
+                        newConfig[field] = cfgValue;
+                    }
                 }
 
-                theConfig = newConfig;
-            }
+                _applyDefaultValue(newConfig, field, defaultValue);
+            });
         }
 
-        return theConfig;
+        return applyDefaults(newConfig, defaultValues);
     }
 
     function _getConfig(identifier:string, field: string, defaultValue: number | string | boolean | string[] | RegExp[] | Function = false) {
         let theValue;
-        let extConfig = _getExtCfg(identifier, null);
-        if (extConfig && !isNullOrUndefined(extConfig[field])) {
+        let extConfig: T = _getExtCfg(identifier, false);
+        let rootConfig = dynamicConfig.cfg;
+
+        if (extConfig && (extConfig[field] || !isNullOrUndefined(extConfig[field]))) {
             theValue = extConfig[field];
-        } else if (config && !isNullOrUndefined(config[field])) {
-            theValue = config[field];
+        } else if (rootConfig[field] || !isNullOrUndefined(rootConfig[field])) {
+            theValue = rootConfig[field];
         }
 
-        return !isNullOrUndefined(theValue) ? theValue : defaultValue;
+        return (theValue || !isNullOrUndefined(theValue)) ? theValue : defaultValue;
     }
 
     function _iterateChain<T extends ITelemetryPlugin = ITelemetryPlugin>(cb: (plugin: T) => void) {
@@ -217,24 +230,28 @@ function _createInternalContext<T extends IBaseProcessingContext>(telemetryChain
  * @param core - The current core instance
  * @param startAt - Identifies the next plugin to execute, if null there is no "next" plugin and if undefined it should assume the start of the chain
  */
-export function createProcessTelemetryContext(telemetryChain: ITelemetryPluginChain | null, config: IConfiguration, core:IAppInsightsCore, startAt?: IPlugin): IProcessTelemetryContext {
+export function createProcessTelemetryContext(telemetryChain: ITelemetryPluginChain | null, cfg: IConfiguration, core:IAppInsightsCore, startAt?: IPlugin): IProcessTelemetryContext {
+    let config = createDynamicConfig(cfg);
     let internalContext: IInternalContext<IProcessTelemetryContext> = _createInternalContext<IProcessTelemetryContext>(telemetryChain, config, core, startAt);
     let context = internalContext.ctx;
 
     function _processNext(env: ITelemetryItem) {
         let nextPlugin: ITelemetryPluginChain = internalContext._next();
-        // Run the next plugin which will call "processNext()"
-        nextPlugin && nextPlugin.processTelemetry(env, context);
+
+        if (nextPlugin) {
+            // Run the next plugin which will call "processNext()"
+            nextPlugin.processTelemetry(env, context);
+        }
 
         return !nextPlugin;
     }
 
     function _createNew(plugins: IPlugin[] | ITelemetryPluginChain | null = null, startAt?: IPlugin) {
         if (isArray(plugins)) {
-            plugins = createTelemetryProxyChain(plugins, config, core, startAt);
+            plugins = createTelemetryProxyChain(plugins, config.cfg, core, startAt);
         }
 
-        return createProcessTelemetryContext(plugins || context.getNext(), config, core, startAt);
+        return createProcessTelemetryContext(plugins || context.getNext(), config.cfg, core, startAt);
     }
 
     context.processNext = _processNext;
@@ -251,7 +268,7 @@ export function createProcessTelemetryContext(telemetryChain: ITelemetryPluginCh
  * @param startAt - Identifies the next plugin to execute, if null there is no "next" plugin and if undefined it should assume the start of the chain
  */
 export function createProcessTelemetryUnloadContext(telemetryChain: ITelemetryPluginChain, core: IAppInsightsCore, startAt?: IPlugin): IProcessTelemetryUnloadContext {
-    let config = core.config || {};
+    let config = createDynamicConfig(core.config);
     let internalContext: IInternalContext<IProcessTelemetryUnloadContext> = _createInternalContext<IProcessTelemetryUnloadContext>(telemetryChain, config, core, startAt);
     let context = internalContext.ctx;
 
@@ -264,7 +281,7 @@ export function createProcessTelemetryUnloadContext(telemetryChain: ITelemetryPl
 
     function _createNew(plugins: IPlugin[] | ITelemetryPluginChain = null, startAt?: IPlugin): IProcessTelemetryUnloadContext {
         if (isArray(plugins)) {
-            plugins = createTelemetryProxyChain(plugins, config, core, startAt);
+            plugins = createTelemetryProxyChain(plugins, config.cfg, core, startAt);
         }
 
         return createProcessTelemetryUnloadContext(plugins || context.getNext(), core, startAt);
@@ -284,7 +301,7 @@ export function createProcessTelemetryUnloadContext(telemetryChain: ITelemetryPl
  * @param startAt - Identifies the next plugin to execute, if null there is no "next" plugin and if undefined it should assume the start of the chain
  */
 export function createProcessTelemetryUpdateContext(telemetryChain: ITelemetryPluginChain, core: IAppInsightsCore, startAt?: IPlugin): IProcessTelemetryUpdateContext {
-    let config = core.config || {};
+    let config = createDynamicConfig(core.config);
     let internalContext: IInternalContext<IProcessTelemetryUpdateContext> = _createInternalContext<IProcessTelemetryUpdateContext>(telemetryChain, config, core, startAt);
     let context = internalContext.ctx;
 
@@ -298,7 +315,7 @@ export function createProcessTelemetryUpdateContext(telemetryChain: ITelemetryPl
 
     function _createNew(plugins: IPlugin[] | ITelemetryPluginChain = null, startAt?: IPlugin) {
         if (isArray(plugins)) {
-            plugins = createTelemetryProxyChain(plugins, config, core, startAt);
+            plugins = createTelemetryProxyChain(plugins, config.cfg, core, startAt);
         }
 
         return createProcessTelemetryUpdateContext(plugins || context.getNext(), core, startAt);
@@ -568,8 +585,8 @@ export class ProcessTelemetryContext implements IProcessTelemetryContext {
      */
     public getCfg: () => IConfiguration;
 
-    public getExtCfg: <T>(identifier:string, defaultValue?:T|any) => T;
-                        
+    public getExtCfg: <T>(identifier:string, defaultValue?: IConfigDefaults<T>) => T;
+
     public getConfig: (identifier:string, field: string, defaultValue?: number | string | boolean | string[] | RegExp[] | Function) => number | string | boolean | string[] | RegExp[] | Function;
 
     /**

package/src/JavaScriptSDK/TelemetryHelpers.ts

@@ -31,9 +31,9 @@ export function _getPluginState(plugin: IPlugin): IPluginState {
 /**
  * Initialize the queue of plugins
  * @param plugins - The array of plugins to initialize and setting of the next plugin
- * @param config The current config for the instance
- * @param core THe current core instance
- * @param extensions The extensions
+ * @param config - The current config for the instance
+ * @param core - THe current core instance
+ * @param extensions - The extensions
  */
 export function initializePlugins(processContext: IProcessTelemetryContext, extensions: IPlugin[]) {
 
@@ -42,12 +42,11 @@ export function initializePlugins(processContext: IProcessTelemetryContext, exte
     let lastPlugin: ITelemetryPlugin = null;
     let proxy: ITelemetryPluginChain = processContext.getNext();
     let pluginState: IPluginState;
+
     while (proxy) {
         let thePlugin = proxy.getPlugin();
         if (thePlugin) {
-            if (lastPlugin &&
-                    isFunction(lastPlugin.setNextPlugin) &&
-                    isFunction(thePlugin.processTelemetry)) {
+            if (lastPlugin && lastPlugin.setNextPlugin && thePlugin.processTelemetry) {
                 // Set this plugin as the next for the previous one
                 lastPlugin.setNextPlugin(thePlugin);
             }
@@ -71,7 +70,7 @@ export function initializePlugins(processContext: IProcessTelemetryContext, exte
 
     // Now initialize the plugins
     arrForEach(initPlugins, thePlugin => {
-        let core = processContext[STR_CORE]();
+        let core = processContext.core();
 
         thePlugin.initialize(
             processContext.getCfg(),
@@ -96,8 +95,8 @@ export function sortPlugins<T = IPlugin>(plugins:T[]) {
     return plugins.sort((extA, extB) => {
         let result = 0;
         if (extB) {
-            let bHasProcess = isFunction(extB[STR_PROCESS_TELEMETRY]);
-            if (isFunction(extA[STR_PROCESS_TELEMETRY])) {
+            let bHasProcess = extB[STR_PROCESS_TELEMETRY];
+            if (extA[STR_PROCESS_TELEMETRY]) {
                 result = bHasProcess ? extA[STR_PRIORITY] - extB[STR_PRIORITY] : 1;
             } else if (bHasProcess) {
                 result = -1;

package/src/JavaScriptSDK/TelemetryInitializerPlugin.ts

@@ -72,9 +72,9 @@ export class TelemetryInitializerPlugin extends BaseTelemetryPlugin implements I
                             // doNotSendItem = true;
                             _throwInternal(
                                 itemCtx.diagLog(),
-                                eLoggingSeverity.CRITICAL,
+                                eLoggingSeverity.WARNING,
                                 _eInternalMessageId.TelemetryInitializerFailed,
-                                "One of telemetry initializers failed, telemetry item will not be sent: " + getExceptionName(e),
+                                "Telemetry initializer failed: " + getExceptionName(e),
                                 { exception: dumpObj(e) }, true);
                         }
                     }

package/src/JavaScriptSDK/W3cTraceParent.ts

@@ -2,9 +2,10 @@ import { isArray, isString, strTrim } from "@nevware21/ts-utils";
 import { ITraceParent } from "../JavaScriptSDK.Interfaces/ITraceParent";
 import { generateW3CId } from "./CoreUtils";
 import { findMetaTag, findNamedServerTiming } from "./EnvUtils";
+import { STR_EMPTY } from "./InternalConstants";
 
 // 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 TRACE_PARENT_REGEX = /^([\da-f]{2})-([\da-f]{32})-([\da-f]{16})-([\da-f]{2})(-[^\s]{1,64})?$/i;
 const DEFAULT_VERSION = "00";
 const INVALID_VERSION = "ff";
 const INVALID_TRACE_ID = "00000000000000000000000000000000";
@@ -13,7 +14,7 @@ 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 !!value.match(/^[\da-f]*$/i);
     }
 
     return false;
@@ -90,9 +91,9 @@ export function parseTraceParent(value: string): ITraceParent {
     }
 
     return {
-        version: match[1],
-        traceId: match[2],
-        spanId: match[3],
+        version: (match[1] || STR_EMPTY).toLowerCase(),
+        traceId: (match[2] || STR_EMPTY).toLowerCase(),
+        spanId: (match[3] || STR_EMPTY).toLowerCase(),
         traceFlags: parseInt(match[4], 16)
     }
 }
@@ -175,7 +176,7 @@ export function formatTraceParent(value: ITraceParent) {
         }
 
         // Format as version 00
-        return `${version}-${_formatValue(value.traceId, 32, INVALID_TRACE_ID)}-${_formatValue(value.spanId, 16, INVALID_SPAN_ID)}-${flags}`;
+        return `${version.toLowerCase()}-${_formatValue(value.traceId, 32, INVALID_TRACE_ID).toLowerCase()}-${_formatValue(value.spanId, 16, INVALID_SPAN_ID).toLowerCase()}-${flags.toLowerCase()}`;
     }
 
     return "";

package/src/JavaScriptSDK.Enums/EnumHelperFuncs.ts

@@ -4,7 +4,6 @@
 import { EnumCls, createEnum, createTypeMap } from "@nevware21/ts-utils";
 
 export declare type EnumValue<E = any> = EnumCls<E>;
-// export declare type EnumMap<E = any, I = E> = EnumNameMap<E, I>;
 
 /**
  * Create an enum style object which has both the key => value and value => key mappings

package/src/JavaScriptSDK.Enums/LoggingEnums.ts

@@ -4,23 +4,12 @@
 
 import { createEnumStyle } from "../JavaScriptSDK.Enums/EnumHelperFuncs";
 
-const FAILED = "Failed";
-const FAILED_MONITOR_AJAX = FAILED + "MonitorAjax";
-const TRACK = "Track";
-const START = "Start";
-const STOP = "Stop";
-const EVENT = "Event";
-const AUTH_CONTEXT = "AuthContext";
-const EXCEPTION = "Exception";
-const LOCAL = "Local";
-const SESSION = "Session";
-const STORAGE = "Storage";
-const BROWSER = "Browser";
-const CANNOT = "Cannot";
-const BUFFER = "Buffer";
-const INSTRUMENTATION_KEY = "InstrumentationKey";
-
 export const enum eLoggingSeverity {
+    /**
+     * No Logging will be enabled
+     */
+    DISABLED = 0,
+
     /**
      * Error will be sent as internal telemetry
      */
@@ -33,6 +22,7 @@ export const enum eLoggingSeverity {
 }
 
 export const LoggingSeverity = createEnumStyle<typeof eLoggingSeverity>({
+    DISABLED: eLoggingSeverity.DISABLED,
     CRITICAL: eLoggingSeverity.CRITICAL,
     WARNING: eLoggingSeverity.WARNING
 });
@@ -123,98 +113,9 @@ export const enum _eInternalMessageId {
     TrackPageActionEventFailed = 103,
     FailedAddingCustomDefinedRequestContext = 104,
     InMemoryStorageBufferFull = 105,
-    InstrumentationKeyDeprecation = 106
+    InstrumentationKeyDeprecation = 106,
+    ConfigWatcherException = 107,
+    DynamicConfigException = 108
 }
 
-/**
- * Internal message ID. Please create a new one for every conceptually different message. Please keep alphabetically ordered
- */
-export const _InternalMessageId = createEnumStyle<typeof _eInternalMessageId>({
-    // Non user actionable
-    [BROWSER + "DoesNotSupport" + LOCAL + STORAGE as "BrowserDoesNotSupportLocalStorage"]: _eInternalMessageId.BrowserDoesNotSupportLocalStorage,
-    [BROWSER + CANNOT + "Read" + LOCAL + STORAGE as "BrowserCannotReadLocalStorage"]: _eInternalMessageId.BrowserCannotReadLocalStorage,
-    [BROWSER + CANNOT + "Read" + SESSION + STORAGE as "BrowserCannotReadSessionStorage"]: _eInternalMessageId.BrowserCannotReadSessionStorage,
-    [BROWSER + CANNOT + "Write" + LOCAL + STORAGE as "BrowserCannotWriteLocalStorage"]: _eInternalMessageId.BrowserCannotWriteLocalStorage,
-    [BROWSER + CANNOT + "Write" + SESSION + STORAGE as "BrowserCannotWriteSessionStorage"]: _eInternalMessageId.BrowserCannotWriteSessionStorage,
-    [BROWSER + FAILED + "RemovalFrom" + LOCAL + STORAGE as "BrowserFailedRemovalFromLocalStorage"]: _eInternalMessageId.BrowserFailedRemovalFromLocalStorage,
-    [BROWSER + FAILED + "RemovalFrom" + SESSION + STORAGE as "BrowserFailedRemovalFromSessionStorage"]: _eInternalMessageId.BrowserFailedRemovalFromSessionStorage,
-    [CANNOT + "SendEmptyTelemetry" as "CannotSendEmptyTelemetry"]: _eInternalMessageId.CannotSendEmptyTelemetry,
-    ClientPerformanceMathError: _eInternalMessageId.ClientPerformanceMathError,
-    ["ErrorParsingAI" + SESSION + "Cookie" as "ErrorParsingAISessionCookie"]: _eInternalMessageId.ErrorParsingAISessionCookie,
-    ErrorPVCalc: _eInternalMessageId.ErrorPVCalc,
-    [EXCEPTION + "WhileLoggingError" as "ExceptionWhileLoggingError"]: _eInternalMessageId.ExceptionWhileLoggingError,
-    [FAILED + "AddingTelemetryTo" + BUFFER as "FailedAddingTelemetryToBuffer"]: _eInternalMessageId.FailedAddingTelemetryToBuffer,
-    [FAILED_MONITOR_AJAX + "Abort" as "FailedMonitorAjaxAbort"]: _eInternalMessageId.FailedMonitorAjaxAbort,
-    [FAILED_MONITOR_AJAX + "Dur" as "FailedMonitorAjaxDur"]: _eInternalMessageId.FailedMonitorAjaxDur,
-    [FAILED_MONITOR_AJAX + "Open" as "FailedMonitorAjaxOpen"]: _eInternalMessageId.FailedMonitorAjaxOpen,
-    [FAILED_MONITOR_AJAX + "RSC" as "FailedMonitorAjaxRSC"]: _eInternalMessageId.FailedMonitorAjaxRSC,
-    [FAILED_MONITOR_AJAX + "Send" as "FailedMonitorAjaxSend"]: _eInternalMessageId.FailedMonitorAjaxSend,
-    [FAILED_MONITOR_AJAX + "GetCorrelationHeader" as "FailedMonitorAjaxGetCorrelationHeader"]: _eInternalMessageId.FailedMonitorAjaxGetCorrelationHeader,
-    [FAILED + "ToAddHandlerForOnBeforeUnload" as "FailedToAddHandlerForOnBeforeUnload"]: _eInternalMessageId.FailedToAddHandlerForOnBeforeUnload,
-    [FAILED + "ToSendQueuedTelemetry" as "FailedToSendQueuedTelemetry"]: _eInternalMessageId.FailedToSendQueuedTelemetry,
-    [FAILED + "ToReportDataLoss" as "FailedToReportDataLoss"]: _eInternalMessageId.FailedToReportDataLoss,
-    ["Flush" + FAILED as "FlushFailed"]: _eInternalMessageId.FlushFailed,
-    MessageLimitPerPVExceeded: _eInternalMessageId.MessageLimitPerPVExceeded,
-    MissingRequiredFieldSpecification: _eInternalMessageId.MissingRequiredFieldSpecification,
-    NavigationTimingNotSupported: _eInternalMessageId.NavigationTimingNotSupported,
-    OnError: _eInternalMessageId.OnError,
-    [SESSION + "RenewalDateIsZero" as "SessionRenewalDateIsZero"]: _eInternalMessageId.SessionRenewalDateIsZero,
-    SenderNotInitialized: _eInternalMessageId.SenderNotInitialized,
-    [START + TRACK + EVENT + FAILED as "StartTrackEventFailed"]: _eInternalMessageId.StartTrackEventFailed,
-    [STOP + TRACK + EVENT + FAILED as "StopTrackEventFailed"]: _eInternalMessageId.StopTrackEventFailed,
-    [START + TRACK + FAILED as "StartTrackFailed"]: _eInternalMessageId.StartTrackFailed,
-    [STOP + TRACK + FAILED as "StopTrackFailed"]: _eInternalMessageId.StopTrackFailed,
-    TelemetrySampledAndNotSent: _eInternalMessageId.TelemetrySampledAndNotSent,
-    [TRACK + EVENT + FAILED as "TrackEventFailed"]: _eInternalMessageId.TrackEventFailed,
-    [TRACK + EXCEPTION + FAILED as "TrackExceptionFailed"]: _eInternalMessageId.TrackExceptionFailed,
-    [TRACK + "Metric" + FAILED as "TrackMetricFailed"]: _eInternalMessageId.TrackMetricFailed,
-    [TRACK + "PV" + FAILED as "TrackPVFailed"]: _eInternalMessageId.TrackPVFailed,
-    [TRACK + "PV" + FAILED + "Calc" as "TrackPVFailedCalc"]: _eInternalMessageId.TrackPVFailedCalc,
-    [TRACK + "Trace" + FAILED as "TrackTraceFailed"]: _eInternalMessageId.TrackTraceFailed,
-    ["Transmission" + FAILED as "TransmissionFailed"]: _eInternalMessageId.TransmissionFailed,
-    [FAILED + "ToSet" + STORAGE + BUFFER as "FailedToSetStorageBuffer"]: _eInternalMessageId.FailedToSetStorageBuffer,
-    [FAILED + "ToRestore" + STORAGE + BUFFER as "FailedToRestoreStorageBuffer"]: _eInternalMessageId.FailedToRestoreStorageBuffer,
-    InvalidBackendResponse: _eInternalMessageId.InvalidBackendResponse,
-    [FAILED + "ToFixDepricatedValues" as "FailedToFixDepricatedValues"]: _eInternalMessageId.FailedToFixDepricatedValues,
-    InvalidDurationValue: _eInternalMessageId.InvalidDurationValue,
-    TelemetryEnvelopeInvalid: _eInternalMessageId.TelemetryEnvelopeInvalid,
-    CreateEnvelopeError: _eInternalMessageId.CreateEnvelopeError,
-
-    // User actionable
-    [CANNOT + "SerializeObject" as "CannotSerializeObject"]: _eInternalMessageId.CannotSerializeObject,
-    [CANNOT + "SerializeObjectNonSerializable" as "CannotSerializeObjectNonSerializable"]: _eInternalMessageId.CannotSerializeObjectNonSerializable,
-    CircularReferenceDetected: _eInternalMessageId.CircularReferenceDetected,
-    ["Clear" + AUTH_CONTEXT + FAILED as "ClearAuthContextFailed"]: _eInternalMessageId.ClearAuthContextFailed,
-    [EXCEPTION + "Truncated" as "ExceptionTruncated"]: _eInternalMessageId.ExceptionTruncated,
-    IllegalCharsInName: _eInternalMessageId.IllegalCharsInName,
-    ItemNotInArray: _eInternalMessageId.ItemNotInArray,
-    MaxAjaxPerPVExceeded: _eInternalMessageId.MaxAjaxPerPVExceeded,
-    MessageTruncated: _eInternalMessageId.MessageTruncated,
-    NameTooLong: _eInternalMessageId.NameTooLong,
-    SampleRateOutOfRange: _eInternalMessageId.SampleRateOutOfRange,
-    ["Set" + AUTH_CONTEXT + FAILED as "SetAuthContextFailed"]: _eInternalMessageId.SetAuthContextFailed,
-    ["Set" + AUTH_CONTEXT + FAILED + "AccountName" as "SetAuthContextFailedAccountName"]: _eInternalMessageId.SetAuthContextFailedAccountName,
-    StringValueTooLong: _eInternalMessageId.StringValueTooLong,
-    StartCalledMoreThanOnce: _eInternalMessageId.StartCalledMoreThanOnce,
-    StopCalledWithoutStart: _eInternalMessageId.StopCalledWithoutStart,
-    ["TelemetryInitializer" + FAILED as "TelemetryInitializerFailed"]: _eInternalMessageId.TelemetryInitializerFailed,
-    TrackArgumentsNotSpecified: _eInternalMessageId.TrackArgumentsNotSpecified,
-    UrlTooLong: _eInternalMessageId.UrlTooLong,
-    [SESSION + STORAGE + BUFFER + "Full" as "SessionStorageBufferFull"]: _eInternalMessageId.SessionStorageBufferFull,
-    [CANNOT + "AccessCookie" as "CannotAccessCookie"]: _eInternalMessageId.CannotAccessCookie,
-    IdTooLong: _eInternalMessageId.IdTooLong,
-    InvalidEvent: _eInternalMessageId.InvalidEvent,
-    [FAILED_MONITOR_AJAX + "SetRequestHeader" as "FailedMonitorAjaxSetRequestHeader"]: _eInternalMessageId.FailedMonitorAjaxSetRequestHeader,
-    ["Send" + BROWSER + "InfoOnUserInit" as "SendBrowserInfoOnUserInit"]: _eInternalMessageId.SendBrowserInfoOnUserInit,
-    ["Plugin" + EXCEPTION as "PluginException"]: _eInternalMessageId.PluginException,
-    ["Notification" + EXCEPTION as "NotificationException"]: _eInternalMessageId.NotificationException,
-    SnippetScriptLoadFailure: _eInternalMessageId.SnippetScriptLoadFailure,
-    ["Invalid" + INSTRUMENTATION_KEY as "InvalidInstrumentationKey"]: _eInternalMessageId.InvalidInstrumentationKey,
-    [CANNOT + "ParseAiBlobValue" as "CannotParseAiBlobValue"]: _eInternalMessageId.CannotParseAiBlobValue,
-    InvalidContentBlob: _eInternalMessageId.InvalidContentBlob,
-    [TRACK + "PageAction" + EVENT + FAILED as "TrackPageActionEventFailed"]: _eInternalMessageId.TrackPageActionEventFailed,
-    [FAILED + "AddingCustomDefinedRequestContext" as "FailedAddingCustomDefinedRequestContext"]: _eInternalMessageId.FailedAddingCustomDefinedRequestContext,
-    ["InMemory" + STORAGE + BUFFER + "Full" as "InMemoryStorageBufferFull"]: _eInternalMessageId.InMemoryStorageBufferFull,
-    [INSTRUMENTATION_KEY + "Deprecation" as "InstrumentationKeyDeprecation"]: _eInternalMessageId.InstrumentationKeyDeprecation
-});
 export type _InternalMessageId = number | _eInternalMessageId;

package/src/JavaScriptSDK.Enums/TelemetryUpdateReason.ts

@@ -13,7 +13,7 @@ export const enum TelemetryUpdateReason {
     /**
      * The configuration has ben updated or changed
      */
-    //ConfigurationChanged = 0x01,
+    ConfigurationChanged = 0x01,
 
     /**
      * One or more plugins have been added

package/src/JavaScriptSDK.Interfaces/IAppInsightsCore.ts

@@ -15,6 +15,8 @@ import { ITelemetryUnloadState } from "./ITelemetryUnloadState";
 import { UnloadHandler } from "../JavaScriptSDK/UnloadHandlerContainer";
 import { SendRequestReason } from "../JavaScriptSDK.Enums/SendRequestReason";
 import { IDistributedTraceContext } from "./IDistributedTraceContext";
+import { ILegacyUnloadHook, IUnloadHook } from "./IUnloadHook";
+import { WatcherFunction } from "../Config/IDynamicWatcher";
 
 export interface ILoadedPlugin<T extends IPlugin> {
     plugin: T;
@@ -86,13 +88,13 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
      * 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.
+     * @param listener - An INotificationListener object.
      */
     addNotificationListener?(listener: INotificationListener): void;
 
     /**
      * Removes all instances of the listener.
-     * @param {INotificationListener} listener - INotificationListener to remove.
+     * @param listener - INotificationListener to remove.
      */
     removeNotificationListener?(listener: INotificationListener): void;
 
@@ -101,7 +103,7 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
      * @param telemetryInitializer - The Telemetry Initializer function
      * @returns - A ITelemetryInitializerHandler to enable the initializer to be removed
      */
-    addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler | void;
+    addTelemetryInitializer(telemetryInitializer: TelemetryInitializerFunction): ITelemetryInitializerHandler;
 
     pollInternalLogs?(eventName?: string): number;
 
@@ -140,6 +142,15 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
      */
     addPlugin<T extends IPlugin = ITelemetryPlugin>(plugin: T, replaceExisting?: boolean, doAsync?: boolean, addCb?: (added?: boolean) => void): void;
   
+    /**
+     * Update the configuration used and broadcast the changes to all loaded plugins, this does NOT support updating, adding or removing
+     * any the plugins (extensions or channels). It will notify each plugin (if supported) that the configuration has changed but it will
+     * not remove or add any new plugins, you need to call addPlugin or getPlugin(identifier).remove();
+     * @param newConfig - The new configuration is apply
+     * @param mergeExisting - Should the new configuration merge with the existing or just replace it. Default is to merge.
+     */
+    updateCfg<T extends IConfiguration = IConfiguration>(newConfig: T, mergeExisting?: boolean): void;
+
     /**
      * Returns the unique event namespace that should be used when registering events
      */
@@ -151,6 +162,12 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
      */
     addUnloadCb(handler: UnloadHandler): void;
 
+    /**
+     * Add this hook so that it is automatically removed during unloading
+     * @param hooks - The single hook or an array of IInstrumentHook objects
+     */
+    addUnloadHook(hooks: IUnloadHook | IUnloadHook[] | Iterator<IUnloadHook> | ILegacyUnloadHook | ILegacyUnloadHook[] | Iterator<ILegacyUnloadHook>): void;
+
     /**
      * Flush and send any batched / cached data immediately
      * @param async - send data asynchronously when true (defaults to true)
@@ -172,4 +189,12 @@ export interface IAppInsightsCore extends IPerfManagerProvider {
      * Sets the current distributed trace context for this instance if available
      */
     setTraceCtx(newTraceCtx: IDistributedTraceContext | null | undefined): void;
+
+    /**
+     * Watches and tracks changes for accesses to the current config, and if the accessed config changes the
+     * handler will be recalled.
+     * @param handler
+     * @returns A watcher handler instance that can be used to remove itself when being unloaded
+     */
+    onCfgChange<T extends IConfiguration = IConfiguration>(handler: WatcherFunction<T>): IUnloadHook;
 }

package/src/JavaScriptSDK.Interfaces/ICookieMgr.ts

@@ -1,6 +1,8 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
+import { ITelemetryUpdateState } from "./ITelemetryUpdateState";
+
 export interface ICookieMgr {
 
     /**
@@ -48,6 +50,12 @@ export interface ICookieMgr {
      * @returns - True if the cookie was marked for deletion otherwise false (Because cookie usage is not available)
      */
     purge(name: string, path?: string): boolean;
+
+    /**
+     * Optional Callback hook to allow the diagnostic logger to update it's configuration
+     * @param updateState
+     */
+    update?(updateState: ITelemetryUpdateState): void;
 }
 
 /**