sino-bc-cli 1.0.0

package/dist/utils/common.d.ts

@@ -0,0 +1,97 @@
+import dayjs from 'dayjs';
+/**
+ * 通用工具类
+ * 封装常用的通用工具方法，使用 lodash 和 dayjs 提升开发效率
+ * 所有方法均为无副作用的纯函数，便于测试和复用
+ */
+export declare class CommonUtils {
+    /**
+     * 格式化日期时间
+     * 封装 dayjs，提供统一的日期格式化入口
+     * @param date 日期（Date 对象、时间戳、日期字符串等）
+     * @param format 格式化模板，默认 'YYYY-MM-DD HH:mm:ss'
+     * @returns 格式化后的日期字符串
+     */
+    static formatDate(date?: dayjs.ConfigType, format?: string): string;
+    /**
+     * 计算两个日期之间的差值（天数）
+     * @param start 开始日期
+     * @param end 结束日期，默认为当前时间
+     * @returns 相差天数（取整）
+     */
+    static diffDays(start: dayjs.ConfigType, end?: dayjs.ConfigType): number;
+    /**
+     * 生成唯一 ID（基于时间戳 + 随机数）
+     * 使用 lodash 的 uniqueId 结合时间戳，避免 ID 碰撞
+     * @param prefix 可选的前缀
+     * @returns 唯一 ID 字符串
+     */
+    static generateUniqueId(prefix?: string): string;
+    /**
+     * 深拷贝对象
+     * 封装 lodash 的 cloneDeep，提供类型安全的深拷贝
+     * @param obj 待拷贝对象
+     * @returns 深拷贝后的对象
+     */
+    static deepClone<T>(obj: T): T;
+    /**
+     * 深度比较两个对象是否相等
+     * 封装 lodash 的 isEqual
+     * @param a 对象 A
+     * @param b 对象 B
+     * @returns 是否深度相等
+     */
+    static deepEqual(a: unknown, b: unknown): boolean;
+    /**
+     * 防抖函数包装
+     * 封装 lodash 的 debounce
+     * @param func 要防抖的函数
+     * @param wait 等待时间（毫秒），默认 300ms
+     * @returns 防抖后的函数
+     */
+    static debounce<T extends (...args: unknown[]) => unknown>(func: T, wait?: number): (...args: Parameters<T>) => void;
+    /**
+     * 节流函数包装
+     * 封装 lodash 的 throttle
+     * @param func 要节流的函数
+     * @param wait 节流间隔（毫秒），默认 300ms
+     * @returns 节流后的函数
+     */
+    static throttle<T extends (...args: unknown[]) => unknown>(func: T, wait?: number): (...args: Parameters<T>) => ReturnType<T> | undefined;
+    /**
+     * 从对象中提取指定的属性
+     * 封装 lodash 的 pick，提供类型安全的属性提取
+     * @param obj 源对象
+     * @param keys 要提取的属性名数组
+     * @returns 包含指定属性的新对象
+     */
+    static pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+    /**
+     * 从对象中排除指定的属性
+     * 封装 lodash 的 omit，提供类型安全的属性排除
+     * @param obj 源对象
+     * @param keys 要排除的属性名数组
+     * @returns 排除指定属性后的新对象
+     */
+    static omit<T extends object, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+    /**
+     * 延迟执行（Promise 封装的 setTimeout）
+     * @param ms 延迟毫秒数
+     */
+    static sleep(ms: number): Promise<void>;
+    /**
+     * 安全解析 JSON 字符串
+     * 解析失败时返回默认值而不是抛出异常
+     * @param jsonString JSON 字符串
+     * @param defaultValue 解析失败时的默认值，默认 undefined
+     * @returns 解析后的对象或默认值
+     */
+    static safeJsonParse<T = unknown>(jsonString: string, defaultValue?: T): T | undefined;
+    /**
+     * 截断字符串并添加省略号
+     * @param str 源字符串
+     * @param maxLength 最大长度
+     * @param suffix 后缀，默认 '...'
+     */
+    static truncate(str: string, maxLength: number, suffix?: string): string;
+}

package/dist/utils/common.js

@@ -0,0 +1,198 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommonUtils = void 0;
+const _ = __importStar(require("lodash"));
+const dayjs_1 = __importDefault(require("dayjs"));
+const logger_1 = require("./logger");
+/**
+ * 通用工具类
+ * 封装常用的通用工具方法，使用 lodash 和 dayjs 提升开发效率
+ * 所有方法均为无副作用的纯函数，便于测试和复用
+ */
+class CommonUtils {
+    /**
+     * 格式化日期时间
+     * 封装 dayjs，提供统一的日期格式化入口
+     * @param date 日期（Date 对象、时间戳、日期字符串等）
+     * @param format 格式化模板，默认 'YYYY-MM-DD HH:mm:ss'
+     * @returns 格式化后的日期字符串
+     */
+    static formatDate(date, format = 'YYYY-MM-DD HH:mm:ss') {
+        if (_.isNil(date)) {
+            return (0, dayjs_1.default)().format(format);
+        }
+        const d = (0, dayjs_1.default)(date);
+        if (!d.isValid()) {
+            logger_1.logger.warn(`无效的日期值: ${String(date)}`);
+            return '';
+        }
+        return d.format(format);
+    }
+    /**
+     * 计算两个日期之间的差值（天数）
+     * @param start 开始日期
+     * @param end 结束日期，默认为当前时间
+     * @returns 相差天数（取整）
+     */
+    static diffDays(start, end = (0, dayjs_1.default)()) {
+        const startDate = (0, dayjs_1.default)(start);
+        const endDate = (0, dayjs_1.default)(end);
+        if (!startDate.isValid() || !endDate.isValid()) {
+            logger_1.logger.warn('计算日期差值时存在无效日期');
+            return 0;
+        }
+        return endDate.diff(startDate, 'day');
+    }
+    /**
+     * 生成唯一 ID（基于时间戳 + 随机数）
+     * 使用 lodash 的 uniqueId 结合时间戳，避免 ID 碰撞
+     * @param prefix 可选的前缀
+     * @returns 唯一 ID 字符串
+     */
+    static generateUniqueId(prefix = '') {
+        const timestamp = (0, dayjs_1.default)().valueOf().toString(36);
+        const random = Math.random().toString(36).substring(2, 8);
+        const uniquePart = _.uniqueId();
+        return _.isEmpty(prefix)
+            ? `${timestamp}-${random}-${uniquePart}`
+            : `${prefix}-${timestamp}-${random}-${uniquePart}`;
+    }
+    /**
+     * 深拷贝对象
+     * 封装 lodash 的 cloneDeep，提供类型安全的深拷贝
+     * @param obj 待拷贝对象
+     * @returns 深拷贝后的对象
+     */
+    static deepClone(obj) {
+        return _.cloneDeep(obj);
+    }
+    /**
+     * 深度比较两个对象是否相等
+     * 封装 lodash 的 isEqual
+     * @param a 对象 A
+     * @param b 对象 B
+     * @returns 是否深度相等
+     */
+    static deepEqual(a, b) {
+        return _.isEqual(a, b);
+    }
+    /**
+     * 防抖函数包装
+     * 封装 lodash 的 debounce
+     * @param func 要防抖的函数
+     * @param wait 等待时间（毫秒），默认 300ms
+     * @returns 防抖后的函数
+     */
+    static debounce(func, wait = 300) {
+        return _.debounce(func, wait);
+    }
+    /**
+     * 节流函数包装
+     * 封装 lodash 的 throttle
+     * @param func 要节流的函数
+     * @param wait 节流间隔（毫秒），默认 300ms
+     * @returns 节流后的函数
+     */
+    static throttle(func, wait = 300) {
+        return _.throttle(func, wait);
+    }
+    /**
+     * 从对象中提取指定的属性
+     * 封装 lodash 的 pick，提供类型安全的属性提取
+     * @param obj 源对象
+     * @param keys 要提取的属性名数组
+     * @returns 包含指定属性的新对象
+     */
+    static pick(obj, keys) {
+        return _.pick(obj, keys);
+    }
+    /**
+     * 从对象中排除指定的属性
+     * 封装 lodash 的 omit，提供类型安全的属性排除
+     * @param obj 源对象
+     * @param keys 要排除的属性名数组
+     * @returns 排除指定属性后的新对象
+     */
+    static omit(obj, keys) {
+        return _.omit(obj, keys);
+    }
+    /**
+     * 延迟执行（Promise 封装的 setTimeout）
+     * @param ms 延迟毫秒数
+     */
+    static sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * 安全解析 JSON 字符串
+     * 解析失败时返回默认值而不是抛出异常
+     * @param jsonString JSON 字符串
+     * @param defaultValue 解析失败时的默认值，默认 undefined
+     * @returns 解析后的对象或默认值
+     */
+    static safeJsonParse(jsonString, defaultValue) {
+        if (_.isEmpty(jsonString) || !_.isString(jsonString)) {
+            return defaultValue;
+        }
+        try {
+            return JSON.parse(jsonString);
+        }
+        catch (error) {
+            logger_1.logger.warn('JSON 解析失败:', error instanceof Error ? error.message : String(error));
+            return defaultValue;
+        }
+    }
+    /**
+     * 截断字符串并添加省略号
+     * @param str 源字符串
+     * @param maxLength 最大长度
+     * @param suffix 后缀，默认 '...'
+     */
+    static truncate(str, maxLength, suffix = '...') {
+        if (!_.isString(str)) {
+            return '';
+        }
+        if (str.length <= maxLength) {
+            return str;
+        }
+        return str.substring(0, maxLength - suffix.length) + suffix;
+    }
+}
+exports.CommonUtils = CommonUtils;
+//# sourceMappingURL=common.js.map

package/dist/utils/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/utils/common.ts"],"names":[],"mappings":"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"}

package/dist/utils/crypto.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 加密工具类
+ * 封装 CryptoJS 常用加密/解密方法，提供统一的加密服务
+ * 遵循高内聚原则，将所有加解密相关逻辑集中在此模块
+ */
+export declare class CryptoUtils {
+    /**
+     * 计算字符串的 MD5 哈希值
+     * @param input 输入字符串
+     * @returns MD5 哈希值（32位小写）
+     */
+    static md5(input: string): string;
+    /**
+     * 计算字符串的 SHA-256 哈希值
+     * @param input 输入字符串
+     * @returns SHA-256 哈希值
+     */
+    static sha256(input: string): string;
+    /**
+     * 使用 AES 加密字符串
+     * @param plaintext 明文
+     * @param secretKey 密钥
+     * @returns 加密后的密文（Base64 编码）
+     */
+    static aesEncrypt(plaintext: string, secretKey: string): string;
+    /**
+     * 使用 AES 解密字符串
+     * @param ciphertext 密文
+     * @param secretKey 密钥
+     * @returns 解密后的明文，失败返回空字符串
+     */
+    static aesDecrypt(ciphertext: string, secretKey: string): string;
+    /**
+     * 使用 Base64 编码字符串
+     * @param input 输入字符串
+     * @returns Base64 编码结果
+     */
+    static base64Encode(input: string): string;
+    /**
+     * 使用 Base64 解码字符串
+     * @param input Base64 编码字符串
+     * @returns 解码后的字符串
+     */
+    static base64Decode(input: string): string;
+    /**
+     * 生成带时间戳的签名（用于接口请求等场景）
+     * 组合应用ID、时间戳、密钥进行签名，防止请求篡改
+     * @param appId 应用ID
+     * @param secretKey 密钥
+     * @returns 签名字符串
+     */
+    static generateSignature(appId: string, secretKey: string): string;
+}

package/dist/utils/crypto.js

@@ -0,0 +1,153 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CryptoUtils = void 0;
+const _ = __importStar(require("lodash"));
+const CryptoJS = __importStar(require("crypto-js"));
+const dayjs_1 = __importDefault(require("dayjs"));
+const logger_1 = require("./logger");
+/**
+ * 加密工具类
+ * 封装 CryptoJS 常用加密/解密方法，提供统一的加密服务
+ * 遵循高内聚原则，将所有加解密相关逻辑集中在此模块
+ */
+class CryptoUtils {
+    /**
+     * 计算字符串的 MD5 哈希值
+     * @param input 输入字符串
+     * @returns MD5 哈希值（32位小写）
+     */
+    static md5(input) {
+        if (_.isEmpty(input)) {
+            return '';
+        }
+        return CryptoJS.MD5(input).toString();
+    }
+    /**
+     * 计算字符串的 SHA-256 哈希值
+     * @param input 输入字符串
+     * @returns SHA-256 哈希值
+     */
+    static sha256(input) {
+        if (_.isEmpty(input)) {
+            return '';
+        }
+        return CryptoJS.SHA256(input).toString();
+    }
+    /**
+     * 使用 AES 加密字符串
+     * @param plaintext 明文
+     * @param secretKey 密钥
+     * @returns 加密后的密文（Base64 编码）
+     */
+    static aesEncrypt(plaintext, secretKey) {
+        if (_.isEmpty(plaintext) || _.isEmpty(secretKey)) {
+            return '';
+        }
+        try {
+            return CryptoJS.AES.encrypt(plaintext, secretKey).toString();
+        }
+        catch (error) {
+            logger_1.logger.error('AES 加密失败:', error);
+            return '';
+        }
+    }
+    /**
+     * 使用 AES 解密字符串
+     * @param ciphertext 密文
+     * @param secretKey 密钥
+     * @returns 解密后的明文，失败返回空字符串
+     */
+    static aesDecrypt(ciphertext, secretKey) {
+        if (_.isEmpty(ciphertext) || _.isEmpty(secretKey)) {
+            return '';
+        }
+        try {
+            const bytes = CryptoJS.AES.decrypt(ciphertext, secretKey);
+            return bytes.toString(CryptoJS.enc.Utf8);
+        }
+        catch (error) {
+            logger_1.logger.error('AES 解密失败:', error);
+            return '';
+        }
+    }
+    /**
+     * 使用 Base64 编码字符串
+     * @param input 输入字符串
+     * @returns Base64 编码结果
+     */
+    static base64Encode(input) {
+        if (_.isEmpty(input)) {
+            return '';
+        }
+        const wordArray = CryptoJS.enc.Utf8.parse(input);
+        return CryptoJS.enc.Base64.stringify(wordArray);
+    }
+    /**
+     * 使用 Base64 解码字符串
+     * @param input Base64 编码字符串
+     * @returns 解码后的字符串
+     */
+    static base64Decode(input) {
+        if (_.isEmpty(input)) {
+            return '';
+        }
+        try {
+            const words = CryptoJS.enc.Base64.parse(input);
+            return words.toString(CryptoJS.enc.Utf8);
+        }
+        catch (error) {
+            logger_1.logger.error('Base64 解码失败:', error);
+            return '';
+        }
+    }
+    /**
+     * 生成带时间戳的签名（用于接口请求等场景）
+     * 组合应用ID、时间戳、密钥进行签名，防止请求篡改
+     * @param appId 应用ID
+     * @param secretKey 密钥
+     * @returns 签名字符串
+     */
+    static generateSignature(appId, secretKey) {
+        const timestamp = (0, dayjs_1.default)().unix().toString();
+        const rawString = `${appId}${timestamp}${secretKey}`;
+        return this.sha256(rawString);
+    }
+}
+exports.CryptoUtils = CryptoUtils;
+//# sourceMappingURL=crypto.js.map

package/dist/utils/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../src/utils/crypto.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,0CAA4B;AAC5B,oDAAsC;AACtC,kDAA0B;AAC1B,qCAAkC;AAElC;;;;GAIG;AACH,MAAa,WAAW;IACtB;;;;OAIG;IACI,MAAM,CAAC,GAAG,CAAC,KAAa;QAC7B,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,KAAa;QAChC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,UAAU,CAAC,SAAiB,EAAE,SAAiB;QAC3D,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACjD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAM,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACjC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,UAAU,CAAC,UAAkB,EAAE,SAAiB;QAC5D,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAClD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAC1D,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAM,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACjC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,YAAY,CAAC,KAAa;QACtC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,YAAY,CAAC,KAAa;QACtC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/C,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAM,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;YACpC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,iBAAiB,CAAC,KAAa,EAAE,SAAiB;QAC9D,MAAM,SAAS,GAAG,IAAA,eAAK,GAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;CACF;AAzGD,kCAyGC"}

package/dist/utils/http.d.ts

@@ -0,0 +1,58 @@
+import { AxiosRequestConfig } from 'axios';
+/**
+ * HTTP 请求工具类
+ * 封装 axios，提供统一的 HTTP 请求接口，包含请求拦截、响应拦截、错误处理
+ * 具备超时设置、自动重试、日志记录等功能
+ */
+export declare class HttpUtils {
+    /** axios 实例 */
+    private static instance;
+    /**
+     * 获取 axios 实例（单例模式）
+     */
+    private static getInstance;
+    /**
+     * 发送 GET 请求
+     * @param url 请求 URL
+     * @param config 请求配置
+     * @returns Promise<T> 响应数据
+     */
+    static get<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * 发送 POST 请求
+     * @param url 请求 URL
+     * @param data 请求数据
+     * @param config 请求配置
+     * @returns Promise<T> 响应数据
+     */
+    static post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * 发送 PUT 请求
+     * @param url 请求 URL
+     * @param data 请求数据
+     * @param config 请求配置
+     * @returns Promise<T> 响应数据
+     */
+    static put<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * 发送 DELETE 请求
+     * @param url 请求 URL
+     * @param config 请求配置
+     * @returns Promise<T> 响应数据
+     */
+    static delete<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * 带重试机制的 GET 请求
+     * @param url 请求 URL
+     * @param maxRetries 最大重试次数，默认 3 次
+     * @param retryDelay 重试间隔（毫秒），默认 1000ms
+     * @param config 请求配置
+     * @returns Promise<T> 响应数据
+     */
+    static getWithRetry<T = unknown>(url: string, maxRetries?: number, retryDelay?: number, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * 延时函数
+     * @param ms 延时毫秒数
+     */
+    private static sleep;
+}