@dangao/bun-server 0.1.4 → 0.1.5

package/dist/auth/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/auth/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAO1B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,MAAM,GAAE,UAAe,GAAG,eAAe,CAU7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,UAAU,GAAG,SAAS,CAGxB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAGlF;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,SAAS,GAAE,MAAM,EAAO,GACvB,OAAO,CAMT"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/auth/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAO1B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,MAAM,GAAE,UAAe,GAAG,eAAe,CAU7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,UAAU,GAAG,SAAS,CAGxB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAOlF;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,SAAS,GAAE,MAAM,EAAO,GACvB,OAAO,CAMT"}

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

@@ -0,0 +1,14 @@
+import { type ConfigModuleOptions } from './types';
+export declare class ConfigModule {
+    /**
+     * 创建配置模块
+     * @param options - 模块配置
+     */
+    static forRoot(options?: ConfigModuleOptions): typeof ConfigModule;
+    /**
+     * 获取环境变量快照
+     * 方便测试和未来扩展（如 .env 文件解析）
+     */
+    private static snapshotEnv;
+}
+//# sourceMappingURL=config-module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-module.d.ts","sourceRoot":"","sources":["../../src/config/config-module.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEzE,qBAGa,YAAY;IACvB;;;OAGG;WACW,OAAO,CACnB,OAAO,GAAE,mBAAwB,GAChC,OAAO,YAAY;IA+CtB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;CAO3B"}

package/dist/config/index.d.ts

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

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

@@ -0,0 +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"}

package/dist/config/service.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 配置服务
+ * 提供类型安全的配置访问能力
+ */
+export declare class ConfigService<TConfig extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly config;
+    private readonly namespace?;
+    constructor(config: TConfig, namespace?: string);
+    /**
+     * 获取完整配置对象
+     */
+    getAll(): TConfig;
+    /**
+     * 获取配置值（支持点号路径）
+     * @param key - 配置键（如 "db.host"）
+     * @param defaultValue - 默认值（可选）
+     */
+    get<T = unknown>(key: string, defaultValue?: T): T | undefined;
+    /**
+     * 获取必需的配置值，如果不存在则抛出错误
+     * @param key - 配置键
+     */
+    getRequired<T = unknown>(key: string): T;
+    /**
+     * 创建带命名空间的 ConfigService 视图
+     * @param namespace - 命名空间前缀
+     */
+    withNamespace(namespace: string): ConfigService<TConfig>;
+    private applyNamespace;
+    private getValueByPath;
+}
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +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,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;gBAEjB,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM;IAKtD;;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

@@ -0,0 +1,22 @@
+export interface ConfigModuleOptions<TConfig extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * 默认配置对象（最低优先级）
+     */
+    defaultConfig?: Partial<TConfig>;
+    /**
+     * 从环境变量加载配置
+     * @param env - process.env 快照
+     */
+    load?: (env: Record<string, string | undefined>) => Partial<TConfig>;
+    /**
+     * 配置验证函数（可抛出错误）
+     * 可用于集成 class-validator 风格的校验逻辑
+     */
+    validate?: (config: TConfig) => void;
+    /**
+     * 命名空间前缀，用于逻辑分组（可选）
+     */
+    namespace?: string;
+}
+export declare const CONFIG_SERVICE_TOKEN: unique symbol;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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;CACpB;AAED,eAAO,MAAM,oBAAoB,eAA8C,CAAC"}

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;AAKzD,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,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;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;gBAEtC,OAAO,GAAE,kBAAuB;IAcnD;;;OAGG;IACI,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIxC;;OAEG;IACI,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBrD;;OAEG;IACI,IAAI,IAAI,IAAI;IAInB;;;;OAIG;YACW,aAAa;IAsB3B;;;OAGG;IACI,kBAAkB,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAKtE;;;OAGG;IACI,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAgBrD;;;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;IACI,YAAY;CAGpB"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/core/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,UAAU,CAAC;AAKzD,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,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;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;gBAEtC,OAAO,GAAE,kBAAuB;IAcnD;;;OAGG;IACI,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIxC;;OAEG;IACI,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBrD;;OAEG;IACI,IAAI,IAAI,IAAI;IAInB;;;;OAIG;YACW,aAAa;IA2B3B;;;OAGG;IACI,kBAAkB,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAKtE;;;OAGG;IACI,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAgBrD;;;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;IACI,YAAY;CAGpB"}

package/dist/health/controller.d.ts

@@ -0,0 +1,27 @@
+import type { HealthIndicator, HealthStatus } from './types';
+import type { HealthModuleOptions } from './types';
+/**
+ * 健康检查控制器
+ *
+ * 提供 `/health` 和 `/ready` 两个端点：
+ * - /health：存活检查（liveness）
+ * - /ready：就绪检查（readiness）
+ */
+export declare class HealthController {
+    private readonly indicators;
+    private readonly options?;
+    constructor(indicators?: HealthIndicator[], options?: HealthModuleOptions | undefined);
+    /**
+     * 存活检查
+     */
+    health(): Promise<HealthStatus>;
+    /**
+     * 就绪检查
+     */
+    ready(): Promise<HealthStatus>;
+    /**
+     * 执行所有健康检查指示器
+     */
+    private checkIndicators;
+}
+//# sourceMappingURL=controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/health/controller.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EACb,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD;;;;;;GAMG;AACH,qBACa,gBAAgB;IAGzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAFR,UAAU,GAAE,eAAe,EAAO,EAElC,OAAO,CAAC,EAAE,mBAAmB,YAAA;IAGhD;;OAEG;IAEU,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAI5C;;OAEG;IAEU,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IAI3C;;OAEG;YACW,eAAe;CA0B9B"}

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

@@ -0,0 +1,9 @@
+import type { HealthModuleOptions } from './types';
+export declare class HealthModule {
+    /**
+     * 创建健康检查模块
+     * @param options - 模块配置
+     */
+    static forRoot(options?: HealthModuleOptions): typeof HealthModule;
+}
+//# sourceMappingURL=health-module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health-module.d.ts","sourceRoot":"","sources":["../../src/health/health-module.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAmB,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGpE,qBAIa,YAAY;IACvB;;;OAGG;WACW,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,YAAY;CAiC9E"}

package/dist/health/index.d.ts

@@ -0,0 +1,4 @@
+export { HealthModule } from './health-module';
+export { HealthController } from './controller';
+export { HEALTH_INDICATORS_TOKEN, HEALTH_OPTIONS_TOKEN, type HealthIndicator, type HealthIndicatorResult, type HealthStatus, type HealthModuleOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,SAAS,CAAC"}

package/dist/health/types.d.ts

@@ -0,0 +1,22 @@
+export declare const HEALTH_INDICATORS_TOKEN: unique symbol;
+export declare const HEALTH_OPTIONS_TOKEN: unique symbol;
+export type HealthStatusValue = 'up' | 'down';
+export interface HealthIndicatorResult {
+    status: HealthStatusValue;
+    details?: Record<string, unknown>;
+}
+export interface HealthIndicator {
+    name: string;
+    check(): Promise<HealthIndicatorResult> | HealthIndicatorResult;
+}
+export interface HealthStatus {
+    status: HealthStatusValue;
+    details: Record<string, HealthIndicatorResult>;
+}
+export interface HealthModuleOptions {
+    /**
+     * 健康检查指示器列表
+     */
+    indicators?: HealthIndicator[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/health/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,eAAiD,CAAC;AACtF,eAAO,MAAM,oBAAoB,eAA8C,CAAC;AAEhF,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;CACjE;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC"}

package/dist/index.d.ts

@@ -21,6 +21,8 @@ export { WebSocketGateway, OnOpen, OnMessage, OnClose, WebSocketGatewayRegistry,
 export { LoggerExtension, LoggerModule, LogLevel, LOGGER_TOKEN, type Logger, type LoggerOptions, type LoggerModuleOptions, type LogEntry, } from './extensions';
 export { SwaggerExtension, SwaggerModule, SwaggerGenerator, createSwaggerUIMiddleware, ApiTags, ApiOperation, ApiParam, ApiBody, ApiResponse, type SwaggerOptions, type SwaggerModuleOptions, type SwaggerDocument, type ApiOperationMetadata, type ApiParamMetadata, type ApiBodyMetadata, type ApiResponseMetadata, } from './swagger';
 export { SecurityModule, SecurityContextHolder, AuthenticationManager, RoleBasedAccessDecisionManager, JwtAuthenticationProvider, OAuth2AuthenticationProvider, createSecurityFilter, type SecurityModuleConfig, type SecurityConfig, type SecurityContext, type Authentication, type AuthenticationProvider, type AuthenticationRequest, type Principal, type Credentials, type AccessDecisionManager, } from './security';
+export { ConfigModule, ConfigService, CONFIG_SERVICE_TOKEN, type ConfigModuleOptions, } from './config';
+export { HealthModule, type HealthIndicator, type HealthIndicatorResult, type HealthStatus, type HealthModuleOptions, HEALTH_INDICATORS_TOKEN, HEALTH_OPTIONS_TOKEN, } from './health';
 export { JWTUtil, OAuth2Service, OAuth2Controller, Auth, getAuthMetadata, requiresAuth, checkRoles, OAUTH2_SERVICE_TOKEN, JWT_UTIL_TOKEN, type JWTConfig, type JWTPayload, type OAuth2Client, type OAuth2AuthorizationRequest, type OAuth2TokenRequest, type OAuth2TokenResponse, type UserInfo, type AuthContext, type AuthConfig, } from './auth';
 export { PerformanceHarness, StressTester, type BenchmarkResult, type StressResult, } from './testing/harness';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -396,7 +396,7 @@ class Router {
     }
     return;
   }
-  async handle(context) {
+  async preHandle(context) {
     const method = context.method;
     const path = this.normalizePath(context.path);
     const route = this.findRoute(method, path);
@@ -413,6 +413,15 @@ class Router {
         method: route.methodName
       };
     }
+  }
+  async handle(context) {
+    await this.preHandle(context);
+    const method = context.method;
+    const path = this.normalizePath(context.path);
+    const route = this.findRoute(method, path);
+    if (!route) {
+      return;
+    }
     return await route.execute(context);
   }
   getRoutes() {
@@ -1920,6 +1929,7 @@ class Application {
     }
     const registry = RouteRegistry.getInstance();
     const router = registry.getRouter();
+    await router.preHandle(context);
     return await this.middlewarePipeline.run(context, async () => {
       const response = await router.handle(context);
       if (response) {
@@ -2445,6 +2455,8 @@ SwaggerModule = __legacyDecorateClassTS([
   })
 ], SwaggerModule);
 // src/security/context.ts
+import { AsyncLocalStorage } from "async_hooks";
+
 class SecurityContextImpl {
   _authentication = null;
   get authentication() {
@@ -2468,17 +2480,24 @@ class SecurityContextImpl {
 }
 
 class SecurityContextHolder {
-  static contexts = new Map;
+  static storage = new AsyncLocalStorage;
   static getContext() {
-    const threadId = Bun.main ? 0 : Date.now();
-    if (!this.contexts.has(threadId)) {
-      this.contexts.set(threadId, new SecurityContextImpl);
+    let context = this.storage.getStore();
+    if (!context) {
+      context = new SecurityContextImpl;
+      this.storage.enterWith(context);
     }
-    return this.contexts.get(threadId);
+    return context;
+  }
+  static runWithContext(callback) {
+    const existing = this.storage.getStore() ?? new SecurityContextImpl;
+    return this.storage.run(existing, callback);
   }
   static clearContext() {
-    const threadId = Bun.main ? 0 : Date.now();
-    this.contexts.delete(threadId);
+    const context = this.storage.getStore();
+    if (context) {
+      context.clear();
+    }
   }
 }
 // src/security/authentication-manager.ts
@@ -2532,7 +2551,10 @@ function getAuthMetadata(target, propertyKey) {
 }
 function requiresAuth(target, propertyKey) {
   const config = getAuthMetadata(target, propertyKey);
-  return config?.required !== false;
+  if (!config) {
+    return false;
+  }
+  return config.required !== false;
 }
 function checkRoles(target, propertyKey, userRoles = []) {
   const config = getAuthMetadata(target, propertyKey);
@@ -2552,53 +2574,58 @@ function createSecurityFilter(config) {
     extractToken
   } = config;
   return async (ctx, next) => {
-    const path = ctx.request.url.split("?")[0];
-    if (excludePaths.some((exclude) => path.startsWith(exclude))) {
-      return await next();
-    }
-    const securityContext = SecurityContextHolder.getContext();
-    try {
-      const token = extractToken ? extractToken(ctx) : extractTokenFromHeader(ctx);
-      if (token) {
-        const request = {
-          principal: "",
-          credentials: token,
-          type: "jwt"
-        };
-        const authentication = await authenticationManager.authenticate(request);
-        if (authentication) {
-          securityContext.setAuthentication(authentication);
-        }
+    return SecurityContextHolder.runWithContext(async () => {
+      const path = ctx.path || ctx.request.url.split("?")[0].replace(/^https?:\/\/[^/]+/, "");
+      if (excludePaths.some((exclude) => path.startsWith(exclude))) {
+        return await next();
       }
-      const handler = ctx.routeHandler;
-      if (handler) {
-        const controller = handler.controller;
-        const method = handler.method;
-        if (requiresAuth(controller, method)) {
-          const authentication = securityContext.authentication;
-          if (!authentication || !authentication.authenticated) {
-            throw new UnauthorizedException("Authentication required");
+      const securityContext = SecurityContextHolder.getContext();
+      try {
+        const token = extractToken ? extractToken(ctx) : extractTokenFromHeader(ctx);
+        if (token) {
+          const request = {
+            principal: "",
+            credentials: token,
+            type: "jwt"
+          };
+          const authentication = await authenticationManager.authenticate(request);
+          if (authentication) {
+            securityContext.setAuthentication(authentication);
           }
-          const requiredRoles = getRequiredRoles(controller, method);
-          if (requiredRoles.length > 0) {
-            const hasAccess = accessDecisionManager.decide(authentication, requiredRoles);
-            if (!hasAccess) {
-              const userRoles = authentication.authorities || [];
-              throw new ForbiddenException(`Insufficient permissions. Required roles: ${requiredRoles.join(", ")}, User roles: ${userRoles.join(", ")}`);
+        }
+        const handler = ctx.routeHandler;
+        if (handler) {
+          const controllerClass = handler.controller;
+          const controllerTarget = controllerClass && controllerClass.prototype || controllerClass;
+          const method = handler.method;
+          if (requiresAuth(controllerTarget, method)) {
+            const authentication = securityContext.authentication;
+            if (!authentication || !authentication.authenticated) {
+              throw new UnauthorizedException("Authentication required");
+            }
+            const requiredRoles = getRequiredRoles(controllerTarget, method);
+            if (requiredRoles.length > 0) {
+              const hasAccess = accessDecisionManager.decide(authentication, requiredRoles);
+              if (!hasAccess) {
+                const userRoles = authentication.authorities || [];
+                throw new ForbiddenException(`Insufficient permissions. Required roles: ${requiredRoles.join(", ")}, User roles: ${userRoles.join(", ")}`);
+              }
             }
           }
+        } else if (defaultAuthRequired && !securityContext.isAuthenticated()) {
+          throw new UnauthorizedException("Authentication required");
         }
-      } else if (defaultAuthRequired && !securityContext.isAuthenticated()) {
-        throw new UnauthorizedException("Authentication required");
+        ctx.security = securityContext;
+        ctx.auth = {
+          isAuthenticated: securityContext.isAuthenticated(),
+          user: securityContext.getPrincipal(),
+          payload: securityContext.authentication?.details
+        };
+        return await next();
+      } finally {
+        SecurityContextHolder.clearContext();
       }
-      ctx.security = securityContext;
-      ctx.auth = {
-        isAuthenticated: securityContext.isAuthenticated(),
-        user: securityContext.getPrincipal(),
-        payload: securityContext.authentication?.details
-      };
-      return await next();
-    } finally {}
+    });
   };
 }
 function extractTokenFromHeader(ctx) {
@@ -3111,6 +3138,206 @@ SecurityModule = __legacyDecorateClassTS([
     middlewares: []
   })
 ], SecurityModule);
+// src/config/service.ts
+class ConfigService {
+  config;
+  namespace;
+  constructor(config, namespace) {
+    this.config = config;
+    this.namespace = namespace;
+  }
+  getAll() {
+    return this.config;
+  }
+  get(key, defaultValue) {
+    const namespacedKey = this.applyNamespace(key);
+    const value = this.getValueByPath(this.config, namespacedKey);
+    if (value === undefined) {
+      return defaultValue;
+    }
+    return value;
+  }
+  getRequired(key) {
+    const value = this.get(key);
+    if (value === undefined) {
+      throw new Error(`Config value required for key: ${key}`);
+    }
+    return value;
+  }
+  withNamespace(namespace) {
+    return new ConfigService(this.config, namespace);
+  }
+  applyNamespace(key) {
+    if (!this.namespace) {
+      return key;
+    }
+    if (!key) {
+      return this.namespace;
+    }
+    if (key.startsWith(this.namespace + ".")) {
+      return key;
+    }
+    return `${this.namespace}.${key}`;
+  }
+  getValueByPath(obj, path) {
+    if (!path) {
+      return obj;
+    }
+    const segments = path.split(".");
+    let current = obj;
+    for (const segment of segments) {
+      if (current === undefined || current === null || typeof current !== "object") {
+        return;
+      }
+      current = current[segment];
+    }
+    return current;
+  }
+}
+
+// src/config/types.ts
+var CONFIG_SERVICE_TOKEN = Symbol("@dangao/bun-server:config:service");
+
+// src/config/config-module.ts
+class ConfigModule {
+  static forRoot(options = {}) {
+    const providers2 = [];
+    const env = ConfigModule.snapshotEnv();
+    const defaultConfig = options.defaultConfig ?? {};
+    const loadedConfig = options.load ? options.load(env) : {};
+    const mergedConfig = {
+      ...defaultConfig,
+      ...loadedConfig
+    };
+    const service = new ConfigService(mergedConfig, options.namespace);
+    if (options.validate) {
+      options.validate(mergedConfig);
+    }
+    providers2.push({
+      provide: CONFIG_SERVICE_TOKEN,
+      useValue: service
+    }, ConfigService);
+    const existingMetadata = Reflect.getMetadata(MODULE_METADATA_KEY, ConfigModule) || {};
+    const metadata = {
+      ...existingMetadata,
+      providers: [...existingMetadata.providers || [], ...providers2],
+      exports: [
+        ...existingMetadata.exports || [],
+        CONFIG_SERVICE_TOKEN,
+        ConfigService
+      ]
+    };
+    Reflect.defineMetadata(MODULE_METADATA_KEY, metadata, ConfigModule);
+    return ConfigModule;
+  }
+  static snapshotEnv() {
+    const env = {};
+    for (const [key, value] of Object.entries(process.env)) {
+      env[key] = value;
+    }
+    return env;
+  }
+}
+ConfigModule = __legacyDecorateClassTS([
+  Module({
+    providers: []
+  })
+], ConfigModule);
+// src/health/types.ts
+var HEALTH_INDICATORS_TOKEN = Symbol("@dangao/bun-server:health:indicators");
+var HEALTH_OPTIONS_TOKEN = Symbol("@dangao/bun-server:health:options");
+
+// src/health/controller.ts
+class HealthController {
+  indicators;
+  options;
+  constructor(indicators = [], options) {
+    this.indicators = indicators;
+    this.options = options;
+  }
+  async health() {
+    return await this.checkIndicators();
+  }
+  async ready() {
+    return await this.checkIndicators();
+  }
+  async checkIndicators() {
+    const details = {};
+    for (const indicator of this.indicators || []) {
+      try {
+        const result = await indicator.check();
+        details[indicator.name] = result;
+      } catch (error) {
+        details[indicator.name] = {
+          status: "down",
+          details: {
+            error: error.message
+          }
+        };
+      }
+    }
+    const allUp = Object.keys(details).length === 0 || Object.values(details).every((result) => result.status === "up");
+    return {
+      status: allUp ? "up" : "down",
+      details
+    };
+  }
+}
+__legacyDecorateClassTS([
+  GET("/health"),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", []),
+  __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], HealthController.prototype, "health", null);
+__legacyDecorateClassTS([
+  GET("/ready"),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", []),
+  __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], HealthController.prototype, "ready", null);
+HealthController = __legacyDecorateClassTS([
+  Controller("/"),
+  __legacyDecorateParamTS(0, Inject(HEALTH_INDICATORS_TOKEN)),
+  __legacyDecorateParamTS(1, Inject(HEALTH_OPTIONS_TOKEN)),
+  __legacyMetadataTS("design:paramtypes", [
+    Array,
+    typeof HealthModuleOptions === "undefined" ? Object : HealthModuleOptions
+  ])
+], HealthController);
+
+// src/health/health-module.ts
+class HealthModule {
+  static forRoot(options = {}) {
+    const providers2 = [];
+    const indicators = options.indicators ?? [];
+    providers2.push({
+      provide: HEALTH_INDICATORS_TOKEN,
+      useValue: indicators
+    }, {
+      provide: HEALTH_OPTIONS_TOKEN,
+      useValue: options
+    });
+    const existingMetadata = Reflect.getMetadata(MODULE_METADATA_KEY, HealthModule) || {};
+    const metadata = {
+      ...existingMetadata,
+      controllers: [...existingMetadata.controllers || [], HealthController],
+      providers: [...existingMetadata.providers || [], ...providers2],
+      exports: [
+        ...existingMetadata.exports || [],
+        HEALTH_INDICATORS_TOKEN,
+        HEALTH_OPTIONS_TOKEN
+      ]
+    };
+    Reflect.defineMetadata(MODULE_METADATA_KEY, metadata, HealthModule);
+    return HealthModule;
+  }
+}
+HealthModule = __legacyDecorateClassTS([
+  Module({
+    controllers: [HealthController],
+    providers: []
+  })
+], HealthModule);
 // src/testing/harness.ts
 import { performance as performance2 } from "perf_hooks";
 
@@ -3236,7 +3463,10 @@ export {
   Injectable,
   Inject,
   HttpException,
+  HealthModule,
   Header,
+  HEALTH_OPTIONS_TOKEN,
+  HEALTH_INDICATORS_TOKEN,
   GET,
   ForbiddenException,
   ExceptionFilterRegistry,
@@ -3245,6 +3475,9 @@ export {
   Controller,
   Context,
   Container,
+  ConfigService,
+  ConfigModule,
+  CONFIG_SERVICE_TOKEN,
   BunServer,
   BodyParser,
   Body,

package/dist/router/router.d.ts

@@ -65,7 +65,12 @@ export declare class Router {
      */
     findRoute(method: HttpMethod, path: string): Route | undefined;
     /**
-     * 处理请求
+     * 预处理请求：仅匹配路由并设置路径参数 / routeHandler，但不执行处理器
+     * 供安全过滤器等中间件在真正执行前基于路由元数据做鉴权
+     */
+    preHandle(context: Context): Promise<void>;
+    /**
+     * 处理请求（包含路由匹配 + 执行）
      * @param context - 请求上下文
      * @returns 响应对象，如果没有匹配的路由则返回 undefined
      */

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,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;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;;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,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACrD,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAaP;;;;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;IAerE;;;;OAIG;IACU,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IA4BpE;;;OAGG;IACI,SAAS,IAAI,SAAS,KAAK,EAAE;IAIpC;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB"}
+{"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,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;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;;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,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACrD,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAaP;;;;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;IAerE;;;OAGG;IACU,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvD;;;;OAIG;IACU,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAepE;;;OAGG;IACI,SAAS,IAAI,SAAS,KAAK,EAAE;IAIpC;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB"}

package/dist/security/context.d.ts

@@ -33,13 +33,18 @@ export declare class SecurityContextImpl implements SecurityContext {
  * 安全上下文持有者（ThreadLocal 模式）
  */
 export declare class SecurityContextHolder {
-    private static readonly contexts;
+    private static readonly storage;
     /**
      * 获取当前上下文
      */
     static getContext(): SecurityContextImpl;
     /**
-     * 清除上下文
+     * 在给定回调中运行，绑定独立的安全上下文（每个请求一个）
+     * @param callback - 要在安全上下文中执行的回调
+     */
+    static runWithContext<T>(callback: () => T): T;
+    /**
+     * 清除当前上下文中的认证信息
      */
     static clearContext(): void;
 }

package/dist/security/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/security/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1E;;GAEG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,eAAe,CAA+B;IAEtD;;OAEG;IACH,IAAW,cAAc,IAAI,cAAc,GAAG,IAAI,CAEjD;IAED;;OAEG;IACI,iBAAiB,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI;IAIrE;;OAEG;IACI,eAAe,IAAI,OAAO;IAIjC;;OAEG;IACI,YAAY,IAAI,SAAS,GAAG,IAAI;IAIvC;;OAEG;IACI,cAAc,IAAI,MAAM,EAAE;IAIjC;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IAE1E;;OAEG;WACW,UAAU,IAAI,mBAAmB;IAQ/C;;OAEG;WACW,YAAY,IAAI,IAAI;CAInC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/security/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1E;;GAEG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,eAAe,CAA+B;IAEtD;;OAEG;IACH,IAAW,cAAc,IAAI,cAAc,GAAG,IAAI,CAEjD;IAED;;OAEG;IACI,iBAAiB,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI;IAIrE;;OAEG;IACI,eAAe,IAAI,OAAO;IAIjC;;OAEG;IACI,YAAY,IAAI,SAAS,GAAG,IAAI;IAIvC;;OAEG;IACI,cAAc,IAAI,MAAM,EAAE;IAIjC;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAgD;IAE/E;;OAEG;WACW,UAAU,IAAI,mBAAmB;IAS/C;;;OAGG;WACW,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAKrD;;OAEG;WACW,YAAY,IAAI,IAAI;CAMnC"}

package/dist/security/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/security/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,SAAS,CAAC;AAIrE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D;;OAEG;IACH,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C;;OAEG;IACH,qBAAqB,CAAC,EAAE,8BAA8B,CAAC;IACvD;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;CAChD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,UAAU,CAqF7E"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/security/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,SAAS,CAAC;AAIrE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D;;OAEG;IACH,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C;;OAEG;IACH,qBAAqB,CAAC,EAAE,8BAA8B,CAAC;IACvD;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;CAChD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,UAAU,CA2F7E"}

package/package.json

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

package/readme.md

@@ -31,7 +31,7 @@
   可扩展**：松耦合的模块系统、扩展系统与日志框架，既可以快速起步，也能按需裁剪。
 - **Monorepo 友好**：原生支持 Bun workspaces，使用 `workspace:*`
   协议管理内部依赖，配合 catalog 统一版本，完美适配多包协作场景。
-- **完整测试矩阵**：内置单元/集成测试、压力与基准测试用例，便于持续优化。
+- **完整测试矩阵**：内置单元/集成测试、压力与基准测试用例，Security 和 Swagger 模块测试覆盖完整，便于持续优化。
 
 ## 核心特性
 
@@ -43,6 +43,8 @@
   **中间件管道**：支持全局/控制器/方法级中间件，内置日志、错误处理、CORS、文件上传、静态资源等。
 - ✅ **输入校验**：声明式验证装饰器，直连 `ValidationError` 与异常过滤器。
 - 📡 **WebSocket**：`@WebSocketGateway`、`@OnMessage` 等装饰器级开发体验。
+- 📖 **Swagger/OpenAPI**：内置 Swagger 插件，支持 `@ApiTags`、`@ApiOperation`、`@ApiParam`、`@ApiBody`、`@ApiResponse` 等装饰器，自动生成 API 文档和 Swagger UI。
+- 🔐 **安全认证**：内置 SecurityModule，支持 JWT 和 OAuth2 认证，提供 `@Auth()` 装饰器进行角色权限控制。
 - 📚 **示例与文档**：多语言文档、基础/完整示例、基准脚本与最佳实践。
 
 ## 架构总览
@@ -126,11 +128,12 @@ bun --cwd=benchmark run bench:di     # 仅运行 DI 基准
 
 ## 示例与扩展
 
-- `examples/basic-app.ts`：最小可运行示例，覆盖 DI + Logger + Middleware。
-- `examples/full-app.ts`：包含验证、文件上传、WebSocket、复杂控制器。
-- `examples/multi-module-app.ts`：多模块示例，展示模块间的依赖关系和服务共享。
-- `packages/@dangao/bun-server/src/extensions/`：官方扩展（如
-  LoggerExtension），可用于注册第三方能力。
+- `examples/basic-app.ts`：最小可运行示例，覆盖 DI + Logger + Middleware + Swagger + ConfigModule。
+- `examples/full-app.ts`：包含验证、文件上传、WebSocket、复杂控制器，使用 ConfigModule 管理端口与中间件配置。
+- `examples/multi-module-app.ts`：多模块示例，展示模块间的依赖关系和服务共享，使用 ConfigModule 统一管理应用配置。
+- `examples/auth-app.ts`：完整的认证演示，包含 JWT + OAuth2 认证流程、前端演示页面，并通过 ConfigModule 管理应用标题和端口。
+- `packages/bun-server/src/extensions/`：官方扩展（如
+  LoggerExtension、SwaggerExtension），可用于注册第三方能力。
 
 ## 性能与 Benchmark
 
@@ -153,10 +156,11 @@ bun benchmark/di.bench.ts
 ## 文档与多语言支持
 
 - 中文默认文档位于 `docs/`
-  - `docs/api.md`
-  - `docs/guide.md`
-  - `docs/best-practices.md`
-  - `docs/migration.md`
+  - `docs/api.md` - API 参考文档
+  - `docs/guide.md` - 使用指南
+  - `docs/extensions.md` - 扩展系统说明（中间件、扩展、模块等）
+  - `docs/best-practices.md` - 最佳实践
+  - `docs/migration.md` - 迁移指南
 - 英文草稿位于
   `docs/en/`，与中文文件结构一致；如果缺失内容，请优先参考中文版本。