@mody-park-cha-raja/finance_common 4.27.1-beta.2 → 4.27.1-beta.3

package/dist/index.d.mts

@@ -123,7 +123,6 @@ interface IDonationEntity extends IAuditColumnEntity {
     id: number;
     receiptNumber: string;
     flatNo: string;
-    flatId: number;
     amount: number;
     mobileNumber?: string;
     paymentType: PaymentType;
@@ -293,69 +292,10 @@ declare class UserModel extends BaseEntityModel implements IUserEntity {
     static populateFromEntity(entity: IUserEntity): UserModel;
 }
 
-interface FlatDonationLike {
-    flatNo: string;
-    amount: number;
-    donationYear?: number;
-    createdOn?: number;
-    createdByUser?: Nullable<{
-        name?: string;
-    }>;
-    updatedByUser?: Nullable<{
-        name?: string;
-    }>;
-}
-type FlatCollectionStatus = "Paid" | "Pending";
-interface FlatCollectionEntry {
-    flatNumber: string;
-    status: FlatCollectionStatus;
-    amount: number;
-    latestDonation?: Nullable<FlatDonationLike>;
-}
-interface FlatParseResult {
-    wing?: string;
-    num?: string;
-    isSpecial: boolean;
-}
-interface FlatOption {
-    label: string;
-    value: string;
-}
-declare class FlatModel {
-    id: number;
-    wing: string;
-    unitNumber: string;
-    status: EntityStatus;
-    createdOn: number;
-    updatedOn: number;
-    createdBy: number;
-    updatedBy: number;
-    static populateFromEntity(entity: IFlatEntity): FlatModel;
-    createdByUser?: UserModel;
-    updatedByUser?: UserModel;
-    donations?: DonationModel[];
-    static relations: Partial<Record<EntityList, IModelRelationConfig<EntityList>>>;
-    static readonly FLAT_NUMBERS: readonly string[];
-    static readonly FLATS_BY_WING: ReadonlyMap<string, readonly string[]>;
-    static readonly SPECIAL_FLATS: readonly string[];
-    static readonly WINGS: readonly string[];
-    static getDonationYear(): number;
-    static getTotalFlats(): number;
-    static buildFlatNumber(wing: string, num: string): string;
-    static isSpecialFlat(flatNo: string): boolean;
-    static parseFlatNumber(flatNo: string): FlatParseResult;
-    static getFlatOptions(wing: string): FlatOption[];
-    static getDisplayLabel(wing: string, flatNo: string): string;
-    static computeCollectionStatus(donations: FlatDonationLike[], year: number): FlatCollectionEntry[];
-    static compareFlatNumbers(a: string, b: string): number;
-    static convertNumberToWords(num: number): string;
-}
-
 declare class DonationModel extends BaseEntityModel implements IDonationEntity {
     id: number;
     receiptNumber: string;
     flatNo: string;
-    flatId: number;
     amount: number;
     mobileNumber?: string;
     paymentType: PaymentType;
@@ -367,10 +307,20 @@ declare class DonationModel extends BaseEntityModel implements IDonationEntity {
     updatedBy: number;
     createdByUser?: UserModel;
     updatedByUser?: UserModel;
-    flat?: FlatModel;
     protected constructor();
     static relations: Partial<Record<EntityList, IModelRelationConfig<EntityList>>>;
     static populateFromEntity(entity: IDonationEntity): DonationModel;
+    /**
+     * Sums the `amount` of all ACTIVE donations in the given list.
+     * The list is always `DonationModel[]`.
+     *
+     * @param donations - The list of DonationModels to sum
+     * @returns The total amount of all `EntityStatus.ACTIVE` donations (0 for empty lists)
+     *
+     * @example
+     * DonationModel.sumActiveDonations(donations); // 12345
+     */
+    static sumActiveDonations(donations: DonationModel[]): number;
     static getReceiptPrefix(flatNo: string): string;
     static generateReceiptNumber(flatNo: string, existingDonations: DonationModel[]): string;
     static toWhatsAppNumber(mobile: string): string;
@@ -446,6 +396,60 @@ declare class FlatHistoryModel extends BaseEntityModel implements IFlatHistoryEn
     static populateFromEntity(entity: IFlatHistoryEntity): FlatHistoryModel;
 }
 
+interface FlatDonationLike {
+    flatNo: string;
+    amount: number;
+    donationYear?: number;
+    createdOn?: number;
+    createdByUser?: Nullable<{
+        name?: string;
+    }>;
+    updatedByUser?: Nullable<{
+        name?: string;
+    }>;
+}
+type FlatCollectionStatus = "Paid" | "Pending";
+interface FlatCollectionEntry {
+    flatNumber: string;
+    status: FlatCollectionStatus;
+    amount: number;
+    latestDonation?: Nullable<FlatDonationLike>;
+}
+interface FlatParseResult {
+    wing?: string;
+    num?: string;
+    isSpecial: boolean;
+}
+interface FlatOption {
+    label: string;
+    value: string;
+}
+declare class FlatModel {
+    id: number;
+    wing: string;
+    unitNumber: string;
+    status: EntityStatus;
+    createdOn: number;
+    updatedOn: number;
+    createdBy: number;
+    updatedBy: number;
+    static populateFromEntity(entity: IFlatEntity): FlatModel;
+    static readonly FLAT_NUMBERS: readonly string[];
+    static readonly FLATS_BY_WING: ReadonlyMap<string, readonly string[]>;
+    static readonly SPECIAL_FLATS: readonly string[];
+    static readonly WINGS: readonly string[];
+    static getDonationYear(): number;
+    static getTotalFlats(): number;
+    static buildFlatNumber(wing: string, num: string): string;
+    static isSpecialFlat(flatNo: string): boolean;
+    static parseFlatNumber(flatNo: string): FlatParseResult;
+    static getFlatOptions(wing: string): FlatOption[];
+    static getDisplayLabel(wing: string, flatNo: string): string;
+    static computeCollectionStatus(donations: FlatDonationLike[], year: number): FlatCollectionEntry[];
+    static compareFlatNumbers(a: string, b: string): number;
+    static convertNumberToWords(num: number): string;
+}
+
 declare class SponsorHistoryModel extends BaseEntityModel implements ISponsorHistoryEntity {
     id: number;
     entityId: number;
@@ -685,6 +689,19 @@ declare function definedValues<T>(arr: Array<Nullable<T> | undefined>): T[];
  * epochToReadableDate(1700000000000);          // "2023-11-14T18:13:20.000Z"
  */
 declare function epochToReadableDate(epoch: number | string, format?: "short" | "long" | "short-dt" | "iso"): string;
+/**
+ * Rounds a number to exactly 2 decimal places.
+ * Uses `Number.EPSILON` to avoid common float artifacts
+ * (e.g. `305.4999999` incorrectly rounding down).
+ *
+ * @param value - The number to round
+ * @returns The number rounded to 2 decimal places (still a number, format per-platform afterwards)
+ *
+ * @example
+ * roundToTwoDecimals(305.49999); // 305.5
+ * roundToTwoDecimals(100.125);   // 100.13
+ */
+declare function roundToTwoDecimals(value: number): number;
 
 declare function convertNumberToWords(num: number): string;
 
@@ -970,4 +987,4 @@ declare function isSpecialFlatLabel(label: string): boolean;
 declare function getFlatValidationErrors(input: Partial<IFlatEntity>): FlatValidationError[];
 declare function validateFlatOrThrow(input: Partial<IFlatEntity>): void;
 
-export { ALL_WINGS_SELECTION, BadRequestException, BaseEntityModel, ConfigurationKey, ConfigurationModel, ConfigurationType, DateCodeUtils, DateUtil, DonationHistoryModel, DonationModel, EntityFilterDataHelper, EntityHistoryOperation, EntityList, type EntityListEntityModelMap, type EntityModelType, EntityStatus, type EntityType, ExpenseHistoryModel, ExpenseModel, ExpenseType, FLATS_BY_WING, FLAT_NUMBERS, FLAT_UNIT_NUMBER_PATTERN, FLAT_WING_PATTERN, type FlatCollectionEntry, type FlatCollectionStatus, type FlatDonationLike, FlatHistoryModel, FlatModel, type FlatOption, type FlatParseResult, type FlatValidationError, ForbiddenException, HttpException, type IAuditColumnEntity, type IBaseHistoryEntity, type ICashBookEntry, type IConfigurationCreateDto, type IConfigurationEntity, type IConfigurationSearchDto, type IConfigurationUpdateDto, type IDonationCreateDto, type IDonationEntity, type IDonationHistoryEntity, type IDonationSearchDto, type IDonationUpdateDto, type IDtoValidationError, type IEntityCreateDto, type IEntityFilterData, type IEntityFilterSearchData, type IEntityFilterSearchDataV2, type IEntityUpdateDto, type IExpenseCreateDto, type IExpenseEntity, type IExpenseHistoryEntity, type IExpenseSearchDto, type IExpenseUpdateDto, type IFlatCreateDto, type IFlatEntity, type IFlatHistoryEntity, type IFlatSearchDto, type IFlatUpdateDto, type IMappingPropertyEntry, type IModelRelationConfig, type ISearchV2Response, type ISponsorCreateDto, type ISponsorEntity, type ISponsorHistoryEntity, type ISponsorSearchDto, type ISponsorUpdateDto, type ITransactionCreateDto, type ITransactionEntity, type ITransactionHistoryEntity, type ITransactionSearchDto, type ITransactionUpdateDto, type IUserCreateDto, type IUserEntity, type IUserHistoryEntity, type IUserSearchDto, type IUserUpdateDto, type IVendorCreateDto, type IVendorEntity, type IVendorHistoryEntity, type IVendorSearchDto, type IVendorUpdateDto, NotFoundException, type Nullable, OrderByDirection, PAYMENT_OPTIONS, PaymentType, ReferenceIdPrefix, RelationType, SHOP_UNIT_NUMBER_PATTERN, SHOP_WING, SPECIAL_FLATS, SPECIAL_FLAT_LABELS, SponsorHistoryModel, SponsorModel, SponsorTier, TransactionEntityType, TransactionHistoryModel, TransactionModel, TransactionType, USER_RELATION_CONFIG, UnauthorizedException, type UserExpenseReport, type UserExpenseReportTotals, type UserExpenseRow, UserHistoryModel, UserModel, VendorHistoryModel, VendorModel, VendorType, WINGS, type WingCollectionDonationLike, type WingCollectionReport, type WingCollectionRow, type WingCollectionTotals, type XlsxCellAddress, type XlsxMergeRange, type XlsxSerializationType, type XlsxSheetInput, type XlsxSheetOptions, buildUserExpenseReport, buildUserExpenseWorkbook, buildWingWiseCollectionReport, buildWingWiseCollectionWorkbook, buildXlsxWorkbook, convertNumberToWords, definedValues, diffArrays, entityListEntityModelMap, epochToReadableDate, getFlatValidationErrors, getObjectDiffingKeys, getWingSelectionLabel, getWingSelectionSlug, groupBy, isSpecialFlatLabel, isValidFlatWing, serializeXlsx, validateFlatOrThrow };
+export { ALL_WINGS_SELECTION, BadRequestException, BaseEntityModel, ConfigurationKey, ConfigurationModel, ConfigurationType, DateCodeUtils, DateUtil, DonationHistoryModel, DonationModel, EntityFilterDataHelper, EntityHistoryOperation, EntityList, type EntityListEntityModelMap, type EntityModelType, EntityStatus, type EntityType, ExpenseHistoryModel, ExpenseModel, ExpenseType, FLATS_BY_WING, FLAT_NUMBERS, FLAT_UNIT_NUMBER_PATTERN, FLAT_WING_PATTERN, type FlatCollectionEntry, type FlatCollectionStatus, type FlatDonationLike, FlatHistoryModel, FlatModel, type FlatOption, type FlatParseResult, type FlatValidationError, ForbiddenException, HttpException, type IAuditColumnEntity, type IBaseHistoryEntity, type ICashBookEntry, type IConfigurationCreateDto, type IConfigurationEntity, type IConfigurationSearchDto, type IConfigurationUpdateDto, type IDonationCreateDto, type IDonationEntity, type IDonationHistoryEntity, type IDonationSearchDto, type IDonationUpdateDto, type IDtoValidationError, type IEntityCreateDto, type IEntityFilterData, type IEntityFilterSearchData, type IEntityFilterSearchDataV2, type IEntityUpdateDto, type IExpenseCreateDto, type IExpenseEntity, type IExpenseHistoryEntity, type IExpenseSearchDto, type IExpenseUpdateDto, type IFlatCreateDto, type IFlatEntity, type IFlatHistoryEntity, type IFlatSearchDto, type IFlatUpdateDto, type IMappingPropertyEntry, type IModelRelationConfig, type ISearchV2Response, type ISponsorCreateDto, type ISponsorEntity, type ISponsorHistoryEntity, type ISponsorSearchDto, type ISponsorUpdateDto, type ITransactionCreateDto, type ITransactionEntity, type ITransactionHistoryEntity, type ITransactionSearchDto, type ITransactionUpdateDto, type IUserCreateDto, type IUserEntity, type IUserHistoryEntity, type IUserSearchDto, type IUserUpdateDto, type IVendorCreateDto, type IVendorEntity, type IVendorHistoryEntity, type IVendorSearchDto, type IVendorUpdateDto, NotFoundException, type Nullable, OrderByDirection, PAYMENT_OPTIONS, PaymentType, ReferenceIdPrefix, RelationType, SHOP_UNIT_NUMBER_PATTERN, SHOP_WING, SPECIAL_FLATS, SPECIAL_FLAT_LABELS, SponsorHistoryModel, SponsorModel, SponsorTier, TransactionEntityType, TransactionHistoryModel, TransactionModel, TransactionType, USER_RELATION_CONFIG, UnauthorizedException, type UserExpenseReport, type UserExpenseReportTotals, type UserExpenseRow, UserHistoryModel, UserModel, VendorHistoryModel, VendorModel, VendorType, WINGS, type WingCollectionDonationLike, type WingCollectionReport, type WingCollectionRow, type WingCollectionTotals, type XlsxCellAddress, type XlsxMergeRange, type XlsxSerializationType, type XlsxSheetInput, type XlsxSheetOptions, buildUserExpenseReport, buildUserExpenseWorkbook, buildWingWiseCollectionReport, buildWingWiseCollectionWorkbook, buildXlsxWorkbook, convertNumberToWords, definedValues, diffArrays, entityListEntityModelMap, epochToReadableDate, getFlatValidationErrors, getObjectDiffingKeys, getWingSelectionLabel, getWingSelectionSlug, groupBy, isSpecialFlatLabel, isValidFlatWing, roundToTwoDecimals, serializeXlsx, validateFlatOrThrow };

package/dist/index.d.ts

@@ -123,7 +123,6 @@ interface IDonationEntity extends IAuditColumnEntity {
     id: number;
     receiptNumber: string;
     flatNo: string;
-    flatId: number;
     amount: number;
     mobileNumber?: string;
     paymentType: PaymentType;
@@ -293,69 +292,10 @@ declare class UserModel extends BaseEntityModel implements IUserEntity {
     static populateFromEntity(entity: IUserEntity): UserModel;
 }
 
-interface FlatDonationLike {
-    flatNo: string;
-    amount: number;
-    donationYear?: number;
-    createdOn?: number;
-    createdByUser?: Nullable<{
-        name?: string;
-    }>;
-    updatedByUser?: Nullable<{
-        name?: string;
-    }>;
-}
-type FlatCollectionStatus = "Paid" | "Pending";
-interface FlatCollectionEntry {
-    flatNumber: string;
-    status: FlatCollectionStatus;
-    amount: number;
-    latestDonation?: Nullable<FlatDonationLike>;
-}
-interface FlatParseResult {
-    wing?: string;
-    num?: string;
-    isSpecial: boolean;
-}
-interface FlatOption {
-    label: string;
-    value: string;
-}
-declare class FlatModel {
-    id: number;
-    wing: string;
-    unitNumber: string;
-    status: EntityStatus;
-    createdOn: number;
-    updatedOn: number;
-    createdBy: number;
-    updatedBy: number;
-    static populateFromEntity(entity: IFlatEntity): FlatModel;
-    createdByUser?: UserModel;
-    updatedByUser?: UserModel;
-    donations?: DonationModel[];
-    static relations: Partial<Record<EntityList, IModelRelationConfig<EntityList>>>;
-    static readonly FLAT_NUMBERS: readonly string[];
-    static readonly FLATS_BY_WING: ReadonlyMap<string, readonly string[]>;
-    static readonly SPECIAL_FLATS: readonly string[];
-    static readonly WINGS: readonly string[];
-    static getDonationYear(): number;
-    static getTotalFlats(): number;
-    static buildFlatNumber(wing: string, num: string): string;
-    static isSpecialFlat(flatNo: string): boolean;
-    static parseFlatNumber(flatNo: string): FlatParseResult;
-    static getFlatOptions(wing: string): FlatOption[];
-    static getDisplayLabel(wing: string, flatNo: string): string;
-    static computeCollectionStatus(donations: FlatDonationLike[], year: number): FlatCollectionEntry[];
-    static compareFlatNumbers(a: string, b: string): number;
-    static convertNumberToWords(num: number): string;
-}
-
 declare class DonationModel extends BaseEntityModel implements IDonationEntity {
     id: number;
     receiptNumber: string;
     flatNo: string;
-    flatId: number;
     amount: number;
     mobileNumber?: string;
     paymentType: PaymentType;
@@ -367,10 +307,20 @@ declare class DonationModel extends BaseEntityModel implements IDonationEntity {
     updatedBy: number;
     createdByUser?: UserModel;
     updatedByUser?: UserModel;
-    flat?: FlatModel;
     protected constructor();
     static relations: Partial<Record<EntityList, IModelRelationConfig<EntityList>>>;
     static populateFromEntity(entity: IDonationEntity): DonationModel;
+    /**
+     * Sums the `amount` of all ACTIVE donations in the given list.
+     * The list is always `DonationModel[]`.
+     *
+     * @param donations - The list of DonationModels to sum
+     * @returns The total amount of all `EntityStatus.ACTIVE` donations (0 for empty lists)
+     *
+     * @example
+     * DonationModel.sumActiveDonations(donations); // 12345
+     */
+    static sumActiveDonations(donations: DonationModel[]): number;
     static getReceiptPrefix(flatNo: string): string;
     static generateReceiptNumber(flatNo: string, existingDonations: DonationModel[]): string;
     static toWhatsAppNumber(mobile: string): string;
@@ -446,6 +396,60 @@ declare class FlatHistoryModel extends BaseEntityModel implements IFlatHistoryEn
     static populateFromEntity(entity: IFlatHistoryEntity): FlatHistoryModel;
 }
 
+interface FlatDonationLike {
+    flatNo: string;
+    amount: number;
+    donationYear?: number;
+    createdOn?: number;
+    createdByUser?: Nullable<{
+        name?: string;
+    }>;
+    updatedByUser?: Nullable<{
+        name?: string;
+    }>;
+}
+type FlatCollectionStatus = "Paid" | "Pending";
+interface FlatCollectionEntry {
+    flatNumber: string;
+    status: FlatCollectionStatus;
+    amount: number;
+    latestDonation?: Nullable<FlatDonationLike>;
+}
+interface FlatParseResult {
+    wing?: string;
+    num?: string;
+    isSpecial: boolean;
+}
+interface FlatOption {
+    label: string;
+    value: string;
+}
+declare class FlatModel {
+    id: number;
+    wing: string;
+    unitNumber: string;
+    status: EntityStatus;
+    createdOn: number;
+    updatedOn: number;
+    createdBy: number;
+    updatedBy: number;
+    static populateFromEntity(entity: IFlatEntity): FlatModel;
+    static readonly FLAT_NUMBERS: readonly string[];
+    static readonly FLATS_BY_WING: ReadonlyMap<string, readonly string[]>;
+    static readonly SPECIAL_FLATS: readonly string[];
+    static readonly WINGS: readonly string[];
+    static getDonationYear(): number;
+    static getTotalFlats(): number;
+    static buildFlatNumber(wing: string, num: string): string;
+    static isSpecialFlat(flatNo: string): boolean;
+    static parseFlatNumber(flatNo: string): FlatParseResult;
+    static getFlatOptions(wing: string): FlatOption[];
+    static getDisplayLabel(wing: string, flatNo: string): string;
+    static computeCollectionStatus(donations: FlatDonationLike[], year: number): FlatCollectionEntry[];
+    static compareFlatNumbers(a: string, b: string): number;
+    static convertNumberToWords(num: number): string;
+}
+
 declare class SponsorHistoryModel extends BaseEntityModel implements ISponsorHistoryEntity {
     id: number;
     entityId: number;
@@ -685,6 +689,19 @@ declare function definedValues<T>(arr: Array<Nullable<T> | undefined>): T[];
  * epochToReadableDate(1700000000000);          // "2023-11-14T18:13:20.000Z"
  */
 declare function epochToReadableDate(epoch: number | string, format?: "short" | "long" | "short-dt" | "iso"): string;
+/**
+ * Rounds a number to exactly 2 decimal places.
+ * Uses `Number.EPSILON` to avoid common float artifacts
+ * (e.g. `305.4999999` incorrectly rounding down).
+ *
+ * @param value - The number to round
+ * @returns The number rounded to 2 decimal places (still a number, format per-platform afterwards)
+ *
+ * @example
+ * roundToTwoDecimals(305.49999); // 305.5
+ * roundToTwoDecimals(100.125);   // 100.13
+ */
+declare function roundToTwoDecimals(value: number): number;
 
 declare function convertNumberToWords(num: number): string;
 
@@ -970,4 +987,4 @@ declare function isSpecialFlatLabel(label: string): boolean;
 declare function getFlatValidationErrors(input: Partial<IFlatEntity>): FlatValidationError[];
 declare function validateFlatOrThrow(input: Partial<IFlatEntity>): void;
 
-export { ALL_WINGS_SELECTION, BadRequestException, BaseEntityModel, ConfigurationKey, ConfigurationModel, ConfigurationType, DateCodeUtils, DateUtil, DonationHistoryModel, DonationModel, EntityFilterDataHelper, EntityHistoryOperation, EntityList, type EntityListEntityModelMap, type EntityModelType, EntityStatus, type EntityType, ExpenseHistoryModel, ExpenseModel, ExpenseType, FLATS_BY_WING, FLAT_NUMBERS, FLAT_UNIT_NUMBER_PATTERN, FLAT_WING_PATTERN, type FlatCollectionEntry, type FlatCollectionStatus, type FlatDonationLike, FlatHistoryModel, FlatModel, type FlatOption, type FlatParseResult, type FlatValidationError, ForbiddenException, HttpException, type IAuditColumnEntity, type IBaseHistoryEntity, type ICashBookEntry, type IConfigurationCreateDto, type IConfigurationEntity, type IConfigurationSearchDto, type IConfigurationUpdateDto, type IDonationCreateDto, type IDonationEntity, type IDonationHistoryEntity, type IDonationSearchDto, type IDonationUpdateDto, type IDtoValidationError, type IEntityCreateDto, type IEntityFilterData, type IEntityFilterSearchData, type IEntityFilterSearchDataV2, type IEntityUpdateDto, type IExpenseCreateDto, type IExpenseEntity, type IExpenseHistoryEntity, type IExpenseSearchDto, type IExpenseUpdateDto, type IFlatCreateDto, type IFlatEntity, type IFlatHistoryEntity, type IFlatSearchDto, type IFlatUpdateDto, type IMappingPropertyEntry, type IModelRelationConfig, type ISearchV2Response, type ISponsorCreateDto, type ISponsorEntity, type ISponsorHistoryEntity, type ISponsorSearchDto, type ISponsorUpdateDto, type ITransactionCreateDto, type ITransactionEntity, type ITransactionHistoryEntity, type ITransactionSearchDto, type ITransactionUpdateDto, type IUserCreateDto, type IUserEntity, type IUserHistoryEntity, type IUserSearchDto, type IUserUpdateDto, type IVendorCreateDto, type IVendorEntity, type IVendorHistoryEntity, type IVendorSearchDto, type IVendorUpdateDto, NotFoundException, type Nullable, OrderByDirection, PAYMENT_OPTIONS, PaymentType, ReferenceIdPrefix, RelationType, SHOP_UNIT_NUMBER_PATTERN, SHOP_WING, SPECIAL_FLATS, SPECIAL_FLAT_LABELS, SponsorHistoryModel, SponsorModel, SponsorTier, TransactionEntityType, TransactionHistoryModel, TransactionModel, TransactionType, USER_RELATION_CONFIG, UnauthorizedException, type UserExpenseReport, type UserExpenseReportTotals, type UserExpenseRow, UserHistoryModel, UserModel, VendorHistoryModel, VendorModel, VendorType, WINGS, type WingCollectionDonationLike, type WingCollectionReport, type WingCollectionRow, type WingCollectionTotals, type XlsxCellAddress, type XlsxMergeRange, type XlsxSerializationType, type XlsxSheetInput, type XlsxSheetOptions, buildUserExpenseReport, buildUserExpenseWorkbook, buildWingWiseCollectionReport, buildWingWiseCollectionWorkbook, buildXlsxWorkbook, convertNumberToWords, definedValues, diffArrays, entityListEntityModelMap, epochToReadableDate, getFlatValidationErrors, getObjectDiffingKeys, getWingSelectionLabel, getWingSelectionSlug, groupBy, isSpecialFlatLabel, isValidFlatWing, serializeXlsx, validateFlatOrThrow };
+export { ALL_WINGS_SELECTION, BadRequestException, BaseEntityModel, ConfigurationKey, ConfigurationModel, ConfigurationType, DateCodeUtils, DateUtil, DonationHistoryModel, DonationModel, EntityFilterDataHelper, EntityHistoryOperation, EntityList, type EntityListEntityModelMap, type EntityModelType, EntityStatus, type EntityType, ExpenseHistoryModel, ExpenseModel, ExpenseType, FLATS_BY_WING, FLAT_NUMBERS, FLAT_UNIT_NUMBER_PATTERN, FLAT_WING_PATTERN, type FlatCollectionEntry, type FlatCollectionStatus, type FlatDonationLike, FlatHistoryModel, FlatModel, type FlatOption, type FlatParseResult, type FlatValidationError, ForbiddenException, HttpException, type IAuditColumnEntity, type IBaseHistoryEntity, type ICashBookEntry, type IConfigurationCreateDto, type IConfigurationEntity, type IConfigurationSearchDto, type IConfigurationUpdateDto, type IDonationCreateDto, type IDonationEntity, type IDonationHistoryEntity, type IDonationSearchDto, type IDonationUpdateDto, type IDtoValidationError, type IEntityCreateDto, type IEntityFilterData, type IEntityFilterSearchData, type IEntityFilterSearchDataV2, type IEntityUpdateDto, type IExpenseCreateDto, type IExpenseEntity, type IExpenseHistoryEntity, type IExpenseSearchDto, type IExpenseUpdateDto, type IFlatCreateDto, type IFlatEntity, type IFlatHistoryEntity, type IFlatSearchDto, type IFlatUpdateDto, type IMappingPropertyEntry, type IModelRelationConfig, type ISearchV2Response, type ISponsorCreateDto, type ISponsorEntity, type ISponsorHistoryEntity, type ISponsorSearchDto, type ISponsorUpdateDto, type ITransactionCreateDto, type ITransactionEntity, type ITransactionHistoryEntity, type ITransactionSearchDto, type ITransactionUpdateDto, type IUserCreateDto, type IUserEntity, type IUserHistoryEntity, type IUserSearchDto, type IUserUpdateDto, type IVendorCreateDto, type IVendorEntity, type IVendorHistoryEntity, type IVendorSearchDto, type IVendorUpdateDto, NotFoundException, type Nullable, OrderByDirection, PAYMENT_OPTIONS, PaymentType, ReferenceIdPrefix, RelationType, SHOP_UNIT_NUMBER_PATTERN, SHOP_WING, SPECIAL_FLATS, SPECIAL_FLAT_LABELS, SponsorHistoryModel, SponsorModel, SponsorTier, TransactionEntityType, TransactionHistoryModel, TransactionModel, TransactionType, USER_RELATION_CONFIG, UnauthorizedException, type UserExpenseReport, type UserExpenseReportTotals, type UserExpenseRow, UserHistoryModel, UserModel, VendorHistoryModel, VendorModel, VendorType, WINGS, type WingCollectionDonationLike, type WingCollectionReport, type WingCollectionRow, type WingCollectionTotals, type XlsxCellAddress, type XlsxMergeRange, type XlsxSerializationType, type XlsxSheetInput, type XlsxSheetOptions, buildUserExpenseReport, buildUserExpenseWorkbook, buildWingWiseCollectionReport, buildWingWiseCollectionWorkbook, buildXlsxWorkbook, convertNumberToWords, definedValues, diffArrays, entityListEntityModelMap, epochToReadableDate, getFlatValidationErrors, getObjectDiffingKeys, getWingSelectionLabel, getWingSelectionSlug, groupBy, isSpecialFlatLabel, isValidFlatWing, roundToTwoDecimals, serializeXlsx, validateFlatOrThrow };

package/dist/index.js

@@ -97,6 +97,7 @@ __export(index_exports, {
   groupBy: () => groupBy,
   isSpecialFlatLabel: () => isSpecialFlatLabel,
   isValidFlatWing: () => isValidFlatWing,
+  roundToTwoDecimals: () => roundToTwoDecimals,
   serializeXlsx: () => serializeXlsx,
   validateFlatOrThrow: () => validateFlatOrThrow
 });
@@ -789,7 +790,6 @@ var _DonationModel = class _DonationModel extends BaseEntityModel {
     this.id = 0;
     this.receiptNumber = "";
     this.flatNo = "";
-    this.flatId = 0;
     this.amount = 0;
     this.paymentType = "Cash" /* CASH */;
     this.status = "Active" /* ACTIVE */;
@@ -804,6 +804,19 @@ var _DonationModel = class _DonationModel extends BaseEntityModel {
       amount: Number(entity.amount)
     });
   }
+  /**
+   * Sums the `amount` of all ACTIVE donations in the given list.
+   * The list is always `DonationModel[]`.
+   *
+   * @param donations - The list of DonationModels to sum
+   * @returns The total amount of all `EntityStatus.ACTIVE` donations (0 for empty lists)
+   *
+   * @example
+   * DonationModel.sumActiveDonations(donations); // 12345
+   */
+  static sumActiveDonations(donations) {
+    return donations.filter((d) => d.status === "Active" /* ACTIVE */).reduce((sum, d) => sum + Number(d.amount), 0);
+  }
   static getReceiptPrefix(flatNo) {
     const year = (/* @__PURE__ */ new Date()).getFullYear();
     if (flatNo === "Devotee") return `MPCR-${year}-OD`;
@@ -834,12 +847,6 @@ _DonationModel.relations = {
     ],
     searchProperty: "id",
     entity: "user" /* USER */
-  },
-  ["flat" /* FLAT */]: {
-    relationType: "ONE" /* ONE */,
-    mappingProperties: [{ sourceProperty: "flatId", targetProperty: "flat" }],
-    searchProperty: "id",
-    entity: "flat" /* FLAT */
   }
 };
 var DonationModel = _DonationModel;
@@ -1113,25 +1120,6 @@ var _FlatModel = class _FlatModel {
     return convertNumberToWords(num);
   }
 };
-_FlatModel.relations = {
-  ["user" /* USER */]: {
-    relationType: "ONE" /* ONE */,
-    mappingProperties: [
-      { sourceProperty: "createdBy", targetProperty: "createdByUser" },
-      { sourceProperty: "updatedBy", targetProperty: "updatedByUser" }
-    ],
-    searchProperty: "id",
-    entity: "user" /* USER */
-  },
-  ["donation" /* DONATION */]: {
-    relationType: "MANY" /* MANY */,
-    mappingProperties: [
-      { sourceProperty: "id", targetProperty: "donations" }
-    ],
-    searchProperty: "flatId",
-    entity: "donation" /* DONATION */
-  }
-};
 _FlatModel.FLAT_NUMBERS = FLAT_NUMBERS;
 _FlatModel.FLATS_BY_WING = FLATS_BY_WING;
 _FlatModel.SPECIAL_FLATS = SPECIAL_FLATS;
@@ -1592,6 +1580,9 @@ function epochToReadableDate(epoch, format = "iso") {
       return date.toISOString();
   }
 }
+function roundToTwoDecimals(value) {
+  return Math.round((value + Number.EPSILON) * 100) / 100;
+}
 
 // src/utils/relation-config.utils.ts
 var RelationType = /* @__PURE__ */ ((RelationType2) => {
@@ -2070,6 +2061,7 @@ function validateFlatOrThrow(input) {
   groupBy,
   isSpecialFlatLabel,
   isValidFlatWing,
+  roundToTwoDecimals,
   serializeXlsx,
   validateFlatOrThrow
 });