@dainamite/billing 0.21.0 → 0.22.0

package/src/modules/billing/i18n/pl.json

@@ -68,7 +68,7 @@
   "billing.accounts.form.customer_kind": "Typ klienta",
   "billing.accounts.form.cycle_anchor": "Zakotwiczenie cyklu",
   "billing.accounts.form.cycle_anchor.month_hint": "1 — 28",
-  "billing.accounts.form.cycle_anchor.weekly_hint": "pon | wt | … | nd",
+  "billing.accounts.form.cycle_anchor.weekly_hint": "mon | tue | … | sun",
   "billing.accounts.form.error.address_required": "Adres na fakturze (linia 1 + miasto) jest wymagany",
   "billing.accounts.form.error.country_invalid": "Kraj musi być 2- lub 3-literowym kodem ISO 3166",
   "billing.accounts.form.error.currency_invalid": "Waluta musi być 3-literowym kodem ISO",

package/src/modules/billing/lib/invoiceDelivery.ts

@@ -4,7 +4,7 @@ import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
 import type { SendEmailOptions } from '@open-mercato/shared/lib/email/send'
 import { BillingAccount, BillingInvoice } from '../data/entities'
 import { emitBillingEvent } from '../events'
-import { DEFAULT_INVOICE_LANGUAGE } from './invoiceLanguages'
+import { resolveInvoiceLanguage } from './invoiceLanguages'
 import { formatIban } from './iban'
 import { documentLocale, formatDocumentDate, formatDocumentMoney, type DocumentTranslate } from './pdf/invoiceModel'
 import { getInvoicePdf, loadDocumentTranslator, type TranslatorLoader } from './pdf/invoicePdf'
@@ -148,10 +148,9 @@ export async function sendInvoice(
     })
   }
 
-  const language =
-    (typeof buyer.invoice_language === 'string' && buyer.invoice_language) ||
-    account?.invoiceLanguage ||
-    DEFAULT_INVOICE_LANGUAGE
+  const language = resolveInvoiceLanguage(
+    (typeof buyer.invoice_language === 'string' && buyer.invoice_language) || account?.invoiceLanguage,
+  )
   const translate = await (deps.loadTranslator ?? loadDocumentTranslator)(language)
   const seller = (invoice.sellerSnapshot ?? {}) as Record<string, unknown>
   const email = buildInvoiceEmail({

package/src/modules/billing/lib/invoiceLanguages.ts

@@ -1,24 +1,35 @@
+import type { Locale } from '@open-mercato/shared/lib/i18n/config'
+
 /**
  * Invoice languages the built-in billing document template can render.
  *
- * Single source of truth for the account form's language picklist and the
- * `invoiceLanguage` validator. Adding a language means adding the template
- * labels for it AND one entry here — never one without the other.
+ * Single source of truth for the account form's language picklist, the
+ * `invoiceLanguage` validator, the `Intl` locale used for money / dates on
+ * documents and emails, and the dictionary the document translator loads.
+ * Adding a language means adding `i18n/<code>.json` AND one entry here — the
+ * dictionary-parity test fails if either is missing.
+ *
+ * Every `code` must be a UI locale the framework ships (`Locale`), because the
+ * document translator loads the regular module dictionary for it. The
+ * `satisfies` clause below turns a code the framework does not ship into a
+ * compile error.
  *
  * `label` is the language's own name (endonym), so it reads correctly no
  * matter which UI locale the operator uses — it is intentionally not routed
- * through i18n.
+ * through i18n. Order: default first, then product priority.
  *
- * Spec: .ai/specs/2026-11-14-billing-account-workspace.md (D22). Narrowing the
- * list per organization (`BillingSettings.enabled_invoice_languages`) arrives
- * with the standalone-ledger spec; until then every supported language is
- * selectable.
+ * Specs: .ai/specs/2026-11-14-billing-account-workspace.md (D22),
+ * .ai/specs/2026-11-15-billing-multi-language.md. Narrowing the list per
+ * organization (`BillingSettings.enabled_invoice_languages`) arrives with the
+ * standalone-ledger spec; until then every supported language is selectable.
  */
 
 export const SUPPORTED_INVOICE_LANGUAGES = [
-  { code: 'en', label: 'English' },
-  { code: 'pl', label: 'Polski' },
-] as const
+  { code: 'en', label: 'English', intlLocale: 'en-GB' },
+  { code: 'es', label: 'Español', intlLocale: 'es-ES' },
+  { code: 'de', label: 'Deutsch', intlLocale: 'de-DE' },
+  { code: 'pl', label: 'Polski', intlLocale: 'pl-PL' },
+] as const satisfies ReadonlyArray<{ code: Locale; label: string; intlLocale: string }>
 
 export type InvoiceLanguageCode = (typeof SUPPORTED_INVOICE_LANGUAGES)[number]['code']
 
@@ -32,3 +43,15 @@ export const DEFAULT_INVOICE_LANGUAGE: InvoiceLanguageCode = 'en'
 export function isSupportedInvoiceLanguage(value: string): value is InvoiceLanguageCode {
   return (INVOICE_LANGUAGE_CODES as readonly string[]).includes(value)
 }
+
+/** Normalizes a stored / requested language to a supported code (`' PL '` → `pl`), else the default. */
+export function resolveInvoiceLanguage(value: string | null | undefined): InvoiceLanguageCode {
+  const normalized = typeof value === 'string' ? value.trim().toLowerCase() : ''
+  return isSupportedInvoiceLanguage(normalized) ? normalized : DEFAULT_INVOICE_LANGUAGE
+}
+
+/** The `Intl` locale documents in this language format money and dates with. */
+export function invoiceIntlLocale(language: string | null | undefined): string {
+  const code = resolveInvoiceLanguage(language)
+  return SUPPORTED_INVOICE_LANGUAGES.find((l) => l.code === code)?.intlLocale ?? 'en-GB'
+}

package/src/modules/billing/lib/pdf/invoiceModel.ts

@@ -12,7 +12,9 @@
  * "corrects" row is added to the header.
  */
 
-export type DocumentTranslate = (key: string, fallback: string) => string
+import { invoiceIntlLocale } from '../invoiceLanguages'
+
+export type DocumentTranslate =(key: string, fallback: string) => string
 
 export type PdfAddress = {
   line1?: string | null
@@ -91,10 +93,9 @@ export type InvoiceDocumentModel = {
   pageLabel: (page: number, pages: number) => string
 }
 
-const LOCALE_BY_LANGUAGE: Record<string, string> = { en: 'en-GB', pl: 'pl-PL' }
-
+/** `Intl` locale for a document language — derived from the language registry. */
 export function documentLocale(language: string): string {
-  return LOCALE_BY_LANGUAGE[language] ?? 'en-GB'
+  return invoiceIntlLocale(language)
 }
 
 function toDate(value: Date | string | null | undefined): Date | null {

package/src/modules/billing/lib/pdf/invoicePdf.ts

@@ -3,7 +3,7 @@ import { BillingAccount, BillingInvoice, BillingInvoiceLine } from '../../data/e
 import { billingEntityIds } from '../../data/entityIds'
 import { buildSellerSnapshot, getBillingSettings } from '../billingSettings'
 import { buildBuyerSnapshot } from '../documentParties'
-import { DEFAULT_INVOICE_LANGUAGE } from '../invoiceLanguages'
+import { resolveInvoiceLanguage } from '../invoiceLanguages'
 import { buildInvoiceDocumentModel, type DocumentTranslate, type PdfAddress } from './invoiceModel'
 import { renderInvoicePdf, type PdfLogo } from './invoiceTemplate'
 import { attachmentIdFromUrl, readAttachment, storeAttachment } from './attachmentStore'
@@ -25,11 +25,15 @@ import { attachmentIdFromUrl, readAttachment, storeAttachment } from './attachme
 
 export type TranslatorLoader = (language: string) => Promise<DocumentTranslate>
 
-/** Billing i18n for a document language (en / pl, falling back to en). */
+/**
+ * Billing i18n for a document language. Any supported invoice language loads
+ * its own dictionary (registry in `../invoiceLanguages`); anything else falls
+ * back to the default language.
+ */
 export const loadDocumentTranslator: TranslatorLoader = async (language) => {
   const { loadDictionary } = await import('@open-mercato/shared/lib/i18n/server')
   const { createFallbackTranslator } = await import('@open-mercato/shared/lib/i18n/translate')
-  const locale = language === 'pl' ? 'pl' : 'en'
+  const locale = resolveInvoiceLanguage(language)
   const translate = createFallbackTranslator(await loadDictionary(locale))
   return (key, fallback) => translate(key, fallback)
 }
@@ -93,7 +97,7 @@ export async function renderBillingDocument(
     { orderBy: { lineNumber: 'asc' } as never },
   )
   const { seller, buyer } = await resolveParties(em, invoice)
-  const language = str(buyer.invoice_language) ?? DEFAULT_INVOICE_LANGUAGE
+  const language = resolveInvoiceLanguage(str(buyer.invoice_language))
   const translate = await (deps.loadTranslator ?? loadDocumentTranslator)(language)
 
   let correctsNumber: string | null = null

package/src/modules/billing/lib/pdf/invoiceTemplate.ts

@@ -27,7 +27,7 @@ const SMALL_SIZE = 8
 const LINE_GAP = 3
 
 // # | description | qty | unit net | VAT % | net | VAT | gross  (sums to CONTENT_WIDTH)
-const TABLE_COLUMNS = [24, 179, 30, 62, 36, 62, 56, 66.28]
+export const TABLE_COLUMNS = [24, 179, 30, 62, 36, 62, 56, 66.28]
 
 const TEXT = rgb(0.12, 0.12, 0.14)
 const MUTED = rgb(0.42, 0.42, 0.46)
@@ -51,7 +51,7 @@ export function sanitizeForFont(text: string, charset: Set<number>): string {
   return out
 }
 
-function wrap(text: string, font: PDFFont, size: number, width: number): string[] {
+export function wrap(text: string, font: PDFFont, size: number, width: number): string[] {
   const lines: string[] = []
   for (const paragraph of text.split('\n')) {
     let current = ''