Files
accounted/lib/invoices/pdf-filename.ts
T
Mattsson 321e684523 Fix/usr fdbck ch (#1105)
* fix(privacy): mask voucher amounts in session replays

* fix: persist transaction source filter

* fix: clarify invoice filenames and booking previews

* fix: truncate long uploaded filenames

* feat: add invoice delivery history

* fix: harden invoice delivery history

* fix: include invoice deliveries in full archive
2026-07-22 18:49:57 +02:00

86 lines
2.9 KiB
TypeScript

import type { InvoiceDocumentType } from '@/types'
const MAX_NAME_PART_LENGTH = 60
const MAX_NUMBER_PART_LENGTH = 40
const MAX_FILENAME_BYTES = 255
interface InvoicePdfFilenameInput {
companyName?: string | null
customerName?: string | null
invoiceNumber?: string | null
invoiceId?: string | null
invoiceDate?: string | null
documentType?: InvoiceDocumentType | null
isCreditNote?: boolean
}
function safeFilenamePart(value: string | null | undefined, fallback: string, maxLength: number): string {
const normalized = (value ?? '')
.toWellFormed()
.normalize('NFC')
.replace(/[\u0000-\u001f\u007f<>:"/\\|?*]+/g, ' ')
.replace(/\s+/g, ' ')
.replace(/[ .]+$/g, '')
.trim()
if (!normalized) return fallback
return Array.from(normalized).slice(0, maxLength).join('').replace(/[ .]+$/g, '') || fallback
}
function documentLabel(documentType: InvoiceDocumentType, isCreditNote: boolean): string {
if (isCreditNote) return 'Kreditfaktura'
if (documentType === 'proforma') return 'Proformafaktura'
if (documentType === 'delivery_note') return 'Följesedel'
return 'Faktura'
}
function utf8ByteLength(value: string): number {
return new TextEncoder().encode(value).length
}
function fitFilename(companyName: string, customerName: string, suffix: string): string {
const company = Array.from(companyName)
const customer = Array.from(customerName)
const build = () => `${company.join('')} x ${customer.join('')} ${suffix}`
while (utf8ByteLength(build()) > MAX_FILENAME_BYTES && (company.length > 1 || customer.length > 1)) {
if (utf8ByteLength(company.join('')) >= utf8ByteLength(customer.join('')) && company.length > 1) {
company.pop()
} else if (customer.length > 1) {
customer.pop()
} else {
company.pop()
}
}
return build()
}
/**
* Build a descriptive, cross-platform-safe PDF filename for an invoice document.
*
* Example: `Oppy x Kund AB Faktura nr 2621 20260721.pdf`.
*/
export function invoicePdfFilename({
companyName,
customerName,
invoiceNumber,
invoiceId,
invoiceDate,
documentType = 'invoice',
isCreditNote = false,
}: InvoicePdfFilenameInput): string {
const company = safeFilenamePart(companyName, 'Företag', MAX_NAME_PART_LENGTH)
const customer = safeFilenamePart(customerName, 'Kund', MAX_NAME_PART_LENGTH)
const label = documentLabel(documentType ?? 'invoice', isCreditNote)
// The cross-platform filename is descriptive only. The invoice body retains
// the authoritative number and credit-note reference, including separators.
const number = invoiceNumber
? `nr ${safeFilenamePart(invoiceNumber, 'okänd', MAX_NUMBER_PART_LENGTH)}`
: `utkast-${safeFilenamePart(invoiceId?.slice(0, 8), 'utan-nummer', MAX_NUMBER_PART_LENGTH)}`
const compactDate = (invoiceDate ?? '').replace(/[^0-9]/g, '').slice(0, 8)
const suffix = [label, number, compactDate].filter(Boolean).join(' ') + '.pdf'
return fitFilename(company, customer, suffix)
}