@dangao/bun-server 2.0.8 → 2.2.0

package/dist/microservice/service-registry/service-registry-module.d.ts

@@ -1,4 +1,5 @@
 import type { NacosClientOptions } from '@dangao/nacos-client';
+import { type ServiceInstance } from './types';
 /**
  * 服务注册中心 Provider 类型
  */
@@ -34,11 +35,26 @@ export interface ServiceRegistryModuleOptions {
      * Nacos 配置（当 provider 为 'nacos' 时使用）
      */
     nacos?: NacosServiceRegistryOptions;
+    /**
+     * 是否自动在 Application.listen 时注册带 @ServiceRegistry 的服务
+     * @default true
+     */
+    autoRegister?: boolean;
+    /**
+     * 通过模块配置自动注册服务（无需 @ServiceRegistry 装饰器）
+     * 当 autoRegister=true 时在 Application.listen 阶段自动注册
+     */
+    autoRegisterService?: Omit<ServiceInstance, 'ip' | 'port'> & {
+        ip?: string;
+        port?: number;
+    };
 }
 /**
  * 服务注册中心模块
  */
 export declare class ServiceRegistryModule {
+    static autoRegister: boolean;
+    static autoRegisterService: ServiceRegistryModuleOptions['autoRegisterService'];
     /**
      * 创建服务注册中心模块
      * @param options - 模块配置

package/dist/microservice/service-registry/service-registry-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-registry-module.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-registry/service-registry-module.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,EAAE,uBAAuB,CAAC;IAElC;;OAEG;IACH,KAAK,CAAC,EAAE,2BAA2B,CAAC;CAKrC;AAED;;GAEG;AACH,qBAGa,qBAAqB;IAChC;;;OAGG;WACW,OAAO,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,qBAAqB;CAwC3F"}
+{"version":3,"file":"service-registry-module.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-registry/service-registry-module.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,EAAE,uBAAuB,CAAC;IAElC;;OAEG;IACH,KAAK,CAAC,EAAE,2BAA2B,CAAC;IAEpC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG;QAC3D,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CAKH;AAED;;GAEG;AACH,qBAGa,qBAAqB;IAChC,OAAc,YAAY,UAAQ;IAClC,OAAc,mBAAmB,EAAE,4BAA4B,CAAC,qBAAqB,CAAC,CAAC;IAEvF;;;OAGG;WACW,OAAO,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,qBAAqB;CA0C3F"}

package/dist/router/index.d.ts

@@ -2,5 +2,6 @@ export { Route } from './route';
 export { Router } from './router';
 export { RouteRegistry } from './registry';
 export { GET, POST, PUT, DELETE, PATCH } from './decorators';
+export { IdleTimeout, IDLE_TIMEOUT_KEY, getIdleTimeout } from './timeout-decorator';
 export type { HttpMethod, RouteHandler, RouteMatch } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/router/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpF,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/router/registry.d.ts

@@ -24,7 +24,7 @@ export declare class RouteRegistry {
      * @param controllerClass - 控制器类（可选）
      * @param methodName - 方法名（可选）
      */
-    register(method: HttpMethod, path: string, handler: RouteHandler, middlewares?: Middleware[], controllerClass?: Constructor<unknown>, methodName?: string): void;
+    register(method: HttpMethod, path: string, handler: RouteHandler, middlewares?: Middleware[], controllerClass?: Constructor<unknown>, methodName?: string, timeout?: number): void;
     /**
      * 注册 GET 路由
      */

package/dist/router/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/router/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO;IAIP;;;OAGG;WACW,WAAW,IAAI,aAAa;IAO1C;;;;;;;;OAQG;IACI,QAAQ,CACb,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,UAAU,EAAO,EAC9B,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAIP;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;OAEG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAItF;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIxF;;OAEG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIvF;;;OAGG;IACI,SAAS,IAAI,MAAM;IAI1B;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/router/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO;IAIP;;;OAGG;WACW,WAAW,IAAI,aAAa;IAO1C;;;;;;;;OAQG;IACI,QAAQ,CACb,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,UAAU,EAAO,EAC9B,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;IAYP;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;OAEG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAItF;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIxF;;OAEG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIvF;;;OAGG;IACI,SAAS,IAAI,MAAM;IAI1B;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB"}

package/dist/router/route.d.ts

@@ -38,7 +38,8 @@ export declare class Route {
     private readonly middlewarePipeline;
     private readonly staticKey?;
     readonly isStatic: boolean;
-    constructor(method: HttpMethod, path: string, handler: RouteHandler, middlewares?: Middleware[], controllerClass?: Constructor<unknown>, methodName?: string);
+    private readonly timeout?;
+    constructor(method: HttpMethod, path: string, handler: RouteHandler, middlewares?: Middleware[], controllerClass?: Constructor<unknown>, methodName?: string, timeout?: number);
     /**
      * 解析路径，生成匹配模式和参数名列表
      */

package/dist/router/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/router/route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;GAGG;AACH,qBAAa,KAAK;IAChB;;OAEG;IACH,SAAgB,MAAM,EAAE,UAAU,CAAC;IAEnC;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,OAAO,EAAE,YAAY,CAAC;IAEtC;;OAEG;IACH,SAAgB,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAEvD;;OAEG;IACH,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAElC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAW;IAEvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA4B;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,SAAgB,QAAQ,EAAE,OAAO,CAAC;gBAGhC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,UAAU,EAAO,EAC9B,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM;IAmBrB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAYxB;;;;;OAKG;IACI,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;IAwB1D;;;;OAIG;IACU,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQzD;;OAEG;IACI,YAAY,IAAI,MAAM,GAAG,SAAS;CAG1C"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/router/route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD;;;GAGG;AACH,qBAAa,KAAK;IAChB;;OAEG;IACH,SAAgB,MAAM,EAAE,UAAU,CAAC;IAEnC;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,OAAO,EAAE,YAAY,CAAC;IAEtC;;OAEG;IACH,SAAgB,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAEvD;;OAEG;IACH,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAElC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAW;IAEvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA4B;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,SAAgB,QAAQ,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;gBAGhC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,UAAU,EAAO,EAC9B,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM;IAoBlB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAYxB;;;;;OAKG;IACI,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;IAwB1D;;;;OAIG;IACU,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgCzD;;OAEG;IACI,YAAY,IAAI,MAAM,GAAG,SAAS;CAG1C"}

package/dist/router/router.d.ts

@@ -32,7 +32,7 @@ export declare class Router {
      * @param controllerClass - 控制器类（可选）
      * @param methodName - 方法名（可选）
      */
-    register(method: HttpMethod, path: string, handler: RouteHandler, middlewares?: Middleware[], controllerClass?: Constructor<unknown>, methodName?: string): void;
+    register(method: HttpMethod, path: string, handler: RouteHandler, middlewares?: Middleware[], controllerClass?: Constructor<unknown>, methodName?: string, timeout?: number): void;
     /**
      * 注册 GET 路由
      * @param path - 路由路径

package/dist/router/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD;;;GAGG;AACH,qBAAa,MAAM;IACjB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0D;IAErF;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;;;OAQG;IACI,QAAQ,CACb,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,UAAU,EAAO,EAC9B,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAgBP;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAItF;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIxF;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIvF;;;;;OAKG;IACI,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAKrE;;;;;OAKG;IACI,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,SAAS;IAmC5G;;;OAGG;IACU,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCvD;;;;OAIG;IACU,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAmCpE;;;OAGG;IACI,SAAS,IAAI,SAAS,KAAK,EAAE;IAIpC;;OAEG;IACI,KAAK,IAAI,IAAI;CAMrB"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD;;;GAGG;AACH,qBAAa,MAAM;IACjB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0D;IAErF;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;;;OAQG;IACI,QAAQ,CACb,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,UAAU,EAAO,EAC9B,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;IAwBP;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAItF;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIxF;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIvF;;;;;OAKG;IACI,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAKrE;;;;;OAKG;IACI,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,SAAS;IAmC5G;;;OAGG;IACU,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCvD;;;;OAIG;IACU,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAmCpE;;;OAGG;IACI,SAAS,IAAI,SAAS,KAAK,EAAE;IAIpC;;OAEG;IACI,KAAK,IAAI,IAAI;CAMrB"}

package/dist/router/timeout-decorator.d.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+import type { Constructor } from '../core/types';
+export declare const IDLE_TIMEOUT_KEY: unique symbol;
+export declare function IdleTimeout(ms: number): MethodDecorator & ClassDecorator;
+export declare function getIdleTimeout(controllerClass: Constructor<unknown>, methodName: string): number | undefined;
+//# sourceMappingURL=timeout-decorator.d.ts.map

package/dist/router/timeout-decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-decorator.d.ts","sourceRoot":"","sources":["../../src/router/timeout-decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,eAAO,MAAM,gBAAgB,eAAkD,CAAC;AAEhF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,cAAc,CAQxE;AAED,wBAAgB,cAAc,CAC5B,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,EACrC,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAcpB"}

package/docs/database.md

@@ -1,23 +1,56 @@
 # Database
 
-This page summarizes database-related documentation in Bun Server Framework.
+Database module v2 is built on top of native `Bun.SQL` and adds request-level strategy routing.
 
-## Core Database Capabilities
+## V2 Highlights
 
-- `DatabaseModule`: connection management, health checks, and SQL access.
-- ORM support: entity metadata, repositories, and query helpers.
-- Transactions: declarative transaction boundaries and rollback handling.
+- Native Bun.SQL pool passthrough (no custom physical pool implementation)
+- `db` proxy as the preferred query entry (`import { db } from '@dangao/bun-server'`)
+- Route strategy control with `@DbStrategy('pool' | 'session')` and `@DbSession()`
+- Session strategy uses lazy `reserve()` + request ALS context
+- `db.transaction()` and `@Transactional()` are unified through `TransactionManager`
+- SQLite improvements: `WAL` mode and write-concurrency guard
 
-## Recommended Reading
+## Configuration
+
+```ts
+DatabaseModule.forRoot({
+  type: 'postgres',
+  url: process.env.DB_URL!,
+  bunSqlPool: {
+    max: 20,
+    idleTimeout: 30,
+  },
+  defaultStrategy: 'pool',
+});
+```
+
+## Route strategy
 
-- [API Reference](./api.md)
-- [Best Practices](./best-practices.md)
-- [Testing](./testing.md)
-- [Migration Guide](./migration.md)
+```ts
+import { Controller, GET, POST, db, DbSession } from '@dangao/bun-server';
 
-## Typical Setup
+@Controller('/users')
+class UserController {
+  @GET('/')
+  public async list() {
+    return await db`SELECT * FROM users`;
+  }
+
+  @DbSession()
+  @POST('/')
+  public async create() {
+    return await db.transaction(async () => {
+      await db`INSERT INTO users (name) VALUES (${'alice'})`;
+      await db`UPDATE stats SET user_count = user_count + 1`;
+      return { ok: true };
+    });
+  }
+}
+```
+
+## Recommended Reading
 
-1. Configure `DatabaseModule.forRoot(...)` in the root module.
-2. Define entities/repositories per feature module.
-3. Use transactions for multi-step write operations.
-4. Add health checks and monitor connection pool metrics.
+- [Lifecycle](./lifecycle.md)
+- [idleTimeout](./idle-timeout.md)
+- [Service Registry](./microservice-service-registry.md)

package/docs/idle-timeout.md

@@ -0,0 +1,42 @@
+# idleTimeout
+
+`idleTimeout` now supports both global and per-route configuration.
+
+## Global idle timeout (milliseconds)
+
+Set in `Application` options using milliseconds.  
+Framework converts internally before passing to `Bun.serve`.
+
+```ts
+const app = new Application({
+  port: 3000,
+  idleTimeout: 15000, // ms
+});
+```
+
+## Per-route timeout (milliseconds)
+
+Use `@IdleTimeout(ms)` on controller class or handler method.
+
+```ts
+import { Controller, GET, IdleTimeout } from '@dangao/bun-server';
+
+@Controller('/api')
+@IdleTimeout(5000) // class-level default
+class ApiController {
+  @GET('/fast')
+  public fast() {
+    return { ok: true };
+  }
+
+  @GET('/slow')
+  @IdleTimeout(1000) // method-level overrides class-level
+  public async slow() {
+    await new Promise((resolve) => setTimeout(resolve, 2000));
+    return { ok: true };
+  }
+}
+```
+
+When timeout is reached, Bun Server throws `HttpException(408, "Request Timeout")`.
+

package/docs/lifecycle.md

@@ -1,35 +1,71 @@
 # Lifecycle Hooks
 
-Bun Server supports lifecycle hooks that let providers participate in application startup and shutdown. Implement the appropriate interface on your injectable services.
+Bun Server supports lifecycle hooks that let components (`@Injectable` / `@Controller`) participate from creation to destruction.
 
 ## Interfaces
 
 | Interface | Method | When Called |
 |-----------|--------|-------------|
+| `ComponentClassBeforeCreate` | `static onBeforeCreate()` | Right before the component instance is created |
+| `OnAfterCreate` | `onAfterCreate()` | Right after instance creation and post processors |
 | `OnModuleInit` | `onModuleInit()` | After all module providers are registered |
 | `OnModuleDestroy` | `onModuleDestroy()` | During shutdown (reverse order) |
+| `OnBeforeDestroy` | `onBeforeDestroy()` | Before `onModuleDestroy` during shutdown (reverse order) |
+| `OnAfterDestroy` | `onAfterDestroy()` | After `onModuleDestroy` during shutdown (reverse order) |
 | `OnApplicationBootstrap` | `onApplicationBootstrap()` | After all modules init, before server listens |
 | `OnApplicationShutdown` | `onApplicationShutdown(signal?)` | When graceful shutdown begins |
 
 ## Execution Order
 
+**Creation (per component instance)**: `onBeforeCreate` (static) -> instantiate -> `onAfterCreate`
+
 **Startup**: `onModuleInit` (all modules) -> `onApplicationBootstrap` (all modules) -> server starts
 
-**Shutdown**: `onApplicationShutdown` (reverse order) -> `onModuleDestroy` (reverse order)
+**Shutdown**: `onApplicationShutdown` (reverse order) -> `onBeforeDestroy` (reverse order) -> `onModuleDestroy` (reverse order) -> `onAfterDestroy` (reverse order)
+
+For `Lifecycle.Scoped` components, destroy hooks are executed automatically at the end of each request context.
+
+## Provider Deduplication
+
+When the same provider instance is exported or registered by multiple tokens,
+`onModuleInit` now runs only once for that instance. This avoids duplicate
+initialization side effects in shared singleton objects.
 
-## Example: DatabaseService with init/destroy
+## Example: Component hooks from create to destroy
 
 ```ts
 import {
   Injectable,
+  Controller,
+  GET,
+  Module,
   OnModuleInit,
   OnModuleDestroy,
+  type ComponentClassBeforeCreate,
+  OnAfterCreate,
+  OnBeforeDestroy,
+  OnAfterDestroy,
 } from '@dangao/bun-server';
 
 @Injectable()
-class DatabaseService implements OnModuleInit, OnModuleDestroy {
+class DatabaseService
+  implements
+    OnAfterCreate,
+    OnModuleInit,
+    OnBeforeDestroy,
+    OnModuleDestroy,
+    OnAfterDestroy
+{
   private connected = false;
 
+  public static onBeforeCreate(): void {
+    console.log('[DatabaseService] Before create');
+  }
+
+  public onAfterCreate(): void {
+    console.log('[DatabaseService] After create');
+  }
+
   public async onModuleInit(): Promise<void> {
     console.log('[DatabaseService] Connecting...');
     await this.connect();
@@ -42,6 +78,14 @@ class DatabaseService implements OnModuleInit, OnModuleDestroy {
     this.connected = false;
   }
 
+  public onBeforeDestroy(): void {
+    console.log('[DatabaseService] Before destroy');
+  }
+
+  public onAfterDestroy(): void {
+    console.log('[DatabaseService] After destroy');
+  }
+
   public isConnected(): boolean {
     return this.connected;
   }
@@ -54,6 +98,36 @@ class DatabaseService implements OnModuleInit, OnModuleDestroy {
     // Close DB connection
   }
 }
+
+@Controller('/health')
+class HealthController implements OnAfterCreate, OnBeforeDestroy, OnAfterDestroy {
+  public static onBeforeCreate(): void {
+    console.log('[HealthController] Before create');
+  }
+
+  public onAfterCreate(): void {
+    console.log('[HealthController] After create');
+  }
+
+  public onBeforeDestroy(): void {
+    console.log('[HealthController] Before destroy');
+  }
+
+  public onAfterDestroy(): void {
+    console.log('[HealthController] After destroy');
+  }
+
+  @GET('/')
+  public get(): object {
+    return { ok: true };
+  }
+}
+
+@Module({
+  controllers: [HealthController],
+  providers: [DatabaseService],
+})
+class AppModule {}
 ```
 
 ## Example: Application-level hooks
@@ -69,4 +143,6 @@ class AppService implements OnApplicationBootstrap, OnApplicationShutdown {
     console.log(`Shutting down (signal: ${signal ?? 'none'})`);
   }
 }
+
+const _beforeCreateHook: ComponentClassBeforeCreate = DatabaseService;
 ```

package/docs/microservice-nacos.md

@@ -121,6 +121,7 @@ import { ServiceRegistryModule } from '@dangao/bun-server';
 app.registerModule(
   ServiceRegistryModule.forRoot({
     provider: 'nacos',
+    autoRegister: true, // set false to disable listen-time auto registration
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],

package/docs/microservice-service-registry.md

@@ -35,6 +35,7 @@ const app = new Application();
 app.registerModule(
   ServiceRegistryModule.forRoot({
     provider: 'nacos',
+    autoRegister: true, // default true
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
@@ -48,6 +49,12 @@ app.registerModule(
 );
 ```
 
+### Auto Register Switch
+
+`ServiceRegistryModule.forRoot({ autoRegister: false })` disables automatic
+service registration in `Application.listen()`. This is useful when you need
+manual registration timing or custom startup orchestration.
+
 ### 2. Register Service
 
 ```typescript

package/docs/zh/database.md

@@ -1,23 +1,56 @@
 # 数据库（Database）
 
-本页用于汇总 Bun Server Framework 的数据库相关文档入口。
+数据库模块 V2 基于原生 `Bun.SQL` 实现，并提供请求级连接策略控制。
 
-## 核心数据库能力
+## V2 关键能力
 
-- `DatabaseModule`：连接管理、健康检查、SQL 访问。
-- ORM 支持：实体元数据、Repository、查询辅助能力。
-- 事务支持：声明式事务边界与回滚处理。
+- 原生 Bun.SQL 连接池参数透传（不重复造物理连接池）
+- 推荐统一入口：`import { db } from '@dangao/bun-server'`
+- 路由级策略：`@DbStrategy('pool' | 'session')` / `@DbSession()`
+- session 策略：首次查询惰性 `reserve()` + ALS 请求上下文绑定
+- `db.transaction()` 与 `@Transactional()` 统一事务路径
+- SQLite 增强：默认 `WAL` + 写并发保护
 
-## 推荐阅读
+## 配置示例
+
+```ts
+DatabaseModule.forRoot({
+  type: 'postgres',
+  url: process.env.DB_URL!,
+  bunSqlPool: {
+    max: 20,
+    idleTimeout: 30,
+  },
+  defaultStrategy: 'pool',
+});
+```
+
+## 路由策略示例
 
-- [API 参考](./api.md)
-- [最佳实践](./best-practices.md)
-- [测试指南](./testing.md)
-- [迁移指南](./migration.md)
+```ts
+import { Controller, GET, POST, db, DbSession } from '@dangao/bun-server';
 
-## 常见接入步骤
+@Controller('/users')
+class UserController {
+  @GET('/')
+  public async list() {
+    return await db`SELECT * FROM users`;
+  }
+
+  @DbSession()
+  @POST('/')
+  public async create() {
+    return await db.transaction(async () => {
+      await db`INSERT INTO users (name) VALUES (${'alice'})`;
+      await db`UPDATE stats SET user_count = user_count + 1`;
+      return { ok: true };
+    });
+  }
+}
+```
+
+## 推荐阅读
 
-1. 在根模块配置 `DatabaseModule.forRoot(...)`。
-2. 按业务模块定义实体与仓储。
-3. 多步骤写操作使用事务保证一致性。
-4. 配置健康检查并监控连接池指标。
+- [生命周期](./lifecycle.md)
+- [idleTimeout](./idle-timeout.md)
+- [服务注册与发现](./microservice-service-registry.md)

package/docs/zh/idle-timeout.md

@@ -0,0 +1,41 @@
+# idleTimeout
+
+`idleTimeout` 现已支持全局与路由级两种配置方式。
+
+## 全局 idleTimeout（毫秒）
+
+在 `Application` 中直接按毫秒设置，框架内部会转换后传给 `Bun.serve`。
+
+```ts
+const app = new Application({
+  port: 3000,
+  idleTimeout: 15000, // ms
+});
+```
+
+## 路由级超时（毫秒）
+
+使用 `@IdleTimeout(ms)` 装饰器配置控制器级或方法级超时。
+
+```ts
+import { Controller, GET, IdleTimeout } from '@dangao/bun-server';
+
+@Controller('/api')
+@IdleTimeout(5000) // 控制器级默认值
+class ApiController {
+  @GET('/fast')
+  public fast() {
+    return { ok: true };
+  }
+
+  @GET('/slow')
+  @IdleTimeout(1000) // 方法级优先
+  public async slow() {
+    await new Promise((resolve) => setTimeout(resolve, 2000));
+    return { ok: true };
+  }
+}
+```
+
+超时后会抛出 `HttpException(408, "Request Timeout")`。
+

package/docs/zh/lifecycle.md

@@ -1,19 +1,31 @@
 # 生命周期钩子
 
-Bun Server 提供四个生命周期接口，用于在模块和应用启动、关闭时执行初始化或清理逻辑。
+Bun Server 支持组件级生命周期钩子，可让 `@Injectable` / `@Controller` 从创建前到销毁后执行自定义逻辑。
 
 ## 接口定义
 
-- **OnModuleInit**：`onModuleInit()`，在模块所有 providers 注册完成后调用
-- **OnModuleDestroy**：`onModuleDestroy()`，在应用关闭时调用（反向顺序）
+- **ComponentClassBeforeCreate**：`static onBeforeCreate()`，组件实例创建前调用
+- **OnAfterCreate**：`onAfterCreate()`，组件实例创建并完成后处理后调用
+- **OnModuleInit**：`onModuleInit()`，在模块所有组件初始化阶段调用
 - **OnApplicationBootstrap**：`onApplicationBootstrap()`，在所有模块初始化完成后、服务器开始监听前调用
 - **OnApplicationShutdown**：`onApplicationShutdown(signal?)`，在优雅停机开始时调用
+- **OnBeforeDestroy**：`onBeforeDestroy()`，在 `onModuleDestroy()` 前调用（反向顺序）
+- **OnModuleDestroy**：`onModuleDestroy()`，在应用关闭时调用（反向顺序）
+- **OnAfterDestroy**：`onAfterDestroy()`，在 `onModuleDestroy()` 后调用（反向顺序）
 
 ## 执行顺序
 
+**创建阶段（每个组件实例）**：`onBeforeCreate`（静态）→ 实例化 → `onAfterCreate`
+
 **启动阶段**：`onModuleInit` → `onApplicationBootstrap`
 
-**关闭阶段**：`onApplicationShutdown` → `onModuleDestroy`（均为反向顺序，即后注册的先执行）
+**关闭阶段**：`onApplicationShutdown` → `onBeforeDestroy` → `onModuleDestroy` → `onAfterDestroy`（均为反向顺序，即后注册的先执行）
+
+对于 `Lifecycle.Scoped` 组件，请求上下文结束时会自动触发其销毁钩子。
+
+## 组件去重行为
+
+当同一个组件实例通过多个 token 重复注册/导出时，生命周期钩子只会执行一次，避免共享单例出现重复副作用。
 
 ## 示例：DatabaseService 的初始化和销毁
 
@@ -36,6 +48,14 @@ import type {
 class DatabaseService implements OnModuleInit, OnModuleDestroy {
   private connected = false;
 
+  public static onBeforeCreate(): void {
+    console.log('[DatabaseService] 创建前');
+  }
+
+  public onAfterCreate(): void {
+    console.log('[DatabaseService] 创建后');
+  }
+
   public async onModuleInit(): Promise<void> {
     console.log('[DatabaseService] 正在连接数据库...');
     await new Promise((resolve) => setTimeout(resolve, 100));
@@ -49,6 +69,14 @@ class DatabaseService implements OnModuleInit, OnModuleDestroy {
     console.log('[DatabaseService] 已断开');
   }
 
+  public onBeforeDestroy(): void {
+    console.log('[DatabaseService] 销毁前');
+  }
+
+  public onAfterDestroy(): void {
+    console.log('[DatabaseService] 销毁后');
+  }
+
   public isConnected(): boolean {
     return this.connected;
   }
@@ -67,6 +95,22 @@ class AppService implements OnApplicationBootstrap, OnApplicationShutdown {
 
 @Controller('/api')
 class AppController {
+  public static onBeforeCreate(): void {
+    console.log('[AppController] 创建前');
+  }
+
+  public onAfterCreate(): void {
+    console.log('[AppController] 创建后');
+  }
+
+  public onBeforeDestroy(): void {
+    console.log('[AppController] 销毁前');
+  }
+
+  public onAfterDestroy(): void {
+    console.log('[AppController] 销毁后');
+  }
+
   @GET('/status')
   public status(): object {
     return { status: 'running', timestamp: Date.now() };
@@ -84,4 +128,4 @@ app.registerModule(AppModule);
 await app.listen();
 ```
 
-按 Ctrl+C 触发关闭时，将依次执行 `onApplicationShutdown` 和 `onModuleDestroy`。
+按 Ctrl+C 触发关闭时，将依次执行 `onApplicationShutdown`、`onBeforeDestroy`、`onModuleDestroy`、`onAfterDestroy`。

package/docs/zh/microservice-nacos.md

@@ -121,6 +121,7 @@ import { ServiceRegistryModule } from '@dangao/bun-server';
 app.registerModule(
   ServiceRegistryModule.forRoot({
     provider: 'nacos',
+    autoRegister: true, // 设为 false 可关闭 listen 阶段自动注册
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],

package/docs/zh/microservice-service-registry.md

@@ -35,6 +35,7 @@ const app = new Application();
 app.registerModule(
   ServiceRegistryModule.forRoot({
     provider: 'nacos',
+    autoRegister: true, // 默认 true
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
@@ -48,6 +49,11 @@ app.registerModule(
 );
 ```
 
+### 自动注册开关
+
+通过 `ServiceRegistryModule.forRoot({ autoRegister: false })` 可关闭
+`Application.listen()` 阶段的自动注册，适用于需要手动控制注册时机的场景。
+
 ### 2. 注册服务
 
 ```typescript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dangao/bun-server",
-  "version": "2.0.8",
+  "version": "2.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",