@dangao/bun-server 1.7.0 → 1.8.0

package/README.md

@@ -49,16 +49,117 @@
 
 ## Architecture
 
+### Request Lifecycle
+
+The following diagram shows the complete request processing flow:
+
+```
+HTTP Request
+    ↓
+┌─────────────────────────────────────┐
+│         Middleware Pipeline         │  ← Global → Module → Controller → Method
+│  (Logger, CORS, RateLimit, etc.)    │
+└─────────────────────────────────────┘
+    ↓
+┌─────────────────────────────────────┐
+│         Security Filter             │  ← Authentication / Authorization
+│   (JWT, OAuth2, Role Check)         │
+└─────────────────────────────────────┘
+    ↓
+┌─────────────────────────────────────┐
+│         Router Matching             │  ← Path, Method, Params
+│   (Static → Dynamic → Wildcard)     │
+└─────────────────────────────────────┘
+    ↓
+┌─────────────────────────────────────┐
+│       Interceptors (Pre)            │  ← Global → Controller → Method
+│   (Cache, Log, Transform)           │
+└─────────────────────────────────────┘
+    ↓
+┌─────────────────────────────────────┐
+│       Parameter Binding             │  ← @Body, @Query, @Param, @Header
+│       + Validation                  │  ← @Validate, IsString, IsEmail...
+└─────────────────────────────────────┘
+    ↓
+┌─────────────────────────────────────┐
+│       Controller Method             │  ← Business Logic Execution
+│   (with DI injected services)       │
+└─────────────────────────────────────┘
+    ↓
+┌─────────────────────────────────────┐
+│       Interceptors (Post)           │  ← Method → Controller → Global
+│   (Response Transform)              │
+└─────────────────────────────────────┘
+    ↓
+┌─────────────────────────────────────┐
+│       Exception Filter              │  ← Exception Handling
+│   (HttpException, ValidationError)  │
+└─────────────────────────────────────┘
+    ↓
+HTTP Response
+```
+
+**Execution Order**: Middleware → Security → Router → Interceptors(Pre) →
+Validation → Handler → Interceptors(Post) → Exception Filter
+
+### Module System
+
 ```
-Application (Controllers / Modules / DI)
-          ↓
-    Middleware Pipeline
-          ↓
- Router + Context + Response
-          ↓
-        Bun Runtime
+Application
+    │
+    ├── ModuleRegistry
+    │   │
+    │   ├── ConfigModule (Configuration)
+    │   ├── LoggerModule (Logging)
+    │   ├── SecurityModule (Authentication)
+    │   │   └── auth/ (JWT, OAuth2)
+    │   ├── SwaggerModule (API Docs)
+    │   ├── CacheModule (Caching)
+    │   ├── DatabaseModule (Database)
+    │   │   └── ORM (Entity, Repository, Transaction)
+    │   ├── QueueModule (Job Queue)
+    │   ├── SessionModule (Session)
+    │   ├── MetricsModule (Metrics)
+    │   ├── HealthModule (Health Check)
+    │   └── Microservice/
+    │       ├── ConfigCenterModule
+    │       ├── ServiceRegistryModule
+    │       ├── ServiceClient
+    │       ├── Governance (Circuit Breaker/Rate Limit/Retry)
+    │       └── Tracing
+    │
+    ├── ControllerRegistry
+    │   └── All module controllers
+    │
+    ├── WebSocketGatewayRegistry
+    │   └── WebSocket gateways
+    │
+    └── InterceptorRegistry
+        └── Interceptor registry
 ```
 
+### DI Container
+
+```
+Container
+    │
+    ├── providers (Map<token, ProviderConfig>)
+    │   ├── Singleton (shared globally)
+    │   ├── Transient (new instance per resolve)
+    │   └── Scoped (per-request instance)
+    │
+    ├── singletons (singleton instance cache)
+    │
+    ├── scopedInstances (WeakMap, request-level cache)
+    │
+    ├── dependencyPlans (dependency resolution plan cache)
+    │
+    └── postProcessors (instance post-processors)
+```
+
+For detailed lifecycle documentation, see
+[Request Lifecycle](./docs/request-lifecycle.md).
+
 ## Getting Started
 
 ### Requirements
@@ -78,7 +179,10 @@ Application (Controllers / Modules / DI)
 }
 ```
 
-Without these, dependency injection will fail (injected services will be `undefined`). See [Troubleshooting Guide](./docs/troubleshooting.md#-critical-injected-dependencies-are-undefined) for details.
+Without these, dependency injection will fail (injected services will be
+`undefined`). See
+[Troubleshooting Guide](./docs/troubleshooting.md#-critical-injected-dependencies-are-undefined)
+for details.
 
 ### Install
 
@@ -117,14 +221,14 @@ app.listen();
 ### Useful scripts
 
 ```bash
-bun --cwd=packages/@dangao/bun-server test
-bun --cwd=packages/@dangao/bun-server run bench
-bun --cwd=packages/@dangao/bun-server run bench:router
-bun --cwd=packages/@dangao/bun-server run bench:di
+bun --cwd=packages/bun-server test
+bun --cwd=packages/bun-server run bench
+bun --cwd=packages/bun-server run bench:router
+bun --cwd=packages/bun-server run bench:di
 ```
 
 > Running `bun test` from the repo root fails because Bun only scans the current
-> workspace. Use the commands above or `cd packages/@dangao/bun-server` first.
+> workspace. Use the commands above or `cd packages/bun-server` first.
 
 ### Advanced Example: Interface + Symbol + Module
 
@@ -249,11 +353,84 @@ app.listen();
 
 ## Examples & Extensions
 
-- `examples/basic-app.ts`: minimal DI + Logger + Middleware showcase.
-- `examples/full-app.ts`: advanced controllers, validation, uploads, WebSocket.
-- `packages/@dangao/bun-server/src/extensions/`: official extensions (e.g.
+### 📚 Organized Examples
+
+Examples are organized by difficulty and feature category:
+
+- **[Quick Start](./examples/00-quick-start/)** - Get started in 5 minutes
+  - `01-hello-world.ts` - Minimal example (5 lines)
+  - `02-basic-routing.ts` - HTTP methods and route parameters
+  - `03-dependency-injection.ts` - DI basics with services
+
+- **[Core Features](./examples/01-core-features/)** - Deep dive into framework
+  mechanics
+  - `basic-app.ts` - DI + Logger + Swagger + Config integration
+  - `multi-module-app.ts` - Module dependencies and organization
+  - `context-scope-app.ts` - Request scoping and ContextService
+  - `full-app.ts` - Validation, uploads, static files, WebSocket
+
+- **[Official Modules](./examples/02-official-modules/)** - Ready-to-use modules
+  - `auth-app.ts` - JWT + OAuth2 authentication (with Web UI)
+  - `session-app.ts` - Session management
+  - `database-app.ts` - Database connection and queries
+  - `orm-app.ts` - Entity + Repository pattern
+  - `cache-app.ts` - Caching with decorators
+  - `queue-app.ts` - Task queues and Cron jobs
+
+- **[Advanced](./examples/03-advanced/)** - Custom framework extensions
+  - `custom-decorator-app.ts` - Create custom decorators
+  - `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
+
+### 🔑 Symbol + Interface Pattern
+
+This framework features a unique **Symbol + Interface co-naming pattern** that
+solves TypeScript's type erasure problem:
+
+```typescript
+// 1. Define interface and Symbol with same name
+interface UserService {
+  find(id: string): Promise<User>;
+}
+const UserService = Symbol('UserService');
+
+// 2. Implement interface
+@Injectable()
+class UserServiceImpl implements UserService {
+  async find(id: string) { ... }
+}
+
+// 3. Register with Symbol token
+@Module({
+  providers: [{
+    provide: UserService,      // Symbol token
+    useClass: UserServiceImpl, // Implementation
+  }],
+})
+
+// 4. Inject with type safety
+constructor(private readonly userService: UserService) {}
+```
+
+**Key**: Import as `import { UserService }` (not `import type { UserService }`).
+
+See [Symbol + Interface Pattern Guide](./docs/symbol-interface-pattern.md) for
+details.
+
+### 🔌 Extensions
+
+- `packages/bun-server/src/extensions/`: Official extensions (e.g.
   `LoggerExtension`) for plugging in external capabilities.
 
+### 📖 Complete Example Index
+
+See [examples/README.md](./examples/README.md) for the complete catalog with
+learning paths, difficulty ratings, and usage scenarios.
+
 ## Benchmark Suite
 
 Benchmarks live in `benchmark/` and rely on `PerformanceHarness` &
@@ -278,14 +455,14 @@ Or use `bun run bench*` scripts for convenience.
 - **English** (default): `docs/api.md`, `docs/guide.md`,
   `docs/best-practices.md`, `docs/migration.md`, `docs/extensions.md`,
   `docs/deployment.md`, `docs/performance.md`, `docs/troubleshooting.md`,
-  `docs/error-handling.md`.
+  `docs/error-handling.md`, `docs/request-lifecycle.md`.
 - **Chinese**: mirrored under `docs/zh/`. If something is missing, please fall
   back to the English source.
 
 ## Roadmap
 
-Detailed milestones and history are tracked in
-[`.roadmap/v0.3.0.md`](./.roadmap/v0.3.0.md).
+Detailed milestones and history are tracked in the [`.roadmap/`](./.roadmap/)
+directory.
 
 ## AI-Assisted Development
 

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

@@ -1,9 +1,27 @@
 import { type CacheModuleOptions } from './types';
+import { CachePostProcessor } from './service-proxy';
+/**
+ * 缓存后处理器 Token
+ */
+export declare const CACHE_POST_PROCESSOR_TOKEN: unique symbol;
 export declare class CacheModule {
+    /**
+     * 缓存后处理器实例（单例）
+     */
+    private static postProcessor;
     /**
      * 创建缓存模块
      * @param options - 模块配置
      */
     static forRoot(options?: CacheModuleOptions): typeof CacheModule;
+    /**
+     * 获取缓存后处理器
+     * 用于在应用启动时注册到 DI 容器
+     */
+    static getPostProcessor(): CachePostProcessor | null;
+    /**
+     * 重置模块状态（主要用于测试）
+     */
+    static reset(): void;
 }
 //# sourceMappingURL=cache-module.d.ts.map

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;AAEjB,qBAGa,WAAW;IACtB;;;OAGG;WACW,OAAO,CACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,WAAW;CA6CtB"}
+{"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"}

package/dist/cache/index.d.ts

@@ -1,6 +1,8 @@
-export { CacheModule } from './cache-module';
+export { CacheModule, CACHE_POST_PROCESSOR_TOKEN } from './cache-module';
 export { CacheService } from './service';
 export { Cacheable, CacheEvict, CachePut, getCacheableMetadata, getCacheEvictMetadata, getCachePutMetadata, type CacheableOptions, type CacheEvictOptions, type CachePutOptions, type CacheableMetadata, type CacheEvictMetadata, type CachePutMetadata, } from './decorators';
 export { MemoryCacheStore, RedisCacheStore, CACHE_SERVICE_TOKEN, CACHE_OPTIONS_TOKEN, } from './types';
 export type { CacheStore, CacheModuleOptions, RedisCacheStoreOptions, } from './types';
+export { CacheServiceProxy, CachePostProcessor, EnableCacheProxy, isCacheProxyEnabled, CACHE_PROXY_ENABLED_KEY, } from './service-proxy';
+export { CacheableInterceptor, CacheEvictInterceptor, CachePutInterceptor, CACHEABLE_INTERCEPTOR_KEY, CACHE_EVICT_INTERCEPTOR_KEY, CACHE_PUT_INTERCEPTOR_KEY, } from './interceptors';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC"}

package/dist/cache/interceptors.d.ts

@@ -0,0 +1,41 @@
+import 'reflect-metadata';
+import { BaseInterceptor } from '../interceptor/base-interceptor';
+import type { Container } from '../di/container';
+import type { Context } from '../core/context';
+/**
+ * 缓存装饰器元数据键（用于拦截器注册）
+ */
+export declare const CACHEABLE_INTERCEPTOR_KEY: unique symbol;
+export declare const CACHE_EVICT_INTERCEPTOR_KEY: unique symbol;
+export declare const CACHE_PUT_INTERCEPTOR_KEY: unique symbol;
+/**
+ * @Cacheable 拦截器
+ * 实现方法结果缓存功能
+ */
+export declare class CacheableInterceptor extends BaseInterceptor {
+    /**
+     * 执行拦截器逻辑
+     */
+    execute<T>(target: unknown, propertyKey: string | symbol, originalMethod: (...args: unknown[]) => T | Promise<T>, args: unknown[], container: Container, context?: Context): Promise<T>;
+}
+/**
+ * @CacheEvict 拦截器
+ * 实现缓存清除功能
+ */
+export declare class CacheEvictInterceptor extends BaseInterceptor {
+    /**
+     * 执行拦截器逻辑
+     */
+    execute<T>(target: unknown, propertyKey: string | symbol, originalMethod: (...args: unknown[]) => T | Promise<T>, args: unknown[], container: Container, context?: Context): Promise<T>;
+}
+/**
+ * @CachePut 拦截器
+ * 实现缓存更新功能（总是执行方法并更新缓存）
+ */
+export declare class CachePutInterceptor extends BaseInterceptor {
+    /**
+     * 执行拦截器逻辑
+     */
+    execute<T>(target: unknown, propertyKey: string | symbol, originalMethod: (...args: unknown[]) => T | Promise<T>, args: unknown[], container: Container, context?: Context): Promise<T>;
+}
+//# sourceMappingURL=interceptors.d.ts.map

package/dist/cache/interceptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../../src/cache/interceptors.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAY/C;;GAEG;AACH,eAAO,MAAM,yBAAyB,eAA+C,CAAC;AACtF,eAAO,MAAM,2BAA2B,eAAiD,CAAC;AAC1F,eAAO,MAAM,yBAAyB,eAA+C,CAAC;AA8DtF;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;IACvD;;OAEG;IACU,OAAO,CAAC,CAAC,EACpB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACtD,IAAI,EAAE,OAAO,EAAE,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,CAAC,CAAC;CAwDd;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;IACxD;;OAEG;IACU,OAAO,CAAC,CAAC,EACpB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACtD,IAAI,EAAE,OAAO,EAAE,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,CAAC,CAAC;CAyDd;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;IACtD;;OAEG;IACU,OAAO,CAAC,CAAC,EACpB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACtD,IAAI,EAAE,OAAO,EAAE,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,CAAC,CAAC;CAkDd"}

package/dist/cache/service-proxy.d.ts

@@ -0,0 +1,62 @@
+import 'reflect-metadata';
+import type { Container } from '../di/container';
+import type { InstancePostProcessor } from '../di/types';
+import type { Constructor } from '../core/types';
+/**
+ * 缓存服务代理工厂
+ * 为服务实例创建代理，拦截带有缓存装饰器的方法
+ */
+export declare class CacheServiceProxy {
+    private static cacheableInterceptor;
+    private static cacheEvictInterceptor;
+    private static cachePutInterceptor;
+    /**
+     * 为服务实例创建缓存代理
+     * @param instance - 原始服务实例
+     * @param container - DI 容器
+     * @returns 代理实例
+     */
+    static createProxy<T extends object>(instance: T, container: Container): T;
+}
+/**
+ * 元数据键：标记服务需要缓存代理
+ */
+export declare const CACHE_PROXY_ENABLED_KEY: unique symbol;
+/**
+ * 启用服务缓存代理的装饰器
+ * 用于标记服务类需要缓存代理支持
+ *
+ * @example
+ * ```ts
+ * @Injectable()
+ * @EnableCacheProxy()
+ * class UserService {
+ *   @Cacheable({ key: 'user:{0}', ttl: 60000 })
+ *   async findById(id: string) {
+ *     return await this.db.findUser(id);
+ *   }
+ * }
+ * ```
+ */
+export declare function EnableCacheProxy(): ClassDecorator;
+/**
+ * 检查类是否启用了缓存代理
+ * @param target - 目标类
+ * @returns 是否启用
+ */
+export declare function isCacheProxyEnabled(target: Function): boolean;
+/**
+ * 缓存实例后处理器
+ * 自动为带有 @EnableCacheProxy() 装饰器的服务创建缓存代理
+ */
+export declare class CachePostProcessor implements InstancePostProcessor {
+    /**
+     * 优先级（较低以确保在其他处理器之后运行）
+     */
+    priority: number;
+    /**
+     * 处理新创建的实例
+     */
+    postProcess<T>(instance: T, constructor: Constructor<T>, container: unknown): T;
+}
+//# sourceMappingURL=service-proxy.d.ts.map

package/dist/cache/service-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-proxy.d.ts","sourceRoot":"","sources":["../../src/cache/service-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAYjD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAA8B;IACjE,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAA+B;IACnE,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAA6B;IAE/D;;;;;OAKG;WACW,WAAW,CAAC,CAAC,SAAS,MAAM,EACxC,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,SAAS,GACnB,CAAC;CAmHL;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,eAAmD,CAAC;AAExF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAIjD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAE7D;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,qBAAqB;IAC9D;;OAEG;IACI,QAAQ,SAAM;IAErB;;OAEG;IACI,WAAW,CAAC,CAAC,EAClB,QAAQ,EAAE,CAAC,EACX,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,OAAO,GACjB,CAAC;CAeL"}

package/dist/controller/controller.d.ts

@@ -48,6 +48,14 @@ export declare class ControllerRegistry {
      * @param basePath - 基础路径
      * @param methodPath - 方法路径
      * @returns 组合后的路径
+     *
+     * 路径规范化规则：
+     * - [/ + /api/base] -> /api/base
+     * - [// + /api/base] -> /api/base
+     * - [/api + /base] -> /api/base
+     * - [/api/ + base] -> /api/base
+     * - [/api/base + ""] -> /api/base
+     * - [/api/base + /] -> /api/base
      */
     private combinePaths;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/controller/controller.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD;;GAEG;AACH,eAAO,MAAM,uBAAuB,eAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAW,IACzB,QAAQ,WAAW,CAAC,OAAO,CAAC,UAI9C;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4C;IACxE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA8C;IAEnF,OAAO;IAIP;;OAEG;WACW,WAAW,IAAI,kBAAkB;IAO/C;;;OAGG;IACI,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAyJnF;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAepB;;;OAGG;IACI,YAAY,IAAI,SAAS;IAIhC;;;OAGG;IACI,iBAAiB,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE;IAIlD;;;OAGG;IACI,wBAAwB,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE;IAIzD;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/controller/controller.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD;;GAEG;AACH,eAAO,MAAM,uBAAuB,eAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAW,IACzB,QAAQ,WAAW,CAAC,OAAO,CAAC,UAI9C;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4C;IACxE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA8C;IAEnF,OAAO;IAIP;;OAEG;WACW,WAAW,IAAI,kBAAkB;IAO/C;;;OAGG;IACI,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAyJnF;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,YAAY;IA+BpB;;;OAGG;IACI,YAAY,IAAI,SAAS;IAIhC;;;OAGG;IACI,iBAAiB,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE;IAIlD;;;OAGG;IACI,wBAAwB,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE;IAIzD;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB"}

package/dist/core/application.d.ts

@@ -87,6 +87,11 @@ export declare class Application {
      * @param moduleClass - 模块类
      */
     registerModule(moduleClass: ModuleClass): void;
+    /**
+     * 检测并注册缓存后处理器
+     * @param container - DI 容器
+     */
+    private registerCachePostProcessorIfNeeded;
     /**
      * 注册 WebSocket 网关
      * @param gatewayClass - WebSocket 网关类

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;AAO3C;;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;IAkCpE;;OAEG;YACW,oBAAoB;IAqBlC;;;OAGG;YACW,sBAAsB;IAyBpC;;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;IA8B3B;;;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;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;AAQ3C;;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;IAkCpE;;OAEG;YACW,oBAAoB;IAqBlC;;;OAGG;YACW,sBAAsB;IAyBpC;;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;IA8B3B;;;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/di/container.d.ts

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import { type ProviderConfig } from "./types";
+import { type InstancePostProcessor, type ProviderConfig } from "./types";
 import type { Constructor } from "@/core/types";
 /**
  * 依赖注入容器
@@ -32,6 +32,10 @@ export declare class Container {
      * 依赖计划缓存，避免重复解析反射元数据
      */
     private readonly dependencyPlans;
+    /**
+     * 实例后处理器列表
+     */
+    private readonly postProcessors;
     /**
      * 注册提供者
      * @param token - 提供者标识符（类构造函数或 token）
@@ -44,6 +48,19 @@ export declare class Container {
      * @param instance - 实例对象
      */
     registerInstance<T>(token: Constructor<T> | string | symbol, instance: T): void;
+    /**
+     * 注册实例后处理器
+     * @param processor - 后处理器实例
+     */
+    registerPostProcessor(processor: InstancePostProcessor): void;
+    /**
+     * 应用所有后处理器（包括父容器的后处理器）
+     * @param instance - 原始实例
+     * @param constructor - 构造函数
+     * @param originContainer - 原始调用容器（用于后处理器解析依赖）
+     * @returns 处理后的实例
+     */
+    private applyPostProcessors;
     /**
      * 解析依赖
      * @param token - 提供者标识符

package/dist/di/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/di/container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AAOjB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;;GAGG;AACH,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAY;gBAEjB,OAAO,GAAE,gBAAqB;IAGjD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8C;IAExE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;IAElE;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwD;IAExF;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGxB;IAEJ;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG5B;IAEJ;;;;OAIG;IACI,QAAQ,CAAC,CAAC,EACf,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,EACvC,MAAM,CAAC,EAAE,cAAc,GACtB,IAAI;IA6BP;;;;OAIG;IACI,gBAAgB,CAAC,CAAC,EACvB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,EACvC,QAAQ,EAAE,CAAC,GACV,IAAI;IAQP;;;;OAIG;IACI,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC;IAyF7D;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAsGvB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAenB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IASnB;;;OAGG;IACI,KAAK,IAAI,IAAI;IAQpB;;;;OAIG;IACI,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO;IAK3E,OAAO,CAAC,iBAAiB;IAuDzB,OAAO,CAAC,eAAe;CA6BxB"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/di/container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,qBAAqB,EAG1B,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AAOjB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;;GAGG;AACH,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAY;gBAEjB,OAAO,GAAE,gBAAqB;IAGjD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8C;IAExE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;IAElE;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwD;IAExF;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGxB;IAEJ;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG5B;IAEJ;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+B;IAE9D;;;;OAIG;IACI,QAAQ,CAAC,CAAC,EACf,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,EACvC,MAAM,CAAC,EAAE,cAAc,GACtB,IAAI;IA6BP;;;;OAIG;IACI,gBAAgB,CAAC,CAAC,EACvB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,EACvC,QAAQ,EAAE,CAAC,GACV,IAAI;IAQP;;;OAGG;IACI,qBAAqB,CAAC,SAAS,EAAE,qBAAqB,GAAG,IAAI;IAMpE;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAsB3B;;;;OAIG;IACI,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC;IAyF7D;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAsGvB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAkBnB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IASnB;;;OAGG;IACI,KAAK,IAAI,IAAI;IASpB;;;;OAIG;IACI,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO;IAK3E,OAAO,CAAC,iBAAiB;IAuDzB,OAAO,CAAC,eAAe;CA6BxB"}

package/dist/di/decorators.d.ts

@@ -1,6 +1,10 @@
 import "reflect-metadata";
 import { type DependencyMetadata, Lifecycle } from "./types";
 import type { Constructor } from "@/core/types";
+/**
+ * 全局模块元数据键
+ */
+export declare const GLOBAL_MODULE_METADATA_KEY: unique symbol;
 /**
  * Injectable 装饰器
  * 标记类为可注入的
@@ -40,4 +44,37 @@ export declare function getLifecycle(target: Constructor<unknown>): Lifecycle |
  * @returns 类型引用
  */
 export declare function getTypeReference(constructor: Constructor<unknown>, parameterIndex: number): Constructor<unknown> | undefined;
+/**
+ * Global 装饰器
+ * 标记模块为全局模块，其导出的提供者可在任何模块中使用，无需显式导入
+ *
+ * @example
+ * ```typescript
+ * @Global()
+ * @Module({
+ *   providers: [ConfigService],
+ *   exports: [ConfigService],
+ * })
+ * class GlobalConfigModule {}
+ *
+ * // 其他模块无需导入 GlobalConfigModule 即可使用 ConfigService
+ * @Module({
+ *   controllers: [UserController],
+ *   providers: [UserService],
+ * })
+ * class UserModule {}
+ *
+ * @Injectable()
+ * class UserService {
+ *   constructor(private readonly config: ConfigService) {}
+ * }
+ * ```
+ */
+export declare function Global(): ClassDecorator;
+/**
+ * 检查模块是否为全局模块
+ * @param target - 目标模块类
+ * @returns 是否为全局模块
+ */
+export declare function isGlobalModule(target: Constructor<unknown>): boolean;
 //# sourceMappingURL=decorators.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/di/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,kBAAkB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAgBhD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GACjC,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,CASxC;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CACpB,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAC7C,kBAAkB,CAoGpB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,EAAE,CAuC3E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAC3B,SAAS,GAAG,SAAS,CAEvB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,EACjC,cAAc,EAAE,MAAM,GACrB,WAAW,CAAC,OAAO,CAAC,GAAG,SAAS,CAMlC"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/di/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,kBAAkB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD;;GAEG;AACH,eAAO,MAAM,0BAA0B,eAA6C,CAAC;AAUrF;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GACjC,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,CASxC;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CACpB,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAC7C,kBAAkB,CAoGpB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,EAAE,CAuC3E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAC3B,SAAS,GAAG,SAAS,CAEvB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,EACjC,cAAc,EAAE,MAAM,GACrB,WAAW,CAAC,OAAO,CAAC,GAAG,SAAS,CAMlC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,IAAI,cAAc,CAIvC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,CAEpE"}

package/dist/di/index.d.ts

@@ -1,4 +1,4 @@
 export { Container } from './container';
-export { Injectable, Inject, getDependencyMetadata, isInjectable, getLifecycle } from './decorators';
-export { Lifecycle, type ProviderConfig, type DependencyMetadata } from './types';
+export { Injectable, Inject, getDependencyMetadata, isInjectable, getLifecycle, Global, isGlobalModule, GLOBAL_MODULE_METADATA_KEY, } from './decorators';
+export { Lifecycle, INSTANCE_POST_PROCESSOR_TOKEN, type ProviderConfig, type DependencyMetadata, type InstancePostProcessor, } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/di/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrG,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/di/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,UAAU,EACV,MAAM,EACN,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,cAAc,EACd,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,6BAA6B,EAC7B,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,GAC3B,MAAM,SAAS,CAAC"}

package/dist/di/module-registry.d.ts

@@ -10,18 +10,35 @@ interface ModuleRef {
     attachedParents: Set<Container>;
     extensions: ApplicationExtension[];
     middlewares: Middleware[];
+    /**
+     * 是否为全局模块
+     */
+    isGlobal: boolean;
 }
 export declare class ModuleRegistry {
     private static instance;
     private readonly moduleRefs;
     private readonly processing;
     private rootContainer?;
+    /**
+     * 存储全局模块列表，用于在其他模块注册时自动附加全局 exports
+     */
+    private readonly globalModules;
     static getInstance(): ModuleRegistry;
     register(moduleClass: ModuleClass, parentContainer: Container): ModuleRef;
     getModuleRef(moduleClass: ModuleClass): ModuleRef | undefined;
     clear(): void;
+    /**
+     * 获取所有全局模块
+     */
+    getGlobalModules(): ModuleClass[];
     private processModule;
     private getOrCreateModuleRef;
+    /**
+     * 将全局模块的 exports 注册到根容器
+     * 这样所有模块都可以访问全局模块导出的提供者
+     */
+    private registerGlobalExports;
     private registerProviders;
     private registerControllers;
     private attachModuleToParent;

package/dist/di/module-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-registry.d.ts","sourceRoot":"","sources":["../../src/di/module-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAA2C,MAAM,UAAU,CAAC;AAExG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,UAAU,SAAS;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC/C,SAAS,EAAE,SAAS,CAAC;IACrB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,eAAe,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAChC,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,aAAa,CAAC,CAAY;WAEpB,WAAW,IAAI,cAAc;IAOpC,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,GAAG,SAAS;IAOzE,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS;IAI7D,KAAK,IAAI,IAAI;IAMpB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACI,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,oBAAoB,EAAE;IAQ5E;;OAEG;IACI,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,EAAE;IAQnE,OAAO,CAAC,cAAc;CAgBvB"}
+{"version":3,"file":"module-registry.d.ts","sourceRoot":"","sources":["../../src/di/module-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAA2C,MAAM,UAAU,CAAC;AAGxG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,UAAU,SAAS;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC/C,SAAS,EAAE,SAAS,CAAC;IACrB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,eAAe,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAChC,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,aAAa,CAAC,CAAY;IAClC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;WAE1C,WAAW,IAAI,cAAc;IAOpC,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,GAAG,SAAS;IAOzE,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS;IAI7D,KAAK,IAAI,IAAI;IAOpB;;OAEG;IACI,gBAAgB,IAAI,WAAW,EAAE;IAIxC,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,oBAAoB;IAkC5B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACI,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,oBAAoB,EAAE;IAQ5E;;OAEG;IACI,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,EAAE;IAQnE,OAAO,CAAC,cAAc;CAgBvB"}