import { describe, expect, test } from 'bun:test' import { createFinanceCommandService, createHouseholdOnboardingService } from '@household/application' import { instantFromIso } from '@household/domain' import type { ExchangeRateProvider, FinanceRepository, HouseholdConfigurationRepository, HouseholdTopicBindingRecord } from '@household/ports' import { createMiniAppDashboardHandler } from './miniapp-dashboard' import { buildMiniAppInitData } from './telegram-miniapp-test-helpers' function expectedCurrentCyclePeriod(timezone: string, rentDueDay: number): string { const parts = new Intl.DateTimeFormat('en-CA', { timeZone: timezone, year: 'numeric', month: '2-digit', day: '2-digit' }).formatToParts(new Date()) const year = Number(parts.find((part) => part.type === 'year')?.value ?? '0') const month = Number(parts.find((part) => part.type === 'month')?.value ?? '1') const day = Number(parts.find((part) => part.type === 'day')?.value ?? '1') const carryMonth = day > rentDueDay ? month + 1 : month const normalizedYear = carryMonth > 12 ? year + 1 : year const normalizedMonth = carryMonth > 12 ? 1 : carryMonth return `${normalizedYear}-${String(normalizedMonth).padStart(2, '0')}` } function repository( member: Awaited> ): FinanceRepository { let cycle: Awaited> extends infer T ? Exclude : never = { id: 'cycle-1', period: '2026-03', currency: 'GEL' as const } return { getMemberByTelegramUserId: async () => member, listMembers: async () => [ member ?? { id: 'member-1', telegramUserId: '123456', displayName: 'Stan', rentShareWeight: 1, isAdmin: true } ], getOpenCycle: async () => cycle, getCycleByPeriod: async (period) => (period === cycle.period ? cycle : null), getLatestCycle: async () => cycle, openCycle: async (period, currency) => { cycle = { id: 'opened-cycle', period, currency } }, closeCycle: async () => {}, saveRentRule: async () => {}, getCycleExchangeRate: async () => null, saveCycleExchangeRate: async (input) => input, addUtilityBill: async () => {}, updateParsedPurchase: async () => null, addParsedPurchase: async (input) => ({ id: 'purchase-new', payerMemberId: input.payerMemberId, amountMinor: input.amountMinor, currency: input.currency, description: input.description, occurredAt: input.occurredAt, splitMode: input.splitMode ?? 'equal', participants: input.participants?.map((p) => ({ memberId: p.memberId, included: p.included ?? true, shareAmountMinor: p.shareAmountMinor ?? null })) ?? [] }), deleteParsedPurchase: async () => false, updateUtilityBill: async () => null, deleteUtilityBill: async () => false, addPaymentRecord: async (input) => ({ id: 'payment-new', memberId: input.memberId, kind: input.kind, amountMinor: input.amountMinor, currency: input.currency, recordedAt: input.recordedAt }), updatePaymentRecord: async () => null, deletePaymentRecord: async () => false, getRentRuleForPeriod: async () => ({ amountMinor: 70000n, currency: 'USD' }), getUtilityTotalForCycle: async () => 12000n, listUtilityBillsForCycle: async () => [ { id: 'utility-1', billName: 'Electricity', amountMinor: 12000n, currency: 'GEL', createdByMemberId: member?.id ?? 'member-1', createdAt: instantFromIso('2026-03-12T12:00:00.000Z') } ], listPaymentRecordsForCycle: async () => [ { id: 'payment-1', memberId: member?.id ?? 'member-1', kind: 'rent', amountMinor: 50000n, currency: 'GEL', recordedAt: instantFromIso('2026-03-18T12:00:00.000Z') } ], listParsedPurchasesForRange: async () => [ { id: 'purchase-1', payerMemberId: member?.id ?? 'member-1', amountMinor: 3000n, currency: 'GEL', description: 'Soap', occurredAt: instantFromIso('2026-03-12T11:00:00.000Z') } ], getSettlementSnapshotLines: async () => [], savePaymentConfirmation: async () => ({ status: 'needs_review', reviewReason: 'settlement_not_ready' }) as const, replaceSettlementSnapshot: async () => {} } } const exchangeRateProvider: ExchangeRateProvider = { async getRate(input) { if (input.baseCurrency === input.quoteCurrency) { return { baseCurrency: input.baseCurrency, quoteCurrency: input.quoteCurrency, rateMicros: 1_000_000n, effectiveDate: input.effectiveDate, source: 'nbg' } } return { baseCurrency: input.baseCurrency, quoteCurrency: input.quoteCurrency, rateMicros: 2_700_000n, effectiveDate: input.effectiveDate, source: 'nbg' } } } function onboardingRepository(): HouseholdConfigurationRepository { const household = { householdId: 'household-1', householdName: 'Kojori House', telegramChatId: '-100123', telegramChatType: 'supergroup', title: 'Kojori House', defaultLocale: 'ru' as const } return { registerTelegramHouseholdChat: async () => ({ status: 'existing', household }), getTelegramHouseholdChat: async () => household, getHouseholdChatByHouseholdId: async () => household, bindHouseholdTopic: async (input) => ({ householdId: input.householdId, role: input.role, telegramThreadId: input.telegramThreadId, topicName: input.topicName?.trim() || null }) satisfies HouseholdTopicBindingRecord, getHouseholdTopicBinding: async () => null, findHouseholdTopicByTelegramContext: async () => null, listHouseholdTopicBindings: async () => [], clearHouseholdTopicBindings: async () => {}, listReminderTargets: async () => [], upsertHouseholdJoinToken: async (input) => ({ householdId: household.householdId, householdName: household.householdName, token: input.token, createdByTelegramUserId: input.createdByTelegramUserId ?? null }), getHouseholdJoinToken: async () => null, getHouseholdByJoinToken: async () => null, upsertPendingHouseholdMember: async (input) => ({ householdId: household.householdId, householdName: household.householdName, telegramUserId: input.telegramUserId, displayName: input.displayName, username: input.username?.trim() || null, languageCode: input.languageCode?.trim() || null, householdDefaultLocale: household.defaultLocale }), getPendingHouseholdMember: async () => null, findPendingHouseholdMemberByTelegramUserId: async () => null, ensureHouseholdMember: async (input) => ({ id: `member-${input.telegramUserId}`, householdId: household.householdId, telegramUserId: input.telegramUserId, displayName: input.displayName, status: input.status ?? 'active', preferredLocale: input.preferredLocale ?? null, householdDefaultLocale: household.defaultLocale, rentShareWeight: 1, isAdmin: input.isAdmin === true }), getHouseholdMember: async () => null, listHouseholdMembers: async () => [ { id: 'member-1', householdId: household.householdId, telegramUserId: '123456', displayName: 'Stan', status: 'active', preferredLocale: null, householdDefaultLocale: household.defaultLocale, rentShareWeight: 1, isAdmin: true } ], listHouseholdMembersByTelegramUserId: async () => [], listPendingHouseholdMembers: async () => [], approvePendingHouseholdMember: async () => null, rejectPendingHouseholdMember: async () => false, updateHouseholdDefaultLocale: async (_householdId, locale) => ({ ...household, defaultLocale: locale }), updateMemberPreferredLocale: async () => null, updateHouseholdMemberDisplayName: async () => null, getHouseholdBillingSettings: async (householdId) => ({ householdId, settlementCurrency: 'GEL', rentAmountMinor: null, rentCurrency: 'USD', rentDueDay: 20, rentWarningDay: 17, utilitiesDueDay: 4, utilitiesReminderDay: 3, timezone: 'Asia/Tbilisi', rentPaymentDestinations: null }), updateHouseholdBillingSettings: async (input) => ({ householdId: input.householdId, settlementCurrency: input.settlementCurrency ?? 'GEL', rentAmountMinor: input.rentAmountMinor ?? null, rentCurrency: input.rentCurrency ?? 'USD', rentDueDay: input.rentDueDay ?? 20, rentWarningDay: input.rentWarningDay ?? 17, utilitiesDueDay: input.utilitiesDueDay ?? 4, utilitiesReminderDay: input.utilitiesReminderDay ?? 3, timezone: input.timezone ?? 'Asia/Tbilisi', rentPaymentDestinations: input.rentPaymentDestinations ?? null }), listHouseholdUtilityCategories: async () => [], upsertHouseholdUtilityCategory: async (input) => ({ id: input.slug ?? 'utility-category-1', householdId: input.householdId, slug: input.slug ?? 'custom', name: input.name, sortOrder: input.sortOrder, isActive: input.isActive }), promoteHouseholdAdmin: async () => null, updateHouseholdMemberRentShareWeight: async () => null, updateHouseholdMemberStatus: async () => null, listHouseholdMemberAbsencePolicies: async () => [], upsertHouseholdMemberAbsencePolicy: async () => null } } describe('createMiniAppDashboardHandler', () => { test('returns a dashboard for an authenticated household member', async () => { const authDate = Math.floor(Date.now() / 1000) const householdRepository = onboardingRepository() const financeService = createFinanceCommandService({ householdId: 'household-1', repository: repository({ id: 'member-1', telegramUserId: '123456', displayName: 'Stan', rentShareWeight: 1, isAdmin: true }), householdConfigurationRepository: householdRepository, exchangeRateProvider }) householdRepository.listHouseholdMembersByTelegramUserId = async () => [ { id: 'member-1', householdId: 'household-1', telegramUserId: '123456', displayName: 'Stan', status: 'active', preferredLocale: null, householdDefaultLocale: 'ru', rentShareWeight: 1, isAdmin: true } ] const dashboard = createMiniAppDashboardHandler({ allowedOrigins: ['http://localhost:5173'], botToken: 'test-bot-token', financeServiceForHousehold: () => financeService, onboardingService: createHouseholdOnboardingService({ repository: householdRepository }) }) const response = await dashboard.handler( new Request('http://localhost/api/miniapp/dashboard', { method: 'POST', headers: { origin: 'http://localhost:5173', 'content-type': 'application/json' }, body: JSON.stringify({ initData: buildMiniAppInitData('test-bot-token', authDate, { id: 123456, first_name: 'Stan', username: 'stanislav', language_code: 'ru' }) }) }) ) expect(response.status).toBe(200) expect(await response.json()).toMatchObject({ ok: true, authorized: true, dashboard: { period: expectedCurrentCyclePeriod('Asia/Tbilisi', 20), currency: 'GEL', paymentBalanceAdjustmentPolicy: 'utilities', totalDueMajor: '2010.00', totalPaidMajor: '500.00', totalRemainingMajor: '1510.00', rentSourceAmountMajor: '700.00', rentSourceCurrency: 'USD', rentDisplayAmountMajor: '1890.00', members: [ { displayName: 'Stan', netDueMajor: '2010.00', paidMajor: '500.00', remainingMajor: '1510.00', rentShareMajor: '1890.00', utilityShareMajor: '120.00', purchaseOffsetMajor: '0.00' } ], ledger: [ { title: 'Soap', currency: 'GEL', displayCurrency: 'GEL' }, { title: 'Electricity', currency: 'GEL', displayCurrency: 'GEL' }, { kind: 'payment', title: 'rent', paymentKind: 'rent', currency: 'GEL', displayCurrency: 'GEL' } ] } }) }) test('serializes purchase split details into the mini app dashboard', async () => { const authDate = Math.floor(Date.now() / 1000) const householdRepository = onboardingRepository() const financeRepository = repository({ id: 'member-1', telegramUserId: '123456', displayName: 'Stan', rentShareWeight: 1, isAdmin: true }) financeRepository.listParsedPurchasesForRange = async () => [ { id: 'purchase-1', payerMemberId: 'member-1', amountMinor: 3000n, currency: 'GEL', description: 'Kettle', occurredAt: instantFromIso('2026-03-12T11:00:00.000Z'), splitMode: 'custom_amounts', participants: [ { memberId: 'member-1', included: true, shareAmountMinor: 2000n }, { memberId: 'member-2', included: false, shareAmountMinor: null }, { memberId: 'member-3', included: true, shareAmountMinor: 1000n } ] } ] financeRepository.listMembers = async () => [ { id: 'member-1', telegramUserId: '123456', displayName: 'Stan', rentShareWeight: 1, isAdmin: true }, { id: 'member-2', telegramUserId: '456789', displayName: 'Dima', rentShareWeight: 1, isAdmin: false }, { id: 'member-3', telegramUserId: '789123', displayName: 'Chorbanaut', rentShareWeight: 1, isAdmin: false } ] const financeService = createFinanceCommandService({ householdId: 'household-1', repository: financeRepository, householdConfigurationRepository: householdRepository, exchangeRateProvider }) householdRepository.listHouseholdMembersByTelegramUserId = async () => [ { id: 'member-1', householdId: 'household-1', telegramUserId: '123456', displayName: 'Stan', status: 'active', preferredLocale: null, householdDefaultLocale: 'ru', rentShareWeight: 1, isAdmin: true } ] householdRepository.listHouseholdMembers = async () => [ { id: 'member-1', householdId: 'household-1', telegramUserId: '123456', displayName: 'Stan', status: 'active', preferredLocale: null, householdDefaultLocale: 'ru', rentShareWeight: 1, isAdmin: true }, { id: 'member-2', householdId: 'household-1', telegramUserId: '456789', displayName: 'Dima', status: 'active', preferredLocale: null, householdDefaultLocale: 'ru', rentShareWeight: 1, isAdmin: false }, { id: 'member-3', householdId: 'household-1', telegramUserId: '789123', displayName: 'Chorbanaut', status: 'active', preferredLocale: null, householdDefaultLocale: 'ru', rentShareWeight: 1, isAdmin: false } ] const dashboard = createMiniAppDashboardHandler({ allowedOrigins: ['http://localhost:5173'], botToken: 'test-bot-token', financeServiceForHousehold: () => financeService, onboardingService: createHouseholdOnboardingService({ repository: householdRepository }) }) const response = await dashboard.handler( new Request('http://localhost/api/miniapp/dashboard', { method: 'POST', headers: { origin: 'http://localhost:5173', 'content-type': 'application/json' }, body: JSON.stringify({ initData: buildMiniAppInitData('test-bot-token', authDate, { id: 123456, first_name: 'Stan', username: 'stanislav', language_code: 'ru' }) }) }) ) expect(response.status).toBe(200) expect(await response.json()).toMatchObject({ ok: true, authorized: true, dashboard: { ledger: [ { id: 'purchase-1', purchaseSplitMode: 'custom_amounts', purchaseParticipants: [ { memberId: 'member-1', included: true, shareAmountMajor: '20.00' }, { memberId: 'member-2', included: false, shareAmountMajor: null }, { memberId: 'member-3', included: true, shareAmountMajor: '10.00' } ] }, { title: 'Electricity' }, { kind: 'payment' } ] } }) }) test('returns 400 for malformed JSON bodies', async () => { const householdRepository = onboardingRepository() const financeService = createFinanceCommandService({ householdId: 'household-1', repository: repository({ id: 'member-1', telegramUserId: '123456', displayName: 'Stan', rentShareWeight: 1, isAdmin: true }), householdConfigurationRepository: householdRepository, exchangeRateProvider }) householdRepository.listHouseholdMembersByTelegramUserId = async () => [ { id: 'member-1', householdId: 'household-1', telegramUserId: '123456', displayName: 'Stan', status: 'active', preferredLocale: null, householdDefaultLocale: 'ru', rentShareWeight: 1, isAdmin: true } ] const dashboard = createMiniAppDashboardHandler({ allowedOrigins: ['http://localhost:5173'], botToken: 'test-bot-token', financeServiceForHousehold: () => financeService, onboardingService: createHouseholdOnboardingService({ repository: householdRepository }) }) const response = await dashboard.handler( new Request('http://localhost/api/miniapp/dashboard', { method: 'POST', headers: { origin: 'http://localhost:5173', 'content-type': 'application/json' }, body: '{"initData":' }) ) expect(response.status).toBe(400) expect(await response.json()).toEqual({ ok: false, error: 'Invalid JSON body' }) }) test('returns a dashboard even if rent rule is missing', async () => { const authDate = Math.floor(Date.now() / 1000) const householdRepository = onboardingRepository() const financeRepository = repository({ id: 'member-1', telegramUserId: '123456', displayName: 'Stan', rentShareWeight: 1, isAdmin: true }) // Simulate missing rent rule financeRepository.getRentRuleForPeriod = async () => null const financeService = createFinanceCommandService({ householdId: 'household-1', repository: financeRepository, householdConfigurationRepository: householdRepository, exchangeRateProvider }) householdRepository.listHouseholdMembersByTelegramUserId = async () => [ { id: 'member-1', householdId: 'household-1', telegramUserId: '123456', displayName: 'Stan', status: 'active', preferredLocale: null, householdDefaultLocale: 'ru', rentShareWeight: 1, isAdmin: true } ] const dashboard = createMiniAppDashboardHandler({ allowedOrigins: ['http://localhost:5173'], botToken: 'test-bot-token', financeServiceForHousehold: () => financeService, onboardingService: createHouseholdOnboardingService({ repository: householdRepository }) }) const response = await dashboard.handler( new Request('http://localhost/api/miniapp/dashboard', { method: 'POST', headers: { origin: 'http://localhost:5173', 'content-type': 'application/json' }, body: JSON.stringify({ initData: buildMiniAppInitData('test-bot-token', authDate, { id: 123456, first_name: 'Stan', username: 'stanislav', language_code: 'ru' }) }) }) ) expect(response.status).toBe(200) const data = (await response.json()) as any expect(data.ok).toBe(true) expect(data.dashboard.rentSourceAmountMajor).toBe('0.00') expect(data.dashboard.rentDisplayAmountMajor).toBe('0.00') }) })