@flusys/nestjs-event-manager 3.0.1

package/cjs/docs/event-manager-swagger.config.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "eventManagerSwaggerConfig", {
+    enumerable: true,
+    get: function() {
+        return eventManagerSwaggerConfig;
+    }
+});
+/** Schema properties to exclude when company feature is disabled */ const COMPANY_SCHEMA_EXCLUSIONS = [
+    {
+        schemaName: 'EventResponseDto',
+        properties: [
+            'companyId'
+        ]
+    },
+    {
+        schemaName: 'CalendarEventResponseDto',
+        properties: [
+            'companyId'
+        ]
+    }
+];
+function buildDescription(enableCompanyFeature) {
+    const companyFeatures = enableCompanyFeature ? '\n- **Company-scoped events**' : '';
+    const companyIsolation = enableCompanyFeature ? '\n- **Company isolation**' : '';
+    const multiTenantSection = enableCompanyFeature ? `
+## Multi-Tenant Support
+
+Events are automatically isolated by:
+- **Company ID**: Events belong to specific companies
+- **User Context**: Participants are company members
+
+All queries automatically filter by current user's company context.
+` : '';
+    return `
+# Event Manager API
+
+Calendar event management with recurrence support${enableCompanyFeature ? ' and multi-tenant capabilities' : ''}.
+
+## Features
+
+### 📅 Event Management
+- Create, read, update, delete events
+- Rich metadata support
+- Meeting link integration
+- Color-coded events${companyFeatures}
+
+### 🔄 Recurrence Support
+- **None**: Single occurrence
+- **Daily**: Every day
+- **Weekly**: Specific days of the week
+- **Biweekly**: Every two weeks
+- **Monthly**: Same day each month
+
+### 👥 Participant Management
+- Add/remove participants
+- Status tracking (pending, accepted, declined, tentative)
+- Organizer designation
+- Bulk participant operations
+
+### 📆 Calendar Queries
+- Date range queries
+- Automatic recurrence expansion
+- Filter by user participation
+- Include/exclude participants in response
+
+### 🔒 Security
+- JWT authentication required
+- Permission-based access control${companyIsolation}
+
+## Recurrence Patterns
+
+### Weekly Recurrence
+Use \`metadata.recurrenceDays\` array to specify days:
+- 0 = Sunday
+- 1 = Monday
+- 2 = Tuesday
+- 3 = Wednesday
+- 4 = Thursday
+- 5 = Friday
+- 6 = Saturday
+
+Example: \`{ "recurrenceDays": [1, 3, 5] }\` = Monday, Wednesday, Friday
+
+### Recurrence Expansion
+Calendar queries automatically expand recurring events into individual instances.
+Each instance includes:
+- \`isRecurrenceInstance: true\`
+- \`originalEventId\`: Reference to parent event
+- \`recurrenceInstanceDate\`: Specific occurrence date
+${multiTenantSection}
+## API Endpoints
+
+All endpoints use POST method (RPC style):
+
+### Events
+- \`/event-manager/event/insert\` - Create event
+- \`/event-manager/event/get/:id\` - Get by ID
+- \`/event-manager/event/get-all\` - List with pagination
+- \`/event-manager/event/update\` - Update event
+- \`/event-manager/event/delete\` - Soft delete
+- \`/event-manager/event/calendar\` - Calendar query with expansion
+- \`/event-manager/event/get-with-participants\` - Get with participant list
+- \`/event-manager/event/add-participants\` - Add participants
+
+### Participants
+- \`/event-manager/participant/insert\` - Create participant
+- \`/event-manager/participant/get-all\` - List participants
+- \`/event-manager/participant/update-status\` - Update status
+- \`/event-manager/participant/get-by-event\` - Get by event
+- \`/event-manager/participant/get-by-user\` - Get by user
+- \`/event-manager/participant/remove\` - Remove from event
+
+## Getting Started
+
+1. **Authenticate**: Obtain JWT token from /auth/login
+2. **Create Event**: POST to /event-manager/event/insert
+3. **Add Participants**: POST to /event-manager/event/add-participants
+4. **Query Calendar**: POST to /event-manager/event/calendar with date range
+`;
+}
+function eventManagerSwaggerConfig(bootstrapConfig) {
+    const enableCompanyFeature = bootstrapConfig?.enableCompanyFeature ?? true;
+    return {
+        title: 'Event Manager API',
+        description: buildDescription(enableCompanyFeature),
+        version: '1.0',
+        path: 'api/docs/event-manager',
+        bearerAuth: true,
+        excludeTags: [],
+        excludeSchemaProperties: enableCompanyFeature ? undefined : COMPANY_SCHEMA_EXCLUSIONS
+    };
+}

package/cjs/docs/index.js

@@ -0,0 +1,24 @@
+// Re-export permissions from shared for convenience
+"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_PARTICIPANT_PERMISSIONS () {
+        return _nestjsshared.EVENT_PARTICIPANT_PERMISSIONS;
+    },
+    get EVENT_PERMISSIONS () {
+        return _nestjsshared.EVENT_PERMISSIONS;
+    },
+    get eventManagerSwaggerConfig () {
+        return _eventmanagerswaggerconfig.eventManagerSwaggerConfig;
+    }
+});
+const _nestjsshared = require("@flusys/nestjs-shared");
+const _eventmanagerswaggerconfig = require("./event-manager-swagger.config");

package/cjs/dtos/calendar-query.dto.js

@@ -0,0 +1,186 @@
+"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 CalendarEventResponseDto () {
+        return CalendarEventResponseDto;
+    },
+    get CalendarQueryDto () {
+        return CalendarQueryDto;
+    }
+});
+const _swagger = require("@nestjs/swagger");
+const _classtransformer = require("class-transformer");
+const _classvalidator = require("class-validator");
+const _eventparticipantdto = require("./event-participant.dto");
+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);
+}
+let CalendarQueryDto = class CalendarQueryDto {
+    constructor(){
+        _define_property(this, "startDate", void 0);
+        _define_property(this, "endDate", void 0);
+        _define_property(this, "includeParticipants", void 0);
+        _define_property(this, "userId", void 0);
+        _define_property(this, "activeOnly", void 0);
+    }
+};
+_ts_decorate([
+    (0, _swagger.ApiProperty)({
+        description: 'Start date for calendar range',
+        example: '2024-01-01T00:00:00Z'
+    }),
+    (0, _classvalidator.IsNotEmpty)(),
+    (0, _classvalidator.IsDate)(),
+    (0, _classtransformer.Type)(()=>Date),
+    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
+], CalendarQueryDto.prototype, "startDate", void 0);
+_ts_decorate([
+    (0, _swagger.ApiProperty)({
+        description: 'End date for calendar range',
+        example: '2024-01-31T23:59:59Z'
+    }),
+    (0, _classvalidator.IsNotEmpty)(),
+    (0, _classvalidator.IsDate)(),
+    (0, _classtransformer.Type)(()=>Date),
+    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
+], CalendarQueryDto.prototype, "endDate", void 0);
+_ts_decorate([
+    (0, _swagger.ApiPropertyOptional)({
+        description: 'Include participant details',
+        default: false
+    }),
+    (0, _classvalidator.IsOptional)(),
+    (0, _classvalidator.IsBoolean)(),
+    _ts_metadata("design:type", Boolean)
+], CalendarQueryDto.prototype, "includeParticipants", void 0);
+_ts_decorate([
+    (0, _swagger.ApiPropertyOptional)({
+        description: 'Filter by specific user ID'
+    }),
+    (0, _classvalidator.IsOptional)(),
+    (0, _classvalidator.IsUUID)(),
+    _ts_metadata("design:type", String)
+], CalendarQueryDto.prototype, "userId", void 0);
+_ts_decorate([
+    (0, _swagger.ApiPropertyOptional)({
+        description: 'Include only active events',
+        default: true
+    }),
+    (0, _classvalidator.IsOptional)(),
+    (0, _classvalidator.IsBoolean)(),
+    _ts_metadata("design:type", Boolean)
+], CalendarQueryDto.prototype, "activeOnly", void 0);
+let CalendarEventResponseDto = class CalendarEventResponseDto {
+    constructor(){
+        _define_property(this, "id", void 0);
+        _define_property(this, "title", void 0);
+        _define_property(this, "description", void 0);
+        _define_property(this, "meetingLink", void 0);
+        _define_property(this, "startDateTime", void 0);
+        _define_property(this, "endDateTime", void 0);
+        _define_property(this, "isAllDay", void 0);
+        _define_property(this, "recurrenceType", void 0);
+        _define_property(this, "color", void 0);
+        _define_property(this, "isActive", void 0);
+        _define_property(this, "originalEventId", void 0);
+        _define_property(this, "isRecurrenceInstance", void 0);
+        _define_property(this, "participants", void 0);
+    }
+};
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", String)
+], CalendarEventResponseDto.prototype, "id", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", String)
+], CalendarEventResponseDto.prototype, "title", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiPropertyOptional)(),
+    _ts_metadata("design:type", Object)
+], CalendarEventResponseDto.prototype, "description", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiPropertyOptional)(),
+    _ts_metadata("design:type", Object)
+], CalendarEventResponseDto.prototype, "meetingLink", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
+], CalendarEventResponseDto.prototype, "startDateTime", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
+], CalendarEventResponseDto.prototype, "endDateTime", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", Boolean)
+], CalendarEventResponseDto.prototype, "isAllDay", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", String)
+], CalendarEventResponseDto.prototype, "recurrenceType", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", String)
+], CalendarEventResponseDto.prototype, "color", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", Boolean)
+], CalendarEventResponseDto.prototype, "isActive", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiPropertyOptional)(),
+    _ts_metadata("design:type", String)
+], CalendarEventResponseDto.prototype, "originalEventId", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiPropertyOptional)(),
+    _ts_metadata("design:type", Boolean)
+], CalendarEventResponseDto.prototype, "isRecurrenceInstance", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiPropertyOptional)({
+        type: ()=>[
+                _eventparticipantdto.EventParticipantResponseDto
+            ]
+    }),
+    (0, _classtransformer.Type)(()=>_eventparticipantdto.EventParticipantResponseDto),
+    _ts_metadata("design:type", Array)
+], CalendarEventResponseDto.prototype, "participants", void 0);

package/cjs/dtos/event-participant.dto.js

@@ -0,0 +1,226 @@
+"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 BulkAddParticipantsDto () {
+        return BulkAddParticipantsDto;
+    },
+    get CreateEventParticipantDto () {
+        return CreateEventParticipantDto;
+    },
+    get EventParticipantResponseDto () {
+        return EventParticipantResponseDto;
+    },
+    get UpdateEventParticipantDto () {
+        return UpdateEventParticipantDto;
+    },
+    get UpdateParticipantStatusDto () {
+        return UpdateParticipantStatusDto;
+    }
+});
+const _enums = require("@flusys/nestjs-shared/enums");
+const _swagger = require("@nestjs/swagger");
+const _classtransformer = require("class-transformer");
+const _classvalidator = require("class-validator");
+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);
+}
+let CreateEventParticipantDto = class CreateEventParticipantDto {
+    constructor(){
+        _define_property(this, "eventId", void 0);
+        _define_property(this, "userId", void 0);
+        _define_property(this, "status", void 0);
+        _define_property(this, "isOrganizer", void 0);
+        _define_property(this, "metadata", void 0);
+    }
+};
+_ts_decorate([
+    (0, _swagger.ApiProperty)({
+        description: 'Event ID',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
+    (0, _classvalidator.IsNotEmpty)(),
+    (0, _classvalidator.IsUUID)(),
+    _ts_metadata("design:type", String)
+], CreateEventParticipantDto.prototype, "eventId", void 0);
+_ts_decorate([
+    (0, _swagger.ApiProperty)({
+        description: 'User ID',
+        example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
+    }),
+    (0, _classvalidator.IsNotEmpty)(),
+    (0, _classvalidator.IsUUID)(),
+    _ts_metadata("design:type", String)
+], CreateEventParticipantDto.prototype, "userId", void 0);
+_ts_decorate([
+    (0, _swagger.ApiPropertyOptional)({
+        description: 'Participation status',
+        enum: _enums.ParticipantStatus,
+        default: _enums.ParticipantStatus.PENDING
+    }),
+    (0, _classvalidator.IsOptional)(),
+    (0, _classvalidator.IsEnum)(_enums.ParticipantStatus),
+    _ts_metadata("design:type", typeof _enums.ParticipantStatus === "undefined" ? Object : _enums.ParticipantStatus)
+], CreateEventParticipantDto.prototype, "status", void 0);
+_ts_decorate([
+    (0, _swagger.ApiPropertyOptional)({
+        description: 'Is the organizer of the event',
+        default: false
+    }),
+    (0, _classvalidator.IsOptional)(),
+    (0, _classvalidator.IsBoolean)(),
+    _ts_metadata("design:type", Boolean)
+], CreateEventParticipantDto.prototype, "isOrganizer", void 0);
+_ts_decorate([
+    (0, _swagger.ApiPropertyOptional)({
+        description: 'Additional metadata'
+    }),
+    (0, _classvalidator.IsOptional)(),
+    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
+], CreateEventParticipantDto.prototype, "metadata", void 0);
+let UpdateEventParticipantDto = class UpdateEventParticipantDto extends (0, _swagger.PartialType)(CreateEventParticipantDto) {
+    constructor(...args){
+        super(...args), _define_property(this, "id", void 0);
+    }
+};
+_ts_decorate([
+    (0, _swagger.ApiProperty)({
+        description: 'Event Participant ID',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
+    (0, _classvalidator.IsUUID)(),
+    (0, _classvalidator.IsNotEmpty)(),
+    _ts_metadata("design:type", String)
+], UpdateEventParticipantDto.prototype, "id", void 0);
+let EventParticipantResponseDto = class EventParticipantResponseDto {
+    constructor(){
+        _define_property(this, "id", void 0);
+        _define_property(this, "eventId", void 0);
+        _define_property(this, "userId", void 0);
+        _define_property(this, "status", void 0);
+        _define_property(this, "isOrganizer", void 0);
+        _define_property(this, "metadata", void 0);
+        _define_property(this, "createdAt", void 0);
+        _define_property(this, "updatedAt", void 0);
+    }
+};
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", String)
+], EventParticipantResponseDto.prototype, "id", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", String)
+], EventParticipantResponseDto.prototype, "eventId", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", String)
+], EventParticipantResponseDto.prototype, "userId", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)({
+        enum: _enums.ParticipantStatus
+    }),
+    _ts_metadata("design:type", String)
+], EventParticipantResponseDto.prototype, "status", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", Boolean)
+], EventParticipantResponseDto.prototype, "isOrganizer", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiPropertyOptional)(),
+    _ts_metadata("design:type", Object)
+], EventParticipantResponseDto.prototype, "metadata", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
+], EventParticipantResponseDto.prototype, "createdAt", void 0);
+_ts_decorate([
+    (0, _classtransformer.Expose)(),
+    (0, _swagger.ApiProperty)(),
+    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
+], EventParticipantResponseDto.prototype, "updatedAt", void 0);
+let UpdateParticipantStatusDto = class UpdateParticipantStatusDto {
+    constructor(){
+        _define_property(this, "id", void 0);
+        _define_property(this, "status", void 0);
+    }
+};
+_ts_decorate([
+    (0, _swagger.ApiProperty)({
+        description: 'Event Participant ID',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
+    (0, _classvalidator.IsUUID)(),
+    (0, _classvalidator.IsNotEmpty)(),
+    _ts_metadata("design:type", String)
+], UpdateParticipantStatusDto.prototype, "id", void 0);
+_ts_decorate([
+    (0, _swagger.ApiProperty)({
+        description: 'New participation status',
+        enum: _enums.ParticipantStatus
+    }),
+    (0, _classvalidator.IsNotEmpty)(),
+    (0, _classvalidator.IsEnum)(_enums.ParticipantStatus),
+    _ts_metadata("design:type", typeof _enums.ParticipantStatus === "undefined" ? Object : _enums.ParticipantStatus)
+], UpdateParticipantStatusDto.prototype, "status", void 0);
+let BulkAddParticipantsDto = class BulkAddParticipantsDto {
+    constructor(){
+        _define_property(this, "eventId", void 0);
+        _define_property(this, "userIds", void 0);
+    }
+};
+_ts_decorate([
+    (0, _swagger.ApiProperty)({
+        description: 'Event ID',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
+    (0, _classvalidator.IsNotEmpty)(),
+    (0, _classvalidator.IsUUID)(),
+    _ts_metadata("design:type", String)
+], BulkAddParticipantsDto.prototype, "eventId", void 0);
+_ts_decorate([
+    (0, _swagger.ApiProperty)({
+        description: 'User IDs to add as participants',
+        type: [
+            String
+        ]
+    }),
+    (0, _classvalidator.IsNotEmpty)(),
+    (0, _classvalidator.IsUUID)('4', {
+        each: true
+    }),
+    _ts_metadata("design:type", Array)
+], BulkAddParticipantsDto.prototype, "userIds", void 0);