@etsoo/shared 1.1.7 → 1.1.11

package/README.md

@@ -151,6 +151,7 @@ String and other related utilities
 
 |Name|Description|
 |---:|---|
+|addBlankItem|Add blank item to collection|
 |charsToNumber|Base64 chars to number|
 |correctTypes|Correct object's property value type|
 |equals|Two values equal|
@@ -158,6 +159,10 @@ String and other related utilities
 |formatString|Format string with parameters|
 |getDataChanges|Get data changed fields with input data updated|
 |getTimeZone|Get time zone|
+|hideData|Hide data|
+|hideEmail|Hide email data|
+|isDigits|Is digits string|
+|isEmail|Is email string|
 |joinItems|Join items as a string|
 |mergeFormData|Merge form data to primary one|
 |mergeClasses|Merge class names|
@@ -167,5 +172,6 @@ String and other related utilities
 |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|
+|removeNonLetters|Remove non letters (0-9, a-z, A-Z)|
 |setLabels|Set source with new labels|
 |snakeNameToWord|Snake name to works, 'snake_name' to 'Snake Name'|

package/__tests__/Utils.ts

@@ -1,5 +1,16 @@
 import { Utils } from '../src/Utils';
 
+test('Tests for addBlankItem', () => {
+    const options = [
+        { id: 1, name: 'a' },
+        { id: 2, name: 'b' }
+    ];
+    Utils.addBlankItem(options, 'id', 'name');
+    expect(options.length).toBe(3);
+    expect(options[0].id).toBe('');
+    expect(options[0].name).toBe('---');
+});
+
 test('Tests for correctTypes', () => {
     const input = {
         id: '1',
@@ -66,6 +77,13 @@ test('Tests for formatString', () => {
     expect(template.format('aa', 'bb')).toBe(result);
 });
 
+test('Tests for hideData', () => {
+    expect('xz@etsoo.com'.hideEmail()).toBe('x***@etsoo.com');
+    expect('info@etsoo.com'.hideEmail()).toBe('in***@etsoo.com');
+    expect('info@etsoo.com'.hideData('@')).toBe('in***@etsoo.com');
+    expect('12345678'.hideData()).toBe('123***678');
+});
+
 test('Tests for isDigits', () => {
     expect(Utils.isDigits('1')).toBeTruthy();
     expect(Utils.isDigits('12', 3)).toBeFalsy();

package/lib/cjs/DateUtils.d.ts

@@ -48,7 +48,7 @@ export declare namespace DateUtils {
      * Format to 'yyyy-MM-dd', especially used for date input min/max property
      * @param date Input date
      */
-    function formatForInput(date?: Date | string): string;
+    function formatForInput(date?: Date | string | null): string;
     /**
      * Get month's days
      * @param year Year

package/lib/cjs/Utils.d.ts

@@ -13,6 +13,17 @@ declare global {
          * @param upperCase To upper case or lower case
          */
         formatInitial(this: string, upperCase: boolean): string;
+        /**
+         * Hide data
+         * @param this Input string
+         * @param endChar End char
+         */
+        hideData(this: string, endChar?: string): string;
+        /**
+         * Hide email data
+         * @param this Input email
+         */
+        hideEmail(this: string): string;
         /**
          * Is digits string
          * @param this Input string
@@ -35,6 +46,14 @@ declare global {
  * Utilities
  */
 export declare namespace Utils {
+    /**
+     * Add blank item to collection
+     * @param options Options
+     * @param idField Id field, default is id
+     * @param labelField Label field, default is label
+     * @param blankLabel Blank label, default is ---
+     */
+    function addBlankItem<T extends {}>(options: T[], idField?: string | keyof T, labelField?: unknown, blankLabel?: string): void;
     /**
      * Base64 chars to number
      * @param base64Chars Base64 chars

package/lib/cjs/Utils.js

@@ -14,6 +14,29 @@ String.prototype.formatInitial = function (upperCase = false) {
     return ((upperCase ? initial.toUpperCase() : initial.toLowerCase()) +
         this.slice(1));
 };
+String.prototype.hideData = function (endChar) {
+    if (this.length === 0)
+        return this;
+    if (endChar != null) {
+        const index = this.indexOf(endChar);
+        if (index === -1)
+            return this.hideData();
+        return this.substring(0, index).hideData() + this.substring(index);
+    }
+    var len = this.length;
+    if (len < 4)
+        return this.substring(0, 1) + '***';
+    if (len < 6)
+        return this.substring(0, 2) + '***';
+    if (len < 8)
+        return this.substring(0, 2) + '***' + this.slice(-2);
+    if (len < 12)
+        return this.substring(0, 3) + '***' + this.slice(-3);
+    return this.substring(0, 4) + '***' + this.slice(-4);
+};
+String.prototype.hideEmail = function () {
+    return this.hideData('@');
+};
 String.prototype.isDigits = function (minLength) {
     return this.length >= (minLength !== null && minLength !== void 0 ? minLength : 0) && /^\d+$/.test(this);
 };
@@ -29,6 +52,21 @@ String.prototype.removeNonLetters = function () {
  */
 var Utils;
 (function (Utils) {
+    /**
+     * Add blank item to collection
+     * @param options Options
+     * @param idField Id field, default is id
+     * @param labelField Label field, default is label
+     * @param blankLabel Blank label, default is ---
+     */
+    function addBlankItem(options, idField, labelField, blankLabel) {
+        const blankItem = {
+            [idField !== null && idField !== void 0 ? idField : 'id']: '',
+            [typeof labelField === 'string' ? labelField : 'label']: blankLabel !== null && blankLabel !== void 0 ? blankLabel : '---'
+        };
+        options.unshift(blankItem);
+    }
+    Utils.addBlankItem = addBlankItem;
     /**
      * Base64 chars to number
      * @param base64Chars Base64 chars

package/lib/mjs/DateUtils.d.ts

@@ -48,7 +48,7 @@ export declare namespace DateUtils {
      * Format to 'yyyy-MM-dd', especially used for date input min/max property
      * @param date Input date
      */
-    function formatForInput(date?: Date | string): string;
+    function formatForInput(date?: Date | string | null): string;
     /**
      * Get month's days
      * @param year Year

package/lib/mjs/Utils.d.ts

@@ -13,6 +13,17 @@ declare global {
          * @param upperCase To upper case or lower case
          */
         formatInitial(this: string, upperCase: boolean): string;
+        /**
+         * Hide data
+         * @param this Input string
+         * @param endChar End char
+         */
+        hideData(this: string, endChar?: string): string;
+        /**
+         * Hide email data
+         * @param this Input email
+         */
+        hideEmail(this: string): string;
         /**
          * Is digits string
          * @param this Input string
@@ -35,6 +46,14 @@ declare global {
  * Utilities
  */
 export declare namespace Utils {
+    /**
+     * Add blank item to collection
+     * @param options Options
+     * @param idField Id field, default is id
+     * @param labelField Label field, default is label
+     * @param blankLabel Blank label, default is ---
+     */
+    function addBlankItem<T extends {}>(options: T[], idField?: string | keyof T, labelField?: unknown, blankLabel?: string): void;
     /**
      * Base64 chars to number
      * @param base64Chars Base64 chars

package/lib/mjs/Utils.js

@@ -11,6 +11,29 @@ String.prototype.formatInitial = function (upperCase = false) {
     return ((upperCase ? initial.toUpperCase() : initial.toLowerCase()) +
         this.slice(1));
 };
+String.prototype.hideData = function (endChar) {
+    if (this.length === 0)
+        return this;
+    if (endChar != null) {
+        const index = this.indexOf(endChar);
+        if (index === -1)
+            return this.hideData();
+        return this.substring(0, index).hideData() + this.substring(index);
+    }
+    var len = this.length;
+    if (len < 4)
+        return this.substring(0, 1) + '***';
+    if (len < 6)
+        return this.substring(0, 2) + '***';
+    if (len < 8)
+        return this.substring(0, 2) + '***' + this.slice(-2);
+    if (len < 12)
+        return this.substring(0, 3) + '***' + this.slice(-3);
+    return this.substring(0, 4) + '***' + this.slice(-4);
+};
+String.prototype.hideEmail = function () {
+    return this.hideData('@');
+};
 String.prototype.isDigits = function (minLength) {
     return this.length >= (minLength !== null && minLength !== void 0 ? minLength : 0) && /^\d+$/.test(this);
 };
@@ -26,6 +49,21 @@ String.prototype.removeNonLetters = function () {
  */
 export var Utils;
 (function (Utils) {
+    /**
+     * Add blank item to collection
+     * @param options Options
+     * @param idField Id field, default is id
+     * @param labelField Label field, default is label
+     * @param blankLabel Blank label, default is ---
+     */
+    function addBlankItem(options, idField, labelField, blankLabel) {
+        const blankItem = {
+            [idField !== null && idField !== void 0 ? idField : 'id']: '',
+            [typeof labelField === 'string' ? labelField : 'label']: blankLabel !== null && blankLabel !== void 0 ? blankLabel : '---'
+        };
+        options.unshift(blankItem);
+    }
+    Utils.addBlankItem = addBlankItem;
     /**
      * Base64 chars to number
      * @param base64Chars Base64 chars

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@etsoo/shared",
-    "version": "1.1.7",
+    "version": "1.1.11",
     "description": "TypeScript shared utilities and functions",
     "main": "lib/cjs/index.js",
     "module": "lib/mjs/index.js",
@@ -57,7 +57,7 @@
         "@types/jest": "^27.4.0",
         "@typescript-eslint/eslint-plugin": "^5.10.1",
         "@typescript-eslint/parser": "^5.10.1",
-        "eslint": "^8.7.0",
+        "eslint": "^8.8.0",
         "eslint-config-airbnb-base": "^15.0.0",
         "eslint-plugin-import": "^2.25.4",
         "jest": "^27.4.7",

package/src/DateUtils.ts

@@ -148,7 +148,7 @@ export namespace DateUtils {
      * Format to 'yyyy-MM-dd', especially used for date input min/max property
      * @param date Input date
      */
-    export function formatForInput(date?: Date | string) {
+    export function formatForInput(date?: Date | string | null) {
         // Parse string as date
         if (typeof date === 'string') date = new Date(date);
 

package/src/Utils.ts

@@ -16,6 +16,19 @@ declare global {
          */
         formatInitial(this: string, upperCase: boolean): string;
 
+        /**
+         * Hide data
+         * @param this Input string
+         * @param endChar End char
+         */
+        hideData(this: string, endChar?: string): string;
+
+        /**
+         * Hide email data
+         * @param this Input email
+         */
+        hideEmail(this: string): string;
+
         /**
          * Is digits string
          * @param this Input string
@@ -59,6 +72,28 @@ String.prototype.formatInitial = function (
     );
 };
 
+String.prototype.hideData = function (this: string, endChar?: string) {
+    if (this.length === 0) return this;
+
+    if (endChar != null) {
+        const index = this.indexOf(endChar);
+        if (index === -1) return this.hideData();
+        return this.substring(0, index).hideData() + this.substring(index);
+    }
+
+    var len = this.length;
+    if (len < 4) return this.substring(0, 1) + '***';
+    if (len < 6) return this.substring(0, 2) + '***';
+    if (len < 8) return this.substring(0, 2) + '***' + this.slice(-2);
+    if (len < 12) return this.substring(0, 3) + '***' + this.slice(-3);
+
+    return this.substring(0, 4) + '***' + this.slice(-4);
+};
+
+String.prototype.hideEmail = function (this: string) {
+    return this.hideData('@');
+};
+
 String.prototype.isDigits = function (this: string, minLength?: number) {
     return this.length >= (minLength ?? 0) && /^\d+$/.test(this);
 };
@@ -77,6 +112,27 @@ String.prototype.removeNonLetters = function (this: string) {
  * Utilities
  */
 export namespace Utils {
+    /**
+     * Add blank item to collection
+     * @param options Options
+     * @param idField Id field, default is id
+     * @param labelField Label field, default is label
+     * @param blankLabel Blank label, default is ---
+     */
+    export function addBlankItem<T extends {}>(
+        options: T[],
+        idField?: string | keyof T,
+        labelField?: unknown,
+        blankLabel?: string
+    ) {
+        const blankItem: any = {
+            [idField ?? 'id']: '',
+            [typeof labelField === 'string' ? labelField : 'label']:
+                blankLabel ?? '---'
+        };
+        options.unshift(blankItem);
+    }
+
     /**
      * Base64 chars to number
      * @param base64Chars Base64 chars