@dangao/bun-server 1.9.0 → 1.12.0

package/README.md

@@ -46,6 +46,22 @@
 - 📡 **WebSocket gateways** with `@WebSocketGateway`, `@OnMessage`, etc.
 - 📚 **Docs & samples** including multi-language docs, benchmark scripts and
   best practices.
+- 🧪 **Testing module** with `Test.createTestingModule()`, provider override,
+  and built-in HTTP test client.
+- 🔄 **Lifecycle hooks** — `OnModuleInit`, `OnModuleDestroy`,
+  `OnApplicationBootstrap`, `OnApplicationShutdown`.
+- ⚡ **Async module config** — `forRootAsync()` with factory injection on
+  ConfigModule, DatabaseModule, CacheModule and more.
+- 🔌 **Type-safe client generation** — extract route manifests and create
+  typed API clients from controller metadata.
+- 🎨 **Decorator composition** — `applyDecorators()` to merge multiple
+  decorators into one reusable decorator.
+- 📊 **Built-in dashboard** — `DashboardModule` provides a zero-dependency
+  monitoring web UI with system info, routes and health status.
+- 🐛 **Request replay / debug** — `DebugModule` records requests in a ring
+  buffer with a debug UI for inspection and replay.
+- 🖥️ **Zero-config cluster** — `ClusterManager` auto-spawns reusePort
+  workers matching CPU core count.
 
 ## Architecture
 
@@ -368,6 +384,8 @@ Examples are organized by difficulty and feature category:
   - `multi-module-app.ts` - Module dependencies and organization
   - `context-scope-app.ts` - Request scoping and ContextService
   - `full-app.ts` - Validation, uploads, static files, WebSocket
+  - `lifecycle-app.ts` - Lifecycle hooks (OnModuleInit, OnModuleDestroy, etc.)
+  - `async-config-app.ts` - Async module config with `forRootAsync()`
 
 - **[Official Modules](./examples/02-official-modules/)** - Ready-to-use modules
   - `auth-app.ts` - JWT + OAuth2 authentication (with Web UI)
@@ -376,15 +394,21 @@ Examples are organized by difficulty and feature category:
   - `orm-app.ts` - Entity + Repository pattern
   - `cache-app.ts` - Caching with decorators
   - `queue-app.ts` - Task queues and Cron jobs
+  - `dashboard-app.ts` - Built-in monitoring dashboard (with Web UI)
 
 - **[Advanced](./examples/03-advanced/)** - Custom framework extensions
   - `custom-decorator-app.ts` - Create custom decorators
+  - `apply-decorators-app.ts` - Decorator composition with `applyDecorators()`
+  - `testing-app.ts` - TestingModule with mock providers and HTTP client
+  - `type-safe-client-app.ts` - Type-safe API client from controller metadata
+  - `debug-app.ts` - Request recording and replay (with Web UI)
   - `websocket-chat-app.ts` - Complete WebSocket chat with rooms (with Web UI)
   - `microservice-app.ts` - Microservices architecture
 
 - **[Real World](./examples/04-real-world/)** - Production-ready examples
   - `database-test-app.ts` - Database connection tester (Web UI)
   - `perf/app.ts` - Performance benchmarking
+  - `perf/cluster-app.ts` - Zero-config cluster with `ClusterManager`
 
 ### 🔑 Symbol + Interface Pattern
 
@@ -433,22 +457,71 @@ learning paths, difficulty ratings, and usage scenarios.
 
 ## Benchmark Suite
 
-Benchmarks live in `benchmark/` and rely on `PerformanceHarness` &
-`StressTester`.
+### Internal Micro-benchmarks
+
+`PerformanceHarness` & `StressTester` based benchmarks:
 
 | Script            | Description                                                           |
 | ----------------- | --------------------------------------------------------------------- |
 | `router.bench.ts` | static/dynamic route hits, `router.handle` and stress runs            |
 | `di.bench.ts`     | singleton vs factory resolves, nested dependencies, concurrent stress |
 
-Run directly:
-
 ```bash
 bun benchmark/router.bench.ts
 bun benchmark/di.bench.ts
 ```
 
-Or use `bun run bench*` scripts for convenience.
+### Framework Comparison (bun-server vs Express vs NestJS)
+
+Real HTTP load testing with [wrk](https://github.com/wg/wrk), comparing
+bun-server against Express 5 and NestJS 11. All frameworks run on the same Bun
+runtime to isolate framework overhead.
+
+**Prerequisites:** wrk (`brew install wrk` / `apt install wrk`). The script
+automatically raises `ulimit -n` to 10240 for child processes.
+
+```bash
+bun benchmark/run-wrk-compare.ts        # full comparison (3 tiers)
+TIER=0 bun benchmark/run-wrk-compare.ts  # Light tier only
+bun benchmark/run-wrk.ts                 # bun-server only (3 tiers)
+```
+
+> **Environment:** Apple M2 Pro (8P + 4E cores) / darwin arm64 / Bun 1.3.10
+
+#### Req/Sec (Light: -t2 -c50 -d10s)
+
+| Endpoint              | bun-server   | Express  | NestJS   |
+|-----------------------|--------------|----------|----------|
+| GET /ping             | **31.41k**   | 30.01k   | 26.52k   |
+| GET /json             | **28.22k**   | 25.99k   | 23.64k   |
+| GET /users/:id        | **30.88k**   | 29.91k   | 25.62k   |
+| GET /search?q=        | **29.96k**   | 28.70k   | 25.17k   |
+| POST /users           | **27.65k**   | 21.37k   | 19.38k   |
+| POST /users/validated | **26.60k**   | 21.28k   | 18.93k   |
+| GET /middleware        | **29.52k**   | 28.57k   | 24.69k   |
+| GET /headers          | **30.98k**   | 29.57k   | 26.43k   |
+| GET /io               | **21.37k**   | 19.46k   | 18.49k   |
+
+Zero errors across all frameworks and tiers. See the full report for Medium and
+Heavy tier results.
+
+> 📊 Full comparison report (3 tiers, latency breakdown, per-framework
+> details): [`benchmark/REPORT_COMPARE.md`](./benchmark/REPORT_COMPARE.md)
+>
+> 📋 Single-framework detailed report:
+> [`benchmark/REPORT.md`](./benchmark/REPORT.md)
+
+### Multi-process Benchmark (reusePort, Linux only)
+
+```bash
+bun benchmark/run-wrk-cluster.ts          # default: 1 worker per CPU core
+WORKERS=4 bun benchmark/run-wrk-cluster.ts
+```
+
+Spawns N workers sharing the same port via `SO_REUSEPORT`. The kernel
+distributes connections across processes. Report saved to
+`benchmark/REPORT_CLUSTER.md`. Note: `reusePort` only works on **Linux**;
+macOS/Windows silently ignore it.
 
 ## Docs & Localization
 
@@ -525,6 +598,6 @@ Released under the [MIT License](./LICENSE).
 
 ## Other Languages
 
-- [中文 README](./readme_zh.md)
+- [中文 README](./README_ZH.md)
 
 Enjoy building on Bun Server!

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

@@ -1,3 +1,4 @@
+import { type AsyncModuleOptions } from '../di/async-module';
 import { type CacheModuleOptions } from './types';
 import { CachePostProcessor } from './service-proxy';
 /**
@@ -14,6 +15,11 @@ export declare class CacheModule {
      * @param options - 模块配置
      */
     static forRoot(options?: CacheModuleOptions): typeof CacheModule;
+    /**
+     * 异步创建缓存模块
+     * @param asyncOptions - 异步配置选项
+     */
+    static forRootAsync(asyncOptions: AsyncModuleOptions<CacheModuleOptions>): typeof CacheModule;
     /**
      * 获取缓存后处理器
      * 用于在应用启动时注册到 DI 容器

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

@@ -1 +1 @@
-{"version":3,"file":"cache-module.d.ts","sourceRoot":"","sources":["../../src/cache/cache-module.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,kBAAkB,EAExB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,0BAA0B,eAAoD,CAAC;AAE5F,qBAGa,WAAW;IACtB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa,CAAmC;IAE/D;;;OAGG;WACW,OAAO,CACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,WAAW;IAwDrB;;;OAGG;WACW,gBAAgB,IAAI,kBAAkB,GAAG,IAAI;IAI3D;;OAEG;WACW,KAAK,IAAI,IAAI;CAI5B"}
+{"version":3,"file":"cache-module.d.ts","sourceRoot":"","sources":["../../src/cache/cache-module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,kBAAkB,EAA0B,MAAM,oBAAoB,CAAC;AAGrF,OAAO,EAIL,KAAK,kBAAkB,EAExB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,0BAA0B,eAAoD,CAAC;AAE5F,qBAGa,WAAW;IACtB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa,CAAmC;IAE/D;;;OAGG;WACW,OAAO,CACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,WAAW;IAwDrB;;;OAGG;WACW,YAAY,CACxB,YAAY,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,GACnD,OAAO,WAAW;IAkBrB;;;OAGG;WACW,gBAAgB,IAAI,kBAAkB,GAAG,IAAI;IAI3D;;OAEG;WACW,KAAK,IAAI,IAAI;CAI5B"}

package/dist/client/generator.d.ts

@@ -0,0 +1,16 @@
+import type { RouteManifest } from './types';
+/**
+ * 客户端清单生成器
+ * 从 RouteRegistry 提取路由元数据，生成路由清单
+ */
+export declare class ClientGenerator {
+    /**
+     * 从当前 RouteRegistry 生成路由清单
+     */
+    static generate(): RouteManifest;
+    /**
+     * 生成清单的 JSON 字符串
+     */
+    static generateJSON(): string;
+}
+//# sourceMappingURL=generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/client/generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,SAAS,CAAC;AAEjE;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;OAEG;WACW,QAAQ,IAAI,aAAa;IAkBvC;;OAEG;WACW,YAAY,IAAI,MAAM;CAGrC"}

package/dist/client/index.d.ts

@@ -0,0 +1,4 @@
+export { ClientGenerator } from './generator';
+export { createClient } from './runtime';
+export type { RouteManifest, RouteManifestEntry, ClientConfig, ClientRequestOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/dist/client/runtime.d.ts

@@ -0,0 +1,15 @@
+import type { ClientConfig, ClientRequestOptions, RouteManifest } from './types';
+/**
+ * 从路由清单创建类型安全的 API 客户端
+ *
+ * 客户端结构按控制器名称（去除 Controller 后缀，转小写）分组，
+ * 每个方法名直接映射为函数调用。
+ *
+ * 示例：
+ * ```
+ * const client = createClient(manifest, { baseUrl: 'http://localhost:3000' });
+ * const result = await client.user.getUser({ params: { id: '1' } });
+ * ```
+ */
+export declare function createClient(manifest: RouteManifest, config: ClientConfig): Record<string, Record<string, (options?: ClientRequestOptions) => Promise<unknown>>>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/client/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/client/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA4BjF;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,YAAY,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAyDtF"}

package/dist/client/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 路由清单中的单个端点描述
+ */
+export interface RouteManifestEntry {
+    method: string;
+    path: string;
+    controllerName: string;
+    methodName: string;
+}
+/**
+ * 完整的路由清单
+ */
+export interface RouteManifest {
+    routes: RouteManifestEntry[];
+}
+/**
+ * 客户端请求选项
+ */
+export interface ClientRequestOptions {
+    params?: Record<string, string>;
+    query?: Record<string, string>;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+/**
+ * 客户端配置
+ */
+export interface ClientConfig {
+    baseUrl: string;
+    headers?: Record<string, string>;
+    /**
+     * 自定义 fetch 实现（可选，用于测试）
+     */
+    fetch?: typeof fetch;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB"}

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

@@ -1,3 +1,4 @@
+import { type AsyncModuleOptions } from '../di/async-module';
 import { ConfigService } from './service';
 import { type ConfigModuleOptions } from './types';
 export declare class ConfigModule {
@@ -6,6 +7,12 @@ export declare class ConfigModule {
      * @param options - 模块配置
      */
     static forRoot(options?: ConfigModuleOptions): typeof ConfigModule;
+    /**
+     * 异步创建配置模块
+     * 支持 configFiles 选项从 .json / .jsonc / .json5 文件异步加载配置
+     * @param asyncOptions - 异步配置选项
+     */
+    static forRootAsync(asyncOptions: AsyncModuleOptions<ConfigModuleOptions>): typeof ConfigModule;
     /**
      * 获取环境变量快照
      * 方便测试和未来扩展（如 .env 文件解析）

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

@@ -1 +1 @@
-{"version":3,"file":"config-module.d.ts","sourceRoot":"","sources":["../../src/config/config-module.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEzE,qBAGa,YAAY;IACvB;;;OAGG;WACW,OAAO,CACnB,OAAO,GAAE,mBAAwB,GAChC,OAAO,YAAY;IAsDtB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAQ1B;;OAEG;WACiB,sBAAsB,CACxC,OAAO,EAAE,aAAa,EACtB,mBAAmB,EAAE,WAAW,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC,GACpE,OAAO,CAAC,IAAI,CAAC;IA+BhB;;OAEG;mBACkB,sBAAsB;IAyE3C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAwDvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;CAwB9B"}
+{"version":3,"file":"config-module.d.ts","sourceRoot":"","sources":["../../src/config/config-module.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,kBAAkB,EAA0B,MAAM,oBAAoB,CAAC;AAErF,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEzE,qBAGa,YAAY;IACvB;;;OAGG;WACW,OAAO,CACnB,OAAO,GAAE,mBAAwB,GAChC,OAAO,YAAY;IAsDtB;;;;OAIG;WACW,YAAY,CACxB,YAAY,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,GACpD,OAAO,YAAY;IAkCtB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAQ1B;;OAEG;WACiB,sBAAsB,CACxC,OAAO,EAAE,aAAa,EACtB,mBAAmB,EAAE,WAAW,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC,GACpE,OAAO,CAAC,IAAI,CAAC;IA+BhB;;OAEG;mBACkB,sBAAsB;IAuE3C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAwDvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;CAwB9B"}

package/dist/config/index.d.ts

@@ -1,4 +1,4 @@
 export { ConfigModule } from './config-module';
 export { ConfigService } from './service';
-export { CONFIG_SERVICE_TOKEN, type ConfigModuleOptions, } from './types';
+export { CONFIG_SERVICE_TOKEN, type ConfigModuleOptions, type ConfigFileFormat, } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,SAAS,CAAC"}

package/dist/config/service.d.ts

@@ -1,8 +1,21 @@
+import type { ConfigFileFormat } from './types';
 /**
  * 配置服务
  * 提供类型安全的配置访问能力
  */
 export declare class ConfigService<TConfig extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * 解析配置内容，按 JSON -> JSONC -> JSON5 顺序自动尝试
+     * 利用 Bun 1.3.6+ 的 Bun.JSONC 和 Bun 1.3.7+ 的 Bun.JSON5
+     * @param content - 配置文本内容
+     * @param format - 强制指定格式（可选），省略则自动检测
+     */
+    static parseConfigContent(content: string, format?: ConfigFileFormat): unknown;
+    /**
+     * 从文件加载配置，根据扩展名自动选择解析器
+     * @param filePath - 配置文件路径（.json / .jsonc / .json5）
+     */
+    static loadConfigFile(filePath: string): Promise<Record<string, unknown>>;
     private config;
     private readonly namespace?;
     private configUpdateListeners;

package/dist/config/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/config/service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1F,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,qBAAqB,CAAwC;gBAElD,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM;IAKtD;;;OAGG;IACI,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAY7C;;;OAGG;IACI,WAAW,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAezD;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAUtE;;OAEG;IACI,MAAM,IAAI,OAAO;IAIxB;;;;OAIG;IACI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IASrE;;;OAGG;IACI,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAQ/C;;;OAGG;IACI,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC;IAI/D,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,cAAc;CAuBvB"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/config/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;GAGG;AACH,qBAAa,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1F;;;;;OAKG;WACW,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO;IAsBrF;;;OAGG;WACiB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAgBtF,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,qBAAqB,CAAwC;gBAElD,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM;IAKtD;;;OAGG;IACI,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAY7C;;;OAGG;IACI,WAAW,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAezD;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAUtE;;OAEG;IACI,MAAM,IAAI,OAAO;IAIxB;;;;OAIG;IACI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IASrE;;;OAGG;IACI,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAQ/C;;;OAGG;IACI,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC;IAI/D,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,cAAc;CAuBvB"}

package/dist/config/types.d.ts

@@ -1,3 +1,7 @@
+/**
+ * 配置文件解析格式
+ */
+export type ConfigFileFormat = 'json' | 'jsonc' | 'json5';
 export interface ConfigModuleOptions<TConfig extends Record<string, unknown> = Record<string, unknown>> {
     /**
      * 默认配置对象（最低优先级）
@@ -8,6 +12,12 @@ export interface ConfigModuleOptions<TConfig extends Record<string, unknown> = R
      * @param env - process.env 快照
      */
     load?: (env: Record<string, string | undefined>) => Partial<TConfig>;
+    /**
+     * 配置文件路径列表（支持 .json / .jsonc / .json5 格式）
+     * 优先级：configFiles > defaultConfig，按数组顺序后者覆盖前者
+     * 仅在 forRootAsync 中生效（文件读取为异步操作）
+     */
+    configFiles?: string[];
     /**
      * 配置验证函数（可抛出错误）
      * 可用于集成 class-validator 风格的校验逻辑

package/dist/config/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpG;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjC;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAErE;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAErC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE;QACb;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;QAElB;;;;WAIG;QACH,OAAO,CAAC,EAAE,GAAG,CACX,MAAM,EACN;YACE,MAAM,EAAE,MAAM,CAAC;YACf,SAAS,EAAE,MAAM,CAAC;YAClB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CACF,CAAC;QAEF;;;;WAIG;QACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;CACH;AAED,eAAO,MAAM,oBAAoB,eAA8C,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpG;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjC;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAErE;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAErC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE;QACb;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;QAElB;;;;WAIG;QACH,OAAO,CAAC,EAAE,GAAG,CACX,MAAM,EACN;YACE,MAAM,EAAE,MAAM,CAAC;YACf,SAAS,EAAE,MAAM,CAAC;YAClB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CACF,CAAC;QAEF;;;;WAIG;QACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;CACH;AAED,eAAO,MAAM,oBAAoB,eAA8C,CAAC"}

package/dist/core/application.d.ts

@@ -25,6 +25,13 @@ export interface ApplicationOptions {
      * 默认 true
      */
     enableSignalHandlers?: boolean;
+    /**
+     * 是否启用 SO_REUSEPORT
+     * 允许多进程绑定同一端口，用于多进程负载均衡
+     * 仅 Linux 有效，macOS/Windows 会忽略
+     * @default false
+     */
+    reusePort?: boolean;
 }
 /**
  * 应用主类

package/dist/core/application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/core/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,UAAU,CAAC;AAMzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAS3C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,uBAAuB,CAAkB;gBAE9B,OAAO,GAAE,kBAAuB;IAsBnD;;;OAGG;IACI,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIxC;;OAEG;IACU,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCpE;;OAEG;YACW,oBAAoB;IAqBlC;;;OAGG;YACW,sBAAsB;IAyBpC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYlC;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9D;;OAEG;YACW,eAAe;IAkB7B;;;;OAIG;YACW,aAAa;IAyC3B;;;OAGG;IACI,kBAAkB,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAKtE;;;OAGG;IACI,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAqBrD;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAc1C;;;OAGG;IACI,wBAAwB,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAIzE;;;OAGG;IACI,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAK/D;;;OAGG;IACI,SAAS,IAAI,SAAS,GAAG,SAAS;IAIzC;;;OAGG;YACW,gBAAgB;IAsB9B;;;OAGG;YACW,kBAAkB;IAwBhC;;;OAGG;IACI,YAAY;IAInB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAS7B"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/core/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,UAAU,CAAC;AAMzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAU3C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,uBAAuB,CAAkB;gBAE9B,OAAO,GAAE,kBAAuB;IAsBnD;;;OAGG;IACI,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIxC;;OAEG;IACU,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDpE;;OAEG;YACW,oBAAoB;IAqBlC;;;OAGG;YACW,sBAAsB;IAyBpC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBlC;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB9D;;OAEG;YACW,eAAe;IAkB7B;;;;OAIG;YACW,aAAa;IAyC3B;;;OAGG;IACI,kBAAkB,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAKtE;;;OAGG;IACI,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAqBrD;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAc1C;;;OAGG;IACI,wBAAwB,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAIzE;;;OAGG;IACI,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAK/D;;;OAGG;IACI,SAAS,IAAI,SAAS,GAAG,SAAS;IAIzC;;;OAGG;YACW,gBAAgB;IAsB9B;;;OAGG;YACW,kBAAkB;IAwBhC;;;OAGG;IACI,YAAY;IAInB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAS7B"}

package/dist/core/apply-decorators.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 装饰器组合工具
+ * 将多个装饰器合并为一个可复用的装饰器
+ */
+export declare function applyDecorators(...decorators: Array<ClassDecorator | MethodDecorator | PropertyDecorator>): ClassDecorator & MethodDecorator & PropertyDecorator;
+//# sourceMappingURL=apply-decorators.d.ts.map

package/dist/core/apply-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-decorators.d.ts","sourceRoot":"","sources":["../../src/core/apply-decorators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,UAAU,EAAE,KAAK,CAAC,cAAc,GAAG,eAAe,GAAG,iBAAiB,CAAC,GACzE,cAAc,GAAG,eAAe,GAAG,iBAAiB,CAwBtD"}

package/dist/core/cluster.d.ts

@@ -0,0 +1,47 @@
+export interface ClusterOptions {
+    /**
+     * 是否启用集群模式
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * Worker 数量。'auto' 表示使用 CPU 核心数
+     * @default 'auto'
+     */
+    workers?: number | 'auto';
+}
+/**
+ * 集群管理器
+ * 自动派生 worker 进程，每个 worker 使用 reusePort 绑定相同端口
+ */
+export declare class ClusterManager {
+    private readonly workerCount;
+    private readonly workers;
+    private readonly scriptPath;
+    private readonly port;
+    private readonly hostname?;
+    constructor(options: {
+        workers: number | 'auto';
+        scriptPath: string;
+        port: number;
+        hostname?: string;
+    });
+    /**
+     * 启动所有 worker 进程
+     */
+    start(): void;
+    /**
+     * 停止所有 worker 进程
+     */
+    stop(): Promise<void>;
+    private monitorWorkers;
+    /**
+     * 检查当前进程是否为 cluster worker
+     */
+    static isWorker(): boolean;
+    /**
+     * 获取当前 worker ID（仅在 worker 进程中有效）
+     */
+    static getWorkerId(): number;
+}
+//# sourceMappingURL=cluster.d.ts.map

package/dist/core/cluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.d.ts","sourceRoot":"","sources":["../../src/core/cluster.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;gBAEhB,OAAO,EAAE;QAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IAQD;;OAEG;IACI,KAAK,IAAI,IAAI;IA+BpB;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBlC,OAAO,CAAC,cAAc;IA8BtB;;OAEG;WACW,QAAQ,IAAI,OAAO;IAIjC;;OAEG;WACW,WAAW,IAAI,MAAM;CAGpC"}

package/dist/core/index.d.ts

@@ -1,5 +1,6 @@
 export { Application, type ApplicationOptions } from './application';
 export { BunServer, type ServerOptions } from './server';
+export { ClusterManager, type ClusterOptions } from './cluster';
 export { Context } from './context';
 export { ContextService, CONTEXT_SERVICE_TOKEN, contextStore } from './context-service';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/server.d.ts

@@ -27,6 +27,13 @@ export interface ServerOptions {
      * 默认 30 秒
      */
     gracefulShutdownTimeout?: number;
+    /**
+     * 是否启用 SO_REUSEPORT
+     * 允许多进程绑定同一端口，用于多进程负载均衡
+     * 仅 Linux 有效，macOS/Windows 会忽略
+     * @default false
+     */
+    reusePort?: boolean;
 }
 /**
  * 服务器封装类
@@ -75,6 +82,7 @@ export declare class BunServer {
     isRunning(): boolean;
     /**
      * 获取服务器端口
+     * 如果服务器正在运行，返回实际绑定的端口（支持 port:0 场景）
      */
     getPort(): number;
     /**

package/dist/core/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1D;;OAEG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAE7C;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAgB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAa;gBAElB,OAAO,EAAE,aAAa;IAIzC;;OAEG;IACI,KAAK,IAAI,IAAI;IAoGpB;;OAEG;IACI,IAAI,IAAI,IAAI;IAWnB;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C9D;;OAEG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACI,mBAAmB,IAAI,OAAO;IAIrC;;;OAGG;IACI,SAAS,IAAI,MAAM,CAAC,uBAAuB,CAAC,GAAG,SAAS;IAI/D;;;OAGG;IACI,SAAS,IAAI,OAAO;IAI3B;;OAEG;IACI,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACI,WAAW,IAAI,MAAM,GAAG,SAAS;CAGzC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1D;;OAEG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAE7C;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAgB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAa;gBAElB,OAAO,EAAE,aAAa;IAIzC;;OAEG;IACI,KAAK,IAAI,IAAI;IAqGpB;;OAEG;IACI,IAAI,IAAI,IAAI;IAWnB;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C9D;;OAEG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACI,mBAAmB,IAAI,OAAO;IAIrC;;;OAGG;IACI,SAAS,IAAI,MAAM,CAAC,uBAAuB,CAAC,GAAG,SAAS;IAI/D;;;OAGG;IACI,SAAS,IAAI,OAAO;IAI3B;;;OAGG;IACI,OAAO,IAAI,MAAM;IAOxB;;OAEG;IACI,WAAW,IAAI,MAAM,GAAG,SAAS;CAGzC"}

package/dist/dashboard/controller.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Dashboard 服务
+ * 提供监控 UI 和 API 端点
+ */
+export declare class DashboardService {
+    private readonly basePath;
+    private readonly auth?;
+    private readonly startTime;
+    /**
+     * 创建 Dashboard 服务实例
+     * @param basePath - Dashboard 基础路径
+     * @param auth - Basic Auth 认证配置（可选）
+     */
+    constructor(basePath: string, auth?: {
+        username: string;
+        password: string;
+    });
+    /**
+     * 注册 Dashboard 路由
+     */
+    registerRoutes(): void;
+    /**
+     * 检查 Basic Auth
+     * @param ctx - 请求上下文
+     * @returns 是否通过认证，未配置 auth 时返回 true
+     */
+    private checkAuth;
+    /**
+     * 返回 401 Unauthorized 响应
+     */
+    private unauthorizedResponse;
+    /**
+     * 处理 Dashboard 主页面
+     */
+    private handleDashboard;
+    /**
+     * 处理系统信息 API
+     */
+    private handleSystem;
+    /**
+     * 处理路由列表 API
+     */
+    private handleRoutes;
+    /**
+     * 将 Markdown 文本渲染为 HTML
+     * 利用 Bun 1.3.8+ 内置 Bun.markdown 解析器（Zig 实现，支持 GFM）
+     */
+    private handleMarkdownRender;
+    /**
+     * 处理健康检查 API
+     * 如果 HealthModule 已注册则运行健康指示器，否则返回基本状态
+     */
+    private handleHealth;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/dashboard/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/dashboard/controller.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAyC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAEhD;;;;OAIG;gBAED,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAM/C;;OAEG;IACI,cAAc,IAAI,IAAI;IA0B7B;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAmBjB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;YACW,eAAe;IAU7B;;OAEG;YACW,YAAY;IAoB1B;;OAEG;YACW,YAAY;IAkB1B;;;OAGG;YACW,oBAAoB;IAwBlC;;;OAGG;YACW,YAAY;CA0C3B"}

package/dist/dashboard/dashboard-extension.d.ts

@@ -0,0 +1,20 @@
+import type { ApplicationExtension } from '../extensions/types';
+import type { Container } from '../di/container';
+import { DashboardService } from './controller';
+/**
+ * Dashboard 扩展
+ * 在应用初始化时注册 Dashboard 路由
+ */
+export declare class DashboardExtension implements ApplicationExtension {
+    private readonly service;
+    /**
+     * 创建 Dashboard 扩展
+     * @param service - Dashboard 服务实例
+     */
+    constructor(service: DashboardService);
+    /**
+     * 注册扩展，将 Dashboard 路由注册到 RouteRegistry
+     */
+    register(_container: Container): void;
+}
+//# sourceMappingURL=dashboard-extension.d.ts.map

package/dist/dashboard/dashboard-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-extension.d.ts","sourceRoot":"","sources":["../../src/dashboard/dashboard-extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,oBAAoB;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAE3C;;;OAGG;gBACgB,OAAO,EAAE,gBAAgB;IAI5C;;OAEG;IACI,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,IAAI;CAG7C"}

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

@@ -0,0 +1,13 @@
+import type { DashboardModuleOptions } from './types';
+/**
+ * Dashboard 模块
+ * 提供监控 Web UI，可视化指标、健康状态、路由和系统信息
+ */
+export declare class DashboardModule {
+    /**
+     * 创建 Dashboard 模块
+     * @param options - 模块配置
+     */
+    static forRoot(options?: DashboardModuleOptions): typeof DashboardModule;
+}
+//# sourceMappingURL=dashboard-module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-module.d.ts","sourceRoot":"","sources":["../../src/dashboard/dashboard-module.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD;;;GAGG;AACH,qBAKa,eAAe;IAC1B;;;OAGG;WACW,OAAO,CACnB,OAAO,GAAE,sBAA2B,GACnC,OAAO,eAAe;CAgB1B"}

package/dist/dashboard/index.d.ts

@@ -0,0 +1,4 @@
+export { DashboardModule } from './dashboard-module';
+export { DashboardService } from './controller';
+export { DASHBOARD_OPTIONS_TOKEN, type DashboardModuleOptions } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,MAAM,SAAS,CAAC"}

package/dist/dashboard/types.d.ts

@@ -0,0 +1,16 @@
+export interface DashboardModuleOptions {
+    /**
+     * Dashboard UI 路径
+     * @default '/_dashboard'
+     */
+    path?: string;
+    /**
+     * Basic Auth 认证配置
+     */
+    auth?: {
+        username: string;
+        password: string;
+    };
+}
+export declare const DASHBOARD_OPTIONS_TOKEN: unique symbol;
+//# sourceMappingURL=types.d.ts.map

package/dist/dashboard/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/dashboard/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,eAAO,MAAM,uBAAuB,eAAiD,CAAC"}

package/dist/dashboard/ui.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 创建 Dashboard HTML 页面
+ * @param basePath - Dashboard 基础路径
+ * @returns 完整的 HTML 页面字符串
+ */
+export declare function createDashboardHTML(basePath: string): string;
+//# sourceMappingURL=ui.d.ts.map

package/dist/dashboard/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/dashboard/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqN5D"}