@vvlad1973/simple-logger 2.1.6 → 2.1.8

package/dist/simple-logger.js

@@ -1,152 +1,152 @@
-/**
- * A module for simple logging with various logging levels.
- * @module SimpleLogger
- */
-import { getCallerName } from 'vvlad1973-utils';
-const loggerLevels = [
-    'trace',
-    'debug',
-    'info',
-    'warn',
-    'error',
-    'fatal',
-    'silent',
-];
-/**
- * A simple logger class with various logging levels.
- * @class
- * @param {string} [level='info'] - Initial logging level.
- * @param {ExternalLogger | undefined | null} [externalLogger=null] - Optional external logger to use.
- */
-export class SimpleLogger {
-    #levels = loggerLevels;
-    #currentLevel = 2;
-    #logger = console;
-    isExternal = false;
-    constructor(level, externalLogger) {
-        if (externalLogger && this.isValidLogger(externalLogger)) {
-            this.setExternalLogger(externalLogger, level);
-        }
-        else {
-            this.setLevel(level ?? 'info');
-        }
-    }
-    trace = (...args) => { };
-    debug = (...args) => { };
-    info = (...args) => { };
-    warn = (...args) => { };
-    error = (...args) => { };
-    fatal = (...args) => { };
-    silent = (...args) => { };
-    /**
-     * Updates the logging methods based on the current logging level.
-     * @private
-     */
-    updateLoggingMethods() {
-        try {
-            const noop = (...args) => { };
-            this.trace =
-                this.#currentLevel <= 0 ? this.getExternalLoggerMethod('trace') : noop;
-            this.debug =
-                this.#currentLevel <= 1 ? this.getExternalLoggerMethod('debug') : noop;
-            this.info =
-                this.#currentLevel <= 2 ? this.getExternalLoggerMethod('info') : noop;
-            this.warn =
-                this.#currentLevel <= 3 ? this.getExternalLoggerMethod('warn') : noop;
-            this.error =
-                this.#currentLevel <= 4 ? this.getExternalLoggerMethod('error') : noop;
-            this.fatal =
-                this.#currentLevel <= 5
-                    ? this.getExternalLoggerMethod('fatal', 'error')
-                    : noop;
-            this.silent = noop;
-        }
-        catch (error) {
-            console.error(error);
-        }
-    }
-    /**
-     * Checks if the provided logger is valid.
-     * @private
-     * @param {any} logger - The logger to check.
-     * @returns {boolean} - True if the logger is valid, otherwise false.
-     */
-    isValidLogger(logger) {
-        return loggerLevels.every((method) => {
-            return typeof logger[method] === 'function';
-        });
-    }
-    /**
-     * Gets the external logger method for a specific level.
-     * @param {string} method - The logger method to get.
-     * @param {string} [fallbackMethod] - The fallback logger method to get.
-     * @returns {LoggerMethod} - The logger method or a no-op function.
-     * @private
-     */
-    getExternalLoggerMethod(method, fallbackMethod) {
-        try {
-            const loggerMethod = this.#logger[method];
-            if (typeof loggerMethod === 'function') {
-                return loggerMethod.bind(this.#logger);
-            }
-            else if (typeof fallbackMethod !== 'undefined') {
-                const fallbackLoggerMethod = this.#logger[fallbackMethod];
-                if (typeof fallbackLoggerMethod === 'function') {
-                    return fallbackLoggerMethod.bind(this.#logger);
-                }
-            }
-            return () => { };
-        }
-        catch (error) {
-            console.error(error);
-            return () => { };
-        }
-    }
-    /**
-     * Sets the logging level.
-     * @param {string} level - The logging level to set.
-     */
-    setLevel(level) {
-        const index = this.#levels.indexOf(level.toLowerCase());
-        if (index !== -1) {
-            this.#currentLevel = index;
-            if (typeof this.#logger.level === 'string') {
-                this.#logger.level = level;
-            }
-            this.updateLoggingMethods();
-        }
-    }
-    /**
-     * Sets an external logger to be used.
-     * @param {ExternalLogger | undefined | null} logger - The external logger to set.
-     */
-    setExternalLogger(logger, level) {
-        if (logger && this.isValidLogger(logger)) {
-            this.#logger = logger;
-            this.isExternal = true;
-        }
-        else {
-            this.#logger = console;
-            this.isExternal = false;
-        }
-        this.setLevel(level ?? logger?.level ?? this.#levels[this.#currentLevel]);
-    }
-    /**
-     * Logs the start of a function.
-     * @param {string} [functionName] - Optional function name to log.
-     */
-    logFunctionStart(functionName) {
-        const callerName = functionName || getCallerName();
-        this.trace(`Function start: ${callerName}`);
-    }
-    /**
-     * Logs the end of a function.
-     * @param {string} [functionName] - Optional function name to log.
-     */
-    logFunctionEnd(functionName) {
-        const callerName = functionName || getCallerName();
-        this.trace(`Function end: ${callerName}`);
-    }
-}
-export default SimpleLogger;
+/**
+ * A module for simple logging with various logging levels.
+ * @module SimpleLogger
+ */
+import { getCallerName } from 'vvlad1973-utils';
+const loggerLevels = [
+    'trace',
+    'debug',
+    'info',
+    'warn',
+    'error',
+    'fatal',
+    'silent',
+];
+/**
+ * A simple logger class with various logging levels.
+ * @class
+ * @param {string} [level='info'] - Initial logging level.
+ * @param {ExternalLogger | undefined | null} [externalLogger=null] - Optional external logger to use.
+ */
+export class SimpleLogger {
+    #levels = loggerLevels;
+    #currentLevel = 2;
+    #logger = console;
+    isExternal = false;
+    constructor(level, externalLogger) {
+        if (externalLogger && this.isValidLogger(externalLogger)) {
+            this.setExternalLogger(externalLogger, level);
+        }
+        else {
+            this.setLevel(level ?? 'info');
+        }
+    }
+    trace = (...args) => { };
+    debug = (...args) => { };
+    info = (...args) => { };
+    warn = (...args) => { };
+    error = (...args) => { };
+    fatal = (...args) => { };
+    silent = (...args) => { };
+    /**
+     * Updates the logging methods based on the current logging level.
+     * @private
+     */
+    updateLoggingMethods() {
+        try {
+            const noop = (...args) => { };
+            this.trace =
+                this.#currentLevel <= 0 ? this.getExternalLoggerMethod('trace') : noop;
+            this.debug =
+                this.#currentLevel <= 1 ? this.getExternalLoggerMethod('debug') : noop;
+            this.info =
+                this.#currentLevel <= 2 ? this.getExternalLoggerMethod('info') : noop;
+            this.warn =
+                this.#currentLevel <= 3 ? this.getExternalLoggerMethod('warn') : noop;
+            this.error =
+                this.#currentLevel <= 4 ? this.getExternalLoggerMethod('error') : noop;
+            this.fatal =
+                this.#currentLevel <= 5
+                    ? this.getExternalLoggerMethod('fatal', 'error')
+                    : noop;
+            this.silent = noop;
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+    /**
+     * Checks if the provided logger is valid.
+     * @private
+     * @param {any} logger - The logger to check.
+     * @returns {boolean} - True if the logger is valid, otherwise false.
+     */
+    isValidLogger(logger) {
+        return loggerLevels.every((method) => {
+            return typeof logger[method] === 'function';
+        });
+    }
+    /**
+     * Gets the external logger method for a specific level.
+     * @param {string} method - The logger method to get.
+     * @param {string} [fallbackMethod] - The fallback logger method to get.
+     * @returns {LoggerMethod} - The logger method or a no-op function.
+     * @private
+     */
+    getExternalLoggerMethod(method, fallbackMethod) {
+        try {
+            const loggerMethod = this.#logger[method];
+            if (typeof loggerMethod === 'function') {
+                return loggerMethod.bind(this.#logger);
+            }
+            else if (typeof fallbackMethod !== 'undefined') {
+                const fallbackLoggerMethod = this.#logger[fallbackMethod];
+                if (typeof fallbackLoggerMethod === 'function') {
+                    return fallbackLoggerMethod.bind(this.#logger);
+                }
+            }
+            return () => { };
+        }
+        catch (error) {
+            console.error(error);
+            return () => { };
+        }
+    }
+    /**
+     * Sets the logging level.
+     * @param {string} level - The logging level to set.
+     */
+    setLevel(level) {
+        const index = this.#levels.indexOf(level.toLowerCase());
+        if (index !== -1) {
+            this.#currentLevel = index;
+            if (typeof this.#logger.level === 'string') {
+                this.#logger.level = level;
+            }
+            this.updateLoggingMethods();
+        }
+    }
+    /**
+     * Sets an external logger to be used.
+     * @param {ExternalLogger | undefined | null} logger - The external logger to set.
+     */
+    setExternalLogger(logger, level) {
+        if (logger && this.isValidLogger(logger)) {
+            this.#logger = logger;
+            this.isExternal = true;
+        }
+        else {
+            this.#logger = console;
+            this.isExternal = false;
+        }
+        this.setLevel(level ?? logger?.level ?? this.#levels[this.#currentLevel]);
+    }
+    /**
+     * Logs the start of a function.
+     * @param {string} [functionName] - Optional function name to log.
+     */
+    logFunctionStart(functionName) {
+        const callerName = functionName || getCallerName();
+        this.trace(`Function start: ${callerName}`);
+    }
+    /**
+     * Logs the end of a function.
+     * @param {string} [functionName] - Optional function name to log.
+     */
+    logFunctionEnd(functionName) {
+        const callerName = functionName || getCallerName();
+        this.trace(`Function end: ${callerName}`);
+    }
+}
+export default SimpleLogger;
 //# sourceMappingURL=simple-logger.js.map

package/dist/types/simple-logger.types.d.ts

@@ -1,33 +1,33 @@
-import { LoggerLevels } from '../constants/constants';
-export type LoggerLevel = (typeof LoggerLevels)[keyof typeof LoggerLevels];
-export interface LogFn {
-    <T extends object>(obj: T, msg?: string, ...args: unknown[]): void;
-    (obj: unknown, msg?: string, ...args: unknown[]): void;
-    (msg: string, ...args: unknown[]): void;
-}
-export interface ExternalLogger {
-    trace?: LogFn;
-    debug?: LogFn;
-    info?: LogFn;
-    warn?: LogFn;
-    error?: LogFn;
-    fatal?: LogFn;
-    silent?: LogFn;
-    level?: string;
-    child?(bindings: Record<string, unknown>): ExternalLogger;
-}
-export type LoggerFactory = (options: Record<string, unknown>) => ExternalLogger;
-export interface LoggerOptions {
-    level?: LoggerLevel;
-    bindings?: Record<string, unknown>;
-    msgPrefix?: string;
-    transport?: unknown;
-    transports?: {
-        targets: Array<{
-            tag?: string;
-            [key: string]: unknown;
-        }>;
-    };
-    [key: string]: unknown;
-}
-export type PreparedLogCall = [string, ...unknown[]] | [object, string?, ...unknown[]] | null;
+import { LoggerLevels } from '../constants/constants';
+export type LoggerLevel = (typeof LoggerLevels)[keyof typeof LoggerLevels];
+export interface LogFn {
+    <T extends object>(obj: T, msg?: string, ...args: unknown[]): void;
+    (obj: unknown, msg?: string, ...args: unknown[]): void;
+    (msg: string, ...args: unknown[]): void;
+}
+export interface ExternalLogger {
+    trace?: LogFn;
+    debug?: LogFn;
+    info?: LogFn;
+    warn?: LogFn;
+    error?: LogFn;
+    fatal?: LogFn;
+    silent?: LogFn;
+    level?: string;
+    child?(bindings: Record<string, unknown>, options?: Record<string, unknown>): ExternalLogger;
+}
+export type LoggerFactory = (options: Record<string, unknown>) => ExternalLogger;
+export interface LoggerOptions {
+    level?: LoggerLevel;
+    bindings?: Record<string, unknown>;
+    msgPrefix?: string;
+    transport?: unknown;
+    transports?: {
+        targets: Array<{
+            tag?: string;
+            [key: string]: unknown;
+        }>;
+    };
+    [key: string]: unknown;
+}
+export type PreparedLogCall = [string, ...unknown[]] | [object, string?, ...unknown[]] | null;

package/dist/types/simple-logger.types.js

@@ -1,2 +1,2 @@
-export {};
+export {};
 //# sourceMappingURL=simple-logger.types.js.map

package/docs/assets/highlight.css

@@ -1,85 +1,85 @@
-:root {
-    --light-hl-0: #795E26;
-    --dark-hl-0: #DCDCAA;
-    --light-hl-1: #000000;
-    --dark-hl-1: #D4D4D4;
-    --light-hl-2: #A31515;
-    --dark-hl-2: #CE9178;
-    --light-hl-3: #AF00DB;
-    --dark-hl-3: #C586C0;
-    --light-hl-4: #001080;
-    --dark-hl-4: #9CDCFE;
-    --light-hl-5: #0000FF;
-    --dark-hl-5: #569CD6;
-    --light-hl-6: #0070C1;
-    --dark-hl-6: #4FC1FF;
-    --light-hl-7: #098658;
-    --dark-hl-7: #B5CEA8;
-    --light-hl-8: #008000;
-    --dark-hl-8: #6A9955;
-    --light-code-background: #FFFFFF;
-    --dark-code-background: #1E1E1E;
-}
-
-@media (prefers-color-scheme: light) { :root {
-    --hl-0: var(--light-hl-0);
-    --hl-1: var(--light-hl-1);
-    --hl-2: var(--light-hl-2);
-    --hl-3: var(--light-hl-3);
-    --hl-4: var(--light-hl-4);
-    --hl-5: var(--light-hl-5);
-    --hl-6: var(--light-hl-6);
-    --hl-7: var(--light-hl-7);
-    --hl-8: var(--light-hl-8);
-    --code-background: var(--light-code-background);
-} }
-
-@media (prefers-color-scheme: dark) { :root {
-    --hl-0: var(--dark-hl-0);
-    --hl-1: var(--dark-hl-1);
-    --hl-2: var(--dark-hl-2);
-    --hl-3: var(--dark-hl-3);
-    --hl-4: var(--dark-hl-4);
-    --hl-5: var(--dark-hl-5);
-    --hl-6: var(--dark-hl-6);
-    --hl-7: var(--dark-hl-7);
-    --hl-8: var(--dark-hl-8);
-    --code-background: var(--dark-code-background);
-} }
-
-:root[data-theme='light'] {
-    --hl-0: var(--light-hl-0);
-    --hl-1: var(--light-hl-1);
-    --hl-2: var(--light-hl-2);
-    --hl-3: var(--light-hl-3);
-    --hl-4: var(--light-hl-4);
-    --hl-5: var(--light-hl-5);
-    --hl-6: var(--light-hl-6);
-    --hl-7: var(--light-hl-7);
-    --hl-8: var(--light-hl-8);
-    --code-background: var(--light-code-background);
-}
-
-:root[data-theme='dark'] {
-    --hl-0: var(--dark-hl-0);
-    --hl-1: var(--dark-hl-1);
-    --hl-2: var(--dark-hl-2);
-    --hl-3: var(--dark-hl-3);
-    --hl-4: var(--dark-hl-4);
-    --hl-5: var(--dark-hl-5);
-    --hl-6: var(--dark-hl-6);
-    --hl-7: var(--dark-hl-7);
-    --hl-8: var(--dark-hl-8);
-    --code-background: var(--dark-code-background);
-}
-
-.hl-0 { color: var(--hl-0); }
-.hl-1 { color: var(--hl-1); }
-.hl-2 { color: var(--hl-2); }
-.hl-3 { color: var(--hl-3); }
-.hl-4 { color: var(--hl-4); }
-.hl-5 { color: var(--hl-5); }
-.hl-6 { color: var(--hl-6); }
-.hl-7 { color: var(--hl-7); }
-.hl-8 { color: var(--hl-8); }
-pre, code { background: var(--code-background); }
+:root {
+    --light-hl-0: #795E26;
+    --dark-hl-0: #DCDCAA;
+    --light-hl-1: #000000;
+    --dark-hl-1: #D4D4D4;
+    --light-hl-2: #A31515;
+    --dark-hl-2: #CE9178;
+    --light-hl-3: #AF00DB;
+    --dark-hl-3: #C586C0;
+    --light-hl-4: #001080;
+    --dark-hl-4: #9CDCFE;
+    --light-hl-5: #0000FF;
+    --dark-hl-5: #569CD6;
+    --light-hl-6: #0070C1;
+    --dark-hl-6: #4FC1FF;
+    --light-hl-7: #098658;
+    --dark-hl-7: #B5CEA8;
+    --light-hl-8: #008000;
+    --dark-hl-8: #6A9955;
+    --light-code-background: #FFFFFF;
+    --dark-code-background: #1E1E1E;
+}
+
+@media (prefers-color-scheme: light) { :root {
+    --hl-0: var(--light-hl-0);
+    --hl-1: var(--light-hl-1);
+    --hl-2: var(--light-hl-2);
+    --hl-3: var(--light-hl-3);
+    --hl-4: var(--light-hl-4);
+    --hl-5: var(--light-hl-5);
+    --hl-6: var(--light-hl-6);
+    --hl-7: var(--light-hl-7);
+    --hl-8: var(--light-hl-8);
+    --code-background: var(--light-code-background);
+} }
+
+@media (prefers-color-scheme: dark) { :root {
+    --hl-0: var(--dark-hl-0);
+    --hl-1: var(--dark-hl-1);
+    --hl-2: var(--dark-hl-2);
+    --hl-3: var(--dark-hl-3);
+    --hl-4: var(--dark-hl-4);
+    --hl-5: var(--dark-hl-5);
+    --hl-6: var(--dark-hl-6);
+    --hl-7: var(--dark-hl-7);
+    --hl-8: var(--dark-hl-8);
+    --code-background: var(--dark-code-background);
+} }
+
+:root[data-theme='light'] {
+    --hl-0: var(--light-hl-0);
+    --hl-1: var(--light-hl-1);
+    --hl-2: var(--light-hl-2);
+    --hl-3: var(--light-hl-3);
+    --hl-4: var(--light-hl-4);
+    --hl-5: var(--light-hl-5);
+    --hl-6: var(--light-hl-6);
+    --hl-7: var(--light-hl-7);
+    --hl-8: var(--light-hl-8);
+    --code-background: var(--light-code-background);
+}
+
+:root[data-theme='dark'] {
+    --hl-0: var(--dark-hl-0);
+    --hl-1: var(--dark-hl-1);
+    --hl-2: var(--dark-hl-2);
+    --hl-3: var(--dark-hl-3);
+    --hl-4: var(--dark-hl-4);
+    --hl-5: var(--dark-hl-5);
+    --hl-6: var(--dark-hl-6);
+    --hl-7: var(--dark-hl-7);
+    --hl-8: var(--dark-hl-8);
+    --code-background: var(--dark-code-background);
+}
+
+.hl-0 { color: var(--hl-0); }
+.hl-1 { color: var(--hl-1); }
+.hl-2 { color: var(--hl-2); }
+.hl-3 { color: var(--hl-3); }
+.hl-4 { color: var(--hl-4); }
+.hl-5 { color: var(--hl-5); }
+.hl-6 { color: var(--hl-6); }
+.hl-7 { color: var(--hl-7); }
+.hl-8 { color: var(--hl-8); }
+pre, code { background: var(--code-background); }