@vpmedia/simplify 1.60.0 → 1.61.0

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [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.61.0",
   "description": "@vpmedia/simplify",
   "author": "Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)",
   "license": "MIT",

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/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,6 +1,6 @@
 /* eslint-disable unicorn/no-useless-undefined */
 
-import { underscoreToCamelCase, capitalize, addLeadingZero, getTypeFromValue } from './string.js';
+import { underscoreToCamelCase, capitalize, addLeadingZero, getTypeFromValue, getDisplayValue } from './string.js';
 
 test('Tests add leading zero', () => {
   expect(addLeadingZero(1)).toBe('01');
@@ -47,7 +47,7 @@ test('Converts underscore to camelCase', () => {
   expect(underscoreToCamelCase('test_variable_name')).toBe('testVariableName');
 });
 
-test('getDisplayValue', () => {
+test('getTypeFromValue', () => {
   expect(getTypeFromValue('test')).toBe('string');
   expect(getTypeFromValue(() => null)).toBe('function');
   expect(getTypeFromValue([])).toBe('array');
@@ -57,3 +57,14 @@ test('getDisplayValue', () => {
   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');
+});

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