import { normalizeCounterpartyName } from '@/lib/bookkeeping/counterparty-templates' /** * Legibility key for a voucher description: the identity string an observed * party is grouped and displayed by. * * Built on top of normalizeCounterpartyName() (mirrored in SQL by * normalize_counterparty_key) and adds the stages the AP registers of Fortnox, * Visma and BL make necessary: "Levfakt BEIJER BYGGMATERIAL AB (2089)" and * "Levfakt Beijer Byggmaterial AB, 097" must land on one key, * "Leverantörsfaktura från 18 Loopia" on "loopia". * * Mirrored in SQL by public.ledger_key() (migration 20260902170000) and pinned * by tests/pg/observed-parties-rpc.pg.test.ts. Change both or neither. * * "inköp" is deliberately not a stripped prefix: it turns the generic * "inköp av varor" into a vendor-looking "varor" (measured 2026-07-27). */ const AP_PREFIX = /^(levfakt|levfkt|leverantörsfaktura från|leverantörsfaktura|levbet|faktura|kvitto|utgift)\s+/ const LEADING_SUPPLIER_NUMBER = /^\d{1,5}\s+/ const TRAILING_SHORT_DIGITS = /(\s+\d{1,3})+$/ export function ledgerKey(raw: string | null | undefined): string { const k = normalizeCounterpartyName(raw ?? '') if (!k) return '' const stripped = k .replace(AP_PREFIX, '') .replace(LEADING_SUPPLIER_NUMBER, '') .replace(TRAILING_SHORT_DIGITS, '') .replace(/\s+/g, ' ') .trim() return stripped === '' ? k : stripped } const CORE_AP_PREFIX = /^(levfakt|levfkt|lev\.?fakt\.?|leverantörsfaktura från|leverantörsfaktura|levbet\.?|kvitto|faktura|utgift|inköp)\s+/ const CORE_LEGAL_FORM = /\b(ab|aktiebolag|hb|kb|sverige|sweden|ltd|limited|oy|gmbh|inc|sarl|publ|filial)\b/g /** * The "core" of a key: what is left when AP prefixes, digit runs and legal * form suffixes are gone. Two keys with one core are the same trade name, * which is NOT the same party (Fortnox AB and Fortnox Finans AB share one), * so the core only ever ranks or annotates candidates; it never merges. * Measured on the document-anchored gold set 2026-09-02: pair precision * 0.909, recall 0.776 (scripts/parties/README.md). */ export function coreKey(key: string): string { return key .toLowerCase() .replace(CORE_AP_PREFIX, '') .replace(/\b\d+\b/g, '') .replace(CORE_LEGAL_FORM, '') .replace(/[^a-zåäöé ]+/g, ' ') .split(/\s+/) .filter(Boolean) .join(' ') }