@allahjs/utils 0.0.1

package/dist/esm/core/cryptoUtils/index.js

@@ -0,0 +1,424 @@
+import CryptoJS from 'crypto-js';
+
+/**
+ * 检测是否为浏览器环境
+ * @returns {boolean} 如果是浏览器环境返回 true，否则返回 false
+ */
+function isBrowser() {
+    return typeof window !== 'undefined' && typeof window.document !== 'undefined';
+}
+/**
+ * 动态导入 uuid 模块
+ * @returns {Promise<any>} 返回 uuid 模块的 Promise
+ */
+async function loadUUID() {
+    try {
+        // 动态导入 uuid 模块以解决 CommonJS/ESM 兼容性问题
+        const uuid = await import('uuid');
+        return uuid;
+    }
+    catch (error) {
+        throw new Error(`加载 uuid 模块失败: ${error}`);
+    }
+}
+/**
+ * 检测是否支持 crypto.getRandomValues
+ * @returns {boolean} 如果支持返回 true，否则返回 false
+ */
+function supportsCryptoGetRandomValues() {
+    return typeof crypto !== 'undefined' &&
+        typeof crypto.getRandomValues === 'function';
+}
+/**
+ * 生成兼容性的随机字节数组
+ * @param {number} size - 需要生成的字节数
+ * @returns {Uint8Array} 随机字节数组
+ */
+function getRandomBytes(size) {
+    const bytes = new Uint8Array(size);
+    // 优先使用 crypto.getRandomValues（现代浏览器和 Node.js）
+    if (supportsCryptoGetRandomValues()) {
+        crypto.getRandomValues(bytes);
+        return bytes;
+    }
+    // 降级方案：使用 Math.random()
+    for (let i = 0; i < size; i++) {
+        bytes[i] = Math.floor(Math.random() * 256);
+    }
+    return bytes;
+}
+/**
+ * 生成兼容性的 UUID v4
+ * 当 crypto.getRandomValues 不可用时使用降级方案
+ * @returns {string} UUID v4 字符串
+ */
+function generateCompatibleUUID() {
+    const bytes = getRandomBytes(16);
+    // 设置版本号 (4) 和变体位
+    bytes[6] = (bytes[6] & 0x0f) | 0x40; // 版本 4
+    bytes[8] = (bytes[8] & 0x3f) | 0x80; // 变体位
+    // 转换为十六进制字符串
+    const hex = Array.from(bytes)
+        .map(b => b.toString(16).padStart(2, '0'))
+        .join('');
+    // 格式化为标准 UUID 格式
+    return [
+        hex.slice(0, 8),
+        hex.slice(8, 12),
+        hex.slice(12, 16),
+        hex.slice(16, 20),
+        hex.slice(20, 32)
+    ].join('-');
+}
+/**
+ * 延迟加载 JSEncrypt（仅在浏览器环境中）
+ * @returns {Promise<any>} 返回 JSEncrypt 类的 Promise
+ */
+async function loadJSEncrypt() {
+    if (!isBrowser()) {
+        throw new Error('JSEncrypt 只能在浏览器环境中使用');
+    }
+    try {
+        // 动态导入 JSEncrypt
+        const { default: JSEncrypt } = await import('jsencrypt');
+        return JSEncrypt;
+    }
+    catch (error) {
+        throw new Error(`加载 JSEncrypt 失败: ${error}`);
+    }
+}
+/**
+ * 延迟加载 Node.js crypto 模块（仅在 Node.js 环境中）
+ * @returns {Promise<any>} 返回 crypto 模块的 Promise
+ */
+async function loadNodeCrypto() {
+    if (isBrowser()) {
+        throw new Error('Node.js crypto 模块只能在 Node.js 环境中使用');
+    }
+    try {
+        // 动态导入 Node.js crypto 模块
+        const crypto = await import('crypto');
+        return crypto;
+    }
+    catch (error) {
+        throw new Error(`加载 Node.js crypto 模块失败: ${error}`);
+    }
+}
+/**
+ * Node.js 环境下的 RSA 加密
+ * @param {string} text - 需要加密的文本
+ * @param {string} publicKey - RSA 公钥（PEM 格式）
+ * @returns {Promise<string | false>} 返回加密后的 Base64 字符串，失败返回 false
+ */
+async function rsaEncryptNode(text, publicKey) {
+    try {
+        const crypto = await loadNodeCrypto();
+        const buffer = Buffer.from(text, 'utf8');
+        const encrypted = crypto.publicEncrypt(publicKey, buffer);
+        return encrypted.toString('base64');
+    }
+    catch (error) {
+        console.error('Node.js RSA 加密失败:', error);
+        return false;
+    }
+}
+/**
+ * Node.js 环境下的 RSA 解密
+ * @param {string} encryptedText - 需要解密的 Base64 字符串
+ * @param {string} privateKey - RSA 私钥（PEM 格式）
+ * @returns {Promise<string | false>} 返回解密后的原文，失败返回 false
+ */
+async function rsaDecryptNode(encryptedText, privateKey) {
+    try {
+        const crypto = await loadNodeCrypto();
+        const buffer = Buffer.from(encryptedText, 'base64');
+        const decrypted = crypto.privateDecrypt(privateKey, buffer);
+        return decrypted.toString('utf8');
+    }
+    catch (error) {
+        console.error('Node.js RSA 解密失败:', error);
+        return false;
+    }
+}
+/**
+ * Node.js 环境下生成 RSA 密钥对
+ * @param {number} keySize - 密钥长度
+ * @returns {Promise<{ publicKey: string; privateKey: string } | null>} 返回包含公钥和私钥的对象，失败返回 null
+ */
+async function generateRSAKeyPairNode(keySize) {
+    try {
+        const crypto = await loadNodeCrypto();
+        const { publicKey, privateKey } = crypto.generateKeyPairSync('rsa', {
+            modulusLength: keySize,
+            publicKeyEncoding: {
+                type: 'spki',
+                format: 'pem'
+            },
+            privateKeyEncoding: {
+                type: 'pkcs8',
+                format: 'pem'
+            }
+        });
+        return { publicKey, privateKey };
+    }
+    catch (error) {
+        console.error('Node.js RSA 密钥对生成失败:', error);
+        return null;
+    }
+}
+/**
+ * 浏览器环境下的 RSA 加密
+ * @param {string} text - 需要加密的文本
+ * @param {string} publicKey - RSA 公钥（PEM 格式）
+ * @returns {Promise<string | false>} 返回加密后的 Base64 字符串，失败返回 false
+ */
+async function rsaEncryptBrowser(text, publicKey) {
+    try {
+        const JSEncrypt = await loadJSEncrypt();
+        const encrypt = new JSEncrypt();
+        encrypt.setPublicKey(publicKey);
+        return encrypt.encrypt(text);
+    }
+    catch (error) {
+        console.error('浏览器 RSA 加密失败:', error);
+        return false;
+    }
+}
+/**
+ * 浏览器环境下的 RSA 解密
+ * @param {string} encryptedText - 需要解密的 Base64 字符串
+ * @param {string} privateKey - RSA 私钥（PEM 格式）
+ * @returns {Promise<string | false>} 返回解密后的原文，失败返回 false
+ */
+async function rsaDecryptBrowser(encryptedText, privateKey) {
+    try {
+        const JSEncrypt = await loadJSEncrypt();
+        const decrypt = new JSEncrypt();
+        decrypt.setPrivateKey(privateKey);
+        return decrypt.decrypt(encryptedText);
+    }
+    catch (error) {
+        console.error('浏览器 RSA 解密失败:', error);
+        return false;
+    }
+}
+/**
+ * 浏览器环境下生成 RSA 密钥对
+ * @param {number} keySize - 密钥长度
+ * @returns {Promise<{ publicKey: string; privateKey: string } | null>} 返回包含公钥和私钥的对象，失败返回 null
+ */
+async function generateRSAKeyPairBrowser(keySize) {
+    try {
+        const JSEncrypt = await loadJSEncrypt();
+        const encrypt = new JSEncrypt({ default_key_size: keySize.toString() });
+        return {
+            publicKey: encrypt.getPublicKey(),
+            privateKey: encrypt.getPrivateKey()
+        };
+    }
+    catch (error) {
+        console.error('浏览器 RSA 密钥对生成失败:', error);
+        return null;
+    }
+}
+/**
+ * 加密工具类
+ * 提供 UUID 生成、MD5 哈希、RSA 加密解密、AES 对称加密等功能
+ */
+const cryptoUtils = {
+    /**
+     * 生成 UUID v4
+     * @returns {Promise<string>} 返回一个随机生成的 UUID v4 字符串
+     * @example
+     * ```typescript
+     * const uuid = await cryptoUtils.uuid();
+     * console.log(uuid); // "550e8400e29b41d4a716446655440000"
+     * ```
+     */
+    async uuid() {
+        try {
+            // 优先尝试使用 uuid 库
+            if (supportsCryptoGetRandomValues()) {
+                const { v4: uuidv4 } = await loadUUID();
+                return uuidv4().replace(/-/g, '');
+            }
+            // 在不支持 crypto.getRandomValues 的环境中使用兼容性方案
+            console.warn('crypto.getRandomValues 不可用，使用兼容性 UUID 生成方案');
+            return generateCompatibleUUID().replace(/-/g, '');
+        }
+        catch (error) {
+            // 如果 uuid 库加载失败，也使用兼容性方案
+            console.warn('UUID 库加载失败，使用兼容性 UUID 生成方案:', error);
+            return generateCompatibleUUID().replace(/-/g, '');
+        }
+    },
+    /**
+     * 生成字符串的 MD5 哈希值
+     * @param {string} input - 需要进行 MD5 加密的输入字符串
+     * @param {string} [salt] - 可选的盐值，用于增强安全性
+     * @returns {string} 返回 MD5 哈希值的十六进制字符串
+     * @example
+     * ```typescript
+     * // 基础 MD5
+     * const hash1 = cryptoUtils.md5('hello world');
+     * console.log(hash1); // "5d41402abc4b2a76b9719d911017c592"
+     *
+     * // 带盐值的 MD5
+     * const hash2 = cryptoUtils.md5('password', 'mysalt');
+     * console.log(hash2); // "a1b2c3d4e5f6..."
+     * ```
+     */
+    md5(input, salt) {
+        const data = salt ? input + salt : input;
+        return CryptoJS.MD5(data).toString();
+    },
+    /**
+     * 生成简短的 UUID（8位）
+     * @returns {string} 返回一个8位的短 UUID 字符串
+     * @example
+     * ```typescript
+     * const shortUuid = cryptoUtils.miniUuid();
+     * console.log(shortUuid); // "a1b2c3d4"
+     * ```
+     */
+    miniUuid() {
+        return Math.random().toString(36).substring(2, 10);
+    },
+    /**
+     * 验证 UUID 格式是否正确
+     * @param {string} uuid - 需要验证的 UUID 字符串
+     * @returns {Promise<boolean>} 如果格式正确返回 true，否则返回 false
+     * @example
+     * ```typescript
+     * const isValid = await cryptoUtils.isValidUUID('550e8400-e29b-41d4-a716-446655440000');
+     * console.log(isValid); // true
+     * ```
+     */
+    async isValidUUID(uuid) {
+        try {
+            const { validate: validateUUID } = await loadUUID();
+            return validateUUID(uuid);
+        }
+        catch (error) {
+            console.warn(`UUID 库加载失败:${error}`);
+            // 如果 uuid 库不可用，使用正则表达式验证
+            const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+            return uuidRegex.test(uuid);
+        }
+    },
+    /**
+     * RSA 加密（跨环境兼容）
+     * 在 Node.js 环境中使用内置 crypto 模块，在浏览器环境中使用 jsencrypt
+     * @param {string} text - 需要加密的文本
+     * @param {string} publicKey - RSA 公钥（PEM 格式）
+     * @returns {Promise<string | false>} 返回加密后的 Base64 字符串，失败返回 false
+     * @example
+     * ```typescript
+     * const publicKey = `-----BEGIN PUBLIC KEY-----
+     * MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC7vbqajDw4o...
+     * -----END PUBLIC KEY-----`;
+     *
+     * const encrypted = await cryptoUtils.rsaEncrypt('Hello World', publicKey);
+     * console.log(encrypted); // "base64 encrypted string"
+     * ```
+     */
+    async rsaEncrypt(text, publicKey) {
+        if (isBrowser()) {
+            return await rsaEncryptBrowser(text, publicKey);
+        }
+        return await rsaEncryptNode(text, publicKey);
+    },
+    /**
+     * RSA 解密（跨环境兼容）
+     * 在 Node.js 环境中使用内置 crypto 模块，在浏览器环境中使用 jsencrypt
+     * @param {string} encryptedText - 需要解密的 Base64 字符串
+     * @param {string} privateKey - RSA 私钥（PEM 格式）
+     * @returns {Promise<string | false>} 返回解密后的原文，失败返回 false
+     * @example
+     * ```typescript
+     * const privateKey = `-----BEGIN PRIVATE KEY-----
+     * MIICdgIBADANBgkqhkiG9w0BAQEFAASCAmAwggJcAgEAAoGBAL...
+     * -----END PRIVATE KEY-----`;
+     *
+     * const decrypted = await cryptoUtils.rsaDecrypt(encryptedText, privateKey);
+     * console.log(decrypted); // "Hello World"
+     * ```
+     */
+    async rsaDecrypt(encryptedText, privateKey) {
+        if (isBrowser()) {
+            return await rsaDecryptBrowser(encryptedText, privateKey);
+        }
+        return await rsaDecryptNode(encryptedText, privateKey);
+    },
+    /**
+     * 生成 RSA 密钥对（跨环境兼容）
+     * 在 Node.js 环境中使用内置 crypto 模块，在浏览器环境中使用 jsencrypt
+     * @param {number} [keySize=1024] - 密钥长度，默认 1024 位
+     * @returns {Promise<{ publicKey: string; privateKey: string } | null>} 返回包含公钥和私钥的对象，失败返回 null
+     * @example
+     * ```typescript
+     * const keyPair = await cryptoUtils.generateRSAKeyPair(2048);
+     * if (keyPair) {
+     *   console.log(keyPair.publicKey);  // "-----BEGIN PUBLIC KEY-----..."
+     *   console.log(keyPair.privateKey); // "-----BEGIN PRIVATE KEY-----..."
+     * }
+     * ```
+     */
+    async generateRSAKeyPair(keySize = 1024) {
+        if (isBrowser()) {
+            return await generateRSAKeyPairBrowser(keySize);
+        }
+        return await generateRSAKeyPairNode(keySize);
+    },
+    /**
+     * AES 加密（使用字符串密钥）
+     * @param {string} text - 需要加密的文本
+     * @param {string} key - 加密密钥（字符串）
+     * @returns {string} 返回加密后的文本（包含 IV 和密文）
+     * @example
+     * ```typescript
+     * const encrypted = cryptoUtils.aesEncrypt('Hello World', 'mySecretKey123');
+     * console.log(encrypted); // "iv:ciphertext"
+     * ```
+     */
+    aesEncrypt(text, key) {
+        try {
+            // 使用 CryptoJS 进行 AES 加密
+            const encrypted = CryptoJS.AES.encrypt(text, key).toString();
+            return encrypted;
+        }
+        catch (error) {
+            console.error('AES 加密失败:', error);
+            throw new Error('AES 加密失败');
+        }
+    },
+    /**
+     * AES 解密（使用字符串密钥）
+     * @param {string} encryptedText - 需要解密的文本（包含 IV 和密文）
+     * @param {string} key - 解密密钥（字符串）
+     * @returns {string} 返回解密后的原文
+     * @example
+     * ```typescript
+     * const decrypted = cryptoUtils.aesDecrypt(encryptedText, 'mySecretKey123');
+     * console.log(decrypted); // "Hello World"
+     * ```
+     */
+    aesDecrypt(encryptedText, key) {
+        try {
+            // 使用 CryptoJS 进行 AES 解密
+            const decrypted = CryptoJS.AES.decrypt(encryptedText, key);
+            const decryptedText = decrypted.toString(CryptoJS.enc.Utf8);
+            if (!decryptedText) {
+                throw new Error('解密失败，可能是密钥错误或数据损坏');
+            }
+            return decryptedText;
+        }
+        catch (error) {
+            console.error('AES 解密失败:', error);
+            throw new Error('AES 解密失败');
+        }
+    }
+};
+
+export { cryptoUtils as default };
+//# sourceMappingURL=index.js.map

package/dist/esm/core/cryptoUtils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../src/core/cryptoUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;AAGG;AACH,SAAS,SAAS,GAAA;IAChB,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,WAAW;AAChF;AAEA;;;AAGG;AACH,eAAe,QAAQ,GAAA;AACrB,IAAA,IAAI;;AAEF,QAAA,MAAM,IAAI,GAAG,MAAM,OAAO,MAAM,CAAC;AACjC,QAAA,OAAO,IAAI;IACb;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,CAAA,CAAE,CAAC;IAC3C;AACF;AAEA;;;AAGG;AACH,SAAS,6BAA6B,GAAA;IACpC,OAAO,OAAO,MAAM,KAAK,WAAW;AAClC,QAAA,OAAO,MAAM,CAAC,eAAe,KAAK,UAAU;AAChD;AAEA;;;;AAIG;AACH,SAAS,cAAc,CAAC,IAAY,EAAA;AAClC,IAAA,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC;;IAGlC,IAAI,6BAA6B,EAAE,EAAE;AACnC,QAAA,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC;AAC7B,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE;AAC7B,QAAA,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;IAC5C;AAEA,IAAA,OAAO,KAAK;AACd;AAEA;;;;AAIG;AACH,SAAS,sBAAsB,GAAA;AAC7B,IAAA,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC;;AAGhC,IAAA,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC;AACpC,IAAA,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC;;AAGpC,IAAA,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK;AACzB,SAAA,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;SACxC,IAAI,CAAC,EAAE,CAAC;;IAGX,OAAO;AACL,QAAA,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;AACf,QAAA,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;AAChB,QAAA,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;AACjB,QAAA,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;AACjB,QAAA,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE;AACjB,KAAA,CAAC,IAAI,CAAC,GAAG,CAAC;AACb;AAEA;;;AAGG;AACH,eAAe,aAAa,GAAA;AAC1B,IAAA,IAAI,CAAC,SAAS,EAAE,EAAE;AAChB,QAAA,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC;IAC1C;AAEA,IAAA,IAAI;;QAEF,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,WAAW,CAAC;AACxD,QAAA,OAAO,SAAS;IAClB;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,CAAA,CAAE,CAAC;IAC9C;AACF;AAEA;;;AAGG;AACH,eAAe,cAAc,GAAA;IAC3B,IAAI,SAAS,EAAE,EAAE;AACf,QAAA,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC;IACvD;AAEA,IAAA,IAAI;;AAEF,QAAA,MAAM,MAAM,GAAG,MAAM,OAAO,QAAQ,CAAC;AACrC,QAAA,OAAO,MAAM;IACf;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,CAAA,CAAE,CAAC;IACrD;AACF;AAEA;;;;;AAKG;AACH,eAAe,cAAc,CAAC,IAAY,EAAE,SAAiB,EAAA;AAC3D,IAAA,IAAI;AACF,QAAA,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QACxC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC;AACzD,QAAA,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACrC;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC;AACzC,QAAA,OAAO,KAAK;IACd;AACF;AAEA;;;;;AAKG;AACH,eAAe,cAAc,CAAC,aAAqB,EAAE,UAAkB,EAAA;AACrE,IAAA,IAAI;AACF,QAAA,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC;QACnD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC;AAC3D,QAAA,OAAO,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;IACnC;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC;AACzC,QAAA,OAAO,KAAK;IACd;AACF;AAEA;;;;AAIG;AACH,eAAe,sBAAsB,CAAC,OAAe,EAAA;AACnD,IAAA,IAAI;AACF,QAAA,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE;QACrC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE;AAClE,YAAA,aAAa,EAAE,OAAO;AACtB,YAAA,iBAAiB,EAAE;AACjB,gBAAA,IAAI,EAAE,MAAM;AACZ,gBAAA,MAAM,EAAE;AACT,aAAA;AACD,YAAA,kBAAkB,EAAE;AAClB,gBAAA,IAAI,EAAE,OAAO;AACb,gBAAA,MAAM,EAAE;AACT;AACF,SAAA,CAAC;AACF,QAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE;IAClC;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC;AAC5C,QAAA,OAAO,IAAI;IACb;AACF;AAEA;;;;;AAKG;AACH,eAAe,iBAAiB,CAAC,IAAY,EAAE,SAAiB,EAAA;AAC9D,IAAA,IAAI;AACF,QAAA,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE;AACvC,QAAA,MAAM,OAAO,GAAG,IAAI,SAAS,EAAE;AAC/B,QAAA,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC;AAC/B,QAAA,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9B;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC;AACrC,QAAA,OAAO,KAAK;IACd;AACF;AAEA;;;;;AAKG;AACH,eAAe,iBAAiB,CAAC,aAAqB,EAAE,UAAkB,EAAA;AACxE,IAAA,IAAI;AACF,QAAA,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE;AACvC,QAAA,MAAM,OAAO,GAAG,IAAI,SAAS,EAAE;AAC/B,QAAA,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC;AACjC,QAAA,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;IACvC;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC;AACrC,QAAA,OAAO,KAAK;IACd;AACF;AAEA;;;;AAIG;AACH,eAAe,yBAAyB,CAAC,OAAe,EAAA;AACtD,IAAA,IAAI;AACF,QAAA,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE;AACvC,QAAA,MAAM,OAAO,GAAG,IAAI,SAAS,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;QACvE,OAAO;AACL,YAAA,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE;AACjC,YAAA,UAAU,EAAE,OAAO,CAAC,aAAa;SAClC;IACH;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC;AACxC,QAAA,OAAO,IAAI;IACb;AACF;AAEA;;;AAGG;AACH,MAAM,WAAW,GAAG;AAClB;;;;;;;;AAQG;AACH,IAAA,MAAM,IAAI,GAAA;AACR,QAAA,IAAI;;YAEF,IAAI,6BAA6B,EAAE,EAAE;gBACnC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,EAAE;gBACvC,OAAO,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACnC;;AAEA,YAAA,OAAO,CAAC,IAAI,CAAC,4CAA4C,CAAC;YAC1D,OAAO,sBAAsB,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnD;QAAE,OAAO,KAAK,EAAE;;AAEd,YAAA,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,KAAK,CAAC;YAClD,OAAO,sBAAsB,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnD;IACF,CAAC;AAED;;;;;;;;;;;;;;;AAeG;IACH,GAAG,CAAC,KAAa,EAAE,IAAa,EAAA;AAC9B,QAAA,MAAM,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK;QACxC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACtC,CAAC;AAED;;;;;;;;AAQG;IACH,QAAQ,GAAA;AACN,QAAA,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,CAAC;AAED;;;;;;;;;AASG;IACH,MAAM,WAAW,CAAC,IAAY,EAAA;AAC5B,QAAA,IAAI;YACF,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,QAAQ,EAAE;AACnD,YAAA,OAAO,YAAY,CAAC,IAAI,CAAC;QAC3B;QAAE,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,IAAI,CAAC,cAAc,KAAK,CAAA,CAAE,CAAC;;YAEnC,MAAM,SAAS,GAAG,wEAAwE;AAC1F,YAAA,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7B;IACF,CAAC;AAED;;;;;;;;;;;;;;;AAeG;AACH,IAAA,MAAM,UAAU,CAAC,IAAY,EAAE,SAAiB,EAAA;QAC9C,IAAI,SAAS,EAAE,EAAE;AACf,YAAA,OAAO,MAAM,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC;QACjD;AACA,QAAA,OAAO,MAAM,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC;IAC9C,CAAC;AAED;;;;;;;;;;;;;;;AAeG;AACH,IAAA,MAAM,UAAU,CAAC,aAAqB,EAAE,UAAkB,EAAA;QACxD,IAAI,SAAS,EAAE,EAAE;AACf,YAAA,OAAO,MAAM,iBAAiB,CAAC,aAAa,EAAE,UAAU,CAAC;QAC3D;AACA,QAAA,OAAO,MAAM,cAAc,CAAC,aAAa,EAAE,UAAU,CAAC;IACxD,CAAC;AAED;;;;;;;;;;;;;AAaG;AACH,IAAA,MAAM,kBAAkB,CAAC,OAAA,GAAkB,IAAI,EAAA;QAC7C,IAAI,SAAS,EAAE,EAAE;AACf,YAAA,OAAO,MAAM,yBAAyB,CAAC,OAAO,CAAC;QACjD;AACA,QAAA,OAAO,MAAM,sBAAsB,CAAC,OAAO,CAAC;IAC9C,CAAC;AAED;;;;;;;;;;AAUG;IACH,UAAU,CAAC,IAAY,EAAE,GAAW,EAAA;AAClC,QAAA,IAAI;;AAEF,YAAA,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE;AAC5D,YAAA,OAAO,SAAS;QAClB;QAAE,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC;AACjC,YAAA,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;QAC7B;IACF,CAAC;AAED;;;;;;;;;;AAUG;IACH,UAAU,CAAC,aAAqB,EAAE,GAAW,EAAA;AAC3C,QAAA,IAAI;;AAEF,YAAA,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;AAC1D,YAAA,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAE3D,IAAI,CAAC,aAAa,EAAE;AAClB,gBAAA,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC;YACtC;AAEA,YAAA,OAAO,aAAa;QACtB;QAAE,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC;AACjC,YAAA,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;QAC7B;IACF;;;;;"}

package/dist/esm/core/dateUtils/index.d.ts

@@ -0,0 +1,117 @@
+import { Dayjs } from 'dayjs';
+
+/**
+ * 日期工具函数
+ */
+
+/**
+ * 日期工具对象
+ */
+declare const dateUtils: {
+    /**
+     * 格式化日期
+     * @param date 日期对象或时间戳
+     * @param format 格式字符串，如 'YYYY-MM-DD HH:mm:ss'
+     * @returns 格式化后的日期字符串
+     */
+    formatDate(date: Date | number | string, format?: string): string;
+    /**
+     * 获取相对时间描述
+     * @param date 日期对象或时间戳
+     * @returns 相对时间描述，如 '2小时前'
+     */
+    timeAgo(date: Date | number | string): string;
+    /**
+     * 添加时间
+     * @param date 日期对象或时间戳
+     * @param amount 数量
+     * @param unit 单位：'years' | 'months' | 'days' | 'hours' | 'minutes' | 'seconds'
+     * @returns 新的日期对象
+     */
+    addTime(date: Date | number | string, amount: number, unit: "years" | "months" | "days" | "hours" | "minutes" | "seconds"): Date;
+    /**
+     * 获取日期范围的开始和结束
+     * @param date 日期对象或时间戳
+     * @param unit 单位：'day' | 'week' | 'month' | 'year'
+     * @returns 包含开始和结束日期的对象
+     */
+    getDateRange(date: Date | number | string, unit: "day" | "week" | "month" | "year"): {
+        start: Date;
+        end: Date;
+    };
+    /**
+     * 判断是否为同一天
+     * @param date1 日期1
+     * @param date2 日期2
+     * @returns 是否为同一天
+     */
+    isSameDay(date1: Date | number | string, date2: Date | number | string): boolean;
+    /**
+     * 判断是否为闰年
+     * @param year 年份
+     * @returns 是否为闰年
+     */
+    isLeapYear(year: number): boolean;
+    /**
+     * 获取月份天数
+     * @param year 年份
+     * @param month 月份（0-11）
+     * @returns 天数
+     */
+    getDaysInMonth(year: number, month: number): number;
+    /**
+     * 获取最近几年的年份选项
+     * @param num 几年？默认三年（向上取）
+     * @returns 年份选项数组
+     */
+    getYearOptions(num?: number): Array<{
+        id: number;
+        text: number;
+    }>;
+    /**
+     * 获取最近几年的年份选项（向下取）
+     * @param num 几年？默认三年（向下取）
+     * @returns 年份选项数组
+     */
+    getPastYearOptions(num?: number): Array<{
+        id: number;
+        text: number;
+    }>;
+    /**
+     * 格式化时间显示
+     * @param timestamp 时间戳（字符串或数字）
+     * @returns 格式化后的时间显示字符串
+     */
+    formatTime(timestamp: string | number): string;
+    /**
+     * 根据当前的时间，来生成是凌晨、早上、中午、下午、晚上，返回对应的字符串
+     */
+    getDayTimeStr: (date?: Dayjs) => "" | "凌晨" | "上午" | "中午" | "下午" | "晚上";
+    /**
+     * 安全格式化日期
+     *
+     * @param date - 要格式化的日期，可以是字符串、数字、Date 对象或 dayjs 对象
+     * @param format - 输出的日期格式，默认为 "YYYY-MM-DD"
+     * @returns 格式化后的日期字符串；如果输入无效，则返回 "-"
+     *
+     * @example
+     * safeFormat("2025-09-20") // "2025-09-20"
+     * safeFormat("2025-13-40") // "-"
+     * safeFormat(new Date(), "YYYY/MM/DD HH:mm") // "2025/09/20 16:30"
+     */
+    safeFormat: (date: any, format?: string) => string;
+    /**
+     * 安全格式化时间
+     */
+    safeFormatTime: (date: any, format?: string) => string;
+    /**
+     * 格式化日期范围显示
+     * 将开始时间和结束时间格式化为范围显示
+     * @param startTime 开始时间
+     * @param endTime 结束时间
+     * @returns 格式化后的日期范围字符串
+     */
+    formatDateRange: (startTime?: string, endTime?: string) => string;
+};
+
+export { dateUtils as default };