@jhqn/utils-core 0.0.1-beta.24 → 0.0.1-beta.26

package/dist/index.cjs

@@ -72,7 +72,11 @@ const jClear = console.clear.bind(console);
 const cnPhoneRE = /^1[3-9]\d{9}$/;
 const cnTelRE = /^0\d{9,11}$/;
 const isDef = (val) => val !== void 0 && val !== null;
-const isNumeric = (val) => typeof val === "number" || /^\d+(?:\.\d+)?$/.test(val);
+const isNumeric = (val) => {
+  if (isDef(val))
+    return typeof val === "number" || /^\d+(?:\.\d+)?$/.test(val);
+  return false;
+};
 const checkImg = (ext) => {
   return /\.(?:jpg|jpeg|png|gif)$/.test((ext || "").toLowerCase());
 };
@@ -80,19 +84,23 @@ const isEmpty = (val) => {
   return !isDef(val) || val === "" || Array.isArray(val) && val.length === 0 || Object.prototype.toString.call(val) === "[object Object]" && Object.keys(val).length === 0 || val instanceof Map && val.size === 0 || val instanceof Set && val.size === 0;
 };
 const isJSONStr = (str) => {
-  try {
-    JSON.parse(str);
-    return true;
-  } catch (e) {
-    return false;
-  }
+  if (isDef(str))
+    try {
+      JSON.parse(str);
+      return true;
+    } catch (e) {
+      return false;
+    }
+  return false;
 };
 const isArrStr = (str) => {
-  try {
-    return Array.isArray(JSON.parse(str));
-  } catch (e) {
-    return false;
-  }
+  if (isDef(str))
+    try {
+      return Array.isArray(JSON.parse(str));
+    } catch (e) {
+      return false;
+    }
+  return false;
 };
 const isValidKey = (key, object) => key in object;
 const isPhone = (val) => {
@@ -111,12 +119,12 @@ const isEmail = (val) => {
   const reg = /^[a-zA-Z\d](?:\w|-)+@[a-zA-Z\d]+\.[a-zA-Z]{2,5}$/;
   return reg.test(val);
 };
-const isIdCard = (val) => {
+const isIdCard = (val, compatible = true) => {
   if (!isDef(val))
     return false;
   const card15 = /^[1-9]\d{7}(?:0[1-9]|10|11|12)(?:[0-2][1-9]|10|20|30|31)\d{2}[\dXx]$/;
   const card18 = /^[1-9]\d{5}(?:18|19|20)\d{2}(?:0[1-9]|1[0-2])(?:[0-2][1-9]|10|20|30|31)\d{3}[\dXx]$/;
-  return card15.test(val) || card18.test(val);
+  return card18.test(val) || (compatible ? card15.test(val) : false);
 };
 const nonASCII = (text) => /[^\x20-\x7E]/.test(text);
 const isValidResCode = (res, code = 200) => res.code === code;
@@ -168,21 +176,23 @@ const hideThird = (str) => {
     return "**";
   return str.slice(0, partLen) + "*".repeat(len - 2 * partLen) + str.slice(len - partLen);
 };
-const hideHead = (str) => {
+const hideHead = (str, count) => {
   if (!isDef(str))
     return "";
   const len = str.length;
+  const cnt = count !== void 0 ? Math.max(Math.min(len, count), 0) : len - 1;
   if (len === 1)
     return "*";
-  return "*".repeat(len - 1) + str[len - 1];
+  return "*".repeat(cnt) + str.substring(cnt);
 };
-const hideTail = (str) => {
+const hideTail = (str, count) => {
   if (!isDef(str))
     return "";
   const len = str.length;
+  const cnt = count !== void 0 ? Math.max(Math.min(len, count), 0) : len - 1;
   if (len === 1)
     return "*";
-  return str[0] + "*".repeat(len - 1);
+  return str.substring(0, len - cnt) + "*".repeat(cnt);
 };
 const hidePhone = (phone) => {
   if (phone) {
@@ -196,9 +206,12 @@ const hidePhone = (phone) => {
   }
   return "";
 };
-const hideCardNo = (cardNo) => {
+const hideCardNo = (cardNo, strong = true) => {
   if (cardNo) {
-    return cardNo.replace(/^(.{4})\d+(.{2})$/, "$1*******$2");
+    if (isIdCard(cardNo, false)) {
+      return strong ? hideMiddle(cardNo) : cardNo.replace(/^(.)\d{3}(.{8})\d{5}(.)$/, "$1***$2*****$3");
+    }
+    return cardNo;
   }
   return "";
 };
@@ -217,7 +230,7 @@ const hideName = (name) => {
   return "";
 };
 const hideSurname = (name) => {
-  return hideHead(name);
+  return hideHead(name, 1);
 };
 const hideFirstName = (name) => {
   return hideTail(name);
@@ -225,14 +238,29 @@ const hideFirstName = (name) => {
 const hideEmail = (email) => {
   if (email) {
     if (!email.includes("@"))
-      return "";
+      return email;
     const arr = email.split("@");
     const name = arr[0];
     const domain = arr[1];
-    const len = name?.length;
-    if (!len)
+    if (!name || !domain)
       return email;
-    return `${hideTail(name)}@${domain}`;
+    const len = name.length;
+    let newName;
+    if (len <= 3) {
+      newName = `${name}***`;
+    } else {
+      newName = hideTail(name, 3);
+    }
+    return `${newName}@${domain}`;
+  }
+  return "";
+};
+const hideBankCard = (bankCard) => {
+  if (bankCard) {
+    const len = bankCard.length;
+    if (len <= 10)
+      return bankCard;
+    return bankCard.substring(0, 6) + "*".repeat(len - 10) + bankCard.substring(len - 4, len);
   }
   return "";
 };
@@ -366,8 +394,11 @@ const toThousands = (num) => {
 const currencyFmt = (currency, fraction = 0) => {
   if (!isDef(currency))
     return "";
+  const num = Number(currency);
+  if (Number.isNaN(num))
+    return "";
   return new Intl.NumberFormat("zh-CN", { style: "currency", currency: "CNY", maximumFractionDigits: fraction }).format(
-    currency
+    num
   );
 };
 
@@ -432,6 +463,7 @@ exports.filterObj = filterObj;
 exports.fixiOSInputAutoZoomIn = fixiOSInputAutoZoomIn;
 exports.getBaseAttachUrl = getBaseAttachUrl;
 exports.getHostEnv = getHostEnv;
+exports.hideBankCard = hideBankCard;
 exports.hideCardNo = hideCardNo;
 exports.hideEmail = hideEmail;
 exports.hideFirstName = hideFirstName;

package/dist/index.d.cts

@@ -221,6 +221,10 @@ declare type Undefinable<T> = T | undefined;
  * 可 Null 或 Undefined
  */
 declare type NullOrUndefinable<T> = Nullable<Undefinable<T>>;
+/**
+ * alias for NullOrUndefinable
+ */
+declare type UnDef<T> = NullOrUndefinable<T>;
 /**
  * 请求结果
  */
@@ -242,53 +246,61 @@ declare type MaybeArray<T = any> = T | Array<T>;
  * 隐藏中间部分
  * @param {string} str 需要隐藏的字符串
  */
-declare const hideMiddle: (str: NullOrUndefinable<string>) => string;
+declare const hideMiddle: (str: UnDef<string>) => string;
 /**
  * 隐藏首尾仅保留中间3分之1
  * @param {string} str 需要隐藏的字符串
  */
-declare const hideThird: (str: NullOrUndefinable<string>) => string;
+declare const hideThird: (str: UnDef<string>) => string;
 /**
  * 隐藏首部
  * @param {string} str 需要隐藏的字符串
+ * @param {number} count 隐藏的字符数
  */
-declare const hideHead: (str: NullOrUndefinable<string>) => string;
+declare const hideHead: (str: UnDef<string>, count?: number) => string;
 /**
  * 隐藏尾部
  * @param {string} str 需要隐藏的字符串
+ * @param {number} count 隐藏的字符数
  */
-declare const hideTail: (str: NullOrUndefinable<string>) => string;
+declare const hideTail: (str: UnDef<string>, count?: number) => string;
 /**
  * 隐藏手机号
  * @param {string} phone 手机号
  */
-declare const hidePhone: (phone: NullOrUndefinable<string>) => string;
+declare const hidePhone: (phone: UnDef<string>) => string;
 /**
  * 隐藏身份证号
  * @param {string} cardNo 身份证号
+ * @param {boolean} strong 是否强化隐藏
  */
-declare const hideCardNo: (cardNo: NullOrUndefinable<string>) => string;
+declare const hideCardNo: (cardNo: UnDef<string>, strong?: boolean) => string;
 /**
  * 隐藏姓名第一个字
  * @param {string} name 姓名
  * @deprecated 请使用 hideSurname
  */
-declare const hideName: (name: NullOrUndefinable<string>) => string;
+declare const hideName: (name: UnDef<string>) => string;
 /**
  * 隐藏姓氏
  * @param {string} name 姓名
  */
-declare const hideSurname: (name: NullOrUndefinable<string>) => string;
+declare const hideSurname: (name: UnDef<string>) => string;
 /**
  * 隐藏名字
  * @param {string} name 姓名
  */
-declare const hideFirstName: (name: NullOrUndefinable<string>) => string;
+declare const hideFirstName: (name: UnDef<string>) => string;
 /**
  * 隐藏邮箱
  * @param {string} email 邮箱
  */
-declare const hideEmail: (email: NullOrUndefinable<string>) => string;
+declare const hideEmail: (email: UnDef<string>) => string;
+/**
+ * 隐藏银行卡号
+ * @param {string} bankCard 银行卡号
+ */
+declare const hideBankCard: (bankCard: UnDef<string>) => string;
 
 /**
  * 判断是否是浏览器环境
@@ -549,7 +561,7 @@ declare const toThousands: (num: number) => string | undefined;
  * @param currency
  * @param fraction
  */
-declare const currencyFmt: (currency: NullOrUndefinable<number | bigint>, fraction?: number) => string;
+declare const currencyFmt: (currency: UnDef<Numeric | bigint>, fraction?: number) => string;
 
 type VantUploadFileStatus = '' | 'uploading' | 'done' | 'failed'
 type AntdUploadFileStatus = 'removed' | 'uploading' | 'done' | 'error'
@@ -607,14 +619,17 @@ declare const recoverFile: (resource: Resource) => {
     deletable?: boolean | undefined;
     reupload?: boolean | undefined;
     fileName?: string | undefined;
-    thumbUrl?: string | undefined;
+    thumbUrl?: string | undefined; /**
+     * 统一文件字段内容
+     * @param resource
+     */
     percentage?: number | undefined;
 };
 /**
  * 附件格式
  * @param data
  */
-declare const attachFmt: (data: NullOrUndefinable<MaybeArray<Resource>> | string) => {
+declare const attachFmt: (data: UnDef<MaybeArray<Resource>> | string) => {
     url: string | undefined;
     content: string | undefined;
     uri: string;
@@ -631,7 +646,10 @@ declare const attachFmt: (data: NullOrUndefinable<MaybeArray<Resource>> | string
     deletable?: boolean | undefined;
     reupload?: boolean | undefined;
     fileName?: string | undefined;
-    thumbUrl?: string | undefined;
+    thumbUrl?: string | undefined; /**
+     * 统一文件字段内容
+     * @param resource
+     */
     percentage?: number | undefined;
 }[];
 
@@ -644,7 +662,7 @@ declare const isDef: <T>(val: T) => val is NonNullable<T>;
  * 是否是数字或字符
  * @param val
  */
-declare const isNumeric: (val: Numeric) => val is string;
+declare const isNumeric: (val: UnDef<Numeric>) => val is string;
 /**
  * 是否是需要的图片格式
  * @param ext
@@ -654,17 +672,17 @@ declare const checkImg: (ext?: string) => boolean;
  * 是否是空值/空数组/空对象 null undefined '' [] {} Set Map
  * @param val
  */
-declare const isEmpty: (val: NullOrUndefinable<Numeric | boolean | Record<any, any> | Array<any> | Set<any> | Map<any, any>>) => boolean;
+declare const isEmpty: (val: UnDef<Numeric | boolean | Record<any, any> | Array<any> | Set<any> | Map<any, any>>) => boolean;
 /**
  * 判断是否合法JSON字符串
  * @param str
  */
-declare const isJSONStr: (str: string) => boolean;
+declare const isJSONStr: (str: UnDef<string>) => boolean;
 /**
  * 判断是否合法JSON数组字符串
  * @param str
  */
-declare const isArrStr: (str: string) => boolean;
+declare const isArrStr: (str: UnDef<string>) => boolean;
 /**
  * 判断是否有效的key
  * @param {string | number | symbol} key 键名
@@ -682,22 +700,23 @@ declare const isValidKey: (key: string | number | symbol, object: object) => key
  * 是否是中国手机号
  * @param val
  */
-declare const isPhone: (val: NullOrUndefinable<Numeric>) => boolean;
+declare const isPhone: (val: UnDef<Numeric>) => boolean;
 /**
  * 是否是中国座机号
  * @param val
  */
-declare const isTel: (val: NullOrUndefinable<Numeric>) => boolean;
+declare const isTel: (val: UnDef<Numeric>) => boolean;
 /**
  * 是否是邮箱
  * @param val
  */
-declare const isEmail: (val: NullOrUndefinable<string>) => boolean;
+declare const isEmail: (val: UnDef<string>) => boolean;
 /**
  * 是否是身份证
- * @param val 身份证号
+ * @param {string|null|undefined} val 身份证号
+ * @param {boolean} compatible 兼容15位
  */
-declare const isIdCard: (val: NullOrUndefinable<string>) => boolean;
+declare const isIdCard: (val: UnDef<string>, compatible?: boolean) => boolean;
 /**
  * 包含非ASCII字符
  * @param text
@@ -735,4 +754,4 @@ declare const isValidPageRes: (res: PageRes, code?: number) => boolean;
  */
 declare const isValidFileType: (file: File, type: string) => boolean;
 
-export { type NullOrUndefinable, type Nullable, type Numeric, type PageRes, type PageResData, type Res, type Undefinable, attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, currencyFmt, dateDuration, dateFmt, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getHostEnv, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hideName, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isDef, isEmail, isEmpty, isIdCard, isJSONStr, isNumeric, isPhone, isTel, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, nonASCII, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };
+export { type MaybeArray, type NullOrUndefinable, type Nullable, type Numeric, type PageRes, type PageResData, type Res, type UnDef, type Undefinable, attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, currencyFmt, dateDuration, dateFmt, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getHostEnv, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hideName, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isDef, isEmail, isEmpty, isIdCard, isJSONStr, isNumeric, isPhone, isTel, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, nonASCII, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };

package/dist/index.d.mts

@@ -221,6 +221,10 @@ declare type Undefinable<T> = T | undefined;
  * 可 Null 或 Undefined
  */
 declare type NullOrUndefinable<T> = Nullable<Undefinable<T>>;
+/**
+ * alias for NullOrUndefinable
+ */
+declare type UnDef<T> = NullOrUndefinable<T>;
 /**
  * 请求结果
  */
@@ -242,53 +246,61 @@ declare type MaybeArray<T = any> = T | Array<T>;
  * 隐藏中间部分
  * @param {string} str 需要隐藏的字符串
  */
-declare const hideMiddle: (str: NullOrUndefinable<string>) => string;
+declare const hideMiddle: (str: UnDef<string>) => string;
 /**
  * 隐藏首尾仅保留中间3分之1
  * @param {string} str 需要隐藏的字符串
  */
-declare const hideThird: (str: NullOrUndefinable<string>) => string;
+declare const hideThird: (str: UnDef<string>) => string;
 /**
  * 隐藏首部
  * @param {string} str 需要隐藏的字符串
+ * @param {number} count 隐藏的字符数
  */
-declare const hideHead: (str: NullOrUndefinable<string>) => string;
+declare const hideHead: (str: UnDef<string>, count?: number) => string;
 /**
  * 隐藏尾部
  * @param {string} str 需要隐藏的字符串
+ * @param {number} count 隐藏的字符数
  */
-declare const hideTail: (str: NullOrUndefinable<string>) => string;
+declare const hideTail: (str: UnDef<string>, count?: number) => string;
 /**
  * 隐藏手机号
  * @param {string} phone 手机号
  */
-declare const hidePhone: (phone: NullOrUndefinable<string>) => string;
+declare const hidePhone: (phone: UnDef<string>) => string;
 /**
  * 隐藏身份证号
  * @param {string} cardNo 身份证号
+ * @param {boolean} strong 是否强化隐藏
  */
-declare const hideCardNo: (cardNo: NullOrUndefinable<string>) => string;
+declare const hideCardNo: (cardNo: UnDef<string>, strong?: boolean) => string;
 /**
  * 隐藏姓名第一个字
  * @param {string} name 姓名
  * @deprecated 请使用 hideSurname
  */
-declare const hideName: (name: NullOrUndefinable<string>) => string;
+declare const hideName: (name: UnDef<string>) => string;
 /**
  * 隐藏姓氏
  * @param {string} name 姓名
  */
-declare const hideSurname: (name: NullOrUndefinable<string>) => string;
+declare const hideSurname: (name: UnDef<string>) => string;
 /**
  * 隐藏名字
  * @param {string} name 姓名
  */
-declare const hideFirstName: (name: NullOrUndefinable<string>) => string;
+declare const hideFirstName: (name: UnDef<string>) => string;
 /**
  * 隐藏邮箱
  * @param {string} email 邮箱
  */
-declare const hideEmail: (email: NullOrUndefinable<string>) => string;
+declare const hideEmail: (email: UnDef<string>) => string;
+/**
+ * 隐藏银行卡号
+ * @param {string} bankCard 银行卡号
+ */
+declare const hideBankCard: (bankCard: UnDef<string>) => string;
 
 /**
  * 判断是否是浏览器环境
@@ -549,7 +561,7 @@ declare const toThousands: (num: number) => string | undefined;
  * @param currency
  * @param fraction
  */
-declare const currencyFmt: (currency: NullOrUndefinable<number | bigint>, fraction?: number) => string;
+declare const currencyFmt: (currency: UnDef<Numeric | bigint>, fraction?: number) => string;
 
 type VantUploadFileStatus = '' | 'uploading' | 'done' | 'failed'
 type AntdUploadFileStatus = 'removed' | 'uploading' | 'done' | 'error'
@@ -607,14 +619,17 @@ declare const recoverFile: (resource: Resource) => {
     deletable?: boolean | undefined;
     reupload?: boolean | undefined;
     fileName?: string | undefined;
-    thumbUrl?: string | undefined;
+    thumbUrl?: string | undefined; /**
+     * 统一文件字段内容
+     * @param resource
+     */
     percentage?: number | undefined;
 };
 /**
  * 附件格式
  * @param data
  */
-declare const attachFmt: (data: NullOrUndefinable<MaybeArray<Resource>> | string) => {
+declare const attachFmt: (data: UnDef<MaybeArray<Resource>> | string) => {
     url: string | undefined;
     content: string | undefined;
     uri: string;
@@ -631,7 +646,10 @@ declare const attachFmt: (data: NullOrUndefinable<MaybeArray<Resource>> | string
     deletable?: boolean | undefined;
     reupload?: boolean | undefined;
     fileName?: string | undefined;
-    thumbUrl?: string | undefined;
+    thumbUrl?: string | undefined; /**
+     * 统一文件字段内容
+     * @param resource
+     */
     percentage?: number | undefined;
 }[];
 
@@ -644,7 +662,7 @@ declare const isDef: <T>(val: T) => val is NonNullable<T>;
  * 是否是数字或字符
  * @param val
  */
-declare const isNumeric: (val: Numeric) => val is string;
+declare const isNumeric: (val: UnDef<Numeric>) => val is string;
 /**
  * 是否是需要的图片格式
  * @param ext
@@ -654,17 +672,17 @@ declare const checkImg: (ext?: string) => boolean;
  * 是否是空值/空数组/空对象 null undefined '' [] {} Set Map
  * @param val
  */
-declare const isEmpty: (val: NullOrUndefinable<Numeric | boolean | Record<any, any> | Array<any> | Set<any> | Map<any, any>>) => boolean;
+declare const isEmpty: (val: UnDef<Numeric | boolean | Record<any, any> | Array<any> | Set<any> | Map<any, any>>) => boolean;
 /**
  * 判断是否合法JSON字符串
  * @param str
  */
-declare const isJSONStr: (str: string) => boolean;
+declare const isJSONStr: (str: UnDef<string>) => boolean;
 /**
  * 判断是否合法JSON数组字符串
  * @param str
  */
-declare const isArrStr: (str: string) => boolean;
+declare const isArrStr: (str: UnDef<string>) => boolean;
 /**
  * 判断是否有效的key
  * @param {string | number | symbol} key 键名
@@ -682,22 +700,23 @@ declare const isValidKey: (key: string | number | symbol, object: object) => key
  * 是否是中国手机号
  * @param val
  */
-declare const isPhone: (val: NullOrUndefinable<Numeric>) => boolean;
+declare const isPhone: (val: UnDef<Numeric>) => boolean;
 /**
  * 是否是中国座机号
  * @param val
  */
-declare const isTel: (val: NullOrUndefinable<Numeric>) => boolean;
+declare const isTel: (val: UnDef<Numeric>) => boolean;
 /**
  * 是否是邮箱
  * @param val
  */
-declare const isEmail: (val: NullOrUndefinable<string>) => boolean;
+declare const isEmail: (val: UnDef<string>) => boolean;
 /**
  * 是否是身份证
- * @param val 身份证号
+ * @param {string|null|undefined} val 身份证号
+ * @param {boolean} compatible 兼容15位
  */
-declare const isIdCard: (val: NullOrUndefinable<string>) => boolean;
+declare const isIdCard: (val: UnDef<string>, compatible?: boolean) => boolean;
 /**
  * 包含非ASCII字符
  * @param text
@@ -735,4 +754,4 @@ declare const isValidPageRes: (res: PageRes, code?: number) => boolean;
  */
 declare const isValidFileType: (file: File, type: string) => boolean;
 
-export { type NullOrUndefinable, type Nullable, type Numeric, type PageRes, type PageResData, type Res, type Undefinable, attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, currencyFmt, dateDuration, dateFmt, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getHostEnv, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hideName, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isDef, isEmail, isEmpty, isIdCard, isJSONStr, isNumeric, isPhone, isTel, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, nonASCII, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };
+export { type MaybeArray, type NullOrUndefinable, type Nullable, type Numeric, type PageRes, type PageResData, type Res, type UnDef, type Undefinable, attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, currencyFmt, dateDuration, dateFmt, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getHostEnv, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hideName, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isDef, isEmail, isEmpty, isIdCard, isJSONStr, isNumeric, isPhone, isTel, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, nonASCII, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };

package/dist/index.d.ts

@@ -221,6 +221,10 @@ declare type Undefinable<T> = T | undefined;
  * 可 Null 或 Undefined
  */
 declare type NullOrUndefinable<T> = Nullable<Undefinable<T>>;
+/**
+ * alias for NullOrUndefinable
+ */
+declare type UnDef<T> = NullOrUndefinable<T>;
 /**
  * 请求结果
  */
@@ -242,53 +246,61 @@ declare type MaybeArray<T = any> = T | Array<T>;
  * 隐藏中间部分
  * @param {string} str 需要隐藏的字符串
  */
-declare const hideMiddle: (str: NullOrUndefinable<string>) => string;
+declare const hideMiddle: (str: UnDef<string>) => string;
 /**
  * 隐藏首尾仅保留中间3分之1
  * @param {string} str 需要隐藏的字符串
  */
-declare const hideThird: (str: NullOrUndefinable<string>) => string;
+declare const hideThird: (str: UnDef<string>) => string;
 /**
  * 隐藏首部
  * @param {string} str 需要隐藏的字符串
+ * @param {number} count 隐藏的字符数
  */
-declare const hideHead: (str: NullOrUndefinable<string>) => string;
+declare const hideHead: (str: UnDef<string>, count?: number) => string;
 /**
  * 隐藏尾部
  * @param {string} str 需要隐藏的字符串
+ * @param {number} count 隐藏的字符数
  */
-declare const hideTail: (str: NullOrUndefinable<string>) => string;
+declare const hideTail: (str: UnDef<string>, count?: number) => string;
 /**
  * 隐藏手机号
  * @param {string} phone 手机号
  */
-declare const hidePhone: (phone: NullOrUndefinable<string>) => string;
+declare const hidePhone: (phone: UnDef<string>) => string;
 /**
  * 隐藏身份证号
  * @param {string} cardNo 身份证号
+ * @param {boolean} strong 是否强化隐藏
  */
-declare const hideCardNo: (cardNo: NullOrUndefinable<string>) => string;
+declare const hideCardNo: (cardNo: UnDef<string>, strong?: boolean) => string;
 /**
  * 隐藏姓名第一个字
  * @param {string} name 姓名
  * @deprecated 请使用 hideSurname
  */
-declare const hideName: (name: NullOrUndefinable<string>) => string;
+declare const hideName: (name: UnDef<string>) => string;
 /**
  * 隐藏姓氏
  * @param {string} name 姓名
  */
-declare const hideSurname: (name: NullOrUndefinable<string>) => string;
+declare const hideSurname: (name: UnDef<string>) => string;
 /**
  * 隐藏名字
  * @param {string} name 姓名
  */
-declare const hideFirstName: (name: NullOrUndefinable<string>) => string;
+declare const hideFirstName: (name: UnDef<string>) => string;
 /**
  * 隐藏邮箱
  * @param {string} email 邮箱
  */
-declare const hideEmail: (email: NullOrUndefinable<string>) => string;
+declare const hideEmail: (email: UnDef<string>) => string;
+/**
+ * 隐藏银行卡号
+ * @param {string} bankCard 银行卡号
+ */
+declare const hideBankCard: (bankCard: UnDef<string>) => string;
 
 /**
  * 判断是否是浏览器环境
@@ -549,7 +561,7 @@ declare const toThousands: (num: number) => string | undefined;
  * @param currency
  * @param fraction
  */
-declare const currencyFmt: (currency: NullOrUndefinable<number | bigint>, fraction?: number) => string;
+declare const currencyFmt: (currency: UnDef<Numeric | bigint>, fraction?: number) => string;
 
 type VantUploadFileStatus = '' | 'uploading' | 'done' | 'failed'
 type AntdUploadFileStatus = 'removed' | 'uploading' | 'done' | 'error'
@@ -607,14 +619,17 @@ declare const recoverFile: (resource: Resource) => {
     deletable?: boolean | undefined;
     reupload?: boolean | undefined;
     fileName?: string | undefined;
-    thumbUrl?: string | undefined;
+    thumbUrl?: string | undefined; /**
+     * 统一文件字段内容
+     * @param resource
+     */
     percentage?: number | undefined;
 };
 /**
  * 附件格式
  * @param data
  */
-declare const attachFmt: (data: NullOrUndefinable<MaybeArray<Resource>> | string) => {
+declare const attachFmt: (data: UnDef<MaybeArray<Resource>> | string) => {
     url: string | undefined;
     content: string | undefined;
     uri: string;
@@ -631,7 +646,10 @@ declare const attachFmt: (data: NullOrUndefinable<MaybeArray<Resource>> | string
     deletable?: boolean | undefined;
     reupload?: boolean | undefined;
     fileName?: string | undefined;
-    thumbUrl?: string | undefined;
+    thumbUrl?: string | undefined; /**
+     * 统一文件字段内容
+     * @param resource
+     */
     percentage?: number | undefined;
 }[];
 
@@ -644,7 +662,7 @@ declare const isDef: <T>(val: T) => val is NonNullable<T>;
  * 是否是数字或字符
  * @param val
  */
-declare const isNumeric: (val: Numeric) => val is string;
+declare const isNumeric: (val: UnDef<Numeric>) => val is string;
 /**
  * 是否是需要的图片格式
  * @param ext
@@ -654,17 +672,17 @@ declare const checkImg: (ext?: string) => boolean;
  * 是否是空值/空数组/空对象 null undefined '' [] {} Set Map
  * @param val
  */
-declare const isEmpty: (val: NullOrUndefinable<Numeric | boolean | Record<any, any> | Array<any> | Set<any> | Map<any, any>>) => boolean;
+declare const isEmpty: (val: UnDef<Numeric | boolean | Record<any, any> | Array<any> | Set<any> | Map<any, any>>) => boolean;
 /**
  * 判断是否合法JSON字符串
  * @param str
  */
-declare const isJSONStr: (str: string) => boolean;
+declare const isJSONStr: (str: UnDef<string>) => boolean;
 /**
  * 判断是否合法JSON数组字符串
  * @param str
  */
-declare const isArrStr: (str: string) => boolean;
+declare const isArrStr: (str: UnDef<string>) => boolean;
 /**
  * 判断是否有效的key
  * @param {string | number | symbol} key 键名
@@ -682,22 +700,23 @@ declare const isValidKey: (key: string | number | symbol, object: object) => key
  * 是否是中国手机号
  * @param val
  */
-declare const isPhone: (val: NullOrUndefinable<Numeric>) => boolean;
+declare const isPhone: (val: UnDef<Numeric>) => boolean;
 /**
  * 是否是中国座机号
  * @param val
  */
-declare const isTel: (val: NullOrUndefinable<Numeric>) => boolean;
+declare const isTel: (val: UnDef<Numeric>) => boolean;
 /**
  * 是否是邮箱
  * @param val
  */
-declare const isEmail: (val: NullOrUndefinable<string>) => boolean;
+declare const isEmail: (val: UnDef<string>) => boolean;
 /**
  * 是否是身份证
- * @param val 身份证号
+ * @param {string|null|undefined} val 身份证号
+ * @param {boolean} compatible 兼容15位
  */
-declare const isIdCard: (val: NullOrUndefinable<string>) => boolean;
+declare const isIdCard: (val: UnDef<string>, compatible?: boolean) => boolean;
 /**
  * 包含非ASCII字符
  * @param text
@@ -735,4 +754,4 @@ declare const isValidPageRes: (res: PageRes, code?: number) => boolean;
  */
 declare const isValidFileType: (file: File, type: string) => boolean;
 
-export { type NullOrUndefinable, type Nullable, type Numeric, type PageRes, type PageResData, type Res, type Undefinable, attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, currencyFmt, dateDuration, dateFmt, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getHostEnv, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hideName, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isDef, isEmail, isEmpty, isIdCard, isJSONStr, isNumeric, isPhone, isTel, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, nonASCII, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };
+export { type MaybeArray, type NullOrUndefinable, type Nullable, type Numeric, type PageRes, type PageResData, type Res, type UnDef, type Undefinable, attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, currencyFmt, dateDuration, dateFmt, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getHostEnv, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hideName, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isDef, isEmail, isEmpty, isIdCard, isJSONStr, isNumeric, isPhone, isTel, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, nonASCII, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };

package/dist/index.mjs

@@ -61,7 +61,11 @@ const jClear = console.clear.bind(console);
 const cnPhoneRE = /^1[3-9]\d{9}$/;
 const cnTelRE = /^0\d{9,11}$/;
 const isDef = (val) => val !== void 0 && val !== null;
-const isNumeric = (val) => typeof val === "number" || /^\d+(?:\.\d+)?$/.test(val);
+const isNumeric = (val) => {
+  if (isDef(val))
+    return typeof val === "number" || /^\d+(?:\.\d+)?$/.test(val);
+  return false;
+};
 const checkImg = (ext) => {
   return /\.(?:jpg|jpeg|png|gif)$/.test((ext || "").toLowerCase());
 };
@@ -69,19 +73,23 @@ const isEmpty = (val) => {
   return !isDef(val) || val === "" || Array.isArray(val) && val.length === 0 || Object.prototype.toString.call(val) === "[object Object]" && Object.keys(val).length === 0 || val instanceof Map && val.size === 0 || val instanceof Set && val.size === 0;
 };
 const isJSONStr = (str) => {
-  try {
-    JSON.parse(str);
-    return true;
-  } catch (e) {
-    return false;
-  }
+  if (isDef(str))
+    try {
+      JSON.parse(str);
+      return true;
+    } catch (e) {
+      return false;
+    }
+  return false;
 };
 const isArrStr = (str) => {
-  try {
-    return Array.isArray(JSON.parse(str));
-  } catch (e) {
-    return false;
-  }
+  if (isDef(str))
+    try {
+      return Array.isArray(JSON.parse(str));
+    } catch (e) {
+      return false;
+    }
+  return false;
 };
 const isValidKey = (key, object) => key in object;
 const isPhone = (val) => {
@@ -100,12 +108,12 @@ const isEmail = (val) => {
   const reg = /^[a-zA-Z\d](?:\w|-)+@[a-zA-Z\d]+\.[a-zA-Z]{2,5}$/;
   return reg.test(val);
 };
-const isIdCard = (val) => {
+const isIdCard = (val, compatible = true) => {
   if (!isDef(val))
     return false;
   const card15 = /^[1-9]\d{7}(?:0[1-9]|10|11|12)(?:[0-2][1-9]|10|20|30|31)\d{2}[\dXx]$/;
   const card18 = /^[1-9]\d{5}(?:18|19|20)\d{2}(?:0[1-9]|1[0-2])(?:[0-2][1-9]|10|20|30|31)\d{3}[\dXx]$/;
-  return card15.test(val) || card18.test(val);
+  return card18.test(val) || (compatible ? card15.test(val) : false);
 };
 const nonASCII = (text) => /[^\x20-\x7E]/.test(text);
 const isValidResCode = (res, code = 200) => res.code === code;
@@ -157,21 +165,23 @@ const hideThird = (str) => {
     return "**";
   return str.slice(0, partLen) + "*".repeat(len - 2 * partLen) + str.slice(len - partLen);
 };
-const hideHead = (str) => {
+const hideHead = (str, count) => {
   if (!isDef(str))
     return "";
   const len = str.length;
+  const cnt = count !== void 0 ? Math.max(Math.min(len, count), 0) : len - 1;
   if (len === 1)
     return "*";
-  return "*".repeat(len - 1) + str[len - 1];
+  return "*".repeat(cnt) + str.substring(cnt);
 };
-const hideTail = (str) => {
+const hideTail = (str, count) => {
   if (!isDef(str))
     return "";
   const len = str.length;
+  const cnt = count !== void 0 ? Math.max(Math.min(len, count), 0) : len - 1;
   if (len === 1)
     return "*";
-  return str[0] + "*".repeat(len - 1);
+  return str.substring(0, len - cnt) + "*".repeat(cnt);
 };
 const hidePhone = (phone) => {
   if (phone) {
@@ -185,9 +195,12 @@ const hidePhone = (phone) => {
   }
   return "";
 };
-const hideCardNo = (cardNo) => {
+const hideCardNo = (cardNo, strong = true) => {
   if (cardNo) {
-    return cardNo.replace(/^(.{4})\d+(.{2})$/, "$1*******$2");
+    if (isIdCard(cardNo, false)) {
+      return strong ? hideMiddle(cardNo) : cardNo.replace(/^(.)\d{3}(.{8})\d{5}(.)$/, "$1***$2*****$3");
+    }
+    return cardNo;
   }
   return "";
 };
@@ -206,7 +219,7 @@ const hideName = (name) => {
   return "";
 };
 const hideSurname = (name) => {
-  return hideHead(name);
+  return hideHead(name, 1);
 };
 const hideFirstName = (name) => {
   return hideTail(name);
@@ -214,14 +227,29 @@ const hideFirstName = (name) => {
 const hideEmail = (email) => {
   if (email) {
     if (!email.includes("@"))
-      return "";
+      return email;
     const arr = email.split("@");
     const name = arr[0];
     const domain = arr[1];
-    const len = name?.length;
-    if (!len)
+    if (!name || !domain)
       return email;
-    return `${hideTail(name)}@${domain}`;
+    const len = name.length;
+    let newName;
+    if (len <= 3) {
+      newName = `${name}***`;
+    } else {
+      newName = hideTail(name, 3);
+    }
+    return `${newName}@${domain}`;
+  }
+  return "";
+};
+const hideBankCard = (bankCard) => {
+  if (bankCard) {
+    const len = bankCard.length;
+    if (len <= 10)
+      return bankCard;
+    return bankCard.substring(0, 6) + "*".repeat(len - 10) + bankCard.substring(len - 4, len);
   }
   return "";
 };
@@ -355,8 +383,11 @@ const toThousands = (num) => {
 const currencyFmt = (currency, fraction = 0) => {
   if (!isDef(currency))
     return "";
+  const num = Number(currency);
+  if (Number.isNaN(num))
+    return "";
   return new Intl.NumberFormat("zh-CN", { style: "currency", currency: "CNY", maximumFractionDigits: fraction }).format(
-    currency
+    num
   );
 };
 
@@ -407,4 +438,4 @@ const attachFmt = (data) => {
   return attachList.map(recoverFile);
 };
 
-export { attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, currencyFmt, dateDuration, dateFmt, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getHostEnv, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hideName, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isDef, isEmail, isEmpty, isIdCard, isJSONStr, isNumeric, isPhone, isTel, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, nonASCII, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };
+export { attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, currencyFmt, dateDuration, dateFmt, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getHostEnv, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hideName, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isDef, isEmail, isEmpty, isIdCard, isJSONStr, isNumeric, isPhone, isTel, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, nonASCII, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jhqn/utils-core",
   "type": "module",
-  "version": "0.0.1-beta.24",
+  "version": "0.0.1-beta.26",
   "author": "jade-gjz <jiangang.zhang@jaderd.com>",
   "license": "MIT",
   "homepage": "https://github.com/jaderd-jh/utils/tree/main/packages/core#readme",