@etsoo/shared 1.0.75 → 1.0.79

package/README.md

@@ -131,6 +131,8 @@ String and other related utilities
 
 |Name|Description|
 |---:|---|
+|charsToNumber|Base64 chars to number|
+|equals|Two values equal|
 |formatInitial|Format inital character to lower case or upper case|
 |formatString|Format string with parameters|
 |getDataChanges|Get data changed fields with input data updated|
@@ -139,7 +141,10 @@ String and other related utilities
 |mergeFormData|Merge form data to primary one|
 |mergeClasses|Merge class names|
 |newGUID|Create a GUID|
+|numberToChars|Number to base64 chars|
 |objectEqual|Test two objects are equal or not|
+|objectKeys|Get two object's unqiue properties|
+|objectUpdated|Get the new object's updated fields contrast to the previous object|
 |parseString|Parse string (JSON) to specific type|
 |setLabels|Set source with new labels|
 |snakeNameToWord|Snake name to works, 'snake_name' to 'Snake Name'|

package/__tests__/Utils.ts

@@ -9,7 +9,8 @@ test('Tests for getDataChanges', () => {
         price: '6.0',
         amount: '',
         enabled: true,
-        value: undefined
+        value: undefined,
+        ids: [1, 2]
     };
     const initData = {
         id: 1,
@@ -18,7 +19,8 @@ test('Tests for getDataChanges', () => {
         brand: 'ETSOO',
         price: 6,
         amount: 0,
-        enabled: true
+        enabled: true,
+        ids: [1, 2]
     };
     const fields = Utils.getDataChanges(input, initData);
     expect(fields).toStrictEqual(['gender', 'brand', 'amount']);
@@ -67,6 +69,13 @@ test('Tests for newGUID', () => {
     expect(id1.length).toBe(id2.length);
 });
 
+test('Tests for numberToChars and charsToNumber', () => {
+    const num = 1638777042242;
+    const chars = Utils.numberToChars(num);
+    expect(chars).toEqual('QmpkdVgv');
+    expect(Utils.charsToNumber(chars)).toEqual(num);
+});
+
 test('Tests for removeNonLetters', () => {
     const input = '1234-5678@abc.';
     const result = '12345678abc';
@@ -75,17 +84,26 @@ test('Tests for removeNonLetters', () => {
 });
 
 test('Tests for objectEqual', () => {
-    const obj1 = { a: 1, b: 'abc', c: true, d: null };
-    const obj2 = { a: '1', b: 'abc', c: true };
+    const obj1 = { a: 1, b: 'abc', c: true, d: null, f: [1, 2] };
+    const obj2 = { a: '1', b: 'abc', c: true, f: [1, 2] };
     expect(Utils.objectEqual(obj1, obj2)).toBeFalsy();
     expect(Utils.objectEqual(obj1, obj2, [], 0)).toBeTruthy();
     expect(Utils.objectEqual(obj1, obj2, ['a'])).toBeTruthy();
     expect(Utils.objectEqual(obj1, obj2, ['a'], 2)).toBeFalsy();
 });
 
+test('Tests for objectUpdated', () => {
+    const objPrev = { a: 1, b: 'abc', c: true, d: null, f: [1, 2] };
+    const objNew = { a: 2, b: 'abc', d: new Date(), f: [1, 2, 3] };
+    const fields = Utils.objectUpdated(objNew, objPrev, ['d']);
+    expect(fields.sort()).toStrictEqual(['a', 'c', 'f']);
+});
+
 test('Tests for parseString', () => {
-    expect(Utils.parseString('test', '')).toBe('test');
+    expect(Utils.parseString<string>('test')).toBe('test');
     expect(Utils.parseString('true', false)).toBe(true);
+    expect(Utils.parseString('', false)).toBeFalsy();
+    expect(Utils.parseString<number>(undefined)).toBeUndefined();
     expect(Utils.parseString('3.14', 0)).toBe(3.14);
     expect(Utils.parseString('2021/4/13', new Date())).toStrictEqual(
         new Date('2021/4/13')

package/lib/cjs/StorageUtils.d.ts

@@ -20,7 +20,7 @@ export declare namespace StorageUtils {
      * @param key Key name
      * @param defaultValue Default value
      */
-    function getLocalData<T>(key: string, defaultValue: T): T;
+    function getLocalData<T>(key: string, defaultValue?: T): T | undefined;
     /**
      * Get local storage object data
      * @param key Key name
@@ -30,7 +30,7 @@ export declare namespace StorageUtils {
      * Get session storage data
      * @param key Key name
      */
-    function getSessionData<T>(key: string, defaultValue: T): T;
+    function getSessionData<T>(key: string, defaultValue?: T): T | undefined;
     /**
      * Get session storage object data
      * @param key Key name

package/lib/cjs/Utils.d.ts

@@ -35,6 +35,19 @@ declare global {
  * Utilities
  */
 export declare namespace Utils {
+    /**
+     * Base64 chars to number
+     * @param base64Chars Base64 chars
+     * @returns Number
+     */
+    function charsToNumber(base64Chars: string): number;
+    /**
+     * Two values equal
+     * @param v1 Value 1
+     * @param v2 Value 2
+     * @param strict Strict level, 0 with ==, 1 === but null equal undefined, 2 ===
+     */
+    function equals(v1: unknown, v2: unknown, strict?: number): boolean;
     /**
      * Format inital character to lower case or upper case
      * @param input Input string
@@ -89,6 +102,12 @@ export declare namespace Utils {
      * Create a GUID
      */
     function newGUID(): string;
+    /**
+     * Number to base64 chars
+     * @param num Input number
+     * @returns Result
+     */
+    function numberToChars(num: number): string;
     /**
      * Test two objects are equal or not
      * @param obj1 Object 1
@@ -99,12 +118,30 @@ export declare namespace Utils {
      */
     function objectEqual(obj1: {}, obj2: {}, ignoreFields?: string[], strict?: number): boolean;
     /**
-     * Parse string (JSON) to specific type
+     * Get two object's unqiue properties
+     * @param obj1 Object 1
+     * @param obj2 Object 2
+     * @param ignoreFields Ignored fields
+     * @returns Unique properties
+     */
+    function objectKeys(obj1: {}, obj2: {}, ignoreFields?: string[]): Set<string>;
+    /**
+     * Get the new object's updated fields contrast to the previous object
+     * @param objNew New object
+     * @param objPre Previous object
+     * @param ignoreFields Ignored fields
+     * @param strict Strict level, 0 with ==, 1 === but null equal undefined, 2 ===
+     * @returns Updated fields
+     */
+    function objectUpdated(objNew: {}, objPrev: {}, ignoreFields?: string[], strict?: number): string[];
+    /**
+     * Parse string (JSON) to specific type, no type conversion
+     * For type conversion, please use DataTypes.convert
      * @param input Input string
      * @param defaultValue Default value
      * @returns Parsed value
      */
-    function parseString<T>(input: string | undefined | null, defaultValue: T): T;
+    function parseString<T>(input: string | undefined | null, defaultValue?: T): T | undefined;
     /**
      * Remove non letters
      * @param input Input string

package/lib/cjs/Utils.js

@@ -29,6 +29,43 @@ String.prototype.removeNonLetters = function () {
  */
 var Utils;
 (function (Utils) {
+    /**
+     * Base64 chars to number
+     * @param base64Chars Base64 chars
+     * @returns Number
+     */
+    function charsToNumber(base64Chars) {
+        const chars = typeof Buffer === 'undefined'
+            ? [...atob(base64Chars)].map((char) => char.charCodeAt(0))
+            : [...Buffer.from(base64Chars, 'base64')];
+        return chars.reduce((previousValue, currentValue, currentIndex) => {
+            return previousValue + currentValue * Math.pow(128, currentIndex);
+        }, 0);
+    }
+    Utils.charsToNumber = charsToNumber;
+    /**
+     * Two values equal
+     * @param v1 Value 1
+     * @param v2 Value 2
+     * @param strict Strict level, 0 with ==, 1 === but null equal undefined, 2 ===
+     */
+    function equals(v1, v2, strict = 1) {
+        // Null and undefined case
+        if (v1 == null || v2 == null) {
+            if (strict <= 1 && v1 == v2)
+                return true;
+            return v1 === v2;
+        }
+        // For array and object
+        if (typeof v1 === 'object')
+            return JSON.stringify(v1) === JSON.stringify(v2);
+        // 1 and '1' case
+        if (strict === 0)
+            return v1 == v2;
+        // Strict equal
+        return v1 === v2;
+    }
+    Utils.equals = equals;
     /**
      * Format inital character to lower case or upper case
      * @param input Input string
@@ -71,7 +108,7 @@ var Utils;
             }
             if (initValue != null) {
                 const newValue = DataTypes_1.DataTypes.convert(value, initValue);
-                if (newValue === initValue) {
+                if (Utils.equals(newValue, initValue)) {
                     Reflect.deleteProperty(input, key);
                     return;
                 }
@@ -149,6 +186,27 @@ var Utils;
         });
     }
     Utils.newGUID = newGUID;
+    /**
+     * Number to base64 chars
+     * @param num Input number
+     * @returns Result
+     */
+    function numberToChars(num) {
+        const codes = [];
+        while (num > 0) {
+            const code = num % 128;
+            codes.push(code);
+            num = (num - code) / 128;
+        }
+        if (typeof Buffer === 'undefined') {
+            return btoa(String.fromCharCode(...codes));
+        }
+        else {
+            const buffer = Buffer.from(codes);
+            return buffer.toString('base64');
+        }
+    }
+    Utils.numberToChars = numberToChars;
     /**
      * Test two objects are equal or not
      * @param obj1 Object 1
@@ -158,37 +216,66 @@ var Utils;
      * @returns Result
      */
     function objectEqual(obj1, obj2, ignoreFields = [], strict = 1) {
-        // Keys
-        const keys = new Set([
-            ...Object.keys(obj1).filter((item) => !ignoreFields.includes(item)),
-            ...Object.keys(obj2).filter((item) => !ignoreFields.includes(item))
-        ]);
+        // Unique keys
+        const keys = Utils.objectKeys(obj1, obj2, ignoreFields);
         for (const key of keys) {
             // Values
             const v1 = Reflect.get(obj1, key);
             const v2 = Reflect.get(obj2, key);
-            // Null and undefined case
-            if (v1 == null && v2 == null && strict <= 1)
-                continue;
-            // 1 and '1' case
-            if (strict === 0 && v1 == v2)
-                continue;
-            // Strict equal
-            if (v1 !== v2)
+            if (!Utils.equals(v1, v2, strict))
                 return false;
         }
         return true;
     }
     Utils.objectEqual = objectEqual;
     /**
-     * Parse string (JSON) to specific type
+     * Get two object's unqiue properties
+     * @param obj1 Object 1
+     * @param obj2 Object 2
+     * @param ignoreFields Ignored fields
+     * @returns Unique properties
+     */
+    function objectKeys(obj1, obj2, ignoreFields = []) {
+        // All keys
+        const allKeys = [...Object.keys(obj1), ...Object.keys(obj2)].filter((item) => !ignoreFields.includes(item));
+        // Unique keys
+        return new Set(allKeys);
+    }
+    Utils.objectKeys = objectKeys;
+    /**
+     * Get the new object's updated fields contrast to the previous object
+     * @param objNew New object
+     * @param objPre Previous object
+     * @param ignoreFields Ignored fields
+     * @param strict Strict level, 0 with ==, 1 === but null equal undefined, 2 ===
+     * @returns Updated fields
+     */
+    function objectUpdated(objNew, objPrev, ignoreFields = [], strict = 1) {
+        // Fields
+        const fields = [];
+        // Unique keys
+        const keys = Utils.objectKeys(objNew, objPrev, ignoreFields);
+        for (const key of keys) {
+            // Values
+            const vNew = Reflect.get(objNew, key);
+            const vPrev = Reflect.get(objPrev, key);
+            if (!Utils.equals(vNew, vPrev, strict)) {
+                fields.push(key);
+            }
+        }
+        return fields;
+    }
+    Utils.objectUpdated = objectUpdated;
+    /**
+     * Parse string (JSON) to specific type, no type conversion
+     * For type conversion, please use DataTypes.convert
      * @param input Input string
      * @param defaultValue Default value
      * @returns Parsed value
      */
     function parseString(input, defaultValue) {
-        // Undefined case, return default value
-        if (input == null)
+        // Undefined and empty case, return default value
+        if (input == null || input === '')
             return defaultValue;
         // String
         if (typeof defaultValue === 'string')
@@ -206,16 +293,11 @@ var Utils;
             // Return
             return json;
         }
-        catch (e) {
-            console.log('Utils.parseString error', e);
+        catch {
+            if (defaultValue == null)
+                return input;
             return defaultValue;
         }
-        /*
-        finally part will still return the boolean value
-        finally {
-            return defaultValue
-        }
-        */
     }
     Utils.parseString = parseString;
     /**

package/lib/mjs/StorageUtils.d.ts

@@ -20,7 +20,7 @@ export declare namespace StorageUtils {
      * @param key Key name
      * @param defaultValue Default value
      */
-    function getLocalData<T>(key: string, defaultValue: T): T;
+    function getLocalData<T>(key: string, defaultValue?: T): T | undefined;
     /**
      * Get local storage object data
      * @param key Key name
@@ -30,7 +30,7 @@ export declare namespace StorageUtils {
      * Get session storage data
      * @param key Key name
      */
-    function getSessionData<T>(key: string, defaultValue: T): T;
+    function getSessionData<T>(key: string, defaultValue?: T): T | undefined;
     /**
      * Get session storage object data
      * @param key Key name

package/lib/mjs/Utils.d.ts

@@ -35,6 +35,19 @@ declare global {
  * Utilities
  */
 export declare namespace Utils {
+    /**
+     * Base64 chars to number
+     * @param base64Chars Base64 chars
+     * @returns Number
+     */
+    function charsToNumber(base64Chars: string): number;
+    /**
+     * Two values equal
+     * @param v1 Value 1
+     * @param v2 Value 2
+     * @param strict Strict level, 0 with ==, 1 === but null equal undefined, 2 ===
+     */
+    function equals(v1: unknown, v2: unknown, strict?: number): boolean;
     /**
      * Format inital character to lower case or upper case
      * @param input Input string
@@ -89,6 +102,12 @@ export declare namespace Utils {
      * Create a GUID
      */
     function newGUID(): string;
+    /**
+     * Number to base64 chars
+     * @param num Input number
+     * @returns Result
+     */
+    function numberToChars(num: number): string;
     /**
      * Test two objects are equal or not
      * @param obj1 Object 1
@@ -99,12 +118,30 @@ export declare namespace Utils {
      */
     function objectEqual(obj1: {}, obj2: {}, ignoreFields?: string[], strict?: number): boolean;
     /**
-     * Parse string (JSON) to specific type
+     * Get two object's unqiue properties
+     * @param obj1 Object 1
+     * @param obj2 Object 2
+     * @param ignoreFields Ignored fields
+     * @returns Unique properties
+     */
+    function objectKeys(obj1: {}, obj2: {}, ignoreFields?: string[]): Set<string>;
+    /**
+     * Get the new object's updated fields contrast to the previous object
+     * @param objNew New object
+     * @param objPre Previous object
+     * @param ignoreFields Ignored fields
+     * @param strict Strict level, 0 with ==, 1 === but null equal undefined, 2 ===
+     * @returns Updated fields
+     */
+    function objectUpdated(objNew: {}, objPrev: {}, ignoreFields?: string[], strict?: number): string[];
+    /**
+     * Parse string (JSON) to specific type, no type conversion
+     * For type conversion, please use DataTypes.convert
      * @param input Input string
      * @param defaultValue Default value
      * @returns Parsed value
      */
-    function parseString<T>(input: string | undefined | null, defaultValue: T): T;
+    function parseString<T>(input: string | undefined | null, defaultValue?: T): T | undefined;
     /**
      * Remove non letters
      * @param input Input string

package/lib/mjs/Utils.js

@@ -26,6 +26,43 @@ String.prototype.removeNonLetters = function () {
  */
 export var Utils;
 (function (Utils) {
+    /**
+     * Base64 chars to number
+     * @param base64Chars Base64 chars
+     * @returns Number
+     */
+    function charsToNumber(base64Chars) {
+        const chars = typeof Buffer === 'undefined'
+            ? [...atob(base64Chars)].map((char) => char.charCodeAt(0))
+            : [...Buffer.from(base64Chars, 'base64')];
+        return chars.reduce((previousValue, currentValue, currentIndex) => {
+            return previousValue + currentValue * Math.pow(128, currentIndex);
+        }, 0);
+    }
+    Utils.charsToNumber = charsToNumber;
+    /**
+     * Two values equal
+     * @param v1 Value 1
+     * @param v2 Value 2
+     * @param strict Strict level, 0 with ==, 1 === but null equal undefined, 2 ===
+     */
+    function equals(v1, v2, strict = 1) {
+        // Null and undefined case
+        if (v1 == null || v2 == null) {
+            if (strict <= 1 && v1 == v2)
+                return true;
+            return v1 === v2;
+        }
+        // For array and object
+        if (typeof v1 === 'object')
+            return JSON.stringify(v1) === JSON.stringify(v2);
+        // 1 and '1' case
+        if (strict === 0)
+            return v1 == v2;
+        // Strict equal
+        return v1 === v2;
+    }
+    Utils.equals = equals;
     /**
      * Format inital character to lower case or upper case
      * @param input Input string
@@ -68,7 +105,7 @@ export var Utils;
             }
             if (initValue != null) {
                 const newValue = DataTypes.convert(value, initValue);
-                if (newValue === initValue) {
+                if (Utils.equals(newValue, initValue)) {
                     Reflect.deleteProperty(input, key);
                     return;
                 }
@@ -146,6 +183,27 @@ export var Utils;
         });
     }
     Utils.newGUID = newGUID;
+    /**
+     * Number to base64 chars
+     * @param num Input number
+     * @returns Result
+     */
+    function numberToChars(num) {
+        const codes = [];
+        while (num > 0) {
+            const code = num % 128;
+            codes.push(code);
+            num = (num - code) / 128;
+        }
+        if (typeof Buffer === 'undefined') {
+            return btoa(String.fromCharCode(...codes));
+        }
+        else {
+            const buffer = Buffer.from(codes);
+            return buffer.toString('base64');
+        }
+    }
+    Utils.numberToChars = numberToChars;
     /**
      * Test two objects are equal or not
      * @param obj1 Object 1
@@ -155,37 +213,66 @@ export var Utils;
      * @returns Result
      */
     function objectEqual(obj1, obj2, ignoreFields = [], strict = 1) {
-        // Keys
-        const keys = new Set([
-            ...Object.keys(obj1).filter((item) => !ignoreFields.includes(item)),
-            ...Object.keys(obj2).filter((item) => !ignoreFields.includes(item))
-        ]);
+        // Unique keys
+        const keys = Utils.objectKeys(obj1, obj2, ignoreFields);
         for (const key of keys) {
             // Values
             const v1 = Reflect.get(obj1, key);
             const v2 = Reflect.get(obj2, key);
-            // Null and undefined case
-            if (v1 == null && v2 == null && strict <= 1)
-                continue;
-            // 1 and '1' case
-            if (strict === 0 && v1 == v2)
-                continue;
-            // Strict equal
-            if (v1 !== v2)
+            if (!Utils.equals(v1, v2, strict))
                 return false;
         }
         return true;
     }
     Utils.objectEqual = objectEqual;
     /**
-     * Parse string (JSON) to specific type
+     * Get two object's unqiue properties
+     * @param obj1 Object 1
+     * @param obj2 Object 2
+     * @param ignoreFields Ignored fields
+     * @returns Unique properties
+     */
+    function objectKeys(obj1, obj2, ignoreFields = []) {
+        // All keys
+        const allKeys = [...Object.keys(obj1), ...Object.keys(obj2)].filter((item) => !ignoreFields.includes(item));
+        // Unique keys
+        return new Set(allKeys);
+    }
+    Utils.objectKeys = objectKeys;
+    /**
+     * Get the new object's updated fields contrast to the previous object
+     * @param objNew New object
+     * @param objPre Previous object
+     * @param ignoreFields Ignored fields
+     * @param strict Strict level, 0 with ==, 1 === but null equal undefined, 2 ===
+     * @returns Updated fields
+     */
+    function objectUpdated(objNew, objPrev, ignoreFields = [], strict = 1) {
+        // Fields
+        const fields = [];
+        // Unique keys
+        const keys = Utils.objectKeys(objNew, objPrev, ignoreFields);
+        for (const key of keys) {
+            // Values
+            const vNew = Reflect.get(objNew, key);
+            const vPrev = Reflect.get(objPrev, key);
+            if (!Utils.equals(vNew, vPrev, strict)) {
+                fields.push(key);
+            }
+        }
+        return fields;
+    }
+    Utils.objectUpdated = objectUpdated;
+    /**
+     * Parse string (JSON) to specific type, no type conversion
+     * For type conversion, please use DataTypes.convert
      * @param input Input string
      * @param defaultValue Default value
      * @returns Parsed value
      */
     function parseString(input, defaultValue) {
-        // Undefined case, return default value
-        if (input == null)
+        // Undefined and empty case, return default value
+        if (input == null || input === '')
             return defaultValue;
         // String
         if (typeof defaultValue === 'string')
@@ -203,16 +290,11 @@ export var Utils;
             // Return
             return json;
         }
-        catch (e) {
-            console.log('Utils.parseString error', e);
+        catch {
+            if (defaultValue == null)
+                return input;
             return defaultValue;
         }
-        /*
-        finally part will still return the boolean value
-        finally {
-            return defaultValue
-        }
-        */
     }
     Utils.parseString = parseString;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@etsoo/shared",
-    "version": "1.0.75",
+    "version": "1.0.79",
     "description": "TypeScript shared utilities and functions",
     "main": "lib/cjs/index.js",
     "module": "lib/mjs/index.js",
@@ -55,13 +55,13 @@
     "dependencies": {},
     "devDependencies": {
         "@types/jest": "^27.0.3",
-        "@typescript-eslint/eslint-plugin": "^5.4.0",
-        "@typescript-eslint/parser": "^5.4.0",
-        "eslint": "^8.2.0",
+        "@typescript-eslint/eslint-plugin": "^5.8.0",
+        "@typescript-eslint/parser": "^5.8.0",
+        "eslint": "^8.5.0",
         "eslint-config-airbnb-base": "^15.0.0",
         "eslint-plugin-import": "^2.25.3",
-        "jest": "^27.3.1",
-        "ts-jest": "^27.0.7",
-        "typescript": "^4.5.2"
+        "jest": "^27.4.5",
+        "ts-jest": "^27.1.2",
+        "typescript": "^4.5.4"
     }
 }

package/src/StorageUtils.ts

@@ -49,7 +49,7 @@ export namespace StorageUtils {
      * @param key Key name
      * @param defaultValue Default value
      */
-    export function getLocalData<T>(key: string, defaultValue: T) {
+    export function getLocalData<T>(key: string, defaultValue?: T) {
         // Get storage
         const data = localStorage.getItem(key);
 
@@ -72,7 +72,7 @@ export namespace StorageUtils {
      * Get session storage data
      * @param key Key name
      */
-    export function getSessionData<T>(key: string, defaultValue: T) {
+    export function getSessionData<T>(key: string, defaultValue?: T) {
         // Get storage
         const data = sessionStorage.getItem(key);
 

package/src/Utils.ts

@@ -77,6 +77,46 @@ String.prototype.removeNonLetters = function (this: string) {
  * Utilities
  */
 export namespace Utils {
+    /**
+     * Base64 chars to number
+     * @param base64Chars Base64 chars
+     * @returns Number
+     */
+    export function charsToNumber(base64Chars: string) {
+        const chars =
+            typeof Buffer === 'undefined'
+                ? [...atob(base64Chars)].map((char) => char.charCodeAt(0))
+                : [...Buffer.from(base64Chars, 'base64')];
+
+        return chars.reduce((previousValue, currentValue, currentIndex) => {
+            return previousValue + currentValue * Math.pow(128, currentIndex);
+        }, 0);
+    }
+
+    /**
+     * Two values equal
+     * @param v1 Value 1
+     * @param v2 Value 2
+     * @param strict Strict level, 0 with ==, 1 === but null equal undefined, 2 ===
+     */
+    export function equals(v1: unknown, v2: unknown, strict = 1) {
+        // Null and undefined case
+        if (v1 == null || v2 == null) {
+            if (strict <= 1 && v1 == v2) return true;
+            return v1 === v2;
+        }
+
+        // For array and object
+        if (typeof v1 === 'object')
+            return JSON.stringify(v1) === JSON.stringify(v2);
+
+        // 1 and '1' case
+        if (strict === 0) return v1 == v2;
+
+        // Strict equal
+        return v1 === v2;
+    }
+
     /**
      * Format inital character to lower case or upper case
      * @param input Input string
@@ -126,7 +166,7 @@ export namespace Utils {
 
             if (initValue != null) {
                 const newValue = DataTypes.convert(value, initValue);
-                if (newValue === initValue) {
+                if (Utils.equals(newValue, initValue)) {
                     Reflect.deleteProperty(input, key);
                     return;
                 }
@@ -218,6 +258,27 @@ export namespace Utils {
         });
     }
 
+    /**
+     * Number to base64 chars
+     * @param num Input number
+     * @returns Result
+     */
+    export function numberToChars(num: number) {
+        const codes = [];
+        while (num > 0) {
+            const code = num % 128;
+            codes.push(code);
+            num = (num - code) / 128;
+        }
+
+        if (typeof Buffer === 'undefined') {
+            return btoa(String.fromCharCode(...codes));
+        } else {
+            const buffer = Buffer.from(codes);
+            return buffer.toString('base64');
+        }
+    }
+
     /**
      * Test two objects are equal or not
      * @param obj1 Object 1
@@ -232,42 +293,87 @@ export namespace Utils {
         ignoreFields: string[] = [],
         strict = 1
     ) {
-        // Keys
-        const keys = new Set([
-            ...Object.keys(obj1).filter((item) => !ignoreFields.includes(item)),
-            ...Object.keys(obj2).filter((item) => !ignoreFields.includes(item))
-        ]);
+        // Unique keys
+        const keys = Utils.objectKeys(obj1, obj2, ignoreFields);
 
         for (const key of keys) {
             // Values
             const v1 = Reflect.get(obj1, key);
             const v2 = Reflect.get(obj2, key);
 
-            // Null and undefined case
-            if (v1 == null && v2 == null && strict <= 1) continue;
+            if (!Utils.equals(v1, v2, strict)) return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Get two object's unqiue properties
+     * @param obj1 Object 1
+     * @param obj2 Object 2
+     * @param ignoreFields Ignored fields
+     * @returns Unique properties
+     */
+    export function objectKeys(
+        obj1: {},
+        obj2: {},
+        ignoreFields: string[] = []
+    ) {
+        // All keys
+        const allKeys = [...Object.keys(obj1), ...Object.keys(obj2)].filter(
+            (item) => !ignoreFields.includes(item)
+        );
 
-            // 1 and '1' case
-            if (strict === 0 && v1 == v2) continue;
+        // Unique keys
+        return new Set(allKeys);
+    }
 
-            // Strict equal
-            if (v1 !== v2) return false;
+    /**
+     * Get the new object's updated fields contrast to the previous object
+     * @param objNew New object
+     * @param objPre Previous object
+     * @param ignoreFields Ignored fields
+     * @param strict Strict level, 0 with ==, 1 === but null equal undefined, 2 ===
+     * @returns Updated fields
+     */
+    export function objectUpdated(
+        objNew: {},
+        objPrev: {},
+        ignoreFields: string[] = [],
+        strict = 1
+    ) {
+        // Fields
+        const fields: string[] = [];
+
+        // Unique keys
+        const keys = Utils.objectKeys(objNew, objPrev, ignoreFields);
+
+        for (const key of keys) {
+            // Values
+            const vNew = Reflect.get(objNew, key);
+            const vPrev = Reflect.get(objPrev, key);
+
+            if (!Utils.equals(vNew, vPrev, strict)) {
+                fields.push(key);
+            }
         }
 
-        return true;
+        return fields;
     }
 
     /**
-     * Parse string (JSON) to specific type
+     * Parse string (JSON) to specific type, no type conversion
+     * For type conversion, please use DataTypes.convert
      * @param input Input string
      * @param defaultValue Default value
      * @returns Parsed value
      */
     export function parseString<T>(
         input: string | undefined | null,
-        defaultValue: T
-    ): T {
-        // Undefined case, return default value
-        if (input == null) return defaultValue;
+        defaultValue?: T
+    ): T | undefined {
+        // Undefined and empty case, return default value
+        if (input == null || input === '') return defaultValue;
 
         // String
         if (typeof defaultValue === 'string') return <any>input;
@@ -285,16 +391,10 @@ export namespace Utils {
 
             // Return
             return <T>json;
-        } catch (e) {
-            console.log('Utils.parseString error', e);
+        } catch {
+            if (defaultValue == null) return <any>input;
             return defaultValue;
         }
-        /*
-        finally part will still return the boolean value
-        finally {
-            return defaultValue
-        }
-        */
     }
 
     /**