@maiyunnet/kebab 3.2.4 → 3.2.5

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "3.2.4";
+export declare const VER = "3.2.5";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 export declare const LIB_PATH: string;
@@ -159,10 +159,10 @@ export interface IConfigConst {
 }
 /** --- 虚拟机配置对象 --- */
 export interface IVhost {
-    readonly 'name': string;
+    readonly 'name'?: string;
     readonly 'domains': string[];
     readonly 'root': string;
-    readonly 'remark': string;
+    readonly 'remark'?: string;
 }
 /** --- 上传的文件信息对象 --- */
 export interface IPostFile {

package/index.js

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

package/lib/s3.d.ts

@@ -60,7 +60,7 @@ export declare class S3 {
      * @param key 对象路径
      * @param bucket bucket 名
      */
-    getObject(key: string, bucket?: string): Promise<false | (stream.Readable & import("@smithy/types").SdkStreamMixin) | (Blob & import("@smithy/types").SdkStreamMixin) | (ReadableStream<any> & import("@smithy/types").SdkStreamMixin) | undefined>;
+    getObject(key: string, bucket?: string): Promise<any>;
     /**
      * --- 删除对象 ---
      * @param key 对象路径

package/lib/ws.d.ts

@@ -111,7 +111,7 @@ export declare class Socket {
     end(): void;
     destroy(): void;
     /** --- 发送文本 --- */
-    writeText(data: string): boolean;
+    writeText(data: Buffer | string | Array<Buffer | string>): boolean;
     /** --- 发送结果对象字符串 --- */
     writeResult(data: kebab.Json): boolean;
     /** --- 发送二进制 --- */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "3.2.4",
+  "version": "3.2.5",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [
@@ -19,25 +19,25 @@
     "#kebab/*": "./*"
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.894.0",
-    "@aws-sdk/lib-storage": "^3.894.0",
+    "@aws-sdk/client-s3": "^3.901.0",
+    "@aws-sdk/lib-storage": "^3.903.0",
     "@litert/http-client": "^1.1.2",
     "@litert/mime": "^0.1.3",
     "@litert/redis": "^3.0.5",
-    "@litert/websocket": "^0.2.3",
+    "@litert/websocket": "^0.2.4",
     "@types/ssh2": "^1.15.5",
     "ejs": "^3.1.10",
     "jszip": "^3.10.1",
-    "mysql2": "^3.15.0",
+    "mysql2": "^3.15.1",
     "ssh2": "^1.17.0",
     "svg-captcha": "^1.4.0",
-    "tencentcloud-sdk-nodejs": "^4.1.120"
+    "tencentcloud-sdk-nodejs": "^4.1.126"
   },
   "devDependencies": {
     "@litert/eslint-plugin-rules": "^0.3.1",
     "@types/ejs": "^3.1.5",
-    "@types/node": "^24.5.2",
+    "@types/node": "^24.7.0",
     "tsc-alias": "^1.8.16",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.3"
   }
 }

package/sys/ctr.d.ts

@@ -124,6 +124,10 @@ export declare class Ctr {
      * --- WebSocket 下连接恢复可写入状态后会调用此事件，可重写此方法 ---
      */
     onDrain(): void | Promise<void>;
+    /**
+     * --- WebSocket 下连接被 end 后会自动被调用的事件，可重写此方法 ---
+     */
+    onEnd(): void | Promise<void>;
     /**
      * --- WebSocket 下连接被终止后会自动被调用的事件，可重写此方法 ---
      */
@@ -231,7 +235,7 @@ export declare class Ctr {
      * --- 发送 socket 文本 ---
      * @param data 要发送的信息
      */
-    protected _writeText(data: string): boolean;
+    protected _writeText(data: Buffer | string | Array<Buffer | string>): boolean;
     /**
      * --- 发送结果对象文本 ---
      * @param data 要发送的结果对象，如 [0, 'Failed.']

package/sys/ctr.js

@@ -163,6 +163,12 @@ export class Ctr {
     onDrain() {
         return;
     }
+    /**
+     * --- WebSocket 下连接被 end 后会自动被调用的事件，可重写此方法 ---
+     */
+    onEnd() {
+        return;
+    }
     /**
      * --- WebSocket 下连接被终止后会自动被调用的事件，可重写此方法 ---
      */

package/sys/route.js

@@ -339,6 +339,13 @@ export async function run(data) {
                         }
                     }).on('error', (e) => {
                         lCore.log(cctr, lText.stringifyJson(e.stack).slice(1, -1), '-error');
+                    }).on('end', async () => {
+                        try {
+                            await cctr['onEnd']();
+                        }
+                        catch (e) {
+                            lCore.log(cctr, lText.stringifyJson(e.stack).slice(1, -1), '-error');
+                        }
                     }).on('close', async () => {
                         try {
                             await cctr['onClose']();
@@ -476,7 +483,7 @@ export async function run(data) {
                 return true;
             }
             // --- 检测 action 是否存在，以及排除内部方法 ---
-            if (pathRight.startsWith('_') || pathRight === 'onUpgrade' || pathRight === 'onLoad' || pathRight === 'onData' || pathRight === 'onDrain' || pathRight === 'onClose' || pathRight === 'setPrototype' || pathRight === 'getPrototype' || pathRight === 'getAuthorization') {
+            if (pathRight.startsWith('_') || pathRight === 'onUpgrade' || pathRight === 'onLoad' || pathRight === 'onData' || pathRight === 'onDrain' || pathRight === 'onEnd' || pathRight === 'onClose' || pathRight === 'setPrototype' || pathRight === 'getPrototype' || pathRight === 'getAuthorization') {
                 // --- _ 开头的 action 是内部方法，不允许访问 ---
                 if (config.route['#404']) {
                     data.res.setHeader('location', lText.urlResolve(config.const.urlBase, config.route['#404']));