law-common 10.72.1-beta.2 → 10.72.1-beta.3

package/README.md

@@ -1 +1 @@
-# law-common
+# law-common

package/dist/src/api/interface/leave.api.d.ts

@@ -1,7 +1,16 @@
-import { FlowConfig, ILeaveEntity, LeaveActionEnum, LeaveStatusEnum } from "../../entities";
+import { ILeaveEntity, LeaveActionEnum, LeaveStatusEnum } from "../../entities";
 import { ILeaveUpdateDto } from "./leave.update.dto.interface";
 export type ILeaveFlowContextData = {
     currentTimesheet?: ILeaveEntity;
     dto?: ILeaveUpdateDto;
 };
-export type ILeaveFlowConfig = FlowConfig<LeaveStatusEnum, LeaveActionEnum, never>;
+export type ILeaveFlowConfig = {
+    [key in LeaveStatusEnum]?: {
+        actions: {
+            [key in LeaveActionEnum]?: {
+                permissions: string[];
+                next: () => LeaveStatusEnum;
+            };
+        };
+    };
+};

package/dist/src/api/interface/vendor.create.dto.interface.autocode.js

@@ -22,19 +22,10 @@
 // }
 // export type IVendorBankDetailCreateExclude = never;
 // export interface IVendorBankDetailCreateDto extends Omit<IEntityCreateDto<IVendorBankDetailEntity>, IVendorBankDetailCreateExclude> {}
-// export type IVendorCreateExclude =
-//   | "contactDetail"
-//   | "bankDetail"
-//   | "organizationTypeId"
-//   | "status"
-//   | "remark"
-//   | "panDocument"
-//   | "gstDocument"
-//   | "contractDocument"
-//   | "attachmentDocuments";
+// export type IVendorCreateExclude = "contactDetail" | "bankDetail" | "panDocument" | "gstDocument" | "contractDocument" | "attachmentDocuments";
 // export interface IVendorCreateDto extends Omit<IEntityCreateDto<IVendorEntity>, IVendorCreateExclude> {
-//   contactDetail?: IVendorContactDetailCreateDto[];
-//   bankDetail?: IVendorBankDetailCreateDto[];
+//   contactDetail?: IVendorContactDetailEntity;
+//   bankDetail?: IVendorBankDetailEntity;
 //   panDocument?: Nullable<MulterFileWithUrl>;
 //   gstDocument?: Nullable<MulterFileWithUrl>;
 //   contractDocument?: Nullable<MulterFileWithUrl>;

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

@@ -1,6 +1,12 @@
 import { VendorActionEnum } from "../../entities/enums/vendor-action.enum";
 import { VendorStatusEnum } from "../../entities/enums/vendor-status.enum";
-import { FlowConfig } from "../../entities/flow-configs/flow-config.type";
-export interface IVendorFlowConfigContextData {
-}
-export type IVendorFlowConfig = FlowConfig<VendorStatusEnum, VendorActionEnum, IVendorFlowConfigContextData>;
+export type IVendorFlowConfig = {
+    [key in VendorStatusEnum]?: {
+        actions: {
+            [key in VendorActionEnum]?: {
+                permissions: string[];
+                next: () => VendorStatusEnum;
+            };
+        };
+    };
+};

package/dist/src/entities/flow-configs/flow-config.type.d.ts

@@ -5,9 +5,9 @@
  * Used as the single source of truth for what actions are valid
  * at each status, and what permissions are required to execute them.
  *
- * @template STATUS_ENUM_TYPE - String enum of all possible statuses
- * @template ACTION_ENUM_TYPE - String enum of all possible actions
- * @template CONTEXT_DATA_TYPE - Optional context data shape passed to the `next()` resolver.
+ * @template S - String enum of all possible statuses
+ * @template A - String enum of all possible actions
+ * @template T - Optional context data shape passed to the `next()` resolver.
  *               Defaults to `never` for flows where `next()` needs no runtime data.
  *
  * @example
@@ -27,10 +27,10 @@
  * // Flow with context data (reimbursement parent)
  * const config: FlowConfig<ReimbursementStatusEnum, ReimbursementActionEnum, IReimbursementFlowContextData> = { ... }
  */
-export type FlowConfig<STATUS_ENUM_TYPE extends string, ACTION_ENUM_TYPE extends string, CONTEXT_DATA_TYPE = never> = {
-    [key in STATUS_ENUM_TYPE]?: {
+export type FlowConfig<S extends string, A extends string, T extends Record<any, any> = never> = {
+    [key in S]?: {
         actions: {
-            [key in ACTION_ENUM_TYPE]?: IFlowConfigActionConfig<STATUS_ENUM_TYPE, CONTEXT_DATA_TYPE>;
+            [key in A]?: IFlowConfigActionConfig<S, T>;
         };
         description?: string;
     };
@@ -39,8 +39,8 @@ export type FlowConfig<STATUS_ENUM_TYPE extends string, ACTION_ENUM_TYPE extends
  * Configuration for a single action within a {@link FlowConfig}.
  * Defines who can execute the action and what status it transitions to.
  *
- * @template STATUS_ENUM_TYPE - String enum of statuses, used as the return type of `next()`
- * @template CONTEXT_DATA_TYPE - Optional context data passed to `next()` for dynamic status resolution.
+ * @template S - String enum of statuses, used as the return type of `next()`
+ * @template T - Optional context data passed to `next()` for dynamic status resolution.
  *               Pass `never` for actions where the next status is always static.
  *
  * @example
@@ -58,9 +58,9 @@ export type FlowConfig<STATUS_ENUM_TYPE extends string, ACTION_ENUM_TYPE extends
  *   next: (data) => areAllRowsApproved(data) ? ReimbursementStatusEnum.APPROVED : ReimbursementStatusEnum.APPROVAL_PENDING,
  * };
  */
-export interface IFlowConfigActionConfig<STATUS_ENUM_TYPE extends string, CONTEXT_DATA_TYPE> {
+export interface IFlowConfigActionConfig<S extends string, T> {
     permissions: string[];
-    next: (data: CONTEXT_DATA_TYPE) => STATUS_ENUM_TYPE;
+    next: (data?: T) => S;
     description?: string;
 }
 export type ParentChildFlowConfig<S extends string, A extends string, CS extends string = never, CA extends string = never, T extends Record<any, any> = never> = {

package/dist/src/entities/flow-configs/leave.flow.config.d.ts

@@ -1,4 +1,4 @@
 import { LeaveActionEnum } from "../enums/leave.action.enum";
 import { LeaveStatusEnum } from "../enums/leave.status.enum";
 import { FlowConfig } from "./flow-config.type";
-export declare const leaveFlowConfig: FlowConfig<LeaveStatusEnum, LeaveActionEnum, never>;
+export declare const leaveFlowConfig: FlowConfig<LeaveStatusEnum, LeaveActionEnum>;

package/dist/src/entities/flow-configs/vendor-flow.config.js

@@ -8,19 +8,19 @@ exports.vendorFlowConfig = {
         actions: {
             [vendor_action_enum_1.VendorActionEnum.APPROVE]: {
                 permissions: ["VENDOR_APPROVE_ORG"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.APPROVED,
+                next: () => vendor_status_enum_1.VendorStatusEnum.APPROVED,
             },
             [vendor_action_enum_1.VendorActionEnum.EDIT]: {
                 permissions: ["VENDOR_UPDATE"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.CREATE_APPROVAL,
+                next: () => vendor_status_enum_1.VendorStatusEnum.CREATE_APPROVAL,
             },
             [vendor_action_enum_1.VendorActionEnum.REJECT]: {
                 permissions: ["VENDOR_APPROVE_ORG"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.REJECTED,
+                next: () => vendor_status_enum_1.VendorStatusEnum.REJECTED,
             },
             [vendor_action_enum_1.VendorActionEnum.DELETE]: {
                 permissions: ["VENDOR_UPDATE"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.DELETED,
+                next: () => vendor_status_enum_1.VendorStatusEnum.DELETED,
             },
         },
     },
@@ -28,19 +28,19 @@ exports.vendorFlowConfig = {
         actions: {
             [vendor_action_enum_1.VendorActionEnum.APPROVE]: {
                 permissions: ["VENDOR_APPROVE_ORG"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.APPROVED,
+                next: () => vendor_status_enum_1.VendorStatusEnum.APPROVED,
             },
             [vendor_action_enum_1.VendorActionEnum.EDIT]: {
                 permissions: ["VENDOR_UPDATE"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.EDIT_APPROVAL,
+                next: () => vendor_status_enum_1.VendorStatusEnum.EDIT_APPROVAL,
             },
             [vendor_action_enum_1.VendorActionEnum.REJECT]: {
                 permissions: ["VENDOR_APPROVE_ORG"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.RESOLVED_REJECTED,
+                next: () => vendor_status_enum_1.VendorStatusEnum.RESOLVED_REJECTED,
             },
             // [VendorActionEnum.RECALL]: {
             //   permissions: ["VENDOR_UPDATE"],
-            //   next: (vendorFlowConfigContextData: IVendorFlowConfigContextData) => VendorStatusEnum.DELETED,
+            //   next: () => VendorStatusEnum.DELETED,
             // },
         },
     },
@@ -48,15 +48,15 @@ exports.vendorFlowConfig = {
         actions: {
             [vendor_action_enum_1.VendorActionEnum.APPROVE]: {
                 permissions: ["VENDOR_APPROVE_ORG"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.DELETED,
+                next: () => vendor_status_enum_1.VendorStatusEnum.DELETED,
             },
             [vendor_action_enum_1.VendorActionEnum.REJECT]: {
                 permissions: ["VENDOR_APPROVE_ORG"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.RESOLVED_REJECTED,
+                next: () => vendor_status_enum_1.VendorStatusEnum.RESOLVED_REJECTED,
             },
             // [VendorActionEnum.RECALL]: {
             //   permissions: ["VENDOR_UPDATE"],
-            //   next: (vendorFlowConfigContextData: IVendorFlowConfigContextData) => VendorStatusEnum.DELETED,
+            //   next: () => VendorStatusEnum.DELETED,
             // },
         },
     },
@@ -64,11 +64,11 @@ exports.vendorFlowConfig = {
         actions: {
             [vendor_action_enum_1.VendorActionEnum.EDIT]: {
                 permissions: ["VENDOR_UPDATE"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.EDIT_APPROVAL,
+                next: () => vendor_status_enum_1.VendorStatusEnum.EDIT_APPROVAL,
             },
             [vendor_action_enum_1.VendorActionEnum.DELETE]: {
                 permissions: ["VENDOR_UPDATE"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.DELETE_APPROVAL,
+                next: () => vendor_status_enum_1.VendorStatusEnum.DELETE_APPROVAL,
             },
         },
     },
@@ -76,11 +76,11 @@ exports.vendorFlowConfig = {
         actions: {
             [vendor_action_enum_1.VendorActionEnum.EDIT]: {
                 permissions: ["VENDOR_UPDATE"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.EDIT_APPROVAL,
+                next: () => vendor_status_enum_1.VendorStatusEnum.EDIT_APPROVAL,
             },
             [vendor_action_enum_1.VendorActionEnum.DELETE]: {
                 permissions: ["VENDOR_UPDATE"],
-                next: (vendorFlowConfigContextData) => vendor_status_enum_1.VendorStatusEnum.DELETE_APPROVAL,
+                next: () => vendor_status_enum_1.VendorStatusEnum.DELETE_APPROVAL,
             },
         },
     },

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

@@ -1,6 +1,7 @@
 import { BillingProfileName } from "../enums/billing_profile.enum";
 import { BillingProfileCode } from "../enums/billing_profile_code.enum";
 import { IEntityAuditColumn } from "./entity-audit-columns.interface";
+import { EntityEnum, EnumEntityType, IEntityFilterData } from "./entity.utils.interface";
 export interface IBillingProfileEntity extends IEntityAuditColumn {
     id: number;
     name: BillingProfileName;
@@ -8,3 +9,5 @@ export interface IBillingProfileEntity extends IEntityAuditColumn {
     pan: string;
     code: BillingProfileCode;
 }
+export interface IBillingProfileEntityFilterData extends IEntityFilterData<EnumEntityType<EntityEnum.BILLING_PROFILE>> {
+}

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

@@ -369,8 +369,8 @@ export type IHistoryEntitySearchByConstraintResponse<T> = {
 export type IHistoryEntityChangedLogs<T> = {
     key: keyof T;
     label: string;
-    newValue: T[keyof T];
-    oldValue: T[keyof T] | null;
+    newValue: string | number;
+    oldValue: string | number;
     timeStamp: number;
 };
 export declare enum VirtualEntityEnum {

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

@@ -22,6 +22,7 @@ export interface IReimbursementEntity extends IEntityAuditColumn {
     disbursementDate?: string;
     referenceNo?: string;
     bankId?: number;
+    incurredByUserId: number;
 }
 export interface IReimbursementExpenseAllocation {
     id: number;

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

@@ -33,6 +33,7 @@ export declare class BillingEntityModel extends BaseEntityModel<EntityEnum.BILLI
     projectId: number;
     totalAmount: number;
     totalMinutes: number;
+    inrAmount: number;
     draftInvoiceNumber: string;
     invoiceNumber: Nullable<string>;
     paymentStatus: PaymentStatusEnum;
@@ -109,6 +110,7 @@ export declare class BillingEntityModel extends BaseEntityModel<EntityEnum.BILLI
     validateAdvanceBillingId(adjustedBillingTransactions: IBillingTransactionEntity[]): void;
     getApprovedBillingTransactionsTotalAmount(): number;
     getCurrentBillingBillingProfile(billingProfiles: BillingProfileEntityModel[]): BillingProfileEntityModel[];
+    static getLatestBillingEntityModel(billingEntityModels: BillingEntityModel[]): BillingEntityModel | void;
     static getNextInvoiceNumber(params: {
         type: BillingInvoiceNumberPrefixEnum;
         invoiceDate: Date;

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

@@ -27,6 +27,7 @@ class BillingEntityModel extends base_entity_model_1.BaseEntityModel {
         this.projectId = 0;
         this.totalAmount = 0;
         this.totalMinutes = 0;
+        this.inrAmount = 0;
         this.draftInvoiceNumber = "";
         this.invoiceNumber = null;
         this.paymentStatus = payment_status_enum_1.PaymentStatusEnum.PENDING;
@@ -284,6 +285,11 @@ class BillingEntityModel extends base_entity_model_1.BaseEntityModel {
         const billingParticularsOfCurrentBilling = JSON.parse(this.particulars);
         return billingProfiles.filter((profile) => profile.name === billingParticularsOfCurrentBilling.name);
     }
+    static getLatestBillingEntityModel(billingEntityModels) {
+        if (billingEntityModels.length === 0)
+            return;
+        return billingEntityModels.sort((a, b) => b.invoiceDate - a.invoiceDate)[0];
+    }
     static getNextInvoiceNumber(params) {
         // Draft numbers never use FY-based logic
         if (params.type === invoice_number_prefix_enum_1.BillingInvoiceNumberPrefixEnum.DRAFT) {

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

@@ -51,4 +51,8 @@ export declare class EntityModelRelationHelper {
         key: keyof EnumToModel<T>;
         value: any;
     }): EnumToModel<T>[];
+    private mergeMapFrom;
+    mergeHelperFrom(other: EntityModelRelationHelper, config?: {
+        populateRelations?: boolean;
+    }): EntityModelRelationHelper;
 }

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

@@ -376,5 +376,66 @@ class EntityModelRelationHelper {
         const entityModels = Object.values(this.entityModelIndexMap[entityEnum] || {});
         return entityModels.filter((model) => model[filter.key] === filter.value).map((model) => model);
     }
+    mergeMapFrom(thisCollection, otherCollection) {
+        // Normalize both to index map regardless of whether input is array or object
+        const thisIndex = Array.isArray(thisCollection)
+            ? thisCollection.reduce((acc, entity) => {
+                acc[entity.id] = entity;
+                return acc;
+            }, {})
+            : Object.assign({}, thisCollection);
+        const otherIndex = Array.isArray(otherCollection)
+            ? otherCollection.reduce((acc, entity) => {
+                acc[entity.id] = entity;
+                return acc;
+            }, {})
+            : Object.assign({}, otherCollection);
+        for (const id in otherIndex) {
+            const numericId = Number(id);
+            if (numericId in thisIndex) {
+                // ID exists in both — Object.assign mutates existing instance in place
+                // preserves prototype chain & fields not present in other (partial DB calls)
+                Object.assign(thisIndex[numericId], otherIndex[numericId]);
+            }
+            else {
+                thisIndex[numericId] = otherIndex[numericId];
+            }
+        }
+        // Return in same shape as input — array if input was array, index map if input was object
+        return Array.isArray(thisCollection) ? Object.values(thisIndex) : thisIndex;
+    }
+    mergeHelperFrom(other, config = { populateRelations: false }) {
+        for (const entityEnum in other.entityModelIndexMap) {
+            // @ts-ignore
+            this.entityMap[entityEnum] = this.mergeMapFrom(
+            // @ts-ignore
+            this.entityMap[entityEnum] || [], other.entityMap[entityEnum] || []);
+            // @ts-ignore
+            this.entityModelMap[entityEnum] = this.mergeMapFrom(
+            // @ts-ignore
+            this.entityModelMap[entityEnum] || [], other.entityModelMap[entityEnum] || []);
+            // @ts-ignore
+            this.entityModelIndexMap[entityEnum] = this.mergeMapFrom(
+            // @ts-ignore
+            this.entityModelIndexMap[entityEnum] || {}, other.entityModelIndexMap[entityEnum] || {});
+        }
+        if (config.populateRelations) {
+            // Re-populate other's entity types — their relations are stale since
+            // they were wired against other's index map, not the merged one
+            for (const entityEnum in other.entityModelIndexMap) {
+                this.populateRelationsByEntityEnum(entityEnum);
+            }
+            // Re-populate this's entity types as well — because other may have introduced
+            // new entities (e.g. a user, a project) that this's models were referencing
+            // but couldn't resolve before the merge
+            for (const entityEnum in this.entityModelIndexMap) {
+                // Skip entity types already re-populated from other's pass above
+                if (entityEnum in other.entityModelIndexMap)
+                    continue;
+                this.populateRelationsByEntityEnum(entityEnum);
+            }
+        }
+        return EntityModelRelationHelper.getClone(this);
+    }
 }
 exports.EntityModelRelationHelper = EntityModelRelationHelper;

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

@@ -233,7 +233,7 @@ class LeaveEntityModel extends base_entity_model_1.BaseEntityModel {
                 message: [`Current user does not have permission to ${dto.actionData.action} leave`],
             });
         }
-        const nextStatus = matchingPermissionConfig.next({});
+        const nextStatus = matchingPermissionConfig.next();
         return nextStatus;
     }
     mapStatusLabel(status) {

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

@@ -48,6 +48,7 @@ class ProjectEntityModel extends base_entity_model_1.BaseEntityModel {
         result.updatedOn = entity.updatedOn;
         result.billingOverdueDays = entity.billingOverdueDays;
         result.billToClientAffiliateId = entity.billingOverdueDays;
+        result.revenueSplit = entity.revenueSplit;
         return result;
     }
     populateUsers(users, projectUserMapping) {

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

@@ -1,7 +1,9 @@
 import { ReimbursementBillingPresentEnum, ReimbursementBillingTypeEnum, ReimbursementIncurredByEnum, ReimbursementPaymentStatusEnum, ReimbursementStatusEnum } from "../enums/reimbursement.entity.enum";
 import { EntityEnum } from "../interface/entity.utils.interface";
 import { IReimbursementEntity } from "../interface/reimbursement.entity.interface";
+import { RelationConfigs } from "../interface/relation-config.interface";
 import { BaseEntityModel } from "./base.entity.model";
+import { ReimbursementExpenseEntityModel } from "./reimbursement-expense.entity.model";
 export declare class ReimbursementEntityModel extends BaseEntityModel<EntityEnum.REIMBURSEMENT> implements IReimbursementEntity {
     id: number;
     billingType: ReimbursementBillingTypeEnum;
@@ -22,11 +24,13 @@ export declare class ReimbursementEntityModel extends BaseEntityModel<EntityEnum
     disbursementDate?: string;
     referenceNo?: string;
     bankId?: number;
+    incurredByUserId: number;
     createdBy: number;
     updatedBy: number;
     createdOn: number;
     updatedOn: number;
-    static relationConfigs: never[];
+    reimbursementExpenses?: ReimbursementExpenseEntityModel[];
+    static relationConfigs: RelationConfigs<[EntityEnum.REIMBURSEMENT_EXPENSE], EntityEnum.REIMBURSEMENT>;
     getRelationConfigs(): any[];
     static fromEntity(entity: IReimbursementEntity): ReimbursementEntityModel;
 }

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReimbursementEntityModel = void 0;
 const reimbursement_entity_enum_1 = require("../enums/reimbursement.entity.enum");
+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 ReimbursementEntityModel extends base_entity_model_1.BaseEntityModel {
@@ -16,10 +17,12 @@ class ReimbursementEntityModel extends base_entity_model_1.BaseEntityModel {
         this.description = "";
         this.status = reimbursement_entity_enum_1.ReimbursementStatusEnum.APPROVAL_PENDING;
         this.paymentStatus = reimbursement_entity_enum_1.ReimbursementPaymentStatusEnum.UNPAID;
+        this.incurredByUserId = 0;
         this.createdBy = 0;
         this.updatedBy = 0;
         this.createdOn = 0;
         this.updatedOn = 0;
+        this.reimbursementExpenses = [];
     }
     getRelationConfigs() {
         return this.constructor.prototype.constructor.relationConfigs || [];
@@ -31,4 +34,14 @@ class ReimbursementEntityModel extends base_entity_model_1.BaseEntityModel {
     }
 }
 exports.ReimbursementEntityModel = ReimbursementEntityModel;
-ReimbursementEntityModel.relationConfigs = [];
+ReimbursementEntityModel.relationConfigs = [
+    {
+        name: entity_utils_interface_1.EntityEnum.REIMBURSEMENT_EXPENSE,
+        relation: relation_type_enum_1.RelationType.MANY,
+        key: "reimbursementExpenses",
+        mapKeyConfig: {
+            relationKey: "reimbursementId",
+            key: "id",
+        },
+    },
+];

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

@@ -1,7 +1,7 @@
-import { EntityEnum, Nullable } from "../interface/entity.utils.interface";
+import { EntityEnum, IEntityUpdateDto, Nullable } from "../interface/entity.utils.interface";
 import { RelationConfigs } from "../interface/relation-config.interface";
 import { BaseEntityModel } from "./base.entity.model";
-import { IVendorFlowConfigContextData } from "../../api";
+import { IVendorActionDataDto } from "../../api";
 import { VendorActionEnum } from "../enums/vendor-action.enum";
 import { VendorStatusEnum } from "../enums/vendor-status.enum";
 import { VendorContractApplicabilityEnum } from "../enums/vendor_contract_applicability_enum";
@@ -62,10 +62,12 @@ export declare class VendorEntityModel extends BaseEntityModel<EntityEnum.VENDOR
     stateModel?: StateEntityModel;
     populateOrganizationTypeModel(organizationTypeEntityModels: OrganizationTypeEntityModel[]): null;
     getPanNoFourthCharacter(): string;
-    static relationConfigs: RelationConfigs<[EntityEnum.STATE, EntityEnum.ORGANIZATION_TYPE], EntityEnum.VENDOR>;
+    static relationConfigs: RelationConfigs<[EntityEnum.STATE], EntityEnum.VENDOR>;
     static fromEntity(entity: IVendorEntity): VendorEntityModel;
     getRelationConfigs(): any[];
-    getNextStatus(currentUser: IUserEntity, action: VendorActionEnum, vendorFlowConfigContextData: IVendorFlowConfigContextData): VendorStatusEnum;
+    getNextStatus(currentUser: IUserEntity, dto: IEntityUpdateDto<IVendorEntity> & {
+        actionData: IVendorActionDataDto;
+    }): VendorStatusEnum;
     getAvailableActions(currentUser: UserEntityModel, config?: {
         combinedActions?: Record<string, {
             combineActions: VendorActionEnum[];

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

@@ -57,7 +57,7 @@ class VendorEntityModel extends base_entity_model_1.BaseEntityModel {
     getRelationConfigs() {
         return this.constructor.prototype.constructor.relationConfigs || [];
     }
-    getNextStatus(currentUser, action, vendorFlowConfigContextData) {
+    getNextStatus(currentUser, dto) {
         if (!this.status) {
             throw new exceptions_1.AppBadRequestException({
                 key: error_key_enum_1.ErrorKeyEnum.STATUS,
@@ -71,17 +71,17 @@ class VendorEntityModel extends base_entity_model_1.BaseEntityModel {
                 message: [`No flow configuration found for status: ${this.status}`],
             });
         }
-        if (!action) {
+        if (!(dto === null || dto === void 0 ? void 0 : dto.actionData)) {
             throw new exceptions_1.AppBadRequestException({
                 key: error_key_enum_1.ErrorKeyEnum.ACTION_DATA,
-                message: ["actionData is required"],
+                message: ["dto.actionData is required"],
             });
         }
-        const matchingPermissionConfig = flowForStatus.actions[action];
+        const matchingPermissionConfig = flowForStatus.actions[dto.actionData.action];
         if (!matchingPermissionConfig) {
             throw new exceptions_1.AppBadRequestException({
                 key: error_key_enum_1.ErrorKeyEnum.ACTION,
-                message: [`Action '${action}' is not valid for the current status.`],
+                message: [`Action '${dto.actionData.action}' is not valid for the current status.`],
             });
         }
         if (!currentUser.permissions || currentUser.permissions.length === 0) {
@@ -94,10 +94,10 @@ class VendorEntityModel extends base_entity_model_1.BaseEntityModel {
         if (!hasPermission) {
             throw new exceptions_1.AppBadRequestException({
                 key: error_key_enum_1.ErrorKeyEnum.PERMISSION,
-                message: [`Current user does not have permission to ${action} vendor`],
+                message: [`Current user does not have permission to ${dto.actionData.action} vendor`],
             });
         }
-        const nextStatus = matchingPermissionConfig.next(vendorFlowConfigContextData);
+        const nextStatus = matchingPermissionConfig.next();
         return nextStatus;
     }
     getAvailableActions(currentUser, config) {
@@ -151,13 +151,4 @@ VendorEntityModel.relationConfigs = [
     //     key: "officeLocationId",
     //   },
     // },
-    {
-        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/vendor_invoice_item.entity.model.autocode.js

@@ -9,11 +9,6 @@
 // import { ExpenseHeadEntityModel } from "./expense_head.entity.model";
 // import { GstRateEntityModel } from "./gst_rate.entity.model";
 // import { TdsRateEntityModel } from "./tds_rate.entity.model";
-// import { VendorEntityModel } from "./vendor.entity.model";
-// import { StateEntityModel } from "./state.entity.model";
-// import { CountryEntityModel } from "./country.entity.model";
-// import { OrganizationTypeEntityModel } from "./organization_type.entity.model";
-// import { OfficeLocationEntityModel } from "./office_location.entity.model";
 // export class VendorInvoiceItemEntityModel extends BaseEntityModel<EntityEnum.VENDOR_INVOICE_ITEM> implements IVendorInvoiceItemEntity {
 //   id: number = 0;
 //   vendorInvoiceId: number = 0;
@@ -94,39 +89,4 @@
 //   getRelationConfigs(): any[] {
 //     return this.constructor.prototype.constructor.relationConfigs || [];
 //   }
-//   get vendor(): VendorEntityModel | undefined {
-//     // many_to_one -> many_to_one verified
-//     // {'vendor_invoice_item->vendor_invoice': 'many_to_one', 'vendor_invoice->vendor': 'many_to_one'}
-//     // ['vendor_invoice_item', 'vendor_invoice'] -> many_to_one
-//     // ['vendor_invoice', 'vendor'] -> many_to_one
-//     return this.vendorInvoice?.vendor;
-//   }
-//   get state(): StateEntityModel | undefined {
-//     // many_to_one -> many_to_one verified
-//     // {'vendor_invoice_item->vendor_invoice': 'many_to_one', 'vendor_invoice->vendor': 'many_to_one', 'vendor->state': 'many_to_one'}
-//     // ['vendor_invoice', 'vendor'] -> many_to_one
-//     // ['vendor', 'state'] -> many_to_one
-//     return this.vendor?.state;
-//   }
-//   get country(): CountryEntityModel | undefined {
-//     // many_to_one -> many_to_one verified
-//     // {'vendor_invoice_item->vendor_invoice': 'many_to_one', 'vendor_invoice->vendor': 'many_to_one', 'vendor->country': 'many_to_one'}
-//     // ['vendor_invoice', 'vendor'] -> many_to_one
-//     // ['vendor', 'country'] -> many_to_one
-//     return this.vendor?.country;
-//   }
-//   get organizationType(): OrganizationTypeEntityModel | undefined {
-//     // many_to_one -> many_to_one verified
-//     // {'vendor_invoice_item->vendor_invoice': 'many_to_one', 'vendor_invoice->vendor': 'many_to_one', 'vendor->organization_type': 'many_to_one'}
-//     // ['vendor_invoice', 'vendor'] -> many_to_one
-//     // ['vendor', 'organization_type'] -> many_to_one
-//     return this.vendor?.organizationType;
-//   }
-//   get officeLocation(): OfficeLocationEntityModel | undefined {
-//     // many_to_one -> many_to_one verified
-//     // {'vendor_invoice_item->vendor_invoice': 'many_to_one', 'vendor_invoice->office_location': 'many_to_one'}
-//     // ['vendor_invoice_item', 'vendor_invoice'] -> many_to_one
-//     // ['vendor_invoice', 'office_location'] -> many_to_one
-//     return this.vendorInvoice?.officeLocation;
-//   }
 // }

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

@@ -1,20 +1,22 @@
 import { EntityEnum, Nullable } from "../interface/entity.utils.interface";
-import { BaseEntityModel } from "./base.entity.model";
 import { RelationConfigs } from "../interface/relation-config.interface";
+import { BaseEntityModel } from "./base.entity.model";
 import { IVendorInvoiceItemEntity } from "../interface/vendor_invoice_item.entity.interface";
-import { VendorInvoiceEntityModel } from "./vendor_invoice.entity.model";
-import { VoucherTypeEntityModel } from "./voucher_type.entity.model";
+import { IGstRateEntity } from "../interface/gst_rate.entity.interface";
+import { ITdsRateEntity } from "../interface/tds_rate.entity.interface";
+import { IVendorEntity } from "../interface/vendor.entity.interface";
 import { ExpenseHeadEntityModel } from "./expense_head.entity.model";
 import { GstRateEntityModel } from "./gst_rate.entity.model";
 import { TdsRateEntityModel } from "./tds_rate.entity.model";
 import { VendorEntityModel } from "./vendor.entity.model";
-import { StateEntityModel } from "./state.entity.model";
-import { CountryEntityModel } from "./country.entity.model";
-import { OrganizationTypeEntityModel } from "./organization_type.entity.model";
-import { OfficeLocationEntityModel } from "./office_location.entity.model";
-import { IGstRateEntity } from "../interface/gst_rate.entity.interface";
-import { ITdsRateEntity } from "../interface/tds_rate.entity.interface";
-import { IVendorEntity } from "../interface/vendor.entity.interface";
+import { VendorInvoiceEntityModel } from "./vendor_invoice.entity.model";
+import { VoucherTypeEntityModel } from "./voucher_type.entity.model";
+export interface IVendorInvoiceItemEntityAmounts {
+    gstAmount: number;
+    tdsAmount: number;
+    invoiceAmount: number;
+    netAmount: number;
+}
 export declare class VendorInvoiceItemEntityModel extends BaseEntityModel<EntityEnum.VENDOR_INVOICE_ITEM> implements IVendorInvoiceItemEntity {
     id: number;
     vendorInvoiceId: number;
@@ -28,13 +30,13 @@ export declare class VendorInvoiceItemEntityModel extends BaseEntityModel<Entity
     netAmount: number;
     quantity: number;
     rate: number;
+    remark: Nullable<string>;
+    gstAmount: number;
+    tdsAmount: number;
     createdOn: number;
     updatedOn: number;
     createdBy: number;
     updatedBy: number;
-    remark: Nullable<string>;
-    gstAmount: number;
-    tdsAmount: number;
     vendorInvoice?: VendorInvoiceEntityModel;
     voucherType?: VoucherTypeEntityModel;
     expenseHead?: ExpenseHeadEntityModel;
@@ -49,11 +51,6 @@ export declare class VendorInvoiceItemEntityModel extends BaseEntityModel<Entity
     ], EntityEnum.VENDOR_INVOICE_ITEM>;
     static fromEntity(entity: IVendorInvoiceItemEntity): VendorInvoiceItemEntityModel;
     getRelationConfigs(): any[];
-    get vendor(): VendorEntityModel | undefined;
-    get state(): StateEntityModel | undefined;
-    get country(): CountryEntityModel | undefined;
-    get organizationType(): OrganizationTypeEntityModel | undefined;
-    get officeLocation(): OfficeLocationEntityModel | undefined;
     static calculateAmounts(params: {
         basicAmount: number;
         gstRateEntity: IGstRateEntity;
@@ -63,9 +60,3 @@ export declare class VendorInvoiceItemEntityModel extends BaseEntityModel<Entity
     static tdsRate(vendorEntity: IVendorEntity, tdsRateEntity: ITdsRateEntity): number;
     static AMOUNT_KEYS: (keyof IVendorInvoiceItemEntityAmounts)[];
 }
-export interface IVendorInvoiceItemEntityAmounts {
-    gstAmount: number;
-    tdsAmount: number;
-    invoiceAmount: number;
-    netAmount: number;
-}

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

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VendorInvoiceItemEntityModel = 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");
-const relation_type_enum_1 = require("../enums/relation-type.enum");
 const vendor_pan_type_enum_1 = require("../enums/vendor_pan_type_enum");
 class VendorInvoiceItemEntityModel extends base_entity_model_1.BaseEntityModel {
     constructor() {
@@ -20,13 +20,14 @@ class VendorInvoiceItemEntityModel extends base_entity_model_1.BaseEntityModel {
         this.netAmount = 0;
         this.quantity = 0;
         this.rate = 0;
+        // status: VendorInvoiceItemStatus = VendorInvoiceItemStatus.PENDING;
+        this.remark = null;
+        this.gstAmount = 0;
+        this.tdsAmount = 0;
         this.createdOn = 0;
         this.updatedOn = 0;
         this.createdBy = 0;
         this.updatedBy = 0;
-        this.remark = null;
-        this.gstAmount = 0;
-        this.tdsAmount = 0;
         // getAvailableActions(
         //   currentUser: UserEntityModel,
         //   config?: {
@@ -64,46 +65,6 @@ class VendorInvoiceItemEntityModel extends base_entity_model_1.BaseEntityModel {
     getRelationConfigs() {
         return this.constructor.prototype.constructor.relationConfigs || [];
     }
-    get vendor() {
-        // many_to_one -> many_to_one verified
-        // {'vendor_invoice_item->vendor_invoice': 'many_to_one', 'vendor_invoice->vendor': 'many_to_one'}
-        // ['vendor_invoice_item', 'vendor_invoice'] -> many_to_one
-        // ['vendor_invoice', 'vendor'] -> many_to_one
-        var _a;
-        return (_a = this.vendorInvoice) === null || _a === void 0 ? void 0 : _a.vendor;
-    }
-    get state() {
-        // many_to_one -> many_to_one verified
-        // {'vendor_invoice_item->vendor_invoice': 'many_to_one', 'vendor_invoice->vendor': 'many_to_one', 'vendor->state': 'many_to_one'}
-        // ['vendor_invoice', 'vendor'] -> many_to_one
-        // ['vendor', 'state'] -> many_to_one
-        var _a;
-        return (_a = this.vendor) === null || _a === void 0 ? void 0 : _a.stateModel;
-    }
-    get country() {
-        // many_to_one -> many_to_one verified
-        // {'vendor_invoice_item->vendor_invoice': 'many_to_one', 'vendor_invoice->vendor': 'many_to_one', 'vendor->country': 'many_to_one'}
-        // ['vendor_invoice', 'vendor'] -> many_to_one
-        // ['vendor', 'country'] -> many_to_one
-        throw new Error("Relation 'country' is not defined in VendorEntityModel. Please define the relation to access country from VendorInvoiceItemEntityModel.");
-        // return this.vendor?.country;
-    }
-    get organizationType() {
-        // many_to_one -> many_to_one verified
-        // {'vendor_invoice_item->vendor_invoice': 'many_to_one', 'vendor_invoice->vendor': 'many_to_one', 'vendor->organization_type': 'many_to_one'}
-        // ['vendor_invoice', 'vendor'] -> many_to_one
-        // ['vendor', 'organization_type'] -> many_to_one
-        var _a;
-        return (_a = this.vendor) === null || _a === void 0 ? void 0 : _a.organizationType;
-    }
-    get officeLocation() {
-        // many_to_one -> many_to_one verified
-        // {'vendor_invoice_item->vendor_invoice': 'many_to_one', 'vendor_invoice->office_location': 'many_to_one'}
-        // ['vendor_invoice_item', 'vendor_invoice'] -> many_to_one
-        // ['vendor_invoice', 'office_location'] -> many_to_one
-        var _a;
-        return (_a = this.vendorInvoice) === null || _a === void 0 ? void 0 : _a.officeLocation;
-    }
     // getNextStatus(dto: IVendorInvoiceItemUpdateDto, currentUser: IUserEntity): VendorInvoiceItemStatus {
     //   // const flow = vendorInvoiceConfigFlow as FlowConfig<
     //   //   VendorInvoiceActionStatusEnum,

package/dist/src/utils/entity.flow.util.d.ts

@@ -30,7 +30,7 @@ export declare function getPermittedActionsOld<T extends LeaveStatusActionPair,
 }, currentStatus: T["status"] | null, userPermissions: string[], combineActions?: T["action"][], actionLabels?: {
     [key in T["action"]]?: string;
 }, data?: (a: E) => {
-    [permissionName: string]: () => boolean;
+    [key: string]: () => boolean;
 }): {
     label: string;
     value: T["action"] | string;
@@ -73,91 +73,91 @@ export declare function getPermittedActions<T extends LeaveStatusActionPair, E>(
 }, currentStatus: T["status"] | null, userPermissions: string[], data?: (a: E) => {
     [key: string]: () => boolean;
 }): T["action"][];
-export declare class EntityActionFlowResolver<E extends EntityEnum, STATUS_ENUM_TYPE extends string, ACTION_ENUM_TYPE extends string, CONTEXT_DATA_TYPE = never> {
+export declare class EntityActionFlowResolver<E extends EntityEnum, S extends string, A extends string> {
     getPermittedActions(entityFlowConfig: {
-        [key in STATUS_ENUM_TYPE]?: {
+        [key in S]?: {
             actions: {
-                [key in ACTION_ENUM_TYPE]?: {
+                [key in A]?: {
                     permissions: string[];
-                    next: (data: CONTEXT_DATA_TYPE) => STATUS_ENUM_TYPE;
+                    next: () => S;
                 };
             };
         };
-    }, currentStatus: STATUS_ENUM_TYPE | null, userPermissions: string[], data?: (a: E) => {
+    }, currentStatus: S | null, userPermissions: string[], data?: (a: E) => {
         [key: string]: () => boolean;
-    }): ACTION_ENUM_TYPE[];
+    }): A[];
     _getPermittedActions(actionConfig: {
-        [key in ACTION_ENUM_TYPE]?: {
+        [key in A]?: {
             permissions: string[];
-            next: (data: CONTEXT_DATA_TYPE) => STATUS_ENUM_TYPE;
+            next: () => S;
         };
     }, userPermissions: string[], data: (a: E) => {
         [key: string]: () => boolean;
-    }): (ACTION_ENUM_TYPE | string)[];
-    combinePermittedActions(permittedActions: readonly ACTION_ENUM_TYPE[], combinedActions?: Record<string, {
-        combineActions: readonly ACTION_ENUM_TYPE[];
+    }): (A | string)[];
+    combinePermittedActions(permittedActions: readonly A[], combinedActions?: Record<string, {
+        combineActions: readonly A[];
         label: string;
-    }>): Map<ACTION_ENUM_TYPE | string, string>;
-    applyActionLabels(result: Map<ACTION_ENUM_TYPE | string, string>, customLabels?: Partial<Record<ACTION_ENUM_TYPE, string>>): Map<ACTION_ENUM_TYPE | string, string>;
-    getAvailableActionsLabelValue(availableActionsFromModel: Map<ACTION_ENUM_TYPE | string, string>): {
+    }>): Map<A | string, string>;
+    applyActionLabels(result: Map<A | string, string>, customLabels?: Partial<Record<A, string>>): Map<A | string, string>;
+    getAvailableActionsLabelValue(availableActionsFromModel: Map<A | string, string>): {
         label: string;
         value: string;
     }[];
     getAvailableActionsData(params: {
-        flowConfig: FlowConfig<STATUS_ENUM_TYPE, ACTION_ENUM_TYPE, CONTEXT_DATA_TYPE>;
-        currentStatus: STATUS_ENUM_TYPE | null;
+        flowConfig: FlowConfig<S, A>;
+        currentStatus: S | null;
         userPermissions: string[];
         visibilityData?: (e: E) => {
             [key: string]: () => boolean;
         };
         combinedActions?: Record<string, {
-            combineActions: readonly ACTION_ENUM_TYPE[];
+            combineActions: readonly A[];
             label: string;
         }>;
-        customLabels?: Partial<Record<ACTION_ENUM_TYPE, string>>;
+        customLabels?: Partial<Record<A, string>>;
     }): IRowActions<E>[];
 }
 export declare class EntityActionFlowResolverV2 {
-    static getPermittedActions<E extends EntityEnum, STATUS_ENUM_TYPE extends string, ACTION_ENUM_TYPE extends string, CONTEXT_DATA_TYPE = never>(entityFlowConfig: {
-        [key in STATUS_ENUM_TYPE]?: {
+    static getPermittedActions<E extends EntityEnum, S extends string, A extends string>(entityFlowConfig: {
+        [key in S]?: {
             actions: {
-                [key in ACTION_ENUM_TYPE]?: {
+                [key in A]?: {
                     permissions: string[];
-                    next: (data: CONTEXT_DATA_TYPE) => STATUS_ENUM_TYPE;
+                    next: () => S;
                 };
             };
         };
-    }, currentStatus: STATUS_ENUM_TYPE | null, userPermissions: string[], data?: (a: E) => {
+    }, currentStatus: S | null, userPermissions: string[], data?: (a: E) => {
         [key: string]: () => boolean;
-    }): ACTION_ENUM_TYPE[];
-    static _getPermittedActions<E extends EntityEnum, STATUS_ENUM_TYPE extends string, ACTION_ENUM_TYPE extends string, CONTEXT_DATA_TYPE = never>(actionConfig: {
-        [key in ACTION_ENUM_TYPE]?: {
+    }): A[];
+    static _getPermittedActions<E extends EntityEnum, S extends string, A extends string>(actionConfig: {
+        [key in A]?: {
             permissions: string[];
-            next: (data: CONTEXT_DATA_TYPE) => STATUS_ENUM_TYPE;
+            next: () => S;
         };
     }, userPermissions: string[], data: (a: E) => {
-        [permissionName: string]: () => boolean;
-    }): (ACTION_ENUM_TYPE | string)[];
-    static combinePermittedActions<ACTION_ENUM_TYPE extends string>(permittedActions: readonly ACTION_ENUM_TYPE[], combinedActions?: Record<string, {
-        combineActions: readonly ACTION_ENUM_TYPE[];
+        [key: string]: () => boolean;
+    }): (A | string)[];
+    static combinePermittedActions<A extends string>(permittedActions: readonly A[], combinedActions?: Record<string, {
+        combineActions: readonly A[];
         label: string;
-    }>): Map<ACTION_ENUM_TYPE | string, string>;
-    static applyActionLabels<ACTION_ENUM_TYPE extends string>(result: Map<ACTION_ENUM_TYPE | string, string>, customLabels?: Partial<Record<ACTION_ENUM_TYPE, string>>): Map<ACTION_ENUM_TYPE | string, string>;
-    static getAvailableActionsLabelValue<ACTION_ENUM_TYPE extends string>(availableActionsFromModel: Map<ACTION_ENUM_TYPE | string, string>): {
+    }>): Map<A | string, string>;
+    static applyActionLabels<A extends string>(result: Map<A | string, string>, customLabels?: Partial<Record<A, string>>): Map<A | string, string>;
+    static getAvailableActionsLabelValue<A extends string>(availableActionsFromModel: Map<A | string, string>): {
         label: string;
         value: string;
     }[];
-    static getAvailableActionsData<E extends EntityEnum, STATUS_ENUM_TYPE extends string, ACTION_ENUM_TYPE extends string, FLOW_CONTEXT_DATA_TYPE = never>(params: {
-        flowConfig: FlowConfig<STATUS_ENUM_TYPE, ACTION_ENUM_TYPE, FLOW_CONTEXT_DATA_TYPE>;
-        currentStatus: STATUS_ENUM_TYPE | null;
+    static getAvailableActionsData<E extends EntityEnum, S extends string, A extends string>(params: {
+        flowConfig: FlowConfig<S, A>;
+        currentStatus: S | null;
         userPermissions: string[];
         visibilityData?: (e: E) => {
             [key: string]: () => boolean;
         };
         combinedActions?: Record<string, {
-            combineActions: readonly ACTION_ENUM_TYPE[];
+            combineActions: readonly A[];
             label: string;
         }>;
-        customLabels?: Partial<Record<ACTION_ENUM_TYPE, string>>;
+        customLabels?: Partial<Record<A, string>>;
     }): IRowActions<E>[];
 }

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

@@ -437,3 +437,8 @@ export declare function sumNormalised<T>(input: T[], key: keyof T): number;
  */
 export declare function isDefined<T>(value: T | null | undefined): value is T;
 export declare function removeDuplicatesByKey<T, K extends keyof T>(items: T[], key: K): T[];
+/**
+ * Extracts unique values from an array of objects by key.
+ * Preserves the exact type of the key (string[] or number[]).
+ */
+export declare function getUniqueValuesByKey<T, K extends keyof T>(items: T[], key: K): T[K][];

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

@@ -47,6 +47,7 @@ exports.getNormalisedFromKey = getNormalisedFromKey;
 exports.sumNormalised = sumNormalised;
 exports.isDefined = isDefined;
 exports.removeDuplicatesByKey = removeDuplicatesByKey;
+exports.getUniqueValuesByKey = getUniqueValuesByKey;
 const date_fns_1 = require("date-fns");
 const lodash_1 = require("lodash");
 const util_constants_1 = require("../constants/util.constants");
@@ -802,3 +803,10 @@ function removeDuplicatesByKey(items, key) {
     }
     return Array.from(map.values());
 }
+/**
+ * Extracts unique values from an array of objects by key.
+ * Preserves the exact type of the key (string[] or number[]).
+ */
+function getUniqueValuesByKey(items, key) {
+    return [...new Set(items.map((item) => item[key]))];
+}

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

@@ -75,4 +75,12 @@ export declare class DateCodeModel {
      * // equivalent to: new DateCodeModel(DateCodeModel.fromDate(new Date('2025-01-01')))
      */
     static fromDateObject(date: Date): DateCodeModel;
+    /**
+     * Returns the earliest (min) and latest (max) dateCodes (YYYYMMDD) from a list.
+     * Accepts string | undefined | DateCodeModel and normalizes internally.
+     */
+    static getMinMax(dateCodes: (string | undefined | DateCodeModel)[]): {
+        min: string | null;
+        max: string | null;
+    };
 }

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

@@ -330,5 +330,29 @@ class DateCodeModel {
     static fromDateObject(date) {
         return new DateCodeModel(DateCodeModel.fromDate(date));
     }
+    /**
+     * Returns the earliest (min) and latest (max) dateCodes (YYYYMMDD) from a list.
+     * Accepts string | undefined | DateCodeModel and normalizes internally.
+     */
+    static getMinMax(dateCodes) {
+        if (!dateCodes || dateCodes.length === 0) {
+            return { min: null, max: null };
+        }
+        const models = dateCodes.filter((d) => d != null).map((d) => (d instanceof DateCodeModel ? d : new DateCodeModel(d)));
+        if (models.length === 0) {
+            return { min: null, max: null };
+        }
+        let min = models[0];
+        let max = models[0];
+        for (const current of models) {
+            if (current.dateCode < min.dateCode) {
+                min = current;
+            }
+            if (current.dateCode > max.dateCode) {
+                max = current;
+            }
+        }
+        return { min: min.dateCode, max: max.dateCode };
+    }
 }
 exports.DateCodeModel = DateCodeModel;

package/package.json

@@ -1,41 +1,41 @@
-{
-  "name": "law-common",
-  "version": "10.72.1-beta.2",
-  "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 && npm run link",
-    "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",
-    "format": "prettier --write .",
-    "check-format": "prettier --check .",
-    "pull:link": "git pull && npm run link"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "devDependencies": {
-    "@types/jest": "^29.5.13",
-    "@types/lodash": "^4.17.21",
-    "@types/node": "^22.6.1",
-    "jest": "^29.7.0",
-    "prettier": "3.8.1",
-    "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.72.1-beta.3",
+  "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 && npm run link",
+    "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",
+    "format": "prettier --write .",
+    "check-format": "prettier --check .",
+    "pull:link": "git pull && npm run link"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/jest": "^29.5.13",
+    "@types/lodash": "^4.17.21",
+    "@types/node": "^22.6.1",
+    "jest": "^29.7.0",
+    "prettier": "3.8.1",
+    "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"
+  }
+}