pdfnative 1.0.3 → 1.0.4

package/README.md

@@ -42,6 +42,8 @@ Pure native PDF generation library — zero vendor dependencies. ISO 32000-1 (PD
 - **Tree-shakeable** — ESM + CJS dual build with TypeScript declarations
 - **95%+ test coverage** — 1588+ tests across 40 files, fuzz suite, performance benchmarks
 - **NPM provenance** — signed builds via GitHub Actions OIDC
+- **On-device generation** — runs in Node, browsers, Workers, Deno, Bun. No SaaS round-trip; documents never leave the calling process unless your application explicitly sends them
+- **No telemetry, no network calls** — verifiable in source. The library never opens a socket, fetches remote fonts, or phones home
 
 ## Installation
 
@@ -944,6 +946,18 @@ When `tagged` is set, the output includes:
 
 The `tagged` option is backward-compatible — omitting it or setting `false` produces the same output as before.
 
+> **PDF/A status (v1.0.4).** As of v1.0.4 every PDF emits a trailer
+> `/ID` and the `/Info CreationDate` is byte-equivalent to the
+> `xmp:CreateDate` (with timezone offset) — closing two veraPDF
+> reference-validator findings. **Latin font embedding** is **not yet
+> implemented**: standard 14 Helvetica is still emitted as an
+> unembedded reference, which veraPDF flags under ISO 19005-1 §6.3.4.
+> Treat the `pdfaid:part` claim in XMP as aspirational until **v1.0.5**
+> lands. See [docs/guides/pdfa.html](docs/guides/pdfa.html) and the
+> tracking issue [release-notes/draft-issue-v1.0.5-latin-embedding.md](release-notes/draft-issue-v1.0.5-latin-embedding.md).
+> Run `npm run validate:pdfa` locally (with veraPDF installed) to
+> verify against the reference validator.
+
 ### PDF Encryption — Implemented ✅
 
 AES-128 and AES-256 encryption with owner/user passwords and granular permissions:

package/dist/index.cjs

@@ -4623,9 +4623,26 @@ function buildStructureTree(root, startObjNum, pageObjToStructParents) {
     totalObjects: nextObj - startObjNum
   };
 }
-function buildXMPMetadata(title, createDate, pdfaPart = 2, pdfaConformance = "B") {
+function buildPdfMetadata(now = /* @__PURE__ */ new Date()) {
+  const pad2 = (n) => String(n).padStart(2, "0");
+  const yyyy = now.getFullYear();
+  const mm = pad2(now.getMonth() + 1);
+  const dd = pad2(now.getDate());
+  const hh = pad2(now.getHours());
+  const mi = pad2(now.getMinutes());
+  const ss = pad2(now.getSeconds());
+  const tzMinutes = -now.getTimezoneOffset();
+  const tzSign = tzMinutes >= 0 ? "+" : "-";
+  const tzAbs = Math.abs(tzMinutes);
+  const tzH = pad2(Math.floor(tzAbs / 60));
+  const tzM = pad2(tzAbs % 60);
+  const pdfDate = `D:${yyyy}${mm}${dd}${hh}${mi}${ss}${tzSign}${tzH}'${tzM}'`;
+  const xmpDate = `${yyyy}-${mm}-${dd}T${hh}:${mi}:${ss}${tzSign}${tzH}:${tzM}`;
+  return { pdfDate, xmpDate };
+}
+function buildXMPMetadata(title, createDate, pdfaPart = 2, pdfaConformance = "B", author) {
   const escapedTitle = escapeXml(title);
-  return [
+  const lines = [
     '<?xpacket begin="\xEF\xBB\xBF" id="W5M0MpCehiHzreSzNTczkc9d"?>',
     '<x:xmpmeta xmlns:x="adobe:ns:meta/">',
     ' <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">',
@@ -4634,17 +4651,24 @@ function buildXMPMetadata(title, createDate, pdfaPart = 2, pdfaConformance = "B"
     '    xmlns:pdf="http://ns.adobe.com/pdf/1.3/"',
     '    xmlns:xmp="http://ns.adobe.com/xap/1.0/"',
     '    xmlns:pdfaid="http://www.aiim.org/pdfa/ns/id/">',
-    `   <dc:title><rdf:Alt><rdf:li xml:lang="x-default">${escapedTitle}</rdf:li></rdf:Alt></dc:title>`,
-    "   <dc:creator><rdf:Seq><rdf:li>pdfnative</rdf:li></rdf:Seq></dc:creator>",
+    `   <dc:title><rdf:Alt><rdf:li xml:lang="x-default">${escapedTitle}</rdf:li></rdf:Alt></dc:title>`
+  ];
+  if (author !== void 0 && author !== "") {
+    lines.push(`   <dc:creator><rdf:Seq><rdf:li>${escapeXml(author)}</rdf:li></rdf:Seq></dc:creator>`);
+  }
+  lines.push(
     "   <pdf:Producer>pdfnative</pdf:Producer>",
     `   <xmp:CreateDate>${createDate}</xmp:CreateDate>`,
+    `   <xmp:ModifyDate>${createDate}</xmp:ModifyDate>`,
+    `   <xmp:MetadataDate>${createDate}</xmp:MetadataDate>`,
     `   <pdfaid:part>${pdfaPart}</pdfaid:part>`,
     `   <pdfaid:conformance>${pdfaConformance}</pdfaid:conformance>`,
     "  </rdf:Description>",
     " </rdf:RDF>",
     "</x:xmpmeta>",
     '<?xpacket end="w"?>'
-  ].join("\n");
+  );
+  return lines.join("\n");
 }
 function buildOutputIntentDict(iccStreamObjNum, subtype = "GTS_PDFA1") {
   return `<< /Type /OutputIntent /S /${subtype} /OutputConditionIdentifier (sRGB IEC61966-2.1) /RegistryName (http://www.color.org) /DestOutputProfile ${iccStreamObjNum} 0 R >>`;
@@ -5256,7 +5280,7 @@ endstream`);
     _offset += d;
   }, objOffsets, parts };
 }
-function writeXrefTrailer(w, totalObjs, infoObjNum, encState) {
+function writeXrefTrailer(w, totalObjs, infoObjNum, encState, idSeed = "") {
   let encryptObjNum = 0;
   if (encState) {
     encryptObjNum = totalObjs + 1;
@@ -5274,11 +5298,13 @@ function writeXrefTrailer(w, totalObjs, infoObjNum, encState) {
 `);
   }
   w.emit("trailer\n");
+  const docId = encState ? encState.docId : md5(new TextEncoder().encode(`pdfnative|${idSeed}|${totalObjs}`));
+  const idArray = buildIdArray(docId);
   if (encState) {
-    w.emit(`<< /Size ${totalObjs + 1} /Root 1 0 R /Info ${infoObjNum} 0 R /Encrypt ${encryptObjNum} 0 R /ID ${buildIdArray(encState.docId)} >>
+    w.emit(`<< /Size ${totalObjs + 1} /Root 1 0 R /Info ${infoObjNum} 0 R /Encrypt ${encryptObjNum} 0 R /ID ${idArray} >>
 `);
   } else {
-    w.emit(`<< /Size ${totalObjs + 1} /Root 1 0 R /Info ${infoObjNum} 0 R >>
+    w.emit(`<< /Size ${totalObjs + 1} /Root 1 0 R /Info ${infoObjNum} 0 R /ID ${idArray} >>
 `);
   }
   w.emit("startxref\n");
@@ -6014,10 +6040,7 @@ function buildPDF(params, layoutOptions) {
   }
   const baseObjCount = enc.isUnicode ? 4 + fontEntries.length * 5 + wmExtraObjs + totalPages * 2 : 4 + wmExtraObjs + totalPages * 2;
   const infoObjNum = baseObjCount + 1;
-  const now = /* @__PURE__ */ new Date();
-  const pad2 = (n) => String(n).padStart(2, "0");
-  const pdfDate = `D:${now.getFullYear()}${pad2(now.getMonth() + 1)}${pad2(now.getDate())}${pad2(now.getHours())}${pad2(now.getMinutes())}${pad2(now.getSeconds())}`;
-  const isoDate = `${now.getFullYear()}-${pad2(now.getMonth() + 1)}-${pad2(now.getDate())}T${pad2(now.getHours())}:${pad2(now.getMinutes())}:${pad2(now.getSeconds())}`;
+  const { pdfDate, xmpDate: isoDate } = buildPdfMetadata();
   const infoTitle = params.docTitle || title || "";
   emitObj(
     infoObjNum,
@@ -6097,7 +6120,7 @@ endobj
     }
   }
   const writer = { emit, emitObj, emitStreamObj, offset: getOffset, adjustOffset, objOffsets, parts };
-  writeXrefTrailer(writer, totalObjs, infoObjNum, encState);
+  writeXrefTrailer(writer, totalObjs, infoObjNum, encState, `${infoTitle}|${pdfDate}`);
   return parts.join("");
 }
 function buildPDFBytes(params, layoutOptions) {
@@ -9703,10 +9726,7 @@ function buildDocumentPDF(params, layoutOptions) {
   }
   const baseObjCount = enc.isUnicode ? 4 + fontEntries.length * 5 + imageCount + wmExtraObjs + totalPages * 2 + totalAnnots + totalFormObjs + formFontObjs : 4 + imageCount + wmExtraObjs + totalPages * 2 + totalAnnots + totalFormObjs + formFontObjs;
   const infoObjNum = baseObjCount + 1;
-  const now = /* @__PURE__ */ new Date();
-  const pad2 = (n) => String(n).padStart(2, "0");
-  const pdfDate = `D:${now.getFullYear()}${pad2(now.getMonth() + 1)}${pad2(now.getDate())}${pad2(now.getHours())}${pad2(now.getMinutes())}${pad2(now.getSeconds())}`;
-  const isoDate = `${now.getFullYear()}-${pad2(now.getMonth() + 1)}-${pad2(now.getDate())}T${pad2(now.getHours())}:${pad2(now.getMinutes())}:${pad2(now.getSeconds())}`;
+  const { pdfDate, xmpDate: isoDate } = buildPdfMetadata();
   const infoTitle = params.title ?? "";
   const metaParts = [`/Title ${encodePdfTextString(infoTitle)}`, "/Producer (pdfnative)", `/CreationDate (${pdfDate})`];
   if (params.metadata?.author) {
@@ -9734,7 +9754,7 @@ function buildDocumentPDF(params, layoutOptions) {
     structTreeRootObjNum = tree.structTreeRootObjNum;
     totalObjs = treeStart + tree.totalObjects - 1;
     xmpObjNum = totalObjs + 1;
-    const xmpContent = buildXMPMetadata(infoTitle, isoDate, pdfaConfig.pdfaPart, pdfaConfig.pdfaConformance);
+    const xmpContent = buildXMPMetadata(infoTitle, isoDate, pdfaConfig.pdfaPart, pdfaConfig.pdfaConformance, params.metadata?.author);
     emitStreamObj(
       xmpObjNum,
       `<< /Type /Metadata /Subtype /XML /Length ${xmpContent.length}`,
@@ -9840,7 +9860,7 @@ endobj
     }
   }
   const writer = { emit, emitObj, emitStreamObj, offset: getOffset, adjustOffset, objOffsets, parts };
-  writeXrefTrailer(writer, totalObjs, infoObjNum, encState);
+  writeXrefTrailer(writer, totalObjs, infoObjNum, encState, `${infoTitle}|${pdfDate}`);
   return parts.join("");
 }
 function buildDocumentPDFBytes(params, layoutOptions) {