koatty_router 2.0.6 → 2.1.0

package/.rollup.config.js

@@ -49,9 +49,16 @@ export default [
           compilerOptions: {
             declaration: false,
             declarationMap: false,
-            module: "ESNext"
+            module: "ESNext",
+            skipLibCheck: true,
+            // 不使用 paths，让 TypeScript 使用 node_modules 中的类型
+            // 这样可以避免类型冲突
           }
-        }
+        },
+        // 使用 cache 来提高性能
+        useTsconfigDeclarationDir: false,
+        // 忽略类型错误，只做转译（类型检查由 build:dts 步骤完成）
+        check: false
       }),
       terser({
         compress: {

package/.turbo/turbo-build.log

@@ -1,20 +1,36 @@
 
 
-> koatty_router@2.0.6 build /Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty-router
+> koatty_router@2.1.0 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
+> koatty_router@2.1.0 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
+created ./dist/index.js, ./dist/index.mjs in 12.6s
 ⠙⠙
-> koatty_router@2.0.6 build:dts
-> npx tsc && npx api-extractor run --local --verbose
+> koatty_router@2.1.0 build:dts
+> bash ../../scripts/build-dts.sh
 
-⠙⠙⠙
+🔨 Building type declarations for koatty-router...
+⏳ Waiting for dependencies to be ready...
+
+🔍 Checking dependencies: koatty_container, koatty_core, koatty_exception, koatty_graphql, koatty_lib, koatty_logger, koatty_proto, koatty_validation
+  ✓ koatty_container type declarations ready
+  ✓ koatty_core type declarations ready
+  ✓ koatty_exception type declarations ready
+  ✓ koatty_graphql type declarations ready
+  ✓ koatty_lib type declarations ready
+  ✓ koatty_logger type declarations ready
+  ✓ koatty_proto type declarations ready
+  ✓ koatty_validation type declarations ready
+
+✅ All dependencies ready (waited 2ms)
+📝 Running TypeScript compiler...
+⠙⠙📦 Running API Extractor...
+
 api-extractor 7.55.2  - https://api-extractor.com/
 
 Using configuration from ./api-extractor.json
@@ -22,6 +38,7 @@ 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/RouterComponent.ts:160:38 - (tsdoc-characters-after-block-tag) The token "@OnEvent" looks like a TSDoc tag but contains an invalid character "("; if it is not a tag, use a backslash to escape the "@"
 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
@@ -96,17 +113,20 @@ Analysis will use the bundled TypeScript version 5.8.2
 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 "{@"
+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}'
+Warning: src/router/router.ts:92: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:92: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:92:67 - (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:92:13 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+Warning: src/router/router.ts:92:18 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
+Warning: src/router/router.ts:92:19 - (tsdoc-malformed-inline-tag) Expecting a TSDoc tag starting with "{@"
 
 API Extractor completed successfully
-⠙⠙
-> koatty_router@2.0.6 build:doc
+⠙✅ Type declarations built successfully
+⠙
+> koatty_router@2.1.0 build:doc
 > npx api-documenter markdown --input temp --output docs/api
 
 
@@ -149,17 +169,17 @@ Unsupported block tag: @interface
 Unsupported block tag: @RequestBody
 Unsupported block tag: @RequestParam
 ⠙⠙
-> koatty_router@2.0.6 build:cp
+> koatty_router@2.1.0 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 dependencies.koatty_container: workspace:* → ^2.0.0
+✓ Fixed dependencies.koatty_core: workspace:* → ^2.1.0
+✓ Fixed dependencies.koatty_exception: workspace:* → ^2.1.0
+✓ Fixed dependencies.koatty_graphql: workspace:* → ^1.1.4
+✓ Fixed dependencies.koatty_lib: workspace:* → ^1.4.5
+✓ Fixed dependencies.koatty_logger: workspace:* → ^2.4.0
+✓ Fixed dependencies.koatty_proto: workspace:* → ^1.3.5
+✓ Fixed dependencies.koatty_validation: workspace:* → ^2.0.0
 ✓ Fixed main: ./dist/... → ./index.js
 ✓ Fixed types: ./dist/... → ./index.d.ts
 ✓ Fixed exports.require: ./dist/index.js → ./index.js

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # Changelog
 
+## 2.1.0
+
+### Minor Changes
+
+- build
+
+### Patch Changes
+
+- Updated dependencies
+  - koatty_container@2.0.0
+  - koatty_core@2.1.0
+  - koatty_exception@2.1.0
+  - koatty_logger@2.4.0
+  - koatty_validation@2.0.0
+
+## 2.0.9
+
+### Patch Changes
+
+- build
+- Updated dependencies
+  - koatty_container@1.17.4
+  - koatty_core@2.0.14
+  - koatty_exception@2.0.10
+  - koatty_graphql@1.1.4
+  - koatty_lib@1.4.5
+  - koatty_logger@2.3.4
+  - koatty_proto@1.3.5
+  - koatty_validation@1.6.6
+
+## 2.0.8
+
+### Patch Changes
+
+- build
+- Updated dependencies
+  - koatty_container@1.17.3
+  - koatty_core@2.0.13
+  - koatty_exception@2.0.9
+  - koatty_graphql@1.1.3
+  - koatty_lib@1.4.4
+  - koatty_logger@2.3.3
+  - koatty_proto@1.3.4
+  - koatty_validation@1.6.5
+
+## 2.0.7
+
+### Patch Changes
+
+- Updated dependencies
+  - koatty_container@1.17.2
+  - koatty_graphql@1.1.2
+  - koatty_lib@1.4.3
+  - koatty_logger@2.3.2
+  - koatty_proto@1.3.3
+  - koatty_validation@1.6.4
+  - koatty_core@2.0.12
+  - koatty_exception@2.0.8
+
 ## 2.0.6
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,13 +1,12 @@
 /*!
 * @Author: richen
-* @Date: 2026-01-28 16:08:27
+* @Date: 2026-01-31 09:50:30
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/
 */
 import { Application } from 'koatty_container';
-import { IPlugin } from 'koatty_core';
-import { IPluginCapability } from 'koatty_core';
+import { IComponent } from 'koatty_core';
 import { KoattyApplication } from 'koatty_core';
 import { KoattyContext } from 'koatty_core';
 import { KoattyNext } from 'koatty_core';
@@ -214,9 +213,12 @@ export declare type MiddlewareFunction = <T = unknown>(ctx: KoattyContext, next:
  * @export
  * @param {KoattyApplication} app
  * @param {RouterOptions} options
- * @returns {*}  {KoattyRouter}
+ * @returns {*}  {{ router: KoattyRouter, factory: RouterFactory }}
  */
-export declare function NewRouter(app: KoattyApplication, opt?: RouterOptions): KoattyRouter;
+export declare function NewRouter(app: KoattyApplication, opt?: RouterOptions): {
+    router: KoattyRouter;
+    factory: RouterFactory;
+};
 
 /**
  * Routes HTTP OPTIONS requests to the specified path.
@@ -359,6 +361,42 @@ export declare enum RequestMethod {
  */
 export declare function RequestParam(): ParameterDecorator;
 
+/**
+ * Router Component
+ * Responsible for initializing and managing routing
+ *
+ * Implements IComponent interface (base interface)
+ *
+ * Event bindings:
+ * - loadRouter: Initialize router
+ * - appStop: Cleanup router resources
+ */
+export declare class RouterComponent implements IComponent {
+    events: Record<string, any>;
+    /**
+     * Initialize router and load routes
+     *
+     * This method handles the complete router initialization:
+     * 1. Create router instance(s) for configured protocol(s)
+     * 2. Bind router to app.router
+     * 3. Load controller routes into router
+     */
+    initRouter(app: KoattyApplication): Promise<void>;
+    /**
+     * Load controller routes into router
+     *
+     * @param app - Koatty application instance
+     */
+    run(app: KoattyApplication): Promise<void>;
+    /**
+     * Cleanup router resources on app stop
+     *
+     * NOTE: Original app.once("appStop", ...) listener in router.ts
+     * is now unified to be handled by @OnEvent(AppEvent.appStop) decorator
+     */
+    cleanup(_app: KoattyApplication): Promise<void>;
+}
+
 /**
  * Router constructor type
  */
@@ -614,38 +652,32 @@ export declare interface RouterOptions {
      *
      * @example
      * ```typescript
-     * // WebSocket 配置
-     * ext: {
-     *   maxFrameSize: 1024 * 1024,
-     *   heartbeatInterval: 15000,
-     *   maxConnections: 1000
-     * }
-     *
-     * // gRPC 配置
      * ext: {
-     *   protoFile: "./proto/service.proto",
-     *   poolSize: 10,
-     *   streamConfig: { maxConcurrentStreams: 50 }
-     * }
-     *
-     * // GraphQL 配置
-     * ext: {
-     *   schemaFile: "./schema/schema.graphql",
-     *   playground: true
+     *   http: {},
+     *   grpc: {
+     *     protoFile: "./proto/service.proto",
+     *     poolSize: 10,
+     *     streamConfig: { maxConcurrentStreams: 50 }
+     *   },
+     *   graphql: {
+     *     schemaFile: "./resource/graphql/schema.graphql",
+     *     // Optional: Enable HTTP/2 with SSL for GraphQL
+     *     // keyFile: "./ssl/server.key",
+     *     // crtFile: "./ssl/server.crt",
+     *     // ssl: { mode: 'auto', allowHTTP1: true },
+     *     // http2: { maxConcurrentStreams: 100 }
+     *   },
+     *   ws: {
+     *     maxFrameSize: 1024 * 1024,
+     *     heartbeatInterval: 15000,
+     *     maxConnections: 1000
+     *   }
      * }
      * ```
      */
     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 流配置
  */