accounted/app/api/transactions/[id]/book/route.ts

import { createClient } from '@/lib/supabase/server'
import { NextResponse } from 'next/server'
import { eventBus } from '@/lib/events'
import { ensureInitialized } from '@/lib/init'
import { createJournalEntry } from '@/lib/bookkeeping/engine'
import { bookkeepingErrorResponse } from '@/lib/bookkeeping/errors'
import { validateBody } from '@/lib/api/validate'
import { BookTransactionSchema } from '@/lib/api/schemas'
import { requireCompanyId } from '@/lib/company/context'
import { requireWritePermission } from '@/lib/auth/require-write'
import { detectBookingDuplicate } from '@/lib/transactions/booking-duplicate-detection'
import { errorResponseFromCode } from '@/lib/errors/get-structured-error'
import { createLogger } from '@/lib/logger'
import { appendProcessingHistory } from '@/lib/processing-history/append'
import type { Transaction } from '@/types'

ensureInitialized()

export async function POST(
  request: Request,
  { params }: { params: Promise<{ id: string }> }
) {
  const supabase = await createClient()
  const { id } = await params

  const { data: { user } } = await supabase.auth.getUser()

  if (!user) {
    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
  }

  const writeCheck = await requireWritePermission(supabase, user.id)
  if (!writeCheck.ok) return writeCheck.response

  const companyId = await requireCompanyId(supabase, user.id)

  const validation = await validateBody(request, BookTransactionSchema)
  if (!validation.success) return validation.response
  const { fiscal_period_id, entry_date, description, lines, force, expected_duplicate_transaction_id, expected_duplicate_journal_entry_id } = validation.data

  // Fetch transaction (validates ownership)
  const { data: transaction, error: fetchError } = await supabase
    .from('transactions')
    .select('*')
    .eq('id', id)
    .eq('company_id', companyId)
    .single()

  if (fetchError || !transaction) {
    return NextResponse.json({ error: 'Transaction not found' }, { status: 404 })
  }

  // Reject if already booked
  if (transaction.journal_entry_id) {
    return NextResponse.json(
      { error: 'Transaction already has a journal entry' },
      { status: 409 }
    )
  }

  // Booking-time duplicate guard: if another transaction with the same
  // date+amount+account is already booked, booking this one would double-count
  // one real event (two verifikationer: felaktig bokföring per BFL). Warn; the
  // user confirms with force=true bound to the reviewed sibling. Mirrors the
  // match-invoice soft-duplicate guard.
  const dupLog = createLogger('transactions.book', { companyId, userId: user.id })
  try {
    const candidate = await detectBookingDuplicate(supabase, companyId, {
      id,
      date: transaction.date,
      amount: transaction.amount,
      cash_account_id: transaction.cash_account_id ?? null,
    })
    if (!force) {
      if (candidate) {
        return errorResponseFromCode('TRANSACTION_BOOK_POSSIBLE_DUPLICATE', dupLog, {
          details: { candidate },
        })
      }
    } else if (
      // force=true is bound to the reviewed candidate. A sibling-transaction
      // candidate carries a transaction_id; a ledger-only voucher candidate does
      // not, so both are bound by journal_entry_id. Either echoed id confirms.
      // Re-detect and refuse the bypass unless it still matches, so a guessed id
      // can't wave the guard.
      !candidate ||
      !(
        (candidate.journal_entry_id && candidate.journal_entry_id === expected_duplicate_journal_entry_id) ||
        (candidate.transaction_id && candidate.transaction_id === expected_duplicate_transaction_id)
      )
    ) {
      return errorResponseFromCode('TRANSACTION_BOOK_FORCE_CANDIDATE_MISMATCH', dupLog, {
        details: {
          expected_duplicate_transaction_id: expected_duplicate_transaction_id ?? null,
          expected_duplicate_journal_entry_id: expected_duplicate_journal_entry_id ?? null,
          detected_transaction_id: candidate?.transaction_id ?? null,
          detected_journal_entry_id: candidate?.journal_entry_id ?? null,
        },
      })
    } else {
      dupLog.warn('booking-time duplicate guard bypassed', {
        reason: 'force=true',
        transactionId: id,
        dismissedTransactionId: candidate.transaction_id,
      })
      // Persist the dismissal to behandlingshistorik (BFNAR 2013:2 kap 8): the
      // decision to book over a DETECTED possible double-booking is a
      // bookkeeping act that must leave a durable, queryable record; a warn in
      // the application log is ephemeral and does not satisfy the requirement.
      // Best-effort: a logging failure must never block a legitimate booking.
      try {
        await appendProcessingHistory({
          companyId,
          correlationId: id,
          aggregateType: 'BankTransaction',
          aggregateId: id,
          eventType: 'BankTransactionDuplicateDismissed',
          payload: {
            transaction_id: id,
            dismissed_transaction_id: candidate.transaction_id,
            dismissed_journal_entry_id: candidate.journal_entry_id,
            amount_ore: Math.round(candidate.amount * 100),
            entry_date: candidate.entry_date,
          },
          actor: { type: 'user', id: user.id },
          occurredAt: new Date(),
        })
      } catch (logErr) {
        dupLog.error('failed to append duplicate-dismissal behandlingshistorik', logErr as Error)
      }
    }
  } catch (err) {
    // Detection is fail-open for the non-force path; force requires a confirmed
    // candidate, so a detection failure under force is rejected as a mismatch.
    if (force) {
      return errorResponseFromCode('TRANSACTION_BOOK_FORCE_CANDIDATE_MISMATCH', dupLog, {
        details: { detection_failed: true },
      })
    }
    dupLog.warn('booking-time duplicate detection failed (continuing)', err as Error)
  }

  // Create journal entry via the engine
  let journalEntry
  try {
    journalEntry = await createJournalEntry(supabase, companyId, user.id, {
      fiscal_period_id,
      entry_date,
      description,
      source_type: 'bank_transaction',
      source_id: id,
      lines,
    })
  } catch (err) {
    const typed = bookkeepingErrorResponse(err)
    if (typed) return typed
    return NextResponse.json(
      { error: err instanceof Error ? err.message : 'Failed to create journal entry' },
      { status: 400 }
    )
  }

  // Link transaction to the journal entry
  const { error: updateError } = await supabase
    .from('transactions')
    .update({
      journal_entry_id: journalEntry.id,
      is_business: true,
      category: 'uncategorized',
    })
    .eq('id', id)

  if (updateError) {
    return NextResponse.json(
      { error: 'Failed to update transaction' },
      { status: 500 }
    )
  }

  // Emit event (non-blocking)
  try {
    await eventBus.emit({
      type: 'transaction.categorized',
      payload: {
        transaction: transaction as Transaction,
        account: lines[0]?.account_number || '',
        taxCode: '',
        userId: user.id,
        companyId,
      },
    })
  } catch {
    // Non-critical
  }

  return NextResponse.json({
    data: journalEntry,
    journal_entry_id: journalEntry.id,
    success: true,
  })
}