law-common 10.45.3-beta.9 → 10.46.1-beta.0

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/entity.model.interface.js

@@ -26,12 +26,14 @@ const holiday_entity_model_1 = require("./holiday.entity.model");
 const leave_entity_model_1 = require("./leave.entity.model");
 const leave_count_entity_model_1 = require("./leave_count.entity.model");
 const organization_type_entity_model_1 = require("./organization_type.entity.model");
+const organization_type_tds_rate_mapping_entity_model_1 = require("./organization_type_tds_rate_mapping.entity.model");
 const project_user_mapping_entity_model_1 = require("./project-user-mapping.entity.model");
 const project_entity_model_1 = require("./project.entity.model");
 const reimbursement_expense_entity_model_1 = require("./reimbursement-expense.entity.model");
 const reimbursement_entity_model_1 = require("./reimbursement.entity.model");
 const state_entity_model_1 = require("./state.entity.model");
 const task_entity_model_1 = require("./task.entity.model");
+const tds_rate_entity_model_1 = require("./tds_rate.entity.model");
 const timesheet_entity_model_1 = require("./timesheet.entity.model");
 const user_entity_model_1 = require("./user.entity.model");
 function mapToIndex(entityMap) {
@@ -86,6 +88,8 @@ exports.entityEnumToEntityModel = {
     [entity_utils_interface_1.EntityEnum.STATE]: state_entity_model_1.StateEntityModel.fromEntity,
     [entity_utils_interface_1.EntityEnum.GST_RATE]: gst_rate_entity_model_1.GstRateEntityModel.fromEntity,
     [entity_utils_interface_1.EntityEnum.ORGANIZATION_TYPE]: organization_type_entity_model_1.OrganizationTypeEntityModel.fromEntity,
+    [entity_utils_interface_1.EntityEnum.TDS_RATE]: tds_rate_entity_model_1.TdsRateEntityModel.fromEntity,
+    [entity_utils_interface_1.EntityEnum.ORGANIZATION_TYPE_TDS_RATE_MAPPING]: organization_type_tds_rate_mapping_entity_model_1.OrganizationTypeTdsRateMappingEntityModel.fromEntity,
 };
 function entityMapToModels(entityMap) {
     for (const entityName in entityMap) {

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/entities/model/organization_type_tds_rate_mapping.entity.model.autocode.js

@@ -0,0 +1,24 @@
+"use strict";
+// import { EntityEnum } from "../interface/entity.utils.interface";
+// import { BaseEntityModel } from "./base.entity.model";
+// export class OrganizationTypeTdsRateMappingEntityModel
+//   extends BaseEntityModel<EntityEnum.ORGANIZATION_TYPE_TDS_RATE_MAPPING>
+//   implements IOrganizationTypeTdsRateMappingEntity
+// {
+//   id: number = 0;
+//   organizationTypeId: number = 0;
+//   tdsRateId: number = 0;
+//   createdOn: number = 0;
+//   updatedOn: number = 0;
+//   createdBy: number = 0;
+//   updatedBy: number = 0;
+//   static relationConfigs = [];
+//   static fromEntity(entity: IOrganizationTypeTdsRateMappingEntity): OrganizationTypeTdsRateMappingEntityModel {
+//     const result = new OrganizationTypeTdsRateMappingEntityModel(EntityEnum.ORGANIZATION_TYPE_TDS_RATE_MAPPING);
+//     Object.assign(result, entity);
+//     return result;
+//   }
+//   getRelationConfigs(): any[] {
+//     return this.constructor.prototype.constructor.relationConfigs || [];
+//   }
+// }

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

@@ -0,0 +1,20 @@
+import { EntityEnum, EnumEntityType } from "../interface/entity.utils.interface";
+import { IOrganizationTypeTdsRateMappingEntity } from "../interface/organization_type_tds_rate_mapping.entity.interface";
+import { RelationConfigs } from "../interface/relation-config.interface";
+import { BaseEntityModel } from "./base.entity.model";
+import { OrganizationTypeEntityModel } from "./organization_type.entity.model";
+import { TdsRateEntityModel } from "./tds_rate.entity.model";
+export declare class OrganizationTypeTdsRateMappingEntityModel extends BaseEntityModel<EntityEnum.ORGANIZATION_TYPE_TDS_RATE_MAPPING> implements IOrganizationTypeTdsRateMappingEntity {
+    id: number;
+    organizationTypeId: number;
+    tdsRateId: number;
+    createdOn: number;
+    updatedOn: number;
+    createdBy: number;
+    updatedBy: number;
+    tdsRate?: TdsRateEntityModel;
+    organizationType?: OrganizationTypeEntityModel;
+    static relationConfigs: RelationConfigs<[EntityEnum.TDS_RATE, EntityEnum.ORGANIZATION_TYPE], EnumEntityType<EntityEnum.ORGANIZATION_TYPE_TDS_RATE_MAPPING>>;
+    static fromEntity(entity: IOrganizationTypeTdsRateMappingEntity): OrganizationTypeTdsRateMappingEntityModel;
+    getRelationConfigs(): any[];
+}

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrganizationTypeTdsRateMappingEntityModel = void 0;
+const relation_type_enum_1 = require("../enums/relation-type.enum");
+const entity_utils_interface_1 = require("../interface/entity.utils.interface");
+const base_entity_model_1 = require("./base.entity.model");
+class OrganizationTypeTdsRateMappingEntityModel extends base_entity_model_1.BaseEntityModel {
+    constructor() {
+        super(...arguments);
+        this.id = 0;
+        this.organizationTypeId = 0;
+        this.tdsRateId = 0;
+        this.createdOn = 0;
+        this.updatedOn = 0;
+        this.createdBy = 0;
+        this.updatedBy = 0;
+    }
+    static fromEntity(entity) {
+        const result = new OrganizationTypeTdsRateMappingEntityModel(entity_utils_interface_1.EntityEnum.ORGANIZATION_TYPE_TDS_RATE_MAPPING);
+        Object.assign(result, entity);
+        return result;
+    }
+    getRelationConfigs() {
+        return this.constructor.prototype.constructor.relationConfigs || [];
+    }
+}
+exports.OrganizationTypeTdsRateMappingEntityModel = OrganizationTypeTdsRateMappingEntityModel;
+OrganizationTypeTdsRateMappingEntityModel.relationConfigs = [
+    {
+        name: entity_utils_interface_1.EntityEnum.TDS_RATE,
+        relation: relation_type_enum_1.RelationType.ONE,
+        key: "tdsRate",
+        mapKeyConfig: {
+            relationKey: "id",
+            key: "tdsRateId",
+        },
+    },
+    {
+        name: entity_utils_interface_1.EntityEnum.ORGANIZATION_TYPE,
+        relation: relation_type_enum_1.RelationType.ONE,
+        key: "organizationType",
+        mapKeyConfig: {
+            relationKey: "id",
+            key: "organizationTypeId",
+        },
+    },
+];

package/dist/src/entities/model/tds_rate.entity.model.autocode.js

@@ -0,0 +1,37 @@
+"use strict";
+// import { EntityEnum } from "../interface/entity.utils.interface";
+// import { BaseEntityModel } from "./base.entity.model";
+// export class TdsRateEntityModel extends BaseEntityModel<EntityEnum.TDS_RATE> implements ITdsRateEntity {
+//   id: number = 0;
+//   section: string = "";
+//   code: string = "";
+//   description?: string;
+//   panAvailableRate: number = 0;
+//   panNotAvailableRate: number = 0;
+//   effectiveFrom: number = 0;
+//   status: TdsRateStatusEnum = TdsRateStatusEnum.ACTIVE;
+//   createdOn: number = 0;
+//   updatedOn: number = 0;
+//   createdBy: number = 0;
+//   updatedBy: number = 0;
+//   organizationTypeTdsRateMappings?: OrganizationTypeTdsRateMappingEntityModel[];
+//   static relationConfigs: RelationConfigs<[EntityEnum.ORGANIZATION_TYPE_TDS_RATE_MAPPING], EnumEntityType<EntityEnum.TDS_RATE>> = [
+//     {
+//       name: EntityEnum.ORGANIZATION_TYPE_TDS_RATE_MAPPING,
+//       relation: RelationType.MANY,
+//       key: "organizationTypeTdsRateMappings",
+//       mapKeyConfig: {
+//         relationKey: "tdsRateId",
+//         key: "id",
+//       },
+//     },
+//   ];
+//   static fromEntity(entity: ITdsRateEntity): TdsRateEntityModel {
+//     const result = new TdsRateEntityModel(EntityEnum.TDS_RATE);
+//     Object.assign(result, entity);
+//     return result;
+//   }
+//   getRelationConfigs(): any[] {
+//     return this.constructor.prototype.constructor.relationConfigs || [];
+//   }
+// }

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

@@ -0,0 +1,24 @@
+import { TdsRateStatusEnum } from "../enums/tds_rate_status_enum";
+import { EntityEnum, EnumEntityType } from "../interface/entity.utils.interface";
+import { RelationConfigs } from "../interface/relation-config.interface";
+import { ITdsRateEntity } from "../interface/tds_rate.entity.interface";
+import { BaseEntityModel } from "./base.entity.model";
+import { OrganizationTypeTdsRateMappingEntityModel } from "./organization_type_tds_rate_mapping.entity.model";
+export declare class TdsRateEntityModel extends BaseEntityModel<EntityEnum.TDS_RATE> implements ITdsRateEntity {
+    id: number;
+    section: string;
+    code: string;
+    description?: string;
+    panAvailableRate: number;
+    panNotAvailableRate: number;
+    effectiveFrom: number;
+    status: TdsRateStatusEnum;
+    createdOn: number;
+    updatedOn: number;
+    createdBy: number;
+    updatedBy: number;
+    organizationTypeTdsRateMappings?: OrganizationTypeTdsRateMappingEntityModel[];
+    static relationConfigs: RelationConfigs<[EntityEnum.ORGANIZATION_TYPE_TDS_RATE_MAPPING], EnumEntityType<EntityEnum.TDS_RATE>>;
+    static fromEntity(entity: ITdsRateEntity): TdsRateEntityModel;
+    getRelationConfigs(): any[];
+}

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

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TdsRateEntityModel = void 0;
+const relation_type_enum_1 = require("../enums/relation-type.enum");
+const tds_rate_status_enum_1 = require("../enums/tds_rate_status_enum");
+const entity_utils_interface_1 = require("../interface/entity.utils.interface");
+const base_entity_model_1 = require("./base.entity.model");
+class TdsRateEntityModel extends base_entity_model_1.BaseEntityModel {
+    constructor() {
+        super(...arguments);
+        this.id = 0;
+        this.section = "";
+        this.code = "";
+        this.panAvailableRate = 0;
+        this.panNotAvailableRate = 0;
+        this.effectiveFrom = 0;
+        this.status = tds_rate_status_enum_1.TdsRateStatusEnum.ACTIVE;
+        this.createdOn = 0;
+        this.updatedOn = 0;
+        this.createdBy = 0;
+        this.updatedBy = 0;
+    }
+    static fromEntity(entity) {
+        const result = new TdsRateEntityModel(entity_utils_interface_1.EntityEnum.TDS_RATE);
+        Object.assign(result, entity);
+        return result;
+    }
+    getRelationConfigs() {
+        return this.constructor.prototype.constructor.relationConfigs || [];
+    }
+}
+exports.TdsRateEntityModel = TdsRateEntityModel;
+TdsRateEntityModel.relationConfigs = [
+    {
+        name: entity_utils_interface_1.EntityEnum.ORGANIZATION_TYPE_TDS_RATE_MAPPING,
+        relation: relation_type_enum_1.RelationType.MANY,
+        key: "organizationTypeTdsRateMappings",
+        mapKeyConfig: {
+            relationKey: "tdsRateId",
+            key: "id",
+        },
+    },
+];

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,6 +1,6 @@
 {
   "name": "law-common",
-  "version": "10.45.3-beta.9",
+  "version": "10.46.1-beta.0",
   "description": "",
   "main": "dist/index.js",
   "files": [