@etsoo/shared 1.2.69 → 1.2.71

package/README.md

@@ -112,16 +112,17 @@ ETSOO Extended abstract history class
 
 Array related utilities
 
-|        Name | Description                                            |
-| ----------: | ------------------------------------------------------ |
-| differences | Array 1 items do not exist in Array 2 or reverse match |
-|         max | Get max number item or number item property            |
-|     maxItem | Get max field value item                               |
-|         min | Get min number item or number item property            |
-|     minItem | Get min field value item                               |
-|      remove | Remove items by value or condition                     |
-|         sum | Sum number items or number item properties             |
-|    toUnique | Make all items are unique                              |
+|        Name | Description                                                  |
+| ----------: | ------------------------------------------------------------ |
+| differences | Array 1 items do not exist in Array 2 or reverse match       |
+|         max | Get max number item or number item property                  |
+|     maxItem | Get max field value item                                     |
+| mergeArrays | Merge arrays, remove duplicates, and sort by the first array |
+|         min | Get min number item or number item property                  |
+|     minItem | Get min field value item                                     |
+|      remove | Remove items by value or condition                           |
+|         sum | Sum number items or number item properties                   |
+|    toUnique | Make all items are unique                                    |
 
 ## DataTypes
 
@@ -196,6 +197,7 @@ Data type definitions and type safe functions. ListItemType, ListItemType1 and L
 |      isSimpleObject | Is the target a simple object, all values are simple type (Type guard) |
 |        isSimpleType | Is the input value simple type, include null and undefined             |
 |        jsonReplacer | JSON.stringify replacer with full path                                 |
+|       jsonSerialize | JSON serialize with options                                            |
 
 ## DateUtils
 

package/__tests__/ArrayUtils.ts

@@ -63,6 +63,15 @@ test("Tests for maxItem / minItem", () => {
   expect(emptyItems.maxItem("amount")).toBeUndefined();
 });
 
+test("Tests for mergeArrays", () => {
+  const a1 = ["e", "a", "c"];
+  const a2 = ["a", "c", "d"];
+  const a3 = ["b", "c", "f"];
+  const result = ArrayUtils.mergeArrays(a1, a2, a3);
+  expect(result).toEqual(["e", "a", "c", "d", "b", "f"]);
+  expect(result.length).toBe(6);
+});
+
 test("Tests for remove simple", () => {
   const items = [1, 2, 3, 4, 5];
   const result = items.remove(1, 5, (item) => item % 2 === 0);

package/__tests__/DataTypes.ts

@@ -202,6 +202,26 @@ test("Tests for jsonReplacer", () => {
   expect(json2).toBe('{"c":{"c2":false}}');
 });
 
+test("Tests for jsonSerialize", () => {
+  const obj = { a: 1, b: null, c: { c1: undefined, c2: false, c3: 128 } };
+  const json = DataTypes.jsonSerialize(obj);
+  expect(json).toBe('{"a":1,"c":{"c2":false,"c3":128}}');
+});
+
+test("Tests for jsonSerialize with removing empty values", () => {
+  const obj = {
+    a: 1,
+    b: null,
+    c: { c1: undefined, c2: false, c3: 128, c4: "" },
+    d: ""
+  };
+  const json = DataTypes.jsonSerialize(obj, {
+    ignoreEmpty: true,
+    ignoreNull: false
+  });
+  expect(json).toBe('{"a":1,"b":null,"c":{"c2":false,"c3":128}}');
+});
+
 test("Tests for EditType", () => {
   type AddEntity = {
     name: string;

package/lib/cjs/ArrayUtils.d.ts

@@ -61,4 +61,11 @@ export declare namespace ArrayUtils {
      * @param round A round for both matches
      */
     function differences<T>(a1: T[], a2: T[], round?: boolean): T[];
+    /**
+     * Merge arrays, remove duplicates, and sort by the first array
+     * @param sort Array to sort
+     * @param param All arrays to merge
+     * @returns Result
+     */
+    function mergeArrays<T>(sort: T[], ...param: T[][]): T[];
 }

package/lib/cjs/ArrayUtils.js

@@ -99,4 +99,24 @@ var ArrayUtils;
         return diff;
     }
     ArrayUtils.differences = differences;
+    /**
+     * Merge arrays, remove duplicates, and sort by the first array
+     * @param sort Array to sort
+     * @param param All arrays to merge
+     * @returns Result
+     */
+    function mergeArrays(sort, ...param) {
+        const result = [...sort];
+        for (let i = 0; i < param.length; i++) {
+            const arr = param[i];
+            for (let j = 0; j < arr.length; j++) {
+                const item = arr[j];
+                if (!result.includes(item)) {
+                    result.push(item);
+                }
+            }
+        }
+        return result;
+    }
+    ArrayUtils.mergeArrays = mergeArrays;
 })(ArrayUtils || (exports.ArrayUtils = ArrayUtils = {}));

package/lib/cjs/DataTypes.d.ts

@@ -420,6 +420,16 @@ export declare namespace DataTypes {
      * @returns JSON receiver function
      */
     function jsonBigintReceiver(...args: string[]): (this: any, key: any, value: any) => any;
+    /**
+     * JSON serialize with options
+     * @param obj Object to serialize
+     * @param options Options to ignore null or empty values
+     * @returns Result
+     */
+    function jsonSerialize(obj: unknown, options?: {
+        ignoreNull?: boolean;
+        ignoreEmpty?: boolean;
+    }): string;
 }
 /**
  * Number and string combination id type

package/lib/cjs/DataTypes.js

@@ -498,4 +498,21 @@ var DataTypes;
         });
     }
     DataTypes.jsonBigintReceiver = jsonBigintReceiver;
+    /**
+     * JSON serialize with options
+     * @param obj Object to serialize
+     * @param options Options to ignore null or empty values
+     * @returns Result
+     */
+    function jsonSerialize(obj, options) {
+        const { ignoreNull = true, ignoreEmpty = false } = options ?? {};
+        return JSON.stringify(obj, (_key, value) => {
+            if (ignoreNull && value == null)
+                return undefined;
+            if (ignoreEmpty && value === "")
+                return undefined;
+            return value;
+        });
+    }
+    DataTypes.jsonSerialize = jsonSerialize;
 })(DataTypes || (exports.DataTypes = DataTypes = {}));

package/lib/mjs/ArrayUtils.d.ts

@@ -61,4 +61,11 @@ export declare namespace ArrayUtils {
      * @param round A round for both matches
      */
     function differences<T>(a1: T[], a2: T[], round?: boolean): T[];
+    /**
+     * Merge arrays, remove duplicates, and sort by the first array
+     * @param sort Array to sort
+     * @param param All arrays to merge
+     * @returns Result
+     */
+    function mergeArrays<T>(sort: T[], ...param: T[][]): T[];
 }

package/lib/mjs/ArrayUtils.js

@@ -93,4 +93,24 @@ export var ArrayUtils;
         return diff;
     }
     ArrayUtils.differences = differences;
+    /**
+     * Merge arrays, remove duplicates, and sort by the first array
+     * @param sort Array to sort
+     * @param param All arrays to merge
+     * @returns Result
+     */
+    function mergeArrays(sort, ...param) {
+        const result = [...sort];
+        for (let i = 0; i < param.length; i++) {
+            const arr = param[i];
+            for (let j = 0; j < arr.length; j++) {
+                const item = arr[j];
+                if (!result.includes(item)) {
+                    result.push(item);
+                }
+            }
+        }
+        return result;
+    }
+    ArrayUtils.mergeArrays = mergeArrays;
 })(ArrayUtils || (ArrayUtils = {}));

package/lib/mjs/DataTypes.d.ts

@@ -420,6 +420,16 @@ export declare namespace DataTypes {
      * @returns JSON receiver function
      */
     function jsonBigintReceiver(...args: string[]): (this: any, key: any, value: any) => any;
+    /**
+     * JSON serialize with options
+     * @param obj Object to serialize
+     * @param options Options to ignore null or empty values
+     * @returns Result
+     */
+    function jsonSerialize(obj: unknown, options?: {
+        ignoreNull?: boolean;
+        ignoreEmpty?: boolean;
+    }): string;
 }
 /**
  * Number and string combination id type

package/lib/mjs/DataTypes.js

@@ -495,4 +495,21 @@ export var DataTypes;
         });
     }
     DataTypes.jsonBigintReceiver = jsonBigintReceiver;
+    /**
+     * JSON serialize with options
+     * @param obj Object to serialize
+     * @param options Options to ignore null or empty values
+     * @returns Result
+     */
+    function jsonSerialize(obj, options) {
+        const { ignoreNull = true, ignoreEmpty = false } = options ?? {};
+        return JSON.stringify(obj, (_key, value) => {
+            if (ignoreNull && value == null)
+                return undefined;
+            if (ignoreEmpty && value === "")
+                return undefined;
+            return value;
+        });
+    }
+    DataTypes.jsonSerialize = jsonSerialize;
 })(DataTypes || (DataTypes = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@etsoo/shared",
-  "version": "1.2.69",
+  "version": "1.2.71",
   "description": "TypeScript shared utilities and functions",
   "main": "lib/cjs/index.js",
   "module": "lib/mjs/index.js",
@@ -37,10 +37,10 @@
   "homepage": "https://github.com/ETSOO/Shared#readme",
   "devDependencies": {
     "@types/lodash.isequal": "^4.5.8",
-    "@vitejs/plugin-react": "^4.4.0",
+    "@vitejs/plugin-react": "^4.4.1",
     "jsdom": "^26.1.0",
     "typescript": "^5.8.3",
-    "vitest": "^3.1.1"
+    "vitest": "^3.1.3"
   },
   "dependencies": {
     "lodash.isequal": "^4.5.0"

package/src/ArrayUtils.ts

@@ -212,4 +212,26 @@ export namespace ArrayUtils {
     if (round) return [...diff, ...a2.filter((x) => !a1.includes(x))];
     return diff;
   }
+
+  /**
+   * Merge arrays, remove duplicates, and sort by the first array
+   * @param sort Array to sort
+   * @param param All arrays to merge
+   * @returns Result
+   */
+  export function mergeArrays<T>(sort: T[], ...param: T[][]): T[] {
+    const result = [...sort];
+
+    for (let i = 0; i < param.length; i++) {
+      const arr = param[i];
+      for (let j = 0; j < arr.length; j++) {
+        const item = arr[j];
+        if (!result.includes(item)) {
+          result.push(item);
+        }
+      }
+    }
+
+    return result;
+  }
 }

package/src/DataTypes.ts

@@ -800,6 +800,25 @@ export namespace DataTypes {
       return value;
     });
   }
+
+  /**
+   * JSON serialize with options
+   * @param obj Object to serialize
+   * @param options Options to ignore null or empty values
+   * @returns Result
+   */
+  export function jsonSerialize(
+    obj: unknown,
+    options?: { ignoreNull?: boolean; ignoreEmpty?: boolean }
+  ) {
+    const { ignoreNull = true, ignoreEmpty = false } = options ?? {};
+
+    return JSON.stringify(obj, (_key, value) => {
+      if (ignoreNull && value == null) return undefined;
+      if (ignoreEmpty && value === "") return undefined;
+      return value;
+    });
+  }
 }
 
 /**