@atlassian/clientside-extensions-debug 2.4.0-69e0f9e-kugbhrvw

package/LICENSE.txt

@@ -0,0 +1,30 @@
+Copyright (c) 2019 - Atlassian Software Systems Pty Ltd
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+
+    * Neither the name of Atlassian Software Systems Pty Ltd nor the names of
+      its contributors may be used to endorse or promote products derived from
+      this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,7 @@
+# Client-side Extensions
+
+## Debug utilities
+
+Set of utils that provide debug capabilities for client-side extensions system.
+
+Refer to the [official documentation](https://developer.atlassian.com/server/framework/clientside-extensions) for more information.

package/dist/cjs/debug-state-env.test.js

@@ -0,0 +1,63 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable  no-underscore-dangle */
+const logger_1 = require("./logger/logger");
+/**
+ * Using async imports in order to test process.env.NODE_ENV usage in module
+ * https://stackoverflow.com/a/48042799
+ */
+describe('debug-state initialization', () => {
+    const ORIGINAL_NODE_ENV = process.env.NODE_ENV;
+    beforeEach(() => {
+        // reset NODE_ENV to whatever it was.
+        process.env.NODE_ENV = ORIGINAL_NODE_ENV;
+        // reset cache of loaded modules. This will ensure that the module is re-initialized
+        // with the new NODE_ENV value
+        delete window.____c_p_d;
+        jest.resetModules();
+    });
+    it('should be set to FALSE if process.env.NODE_ENV is "production"', async () => {
+        process.env.NODE_ENV = 'production';
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const debugStateModule = await Promise.resolve().then(() => __importStar(require('./debug-state')));
+        expect(window.____c_p_d.__initialized).toBe(true);
+        expect(window.____c_p_d.debug).toBe(false);
+        expect(window.____c_p_d.logging).toBe(false);
+        expect(window.____c_p_d.validation).toBe(false);
+        expect(window.____c_p_d.discovery).toBe(false);
+    });
+    it('should set the default log level to "ERROR" if process.env.NODE_ENV is "production"', async () => {
+        process.env.NODE_ENV = 'production';
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        await Promise.resolve().then(() => __importStar(require('./debug-state')));
+        expect(window.____c_p_d.__initialized).toBe(true);
+        expect(window.____c_p_d.logLevel).toBe(logger_1.LogLevel.error);
+    });
+    it('should be set the default log level to "INFO" if process.env.NODE_ENV is different than "production"', async () => {
+        process.env.NODE_ENV = 'development';
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        await Promise.resolve().then(() => __importStar(require('./debug-state')));
+        expect(window.____c_p_d.__initialized).toBe(true);
+        expect(window.____c_p_d.logLevel).toBe(logger_1.LogLevel.info);
+    });
+});
+//# sourceMappingURL=debug-state-env.test.js.map

package/dist/cjs/debug-state-env.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-state-env.test.js","sourceRoot":"","sources":["../../lib/debug-state-env.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,0CAA0C;AAC1C,4CAA2C;AAE3C;;;GAGG;AACH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IACxC,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IAE/C,UAAU,CAAC,GAAG,EAAE;QACZ,qCAAqC;QACrC,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,iBAAiB,CAAC;QACzC,oFAAoF;QACpF,8BAA8B;QAC9B,OAAO,MAAM,CAAC,SAAS,CAAC;QACxB,IAAI,CAAC,YAAY,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC5E,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,YAAY,CAAC;QAEpC,6DAA6D;QAC7D,MAAM,gBAAgB,GAAG,wDAAa,eAAe,GAAC,CAAC;QAEvD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qFAAqF,EAAE,KAAK,IAAI,EAAE;QACjG,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,YAAY,CAAC;QAEpC,6DAA6D;QAC7D,wDAAa,eAAe,GAAC,CAAC;QAE9B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,iBAAQ,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sGAAsG,EAAE,KAAK,IAAI,EAAE;QAClH,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,aAAa,CAAC;QAErC,6DAA6D;QAC7D,wDAAa,eAAe,GAAC,CAAC;QAE9B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,iBAAQ,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC","sourcesContent":["/* eslint-disable  no-underscore-dangle */\nimport { LogLevel } from './logger/logger';\n\n/**\n * Using async imports in order to test process.env.NODE_ENV usage in module\n * https://stackoverflow.com/a/48042799\n */\ndescribe('debug-state initialization', () => {\n    const ORIGINAL_NODE_ENV = process.env.NODE_ENV;\n\n    beforeEach(() => {\n        // reset NODE_ENV to whatever it was.\n        process.env.NODE_ENV = ORIGINAL_NODE_ENV;\n        // reset cache of loaded modules. This will ensure that the module is re-initialized\n        // with the new NODE_ENV value\n        delete window.____c_p_d;\n        jest.resetModules();\n    });\n\n    it('should be set to FALSE if process.env.NODE_ENV is \"production\"', async () => {\n        process.env.NODE_ENV = 'production';\n\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const debugStateModule = await import('./debug-state');\n\n        expect(window.____c_p_d.__initialized).toBe(true);\n\n        expect(window.____c_p_d.debug).toBe(false);\n        expect(window.____c_p_d.logging).toBe(false);\n        expect(window.____c_p_d.validation).toBe(false);\n        expect(window.____c_p_d.discovery).toBe(false);\n    });\n\n    it('should set the default log level to \"ERROR\" if process.env.NODE_ENV is \"production\"', async () => {\n        process.env.NODE_ENV = 'production';\n\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        await import('./debug-state');\n\n        expect(window.____c_p_d.__initialized).toBe(true);\n        expect(window.____c_p_d.logLevel).toBe(LogLevel.error);\n    });\n\n    it('should be set the default log level to \"INFO\" if process.env.NODE_ENV is different than \"production\"', async () => {\n        process.env.NODE_ENV = 'development';\n\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        await import('./debug-state');\n\n        expect(window.____c_p_d.__initialized).toBe(true);\n        expect(window.____c_p_d.logLevel).toBe(LogLevel.info);\n    });\n});\n"]}

package/dist/cjs/debug-state.js

@@ -0,0 +1,155 @@
+"use strict";
+/* eslint-disable no-underscore-dangle */
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setLogLevel = exports.setDiscoveryEnabled = exports.setValidationEnabled = exports.setLoggingEnabled = exports.setDebugEnabled = exports.getLogLevel = exports.isDiscoveryEnabled = exports.isValidationEnabled = exports.isLoggingEnabled = exports.isDebugEnabled = exports.observeStateChange = void 0;
+const clientside_extensions_base_1 = require("@atlassian/clientside-extensions-base");
+const debug_subjects_1 = require("./debug-subjects");
+const logger_1 = require("./logger/logger");
+var ClientExtensionDebugTypes;
+(function (ClientExtensionDebugTypes) {
+    ClientExtensionDebugTypes["debug"] = "debug";
+    ClientExtensionDebugTypes["logging"] = "logging";
+    ClientExtensionDebugTypes["validation"] = "validation";
+    ClientExtensionDebugTypes["discovery"] = "discovery";
+    /** @since 2.1.0 */
+    ClientExtensionDebugTypes["logLevel"] = "logLevel";
+})(ClientExtensionDebugTypes || (ClientExtensionDebugTypes = {}));
+const defineDebugGlobal = (previousGlobal) => {
+    // initialize as boolean
+    const debugGlobal = Object.create(null);
+    const debugStates = {
+        debug: false,
+        logging: false,
+        validation: false,
+        discovery: false,
+        /** @since 2.1.0 */
+        // In dev mode we set default loglevel to INFO
+        logLevel: process.env.NODE_ENV === 'production' ? logger_1.LogLevel.error : logger_1.LogLevel.info,
+    };
+    const debugStateSubject = debug_subjects_1.registerDebugSubject("state" /* State */, () => new clientside_extensions_base_1.ReplaySubject(1));
+    const properties = {
+        debug: {
+            get() {
+                return debugStates.debug;
+            },
+            set(val) {
+                debugStates.debug = Boolean(val);
+                debugStateSubject.notify(debugStates);
+            },
+        },
+        logging: {
+            get() {
+                return debugStates.logging;
+            },
+            set(val) {
+                debugStates.logging = Boolean(val);
+                debugStateSubject.notify(debugStates);
+            },
+        },
+        validation: {
+            get() {
+                return debugStates.validation;
+            },
+            set(val) {
+                debugStates.validation = Boolean(val);
+                debugStateSubject.notify(debugStates);
+            },
+        },
+        discovery: {
+            get() {
+                return debugStates.discovery;
+            },
+            set(val) {
+                debugStates.discovery = Boolean(val);
+                debugStateSubject.notify(debugStates);
+            },
+        },
+        /** @since 2.1.0 */
+        logLevel: {
+            get() {
+                return debugStates.logLevel;
+            },
+            set(val) {
+                let level = String(val).toUpperCase();
+                // Handle runtime errors
+                if (!Object.values(logger_1.LogLevel).includes(level)) {
+                    level = logger_1.LogLevel.info;
+                }
+                debugStates.logLevel = level;
+                debugStateSubject.notify(debugStates);
+            },
+        },
+        __initialized: { value: true, writable: false },
+    };
+    Object.defineProperties(debugGlobal, properties);
+    Object.defineProperty(window, '____c_p_d', {
+        configurable: true,
+        get() {
+            return debugGlobal;
+        },
+        set(val) {
+            // its a boolean
+            if (val === true || val === false) {
+                debugGlobal.debug = val;
+                debugGlobal.logging = val;
+                debugGlobal.validation = val;
+                debugGlobal.discovery = val;
+                return;
+            }
+            // we can handle booleans - like above
+            // or objects (except null) and nothing else.
+            if (typeof val !== 'object' || val === null) {
+                return;
+            }
+            const clientExtensionDebugKeys = Object.keys(ClientExtensionDebugTypes);
+            clientExtensionDebugKeys.forEach((key) => {
+                if (key in val) {
+                    debugGlobal[key] = val[key];
+                }
+            });
+        },
+    });
+    // Now, we can use the previous value e.g. boolean, to set the value for all flags
+    window.____c_p_d = previousGlobal;
+};
+// Register global value only once
+if (!('____c_p_d' in window) || !window.____c_p_d.__initialized) {
+    defineDebugGlobal((_a = window.____c_p_d) !== null && _a !== void 0 ? _a : process.env.NODE_ENV !== 'production');
+}
+exports.observeStateChange = (observer) => debug_subjects_1.observeDebugSubject("state" /* State */, observer);
+exports.isDebugEnabled = () => {
+    return window.____c_p_d.debug;
+};
+exports.isLoggingEnabled = () => {
+    return window.____c_p_d.logging;
+};
+exports.isValidationEnabled = () => {
+    return window.____c_p_d.validation;
+};
+exports.isDiscoveryEnabled = () => {
+    return window.____c_p_d.discovery;
+};
+/** @since 2.1.0 */
+exports.getLogLevel = () => {
+    const logLevel = window.____c_p_d.logLevel;
+    return logLevel !== null && logLevel !== void 0 ? logLevel : logger_1.LogLevel.info;
+};
+exports.setDebugEnabled = (value) => {
+    window.____c_p_d.debug = value;
+};
+exports.setLoggingEnabled = (value) => {
+    window.____c_p_d.logging = value;
+};
+exports.setValidationEnabled = (value) => {
+    window.____c_p_d.validation = value;
+};
+exports.setDiscoveryEnabled = (value) => {
+    window.____c_p_d.discovery = value;
+};
+/** @since 2.1.0 */
+exports.setLogLevel = (value) => {
+    const level = value.toUpperCase();
+    window.____c_p_d.logLevel = level;
+};
+//# sourceMappingURL=debug-state.js.map

package/dist/cjs/debug-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-state.js","sourceRoot":"","sources":["../../lib/debug-state.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable no-underscore-dangle */\n\nimport type { Observer } from '@atlassian/clientside-extensions-base';\nimport { ReplaySubject } from '@atlassian/clientside-extensions-base';\nimport { DebugSubjects, observeDebugSubject, registerDebugSubject } from './debug-subjects';\nimport { LogLevel } from './logger/logger';\n\nenum ClientExtensionDebugTypes {\n    debug = 'debug',\n    logging = 'logging',\n    validation = 'validation',\n    discovery = 'discovery',\n    /** @since 2.1.0 */\n    logLevel = 'logLevel',\n}\n\ntype DebugTypeKeys = Exclude<keyof typeof ClientExtensionDebugTypes, 'logLevel'>;\n\nexport type ClientExtensionDebug = {\n    [key in DebugTypeKeys]: boolean;\n} & {\n    [ClientExtensionDebugTypes.logLevel]: LogLevel;\n};\n\nexport type ExposedClientExtensionDebug = { [key in keyof ClientExtensionDebug]: PropertyDescriptor } & {\n    __initialized: PropertyDescriptor;\n};\n\ndeclare global {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    interface Window {\n        // The global ____c_p_d is a primitive boolean value that holds additional properties\n        // Due to historical name changes the \"p\" still represents the old \"plugin\" nomenclature\n        ____c_p_d: ExposedClientExtensionDebug;\n    }\n}\n\nconst defineDebugGlobal = (previousGlobal: unknown) => {\n    // initialize as boolean\n    const debugGlobal = Object.create(null);\n    const debugStates: ClientExtensionDebug = {\n        debug: false,\n        logging: false,\n        validation: false,\n        discovery: false,\n        /** @since 2.1.0 */\n        // In dev mode we set default loglevel to INFO\n        logLevel: process.env.NODE_ENV === 'production' ? LogLevel.error : LogLevel.info,\n    };\n\n    const debugStateSubject = registerDebugSubject(DebugSubjects.State, () => new ReplaySubject(1));\n\n    const properties: ExposedClientExtensionDebug = {\n        debug: {\n            get() {\n                return debugStates.debug;\n            },\n            set(val: unknown) {\n                debugStates.debug = Boolean(val);\n                debugStateSubject.notify(debugStates);\n            },\n        },\n        logging: {\n            get() {\n                return debugStates.logging;\n            },\n            set(val: unknown) {\n                debugStates.logging = Boolean(val);\n                debugStateSubject.notify(debugStates);\n            },\n        },\n        validation: {\n            get() {\n                return debugStates.validation;\n            },\n            set(val: unknown) {\n                debugStates.validation = Boolean(val);\n                debugStateSubject.notify(debugStates);\n            },\n        },\n        discovery: {\n            get() {\n                return debugStates.discovery;\n            },\n            set(val: unknown) {\n                debugStates.discovery = Boolean(val);\n                debugStateSubject.notify(debugStates);\n            },\n        },\n        /** @since 2.1.0 */\n        logLevel: {\n            get() {\n                return debugStates.logLevel;\n            },\n            set(val: unknown) {\n                let level = String(val).toUpperCase() as LogLevel;\n\n                // Handle runtime errors\n                if (!Object.values(LogLevel).includes(level)) {\n                    level = LogLevel.info;\n                }\n\n                debugStates.logLevel = level;\n                debugStateSubject.notify(debugStates);\n            },\n        },\n        __initialized: { value: true, writable: false },\n    };\n    Object.defineProperties(debugGlobal, properties);\n\n    Object.defineProperty(window, '____c_p_d', {\n        configurable: true, // needed for testing :(\n        get() {\n            return debugGlobal;\n        },\n        set(val) {\n            // its a boolean\n            if (val === true || val === false) {\n                debugGlobal.debug = val;\n                debugGlobal.logging = val;\n                debugGlobal.validation = val;\n                debugGlobal.discovery = val;\n                return;\n            }\n\n            // we can handle booleans - like above\n            // or objects (except null) and nothing else.\n            if (typeof val !== 'object' || val === null) {\n                return;\n            }\n\n            const clientExtensionDebugKeys = Object.keys(ClientExtensionDebugTypes) as (keyof ClientExtensionDebug)[];\n\n            clientExtensionDebugKeys.forEach((key) => {\n                if (key in val) {\n                    debugGlobal[key] = val[key];\n                }\n            });\n        },\n    });\n\n    // Now, we can use the previous value e.g. boolean, to set the value for all flags\n    window.____c_p_d = previousGlobal as ExposedClientExtensionDebug;\n};\n\n// Register global value only once\nif (!('____c_p_d' in window) || !window.____c_p_d.__initialized) {\n    defineDebugGlobal(window.____c_p_d ?? process.env.NODE_ENV !== 'production');\n}\n\nexport const observeStateChange = (observer: Observer<ClientExtensionDebug>) =>\n    observeDebugSubject<ClientExtensionDebug>(DebugSubjects.State, observer);\n\nexport const isDebugEnabled = () => {\n    return window.____c_p_d.debug as boolean;\n};\n\nexport const isLoggingEnabled = () => {\n    return window.____c_p_d.logging as boolean;\n};\n\nexport const isValidationEnabled = () => {\n    return window.____c_p_d.validation as boolean;\n};\n\nexport const isDiscoveryEnabled = () => {\n    return window.____c_p_d.discovery as boolean;\n};\n\n/** @since 2.1.0 */\nexport const getLogLevel = (): LogLevel => {\n    const logLevel = window.____c_p_d.logLevel as LogLevel;\n\n    return logLevel ?? LogLevel.info;\n};\n\nexport const setDebugEnabled = (value: boolean) => {\n    (window.____c_p_d.debug as boolean) = value;\n};\n\nexport const setLoggingEnabled = (value: boolean) => {\n    (window.____c_p_d.logging as boolean) = value;\n};\n\nexport const setValidationEnabled = (value: boolean) => {\n    (window.____c_p_d.validation as boolean) = value;\n};\n\nexport const setDiscoveryEnabled = (value: boolean) => {\n    (window.____c_p_d.discovery as boolean) = value;\n};\n\n/** @since 2.1.0 */\nexport const setLogLevel = (value: string) => {\n    const level = value.toUpperCase() as LogLevel;\n\n    (window.____c_p_d.logLevel as LogLevel) = level;\n};\n"]}

package/dist/cjs/debug-state.test.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/* eslint-disable no-underscore-dangle, jest/no-standalone-expect */
+const jest_in_case_1 = tslib_1.__importDefault(require("jest-in-case"));
+const debug_state_1 = require("./debug-state");
+const logger_1 = require("./logger/logger");
+describe('debug utils', () => {
+    beforeEach(() => {
+        window.____c_p_d = false;
+    });
+    jest_in_case_1.default('should be active if respective flag is set to TRUE', (opts) => {
+        expect(opts.isUtil()).toBe(false);
+        // switch flag to TRUE
+        window.____c_p_d = { [opts.key]: true };
+        expect(opts.isUtil()).toBe(true);
+        // switch ALL false
+        window.____c_p_d = false;
+        expect(opts.isUtil()).toBe(false);
+        // switch ALL true
+        window.____c_p_d = true;
+        expect(opts.isUtil()).toBe(true);
+    }, {
+        isDebugEnabled: { isUtil: debug_state_1.isDebugEnabled, key: 'debug' },
+        isLoggingEnabled: { isUtil: debug_state_1.isLoggingEnabled, key: 'logging' },
+        isValidationEnabled: { isUtil: debug_state_1.isValidationEnabled, key: 'validation' },
+        isDiscoveryEnabled: { isUtil: debug_state_1.isDiscoveryEnabled, key: 'discovery' },
+    });
+    describe('log levels', () => {
+        let prevDebugState;
+        beforeEach(() => {
+            prevDebugState = window.____c_p_d;
+        });
+        afterEach(() => {
+            window.____c_p_d = prevDebugState;
+        });
+        it('should allow to change the default log level using utils', () => {
+            expect(debug_state_1.getLogLevel()).toBe(logger_1.LogLevel.info);
+            debug_state_1.setLogLevel(logger_1.LogLevel.debug);
+            expect(debug_state_1.getLogLevel()).toBe(logger_1.LogLevel.debug);
+        });
+        it('should allow to change log level using global variable', () => {
+            // Change with enum
+            window.____c_p_d.logLevel = logger_1.LogLevel.error;
+            expect(debug_state_1.getLogLevel()).toBe(logger_1.LogLevel.error);
+            // Change with string value
+            window.____c_p_d.logLevel = 'warn';
+            expect(debug_state_1.getLogLevel()).toBe(logger_1.LogLevel.warn);
+        });
+        it('should fallback to a default "INFO" level when using unsupported runtime value', () => {
+            window.____c_p_d.logLevel = 'show-me-all-the-things';
+            expect(debug_state_1.getLogLevel()).toBe(logger_1.LogLevel.info);
+        });
+    });
+    describe('compatibility mode', () => {
+        it('should fallback to a default "INFO" level when "logLevel" property is missing e.g. CSE < 2.1.0', () => {
+            Object.defineProperty(window, '____c_p_d', {
+                value: {},
+                configurable: true,
+                writable: true,
+            });
+            expect(debug_state_1.getLogLevel()).toBe(logger_1.LogLevel.info);
+        });
+    });
+});
+//# sourceMappingURL=debug-state.test.js.map

package/dist/cjs/debug-state.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-state.test.js","sourceRoot":"","sources":["../../lib/debug-state.test.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable no-underscore-dangle, jest/no-standalone-expect */\nimport cases from 'jest-in-case';\nimport type { ExposedClientExtensionDebug } from './debug-state';\nimport { isDebugEnabled, isDiscoveryEnabled, isLoggingEnabled, isValidationEnabled, getLogLevel, setLogLevel } from './debug-state';\nimport { LogLevel } from './logger/logger';\n\ndescribe('debug utils', () => {\n    beforeEach(() => {\n        (window.____c_p_d as unknown) = false;\n    });\n\n    cases(\n        'should be active if respective flag is set to TRUE',\n        (opts) => {\n            expect(opts.isUtil()).toBe(false);\n\n            // switch flag to TRUE\n            (window.____c_p_d as unknown) = { [opts.key]: true };\n\n            expect(opts.isUtil()).toBe(true);\n\n            // switch ALL false\n            (window.____c_p_d as unknown) = false;\n\n            expect(opts.isUtil()).toBe(false);\n\n            // switch ALL true\n            (window.____c_p_d as unknown) = true;\n\n            expect(opts.isUtil()).toBe(true);\n        },\n        {\n            isDebugEnabled: { isUtil: isDebugEnabled, key: 'debug' },\n            isLoggingEnabled: { isUtil: isLoggingEnabled, key: 'logging' },\n            isValidationEnabled: { isUtil: isValidationEnabled, key: 'validation' },\n            isDiscoveryEnabled: { isUtil: isDiscoveryEnabled, key: 'discovery' },\n        },\n    );\n\n    describe('log levels', () => {\n        let prevDebugState: ExposedClientExtensionDebug;\n\n        beforeEach(() => {\n            prevDebugState = window.____c_p_d;\n        });\n\n        afterEach(() => {\n            window.____c_p_d = prevDebugState;\n        });\n\n        it('should allow to change the default log level using utils', () => {\n            expect(getLogLevel()).toBe(LogLevel.info);\n\n            setLogLevel(LogLevel.debug);\n\n            expect(getLogLevel()).toBe(LogLevel.debug);\n        });\n\n        it('should allow to change log level using global variable', () => {\n            // Change with enum\n            (window.____c_p_d.logLevel as LogLevel) = LogLevel.error;\n            expect(getLogLevel()).toBe(LogLevel.error);\n\n            // Change with string value\n            (window.____c_p_d.logLevel as string) = 'warn';\n            expect(getLogLevel()).toBe(LogLevel.warn);\n        });\n\n        it('should fallback to a default \"INFO\" level when using unsupported runtime value', () => {\n            (window.____c_p_d.logLevel as string) = 'show-me-all-the-things';\n\n            expect(getLogLevel()).toBe(LogLevel.info);\n        });\n    });\n\n    describe('compatibility mode', () => {\n        it('should fallback to a default \"INFO\" level when \"logLevel\" property is missing e.g. CSE < 2.1.0', () => {\n            Object.defineProperty(window, '____c_p_d', {\n                value: {},\n                configurable: true,\n                writable: true,\n            });\n\n            expect(getLogLevel()).toBe(LogLevel.info);\n        });\n    });\n});\n"]}

package/dist/cjs/debug-subjects.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.observeDebugSubject = exports.registerDebugSubject = void 0;
+const defineSubjectGlobal = () => {
+    // initialize as boolean
+    const subjectGlobal = Object.create(null);
+    const properties = {
+        __initialized: { value: true, writable: false },
+        subjects: {
+            value: subjectGlobal,
+            writable: false,
+        },
+    };
+    Object.defineProperties(subjectGlobal, properties);
+    window.____c_p_s = subjectGlobal;
+};
+if (!('____c_p_s' in window) || !window.____c_p_s.__initialized) {
+    defineSubjectGlobal();
+}
+/**
+ * Registers a debug subject as singleton
+ *
+ * @param key
+ * @param subjectFactory
+ */
+exports.registerDebugSubject = (key, subjectFactory) => {
+    const debugSubjects = window.____c_p_s.subjects;
+    // good old singletons - ensure we do not register the same subject twice.
+    // we also can't fail as multiple instances might try to access the same, so instead we return the previously registered one.
+    if (!(key in debugSubjects)) {
+        debugSubjects[key] = subjectFactory();
+    }
+    return debugSubjects[key];
+};
+exports.observeDebugSubject = (key, observer) => {
+    const debugSubjects = window.____c_p_s.subjects;
+    if (!(key in debugSubjects)) {
+        throw new Error(`No subject registered for key: "${key}"`);
+    }
+    return debugSubjects[key].subscribe(observer);
+};
+//# sourceMappingURL=debug-subjects.js.map

package/dist/cjs/debug-subjects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-subjects.js","sourceRoot":"","sources":["../../lib/debug-subjects.ts"],"names":[],"mappings":";;;AAyBA,MAAM,mBAAmB,GAAG,GAAG,EAAE;IAC7B,wBAAwB;IACxB,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE1C,MAAM,UAAU,GAAmC;QAC/C,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC/C,QAAQ,EAAE;YACN,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE,KAAK;SAClB;KACJ,CAAC;IAEF,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAEnD,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC;AACrC,CAAC,CAAC;AAEF,IAAI,CAAC,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,EAAE;IAC7D,mBAAmB,EAAE,CAAC;CACzB;AAID;;;;;GAKG;AACU,QAAA,oBAAoB,GAAG,CAChC,GAAkB,EAClB,cAAiC,EACtB,EAAE;IACb,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,QAAyC,CAAC;IAEjF,0EAA0E;IAC1E,6HAA6H;IAC7H,IAAI,CAAC,CAAC,GAAG,IAAI,aAAa,CAAC,EAAE;QACzB,aAAa,CAAC,GAAG,CAAC,GAAG,cAAc,EAAE,CAAC;KACzC;IAED,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEW,QAAA,mBAAmB,GAAG,CAAc,GAAkB,EAAE,QAA+B,EAAE,EAAE;IACpG,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,QAAkD,CAAC;IAE1F,IAAI,CAAC,CAAC,GAAG,IAAI,aAAa,CAAC,EAAE;QACzB,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,GAAG,CAAC,CAAC;KAC9D;IAED,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC,CAAC","sourcesContent":["/* eslint-disable no-underscore-dangle */\nimport type { Observer, Subject } from '@atlassian/clientside-extensions-base';\n\ntype ExposedClientExtensionSubjects = {\n    __initialized: PropertyDescriptor;\n    subjects: PropertyDescriptor;\n};\n\nexport const enum DebugSubjects {\n    Logger = 'logger',\n    State = 'state',\n}\n\ntype DebugSubjectsMap<Subject> = {\n    [key in DebugSubjects]: Subject;\n};\n\ndeclare global {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    interface Window {\n        // Due to historical name changes the \"p\" still represents the old \"plugin\" nomenclature\n        ____c_p_s: ExposedClientExtensionSubjects;\n    }\n}\n\nconst defineSubjectGlobal = () => {\n    // initialize as boolean\n    const subjectGlobal = Object.create(null);\n\n    const properties: ExposedClientExtensionSubjects = {\n        __initialized: { value: true, writable: false },\n        subjects: {\n            value: subjectGlobal,\n            writable: false,\n        },\n    };\n\n    Object.defineProperties(subjectGlobal, properties);\n\n    window.____c_p_s = subjectGlobal;\n};\n\nif (!('____c_p_s' in window) || !window.____c_p_s.__initialized) {\n    defineSubjectGlobal();\n}\n\ntype UnpackPayloadType<SubjectType> = SubjectType extends Subject<infer U> ? U : never;\n\n/**\n * Registers a debug subject as singleton\n *\n * @param key\n * @param subjectFactory\n */\nexport const registerDebugSubject = <SubjectType extends Subject<PayloadType>, PayloadType = UnpackPayloadType<SubjectType>>(\n    key: DebugSubjects,\n    subjectFactory: () => SubjectType,\n): SubjectType => {\n    const debugSubjects = window.____c_p_s.subjects as DebugSubjectsMap<SubjectType>;\n\n    // good old singletons - ensure we do not register the same subject twice.\n    // we also can't fail as multiple instances might try to access the same, so instead we return the previously registered one.\n    if (!(key in debugSubjects)) {\n        debugSubjects[key] = subjectFactory();\n    }\n\n    return debugSubjects[key];\n};\n\nexport const observeDebugSubject = <PayloadType>(key: DebugSubjects, observer: Observer<PayloadType>) => {\n    const debugSubjects = window.____c_p_s.subjects as DebugSubjectsMap<Subject<PayloadType>>;\n\n    if (!(key in debugSubjects)) {\n        throw new Error(`No subject registered for key: \"${key}\"`);\n    }\n\n    return debugSubjects[key].subscribe(observer);\n};\n"]}

package/dist/cjs/debug-subjects.test.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const clientside_extensions_base_1 = require("@atlassian/clientside-extensions-base");
+const debug_subjects_1 = require("./debug-subjects");
+describe('debug-subject', () => {
+    const debugFactory = () => new clientside_extensions_base_1.Subject();
+    describe('registerDebugSubject', () => {
+        it('should create an register a subject under a given namespace', () => {
+            const subject = debug_subjects_1.registerDebugSubject("logger" /* Logger */, debugFactory);
+            expect(subject).toBeInstanceOf(clientside_extensions_base_1.Subject);
+        });
+        it('should not create a new instance for a previously registered key', () => {
+            const subject = debug_subjects_1.registerDebugSubject("state" /* State */, debugFactory);
+            const sameSubject = debug_subjects_1.registerDebugSubject("state" /* State */, debugFactory);
+            expect(subject).toBe(sameSubject);
+        });
+    });
+    describe('observeDebugSubject', () => {
+        it('should throw if the subject does not exist yet', () => {
+            // @ts-expect-error We are using a wrong subject key here
+            const unregisteredSubject = () => debug_subjects_1.observeDebugSubject('Foo', () => { });
+            expect(unregisteredSubject).toThrow(`No subject registered for key: "Foo"`);
+        });
+        it('should subscribe to a previously registered subject', () => {
+            const SUBJECT = "state" /* State */;
+            const TEST_PAYLOAD = 'some payload';
+            const observer = jest.fn();
+            const subject = debug_subjects_1.registerDebugSubject(SUBJECT, debugFactory);
+            debug_subjects_1.observeDebugSubject(SUBJECT, observer);
+            subject.notify(TEST_PAYLOAD);
+            expect(observer).toBeCalledWith(TEST_PAYLOAD);
+        });
+    });
+});
+//# sourceMappingURL=debug-subjects.test.js.map

package/dist/cjs/debug-subjects.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-subjects.test.js","sourceRoot":"","sources":["../../lib/debug-subjects.test.ts"],"names":[],"mappings":";;AAAA,sFAAgE;AAChE,qDAA4F;AAE5F,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC3B,MAAM,YAAY,GAAG,GAAoB,EAAE,CAAC,IAAI,oCAAO,EAAU,CAAC;IAElE,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACnE,MAAM,OAAO,GAAG,qCAAoB,wBAAuB,YAAY,CAAC,CAAC;YACzE,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,oCAAO,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;YACxE,MAAM,OAAO,GAAG,qCAAoB,sBAAsB,YAAY,CAAC,CAAC;YACxE,MAAM,WAAW,GAAG,qCAAoB,sBAAsB,YAAY,CAAC,CAAC;YAC5E,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACtD,yDAAyD;YACzD,MAAM,mBAAmB,GAAG,GAAG,EAAE,CAAC,oCAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEvE,MAAM,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC3D,MAAM,OAAO,sBAAsB,CAAC;YACpC,MAAM,YAAY,GAAG,cAAc,CAAC;YAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,qCAAoB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAC5D,oCAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEvC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC7B,MAAM,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC","sourcesContent":["import { Subject } from '@atlassian/clientside-extensions-base';\nimport { DebugSubjects, observeDebugSubject, registerDebugSubject } from './debug-subjects';\n\ndescribe('debug-subject', () => {\n    const debugFactory = (): Subject<string> => new Subject<string>();\n\n    describe('registerDebugSubject', () => {\n        it('should create an register a subject under a given namespace', () => {\n            const subject = registerDebugSubject(DebugSubjects.Logger, debugFactory);\n            expect(subject).toBeInstanceOf(Subject);\n        });\n\n        it('should not create a new instance for a previously registered key', () => {\n            const subject = registerDebugSubject(DebugSubjects.State, debugFactory);\n            const sameSubject = registerDebugSubject(DebugSubjects.State, debugFactory);\n            expect(subject).toBe(sameSubject);\n        });\n    });\n\n    describe('observeDebugSubject', () => {\n        it('should throw if the subject does not exist yet', () => {\n            // @ts-expect-error We are using a wrong subject key here\n            const unregisteredSubject = () => observeDebugSubject('Foo', () => {});\n\n            expect(unregisteredSubject).toThrow(`No subject registered for key: \"Foo\"`);\n        });\n\n        it('should subscribe to a previously registered subject', () => {\n            const SUBJECT = DebugSubjects.State;\n            const TEST_PAYLOAD = 'some payload';\n\n            const observer = jest.fn();\n            const subject = registerDebugSubject(SUBJECT, debugFactory);\n            observeDebugSubject(SUBJECT, observer);\n\n            subject.notify(TEST_PAYLOAD);\n            expect(observer).toBeCalledWith(TEST_PAYLOAD);\n        });\n    });\n});\n"]}

package/dist/cjs/debug.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onDebug = void 0;
+const debug_state_1 = require("./debug-state");
+const logger_1 = require("./logger/logger");
+// eslint-disable-next-line import/prefer-default-export
+exports.onDebug = (callback) => {
+    // Return early if both debug and logging is disabled
+    if (!debug_state_1.isDebugEnabled() || !debug_state_1.isLoggingEnabled()) {
+        return;
+    }
+    let payload;
+    try {
+        payload = callback(logger_1.LogLevel);
+    }
+    catch (e) {
+        // eslint-disable-next-line no-empty
+    }
+    if (payload) {
+        logger_1._loggerSubject.notify(payload);
+    }
+};
+//# sourceMappingURL=debug.js.map

package/dist/cjs/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../lib/debug.ts"],"names":[],"mappings":";;;AAAA,+CAAiE;AAGjE,4CAA2D;AAE3D,wDAAwD;AAC3C,QAAA,OAAO,GAAG,CAAC,QAAwB,EAAE,EAAE;IAChD,qDAAqD;IACrD,IAAI,CAAC,4BAAc,EAAE,IAAI,CAAC,8BAAgB,EAAE,EAAE;QAC1C,OAAO;KACV;IAED,IAAI,OAAkC,CAAC;IAEvC,IAAI;QACA,OAAO,GAAG,QAAQ,CAAC,iBAAQ,CAAC,CAAC;KAChC;IAAC,OAAO,CAAC,EAAE;QACR,oCAAoC;KACvC;IAED,IAAI,OAAO,EAAE;QACT,uBAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;KAClC;AACL,CAAC,CAAC","sourcesContent":["import { isDebugEnabled, isLoggingEnabled } from './debug-state';\n\nimport type { LoggerCallback, LoggerPayload } from './logger/logger';\nimport { _loggerSubject, LogLevel } from './logger/logger';\n\n// eslint-disable-next-line import/prefer-default-export\nexport const onDebug = (callback: LoggerCallback) => {\n    // Return early if both debug and logging is disabled\n    if (!isDebugEnabled() || !isLoggingEnabled()) {\n        return;\n    }\n\n    let payload: LoggerPayload | undefined;\n\n    try {\n        payload = callback(LogLevel);\n    } catch (e) {\n        // eslint-disable-next-line no-empty\n    }\n\n    if (payload) {\n        _loggerSubject.notify(payload);\n    }\n};\n"]}

package/dist/cjs/debug.test.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("ts-jest/utils");
+const debug_state_1 = require("./debug-state");
+const debug_1 = require("./debug");
+const logger_1 = require("./logger/logger");
+const default_logger_1 = require("./logger/default-logger");
+jest.mock('./debug-state');
+describe('onDebug util', () => {
+    const orgConsole = global.console;
+    beforeEach(() => {
+        utils_1.mocked(debug_state_1.isDebugEnabled).mockReturnValue(false);
+        utils_1.mocked(debug_state_1.isLoggingEnabled).mockReturnValue(false);
+        utils_1.mocked(debug_state_1.getLogLevel).mockReturnValue(logger_1.LogLevel.debug);
+        // Silent down console
+        global.console = {
+            ...orgConsole,
+            error: jest.fn(),
+            log: jest.fn(),
+            groupCollapsed: jest.fn(),
+        };
+    });
+    afterEach(() => {
+        utils_1.mocked(debug_state_1.isDebugEnabled).mockClear();
+        utils_1.mocked(debug_state_1.isLoggingEnabled).mockClear();
+        utils_1.mocked(debug_state_1.getLogLevel).mockClear();
+        global.console = orgConsole;
+    });
+    it('should only execute the given callback when debug and logging is enabled', () => {
+        const debugCallbackSpy = jest.fn();
+        // disable
+        utils_1.mocked(debug_state_1.isDebugEnabled).mockReturnValue(false);
+        utils_1.mocked(debug_state_1.isLoggingEnabled).mockReturnValue(false);
+        debug_1.onDebug(debugCallbackSpy);
+        expect(debugCallbackSpy).not.toHaveBeenCalled();
+        // enable
+        utils_1.mocked(debug_state_1.isDebugEnabled).mockReturnValue(true);
+        utils_1.mocked(debug_state_1.isLoggingEnabled).mockReturnValue(true);
+        debug_1.onDebug(debugCallbackSpy);
+        expect(debugCallbackSpy).toHaveBeenCalled();
+    });
+    it('should not notify the observer when logging is disabled', () => {
+        const payload = {
+            message: 'foo',
+            level: logger_1.LogLevel.error,
+        };
+        const loggerCallback = jest.fn(() => payload);
+        const loggerObserver = jest.fn();
+        // need to enable debug in order to run the debugCallback
+        utils_1.mocked(debug_state_1.isDebugEnabled).mockReturnValue(true);
+        // disable
+        utils_1.mocked(debug_state_1.isLoggingEnabled).mockReturnValue(false);
+        default_logger_1.observeLogger(loggerObserver);
+        debug_1.onDebug(loggerCallback);
+        expect(loggerCallback).not.toHaveBeenCalled();
+        expect(loggerObserver).not.toHaveBeenCalled();
+        // enable
+        utils_1.mocked(debug_state_1.isLoggingEnabled).mockReturnValue(true);
+        debug_1.onDebug(loggerCallback);
+        expect(loggerCallback).toHaveBeenCalledTimes(1);
+        expect(loggerObserver).toHaveBeenCalledWith(payload);
+    });
+    it('should not throw an error when logger callback fails', () => {
+        utils_1.mocked(debug_state_1.isDebugEnabled).mockReturnValue(true);
+        utils_1.mocked(debug_state_1.isLoggingEnabled).mockReturnValue(true);
+        const callOnDebug = () => {
+            const loggerCallback = () => {
+                throw new Error('ups');
+            };
+            debug_1.onDebug(loggerCallback);
+        };
+        expect(callOnDebug).not.toThrow();
+    });
+});
+//# sourceMappingURL=debug.test.js.map

package/dist/cjs/debug.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.test.js","sourceRoot":"","sources":["../../lib/debug.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { mocked } from 'ts-jest/utils';\nimport { getLogLevel, isDebugEnabled, isLoggingEnabled } from './debug-state';\nimport { onDebug } from './debug';\nimport { LogLevel } from './logger/logger';\nimport { observeLogger } from './logger/default-logger';\n\njest.mock('./debug-state');\n\ndescribe('onDebug util', () => {\n    const orgConsole = global.console;\n\n    beforeEach(() => {\n        mocked(isDebugEnabled).mockReturnValue(false);\n        mocked(isLoggingEnabled).mockReturnValue(false);\n        mocked(getLogLevel).mockReturnValue(LogLevel.debug);\n\n        // Silent down console\n        global.console = {\n            ...orgConsole,\n            error: jest.fn(),\n            log: jest.fn(),\n            groupCollapsed: jest.fn(),\n        };\n    });\n\n    afterEach(() => {\n        mocked(isDebugEnabled).mockClear();\n        mocked(isLoggingEnabled).mockClear();\n        mocked(getLogLevel).mockClear();\n\n        global.console = orgConsole;\n    });\n\n    it('should only execute the given callback when debug and logging is enabled', () => {\n        const debugCallbackSpy = jest.fn();\n\n        // disable\n        mocked(isDebugEnabled).mockReturnValue(false);\n        mocked(isLoggingEnabled).mockReturnValue(false);\n\n        onDebug(debugCallbackSpy);\n\n        expect(debugCallbackSpy).not.toHaveBeenCalled();\n\n        // enable\n        mocked(isDebugEnabled).mockReturnValue(true);\n        mocked(isLoggingEnabled).mockReturnValue(true);\n\n        onDebug(debugCallbackSpy);\n\n        expect(debugCallbackSpy).toHaveBeenCalled();\n    });\n\n    it('should not notify the observer when logging is disabled', () => {\n        const payload = {\n            message: 'foo',\n            level: LogLevel.error,\n        };\n        const loggerCallback = jest.fn(() => payload);\n        const loggerObserver = jest.fn();\n\n        // need to enable debug in order to run the debugCallback\n        mocked(isDebugEnabled).mockReturnValue(true);\n        // disable\n        mocked(isLoggingEnabled).mockReturnValue(false);\n\n        observeLogger(loggerObserver);\n        onDebug(loggerCallback);\n\n        expect(loggerCallback).not.toHaveBeenCalled();\n        expect(loggerObserver).not.toHaveBeenCalled();\n\n        // enable\n        mocked(isLoggingEnabled).mockReturnValue(true);\n        onDebug(loggerCallback);\n\n        expect(loggerCallback).toHaveBeenCalledTimes(1);\n        expect(loggerObserver).toHaveBeenCalledWith(payload);\n    });\n\n    it('should not throw an error when logger callback fails', () => {\n        mocked(isDebugEnabled).mockReturnValue(true);\n        mocked(isLoggingEnabled).mockReturnValue(true);\n\n        const callOnDebug = () => {\n            const loggerCallback = () => {\n                throw new Error('ups');\n            };\n\n            onDebug(loggerCallback);\n        };\n\n        expect(callOnDebug).not.toThrow();\n    });\n});\n"]}

package/dist/cjs/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var debug_1 = require("./debug");
+Object.defineProperty(exports, "onDebug", { enumerable: true, get: function () { return debug_1.onDebug; } });
+var logger_1 = require("./logger/logger");
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_1.LogLevel; } });
+var default_logger_1 = require("./logger/default-logger");
+/** @deprecated in 2.1.0 */ Object.defineProperty(exports, "observeLogger", { enumerable: true, get: function () { return default_logger_1.observeLogger; } });
+/** @since in 2.1.0 */ Object.defineProperty(exports, "setLogger", { enumerable: true, get: function () { return default_logger_1.setLogger; } });
+Object.defineProperty(exports, "_deregisterDefaultLogger", { enumerable: true, get: function () { return default_logger_1._deregisterDefaultLogger; } });
+var console_1 = require("./logger/console");
+Object.defineProperty(exports, "consoleLogger", { enumerable: true, get: function () { return console_1.consoleLogger; } });
+var debug_state_1 = require("./debug-state");
+Object.defineProperty(exports, "isDebugEnabled", { enumerable: true, get: function () { return debug_state_1.isDebugEnabled; } });
+Object.defineProperty(exports, "isLoggingEnabled", { enumerable: true, get: function () { return debug_state_1.isLoggingEnabled; } });
+Object.defineProperty(exports, "isDiscoveryEnabled", { enumerable: true, get: function () { return debug_state_1.isDiscoveryEnabled; } });
+Object.defineProperty(exports, "isValidationEnabled", { enumerable: true, get: function () { return debug_state_1.isValidationEnabled; } });
+Object.defineProperty(exports, "setDebugEnabled", { enumerable: true, get: function () { return debug_state_1.setDebugEnabled; } });
+Object.defineProperty(exports, "setLoggingEnabled", { enumerable: true, get: function () { return debug_state_1.setLoggingEnabled; } });
+Object.defineProperty(exports, "setDiscoveryEnabled", { enumerable: true, get: function () { return debug_state_1.setDiscoveryEnabled; } });
+Object.defineProperty(exports, "setValidationEnabled", { enumerable: true, get: function () { return debug_state_1.setValidationEnabled; } });
+Object.defineProperty(exports, "observeStateChange", { enumerable: true, get: function () { return debug_state_1.observeStateChange; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":";;AAAA,iCAAkC;AAAzB,gGAAA,OAAO,OAAA;AAEhB,0CAA2C;AAAlC,kGAAA,QAAQ,OAAA;AAEjB,0DAIiC;AAH7B,2BAA2B,CAAC,+GAAA,aAAa,OAAA;AACzC,sBAAsB,CAAC,2GAAA,SAAS,OAAA;AAChC,0HAAA,wBAAwB,OAAA;AAG5B,4CAAwE;AAAxC,wGAAA,aAAa,OAAA;AAE7C,6CAUuB;AATnB,6GAAA,cAAc,OAAA;AACd,+GAAA,gBAAgB,OAAA;AAChB,iHAAA,kBAAkB,OAAA;AAClB,kHAAA,mBAAmB,OAAA;AACnB,8GAAA,eAAe,OAAA;AACf,gHAAA,iBAAiB,OAAA;AACjB,kHAAA,mBAAmB,OAAA;AACnB,mHAAA,oBAAoB,OAAA;AACpB,iHAAA,kBAAkB,OAAA","sourcesContent":["export { onDebug } from './debug';\nexport type { LoggerPayload } from './logger/logger';\nexport { LogLevel } from './logger/logger';\n\nexport {\n    /** @deprecated in 2.1.0 */ observeLogger,\n    /** @since in 2.1.0 */ setLogger,\n    _deregisterDefaultLogger,\n} from './logger/default-logger';\n\nexport { /** @since in 2.1.0 */ consoleLogger } from './logger/console';\n\nexport {\n    isDebugEnabled,\n    isLoggingEnabled,\n    isDiscoveryEnabled,\n    isValidationEnabled,\n    setDebugEnabled,\n    setLoggingEnabled,\n    setDiscoveryEnabled,\n    setValidationEnabled,\n    observeStateChange,\n} from './debug-state';\n"]}