@vpmedia/simplify 1.58.0 → 1.60.0

package/CHANGELOG.md

@@ -1,3 +1,38 @@
+## [1.60.0] - 2026-01-14
+
+### 💼 Other
+
+- *(deps)* Bump dependency versions
+
+### 🚜 Refactor
+
+- Adjusted exports and namespaces
+
+### ⚙️ Miscellaneous Tasks
+
+- Release
+- Cleanup, improve typechecker class
+- Improve isEnum validator jsdoc types
+- Improve validators and type checker
+- Apply naming conventions
+- Adjust exception message format
+- Cleanup
+- *(release)* V1.60.0
+## [1.59.0] - 2026-01-13
+
+### 🚀 Features
+
+- Updated http status codes and added map to get status names
+
+### 🧪 Testing
+
+- Fix flaky delayPromise test
+
+### ⚙️ Miscellaneous Tasks
+
+- Release
+- Updated http status code names
+- *(release)* V1.59.0
 ## [1.58.0] - 2026-01-13
 
 ### 💼 Other

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/simplify",
-  "version": "1.58.0",
+  "version": "1.60.0",
   "description": "@vpmedia/simplify",
   "author": "Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)",
   "license": "MIT",
@@ -28,7 +28,7 @@
     "@commitlint/cli": "^20.3.1",
     "@commitlint/config-conventional": "^20.3.1",
     "@eslint/js": "^9.39.2",
-    "@types/node": "^25.0.7",
+    "@types/node": "^25.0.8",
     "@vitest/coverage-v8": "^4.0.17",
     "eslint": "^9.39.2",
     "eslint-plugin-jsdoc": "^62.0.0",

package/src/const/http_status.js

@@ -1,3 +1,6 @@
+// @see https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml
+// @see https://www.rfc-editor.org/rfc/rfc9110
+
 export const HTTP_100_CONTINUE = 100;
 export const HTTP_101_SWITCHING_PROTOCOLS = 101;
 export const HTTP_102_PROCESSING = 102;
@@ -34,23 +37,23 @@ export const HTTP_409_CONFLICT = 409;
 export const HTTP_410_GONE = 410;
 export const HTTP_411_LENGTH_REQUIRED = 411;
 export const HTTP_412_PRECONDITION_FAILED = 412;
-export const HTTP_413_REQUEST_ENTITY_TOO_LARGE = 413;
-export const HTTP_414_REQUEST_URI_TOO_LONG = 414;
+export const HTTP_413_CONTENT_TOO_LARGE = 413;
+export const HTTP_414_URI_TOO_LONG = 414;
 export const HTTP_415_UNSUPPORTED_MEDIA_TYPE = 415;
-export const HTTP_416_REQUESTED_RANGE_NOT_SATISFIABLE = 416;
+export const HTTP_416_RANGE_NOT_SATISFIABLE = 416;
 export const HTTP_417_EXPECTATION_FAILED = 417;
 export const HTTP_418_IM_A_TEAPOT = 418;
 export const HTTP_421_MISDIRECTED_REQUEST = 421;
-export const HTTP_422_UNPROCESSABLE_ENTITY = 422;
+export const HTTP_422_UNPROCESSABLE_CONTENT = 422;
 export const HTTP_423_LOCKED = 423;
 export const HTTP_424_FAILED_DEPENDENCY = 424;
 export const HTTP_425_TOO_EARLY = 425;
 export const HTTP_426_UPGRADE_REQUIRED = 426;
 export const HTTP_428_PRECONDITION_REQUIRED = 428;
 export const HTTP_429_TOO_MANY_REQUESTS = 429;
-export const HTTP_499_CLIENT_CLOSED_CONNECTION = 499;
 export const HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE = 431;
 export const HTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS = 451;
+export const HTTP_499_CLIENT_CLOSED_CONNECTION = 499;
 export const HTTP_500_INTERNAL_SERVER_ERROR = 500;
 export const HTTP_501_NOT_IMPLEMENTED = 501;
 export const HTTP_502_BAD_GATEWAY = 502;
@@ -62,3 +65,70 @@ export const HTTP_507_INSUFFICIENT_STORAGE = 507;
 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 = {
+  [HTTP_100_CONTINUE]: 'HTTP_100_CONTINUE',
+  [HTTP_101_SWITCHING_PROTOCOLS]: 'HTTP_101_SWITCHING_PROTOCOLS',
+  [HTTP_102_PROCESSING]: 'HTTP_102_PROCESSING',
+  [HTTP_103_EARLY_HINTS]: 'HTTP_103_EARLY_HINTS',
+  [HTTP_200_OK]: 'HTTP_200_OK',
+  [HTTP_201_CREATED]: 'HTTP_201_CREATED',
+  [HTTP_202_ACCEPTED]: 'HTTP_202_ACCEPTED',
+  [HTTP_203_NON_AUTHORITATIVE_INFORMATION]: 'HTTP_203_NON_AUTHORITATIVE_INFORMATION',
+  [HTTP_204_NO_CONTENT]: 'HTTP_204_NO_CONTENT',
+  [HTTP_205_RESET_CONTENT]: 'HTTP_205_RESET_CONTENT',
+  [HTTP_206_PARTIAL_CONTENT]: 'HTTP_206_PARTIAL_CONTENT',
+  [HTTP_207_MULTI_STATUS]: 'HTTP_207_MULTI_STATUS',
+  [HTTP_208_ALREADY_REPORTED]: 'HTTP_208_ALREADY_REPORTED',
+  [HTTP_226_IM_USED]: 'HTTP_226_IM_USED',
+  [HTTP_300_MULTIPLE_CHOICES]: 'HTTP_300_MULTIPLE_CHOICES',
+  [HTTP_301_MOVED_PERMANENTLY]: 'HTTP_301_MOVED_PERMANENTLY',
+  [HTTP_302_FOUND]: 'HTTP_302_FOUND',
+  [HTTP_303_SEE_OTHER]: 'HTTP_303_SEE_OTHER',
+  [HTTP_304_NOT_MODIFIED]: 'HTTP_304_NOT_MODIFIED',
+  [HTTP_305_USE_PROXY]: 'HTTP_305_USE_PROXY',
+  [HTTP_306_RESERVED]: 'HTTP_306_RESERVED',
+  [HTTP_307_TEMPORARY_REDIRECT]: 'HTTP_307_TEMPORARY_REDIRECT',
+  [HTTP_308_PERMANENT_REDIRECT]: 'HTTP_308_PERMANENT_REDIRECT',
+  [HTTP_400_BAD_REQUEST]: 'HTTP_400_BAD_REQUEST',
+  [HTTP_401_UNAUTHORIZED]: 'HTTP_401_UNAUTHORIZED',
+  [HTTP_402_PAYMENT_REQUIRED]: 'HTTP_402_PAYMENT_REQUIRED',
+  [HTTP_403_FORBIDDEN]: 'HTTP_403_FORBIDDEN',
+  [HTTP_404_NOT_FOUND]: 'HTTP_404_NOT_FOUND',
+  [HTTP_405_METHOD_NOT_ALLOWED]: 'HTTP_405_METHOD_NOT_ALLOWED',
+  [HTTP_406_NOT_ACCEPTABLE]: 'HTTP_406_NOT_ACCEPTABLE',
+  [HTTP_407_PROXY_AUTHENTICATION_REQUIRED]: 'HTTP_407_PROXY_AUTHENTICATION_REQUIRED',
+  [HTTP_408_REQUEST_TIMEOUT]: 'HTTP_408_REQUEST_TIMEOUT',
+  [HTTP_409_CONFLICT]: 'HTTP_409_CONFLICT',
+  [HTTP_410_GONE]: 'HTTP_410_GONE',
+  [HTTP_411_LENGTH_REQUIRED]: 'HTTP_411_LENGTH_REQUIRED',
+  [HTTP_412_PRECONDITION_FAILED]: 'HTTP_412_PRECONDITION_FAILED',
+  [HTTP_413_CONTENT_TOO_LARGE]: 'HTTP_413_CONTENT_TOO_LARGE',
+  [HTTP_414_URI_TOO_LONG]: 'HTTP_414_URI_TOO_LONG',
+  [HTTP_415_UNSUPPORTED_MEDIA_TYPE]: 'HTTP_415_UNSUPPORTED_MEDIA_TYPE',
+  [HTTP_416_RANGE_NOT_SATISFIABLE]: 'HTTP_416_RANGE_NOT_SATISFIABLE',
+  [HTTP_417_EXPECTATION_FAILED]: 'HTTP_417_EXPECTATION_FAILED',
+  [HTTP_418_IM_A_TEAPOT]: 'HTTP_418_IM_A_TEAPOT',
+  [HTTP_421_MISDIRECTED_REQUEST]: 'HTTP_421_MISDIRECTED_REQUEST',
+  [HTTP_422_UNPROCESSABLE_CONTENT]: 'HTTP_422_UNPROCESSABLE_CONTENT',
+  [HTTP_423_LOCKED]: 'HTTP_423_LOCKED',
+  [HTTP_424_FAILED_DEPENDENCY]: 'HTTP_424_FAILED_DEPENDENCY',
+  [HTTP_425_TOO_EARLY]: 'HTTP_425_TOO_EARLY',
+  [HTTP_426_UPGRADE_REQUIRED]: 'HTTP_426_UPGRADE_REQUIRED',
+  [HTTP_428_PRECONDITION_REQUIRED]: 'HTTP_428_PRECONDITION_REQUIRED',
+  [HTTP_429_TOO_MANY_REQUESTS]: 'HTTP_429_TOO_MANY_REQUESTS',
+  [HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE]: 'HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE',
+  [HTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS]: 'HTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS',
+  [HTTP_499_CLIENT_CLOSED_CONNECTION]: 'HTTP_499_CLIENT_CLOSED_CONNECTION',
+  [HTTP_500_INTERNAL_SERVER_ERROR]: 'HTTP_500_INTERNAL_SERVER_ERROR',
+  [HTTP_501_NOT_IMPLEMENTED]: 'HTTP_501_NOT_IMPLEMENTED',
+  [HTTP_502_BAD_GATEWAY]: 'HTTP_502_BAD_GATEWAY',
+  [HTTP_503_SERVICE_UNAVAILABLE]: 'HTTP_503_SERVICE_UNAVAILABLE',
+  [HTTP_504_GATEWAY_TIMEOUT]: 'HTTP_504_GATEWAY_TIMEOUT',
+  [HTTP_505_HTTP_VERSION_NOT_SUPPORTED]: 'HTTP_505_HTTP_VERSION_NOT_SUPPORTED',
+  [HTTP_506_VARIANT_ALSO_NEGOTIATES]: 'HTTP_506_VARIANT_ALSO_NEGOTIATES',
+  [HTTP_507_INSUFFICIENT_STORAGE]: 'HTTP_507_INSUFFICIENT_STORAGE',
+  [HTTP_508_LOOP_DETECTED]: 'HTTP_508_LOOP_DETECTED',
+  [HTTP_510_NOT_EXTENDED]: 'HTTP_510_NOT_EXTENDED',
+  [HTTP_511_NETWORK_AUTHENTICATION_REQUIRED]: 'HTTP_511_NETWORK_AUTHENTICATION_REQUIRED',
+};

package/src/const/http_status.test.js

@@ -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/index.js

@@ -1,4 +1,3 @@
-// core
 export * from './const/http_status.js';
 export { AbstractLogHandler } from './logging/AbstractLogHandler.js';
 export { ConsoleLogHandler } from './logging/ConsoleLogHandler.js';
@@ -8,16 +7,37 @@ export { OpenTelemetryLogHandler } from './logging/OpenTelemetryLogHandler.js';
 export { SentryLogHandler } from './logging/SentryLogHandler.js';
 export { formatLogMessage, getLogLevelName } from './logging/util.js';
 export * from './pagelifecycle/const.js';
-export * from './pagelifecycle/event.js';
 export * from './pagelifecycle/typedef.js';
-export * from './pagelifecycle/util.js';
-export * from './util/async.js';
-export * from './util/error.js';
+export {
+  addPageLifecycleCallback,
+  getDocumentState,
+  getPageLifecycleEventEmitter,
+  getPageLifecycleState,
+  initPageLifecycle,
+  isPageLifecycleInitialized,
+} from './pagelifecycle/util.js';
+export { typeChecker } from './typecheck/TypeChecker.js';
+export { TypeCheckError } from './typecheck/TypeCheckError.js';
+export { typeCheck, typeCheckArray, typeCheckEnum } from './typecheck/util.js';
+export { delayPromise, loadJSON } from './util/async.js';
+export { getErrorDetails } from './util/error.js';
 export { FetchError, fetchRetry, HTTP_0_ANY } from './util/fetch.js';
-export * from './util/number.js';
-export * from './util/object.js';
-export * from './util/query.js';
-export * from './util/state.js';
-export * from './util/string.js';
-export * from './util/typecheck.js';
+export {
+  addFloat,
+  deg2rad,
+  fixFloat,
+  fixFloatPrecision,
+  getRandomInt,
+  isEqual,
+  isGreater,
+  isGreaterOrEqual,
+  isInRange,
+  isLess,
+  isLessOrEqual,
+  subFloat,
+} from './util/number.js';
+export { purgeObject, deepMerge, getObjArrayPropSum, getObjValueByPath, setObjValueByPath } from './util/object.js';
+export { getURLParam, sanitizeURLParam } from './util/query.js';
+export { serverDataToState } from './util/state.js';
+export { addLeadingZero, capitalize, getTypeFromValue, saveAsFile, underscoreToCamelCase } from './util/string.js';
 export * from './util/validate.js';

package/src/logging/OpenTelemetryLogHandler.js

@@ -1,5 +1,4 @@
 import { AbstractLogHandler } from './AbstractLogHandler.js';
-import { LOG_LEVEL_DEBUG } from './const.js';
 
 export class OpenTelemetryLogHandler extends AbstractLogHandler {
   /**

package/src/pagelifecycle/const.js

@@ -9,3 +9,6 @@ export const DOCUMENT_STATE_FULLY_LOADED = 'fullyLoaded';
 export const DOCUMENT_STATE_COMPLETE = 'complete';
 export const DOCUMENT_STATE_INTERACTIVE = 'interactive';
 export const DOCUMENT_STATE_LOADING = 'loading';
+
+export const PAGE_LIFECYCLE_STATE_CHANGE_EVENT = 'pageLifecycleStateChange';
+export const DOCUMENT_STATE_CHANGE_EVENT = 'documentStateChange';

package/src/pagelifecycle/util.js

@@ -8,15 +8,16 @@
 import { EventEmitter } from 'eventemitter3';
 import { Logger } from '../logging/Logger.js';
 import {
+  DOCUMENT_STATE_CHANGE_EVENT,
   DOCUMENT_STATE_DOM_LOADED,
   DOCUMENT_STATE_FULLY_LOADED,
   PAGE_LIFECYCLE_STATE_ACTIVE,
+  PAGE_LIFECYCLE_STATE_CHANGE_EVENT,
   PAGE_LIFECYCLE_STATE_FROZEN,
   PAGE_LIFECYCLE_STATE_HIDDEN,
   PAGE_LIFECYCLE_STATE_PASSIVE,
   PAGE_LIFECYCLE_STATE_TERMINATED,
 } from './const.js';
-import { DOCUMENT_STATE_CHANGE_EVENT, PAGE_LIFECYCLE_STATE_CHANGE_EVENT } from './event.js';
 
 const logger = new Logger('pagelifecycle');
 

package/src/typecheck/TypeCheckError.js

@@ -0,0 +1,10 @@
+export class TypeCheckError extends TypeError {
+  /**
+   * Creates a new `TypeCheckError` instance.
+   * @param {string} message - Error message.
+   */
+  constructor(message) {
+    super(message);
+    this.name = 'TypeCheckError';
+  }
+}

package/src/typecheck/TypeChecker.js

@@ -0,0 +1,91 @@
+import { TypeCheckError } from './TypeCheckError.js';
+import { Logger } from '../logging/Logger.js';
+import { typeCheck, typeCheckArray, typeCheckEnum } from './util.js';
+
+const logger = new Logger('typechecker');
+
+class TypeChecker {
+  /** @type {TypeChecker} */
+  static #instance;
+
+  /** @type {boolean} */
+  #swallowErrors = false;
+
+  constructor() {
+    if (TypeChecker.#instance === undefined) {
+      TypeChecker.#instance = this;
+    }
+  }
+
+  /**
+   * Enable or disable swallowing of TypeCheckErrors.
+   * @param {boolean} value - Swallow errors flag.
+   */
+  setSwallowErrors(value) {
+    this.#swallowErrors = Boolean(value);
+  }
+
+  /**
+   * Type check a single value.
+   * @template T
+   * @param {unknown} value - The value to check.
+   * @param {(value: unknown) => value is T} validator - The validator to check with.
+   * @returns {T} - The type checked value.
+   */
+  check(value, validator) {
+    try {
+      return typeCheck(value, validator);
+    } catch (error) {
+      if (this.#swallowErrors && error instanceof TypeCheckError) {
+        logger.exception('check', error);
+        // @ts-expect-error
+        return value;
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Type check an array of values.
+   * @template T
+   * @param {unknown[]} value - The value to check.
+   * @param {(value: unknown) => value is T} validator - The validator to check the array with.
+   * @returns {T[]} - The type checked value.
+   */
+  checkArray(value, validator) {
+    try {
+      return typeCheckArray(value, validator);
+    } catch (error) {
+      if (this.#swallowErrors && error instanceof TypeCheckError) {
+        logger.exception('checkArray', error);
+        // @ts-expect-error
+        return value;
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Type check an array of values.
+   * @template T
+   * @param {string | number} value - The value to check.
+   * @param {(string | number)[] | Set<string | number> | Record<string | number, string | number>} choices - Enum list.
+   * @returns {string | number} - The type checked value.
+   */
+  checkEnum(value, choices) {
+    try {
+      return typeCheckEnum(value, choices);
+    } catch (error) {
+      if (this.#swallowErrors && error instanceof TypeCheckError) {
+        logger.exception('checkEnum', error);
+        return value;
+      }
+      throw error;
+    }
+  }
+}
+
+/**
+ * Export a single shared instance.
+ */
+export const typeChecker = new TypeChecker();

package/src/typecheck/util.js

@@ -0,0 +1,55 @@
+import { getTypeFromValue } from '../util/string.js';
+import { isArrayOf, isEnum } from '../util/validate.js';
+import { TypeCheckError } from './TypeCheckError.js';
+
+const VALIDATOR_FALLBACK_NAME = '<anonymous>';
+
+/**
+ * Type check a value using a validator.
+ * @template T
+ * @param {unknown} value - The value to check.
+ * @param {(value: unknown) => value is T} validator - The validator to check with.
+ * @returns {T} The type checked value.
+ * @throws {TypeCheckError}
+ */
+export const typeCheck = (value, validator) => {
+  if (!validator(value)) {
+    const validatorName = validator.name || VALIDATOR_FALLBACK_NAME;
+    const displayValue = getTypeFromValue(value);
+    throw new TypeCheckError(`Validation failed: ${validatorName} (${displayValue})`);
+  }
+  return value;
+};
+
+/**
+ * Type check a value using a validator.
+ * @template T
+ * @param {unknown[]} value - The value to check.
+ * @param {(value: unknown) => value is T} validator - The validator to check the array with.
+ * @returns {T[]} The type checked value.
+ * @throws {TypeCheckError}
+ */
+export const typeCheckArray = (value, validator) => {
+  if (!isArrayOf(value, validator)) {
+    const validatorName = validator.name || VALIDATOR_FALLBACK_NAME;
+    const displayValue = getTypeFromValue(value);
+    throw new TypeCheckError(`Validation failed: ${validatorName} (${displayValue})`);
+  }
+  return value;
+};
+
+/**
+ * Type check an enum.
+ * @param {string | number} value - The value to check.
+ * @param {(string | number)[] | Set<string | number> | Record<string | number, string | number>} choices - Enum list.
+ * @returns {string | number} The type checked value.
+ * @throws {TypeCheckError}
+ */
+export const typeCheckEnum = (value, choices) => {
+  if (!isEnum(value, choices)) {
+    const validatorName = 'isEnum';
+    const displayValue = getTypeFromValue(value);
+    throw new TypeCheckError(`Validation failed: ${validatorName} (${displayValue})`);
+  }
+  return value;
+};

package/src/{util/typecheck.test.js → typecheck/util.test.js}

@@ -1,5 +1,6 @@
-import { typeCheck, typeCheckArray, TypeCheckError } from './typecheck.js';
-import { isNumber, isPositiveInteger } from './validate.js';
+import { isNumber, isPositiveInteger } from '../util/validate.js';
+import { TypeCheckError } from './TypeCheckError.js';
+import { typeCheck, typeCheckArray, typeCheckEnum } from './util.js';
 
 describe('typecheck', () => {
   test('typeCheck', () => {
@@ -16,4 +17,12 @@ describe('typecheck', () => {
     // @ts-expect-error
     expect(() => typeCheckArray('string', isNumber)).toThrowError(TypeCheckError);
   });
+
+  test('typeCheckEnum', () => {
+    expect(() => typeCheckEnum('AA', ['AA'])).not.toThrowError(TypeCheckError);
+    expect(() => typeCheckEnum('AA', ['BB'])).toThrowError(TypeCheckError);
+    expect(() => typeCheckEnum(null, ['BB'])).toThrowError(TypeCheckError);
+    // @ts-expect-error
+    expect(() => typeCheckEnum(['AA'], null)).toThrowError(TypeCheckError);
+  });
 });

package/src/util/async.test.js

@@ -7,7 +7,7 @@ describe('delayPromise', () => {
     const end = Date.now();
 
     // Should resolve within a reasonable time frame
-    expect(end - start).toBeGreaterThanOrEqual(10);
+    expect(end - start).toBeGreaterThanOrEqual(9);
   });
 
   test('Handles zero delay correctly', async () => {

package/src/util/error.test.js

@@ -9,9 +9,9 @@ test('Tests getErrorDetails', () => {
 });
 
 test('Tests getErrorDetails with Error cause', () => {
-  const error = new Error('Test error', { cause: new Error('Cause error') });
+  const error = new SyntaxError('Test error', { cause: new TypeError('Cause error') });
   const errorDetails = getErrorDetails(error);
-  expect(errorDetails.type).toBe('Error');
+  expect(errorDetails.type).toBe('SyntaxError');
   expect(errorDetails.message).toBe('Test error');
   expect(errorDetails.cause instanceof Error).toBe(true);
   if (errorDetails.cause instanceof Error) {

package/src/util/fetch.js

@@ -5,7 +5,7 @@ import {
   HTTP_401_UNAUTHORIZED,
   HTTP_403_FORBIDDEN,
   HTTP_405_METHOD_NOT_ALLOWED,
-  HTTP_422_UNPROCESSABLE_ENTITY,
+  HTTP_422_UNPROCESSABLE_CONTENT,
 } from '../const/http_status.js';
 import { Logger } from '../logging/Logger.js';
 import { delayPromise } from './async.js';
@@ -49,7 +49,7 @@ export const fetchRetry = async (resource, fetchOptions, retryOptions) => {
     HTTP_401_UNAUTHORIZED,
     HTTP_403_FORBIDDEN,
     HTTP_405_METHOD_NOT_ALLOWED,
-    HTTP_422_UNPROCESSABLE_ENTITY,
+    HTTP_422_UNPROCESSABLE_CONTENT,
   ];
   while (retryOptions.numTries > 0) {
     logger.info('request', { resource, fetchOptions, retryOptions });

package/src/util/string.js

@@ -52,3 +52,10 @@ export const saveAsFile = (filename, text) => {
   element.click();
   element.remove();
 };
+
+/**
+ * Get type from value in human readable format.
+ * @param {unknown} value - The value to check.
+ * @returns {string} Type in human readable format.
+ */
+export const getTypeFromValue = (value) => Object.prototype.toString.call(value).slice(8, -1).toLowerCase();

package/src/util/string.test.js

@@ -1,6 +1,6 @@
 /* eslint-disable unicorn/no-useless-undefined */
 
-import { underscoreToCamelCase, capitalize, addLeadingZero } from './string.js';
+import { underscoreToCamelCase, capitalize, addLeadingZero, getTypeFromValue } from './string.js';
 
 test('Tests add leading zero', () => {
   expect(addLeadingZero(1)).toBe('01');
@@ -46,3 +46,14 @@ test('Converts underscore to camelCase', () => {
   expect(underscoreToCamelCase('test_variable')).toBe('testVariable');
   expect(underscoreToCamelCase('test_variable_name')).toBe('testVariableName');
 });
+
+test('getDisplayValue', () => {
+  expect(getTypeFromValue('test')).toBe('string');
+  expect(getTypeFromValue(() => null)).toBe('function');
+  expect(getTypeFromValue([])).toBe('array');
+  expect(getTypeFromValue({})).toBe('object');
+  expect(getTypeFromValue(new Date())).toBe('date');
+  expect(getTypeFromValue(null)).toBe('null');
+  expect(getTypeFromValue(true)).toBe('boolean');
+  expect(getTypeFromValue(undefined)).toBe('undefined');
+});

package/src/util/validate.js

@@ -113,7 +113,7 @@ export const isInstance = (value, type) => isFunction(type) && value instanceof
 /**
  * Validates `value` as `enum`.
  * @param {unknown} value - Input value.
- * @param {unknown[] | Set<string | number> | Record<string | number, unknown>} choices - Input value.
+ * @param {(string | number)[] | Set<string | number> | Record<string | number, string | number>} choices - Enum list.
  * @returns {boolean} `true` if `value` is `enum` type.
  */
 export const isEnum = (value, choices) => {

package/types/const/http_status.d.ts

@@ -34,23 +34,23 @@ export const HTTP_409_CONFLICT: 409;
 export const HTTP_410_GONE: 410;
 export const HTTP_411_LENGTH_REQUIRED: 411;
 export const HTTP_412_PRECONDITION_FAILED: 412;
-export const HTTP_413_REQUEST_ENTITY_TOO_LARGE: 413;
-export const HTTP_414_REQUEST_URI_TOO_LONG: 414;
+export const HTTP_413_CONTENT_TOO_LARGE: 413;
+export const HTTP_414_URI_TOO_LONG: 414;
 export const HTTP_415_UNSUPPORTED_MEDIA_TYPE: 415;
-export const HTTP_416_REQUESTED_RANGE_NOT_SATISFIABLE: 416;
+export const HTTP_416_RANGE_NOT_SATISFIABLE: 416;
 export const HTTP_417_EXPECTATION_FAILED: 417;
 export const HTTP_418_IM_A_TEAPOT: 418;
 export const HTTP_421_MISDIRECTED_REQUEST: 421;
-export const HTTP_422_UNPROCESSABLE_ENTITY: 422;
+export const HTTP_422_UNPROCESSABLE_CONTENT: 422;
 export const HTTP_423_LOCKED: 423;
 export const HTTP_424_FAILED_DEPENDENCY: 424;
 export const HTTP_425_TOO_EARLY: 425;
 export const HTTP_426_UPGRADE_REQUIRED: 426;
 export const HTTP_428_PRECONDITION_REQUIRED: 428;
 export const HTTP_429_TOO_MANY_REQUESTS: 429;
-export const HTTP_499_CLIENT_CLOSED_CONNECTION: 499;
 export const HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE: 431;
 export const HTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS: 451;
+export const HTTP_499_CLIENT_CLOSED_CONNECTION: 499;
 export const HTTP_500_INTERNAL_SERVER_ERROR: 500;
 export const HTTP_501_NOT_IMPLEMENTED: 501;
 export const HTTP_502_BAD_GATEWAY: 502;
@@ -62,4 +62,70 @@ export const HTTP_507_INSUFFICIENT_STORAGE: 507;
 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: {
+    100: string;
+    101: string;
+    102: string;
+    103: string;
+    200: string;
+    201: string;
+    202: string;
+    203: string;
+    204: string;
+    205: string;
+    206: string;
+    207: string;
+    208: string;
+    226: string;
+    300: string;
+    301: string;
+    302: string;
+    303: string;
+    304: string;
+    305: string;
+    306: string;
+    307: string;
+    308: string;
+    400: string;
+    401: string;
+    402: string;
+    403: string;
+    404: string;
+    405: string;
+    406: string;
+    407: string;
+    408: string;
+    409: string;
+    410: string;
+    411: string;
+    412: string;
+    413: string;
+    414: string;
+    415: string;
+    416: string;
+    417: string;
+    418: string;
+    421: string;
+    422: string;
+    423: string;
+    424: string;
+    425: string;
+    426: string;
+    428: string;
+    429: string;
+    431: string;
+    451: string;
+    499: string;
+    500: string;
+    501: string;
+    502: string;
+    503: string;
+    504: string;
+    505: string;
+    506: string;
+    507: string;
+    508: string;
+    510: string;
+    511: string;
+};
 //# sourceMappingURL=http_status.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"http_status.d.ts","sourceRoot":"","sources":["../../src/const/http_status.js"],"names":[],"mappings":"AAAA,gCAAiC,GAAG,CAAC;AACrC,2CAA4C,GAAG,CAAC;AAChD,kCAAmC,GAAG,CAAC;AACvC,mCAAoC,GAAG,CAAC;AACxC,0BAA2B,GAAG,CAAC;AAC/B,+BAAgC,GAAG,CAAC;AACpC,gCAAiC,GAAG,CAAC;AACrC,qDAAsD,GAAG,CAAC;AAC1D,kCAAmC,GAAG,CAAC;AACvC,qCAAsC,GAAG,CAAC;AAC1C,uCAAwC,GAAG,CAAC;AAC5C,oCAAqC,GAAG,CAAC;AACzC,wCAAyC,GAAG,CAAC;AAC7C,+BAAgC,GAAG,CAAC;AACpC,wCAAyC,GAAG,CAAC;AAC7C,yCAA0C,GAAG,CAAC;AAC9C,6BAA8B,GAAG,CAAC;AAClC,iCAAkC,GAAG,CAAC;AACtC,oCAAqC,GAAG,CAAC;AACzC,iCAAkC,GAAG,CAAC;AACtC,gCAAiC,GAAG,CAAC;AACrC,0CAA2C,GAAG,CAAC;AAC/C,0CAA2C,GAAG,CAAC;AAC/C,mCAAoC,GAAG,CAAC;AACxC,oCAAqC,GAAG,CAAC;AACzC,wCAAyC,GAAG,CAAC;AAC7C,iCAAkC,GAAG,CAAC;AACtC,iCAAkC,GAAG,CAAC;AACtC,0CAA2C,GAAG,CAAC;AAC/C,sCAAuC,GAAG,CAAC;AAC3C,qDAAsD,GAAG,CAAC;AAC1D,uCAAwC,GAAG,CAAC;AAC5C,gCAAiC,GAAG,CAAC;AACrC,4BAA6B,GAAG,CAAC;AACjC,uCAAwC,GAAG,CAAC;AAC5C,2CAA4C,GAAG,CAAC;AAChD,gDAAiD,GAAG,CAAC;AACrD,4CAA6C,GAAG,CAAC;AACjD,8CAA+C,GAAG,CAAC;AACnD,uDAAwD,GAAG,CAAC;AAC5D,0CAA2C,GAAG,CAAC;AAC/C,mCAAoC,GAAG,CAAC;AACxC,2CAA4C,GAAG,CAAC;AAChD,4CAA6C,GAAG,CAAC;AACjD,8BAA+B,GAAG,CAAC;AACnC,yCAA0C,GAAG,CAAC;AAC9C,iCAAkC,GAAG,CAAC;AACtC,wCAAyC,GAAG,CAAC;AAC7C,6CAA8C,GAAG,CAAC;AAClD,yCAA0C,GAAG,CAAC;AAC9C,gDAAiD,GAAG,CAAC;AACrD,uDAAwD,GAAG,CAAC;AAC5D,qDAAsD,GAAG,CAAC;AAC1D,6CAA8C,GAAG,CAAC;AAClD,uCAAwC,GAAG,CAAC;AAC5C,mCAAoC,GAAG,CAAC;AACxC,2CAA4C,GAAG,CAAC;AAChD,uCAAwC,GAAG,CAAC;AAC5C,kDAAmD,GAAG,CAAC;AACvD,+CAAgD,GAAG,CAAC;AACpD,4CAA6C,GAAG,CAAC;AACjD,qCAAsC,GAAG,CAAC;AAC1C,oCAAqC,GAAG,CAAC;AACzC,uDAAwD,GAAG,CAAC"}
+{"version":3,"file":"http_status.d.ts","sourceRoot":"","sources":["../../src/const/http_status.js"],"names":[],"mappings":"AAGA,gCAAiC,GAAG,CAAC;AACrC,2CAA4C,GAAG,CAAC;AAChD,kCAAmC,GAAG,CAAC;AACvC,mCAAoC,GAAG,CAAC;AACxC,0BAA2B,GAAG,CAAC;AAC/B,+BAAgC,GAAG,CAAC;AACpC,gCAAiC,GAAG,CAAC;AACrC,qDAAsD,GAAG,CAAC;AAC1D,kCAAmC,GAAG,CAAC;AACvC,qCAAsC,GAAG,CAAC;AAC1C,uCAAwC,GAAG,CAAC;AAC5C,oCAAqC,GAAG,CAAC;AACzC,wCAAyC,GAAG,CAAC;AAC7C,+BAAgC,GAAG,CAAC;AACpC,wCAAyC,GAAG,CAAC;AAC7C,yCAA0C,GAAG,CAAC;AAC9C,6BAA8B,GAAG,CAAC;AAClC,iCAAkC,GAAG,CAAC;AACtC,oCAAqC,GAAG,CAAC;AACzC,iCAAkC,GAAG,CAAC;AACtC,gCAAiC,GAAG,CAAC;AACrC,0CAA2C,GAAG,CAAC;AAC/C,0CAA2C,GAAG,CAAC;AAC/C,mCAAoC,GAAG,CAAC;AACxC,oCAAqC,GAAG,CAAC;AACzC,wCAAyC,GAAG,CAAC;AAC7C,iCAAkC,GAAG,CAAC;AACtC,iCAAkC,GAAG,CAAC;AACtC,0CAA2C,GAAG,CAAC;AAC/C,sCAAuC,GAAG,CAAC;AAC3C,qDAAsD,GAAG,CAAC;AAC1D,uCAAwC,GAAG,CAAC;AAC5C,gCAAiC,GAAG,CAAC;AACrC,4BAA6B,GAAG,CAAC;AACjC,uCAAwC,GAAG,CAAC;AAC5C,2CAA4C,GAAG,CAAC;AAChD,yCAA0C,GAAG,CAAC;AAC9C,oCAAqC,GAAG,CAAC;AACzC,8CAA+C,GAAG,CAAC;AACnD,6CAA8C,GAAG,CAAC;AAClD,0CAA2C,GAAG,CAAC;AAC/C,mCAAoC,GAAG,CAAC;AACxC,2CAA4C,GAAG,CAAC;AAChD,6CAA8C,GAAG,CAAC;AAClD,8BAA+B,GAAG,CAAC;AACnC,yCAA0C,GAAG,CAAC;AAC9C,iCAAkC,GAAG,CAAC;AACtC,wCAAyC,GAAG,CAAC;AAC7C,6CAA8C,GAAG,CAAC;AAClD,yCAA0C,GAAG,CAAC;AAC9C,uDAAwD,GAAG,CAAC;AAC5D,qDAAsD,GAAG,CAAC;AAC1D,gDAAiD,GAAG,CAAC;AACrD,6CAA8C,GAAG,CAAC;AAClD,uCAAwC,GAAG,CAAC;AAC5C,mCAAoC,GAAG,CAAC;AACxC,2CAA4C,GAAG,CAAC;AAChD,uCAAwC,GAAG,CAAC;AAC5C,kDAAmD,GAAG,CAAC;AACvD,+CAAgD,GAAG,CAAC;AACpD,4CAA6C,GAAG,CAAC;AACjD,qCAAsC,GAAG,CAAC;AAC1C,oCAAqC,GAAG,CAAC;AACzC,uDAAwD,GAAG,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiEE"}

package/types/index.d.ts

@@ -1,23 +1,24 @@
 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 * from "./util/async.js";
-export * from "./util/error.js";
-export * from "./util/number.js";
-export * from "./util/object.js";
-export * from "./util/query.js";
-export * from "./util/state.js";
-export * from "./util/string.js";
-export * from "./util/typecheck.js";
 export * from "./util/validate.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 { SentryLogHandler } from "./logging/SentryLogHandler.js";
+export { typeChecker } from "./typecheck/TypeChecker.js";
+export { TypeCheckError } from "./typecheck/TypeCheckError.js";
+export { getErrorDetails } from "./util/error.js";
+export { serverDataToState } from "./util/state.js";
 export { formatLogMessage, getLogLevelName } from "./logging/util.js";
+export { addPageLifecycleCallback, getDocumentState, getPageLifecycleEventEmitter, getPageLifecycleState, initPageLifecycle, isPageLifecycleInitialized } from "./pagelifecycle/util.js";
+export { typeCheck, typeCheckArray, typeCheckEnum } from "./typecheck/util.js";
+export { delayPromise, loadJSON } from "./util/async.js";
 export { FetchError, fetchRetry, HTTP_0_ANY } from "./util/fetch.js";
+export { addFloat, deg2rad, fixFloat, fixFloatPrecision, getRandomInt, isEqual, isGreater, isGreaterOrEqual, isInRange, isLess, isLessOrEqual, subFloat } from "./util/number.js";
+export { purgeObject, deepMerge, getObjArrayPropSum, getObjValueByPath, setObjValueByPath } from "./util/object.js";
+export { getURLParam, sanitizeURLParam } from "./util/query.js";
+export { addLeadingZero, capitalize, getTypeFromValue, saveAsFile, underscoreToCamelCase } from "./util/string.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,EAK9K;IADC,kBAJkB,OAAO,aAAa,EAAE,MAAM,aAAa,MAAM,SAAS,MAAM,WAAW,MAAM,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,SAAS,KAAK,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAIvJ;CAmBzB;mCA9BkC,yBAAyB"}
+{"version":3,"file":"OpenTelemetryLogHandler.d.ts","sourceRoot":"","sources":["../../src/logging/OpenTelemetryLogHandler.js"],"names":[],"mappings":"AAEA;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,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,EAK9K;IADC,kBAJkB,OAAO,aAAa,EAAE,MAAM,aAAa,MAAM,SAAS,MAAM,WAAW,MAAM,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,SAAS,KAAK,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAIvJ;CAmBzB;mCA7BkC,yBAAyB"}

package/types/pagelifecycle/const.d.ts

@@ -8,4 +8,6 @@ export const DOCUMENT_STATE_FULLY_LOADED: "fullyLoaded";
 export const DOCUMENT_STATE_COMPLETE: "complete";
 export const DOCUMENT_STATE_INTERACTIVE: "interactive";
 export const DOCUMENT_STATE_LOADING: "loading";
+export const PAGE_LIFECYCLE_STATE_CHANGE_EVENT: "pageLifecycleStateChange";
+export const DOCUMENT_STATE_CHANGE_EVENT: "documentStateChange";
 //# sourceMappingURL=const.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/const.js"],"names":[],"mappings":"AAAA,0CAA2C,QAAQ,CAAC;AACpD,0CAA2C,QAAQ,CAAC;AACpD,2CAA4C,SAAS,CAAC;AACtD,0CAA2C,QAAQ,CAAC;AACpD,8CAA+C,YAAY,CAAC;AAE5D,wCAAyC,WAAW,CAAC;AACrD,0CAA2C,aAAa,CAAC;AACzD,sCAAuC,UAAU,CAAC;AAClD,yCAA0C,aAAa,CAAC;AACxD,qCAAsC,SAAS,CAAC"}
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/const.js"],"names":[],"mappings":"AAAA,0CAA2C,QAAQ,CAAC;AACpD,0CAA2C,QAAQ,CAAC;AACpD,2CAA4C,SAAS,CAAC;AACtD,0CAA2C,QAAQ,CAAC;AACpD,8CAA+C,YAAY,CAAC;AAE5D,wCAAyC,WAAW,CAAC;AACrD,0CAA2C,aAAa,CAAC;AACzD,sCAAuC,UAAU,CAAC;AAClD,yCAA0C,aAAa,CAAC;AACxD,qCAAsC,SAAS,CAAC;AAEhD,gDAAiD,0BAA0B,CAAC;AAC5E,0CAA2C,qBAAqB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/util.js"],"names":[],"mappings":"AAiGO,0CAyBN;AAMM,yCAFM,MAAM,GAAG,IAAI,GAAG,SAAS,CAE8B;AAM7D,oCAFM,OAAO,cAAc,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,CAEV;AAMnD,gDAFM,YAAY,CAOxB;AAMM,8CAFM,OAAO,CAEyC;AAOtD,gDAHI,OAAO,cAAc,EAAE,aAAa,GAAG,OAAO,cAAc,EAAE,kBAAkB,YAChF,MAAM,IAAI,QAMpB;6BA3J4B,eAAe"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/util.js"],"names":[],"mappings":"AAkGO,0CAyBN;AAMM,yCAFM,MAAM,GAAG,IAAI,GAAG,SAAS,CAE8B;AAM7D,oCAFM,OAAO,cAAc,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,CAEV;AAMnD,gDAFM,YAAY,CAOxB;AAMM,8CAFM,OAAO,CAEyC;AAOtD,gDAHI,OAAO,cAAc,EAAE,aAAa,GAAG,OAAO,cAAc,EAAE,kBAAkB,YAChF,MAAM,IAAI,QAMpB;6BA5J4B,eAAe"}

package/types/typecheck/TypeCheckError.d.ts

@@ -0,0 +1,8 @@
+export class TypeCheckError extends TypeError {
+    /**
+     * Creates a new `TypeCheckError` instance.
+     * @param {string} message - Error message.
+     */
+    constructor(message: string);
+}
+//# sourceMappingURL=TypeCheckError.d.ts.map

package/types/typecheck/TypeCheckError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeCheckError.d.ts","sourceRoot":"","sources":["../../src/typecheck/TypeCheckError.js"],"names":[],"mappings":"AAAA;IACE;;;OAGG;IACH,qBAFW,MAAM,EAKhB;CACF"}

package/types/{util/typecheck.d.ts → typecheck/TypeChecker.d.ts}

@@ -1,12 +1,3 @@
-export class TypeCheckError extends TypeError {
-    /**
-     * Creates a new `TypeCheckError` instance.
-     * @param {string} message - Error message.
-     */
-    constructor(message: string);
-}
-export function typeCheck<T>(value: unknown, validator: (value: unknown) => value is T): T;
-export function typeCheckArray<T>(value: unknown[], validator: (value: unknown) => value is T): T[];
 /**
  * Export a single shared instance.
  */
@@ -24,18 +15,26 @@ declare class TypeChecker {
      * @template T
      * @param {unknown} value - The value to check.
      * @param {(value: unknown) => value is T} validator - The validator to check with.
-     * @returns {T | null} - The type checked value.
+     * @returns {T} - The type checked value.
      */
-    check<T>(value: unknown, validator: (value: unknown) => value is T): T | null;
+    check<T>(value: unknown, validator: (value: unknown) => value is T): T;
     /**
      * Type check an array of values.
      * @template T
      * @param {unknown[]} value - The value to check.
      * @param {(value: unknown) => value is T} validator - The validator to check the array with.
-     * @returns {T[] | null} - The type checked value.
+     * @returns {T[]} - The type checked value.
+     */
+    checkArray<T>(value: unknown[], validator: (value: unknown) => value is T): T[];
+    /**
+     * Type check an array of values.
+     * @template T
+     * @param {string | number} value - The value to check.
+     * @param {(string | number)[] | Set<string | number> | Record<string | number, string | number>} choices - Enum list.
+     * @returns {string | number} - The type checked value.
      */
-    checkArray<T>(value: unknown[], validator: (value: unknown) => value is T): T[] | null;
+    checkEnum<T>(value: string | number, choices: (string | number)[] | Set<string | number> | Record<string | number, string | number>): string | number;
     #private;
 }
 export {};
-//# sourceMappingURL=typecheck.d.ts.map
+//# sourceMappingURL=TypeChecker.d.ts.map

package/types/typecheck/TypeChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeChecker.d.ts","sourceRoot":"","sources":["../../src/typecheck/TypeChecker.js"],"names":[],"mappings":"AAuFA;;GAEG;AACH,sCAA6C;AApF7C;IACE,0BAA0B;IAC1B,+BADW,WAAW,CACL;IAWjB;;;OAGG;IACH,wBAFW,OAAO,QAIjB;IAED;;;;;;OAMG;IACH,MALa,CAAC,SACH,OAAO,aACP,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAC5B,CAAC,CAab;IAED;;;;;;OAMG;IACH,WALa,CAAC,SACH,OAAO,EAAE,aACT,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAC5B,CAAC,EAAE,CAaf;IAED;;;;;;OAMG;IACH,UALa,CAAC,SACH,MAAM,GAAG,MAAM,WACf,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACnF,MAAM,GAAG,MAAM,CAY3B;;CACF"}

package/types/typecheck/util.d.ts

@@ -0,0 +1,4 @@
+export function typeCheck<T>(value: unknown, validator: (value: unknown) => value is T): T;
+export function typeCheckArray<T>(value: unknown[], validator: (value: unknown) => value is T): T[];
+export function typeCheckEnum(value: string | number, choices: (string | number)[] | Set<string | number> | Record<string | number, string | number>): string | number;
+//# sourceMappingURL=util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/typecheck/util.js"],"names":[],"mappings":"AAcO,0BANM,CAAC,SACH,OAAO,aACP,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAC5B,CAAC,CAUb;AAUM,+BANM,CAAC,SACH,OAAO,EAAE,aACT,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAC5B,CAAC,EAAE,CAUf;AASM,qCALI,MAAM,GAAG,MAAM,WACf,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACnF,MAAM,GAAG,MAAM,CAU3B"}

package/types/util/string.d.ts

@@ -2,4 +2,5 @@ export function addLeadingZero(value: number | string | null | undefined, size?:
 export function capitalize(value: string | null | undefined): string | null;
 export function underscoreToCamelCase(value: string): string;
 export function saveAsFile(filename: string, text: string): void;
+export function getTypeFromValue(value: unknown): string;
 //# sourceMappingURL=string.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/util/string.js"],"names":[],"mappings":"AAMO,sCAJI,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,SAClC,MAAM,GACJ,MAAM,GAAG,IAAI,CAWzB;AAOM,kCAHI,MAAM,GAAG,IAAI,GAAG,SAAS,GACvB,MAAM,GAAG,IAAI,CAWzB;AAOM,6CAHI,MAAM,GACJ,MAAM,CAEmF;AAO/F,qCAHI,MAAM,QACN,MAAM,QAUhB"}
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/util/string.js"],"names":[],"mappings":"AAMO,sCAJI,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,SAClC,MAAM,GACJ,MAAM,GAAG,IAAI,CAWzB;AAOM,kCAHI,MAAM,GAAG,IAAI,GAAG,SAAS,GACvB,MAAM,GAAG,IAAI,CAWzB;AAOM,6CAHI,MAAM,GACJ,MAAM,CAEmF;AAO/F,qCAHI,MAAM,QACN,MAAM,QAUhB;AAOM,wCAHI,OAAO,GACL,MAAM,CAEwF"}

package/types/util/validate.d.ts

@@ -13,7 +13,7 @@ export function isNullOrUndefined(value: unknown): value is null | undefined;
 export function isPlainObject(value: unknown): value is Record<string, unknown>;
 export function isFunction(value: unknown): value is (...args: any[]) => any;
 export function isInstance<T>(value: unknown, type: new (...args: any[]) => T): value is T;
-export function isEnum(value: unknown, choices: unknown[] | Set<string | number> | Record<string | number, unknown>): boolean;
+export function isEnum(value: unknown, choices: (string | number)[] | Set<string | number> | Record<string | number, string | number>): boolean;
 export function isArrayOf<T>(values: unknown[], validator: (value: unknown) => value is T): values is T[];
 export function isPlainObjectOf<T>(record: Record<string | number, unknown>, validator: (value: unknown) => value is T): record is Record<string | number, T>;
 export function refineValidator<T>(base: (value: unknown) => value is T, predicate: (value: T) => boolean, name?: string | null): (value: unknown) => value is T;

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

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

package/src/pagelifecycle/event.js

@@ -1,2 +0,0 @@
-export const PAGE_LIFECYCLE_STATE_CHANGE_EVENT = 'pageLifecycleStateChange';
-export const DOCUMENT_STATE_CHANGE_EVENT = 'documentStateChange';

package/src/util/typecheck.js

@@ -1,114 +0,0 @@
-import { Logger } from '../logging/Logger.js';
-import { isArrayOf } from './validate.js';
-
-const logger = new Logger('typecheck');
-
-export class TypeCheckError extends TypeError {
-  /**
-   * Creates a new `TypeCheckError` instance.
-   * @param {string} message - Error message.
-   */
-  constructor(message) {
-    super(message);
-    this.name = 'TypeCheckError';
-  }
-}
-
-/**
- * Type check a value using a validator.
- * @template T
- * @param {unknown} value - The value to check.
- * @param {(value: unknown) => value is T} validator - The validator to check with.
- * @returns {T} The type checked value.
- * @throws {TypeCheckError}
- */
-export const typeCheck = (value, validator) => {
-  if (!validator(value)) {
-    const name = validator.name || '<anonymous>';
-    const display = typeof value === 'string' ? `"${value}"` : Object.prototype.toString.call(value);
-    throw new TypeCheckError(`Validation failed: ${name} (${display})`);
-  }
-  return value;
-};
-
-/**
- * Type check a value using a validator.
- * @template T
- * @param {unknown[]} value - The value to check.
- * @param {(value: unknown) => value is T} validator - The validator to check the array with.
- * @returns {T[]} The type checked value.
- * @throws {TypeCheckError}
- */
-export const typeCheckArray = (value, validator) => {
-  if (!isArrayOf(value, validator)) {
-    const name = validator.name || '<anonymous>';
-    const display = typeof value === 'string' ? `"${value}"` : Object.prototype.toString.call(value);
-    throw new TypeCheckError(`Validation failed: ${name} (${display})`);
-  }
-  return value;
-};
-
-class TypeChecker {
-  /** @type {TypeChecker} */
-  static #instance;
-
-  /** @type {boolean} */
-  #swallowErrors = false;
-
-  constructor() {
-    if (TypeChecker.#instance === undefined) {
-      TypeChecker.#instance = this;
-    }
-  }
-
-  /**
-   * Enable or disable swallowing of TypeCheckErrors.
-   * @param {boolean} value - Swallow errors flag.
-   */
-  setSwallowErrors(value) {
-    this.#swallowErrors = Boolean(value);
-  }
-
-  /**
-   * Type check a single value.
-   * @template T
-   * @param {unknown} value - The value to check.
-   * @param {(value: unknown) => value is T} validator - The validator to check with.
-   * @returns {T | null} - The type checked value.
-   */
-  check(value, validator) {
-    try {
-      return typeCheck(value, validator);
-    } catch (error) {
-      if (this.#swallowErrors && error instanceof TypeCheckError) {
-        logger.exception('check', error);
-        return null;
-      }
-      throw error;
-    }
-  }
-
-  /**
-   * Type check an array of values.
-   * @template T
-   * @param {unknown[]} value - The value to check.
-   * @param {(value: unknown) => value is T} validator - The validator to check the array with.
-   * @returns {T[] | null} - The type checked value.
-   */
-  checkArray(value, validator) {
-    try {
-      return typeCheckArray(value, validator);
-    } catch (error) {
-      if (this.#swallowErrors && error instanceof TypeCheckError) {
-        logger.exception('checkArray', error);
-        return null;
-      }
-      throw error;
-    }
-  }
-}
-
-/**
- * Export a single shared instance.
- */
-export const typeChecker = new TypeChecker();

package/types/pagelifecycle/event.d.ts

@@ -1,3 +0,0 @@
-export const PAGE_LIFECYCLE_STATE_CHANGE_EVENT: "pageLifecycleStateChange";
-export const DOCUMENT_STATE_CHANGE_EVENT: "documentStateChange";
-//# sourceMappingURL=event.d.ts.map

package/types/pagelifecycle/event.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/event.js"],"names":[],"mappings":"AAAA,gDAAiD,0BAA0B,CAAC;AAC5E,0CAA2C,qBAAqB,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"typecheck.d.ts","sourceRoot":"","sources":["../../src/util/typecheck.js"],"names":[],"mappings":"AAKA;IACE;;;OAGG;IACH,qBAFW,MAAM,EAKhB;CACF;AAUM,0BANM,CAAC,SACH,OAAO,aACP,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAC5B,CAAC,CAUb;AAUM,+BANM,CAAC,SACH,OAAO,EAAE,aACT,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAC5B,CAAC,EAAE,CAUf;AA8DD;;GAEG;AACH,sCAA6C;AA/D7C;IACE,0BAA0B;IAC1B,+BADW,WAAW,CACL;IAWjB;;;OAGG;IACH,wBAFW,OAAO,QAIjB;IAED;;;;;;OAMG;IACH,MALa,CAAC,SACH,OAAO,aACP,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAC5B,CAAC,GAAG,IAAI,CAYpB;IAED;;;;;;OAMG;IACH,WALa,CAAC,SACH,OAAO,EAAE,aACT,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAC5B,CAAC,EAAE,GAAG,IAAI,CAYtB;;CACF"}