typespeed 2.5.0 → 2.5.2

package/CHANGELOG.md

@@ -4,6 +4,8 @@ typespeed 版本演进记录。本文件 2026-09-06 从 git 历史反推建立
 
 ## 2.5.x
 
+- **2.5.2**：README 重写（专业丰富版：30+ 装饰器分类、书籍体系突出）+ 新增英文版 `README.en.md`（中英切换，默认中文）（2026-09-07）
+- **2.5.1**：补全 `default/` 族装饰器双签名（`rabbitListener` / `redisSubscriber` / `SocketIo.onEvent`/`onError`/`onDisconnect`/`onConnected`）；打包瘦身（`files` 白名单 108→31 文件）；`npm pkg fix` 修正 bin 字段；修正 `redisSubscriber` 的 d.ts 签名（2026-09-07）
 - **2.5.0**：装饰器双轨——支持 TC39 标准装饰器（Stage 2.7），legacy 装饰器零破坏。单份源码运行时双签名感知（`isStd` 判据），覆盖 core/route/database 三族 + 入口 `app`/`value`；新增方法级 `@bind` 装饰器（route 参数名→来源、database 占位符→索引，替代标准模式删除的参数装饰器）；`@autoware`/`@resource`/`@bean` 支持显式 token（标准模式无 `design:type`）；类型声明宽松化；新增标准模式示例 `introduction/decorator-next/` + `isStd` 单测（2026-09-07）
 
 ## 2.4.x

package/README.en.md

@@ -0,0 +1,169 @@
+<p align="center">
+  <h1 align="center">TypeSpeed</h1>
+  <p align="center">A decorator-driven TypeScript web framework — build web services declaratively with decorators</p>
+</p>
+
+<p align="center">
+  <a href="README.md">简体中文</a> · <b>English</b>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/typespeed"><img src="https://badgen.net/npm/v/typespeed?color=cyan" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/typespeed"><img src="https://badgen.net/npm/dt/typespeed?color=pink" alt="npm downloads"></a>
+  <a href="https://github.com/speedphp/typespeed/blob/main/LICENSE"><img src="https://badgen.net/github/license/speedphp/typespeed" alt="license"></a>
+  <a href="https://github.com/speedphp/typespeed/actions"><img src="https://img.shields.io/github/actions/workflow/status/speedphp/typespeed/test.yml?label=CI" alt="build"></a>
+  <a href="https://badgen.net/badge/icon/TypeScript?icon=typescript&label"><img src="https://badgen.net/badge/icon/TypeScript?icon=typescript&label" alt="TypeScript"></a>
+</p>
+
+---
+
+TypeSpeed is a **web framework written in TypeScript**, built on top of [Express](https://expressjs.com/). It organizes your application declaratively through **decorators** — dependency injection, routing, database, caching, authentication, and message queues are all declared with decorators, with zero configuration to start.
+
+> 📖 The companion book **《TypeScript 框架开发实践（微课视频版）》(TypeScript Framework Development in Practice, Tsinghua University Press)** systematically explains the design and implementation of this framework, taking you from zero to building a framework.
+
+---
+
+## ✨ Features
+
+### 🎯 Decorator-Driven
+Provides **30+ decorators** covering the full spectrum of web development — object management, web routing, parameter binding, database operations, caching, authentication, message queues, and sockets. One annotation, one feature:
+
+| Category | Decorators | Description |
+|---|---|---|
+| **Object management** | `@component` `@bean` `@autoware` `@resource` | Component registration & dependency injection |
+| **Web routing** | `@getMapping` `@postMapping` `@requestMapping` | REST route declaration |
+| **Route parameters** | `@req` `@res` `@next` `@reqBody` `@reqParam` `@reqQuery` `@reqForm` | Request parameter injection |
+| **AOP** | `@before` `@after` | Before / after interception |
+| **Database** | `@insert` `@update` `@remove` `@select` `@param` `@resultType` `@cache` | Declarative SQL operations |
+| **Security / upload** | `@jwt` `@upload` | JWT authentication, file upload |
+| **Scheduling / config** | `@schedule` `@value` `@config` | Scheduled tasks, config injection |
+| **Messaging / cache** | `@rabbitListener` `@redisSubscriber` | MQ listener, Redis subscriber |
+| **Socket.IO** | `@SocketIo.onEvent` `@onConnected` `@onDisconnect` `@onError` | Real-time communication events |
+| **Parameter binding** (2.5+) | `@bind` | Method-level parameter binding under standard decorators |
+
+### 🧩 Core Mechanisms
+- **Dependency Injection (DI)**: `@autoware` / `@resource` auto-inject instances, `@bean` provides factory methods, with explicit token support (standard decorator mode)
+- **AOP**: `@before` / `@after` intercept methods non-invasively
+- **Middleware**: pluggable middleware chain + global authentication (`AuthenticationFactory`)
+- **Startup scanning**: automatically scans core and application modules, zero-config startup
+
+### 🗄️ Database (two styles)
+- **Decorator style**: `@select("SQL")` + `@param` / `@resultType` / `@cache` — declarative SQL execution, result type mapping, automatic caching
+- **Model ORM style**: extend `Model` — `findAll` / `find` / `create` / `update` / `delete` / `findCount` / `incr` / `decr` / `pager`, chainable queries, condition building, pagination
+
+### 🔌 Built-in Components
+- **Cache**: `NodeCache` (in-memory) + Redis (extensible via `CacheFactory`)
+- **Message queue**: RabbitMQ wrapper (`RabbitMQ` / `@rabbitListener`)
+- **Redis**: connection management + `@redisSubscriber` + leaderboards (`zranking` / `zrevranking`)
+- **Socket.IO**: event decorators + rooms + connection management
+- **Session / static / templates / upload**: session (Redis store), static assets, multi template engines (consolidate), file upload
+
+### 🚀 Standard Decorator Dual-Track (2.5+)
+Supports both **legacy decorators** (`experimentalDecorators: true`, the book's style) and **TC39 standard decorators** (Stage 2.7, `experimentalDecorators: false`), auto-detected at runtime from a single codebase — legacy code works unchanged.
+
+---
+
+## 📦 Quick Start
+
+**Requirements**: Node.js 16+ (18/20/22 recommended), TypeScript.
+
+```bash
+# 1. Install the CLI globally
+npm install typespeed -g
+
+# 2. Create a project (zero config)
+typespeed new blog
+cd blog
+
+# 3. Install dependencies and start
+npm install
+npm run start
+```
+
+---
+
+## 📝 Example
+
+A minimal example combining component, routing, database, and caching:
+
+```typescript
+import { component, app, autoware, getMapping, insert, select, resultType, cache, CacheFactory, ServerFactory } from "typespeed";
+
+// Component (service)
+@component
+class UserService {
+
+    // Dependency injection
+    @autoware
+    private cacheBean: CacheFactory;
+
+    // Route + parameter injection
+    @getMapping("/user/:id")
+    async getUser(@reqParam id: number, @res res) {
+        res.json({ id, name: "typespeed" });
+    }
+
+    // Database: declarative SQL
+    @insert("Insert into `user` (id, name) values (#{id}, #{name})")
+    async addUser(@param("id") id: number, @param("name") name: string) {}
+
+    // Query + result type mapping + caching
+    @cache(1800)
+    @select("Select * from `user` where id = #{id}")
+    @resultType(UserDto)
+    async findUser(@param("id") id: number): Promise<UserDto[]> { return; }
+}
+
+// Application entry: @app auto-starts main()
+@app
+class Main {
+    @autoware
+    private server: ServerFactory;
+
+    main() {
+        this.server.start(8081);
+    }
+}
+```
+
+> See the [`app/`](https://github.com/speedphp/typespeed/tree/main/app) directory and the book's companion source for more complete examples.
+
+---
+
+## 📚 Learning Resources
+
+TypeSpeed is not just a framework — it comes with a complete **"book + video + dual source code" learning system**:
+
+| Resource | Description | Link |
+|---|---|---|
+| 📖 **Book** | 《TypeScript 框架开发实践（微课视频版）》by 曾振中, Tsinghua University Press | [JD.com](https://item.jd.com/14275373.html) |
+| 🎬 **Video course** | Accompanying micro-lecture videos, one source snapshot per lesson | Bundled with the book |
+| 📂 **Book source · ts-book** | Organized by chapter (chapter01~chapter06), runnable examples per chapter | [github.com/speedphp/ts-book](https://github.com/speedphp/ts-book) |
+| 🏷️ **Video code · ts-practice** | Tagged by book section number (e.g. `4.10.4` = Chapter 4, Section 10, Step 4), one runnable snapshot per lesson | [github.com/speedphp/ts-practice](https://github.com/speedphp/ts-practice) |
+
+> To learn the framework's design and implementation systematically, start with the book + ts-book; to follow along hands-on, use ts-practice.
+
+---
+
+## 🗺️ Roadmap
+
+| Version | Content | Status |
+|---|---|---|
+| 2.4.x | Documentation revival, CI modernization, all tests green | ✅ Released |
+| 2.5.x | **Standard decorator dual-track** (TC39 Stage 2.7) + `@bind` + explicit token | ✅ Released (latest) |
+| 2.6.x | Node/TS upgrade + health checks + graceful shutdown + Docker/k8s manifests | 🚧 In progress |
+
+---
+
+## 🤝 Contributing
+
+Issues and pull requests are welcome. Development and testing:
+
+```bash
+npm run build   # compile
+npm test        # test (requires MySQL / Redis / RabbitMQ)
+```
+
+## 📄 License
+
+[MIT](LICENSE) © [speedphp](https://github.com/speedphp)

package/README.md

@@ -1,83 +1,169 @@
-# TypeSpeed Framework
+<p align="center">
+  <h1 align="center">TypeSpeed</h1>
+  <p align="center">一个装饰器驱动的 TypeScript Web 框架 —— 用声明式装饰器，快速构建 Web 服务</p>
+</p>
 
+<p align="center">
+  <b>简体中文</b> · <a href="README.en.md">English</a>
+</p>
 
+<p align="center">
+  <a href="https://www.npmjs.com/package/typespeed"><img src="https://badgen.net/npm/v/typespeed?color=cyan" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/typespeed"><img src="https://badgen.net/npm/dt/typespeed?color=pink" alt="npm downloads"></a>
+  <a href="https://github.com/speedphp/typespeed/blob/main/LICENSE"><img src="https://badgen.net/github/license/speedphp/typespeed" alt="license"></a>
+  <a href="https://github.com/speedphp/typespeed/actions"><img src="https://img.shields.io/github/actions/workflow/status/speedphp/typespeed/test.yml?label=CI" alt="build"></a>
+  <a href="https://badgen.net/badge/icon/TypeScript?icon=typescript&label"><img src="https://badgen.net/badge/icon/TypeScript?icon=typescript&label" alt="TypeScript"></a>
+</p>
 
-![typescript](https://badgen.net/badge/icon/TypeScript?icon=typescript\&label)
+---
 
+TypeSpeed 是一个 **TypeScript 编写的 Web 框架**，底层基于 [Express](https://expressjs.com/)，通过**装饰器**以声明式的方式组织你的应用——依赖注入、路由、数据库、缓存、鉴权、消息队列，全部用装饰器声明，零配置启动。
 
+> 📖 配套图书 **《TypeScript 框架开发实践（微课视频版）》**（曾振中 著，清华大学出版社）系统讲解本框架的设计与实现，从零带你写出一个框架。
 
-![npm](https://badgen.net/npm/v/typespeed?color=cyan)
+---
 
+## ✨ 特性
 
+### 🎯 装饰器驱动
+提供 **30+ 个装饰器**，覆盖 Web 开发全流程——对象管理、Web 路由、参数绑定、数据库操作、缓存、鉴权、消息队列、Socket，一个注解搞定一个功能：
 
-![downloads](https://badgen.net/npm/dt/typespeed?color=pink)
+| 分类 | 装饰器 | 说明 |
+|---|---|---|
+| **对象管理** | `@component` `@bean` `@autoware` `@resource` | 组件注册与依赖注入 |
+| **Web 路由** | `@getMapping` `@postMapping` `@requestMapping` | REST 路由声明 |
+| **路由参数** | `@req` `@res` `@next` `@reqBody` `@reqParam` `@reqQuery` `@reqForm` | 请求参数注入 |
+| **切面 AOP** | `@before` `@after` | 前置 / 后置拦截 |
+| **数据库** | `@insert` `@update` `@remove` `@select` `@param` `@resultType` `@cache` | SQL 声明式操作 |
+| **安全 / 上传** | `@jwt` `@upload` | JWT 鉴权、文件上传 |
+| **定时 / 配置** | `@schedule` `@value` `@config` | 定时任务、配置注入 |
+| **消息 / 缓存** | `@rabbitListener` `@redisSubscriber` | MQ 监听、Redis 订阅 |
+| **Socket.IO** | `@SocketIo.onEvent` `@onConnected` `@onDisconnect` `@onError` | 实时通信事件 |
+| **参数绑定**（2.5+） | `@bind` | 标准装饰器下的方法级参数绑定 |
 
+### 🧩 核心机制
+- **依赖注入（DI）**：`@autoware` / `@resource` 自动注入实例，`@bean` 提供工厂方法，支持显式 token（标准装饰器模式）
+- **AOP 切面**：`@before` / `@after` 无侵入拦截方法
+- **中间件**：可插拔中间件链 + 全局认证（`AuthenticationFactory`）
+- **启动扫描**：自动扫描核心模块与应用模块，零配置启动
 
+### 🗄️ 数据库（两种风格）
+- **装饰器风格**：`@select("SQL")` + `@param` / `@resultType` / `@cache`，SQL 声明式执行、结果类型映射、自动缓存
+- **Model ORM 风格**：继承 `Model`，`findAll` / `find` / `create` / `update` / `delete` / `findCount` / `incr` / `decr` / `pager`，链式查询、条件构建、分页
 
-![license](https://badgen.net/github/license/speedphp/typespeed)
+### 🔌 内置组件
+- **缓存**：`NodeCache`（内存）+ Redis（`CacheFactory` 可扩展）
+- **消息队列**：RabbitMQ 封装（`RabbitMQ` / `@rabbitListener`）
+- **Redis**：连接管理 + `@redisSubscriber` 订阅 + 排行榜（`zranking` / `zrevranking`）
+- **Socket.IO**：事件装饰器 + 房间 + 连接管理
+- **会话 / 静态 / 模板 / 上传**：session（Redis 存储）、静态资源、多模板引擎（consolidate）、文件上传
 
+### 🚀 标准装饰器双轨（2.5+）
+同时支持 **legacy 装饰器**（`experimentalDecorators: true`，书中写法）与 **TC39 标准装饰器**（Stage 2.7，`experimentalDecorators: false`），单份源码运行时自动识别，旧代码零改动。
 
+---
 
-![GitHub Build Status](https://img.shields.io/github/actions/workflow/status/speedphp/typespeed/test.yml)
+## 📦 快速开始
 
+**环境要求**：Node.js 16+（推荐 18/20/22），TypeScript。
 
+```bash
+# 1. 全局安装脚手架
+npm install typespeed -g
 
-![Codecov](https://img.shields.io/codecov/c/github/speedphp/typespeed)
-
-### 资料体系
-
-TypeSpeed 不只提供一个框架，还配有完整的「书 + 视频 + 双源码」学习资料：
-
-
+# 2. 创建项目（零配置）
+typespeed new blog
+cd blog
 
-* **书**：《TypeScript 框架开发实践（微课视频版）》（曾振中 著，清华大学出版社）——[京东购买](https://item.jd.com/14275373.html)
+# 3. 安装依赖并启动
+npm install
+npm run start
+```
 
-* **视频课程**：随书微课视频（每节配套源码快照见 ts-practice）
+---
 
-* **附书源码・ts-book**：[https://github.com/speedphp/ts-book](https://github.com/speedphp/ts-book)—— 按章组织（chapter01 \~ chapter06），每章含可运行示例
+## 📝 示例
 
-* **视频代码・ts-practice**：[https://github.com/speedphp/ts-practice](https://github.com/speedphp/ts-practice)—— 按书籍章节号打 tag（如 `4.10.4` = 第 4 章第 10 节第 4 步），每节视频对应一份可跑源码快照
+一个组件 + 路由 + 数据库 + 缓存的最小示例：
 
-### 特点
+```typescript
+import { component, app, autoware, getMapping, insert, select, resultType, cache, CacheFactory, ServerFactory } from "typespeed";
 
+// 组件（服务）
+@component
+class UserService {
 
+    // 依赖注入
+    @autoware
+    private cacheBean: CacheFactory;
 
-* 遵循 MIT 许可的开源项目。
+    // 路由 + 参数注入
+    @getMapping("/user/:id")
+    async getUser(@reqParam id: number, @res res) {
+        res.json({ id, name: "typespeed" });
+    }
 
-* 提供 31 个 TypeScript 装饰器，这些装饰器构成了完整的 Web 框架功能，包括对象管理、Web 路由、数据库操作等。
+    // 数据库：声明式 SQL
+    @insert("Insert into `user` (id, name) values (#{id}, #{name})")
+    async addUser(@param("id") id: number, @param("name") name: string) {}
 
-* 通过命令行脚手架，可以快速创建项目，零配置启动。
+    // 查询 + 结果类型映射 + 缓存
+    @cache(1800)
+    @select("Select * from `user` where id = #{id}")
+    @resultType(UserDto)
+    async findUser(@param("id") id: number): Promise<UserDto[]> { return; }
+}
 
-* 基于依赖注入、AOP、中间件和启动扫描等编程理念开发实现。
+// 应用入口：@app 自动启动 main()
+@app
+class Main {
+    @autoware
+    private server: ServerFactory;
 
-* 底层采用 ExpressJS 实现，提供稳定、快速的 Web 服务。
+    main() {
+        this.server.start(8081);
+    }
+}
+```
 
-* 框架提供了两种风格不同却各具优点的数据操作模式。
+> 更多完整示例见仓库 [`app/`](https://github.com/speedphp/typespeed/tree/main/app) 目录与随书源码。
 
-### 安装
+---
 
-TypeSpeed 环境要求 NodeJS 16+，TypeScript 运行时。
+## 📚 学习资料体系
 
+TypeSpeed 不只是一个框架，还配有**完整的「书 + 视频 + 双源码」学习体系**：
 
+| 资料 | 说明 | 链接 |
+|---|---|---|
+| 📖 **图书** | 《TypeScript 框架开发实践（微课视频版）》曾振中 著，清华大学出版社 | [京东购买](https://item.jd.com/14275373.html) |
+| 🎬 **视频课程** | 随书微课视频，每节配套源码 | 随书附带 |
+| 📂 **附书源码 ts-book** | 按章组织（chapter01~chapter06），每章可运行示例 | [github.com/speedphp/ts-book](https://github.com/speedphp/ts-book) |
+| 🏷️ **视频代码 ts-practice** | 按书籍章节号打 tag（如 `4.10.4` = 第 4 章第 10 节第 4 步），每节对应可跑源码快照 | [github.com/speedphp/ts-practice](https://github.com/speedphp/ts-practice) |
 
-```
-npm install typespeed -g
-```
+> 想系统学习框架原理与实现，从图书 + ts-book 入手；想跟随视频动手，用 ts-practice。
 
-### 使用
+---
 
+## 🗺️ 版本路线图
 
+| 版本 | 内容 | 状态 |
+|---|---|---|
+| 2.4.x | 文档复活、CI 现代化、测试全绿 | ✅ 已发布 |
+| 2.5.x | **标准装饰器双轨**（TC39 Stage 2.7）+ `@bind` + 显式 token | ✅ 已发布（latest） |
+| 2.6.x | Node/TS 升级 + 健康检查 + 优雅停机 + Docker/k8s 部署清单 | 🚧 进行中 |
 
-```
-typespeed new blog
+---
 
-cd ./blog
+## 🤝 参与贡献
 
-npm install
+欢迎提交 Issue 与 Pull Request。开发与测试：
 
-npm run test
+```bash
+npm run build   # 编译
+npm test        # 测试（需 MySQL / Redis / RabbitMQ）
 ```
 
-### 开源协议
+## 📄 开源协议
 
-[MIT](LICENSE) © speedphp
+[MIT](LICENSE) © [speedphp](https://github.com/speedphp)

package/dist/default/rabbitmq.class.js

@@ -13,6 +13,7 @@ exports.rabbitListener = exports.RabbitMQ = void 0;
 const core_decorator_1 = require("../core.decorator");
 const typespeed_1 = require("../typespeed");
 const amqplib_1 = require("amqplib");
+const decorator_utils_1 = require("../decorator-utils");
 let rabbitConnection = null;
 class RabbitMQ {
     getRabbitMQ() {
@@ -58,7 +59,23 @@ async function getChannel() {
     return channel;
 }
 function rabbitListener(queue) {
-    return (target, propertyKey) => {
+    return (...args) => {
+        if ((0, decorator_utils_1.isStd)(args)) {
+            const [, ctx] = (0, decorator_utils_1.getStdArgs)(args);
+            ctx.addInitializer(function () {
+                const targetConstructor = this.constructor;
+                const methodName = String(ctx.name);
+                (async function () {
+                    const channel = await getChannel();
+                    await channel.assertQueue(queue);
+                    const targetBean = (0, core_decorator_1.getComponent)(targetConstructor);
+                    await channel.consume(queue, targetBean[methodName], { noAck: true });
+                }());
+            });
+            return;
+        }
+        const target = args[0];
+        const propertyKey = args[1];
         (async function () {
             const channel = await getChannel();
             await channel.assertQueue(queue);

package/dist/default/redis.class.js

@@ -13,6 +13,7 @@ exports.redisSubscriber = exports.Redis = void 0;
 const core_decorator_1 = require("../core.decorator");
 const ioredis_1 = require("ioredis");
 const typespeed_1 = require("../typespeed");
+const decorator_utils_1 = require("../decorator-utils");
 const redisSubscribers = {};
 class Redis extends ioredis_1.default {
     getRedis() {
@@ -75,7 +76,19 @@ function redisSubscriber(channel) {
             console.error(err);
         }
     });
-    return function (target, propertyKey) {
+    return function (...args) {
+        if ((0, decorator_utils_1.isStd)(args)) {
+            const [, ctx] = (0, decorator_utils_1.getStdArgs)(args);
+            ctx.addInitializer(function () {
+                redisSubscribers[channel] = {
+                    target: this,
+                    propertyKey: String(ctx.name)
+                };
+            });
+            return;
+        }
+        const target = args[0];
+        const propertyKey = args[1];
         redisSubscribers[channel] = {
             target: target,
             propertyKey: propertyKey

package/dist/default/socket-io.class.js

@@ -4,6 +4,7 @@ exports.io = exports.SocketIo = void 0;
 const socket_io_1 = require("socket.io");
 const http_1 = require("http");
 const core_decorator_1 = require("../core.decorator");
+const decorator_utils_1 = require("../decorator-utils");
 let io = null;
 exports.io = io;
 const listeners = { "event": [], "disconnect": null, "error": null, "connected": null };
@@ -48,26 +49,74 @@ class SocketIo {
         return httpServer;
     }
     static onEvent(event) {
-        return (target, propertyKey) => {
+        return (...args) => {
+            if ((0, decorator_utils_1.isStd)(args)) {
+                const [, ctx] = (0, decorator_utils_1.getStdArgs)(args);
+                ctx.addInitializer(function () {
+                    listeners["event"].push([{
+                            target: this,
+                            propertyKey: String(ctx.name)
+                        }, event]);
+                });
+                return;
+            }
+            const target = args[0];
+            const propertyKey = args[1];
             listeners["event"].push([{
                     target: target,
                     propertyKey: propertyKey
                 }, event]);
         };
     }
-    static onError(target, propertyKey) {
+    static onError(...args) {
+        if ((0, decorator_utils_1.isStd)(args)) {
+            const [, ctx] = (0, decorator_utils_1.getStdArgs)(args);
+            ctx.addInitializer(function () {
+                listeners["error"] = {
+                    target: this,
+                    propertyKey: String(ctx.name)
+                };
+            });
+            return;
+        }
+        const target = args[0];
+        const propertyKey = args[1];
         listeners["error"] = {
             target: target,
             propertyKey: propertyKey
         };
     }
-    static onDisconnect(target, propertyKey) {
+    static onDisconnect(...args) {
+        if ((0, decorator_utils_1.isStd)(args)) {
+            const [, ctx] = (0, decorator_utils_1.getStdArgs)(args);
+            ctx.addInitializer(function () {
+                listeners["disconnect"] = {
+                    target: this,
+                    propertyKey: String(ctx.name)
+                };
+            });
+            return;
+        }
+        const target = args[0];
+        const propertyKey = args[1];
         listeners["disconnect"] = {
             target: target,
             propertyKey: propertyKey
         };
     }
-    static onConnected(target, propertyKey) {
+    static onConnected(...args) {
+        if ((0, decorator_utils_1.isStd)(args)) {
+            const [, ctx] = (0, decorator_utils_1.getStdArgs)(args);
+            ctx.addInitializer(function () {
+                listeners["connected"] = {
+                    target: this,
+                    propertyKey: String(ctx.name)
+                };
+            });
+            return;
+        }
+        const target = args[0];
+        const propertyKey = args[1];
         listeners["connected"] = {
             target: target,
             propertyKey: propertyKey

package/dist/typespeed.d.ts

@@ -175,9 +175,9 @@ declare function after(constructorFunction: any, methodName: string): (...args:
 /**定时程序装饰器，参数支持 crontab 格式字符串，可根据参数定时执行被装饰的方法 */
 declare function schedule(cronTime: string | Date): (...args: any[]) => any;
 /**RabbitMQ 监听装饰器，参数是监听的队列名称，当接受到消息时将执行被装饰方法 */
-declare function rabbitListener(queue: string): (target: any, propertyKey: string) => void;
-/**Redis 监听装饰器，参数是监听的队列名称，当接受到消息时将执行被装饰方法 */
-declare function redisSubscriber(target: any, propertyKey: string): void;
+declare function rabbitListener(queue: string): (...args: any[]) => any;
+/**Redis 监听装饰器，参数是监听的频道名称，当接受到消息时将执行被装饰方法 */
+declare function redisSubscriber(channel: string): (...args: any[]) => any;
 /** request 对象装饰器，作为路由页面方法参数，获取 request 对象 */
 declare function req(target: any, propertyKey: string, parameterIndex: number): void;
 /** response 对象装饰器，作为路由页面方法参数，获取 response 对象 */
@@ -389,13 +389,13 @@ declare class SocketIo {
      * Socket IO 事件装饰器
      * @param event 事件名称
      */
-    public static onEvent(event: string): (target: any, propertyKey: string) => void;
+    public static onEvent(event: string): (...args: any[]) => any;
     /**Socket IO 错误捕获装饰器 */
-    public static onError(target: any, propertyKey: string): void;
+    public static onError(...args: any[]): any;
     /**Socket IO 客户端断开连接事件装饰器 */
-    public static onDisconnect(target: any, propertyKey: string): void;
+    public static onDisconnect(...args: any[]): any;
     /**Socket IO 客户端连接成功事件装饰器 */
-    public static onConnected(target: any, propertyKey: string): void;
+    public static onConnected(...args: any[]): any;
 }
 /**Socket IO 服务实现类 */
 declare const io: IoServer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typespeed",
-  "version": "2.5.0",
+  "version": "2.5.2",
   "description": "A new Framework for TypeScript.",
   "author": "speedphp",
   "license": "MIT License",
@@ -13,8 +13,13 @@
     "prebuild": "rm -rf dist"
   },
   "main": "dist/typespeed.js",
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "README.en.md"
+  ],
   "bin": {
-    "typespeed": "./dist/scaffold/command.js"
+    "typespeed": "dist/scaffold/command.js"
   },
   "homepage": "https://github.com/speedphp/typespeed#readme",
   "repository": {

package/.github/workflows/test.yml

@@ -1,50 +0,0 @@
-name: Tests
-'on': 
-  push:
-    branches:
-      - main
-
-jobs:
-  test:
-    name: 'Test TypeSpeed'
-    runs-on: ubuntu-latest
-    services:
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-      rabbitmq:
-        image: rabbitmq:3.8
-        env:
-          RABBITMQ_DEFAULT_USER: guest
-          RABBITMQ_DEFAULT_PASS: guest
-        ports:
-          - 5672
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-      - name: Setup MySQL
-        run: |
-          sudo /etc/init.d/mysql start
-          mysql -e 'CREATE DATABASE test;USE test; \
-          CREATE TABLE `user` (`id` int(11) NOT NULL AUTO_INCREMENT,`name` varchar(100) DEFAULT NULL,PRIMARY KEY (`id`)) \
-          ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;SHOW TABLES;' -uroot -proot
-      - name: 'Cache node_modules'
-        uses: actions/cache@v4
-        with:
-          path: ~/.npm
-          key: ${{ runner.os }}-node-v22-${{ hashFiles('**/package.json') }}
-          restore-keys: |
-            ${{ runner.os }}-node-v22-
-      - name: Install Dependencies
-        run: npm install
-      - name: Run Tests with Coverage
-        run: npm run test-with-coverage
-        env:
-          LOCAL_HOST: localhost
-      - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v3
-        env:
-          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

package/app/nodemon.json

@@ -1,5 +0,0 @@
-{
-    "watch": ["src", "../dist", "../src", "../test"],
-    "ext": "ts,json",
-    "exec": "npm test" 
-}