/** * Receipt HTML renderer — invoice-receipt-document (wave-12, spec 179). * * Produces print-ready Hebrew RTL HTML for: * - קבלה (receipt, doc_type='receipt') * - חשבונית מס/קבלה (invoice_receipt, doc_type='invoice_receipt') * * No puppeteer — caller converts to PDF via browser print. * Hebrew amount-in-words via amountInWordsHe(). * * TODO(ird-024): reuse tenant_invoice_pdf_config branding (logo, colors) like invoice render. */ import type { ReceiptObject } from '@zync/types' // ── Amount in words (Hebrew) ────────────────────────────────────────────────── const ONES_HE = [ '', 'אחד', 'שניים', 'שלושה', 'ארבעה', 'חמישה', 'שישה', 'שבעה', 'שמונה', 'תשעה', 'עשרה', 'אחד עשר', 'שנים עשר', 'שלושה עשר', 'ארבעה עשר', 'חמישה עשר', 'שישה עשר', 'שבעה עשר', 'שמונה עשר', 'תשעה עשר', ] const TENS_HE = ['', '', 'עשרים', 'שלושים', 'ארבעים', 'חמישים', 'שישים', 'שבעים', 'שמונים', 'תשעים'] function integerToWordsHe(n: number): string { if (n === 0) return 'אפס' if (n < 0) return `מינוס ${integerToWordsHe(-n)}` if (n < 20) return ONES_HE[n] ?? '' if (n < 100) { const t = Math.floor(n / 10) const o = n % 10 return o === 0 ? (TENS_HE[t] ?? '') : `${TENS_HE[t] ?? ''} ו${ONES_HE[o] ?? ''}` } if (n < 1000) { const h = Math.floor(n / 100) const rest = n % 100 const hWord = h === 1 ? 'מאה' : h === 2 ? 'מאתיים' : `${ONES_HE[h] ?? ''} מאות` return rest === 0 ? hWord : `${hWord} ו${integerToWordsHe(rest)}` } if (n < 1_000_000) { const k = Math.floor(n / 1000) const rest = n % 1000 const kWord = k === 1 ? 'אלף' : k === 2 ? 'אלפיים' : `${integerToWordsHe(k)} אלף` return rest === 0 ? kWord : `${kWord} ו${integerToWordsHe(rest)}` } const m = Math.floor(n / 1_000_000) const rest = n % 1_000_000 const mWord = `${integerToWordsHe(m)} מיליון` return rest === 0 ? mWord : `${mWord} ו${integerToWordsHe(rest)}` } const CURRENCY_NAMES_HE: Record = { ILS: { integer: 'שקל', fraction: 'אגורה' }, USD: { integer: 'דולר', fraction: 'סנט' }, EUR: { integer: 'יורו', fraction: 'סנט' }, GBP: { integer: 'פאונד', fraction: 'פני' }, } export function amountInWordsHe(amount: number, currency: string): string { const names = CURRENCY_NAMES_HE[currency] ?? { integer: currency, fraction: '' } const intPart = Math.floor(amount) const fracPart = Math.round((amount - intPart) * 100) let result = `${integerToWordsHe(intPart)} ${names.integer}` if (fracPart > 0 && names.fraction) { result += ` ו${integerToWordsHe(fracPart)} ${names.fraction}` } return result } // ── HTML escape ─────────────────────────────────────────────────────────────── function esc(s: string | null | undefined): string { if (!s) return '' return s .replace(/&/g, '&') .replace(//g, '>') .replace(/"/g, '"') } // ── Render ──────────────────────────────────────────────────────────────────── const METHOD_LABELS_HE: Record = { cash: 'מזומן', bank_transfer: 'העברה בנקאית', cheque: "צ'ק", credit_card: 'כרטיס אשראי', other: 'אחר', } export interface ReceiptRenderContext { tenantName: string tenantAddress?: string tenantTaxId?: string customerName?: string customerTaxId?: string customerAddress?: string /** Originating tax-invoice number (never a UUID). */ invoiceNumber?: string r2PublicUrl?: string } export function renderReceiptHtml( receipt: ReceiptObject, ctx: ReceiptRenderContext, ): string { const isInvoiceReceipt = receipt.docType === 'invoice_receipt' const docTitleHe = isInvoiceReceipt ? 'חשבונית מס/קבלה' : 'קבלה' const docTitleEn = isInvoiceReceipt ? 'Invoice-Receipt' : 'Receipt' const fontUrl = ctx.r2PublicUrl ? `${ctx.r2PublicUrl}/_static/fonts/heebo-variable.woff2` : null const formatCurrency = (val: string | number | null) => { if (val === null || val === undefined) return '—' const n = typeof val === 'string' ? parseFloat(val) : val return new Intl.NumberFormat('he-IL', { style: 'currency', currency: receipt.currency, }).format(n) } const formatDate = (d: string | null) => { if (!d) return '—' return new Intl.DateTimeFormat('he-IL', { year: 'numeric', month: 'long', day: 'numeric', }).format(new Date(d)) } const amountNum = parseFloat(receipt.amount) const amountWords = amountInWordsHe(amountNum, receipt.currency) const linesHtml = (receipt.lines ?? []).map((line) => { const methodLabel = METHOD_LABELS_HE[line.method] ?? line.method let detail = '' if (line.method === 'cheque' && line.chequeNumber) { detail = ` — מס׳ ${esc(line.chequeNumber)}` if (line.chequeBank) detail += ` בנק ${esc(line.chequeBank)}` if (line.chequeDueDate) detail += ` תאריך פירעון ${esc(line.chequeDueDate)}` } if (line.method === 'credit_card' && line.cardLastFour) { detail = ` — *${esc(line.cardLastFour)}` if (line.cardBrand) detail += ` (${esc(line.cardBrand)})` } if (line.reference) { detail += ` אסמכתא: ${esc(line.reference)}` } return `
${esc(methodLabel)}${detail}
${formatCurrency(line.amount)}
` }).join('') const voidBanner = receipt.status === 'VOIDED' ? `
מבוטל — ${esc(receipt.voidReason)}
` : '' const fontFaceBlock = fontUrl ? `@font-face { font-family: 'Heebo'; src: url('${fontUrl}') format('woff2'); font-weight: 100 900; }` : '' return ` ${docTitleHe} ${esc(receipt.receiptNumber ?? '')} ${voidBanner}
${docTitleHe}
${esc(receipt.receiptNumber ? `מס׳ ${receipt.receiptNumber}` : 'טיוטה')}
${esc(ctx.tenantName)}
${ctx.tenantAddress ? `
${esc(ctx.tenantAddress)}
` : ''} ${ctx.tenantTaxId ? `
ח.פ. ${esc(ctx.tenantTaxId)}
` : ''}
לכבוד
${esc(ctx.customerName ?? '')}
${ctx.customerAddress ? `
${esc(ctx.customerAddress)}
` : ''}
תאריך הנפקה: ${formatDate(receipt.issuedAt)}
${ctx.invoiceNumber ? `
מס׳ חשבונית: ${esc(ctx.invoiceNumber)}
` : ''}
אמצעי תשלום
סכום
${linesHtml || `
—
`}
סה"כ
${formatCurrency(receipt.amount)}
סכום במילים: ${esc(amountWords)}
${docTitleEn} — ${docTitleHe} | ${esc(ctx.tenantName)}
` }