@flusys/nestjs-shared 3.0.0 → 3.0.1

package/README.md

@@ -1,7 +1,7 @@
 # Shared Package Guide
 
 > **Package:** `@flusys/nestjs-shared`
-> **Version:** 3.0.0
+> **Version:** 3.0.1
 > **Type:** Shared NestJS utilities, classes, decorators, guards, and modules
 
 This comprehensive guide covers the shared package - the shared NestJS infrastructure layer.

package/cjs/constants/permissions.js

@@ -1,13 +1,4 @@
-/**
- * Centralized Permission Codes
- *
- * Single source of truth for all permission codes used across the application.
- * Use these constants instead of hardcoded strings to prevent typos and enable easy refactoring.
- *
- * Naming Convention: <entity>.<action>
- * - entity: The resource being accessed (e.g., user, role, company)
- * - action: The operation being performed (create, read, update, delete, assign)
- */ // ==================== AUTH MODULE ====================
+// ==================== AUTH MODULE ====================
 "use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
@@ -37,6 +28,12 @@ _export(exports, {
     get EMAIL_TEMPLATE_PERMISSIONS () {
         return EMAIL_TEMPLATE_PERMISSIONS;
     },
+    get EVENT_PARTICIPANT_PERMISSIONS () {
+        return EVENT_PARTICIPANT_PERMISSIONS;
+    },
+    get EVENT_PERMISSIONS () {
+        return EVENT_PERMISSIONS;
+    },
     get FILE_PERMISSIONS () {
         return FILE_PERMISSIONS;
     },
@@ -49,6 +46,9 @@ _export(exports, {
     get FORM_RESULT_PERMISSIONS () {
         return FORM_RESULT_PERMISSIONS;
     },
+    get NOTIFICATION_PERMISSIONS () {
+        return NOTIFICATION_PERMISSIONS;
+    },
     get PERMISSIONS () {
         return PERMISSIONS;
     },
@@ -159,6 +159,24 @@ const FORM_RESULT_PERMISSIONS = {
     UPDATE: 'form-result.update',
     DELETE: 'form-result.delete'
 };
+const EVENT_PERMISSIONS = {
+    CREATE: 'event.create',
+    READ: 'event.read',
+    UPDATE: 'event.update',
+    DELETE: 'event.delete'
+};
+const EVENT_PARTICIPANT_PERMISSIONS = {
+    CREATE: 'event-participant.create',
+    READ: 'event-participant.read',
+    UPDATE: 'event-participant.update',
+    DELETE: 'event-participant.delete'
+};
+const NOTIFICATION_PERMISSIONS = {
+    CREATE: 'notification.create',
+    READ: 'notification.read',
+    UPDATE: 'notification.update',
+    DELETE: 'notification.delete'
+};
 const PERMISSIONS = {
     // Auth
     USER: USER_PERMISSIONS,
@@ -180,5 +198,10 @@ const PERMISSIONS = {
     EMAIL_TEMPLATE: EMAIL_TEMPLATE_PERMISSIONS,
     // Form Builder
     FORM: FORM_PERMISSIONS,
-    FORM_RESULT: FORM_RESULT_PERMISSIONS
+    FORM_RESULT: FORM_RESULT_PERMISSIONS,
+    // Event Manager
+    EVENT: EVENT_PERMISSIONS,
+    EVENT_PARTICIPANT: EVENT_PARTICIPANT_PERMISSIONS,
+    // Notification
+    NOTIFICATION: NOTIFICATION_PERMISSIONS
 };

package/cjs/enums/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./notification-type.enum"), exports);
+_export_star(require("./participant-status.enum"), exports);
+_export_star(require("./recurrence-type.enum"), 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/enums/notification-type.enum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "NotificationType", {
+    enumerable: true,
+    get: function() {
+        return NotificationType;
+    }
+});
+var NotificationType = /*#__PURE__*/ function(NotificationType) {
+    NotificationType["INFO"] = "info";
+    NotificationType["WARNING"] = "warning";
+    NotificationType["SUCCESS"] = "success";
+    NotificationType["ERROR"] = "error";
+    return NotificationType;
+}({});

package/cjs/enums/participant-status.enum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "ParticipantStatus", {
+    enumerable: true,
+    get: function() {
+        return ParticipantStatus;
+    }
+});
+var ParticipantStatus = /*#__PURE__*/ function(ParticipantStatus) {
+    ParticipantStatus["PENDING"] = "pending";
+    ParticipantStatus["ACCEPTED"] = "accepted";
+    ParticipantStatus["DECLINED"] = "declined";
+    ParticipantStatus["TENTATIVE"] = "tentative";
+    return ParticipantStatus;
+}({});

package/cjs/enums/recurrence-type.enum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "RecurrenceType", {
+    enumerable: true,
+    get: function() {
+        return RecurrenceType;
+    }
+});
+var RecurrenceType = /*#__PURE__*/ function(RecurrenceType) {
+    RecurrenceType["NONE"] = "none";
+    RecurrenceType["DAILY"] = "daily";
+    RecurrenceType["WEEKLY"] = "weekly";
+    RecurrenceType["BIWEEKLY"] = "biweekly";
+    RecurrenceType["MONTHLY"] = "monthly";
+    return RecurrenceType;
+}({});

package/cjs/index.js

@@ -7,6 +7,7 @@ _export_star(require("./constants"), exports);
 _export_star(require("./decorators"), exports);
 _export_star(require("./dtos"), exports);
 _export_star(require("./entities"), exports);
+_export_star(require("./enums"), exports);
 _export_star(require("./exceptions"), exports);
 _export_star(require("./guards"), exports);
 _export_star(require("./interceptors"), exports);

package/cjs/interfaces/event-manager-adapter.interface.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "EVENT_MANAGER_ADAPTER", {
+    enumerable: true,
+    get: function() {
+        return EVENT_MANAGER_ADAPTER;
+    }
+});
+const EVENT_MANAGER_ADAPTER = 'EVENT_MANAGER_ADAPTER';

package/cjs/interfaces/index.js

@@ -4,10 +4,12 @@ Object.defineProperty(exports, "__esModule", {
 });
 _export_star(require("./api.interface"), exports);
 _export_star(require("./datasource.interface"), exports);
+_export_star(require("./event-manager-adapter.interface"), exports);
 _export_star(require("./identity.interface"), exports);
 _export_star(require("./logged-user-info.interface"), exports);
 _export_star(require("./logger.interface"), exports);
 _export_star(require("./module-config.interface"), exports);
+_export_star(require("./notification-adapter.interface"), exports);
 _export_star(require("./permission.interface"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {

package/cjs/interfaces/notification-adapter.interface.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "NOTIFICATION_ADAPTER", {
+    enumerable: true,
+    get: function() {
+        return NOTIFICATION_ADAPTER;
+    }
+});
+const NOTIFICATION_ADAPTER = 'NOTIFICATION_ADAPTER';

package/constants/permissions.d.ts

@@ -86,6 +86,24 @@ export declare const FORM_RESULT_PERMISSIONS: {
     readonly UPDATE: "form-result.update";
     readonly DELETE: "form-result.delete";
 };
+export declare const EVENT_PERMISSIONS: {
+    readonly CREATE: "event.create";
+    readonly READ: "event.read";
+    readonly UPDATE: "event.update";
+    readonly DELETE: "event.delete";
+};
+export declare const EVENT_PARTICIPANT_PERMISSIONS: {
+    readonly CREATE: "event-participant.create";
+    readonly READ: "event-participant.read";
+    readonly UPDATE: "event-participant.update";
+    readonly DELETE: "event-participant.delete";
+};
+export declare const NOTIFICATION_PERMISSIONS: {
+    readonly CREATE: "notification.create";
+    readonly READ: "notification.read";
+    readonly UPDATE: "notification.update";
+    readonly DELETE: "notification.delete";
+};
 export declare const PERMISSIONS: {
     readonly USER: {
         readonly CREATE: "user.create";
@@ -175,5 +193,23 @@ export declare const PERMISSIONS: {
         readonly UPDATE: "form-result.update";
         readonly DELETE: "form-result.delete";
     };
+    readonly EVENT: {
+        readonly CREATE: "event.create";
+        readonly READ: "event.read";
+        readonly UPDATE: "event.update";
+        readonly DELETE: "event.delete";
+    };
+    readonly EVENT_PARTICIPANT: {
+        readonly CREATE: "event-participant.create";
+        readonly READ: "event-participant.read";
+        readonly UPDATE: "event-participant.update";
+        readonly DELETE: "event-participant.delete";
+    };
+    readonly NOTIFICATION: {
+        readonly CREATE: "notification.create";
+        readonly READ: "notification.read";
+        readonly UPDATE: "notification.update";
+        readonly DELETE: "notification.delete";
+    };
 };
 export type PermissionCode = (typeof PERMISSIONS)[keyof typeof PERMISSIONS][keyof (typeof PERMISSIONS)[keyof typeof PERMISSIONS]];

package/enums/index.d.ts

@@ -0,0 +1,3 @@
+export * from './notification-type.enum';
+export * from './participant-status.enum';
+export * from './recurrence-type.enum';

package/enums/notification-type.enum.d.ts

@@ -0,0 +1,6 @@
+export declare enum NotificationType {
+    INFO = "info",
+    WARNING = "warning",
+    SUCCESS = "success",
+    ERROR = "error"
+}

package/enums/participant-status.enum.d.ts

@@ -0,0 +1,6 @@
+export declare enum ParticipantStatus {
+    PENDING = "pending",
+    ACCEPTED = "accepted",
+    DECLINED = "declined",
+    TENTATIVE = "tentative"
+}

package/enums/recurrence-type.enum.d.ts

@@ -0,0 +1,7 @@
+export declare enum RecurrenceType {
+    NONE = "none",
+    DAILY = "daily",
+    WEEKLY = "weekly",
+    BIWEEKLY = "biweekly",
+    MONTHLY = "monthly"
+}

package/fesm/constants/permissions.js

@@ -1,13 +1,4 @@
-/**
- * Centralized Permission Codes
- *
- * Single source of truth for all permission codes used across the application.
- * Use these constants instead of hardcoded strings to prevent typos and enable easy refactoring.
- *
- * Naming Convention: <entity>.<action>
- * - entity: The resource being accessed (e.g., user, role, company)
- * - action: The operation being performed (create, read, update, delete, assign)
- */ // ==================== AUTH MODULE ====================
+// ==================== AUTH MODULE ====================
 export const USER_PERMISSIONS = {
     CREATE: 'user.create',
     READ: 'user.read',
@@ -100,10 +91,28 @@ export const FORM_RESULT_PERMISSIONS = {
     UPDATE: 'form-result.update',
     DELETE: 'form-result.delete'
 };
+// ==================== EVENT MANAGER MODULE ====================
+export const EVENT_PERMISSIONS = {
+    CREATE: 'event.create',
+    READ: 'event.read',
+    UPDATE: 'event.update',
+    DELETE: 'event.delete'
+};
+export const EVENT_PARTICIPANT_PERMISSIONS = {
+    CREATE: 'event-participant.create',
+    READ: 'event-participant.read',
+    UPDATE: 'event-participant.update',
+    DELETE: 'event-participant.delete'
+};
+// ==================== NOTIFICATION MODULE ====================
+export const NOTIFICATION_PERMISSIONS = {
+    CREATE: 'notification.create',
+    READ: 'notification.read',
+    UPDATE: 'notification.update',
+    DELETE: 'notification.delete'
+};
 // ==================== AGGREGATED EXPORTS ====================
-/**
- * All permission codes grouped by module
- */ export const PERMISSIONS = {
+export const PERMISSIONS = {
     // Auth
     USER: USER_PERMISSIONS,
     COMPANY: COMPANY_PERMISSIONS,
@@ -124,5 +133,10 @@ export const FORM_RESULT_PERMISSIONS = {
     EMAIL_TEMPLATE: EMAIL_TEMPLATE_PERMISSIONS,
     // Form Builder
     FORM: FORM_PERMISSIONS,
-    FORM_RESULT: FORM_RESULT_PERMISSIONS
+    FORM_RESULT: FORM_RESULT_PERMISSIONS,
+    // Event Manager
+    EVENT: EVENT_PERMISSIONS,
+    EVENT_PARTICIPANT: EVENT_PARTICIPANT_PERMISSIONS,
+    // Notification
+    NOTIFICATION: NOTIFICATION_PERMISSIONS
 };

package/fesm/enums/index.js

@@ -0,0 +1,3 @@
+export * from './notification-type.enum';
+export * from './participant-status.enum';
+export * from './recurrence-type.enum';

package/fesm/enums/notification-type.enum.js

@@ -0,0 +1,7 @@
+export var NotificationType = /*#__PURE__*/ function(NotificationType) {
+    NotificationType["INFO"] = "info";
+    NotificationType["WARNING"] = "warning";
+    NotificationType["SUCCESS"] = "success";
+    NotificationType["ERROR"] = "error";
+    return NotificationType;
+}({});

package/fesm/enums/participant-status.enum.js

@@ -0,0 +1,7 @@
+export var ParticipantStatus = /*#__PURE__*/ function(ParticipantStatus) {
+    ParticipantStatus["PENDING"] = "pending";
+    ParticipantStatus["ACCEPTED"] = "accepted";
+    ParticipantStatus["DECLINED"] = "declined";
+    ParticipantStatus["TENTATIVE"] = "tentative";
+    return ParticipantStatus;
+}({});

package/fesm/enums/recurrence-type.enum.js

@@ -0,0 +1,8 @@
+export var RecurrenceType = /*#__PURE__*/ function(RecurrenceType) {
+    RecurrenceType["NONE"] = "none";
+    RecurrenceType["DAILY"] = "daily";
+    RecurrenceType["WEEKLY"] = "weekly";
+    RecurrenceType["BIWEEKLY"] = "biweekly";
+    RecurrenceType["MONTHLY"] = "monthly";
+    return RecurrenceType;
+}({});

package/fesm/index.js

@@ -3,6 +3,7 @@ export * from './constants';
 export * from './decorators';
 export * from './dtos';
 export * from './entities';
+export * from './enums';
 export * from './exceptions';
 export * from './guards';
 export * from './interceptors';

package/fesm/interfaces/event-manager-adapter.interface.js

@@ -0,0 +1 @@
+export const EVENT_MANAGER_ADAPTER = 'EVENT_MANAGER_ADAPTER';

package/fesm/interfaces/index.js

@@ -1,7 +1,9 @@
 export * from './api.interface';
 export * from './datasource.interface';
+export * from './event-manager-adapter.interface';
 export * from './identity.interface';
 export * from './logged-user-info.interface';
 export * from './logger.interface';
 export * from './module-config.interface';
+export * from './notification-adapter.interface';
 export * from './permission.interface';

package/fesm/interfaces/notification-adapter.interface.js

@@ -0,0 +1 @@
+export const NOTIFICATION_ADAPTER = 'NOTIFICATION_ADAPTER';

package/index.d.ts

@@ -3,6 +3,7 @@ export * from './constants';
 export * from './decorators';
 export * from './dtos';
 export * from './entities';
+export * from './enums';
 export * from './exceptions';
 export * from './guards';
 export * from './interceptors';

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

@@ -0,0 +1,43 @@
+import { ParticipantStatus } from '../enums/participant-status.enum';
+import { RecurrenceType } from '../enums/recurrence-type.enum';
+export interface IEventManagerAdapter {
+    createEvent(options: CreateEventOptions): Promise<EventResult>;
+    addParticipants(eventId: string, userIds: string[], companyId?: string): Promise<void>;
+    removeParticipant(eventId: string, userId: string): Promise<void>;
+    updateParticipantStatus(participantId: string, status: ParticipantStatus): Promise<void>;
+    getEventsForUser?(userId: string, startDate: Date, endDate: Date, companyId?: string): Promise<EventResult[]>;
+    getEventById?(eventId: string): Promise<EventResult | null>;
+}
+export interface CreateEventOptions {
+    title: string;
+    description?: string;
+    meetingLink?: string;
+    startDateTime: Date;
+    endDateTime: Date;
+    isAllDay?: boolean;
+    recurrenceType?: RecurrenceType;
+    recurrenceEndDate?: Date;
+    color?: string;
+    metadata?: Record<string, unknown>;
+    participantIds?: string[];
+    organizerId?: string;
+    companyId?: string;
+}
+export interface EventResult {
+    id: string;
+    title: string;
+    description?: string | null;
+    meetingLink?: string | null;
+    startDateTime: Date;
+    endDateTime: Date;
+    isAllDay: boolean;
+    recurrenceType: string;
+    recurrenceEndDate?: Date | null;
+    color: string;
+    isActive: boolean;
+    metadata?: Record<string, unknown> | null;
+    companyId?: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const EVENT_MANAGER_ADAPTER = "EVENT_MANAGER_ADAPTER";

package/interfaces/index.d.ts

@@ -1,7 +1,9 @@
 export * from './api.interface';
 export * from './datasource.interface';
+export * from './event-manager-adapter.interface';
 export * from './identity.interface';
 export * from './logged-user-info.interface';
 export * from './logger.interface';
 export * from './module-config.interface';
+export * from './notification-adapter.interface';
 export * from './permission.interface';

package/interfaces/notification-adapter.interface.d.ts

@@ -0,0 +1,22 @@
+import { NotificationType } from '../enums/notification-type.enum';
+export interface INotificationAdapter {
+    send(options: NotificationSendOptions): Promise<void>;
+    sendToMany(options: NotificationBulkSendOptions): Promise<void>;
+    broadcastToCompany?(companyId: string, title: string, message?: string, type?: NotificationType, data?: Record<string, unknown>): Promise<void>;
+    isUserOnline?(userId: string): boolean;
+}
+interface NotificationBaseOptions {
+    title: string;
+    message?: string;
+    type?: NotificationType;
+    data?: Record<string, unknown>;
+    companyId?: string;
+}
+export interface NotificationSendOptions extends NotificationBaseOptions {
+    userId: string;
+}
+export interface NotificationBulkSendOptions extends NotificationBaseOptions {
+    userIds: string[];
+}
+export declare const NOTIFICATION_ADAPTER = "NOTIFICATION_ADAPTER";
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-shared",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Common shared utilities for Flusys NestJS applications",
   "main": "cjs/index.js",
   "module": "fesm/index.js",
@@ -46,6 +46,11 @@
       "import": "./fesm/entities/index.js",
       "require": "./cjs/entities/index.js"
     },
+    "./enums": {
+      "types": "./enums/index.d.ts",
+      "import": "./fesm/enums/index.js",
+      "require": "./cjs/enums/index.js"
+    },
     "./exceptions": {
       "types": "./exceptions/index.d.ts",
       "import": "./fesm/exceptions/index.js",
@@ -105,6 +110,6 @@
     "winston-daily-rotate-file": "^5.0.0"
   },
   "dependencies": {
-    "@flusys/nestjs-core": "3.0.0"
+    "@flusys/nestjs-core": "3.0.1"
   }
 }