@formfeed/engine 0.3.20 → 0.3.22

package/index.cjs

@@ -47,10 +47,12 @@ __export(index_exports, {
   DefaultHelperRegistry: () => DefaultHelperRegistry,
   EINVOICE_FLAVOURS: () => EINVOICE_FLAVOURS,
   EINVOICE_FLAVOUR_NAMES: () => EINVOICE_FLAVOUR_NAMES,
+  EINVOICE_HEADER_LENGTH: () => EINVOICE_HEADER_LENGTH,
   EINVOICE_MAX_MESSAGES: () => EINVOICE_MAX_MESSAGES,
   EINVOICE_PROFILES: () => EINVOICE_PROFILES,
   EINVOICE_PROFILE_NAMES: () => EINVOICE_PROFILE_NAMES,
   EINVOICE_SPEC_VERSIONS: () => EINVOICE_SPEC_VERSIONS,
+  EINVOICE_TEST_NOTE: () => EINVOICE_TEST_NOTE,
   EINVOICE_XML_NAME: () => EINVOICE_XML_NAME,
   EN16931_TERMS: () => EN16931_TERMS,
   EPC_MAX_BYTES: () => EPC_MAX_BYTES,
@@ -58,6 +60,12 @@ __export(index_exports, {
   INVOICE_DATA_KEY: () => INVOICE_DATA_KEY,
   OFFICE_FILLED_MAX_BYTES: () => OFFICE_FILLED_MAX_BYTES,
   OfficeTemplateError: () => OfficeTemplateError,
+  PDFA_DEFAULT_LEVEL: () => PDFA_DEFAULT_LEVEL,
+  PDFA_HEADER_LENGTH: () => PDFA_HEADER_LENGTH,
+  PDFA_LEVELS: () => PDFA_LEVELS,
+  PDFA_MAX_MESSAGES: () => PDFA_MAX_MESSAGES,
+  PDFA_REFUSALS: () => PDFA_REFUSALS,
+  PDFA_STANDARDS: () => PDFA_STANDARDS,
   PDFUA_STANDARD: () => PDFUA_STANDARD,
   RenderError: () => RenderError,
   RenderLimitError: () => RenderLimitError,
@@ -106,6 +114,7 @@ __export(index_exports, {
   editAttribute: () => editAttribute,
   editableRegion: () => editableRegion,
   editableRegionAt: () => editableRegionAt,
+  einvoiceHeaderValue: () => einvoiceHeaderValue,
   einvoiceOptionsSchema: () => einvoiceOptionsSchema,
   einvoiceResult: () => einvoiceResult,
   einvoiceXml: () => einvoiceXml,
@@ -149,6 +158,8 @@ __export(index_exports, {
   isApitemplateRegion: () => isApitemplateRegion,
   isOfficeKind: () => isOfficeKind,
   isOutputFormat: () => isOutputFormat,
+  isPdfaResult: () => isPdfaResult,
+  isPdfaSetting: () => isPdfaSetting,
   isScss: () => isScss,
   isUaSetting: () => isUaSetting,
   jinja2Engine: () => jinja2Engine,
@@ -181,6 +192,10 @@ __export(index_exports, {
   parseDesign: () => parseDesign,
   parseSourceAttribute: () => parseSourceAttribute,
   partialInclude: () => partialInclude,
+  pdfaFromEinvoice: () => pdfaFromEinvoice,
+  pdfaHeaderValue: () => pdfaHeaderValue,
+  pdfaResult: () => pdfaResult,
+  pdfaStandard: () => pdfaStandard,
   printReset: () => printReset,
   qrSvg: () => qrSvg,
   readJsreportExport: () => readJsreportExport,
@@ -191,6 +206,7 @@ __export(index_exports, {
   renderVersion: () => renderVersion,
   resolveEinvoiceOptions: () => resolveEinvoiceOptions,
   resolvePath: () => resolvePath,
+  resolvePdfa: () => resolvePdfa,
   resolveTranslation: () => resolveTranslation,
   resolveUa: () => resolveUa,
   scanBlocks: () => scanBlocks,
@@ -321,7 +337,7 @@ function toNumber(value) {
 // packages/engine/src/lib/codes/epc.ts
 function epcPayload(input) {
   const amount2 = input.amount === void 0 || input.amount === "" ? "" : `EUR${toNumber(input.amount).toFixed(2)}`;
-  return [
+  const elements = [
     "BCD",
     "002",
     "1",
@@ -333,8 +349,12 @@ function epcPayload(input) {
     (input.purpose ?? "").slice(0, 4),
     (input.reference ?? "").slice(0, 35),
     input.reference ? "" : (input.text ?? "").slice(0, 140),
+    // the beneficiary to originator information, which a payment here has no field for
     ""
-  ].join("\n");
+  ];
+  while (elements.length > 0 && elements[elements.length - 1] === "")
+    elements.pop();
+  return elements.join("\n");
 }
 var IBAN_LENGTHS = {
   AD: 24,
@@ -391,34 +411,73 @@ function validateEpc(input) {
   const problems = [];
   const name = String(input.name ?? "").trim();
   if (!name) problems.push({ field: "name", code: "required" });
-  else if (name.length > 70) problems.push({ field: "name", code: "too_long", max: 70, actual: name.length });
+  else if (name.length > 70)
+    problems.push({
+      field: "name",
+      code: "too_long",
+      max: 70,
+      actual: name.length
+    });
   const iban2 = normaliseIban(String(input.iban ?? ""));
   if (!iban2) problems.push({ field: "iban", code: "required" });
-  else if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$/.test(iban2)) problems.push({ field: "iban", code: "iban_characters" });
+  else if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$/.test(iban2))
+    problems.push({ field: "iban", code: "iban_characters" });
   else {
     const expected = IBAN_LENGTHS[iban2.slice(0, 2)];
     if (expected !== void 0 && iban2.length !== expected)
-      problems.push({ field: "iban", code: "iban_country_length", max: expected, actual: iban2.length });
-    else if (!ibanChecksum(iban2)) problems.push({ field: "iban", code: "iban_checksum" });
+      problems.push({
+        field: "iban",
+        code: "iban_country_length",
+        max: expected,
+        actual: iban2.length
+      });
+    else if (!ibanChecksum(iban2))
+      problems.push({ field: "iban", code: "iban_checksum" });
   }
   const bic = String(input.bic ?? "").replace(/\s/g, "").toUpperCase();
-  if (bic && !/^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$/.test(bic)) problems.push({ field: "bic", code: "bic_format" });
+  if (bic && !/^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$/.test(bic))
+    problems.push({ field: "bic", code: "bic_format" });
   if (input.amount !== void 0 && input.amount !== "") {
     const amount2 = toNumber(input.amount);
-    if (Number.isNaN(amount2)) problems.push({ field: "amount", code: "not_a_number" });
-    else if (amount2 < 0.01 || amount2 > 99999999999e-2) problems.push({ field: "amount", code: "out_of_range" });
+    if (Number.isNaN(amount2))
+      problems.push({ field: "amount", code: "not_a_number" });
+    else if (amount2 < 0.01 || amount2 > 99999999999e-2)
+      problems.push({ field: "amount", code: "out_of_range" });
   }
   const purpose = String(input.purpose ?? "");
-  if (purpose.length > 4) problems.push({ field: "purpose", code: "too_long", max: 4, actual: purpose.length });
+  if (purpose.length > 4)
+    problems.push({
+      field: "purpose",
+      code: "too_long",
+      max: 4,
+      actual: purpose.length
+    });
   const reference = String(input.reference ?? "").trim();
   const text4 = String(input.text ?? "").trim();
-  if (reference && text4) problems.push({ field: "reference", code: "reference_or_text" });
+  if (reference && text4)
+    problems.push({ field: "reference", code: "reference_or_text" });
   if (reference.length > 35)
-    problems.push({ field: "reference", code: "too_long", max: 35, actual: reference.length });
-  if (text4.length > 140) problems.push({ field: "text", code: "too_long", max: 140, actual: text4.length });
+    problems.push({
+      field: "reference",
+      code: "too_long",
+      max: 35,
+      actual: reference.length
+    });
+  if (text4.length > 140)
+    problems.push({
+      field: "text",
+      code: "too_long",
+      max: 140,
+      actual: text4.length
+    });
   const bytes = byteLength(epcPayload(input));
   if (bytes > EPC_MAX_BYTES)
-    problems.push({ field: "payload", code: "too_long", max: EPC_MAX_BYTES, actual: bytes });
+    problems.push({
+      field: "payload",
+      code: "too_long",
+      max: EPC_MAX_BYTES,
+      actual: bytes
+    });
   return problems;
 }
 
@@ -9785,6 +9844,7 @@ var CII_GUIDELINES = {
   en16931: "urn:cen.eu:en16931:2017"
 };
 var EINVOICE_XML_NAME = "factur-x.xml";
+var EINVOICE_TEST_NOTE = "TEST \u2013 keine Rechnung / test render, not an invoice";
 function leaf(name, text4, attributes) {
   if (text4 === void 0 || text4 === "") return void 0;
   const kept = Object.entries(attributes ?? {}).filter(
@@ -10030,6 +10090,7 @@ function invoiceToCii(invoice, options) {
         leaf("ram:ID", invoice.number),
         leaf("ram:TypeCode", invoice.type_code),
         date("ram:IssueDateTime", invoice.issue_date),
+        options.test ? group2("ram:IncludedNote", [leaf("ram:Content", EINVOICE_TEST_NOTE)]) : void 0,
         ...invoice.notes.map(
           (note2) => group2("ram:IncludedNote", [
             leaf("ram:Content", note2.text),
@@ -10943,6 +11004,33 @@ function einvoiceResult(options, specVersion, validation, display) {
     display: display ? { checked: display.checked, missing: display.missing } : null
   };
 }
+var EINVOICE_HEADER_LENGTH = 8e3;
+function einvoiceHeaderValue(result, limit = EINVOICE_HEADER_LENGTH) {
+  const encode = (report) => encodeURIComponent(JSON.stringify(report));
+  const full = encode(result);
+  const validation = result.validation;
+  if (full.length <= limit || !validation) return full;
+  let messages = validation.messages.map((message) => ({
+    ...message,
+    location: null
+  }));
+  const cut = () => ({
+    ...result,
+    validation: { ...validation, messages, truncated: true }
+  });
+  let value = encode(cut());
+  while (value.length > limit && messages.length > 0) {
+    let last = messages.length - 1;
+    for (let i = messages.length - 1; i >= 0; i--)
+      if (messages[i].severity !== "error") {
+        last = i;
+        break;
+      }
+    messages = messages.filter((_, i) => i !== last);
+    value = encode(cut());
+  }
+  return value;
+}
 var EINVOICE_FLAVOUR_NAMES = {
   "factur-x": "Factur-X",
   zugferd: "ZUGFeRD"
@@ -11146,7 +11234,7 @@ function einvoiceXml(data, options) {
         }
       ]
     };
-  const check = checkInvoice(block, options);
+  const check = checkInvoice(block, { profile: options.profile });
   if (!check.ok) return { ok: false, problems: check.problems };
   return {
     ok: true,
@@ -11469,6 +11557,89 @@ function staticAudit(input) {
   return findings;
 }
 
+// packages/engine/src/lib/pdfa/index.ts
+var PDFA_LEVELS = ["2b", "3b"];
+var PDFA_DEFAULT_LEVEL = "3b";
+var PDFA_STANDARDS = {
+  "2b": "PDF/A-2b",
+  "3b": "PDF/A-3b"
+};
+function resolvePdfa(setting) {
+  if (setting === true) return PDFA_DEFAULT_LEVEL;
+  return typeof setting === "string" && PDFA_LEVELS.includes(setting) ? setting : null;
+}
+function isPdfaSetting(value) {
+  return value === null || typeof value === "boolean" || typeof value === "string" && PDFA_LEVELS.includes(value);
+}
+function pdfaStandard(level) {
+  return PDFA_STANDARDS[level];
+}
+var PDFA_REFUSALS = {
+  password: "pdf.pdfa cannot be combined with post.password: PDF/A does not allow encryption",
+  einvoice: 'pdf.pdfa "2b" cannot be combined with an e-invoice: the invoice XML is an attachment, which PDF/A-2 does not allow. An e-invoice is a PDF/A-3b already; ask for "3b" or leave pdf.pdfa out',
+  invalid: 'settings.pdf.pdfa is "2b", "3b", true, false or null'
+};
+var PDFA_MAX_MESSAGES = 50;
+var asMessage = (message) => ({
+  severity: message.severity === "warning" ? "warning" : "error",
+  rule: typeof message.rule === "string" ? message.rule : null,
+  message: typeof message.message === "string" ? message.message : "",
+  location: typeof message.location === "string" ? message.location : null
+});
+var capped = (messages, truncated) => {
+  const sorted = [
+    ...messages.filter((message) => message.severity === "error"),
+    ...messages.filter((message) => message.severity !== "error")
+  ];
+  return sorted.length > PDFA_MAX_MESSAGES || truncated ? { messages: sorted.slice(0, PDFA_MAX_MESSAGES), truncated: true } : { messages: sorted };
+};
+function pdfaResult(level, report, pdfSha256) {
+  return {
+    standard: PDFA_STANDARDS[level],
+    conformant: report.valid === true,
+    validator: report.validator,
+    id: report.id,
+    versions: { ...report.versions ?? {} },
+    pdf_sha256: pdfSha256,
+    ...capped(
+      (Array.isArray(report.messages) ? report.messages : []).map(asMessage),
+      report.truncated === true
+    )
+  };
+}
+function pdfaFromEinvoice(validation) {
+  if (!validation || validation.pdfa == null) return null;
+  const messages = validation.messages.filter((message) => message.part === "pdf").map((message) => ({
+    severity: message.severity,
+    rule: message.rule,
+    message: message.message,
+    location: message.location
+  }));
+  const versions = { ...validation.versions ?? {} };
+  return {
+    standard: PDFA_STANDARDS["3b"],
+    conformant: !messages.some((message) => message.severity === "error"),
+    validator: `veraPDF ${versions["verapdf"] ?? "unknown"}`,
+    id: validation.id ?? "",
+    versions,
+    pdf_sha256: validation.pdf_sha256 ?? null,
+    ...capped(messages, false)
+  };
+}
+function isPdfaResult(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const report = value;
+  return typeof report.standard === "string" && Object.values(PDFA_STANDARDS).includes(report.standard) && typeof report.conformant === "boolean";
+}
+var PDFA_HEADER_LENGTH = 2e3;
+function pdfaHeaderValue(result, limit = PDFA_HEADER_LENGTH) {
+  const value = encodeURIComponent(JSON.stringify(result));
+  if (value.length <= limit) return value;
+  return encodeURIComponent(
+    JSON.stringify({ ...result, messages: [], truncated: true })
+  );
+}
+
 // packages/engine/src/lib/office/errors.ts
 var OfficeError = class extends Error {
   constructor(code, message, details = {}) {

package/index.js

@@ -101,7 +101,7 @@ function toNumber(value) {
 // packages/engine/src/lib/codes/epc.ts
 function epcPayload(input) {
   const amount2 = input.amount === void 0 || input.amount === "" ? "" : `EUR${toNumber(input.amount).toFixed(2)}`;
-  return [
+  const elements = [
     "BCD",
     "002",
     "1",
@@ -113,8 +113,12 @@ function epcPayload(input) {
     (input.purpose ?? "").slice(0, 4),
     (input.reference ?? "").slice(0, 35),
     input.reference ? "" : (input.text ?? "").slice(0, 140),
+    // the beneficiary to originator information, which a payment here has no field for
     ""
-  ].join("\n");
+  ];
+  while (elements.length > 0 && elements[elements.length - 1] === "")
+    elements.pop();
+  return elements.join("\n");
 }
 var IBAN_LENGTHS = {
   AD: 24,
@@ -171,34 +175,73 @@ function validateEpc(input) {
   const problems = [];
   const name = String(input.name ?? "").trim();
   if (!name) problems.push({ field: "name", code: "required" });
-  else if (name.length > 70) problems.push({ field: "name", code: "too_long", max: 70, actual: name.length });
+  else if (name.length > 70)
+    problems.push({
+      field: "name",
+      code: "too_long",
+      max: 70,
+      actual: name.length
+    });
   const iban2 = normaliseIban(String(input.iban ?? ""));
   if (!iban2) problems.push({ field: "iban", code: "required" });
-  else if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$/.test(iban2)) problems.push({ field: "iban", code: "iban_characters" });
+  else if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$/.test(iban2))
+    problems.push({ field: "iban", code: "iban_characters" });
   else {
     const expected = IBAN_LENGTHS[iban2.slice(0, 2)];
     if (expected !== void 0 && iban2.length !== expected)
-      problems.push({ field: "iban", code: "iban_country_length", max: expected, actual: iban2.length });
-    else if (!ibanChecksum(iban2)) problems.push({ field: "iban", code: "iban_checksum" });
+      problems.push({
+        field: "iban",
+        code: "iban_country_length",
+        max: expected,
+        actual: iban2.length
+      });
+    else if (!ibanChecksum(iban2))
+      problems.push({ field: "iban", code: "iban_checksum" });
   }
   const bic = String(input.bic ?? "").replace(/\s/g, "").toUpperCase();
-  if (bic && !/^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$/.test(bic)) problems.push({ field: "bic", code: "bic_format" });
+  if (bic && !/^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$/.test(bic))
+    problems.push({ field: "bic", code: "bic_format" });
   if (input.amount !== void 0 && input.amount !== "") {
     const amount2 = toNumber(input.amount);
-    if (Number.isNaN(amount2)) problems.push({ field: "amount", code: "not_a_number" });
-    else if (amount2 < 0.01 || amount2 > 99999999999e-2) problems.push({ field: "amount", code: "out_of_range" });
+    if (Number.isNaN(amount2))
+      problems.push({ field: "amount", code: "not_a_number" });
+    else if (amount2 < 0.01 || amount2 > 99999999999e-2)
+      problems.push({ field: "amount", code: "out_of_range" });
   }
   const purpose = String(input.purpose ?? "");
-  if (purpose.length > 4) problems.push({ field: "purpose", code: "too_long", max: 4, actual: purpose.length });
+  if (purpose.length > 4)
+    problems.push({
+      field: "purpose",
+      code: "too_long",
+      max: 4,
+      actual: purpose.length
+    });
   const reference = String(input.reference ?? "").trim();
   const text4 = String(input.text ?? "").trim();
-  if (reference && text4) problems.push({ field: "reference", code: "reference_or_text" });
+  if (reference && text4)
+    problems.push({ field: "reference", code: "reference_or_text" });
   if (reference.length > 35)
-    problems.push({ field: "reference", code: "too_long", max: 35, actual: reference.length });
-  if (text4.length > 140) problems.push({ field: "text", code: "too_long", max: 140, actual: text4.length });
+    problems.push({
+      field: "reference",
+      code: "too_long",
+      max: 35,
+      actual: reference.length
+    });
+  if (text4.length > 140)
+    problems.push({
+      field: "text",
+      code: "too_long",
+      max: 140,
+      actual: text4.length
+    });
   const bytes = byteLength(epcPayload(input));
   if (bytes > EPC_MAX_BYTES)
-    problems.push({ field: "payload", code: "too_long", max: EPC_MAX_BYTES, actual: bytes });
+    problems.push({
+      field: "payload",
+      code: "too_long",
+      max: EPC_MAX_BYTES,
+      actual: bytes
+    });
   return problems;
 }
 
@@ -9565,6 +9608,7 @@ var CII_GUIDELINES = {
   en16931: "urn:cen.eu:en16931:2017"
 };
 var EINVOICE_XML_NAME = "factur-x.xml";
+var EINVOICE_TEST_NOTE = "TEST \u2013 keine Rechnung / test render, not an invoice";
 function leaf(name, text4, attributes) {
   if (text4 === void 0 || text4 === "") return void 0;
   const kept = Object.entries(attributes ?? {}).filter(
@@ -9810,6 +9854,7 @@ function invoiceToCii(invoice, options) {
         leaf("ram:ID", invoice.number),
         leaf("ram:TypeCode", invoice.type_code),
         date("ram:IssueDateTime", invoice.issue_date),
+        options.test ? group2("ram:IncludedNote", [leaf("ram:Content", EINVOICE_TEST_NOTE)]) : void 0,
         ...invoice.notes.map(
           (note2) => group2("ram:IncludedNote", [
             leaf("ram:Content", note2.text),
@@ -10723,6 +10768,33 @@ function einvoiceResult(options, specVersion, validation, display) {
     display: display ? { checked: display.checked, missing: display.missing } : null
   };
 }
+var EINVOICE_HEADER_LENGTH = 8e3;
+function einvoiceHeaderValue(result, limit = EINVOICE_HEADER_LENGTH) {
+  const encode = (report) => encodeURIComponent(JSON.stringify(report));
+  const full = encode(result);
+  const validation = result.validation;
+  if (full.length <= limit || !validation) return full;
+  let messages = validation.messages.map((message) => ({
+    ...message,
+    location: null
+  }));
+  const cut = () => ({
+    ...result,
+    validation: { ...validation, messages, truncated: true }
+  });
+  let value = encode(cut());
+  while (value.length > limit && messages.length > 0) {
+    let last = messages.length - 1;
+    for (let i = messages.length - 1; i >= 0; i--)
+      if (messages[i].severity !== "error") {
+        last = i;
+        break;
+      }
+    messages = messages.filter((_, i) => i !== last);
+    value = encode(cut());
+  }
+  return value;
+}
 var EINVOICE_FLAVOUR_NAMES = {
   "factur-x": "Factur-X",
   zugferd: "ZUGFeRD"
@@ -10926,7 +10998,7 @@ function einvoiceXml(data, options) {
         }
       ]
     };
-  const check = checkInvoice(block, options);
+  const check = checkInvoice(block, { profile: options.profile });
   if (!check.ok) return { ok: false, problems: check.problems };
   return {
     ok: true,
@@ -11249,6 +11321,89 @@ function staticAudit(input) {
   return findings;
 }
 
+// packages/engine/src/lib/pdfa/index.ts
+var PDFA_LEVELS = ["2b", "3b"];
+var PDFA_DEFAULT_LEVEL = "3b";
+var PDFA_STANDARDS = {
+  "2b": "PDF/A-2b",
+  "3b": "PDF/A-3b"
+};
+function resolvePdfa(setting) {
+  if (setting === true) return PDFA_DEFAULT_LEVEL;
+  return typeof setting === "string" && PDFA_LEVELS.includes(setting) ? setting : null;
+}
+function isPdfaSetting(value) {
+  return value === null || typeof value === "boolean" || typeof value === "string" && PDFA_LEVELS.includes(value);
+}
+function pdfaStandard(level) {
+  return PDFA_STANDARDS[level];
+}
+var PDFA_REFUSALS = {
+  password: "pdf.pdfa cannot be combined with post.password: PDF/A does not allow encryption",
+  einvoice: 'pdf.pdfa "2b" cannot be combined with an e-invoice: the invoice XML is an attachment, which PDF/A-2 does not allow. An e-invoice is a PDF/A-3b already; ask for "3b" or leave pdf.pdfa out',
+  invalid: 'settings.pdf.pdfa is "2b", "3b", true, false or null'
+};
+var PDFA_MAX_MESSAGES = 50;
+var asMessage = (message) => ({
+  severity: message.severity === "warning" ? "warning" : "error",
+  rule: typeof message.rule === "string" ? message.rule : null,
+  message: typeof message.message === "string" ? message.message : "",
+  location: typeof message.location === "string" ? message.location : null
+});
+var capped = (messages, truncated) => {
+  const sorted = [
+    ...messages.filter((message) => message.severity === "error"),
+    ...messages.filter((message) => message.severity !== "error")
+  ];
+  return sorted.length > PDFA_MAX_MESSAGES || truncated ? { messages: sorted.slice(0, PDFA_MAX_MESSAGES), truncated: true } : { messages: sorted };
+};
+function pdfaResult(level, report, pdfSha256) {
+  return {
+    standard: PDFA_STANDARDS[level],
+    conformant: report.valid === true,
+    validator: report.validator,
+    id: report.id,
+    versions: { ...report.versions ?? {} },
+    pdf_sha256: pdfSha256,
+    ...capped(
+      (Array.isArray(report.messages) ? report.messages : []).map(asMessage),
+      report.truncated === true
+    )
+  };
+}
+function pdfaFromEinvoice(validation) {
+  if (!validation || validation.pdfa == null) return null;
+  const messages = validation.messages.filter((message) => message.part === "pdf").map((message) => ({
+    severity: message.severity,
+    rule: message.rule,
+    message: message.message,
+    location: message.location
+  }));
+  const versions = { ...validation.versions ?? {} };
+  return {
+    standard: PDFA_STANDARDS["3b"],
+    conformant: !messages.some((message) => message.severity === "error"),
+    validator: `veraPDF ${versions["verapdf"] ?? "unknown"}`,
+    id: validation.id ?? "",
+    versions,
+    pdf_sha256: validation.pdf_sha256 ?? null,
+    ...capped(messages, false)
+  };
+}
+function isPdfaResult(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const report = value;
+  return typeof report.standard === "string" && Object.values(PDFA_STANDARDS).includes(report.standard) && typeof report.conformant === "boolean";
+}
+var PDFA_HEADER_LENGTH = 2e3;
+function pdfaHeaderValue(result, limit = PDFA_HEADER_LENGTH) {
+  const value = encodeURIComponent(JSON.stringify(result));
+  if (value.length <= limit) return value;
+  return encodeURIComponent(
+    JSON.stringify({ ...result, messages: [], truncated: true })
+  );
+}
+
 // packages/engine/src/lib/office/errors.ts
 var OfficeError = class extends Error {
   constructor(code, message, details = {}) {
@@ -14159,10 +14314,12 @@ export {
   DefaultHelperRegistry,
   EINVOICE_FLAVOURS,
   EINVOICE_FLAVOUR_NAMES,
+  EINVOICE_HEADER_LENGTH,
   EINVOICE_MAX_MESSAGES,
   EINVOICE_PROFILES,
   EINVOICE_PROFILE_NAMES,
   EINVOICE_SPEC_VERSIONS,
+  EINVOICE_TEST_NOTE,
   EINVOICE_XML_NAME,
   EN16931_TERMS,
   EPC_MAX_BYTES,
@@ -14170,6 +14327,12 @@ export {
   INVOICE_DATA_KEY,
   OFFICE_FILLED_MAX_BYTES,
   OfficeTemplateError,
+  PDFA_DEFAULT_LEVEL,
+  PDFA_HEADER_LENGTH,
+  PDFA_LEVELS,
+  PDFA_MAX_MESSAGES,
+  PDFA_REFUSALS,
+  PDFA_STANDARDS,
   PDFUA_STANDARD,
   RenderError,
   RenderLimitError,
@@ -14218,6 +14381,7 @@ export {
   editAttribute,
   editableRegion,
   editableRegionAt,
+  einvoiceHeaderValue,
   einvoiceOptionsSchema,
   einvoiceResult,
   einvoiceXml,
@@ -14261,6 +14425,8 @@ export {
   isApitemplateRegion,
   isOfficeKind,
   isOutputFormat,
+  isPdfaResult,
+  isPdfaSetting,
   isScss,
   isUaSetting,
   jinja2Engine,
@@ -14293,6 +14459,10 @@ export {
   parseDesign,
   parseSourceAttribute,
   partialInclude,
+  pdfaFromEinvoice,
+  pdfaHeaderValue,
+  pdfaResult,
+  pdfaStandard,
   printReset,
   qrSvg,
   readJsreportExport,
@@ -14303,6 +14473,7 @@ export {
   renderVersion,
   resolveEinvoiceOptions,
   resolvePath,
+  resolvePdfa,
   resolveTranslation,
   resolveUa,
   scanBlocks,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formfeed/engine",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "description": "The Formfeed template engine (Jinja2, Liquid, Handlebars) for the browser and Node.",
   "license": "MIT",
   "type": "module",

package/types/index.d.cts

@@ -30,11 +30,13 @@ export type { ApplyResult, ChipKind, EditableRegion, EditItem, RegionChip, Regio
 export { resolveTranslation, translationTarget } from './lib/translation.cjs';
 export { DESIGN_LIMITS, DESIGN_VERSION, dataPathPattern, defaultLayer, designBytes, designOutputHash, designStarters, emitDesign, emptyDesign, genericFamily, googleFont, googleFonts, googleFontsUrl, imageIsEmpty, layerIdPattern, nearestWeight, nextLayerId, parseDesign, } from './lib/design/index.cjs';
 export type { BarcodeLayer, BarcodeSymbology, Binding, CanvasSize, DesignDocument, DesignLayer, DesignStarter, EmittedDesign, FontChoice, GoogleFont, ImageLayer, ImageSource, LayerBase, LayerType, Paint, ParsedDesign, QrLayer, Shadow, ShapeLayer, Stroke, TextFormat, TextItem, TextLayer, TextStyle, } from './lib/design/index.cjs';
-export { CII_GUIDELINES, CODE_LIST_RELEASE, DISPLAY_TERMS, EINVOICE_FLAVOURS, EINVOICE_FLAVOUR_NAMES, EINVOICE_MAX_MESSAGES, EINVOICE_PROFILES, EINVOICE_PROFILE_NAMES, EINVOICE_SPEC_VERSIONS, EINVOICE_XML_NAME, EN16931_TERMS, INVOICE_DATA_KEY, VAT_CATEGORIES, capMessages, carriesTerm, checkInvoice, defaultEinvoiceOptions, displayCheck, displayMissingText, einvoiceOptionsSchema, einvoiceResult, einvoiceXml, htmlText, invoiceAmountText, invoiceLineOf, invoicePathSegments, invoiceSchema, invoiceSkeleton, invoiceToCii, locateJsonPath, resolveEinvoiceOptions, shownAmounts, } from './lib/einvoice/index.cjs';
+export { CII_GUIDELINES, CODE_LIST_RELEASE, DISPLAY_TERMS, EINVOICE_FLAVOURS, EINVOICE_FLAVOUR_NAMES, EINVOICE_HEADER_LENGTH, EINVOICE_MAX_MESSAGES, EINVOICE_PROFILES, EINVOICE_PROFILE_NAMES, EINVOICE_SPEC_VERSIONS, EINVOICE_TEST_NOTE, EINVOICE_XML_NAME, EN16931_TERMS, INVOICE_DATA_KEY, VAT_CATEGORIES, capMessages, carriesTerm, checkInvoice, defaultEinvoiceOptions, displayCheck, displayMissingText, einvoiceHeaderValue, einvoiceOptionsSchema, einvoiceResult, einvoiceXml, htmlText, invoiceAmountText, invoiceLineOf, invoicePathSegments, invoiceSchema, invoiceSkeleton, invoiceToCii, locateJsonPath, resolveEinvoiceOptions, shownAmounts, } from './lib/einvoice/index.cjs';
 export type { CheckOptions, DisplayCheck, DisplayValue, EinvoiceDisplay, EinvoiceFlavour, EinvoiceMessage, EinvoiceOptions, EinvoiceOptionsInput, EinvoiceProfile, EinvoiceResult, EinvoiceTerm, EinvoiceValidation, EinvoiceXml, Identifier, Invoice, InvoiceAddress, InvoiceAllowance, InvoiceBreakdown, InvoiceCheck, InvoiceInput, InvoiceLine, InvoiceParty, InvoiceProblem, InvoiceProblemCode, InvoiceTax, JsonLocation, ResolvedEinvoice, VatCategory, } from './lib/einvoice/index.cjs';
 export { ACCESSIBILITY_HEADER_LENGTH, ACCESSIBILITY_MAX_ELEMENTS, ACCESSIBILITY_MAX_FAILURES, AUDIT_CODES, AUDIT_RULES, AUDIT_SEVERITY, AUDIT_SNIPPET_LENGTH, AUDIT_TITLES, PDFUA_STANDARD, UA_CHECKS, UA_REFUSALS, accessibilityHeader, accessibilityHeaderValue, accessibilityResult, auditMessage, isUaSetting, resolveUa, } from './lib/accessibility/index.cjs';
 export type { AccessibilityFailure, AccessibilityResult, AccessibilityWarning, AuditArgs, AuditCode, AuditFinding, AuditLink, AuditOptions, AuditReport, AuditSeverity, UaCheck, UaOptions, UaSetting, ValidatorFailure, ValidatorVerdict, } from './lib/accessibility/index.cjs';
 export { staticAudit, staticAuditDiagnostics, } from './lib/accessibility/static.cjs';
+export { PDFA_DEFAULT_LEVEL, PDFA_HEADER_LENGTH, PDFA_LEVELS, PDFA_MAX_MESSAGES, PDFA_REFUSALS, PDFA_STANDARDS, isPdfaResult, isPdfaSetting, pdfaFromEinvoice, pdfaHeaderValue, pdfaResult, pdfaStandard, resolvePdfa, } from './lib/pdfa/index.cjs';
+export type { PdfaLevel, PdfaMessage, PdfaResult, PdfaSetting, PdfaStandard, PdfaValidatorReport, } from './lib/pdfa/index.cjs';
 export type { StaticAuditDiagnostic, StaticAuditInput, } from './lib/accessibility/static.cjs';
 export { auditRuntime } from './lib/generated/frames.cjs';
 export { encodeTemplateText } from './lib/source-edit.cjs';

package/types/index.d.ts

@@ -30,11 +30,13 @@ export type { ApplyResult, ChipKind, EditableRegion, EditItem, RegionChip, Regio
 export { resolveTranslation, translationTarget } from './lib/translation.js';
 export { DESIGN_LIMITS, DESIGN_VERSION, dataPathPattern, defaultLayer, designBytes, designOutputHash, designStarters, emitDesign, emptyDesign, genericFamily, googleFont, googleFonts, googleFontsUrl, imageIsEmpty, layerIdPattern, nearestWeight, nextLayerId, parseDesign, } from './lib/design/index.js';
 export type { BarcodeLayer, BarcodeSymbology, Binding, CanvasSize, DesignDocument, DesignLayer, DesignStarter, EmittedDesign, FontChoice, GoogleFont, ImageLayer, ImageSource, LayerBase, LayerType, Paint, ParsedDesign, QrLayer, Shadow, ShapeLayer, Stroke, TextFormat, TextItem, TextLayer, TextStyle, } from './lib/design/index.js';
-export { CII_GUIDELINES, CODE_LIST_RELEASE, DISPLAY_TERMS, EINVOICE_FLAVOURS, EINVOICE_FLAVOUR_NAMES, EINVOICE_MAX_MESSAGES, EINVOICE_PROFILES, EINVOICE_PROFILE_NAMES, EINVOICE_SPEC_VERSIONS, EINVOICE_XML_NAME, EN16931_TERMS, INVOICE_DATA_KEY, VAT_CATEGORIES, capMessages, carriesTerm, checkInvoice, defaultEinvoiceOptions, displayCheck, displayMissingText, einvoiceOptionsSchema, einvoiceResult, einvoiceXml, htmlText, invoiceAmountText, invoiceLineOf, invoicePathSegments, invoiceSchema, invoiceSkeleton, invoiceToCii, locateJsonPath, resolveEinvoiceOptions, shownAmounts, } from './lib/einvoice/index.js';
+export { CII_GUIDELINES, CODE_LIST_RELEASE, DISPLAY_TERMS, EINVOICE_FLAVOURS, EINVOICE_FLAVOUR_NAMES, EINVOICE_HEADER_LENGTH, EINVOICE_MAX_MESSAGES, EINVOICE_PROFILES, EINVOICE_PROFILE_NAMES, EINVOICE_SPEC_VERSIONS, EINVOICE_TEST_NOTE, EINVOICE_XML_NAME, EN16931_TERMS, INVOICE_DATA_KEY, VAT_CATEGORIES, capMessages, carriesTerm, checkInvoice, defaultEinvoiceOptions, displayCheck, displayMissingText, einvoiceHeaderValue, einvoiceOptionsSchema, einvoiceResult, einvoiceXml, htmlText, invoiceAmountText, invoiceLineOf, invoicePathSegments, invoiceSchema, invoiceSkeleton, invoiceToCii, locateJsonPath, resolveEinvoiceOptions, shownAmounts, } from './lib/einvoice/index.js';
 export type { CheckOptions, DisplayCheck, DisplayValue, EinvoiceDisplay, EinvoiceFlavour, EinvoiceMessage, EinvoiceOptions, EinvoiceOptionsInput, EinvoiceProfile, EinvoiceResult, EinvoiceTerm, EinvoiceValidation, EinvoiceXml, Identifier, Invoice, InvoiceAddress, InvoiceAllowance, InvoiceBreakdown, InvoiceCheck, InvoiceInput, InvoiceLine, InvoiceParty, InvoiceProblem, InvoiceProblemCode, InvoiceTax, JsonLocation, ResolvedEinvoice, VatCategory, } from './lib/einvoice/index.js';
 export { ACCESSIBILITY_HEADER_LENGTH, ACCESSIBILITY_MAX_ELEMENTS, ACCESSIBILITY_MAX_FAILURES, AUDIT_CODES, AUDIT_RULES, AUDIT_SEVERITY, AUDIT_SNIPPET_LENGTH, AUDIT_TITLES, PDFUA_STANDARD, UA_CHECKS, UA_REFUSALS, accessibilityHeader, accessibilityHeaderValue, accessibilityResult, auditMessage, isUaSetting, resolveUa, } from './lib/accessibility/index.js';
 export type { AccessibilityFailure, AccessibilityResult, AccessibilityWarning, AuditArgs, AuditCode, AuditFinding, AuditLink, AuditOptions, AuditReport, AuditSeverity, UaCheck, UaOptions, UaSetting, ValidatorFailure, ValidatorVerdict, } from './lib/accessibility/index.js';
 export { staticAudit, staticAuditDiagnostics, } from './lib/accessibility/static.js';
+export { PDFA_DEFAULT_LEVEL, PDFA_HEADER_LENGTH, PDFA_LEVELS, PDFA_MAX_MESSAGES, PDFA_REFUSALS, PDFA_STANDARDS, isPdfaResult, isPdfaSetting, pdfaFromEinvoice, pdfaHeaderValue, pdfaResult, pdfaStandard, resolvePdfa, } from './lib/pdfa/index.js';
+export type { PdfaLevel, PdfaMessage, PdfaResult, PdfaSetting, PdfaStandard, PdfaValidatorReport, } from './lib/pdfa/index.js';
 export type { StaticAuditDiagnostic, StaticAuditInput, } from './lib/accessibility/static.js';
 export { auditRuntime } from './lib/generated/frames.js';
 export { encodeTemplateText } from './lib/source-edit.js';

package/types/lib/assemble.d.cts

@@ -1,4 +1,5 @@
 import type { UaSetting } from './accessibility/index.cjs';
+import type { PdfaSetting } from './pdfa/index.cjs';
 import type { BrandContext } from './brand.cjs';
 import type { EinvoiceOptionsInput } from './einvoice/schema.cjs';
 import type { EngineId, RenderContext } from './types.cjs';
@@ -56,6 +57,13 @@ export interface TemplateSettings {
          * implies `tagged`. Read it through `resolveUa`.
          */
         ua?: UaSetting;
+        /**
+         * PDF/A (plan 26): the finished PDF is converted to PDF/A-2b or PDF/A-3b and held to it by the
+         * validator; a file that fails fails the render, there is no mode that delivers it. `true` is
+         * `'3b'`. An e-invoice is a PDF/A-3b already, so `'2b'` beside one is refused. Read it through
+         * `resolvePdfa`.
+         */
+        pdfa?: PdfaSetting;
         metadata?: {
             title?: string;
             author?: string;

package/types/lib/assemble.d.ts

@@ -1,4 +1,5 @@
 import type { UaSetting } from './accessibility/index.js';
+import type { PdfaSetting } from './pdfa/index.js';
 import type { BrandContext } from './brand.js';
 import type { EinvoiceOptionsInput } from './einvoice/schema.js';
 import type { EngineId, RenderContext } from './types.js';
@@ -56,6 +57,13 @@ export interface TemplateSettings {
          * implies `tagged`. Read it through `resolveUa`.
          */
         ua?: UaSetting;
+        /**
+         * PDF/A (plan 26): the finished PDF is converted to PDF/A-2b or PDF/A-3b and held to it by the
+         * validator; a file that fails fails the render, there is no mode that delivers it. `true` is
+         * `'3b'`. An e-invoice is a PDF/A-3b already, so `'2b'` beside one is refused. Read it through
+         * `resolvePdfa`.
+         */
+        pdfa?: PdfaSetting;
         metadata?: {
             title?: string;
             author?: string;

package/types/lib/codes/epc.d.cts

@@ -29,7 +29,11 @@ export interface EpcPayment {
 }
 /** What a caller actually hands over: the same fields, none of them guaranteed to be there. */
 export type EpcInput = Partial<EpcPayment>;
-/** EPC QR (GiroCode) payload, version 002, UTF-8, SCT. */
+/**
+ * EPC QR (GiroCode) payload, version 002, UTF-8, SCT. It ends with the last populated element:
+ * "The last populated element is not followed by any character or element separator" (EPC069-12
+ * v3.1 §2.2), so the empty elements after it are left out, line breaks and all.
+ */
 export declare function epcPayload(input: EpcInput): string;
 /**
  * What is wrong with a payment, as a code rather than a sentence: the engine has no locale, and the

package/types/lib/codes/epc.d.ts

@@ -29,7 +29,11 @@ export interface EpcPayment {
 }
 /** What a caller actually hands over: the same fields, none of them guaranteed to be there. */
 export type EpcInput = Partial<EpcPayment>;
-/** EPC QR (GiroCode) payload, version 002, UTF-8, SCT. */
+/**
+ * EPC QR (GiroCode) payload, version 002, UTF-8, SCT. It ends with the last populated element:
+ * "The last populated element is not followed by any character or element separator" (EPC069-12
+ * v3.1 §2.2), so the empty elements after it are left out, line breaks and all.
+ */
 export declare function epcPayload(input: EpcInput): string;
 /**
  * What is wrong with a payment, as a code rather than a sentence: the engine has no locale, and the

package/types/lib/einvoice/cii.d.cts

@@ -13,6 +13,15 @@ import type { EinvoiceProfile } from './schema.cjs';
 export declare const CII_GUIDELINES: Record<EinvoiceProfile, string>;
 /** The name the XML has inside the PDF, under either of the specification's two names. */
 export declare const EINVOICE_XML_NAME = "factur-x.xml";
+/**
+ * The first note (BT-22) of a test render's invoice, on every plan (plan 25 §5.2): an XML carries
+ * no page mark, so the invoice says it of itself. No subject code: France's rules, which hold the
+ * subject codes of an invoice between French businesses, accept the note without one (measured
+ * with the sidecar on 2026-10-27). The wording waits for the Steuerberater (plan 25 §5.5).
+ */
+export declare const EINVOICE_TEST_NOTE = "TEST \u2013 keine Rechnung / test render, not an invoice";
 export declare function invoiceToCii(invoice: Invoice, options: {
     profile: EinvoiceProfile;
+    /** A test render's invoice: its first note says it is none (`EINVOICE_TEST_NOTE`). */
+    test?: boolean;
 }): string;

package/types/lib/einvoice/cii.d.ts

@@ -13,6 +13,15 @@ import type { EinvoiceProfile } from './schema.js';
 export declare const CII_GUIDELINES: Record<EinvoiceProfile, string>;
 /** The name the XML has inside the PDF, under either of the specification's two names. */
 export declare const EINVOICE_XML_NAME = "factur-x.xml";
+/**
+ * The first note (BT-22) of a test render's invoice, on every plan (plan 25 §5.2): an XML carries
+ * no page mark, so the invoice says it of itself. No subject code: France's rules, which hold the
+ * subject codes of an invoice between French businesses, accept the note without one (measured
+ * with the sidecar on 2026-10-27). The wording waits for the Steuerberater (plan 25 §5.5).
+ */
+export declare const EINVOICE_TEST_NOTE = "TEST \u2013 keine Rechnung / test render, not an invoice";
 export declare function invoiceToCii(invoice: Invoice, options: {
     profile: EinvoiceProfile;
+    /** A test render's invoice: its first note says it is none (`EINVOICE_TEST_NOTE`). */
+    test?: boolean;
 }): string;

package/types/lib/einvoice/index.d.cts

@@ -7,13 +7,13 @@
 import { type Invoice, type InvoiceProblem } from './check.cjs';
 import type { EinvoiceFlavour, EinvoiceProfile } from './schema.cjs';
 export { checkInvoice, type CheckOptions, type Identifier, type Invoice, type InvoiceAddress, type InvoiceAllowance, type InvoiceBreakdown, type InvoiceCheck, type InvoiceLine, type InvoiceParty, type InvoiceProblem, type InvoiceProblemCode, type InvoiceTax, } from './check.cjs';
-export { CII_GUIDELINES, EINVOICE_XML_NAME, invoiceToCii } from './cii.cjs';
+export { CII_GUIDELINES, EINVOICE_TEST_NOTE, EINVOICE_XML_NAME, invoiceToCii, } from './cii.cjs';
 export { EN16931_TERMS, carriesTerm, type EinvoiceTerm } from './coverage.cjs';
 export { CODE_LIST_RELEASE } from './codes.generated.cjs';
 export { DISPLAY_TERMS, displayCheck, displayMissingText, shownAmounts, type DisplayCheck, type DisplayValue, } from './display.cjs';
 export { EINVOICE_FLAVOURS, EINVOICE_PROFILES, VAT_CATEGORIES, defaultEinvoiceOptions, einvoiceOptionsSchema, invoiceSchema, resolveEinvoiceOptions, type EinvoiceFlavour, type EinvoiceOptions, type EinvoiceOptionsInput, type EinvoiceProfile, type InvoiceInput, type ResolvedEinvoice, type VatCategory, } from './schema.cjs';
 export { invoicePathSegments, locateJsonPath, type JsonLocation, } from './locate.cjs';
-export { EINVOICE_FLAVOUR_NAMES, EINVOICE_MAX_MESSAGES, EINVOICE_PROFILE_NAMES, capMessages, einvoiceResult, invoiceLineOf, type EinvoiceDisplay, type EinvoiceMessage, type EinvoiceResult, type EinvoiceValidation, } from './report.cjs';
+export { EINVOICE_FLAVOUR_NAMES, EINVOICE_HEADER_LENGTH, EINVOICE_MAX_MESSAGES, EINVOICE_PROFILE_NAMES, capMessages, einvoiceHeaderValue, einvoiceResult, invoiceLineOf, type EinvoiceDisplay, type EinvoiceMessage, type EinvoiceResult, type EinvoiceValidation, } from './report.cjs';
 export { htmlText } from './html-text.cjs';
 export { invoiceSkeleton } from './skeleton.cjs';
 /** Where the invoice sits in the render data. */
@@ -43,4 +43,6 @@ export type EinvoiceXml = {
  */
 export declare function einvoiceXml(data: unknown, options: {
     profile: EinvoiceProfile;
+    /** A test render's invoice, whose first note says it is none (`EINVOICE_TEST_NOTE`). */
+    test?: boolean;
 }): EinvoiceXml;

package/types/lib/einvoice/index.d.ts

@@ -7,13 +7,13 @@
 import { type Invoice, type InvoiceProblem } from './check.js';
 import type { EinvoiceFlavour, EinvoiceProfile } from './schema.js';
 export { checkInvoice, type CheckOptions, type Identifier, type Invoice, type InvoiceAddress, type InvoiceAllowance, type InvoiceBreakdown, type InvoiceCheck, type InvoiceLine, type InvoiceParty, type InvoiceProblem, type InvoiceProblemCode, type InvoiceTax, } from './check.js';
-export { CII_GUIDELINES, EINVOICE_XML_NAME, invoiceToCii } from './cii.js';
+export { CII_GUIDELINES, EINVOICE_TEST_NOTE, EINVOICE_XML_NAME, invoiceToCii, } from './cii.js';
 export { EN16931_TERMS, carriesTerm, type EinvoiceTerm } from './coverage.js';
 export { CODE_LIST_RELEASE } from './codes.generated.js';
 export { DISPLAY_TERMS, displayCheck, displayMissingText, shownAmounts, type DisplayCheck, type DisplayValue, } from './display.js';
 export { EINVOICE_FLAVOURS, EINVOICE_PROFILES, VAT_CATEGORIES, defaultEinvoiceOptions, einvoiceOptionsSchema, invoiceSchema, resolveEinvoiceOptions, type EinvoiceFlavour, type EinvoiceOptions, type EinvoiceOptionsInput, type EinvoiceProfile, type InvoiceInput, type ResolvedEinvoice, type VatCategory, } from './schema.js';
 export { invoicePathSegments, locateJsonPath, type JsonLocation, } from './locate.js';
-export { EINVOICE_FLAVOUR_NAMES, EINVOICE_MAX_MESSAGES, EINVOICE_PROFILE_NAMES, capMessages, einvoiceResult, invoiceLineOf, type EinvoiceDisplay, type EinvoiceMessage, type EinvoiceResult, type EinvoiceValidation, } from './report.js';
+export { EINVOICE_FLAVOUR_NAMES, EINVOICE_HEADER_LENGTH, EINVOICE_MAX_MESSAGES, EINVOICE_PROFILE_NAMES, capMessages, einvoiceHeaderValue, einvoiceResult, invoiceLineOf, type EinvoiceDisplay, type EinvoiceMessage, type EinvoiceResult, type EinvoiceValidation, } from './report.js';
 export { htmlText } from './html-text.js';
 export { invoiceSkeleton } from './skeleton.js';
 /** Where the invoice sits in the render data. */
@@ -43,4 +43,6 @@ export type EinvoiceXml = {
  */
 export declare function einvoiceXml(data: unknown, options: {
     profile: EinvoiceProfile;
+    /** A test render's invoice, whose first note says it is none (`EINVOICE_TEST_NOTE`). */
+    test?: boolean;
 }): EinvoiceXml;

package/types/lib/einvoice/report.d.cts

@@ -62,6 +62,21 @@ export declare const EINVOICE_MAX_MESSAGES = 50;
 export declare function capMessages(messages: readonly EinvoiceMessage[], max?: number): Pick<EinvoiceValidation, 'messages' | 'truncated'>;
 /** The result of a render that got as far as `validation` and `display` say. */
 export declare function einvoiceResult(options: Pick<EinvoiceOptions, 'profile' | 'flavour'>, specVersion: string, validation: EinvoiceValidation | null, display: DisplayCheck | null): EinvoiceResult;
+/**
+ * How long the report may be as a header value. A proxy answers a response whose headers grow past a
+ * few kilobytes with 502, and the e-invoice's report shares this room with a PDF/UA verdict
+ * (`ACCESSIBILITY_HEADER_LENGTH`) where a render made both.
+ */
+export declare const EINVOICE_HEADER_LENGTH = 8000;
+/**
+ * The report as a response header carries it: the editor's true render reads the file from the body
+ * and the report from `X-Formfeed-Einvoice`, percent-encoded because a validator's message is not
+ * always ASCII. A report too long for `limit` loses, in this order, every finding's place, then the
+ * findings from the last, warnings before errors, and says so in `truncated` (plan 25 §5.5). What
+ * makes it a verdict always arrives: whether the file is valid, the rule set, the validator's id and
+ * versions, the hashes of the bytes it judged, and the display check.
+ */
+export declare function einvoiceHeaderValue(result: EinvoiceResult, limit?: number): string;
 /** The names a person reads: `Factur-X` and `EN 16931` for `factur-x` and `en16931`. */
 export declare const EINVOICE_FLAVOUR_NAMES: Record<EinvoiceFlavour, string>;
 export declare const EINVOICE_PROFILE_NAMES: Record<EinvoiceProfile, string>;

package/types/lib/einvoice/report.d.ts

@@ -62,6 +62,21 @@ export declare const EINVOICE_MAX_MESSAGES = 50;
 export declare function capMessages(messages: readonly EinvoiceMessage[], max?: number): Pick<EinvoiceValidation, 'messages' | 'truncated'>;
 /** The result of a render that got as far as `validation` and `display` say. */
 export declare function einvoiceResult(options: Pick<EinvoiceOptions, 'profile' | 'flavour'>, specVersion: string, validation: EinvoiceValidation | null, display: DisplayCheck | null): EinvoiceResult;
+/**
+ * How long the report may be as a header value. A proxy answers a response whose headers grow past a
+ * few kilobytes with 502, and the e-invoice's report shares this room with a PDF/UA verdict
+ * (`ACCESSIBILITY_HEADER_LENGTH`) where a render made both.
+ */
+export declare const EINVOICE_HEADER_LENGTH = 8000;
+/**
+ * The report as a response header carries it: the editor's true render reads the file from the body
+ * and the report from `X-Formfeed-Einvoice`, percent-encoded because a validator's message is not
+ * always ASCII. A report too long for `limit` loses, in this order, every finding's place, then the
+ * findings from the last, warnings before errors, and says so in `truncated` (plan 25 §5.5). What
+ * makes it a verdict always arrives: whether the file is valid, the rule set, the validator's id and
+ * versions, the hashes of the bytes it judged, and the display check.
+ */
+export declare function einvoiceHeaderValue(result: EinvoiceResult, limit?: number): string;
 /** The names a person reads: `Factur-X` and `EN 16931` for `factur-x` and `en16931`. */
 export declare const EINVOICE_FLAVOUR_NAMES: Record<EinvoiceFlavour, string>;
 export declare const EINVOICE_PROFILE_NAMES: Record<EinvoiceProfile, string>;

package/types/lib/pdfa/index.d.cts

@@ -0,0 +1,112 @@
+import type { EinvoiceValidation } from '../einvoice/report.cjs';
+/**
+ * `@formfeed/engine/pdfa` (plan 26): what `pdf.pdfa` asks for, what it cannot go with, and the
+ * report a render keeps of what the validator said. No template engine is imported here and nothing
+ * of Node, so the gateway Worker, the render-worker, the editor and the CLI all read the same names.
+ *
+ * PDF/A is ISO 19005, a file format for keeping documents: the fonts embedded, the colours defined,
+ * nothing that needs the network or a password. Whether an archive keeps them as a law asks (the
+ * GoBD, for one) is a matter of how the archive is run, not of the file, so nothing here or on any
+ * page says "revisionssicher", "GoBD-konform", "certified" or "archive-compliant": the report says
+ * which part and level a file was held to, and by which validator.
+ */
+/**
+ * The levels a render can ask for. 3b is the default and what an e-invoice is; 2b is for archives
+ * that take PDF/A-2 and not PDF/A-3, which may carry any file as an attachment. PDF/A-1 forbids the
+ * transparency Chromium writes, so it is not offered.
+ */
+export declare const PDFA_LEVELS: readonly ["2b", "3b"];
+export type PdfaLevel = (typeof PDFA_LEVELS)[number];
+/** What `true` stands for. */
+export declare const PDFA_DEFAULT_LEVEL: PdfaLevel;
+/** The standard a level names, as the report and the `X-Formfeed-PDF-A` header write it. */
+export declare const PDFA_STANDARDS: {
+    readonly '2b': "PDF/A-2b";
+    readonly '3b': "PDF/A-3b";
+};
+export type PdfaStandard = (typeof PDFA_STANDARDS)[PdfaLevel];
+/** `pdf.pdfa` as a template's settings or a request write it. */
+export type PdfaSetting = PdfaLevel | boolean | null;
+/**
+ * `pdf.pdfa` as a render takes it: a level, `true` for the default level, and anything else off.
+ * There is no check to choose (plan 26, decision 2): a file that fails PDF/A fails the render.
+ */
+export declare function resolvePdfa(setting: unknown): PdfaLevel | null;
+/** Whether a `pdf.pdfa` value is one the API takes: a level, a boolean, or null. */
+export declare function isPdfaSetting(value: unknown): value is PdfaSetting;
+export declare function pdfaStandard(level: PdfaLevel): PdfaStandard;
+/**
+ * What `pdf.pdfa` cannot go with, in the words every place that refuses it uses (the gateway before
+ * a render costs anything, the worker for whoever calls it directly, `formfeed validate`, the API's
+ * template validation). A merge, a watermark and Word and PowerPoint templates go with it, since all
+ * of them come before the conversion.
+ */
+export declare const PDFA_REFUSALS: {
+    readonly password: "pdf.pdfa cannot be combined with post.password: PDF/A does not allow encryption";
+    readonly einvoice: "pdf.pdfa \"2b\" cannot be combined with an e-invoice: the invoice XML is an attachment, which PDF/A-2 does not allow. An e-invoice is a PDF/A-3b already; ask for \"3b\" or leave pdf.pdfa out";
+    readonly invalid: "settings.pdf.pdfa is \"2b\", \"3b\", true, false or null";
+};
+/** How many findings a render keeps; a render row travels in every list and webhook. */
+export declare const PDFA_MAX_MESSAGES = 50;
+/** One rule of PDF/A the file failed, as the validator reports it. */
+export interface PdfaMessage {
+    severity: 'error' | 'warning';
+    /** A clause of ISO 19005 and veraPDF's test number, `6.2.11.4.1-1`. */
+    rule: string | null;
+    message: string;
+    /** veraPDF's path to the object of the PDF. */
+    location: string | null;
+}
+/**
+ * `pdfa` on a render (plan 26): `null` unless the render asked for PDF/A or is an e-invoice with
+ * `pdf.pdfa` beside it. `conformant` is the validator's word on the file it judged; a render that
+ * succeeded delivered exactly that file, and one that failed delivered nothing.
+ */
+export interface PdfaResult {
+    standard: PdfaStandard;
+    conformant: boolean;
+    /** The validator and its version: its rule set moves between releases. */
+    validator: string;
+    /** The validator's own id for this report, which its log names too. */
+    id: string;
+    /** The versions of what converted and judged the file: `verapdf`, `pdfbox` (and `mustang` for an e-invoice). */
+    versions: Record<string, string>;
+    /** SHA-256 of the PDF that was judged: the delivered file when the render succeeded. */
+    pdf_sha256: string | null;
+    messages: PdfaMessage[];
+    /** More findings than the render keeps. */
+    truncated?: boolean;
+}
+/** The sidecar's report of `POST /pdf/pdfa` (`ArchiveReport` in `apps/conformance`). */
+export interface PdfaValidatorReport {
+    id: string;
+    valid: boolean;
+    pdfa: string;
+    validator: string;
+    messages: Array<{
+        severity?: string;
+        rule?: string | null;
+        message?: string;
+        location?: string | null;
+    }>;
+    truncated?: boolean;
+    versions?: Record<string, string>;
+}
+/** The report a render keeps, from the sidecar's, with the hash of the file it judged. */
+export declare function pdfaResult(level: PdfaLevel, report: PdfaValidatorReport, pdfSha256: string | null): PdfaResult;
+/**
+ * The `pdfa` block of an e-invoice that asked for PDF/A too (plan 26, decision 8): an e-invoice is
+ * a PDF/A-3b, converted and judged once, so the block is made from the e-invoice's own validation
+ * and its PDF findings. Null while that validation ended at the XML, before there was a file.
+ */
+export declare function pdfaFromEinvoice(validation: EinvoiceValidation | null | undefined): PdfaResult | null;
+/** Whether a stored value is a report: the API shows it, and null otherwise. */
+export declare function isPdfaResult(value: unknown): value is PdfaResult;
+/** How long the report may be as a header value: proxies refuse a response whose headers grow past a few kilobytes. */
+export declare const PDFA_HEADER_LENGTH = 2000;
+/**
+ * The report as the worker's binary answer carries it in `x-formfeed-pdfa`, percent-encoded: the
+ * gateway records it with the render and `preview-render` shows it. A file that was delivered
+ * passed, so its report is short; one that is too long anyway loses its findings and says so.
+ */
+export declare function pdfaHeaderValue(result: PdfaResult, limit?: number): string;

package/types/lib/pdfa/index.d.ts

@@ -0,0 +1,112 @@
+import type { EinvoiceValidation } from '../einvoice/report.js';
+/**
+ * `@formfeed/engine/pdfa` (plan 26): what `pdf.pdfa` asks for, what it cannot go with, and the
+ * report a render keeps of what the validator said. No template engine is imported here and nothing
+ * of Node, so the gateway Worker, the render-worker, the editor and the CLI all read the same names.
+ *
+ * PDF/A is ISO 19005, a file format for keeping documents: the fonts embedded, the colours defined,
+ * nothing that needs the network or a password. Whether an archive keeps them as a law asks (the
+ * GoBD, for one) is a matter of how the archive is run, not of the file, so nothing here or on any
+ * page says "revisionssicher", "GoBD-konform", "certified" or "archive-compliant": the report says
+ * which part and level a file was held to, and by which validator.
+ */
+/**
+ * The levels a render can ask for. 3b is the default and what an e-invoice is; 2b is for archives
+ * that take PDF/A-2 and not PDF/A-3, which may carry any file as an attachment. PDF/A-1 forbids the
+ * transparency Chromium writes, so it is not offered.
+ */
+export declare const PDFA_LEVELS: readonly ["2b", "3b"];
+export type PdfaLevel = (typeof PDFA_LEVELS)[number];
+/** What `true` stands for. */
+export declare const PDFA_DEFAULT_LEVEL: PdfaLevel;
+/** The standard a level names, as the report and the `X-Formfeed-PDF-A` header write it. */
+export declare const PDFA_STANDARDS: {
+    readonly '2b': "PDF/A-2b";
+    readonly '3b': "PDF/A-3b";
+};
+export type PdfaStandard = (typeof PDFA_STANDARDS)[PdfaLevel];
+/** `pdf.pdfa` as a template's settings or a request write it. */
+export type PdfaSetting = PdfaLevel | boolean | null;
+/**
+ * `pdf.pdfa` as a render takes it: a level, `true` for the default level, and anything else off.
+ * There is no check to choose (plan 26, decision 2): a file that fails PDF/A fails the render.
+ */
+export declare function resolvePdfa(setting: unknown): PdfaLevel | null;
+/** Whether a `pdf.pdfa` value is one the API takes: a level, a boolean, or null. */
+export declare function isPdfaSetting(value: unknown): value is PdfaSetting;
+export declare function pdfaStandard(level: PdfaLevel): PdfaStandard;
+/**
+ * What `pdf.pdfa` cannot go with, in the words every place that refuses it uses (the gateway before
+ * a render costs anything, the worker for whoever calls it directly, `formfeed validate`, the API's
+ * template validation). A merge, a watermark and Word and PowerPoint templates go with it, since all
+ * of them come before the conversion.
+ */
+export declare const PDFA_REFUSALS: {
+    readonly password: "pdf.pdfa cannot be combined with post.password: PDF/A does not allow encryption";
+    readonly einvoice: "pdf.pdfa \"2b\" cannot be combined with an e-invoice: the invoice XML is an attachment, which PDF/A-2 does not allow. An e-invoice is a PDF/A-3b already; ask for \"3b\" or leave pdf.pdfa out";
+    readonly invalid: "settings.pdf.pdfa is \"2b\", \"3b\", true, false or null";
+};
+/** How many findings a render keeps; a render row travels in every list and webhook. */
+export declare const PDFA_MAX_MESSAGES = 50;
+/** One rule of PDF/A the file failed, as the validator reports it. */
+export interface PdfaMessage {
+    severity: 'error' | 'warning';
+    /** A clause of ISO 19005 and veraPDF's test number, `6.2.11.4.1-1`. */
+    rule: string | null;
+    message: string;
+    /** veraPDF's path to the object of the PDF. */
+    location: string | null;
+}
+/**
+ * `pdfa` on a render (plan 26): `null` unless the render asked for PDF/A or is an e-invoice with
+ * `pdf.pdfa` beside it. `conformant` is the validator's word on the file it judged; a render that
+ * succeeded delivered exactly that file, and one that failed delivered nothing.
+ */
+export interface PdfaResult {
+    standard: PdfaStandard;
+    conformant: boolean;
+    /** The validator and its version: its rule set moves between releases. */
+    validator: string;
+    /** The validator's own id for this report, which its log names too. */
+    id: string;
+    /** The versions of what converted and judged the file: `verapdf`, `pdfbox` (and `mustang` for an e-invoice). */
+    versions: Record<string, string>;
+    /** SHA-256 of the PDF that was judged: the delivered file when the render succeeded. */
+    pdf_sha256: string | null;
+    messages: PdfaMessage[];
+    /** More findings than the render keeps. */
+    truncated?: boolean;
+}
+/** The sidecar's report of `POST /pdf/pdfa` (`ArchiveReport` in `apps/conformance`). */
+export interface PdfaValidatorReport {
+    id: string;
+    valid: boolean;
+    pdfa: string;
+    validator: string;
+    messages: Array<{
+        severity?: string;
+        rule?: string | null;
+        message?: string;
+        location?: string | null;
+    }>;
+    truncated?: boolean;
+    versions?: Record<string, string>;
+}
+/** The report a render keeps, from the sidecar's, with the hash of the file it judged. */
+export declare function pdfaResult(level: PdfaLevel, report: PdfaValidatorReport, pdfSha256: string | null): PdfaResult;
+/**
+ * The `pdfa` block of an e-invoice that asked for PDF/A too (plan 26, decision 8): an e-invoice is
+ * a PDF/A-3b, converted and judged once, so the block is made from the e-invoice's own validation
+ * and its PDF findings. Null while that validation ended at the XML, before there was a file.
+ */
+export declare function pdfaFromEinvoice(validation: EinvoiceValidation | null | undefined): PdfaResult | null;
+/** Whether a stored value is a report: the API shows it, and null otherwise. */
+export declare function isPdfaResult(value: unknown): value is PdfaResult;
+/** How long the report may be as a header value: proxies refuse a response whose headers grow past a few kilobytes. */
+export declare const PDFA_HEADER_LENGTH = 2000;
+/**
+ * The report as the worker's binary answer carries it in `x-formfeed-pdfa`, percent-encoded: the
+ * gateway records it with the render and `preview-render` shows it. A file that was delivered
+ * passed, so its report is short; one that is too long anyway loses its findings and says so.
+ */
+export declare function pdfaHeaderValue(result: PdfaResult, limit?: number): string;