@vpmedia/simplify 1.16.0 → 1.18.0

package/README.md

@@ -1,6 +1,6 @@
 # @vpmedia/simplify
 
-[![npm version](https://badge.fury.io/js/@vpmedia%2Fsimplify.svg?v=1.16.0)](https://badge.fury.io/js/@vpmedia%2Fsimplify)
+[![npm version](https://badge.fury.io/js/@vpmedia%2Fsimplify.svg?v=1.18.0)](https://badge.fury.io/js/@vpmedia%2Fsimplify)
 [![Node.js CI](https://github.com/vpmedia/simplify/actions/workflows/ci.yml/badge.svg)](https://github.com/vpmedia/simplify/actions/workflows/ci.yml)
 
 @vpmedia/simplify TBD

package/lefthook.yml

@@ -1,7 +1,3 @@
-# Copyright (c) Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
-# author: Andras Csizmadia <andras@vpmedia.hu>
-# see: https://github.com/evilmartians/lefthook/blob/master/docs/configuration.md
-
 pre-commit:
   parallel: false
   commands:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/simplify",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "description": "@vpmedia/simplify",
   "author": "Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)",
   "license": "MIT",
@@ -19,32 +19,30 @@
   "types": "./types/index.d.ts",
   "type": "module",
   "devDependencies": {
-    "@babel/preset-env": "^7.26.0",
-    "@eslint/js": "^9.15.0",
+    "@babel/preset-env": "^7.26.9",
+    "@eslint/js": "^9.23.0",
     "@jest/globals": "^29.7.0",
     "@types/jest": "^29.5.14",
-    "eslint": "^9.15.0",
-    "eslint-plugin-jsdoc": "^50.5.0",
-    "eslint-plugin-unicorn": "^56.0.1",
-    "globals": "^15.12.0",
+    "eslint": "^9.24.0",
+    "eslint-plugin-jsdoc": "^50.6.9",
+    "eslint-plugin-unicorn": "^58.0.0",
+    "globals": "^16.0.0",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
-    "lefthook": "^1.8.4",
-    "prettier": "^3.3.3",
-    "typescript": "^5.7.2"
+    "prettier": "^3.5.3",
+    "typescript": "^5.8.3"
   },
   "scripts": {
     "test": "NODE_OPTIONS=--experimental-vm-modules jest --passWithNoTests",
     "lint": "eslint \"**/*.{js,jsx}\"",
     "typecheck": "tsc",
-    "format": "prettier --write \"./**/*.{js,jsx,mjs,cjs,ts,tsx,json,md,css}\"",
-    "lefthook:install": "lefthook install",
-    "lefthook:uninstall": "lefthook uninstall"
+    "format": "prettier --write \"./**/*.{js,jsx,mjs,cjs,ts,tsx,json,md,css}\""
   },
   "browserslist": [
     "> 0.5%",
     "not dead",
-    "not op_mini all"
+    "not op_mini all",
+    "iOS >= 14"
   ],
   "dependencies": {
     "eventemitter3": "^5.0.1"

package/src/index.js

@@ -7,16 +7,20 @@ export * from './pagelifecycle/typedef.js';
 export * from './pagelifecycle/util.js';
 export { addLeadingZero } from './util/addLeadingZero.js';
 export { capitalize } from './util/capitalize.js';
+export { deepMerge } from './util/deepMerge.js';
 export { deg2rad } from './util/deg2rad.js';
 export { delayPromise } from './util/delayPromise.js';
-export { FetchError, HTTP_0_ANY, fetchRetry } from './util/fetchRetry.js';
+export { FetchError, fetchRetry, HTTP_0_ANY } from './util/fetchRetry.js';
 export { fixFloatPrecision } from './util/fixFloatPrecision.js';
 export { getObjValueByPath } from './util/getObjValueByPath.js';
 export { getRandomInt } from './util/getRandomInt.js';
 export { getURLParam } from './util/getURLParam.js';
+export { loadJSON } from './util/loadJSON.js';
 export { purgeObject } from './util/purgeObject.js';
 export { addFloat, fixFloat, subFloat } from './util/safeFloat.js';
 export { sanitizeURLParam } from './util/sanitizeURLParam.js';
 export { saveAsFile } from './util/saveAsFile.js';
+export { serverDataToState } from './util/serverDataToState.js';
 export { setObjValueByPath } from './util/setObjValueByPath.js';
 export { underscoreToCamelCase } from './util/underscoreToCamelCase.js';
+

package/src/util/deepMerge.js

@@ -0,0 +1,23 @@
+/**
+ * TBD.
+ * @param {object} target - TBD.
+ * @param {object} source - TBD.
+ * @returns {object} TBD.
+ */
+export const deepMerge = (target, source) => {
+  if (typeof target !== 'object' || target === null) return source;
+  if (typeof source !== 'object' || source === null) return target;
+
+  for (const key of Object.keys(source)) {
+    if (typeof source[key] === 'object' && source[key] !== null) {
+      if (!target[key] || typeof target[key] !== 'object') {
+        target[key] = {};
+      }
+      deepMerge(target[key], source[key]);
+    } else {
+      target[key] = source[key];
+    }
+  }
+
+  return target;
+};

package/src/util/deepMerge.test.js

@@ -0,0 +1,25 @@
+import { deepMerge } from './deepMerge.js';
+
+describe('deepMerge', () => {
+  test('should override deep properties correctly', () => {
+    const defaultObj = { a: { b: 1, c: 2 }, d: 3 };
+    const overrideObj = { a: { b: 42 } };
+    const expectedResult = { a: { b: 42, c: 2 }, d: 3 };
+
+    expect(deepMerge({ ...defaultObj }, overrideObj)).toEqual(expectedResult);
+  });
+
+  test('should not modify the original target object', () => {
+    const target = { x: { y: 10 } };
+    const source = { x: { y: 20 } };
+    const copy = { ...target };
+
+    deepMerge(target, source);
+    expect(target).toEqual(copy);
+  });
+
+  test('should handle non-object values correctly', () => {
+    expect(deepMerge(null, { a: 1 })).toEqual({ a: 1 });
+    expect(deepMerge({ a: 1 }, null)).toEqual({ a: 1 });
+  });
+});

package/src/util/fetchRetry.js

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

package/src/util/loadJSON.js

@@ -0,0 +1,10 @@
+/**
+ * Load JSON file using a fetch GET request.
+ * @param {string} url - URL to load.
+ * @returns {Promise<string>} The parsed JSON data.
+ */
+export async function loadJSON(url) {
+  const response = await fetch(url);
+  const json = await response.json();
+  return JSON.stringify(json);
+}

package/src/util/serverDataToState.js

@@ -0,0 +1,15 @@
+import { underscoreToCamelCase } from './underscoreToCamelCase.js';
+
+/**
+ * Maps server data to client data.
+ * @param {object} data - The server input data.
+ * @returns {object} The output data.
+ */
+export const serverDataToState = (data) => {
+  const result = {};
+  for (const serverKey of Object.keys(data)) {
+    const clientKey = underscoreToCamelCase(serverKey);
+    result[clientKey] = data[serverKey];
+  }
+  return result;
+};

package/src/util/serverDataToState.test.js

@@ -0,0 +1,8 @@
+import { serverDataToState } from './serverDataToState.js';
+
+test('serverDataToState()', () => {
+  const state = serverDataToState({ balance: 1000, my_var: 'test', my_list: [1, 2, 3] });
+  expect(state.balance).toBe(1000);
+  expect(state.myVar).toBe('test');
+  expect(state.myList[0]).toBe(1);
+});

package/types/index.d.ts

@@ -6,17 +6,20 @@ export * from "./pagelifecycle/util.js";
 export { Logger } from "./logging/Logger.js";
 export { addLeadingZero } from "./util/addLeadingZero.js";
 export { capitalize } from "./util/capitalize.js";
+export { deepMerge } from "./util/deepMerge.js";
 export { deg2rad } from "./util/deg2rad.js";
 export { delayPromise } from "./util/delayPromise.js";
 export { fixFloatPrecision } from "./util/fixFloatPrecision.js";
 export { getObjValueByPath } from "./util/getObjValueByPath.js";
 export { getRandomInt } from "./util/getRandomInt.js";
 export { getURLParam } from "./util/getURLParam.js";
+export { loadJSON } from "./util/loadJSON.js";
 export { purgeObject } from "./util/purgeObject.js";
 export { sanitizeURLParam } from "./util/sanitizeURLParam.js";
 export { saveAsFile } from "./util/saveAsFile.js";
+export { serverDataToState } from "./util/serverDataToState.js";
 export { setObjValueByPath } from "./util/setObjValueByPath.js";
 export { underscoreToCamelCase } from "./util/underscoreToCamelCase.js";
-export { FetchError, HTTP_0_ANY, fetchRetry } from "./util/fetchRetry.js";
+export { FetchError, fetchRetry, HTTP_0_ANY } from "./util/fetchRetry.js";
 export { addFloat, fixFloat, subFloat } from "./util/safeFloat.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/util.js"],"names":[],"mappings":"AAsCO,gDAHI,OAAO,cAAc,EAAE,aAAa,GAAG,OAAO,cAAc,EAAE,kBAAkB,YAChF,MAAM,IAAI,QAMpB;AAgEM,0CAsBN;AAMM,yCAFM,MAAM,CAIlB;AAMM,oCAFM,OAAO,cAAc,EAAE,aAAa,CAIhD;AAMM,gDAFM,YAAY,CAOxB;AAMM,8CAFM,OAAO,CAInB;6BA9J4B,eAAe"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/util.js"],"names":[],"mappings":"AAsCO,gDAHI,OAAO,cAAc,EAAE,aAAa,GAAG,OAAO,cAAc,EAAE,kBAAkB,YAChF,MAAM,IAAI,QAMpB;AAgEM,0CAyBN;AAMM,yCAFM,MAAM,CAIlB;AAMM,oCAFM,OAAO,cAAc,EAAE,aAAa,CAIhD;AAMM,gDAFM,YAAY,CAOxB;AAMM,8CAFM,OAAO,CAInB;6BAjK4B,eAAe"}

package/types/util/deepMerge.d.ts

@@ -0,0 +1,2 @@
+export function deepMerge(target: object, source: object): object;
+//# sourceMappingURL=deepMerge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deepMerge.d.ts","sourceRoot":"","sources":["../../src/util/deepMerge.js"],"names":[],"mappings":"AAMO,kCAJI,MAAM,UACN,MAAM,GACJ,MAAM,CAkBlB"}

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

@@ -1 +1 @@
-{"version":3,"file":"fetchRetry.d.ts","sourceRoot":"","sources":["../../src/util/fetchRetry.js"],"names":[],"mappings":"AAMA,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,iBACtB,WAAW,iBACX;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAC,GAC5D,OAAO,CAAC,QAAQ,CAAC,CA0C7B"}
+{"version":3,"file":"fetchRetry.d.ts","sourceRoot":"","sources":["../../src/util/fetchRetry.js"],"names":[],"mappings":"AAWA,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,iBACtB,WAAW,iBACX;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAC,GAC5D,OAAO,CAAC,QAAQ,CAAC,CA2C7B"}

package/types/util/loadJSON.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Load JSON file using a fetch GET request.
+ * @param {string} url - URL to load.
+ * @returns {Promise<string>} The parsed JSON data.
+ */
+export function loadJSON(url: string): Promise<string>;
+//# sourceMappingURL=loadJSON.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadJSON.d.ts","sourceRoot":"","sources":["../../src/util/loadJSON.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,8BAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAM3B"}

package/types/util/serverDataToState.d.ts

@@ -0,0 +1,2 @@
+export function serverDataToState(data: object): object;
+//# sourceMappingURL=serverDataToState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serverDataToState.d.ts","sourceRoot":"","sources":["../../src/util/serverDataToState.js"],"names":[],"mappings":"AAOO,wCAHI,MAAM,GACJ,MAAM,CASlB"}