@fast-china/utils 2.1.2 → 2.1.4

package/dist/crypto/index.d.mts

@@ -2,18 +2,18 @@ import { DecodedText } from "../internal/text.mjs";
 import "crypto-js/pad-ansix923.js";
 //#region src/crypto/index.d.ts
 /** AES 分组密码模式；与 .NET `CipherMode.CBC` 和 `CipherMode.ECB` 对应。 */
-type AesCipherMode = "CBC" | "ECB";
+export type AesCipherMode = "CBC" | "ECB";
 /** AES 填充模式；与 .NET `PaddingMode` 中可由 CryptoJS 互操作的成员对应。 */
-type AesPaddingMode = "None" | "PKCS7" | "Zeros" | "ANSIX923" | "ISO10126";
+export type AesPaddingMode = "None" | "PKCS7" | "Zeros" | "ANSIX923" | "ISO10126";
 /** Web Crypto 导出的 PEM 公私钥对。 */
-interface PemKeyPair {
+export interface PemKeyPair {
   /** 未加密的 PKCS#8 PEM 私钥，包含标准 `PRIVATE KEY` 头尾和 64 字符换行。 */
   privateKey: string;
   /** SubjectPublicKeyInfo PEM 公钥，包含标准 `PUBLIC KEY` 头尾和 64 字符换行。 */
   publicKey: string;
 }
 /** 本模块支持的 Web Crypto 椭圆曲线。 */
-type EcNamedCurve = "P-256" | "P-384" | "P-521";
+export type EcNamedCurve = "P-256" | "P-384" | "P-521";
 /**
  * 生成随机字节。
  *
@@ -22,7 +22,7 @@ type EcNamedCurve = "P-256" | "P-384" | "P-521";
  * @returns 新建的 `Uint8Array`。
  * @throws 参数非法时抛出 `RangeError`。
  */
-declare function GenerateRandomBytes(length: number): Uint8Array;
+export declare function GenerateRandomBytes(length: number): Uint8Array;
 /**
  * 以不提前退出的方式比较两个字节数组。
  *
@@ -32,7 +32,7 @@ declare function GenerateRandomBytes(length: number): Uint8Array;
  * @param right - 第二字节序列。
  * @returns 长度和每个字节均相同时返回 `true`。
  */
-declare function FixedTimeEquals(left: Uint8Array, right: Uint8Array): boolean;
+export declare function FixedTimeEquals(left: Uint8Array, right: Uint8Array): boolean;
 /**
  * 计算 MD5 摘要并返回小写十六进制文本。
  *
@@ -40,7 +40,7 @@ declare function FixedTimeEquals(left: Uint8Array, right: Uint8Array): boolean;
  * @param value - UTF-8 文本。
  * @returns 32 字符小写十六进制摘要。
  */
-declare function MD5Encrypt(value: string): string;
+export declare function MD5Encrypt(value: string): string;
 /**
  * 计算 SHA-1 摘要并返回大写十六进制文本。
  *
@@ -48,7 +48,7 @@ declare function MD5Encrypt(value: string): string;
  * @param value - UTF-8 文本。
  * @returns 40 字符大写十六进制摘要。
  */
-declare function SHA1Encrypt(value: string): string;
+export declare function SHA1Encrypt(value: string): string;
 /**
  * 计算 SHA-256 摘要。
  *
@@ -57,7 +57,7 @@ declare function SHA1Encrypt(value: string): string;
  * @returns 32 字节摘要。
  * @throws 缺少 Web Crypto 或 Encoding API 时抛出 `Error`。
  */
-declare function SHA256Bytes(value: string): Promise<Uint8Array>;
+export declare function SHA256Bytes(value: string): Promise<Uint8Array>;
 /**
  * 计算 SHA-256 并格式化为十六进制。
  *
@@ -65,35 +65,35 @@ declare function SHA256Bytes(value: string): Promise<Uint8Array>;
  * @returns 64 字符大写十六进制文本。
  * @throws 缺少 Web Crypto 或 Encoding API 时抛出 `Error`。
  */
-declare function SHA256Encrypt(value: string): Promise<string>;
+export declare function SHA256Encrypt(value: string): Promise<string>;
 /**
  * 计算 SHA-384 摘要。
  *
  * @param value - UTF-8 文本或原始字节。
  * @returns 48 字节摘要。
  */
-declare function SHA384Bytes(value: string): Promise<Uint8Array>;
+export declare function SHA384Bytes(value: string): Promise<Uint8Array>;
 /**
  * 计算 SHA-384 并格式化为十六进制文本。
  *
  * @param value - UTF-8 文本或原始字节。
  * @returns 96 个大写十六进制字符组成的摘要。
  */
-declare function SHA384Encrypt(value: string): Promise<string>;
+export declare function SHA384Encrypt(value: string): Promise<string>;
 /**
  * 计算 SHA-512 摘要。
  *
  * @param value - UTF-8 文本或原始字节。
  * @returns 64 字节摘要。
  */
-declare function SHA512Bytes(value: string): Promise<Uint8Array>;
+export declare function SHA512Bytes(value: string): Promise<Uint8Array>;
 /**
  * 计算 SHA-512 并格式化为十六进制文本。
  *
  * @param value - UTF-8 文本或原始字节。
  * @returns 128 个大写十六进制字符组成的摘要。
  */
-declare function SHA512Encrypt(value: string): Promise<string>;
+export declare function SHA512Encrypt(value: string): Promise<string>;
 /**
  * 使用 HMAC-SHA-256 认证文本，并返回十六进制标签。
  *
@@ -101,7 +101,7 @@ declare function SHA512Encrypt(value: string): Promise<string>;
  * @param key - 非空的 UTF-8 文本密钥或原始密钥字节。
  * @returns 64 个小写十六进制字符组成的认证标签。
  */
-declare function HMACSHA256Encrypt(value: string, key: string): Promise<string>;
+export declare function HMACSHA256Encrypt(value: string, key: string): Promise<string>;
 /**
  * 使用 HMAC-SHA-384 认证文本或字节，并返回十六进制标签。
  *
@@ -109,7 +109,7 @@ declare function HMACSHA256Encrypt(value: string, key: string): Promise<string>;
  * @param key - 非空的 UTF-8 文本密钥或原始密钥字节。
  * @returns 96 个小写十六进制字符组成的认证标签。
  */
-declare function HMACSHA384Encrypt(value: string, key: string): Promise<string>;
+export declare function HMACSHA384Encrypt(value: string, key: string): Promise<string>;
 /**
  * 使用 HMAC-SHA-512 认证文本或字节，并返回十六进制标签。
  *
@@ -117,7 +117,7 @@ declare function HMACSHA384Encrypt(value: string, key: string): Promise<string>;
  * @param key - 非空的 UTF-8 文本密钥或原始密钥字节。
  * @returns 128 个小写十六进制字符组成的认证标签。
  */
-declare function HMACSHA512Encrypt(value: string, key: string): Promise<string>;
+export declare function HMACSHA512Encrypt(value: string, key: string): Promise<string>;
 /**
  * 使用 PBKDF2-HMAC-SHA-256 从密码派生密钥。
  *
@@ -128,7 +128,7 @@ declare function HMACSHA512Encrypt(value: string, key: string): Promise<string>;
  * @returns 指定长度的派生密钥。
  * @throws 参数超过协议边界时抛出 `TypeError` 或 `RangeError`。
  */
-declare function PBKDF2SHA256(password: string, salt: Uint8Array, iterations?: number, outputLength?: number): Promise<Uint8Array>;
+export declare function PBKDF2SHA256(password: string, salt: Uint8Array, iterations?: number, outputLength?: number): Promise<Uint8Array>;
 /**
  * 生成可持久化的随机盐 PBKDF2-HMAC-SHA-256 密码哈希。
  *
@@ -136,7 +136,7 @@ declare function PBKDF2SHA256(password: string, salt: Uint8Array, iterations?: n
  * @param iterations - 迭代次数，范围为 100,000 至 5,000,000。
  * @returns 包含版本、迭代次数、16 字节随机盐和 32 字节派生密钥的自描述字符串。
  */
-declare function HashPasswordPBKDF2SHA256(password: string, iterations?: number): Promise<string>;
+export declare function HashPasswordPBKDF2SHA256(password: string, iterations?: number): Promise<string>;
 /**
  * 验证 {@link HashPasswordPBKDF2SHA256} 生成的密码哈希。
  *
@@ -144,7 +144,7 @@ declare function HashPasswordPBKDF2SHA256(password: string, iterations?: number)
  * @param passwordHash - 自描述的 PBKDF2-HMAC-SHA-256 密码哈希。
  * @returns 格式有效且密码匹配时返回 `true`；格式无效或密码错误时返回 `false`。
  */
-declare function VerifyPasswordPBKDF2SHA256(password: string, passwordHash: string): Promise<boolean>;
+export declare function VerifyPasswordPBKDF2SHA256(password: string, passwordHash: string): Promise<boolean>;
 /**
  * 使用 RFC 5869 HKDF-SHA-256 派生上下文隔离的密钥材料。
  *
@@ -154,7 +154,7 @@ declare function VerifyPasswordPBKDF2SHA256(password: string, passwordHash: stri
  * @param outputLength - 输出长度，范围为 1 至 8,160 字节。
  * @returns 与 `salt` 和 `info` 绑定的派生密钥。
  */
-declare function HKDFSHA256(inputKeyMaterial: Uint8Array, salt?: Uint8Array, info?: Uint8Array, outputLength?: number): Promise<Uint8Array>;
+export declare function HKDFSHA256(inputKeyMaterial: Uint8Array, salt?: Uint8Array, info?: Uint8Array, outputLength?: number): Promise<Uint8Array>;
 /**
  * 使用 AES-256 对 UTF-8 文本进行分组加密。
  *
@@ -168,7 +168,7 @@ declare function HKDFSHA256(inputKeyMaterial: Uint8Array, salt?: Uint8Array, inf
  * @returns Base64 密文；输入、密钥或 IV 为空白时返回 `null`。
  * @throws 模式或填充不受支持时抛出 `RangeError`。
  */
-declare function AESEncrypt(dataStr: string, key: string, vector: string, cipherMode?: AesCipherMode, paddingMode?: AesPaddingMode): string | null;
+export declare function AESEncrypt(dataStr: string, key: string, vector: string, cipherMode?: AesCipherMode, paddingMode?: AesPaddingMode): string | null;
 /**
  * 使用 AES-256 解密 Base64 分组密文。
  *
@@ -181,7 +181,7 @@ declare function AESEncrypt(dataStr: string, key: string, vector: string, cipher
  * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 UTF-8 字符串；输入、密钥或 IV 为空白时返回 `null`。
  * @throws 模式、填充、Base64、密钥或密文无效时抛出错误。
  */
-declare function AESDecrypt(dataStr: string, key: string, vector: string, cipherMode?: AesCipherMode, paddingMode?: AesPaddingMode): DecodedText | null;
+export declare function AESDecrypt(dataStr: string, key: string, vector: string, cipherMode?: AesCipherMode, paddingMode?: AesPaddingMode): DecodedText | null;
 /**
  * 使用 SHA-256 归一化文本密钥，再以 AES-256-GCM 认证加密 UTF-8 文本。
  *
@@ -191,7 +191,7 @@ declare function AESDecrypt(dataStr: string, key: string, vector: string, cipher
  * @returns Base64 编码的 v1 AES-GCM 认证载荷。
  * @throws 密钥为空或运行时缺少 Web Crypto 时抛出错误。
  */
-declare function AESEncryptAuthenticated(plaintext: string, key: string): Promise<string>;
+export declare function AESEncryptAuthenticated(plaintext: string, key: string): Promise<string>;
 /**
  * 解密并认证 .NET `AESEncryptAuthenticated` 或 {@link AESEncryptAuthenticated} 生成的载荷。
  *
@@ -200,7 +200,7 @@ declare function AESEncryptAuthenticated(plaintext: string, key: string): Promis
  * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 UTF-8 字符串。
  * @throws 载荷格式无效、密钥错误或认证失败时抛出错误。
  */
-declare function AESDecryptAuthenticated(payload: string, key: string): Promise<DecodedText>;
+export declare function AESDecryptAuthenticated(payload: string, key: string): Promise<DecodedText>;
 /**
  * 使用 PBKDF2-HMAC-SHA-256 派生密钥，再以 AES-256-GCM 认证加密 UTF-8 文本。
  *
@@ -213,7 +213,7 @@ declare function AESDecryptAuthenticated(payload: string, key: string): Promise<
  * @throws 口令非法时抛出 `TypeError` 或 `RangeError`；明文过大时抛出 `RangeError`；
  * 运行时缺少 Web Crypto 或 Encoding API 时抛出 `Error`。
  */
-declare function AESEncryptWithPassword(plaintext: string, password: string, iterations?: number): Promise<string>;
+export declare function AESEncryptWithPassword(plaintext: string, password: string, iterations?: number): Promise<string>;
 /**
  * 解密 {@link AESEncryptWithPassword} 生成的 v1 认证载荷。
  *
@@ -223,7 +223,7 @@ declare function AESEncryptWithPassword(plaintext: string, password: string, ite
  * @throws 格式或字段非法时抛出 `TypeError`，载荷过大时抛出 `RangeError`，认证或密码
  * 失败及缺少平台能力时抛出 `Error`。
  */
-declare function AESDecryptWithPassword(payload: string, password: string): Promise<DecodedText>;
+export declare function AESDecryptWithPassword(payload: string, password: string): Promise<DecodedText>;
 /**
  * 生成可供 RSA-OAEP/SHA-256 与 RSA-PSS/SHA-256 共用的 PEM 密钥对。
  *
@@ -231,7 +231,7 @@ declare function AESDecryptWithPassword(payload: string, password: string): Prom
  * @returns 未加密 PKCS#8 私钥和 SubjectPublicKeyInfo 公钥组成的 PEM 密钥对。
  * @throws 模数小于 2,048 或不是 256 的倍数时抛出 `RangeError`。
  */
-declare function GenerateRSAKeyPair(modulusLength?: number): Promise<PemKeyPair>;
+export declare function GenerateRSAKeyPair(modulusLength?: number): Promise<PemKeyPair>;
 /**
  * 使用 RSA-OAEP/SHA-256 公钥加密 UTF-8 文本。
  *
@@ -240,7 +240,7 @@ declare function GenerateRSAKeyPair(modulusLength?: number): Promise<PemKeyPair>
  * @returns Base64 编码的 RSA 密文。
  * @throws 公钥格式无效或明文超过 RSA-OAEP 容量时抛出错误。
  */
-declare function RSAEncryptOAEP(plaintext: string, publicKeyPem: string): Promise<string>;
+export declare function RSAEncryptOAEP(plaintext: string, publicKeyPem: string): Promise<string>;
 /**
  * 使用 RSA-OAEP/SHA-256 私钥解密 Base64 密文。
  *
@@ -249,7 +249,7 @@ declare function RSAEncryptOAEP(plaintext: string, publicKeyPem: string): Promis
  * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 UTF-8 字符串。
  * @throws 私钥、Base64 或密文无效时抛出错误。
  */
-declare function RSADecryptOAEP(ciphertext: string, privateKeyPem: string): Promise<DecodedText>;
+export declare function RSADecryptOAEP(ciphertext: string, privateKeyPem: string): Promise<DecodedText>;
 /**
  * 使用 RSA-PSS/SHA-256 私钥签名文本或字节。
  *
@@ -258,7 +258,7 @@ declare function RSADecryptOAEP(ciphertext: string, privateKeyPem: string): Prom
  * @returns Base64 编码的 RSA-PSS 签名；盐长度固定为 32 字节。
  * @throws 私钥格式无效或签名失败时抛出错误。
  */
-declare function RSASignPSS(value: string, privateKeyPem: string): Promise<string>;
+export declare function RSASignPSS(value: string, privateKeyPem: string): Promise<string>;
 /**
  * 使用 RSA-PSS/SHA-256 公钥验证 Base64 签名。
  *
@@ -268,14 +268,14 @@ declare function RSASignPSS(value: string, privateKeyPem: string): Promise<strin
  * @returns 签名与内容、公钥匹配时返回 `true`。
  * @throws 公钥或 Base64 格式无效时抛出错误。
  */
-declare function RSAVerifyPSS(value: string, signature: string, publicKeyPem: string): Promise<boolean>;
+export declare function RSAVerifyPSS(value: string, signature: string, publicKeyPem: string): Promise<boolean>;
 /**
  * 生成 ECDSA PEM 签名密钥对。
  *
  * @param namedCurve - NIST 曲线：P-256、P-384 或 P-521。
  * @returns 未加密 PKCS#8 私钥和 SubjectPublicKeyInfo 公钥组成的 PEM 密钥对。
  */
-declare function GenerateECDSAKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyPair>;
+export declare function GenerateECDSAKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyPair>;
 /**
  * 使用 ECDSA 私钥签名文本或字节。
  *
@@ -285,7 +285,7 @@ declare function GenerateECDSAKeyPair(namedCurve?: EcNamedCurve): Promise<PemKey
  * @param namedCurve - 私钥使用的 NIST 曲线。
  * @returns Base64 编码的 IEEE P1363 ECDSA 签名。
  */
-declare function ECDSASign(value: string, privateKeyPem: string, namedCurve?: EcNamedCurve): Promise<string>;
+export declare function ECDSASign(value: string, privateKeyPem: string, namedCurve?: EcNamedCurve): Promise<string>;
 /**
  * 使用 ECDSA 公钥验证 Base64 签名。
  *
@@ -295,14 +295,14 @@ declare function ECDSASign(value: string, privateKeyPem: string, namedCurve?: Ec
  * @param namedCurve - 公钥使用的 NIST 曲线。
  * @returns 签名与内容、公钥和曲线匹配时返回 `true`。
  */
-declare function ECDSAVerify(value: string, signature: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<boolean>;
+export declare function ECDSAVerify(value: string, signature: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<boolean>;
 /**
  * 生成 ECDH PEM 密钥协商密钥对。
  *
  * @param namedCurve - NIST 曲线：P-256、P-384 或 P-521。
  * @returns 未加密 PKCS#8 私钥和 SubjectPublicKeyInfo 公钥组成的 PEM 密钥对。
  */
-declare function GenerateECDHKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyPair>;
+export declare function GenerateECDHKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyPair>;
 /**
  * 使用本方 ECDH 私钥与对方 ECDH 公钥派生共享秘密。
  *
@@ -312,7 +312,7 @@ declare function GenerateECDHKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyP
  * @param namedCurve - 双方密钥使用的 NIST 曲线。
  * @returns 曲线字段长度的原始 ECDH 共享秘密。
  */
-declare function DeriveECDHSecret(privateKeyPem: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<Uint8Array>;
+export declare function DeriveECDHSecret(privateKeyPem: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<Uint8Array>;
 /**
  * 使用 ECDH 后以 SHA-256 派生共享密钥。
  *
@@ -322,7 +322,6 @@ declare function DeriveECDHSecret(privateKeyPem: string, publicKeyPem: string, n
  * @param namedCurve - 双方密钥使用的 NIST 曲线。
  * @returns 32 字节共享密钥。
  */
-declare function DeriveECDHKeySHA256(privateKeyPem: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<Uint8Array>;
+export declare function DeriveECDHKeySHA256(privateKeyPem: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<Uint8Array>;
 //#endregion
-export { AESDecrypt, AESDecryptAuthenticated, AESDecryptWithPassword, AESEncrypt, AESEncryptAuthenticated, AESEncryptWithPassword, AesCipherMode, AesPaddingMode, DeriveECDHKeySHA256, DeriveECDHSecret, ECDSASign, ECDSAVerify, EcNamedCurve, FixedTimeEquals, GenerateECDHKeyPair, GenerateECDSAKeyPair, GenerateRSAKeyPair, GenerateRandomBytes, HKDFSHA256, HMACSHA256Encrypt, HMACSHA384Encrypt, HMACSHA512Encrypt, HashPasswordPBKDF2SHA256, MD5Encrypt, PBKDF2SHA256, PemKeyPair, RSADecryptOAEP, RSAEncryptOAEP, RSASignPSS, RSAVerifyPSS, SHA1Encrypt, SHA256Bytes, SHA256Encrypt, SHA384Bytes, SHA384Encrypt, SHA512Bytes, SHA512Encrypt, VerifyPasswordPBKDF2SHA256 };
 //# sourceMappingURL=index.d.mts.map

package/dist/crypto/index.mjs

@@ -1,4 +1,5 @@
 import { createDecodedText, encodeUtf8, getTextDecoder } from "../internal/text.mjs";
+import { runtimeGlobals } from "../internal/runtime.mjs";
 import { decodeBase64Bytes, decodeBase64UrlBytes, encodeBase64Bytes, encodeBase64UrlBytes } from "../base64/index.mjs";
 import AES from "crypto-js/aes.js";
 import CryptoCore from "crypto-js/core.js";
@@ -31,6 +32,10 @@ const encryptedPayloadPrefix = "FAST-AES-256-GCM-V1";
 const passwordHashPrefix = "FAST-PBKDF2-SHA256-V1";
 /** 直接 AES-GCM 密钥加密载荷的协议版本。 */
 const authenticatedAesPayloadVersion = 1;
+/** 校验 JavaScript 调用方传入的 AES 分组模式。 */
+const assertAesCipherMode = (value) => {
+	if (value !== "CBC" && value !== "ECB") throw new RangeError("`cipherMode` 必须是 `CBC` 或 `ECB`。");
+};
 /**
 * 获取本模块非随机 API 所需的完整 Web Crypto 能力。
 *
@@ -38,7 +43,7 @@ const authenticatedAesPayloadVersion = 1;
 * @throws `Error` 当任一必要 SubtleCrypto 方法缺失。
 */
 const requireWebCrypto = () => {
-	const crypto = globalThis.crypto;
+	const crypto = runtimeGlobals.crypto;
 	const subtle = crypto?.subtle;
 	if (typeof subtle?.decrypt !== "function" || typeof subtle.deriveBits !== "function" || typeof subtle.deriveKey !== "function" || typeof subtle.digest !== "function" || typeof subtle.encrypt !== "function" || typeof subtle.exportKey !== "function" || typeof subtle.generateKey !== "function" || typeof subtle.importKey !== "function" || typeof subtle.sign !== "function" || typeof subtle.verify !== "function") throw new Error("当前运行环境不支持 Web Crypto SubtleCrypto。");
 	return crypto;
@@ -173,7 +178,7 @@ const computeHmacBytes = async (value, key, hash) => {
 function GenerateRandomBytes(length) {
 	if (!Number.isSafeInteger(length) || length < 0 || length > 65536) throw new RangeError("`length` 必须是 0 到 65,536 之间的安全整数。");
 	const bytes = new Uint8Array(length);
-	const crypto = globalThis.crypto;
+	const crypto = runtimeGlobals.crypto;
 	if (typeof crypto?.getRandomValues === "function") return crypto.getRandomValues(bytes);
 	for (let index = 0; index < bytes.length; index += 1) bytes[index] = Math.floor(Math.random() * 256);
 	return bytes;
@@ -400,7 +405,7 @@ async function HKDFSHA256(inputKeyMaterial, salt = /* @__PURE__ */ new Uint8Arra
 */
 function AESEncrypt(dataStr, key, vector, cipherMode = "CBC", paddingMode = "PKCS7") {
 	if (dataStr.trim().length === 0 || key.trim().length === 0 || vector.trim().length === 0) return null;
-	if (cipherMode !== "CBC" && cipherMode !== "ECB") throw new RangeError("`cipherMode` 必须是 `CBC` 或 `ECB`。");
+	assertAesCipherMode(cipherMode);
 	let padding = Pkcs7;
 	switch (paddingMode) {
 		case "None":
@@ -444,7 +449,7 @@ function AESEncrypt(dataStr, key, vector, cipherMode = "CBC", paddingMode = "PKC
 */
 function AESDecrypt(dataStr, key, vector, cipherMode = "CBC", paddingMode = "PKCS7") {
 	if (dataStr.trim().length === 0 || key.trim().length === 0 || vector.trim().length === 0) return null;
-	if (cipherMode !== "CBC" && cipherMode !== "ECB") throw new RangeError("`cipherMode` 必须是 `CBC` 或 `ECB`。");
+	assertAesCipherMode(cipherMode);
 	let padding = Pkcs7;
 	switch (paddingMode) {
 		case "None":