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

package/dist/backend/routes.customer.js

@@ -0,0 +1,124 @@
+import { HttpError } from '@endora-commerce/platform/http';
+import { ERROR_CODES, } from '@endora-commerce/contracts';
+import { InvoiceExternalAttachment } from './entities/invoice-external-attachment.entity.js';
+import { Invoice } from './entities/invoice.entity.js';
+/**
+ * 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 async function registerInvoicesCustomerRoutes(app, deps) {
+    const { emFactory, orderReadPort, assetsLibrary, saleDocumentAttachments, requireCustomer, resolveCustomerContext, invoiceService, pdfRenderer, templateService, } = deps;
+    async function ownedOrderOr404(req, orderId) {
+        const ctx = resolveCustomerContext(req);
+        const order = await orderReadPort.findById(orderId);
+        if (!order ||
+            (order.placedByCustomerAccountId !== ctx.customerAccountId &&
+                order.organizationId !== ctx.organizationId)) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Order not found.');
+        }
+        return order;
+    }
+    app.get('/api/v1/orders/:id/invoices', { preHandler: requireCustomer }, async (request) => {
+        await ownedOrderOr404(request, request.params.id);
+        const em = emFactory();
+        const rows = await em.find(Invoice, { orderId: request.params.id, status: 'ready' }, { orderBy: { issuedAt: 'desc' } });
+        return {
+            data: rows.map((i) => ({
+                id: i.id,
+                kind: i.kind,
+                number: i.number,
+                issuedAt: i.issuedAt.toISOString(),
+                currency: i.currency,
+                total: Number(i.total),
+                downloadHref: `/api/v1/orders/${request.params.id}/invoices/${i.id}/pdf`,
+            })),
+        };
+    });
+    app.get('/api/v1/orders/:id/invoices/:invoiceId/pdf', { preHandler: requireCustomer, config: { streamingResponse: true } }, async (request, reply) => {
+        await ownedOrderOr404(request, request.params.id);
+        const em = emFactory();
+        const inv = await em.findOne(Invoice, {
+            id: request.params.invoiceId,
+            orderId: request.params.id,
+            status: 'ready',
+        });
+        if (!inv)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Invoice not found.');
+        const detail = await invoiceService.buildDetail(inv.id);
+        const tree = await templateService.resolveTree(detail.salesChannelId, 'pl-PL');
+        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);
+    });
+    app.get('/api/v1/account/organization/invoices', { preHandler: requireCustomer }, async (request) => {
+        const ctx = resolveCustomerContext(request);
+        const em = emFactory();
+        const rows = await em.find(Invoice, { origin: 'erp_import', organizationId: ctx.organizationId, status: 'ready' }, { orderBy: { issuedAt: 'desc' } });
+        const attachmentsByInvoice = new Map();
+        if (rows.length > 0) {
+            const attachments = await em.find(InvoiceExternalAttachment, {
+                invoiceId: { $in: rows.map((row) => row.id) },
+            });
+            for (const attachment of attachments) {
+                const bucket = attachmentsByInvoice.get(attachment.invoiceId) ?? [];
+                bucket.push(attachment);
+                attachmentsByInvoice.set(attachment.invoiceId, bucket);
+            }
+        }
+        return {
+            data: rows.map((row) => ({
+                id: row.id,
+                kind: row.kind,
+                number: row.number,
+                documentKind: row.externalDocumentRef?.documentKind ?? 'invoice',
+                issuedAt: row.issuedAt.toISOString(),
+                currency: row.currency,
+                total: Number(row.total),
+                orderId: row.orderId ?? null,
+                attachments: (attachmentsByInvoice.get(row.id) ?? []).map((attachment) => ({
+                    id: attachment.id,
+                    fileName: attachment.fileName,
+                    contentType: attachment.contentType ?? null,
+                    downloadHref: `/api/v1/account/organization/invoices/${row.id}/attachments/${attachment.id}`,
+                })),
+            })),
+        };
+    });
+    app.get('/api/v1/account/organization/invoices/:invoiceId/attachments/:attachmentId', { preHandler: requireCustomer, config: { streamingResponse: true } }, async (request, reply) => {
+        const ctx = resolveCustomerContext(request);
+        const em = emFactory();
+        const invoice = await em.findOne(Invoice, {
+            id: request.params.invoiceId,
+            origin: 'erp_import',
+            organizationId: ctx.organizationId,
+            status: 'ready',
+        });
+        if (!invoice) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Sale document not found.');
+        }
+        const attachment = await em.findOne(InvoiceExternalAttachment, {
+            id: request.params.attachmentId,
+            invoiceId: invoice.id,
+        });
+        if (!attachment) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Attachment not found.');
+        }
+        if (!attachment.assetId) {
+            const ensured = await saleDocumentAttachments.ensureAttachmentBytes({
+                invoiceId: invoice.id,
+                attachmentId: attachment.id,
+                organizationId: ctx.organizationId,
+            });
+            if (!ensured) {
+                throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Attachment not found.');
+            }
+            attachment.assetId = ensured.assetId;
+        }
+        const asset = await assetsLibrary.getAsset(attachment.assetId);
+        return reply.redirect(asset.url);
+    });
+}
+//# sourceMappingURL=routes.customer.js.map

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

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

package/dist/backend/seeds/generic-invoice-template.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Seeded generic invoice template (feature 047, US6 / T027). A Puck content
+ * envelope composed of the bounded invoice component set.
+ *
+ * Props on each node MUST mirror `defaultProps` in
+ * `admin/.../invoice-puck-config.tsx` so the editor sidebar shows selected
+ * radios/selects when a template is created from this seed (Puck does not
+ * re-apply defaultProps onto already-persisted nodes).
+ */
+export declare const GENERIC_INVOICE_TEMPLATE_CODE = "generic";
+export declare const GENERIC_INVOICE_TEMPLATE_LANGUAGES: string[];
+/**
+ * Bump when the seeded Puck tree shape changes so `ensureGenericSeed` (and the
+ * matching data migration) refresh the system `generic` row on existing DBs.
+ */
+export declare const GENERIC_INVOICE_TEMPLATE_SEED_REVISION = 2;
+export declare const GENERIC_INVOICE_TEMPLATE_CONTENT: Record<string, unknown>;
+//# sourceMappingURL=generic-invoice-template.d.ts.map

package/dist/backend/seeds/generic-invoice-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-invoice-template.d.ts","sourceRoot":"","sources":["../../../src/backend/seeds/generic-invoice-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,YAAY,CAAC;AACvD,eAAO,MAAM,kCAAkC,UAAqB,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,sCAAsC,IAAI,CAAC;AA2JxD,eAAO,MAAM,gCAAgC,EAMxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/backend/seeds/generic-invoice-template.js

@@ -0,0 +1,174 @@
+/**
+ * Seeded generic invoice template (feature 047, US6 / T027). A Puck content
+ * envelope composed of the bounded invoice component set.
+ *
+ * Props on each node MUST mirror `defaultProps` in
+ * `admin/.../invoice-puck-config.tsx` so the editor sidebar shows selected
+ * radios/selects when a template is created from this seed (Puck does not
+ * re-apply defaultProps onto already-persisted nodes).
+ */
+export const GENERIC_INVOICE_TEMPLATE_CODE = 'generic';
+export const GENERIC_INVOICE_TEMPLATE_LANGUAGES = ['pl-PL', 'en-US'];
+/**
+ * Bump when the seeded Puck tree shape changes so `ensureGenericSeed` (and the
+ * matching data migration) refresh the system `generic` row on existing DBs.
+ */
+export const GENERIC_INVOICE_TEMPLATE_SEED_REVISION = 2;
+const DEFAULT_FOOTER_TEXT = 'Thank you for your business.\n{{var seller.legalName}} · Tax ID {{var seller.taxId}}';
+function genericTree() {
+    return {
+        root: { props: {} },
+        content: [
+            {
+                type: 'invoices.InvoiceLogo',
+                props: {
+                    id: 'inv-logo',
+                    imageSource: 'url',
+                    src: '',
+                    assetId: '',
+                    width: 140,
+                    maxHeight: 80,
+                    align: 'center',
+                    marginBottom: 12,
+                },
+            },
+            {
+                type: 'invoices.InvoiceHeader',
+                props: {
+                    id: 'inv-header',
+                    titleSize: 14,
+                    titleColor: '#0f172a',
+                    titleBold: true,
+                    align: 'left',
+                    showIssuedAt: true,
+                    showSaleDate: true,
+                    showPaymentDue: true,
+                    showPaymentMethod: true,
+                    labelIssuedAt: 'Issue date',
+                    labelSaleDate: 'Sale date',
+                    labelPaymentDue: 'Payment due',
+                    labelPaymentMethod: 'Payment method',
+                    marginTop: 0,
+                    marginBottom: 12,
+                },
+            },
+            {
+                type: 'invoices.InvoiceSpacer',
+                props: { id: 'inv-spacer-1', height: 8, backgroundColor: '' },
+            },
+            {
+                type: 'invoices.InvoiceParties',
+                props: {
+                    id: 'inv-parties',
+                    sellerLabel: 'Seller',
+                    buyerLabel: 'Buyer',
+                    showSellerBank: true,
+                    showSellerSwift: true,
+                    showBuyerTaxId: true,
+                    labelFontSize: 10,
+                    bodyFontSize: 10,
+                    columnGap: 16,
+                    sellerWidthPercent: 50,
+                    marginTop: 0,
+                    marginBottom: 16,
+                },
+            },
+            {
+                type: 'invoices.InvoiceLineItems',
+                props: {
+                    id: 'inv-lines',
+                    fontSize: 8,
+                    headerBold: true,
+                    headerBackground: '',
+                    headerColor: '',
+                    borderColor: '#cbd5e1',
+                    zebra: false,
+                    showUnit: true,
+                    showQty: true,
+                    showUnitNet: true,
+                    showTaxRate: true,
+                    showNet: true,
+                    showGross: true,
+                    marginTop: 0,
+                    marginBottom: 12,
+                },
+            },
+            {
+                type: 'invoices.InvoiceVatSummary',
+                props: {
+                    id: 'inv-vat',
+                    fontSize: 8,
+                    headerBold: true,
+                    headerBackground: '',
+                    headerColor: '',
+                    borderColor: '#cbd5e1',
+                    showTotalRow: true,
+                    totalLabel: 'Total',
+                    marginTop: 0,
+                    marginBottom: 12,
+                },
+            },
+            {
+                type: 'invoices.InvoiceTotals',
+                props: {
+                    id: 'inv-totals',
+                    align: 'right',
+                    fontSize: 10,
+                    color: '#0f172a',
+                    amountDueColor: '',
+                    amountDueBold: true,
+                    amountInWordsItalics: true,
+                    showPaid: true,
+                    showAmountDue: true,
+                    showGross: true,
+                    showAmountInWords: true,
+                    labelPaid: 'Paid',
+                    labelAmountDue: 'Amount due',
+                    labelGross: 'Total',
+                    labelInWords: 'In words',
+                    marginTop: 0,
+                    marginBottom: 16,
+                },
+            },
+            // A `ksef.InvoiceSection` node stood here until feature 134's T063, and
+            // this is the record of why it left. The comment that used to sit in
+            // `pdf-components/descriptor.ts` said it first: the descriptor's owner
+            // was *"derived from the name's owner segment rather than asserted: ten
+            // of the eleven are `invoices`' and the eleventh, `ksef.InvoiceSection`,
+            // is `ksef`'s (feature 096, T201). A literal here would have said
+            // `invoices` for a block `invoices` does not own."* The eleventh was
+            // different in kind — declared by another module and still seeded,
+            // rendered, described and previewed here — so it went to the module
+            // that declares it (`specs/134-paid-module-extraction/spec.md` §11.3,
+            // exit E4). A free instance has no KSeF, so its generic template has no
+            // KSeF section. Installing `ksef` does not put one back: the operator
+            // places the block in the builder. Templates seeded before the change
+            // keep their node — the seed revision is deliberately unchanged, so
+            // nothing rewrites them — and it renders wherever `ksef` is present.
+            {
+                type: 'invoices.InvoiceFooter',
+                props: {
+                    id: 'inv-footer',
+                    text: DEFAULT_FOOTER_TEXT,
+                    align: 'center',
+                    fontSize: 9,
+                    color: '#0f172a',
+                    bold: false,
+                    italics: false,
+                    showTopDivider: true,
+                    marginTop: 0,
+                    marginBottom: 8,
+                },
+            },
+        ],
+        zones: {},
+    };
+}
+export const GENERIC_INVOICE_TEMPLATE_CONTENT = {
+    schema_version: GENERIC_INVOICE_TEMPLATE_SEED_REVISION,
+    languages: {
+        'pl-PL': genericTree(),
+        'en-US': genericTree(),
+    },
+};
+//# sourceMappingURL=generic-invoice-template.js.map

package/dist/backend/seeds/generic-invoice-template.js.map

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

package/dist/backend/services/amount-to-words.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Amount-in-words ("słownie") for invoice PDFs (feature 047, research R7).
+ *
+ * Renders a monetary amount as words for Polish (`pl`) and English (`en`),
+ * with the fractional part shown in the `NN/100` form used on Polish invoices
+ * (e.g. "sześć tysięcy sześćset czterdzieści osiem złotych 15/100"). A small
+ * self-contained util — no runtime dependency (Constitution Principle IV).
+ */
+export type AmountToWordsLocale = 'pl' | 'en';
+/**
+ * Convert a numeric amount to words. The integer part is spelled out; the
+ * fractional (minor) part is shown as `NN/100`. The currency word follows the
+ * integer part (Polish: with correct plural; English: singular/plural).
+ *
+ * @param amount  monetary amount (major units, may have 2 decimals)
+ * @param currency ISO-4217 code (PLN/EUR/USD recognised; others fall back to the code)
+ * @param locale  'pl' (default) or 'en'
+ */
+export declare function amountToWords(amount: number, currency: string, locale?: AmountToWordsLocale): string;
+//# sourceMappingURL=amount-to-words.d.ts.map

package/dist/backend/services/amount-to-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount-to-words.d.ts","sourceRoot":"","sources":["../../../src/backend/services/amount-to-words.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAAC;AAkM9C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,mBAA0B,GACjC,MAAM,CAgBR"}

package/dist/backend/services/amount-to-words.js

@@ -0,0 +1,232 @@
+/**
+ * Amount-in-words ("słownie") for invoice PDFs (feature 047, research R7).
+ *
+ * Renders a monetary amount as words for Polish (`pl`) and English (`en`),
+ * with the fractional part shown in the `NN/100` form used on Polish invoices
+ * (e.g. "sześć tysięcy sześćset czterdzieści osiem złotych 15/100"). A small
+ * self-contained util — no runtime dependency (Constitution Principle IV).
+ */
+const PL_ONES = [
+    'zero',
+    'jeden',
+    'dwa',
+    'trzy',
+    'cztery',
+    'pięć',
+    'sześć',
+    'siedem',
+    'osiem',
+    'dziewięć',
+    'dziesięć',
+    'jedenaście',
+    'dwanaście',
+    'trzynaście',
+    'czternaście',
+    'piętnaście',
+    'szesnaście',
+    'siedemnaście',
+    'osiemnaście',
+    'dziewiętnaście',
+];
+const PL_TENS = [
+    '',
+    '',
+    'dwadzieścia',
+    'trzydzieści',
+    'czterdzieści',
+    'pięćdziesiąt',
+    'sześćdziesiąt',
+    'siedemdziesiąt',
+    'osiemdziesiąt',
+    'dziewięćdziesiąt',
+];
+const PL_HUNDREDS = [
+    '',
+    'sto',
+    'dwieście',
+    'trzysta',
+    'czterysta',
+    'pięćset',
+    'sześćset',
+    'siedemset',
+    'osiemset',
+    'dziewięćset',
+];
+// Polish scale words with the three plural forms [1, 2-4, 5+].
+const PL_SCALES = [
+    ['', '', ''],
+    ['tysiąc', 'tysiące', 'tysięcy'],
+    ['milion', 'miliony', 'milionów'],
+    ['miliard', 'miliardy', 'miliardów'],
+];
+const EN_ONES = [
+    'zero',
+    'one',
+    'two',
+    'three',
+    'four',
+    'five',
+    'six',
+    'seven',
+    'eight',
+    'nine',
+    'ten',
+    'eleven',
+    'twelve',
+    'thirteen',
+    'fourteen',
+    'fifteen',
+    'sixteen',
+    'seventeen',
+    'eighteen',
+    'nineteen',
+];
+const EN_TENS = [
+    '',
+    '',
+    'twenty',
+    'thirty',
+    'forty',
+    'fifty',
+    'sixty',
+    'seventy',
+    'eighty',
+    'ninety',
+];
+const EN_SCALES = ['', 'thousand', 'million', 'billion'];
+/** Polish plural index: 1 -> 0, 2-4 (not 12-14) -> 1, else -> 2. */
+function plPluralIndex(n) {
+    if (n === 1)
+        return 0;
+    const lastTwo = n % 100;
+    const last = n % 10;
+    if (last >= 2 && last <= 4 && !(lastTwo >= 12 && lastTwo <= 14))
+        return 1;
+    return 2;
+}
+/** Safe array lookup — the input ranges are bounded by construction. */
+function word(arr, i) {
+    return arr[i] ?? '';
+}
+function plThreeDigits(n) {
+    const parts = [];
+    const h = Math.floor(n / 100);
+    const t = Math.floor((n % 100) / 10);
+    const o = n % 10;
+    if (h)
+        parts.push(word(PL_HUNDREDS, h));
+    if (t >= 2) {
+        parts.push(word(PL_TENS, t));
+        if (o)
+            parts.push(word(PL_ONES, o));
+    }
+    else {
+        const rest = t * 10 + o;
+        if (rest)
+            parts.push(word(PL_ONES, rest));
+    }
+    return parts.filter(Boolean).join(' ');
+}
+function plInteger(value) {
+    if (value === 0)
+        return word(PL_ONES, 0);
+    const groups = [];
+    let n = value;
+    while (n > 0) {
+        groups.push(n % 1000);
+        n = Math.floor(n / 1000);
+    }
+    const words = [];
+    for (let i = groups.length - 1; i >= 0; i--) {
+        const g = groups[i] ?? 0;
+        if (g === 0)
+            continue;
+        if (i === 0) {
+            words.push(plThreeDigits(g));
+        }
+        else {
+            // "jeden tysiąc" is conventionally just "tysiąc".
+            if (g !== 1)
+                words.push(plThreeDigits(g));
+            const scale = PL_SCALES[i];
+            if (scale)
+                words.push(word(scale, plPluralIndex(g)));
+        }
+    }
+    return words.filter(Boolean).join(' ');
+}
+function enThreeDigits(n) {
+    const parts = [];
+    const h = Math.floor(n / 100);
+    const rest = n % 100;
+    if (h) {
+        parts.push(`${word(EN_ONES, h)} hundred`);
+    }
+    if (rest) {
+        if (rest < 20) {
+            parts.push(word(EN_ONES, rest));
+        }
+        else {
+            const t = Math.floor(rest / 10);
+            const o = rest % 10;
+            parts.push(o ? `${word(EN_TENS, t)}-${word(EN_ONES, o)}` : word(EN_TENS, t));
+        }
+    }
+    return parts.filter(Boolean).join(' ');
+}
+function enInteger(value) {
+    if (value === 0)
+        return word(EN_ONES, 0);
+    const groups = [];
+    let n = value;
+    while (n > 0) {
+        groups.push(n % 1000);
+        n = Math.floor(n / 1000);
+    }
+    const words = [];
+    for (let i = groups.length - 1; i >= 0; i--) {
+        const g = groups[i] ?? 0;
+        if (g === 0)
+            continue;
+        words.push(enThreeDigits(g));
+        if (i > 0)
+            words.push(word(EN_SCALES, i));
+    }
+    return words.filter(Boolean).join(' ');
+}
+const PL_CURRENCY = {
+    PLN: ['złoty', 'złote', 'złotych'],
+    EUR: ['euro', 'euro', 'euro'],
+    USD: ['dolar', 'dolary', 'dolarów'],
+};
+const EN_CURRENCY = {
+    PLN: ['zloty', 'zlotys'],
+    EUR: ['euro', 'euro'],
+    USD: ['dollar', 'dollars'],
+};
+/**
+ * Convert a numeric amount to words. The integer part is spelled out; the
+ * fractional (minor) part is shown as `NN/100`. The currency word follows the
+ * integer part (Polish: with correct plural; English: singular/plural).
+ *
+ * @param amount  monetary amount (major units, may have 2 decimals)
+ * @param currency ISO-4217 code (PLN/EUR/USD recognised; others fall back to the code)
+ * @param locale  'pl' (default) or 'en'
+ */
+export function amountToWords(amount, currency, locale = 'pl') {
+    const safe = Number.isFinite(amount) ? Math.abs(amount) : 0;
+    const integer = Math.floor(safe + 1e-9);
+    const minor = Math.round((safe - integer) * 100);
+    const code = currency.toUpperCase();
+    const fraction = `${minor.toString().padStart(2, '0')}/100`;
+    const sign = amount < 0 ? (locale === 'pl' ? 'minus ' : 'minus ') : '';
+    if (locale === 'pl') {
+        const words = plInteger(integer);
+        const cur = PL_CURRENCY[code]?.[plPluralIndex(integer)] ?? code;
+        return `${sign}${words} ${cur} ${fraction}`.trim();
+    }
+    const words = enInteger(integer);
+    const cur = EN_CURRENCY[code]?.[integer === 1 ? 0 : 1] ?? code;
+    return `${sign}${words} ${cur} ${fraction}`.trim();
+}
+//# sourceMappingURL=amount-to-words.js.map

package/dist/backend/services/amount-to-words.js.map

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

package/dist/backend/services/auto-issue-reactor.d.ts

@@ -0,0 +1,53 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { InvoiceService } from './invoice-service.js';
+import type { InvoiceEmailDispatcher, InvoiceEmailLog } from './invoice-email-dispatch.js';
+import type { SettingsReader } from './seller-settings.js';
+export interface AutoIssueReactorDeps {
+    emFactory: () => EntityManager;
+    invoiceService: InvoiceService;
+    settingsService: SettingsReader;
+    /** Absent when this composition wired no transactional-email sender. */
+    emailDispatcher?: InvoiceEmailDispatcher | undefined;
+    /**
+     * Where an auto-issue that did not reach the customer is reported. Injectable
+     * so a test can read it; defaults to `console.warn`, which is what the rest of
+     * this layer uses.
+     */
+    log?: InvoiceEmailLog;
+}
+/**
+ * FR-002 — issue an invoice when an order reaches the configured status.
+ *
+ * The **subscription** lives in this module's `backend.ts` and goes through
+ * `ctx.subscribe` (issue #107). It was a bare `eventBus.on` in the plugin body,
+ * and of the twenty-two such registrations this was the heaviest write: a
+ * switched-off `invoices` module still issued a numbered legal document, took a
+ * number out of the invoice sequence and e-mailed the PDF to the customer, while
+ * the admin surface that would have shown it refused.
+ *
+ * Idempotent on `(orderId, kind='invoice')`, and still best-effort: a failed
+ * automatic attempt leaves manual issuance available. It is no longer *silent*
+ * (issue #115). This subscriber has no caller to answer, so "observed" means
+ * written to the log with the context only the reactor knows — which order
+ * triggered the issuance, and which number it drew. Three things were swallowed
+ * here and each now has a distinct outcome:
+ *
+ *   - a **non-sent dispatch**: `{ sent, reason }` was discarded exactly as the
+ *     plugin-body closure it was lifted out of discarded it, so an invoice that
+ *     was issued and never delivered read as success. The reason is recorded.
+ *   - a **switched-off module**: the outer `catch {}` absorbed
+ *     `ModuleDisabledError`, which is fail-closed turned into fail-open. It is
+ *     re-thrown; the EventBus isolates and logs handler throws, so the presence
+ *     answer surfaces instead of being confused with a transient failure.
+ *   - a **defective settings read**: `catch { trigger = '' }` made every failure
+ *     read as "no trigger configured" — the same `''` sentinel D-43 removed from
+ *     the dispatcher. Only the two conditions that genuinely mean "not
+ *     configured" degrade now.
+ *
+ * An operator who switched send-on-issue off is *not* a loss and is not logged:
+ * that is a configured choice, not an undelivered message.
+ */
+export declare function createAutoIssueReactor(deps: AutoIssueReactorDeps): {
+    onOrderStatusChanged: (payload: unknown) => Promise<void>;
+};
+//# sourceMappingURL=auto-issue-reactor.d.ts.map