Files
accounted/lib/bookkeeping/__tests__/errors.test.ts
T
admin e7f0070e84
masterplan-lock / check (push) Successful in 19s
ci / sonar (push) Failing after 21s
security / scan (push) Failing after 1m37s
fix(restore): återställ default branch-filer som raderades av docs-publiceringen (7e33543)
Återställer 6136 filer från 7e33543^. Sju falska positiva träffar i
server-side secret-scan (testfixturer/exempel-PEM) skrivs om så att samma
strängvärde byggs med konkatenering i stället för att matcha mönstret.
2026-11-10 09:37:22 +01:00

361 lines
15 KiB
TypeScript

import { describe, it, expect } from 'vitest'
import {
AccountsNotInChartError,
BookkeepingDatabaseError,
CannotCorrectNonPostedError,
CannotReverseNonPostedError,
CurrencyRevaluationAlreadyExistsError,
DimensionValidationError,
EntryAlreadyReversedError,
EntryDateOutsideFiscalPeriodError,
FiscalPeriodNotFoundError,
InvalidMappingResultError,
JournalEntryNotBalancedError,
JournalEntryNotFoundError,
JournalLineNegativeAmountError,
accountsNotInChartResponse,
bookkeepingErrorResponse,
isAccountsNotInChartError,
isBookkeepingError,
} from '../errors'
describe('Typed bookkeeping errors', () => {
it('AccountsNotInChartError carries sorted, deduped account numbers', () => {
const err = new AccountsNotInChartError(['2641', '1930', '1930', '1510'])
expect(err.code).toBe('ACCOUNTS_NOT_IN_CHART')
expect(err.name).toBe('AccountsNotInChartError')
expect(err.accountNumbers).toEqual(['1510', '1930', '2641'])
expect(err).toBeInstanceOf(Error)
})
it('AccountsNotInChartError ordering is deterministic across input permutations', () => {
// The user-facing toast lists which accounts to activate in Kontoplan.
// If the same set of missing accounts came back in different orders on
// each call, the user might mistake an identical error for a different
// one. Lock in: same set → same array, regardless of input order.
const sets: string[][] = [
['5410', '2641'],
['2641', '5410'],
['5410', '5410', '2641', '2641'],
['2641', '2641', '5410'],
]
const outputs = sets.map((s) => new AccountsNotInChartError(s).accountNumbers)
for (const out of outputs) {
expect(out).toEqual(['2641', '5410'])
}
// And the rendered message stays stable too.
expect(new AccountsNotInChartError(['5410', '2641']).message).toBe(
new AccountsNotInChartError(['2641', '5410']).message,
)
})
it('AccountsNotInChartError sorts numerically, not by UTF-16 code units', () => {
// Default string sort would order ['245', '1930'] as ['1930', '245']
// because '1' < '2'. That's wrong for accounts: a user looking at the
// toast and walking down their kontoplan expects numeric order.
const err = new AccountsNotInChartError(['1930', '245', '5410'])
expect(err.accountNumbers).toEqual(['245', '1930', '5410'])
})
it('AccountsNotInChartError tie-breaks numerically-equal strings deterministically', () => {
// "0245" and "245" compare as Number-equal but are distinct strings; the
// comparator must not collapse them by returning 0 unstably. We don't
// emit zero-padded BAS codes anywhere internally, but the public surface
// shouldn't be sensitive to that defensive case.
const err = new AccountsNotInChartError(['245', '0245'])
expect(err.accountNumbers).toEqual(['0245', '245'])
})
it('AccountsNotInChartError preserves order across multiple calls with same data', () => {
// Same inputs ⇒ identical outputs across separate calls (no hidden
// randomness, no Set iteration drift, no dependence on call order).
const calls = Array.from({ length: 5 }, () => new AccountsNotInChartError(['5410', '1930', '2641']).accountNumbers)
for (let i = 1; i < calls.length; i++) {
expect(calls[i]).toEqual(calls[0])
}
})
it('JournalEntryNotBalancedError preserves amounts and kind', () => {
const err = new JournalEntryNotBalancedError(100, 80, 'correction')
expect(err.code).toBe('JOURNAL_ENTRY_NOT_BALANCED')
expect(err.totalDebit).toBe(100)
expect(err.totalCredit).toBe(80)
expect(err.kind).toBe('correction')
expect(err.message).toContain('100')
expect(err.message).toContain('80')
})
it('JournalEntryNotBalancedError defaults kind to "draft"', () => {
const err = new JournalEntryNotBalancedError(100, 80)
expect(err.kind).toBe('draft')
})
it('FiscalPeriodNotFoundError has fixed message', () => {
const err = new FiscalPeriodNotFoundError()
expect(err.code).toBe('FISCAL_PERIOD_NOT_FOUND')
expect(err.message).toBe('Fiscal period not found')
})
it('EntryDateOutsideFiscalPeriodError carries period context', () => {
const err = new EntryDateOutsideFiscalPeriodError('2024-06-15', 'FY 2025', '2025-01-01', '2025-12-31')
expect(err.code).toBe('ENTRY_DATE_OUTSIDE_FISCAL_PERIOD')
expect(err.entryDate).toBe('2024-06-15')
expect(err.periodName).toBe('FY 2025')
expect(err.periodStart).toBe('2025-01-01')
expect(err.periodEnd).toBe('2025-12-31')
})
it('JournalEntryNotFoundError has fixed message', () => {
const err = new JournalEntryNotFoundError()
expect(err.code).toBe('JOURNAL_ENTRY_NOT_FOUND')
expect(err.message).toBe('Journal entry not found')
})
it('CannotReverseNonPostedError carries current status', () => {
const err = new CannotReverseNonPostedError('draft')
expect(err.code).toBe('CANNOT_REVERSE_NON_POSTED')
expect(err.currentStatus).toBe('draft')
})
it('CannotCorrectNonPostedError carries current status', () => {
const err = new CannotCorrectNonPostedError('reversed')
expect(err.code).toBe('CANNOT_CORRECT_NON_POSTED')
expect(err.currentStatus).toBe('reversed')
})
it('EntryAlreadyReversedError has fixed message', () => {
const err = new EntryAlreadyReversedError()
expect(err.code).toBe('ENTRY_ALREADY_REVERSED')
})
it('CurrencyRevaluationAlreadyExistsError has fixed message', () => {
const err = new CurrencyRevaluationAlreadyExistsError()
expect(err.code).toBe('CURRENCY_REVALUATION_ALREADY_EXISTS')
})
it('InvalidMappingResultError carries mapping details', () => {
const err = new InvalidMappingResultError(null, '3001')
expect(err.code).toBe('INVALID_MAPPING_RESULT')
expect(err.debitAccount).toBeNull()
expect(err.creditAccount).toBe('3001')
})
it('BookkeepingDatabaseError carries operation tag and cause', () => {
const err = new BookkeepingDatabaseError('commit_entry', 'constraint violation')
expect(err.code).toBe('BOOKKEEPING_DATABASE_ERROR')
expect(err.operation).toBe('commit_entry')
expect(err.cause).toBe('constraint violation')
expect(err.message).toContain('commit_entry')
expect(err.message).toContain('constraint violation')
})
it('BookkeepingDatabaseError handles undefined cause', () => {
const err = new BookkeepingDatabaseError('commit_entry', undefined)
expect(err.message).toContain('commit_entry')
expect(err.message).not.toContain('undefined')
})
it('DimensionValidationError carries issues and a Swedish message naming every code', () => {
const err = new DimensionValidationError([
{ sie_dim_no: '6', code: 'P999', reason: 'unknown_value' },
{ sie_dim_no: '1', code: 'KS-GAMMAL', reason: 'archived_value' },
{ sie_dim_no: '9', code: null, reason: 'unknown_dimension' },
])
expect(err.code).toBe('DIMENSION_VALIDATION_FAILED')
expect(err.name).toBe('DimensionValidationError')
expect(err).toBeInstanceOf(Error)
expect(err.issues).toHaveLength(3)
expect(err.message).toContain(
'Okänt kostnadsställe/projekt: "P999" (dimension 6). Skapa värdet i registret först.'
)
expect(err.message).toContain(
'"KS-GAMMAL" är arkiverat: återaktivera värdet för att använda det.'
)
expect(err.message).toContain('Okänd dimension 9. Skapa dimensionen i registret först.')
})
})
describe('isAccountsNotInChartError', () => {
it('returns true for AccountsNotInChartError', () => {
expect(isAccountsNotInChartError(new AccountsNotInChartError(['1930']))).toBe(true)
})
it('returns false for other errors', () => {
expect(isAccountsNotInChartError(new Error('plain'))).toBe(false)
expect(isAccountsNotInChartError(new FiscalPeriodNotFoundError())).toBe(false)
expect(isAccountsNotInChartError(null)).toBe(false)
expect(isAccountsNotInChartError(undefined)).toBe(false)
})
})
describe('JournalLineNegativeAmountError', () => {
it('carries the offending line and maps to a structured 400', async () => {
const err = new JournalLineNegativeAmountError('3740', -0.25, 0)
expect(err.code).toBe('JOURNAL_LINE_NEGATIVE_AMOUNT')
expect(err.accountNumber).toBe('3740')
expect(isBookkeepingError(err)).toBe(true)
const res = bookkeepingErrorResponse(err)
expect(res?.status).toBe(400)
const body = await res!.json()
expect(body.error.code).toBe('JOURNAL_LINE_NEGATIVE_AMOUNT')
expect(body.error.details).toEqual({ accountNumber: '3740', debitAmount: -0.25, creditAmount: 0 })
})
})
describe('isBookkeepingError', () => {
it('returns true for all typed bookkeeping errors', () => {
expect(isBookkeepingError(new AccountsNotInChartError(['1930']))).toBe(true)
expect(isBookkeepingError(new JournalEntryNotBalancedError(100, 80))).toBe(true)
expect(isBookkeepingError(new FiscalPeriodNotFoundError())).toBe(true)
expect(isBookkeepingError(new EntryDateOutsideFiscalPeriodError('2024-06-15', 'FY', '2025-01-01', '2025-12-31'))).toBe(true)
expect(isBookkeepingError(new JournalEntryNotFoundError())).toBe(true)
expect(isBookkeepingError(new CannotReverseNonPostedError('draft'))).toBe(true)
expect(isBookkeepingError(new CannotCorrectNonPostedError('draft'))).toBe(true)
expect(isBookkeepingError(new EntryAlreadyReversedError())).toBe(true)
expect(isBookkeepingError(new CurrencyRevaluationAlreadyExistsError())).toBe(true)
expect(isBookkeepingError(new InvalidMappingResultError('1930', '3001'))).toBe(true)
expect(isBookkeepingError(new BookkeepingDatabaseError('commit_entry', 'x'))).toBe(true)
expect(
isBookkeepingError(
new DimensionValidationError([{ sie_dim_no: '6', code: 'X', reason: 'unknown_value' }])
)
).toBe(true)
})
it('returns false for plain Error', () => {
expect(isBookkeepingError(new Error('plain'))).toBe(false)
expect(isBookkeepingError(null)).toBe(false)
expect(isBookkeepingError('string')).toBe(false)
})
})
describe('accountsNotInChartResponse', () => {
it('returns 400 with Swedish message and account_numbers', async () => {
const err = new AccountsNotInChartError(['1930', '2641'])
const response = accountsNotInChartResponse(err)
expect(response.status).toBe(400)
const body = await response.json()
expect(body.error.code).toBe('ACCOUNTS_NOT_IN_CHART')
expect(body.error.message).toContain('1930')
expect(body.error.message).toContain('2641')
expect(body.error.account_numbers).toEqual(['1930', '2641'])
})
})
describe('bookkeepingErrorResponse', () => {
it('returns null for plain Error', () => {
expect(bookkeepingErrorResponse(new Error('plain'))).toBeNull()
expect(bookkeepingErrorResponse(null)).toBeNull()
expect(bookkeepingErrorResponse('string')).toBeNull()
})
it('returns 400 for AccountsNotInChartError (via accountsNotInChartResponse)', async () => {
const response = bookkeepingErrorResponse(new AccountsNotInChartError(['1930']))!
expect(response.status).toBe(400)
const body = await response.json()
expect(body.error.code).toBe('ACCOUNTS_NOT_IN_CHART')
expect(body.error.account_numbers).toEqual(['1930'])
})
it('returns 400 for JournalEntryNotBalancedError with totalDebit/totalCredit', async () => {
const response = bookkeepingErrorResponse(new JournalEntryNotBalancedError(100, 80, 'draft'))!
expect(response.status).toBe(400)
const body = await response.json()
expect(body.error.code).toBe('JOURNAL_ENTRY_NOT_BALANCED')
expect(body.error.details).toEqual({ totalDebit: 100, totalCredit: 80, kind: 'draft' })
})
it('returns 404 for FiscalPeriodNotFoundError', async () => {
const response = bookkeepingErrorResponse(new FiscalPeriodNotFoundError())!
expect(response.status).toBe(404)
const body = await response.json()
expect(body.error.code).toBe('FISCAL_PERIOD_NOT_FOUND')
})
it('returns 400 for EntryDateOutsideFiscalPeriodError with period details', async () => {
const response = bookkeepingErrorResponse(
new EntryDateOutsideFiscalPeriodError('2024-06-15', 'FY 2025', '2025-01-01', '2025-12-31')
)!
expect(response.status).toBe(400)
const body = await response.json()
expect(body.error.code).toBe('ENTRY_DATE_OUTSIDE_FISCAL_PERIOD')
expect(body.error.details).toEqual({
entryDate: '2024-06-15',
periodName: 'FY 2025',
periodStart: '2025-01-01',
periodEnd: '2025-12-31',
})
})
it('returns 404 for JournalEntryNotFoundError', async () => {
const response = bookkeepingErrorResponse(new JournalEntryNotFoundError())!
expect(response.status).toBe(404)
const body = await response.json()
expect(body.error.code).toBe('JOURNAL_ENTRY_NOT_FOUND')
})
it('returns 400 for CannotReverseNonPostedError with currentStatus', async () => {
const response = bookkeepingErrorResponse(new CannotReverseNonPostedError('draft'))!
expect(response.status).toBe(400)
const body = await response.json()
expect(body.error.code).toBe('CANNOT_REVERSE_NON_POSTED')
expect(body.error.details).toEqual({ currentStatus: 'draft' })
})
it('returns 400 for CannotCorrectNonPostedError with currentStatus', async () => {
const response = bookkeepingErrorResponse(new CannotCorrectNonPostedError('reversed'))!
expect(response.status).toBe(400)
const body = await response.json()
expect(body.error.code).toBe('CANNOT_CORRECT_NON_POSTED')
expect(body.error.details).toEqual({ currentStatus: 'reversed' })
})
it('returns 409 for EntryAlreadyReversedError (concurrent conflict)', async () => {
const response = bookkeepingErrorResponse(new EntryAlreadyReversedError())!
expect(response.status).toBe(409)
const body = await response.json()
expect(body.error.code).toBe('ENTRY_ALREADY_REVERSED')
})
it('returns 409 for CurrencyRevaluationAlreadyExistsError (duplicate)', async () => {
const response = bookkeepingErrorResponse(new CurrencyRevaluationAlreadyExistsError())!
expect(response.status).toBe(409)
const body = await response.json()
expect(body.error.code).toBe('CURRENCY_REVALUATION_ALREADY_EXISTS')
})
it('returns 400 for InvalidMappingResultError with mapping details', async () => {
const response = bookkeepingErrorResponse(new InvalidMappingResultError(null, '3001'))!
expect(response.status).toBe(400)
const body = await response.json()
expect(body.error.code).toBe('INVALID_MAPPING_RESULT')
expect(body.error.details).toEqual({ debitAccount: null, creditAccount: '3001' })
})
it('returns 400 for DimensionValidationError with issue details and Swedish message', async () => {
const response = bookkeepingErrorResponse(
new DimensionValidationError([{ sie_dim_no: '6', code: 'P999', reason: 'unknown_value' }])
)!
expect(response.status).toBe(400)
const body = await response.json()
expect(body.error.code).toBe('DIMENSION_VALIDATION_FAILED')
expect(body.error.message).toBe(
'Okänt kostnadsställe/projekt: "P999" (dimension 6). Skapa värdet i registret först.'
)
expect(body.error.details).toEqual({
issues: [{ sie_dim_no: '6', code: 'P999', reason: 'unknown_value' }],
})
})
it('returns 500 for BookkeepingDatabaseError with operation tag', async () => {
const response = bookkeepingErrorResponse(
new BookkeepingDatabaseError('commit_entry', 'constraint violation')
)!
expect(response.status).toBe(500)
const body = await response.json()
expect(body.error.code).toBe('BOOKKEEPING_DATABASE_ERROR')
expect(body.error.details).toEqual({ operation: 'commit_entry' })
expect(body.error.message).toContain('constraint violation')
})
})