uve-utils

一个功能丰富的通用工具库，专为现代 Web 开发和政务端（浙政钉、浙里办）应用设计。

特性

• 🚀 单文件打包：基于 Vite 构建，输出精简的 ESM 和 CJS 单文件。
• 🛠️ 通用工具：包含正则表达式校验、日期格式化、数据类型判断、金额格式化等常用工具。
• 🔒 加密算法：集成 AES 以及国密算法（SM2, SM3, SM4）。
• 🏛️ 政务端支持：专门针对浙政钉和浙里办环境的初始化、埋点和授权封装。
• 📦 开箱即用：支持 TypeScript，提供完整的类型定义。

安装

npm install uve-utils
# 或者
yarn add uve-utils

快速使用

通用工具

import { utils } from 'uve-utils';

// 手机号校验
utils.checkPhoneNumber('13800138000'); // true

// 身份证校验
utils.checkIdentityId('330101199001011234');

// 日期格式化
utils.dateFormat(new Date(), 'YYYY-MM-DD HH:mm:ss');

// AES 加密
const encrypted = utils.encryptAes('Hello World');
const decrypted = utils.decryptAes(encrypted);

浙政钉/浙里办初始化

import { initZhezhengding, initZheliban } from 'uve-utils';

// 初始化浙政钉配置
initZhezhengding({
  enable: true,
  bid: 'your_bid',
  signkey: 'your_signkey',
  sapp_id: 'your_sapp_id',
  sapp_name: 'your_sapp_name'
});

// 初始化浙里办配置
initZheliban({
  enable: true,
  appTitle: '应用名称',
  bid: 'your_bid'
});

API 说明

utils (常用工具)

| 方法 | 说明 | | --- | --- | | checkPhoneNumber(phone) | 验证手机号码格式 | | checkIdentityId(id) | 验证身份证号码合法性 | | isNumber(val) | 判断是否为纯数字 | | numberChinese(num) | 数字转中文大写 | | dateFormat(date, format) | 日期格式化 | | getOsType() | 获取系统类型 (1:IOS, 2:Android, 3:Win, 4:Mac) | | getBrowserType() | 获取浏览器环境 (浙里办, 浙政钉, 微信等) | | hideString(str, start, len) | 字符串脱敏 | | uuid() | 生成唯一标识 | | moneyFormat(num) | 金额千分位格式化 | | encryptAes / decryptAes | AES 加解密 | | encryptSm2 / decryptSm2 | 国密 SM2 加解密 | | encryptSm4 / decryptSm4 | 国密 SM4 加解密 |

浙政钉埋点与授权

| 方法 | 说明 | | --- | --- | | createBaseBurialPointZzd(config) | 基础埋点 | | createUserInfoBurialPointZzd(config) | 用户信息埋点 | | getAuthCodeZzd() | 获取免登授权码 (Promise) |

浙里办埋点

| 方法 | 说明 | | --- | --- | | zwlogGlobalZlb(config) | 浙里办全局日志埋点 |

开发与构建

项目采用 Vite 进行构建，输出单文件 bundle。

# 安装依赖
yarn install

# 构建项目
yarn build

构建产物位于 dist 目录：

• index.js: ESM 模块
• index.cjs: CommonJS 模块
• index.d.ts: 类型声明文件
• zzd.html/zlb.html: 预置资产文件

License

ISC