@flusys/nestjs-event-manager 6.4.0 → 7.0.0-beta.1

package/cjs/config/event-actions.js

@@ -0,0 +1,27 @@
+/**
+ * Domain event actions published by the event manager module, alongside the CRUD
+ * lifecycle actions every ApiService emits.
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get EVENT_MANAGER_EVENT_ACTIONS () {
+        return EVENT_MANAGER_EVENT_ACTIONS;
+    },
+    get EVENT_MANAGER_EVENT_ENTITIES () {
+        return EVENT_MANAGER_EVENT_ENTITIES;
+    }
+});
+const EVENT_MANAGER_EVENT_ACTIONS = {
+    PARTICIPANT_STATUS_CHANGED: 'participant-status-changed'
+};
+const EVENT_MANAGER_EVENT_ENTITIES = {
+    EVENT: 'event'
+};

package/cjs/config/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
+_export_star(require("./event-actions"), exports);
 _export_star(require("./event-manager.constants"), exports);
 _export_star(require("./message-keys"), exports);
 function _export_star(from, to) {

package/cjs/modules/event-manager.module.js

@@ -88,6 +88,7 @@ let EventManagerModule = class EventManagerModule {
                 useValue: options
             });
         }
+        providers.push((0, _modules.createModuleEventsProvider)('event-manager', _eventmanagerconstants.EVENT_MANAGER_MODULE_OPTIONS));
         return providers;
     }
     static createAsyncProviders(options) {

package/cjs/services/event.service.js

@@ -176,7 +176,7 @@ let EventService = class EventService extends _classes.ApiService {
         }
         return this.expandRecurringEvents(events, queryDto.startDate, queryDto.endDate);
     }
-    async updateParticipantStatus(dto, _user) {
+    async updateParticipantStatus(dto, user) {
         const participantRepo = await this.ensureParticipantRepositoryInitialized();
         const participant = await participantRepo.findOne({
             where: {
@@ -190,7 +190,27 @@ let EventService = class EventService extends _classes.ApiService {
             });
         }
         participant.status = dto.status;
-        return participantRepo.save(participant);
+        const saved = await participantRepo.save(participant);
+        await Promise.all([
+            this.clearCacheForAll(),
+            this.clearCacheForId([
+                {
+                    id: participant.eventId
+                }
+            ])
+        ]);
+        await this.publishDomainAction(_config.EVENT_MANAGER_EVENT_ACTIONS.PARTICIPANT_STATUS_CHANGED, {
+            ids: [
+                participant.eventId
+            ],
+            metadata: {
+                participantId: saved.id,
+                participantUserId: saved.userId,
+                status: saved.status
+            },
+            user
+        });
+        return saved;
     }
     // Private business logic helpers
     async addCreatorAndParticipants(eventId, participantIds, user) {

package/cjs/services/event.service.spec.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", {
     value: true
 });
 const _common = require("@nestjs/common");
+const _classes = require("@flusys/nestjs-shared/classes");
 const _enums = require("@flusys/nestjs-shared/enums");
 const _repositorymock = require("@test-utils/mocks/repository.mock");
 const _loggedusermock = require("@test-utils/mocks/logged-user.mock");
@@ -50,6 +51,15 @@ function buildParticipant(overrides = {}) {
     };
 }
 describe('EventService', ()=>{
+    const mockUtilsService = {
+        clearCache: jest.fn(),
+        getCacheKey: jest.fn().mockReturnValue('cache-key'),
+        trackCacheKey: jest.fn()
+    };
+    // Call history is shared across tests in this file; reset it so each cache assertion is exact.
+    beforeEach(()=>{
+        mockUtilsService.clearCache.mockClear();
+    });
     let service;
     let mockEventRepo;
     let mockParticipantRepo;
@@ -72,7 +82,7 @@ describe('EventService', ()=>{
             getRepository: jest.fn((entity)=>Promise.resolve(entity === _entities.EventParticipant ? mockParticipantRepo : mockEventRepo)),
             getDataSource: jest.fn()
         };
-        service = new _eventservice.EventService({}, {}, mockConfigService, mockDataSourceProvider);
+        service = new _eventservice.EventService({}, mockUtilsService, mockConfigService, mockDataSourceProvider);
     });
     describe('resolveEntity', ()=>{
         it('resolves to the company-scoped entity when the company feature is enabled', ()=>{
@@ -361,6 +371,19 @@ describe('EventService', ()=>{
                 status: _enums.ParticipantStatus.TENTATIVE
             }));
         });
+        it('invalidates the event list cache and the parent event entry', async ()=>{
+            const participant = buildParticipant({
+                status: _enums.ParticipantStatus.PENDING
+            });
+            mockParticipantRepo.findOne.mockResolvedValue(participant);
+            mockParticipantRepo.save.mockImplementation(async (p)=>p);
+            await service.updateParticipantStatus({
+                id: participant.id,
+                status: _enums.ParticipantStatus.ACCEPTED
+            }, user);
+            expect(mockUtilsService.clearCache).toHaveBeenCalledWith('event', expect.anything());
+            expect(mockUtilsService.clearCache).toHaveBeenCalledWith('event', expect.anything(), participant.eventId);
+        });
         it('throws NotFoundException with the correct messageKey when the participant is missing', async ()=>{
             mockParticipantRepo.findOne.mockResolvedValue(null);
             const dto = {
@@ -852,4 +875,53 @@ describe('EventService', ()=>{
             expect(mockDataSourceProvider.getRepository).toHaveBeenCalledWith(_entities.EventParticipant);
         });
     });
+    describe('domain events', ()=>{
+        let publish;
+        beforeEach(()=>{
+            publish = jest.fn().mockResolvedValue(undefined);
+            _classes.EventBusRegistry.reset();
+            _classes.EventBusRegistry.setBus({
+                publish,
+                subscribe: jest.fn(),
+                close: jest.fn()
+            });
+            _classes.EventBusRegistry.configureModule('event-manager', {
+                enabled: true
+            });
+        });
+        afterEach(()=>{
+            _classes.EventBusRegistry.reset();
+        });
+        it('publishes event-manager.event.participant-status-changed with the new status', async ()=>{
+            const participant = buildParticipant({
+                status: _enums.ParticipantStatus.PENDING
+            });
+            mockParticipantRepo.findOne.mockResolvedValue(participant);
+            mockParticipantRepo.save.mockImplementation(async (p)=>p);
+            await service.updateParticipantStatus({
+                id: 'participant-uuid-1',
+                status: _enums.ParticipantStatus.ACCEPTED
+            }, user);
+            expect(publish).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'event-manager.event.participant-status-changed',
+                payload: expect.objectContaining({
+                    metadata: expect.objectContaining({
+                        status: _enums.ParticipantStatus.ACCEPTED
+                    })
+                })
+            }));
+        });
+        it('does not publish when the event manager module has events disabled', async ()=>{
+            _classes.EventBusRegistry.configureModule('event-manager', {
+                enabled: false
+            });
+            mockParticipantRepo.findOne.mockResolvedValue(buildParticipant());
+            mockParticipantRepo.save.mockImplementation(async (p)=>p);
+            await service.updateParticipantStatus({
+                id: 'participant-uuid-1',
+                status: _enums.ParticipantStatus.ACCEPTED
+            }, user);
+            expect(publish).not.toHaveBeenCalled();
+        });
+    });
 });

package/config/event-actions.d.ts

@@ -0,0 +1,6 @@
+export declare const EVENT_MANAGER_EVENT_ACTIONS: {
+    readonly PARTICIPANT_STATUS_CHANGED: "participant-status-changed";
+};
+export declare const EVENT_MANAGER_EVENT_ENTITIES: {
+    readonly EVENT: "event";
+};

package/config/index.d.ts

@@ -1,2 +1,3 @@
+export * from './event-actions';
 export * from './event-manager.constants';
 export * from './message-keys';

package/fesm/config/event-actions.js

@@ -0,0 +1,9 @@
+/**
+ * Domain event actions published by the event manager module, alongside the CRUD
+ * lifecycle actions every ApiService emits.
+ */ export const EVENT_MANAGER_EVENT_ACTIONS = {
+    PARTICIPANT_STATUS_CHANGED: 'participant-status-changed'
+};
+/** Every entity the event manager module publishes under */ export const EVENT_MANAGER_EVENT_ENTITIES = {
+    EVENT: 'event'
+};

package/fesm/config/index.js

@@ -1,2 +1,3 @@
+export * from './event-actions';
 export * from './event-manager.constants';
 export * from './message-keys';

package/fesm/modules/event-manager.module.js

@@ -4,7 +4,7 @@ function _ts_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;
 }
-import { CacheModule, UtilsModule } from '@flusys/nestjs-shared/modules';
+import { CacheModule, UtilsModule, createModuleEventsProvider } from '@flusys/nestjs-shared/modules';
 import { EVENT_MANAGER_ADAPTER } from '@flusys/nestjs-shared/interfaces';
 import { Module } from '@nestjs/common';
 import { EVENT_MANAGER_MODULE_OPTIONS } from '../config/event-manager.constants';
@@ -78,6 +78,7 @@ export class EventManagerModule {
                 useValue: options
             });
         }
+        providers.push(createModuleEventsProvider('event-manager', EVENT_MANAGER_MODULE_OPTIONS));
         return providers;
     }
     static createAsyncProviders(options) {

package/fesm/services/event.service.js

@@ -32,7 +32,7 @@ import { UtilsService } from '@flusys/nestjs-shared/modules';
 import { applyCompanyFilter } from '@flusys/nestjs-shared/utils';
 import { Inject, Injectable, NotFoundException, Scope } from '@nestjs/common';
 import { In, IsNull } from 'typeorm';
-import { EVENT_MESSAGES, EVENT_PARTICIPANT_MESSAGES } from '../config';
+import { EVENT_MANAGER_EVENT_ACTIONS, EVENT_MESSAGES, EVENT_PARTICIPANT_MESSAGES } from '../config';
 import { UpdateParticipantStatusDto } from '../dtos';
 import { Event, EventParticipant, EventWithCompany } from '../entities';
 import { EventManagerConfigService } from './event-manager-config.service';
@@ -166,7 +166,7 @@ export class EventService extends ApiService {
         }
         return this.expandRecurringEvents(events, queryDto.startDate, queryDto.endDate);
     }
-    async updateParticipantStatus(dto, _user) {
+    async updateParticipantStatus(dto, user) {
         const participantRepo = await this.ensureParticipantRepositoryInitialized();
         const participant = await participantRepo.findOne({
             where: {
@@ -180,7 +180,27 @@ export class EventService extends ApiService {
             });
         }
         participant.status = dto.status;
-        return participantRepo.save(participant);
+        const saved = await participantRepo.save(participant);
+        await Promise.all([
+            this.clearCacheForAll(),
+            this.clearCacheForId([
+                {
+                    id: participant.eventId
+                }
+            ])
+        ]);
+        await this.publishDomainAction(EVENT_MANAGER_EVENT_ACTIONS.PARTICIPANT_STATUS_CHANGED, {
+            ids: [
+                participant.eventId
+            ],
+            metadata: {
+                participantId: saved.id,
+                participantUserId: saved.userId,
+                status: saved.status
+            },
+            user
+        });
+        return saved;
     }
     // Private business logic helpers
     async addCreatorAndParticipants(eventId, participantIds, user) {

package/fesm/services/event.service.spec.js

@@ -1,4 +1,5 @@
 import { NotFoundException } from '@nestjs/common';
+import { EventBusRegistry } from '@flusys/nestjs-shared/classes';
 import { ParticipantStatus, RecurrenceType } from '@flusys/nestjs-shared/enums';
 import { createMockRepository } from '@test-utils/mocks/repository.mock';
 import { buildMockUser } from '@test-utils/mocks/logged-user.mock';
@@ -46,6 +47,15 @@ function buildParticipant(overrides = {}) {
     };
 }
 describe('EventService', ()=>{
+    const mockUtilsService = {
+        clearCache: jest.fn(),
+        getCacheKey: jest.fn().mockReturnValue('cache-key'),
+        trackCacheKey: jest.fn()
+    };
+    // Call history is shared across tests in this file; reset it so each cache assertion is exact.
+    beforeEach(()=>{
+        mockUtilsService.clearCache.mockClear();
+    });
     let service;
     let mockEventRepo;
     let mockParticipantRepo;
@@ -68,7 +78,7 @@ describe('EventService', ()=>{
             getRepository: jest.fn((entity)=>Promise.resolve(entity === EventParticipant ? mockParticipantRepo : mockEventRepo)),
             getDataSource: jest.fn()
         };
-        service = new EventService({}, {}, mockConfigService, mockDataSourceProvider);
+        service = new EventService({}, mockUtilsService, mockConfigService, mockDataSourceProvider);
     });
     describe('resolveEntity', ()=>{
         it('resolves to the company-scoped entity when the company feature is enabled', ()=>{
@@ -357,6 +367,19 @@ describe('EventService', ()=>{
                 status: ParticipantStatus.TENTATIVE
             }));
         });
+        it('invalidates the event list cache and the parent event entry', async ()=>{
+            const participant = buildParticipant({
+                status: ParticipantStatus.PENDING
+            });
+            mockParticipantRepo.findOne.mockResolvedValue(participant);
+            mockParticipantRepo.save.mockImplementation(async (p)=>p);
+            await service.updateParticipantStatus({
+                id: participant.id,
+                status: ParticipantStatus.ACCEPTED
+            }, user);
+            expect(mockUtilsService.clearCache).toHaveBeenCalledWith('event', expect.anything());
+            expect(mockUtilsService.clearCache).toHaveBeenCalledWith('event', expect.anything(), participant.eventId);
+        });
         it('throws NotFoundException with the correct messageKey when the participant is missing', async ()=>{
             mockParticipantRepo.findOne.mockResolvedValue(null);
             const dto = {
@@ -848,4 +871,53 @@ describe('EventService', ()=>{
             expect(mockDataSourceProvider.getRepository).toHaveBeenCalledWith(EventParticipant);
         });
     });
+    describe('domain events', ()=>{
+        let publish;
+        beforeEach(()=>{
+            publish = jest.fn().mockResolvedValue(undefined);
+            EventBusRegistry.reset();
+            EventBusRegistry.setBus({
+                publish,
+                subscribe: jest.fn(),
+                close: jest.fn()
+            });
+            EventBusRegistry.configureModule('event-manager', {
+                enabled: true
+            });
+        });
+        afterEach(()=>{
+            EventBusRegistry.reset();
+        });
+        it('publishes event-manager.event.participant-status-changed with the new status', async ()=>{
+            const participant = buildParticipant({
+                status: ParticipantStatus.PENDING
+            });
+            mockParticipantRepo.findOne.mockResolvedValue(participant);
+            mockParticipantRepo.save.mockImplementation(async (p)=>p);
+            await service.updateParticipantStatus({
+                id: 'participant-uuid-1',
+                status: ParticipantStatus.ACCEPTED
+            }, user);
+            expect(publish).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'event-manager.event.participant-status-changed',
+                payload: expect.objectContaining({
+                    metadata: expect.objectContaining({
+                        status: ParticipantStatus.ACCEPTED
+                    })
+                })
+            }));
+        });
+        it('does not publish when the event manager module has events disabled', async ()=>{
+            EventBusRegistry.configureModule('event-manager', {
+                enabled: false
+            });
+            mockParticipantRepo.findOne.mockResolvedValue(buildParticipant());
+            mockParticipantRepo.save.mockImplementation(async (p)=>p);
+            await service.updateParticipantStatus({
+                id: 'participant-uuid-1',
+                status: ParticipantStatus.ACCEPTED
+            }, user);
+            expect(publish).not.toHaveBeenCalled();
+        });
+    });
 });

package/interfaces/event-manager-module.interface.d.ts

@@ -1,8 +1,10 @@
 import { IBootstrapAppConfig, IDataSourceServiceOptions, IDynamicModuleConfig, IModuleOptionsFactory } from '@flusys/nestjs-core';
+import { IModuleEventsConfig } from '@flusys/nestjs-shared/interfaces';
 import { ModuleMetadata, Type } from '@nestjs/common';
 export interface IEventManagerModuleConfig extends IDataSourceServiceOptions {
     defaultColor?: string;
     maxRecurrenceOccurrences?: number;
+    events?: IModuleEventsConfig;
 }
 export interface EventManagerModuleOptions extends IDynamicModuleConfig {
     bootstrapAppConfig?: IBootstrapAppConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-event-manager",
-  "version": "6.4.0",
+  "version": "7.0.0-beta.1",
   "description": "Event manager module with calendar support and recurrence",
   "main": "cjs/index.js",
   "module": "fesm/index.js",
@@ -84,7 +84,7 @@
     "express": "^5.0.0"
   },
   "dependencies": {
-    "@flusys/nestjs-core": "6.4.0",
-    "@flusys/nestjs-shared": "6.4.0"
+    "@flusys/nestjs-core": "7.0.0-beta.1",
+    "@flusys/nestjs-shared": "7.0.0-beta.1"
   }
 }

package/services/event.service.d.ts

@@ -28,7 +28,7 @@ export declare class EventService extends ApiService<CreateEventDto, UpdateEvent
     protected afterInsertOperation(entities: EventBase[], _dto: CreateEventDto | Array<CreateEventDto>, user: ILoggedUserInfo | null, _qr: QueryRunner): Promise<void>;
     protected afterUpdateOperation(entities: EventBase[], _dto: UpdateEventDto | Array<UpdateEventDto>, user: ILoggedUserInfo | null, _qr: QueryRunner): Promise<void>;
     getEventsForCalendarRange(queryDto: CalendarQueryDto, user: ILoggedUserInfo | null): Promise<ICalendarEvent[]>;
-    updateParticipantStatus(dto: UpdateParticipantStatusDto, _user: ILoggedUserInfo | null): Promise<EventParticipant>;
+    updateParticipantStatus(dto: UpdateParticipantStatusDto, user: ILoggedUserInfo | null): Promise<EventParticipant>;
     private addCreatorAndParticipants;
     private expandRecurringEvents;
     private generateOccurrences;