law-common 10.16.1 → 10.17.0

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

@@ -1,4 +1,4 @@
-import { BillingImpactEnum, BillingStatusEnum, IBillingEntity, IEntityCreateDto } from "../../entities";
+import { BillingImpactEnum, BillingStatusEnum, IBillingEntity, IBillingTimesheetEntity, IEntityCreateDto, IProjectEntity, ITimesheetEntity } from "../../entities";
 export type IBillingCreateExclude = "paymentStatus" | "status" | "writeoffAmount" | "tdsAmount" | "totalAmountPaid" | "creditNoteAmount" | "invoicePdfUrl";
 export interface IBillingCreateDto extends Omit<IEntityCreateDto<IBillingEntity>, IBillingCreateExclude> {
     timesheets: IBillingTimesheetsDto;
@@ -24,3 +24,8 @@ export interface IBillingTimesheetsDto {
     updateDetails: IBillingTimesheetUpdateDeleteDetailDto[];
     deleteDetails: IBillingTimesheetUpdateDeleteDetailDto[];
 }
+export interface IBillingEntityCreateDtoValidationData {
+    projectEntity: IProjectEntity;
+    billingTimesheetEntities: IBillingTimesheetEntity[];
+    timesheetEntities: ITimesheetEntity[];
+}

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

@@ -1,4 +1,5 @@
-import { BillingActionsEnum, IBillingEntity, IBillingEntityCreateDtoValidationData, IBillingTimesheetUpdateDto, IEntityUpdateDto } from "../../entities";
+import { BillingActionsEnum, IBillingEntity, IBillingTimesheetUpdateDto, IEntityUpdateDto } from "../../entities";
+import { IBillingEntityCreateDtoValidationData } from "./billing.create.dto.interface";
 export interface IBillingUpdateDto extends IEntityUpdateDto<IBillingEntity> {
 }
 export interface IUpdateBillingDto extends IBillingUpdateDto {

package/dist/src/constants/entity_constants.d.ts

@@ -11,3 +11,4 @@ export declare const usersToExcludeFromSearchResponse: string[];
 export declare const systemUsers: string[];
 export declare const reimbursementExpenseProjectUserInactiveBuffer: number;
 export declare const annualPaidLeaves = 24;
+export declare const designationPriorityOrder: Record<string, number>;

package/dist/src/constants/entity_constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.annualPaidLeaves = exports.reimbursementExpenseProjectUserInactiveBuffer = exports.systemUsers = exports.usersToExcludeFromSearchResponse = exports.freezeTimesheetAfterBillingStatus = exports.leaveImplicitDays = exports.reimbursementPaymentProcessorPermissionName = exports.toDoListMinimumEstimatedDuration = exports.timesheetMinimumTotalDuration = exports.timesheetEnterThreshold = exports.timesheetThreshold = exports.timesheetViewThreshold = void 0;
+exports.designationPriorityOrder = exports.annualPaidLeaves = exports.reimbursementExpenseProjectUserInactiveBuffer = exports.systemUsers = exports.usersToExcludeFromSearchResponse = exports.freezeTimesheetAfterBillingStatus = exports.leaveImplicitDays = exports.reimbursementPaymentProcessorPermissionName = exports.toDoListMinimumEstimatedDuration = exports.timesheetMinimumTotalDuration = exports.timesheetEnterThreshold = exports.timesheetThreshold = exports.timesheetViewThreshold = void 0;
 const entities_1 = require("../entities");
 exports.timesheetViewThreshold = "timesheetViewThreshold";
 exports.timesheetThreshold = "timesheetThreshold";
@@ -14,3 +14,9 @@ exports.usersToExcludeFromSearchResponse = ["DB migration"];
 exports.systemUsers = ["DB migration"];
 exports.reimbursementExpenseProjectUserInactiveBuffer = 24 * 60;
 exports.annualPaidLeaves = 24;
+exports.designationPriorityOrder = {
+    seniorPartner: 1,
+    partner: 2,
+    seniorAssociate: 3,
+    associate: 4,
+};

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

@@ -1,10 +1,9 @@
+import { CurrencyEnum } from "../../enums";
 import { BillingStatusEnum } from "../enums/billing.status.enum";
 import { BillingInvoiceTypeEnum } from "../enums/billing_invoice_type.enum";
 import { PaymentStatusEnum } from "../enums/payment_status.enum";
 import { IAuditColumnEntity } from "./audit-column.entity.interface";
 import { EntityEnum, IEntityFilterData } from "./entity.utils.interface";
-import { IProjectEntity } from "./project.entity.interface";
-import { ITimesheetEntity } from "./timesheet.entity.interface";
 export interface IBillingEntity extends IAuditColumnEntity {
     id: number;
     startDate: string;
@@ -24,12 +23,11 @@ export interface IBillingEntity extends IAuditColumnEntity {
     invoicePdfUrl?: string | null;
     invoiceContactName: string;
     bankId: number;
+    conversionRate?: number;
+    particulars: string;
+    currency: CurrencyEnum;
 }
 export interface IBillingEntityFilterDto extends IEntityFilterData<IBillingEntity> {
 }
-export interface IBillingEntityCreateDtoValidationData {
-    projectEntity: IProjectEntity;
-    timesheetEntities: ITimesheetEntity[];
-}
 export declare const billingRelations: EntityEnum[];
 export declare const billingEntities: EntityEnum[];

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

@@ -39,7 +39,8 @@ export interface IBillingTimesheetDetailsArray extends Array<IBillingTimesheetDe
 export interface IBillingTimesheetEntityFilterDto extends IEntityFilterData<IBillingTimesheetEntity> {
 }
 export interface IBillingTimesheetEntityCreateDtoValidationResult {
-    timesheets: ITimesheetEntity[];
+    billingTimesheetEntities: IBillingTimesheetEntity[];
+    timesheetEntities: ITimesheetEntity[];
 }
 export interface IBillingTimesheetUpdateDto extends IEntityUpdateDto<IBillingTimesheetEntity> {
 }

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

@@ -37,17 +37,19 @@ export interface IProjectHourlyRate {
     rate: number;
     unit: TimeUnitEnum.HOUR;
 }
-export interface IProjectFixedMonthlyRate {
+export interface IProjectFixedTypeRate {
     rate: number;
-    unit: TimeUnitEnum.MONTH;
+    unit: TimeUnitEnum;
     maxEstimatedHours: number;
+    extraHoursRate: number;
 }
 export interface IProjectAdhocRate {
     rate: number;
     maxEstimatedHours: number;
+    extraHoursRate: number;
 }
 export interface IProjectCreateDtoExtra {
-    projectBillingRate: IProjectHourlyRate[] | IProjectFixedMonthlyRate | IProjectAdhocRate;
+    projectBillingRate: IProjectHourlyRate[] | IProjectFixedTypeRate | IProjectAdhocRate;
 }
 export interface IProjectEntityCreateDto extends Omit<IEntityCreateDto<IProjectEntity>, IProjectExclude>, IProjectEntityDependent, IProjectCreateDtoExtra {
 }

package/dist/src/enums/time.unit.enum.d.ts

@@ -5,6 +5,7 @@ export declare enum TimeUnitEnum {
     DAY = "DAY",
     WEEK = "WEEK",
     MONTH = "MONTH",
+    QUARTER = "QUARTER",
     YEAR = "YEAR"
 }
 export declare namespace TimeUnitEnum {

package/dist/src/enums/time.unit.enum.js

@@ -11,6 +11,7 @@ var TimeUnitEnum;
     TimeUnitEnum["DAY"] = "DAY";
     TimeUnitEnum["WEEK"] = "WEEK";
     TimeUnitEnum["MONTH"] = "MONTH";
+    TimeUnitEnum["QUARTER"] = "QUARTER";
     TimeUnitEnum["YEAR"] = "YEAR";
 })(TimeUnitEnum || (exports.TimeUnitEnum = TimeUnitEnum = {}));
 (function (TimeUnitEnum) {
@@ -28,6 +29,8 @@ var TimeUnitEnum;
                 return 60 * 24 * 7;
             case TimeUnitEnum.MONTH:
                 return 60 * 24 * 30;
+            case TimeUnitEnum.QUARTER:
+                return 60 * 24 * 30 * 3;
             case TimeUnitEnum.YEAR:
                 return 60 * 24 * 365;
         }
@@ -55,15 +58,16 @@ var TimeUnitEnum;
                 return TimeUnitEnum.YEAR;
             default:
                 throw new exceptions_1.AppBadRequestException({
-                    message: [`Invalid time unit: ${value}. Valid values are: ${TimeUnitEnum.getNames().join(", ")}`],
+                    message: [
+                        `Invalid time unit: ${value}. Valid values are: ${TimeUnitEnum.getNames().join(", ")}`,
+                    ],
                     key: error_key_enum_1.ErrorKeyEnum.TIME_UNIT,
                 });
         }
     }
     TimeUnitEnum.parse = parse;
     function getNames() {
-        return Object.values(TimeUnitEnum).filter(value => typeof value === 'string');
-        ;
+        return Object.values(TimeUnitEnum).filter((value) => typeof value === "string");
     }
     TimeUnitEnum.getNames = getNames;
 })(TimeUnitEnum || (exports.TimeUnitEnum = TimeUnitEnum = {}));

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

@@ -176,3 +176,39 @@ export declare function transformDate<T extends {
 export declare function capitalizeFirstWord(str: string): string;
 export declare function getEntitiesFromSearchV2Response<E extends EntityEnum, // Enum key like EntityEnum.USER, EntityEnum.PROJECT, etc.
 T extends EnumEntityType<E>>(searchResponseV2: IBaseEntityServiceResponse<EnumEntityType<EntityEnum>>, entityEnumKey: E, EntityClass: new () => T): T[];
+/**
+ * Checks if two decimal numbers are approximately equal within a given tolerance.
+ *
+ * @param {number} firstValue - The first number to compare.
+ * @param {number} secondValue - The second number to compare.
+ * @param {number} allowedDifference - The maximum difference allowed for the numbers
+ *                                     to be considered equal.
+ *
+ * @returns {boolean} Returns `true` if the numbers are within the allowed difference;
+ * otherwise, returns `false`.
+ *
+ * @example
+ * areDecimalNumbersEqual(5483.86, 5483.87, 0.5); // true
+ * areDecimalNumbersEqual(5483.86, 5484.5, 0.5);  // false
+ */
+export declare function areDecimalNumbersEqual(firstValue: number, secondValue: number, allowedDifference?: number): boolean;
+/**
+ * Formats a number into the Indian numbering system with commas.
+ *
+ * - Ensures **two decimal places**.
+ * - Applies Indian digit grouping: last 3 digits, then groups of 2 (e.g., 1,23,456.00).
+ * - Accepts both `number` and `string` input.
+ * - Returns an empty string if the input is not a valid number.
+ *
+ * @param {number | string} amount - The number or numeric string to format.
+ * @returns {string} The formatted number as a string in Indian number format.
+ *
+ * @example
+ * formatIndianNumber(123456);     // "1,23,456.00"
+ * formatIndianNumber(1891250);    // "18,91,250.00"
+ * formatIndianNumber("21250");    // "21,250.00"
+ * formatIndianNumber("abc");      // ""
+ */
+export declare function formatIndianNumber(amount: number | string): string;
+export declare function findDuplicateIds(ids: number[]): number[];
+export declare function getDecimalNumberFromString(value: string | number, placesAfterDecimal?: number): number;

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

@@ -33,6 +33,10 @@ exports.createKeyLabelMap = createKeyLabelMap;
 exports.transformDate = transformDate;
 exports.capitalizeFirstWord = capitalizeFirstWord;
 exports.getEntitiesFromSearchV2Response = getEntitiesFromSearchV2Response;
+exports.areDecimalNumbersEqual = areDecimalNumbersEqual;
+exports.formatIndianNumber = formatIndianNumber;
+exports.findDuplicateIds = findDuplicateIds;
+exports.getDecimalNumberFromString = getDecimalNumberFromString;
 const util_constants_1 = require("../constants/util.constants");
 const error_key_enum_1 = require("../enums/error.key.enum");
 const exceptions_1 = require("../exceptions");
@@ -393,3 +397,73 @@ function getEntitiesFromSearchV2Response(searchResponseV2, entityEnumKey, Entity
     }
     return (((_a = searchResponseV2.relatedEntities[entityEnumKey]) === null || _a === void 0 ? void 0 : _a.baseEntities) || []).map((entity) => Object.assign(new EntityClass(), entity));
 }
+/**
+ * Checks if two decimal numbers are approximately equal within a given tolerance.
+ *
+ * @param {number} firstValue - The first number to compare.
+ * @param {number} secondValue - The second number to compare.
+ * @param {number} allowedDifference - The maximum difference allowed for the numbers
+ *                                     to be considered equal.
+ *
+ * @returns {boolean} Returns `true` if the numbers are within the allowed difference;
+ * otherwise, returns `false`.
+ *
+ * @example
+ * areDecimalNumbersEqual(5483.86, 5483.87, 0.5); // true
+ * areDecimalNumbersEqual(5483.86, 5484.5, 0.5);  // false
+ */
+function areDecimalNumbersEqual(firstValue, secondValue, allowedDifference = 0.5) {
+    // Calculate the absolute difference between both values
+    const actualDifference = Math.abs(firstValue - secondValue);
+    // Return true if the actual difference is less than or equal to the allowed difference
+    return actualDifference <= allowedDifference;
+}
+/**
+ * Formats a number into the Indian numbering system with commas.
+ *
+ * - Ensures **two decimal places**.
+ * - Applies Indian digit grouping: last 3 digits, then groups of 2 (e.g., 1,23,456.00).
+ * - Accepts both `number` and `string` input.
+ * - Returns an empty string if the input is not a valid number.
+ *
+ * @param {number | string} amount - The number or numeric string to format.
+ * @returns {string} The formatted number as a string in Indian number format.
+ *
+ * @example
+ * formatIndianNumber(123456);     // "1,23,456.00"
+ * formatIndianNumber(1891250);    // "18,91,250.00"
+ * formatIndianNumber("21250");    // "21,250.00"
+ * formatIndianNumber("abc");      // ""
+ */
+function formatIndianNumber(amount) {
+    let num = Number(amount);
+    if (isNaN(num))
+        return "";
+    // Ensure 2 decimal places
+    let [integerPart, decimalPart] = num.toFixed(2).split(".");
+    // Indian grouping: last 3 digits, then groups of 2
+    let lastThree = integerPart.slice(-3);
+    let otherNumbers = integerPart.slice(0, -3);
+    if (otherNumbers !== "") {
+        lastThree = "," + lastThree;
+    }
+    let formattedInt = otherNumbers.replace(/\B(?=(\d{2})+(?!\d))/g, ",") + lastThree;
+    return formattedInt + "." + decimalPart;
+}
+function findDuplicateIds(ids) {
+    const seen = new Set();
+    const duplicates = new Set();
+    for (const id of ids) {
+        if (seen.has(id)) {
+            duplicates.add(id);
+        }
+        else {
+            seen.add(id);
+        }
+    }
+    return Array.from(duplicates);
+}
+function getDecimalNumberFromString(value, placesAfterDecimal = 2) {
+    // this method should internally handle if the value is number or string
+    return Number(Number(value).toFixed(placesAfterDecimal));
+}

package/dist/src/utils/models/date-code.model.util.d.ts

@@ -34,4 +34,6 @@ export declare class DateCodeModel {
     isSame(dateCodeModel: DateCodeModel): boolean;
     getWeekday(): Weekday;
     getDateInIST(): Date;
+    static getDaysInCurrentMonth(): number;
+    getDaysInMonth(dateCode?: string): number;
 }

package/dist/src/utils/models/date-code.model.util.js

@@ -98,8 +98,8 @@ class DateCodeModel {
         }
         const dateRange = startModel.getRange(endModel);
         const excludeDayPredicates = (dateModel) => !dateModel.isDayPresent(excludeDays);
-        const excludeDatePredicates = (dateModel) => !excludeDateCodes.some(d => d.isSame(dateModel));
-        return dateRange.filter((dateModel => excludeDayPredicates(dateModel) && excludeDatePredicates(dateModel))).length;
+        const excludeDatePredicates = (dateModel) => !excludeDateCodes.some((d) => d.isSame(dateModel));
+        return dateRange.filter((dateModel) => excludeDayPredicates(dateModel) && excludeDatePredicates(dateModel)).length;
     }
     static getByPredicates(models, includePredicates, excludePredicates) {
         return models.filter((model) => includePredicates.every((predicate) => predicate(model)) &&
@@ -209,5 +209,18 @@ class DateCodeModel {
         billDateIST.setHours(nowIST.getHours(), nowIST.getMinutes(), nowIST.getSeconds(), nowIST.getMilliseconds());
         return billDateIST;
     }
+    static getDaysInCurrentMonth() {
+        const today = new Date();
+        const lastDay = (0, date_fns_1.lastDayOfMonth)(today); // Gives last day of current month
+        return lastDay.getDate(); // Number of days in that month
+    }
+    getDaysInMonth(dateCode) {
+        // If a dateCode is provided, use that; otherwise use this instance's dateCode
+        const model = dateCode ? new DateCodeModel(dateCode) : this;
+        // Reuse existing parsing/normalization via getDate()
+        const date = model.getDate();
+        // Number of days in that month
+        return (0, date_fns_1.lastDayOfMonth)(date).getDate();
+    }
 }
 exports.DateCodeModel = DateCodeModel;

package/package.json

@@ -1,35 +1,35 @@
-{
-  "name": "law-common",
-  "version": "10.16.1",
-  "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/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"
-  }
-}
+{
+  "name": "law-common",
+  "version": "10.17.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/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"
+  }
+}