@rolandsall24/nest-mediator 0.0.1

package/dist/lib/decorators/command-handler.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/command-handler.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,QAAQ,KAAG,cAE1E,CAAC"}

package/dist/lib/decorators/command-handler.decorator.js

@@ -0,0 +1,20 @@
+import { SetMetadata } from '@nestjs/common';
+export const COMMAND_HANDLER_METADATA = 'COMMAND_HANDLER_METADATA';
+/**
+ * Decorator to mark a class as a command handler
+ * @param command - The command class that this handler handles
+ * @returns Class decorator
+ *
+ * @example
+ * ```typescript
+ * @CommandHandler(AddCategoryCommand)
+ * export class AddCategoryCommandHandler implements ICommandHandler<AddCategoryCommand> {
+ *   async execute(command: AddCategoryCommand): Promise<Category> {
+ *     // Implementation
+ *   }
+ * }
+ * ```
+ */
+export const CommandHandler = (command) => {
+    return SetMetadata(COMMAND_HANDLER_METADATA, command);
+};

package/dist/lib/decorators/index.d.ts

@@ -0,0 +1,3 @@
+export * from './command-handler.decorator.js';
+export * from './query-handler.decorator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC"}

package/dist/lib/decorators/index.js

@@ -0,0 +1,2 @@
+export * from './command-handler.decorator.js';
+export * from './query-handler.decorator.js';

package/dist/lib/decorators/query-handler.decorator.d.ts

@@ -0,0 +1,19 @@
+import { IQuery } from '../interfaces/index.js';
+export declare const QUERY_HANDLER_METADATA = "QUERY_HANDLER_METADATA";
+/**
+ * Decorator to mark a class as a query handler
+ * @param query - The query class that this handler handles
+ * @returns Class decorator
+ *
+ * @example
+ * ```typescript
+ * @QueryHandler(GetCategoryQuery)
+ * export class GetCategoryQueryHandler implements IQueryHandler<GetCategoryQuery, Category> {
+ *   async execute(query: GetCategoryQuery): Promise<Category> {
+ *     // Implementation
+ *   }
+ * }
+ * ```
+ */
+export declare const QueryHandler: (query: new (...args: any[]) => IQuery) => ClassDecorator;
+//# sourceMappingURL=query-handler.decorator.d.ts.map

package/dist/lib/decorators/query-handler.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-handler.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/query-handler.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,KAAG,cAEpE,CAAC"}

package/dist/lib/decorators/query-handler.decorator.js

@@ -0,0 +1,20 @@
+import { SetMetadata } from '@nestjs/common';
+export const QUERY_HANDLER_METADATA = 'QUERY_HANDLER_METADATA';
+/**
+ * Decorator to mark a class as a query handler
+ * @param query - The query class that this handler handles
+ * @returns Class decorator
+ *
+ * @example
+ * ```typescript
+ * @QueryHandler(GetCategoryQuery)
+ * export class GetCategoryQueryHandler implements IQueryHandler<GetCategoryQuery, Category> {
+ *   async execute(query: GetCategoryQuery): Promise<Category> {
+ *     // Implementation
+ *   }
+ * }
+ * ```
+ */
+export const QueryHandler = (query) => {
+    return SetMetadata(QUERY_HANDLER_METADATA, query);
+};

package/dist/lib/interfaces/command-handler.interface.d.ts

@@ -0,0 +1,14 @@
+import { ICommand } from './command.interface.js';
+/**
+ * Interface for command handlers
+ * @template TCommand - The command type that extends ICommand
+ */
+export interface ICommandHandler<TCommand extends ICommand> {
+    /**
+     * Execute the command
+     * @param command - The command to execute
+     * @returns Promise<void>
+     */
+    execute(command: TCommand): Promise<void>;
+}
+//# sourceMappingURL=command-handler.interface.d.ts.map

package/dist/lib/interfaces/command-handler.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/command-handler.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,SAAS,QAAQ;IACxD;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/dist/lib/interfaces/command-handler.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/interfaces/command.interface.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Marker interface for commands
+ * All commands should implement this interface
+ */
+export interface ICommand {
+}
+//# sourceMappingURL=command.interface.d.ts.map

package/dist/lib/interfaces/command.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/command.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,QAAQ;CAAG"}

package/dist/lib/interfaces/command.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/interfaces/index.d.ts

@@ -0,0 +1,5 @@
+export * from './command.interface.js';
+export * from './query.interface.js';
+export * from './command-handler.interface.js';
+export * from './query-handler.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC"}

package/dist/lib/interfaces/index.js

@@ -0,0 +1,4 @@
+export * from './command.interface.js';
+export * from './query.interface.js';
+export * from './command-handler.interface.js';
+export * from './query-handler.interface.js';

package/dist/lib/interfaces/query-handler.interface.d.ts

@@ -0,0 +1,15 @@
+import { IQuery } from './query.interface.js';
+/**
+ * Interface for query handlers
+ * @template TQuery - The query type that extends IQuery
+ * @template TResult - The result type (default: any)
+ */
+export interface IQueryHandler<TQuery extends IQuery, TResult = any> {
+    /**
+     * Execute the query
+     * @param query - The query to execute
+     * @returns Promise with the result
+     */
+    execute(query: TQuery): Promise<TResult>;
+}
+//# sourceMappingURL=query-handler.interface.d.ts.map

package/dist/lib/interfaces/query-handler.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-handler.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/query-handler.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,MAAM,EAAE,OAAO,GAAG,GAAG;IACjE;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C"}

package/dist/lib/interfaces/query-handler.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/interfaces/query.interface.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Marker interface for queries
+ * All queries should implement this interface
+ */
+export interface IQuery {
+}
+//# sourceMappingURL=query.interface.d.ts.map

package/dist/lib/interfaces/query.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/query.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,MAAM;CAAG"}

package/dist/lib/interfaces/query.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/nest-mediator.d.ts

@@ -0,0 +1,2 @@
+export declare function nestMediator(): string;
+//# sourceMappingURL=nest-mediator.d.ts.map

package/dist/lib/nest-mediator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-mediator.d.ts","sourceRoot":"","sources":["../../src/lib/nest-mediator.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/lib/nest-mediator.js

@@ -0,0 +1,3 @@
+export function nestMediator() {
+    return 'nest-mediator';
+}

package/dist/lib/nest-mediator.module.d.ts

@@ -0,0 +1,21 @@
+import { DynamicModule, Type, OnModuleInit } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { MediatorService } from './services/index.js';
+import { ICommandHandler, IQueryHandler } from './interfaces/index.js';
+export interface NestMediatorModuleOptions {
+    handlers?: Type<ICommandHandler<any> | IQueryHandler<any, any>>[];
+}
+export declare class NestMediatorModule implements OnModuleInit {
+    private readonly mediatorService;
+    private readonly reflector;
+    private readonly handlers;
+    constructor(mediatorService: MediatorService, reflector: Reflector, handlers: Type<ICommandHandler<any> | IQueryHandler<any, any>>[]);
+    onModuleInit(): void;
+    /**
+     * Register the NestMediator module with handlers
+     * @param options - Module options containing handlers to register
+     * @returns Dynamic module
+     */
+    static forRoot(options?: NestMediatorModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=nest-mediator.module.d.ts.map

package/dist/lib/nest-mediator.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-mediator.module.d.ts","sourceRoot":"","sources":["../../src/lib/nest-mediator.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,IAAI,EAAE,YAAY,EAAU,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAY,eAAe,EAAU,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEzF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;CACnE;AAED,qBACa,kBAAmB,YAAW,YAAY;IAEjD,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAHR,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,SAAS,EAEpB,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE;IAGrF,YAAY;IAoCZ;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,yBAA8B,GAAG,aAAa;CAgBvE"}

package/dist/lib/nest-mediator.module.js

@@ -0,0 +1,58 @@
+var NestMediatorModule_1;
+import { __decorate, __metadata, __param } from "tslib";
+import { Module, Inject } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { MediatorService } from './services/index.js';
+import { COMMAND_HANDLER_METADATA, QUERY_HANDLER_METADATA } from './decorators/index.js';
+let NestMediatorModule = NestMediatorModule_1 = class NestMediatorModule {
+    mediatorService;
+    reflector;
+    handlers;
+    constructor(mediatorService, reflector, handlers) {
+        this.mediatorService = mediatorService;
+        this.reflector = reflector;
+        this.handlers = handlers;
+    }
+    onModuleInit() {
+        console.log(`[NestMediator] Registering ${this.handlers.length} handlers...`);
+        this.handlers.forEach((handlerType) => {
+            const commandMetadata = this.reflector.get(COMMAND_HANDLER_METADATA, handlerType);
+            if (commandMetadata) {
+                console.log(`[NestMediator] Registering command handler: ${handlerType.name} for command: ${commandMetadata.name}`);
+                this.mediatorService.registerCommandHandler(commandMetadata, handlerType);
+            }
+            const queryMetadata = this.reflector.get(QUERY_HANDLER_METADATA, handlerType);
+            if (queryMetadata) {
+                console.log(`[NestMediator] Registering query handler: ${handlerType.name} for query: ${queryMetadata.name}`);
+                this.mediatorService.registerQueryHandler(queryMetadata, handlerType);
+            }
+        });
+    }
+    /**
+     * Register the NestMediator module with handlers
+     * @param options - Module options containing handlers to register
+     * @returns Dynamic module
+     */
+    static forRoot(options = {}) {
+        const handlers = options.handlers || [];
+        return {
+            module: NestMediatorModule_1,
+            providers: [
+                MediatorService,
+                {
+                    provide: 'HANDLERS_CONFIG',
+                    useValue: handlers,
+                },
+            ],
+            exports: [MediatorService],
+            global: true,
+        };
+    }
+};
+NestMediatorModule = NestMediatorModule_1 = __decorate([
+    Module({}),
+    __param(2, Inject('HANDLERS_CONFIG')),
+    __metadata("design:paramtypes", [MediatorService,
+        Reflector, Array])
+], NestMediatorModule);
+export { NestMediatorModule };

package/dist/lib/services/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mediator.service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/lib/services/index.js

@@ -0,0 +1 @@
+export * from './mediator.service.js';

package/dist/lib/services/mediator.service.d.ts

@@ -0,0 +1,34 @@
+import { Type } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { ICommand, ICommandHandler, IQuery, IQueryHandler } from '../interfaces/index.js';
+export declare class MediatorService {
+    private readonly moduleRef;
+    private commandHandlers;
+    private queryHandlers;
+    constructor(moduleRef: ModuleRef);
+    /**
+     * Register a command handler
+     * @param command - The command class
+     * @param handler - The handler class
+     */
+    registerCommandHandler(command: Type<ICommand>, handler: Type<ICommandHandler<any>>): void;
+    /**
+     * Register a query handler
+     * @param query - The query class
+     * @param handler - The handler class
+     */
+    registerQueryHandler(query: Type<IQuery>, handler: Type<IQueryHandler<any, any>>): void;
+    /**
+     * Send a command to its handler
+     * @param command - The command instance
+     * @returns Promise<void>
+     */
+    send<TCommand extends ICommand>(command: TCommand): Promise<void>;
+    /**
+     * Execute a query through its handler
+     * @param query - The query instance
+     * @returns Promise with the result
+     */
+    query<TQuery extends IQuery, TResult = any>(query: TQuery): Promise<TResult>;
+}
+//# sourceMappingURL=mediator.service.d.ts.map

package/dist/lib/services/mediator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediator.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/mediator.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE1F,qBACa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,OAAO,CAAC,eAAe,CAAiD;IACxE,OAAO,CAAC,aAAa,CAAoD;gBAE5C,SAAS,EAAE,SAAS;IAEjD;;;;OAIG;IACH,sBAAsB,CACpB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,EACvB,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAClC,IAAI;IAQP;;;;OAIG;IACH,oBAAoB,CAClB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EACnB,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GACrC,IAAI;IAQP;;;;OAIG;IACG,IAAI,CAAC,QAAQ,SAAS,QAAQ,EAClC,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;OAIG;IACG,KAAK,CAAC,MAAM,SAAS,MAAM,EAAE,OAAO,GAAG,GAAG,EAC9C,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;CAiBpB"}

package/dist/lib/services/mediator.service.js

@@ -0,0 +1,68 @@
+import { __decorate, __metadata } from "tslib";
+import { Injectable } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+let MediatorService = class MediatorService {
+    moduleRef;
+    commandHandlers = new Map();
+    queryHandlers = new Map();
+    constructor(moduleRef) {
+        this.moduleRef = moduleRef;
+    }
+    /**
+     * Register a command handler
+     * @param command - The command class
+     * @param handler - The handler class
+     */
+    registerCommandHandler(command, handler) {
+        const commandName = command.name;
+        if (this.commandHandlers.has(commandName)) {
+            throw new Error(`Command handler for ${commandName} is already registered`);
+        }
+        this.commandHandlers.set(commandName, handler);
+    }
+    /**
+     * Register a query handler
+     * @param query - The query class
+     * @param handler - The handler class
+     */
+    registerQueryHandler(query, handler) {
+        const queryName = query.name;
+        if (this.queryHandlers.has(queryName)) {
+            throw new Error(`Query handler for ${queryName} is already registered`);
+        }
+        this.queryHandlers.set(queryName, handler);
+    }
+    /**
+     * Send a command to its handler
+     * @param command - The command instance
+     * @returns Promise<void>
+     */
+    async send(command) {
+        const commandName = command.constructor.name;
+        const handlerType = this.commandHandlers.get(commandName);
+        if (!handlerType) {
+            throw new Error(`No handler registered for command: ${commandName}. Did you forget to add @CommandHandler decorator?`);
+        }
+        const handler = this.moduleRef.get(handlerType, { strict: false });
+        await handler.execute(command);
+    }
+    /**
+     * Execute a query through its handler
+     * @param query - The query instance
+     * @returns Promise with the result
+     */
+    async query(query) {
+        const queryName = query.constructor.name;
+        const handlerType = this.queryHandlers.get(queryName);
+        if (!handlerType) {
+            throw new Error(`No handler registered for query: ${queryName}. Did you forget to add @QueryHandler decorator?`);
+        }
+        const handler = this.moduleRef.get(handlerType, { strict: false });
+        return handler.execute(query);
+    }
+};
+MediatorService = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [ModuleRef])
+], MediatorService);
+export { MediatorService };