@maiyunnet/kebab 3.2.7 → 3.2.8

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "3.2.7";
+export declare const VER = "3.2.8";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 export declare const LIB_PATH: string;

package/index.js

@@ -6,7 +6,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export const VER = '3.2.7';
+export const VER = '3.2.8';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */

package/lib/crypto.d.ts

@@ -58,9 +58,13 @@ export declare function publicDecrypt(key: crypto.RsaPublicKey | crypto.RsaPriva
  * @param buffer 数据
  */
 export declare function privateDecrypt(key: crypto.RsaPrivateKey | crypto.KeyLike, buffer: NodeJS.ArrayBufferView | string): Buffer;
+/** --- 勿使用，无 iv 默认，但勿使用 --- */
 export declare const AES_256_ECB = "aes-256-ecb";
+/** --- 一般不用，兼容性场景下用 --- */
 export declare const AES_256_CBC = "aes-256-cbc";
-export declare const AES_256_CFB = "aes-256-cfb";
+/** --- 设置 iv 会自动切换为 CTR，流式下使用，非流直接使用 GCM --- */
+export declare const AES_256_CTR = "aes-256-ctr";
+/** --- 非流直接使用 GCM --- */
 export declare const AES_256_GCM = "aes-256-gcm";
 export declare const SM4_ECB = "sm4-ecb";
 export declare const SM4_CBC = "sm4-cbc";
@@ -69,7 +73,7 @@ export declare const SM4_CFB = "sm4-cfb";
  * --- cipher 加密，强烈不建议使用 AES_256_ECB ---
  * @param original 原始字符串
  * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16(CFB) 或 12(GCM) 个英文字母和数字
+ * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
  * @param method 加密方法
  */
 export declare function cipherEncrypt(original: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'base64' | 'buffer'): string | Buffer | false;
@@ -83,7 +87,7 @@ export declare function sm4Encrypt(original: string | Buffer, key: crypto.Cipher
  * --- cipher 解密 ---
  * @param encrypt 需解密的字符串
  * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16(CFB) 或 12(GCM) 个英文字母和数字
+ * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
  * @param method 加密方法
  */
 export declare function cipherDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'binary' | 'buffer'): string | Buffer | false;

package/lib/crypto.js

@@ -96,10 +96,14 @@ export function privateDecrypt(key, buffer) {
     return crypto.privateDecrypt(key, buffer);
 }
 // --- Cipher (AES/SM4...) 加/解密 ---
-export const AES_256_ECB = 'aes-256-ecb'; // --- 如果未设置 iv，则默认这个，但强烈不建议 ---
+/** --- 勿使用，无 iv 默认，但勿使用 --- */
+export const AES_256_ECB = 'aes-256-ecb';
+/** --- 一般不用，兼容性场景下用 --- */
 export const AES_256_CBC = 'aes-256-cbc';
-export const AES_256_CFB = 'aes-256-cfb'; // --- 设置 iv，自动就切换成了这个 ---
-export const AES_256_GCM = 'aes-256-gcm'; // --- 强烈建议使用这个 ---
+/** --- 设置 iv 会自动切换为 CTR，流式下使用，非流直接使用 GCM --- */
+export const AES_256_CTR = 'aes-256-ctr';
+/** --- 非流直接使用 GCM --- */
+export const AES_256_GCM = 'aes-256-gcm';
 export const SM4_ECB = 'sm4-ecb'; // --- SM4 如果未设置 iv，则默认这个 ---
 export const SM4_CBC = 'sm4-cbc';
 export const SM4_CFB = 'sm4-cfb'; // --- SM4 一般用这个，设置 iv，自动就切换成了这个 ---
@@ -107,7 +111,7 @@ export const SM4_CFB = 'sm4-cfb'; // --- SM4 一般用这个，设置 iv，自
  * --- cipher 加密，强烈不建议使用 AES_256_ECB ---
  * @param original 原始字符串
  * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16(CFB) 或 12(GCM) 个英文字母和数字
+ * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
  * @param method 加密方法
  */
 export function cipherEncrypt(original, key, iv = '', method = AES_256_ECB, output = 'base64') {
@@ -116,7 +120,7 @@ export function cipherEncrypt(original, key, iv = '', method = AES_256_ECB, outp
             key = hashHmac('md5', key, 'MaiyunSalt');
         }
         if (iv) {
-            if (method === AES_256_CFB) {
+            if (method === AES_256_CTR) {
                 if (iv.length !== 16) {
                     return false;
                 }
@@ -165,13 +169,13 @@ export function cipherEncrypt(original, key, iv = '', method = AES_256_ECB, outp
  * --- AES 加密 ---
  * @param original 原始字符串
  * @param key 密钥尽量 32 个英文字母和数字，不是 32 个系统会自动处理
- * @param iv 向量 16 个英文字母和数字
+ * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
  * @param method 加密方法
  * @param output 输出类型
  */
 export function aesEncrypt(original, key, iv = '', method = AES_256_ECB, output = 'base64') {
     if (iv !== '') {
-        method = method === AES_256_ECB ? AES_256_CFB : method;
+        method = method === AES_256_ECB ? AES_256_CTR : method;
     }
     return cipherEncrypt(original, key, iv, method, output);
 }
@@ -206,7 +210,7 @@ export function sm4Encrypt(original, key, iv = '', method = SM4_ECB, output = 'b
  * --- cipher 解密 ---
  * @param encrypt 需解密的字符串
  * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16(CFB) 或 12(GCM) 个英文字母和数字
+ * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
  * @param method 加密方法
  */
 export function cipherDecrypt(encrypt, key, iv = '', method = AES_256_ECB, output = 'binary') {
@@ -215,7 +219,7 @@ export function cipherDecrypt(encrypt, key, iv = '', method = AES_256_ECB, outpu
             key = hashHmac('md5', key, 'MaiyunSalt');
         }
         if (iv) {
-            if (method === AES_256_CFB) {
+            if (method === AES_256_CTR) {
                 if (iv.length !== 16) {
                     return false;
                 }
@@ -268,12 +272,12 @@ export function cipherDecrypt(encrypt, key, iv = '', method = AES_256_ECB, outpu
  * --- AES 解密 ---
  * @param encrypt 需解密的字符串
  * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16 个英文字母和数字
+ * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
  * @param method 加密方法
  */
 export function aesDecrypt(encrypt, key, iv = '', method = AES_256_ECB, output = 'binary') {
     if (iv !== '') {
-        method = method === AES_256_ECB ? AES_256_CFB : method;
+        method = method === AES_256_ECB ? AES_256_CTR : method;
     }
     return cipherDecrypt(encrypt, key, iv, method, output);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "3.2.7",
+  "version": "3.2.8",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [