koatty_router 2.1.10 → 2.2.0

package/.turbo/turbo-build.log

@@ -1,10 +1,10 @@
 
 
-> koatty_router@2.1.10 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.10 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     136.77 KB
-ESM dist/index.mjs.map 363.60 KB
-ESM ⚡️ Build success in 498ms
-CJS dist/index.js     142.64 KB
-CJS dist/index.js.map 363.90 KB
-CJS ⚡️ Build success in 498ms
-
-> koatty_router@2.1.10 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...
@@ -40,8 +40,170 @@
 
 ✅ 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/
 
 Using configuration from ./api-extractor.json
@@ -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
@@ -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.10 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.10 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,40 @@
 # 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
@@ -289,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
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /*!
 * @Author: richen
-* @Date: 2026-03-08 12:45:14
+* @Date: 2026-04-24 16:20:40
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/
@@ -315,10 +315,11 @@ export declare function RegisterMiddleware(app: Application, config: Omit<Middle
 export declare function RegisterRouter(protocol: string): <T extends RouterConstructor>(target: T) => T;
 
 /**
- * Get parsed body(form variable and file object).
+ * Get parsed request body as a flat object.
+ * For multipart requests, use FILE_KEY symbol from payload/interface to access uploaded files.
  *
  * @export
- * @returns ex: {body: {...}, file: {...}}
+ * @returns Flat body object. Files (if any) accessible via body[FILE_KEY].
  */
 export declare function RequestBody(): ParameterDecorator;