@vpmedia/simplify 1.74.0 → 1.76.0

package/dist/util/object.d.ts

@@ -0,0 +1,24 @@
+type AnyRecord = Record<string, any>;
+/**
+ * Purges object properties to free up memory.
+ */
+export declare const purgeObject: (target: AnyRecord | null | undefined) => void;
+/**
+ * Merge two objects.
+ */
+export declare const deepMerge: (target: AnyRecord | null, source: AnyRecord | null) => AnyRecord | null;
+/**
+ * Returns the sum value of an array of objects field.
+ */
+export declare const getObjArrayPropSum: (arr: AnyRecord[], prop: string) => number;
+/**
+ * Get object value by path.
+ */
+export declare const getObjValueByPath: (obj: AnyRecord | null | undefined, path: string | null | undefined) => unknown;
+/**
+ * Set object value by path.
+ * @throws {SyntaxError} Error when illegal path value has been provided.
+ */
+export declare const setObjValueByPath: (obj: AnyRecord | null | undefined, path: string | null | undefined, value: unknown) => void;
+export {};
+//# sourceMappingURL=object.d.ts.map

package/dist/util/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/util/object.ts"],"names":[],"mappings":"AAEA,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,SAAS,GAAG,IAAI,GAAG,SAAS,KAAG,IAOlE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,SAAS,GAAG,IAAI,EAAE,QAAQ,SAAS,GAAG,IAAI,KAAG,SAAS,GAAG,IAsB1F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,SAAS,EAAE,EAAE,MAAM,MAAM,KAAG,MACY,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,SAAS,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,OAatG,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,KAAK,SAAS,GAAG,IAAI,GAAG,SAAS,EACjC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,OAAO,OAAO,KACb,IAiBF,CAAC"}

package/dist/util/query.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sanitizes URL parameters allowing only alpha-numeric characters and dash.
+ */
+export declare function sanitizeURLParam(input: string): string;
+export declare function sanitizeURLParam(input: null | undefined): null | undefined;
+export declare function sanitizeURLParam(input: string | null | undefined): string | null | undefined;
+/**
+ * Get a URL parameter value.
+ */
+export declare function getURLParam<T = null>(key: string | null | undefined, defaultValue?: T, isSanitize?: boolean): string | T;
+//# sourceMappingURL=query.d.ts.map

package/dist/util/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/util/query.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;AACxD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;AAC5E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAQ9F;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,IAAI,EAClC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,YAAY,CAAC,EAAE,CAAC,EAChB,UAAU,CAAC,EAAE,OAAO,GACnB,MAAM,GAAG,CAAC,CAYZ"}

package/dist/util/state.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Maps server data to client data.
+ */
+export declare const serverDataToState: (data: unknown, isRecursive?: boolean) => any;
+//# sourceMappingURL=state.d.ts.map

package/dist/util/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/util/state.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,OAAO,EAAE,qBAAmB,KAAG,GAetE,CAAC"}

package/dist/util/string.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Add leading zeros to a value to ensure it has a minimum width.
+ */
+export declare const addLeadingZero: (value: number | string | null | undefined, size?: number) => string | null;
+/**
+ * Capitalize a string.
+ */
+export declare const capitalize: (value: string | null | undefined) => string | null;
+/**
+ * Converts underscore case string to camel case.
+ */
+export declare const underscoreToCamelCase: (value: string) => string;
+/**
+ * Saves text file.
+ */
+export declare const saveAsFile: (filename: string, text: string) => void;
+/**
+ * Get type from value in human readable format.
+ */
+export declare const getTypeFromValue: (value: unknown) => string;
+/**
+ * Get value in human readable format.
+ */
+export declare const getDisplayValue: (value: unknown) => string;
+//# sourceMappingURL=string.d.ts.map

package/dist/util/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/util/string.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,aAAQ,KAAG,MAAM,GAAG,IAS7F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,IAStE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,KAAG,MACG,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,EAAE,MAAM,MAAM,KAAG,IAQ3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,MACgB,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,MAQhD,CAAC"}

package/dist/util/uuid.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Convert a byte (0–255) to a 2-character hex string.
+ */
+export declare const byteToHex: (byte: number) => string;
+/**
+ * UUIDv4 fallback generator (RFC 4122 compliant).
+ */
+export declare const randomUUIDFallback: () => string;
+/**
+ * Crypto UUIDv4 wrapper with fallback.
+ */
+export declare const uuidv4: () => string;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/util/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/util/uuid.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAAkE,CAAC;AAE5G;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAO,MAgBrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,QAAO,MAC4D,CAAC"}

package/dist/util/validate.d.ts

@@ -0,0 +1,106 @@
+export type Validator<T> = (value: unknown) => value is T;
+/**
+ * Validates `value` as `boolean`.
+ */
+export declare const isBoolean: (value: unknown) => value is boolean;
+/**
+ * Validates `value` as `number`.
+ */
+export declare const isNumber: (value: unknown) => value is number;
+/**
+ * Validates `value` as positive `number`.
+ */
+export declare const isPositiveNumber: (value: unknown) => value is number;
+/**
+ * Validates `value` as non-negative `number`.
+ */
+export declare const isNonNegativeNumber: (value: unknown) => value is number;
+/**
+ * Validates `value` as `integer`.
+ */
+export declare const isInteger: (value: unknown) => value is number;
+/**
+ * Validates `value` as positive `integer`.
+ */
+export declare const isPositiveInteger: (value: unknown) => value is number;
+/**
+ * Validates `value` as non-negative `integer`.
+ */
+export declare const isNonNegativeInteger: (value: unknown) => value is number;
+/**
+ * Validates `value` as `string`.
+ */
+export declare const isString: (value: unknown) => value is string;
+/**
+ * Validates `value` as `array`.
+ */
+export declare const isArray: <T = unknown>(value: unknown) => value is T[];
+/**
+ * Validates `value` as `null`.
+ */
+export declare const isNull: (value: unknown) => value is null;
+/**
+ * Validates `value` as `undefined`.
+ */
+export declare const isUndefined: (value: unknown) => value is undefined;
+/**
+ * Validates `value` as `null` or `undefined`.
+ */
+export declare const isNullOrUndefined: (value: unknown) => value is null | undefined;
+/**
+ * Validates `value` as plain `object`.
+ */
+export declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
+/**
+ * Validates `value` as `function`.
+ */
+export declare const isFunction: (value: unknown) => value is (...args: any[]) => any;
+/**
+ * Validates `value` as `type`.
+ */
+export declare const isInstance: <T>(value: unknown, type: new (...args: any[]) => T) => value is T;
+/**
+ * Validates `value` as `enum`.
+ */
+export declare const isEnum: (value: unknown, choices: ReadonlyArray<string | number> | ReadonlySet<string | number> | Readonly<Record<string | number, string | number>> | null | undefined) => boolean;
+/**
+ * Type check an array of values using a validator.
+ */
+export declare const isArrayOf: <T>(values: unknown, validator: Validator<T>) => values is T[];
+/**
+ * Type check a plain object of values using a validator.
+ */
+export declare const isPlainObjectOf: <T>(record: unknown, validator: Validator<T>) => record is Record<string | number, T>;
+/**
+ * Refine a base validator with an extra condition.
+ */
+export declare const refineValidator: <T>(base: Validator<T>, predicate: (value: T) => boolean, name?: string | null) => Validator<T>;
+/**
+ * Logical OR of two validators.
+ */
+export declare const isAnyOf: <A, B>(a: Validator<A>, b: Validator<B>) => Validator<A | B>;
+export declare const isNumberGreater: (min: number) => Validator<number>;
+export declare const isNumberGreaterOrEqual: (min: number) => Validator<number>;
+export declare const isNumberLess: (min: number) => Validator<number>;
+export declare const isNumberLessOrEqual: (min: number) => Validator<number>;
+export declare const isNumberInRange: (min: number, max: number) => Validator<number>;
+export declare const isNumberEqual: (expected: number) => Validator<number>;
+export declare const isIntegerGreater: (min: number) => Validator<number>;
+export declare const isIntegerGreaterOrEqual: (min: number) => Validator<number>;
+export declare const isIntegerLess: (min: number) => Validator<number>;
+export declare const isIntegerLessOrEqual: (min: number) => Validator<number>;
+export declare const isIntegerInRange: (min: number, max: number) => Validator<number>;
+export declare const isIntegerEqual: (expected: number) => Validator<number>;
+export declare const isStringLengthGreater: (min: number) => Validator<string>;
+export declare const isStringLengthGreaterOrEqual: (min: number) => Validator<string>;
+export declare const isStringLengthLess: (min: number) => Validator<string>;
+export declare const isStringLengthLessOrEqual: (min: number) => Validator<string>;
+export declare const isStringLengthInRange: (min: number, max: number) => Validator<string>;
+export declare const isStringLengthEqual: (expected: number) => Validator<string>;
+export declare const isArrayLengthGreater: (min: number) => Validator<unknown[]>;
+export declare const isArrayLengthGreaterOrEqual: (min: number) => Validator<unknown[]>;
+export declare const isArrayLengthLess: (min: number) => Validator<unknown[]>;
+export declare const isArrayLengthLessOrEqual: (min: number) => Validator<unknown[]>;
+export declare const isArrayLengthInRange: (min: number, max: number) => Validator<unknown[]>;
+export declare const isArrayLengthEqual: (expected: number) => Validator<unknown[]>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/util/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/util/validate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/simplify",
-  "version": "1.74.0",
+  "version": "1.76.0",
   "description": "@vpmedia/simplify",
   "author": "Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)",
   "license": "MIT",
@@ -15,27 +15,43 @@
   "keywords": [
     "utils"
   ],
-  "main": "./src/index.js",
-  "types": "./types/index.d.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md",
+    "SECURITY.md"
+  ],
   "type": "module",
   "optionalDependencies": {
-    "@sentry/browser": "^10.40.0"
+    "@sentry/browser": "^10.52.0"
   },
   "devDependencies": {
-    "@commitlint/cli": "^20.4.2",
-    "@commitlint/config-conventional": "^20.4.2",
-    "@types/node": "^25.3.3",
-    "@vitest/coverage-v8": "^4.0.18",
-    "jsdom": "^28.1.0",
-    "msw": "^2.12.10",
-    "oxfmt": "^0.35.0",
-    "oxlint": "^1.50.0",
-    "oxlint-tsgolint": "^0.15.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "@commitlint/cli": "^21.0.0",
+    "@commitlint/config-conventional": "^21.0.0",
+    "@types/node": "^25.6.2",
+    "@vitest/coverage-v8": "^4.1.5",
+    "jsdom": "^29.1.1",
+    "msw": "^2.14.5",
+    "oxfmt": "^0.48.0",
+    "oxlint": "^1.63.0",
+    "oxlint-tsgolint": "^0.22.1",
+    "rolldown": "^1.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   },
   "scripts": {
-    "build": "rm -rf types && tsc -p ./tsconfig.build.json",
+    "build": "rm -rf dist && rolldown -c && tsc -p tsconfig.json --emitDeclarationOnly",
     "check": "pnpm build && pnpm lint && pnpm test && pnpm typecheck",
     "format": "oxfmt --write \"./**/*.{js,jsx,mjs,cjs,ts,tsx,json,css}\"",
     "lint": "oxlint src",

package/src/const/http_status.test.ts

@@ -0,0 +1,7 @@
+import { HTTP_100_CONTINUE, HTTP_STATUS_MAP } from './http_status.js';
+
+describe('http_status', () => {
+  test('HTTP status name from code', () => {
+    expect(HTTP_STATUS_MAP[HTTP_100_CONTINUE]).toBe('HTTP_100_CONTINUE');
+  });
+});

package/src/const/{http_status.js → http_status.ts}

@@ -66,7 +66,7 @@ export const HTTP_508_LOOP_DETECTED = 508;
 export const HTTP_510_NOT_EXTENDED = 510;
 export const HTTP_511_NETWORK_AUTHENTICATION_REQUIRED = 511;
 
-export const HTTP_STATUS_MAP = {
+export const HTTP_STATUS_MAP: Record<number, string> = {
   [HTTP_100_CONTINUE]: 'HTTP_100_CONTINUE',
   [HTTP_101_SWITCHING_PROTOCOLS]: 'HTTP_101_SWITCHING_PROTOCOLS',
   [HTTP_102_PROCESSING]: 'HTTP_102_PROCESSING',

package/src/{index.js → index.ts}

@@ -1,9 +1,11 @@
 export * from './const/http_status.js';
 export { AbstractLogHandler } from './logging/AbstractLogHandler.js';
+export type { LogExtra } 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 type { OpenTelemetryLogEmitter } from './logging/OpenTelemetryLogHandler.js';
 export { SentryLogHandler } from './logging/SentryLogHandler.js';
 export { formatLogMessage, getLogLevelName } from './logging/util.js';
 export * from './pagelifecycle/const.js';
@@ -18,11 +20,16 @@ export {
 } from './pagelifecycle/util.js';
 export { typeChecker } from './typecheck/TypeChecker.js';
 export { TypeCheckError } from './typecheck/TypeCheckError.js';
+export type { TypeCheckErrorOptions } from './typecheck/TypeCheckError.js';
 export { typeCheck, typeCheckArray, typeCheckEnum } from './typecheck/util.js';
+export type { EnumChoices } from './typecheck/util.js';
 export { delayPromise, loadJSON, retryAsync } from './util/async.js';
 export { getErrorDetails, getTypedError } from './util/error.js';
+export type { ErrorDetails } from './util/error.js';
 export { EventEmitter } from './util/event_emitter.js';
+export type { EventListener } from './util/event_emitter.js';
 export { FetchError, fetchRetry, HTTP_0_ANY } from './util/fetch.js';
+export type { FetchRetryOptions } from './util/fetch.js';
 export {
   deg2rad,
   fixFloatPrecision,
@@ -41,3 +48,4 @@ export { serverDataToState } from './util/state.js';
 export { addLeadingZero, capitalize, getTypeFromValue, saveAsFile, underscoreToCamelCase } from './util/string.js';
 export { uuidv4 } from './util/uuid.js';
 export * from './util/validate.js';
+export type { Validator } from './util/validate.js';

package/src/logging/AbstractLogHandler.ts

@@ -0,0 +1,31 @@
+import type { Logger } from './Logger.js';
+
+export interface LogExtra {
+  tags?: Record<string, string | number | boolean | null | undefined>;
+  [key: string]: unknown;
+}
+
+export class AbstractLogHandler {
+  level: number;
+
+  /**
+   * Abstract log handler.
+   */
+  constructor(level: number) {
+    this.level = level;
+  }
+
+  /**
+   * Emit log record.
+   */
+  emit(
+    _logger: Logger,
+    _timestamp: number,
+    _level: number,
+    _message: string,
+    _extra: LogExtra | null | undefined,
+    _error: Error | null | undefined
+  ): void {
+    throw new Error('Not implemented.');
+  }
+}

package/src/logging/{ConsoleLogHandler.js → ConsoleLogHandler.ts}

@@ -1,8 +1,11 @@
-import { AbstractLogHandler } from './AbstractLogHandler.js';
+import { AbstractLogHandler, type LogExtra } from './AbstractLogHandler.js';
 import { LOG_LEVEL_DEBUG } from './const.js';
+import type { Logger } from './Logger.js';
 import { formatLogMessage } from './util.js';
 
-const CONSOLE_FUNCTIONS = [
+type ConsoleFn = (...data: unknown[]) => void;
+
+const CONSOLE_FUNCTIONS: ReadonlyArray<ConsoleFn | null> = [
   null, // silent
   console.error, // fatal
   console.error, // error
@@ -14,29 +17,28 @@ const CONSOLE_FUNCTIONS = [
 export class ConsoleLogHandler extends AbstractLogHandler {
   /**
    * Console log handler.
-   * @param {number} level - Log handler level.
    */
-  constructor(level = LOG_LEVEL_DEBUG) {
+  constructor(level: number = 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 | null | undefined} extra - Log extra data.
-   * @param {Error | null | undefined} error - Log error.
-   * @throws {Error}
    */
-  emit(logger, timestamp, level, message, extra, error) {
+  override emit(
+    logger: Logger,
+    timestamp: number,
+    level: number,
+    message: string,
+    extra: LogExtra | null | undefined,
+    error: Error | null | undefined
+  ): void {
     if (logger.level < level) {
       return;
     }
     const logMessage = formatLogMessage(logger, timestamp, level, message);
     const consoleFunction = CONSOLE_FUNCTIONS[level];
-    if (consoleFunction === null) {
+    if (consoleFunction === null || consoleFunction === undefined) {
       return;
     }
     if (error) {

package/src/logging/Logger.test.ts

@@ -0,0 +1,69 @@
+import { AbstractLogHandler, type LogExtra } 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';
+
+class TestLogHandler extends AbstractLogHandler {
+  emitLogLogger: Logger | null = null;
+  emitLogTimestamp: number | null = null;
+  emitLogLevel: number | null = null;
+  emitLogMessage: string | null = null;
+  emitLogExtra: LogExtra | null | undefined = null;
+  emitLogError: Error | null | undefined = null;
+
+  constructor() {
+    super(LOG_LEVEL_DEBUG);
+  }
+
+  override emit(
+    logger: Logger,
+    timestamp: number,
+    level: number,
+    message: string,
+    extra: LogExtra | null | undefined,
+    error: Error | null | undefined
+  ): void {
+    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');
+  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');
+  // warning
+  logger.warn('warning');
+  expect(testLogHandler.emitLogLevel).toBe(LOG_LEVEL_WARNING);
+  expect(testLogHandler.emitLogMessage).toBe('warning');
+  logger.warning('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/Logger.ts

@@ -0,0 +1,77 @@
+import { getURLParam } from '../util/query.js';
+import type { AbstractLogHandler, LogExtra } from './AbstractLogHandler.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';
+
+const ROOT_LOGGER_NAME = 'root';
+
+export class Logger {
+  static handlers: AbstractLogHandler[] = [];
+
+  name: string;
+  level: number;
+
+  /**
+   * Creates a new Logger instance.
+   */
+  constructor(name: string = ROOT_LOGGER_NAME) {
+    this.name = name ?? ROOT_LOGGER_NAME;
+    const appEnvironment = getAppEnvironment();
+    const isProduction = appEnvironment === 'production' || appEnvironment === 'release';
+    const defaultLevel = isProduction ? LOG_LEVEL_SILENT : LOG_LEVEL_DEBUG;
+    const parameterName = `log_${this.name.toLowerCase()}`;
+    const paramLevel =
+      getURLParam(parameterName, getURLParam('log_all', defaultLevel.toString())) ?? defaultLevel.toString();
+    this.level = Number.parseInt(paramLevel, 10);
+  }
+
+  static addHandler = (handler: AbstractLogHandler): void => {
+    Logger.handlers.push(handler);
+  };
+
+  static emit = (
+    logger: Logger,
+    level: number,
+    message: string,
+    extra?: LogExtra | null,
+    error?: Error | null
+  ): void => {
+    const timestamp = Date.now();
+    for (const handler of Logger.handlers) {
+      if (handler.level >= level) {
+        handler.emit(logger, timestamp, level, message, extra, error);
+      }
+    }
+  };
+
+  debug(message: string, extra?: LogExtra | null): void {
+    Logger.emit(this, LOG_LEVEL_DEBUG, message, extra);
+  }
+
+  info(message: string, extra?: LogExtra | null): void {
+    Logger.emit(this, LOG_LEVEL_INFO, message, extra);
+  }
+
+  warn(message: string, extra?: LogExtra | null): void {
+    Logger.emit(this, LOG_LEVEL_WARNING, message, extra);
+  }
+
+  warning(message: string, extra?: LogExtra | null): void {
+    Logger.emit(this, LOG_LEVEL_WARNING, message, extra);
+  }
+
+  error(message: string, extra?: LogExtra | null): void {
+    Logger.emit(this, LOG_LEVEL_ERROR, message, extra);
+  }
+
+  exception(message: string, error: Error, extra?: LogExtra | null): void {
+    Logger.emit(this, LOG_LEVEL_FATAL, message, extra, error);
+  }
+}

package/src/logging/OpenTelemetryLogHandler.ts

@@ -0,0 +1,40 @@
+import { AbstractLogHandler, type LogExtra } from './AbstractLogHandler.js';
+import type { Logger } from './Logger.js';
+
+export type OpenTelemetryLogEmitter = (
+  logger: Logger,
+  timestamp: number,
+  level: number,
+  message: string,
+  extra: LogExtra | null | undefined,
+  error: Error | null | undefined
+) => void;
+
+export class OpenTelemetryLogHandler extends AbstractLogHandler {
+  emitter: OpenTelemetryLogEmitter;
+
+  /**
+   * Open Telemetry log handler.
+   */
+  constructor(level: number, emitter: OpenTelemetryLogEmitter) {
+    super(level);
+    this.emitter = emitter;
+  }
+
+  /**
+   * Emit log record.
+   */
+  override emit(
+    logger: Logger,
+    timestamp: number,
+    level: number,
+    message: string,
+    extra: LogExtra | null | undefined,
+    error: Error | null | undefined
+  ): void {
+    if (!this.emitter) {
+      return;
+    }
+    this.emitter(logger, timestamp, level, message, extra, error);
+  }
+}

package/src/logging/SentryLogHandler.ts

@@ -0,0 +1,44 @@
+import { addBreadcrumb, captureException, captureMessage, type SeverityLevel } from '@sentry/browser';
+import { AbstractLogHandler, type LogExtra } from './AbstractLogHandler.js';
+import { LOG_LEVEL_DEBUG, LOG_LEVEL_WARNING } from './const.js';
+import type { Logger } from './Logger.js';
+import { getLogLevelName } from './util.js';
+
+export class SentryLogHandler extends AbstractLogHandler {
+  /**
+   * Sentry log handler.
+   */
+  constructor(level: number = LOG_LEVEL_DEBUG) {
+    super(level);
+  }
+
+  /**
+   * Emit log record.
+   */
+  override emit(
+    logger: Logger,
+    _timestamp: number,
+    level: number,
+    message: string,
+    extra: LogExtra | null | undefined,
+    error: Error | null | undefined
+  ): void {
+    const levelName = getLogLevelName(level) as SeverityLevel;
+    const logMessage = `[${logger.name}] ${message}`;
+    const breadcrumb = {
+      type: 'default',
+      category: 'console',
+      message: logMessage,
+      level: levelName,
+      data: extra ?? undefined,
+    };
+    addBreadcrumb(breadcrumb);
+    if (error) {
+      extra?.tags ? captureException(error, { tags: extra.tags }) : captureException(error);
+    } else if (level === LOG_LEVEL_WARNING) {
+      extra?.tags
+        ? captureMessage(logMessage, { level: 'warning', tags: extra.tags })
+        : captureMessage(logMessage, { level: 'warning' });
+    }
+  }
+}