@tomei/sso 0.46.7 → 0.46.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomei/sso",
-  "version": "0.46.7",
+  "version": "0.46.9",
   "description": "Tomei SSO Package",
   "main": "dist/index.js",
   "scripts": {

package/src/components/user-privilege/user-privilege.ts

@@ -1,6 +1,14 @@
 import { ClassError, ObjectBase } from '@tomei/general';
 import { IUserPrivilegeAttr } from '../../interfaces/user-privilege.interface';
 import { UserPrivilegeRepository } from './user-privilege.repository';
+import { User as UserClass } from '../login-user/user';
+import { ApplicationConfig } from '@tomei/config';
+import SystemPrivilegeModel from '../../models/system-privilege.entity';
+import SystemModel from '../../models/system.entity';
+import { UserGroupRepository } from '../user-group/user-group.repository';
+import GroupModel from '../../models/group.entity';
+import User from '../../models/user.entity';
+import { GroupPrivilegeRepository } from '../group-privilege/group-privilege.repository';
 
 export class UserPrivilege extends ObjectBase {
   TableName = 'sso_UserPrivilege';
@@ -33,6 +41,8 @@ export class UserPrivilege extends ObjectBase {
   }
 
   private static _Repository = new UserPrivilegeRepository();
+  private static _UserGroupRepository = new UserGroupRepository();
+  private static _GroupPrivilegeRepository = new GroupPrivilegeRepository();
 
   private constructor(userPrivilegeAttr?: IUserPrivilegeAttr) {
     super();
@@ -71,4 +81,259 @@ export class UserPrivilege extends ObjectBase {
       throw error;
     }
   }
+
+  public static async findAll(
+    loginUser: UserClass, //The currently logged-in user initiating the request.
+    dbTransaction: any, //The active database transaction to ensure consistency during the query.
+    whereOption: {
+      //An object containing filter criteria, specifically:
+      UserId: number; //The ID of the user whose system access records are to be retrieved.
+      SystemCode?: string;
+    },
+    pagination: {
+      //An object containing pagination parameters:
+      page: number; //The current page number to retrieve.
+      limit: number; //The number of records to retrieve per page.
+    },
+  ): Promise<{
+    records: {
+      UserPrivilegeId: number;
+      SystemPrivilegeId: string;
+      PrivilegeCode: string;
+      SystemName: string;
+      Status: string;
+      CreatedBy: string;
+      CreatedAt: Date;
+      UpdatedBy: string;
+      UpdatedAt: Date;
+    }[];
+    pagination: {
+      currentPage: number;
+      pageSize: number;
+      totalRecords: number;
+    };
+  }> {
+    try {
+      // Privilege Checking:
+      // Call loginUser.checkPrivileges() method by passing:
+      // SystemCode: Retrieve from app config.
+      //   PrivilegeCode: 'USER_PRIVILEGE_LIST'.
+      const systemCode =
+        ApplicationConfig.getComponentConfigValue('system-code');
+      const privilegeCode = 'USER_PRIVILEGE_LIST';
+      const isPrivileged = await loginUser.checkPrivileges(
+        systemCode,
+        privilegeCode,
+      );
+      if (!isPrivileged) {
+        throw new ClassError(
+          'UserPrivilege',
+          'UserPrivilegeErrMsg01',
+          'You do not have permission to access this resource.',
+        );
+      }
+
+      const options: any = {
+        where: {
+          UserId: whereOption.UserId,
+        },
+        offset: (pagination.page - 1) * pagination.limit,
+        limit: pagination.limit,
+        transaction: dbTransaction,
+        include: [
+          {
+            model: SystemPrivilegeModel,
+            attributes: ['PrivilegeCode'],
+            include: [
+              {
+                model: SystemModel,
+                attributes: ['Name'],
+              },
+            ],
+          },
+          {
+            model: User,
+            as: 'CreatedByUser',
+            attributes: ['FullName'],
+          },
+          {
+            model: User,
+            as: 'UpdatedByUser',
+            attributes: ['FullName'],
+          },
+        ],
+      };
+      const { count, rows } = await this._Repository.findAllWithPagination(
+        options,
+      );
+      return {
+        records: rows.map((record) => {
+          return {
+            UserPrivilegeId: record.UserPrivilegeId,
+            SystemPrivilegeId: record.SystemPrivilegeId,
+            PrivilegeCode: record.Privilege.PrivilegeCode,
+            SystemName: record.Privilege.System.Name,
+            Status: record.Status,
+            CreatedBy: record.CreatedByUser.FullName,
+            CreatedAt: record.CreatedAt,
+            UpdatedBy: record.UpdatedByUser.FullName,
+            UpdatedAt: record.UpdatedAt,
+          };
+        }),
+        pagination: {
+          currentPage: pagination.page,
+          pageSize: pagination.limit,
+          totalRecords: count,
+        },
+      };
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  public static async findAllInheritedPrivileges(
+    UserId: number, //The ID of the user for whom privileges are being retrieved.
+    loginUser: UserClass, //The currently logged-in user initiating the request.
+    dbTransaction: any, //The active database transaction to ensure consistency during the query.
+  ) {
+    try {
+      // Part 1: Privilege Checking
+      // Call loginUser.checkPrivileges() to ensure the user has permission to retrieve system access information.
+      // SystemCode: Retrieve from app config.
+      // PrivilegeCode: 'USER_PRIVILEGE_LIST'.
+      // If the privilege check fails, throw an error with a 403 Forbidden status.
+      const systemCode =
+        ApplicationConfig.getComponentConfigValue('system-code');
+      const privilegeCode = 'USER_PRIVILEGE_LIST';
+      const isPrivileged = await loginUser.checkPrivileges(
+        systemCode,
+        privilegeCode,
+      );
+      if (!isPrivileged) {
+        throw new ClassError(
+          'UserPrivilege',
+          'UserPrivilegeErrMsg01',
+          'You do not have permission to access this resource.',
+        );
+      }
+
+      // Part 2: Retrieve User Groups
+      // Query the sso_UserGroup table to find all active groups the user belongs to.
+      // Join with the sso_Group table to retrieve the GroupCode, GroupName, and InheritGroupPrivilegeYNfields.
+      // Ensure that the value of InheritGroupPrivilegeYN is explicitly 'Y' or 'N' for each group.
+      // If InheritGroupPrivilegeYN is not set, default it to 'N'.
+      // Return only active groups (based on Status field).
+      // The query should return the following fields for each group:
+      // - GroupCode
+      // - GroupName
+      // - InheritPrivilegeYN
+
+      const userGroups = await UserPrivilege._UserGroupRepository.findAll({
+        where: {
+          UserId,
+        },
+        include: [
+          {
+            model: GroupModel,
+            attributes: ['GroupCode', 'Name', 'InheritParentPrivilegeYN'],
+          },
+        ],
+        transaction: dbTransaction,
+      });
+
+      const listOfGroups = userGroups.map((groups) => {
+        let inheritPrivilegeYN = groups.InheritGroupPrivilegeYN;
+        if (inheritPrivilegeYN !== 'Y') {
+          inheritPrivilegeYN = 'N';
+        }
+        return {
+          GroupCode: groups.GroupCode,
+          GroupName: groups.Group.Name,
+          InheritPrivilegeYN: inheritPrivilegeYN,
+          Status: groups.Status,
+        };
+      });
+
+      // Part 3: Retrieve System Privilege for Groups with Inheritance
+      // For each group where InheritGroupPrivilegeYN = 'Y', query the sso_GroupPrivilege table to retrieve system privilege details.
+      // Join with the sso_SystemPrivilege table to fetch system details (PrivilegeCode).
+      // Ensure only active group privilege (Status = 'Active') are included.
+      // For each privilege, retrieve the following fields:
+      // - GroupPrivilegeId (from sso_GroupPrivilege.GroupPrivilegeId)
+      // - SystemPrivilegeId (from sso_GroupPrivilege.SystemPrivilegeId)
+      // - PrivilegeCode (from sso_SystemPrivilege.SystemCode)
+      // - Status (from sso_GroupPrivilege.Status)
+      // - CreatedAt (from sso_GroupPrivilege.CreatedAt)
+      // - UpdatedAt (from sso_GroupPrivilege.UpdatedAt)
+
+      const userGroupPrivilege = [];
+      for (let i = 0; i < listOfGroups.length; i++) {
+        const group = await listOfGroups[i];
+        const data = {
+          GroupCode: group.GroupCode,
+          GroupName: group.GroupName,
+          InheritPrivilegeYN: group.InheritPrivilegeYN,
+          systems: [],
+        };
+
+        // Part 4: Handling Non-Inherited Groups
+        // For groups where InheritGroupSPrivilegeYN = 'N', return the group details without group privilege records.
+        // Set the Privileges field to an empty array or null to indicate no inherited privilege for those groups.
+        if (group.InheritPrivilegeYN === 'Y') {
+          if (group.Status === 'Active') {
+            const options: any = {
+              where: {
+                GroupCode: group.GroupCode,
+                Status: 'Active',
+              },
+              transaction: dbTransaction,
+              include: [
+                {
+                  model: SystemPrivilegeModel,
+                  attributes: ['PrivilegeCode'],
+                  include: [
+                    {
+                      model: SystemModel,
+                      attributes: ['Name'],
+                    },
+                  ],
+                },
+                {
+                  model: User,
+                  as: 'CreatedByUser',
+                  attributes: ['FullName'],
+                },
+                {
+                  model: User,
+                  as: 'UpdatedByUser',
+                  attributes: ['FullName'],
+                },
+              ],
+            };
+            const systemPrivilege =
+              await this._GroupPrivilegeRepository.findAll(options);
+
+            const privilegeDetails = systemPrivilege.map((record) => {
+              return {
+                GroupPrivilegeId: record.GroupPrivilegeId,
+                SystemPrivilegeId: record.SystemPrivilegeId,
+                PrivilegeCode: record.Privilege.PrivilegeCode,
+                Status: record.Status,
+                CreatedBy: record.CreatedByUser.FullName,
+                CreatedAt: record.CreatedAt,
+                UpdatedBy: record.UpdatedByUser.FullName,
+                UpdatedAt: record.UpdatedAt,
+              };
+            });
+
+            data.systems = privilegeDetails;
+          }
+        }
+        userGroupPrivilege.push(data);
+      }
+      return userGroupPrivilege;
+    } catch (error) {
+      throw error;
+    }
+  }
 }

package/src/components/user-system-access/user-system-access.repository.ts

@@ -8,4 +8,18 @@ export class UserSystemAccessRepository
   constructor() {
     super(UserSystemAccessModel);
   }
+
+  async delete(UserSystemAccessId: number, dbTransaction?: any) {
+    try {
+      const options = {
+        where: {
+          UserSystemAccessId: UserSystemAccessId,
+        },
+        transaction: dbTransaction,
+      };
+      await UserSystemAccessModel.destroy(options);
+    } catch (error) {
+      throw new Error(`An Error occured when delete : ${error.message}`);
+    }
+  }
 }

package/src/components/user-system-access/user-system-access.ts

@@ -162,6 +162,7 @@ export class UserSystemAccess extends ObjectBase {
       return {
         records: userSystemAccesses.rows.map((userSystemAccess) => {
           return {
+            UserSystemAccessId: userSystemAccess.UserSystemAccessId,
             SystemName: userSystemAccess.System.Name,
             SystemCode: userSystemAccess.System.SystemCode,
             Status: userSystemAccess.Status,
@@ -301,4 +302,178 @@ export class UserSystemAccess extends ObjectBase {
       throw error;
     }
   }
+
+  public async update(
+    loginUser: User, //The user object representing the currently logged-in user.
+    dbTransaction: any, //The database transaction instance for managing the transaction scope.
+    Status: string, //The new access status (Active/Inactive) for the user system access.
+  ) {
+    try {
+      // Part 1: Update Access
+      // Call the UserSystemAccess._Repo.update() method to perform the update operation, passing:
+      // - Status: The new access status.
+      // - UpdatedById: loginUser.UserId (to indicate who updated the record).
+      // - UpdatedAt: Set to the current date and time.
+      // - dbTransaction: The database transaction instance.
+
+      const entityValueBefore = {
+        UserId: this.UserId,
+        SystemCode: this.SystemCode,
+        Status: this.Status,
+        CreatedById: this.CreatedById,
+        CreatedAt: this.CreatedAt,
+        UpdatedById: this.UpdatedById,
+        UpdatedAt: this.UpdatedAt,
+      };
+      await UserSystemAccess._Repository.update(
+        {
+          Status: Status,
+          UpdatedById: loginUser.UserId,
+          UpdatedAt: new Date(),
+        },
+        {
+          where: {
+            UserSystemAccessId: this.UserSystemAccessId,
+          },
+          transaction: dbTransaction,
+        },
+      );
+
+      const entityValueAfter = {
+        UserId: this.UserId,
+        SystemCode: this.SystemCode,
+        Status: Status,
+        CreatedById: this.CreatedById,
+        CreatedAt: this.CreatedAt,
+        UpdatedById: loginUser.UserId,
+        UpdatedAt: new Date(),
+      };
+
+      // Part 2: Record Activity History
+      // Initialize a variable entityValueBefore to store the current state of the user system access record before the update.
+      // Create an instance of the Activity class and set the following properties:
+      // - ActivityId: Call activity.createId().
+      // - Action: Set to ActionEnum.Update.
+      // - Description: Set to Update User System Access.
+      // - EntityType: Set to UserSystemAccess.
+      // - EntityId: Use the ID of the updated user system access record.
+      // - EntityValueBefore: Stringify entityValueBefore to capture the state before the update.
+      // - EntityValueAfter: Stringify the updated user system access record to capture the new state after the update.
+      // Call the activity create method with the following parameters:
+      // - dbTransaction
+      // - userId: loginUser.UserId
+      const activity = new Activity();
+      activity.ActivityId = activity.createId();
+      activity.Action = ActionEnum.UPDATE;
+      activity.Description = 'Update User System Access';
+      activity.EntityType = 'UserSystemAccess';
+      activity.EntityId = this.UserSystemAccessId + '';
+      activity.EntityValueBefore = JSON.stringify(entityValueBefore);
+      activity.EntityValueAfter = JSON.stringify(entityValueAfter);
+      await activity.create(loginUser.ObjectId, dbTransaction);
+
+      // Part 3: Return Updated Record
+      // Retrieve the updated user system access record from the database or return the updated instance as needed.
+
+      // Part 5: Return Newly Created Record
+      // Return the newly created UserSystemAccess instance with all relevant fields, including UserSystemAccessId, SystemCode, Status, CreatedAt, and CreatedById.
+      return entityValueAfter;
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  public static async remove(
+    loginUser: User, //The currently logged-in user initiating the request.
+    dbTransaction: any, //The active database transaction to ensure consistency during the query.
+    UserSystemAccessId: number, //The unique identifier of the User System Access record to be deleted.
+  ) {
+    try {
+      // Part 1: Privilege Checking
+      // Call loginUser.checkPrivileges() method by passing:
+      // - SystemCode: Retrieve from app config.
+      // - PrivilegeCode: 'USER_SYSTEM_ACCESS_REMOVE'.
+      // If the user does not have the required privileges, throw an appropriate exception.
+      const systemCode =
+        ApplicationConfig.getComponentConfigValue('system-code');
+      const privilegeCode = 'USER_SYSTEM_ACCESS_REMOVE';
+      const isPrivileged = await loginUser.checkPrivileges(
+        systemCode,
+        privilegeCode,
+      );
+      if (!isPrivileged) {
+        throw new ClassError(
+          'UserSystemAccess',
+          'UserSystemAccessErrMsg01',
+          'You do not have permission to access this resource.',
+        );
+      }
+
+      // Part 2: Retrieve Record
+      // Use the UserSystemAccessRepo.findById(UserSystemAccessId) method to retrieve the record.
+      // If the record does not exist, throw an exception indicating the record was not found.
+
+      const userSystemAccess = await UserSystemAccess._Repository.findOne({
+        where: {
+          UserSystemAccessId: UserSystemAccessId,
+        },
+        transaction: dbTransaction,
+      });
+
+      if (!userSystemAccess) {
+        throw new ClassError(
+          'UserSystemAccess',
+          'UserSystemAccessErrMsg02',
+          'User System Access not Found',
+        );
+      }
+
+      // Part 3: Delete Record
+      // Call the UserSystemAccess._Repo.delete() method, passing:
+      // - UserSystemAccessId
+      // dbTransaction to permanently delete the record from the database.
+      await UserSystemAccess._Repository.delete(
+        UserSystemAccessId,
+        dbTransaction,
+      );
+
+      const entityValueBefore = {
+        UserId: userSystemAccess.UserId,
+        SystemCode: userSystemAccess.SystemCode,
+        Status: userSystemAccess.Status,
+        CreatedById: userSystemAccess.CreatedById,
+        CreatedAt: userSystemAccess.CreatedAt,
+        UpdatedById: userSystemAccess.UpdatedById,
+        UpdatedAt: userSystemAccess.UpdatedAt,
+      };
+
+      // Part 4: Record Activity History
+      // Instantiate a new activity from the Activity class, and set:
+      // - ActivityId: activity.createId()
+      // - Action: ActionEnum.Delete
+      // - Description: Delete User System Access
+      // - EntityType: UserSystemAccess
+      // - EntityId: UserSystemAccessId
+      // - EntityValueBefore: Stringified representation of the record before deletion.
+      // - EntityValueAfter: null.
+      // Call the activity.create() method by passing:
+      // - dbTransaction
+      // - userId: loginUser.UserId.
+
+      //Instantiate new activity
+      const activity = new Activity();
+      activity.ActivityId = activity.createId();
+      activity.Action = ActionEnum.DELETE;
+      activity.Description = 'Delete User System Access';
+      activity.EntityType = 'UserSystemAccess';
+      activity.EntityId = UserSystemAccessId?.toString();
+      activity.EntityValueBefore = JSON.stringify(entityValueBefore);
+      activity.EntityValueAfter = JSON.stringify({});
+
+      //Call Activity.create method
+      await activity.create(loginUser.ObjectId, dbTransaction);
+    } catch (error) {
+      throw error;
+    }
+  }
 }