@vpmedia/simplify 1.32.0 → 1.33.0

package/SECURITY.md

@@ -0,0 +1,5 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you have found a possible vulnerability please email `andras at vpmedia dot hu`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/simplify",
-  "version": "1.32.0",
+  "version": "1.33.0",
   "description": "@vpmedia/simplify",
   "author": "Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)",
   "license": "MIT",
@@ -23,7 +23,7 @@
     "@eslint/js": "^9.37.0",
     "@vitest/coverage-v8": "^3.2.4",
     "eslint": "^9.37.0",
-    "eslint-plugin-jsdoc": "^61.1.0",
+    "eslint-plugin-jsdoc": "^61.1.4",
     "eslint-plugin-unicorn": "^61.0.2",
     "globals": "^16.4.0",
     "jsdom": "^27.0.0",
@@ -41,11 +41,15 @@
     "@types/node": "^24.7.2",
     "eventemitter3": "^5.0.1"
   },
+  "optionalDependencies": {
+    "@sentry/browser": "^10.20.0"
+  },
   "scripts": {
     "build": "exit 0",
-    "test": "vitest --coverage --pass-with-no-tests",
+    "check": "pnpm lint && pnpm test && pnpm typecheck",
+    "format": "prettier --write \"./**/*.{js,jsx,mjs,cjs,ts,tsx,json,md,css}\"",
     "lint": "eslint \"**/*.{js,jsx}\"",
-    "typecheck": "tsc",
-    "format": "prettier --write \"./**/*.{js,jsx,mjs,cjs,ts,tsx,json,md,css}\""
+    "test": "vitest --coverage",
+    "typecheck": "rm -rf types && tsc"
   }
 }

package/src/index.js

@@ -1,6 +1,11 @@
 // core
 export * from './const/http_status.js';
+export { AbstractLogHandler } from './logging/AbstractLogHandler.js';
+export { ConsoleLogHandler } from './logging/ConsoleLogHandler.js';
+export * from './logging/const.js';
 export { Logger } from './logging/Logger.js';
+export { OpenTelemetryLogHandler } from './logging/OpenTelemetryLogHandler.js';
+export { formatLogMessage, getLogLevelName } from './logging/util.js';
 export * from './pagelifecycle/const.js';
 export * from './pagelifecycle/event.js';
 export * from './pagelifecycle/typedef.js';

package/src/logging/AbstractLogHandler.js

@@ -0,0 +1,23 @@
+export class AbstractLogHandler {
+  /**
+   * Abstract log handler.
+   * @param {number} level - Log handler level.
+   */
+  constructor(level) {
+    this.level = level;
+  }
+
+  /**
+   * Emit log record.
+   * @param {import('./Logger.js').Logger} logger - Logger instance.
+   * @param {number} timestamp - Log timestamp.
+   * @param {number} level - Log level.
+   * @param {string} message - Log message.
+   * @param {object} extra - Log extra data.
+   * @param {Error} error - Log extra data.
+   * @throws {Error}
+   */
+  emit(logger, timestamp, level, message, extra, error) {
+    throw new Error('Not implemented.');
+  }
+}

package/src/logging/ConsoleLogHandler.js

@@ -0,0 +1,45 @@
+import { AbstractLogHandler } from './AbstractLogHandler.js';
+import { LOG_LEVEL_DEBUG } from './const.js';
+import { formatLogMessage } from './util.js';
+
+const CONSOLE_FUNCTIONS = [
+  null, // silent
+  console.debug, // debug
+  console.info, // info
+  console.warn, // warning
+  console.error, // error
+  console.error, // fatal
+];
+
+export class ConsoleLogHandler extends AbstractLogHandler {
+  /**
+   * Console log handler.
+   * @param {number} level - Log handler level.
+   */
+  constructor(level = LOG_LEVEL_DEBUG) {
+    super(level);
+  }
+
+  /**
+   * Emit log record.
+   * @param {import('./Logger.js').Logger} logger - Logger instance.
+   * @param {number} timestamp - Log timestamp.
+   * @param {number} level - Log level.
+   * @param {string} message - Log message.
+   * @param {object} extra - Log extra data.
+   * @param {Error} error - Log extra data.
+   * @throws {Error}
+   */
+  emit(logger, timestamp, level, message, extra, error) {
+    const logMessage = formatLogMessage(logger, timestamp, level, message);
+    const consoleFunction = CONSOLE_FUNCTIONS[level];
+    if (consoleFunction === null) {
+      return;
+    }
+    if (error) {
+      extra === null ? consoleFunction(logMessage, error) : consoleFunction(logMessage, error, extra);
+      return;
+    }
+    extra === null ? consoleFunction(logMessage) : consoleFunction(logMessage, extra);
+  }
+}

package/src/logging/Logger.js

@@ -1,128 +1,112 @@
 import { getURLParam } from '../util/getURLParam.js';
-import { getAppEnvironment } from './getAppEnvironment.js';
+import {
+  LOG_LEVEL_DEBUG,
+  LOG_LEVEL_ERROR,
+  LOG_LEVEL_FATAL,
+  LOG_LEVEL_INFO,
+  LOG_LEVEL_SILENT,
+  LOG_LEVEL_WARNING,
+} from './const.js';
+import { getAppEnvironment } from './util.js';
 
-export const LEVEL_DEBUG = 4;
-export const LEVEL_INFO = 3;
-export const LEVEL_WARN = 2;
-export const LEVEL_ERROR = 1;
-export const LEVEL_SILENT = 0;
+const ROOT_LOGGER_NAME = 'root';
 
 export class Logger {
   /**
-   * @type {(error: Error) => void}
+   * @type {import('./AbstractLogHandler.js').AbstractLogHandler[]}
    */
-  static exceptionHandler = null;
-  /**
-   * @type {(target: string, level: string, message: string, extraData: object) => void}
-   */
-  static suppressedLogHandler = null;
+  static handlers = [];
 
   /**
    * Creates a new Logger instance.
-   * @param {string} name - The logger name.
+   * @param {string} [name] - The logger name.
    */
-  constructor(name) {
-    this.name = name;
+  constructor(name = ROOT_LOGGER_NAME) {
+    this.name = name ?? ROOT_LOGGER_NAME;
     const appEnvironment = getAppEnvironment();
     const isProduction = appEnvironment === 'production' || appEnvironment === 'release';
-    const defaultLevel = isProduction ? LEVEL_SILENT : LEVEL_DEBUG;
+    const defaultLevel = isProduction ? LOG_LEVEL_SILENT : LOG_LEVEL_DEBUG;
     const parameterName = `log_${this.name.toLowerCase()}`;
     this.level = Number.parseInt(getURLParam(parameterName, getURLParam('log_all', defaultLevel)), 10);
   }
 
   /**
-   * TBD.
-   * @param {string} message - TBD.
-   * @param {object} extraData - TBD.
+   * Add log handler.
+   * @param {import('./AbstractLogHandler.js').AbstractLogHandler} handler - Log handler.
+   */
+  static addHandler = (handler) => {
+    Logger.handlers.push(handler);
+  };
+
+  /**
+   * Emit log record.
+   * @param {Logger} logger - Logger instance.
+   * @param {number} level - Log level.
+   * @param {string} message - Log message.
+   * @param {object} extra - Log extra data.
+   * @param {Error} [error] - Log exception.
    */
-  debug(message, extraData = null) {
-    if (this.level < LEVEL_DEBUG) {
-      if (Logger.suppressedLogHandler) {
-        Logger.suppressedLogHandler(this.name, 'debug', message, extraData);
+  static emit = (logger, level, message, extra, error) => {
+    const timestamp = Date.now();
+    for (const handler of Logger.handlers) {
+      if (handler.level >= level) {
+        handler.emit(logger, timestamp, level, message, extra, error);
       }
-      return;
-    }
-    const logMessage = `${Date.now()} [${this.name}] ${message}`;
-    if (extraData !== null) {
-      console.debug(logMessage, extraData);
-      return;
     }
-    console.debug(logMessage);
+  };
+
+  /**
+   * Emit debug log.
+   * @param {string} message - Log message.
+   * @param {object} [extra] - Log extra data.
+   */
+  debug(message, extra = null) {
+    Logger.emit(this, LOG_LEVEL_DEBUG, message, extra);
   }
 
   /**
-   * TBD.
-   * @param {string} message - TBD.
-   * @param {object} extraData - TBD.
+   * Emit info log.
+   * @param {string} message - Log message.
+   * @param {object} [extra] - Log extra data.
    */
-  info(message, extraData = null) {
-    if (this.level < LEVEL_INFO) {
-      if (Logger.suppressedLogHandler) {
-        Logger.suppressedLogHandler(this.name, 'info', message, extraData);
-      }
-      return;
-    }
-    const logMessage = `${Date.now()} [${this.name}] ${message}`;
-    if (extraData !== null) {
-      console.info(logMessage, extraData);
-      return;
-    }
-    console.info(logMessage);
+  info(message, extra = null) {
+    Logger.emit(this, LOG_LEVEL_INFO, message, extra);
   }
 
   /**
-   * TBD.
-   * @param {string} message - TBD.
-   * @param {object} extraData - TBD.
+   * Emit warning log.
+   * @param {string} message - Log message.
+   * @param {object} [extra] - Log extra data.
    */
-  warn(message, extraData = null) {
-    if (this.level < LEVEL_WARN) {
-      if (Logger.suppressedLogHandler) {
-        Logger.suppressedLogHandler(this.name, 'warning', message, extraData);
-      }
-      return;
-    }
-    const logMessage = `${Date.now()} [${this.name}] ${message}`;
-    if (extraData !== null) {
-      console.warn(logMessage, extraData);
-      return;
-    }
-    console.warn(logMessage);
+  warn(message, extra = null) {
+    Logger.emit(this, LOG_LEVEL_WARNING, message, extra);
   }
 
   /**
-   * TBD.
-   * @param {string} message - TBD.
-   * @param {object} extraData - TBD.
+   * Emit warning log.
+   * @param {string} message - Log message.
+   * @param {object} [extra] - Log extra data.
    */
-  error(message, extraData = null) {
-    if (this.level < LEVEL_ERROR) {
-      if (Logger.suppressedLogHandler) {
-        Logger.suppressedLogHandler(this.name, 'error', message, extraData);
-      }
-      return;
-    }
-    const logMessage = `${Date.now()} [${this.name}] ${message}`;
-    if (extraData !== null) {
-      console.error(logMessage, extraData);
-      return;
-    }
-    console.error(logMessage);
+  warning(message, extra = null) {
+    Logger.emit(this, LOG_LEVEL_WARNING, message, extra);
   }
 
   /**
-   * TBD.
-   * @param {string} message - TBD.
-   * @param {Error} exception - TBD.
+   * Emit error log.
+   * @param {string} message - Log message.
+   * @param {object} [extra] - Log extra data.
    */
-  exception(message, exception) {
-    if (Logger.exceptionHandler) {
-      Logger.exceptionHandler(exception);
-    }
-    if (this.level < LEVEL_ERROR) {
-      return;
-    }
-    const logMessage = `${Date.now()} [${this.name}] ${message}`;
-    console.error(logMessage, exception);
+  error(message, extra = null) {
+    Logger.emit(this, LOG_LEVEL_ERROR, message, extra);
+  }
+
+  /**
+   * Emit exception log.
+   * @param {string} message - Log message.
+   * @param {Error} error - Log error.
+   * @param {object} [extra] - Log extra data.
+   */
+  exception(message, error, extra = null) {
+    Logger.emit(this, LOG_LEVEL_FATAL, message, extra, error);
   }
 }

package/src/logging/Logger.test.js

@@ -1,14 +1,70 @@
-import { LEVEL_DEBUG, Logger } from './Logger.js';
+import { AbstractLogHandler } from './AbstractLogHandler.js';
+import { LOG_LEVEL_DEBUG, LOG_LEVEL_ERROR, LOG_LEVEL_FATAL, LOG_LEVEL_INFO, LOG_LEVEL_WARNING } from './const.js';
+import { Logger } from './Logger.js';
 
-test('Tests Logger', () => {
+class TestLogHandler extends AbstractLogHandler {
+  /**
+   * Test log handler.
+   */
+  constructor() {
+    super(LOG_LEVEL_DEBUG);
+    this.emitLogLogger = null;
+    this.emitLogTimestamp = null;
+    this.emitLogLevel = null;
+    this.emitLogMessage = null;
+    this.emitLogExtra = null;
+    this.emitLogError = null;
+  }
+
+  /**
+   * Emit log record.
+   * @param {import('./Logger.js').Logger} logger - Logger instance.
+   * @param {number} timestamp - Log timestamp.
+   * @param {number} level - Log level.
+   * @param {string} message - Log message.
+   * @param {object} extra - Log extra data.
+   * @param {Error} error - Log extra data.
+   */
+  emit(logger, timestamp, level, message, extra, error) {
+    this.emitLogLogger = logger;
+    this.emitLogTimestamp = timestamp;
+    this.emitLogLevel = level;
+    this.emitLogMessage = message;
+    this.emitLogExtra = extra;
+    this.emitLogError = error;
+  }
+}
+
+test('Tests Logger default level', () => {
+  const logger = new Logger('test');
+  expect(logger.level).toBe(LOG_LEVEL_DEBUG);
+});
+
+test('Tests Logger custom handler', () => {
   const logger = new Logger('test');
-  expect(Logger.exceptionHandler).toBe(null);
-  expect(logger.level).toBe(LEVEL_DEBUG);
-  let handledError = null;
-  const exceptionHandler = (error) => {
-    handledError = error;
-  };
-  Logger.exceptionHandler = exceptionHandler;
-  logger.exception('test', 'error');
-  expect(handledError).toBe('error');
+  const testLogHandler = new TestLogHandler();
+  Logger.addHandler(testLogHandler);
+  // debug
+  logger.debug('debug');
+  expect(testLogHandler.emitLogLevel).toBe(LOG_LEVEL_DEBUG);
+  expect(testLogHandler.emitLogMessage).toBe('debug');
+  // info
+  logger.info('info');
+  expect(testLogHandler.emitLogLevel).toBe(LOG_LEVEL_INFO);
+  expect(testLogHandler.emitLogMessage).toBe('info');
+  // info
+  logger.warn('warning');
+  expect(testLogHandler.emitLogLevel).toBe(LOG_LEVEL_WARNING);
+  expect(testLogHandler.emitLogMessage).toBe('warning');
+  // error
+  logger.error('error');
+  expect(testLogHandler.emitLogLevel).toBe(LOG_LEVEL_ERROR);
+  expect(testLogHandler.emitLogMessage).toBe('error');
+  // exception
+  logger.exception('test', new Error('test_error'), { context: 'ctx' });
+  expect(testLogHandler.emitLogLevel).toBe(LOG_LEVEL_FATAL);
+  expect(testLogHandler.emitLogMessage).toBe('test');
+  expect(testLogHandler.emitLogError.message).toBe('test_error');
+  expect(testLogHandler.emitLogLogger).toBe(logger);
+  expect(testLogHandler.emitLogExtra.context).toBe('ctx');
 });

package/src/logging/OpenTelemetryLogHandler.js

@@ -0,0 +1,31 @@
+import { AbstractLogHandler } from './AbstractLogHandler.js';
+import { LOG_LEVEL_DEBUG } from './const.js';
+
+export class OpenTelemetryLogHandler extends AbstractLogHandler {
+  /**
+   * Open Telemetry log handler.
+   * @param {number} level - Log handler level.
+   * @param {(logger: import('./Logger.js').Logger, timestamp: number, level: number, message: string, extra: object, error: Error) => void} emitter - Log handler emitter.
+   */
+  constructor(level = LOG_LEVEL_DEBUG, emitter) {
+    super(level);
+    this.emitter = emitter;
+  }
+
+  /**
+   * Emit log record.
+   * @param {import('./Logger.js').Logger} logger - Logger instance.
+   * @param {number} timestamp - Log timestamp.
+   * @param {number} level - Log level.
+   * @param {string} message - Log message.
+   * @param {object} extra - Log extra data.
+   * @param {Error} error - Log extra data.
+   * @throws {Error}
+   */
+  emit(logger, timestamp, level, message, extra, error) {
+    if (!this.emitter) {
+      return;
+    }
+    this.emitter(logger, timestamp, level, message, extra, error);
+  }
+}

package/src/logging/SentryLogHandler.js

@@ -0,0 +1,47 @@
+import { addBreadcrumb, captureException } from '@sentry/browser';
+import { AbstractLogHandler } from './AbstractLogHandler.js';
+import { LOG_LEVEL_DEBUG } from './const.js';
+import { getLogLevelName } from './util.js';
+
+const BREADCRUMB_CATEGORY = 'log';
+
+export class SentryLogHandler extends AbstractLogHandler {
+  /**
+   * Console log handler.
+   * @param {number} level - Log handler level.
+   */
+  constructor(level = LOG_LEVEL_DEBUG) {
+    super(level);
+  }
+
+  /**
+   * Emit log record.
+   * @param {import('./Logger.js').Logger} logger - Logger instance.
+   * @param {number} timestamp - Log timestamp.
+   * @param {number} level - Log level.
+   * @param {string} message - Log message.
+   * @param {object} extra - Log extra data.
+   * @param {Error} error - Log extra data.
+   * @throws {Error}
+   */
+  emit(logger, timestamp, level, message, extra, error) {
+    /** @type {import('@sentry/browser').SeverityLevel} */
+    // @ts-ignore
+    const levelName = getLogLevelName(level);
+    const logMessage = `[${logger.name}] ${message}`;
+    const breadcrumb = {
+      category: BREADCRUMB_CATEGORY,
+      message: logMessage,
+      level: levelName,
+      data: extra,
+    };
+    if (logger.level < level) {
+      // only capture breadcrumbs if logger is silenced with this level,
+      // so no console logs are present for Sentry.
+      addBreadcrumb(breadcrumb);
+    }
+    if (error) {
+      captureException(error);
+    }
+  }
+}

package/src/logging/const.js

@@ -0,0 +1,22 @@
+export const LOG_LEVEL_SILENT = 0;
+export const LOG_LEVEL_FATAL = 1;
+export const LOG_LEVEL_ERROR = 2;
+export const LOG_LEVEL_WARNING = 3;
+export const LOG_LEVEL_INFO = 4;
+export const LOG_LEVEL_DEBUG = 5;
+
+export const LOG_LEVEL_NAME_SILENT = 'silent';
+export const LOG_LEVEL_NAME_FATAL = 'fatal';
+export const LOG_LEVEL_NAME_ERROR = 'error';
+export const LOG_LEVEL_NAME_WARNING = 'warning';
+export const LOG_LEVEL_NAME_INFO = 'info';
+export const LOG_LEVEL_NAME_DEBUG = 'debug';
+
+export const LOG_LEVEL_NAMES = [
+  LOG_LEVEL_NAME_SILENT,
+  LOG_LEVEL_NAME_FATAL,
+  LOG_LEVEL_NAME_ERROR,
+  LOG_LEVEL_NAME_WARNING,
+  LOG_LEVEL_NAME_INFO,
+  LOG_LEVEL_NAME_DEBUG,
+];

package/src/logging/util.js

@@ -0,0 +1,41 @@
+import { LOG_LEVEL_NAMES } from './const.js';
+
+/**
+ * Format log message.
+ * @param {import('./Logger.js').Logger} logger - Logger target name.
+ * @param {number} timestamp - Log timestamp.
+ * @param {number} level - Log level.
+ * @param {string} message - Log message.
+ * @returns {string} Formatted log message.
+ */
+export const formatLogMessage = (logger, timestamp, level, message) => `${timestamp} [${logger.name}] ${message}`;
+
+/**
+ * Get log level name.
+ * @param {number} level - Log level.
+ * @returns {string} Log level name.
+ */
+export const getLogLevelName = (level) => LOG_LEVEL_NAMES[level];
+
+/**
+ * Returns the application environment identifier.
+ * @returns {string} App environment type.
+ */
+export const getAppEnvironment = () => {
+  let appEnvironment = 'local';
+  try {
+    if (import.meta['env'].VITE_APP_ENVIRONMENT) {
+      appEnvironment = import.meta['env'].VITE_APP_ENVIRONMENT;
+    }
+  } catch {
+    // pass
+  }
+  try {
+    if (process.env.APP_ENVIRONMENT) {
+      appEnvironment = process.env.APP_ENVIRONMENT;
+    }
+  } catch {
+    // pass
+  }
+  return appEnvironment;
+};

package/src/logging/util.test.js

@@ -0,0 +1,30 @@
+import {
+  LOG_LEVEL_DEBUG,
+  LOG_LEVEL_ERROR,
+  LOG_LEVEL_FATAL,
+  LOG_LEVEL_INFO,
+  LOG_LEVEL_NAME_DEBUG,
+  LOG_LEVEL_NAME_ERROR,
+  LOG_LEVEL_NAME_FATAL,
+  LOG_LEVEL_NAME_INFO,
+  LOG_LEVEL_NAME_SILENT,
+  LOG_LEVEL_NAME_WARNING,
+  LOG_LEVEL_SILENT,
+  LOG_LEVEL_WARNING,
+} from './const.js';
+import { formatLogMessage, getLogLevelName } from './util.js';
+
+test('formatLogMessage()', () => {
+  expect(
+    formatLogMessage({ name: 'loggerName' }, Date.now, LOG_LEVEL_INFO, 'logMessage').endsWith('[loggerName] logMessage')
+  ).toBe(true);
+});
+
+test('getLogLevelName()', () => {
+  expect(getLogLevelName(LOG_LEVEL_DEBUG)).toBe(LOG_LEVEL_NAME_DEBUG);
+  expect(getLogLevelName(LOG_LEVEL_INFO)).toBe(LOG_LEVEL_NAME_INFO);
+  expect(getLogLevelName(LOG_LEVEL_WARNING)).toBe(LOG_LEVEL_NAME_WARNING);
+  expect(getLogLevelName(LOG_LEVEL_ERROR)).toBe(LOG_LEVEL_NAME_ERROR);
+  expect(getLogLevelName(LOG_LEVEL_FATAL)).toBe(LOG_LEVEL_NAME_FATAL);
+  expect(getLogLevelName(LOG_LEVEL_SILENT)).toBe(LOG_LEVEL_NAME_SILENT);
+});

package/src/pagelifecycle/util.js

@@ -28,7 +28,7 @@ let currentDocumentState = null;
 
 let isInitialized = false;
 
-/** @type {{[key: string]: Function[]}} */
+/** @type {{[key: string]: (() => void)[]}} */
 let callbacks = {};
 
 /**

package/src/util/getURLParam.js

@@ -5,14 +5,14 @@ const urlSearchParams = new URLSearchParams(window.location.search);
 /**
  * TBD.
  * @param {string} key - TBD.
- * @param {*} defaultValue - TBD.
+ * @param {string | number | boolean} defaultValue - TBD.
  * @param {boolean} isSanitize - TBD.
  * @returns {string} TBD.
  */
 export const getURLParam = (key, defaultValue = null, isSanitize = true) => {
   const paramValue = urlSearchParams.get(key);
   if (paramValue === null || paramValue === undefined) {
-    return defaultValue;
+    return String(defaultValue);
   }
   if (isSanitize) {
     return sanitizeURLParam(paramValue);

package/types/index.d.ts

@@ -1,9 +1,13 @@
 export * from "./const/http_status.js";
+export * from "./logging/const.js";
 export * from "./pagelifecycle/const.js";
 export * from "./pagelifecycle/event.js";
 export * from "./pagelifecycle/typedef.js";
 export * from "./pagelifecycle/util.js";
+export { AbstractLogHandler } from "./logging/AbstractLogHandler.js";
+export { ConsoleLogHandler } from "./logging/ConsoleLogHandler.js";
 export { Logger } from "./logging/Logger.js";
+export { OpenTelemetryLogHandler } from "./logging/OpenTelemetryLogHandler.js";
 export { addLeadingZero } from "./util/addLeadingZero.js";
 export { capitalize } from "./util/capitalize.js";
 export { deepMerge } from "./util/deepMerge.js";
@@ -21,6 +25,7 @@ export { saveAsFile } from "./util/saveAsFile.js";
 export { serverDataToState } from "./util/serverDataToState.js";
 export { setObjValueByPath } from "./util/setObjValueByPath.js";
 export { underscoreToCamelCase } from "./util/underscoreToCamelCase.js";
+export { formatLogMessage, getLogLevelName } from "./logging/util.js";
 export { FetchError, fetchRetry, HTTP_0_ANY } from "./util/fetchRetry.js";
 export { addFloat, fixFloat, subFloat } from "./util/safeFloat.js";
 //# sourceMappingURL=index.d.ts.map

package/types/logging/AbstractLogHandler.d.ts

@@ -0,0 +1,20 @@
+export class AbstractLogHandler {
+    /**
+     * Abstract log handler.
+     * @param {number} level - Log handler level.
+     */
+    constructor(level: number);
+    level: number;
+    /**
+     * Emit log record.
+     * @param {import('./Logger.js').Logger} logger - Logger instance.
+     * @param {number} timestamp - Log timestamp.
+     * @param {number} level - Log level.
+     * @param {string} message - Log message.
+     * @param {object} extra - Log extra data.
+     * @param {Error} error - Log extra data.
+     * @throws {Error}
+     */
+    emit(logger: import("./Logger.js").Logger, timestamp: number, level: number, message: string, extra: object, error: Error): void;
+}
+//# sourceMappingURL=AbstractLogHandler.d.ts.map

package/types/logging/AbstractLogHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractLogHandler.d.ts","sourceRoot":"","sources":["../../src/logging/AbstractLogHandler.js"],"names":[],"mappings":"AAAA;IACE;;;OAGG;IACH,mBAFW,MAAM,EAIhB;IADC,cAAkB;IAGpB;;;;;;;;;OASG;IACH,aARW,OAAO,aAAa,EAAE,MAAM,aAC5B,MAAM,SACN,MAAM,WACN,MAAM,SACN,MAAM,SACN,KAAK,QAKf;CACF"}

package/types/logging/ConsoleLogHandler.d.ts

@@ -0,0 +1,9 @@
+export class ConsoleLogHandler extends AbstractLogHandler {
+    /**
+     * Console log handler.
+     * @param {number} level - Log handler level.
+     */
+    constructor(level?: number);
+}
+import { AbstractLogHandler } from './AbstractLogHandler.js';
+//# sourceMappingURL=ConsoleLogHandler.d.ts.map

package/types/logging/ConsoleLogHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleLogHandler.d.ts","sourceRoot":"","sources":["../../src/logging/ConsoleLogHandler.js"],"names":[],"mappings":"AAaA;IACE;;;OAGG;IACH,oBAFW,MAAM,EAIhB;CAwBF;mCA5CkC,yBAAyB"}

package/types/logging/Logger.d.ts

@@ -1,53 +1,65 @@
-export const LEVEL_DEBUG: 4;
-export const LEVEL_INFO: 3;
-export const LEVEL_WARN: 2;
-export const LEVEL_ERROR: 1;
-export const LEVEL_SILENT: 0;
 export class Logger {
     /**
-     * @type {(error: Error) => void}
+     * @type {import('./AbstractLogHandler.js').AbstractLogHandler[]}
      */
-    static exceptionHandler: (error: Error) => void;
+    static handlers: import("./AbstractLogHandler.js").AbstractLogHandler[];
     /**
-     * @type {(target: string, level: string, message: string, extraData: object) => void}
+     * Add log handler.
+     * @param {import('./AbstractLogHandler.js').AbstractLogHandler} handler - Log handler.
      */
-    static suppressedLogHandler: (target: string, level: string, message: string, extraData: object) => void;
+    static addHandler: (handler: import("./AbstractLogHandler.js").AbstractLogHandler) => void;
+    /**
+     * Emit log record.
+     * @param {Logger} logger - Logger instance.
+     * @param {number} level - Log level.
+     * @param {string} message - Log message.
+     * @param {object} extra - Log extra data.
+     * @param {Error} [error] - Log exception.
+     */
+    static emit: (logger: Logger, level: number, message: string, extra: object, error?: Error) => void;
     /**
      * Creates a new Logger instance.
-     * @param {string} name - The logger name.
+     * @param {string} [name] - The logger name.
      */
-    constructor(name: string);
+    constructor(name?: string);
     name: string;
     level: number;
     /**
-     * TBD.
-     * @param {string} message - TBD.
-     * @param {object} extraData - TBD.
+     * Emit debug log.
+     * @param {string} message - Log message.
+     * @param {object} [extra] - Log extra data.
+     */
+    debug(message: string, extra?: object): void;
+    /**
+     * Emit info log.
+     * @param {string} message - Log message.
+     * @param {object} [extra] - Log extra data.
      */
-    debug(message: string, extraData?: object): void;
+    info(message: string, extra?: object): void;
     /**
-     * TBD.
-     * @param {string} message - TBD.
-     * @param {object} extraData - TBD.
+     * Emit warning log.
+     * @param {string} message - Log message.
+     * @param {object} [extra] - Log extra data.
      */
-    info(message: string, extraData?: object): void;
+    warn(message: string, extra?: object): void;
     /**
-     * TBD.
-     * @param {string} message - TBD.
-     * @param {object} extraData - TBD.
+     * Emit warning log.
+     * @param {string} message - Log message.
+     * @param {object} [extra] - Log extra data.
      */
-    warn(message: string, extraData?: object): void;
+    warning(message: string, extra?: object): void;
     /**
-     * TBD.
-     * @param {string} message - TBD.
-     * @param {object} extraData - TBD.
+     * Emit error log.
+     * @param {string} message - Log message.
+     * @param {object} [extra] - Log extra data.
      */
-    error(message: string, extraData?: object): void;
+    error(message: string, extra?: object): void;
     /**
-     * TBD.
-     * @param {string} message - TBD.
-     * @param {Error} exception - TBD.
+     * Emit exception log.
+     * @param {string} message - Log message.
+     * @param {Error} error - Log error.
+     * @param {object} [extra] - Log extra data.
      */
-    exception(message: string, exception: Error): void;
+    exception(message: string, error: Error, extra?: object): void;
 }
 //# sourceMappingURL=Logger.d.ts.map

package/types/logging/Logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/logging/Logger.js"],"names":[],"mappings":"AAGA,0BAA2B,CAAC,CAAC;AAC7B,yBAA0B,CAAC,CAAC;AAC5B,yBAA0B,CAAC,CAAC;AAC5B,0BAA2B,CAAC,CAAC;AAC7B,2BAA4B,CAAC,CAAC;AAE9B;IACE;;OAEG;IACH,yBAFU,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAED;IAC/B;;OAEG;IACH,6BAFU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAElD;IAEnC;;;OAGG;IACH,kBAFW,MAAM,EAShB;IANC,aAAgB;IAKhB,cAAkG;IAGpG;;;;OAIG;IACH,eAHW,MAAM,cACN,MAAM,QAehB;IAED;;;;OAIG;IACH,cAHW,MAAM,cACN,MAAM,QAehB;IAED;;;;OAIG;IACH,cAHW,MAAM,cACN,MAAM,QAehB;IAED;;;;OAIG;IACH,eAHW,MAAM,cACN,MAAM,QAehB;IAED;;;;OAIG;IACH,mBAHW,MAAM,aACN,KAAK,QAWf;CACF"}
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/logging/Logger.js"],"names":[],"mappings":"AAaA;IACE;;OAEG;IACH,iBAFU,OAAO,yBAAyB,EAAE,kBAAkB,EAAE,CAE3C;IAerB;;;OAGG;IACH,oBAAqB,SAFV,OAAO,yBAAyB,EAAE,kBAEjB,UAE1B;IAEF;;;;;;;OAOG;IACH,cAAe,QANJ,MAMU,EAAE,OALZ,MAKiB,EAAE,SAJnB,MAI0B,EAAE,OAH5B,MAGiC,EAAE,QAFnC,KAEwC,UAOjD;IApCF;;;OAGG;IACH,mBAFW,MAAM,EAShB;IANC,aAAoC;IAKpC,cAAkG;IA4BpG;;;;OAIG;IACH,eAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,cAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,cAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,iBAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,eAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;;;OAKG;IACH,mBAJW,MAAM,SACN,KAAK,UACL,MAAM,QAIhB;CACF"}

package/types/logging/OpenTelemetryLogHandler.d.ts

@@ -0,0 +1,11 @@
+export class OpenTelemetryLogHandler extends AbstractLogHandler {
+    /**
+     * Open Telemetry log handler.
+     * @param {number} level - Log handler level.
+     * @param {(logger: import('./Logger.js').Logger, timestamp: number, level: number, message: string, extra: object, error: Error) => void} emitter - Log handler emitter.
+     */
+    constructor(level: number, emitter: (logger: import("./Logger.js").Logger, timestamp: number, level: number, message: string, extra: object, error: Error) => void);
+    emitter: (logger: import("./Logger.js").Logger, timestamp: number, level: number, message: string, extra: object, error: Error) => void;
+}
+import { AbstractLogHandler } from './AbstractLogHandler.js';
+//# sourceMappingURL=OpenTelemetryLogHandler.d.ts.map

package/types/logging/OpenTelemetryLogHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenTelemetryLogHandler.d.ts","sourceRoot":"","sources":["../../src/logging/OpenTelemetryLogHandler.js"],"names":[],"mappings":"AAGA;IACE;;;;OAIG;IACH,mBAHW,MAAM,WACN,CAAC,MAAM,EAAE,OAAO,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,EAKxI;IADC,kBAJkB,OAAO,aAAa,EAAE,MAAM,aAAa,MAAM,SAAS,MAAM,WAAW,MAAM,SAAS,MAAM,SAAS,KAAK,KAAK,IAAI,CAIjH;CAmBzB;mCA9BkC,yBAAyB"}

package/types/logging/SentryLogHandler.d.ts

@@ -0,0 +1,9 @@
+export class SentryLogHandler extends AbstractLogHandler {
+    /**
+     * Console log handler.
+     * @param {number} level - Log handler level.
+     */
+    constructor(level?: number);
+}
+import { AbstractLogHandler } from './AbstractLogHandler.js';
+//# sourceMappingURL=SentryLogHandler.d.ts.map

package/types/logging/SentryLogHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SentryLogHandler.d.ts","sourceRoot":"","sources":["../../src/logging/SentryLogHandler.js"],"names":[],"mappings":"AAOA;IACE;;;OAGG;IACH,oBAFW,MAAM,EAIhB;CAgCF;mCA7CkC,yBAAyB"}

package/types/logging/const.d.ts

@@ -0,0 +1,14 @@
+export const LOG_LEVEL_SILENT: 0;
+export const LOG_LEVEL_FATAL: 1;
+export const LOG_LEVEL_ERROR: 2;
+export const LOG_LEVEL_WARNING: 3;
+export const LOG_LEVEL_INFO: 4;
+export const LOG_LEVEL_DEBUG: 5;
+export const LOG_LEVEL_NAME_SILENT: "silent";
+export const LOG_LEVEL_NAME_FATAL: "fatal";
+export const LOG_LEVEL_NAME_ERROR: "error";
+export const LOG_LEVEL_NAME_WARNING: "warning";
+export const LOG_LEVEL_NAME_INFO: "info";
+export const LOG_LEVEL_NAME_DEBUG: "debug";
+export const LOG_LEVEL_NAMES: string[];
+//# sourceMappingURL=const.d.ts.map

package/types/logging/const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../src/logging/const.js"],"names":[],"mappings":"AAAA,+BAAgC,CAAC,CAAC;AAClC,8BAA+B,CAAC,CAAC;AACjC,8BAA+B,CAAC,CAAC;AACjC,gCAAiC,CAAC,CAAC;AACnC,6BAA8B,CAAC,CAAC;AAChC,8BAA+B,CAAC,CAAC;AAEjC,oCAAqC,QAAQ,CAAC;AAC9C,mCAAoC,OAAO,CAAC;AAC5C,mCAAoC,OAAO,CAAC;AAC5C,qCAAsC,SAAS,CAAC;AAChD,kCAAmC,MAAM,CAAC;AAC1C,mCAAoC,OAAO,CAAC;AAE5C,uCAOE"}

package/types/logging/util.d.ts

@@ -0,0 +1,4 @@
+export function formatLogMessage(logger: import("./Logger.js").Logger, timestamp: number, level: number, message: string): string;
+export function getLogLevelName(level: number): string;
+export function getAppEnvironment(): string;
+//# sourceMappingURL=util.d.ts.map

package/types/logging/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/logging/util.js"],"names":[],"mappings":"AAUO,yCANI,OAAO,aAAa,EAAE,MAAM,aAC5B,MAAM,SACN,MAAM,WACN,MAAM,GACJ,MAAM,CAE8F;AAO1G,uCAHI,MAAM,GACJ,MAAM,CAE6C;AAMzD,qCAFM,MAAM,CAmBlB"}

package/types/util/getURLParam.d.ts

@@ -1,2 +1,2 @@
-export function getURLParam(key: string, defaultValue?: any, isSanitize?: boolean): string;
+export function getURLParam(key: string, defaultValue?: string | number | boolean, isSanitize?: boolean): string;
 //# sourceMappingURL=getURLParam.d.ts.map

package/types/util/getURLParam.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getURLParam.d.ts","sourceRoot":"","sources":["../../src/util/getURLParam.js"],"names":[],"mappings":"AAWO,iCALI,MAAM,iBACN,GAAC,eACD,OAAO,GACL,MAAM,CAWlB"}
+{"version":3,"file":"getURLParam.d.ts","sourceRoot":"","sources":["../../src/util/getURLParam.js"],"names":[],"mappings":"AAWO,iCALI,MAAM,iBACN,MAAM,GAAG,MAAM,GAAG,OAAO,eACzB,OAAO,GACL,MAAM,CAWlB"}

package/src/logging/getAppEnvironment.js

@@ -1,22 +0,0 @@
-/**
- * Returns the application environment identifier.
- * @returns {string} TBD.
- */
-export const getAppEnvironment = () => {
-  let appEnvironment = 'local';
-  try {
-    if (import.meta['env'].VITE_APP_ENVIRONMENT) {
-      appEnvironment = import.meta['env'].VITE_APP_ENVIRONMENT;
-    }
-  } catch {
-    // pass
-  }
-  try {
-    if (process.env.APP_ENVIRONMENT) {
-      appEnvironment = process.env.APP_ENVIRONMENT;
-    }
-  } catch {
-    // pass
-  }
-  return appEnvironment;
-};

package/types/logging/getAppEnvironment.d.ts

@@ -1,2 +0,0 @@
-export function getAppEnvironment(): string;
-//# sourceMappingURL=getAppEnvironment.d.ts.map

package/types/logging/getAppEnvironment.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getAppEnvironment.d.ts","sourceRoot":"","sources":["../../src/logging/getAppEnvironment.js"],"names":[],"mappings":"AAIO,qCAFM,MAAM,CAmBlB"}

package/types/util/cloneObject.d.ts

@@ -1,7 +0,0 @@
-/**
- * Clones an object.
- * @param {object} source - A reference to the source object.
- * @returns {object} The cloned object.
- */
-export function cloneObject(source: object): object;
-//# sourceMappingURL=cloneObject.d.ts.map

package/types/util/cloneObject.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cloneObject.d.ts","sourceRoot":"","sources":["../../src/util/cloneObject.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oCAHW,MAAM,GACJ,MAAM,CAKlB"}

package/types/util/deg2rot.d.ts

@@ -1,2 +0,0 @@
-export function deg2rad(deg: number): number;
-//# sourceMappingURL=deg2rot.d.ts.map

package/types/util/deg2rot.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deg2rot.d.ts","sourceRoot":"","sources":["../../src/util/deg2rot.js"],"names":[],"mappings":"AAKO,6BAHI,MAAM,GACJ,MAAM,CAIlB"}