@tomei/rental 0.17.1 → 0.19.0-staging.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomei/rental",
-  "version": "0.17.1",
+  "version": "0.19.0-staging.2",
   "description": "Tomei Rental Package",
   "main": "dist/index.js",
   "scripts": {
@@ -57,13 +57,15 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@tomei/activity-history": "^0.2.23",
+    "@tomei/activity-history": "^0.4.1",
     "@tomei/config": "^0.3.21",
-    "@tomei/general": "^0.21.3",
-    "@tomei/sso": "^0.51.6",
-    "luxon": "^3.5.0",
+    "@tomei/finance": "^0.11.7-staging.4",
+    "@tomei/general": "^0.21.7",
+    "@tomei/sso": "^0.60.4",
+    "@tomei/stock": "^0.18.1",
+    "luxon": "^3.6.1",
     "reflect-metadata": "^0.2.2",
-    "sequelize": "^6.37.5",
+    "sequelize": "^6.37.7",
     "sequelize-typescript": "^2.1.6"
   },
   "lint-staged": {
@@ -71,5 +73,8 @@
       "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
       "eslint \"{src,apps,libs,test}/**/*.ts\" --fix"
     ]
+  },
+  "overrides": {
+    "glob": "^9.0.0"
   }
 }

package/src/ClassMappings/ItemClassMap.ts

@@ -0,0 +1,7 @@
+// Import all item classes that Rental might reference
+import { StockInventory } from '@tomei/stock';
+
+// Create and export the mapping
+export const ItemClassMap = {
+  StockInventory,
+};

package/src/ClassMappings/index.ts

@@ -0,0 +1,3 @@
+import { ItemClassMap } from './ItemClassMap';
+
+export { ItemClassMap };

package/src/components/agreement/agreement.ts

@@ -9,7 +9,7 @@ import * as rentalDb from '../../database';
 import { QueryTypes, where } from 'sequelize';
 import { IResponseAgreementSignature } from '../../interfaces/response-hirer-signature-attr.interface';
 import { AgreementHistoryRepository } from '../agreement-history/agreement-history.repository';
-import { IAgreementHistoryAttr } from 'interfaces/agreement-history-attr.interface';
+import { IAgreementHistoryAttr } from '../../interfaces/agreement-history-attr.interface';
 import { ActionEnum, Activity } from '@tomei/activity-history';
 
 export class Agreement extends ObjectBase {

package/src/components/rental/rental.ts

@@ -22,6 +22,8 @@ import { AgreementSignatureRepository } from '../agreement-signature/agreement-s
 import { AgreementSignatureStatusEnum } from '../../enum/agreement-signature-status.enum';
 import { HirerTypeEnum } from '../../enum/hirer-type.enum';
 import { AgreementHistoryRepository } from '../agreement-history/agreement-history.repository';
+import { DocType, Document, IAccountSystem } from '@tomei/finance';
+import { ItemClassMap } from '../../ClassMappings/ItemClassMap';
 
 export class Rental extends ObjectBase {
   ObjectId: string;
@@ -40,6 +42,8 @@ export class Rental extends ObjectBase {
   AgreementNo: string;
   AccountType: RentalAccountTypeEnum;
   JointHirers: JointHirer[] = [];
+  Invoices: Document[] = [];
+  Item: any;
   protected _Status: RentalStatusEnum | string;
   protected _EscheatmentYN: string = 'N';
   protected _CreatedById: string;
@@ -1132,4 +1136,226 @@ export class Rental extends ObjectBase {
       throw error;
     }
   }
+
+  public toJSON(): IRentalAttr {
+    return {
+      RentalId: this.RentalId,
+      CustomerId: this.CustomerId,
+      CustomerType: this.CustomerType,
+      ItemId: this.ItemId,
+      ItemType: this.ItemType,
+      PriceId: this.PriceId,
+      StartDateTime: this.StartDateTime,
+      EndDateTime: this.EndDateTime,
+      Status: this.Status,
+      CancelRemarks: this.CancelRemarks,
+      TerminateRemarks: this.TerminateRemarks,
+      EscheatmentYN: this.EscheatmentYN,
+      AgreementNo: this.AgreementNo,
+      AccountType: this.AccountType,
+      CreatedById: this.CreatedById,
+      CreatedAt: this.CreatedAt,
+      UpdatedById: this.UpdatedById,
+      UpdatedAt: this.UpdatedAt,
+    };
+  }
+
+  public async getInvoices(
+    loginUser: LoginUser,
+    dbTransaction: any,
+    accountingSystem?: IAccountSystem,
+  ) {
+    try {
+      // Part 1: Privilege Checking
+      // Call loginUser.checkPrivileges() by passing:
+      // SystemCode: <get_from_app_config>
+      // PrivilegeCode: "RENTAL_VIEW_INVOICE"
+      const systemCode =
+        ApplicationConfig.getComponentConfigValue('system-code');
+      const isPrivileged = loginUser.checkPrivileges(
+        systemCode,
+        'RENTAL_VIEW_INVOICE',
+      );
+
+      if (!isPrivileged) {
+        throw new ClassError(
+          'Rental',
+          'RentalErrMsg01',
+          "You do not have 'RENTAL_VIEW_INVOICE' privilege.",
+        );
+      }
+
+      // Part 2: Validation
+      // Make sure this._ObjectId exists, if not throw new ClassError by passing
+      if (!this.ObjectId) {
+        throw new ClassError(
+          'Rental',
+          'RentalErrMsg01',
+          'ObjectId is missing.',
+        );
+      }
+
+      // Part 3: Check Existing Invoices
+      if (this.Invoices.length > 0) {
+        return this.Invoices;
+      }
+
+      // Part 4: Retrieve Invoices and Returns
+      const search = {
+        DocType: DocType.INVOICE,
+        RelatedObjectId: this.ObjectId,
+        RelatedObjectType: this.ObjectType,
+      };
+
+      const documents = await Document.findAll(
+        loginUser,
+        dbTransaction,
+        undefined,
+        undefined,
+        search,
+        undefined,
+        accountingSystem,
+      );
+
+      this.Invoices = documents.rows.map((doc) => {
+        const document = new Document(dbTransaction, doc);
+        return document;
+      });
+
+      return this.Invoices;
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  public async getItem(dbTransaction: any): Promise<any> {
+    if (this.Item) {
+      return this.Item;
+    } else {
+      const ItemClass = ItemClassMap[this.ItemType];
+
+      if (!ItemClass || typeof ItemClass.init !== 'function') {
+        throw new Error(`Invalid or unregistered ItemType: ${this.ItemType}`);
+      }
+
+      ItemClass._Repo = ItemClass._Repo || ItemClass.getRepo();
+
+      if (!ItemClass._Repo) {
+        throw new Error(
+          `ItemType ${this.ItemType} does not have a repository.`,
+        );
+      }
+
+      const itemInstance = await ItemClass.init(this.ItemId, dbTransaction);
+
+      if (!itemInstance) {
+        throw new Error(`${this.ItemType} not found with ID ${this.ItemId}`);
+      }
+      this.Item = itemInstance;
+
+      // Make sure item has setAvailable method
+      if (typeof this.Item.setAvailable !== 'function') {
+        throw new Error(`${this.ItemType} does not implement setAvailable()`);
+      }
+      return this.Item;
+    }
+  }
+
+  public async cancel(
+    loginUser: LoginUser,
+    dbTransaction: any,
+    remarks: string,
+  ): Promise<Rental> {
+    try {
+      // Part 1: Privilege Checking
+      const systemCode =
+        ApplicationConfig.getComponentConfigValue('system-code');
+      const isPrivileged = await loginUser.checkPrivileges(
+        systemCode,
+        'RENTAL_CANCEL',
+      );
+
+      if (!isPrivileged) {
+        throw new ClassError(
+          'Rental',
+          'RentalErrMsg01',
+          "You do not have 'RENTAL_CANCEL' privilege.",
+        );
+      }
+
+      // Part 2: Validation
+      if (!this.ObjectId) {
+        throw new ClassError(
+          'Rental',
+          'RentalErrMsg01',
+          'Rental not found. Rental Id is empty.',
+        );
+      }
+
+      if (
+        this.Status === RentalStatusEnum.ACTIVE ||
+        this.Status === RentalStatusEnum.SUSPENDED
+      ) {
+        throw new ClassError(
+          'Rental',
+          'RentalErrMsg01',
+          `Rental already ${this.Status}, please do termination process.`,
+        );
+      }
+
+      if (!remarks) {
+        throw new ClassError(
+          'Rental',
+          'RentalErrMsg01',
+          'Cancellation remarks is required.',
+        );
+      }
+
+      // Part 3: Capture Record Info Before Changes
+      const entityValueBefore = this.toJSON();
+
+      // Part 4: Update Rental Status and Remarks
+      this._Status = RentalStatusEnum.CANCELLED;
+      this.CancelRemarks = remarks;
+      this._UpdatedById = loginUser.ObjectId;
+      this._UpdatedAt = new Date();
+
+      // Part 5: Update Rental Record
+      await Rental._Repo.update(
+        {
+          Status: this.Status,
+          CancelRemarks: this.CancelRemarks,
+          UpdatedById: this.UpdatedById,
+          UpdatedAt: this.UpdatedAt,
+        },
+        {
+          where: {
+            RentalId: this.RentalId,
+          },
+          transaction: dbTransaction,
+        },
+      );
+
+      // Part 6: Mark Item as Available
+      const item = await this.getItem(dbTransaction);
+
+      await item.setAvailable(loginUser, dbTransaction);
+
+      // Part 7: Capture Record Info After Changes
+      const entityValueAfter = this.toJSON();
+      // Part 8: Record Activity
+      const activity = new Activity();
+      activity.ActivityId = activity.createId();
+      activity.Action = ActionEnum.UPDATE;
+      activity.Description = 'Rental Cancellation';
+      activity.EntityType = this.ObjectType;
+      activity.EntityId = this.ObjectId;
+      activity.EntityValueBefore = JSON.stringify(entityValueBefore);
+      activity.EntityValueAfter = JSON.stringify(entityValueAfter);
+      await activity.create(loginUser.ObjectId, dbTransaction);
+      return this;
+    } catch (error) {
+      throw error;
+    }
+  }
 }

package/src/index.ts

@@ -12,6 +12,7 @@ import { AgreementSignature } from './components/agreement-signature/agreement-s
 import { AgreementSignatureRepository } from './components/agreement-signature/agreement-signature.repository';
 import { AgreementHistory } from './components/agreement-history/agreement-history';
 import { AgreementHistoryRepository } from './components/agreement-history/agreement-history.repository';
+import { ItemClassMap } from './ClassMappings/ItemClassMap';
 import * as rentalDb from './database';
 export * from './interfaces';
 export * from './models';
@@ -33,4 +34,5 @@ export {
   AgreementSignatureRepository,
   AgreementHistory,
   AgreementHistoryRepository,
+  ItemClassMap,
 };