@etsoo/appscript 1.2.73 → 1.2.76

package/lib/mjs/business/BusinessUtils.d.ts

@@ -1,12 +1,19 @@
 import { DataTypes } from '@etsoo/shared';
 import { IdLabelDto } from '../dto/IdLabelDto';
 import { ICultureGet } from '../state/Culture';
-import { EntityStatus } from './EntityStatus';
 import { ProductUnit } from './ProductUnit';
 /**
  * Business utils
  */
 export declare namespace BusinessUtils {
+    /**
+     * Format avatar title
+     * @param title Title
+     * @param maxChars Max characters
+     * @param defaultTitle Default title
+     * @returns Result
+     */
+    function formatAvatarTitle(title?: string, maxChars?: number, defaultTitle?: string): string;
     /**
      * Get currency collection
      * @param currencyNames Names like CNY, USD
@@ -14,31 +21,13 @@ export declare namespace BusinessUtils {
      * @returns Collection
      */
     function getCurrencies(currencyNames: string[], func: ICultureGet): IdLabelDto<string>[];
-    /**
-     * Get entity status's label
-     * Please define the label with key 'statusNormal' for Normal status
-     * @param unit Unit
-     * @param func Label delegate
-     * @returns Label
-     */
-    function getEntityStatusLabel(status: EntityStatus, func: ICultureGet): string;
-    /**
-     * Get entity status collection
-     * @param unit Unit
-     * @param func Label delegate
-     * @returns Label
-     */
-    function getEntityStatus(func: ICultureGet): {
-        id: EntityStatus;
-        label: string;
-    }[];
     /**
      * Get 12-month items
      * @param monthLabels Month labels
      * @param startMonth Start month, 0 as Jan.
      * @returns 12 months
      */
-    function getMonths(monthLabels: string[], startMonth?: number): DataTypes.IdLabelItem[];
+    function getMonths(monthLabels: string[], startMonth?: number): DataTypes.IdLabelItem<number>[];
     /**
      * Get product unit's label
      * Please define the label in culture with key 'unitPC' for ProductUnit.PC like that

package/lib/mjs/business/BusinessUtils.js

@@ -1,12 +1,43 @@
 import { DataTypes } from '@etsoo/shared';
-import { RepeatOption } from '..';
-import { EntityStatus } from './EntityStatus';
 import { ProductUnit } from './ProductUnit';
+import { RepeatOption } from './RepeatOption';
 /**
  * Business utils
  */
 export var BusinessUtils;
 (function (BusinessUtils) {
+    /**
+     * Format avatar title
+     * @param title Title
+     * @param maxChars Max characters
+     * @param defaultTitle Default title
+     * @returns Result
+     */
+    function formatAvatarTitle(title, maxChars = 3, defaultTitle = 'ME') {
+        // Just return for empty cases
+        if (title == null || title === '')
+            return defaultTitle;
+        // split with words
+        const items = title.trim().split(/\s+/g);
+        if (items.length === 1) {
+            // 2-3 Chinese names
+            const titleLen = title.length;
+            if (titleLen <= maxChars)
+                return title.toUpperCase();
+            // Return default for simplicity
+            return defaultTitle;
+        }
+        // First letter of each item
+        var firstLetters = items
+            .map((item) => item[0])
+            .join('')
+            .toUpperCase();
+        const flen = firstLetters.length;
+        if (flen <= maxChars)
+            return firstLetters;
+        return defaultTitle;
+    }
+    BusinessUtils.formatAvatarTitle = formatAvatarTitle;
     /**
      * Get currency collection
      * @param currencyNames Names like CNY, USD
@@ -23,35 +54,6 @@ export var BusinessUtils;
         });
     }
     BusinessUtils.getCurrencies = getCurrencies;
-    /**
-     * Get entity status's label
-     * Please define the label with key 'statusNormal' for Normal status
-     * @param unit Unit
-     * @param func Label delegate
-     * @returns Label
-     */
-    function getEntityStatusLabel(status, func) {
-        var _a;
-        const key = EntityStatus[status];
-        return (_a = func('status' + key)) !== null && _a !== void 0 ? _a : key;
-    }
-    BusinessUtils.getEntityStatusLabel = getEntityStatusLabel;
-    /**
-     * Get entity status collection
-     * @param unit Unit
-     * @param func Label delegate
-     * @returns Label
-     */
-    function getEntityStatus(func) {
-        return DataTypes.getEnumKeys(EntityStatus).map((key) => {
-            const id = DataTypes.getEnumByKey(EntityStatus, key);
-            return {
-                id,
-                label: getEntityStatusLabel(id, func)
-            };
-        });
-    }
-    BusinessUtils.getEntityStatus = getEntityStatus;
     /**
      * Get 12-month items
      * @param monthLabels Month labels

package/lib/mjs/dto/IdLabelDto.d.ts

@@ -1,9 +1,8 @@
 import { DataTypes } from '@etsoo/shared';
-import { IdDto } from './IdDto';
 /**
  * Dto with id and label field
  */
-export declare type IdLabelDto<T extends DataTypes.IdType = number> = IdDto<T> & {
+export declare type IdLabelDto<T extends DataTypes.IdType = number> = DataTypes.IdItem<T> & {
     /**
      * Label
      */
@@ -12,4 +11,4 @@ export declare type IdLabelDto<T extends DataTypes.IdType = number> = IdDto<T> &
 /**
  * Conditional IdLabel type
  */
-export declare type IdLabelConditional<T extends boolean> = T extends true ? IdLabelDto[] : IdLabelDto<string>[];
+export declare type IdLabelConditional<T extends boolean> = T extends true ? IdLabelDto<number>[] : IdLabelDto<string>[];

package/lib/mjs/i18n/en-US.json

@@ -43,6 +43,7 @@
     "enabled": "Enabled",
     "entityStatus": "Status",
     "environmentChanged": "The operating environment has changed, please log in again",
+    "error": "Error",
     "etsoo": "ETSOO",
     "expiry": "Expiry",
     "failed": "Operation failed",
@@ -52,6 +53,7 @@
     "itemExists": "'{0}' already exists",
     "loading": "Loading...",
     "login": "Login",
+    "me": "ME",
     "menuHome": "Home",
     "message": "Message",
     "mobile": "Mobile number",
@@ -139,6 +141,7 @@
     "taxUSEIN": "Employer identification number",
     "timeDifferenceInvalid": "The time difference between the device and the server is {0}, which exceeds the limit of {1} seconds. Please adjust the device time. If it is abnormal, please inform the administrator",
     "tokenExpiry": "Your session is about to expire. Click the Cancel button to continue",
+    "type": "Type",
     "yes": "Yes",
     "unknownError": "Unknown Error",
     "unitJoin": "per {0}",

package/lib/mjs/i18n/zh-CN.json

@@ -43,6 +43,7 @@
     "enabled": "已启用",
     "entityStatus": "状态",
     "environmentChanged": "运行环境已改变，请重新登录",
+    "error": "错误",
     "etsoo": "亿速思维",
     "expiry": "到期时间",
     "failed": "操作失败",
@@ -52,6 +53,7 @@
     "itemExists": "'{0}'已经存在",
     "loading": "正在加载...",
     "login": "登录",
+    "me": "我",
     "menuHome": "首页",
     "message": "留言",
     "mobile": "手机号码",
@@ -139,6 +141,7 @@
     "taxUSEIN": "雇主识别号码(EIN)",
     "timeDifferenceInvalid": "设备时间和服务器时间差为{0}，超过{1}秒的限制，请调整设备时间，如果异常请告知管理员",
     "tokenExpiry": "您的会话即将过期。点击 取消 按钮继续使用",
+    "type": "类型",
     "yes": "是",
     "unknownError": "未知错误",
     "unitJoin": "每{0}",

package/lib/mjs/i18n/zh-HK.json

@@ -43,6 +43,7 @@
     "enabled": "已啟用",
     "entityStatus": "狀態",
     "environmentChanged": "運行環境已改變，請重新登錄",
+    "error": "錯誤",
     "etsoo": "億速思維",
     "expiry": "到期時間",
     "failed": "操作失敗",
@@ -52,6 +53,7 @@
     "itemExists": "'{0}'已经存在",
     "loading": "正在加載...",
     "login": "登錄",
+    "me": "我",
     "menuHome": "首頁",
     "message": "留言",
     "mobilePhone": "手機號碼",
@@ -139,6 +141,7 @@
     "taxUSEIN": "雇主識別號碼(EIN)",
     "timeDifferenceInvalid": "設備時間和服務器時間差為{0}，超過{1}秒的限制，請調整設備時間，如果異常請告知管理員",
     "tokenExpiry": "您的會話即將過期。點擊 取消 按鈕繼續使用",
+    "type": "類型",
     "yes": "是",
     "unknownError": "未知錯誤",
     "unitJoin": "每{0}",

package/lib/mjs/index.d.ts

@@ -13,7 +13,6 @@ export * from './business/EntityStatus';
 export * from './business/ProductUnit';
 export * from './business/RepeatOption';
 export * from './def/ListItem';
-export * from './dto/IdDto';
 export * from './dto/IdLabelDto';
 export * from './dto/IdLabelPrimaryDto';
 export * from './dto/InitCallDto';

package/lib/mjs/index.js

@@ -19,7 +19,6 @@ export * from './business/RepeatOption';
 // def
 export * from './def/ListItem';
 // dto
-export * from './dto/IdDto';
 export * from './dto/IdLabelDto';
 export * from './dto/IdLabelPrimaryDto';
 export * from './dto/InitCallDto';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@etsoo/appscript",
-    "version": "1.2.73",
+    "version": "1.2.76",
     "description": "Applications shared TypeScript framework",
     "main": "lib/cjs/index.js",
     "module": "lib/mjs/index.js",
@@ -54,7 +54,7 @@
     "dependencies": {
         "@etsoo/notificationbase": "^1.1.5",
         "@etsoo/restclient": "^1.0.70",
-        "@etsoo/shared": "^1.1.41",
+        "@etsoo/shared": "^1.1.45",
         "@types/crypto-js": "^4.1.1",
         "crypto-js": "^4.1.1"
     },
@@ -64,15 +64,15 @@
         "@babel/plugin-transform-runtime": "^7.18.10",
         "@babel/preset-env": "^7.18.10",
         "@babel/runtime-corejs3": "^7.18.9",
-        "@types/jest": "^28.1.6",
-        "@typescript-eslint/eslint-plugin": "^5.32.0",
-        "@typescript-eslint/parser": "^5.32.0",
-        "eslint": "^8.21.0",
+        "@types/jest": "^28.1.7",
+        "@typescript-eslint/eslint-plugin": "^5.33.1",
+        "@typescript-eslint/parser": "^5.33.1",
+        "eslint": "^8.22.0",
         "eslint-config-airbnb-base": "^15.0.0",
         "eslint-plugin-import": "^2.26.0",
         "jest": "^28.1.3",
         "jest-environment-jsdom": "^28.1.3",
-        "ts-jest": "^28.0.7",
+        "ts-jest": "^28.0.8",
         "typescript": "^4.7.4"
     }
 }

package/src/app/CoreApp.ts

@@ -31,13 +31,14 @@ import { AddressRegion } from '../address/AddressRegion';
 import { AddressUtils } from '../address/AddressUtils';
 import { BridgeUtils } from '../bridges/BridgeUtils';
 import { BusinessUtils } from '../business/BusinessUtils';
+import { EntityStatus } from '../business/EntityStatus';
 import { ProductUnit } from '../business/ProductUnit';
 import { IdLabelDto } from '../dto/IdLabelDto';
 import { InitCallDto } from '../dto/InitCallDto';
 import { ActionResultError } from '../result/ActionResultError';
 import { IActionResult } from '../result/IActionResult';
 import { InitCallResult, InitCallResultData } from '../result/InitCallResult';
-import { IUser, IUserData } from '../state/User';
+import { IUser } from '../state/User';
 import { IAppSettings } from './AppSettings';
 import { UserRole } from './UserRole';
 
@@ -374,18 +375,30 @@ export interface ICoreApp<
      */
     getCacheToken(): string | undefined;
 
-    /**
-     * Get entity status label
-     * @param data Input data
-     */
-    getEntityStatusLabel<D extends { entityStatus?: number }>(data?: D): string;
-
     /**
      * Get all regions
      * @returns Regions
      */
     getRegions(): AddressRegion[];
 
+    /**
+     * Get roles
+     * @param role Combination role value
+     */
+    getRoles(role: number): IdLabelDto[];
+
+    /**
+     * Get status label
+     * @param status Status value
+     */
+    getStatusLabel(status: number | null | undefined): string;
+
+    /**
+     * Get status list
+     * @returns list
+     */
+    getStatusList(): IdLabelDto[];
+
     /**
      * Get refresh token from response headers
      * @param rawResponse Raw response from API call
@@ -1592,6 +1605,67 @@ export abstract class CoreApp<
         return this.storage.getData<string>(this.fields.headerToken);
     }
 
+    /**
+     * Get enum item number id list
+     * @param em Enum
+     * @param prefix Label prefix
+     * @param filter Filter
+     * @returns List
+     */
+    protected getEnumList<E extends DataTypes.EnumBase = DataTypes.EnumBase>(
+        em: E,
+        prefix: string,
+        filter?: (
+            id: E[keyof E],
+            key: keyof E & string
+        ) => E[keyof E] | undefined
+    ): IdLabelDto[] {
+        const list: IdLabelDto<number>[] = [];
+        const keys = DataTypes.getEnumKeys(em);
+        for (const key of keys) {
+            let id = em[key as keyof E];
+            if (filter) {
+                const fid = filter(id, key);
+                if (fid == null) continue;
+                id = fid;
+            }
+            if (typeof id !== 'number') continue;
+            var label = this.get<string>(prefix + key) ?? key;
+            list.push({ id, label });
+        }
+        return list;
+    }
+
+    /**
+     * Get enum item string id list
+     * @param em Enum
+     * @param prefix Label prefix
+     * @param filter Filter
+     * @returns List
+     */
+    protected getEnumStrList<E extends DataTypes.EnumBase = DataTypes.EnumBase>(
+        em: E,
+        prefix: string,
+        filter?: (
+            id: E[keyof E],
+            key: keyof E & string
+        ) => E[keyof E] | undefined
+    ): IdLabelDto<string>[] {
+        const list: IdLabelDto<string>[] = [];
+        const keys = DataTypes.getEnumKeys(em);
+        for (const key of keys) {
+            let id = em[key as keyof E];
+            if (filter) {
+                const fid = filter(id, key);
+                if (fid == null) continue;
+                id = fid;
+            }
+            var label = this.get<string>(prefix + key) ?? key;
+            list.push({ id: id.toString(), label });
+        }
+        return list;
+    }
+
     /**
      * Get all regions
      * @returns Regions
@@ -1603,15 +1677,31 @@ export abstract class CoreApp<
     }
 
     /**
-     * Get entity status label
-     * @param data Input data
+     * Get roles
+     * @param role Combination role value
      */
-    getEntityStatusLabel<D extends { entityStatus?: number }>(data?: D) {
-        if (data == null || data.entityStatus == null) return '';
-        return BusinessUtils.getEntityStatusLabel(
-            data.entityStatus,
-            this.labelDelegate
-        );
+    getRoles(role: number) {
+        return this.getEnumList(UserRole, 'role', (id, _key) => {
+            if ((id & role) > 0) return id;
+        });
+    }
+
+    /**
+     * Get status list
+     * @returns list
+     */
+    getStatusList() {
+        return this.getEnumList(EntityStatus, 'status');
+    }
+
+    /**
+     * Get status label
+     * @param status Status value
+     */
+    getStatusLabel(status: number | null | undefined) {
+        if (status == null) return '';
+        const key = EntityStatus[status];
+        return this.get<string>('status' + key) ?? key;
     }
 
     /**

package/src/business/BusinessUtils.ts

@@ -1,14 +1,52 @@
 import { DataTypes } from '@etsoo/shared';
-import { RepeatOption } from '..';
 import { IdLabelDto } from '../dto/IdLabelDto';
 import { ICultureGet } from '../state/Culture';
-import { EntityStatus } from './EntityStatus';
 import { ProductUnit } from './ProductUnit';
+import { RepeatOption } from './RepeatOption';
 
 /**
  * Business utils
  */
 export namespace BusinessUtils {
+    /**
+     * Format avatar title
+     * @param title Title
+     * @param maxChars Max characters
+     * @param defaultTitle Default title
+     * @returns Result
+     */
+    export function formatAvatarTitle(
+        title?: string,
+        maxChars: number = 3,
+        defaultTitle: string = 'ME'
+    ): string {
+        // Just return for empty cases
+        if (title == null || title === '') return defaultTitle;
+
+        // split with words
+        const items = title.trim().split(/\s+/g);
+
+        if (items.length === 1) {
+            // 2-3 Chinese names
+            const titleLen = title.length;
+            if (titleLen <= maxChars) return title.toUpperCase();
+
+            // Return default for simplicity
+            return defaultTitle;
+        }
+
+        // First letter of each item
+        var firstLetters = items
+            .map((item) => item[0])
+            .join('')
+            .toUpperCase();
+
+        const flen = firstLetters.length;
+        if (flen <= maxChars) return firstLetters;
+
+        return defaultTitle;
+    }
+
     /**
      * Get currency collection
      * @param currencyNames Names like CNY, USD
@@ -25,37 +63,6 @@ export namespace BusinessUtils {
         }));
     }
 
-    /**
-     * Get entity status's label
-     * Please define the label with key 'statusNormal' for Normal status
-     * @param unit Unit
-     * @param func Label delegate
-     * @returns Label
-     */
-    export function getEntityStatusLabel(
-        status: EntityStatus,
-        func: ICultureGet
-    ) {
-        const key = EntityStatus[status];
-        return func('status' + key) ?? key;
-    }
-
-    /**
-     * Get entity status collection
-     * @param unit Unit
-     * @param func Label delegate
-     * @returns Label
-     */
-    export function getEntityStatus(func: ICultureGet) {
-        return DataTypes.getEnumKeys(EntityStatus).map((key) => {
-            const id = DataTypes.getEnumByKey(EntityStatus, key)!;
-            return {
-                id,
-                label: getEntityStatusLabel(id, func)
-            };
-        });
-    }
-
     /**
      * Get 12-month items
      * @param monthLabels Month labels

package/src/dto/IdLabelDto.ts

@@ -1,19 +1,19 @@
 import { DataTypes } from '@etsoo/shared';
-import { IdDto } from './IdDto';
 
 /**
  * Dto with id and label field
  */
-export type IdLabelDto<T extends DataTypes.IdType = number> = IdDto<T> & {
-    /**
-     * Label
-     */
-    label: string;
-};
+export type IdLabelDto<T extends DataTypes.IdType = number> =
+    DataTypes.IdItem<T> & {
+        /**
+         * Label
+         */
+        label: string;
+    };
 
 /**
  * Conditional IdLabel type
  */
 export type IdLabelConditional<T extends boolean> = T extends true
-    ? IdLabelDto[]
+    ? IdLabelDto<number>[]
     : IdLabelDto<string>[];

package/src/i18n/en-US.json

@@ -43,6 +43,7 @@
     "enabled": "Enabled",
     "entityStatus": "Status",
     "environmentChanged": "The operating environment has changed, please log in again",
+    "error": "Error",
     "etsoo": "ETSOO",
     "expiry": "Expiry",
     "failed": "Operation failed",
@@ -52,6 +53,7 @@
     "itemExists": "'{0}' already exists",
     "loading": "Loading...",
     "login": "Login",
+    "me": "ME",
     "menuHome": "Home",
     "message": "Message",
     "mobile": "Mobile number",
@@ -139,6 +141,7 @@
     "taxUSEIN": "Employer identification number",
     "timeDifferenceInvalid": "The time difference between the device and the server is {0}, which exceeds the limit of {1} seconds. Please adjust the device time. If it is abnormal, please inform the administrator",
     "tokenExpiry": "Your session is about to expire. Click the Cancel button to continue",
+    "type": "Type",
     "yes": "Yes",
     "unknownError": "Unknown Error",
     "unitJoin": "per {0}",

package/src/i18n/zh-CN.json

@@ -43,6 +43,7 @@
     "enabled": "已启用",
     "entityStatus": "状态",
     "environmentChanged": "运行环境已改变，请重新登录",
+    "error": "错误",
     "etsoo": "亿速思维",
     "expiry": "到期时间",
     "failed": "操作失败",
@@ -52,6 +53,7 @@
     "itemExists": "'{0}'已经存在",
     "loading": "正在加载...",
     "login": "登录",
+    "me": "我",
     "menuHome": "首页",
     "message": "留言",
     "mobile": "手机号码",
@@ -139,6 +141,7 @@
     "taxUSEIN": "雇主识别号码(EIN)",
     "timeDifferenceInvalid": "设备时间和服务器时间差为{0}，超过{1}秒的限制，请调整设备时间，如果异常请告知管理员",
     "tokenExpiry": "您的会话即将过期。点击 取消 按钮继续使用",
+    "type": "类型",
     "yes": "是",
     "unknownError": "未知错误",
     "unitJoin": "每{0}",

package/src/i18n/zh-HK.json

@@ -43,6 +43,7 @@
     "enabled": "已啟用",
     "entityStatus": "狀態",
     "environmentChanged": "運行環境已改變，請重新登錄",
+    "error": "錯誤",
     "etsoo": "億速思維",
     "expiry": "到期時間",
     "failed": "操作失敗",
@@ -52,6 +53,7 @@
     "itemExists": "'{0}'已经存在",
     "loading": "正在加載...",
     "login": "登錄",
+    "me": "我",
     "menuHome": "首頁",
     "message": "留言",
     "mobilePhone": "手機號碼",
@@ -139,6 +141,7 @@
     "taxUSEIN": "雇主識別號碼(EIN)",
     "timeDifferenceInvalid": "設備時間和服務器時間差為{0}，超過{1}秒的限制，請調整設備時間，如果異常請告知管理員",
     "tokenExpiry": "您的會話即將過期。點擊 取消 按鈕繼續使用",
+    "type": "類型",
     "yes": "是",
     "unknownError": "未知錯誤",
     "unitJoin": "每{0}",

package/src/index.ts

@@ -24,7 +24,6 @@ export * from './business/RepeatOption';
 export * from './def/ListItem';
 
 // dto
-export * from './dto/IdDto';
 export * from './dto/IdLabelDto';
 export * from './dto/IdLabelPrimaryDto';
 export * from './dto/InitCallDto';

package/lib/cjs/dto/IdDto.d.ts

@@ -1,10 +0,0 @@
-import { DataTypes } from '@etsoo/shared';
-/**
- * Dto with id field
- */
-export declare type IdDto<T extends DataTypes.IdType = number> = {
-    /**
-     * Id
-     */
-    readonly id: T;
-};

package/lib/cjs/dto/IdDto.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/mjs/dto/IdDto.d.ts

@@ -1,10 +0,0 @@
-import { DataTypes } from '@etsoo/shared';
-/**
- * Dto with id field
- */
-export declare type IdDto<T extends DataTypes.IdType = number> = {
-    /**
-     * Id
-     */
-    readonly id: T;
-};

package/lib/mjs/dto/IdDto.js

@@ -1 +0,0 @@
-export {};