typespeed 2.6.2 → 2.6.4

package/CHANGELOG.md

@@ -4,6 +4,8 @@ typespeed 版本演进记录。本文件 2026-09-06 从 git 历史反推建立
 
 ## 2.6.x
 
+- **2.6.4**：官方部署清单——多阶段 `Dockerfile`（build/run 分离 + 非 root + HEALTHCHECK）；`docker-compose.yml`（app + MySQL/Redis/RabbitMQ，depends_on + healthcheck）；k8s 清单（Deployment 带 readinessProbe→`/ready`、livenessProbe→`/health` + Service + Ingress）；Helm chart（Chart/values/templates）（2026-09-07）
+- **2.6.3**：框架内建优雅停机——`ExpressServer` 存储 `httpServer` + 新增 `stop()`（Promise 化 graceful close）；SIGTERM/SIGINT 优雅停机（close 后 exit 0，30s 兜底强制退出），停机时关闭 Redis；socket 模式一并处理（2026-09-07）
 - **2.6.2**：框架内建健康检查——新增 `HealthFactory`（abstract `ready()`）+ `HealthDefault`（默认恒就绪）；`ExpressServer` 内建 `GET /health`（liveness）与 `GET /ready`（readiness，读 HealthFactory，200/503），路径可经 config 覆盖（2026-09-07）
 - **2.6.1**：Node/TS 升级——TypeScript 4.9 → 5.9.3（legacy 装饰器零改动兼容，标准装饰器双轨同步验证）；`@types/node` 对齐 22；声明 `engines`（node >=18）（2026-09-07）
 

package/dist/default/express-server.class.js

@@ -26,6 +26,10 @@ const health_factory_class_1 = require("../factory/health-factory.class");
 const redis_class_1 = require("./redis.class");
 const authentication_factory_class_1 = require("../factory/authentication-factory.class");
 class ExpressServer extends server_factory_class_1.default {
+    constructor() {
+        super(...arguments);
+        this.httpServer = null;
+    }
     getSever() {
         const server = new ExpressServer();
         server.app = express();
@@ -39,13 +43,46 @@ class ExpressServer extends server_factory_class_1.default {
             this.app.use(middleware);
         });
         this.setDefaultMiddleware();
+        let server;
         if (this.socketIoConfig) {
             const newSocketApp = socket_io_class_1.SocketIo.setIoServer(this.app, this.socketIoConfig);
-            return newSocketApp.listen(port);
+            server = newSocketApp.listen(port);
         }
         else {
-            return this.app.listen(port);
+            server = this.app.listen(port);
         }
+        this.httpServer = server;
+        this.registerGracefulShutdown();
+        return server;
+    }
+    stop() {
+        return new Promise((resolve) => {
+            if (this.httpServer) {
+                this.httpServer.close(() => resolve());
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    registerGracefulShutdown() {
+        const shutdown = (signal) => {
+            (0, core_decorator_1.log)(`received ${signal}, gracefully shutting down...`);
+            // 30 秒兜底强制退出，防止连接迟迟不关闭
+            const forceExit = setTimeout(() => {
+                (0, core_decorator_1.log)("forced shutdown after timeout");
+                process.exit(1);
+            }, 30000);
+            forceExit.unref();
+            redis_class_1.Redis.close().catch(() => { });
+            this.httpServer.close(() => {
+                clearTimeout(forceExit);
+                (0, core_decorator_1.log)("server closed");
+                process.exit(0);
+            });
+        };
+        process.on("SIGTERM", () => shutdown("SIGTERM"));
+        process.on("SIGINT", () => shutdown("SIGINT"));
     }
     setDefaultMiddleware() {
         this.app.use(express.urlencoded({ extended: true }));

package/dist/typespeed.d.ts

@@ -388,6 +388,10 @@ declare class ExpressServer extends ServerFactory {
     getSever(): ServerFactory;
     setMiddleware(middleware: any): void;
     start(port: number): void;
+    /**HTTP 服务实例（start 后可用） */
+    httpServer: any;
+    /**优雅停机：关闭 HTTP 服务（排空在途连接） */
+    stop(): Promise<void>;
     private setDefaultMiddleware;
 }
 /**Socket IO 装饰器类 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typespeed",
-  "version": "2.6.2",
+  "version": "2.6.4",
   "description": "A new Framework for TypeScript.",
   "author": "speedphp",
   "license": "MIT License",