household-bot/packages/application/src/household-onboarding-service.test.ts

import { describe, expect, test } from 'bun:test'

import type {
  HouseholdConfigurationRepository,
  HouseholdMemberRecord,
  HouseholdJoinTokenRecord,
  HouseholdPendingMemberRecord,
  HouseholdTelegramChatRecord,
  HouseholdTopicBindingRecord
} from '@household/ports'

import { createHouseholdOnboardingService } from './household-onboarding-service'

function createRepositoryStub() {
  const household: HouseholdTelegramChatRecord = {
    householdId: 'household-1',
    householdName: 'Kojori House',
    telegramChatId: '-100123',
    telegramChatType: 'supergroup',
    title: 'Kojori House',
    defaultLocale: 'ru'
  }
  let joinToken: HouseholdJoinTokenRecord | null = null
  const pendingMembers = new Map<string, HouseholdPendingMemberRecord>()
  const members = new Map<string, HouseholdMemberRecord>()

  const repository: HouseholdConfigurationRepository = {
    async registerTelegramHouseholdChat() {
      return {
        status: 'existing',
        household
      }
    },
    async getTelegramHouseholdChat() {
      return household
    },
    async getHouseholdChatByHouseholdId() {
      return household
    },
    async bindHouseholdTopic(input) {
      const binding: HouseholdTopicBindingRecord = {
        householdId: input.householdId,
        role: input.role,
        telegramThreadId: input.telegramThreadId,
        topicName: input.topicName?.trim() || null
      }
      return binding
    },
    async getHouseholdTopicBinding() {
      return null
    },
    async findHouseholdTopicByTelegramContext() {
      return null
    },
    async listHouseholdTopicBindings() {
      return []
    },
    async clearHouseholdTopicBindings() {},
    async listReminderTargets() {
      return []
    },
    async upsertHouseholdJoinToken(input) {
      joinToken = {
        householdId: household.householdId,
        householdName: household.householdName,
        token: input.token,
        createdByTelegramUserId: input.createdByTelegramUserId ?? null
      }
      return joinToken
    },
    async getHouseholdJoinToken() {
      return joinToken
    },
    async getHouseholdByJoinToken(token) {
      return joinToken?.token === token ? household : null
    },
    async upsertPendingHouseholdMember(input) {
      const record: HouseholdPendingMemberRecord = {
        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
      }
      pendingMembers.set(input.telegramUserId, record)
      return record
    },
    async getPendingHouseholdMember(_householdId, telegramUserId) {
      return pendingMembers.get(telegramUserId) ?? null
    },
    async findPendingHouseholdMemberByTelegramUserId(telegramUserId) {
      return pendingMembers.get(telegramUserId) ?? null
    },
    async ensureHouseholdMember(input) {
      const member = {
        id: `member-${input.telegramUserId}`,
        householdId: input.householdId,
        telegramUserId: input.telegramUserId,
        displayName: input.displayName,
        status: input.status ?? 'active',
        preferredLocale: input.preferredLocale ?? null,
        householdDefaultLocale: household.defaultLocale,
        rentShareWeight: 1,
        isAdmin: input.isAdmin === true
      }
      members.set(input.telegramUserId, member)
      return member
    },
    async getHouseholdMember(_householdId, telegramUserId) {
      return members.get(telegramUserId) ?? null
    },
    async listHouseholdMembers(householdId) {
      return [...members.values()].filter((member) => member.householdId === householdId)
    },
    async listHouseholdMembersByTelegramUserId(telegramUserId) {
      const member = members.get(telegramUserId)
      return member ? [member] : []
    },
    async listPendingHouseholdMembers() {
      return [...pendingMembers.values()]
    },
    async approvePendingHouseholdMember(input) {
      const pending = pendingMembers.get(input.telegramUserId)
      if (!pending) {
        return null
      }

      pendingMembers.delete(input.telegramUserId)

      return {
        id: `member-${pending.telegramUserId}`,
        householdId: pending.householdId,
        telegramUserId: pending.telegramUserId,
        displayName: pending.displayName,
        status: 'active',
        preferredLocale: null,
        householdDefaultLocale: household.defaultLocale,
        rentShareWeight: 1,
        isAdmin: input.isAdmin === true
      }
    },
    async updateHouseholdDefaultLocale(_householdId, locale) {
      return {
        ...household,
        defaultLocale: locale
      }
    },
    async updateMemberPreferredLocale(_householdId, telegramUserId, locale) {
      const member = members.get(telegramUserId)
      return member
        ? {
            ...member,
            preferredLocale: locale
          }
        : null
    },
    async getHouseholdBillingSettings(householdId) {
      return {
        householdId,
        settlementCurrency: 'GEL',
        rentAmountMinor: null,
        rentCurrency: 'USD',
        rentDueDay: 20,
        rentWarningDay: 17,
        utilitiesDueDay: 4,
        utilitiesReminderDay: 3,
        timezone: 'Asia/Tbilisi'
      }
    },
    async updateHouseholdBillingSettings(input) {
      return {
        householdId: input.householdId,
        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'
      }
    },
    async listHouseholdUtilityCategories() {
      return []
    },
    async upsertHouseholdUtilityCategory(input) {
      return {
        id: input.slug ?? 'utility-category-1',
        householdId: input.householdId,
        slug: input.slug ?? 'custom',
        name: input.name,
        sortOrder: input.sortOrder,
        isActive: input.isActive
      }
    },
    async promoteHouseholdAdmin() {
      return null
    },
    async updateHouseholdMemberRentShareWeight() {
      return null
    },
    async updateHouseholdMemberStatus() {
      return null
    },
    async listHouseholdMemberAbsencePolicies() {
      return []
    },
    async upsertHouseholdMemberAbsencePolicy() {
      return null
    }
  }

  return {
    repository
  }
}

describe('createHouseholdOnboardingService', () => {
  test('creates and reuses a stable join token for a household', async () => {
    const { repository } = createRepositoryStub()
    const service = createHouseholdOnboardingService({
      repository,
      tokenFactory: () => 'join-token'
    })

    const created = await service.ensureHouseholdJoinToken({
      householdId: 'household-1',
      actorTelegramUserId: '1'
    })
    const reused = await service.ensureHouseholdJoinToken({
      householdId: 'household-1'
    })

    expect(created.token).toBe('join-token')
    expect(reused.token).toBe('join-token')
  })

  test('reports join_required for a valid token and non-member', async () => {
    const { repository } = createRepositoryStub()
    const service = createHouseholdOnboardingService({
      repository,
      tokenFactory: () => 'join-token'
    })
    await service.ensureHouseholdJoinToken({
      householdId: 'household-1'
    })

    const access = await service.getMiniAppAccess({
      identity: {
        telegramUserId: '42',
        displayName: 'Stan'
      },
      joinToken: 'join-token'
    })

    expect(access).toEqual({
      status: 'join_required',
      household: {
        id: 'household-1',
        name: 'Kojori House',
        defaultLocale: 'ru'
      }
    })
  })

  test('creates a pending join request', async () => {
    const { repository } = createRepositoryStub()
    const service = createHouseholdOnboardingService({
      repository,
      tokenFactory: () => 'join-token'
    })
    await service.ensureHouseholdJoinToken({
      householdId: 'household-1'
    })

    const result = await service.joinHousehold({
      identity: {
        telegramUserId: '42',
        displayName: 'Stan',
        username: 'stan'
      },
      joinToken: 'join-token'
    })

    expect(result).toEqual({
      status: 'pending',
      household: {
        id: 'household-1',
        name: 'Kojori House',
        defaultLocale: 'ru'
      }
    })

    const access = await service.getMiniAppAccess({
      identity: {
        telegramUserId: '42',
        displayName: 'Stan'
      }
    })

    expect(access).toEqual({
      status: 'pending',
      household: {
        id: 'household-1',
        name: 'Kojori House',
        defaultLocale: 'ru'
      }
    })
  })

  test('returns active when the user is already a household member', async () => {
    const { repository } = createRepositoryStub()
    await repository.ensureHouseholdMember({
      householdId: 'household-1',
      telegramUserId: '42',
      displayName: 'Stan',
      isAdmin: true
    })
    const service = createHouseholdOnboardingService({
      repository
    })

    const access = await service.getMiniAppAccess({
      identity: {
        telegramUserId: '42',
        displayName: 'Stan'
      },
      joinToken: 'anything'
    })

    expect(access).toEqual({
      status: 'active',
      member: {
        id: 'member-42',
        householdId: 'household-1',
        displayName: 'Stan',
        status: 'active',
        preferredLocale: null,
        householdDefaultLocale: 'ru',
        rentShareWeight: 1,
        isAdmin: true
      }
    })
  })

  test('returns open_from_group when user belongs to multiple households and no join token is provided', async () => {
    const { repository } = createRepositoryStub()
    const member: HouseholdMemberRecord = {
      id: 'member-1',
      householdId: 'household-1',
      telegramUserId: '42',
      displayName: 'Stan',
      status: 'active',
      preferredLocale: null,
      householdDefaultLocale: 'ru',
      rentShareWeight: 1,
      isAdmin: true
    }
    const service = createHouseholdOnboardingService({ repository })
    const duplicateRepository = repository as HouseholdConfigurationRepository & {
      listHouseholdMembersByTelegramUserId: (
        telegramUserId: string
      ) => Promise<readonly (HouseholdMemberRecord & { rentShareWeight: number })[]>
    }
    duplicateRepository.listHouseholdMembersByTelegramUserId = async () => [
      member,
      {
        id: 'member-2',
        householdId: 'household-2',
        telegramUserId: '42',
        displayName: 'Stan elsewhere',
        status: 'active',
        preferredLocale: null,
        householdDefaultLocale: 'ru',
        rentShareWeight: 1,
        isAdmin: false
      }
    ]

    const access = await service.getMiniAppAccess({
      identity: {
        telegramUserId: '42',
        displayName: 'Stan'
      }
    })

    expect(access).toEqual({
      status: 'open_from_group'
    })
  })
})