koatty_router 2.0.2 → 2.0.6

package/.turbo/turbo-build.log

@@ -0,0 +1,169 @@
+
+
+> koatty_router@2.0.6 build /Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
+> npm run build:js && npm run build:dts && npm run build:doc && npm run build:cp
+
+
+> koatty_router@2.0.6 build:js
+> npx rollup --bundleConfigAsCjs -c .rollup.config.js
+
+
+./src/index.ts → ./dist/index.js, ./dist/index.mjs...
+created ./dist/index.js, ./dist/index.mjs in 17.6s
+⠙⠙
+> koatty_router@2.0.6 build:dts
+> npx tsc && npx api-extractor run --local --verbose
+
+⠙⠙⠙
+api-extractor 7.55.2  - https://api-extractor.com/
+
+Using configuration from ./api-extractor.json
+Analysis will use the bundled TypeScript version 5.8.2
+*** The target project appears to use TypeScript 5.9.3 which is newer than the bundled compiler engine; consider upgrading API Extractor.
+Writing: /Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router/temp/koatty_router.api.json
+Writing package typings: /Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router/dist/index.d.ts
+Warning: src/params/mapping.ts:33:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
+Warning: src/params/mapping.ts:34:4 - (tsdoc-undefined-tag) The TSDoc tag "@interface" is not defined in this configuration
+Warning: src/params/mapping.ts:47:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
+Warning: src/params/mapping.ts:48:4 - (tsdoc-undefined-tag) The TSDoc tag "@var" is not defined in this configuration
+Warning: src/params/mapping.ts:64: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/mapping.ts:64:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/mapping.ts:65:27 - (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/mapping.ts:65:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/mapping.ts:66:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/mapping.ts:69:11 - (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/mapping.ts:70:15 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
+Warning: src/params/mapping.ts:70:34 - (tsdoc-escape-right-brace) The "}" character should be escaped using a backslash to avoid confusion with a TSDoc inline tag
+Warning: src/params/mapping.ts:70:13 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+Warning: src/params/mapping.ts:70:18 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+Warning: src/params/params.ts:19:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
+Warning: src/params/params.ts:20: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:20:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/params.ts:21: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:21:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/params.ts:37:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
+Warning: src/params/params.ts:38: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:38:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/params.ts:39: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:39:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/params.ts:58:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
+Warning: src/params/params.ts:59: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:59:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/params.ts:60: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:60:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/params/params.ts:79:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
+Warning: src/params/params.ts:80: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: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/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
+Warning: src/router/router.ts:53:74 - (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:53:19 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+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:87:4 - (tsdoc-undefined-tag) The TSDoc tag "@export" is not defined in this configuration
+Warning: src/router/router.ts:88:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/router/router.ts:89:11 - (tsdoc-param-tag-with-invalid-type) The @param block should not include a JSDoc-style '{type}'
+Warning: src/router/router.ts:90:15 - (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:90:31 - (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:90:13 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+Warning: src/router/router.ts:90:18 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+
+API Extractor completed successfully
+⠙⠙
+> koatty_router@2.0.6 build:doc
+> npx api-documenter markdown --input temp --output docs/api
+
+
+api-documenter 7.28.2  - https://api-extractor.com/
+
+Reading koatty_router.api.json
+
+Deleting old output from docs/api
+Writing koatty_router package
+Unsupported block tag: @RequestBody
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @RequestParam
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @var
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @interface
+Unsupported block tag: @export
+Unsupported block tag: @interface
+Unsupported block tag: @export
+Unsupported block tag: @var
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @export
+Unsupported block tag: @interface
+Unsupported block tag: @export
+Unsupported block tag: @interface
+Unsupported block tag: @RequestBody
+Unsupported block tag: @RequestParam
+⠙⠙
+> koatty_router@2.0.6 build:cp
+> copyfiles package.json LICENSE README.md dist/ && node scripts/postBuild
+
+✓ Fixed dependencies.koatty_container: workspace:* → ^1.17.1
+✓ Fixed dependencies.koatty_core: workspace:* → ^2.0.11
+✓ Fixed dependencies.koatty_exception: workspace:* → ^2.0.7
+✓ Fixed dependencies.koatty_graphql: workspace:* → ^1.1.1
+✓ Fixed dependencies.koatty_lib: workspace:* → ^1.4.2
+✓ Fixed dependencies.koatty_logger: workspace:* → ^2.3.1
+✓ Fixed dependencies.koatty_proto: workspace:* → ^1.3.2
+✓ Fixed dependencies.koatty_validation: workspace:* → ^1.6.3
+✓ Fixed main: ./dist/... → ./index.js
+✓ Fixed types: ./dist/... → ./index.d.ts
+✓ Fixed exports.require: ./dist/index.js → ./index.js
+✓ Fixed exports.import: ./dist/index.mjs → ./index.mjs
+✓ Fixed exports.types: ./dist/index.d.ts → ./index.d.ts
+✅ Fixed workspace:* dependencies and paths in dist/package.json
+⠙

package/CHANGELOG.md

@@ -1,46 +1,84 @@
 # Changelog
 
+## 2.0.6
+
+### Patch Changes
+
+- Updated dependencies
+  - koatty_proto@1.3.2
+
+## 2.0.5
+
+### Patch Changes
+
+- Updated dependencies
+  - koatty_lib@1.4.2
+  - koatty_container@1.17.1
+  - koatty_core@2.0.11
+  - koatty_exception@2.0.7
+  - koatty_graphql@1.1.1
+  - koatty_logger@2.3.1
+  - koatty_proto@1.3.1
+  - koatty_validation@1.6.3
+
+## 2.0.4
+
+### Patch Changes
+
+- build
+- build
+- Updated dependencies
+- Updated dependencies
+  - koatty_core@2.0.10
+  - koatty_exception@2.0.6
+  - koatty_validation@1.6.2
+
+## 2.0.3
+
+### Patch Changes
+
+- init
+- Updated dependencies
+  - koatty_core@2.0.9
+  - koatty_exception@2.0.5
+
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
 ### [2.0.2](https://github.com/koatty/koatty_router/compare/koatty-router@2.0.1...koatty-router@2.0.2) (2025-10-25)
 
-
 ### Features
 
-* **trace:** enhance tracing with timeout handling and status checks ([caa6a10](https://github.com/koatty/koatty_router/commit/caa6a10d0d82064567f1a3f8f3146f28a7b7398d))
-
+- **trace:** enhance tracing with timeout handling and status checks ([caa6a10](https://github.com/koatty/koatty_router/commit/caa6a10d0d82064567f1a3f8f3146f28a7b7398d))
 
 ### Bug Fixes
 
-* **koatty-serve:** 修复不稳定的时间相关测试 ([cf2d6b5](https://github.com/koatty/koatty_router/commit/cf2d6b5754a56217df1b912faf7cd40b01dbcbdc))
-* **koatty-trace:** 修复ESLint错误和测试mock问题 ([b24e1f9](https://github.com/koatty/koatty_router/commit/b24e1f9dcc55c64f5d97f3ca01bc53161e7bdb7c))
+- **koatty-serve:** 修复不稳定的时间相关测试 ([cf2d6b5](https://github.com/koatty/koatty_router/commit/cf2d6b5754a56217df1b912faf7cd40b01dbcbdc))
+- **koatty-trace:** 修复 ESLint 错误和测试 mock 问题 ([b24e1f9](https://github.com/koatty/koatty_router/commit/b24e1f9dcc55c64f5d97f3ca01bc53161e7bdb7c))
 
 ### 2.0.1 (2025-10-25)
 
-
 ### ⚠ BREAKING CHANGES
 
-* **scripts:** - Tag格式从 v{version} 改为 {package-name}@{version}
+- **scripts:** - Tag 格式从 v{version} 改为 {package-name}@{version}
 
 ### Features
 
-* add examples directory with basic-app example ([ef49c6f](https://github.com/koatty/koatty_router/commit/ef49c6f932b88ba947fc4c7f448d91b016e3e020))
-* improve type safety in compress middleware ([61beb1d](https://github.com/koatty/koatty_router/commit/61beb1d206bebfd5f6fec9a2d1297f420be217a2))
-* **koatty_core:** upgrade to Koa 3.0 ([fe246ad](https://github.com/koatty/koatty_router/commit/fe246ad773521b6117d212378b07faa30abd17e0))
-* **koatty_router:** migrate from koa-graphql to graphql-http ([847821a](https://github.com/koatty/koatty_router/commit/847821ac80109c6f4fd953e0701ad695e4fb771f))
-* make exception context fields optional and improve trace handling ([e0ec4db](https://github.com/koatty/koatty_router/commit/e0ec4db1ba7299b1d22018558f61288cb2564dc6))
-* **release:** add release guide and automation script ([c5f01b1](https://github.com/koatty/koatty_router/commit/c5f01b17765a9b1eeb07c448b27be5ade9278569))
-* update sync script to use HTTPS instead of SSH for package repos ([91c9fd7](https://github.com/koatty/koatty_router/commit/91c9fd74f080685cb2e8fab66e4765cbf86be57c))
-* upgrade to Koa 3.0 (WIP) ([d14114c](https://github.com/koatty/koatty_router/commit/d14114c63d0f62fcd3a64296cbb6648ec1ee1e83))
-
+- add examples directory with basic-app example ([ef49c6f](https://github.com/koatty/koatty_router/commit/ef49c6f932b88ba947fc4c7f448d91b016e3e020))
+- improve type safety in compress middleware ([61beb1d](https://github.com/koatty/koatty_router/commit/61beb1d206bebfd5f6fec9a2d1297f420be217a2))
+- **koatty_core:** upgrade to Koa 3.0 ([fe246ad](https://github.com/koatty/koatty_router/commit/fe246ad773521b6117d212378b07faa30abd17e0))
+- **koatty_router:** migrate from koa-graphql to graphql-http ([847821a](https://github.com/koatty/koatty_router/commit/847821ac80109c6f4fd953e0701ad695e4fb771f))
+- make exception context fields optional and improve trace handling ([e0ec4db](https://github.com/koatty/koatty_router/commit/e0ec4db1ba7299b1d22018558f61288cb2564dc6))
+- **release:** add release guide and automation script ([c5f01b1](https://github.com/koatty/koatty_router/commit/c5f01b17765a9b1eeb07c448b27be5ade9278569))
+- update sync script to use HTTPS instead of SSH for package repos ([91c9fd7](https://github.com/koatty/koatty_router/commit/91c9fd74f080685cb2e8fab66e4765cbf86be57c))
+- upgrade to Koa 3.0 (WIP) ([d14114c](https://github.com/koatty/koatty_router/commit/d14114c63d0f62fcd3a64296cbb6648ec1ee1e83))
 
 ### Bug Fixes
 
-* **koatty_core:** attempt to fix test timeouts ([fb197ea](https://github.com/koatty/koatty_router/commit/fb197eab7d193616ed4255753c22df0b400c1bc6))
-* resolve workspace dependencies in build process ([d8a2661](https://github.com/koatty/koatty_router/commit/d8a266123fee1dea8ea7be6a39401bf0c052688b))
-* **scripts:** 修复monorepo中tag冲突问题 ([d2602bc](https://github.com/koatty/koatty_router/commit/d2602bcc8c245e6f2137a678ec0e5e2fd6ef673a))
-* **scripts:** 增强release脚本的验证和调试信息 ([2e0db49](https://github.com/koatty/koatty_router/commit/2e0db499234bd4f132bbfc65559105fd9f98f926))
-* 解决依赖问题以支持Koa 3.0升级 ([30cf0b5](https://github.com/koatty/koatty_router/commit/30cf0b53ed032c7de5ea24b4c2ed965e8d4948df))
+- **koatty_core:** attempt to fix test timeouts ([fb197ea](https://github.com/koatty/koatty_router/commit/fb197eab7d193616ed4255753c22df0b400c1bc6))
+- resolve workspace dependencies in build process ([d8a2661](https://github.com/koatty/koatty_router/commit/d8a266123fee1dea8ea7be6a39401bf0c052688b))
+- **scripts:** 修复 monorepo 中 tag 冲突问题 ([d2602bc](https://github.com/koatty/koatty_router/commit/d2602bcc8c245e6f2137a678ec0e5e2fd6ef673a))
+- **scripts:** 增强 release 脚本的验证和调试信息 ([2e0db49](https://github.com/koatty/koatty_router/commit/2e0db499234bd4f132bbfc65559105fd9f98f926))
+- 解决依赖问题以支持 Koa 3.0 升级 ([30cf0b5](https://github.com/koatty/koatty_router/commit/30cf0b53ed032c7de5ea24b4c2ed965e8d4948df))
 
 ## [2.0.0] (2025-03-16)
 

package/dist/index.d.ts

@@ -1,12 +1,14 @@
 /*!
 * @Author: richen
-* @Date: 2025-10-25 10:05:03
+* @Date: 2026-01-28 16:08:27
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/
 */
 import { Application } from 'koatty_container';
-import { Koatty } from 'koatty_core';
+import { IPlugin } from 'koatty_core';
+import { IPluginCapability } from 'koatty_core';
+import { KoattyApplication } from 'koatty_core';
 import { KoattyContext } from 'koatty_core';
 import { KoattyNext } from 'koatty_core';
 import { KoattyRouter } from 'koatty_core';
@@ -121,7 +123,7 @@ export declare interface HttpExtConfig {
  * Router factory interface
  */
 export declare interface IRouterFactory {
-    create(protocol: string, app: Koatty, options: RouterOptions): KoattyRouter;
+    create(protocol: string, app: KoattyApplication, options: RouterOptions): KoattyRouter;
     register(protocol: string, routerClass: RouterConstructor): void;
     getSupportedProtocols(): string[];
 }
@@ -150,7 +152,7 @@ export declare class MiddlewareBuilder {
     enabled(enabled: boolean): this;
     middleware(middleware: MiddlewareFunction): this;
     condition(condition: MiddlewareCondition): this;
-    metadata(key: string, value: any): this;
+    metadata(key: string, value: unknown): this;
     build(): MiddlewareConfig;
     register(app: Application): void;
 }
@@ -174,9 +176,9 @@ export declare interface MiddlewareConfig {
     priority?: number;
     enabled?: boolean;
     conditions?: MiddlewareCondition[];
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     middlewareConfig?: {
-        [key: string]: any;
+        [key: string]: unknown;
     };
 }
 
@@ -204,17 +206,17 @@ export declare interface MiddlewareExecutionContext {
 /**
  * Middleware function type
  */
-export declare type MiddlewareFunction = (ctx: KoattyContext, next: KoattyNext) => Promise<any> | any;
+export declare type MiddlewareFunction = <T = unknown>(ctx: KoattyContext, next: KoattyNext) => Promise<T> | T;
 
 /**
  * get instance of Router using Factory Pattern
  *
  * @export
- * @param {Koatty} app
+ * @param {KoattyApplication} app
  * @param {RouterOptions} options
  * @returns {*}  {KoattyRouter}
  */
-export declare function NewRouter(app: Koatty, opt?: RouterOptions): KoattyRouter;
+export declare function NewRouter(app: KoattyApplication, opt?: RouterOptions): KoattyRouter;
 
 /**
  * Routes HTTP OPTIONS requests to the specified path.
@@ -300,7 +302,7 @@ export declare const PutMapping: (path?: string, routerOptions?: RouterOption) =
 /**
  * Decorator for auto-registering middlewares
  */
-export declare function RegisterMiddleware(app: Application, config: Omit<MiddlewareConfig, 'middleware'>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function RegisterMiddleware(app: Application, config: Omit<MiddlewareConfig, 'middleware'>): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 
 /**
  * Decorator for auto-registering custom routers
@@ -360,7 +362,7 @@ export declare function RequestParam(): ParameterDecorator;
 /**
  * Router constructor type
  */
-export declare type RouterConstructor = new (app: Koatty, options?: RouterOptions) => KoattyRouter;
+export declare type RouterConstructor = new (app: KoattyApplication, options?: RouterOptions) => KoattyRouter;
 
 /**
  * Router factory implementation
@@ -376,7 +378,7 @@ export declare class RouterFactory implements IRouterFactory {
     /**
      * Create router instance
      */
-    create(protocol: string, app: Koatty, options: RouterOptions): KoattyRouter;
+    create(protocol: string, app: KoattyApplication, options: RouterOptions): KoattyRouter;
     /**
      * Register custom router
      */
@@ -636,6 +638,14 @@ export declare interface RouterOptions {
     ext?: Record<string, any>;
 }
 
+export declare class RouterPlugin implements IPlugin {
+    readonly provides: IPluginCapability[];
+    readonly events: {
+        beforeRouterLoad: (app: KoattyApplication) => Promise<void>;
+    };
+    uninstall(_app: KoattyApplication): Promise<void>;
+}
+
 /**
  * gRPC 流配置
  */