@maiyunnet/kebab 3.2.6 → 3.2.8

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "3.2.6";
+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.6';
+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/lib/ws.js

@@ -177,11 +177,14 @@ export class Socket {
                 break;
             }
             case 'end': {
+                if (!this._ws.ended) {
+                    break;
+                }
                 cb();
                 break;
             }
             default: {
-                // --- close ---
+                // --- drain, close ---
                 if (!this._close) {
                     break;
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "3.2.6",
+  "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": [

package/sys/ctr.d.ts

@@ -111,11 +111,14 @@ export declare class Ctr {
         'timeout'?: number;
     };
     /**
-     * --- WebSocket 下当收到数据时会自动被调用的事件，即只文本和二进制数据，返回内容会被发送给 socket，但返回 false 连接会被中断 ---
+     * --- WebSocket 下当收到数据时会自动被调用的事件，即只文本和二进制数据，返回内容会被发送给 socket ---
+     * --- 但返回 false 连接会被中断，什么都不返回则什么都不做 ---
      */
     onData(data: Buffer | string, opcode: lWs.EOpcode): kebab.Json;
     /**
-     * --- 包含所有 opcode 的消息，若要发送数据需自行调用 write 方法，data 恒定为原始 buffer，返回 false 则不会执行默认方法 ---
+     * --- 包含所有 opcode 的消息，若要发送数据需自行调用 write 方法，data 恒定为原始 buffer ---
+     * --- 返回 false 则不会执行默认方法，一般请什么都不要返回 ---
+     * --- 返回 false 链接也不会中断 ---
      * @param data 数据
      * @param opcode opcode
      */

package/www/example/ctr/test.js

@@ -2790,6 +2790,9 @@ setInterval(() => {
                 ws.on('message', (frame) => {
                     echo.push('<div>Server: ' + frame.data.toString() + '.</div>');
                 });
+                ws.on('end', () => {
+                    lCore.display('CLIENT onEnd');
+                });
                 ws.on('close', () => {
                     resolve();
                 });

package/www/example/ws/test.js

@@ -7,13 +7,13 @@ export default class extends sCtr.Ctr {
         this._nick = '';
     }
     onUpgrade() {
-        lCore.debug('WebSocket test onUpgrade.');
+        lCore.display('[/test] WebSocket test onUpgrade.');
         return {
             'timeout': 60_000 * 2,
         };
     }
     onLoad() {
-        lCore.debug('WebSocket test onLoad.');
+        lCore.display('[/test] WebSocket test onLoad.');
         setTimeout(() => {
             if (!this._nick) {
                 return;
@@ -32,11 +32,11 @@ export default class extends sCtr.Ctr {
         }
         // --- 用户消息 ---
         const date = new Date();
-        lCore.debug('[' + date.getHours().toString().padStart(2, '0') + ':' + date.getMinutes().toString().padStart(2, '0') + ':' + date.getSeconds().toString().padStart(2, '0') + '] WebSocket test onData, data: ' + data);
+        lCore.display('[/test] [' + date.getHours().toString().padStart(2, '0') + ':' + date.getMinutes().toString().padStart(2, '0') + ':' + date.getSeconds().toString().padStart(2, '0') + '] WebSocket test onData, data: ' + data);
         return '<b>' + this._nick + ':</b> ' + data;
     }
     onClose() {
-        lCore.debug('WebSocket test onClose, nick: ' + this._nick);
+        lCore.display('[/test] WebSocket test onClose, nick: ' + this._nick);
         this._nick = '';
     }
 }