gzjs-utils 1.0.2-7.1

package/types/utils/MD5.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 进度信息
+ */
+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 待加密的字符串
+     * @returns 十六进制字符串格式的 MD5 哈希值
+     */
+    encode(str: string): string;
+    /**
+     * HMAC-MD5 加密，返回十六进制字符串
+     * @param key 加密密钥
+     * @param str 加密内容
+     * @returns 十六进制字符串格式的 HMAC-MD5 哈希值
+     */
+    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>;
+};
+export default _MD5_;
+export declare type MD5 = typeof _MD5_;

package/types/utils/Promise.d.ts

@@ -0,0 +1,21 @@
+export declare class AggregateError extends Error {
+    errors: any[];
+    constructor(errors: any[], message?: string);
+}
+export declare class _Promise {
+    private PromiseState;
+    private PromiseResult;
+    private callbacks;
+    private finallys;
+    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

@@ -0,0 +1,91 @@
+/**
+ * 输入类型：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 src 输入数据
+     * @returns hex 字符串（40 字符）
+     */
+    sha1(src: SHAInput): string | null;
+    /**
+     * SHA224 加密
+     * @param data 输入数据
+     * @returns hex 字符串（56 字符）
+     */
+    sha224(data: SHAInput): string | null;
+    /**
+     * SHA256 加密
+     * @param src 输入数据
+     * @returns hex 字符串（64 字符）
+     */
+    sha256(src: SHAInput): string | null;
+    /**
+     * SHA384 加密
+     * @param src 输入数据
+     * @returns hex 字符串（96 字符）
+     */
+    sha384(src: SHAInput): string | null;
+    /**
+     * SHA512 加密
+     * @param src 输入数据
+     * @returns hex 字符串（128 字符）
+     */
+    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>;
+};
+export default SHA;
+export type SHA = typeof SHA;

package/types/utils/TreeUtils.d.ts

@@ -0,0 +1,90 @@
+export type TreeNodeEF = {
+    __level__: number;
+    __isRoot__: boolean;
+} & Record<any, any>;
+/**
+ * @param curr 当前项
+ * @param parent 父项
+ * @param idx 当前项目所在列表中的索引
+ * @param arr 当前项所在的列表对象
+ */
+export type EachTreeConsumer<T> = {
+    /**
+     *
+     * @param curr 当前节点
+     * @param parent 父节点
+     * @param idx  当前节点所在列表的索引
+     * @param arr 当前节点所在的列表
+     */
+    (curr: T, parent?: T | null, idx?: number, arr?: T[]): any;
+};
+/**
+ * 筛选器
+ * @param c 当前节点
+ * @param p 父节点
+ * @param idx  当前节点在列表中的索引
+ * @param arr 当前节点所在的列表
+ */
+export type TreeFilter<T> = {
+    /**
+     *
+     * @param c 当前节点
+     * @param p 父节点
+     * @param idx  当前节点在列表中的索引
+     * @param arr 当前节点所在的列表
+     * */
+    (c: T, p: T | null, idx: number, arr?: T[]): boolean;
+};
+declare const _TreeUtils_: {
+    /**
+     * 构建树型结构
+     * @param arr   数据列表
+     * @param idField id 唯一标识节点名称.默认=id
+     * @param parentField 父级节点名称.默认=parentId
+     * @param childrenField 子节点名称 .默认=children
+     */
+    buildTree<T, C extends string, R = T & {
+        __level__: number;
+        __isRoot__: boolean;
+    } & Record<any, any> & { [K in C]: R[]; }>(arr: T[], idField?: string, parentField?: string, childrenField?: C | "children"): R[];
+    /**
+     * 遍历树节点
+     * @param arr
+     * @param callback
+     * @param childrenField 默认=children
+     */
+    eachTree<T, R = T>(arr: T[], callback: EachTreeConsumer<T>, childrenField?: string | "children"): R[];
+    /**
+     * 查找 树节点 只返回一项
+     * @param treeList
+     * @param filter
+     * @param childrenField 默认=children
+     */
+    findTreeItem<T>(treeList: T[], filter: TreeFilter<T>, childrenField?: string | "children"): T | null;
+    /**
+     * 输转 数组
+     * @param arr
+     * @param childrenField 默认=children
+     * @param removeChildren 是否删除 children 节点
+     */
+    treeToArray<T>(arr: T[] | T, childrenField?: string, removeChildren?: boolean): T[];
+    /**
+     * 查找 一项
+     * @param arr 数据源
+     * @param filter 筛选器
+     * @param childrenField 默认=children
+     *
+     * @return The first element in the array that satisfies the provided testing function. Otherwise, undefined  is returned.
+     */
+    find<T>(arr: T[], filter: TreeFilter<T>, childrenField?: string | "children"): T | null;
+    /**
+     * 查找数
+     * @param arr 数列表
+     * @param filter 过滤器
+     * @param childrenField 默认=children
+     * @return A shallow copy of the given array containing just the elements that pass the test. If no elements pass the test, an empty array is returned.
+     */
+    filter<T>(arr: T[], filter: TreeFilter<T>, childrenField?: string | "children"): T[];
+};
+export default _TreeUtils_;
+export declare type TreeUtils = typeof _TreeUtils_;