@lacspace/invoice 1.0.0

package/LICENSE

@@ -0,0 +1,51 @@
+Lacspace Free Licence
+Version 1.0, August 2026
+
+Copyright (c) 2026 Lacspace
+
+PREAMBLE
+
+This software is published by Lacspace under the Lacspace Free Licence — a free,
+permissive licence that lets you use this software for any purpose, including in
+commercial products and services, at no cost. It grants the same freedoms as
+common permissive open-source licences; the only condition is that this notice
+travels with the software. The canonical, always-current text of this licence is
+maintained at https://lacspace.com/licenses/lacspace-free-1.0
+
+GRANT OF RIGHTS
+
+Permission is hereby granted, free of charge, to any person or organisation
+obtaining a copy of this software and its associated documentation and data files
+(the "Software"), to deal in the Software without restriction, including without
+limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the conditions below. These rights are
+granted for any purpose, personal or commercial, and are perpetual, worldwide,
+non-exclusive, and royalty-free.
+
+CONDITIONS
+
+The above copyright notice, this permission notice, and the name of this licence
+("Lacspace Free Licence") shall be included in all copies or substantial portions
+of the Software.
+
+TRADEMARKS
+
+This licence does not grant permission to use the trade names, trademarks, service
+marks, logos, or product names of Lacspace, except as required to reproduce the
+notice above or to describe the origin of the Software in a truthful manner.
+
+DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN
+AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
+The Lacspace Free Licence is a source-available, permissive licence and is not (as
+of this version) an OSI-approved licence. In substance it grants the same freedoms
+as the MIT Licence. Learn more at https://lacspace.com/licenses

package/README.md

@@ -0,0 +1,126 @@
+<div align="center">
+
+# @lacspace/invoice
+
+**An invoice model, numbering & tax-rollup engine — pure, immutable & serializable.**
+
+[![npm version](https://img.shields.io/npm/v/@lacspace/invoice?color=%2316a34a&label=npm)](https://www.npmjs.com/package/@lacspace/invoice)
+[![minzipped](https://img.shields.io/bundlephobia/minzip/@lacspace/invoice?label=minzip)](https://bundlephobia.com/package/@lacspace/invoice)
+[![types](https://img.shields.io/badge/types-included-blue)](https://www.npmjs.com/package/@lacspace/invoice)
+[![license](https://img.shields.io/npm/l/@lacspace/invoice?color=green)](https://github.com/lacspace/npm-packages/blob/main/LICENSE)
+
+</div>
+
+> The invoicing math every billing system re-implements badly. A tiny set of **pure functions** over a plain `Invoice` object — compute per-line and total amounts, roll tax up by rate, generate sequential invoice numbers, track payments, and emit a render-ready row table. No PDF library, no floats.
+
+- 🧊 **Immutable** — payments and status transitions return a brand-new invoice; your input is never mutated
+- 💾 **Serializable** — `Invoice` is plain data, safe to `JSON.stringify` and persist
+- 🪙 **Exact money** — integer **minor units** everywhere, so tax never loses a penny
+- 🧾 **Tax rollup** — lines grouped by rate into a summary, consistent with the totals
+- 🖨️ **Render-ready** — `renderRows` hands a normalized table to `@lacspace/pdf` or `@lacspace/xlsx` — with **zero dependency** on them
+- ⚡ Isomorphic — Node, edge runtimes & browsers · 📦 ESM + CJS · fully typed · zero deps
+
+## Install
+
+```bash
+npm i @lacspace/invoice      # or pnpm add / yarn add / bun add
+```
+
+## Build an invoice
+
+```ts
+import { createInvoice, invoiceNumber } from "@lacspace/invoice";
+
+const inv = createInvoice({
+  number: invoiceNumber(1, { year: 2026 }), // "INV-2026-000001"
+  currency: "USD",
+  seller: { name: "Lacspace", taxId: "T-1" },
+  buyer: { name: "Acme Co", email: "ap@acme.test" },
+  lines: [
+    { description: "Widget", qty: 2, unitPrice: 1000, taxRate: 0.13, discount: 200 },
+    { description: "Sticker", qty: 1, unitPrice: 500, taxRate: 0 },
+  ],
+});
+
+inv.lines[0]; // { ..., net: 1800, tax: 234, total: 2034 }
+inv.totals;   // { subtotal: 2300, discount: 200, taxTotal: 234, total: 2534, amountPaid: 0, balanceDue: 2534 }
+```
+
+## Tax grouped by rate
+
+```ts
+inv.taxSummary;
+// [{ rate: 0, net: 500, tax: 0 }, { rate: 0.13, net: 1800, tax: 234 }]
+```
+
+**Rounding order:** each line's tax is rounded first (`round(net * taxRate)`), then the already-rounded per-line taxes are summed into both `taxSummary` and `totals.taxTotal` — so the summary always reconciles with the total.
+
+## Track payments — immutably
+
+```ts
+import { recordPayment } from "@lacspace/invoice";
+
+let cur = recordPayment(inv, 2000); // cur.status === "partial", balanceDue 534
+cur = recordPayment(cur, 534);      // cur.status === "paid",    balanceDue 0
+
+recordPayment(inv, 3000); // throws InvoiceError { code: "overpayment" }
+```
+
+## Status transitions & overdue
+
+```ts
+import { markIssued, markVoid, isOverdue } from "@lacspace/invoice";
+
+const issued = markIssued(inv, Date.now());
+const voided = markVoid(inv);
+isOverdue({ ...issued, dueAt: Date.now() - 1 }); // true — past due with a balance
+```
+
+## Hand it to a renderer
+
+```ts
+import { renderRows } from "@lacspace/invoice";
+
+const { columns, rows } = renderRows(inv);
+// columns: ["Description", "Qty", "Unit", "Tax %", "Line total"]
+// rows:    [["Widget", 2, 1000, 13, 2034], ["Sticker", 1, 500, 0, 500]]
+// → feed straight into @lacspace/xlsx or a PDF table builder
+```
+
+## API
+
+| Function | Description |
+| --- | --- |
+| `createInvoice(input)` | build a computed, serializable `Invoice` (lines, totals, tax summary) |
+| `recordPayment(inv, amount, opts?)` | immutable; add a payment, recompute balance, set `paid`/`partial` |
+| `markIssued(inv, at?)` | immutable transition to `issued` (throws on paid/void) |
+| `markVoid(inv)` | immutable transition to `void` (throws on paid) |
+| `isOverdue(inv, now?)` | `dueAt` in the past **and** a positive balance |
+| `invoiceNumber(seq, opts?)` | deterministic number, default `"INV-2026-000123"` |
+| `renderRows(inv)` | `{ columns, rows }` — a normalized table for PDF / XLSX |
+
+Types exported: `Party`, `InvoiceLineInput`, `InvoiceLine`, `TaxSummaryRow`, `InvoiceTotals`, `InvoiceStatus`, `Invoice`, and the `InvoiceError` class.
+
+All amounts are integer minor units; `taxRate` is a fraction (`0.13` = 13%). `net = qty * unitPrice - discount`, `tax = round(net * taxRate)`, `total = net + tax`.
+
+## Licensing
+
+This package is **free** under the **[Lacspace Free Licence](https://lacspace.com/licenses/lacspace-free-1.0)** — permissive freedoms. Use it in personal and commercial projects at no cost; just keep the notice.
+
+Not every Lacspace package is free. We also offer **Commercial** (paid), **Client-specific**, and **Private** (proprietary) packages under separate terms. See the full **[Lacspace Licence Centre](https://lacspace.com/licenses)**.
+
+<!-- LACSPACE-DEV-PLATFORM -->
+
+---
+
+## The Lacspace Developer Platform
+
+`@lacspace/invoice` is part of **63+ zero-dependency, isomorphic TypeScript packages**. Explore the ecosystem:
+
+- 🗂️ **All packages** — https://developer.lacspace.com/packages
+- 🧭 **Developer handbook** — https://developer.lacspace.com/handbook
+- 🧪 **Live playground** — https://developer.lacspace.com/playground
+- 🖥️ **Finished app templates** — https://templates.lacspace.com
+- 🚀 **Scaffold a full app** — `npm create lacspace-app@latest`
+
+Free under the **[Lacspace Free Licence](https://lacspace.com/licenses/lacspace-free-1.0)** — a permissive, free-to-use licence.

package/dist/index.cjs

@@ -0,0 +1,149 @@
+'use strict';
+
+// src/index.ts
+var InvoiceError = class _InvoiceError extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "InvoiceError";
+    this.code = code;
+    Object.setPrototypeOf(this, _InvoiceError.prototype);
+  }
+};
+function roundMinor(n) {
+  return n < 0 ? -Math.round(-n) : Math.round(n);
+}
+function computeLine(input) {
+  if (!Number.isFinite(input.qty) || input.qty < 0) {
+    throw new InvoiceError(
+      `Line "${input.description}" has a negative or invalid qty`,
+      "invalid_qty"
+    );
+  }
+  const discount = input.discount ?? 0;
+  const taxRate = input.taxRate ?? 0;
+  const net = input.qty * input.unitPrice - discount;
+  const tax = roundMinor(net * taxRate);
+  return {
+    ...input,
+    net,
+    tax,
+    total: net + tax
+  };
+}
+function summarizeTax(lines) {
+  const byRate = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    const rate = line.taxRate ?? 0;
+    const row = byRate.get(rate) ?? { rate, net: 0, tax: 0 };
+    row.net += line.net;
+    row.tax += line.tax;
+    byRate.set(rate, row);
+  }
+  return [...byRate.values()].sort((a, b) => a.rate - b.rate);
+}
+function createInvoice(input) {
+  if (!input.lines || input.lines.length === 0) {
+    throw new InvoiceError("An invoice must have at least one line", "no_lines");
+  }
+  const lines = input.lines.map(computeLine);
+  const subtotal = lines.reduce((s, l) => s + l.net, 0);
+  const discount = lines.reduce((s, l) => s + (l.discount ?? 0), 0);
+  const taxTotal = lines.reduce((s, l) => s + l.tax, 0);
+  const total = subtotal + taxTotal;
+  const amountPaid = input.amountPaid ?? 0;
+  const balanceDue = total - amountPaid;
+  const totals = {
+    subtotal,
+    discount,
+    taxTotal,
+    total,
+    amountPaid,
+    balanceDue
+  };
+  return {
+    number: input.number,
+    status: input.status ?? "draft",
+    currency: input.currency,
+    seller: input.seller,
+    buyer: input.buyer,
+    lines,
+    totals,
+    taxSummary: summarizeTax(lines),
+    issuedAt: input.issuedAt,
+    dueAt: input.dueAt,
+    notes: input.notes,
+    meta: input.meta
+  };
+}
+function recordPayment(inv, amount, opts) {
+  if (!Number.isFinite(amount) || amount <= 0) {
+    throw new InvoiceError("Payment amount must be positive", "invalid_amount");
+  }
+  const amountPaid = inv.totals.amountPaid + amount;
+  if (amountPaid > inv.totals.total) {
+    throw new InvoiceError(
+      "Payment exceeds the amount due",
+      "overpayment"
+    );
+  }
+  const balanceDue = inv.totals.total - amountPaid;
+  const status = balanceDue === 0 ? "paid" : "partial";
+  return {
+    ...inv,
+    status,
+    totals: { ...inv.totals, amountPaid, balanceDue },
+    meta: opts?.at !== void 0 ? { ...inv.meta ?? {}, lastPaymentAt: opts.at } : inv.meta
+  };
+}
+function markVoid(inv) {
+  if (inv.status === "paid") {
+    throw new InvoiceError("Cannot void a paid invoice", "already_paid");
+  }
+  return { ...inv, status: "void" };
+}
+function markIssued(inv, at) {
+  if (inv.status === "paid") {
+    throw new InvoiceError("Cannot re-issue a paid invoice", "already_paid");
+  }
+  if (inv.status === "void") {
+    throw new InvoiceError("Cannot issue a void invoice", "void");
+  }
+  return {
+    ...inv,
+    status: "issued",
+    issuedAt: at ?? inv.issuedAt
+  };
+}
+function isOverdue(inv, now = Date.now()) {
+  return inv.dueAt !== void 0 && inv.dueAt < now && inv.totals.balanceDue > 0;
+}
+function invoiceNumber(seq, opts) {
+  const prefix = opts?.prefix ?? "INV";
+  const year = opts?.year ?? (/* @__PURE__ */ new Date()).getFullYear();
+  const pad = opts?.pad ?? 6;
+  const sep = opts?.separator ?? "-";
+  const num = String(Math.trunc(seq)).padStart(pad, "0");
+  return `${prefix}${sep}${year}${sep}${num}`;
+}
+function renderRows(inv) {
+  const columns = ["Description", "Qty", "Unit", "Tax %", "Line total"];
+  const rows = inv.lines.map((l) => [
+    l.description,
+    l.qty,
+    l.unitPrice,
+    (l.taxRate ?? 0) * 100,
+    l.total
+  ]);
+  return { columns, rows };
+}
+
+exports.InvoiceError = InvoiceError;
+exports.createInvoice = createInvoice;
+exports.invoiceNumber = invoiceNumber;
+exports.isOverdue = isOverdue;
+exports.markIssued = markIssued;
+exports.markVoid = markVoid;
+exports.recordPayment = recordPayment;
+exports.renderRows = renderRows;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @lacspace/invoice\n *\n * Invoice MODEL + numbering + tax rollup. Pure, immutable, isomorphic and\n * zero-dependency. All money is expressed in integer **minor units** (e.g.\n * cents / paisa) so nothing is ever lost to floating-point drift.\n *\n * This package is model-only: it computes a structured, serializable invoice\n * and can emit a normalized row table ready to feed a renderer such as\n * `@lacspace/pdf` or `@lacspace/xlsx` — but it imports NEITHER of them.\n */\n\n// ---------------------------------------------------------------------------\n// Model\n// ---------------------------------------------------------------------------\n\n/** A billing party — the seller or the buyer on an invoice. */\nexport interface Party {\n  name: string;\n  address?: string;\n  email?: string;\n  taxId?: string;\n  meta?: Record<string, unknown>;\n}\n\n/**\n * Raw input for a single invoice line. Amounts are integer minor units;\n * `taxRate` is a fraction (e.g. `0.13` for 13%).\n */\nexport interface InvoiceLineInput {\n  description: string;\n  qty: number;\n  unitPrice: number;\n  taxRate?: number;\n  discount?: number;\n  sku?: string;\n}\n\n/**\n * A computed invoice line.\n *   net   = qty * unitPrice - discount\n *   tax   = round(net * taxRate)\n *   total = net + tax\n */\nexport interface InvoiceLine extends InvoiceLineInput {\n  net: number;\n  tax: number;\n  total: number;\n}\n\n/** One row of the tax summary: all net/tax that share a single rate. */\nexport interface TaxSummaryRow {\n  rate: number;\n  net: number;\n  tax: number;\n}\n\n/** Invoice-level money rollup, all integer minor units. */\nexport interface InvoiceTotals {\n  subtotal: number;\n  discount: number;\n  taxTotal: number;\n  total: number;\n  amountPaid: number;\n  balanceDue: number;\n}\n\nexport type InvoiceStatus =\n  | \"draft\"\n  | \"issued\"\n  | \"paid\"\n  | \"partial\"\n  | \"void\"\n  | \"overdue\";\n\n/** A complete, serializable invoice. */\nexport interface Invoice {\n  number: string;\n  status: InvoiceStatus;\n  currency: string;\n  seller: Party;\n  buyer: Party;\n  lines: InvoiceLine[];\n  totals: InvoiceTotals;\n  taxSummary: TaxSummaryRow[];\n  issuedAt?: number;\n  dueAt?: number;\n  notes?: string;\n  meta?: Record<string, unknown>;\n}\n\n/** Error thrown for any invalid invoice operation. */\nexport class InvoiceError extends Error {\n  code?: string;\n  constructor(message: string, code?: string) {\n    super(message);\n    this.name = \"InvoiceError\";\n    this.code = code;\n    // Restore prototype chain for downlevel ES targets.\n    Object.setPrototypeOf(this, InvoiceError.prototype);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/** Round to the nearest integer minor unit (half away from zero). */\nfunction roundMinor(n: number): number {\n  return n < 0 ? -Math.round(-n) : Math.round(n);\n}\n\nfunction computeLine(input: InvoiceLineInput): InvoiceLine {\n  if (!Number.isFinite(input.qty) || input.qty < 0) {\n    throw new InvoiceError(\n      `Line \"${input.description}\" has a negative or invalid qty`,\n      \"invalid_qty\",\n    );\n  }\n  const discount = input.discount ?? 0;\n  const taxRate = input.taxRate ?? 0;\n  const net = input.qty * input.unitPrice - discount;\n  const tax = roundMinor(net * taxRate);\n  return {\n    ...input,\n    net,\n    tax,\n    total: net + tax,\n  };\n}\n\n/**\n * Group computed lines into tax-summary rows by rate.\n *\n * Rounding order: each LINE's tax is rounded first (in `computeLine`), then the\n * already-rounded per-line tax amounts are summed into the summary row. Net is\n * likewise summed from per-line nets. This keeps the tax summary consistent\n * with `totals.taxTotal` (both are sums of the same rounded per-line taxes).\n */\nfunction summarizeTax(lines: InvoiceLine[]): TaxSummaryRow[] {\n  const byRate = new Map<number, TaxSummaryRow>();\n  for (const line of lines) {\n    const rate = line.taxRate ?? 0;\n    const row = byRate.get(rate) ?? { rate, net: 0, tax: 0 };\n    row.net += line.net;\n    row.tax += line.tax;\n    byRate.set(rate, row);\n  }\n  // Deterministic ascending order by rate.\n  return [...byRate.values()].sort((a, b) => a.rate - b.rate);\n}\n\n// ---------------------------------------------------------------------------\n// Build & compute\n// ---------------------------------------------------------------------------\n\n/**\n * Build a fully computed invoice from raw input.\n *\n * Computes each line (net / tax / total), the invoice totals, and the tax\n * summary grouped by rate. Integer minor units throughout.\n *\n * @throws InvoiceError when there are no lines.\n */\nexport function createInvoice(input: {\n  number: string;\n  currency: string;\n  seller: Party;\n  buyer: Party;\n  lines: InvoiceLineInput[];\n  status?: InvoiceStatus;\n  issuedAt?: number;\n  dueAt?: number;\n  amountPaid?: number;\n  notes?: string;\n  meta?: Record<string, unknown>;\n}): Invoice {\n  if (!input.lines || input.lines.length === 0) {\n    throw new InvoiceError(\"An invoice must have at least one line\", \"no_lines\");\n  }\n\n  const lines = input.lines.map(computeLine);\n\n  const subtotal = lines.reduce((s, l) => s + l.net, 0);\n  const discount = lines.reduce((s, l) => s + (l.discount ?? 0), 0);\n  const taxTotal = lines.reduce((s, l) => s + l.tax, 0);\n  const total = subtotal + taxTotal;\n  const amountPaid = input.amountPaid ?? 0;\n  const balanceDue = total - amountPaid;\n\n  const totals: InvoiceTotals = {\n    subtotal,\n    discount,\n    taxTotal,\n    total,\n    amountPaid,\n    balanceDue,\n  };\n\n  return {\n    number: input.number,\n    status: input.status ?? \"draft\",\n    currency: input.currency,\n    seller: input.seller,\n    buyer: input.buyer,\n    lines,\n    totals,\n    taxSummary: summarizeTax(lines),\n    issuedAt: input.issuedAt,\n    dueAt: input.dueAt,\n    notes: input.notes,\n    meta: input.meta,\n  };\n}\n\n/**\n * Record a payment against an invoice. Immutable — returns a new invoice.\n *\n * Increases `amountPaid`, recomputes `balanceDue`, and sets `status` to\n * `\"paid\"` (balance 0) or `\"partial\"` (balance > 0).\n *\n * @throws InvoiceError when `amount <= 0` (\"invalid_amount\") or the payment\n *   would take total paid past the invoice total (\"overpayment\").\n */\nexport function recordPayment(\n  inv: Invoice,\n  amount: number,\n  opts?: { at?: number },\n): Invoice {\n  if (!Number.isFinite(amount) || amount <= 0) {\n    throw new InvoiceError(\"Payment amount must be positive\", \"invalid_amount\");\n  }\n  const amountPaid = inv.totals.amountPaid + amount;\n  if (amountPaid > inv.totals.total) {\n    throw new InvoiceError(\n      \"Payment exceeds the amount due\",\n      \"overpayment\",\n    );\n  }\n  const balanceDue = inv.totals.total - amountPaid;\n  const status: InvoiceStatus = balanceDue === 0 ? \"paid\" : \"partial\";\n  return {\n    ...inv,\n    status,\n    totals: { ...inv.totals, amountPaid, balanceDue },\n    meta:\n      opts?.at !== undefined\n        ? { ...(inv.meta ?? {}), lastPaymentAt: opts.at }\n        : inv.meta,\n  };\n}\n\n/**\n * Transition an invoice to `\"void\"`. Immutable.\n *\n * @throws InvoiceError when the invoice is already paid (\"already_paid\").\n */\nexport function markVoid(inv: Invoice): Invoice {\n  if (inv.status === \"paid\") {\n    throw new InvoiceError(\"Cannot void a paid invoice\", \"already_paid\");\n  }\n  return { ...inv, status: \"void\" };\n}\n\n/**\n * Transition an invoice to `\"issued\"` (optionally stamping `issuedAt`).\n * Immutable.\n *\n * @throws InvoiceError when the invoice is already paid (\"already_paid\") or\n *   void (\"void\").\n */\nexport function markIssued(inv: Invoice, at?: number): Invoice {\n  if (inv.status === \"paid\") {\n    throw new InvoiceError(\"Cannot re-issue a paid invoice\", \"already_paid\");\n  }\n  if (inv.status === \"void\") {\n    throw new InvoiceError(\"Cannot issue a void invoice\", \"void\");\n  }\n  return {\n    ...inv,\n    status: \"issued\",\n    issuedAt: at ?? inv.issuedAt,\n  };\n}\n\n/**\n * Whether an invoice is overdue: it has a `dueAt` in the past and a positive\n * balance due.\n */\nexport function isOverdue(inv: Invoice, now: number = Date.now()): boolean {\n  return (\n    inv.dueAt !== undefined &&\n    inv.dueAt < now &&\n    inv.totals.balanceDue > 0\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Numbering & render helper\n// ---------------------------------------------------------------------------\n\n/**\n * Generate a deterministic sequential invoice number.\n *\n * Default shape: `\"INV-2026-000123\"` (prefix `\"INV\"`, current year, pad 6).\n */\nexport function invoiceNumber(\n  seq: number,\n  opts?: { prefix?: string; year?: number; pad?: number; separator?: string },\n): string {\n  const prefix = opts?.prefix ?? \"INV\";\n  const year = opts?.year ?? new Date().getFullYear();\n  const pad = opts?.pad ?? 6;\n  const sep = opts?.separator ?? \"-\";\n  const num = String(Math.trunc(seq)).padStart(pad, \"0\");\n  return `${prefix}${sep}${year}${sep}${num}`;\n}\n\n/**\n * Emit a normalized table from an invoice's lines, ready to hand to a renderer\n * such as `@lacspace/xlsx` or a PDF table builder. Amounts stay in integer\n * minor units — formatting is the renderer's job. No renderer is imported.\n *\n * Columns: `Description`, `Qty`, `Unit`, `Tax %`, `Line total`.\n */\nexport function renderRows(inv: Invoice): {\n  columns: string[];\n  rows: (string | number)[][];\n} {\n  const columns = [\"Description\", \"Qty\", \"Unit\", \"Tax %\", \"Line total\"];\n  const rows = inv.lines.map((l) => [\n    l.description,\n    l.qty,\n    l.unitPrice,\n    (l.taxRate ?? 0) * 100,\n    l.total,\n  ]);\n  return { columns, rows };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,154 @@
+/**
+ * @lacspace/invoice
+ *
+ * Invoice MODEL + numbering + tax rollup. Pure, immutable, isomorphic and
+ * zero-dependency. All money is expressed in integer **minor units** (e.g.
+ * cents / paisa) so nothing is ever lost to floating-point drift.
+ *
+ * This package is model-only: it computes a structured, serializable invoice
+ * and can emit a normalized row table ready to feed a renderer such as
+ * `@lacspace/pdf` or `@lacspace/xlsx` — but it imports NEITHER of them.
+ */
+/** A billing party — the seller or the buyer on an invoice. */
+interface Party {
+    name: string;
+    address?: string;
+    email?: string;
+    taxId?: string;
+    meta?: Record<string, unknown>;
+}
+/**
+ * Raw input for a single invoice line. Amounts are integer minor units;
+ * `taxRate` is a fraction (e.g. `0.13` for 13%).
+ */
+interface InvoiceLineInput {
+    description: string;
+    qty: number;
+    unitPrice: number;
+    taxRate?: number;
+    discount?: number;
+    sku?: string;
+}
+/**
+ * A computed invoice line.
+ *   net   = qty * unitPrice - discount
+ *   tax   = round(net * taxRate)
+ *   total = net + tax
+ */
+interface InvoiceLine extends InvoiceLineInput {
+    net: number;
+    tax: number;
+    total: number;
+}
+/** One row of the tax summary: all net/tax that share a single rate. */
+interface TaxSummaryRow {
+    rate: number;
+    net: number;
+    tax: number;
+}
+/** Invoice-level money rollup, all integer minor units. */
+interface InvoiceTotals {
+    subtotal: number;
+    discount: number;
+    taxTotal: number;
+    total: number;
+    amountPaid: number;
+    balanceDue: number;
+}
+type InvoiceStatus = "draft" | "issued" | "paid" | "partial" | "void" | "overdue";
+/** A complete, serializable invoice. */
+interface Invoice {
+    number: string;
+    status: InvoiceStatus;
+    currency: string;
+    seller: Party;
+    buyer: Party;
+    lines: InvoiceLine[];
+    totals: InvoiceTotals;
+    taxSummary: TaxSummaryRow[];
+    issuedAt?: number;
+    dueAt?: number;
+    notes?: string;
+    meta?: Record<string, unknown>;
+}
+/** Error thrown for any invalid invoice operation. */
+declare class InvoiceError extends Error {
+    code?: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * Build a fully computed invoice from raw input.
+ *
+ * Computes each line (net / tax / total), the invoice totals, and the tax
+ * summary grouped by rate. Integer minor units throughout.
+ *
+ * @throws InvoiceError when there are no lines.
+ */
+declare function createInvoice(input: {
+    number: string;
+    currency: string;
+    seller: Party;
+    buyer: Party;
+    lines: InvoiceLineInput[];
+    status?: InvoiceStatus;
+    issuedAt?: number;
+    dueAt?: number;
+    amountPaid?: number;
+    notes?: string;
+    meta?: Record<string, unknown>;
+}): Invoice;
+/**
+ * Record a payment against an invoice. Immutable — returns a new invoice.
+ *
+ * Increases `amountPaid`, recomputes `balanceDue`, and sets `status` to
+ * `"paid"` (balance 0) or `"partial"` (balance > 0).
+ *
+ * @throws InvoiceError when `amount <= 0` ("invalid_amount") or the payment
+ *   would take total paid past the invoice total ("overpayment").
+ */
+declare function recordPayment(inv: Invoice, amount: number, opts?: {
+    at?: number;
+}): Invoice;
+/**
+ * Transition an invoice to `"void"`. Immutable.
+ *
+ * @throws InvoiceError when the invoice is already paid ("already_paid").
+ */
+declare function markVoid(inv: Invoice): Invoice;
+/**
+ * Transition an invoice to `"issued"` (optionally stamping `issuedAt`).
+ * Immutable.
+ *
+ * @throws InvoiceError when the invoice is already paid ("already_paid") or
+ *   void ("void").
+ */
+declare function markIssued(inv: Invoice, at?: number): Invoice;
+/**
+ * Whether an invoice is overdue: it has a `dueAt` in the past and a positive
+ * balance due.
+ */
+declare function isOverdue(inv: Invoice, now?: number): boolean;
+/**
+ * Generate a deterministic sequential invoice number.
+ *
+ * Default shape: `"INV-2026-000123"` (prefix `"INV"`, current year, pad 6).
+ */
+declare function invoiceNumber(seq: number, opts?: {
+    prefix?: string;
+    year?: number;
+    pad?: number;
+    separator?: string;
+}): string;
+/**
+ * Emit a normalized table from an invoice's lines, ready to hand to a renderer
+ * such as `@lacspace/xlsx` or a PDF table builder. Amounts stay in integer
+ * minor units — formatting is the renderer's job. No renderer is imported.
+ *
+ * Columns: `Description`, `Qty`, `Unit`, `Tax %`, `Line total`.
+ */
+declare function renderRows(inv: Invoice): {
+    columns: string[];
+    rows: (string | number)[][];
+};
+
+export { type Invoice, InvoiceError, type InvoiceLine, type InvoiceLineInput, type InvoiceStatus, type InvoiceTotals, type Party, type TaxSummaryRow, createInvoice, invoiceNumber, isOverdue, markIssued, markVoid, recordPayment, renderRows };

package/dist/index.d.ts

@@ -0,0 +1,154 @@
+/**
+ * @lacspace/invoice
+ *
+ * Invoice MODEL + numbering + tax rollup. Pure, immutable, isomorphic and
+ * zero-dependency. All money is expressed in integer **minor units** (e.g.
+ * cents / paisa) so nothing is ever lost to floating-point drift.
+ *
+ * This package is model-only: it computes a structured, serializable invoice
+ * and can emit a normalized row table ready to feed a renderer such as
+ * `@lacspace/pdf` or `@lacspace/xlsx` — but it imports NEITHER of them.
+ */
+/** A billing party — the seller or the buyer on an invoice. */
+interface Party {
+    name: string;
+    address?: string;
+    email?: string;
+    taxId?: string;
+    meta?: Record<string, unknown>;
+}
+/**
+ * Raw input for a single invoice line. Amounts are integer minor units;
+ * `taxRate` is a fraction (e.g. `0.13` for 13%).
+ */
+interface InvoiceLineInput {
+    description: string;
+    qty: number;
+    unitPrice: number;
+    taxRate?: number;
+    discount?: number;
+    sku?: string;
+}
+/**
+ * A computed invoice line.
+ *   net   = qty * unitPrice - discount
+ *   tax   = round(net * taxRate)
+ *   total = net + tax
+ */
+interface InvoiceLine extends InvoiceLineInput {
+    net: number;
+    tax: number;
+    total: number;
+}
+/** One row of the tax summary: all net/tax that share a single rate. */
+interface TaxSummaryRow {
+    rate: number;
+    net: number;
+    tax: number;
+}
+/** Invoice-level money rollup, all integer minor units. */
+interface InvoiceTotals {
+    subtotal: number;
+    discount: number;
+    taxTotal: number;
+    total: number;
+    amountPaid: number;
+    balanceDue: number;
+}
+type InvoiceStatus = "draft" | "issued" | "paid" | "partial" | "void" | "overdue";
+/** A complete, serializable invoice. */
+interface Invoice {
+    number: string;
+    status: InvoiceStatus;
+    currency: string;
+    seller: Party;
+    buyer: Party;
+    lines: InvoiceLine[];
+    totals: InvoiceTotals;
+    taxSummary: TaxSummaryRow[];
+    issuedAt?: number;
+    dueAt?: number;
+    notes?: string;
+    meta?: Record<string, unknown>;
+}
+/** Error thrown for any invalid invoice operation. */
+declare class InvoiceError extends Error {
+    code?: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * Build a fully computed invoice from raw input.
+ *
+ * Computes each line (net / tax / total), the invoice totals, and the tax
+ * summary grouped by rate. Integer minor units throughout.
+ *
+ * @throws InvoiceError when there are no lines.
+ */
+declare function createInvoice(input: {
+    number: string;
+    currency: string;
+    seller: Party;
+    buyer: Party;
+    lines: InvoiceLineInput[];
+    status?: InvoiceStatus;
+    issuedAt?: number;
+    dueAt?: number;
+    amountPaid?: number;
+    notes?: string;
+    meta?: Record<string, unknown>;
+}): Invoice;
+/**
+ * Record a payment against an invoice. Immutable — returns a new invoice.
+ *
+ * Increases `amountPaid`, recomputes `balanceDue`, and sets `status` to
+ * `"paid"` (balance 0) or `"partial"` (balance > 0).
+ *
+ * @throws InvoiceError when `amount <= 0` ("invalid_amount") or the payment
+ *   would take total paid past the invoice total ("overpayment").
+ */
+declare function recordPayment(inv: Invoice, amount: number, opts?: {
+    at?: number;
+}): Invoice;
+/**
+ * Transition an invoice to `"void"`. Immutable.
+ *
+ * @throws InvoiceError when the invoice is already paid ("already_paid").
+ */
+declare function markVoid(inv: Invoice): Invoice;
+/**
+ * Transition an invoice to `"issued"` (optionally stamping `issuedAt`).
+ * Immutable.
+ *
+ * @throws InvoiceError when the invoice is already paid ("already_paid") or
+ *   void ("void").
+ */
+declare function markIssued(inv: Invoice, at?: number): Invoice;
+/**
+ * Whether an invoice is overdue: it has a `dueAt` in the past and a positive
+ * balance due.
+ */
+declare function isOverdue(inv: Invoice, now?: number): boolean;
+/**
+ * Generate a deterministic sequential invoice number.
+ *
+ * Default shape: `"INV-2026-000123"` (prefix `"INV"`, current year, pad 6).
+ */
+declare function invoiceNumber(seq: number, opts?: {
+    prefix?: string;
+    year?: number;
+    pad?: number;
+    separator?: string;
+}): string;
+/**
+ * Emit a normalized table from an invoice's lines, ready to hand to a renderer
+ * such as `@lacspace/xlsx` or a PDF table builder. Amounts stay in integer
+ * minor units — formatting is the renderer's job. No renderer is imported.
+ *
+ * Columns: `Description`, `Qty`, `Unit`, `Tax %`, `Line total`.
+ */
+declare function renderRows(inv: Invoice): {
+    columns: string[];
+    rows: (string | number)[][];
+};
+
+export { type Invoice, InvoiceError, type InvoiceLine, type InvoiceLineInput, type InvoiceStatus, type InvoiceTotals, type Party, type TaxSummaryRow, createInvoice, invoiceNumber, isOverdue, markIssued, markVoid, recordPayment, renderRows };

package/dist/index.js

@@ -0,0 +1,140 @@
+// src/index.ts
+var InvoiceError = class _InvoiceError extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "InvoiceError";
+    this.code = code;
+    Object.setPrototypeOf(this, _InvoiceError.prototype);
+  }
+};
+function roundMinor(n) {
+  return n < 0 ? -Math.round(-n) : Math.round(n);
+}
+function computeLine(input) {
+  if (!Number.isFinite(input.qty) || input.qty < 0) {
+    throw new InvoiceError(
+      `Line "${input.description}" has a negative or invalid qty`,
+      "invalid_qty"
+    );
+  }
+  const discount = input.discount ?? 0;
+  const taxRate = input.taxRate ?? 0;
+  const net = input.qty * input.unitPrice - discount;
+  const tax = roundMinor(net * taxRate);
+  return {
+    ...input,
+    net,
+    tax,
+    total: net + tax
+  };
+}
+function summarizeTax(lines) {
+  const byRate = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    const rate = line.taxRate ?? 0;
+    const row = byRate.get(rate) ?? { rate, net: 0, tax: 0 };
+    row.net += line.net;
+    row.tax += line.tax;
+    byRate.set(rate, row);
+  }
+  return [...byRate.values()].sort((a, b) => a.rate - b.rate);
+}
+function createInvoice(input) {
+  if (!input.lines || input.lines.length === 0) {
+    throw new InvoiceError("An invoice must have at least one line", "no_lines");
+  }
+  const lines = input.lines.map(computeLine);
+  const subtotal = lines.reduce((s, l) => s + l.net, 0);
+  const discount = lines.reduce((s, l) => s + (l.discount ?? 0), 0);
+  const taxTotal = lines.reduce((s, l) => s + l.tax, 0);
+  const total = subtotal + taxTotal;
+  const amountPaid = input.amountPaid ?? 0;
+  const balanceDue = total - amountPaid;
+  const totals = {
+    subtotal,
+    discount,
+    taxTotal,
+    total,
+    amountPaid,
+    balanceDue
+  };
+  return {
+    number: input.number,
+    status: input.status ?? "draft",
+    currency: input.currency,
+    seller: input.seller,
+    buyer: input.buyer,
+    lines,
+    totals,
+    taxSummary: summarizeTax(lines),
+    issuedAt: input.issuedAt,
+    dueAt: input.dueAt,
+    notes: input.notes,
+    meta: input.meta
+  };
+}
+function recordPayment(inv, amount, opts) {
+  if (!Number.isFinite(amount) || amount <= 0) {
+    throw new InvoiceError("Payment amount must be positive", "invalid_amount");
+  }
+  const amountPaid = inv.totals.amountPaid + amount;
+  if (amountPaid > inv.totals.total) {
+    throw new InvoiceError(
+      "Payment exceeds the amount due",
+      "overpayment"
+    );
+  }
+  const balanceDue = inv.totals.total - amountPaid;
+  const status = balanceDue === 0 ? "paid" : "partial";
+  return {
+    ...inv,
+    status,
+    totals: { ...inv.totals, amountPaid, balanceDue },
+    meta: opts?.at !== void 0 ? { ...inv.meta ?? {}, lastPaymentAt: opts.at } : inv.meta
+  };
+}
+function markVoid(inv) {
+  if (inv.status === "paid") {
+    throw new InvoiceError("Cannot void a paid invoice", "already_paid");
+  }
+  return { ...inv, status: "void" };
+}
+function markIssued(inv, at) {
+  if (inv.status === "paid") {
+    throw new InvoiceError("Cannot re-issue a paid invoice", "already_paid");
+  }
+  if (inv.status === "void") {
+    throw new InvoiceError("Cannot issue a void invoice", "void");
+  }
+  return {
+    ...inv,
+    status: "issued",
+    issuedAt: at ?? inv.issuedAt
+  };
+}
+function isOverdue(inv, now = Date.now()) {
+  return inv.dueAt !== void 0 && inv.dueAt < now && inv.totals.balanceDue > 0;
+}
+function invoiceNumber(seq, opts) {
+  const prefix = opts?.prefix ?? "INV";
+  const year = opts?.year ?? (/* @__PURE__ */ new Date()).getFullYear();
+  const pad = opts?.pad ?? 6;
+  const sep = opts?.separator ?? "-";
+  const num = String(Math.trunc(seq)).padStart(pad, "0");
+  return `${prefix}${sep}${year}${sep}${num}`;
+}
+function renderRows(inv) {
+  const columns = ["Description", "Qty", "Unit", "Tax %", "Line total"];
+  const rows = inv.lines.map((l) => [
+    l.description,
+    l.qty,
+    l.unitPrice,
+    (l.taxRate ?? 0) * 100,
+    l.total
+  ]);
+  return { columns, rows };
+}
+
+export { InvoiceError, createInvoice, invoiceNumber, isOverdue, markIssued, markVoid, recordPayment, renderRows };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @lacspace/invoice\n *\n * Invoice MODEL + numbering + tax rollup. Pure, immutable, isomorphic and\n * zero-dependency. All money is expressed in integer **minor units** (e.g.\n * cents / paisa) so nothing is ever lost to floating-point drift.\n *\n * This package is model-only: it computes a structured, serializable invoice\n * and can emit a normalized row table ready to feed a renderer such as\n * `@lacspace/pdf` or `@lacspace/xlsx` — but it imports NEITHER of them.\n */\n\n// ---------------------------------------------------------------------------\n// Model\n// ---------------------------------------------------------------------------\n\n/** A billing party — the seller or the buyer on an invoice. */\nexport interface Party {\n  name: string;\n  address?: string;\n  email?: string;\n  taxId?: string;\n  meta?: Record<string, unknown>;\n}\n\n/**\n * Raw input for a single invoice line. Amounts are integer minor units;\n * `taxRate` is a fraction (e.g. `0.13` for 13%).\n */\nexport interface InvoiceLineInput {\n  description: string;\n  qty: number;\n  unitPrice: number;\n  taxRate?: number;\n  discount?: number;\n  sku?: string;\n}\n\n/**\n * A computed invoice line.\n *   net   = qty * unitPrice - discount\n *   tax   = round(net * taxRate)\n *   total = net + tax\n */\nexport interface InvoiceLine extends InvoiceLineInput {\n  net: number;\n  tax: number;\n  total: number;\n}\n\n/** One row of the tax summary: all net/tax that share a single rate. */\nexport interface TaxSummaryRow {\n  rate: number;\n  net: number;\n  tax: number;\n}\n\n/** Invoice-level money rollup, all integer minor units. */\nexport interface InvoiceTotals {\n  subtotal: number;\n  discount: number;\n  taxTotal: number;\n  total: number;\n  amountPaid: number;\n  balanceDue: number;\n}\n\nexport type InvoiceStatus =\n  | \"draft\"\n  | \"issued\"\n  | \"paid\"\n  | \"partial\"\n  | \"void\"\n  | \"overdue\";\n\n/** A complete, serializable invoice. */\nexport interface Invoice {\n  number: string;\n  status: InvoiceStatus;\n  currency: string;\n  seller: Party;\n  buyer: Party;\n  lines: InvoiceLine[];\n  totals: InvoiceTotals;\n  taxSummary: TaxSummaryRow[];\n  issuedAt?: number;\n  dueAt?: number;\n  notes?: string;\n  meta?: Record<string, unknown>;\n}\n\n/** Error thrown for any invalid invoice operation. */\nexport class InvoiceError extends Error {\n  code?: string;\n  constructor(message: string, code?: string) {\n    super(message);\n    this.name = \"InvoiceError\";\n    this.code = code;\n    // Restore prototype chain for downlevel ES targets.\n    Object.setPrototypeOf(this, InvoiceError.prototype);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/** Round to the nearest integer minor unit (half away from zero). */\nfunction roundMinor(n: number): number {\n  return n < 0 ? -Math.round(-n) : Math.round(n);\n}\n\nfunction computeLine(input: InvoiceLineInput): InvoiceLine {\n  if (!Number.isFinite(input.qty) || input.qty < 0) {\n    throw new InvoiceError(\n      `Line \"${input.description}\" has a negative or invalid qty`,\n      \"invalid_qty\",\n    );\n  }\n  const discount = input.discount ?? 0;\n  const taxRate = input.taxRate ?? 0;\n  const net = input.qty * input.unitPrice - discount;\n  const tax = roundMinor(net * taxRate);\n  return {\n    ...input,\n    net,\n    tax,\n    total: net + tax,\n  };\n}\n\n/**\n * Group computed lines into tax-summary rows by rate.\n *\n * Rounding order: each LINE's tax is rounded first (in `computeLine`), then the\n * already-rounded per-line tax amounts are summed into the summary row. Net is\n * likewise summed from per-line nets. This keeps the tax summary consistent\n * with `totals.taxTotal` (both are sums of the same rounded per-line taxes).\n */\nfunction summarizeTax(lines: InvoiceLine[]): TaxSummaryRow[] {\n  const byRate = new Map<number, TaxSummaryRow>();\n  for (const line of lines) {\n    const rate = line.taxRate ?? 0;\n    const row = byRate.get(rate) ?? { rate, net: 0, tax: 0 };\n    row.net += line.net;\n    row.tax += line.tax;\n    byRate.set(rate, row);\n  }\n  // Deterministic ascending order by rate.\n  return [...byRate.values()].sort((a, b) => a.rate - b.rate);\n}\n\n// ---------------------------------------------------------------------------\n// Build & compute\n// ---------------------------------------------------------------------------\n\n/**\n * Build a fully computed invoice from raw input.\n *\n * Computes each line (net / tax / total), the invoice totals, and the tax\n * summary grouped by rate. Integer minor units throughout.\n *\n * @throws InvoiceError when there are no lines.\n */\nexport function createInvoice(input: {\n  number: string;\n  currency: string;\n  seller: Party;\n  buyer: Party;\n  lines: InvoiceLineInput[];\n  status?: InvoiceStatus;\n  issuedAt?: number;\n  dueAt?: number;\n  amountPaid?: number;\n  notes?: string;\n  meta?: Record<string, unknown>;\n}): Invoice {\n  if (!input.lines || input.lines.length === 0) {\n    throw new InvoiceError(\"An invoice must have at least one line\", \"no_lines\");\n  }\n\n  const lines = input.lines.map(computeLine);\n\n  const subtotal = lines.reduce((s, l) => s + l.net, 0);\n  const discount = lines.reduce((s, l) => s + (l.discount ?? 0), 0);\n  const taxTotal = lines.reduce((s, l) => s + l.tax, 0);\n  const total = subtotal + taxTotal;\n  const amountPaid = input.amountPaid ?? 0;\n  const balanceDue = total - amountPaid;\n\n  const totals: InvoiceTotals = {\n    subtotal,\n    discount,\n    taxTotal,\n    total,\n    amountPaid,\n    balanceDue,\n  };\n\n  return {\n    number: input.number,\n    status: input.status ?? \"draft\",\n    currency: input.currency,\n    seller: input.seller,\n    buyer: input.buyer,\n    lines,\n    totals,\n    taxSummary: summarizeTax(lines),\n    issuedAt: input.issuedAt,\n    dueAt: input.dueAt,\n    notes: input.notes,\n    meta: input.meta,\n  };\n}\n\n/**\n * Record a payment against an invoice. Immutable — returns a new invoice.\n *\n * Increases `amountPaid`, recomputes `balanceDue`, and sets `status` to\n * `\"paid\"` (balance 0) or `\"partial\"` (balance > 0).\n *\n * @throws InvoiceError when `amount <= 0` (\"invalid_amount\") or the payment\n *   would take total paid past the invoice total (\"overpayment\").\n */\nexport function recordPayment(\n  inv: Invoice,\n  amount: number,\n  opts?: { at?: number },\n): Invoice {\n  if (!Number.isFinite(amount) || amount <= 0) {\n    throw new InvoiceError(\"Payment amount must be positive\", \"invalid_amount\");\n  }\n  const amountPaid = inv.totals.amountPaid + amount;\n  if (amountPaid > inv.totals.total) {\n    throw new InvoiceError(\n      \"Payment exceeds the amount due\",\n      \"overpayment\",\n    );\n  }\n  const balanceDue = inv.totals.total - amountPaid;\n  const status: InvoiceStatus = balanceDue === 0 ? \"paid\" : \"partial\";\n  return {\n    ...inv,\n    status,\n    totals: { ...inv.totals, amountPaid, balanceDue },\n    meta:\n      opts?.at !== undefined\n        ? { ...(inv.meta ?? {}), lastPaymentAt: opts.at }\n        : inv.meta,\n  };\n}\n\n/**\n * Transition an invoice to `\"void\"`. Immutable.\n *\n * @throws InvoiceError when the invoice is already paid (\"already_paid\").\n */\nexport function markVoid(inv: Invoice): Invoice {\n  if (inv.status === \"paid\") {\n    throw new InvoiceError(\"Cannot void a paid invoice\", \"already_paid\");\n  }\n  return { ...inv, status: \"void\" };\n}\n\n/**\n * Transition an invoice to `\"issued\"` (optionally stamping `issuedAt`).\n * Immutable.\n *\n * @throws InvoiceError when the invoice is already paid (\"already_paid\") or\n *   void (\"void\").\n */\nexport function markIssued(inv: Invoice, at?: number): Invoice {\n  if (inv.status === \"paid\") {\n    throw new InvoiceError(\"Cannot re-issue a paid invoice\", \"already_paid\");\n  }\n  if (inv.status === \"void\") {\n    throw new InvoiceError(\"Cannot issue a void invoice\", \"void\");\n  }\n  return {\n    ...inv,\n    status: \"issued\",\n    issuedAt: at ?? inv.issuedAt,\n  };\n}\n\n/**\n * Whether an invoice is overdue: it has a `dueAt` in the past and a positive\n * balance due.\n */\nexport function isOverdue(inv: Invoice, now: number = Date.now()): boolean {\n  return (\n    inv.dueAt !== undefined &&\n    inv.dueAt < now &&\n    inv.totals.balanceDue > 0\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Numbering & render helper\n// ---------------------------------------------------------------------------\n\n/**\n * Generate a deterministic sequential invoice number.\n *\n * Default shape: `\"INV-2026-000123\"` (prefix `\"INV\"`, current year, pad 6).\n */\nexport function invoiceNumber(\n  seq: number,\n  opts?: { prefix?: string; year?: number; pad?: number; separator?: string },\n): string {\n  const prefix = opts?.prefix ?? \"INV\";\n  const year = opts?.year ?? new Date().getFullYear();\n  const pad = opts?.pad ?? 6;\n  const sep = opts?.separator ?? \"-\";\n  const num = String(Math.trunc(seq)).padStart(pad, \"0\");\n  return `${prefix}${sep}${year}${sep}${num}`;\n}\n\n/**\n * Emit a normalized table from an invoice's lines, ready to hand to a renderer\n * such as `@lacspace/xlsx` or a PDF table builder. Amounts stay in integer\n * minor units — formatting is the renderer's job. No renderer is imported.\n *\n * Columns: `Description`, `Qty`, `Unit`, `Tax %`, `Line total`.\n */\nexport function renderRows(inv: Invoice): {\n  columns: string[];\n  rows: (string | number)[][];\n} {\n  const columns = [\"Description\", \"Qty\", \"Unit\", \"Tax %\", \"Line total\"];\n  const rows = inv.lines.map((l) => [\n    l.description,\n    l.qty,\n    l.unitPrice,\n    (l.taxRate ?? 0) * 100,\n    l.total,\n  ]);\n  return { columns, rows };\n}\n"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@lacspace/invoice",
+  "version": "1.0.0",
+  "description": "Invoice model, numbering and tax-rollup engine — per-line and total calculation, tax grouped by rate, sequential invoice numbers, payment tracking and a render-ready row structure for PDF/XLSX. Integer minor units, zero-dependency, isomorphic.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "invoice",
+    "invoicing",
+    "billing",
+    "tax",
+    "invoice-number",
+    "accounting",
+    "ecommerce",
+    "vat",
+    "minor-units",
+    "isomorphic",
+    "typescript"
+  ],
+  "author": "Lacspace <contact@lacspace.com>",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://developer.lacspace.com/packages/invoice",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lacspace/npm-packages.git",
+    "directory": "invoice"
+  },
+  "bugs": {
+    "url": "https://github.com/lacspace/npm-packages/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {},
+  "publishConfig": {
+    "access": "public"
+  }
+}