@mody-park-cha-raja/finance_common 4.26.0 → 4.26.1-beta.1

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import * as XLSX from 'xlsx';
+
 declare const SPECIAL_FLATS: readonly string[];
 declare const FLAT_NUMBERS: readonly string[];
 declare const FLATS_BY_WING: ReadonlyMap<string, readonly string[]>;
@@ -383,6 +385,7 @@ declare class FlatModel {
     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;
@@ -653,6 +656,91 @@ declare enum OrderByDirection {
     DESC = "DESC"
 }
 
+interface UserExpenseRow {
+    userId: number;
+    userName: string;
+    count: number;
+    cash: number;
+    upi: number;
+    bankTransfer: number;
+    total: number;
+}
+interface UserExpenseReportTotals {
+    count: number;
+    cash: number;
+    upi: number;
+    bankTransfer: number;
+    total: number;
+}
+interface UserExpenseReport {
+    year: number;
+    rows: UserExpenseRow[];
+    totals: UserExpenseReportTotals;
+}
+declare function buildUserExpenseReport(expenses: ExpenseModel[], year: number): UserExpenseReport;
+declare function buildUserExpenseWorkbook(report: UserExpenseReport): XLSX.WorkBook;
+
+interface WingCollectionDonationLike {
+    flatNo: string;
+    amount: number;
+    receiptNumber?: string;
+    paymentType?: string;
+    createdOn?: number;
+}
+interface WingCollectionRow {
+    flatNo: string;
+    status: FlatCollectionStatus;
+    amount: number;
+    count: number;
+    receiptNumber: string;
+    paymentType: string;
+    donationDate: string;
+}
+interface WingCollectionTotals {
+    flats: number;
+    paid: number;
+    pending: number;
+    amount: number;
+    cash: number;
+    upi: number;
+    bankTransfer: number;
+}
+interface WingCollectionReport {
+    year: number;
+    selection: string;
+    label: string;
+    rows: WingCollectionRow[];
+    totals: WingCollectionTotals;
+}
+declare const ALL_WINGS_SELECTION = "ALL";
+declare function getWingSelectionLabel(selection: string): string;
+declare function getWingSelectionSlug(selection: string): string;
+declare function buildWingWiseCollectionReport(donations: WingCollectionDonationLike[], year: number, selection: string): WingCollectionReport;
+declare function buildWingWiseCollectionWorkbook(report: WingCollectionReport): XLSX.WorkBook;
+
+type XlsxSerializationType = 'base64' | 'array' | 'binary';
+interface XlsxCellAddress {
+    r: number;
+    c: number;
+}
+interface XlsxMergeRange {
+    s: XlsxCellAddress;
+    e: XlsxCellAddress;
+}
+interface XlsxSheetOptions {
+    cols?: {
+        wch?: number;
+    }[];
+    merges?: XlsxMergeRange[];
+}
+interface XlsxSheetInput {
+    name: string;
+    aoa: (string | number)[][];
+    options?: XlsxSheetOptions;
+}
+declare function buildXlsxWorkbook(sheets: XlsxSheetInput[]): XLSX.WorkBook;
+declare function serializeXlsx(workbook: XLSX.WorkBook, type: XlsxSerializationType): string | ArrayBuffer;
+
 interface IUserEntity extends IAuditColumnEntity {
     id: number;
     name: string;
@@ -807,4 +895,4 @@ interface IConfigurationUpdateDto extends IEntityUpdateDto<EntityType<EntityList
 interface IConfigurationSearchDto extends IEntityFilterData<EntityType<EntityList.CONFIGURATION>> {
 }
 
-export { 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, type FlatCollectionEntry, type FlatCollectionStatus, type FlatDonationLike, FlatModel, type FlatOption, type FlatParseResult, 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 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, SPECIAL_FLATS, SponsorHistoryModel, SponsorModel, SponsorTier, TransactionEntityType, TransactionHistoryModel, TransactionModel, TransactionType, USER_RELATION_CONFIG, UnauthorizedException, UserHistoryModel, UserModel, VendorHistoryModel, VendorModel, VendorType, WINGS, convertNumberToWords, definedValues, diffArrays, entityListEntityModelMap, epochToReadableDate, getObjectDiffingKeys, groupBy };
+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, type FlatCollectionEntry, type FlatCollectionStatus, type FlatDonationLike, FlatModel, type FlatOption, type FlatParseResult, 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 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, SPECIAL_FLATS, 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, getObjectDiffingKeys, getWingSelectionLabel, getWingSelectionSlug, groupBy, serializeXlsx };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import * as XLSX from 'xlsx';
+
 declare const SPECIAL_FLATS: readonly string[];
 declare const FLAT_NUMBERS: readonly string[];
 declare const FLATS_BY_WING: ReadonlyMap<string, readonly string[]>;
@@ -383,6 +385,7 @@ declare class FlatModel {
     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;
@@ -653,6 +656,91 @@ declare enum OrderByDirection {
     DESC = "DESC"
 }
 
+interface UserExpenseRow {
+    userId: number;
+    userName: string;
+    count: number;
+    cash: number;
+    upi: number;
+    bankTransfer: number;
+    total: number;
+}
+interface UserExpenseReportTotals {
+    count: number;
+    cash: number;
+    upi: number;
+    bankTransfer: number;
+    total: number;
+}
+interface UserExpenseReport {
+    year: number;
+    rows: UserExpenseRow[];
+    totals: UserExpenseReportTotals;
+}
+declare function buildUserExpenseReport(expenses: ExpenseModel[], year: number): UserExpenseReport;
+declare function buildUserExpenseWorkbook(report: UserExpenseReport): XLSX.WorkBook;
+
+interface WingCollectionDonationLike {
+    flatNo: string;
+    amount: number;
+    receiptNumber?: string;
+    paymentType?: string;
+    createdOn?: number;
+}
+interface WingCollectionRow {
+    flatNo: string;
+    status: FlatCollectionStatus;
+    amount: number;
+    count: number;
+    receiptNumber: string;
+    paymentType: string;
+    donationDate: string;
+}
+interface WingCollectionTotals {
+    flats: number;
+    paid: number;
+    pending: number;
+    amount: number;
+    cash: number;
+    upi: number;
+    bankTransfer: number;
+}
+interface WingCollectionReport {
+    year: number;
+    selection: string;
+    label: string;
+    rows: WingCollectionRow[];
+    totals: WingCollectionTotals;
+}
+declare const ALL_WINGS_SELECTION = "ALL";
+declare function getWingSelectionLabel(selection: string): string;
+declare function getWingSelectionSlug(selection: string): string;
+declare function buildWingWiseCollectionReport(donations: WingCollectionDonationLike[], year: number, selection: string): WingCollectionReport;
+declare function buildWingWiseCollectionWorkbook(report: WingCollectionReport): XLSX.WorkBook;
+
+type XlsxSerializationType = 'base64' | 'array' | 'binary';
+interface XlsxCellAddress {
+    r: number;
+    c: number;
+}
+interface XlsxMergeRange {
+    s: XlsxCellAddress;
+    e: XlsxCellAddress;
+}
+interface XlsxSheetOptions {
+    cols?: {
+        wch?: number;
+    }[];
+    merges?: XlsxMergeRange[];
+}
+interface XlsxSheetInput {
+    name: string;
+    aoa: (string | number)[][];
+    options?: XlsxSheetOptions;
+}
+declare function buildXlsxWorkbook(sheets: XlsxSheetInput[]): XLSX.WorkBook;
+declare function serializeXlsx(workbook: XLSX.WorkBook, type: XlsxSerializationType): string | ArrayBuffer;
+
 interface IUserEntity extends IAuditColumnEntity {
     id: number;
     name: string;
@@ -807,4 +895,4 @@ interface IConfigurationUpdateDto extends IEntityUpdateDto<EntityType<EntityList
 interface IConfigurationSearchDto extends IEntityFilterData<EntityType<EntityList.CONFIGURATION>> {
 }
 
-export { 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, type FlatCollectionEntry, type FlatCollectionStatus, type FlatDonationLike, FlatModel, type FlatOption, type FlatParseResult, 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 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, SPECIAL_FLATS, SponsorHistoryModel, SponsorModel, SponsorTier, TransactionEntityType, TransactionHistoryModel, TransactionModel, TransactionType, USER_RELATION_CONFIG, UnauthorizedException, UserHistoryModel, UserModel, VendorHistoryModel, VendorModel, VendorType, WINGS, convertNumberToWords, definedValues, diffArrays, entityListEntityModelMap, epochToReadableDate, getObjectDiffingKeys, groupBy };
+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, type FlatCollectionEntry, type FlatCollectionStatus, type FlatDonationLike, FlatModel, type FlatOption, type FlatParseResult, 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 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, SPECIAL_FLATS, 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, getObjectDiffingKeys, getWingSelectionLabel, getWingSelectionSlug, groupBy, serializeXlsx };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,11 +17,20 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ALL_WINGS_SELECTION: () => ALL_WINGS_SELECTION,
   BadRequestException: () => BadRequestException,
   BaseEntityModel: () => BaseEntityModel,
   ConfigurationKey: () => ConfigurationKey,
@@ -63,13 +74,21 @@ __export(index_exports, {
   VendorModel: () => VendorModel,
   VendorType: () => VendorType,
   WINGS: () => WINGS,
+  buildUserExpenseReport: () => buildUserExpenseReport,
+  buildUserExpenseWorkbook: () => buildUserExpenseWorkbook,
+  buildWingWiseCollectionReport: () => buildWingWiseCollectionReport,
+  buildWingWiseCollectionWorkbook: () => buildWingWiseCollectionWorkbook,
+  buildXlsxWorkbook: () => buildXlsxWorkbook,
   convertNumberToWords: () => convertNumberToWords,
   definedValues: () => definedValues,
   diffArrays: () => diffArrays,
   entityListEntityModelMap: () => entityListEntityModelMap,
   epochToReadableDate: () => epochToReadableDate,
   getObjectDiffingKeys: () => getObjectDiffingKeys,
-  groupBy: () => groupBy
+  getWingSelectionLabel: () => getWingSelectionLabel,
+  getWingSelectionSlug: () => getWingSelectionSlug,
+  groupBy: () => groupBy,
+  serializeXlsx: () => serializeXlsx
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -965,6 +984,9 @@ var _FlatModel = class _FlatModel {
   static getDonationYear() {
     return (/* @__PURE__ */ new Date()).getFullYear();
   }
+  static getTotalFlats() {
+    return _FlatModel.FLAT_NUMBERS.length;
+  }
   static buildFlatNumber(wing, num) {
     return `${wing}-${num}`;
   }
@@ -1512,6 +1534,231 @@ var OrderByDirection = /* @__PURE__ */ ((OrderByDirection2) => {
   return OrderByDirection2;
 })(OrderByDirection || {});
 
+// src/utils/xlsx.utils.ts
+var XLSX = __toESM(require("xlsx"));
+function addressToCell(addr) {
+  return { c: addr.c, r: addr.r };
+}
+function buildXlsxWorkbook(sheets) {
+  const workbook = XLSX.utils.book_new();
+  for (const { name, aoa, options } of sheets) {
+    const worksheet = XLSX.utils.aoa_to_sheet(aoa);
+    if (options) {
+      if (options.cols) worksheet["!cols"] = options.cols;
+      if (options.merges) {
+        worksheet["!merges"] = options.merges.map((merge) => ({
+          s: addressToCell(merge.s),
+          e: addressToCell(merge.e)
+        }));
+      }
+    }
+    XLSX.utils.book_append_sheet(workbook, worksheet, name);
+  }
+  return workbook;
+}
+function serializeXlsx(workbook, type) {
+  return XLSX.write(workbook, { type, bookType: "xlsx" });
+}
+
+// src/utils/user-expense.report.ts
+function buildUserExpenseReport(expenses, year) {
+  const map = /* @__PURE__ */ new Map();
+  for (const e of expenses) {
+    const userId = e.incurredBy ?? 0;
+    const userName = e.incurredByUserName || (userId === 0 ? UserModel.mandalAccountUser().name : `User #${userId}`);
+    let row = map.get(userId);
+    if (!row) {
+      row = { userId, userName, count: 0, cash: 0, upi: 0, bankTransfer: 0, total: 0 };
+      map.set(userId, row);
+    }
+    row.count += 1;
+    row.total += e.amount;
+    if (e.paymentType === "UPI" /* UPI */) {
+      row.upi += e.amount;
+    } else if (e.paymentType === "Bank Transfer" /* BANK_TRANSFER */) {
+      row.bankTransfer += e.amount;
+    } else {
+      row.cash += e.amount;
+    }
+  }
+  const rows = [...map.values()].sort((a, b) => b.total - a.total);
+  const totals = rows.reduce(
+    (acc, r) => ({
+      count: acc.count + r.count,
+      cash: acc.cash + r.cash,
+      upi: acc.upi + r.upi,
+      bankTransfer: acc.bankTransfer + r.bankTransfer,
+      total: acc.total + r.total
+    }),
+    { count: 0, cash: 0, upi: 0, bankTransfer: 0, total: 0 }
+  );
+  return { year, rows, totals };
+}
+function buildUserExpenseWorkbook(report) {
+  const aoa = [
+    ["User", "Expense Count", "Cash (INR)", "UPI (INR)", "Bank Transfer (INR)", "Total (INR)"]
+  ];
+  for (const row of report.rows) {
+    aoa.push([row.userName, row.count, row.cash, row.upi, row.bankTransfer, row.total]);
+  }
+  aoa.push([
+    "GRAND TOTAL",
+    report.totals.count,
+    report.totals.cash,
+    report.totals.upi,
+    report.totals.bankTransfer,
+    report.totals.total
+  ]);
+  return buildXlsxWorkbook([
+    {
+      name: "User-wise Expense Report",
+      aoa,
+      options: {
+        cols: [{ wch: 26 }, { wch: 14 }, { wch: 12 }, { wch: 12 }, { wch: 18 }, { wch: 12 }]
+      }
+    }
+  ]);
+}
+
+// src/utils/wing-wise-collection.report.ts
+var ALL_WINGS_SELECTION = "ALL";
+function getWingSelectionLabel(selection) {
+  if (selection === ALL_WINGS_SELECTION) return "All Wings";
+  if (FlatModel.SPECIAL_FLATS.includes(selection)) return selection;
+  return `Wing ${selection}`;
+}
+function getWingSelectionSlug(selection) {
+  if (selection === ALL_WINGS_SELECTION) return "all";
+  if (FlatModel.SPECIAL_FLATS.includes(selection)) {
+    return selection.toLowerCase().replace(/[^a-z0-9]+/g, "-");
+  }
+  return selection.toLowerCase();
+}
+function getFlatNumbersInScope(selection) {
+  if (selection === ALL_WINGS_SELECTION) {
+    return FlatModel.FLAT_NUMBERS.map((n) => n);
+  }
+  if (FlatModel.SPECIAL_FLATS.includes(selection)) {
+    return [selection];
+  }
+  const wingFlats = FlatModel.FLATS_BY_WING.get(selection) ?? [];
+  return wingFlats.map((num) => FlatModel.buildFlatNumber(selection, num));
+}
+function buildWingWiseCollectionReport(donations, year, selection) {
+  const label = getWingSelectionLabel(selection);
+  const donationsByFlat = /* @__PURE__ */ new Map();
+  for (const d of donations) {
+    const list = donationsByFlat.get(d.flatNo) ?? [];
+    list.push(d);
+    donationsByFlat.set(d.flatNo, list);
+  }
+  const rows = getFlatNumbersInScope(selection).map(
+    (flatNo) => {
+      const flatDonations = donationsByFlat.get(flatNo) ?? [];
+      const amount = flatDonations.reduce((sum, d) => sum + d.amount, 0);
+      const latest = flatDonations.reduce(
+        (acc, d) => !acc || (d.createdOn ?? 0) > (acc.createdOn ?? 0) ? d : acc,
+        null
+      );
+      return {
+        flatNo,
+        status: amount > 0 ? "Paid" : "Pending",
+        amount,
+        count: flatDonations.length,
+        receiptNumber: latest?.receiptNumber ?? "",
+        paymentType: latest?.paymentType ?? "",
+        donationDate: latest?.createdOn ? epochToReadableDate(latest.createdOn, "short") : ""
+      };
+    }
+  );
+  rows.sort((a, b) => FlatModel.compareFlatNumbers(a.flatNo, b.flatNo));
+  const totals = rows.reduce(
+    (acc, r) => ({
+      flats: acc.flats + 1,
+      paid: acc.paid + (r.status === "Paid" ? 1 : 0),
+      pending: acc.pending + (r.status === "Pending" ? 1 : 0),
+      amount: acc.amount + r.amount,
+      cash: acc.cash,
+      upi: acc.upi,
+      bankTransfer: acc.bankTransfer
+    }),
+    { flats: 0, paid: 0, pending: 0, amount: 0, cash: 0, upi: 0, bankTransfer: 0 }
+  );
+  for (const [flatNo, flatDonations] of donationsByFlat) {
+    if (!getFlatNumbersInScope(selection).includes(flatNo)) continue;
+    for (const d of flatDonations) {
+      if (d.paymentType === "Cash" /* CASH */) {
+        totals.cash += d.amount;
+      } else if (d.paymentType === "UPI" /* UPI */) {
+        totals.upi += d.amount;
+      } else {
+        totals.bankTransfer += d.amount;
+      }
+    }
+  }
+  return { year, selection, label, rows, totals };
+}
+function buildWingWiseCollectionWorkbook(report) {
+  const aoa = [
+    [
+      `Mody Park Ganeshotsav Mandal - Wing-wise Collection Report (${report.label}) - ${report.year}`
+    ],
+    [
+      `Assessment Cycle ${report.year} - Flats ${report.totals.flats}, Paid ${report.totals.paid}, Pending ${report.totals.pending}`
+    ],
+    [
+      "S.No.",
+      "Flat No",
+      "Status",
+      "Amount (INR)",
+      "Receipt No",
+      "Payment Type",
+      "Donation Date"
+    ]
+  ];
+  report.rows.forEach((row, index) => {
+    aoa.push([
+      index + 1,
+      row.flatNo,
+      row.status,
+      row.amount,
+      row.receiptNumber,
+      row.paymentType,
+      row.donationDate
+    ]);
+  });
+  aoa.push([
+    "",
+    "GRAND TOTAL",
+    `${report.totals.paid} Paid / ${report.totals.pending} Pending`,
+    report.totals.amount,
+    "",
+    "",
+    ""
+  ]);
+  return buildXlsxWorkbook([
+    {
+      name: "Wing-Wise Collection",
+      aoa,
+      options: {
+        cols: [
+          { wch: 8 },
+          { wch: 10 },
+          { wch: 12 },
+          { wch: 14 },
+          { wch: 18 },
+          { wch: 14 },
+          { wch: 14 }
+        ],
+        merges: [
+          { s: { r: 0, c: 0 }, e: { r: 0, c: 6 } },
+          { s: { r: 1, c: 0 }, e: { r: 1, c: 6 } }
+        ]
+      }
+    }
+  ]);
+}
+
 // src/helpers/entity-filter-data.helper.ts
 var EntityFilterDataHelper = class {
   constructor(searchResponse) {
@@ -1610,6 +1857,7 @@ var USER_RELATION_CONFIG = {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ALL_WINGS_SELECTION,
   BadRequestException,
   BaseEntityModel,
   ConfigurationKey,
@@ -1653,12 +1901,20 @@ var USER_RELATION_CONFIG = {
   VendorModel,
   VendorType,
   WINGS,
+  buildUserExpenseReport,
+  buildUserExpenseWorkbook,
+  buildWingWiseCollectionReport,
+  buildWingWiseCollectionWorkbook,
+  buildXlsxWorkbook,
   convertNumberToWords,
   definedValues,
   diffArrays,
   entityListEntityModelMap,
   epochToReadableDate,
   getObjectDiffingKeys,
-  groupBy
+  getWingSelectionLabel,
+  getWingSelectionSlug,
+  groupBy,
+  serializeXlsx
 });
 //# sourceMappingURL=index.js.map