pdfn 0.8.0 → 0.8.2

package/README.md

@@ -31,11 +31,9 @@ npx pdfn dev --open    # Start and open browser
 - Live preview with hot reload
 - Inspector panel (performance, debug overlays)
 - Accessibility checker (axe-core)
-- PDF/A standard dropdown — requires `PDFN_API_KEY`
+- PDF/A compliance dropdown
 
-**PDF/A Standards:**
-
-Generate archival PDFs via pdfn Cloud:
+**PDF/A Compliance:**
 
 | Standard | Description |
 |----------|-------------|
@@ -43,7 +41,11 @@ Generate archival PDFs via pdfn Cloud:
 | PDF/A-2b | PDF 1.7 archival, allows transparency |
 | PDF/A-3b | Like PDF/A-2b plus embedded files |
 
-Select a standard from the dropdown in the dev server UI. PDF/A downloads require a pdfn Cloud API key (`PDFN_API_KEY`).
+> `pdfn dev` focuses on layout preview. PDF/A archival compliance (validation, metadata, color profiles) is applied by pdfn Cloud as post-processing.
+>
+> **Layout is identical** whether you use pdfn dev, pdfn Cloud, or self-host. Compliance does not change layout — it only adds validation and archival metadata.
+
+To generate PDF/A-compliant PDFs, set `PDFN_API_KEY`. Without an API key, requests with a standard will fail.
 
 **Server API:**
 

package/dist/cli.js

@@ -1708,7 +1708,7 @@ async function generatePdf(page, html, options = {}) {
     contentLoadTime = performance.now() - contentStart;
     const pagedStart = performance.now();
     await page.waitForFunction(
-      () => window.PDFN?.ready === true,
+      () => typeof window.PDFN === "undefined" || window.PDFN?.ready === true,
       { timeout }
     );
     pagedJsTime = performance.now() - pagedStart;
@@ -1764,12 +1764,27 @@ async function generatePdf(page, html, options = {}) {
 function createGenerateHandler(browserManager, options = {}) {
   const { timeout = 3e4, onSuccess, onError } = options;
   return async (req, res) => {
-    const { html, options: pdfOptions } = req.body;
+    const { html, standard, options: pdfOptions } = req.body;
     const format = req.query.format;
     if (!html) {
       res.status(400).json({ error: "HTML content is required" });
       return;
     }
+    if (standard) {
+      res.status(400).json({
+        error: `PDF/A archival compliance requires the pdfn Cloud compliance pipeline.
+
+Layout is identical in local dev. Compliance does not change layout or rendering \u2014 it only adds validation and archival metadata.
+
+To generate ${standard}-compliant PDFs:
+  Set: PDFN_API_KEY=pdfn_live_...
+  Get key at: https://console.pdfn.dev
+
+To preview layout without compliance:
+  Remove the 'standard' option`
+      });
+      return;
+    }
     if (format === "html") {
       res.setHeader("Content-Type", "text/html; charset=utf-8");
       res.send(html);
@@ -2642,7 +2657,7 @@ function createPreviewHTML(templates, activeTemplate, hasCloudAccess) {
 
     .btn-primary:hover { background: var(--primary-hover); border-color: var(--primary-hover); }
 
-    .conformance-select {
+    .standard-select {
       padding: 6px 10px;
       background: var(--surface-2);
       border: 1px solid #333;
@@ -2652,8 +2667,8 @@ function createPreviewHTML(templates, activeTemplate, hasCloudAccess) {
       cursor: pointer;
     }
 
-    .conformance-select:hover { border-color: #444; }
-    .conformance-select:focus { outline: none; border-color: var(--primary); }
+    .standard-select:hover { border-color: #444; }
+    .standard-select:focus { outline: none; border-color: var(--primary); }
 
     .cloud-key-message {
       display: none;
@@ -2730,12 +2745,11 @@ function createPreviewHTML(templates, activeTemplate, hasCloudAccess) {
             <div class="page-info" id="page-info"></div>
           </div>
           <div class="context-actions">
-            <select id="conformance-select" class="conformance-select" title="PDF conformance level">
+            <select id="standard-select" class="standard-select" title="PDF standard">
               <option value="">Standard PDF (Local)</option>
               <option value="PDF/A-1b">PDF/A-1b (Cloud)</option>
               <option value="PDF/A-2b">PDF/A-2b (Cloud)</option>
               <option value="PDF/A-3b">PDF/A-3b (Cloud)</option>
-              <option value="PDF/UA">PDF/UA (Cloud)</option>
             </select>
             <button class="btn" id="preview-pdf" title="Preview PDF">
               <svg width="14" height="14" fill="none" stroke="currentColor" viewBox="0 0 24 24">
@@ -3243,23 +3257,23 @@ function createPreviewHTML(templates, activeTemplate, hasCloudAccess) {
 
         document.getElementById('view-html').href = htmlUrl;
 
-        // Preview button handler (local only - hidden when conformance selected)
+        // Preview button handler (local only - hidden when standard selected)
         document.getElementById('preview-pdf').onclick = () => {
           window.open(pdfUrl, '_blank');
         };
 
         // Download button handler
         document.getElementById('download-pdf').onclick = async () => {
-          const conformance = document.getElementById('conformance-select').value;
+          const standard = document.getElementById('standard-select').value;
           const btn = document.getElementById('download-pdf');
 
-          if (conformance) {
-            // Use pdfn cloud for conformance PDFs
+          if (standard) {
+            // Use pdfn cloud for PDF/A standard
             btn.innerHTML = spinnerSvg + ' Generating...';
             btn.disabled = true;
 
             try {
-              const response = await fetch('/api/template/' + templateId + '/pdf-conformance?conformance=' + encodeURIComponent(conformance));
+              const response = await fetch('/api/template/' + templateId + '/pdf-standard?standard=' + encodeURIComponent(standard));
               if (!response.ok) {
                 const error = await response.json();
                 throw new Error(error.error || 'Failed to generate PDF');
@@ -3309,20 +3323,20 @@ function createPreviewHTML(templates, activeTemplate, hasCloudAccess) {
     const downloadIcon = '<svg width="14" height="14" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4"/></svg>';
     const cloudDownloadIcon = '<svg width="14" height="14" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M9 19l3 3m0 0l3-3m-3 3V10"/></svg>';
 
-    // Update Preview and Download buttons based on conformance selection
+    // Update Preview and Download buttons based on standard selection
     function updateActionButtons() {
-      const conformance = document.getElementById('conformance-select').value;
+      const standard = document.getElementById('standard-select').value;
       const previewBtn = document.getElementById('preview-pdf');
       const downloadBtn = document.getElementById('download-pdf');
       const cloudMessage = document.getElementById('cloud-key-message');
-      const needsCloud = !!conformance;
+      const needsCloud = !!standard;
       const cloudAvailable = hasCloudAccess;
 
       if (needsCloud) {
         // Cloud mode - hide Preview, show cloud Download
         previewBtn.style.display = 'none';
         downloadBtn.innerHTML = cloudDownloadIcon + ' Download';
-        downloadBtn.title = 'Download ' + conformance + ' PDF via pdfn Cloud';
+        downloadBtn.title = 'Download ' + standard + ' PDF via pdfn Cloud';
 
         if (!cloudAvailable) {
           // Show message and disable Download
@@ -3353,7 +3367,7 @@ function createPreviewHTML(templates, activeTemplate, hasCloudAccess) {
     }
 
     // Conformance select change handler
-    document.getElementById('conformance-select').onchange = updateActionButtons;
+    document.getElementById('standard-select').onchange = updateActionButtons;
 
     // Accessibility check handler
     let a11yHasRun = false;
@@ -3756,22 +3770,22 @@ async function startDevServer(options) {
       res.status(500).send(`Error generating PDF: ${error}`);
     }
   });
-  app.get("/api/template/:id/pdf-conformance", async (req, res) => {
+  app.get("/api/template/:id/pdf-standard", async (req, res) => {
     const template = templates.find((t) => t.id === req.params.id);
     if (!template) {
       res.status(404).json({ error: "Template not found" });
       return;
     }
-    const conformance = req.query.conformance;
-    const validConformance = ["PDF/A-1b", "PDF/A-2b", "PDF/A-3b", "PDF/UA"];
-    if (!conformance || !validConformance.includes(conformance)) {
-      res.status(400).json({ error: `Invalid conformance. Must be one of: ${validConformance.join(", ")}` });
+    const standard = req.query.standard;
+    const validStandards = ["PDF/A-1b", "PDF/A-2b", "PDF/A-3b"];
+    if (!standard || !validStandards.includes(standard)) {
+      res.status(400).json({ error: `Invalid standard. Must be one of: ${validStandards.join(", ")}` });
       return;
     }
     const apiKey = process.env.PDFN_API_KEY;
     if (!apiKey) {
       res.status(400).json({
-        error: "PDFN_API_KEY required for conformance PDFs. Get one at https://console.pdfn.dev"
+        error: "PDFN_API_KEY required for PDF/A standard. Get one at https://console.pdfn.dev"
       });
       return;
     }
@@ -3784,7 +3798,7 @@ async function startDevServer(options) {
           "Content-Type": "application/json",
           "Authorization": `Bearer ${apiKey}`
         },
-        body: JSON.stringify({ html, conformance })
+        body: JSON.stringify({ html, standard })
       });
       if (!response.ok) {
         const error = await response.json().catch(() => ({ message: response.statusText }));
@@ -3796,7 +3810,7 @@ async function startDevServer(options) {
       console.log(
         chalk.green("  \u2713"),
         template.file,
-        chalk.dim(`\u2192 ${conformance}`),
+        chalk.dim(`\u2192 ${standard}`),
         chalk.magenta("(Cloud)"),
         chalk.dim("\u2022"),
         chalk.cyan(`${duration}ms`),
@@ -3808,7 +3822,7 @@ async function startDevServer(options) {
       res.send(pdfBuffer);
     } catch (error) {
       const message = error instanceof Error ? error.message : "Unknown error";
-      console.log(chalk.red("  \u2717"), template.file, chalk.red(`${conformance} generation failed:`), message);
+      console.log(chalk.red("  \u2717"), template.file, chalk.red(`${standard} generation failed:`), message);
       res.status(500).json({ error: message });
     }
   });