@porulle/core 0.6.0 → 0.8.0

package/dist/modules/documents/render.d.ts

@@ -0,0 +1,32 @@
+import type { HydratedOrder } from "../orders/service.js";
+import { type PdfTextOp } from "./pdf.js";
+/** Branding values read from the settings module's `branding` group. */
+export interface DocumentBranding {
+    storeName?: string;
+    receiptHeader?: string;
+    receiptFooter?: string;
+    logoUrl?: string;
+    address?: string;
+    phone?: string;
+    email?: string;
+    taxId?: string;
+}
+export interface DocumentContext {
+    order: HydratedOrder;
+    branding: DocumentBranding;
+    invoiceNumber: string;
+}
+export declare function escapeHtml(value: unknown): string;
+/** Minor units → "1,234.50 LKR". */
+export declare function formatAmount(minor: number, currency: string): string;
+/** A4-style HTML invoice with seller branding and fiscal invoice number. */
+export declare function invoiceHtml(ctx: DocumentContext): string;
+/** Narrow receipt-style HTML with the configured header/footer. */
+export declare function receiptHtml(ctx: Omit<DocumentContext, "invoiceNumber"> & {
+    invoiceNumber?: string;
+}): string;
+/**
+ * Lays an invoice out as pages of text ops for the minimal PDF writer.
+ */
+export declare function invoicePdfOps(ctx: DocumentContext): PdfTextOp[][];
+//# sourceMappingURL=render.d.ts.map

package/dist/modules/documents/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAM,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAE9C,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOjD;AAED,oCAAoC;AACpC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOpE;AAoDD,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAuBxD;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAkB5G;AAiBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,SAAS,EAAE,EAAE,CA2EjE"}

package/dist/modules/documents/render.js

@@ -0,0 +1,190 @@
+import { A4 } from "./pdf.js";
+export function escapeHtml(value) {
+    return String(value ?? "")
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+/** Minor units → "1,234.50 LKR". */
+export function formatAmount(minor, currency) {
+    const major = minor / 100;
+    const formatted = major.toLocaleString("en-US", {
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2,
+    });
+    return `${formatted} ${currency}`;
+}
+function formatDate(date) {
+    if (!date)
+        return "";
+    const d = typeof date === "string" ? new Date(date) : date;
+    return d.toISOString().slice(0, 10);
+}
+function sellerBlockHtml(branding) {
+    const lines = [
+        branding.storeName && `<strong>${escapeHtml(branding.storeName)}</strong>`,
+        branding.address && escapeHtml(branding.address),
+        branding.phone && escapeHtml(branding.phone),
+        branding.email && escapeHtml(branding.email),
+        branding.taxId && `Tax ID: ${escapeHtml(branding.taxId)}`,
+    ].filter(Boolean);
+    return lines.join("<br>");
+}
+function lineRowsHtml(order) {
+    return order.lineItems
+        .map((li) => `<tr>
+  <td>${escapeHtml(li.title)}${li.sku ? `<br><small>${escapeHtml(li.sku)}</small>` : ""}</td>
+  <td class="num">${li.quantity}</td>
+  <td class="num">${escapeHtml(formatAmount(li.unitPrice, order.currency))}</td>
+  <td class="num">${escapeHtml(formatAmount(li.totalPrice, order.currency))}</td>
+</tr>`)
+        .join("\n");
+}
+function totalsRowsHtml(order) {
+    const rows = [
+        ["Subtotal", order.subtotal],
+        ...(order.discountTotal ? [["Discount", -order.discountTotal]] : []),
+        ["Tax", order.taxTotal],
+        ...(order.shippingTotal ? [["Shipping", order.shippingTotal]] : []),
+    ];
+    const body = rows
+        .map(([label, amount]) => `<tr><td>${label}</td><td class="num">${escapeHtml(formatAmount(amount, order.currency))}</td></tr>`)
+        .join("\n");
+    return `${body}\n<tr class="grand"><td>Total</td><td class="num">${escapeHtml(formatAmount(order.grandTotal, order.currency))}</td></tr>`;
+}
+const BASE_STYLE = `body{font-family:system-ui,-apple-system,sans-serif;color:#111;margin:2rem auto;line-height:1.45}
+table{width:100%;border-collapse:collapse;margin:1rem 0}
+th,td{text-align:left;padding:.4rem .5rem;border-bottom:1px solid #ddd}
+td.num,th.num{text-align:right}
+tr.grand td{font-weight:700;border-top:2px solid #111}
+small{color:#666}`;
+/** A4-style HTML invoice with seller branding and fiscal invoice number. */
+export function invoiceHtml(ctx) {
+    const { order, branding, invoiceNumber } = ctx;
+    return `<!doctype html>
+<html><head><meta charset="utf-8"><title>Invoice ${escapeHtml(invoiceNumber)}</title>
+<style>${BASE_STYLE}
+body{max-width:48rem}</style></head>
+<body>
+<table style="border:none"><tr>
+  <td style="border:none">${sellerBlockHtml(branding)}</td>
+  <td style="border:none;text-align:right">
+    <h1 style="margin:0">INVOICE</h1>
+    <div>Invoice #: <strong>${escapeHtml(invoiceNumber)}</strong></div>
+    <div>Order #: ${escapeHtml(order.orderNumber)}</div>
+    <div>Date: ${escapeHtml(formatDate(order.placedAt))}</div>
+  </td>
+</tr></table>
+<table>
+  <thead><tr><th>Item</th><th class="num">Qty</th><th class="num">Unit</th><th class="num">Amount</th></tr></thead>
+  <tbody>${lineRowsHtml(order)}</tbody>
+</table>
+<table style="max-width:20rem;margin-left:auto"><tbody>${totalsRowsHtml(order)}</tbody></table>
+${branding.receiptFooter ? `<p><small>${escapeHtml(branding.receiptFooter)}</small></p>` : ""}
+</body></html>`;
+}
+/** Narrow receipt-style HTML with the configured header/footer. */
+export function receiptHtml(ctx) {
+    const { order, branding } = ctx;
+    return `<!doctype html>
+<html><head><meta charset="utf-8"><title>Receipt ${escapeHtml(order.orderNumber)}</title>
+<style>${BASE_STYLE}
+body{max-width:22rem;font-size:.9rem}
+h2,p.center{text-align:center}</style></head>
+<body>
+${branding.storeName ? `<h2>${escapeHtml(branding.storeName)}</h2>` : ""}
+${branding.receiptHeader ? `<p class="center">${escapeHtml(branding.receiptHeader)}</p>` : ""}
+${branding.taxId ? `<p class="center"><small>Tax ID: ${escapeHtml(branding.taxId)}</small></p>` : ""}
+<p>Order #: ${escapeHtml(order.orderNumber)}<br>Date: ${escapeHtml(formatDate(order.placedAt))}</p>
+<table>
+  <tbody>${lineRowsHtml(order)}</tbody>
+</table>
+<table><tbody>${totalsRowsHtml(order)}</tbody></table>
+${branding.receiptFooter ? `<p class="center"><small>${escapeHtml(branding.receiptFooter)}</small></p>` : ""}
+</body></html>`;
+}
+// ── PDF layout ─────────────────────────────────────────────────────────────
+const MARGIN = 50;
+const LINE_HEIGHT = 16;
+const COL = {
+    item: MARGIN,
+    qty: 380,
+    unit: 440,
+    total: 515,
+};
+function truncate(text, max) {
+    return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}
+/**
+ * Lays an invoice out as pages of text ops for the minimal PDF writer.
+ */
+export function invoicePdfOps(ctx) {
+    const { order, branding, invoiceNumber } = ctx;
+    const pages = [];
+    let ops = [];
+    let y = A4.height - MARGIN;
+    const write = (text, x, opts) => {
+        ops.push({ x, y, size: opts?.size ?? 10, bold: opts?.bold, text });
+    };
+    const newline = (lines = 1) => {
+        y -= LINE_HEIGHT * lines;
+        if (y < MARGIN + LINE_HEIGHT) {
+            pages.push(ops);
+            ops = [];
+            y = A4.height - MARGIN;
+        }
+    };
+    write("INVOICE", MARGIN, { size: 20, bold: true });
+    newline(2);
+    write(`Invoice #: ${invoiceNumber}`, MARGIN, { bold: true });
+    newline();
+    write(`Order #: ${order.orderNumber}`, MARGIN);
+    newline();
+    write(`Date: ${formatDate(order.placedAt)}`, MARGIN);
+    newline(2);
+    const seller = [
+        branding.storeName,
+        branding.address,
+        branding.phone,
+        branding.email,
+        branding.taxId ? `Tax ID: ${branding.taxId}` : undefined,
+    ].filter((v) => Boolean(v));
+    for (const [i, line] of seller.entries()) {
+        write(line, MARGIN, { bold: i === 0 });
+        newline();
+    }
+    newline();
+    write("Item", COL.item, { bold: true });
+    write("Qty", COL.qty, { bold: true });
+    write("Unit", COL.unit, { bold: true });
+    write("Amount", COL.total, { bold: true });
+    newline();
+    for (const li of order.lineItems) {
+        write(truncate(li.title, 52), COL.item);
+        write(String(li.quantity), COL.qty);
+        write(formatAmount(li.unitPrice, order.currency), COL.unit);
+        write(formatAmount(li.totalPrice, order.currency), COL.total);
+        newline();
+    }
+    newline();
+    const totals = [
+        ["Subtotal", order.subtotal],
+        ...(order.discountTotal ? [["Discount", -order.discountTotal]] : []),
+        ["Tax", order.taxTotal],
+        ...(order.shippingTotal ? [["Shipping", order.shippingTotal]] : []),
+        ["Total", order.grandTotal, true],
+    ];
+    for (const [label, amount, bold] of totals) {
+        write(label, COL.qty, { bold });
+        write(formatAmount(amount, order.currency), COL.total, { bold });
+        newline();
+    }
+    if (branding.receiptFooter) {
+        newline();
+        write(branding.receiptFooter, MARGIN, { size: 8 });
+    }
+    pages.push(ops);
+    return pages;
+}

package/dist/modules/documents/repository/index.d.ts

@@ -0,0 +1,25 @@
+import type { TxContext } from "../../../kernel/database/tx-context.js";
+import type { DrizzleDatabase } from "../../../kernel/database/drizzle-db.js";
+import { orderDocuments } from "../schema.js";
+export type OrderDocument = typeof orderDocuments.$inferSelect;
+/**
+ * Persistence for fiscal sequences and issued documents (issue #47).
+ */
+export declare class DocumentsRepository {
+    private readonly db;
+    constructor(db: DrizzleDatabase);
+    private getDb;
+    /**
+     * Atomically allocates the next sequence value for (org, series).
+     * Single upsert-returning statement — safe under concurrency.
+     */
+    allocate(orgId: string, series: string, ctx?: TxContext): Promise<number>;
+    findDocument(orgId: string, orderId: string, type: string, ctx?: TxContext): Promise<OrderDocument | undefined>;
+    createDocument(data: {
+        organizationId: string;
+        orderId: string;
+        type: string;
+        documentNumber: string;
+    }, ctx?: TxContext): Promise<OrderDocument>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/documents/repository/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/documents/repository/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAoB,cAAc,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,YAAY,CAAC;AAE/D;;GAEG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,eAAe;IAEhD,OAAO,CAAC,KAAK;IAIb;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBzE,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAa/B,cAAc,CAClB,IAAI,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,EACvF,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,aAAa,CAAC;CAK1B"}

package/dist/modules/documents/repository/index.js

@@ -0,0 +1,47 @@
+import { and, eq, sql } from "drizzle-orm";
+import { invoiceSequences, orderDocuments } from "../schema.js";
+/**
+ * Persistence for fiscal sequences and issued documents (issue #47).
+ */
+export class DocumentsRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    getDb(ctx) {
+        return ctx?.tx ?? this.db;
+    }
+    /**
+     * Atomically allocates the next sequence value for (org, series).
+     * Single upsert-returning statement — safe under concurrency.
+     */
+    async allocate(orgId, series, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .insert(invoiceSequences)
+            .values({ organizationId: orgId, series, nextValue: 2 })
+            .onConflictDoUpdate({
+            target: [invoiceSequences.organizationId, invoiceSequences.series],
+            set: {
+                nextValue: sql `${invoiceSequences.nextValue} + 1`,
+                updatedAt: new Date(),
+            },
+        })
+            .returning({ nextValue: invoiceSequences.nextValue });
+        // nextValue is post-increment; the allocated number is one less.
+        return rows[0].nextValue - 1;
+    }
+    async findDocument(orgId, orderId, type, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .select()
+            .from(orderDocuments)
+            .where(and(eq(orderDocuments.organizationId, orgId), eq(orderDocuments.orderId, orderId), eq(orderDocuments.type, type)));
+        return rows[0];
+    }
+    async createDocument(data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.insert(orderDocuments).values(data).returning();
+        return rows[0];
+    }
+}

package/dist/modules/documents/schema.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Fiscal document sequences (issue #47).
+ *
+ * Per-(org, series) counters for legally sequential invoice numbers.
+ * Allocation is a single atomic upsert-returning statement, so concurrent
+ * requests never observe the same value.
+ */
+export declare const invoiceSequences: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "invoice_sequences";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "invoice_sequences";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        organizationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "organization_id";
+            tableName: "invoice_sequences";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        series: import("drizzle-orm/pg-core").PgColumn<{
+            name: "series";
+            tableName: "invoice_sequences";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        nextValue: import("drizzle-orm/pg-core").PgColumn<{
+            name: "next_value";
+            tableName: "invoice_sequences";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "invoice_sequences";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+/**
+ * Issued documents (issue #47). One row per (org, order, type) — re-rendering
+ * an order's invoice returns the number issued the first time, so a fiscal
+ * number never changes once handed out.
+ */
+export declare const orderDocuments: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "order_documents";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "order_documents";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        organizationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "organization_id";
+            tableName: "order_documents";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        orderId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "order_id";
+            tableName: "order_documents";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        type: import("drizzle-orm/pg-core").PgColumn<{
+            name: "type";
+            tableName: "order_documents";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        documentNumber: import("drizzle-orm/pg-core").PgColumn<{
+            name: "document_number";
+            tableName: "order_documents";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "order_documents";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/modules/documents/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/schema.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW1B,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcxB,CAAC"}

package/dist/modules/documents/schema.js

@@ -0,0 +1,42 @@
+import { index, integer, pgTable, text, timestamp, uniqueIndex, uuid } from "drizzle-orm/pg-core";
+import { organization } from "../../auth/auth-schema.js";
+import { orders } from "../orders/schema.js";
+/**
+ * Fiscal document sequences (issue #47).
+ *
+ * Per-(org, series) counters for legally sequential invoice numbers.
+ * Allocation is a single atomic upsert-returning statement, so concurrent
+ * requests never observe the same value.
+ */
+export const invoiceSequences = pgTable("invoice_sequences", {
+    id: uuid("id").defaultRandom().primaryKey(),
+    organizationId: text("organization_id")
+        .notNull()
+        .references(() => organization.id, { onDelete: "cascade" }),
+    series: text("series").notNull().default("default"),
+    // The NEXT value to hand out; allocation returns the pre-increment value.
+    nextValue: integer("next_value").notNull().default(1),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull(),
+}, (table) => ({
+    orgSeriesUnique: uniqueIndex("invoice_sequences_org_series_unique").on(table.organizationId, table.series),
+}));
+/**
+ * Issued documents (issue #47). One row per (org, order, type) — re-rendering
+ * an order's invoice returns the number issued the first time, so a fiscal
+ * number never changes once handed out.
+ */
+export const orderDocuments = pgTable("order_documents", {
+    id: uuid("id").defaultRandom().primaryKey(),
+    organizationId: text("organization_id")
+        .notNull()
+        .references(() => organization.id, { onDelete: "cascade" }),
+    orderId: uuid("order_id")
+        .notNull()
+        .references(() => orders.id, { onDelete: "cascade" }),
+    type: text("type").notNull(), // "invoice" | "receipt"
+    documentNumber: text("document_number").notNull(),
+    createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
+}, (table) => ({
+    orgOrderTypeUnique: uniqueIndex("order_documents_org_order_type_unique").on(table.organizationId, table.orderId, table.type),
+    orgIdx: index("idx_order_documents_org").on(table.organizationId),
+}));

package/dist/modules/documents/service.d.ts

@@ -0,0 +1,51 @@
+import type { Actor } from "../../auth/types.js";
+import type { TxContext } from "../../kernel/database/tx-context.js";
+import { type Result } from "../../kernel/result.js";
+import type { HydratedOrder } from "../orders/service.js";
+import type { DocumentsRepository, OrderDocument } from "./repository/index.js";
+interface DocumentsServiceDeps {
+    repository: DocumentsRepository;
+    services: Record<string, unknown>;
+}
+/**
+ * Order document rendering + fiscal numbering (issue #47).
+ */
+export declare class DocumentsService {
+    private repository;
+    private services;
+    constructor(deps: DocumentsServiceDeps);
+    private get orders();
+    private get settings();
+    private brandingFor;
+    /**
+     * Issues (or returns the previously issued) fiscal invoice number for an
+     * order. Idempotent per (org, order): once handed out, the number never
+     * changes. Sequence allocation is atomic; a lost creation race falls back
+     * to the winner's document.
+     */
+    issueInvoiceNumber(order: HydratedOrder, ctx?: TxContext): Promise<OrderDocument>;
+    private loadOrder;
+    renderInvoiceHtml(orderId: string, actor: Actor | null, ctx?: TxContext): Promise<Result<{
+        html: string;
+        invoiceNumber: string;
+    }>>;
+    renderInvoicePdf(orderId: string, actor: Actor | null, ctx?: TxContext): Promise<Result<{
+        pdf: Uint8Array;
+        invoiceNumber: string;
+    }>>;
+    renderReceiptHtml(orderId: string, actor: Actor | null, ctx?: TxContext): Promise<Result<{
+        html: string;
+    }>>;
+    /**
+     * Emails the invoice via the configured email adapter. The adapter's
+     * template contract is (template, to, data) — the rendered HTML and the
+     * fiscal number ride in `data` so template-based adapters can use either.
+     */
+    emailInvoice(orderId: string, to: string, actor: Actor | null, ctx?: TxContext): Promise<Result<{
+        sent: true;
+        invoiceNumber: string;
+        to: string;
+    }>>;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/modules/documents/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,sBAAsB,CAAC;AASxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEhF,UAAU,oBAAoB;IAC5B,UAAU,EAAE,mBAAmB,CAAC;IAGhC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAQD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,IAAI,EAAE,oBAAoB;IAKtC,OAAO,KAAK,MAAM,GAEjB;IAED,OAAO,KAAK,QAAQ,GAEnB;YAEa,WAAW;IAIzB;;;;;OAKG;IACG,kBAAkB,CACtB,KAAK,EAAE,aAAa,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,aAAa,CAAC;YA0BX,SAAS;IAQjB,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAWrD,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC;QAAE,GAAG,EAAE,UAAU,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAaxD,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAOpC;;;;OAIG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CA0BtE"}