koatty_router 2.1.9 → 2.2.0

package/.opencode/feature_list.json

@@ -0,0 +1,59 @@
+{
+  "project": "koatty-router",
+  "created_at": "2026-03-08T00:00:00Z",
+  "updated_at": "2026-03-08T11:00:00Z",
+  "tasks": [
+    {
+      "id": "task-011",
+      "name": "修复测试文件 P1 严重问题",
+      "description": "修复 test/grpc-simple-test.test.ts 中的 P1 严重问题：\n1. 删除整个 \"Batch Processor\" describe 块（263-337行）\n2. 修复 config.bufferSize → config.streamBufferSize（399行）\n3. 删除 options.batchSize 断言（445行）\n4. 清理 afterEach 中 batchProcessor 残留清理代码（88-98行）",
+      "status": "completed",
+      "review_status": "pass",
+      "reviewer_notes": [],
+      "priority": "high",
+      "depends_on": [],
+      "assignee": null,
+      "created_at": "2026-03-08T00:00:00Z",
+      "updated_at": "2026-03-08T10:46:00Z",
+      "completed_at": "2026-03-08T10:46:00Z"
+    },
+    {
+      "id": "task-012",
+      "name": "修复 P2 中等问题",
+      "description": "修复 P2 中等问题：\n1. src/middleware/manager.ts:816 - createGroup() 调用 this.register() 未 await，异步错误被静默丢弃\n2. src/router/grpc.ts:71 - StreamManager 中 streamBufferSize 存入 this.config 但背压逻辑从未读取，字段完全孤立无作用",
+      "status": "completed",
+      "review_status": null,
+      "reviewer_notes": "[P2] src/middleware/manager.ts:80-87 — IRouterMiddlewareManager 接口未声明 createGroup() 方法，但实现类已将其改为 async createGroup(): Promise<void>；接口未同步更新导致通过接口类型调用时无法访问该方法，TypeScript 类型契约不一致；建议在接口中添加 createGroup(groupName: string, middlewareNames: string[]): Promise<void> 声明",
+      "priority": "medium",
+      "depends_on": [
+        "task-011"
+      ],
+      "assignee": null,
+      "created_at": "2026-03-08T00:00:00Z",
+      "updated_at": "2026-03-08T10:46:09.075968",
+      "completed_at": "2026-03-08T10:46:09.075973",
+      "audit_log": [
+        {
+          "from": "review_pending",
+          "to": "completed",
+          "actor": "reviewer",
+          "timestamp": "2026-03-08T10:46:09.075974"
+        }
+      ]
+    },
+    {
+      "id": "task-013",
+      "name": "修复接口签名不一致问题",
+      "description": "在 IRouterMiddlewareManager 接口中添加 createGroup() 方法声明，使其与实现类签名一致：createGroup(groupName: string, middlewareNames: string[]): Promise<void>",
+      "status": "completed",
+      "review_status": "pass",
+      "reviewer_notes": [],
+      "priority": "medium",
+      "depends_on": ["task-012"],
+      "assignee": null,
+      "created_at": "2026-03-08T11:00:00Z",
+      "updated_at": "2026-03-08T11:05:00Z",
+      "completed_at": "2026-03-08T11:05:00Z"
+    }
+  ]
+}

package/.opencode/progress.txt

@@ -0,0 +1,45 @@
+# Task Progress
+
+## task-012: 修复 P2 中等问题
+Status: review_pending
+Date: 2026-03-08
+
+### Changes Made:
+1. 修复 src/middleware/manager.ts:816 - 将 createGroup() 改为 async 方法，await register() 调用以正确处理异步错误
+2. 修复 src/router/grpc.ts:71 - 移除未使用的 streamBufferSize 配置项（从 StreamConfig 接口和 StreamManager 构造函数中删除）
+3. 修复 src/router/grpc.ts:314,384,469 - 移除未使用的 streamState 变量赋值（P3 问题）
+4. 更新测试文件 test/grpc_stream.test.ts 和 test/grpc-simple-test.test.ts - 移除对已删除 streamBufferSize 的检查
+
+### Issues Resolved:
+- [P2] createGroup() 未 await register()，异步错误被静默丢弃
+- [P2] streamBufferSize 配置项存入 this.config 但从未在背压逻辑中使用，字段完全孤立
+- [P3] streamState 变量在三处被赋值但从未使用
+
+### Test Result:
+- All 36 gRPC tests passed
+- Lint passed with 0 errors (23 warnings only)
+
+### Files Modified:
+- src/middleware/manager.ts
+- src/router/grpc.ts
+- src/router/types.ts
+- test/grpc_stream.test.ts
+- test/grpc-simple-test.test.ts
+
+## task-011: 修复测试文件 P1 严重问题
+Status: review_pending
+Date: 2026-03-08
+
+### Changes Made:
+1. 删除 "Batch Processor" describe 块（原263-337行）
+2. 修复 config.bufferSize → config.streamBufferSize（原322行和328行）
+3. 删除 options.batchSize 断言（原369行）
+4. 清理 afterEach 中 batchProcessor 残留清理代码（原88-98行）
+5. 删除 "should handle batch processor edge cases" 测试（因 batchProcessor 已不存在）
+
+### Test Result:
+- All 20 tests passed
+- Test file: test/grpc-simple-test.test.ts
+
+### Files Modified:
+- test/grpc-simple-test.test.ts

package/.turbo/turbo-build.log

@@ -1,10 +1,10 @@
 
 
-> koatty_router@2.1.9 build /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
+> koatty_router@2.2.0 build /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
 > pnpm run build:js && pnpm run build:dts && pnpm run build:doc && pnpm run build:cp
 
 
-> koatty_router@2.1.9 build:js /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
+> koatty_router@2.2.0 build:js /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
 > tsup
 
 CLI Building entry: src/index.ts
@@ -15,14 +15,14 @@
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-ESM dist/index.mjs     141.83 KB
-ESM dist/index.mjs.map 376.26 KB
-ESM ⚡️ Build success in 656ms
-CJS dist/index.js     147.84 KB
-CJS dist/index.js.map 376.58 KB
-CJS ⚡️ Build success in 657ms
-
-> koatty_router@2.1.9 build:dts /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
+CJS dist/index.js     141.41 KB
+CJS dist/index.js.map 361.31 KB
+CJS ⚡️ Build success in 534ms
+ESM dist/index.mjs     135.65 KB
+ESM dist/index.mjs.map 361.02 KB
+ESM ⚡️ Build success in 533ms
+
+> koatty_router@2.2.0 build:dts /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
 > bash ../../scripts/build-dts.sh
 
 🔨 Building type declarations for koatty-router...
@@ -38,9 +38,171 @@
   ✓ koatty_proto type declarations ready
   ✓ koatty_validation type declarations ready
 
-✅ All dependencies ready (waited 2ms)
+✅ All dependencies ready (waited 1ms)
 📝 Running TypeScript compiler...
-⠙⠙📦 Running API Extractor...
+⠙src/router/factory.ts:61:37 - error TS2345: Argument of type 'typeof HttpRouter' is not assignable to parameter of type 'RouterConstructor'.
+  Types of construct signatures are incompatible.
+    Type 'new (app: Koatty, options?: RouterOptions) => HttpRouter' is not assignable to type 'new (app: KoattyApplication, options?: RouterOptions) => KoattyRouter'.
+      Construct signature return types 'HttpRouter' and 'KoattyRouter' are incompatible.
+        The types of 'options' are incompatible between these types.
+          Type 'RouterOptions' is not assignable to type 'Record<string, unknown>'.
+            Index signature for type 'string' is missing in type 'RouterOptions'.
+
+61     this.routerRegistry.set('http', HttpRouter);
+                                       ~~~~~~~~~~
+
+src/router/factory.ts:62:38 - error TS2345: Argument of type 'typeof HttpRouter' is not assignable to parameter of type 'RouterConstructor'.
+  Types of construct signatures are incompatible.
+    Type 'new (app: Koatty, options?: RouterOptions) => HttpRouter' is not assignable to type 'new (app: KoattyApplication, options?: RouterOptions) => KoattyRouter'.
+      Construct signature return types 'HttpRouter' and 'KoattyRouter' are incompatible.
+        The types of 'options' are incompatible between these types.
+          Type 'RouterOptions' is not assignable to type 'Record<string, unknown>'.
+            Index signature for type 'string' is missing in type 'RouterOptions'.
+
+62     this.routerRegistry.set('https', HttpRouter);
+                                        ~~~~~~~~~~
+
+src/router/factory.ts:63:38 - error TS2345: Argument of type 'typeof HttpRouter' is not assignable to parameter of type 'RouterConstructor'.
+  Types of construct signatures are incompatible.
+    Type 'new (app: Koatty, options?: RouterOptions) => HttpRouter' is not assignable to type 'new (app: KoattyApplication, options?: RouterOptions) => KoattyRouter'.
+      Construct signature return types 'HttpRouter' and 'KoattyRouter' are incompatible.
+        The types of 'options' are incompatible between these types.
+          Type 'RouterOptions' is not assignable to type 'Record<string, unknown>'.
+            Index signature for type 'string' is missing in type 'RouterOptions'.
+
+63     this.routerRegistry.set('http2', HttpRouter);
+                                        ~~~~~~~~~~
+
+src/router/factory.ts:64:38 - error TS2345: Argument of type 'typeof HttpRouter' is not assignable to parameter of type 'RouterConstructor'.
+  Types of construct signatures are incompatible.
+    Type 'new (app: Koatty, options?: RouterOptions) => HttpRouter' is not assignable to type 'new (app: KoattyApplication, options?: RouterOptions) => KoattyRouter'.
+      Construct signature return types 'HttpRouter' and 'KoattyRouter' are incompatible.
+        The types of 'options' are incompatible between these types.
+          Type 'RouterOptions' is not assignable to type 'Record<string, unknown>'.
+            Index signature for type 'string' is missing in type 'RouterOptions'.
+
+64     this.routerRegistry.set('http3', HttpRouter);
+                                        ~~~~~~~~~~
+
+src/router/factory.ts:65:35 - error TS2345: Argument of type 'typeof WebsocketRouter' is not assignable to parameter of type 'RouterConstructor'.
+  Types of construct signatures are incompatible.
+    Type 'new (app: Koatty, options?: RouterOptions) => WebsocketRouter' is not assignable to type 'new (app: KoattyApplication, options?: RouterOptions) => KoattyRouter'.
+      Construct signature return types 'WebsocketRouter' and 'KoattyRouter' are incompatible.
+        The types of 'options' are incompatible between these types.
+          Type 'WebsocketRouterOptions' is not assignable to type 'Record<string, unknown>'.
+            Index signature for type 'string' is missing in type 'WebsocketRouterOptions'.
+
+65     this.routerRegistry.set('ws', WebsocketRouter);
+                                     ~~~~~~~~~~~~~~~
+
+src/router/factory.ts:66:36 - error TS2345: Argument of type 'typeof WebsocketRouter' is not assignable to parameter of type 'RouterConstructor'.
+  Types of construct signatures are incompatible.
+    Type 'new (app: Koatty, options?: RouterOptions) => WebsocketRouter' is not assignable to type 'new (app: KoattyApplication, options?: RouterOptions) => KoattyRouter'.
+      Construct signature return types 'WebsocketRouter' and 'KoattyRouter' are incompatible.
+        The types of 'options' are incompatible between these types.
+          Type 'WebsocketRouterOptions' is not assignable to type 'Record<string, unknown>'.
+            Index signature for type 'string' is missing in type 'WebsocketRouterOptions'.
+
+66     this.routerRegistry.set('wss', WebsocketRouter);
+                                      ~~~~~~~~~~~~~~~
+
+src/router/factory.ts:67:37 - error TS2345: Argument of type 'typeof GrpcRouter' is not assignable to parameter of type 'RouterConstructor'.
+  Types of construct signatures are incompatible.
+    Type 'new (app: Koatty, options?: RouterOptions) => GrpcRouter' is not assignable to type 'new (app: KoattyApplication, options?: RouterOptions) => KoattyRouter'.
+      Construct signature return types 'GrpcRouter' and 'KoattyRouter' are incompatible.
+        The types of 'options' are incompatible between these types.
+          Type 'GrpcRouterOptions' is not assignable to type 'Record<string, unknown>'.
+            Index signature for type 'string' is missing in type 'GrpcRouterOptions'.
+
+67     this.routerRegistry.set('grpc', GrpcRouter);
+                                       ~~~~~~~~~~
+
+src/router/factory.ts:68:40 - error TS2345: Argument of type 'typeof GraphQLRouter' is not assignable to parameter of type 'RouterConstructor'.
+  Types of construct signatures are incompatible.
+    Type 'new (app: Koatty, options?: RouterOptions) => GraphQLRouter' is not assignable to type 'new (app: KoattyApplication, options?: RouterOptions) => KoattyRouter'.
+      Construct signature return types 'GraphQLRouter' and 'KoattyRouter' are incompatible.
+        The types of 'options' are incompatible between these types.
+          Type 'GraphQLRouterOptions' is not assignable to type 'Record<string, unknown>'.
+            Index signature for type 'string' is missing in type 'GraphQLRouterOptions'.
+
+68     this.routerRegistry.set('graphql', GraphQLRouter);
+                                          ~~~~~~~~~~~~~
+
+src/router/graphql.ts:39:3 - error TS2416: Property 'options' in type 'GraphQLRouter' is not assignable to the same property in base type 'KoattyRouter'.
+  Type 'GraphQLRouterOptions' is not assignable to type 'Record<string, unknown>'.
+    Index signature for type 'string' is missing in type 'GraphQLRouterOptions'.
+
+39   options: GraphQLRouterOptions;
+     ~~~~~~~
+
+src/router/graphql.ts:129:19 - error TS2339: Property 'extensions' does not exist on type 'Readonly<Error | GraphQLError>'.
+  Property 'extensions' does not exist on type 'Readonly<Error>'.
+
+129         if (error.extensions) {
+                      ~~~~~~~~~~
+
+src/router/graphql.ts:130:40 - error TS2339: Property 'extensions' does not exist on type 'Readonly<Error | GraphQLError>'.
+  Property 'extensions' does not exist on type 'Readonly<Error>'.
+
+130           formatted.extensions = error.extensions;
+                                           ~~~~~~~~~~
+
+src/router/graphql.ts:132:19 - error TS2339: Property 'locations' does not exist on type 'Readonly<Error | GraphQLError>'.
+  Property 'locations' does not exist on type 'Readonly<Error>'.
+
+132         if (error.locations) {
+                      ~~~~~~~~~
+
+src/router/graphql.ts:133:39 - error TS2339: Property 'locations' does not exist on type 'Readonly<Error | GraphQLError>'.
+  Property 'locations' does not exist on type 'Readonly<Error>'.
+
+133           formatted.locations = error.locations;
+                                          ~~~~~~~~~
+
+src/router/graphql.ts:135:19 - error TS2339: Property 'path' does not exist on type 'Readonly<Error | GraphQLError>'.
+  Property 'path' does not exist on type 'Readonly<Error>'.
+
+135         if (error.path) {
+                      ~~~~
+
+src/router/graphql.ts:136:34 - error TS2339: Property 'path' does not exist on type 'Readonly<Error | GraphQLError>'.
+  Property 'path' does not exist on type 'Readonly<Error>'.
+
+136           formatted.path = error.path;
+                                     ~~~~
+
+src/router/grpc.ts:184:3 - error TS2416: Property 'options' in type 'GrpcRouter' is not assignable to the same property in base type 'KoattyRouter'.
+  Type 'GrpcRouterOptions' is not assignable to type 'Record<string, unknown>'.
+    Index signature for type 'string' is missing in type 'GrpcRouterOptions'.
+
+184   options: GrpcRouterOptions;
+      ~~~~~~~
+
+src/router/http.ts:28:3 - error TS2416: Property 'options' in type 'HttpRouter' is not assignable to the same property in base type 'KoattyRouter'.
+  Type 'RouterOptions' is not assignable to type 'Record<string, unknown>'.
+    Index signature for type 'string' is missing in type 'RouterOptions'.
+
+28   options: RouterOptions;
+     ~~~~~~~
+
+src/router/ws.ts:55:3 - error TS2416: Property 'options' in type 'WebsocketRouter' is not assignable to the same property in base type 'KoattyRouter'.
+  Type 'WebsocketRouterOptions' is not assignable to type 'Record<string, unknown>'.
+    Index signature for type 'string' is missing in type 'WebsocketRouterOptions'.
+
+55   options: WebsocketRouterOptions;
+     ~~~~~~~
+
+
+Found 18 errors in 5 files.
+
+Errors  Files
+     8  src/router/factory.ts:61
+     7  src/router/graphql.ts:39
+     1  src/router/grpc.ts:184
+     1  src/router/http.ts:28
+     1  src/router/ws.ts:55
+⠙⚠️  TypeScript compilation had errors, but continuing...
+📦 Running API Extractor...
 ⠙
 api-extractor 7.55.2  - https://api-extractor.com/
 
@@ -84,37 +246,31 @@ Analysis will use the bundled TypeScript version 5.8.2
 Warning: src/params/params.ts:80:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
 Warning: src/params/params.ts:81:17 - (tsdoc-param-tag-with-invalid-optional-name) The @param should not include a JSDoc-style optional name; it must not be enclosed in '[ ]' brackets.
 Warning: src/params/params.ts:81:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
-Warning: src/params/params.ts:101:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
-Warning: src/params/params.ts:102:20 - (tsdoc-param-tag-with-invalid-optional-name) The @param should not include a JSDoc-style optional name; it must not be enclosed in '[ ]' brackets.
-Warning: src/params/params.ts:102:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
-Warning: src/params/params.ts:103:17 - (tsdoc-param-tag-with-invalid-optional-name) The @param should not include a JSDoc-style optional name; it must not be enclosed in '[ ]' brackets.
-Warning: src/params/params.ts:103:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
-Warning: src/params/params.ts:124:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
-Warning: src/params/params.ts:125:28 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
-Warning: src/params/params.ts:125:41 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
-Warning: src/params/params.ts:125:42 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
-Warning: src/params/params.ts:125:17 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
-Warning: src/params/params.ts:125:24 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
-Warning: src/params/params.ts:125:37 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
-Warning: src/params/params.ts:136:13 - (tsdoc-undefined-tag) The TSDoc tag "@RequestBody" is not defined in this configuration
-Warning: src/params/params.ts:137:13 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
-Warning: src/params/params.ts:137:11 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
-Warning: src/params/params.ts:137:4 - (tsdoc-param-tag-with-invalid-name) The @param block should be followed by a parameter name
-Warning: src/params/params.ts:137:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
-Warning: src/params/params.ts:138:14 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
-Warning: src/params/params.ts:138:12 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
-Warning: src/params/params.ts:138:4 - (tsdoc-undefined-tag) The TSDoc tag "@return" is not defined in this configuration
-Warning: src/params/params.ts:146:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
-Warning: src/params/params.ts:147:32 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
-Warning: src/params/params.ts:147:13 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
-Warning: src/params/params.ts:158:13 - (tsdoc-undefined-tag) The TSDoc tag "@RequestParam" is not defined in this configuration
-Warning: src/params/params.ts:159:13 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
-Warning: src/params/params.ts:159:11 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
-Warning: src/params/params.ts:159:4 - (tsdoc-param-tag-with-invalid-name) The @param block should be followed by a parameter name
-Warning: src/params/params.ts:159:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
-Warning: src/params/params.ts:160:14 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
-Warning: src/params/params.ts:160:12 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
-Warning: src/params/params.ts:160:4 - (tsdoc-undefined-tag) The TSDoc tag "@return" is not defined in this configuration
+Warning: src/params/params.ts:107:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
+Warning: src/params/params.ts:108:20 - (tsdoc-param-tag-with-invalid-optional-name) The @param should not include a JSDoc-style optional name; it must not be enclosed in '[ ]' brackets.
+Warning: src/params/params.ts:108:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/params.ts:109:17 - (tsdoc-param-tag-with-invalid-optional-name) The @param should not include a JSDoc-style optional name; it must not be enclosed in '[ ]' brackets.
+Warning: src/params/params.ts:109:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/params.ts:131:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
+Warning: src/params/params.ts:143:13 - (tsdoc-undefined-tag) The TSDoc tag "@RequestBody" is not defined in this configuration
+Warning: src/params/params.ts:144:13 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
+Warning: src/params/params.ts:144:11 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+Warning: src/params/params.ts:144:4 - (tsdoc-param-tag-with-invalid-name) The @param block should be followed by a parameter name
+Warning: src/params/params.ts:144:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/params.ts:145:14 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
+Warning: src/params/params.ts:145:12 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+Warning: src/params/params.ts:145:4 - (tsdoc-undefined-tag) The TSDoc tag "@return" is not defined in this configuration
+Warning: src/params/params.ts:153:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
+Warning: src/params/params.ts:154:32 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
+Warning: src/params/params.ts:154:13 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+Warning: src/params/params.ts:165:13 - (tsdoc-undefined-tag) The TSDoc tag "@RequestParam" is not defined in this configuration
+Warning: src/params/params.ts:166:13 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
+Warning: src/params/params.ts:166:11 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+Warning: src/params/params.ts:166:4 - (tsdoc-param-tag-with-invalid-name) The @param block should be followed by a parameter name
+Warning: src/params/params.ts:166:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/params.ts:167:14 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
+Warning: src/params/params.ts:167:12 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+Warning: src/params/params.ts:167:4 - (tsdoc-undefined-tag) The TSDoc tag "@return" is not defined in this configuration
 Warning: src/router/router.ts:20:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
 Warning: src/router/router.ts:21:4 - (tsdoc-undefined-tag) The TSDoc tag "@interface" is not defined in this configuration
 Warning: src/router/router.ts:48:3 - (ae-forgotten-export) The symbol "PayloadOptions" needs to be exported by the entry point index.d.ts
@@ -123,7 +279,7 @@ Analysis will use the bundled TypeScript version 5.8.2
 Warning: src/router/router.ts:54:66 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
 Warning: src/router/router.ts:54:14 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
 Warning: src/router/router.ts:55:62 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
-Warning: src/router/router.ts:55:17 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+Warning: src/router/router.ts:55:17 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
 Warning: src/router/router.ts:89:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
 Warning: src/router/router.ts:90:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
 Warning: src/router/router.ts:91:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
@@ -137,7 +293,7 @@ Analysis will use the bundled TypeScript version 5.8.2
 API Extractor completed successfully
 ⠙✅ Type declarations built successfully
 
-> koatty_router@2.1.9 build:doc /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
+> koatty_router@2.2.0 build:doc /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
 > api-documenter markdown --input temp --output docs/api
 
 
@@ -180,7 +336,7 @@ Unsupported block tag: @interface
 Unsupported block tag: @RequestBody
 Unsupported block tag: @RequestParam
 
-> koatty_router@2.1.9 build:cp /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
+> koatty_router@2.2.0 build:cp /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
 > node ../../scripts/postBuild.js
 
 📦 postBuild: koatty-router

package/.turbo/turbo-clean.log

@@ -0,0 +1,4 @@
+
+> koatty_router@2.1.11 clean /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
+> rimraf dist temp docs/api
+

package/.turbo/turbo-test.log

@@ -0,0 +1,77 @@
+
+> koatty_router@2.1.10 test /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
+> pnpm run lint && jest --passWithNoTests
+
+
+> koatty_router@2.1.10 lint /Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
+> eslint --ext .ts,.js ./src
+
+
+/Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router/src/middleware/manager.ts
+   28:36  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  264:41  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+
+/Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router/src/params/mapping.ts
+   23:15  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+   41:16  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+   77:18  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  205:15  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+
+/Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router/src/router/grpc.ts
+  175:10  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  178:26  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+
+/Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router/src/router/ws.ts
+  290:66   warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  290:149  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+
+/Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router/src/utils/handler.ts
+  39:91  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+
+/Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router/src/utils/inject.ts
+  140:24  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  227:47  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  235:49  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  280:37  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  356:31  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  390:9   warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  396:16  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  613:7   warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  873:9   warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  883:18  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+
+/Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router/src/utils/param-extractors.ts
+  89:34  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+
+/Volumes/ExternalSSD/Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router/src/utils/strategy-extractor.ts
+  161:14  warning  The `Function` type accepts any function-like value.
+Prefer explicitly defining any function parameters and return type  @typescript-eslint/no-unsafe-function-type
+  767:13  error    'rawValue' is never reassigned. Use 'const' instead                                                                      prefer-const
+
+✖ 24 problems (1 error, 23 warnings)
+  1 error and 0 warnings potentially fixable with the `--fix` option.
+
+ ELIFECYCLE  Command failed with exit code 1.
+ ELIFECYCLE  Test failed. See above for more details.

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## 2.2.0
+
+### Minor Changes
+
+- build
+- build
+
+### Patch Changes
+
+- Updated dependencies
+- Updated dependencies
+  - koatty_exception@2.2.0
+  - koatty_core@2.2.0
+  - koatty_container@3.0.0
+  - koatty_graphql@2.0.0
+  - koatty_lib@1.5.0
+  - koatty_logger@3.0.0
+  - koatty_proto@2.0.0
+  - koatty_validation@3.0.0
+
+## 2.1.11
+
+### Patch Changes
+
+- build
+- Updated dependencies
+  - koatty_exception@2.1.10
+  - koatty_core@2.1.10
+  - koatty_container@2.0.10
+  - koatty_graphql@1.1.10
+  - koatty_lib@1.4.10
+  - koatty_logger@2.8.6
+  - koatty_proto@1.3.10
+  - koatty_validation@2.0.8
+
+## 2.1.10
+
+### Patch Changes
+
+- build
+- Updated dependencies
+  - koatty_container@2.0.8
+  - koatty_core@2.1.9
+  - koatty_exception@2.1.9
+  - koatty_validation@2.0.8
+
 ## 2.1.9
 
 ### Patch Changes
@@ -278,12 +324,10 @@ This is a major release focusing on **performance**, **memory efficiency**, and
 **If upgrading from v1.20.0-8 or earlier:**
 
 1. **Validator Compilation**: Ensure all validation rules are compatible with pre-compilation
-
    - Custom validation functions must be pure functions
    - All `ValidRules` references must exist in `FunctionValidator`
 
 2. **Error Handling**: Applications will now fail at startup (not runtime) if validators cannot compile
-
    - Check application startup logs for compilation errors
    - Fix any custom validators that throw during compilation