gzjs-utils 1.0.25 → 1.0.26

package/types/utils/Hmac.d.ts

@@ -1,34 +1,81 @@
-export declare type Hmac = {
+import { default as CryptoJS } from 'crypto-js';
+/**
+ * 输入类型：string | Uint8Array | Int8Array | number[]
+ */
+type HmacInput = string | Uint8Array | Int8Array | number[];
+/**
+ * HMAC (Hash-based Message Authentication Code) 工具类
+ * 基于 crypto-js 实现，支持 MD5、SHA1、SHA224、SHA256、SHA384、SHA512
+ */
+declare const _Hmac_: {
     /**
-     * hmac_sha1 加密
-     * @param key
-     * @param data
+     * HMAC-MD5 加密
+     * @param key 密钥
+     * @param data 待加密数据
+     * @returns 16 进制字符串（32 字符）
      */
-    sha1(key: string, data: string | Uint8Array | Int8Array | any): Uint8Array;
+    md5(key: HmacInput, data: HmacInput): string;
     /**
-     * hmac_sha224 加密
-     * @param key
-     * @param data
+     * HMAC-SHA1 加密
+     * @param key 密钥
+     * @param data 待加密数据
+     * @returns 16 进制字符串（40 字符）
      */
-    sha224(key: string, data: string | Uint8Array | Int8Array | any): Uint8Array;
+    sha1(key: HmacInput, data: HmacInput): string;
     /**
-     * hmac_sha256 加密
-     * @param key
-     * @param data
+     * HMAC-SHA224 加密
+     * @param key 密钥
+     * @param data 待加密数据
+     * @returns 16 进制字符串（56 字符）
      */
-    sha256(key: string, data: string | Uint8Array | Int8Array | any): Uint8Array;
+    sha224(key: HmacInput, data: HmacInput): string;
     /**
-     * hmac_sha384 加密
-     * @param key
-     * @param data
+     * HMAC-SHA256 加密
+     * @param key 密钥
+     * @param data 待加密数据
+     * @returns 16 进制字符串（64 字符）
      */
-    sha384(key: string, data: string | Uint8Array | Int8Array | any): Uint8Array;
+    sha256(key: HmacInput, data: HmacInput): string;
     /**
-     * hmac_sha512 加密
-     * @param key
-     * @param data
+     * HMAC-SHA384 加密
+     * @param key 密钥
+     * @param data 待加密数据
+     * @returns 16 进制字符串（96 字符）
      */
-    sha512(key: string, data: string | Uint8Array | Int8Array | any): Uint8Array;
+    sha384(key: HmacInput, data: HmacInput): string;
+    /**
+     * HMAC-SHA512 加密
+     * @param key 密钥
+     * @param data 待加密数据
+     * @returns 16 进制字符串（128 字符）
+     */
+    sha512(key: HmacInput, data: HmacInput): string;
+    /**
+     * HMAC-SHA256 返回 WordArray（用于内部调用）
+     * @param key 密钥
+     * @param data 待加密数据
+     * @returns CryptoJS WordArray
+     */
+    SHA256(key: HmacInput, data: HmacInput): CryptoJS.lib.WordArray;
+    /**
+     * HMAC-SHA512 返回 WordArray（用于内部调用）
+     * @param key 密钥
+     * @param data 待加密数据
+     * @returns CryptoJS WordArray
+     */
+    SHA512(key: HmacInput, data: HmacInput): CryptoJS.lib.WordArray;
+    /**
+     * HMAC-SHA1 返回 WordArray
+     */
+    SHA1(key: HmacInput, data: HmacInput): CryptoJS.lib.WordArray;
+    /**
+     * HMAC-SHA224 返回 WordArray
+     */
+    SHA224(key: HmacInput, data: HmacInput): CryptoJS.lib.WordArray;
+    /**
+     * HMAC-SHA384 返回 WordArray
+     */
+    SHA384(key: HmacInput, data: HmacInput): CryptoJS.lib.WordArray;
 };
-declare const _default: Hmac;
-export default _default;
+export default _Hmac_;
+export type Hmac = typeof _Hmac_;

package/types/utils/MD5.d.ts

@@ -1,15 +1,65 @@
-export declare type MD5 = {
+/**
+ * 进度信息
+ */
+export interface MD5ProgressInfo {
+    /** 已读取字节数 */
+    loaded: number;
+    /** 文件总字节数 */
+    total: number;
+    /** 进度百分比 (0-100) */
+    percent: number;
+}
+/**
+ * 文件 MD5 计算选项
+ */
+export interface MD5FileOptions {
+    /** 分块大小，默认 4MB */
+    chunkSize?: number;
+    /** 进度回调函数 */
+    onProgress?: (info: MD5ProgressInfo) => void;
+}
+/**
+ * 文件输入类型：浏览器 File 对象或 Node.js 文件路径字符串
+ */
+type MD5FileInput = File | string;
+/**
+ * HMAC-MD5 加密，返回十六进制字符串
+ * @param key 密钥
+ * @param data 数据
+ * @returns 十六进制字符串格式的 HMAC-MD5 哈希值
+ */
+export declare function hmac_md5(key: any, data: any): string;
+/**
+ * MD5 工具类
+ */
+declare const _MD5_: {
     /**
-     * MD5 加密
-     * @param str
+     * MD5 加密，返回十六进制字符串
+     * @param str 待加密的字符串
+     * @returns 十六进制字符串格式的 MD5 哈希值
      */
-    encode(str: string): string | null | undefined;
+    encode(str: string): string;
     /**
-     * hmac_md5 加密
+     * HMAC-MD5 加密，返回十六进制字符串
      * @param key 加密密钥
      * @param str 加密内容
+     * @returns 十六进制字符串格式的 HMAC-MD5 哈希值
      */
-    hmac_md5(key: string, str: string): string | null | undefined;
+    HmacMD5(key: string, str: string): string;
+    /**
+     * 计算文件 MD5 哈希（支持大文件流式计算）
+     * @param file 文件对象（浏览器）或文件路径（Node.js）
+     * @param options 可选配置：分块大小、进度回调
+     * @returns Promise<string> 返回哈希值（32 字符 hex）
+     * @example
+     * // Node.js
+     * const hash = await MD5.encodeFile('/path/to/file.zip', {
+     *   onProgress: (p) => console.log(`${p.percent}%`)
+     * });
+     * // 浏览器
+     * const hash = await MD5.encodeFile(fileInput.files[0]);
+     */
+    encodeFile(file: MD5FileInput, options?: MD5FileOptions): Promise<string>;
 };
-declare const _MD5_: MD5;
 export default _MD5_;
+export declare type MD5 = typeof _MD5_;

package/types/utils/Promise.d.ts

@@ -1,14 +1,21 @@
+export declare class AggregateError extends Error {
+    errors: any[];
+    constructor(errors: any[], message?: string);
+}
 export declare class _Promise {
     private PromiseState;
-    private PromiseRuesult;
+    private PromiseResult;
     private callbacks;
     private finallys;
-    constructor(executor: any);
-    then(onResolved: any, onRejected: any): Promise<unknown>;
-    catch(onRejected: any): Promise<unknown>;
-    finally(onFinally: any): this;
-    static resolve(value: any): Promise<unknown>;
-    static reject(reason: any): Promise<unknown>;
-    static all(promises: Array<Promise<any> | _Promise>): Promise<unknown>;
-    static race(promises: any): Promise<unknown>;
+    constructor(executor: (resolve: (value?: any) => void, reject: (reason?: any) => void) => void);
+    then(onResolved?: (value: any) => any, onRejected?: (reason: any) => any): _Promise;
+    catch(onRejected: (reason: any) => any): _Promise;
+    finally(onFinally?: () => any): _Promise;
+    static resolve(value: any): _Promise;
+    static reject(reason: any): _Promise;
+    static all(promises: Array<_Promise | Promise<any>>): _Promise;
+    static race(promises: Array<_Promise | Promise<any>>): _Promise;
+    static any(promises: Array<_Promise | Promise<any>>): _Promise;
 }
+export default _Promise;
+export type PromiseType = typeof _Promise;

package/types/utils/Regexps.d.ts

@@ -0,0 +1,164 @@
+/**
+ * @description: the description Regexps
+ * @fileName:    Regexps.ts
+ * @author:      xiyuan-lgz
+ * @date:        2026-02-28  13:17:19
+ * @version:     1.0.0
+ */
+export declare const _Regexps_: {
+    /**
+     * 空格 空白
+     */
+    SPACE: RegExp;
+    /**
+     * 左空白
+     */
+    SPACE_LEFT: RegExp;
+    /**
+     * 有空白
+     */
+    SPACE_RIGHT: RegExp;
+    /**
+     * //数字，至少1位
+     */
+    NUMERIC: RegExp;
+    /**
+     *  //整数，支持正负数
+     */
+    INTEGER: RegExp;
+    /**
+     *  //正整数，第一个数字是1-9
+     */
+    INTEGER_P: RegExp;
+    /**
+     * //非负整数，0或者正整数
+     */
+    INTEGER_N_N: RegExp;
+    /**
+     * //浮点值，支持多位小数点，支持正负数
+     */
+    FLOAT: RegExp;
+    /**
+     * //浮点值，支持多位小数
+     */
+    FLOAT_N_N: RegExp;
+    /**
+     * //标准元金额，支持0-2位小数，支持正负数
+     */
+    AMOUNT_2R: RegExp;
+    /**
+     * //固定元金额，两位小数，支持正负数
+     */
+    AMOUNT_2R_FIXED: RegExp;
+    /**
+     * //标准元金额，支持0-2位小数
+     */
+    AMOUNT_N_N_2R: RegExp;
+    /**
+     *  //固定元金额，两位小数
+     */
+    AMOUNT_N_N_2R_FIXED: RegExp;
+    /**
+     * //字母
+     */
+    ALPHABAT: RegExp;
+    /**
+     * //大写字母
+     */
+    ALPHABAT_UPPER: RegExp;
+    /**
+     * //小写字母
+     */
+    ALPHABAT_LOWER: RegExp;
+    /**
+     *  //小写字母或数字
+     */
+    ALPHA_LOWER_NUMERIC: RegExp;
+    /**
+     *  //大写字母或数字
+     */
+    ALPHA_UPPER_NUMERIC: RegExp;
+    /**
+     *  //大小写字母或数字
+     */
+    ALPHA_NUMERIC: RegExp;
+    /**
+     *  //大小写字母或数字，开头必须为字母
+     */
+    ALPHA_NUMERIC_PA: RegExp;
+    /**
+     *  //双字节
+     */
+    ALPHABAT_DOUBLE: RegExp;
+    /**
+     *  //中文
+     */
+    CHINESE: RegExp;
+    /**
+     *  //中文大小写字母和数字
+     */
+    CHINESE_ALPHA_NUMERIC: RegExp;
+    /**
+     *  //日期 YYYY-MM-DD
+     */
+    DATE: RegExp;
+    /**
+     *  //时间 HH:mm:ss
+     */
+    TIME: RegExp;
+    /**
+     *  //日期时间 YYYY-MM-DD HH:mm:ss
+     */
+    DATE_TIME: RegExp;
+    /**
+     *  //日期时间匹配
+     */
+    DATE_TIME_MATCH: RegExp;
+    /**
+     *  //HTML标签
+     */
+    HTML: RegExp;
+    /**
+     *  //HTML标签匹配
+     */
+    HTML_TAG: RegExp;
+    /**
+     *  //HTML标签名称匹配
+     */
+    HTML_TAG_NAME: RegExp;
+    /**
+     *  //手机号 支持 11位 + 国别
+     */
+    MOBILE: RegExp;
+    /**
+     *  //手机号11位
+     */
+    MOBILE_11: RegExp;
+    /**
+     *  //IP地址
+     */
+    IP: RegExp;
+    /**
+     *  //MAC地址
+     */
+    MAC: RegExp;
+    /**
+     *  //QQ号
+     */
+    QQ: RegExp;
+    /**
+     *  //邮政编码
+     */
+    POSTAL_CODE: RegExp;
+    /**
+     *  //邮箱
+     */
+    EMAIL: RegExp;
+    /**
+     *  //身份证
+     */
+    IDCARD: RegExp;
+    IPv6: RegExp;
+};
+export default _Regexps_;
+export declare type Regexps = typeof _Regexps_;

package/types/utils/Requests.d.ts

@@ -0,0 +1,42 @@
+import { AxiosRequestConfig } from '/#/types/axios';
+export type RequestConfig = {
+    meta?: {
+        /**
+         * 是否忽略节流，默认false
+         */
+        ignoreThrottle?: boolean;
+        /**
+         * 节流时长，单位毫秒
+         */
+        throttleDuration?: number;
+    } & Record<any, any>;
+} & AxiosRequestConfig;
+declare const Requests: {
+    /**
+     * 节流请求
+     * 在指定的节流时长内，相同的请求会被合并，只执行一次实际请求
+     * 多个调用者会共享同一个响应结果
+     *
+     * @param config 请求参数
+     * @param request 实际请求函数
+     * @param duration 节流时长 单位/毫秒 默认=1000
+     * @returns Promise<响应结果>
+     *
+     * @example
+     * // 基本使用
+     * const result = await Requests.ThrottleRequest(
+     *   { url: '/api/data', method: 'GET' },
+     *   axios.request,
+     *   1000 // 1秒内相同请求只发一次
+     * );
+     *
+     * @example
+     * // 忽略节流
+     * const result = await Requests.ThrottleRequest(
+     *   { url: '/api/data', meta: { ignoreThrottle: true } },
+     *   axios.request
+     * );
+     */
+    ThrottleRequest<P extends RequestConfig, R = any>(config: P, request: (config: P) => Promise<R>, duration?: number): Promise<R>;
+};
+export default Requests;

package/types/utils/SHA.d.ts

@@ -1,29 +1,91 @@
-export declare type SHA = {
+/**
+ * 输入类型：string | Uint8Array | Int8Array | number[]
+ */
+type SHAInput = string | Uint8Array | Int8Array | number[];
+/**
+ * 进度信息
+ */
+export interface ProgressInfo {
+    /** 已读取字节数 */
+    loaded: number;
+    /** 文件总字节数 */
+    total: number;
+    /** 进度百分比 (0-100) */
+    percent: number;
+}
+/**
+ * 文件哈希计算选项
+ */
+export interface FileHashOptions {
+    /** 分块大小，默认 4MB */
+    chunkSize?: number;
+    /** 进度回调函数 */
+    onProgress?: (info: ProgressInfo) => void;
+}
+/**
+ * 文件输入类型：浏览器 File 对象或 Node.js 文件路径字符串
+ */
+type FileInput = File | string;
+declare const SHA: {
     /**
-     * sha1 加密
-     * @param data
+     * SHA1 加密
+     * @param src 输入数据
+     * @returns hex 字符串（40 字符）
      */
-    sha1(data: string | Uint8Array | Int8Array | any): Uint8Array;
+    sha1(src: SHAInput): string | null;
     /**
-     * sha224 加密
-     * @param data
+     * SHA224 加密
+     * @param data 输入数据
+     * @returns hex 字符串（56 字符）
      */
-    sha224(data: string | Uint8Array | Int8Array | any): Uint8Array;
+    sha224(data: SHAInput): string | null;
     /**
-     * sha256 加密
-     * @param data
+     * SHA256 加密
+     * @param src 输入数据
+     * @returns hex 字符串（64 字符）
      */
-    sha256(data: string | Uint8Array | Int8Array | any): Uint8Array;
+    sha256(src: SHAInput): string | null;
     /**
-     * sha384 加密
-     * @param data
+     * SHA384 加密
+     * @param src 输入数据
+     * @returns hex 字符串（96 字符）
      */
-    sha384(data: string | Uint8Array | Int8Array | any): Uint8Array;
+    sha384(src: SHAInput): string | null;
     /**
-     * sha512 加密
-     * @param data
+     * SHA512 加密
+     * @param src 输入数据
+     * @returns hex 字符串（128 字符）
      */
-    sha512(data: string | Uint8Array | Int8Array | any): Uint8Array;
+    sha512(src: SHAInput): string | null;
+    /**
+     * 计算 SHA256 文件哈希（支持大文件流式计算）
+     * @param file 文件对象（浏览器）或文件路径（Node.js）
+     * @param options 可选配置：分块大小、进度回调
+     * @returns Promise<string> 返回哈希值（64 字符 hex）
+     * @example
+     * // Node.js
+     * const hash = await SHA.sha256File('/path/to/file.mp4', {
+     *   onProgress: (p) => console.log(`${p.percent}%`)
+     * });
+     * // 浏览器
+     * const hash = await SHA.sha256File(fileInput.files[0]);
+     */
+    sha256File(file: FileInput, options?: FileHashOptions): Promise<string>;
+    /**
+     * 计算 SHA512 文件哈希（支持大文件流式计算）
+     * @param file 文件对象（浏览器）或文件路径（Node.js）
+     * @param options 可选配置：分块大小、进度回调
+     * @returns Promise<string> 返回哈希值（128 字符 hex）
+     * @example
+     * // Node.js
+     * const hash = await SHA.sha512File('/path/to/large-file.zip');
+     * // 浏览器
+     * const hash = await SHA.sha512File(fileInput.files[0], {
+     *   chunkSize: 8 * 1024 * 1024,  // 8MB 分块
+     *   onProgress: (p) => updateProgressBar(p.percent)
+     * });
+     */
+    sha512File(file: FileInput, options?: FileHashOptions): Promise<string>;
 };
-declare const _default: SHA;
-export default _default;
+export default SHA;
+export type SHA = typeof SHA;

package/types/utils/TreeUtils.d.ts

@@ -87,4 +87,4 @@ declare const _TreeUtils_: {
     filter<T>(arr: T[], filter: TreeFilter<T>, childrenField?: string | "children"): T[];
 };
 export default _TreeUtils_;
-export type TreeUtils = typeof _TreeUtils_;
+export declare type TreeUtils = typeof _TreeUtils_;