@ivujs/i-utils 2.0.0 → 2.1.0

package/dist/es/crypto/base64/index.d.ts

@@ -1,36 +1,53 @@
 /**
- * base64 加密
- * @param {String} str 字符串
- * @returns {String} 返回加密后的字符串
+ * Base64编码
+ * @param str 待编码的UTF8字符串
+ * @param urlSafe 是否生成URL安全的Base64（默认false）
+ * @returns Base64字符串
  */
-export function encode(str: string): string;
+export declare function base64Encode(str: string, urlSafe?: boolean): string;
 /**
- * base64 解密
- * @param {String} str 字符串
- * @returns {String} 返回解密后的字符串
+ * Base64解码
+ * @param str 待解码的Base64字符串
+ * @returns 解码后的UTF8字符串
  */
-export function decode(str: string): string;
+export declare function base64Decode(str: string): string;
 /**
- * base64 utf8加密
- * @param {String} str 字符串
- * @returns {String} 返回加密后的字符串
+ * URL安全Base64编码
+ * @param str 待编码的UTF8字符串
+ * @returns URL安全的Base64字符串
  */
-export function utf8Encode(str: string): string;
+export declare function base64EncodeURI(str: string): string;
 /**
- * base64 utf8解密
- * @param {String} str 字符串
- * @returns {String} 返回解密后的字符串
+ * URL安全Base64解码
+ * @param str 待解码的URL安全Base64字符串
+ * @returns 解码后的UTF8字符串
  */
-export function utf8Decode(str: string): string;
+export declare function base64DecodeURI(str: string): string;
 /**
- * base64 加密字节数组
- * @param {Array} array 数组
- * @returns {String} 返回加密后的字符串
+ * Uint8Array转Base64字符串
+ * @param uint8Array 待编码的字节数组
+ * @param urlSafe 是否生成URL安全的Base64（默认false）
+ * @returns Base64字符串
  */
-export function encodeAsBytes(array: any[]): string;
+export declare function base64FromUint8Array(uint8Array: Uint8Array, urlSafe?: boolean): string;
 /**
- * base64 解密字节数组
- * @param {String} str 字符串
- * @returns {Array} 返回解密后的字节数组
+ * Base64字符串转Uint8Array
+ * @param base64Str 待解码的Base64字符串
+ * @param urlSafe 是否为URL安全的Base64（默认false）
+ * @returns 解码后的字节数组
  */
-export function decodeAsBytes(str: string): any[];
+export declare function base64ToUint8Array(base64Str: string, urlSafe?: boolean): Uint8Array;
+/**
+ * 十六进制字符串转Base64字符串
+ * @param hexStr 待编码的十六进制字符串
+ * @param urlSafe 是否生成URL安全的Base64（默认false）
+ * @returns Base64字符串
+ */
+export declare function base64FromHex(hexStr: string, urlSafe?: boolean): string;
+/**
+ * Base64字符串转十六进制字符串
+ * @param base64Str 待解码的Base64字符串
+ * @param urlSafe 是否为URL安全的Base64（默认false）
+ * @returns 解码后的十六进制字符串
+ */
+export declare function base64ToHex(base64Str: string, urlSafe?: boolean): string;

package/dist/es/crypto/base64/index.mjs

@@ -1,52 +1,73 @@
-import { encode as encode$1, decode as decode$1, utf8Encode as utf8Encode$1, utf8Decode as utf8Decode$1, decodeAsBytes as decodeAsBytes$1 } from './base64.mjs';
+import { encode, decode, encodeURI, decodeURI, fromUint8Array, toUint8Array, fromHex, toHex } from './base64.mjs';
 
 /**
- * base64 加密
- * @param {String} str 字符串
- * @returns {String} 返回加密后的字符串
+ * Base64编码
+ * @param str 待编码的UTF8字符串
+ * @param urlSafe 是否生成URL安全的Base64（默认false）
+ * @returns Base64字符串
  */
-function encode(str) {
-    return encode$1(str);
+function base64Encode(str, urlSafe = false) {
+    return encode(str, urlSafe);
 }
 /**
- * base64 解密
- * @param {String} str 字符串
- * @returns {String} 返回解密后的字符串
+ * Base64解码
+ * @param str 待解码的Base64字符串
+ * @returns 解码后的UTF8字符串
  */
-function decode(str) {
-    return decode$1(str);
+function base64Decode(str) {
+    return decode(str);
 }
 /**
- * base64 utf8加密
- * @param {String} str 字符串
- * @returns {String} 返回加密后的字符串
+ * URL安全Base64编码
+ * @param str 待编码的UTF8字符串
+ * @returns URL安全的Base64字符串
  */
-function utf8Encode(str) {
-    return utf8Encode$1(str);
+function base64EncodeURI(str) {
+    return encodeURI(str);
 }
 /**
- * base64 utf8解密
- * @param {String} str 字符串
- * @returns {String} 返回解密后的字符串
+ * URL安全Base64解码
+ * @param str 待解码的URL安全Base64字符串
+ * @returns 解码后的UTF8字符串
  */
-function utf8Decode(str) {
-    return utf8Decode$1(str);
+function base64DecodeURI(str) {
+    return decodeURI(str);
 }
 /**
- * base64 加密字节数组
- * @param {Array} array 数组
- * @returns {String} 返回加密后的字符串
+ * Uint8Array转Base64字符串
+ * @param uint8Array 待编码的字节数组
+ * @param urlSafe 是否生成URL安全的Base64（默认false）
+ * @returns Base64字符串
  */
-function encodeAsBytes(array) {
-    return encode$1(array);
+function base64FromUint8Array(uint8Array, urlSafe = false) {
+    return fromUint8Array(uint8Array, urlSafe);
 }
 /**
- * base64 解密字节数组
- * @param {String} str 字符串
- * @returns {Array} 返回解密后的字节数组
+ * Base64字符串转Uint8Array
+ * @param base64Str 待解码的Base64字符串
+ * @param urlSafe 是否为URL安全的Base64（默认false）
+ * @returns 解码后的字节数组
  */
-function decodeAsBytes(str) {
-    return decodeAsBytes$1(str);
+function base64ToUint8Array(base64Str, urlSafe = false) {
+    return toUint8Array(base64Str, urlSafe);
+}
+/**
+ * 十六进制字符串转Base64字符串
+ * @param hexStr 待编码的十六进制字符串
+ * @param urlSafe 是否生成URL安全的Base64（默认false）
+ * @returns Base64字符串
+ */
+function base64FromHex(hexStr, urlSafe = false) {
+    return fromHex(hexStr, urlSafe);
+}
+/**
+ * Base64字符串转十六进制字符串
+ * @param base64Str 待解码的Base64字符串
+ * @param urlSafe 是否为URL安全的Base64（默认false）
+ * @returns 解码后的十六进制字符串
+ */
+function base64ToHex(base64Str, urlSafe = false) {
+    return toHex(base64Str, urlSafe);
 }
 
-export { decode, decodeAsBytes, encode, encodeAsBytes, utf8Decode, utf8Encode };
+export { base64Decode, base64DecodeURI, base64Encode, base64EncodeURI, base64FromHex, base64FromUint8Array, base64ToHex, base64ToUint8Array };

package/dist/es/crypto/index.d.ts

@@ -1,8 +1,8 @@
-export * as base64 from "./base64/index.js";
-export * as base32 from "./base32/index.js";
-export * from "./md5/index.js";
-export * from "./sha/index.js";
-export * from "./sm/index.js";
-export * as aes from "./aes/index.js";
-export * as des from "./des/index.js";
-export * as tea from "./tea/index.js";
+/**
+ * @module 加解密算法
+ */
+export * from "./base64";
+export * from "./md5";
+export * from "./sha256";
+export * from "./sm3";
+export * from "./sm4";

package/dist/es/crypto/md5/index.d.ts

@@ -1,13 +1,26 @@
 /**
  * md5 加密
- * @param {String} str 字符串
- * @returns {string} 返回加密后的字符串
+ * @param {string} str 字符串
+ * @returns {string} 返回加密后的十六进制字符串
  */
-export function md5(str: string): string;
+export declare function md5(str: string): string;
+/**
+ * md5 加密
+ * @param {string} str 字符串
+ * @returns {*} 返回加密后的二进制原始值
+ */
+export declare function md5Raw(str: string): any;
+/**
+ * md5_hmac 加密
+ * @param {string} str 字符串
+ * @param {string} key 秘钥
+ * @returns {string} 返回加密后的十六进制字符串
+ */
+export declare function md5Hmac(str: string, key: string): string;
 /**
  * md5_hmac 加密
- * @param {String} str 字符串
- * @param {String} key 秘钥
- * @returns {string} 返回加密后的字符串
+ * @param {string} str 字符串
+ * @param {string} key 秘钥
+ * @returns {string} 返回加密后的二进制原始值
  */
-export function md5_hmac(str: string, key: string): string;
+export declare function md5HmacRaw(str: string, key: string): any;

package/dist/es/crypto/md5/index.mjs

@@ -1,21 +1,44 @@
-import { md5 as md5$1, md5_hmac as md5_hmac$1 } from './md5.mjs';
+import { md5 as md5$1 } from './md5.mjs';
 
 /**
  * md5 加密
- * @param {String} str 字符串
- * @returns {string} 返回加密后的字符串
+ * @param {string} str 字符串
+ * @returns {string} 返回加密后的十六进制字符串
  */
 function md5(str) {
     return md5$1(str);
 }
+/**
+ * md5 加密
+ * @param {string} str 字符串
+ * @returns {*} 返回加密后的二进制原始值
+ */
+function md5Raw(str) {
+    return md5$1(str, undefined, true);
+}
+/**
+ * md5_hmac 加密
+ * @param {string} str 字符串
+ * @param {string} key 秘钥
+ * @returns {string} 返回加密后的十六进制字符串
+ */
+function md5Hmac(str, key) {
+    if (!str || !key) {
+        throw new Error("Missing str or key");
+    }
+    return md5$1(str, key, false);
+}
 /**
  * md5_hmac 加密
- * @param {String} str 字符串
- * @param {String} key 秘钥
- * @returns {string} 返回加密后的字符串
+ * @param {string} str 字符串
+ * @param {string} key 秘钥
+ * @returns {string} 返回加密后的二进制原始值
  */
-function md5_hmac(str, key) {
-    return md5_hmac$1(key, str);
+function md5HmacRaw(str, key) {
+    if (!str || !key) {
+        throw new Error("Missing str or key");
+    }
+    return md5$1(str, key, true);
 }
 
-export { md5, md5_hmac };
+export { md5, md5Hmac, md5HmacRaw, md5Raw };

package/dist/es/crypto/md5/md5.d.ts

@@ -1,144 +1,11 @@
-export const md5: Md5;
-export const md5_hmac: HmacMd5;
 /**
- * Md5 class
- * @class Md5
- * @description This is internal class.
- * @see {@link md5.create}
+ * Calculates MD5 value for a given string.
+ * If a key is provided, calculates the HMAC-MD5 value.
+ * Returns a Hex encoded string unless the raw argument is given.
+ *
+ * @param {string} string Input string
+ * @param {string} [key] HMAC key
+ * @param {boolean} [raw] Raw output switch
+ * @returns {string} MD5 output
  */
-declare function Md5(sharedMemory: any): void;
-declare class Md5 {
-    /**
-     * Md5 class
-     * @class Md5
-     * @description This is internal class.
-     * @see {@link md5.create}
-     */
-    constructor(sharedMemory: any);
-    blocks: any[] | Uint32Array<ArrayBuffer>;
-    buffer8: any;
-    h0: number;
-    h1: number;
-    h2: number;
-    h3: number;
-    start: number;
-    bytes: number;
-    hBytes: number;
-    finalized: boolean;
-    hashed: boolean;
-    first: boolean;
-    /**
-     * @method update
-     * @memberof Md5
-     * @instance
-     * @description Update hash
-     * @param {String|Array|Uint8Array|ArrayBuffer} message message to hash
-     * @returns {Md5} Md5 object.
-     * @see {@link md5.update}
-     */
-    update(message: string | any[] | Uint8Array | ArrayBuffer): Md5;
-    lastByteIndex: number | undefined;
-    finalize(): void;
-    hash(): void;
-    /**
-     * @method hex
-     * @memberof Md5
-     * @instance
-     * @description Output hash as hex string
-     * @returns {String} Hex string
-     * @see {@link md5.hex}
-     * @example
-     * hash.hex();
-     */
-    hex(): string;
-    /**
-     * @method toString
-     * @memberof Md5
-     * @instance
-     * @description Output hash as hex string
-     * @returns {String} Hex string
-     * @see {@link md5.hex}
-     * @example
-     * hash.toString();
-     */
-    toString: any;
-    /**
-     * @method digest
-     * @memberof Md5
-     * @instance
-     * @description Output hash as bytes array
-     * @returns {Array} Bytes array
-     * @see {@link md5.digest}
-     * @example
-     * hash.digest();
-     */
-    digest(): any[];
-    /**
-     * @method array
-     * @memberof Md5
-     * @instance
-     * @description Output hash as bytes array
-     * @returns {Array} Bytes array
-     * @see {@link md5.array}
-     * @example
-     * hash.array();
-     */
-    array: any;
-    /**
-     * @method arrayBuffer
-     * @memberof Md5
-     * @instance
-     * @description Output hash as ArrayBuffer
-     * @returns {ArrayBuffer} ArrayBuffer
-     * @see {@link md5.arrayBuffer}
-     * @example
-     * hash.arrayBuffer();
-     */
-    arrayBuffer(): ArrayBuffer;
-    /**
-     * @method buffer
-     * @deprecated This maybe confuse with Buffer in node.js. Please use arrayBuffer instead.
-     * @memberof Md5
-     * @instance
-     * @description Output hash as ArrayBuffer
-     * @returns {ArrayBuffer} ArrayBuffer
-     * @see {@link md5.buffer}
-     * @example
-     * hash.buffer();
-     */
-    buffer: any;
-    /**
-     * @method base64
-     * @memberof Md5
-     * @instance
-     * @description Output hash as base64 string
-     * @returns {String} base64 string
-     * @see {@link md5.base64}
-     * @example
-     * hash.base64();
-     */
-    base64(): string;
-}
-/**
- * HmacMd5 class
- * @class HmacMd5
- * @extends Md5
- * @description This is internal class.
- * @see {@link md5.hmac.create}
- */
-declare function HmacMd5(key: any, sharedMemory: any): void;
-declare class HmacMd5 {
-    /**
-     * HmacMd5 class
-     * @class HmacMd5
-     * @extends Md5
-     * @description This is internal class.
-     * @see {@link md5.hmac.create}
-     */
-    constructor(key: any, sharedMemory: any);
-    oKeyPad: number[];
-    inner: boolean;
-    sharedMemory: any;
-    finalize(): void;
-}
-export {};
+export function md5(string: string, key?: string, raw?: boolean): string;