@vpmedia/simplify 1.56.0 → 1.58.0

package/CHANGELOG.md

@@ -1,3 +1,47 @@
+## [1.58.0] - 2026-01-13
+
+### 💼 Other
+
+- *(deps)* Bump dependency versions
+
+### 🚜 Refactor
+
+- Use globalThis instead of window
+
+### 🧪 Testing
+
+- Fixed failing test
+
+### ⚙️ Miscellaneous Tasks
+
+- Release
+- Adjusted error message
+- *(release)* V1.58.0
+## [1.57.0] - 2026-01-12
+
+### 🚀 Features
+
+- Added type checker singleton
+- Extend error logging details with cause
+- Enrich exception logging with cause
+
+### 💼 Other
+
+- *(deps)* Bump dependency versions
+
+### 🚜 Refactor
+
+- Separate typecheck and validation modules
+
+### 🧪 Testing
+
+- Improve fetch retry tests
+- Improve fetch retry test coverage
+
+### ⚙️ Miscellaneous Tasks
+
+- Release
+- *(release)* V1.57.0
 ## [1.56.0] - 2026-01-12
 
 ### 💼 Other

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/simplify",
-  "version": "1.56.0",
+  "version": "1.58.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.6",
+    "@types/node": "^25.0.7",
     "@vitest/coverage-v8": "^4.0.17",
     "eslint": "^9.39.2",
     "eslint-plugin-jsdoc": "^62.0.0",
@@ -40,7 +40,7 @@
     "oxlint-tsgolint": "^0.11.0",
     "prettier": "^3.7.4",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.52.0",
+    "typescript-eslint": "^8.53.0",
     "vitest": "^4.0.17"
   },
   "browserslist": [

package/src/index.js

@@ -19,4 +19,5 @@ 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';

package/src/logging/ConsoleLogHandler.js

@@ -41,6 +41,9 @@ export class ConsoleLogHandler extends AbstractLogHandler {
     }
     if (error) {
       extra === undefined ? consoleFunction(logMessage, error) : consoleFunction(logMessage, error, extra);
+      if (error.cause) {
+        consoleFunction('Error cause', error.cause);
+      }
       return;
     }
     extra === undefined ? consoleFunction(logMessage) : consoleFunction(logMessage, extra);

package/src/pagelifecycle/util.js

@@ -104,13 +104,13 @@ export const initPageLifecycle = () => {
   onDocumentStateChange(document.readyState);
   const options = { capture: true };
   document.addEventListener('visibilitychange', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
-  // window.addEventListener('popstate', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
-  window.addEventListener('pageshow', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
-  window.addEventListener('focus', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
-  window.addEventListener('blur', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
+  // globalThis.addEventListener('popstate', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
+  globalThis.addEventListener('pageshow', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
+  globalThis.addEventListener('focus', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
+  globalThis.addEventListener('blur', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
   document.addEventListener('resume', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
   document.addEventListener('freeze', () => onPageLifecycleStateChange(PAGE_LIFECYCLE_STATE_FROZEN), options);
-  window.addEventListener(
+  globalThis.addEventListener(
     'pagehide',
     (event) =>
       onPageLifecycleStateChange(event.persisted ? PAGE_LIFECYCLE_STATE_FROZEN : PAGE_LIFECYCLE_STATE_TERMINATED),
@@ -118,7 +118,7 @@ export const initPageLifecycle = () => {
   );
   document.addEventListener('DOMContentLoaded', () => onDocumentStateChange(DOCUMENT_STATE_DOM_LOADED), options);
   document.addEventListener('readystatechange', () => onDocumentStateChange(document.readyState), options);
-  window.addEventListener('load', () => onDocumentStateChange(DOCUMENT_STATE_FULLY_LOADED), options);
+  globalThis.addEventListener('load', () => onDocumentStateChange(DOCUMENT_STATE_FULLY_LOADED), options);
   isInitialized = true;
 };
 

package/src/util/error.test.js

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

package/src/util/fetch.js

@@ -29,6 +29,7 @@ export class FetchError extends Error {
     this.resource = resource;
     this.fetchOptions = fetchOptions;
     this.response = response;
+    this.cause = response?.status ?? null;
   }
 }
 
@@ -53,17 +54,12 @@ export const fetchRetry = async (resource, fetchOptions, retryOptions) => {
   while (retryOptions.numTries > 0) {
     logger.info('request', { resource, fetchOptions, retryOptions });
     const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort('Fetch is timed out'), retryOptions.timeout);
+    const timeoutId = setTimeout(() => controller.abort('Fetch timed out'), retryOptions.timeout);
     fetchOptions.signal = controller.signal;
     try {
       const response = await fetch(resource, fetchOptions);
       if (!response.ok) {
-        throw new FetchError(
-          `fetch ${response.url} returned status ${response.status}`,
-          resource,
-          fetchOptions,
-          response
-        );
+        throw new FetchError(`Fetch error ${response.status}`, resource, fetchOptions, response);
       }
       logger.info('response', response);
       return response;
@@ -85,5 +81,5 @@ export const fetchRetry = async (resource, fetchOptions, retryOptions) => {
       clearTimeout(timeoutId);
     }
   }
-  throw new Error('Fetch has failed');
+  throw new Error('Fetch failed');
 };

package/src/util/fetch.test.js

@@ -1,9 +1,54 @@
+import { HTTP_404_NOT_FOUND } from '../const/http_status.js';
 import { fetchRetry, FetchError } from './fetch.js';
 
 describe('fetchRetry', () => {
-  test('core', () => {
-    expect(fetchRetry).toBeDefined();
-    expect(typeof fetchRetry).toBe('function');
-    expect(FetchError).toBeDefined();
+  test('fetch OK', async () => {
+    const response = await fetchRetry('https://jsonplaceholder.typicode.com/todos/1', {
+      cache: 'no-cache',
+      keepalive: false,
+      method: 'GET',
+      redirect: 'error',
+    });
+    const json = await response.json();
+    const expectedJSON = {
+      completed: false,
+      id: 1,
+      title: 'delectus aut autem',
+      userId: 1,
+    };
+    expect(json).toEqual(expectedJSON);
+  });
+  test('fetch unknown scheme', async () => {
+    try {
+      await fetchRetry('htps://jsonplaceholder', {});
+    } catch (error) {
+      const typedError = error instanceof Error ? error : new Error(String(error));
+      expect(typedError.message).toEqual('fetch failed');
+      const typedErrorCause =
+        typedError.cause instanceof Error ? typedError.cause : new Error(String(typedError.cause));
+      expect(typedErrorCause.message).toEqual('unknown scheme');
+    }
+  });
+  test('fetch 404 error with retry', async () => {
+    try {
+      await fetchRetry(
+        'https://jsonplaceholder.typicode.com/todos/1',
+        {
+          cache: 'no-cache',
+          keepalive: false,
+          method: 'POST',
+          redirect: 'error',
+        },
+        { numTries: 2, statusExcludes: [], delay: 1 }
+      );
+    } catch (error) {
+      const typedError = error instanceof Error ? error : new Error(String(error));
+      expect(typedError).toBeInstanceOf(FetchError);
+      if (typedError instanceof FetchError) {
+        expect(typedError.message).toBe('Fetch error 404');
+        expect(typedError.response.status).toBe(HTTP_404_NOT_FOUND);
+        expect(typedError.cause).toBe(HTTP_404_NOT_FOUND);
+      }
+    }
   });
 });

package/src/util/typecheck.js

@@ -0,0 +1,114 @@
+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/src/util/typecheck.test.js

@@ -0,0 +1,19 @@
+import { typeCheck, typeCheckArray, TypeCheckError } from './typecheck.js';
+import { isNumber, isPositiveInteger } from './validate.js';
+
+describe('typecheck', () => {
+  test('typeCheck', () => {
+    expect(() => typeCheck(0.1, isNumber)).not.toThrowError(TypeCheckError);
+    expect(() => typeCheck(-0.1, isPositiveInteger)).toThrowError(TypeCheckError);
+    expect(() => typeCheck('string', isNumber)).toThrowError(TypeCheckError);
+  });
+
+  test('typeCheckArray', () => {
+    expect(() => typeCheckArray([0.1], isNumber)).not.toThrowError(TypeCheckError);
+    expect(() => typeCheckArray(['string'], isNumber)).toThrowError(TypeCheckError);
+    // @ts-expect-error
+    expect(() => typeCheckArray(-0.1, isPositiveInteger)).toThrowError(TypeCheckError);
+    // @ts-expect-error
+    expect(() => typeCheckArray('string', isNumber)).toThrowError(TypeCheckError);
+  });
+});

package/src/util/validate.js

@@ -9,13 +9,6 @@ import { isEqual, isGreater, isGreaterOrEqual, isInRange, isLess, isLessOrEqual
  */
 export const isBoolean = (value) => typeof value === 'boolean';
 
-/**
- * Validates `value` as `function`.
- * @param {unknown} value - Input value.
- * @returns {value is (...args: any[]) => any} `true` if `value` is `function` type.
- */
-export const isFunction = (value) => typeof value === 'function';
-
 /**
  * Validates `value` as `number`.
  * @param {unknown} value - Input value.
@@ -101,6 +94,13 @@ export const isNullOrUndefined = (value) => isNull(value) || isUndefined(value);
  */
 export const isPlainObject = (value) => Object.prototype.toString.call(value) === '[object Object]';
 
+/**
+ * Validates `value` as `function`.
+ * @param {unknown} value - Input value.
+ * @returns {value is (...args: any[]) => any} `true` if `value` is `function` type.
+ */
+export const isFunction = (value) => typeof value === 'function';
+
 /**
  * Validates `value` as `type`
  * @template T
@@ -130,7 +130,7 @@ export const isEnum = (value, choices) => {
 /**
  * Type check an array of values using a validator.
  * @template T
- * @param {unknown} values - The value to check.
+ * @param {unknown[]} values - The value to check.
  * @param {(value: unknown) => value is T} validator - The validator to check with.
  * @returns {values is T[]} `true` if `values` has only `validator` checked types.
  */
@@ -196,79 +196,54 @@ export const refineValidator = (base, predicate, name = null) => {
 export const isAnyOf = (a, b) => (value) => a(value) || b(value);
 
 export const isNumberGreater = (min) => refineValidator(isNumber, (value) => isGreater(value, min));
+
 export const isNumberGreaterOrEqual = (min) => refineValidator(isNumber, (value) => isGreaterOrEqual(value, min));
+
 export const isNumberLess = (min) => refineValidator(isNumber, (value) => isLess(value, min));
+
 export const isNumberLessOrEqual = (min) => refineValidator(isNumber, (value) => isLessOrEqual(value, min));
+
 export const isNumberInRange = (min, max) => refineValidator(isNumber, (value) => isInRange(value, min, max));
+
 export const isNumberEqual = (expected) => refineValidator(isNumber, (value) => isEqual(value, expected));
 
 export const isIntegerGreater = (min) => refineValidator(isInteger, (value) => isGreater(value, min));
+
 export const isIntegerGreaterOrEqual = (min) => refineValidator(isInteger, (value) => isGreaterOrEqual(value, min));
+
 export const isIntegerLess = (min) => refineValidator(isInteger, (value) => isLess(value, min));
+
 export const isIntegerLessOrEqual = (min) => refineValidator(isInteger, (value) => isLessOrEqual(value, min));
+
 export const isIntegerInRange = (min, max) => refineValidator(isInteger, (value) => isInRange(value, min, max));
+
 export const isIntegerEqual = (expected) => refineValidator(isInteger, (value) => isEqual(value, expected));
 
 export const isStringLengthGreater = (min) => refineValidator(isString, (value) => isGreater(value.length, min));
+
 export const isStringLengthGreaterOrEqual = (min) =>
   refineValidator(isString, (value) => isGreaterOrEqual(value.length, min));
+
 export const isStringLengthLess = (min) => refineValidator(isString, (value) => isLess(value.length, min));
+
 export const isStringLengthLessOrEqual = (min) =>
   refineValidator(isString, (value) => isLessOrEqual(value.length, min));
+
 export const isStringLengthInRange = (min, max) =>
   refineValidator(isString, (value) => isInRange(value.length, min, max));
+
 export const isStringLengthEqual = (expected) => refineValidator(isString, (value) => isEqual(value.length, expected));
 
 export const isArrayLengthGreater = (min) => refineValidator(isArray, (value) => isGreater(value.length, min));
+
 export const isArrayLengthGreaterOrEqual = (min) =>
   refineValidator(isArray, (value) => isGreaterOrEqual(value.length, min));
+
 export const isArrayLengthLess = (min) => refineValidator(isArray, (value) => isLess(value.length, min));
+
 export const isArrayLengthLessOrEqual = (min) => refineValidator(isArray, (value) => isLessOrEqual(value.length, min));
+
 export const isArrayLengthInRange = (min, max) =>
   refineValidator(isArray, (value) => isInRange(value.length, min, max));
-export const isArrayLengthEqual = (expected) => refineValidator(isArray, (value) => isEqual(value.length, expected));
-
-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;
-};
+export const isArrayLengthEqual = (expected) => refineValidator(isArray, (value) => isEqual(value.length, expected));

package/src/util/validate.test.js

@@ -19,9 +19,6 @@ import {
   isPositiveNumber,
   isString,
   isUndefined,
-  typeCheck,
-  typeCheckArray,
-  TypeCheckError,
   refineValidator,
   isNumberLess,
   isNumberGreater,
@@ -227,6 +224,7 @@ describe('validate', () => {
     expect(isInstance(new CustomError(), {})).toBe(false);
     expect(isInstance(new CustomError(), Error)).toBe(true);
     expect(isInstance(new CustomError(), Number)).toBe(false);
+    expect(isInstance(new Date(), Date)).toBe(true);
   });
 
   test('isEnum', () => {
@@ -249,11 +247,14 @@ describe('validate', () => {
   });
 
   test('isArrayOf', () => {
+    // @ts-expect-error
     expect(isArrayOf(0.1, isNumber)).toBe(false);
     expect(isArrayOf([0.1, 'string'], isNumber)).toBe(false);
     expect(isArrayOf([0.1, 0.2], isNumber)).toBe(true);
     expect(isArrayOf([0.1, 1, 2], isInteger)).toBe(false);
     expect(isArrayOf([1, 2], isInteger)).toBe(true);
+    expect(isArrayOf([1, 'string', undefined], isAnyOf(isInteger, isNullOrUndefined))).toBe(false);
+    expect(isArrayOf([1, null, undefined], isAnyOf(isInteger, isNullOrUndefined))).toBe(true);
   });
 
   test('isPlainObjectOf', () => {
@@ -265,21 +266,6 @@ describe('validate', () => {
     expect(isPlainObjectOf({ a: 1, b: 2 }, isInteger)).toBe(true);
   });
 
-  test('typeCheck', () => {
-    expect(() => typeCheck(0.1, isNumber)).not.toThrowError(TypeCheckError);
-    expect(() => typeCheck(-0.1, isPositiveInteger)).toThrowError(TypeCheckError);
-    expect(() => typeCheck('string', isNumber)).toThrowError(TypeCheckError);
-  });
-
-  test('typeCheckArray', () => {
-    expect(() => typeCheckArray([0.1], isNumber)).not.toThrowError(TypeCheckError);
-    expect(() => typeCheckArray(['string'], isNumber)).toThrowError(TypeCheckError);
-    // @ts-expect-error
-    expect(() => typeCheckArray(-0.1, isPositiveInteger)).toThrowError(TypeCheckError);
-    // @ts-expect-error
-    expect(() => typeCheckArray('string', isNumber)).toThrowError(TypeCheckError);
-  });
-
   test('isAnyOf', () => {
     expect(isAnyOf(isNumber, isNull)(1)).toBe(true);
     expect(isAnyOf(isNumber, isNull)(null)).toBe(true);

package/types/index.d.ts

@@ -11,6 +11,7 @@ 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";

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

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

package/types/util/fetch.d.ts

@@ -11,6 +11,7 @@ export class FetchError extends Error {
     resource: string | URL | Request;
     fetchOptions: RequestInit;
     response: Response;
+    cause: number;
 }
 export function fetchRetry(resource: string | URL | Request, fetchOptions: RequestInit, retryOptions?: {
     delay?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/util/fetch.js"],"names":[],"mappings":"AAeA,yBAA0B,CAAC,CAAC;AAE5B;IACE;;;;;;OAMG;IACH,qBALW,MAAM,YACN,MAAM,GAAG,GAAG,GAAG,OAAO,gBACtB,WAAW,YACX,QAAQ,EAQlB;IAHC,iCAAwB;IACxB,0BAAgC;IAChC,mBAAwB;CAE3B;AASM,qCALI,MAAM,GAAG,GAAG,GAAG,OAAO,gBACtB,WAAW,iBACX;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC9E,OAAO,CAAC,QAAQ,CAAC,CAiD7B"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/util/fetch.js"],"names":[],"mappings":"AAeA,yBAA0B,CAAC,CAAC;AAE5B;IACE;;;;;;OAMG;IACH,qBALW,MAAM,YACN,MAAM,GAAG,GAAG,GAAG,OAAO,gBACtB,WAAW,YACX,QAAQ,EASlB;IAJC,iCAAwB;IACxB,0BAAgC;IAChC,mBAAwB;IACxB,cAAqC;CAExC;AASM,qCALI,MAAM,GAAG,GAAG,GAAG,OAAO,gBACtB,WAAW,iBACX;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC9E,OAAO,CAAC,QAAQ,CAAC,CA4C7B"}

package/types/util/typecheck.d.ts

@@ -0,0 +1,41 @@
+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.
+ */
+export const typeChecker: TypeChecker;
+declare class TypeChecker {
+    /** @type {TypeChecker} */
+    static "__#private@#instance": TypeChecker;
+    /**
+     * Enable or disable swallowing of TypeCheckErrors.
+     * @param {boolean} value - Swallow errors flag.
+     */
+    setSwallowErrors(value: boolean): void;
+    /**
+     * 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<T>(value: unknown, validator: (value: unknown) => value is T): T | null;
+    /**
+     * 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<T>(value: unknown[], validator: (value: unknown) => value is T): T[] | null;
+    #private;
+}
+export {};
+//# sourceMappingURL=typecheck.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}

package/types/util/validate.d.ts

@@ -1,5 +1,4 @@
 export function isBoolean(value: unknown): value is boolean;
-export function isFunction(value: unknown): value is (...args: any[]) => any;
 export function isNumber(value: unknown): value is number;
 export function isPositiveNumber(value: unknown): value is number;
 export function isNonNegativeNumber(value: unknown): value is number;
@@ -12,9 +11,10 @@ export function isNull(value: unknown): value is null;
 export function isUndefined(value: unknown): value is undefined;
 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 isArrayOf<T>(values: unknown, validator: (value: unknown) => value is T): values is T[];
+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;
 export function isAnyOf<A, B>(a: (value: unknown) => value is A, b: (value: unknown) => value is B): (value: unknown) => value is A | B;
@@ -42,13 +42,4 @@ export function isArrayLengthLess(min: any): (value: unknown) => value is unknow
 export function isArrayLengthLessOrEqual(min: any): (value: unknown) => value is unknown[];
 export function isArrayLengthInRange(min: any, max: any): (value: unknown) => value is unknown[];
 export function isArrayLengthEqual(expected: any): (value: unknown) => value is unknown[];
-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[];
 //# sourceMappingURL=validate.d.ts.map

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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"}