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

package/dist/backend/services/invoice-number-generator.js

@@ -0,0 +1,157 @@
+import { LockMode } from '@mikro-orm/core';
+import { z } from 'zod';
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+import { InvoiceNumberCounter } from '../entities/invoice-number-counter.entity.js';
+/**
+ * The shipped defaults, which **must** stay identical to the manifest
+ * `defaultValue`s (`manifest.ts`): the manifest default is what production
+ * resolves, and this map is only reached when the settings read throws.
+ *
+ * The `/` on both sides of `{channel}` is load-bearing, not cosmetic. A
+ * discriminator concatenated straight onto the sequence loses the boundary
+ * between the two variable-length fields, so `FV {channel}{seq}/{YYYY}` renders
+ * `FV A12/2026` for both (`a1`, seq 2) and (`a`, seq 12) — see D-95.1
+ * property 3.
+ */
+const DEFAULT_PATTERNS = {
+    invoice: 'FV {seq}/{channel}/{YYYY}',
+    proforma: 'PRO {seq}/{channel}/{YYYY}',
+    correction: 'KOR {seq}/{channel}/{YYYY}',
+};
+/** The pre-D-95 defaults, kept for the system-default channel (D-95.3 move 3). */
+export const PRE_CHANNEL_DEFAULT_PATTERNS = {
+    invoice: 'FV {seq}/{YYYY}',
+    proforma: 'PRO {seq}/{YYYY}',
+    correction: 'KOR {seq}/{YYYY}',
+};
+/**
+ * The pattern a stored setting value really means: a blank value is not an
+ * empty pattern, it is "unset", and it resolves to the default. Two channels
+ * can therefore collide while their stored values differ, which is why the
+ * collision predicate compares what would be *resolved* and never the raw row.
+ */
+export function effectivePattern(kind, stored) {
+    return stored && stored.trim() ? stored : DEFAULT_PATTERNS[kind];
+}
+/**
+ * Render an invoice-number pattern. Supported tokens:
+ *   {seq}      — sequence number
+ *   {seq:N}    — zero-padded to width N
+ *   {channel}  — the sales channel discriminator (feature 078, D-95)
+ *   {YYYY}     — 4-digit year
+ *   {YY}       — 2-digit year
+ *   {MM}       — 2-digit month
+ * Everything else is literal (so prefix/suffix are just literal text).
+ *
+ * `channel` is a **required** member of the context, not an optional one
+ * defaulting to `''`: an absent discriminator makes every channel render
+ * identically, which is the defect this token exists to remove. A caller that
+ * cannot name a channel must fail rather than render.
+ *
+ * Pure — the collision predicate and the boot report both call it directly.
+ */
+export function formatInvoiceNumber(pattern, ctx) {
+    const year = ctx.date.getFullYear();
+    const month = ctx.date.getMonth() + 1;
+    return pattern.replace(/\{(seq(?::(\d+))?|channel|YYYY|YY|MM)\}/g, (_m, token, pad) => {
+        if (token === 'YYYY')
+            return String(year);
+        if (token === 'YY')
+            return String(year % 100).padStart(2, '0');
+        if (token === 'MM')
+            return String(month).padStart(2, '0');
+        if (token === 'channel')
+            return ctx.channel;
+        // seq or seq:N
+        if (pad)
+            return String(ctx.seq).padStart(Number(pad), '0');
+        return String(ctx.seq);
+    });
+}
+/**
+ * The discriminator a channel code renders as: uppercase, and otherwise
+ * verbatim. The code charset is `/^[a-z][a-z0-9_-]*$/`, so uppercasing is
+ * injective — no two channels can produce the same discriminator. Stripping or
+ * folding any character would break that and is forbidden.
+ */
+export function channelDiscriminator(code) {
+    return code.toUpperCase();
+}
+/**
+ * Draws gap-free, per-(channel, kind, year) sequence numbers under a pessimistic
+ * row lock and assembles the human-readable number from the configured pattern.
+ */
+export class InvoiceNumberGenerator {
+    patterns;
+    constructor(patterns) {
+        this.patterns = patterns;
+    }
+    /** Must run inside an open transaction (`em.transactional(...)`). */
+    async next(tx, kind, salesChannelId, issuedAt) {
+        // command-coverage-ignore: gap-free sequence-counter increment under a row
+        // lock, invoked within the audited issue()/createCorrection() transaction;
+        // internal numbering bookkeeping, not a standalone audited write.
+        const periodYear = issuedAt.getFullYear();
+        let counter = await tx.findOne(InvoiceNumberCounter, { salesChannelId, kind, periodYear }, { lockMode: LockMode.PESSIMISTIC_WRITE });
+        if (!counter) {
+            counter = tx.create(InvoiceNumberCounter, { salesChannelId, kind, periodYear, currentValue: 0 });
+        }
+        counter.currentValue += 1;
+        await tx.persistAndFlush(counter);
+        const pattern = await this.resolvePattern(kind, salesChannelId);
+        return formatInvoiceNumber(pattern, {
+            seq: counter.currentValue,
+            date: issuedAt,
+            channel: await this.resolveDiscriminator(tx, salesChannelId),
+        });
+    }
+    /**
+     * The `{channel}` discriminator for a channel id, read from the kernel's
+     * `sales_channels` row.
+     *
+     * An absent row **fails** rather than rendering an empty discriminator. A
+     * fallback here would put every channel back on one string and restore the
+     * defect this feature removes; a `salesChannelId` with no row behind it is a
+     * data defect in whatever produced it (`Order.salesChannelId` is non-nullable
+     * and a system-default channel always exists), and it is reported, not
+     * absorbed.
+     */
+    async resolveDiscriminator(tx, salesChannelId) {
+        const channel = await tx.findOne(SalesChannel, { id: salesChannelId });
+        if (!channel) {
+            throw new HttpError(500, ERROR_CODES.INTERNAL, `Sales channel "${salesChannelId}" has no row, so an invoice number cannot be ` +
+                `rendered for it.`);
+        }
+        return channelDiscriminator(channel.code);
+    }
+    async resolvePattern(kind, salesChannelId) {
+        if (!this.patterns)
+            return DEFAULT_PATTERNS[kind];
+        try {
+            return effectivePattern(kind, await this.patterns.resolvePattern(kind, salesChannelId));
+        }
+        catch {
+            return DEFAULT_PATTERNS[kind];
+        }
+    }
+}
+/**
+ * Settings-backed pattern resolver: reads `invoices.numbering.<kind>.pattern`
+ * per sales channel, falling back to the built-in default.
+ */
+export function createSettingsPatternResolver(settingsService) {
+    return {
+        async resolvePattern(kind, salesChannelId) {
+            try {
+                return await settingsService.get(`invoices.numbering.${kind}.pattern`, salesChannelId, z.string());
+            }
+            catch {
+                return DEFAULT_PATTERNS[kind];
+            }
+        },
+    };
+}
+export { DEFAULT_PATTERNS };
+//# sourceMappingURL=invoice-number-generator.js.map

package/dist/backend/services/invoice-number-generator.js.map

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

package/dist/backend/services/invoice-pdf-block-registry.d.ts

@@ -0,0 +1,65 @@
+import type { InvoicePdfBlockRegistration, InvoicePdfBlockRegistryPort } from '@endora-commerce/contracts';
+/** Two different contributions for one block name. */
+export declare class InvoicePdfBlockConflictError extends Error {
+    constructor(name: string, existingModuleId: string, moduleId: string);
+}
+/** A registration this registry refuses on its shape, before it is stored. */
+export declare class InvoicePdfBlockRegistrationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Invoice template blocks another module renders onto the PDF
+ * (`specs/134-paid-module-extraction/` T063 and T126; `research.md` D11, D12
+ * and D16 §2(e)).
+ *
+ * **Why the seam exists.** `ksef.InvoiceSection` is declared by `ksef`, and
+ * until T063 this module seeded, rendered and described it, while the data its
+ * QR code needs reached the renderer only where a composition root called
+ * `setKsefVerificationResolver`. Both halves read as working for as long as
+ * both modules were in the tree, and the second did not work at all on an
+ * instance composed through the platform alone. The declaring module now
+ * renders, describes and enriches its own block, and registers all three here
+ * from its composition root; this module names no contributor.
+ *
+ * **A contribution registry in D-39's sense**, and a plain `di.register`: a
+ * contributor pushes from a boot hook whatever this module's effective state
+ * is, so a gate here would stop the backend from starting for an operator who
+ * switched invoicing off.
+ *
+ * **The policy it states: skip an absent contributor's block.** While the
+ * declaring module is not present its block is not described to the builder,
+ * not resolved and not rendered — the same answer a stored block of an
+ * uninstalled module gets (`specs/096-page-builder-block-ownership/` FR-019,
+ * FR-020): the PDF simply has no such section, and the stored props are
+ * untouched. Presence is read on every call, so switching the contributor back
+ * on takes effect on the next render with no restart.
+ *
+ * Three more rules, each stated because the alternative is plausible:
+ *
+ *  1. **The owner segment is the contributor.** A block name is
+ *     `<moduleId>.<LocalName>` and is persisted in every template that places
+ *     it, so a module may contribute only under its own id — the rule
+ *     `check:block-names` holds manifests to.
+ *  2. **`invoices`' own blocks are not contributable.** This module renders its
+ *     ten itself; a contribution under `invoices.` could only shadow one.
+ *  3. **A second contributor for one name is refused**, not ordered, so which
+ *     module renders a block never depends on which composed last. The
+ *     identical registration twice is accepted.
+ */
+export declare class InvoicePdfBlockRegistry implements InvoicePdfBlockRegistryPort {
+    private readonly isModulePresent;
+    private readonly registrations;
+    /**
+     * @param isModulePresent the effective-state probe. Defaults to
+     *   always-present, so a registry a unit test builds answers about what that
+     *   test registered; the module's composition wires it to the kernel's
+     *   effective state.
+     */
+    constructor(isModulePresent?: (moduleId: string) => boolean);
+    register(registration: InvoicePdfBlockRegistration): void;
+    /** The contributed block of that name, or `undefined` while its contributor is absent. */
+    find(name: string): InvoicePdfBlockRegistration | undefined;
+    /** Every contributed block whose contributor is present, in registration order. */
+    present(): InvoicePdfBlockRegistration[];
+}
+//# sourceMappingURL=invoice-pdf-block-registry.d.ts.map

package/dist/backend/services/invoice-pdf-block-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-pdf-block-registry.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-pdf-block-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,4BAA4B,CAAC;AAEpC,sDAAsD;AACtD,qBAAa,4BAA6B,SAAQ,KAAK;gBACzC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAOrE;AAED,8EAA8E;AAC9E,qBAAa,gCAAiC,SAAQ,KAAK;gBAC7C,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,uBAAwB,YAAW,2BAA2B;IAS7D,OAAO,CAAC,QAAQ,CAAC,eAAe;IAR5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkD;IAEhF;;;;;OAKG;gBAC0B,eAAe,GAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAoB;IAExF,QAAQ,CAAC,YAAY,EAAE,2BAA2B,GAAG,IAAI;IAqBzD,0FAA0F;IAC1F,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS;IAK3D,mFAAmF;IACnF,OAAO,IAAI,2BAA2B,EAAE;CAKzC"}

package/dist/backend/services/invoice-pdf-block-registry.js

@@ -0,0 +1,94 @@
+/** Two different contributions for one block name. */
+export class InvoicePdfBlockConflictError extends Error {
+    constructor(name, existingModuleId, moduleId) {
+        super(`invoicePdfBlockRegistry: block "${name}" is already contributed by module ` +
+            `"${existingModuleId}"; module "${moduleId}" cannot register a second one.`);
+        this.name = 'InvoicePdfBlockConflictError';
+    }
+}
+/** A registration this registry refuses on its shape, before it is stored. */
+export class InvoicePdfBlockRegistrationError extends Error {
+    constructor(message) {
+        super(`invoicePdfBlockRegistry: ${message}`);
+        this.name = 'InvoicePdfBlockRegistrationError';
+    }
+}
+/**
+ * Invoice template blocks another module renders onto the PDF
+ * (`specs/134-paid-module-extraction/` T063 and T126; `research.md` D11, D12
+ * and D16 §2(e)).
+ *
+ * **Why the seam exists.** `ksef.InvoiceSection` is declared by `ksef`, and
+ * until T063 this module seeded, rendered and described it, while the data its
+ * QR code needs reached the renderer only where a composition root called
+ * `setKsefVerificationResolver`. Both halves read as working for as long as
+ * both modules were in the tree, and the second did not work at all on an
+ * instance composed through the platform alone. The declaring module now
+ * renders, describes and enriches its own block, and registers all three here
+ * from its composition root; this module names no contributor.
+ *
+ * **A contribution registry in D-39's sense**, and a plain `di.register`: a
+ * contributor pushes from a boot hook whatever this module's effective state
+ * is, so a gate here would stop the backend from starting for an operator who
+ * switched invoicing off.
+ *
+ * **The policy it states: skip an absent contributor's block.** While the
+ * declaring module is not present its block is not described to the builder,
+ * not resolved and not rendered — the same answer a stored block of an
+ * uninstalled module gets (`specs/096-page-builder-block-ownership/` FR-019,
+ * FR-020): the PDF simply has no such section, and the stored props are
+ * untouched. Presence is read on every call, so switching the contributor back
+ * on takes effect on the next render with no restart.
+ *
+ * Three more rules, each stated because the alternative is plausible:
+ *
+ *  1. **The owner segment is the contributor.** A block name is
+ *     `<moduleId>.<LocalName>` and is persisted in every template that places
+ *     it, so a module may contribute only under its own id — the rule
+ *     `check:block-names` holds manifests to.
+ *  2. **`invoices`' own blocks are not contributable.** This module renders its
+ *     ten itself; a contribution under `invoices.` could only shadow one.
+ *  3. **A second contributor for one name is refused**, not ordered, so which
+ *     module renders a block never depends on which composed last. The
+ *     identical registration twice is accepted.
+ */
+export class InvoicePdfBlockRegistry {
+    isModulePresent;
+    registrations = new Map();
+    /**
+     * @param isModulePresent the effective-state probe. Defaults to
+     *   always-present, so a registry a unit test builds answers about what that
+     *   test registered; the module's composition wires it to the kernel's
+     *   effective state.
+     */
+    constructor(isModulePresent = () => true) {
+        this.isModulePresent = isModulePresent;
+    }
+    register(registration) {
+        const { name, moduleId } = registration;
+        if (moduleId === 'invoices' || name.startsWith('invoices.')) {
+            throw new InvoicePdfBlockRegistrationError(`"${name}" is under \`invoices\`' own namespace — this module renders its own blocks itself.`);
+        }
+        if (!name.startsWith(`${moduleId}.`) || name.length <= moduleId.length + 1) {
+            throw new InvoicePdfBlockRegistrationError(`"${name}" does not carry "${moduleId}" as its owner segment — a module contributes ` +
+                'only the blocks its own manifest declares.');
+        }
+        const existing = this.registrations.get(name);
+        if (existing) {
+            if (existing === registration)
+                return;
+            throw new InvoicePdfBlockConflictError(name, existing.moduleId, moduleId);
+        }
+        this.registrations.set(name, registration);
+    }
+    /** The contributed block of that name, or `undefined` while its contributor is absent. */
+    find(name) {
+        const registration = this.registrations.get(name);
+        return registration && this.isModulePresent(registration.moduleId) ? registration : undefined;
+    }
+    /** Every contributed block whose contributor is present, in registration order. */
+    present() {
+        return [...this.registrations.values()].filter((registration) => this.isModulePresent(registration.moduleId));
+    }
+}
+//# sourceMappingURL=invoice-pdf-block-registry.js.map

package/dist/backend/services/invoice-pdf-block-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-pdf-block-registry.js","sourceRoot":"","sources":["../../../src/backend/services/invoice-pdf-block-registry.ts"],"names":[],"mappings":"AAKA,sDAAsD;AACtD,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,YAAY,IAAY,EAAE,gBAAwB,EAAE,QAAgB;QAClE,KAAK,CACH,mCAAmC,IAAI,qCAAqC;YAC1E,IAAI,gBAAgB,cAAc,QAAQ,iCAAiC,CAC9E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,OAAO,gCAAiC,SAAQ,KAAK;IACzD,YAAY,OAAe;QACzB,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,OAAO,uBAAuB;IASL;IARZ,aAAa,GAAG,IAAI,GAAG,EAAuC,CAAC;IAEhF;;;;;OAKG;IACH,YAA6B,kBAAiD,GAAG,EAAE,CAAC,IAAI;QAA3D,oBAAe,GAAf,eAAe,CAA4C;IAAG,CAAC;IAE5F,QAAQ,CAAC,YAAyC;QAChD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC;QACxC,IAAI,QAAQ,KAAK,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,gCAAgC,CACxC,IAAI,IAAI,qFAAqF,CAC9F,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,gCAAgC,CACxC,IAAI,IAAI,qBAAqB,QAAQ,gDAAgD;gBACnF,4CAA4C,CAC/C,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,QAAQ,KAAK,YAAY;gBAAE,OAAO;YACtC,MAAM,IAAI,4BAA4B,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED,0FAA0F;IAC1F,IAAI,CAAC,IAAY;QACf,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,YAAY,IAAI,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAChG,CAAC;IAED,mFAAmF;IACnF,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAC9D,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,QAAQ,CAAC,CAC5C,CAAC;IACJ,CAAC;CACF"}

package/dist/backend/services/invoice-pdf-renderer.d.ts

@@ -0,0 +1,57 @@
+import type { Content } from 'pdfmake/interfaces.js';
+import type { InvoiceDetail } from '@endora-commerce/contracts';
+import type { AmountToWordsLocale } from './amount-to-words.js';
+import { InvoicePdfBlockRegistry } from './invoice-pdf-block-registry.js';
+import { type LoadAssetImage } from '../pdf-components/embed-logo-images.js';
+export type InvoicePdfRendererOptions = {
+    /** Load library asset bytes for InvoiceLogo (avoids pdfmake self-HTTP). */
+    loadAssetImage?: LoadAssetImage;
+    /**
+     * The blocks other modules render (T063/T126). Defaults to an empty,
+     * always-present registry, so a renderer a unit test builds renders this
+     * module's own blocks and nothing else.
+     */
+    blocks?: InvoicePdfBlockRegistry;
+};
+/**
+ * Renders an invoice to a PDF Buffer using pdfmake (feature 047, R1/R2/US6).
+ *
+ * When a WYSIWYG (Puck) template tree is supplied and yields renderable invoice
+ * components, the PDF follows that layout; otherwise it falls back to the
+ * built-in generic layout (FR-016). Both paths share the same section builders.
+ */
+export declare class InvoicePdfRenderer {
+    #private;
+    /**
+     * The contributed-block seam — the generalisation of the
+     * `setKsefVerificationResolver` this class carried from feature 059 to 134.
+     *
+     * That setter was one vendor's contribution point: a composition root had to
+     * call it after building both modules, which only this repository's
+     * reference root did, so on an instance composed through the platform the
+     * PDF carried no KSeF verification block while `ksef` was installed and on
+     * (`research.md` D16 §1 item 7). A contributor now registers the whole block —
+     * renderer, description and the per-render data it needs — from its own
+     * composition, and every render path reads it here.
+     */
+    readonly blocks: InvoicePdfBlockRegistry;
+    constructor(opts?: InvoicePdfRendererOptions);
+    render(invoice: InvoiceDetail, locale?: AmountToWordsLocale, templateTree?: unknown): Promise<Buffer>;
+    /**
+     * The pdfmake content an invoice renders to — the template's blocks, or the
+     * built-in layout when the template places none this module or a present
+     * contributor renders (FR-016).
+     *
+     * Public because it is the one place every render path meets, which makes it
+     * the place a test asserts what a PDF carries without parsing one.
+     */
+    content(invoice: InvoiceDetail, locale?: AmountToWordsLocale, templateTree?: unknown): Promise<Content[]>;
+    /**
+     * Each block's per-render data, read once. A rejection is the block's `null`:
+     * the data is an enrichment, and an invoice — a legal document — never fails
+     * to render on it. The `catch` is around a contributed callback, not a port.
+     */
+    private resolveContributed;
+    private buildDoc;
+}
+//# sourceMappingURL=invoice-pdf-renderer.d.ts.map

package/dist/backend/services/invoice-pdf-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-pdf-renderer.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-pdf-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAyC,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,4BAA4B,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAchE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,wCAAwC,CAAC;AA+DhD,MAAM,MAAM,yBAAyB,GAAG;IACtC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;OAIG;IACH,MAAM,CAAC,EAAE,uBAAuB,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,kBAAkB;;IAG7B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;gBAE7B,IAAI,GAAE,yBAA8B;IAK1C,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,MAAM,GAAE,mBAA0B,EAClC,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,MAAM,CAAC;IAWlB;;;;;;;OAOG;IACG,OAAO,CACX,OAAO,EAAE,aAAa,EACtB,MAAM,GAAE,mBAA0B,EAClC,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,OAAO,EAAE,CAAC;IAgDrB;;;;OAIG;YACW,kBAAkB;IAgBhC,OAAO,CAAC,QAAQ;CASjB"}

package/dist/backend/services/invoice-pdf-renderer.js

@@ -0,0 +1,158 @@
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { headerSection, partiesSection, lineItemsSection, vatSummarySection, totalsSection, } from '../pdf-components/sections.js';
+import { INVOICE_COMPONENT_NAMES, placedBlockNames, treeToContent, } from '../pdf-components/tree-mapper.js';
+import { InvoicePdfBlockRegistry } from './invoice-pdf-block-registry.js';
+import { embedInvoiceLogoImages, } from '../pdf-components/embed-logo-images.js';
+const requireFromHere = createRequire(import.meta.url);
+const pdfMake = requireFromHere('pdfmake');
+function buildFontDictionary() {
+    const fontsDir = requireFromHere
+        .resolve('pdfmake/package.json')
+        .replace(/package\.json$/, `fonts${path.sep}Roboto${path.sep}`);
+    return {
+        Roboto: {
+            normal: `${fontsDir}Roboto-Regular.ttf`,
+            bold: `${fontsDir}Roboto-Medium.ttf`,
+            italics: `${fontsDir}Roboto-Italic.ttf`,
+            bolditalics: `${fontsDir}Roboto-MediumItalic.ttf`,
+        },
+    };
+}
+let fontsRegistered = false;
+/**
+ * Built-in generic layout — the FR-016 fallback when no valid template exists.
+ *
+ * Its last entries are the present contributors' blocks, with their default
+ * props. That is where `ksefSection(inv)` used to be written out: a use of the
+ * KSeF block the E4 ruling's table did not list, generalised with the other
+ * four rather than kept (`specs/134-paid-module-extraction/` T063).
+ */
+function builtinLayout(inv, locale, contributed, suppressKsefNumber) {
+    return [
+        headerSection(inv, {}, { suppressKsefNumber }),
+        partiesSection(inv),
+        lineItemsSection(inv),
+        {
+            columns: [
+                { width: '55%', stack: [vatSummarySection(inv)] },
+                { width: '45%', stack: [totalsSection(inv, locale)] },
+            ],
+            margin: [0, 0, 0, 16],
+        },
+        ...(inv.kind === 'correction' && inv.originalInvoiceId
+            ? [{ text: 'Dokument korygujący do faktury pierwotnej.', italics: true, margin: [0, 0, 0, 8] }]
+            : []),
+        ...contributed,
+    ];
+}
+const OWN_BLOCKS = new Set(INVOICE_COMPONENT_NAMES);
+/**
+ * Renders an invoice to a PDF Buffer using pdfmake (feature 047, R1/R2/US6).
+ *
+ * When a WYSIWYG (Puck) template tree is supplied and yields renderable invoice
+ * components, the PDF follows that layout; otherwise it falls back to the
+ * built-in generic layout (FR-016). Both paths share the same section builders.
+ */
+export class InvoicePdfRenderer {
+    #loadAssetImage;
+    /**
+     * The contributed-block seam — the generalisation of the
+     * `setKsefVerificationResolver` this class carried from feature 059 to 134.
+     *
+     * That setter was one vendor's contribution point: a composition root had to
+     * call it after building both modules, which only this repository's
+     * reference root did, so on an instance composed through the platform the
+     * PDF carried no KSeF verification block while `ksef` was installed and on
+     * (`research.md` D16 §1 item 7). A contributor now registers the whole block —
+     * renderer, description and the per-render data it needs — from its own
+     * composition, and every render path reads it here.
+     */
+    blocks;
+    constructor(opts = {}) {
+        this.#loadAssetImage = opts.loadAssetImage;
+        this.blocks = opts.blocks ?? new InvoicePdfBlockRegistry();
+    }
+    async render(invoice, locale = 'pl', templateTree) {
+        if (!fontsRegistered) {
+            pdfMake.setFonts(buildFontDictionary());
+            // Images are inlined as data URIs by embedInvoiceLogoImages — deny network.
+            pdfMake.setUrlAccessPolicy(() => false);
+            fontsRegistered = true;
+        }
+        const content = await this.content(invoice, locale, templateTree);
+        return pdfMake.createPdf(this.buildDoc(content)).getBuffer();
+    }
+    /**
+     * The pdfmake content an invoice renders to — the template's blocks, or the
+     * built-in layout when the template places none this module or a present
+     * contributor renders (FR-016).
+     *
+     * Public because it is the one place every render path meets, which makes it
+     * the place a test asserts what a PDF carries without parsing one.
+     */
+    async content(invoice, locale = 'pl', templateTree) {
+        const tree = templateTree
+            ? await embedInvoiceLogoImages(templateTree, this.#loadAssetImage)
+            : undefined;
+        const present = this.blocks.present();
+        const placed = tree ? new Set(placedBlockNames(tree)) : null;
+        const resolved = await this.resolveContributed(invoice.id, present.filter((block) => placed === null || placed.has(block.name)));
+        const contributed = (name) => {
+            if (OWN_BLOCKS.has(name))
+                return undefined;
+            const block = this.blocks.find(name);
+            if (!block)
+                return undefined;
+            return (props) => block.render({ props, invoice, locale, resolved: resolved.get(name) ?? null });
+        };
+        // T137 (D22 §3(a)): the KSeF number is printed exactly once. The header
+        // stands down only while a block that prints it is present **and placed**
+        // in this tree; otherwise the header prints it, whatever any module's state.
+        const printsNumber = present.filter((block) => block.printsKsefReferenceNumber === true);
+        const suppressInTree = placed !== null && printsNumber.some((block) => placed.has(block.name));
+        const fromTemplate = tree
+            ? treeToContent(tree, invoice, locale, contributed, { suppressKsefNumber: suppressInTree })
+            : null;
+        if (fromTemplate)
+            return fromTemplate;
+        const fallbackResolved = placed === null ? resolved : await this.resolveContributed(invoice.id, present);
+        return builtinLayout(invoice, locale, present.map((block) => block.render({
+            props: {},
+            invoice,
+            locale,
+            resolved: fallbackResolved.get(block.name) ?? null,
+        })), 
+        // The built-in layout places every present contributor's block.
+        printsNumber.length > 0);
+    }
+    /**
+     * Each block's per-render data, read once. A rejection is the block's `null`:
+     * the data is an enrichment, and an invoice — a legal document — never fails
+     * to render on it. The `catch` is around a contributed callback, not a port.
+     */
+    async resolveContributed(invoiceId, blocks) {
+        const out = new Map();
+        for (const block of blocks) {
+            if (!block.resolve)
+                continue;
+            try {
+                out.set(block.name, (await block.resolve(invoiceId)) ?? null);
+            }
+            catch {
+                out.set(block.name, null);
+            }
+        }
+        return out;
+    }
+    buildDoc(content) {
+        return {
+            pageSize: 'A4',
+            pageMargins: [40, 40, 40, 48],
+            defaultStyle: { fontSize: 10, font: 'Roboto' },
+            styles: { docTitle: { fontSize: 14, bold: true } },
+            content,
+        };
+    }
+}
+//# sourceMappingURL=invoice-pdf-renderer.js.map

package/dist/backend/services/invoice-pdf-renderer.js.map

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

package/dist/backend/services/invoice-pdf.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Minimal PDF synthesis for invoice downloads (US2 T146).
+ *
+ * Not a production PDF generator — this produces a valid but trivial 1-page
+ * PDF with a plain-text block. Real typesetting waits for the pdfkit-based
+ * templating in a later polish sub-phase. The contract test only asserts the
+ * `%PDF-` magic header and the application/pdf Content-Type.
+ */
+export declare function buildMinimalInvoicePdf(params: {
+    invoiceNumber: string;
+    total: string;
+    currency: string;
+}): Buffer;
+/**
+ * Bulk invoice "printout" (feature 038 US2) — one summary line per invoice in a
+ * single PDF. Same stub-grade synthesis as the single-invoice download; real
+ * per-invoice typesetting waits for the pdfkit templating phase.
+ */
+export declare function buildBulkInvoicesPdf(invoices: Array<{
+    invoiceNumber: string;
+    total: string;
+    currency: string;
+}>): Buffer;
+//# sourceMappingURL=invoice-pdf.d.ts.map

package/dist/backend/services/invoice-pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-pdf.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-pdf.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAET;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,KAAK,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1E,MAAM,CAMR"}

package/dist/backend/services/invoice-pdf.js

@@ -0,0 +1,52 @@
+/**
+ * Minimal PDF synthesis for invoice downloads (US2 T146).
+ *
+ * Not a production PDF generator — this produces a valid but trivial 1-page
+ * PDF with a plain-text block. Real typesetting waits for the pdfkit-based
+ * templating in a later polish sub-phase. The contract test only asserts the
+ * `%PDF-` magic header and the application/pdf Content-Type.
+ */
+export function buildMinimalInvoicePdf(params) {
+    return buildTextPdf([`Invoice ${params.invoiceNumber}`, `Total: ${params.total} ${params.currency}`]);
+}
+/**
+ * Bulk invoice "printout" (feature 038 US2) — one summary line per invoice in a
+ * single PDF. Same stub-grade synthesis as the single-invoice download; real
+ * per-invoice typesetting waits for the pdfkit templating phase.
+ */
+export function buildBulkInvoicesPdf(invoices) {
+    const lines = invoices.length === 0
+        ? ['No invoices selected.']
+        : invoices.map((i) => `${i.invoiceNumber}  -  ${i.total} ${i.currency}`);
+    return buildTextPdf(['Invoices', ...lines]);
+}
+/** Render an array of plain-text lines as a trivial single-page PDF. */
+function buildTextPdf(lines) {
+    // One Tline per text line, stepping the text cursor down 16pt each time.
+    const escaped = lines.map((l) => l.replace(/([()\\])/g, '\\$1'));
+    const content = 'BT /F1 12 Tf 72 720 Td ' +
+        escaped.map((l, i) => (i === 0 ? `(${l}) Tj` : `0 -16 Td (${l}) Tj`)).join(' ') +
+        ' ET';
+    // Hand-authored objects are simpler than pulling in a PDF lib for a stub.
+    const objects = [
+        '1 0 obj\n<< /Type /Catalog /Pages 2 0 R >>\nendobj\n',
+        '2 0 obj\n<< /Type /Pages /Kids [3 0 R] /Count 1 >>\nendobj\n',
+        '3 0 obj\n<< /Type /Page /Parent 2 0 R /MediaBox [0 0 612 792] /Contents 4 0 R /Resources << /Font << /F1 5 0 R >> >> >>\nendobj\n',
+        `4 0 obj\n<< /Length ${content.length} >>\nstream\n${content}\nendstream\nendobj\n`,
+        '5 0 obj\n<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica >>\nendobj\n',
+    ];
+    let body = '%PDF-1.4\n';
+    const offsets = [];
+    for (const obj of objects) {
+        offsets.push(Buffer.byteLength(body, 'utf8'));
+        body += obj;
+    }
+    const xrefOffset = Buffer.byteLength(body, 'utf8');
+    body += `xref\n0 ${objects.length + 1}\n0000000000 65535 f \n`;
+    for (const off of offsets) {
+        body += `${off.toString().padStart(10, '0')} 00000 n \n`;
+    }
+    body += `trailer\n<< /Size ${objects.length + 1} /Root 1 0 R >>\nstartxref\n${xrefOffset}\n%%EOF\n`;
+    return Buffer.from(body, 'utf8');
+}
+//# sourceMappingURL=invoice-pdf.js.map