law-common 10.45.3-beta.9 → 10.46.0

package/dist/src/api/interface/billing.create.dto.interface.d.ts

@@ -1,5 +1,5 @@
 import { BillingImpactEnum, BillingReimbursementExpenseChangedStatusEnum, BillingStatusEnum, IBillingEntity, IBillingTimesheetEntity, IEntityCreateDto, IProjectEntity, ITimesheetEntity } from "../../entities";
-export type IBillingCreateExclude = "paymentStatus" | "status" | "writeoffAmount" | "tdsAmount" | "totalAmountPaid" | "creditNoteAmount" | "invoicePdfUrl" | "startDate" | "endDate";
+export type IBillingCreateExclude = "paymentStatus" | "status" | "writeoffAmount" | "tdsAmount" | "totalAmountPaid" | "creditNoteAmount" | "refundAmount" | "invoicePdfUrl" | "startDate" | "endDate";
 export interface IBillingCreateDto extends Omit<IEntityCreateDto<IBillingEntity>, IBillingCreateExclude | "particulars"> {
     timesheets?: IBillingTimesheetsDto;
     status?: BillingStatusEnum;
@@ -9,6 +9,7 @@ export interface IBillingCreateDto extends Omit<IEntityCreateDto<IBillingEntity>
     endDate?: string;
 }
 export interface IBillingParticulars {
+    invoiceDescription: string;
     invoiceText?: string;
     debitNoteText?: string;
     includeDebitNoteSummary: boolean;

package/dist/src/api/interface/expense_type.update.dto.d.ts

@@ -1,6 +1,9 @@
-import { ExpenseTypeEnum } from "../../entities";
+import { ExpenseTypeEnum, IExpenseTypeEntity } from "../../entities";
 export interface IExpenseTypeUpdateDto {
     name?: string;
     description?: string;
     type?: ExpenseTypeEnum;
 }
+export interface IExpenseTypeUpdateDtoValidationData {
+    existingEntity: IExpenseTypeEntity;
+}

package/dist/src/entities/enums/billing.transaction.enum.d.ts

@@ -2,7 +2,8 @@ export declare enum BillingTransactionType {
     TDS = "TDS",
     WRITE_OFF = "WRITE_OFF",
     CREDIT_NOTE = "CREDIT_NOTE",
-    PAYMENT = "PAYMENT"
+    RECEIPT = "RECEIPT",
+    REFUND = "REFUND"
 }
 export declare namespace BillingTransactionType {
     function getNames(): string[];

package/dist/src/entities/enums/billing.transaction.enum.js

@@ -8,7 +8,8 @@ var BillingTransactionType;
     BillingTransactionType["TDS"] = "TDS";
     BillingTransactionType["WRITE_OFF"] = "WRITE_OFF";
     BillingTransactionType["CREDIT_NOTE"] = "CREDIT_NOTE";
-    BillingTransactionType["PAYMENT"] = "PAYMENT";
+    BillingTransactionType["RECEIPT"] = "RECEIPT";
+    BillingTransactionType["REFUND"] = "REFUND";
 })(BillingTransactionType || (exports.BillingTransactionType = BillingTransactionType = {}));
 (function (BillingTransactionType) {
     function getNames() {

package/dist/src/entities/index.d.ts

@@ -1,6 +1,6 @@
+export * from "./enums/organization.entity.enum";
 export * from "./enums/task.entity.enum";
 export * from "./enums/user.entity.enum";
-export * from "./enums/organization.entity.enum";
 export * from "./interface/entity.utils.interface";
 export * from "./interface/organization.entity.interface";
 export * from "./interface/task.entity.interface";
@@ -47,12 +47,12 @@ export * from "./enums/entity_search_constraint_type.enum";
 export * from "./enums/bank_action.enum";
 export * from "./enums/bank_status.enum";
 export * from "./interface/bank_history.entity.interface";
+export * from "./enums/duration-type.enum";
+export * from "./enums/leave-type.enum";
 export * from "./enums/leave.action.enum";
 export * from "./enums/leave.status.enum";
 export * from "./interface/leave.entity.interface";
 export * from "./interface/leave_history.entity.interface";
-export * from "./enums/duration-type.enum";
-export * from "./enums/leave-type.enum";
 export * from "./enums/work.from.home.action.enum";
 export * from "./enums/work.from.home.status.enum";
 export * from "./interface/work_from_home.entity.interface";
@@ -61,56 +61,56 @@ export * from "./interface/country.entity.interface";
 export * from "./enums/billing_invoice_type.enum";
 export * from "./interface/billing_timesheet.entity.interface";
 export * from "./interface/intermediary_bank.entity.interface";
+export * from "./interface/address-book.entity.interface";
 export * from "./interface/holiday-list.entity.interface";
 export * from "./interface/holiday.entity.interface";
-export * from "./interface/address-book.entity.interface";
-export * from "./model/leave.entity.model";
-export * from "./model/leave_count.entity.model";
-export * from "./model/holiday.entity.model";
+export * from "./enums/configuration-key.enum";
 export * from "./enums/cron-jobs-name.enum";
 export * from "./enums/cron-jobs-status.enum";
-export * from "./enums/configuration-key.enum";
 export * from "./enums/timezone.enum";
 export * from "./interface/cron-job.entity.interface";
-export * from "./model/configuration.model";
 export * from "./interface/to-do.entity.interface";
-export * from "./enums/billing-type.enum";
-export * from "./interface/billing-reimbursement-expense.entity.interface";
+export * from "./model/configuration.model";
+export * from "./model/holiday.entity.model";
+export * from "./model/leave.entity.model";
+export * from "./model/leave_count.entity.model";
+export * from "./enums/billing-reimburement-expense-impact.enum";
 export * from "./enums/billing-reimbursement-expense-change-status.enum";
+export * from "./enums/billing-type.enum";
 export * from "./interface/billing-reimbursement-expense-history.entity.interface";
-export * from "./enums/billing-reimburement-expense-impact.enum";
+export * from "./interface/billing-reimbursement-expense.entity.interface";
 export * from "./model/bank.entity.model";
 export * from "./model/base.entity.model";
 export * from "./model/billing-reimbursement-expense.entity.model";
+export * from "./model/billing-timesheet.entity.model";
 export * from "./model/billing.entity.model";
+export * from "./model/client-affiliate.entity.model";
+export * from "./model/client.entity.model";
+export * from "./model/configuration.model";
+export * from "./model/country.entity.model";
+export * from "./model/designation.entity.model";
 export * from "./model/entity.model.interface";
 export * from "./model/project-user-mapping.entity.model";
 export * from "./model/project.entity.model";
 export * from "./model/reimbursement-expense.entity.model";
 export * from "./model/reimbursement.entity.model";
 export * from "./model/task.entity.model";
-export * from "./model/user.entity.model";
-export * from "./model/client.entity.model";
-export * from "./model/configuration.model";
-export * from "./model/designation.entity.model";
 export * from "./model/timesheet.entity.model";
 export * from "./model/user.entity.model";
-export * from "./model/client-affiliate.entity.model";
-export * from "./model/billing-timesheet.entity.model";
-export * from "./model/country.entity.model";
 export * from "./interface/entity-audit-columns.interface";
 export * from "./enums/billing-transaction-action.enum";
 export * from "./enums/billing-transaction-status.enum";
 export * from "./interface/billing-transaction-history.entity";
 export * from "./model/billing-transaction.model";
-export * from "./interface/address-book.entity.interface";
 export * from "./enums/address_book_status_enum";
-export * from "./interface/state.entity.interface";
+export * from "./interface/address-book.entity.interface";
 export * from "./enums/state_status_enum";
+export * from "./interface/state.entity.interface";
 export * from "./model/state.entity.model";
-export * from "./interface/gst_rate.entity.interface";
 export * from "./enums/gst_rate_status_enum";
+export * from "./interface/gst_rate.entity.interface";
 export * from "./model/gst_rate.entity.model";
-export * from "./interface/organization_type.entity.interface";
 export * from "./enums/organization_type_status_enum";
+export * from "./interface/organization_type.entity.interface";
 export * from "./model/organization_type.entity.model";
+export * from "./model/interface/billing.model.interface";

package/dist/src/entities/index.js

@@ -14,9 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./enums/organization.entity.enum"), exports);
 __exportStar(require("./enums/task.entity.enum"), exports);
 __exportStar(require("./enums/user.entity.enum"), exports);
-__exportStar(require("./enums/organization.entity.enum"), exports);
 __exportStar(require("./interface/entity.utils.interface"), exports);
 __exportStar(require("./interface/organization.entity.interface"), exports);
 __exportStar(require("./interface/task.entity.interface"), exports);
@@ -63,12 +63,12 @@ __exportStar(require("./enums/entity_search_constraint_type.enum"), exports);
 __exportStar(require("./enums/bank_action.enum"), exports);
 __exportStar(require("./enums/bank_status.enum"), exports);
 __exportStar(require("./interface/bank_history.entity.interface"), exports);
+__exportStar(require("./enums/duration-type.enum"), exports);
+__exportStar(require("./enums/leave-type.enum"), exports);
 __exportStar(require("./enums/leave.action.enum"), exports);
 __exportStar(require("./enums/leave.status.enum"), exports);
 __exportStar(require("./interface/leave.entity.interface"), exports);
 __exportStar(require("./interface/leave_history.entity.interface"), exports);
-__exportStar(require("./enums/duration-type.enum"), exports);
-__exportStar(require("./enums/leave-type.enum"), exports);
 __exportStar(require("./enums/work.from.home.action.enum"), exports);
 __exportStar(require("./enums/work.from.home.status.enum"), exports);
 __exportStar(require("./interface/work_from_home.entity.interface"), exports);
@@ -77,56 +77,56 @@ __exportStar(require("./interface/country.entity.interface"), exports);
 __exportStar(require("./enums/billing_invoice_type.enum"), exports);
 __exportStar(require("./interface/billing_timesheet.entity.interface"), exports);
 __exportStar(require("./interface/intermediary_bank.entity.interface"), exports);
+__exportStar(require("./interface/address-book.entity.interface"), exports);
 __exportStar(require("./interface/holiday-list.entity.interface"), exports);
 __exportStar(require("./interface/holiday.entity.interface"), exports);
-__exportStar(require("./interface/address-book.entity.interface"), exports);
-__exportStar(require("./model/leave.entity.model"), exports);
-__exportStar(require("./model/leave_count.entity.model"), exports);
-__exportStar(require("./model/holiday.entity.model"), exports);
+__exportStar(require("./enums/configuration-key.enum"), exports);
 __exportStar(require("./enums/cron-jobs-name.enum"), exports);
 __exportStar(require("./enums/cron-jobs-status.enum"), exports);
-__exportStar(require("./enums/configuration-key.enum"), exports);
 __exportStar(require("./enums/timezone.enum"), exports);
 __exportStar(require("./interface/cron-job.entity.interface"), exports);
-__exportStar(require("./model/configuration.model"), exports);
 __exportStar(require("./interface/to-do.entity.interface"), exports);
-__exportStar(require("./enums/billing-type.enum"), exports);
-__exportStar(require("./interface/billing-reimbursement-expense.entity.interface"), exports);
+__exportStar(require("./model/configuration.model"), exports);
+__exportStar(require("./model/holiday.entity.model"), exports);
+__exportStar(require("./model/leave.entity.model"), exports);
+__exportStar(require("./model/leave_count.entity.model"), exports);
+__exportStar(require("./enums/billing-reimburement-expense-impact.enum"), exports);
 __exportStar(require("./enums/billing-reimbursement-expense-change-status.enum"), exports);
+__exportStar(require("./enums/billing-type.enum"), exports);
 __exportStar(require("./interface/billing-reimbursement-expense-history.entity.interface"), exports);
-__exportStar(require("./enums/billing-reimburement-expense-impact.enum"), exports);
+__exportStar(require("./interface/billing-reimbursement-expense.entity.interface"), exports);
 __exportStar(require("./model/bank.entity.model"), exports);
 __exportStar(require("./model/base.entity.model"), exports);
 __exportStar(require("./model/billing-reimbursement-expense.entity.model"), exports);
+__exportStar(require("./model/billing-timesheet.entity.model"), exports);
 __exportStar(require("./model/billing.entity.model"), exports);
+__exportStar(require("./model/client-affiliate.entity.model"), exports);
+__exportStar(require("./model/client.entity.model"), exports);
+__exportStar(require("./model/configuration.model"), exports);
+__exportStar(require("./model/country.entity.model"), exports);
+__exportStar(require("./model/designation.entity.model"), exports);
 __exportStar(require("./model/entity.model.interface"), exports);
 __exportStar(require("./model/project-user-mapping.entity.model"), exports);
 __exportStar(require("./model/project.entity.model"), exports);
 __exportStar(require("./model/reimbursement-expense.entity.model"), exports);
 __exportStar(require("./model/reimbursement.entity.model"), exports);
 __exportStar(require("./model/task.entity.model"), exports);
-__exportStar(require("./model/user.entity.model"), exports);
-__exportStar(require("./model/client.entity.model"), exports);
-__exportStar(require("./model/configuration.model"), exports);
-__exportStar(require("./model/designation.entity.model"), exports);
 __exportStar(require("./model/timesheet.entity.model"), exports);
 __exportStar(require("./model/user.entity.model"), exports);
-__exportStar(require("./model/client-affiliate.entity.model"), exports);
-__exportStar(require("./model/billing-timesheet.entity.model"), exports);
-__exportStar(require("./model/country.entity.model"), exports);
 __exportStar(require("./interface/entity-audit-columns.interface"), exports);
 __exportStar(require("./enums/billing-transaction-action.enum"), exports);
 __exportStar(require("./enums/billing-transaction-status.enum"), exports);
 __exportStar(require("./interface/billing-transaction-history.entity"), exports);
 __exportStar(require("./model/billing-transaction.model"), exports);
-__exportStar(require("./interface/address-book.entity.interface"), exports);
 __exportStar(require("./enums/address_book_status_enum"), exports);
-__exportStar(require("./interface/state.entity.interface"), exports);
+__exportStar(require("./interface/address-book.entity.interface"), exports);
 __exportStar(require("./enums/state_status_enum"), exports);
+__exportStar(require("./interface/state.entity.interface"), exports);
 __exportStar(require("./model/state.entity.model"), exports);
-__exportStar(require("./interface/gst_rate.entity.interface"), exports);
 __exportStar(require("./enums/gst_rate_status_enum"), exports);
+__exportStar(require("./interface/gst_rate.entity.interface"), exports);
 __exportStar(require("./model/gst_rate.entity.model"), exports);
-__exportStar(require("./interface/organization_type.entity.interface"), exports);
 __exportStar(require("./enums/organization_type_status_enum"), exports);
+__exportStar(require("./interface/organization_type.entity.interface"), exports);
 __exportStar(require("./model/organization_type.entity.model"), exports);
+__exportStar(require("./model/interface/billing.model.interface"), exports);

package/dist/src/entities/interface/billing.entity.interface.d.ts

@@ -20,6 +20,7 @@ export interface IBillingEntity extends IEntityAuditColumn {
     totalAmountPaid: number;
     tdsAmount: number;
     creditNoteAmount: number;
+    refundAmount: number;
     invoiceEntityId: number;
     invoiceEntityType: BillingInvoiceTypeEnum;
     invoicePdfUrl?: string | null;

package/dist/src/entities/interface/billing_transaction.entity.interface.d.ts

@@ -5,6 +5,7 @@ import { IEntityFilterData } from "./entity.utils.interface";
 export interface IBillingTransactionEntity extends IEntityAuditColumn {
     id: number;
     billingId: number;
+    advanceBillingId?: number;
     type: BillingTransactionType;
     amount: number;
     details: string;

package/dist/src/entities/model/billing-transaction.model.d.ts

@@ -10,6 +10,7 @@ import { UserEntityModel } from "./user.entity.model";
 export declare class BillingTransactionEntityModel extends BaseEntityModel<EntityEnum.BILLING_TRANSACTION> implements IBillingTransactionEntity {
     id: number;
     billingId: number;
+    advanceBillingId?: number;
     type: BillingTransactionType;
     amount: number;
     details: string;
@@ -35,4 +36,5 @@ export declare class BillingTransactionEntityModel extends BaseEntityModel<Entit
         EntityEnum.BILLING
     ], EnumEntityType<EntityEnum.BILLING_TRANSACTION>>;
     static fromEntity(entity: IBillingTransactionEntity): BillingTransactionEntityModel;
+    static sumAmounts(transactions: BillingTransactionEntityModel[]): number;
 }

package/dist/src/entities/model/billing-transaction.model.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BillingTransactionEntityModel = void 0;
+const utils_1 = require("../../utils");
 const billing_transaction_status_enum_1 = require("../enums/billing-transaction-status.enum");
 const billing_transaction_enum_1 = require("../enums/billing.transaction.enum");
 const relation_type_enum_1 = require("../enums/relation-type.enum");
@@ -11,7 +12,8 @@ class BillingTransactionEntityModel extends base_entity_model_1.BaseEntityModel
         super(...arguments);
         this.id = 0;
         this.billingId = 0;
-        this.type = billing_transaction_enum_1.BillingTransactionType.PAYMENT;
+        this.advanceBillingId = 0;
+        this.type = billing_transaction_enum_1.BillingTransactionType.RECEIPT;
         this.amount = 0;
         this.details = "";
         this.status = billing_transaction_status_enum_1.BillingTransactionStatusEnum.APPROVED;
@@ -30,6 +32,16 @@ class BillingTransactionEntityModel extends base_entity_model_1.BaseEntityModel
         Object.assign(result, entity);
         return result;
     }
+    static sumAmounts(transactions) {
+        return (0, utils_1.sumArray)(transactions.map((t) => {
+            var _a;
+            return ({
+                amount: typeof t.amount === "string"
+                    ? (0, utils_1.getDecimalNumberFromString)(t.amount)
+                    : ((_a = t.amount) !== null && _a !== void 0 ? _a : 0),
+            });
+        }), "amount");
+    }
 }
 exports.BillingTransactionEntityModel = BillingTransactionEntityModel;
 BillingTransactionEntityModel.relationConfigs = [

package/dist/src/entities/model/billing.entity.model.d.ts

@@ -6,6 +6,7 @@ import { BillingStatusEnum } from "../enums/billing.status.enum";
 import { BillingInvoiceTypeEnum } from "../enums/billing_invoice_type.enum";
 import { PaymentStatusEnum } from "../enums/payment_status.enum";
 import { IBillingEntity } from "../interface/billing.entity.interface";
+import { IBillingTransactionEntity } from "../interface/billing_transaction.entity.interface";
 import { EntityEnum, EnumEntityType } from "../interface/entity.utils.interface";
 import { RelationConfigs } from "../interface/relation-config.interface";
 import { BankEntityModel } from "./bank.entity.model";
@@ -14,6 +15,7 @@ import { BillingReimbursementExpneseEntityModel } from "./billing-reimbursement-
 import { BillingTimesheetEntityModel } from "./billing-timesheet.entity.model";
 import { BillingTransactionEntityModel } from "./billing-transaction.model";
 import { ClientEntityModel } from "./client.entity.model";
+import { IAdvanceBillingTransactionsSummary } from "./interface/billing.model.interface";
 import { ProjectEntityModel } from "./project.entity.model";
 import { ReimbursementExpenseEntityModel } from "./reimbursement-expense.entity.model";
 import { UserEntityModel } from "./user.entity.model";
@@ -40,6 +42,7 @@ export declare class BillingEntityModel extends BaseEntityModel<EntityEnum.BILLI
     totalAmountPaid: number;
     tdsAmount: number;
     creditNoteAmount: number;
+    refundAmount: number;
     invoiceEntityId: number;
     invoiceEntityType: BillingInvoiceTypeEnum;
     invoicePdfUrl?: string | null;
@@ -87,4 +90,17 @@ export declare class BillingEntityModel extends BaseEntityModel<EntityEnum.BILLI
         [key: string]: () => boolean;
     }): BillingActionsEnum[];
     getRelationConfigs(): any;
+    getAdvanceBillingTransactionsSummary(adjustedBillingTransactions: IBillingTransactionEntity[]): IAdvanceBillingTransactionsSummary;
+    private getUseableTDSAmount;
+    private getUsedTDSAmount;
+    private getTotalTDSAmount;
+    private getTotalRecieptAmount;
+    private getUseableRecieptAmount;
+    private getUsedRecieptAmount;
+    private getUseableAmount;
+    private getUsedAmount;
+    getTotalAmountRecieved(): number;
+    getTotalRecievableAmount(): number;
+    validateAdvanceBillingId(adjustedBillingTransactions: IBillingTransactionEntity[]): void;
+    getApprovedBillingTransactionsTotalAmount(): number;
 }

package/dist/src/entities/model/billing.entity.model.js

@@ -2,9 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BillingEntityModel = exports.BillingStatusCategoryEnumForUI = void 0;
 const enums_1 = require("../../enums");
+const error_key_enum_1 = require("../../enums/error.key.enum");
+const exceptions_1 = require("../../exceptions");
 const utils_1 = require("../../utils");
+const billing_transaction_status_enum_1 = require("../enums/billing-transaction-status.enum");
 const billing_type_enum_1 = require("../enums/billing-type.enum");
 const billing_status_enum_1 = require("../enums/billing.status.enum");
+const billing_transaction_enum_1 = require("../enums/billing.transaction.enum");
 const billing_invoice_type_enum_1 = require("../enums/billing_invoice_type.enum");
 const payment_status_enum_1 = require("../enums/payment_status.enum");
 const relation_type_enum_1 = require("../enums/relation-type.enum");
@@ -32,6 +36,7 @@ class BillingEntityModel extends base_entity_model_1.BaseEntityModel {
         this.totalAmountPaid = 0;
         this.tdsAmount = 0;
         this.creditNoteAmount = 0;
+        this.refundAmount = 0;
         this.invoiceEntityId = 0;
         this.invoiceEntityType = billing_invoice_type_enum_1.BillingInvoiceTypeEnum.CLIENT;
         this.invoiceContactName = "";
@@ -44,23 +49,9 @@ class BillingEntityModel extends base_entity_model_1.BaseEntityModel {
         this.updatedOn = 0;
         this.type = billing_type_enum_1.BillingTypeEnum.INVOICE;
     }
-    // static fromEntity(entity: IBillingEntity): BillingEntityModel {
-    //   console.log("entity", entity);
-    //   const result = new BillingEntityModel(EntityEnum.BILLING);
-    //   console.log("result", result);
-    //   Object.assign(result, entity);
-    //   return result;
-    // }
     static fromEntity(entity) {
-        console.log("Raw input → entity.type =", entity.type); // should be "both"
         const result = new BillingEntityModel(entity_utils_interface_1.EntityEnum.BILLING);
-        console.log("After new → result.type =", result.type);
-        console.log("After new → result['type'] (bypass getter) =", result["type"]);
-        console.log("After new → JSON.stringify(result) =", JSON.stringify(result, null, 2));
-        console.log("After new → hasOwnProperty('type') =", result.hasOwnProperty("type"));
-        console.log("After new → getOwnPropertyDescriptor =", Object.getOwnPropertyDescriptor(result, "type"));
         Object.assign(result, entity);
-        console.log("After assign → result.type =", result.type);
         return result;
     }
     getStatusCategory() {
@@ -195,6 +186,85 @@ class BillingEntityModel extends base_entity_model_1.BaseEntityModel {
     getRelationConfigs() {
         return this.constructor.prototype.constructor.relationConfigs || [];
     }
+    getAdvanceBillingTransactionsSummary(adjustedBillingTransactions) {
+        this.validateAdvanceBillingId(adjustedBillingTransactions);
+        if (this.type === billing_type_enum_1.BillingTypeEnum.ADVANCE) {
+            return {
+                useAbleTdsAmount: this.getUseableTDSAmount(adjustedBillingTransactions),
+                usedTdsAmount: this.getUsedTDSAmount(adjustedBillingTransactions),
+                useableRecieptAmount: this.getUseableRecieptAmount(adjustedBillingTransactions),
+                usedRecieptAmount: this.getUsedRecieptAmount(adjustedBillingTransactions),
+                totalUsableAmount: this.getUseableAmount(adjustedBillingTransactions),
+                totalUsedAmount: this.getUsedAmount(adjustedBillingTransactions),
+                totalTDSAmount: this.getTotalTDSAmount(adjustedBillingTransactions),
+                totalRecieptAmount: this.getTotalRecieptAmount(adjustedBillingTransactions),
+            };
+        }
+        return {};
+    }
+    getUseableTDSAmount(adjustedBillingTransactions) {
+        return ((0, utils_1.getDecimalNumberFromString)(this.tdsAmount) -
+            this.getUsedTDSAmount(adjustedBillingTransactions));
+    }
+    getUsedTDSAmount(adjustedBillingTransactions) {
+        return (0, utils_1.sumNormalised)(adjustedBillingTransactions.filter((transaction) => transaction.type === billing_transaction_enum_1.BillingTransactionType.TDS), "amount");
+    }
+    getTotalTDSAmount(adjustedBillingTransactions) {
+        return (this.getUseableTDSAmount(adjustedBillingTransactions) +
+            this.getUsedTDSAmount(adjustedBillingTransactions));
+    }
+    getTotalRecieptAmount(adjustedBillingTransactions) {
+        return (this.getUseableRecieptAmount(adjustedBillingTransactions) +
+            this.getUsedRecieptAmount(adjustedBillingTransactions));
+    }
+    getUseableRecieptAmount(adjustedBillingTransactions) {
+        return ((0, utils_1.getDecimalNumberFromString)(this.totalAmountPaid) -
+            this.getUsedRecieptAmount(adjustedBillingTransactions));
+    }
+    getUsedRecieptAmount(adjustedBillingTransactions) {
+        return (0, utils_1.sumNormalised)(adjustedBillingTransactions.filter((transaction) => transaction.type === billing_transaction_enum_1.BillingTransactionType.RECEIPT), "amount");
+    }
+    getUseableAmount(adjustedBillingTransactions) {
+        return (this.getUseableRecieptAmount(adjustedBillingTransactions) +
+            this.getUseableTDSAmount(adjustedBillingTransactions));
+    }
+    getUsedAmount(adjustedBillingTransactions) {
+        return (this.getUsedRecieptAmount(adjustedBillingTransactions) +
+            this.getUsedTDSAmount(adjustedBillingTransactions));
+    }
+    getTotalAmountRecieved() {
+        var _a, _b, _c, _d;
+        const amountRecieved = (0, utils_1.sumNormalised)((_b = (_a = this.billingTransactions) === null || _a === void 0 ? void 0 : _a.filter((transaction) => [billing_transaction_enum_1.BillingTransactionType.TDS, billing_transaction_enum_1.BillingTransactionType.RECEIPT].includes(transaction.type))) !== null && _b !== void 0 ? _b : [], "amount") -
+            (0, utils_1.sumNormalised)((_d = (_c = this.billingTransactions) === null || _c === void 0 ? void 0 : _c.filter((transaction) => transaction.type === billing_transaction_enum_1.BillingTransactionType.REFUND)) !== null && _d !== void 0 ? _d : [], "amount");
+        return amountRecieved;
+    }
+    getTotalRecievableAmount() {
+        var _a, _b;
+        return ((0, utils_1.getDecimalNumberFromString)(this.totalAmount) -
+            (this.getTotalAmountRecieved() +
+                (0, utils_1.sumNormalised)((_b = (_a = this.billingTransactions) === null || _a === void 0 ? void 0 : _a.filter((transaction) => [
+                    billing_transaction_enum_1.BillingTransactionType.CREDIT_NOTE,
+                    billing_transaction_enum_1.BillingTransactionType.WRITE_OFF,
+                ].includes(transaction.type))) !== null && _b !== void 0 ? _b : [], "amount")));
+    }
+    validateAdvanceBillingId(adjustedBillingTransactions) {
+        const index = adjustedBillingTransactions.findIndex((item) => item.advanceBillingId === null);
+        if (index !== -1) {
+            throw new exceptions_1.AppBadRequestException({
+                key: error_key_enum_1.ErrorKeyEnum.ADVANCE_BILLING_ID,
+                message: [
+                    `advanceBillingId is missing in transaction at index ${index}`,
+                ],
+            });
+        }
+    }
+    getApprovedBillingTransactionsTotalAmount() {
+        var _a, _b;
+        return (0, utils_1.sumNormalised)((_b = (_a = this.billingTransactions) === null || _a === void 0 ? void 0 : _a.filter((entity) => ![
+            billing_transaction_status_enum_1.BillingTransactionStatusEnum.CREDITNOTE_APPROVAL_PENDING,
+            billing_transaction_status_enum_1.BillingTransactionStatusEnum.WRITEOFF_APPROVAL_PENDING,
+        ].includes(entity.status))) !== null && _b !== void 0 ? _b : [], "amount");
+    }
 }
 exports.BillingEntityModel = BillingEntityModel;
 BillingEntityModel.relationConfigs = [

package/dist/src/entities/model/interface/billing.model.interface.d.ts

@@ -0,0 +1,10 @@
+export interface IAdvanceBillingTransactionsSummary {
+    useAbleTdsAmount: number;
+    usedTdsAmount: number;
+    useableRecieptAmount: number;
+    usedRecieptAmount: number;
+    totalUsableAmount: number;
+    totalUsedAmount: number;
+    totalTDSAmount: number;
+    totalRecieptAmount: number;
+}

package/dist/src/entities/model/interface/billing.model.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/enums/error.key.enum.d.ts

@@ -22,5 +22,6 @@ export declare enum ErrorKeyEnum {
     WORK_FROM_HOME_FLOW = "WORK_FROM_HOME_FLOW",
     WORK_FROM_HOME_KEY = "WORK_FROM_HOME_KEY",
     RELATED_ENTITIES = "RELATED_ENTITIES",
-    USER_ROLE = "USER_ROLE"
+    USER_ROLE = "USER_ROLE",
+    ADVANCE_BILLING_ID = "ADVANCE_BILLING_ID"
 }

package/dist/src/enums/error.key.enum.js

@@ -27,4 +27,5 @@ var ErrorKeyEnum;
     ErrorKeyEnum["WORK_FROM_HOME_KEY"] = "WORK_FROM_HOME_KEY";
     ErrorKeyEnum["RELATED_ENTITIES"] = "RELATED_ENTITIES";
     ErrorKeyEnum["USER_ROLE"] = "USER_ROLE";
+    ErrorKeyEnum["ADVANCE_BILLING_ID"] = "ADVANCE_BILLING_ID";
 })(ErrorKeyEnum || (exports.ErrorKeyEnum = ErrorKeyEnum = {}));

package/dist/src/misc/config/app-file-config.d.ts

@@ -0,0 +1,7 @@
+export interface IAppFileConfig {
+    name: string;
+    size: number;
+    count?: number;
+    isRequired?: boolean;
+    format: string[];
+}

package/dist/src/misc/config/app-file-config.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/misc/index.d.ts

@@ -1,4 +1,6 @@
+export * from "./config/app-file-config";
 export * from "./interface/modify.interface";
 export * from "./interface/upload-multer-file.interface";
-export * from "./type/arrayed.type";
 export * from "./models/dto-validation-type";
+export * from "./type/arrayed.type";
+export * from "./type/delete-document-details.type";

package/dist/src/misc/index.js

@@ -14,7 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config/app-file-config"), exports);
 __exportStar(require("./interface/modify.interface"), exports);
 __exportStar(require("./interface/upload-multer-file.interface"), exports);
-__exportStar(require("./type/arrayed.type"), exports);
 __exportStar(require("./models/dto-validation-type"), exports);
+__exportStar(require("./type/arrayed.type"), exports);
+__exportStar(require("./type/delete-document-details.type"), exports);

package/dist/src/misc/type/delete-document-details.type.d.ts

@@ -0,0 +1 @@
+export type IDeleteDocumentDetails<T> = Partial<Record<keyof T, string[]>>;

package/dist/src/misc/type/delete-document-details.type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/utils/helper.fn.util.d.ts

@@ -333,20 +333,65 @@ export declare function convertToNumberType<T extends string | number>(value: T)
  * // Returns: "1970-01-01 05:30:00"  // if your system timezone is IST (UTC+5:30)
  */
 export declare function epochToDateTime(epoch: number): string;
+export declare function dateTimeToEpoch(dateInput: string | Date): number;
+export declare function checkEmptyObj<T extends Record<string, any>>(obj: T): boolean;
 /**
- * Converts a JavaScript Date object into epoch seconds (UNIX timestamp).
+ * Normalises the value of a given key in an array of objects.
+ *
+ * If the value is a string or number, it is converted into a decimal number
+ * using `getDecimalNumberFromString`. Other value types are left unchanged.
+ *
+ * @template T
  *
- * @param {Date} date - A JavaScript Date instance.
+ * @param {T[]} input - Array of objects to be normalised.
+ * @param {keyof T} key - The object key whose value should be normalised.
  *
- * @returns {number} The corresponding epoch time in seconds (number of seconds since 1970-01-01 00:00:00 UTC).
+ * @returns {T[]} A new array with the specified key normalised.
  *
  * @example
- * toEpochSeconds(new Date("2025-09-30 11:19:25"));
- * // Returns: 1759211965
+ * getNormalisedFromKey([{ amount: "1,200.50" }], "amount");
+ * // Returns: [{ amount: 1200.5 }]
+ */
+export declare function getNormalisedFromKey<T>(input: T[], key: keyof T): T[];
+/**
+ * Normalises the value of a given key in an array of objects
+ * and returns the sum of the normalised values.
+ *
+ * Internally, this function first normalises the values using
+ * `getNormalisedFromKey` and then sums them using `sumArray`.
+ *
+ * @template T
+ *
+ * @param {T[]} input - Array of objects whose values should be summed.
+ * @param {keyof T} key - The object key to normalise and sum.
+ *
+ * @returns {number} The sum of the normalised values for the given key.
  *
  * @example
- * toEpochSeconds(new Date());
- * // Returns: current epoch time in seconds
+ * sumNormalised([{ amount: "100" }, { amount: "200.5" }], "amount");
+ * // Returns: 300.5
  */
-export declare function toEpochSeconds(date: Date): number;
-export declare function dateTimeToEpoch(dateInput: string | Date): number;
+export declare function sumNormalised<T>(input: T[], key: keyof T): number;
+/**
+ * Converts a camelCase or PascalCase string into a human-readable
+ * title-cased string with spaces.
+ *
+ * This is useful for generating user-friendly field names in
+ * validation or error messages.
+ *
+ * @example
+ * camelCaseToTitle("noteDocument");
+ * // → "Note Document"
+ *
+ * @example
+ * camelCaseToTitle("additionalDocuments");
+ * // → "Additional Documents"
+ *
+ * @example
+ * camelCaseToTitle("PDFDocument");
+ * // → "PDF Document"
+ *
+ * @param input - The camelCase or PascalCase string to convert
+ * @returns A title-cased, space-separated string
+ */
+export declare function camelCaseToTitle(input: string): string;

package/dist/src/utils/helper.fn.util.js

@@ -42,13 +42,16 @@ exports.getDecimalNumberFromString = getDecimalNumberFromString;
 exports.hasProperty = hasProperty;
 exports.convertToNumberType = convertToNumberType;
 exports.epochToDateTime = epochToDateTime;
-exports.toEpochSeconds = toEpochSeconds;
 exports.dateTimeToEpoch = dateTimeToEpoch;
+exports.checkEmptyObj = checkEmptyObj;
+exports.getNormalisedFromKey = getNormalisedFromKey;
+exports.sumNormalised = sumNormalised;
+exports.camelCaseToTitle = camelCaseToTitle;
 const date_fns_1 = require("date-fns");
+const lodash_1 = require("lodash");
 const util_constants_1 = require("../constants/util.constants");
 const error_key_enum_1 = require("../enums/error.key.enum");
 const exceptions_1 = require("../exceptions");
-const lodash_1 = require("lodash");
 function groupByFunction(list, keyGetter) {
     const map = new Map();
     list.forEach((item) => {
@@ -687,25 +690,84 @@ function epochToDateTime(epoch) {
     const date = new Date(epoch * 1000); // JS Date expects milliseconds
     return (0, date_fns_1.format)(date, "yyyy-MM-dd HH:mm:ss");
 }
+function dateTimeToEpoch(dateInput) {
+    const date = typeof dateInput === "string" ? new Date(dateInput) : dateInput;
+    return Math.floor(date.getTime() / 1000);
+}
+function checkEmptyObj(obj) {
+    return Object.keys(obj).length === 0;
+}
 /**
- * Converts a JavaScript Date object into epoch seconds (UNIX timestamp).
+ * Normalises the value of a given key in an array of objects.
+ *
+ * If the value is a string or number, it is converted into a decimal number
+ * using `getDecimalNumberFromString`. Other value types are left unchanged.
  *
- * @param {Date} date - A JavaScript Date instance.
+ * @template T
  *
- * @returns {number} The corresponding epoch time in seconds (number of seconds since 1970-01-01 00:00:00 UTC).
+ * @param {T[]} input - Array of objects to be normalised.
+ * @param {keyof T} key - The object key whose value should be normalised.
+ *
+ * @returns {T[]} A new array with the specified key normalised.
  *
  * @example
- * toEpochSeconds(new Date("2025-09-30 11:19:25"));
- * // Returns: 1759211965
+ * getNormalisedFromKey([{ amount: "1,200.50" }], "amount");
+ * // Returns: [{ amount: 1200.5 }]
+ */
+function getNormalisedFromKey(input, key) {
+    return input.map((inp) => (Object.assign(Object.assign({}, inp), { [key]: typeof inp[key] === "string" || typeof inp[key] === "number"
+            ? getDecimalNumberFromString(inp[key])
+            : inp[key] })));
+}
+/**
+ * Normalises the value of a given key in an array of objects
+ * and returns the sum of the normalised values.
+ *
+ * Internally, this function first normalises the values using
+ * `getNormalisedFromKey` and then sums them using `sumArray`.
+ *
+ * @template T
+ *
+ * @param {T[]} input - Array of objects whose values should be summed.
+ * @param {keyof T} key - The object key to normalise and sum.
+ *
+ * @returns {number} The sum of the normalised values for the given key.
  *
  * @example
- * toEpochSeconds(new Date());
- * // Returns: current epoch time in seconds
+ * sumNormalised([{ amount: "100" }, { amount: "200.5" }], "amount");
+ * // Returns: 300.5
  */
-function toEpochSeconds(date) {
-    return Math.floor(date.getTime() / 1000);
+function sumNormalised(input, key) {
+    return sumArray(getNormalisedFromKey(input, key), key);
 }
-function dateTimeToEpoch(dateInput) {
-    const date = typeof dateInput === "string" ? new Date(dateInput) : dateInput;
-    return Math.floor(date.getTime() / 1000);
+/**
+ * Converts a camelCase or PascalCase string into a human-readable
+ * title-cased string with spaces.
+ *
+ * This is useful for generating user-friendly field names in
+ * validation or error messages.
+ *
+ * @example
+ * camelCaseToTitle("noteDocument");
+ * // → "Note Document"
+ *
+ * @example
+ * camelCaseToTitle("additionalDocuments");
+ * // → "Additional Documents"
+ *
+ * @example
+ * camelCaseToTitle("PDFDocument");
+ * // → "PDF Document"
+ *
+ * @param input - The camelCase or PascalCase string to convert
+ * @returns A title-cased, space-separated string
+ */
+function camelCaseToTitle(input) {
+    if (input.length === 0)
+        return input;
+    return (input
+        // insert space before capital letters
+        .replace(/([a-z])([A-Z])/g, "$1 $2")
+        // capitalize first letter
+        .replace(/^./, (char) => char.toUpperCase()));
 }

package/package.json

@@ -1,37 +1,37 @@
-{
-  "name": "law-common",
-  "version": "10.45.3-beta.9",
-  "description": "",
-  "main": "dist/index.js",
-  "files": [
-    "dist/**/*"
-  ],
-  "scripts": {
-    "clean": "rm -rf dist",
-    "build": "npm run clean && tsc",
-    "publish:beta": "npm version prerelease --preid beta && git push && npm run build && npm publish --tag beta",
-    "publish:patch": "npm version patch && git push && npm run build && npm publish",
-    "publish:minor": "npm version minor && git push && npm run build && npm publish",
-    "publish:major": "npm version major && git push && npm run build && npm publish",
-    "link": "npm run build && npm link",
-    "test": "jest"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "devDependencies": {
-    "@types/jest": "^29.5.13",
-    "@types/lodash": "^4.17.21",
-    "@types/node": "^22.6.1",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.2.5",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.6.2"
-  },
-  "dependencies": {
-    "@types/express": "^5.0.0",
-    "@types/multer": "^1.4.12",
-    "date-fns": "^4.1.0",
-    "lodash": "4.17.21"
-  }
-}
+{
+  "name": "law-common",
+  "version": "10.46.0",
+  "description": "",
+  "main": "dist/index.js",
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc",
+    "publish:beta": "npm version prerelease --preid beta && git push && npm run build && npm publish --tag beta",
+    "publish:patch": "npm version patch && git push && npm run build && npm publish",
+    "publish:minor": "npm version minor && git push && npm run build && npm publish",
+    "publish:major": "npm version major && git push && npm run build && npm publish",
+    "link": "npm run build && npm link",
+    "test": "jest"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/jest": "^29.5.13",
+    "@types/lodash": "^4.17.21",
+    "@types/node": "^22.6.1",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.6.2"
+  },
+  "dependencies": {
+    "@types/express": "^5.0.0",
+    "@types/multer": "^1.4.12",
+    "date-fns": "^4.1.0",
+    "lodash": "4.17.21"
+  }
+}