@microsoft/applicationinsights-common 3.0.0-beta.2303-02 → 3.0.0-beta.2303-03

package/dist-esm/TelemetryItemCreator.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-02
+ * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-esm/ThrottleMgr.js

@@ -1,13 +1,13 @@
 /*
- * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-02
+ * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
-import { _throwInternal, arrForEach, arrIndexOf, isNotNullOrUndefined, isNullOrUndefined, randomValue, safeGetLogger, strTrim } from "@microsoft/applicationinsights-core-js";
+import { _throwInternal, arrForEach, arrIndexOf, createDynamicConfig, createUnloadHookContainer, isNotNullOrUndefined, isNullOrUndefined, onConfigChange, randomValue, safeGetLogger, strTrim } from "@microsoft/applicationinsights-core-js";
 import { utlCanUseLocalStorage, utlGetLocalStorage, utlSetLocalStorage } from "./StorageHelperFuncs";
 import { _DYN_COUNT, _DYN_DATE, _DYN_DAYS_OF_MONTH, _DYN_DISABLED, _DYN_GET_UTCDATE, _DYN_INTERVAL, _DYN_LENGTH, _DYN_MESSAGE, _DYN_PRE_TRIGGER_DATE, _DYN_STRINGIFY } from "./__DynamicConstants";
 var THROTTLE_STORAGE_PREFIX = "appInsightsThrottle";
 var ThrottleMgr = /** @class */ (function () {
-    function ThrottleMgr(throttleMgr, core, namePrefix) {
+    function ThrottleMgr(config, core, namePrefix, unloadHookContainer) {
         var _self = this;
         var _canUseLocalStorage;
         var _logger;
@@ -20,6 +20,10 @@ var ThrottleMgr = /** @class */ (function () {
         var _isReady = false;
         var _isSpecificDaysGiven = false;
         _initConfig();
+        // Special internal method to allow the unit tests and DebugPlugin to hook embedded objects
+        _self["_getDbgPlgTargets"] = function () {
+            return [_queue];
+        };
         _self.getConfig = function () {
             return _config;
         };
@@ -56,8 +60,10 @@ var ThrottleMgr = /** @class */ (function () {
         _self.flush = function () {
             try {
                 if (_isReady && _queue[_DYN_LENGTH /* @min:%2elength */] > 0) {
-                    arrForEach(_queue, function (item) {
-                        _self.sendMessage(item.msgID, item[_DYN_MESSAGE /* @min:%2emessage */], item.severity);
+                    var items = _queue.slice(0);
+                    _queue = [];
+                    arrForEach(items, function (item) {
+                        _flushMessage(item.msgID, item[_DYN_MESSAGE /* @min:%2emessage */], item.severity, false);
                     });
                     return true;
                 }
@@ -78,6 +84,9 @@ var ThrottleMgr = /** @class */ (function () {
             return _self.flush();
         };
         _self.sendMessage = function (msgID, message, severity) {
+            return _flushMessage(msgID, message, severity, true);
+        };
+        function _flushMessage(msgID, message, severity, saveUnsentMsg) {
             if (_isReady) {
                 var isSampledIn = _canSampledIn();
                 if (!isSampledIn) {
@@ -112,41 +121,49 @@ var ThrottleMgr = /** @class */ (function () {
                 };
             }
             else {
-                _queue.push({
-                    msgID: msgID,
-                    message: message,
-                    severity: severity
-                });
+                if (!!saveUnsentMsg) {
+                    _queue.push({
+                        msgID: msgID,
+                        message: message,
+                        severity: severity
+                    });
+                }
             }
             return null;
-        };
+        }
         function _initConfig() {
-            var _a, _b;
-            _canUseLocalStorage = utlCanUseLocalStorage();
             _logger = safeGetLogger(core);
             _isTriggered = false;
-            _namePrefix = isNotNullOrUndefined(namePrefix) ? namePrefix : "";
             _queue = [];
-            var configMgr = throttleMgr;
-            _config = {};
-            _config[_DYN_DISABLED /* @min:%2edisabled */] = !!configMgr[_DYN_DISABLED /* @min:%2edisabled */];
-            _config.msgKey = configMgr.msgKey;
-            var configInterval = configMgr[_DYN_INTERVAL /* @min:%2einterval */] || {};
-            _isSpecificDaysGiven = (configInterval === null || configInterval === void 0 ? void 0 : configInterval.daysOfMonth) && (configInterval === null || configInterval === void 0 ? void 0 : configInterval.daysOfMonth[_DYN_LENGTH /* @min:%2elength */]) > 0;
-            _config[_DYN_INTERVAL /* @min:%2einterval */] = _getIntervalConfig(configInterval);
-            var limit = {
-                samplingRate: ((_a = configMgr.limit) === null || _a === void 0 ? void 0 : _a.samplingRate) || 100,
-                // dafault: every time sent only 1 event
-                maxSendNumber: ((_b = configMgr.limit) === null || _b === void 0 ? void 0 : _b.maxSendNumber) || 1
-            };
-            _config.limit = limit;
-            _localStorageName = _getLocalStorageName(_config.msgKey, _namePrefix);
-            if (_canUseLocalStorage && _localStorageName) {
-                _localStorageObj = _getLocalStorageObj(utlGetLocalStorage(_logger, _localStorageName), _logger, _localStorageName);
-            }
-            if (_localStorageObj) {
-                _isTriggered = _isTriggeredOnCurDate(_localStorageObj[_DYN_PRE_TRIGGER_DATE /* @min:%2epreTriggerDate */]);
-            }
+            _namePrefix = isNotNullOrUndefined(namePrefix) ? namePrefix : "";
+            unloadHookContainer = unloadHookContainer || createUnloadHookContainer();
+            // Make sure the root config is dynamic as it may be the global config
+            config = createDynamicConfig(config || {}, null, _logger).cfg;
+            var unloadHook = onConfigChange((config), function () {
+                var _a, _b;
+                _canUseLocalStorage = utlCanUseLocalStorage();
+                var configMgr = config || {};
+                _config = {};
+                _config[_DYN_DISABLED /* @min:%2edisabled */] = !!configMgr[_DYN_DISABLED /* @min:%2edisabled */];
+                _config.msgKey = configMgr.msgKey || 0 /* IThrottleMsgKey.default */;
+                var configInterval = configMgr[_DYN_INTERVAL /* @min:%2einterval */] || {};
+                _isSpecificDaysGiven = (configInterval === null || configInterval === void 0 ? void 0 : configInterval.daysOfMonth) && (configInterval === null || configInterval === void 0 ? void 0 : configInterval.daysOfMonth[_DYN_LENGTH /* @min:%2elength */]) > 0;
+                _config[_DYN_INTERVAL /* @min:%2einterval */] = _getIntervalConfig(configInterval);
+                var limit = {
+                    samplingRate: ((_a = configMgr.limit) === null || _a === void 0 ? void 0 : _a.samplingRate) || 100,
+                    // dafault: every time sent only 1 event
+                    maxSendNumber: ((_b = configMgr.limit) === null || _b === void 0 ? void 0 : _b.maxSendNumber) || 1
+                };
+                _config.limit = limit;
+                _localStorageName = _getLocalStorageName(_config.msgKey, _namePrefix);
+                if (_canUseLocalStorage && _localStorageName) {
+                    _localStorageObj = _getLocalStorageObj(utlGetLocalStorage(_logger, _localStorageName), _logger, _localStorageName);
+                }
+                if (_localStorageObj) {
+                    _isTriggered = _isTriggeredOnCurDate(_localStorageObj[_DYN_PRE_TRIGGER_DATE /* @min:%2epreTriggerDate */]);
+                }
+            });
+            unloadHookContainer && unloadHookContainer.add(unloadHook);
         }
         function _getIntervalConfig(interval) {
             interval = interval || {};
@@ -268,6 +285,9 @@ var ThrottleMgr = /** @class */ (function () {
             return false;
         }
         function _checkInterval(interval, start, current) {
+            if (interval <= 0) {
+                return 1;
+            }
             // count from start year
             return (current >= start) && (current - start) % interval == 0 ? Math.floor((current - start) / interval) + 1 : -1;
         }

package/dist-esm/ThrottleMgr.js.map

@@ -1 +1 @@
-{"version":3,"file":"ThrottleMgr.js.map","sources":["ThrottleMgr.js"],"sourcesContent":["import { _throwInternal, arrForEach, arrIndexOf, isNotNullOrUndefined, isNullOrUndefined, randomValue, safeGetLogger, strTrim } from \"@microsoft/applicationinsights-core-js\";\r\nimport { utlCanUseLocalStorage, utlGetLocalStorage, utlSetLocalStorage } from \"./StorageHelperFuncs\";\r\nimport { _DYN_COUNT, _DYN_DATE, _DYN_DAYS_OF_MONTH, _DYN_DISABLED, _DYN_GET_UTCDATE, _DYN_INTERVAL, _DYN_LENGTH, _DYN_MESSAGE, _DYN_PRE_TRIGGER_DATE, _DYN_STRINGIFY } from \"./__DynamicConstants\";\r\nvar THROTTLE_STORAGE_PREFIX = \"appInsightsThrottle\";\r\nvar ThrottleMgr = /** @class */ (function () {\r\n    function ThrottleMgr(throttleMgr, core, namePrefix) {\r\n        var _self = this;\r\n        var _canUseLocalStorage;\r\n        var _logger;\r\n        var _config;\r\n        var _localStorageName;\r\n        var _localStorageObj;\r\n        var _isTriggered; //_isTriggered is to make sure that we only trigger throttle once a day\r\n        var _namePrefix;\r\n        var _queue;\r\n        var _isReady = false;\r\n        var _isSpecificDaysGiven = false;\r\n        _initConfig();\r\n        _self.getConfig = function () {\r\n            return _config;\r\n        };\r\n        /**\r\n         * Check if it is the correct day to send message.\r\n         * If _isTriggered is true, even if canThrottle returns true, message will not be sent,\r\n         * because we only allow triggering sendMessage() once a day.\r\n         * @returns if the current date is the valid date to send message\r\n         */\r\n        _self.canThrottle = function () {\r\n            return _canThrottle(_config, _canUseLocalStorage, _localStorageObj);\r\n        };\r\n        /**\r\n         * Check if throttle is triggered on current day(UTC)\r\n         * if canThrottle returns false, isTriggered will return false\r\n         * @returns if throttle is triggered on current day(UTC)\r\n         */\r\n        _self.isTriggered = function () {\r\n            return _isTriggered;\r\n        };\r\n        /**\r\n         * Before isReady set to true, all message will be stored in queue.\r\n         * Message will only be sent out after isReady set to true.\r\n         * Initial and default value: false\r\n         * @returns isReady state\r\n         */\r\n        _self.isReady = function () {\r\n            return _isReady;\r\n        };\r\n        /**\r\n         * Flush all message in queue with isReady state set to true.\r\n         * @returns if message queue is flushed\r\n         */\r\n        _self.flush = function () {\r\n            try {\r\n                if (_isReady && _queue[_DYN_LENGTH /* @min:%2elength */] > 0) {\r\n                    arrForEach(_queue, function (item) {\r\n                        _self.sendMessage(item.msgID, item[_DYN_MESSAGE /* @min:%2emessage */], item.severity);\r\n                    });\r\n                    return true;\r\n                }\r\n            }\r\n            catch (err) {\r\n                // eslint-disable-next-line no-empty\r\n            }\r\n            return false;\r\n        };\r\n        /**\r\n         * Set isReady State\r\n         * if isReady set to true, message queue will be flushed automatically.\r\n         * @param isReady isReady State\r\n         * @returns if message queue is flushed\r\n         */\r\n        _self.onReadyState = function (isReady) {\r\n            _isReady = isNullOrUndefined(isReady) ? true : isReady;\r\n            return _self.flush();\r\n        };\r\n        _self.sendMessage = function (msgID, message, severity) {\r\n            if (_isReady) {\r\n                var isSampledIn = _canSampledIn();\r\n                if (!isSampledIn) {\r\n                    return;\r\n                }\r\n                var canThrottle = _canThrottle(_config, _canUseLocalStorage, _localStorageObj);\r\n                var throttled = false;\r\n                var number = 0;\r\n                try {\r\n                    if (canThrottle && !_isTriggered) {\r\n                        number = Math.min(_config.limit.maxSendNumber, _localStorageObj[_DYN_COUNT /* @min:%2ecount */] + 1);\r\n                        _localStorageObj[_DYN_COUNT /* @min:%2ecount */] = 0;\r\n                        throttled = true;\r\n                        _isTriggered = true;\r\n                        _localStorageObj[_DYN_PRE_TRIGGER_DATE /* @min:%2epreTriggerDate */] = new Date();\r\n                    }\r\n                    else {\r\n                        _isTriggered = canThrottle;\r\n                        _localStorageObj[_DYN_COUNT /* @min:%2ecount */] += 1;\r\n                    }\r\n                    _resetLocalStorage(_logger, _localStorageName, _localStorageObj);\r\n                    for (var i = 0; i < number; i++) {\r\n                        _sendMessage(msgID, _logger, message, severity);\r\n                    }\r\n                }\r\n                catch (e) {\r\n                    // eslint-disable-next-line no-empty\r\n                }\r\n                return {\r\n                    isThrottled: throttled,\r\n                    throttleNum: number\r\n                };\r\n            }\r\n            else {\r\n                _queue.push({\r\n                    msgID: msgID,\r\n                    message: message,\r\n                    severity: severity\r\n                });\r\n            }\r\n            return null;\r\n        };\r\n        function _initConfig() {\r\n            var _a, _b;\r\n            _canUseLocalStorage = utlCanUseLocalStorage();\r\n            _logger = safeGetLogger(core);\r\n            _isTriggered = false;\r\n            _namePrefix = isNotNullOrUndefined(namePrefix) ? namePrefix : \"\";\r\n            _queue = [];\r\n            var configMgr = throttleMgr;\r\n            _config = {};\r\n            _config[_DYN_DISABLED /* @min:%2edisabled */] = !!configMgr[_DYN_DISABLED /* @min:%2edisabled */];\r\n            _config.msgKey = configMgr.msgKey;\r\n            var configInterval = configMgr[_DYN_INTERVAL /* @min:%2einterval */] || {};\r\n            _isSpecificDaysGiven = (configInterval === null || configInterval === void 0 ? void 0 : configInterval.daysOfMonth) && (configInterval === null || configInterval === void 0 ? void 0 : configInterval.daysOfMonth[_DYN_LENGTH /* @min:%2elength */]) > 0;\r\n            _config[_DYN_INTERVAL /* @min:%2einterval */] = _getIntervalConfig(configInterval);\r\n            var limit = {\r\n                samplingRate: ((_a = configMgr.limit) === null || _a === void 0 ? void 0 : _a.samplingRate) || 100,\r\n                // dafault: every time sent only 1 event\r\n                maxSendNumber: ((_b = configMgr.limit) === null || _b === void 0 ? void 0 : _b.maxSendNumber) || 1\r\n            };\r\n            _config.limit = limit;\r\n            _localStorageName = _getLocalStorageName(_config.msgKey, _namePrefix);\r\n            if (_canUseLocalStorage && _localStorageName) {\r\n                _localStorageObj = _getLocalStorageObj(utlGetLocalStorage(_logger, _localStorageName), _logger, _localStorageName);\r\n            }\r\n            if (_localStorageObj) {\r\n                _isTriggered = _isTriggeredOnCurDate(_localStorageObj[_DYN_PRE_TRIGGER_DATE /* @min:%2epreTriggerDate */]);\r\n            }\r\n        }\r\n        function _getIntervalConfig(interval) {\r\n            interval = interval || {};\r\n            var monthInterval = interval === null || interval === void 0 ? void 0 : interval.monthInterval;\r\n            var dayInterval = interval === null || interval === void 0 ? void 0 : interval.dayInterval;\r\n            // default: send data every 3 month each year\r\n            if (isNullOrUndefined(monthInterval) && isNullOrUndefined(dayInterval)) {\r\n                interval.monthInterval = 3;\r\n                if (!_isSpecificDaysGiven) {\r\n                    // default: send data on 28th\r\n                    interval[_DYN_DAYS_OF_MONTH /* @min:%2edaysOfMonth */] = [28];\r\n                    _isSpecificDaysGiven = true;\r\n                }\r\n            }\r\n            interval = {\r\n                // dafault: sent every three months\r\n                monthInterval: interval === null || interval === void 0 ? void 0 : interval.monthInterval,\r\n                dayInterval: interval === null || interval === void 0 ? void 0 : interval.dayInterval,\r\n                daysOfMonth: interval === null || interval === void 0 ? void 0 : interval.daysOfMonth\r\n            };\r\n            return interval;\r\n        }\r\n        function _canThrottle(config, canUseLocalStorage, localStorageObj) {\r\n            if (!config[_DYN_DISABLED /* @min:%2edisabled */] && canUseLocalStorage && isNotNullOrUndefined(localStorageObj)) {\r\n                var curDate = _getThrottleDate();\r\n                var date = localStorageObj[_DYN_DATE /* @min:%2edate */];\r\n                var interval = config[_DYN_INTERVAL /* @min:%2einterval */];\r\n                var monthCheck = 1;\r\n                if (interval === null || interval === void 0 ? void 0 : interval.monthInterval) {\r\n                    var monthExpand = (curDate.getUTCFullYear() - date.getUTCFullYear()) * 12 + curDate.getUTCMonth() - date.getUTCMonth();\r\n                    monthCheck = _checkInterval(interval.monthInterval, 0, monthExpand);\r\n                }\r\n                var dayCheck = 1;\r\n                if (_isSpecificDaysGiven) {\r\n                    dayCheck = arrIndexOf(interval[_DYN_DAYS_OF_MONTH /* @min:%2edaysOfMonth */], curDate[_DYN_GET_UTCDATE /* @min:%2egetUTCDate */]());\r\n                }\r\n                else if (interval === null || interval === void 0 ? void 0 : interval.dayInterval) {\r\n                    var daySpan = Math.floor((curDate.getTime() - date.getTime()) / 86400000);\r\n                    dayCheck = _checkInterval(interval.dayInterval, 0, daySpan);\r\n                }\r\n                return monthCheck >= 0 && dayCheck >= 0;\r\n            }\r\n            return false;\r\n        }\r\n        function _getLocalStorageName(msgKey, prefix) {\r\n            var fix = isNotNullOrUndefined(prefix) ? prefix : \"\";\r\n            if (msgKey) {\r\n                return THROTTLE_STORAGE_PREFIX + fix + \"-\" + msgKey;\r\n            }\r\n            return null;\r\n        }\r\n        // returns if throttle is triggered on current Date\r\n        function _isTriggeredOnCurDate(preTriggerDate) {\r\n            try {\r\n                if (preTriggerDate) {\r\n                    var curDate = new Date();\r\n                    return preTriggerDate.getUTCFullYear() === curDate.getUTCFullYear() &&\r\n                        preTriggerDate.getUTCMonth() === curDate.getUTCMonth() &&\r\n                        preTriggerDate[_DYN_GET_UTCDATE /* @min:%2egetUTCDate */]() === curDate[_DYN_GET_UTCDATE /* @min:%2egetUTCDate */]();\r\n                }\r\n            }\r\n            catch (e) {\r\n                // eslint-disable-next-line no-empty\r\n            }\r\n            return false;\r\n        }\r\n        // transfer local storage string value to object that identifies start date, current count and preTriggerDate\r\n        function _getLocalStorageObj(value, logger, storageName) {\r\n            try {\r\n                var storageObj = {\r\n                    date: _getThrottleDate(),\r\n                    count: 0\r\n                };\r\n                if (value) {\r\n                    var obj = JSON.parse(value);\r\n                    return {\r\n                        date: _getThrottleDate(obj[_DYN_DATE /* @min:%2edate */]) || storageObj[_DYN_DATE /* @min:%2edate */],\r\n                        count: obj[_DYN_COUNT /* @min:%2ecount */] || storageObj[_DYN_COUNT /* @min:%2ecount */],\r\n                        preTriggerDate: obj.preTriggerDate ? _getThrottleDate(obj[_DYN_PRE_TRIGGER_DATE /* @min:%2epreTriggerDate */]) : undefined\r\n                    };\r\n                }\r\n                else {\r\n                    _resetLocalStorage(logger, storageName, storageObj);\r\n                    return storageObj;\r\n                }\r\n            }\r\n            catch (e) {\r\n                // eslint-disable-next-line no-empty\r\n            }\r\n            return null;\r\n        }\r\n        // if datestr is not defined, current date will be returned\r\n        function _getThrottleDate(dateStr) {\r\n            // if new Date() can't be created through the provided dateStr, null will be returned.\r\n            try {\r\n                if (dateStr) {\r\n                    var date = new Date(dateStr);\r\n                    //make sure it is a valid Date Object\r\n                    if (!isNaN(date.getDate())) {\r\n                        return date;\r\n                    }\r\n                }\r\n                else {\r\n                    return new Date();\r\n                }\r\n            }\r\n            catch (e) {\r\n                // eslint-disable-next-line no-empty\r\n            }\r\n            return null;\r\n        }\r\n        function _resetLocalStorage(logger, storageName, obj) {\r\n            try {\r\n                return utlSetLocalStorage(logger, storageName, strTrim(JSON[_DYN_STRINGIFY /* @min:%2estringify */](obj)));\r\n            }\r\n            catch (e) {\r\n                //     // eslint-disable-next-line no-empty\r\n            }\r\n            return false;\r\n        }\r\n        function _checkInterval(interval, start, current) {\r\n            // count from start year\r\n            return (current >= start) && (current - start) % interval == 0 ? Math.floor((current - start) / interval) + 1 : -1;\r\n        }\r\n        function _sendMessage(msgID, logger, message, severity) {\r\n            _throwInternal(logger, severity || 1 /* eLoggingSeverity.CRITICAL */, msgID, message);\r\n        }\r\n        // NOTE: config.limit.samplingRate is set to 4 decimal places,\r\n        // so config.limit.samplingRate = 1 means 0.0001%\r\n        function _canSampledIn() {\r\n            return randomValue(1000000) <= _config.limit.samplingRate;\r\n        }\r\n    }\r\n    return ThrottleMgr;\r\n}());\r\nexport { ThrottleMgr };\r\n//# sourceMappingURL=ThrottleMgr.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;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;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;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;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;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;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;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;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;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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}
+{"version":3,"file":"ThrottleMgr.js.map","sources":["ThrottleMgr.js"],"sourcesContent":["import { _throwInternal, arrForEach, arrIndexOf, createDynamicConfig, createUnloadHookContainer, isNotNullOrUndefined, isNullOrUndefined, onConfigChange, randomValue, safeGetLogger, strTrim } from \"@microsoft/applicationinsights-core-js\";\r\nimport { utlCanUseLocalStorage, utlGetLocalStorage, utlSetLocalStorage } from \"./StorageHelperFuncs\";\r\nimport { _DYN_COUNT, _DYN_DATE, _DYN_DAYS_OF_MONTH, _DYN_DISABLED, _DYN_GET_UTCDATE, _DYN_INTERVAL, _DYN_LENGTH, _DYN_MESSAGE, _DYN_PRE_TRIGGER_DATE, _DYN_STRINGIFY } from \"./__DynamicConstants\";\r\nvar THROTTLE_STORAGE_PREFIX = \"appInsightsThrottle\";\r\nvar ThrottleMgr = /** @class */ (function () {\r\n    function ThrottleMgr(config, core, namePrefix, unloadHookContainer) {\r\n        var _self = this;\r\n        var _canUseLocalStorage;\r\n        var _logger;\r\n        var _config;\r\n        var _localStorageName;\r\n        var _localStorageObj;\r\n        var _isTriggered; //_isTriggered is to make sure that we only trigger throttle once a day\r\n        var _namePrefix;\r\n        var _queue;\r\n        var _isReady = false;\r\n        var _isSpecificDaysGiven = false;\r\n        _initConfig();\r\n        // Special internal method to allow the unit tests and DebugPlugin to hook embedded objects\r\n        _self[\"_getDbgPlgTargets\"] = function () {\r\n            return [_queue];\r\n        };\r\n        _self.getConfig = function () {\r\n            return _config;\r\n        };\r\n        /**\r\n         * Check if it is the correct day to send message.\r\n         * If _isTriggered is true, even if canThrottle returns true, message will not be sent,\r\n         * because we only allow triggering sendMessage() once a day.\r\n         * @returns if the current date is the valid date to send message\r\n         */\r\n        _self.canThrottle = function () {\r\n            return _canThrottle(_config, _canUseLocalStorage, _localStorageObj);\r\n        };\r\n        /**\r\n         * Check if throttle is triggered on current day(UTC)\r\n         * if canThrottle returns false, isTriggered will return false\r\n         * @returns if throttle is triggered on current day(UTC)\r\n         */\r\n        _self.isTriggered = function () {\r\n            return _isTriggered;\r\n        };\r\n        /**\r\n         * Before isReady set to true, all message will be stored in queue.\r\n         * Message will only be sent out after isReady set to true.\r\n         * Initial and default value: false\r\n         * @returns isReady state\r\n         */\r\n        _self.isReady = function () {\r\n            return _isReady;\r\n        };\r\n        /**\r\n         * Flush all message in queue with isReady state set to true.\r\n         * @returns if message queue is flushed\r\n         */\r\n        _self.flush = function () {\r\n            try {\r\n                if (_isReady && _queue[_DYN_LENGTH /* @min:%2elength */] > 0) {\r\n                    var items = _queue.slice(0);\r\n                    _queue = [];\r\n                    arrForEach(items, function (item) {\r\n                        _flushMessage(item.msgID, item[_DYN_MESSAGE /* @min:%2emessage */], item.severity, false);\r\n                    });\r\n                    return true;\r\n                }\r\n            }\r\n            catch (err) {\r\n                // eslint-disable-next-line no-empty\r\n            }\r\n            return false;\r\n        };\r\n        /**\r\n         * Set isReady State\r\n         * if isReady set to true, message queue will be flushed automatically.\r\n         * @param isReady isReady State\r\n         * @returns if message queue is flushed\r\n         */\r\n        _self.onReadyState = function (isReady) {\r\n            _isReady = isNullOrUndefined(isReady) ? true : isReady;\r\n            return _self.flush();\r\n        };\r\n        _self.sendMessage = function (msgID, message, severity) {\r\n            return _flushMessage(msgID, message, severity, true);\r\n        };\r\n        function _flushMessage(msgID, message, severity, saveUnsentMsg) {\r\n            if (_isReady) {\r\n                var isSampledIn = _canSampledIn();\r\n                if (!isSampledIn) {\r\n                    return;\r\n                }\r\n                var canThrottle = _canThrottle(_config, _canUseLocalStorage, _localStorageObj);\r\n                var throttled = false;\r\n                var number = 0;\r\n                try {\r\n                    if (canThrottle && !_isTriggered) {\r\n                        number = Math.min(_config.limit.maxSendNumber, _localStorageObj[_DYN_COUNT /* @min:%2ecount */] + 1);\r\n                        _localStorageObj[_DYN_COUNT /* @min:%2ecount */] = 0;\r\n                        throttled = true;\r\n                        _isTriggered = true;\r\n                        _localStorageObj[_DYN_PRE_TRIGGER_DATE /* @min:%2epreTriggerDate */] = new Date();\r\n                    }\r\n                    else {\r\n                        _isTriggered = canThrottle;\r\n                        _localStorageObj[_DYN_COUNT /* @min:%2ecount */] += 1;\r\n                    }\r\n                    _resetLocalStorage(_logger, _localStorageName, _localStorageObj);\r\n                    for (var i = 0; i < number; i++) {\r\n                        _sendMessage(msgID, _logger, message, severity);\r\n                    }\r\n                }\r\n                catch (e) {\r\n                    // eslint-disable-next-line no-empty\r\n                }\r\n                return {\r\n                    isThrottled: throttled,\r\n                    throttleNum: number\r\n                };\r\n            }\r\n            else {\r\n                if (!!saveUnsentMsg) {\r\n                    _queue.push({\r\n                        msgID: msgID,\r\n                        message: message,\r\n                        severity: severity\r\n                    });\r\n                }\r\n            }\r\n            return null;\r\n        }\r\n        function _initConfig() {\r\n            _logger = safeGetLogger(core);\r\n            _isTriggered = false;\r\n            _queue = [];\r\n            _namePrefix = isNotNullOrUndefined(namePrefix) ? namePrefix : \"\";\r\n            unloadHookContainer = unloadHookContainer || createUnloadHookContainer();\r\n            // Make sure the root config is dynamic as it may be the global config\r\n            config = createDynamicConfig(config || {}, null, _logger).cfg;\r\n            var unloadHook = onConfigChange((config), function () {\r\n                var _a, _b;\r\n                _canUseLocalStorage = utlCanUseLocalStorage();\r\n                var configMgr = config || {};\r\n                _config = {};\r\n                _config[_DYN_DISABLED /* @min:%2edisabled */] = !!configMgr[_DYN_DISABLED /* @min:%2edisabled */];\r\n                _config.msgKey = configMgr.msgKey || 0 /* IThrottleMsgKey.default */;\r\n                var configInterval = configMgr[_DYN_INTERVAL /* @min:%2einterval */] || {};\r\n                _isSpecificDaysGiven = (configInterval === null || configInterval === void 0 ? void 0 : configInterval.daysOfMonth) && (configInterval === null || configInterval === void 0 ? void 0 : configInterval.daysOfMonth[_DYN_LENGTH /* @min:%2elength */]) > 0;\r\n                _config[_DYN_INTERVAL /* @min:%2einterval */] = _getIntervalConfig(configInterval);\r\n                var limit = {\r\n                    samplingRate: ((_a = configMgr.limit) === null || _a === void 0 ? void 0 : _a.samplingRate) || 100,\r\n                    // dafault: every time sent only 1 event\r\n                    maxSendNumber: ((_b = configMgr.limit) === null || _b === void 0 ? void 0 : _b.maxSendNumber) || 1\r\n                };\r\n                _config.limit = limit;\r\n                _localStorageName = _getLocalStorageName(_config.msgKey, _namePrefix);\r\n                if (_canUseLocalStorage && _localStorageName) {\r\n                    _localStorageObj = _getLocalStorageObj(utlGetLocalStorage(_logger, _localStorageName), _logger, _localStorageName);\r\n                }\r\n                if (_localStorageObj) {\r\n                    _isTriggered = _isTriggeredOnCurDate(_localStorageObj[_DYN_PRE_TRIGGER_DATE /* @min:%2epreTriggerDate */]);\r\n                }\r\n            });\r\n            unloadHookContainer && unloadHookContainer.add(unloadHook);\r\n        }\r\n        function _getIntervalConfig(interval) {\r\n            interval = interval || {};\r\n            var monthInterval = interval === null || interval === void 0 ? void 0 : interval.monthInterval;\r\n            var dayInterval = interval === null || interval === void 0 ? void 0 : interval.dayInterval;\r\n            // default: send data every 3 month each year\r\n            if (isNullOrUndefined(monthInterval) && isNullOrUndefined(dayInterval)) {\r\n                interval.monthInterval = 3;\r\n                if (!_isSpecificDaysGiven) {\r\n                    // default: send data on 28th\r\n                    interval[_DYN_DAYS_OF_MONTH /* @min:%2edaysOfMonth */] = [28];\r\n                    _isSpecificDaysGiven = true;\r\n                }\r\n            }\r\n            interval = {\r\n                // dafault: sent every three months\r\n                monthInterval: interval === null || interval === void 0 ? void 0 : interval.monthInterval,\r\n                dayInterval: interval === null || interval === void 0 ? void 0 : interval.dayInterval,\r\n                daysOfMonth: interval === null || interval === void 0 ? void 0 : interval.daysOfMonth\r\n            };\r\n            return interval;\r\n        }\r\n        function _canThrottle(config, canUseLocalStorage, localStorageObj) {\r\n            if (!config[_DYN_DISABLED /* @min:%2edisabled */] && canUseLocalStorage && isNotNullOrUndefined(localStorageObj)) {\r\n                var curDate = _getThrottleDate();\r\n                var date = localStorageObj[_DYN_DATE /* @min:%2edate */];\r\n                var interval = config[_DYN_INTERVAL /* @min:%2einterval */];\r\n                var monthCheck = 1;\r\n                if (interval === null || interval === void 0 ? void 0 : interval.monthInterval) {\r\n                    var monthExpand = (curDate.getUTCFullYear() - date.getUTCFullYear()) * 12 + curDate.getUTCMonth() - date.getUTCMonth();\r\n                    monthCheck = _checkInterval(interval.monthInterval, 0, monthExpand);\r\n                }\r\n                var dayCheck = 1;\r\n                if (_isSpecificDaysGiven) {\r\n                    dayCheck = arrIndexOf(interval[_DYN_DAYS_OF_MONTH /* @min:%2edaysOfMonth */], curDate[_DYN_GET_UTCDATE /* @min:%2egetUTCDate */]());\r\n                }\r\n                else if (interval === null || interval === void 0 ? void 0 : interval.dayInterval) {\r\n                    var daySpan = Math.floor((curDate.getTime() - date.getTime()) / 86400000);\r\n                    dayCheck = _checkInterval(interval.dayInterval, 0, daySpan);\r\n                }\r\n                return monthCheck >= 0 && dayCheck >= 0;\r\n            }\r\n            return false;\r\n        }\r\n        function _getLocalStorageName(msgKey, prefix) {\r\n            var fix = isNotNullOrUndefined(prefix) ? prefix : \"\";\r\n            if (msgKey) {\r\n                return THROTTLE_STORAGE_PREFIX + fix + \"-\" + msgKey;\r\n            }\r\n            return null;\r\n        }\r\n        // returns if throttle is triggered on current Date\r\n        function _isTriggeredOnCurDate(preTriggerDate) {\r\n            try {\r\n                if (preTriggerDate) {\r\n                    var curDate = new Date();\r\n                    return preTriggerDate.getUTCFullYear() === curDate.getUTCFullYear() &&\r\n                        preTriggerDate.getUTCMonth() === curDate.getUTCMonth() &&\r\n                        preTriggerDate[_DYN_GET_UTCDATE /* @min:%2egetUTCDate */]() === curDate[_DYN_GET_UTCDATE /* @min:%2egetUTCDate */]();\r\n                }\r\n            }\r\n            catch (e) {\r\n                // eslint-disable-next-line no-empty\r\n            }\r\n            return false;\r\n        }\r\n        // transfer local storage string value to object that identifies start date, current count and preTriggerDate\r\n        function _getLocalStorageObj(value, logger, storageName) {\r\n            try {\r\n                var storageObj = {\r\n                    date: _getThrottleDate(),\r\n                    count: 0\r\n                };\r\n                if (value) {\r\n                    var obj = JSON.parse(value);\r\n                    return {\r\n                        date: _getThrottleDate(obj[_DYN_DATE /* @min:%2edate */]) || storageObj[_DYN_DATE /* @min:%2edate */],\r\n                        count: obj[_DYN_COUNT /* @min:%2ecount */] || storageObj[_DYN_COUNT /* @min:%2ecount */],\r\n                        preTriggerDate: obj.preTriggerDate ? _getThrottleDate(obj[_DYN_PRE_TRIGGER_DATE /* @min:%2epreTriggerDate */]) : undefined\r\n                    };\r\n                }\r\n                else {\r\n                    _resetLocalStorage(logger, storageName, storageObj);\r\n                    return storageObj;\r\n                }\r\n            }\r\n            catch (e) {\r\n                // eslint-disable-next-line no-empty\r\n            }\r\n            return null;\r\n        }\r\n        // if datestr is not defined, current date will be returned\r\n        function _getThrottleDate(dateStr) {\r\n            // if new Date() can't be created through the provided dateStr, null will be returned.\r\n            try {\r\n                if (dateStr) {\r\n                    var date = new Date(dateStr);\r\n                    //make sure it is a valid Date Object\r\n                    if (!isNaN(date.getDate())) {\r\n                        return date;\r\n                    }\r\n                }\r\n                else {\r\n                    return new Date();\r\n                }\r\n            }\r\n            catch (e) {\r\n                // eslint-disable-next-line no-empty\r\n            }\r\n            return null;\r\n        }\r\n        function _resetLocalStorage(logger, storageName, obj) {\r\n            try {\r\n                return utlSetLocalStorage(logger, storageName, strTrim(JSON[_DYN_STRINGIFY /* @min:%2estringify */](obj)));\r\n            }\r\n            catch (e) {\r\n                //     // eslint-disable-next-line no-empty\r\n            }\r\n            return false;\r\n        }\r\n        function _checkInterval(interval, start, current) {\r\n            if (interval <= 0) {\r\n                return 1;\r\n            }\r\n            // count from start year\r\n            return (current >= start) && (current - start) % interval == 0 ? Math.floor((current - start) / interval) + 1 : -1;\r\n        }\r\n        function _sendMessage(msgID, logger, message, severity) {\r\n            _throwInternal(logger, severity || 1 /* eLoggingSeverity.CRITICAL */, msgID, message);\r\n        }\r\n        // NOTE: config.limit.samplingRate is set to 4 decimal places,\r\n        // so config.limit.samplingRate = 1 means 0.0001%\r\n        function _canSampledIn() {\r\n            return randomValue(1000000) <= _config.limit.samplingRate;\r\n        }\r\n    }\r\n    return ThrottleMgr;\r\n}());\r\nexport { ThrottleMgr };\r\n//# sourceMappingURL=ThrottleMgr.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;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;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;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;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;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;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;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;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;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;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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}

package/dist-esm/UrlHelperFuncs.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-02
+ * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-esm/Util.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-02
+ * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-esm/__DynamicConstants.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-02
+ * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-esm/applicationinsights-common.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-02
+ * Application Insights JavaScript SDK - Common, 3.0.0-beta.2303-03
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@microsoft/applicationinsights-common",
-    "version": "3.0.0-beta.2303-02",
+    "version": "3.0.0-beta.2303-03",
     "description": "Microsoft Application Insights Common JavaScript Library",
     "homepage": "https://github.com/microsoft/ApplicationInsights-JS#readme",
     "author": "Microsoft Application Insights Team",
@@ -51,7 +51,7 @@
     },
     "dependencies": {
         "@microsoft/applicationinsights-shims": "2.0.2",
-        "@microsoft/applicationinsights-core-js": "3.0.0-beta.2303-02",
+        "@microsoft/applicationinsights-core-js": "3.0.0-beta.2303-03",
         "@microsoft/dynamicproto-js": "^1.1.7",
         "@nevware21/ts-utils": ">= 0.8.1 < 2.x"
     },

package/src/Enums.ts

@@ -49,7 +49,17 @@ export const DistributedTracingModes = createEnumStyle<typeof eDistributedTracin
 export type DistributedTracingModes = number | eDistributedTracingModes;
 
 export const enum IThrottleMsgKey {
+    /**
+     * Default Message key for non pre-defined message
+     */
     default = 0,
+    /**
+     * Message key for ikey Deprecation
+     */
     ikeyDeprecate = 1,
+    /**
+     * Message key for cdn Deprecation
+     */
     cdnDeprecate = 2
 }
+

package/src/Interfaces/IThrottleMgr.ts

@@ -50,8 +50,9 @@ export interface IThrottleInterval {
 export interface IThrottleMgrConfig {
     /**
     * Identifies message key to be used for local storage key
+    * Default: IThrottleMsgKey.default
     */
-    msgKey: IThrottleMsgKey;
+    msgKey?: IThrottleMsgKey;
 
     /**
     * Identifies if throttle is disabled
@@ -61,6 +62,7 @@ export interface IThrottleMgrConfig {
 
     /**
     * Identifies limit number/percentage of items sent per time
+    * Default: sampling percentage 0.01% with one item sent per time
     */
     limit?: IThrottleLimit;
 
@@ -106,4 +108,4 @@ export interface IThrottleResult {
     * if isThrottled is false, it will be set to 0
     */
     throttleNum: number;
-}
+}

package/src/ThrottleMgr.ts

@@ -1,6 +1,7 @@
 import {
-    IAppInsightsCore, IDiagnosticLogger, _eInternalMessageId, _throwInternal, arrForEach, arrIndexOf, eLoggingSeverity, isNotNullOrUndefined,
-    isNullOrUndefined, randomValue, safeGetLogger, strTrim
+    IAppInsightsCore, IDiagnosticLogger, IUnloadHookContainer, _eInternalMessageId, _throwInternal, arrForEach, arrIndexOf,
+    createDynamicConfig, createUnloadHookContainer, eLoggingSeverity, isNotNullOrUndefined, isNullOrUndefined, onConfigChange, randomValue,
+    safeGetLogger, strTrim
 } from "@microsoft/applicationinsights-core-js";
 import { IThrottleMsgKey } from "./Enums";
 import { IThrottleInterval, IThrottleLocalStorageObj, IThrottleMgrConfig, IThrottleResult } from "./Interfaces/IThrottleMgr";
@@ -22,8 +23,9 @@ export class ThrottleMgr {
     public isReady: () => boolean
     public onReadyState: (isReady?: boolean) => boolean;
     public flush: () => boolean;
+    public config: IThrottleMgrConfig;
 
-    constructor(throttleMgr?: IThrottleMgrConfig, core?: IAppInsightsCore, namePrefix?: string) {
+    constructor(config?: IThrottleMgrConfig, core?: IAppInsightsCore, namePrefix?: string, unloadHookContainer?: IUnloadHookContainer) {
         let _self = this;
         let _canUseLocalStorage: boolean;
         let _logger: IDiagnosticLogger | null | undefined;
@@ -38,6 +40,11 @@ export class ThrottleMgr {
 
         _initConfig();
 
+        // Special internal method to allow the unit tests and DebugPlugin to hook embedded objects
+        _self["_getDbgPlgTargets"] = () => {
+            return [_queue];
+        };
+
         _self.getConfig = (): IThrottleMgrConfig => {
             return _config;
         }
@@ -78,8 +85,10 @@ export class ThrottleMgr {
         _self.flush = (): boolean => {
             try {
                 if (_isReady && _queue.length > 0) {
-                    arrForEach(_queue, (item: SendMsgParameter) => {
-                        _self.sendMessage(item.msgID, item.message, item.severity);
+                    let items = _queue.slice(0);
+                    _queue = [];
+                    arrForEach(items, (item: SendMsgParameter) => {
+                        _flushMessage(item.msgID, item.message, item.severity, false);
                     });
                     return true;
                 }
@@ -101,6 +110,11 @@ export class ThrottleMgr {
         }
        
         _self.sendMessage = (msgID: _eInternalMessageId, message: string, severity?: eLoggingSeverity): IThrottleResult | null => {
+            return _flushMessage(msgID, message, severity, true);
+    
+        }
+
+        function _flushMessage(msgID: _eInternalMessageId, message: string, severity?: eLoggingSeverity, saveUnsentMsg?: boolean) {
             if (_isReady) {
                 let isSampledIn = _canSampledIn();
                 if (!isSampledIn) {
@@ -132,44 +146,55 @@ export class ThrottleMgr {
                     throttleNum: number
                 } as IThrottleResult;
             } else {
-                _queue.push({
-                    msgID: msgID,
-                    message: message,
-                    severity: severity
-                } as SendMsgParameter);
+                if (!!saveUnsentMsg) {
+                    _queue.push({
+                        msgID: msgID,
+                        message: message,
+                        severity: severity
+                    } as SendMsgParameter);
+                }
             }
             return null;
         }
         
         function _initConfig() {
-            _canUseLocalStorage = utlCanUseLocalStorage();
             _logger = safeGetLogger(core);
             _isTriggered = false;
-            _namePrefix = isNotNullOrUndefined(namePrefix)? namePrefix : "";
             _queue = [];
-            let configMgr = throttleMgr;
-            _config = {} as any;
-            _config.disabled = !!configMgr.disabled;
-            _config.msgKey = configMgr.msgKey;
+            _namePrefix = isNotNullOrUndefined(namePrefix)? namePrefix : "";
+            unloadHookContainer = unloadHookContainer || createUnloadHookContainer();
+            // Make sure the root config is dynamic as it may be the global config
+            config = createDynamicConfig(config as any || {}, null, _logger).cfg;
 
-            let configInterval = configMgr.interval || {};
-            _isSpecificDaysGiven = configInterval?.daysOfMonth && configInterval?.daysOfMonth.length > 0;
-            _config.interval = _getIntervalConfig(configInterval);
+            let unloadHook = onConfigChange((config), () => {
+                _canUseLocalStorage = utlCanUseLocalStorage();
+                
+                let configMgr = config || {};
+                _config = {} as any;
+                _config.disabled = !!configMgr.disabled;
 
-            let limit = {
-                samplingRate: configMgr.limit?.samplingRate || 100,
-                // dafault: every time sent only 1 event
-                maxSendNumber: configMgr.limit?.maxSendNumber || 1
-            };
-            _config.limit = limit;
-            _localStorageName = _getLocalStorageName(_config.msgKey, _namePrefix);
-            
-            if (_canUseLocalStorage && _localStorageName) {
-                _localStorageObj = _getLocalStorageObj(utlGetLocalStorage(_logger, _localStorageName), _logger, _localStorageName);
-            }
-            if (_localStorageObj) {
-                _isTriggered = _isTriggeredOnCurDate(_localStorageObj.preTriggerDate);
-            }
+                _config.msgKey = configMgr.msgKey || IThrottleMsgKey.default;
+    
+                let configInterval = configMgr.interval || {};
+                _isSpecificDaysGiven = configInterval?.daysOfMonth && configInterval?.daysOfMonth.length > 0;
+                _config.interval = _getIntervalConfig(configInterval);
+    
+                let limit = {
+                    samplingRate: configMgr.limit?.samplingRate || 100,
+                    // dafault: every time sent only 1 event
+                    maxSendNumber: configMgr.limit?.maxSendNumber || 1
+                };
+                _config.limit = limit;
+                _localStorageName = _getLocalStorageName(_config.msgKey, _namePrefix);
+                
+                if (_canUseLocalStorage && _localStorageName) {
+                    _localStorageObj = _getLocalStorageObj(utlGetLocalStorage(_logger, _localStorageName), _logger, _localStorageName);
+                }
+                if (_localStorageObj) {
+                    _isTriggered = _isTriggeredOnCurDate(_localStorageObj.preTriggerDate);
+                }
+            });
+            unloadHookContainer && unloadHookContainer.add(unloadHook);
         }
 
         function _getIntervalConfig(interval: IThrottleInterval) {
@@ -297,6 +322,9 @@ export class ThrottleMgr {
         }
 
         function _checkInterval(interval: number, start: number, current: number) {
+            if (interval <= 0) {
+                return 1;
+            }
             // count from start year
             return  (current >= start) && (current - start) % interval == 0 ? Math.floor((current - start) / interval) + 1 : -1;
         }

package/src/applicationinsights-common.ts

@@ -58,7 +58,6 @@ export { IPropertiesPlugin } from "./Interfaces/IPropertiesPlugin";
 export { IUser, IUserContext } from "./Interfaces/Context/IUser";
 export { ITelemetryTrace, ITraceState } from "./Interfaces/Context/ITelemetryTrace";
 export { IRequestContext } from "./Interfaces/IRequestContext";
-export { IThrottleLocalStorageObj, IThrottleMgrConfig, IThrottleResult, IThrottleLimit, IThrottleInterval } from "./Interfaces/IThrottleMgr";
 export { eDistributedTracingModes, DistributedTracingModes, IThrottleMsgKey } from "./Enums";
 export { stringToBoolOrDefault, msToTimeSpan, getExtensionByName, isCrossOriginError } from "./HelperFuncs";
 export {
@@ -71,6 +70,7 @@ export {
     utlCanUseSessionStorage, utlGetSessionStorageKeys, utlGetSessionStorage, utlSetSessionStorage, utlRemoveSessionStorage
 } from "./StorageHelperFuncs";
 export { urlParseUrl, urlGetAbsoluteUrl, urlGetPathName, urlGetCompleteUrl, urlParseHost, urlParseFullHost } from "./UrlHelperFuncs";
+export { IThrottleLimit, IThrottleInterval, IThrottleMgrConfig, IThrottleLocalStorageObj, IThrottleResult } from "./Interfaces/IThrottleMgr";
 
 export const PropertiesPluginIdentifier = "AppInsightsPropertiesPlugin";
 export const BreezeChannelIdentifier = "AppInsightsChannelPlugin";

package/types/Enums.d.ts

@@ -34,7 +34,16 @@ export declare const enum eDistributedTracingModes {
 export declare const DistributedTracingModes: import("@microsoft/applicationinsights-core-js").EnumValue<typeof eDistributedTracingModes>;
 export type DistributedTracingModes = number | eDistributedTracingModes;
 export declare const enum IThrottleMsgKey {
+    /**
+     * Default Message key for non pre-defined message
+     */
     default = 0,
+    /**
+     * Message key for ikey Deprecation
+     */
     ikeyDeprecate = 1,
+    /**
+     * Message key for cdn Deprecation
+     */
     cdnDeprecate = 2
 }

package/types/Interfaces/IThrottleMgr.d.ts

@@ -44,8 +44,9 @@ export interface IThrottleInterval {
 export interface IThrottleMgrConfig {
     /**
     * Identifies message key to be used for local storage key
+    * Default: IThrottleMsgKey.default
     */
-    msgKey: IThrottleMsgKey;
+    msgKey?: IThrottleMsgKey;
     /**
     * Identifies if throttle is disabled
     * Default: false
@@ -53,6 +54,7 @@ export interface IThrottleMgrConfig {
     disabled?: boolean;
     /**
     * Identifies limit number/percentage of items sent per time
+    * Default: sampling percentage 0.01% with one item sent per time
     */
     limit?: IThrottleLimit;
     /**

package/types/ThrottleMgr.d.ts

@@ -1,4 +1,4 @@
-import { IAppInsightsCore, _eInternalMessageId, eLoggingSeverity } from "@microsoft/applicationinsights-core-js";
+import { IAppInsightsCore, IUnloadHookContainer, _eInternalMessageId, eLoggingSeverity } from "@microsoft/applicationinsights-core-js";
 import { IThrottleMgrConfig, IThrottleResult } from "./Interfaces/IThrottleMgr";
 export declare class ThrottleMgr {
     canThrottle: () => boolean;
@@ -8,5 +8,6 @@ export declare class ThrottleMgr {
     isReady: () => boolean;
     onReadyState: (isReady?: boolean) => boolean;
     flush: () => boolean;
-    constructor(throttleMgr?: IThrottleMgrConfig, core?: IAppInsightsCore, namePrefix?: string);
+    config: IThrottleMgrConfig;
+    constructor(config?: IThrottleMgrConfig, core?: IAppInsightsCore, namePrefix?: string, unloadHookContainer?: IUnloadHookContainer);
 }

package/types/applicationinsights-common.d.ts

@@ -47,13 +47,13 @@ export { IPropertiesPlugin } from "./Interfaces/IPropertiesPlugin";
 export { IUser, IUserContext } from "./Interfaces/Context/IUser";
 export { ITelemetryTrace, ITraceState } from "./Interfaces/Context/ITelemetryTrace";
 export { IRequestContext } from "./Interfaces/IRequestContext";
-export { IThrottleLocalStorageObj, IThrottleMgrConfig, IThrottleResult, IThrottleLimit, IThrottleInterval } from "./Interfaces/IThrottleMgr";
 export { eDistributedTracingModes, DistributedTracingModes, IThrottleMsgKey } from "./Enums";
 export { stringToBoolOrDefault, msToTimeSpan, getExtensionByName, isCrossOriginError } from "./HelperFuncs";
 export { isBeaconsSupported as isBeaconApiSupported, ITraceParent, createTraceParent, parseTraceParent, isValidTraceId, isValidSpanId, isValidTraceParent, isSampledFlag, formatTraceParent, findW3cTraceParent } from "@microsoft/applicationinsights-core-js";
 export { createDomEvent } from "./DomHelperFuncs";
 export { utlDisableStorage, utlEnableStorage, utlCanUseLocalStorage, utlGetLocalStorage, utlSetLocalStorage, utlRemoveStorage, utlCanUseSessionStorage, utlGetSessionStorageKeys, utlGetSessionStorage, utlSetSessionStorage, utlRemoveSessionStorage } from "./StorageHelperFuncs";
 export { urlParseUrl, urlGetAbsoluteUrl, urlGetPathName, urlGetCompleteUrl, urlParseHost, urlParseFullHost } from "./UrlHelperFuncs";
+export { IThrottleLimit, IThrottleInterval, IThrottleMgrConfig, IThrottleLocalStorageObj, IThrottleResult } from "./Interfaces/IThrottleMgr";
 export declare const PropertiesPluginIdentifier = "AppInsightsPropertiesPlugin";
 export declare const BreezeChannelIdentifier = "AppInsightsChannelPlugin";
 export declare const AnalyticsPluginIdentifier = "ApplicationInsightsAnalytics";