law-common 10.29.0 → 10.30.1-beta.0

package/dist/src/api/enums/crud.enum.d.ts

@@ -0,0 +1,7 @@
+export declare enum CRUDEnum {
+    CREATE = "CREATE",
+    READ = "READ",
+    UPDATE = "UPDATE",
+    DELETE = "DELETE",
+    UNCHANGED = "UNCHANGED"
+}

package/dist/src/api/enums/crud.enum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CRUDEnum = void 0;
+var CRUDEnum;
+(function (CRUDEnum) {
+    CRUDEnum["CREATE"] = "CREATE";
+    CRUDEnum["READ"] = "READ";
+    CRUDEnum["UPDATE"] = "UPDATE";
+    CRUDEnum["DELETE"] = "DELETE";
+    CRUDEnum["UNCHANGED"] = "UNCHANGED";
+})(CRUDEnum || (exports.CRUDEnum = CRUDEnum = {}));

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

@@ -48,3 +48,7 @@ export * from "./interface/work.from.home.create.dto.interface";
 export * from "./interface/work.from.home.update.interface";
 export * from "./interface/cron-job-manual-trigger.dto.interface";
 export * from "./interface/cron-job.entity.response";
+export * from "./interface/address-book.create.dto.interface";
+export * from "./enums/crud.enum";
+export * from "./interface/api.utils.interface";
+export * from "./interface/address-book.update.dto.interface";

package/dist/src/api/index.js

@@ -64,3 +64,11 @@ __exportStar(require("./interface/work.from.home.create.dto.interface"), exports
 __exportStar(require("./interface/work.from.home.update.interface"), exports);
 __exportStar(require("./interface/cron-job-manual-trigger.dto.interface"), exports);
 __exportStar(require("./interface/cron-job.entity.response"), exports);
+// export * from "./interface/to-do.entity.api";
+// export * from "./interface/billing-reimbursement-expense.api";
+// export * from "./interface/billing-reimbursement-expense-history.api";
+// export * from "./interface/project-user-mapping.entity.api";
+__exportStar(require("./interface/address-book.create.dto.interface"), exports);
+__exportStar(require("./enums/crud.enum"), exports);
+__exportStar(require("./interface/api.utils.interface"), exports);
+__exportStar(require("./interface/address-book.update.dto.interface"), exports);

package/dist/src/api/interface/address-book.create.dto.interface.d.ts

@@ -0,0 +1,21 @@
+import { IAddressBookEntity, IEntityCreateDto } from "../../entities";
+import { CRUDEnum } from "../enums/crud.enum";
+export type IAddressBookCreateExclude = "contactDetails" | "address" | "organizationId";
+export interface IAddressBookContactDetail {
+    id?: number;
+    name: string;
+    email?: string;
+    phone?: string;
+    operation: CRUDEnum;
+}
+export interface IAddressBookAddress {
+    addressLine1?: string;
+    addressLine2?: string;
+    city?: string;
+    state?: string;
+    zipCode?: string;
+}
+export interface IAddressBookCreateDto extends Omit<IEntityCreateDto<IAddressBookEntity>, IAddressBookCreateExclude> {
+    contactDetails: IAddressBookContactDetail[];
+    address?: IAddressBookAddress;
+}

package/dist/src/api/interface/address-book.create.dto.interface.js

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

package/dist/src/api/interface/address-book.update.dto.interface.d.ts

@@ -0,0 +1,3 @@
+import { IAddressBookCreateDto } from "./address-book.create.dto.interface";
+import { DeepPartialButRequired } from "./api.utils.interface";
+export type IAddressBookUpdateDto = DeepPartialButRequired<IAddressBookCreateDto, never>;

package/dist/src/api/interface/address-book.update.dto.interface.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// export type IAddressBookUpdateDto = DeepPartialButRequired<
+//     Omit<IAddressBookCreateDto, 'contactDetails'>,
+//     never
+// > & {
+//     contactDetails?: DeepPartialButRequired<IAddressBookContactDetail, 'id'>[];  // id required per item
+//     // address?: DeepPartial<IAddressBookAddress>;
+// };
+// const a: IAddressBookUpdateDto = {
+//     organizationName: "Test Name",
+//     contactDetails: [
+//         {
+//             id: 1,
+//             email: "test@example.com",
+//             phone: "123-456-7890"
+//         }
+//     ]
+// };
+// const b: IAddressBookUpdateDto = {
+//     organizationName: "Test Name",
+//     address: {
+//         city: "Sample City"
+//     }
+// };

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

@@ -0,0 +1,4 @@
+export type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: T[P] extends Array<infer U> ? Array<DeepPartial<U>> : T[P] extends object ? DeepPartial<T[P]> : T[P];
+} : T;
+export type DeepPartialButRequired<T, K extends keyof T> = DeepPartial<T> & Required<Pick<T, K>>;

package/dist/src/api/interface/api.utils.interface.js

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

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

@@ -63,6 +63,7 @@ export * from "./interface/billing_timesheet.entity.interface";
 export * from "./interface/intermediary_bank.entity.interface";
 export * from "./interface/holiday-list.entity.interface";
 export * from "./interface/holiday.entity.interface";
+export * from "./interface/address-book.entity.interface";
 export * from "./model/leave.entity.model";
 export * from "./model/leave_count.entity.model";
 export * from "./model/holiday.entity.model";
@@ -96,8 +97,10 @@ export * from "./model/timesheet.entity.model";
 export * from "./model/user.entity.model";
 export * from "./model/client-affiliate.entity.model";
 export * from "./model/billing-timesheet.entity.model";
+export * from "./model/country.entity.model";
 export * from "./interface/entity-audit-columns.interface";
 export * from "./enums/billing-transaction-action.enum";
 export * from "./enums/billing-transaction-status.enum";
 export * from "./interface/billing-transaction-history.entity";
 export * from "./model/billing-transaction.model";
+export * from "./interface/address-book.entity.interface";

package/dist/src/entities/index.js

@@ -79,6 +79,7 @@ __exportStar(require("./interface/billing_timesheet.entity.interface"), exports)
 __exportStar(require("./interface/intermediary_bank.entity.interface"), exports);
 __exportStar(require("./interface/holiday-list.entity.interface"), exports);
 __exportStar(require("./interface/holiday.entity.interface"), exports);
+__exportStar(require("./interface/address-book.entity.interface"), exports);
 __exportStar(require("./model/leave.entity.model"), exports);
 __exportStar(require("./model/leave_count.entity.model"), exports);
 __exportStar(require("./model/holiday.entity.model"), exports);
@@ -112,8 +113,10 @@ __exportStar(require("./model/timesheet.entity.model"), exports);
 __exportStar(require("./model/user.entity.model"), exports);
 __exportStar(require("./model/client-affiliate.entity.model"), exports);
 __exportStar(require("./model/billing-timesheet.entity.model"), exports);
+__exportStar(require("./model/country.entity.model"), exports);
 __exportStar(require("./interface/entity-audit-columns.interface"), exports);
 __exportStar(require("./enums/billing-transaction-action.enum"), exports);
 __exportStar(require("./enums/billing-transaction-status.enum"), exports);
 __exportStar(require("./interface/billing-transaction-history.entity"), exports);
 __exportStar(require("./model/billing-transaction.model"), exports);
+__exportStar(require("./interface/address-book.entity.interface"), exports);

package/dist/src/entities/interface/address-book.entity.interface.d.ts

@@ -0,0 +1,11 @@
+import { IEntityAuditColumn } from "./entity-audit-columns.interface";
+export interface IAddressBookEntity extends IEntityAuditColumn {
+    id: number;
+    organizationName: string;
+    contactDetails: string;
+    address?: string;
+    country: string;
+    notes?: string;
+    organizationId: number;
+    introducedBy?: number;
+}

package/dist/src/entities/interface/address-book.entity.interface.js

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

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

@@ -3,6 +3,7 @@ import { ConvertToArray } from "../../misc";
 import { Modify } from "../../misc/interface/modify.interface";
 import { EntitySearchConstraintTypeEnum } from "../enums/entity_search_constraint_type.enum";
 import { HistoryOperationEnum } from "../enums/history_operation.enum";
+import { AddressBookEntityModel } from "../model/address_book.model";
 import { BankEntityModel } from "../model/bank.entity.model";
 import { BillingReimbursementExpneseEntityModel } from "../model/billing-reimbursement-expense.entity.model";
 import { BillingTimesheetEntityModel } from "../model/billing-timesheet.entity.model";
@@ -11,6 +12,7 @@ import { BillingEntityModel } from "../model/billing.entity.model";
 import { ClientAffiliateEntityModel } from "../model/client-affiliate.entity.model";
 import { ClientEntityModel } from "../model/client.entity.model";
 import { ConfigurationEntityModel } from "../model/configuration.model";
+import { CountryEntityModel } from "../model/country.entity.model";
 import { HolidayEntityModel } from "../model/holiday.entity.model";
 import { LeaveEntityModel } from "../model/leave.entity.model";
 import { LeaveCountVirtualEntityModel } from "../model/leave_count.entity.model";
@@ -21,6 +23,7 @@ import { ReimbursementEntityModel } from "../model/reimbursement.entity.model";
 import { TaskEntityModel } from "../model/task.entity.model";
 import { TimesheetEntityModel } from "../model/timesheet.entity.model";
 import { UserEntityModel } from "../model/user.entity.model";
+import { IAddressBookEntity } from "./address-book.entity.interface";
 import { IBankEntity } from "./bank.entity.interface";
 import { IBankHistoryEntity } from "./bank_history.entity.interface";
 import { IBillingReimbursementExpenseEntity } from "./billing-reimbursement-expense.entity.interface";
@@ -139,7 +142,8 @@ export declare enum EntityEnum {
     HOLIDAY = "holiday",
     HOLIDAY_LIST = "holiday_list",
     CRON_JOBS = "cron_jobs",
-    TO_DO_LIST = "to_do_list"
+    TO_DO_LIST = "to_do_list",
+    ADDRESS_BOOK = "address_book"
 }
 export type EntityRelations = {
     [K in EntityEnum | VirtualEntityEnum]: K;
@@ -158,7 +162,7 @@ export type IBaseEntityApiResponse<T> = {
         [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.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.BILLING_TRANSACTION_HISTORY ? IBillingTransactionHistoryEntity : 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 EntityEnum.BANK_HISTORY ? IBankHistoryEntity : T extends VirtualEntityEnum.LEAVE_COUNT ? ILeaveCountVirtualEntity : 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.BILLING_TRANSACTION_HISTORY ? IBillingTransactionHistoryEntity : 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 EntityEnum.BANK_HISTORY ? IBankHistoryEntity : T extends VirtualEntityEnum.LEAVE_COUNT ? ILeaveCountVirtualEntity : T extends EntityEnum.LEAVE_HISTORY ? ILeaveHistoryEntity : T extends EntityEnum.WORK_FROM_HOME_HISTORY ? IWorkFromHomeHistoryEntity : T extends EntityEnum.TIMESHEET_HISTORY ? ITimesheetHistoryEntity : T extends EntityEnum.ADDRESS_BOOK ? IAddressBookEntity : never) & {
     id: number;
 };
 export type EntityRelationConfig<T extends EntityEnum | VirtualEntityEnum> = {
@@ -281,7 +285,7 @@ export declare enum VirtualEntityEnum {
 }
 export type IHistoryConstraintSearchResponse<T> = IBaseResponse<IHistoryEntitySearchByConstraintResponse<T>[]>;
 export type IHistoryConstraintSearchServiceResponse<T> = IHistoryEntitySearchByConstraintResponse<T>[];
-export type EnumToModel<T extends EntityEnum | VirtualEntityEnum> = T extends EntityEnum.BILLING ? BillingEntityModel : T extends EntityEnum.CLIENT ? ClientEntityModel : T extends EntityEnum.PROJECT ? ProjectEntityModel : T extends EntityEnum.PROJECT_USER_MAPPING ? ProjectUserMappingEntityModel : T extends EntityEnum.REIMBURSEMENT ? ReimbursementEntityModel : T extends EntityEnum.REIMBURSEMENT_EXPENSE ? ReimbursementExpenseEntityModel : T extends EntityEnum.BILLING_REIMBURSEMENT_EXPENSE ? BillingReimbursementExpneseEntityModel : T extends EntityEnum.LEAVE ? LeaveEntityModel : T extends EntityEnum.HOLIDAY ? HolidayEntityModel : T extends VirtualEntityEnum.LEAVE_COUNT ? LeaveCountVirtualEntityModel : T extends EntityEnum.CLIENT_AFFILIATE ? ClientAffiliateEntityModel : T extends EntityEnum.BANK ? BankEntityModel : T extends EntityEnum.CONFIGURATION ? ConfigurationEntityModel : T extends EntityEnum.TASK ? TaskEntityModel : T extends EntityEnum.BILLING_TIMESHEET ? BillingTimesheetEntityModel : T extends EntityEnum.TIMESHEET ? TimesheetEntityModel : T extends EntityEnum.BILLING_TRANSACTION ? BillingTransactionEntityModel : UserEntityModel;
+export type EnumToModel<T extends EntityEnum | VirtualEntityEnum> = T extends EntityEnum.BILLING ? BillingEntityModel : T extends EntityEnum.CLIENT ? ClientEntityModel : T extends EntityEnum.PROJECT ? ProjectEntityModel : T extends EntityEnum.PROJECT_USER_MAPPING ? ProjectUserMappingEntityModel : T extends EntityEnum.REIMBURSEMENT ? ReimbursementEntityModel : T extends EntityEnum.REIMBURSEMENT_EXPENSE ? ReimbursementExpenseEntityModel : T extends EntityEnum.BILLING_REIMBURSEMENT_EXPENSE ? BillingReimbursementExpneseEntityModel : T extends EntityEnum.LEAVE ? LeaveEntityModel : T extends EntityEnum.HOLIDAY ? HolidayEntityModel : T extends VirtualEntityEnum.LEAVE_COUNT ? LeaveCountVirtualEntityModel : T extends EntityEnum.CLIENT_AFFILIATE ? ClientAffiliateEntityModel : T extends EntityEnum.BANK ? BankEntityModel : T extends EntityEnum.CONFIGURATION ? ConfigurationEntityModel : T extends EntityEnum.TASK ? TaskEntityModel : T extends EntityEnum.BILLING_TIMESHEET ? BillingTimesheetEntityModel : T extends EntityEnum.TIMESHEET ? TimesheetEntityModel : T extends EntityEnum.COUNTRY ? CountryEntityModel : T extends EntityEnum.BILLING_TRANSACTION ? BillingTransactionEntityModel : T extends EntityEnum.ADDRESS_BOOK ? AddressBookEntityModel : UserEntityModel;
 export type EntityMap = {
     [key in EntityEnum | VirtualEntityEnum]: EnumToModel<key>[];
 };

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

@@ -77,6 +77,7 @@ var EntityEnum;
     EntityEnum["HOLIDAY_LIST"] = "holiday_list";
     EntityEnum["CRON_JOBS"] = "cron_jobs";
     EntityEnum["TO_DO_LIST"] = "to_do_list";
+    EntityEnum["ADDRESS_BOOK"] = "address_book";
 })(EntityEnum || (exports.EntityEnum = EntityEnum = {}));
 var VirtualEntityEnum;
 (function (VirtualEntityEnum) {

package/dist/src/entities/model/address_book.model.d.ts

@@ -0,0 +1,31 @@
+import { RelationType } from "../enums/relation-type.enum";
+import { IAddressBookEntity } from "../interface/address-book.entity.interface";
+import { EntityEnum } from "../interface/entity.utils.interface";
+import { BaseEntityModel } from "./base.entity.model";
+import { UserEntityModel } from "./user.entity.model";
+export declare class AddressBookEntityModel extends BaseEntityModel<EntityEnum.ADDRESS_BOOK> implements IAddressBookEntity {
+    id: number;
+    organizationName: string;
+    contactDetails: string;
+    address?: string | undefined;
+    country: string;
+    notes?: string | undefined;
+    organizationId: number;
+    introducedBy?: number | undefined;
+    createdOn: number;
+    updatedOn: number;
+    createdBy: number;
+    updatedBy: number;
+    introducedByUser?: UserEntityModel | undefined;
+    static fromEntity(entity: IAddressBookEntity): AddressBookEntityModel;
+    static relationConfigs: {
+        name: EntityEnum;
+        relation: RelationType;
+        key: string;
+        mapKeyConfig: {
+            relationKey: string;
+            key: string;
+        };
+    }[];
+    getRelationConfigs(): any[];
+}

package/dist/src/entities/model/address_book.model.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressBookEntityModel = void 0;
+const relation_type_enum_1 = require("../enums/relation-type.enum");
+const entity_utils_interface_1 = require("../interface/entity.utils.interface");
+const base_entity_model_1 = require("./base.entity.model");
+class AddressBookEntityModel extends base_entity_model_1.BaseEntityModel {
+    constructor() {
+        super(...arguments);
+        this.id = 0;
+        this.organizationName = "";
+        this.contactDetails = "";
+        this.address = "";
+        this.country = "";
+        this.notes = "";
+        this.organizationId = 0;
+        this.introducedBy = 0;
+        this.createdOn = 0;
+        this.updatedOn = 0;
+        this.createdBy = 0;
+        this.updatedBy = 0;
+    }
+    static fromEntity(entity) {
+        const result = new AddressBookEntityModel(entity_utils_interface_1.EntityEnum.ADDRESS_BOOK);
+        Object.assign(result, entity);
+        return result;
+    }
+    getRelationConfigs() {
+        return this.constructor.prototype.constructor.relationConfigs || [];
+    }
+}
+exports.AddressBookEntityModel = AddressBookEntityModel;
+AddressBookEntityModel.relationConfigs = [
+    {
+        name: entity_utils_interface_1.EntityEnum.USER,
+        relation: relation_type_enum_1.RelationType.ONE,
+        key: "introducedByUser",
+        mapKeyConfig: {
+            relationKey: "id",
+            key: "introducedBy",
+        },
+    }
+];

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

@@ -4,7 +4,7 @@ export declare enum RelationType {
     MANY = "many"
 }
 export declare abstract class BaseEntityModel<T extends EntityEnum | VirtualEntityEnum> {
-    protected entityName: T;
+    readonly entityName: T;
     constructor(entityName: T);
     abstract getRelationConfigs(): any[];
     populateRelationsByIndex(entityIndexMap: EntityIndexMap): void;

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

@@ -15,7 +15,7 @@ class BaseEntityModel {
             const thisMappingKey = relationConfig.mapKeyConfig.key;
             const relatedMappingKey = relationConfig.mapKeyConfig.relationKey;
             const thisKey = relationConfig.key;
-            // console.log('Populating relation for', relationConfig.name, 'on', this.entityName, relationConfig);
+            console.log('Populating relation for', relationConfig.name, 'on', this.entityName, relationConfig);
             // debugger;
             if (relationConfig.relation === RelationType.ONE) {
                 const relatedEntities = entityIndexMap[relationConfig.name] || {};
@@ -37,11 +37,15 @@ class BaseEntityModel {
                 }
                 else {
                     // foundRelatedEntities = relatedEntities[this[thisKey]] ? [relatedEntities[this[thisKey]]] : [];
-                    const relatedEntity = relatedEntities[this[thisMappingKey]];
-                    if (relatedEntity) {
+                    // console.log(
+                    //   `[populateRelationsByIndex] Looking for relation "${relationConfig.name}" on entity "${this.entityName}" where relatedEntities[${this[thisMappingKey]}]`
+                    // );
+                    if (relatedMappingKey === "id") {
+                        const relatedEntity = relatedEntities[this[thisMappingKey]];
                         foundRelatedEntities = [relatedEntity];
                     }
                     else if (relatedMappingKey !== "id") {
+                        console.log(`[populateRelationsByIndex] Searching through related entities for relation "${relationConfig.name}" on entity "${this.entityName}"`);
                         foundRelatedEntities = Object.values(relatedEntities).filter((entity) => entity[relatedMappingKey] === this[thisMappingKey]);
                     }
                     else {

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

@@ -0,0 +1,11 @@
+import { ICountryEntity } from "../interface/country.entity.interface";
+export declare class CountryEntityModel implements ICountryEntity {
+    id: number;
+    name: string;
+    createdBy: number;
+    updatedBy: number;
+    createdOn: number;
+    updatedOn: number;
+    constructor(data?: ICountryEntity);
+    static fromApiEntity(apiEntity: ICountryEntity): CountryEntityModel;
+}

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

@@ -0,0 +1,21 @@
+"use strict";
+// import { ICountryApiEntity } from "../../api";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CountryEntityModel = void 0;
+class CountryEntityModel {
+    constructor(data) {
+        this.id = 0;
+        this.name = "";
+        this.createdBy = 0;
+        this.updatedBy = 0;
+        this.createdOn = 0;
+        this.updatedOn = 0;
+        Object.assign(this, data);
+    }
+    static fromApiEntity(apiEntity) {
+        const entity = new CountryEntityModel(apiEntity);
+        Object.assign(entity, apiEntity);
+        return entity;
+    }
+}
+exports.CountryEntityModel = CountryEntityModel;

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

@@ -1,19 +1,42 @@
 import { EntityEnum, EntityIndexMap, EntityMap, EnumEntityType, EnumToModel, IApiEntity, IBaseEntityApiResponse, VirtualEntityEnum } from "../interface/entity.utils.interface";
+import { BaseEntityModel } from "./base.entity.model";
 export declare function mapToIndex(entityMap: EntityMap): EntityIndexMap;
 export declare function getEntityIndexMap<T extends EntityEnum>(data: IBaseEntityApiResponse<EnumEntityType<T>>, baseEntity: T, reusedConfig?: {
     existingEntityIndexMap: EntityIndexMap;
     enumEntities: EntityEnum[];
 }): EntityIndexMap;
 export declare function populateRelationsFor(entityIndexMap: EntityIndexMap, enumEntities: EntityEnum[]): void;
-export declare function parseEntities<T extends EnumEntityType<EntityEnum>>(json: IBaseEntityApiResponse<T>, baseEntity: EntityEnum, entityMap: EntityMap): EntityMap;
 export declare const entityEnumToEntityModel: {
-    [E in EntityEnum | VirtualEntityEnum]?: (json: IApiEntity<EnumEntityType<E>> & {
-        createdOn: number;
-        updatedOn: number;
-    }) => EnumToModel<E>;
+    [E in EntityEnum | VirtualEntityEnum]?: (json: EnumEntityType<E>) => EnumToModel<E>;
 };
+export declare function entityMapToModels(entityMap: EntityMap): void;
+export declare function parseEntities<T extends EnumEntityType<EntityEnum | VirtualEntityEnum>>(json: IBaseEntityApiResponse<T>, baseEntity: EntityEnum | VirtualEntityEnum, entityMap: EntityMap): EntityMap;
+export declare function entityMapToEntityIndexMap(entityMap: EntityMap, entityRelationsFor: EntityEnum[]): EntityIndexMap;
 export declare function parseEntitiesWithoutModels<T extends EnumEntityType<EntityEnum | VirtualEntityEnum>>(json: IBaseEntityApiResponse<T>, baseEntity: EntityEnum | VirtualEntityEnum, entityMap?: {
     [E in EntityEnum | VirtualEntityEnum]?: IApiEntity<EnumEntityType<E>>[];
 }): {
     [E in EntityEnum | VirtualEntityEnum]?: IApiEntity<EnumEntityType<E>>[];
 };
+export declare function removeEntityById(entityIndexMap: EntityIndexMap, entity: EntityEnum, id: number): void;
+export declare class EntityModelRelationHelper {
+    entityMap: EntityMap;
+    entityModelMap: EntityMap;
+    entityModelIndexMap: EntityIndexMap;
+    constructor(entityMap: EntityMap);
+    private init;
+    private toEntityModelMap;
+    fromEntityToEntityModel<T extends EntityEnum | VirtualEntityEnum>(entity: EnumEntityType<T>, entityEnum: T): BaseEntityModel<T>;
+    private toEntityModelIndexMap;
+    populateRelationsByEntityEnums(entityEnums: EntityEnum[]): EntityModelRelationHelper;
+    populateRelationsByEntityEnum(entityEnum: EntityEnum): void;
+    populateRelationsByEntityModel(entityModel: BaseEntityModel<EntityEnum | VirtualEntityEnum>): void;
+    addEntityModel<T extends EntityEnum | VirtualEntityEnum>(entityModel: BaseEntityModel<T>, config?: {
+        populateRelations?: boolean;
+    }): void;
+    addEntity<T extends EntityEnum | VirtualEntityEnum>(entity: EnumEntityType<T>, entityEnum: T, config?: {
+        populateRelations?: boolean;
+    }): void;
+    updateEntityModel<T extends EntityEnum | VirtualEntityEnum>(entityModel: BaseEntityModel<T>, config?: {
+        populateRelations?: boolean;
+    }): void;
+}

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

@@ -1,24 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.entityEnumToEntityModel = void 0;
+exports.EntityModelRelationHelper = exports.entityEnumToEntityModel = void 0;
 exports.mapToIndex = mapToIndex;
 exports.getEntityIndexMap = getEntityIndexMap;
 exports.populateRelationsFor = populateRelationsFor;
+exports.entityMapToModels = entityMapToModels;
 exports.parseEntities = parseEntities;
+exports.entityMapToEntityIndexMap = entityMapToEntityIndexMap;
 exports.parseEntitiesWithoutModels = parseEntitiesWithoutModels;
+exports.removeEntityById = removeEntityById;
 const entity_utils_interface_1 = require("../interface/entity.utils.interface");
 const bank_entity_model_1 = require("./bank.entity.model");
 const base_entity_model_1 = require("./base.entity.model");
 const billing_reimbursement_expense_entity_model_1 = require("./billing-reimbursement-expense.entity.model");
 const billing_timesheet_entity_model_1 = require("./billing-timesheet.entity.model");
-const billing_transaction_model_1 = require("./billing-transaction.model");
 const billing_entity_model_1 = require("./billing.entity.model");
 const client_affiliate_entity_model_1 = require("./client-affiliate.entity.model");
 const client_entity_model_1 = require("./client.entity.model");
-const configuration_model_1 = require("./configuration.model");
 const holiday_entity_model_1 = require("./holiday.entity.model");
 const leave_entity_model_1 = require("./leave.entity.model");
 const leave_count_entity_model_1 = require("./leave_count.entity.model");
+const configuration_model_1 = require("./configuration.model");
 const project_user_mapping_entity_model_1 = require("./project-user-mapping.entity.model");
 const project_entity_model_1 = require("./project.entity.model");
 const reimbursement_expense_entity_model_1 = require("./reimbursement-expense.entity.model");
@@ -26,6 +28,8 @@ const reimbursement_entity_model_1 = require("./reimbursement.entity.model");
 const task_entity_model_1 = require("./task.entity.model");
 const timesheet_entity_model_1 = require("./timesheet.entity.model");
 const user_entity_model_1 = require("./user.entity.model");
+const country_entity_model_1 = require("./country.entity.model");
+const address_book_model_1 = require("./address_book.model");
 function mapToIndex(entityMap) {
     return Object.keys(entityMap).reduce((acc, key) => {
         // @ts-ignore
@@ -53,41 +57,6 @@ function populateRelationsFor(entityIndexMap, enumEntities) {
         base_entity_model_1.BaseEntityModel.populateRelationsForEntities(entityIndexMap, entity);
     });
 }
-function parseEntities(json, baseEntity, entityMap) {
-    var _a;
-    const entityFromJsonMappings = {
-        [entity_utils_interface_1.EntityEnum.PROJECT]: project_entity_model_1.ProjectEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.CLIENT]: client_entity_model_1.ClientEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.BILLING]: billing_entity_model_1.BillingEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.USER]: user_entity_model_1.UserEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.PROJECT_USER_MAPPING]: project_user_mapping_entity_model_1.ProjectUserMappingEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.REIMBURSEMENT]: reimbursement_entity_model_1.ReimbursementEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.REIMBURSEMENT_EXPENSE]: reimbursement_expense_entity_model_1.ReimbursementExpenseEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.BILLING_REIMBURSEMENT_EXPENSE]: billing_reimbursement_expense_entity_model_1.BillingReimbursementExpneseEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.CLIENT_AFFILIATE]: client_affiliate_entity_model_1.ClientAffiliateEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.BANK]: bank_entity_model_1.BankEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.CONFIGURATION]: configuration_model_1.ConfigurationEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.TASK]: task_entity_model_1.TaskEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.BILLING_TIMESHEET]: billing_timesheet_entity_model_1.BillingTimesheetEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.TIMESHEET]: timesheet_entity_model_1.TimesheetEntityModel.fromEntity,
-        [entity_utils_interface_1.EntityEnum.BILLING_TRANSACTION]: billing_transaction_model_1.BillingTransactionEntityModel.fromEntity,
-    };
-    if (!(baseEntity in entityFromJsonMappings)) {
-        throw new Error(`Unknown entity: ${baseEntity}`);
-    }
-    entityMap[baseEntity] = ((_a = json["baseEntities"]) !== null && _a !== void 0 ? _a : []).map(
-    // REVIEW: Needs to be fixed after audit column type conversion
-    (e) => entityFromJsonMappings[baseEntity](e));
-    if (json["relatedEntities"]) {
-        const relatedEntities = json["relatedEntities"];
-        for (const entityName in relatedEntities) {
-            parseEntities(
-            // @ts-ignore
-            relatedEntities[entityName], entityName, entityMap);
-        }
-    }
-    return entityMap;
-}
 exports.entityEnumToEntityModel = {
     [entity_utils_interface_1.EntityEnum.PROJECT]: project_entity_model_1.ProjectEntityModel.fromEntity,
     [entity_utils_interface_1.EntityEnum.CLIENT]: client_entity_model_1.ClientEntityModel.fromEntity,
@@ -107,13 +76,45 @@ exports.entityEnumToEntityModel = {
     [entity_utils_interface_1.EntityEnum.TASK]: task_entity_model_1.TaskEntityModel.fromEntity,
     [entity_utils_interface_1.EntityEnum.BILLING_TIMESHEET]: billing_timesheet_entity_model_1.BillingTimesheetEntityModel.fromEntity,
     [entity_utils_interface_1.EntityEnum.TIMESHEET]: timesheet_entity_model_1.TimesheetEntityModel.fromEntity,
-    [entity_utils_interface_1.EntityEnum.BILLING_TRANSACTION]: billing_transaction_model_1.BillingTransactionEntityModel.fromEntity,
+    [entity_utils_interface_1.EntityEnum.COUNTRY]: country_entity_model_1.CountryEntityModel.fromApiEntity,
+    [entity_utils_interface_1.EntityEnum.ADDRESS_BOOK]: address_book_model_1.AddressBookEntityModel.fromEntity,
 };
-function parseEntitiesWithoutModels(json, baseEntity, entityMap = {}) {
+function entityMapToModels(entityMap) {
+    for (const entityName in entityMap) {
+        if (!(entityName in exports.entityEnumToEntityModel)) {
+            throw new Error(`Unknown entity: ${entityName}`);
+        }
+        entityMap[entityName] = entityMap[entityName].map((entity) => 
+        // @ts-ignore
+        exports.entityEnumToEntityModel[entityName](entity));
+    }
+}
+function parseEntities(json, baseEntity, entityMap) {
     var _a;
     if (!(baseEntity in exports.entityEnumToEntityModel)) {
         throw new Error(`Unknown entity: ${baseEntity}`);
     }
+    entityMap[baseEntity] = ((_a = json["baseEntities"]) !== null && _a !== void 0 ? _a : []).map(
+    // @ts-ignore
+    (e) => exports.entityEnumToEntityModel[baseEntity](e));
+    if (json["relatedEntities"]) {
+        const relatedEntities = json["relatedEntities"];
+        for (const entityName in relatedEntities) {
+            parseEntities(
+            // @ts-ignore
+            relatedEntities[entityName], entityName, entityMap);
+        }
+    }
+    return entityMap;
+}
+function entityMapToEntityIndexMap(entityMap, entityRelationsFor) {
+    entityMapToModels(entityMap);
+    const entityIndexMap = mapToIndex(entityMap);
+    populateRelationsFor(entityIndexMap, entityRelationsFor);
+    return entityIndexMap;
+}
+function parseEntitiesWithoutModels(json, baseEntity, entityMap = {}) {
+    var _a;
     entityMap[baseEntity] = ((_a = json["baseEntities"]) !== null && _a !== void 0 ? _a : []);
     if (json["relatedEntities"]) {
         const relatedEntities = json["relatedEntities"];
@@ -125,3 +126,88 @@ function parseEntitiesWithoutModels(json, baseEntity, entityMap = {}) {
     }
     return entityMap;
 }
+function removeEntityById(entityIndexMap, entity, id) {
+    if (entityIndexMap[entity]) {
+        delete entityIndexMap[entity][id];
+    }
+}
+class EntityModelRelationHelper {
+    constructor(entityMap) {
+        this.entityMap = entityMap;
+        this.entityModelMap = {};
+        this.entityModelIndexMap = {};
+        this.init();
+    }
+    init() {
+        this.toEntityModelMap();
+        this.toEntityModelIndexMap();
+    }
+    toEntityModelMap() {
+        for (const entityName in this.entityMap) {
+            if (!(entityName in exports.entityEnumToEntityModel)) {
+                throw new Error(`Unknown entity: ${entityName}`);
+            }
+            this.entityModelMap[entityName] = this.entityMap[entityName].map((entity) => 
+            // @ts-ignore
+            exports.entityEnumToEntityModel[entityName](entity));
+        }
+        return this;
+    }
+    fromEntityToEntityModel(entity, entityEnum) {
+        if (!(entityEnum in exports.entityEnumToEntityModel)) {
+            throw new Error(`Unknown entity: ${entityEnum}`);
+        }
+        return exports.entityEnumToEntityModel[entityEnum](entity);
+    }
+    toEntityModelIndexMap() {
+        this.entityModelIndexMap = Object.keys(this.entityModelMap).reduce((acc, key) => {
+            // @ts-ignore
+            acc[key] = this.entityModelMap[key].reduce((innerAcc, entity) => {
+                innerAcc[entity.id] = entity;
+                return innerAcc;
+            }, {});
+            return acc;
+        }, {});
+        return this;
+    }
+    populateRelationsByEntityEnums(entityEnums) {
+        entityEnums.forEach((entityEnum) => {
+            this.populateRelationsByEntityEnum(entityEnum);
+        });
+        return this;
+    }
+    populateRelationsByEntityEnum(entityEnum) {
+        for (const key of Object.keys(this.entityModelIndexMap[entityEnum] || {})) {
+            const entityModel = this.entityModelIndexMap[entityEnum][key];
+            entityModel.populateRelationsByIndex(this.entityModelIndexMap);
+        }
+    }
+    populateRelationsByEntityModel(entityModel) {
+        entityModel.populateRelationsByIndex(this.entityModelIndexMap);
+    }
+    addEntityModel(entityModel, config = { populateRelations: false }) {
+        const entityEnum = entityModel.entityName;
+        this.entityModelIndexMap[entityEnum] = this.entityModelIndexMap[entityEnum] || {};
+        // @ts-ignore
+        this.entityModelIndexMap[entityEnum][entityModel.id] = entityModel;
+        if (config.populateRelations) {
+            this.populateRelationsByEntityModel(entityModel);
+        }
+    }
+    addEntity(entity, entityEnum, config = { populateRelations: false }) {
+        if (!(entityEnum in exports.entityEnumToEntityModel)) {
+            throw new Error(`Unknown entity: ${entityEnum}`);
+        }
+        this.addEntityModel(this.fromEntityToEntityModel(entity, entityEnum), config);
+    }
+    updateEntityModel(entityModel, config = { populateRelations: false }) {
+        const entityEnum = entityModel.entityName;
+        this.entityModelIndexMap[entityEnum] = this.entityModelIndexMap[entityEnum] || {};
+        // @ts-ignore
+        this.entityModelIndexMap[entityEnum][entityModel.id] = entityModel;
+        if (config.populateRelations) {
+            this.populateRelationsByEntityModel(entityModel);
+        }
+    }
+}
+exports.EntityModelRelationHelper = EntityModelRelationHelper;

package/dist/src/utils/array.util.d.ts

@@ -0,0 +1,25 @@
+export type ArrayComparisonCategory<T> = {
+    unchanged: T[];
+    added: T[];
+    updated: T[];
+    deleted: {
+        [x: string]: T[keyof T];
+    }[];
+    notFound: {
+        [x: string]: T[keyof T];
+    }[];
+};
+export declare class ArrayComparisonCategorizer<T> {
+    private incomingArray;
+    private existingArray;
+    private keyProperty;
+    private arrayComparisonCategory;
+    constructor(incomingArray: T[] | undefined, existingArray: T[] | undefined, keyProperty: keyof T);
+    private get existingMap();
+    private isExistingItem;
+    private isMarkForDeletion;
+    private isIdentifierPresent;
+    compare(): ArrayComparisonCategory<T>;
+    get category(): ArrayComparisonCategory<T> | null;
+    merge(): T[];
+}

package/dist/src/utils/array.util.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayComparisonCategorizer = void 0;
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a !== "object")
+        return a === b;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    if (Array.isArray(a)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((v, i) => deepEqual(v, b[i]));
+    }
+    const keysA = Object.keys(a).sort();
+    const keysB = Object.keys(b).sort();
+    if (keysA.length !== keysB.length)
+        return false;
+    return keysA.every((key) => deepEqual(a[key], b[key]));
+}
+class ArrayComparisonCategorizer {
+    constructor(incomingArray = [], existingArray = [], keyProperty) {
+        this.arrayComparisonCategory = null;
+        this.incomingArray = [...incomingArray];
+        this.existingArray = [...existingArray];
+        this.keyProperty = keyProperty;
+    }
+    get existingMap() {
+        return new Map(this.existingArray.filter((item) => item[this.keyProperty] !== undefined).map((item) => [item[this.keyProperty], item]));
+    }
+    isExistingItem(incomingItem, existingMap) {
+        return existingMap.has(incomingItem[this.keyProperty]);
+    }
+    isMarkForDeletion(incomingItem) {
+        const onlyIdentifierPresent = Object.keys(incomingItem).length === 1;
+        return this.isIdentifierPresent(incomingItem) && onlyIdentifierPresent;
+    }
+    isIdentifierPresent(incomingItem) {
+        return incomingItem[this.keyProperty] !== undefined && incomingItem[this.keyProperty] !== null;
+    }
+    compare() {
+        const existingMap = this.existingMap;
+        const unchanged = [];
+        const added = [];
+        const updated = [];
+        const deleted = [];
+        const notFound = [];
+        for (const incomingItem of this.incomingArray) {
+            const isIdentifierPresent = this.isIdentifierPresent(incomingItem);
+            const isMarkForDeletion = isIdentifierPresent && this.isMarkForDeletion(incomingItem);
+            const isExistingItem = isIdentifierPresent && this.isExistingItem(incomingItem, existingMap);
+            const existingItem = isExistingItem ? existingMap.get(incomingItem[this.keyProperty]) : null;
+            if (isMarkForDeletion) {
+                deleted.push({ [this.keyProperty]: incomingItem[this.keyProperty] });
+            }
+            else if (!isIdentifierPresent && !isExistingItem) {
+                added.push(incomingItem);
+            }
+            else if (isExistingItem && isIdentifierPresent) {
+                if (deepEqual(incomingItem, existingItem)) {
+                    unchanged.push(incomingItem);
+                }
+                else {
+                    updated.push(incomingItem);
+                }
+            }
+            else {
+                notFound.push({ [this.keyProperty]: incomingItem[this.keyProperty] });
+            }
+        }
+        const result = {
+            unchanged,
+            added,
+            updated,
+            deleted,
+            notFound
+        };
+        this.arrayComparisonCategory = result;
+        return result;
+    }
+    get category() {
+        return this.arrayComparisonCategory;
+    }
+    merge() {
+        if (!this.arrayComparisonCategory) {
+            throw new Error("ArrayComparisonCategory is not computed yet. Call compare() first.");
+        }
+        const changes = this.arrayComparisonCategory;
+        let newState = this.existingArray.filter(this.isIdentifierPresent.bind(this));
+        // Remove deleted items
+        const deletedIds = new Set(changes.deleted.map((d) => d[this.keyProperty]));
+        newState = newState.filter((item) => !deletedIds.has(item[this.keyProperty]));
+        // Update items
+        for (let i = 0; i < newState.length; i++) {
+            const item = newState[i];
+            const updatedItem = changes.updated.find((u) => u[this.keyProperty] === item[this.keyProperty]);
+            if (updatedItem) {
+                newState[i] = updatedItem;
+            }
+        }
+        // Get Max Id
+        const existingWithId = this.existingArray.filter(this.isIdentifierPresent.bind(this));
+        const originalMaxId = existingWithId.length > 0
+            ? Math.max(...existingWithId.map((item) => item[this.keyProperty]))
+            : 0;
+        // Add new items with new identifier
+        let currentMaxId = originalMaxId;
+        for (const item of changes.added) {
+            const id = ++currentMaxId;
+            newState.push(Object.assign(Object.assign({}, item), { [this.keyProperty]: id }));
+        }
+        return newState;
+    }
+}
+exports.ArrayComparisonCategorizer = ArrayComparisonCategorizer;
+// function categorizeChanges<T extends Item>(
+//   incoming: T[],
+//   existing: T[]
+// ): {
+//   unchanged: T[];
+//   added: T[];
+//   updated: T[];
+//   deleted: { id: number }[];
+//   notFound: { id: number }[];
+// } {
+//   console.log("Categorizing changes between incoming and existing items");
+//   console.log("Incoming items:", incoming);
+//   console.log("Existing items:", existing);
+//   const existingMap = new Map<number, T>(existing.filter((item) => item.id !== undefined).map((item) => [item.id!, item]));
+//   const incomingIds = new Set<number>(incoming.filter((item) => item.id !== undefined).map((item) => item.id!));
+//   const deleted: { id: number }[] = [];
+//   const notFound: { id: number }[] = [];
+//   const unchanged: T[] = [];
+//   const updated: T[] = [];
+//   const added: T[] = [];
+//   for (const item of incoming) {
+//     if (item.id === undefined) {
+//       added.push(item);
+//       continue;
+//     }
+//     const id = item.id;
+//     if (Object.keys(item).length === 1) {
+//       deleted.push({ id });
+//       continue;
+//     }
+//     if (!existingMap.has(id)) {
+//       added.push(item);
+//       continue;
+//     }
+//     const existingItem = existingMap.get(id)!;
+//     if (deepEqual(item, existingItem)) {
+//       unchanged.push(item);
+//     } else {
+//       updated.push(item);
+//     }
+//   }
+//   for (const [id] of existingMap) {
+//     if (!incomingIds.has(id)) {
+//       notFound.push({ id });
+//     }
+//   }
+//   return { unchanged, added, updated, deleted, notFound };
+// }

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

@@ -3,3 +3,4 @@ export * from "./helper.fn.util";
 export * from "./models/date-code.model.util";
 export * from "./string.util";
 export * from "./entity.flow.util";
+export * from "./array.util";

package/dist/src/utils/index.js

@@ -19,3 +19,4 @@ __exportStar(require("./helper.fn.util"), exports);
 __exportStar(require("./models/date-code.model.util"), exports);
 __exportStar(require("./string.util"), exports);
 __exportStar(require("./entity.flow.util"), exports);
+__exportStar(require("./array.util"), exports);

package/dist/src/utils/object.util.d.ts

@@ -0,0 +1,10 @@
+interface ComparableObject {
+    [key: string]: any;
+}
+declare class ObjectComparator {
+    private incoming;
+    private existing;
+    constructor(incoming: ComparableObject, existing: ComparableObject);
+    compare(): ComparableObject;
+    private deepDiff;
+}

package/dist/src/utils/object.util.js

@@ -0,0 +1,134 @@
+"use strict";
+class ObjectComparator {
+    constructor(incoming, existing) {
+        this.incoming = incoming;
+        this.existing = existing;
+    }
+    compare() {
+        return this.deepDiff(this.incoming, this.existing);
+    }
+    deepDiff(a, b) {
+        // Handle null/undefined cases
+        if (a == null && b == null) {
+            return undefined;
+        }
+        if (a == null || b == null) {
+            return a;
+        }
+        // Handle primitives (loose equality)
+        if (typeof a !== "object") {
+            return a == b ? undefined : a;
+        }
+        // a is object or array
+        if (Array.isArray(a)) {
+            // Handle as array
+            const diffArr = new Array(a.length);
+            let hasDiff = false;
+            for (let i = 0; i < a.length; i++) {
+                const subB = Array.isArray(b) && i < b.length ? b[i] : undefined;
+                const subDiff = this.deepDiff(a[i], subB);
+                if (subDiff !== undefined) {
+                    diffArr[i] = subDiff;
+                    hasDiff = true;
+                }
+            }
+            return hasDiff ? diffArr : undefined;
+        }
+        else {
+            // Handle as object
+            const diff = {};
+            let hasDiff = false;
+            for (const key of Object.keys(a)) {
+                const subDiff = this.deepDiff(a[key], b === null || b === void 0 ? void 0 : b[key]);
+                if (subDiff !== undefined) {
+                    diff[key] = subDiff;
+                    hasDiff = true;
+                }
+            }
+            return hasDiff ? diff : undefined;
+        }
+    }
+}
+// // Comprehensive Usage Examples
+// // Example 1: Simple object with primitive differences
+// console.log("Example 1: Simple object");
+// const incoming1 = { name: "Alice", age: 30, city: "New York" };
+// const existing1 = { name: "Bob", age: 30, city: "Boston" };
+// const comparator1 = new ObjectComparator(incoming1, existing1);
+// console.log(comparator1.compare()); // Output: { name: 'Alice', city: 'New York' }
+// // Example 2: Nested objects
+// console.log("Example 2: Nested objects");
+// const incoming2 = {
+//   user: { id: 1, profile: { email: "alice@example.com", phone: "123-456" } },
+//   settings: { theme: "dark", notifications: true },
+// };
+// const existing2 = {
+//   user: { id: 1, profile: { email: "bob@example.com" } },
+//   settings: { theme: "light" },
+// };
+// const comparator2 = new ObjectComparator(incoming2, existing2);
+// console.log(comparator2.compare());
+// // Output: {
+// //   user: { profile: { email: 'alice@example.com', phone: '123-456' } },
+// //   settings: { theme: 'dark', notifications: true }
+// // }
+// // Example 3: Array of primitives
+// console.log("Example 3: Array of primitives");
+// const incoming3 = { scores: [95, 87, 100] };
+// const existing3 = { scores: [80, 87, 90] };
+// const comparator3 = new ObjectComparator(incoming3, existing3);
+// console.log(comparator3.compare()); // Output: { scores: [95, undefined, 100] }
+// // Example 4: Array of objects
+// console.log("Example 4: Array of objects");
+// const incoming4 = {
+//   items: [
+//     { id: 1, name: "Item A", price: 10 },
+//     { id: 2, name: "Item B", price: 20 },
+//     { id: 3, name: "Item C", price: 30 },
+//   ],
+// };
+// const existing4 = {
+//   items: [
+//     { id: 1, name: "Item A", price: 15 },
+//     { id: 2, name: "Item X", price: 20 },
+//   ],
+// };
+// const comparator4 = new ObjectComparator(incoming4, existing4);
+// console.log(comparator4.compare());
+// // Output: {
+// //   items: [
+// //     { price: 10 },
+// //     { name: 'Item B' },
+// //     { id: 3, name: 'Item C', price: 30 }
+// //   ]
+// // }
+// // Example 5: Mixed structure with missing properties and nulls
+// console.log("Example 5: Mixed with nulls and missing");
+// const incoming5 = {
+//   data: {
+//     value: null,
+//     list: [1, 2, { nested: "hello" }],
+//     extra: "new",
+//   },
+// };
+// const existing5 = {
+//   data: {
+//     value: 42,
+//     list: [1, 3],
+//   },
+// };
+// const comparator5 = new ObjectComparator(incoming5, existing5);
+// console.log(comparator5.compare());
+// // Output: {
+// //   data: {
+// //     value: null,
+// //     list: [undefined, 2, { nested: 'hello' }],
+// //     extra: 'new'
+// //   }
+// // }
+// // Example 6: No differences
+// console.log("Example 6: No differences");
+// const incoming6 = { a: 1, b: { c: [true] } };
+// const existing6 = { a: 1, b: { c: [true] } };
+// const comparator6 = new ObjectComparator(incoming6, existing6);
+// console.log(comparator6.compare()); // Output: {}

package/package.json

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