@dainamite/billing 0.20.0 → 0.21.0

package/dist/modules/billing/lib/invoiceDelivery.js

@@ -0,0 +1,131 @@
+import { z } from "zod";
+import { CrudHttpError } from "@open-mercato/shared/lib/crud/errors";
+import { BillingAccount, BillingInvoice } from "../data/entities.js";
+import { emitBillingEvent } from "../events.js";
+import { DEFAULT_INVOICE_LANGUAGE } from "./invoiceLanguages.js";
+import { formatIban } from "./iban.js";
+import { documentLocale, formatDocumentDate, formatDocumentMoney } from "./pdf/invoiceModel.js";
+import { getInvoicePdf, loadDocumentTranslator } from "./pdf/invoicePdf.js";
+const PLACEHOLDER_DOMAIN = "@invalid.local";
+const emailSchema = z.string().trim().email();
+function isDeliverableEmail(value) {
+  if (!value) return false;
+  if (value.trim().toLowerCase().endsWith(PLACEHOLDER_DOMAIN)) return false;
+  return emailSchema.safeParse(value).success;
+}
+function hasSuccessfulDelivery(invoice, trigger) {
+  const deliveries = invoice.metadata?.deliveries ?? [];
+  return Array.isArray(deliveries) && deliveries.some((d) => d.status === "sent" && (!trigger || d.trigger === trigger));
+}
+function escapeHtml(value) {
+  return value.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c] ?? c);
+}
+function fill(template, params) {
+  return template.replace(/\{(\w+)\}/g, (match, key) => params[key] ?? match);
+}
+function buildInvoiceEmail(params) {
+  const { invoice, translate: t } = params;
+  const locale = documentLocale(params.language);
+  const values = {
+    number: invoice.number,
+    name: params.buyerName,
+    amount: formatDocumentMoney(invoice.totalGross, invoice.currencyCode, locale).replace(/[  ]/g, " "),
+    dueDate: formatDocumentDate(invoice.dueDate ?? null, locale),
+    iban: params.iban ? formatIban(params.iban) : ""
+  };
+  const paragraphs = [
+    fill(t("billing.email.invoice.greeting", "Hello {name},"), values),
+    fill(t("billing.email.invoice.body", "Please find attached invoice {number} for {amount}, due on {dueDate}."), values),
+    params.iban ? fill(t("billing.email.invoice.payment", "Please pay to IBAN {iban} with the transfer title {number}."), values) : "",
+    [t("billing.email.invoice.closing", "Kind regards,"), params.sellerName ?? ""].filter(Boolean).join("\n")
+  ].filter(Boolean);
+  return {
+    subject: fill(t("billing.email.invoice.subject", "Invoice {number}"), values),
+    text: paragraphs.join("\n\n"),
+    html: paragraphs.map((p) => `<p>${escapeHtml(p).replace(/\n/g, "<br/>")}</p>`).join("")
+  };
+}
+async function defaultSendEmail(options) {
+  const { sendEmail } = await import("@open-mercato/shared/lib/email/send");
+  await sendEmail(options);
+}
+async function appendDelivery(em, invoice, delivery) {
+  await em.execute(
+    `UPDATE billing_invoices
+        SET metadata = jsonb_set(COALESCE(metadata, '{}'::jsonb), '{deliveries}',
+                                 COALESCE(metadata->'deliveries', '[]'::jsonb) || ?::jsonb),
+            updated_at = now()
+      WHERE id = ? AND tenant_id = ? AND organization_id = ?`,
+    [JSON.stringify([delivery]), invoice.id, invoice.tenantId, invoice.organizationId]
+  );
+  const deliveries = Array.isArray(invoice.metadata?.deliveries) ? invoice.metadata?.deliveries : [];
+  invoice.metadata = { ...invoice.metadata ?? {}, deliveries: [...deliveries, delivery] };
+}
+async function sendInvoice(em, params, deps = {}) {
+  const scope = { tenantId: params.tenantId, organizationId: params.organizationId };
+  const invoice = await em.findOne(BillingInvoice, { id: params.invoiceId, ...scope, deletedAt: null });
+  if (!invoice) throw new CrudHttpError(404, { error: "Invoice not found" });
+  if (invoice.status === "draft" || invoice.testRun) {
+    throw new CrudHttpError(409, {
+      error: "Only posted invoices can be sent",
+      code: "billing.invoice.not_posted"
+    });
+  }
+  const account = await em.findOne(BillingAccount, { id: invoice.billAccountId, ...scope });
+  const buyer = invoice.buyerSnapshot ?? {};
+  const to = account?.invoiceEmail ?? (typeof buyer.invoice_email === "string" ? buyer.invoice_email : "");
+  if (!isDeliverableEmail(to)) {
+    throw new CrudHttpError(422, {
+      error: "The billing account has no deliverable invoice email",
+      code: "billing.invoice.email_invalid"
+    });
+  }
+  const language = typeof buyer.invoice_language === "string" && buyer.invoice_language || account?.invoiceLanguage || DEFAULT_INVOICE_LANGUAGE;
+  const translate = await (deps.loadTranslator ?? loadDocumentTranslator)(language);
+  const seller = invoice.sellerSnapshot ?? {};
+  const email = buildInvoiceEmail({
+    invoice,
+    buyerName: typeof buyer.name === "string" && buyer.name || account?.name || "",
+    sellerName: typeof seller.legal_name === "string" ? seller.legal_name : null,
+    iban: typeof seller.iban === "string" ? seller.iban : null,
+    language,
+    translate
+  });
+  const now = deps.now ?? (() => /* @__PURE__ */ new Date());
+  let error = null;
+  try {
+    const pdf = await getInvoicePdf(em, invoice, { loadTranslator: deps.loadTranslator });
+    await (deps.sendEmail ?? defaultSendEmail)({
+      to,
+      subject: email.subject,
+      text: email.text,
+      html: email.html,
+      attachments: [{ filename: pdf.fileName, content: Buffer.from(pdf.bytes).toString("base64"), contentType: "application/pdf" }],
+      tenantId: params.tenantId,
+      organizationId: params.organizationId
+    });
+  } catch (err) {
+    error = err instanceof Error ? err.message : String(err);
+    console.warn("[billing.invoice.send] delivery failed", invoice.id, error);
+  }
+  const status = error ? "failed" : "sent";
+  await appendDelivery(em, invoice, { at: now().toISOString(), to, status, error, trigger: params.trigger });
+  await emitBillingEvent(status === "sent" ? "billing.invoice.sent" : "billing.invoice.send_failed", {
+    invoiceId: invoice.id,
+    invoiceNumber: invoice.number,
+    billAccountId: invoice.billAccountId,
+    to,
+    trigger: params.trigger,
+    error,
+    tenantId: invoice.tenantId,
+    organizationId: invoice.organizationId
+  });
+  return { invoiceId: invoice.id, to, status, error };
+}
+export {
+  buildInvoiceEmail,
+  hasSuccessfulDelivery,
+  isDeliverableEmail,
+  sendInvoice
+};
+//# sourceMappingURL=invoiceDelivery.js.map

package/dist/modules/billing/lib/invoiceDelivery.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/lib/invoiceDelivery.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { z } from 'zod'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport type { SendEmailOptions } from '@open-mercato/shared/lib/email/send'\nimport { BillingAccount, BillingInvoice } from '../data/entities'\nimport { emitBillingEvent } from '../events'\nimport { DEFAULT_INVOICE_LANGUAGE } from './invoiceLanguages'\nimport { formatIban } from './iban'\nimport { documentLocale, formatDocumentDate, formatDocumentMoney, type DocumentTranslate } from './pdf/invoiceModel'\nimport { getInvoicePdf, loadDocumentTranslator, type TranslatorLoader } from './pdf/invoicePdf'\n\n/**\n * Emails a posted billing document to the account's invoice address with\n * the frozen PDF attached (Spec B), through the platform's standard\n * `sendEmail()` \u2014 no custom transport.\n *\n *   - posted (non-draft, non-test) documents only \u2192 409 `billing.invoice.not_posted`;\n *   - the connector's placeholder addresses (`@invalid.local`) and malformed\n *     emails are refused \u2192 422 `billing.invoice.email_invalid`, nothing sent;\n *   - every attempt appends `{ at, to, status, error?, trigger }` to\n *     `metadata.deliveries` (atomic jsonb append \u2014 concurrent sends never\n *     lose an entry) and emits `billing.invoice.sent` / `send_failed`;\n *   - transport errors (e.g. `EMAIL_TRANSPORT_NOT_CONFIGURED`) are recorded\n *     as a `failed` delivery and returned, never thrown \u2014 posting is\n *     unaffected and the operator sees the reason.\n */\n\nexport type DeliveryTrigger = 'manual' | 'auto'\n\nexport type InvoiceDelivery = {\n  at: string\n  to: string\n  status: 'sent' | 'failed'\n  error?: string | null\n  trigger: DeliveryTrigger\n}\n\nexport type SendInvoiceResult = { invoiceId: string; to: string; status: 'sent' | 'failed'; error: string | null }\n\nexport type SendEmailFn = (options: SendEmailOptions) => Promise<void>\n\nexport type SendInvoiceDeps = {\n  sendEmail?: SendEmailFn\n  loadTranslator?: TranslatorLoader\n  now?: () => Date\n}\n\nconst PLACEHOLDER_DOMAIN = '@invalid.local'\nconst emailSchema = z.string().trim().email()\n\nexport function isDeliverableEmail(value: string | null | undefined): value is string {\n  if (!value) return false\n  if (value.trim().toLowerCase().endsWith(PLACEHOLDER_DOMAIN)) return false\n  return emailSchema.safeParse(value).success\n}\n\nexport function hasSuccessfulDelivery(\n  invoice: Pick<BillingInvoice, 'metadata'>,\n  trigger?: DeliveryTrigger,\n): boolean {\n  const deliveries = (invoice.metadata?.deliveries ?? []) as InvoiceDelivery[]\n  return Array.isArray(deliveries) && deliveries.some((d) => d.status === 'sent' && (!trigger || d.trigger === trigger))\n}\n\nfunction escapeHtml(value: string): string {\n  return value.replace(/[&<>\"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '\"': '&quot;', \"'\": '&#39;' })[c] ?? c)\n}\n\nfunction fill(template: string, params: Record<string, string>): string {\n  return template.replace(/\\{(\\w+)\\}/g, (match, key: string) => params[key] ?? match)\n}\n\n/** Subject + plain-text and HTML bodies in the document language. Pure. */\nexport function buildInvoiceEmail(params: {\n  invoice: Pick<BillingInvoice, 'number' | 'totalGross' | 'currencyCode' | 'dueDate'>\n  buyerName: string\n  sellerName: string | null\n  iban: string | null\n  language: string\n  translate: DocumentTranslate\n}): { subject: string; text: string; html: string } {\n  const { invoice, translate: t } = params\n  const locale = documentLocale(params.language)\n  const values = {\n    number: invoice.number,\n    name: params.buyerName,\n    amount: formatDocumentMoney(invoice.totalGross, invoice.currencyCode, locale).replace(/[\u00A0\u202F]/g, ' '),\n    dueDate: formatDocumentDate(invoice.dueDate ?? null, locale),\n    iban: params.iban ? formatIban(params.iban) : '',\n  }\n  const paragraphs = [\n    fill(t('billing.email.invoice.greeting', 'Hello {name},'), values),\n    fill(t('billing.email.invoice.body', 'Please find attached invoice {number} for {amount}, due on {dueDate}.'), values),\n    params.iban\n      ? fill(t('billing.email.invoice.payment', 'Please pay to IBAN {iban} with the transfer title {number}.'), values)\n      : '',\n    [t('billing.email.invoice.closing', 'Kind regards,'), params.sellerName ?? ''].filter(Boolean).join('\\n'),\n  ].filter(Boolean)\n  return {\n    subject: fill(t('billing.email.invoice.subject', 'Invoice {number}'), values),\n    text: paragraphs.join('\\n\\n'),\n    html: paragraphs.map((p) => `<p>${escapeHtml(p).replace(/\\n/g, '<br/>')}</p>`).join(''),\n  }\n}\n\nasync function defaultSendEmail(options: SendEmailOptions): Promise<void> {\n  const { sendEmail } = await import('@open-mercato/shared/lib/email/send')\n  await sendEmail(options)\n}\n\nasync function appendDelivery(em: EntityManager, invoice: BillingInvoice, delivery: InvoiceDelivery): Promise<void> {\n  await em.execute(\n    `UPDATE billing_invoices\n        SET metadata = jsonb_set(COALESCE(metadata, '{}'::jsonb), '{deliveries}',\n                                 COALESCE(metadata->'deliveries', '[]'::jsonb) || ?::jsonb),\n            updated_at = now()\n      WHERE id = ? AND tenant_id = ? AND organization_id = ?`,\n    [JSON.stringify([delivery]), invoice.id, invoice.tenantId, invoice.organizationId],\n  )\n  const deliveries = Array.isArray(invoice.metadata?.deliveries) ? (invoice.metadata?.deliveries as InvoiceDelivery[]) : []\n  invoice.metadata = { ...(invoice.metadata ?? {}), deliveries: [...deliveries, delivery] }\n}\n\nexport async function sendInvoice(\n  em: EntityManager,\n  params: { invoiceId: string; tenantId: string; organizationId: string; trigger: DeliveryTrigger },\n  deps: SendInvoiceDeps = {},\n): Promise<SendInvoiceResult> {\n  const scope = { tenantId: params.tenantId, organizationId: params.organizationId }\n  const invoice = await em.findOne(BillingInvoice, { id: params.invoiceId, ...scope, deletedAt: null } as never)\n  if (!invoice) throw new CrudHttpError(404, { error: 'Invoice not found' })\n  if (invoice.status === 'draft' || invoice.testRun) {\n    throw new CrudHttpError(409, {\n      error: 'Only posted invoices can be sent',\n      code: 'billing.invoice.not_posted',\n    })\n  }\n\n  // The live account address wins (an operator may fix a bad address and\n  // resend); the frozen buyer snapshot is the fallback for a deleted account.\n  const account = await em.findOne(BillingAccount, { id: invoice.billAccountId, ...scope } as never)\n  const buyer = (invoice.buyerSnapshot ?? {}) as Record<string, unknown>\n  const to = account?.invoiceEmail ?? (typeof buyer.invoice_email === 'string' ? buyer.invoice_email : '')\n  if (!isDeliverableEmail(to)) {\n    throw new CrudHttpError(422, {\n      error: 'The billing account has no deliverable invoice email',\n      code: 'billing.invoice.email_invalid',\n    })\n  }\n\n  const language =\n    (typeof buyer.invoice_language === 'string' && buyer.invoice_language) ||\n    account?.invoiceLanguage ||\n    DEFAULT_INVOICE_LANGUAGE\n  const translate = await (deps.loadTranslator ?? loadDocumentTranslator)(language)\n  const seller = (invoice.sellerSnapshot ?? {}) as Record<string, unknown>\n  const email = buildInvoiceEmail({\n    invoice,\n    buyerName: (typeof buyer.name === 'string' && buyer.name) || account?.name || '',\n    sellerName: typeof seller.legal_name === 'string' ? seller.legal_name : null,\n    iban: typeof seller.iban === 'string' ? seller.iban : null,\n    language,\n    translate,\n  })\n\n  const now = deps.now ?? (() => new Date())\n  let error: string | null = null\n  try {\n    const pdf = await getInvoicePdf(em, invoice, { loadTranslator: deps.loadTranslator })\n    await (deps.sendEmail ?? defaultSendEmail)({\n      to,\n      subject: email.subject,\n      text: email.text,\n      html: email.html,\n      attachments: [{ filename: pdf.fileName, content: Buffer.from(pdf.bytes).toString('base64'), contentType: 'application/pdf' }],\n      tenantId: params.tenantId,\n      organizationId: params.organizationId,\n    })\n  } catch (err) {\n    error = err instanceof Error ? err.message : String(err)\n    console.warn('[billing.invoice.send] delivery failed', invoice.id, error)\n  }\n\n  const status: InvoiceDelivery['status'] = error ? 'failed' : 'sent'\n  await appendDelivery(em, invoice, { at: now().toISOString(), to, status, error, trigger: params.trigger })\n  await emitBillingEvent(status === 'sent' ? 'billing.invoice.sent' : 'billing.invoice.send_failed', {\n    invoiceId: invoice.id,\n    invoiceNumber: invoice.number,\n    billAccountId: invoice.billAccountId,\n    to,\n    trigger: params.trigger,\n    error,\n    tenantId: invoice.tenantId,\n    organizationId: invoice.organizationId,\n  })\n  return { invoiceId: invoice.id, to, status, error }\n}\n"],
+  "mappings": "AACA,SAAS,SAAS;AAClB,SAAS,qBAAqB;AAE9B,SAAS,gBAAgB,sBAAsB;AAC/C,SAAS,wBAAwB;AACjC,SAAS,gCAAgC;AACzC,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB,oBAAoB,2BAAmD;AAChG,SAAS,eAAe,8BAAqD;AAsC7E,MAAM,qBAAqB;AAC3B,MAAM,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;AAErC,SAAS,mBAAmB,OAAmD;AACpF,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,MAAM,KAAK,EAAE,YAAY,EAAE,SAAS,kBAAkB,EAAG,QAAO;AACpE,SAAO,YAAY,UAAU,KAAK,EAAE;AACtC;AAEO,SAAS,sBACd,SACA,SACS;AACT,QAAM,aAAc,QAAQ,UAAU,cAAc,CAAC;AACrD,SAAO,MAAM,QAAQ,UAAU,KAAK,WAAW,KAAK,CAAC,MAAM,EAAE,WAAW,WAAW,CAAC,WAAW,EAAE,YAAY,QAAQ;AACvH;AAEA,SAAS,WAAW,OAAuB;AACzC,SAAO,MAAM,QAAQ,YAAY,CAAC,OAAO,EAAE,KAAK,SAAS,KAAK,QAAQ,KAAK,QAAQ,KAAK,UAAU,KAAK,QAAQ,GAAG,CAAC,KAAK,CAAC;AAC3H;AAEA,SAAS,KAAK,UAAkB,QAAwC;AACtE,SAAO,SAAS,QAAQ,cAAc,CAAC,OAAO,QAAgB,OAAO,GAAG,KAAK,KAAK;AACpF;AAGO,SAAS,kBAAkB,QAOkB;AAClD,QAAM,EAAE,SAAS,WAAW,EAAE,IAAI;AAClC,QAAM,SAAS,eAAe,OAAO,QAAQ;AAC7C,QAAM,SAAS;AAAA,IACb,QAAQ,QAAQ;AAAA,IAChB,MAAM,OAAO;AAAA,IACb,QAAQ,oBAAoB,QAAQ,YAAY,QAAQ,cAAc,MAAM,EAAE,QAAQ,SAAS,GAAG;AAAA,IAClG,SAAS,mBAAmB,QAAQ,WAAW,MAAM,MAAM;AAAA,IAC3D,MAAM,OAAO,OAAO,WAAW,OAAO,IAAI,IAAI;AAAA,EAChD;AACA,QAAM,aAAa;AAAA,IACjB,KAAK,EAAE,kCAAkC,eAAe,GAAG,MAAM;AAAA,IACjE,KAAK,EAAE,8BAA8B,uEAAuE,GAAG,MAAM;AAAA,IACrH,OAAO,OACH,KAAK,EAAE,iCAAiC,6DAA6D,GAAG,MAAM,IAC9G;AAAA,IACJ,CAAC,EAAE,iCAAiC,eAAe,GAAG,OAAO,cAAc,EAAE,EAAE,OAAO,OAAO,EAAE,KAAK,IAAI;AAAA,EAC1G,EAAE,OAAO,OAAO;AAChB,SAAO;AAAA,IACL,SAAS,KAAK,EAAE,iCAAiC,kBAAkB,GAAG,MAAM;AAAA,IAC5E,MAAM,WAAW,KAAK,MAAM;AAAA,IAC5B,MAAM,WAAW,IAAI,CAAC,MAAM,MAAM,WAAW,CAAC,EAAE,QAAQ,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE;AAAA,EACxF;AACF;AAEA,eAAe,iBAAiB,SAA0C;AACxE,QAAM,EAAE,UAAU,IAAI,MAAM,OAAO,qCAAqC;AACxE,QAAM,UAAU,OAAO;AACzB;AAEA,eAAe,eAAe,IAAmB,SAAyB,UAA0C;AAClH,QAAM,GAAG;AAAA,IACP;AAAA;AAAA;AAAA;AAAA;AAAA,IAKA,CAAC,KAAK,UAAU,CAAC,QAAQ,CAAC,GAAG,QAAQ,IAAI,QAAQ,UAAU,QAAQ,cAAc;AAAA,EACnF;AACA,QAAM,aAAa,MAAM,QAAQ,QAAQ,UAAU,UAAU,IAAK,QAAQ,UAAU,aAAmC,CAAC;AACxH,UAAQ,WAAW,EAAE,GAAI,QAAQ,YAAY,CAAC,GAAI,YAAY,CAAC,GAAG,YAAY,QAAQ,EAAE;AAC1F;AAEA,eAAsB,YACpB,IACA,QACA,OAAwB,CAAC,GACG;AAC5B,QAAM,QAAQ,EAAE,UAAU,OAAO,UAAU,gBAAgB,OAAO,eAAe;AACjF,QAAM,UAAU,MAAM,GAAG,QAAQ,gBAAgB,EAAE,IAAI,OAAO,WAAW,GAAG,OAAO,WAAW,KAAK,CAAU;AAC7G,MAAI,CAAC,QAAS,OAAM,IAAI,cAAc,KAAK,EAAE,OAAO,oBAAoB,CAAC;AACzE,MAAI,QAAQ,WAAW,WAAW,QAAQ,SAAS;AACjD,UAAM,IAAI,cAAc,KAAK;AAAA,MAC3B,OAAO;AAAA,MACP,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAIA,QAAM,UAAU,MAAM,GAAG,QAAQ,gBAAgB,EAAE,IAAI,QAAQ,eAAe,GAAG,MAAM,CAAU;AACjG,QAAM,QAAS,QAAQ,iBAAiB,CAAC;AACzC,QAAM,KAAK,SAAS,iBAAiB,OAAO,MAAM,kBAAkB,WAAW,MAAM,gBAAgB;AACrG,MAAI,CAAC,mBAAmB,EAAE,GAAG;AAC3B,UAAM,IAAI,cAAc,KAAK;AAAA,MAC3B,OAAO;AAAA,MACP,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAEA,QAAM,WACH,OAAO,MAAM,qBAAqB,YAAY,MAAM,oBACrD,SAAS,mBACT;AACF,QAAM,YAAY,OAAO,KAAK,kBAAkB,wBAAwB,QAAQ;AAChF,QAAM,SAAU,QAAQ,kBAAkB,CAAC;AAC3C,QAAM,QAAQ,kBAAkB;AAAA,IAC9B;AAAA,IACA,WAAY,OAAO,MAAM,SAAS,YAAY,MAAM,QAAS,SAAS,QAAQ;AAAA,IAC9E,YAAY,OAAO,OAAO,eAAe,WAAW,OAAO,aAAa;AAAA,IACxE,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,OAAO;AAAA,IACtD;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,MAAM,KAAK,QAAQ,MAAM,oBAAI,KAAK;AACxC,MAAI,QAAuB;AAC3B,MAAI;AACF,UAAM,MAAM,MAAM,cAAc,IAAI,SAAS,EAAE,gBAAgB,KAAK,eAAe,CAAC;AACpF,WAAO,KAAK,aAAa,kBAAkB;AAAA,MACzC;AAAA,MACA,SAAS,MAAM;AAAA,MACf,MAAM,MAAM;AAAA,MACZ,MAAM,MAAM;AAAA,MACZ,aAAa,CAAC,EAAE,UAAU,IAAI,UAAU,SAAS,OAAO,KAAK,IAAI,KAAK,EAAE,SAAS,QAAQ,GAAG,aAAa,kBAAkB,CAAC;AAAA,MAC5H,UAAU,OAAO;AAAA,MACjB,gBAAgB,OAAO;AAAA,IACzB,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,YAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AACvD,YAAQ,KAAK,0CAA0C,QAAQ,IAAI,KAAK;AAAA,EAC1E;AAEA,QAAM,SAAoC,QAAQ,WAAW;AAC7D,QAAM,eAAe,IAAI,SAAS,EAAE,IAAI,IAAI,EAAE,YAAY,GAAG,IAAI,QAAQ,OAAO,SAAS,OAAO,QAAQ,CAAC;AACzG,QAAM,iBAAiB,WAAW,SAAS,yBAAyB,+BAA+B;AAAA,IACjG,WAAW,QAAQ;AAAA,IACnB,eAAe,QAAQ;AAAA,IACvB,eAAe,QAAQ;AAAA,IACvB;AAAA,IACA,SAAS,OAAO;AAAA,IAChB;AAAA,IACA,UAAU,QAAQ;AAAA,IAClB,gBAAgB,QAAQ;AAAA,EAC1B,CAAC;AACD,SAAO,EAAE,WAAW,QAAQ,IAAI,IAAI,QAAQ,MAAM;AACpD;",
+  "names": []
+}

package/dist/modules/billing/lib/invoiceLanguages.js

@@ -0,0 +1,16 @@
+const SUPPORTED_INVOICE_LANGUAGES = [
+  { code: "en", label: "English" },
+  { code: "pl", label: "Polski" }
+];
+const INVOICE_LANGUAGE_CODES = SUPPORTED_INVOICE_LANGUAGES.map((l) => l.code);
+const DEFAULT_INVOICE_LANGUAGE = "en";
+function isSupportedInvoiceLanguage(value) {
+  return INVOICE_LANGUAGE_CODES.includes(value);
+}
+export {
+  DEFAULT_INVOICE_LANGUAGE,
+  INVOICE_LANGUAGE_CODES,
+  SUPPORTED_INVOICE_LANGUAGES,
+  isSupportedInvoiceLanguage
+};
+//# sourceMappingURL=invoiceLanguages.js.map

package/dist/modules/billing/lib/invoiceLanguages.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/lib/invoiceLanguages.ts"],
+  "sourcesContent": ["/**\n * Invoice languages the built-in billing document template can render.\n *\n * Single source of truth for the account form's language picklist and the\n * `invoiceLanguage` validator. Adding a language means adding the template\n * labels for it AND one entry here \u2014 never one without the other.\n *\n * `label` is the language's own name (endonym), so it reads correctly no\n * matter which UI locale the operator uses \u2014 it is intentionally not routed\n * through i18n.\n *\n * Spec: .ai/specs/2026-11-14-billing-account-workspace.md (D22). Narrowing the\n * list per organization (`BillingSettings.enabled_invoice_languages`) arrives\n * with the standalone-ledger spec; until then every supported language is\n * selectable.\n */\n\nexport const SUPPORTED_INVOICE_LANGUAGES = [\n  { code: 'en', label: 'English' },\n  { code: 'pl', label: 'Polski' },\n] as const\n\nexport type InvoiceLanguageCode = (typeof SUPPORTED_INVOICE_LANGUAGES)[number]['code']\n\nexport const INVOICE_LANGUAGE_CODES = SUPPORTED_INVOICE_LANGUAGES.map((l) => l.code) as [\n  InvoiceLanguageCode,\n  ...InvoiceLanguageCode[],\n]\n\nexport const DEFAULT_INVOICE_LANGUAGE: InvoiceLanguageCode = 'en'\n\nexport function isSupportedInvoiceLanguage(value: string): value is InvoiceLanguageCode {\n  return (INVOICE_LANGUAGE_CODES as readonly string[]).includes(value)\n}\n"],
+  "mappings": "AAiBO,MAAM,8BAA8B;AAAA,EACzC,EAAE,MAAM,MAAM,OAAO,UAAU;AAAA,EAC/B,EAAE,MAAM,MAAM,OAAO,SAAS;AAChC;AAIO,MAAM,yBAAyB,4BAA4B,IAAI,CAAC,MAAM,EAAE,IAAI;AAK5E,MAAM,2BAAgD;AAEtD,SAAS,2BAA2B,OAA6C;AACtF,SAAQ,uBAA6C,SAAS,KAAK;AACrE;",
+  "names": []
+}

package/dist/modules/billing/lib/invoiceWriter.js

@@ -1,118 +1,86 @@
-import {
-  SalesInvoice,
-  SalesInvoiceLine
-} from "@open-mercato/core/modules/sales/data/entities";
-import {
-  __resetInvoiceStatusCacheForTests,
-  resolveInvoiceStatusEntryId
-} from "./invoiceStatus.js";
-const DRAFT_INVOICE_STATUS_VALUE = "draft";
+import { BillingInvoice, BillingInvoiceLine } from "../data/entities.js";
+import { draftNumber, testNumber } from "./numbering.js";
+import { sumTotals } from "./vat.js";
+import { lineVat, priceBasisOf, unitPriceNetOf } from "./lineAmounts.js";
 function __resetInvoiceWriterCacheForTests() {
-  __resetInvoiceStatusCacheForTests();
-}
-function generateTestInvoiceNumber() {
-  const random = Math.floor(Math.random() * 1e9).toString(16).padStart(8, "0");
-  return `TEST-${Date.now().toString(16)}-${random}`;
 }
 function roundHalfUp2dp(value) {
-  return Math.round((value + Number.EPSILON) * 100) / 100;
+  const sign = value < 0 ? -1 : 1;
+  return sign * Math.round((Math.abs(value) + Number.EPSILON) * 100) / 100;
 }
 function format4dp(value) {
   return roundHalfUp2dp(value).toFixed(4);
 }
-function sumNetTotal(lines) {
-  let total = 0;
-  for (const line of lines) {
-    total += Number.parseFloat(line.totalNetAmount);
-  }
-  return format4dp(total);
+function itemTaxRate(item) {
+  const rate = Number.parseFloat(String(item.taxRate ?? "0"));
+  return Number.isFinite(rate) && rate >= 0 ? String(rate) : "0";
 }
-async function writeDraftInvoice(em, container, params) {
-  const totalNet = sumNetTotal(params.lines);
+function isoDate(date) {
+  return new Date(date).toISOString().slice(0, 10);
+}
+async function writeDraftInvoice(em, params) {
+  const amounts = params.lines.map(
+    (line) => lineVat({ amount: line.lineAmount, priceBasis: line.priceBasis, taxRate: line.taxRate })
+  );
+  const totals = sumTotals(amounts);
   if (params.mode === "dry") {
-    return { invoiceId: null, invoiceNumber: null, totalNet };
+    return { invoiceId: null, invoiceNumber: null, totalNet: totals.subtotalNet, totalGross: totals.totalGross };
   }
   const { account, period, billRunId, lines, mode } = params;
-  let invoiceNumber;
-  if (mode === "test") {
-    invoiceNumber = generateTestInvoiceNumber();
-  } else {
-    const numberGenerator = container.resolve(
-      "salesDocumentNumberGenerator"
-    );
-    const generated = await numberGenerator.generate({
-      organizationId: account.organizationId,
-      tenantId: account.tenantId,
-      kind: "invoice"
-    });
-    invoiceNumber = generated.number;
-  }
-  const statusEntryId = await resolveInvoiceStatusEntryId(
-    em,
-    account.tenantId,
-    account.organizationId,
-    "draft"
-  );
+  const invoiceNumber = mode === "test" ? testNumber() : draftNumber();
   const now = /* @__PURE__ */ new Date();
-  const invoice = em.create(SalesInvoice, {
+  const invoice = em.create(BillingInvoice, {
     organizationId: account.organizationId,
     tenantId: account.tenantId,
-    invoiceNumber,
-    statusEntryId,
-    status: DRAFT_INVOICE_STATUS_VALUE,
-    issueDate: now,
+    billAccountId: account.id,
+    documentType: "invoice",
+    number: invoiceNumber,
+    series: null,
+    status: "draft",
+    testRun: mode === "test",
+    billRunId,
+    billDate: params.billDate,
+    periodStart: period.periodStart,
+    periodEnd: period.periodEnd,
     currencyCode: account.currencyCode,
-    subtotalNetAmount: totalNet,
-    subtotalGrossAmount: totalNet,
-    // gross == net for drafts (tax computed on post)
-    discountTotalAmount: "0",
-    taxTotalAmount: "0",
-    grandTotalNetAmount: totalNet,
-    grandTotalGrossAmount: totalNet,
-    paidTotalAmount: "0",
-    outstandingAmount: totalNet,
-    metadata: {
-      bill_run_id: billRunId,
-      bill_account_id: account.id,
-      bill_period_start: period.periodStart.toISOString().slice(0, 10),
-      bill_period_end: period.periodEnd.toISOString().slice(0, 10),
-      test_run: mode === "test" ? true : void 0
-    },
+    subtotalNet: totals.subtotalNet,
+    taxTotal: totals.taxTotal,
+    totalGross: totals.totalGross,
+    paidTotal: "0",
+    creditedTotal: "0",
+    outstanding: totals.totalGross,
     createdAt: now,
     updatedAt: now
   });
   em.persist(invoice);
-  let lineNumber = 1;
-  for (const line of lines) {
-    const invoiceLine = em.create(SalesInvoiceLine, {
-      invoice,
-      organizationId: account.organizationId,
-      tenantId: account.tenantId,
-      lineNumber: lineNumber++,
-      kind: "product",
-      description: line.description,
-      quantity: line.quantity,
-      normalizedQuantity: line.quantity,
-      currencyCode: account.currencyCode,
-      unitPriceNet: line.unitPriceNet,
-      unitPriceGross: line.unitPriceNet,
-      // gross == net until tax computed on post
-      discountAmount: "0",
-      discountPercent: "0",
-      taxRate: "0",
-      taxAmount: "0",
-      totalNetAmount: line.totalNetAmount,
-      totalGrossAmount: line.totalNetAmount,
-      metadata: {
-        billing_item_id: line.billingItemId,
-        billing_type: line.billingType,
-        ...line.metadataExtra ?? {}
-      }
-    });
-    em.persist(invoiceLine);
-  }
   await em.flush();
-  return { invoiceId: invoice.id, invoiceNumber, totalNet };
+  lines.forEach((line, index) => {
+    const amount = amounts[index];
+    em.persist(
+      em.create(BillingInvoiceLine, {
+        organizationId: account.organizationId,
+        tenantId: account.tenantId,
+        invoiceId: invoice.id,
+        lineNumber: index + 1,
+        billingItemId: line.billingItemId,
+        billingType: line.billingType,
+        description: line.description,
+        quantity: line.quantity,
+        unitPriceNet: line.priceBasis === "gross" ? unitPriceNetOf(line.unitPrice, "gross", line.taxRate) : line.unitPrice,
+        taxRate: line.taxRate,
+        netAmount: format4dp(amount.net),
+        taxAmount: format4dp(amount.tax),
+        grossAmount: format4dp(amount.gross),
+        servicePeriodStart: line.servicePeriodStart ?? null,
+        servicePeriodEnd: line.servicePeriodEnd ?? null,
+        metadata: line.metadataExtra ?? null,
+        createdAt: now,
+        updatedAt: now
+      })
+    );
+  });
+  await em.flush();
+  return { invoiceId: invoice.id, invoiceNumber, totalNet: totals.subtotalNet, totalGross: totals.totalGross };
 }
 function buildInvoiceLinesFromItems(items) {
   const lines = [];
@@ -125,9 +93,11 @@ function buildInvoiceLinesFromItems(items) {
         billingItemId: item.id,
         billingType: "one_time",
         description: item.description,
-        unitPriceNet: amount,
+        unitPrice: amount,
         quantity: "1",
-        totalNetAmount: amount
+        lineAmount: amount,
+        priceBasis: priceBasisOf(item.priceBasis),
+        taxRate: itemTaxRate(item)
       });
     } else if (item.type === "recurring") {
       const rate = item.rateJson;
@@ -137,17 +107,55 @@ function buildInvoiceLinesFromItems(items) {
         billingItemId: item.id,
         billingType: "recurring",
         description: item.description,
-        unitPriceNet: unitPrice,
+        unitPrice,
         quantity: "1",
-        totalNetAmount: unitPrice
+        lineAmount: unitPrice,
+        priceBasis: priceBasisOf(item.priceBasis),
+        taxRate: itemTaxRate(item)
       });
     }
   }
   return lines;
 }
+function displayPeriod(lines, fallback) {
+  let start = null;
+  let end = null;
+  for (const line of lines) {
+    if (line.servicePeriodStart && (!start || line.servicePeriodStart < start)) start = line.servicePeriodStart;
+    if (line.servicePeriodEnd && (!end || line.servicePeriodEnd > end)) end = line.servicePeriodEnd;
+  }
+  return { periodStart: start ?? fallback.periodStart, periodEnd: end ?? fallback.periodEnd };
+}
+function buildRecurringLineDescriptors(item, lines) {
+  return lines.map((line) => {
+    const amount = format4dp(line.amount);
+    const dated = line.proration !== null || line.kind === "credit";
+    return {
+      billingItemId: item.id,
+      billingType: "recurring",
+      description: dated ? `${item.description} \xB7 ${isoDate(line.servicePeriodStart)} \u2013 ${isoDate(line.servicePeriodEnd)}` : item.description,
+      unitPrice: amount,
+      quantity: "1",
+      lineAmount: amount,
+      // Proration and credit lines inherit the item's rate (Spec B) and basis (Spec F).
+      priceBasis: priceBasisOf(item.priceBasis),
+      taxRate: itemTaxRate(item),
+      servicePeriodStart: line.servicePeriodStart,
+      servicePeriodEnd: line.servicePeriodEnd,
+      metadataExtra: {
+        charge_timing: item.chargeTiming,
+        ...line.proration ? { proration: { active_days: line.proration.activeDays, period_days: line.proration.periodDays } } : {},
+        ...line.kind === "credit" ? { credit_for: item.id } : {}
+      }
+    };
+  });
+}
 export {
   __resetInvoiceWriterCacheForTests,
   buildInvoiceLinesFromItems,
+  buildRecurringLineDescriptors,
+  displayPeriod,
+  itemTaxRate,
   writeDraftInvoice
 };
 //# sourceMappingURL=invoiceWriter.js.map

package/dist/modules/billing/lib/invoiceWriter.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/billing/lib/invoiceWriter.ts"],
-  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport {\n  SalesInvoice,\n  SalesInvoiceLine,\n} from '@open-mercato/core/modules/sales/data/entities'\nimport type { SalesDocumentNumberGenerator } from '@open-mercato/core/modules/sales/services/salesDocumentNumberGenerator'\nimport type { BillingAccount, BillingItem } from '../data/entities'\nimport type { BillPeriod } from './billPeriod'\nimport {\n  __resetInvoiceStatusCacheForTests,\n  resolveInvoiceStatusEntryId,\n} from './invoiceStatus'\n\n/**\n * Writes a `core/sales` draft invoice for a billing account's bill period.\n *\n * Two notable deviations from the spec, documented in CHANGELOG / spec:\n *\n *   1. `SalesInvoice.invoice_number` is `NOT NULL` in the upstream\n *      schema, but the spec says \"sequence number assigned at Post.\"\n *      Real-mode invoices get a real number via\n *      `salesDocumentNumberGenerator.generate({ kind: 'invoice' })` at\n *      *draft create time* \u2014 the spec's intent (gap-free numbering via\n *      atomic SQL upsert) is preserved; the timing differs because the\n *      upstream column is `NOT NULL`. \"Post\" then just transitions\n *      status `draft \u2192 posted`.\n *\n *   2. Test-mode invoices use a `TEST-<uuid>` placeholder number (not\n *      the real sequence) so test runs do not burn production numbers\n *      and can be repeated idempotently.\n *\n * VAT is NOT computed here \u2014 `core/sales`'s tax service owns the\n * per-line `tax_rate` / `tax_amount` calculation, and runs on POST.\n * Drafts therefore carry zeroes in the tax columns; the totals reflect\n * net amounts only.\n */\n\nexport type WriteMode = 'real' | 'test' | 'dry'\n\nexport type InvoiceLineDescriptor = {\n  /** Maps to billing_item_id on the resulting SalesInvoiceLine.metadata. */\n  billingItemId: string\n  /** From the spec's `metadata.billing_type` for traceability. */\n  billingType: 'one_time' | 'recurring' | 'usage'\n  description: string\n  /** Net unit price (numeric string for SalesInvoiceLine.unit_price_net). */\n  unitPriceNet: string\n  /** Quantity (string for the numeric(18,4) column). */\n  quantity: string\n  /** Total net (string). */\n  totalNetAmount: string\n  /** Optional per-line metadata extension \u2014 e.g. usage tier breakdown. */\n  metadataExtra?: Record<string, unknown>\n}\n\nexport type WriteInvoiceParams = {\n  mode: WriteMode\n  account: BillingAccount\n  period: BillPeriod\n  billRunId: string\n  lines: InvoiceLineDescriptor[]\n}\n\nexport type WrittenInvoice = {\n  invoiceId: string | null\n  invoiceNumber: string | null\n  totalNet: string\n}\n\nconst DRAFT_INVOICE_STATUS_VALUE = 'draft'\n\n/**\n * Test hook \u2014 clears the shared resolver's status cache so the engine\n * test suite stays deterministic across mocked-EM environments.\n */\nexport function __resetInvoiceWriterCacheForTests(): void {\n  __resetInvoiceStatusCacheForTests()\n}\n\nfunction generateTestInvoiceNumber(): string {\n  // Match the pattern operators search by: `TEST-` prefix + random\n  // suffix so the test wipe-out endpoint can filter via `LIKE 'TEST-%'`\n  // (defensive \u2014 primary filter is `metadata.test_run=true`).\n  const random = Math.floor(Math.random() * 1e9)\n    .toString(16)\n    .padStart(8, '0')\n  return `TEST-${Date.now().toString(16)}-${random}`\n}\n\n/**\n * 2dp half-up rounding that survives binary floating-point edge cases\n * (e.g. `1.005 * 100 === 100.49999...` would otherwise round DOWN to\n * `1.00` under naive `Math.round`). The `+ EPSILON` nudge pushes\n * representations like 100.4999...8 up to the true half-up boundary.\n * Matches the spec's \"2 decimal places, half-up\" rounding policy.\n */\nfunction roundHalfUp2dp(value: number): number {\n  return Math.round((value + Number.EPSILON) * 100) / 100\n}\n\nfunction format4dp(value: number): string {\n  return roundHalfUp2dp(value).toFixed(4)\n}\n\nfunction sumNetTotal(lines: InvoiceLineDescriptor[]): string {\n  let total = 0\n  for (const line of lines) {\n    total += Number.parseFloat(line.totalNetAmount)\n  }\n  return format4dp(total)\n}\n\nexport async function writeDraftInvoice(\n  em: EntityManager,\n  container: AwilixContainer,\n  params: WriteInvoiceParams,\n): Promise<WrittenInvoice> {\n  const totalNet = sumNetTotal(params.lines)\n\n  if (params.mode === 'dry') {\n    // Compute totals; persist nothing.\n    return { invoiceId: null, invoiceNumber: null, totalNet }\n  }\n\n  const { account, period, billRunId, lines, mode } = params\n\n  let invoiceNumber: string\n  if (mode === 'test') {\n    invoiceNumber = generateTestInvoiceNumber()\n  } else {\n    const numberGenerator = container.resolve(\n      'salesDocumentNumberGenerator',\n    ) as SalesDocumentNumberGenerator\n    const generated = await numberGenerator.generate({\n      organizationId: account.organizationId,\n      tenantId: account.tenantId,\n      kind: 'invoice',\n    })\n    invoiceNumber = generated.number\n  }\n\n  const statusEntryId = await resolveInvoiceStatusEntryId(\n    em,\n    account.tenantId,\n    account.organizationId,\n    'draft',\n  )\n\n  const now = new Date()\n  const invoice = em.create(SalesInvoice, {\n    organizationId: account.organizationId,\n    tenantId: account.tenantId,\n    invoiceNumber,\n    statusEntryId,\n    status: DRAFT_INVOICE_STATUS_VALUE,\n    issueDate: now,\n    currencyCode: account.currencyCode,\n    subtotalNetAmount: totalNet,\n    subtotalGrossAmount: totalNet, // gross == net for drafts (tax computed on post)\n    discountTotalAmount: '0',\n    taxTotalAmount: '0',\n    grandTotalNetAmount: totalNet,\n    grandTotalGrossAmount: totalNet,\n    paidTotalAmount: '0',\n    outstandingAmount: totalNet,\n    metadata: {\n      bill_run_id: billRunId,\n      bill_account_id: account.id,\n      bill_period_start: period.periodStart.toISOString().slice(0, 10),\n      bill_period_end: period.periodEnd.toISOString().slice(0, 10),\n      test_run: mode === 'test' ? true : undefined,\n    },\n    createdAt: now,\n    updatedAt: now,\n  })\n  em.persist(invoice)\n\n  let lineNumber = 1\n  for (const line of lines) {\n    const invoiceLine = em.create(SalesInvoiceLine, {\n      invoice,\n      organizationId: account.organizationId,\n      tenantId: account.tenantId,\n      lineNumber: lineNumber++,\n      kind: 'product',\n      description: line.description,\n      quantity: line.quantity,\n      normalizedQuantity: line.quantity,\n      currencyCode: account.currencyCode,\n      unitPriceNet: line.unitPriceNet,\n      unitPriceGross: line.unitPriceNet, // gross == net until tax computed on post\n      discountAmount: '0',\n      discountPercent: '0',\n      taxRate: '0',\n      taxAmount: '0',\n      totalNetAmount: line.totalNetAmount,\n      totalGrossAmount: line.totalNetAmount,\n      metadata: {\n        billing_item_id: line.billingItemId,\n        billing_type: line.billingType,\n        ...(line.metadataExtra ?? {}),\n      },\n    })\n    em.persist(invoiceLine)\n  }\n\n  await em.flush()\n\n  return { invoiceId: invoice.id, invoiceNumber, totalNet }\n}\n\n/**\n * Build the InvoiceLineDescriptor list for a single account's eligible\n * items (the result of `itemSelector.selectItemsForPeriod`). One line\n * per item; `usage` items are excluded earlier by the selector.\n *\n * Per-type pricing per the spec's `BillingItem \u2192 InvoiceLine mapping`:\n *   - `one_time`: unit_price = amount, quantity = 1\n *   - `recurring`: unit_price = unit_price, quantity = 1\n *     (one full cycle per bill period; catch-up emits separate drafts\n *     per missed cycle, never combined)\n */\nexport function buildInvoiceLinesFromItems(\n  items: readonly BillingItem[],\n): InvoiceLineDescriptor[] {\n  const lines: InvoiceLineDescriptor[] = []\n  for (const item of items) {\n    if (item.type === 'one_time') {\n      const rate = item.rateJson as { amount?: number } | null\n      if (!rate || typeof rate.amount !== 'number') continue\n      // For one_time the per-unit price IS the total \u2014 quantity is 1.\n      // Both fields therefore carry the same value, with the 2dp\n      // half-up policy applied (unit price + line total are the same\n      // numeric column at numeric(18,4)).\n      const amount = format4dp(rate.amount)\n      lines.push({\n        billingItemId: item.id,\n        billingType: 'one_time',\n        description: item.description,\n        unitPriceNet: amount,\n        quantity: '1',\n        totalNetAmount: amount,\n      })\n    } else if (item.type === 'recurring') {\n      const rate = item.rateJson as { unit_price?: number } | null\n      if (!rate || typeof rate.unit_price !== 'number') continue\n      const unitPrice = format4dp(rate.unit_price)\n      lines.push({\n        billingItemId: item.id,\n        billingType: 'recurring',\n        description: item.description,\n        unitPriceNet: unitPrice,\n        quantity: '1',\n        totalNetAmount: unitPrice,\n      })\n    }\n  }\n  return lines\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { BillingInvoice, BillingInvoiceLine } from '../data/entities'\nimport type { BillingAccount, BillingItem } from '../data/entities'\nimport type { BillPeriod } from './billPeriod'\nimport type { RecurringLine } from './servicePeriods'\nimport { draftNumber, testNumber } from './numbering'\nimport { sumTotals } from './vat'\nimport { lineVat, priceBasisOf, unitPriceNetOf, type PriceBasis } from './lineAmounts'\n\n/**\n * Writes a billing-owned draft invoice (`billing_invoices` +\n * `billing_invoice_lines`) for one bill date of an account \u2014 Spec 0: billing\n * no longer records anything in core `sales`.\n *\n *   - Real drafts get a temporary `DRAFT-\u2026` number; the series number is\n *     claimed only at post (gap-free numbering \u2014 no number is burnt by a\n *     deleted draft).\n *   - Test drafts get `TEST-\u2026` and `test_run = true`; they are never posted.\n *   - Spec B (B-D2): every line carries its item's VAT rate; tax is rounded\n *     per line (half-up, 2 dp) and totals are sums of the rounded lines.\n *   - Spec F (F-D2): line amounts are on the item's `price_basis`; net / tax\n *     / gross come from `lineVat`, so a typed gross is reproduced exactly.\n */\n\nexport type WriteMode = 'real' | 'test' | 'dry'\n\nexport type InvoiceLineDescriptor = {\n  /** Maps to `billing_invoice_lines.billing_item_id`. */\n  billingItemId: string\n  /** From the spec's `metadata.billing_type` for traceability. */\n  billingType: 'one_time' | 'recurring' | 'usage'\n  description: string\n  /** Unit price on `priceBasis` (numeric string). The writer derives `unit_price_net`. */\n  unitPrice: string\n  /** Quantity (string for the numeric(18,4) column). */\n  quantity: string\n  /** Extended line amount on `priceBasis` (unit \u00D7 quantity \u00D7 proration). */\n  lineAmount: string\n  /** Spec F: the basis `unitPrice` / `lineAmount` are on (the item's `price_basis`). */\n  priceBasis: PriceBasis\n  /** Spec B: VAT rate in percent (numeric string), from the item. */\n  taxRate: string\n  /** Optional per-line metadata extension \u2014 e.g. usage tier breakdown. */\n  metadataExtra?: Record<string, unknown>\n  /**\n   * Spec A: inclusive service period the line covers (recurring + usage).\n   * Written to line metadata and used for the invoice's display period.\n   */\n  servicePeriodStart?: Date\n  servicePeriodEnd?: Date\n}\n\nexport type WriteInvoiceParams = {\n  mode: WriteMode\n  account: BillingAccount\n  /** Spec A: the bill date this invoice is for \u2014 the dedupe key. */\n  billDate: Date\n  /** Display period: min/max of the line service periods (see `displayPeriod`). */\n  period: BillPeriod\n  billRunId: string\n  lines: InvoiceLineDescriptor[]\n}\n\nexport type WrittenInvoice = {\n  invoiceId: string | null\n  invoiceNumber: string | null\n  totalNet: string\n  totalGross: string\n}\n\n/** @deprecated kept for test-suite compatibility; the writer has no cache any more. */\nexport function __resetInvoiceWriterCacheForTests(): void {}\n\n/** 2dp half-up rounding (survives 1.005-style binary edges). */\nfunction roundHalfUp2dp(value: number): number {\n  const sign = value < 0 ? -1 : 1\n  return (sign * Math.round((Math.abs(value) + Number.EPSILON) * 100)) / 100\n}\n\nfunction format4dp(value: number): string {\n  return roundHalfUp2dp(value).toFixed(4)\n}\n\n/** VAT rate of an item as a numeric string; items predating Spec B read as 0. */\nexport function itemTaxRate(item: Pick<BillingItem, 'taxRate'>): string {\n  const rate = Number.parseFloat(String(item.taxRate ?? '0'))\n  return Number.isFinite(rate) && rate >= 0 ? String(rate) : '0'\n}\n\nfunction isoDate(date: Date): string {\n  return new Date(date).toISOString().slice(0, 10)\n}\n\nexport async function writeDraftInvoice(\n  em: EntityManager,\n  params: WriteInvoiceParams,\n): Promise<WrittenInvoice> {\n  const amounts = params.lines.map((line) =>\n    lineVat({ amount: line.lineAmount, priceBasis: line.priceBasis, taxRate: line.taxRate }),\n  )\n  const totals = sumTotals(amounts)\n\n  if (params.mode === 'dry') {\n    // Compute totals; persist nothing.\n    return { invoiceId: null, invoiceNumber: null, totalNet: totals.subtotalNet, totalGross: totals.totalGross }\n  }\n\n  const { account, period, billRunId, lines, mode } = params\n  const invoiceNumber = mode === 'test' ? testNumber() : draftNumber()\n  const now = new Date()\n\n  const invoice = em.create(BillingInvoice, {\n    organizationId: account.organizationId,\n    tenantId: account.tenantId,\n    billAccountId: account.id,\n    documentType: 'invoice',\n    number: invoiceNumber,\n    series: null,\n    status: 'draft',\n    testRun: mode === 'test',\n    billRunId,\n    billDate: params.billDate,\n    periodStart: period.periodStart,\n    periodEnd: period.periodEnd,\n    currencyCode: account.currencyCode,\n    subtotalNet: totals.subtotalNet,\n    taxTotal: totals.taxTotal,\n    totalGross: totals.totalGross,\n    paidTotal: '0',\n    creditedTotal: '0',\n    outstanding: totals.totalGross,\n    createdAt: now,\n    updatedAt: now,\n  })\n  em.persist(invoice)\n  await em.flush() // need the invoice id for the lines\n\n  lines.forEach((line, index) => {\n    const amount = amounts[index]\n    em.persist(\n      em.create(BillingInvoiceLine, {\n        organizationId: account.organizationId,\n        tenantId: account.tenantId,\n        invoiceId: invoice.id,\n        lineNumber: index + 1,\n        billingItemId: line.billingItemId,\n        billingType: line.billingType,\n        description: line.description,\n        quantity: line.quantity,\n        unitPriceNet:\n          line.priceBasis === 'gross' ? unitPriceNetOf(line.unitPrice, 'gross', line.taxRate) : line.unitPrice,\n        taxRate: line.taxRate,\n        netAmount: format4dp(amount.net),\n        taxAmount: format4dp(amount.tax),\n        grossAmount: format4dp(amount.gross),\n        servicePeriodStart: line.servicePeriodStart ?? null,\n        servicePeriodEnd: line.servicePeriodEnd ?? null,\n        metadata: line.metadataExtra ?? null,\n        createdAt: now,\n        updatedAt: now,\n      }),\n    )\n  })\n  await em.flush()\n\n  return { invoiceId: invoice.id, invoiceNumber, totalNet: totals.subtotalNet, totalGross: totals.totalGross }\n}\n\n/**\n * Build the InvoiceLineDescriptor list for a single account's eligible\n * items (the result of `itemSelector.selectItemsForPeriod`). One line\n * per item; `usage` items are excluded earlier by the selector.\n *\n * Per-type pricing per the spec's `BillingItem \u2192 InvoiceLine mapping`:\n *   - `one_time`: unit_price = amount, quantity = 1\n *   - `recurring`: unit_price = unit_price, quantity = 1\n *     (one full cycle per bill period; catch-up emits separate drafts\n *     per missed cycle, never combined)\n */\nexport function buildInvoiceLinesFromItems(\n  items: readonly BillingItem[],\n): InvoiceLineDescriptor[] {\n  const lines: InvoiceLineDescriptor[] = []\n  for (const item of items) {\n    if (item.type === 'one_time') {\n      const rate = item.rateJson as { amount?: number } | null\n      if (!rate || typeof rate.amount !== 'number') continue\n      // For one_time the per-unit price IS the total \u2014 quantity is 1.\n      // Both fields therefore carry the same value, with the 2dp\n      // half-up policy applied (unit price + line total are the same\n      // numeric column at numeric(18,4)).\n      const amount = format4dp(rate.amount)\n      lines.push({\n        billingItemId: item.id,\n        billingType: 'one_time',\n        description: item.description,\n        unitPrice: amount,\n        quantity: '1',\n        lineAmount: amount,\n        priceBasis: priceBasisOf(item.priceBasis),\n        taxRate: itemTaxRate(item),\n      })\n    } else if (item.type === 'recurring') {\n      const rate = item.rateJson as { unit_price?: number } | null\n      if (!rate || typeof rate.unit_price !== 'number') continue\n      const unitPrice = format4dp(rate.unit_price)\n      lines.push({\n        billingItemId: item.id,\n        billingType: 'recurring',\n        description: item.description,\n        unitPrice,\n        quantity: '1',\n        lineAmount: unitPrice,\n        priceBasis: priceBasisOf(item.priceBasis),\n        taxRate: itemTaxRate(item),\n      })\n    }\n  }\n  return lines\n}\n\n/**\n * Display period of an invoice: min start / max end over the lines' service\n * periods, falling back to `fallback` (the arrears window) when no line\n * carries one (e.g. a one_time-only invoice).\n */\nexport function displayPeriod(lines: readonly InvoiceLineDescriptor[], fallback: BillPeriod): BillPeriod {\n  let start: Date | null = null\n  let end: Date | null = null\n  for (const line of lines) {\n    if (line.servicePeriodStart && (!start || line.servicePeriodStart < start)) start = line.servicePeriodStart\n    if (line.servicePeriodEnd && (!end || line.servicePeriodEnd > end)) end = line.servicePeriodEnd\n  }\n  return { periodStart: start ?? fallback.periodStart, periodEnd: end ?? fallback.periodEnd }\n}\n\n/**\n * Spec A: invoice lines for computed recurring service periods (charges and\n * credits). Full-period charges keep the bare item description; partial\n * periods and credits append the covered dates so the line is\n * self-explanatory on any document (language-neutral \u2014 the PDF renders\n * localized labels later).\n */\nexport function buildRecurringLineDescriptors(\n  item: Pick<BillingItem, 'id' | 'description' | 'chargeTiming' | 'taxRate' | 'priceBasis'>,\n  lines: readonly RecurringLine[],\n): InvoiceLineDescriptor[] {\n  return lines.map((line) => {\n    const amount = format4dp(line.amount)\n    const dated = line.proration !== null || line.kind === 'credit'\n    return {\n      billingItemId: item.id,\n      billingType: 'recurring' as const,\n      description: dated\n        ? `${item.description} \u00B7 ${isoDate(line.servicePeriodStart)} \u2013 ${isoDate(line.servicePeriodEnd)}`\n        : item.description,\n      unitPrice: amount,\n      quantity: '1',\n      lineAmount: amount,\n      // Proration and credit lines inherit the item's rate (Spec B) and basis (Spec F).\n      priceBasis: priceBasisOf(item.priceBasis),\n      taxRate: itemTaxRate(item),\n      servicePeriodStart: line.servicePeriodStart,\n      servicePeriodEnd: line.servicePeriodEnd,\n      metadataExtra: {\n        charge_timing: item.chargeTiming,\n        ...(line.proration\n          ? { proration: { active_days: line.proration.activeDays, period_days: line.proration.periodDays } }\n          : {}),\n        ...(line.kind === 'credit' ? { credit_for: item.id } : {}),\n      },\n    }\n  })\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/billing/lib/itemBillingState.js

@@ -0,0 +1,27 @@
+function day(value) {
+  return value ? value.slice(0, 10) : null;
+}
+function nextDay(iso) {
+  const date = /* @__PURE__ */ new Date(`${iso}T00:00:00Z`);
+  date.setUTCDate(date.getUTCDate() + 1);
+  return date.toISOString().slice(0, 10);
+}
+function itemBillingState(item, today) {
+  if (!item.is_active) return { status: "inactive", date: null };
+  if (item.type === "usage") return { status: "metered", date: null };
+  const start = day(item.bill_start_date) ?? today;
+  const billedTo = day(item.billed_to_date);
+  const end = day(item.bill_end_date);
+  if (item.type === "one_time") {
+    if (billedTo) return { status: "billed", date: null };
+    return start > today ? { status: "scheduled", date: start } : { status: "awaiting_run", date: null };
+  }
+  if (!billedTo) return start > today ? { status: "scheduled", date: start } : { status: "awaiting_run", date: null };
+  if (end && billedTo >= end) return { status: "fully_billed", date: billedTo };
+  if (billedTo >= today) return { status: "current", date: billedTo };
+  return { status: "due", date: nextDay(billedTo) };
+}
+export {
+  itemBillingState
+};
+//# sourceMappingURL=itemBillingState.js.map

package/dist/modules/billing/lib/itemBillingState.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/lib/itemBillingState.ts"],
+  "sourcesContent": ["/**\n * Where an item stands against today (account Items tab): has it been billed,\n * and through which date? Pure \u2014 computed from the item row and today's date.\n *\n *   inactive      the item is switched off\n *   metered       usage item (billed from usage records, no watermark)\n *   scheduled     starts after today, nothing billed yet\n *   awaiting_run  started, but no Bill Run has charged it yet\n *   billed        one-time item already charged\n *   current       recurring, charged through today or later (paid ahead)\n *   due           recurring, charged only through a past date \u2014 the next\n *                 Bill Run will charge the rest\n *   fully_billed  recurring with an end date, charged through that end\n */\n\nexport type ItemBillingStatus =\n  | 'inactive'\n  | 'metered'\n  | 'scheduled'\n  | 'awaiting_run'\n  | 'billed'\n  | 'current'\n  | 'due'\n  | 'fully_billed'\n\nexport type ItemBillingInput = {\n  type: 'one_time' | 'recurring' | 'usage'\n  is_active: boolean\n  bill_start_date: string\n  bill_end_date?: string | null\n  billed_to_date?: string | null\n}\n\nexport type ItemBillingState = {\n  status: ItemBillingStatus\n  /** The relevant date for the label: start, billed-through or due-since day (YYYY-MM-DD). */\n  date: string | null\n}\n\nfunction day(value: string | null | undefined): string | null {\n  return value ? value.slice(0, 10) : null\n}\n\nfunction nextDay(iso: string): string {\n  const date = new Date(`${iso}T00:00:00Z`)\n  date.setUTCDate(date.getUTCDate() + 1)\n  return date.toISOString().slice(0, 10)\n}\n\n/** `today` is a YYYY-MM-DD string (the viewer's calendar day). */\nexport function itemBillingState(item: ItemBillingInput, today: string): ItemBillingState {\n  if (!item.is_active) return { status: 'inactive', date: null }\n  if (item.type === 'usage') return { status: 'metered', date: null }\n  const start = day(item.bill_start_date) ?? today\n  const billedTo = day(item.billed_to_date)\n  const end = day(item.bill_end_date)\n\n  if (item.type === 'one_time') {\n    if (billedTo) return { status: 'billed', date: null }\n    return start > today ? { status: 'scheduled', date: start } : { status: 'awaiting_run', date: null }\n  }\n\n  if (!billedTo) return start > today ? { status: 'scheduled', date: start } : { status: 'awaiting_run', date: null }\n  if (end && billedTo >= end) return { status: 'fully_billed', date: billedTo }\n  if (billedTo >= today) return { status: 'current', date: billedTo }\n  return { status: 'due', date: nextDay(billedTo) }\n}\n"],
+  "mappings": "AAuCA,SAAS,IAAI,OAAiD;AAC5D,SAAO,QAAQ,MAAM,MAAM,GAAG,EAAE,IAAI;AACtC;AAEA,SAAS,QAAQ,KAAqB;AACpC,QAAM,OAAO,oBAAI,KAAK,GAAG,GAAG,YAAY;AACxC,OAAK,WAAW,KAAK,WAAW,IAAI,CAAC;AACrC,SAAO,KAAK,YAAY,EAAE,MAAM,GAAG,EAAE;AACvC;AAGO,SAAS,iBAAiB,MAAwB,OAAiC;AACxF,MAAI,CAAC,KAAK,UAAW,QAAO,EAAE,QAAQ,YAAY,MAAM,KAAK;AAC7D,MAAI,KAAK,SAAS,QAAS,QAAO,EAAE,QAAQ,WAAW,MAAM,KAAK;AAClE,QAAM,QAAQ,IAAI,KAAK,eAAe,KAAK;AAC3C,QAAM,WAAW,IAAI,KAAK,cAAc;AACxC,QAAM,MAAM,IAAI,KAAK,aAAa;AAElC,MAAI,KAAK,SAAS,YAAY;AAC5B,QAAI,SAAU,QAAO,EAAE,QAAQ,UAAU,MAAM,KAAK;AACpD,WAAO,QAAQ,QAAQ,EAAE,QAAQ,aAAa,MAAM,MAAM,IAAI,EAAE,QAAQ,gBAAgB,MAAM,KAAK;AAAA,EACrG;AAEA,MAAI,CAAC,SAAU,QAAO,QAAQ,QAAQ,EAAE,QAAQ,aAAa,MAAM,MAAM,IAAI,EAAE,QAAQ,gBAAgB,MAAM,KAAK;AAClH,MAAI,OAAO,YAAY,IAAK,QAAO,EAAE,QAAQ,gBAAgB,MAAM,SAAS;AAC5E,MAAI,YAAY,MAAO,QAAO,EAAE,QAAQ,WAAW,MAAM,SAAS;AAClE,SAAO,EAAE,QAAQ,OAAO,MAAM,QAAQ,QAAQ,EAAE;AAClD;",
+  "names": []
+}

package/dist/modules/billing/lib/itemPriceChange.js

@@ -0,0 +1,18 @@
+import { toIsoDate, toUtcMidnight } from "./dateOnly.js";
+function planPriceChange(item, effectiveDate) {
+  if (item.type !== "recurring") return { ok: false, error: "billing.item.price_change_recurring_only" };
+  if (!item.isActive || item.deletedAt) return { ok: false, error: "billing.item.price_change_inactive" };
+  const effective = toUtcMidnight(effectiveDate);
+  const start = toUtcMidnight(item.billStartDate);
+  if (effective.getTime() <= start.getTime()) return { ok: false, error: "billing.item.price_change_before_start" };
+  const end = item.billEndDate ? toUtcMidnight(item.billEndDate) : null;
+  if (end && effective.getTime() > end.getTime()) return { ok: false, error: "billing.item.price_change_after_end" };
+  const oldItemEndDate = new Date(effective);
+  oldItemEndDate.setUTCDate(oldItemEndDate.getUTCDate() - 1);
+  return { ok: true, plan: { oldItemEndDate, newItemStartDate: effective, newItemEndDate: end } };
+}
+export {
+  planPriceChange,
+  toIsoDate
+};
+//# sourceMappingURL=itemPriceChange.js.map

package/dist/modules/billing/lib/itemPriceChange.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/lib/itemPriceChange.ts"],
+  "sourcesContent": ["import { toIsoDate, toUtcMidnight } from './dateOnly'\n\n/**\n * Change the price of a recurring item from a date on (Spec F follow-up):\n * the current item ends the day before `effectiveDate`, and a copy with the\n * new price starts on `effectiveDate` and keeps the original end date.\n *\n * Nothing is billed twice: if the old item was already billed past the\n * change (in advance), the engine credits the unused days (prorate on) and\n * the new item charges them at the new price; with prorate off the old item\n * keeps them and the new item starts charging at its next full period.\n *\n * Pure \u2014 validates and computes the dates; the command does the writes.\n */\n\nexport type PriceChangeItem = {\n  type: string\n  isActive: boolean\n  deletedAt?: Date | string | null\n  billStartDate: Date | string\n  billEndDate?: Date | string | null\n}\n\nexport type PriceChangePlan = {\n  /** New end date of the current item: the day before the change. */\n  oldItemEndDate: Date\n  /** Start of the new item: the effective date. */\n  newItemStartDate: Date\n  /** The new item keeps the original end date (null = open-ended). */\n  newItemEndDate: Date | null\n}\n\nexport type PriceChangeError =\n  | 'billing.item.price_change_recurring_only'\n  | 'billing.item.price_change_inactive'\n  | 'billing.item.price_change_before_start'\n  | 'billing.item.price_change_after_end'\n\nexport function planPriceChange(\n  item: PriceChangeItem,\n  effectiveDate: Date | string,\n): { ok: true; plan: PriceChangePlan } | { ok: false; error: PriceChangeError } {\n  if (item.type !== 'recurring') return { ok: false, error: 'billing.item.price_change_recurring_only' }\n  if (!item.isActive || item.deletedAt) return { ok: false, error: 'billing.item.price_change_inactive' }\n  const effective = toUtcMidnight(effectiveDate)\n  const start = toUtcMidnight(item.billStartDate)\n  // The current item must keep at least one day.\n  if (effective.getTime() <= start.getTime()) return { ok: false, error: 'billing.item.price_change_before_start' }\n  const end = item.billEndDate ? toUtcMidnight(item.billEndDate) : null\n  if (end && effective.getTime() > end.getTime()) return { ok: false, error: 'billing.item.price_change_after_end' }\n  const oldItemEndDate = new Date(effective)\n  oldItemEndDate.setUTCDate(oldItemEndDate.getUTCDate() - 1)\n  return { ok: true, plan: { oldItemEndDate, newItemStartDate: effective, newItemEndDate: end } }\n}\n\nexport { toIsoDate }\n"],
+  "mappings": "AAAA,SAAS,WAAW,qBAAqB;AAsClC,SAAS,gBACd,MACA,eAC8E;AAC9E,MAAI,KAAK,SAAS,YAAa,QAAO,EAAE,IAAI,OAAO,OAAO,2CAA2C;AACrG,MAAI,CAAC,KAAK,YAAY,KAAK,UAAW,QAAO,EAAE,IAAI,OAAO,OAAO,qCAAqC;AACtG,QAAM,YAAY,cAAc,aAAa;AAC7C,QAAM,QAAQ,cAAc,KAAK,aAAa;AAE9C,MAAI,UAAU,QAAQ,KAAK,MAAM,QAAQ,EAAG,QAAO,EAAE,IAAI,OAAO,OAAO,yCAAyC;AAChH,QAAM,MAAM,KAAK,cAAc,cAAc,KAAK,WAAW,IAAI;AACjE,MAAI,OAAO,UAAU,QAAQ,IAAI,IAAI,QAAQ,EAAG,QAAO,EAAE,IAAI,OAAO,OAAO,sCAAsC;AACjH,QAAM,iBAAiB,IAAI,KAAK,SAAS;AACzC,iBAAe,WAAW,eAAe,WAAW,IAAI,CAAC;AACzD,SAAO,EAAE,IAAI,MAAM,MAAM,EAAE,gBAAgB,kBAAkB,WAAW,gBAAgB,IAAI,EAAE;AAChG;",
+  "names": []
+}