react-util-tools 1.0.14 → 1.0.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-util-tools",
-  "version": "1.0.14",
+  "version": "1.0.23",
   "description": "A collection of useful utilities: throttle, debounce, date formatting, device detection, money formatting, decimal calculations and more",
   "type": "module",
   "main": "dist/index.cjs",
@@ -14,15 +14,6 @@
       "require": "./dist/index.cjs"
     }
   },
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts",
-    "dev": "tsup src/index.ts --watch",
-    "prepublishOnly": "npm run build",
-    "release:patch": "npm version patch --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && npm publish",
-    "release:minor": "npm version minor --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && npm publish",
-    "release:major": "npm version major --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && npm publish",
-    "release": "npm run release:patch"
-  },
   "keywords": [
     "react",
     "utils",
@@ -63,5 +54,13 @@
     "date-fns": "^4.1.0",
     "date-fns-tz": "^3.2.0",
     "decimal.js": "^10.6.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --watch",
+    "release:patch": "pnpm version patch --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && pnpm publish --no-git-checks",
+    "release:minor": "pnpm version minor --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && pnpm publish --no-git-checks",
+    "release:major": "pnpm version major --no-git-tag-version && git add . && git commit -m 'chore: release v%s' && git tag v$(node -p \"require('./package.json').version\") && git push --follow-tags && pnpm publish --no-git-checks",
+    "release": "pnpm run release:patch"
   }
-}
+}

package/src/format/index.ts

@@ -187,3 +187,68 @@ export function formatPercent(
   const num = multiply ? value * 100 : value
   return num.toFixed(decimals) + '%'
 }
+
+/**
+ * 邮箱脱敏：只展示前3个字符+@和后面的字符串，中间用***表示
+ * @param email 邮箱地址
+ * @returns 脱敏后的邮箱地址
+ * @example
+ * maskEmail('dj49846917@proton.me') // 'dj4***@proton.me'
+ * maskEmail('abc@example.com') // 'abc***@example.com'
+ */
+export function maskEmail(email: string): string {
+  if (!email || typeof email !== 'string') {
+    return ''
+  }
+
+  const atIndex = email.indexOf('@')
+  if (atIndex <= 0) {
+    return email // 无效邮箱，返回原值
+  }
+
+  const localPart = email.substring(0, atIndex)
+  const domainPart = email.substring(atIndex)
+
+  // 只展示前3个字符
+  const visiblePart = localPart.substring(0, 3)
+  
+  return `${visiblePart}***${domainPart}`
+}
+
+/**
+ * 邮箱解脱敏：将脱敏的邮箱还原（需要提供原始邮箱）
+ * @param maskedEmail 脱敏后的邮箱地址
+ * @param originalEmail 原始邮箱地址
+ * @returns 解脱敏后的邮箱地址
+ * @example
+ * unmaskEmail('dj4***@proton.me', 'dj49846917@proton.me') // 'dj49846917@proton.me'
+ */
+export function unmaskEmail(maskedEmail: string, originalEmail: string): string {
+  if (!maskedEmail || !originalEmail) {
+    return ''
+  }
+
+  // 验证脱敏邮箱格式
+  if (!maskedEmail.includes('***@')) {
+    return maskedEmail // 不是脱敏格式，直接返回
+  }
+
+  // 验证原始邮箱和脱敏邮箱是否匹配
+  const maskedParts = maskedEmail.split('***@')
+  const atIndex = originalEmail.indexOf('@')
+  
+  if (atIndex <= 0) {
+    return maskedEmail // 原始邮箱无效
+  }
+
+  const originalPrefix = originalEmail.substring(0, 3)
+  const originalDomain = originalEmail.substring(atIndex + 1)
+  const maskedDomain = maskedParts[1]
+
+  // 验证前缀和域名是否匹配
+  if (maskedParts[0] === originalPrefix && maskedDomain === originalDomain) {
+    return originalEmail
+  }
+
+  return maskedEmail // 不匹配，返回脱敏邮箱
+}