@dangao/bun-server 1.9.0 → 1.12.0

package/dist/router/route.d.ts

@@ -28,23 +28,21 @@ export declare class Route {
      */
     readonly methodName?: string;
     /**
-     * 路径模式（用于匹配）
+     * 动态路由匹配用正则（比 URLPattern.exec() 快约 10 倍）
      */
-    private readonly pattern;
+    private readonly pattern?;
     /**
-     * 路径参数名列表
+     * 动态路由参数名列表
      */
-    private readonly paramNames;
+    private readonly paramNames?;
     private readonly middlewarePipeline;
     private readonly staticKey?;
     readonly isStatic: boolean;
     constructor(method: HttpMethod, path: string, handler: RouteHandler, middlewares?: Middleware[], controllerClass?: Constructor<unknown>, methodName?: string);
     /**
      * 解析路径，生成匹配模式和参数名列表
-     * @param path - 路由路径
-     * @returns 匹配模式和参数名列表
      */
-    private parsePath;
+    private static parsePath;
     /**
      * 匹配路由
      * @param method - HTTP 方法

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,CAAS;IAEjC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAW;IAEtC,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;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAajB;;;;;OAKG;IACI,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;IAqB1D;;;;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;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"}

package/dist/swagger/generator.d.ts

@@ -9,6 +9,16 @@ export declare class SwaggerGenerator {
      * 生成 Swagger 文档
      */
     generate(): SwaggerDocument;
+    /**
+     * 生成 Markdown 格式的 API 文档
+     * 利用 Bun 1.3.8+ 原生 Bun.markdown 内置解析器
+     */
+    generateMarkdown(): string;
+    /**
+     * 生成 Markdown 并渲染为 HTML
+     * 利用 Bun.markdown.html() 进行高性能渲染
+     */
+    generateMarkdownHtml(): string;
     /**
      * 规范化路径
      */

package/dist/swagger/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/swagger/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAmB,MAAM,SAAS,CAAC;AAWhF;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAEtB,OAAO,EAAE,cAAc;IAI1C;;OAEG;IACI,QAAQ,IAAI,eAAe;IAgMlC;;OAEG;IACH,OAAO,CAAC,aAAa;CAatB"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/swagger/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAmB,MAAM,SAAS,CAAC;AAWhF;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAEtB,OAAO,EAAE,cAAc;IAI1C;;OAEG;IACI,QAAQ,IAAI,eAAe;IAgMlC;;;OAGG;IACI,gBAAgB,IAAI,MAAM;IAuFjC;;;OAGG;IACI,oBAAoB,IAAI,MAAM;IAKrC;;OAEG;IACH,OAAO,CAAC,aAAa;CAatB"}

package/dist/testing/test-client.d.ts

@@ -0,0 +1,49 @@
+import type { Application } from '../core/application';
+interface RequestOptions {
+    headers?: Record<string, string>;
+    body?: unknown;
+    query?: Record<string, string>;
+}
+interface TestResponse {
+    status: number;
+    headers: Headers;
+    body: unknown;
+    text: string;
+    ok: boolean;
+}
+/**
+ * HTTP 测试客户端
+ * 基于 fetch API，提供简洁的 HTTP 请求方法
+ */
+export declare class TestHttpClient {
+    private readonly baseUrl;
+    private readonly app;
+    constructor(baseUrl: string, app: Application);
+    /**
+     * 发送 GET 请求
+     */
+    get(path: string, options?: RequestOptions): Promise<TestResponse>;
+    /**
+     * 发送 POST 请求
+     */
+    post(path: string, options?: RequestOptions): Promise<TestResponse>;
+    /**
+     * 发送 PUT 请求
+     */
+    put(path: string, options?: RequestOptions): Promise<TestResponse>;
+    /**
+     * 发送 DELETE 请求
+     */
+    delete(path: string, options?: RequestOptions): Promise<TestResponse>;
+    /**
+     * 发送 PATCH 请求
+     */
+    patch(path: string, options?: RequestOptions): Promise<TestResponse>;
+    /**
+     * 关闭测试服务器
+     */
+    close(): Promise<void>;
+    private request;
+}
+export {};
+//# sourceMappingURL=test-client.d.ts.map

package/dist/testing/test-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-client.d.ts","sourceRoot":"","sources":["../../src/testing/test-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;CACb;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAEf,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW;IAKpD;;OAEG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/E;;OAEG;IACU,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAIhF;;OAEG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/E;;OAEG;IACU,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAIlF;;OAEG;IACU,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjF;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAIrB,OAAO;CAwCtB"}

package/dist/testing/testing-module.d.ts

@@ -0,0 +1,90 @@
+import 'reflect-metadata';
+import { Application, type ApplicationOptions } from '../core/application';
+import { Container } from '../di/container';
+import { type ModuleMetadata, type ModuleProvider, type ProviderToken } from '../di/module';
+import type { Constructor } from '../core/types';
+import { TestHttpClient } from './test-client';
+interface ProviderOverride {
+    token: ProviderToken;
+    useValue?: unknown;
+    useClass?: Constructor<unknown>;
+    useFactory?: () => unknown;
+}
+/**
+ * 测试模块构建器
+ * 提供流畅的 API 来创建测试用的隔离模块环境
+ */
+export declare class TestingModuleBuilder {
+    private readonly metadata;
+    private readonly overrides;
+    constructor(metadata: ModuleMetadata);
+    /**
+     * 覆盖指定 provider
+     * @param token - 要覆盖的 provider token
+     */
+    overrideProvider(token: ProviderToken): ProviderOverrideBuilder;
+    /**
+     * 编译测试模块，返回可用的 TestingModule 实例
+     */
+    compile(): Promise<TestingModule>;
+    private buildProviders;
+}
+declare class ProviderOverrideBuilder {
+    private readonly builder;
+    private readonly token;
+    constructor(builder: TestingModuleBuilder, token: ProviderToken);
+    /**
+     * 使用固定值覆盖
+     */
+    useValue(value: unknown): TestingModuleBuilder;
+    /**
+     * 使用替代类覆盖
+     */
+    useClass(cls: Constructor<unknown>): TestingModuleBuilder;
+    /**
+     * 使用工厂函数覆盖
+     */
+    useFactory(factory: () => unknown): TestingModuleBuilder;
+}
+/**
+ * 编译后的测试模块
+ * 提供 DI 容器访问和 HTTP 测试客户端创建
+ */
+export declare class TestingModule {
+    private readonly metadata;
+    private readonly providers;
+    private readonly overrides;
+    private app?;
+    private container?;
+    constructor(metadata: ModuleMetadata, providers: ModuleProvider[], overrides: ProviderOverride[]);
+    /**
+     * 从容器中获取 provider 实例
+     */
+    get<T>(token: Constructor<T> | string | symbol): T;
+    /**
+     * 创建一个 Application 实例并注册所有 providers、controllers
+     * @param options - 应用配置
+     */
+    createApplication(options?: ApplicationOptions): Application;
+    /**
+     * 创建 HTTP 测试客户端
+     * 自动启动应用，获取随机端口，返回 TestHttpClient
+     */
+    createHttpClient(options?: ApplicationOptions): Promise<TestHttpClient>;
+    /**
+     * 获取 DI 容器
+     */
+    getContainer(): Container;
+}
+/**
+ * 测试工具入口
+ */
+export declare class Test {
+    /**
+     * 创建测试模块
+     * @param metadata - 模块元数据
+     */
+    static createTestingModule(metadata: ModuleMetadata): TestingModuleBuilder;
+}
+export {};
+//# sourceMappingURL=testing-module.d.ts.map

package/dist/testing/testing-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing-module.d.ts","sourceRoot":"","sources":["../../src/testing/testing-module.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,OAAO,EAAuB,KAAK,cAAc,EAAoB,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACnI,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,UAAU,gBAAgB;IACxB,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAEjC,QAAQ,EAAE,cAAc;IAI3C;;;OAGG;IACI,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,uBAAuB;IAItE;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAU9C,OAAO,CAAC,cAAc;CA0CvB;AAED,cAAM,uBAAuB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;gBAEnB,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,aAAa;IAKtE;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB;IAKrD;;OAEG;IACI,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,oBAAoB;IAKhE;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,OAAO,GAAG,oBAAoB;CAIhE;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,GAAG,CAAC,CAAc;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAY;gBAG5B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,cAAc,EAAE,EAC3B,SAAS,EAAE,gBAAgB,EAAE;IAO/B;;OAEG;IACI,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC;IAIzD;;;OAGG;IACI,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW;IA2CvE;;;OAGG;IACU,gBAAgB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAQxF;;OAEG;IACI,YAAY,IAAI,SAAS;CAKjC;AAED;;GAEG;AACH,qBAAa,IAAI;IACf;;;OAGG;WACW,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,oBAAoB;CAGlF"}

package/dist/websocket/registry.d.ts

@@ -15,12 +15,7 @@ export declare class WebSocketGatewayRegistry {
     private readonly dynamicGateways;
     private constructor();
     static getInstance(): WebSocketGatewayRegistry;
-    /**
-     * 解析路径，生成匹配模式和参数名列表
-     * @param path - 路由路径
-     * @returns 匹配模式和参数名列表
-     */
-    private parsePath;
+    private static parsePath;
     register(gatewayClass: Constructor<unknown>): void;
     /**
      * 检查是否有匹配的网关（支持动态路径匹配）

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/websocket/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAO3C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAehD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAE3D,OAAO;WAIO,WAAW,IAAI,wBAAwB;IAOrD;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAaV,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAsCzD;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAgBjC,KAAK,IAAI,IAAI;IAMpB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAuBlB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;;;;;OAMG;YACW,aAAa;IA0Gd,UAAU,CAAC,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE,aAAa,CACxB,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,EAC5C,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAC9C,OAAO,CAAC,IAAI,CAAC;IAcH,WAAW,CACtB,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,EAC5C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;CAQjB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/websocket/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAO3C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAehD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAE3D,OAAO;WAIO,WAAW,IAAI,wBAAwB;IAOrD,OAAO,CAAC,MAAM,CAAC,SAAS;IAYjB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAoCzD;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAcjC,KAAK,IAAI,IAAI;IAMpB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAoBlB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;;;;;OAMG;YACW,aAAa;IA0Gd,UAAU,CAAC,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE,aAAa,CACxB,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,EAC5C,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAC9C,OAAO,CAAC,IAAI,CAAC;IAcH,WAAW,CACtB,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,EAC5C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;CAQjB"}

package/docs/async-module.md

@@ -0,0 +1,59 @@
+# Async Module Configuration
+
+Some modules support `forRootAsync()` for configuration that depends on asynchronous sources (remote config, secrets, database lookups). The async factory runs during `Application.listen()` before the server starts.
+
+## AsyncModuleOptions<T>
+
+```ts
+interface AsyncModuleOptions<T> {
+  imports?: ModuleClass[];   // Modules providing inject dependencies
+  inject?: ProviderToken[];  // Tokens to inject into useFactory
+  useFactory: (...deps: unknown[]) => T | Promise<T>;
+}
+```
+
+## Available Modules
+
+- **ConfigModule** – Load config from remote sources
+- **DatabaseModule** – Get DB options from ConfigService or secrets
+- **CacheModule** – Get cache config asynchronously
+
+## Example: ConfigModule.forRootAsync
+
+```ts
+@Module({
+  imports: [
+    ConfigModule.forRootAsync({
+      useFactory: async () => {
+        const remoteConfig = await loadRemoteConfig();
+        return { defaultConfig: remoteConfig };
+      },
+    }),
+  ],
+  controllers: [AppController],
+})
+class AppModule {}
+```
+
+## Example: DatabaseModule.forRootAsync with ConfigService
+
+```ts
+import { ConfigModule, CONFIG_SERVICE_TOKEN } from '@dangao/bun-server';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({ defaultConfig: { db: { url: '...' } } }),
+    DatabaseModule.forRootAsync({
+      imports: [ConfigModule],
+      inject: [CONFIG_SERVICE_TOKEN],
+      useFactory: (config: ConfigService) => ({
+        url: config.get<string>('db.url'),
+        // ...other options
+      }),
+    }),
+  ],
+})
+class AppModule {}
+```
+
+The `useFactory` receives resolved dependencies in the order of `inject`. Async providers are initialized sequentially during `listen()`.

package/docs/client-generation.md

@@ -0,0 +1,100 @@
+# Type-Safe Client Generation
+
+Generate a type-safe API client from your server's route manifest. The client is grouped by controller name and mirrors your controller methods.
+
+## Workflow
+
+1. Register controllers and start the application (or at least register routes)
+2. Call `ClientGenerator.generate()` to extract the route manifest
+3. Call `createClient(manifest, config)` to build the client
+
+## ClientGenerator.generate()
+
+Extracts route metadata from the current `RouteRegistry`:
+
+```ts
+const manifest = ClientGenerator.generate();
+// { routes: [{ method, path, controllerName, methodName }, ...] }
+```
+
+Use `ClientGenerator.generateJSON()` for a JSON string.
+
+## createClient(manifest, config)
+
+Creates an API client:
+
+```ts
+const client = createClient(manifest, {
+  baseUrl: 'http://localhost:3000',
+  headers: { 'X-API-Key': 'secret' },
+});
+```
+
+## Client Structure
+
+The client is grouped by controller name (with `Controller` suffix removed and first letter lowercased). Each method maps to a function:
+
+```ts
+client.user.listUsers();                    // GET /api/users/
+client.user.getUser({ params: { id: '1' } }); // GET /api/users/:id
+client.user.createUser({ body: { name: 'Alice' } }); // POST /api/users/
+```
+
+## ClientRequestOptions
+
+```ts
+{
+  params?: Record<string, string>;  // Path params (:id -> params.id)
+  query?: Record<string, string>;    // Query string
+  body?: unknown;                    // Request body (JSON)
+  headers?: Record<string, string>;   // Extra headers
+}
+```
+
+## Full Example
+
+```ts
+import {
+  Application,
+  Controller,
+  GET,
+  POST,
+  Param,
+  Body,
+  Module,
+  ClientGenerator,
+  createClient,
+} from '@dangao/bun-server';
+
+@Controller('/api/users')
+class UserController {
+  @GET('/')
+  public listUsers(): object {
+    return [{ id: '1', name: 'Alice' }];
+  }
+
+  @GET('/:id')
+  public getUser(@Param('id') id: string): object {
+    return { id, name: 'Alice' };
+  }
+
+  @POST('/')
+  public createUser(@Body() body: unknown): object {
+    return { ...(body as object), id: '3' };
+  }
+}
+
+@Module({ controllers: [UserController] })
+class AppModule {}
+
+const app = new Application({ port: 3001 });
+app.registerModule(AppModule);
+await app.listen();
+
+const manifest = ClientGenerator.generate();
+const client = createClient(manifest, { baseUrl: 'http://localhost:3001' });
+
+const users = await client.user.listUsers();
+const user = await client.user.getUser({ params: { id: '42' } });
+const created = await client.user.createUser({ body: { name: 'Charlie' } });
+```

package/docs/cluster.md

@@ -0,0 +1,81 @@
+# Zero-Config Cluster
+
+`ClusterManager` spawns multiple worker processes that share a single port via SO_REUSEPORT. Each worker runs your application; the master process monitors and restarts crashed workers.
+
+## ClusterManager Class
+
+```ts
+const manager = new ClusterManager({
+  workers: 'auto' | number,  // 'auto' = CPU cores
+  scriptPath: import.meta.path,
+  port: 3000,
+  hostname?: string,
+});
+
+manager.start();
+await manager.stop();
+```
+
+## Static Methods
+
+- **ClusterManager.isWorker()**: Returns `true` in worker processes; `false` in master
+- **ClusterManager.getWorkerId()**: Returns worker index (0, 1, ...) in workers; `-1` in master
+
+## Master/Worker Pattern
+
+```ts
+if (!ClusterManager.isWorker()) {
+  // Master: spawn workers
+  const manager = new ClusterManager({
+    workers: 'auto',
+    scriptPath: import.meta.path,
+    port: PORT,
+  });
+  manager.start();
+
+  process.on('SIGINT', async () => {
+    await manager.stop();
+    process.exit(0);
+  });
+} else {
+  // Worker: run app
+  const app = new Application({
+    port: PORT,
+    reusePort: true,
+    enableSignalHandlers: true,
+  });
+  app.registerModule(WorkerModule);
+  await app.listen();
+}
+```
+
+## Linux-Only: reusePort
+
+SO_REUSEPORT works on Linux. On macOS and Windows it is ignored; the app may still run but only one worker will bind the port.
+
+## Example
+
+```ts
+const PORT = Number(process.env.PORT ?? 3300);
+
+if (!ClusterManager.isWorker()) {
+  const manager = new ClusterManager({
+    workers: process.env.WORKERS ? Number(process.env.WORKERS) : 'auto',
+    scriptPath: import.meta.path,
+    port: PORT,
+  });
+  manager.start();
+  process.on('SIGINT', () => manager.stop().then(() => process.exit(0)));
+} else {
+  @Controller('/api')
+  class PerfController {
+    @GET('/ping')
+    public ping(): object {
+      return { pong: true, worker: ClusterManager.getWorkerId() };
+    }
+  }
+  const app = new Application({ port: PORT, reusePort: true });
+  app.registerModule(WorkerModule);
+  await app.listen();
+}
+```

package/docs/custom-decorators.md

@@ -27,11 +27,9 @@ Bun Server Framework provides a powerful interceptor mechanism that allows you t
 
 ### Basic Decorator Pattern
 
-A custom decorator is a function that returns a `MethodDecorator`. It uses `reflect-metadata` to store metadata on the method.
+A custom decorator is a function that returns a `MethodDecorator`. It uses the Reflect metadata API to store metadata on the method.
 
 ```typescript
-import 'reflect-metadata';
-
 // 1. Define a metadata key (use Symbol for uniqueness)
 export const MY_METADATA_KEY = Symbol('@my-app:my-decorator');
 
@@ -260,8 +258,6 @@ class MyInterceptor extends BaseInterceptor {
 ### Storing Metadata
 
 ```typescript
-import 'reflect-metadata';
-
 const METADATA_KEY = Symbol('my-metadata');
 
 // Store metadata
@@ -337,7 +333,6 @@ class MyInterceptor extends BaseInterceptor {
 ### Example 1: Simple Logging Interceptor
 
 ```typescript
-import 'reflect-metadata';
 import { BaseInterceptor } from '@dangao/bun-server';
 import type { Container } from '@dangao/bun-server';
 import type { Context } from '@dangao/bun-server';
@@ -375,7 +370,6 @@ export class LogInterceptor extends BaseInterceptor {
 ### Example 2: Rate Limiting Interceptor
 
 ```typescript
-import 'reflect-metadata';
 import { BaseInterceptor, HttpException } from '@dangao/bun-server';
 import type { Container } from '@dangao/bun-server';
 import type { Context } from '@dangao/bun-server';

package/docs/dashboard.md

@@ -0,0 +1,54 @@
+# Dashboard Module
+
+The Dashboard Module provides a monitoring Web UI with system metrics, route listing, and health status.
+
+## Configuration
+
+```ts
+DashboardModule.forRoot({
+  path: '/_dashboard',  // default
+  auth: { username: 'admin', password: 'admin' },
+})
+```
+
+- **path**: Base path for the dashboard (default `/_dashboard`)
+- **auth**: Optional Basic Auth. If omitted, the dashboard is unauthenticated.
+
+## Endpoints
+
+| Path | Description |
+|------|--------------|
+| `/{path}` | Dashboard UI (HTML) |
+| `/{path}/api/system` | System info (uptime, memory, platform, Bun version) |
+| `/{path}/api/routes` | Registered routes (method, path, controller, methodName) |
+| `/{path}/api/health` | Health check results (if HealthModule is used) |
+
+## Basic Auth
+
+When `auth` is set, all dashboard endpoints require Basic Auth. The browser will prompt for credentials.
+
+## UI Description
+
+The dashboard is a dark-themed single-page UI with:
+
+- **Header**: "Bun Server Dashboard" and a short description
+- **Cards**: System (uptime, memory, platform), Routes (count and list), Health (status and details)
+- **Layout**: Responsive grid of cards with monospace values
+- **Links**: Quick links to system, routes, and health API endpoints
+
+## Example
+
+```ts
+@Module({
+  imports: [
+    DashboardModule.forRoot({
+      path: '/_dashboard',
+      auth: { username: 'admin', password: 'admin' },
+    }),
+  ],
+  controllers: [AppController],
+})
+class AppModule {}
+```
+
+Access at `http://localhost:3000/_dashboard` (credentials: admin/admin).

package/docs/debug.md

@@ -0,0 +1,58 @@
+# Debug & Request Replay Module
+
+The Debug Module records HTTP requests in development and provides a UI to inspect and replay them.
+
+## Configuration
+
+```ts
+DebugModule.forRoot({
+  enabled: true,       // default
+  maxRecords: 500,      // default, ring buffer size
+  recordBody: true,     // default, capture request/response bodies
+  path: '/_debug',     // default
+})
+```
+
+## Recorded Data
+
+Each `RequestRecord` includes:
+
+- **id**: Unique record ID
+- **timestamp**: Request time
+- **request**: method, path, headers, body (if `recordBody`)
+- **response**: status, headers, bodySize
+- **timing**: total duration (ms)
+- **metadata**: matchedRoute, controller, methodName
+
+## Debug UI Endpoints
+
+| Path | Method | Description |
+|------|--------|-------------|
+| `/{path}` | GET | Debug UI (HTML) |
+| `/{path}/api/records` | GET | List all records |
+| `/{path}/api/records` | DELETE | Clear all records |
+| `/{path}/api/records/:id` | GET | Get single record |
+| `/{path}/api/replay/:id` | POST | Replay a request |
+
+## Request Replay
+
+`POST /_debug/api/replay/:id` replays the recorded request against the current server. The response includes `ok`, `status`, `body`, or `error` on failure.
+
+## Example
+
+```ts
+@Module({
+  imports: [
+    DebugModule.forRoot({
+      enabled: true,
+      maxRecords: 100,
+      recordBody: true,
+      path: '/_debug',
+    }),
+  ],
+  controllers: [AppController],
+})
+class AppModule {}
+```
+
+Visit `http://localhost:3000/_debug` to view recorded requests and replay them.

package/docs/extensions.md

@@ -499,8 +499,6 @@ You can create custom decorators to extend controller and route functionality.
 ### Creating Decorators
 
 ```typescript
-import 'reflect-metadata';
-
 // Cache decorator
 export function Cache(ttl: number) {
   return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {

package/docs/guide.md

@@ -15,7 +15,6 @@ For detailed lifecycle documentation, see [Request Lifecycle](./request-lifecycl
 ## 1. Initialize Application
 
 ```ts
-import "reflect-metadata";
 import { Application } from "@dangao/bun-server";
 
 const app = new Application({ port: 3000 });