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

package/dist/manifest.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Invoices module — manifest (feature 047-invoices-module).
+ *
+ * Owns invoice generation (proforma / VAT invoice / correction), the per-channel
+ * numbering engine, the WYSIWYG PDF templates, seller company settings, and
+ * email delivery (through the transactional_emails module). Scalar settings are
+ * declared here and seeded by the module-lifecycle ManifestReconciler on boot;
+ * all are Sales-Channel-scopable through the standard settings scoping.
+ */
+export declare const INVOICES_SETTING_CODES: {
+    readonly SELLER_TAX_ID: "invoices.seller.tax_id";
+    readonly SELLER_COMPANY_DATA: "invoices.seller.company_data";
+    readonly AUTO_ISSUE_TRIGGER_STATUS: "invoices.auto_issue.trigger_status";
+    readonly EMAIL_SEND_ON_ISSUE: "invoices.email.send_on_issue";
+    readonly EMAIL_DELIVERY_MODE: "invoices.email.delivery_mode";
+    readonly NUMBERING_INVOICE_PATTERN: "invoices.numbering.invoice.pattern";
+    readonly NUMBERING_PROFORMA_PATTERN: "invoices.numbering.proforma.pattern";
+    readonly NUMBERING_CORRECTION_PATTERN: "invoices.numbering.correction.pattern";
+    readonly STOREFRONT_BASE_URL: "invoices.storefront_base_url";
+};
+export declare const invoicesSettingsManifest: {
+    moduleCode: string;
+    groups: {
+        code: string;
+        name: string;
+        salesChannelCodes?: string[] | undefined;
+        isSystemProtected?: boolean | undefined;
+    }[];
+    settings: {
+        code: string;
+        name: string;
+        valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+        defaultValue: unknown;
+        description?: string | undefined;
+        groupCode?: string | undefined;
+        previousDefaultValues?: unknown[] | undefined;
+        salesChannelCodes?: string[] | undefined;
+        enumOptions?: string[] | undefined;
+        configurationType?: string | undefined;
+        hidden?: boolean | undefined;
+    }[];
+};
+export declare const manifest: {
+    id: string;
+    name: string;
+    version: string;
+    dependencies: string[];
+    description?: string | undefined;
+    acknowledgedDependencies?: {
+        moduleId: string;
+        port: string;
+        reason: string;
+    }[] | undefined;
+    nonBindingDependencies?: {
+        moduleId: string;
+        name: string;
+        kind: "contributes-to" | "degrades-without" | "refuses-without";
+        reason: string;
+        whenAbsent?: string | undefined;
+    }[] | undefined;
+    activation?: {
+        settingCode: string;
+        default: boolean;
+    } | {
+        nonDeactivatable: true;
+        reason: string;
+    } | undefined;
+    settings?: {
+        moduleCode: string;
+        groups: {
+            code: string;
+            name: string;
+            salesChannelCodes?: string[] | undefined;
+            isSystemProtected?: boolean | undefined;
+        }[];
+        settings: {
+            code: string;
+            name: string;
+            valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+            defaultValue: unknown;
+            description?: string | undefined;
+            groupCode?: string | undefined;
+            previousDefaultValues?: unknown[] | undefined;
+            salesChannelCodes?: string[] | undefined;
+            enumOptions?: string[] | undefined;
+            configurationType?: string | undefined;
+            hidden?: boolean | undefined;
+        }[];
+    } | undefined;
+    i18n?: {
+        bundlesDir: string;
+    } | undefined;
+    docs?: false | {
+        dir: string;
+    } | undefined;
+    demo?: false | {
+        summary: string;
+        seed: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoSeedResult>;
+        reset: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoResetResult>;
+        after?: readonly string[] | undefined;
+        package?: string | undefined;
+    } | undefined;
+    actions?: {
+        id: string;
+        labelKey: string;
+        icon: "Plus" | "Sparkles" | "Settings" | "Search" | "Boxes" | "Layers" | "Menu" | "PlusCircle" | "PlusSquare" | "FilePlus" | "FolderPlus" | "Upload" | "FileUp" | "CloudUpload" | "Download" | "FileDown" | "FileText" | "BookOpen" | "Rss" | "Package" | "Tag" | "ShoppingCart" | "Receipt" | "CreditCard" | "Users" | "UserPlus" | "Inbox" | "ListChecks" | "ClipboardList" | "Image" | "Video" | "LayoutDashboard" | "PanelLeft" | "KeyRound" | "ShieldCheck" | "Edit" | "Archive" | "Box" | "Truck" | "CircleDollarSign" | "Activity" | "LineChart" | "Smartphone" | "Webhook" | "Scale" | "PlugZap" | "PercentDiamond" | "Newspaper" | "Languages" | "Eraser" | "Warehouse" | "TrendingDown" | "Bell" | "PackageOpen" | "Building2" | "Store" | "ClipboardCheck";
+        targetRoute: string;
+        keywords: string[];
+        weight: number;
+        descriptionKey?: string | undefined;
+        requiredPermission?: string | undefined;
+    }[] | undefined;
+    permissions?: {
+        code: string;
+        label: string;
+        module?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+    }[] | undefined;
+    transactionalEmails?: {
+        code: string;
+        name: string;
+        variables: {
+            key: string;
+            label: string;
+            sampleValue?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    capabilities?: string[] | undefined;
+    exclusiveCapabilities?: {
+        key: string;
+        errorCode: string;
+    }[] | undefined;
+    errorCodes?: {
+        code: string;
+        tokens?: string[] | undefined;
+    }[] | undefined;
+    blocks?: {
+        name: string;
+        labelKey: string;
+        category: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        fields: Record<string, {
+            type: "number" | "object" | "array" | "text" | "textarea" | "select" | "radio" | "external" | "uuid" | "richtext";
+            label?: string | undefined;
+            required?: boolean | undefined;
+            options?: {
+                label: string;
+                value: string | number;
+            }[] | undefined;
+            refKind?: string | undefined;
+        }>;
+        descriptionKey?: string | undefined;
+        defaultProps?: Record<string, unknown> | undefined;
+        responsiveFields?: string[] | undefined;
+        previewIcon?: string | undefined;
+        weight?: number | undefined;
+    }[] | undefined;
+    blockCategories?: {
+        key: string;
+        titleKey: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        weight?: number | undefined;
+        visible?: boolean | undefined;
+    }[] | undefined;
+    env?: {
+        name: string;
+        describes: {
+            en: string;
+            pl: string;
+        };
+        requirement: {
+            kind: "required";
+        } | {
+            kind: "requiredWhen";
+            input: string;
+            equals: string;
+        } | {
+            kind: "optional";
+            without: {
+                en: string;
+                pl: string;
+            };
+        };
+        secret: boolean;
+        generable: boolean;
+        owner: {
+            kind: "platform";
+        } | {
+            kind: "application";
+            application: "admin" | "backend" | "storefront";
+        } | {
+            kind: "module";
+            moduleId: string;
+        };
+        consumers: ("admin" | "backend" | "storefront")[];
+        addressOf: "admin" | "backend" | "storefront" | null;
+    }[] | undefined;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;CAUzB,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;CAgHnC,CAAC;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwQnB,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,390 @@
+import { defineModuleManifest, defineModuleSettingsManifest } from '@endora-commerce/contracts';
+/**
+ * Invoices module — manifest (feature 047-invoices-module).
+ *
+ * Owns invoice generation (proforma / VAT invoice / correction), the per-channel
+ * numbering engine, the WYSIWYG PDF templates, seller company settings, and
+ * email delivery (through the transactional_emails module). Scalar settings are
+ * declared here and seeded by the module-lifecycle ManifestReconciler on boot;
+ * all are Sales-Channel-scopable through the standard settings scoping.
+ */
+export const INVOICES_SETTING_CODES = {
+    SELLER_TAX_ID: 'invoices.seller.tax_id',
+    SELLER_COMPANY_DATA: 'invoices.seller.company_data',
+    AUTO_ISSUE_TRIGGER_STATUS: 'invoices.auto_issue.trigger_status',
+    EMAIL_SEND_ON_ISSUE: 'invoices.email.send_on_issue',
+    EMAIL_DELIVERY_MODE: 'invoices.email.delivery_mode',
+    NUMBERING_INVOICE_PATTERN: 'invoices.numbering.invoice.pattern',
+    NUMBERING_PROFORMA_PATTERN: 'invoices.numbering.proforma.pattern',
+    NUMBERING_CORRECTION_PATTERN: 'invoices.numbering.correction.pattern',
+    STOREFRONT_BASE_URL: 'invoices.storefront_base_url',
+};
+export const invoicesSettingsManifest = defineModuleSettingsManifest({
+    moduleCode: 'invoices',
+    groups: [{ code: 'invoices', name: 'Invoices' }],
+    settings: [
+        {
+            // Feature 073 — the operator's activation control. Platform-wide.
+            code: 'invoices.enabled',
+            name: 'Invoices enabled',
+            description: 'Switches invoice issuance, corrections, the PDF renderer and the customer-facing invoice list on or off. Nothing is dropped: issued invoices, their numbering sequence and their templates stay in the database, and issuance resumes from the same sequence when you switch it back on.',
+            groupCode: 'invoices',
+            valueType: 'boolean',
+            defaultValue: true,
+        },
+        {
+            code: INVOICES_SETTING_CODES.SELLER_TAX_ID,
+            name: 'Seller VAT / NIP',
+            description: 'Your company VAT/NIP number printed on every invoice as the seller. Sales-channel value overrides the global value.',
+            groupCode: 'invoices',
+            valueType: 'string',
+            defaultValue: '',
+        },
+        {
+            code: INVOICES_SETTING_CODES.SELLER_COMPANY_DATA,
+            name: 'Seller company data',
+            description: 'Seller (your company) data printed on invoices: { legalName, addressLine1, addressLine2, postalCode, city, country, bankName, bankAccount, swift, email, phone }. JSON object.',
+            groupCode: 'invoices',
+            valueType: 'json',
+            defaultValue: {},
+        },
+        {
+            code: INVOICES_SETTING_CODES.AUTO_ISSUE_TRIGGER_STATUS,
+            name: 'Auto-issue on order status',
+            description: 'Order status code that automatically issues a VAT invoice when reached (e.g. "paid"). Empty = manual issuance only.',
+            groupCode: 'invoices',
+            valueType: 'string',
+            defaultValue: '',
+        },
+        {
+            code: INVOICES_SETTING_CODES.EMAIL_SEND_ON_ISSUE,
+            name: 'Email invoice on issue',
+            description: 'When enabled, the invoice is emailed to the customer automatically once issued.',
+            groupCode: 'invoices',
+            valueType: 'boolean',
+            defaultValue: false,
+        },
+        {
+            code: INVOICES_SETTING_CODES.EMAIL_DELIVERY_MODE,
+            name: 'Invoice email delivery mode',
+            description: 'Whether the invoice email carries the PDF as an attachment or a link to the storefront customer panel download.',
+            groupCode: 'invoices',
+            valueType: 'string',
+            defaultValue: 'attachment',
+            enumOptions: ['attachment', 'link'],
+        },
+        // Feature 078, D-95.3 — the three numbering defaults carry `{channel}`.
+        //
+        // Every channel used to resolve one and the same default, so *creating a
+        // sales channel* armed a duplicate: two channels drew sequence 1 in the
+        // same year, rendered one string, and the second issuance died on
+        // `invoices_number_unique`. The operator never had to open this screen for
+        // that to happen, which is why the fix is in the default rather than only
+        // in the write refusal.
+        //
+        // `previousDefaultValues` names the pre-D-95 string so `ManifestReconciler`
+        // migrates a deployment that never overrode it instead of refusing to boot.
+        // The system-default channel is pinned back to the old pattern by this
+        // module's boot hook, so no existing series changes shape.
+        {
+            code: INVOICES_SETTING_CODES.NUMBERING_INVOICE_PATTERN,
+            name: 'Invoice numbering pattern',
+            description: 'Format for VAT invoice numbers. Tokens: {seq}, {seq:N} (zero-padded), {channel} (the sales channel code), {YYYY}, {YY}, {MM}. The sequence resets yearly, per channel, while the number itself must be unique across the whole platform — so a pattern shared by two channels needs {channel} in it.',
+            groupCode: 'invoices',
+            valueType: 'string',
+            defaultValue: 'FV {seq}/{channel}/{YYYY}',
+            previousDefaultValues: ['FV {seq}/{YYYY}'],
+        },
+        {
+            code: INVOICES_SETTING_CODES.NUMBERING_PROFORMA_PATTERN,
+            name: 'Proforma numbering pattern',
+            description: 'Format for proforma numbers. Tokens: {seq}, {seq:N} (zero-padded), {channel} (the sales channel code), {YYYY}, {YY}, {MM}. The sequence resets yearly, per channel, while the number itself must be unique across the whole platform — so a pattern shared by two channels needs {channel} in it.',
+            groupCode: 'invoices',
+            valueType: 'string',
+            defaultValue: 'PRO {seq}/{channel}/{YYYY}',
+            previousDefaultValues: ['PRO {seq}/{YYYY}'],
+        },
+        {
+            code: INVOICES_SETTING_CODES.NUMBERING_CORRECTION_PATTERN,
+            name: 'Correction numbering pattern',
+            description: 'Format for corrective-invoice numbers. Tokens: {seq}, {seq:N} (zero-padded), {channel} (the sales channel code), {YYYY}, {YY}, {MM}. The sequence resets yearly, per channel, while the number itself must be unique across the whole platform — so a pattern shared by two channels needs {channel} in it.',
+            groupCode: 'invoices',
+            valueType: 'string',
+            defaultValue: 'KOR {seq}/{channel}/{YYYY}',
+            previousDefaultValues: ['KOR {seq}/{YYYY}'],
+        },
+        {
+            code: INVOICES_SETTING_CODES.STOREFRONT_BASE_URL,
+            name: 'Storefront base URL (for invoice email links)',
+            description: 'Base URL used to build the customer-panel invoice download link in link-mode emails (e.g. https://shop.example.com). Empty = links disabled.',
+            groupCode: 'invoices',
+            valueType: 'string',
+            defaultValue: '',
+        },
+    ],
+});
+export const manifest = defineModuleManifest({
+    id: 'invoices',
+    name: 'Invoices',
+    description: 'Invoice generation, numbering, PDF templates, corrections, and email delivery.',
+    version: '2.0.0',
+    // `auth` owns the `requireAdmin` port and the customer guard this module
+    // resolves; feature 072 made both container resolutions.
+    // `ksef` is deliberately absent: it reads `invoiceService`, so declaring it
+    // here would close a cycle. The KSeF verification block reaches this module
+    // as a contribution a root fills, not as a port this module resolves.
+    //
+    // `assets_library` and `customer_accounts` joined in
+    // `specs/110-instance-repository/` T118c, when `invoicesBridge` was retired:
+    // the operator's logo is `assetReadPort` and the invoice e-mail's recipient
+    // is `customerAccountReadPort`, both resolved by this module now and both
+    // reached through a composition root's closure before. Binding edges, and
+    // **neither costs an operator a control** — derived and not waived: both
+    // owners declare `activation.nonDeactivatable`, so there is no switchable
+    // owner for a `refuses-without` sentence to describe. That is the same answer
+    // `mfa` and `product_feeds` came to and a different one from `returns`, and
+    // the difference is the owners', not the consumer's.
+    dependencies: [
+        'assets_library',
+        'auth',
+        'customer_accounts',
+        'orders',
+        'organizations',
+        'settings',
+        'transactional_emails',
+    ],
+    nonBindingDependencies: [
+        {
+            moduleId: 'invoice_ledger',
+            name: 'invoiceLedgerRoutingPort',
+            kind: 'degrades-without',
+            whenAbsent: 'Issuance stays Endora-numbered and ready; mode B wait is ignored.',
+            reason: 'InvoiceService.issue holds pending only when the ledger module is present and numbering is vendor.',
+        },
+    ],
+    settings: invoicesSettingsManifest,
+    i18n: { bundlesDir: 'i18n' },
+    docs: { dir: 'docs' },
+    // Feature 047 — admin-editable transactional email owned by this module.
+    transactionalEmails: [
+        {
+            code: 'invoice_issued',
+            name: 'Invoice issued',
+            group: 'invoices',
+            variables: [
+                { key: 'invoice.number', label: 'Invoice number', sampleValue: 'FV 26/2026' },
+                { key: 'invoice.total', label: 'Invoice total', sampleValue: '6 648,15' },
+                { key: 'invoice.currency', label: 'Currency', sampleValue: 'PLN' },
+                { key: 'order.businessId', label: 'Order number', sampleValue: 'ORD-1042' },
+                { key: 'invoice.downloadUrl', label: 'Download link', sampleValue: 'https://shop.example.com/orders/…' },
+            ],
+        },
+    ],
+    permissions: [
+        { code: 'invoices:read', label: 'View invoices and download invoice PDFs' },
+        { code: 'invoices:write', label: 'Issue/correct invoices, edit templates, and configure invoicing' },
+    ],
+    /**
+     * The three error codes this module owns — feature 090 Phase 3
+     * (`specs/090-module-owned-error-codes/contracts/error-code-declaration.md`
+     * §1.1). This is where each sentence is looked up from: `errors.<CODE>` in this
+     * module's own `i18n/{en,pl}.json`, which already holds all three in both
+     * languages.
+     *
+     * The list is answer-preserving, not a judgement (§6.2 and §6.5): it is exactly
+     * what the prefix chain in `@endora-commerce/mod-i18n` routes here today,
+     * copied from the frozen capture at
+     * `backend/test/fixtures/error-code-routing/chain-answers.ts` rather than
+     * re-derived. Re-routing a code to a better owner is
+     * `specs/082-error-code-ownership/rulings.md` §9's remaining work and is
+     * deliberately not done here.
+     *
+     * **This module's list and this module's `throw`s are two different sets, in
+     * both directions**, because ownership follows the domain noun and never the
+     * thrower (D-95.2). `INVOICE_NOT_READY` is declared here and raised **only** by
+     * `orders`, at both ends of its invoice-download path — `GET
+     * /api/v1/orders/:id/invoice` and `POST /api/v1/admin/orders/bulk/print-invoices`,
+     * both in that module's `routes.ts`. Going the other way, five
+     * codes this module does raise belong elsewhere and are absent below:
+     * `ORDER_NOT_FOUND` is `orders`', and `NOT_FOUND`, `VALIDATION_FAILED`,
+     * `VERSION_CONFLICT` and `INTERNAL` are the platform's.
+     *
+     * **One more code a reader will look for here and not find.**
+     * `PDF_GENERATION_FAILED` reads like this module's — it renders every invoice
+     * PDF — and is `comparisons`', by the chain's own `code ===
+     * ERROR_CODES.PDF_GENERATION_FAILED` rule. Nothing here raises it: this
+     * module's PDF path throws no `HttpError` at all.
+     *
+     * **The tokens come off the raise sites, not off the bundle.** The envelope's
+     * `refusalToken` (`packages/platform/src/http/error-envelope.ts`) reads exactly
+     * one member of `details` — `code` — as the tail of `errors.<CODE>.<token>`, so
+     * the token set is the set of values this module's raise sites can put there.
+     * Unlike `carts` there is no enum and no named type here: every value is a bare
+     * string literal, so the set is complete once the raise sites are enumerated,
+     * and enumerating them completely is the whole of the work. Each token list
+     * below is in raise-site order.
+     *
+     * - `INVOICE_NUMBER_ALREADY_ISSUED` — `duplicate-number-refusal.ts` throws it
+     *   twice. The second throw writes `code: sameChannel ? 'same_channel' :
+     *   'other_channel'`; the first, taken when the row holding the number has been
+     *   deleted between the constraint violation and the read, deliberately passes
+     *   no `code` and so answers the tokenless base sentence.
+     * - `INVOICE_NUMBER_PATTERN_COLLIDES` — `numbering-write-validator.ts` throws it
+     *   twice too, `{ code: 'no_sequence_token' }` for the self-collision and
+     *   `code: 'other_channel'` for the pairwise one. Two separate throws in one
+     *   file: an author who stopped at the first grep hit would declare one token
+     *   and lose the other.
+     * - `INVOICE_NOT_READY` — neither raise site passes `details` at all, so it
+     *   carries no token.
+     *
+     * The bundle holds a sentence for all four and for no fifth, and
+     * `backend/test/unit/invoices/error-sentences.test.ts` enumerates the same
+     * seven keys by hand. Both agree with the raise sites; neither is the
+     * authority, because a token nobody has written a sentence for is still a token
+     * (`specs/090-module-owned-error-codes/migration-runbook.md` §5).
+     */
+    errorCodes: [
+        { code: 'INVOICE_NOT_READY' },
+        { code: 'INVOICE_NUMBER_ALREADY_ISSUED', tokens: ['same_channel', 'other_channel'] },
+        {
+            code: 'INVOICE_NUMBER_PATTERN_COLLIDES',
+            tokens: ['no_sequence_token', 'other_channel'],
+        },
+    ],
+    actions: [
+        {
+            id: 'open-invoices',
+            labelKey: 'actions.openInvoices.label',
+            descriptionKey: 'actions.openInvoices.description',
+            icon: 'FileText',
+            targetRoute: '/invoices',
+            requiredPermission: 'invoices:read',
+            keywords: ['invoices', 'faktury', 'vat', 'billing'],
+            weight: 240,
+        },
+        {
+            id: 'invoice-templates',
+            labelKey: 'actions.invoiceTemplates.label',
+            descriptionKey: 'actions.invoiceTemplates.description',
+            icon: 'Layers',
+            targetRoute: '/invoices/templates',
+            // `invoices:read` — `GET /api/v1/admin/invoice-templates` is read-gated,
+            // and the row is a destination rather than an operation (issue #232).
+            requiredPermission: 'invoices:read',
+            keywords: ['invoice template', 'szablon faktury', 'pdf'],
+            weight: 245,
+        },
+    ],
+    activation: { settingCode: 'invoices.enabled', default: true },
+    /**
+     * The 10 invoice-template blocks this module owns, and the Invoice sections
+     * section they populate (feature 096, §7.3 and §2.1).
+     *
+     * The eleventh block in that palette, `InvoiceKsef`, is **`ksef`'s** —
+     * `ksef.InvoiceSection`, by the owner ruling of 2026-09-02 — which is why
+     * weight 70 is left unused here.
+     *
+     * The category declaration carries a **`weight`** deliberately. `ksef`
+     * declares the same section, joining it with no `weight` and no `visible`, so
+     * under `contracts/block-definition.md` §1.1's total order this declaration
+     * wins on weight and names the section. Leaving the weight off would put the
+     * pair on the module-id tie-break, which happens to give the same answer
+     * today and gives it for no stated reason.
+     */
+    blocks: [
+        {
+            name: 'invoices.InvoiceHeader',
+            labelKey: 'blocks.invoiceHeader.label',
+            descriptionKey: 'blocks.invoiceHeader.description',
+            category: 'invoice',
+            contexts: ['invoice'],
+            fields: {},
+            weight: 10,
+        },
+        {
+            name: 'invoices.InvoiceParties',
+            labelKey: 'blocks.invoiceParties.label',
+            descriptionKey: 'blocks.invoiceParties.description',
+            category: 'invoice',
+            contexts: ['invoice'],
+            fields: {},
+            weight: 20,
+        },
+        {
+            name: 'invoices.InvoiceLineItems',
+            labelKey: 'blocks.invoiceLineItems.label',
+            descriptionKey: 'blocks.invoiceLineItems.description',
+            category: 'invoice',
+            contexts: ['invoice'],
+            fields: {},
+            weight: 30,
+        },
+        {
+            name: 'invoices.InvoiceVatSummary',
+            labelKey: 'blocks.invoiceVatSummary.label',
+            descriptionKey: 'blocks.invoiceVatSummary.description',
+            category: 'invoice',
+            contexts: ['invoice'],
+            fields: {},
+            weight: 40,
+        },
+        {
+            name: 'invoices.InvoiceTotals',
+            labelKey: 'blocks.invoiceTotals.label',
+            descriptionKey: 'blocks.invoiceTotals.description',
+            category: 'invoice',
+            contexts: ['invoice'],
+            fields: {},
+            weight: 50,
+        },
+        {
+            name: 'invoices.InvoiceNotes',
+            labelKey: 'blocks.invoiceNotes.label',
+            descriptionKey: 'blocks.invoiceNotes.description',
+            category: 'invoice',
+            contexts: ['invoice'],
+            fields: {},
+            weight: 60,
+        },
+        {
+            name: 'invoices.InvoiceSpacer',
+            labelKey: 'blocks.invoiceSpacer.label',
+            descriptionKey: 'blocks.invoiceSpacer.description',
+            category: 'invoice',
+            contexts: ['invoice'],
+            fields: {},
+            weight: 80,
+        },
+        {
+            name: 'invoices.InvoiceDivider',
+            labelKey: 'blocks.invoiceDivider.label',
+            descriptionKey: 'blocks.invoiceDivider.description',
+            category: 'invoice',
+            contexts: ['invoice'],
+            fields: {},
+            weight: 90,
+        },
+        {
+            name: 'invoices.InvoiceLogo',
+            labelKey: 'blocks.invoiceLogo.label',
+            descriptionKey: 'blocks.invoiceLogo.description',
+            category: 'invoice',
+            contexts: ['invoice'],
+            fields: {},
+            weight: 100,
+        },
+        {
+            name: 'invoices.InvoiceFooter',
+            labelKey: 'blocks.invoiceFooter.label',
+            descriptionKey: 'blocks.invoiceFooter.description',
+            category: 'invoice',
+            contexts: ['invoice'],
+            fields: {},
+            weight: 110,
+        },
+    ],
+    blockCategories: [
+        { key: 'invoice', titleKey: 'blocks.category.invoice', contexts: ['invoice'], weight: 10 },
+    ],
+});
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/migrations/20260629T125121_invoices_module.d.ts

@@ -0,0 +1,17 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Feature 047 — Invoices module.
+ *
+ * Extends the existing `invoices` table (created in 004_commerce_init) with the
+ * fields needed for real VAT invoices, and adds the supporting tables:
+ *   - `invoice_lines`            — immutable per-line snapshots
+ *   - `invoice_number_counters`  — per (channel, kind, year) gap-free sequence
+ *   - `invoice_templates`        — WYSIWYG (Puck) PDF layouts (global + per-channel)
+ *
+ * No email-log table — invoice emails reuse the `transactional_emails` module.
+ */
+export declare class Migration20260629T125121InvoicesModule extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260629T125121_invoices_module.d.ts.map

package/dist/migrations/20260629T125121_invoices_module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260629T125121_invoices_module.d.ts","sourceRoot":"","sources":["../../src/migrations/20260629T125121_invoices_module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;GAUG;AACH,qBAAa,sCAAuC,SAAQ,SAAS;IACpD,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IA0FnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA0BrC"}