typespeed 2.5.2 → 2.6.1

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 typespeed 版本演进记录。本文件 2026-09-06 从 git 历史反推建立；git 最早提交 2022-09-18（ch01）。
 
+## 2.6.x
+
+- **2.6.1**：Node/TS 升级——TypeScript 4.9 → 5.9.3（legacy 装饰器零改动兼容，标准装饰器双轨同步验证）；`@types/node` 对齐 22；声明 `engines`（node >=18）（2026-09-07）
+
 ## 2.5.x
 
 - **2.5.2**：README 重写（专业丰富版：30+ 装饰器分类、书籍体系突出）+ 新增英文版 `README.en.md`（中英切换，默认中文）（2026-09-07）

package/dist/bind.decorator.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBindMapping = exports.bind = void 0;
+exports.bind = bind;
+exports.getBindMapping = getBindMapping;
 const decorator_utils_1 = require("./decorator-utils");
 /**
  * 方法级参数绑定注册表：key = `[className, methodName]`，value = 绑定声明。
@@ -42,9 +43,7 @@ function bind(mapping) {
         bindParamMap.set([target.constructor.name, propertyKey].toString(), mapping);
     };
 }
-exports.bind = bind;
 /** 读取某方法上的 @bind 声明（route/database 内部使用） */
 function getBindMapping(className, methodName) {
     return bindParamMap.get([className, methodName].toString());
 }
-exports.getBindMapping = getBindMapping;

package/dist/core.decorator.js

@@ -1,6 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.schedule = exports.getComponent = exports.getBean = exports.autoware = exports.error = exports.logx = exports.log = exports.resource = exports.bean = exports.component = void 0;
+exports.component = component;
+exports.bean = bean;
+exports.resource = resource;
+exports.log = log;
+exports.logx = logx;
+exports.error = error;
+exports.autoware = autoware;
+exports.getBean = getBean;
+exports.getComponent = getComponent;
+exports.schedule = schedule;
 require("reflect-metadata");
 const cron = require("cron");
 const log_factory_class_1 = require("./factory/log-factory.class");
@@ -19,11 +28,9 @@ function component(...args) {
     const constructorFunction = args[0];
     objectMapper.set(constructorFunction.name, new constructorFunction());
 }
-exports.component = component;
 function getComponent(constructorFunction) {
     return objectMapper.get(constructorFunction.name);
 }
-exports.getComponent = getComponent;
 function bean(...args) {
     if (args.length >= 2) {
         // 直接装饰器形式：@bean（无 token，走 legacy design:returntype）
@@ -32,7 +39,6 @@ function bean(...args) {
     // 工厂形式：@bean(Token)（显式返回类型 token，标准模式必需）
     return beanWithToken(args[0]);
 }
-exports.bean = bean;
 function beanWithToken(token) {
     return function (...args) {
         if ((0, decorator_utils_1.isStd)(args)) {
@@ -59,7 +65,6 @@ function getBean(mappingClass) {
     const bean = beanMapper.get(mappingClass.name);
     return bean["factory"];
 }
-exports.getBean = getBean;
 function autoware(...args) {
     if (args.length >= 2) {
         // 直接装饰器形式：@autoware（无 token，走 legacy design:type）
@@ -68,7 +73,6 @@ function autoware(...args) {
     // 工厂形式：@autoware(Token)（显式 token，标准模式必需）
     return autowareWithToken(args[0]);
 }
-exports.autoware = autoware;
 function autowareWithToken(token) {
     return function (...args) {
         if ((0, decorator_utils_1.isStd)(args)) {
@@ -138,7 +142,6 @@ function resource(...args) {
         });
     };
 }
-exports.resource = resource;
 function log(message, ...optionalParams) {
     const logObject = beanMapper.get(log_factory_class_1.default.name);
     if (logObject) {
@@ -148,7 +151,6 @@ function log(message, ...optionalParams) {
         console.log(message, ...optionalParams);
     }
 }
-exports.log = log;
 function logx(message) {
     message = JSON.stringify(message);
     const logObject = beanMapper.get(log_factory_class_1.default.name);
@@ -159,7 +161,6 @@ function logx(message) {
         console.log(message);
     }
 }
-exports.logx = logx;
 function error(message, ...optionalParams) {
     const logObject = beanMapper.get(log_factory_class_1.default.name);
     if (logObject) {
@@ -169,7 +170,6 @@ function error(message, ...optionalParams) {
         console.error(message, ...optionalParams);
     }
 }
-exports.error = error;
 function schedule(cronTime) {
     return (...args) => {
         if ((0, decorator_utils_1.isStd)(args)) {
@@ -184,4 +184,3 @@ function schedule(cronTime) {
         new cron.CronJob(cronTime, target[propertyKey]).start();
     };
 }
-exports.schedule = schedule;

package/dist/database.decorator.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Model = exports.cache = exports.resultType = exports.param = exports.select = exports.remove = exports.update = exports.insert = void 0;
+exports.Model = void 0;
+exports.insert = insert;
+exports.update = update;
+exports.remove = remove;
+exports.select = select;
+exports.param = param;
+exports.resultType = resultType;
+exports.cache = cache;
 const core_decorator_1 = require("./core.decorator");
 const decorator_utils_1 = require("./decorator-utils");
 const bind_decorator_1 = require("./bind.decorator");
@@ -38,7 +45,6 @@ function insert(sql) {
         };
     };
 }
-exports.insert = insert;
 function update(sql) {
     return (...args) => {
         if ((0, decorator_utils_1.isStd)(args)) {
@@ -66,7 +72,6 @@ function update(sql) {
         };
     };
 }
-exports.update = update;
 function remove(sql) {
     return (...args) => {
         if ((0, decorator_utils_1.isStd)(args)) {
@@ -94,7 +99,6 @@ function remove(sql) {
         };
     };
 }
-exports.remove = remove;
 function select(sql) {
     return (...args) => {
         if ((0, decorator_utils_1.isStd)(args)) {
@@ -144,7 +148,6 @@ function select(sql) {
         };
     };
 }
-exports.select = select;
 function resultType(dataClass) {
     return function (...args) {
         if ((0, decorator_utils_1.isStd)(args)) {
@@ -160,7 +163,6 @@ function resultType(dataClass) {
         //never return
     };
 }
-exports.resultType = resultType;
 function param(name) {
     return function (target, propertyKey, parameterIndex) {
         const existingParameters = Reflect.getOwnMetadata(paramMetadataKey, target, propertyKey) || [];
@@ -168,7 +170,6 @@ function param(name) {
         Reflect.defineMetadata(paramMetadataKey, existingParameters, target, propertyKey);
     };
 }
-exports.param = param;
 async function queryForExecute(sql, args, target, propertyKey) {
     const [newSql, sqlValues] = convertSQLParams(sql, target, propertyKey, args);
     return actionExecute(newSql, sqlValues);
@@ -255,7 +256,6 @@ function cache(ttl) {
         }
     };
 }
-exports.cache = cache;
 function getTableAndVersion(name, sql) {
     const regExpMap = {
         insert: /insert\sinto\s+([\w`\'\"]+)/i,

package/dist/decorator-utils.js

@@ -12,7 +12,8 @@
  * 因此库可以单份源码、运行时按签名形态分流：legacy 分支逻辑与 2.4.x 逐字一致，标准分支为新增。
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getStdArgs = exports.isStd = void 0;
+exports.isStd = isStd;
+exports.getStdArgs = getStdArgs;
 /**
  * 判断装饰器收到的运行时参数是否为标准装饰器签名 (value, context)。
  *
@@ -31,7 +32,6 @@ function isStd(args) {
         && args[1] !== null
         && typeof args[1].kind === "string";
 }
-exports.isStd = isStd;
 /**
  * 从标准装饰器参数中解出 (value, context)。
  * 仅应在 isStd(args) 为 true 时调用。
@@ -39,4 +39,3 @@ exports.isStd = isStd;
 function getStdArgs(args) {
     return [args[0], args[1]];
 }
-exports.getStdArgs = getStdArgs;

package/dist/default/default-authentication.class.js

@@ -16,10 +16,10 @@ class DefaultAuthentication extends authentication_factory_class_1.default {
         return new DefaultAuthentication();
     }
 }
+exports.default = DefaultAuthentication;
 __decorate([
     core_decorator_1.bean,
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", authentication_factory_class_1.default)
 ], DefaultAuthentication.prototype, "getAuthentication", null);
-exports.default = DefaultAuthentication;

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

@@ -115,6 +115,7 @@ class ExpressServer extends server_factory_class_1.default {
         });
     }
 }
+exports.default = ExpressServer;
 __decorate([
     (0, typespeed_1.value)("view"),
     __metadata("design:type", String)
@@ -165,4 +166,3 @@ __decorate([
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", server_factory_class_1.default)
 ], ExpressServer.prototype, "getSever", null);
-exports.default = ExpressServer;

package/dist/default/log-default.class.js

@@ -16,10 +16,10 @@ class LogDefault extends log_factory_class_1.default {
         return new LogDefault();
     }
 }
+exports.default = LogDefault;
 __decorate([
     core_decorator_1.bean,
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", log_factory_class_1.default)
 ], LogDefault.prototype, "createLog", null);
-exports.default = LogDefault;

package/dist/default/node-cache.class.js

@@ -38,6 +38,7 @@ class NodeCache extends cache_factory_class_1.default {
         this.NodeCache.flushAll();
     }
 }
+exports.default = NodeCache;
 __decorate([
     (0, typespeed_1.value)("cache"),
     __metadata("design:type", Object)
@@ -48,4 +49,3 @@ __decorate([
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", cache_factory_class_1.default)
 ], NodeCache.prototype, "getNodeCache", null);
-exports.default = NodeCache;

package/dist/default/rabbitmq.class.js

@@ -9,7 +9,8 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rabbitListener = exports.RabbitMQ = void 0;
+exports.RabbitMQ = void 0;
+exports.rabbitListener = rabbitListener;
 const core_decorator_1 = require("../core.decorator");
 const typespeed_1 = require("../typespeed");
 const amqplib_1 = require("amqplib");
@@ -41,13 +42,13 @@ class RabbitMQ {
         await this.sendMessageToQueue(queue, message);
     }
 }
+exports.RabbitMQ = RabbitMQ;
 __decorate([
     core_decorator_1.bean,
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", RabbitMQ)
 ], RabbitMQ.prototype, "getRabbitMQ", null);
-exports.RabbitMQ = RabbitMQ;
 async function getChannel() {
     if (rabbitConnection === null) {
         rabbitConnection = await (0, amqplib_1.connect)((0, typespeed_1.config)("rabbitmq"));
@@ -84,4 +85,3 @@ function rabbitListener(queue) {
         }());
     };
 }
-exports.rabbitListener = rabbitListener;

package/dist/default/read-write-db.class.js

@@ -57,10 +57,10 @@ class ReadWriteDb extends data_source_factory_class_1.default {
         return this.writeSession;
     }
 }
+exports.default = ReadWriteDb;
 __decorate([
     core_decorator_1.bean,
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", data_source_factory_class_1.default)
 ], ReadWriteDb.prototype, "getDataSource", null);
-exports.default = ReadWriteDb;

package/dist/default/redis.class.js

@@ -9,7 +9,8 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.redisSubscriber = exports.Redis = void 0;
+exports.Redis = void 0;
+exports.redisSubscriber = redisSubscriber;
 const core_decorator_1 = require("../core.decorator");
 const ioredis_1 = require("ioredis");
 const typespeed_1 = require("../typespeed");
@@ -57,6 +58,7 @@ class Redis extends ioredis_1.default {
         }
     }
 }
+exports.Redis = Redis;
 Redis.pubObj = null;
 Redis.subObj = null;
 __decorate([
@@ -65,7 +67,6 @@ __decorate([
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", Redis)
 ], Redis.prototype, "getRedis", null);
-exports.Redis = Redis;
 function redisSubscriber(channel) {
     if (!(0, typespeed_1.config)("redis"))
         return function () {
@@ -95,7 +96,6 @@ function redisSubscriber(channel) {
         };
     };
 }
-exports.redisSubscriber = redisSubscriber;
 if ((0, typespeed_1.config)("redis")) {
     Redis.getInstanceOfRedis("sub").on("message", async function (channel, message) {
         await (0, core_decorator_1.getComponent)(redisSubscribers[channel].target.constructor)[redisSubscribers[channel].propertyKey](message);

package/dist/route.decorator.js

@@ -1,6 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.jwt = exports.upload = exports.setRouter = exports.requestMapping = exports.postMapping = exports.getMapping = exports.after = exports.before = exports.response = exports.res = exports.request = exports.req = exports.reqParam = exports.reqForm = exports.reqQuery = exports.reqBody = exports.next = void 0;
+exports.requestMapping = exports.postMapping = exports.getMapping = void 0;
+exports.next = next;
+exports.reqBody = reqBody;
+exports.reqQuery = reqQuery;
+exports.reqForm = reqForm;
+exports.reqParam = reqParam;
+exports.req = req;
+exports.request = req;
+exports.res = res;
+exports.response = res;
+exports.before = before;
+exports.after = after;
+exports.setRouter = setRouter;
+exports.upload = upload;
+exports.jwt = jwt;
 const multiparty = require("multiparty");
 const express_jwt_1 = require("express-jwt");
 const core_decorator_1 = require("./core.decorator");
@@ -28,7 +42,6 @@ function setRouter(app) {
         }
     });
 }
-exports.setRouter = setRouter;
 function mapperFunction(method, value) {
     return (...args) => {
         if ((0, decorator_utils_1.isStd)(args)) {
@@ -137,7 +150,6 @@ function upload(...args) {
         routerMiddleware[key] = [uploadMiddleware];
     }
 }
-exports.upload = upload;
 function uploadMiddleware(req, res, next) {
     const form = new multiparty.Form();
     form.parse(req, (err, fields, files) => {
@@ -171,7 +183,6 @@ function jwt(jwtConfig) {
         }
     };
 }
-exports.jwt = jwt;
 function before(constructorFunction, methodName) {
     const targetBean = (0, core_decorator_1.getComponent)(constructorFunction);
     return function (...args) {
@@ -206,7 +217,6 @@ function before(constructorFunction, methodName) {
         });
     };
 }
-exports.before = before;
 function after(constructorFunction, methodName) {
     const targetBean = (0, core_decorator_1.getComponent)(constructorFunction);
     return function (...args) {
@@ -243,35 +253,27 @@ function after(constructorFunction, methodName) {
         });
     };
 }
-exports.after = after;
 function req(target, propertyKey, parameterIndex) {
     const key = [target.constructor.name, propertyKey, parameterIndex].toString();
     routerParams[key] = (req, res, next) => req;
 }
-exports.req = req;
-exports.request = req;
 function res(target, propertyKey, parameterIndex) {
     const key = [target.constructor.name, propertyKey, parameterIndex].toString();
     routerParams[key] = (req, res, next) => res;
 }
-exports.res = res;
-exports.response = res;
 function next(target, propertyKey, parameterIndex) {
     const key = [target.constructor.name, propertyKey, parameterIndex].toString();
     routerParams[key] = (req, res, next) => next;
 }
-exports.next = next;
 function reqBody(target, propertyKey, parameterIndex) {
     const key = [target.constructor.name, propertyKey, parameterIndex].toString();
     routerParams[key] = (req, res, next) => req.body;
 }
-exports.reqBody = reqBody;
 function reqParam(target, propertyKey, parameterIndex) {
     const key = [target.constructor.name, propertyKey, parameterIndex].toString();
     const paramName = getParamInFunction(target[propertyKey], parameterIndex);
     routerParams[key] = (req, res, next) => req.params[paramName];
 }
-exports.reqParam = reqParam;
 function getParamInFunction(fn, index) {
     const code = fn.toString().replace(/((\/\/.*$)|(\/\*[\s\S]*?\*\/))/mg, '').replace(/=>.*$/mg, '').replace(/=[^,]+/mg, '');
     const result = code.slice(code.indexOf('(') + 1, code.indexOf(')')).match(/([^\s,]+)/g);
@@ -330,14 +332,12 @@ function reqQuery(target, propertyKey, parameterIndex) {
     const paramName = getParamInFunction(target[propertyKey], parameterIndex);
     routerParams[key] = (req, res, next) => req.query[paramName];
 }
-exports.reqQuery = reqQuery;
 function reqForm(paramName) {
     return (target, propertyKey, parameterIndex) => {
         const key = [target.constructor.name, propertyKey, parameterIndex].toString();
         routerParams[key] = (req, res, next) => req.body[paramName];
     };
 }
-exports.reqForm = reqForm;
 const getMapping = (value) => mapperFunction("get", value);
 exports.getMapping = getMapping;
 const postMapping = (value) => mapperFunction("post", value);

package/dist/typespeed.js

@@ -14,7 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReadWriteDb = exports.redisSubscriber = exports.Redis = exports.NodeCache = exports.LogDefault = exports.ExpressServer = exports.AuthenticationFactory = exports.ServerFactory = exports.DataSourceFactory = exports.CacheFactory = exports.LogFactory = exports.config = exports.value = exports.app = void 0;
+exports.ReadWriteDb = exports.redisSubscriber = exports.Redis = exports.NodeCache = exports.LogDefault = exports.ExpressServer = exports.AuthenticationFactory = exports.ServerFactory = exports.DataSourceFactory = exports.CacheFactory = exports.LogFactory = void 0;
+exports.app = app;
+exports.value = value;
+exports.config = config;
 require("reflect-metadata");
 const fs = require("fs");
 const path = require("path");
@@ -44,20 +47,18 @@ function app(...args) {
     }
     startApp(args[0]);
 }
-exports.app = app;
 function startApp(constructor) {
     const coreFiles = walkSync(corePath, { globs: ['**/*.ts'], ignore: ['**/*.d.ts', 'scaffold/**'] });
     const mainFiles = walkSync(mainPath, { globs: ['**/*.ts'] });
     (async function () {
-        var _a, _b;
         try {
             for (let p of coreFiles) {
                 let moduleName = p.replace(".d.ts", "").replace(".ts", "");
-                await (_a = corePath + "/" + moduleName, Promise.resolve().then(() => require(_a)));
+                await Promise.resolve(`${corePath + "/" + moduleName}`).then(s => require(s));
             }
             for (let p of mainFiles) {
                 let moduleName = p.replace(".d.ts", "").replace(".ts", "");
-                await (_b = mainPath + "/" + moduleName, Promise.resolve().then(() => require(_b)));
+                await Promise.resolve(`${mainPath + "/" + moduleName}`).then(s => require(s));
             }
         }
         catch (err) {
@@ -71,7 +72,6 @@ function startApp(constructor) {
 function config(node) {
     return globalConfig[node] || null;
 }
-exports.config = config;
 function value(configPath) {
     return function (...args) {
         if ((0, decorator_utils_1.isStd)(args)) {
@@ -111,7 +111,6 @@ function value(configPath) {
         }
     };
 }
-exports.value = value;
 function getRootPath(lines) {
     // 兼容新旧 Node 栈帧（Node<22: "Function.Module._load" / Node22+: "Function._load"）、
     // mocha(ts-node) 下 "Context.<anonymous>" 与中间可能插入的 "wrapModuleLoad" 帧：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typespeed",
-  "version": "2.5.2",
+  "version": "2.6.1",
   "description": "A new Framework for TypeScript.",
   "author": "speedphp",
   "license": "MIT License",
@@ -13,6 +13,9 @@
     "prebuild": "rm -rf dist"
   },
   "main": "dist/typespeed.js",
+  "engines": {
+    "node": ">=18"
+  },
   "files": [
     "dist",
     "CHANGELOG.md",
@@ -62,13 +65,13 @@
   "devDependencies": {
     "@types/express": "^4.17.13",
     "@types/mocha": "^10.0.1",
-    "@types/node": "^18.19.3",
+    "@types/node": "^22.0.0",
     "chai": "4.3.7",
     "chai-http": "^4.4.0",
     "mocha": "10.2.0",
     "nyc": "^15.1.0",
     "socket.io-client": "4.7.1",
     "ts-node": "^10.9.1",
-    "typescript": "^4.9.5"
+    "typescript": "^5.9.3"
   }
 }