@jasy/cli 1.0.0-alpha.1 → 1.0.0-alpha.3

package/dist/commands/validate.js

@@ -5,9 +5,9 @@ import { describeInvoice } from "../core/detect.js";
 import { validateInvoiceXml, profileFor } from "../core/validate.js";
 import { checkPdfA3 } from "../core/pdfa.js";
 import { findVerapdf, runVeraPdf } from "../core/verapdf.js";
-// `jasy validate <file> [-v]` - runs the full local check (EN 16931 business rules + structural
-// PDF/A-3) on a ZUGFeRD/XRechnung PDF or raw XML, prints a report, and exits non-zero when invalid
-// (so it slots into scripts/CI). Same UI-agnostic core as the TUI.
+// `jasy validate <file> [--json] [-v]` - runs the full local check (EN 16931 business rules +
+// structural PDF/A-3, plus veraPDF when installed) on a ZUGFeRD/XRechnung PDF or raw XML, prints a
+// report (or `--json` for scripts/CI/services), and exits non-zero when invalid. Same core as the TUI.
 const tty = process.stdout.isTTY;
 const paint = (code, s) => (tty ? `\x1b[${code}m${s}\x1b[0m` : s);
 const green = (s) => paint("32", s);
@@ -15,12 +15,19 @@ const red = (s) => paint("31", s);
 const dim = (s) => paint("2", s);
 const bold = (s) => paint("1", s);
 export function validateCommand(args) {
-    var _a, _b;
+    var _a;
     const file = args.find((a) => !a.startsWith("-"));
     const verbose = args.includes("-v") || args.includes("--verbose");
-    if (!file) {
-        console.error("usage: jasy validate <file.pdf|file.xml> [-v]");
+    const json = args.includes("--json");
+    const fail = (msg) => {
+        if (json)
+            console.log(JSON.stringify({ error: msg }));
+        else
+            console.error(red(`✗ ${msg}`));
         process.exitCode = 1;
+    };
+    if (!file) {
+        fail("usage: jasy validate <file.pdf|file.xml> [--json] [-v]");
         return;
     }
     const base = (_a = process.env.INIT_CWD) !== null && _a !== void 0 ? _a : process.cwd();
@@ -29,8 +36,7 @@ export function validateCommand(args) {
         bytes = readFileSync(resolve(base, file));
     }
     catch (e) {
-        console.error(red(`✗ could not read ${file}: ${e.message}`));
-        process.exitCode = 1;
+        fail(`could not read ${file}: ${e.message}`);
         return;
     }
     const read = readInvoice(bytes);
@@ -41,11 +47,71 @@ export function validateCommand(args) {
         try {
             rules = validateInvoiceXml(read.xml, profileFor(read.meta));
         }
-        catch (_c) {
+        catch (_b) {
             rules = null;
         }
     }
     const pdfa = read.isPdf ? checkPdfA3(bytes) : null;
+    // Full ISO 19005 (PDF/A) via veraPDF - only when installed; never blocks, just adds the official seal.
+    let vera = null;
+    if (read.isPdf && findVerapdf()) {
+        try {
+            vera = runVeraPdf(resolve(base, file));
+        }
+        catch (_c) {
+            vera = null;
+        }
+    }
+    // VALID requires that we actually recognised EN 16931 invoice data: a file we could not parse as an
+    // invoice (random bytes, or a plain PDF with no embedded XML) is "not an invoice" - never "valid".
+    const recognized = read.meta.syntax !== "unknown";
+    const ok = recognized && (!rules || rules.valid) && (!pdfa || pdfa.ok) && (!vera || vera.ok);
+    if (!ok)
+        process.exitCode = 1;
+    if (json) {
+        console.log(JSON.stringify(toJson(file, read, rules, pdfa, vera, recognized, ok)));
+        return;
+    }
+    printReport(file, read, rules, pdfa, vera, recognized, ok, verbose);
+}
+/** The machine-readable report (`--json`): the exact same data the printed report shows. */
+function toJson(file, read, rules, pdfa, vera, recognized, ok) {
+    var _a;
+    return {
+        file: basename(file),
+        summary: describeInvoice(read.meta),
+        recognized,
+        valid: ok,
+        businessRules: rules && {
+            kind: rules.profile.startsWith("xrechnung") ? "XRechnung" : "EN 16931",
+            profile: rules.profile,
+            valid: rules.valid,
+            errors: rules.errors,
+            warnings: rules.warnings,
+        },
+        pdfA3: pdfa && {
+            valid: pdfa.ok,
+            passed: pdfa.checks.filter((c) => c.ok).length,
+            total: pdfa.checks.length,
+            checks: pdfa.checks,
+        },
+        // null when it isn't a PDF; { available: false } when it is but veraPDF isn't installed.
+        veraPdf: read.isPdf
+            ? vera
+                ? {
+                    available: true,
+                    valid: vera.ok,
+                    profile: vera.profile,
+                    failedRules: (_a = vera.failedRules) !== null && _a !== void 0 ? _a : vera.failures.length,
+                    failures: vera.failures,
+                }
+                : { available: false }
+            : null,
+    };
+}
+/** The human-readable report (default): a coloured summary line + per-check detail. */
+function printReport(file, read, rules, pdfa, vera, recognized, ok, verbose) {
+    var _a;
     const label = (s) => s.padEnd(20);
     console.log(`\n  ${bold(basename(file))}  ${dim("·")}  ${describeInvoice(read.meta)}\n`);
     // business rules
@@ -75,18 +141,9 @@ export function validateCommand(args) {
     else {
         console.log(`  ${label("PDF/A-3 structure")}${dim("n/a (raw XML)")}`);
     }
-    // full ISO 19005 (PDF/A) via veraPDF - only when installed; never blocks, just adds the official seal
-    let vera = null;
-    if (read.isPdf && findVerapdf()) {
-        try {
-            vera = runVeraPdf(resolve(base, file));
-        }
-        catch (_d) {
-            vera = null;
-        }
-    }
+    // full ISO 19005 (PDF/A) via veraPDF
     if (vera) {
-        const n = (_b = vera.failedRules) !== null && _b !== void 0 ? _b : vera.failures.length;
+        const n = (_a = vera.failedRules) !== null && _a !== void 0 ? _a : vera.failures.length;
         console.log(`  ${label("PDF/A (veraPDF)")}${vera.ok ? green("✓ compliant") : red(`✗ ${n} failed`)}`);
         if (!vera.ok)
             for (const f of vera.failures)
@@ -95,8 +152,8 @@ export function validateCommand(args) {
     else if (read.isPdf) {
         console.log(`  ${label("PDF/A (veraPDF)")}${dim("n/a - `jasy verapdf --install` for the full ISO check")}`);
     }
-    const ok = (!rules || rules.valid) && (!pdfa || pdfa.ok) && (!vera || vera.ok);
-    console.log(`\n  → ${ok ? green(bold("VALID")) : red(bold("INVALID"))}\n`);
-    if (!ok)
-        process.exitCode = 1;
+    if (!recognized)
+        console.log(`\n  → ${red(bold("NOT A ZUGFeRD / XRECHNUNG INVOICE"))}  ${dim("(no EN 16931 data found)")}\n`);
+    else
+        console.log(`\n  → ${ok ? green(bold("VALID")) : red(bold("INVALID"))}\n`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jasy/cli",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.3",
   "description": "Interactive terminal to validate, read and export ZUGFeRD / XRechnung e-invoices.",
   "keywords": [
     "cli",