@vpmedia/simplify 1.61.0 → 1.62.0

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/simplify",
-  "version": "1.61.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/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.test.js

@@ -1,70 +1,66 @@
 /* eslint-disable unicorn/no-useless-undefined */
 
-import { underscoreToCamelCase, capitalize, addLeadingZero, getTypeFromValue, getDisplayValue } 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('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(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('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/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"}