@endora-commerce/mod-invoices 0.0.0-stage → 0.100.0

package/dist/backend/plugin.d.ts

@@ -0,0 +1,124 @@
+import type { FastifyInstance, FastifyRequest } from 'fastify';
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { AssetReadPort, AssetsLibraryPort, InvoiceAttachmentFetchPort, OrderReadPort, OrderRecord, TransactionalEmailSender } from '@endora-commerce/contracts';
+import { InvoiceService, type InvoiceAuditRecorder } from './services/invoice-service.js';
+import type { LedgerNumberingLookup } from './services/vendor-number-hold.js';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import { InvoicePdfRenderer } from './services/invoice-pdf-renderer.js';
+import type { InvoicePdfBlockRegistry } from './services/invoice-pdf-block-registry.js';
+import type { LoadAssetImage } from './pdf-components/embed-logo-images.js';
+import { InvoiceNumberGenerator } from './services/invoice-number-generator.js';
+import { type SettingsReader } from './services/seller-settings.js';
+import { InvoiceEmailDispatcher } from './services/invoice-email-dispatch.js';
+import { InvoiceTemplateService } from './services/invoice-template-service.js';
+import { createAutoIssueReactor } from './services/auto-issue-reactor.js';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+/**
+ * The attach function this module hands its composition root.
+ *
+ * Typed on `fastify`'s own `FastifyInstance` rather than on the platform's
+ * `ModulePlugin`, which `contracts/host-package.md` §1.4g classifies **A**: the
+ * host does not publish it, so a packaged module cannot name it. The
+ * already-packaged `quote_requests` types its attach function the same way.
+ */
+type ModuleAttach = (app: FastifyInstance) => Promise<void>;
+/**
+ * Minimal event-bus surface this module needs. Emission only: the FR-002
+ * subscription moved to `backend.ts` and `ctx.subscribe` (issue #107), so this
+ * no longer carries `on`.
+ */
+export interface InvoicesEventBus {
+    /** Present on the real EventBus — used to emit invoice.issued/corrected.v1 (feature 059). */
+    emit?(eventName: string, payload: {
+        eventId: string;
+        occurredAt: string;
+    }): void;
+}
+export interface InvoicesModuleOptions {
+    emFactory: () => EntityManager;
+    /**
+     * `orders`' published read model (feature 075, Phase C). Not optional: an
+     * invoice is a document *about an order*, so a module that cannot read one
+     * has nothing to issue. Every read of the order rows used to be
+     * `em.findOne(Order, …)` from inside this module — a query no gate can see,
+     * so an invoice went on being issued against a module an operator had
+     * switched off.
+     */
+    orderReadPort: OrderReadPort;
+    assetReadPort: AssetReadPort;
+    assetsLibrary: AssetsLibraryPort;
+    saleDocumentAttachments: InvoiceAttachmentFetchPort;
+    requireAdmin: RequireAdminFactory;
+    requireCustomer: (req: FastifyRequest, reply: unknown) => Promise<void>;
+    settingsService: SettingsReader;
+    /**
+     * The five that stopped being optional in
+     * `specs/110-instance-repository/` T118c.
+     *
+     * Each was a member of the contributed `invoicesBridge` and each was declared
+     * `?`, which was true of the *contribution* and never of the module: this
+     * module resolves all five itself now — the platform's two actor resolvers,
+     * `transactional_emails`' sender accessor, `customer_accounts`' record and a
+     * read of the channel — so no composition can decline to supply one. An
+     * option that is nonetheless typed as omittable is a branch no test can
+     * drive, which is what `loadAssetImage` was until D-223 and what the
+     * e-mail trio still is: `emailDispatcher` was built only when all three were
+     * present, so a composition that dropped one silently stopped sending
+     * invoices and answered `no_sender`.
+     */
+    resolveAdminUserId: (req: FastifyRequest) => string | null;
+    resolveCustomerContext: (req: FastifyRequest) => {
+        customerAccountId: string;
+        organizationId: string;
+    };
+    /** US5 — transactional email sender (late-bound). */
+    getTransactionalEmailSender: () => TransactionalEmailSender | undefined;
+    /** US5 — recipient email for an order (customer account email). */
+    resolveRecipientEmail: (order: OrderRecord) => Promise<string | null>;
+    /** US5 — channel default language (BCP-47). */
+    resolveLanguage: (salesChannelId: string | null) => Promise<string>;
+    /** Feature 059 — emits `invoice.issued.v1` / `invoice.corrected.v1`. */
+    eventBus?: InvoicesEventBus;
+    /** FR-035 — audit-log recorder for issuance / correction. */
+    audit?: InvoiceAuditRecorder;
+    /** Feature 054 — full audit sink for invoice-template writes (co-transactional). */
+    auditLog?: AuditPort;
+    /**
+     * Load image bytes for InvoiceLogo from the Assets Library (avoids pdfmake
+     * self-fetching `/assets/file/:id` during Preview PDF).
+     */
+    loadAssetImage: LoadAssetImage;
+    /** Mode B wait. Absent ledger degrades to today's ready path. */
+    ledgerRouting?: LedgerNumberingLookup;
+    /**
+     * The blocks other modules render onto the PDF (`specs/134-paid-module-extraction/`
+     * T063/T126) — this module's own `invoicePdfBlockRegistry`, which contributors
+     * push into from their composition roots.
+     */
+    pdfBlocks: InvoicePdfBlockRegistry;
+}
+export interface InvoicesModuleHandle {
+    /** FR-002 reactor; `backend.ts` owns its subscription. */
+    autoIssueReactor: ReturnType<typeof createAutoIssueReactor>;
+    invoiceService: InvoiceService;
+    pdfRenderer: InvoicePdfRenderer;
+    numberGenerator: InvoiceNumberGenerator;
+    templateService: InvoiceTemplateService;
+    emailDispatcher: InvoiceEmailDispatcher;
+    /**
+     * The logo loader this module resolved for itself (T118c).
+     *
+     * On the handle because that is the only place the *composed* value is
+     * observable: the renderer holds it privately, and a test asserting it
+     * through a rendered PDF would be asserting pdfmake. D-223's survey found it
+     * supplied by one root and omitted by the other, so what this exposes is the
+     * exact thing that went unnoticed.
+     */
+    loadAssetImage: LoadAssetImage;
+}
+export declare function invoicesModule(options: InvoicesModuleOptions): {
+    handle: InvoicesModuleHandle;
+    plugin: ModuleAttach;
+};
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/backend/plugin.d.ts.map

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

package/dist/backend/plugin.js

@@ -0,0 +1,87 @@
+import { InvoiceService } from './services/invoice-service.js';
+import { InvoicePdfRenderer } from './services/invoice-pdf-renderer.js';
+import { InvoiceNumberGenerator, createSettingsPatternResolver } from './services/invoice-number-generator.js';
+import { SellerSettingsResolver } from './services/seller-settings.js';
+import { InvoiceEmailDispatcher } from './services/invoice-email-dispatch.js';
+import { InvoiceTemplateService } from './services/invoice-template-service.js';
+import { createAutoIssueReactor } from './services/auto-issue-reactor.js';
+import { registerInvoicesAdminRoutes } from './routes.admin.js';
+import { registerInvoicesCustomerRoutes } from './routes.customer.js';
+export function invoicesModule(options) {
+    const numberGenerator = new InvoiceNumberGenerator(createSettingsPatternResolver(options.settingsService));
+    const sellerSettings = new SellerSettingsResolver(options.settingsService);
+    const emailOnReadyHolder = {};
+    const invoiceService = new InvoiceService(options.emFactory, options.orderReadPort, numberGenerator, sellerSettings, options.audit, options.eventBus?.emit
+        ? {
+            emit: (eventName, payload) => options.eventBus.emit(eventName, payload),
+        }
+        : undefined, async (invoiceId) => {
+        await emailOnReadyHolder.dispatch?.(invoiceId);
+    }, options.ledgerRouting);
+    const pdfRenderer = new InvoicePdfRenderer({
+        loadAssetImage: options.loadAssetImage,
+        blocks: options.pdfBlocks,
+    });
+    const templateService = new InvoiceTemplateService(options.emFactory, options.auditLog);
+    // T118c — built unconditionally. The three inputs used to be optional bridge
+    // members, so a composition that supplied two of the three got no dispatcher
+    // at all and every issued invoice answered `not_sent` / `no_sender` — a
+    // plausible-looking outcome rather than a visible failure. The module
+    // resolves all three itself now and there is nothing left to be absent.
+    const emailDispatcher = new InvoiceEmailDispatcher({
+        orderReadPort: options.orderReadPort,
+        invoiceService,
+        pdfRenderer,
+        settingsService: options.settingsService,
+        getSender: options.getTransactionalEmailSender,
+        resolveRecipientEmail: options.resolveRecipientEmail,
+        resolveLanguage: options.resolveLanguage,
+    });
+    emailOnReadyHolder.dispatch = async (invoiceId) => {
+        await emailDispatcher.dispatch(invoiceId);
+    };
+    // FR-002 — the auto-issue reactor. `backend.ts` registers it through
+    // `ctx.subscribe`, so a switched-off module issues nothing.
+    const autoIssueReactor = createAutoIssueReactor({
+        emFactory: options.emFactory,
+        invoiceService,
+        settingsService: options.settingsService,
+        emailDispatcher,
+    });
+    const handle = {
+        autoIssueReactor,
+        invoiceService,
+        pdfRenderer,
+        numberGenerator,
+        templateService,
+        emailDispatcher,
+        loadAssetImage: options.loadAssetImage,
+    };
+    const plugin = async (app) => {
+        // Seed the system generic template once (idempotent).
+        await templateService.ensureGenericSeed().catch(() => undefined);
+        await registerInvoicesAdminRoutes(app, {
+            emFactory: options.emFactory,
+            orderReadPort: options.orderReadPort,
+            requireAdmin: options.requireAdmin,
+            invoiceService,
+            pdfRenderer,
+            templateService,
+            emailDispatcher,
+            resolveAdminUserId: options.resolveAdminUserId,
+        });
+        await registerInvoicesCustomerRoutes(app, {
+            emFactory: options.emFactory,
+            orderReadPort: options.orderReadPort,
+            assetsLibrary: options.assetsLibrary,
+            saleDocumentAttachments: options.saleDocumentAttachments,
+            requireCustomer: options.requireCustomer,
+            resolveCustomerContext: options.resolveCustomerContext,
+            invoiceService,
+            pdfRenderer,
+            templateService,
+        });
+    };
+    return { handle, plugin };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/backend/plugin.js.map

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

package/dist/backend/routes.admin.d.ts

@@ -0,0 +1,41 @@
+import type { FastifyInstance, FastifyRequest } from 'fastify';
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type OrderReadPort } from '@endora-commerce/contracts';
+import type { InvoiceService } from './services/invoice-service.js';
+import type { InvoicePdfRenderer } from './services/invoice-pdf-renderer.js';
+import type { InvoiceTemplateService } from './services/invoice-template-service.js';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import type { InvoiceEmailDispatchResult } from './services/invoice-email-dispatch.js';
+/** Minimal email-dispatch seam — implemented by the US5 dispatcher. */
+export interface InvoiceEmailDispatcher {
+    dispatch(invoiceId: string, opts?: {
+        mode?: 'attachment' | 'link';
+        messageId?: string;
+    }): Promise<InvoiceEmailDispatchResult>;
+    sendOnIssueEnabled(salesChannelId: string | null): Promise<boolean>;
+}
+/**
+ * Admin invoice routes (feature 047). Browse/list, view detail, download the
+ * PDF (rendered on demand), issue an invoice/proforma for an order, regenerate
+ * the PDF, and (re)send the invoice email.
+ */
+export interface InvoicesAdminDeps {
+    emFactory: () => EntityManager;
+    /** `orders`' published read model (feature 075, Phase C). */
+    orderReadPort: OrderReadPort;
+    requireAdmin: RequireAdminFactory;
+    invoiceService: InvoiceService;
+    pdfRenderer: InvoicePdfRenderer;
+    templateService: InvoiceTemplateService;
+    /**
+     * T118c — required, both of them. Each was optional because the *bridge*
+     * member behind it was, and a composition that omitted one got a route that
+     * silently did less: no dispatcher meant every issue answered
+     * `not_sent` / `no_sender`, and no resolver meant every invoice was recorded
+     * as issued by nobody. The module resolves both itself now.
+     */
+    emailDispatcher: InvoiceEmailDispatcher;
+    resolveAdminUserId: (req: FastifyRequest) => string | null;
+}
+export declare function registerInvoicesAdminRoutes(app: FastifyInstance, deps: InvoicesAdminDeps): Promise<void>;
+//# sourceMappingURL=routes.admin.d.ts.map

package/dist/backend/routes.admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.admin.d.ts","sourceRoot":"","sources":["../../src/backend/routes.admin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAIrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1D,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvC,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,6DAA6D;IAC7D,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,mBAAmB,CAAC;IAClC,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,kBAAkB,CAAC;IAChC,eAAe,EAAE,sBAAsB,CAAC;IACxC;;;;;;OAMG;IACH,eAAe,EAAE,sBAAsB,CAAC;IACxC,kBAAkB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,MAAM,GAAG,IAAI,CAAC;CAC5D;AAID,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CA4Of"}

package/dist/backend/routes.admin.js

@@ -0,0 +1,219 @@
+import { issueInvoiceRequestSchema, sendInvoiceEmailRequestSchema, } from '@endora-commerce/contracts';
+import { Invoice } from './entities/invoice.entity.js';
+import { isOrgInScope } from '@endora-commerce/platform/tenancy';
+import { z } from 'zod';
+import { invoicePageBuilderDescriptor } from './pdf-components/descriptor.js';
+import { sampleInvoiceDetail } from './pdf-components/sample.js';
+import { pickLanguageTree } from './pdf-components/tree-mapper.js';
+const RENDER_LANGUAGE = 'pl-PL';
+export async function registerInvoicesAdminRoutes(app, deps) {
+    const { emFactory, orderReadPort, requireAdmin, invoiceService, pdfRenderer, templateService } = deps;
+    // List ------------------------------------------------------------------
+    app.get('/api/v1/admin/invoices', { preHandler: requireAdmin('invoices:read') }, async (request) => {
+        const q = (request.query ?? {});
+        const where = {};
+        if (q['filter[status]'])
+            where['status'] = q['filter[status]'];
+        if (q['filter[orderId]'])
+            where['orderId'] = q['filter[orderId]'];
+        if (q['filter[kind]'])
+            where['kind'] = q['filter[kind]'];
+        if (q['filter[salesChannelId]'])
+            where['salesChannelId'] = q['filter[salesChannelId]'];
+        const issuedAt = {};
+        if (q['filter[issuedFrom]'])
+            issuedAt['$gte'] = new Date(q['filter[issuedFrom]']);
+        if (q['filter[issuedTo]'])
+            issuedAt['$lte'] = new Date(q['filter[issuedTo]']);
+        if (Object.keys(issuedAt).length)
+            where['issuedAt'] = issuedAt;
+        const total = {};
+        if (q['filter[totalMin]'] && Number.isFinite(Number(q['filter[totalMin]'])))
+            total['$gte'] = Number(q['filter[totalMin]']);
+        if (q['filter[totalMax]'] && Number.isFinite(Number(q['filter[totalMax]'])))
+            total['$lte'] = Number(q['filter[totalMax]']);
+        if (Object.keys(total).length)
+            where['total'] = total;
+        const em = emFactory();
+        // Filter by order number (business id): resolve matching orders first,
+        // then constrain invoices to those order ids. A no-match short-circuits.
+        //
+        // Feature 080, T048 (D-169) — the lookup is `orders`' own search now. It
+        // was `em.find(Order, { businessId: { $ilike } }, { limit: 500 })` here,
+        // a plain read of that module's table, so it takes a read-port method and
+        // not an `EntityManager`-taking apply port. The short-circuit is what
+        // made it worth cutting: an absent `orders` used to answer "no invoice
+        // for that order number" out of a table nobody was serving.
+        const orderNumber = q['filter[orderNumber]']?.trim();
+        if (orderNumber) {
+            const matchingOrderIds = await orderReadPort.findIdsByBusinessIdLike(orderNumber, 500);
+            if (matchingOrderIds.length === 0) {
+                return { data: [], pagination: { cursor: null, hasMore: false, limit: 0 } };
+            }
+            where['orderId'] = { $in: matchingOrderIds };
+        }
+        const limit = Math.min(Math.max(Number.parseInt(q['limit'] ?? '50', 10), 1), 200);
+        const rows = await em.find(Invoice, where, { orderBy: { issuedAt: 'desc' }, limit });
+        const orderIds = [
+            ...new Set(rows.map((r) => r.orderId).filter((id) => id != null)),
+        ];
+        // Feature 075, Phase C — the order number and the owning organisation are
+        // `orders`' fields, read over its port rather than out of its table.
+        const orders = await orderReadPort.findByIds(orderIds);
+        const byOrder = new Map(orders.map((o) => [o.id, o.businessId]));
+        const orgByOrder = new Map(orders.map((o) => [o.id, o.organizationId]));
+        // Feature 050 — Invoice is transitively scoped via its Order's org; hide
+        // invoices whose order is out of the ambient tenant scope. ERP-imported
+        // rows without an order scope directly on `organizationId` (feature 119).
+        const scoped = rows.filter((i) => i.origin === 'erp_import'
+            ? isOrgInScope(i.organizationId ?? '')
+            : isOrgInScope(orgByOrder.get(i.orderId ?? '') ?? ''));
+        return {
+            data: scoped.map((i) => serialize(i, i.orderId ? (byOrder.get(i.orderId) ?? null) : null)),
+            pagination: { cursor: null, hasMore: false, limit: scoped.length },
+        };
+    });
+    // Detail ----------------------------------------------------------------
+    app.get('/api/v1/admin/invoices/:id', { preHandler: requireAdmin('invoices:read') }, async (request) => {
+        return { data: await invoiceService.buildDetail(request.params.id) };
+    });
+    // PDF (rendered on demand) ---------------------------------------------
+    app.get('/api/v1/admin/invoices/:id/pdf', { preHandler: requireAdmin('invoices:read'), config: { streamingResponse: true } }, async (request, reply) => {
+        const detail = await invoiceService.buildDetail(request.params.id);
+        const tree = await templateService.resolveTree(detail.salesChannelId, RENDER_LANGUAGE);
+        const pdf = await pdfRenderer.render(detail, 'pl', tree);
+        reply
+            .header('content-type', 'application/pdf')
+            .header('content-disposition', `attachment; filename="invoice-${detail.number.replace(/\W+/g, '_')}.pdf"`);
+        return reply.send(pdf);
+    });
+    // Issue an invoice/proforma for an order -------------------------------
+    app.post('/api/v1/admin/orders/:orderId/invoices', { preHandler: requireAdmin('invoices:write'), schema: { body: issueInvoiceRequestSchema } }, async (request, reply) => {
+        const body = issueInvoiceRequestSchema.parse(request.body ?? {});
+        const issuedBy = deps.resolveAdminUserId(request) ?? undefined;
+        const detail = await invoiceService.issue(request.params.orderId, body.kind, {
+            ...(body.saleDate ? { saleDate: body.saleDate } : {}),
+            ...(body.paymentDueDate ? { paymentDueDate: body.paymentDueDate } : {}),
+            ...(issuedBy ? { issuedBy } : {}),
+        });
+        const email = await sendOnIssue(deps, detail.id, detail.salesChannelId, detail.status);
+        // Still a 201 whatever `email` says: the notification is best-effort
+        // (FR-024) and a suppressed message must not undo an issued document.
+        reply.status(201);
+        return { data: detail, email };
+    });
+    // Regenerate PDF — the PDF is rendered on demand, so "regenerate" actually
+    // re-runs the full render pipeline (template tree + pdfmake) to validate that
+    // a fresh document can be produced and to surface any rendering error to the
+    // operator instead of silently doing nothing. Returns the refreshed detail.
+    app.post('/api/v1/admin/invoices/:id/regenerate-pdf', { preHandler: requireAdmin('invoices:write') }, async (request) => {
+        const detail = await invoiceService.buildDetail(request.params.id);
+        const tree = await templateService.resolveTree(detail.salesChannelId, RENDER_LANGUAGE);
+        await pdfRenderer.render(detail, 'pl', tree);
+        return { data: detail };
+    });
+    // (Re)send the invoice email -------------------------------------------
+    app.post('/api/v1/admin/invoices/:id/send-email', { preHandler: requireAdmin('invoices:write'), schema: { body: sendInvoiceEmailRequestSchema } }, async (request) => {
+        const body = sendInvoiceEmailRequestSchema.parse(request.body ?? {});
+        // The `if (!deps.emailDispatcher)` arm that stood here is gone with T118c
+        // and `no_sender` is not: a dispatcher always exists now, and it answers
+        // that name itself when `transactional_emails` has announced no sender.
+        // The reason word is unchanged — it was `email_not_configured` until
+        // issue #149, an eighth word for one of the seven reasons a caller can
+        // translate.
+        const messageId = `invoice_issued:${request.params.id}:resend:${Date.now()}`;
+        // Issue #103 — the operator asked for this send explicitly, so the reason
+        // it did not happen belongs in the answer rather than only in the log.
+        const result = await deps.emailDispatcher.dispatch(request.params.id, {
+            ...(body.mode ? { mode: body.mode } : {}),
+            messageId,
+        });
+        return {
+            data: result.sent ? { ok: true } : { ok: false, reason: result.reason },
+        };
+    });
+    // --- Invoice templates (US6) ------------------------------------------
+    app.get('/api/v1/admin/invoice-templates', { preHandler: requireAdmin('invoices:read') }, async () => ({ data: await templateService.list() }));
+    app.get('/api/v1/admin/invoice-templates/page-builder/config', { preHandler: requireAdmin('invoices:read') }, async () => ({ data: invoicePageBuilderDescriptor(pdfRenderer.blocks) }));
+    app.get('/api/v1/admin/invoice-templates/:id', { preHandler: requireAdmin('invoices:read') }, async (request) => ({ data: await templateService.get(request.params.id) }));
+    const createTemplateSchema = z.object({
+        code: z.string().min(1).max(180),
+        name: z.string().min(1).max(200),
+        salesChannelId: z.string().uuid().nullable().optional(),
+    });
+    app.post('/api/v1/admin/invoice-templates', { preHandler: requireAdmin('invoices:write'), schema: { body: createTemplateSchema } }, async (request, reply) => {
+        const body = createTemplateSchema.parse(request.body);
+        const created = await templateService.create({
+            code: body.code,
+            name: body.name,
+            salesChannelId: body.salesChannelId ?? null,
+        });
+        reply.status(201);
+        return { data: created };
+    });
+    const saveContentSchema = z.object({ data: z.unknown(), version: z.number().int() });
+    app.put('/api/v1/admin/invoice-templates/:id/content/:language', { preHandler: requireAdmin('invoices:write'), schema: { body: saveContentSchema } }, async (request) => {
+        const body = saveContentSchema.parse(request.body);
+        return {
+            data: await templateService.saveContent(request.params.id, request.params.language, body.data, body.version),
+        };
+    });
+    // Preview: sample invoice through this template's saved tree (GET) or a draft
+    // canvas tree (POST) without persisting.
+    app.get('/api/v1/admin/invoice-templates/:id/preview', { preHandler: requireAdmin('invoices:write'), config: { streamingResponse: true } }, async (request, reply) => {
+        const tpl = await templateService.get(request.params.id);
+        const tree = pickLanguageTree(tpl.content, RENDER_LANGUAGE);
+        const pdf = await pdfRenderer.render(sampleInvoiceDetail(), 'en', tree);
+        reply.header('content-type', 'application/pdf').header('content-disposition', 'inline; filename="preview.pdf"');
+        return reply.send(pdf);
+    });
+    app.post('/api/v1/admin/invoice-templates/:id/preview', { preHandler: requireAdmin('invoices:write') }, async (request, reply) => {
+        await templateService.get(request.params.id); // 404 if missing
+        const body = z.object({ data: z.unknown() }).parse(request.body);
+        const pdf = await pdfRenderer.render(sampleInvoiceDetail(), 'en', body.data);
+        reply.header('content-type', 'application/pdf').header('content-disposition', 'inline; filename="preview.pdf"');
+        return reply.send(pdf);
+    });
+}
+/**
+ * Send-on-issue, and what became of it (issue #149).
+ *
+ * The dispatch result used to be awaited and dropped, so an operator who
+ * clicked "issue and send" was told "issued" whether the e-mail went out or was
+ * suppressed for one of seven named reasons — the last site of the #67/#78/#115
+ * family. Nothing catches here: `dispatch` contains its own failures and names
+ * them in the result (FR-029), and the one thing it re-throws is a presence
+ * answer that must reach the caller as a 503.
+ */
+async function sendOnIssue(deps, invoiceId, salesChannelId, invoiceStatus) {
+    const dispatcher = deps.emailDispatcher;
+    // The `if (!dispatcher)` arm that stood here is gone with T118c: the
+    // dispatcher is built unconditionally, so "this composition has no e-mail
+    // surface" is no longer a state. `no_sender` is still reachable and is still
+    // the honest answer — it is the dispatcher's own, for a
+    // `transactional_emails` that has not announced its sender.
+    if (invoiceStatus === 'pending')
+        return { status: 'not_requested' };
+    if (!(await dispatcher.sendOnIssueEnabled(salesChannelId)))
+        return { status: 'not_requested' };
+    const result = await dispatcher.dispatch(invoiceId);
+    return result.sent ? { status: 'sent' } : { status: 'not_sent', reason: result.reason };
+}
+function serialize(i, orderBusinessId) {
+    return {
+        id: i.id,
+        orderId: i.orderId,
+        orderBusinessId,
+        salesChannelId: i.salesChannelId ?? null,
+        kind: i.kind,
+        number: i.number,
+        issuedAt: i.issuedAt.toISOString(),
+        currency: i.currency,
+        total: Number(i.total),
+        status: i.status,
+        pdfReady: i.status === 'ready',
+        createdAt: i.createdAt.toISOString(),
+        updatedAt: i.updatedAt.toISOString(),
+    };
+}
+//# sourceMappingURL=routes.admin.js.map

package/dist/backend/routes.admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.admin.js","sourceRoot":"","sources":["../../src/backend/routes.admin.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAG9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAqCnE,MAAM,eAAe,GAAG,OAAO,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,GAAoB,EACpB,IAAuB;IAEvB,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,GAC5F,IAAI,CAAC;IAEP,0EAA0E;IAC1E,GAAG,CAAC,GAAG,CACL,wBAAwB,EACxB,EAAE,UAAU,EAAE,YAAY,CAAC,eAAe,CAAC,EAAE,EAC7C,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAuC,CAAC;QACtE,MAAM,KAAK,GAA4B,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,gBAAgB,CAAC;YAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAC/D,IAAI,CAAC,CAAC,iBAAiB,CAAC;YAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAClE,IAAI,CAAC,CAAC,cAAc,CAAC;YAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,CAAC,CAAC,wBAAwB,CAAC;YAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,wBAAwB,CAAC,CAAC;QACvF,MAAM,QAAQ,GAAyB,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,oBAAoB,CAAC;YAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAW,CAAC,CAAC;QAC5F,IAAI,CAAC,CAAC,kBAAkB,CAAC;YAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAW,CAAC,CAAC;QACxF,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM;YAAE,KAAK,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC;QAC/D,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,CAAC,CAAC,kBAAkB,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACzE,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,CAAC,kBAAkB,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACzE,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;YAAE,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;QAEtD,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QAEvB,uEAAuE;QACvE,yEAAyE;QACzE,EAAE;QACF,yEAAyE;QACzE,yEAAyE;QACzE,0EAA0E;QAC1E,sEAAsE;QACtE,uEAAuE;QACvE,4DAA4D;QAC5D,MAAM,WAAW,GAAG,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,CAAC;QACrD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,gBAAgB,GAAG,MAAM,aAAa,CAAC,uBAAuB,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YACvF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9E,CAAC;YACD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC;QAC/C,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAClF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrF,MAAM,QAAQ,GAAG;YACf,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;SAChF,CAAC;QACF,0EAA0E;QAC1E,qEAAqE;QACrE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACxE,yEAAyE;QACzE,wEAAwE;QACxE,0EAA0E;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,CAAC,CAAC,MAAM,KAAK,YAAY;YACvB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC;YACtC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CACxD,CAAC;QACF,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC1F,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,GAAG,CAAC,GAAG,CACL,4BAA4B,EAC5B,EAAE,UAAU,EAAE,YAAY,CAAC,eAAe,CAAC,EAAE,EAC7C,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IACvE,CAAC,CACF,CAAC;IAEF,yEAAyE;IACzE,GAAG,CAAC,GAAG,CACL,gCAAgC,EAChC,EAAE,UAAU,EAAE,YAAY,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,EAClF,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;QACvF,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACzD,KAAK;aACF,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC;aACzC,MAAM,CAAC,qBAAqB,EAAE,iCAAiC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7G,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC,CACF,CAAC;IAEF,yEAAyE;IACzE,GAAG,CAAC,IAAI,CACN,wCAAwC,EACxC,EAAE,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,EAAE,EAC3F,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,yBAAyB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;QAC/D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;YAC3E,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACvF,qEAAqE;QACrE,sEAAsE;QACtE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC,CACF,CAAC;IAEF,2EAA2E;IAC3E,8EAA8E;IAC9E,6EAA6E;IAC7E,4EAA4E;IAC5E,GAAG,CAAC,IAAI,CACN,2CAA2C,EAC3C,EAAE,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,EAC9C,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;QACvF,MAAM,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC,CACF,CAAC;IAEF,yEAAyE;IACzE,GAAG,CAAC,IAAI,CACN,uCAAuC,EACvC,EAAE,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,6BAA6B,EAAE,EAAE,EAC/F,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,IAAI,GAAG,6BAA6B,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACrE,0EAA0E;QAC1E,yEAAyE;QACzE,wEAAwE;QACxE,qEAAqE;QACrE,uEAAuE;QACvE,aAAa;QACb,MAAM,SAAS,GAAG,kBAAkB,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC7E,0EAA0E;QAC1E,uEAAuE;QACvE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE;YACpE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,SAAS;SACV,CAAC,CAAC;QACH,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SACxE,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,yEAAyE;IACzE,GAAG,CAAC,GAAG,CACL,iCAAiC,EACjC,EAAE,UAAU,EAAE,YAAY,CAAC,eAAe,CAAC,EAAE,EAC7C,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CACrD,CAAC;IAEF,GAAG,CAAC,GAAG,CACL,qDAAqD,EACrD,EAAE,UAAU,EAAE,YAAY,CAAC,eAAe,CAAC,EAAE,EAC7C,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,4BAA4B,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CACzE,CAAC;IAEF,GAAG,CAAC,GAAG,CACL,qCAAqC,EACrC,EAAE,UAAU,EAAE,YAAY,CAAC,eAAe,CAAC,EAAE,EAC7C,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAC5E,CAAC;IAEF,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;QACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QAChC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KACxD,CAAC,CAAC;IACH,GAAG,CAAC,IAAI,CACN,iCAAiC,EACjC,EAAE,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,EACtF,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC;YAC3C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;SAC5C,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC,CACF,CAAC;IAEF,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrF,GAAG,CAAC,GAAG,CACL,uDAAuD,EACvD,EAAE,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,EACnF,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO;YACL,IAAI,EAAE,MAAM,eAAe,CAAC,WAAW,CACrC,OAAO,CAAC,MAAM,CAAC,EAAE,EACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,EACvB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,OAAO,CACb;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,8EAA8E;IAC9E,yCAAyC;IACzC,GAAG,CAAC,GAAG,CACL,6CAA6C,EAC7C,EAAE,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,EACnF,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACxE,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC,MAAM,CAAC,qBAAqB,EAAE,gCAAgC,CAAC,CAAC;QAChH,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,IAAI,CACN,6CAA6C,EAC7C,EAAE,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,EAC9C,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB;QAC/D,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC,MAAM,CAAC,qBAAqB,EAAE,gCAAgC,CAAC,CAAC;QAChH,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,WAAW,CACxB,IAAuB,EACvB,SAAiB,EACjB,cAA6B,EAC7B,aAAqB;IAErB,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC;IACxC,qEAAqE;IACrE,0EAA0E;IAC1E,6EAA6E;IAC7E,wDAAwD;IACxD,4DAA4D;IAC5D,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACpE,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC/F,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAC1F,CAAC;AAED,SAAS,SAAS,CAAC,CAAU,EAAE,eAA8B;IAC3D,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,eAAe;QACf,cAAc,EAAE,CAAC,CAAC,cAAc,IAAI,IAAI;QACxC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE;QAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,KAAK,OAAO;QAC9B,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;QACpC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;KACrC,CAAC;AACJ,CAAC"}

package/dist/backend/routes.customer.d.ts

@@ -0,0 +1,33 @@
+import type { FastifyInstance, FastifyRequest } from 'fastify';
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type AssetsLibraryPort, type InvoiceAttachmentFetchPort, type OrderReadPort } from '@endora-commerce/contracts';
+import type { InvoiceService } from './services/invoice-service.js';
+import type { InvoicePdfRenderer } from './services/invoice-pdf-renderer.js';
+import type { InvoiceTemplateService } from './services/invoice-template-service.js';
+export interface InvoicesCustomerDeps {
+    emFactory: () => EntityManager;
+    /** `orders`' published read model — the ownership check (feature 075, Phase C). */
+    orderReadPort: OrderReadPort;
+    /** `assets_library` — resolves signed URLs for private attachment bytes. */
+    assetsLibrary: AssetsLibraryPort;
+    /**
+     * This module's own attachment fetch registry (feature 134, T061): the
+     * provider of the document's source system, or `null` when none is present.
+     */
+    saleDocumentAttachments: InvoiceAttachmentFetchPort;
+    requireCustomer: (req: FastifyRequest, reply: unknown) => Promise<void>;
+    resolveCustomerContext: (req: FastifyRequest) => {
+        customerAccountId: string;
+        organizationId: string;
+    };
+    invoiceService: InvoiceService;
+    pdfRenderer: InvoicePdfRenderer;
+    templateService: InvoiceTemplateService;
+}
+/**
+ * Storefront customer invoice routes (feature 047, US4). A customer lists and
+ * downloads invoices for an order they (or their organization) own. Only
+ * `ready` invoices are exposed.
+ */
+export declare function registerInvoicesCustomerRoutes(app: FastifyInstance, deps: InvoicesCustomerDeps): Promise<void>;
+//# sourceMappingURL=routes.customer.d.ts.map

package/dist/backend/routes.customer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.customer.d.ts","sourceRoot":"","sources":["../../src/backend/routes.customer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,aAAa,EAEnB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAErF,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,mFAAmF;IACnF,aAAa,EAAE,aAAa,CAAC;IAC7B,4EAA4E;IAC5E,aAAa,EAAE,iBAAiB,CAAC;IACjC;;;OAGG;IACH,uBAAuB,EAAE,0BAA0B,CAAC;IACpD,eAAe,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,sBAAsB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IACvG,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,kBAAkB,CAAC;IAChC,eAAe,EAAE,sBAAsB,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAyJf"}