@cogenta/commerce 0.2.0

package/dist/invoice/pdf.js

@@ -0,0 +1,449 @@
+/**
+ * An invoice rendered as a PDF, written byte by byte, with no dependency.
+ *
+ * Rule R9 asks for zero dependencies before a small one and rule R10 forbids
+ * native code, which rules out `pdfkit` (a large tree) and `puppeteer` (a
+ * browser download plus a native binary). A PDF that only has to place text on
+ * A4 in a base-14 font is a few hundred lines of byte assembly, so that is what
+ * this is.
+ *
+ * Three decisions shape the file it produces:
+ *
+ * - **Base-14 fonts only.** `/Helvetica` and `/Helvetica-Bold` are guaranteed
+ *   present in every conforming reader, so nothing is embedded and an invoice
+ *   stays a few kilobytes. The price is `WinAnsiEncoding`: one byte per glyph,
+ *   and a character outside that repertoire becomes `?` rather than a broken
+ *   file.
+ * - **No compression.** A `/FlateDecode` stream would need zlib and would make
+ *   the output unreadable to anything but a PDF parser. Uncompressed streams
+ *   keep an invoice greppable and the whole file auditable by eye.
+ * - **Deterministic to the byte.** Nothing here reads the clock or a random
+ *   source. The same document renders to the same bytes forever, so a hash
+ *   stored next to an invoice still means something a year later. `/CreationDate`
+ *   is derived from the document's own `issuedAt` or omitted entirely.
+ */
+// --- Page geometry -------------------------------------------------------
+// A4 in points, the unit PDF measures everything in (72 to the inch).
+const PAGE_WIDTH = 595;
+const PAGE_HEIGHT = 842;
+const MARGIN = 50;
+const CONTENT_WIDTH = PAGE_WIDTH - MARGIN * 2;
+const RIGHT_EDGE = MARGIN + CONTENT_WIDTH;
+/** Baseline of the first line on a page. PDF's origin is the bottom left. */
+const TOP_Y = PAGE_HEIGHT - MARGIN;
+/** Nothing is drawn below this; the footer lives underneath it. */
+const BOTTOM_Y = MARGIN + 24;
+const COLUMN_GUTTER = 6;
+/**
+ * Helvetica is proportional, so this is a deliberate approximation: a fixed
+ * measure of half an em per character. It over-estimates `l` and `i` and
+ * under-estimates `W`, which for an invoice — digits, short labels, addresses —
+ * lands close enough to wrap sensibly. The alternative is embedding the
+ * Helvetica width table, 315 numbers of accidental complexity for a table of
+ * amounts.
+ */
+const CHAR_WIDTH_RATIO = 0.5;
+const SIZE_TITLE = 20;
+const SIZE_META = 10;
+const SIZE_ROW = 9;
+const SIZE_FOOTER = 8;
+const LEAD_META = 13;
+/** Extra space between two wrapped lines inside one table cell. */
+const ROW_LEADING = 3;
+// --- Object numbering ----------------------------------------------------
+// Fixed for the first five; pages then take two objects each (the page
+// dictionary and its content stream), which is what makes the page object
+// number computable without a second pass.
+const OBJ_CATALOG = 1;
+const OBJ_PAGE_TREE = 2;
+const OBJ_FONT_REGULAR = 3;
+const OBJ_FONT_BOLD = 4;
+const OBJ_INFO = 5;
+const FIRST_PAGE_OBJECT = 6;
+/**
+ * The one entry point: a document in, a complete PDF file out.
+ *
+ * Total by design — it never throws. Every input that could be called invalid
+ * has a defined, lossless rendering instead: a row shorter than the header is
+ * padded, a row longer than the header widens the table, an unrepresentable
+ * character becomes `?`, and text too wide for its column wraps rather than
+ * being cut. An invoice is a legal document; losing a line to a validation
+ * decision taken inside a renderer would be worse than printing it oddly.
+ */
+export function renderInvoicePdf(document) {
+    return serialise(layoutDocument(document), document);
+}
+// --- Layout --------------------------------------------------------------
+function layoutDocument(document) {
+    const pages = [];
+    const startPage = () => {
+        const page = { texts: [], rules: [] };
+        pages.push(page);
+        return page;
+    };
+    let page = startPage();
+    let y = TOP_Y;
+    const write = (x, size, bold, text) => {
+        if (text !== '')
+            page.texts.push({ x, y, size, bold, text });
+    };
+    const writeRight = (right, size, bold, text) => {
+        if (text !== '')
+            page.texts.push({ x: right - measure(text, size), y, size, bold, text });
+    };
+    const rule = () => {
+        page.rules.push({ y, from: MARGIN, to: RIGHT_EDGE });
+    };
+    const breakPage = () => {
+        page = startPage();
+        y = TOP_Y;
+    };
+    // Heading. The number and the date are printed verbatim, without invented
+    // labels: the caller knows which language its customers read, this file does
+    // not, and a hard-coded "No." on a French invoice is worse than no label.
+    y -= SIZE_TITLE;
+    write(MARGIN, SIZE_TITLE, true, document.title);
+    y -= 20;
+    write(MARGIN, SIZE_META, false, document.number);
+    writeRight(RIGHT_EDGE, SIZE_META, false, document.issuedAt);
+    y -= 8;
+    rule();
+    y -= 22;
+    // Seller on the left, buyer on the right, both starting on the same line.
+    const addressTop = y;
+    const halfWidth = Math.floor(CONTENT_WIDTH / 2);
+    const writeAddress = (block, x) => {
+        y = addressTop;
+        block.forEach((line, index) => {
+            write(x, SIZE_META, index === 0, line);
+            y -= LEAD_META;
+        });
+    };
+    writeAddress(document.seller, MARGIN);
+    writeAddress(document.buyer, MARGIN + halfWidth);
+    const addressLines = Math.max(document.seller.length, document.buyer.length);
+    y = addressTop - addressLines * LEAD_META - 16;
+    // Line-item table.
+    const columnCount = Math.max(document.columns.length, ...document.lines.map((line) => line.cells.length), 0);
+    const widths = columnWidths(columnCount);
+    const offsets = columnOffsets(widths);
+    const rowHeight = (cells, size) => Math.max(1, ...cells.map((cell, index) => wrapCell(cell, widths, index, size).length)) *
+        (size + ROW_LEADING);
+    const paintRow = (cells, size, bold) => {
+        const top = y;
+        let height = size + ROW_LEADING;
+        cells.forEach((cell, index) => {
+            const width = widths[index] ?? 0;
+            const x = offsets[index] ?? MARGIN;
+            const lines = wrapCell(cell, widths, index, size);
+            // The last column carries amounts, and a column of amounts is only
+            // readable right-aligned.
+            const isLast = index === cells.length - 1 && cells.length === widths.length;
+            y = top;
+            for (const line of lines) {
+                if (isLast)
+                    writeRight(x + width - COLUMN_GUTTER, size, bold, line);
+                else
+                    write(x, size, bold, line);
+                y -= size + ROW_LEADING;
+            }
+            height = Math.max(height, lines.length * (size + ROW_LEADING));
+        });
+        y = top - height;
+    };
+    const paintHeader = () => {
+        if (columnCount === 0)
+            return;
+        paintRow(padCells(document.columns, columnCount), SIZE_ROW, true);
+        y += 2;
+        rule();
+        y -= 10;
+    };
+    if (columnCount > 0) {
+        if (y - rowHeight(padCells(document.columns, columnCount), SIZE_ROW) - 12 < BOTTOM_Y) {
+            breakPage();
+        }
+        paintHeader();
+    }
+    for (const line of document.lines) {
+        const cells = padCells(line.cells, columnCount);
+        if (y - rowHeight(cells, SIZE_ROW) < BOTTOM_Y) {
+            breakPage();
+            paintHeader();
+        }
+        paintRow(cells, SIZE_ROW, false);
+    }
+    // Totals, right-aligned in two columns of their own.
+    if (document.totals.length > 0) {
+        y -= 6;
+        if (y < BOTTOM_Y)
+            breakPage();
+        rule();
+        y -= 16;
+        document.totals.forEach(([label, amount], index) => {
+            if (y < BOTTOM_Y)
+                breakPage();
+            const bold = index === document.totals.length - 1;
+            writeRight(RIGHT_EDGE - 130, SIZE_META, bold, label);
+            writeRight(RIGHT_EDGE, SIZE_META, bold, amount);
+            y -= LEAD_META + 3;
+        });
+    }
+    // Footers last: the page count is only known once every page exists.
+    const footer = document.footer;
+    pages.forEach((target, index) => {
+        const baseline = MARGIN - 12;
+        if (footer !== undefined && footer !== '') {
+            target.texts.push({ x: MARGIN, y: baseline, size: SIZE_FOOTER, bold: false, text: footer });
+        }
+        const counter = `${index + 1} / ${pages.length}`;
+        target.texts.push({
+            x: RIGHT_EDGE - measure(counter, SIZE_FOOTER),
+            y: baseline,
+            size: SIZE_FOOTER,
+            bold: false,
+            text: counter,
+        });
+    });
+    return pages;
+}
+/**
+ * The first column gets 40 % of the width and the rest share what is left.
+ *
+ * An invoice's first column is a description and the others are quantities,
+ * unit prices and amounts — short. This is not a layout engine, and a fixed
+ * split is honest about that.
+ */
+function columnWidths(count) {
+    if (count <= 0)
+        return [];
+    if (count === 1)
+        return [CONTENT_WIDTH];
+    const first = Math.round(CONTENT_WIDTH * 0.4);
+    const other = Math.floor((CONTENT_WIDTH - first) / (count - 1));
+    return [first, ...Array.from({ length: count - 1 }, () => other)];
+}
+function columnOffsets(widths) {
+    const offsets = [];
+    let x = MARGIN;
+    for (const width of widths) {
+        offsets.push(x);
+        x += width;
+    }
+    return offsets;
+}
+function padCells(cells, count) {
+    if (cells.length >= count)
+        return cells;
+    return [...cells, ...Array.from({ length: count - cells.length }, () => '')];
+}
+function wrapCell(cell, widths, index, size) {
+    const width = widths[index] ?? CONTENT_WIDTH;
+    return wrapText(cell, width - COLUMN_GUTTER, size);
+}
+/**
+ * Wraps rather than truncates. A cut description on an invoice is a missing
+ * piece of a legal document; an ugly wrap is only ugly.
+ */
+function wrapText(text, maxWidth, size) {
+    const maxChars = Math.max(1, Math.floor(maxWidth / (size * CHAR_WIDTH_RATIO)));
+    const out = [];
+    for (const paragraph of text.split(/\r?\n/u)) {
+        let current = '';
+        for (const word of paragraph.split(' ')) {
+            for (const piece of hardSplit(word, maxChars)) {
+                if (current === '')
+                    current = piece;
+                else if (countCharacters(current) + 1 + countCharacters(piece) <= maxChars) {
+                    current = `${current} ${piece}`;
+                }
+                else {
+                    out.push(current);
+                    current = piece;
+                }
+            }
+        }
+        out.push(current);
+    }
+    return out;
+}
+/** A word wider than its column (a URL, a long SKU) is broken, never dropped. */
+function hardSplit(word, maxChars) {
+    const characters = [...word];
+    if (characters.length <= maxChars)
+        return [word];
+    const pieces = [];
+    for (let index = 0; index < characters.length; index += maxChars) {
+        pieces.push(characters.slice(index, index + maxChars).join(''));
+    }
+    return pieces;
+}
+function countCharacters(text) {
+    return [...text].length;
+}
+function measure(text, size) {
+    return countCharacters(text) * size * CHAR_WIDTH_RATIO;
+}
+// --- Text encoding -------------------------------------------------------
+/**
+ * The twenty-seven WinAnsi code points that are not Latin-1.
+ *
+ * WinAnsi (Windows-1252) agrees with Latin-1 everywhere except 0x80–0x9F,
+ * where Latin-1 has unused control codes and WinAnsi has typography — the euro
+ * sign, curly quotes, the dashes a real invoice actually contains. Without this
+ * table a euro sign silently becomes a control byte.
+ */
+const WIN_ANSI_EXTRAS = new Map([
+    [0x20ac, 0x80], // €
+    [0x201a, 0x82],
+    [0x0192, 0x83],
+    [0x201e, 0x84],
+    [0x2026, 0x85], // …
+    [0x2020, 0x86],
+    [0x2021, 0x87],
+    [0x02c6, 0x88],
+    [0x2030, 0x89],
+    [0x0160, 0x8a],
+    [0x2039, 0x8b],
+    [0x0152, 0x8c], // Œ
+    [0x017d, 0x8e],
+    [0x2018, 0x91],
+    [0x2019, 0x92], // ’
+    [0x201c, 0x93],
+    [0x201d, 0x94],
+    [0x2022, 0x95],
+    [0x2013, 0x96], // –
+    [0x2014, 0x97], // —
+    [0x02dc, 0x98],
+    [0x2122, 0x99],
+    [0x0161, 0x9a],
+    [0x203a, 0x9b],
+    [0x0153, 0x9c], // œ
+    [0x017e, 0x9e],
+    [0x0178, 0x9f],
+]);
+const QUESTION_MARK = 0x3f;
+/** One Unicode code point to the one WinAnsi byte that can carry it, or `?`. */
+function winAnsiByte(codePoint) {
+    if (codePoint === 0x09)
+        return 0x20; // A tab has no width in a PDF string.
+    if (codePoint < 0x20)
+        return QUESTION_MARK;
+    if (codePoint <= 0x7e)
+        return codePoint;
+    const extra = WIN_ANSI_EXTRAS.get(codePoint);
+    if (extra !== undefined)
+        return extra;
+    // 0x7F and 0x80–0x9F are undefined in WinAnsi; 0xA0–0xFF is Latin-1 as is.
+    if (codePoint >= 0xa0 && codePoint <= 0xff)
+        return codePoint;
+    return QUESTION_MARK;
+}
+/**
+ * A PDF string literal: WinAnsi bytes between parentheses, with the three
+ * characters that would end or nest the literal escaped.
+ *
+ * This is the single most load-bearing function in the file. A customer named
+ * `Smith (Ltd)` whose parentheses are not escaped closes the literal early and
+ * every byte after it becomes an operator — the whole document, not just that
+ * one name, stops being a PDF.
+ */
+function pdfString(text) {
+    let out = '(';
+    for (const character of text) {
+        const byte = winAnsiByte(character.codePointAt(0) ?? QUESTION_MARK);
+        if (byte === 0x28 || byte === 0x29 || byte === 0x5c)
+            out += '\\';
+        out += String.fromCharCode(byte);
+    }
+    return `${out})`;
+}
+// --- Serialisation -------------------------------------------------------
+/**
+ * The file is assembled as a string in which **every character is one byte**
+ * (`pdfString` guarantees it, and every other fragment is ASCII). That single
+ * invariant is what makes the cross-reference table correct for free: a byte
+ * offset is a string index, so no offset is ever estimated.
+ */
+function serialise(pages, document) {
+    const kids = pages.map((_, index) => `${FIRST_PAGE_OBJECT + index * 2} 0 R`).join(' ');
+    const objects = [
+        `<< /Type /Catalog /Pages ${OBJ_PAGE_TREE} 0 R >>`,
+        `<< /Type /Pages /Kids [${kids}] /Count ${pages.length} >>`,
+        '<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica /Encoding /WinAnsiEncoding >>',
+        '<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica-Bold /Encoding /WinAnsiEncoding >>',
+        infoDictionary(document),
+    ];
+    pages.forEach((page, index) => {
+        const contents = FIRST_PAGE_OBJECT + index * 2 + 1;
+        objects.push(`<< /Type /Page /Parent ${OBJ_PAGE_TREE} 0 R /MediaBox [0 0 ${PAGE_WIDTH} ${PAGE_HEIGHT}]` +
+            ` /Resources << /Font << /F1 ${OBJ_FONT_REGULAR} 0 R /F2 ${OBJ_FONT_BOLD} 0 R >> >>` +
+            ` /Contents ${contents} 0 R >>`);
+        objects.push(contentStreamObject(page));
+    });
+    // The binary comment on the second line tells every tool that has ever
+    // shipped a heuristic that this file is binary and must not be newline
+    // translated on transfer.
+    let out = '%PDF-1.4\n%âãÏÓ\n';
+    const offsets = [];
+    objects.forEach((body, index) => {
+        offsets.push(out.length);
+        out += `${index + 1} 0 obj\n${body}\nendobj\n`;
+    });
+    const xrefOffset = out.length;
+    // Entry zero is the head of the free list, and every entry is exactly twenty
+    // bytes: ten digits, a space, five digits, a space, the type, then a two-byte
+    // end of line. Readers that seek into this table by multiplication break on a
+    // nineteen-byte entry.
+    out += `xref\n0 ${objects.length + 1}\n0000000000 65535 f \n`;
+    for (const offset of offsets)
+        out += `${String(offset).padStart(10, '0')} 00000 n \n`;
+    out += `trailer\n<< /Size ${objects.length + 1} /Root ${OBJ_CATALOG} 0 R`;
+    out += ` /Info ${OBJ_INFO} 0 R >>\nstartxref\n${xrefOffset}\n%%EOF\n`;
+    return toBytes(out);
+}
+function contentStreamObject(page) {
+    let stream = '0.6 w\n';
+    for (const line of page.rules) {
+        stream += `${number(line.from)} ${number(line.y)} m ${number(line.to)} ${number(line.y)} l S\n`;
+    }
+    for (const op of page.texts) {
+        const font = op.bold ? 'F2' : 'F1';
+        stream += `BT /${font} ${number(op.size)} Tf ${number(op.x)} ${number(op.y)} Td `;
+        stream += `${pdfString(op.text)} Tj ET\n`;
+    }
+    // `/Length` counts the bytes between `stream\n` and `\nendstream`. Because
+    // one character is one byte here, that is exactly the string length.
+    return `<< /Length ${stream.length} >>\nstream\n${stream}\nendstream`;
+}
+/**
+ * `/CreationDate` is only written when `issuedAt` starts with an ISO date.
+ *
+ * Guessing at a human-formatted date with `Date.parse` would make the bytes
+ * depend on the engine's parser, and the clock is out of the question: the
+ * whole point is that regenerating an invoice yields the same file. No date at
+ * all is better than a date that moves.
+ */
+function infoDictionary(document) {
+    let info = `<< /Title ${pdfString(`${document.title} ${document.number}`)} /Producer (Cogenta)`;
+    const iso = /^(\d{4})-(\d{2})-(\d{2})/u.exec(document.issuedAt);
+    if (iso !== null)
+        info += ` /CreationDate (D:${iso[1]}${iso[2]}${iso[3]}000000Z)`;
+    return `${info} >>`;
+}
+/** Two decimals at most, and never an exponent, so the bytes never drift. */
+function number(value) {
+    return String(Math.round(value * 100) / 100);
+}
+function toBytes(text) {
+    const bytes = new Uint8Array(text.length);
+    for (let index = 0; index < text.length; index += 1) {
+        const code = text.charCodeAt(index);
+        // Defence in depth for the one-character-one-byte invariant: substituting
+        // keeps the length — and therefore every recorded offset — correct, where
+        // encoding to UTF-8 would silently shift every offset after it.
+        bytes[index] = code > 0xff ? QUESTION_MARK : code;
+    }
+    return bytes;
+}
+//# sourceMappingURL=pdf.js.map

package/dist/invoice/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.js","sourceRoot":"","sources":["../../src/invoice/pdf.ts"],"names":[],"mappings":"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"}

package/dist/invoice/store.d.ts

@@ -0,0 +1,96 @@
+import { type DatabaseHandle } from '@cogenta/core';
+import type { OrderStore } from '../order/store.js';
+import type { PdfInvoiceDocument } from './pdf.js';
+/**
+ * An invoice, and the number that makes it one.
+ *
+ * The number is the whole point of this file. A sequential, gapless,
+ * never-reused, never-editable number is an accounting obligation in most of
+ * the jurisdictions this CMS will be deployed in — not a nice-to-have, and not
+ * something to approximate with a count or a timestamp.
+ */
+export interface Invoice {
+    readonly id: string;
+    readonly orderId: string;
+    readonly series: string;
+    /** The ordinal within the series. 1, 2, 3… with no gaps. */
+    readonly seq: number;
+    /** The number a human sees and an auditor checks: `2026-000042`. */
+    readonly number: string;
+    readonly issuedAt: string;
+    readonly currency: string;
+    readonly totalMinor: number;
+    /** The frozen document. What the invoice said the day it was issued. */
+    readonly document: InvoiceDocument;
+}
+/**
+ * The snapshot stored with the invoice.
+ *
+ * Copied, never joined. An order can be refunded, a product renamed, a
+ * customer's address corrected; an invoice issued last March must still say
+ * what it said last March, because that is the copy the tax office has.
+ */
+export interface InvoiceDocument {
+    readonly number: string;
+    readonly issuedAt: string;
+    readonly orderReference: string;
+    readonly seller: readonly string[];
+    readonly buyer: readonly string[];
+    readonly currency: string;
+    readonly lines: readonly {
+        readonly sku: string;
+        readonly title: string;
+        readonly quantity: number;
+        readonly unitPriceMinor: number;
+        readonly taxRateBp: number;
+        readonly totalMinor: number;
+    }[];
+    readonly subtotalMinor: number;
+    readonly discountMinor: number;
+    readonly shippingMinor: number;
+    readonly taxMinor: number;
+    readonly totalMinor: number;
+    readonly footer: string | null;
+}
+export interface SellerDetails {
+    /** Address block, one line per string. Shown verbatim on the invoice. */
+    readonly address: readonly string[];
+    /** Legal footer: VAT number, company registration, payment terms. */
+    readonly footer?: string;
+}
+export interface IssueInvoiceInput {
+    readonly orderId: string;
+    /** Usually the year. One sequence per series, each dense in itself. */
+    readonly series?: string;
+    readonly buyerAddress?: readonly string[];
+    readonly actorId?: string | null;
+}
+export interface InvoiceStoreDependencies {
+    readonly orders: OrderStore;
+    readonly seller: SellerDetails;
+}
+export interface InvoiceStore {
+    /** Issues the invoice for an order. Exactly once, ever. */
+    issue(input: IssueInvoiceInput): Promise<Invoice>;
+    read(id: string): Promise<Invoice | null>;
+    readByOrder(orderId: string): Promise<Invoice | null>;
+    readByNumber(number: string): Promise<Invoice | null>;
+    list(options?: {
+        readonly series?: string;
+        readonly limit?: number;
+    }): Promise<readonly Invoice[]>;
+    /** The PDF for an invoice. Regenerated from the snapshot, byte-identical. */
+    pdf(id: string): Promise<Uint8Array>;
+}
+/** `2026-000042`. Zero-padded so the numbers sort as strings too. */
+export declare function formatInvoiceNumber(series: string, seq: number): string;
+export declare function createInvoiceStore(db: DatabaseHandle, dependencies: InvoiceStoreDependencies, now?: () => number): InvoiceStore;
+/**
+ * The stored snapshot, laid out for the PDF writer.
+ *
+ * A separate step on purpose: the snapshot is the record and the PDF is a
+ * rendering of it. Regenerating a PDF five years later from the same snapshot
+ * produces the same bytes, because nothing here reads a clock or a live row.
+ */
+export declare function pdfDocumentFor(document: InvoiceDocument): PdfInvoiceDocument;
+//# sourceMappingURL=store.d.ts.map

package/dist/invoice/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/invoice/store.ts"],"names":[],"mappings":"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"}