@dangao/bun-server 1.7.1 → 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
+    │
+    ├── 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
+
 ```
-Application (Controllers / Modules / DI)
-          ↓
-    Middleware Pipeline
-          ↓
- Router + Context + Response
-          ↓
-        Bun Runtime
+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
 
@@ -258,7 +362,8 @@ Examples are organized by difficulty and feature category:
   - `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
+- **[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
@@ -283,7 +388,8 @@ Examples are organized by difficulty and feature category:
 
 ### 🔑 Symbol + Interface Pattern
 
-This framework features a unique **Symbol + Interface co-naming pattern** that solves TypeScript's type erasure problem:
+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
@@ -312,16 +418,18 @@ 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.
+See [Symbol + Interface Pattern Guide](./docs/symbol-interface-pattern.md) for
+details.
 
 ### 🔌 Extensions
 
-- `packages/@dangao/bun-server/src/extensions/`: Official extensions (e.g.
+- `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.
+See [examples/README.md](./examples/README.md) for the complete catalog with
+learning paths, difficulty ratings, and usage scenarios.
 
 ## Benchmark Suite
 
@@ -347,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/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 { 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,EACL,SAAS,EACT,6BAA6B,EAC7B,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,GAC3B,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"}

package/dist/events/decorators.d.ts

@@ -0,0 +1,52 @@
+import 'reflect-metadata';
+import { type OnEventMethodMetadata } from './types';
+/**
+ * OnEvent 装饰器选项
+ */
+export interface OnEventOptions {
+    /**
+     * 是否异步处理
+     * @default false
+     */
+    async?: boolean;
+    /**
+     * 监听器优先级（数值越大优先级越高）
+     * @default 0
+     */
+    priority?: number;
+}
+/**
+ * 事件监听器装饰器
+ * 用于标记方法为事件监听器
+ *
+ * @param event - 事件名称或标识符
+ * @param options - 监听选项
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class NotificationService {
+ *   @OnEvent('user.created')
+ *   handleUserCreated(payload: UserCreatedEvent) {
+ *     console.log('User created:', payload.userId);
+ *   }
+ *
+ *   @OnEvent(USER_DELETED, { async: true, priority: 10 })
+ *   async handleUserDeleted(payload: UserDeletedEvent) {
+ *     await this.cleanup(payload.userId);
+ *   }
+ * }
+ * ```
+ */
+export declare function OnEvent(event: string | symbol, options?: OnEventOptions): MethodDecorator;
+/**
+ * 获取类的事件监听器元数据
+ * @param target - 目标类
+ */
+export declare function getOnEventMetadata(target: Function): OnEventMethodMetadata[] | undefined;
+/**
+ * 检查类是否为事件监听器类
+ * @param target - 目标类
+ */
+export declare function isEventListenerClass(target: Function): boolean;
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/events/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,GAAE,cAAmB,GAC3B,eAAe,CAgCjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,QAAQ,GACf,qBAAqB,EAAE,GAAG,SAAS,CAErC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAI9D"}

package/dist/events/event-module.d.ts

@@ -0,0 +1,97 @@
+import 'reflect-metadata';
+import type { Container } from '../di/container';
+import { type EventModuleOptions, type EventEmitter } from './types';
+/**
+ * 事件监听器扫描器
+ * 负责扫描和注册带有 @OnEvent() 装饰器的方法
+ */
+export declare class EventListenerScanner {
+    private readonly eventEmitter;
+    private readonly container;
+    /**
+     * 构造函数
+     * @param eventEmitter - 事件发射器服务
+     * @param container - DI 容器
+     */
+    constructor(eventEmitter: EventEmitter, container: Container);
+    /**
+     * 扫描并注册监听器类
+     * @param listenerClasses - 监听器类数组
+     */
+    scanAndRegister(listenerClasses: Function[]): void;
+    /**
+     * 注册单个监听器类
+     * @param listenerClass - 监听器类
+     */
+    registerListenerClass(listenerClass: Function): void;
+}
+/**
+ * 事件监听器扫描器 Token
+ */
+export declare const EVENT_LISTENER_SCANNER_TOKEN: unique symbol;
+export declare class EventModule {
+    /**
+     * 已注册的监听器类（用于模块初始化后扫描）
+     */
+    private static listenerClasses;
+    /**
+     * 创建事件模块
+     * @param options - 模块配置
+     *
+     * @example
+     * ```typescript
+     * @Module({
+     *   imports: [
+     *     EventModule.forRoot({
+     *       wildcard: true,
+     *       maxListeners: 20,
+     *     }),
+     *   ],
+     *   providers: [NotificationService, AnalyticsService],
+     * })
+     * class AppModule {}
+     * ```
+     */
+    static forRoot(options?: EventModuleOptions): typeof EventModule;
+    /**
+     * 注册监听器类
+     * 用于在模块配置后手动注册监听器类
+     *
+     * @param listenerClasses - 监听器类数组
+     *
+     * @example
+     * ```typescript
+     * EventModule.registerListeners([NotificationService, AnalyticsService]);
+     * ```
+     */
+    static registerListeners(listenerClasses: Function[]): void;
+    /**
+     * 初始化事件监听器扫描
+     * 在应用启动时调用，扫描并注册所有监听器
+     *
+     * @param listenerContainer - 用于解析监听器服务的 DI 容器（通常是应用模块的容器）
+     * @param additionalListeners - 额外的监听器类
+     *
+     * @example
+     * ```typescript
+     * // 在 registerModule 之后调用
+     * app.registerModule(RootModule);
+     *
+     * // 方式1：传入监听器所在模块的容器（推荐）
+     * const moduleRef = ModuleRegistry.getInstance().getModuleRef(RootModule);
+     * EventModule.initializeListeners(moduleRef?.container, [NotificationService]);
+     *
+     * // 方式2：如果监听器在 EventModule 的 providers 中注册，可以不传容器
+     * EventModule.initializeListeners(undefined, [NotificationService]);
+     * ```
+     */
+    static initializeListeners(listenerContainer?: Container, additionalListeners?: Function[]): void;
+    /**
+     * 获取事件发射器服务（静态方法）
+     * 用于在模块配置后获取事件发射器
+     *
+     * @param container - DI 容器（可选，如果不提供则从 EventModule 自身的容器获取）
+     */
+    static getEventEmitter(container?: Container): EventEmitter | undefined;
+}
+//# sourceMappingURL=event-module.d.ts.map

package/dist/events/event-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-module.d.ts","sourceRoot":"","sources":["../../src/events/event-module.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAClB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,oBAAoB;IAO7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B;;;;OAIG;gBAEgB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS;IAGvC;;;OAGG;IACI,eAAe,CAAC,eAAe,EAAE,QAAQ,EAAE,GAAG,IAAI;IAMzD;;;OAGG;IACI,qBAAqB,CAAC,aAAa,EAAE,QAAQ,GAAG,IAAI;CA2C5D;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,eAExC,CAAC;AAEF,qBAGa,WAAW;IACtB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe,CAAkB;IAEhD;;;;;;;;;;;;;;;;;OAiBG;WACW,OAAO,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,WAAW;IAsC3E;;;;;;;;;;OAUG;WACW,iBAAiB,CAAC,eAAe,EAAE,QAAQ,EAAE,GAAG,IAAI;IAIlE;;;;;;;;;;;;;;;;;;;OAmBG;WACW,mBAAmB,CAC/B,iBAAiB,CAAC,EAAE,SAAS,EAC7B,mBAAmB,GAAE,QAAQ,EAAO,GACnC,IAAI;IA2CP;;;;;OAKG;WACW,eAAe,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS;CAwB/E"}

package/dist/events/index.d.ts

@@ -0,0 +1,5 @@
+export { EVENT_EMITTER_TOKEN, EVENT_OPTIONS_TOKEN, ON_EVENT_METADATA_KEY, EVENT_LISTENER_CLASS_METADATA_KEY, type EventEmitter, type EventListener, type EventMetadata, type EventModuleOptions, type ListenerOptions, type OnEventMethodMetadata, type RegisteredListener, } from './types';
+export { EventEmitterService } from './service';
+export { OnEvent, getOnEventMetadata, isEventListenerClass, type OnEventOptions, } from './decorators';
+export { EventModule, EventListenerScanner, EVENT_LISTENER_SCANNER_TOKEN, } from './event-module';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,iCAAiC,EACjC,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD,OAAO,EACL,OAAO,EACP,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC"}

package/dist/events/service.d.ts

@@ -0,0 +1,76 @@
+import type { EventEmitter, EventListener, EventModuleOptions, ListenerOptions } from './types';
+/**
+ * 事件发射器服务实现
+ */
+export declare class EventEmitterService implements EventEmitter {
+    /**
+     * 事件监听器映射
+     */
+    private listeners;
+    /**
+     * 模块选项
+     */
+    private options;
+    /**
+     * 构造函数
+     * @param options - 模块选项
+     */
+    constructor(options?: EventModuleOptions);
+    /**
+     * 发布事件（同步触发所有监听器，不等待异步监听器完成）
+     */
+    emit<T>(event: string | symbol, payload: T): void;
+    /**
+     * 异步发布事件（等待所有监听器完成）
+     */
+    emitAsync<T>(event: string | symbol, payload: T): Promise<void>;
+    /**
+     * 订阅事件
+     */
+    on<T>(event: string | symbol, listener: EventListener<T>, options?: ListenerOptions): () => void;
+    /**
+     * 一次性订阅
+     */
+    once<T>(event: string | symbol, listener: EventListener<T>, options?: ListenerOptions): () => void;
+    /**
+     * 取消订阅
+     */
+    off<T>(event: string | symbol, listener: EventListener<T>): void;
+    /**
+     * 移除所有监听器
+     */
+    removeAllListeners(event?: string | symbol): void;
+    /**
+     * 获取指定事件的监听器数量
+     */
+    listenerCount(event: string | symbol): number;
+    /**
+     * 获取所有已注册的事件名称
+     */
+    eventNames(): (string | symbol)[];
+    /**
+     * 添加监听器
+     */
+    private addListener;
+    /**
+     * 解析事件名称（添加全局前缀）
+     */
+    private resolveEventName;
+    /**
+     * 获取匹配的监听器（支持通配符）
+     */
+    private getMatchedListeners;
+    /**
+     * 匹配通配符模式
+     */
+    private matchWildcard;
+    /**
+     * 按优先级排序监听器
+     */
+    private sortListenersByPriority;
+    /**
+     * 处理错误
+     */
+    private handleError;
+}
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/events/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,eAAe,EAEhB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD;;OAEG;IACH,OAAO,CAAC,SAAS,CAAyD;IAE1E;;OAEG;IACH,OAAO,CAAC,OAAO,CAAqB;IAEpC;;;OAGG;gBACgB,OAAO,GAAE,kBAAuB;IASnD;;OAEG;IACI,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI;IA+BxD;;OAEG;IACU,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C5E;;OAEG;IACI,EAAE,CAAC,CAAC,EACT,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,GAAE,eAAoB,GAC5B,MAAM,IAAI;IAKb;;OAEG;IACI,IAAI,CAAC,CAAC,EACX,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,GAAE,eAAoB,GAC5B,MAAM,IAAI;IAKb;;OAEG;IACI,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAmBvE;;OAEG;IACI,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASxD;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAMpD;;OAEG;IACI,UAAU,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE;IAIxC;;OAEG;IACH,OAAO,CAAC,WAAW;IAuCnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;OAEG;IACH,OAAO,CAAC,aAAa;IA4CrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAM/B;;OAEG;IACH,OAAO,CAAC,WAAW;CAcpB"}