accounted/tests/pg/get_account_gl_lines_for_matching.pg.test.ts

/**
 * pg-real test for get_account_gl_lines_for_matching
 * (20260610120000_gl_lines_for_matching.sql, link-count semantics reworked in
 * 20260723160000_gl_lines_matching_account_scoped_count.sql).
 *
 * This RPC backs the N:1 "lägga på flera" feature: it mirrors get_unlinked_gl_lines
 * but can ALSO surface already-matched vouchers (so a second/third bank
 * transaction can be attached to one verifikat), each carrying how many
 * transactions already point at it.
 *
 * Since 20260723090000 the link count is scoped to the requested settlement
 * account: a transaction provably on ANOTHER cash account does not mark the
 * voucher as matched for p_account_number. This surfaces the unsettled second
 * leg of an own-account transfer by default (issue #1026) while transactions
 * with no resolvable cash account keep counting for every account.
 * (The companion mark_entry_as_opening_balance guard from the same migration
 * is covered in mark-entry-as-opening-balance.pg.test.ts.)
 */
import { describe, it, expect } from 'vitest'
import { randomUUID } from 'node:crypto'
import { getPool } from './setup'
import {
  insertAuthUser,
  insertCashAccount,
  insertCompany,
  insertFiscalPeriod,
  insertTransaction,
} from './fixtures'

async function insertPostedJournalEntry(params: {
  userId: string
  companyId: string
  fiscalPeriodId: string
  entryDate: string
  sourceType: 'opening_balance' | 'manual' | 'bank_transaction' | 'import' | 'storno' | 'correction'
  voucherNumber: number
  amount?: number
  /** Line rows to book; defaults to the classic 1930 debit / 2091 credit pair. */
  lines?: Array<{ account: string; debit: number; credit: number }>
}): Promise<string> {
  const id = randomUUID()
  const amount = params.amount ?? 1000
  await getPool().query(
    `INSERT INTO public.journal_entries
       (id, user_id, company_id, fiscal_period_id, voucher_number, voucher_series,
        entry_date, description, source_type, status)
     VALUES ($1, $2, $3, $4, $5, 'A', $6, $7, $8, 'posted')`,
    [
      id,
      params.userId,
      params.companyId,
      params.fiscalPeriodId,
      params.voucherNumber,
      params.entryDate,
      `Test ${params.sourceType}`,
      params.sourceType,
    ],
  )
  const lines = params.lines ?? [
    { account: '1930', debit: amount, credit: 0 },
    { account: '2091', debit: 0, credit: amount },
  ]
  for (const line of lines) {
    await getPool().query(
      `INSERT INTO public.journal_entry_lines
         (journal_entry_id, account_number, debit_amount, credit_amount)
       VALUES ($1, $2, $3, $4)`,
      [id, line.account, line.debit, line.credit],
    )
  }
  return id
}

describe('get_account_gl_lines_for_matching RPC: N:1 candidates', () => {
  it('returns already-matched vouchers (with link count) only when p_include_matched is true', async () => {
    const userId = await insertAuthUser()
    const companyId = await insertCompany({ createdBy: userId })
    const fiscalPeriodId = await insertFiscalPeriod({
      userId, companyId, periodStart: '2026-01-01', periodEnd: '2026-12-31',
    })

    // One unmatched voucher, one voucher already settled by TWO transactions
    // (the salary-run-paid-in-two-transfers shape).
    const unmatchedEntry = await insertPostedJournalEntry({
      userId, companyId, fiscalPeriodId,
      entryDate: '2026-03-15', sourceType: 'bank_transaction', voucherNumber: 1, amount: 1500,
    })
    const matchedEntry = await insertPostedJournalEntry({
      userId, companyId, fiscalPeriodId,
      entryDate: '2026-03-20', sourceType: 'manual', voucherNumber: 2, amount: 30000,
    })
    await insertTransaction({ companyId, userId, currency: 'SEK', journalEntryId: matchedEntry })
    await insertTransaction({ companyId, userId, currency: 'SEK', journalEntryId: matchedEntry })

    // Default (p_include_matched=false): parity with get_unlinked_gl_lines: only
    // the unmatched voucher, count 0.
    const { rows: unmatchedOnly } = await getPool().query(
      `SELECT journal_entry_id, linked_transaction_count
         FROM public.get_account_gl_lines_for_matching(p_company_id => $1)`,
      [companyId],
    )
    const unmatchedIds = new Set(unmatchedOnly.map((r) => r.journal_entry_id))
    expect(unmatchedIds.has(unmatchedEntry)).toBe(true)
    expect(unmatchedIds.has(matchedEntry)).toBe(false)
    expect(unmatchedOnly.find((r) => r.journal_entry_id === unmatchedEntry).linked_transaction_count).toBe(0)

    // p_include_matched=true: the matched voucher appears too, reporting both links.
    const { rows: withMatched } = await getPool().query(
      `SELECT journal_entry_id, linked_transaction_count
         FROM public.get_account_gl_lines_for_matching(p_company_id => $1, p_include_matched => true)`,
      [companyId],
    )
    const byId = new Map(withMatched.map((r) => [r.journal_entry_id, r.linked_transaction_count]))
    expect(byId.get(unmatchedEntry)).toBe(0)
    expect(byId.get(matchedEntry)).toBe(2)
  })

  it('still excludes opening_balance / storno / correction even with p_include_matched', async () => {
    const userId = await insertAuthUser()
    const companyId = await insertCompany({ createdBy: userId })
    const fiscalPeriodId = await insertFiscalPeriod({
      userId, companyId, periodStart: '2026-01-01', periodEnd: '2026-12-31',
    })

    // These book-only / IB vouchers have no bank-feed counterpart and can never
    // be a match target: the include_matched opt-in must not resurrect them.
    await insertPostedJournalEntry({
      userId, companyId, fiscalPeriodId,
      entryDate: '2026-01-01', sourceType: 'opening_balance', voucherNumber: 1, amount: 50000,
    })
    await insertPostedJournalEntry({
      userId, companyId, fiscalPeriodId,
      entryDate: '2026-05-02', sourceType: 'storno', voucherNumber: 2, amount: 25000,
    })
    await insertPostedJournalEntry({
      userId, companyId, fiscalPeriodId,
      entryDate: '2026-05-02', sourceType: 'correction', voucherNumber: 3, amount: 25000,
    })
    const bankEntry = await insertPostedJournalEntry({
      userId, companyId, fiscalPeriodId,
      entryDate: '2026-05-03', sourceType: 'bank_transaction', voucherNumber: 4, amount: 1500,
    })

    const { rows } = await getPool().query(
      `SELECT journal_entry_id, source_type
         FROM public.get_account_gl_lines_for_matching(p_company_id => $1, p_include_matched => true)`,
      [companyId],
    )

    const returnedIds = new Set(rows.map((r) => r.journal_entry_id))
    expect(returnedIds.has(bankEntry)).toBe(true)
    expect(rows.find((r) => r.source_type === 'opening_balance')).toBeUndefined()
    expect(rows.find((r) => r.source_type === 'storno')).toBeUndefined()
    expect(rows.find((r) => r.source_type === 'correction')).toBeUndefined()
  })
})

describe('get_account_gl_lines_for_matching RPC: account-scoped link count (#1026)', () => {
  it('surfaces the unsettled leg of an own-account transfer by default', async () => {
    const userId = await insertAuthUser()
    const companyId = await insertCompany({ createdBy: userId })
    const fiscalPeriodId = await insertFiscalPeriod({
      userId, companyId, periodStart: '2026-01-01', periodEnd: '2026-12-31',
    })
    await insertCashAccount({ companyId, ledgerAccount: '1930' })
    const acc1940 = await insertCashAccount({ companyId, ledgerAccount: '1940' })

    // Own-account transfer: one voucher, debit 1930 / credit 1940. The outgoing
    // leg (a transaction on the 1940 account) is already matched to it.
    const transferEntry = await insertPostedJournalEntry({
      userId, companyId, fiscalPeriodId,
      entryDate: '2026-06-26', sourceType: 'manual', voucherNumber: 1,
      lines: [
        { account: '1930', debit: 2344.16, credit: 0 },
        { account: '1940', debit: 0, credit: 2344.16 },
      ],
    })
    await insertTransaction({
      companyId, userId, amount: -2344.16, date: '2026-06-26',
      journalEntryId: transferEntry, cashAccountId: acc1940,
    })

    // From 1930's perspective the voucher is unmatched: it must appear in the
    // DEFAULT list (no toggle) with a zero link count, so ranking/auto-select
    // treat it as a normal candidate.
    const { rows: on1930 } = await getPool().query(
      `SELECT journal_entry_id, linked_transaction_count
         FROM public.get_account_gl_lines_for_matching(p_company_id => $1, p_account_number => '1930')`,
      [companyId],
    )
    const row1930 = on1930.find((r) => r.journal_entry_id === transferEntry)
    expect(row1930).toBeDefined()
    expect(row1930.linked_transaction_count).toBe(0)

    // From 1940's perspective it IS settled: hidden by default, visible with
    // the opt-in and carrying the link.
    const { rows: on1940Default } = await getPool().query(
      `SELECT journal_entry_id
         FROM public.get_account_gl_lines_for_matching(p_company_id => $1, p_account_number => '1940')`,
      [companyId],
    )
    expect(on1940Default.find((r) => r.journal_entry_id === transferEntry)).toBeUndefined()

    const { rows: on1940Matched } = await getPool().query(
      `SELECT journal_entry_id, linked_transaction_count
         FROM public.get_account_gl_lines_for_matching(
           p_company_id => $1, p_account_number => '1940', p_include_matched => true)`,
      [companyId],
    )
    expect(on1940Matched.find((r) => r.journal_entry_id === transferEntry).linked_transaction_count).toBe(1)
  })

  it('keeps same-account N:1 vouchers behind the include_matched opt-in', async () => {
    const userId = await insertAuthUser()
    const companyId = await insertCompany({ createdBy: userId })
    const fiscalPeriodId = await insertFiscalPeriod({
      userId, companyId, periodStart: '2026-01-01', periodEnd: '2026-12-31',
    })
    const acc1930 = await insertCashAccount({ companyId, ledgerAccount: '1930' })

    // A salary-run shape: one voucher on 1930, partially settled by a first
    // transfer FROM THE SAME account. The second instalment must still require
    // the deliberate opt-in; account scoping must not open the N:1 floodgate.
    const salaryEntry = await insertPostedJournalEntry({
      userId, companyId, fiscalPeriodId,
      entryDate: '2026-06-25', sourceType: 'manual', voucherNumber: 1, amount: 30000,
    })
    await insertTransaction({
      companyId, userId, amount: -10000, date: '2026-06-25',
      journalEntryId: salaryEntry, cashAccountId: acc1930,
    })

    const { rows: byDefault } = await getPool().query(
      `SELECT journal_entry_id
         FROM public.get_account_gl_lines_for_matching(p_company_id => $1, p_account_number => '1930')`,
      [companyId],
    )
    expect(byDefault.find((r) => r.journal_entry_id === salaryEntry)).toBeUndefined()

    const { rows: withMatched } = await getPool().query(
      `SELECT journal_entry_id, linked_transaction_count
         FROM public.get_account_gl_lines_for_matching(
           p_company_id => $1, p_account_number => '1930', p_include_matched => true)`,
      [companyId],
    )
    expect(withMatched.find((r) => r.journal_entry_id === salaryEntry).linked_transaction_count).toBe(1)
  })

  it('treats transactions without a resolvable cash account as settling every account', async () => {
    const userId = await insertAuthUser()
    const companyId = await insertCompany({ createdBy: userId })
    const fiscalPeriodId = await insertFiscalPeriod({
      userId, companyId, periodStart: '2026-01-01', periodEnd: '2026-12-31',
    })

    // Legacy shape: the linked transaction carries no cash_account_id, so it
    // could belong to any account. The voucher must stay hidden by default
    // (conservative: pre-account-scoping behavior).
    const legacyEntry = await insertPostedJournalEntry({
      userId, companyId, fiscalPeriodId,
      entryDate: '2026-06-20', sourceType: 'bank_transaction', voucherNumber: 1, amount: 500,
    })
    await insertTransaction({
      companyId, userId, amount: 500, date: '2026-06-20',
      journalEntryId: legacyEntry, cashAccountId: null,
    })

    const { rows: byDefault } = await getPool().query(
      `SELECT journal_entry_id
         FROM public.get_account_gl_lines_for_matching(p_company_id => $1, p_account_number => '1930')`,
      [companyId],
    )
    expect(byDefault.find((r) => r.journal_entry_id === legacyEntry)).toBeUndefined()

    const { rows: withMatched } = await getPool().query(
      `SELECT journal_entry_id, linked_transaction_count
         FROM public.get_account_gl_lines_for_matching(
           p_company_id => $1, p_account_number => '1930', p_include_matched => true)`,
      [companyId],
    )
    expect(withMatched.find((r) => r.journal_entry_id === legacyEntry).linked_transaction_count).toBe(1)
  })
})