@vpmedia/simplify 1.60.0 → 1.62.0

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## [1.62.0] - 2026-01-14
+
+### 🧪 Testing
+
+- Improve test coverage, added getTypedError
+
+### ⚙️ Miscellaneous Tasks
+
+- Release
+- *(release)* V1.62.0
+## [1.61.0] - 2026-01-14
+
+### 🚜 Refactor
+
+- Improve validation error message
+
+### ⚙️ Miscellaneous Tasks
+
+- Release
+- *(release)* V1.61.0
 ## [1.60.0] - 2026-01-14
 
 ### 💼 Other

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/simplify",
-  "version": "1.60.0",
+  "version": "1.62.0",
   "description": "@vpmedia/simplify",
   "author": "Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)",
   "license": "MIT",

package/src/index.js

@@ -20,7 +20,7 @@ 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 { getErrorDetails, getTypedError } from './util/error.js';
 export { FetchError, fetchRetry, HTTP_0_ANY } from './util/fetch.js';
 export {
   addFloat,

package/src/typecheck/util.js

@@ -1,9 +1,17 @@
-import { getTypeFromValue } from '../util/string.js';
+import { getDisplayValue, getTypeFromValue } from '../util/string.js';
 import { isArrayOf, isEnum } from '../util/validate.js';
 import { TypeCheckError } from './TypeCheckError.js';
 
-const VALIDATOR_FALLBACK_NAME = '<anonymous>';
-
+/**
+ * Get error message for validator exceptions.
+ * @param {string} validatorName - Validator name.
+ * @param {unknown} value - Input value.
+ */
+const getErrorMessage = (validatorName, value) => {
+  const displayValue = getDisplayValue(value);
+  const displayType = getTypeFromValue(value);
+  throw new TypeCheckError(`Validation failed: ${validatorName || '<anonymous>'} - ${displayValue} (${displayType})`);
+};
 /**
  * Type check a value using a validator.
  * @template T
@@ -14,9 +22,8 @@ const VALIDATOR_FALLBACK_NAME = '<anonymous>';
  */
 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})`);
+    const errorMessage = getErrorMessage(validator.name, value);
+    throw new TypeCheckError(errorMessage);
   }
   return value;
 };
@@ -31,9 +38,8 @@ export const typeCheck = (value, validator) => {
  */
 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})`);
+    const errorMessage = getErrorMessage(validator.name, value);
+    throw new TypeCheckError(errorMessage);
   }
   return value;
 };
@@ -47,9 +53,8 @@ export const typeCheckArray = (value, validator) => {
  */
 export const typeCheckEnum = (value, choices) => {
   if (!isEnum(value, choices)) {
-    const validatorName = 'isEnum';
-    const displayValue = getTypeFromValue(value);
-    throw new TypeCheckError(`Validation failed: ${validatorName} (${displayValue})`);
+    const errorMessage = getErrorMessage('isEnum', value);
+    throw new TypeCheckError(errorMessage);
   }
   return value;
 };

package/src/typecheck/util.test.js

@@ -24,5 +24,12 @@ describe('typecheck', () => {
     expect(() => typeCheckEnum(null, ['BB'])).toThrowError(TypeCheckError);
     // @ts-expect-error
     expect(() => typeCheckEnum(['AA'], null)).toThrowError(TypeCheckError);
+    try {
+      typeCheckEnum('AA', ['BB']);
+    } catch (error) {
+      if (error instanceof Error) {
+        expect(error.message).toBe('Validation failed: isEnum - "AA" (string)');
+      }
+    }
   });
 });

package/src/util/async.test.js

@@ -10,7 +10,7 @@ describe('delayPromise', () => {
     expect(end - start).toBeGreaterThanOrEqual(9);
   });
 
-  test('Handles zero delay correctly', async () => {
+  test('delayPromise with zero delay', async () => {
     const start = Date.now();
     await delayPromise(0);
     const end = Date.now();

package/src/util/error.js

@@ -22,3 +22,10 @@ export const getErrorDetails = (error, excludes = ['stack']) => {
   }
   return errorDetails;
 };
+
+/**
+ * Get typed error from an unknown type.
+ * @param {unknown} error - The error to cast.
+ * @returns {Error} The typed error object.
+ */
+export const getTypedError = (error) => (error instanceof Error ? error : new Error(String(error)));

package/src/util/error.test.js

@@ -1,20 +1,33 @@
-import { getErrorDetails } from './error.js';
+/* eslint-disable unicorn/no-useless-undefined */
 
-test('Tests getErrorDetails', () => {
-  const error = new Error('Test error', { cause: 'Test cause' });
-  const errorDetails = getErrorDetails(error);
-  expect(errorDetails.type).toBe('Error');
-  expect(errorDetails.message).toBe('Test error');
-  expect(errorDetails.cause).toBe('Test cause');
-});
+import { getErrorDetails, getTypedError } from './error.js';
+
+describe('error', () => {
+  test('getErrorDetails', () => {
+    const error = new Error('Test error', { cause: 'Test cause' });
+    const errorDetails = getErrorDetails(error);
+    expect(errorDetails.type).toBe('Error');
+    expect(errorDetails.message).toBe('Test error');
+    expect(errorDetails.cause).toBe('Test cause');
+  });
+
+  test('getErrorDetails with Error cause', () => {
+    const error = new SyntaxError('Test error', { cause: new TypeError('Cause error') });
+    const errorDetails = getErrorDetails(error);
+    expect(errorDetails.type).toBe('SyntaxError');
+    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');
+    }
+  });
 
-test('Tests getErrorDetails with Error cause', () => {
-  const error = new SyntaxError('Test error', { cause: new TypeError('Cause error') });
-  const errorDetails = getErrorDetails(error);
-  expect(errorDetails.type).toBe('SyntaxError');
-  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');
-  }
+  test('getTypedError', () => {
+    expect(getTypedError(new Error('Error message')).message).toBe('Error message');
+    expect(getTypedError('Error message').message).toBe('Error message');
+    expect(getTypedError(1).message).toBe('1');
+    expect(getTypedError(true).message).toBe('true');
+    expect(getTypedError(null).message).toBe('null');
+    expect(getTypedError(undefined).message).toBe('undefined');
+  });
 });

package/src/util/state.test.js

@@ -1,45 +1,47 @@
 import { serverDataToState } from './state.js';
 
-test('serverDataToState() recursive', () => {
-  const state = serverDataToState(
-    {
-      my_array: [{ key_a: 'value1' }],
-      my_data: { key_a: 'value1' },
-      my_list: [1, 2, 3],
-      my_null: null,
-      my_number: 1000,
-      my_string: 'a',
-      my_var: 'test',
-    },
-    true
-  );
-  expect(state.myArray[0].keyA).toBe('value1');
-  expect(state.myData.keyA).toBe('value1');
-  expect(state.myList[0]).toBe(1);
-  expect(state.myNull).toBe(null);
-  expect(state.myNumber).toBe(1000);
-  expect(state.myString).toBe('a');
-  expect(state.myVar).toBe('test');
-});
+describe('state', () => {
+  test('serverDataToState() recursive', () => {
+    const state = serverDataToState(
+      {
+        my_array: [{ key_a: 'value1' }],
+        my_data: { key_a: 'value1' },
+        my_list: [1, 2, 3],
+        my_null: null,
+        my_number: 1000,
+        my_string: 'a',
+        my_var: 'test',
+      },
+      true
+    );
+    expect(state.myArray[0].keyA).toBe('value1');
+    expect(state.myData.keyA).toBe('value1');
+    expect(state.myList[0]).toBe(1);
+    expect(state.myNull).toBe(null);
+    expect(state.myNumber).toBe(1000);
+    expect(state.myString).toBe('a');
+    expect(state.myVar).toBe('test');
+  });
 
-test('serverDataToState() non-recursive', () => {
-  const state = serverDataToState(
-    {
-      my_array: [{ key_a: 'value1' }],
-      my_data: { key_a: 'value1' },
-      my_list: [1, 2, 3],
-      my_null: null,
-      my_number: 1000,
-      my_string: 'a',
-      my_var: 'test',
-    },
-    false
-  );
-  expect(state.myArray[0].key_a).toBe('value1');
-  expect(state.myData.key_a).toBe('value1');
-  expect(state.myList[0]).toBe(1);
-  expect(state.myNull).toBe(null);
-  expect(state.myNumber).toBe(1000);
-  expect(state.myString).toBe('a');
-  expect(state.myVar).toBe('test');
+  test('serverDataToState() non-recursive', () => {
+    const state = serverDataToState(
+      {
+        my_array: [{ key_a: 'value1' }],
+        my_data: { key_a: 'value1' },
+        my_list: [1, 2, 3],
+        my_null: null,
+        my_number: 1000,
+        my_string: 'a',
+        my_var: 'test',
+      },
+      false
+    );
+    expect(state.myArray[0].key_a).toBe('value1');
+    expect(state.myData.key_a).toBe('value1');
+    expect(state.myList[0]).toBe(1);
+    expect(state.myNull).toBe(null);
+    expect(state.myNumber).toBe(1000);
+    expect(state.myString).toBe('a');
+    expect(state.myVar).toBe('test');
+  });
 });

package/src/util/string.js

@@ -59,3 +59,18 @@ export const saveAsFile = (filename, text) => {
  * @returns {string} Type in human readable format.
  */
 export const getTypeFromValue = (value) => Object.prototype.toString.call(value).slice(8, -1).toLowerCase();
+
+/**
+ * Get value in human readable format.
+ * @param {unknown} value - The value to check.
+ * @returns {string} Value in human readable format.
+ */
+export const getDisplayValue = (value) => {
+  if (typeof value === 'string') {
+    return `"${value}"`;
+  }
+  if (typeof value === 'object') {
+    return JSON.stringify(value);
+  }
+  return String(value);
+};

package/src/util/string.test.js

@@ -1,59 +1,66 @@
 /* eslint-disable unicorn/no-useless-undefined */
 
-import { underscoreToCamelCase, capitalize, addLeadingZero, getTypeFromValue } from './string.js';
+import {
+  underscoreToCamelCase,
+  capitalize,
+  addLeadingZero,
+  getTypeFromValue,
+  getDisplayValue,
+  saveAsFile,
+} from './string.js';
 
-test('Tests add leading zero', () => {
-  expect(addLeadingZero(1)).toBe('01');
-  expect(addLeadingZero('1')).toBe('01');
-  expect(addLeadingZero(1, 3)).toBe('001');
-  expect(addLeadingZero('21')).toBe('21');
-  expect(addLeadingZero(21)).toBe('21');
-  expect(addLeadingZero(null)).toBe(null);
-  expect(addLeadingZero(undefined)).toBe(null);
-});
+describe('string', () => {
+  test('addLeadingZero', () => {
+    expect(addLeadingZero(1)).toBe('01');
+    expect(addLeadingZero('1')).toBe('01');
+    expect(addLeadingZero(1, 3)).toBe('001');
+    expect(addLeadingZero('21')).toBe('21');
+    expect(addLeadingZero(21)).toBe('21');
+    expect(addLeadingZero(null)).toBe(null);
+    expect(addLeadingZero(undefined)).toBe(null);
+  });
 
-describe('capitalize', () => {
-  test('Capitalizes first letter of string', () => {
+  test('capitalize', () => {
     expect(capitalize('test')).toBe('Test');
     expect(capitalize('TEST')).toBe('Test');
     expect(capitalize('tEST')).toBe('Test');
-  });
-
-  test('Handles null input', () => {
     expect(capitalize(null)).toBe(null);
-  });
-
-  test('Handles empty string', () => {
     expect(capitalize('')).toBe('');
-  });
-
-  test('Handles empty string with whitespace', () => {
     expect(capitalize('   ')).toBe('   ');
-  });
-
-  test('Handles single character', () => {
     expect(capitalize('a')).toBe('A');
     expect(capitalize('A')).toBe('A');
+    expect(capitalize('test123')).toBe('Test123');
   });
 
-  test('Handles strings with numbers', () => {
-    expect(capitalize('test123')).toBe('Test123');
+  test('underscoreToCamelCase', () => {
+    expect(underscoreToCamelCase('test')).toBe('test');
+    expect(underscoreToCamelCase('test_variable')).toBe('testVariable');
+    expect(underscoreToCamelCase('test_variable_name')).toBe('testVariableName');
   });
-});
 
-test('Converts underscore to camelCase', () => {
-  expect(underscoreToCamelCase('test')).toBe('test');
-  expect(underscoreToCamelCase('test_variable')).toBe('testVariable');
-  expect(underscoreToCamelCase('test_variable_name')).toBe('testVariableName');
-});
+  test('getTypeFromValue', () => {
+    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');
+  });
+
+  test('getDisplayValue', () => {
+    expect(getDisplayValue('test')).toBe('"test"');
+    expect(getDisplayValue(() => null)).toBe('() => null');
+    expect(getDisplayValue([])).toBe('[]');
+    expect(getDisplayValue({})).toBe('{}');
+    expect(getDisplayValue(new Date())).not.toBe(null);
+    expect(getDisplayValue(null)).toBe('null');
+    expect(getDisplayValue(true)).toBe('true');
+    expect(getDisplayValue(undefined)).toBe('undefined');
+  });
 
-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');
+  test('saveAsFile', () => {
+    expect(() => saveAsFile('test.txt', 'test content')).not.toThrowError(Error);
+  });
 });

package/types/index.d.ts

@@ -10,12 +10,12 @@ 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 { getErrorDetails, getTypedError } from "./util/error.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";

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

@@ -1 +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"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/typecheck/util.js"],"names":[],"mappings":"AAsBO,0BANM,CAAC,SACH,OAAO,aACP,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAC5B,CAAC,CASb;AAUM,+BANM,CAAC,SACH,OAAO,EAAE,aACT,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAC5B,CAAC,EAAE,CASf;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,CAS3B"}

package/types/util/error.d.ts

@@ -1,2 +1,3 @@
 export function getErrorDetails(error: Error, excludes?: string[]): object;
+export function getTypedError(error: unknown): Error;
 //# sourceMappingURL=error.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/util/error.js"],"names":[],"mappings":"AAMO,uCAJI,KAAK,aACL,MAAM,EAAE,GACN,MAAM,CAmBlB"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/util/error.js"],"names":[],"mappings":"AAMO,uCAJI,KAAK,aACL,MAAM,EAAE,GACN,MAAM,CAmBlB;AAOM,qCAHI,OAAO,GACL,KAAK,CAEiF"}

package/types/util/string.d.ts

@@ -3,4 +3,5 @@ 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;
+export function getDisplayValue(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;AAOM,wCAHI,OAAO,GACL,MAAM,CAEwF"}
+{"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;AAOpG,uCAHI,OAAO,GACL,MAAM,CAUlB"}