law-common 10.17.0 → 10.17.1-beta.1

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

@@ -80,3 +80,4 @@ export * from "./interface/holiday-list.entity.response";
 export * from "./interface/cron-job-manual-trigger.dto.interface";
 export * from "./interface/cron-job.entity.response";
 export * from "./interface/to-do.entity.api";
+export * from "./interface/billing-reimbursement-expense-history.api";

package/dist/src/api/index.js

@@ -96,3 +96,4 @@ __exportStar(require("./interface/holiday-list.entity.response"), exports);
 __exportStar(require("./interface/cron-job-manual-trigger.dto.interface"), exports);
 __exportStar(require("./interface/cron-job.entity.response"), exports);
 __exportStar(require("./interface/to-do.entity.api"), exports);
+__exportStar(require("./interface/billing-reimbursement-expense-history.api"), exports);

package/dist/src/api/interface/billing-reimbursement-expense-history.api.d.ts

@@ -0,0 +1,4 @@
+import { IApiEntity } from "../../entities";
+import { IBillingReimbursementExpenseHistoryEntity } from "../../entities/interface/billing-reimbursement-expense-history.entity.interface";
+export type IBillingReimbursementExpenseHistoryApiEntity = IApiEntity<IBillingReimbursementExpenseHistoryEntity>;
+export type IBillingReimbursementExpenseHistoryApiEntityArray = IBillingReimbursementExpenseHistoryApiEntity[];

package/dist/src/api/interface/billing-reimbursement-expense-history.api.js

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

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

@@ -1,10 +1,14 @@
-import { BillingImpactEnum, BillingStatusEnum, IBillingEntity, IBillingTimesheetEntity, IEntityCreateDto, IProjectEntity, ITimesheetEntity } from "../../entities";
+import { BillingImpactEnum, BillingReimbursementExpenseChangedStatusEnum, 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;
     status?: BillingStatusEnum;
 }
-export interface IBillingTimesheetUnchagedDto {
+export interface IBillingTimesheetUnchangedDto {
+    id: number;
+    amount: number;
+}
+export interface IBillingReimbursementExpenseUnchangedDto {
     id: number;
     amount: number;
 }
@@ -20,7 +24,7 @@ export interface IBillingTimesheetUpdateDeleteDetailDto {
 }
 export interface IBillingTimesheetsDto {
     all: number[];
-    unchanged: IBillingTimesheetUnchagedDto[];
+    unchanged: IBillingTimesheetUnchangedDto[];
     updateDetails: IBillingTimesheetUpdateDeleteDetailDto[];
     deleteDetails: IBillingTimesheetUpdateDeleteDetailDto[];
 }
@@ -29,3 +33,13 @@ export interface IBillingEntityCreateDtoValidationData {
     billingTimesheetEntities: IBillingTimesheetEntity[];
     timesheetEntities: ITimesheetEntity[];
 }
+export interface IBillingReimbursementExpenseCreateDtoDetails {
+    userId: number;
+    reimbursementExpenseId: number;
+    projectId: number;
+    expenseType: string;
+    totalAmount: number;
+    expenseIncurredDate: string;
+    changedStatus: BillingReimbursementExpenseChangedStatusEnum;
+    amendmentPurpose?: string;
+}

package/dist/src/api/interface/billing.entity.response.d.ts

@@ -1,4 +1,4 @@
-import { BillingActionsEnum, BillingStatusEnum, IBillingEntity } from "../../entities";
+import { BillingActionsEnum, BillingStatusEnum, IBillingEntity, IBillingReimbursementExpenseEntity } from "../../entities";
 import { IBillingApiEntity } from "./billing.entity.api";
 import { IBillingTimesheetApiEntity } from "./billing.timesheet.entity.api";
 import { IUpdateBillingDto } from "./billing.update.dto.interface";
@@ -6,7 +6,8 @@ import { IProjectApiEntity } from "./project.entity.response";
 import { IUserApiEntity } from "./user.entity.api";
 export type IBillingEntityResponse = {
     billing: IBillingApiEntity;
-    billingTimesheets: IBillingTimesheetApiEntity[];
+    billingTimesheets?: IBillingTimesheetApiEntity[];
+    billingReimbursementExpenses?: IBillingReimbursementExpenseEntity[];
 };
 export interface IUserEntityRelation {
     users?: IUserApiEntity[];

package/dist/src/entities/enums/billing-reimburement-expense-impact.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum BillingReimbursementExpenseImpactEnum {
+    POSITIVE = "positive",
+    NEUTRAL = "neutral",
+    NEGATIVE = "negative"
+}

package/dist/src/entities/enums/billing-reimburement-expense-impact.enum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingReimbursementExpenseImpactEnum = void 0;
+var BillingReimbursementExpenseImpactEnum;
+(function (BillingReimbursementExpenseImpactEnum) {
+    BillingReimbursementExpenseImpactEnum["POSITIVE"] = "positive";
+    BillingReimbursementExpenseImpactEnum["NEUTRAL"] = "neutral";
+    BillingReimbursementExpenseImpactEnum["NEGATIVE"] = "negative";
+})(BillingReimbursementExpenseImpactEnum || (exports.BillingReimbursementExpenseImpactEnum = BillingReimbursementExpenseImpactEnum = {}));

package/dist/src/entities/enums/billing-reimbursement-expense-change-status.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum BillingReimbursementExpenseChangedStatusEnum {
+    UNCHANGED = "unchanged",
+    UPDATED = "updated",
+    DELETED = "deleted"
+}

package/dist/src/entities/enums/billing-reimbursement-expense-change-status.enum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingReimbursementExpenseChangedStatusEnum = void 0;
+var BillingReimbursementExpenseChangedStatusEnum;
+(function (BillingReimbursementExpenseChangedStatusEnum) {
+    BillingReimbursementExpenseChangedStatusEnum["UNCHANGED"] = "unchanged";
+    BillingReimbursementExpenseChangedStatusEnum["UPDATED"] = "updated";
+    BillingReimbursementExpenseChangedStatusEnum["DELETED"] = "deleted";
+})(BillingReimbursementExpenseChangedStatusEnum || (exports.BillingReimbursementExpenseChangedStatusEnum = BillingReimbursementExpenseChangedStatusEnum = {}));

package/dist/src/entities/enums/billing-type.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum BillingTypeEnum {
+    DEBIT_NOTE = "debitNote",
+    INVOICE = "invoice",
+    BOTH = "both"
+}

package/dist/src/entities/enums/billing-type.enum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingTypeEnum = void 0;
+var BillingTypeEnum;
+(function (BillingTypeEnum) {
+    BillingTypeEnum["DEBIT_NOTE"] = "debitNote";
+    BillingTypeEnum["INVOICE"] = "invoice";
+    BillingTypeEnum["BOTH"] = "both";
+})(BillingTypeEnum || (exports.BillingTypeEnum = BillingTypeEnum = {}));

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

@@ -74,3 +74,8 @@ 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 "./enums/billing-reimbursement-expense-change-status.enum";
+export * from "./interface/billing-reimbursement-expense-history.entity.interface";
+export * from "./enums/billing-reimburement-expense-impact.enum";

package/dist/src/entities/index.js

@@ -91,3 +91,8 @@ __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("./enums/billing-reimbursement-expense-change-status.enum"), exports);
+__exportStar(require("./interface/billing-reimbursement-expense-history.entity.interface"), exports);
+__exportStar(require("./enums/billing-reimburement-expense-impact.enum"), exports);

package/dist/src/entities/interface/billing-reimbursement-expense-history.entity.interface.d.ts

@@ -0,0 +1,7 @@
+import { IBaseHistoryEntity, IEntityCreateDto, IEntityFilterData } from "./entity.utils.interface";
+export interface IBillingReimbursementExpenseHistoryEntity extends IBaseHistoryEntity {
+}
+export interface IBillingReimbursementExpenseHistoryCreateDto extends IEntityCreateDto<IBillingReimbursementExpenseHistoryEntity> {
+}
+export interface IBillingReimbursementExpenseHistorySearchDto extends IEntityFilterData<IBillingReimbursementExpenseHistoryEntity> {
+}

package/dist/src/entities/interface/billing-reimbursement-expense-history.entity.interface.js

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

package/dist/src/entities/interface/billing-reimbursement-expense.entity.interface.d.ts

@@ -0,0 +1,23 @@
+import { BillingReimbursementExpenseImpactEnum } from "../enums/billing-reimburement-expense-impact.enum";
+import { BillingReimbursementExpenseChangedStatusEnum } from "../enums/billing-reimbursement-expense-change-status.enum";
+import { IAuditColumnEntity } from "./audit-column.entity.interface";
+import { IEntityCreateDto, IEntityFilterData, IEntityUpdateDto } from "./entity.utils.interface";
+export interface IBillingReimbursementExpenseEntity extends IAuditColumnEntity {
+    id: number;
+    billingId: number;
+    userId: number;
+    reimbursementExpenseId: number;
+    projectId: number;
+    expenseType: string;
+    totalAmount: number;
+    expenseIncurredDate: string;
+    changedStatus: BillingReimbursementExpenseChangedStatusEnum;
+    amendmentPurpose?: string;
+    impact: BillingReimbursementExpenseImpactEnum;
+}
+export interface IBillingReimbursementExpenseCreateDto extends IEntityCreateDto<IBillingReimbursementExpenseEntity> {
+}
+export interface IBillingReimbursementExpenseUpdateDto extends IEntityUpdateDto<IBillingReimbursementExpenseEntity> {
+}
+export interface IBillingReimbursementExpenseFilterData extends IEntityFilterData<IBillingReimbursementExpenseEntity> {
+}

package/dist/src/entities/interface/billing-reimbursement-expense.entity.interface.js

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

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

@@ -1,4 +1,5 @@
 import { CurrencyEnum } from "../../enums";
+import { BillingTypeEnum } from "../enums/billing-type.enum";
 import { BillingStatusEnum } from "../enums/billing.status.enum";
 import { BillingInvoiceTypeEnum } from "../enums/billing_invoice_type.enum";
 import { PaymentStatusEnum } from "../enums/payment_status.enum";
@@ -26,6 +27,7 @@ export interface IBillingEntity extends IAuditColumnEntity {
     conversionRate?: number;
     particulars: string;
     currency: CurrencyEnum;
+    type: BillingTypeEnum;
 }
 export interface IBillingEntityFilterDto extends IEntityFilterData<IBillingEntity> {
 }

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

@@ -6,6 +6,7 @@ import { HistoryOperationEnum } from "../enums/history_operation.enum";
 import { IAuditColumnEntity } from "./audit-column.entity.interface";
 import { IBankEntity } from "./bank.entity.interface";
 import { IBankHistoryEntity } from "./bank_history.entity.interface";
+import { IBillingReimbursementExpenseEntity } from "./billing-reimbursement-expense.entity.interface";
 import { IBillingEntity } from "./billing.entity.interface";
 import { IBillingPaymentEntity } from "./billing_payment.entity.interface";
 import { IBillingTimesheetEntity } from "./billing_timesheet.entity.interface";
@@ -48,11 +49,43 @@ export type IApiEntity<T extends {
 }>;
 export type IEntityCreateDto<T> = Omit<T, "id" | keyof IAuditColumnEntity>;
 export type IEntityUpdateDto<T> = Omit<Partial<T>, "id" | keyof IAuditColumnEntity>;
+/**
+ * EntityEnum
+ *
+ * Centralized registry of **entity identifiers** used across the application.
+ *
+ * Purpose:
+ * - Provides a single source of truth for entity names.
+ * - Ensures consistency across backend, frontend, and shared packages.
+ * - In the backend, these values are also used as TypeORM table names.
+ *
+ * Rules:
+ * - Whenever a new entity (domain object / database table) is introduced,
+ *   its corresponding entry MUST be added here.
+ * - Backend entities must always use `@Entity(EntityEnum.XYZ)` instead of string literals.
+ *
+ * Example (backend):
+ * ```ts
+ * @Entity(EntityEnum.USER)
+ * export class UserEntity { ... }
+ * ```
+ *
+ * Example (frontend / service):
+ * ```ts
+ * if (entity === EntityEnum.USER) {
+ *   // handle user entity logic
+ * }
+ * ```
+ *
+ * Do not duplicate or hardcode entity names in different layers.
+ */
 export declare enum EntityEnum {
     BILLING = "billing",
     BILLING_HISTORY = "billing_history",
     BILLING_TIMESHEET = "billing_timesheet",
+    BILLING_REIMBURSEMENT_EXPENSE = "billing_reimbursement_expense",
     BILLING_TIMESHEET_HISTORY = "billing_timesheet_history",
+    BILLING_REIMBURESMENT_EXPENSE_HISTORY = "billing_reimbursement_expense_history",
     TIMESHEET = "timesheet",
     TIMESHEET_HISTORY = "timesheet_history",
     USER = "user",
@@ -111,7 +144,7 @@ export type IBaseEntityApiResponse<T extends {
         [K in EntityEnum | VirtualEntityEnum]?: IBaseEntityApiResponse<EnumEntityType<K>>;
     };
 };
-export type EnumEntityType<T extends EntityEnum | VirtualEntityEnum> = (T extends EntityEnum.BILLING ? IBillingEntity : T extends EntityEnum.BILLING_TIMESHEET ? IBillingTimesheetEntity : T extends EntityEnum.TIMESHEET ? ITimesheetEntity : T extends EntityEnum.USER ? IUserEntity : T extends EntityEnum.PROJECT ? IProjectEntity : T extends EntityEnum.CLIENT ? IClientEntity : T extends EntityEnum.LEAVE ? ILeaveEntity : T extends EntityEnum.BANK ? IBankEntity : T extends EntityEnum.BILLING_PAYMENT ? IBillingPaymentEntity : T extends EntityEnum.BILLING_TRANSACTION ? IBillingTransactionEntity : T extends EntityEnum.CLIENT_AFFILIATE ? IClientAffiliateEntity : T extends EntityEnum.CONFIGURATION ? IConfigurationEntity : T extends EntityEnum.HOLIDAY ? IHolidayEntity : T extends EntityEnum.HOLIDAY_LIST ? IHolidayListEntity : T extends EntityEnum.COUNTRY ? ICountryEntity : T extends EntityEnum.EXPENSE_TYPE ? IExpenseTypeEntity : T extends EntityEnum.INDUSTRY ? IIndustryEntity : T extends EntityEnum.INTERMEDIARY_BANK ? IIntermediaryBankEntity : T extends EntityEnum.OFFICE_LOCATION ? IOfficeLocationEntity : T extends EntityEnum.PERMISSION ? IPermissionEntity : T extends EntityEnum.ROLE ? IRoleEntity : T extends EntityEnum.TASK ? ITaskEntity : T extends EntityEnum.DESIGNATION ? IDesignationEntity : T extends EntityEnum.RATE ? IRateEntity : T extends EntityEnum.REIMBURSEMENT ? IReimbursementEntity : T extends EntityEnum.REIMBURSEMENT_EXPENSE ? IReimbursementExpenseEntity : T extends EntityEnum.WORK_FROM_HOME ? IWorkFromHomeEntity : T extends EntityEnum.ORGANIZATION ? IOrganizationEntity : T extends EntityEnum.PROJECT_USER_MAPPING ? IProjectUserMappingEntity : T extends EntityEnum.CLIENT_USER_MAPPING ? IClientUserMappingEntity : T extends EntityEnum.TO_DO_LIST ? IToDoListEntity : T extends EntityEnum.CRON_JOBS ? ICronJobsEntity : T extends EntityEnum.ROLE_PERMISSION_MAPPING ? IRolePermissionMappingEntity : T extends VirtualEntityEnum.USER_LEAVE ? IUserLeaveVirtualEntity : T extends EntityEnum.BANK_HISTORY ? IBankHistoryEntity : T extends EntityEnum.LEAVE_HISTORY ? ILeaveHistoryEntity : T extends EntityEnum.WORK_FROM_HOME_HISTORY ? IWorkFromHomeHistoryEntity : T extends EntityEnum.TIMESHEET_HISTORY ? ITimesheetHistoryEntity : never) & {
+export type EnumEntityType<T extends EntityEnum | VirtualEntityEnum> = (T extends EntityEnum.BILLING ? IBillingEntity : T extends EntityEnum.BILLING_TIMESHEET ? IBillingTimesheetEntity : T extends EntityEnum.BILLING_REIMBURSEMENT_EXPENSE ? IBillingReimbursementExpenseEntity : T extends EntityEnum.TIMESHEET ? ITimesheetEntity : T extends EntityEnum.USER ? IUserEntity : T extends EntityEnum.PROJECT ? IProjectEntity : T extends EntityEnum.CLIENT ? IClientEntity : T extends EntityEnum.LEAVE ? ILeaveEntity : T extends EntityEnum.BANK ? IBankEntity : T extends EntityEnum.BILLING_PAYMENT ? IBillingPaymentEntity : T extends EntityEnum.BILLING_TRANSACTION ? IBillingTransactionEntity : T extends EntityEnum.CLIENT_AFFILIATE ? IClientAffiliateEntity : T extends EntityEnum.CONFIGURATION ? IConfigurationEntity : T extends EntityEnum.HOLIDAY ? IHolidayEntity : T extends EntityEnum.HOLIDAY_LIST ? IHolidayListEntity : T extends EntityEnum.COUNTRY ? ICountryEntity : T extends EntityEnum.EXPENSE_TYPE ? IExpenseTypeEntity : T extends EntityEnum.INDUSTRY ? IIndustryEntity : T extends EntityEnum.INTERMEDIARY_BANK ? IIntermediaryBankEntity : T extends EntityEnum.OFFICE_LOCATION ? IOfficeLocationEntity : T extends EntityEnum.PERMISSION ? IPermissionEntity : T extends EntityEnum.ROLE ? IRoleEntity : T extends EntityEnum.TASK ? ITaskEntity : T extends EntityEnum.DESIGNATION ? IDesignationEntity : T extends EntityEnum.RATE ? IRateEntity : T extends EntityEnum.REIMBURSEMENT ? IReimbursementEntity : T extends EntityEnum.REIMBURSEMENT_EXPENSE ? IReimbursementExpenseEntity : T extends EntityEnum.WORK_FROM_HOME ? IWorkFromHomeEntity : T extends EntityEnum.ORGANIZATION ? IOrganizationEntity : T extends EntityEnum.PROJECT_USER_MAPPING ? IProjectUserMappingEntity : T extends EntityEnum.CLIENT_USER_MAPPING ? IClientUserMappingEntity : T extends EntityEnum.TO_DO_LIST ? IToDoListEntity : T extends EntityEnum.CRON_JOBS ? ICronJobsEntity : T extends EntityEnum.ROLE_PERMISSION_MAPPING ? IRolePermissionMappingEntity : T extends VirtualEntityEnum.USER_LEAVE ? IUserLeaveVirtualEntity : T extends EntityEnum.BANK_HISTORY ? IBankHistoryEntity : T extends EntityEnum.LEAVE_HISTORY ? ILeaveHistoryEntity : T extends EntityEnum.WORK_FROM_HOME_HISTORY ? IWorkFromHomeHistoryEntity : T extends EntityEnum.TIMESHEET_HISTORY ? ITimesheetHistoryEntity : never) & {
     id: number;
 };
 export type EntityRelationConfig<T extends EntityEnum | VirtualEntityEnum> = {
@@ -155,6 +188,7 @@ export type IEntityFilterData<T extends EnumEntityType<EntityEnum | VirtualEntit
     virtualRelations?: ISearchIncludeEntity<VirtualEntityEnum>[];
 };
 export type ISearchIncludeEntity<T extends EntityEnum | VirtualEntityEnum> = {
+    id?: number[];
     name: T;
     relations?: ISearchIncludeEntity<EntityRelations[EntityEnum]>[];
     entities?: ISearchIncludeEntity<EntityRelations[EntityEnum]>[];

package/dist/src/entities/interface/entity.utils.interface.js

@@ -1,12 +1,44 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VirtualEntityEnum = exports.EntityEnum = void 0;
+/**
+ * EntityEnum
+ *
+ * Centralized registry of **entity identifiers** used across the application.
+ *
+ * Purpose:
+ * - Provides a single source of truth for entity names.
+ * - Ensures consistency across backend, frontend, and shared packages.
+ * - In the backend, these values are also used as TypeORM table names.
+ *
+ * Rules:
+ * - Whenever a new entity (domain object / database table) is introduced,
+ *   its corresponding entry MUST be added here.
+ * - Backend entities must always use `@Entity(EntityEnum.XYZ)` instead of string literals.
+ *
+ * Example (backend):
+ * ```ts
+ * @Entity(EntityEnum.USER)
+ * export class UserEntity { ... }
+ * ```
+ *
+ * Example (frontend / service):
+ * ```ts
+ * if (entity === EntityEnum.USER) {
+ *   // handle user entity logic
+ * }
+ * ```
+ *
+ * Do not duplicate or hardcode entity names in different layers.
+ */
 var EntityEnum;
 (function (EntityEnum) {
     EntityEnum["BILLING"] = "billing";
     EntityEnum["BILLING_HISTORY"] = "billing_history";
     EntityEnum["BILLING_TIMESHEET"] = "billing_timesheet";
+    EntityEnum["BILLING_REIMBURSEMENT_EXPENSE"] = "billing_reimbursement_expense";
     EntityEnum["BILLING_TIMESHEET_HISTORY"] = "billing_timesheet_history";
+    EntityEnum["BILLING_REIMBURESMENT_EXPENSE_HISTORY"] = "billing_reimbursement_expense_history";
     EntityEnum["TIMESHEET"] = "timesheet";
     EntityEnum["TIMESHEET_HISTORY"] = "timesheet_history";
     EntityEnum["USER"] = "user";

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

@@ -212,3 +212,32 @@ export declare function areDecimalNumbersEqual(firstValue: number, secondValue:
 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;
+/**
+ * Recursively checks if a specified property exists in an object or its nested objects.
+ * Skips properties with array values and does not check their contents.
+ * The property is considered present if it exists in the object and its value is not undefined.
+ *
+ * @template T - The type of the input object, constrained to be an object.
+ * @param obj - The object to check for the property. Can be null or undefined.
+ * @param propName - The name of the property to search for.
+ * @returns True if the property exists in the object or any nested non-array object and is not undefined; false otherwise.
+ *
+ * @example
+ * ```typescript
+ * interface MyObject {
+ *   name?: string;
+ *   details?: { age?: number; tags?: string[] };
+ * }
+ *
+ * const obj: MyObject = {
+ *   name: "Alice",
+ *   details: { age: 30, tags: ["test"] }
+ * };
+ *
+ * console.log(hasProperty(obj, "name")); // true
+ * console.log(hasProperty(obj, "age")); // true (nested in details)
+ * console.log(hasProperty(obj, "tags")); // false (tags is an array, skipped)
+ * console.log(hasProperty(obj, "unknown")); // false
+ * ```
+ */
+export declare function hasProperty<T extends object>(obj: T | null | undefined, propName: string): boolean;

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

@@ -37,6 +37,7 @@ exports.areDecimalNumbersEqual = areDecimalNumbersEqual;
 exports.formatIndianNumber = formatIndianNumber;
 exports.findDuplicateIds = findDuplicateIds;
 exports.getDecimalNumberFromString = getDecimalNumberFromString;
+exports.hasProperty = hasProperty;
 const util_constants_1 = require("../constants/util.constants");
 const error_key_enum_1 = require("../enums/error.key.enum");
 const exceptions_1 = require("../exceptions");
@@ -467,3 +468,54 @@ function getDecimalNumberFromString(value, placesAfterDecimal = 2) {
     // this method should internally handle if the value is number or string
     return Number(Number(value).toFixed(placesAfterDecimal));
 }
+/**
+ * Recursively checks if a specified property exists in an object or its nested objects.
+ * Skips properties with array values and does not check their contents.
+ * The property is considered present if it exists in the object and its value is not undefined.
+ *
+ * @template T - The type of the input object, constrained to be an object.
+ * @param obj - The object to check for the property. Can be null or undefined.
+ * @param propName - The name of the property to search for.
+ * @returns True if the property exists in the object or any nested non-array object and is not undefined; false otherwise.
+ *
+ * @example
+ * ```typescript
+ * interface MyObject {
+ *   name?: string;
+ *   details?: { age?: number; tags?: string[] };
+ * }
+ *
+ * const obj: MyObject = {
+ *   name: "Alice",
+ *   details: { age: 30, tags: ["test"] }
+ * };
+ *
+ * console.log(hasProperty(obj, "name")); // true
+ * console.log(hasProperty(obj, "age")); // true (nested in details)
+ * console.log(hasProperty(obj, "tags")); // false (tags is an array, skipped)
+ * console.log(hasProperty(obj, "unknown")); // false
+ * ```
+ */
+function hasProperty(obj, propName) {
+    if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
+        return false;
+    }
+    // Check if the property exists at the current level
+    if (propName in obj && obj[propName] !== undefined) {
+        return true;
+    }
+    // Recursively check all nested objects, skipping arrays
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            const value = obj[key];
+            if (typeof value === "object" &&
+                value !== null &&
+                !Array.isArray(value)) {
+                if (hasProperty(value, propName)) {
+                    return true;
+                }
+            }
+        }
+    }
+    return false;
+}

package/package.json

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