@hestjs/cqrs 0.1.0

package/README.md

@@ -0,0 +1,234 @@
+# @hestjs/cqrs
+
+HestJS CQRS - Command Query Responsibility Segregation module for HestJS
+
+## 安装
+
+```bash
+npm install @hestjs/cqrs
+```
+
+## 基本用法
+
+### 1. 初始化CQRS模块
+
+```typescript
+import { CqrsModule } from "@hestjs/cqrs";
+
+// 基本初始化
+CqrsModule.forRoot();
+
+// 或者使用选项
+CqrsModule.forRoot({
+  // 自定义配置
+});
+```
+
+### 2. 创建Command
+
+```typescript
+import { Command } from "@hestjs/cqrs";
+
+export class CreateUserCommand extends Command<string> {
+  constructor(
+    public readonly name: string,
+    public readonly email: string
+  ) {
+    super();
+  }
+}
+```
+
+### 3. 创建Command Handler
+
+```typescript
+import { CommandHandler, ICommandHandler } from "@hestjs/cqrs";
+import { CreateUserCommand } from "./create-user.command";
+
+@CommandHandler(CreateUserCommand)
+export class CreateUserHandler
+  implements ICommandHandler<CreateUserCommand, string>
+{
+  async execute(command: CreateUserCommand): Promise<string> {
+    // 处理命令逻辑
+    console.log(`Creating user: ${command.name} (${command.email})`);
+    return "user-id-123";
+  }
+}
+```
+
+### 4. 创建Query
+
+```typescript
+import { Query, IQueryResult } from "@hestjs/cqrs";
+
+export class GetUserQuery extends Query<GetUserResult> {
+  constructor(public readonly userId: string) {
+    super();
+  }
+}
+
+export class GetUserResult implements IQueryResult {
+  constructor(
+    public readonly id: string,
+    public readonly name: string,
+    public readonly email: string
+  ) {}
+}
+```
+
+### 5. 创建Query Handler
+
+```typescript
+import { QueryHandler, IQueryHandler } from "@hestjs/cqrs";
+import { GetUserQuery, GetUserResult } from "./get-user.query";
+
+@QueryHandler(GetUserQuery)
+export class GetUserHandler
+  implements IQueryHandler<GetUserQuery, GetUserResult>
+{
+  async execute(query: GetUserQuery): Promise<GetUserResult> {
+    // 查询逻辑
+    return new GetUserResult(query.userId, "John Doe", "john@example.com");
+  }
+}
+```
+
+### 6. 创建Event
+
+```typescript
+import { Event } from "@hestjs/cqrs";
+
+export class UserCreatedEvent extends Event {
+  constructor(
+    public readonly userId: string,
+    public readonly name: string,
+    public readonly email: string
+  ) {
+    super(userId);
+  }
+}
+```
+
+### 7. 创建Event Handler
+
+```typescript
+import { EventsHandler, IEventHandler } from "@hestjs/cqrs";
+import { UserCreatedEvent } from "./user-created.event";
+
+@EventsHandler(UserCreatedEvent)
+export class UserCreatedHandler implements IEventHandler<UserCreatedEvent> {
+  async handle(event: UserCreatedEvent): Promise<void> {
+    // 处理事件逻辑
+    console.log(`User created: ${event.name} (${event.email})`);
+  }
+}
+```
+
+### 8. 在控制器中使用
+
+```typescript
+import { Controller, Post } from "@hestjs/core";
+import { CommandBus, QueryBus, EventBus } from "@hestjs/cqrs";
+import { CreateUserCommand } from "./commands/create-user.command";
+import { GetUserQuery } from "./queries/get-user.query";
+import { UserCreatedEvent } from "./events/user-created.event";
+
+@Controller("/users")
+export class UserController {
+  constructor(
+    private readonly commandBus: CommandBus,
+    private readonly queryBus: QueryBus,
+    private readonly eventBus: EventBus
+  ) {}
+
+  @Post()
+  async createUser(data: { name: string; email: string }) {
+    const command = new CreateUserCommand(data.name, data.email);
+    const userId = await this.commandBus.execute(command);
+
+    // 发布事件
+    const event = new UserCreatedEvent(userId, data.name, data.email);
+    await this.eventBus.publish(event);
+
+    return { userId };
+  }
+
+  @Get("/:id")
+  async getUser(id: string) {
+    const query = new GetUserQuery(id);
+    return await this.queryBus.execute(query);
+  }
+}
+```
+
+### 9. 注册处理器
+
+```typescript
+import { CqrsModule } from "@hestjs/cqrs";
+import { CreateUserHandler } from "./handlers/create-user.handler";
+import { GetUserHandler } from "./handlers/get-user.handler";
+import { UserCreatedHandler } from "./handlers/user-created.handler";
+
+// 初始化CQRS模块
+CqrsModule.forRoot();
+
+// 获取CQRS模块实例
+const cqrsModule = CqrsModule.getInstance();
+
+// 注册处理器
+cqrsModule.registerHandler(CreateUserHandler);
+cqrsModule.registerHandler(GetUserHandler);
+cqrsModule.registerHandler(UserCreatedHandler);
+
+// 启动应用时调用
+await cqrsModule.onApplicationBootstrap();
+```
+
+### 10. Saga (长期运行的流程)
+
+```typescript
+import { Saga, ICommand } from "@hestjs/cqrs";
+import { UserCreatedEvent } from "./events/user-created.event";
+import { SendWelcomeEmailCommand } from "./commands/send-welcome-email.command";
+
+@Saga()
+export class UserSaga {
+  // 当用户创建事件发生时，发送欢迎邮件
+  async onUserCreatedEvent(event: UserCreatedEvent): Promise<ICommand[]> {
+    return [new SendWelcomeEmailCommand(event.userId, event.email)];
+  }
+}
+```
+
+## API 参考
+
+### 装饰器
+
+- `@CommandHandler(command)` - 标记命令处理器
+- `@QueryHandler(query)` - 标记查询处理器
+- `@EventsHandler(...events)` - 标记事件处理器
+- `@Saga()` - 标记Saga
+
+### 基类
+
+- `Command<T>` - 命令基类，T为返回类型
+- `Query<T>` - 查询基类，T为结果类型
+- `Event` - 事件基类
+
+### 总线
+
+- `CommandBus` - 命令总线
+- `QueryBus` - 查询总线
+- `EventBus` - 事件总线
+
+### 接口
+
+- `ICommandHandler<TCommand, TResult>` - 命令处理器接口
+- `IQueryHandler<TQuery, TResult>` - 查询处理器接口
+- `IEventHandler<TEvent>` - 事件处理器接口
+- `ISaga<TEvent>` - Saga接口
+
+## 许可证
+
+MIT

package/dist/classes/command.d.ts

@@ -0,0 +1,13 @@
+import { RESULT_TYPE_SYMBOL } from "../constants";
+import { ICommand } from "../interfaces";
+/**
+ * Utility type to extract the result type of a command.
+ */
+export type CommandResult<C extends Command<unknown>> = C extends Command<infer R> ? R : never;
+/**
+ * Base command class with typed result
+ */
+export declare class Command<T> implements ICommand {
+    readonly [RESULT_TYPE_SYMBOL]?: T;
+}
+//# sourceMappingURL=command.d.ts.map

package/dist/classes/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/classes/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,IAClD,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEzC;;GAEG;AACH,qBAAa,OAAO,CAAC,CAAC,CAAE,YAAW,QAAQ;IACzC,QAAQ,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;CACnC"}

package/dist/classes/command.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Command = void 0;
+const constants_1 = require("../constants");
+/**
+ * Base command class with typed result
+ */
+class Command {
+}
+exports.Command = Command;
+//# sourceMappingURL=command.js.map

package/dist/classes/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/classes/command.ts"],"names":[],"mappings":";;;AAAA,4CAAkD;AASlD;;GAEG;AACH,MAAa,OAAO;CAEnB;AAFD,0BAEC"}

package/dist/classes/event.d.ts

@@ -0,0 +1,10 @@
+import { IEvent } from "../interfaces";
+/**
+ * Base event class
+ */
+export declare class Event implements IEvent {
+    readonly aggregateId?: string;
+    readonly version?: number;
+    constructor(aggregateId?: string, version?: number);
+}
+//# sourceMappingURL=event.d.ts.map

package/dist/classes/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/classes/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC;;GAEG;AACH,qBAAa,KAAM,YAAW,MAAM;IAClC,SAAgB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAErB,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAInD"}

package/dist/classes/event.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Event = void 0;
+/**
+ * Base event class
+ */
+class Event {
+    constructor(aggregateId, version) {
+        this.aggregateId = aggregateId;
+        this.version = version;
+    }
+}
+exports.Event = Event;
+//# sourceMappingURL=event.js.map

package/dist/classes/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/classes/event.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAa,KAAK;IAIhB,YAAY,WAAoB,EAAE,OAAgB;QAChD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AARD,sBAQC"}

package/dist/classes/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./command";
+export * from "./event";
+export * from "./query";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/classes/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./command"), exports);
+__exportStar(require("./event"), exports);
+__exportStar(require("./query"), exports);
+//# sourceMappingURL=index.js.map

package/dist/classes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB"}

package/dist/classes/query.d.ts

@@ -0,0 +1,13 @@
+import { RESULT_TYPE_SYMBOL } from "../constants";
+import { IQuery, IQueryResult } from "../interfaces";
+/**
+ * Utility type to extract the result type of a query.
+ */
+export type QueryResult<Q extends Query<IQueryResult>> = Q extends Query<infer R> ? R : never;
+/**
+ * Base query class with typed result
+ */
+export declare class Query<T extends IQueryResult> implements IQuery {
+    readonly [RESULT_TYPE_SYMBOL]?: T;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/classes/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/classes/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,KAAK,CAAC,YAAY,CAAC,IACnD,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEvC;;GAEG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,YAAY,CAAE,YAAW,MAAM;IAC1D,QAAQ,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;CACnC"}

package/dist/classes/query.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Query = void 0;
+const constants_1 = require("../constants");
+/**
+ * Base query class with typed result
+ */
+class Query {
+}
+exports.Query = Query;
+//# sourceMappingURL=query.js.map

package/dist/classes/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/classes/query.ts"],"names":[],"mappings":";;;AAAA,4CAAkD;AASlD;;GAEG;AACH,MAAa,KAAK;CAEjB;AAFD,sBAEC"}

package/dist/command-bus.d.ts

@@ -0,0 +1,30 @@
+import "reflect-metadata";
+import { Command } from "./classes";
+import { CommandHandlerType, ICommand, ICommandBus, ICommandPublisher } from "./interfaces";
+import { ObservableBus } from "./utils";
+export declare class CommandBus<CommandBase extends ICommand = ICommand> extends ObservableBus<CommandBase> implements ICommandBus<CommandBase> {
+    private handlers;
+    private _publisher;
+    constructor();
+    /**
+     * Returns the publisher.
+     */
+    get publisher(): ICommandPublisher<CommandBase>;
+    /**
+     * Sets the publisher.
+     */
+    set publisher(_publisher: ICommandPublisher<CommandBase>);
+    /**
+     * Executes a command.
+     */
+    execute<R = void>(command: Command<R>): Promise<R>;
+    execute<T extends CommandBase, R = any>(command: T): Promise<R>;
+    /**
+     * Registers command handlers.
+     */
+    register(handlers: CommandHandlerType<CommandBase>[]): void;
+    private registerHandler;
+    private useDefaultPublisher;
+    private getCommandName;
+}
+//# sourceMappingURL=command-bus.d.ts.map

package/dist/command-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bus.d.ts","sourceRoot":"","sources":["../src/command-bus.ts"],"names":[],"mappings":"AACA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,WAAW,EAEX,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,qBACa,UAAU,CAAC,WAAW,SAAS,QAAQ,GAAG,QAAQ,CAC7D,SAAQ,aAAa,CAAC,WAAW,CACjC,YAAW,WAAW,CAAC,WAAW,CAAC;IAEnC,OAAO,CAAC,QAAQ,CAA6D;IAC7E,OAAO,CAAC,UAAU,CAAkC;;IAOpD;;OAEG;IACH,IAAI,SAAS,IAAI,iBAAiB,CAAC,WAAW,CAAC,CAE9C;IAED;;OAEG;IACH,IAAI,SAAS,CAAC,UAAU,EAAE,iBAAiB,CAAC,WAAW,CAAC,EAEvD;IAED;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoBrE;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC,WAAW,CAAC,EAAE,GAAG,IAAI;IAI3D,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,cAAc;CAIvB"}

package/dist/command-bus.js

@@ -0,0 +1,88 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandBus = void 0;
+const core_1 = require("@hestjs/core");
+require("reflect-metadata");
+const tsyringe_1 = require("tsyringe");
+const constants_1 = require("./constants");
+const exceptions_1 = require("./exceptions");
+const helpers_1 = require("./helpers");
+const utils_1 = require("./utils");
+let CommandBus = class CommandBus extends utils_1.ObservableBus {
+    constructor() {
+        super();
+        this.handlers = new Map();
+        this.useDefaultPublisher();
+    }
+    /**
+     * Returns the publisher.
+     */
+    get publisher() {
+        return this._publisher;
+    }
+    /**
+     * Sets the publisher.
+     */
+    set publisher(_publisher) {
+        this._publisher = _publisher;
+    }
+    async execute(command) {
+        const commandName = this.getCommandName(command);
+        const handler = this.handlers.get(commandName);
+        if (!handler) {
+            core_1.logger.error(`Command handler for "${commandName}" not found`);
+            throw new exceptions_1.CommandHandlerNotFoundException(commandName);
+        }
+        this.publishToSubject(command);
+        try {
+            return await handler(command);
+        }
+        catch (error) {
+            core_1.logger.error(`Error executing command "${commandName}":`, String(error));
+            throw error;
+        }
+    }
+    /**
+     * Registers command handlers.
+     */
+    register(handlers) {
+        handlers.forEach((handler) => this.registerHandler(handler));
+    }
+    registerHandler(handler) {
+        const target = handler;
+        const commandType = Reflect.getMetadata(constants_1.COMMAND_HANDLER_METADATA, target);
+        if (!commandType) {
+            throw new exceptions_1.InvalidCommandHandlerException(`Missing @CommandHandler decorator on ${target.name}`);
+        }
+        const commandName = this.getCommandName(commandType);
+        if (this.handlers.has(commandName)) {
+            core_1.logger.warn(`Command handler for "${commandName}" already registered. Overwriting.`);
+        }
+        // Get handler instance from container
+        const handlerInstance = tsyringe_1.container.resolve(target);
+        this.handlers.set(commandName, (command) => handlerInstance.execute(command));
+        core_1.logger.info(`Registered command handler for "${commandName}"`);
+    }
+    useDefaultPublisher() {
+        this._publisher = new helpers_1.DefaultCommandPubSub();
+    }
+    getCommandName(command) {
+        const { constructor } = Object.getPrototypeOf(command);
+        return constructor.name;
+    }
+};
+exports.CommandBus = CommandBus;
+exports.CommandBus = CommandBus = __decorate([
+    (0, core_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], CommandBus);
+//# sourceMappingURL=command-bus.js.map

package/dist/command-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bus.js","sourceRoot":"","sources":["../src/command-bus.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,uCAAkD;AAClD,4BAA0B;AAC1B,uCAAqC;AAErC,2CAAuD;AACvD,6CAGsB;AACtB,uCAAiD;AAQjD,mCAAwC;AAGjC,IAAM,UAAU,GAAhB,MAAM,UACX,SAAQ,qBAA0B;IAMlC;QACE,KAAK,EAAE,CAAC;QAJF,aAAQ,GAAG,IAAI,GAAG,EAAkD,CAAC;QAK3E,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,SAAS,CAAC,UAA0C;QACtD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAOD,KAAK,CAAC,OAAO,CAAiC,OAAU;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,aAAM,CAAC,KAAK,CAAC,wBAAwB,WAAW,aAAa,CAAC,CAAC;YAC/D,MAAM,IAAI,4CAA+B,CAAC,WAAW,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE/B,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,aAAM,CAAC,KAAK,CAAC,4BAA4B,WAAW,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACzE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAA2C;QAClD,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAEO,eAAe,CAAC,OAAwC;QAC9D,MAAM,MAAM,GAAG,OAAO,CAAC;QACvB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,oCAAwB,EAAE,MAAM,CAAC,CAAC;QAE1E,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,2CAA8B,CACtC,wCAAwC,MAAM,CAAC,IAAI,EAAE,CACtD,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAErD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,aAAM,CAAC,IAAI,CACT,wBAAwB,WAAW,oCAAoC,CACxE,CAAC;QACJ,CAAC;QAED,sCAAsC;QACtC,MAAM,eAAe,GAAG,oBAAS,CAAC,OAAO,CACvC,MAAM,CACyB,CAAC;QAElC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,OAAoB,EAAE,EAAE,CACtD,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CACjC,CAAC;QAEF,aAAM,CAAC,IAAI,CAAC,mCAAmC,WAAW,GAAG,CAAC,CAAC;IACjE,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,8BAAoB,EAAe,CAAC;IAC5D,CAAC;IAEO,cAAc,CAAC,OAAY;QACjC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACvD,OAAO,WAAW,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF,CAAA;AA/FY,gCAAU;qBAAV,UAAU;IADtB,IAAA,iBAAU,GAAE;;GACA,UAAU,CA+FtB"}

package/dist/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const CQRS_MODULE_OPTIONS: unique symbol;
+export declare const COMMAND_HANDLER_METADATA: unique symbol;
+export declare const COMMAND_METADATA: unique symbol;
+export declare const QUERY_HANDLER_METADATA: unique symbol;
+export declare const QUERY_METADATA: unique symbol;
+export declare const EVENT_HANDLER_METADATA: unique symbol;
+export declare const EVENT_METADATA: unique symbol;
+export declare const SAGA_METADATA: unique symbol;
+export declare const RESULT_TYPE_SYMBOL: unique symbol;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAGjE,eAAO,MAAM,wBAAwB,eAAqC,CAAC;AAC3E,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D,eAAO,MAAM,sBAAsB,eAAmC,CAAC;AACvE,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD,eAAO,MAAM,sBAAsB,eAAmC,CAAC;AACvE,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD,eAAO,MAAM,aAAa,eAA0B,CAAC;AAGrD,eAAO,MAAM,kBAAkB,eAA+B,CAAC"}

package/dist/constants.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESULT_TYPE_SYMBOL = exports.SAGA_METADATA = exports.EVENT_METADATA = exports.EVENT_HANDLER_METADATA = exports.QUERY_METADATA = exports.QUERY_HANDLER_METADATA = exports.COMMAND_METADATA = exports.COMMAND_HANDLER_METADATA = exports.CQRS_MODULE_OPTIONS = void 0;
+// CQRS Module constants
+exports.CQRS_MODULE_OPTIONS = Symbol("CQRS_MODULE_OPTIONS");
+// Metadata keys for decorators
+exports.COMMAND_HANDLER_METADATA = Symbol("COMMAND_HANDLER_METADATA");
+exports.COMMAND_METADATA = Symbol("COMMAND_METADATA");
+exports.QUERY_HANDLER_METADATA = Symbol("QUERY_HANDLER_METADATA");
+exports.QUERY_METADATA = Symbol("QUERY_METADATA");
+exports.EVENT_HANDLER_METADATA = Symbol("EVENT_HANDLER_METADATA");
+exports.EVENT_METADATA = Symbol("EVENT_METADATA");
+exports.SAGA_METADATA = Symbol("SAGA_METADATA");
+// Result type symbol for commands and queries
+exports.RESULT_TYPE_SYMBOL = Symbol("RESULT_TYPE_SYMBOL");
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAA,wBAAwB;AACX,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE,+BAA+B;AAClB,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAC9D,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAE9C,QAAA,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAC1D,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAE1C,QAAA,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAC1D,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAE1C,QAAA,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAErD,8CAA8C;AACjC,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/cqrs.module.d.ts

@@ -0,0 +1,50 @@
+import { CommandBus } from "./command-bus";
+import { EventBus } from "./event-bus";
+import { CqrsModuleAsyncOptions, CqrsModuleOptions, IEvent } from "./interfaces";
+import { QueryBus } from "./query-bus";
+import { ExplorerService } from "./services";
+/**
+ * CQRS Module for HestJS
+ * Provides Command Query Responsibility Segregation capabilities
+ */
+export declare class CqrsModule<EventBase extends IEvent = IEvent> {
+    private readonly explorerService;
+    private readonly eventBus;
+    private readonly commandBus;
+    private readonly queryBus;
+    private static isInitialized;
+    constructor(explorerService: ExplorerService<EventBase>, eventBus: EventBus<EventBase>, commandBus: CommandBus, queryBus: QueryBus);
+    /**
+     * Configure CQRS module with options
+     */
+    static forRoot(options?: CqrsModuleOptions): typeof CqrsModule;
+    /**
+     * Configure CQRS module with async options
+     */
+    static forRootAsync(options: CqrsModuleAsyncOptions): typeof CqrsModule;
+    /**
+     * Initialize the CQRS module and register all handlers
+     */
+    onApplicationBootstrap(): Promise<void>;
+    /**
+     * Get the command bus instance
+     */
+    getCommandBus(): CommandBus;
+    /**
+     * Get the query bus instance
+     */
+    getQueryBus(): QueryBus;
+    /**
+     * Get the event bus instance
+     */
+    getEventBus(): EventBus<EventBase>;
+    /**
+     * Register a handler manually
+     */
+    registerHandler(handlerClass: Function): void;
+    /**
+     * Get a singleton instance of the CQRS module
+     */
+    static getInstance<EventBase extends IEvent = IEvent>(): CqrsModule<EventBase>;
+}
+//# sourceMappingURL=cqrs.module.d.ts.map

package/dist/cqrs.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cqrs.module.d.ts","sourceRoot":"","sources":["../src/cqrs.module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EAEjB,MAAM,EACP,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,qBACa,UAAU,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAIrD,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,MAAM,CAAC,aAAa,CAAS;gBAGlB,eAAe,EAAE,eAAe,CAAC,SAAS,CAAC,EAC3C,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC7B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ;IAGrC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,UAAU;IAuB9D;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,UAAU;IAwCvE;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAY7C;;OAEG;IACH,aAAa,IAAI,UAAU;IAI3B;;OAEG;IACH,WAAW,IAAI,QAAQ;IAIvB;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,SAAS,CAAC;IAIlC;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,QAAQ,GAAG,IAAI;IAI7C;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,SAAS,SAAS,MAAM,GAAG,MAAM,KAC9B,UAAU,CAAC,SAAS,CAAC;CAoB3B"}