@flusys/nestjs-event-manager 7.1.0 → 8.0.0

package/cjs/adapters/event-manager.adapter.spec.js

@@ -1,104 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _nestjsshared = require("@flusys/nestjs-shared");
-const _eventmanageradapter = require("./event-manager.adapter");
-describe('EventManagerAdapter', ()=>{
-    let adapter;
-    let mockHelper;
-    beforeEach(()=>{
-        mockHelper = {
-            createEvent: jest.fn(),
-            updateParticipantStatus: jest.fn(),
-            getEventsForUser: jest.fn(),
-            getEventById: jest.fn()
-        };
-        adapter = new _eventmanageradapter.EventManagerAdapter(mockHelper);
-    });
-    describe('createEvent', ()=>{
-        it('delegates to the helper service and returns its result', async ()=>{
-            const options = {
-                title: 'Sprint Planning',
-                eventDate: '2026-04-03',
-                startTime: '09:00',
-                endTime: '10:00'
-            };
-            const expected = {
-                id: 'event-uuid-1',
-                title: 'Sprint Planning',
-                description: null,
-                eventDate: '2026-04-03',
-                startTime: '09:00',
-                endTime: '10:00',
-                isAllDay: false,
-                recurrenceType: 'none',
-                recurrenceEndDate: null,
-                weekDays: null,
-                color: '#3B82F6',
-                meetingLink: null,
-                isActive: true,
-                companyId: null,
-                createdAt: new Date(),
-                updatedAt: new Date()
-            };
-            mockHelper.createEvent.mockResolvedValue(expected);
-            const result = await adapter.createEvent(options);
-            expect(mockHelper.createEvent).toHaveBeenCalledWith(options);
-            expect(result).toBe(expected);
-        });
-        it('propagates errors thrown by the helper service', async ()=>{
-            mockHelper.createEvent.mockRejectedValue(new Error('boom'));
-            await expect(adapter.createEvent({})).rejects.toThrow('boom');
-        });
-    });
-    describe('updateParticipantStatus', ()=>{
-        it('delegates to the helper service', async ()=>{
-            mockHelper.updateParticipantStatus.mockResolvedValue(undefined);
-            await adapter.updateParticipantStatus('participant-uuid-1', _nestjsshared.ParticipantStatus.ACCEPTED);
-            expect(mockHelper.updateParticipantStatus).toHaveBeenCalledWith('participant-uuid-1', _nestjsshared.ParticipantStatus.ACCEPTED);
-        });
-    });
-    describe('getEventsForUser', ()=>{
-        it('converts Date range boundaries to YYYY-MM-DD strings before delegating', async ()=>{
-            mockHelper.getEventsForUser.mockResolvedValue([]);
-            const startDate = new Date('2026-04-01T00:00:00.000Z');
-            const endDate = new Date('2026-04-30T23:59:59.000Z');
-            await adapter.getEventsForUser('user-uuid-1', startDate, endDate, 'company-uuid-1');
-            expect(mockHelper.getEventsForUser).toHaveBeenCalledWith('user-uuid-1', '2026-04-01', '2026-04-30', 'company-uuid-1');
-        });
-        it('forwards undefined companyId when not supplied', async ()=>{
-            mockHelper.getEventsForUser.mockResolvedValue([]);
-            const startDate = new Date('2026-04-01T00:00:00.000Z');
-            const endDate = new Date('2026-04-02T00:00:00.000Z');
-            await adapter.getEventsForUser('user-uuid-1', startDate, endDate);
-            expect(mockHelper.getEventsForUser).toHaveBeenCalledWith('user-uuid-1', '2026-04-01', '2026-04-02', undefined);
-        });
-        it('returns the events resolved by the helper service', async ()=>{
-            const events = [
-                {
-                    id: 'event-uuid-1'
-                }
-            ];
-            mockHelper.getEventsForUser.mockResolvedValue(events);
-            const result = await adapter.getEventsForUser('user-uuid-1', new Date('2026-01-01T00:00:00.000Z'), new Date('2026-01-31T00:00:00.000Z'));
-            expect(result).toBe(events);
-        });
-    });
-    describe('getEventById', ()=>{
-        it('returns the event resolved by the helper service', async ()=>{
-            const event = {
-                id: 'event-uuid-1'
-            };
-            mockHelper.getEventById.mockResolvedValue(event);
-            const result = await adapter.getEventById('event-uuid-1');
-            expect(mockHelper.getEventById).toHaveBeenCalledWith('event-uuid-1');
-            expect(result).toBe(event);
-        });
-        it('returns null when the helper service finds no matching event', async ()=>{
-            mockHelper.getEventById.mockResolvedValue(null);
-            const result = await adapter.getEventById('missing-uuid');
-            expect(result).toBeNull();
-        });
-    });
-});

package/cjs/adapters/index.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./event-manager.adapter"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}

package/cjs/config/event-actions.js

@@ -1,31 +0,0 @@
-/**
- * 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;
-    },
-    get EVENT_MANAGER_EVENT_MODULE () {
-        return EVENT_MANAGER_EVENT_MODULE;
-    }
-});
-const EVENT_MANAGER_EVENT_ACTIONS = {
-    PARTICIPANT_STATUS_CHANGED: 'participant-status-changed'
-};
-const EVENT_MANAGER_EVENT_ENTITIES = {
-    EVENT: 'event'
-};
-const EVENT_MANAGER_EVENT_MODULE = 'event-manager';

package/cjs/config/event-manager.constants.js

@@ -1,13 +0,0 @@
-/**
- * Event Manager Module Constants
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "EVENT_MANAGER_MODULE_OPTIONS", {
-    enumerable: true,
-    get: function() {
-        return EVENT_MANAGER_MODULE_OPTIONS;
-    }
-});
-const EVENT_MANAGER_MODULE_OPTIONS = 'EVENT_MANAGER_MODULE_OPTIONS';

package/cjs/config/index.js

@@ -1,20 +0,0 @@
-"use strict";
-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) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}

package/cjs/config/message-keys.js

@@ -1,27 +0,0 @@
-// ==================== EVENT MANAGER MODULE MESSAGE KEYS ====================
-"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_MESSAGES () {
-        return EVENT_MESSAGES;
-    },
-    get EVENT_PARTICIPANT_MESSAGES () {
-        return EVENT_PARTICIPANT_MESSAGES;
-    }
-});
-const EVENT_MESSAGES = {
-    GET_ALL_SUCCESS: 'event.get.all.success',
-    NOT_FOUND: 'event.not.found'
-};
-const EVENT_PARTICIPANT_MESSAGES = {
-    NOT_FOUND: 'event.participant.not.found',
-    STATUS_UPDATE_SUCCESS: 'event.participant.status.update.success'
-};

package/cjs/controllers/event.controller.js

@@ -1,190 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "EventController", {
-    enumerable: true,
-    get: function() {
-        return EventController;
-    }
-});
-const _classes = require("@flusys/nestjs-shared/classes");
-const _decorators = require("@flusys/nestjs-shared/decorators");
-const _dtos = require("@flusys/nestjs-shared/dtos");
-const _guards = require("@flusys/nestjs-shared/guards");
-const _interfaces = require("@flusys/nestjs-shared/interfaces");
-const _common = require("@nestjs/common");
-const _swagger = require("@nestjs/swagger");
-const _classtransformer = require("class-transformer");
-const _config = require("../config");
-const _docs = require("../docs");
-const _dtos1 = require("../dtos");
-const _eventservice = require("../services/event.service");
-function _define_property(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-function _ts_decorate(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;
-}
-function _ts_metadata(k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-function _ts_param(paramIndex, decorator) {
-    return function(target, key) {
-        decorator(target, key, paramIndex);
-    };
-}
-let EventController = class EventController extends (0, _classes.createApiController)(_dtos1.CreateEventDto, _dtos1.UpdateEventDto, _dtos1.EventResponseDto, {
-    entityName: 'event',
-    security: {
-        insert: {
-            level: 'permission',
-            permissions: [
-                _docs.EVENT_PERMISSIONS.CREATE
-            ]
-        },
-        insertMany: {
-            level: 'permission',
-            permissions: [
-                _docs.EVENT_PERMISSIONS.CREATE
-            ]
-        },
-        getById: {
-            level: 'permission',
-            permissions: [
-                _docs.EVENT_PERMISSIONS.READ
-            ]
-        },
-        getAll: {
-            level: 'permission',
-            permissions: [
-                _docs.EVENT_PERMISSIONS.READ
-            ]
-        },
-        update: {
-            level: 'permission',
-            permissions: [
-                _docs.EVENT_PERMISSIONS.UPDATE
-            ]
-        },
-        updateMany: {
-            level: 'permission',
-            permissions: [
-                _docs.EVENT_PERMISSIONS.UPDATE
-            ]
-        },
-        delete: {
-            level: 'permission',
-            permissions: [
-                _docs.EVENT_PERMISSIONS.DELETE
-            ]
-        }
-    }
-}) {
-    async getCalendarEvents(dto, user) {
-        const events = await this.eventService.getEventsForCalendarRange(dto, user);
-        const plainOptions = {
-            excludeExtraneousValues: true
-        };
-        const data = (0, _classtransformer.plainToInstance)(_dtos1.CalendarEventResponseDto, events, plainOptions);
-        return {
-            success: true,
-            message: 'Calendar events retrieved successfully',
-            messageKey: _config.EVENT_MESSAGES.GET_ALL_SUCCESS,
-            data,
-            meta: {
-                total: data.length,
-                page: 0,
-                pageSize: data.length,
-                count: data.length
-            }
-        };
-    }
-    async updateParticipantStatus(dto, user) {
-        const participant = await this.eventService.updateParticipantStatus(dto, user);
-        const plainOptions = {
-            excludeExtraneousValues: true
-        };
-        return {
-            success: true,
-            message: 'Participant status updated successfully',
-            messageKey: _config.EVENT_PARTICIPANT_MESSAGES.STATUS_UPDATE_SUCCESS,
-            data: (0, _classtransformer.plainToInstance)(_dtos1.EventParticipantResponseDto, participant, plainOptions)
-        };
-    }
-    constructor(eventService){
-        super(eventService), _define_property(this, "eventService", void 0), this.eventService = eventService;
-    }
-};
-_ts_decorate([
-    (0, _common.Post)('calendar'),
-    (0, _common.UseGuards)(_guards.JwtAuthGuard),
-    (0, _swagger.ApiBearerAuth)(),
-    (0, _common.HttpCode)(_common.HttpStatus.OK),
-    (0, _swagger.ApiOperation)({
-        summary: 'Get events for calendar range with recurrence expansion'
-    }),
-    (0, _swagger.ApiBody)({
-        type: _dtos1.CalendarQueryDto
-    }),
-    (0, _swagger.ApiResponse)({
-        status: 200,
-        description: 'Calendar events retrieved successfully',
-        type: _dtos.ListResponseDto
-    }),
-    _ts_param(0, (0, _common.Body)()),
-    _ts_param(1, (0, _decorators.CurrentUser)()),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _dtos1.CalendarQueryDto === "undefined" ? Object : _dtos1.CalendarQueryDto,
-        typeof _interfaces.ILoggedUserInfo === "undefined" ? Object : _interfaces.ILoggedUserInfo
-    ]),
-    _ts_metadata("design:returntype", Promise)
-], EventController.prototype, "getCalendarEvents", null);
-_ts_decorate([
-    (0, _common.Post)('update-participant-status'),
-    (0, _common.UseGuards)(_guards.JwtAuthGuard, _guards.PermissionGuard),
-    (0, _swagger.ApiBearerAuth)(),
-    (0, _common.HttpCode)(_common.HttpStatus.OK),
-    (0, _decorators.RequirePermission)(_docs.EVENT_PERMISSIONS.UPDATE),
-    (0, _swagger.ApiOperation)({
-        summary: 'Update participant status (accept/decline/tentative)'
-    }),
-    (0, _swagger.ApiBody)({
-        type: _dtos1.UpdateParticipantStatusDto
-    }),
-    (0, _swagger.ApiResponse)({
-        status: 200,
-        type: _dtos.SingleResponseDto
-    }),
-    _ts_param(0, (0, _common.Body)()),
-    _ts_param(1, (0, _decorators.CurrentUser)()),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _dtos1.UpdateParticipantStatusDto === "undefined" ? Object : _dtos1.UpdateParticipantStatusDto,
-        typeof _interfaces.ILoggedUserInfo === "undefined" ? Object : _interfaces.ILoggedUserInfo
-    ]),
-    _ts_metadata("design:returntype", Promise)
-], EventController.prototype, "updateParticipantStatus", null);
-EventController = _ts_decorate([
-    (0, _swagger.ApiTags)('Events'),
-    (0, _common.Controller)('event-manager/event'),
-    _ts_param(0, (0, _common.Inject)(_eventservice.EventService)),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _eventservice.EventService === "undefined" ? Object : _eventservice.EventService
-    ])
-], EventController);

package/cjs/controllers/event.controller.spec.js

@@ -1,156 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _common = require("@nestjs/common");
-const _enums = require("@flusys/nestjs-shared/enums");
-const _loggedusermock = require("@test-utils/mocks/logged-user.mock");
-const _config = require("../config");
-const _eventcontroller = require("./event.controller");
-function buildCalendarEvent(overrides = {}) {
-    return {
-        id: 'event-uuid-1',
-        title: 'Sprint Planning',
-        description: null,
-        eventDate: '2026-04-03',
-        startTime: '09:00',
-        endTime: '10:00',
-        isAllDay: false,
-        recurrenceType: _enums.RecurrenceType.NONE,
-        recurrenceEndDate: null,
-        weekDays: null,
-        color: '#3B82F6',
-        meetingLink: null,
-        isActive: true,
-        createdAt: new Date('2026-01-01T00:00:00Z'),
-        updatedAt: new Date('2026-01-01T00:00:00Z'),
-        deletedAt: null,
-        createdById: null,
-        updatedById: null,
-        deletedById: null,
-        ...overrides
-    };
-}
-describe('EventController', ()=>{
-    let controller;
-    let mockService;
-    const user = (0, _loggedusermock.buildMockUser)();
-    beforeEach(()=>{
-        mockService = {
-            getEventsForCalendarRange: jest.fn(),
-            updateParticipantStatus: jest.fn()
-        };
-        controller = new _eventcontroller.EventController(mockService);
-    });
-    describe('getCalendarEvents', ()=>{
-        it('returns a ListResponseDto shaped payload with meta reflecting the result count', async ()=>{
-            const events = [
-                buildCalendarEvent(),
-                buildCalendarEvent({
-                    id: 'event-uuid-2'
-                })
-            ];
-            mockService.getEventsForCalendarRange.mockResolvedValue(events);
-            const dto = {
-                startDate: '2026-04-01',
-                endDate: '2026-04-30'
-            };
-            const result = await controller.getCalendarEvents(dto, user);
-            expect(mockService.getEventsForCalendarRange).toHaveBeenCalledWith(dto, user);
-            expect(result.success).toBe(true);
-            expect(result.messageKey).toBe(_config.EVENT_MESSAGES.GET_ALL_SUCCESS);
-            expect(result.data).toHaveLength(2);
-            expect(result.meta).toEqual({
-                total: 2,
-                page: 0,
-                pageSize: 2,
-                count: 2
-            });
-        });
-        it('returns an empty payload with zeroed meta when no events are found', async ()=>{
-            mockService.getEventsForCalendarRange.mockResolvedValue([]);
-            const dto = {
-                startDate: '2026-04-01',
-                endDate: '2026-04-01'
-            };
-            const result = await controller.getCalendarEvents(dto, user);
-            expect(result.data).toEqual([]);
-            expect(result.meta).toEqual({
-                total: 0,
-                page: 0,
-                pageSize: 0,
-                count: 0
-            });
-        });
-        it('serializes events through CalendarEventResponseDto, exposing only declared fields', async ()=>{
-            const events = [
-                buildCalendarEvent({
-                    originalEventId: 'event-uuid-1',
-                    isRecurrenceInstance: true,
-                    // extraneous field that must be stripped by excludeExtraneousValues
-                    ...{
-                        secretInternalField: 'should-not-leak'
-                    }
-                })
-            ];
-            mockService.getEventsForCalendarRange.mockResolvedValue(events);
-            const dto = {
-                startDate: '2026-04-01',
-                endDate: '2026-04-30'
-            };
-            const result = await controller.getCalendarEvents(dto, user);
-            const [firstEvent] = result.data ?? [];
-            expect(firstEvent).not.toHaveProperty('secretInternalField');
-            expect(firstEvent).toMatchObject({
-                id: 'event-uuid-1',
-                originalEventId: 'event-uuid-1',
-                isRecurrenceInstance: true
-            });
-        });
-        it('propagates errors raised by the service', async ()=>{
-            mockService.getEventsForCalendarRange.mockRejectedValue(new Error('db down'));
-            const dto = {
-                startDate: '2026-04-01',
-                endDate: '2026-04-30'
-            };
-            await expect(controller.getCalendarEvents(dto, user)).rejects.toThrow('db down');
-        });
-    });
-    describe('updateParticipantStatus', ()=>{
-        it('returns a SingleResponseDto shaped payload on success', async ()=>{
-            const participant = {
-                id: 'participant-uuid-1',
-                eventId: 'event-uuid-1',
-                userId: user.id,
-                status: _enums.ParticipantStatus.ACCEPTED,
-                isOrganizer: false,
-                createdAt: new Date('2026-01-01T00:00:00Z'),
-                updatedAt: new Date('2026-01-02T00:00:00Z')
-            };
-            mockService.updateParticipantStatus.mockResolvedValue(participant);
-            const dto = {
-                id: 'participant-uuid-1',
-                status: _enums.ParticipantStatus.ACCEPTED
-            };
-            const result = await controller.updateParticipantStatus(dto, user);
-            expect(mockService.updateParticipantStatus).toHaveBeenCalledWith(dto, user);
-            expect(result.success).toBe(true);
-            expect(result.messageKey).toBe(_config.EVENT_PARTICIPANT_MESSAGES.STATUS_UPDATE_SUCCESS);
-            expect(result.data).toMatchObject({
-                id: 'participant-uuid-1',
-                status: _enums.ParticipantStatus.ACCEPTED
-            });
-        });
-        it('propagates a NotFoundException raised by the service', async ()=>{
-            mockService.updateParticipantStatus.mockRejectedValue(new _common.NotFoundException({
-                message: 'Event participant not found',
-                messageKey: _config.EVENT_PARTICIPANT_MESSAGES.NOT_FOUND
-            }));
-            const dto = {
-                id: 'missing-uuid',
-                status: _enums.ParticipantStatus.DECLINED
-            };
-            await expect(controller.updateParticipantStatus(dto, user)).rejects.toThrow(_common.NotFoundException);
-        });
-    });
-});

package/cjs/controllers/index.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./event.controller"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}