@n42/cli 0.2.42 → 0.2.72

package/.github/workflows/ci.yaml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint
+        run: npx --no-install eslint src
+
+      - name: Run tests with coverage
+        run: npm run test:coverage
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: true

package/.github/workflows/cli-test-npm.yaml

@@ -0,0 +1,66 @@
+name: CLI Tests on npm Installations
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version of @n42/cli to test (e.g. 0.4.2 or 0.2.42)'
+        required: true
+        type: string
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x, 'lts/*']
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      # ---- Global install (fresh) ----
+      - name: Global install fresh @n42/cli@${{ inputs.version }}
+        run: |
+          npm install -g @n42/cli@${{ inputs.version }}
+          echo "Installed version:"
+          n42 --version
+          # Run your validation script (assumes it exists in repo)
+          node test/asserts/validate_tests.js || echo "Validation failed - check logs"
+
+      # ---- Global upgrade to latest ----
+      - name: Global upgrade to latest @n42/cli
+        run: |
+          npm install -g @n42/cli
+          echo "Upgraded version:"
+          n42 --version
+          node test/asserts/validate_tests.js || echo "Validation failed after upgrade"
+
+      # ---- Local install (fresh) in isolated dir ----
+      - name: Local install fresh @n42/cli@${{ inputs.version }}
+        run: |
+          mkdir local-fresh && cd local-fresh
+          npm init -y
+          npm install @n42/cli@${{ inputs.version }}
+          echo "Local fresh version:"
+          npx n42 --version
+          node ../test/asserts/validate_tests.js || echo "Local validation failed"
+          cd ..
+
+      # ---- Local upgrade to latest ----
+      - name: Local upgrade to latest @n42/cli
+        run: |
+          mkdir local-upgrade && cd local-upgrade
+          npm init -y
+          npm install @n42/cli@${{ inputs.version }}
+          npm install @n42/cli
+          echo "Local upgraded version:"
+          npx n42 --version
+          node ../test/asserts/validate_tests.js || echo "Local upgrade validation failed"
+          cd ..

package/README.md

@@ -1,18 +1,23 @@
+[![codecov](https://codecov.io/gh/node42-dev/node42-cli/graph/badge.svg)](https://codecov.io/gh/node42-dev/node42-cli)
+[![CI](https://github.com/node42-dev/node42-cli/actions/workflows/ci.yaml/badge.svg)](https://github.com/node42-dev/node42-cli/actions/workflows/ci.yaml)
+[![npm](https://img.shields.io/npm/v/@n42/cli.svg)](https://www.npmjs.com/package/@n42/cli)
+[![Swagger](https://img.shields.io/badge/Swagger-Discovery%20API-green)](https://node42.dev/docs/discovery)
+
 # Node42 CLI
 
-Command-line interface for **eDelivery discovery, diagnostics, and
-validation**, with support for the Peppol network.
+Command-line frontend for Node42 **eDelivery path discovery**, diagnostics and validation with support for the Peppol network.
+
+The Node42 CLI is a **scriptable command-line client** to the **Node42 WebUI and API**, 
+built for **system integrators**, **service providers**, and **operators** who need fast,
+repeatable insight into eDelivery routing, SML/SMK, SMP resolution, and Access Point behavior.
 
-The Node42 CLI is designed for **system integrators, service providers,
-and operators** who need fast, repeatable insight into eDelivery
-routing, SML/SMK, SMP resolution, and Access Point behavior.
+It exposes the **same capabilities as the Node42 WebUI** but optimized for automation
+and local analysis.
 
 While Node42's toolset **includes** modules capable of constructing and **sending
 standards-compliant messages**, it is **intended for diagnostics**, validation,
 and testing — not for production message exchange.
 
-
-
 ## Features
 
 - Peppol eDelivery path discovery

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@n42/cli",
-  "version": "0.2.42",
+  "version": "0.2.72",
   "description": "Node42 CLI – Command-line interface for Peppol eDelivery path discovery, diagnostics, and tooling",
   "keywords": [
-    "node42", "peppol", "edelivery", "diagnostics",
-    "cli", "api"
+    "node42",
+    "peppol",
+    "edelivery",
+    "diagnostics",
+    "cli",
+    "api"
   ],
   "homepage": "https://github.com/node42-dev/node42-cli",
   "repository": {
@@ -19,7 +23,22 @@
   },
   "scripts": {
     "lint": "eslint src",
-    "test": "mocha"
+    "test": "mocha",
+    "test:coverage": "c8 --reporter=text-summary --reporter=lcov mocha",
+    "test:watch": "mocha --watch",
+    "build": "esbuild src/cli.js --bundle --platform=node --target=node20 --outfile=dist/n42 --format=cjs --minify --banner:js='#!/usr/bin/env node'"
+  },
+  "c8": {
+    "exclude": [
+      "src/assets/**",
+      "src/completion/**",
+      "src/config.js",
+      "src/colors.js"
+    ],
+    "check-coverage": true,
+    "lines": 70,
+    "functions": 70,
+    "branches": 70
   },
   "engines": {
     "node": ">=18"
@@ -27,10 +46,14 @@
   "dependencies": {
     "commander": "^11.1.0",
     "inquirer": "^8.2.7",
-    "open": "^11.0.0"
+    "open": "^11.0.0",
+    "xmldom": "^0.6.0",
+    "xpath": "^0.0.34"
   },
   "devDependencies": {
+    "c8": "^10.1.3",
     "chai": "^4.5.0",
+    "esbuild": "^0.27.2",
     "eslint": "^9.39.2",
     "globals": "^17.2.0",
     "mocha": "^11.3.0",

package/src/assets/{wrapper.html.template → discover.html.template}

@@ -28,6 +28,6 @@
         </div>
       </div>
     </div>
-     <script src="../../assets/wrapper.js" defer></script>
+     <script src="../../assets/discover.js" defer></script>
   </body>
 </html>

package/src/assets/validator-light.css

@@ -0,0 +1,49 @@
+#xmldata {
+    background: #fff;
+    padding: 6px 12px 6px 10px;
+    color: #9ca3af;
+    font-family: monospace;
+    white-space: pre-wrap;
+    overflow-x: auto;
+    cursor: default;
+}
+
+.xml-info0 {
+    background: #e5e7eb;
+    color: #374151;
+    border-left: 4px solid #9ca3af;
+    padding-left: 2px;
+    cursor: pointer;
+}  
+
+.xml-info1 {
+    background: #e0f2fe;
+    color: #111827;
+    border-left: 4px solid #38bdf8;
+    padding-left: 2px;
+    cursor: pointer;
+}
+
+.xml-info2 {
+    background: #f3e8ff;
+    color: #111827;
+    border-left: 4px solid #a855f7;
+    padding-left: 2px;
+    cursor: pointer;
+}
+
+.xml-warning {
+    background: #fef3c7;
+    color: #111827;
+    border-left: 4px solid #f59e0b;
+    padding-left: 2px;
+    cursor: pointer;
+}
+
+.xml-error {
+    background: #fee2e2;
+    color: #111827;
+    border-left: 4px solid #dc2626;
+    padding-left: 2px;
+    cursor: pointer;
+}

package/src/assets/validator.html.template

@@ -0,0 +1,27 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <title>Node42</title>
+    <link rel="stylesheet" href="../../assets/wrapper-light.css">
+    <link rel="stylesheet" href="../../assets/validator-light.css">
+  </head>
+  <body>
+    <div id="app-header">
+      <div class="header-left">
+        <img id="appBtn" src="../../assets/node42-logo.svg" alt="Node42" onclick="window.open('https://www.node42.dev', '_blank');">
+      </div>
+      <div class="header-right"></div>
+    </div>
+    <div id="page">
+      <div id="app-shell">
+        <div id="timeline"></div>
+          <div id="bubble" class="bubble" data-uuid="/--UUID--/">
+            <div id="xmldata"><!-- XML --></div>
+            <div class="bubble-time"><!-- TIME --></div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

package/src/assets/wrapper-light.css

@@ -95,6 +95,13 @@ body {
     display: block;
 }
 
+.bubble-title {
+    font-size: 17px;
+    font-weight: 600;
+    margin-bottom: 2px;
+    text-align: center;
+}
+
 .bubble-time {
     position: absolute;
     bottom: -24px;

package/src/cli.js

@@ -4,6 +4,7 @@ const { Command } = require("commander");
 const { login, logout, checkAuth, setApiKey, getApiKey, removeApiKey } = require("./auth");
 const { getUserWithIndex, getUserUsage } = require("./user");
 const { runDiscovery } = require("./discover");
+const { runValidation } = require("./validator");
 const { startSpinner, validateEnv, validateId, createAppDirs, capitalize, cleanAppDirs } = require("./utils");
 const { NODE42_DIR, ARTEFACTS_DIR, DEFAULT_OUTPUT, DEFAULT_FORMAT } = require("./config");
 
@@ -40,6 +41,16 @@ program
     console.log(`Run: ${C.BOLD}source ${dest}${C.RESET}\n`);
   });
 
+program
+  .command("login")
+  .description("Authenticate using username and password and store tokens locally")
+  .action(login);
+
+program
+  .command("logout")
+  .description("Terminate user session and delete all local tokens")
+  .action(logout);
+
 program
   .command("apikey")
   .description("Manage API key authentication")
@@ -76,29 +87,6 @@ program
     console.log(apiKey ? `${C.RED}API key configured${C.RESET}\n` : `${C.RED}No API key configured${C.RESET}\n`);
   });
 
-program
-  .command("login")
-  .description("Authenticate using username and password and store tokens locally")
-  .action(login);
-
-program
-  .command("logout")
-  .description("Terminate user session and delete all local tokens")
-  .action(logout);
-
-program
-  .command("clean")
-  .description("Remove locally stored artefacts and cache")
-  .option("--tokens", "Remove stored authentication tokens")
-  .option("--artefacts", "Remove artefacts")
-  .option("--transactions", "Remove transactions")
-  .option("--validations", "Remove validations")
-  .option("--db", "Remove local database")
-  .option("--all", "Wipe all local data")
-  .action((options)=> {
-      cleanAppDirs(options);
-  });
-
 program
   .command("me")
   .description("Returns identity and service usage for the authenticated user.")
@@ -148,6 +136,19 @@ program
     console.log(` • ${currentMonth}: ${C.RED}${usage}${C.RESET}\n`);
   });
 
+program
+  .command("clean")
+  .description("Remove locally stored artefacts and cache")
+  .option("--tokens", "Remove stored authentication tokens")
+  .option("--artefacts", "Remove artefacts")
+  .option("--transactions", "Remove transactions")
+  .option("--validations", "Remove validations")
+  .option("--db", "Remove local database")
+  .option("--all", "Wipe all local data")
+  .action((options)=> {
+      cleanAppDirs(options);
+  });
+
 program
   .command("history [participantId]")
   .description("Show local history with filtering")
@@ -260,4 +261,26 @@ discover
     runDiscovery(participantId, options);
   });
 
+const validate = program
+  .command("validate")
+  .description("Run document validation using configurable rulesets");
+
+validate
+  .command("peppol <document>")
+  .description("Validate a document against Peppol validation rulesets")
+  .option("-r, --ruleset <ruleset>", "Validation ruleset to use (latest | current | legacy)", "current")
+  .option("--location", "Include XPath location for each validation assertion", true)
+  .option("--runtime", "Include execution time in the validation output", false)
+  .action((document, options) => {
+    if (!fs.existsSync(document)) {
+      console.error("Couldn't find a valid document at the selected path");
+      process.exit(1);
+    }
+
+    const xmlDoc = fs.readFileSync(document, "utf8");
+    const docName = path.basename(document);
+
+    runValidation(docName, xmlDoc, options);
+  });
+
 program.parse(process.argv);

package/src/completion/bash.sh

@@ -3,7 +3,7 @@ _n42_completions()
   local cur prev words cword
   _init_completion || return
 
-  local commands="login logout me usage history discover clean"
+  local commands="login logout apikey me usage clean history discover validate"
 
   if [[ $cword -eq 1 ]]; then
     COMPREPLY=( $(compgen -W "$commands" -- "$cur") )
@@ -16,6 +16,12 @@ _n42_completions()
     return
   fi
 
+  # validate peppol
+  if [[ ${words[1]} == "validate" && $cword -eq 2 ]]; then
+    COMPREPLY=( $(compgen -W "peppol" -- "$cur") )
+    return
+  fi
+
   # usage discovery|validation|transactions
   if [[ ${words[1]} == "usage" && $cword -eq 2 ]]; then
     COMPREPLY=( $(compgen -W "discovery validation transactions" -- "$cur") )

package/src/config.js

@@ -6,6 +6,8 @@ const config = {
   API_URL: "https://api.node42.dev",
   WWW_URL: "https://www.node42.dev",
 
+  VALIDATOR_URL: "https://validator.node42.dev",
+
   API_TIMEOUT_MS: 30000,
 
   NODE42_DIR: path.join(os.homedir(), ".node42"),
@@ -24,7 +26,8 @@ const config = {
   EP_SIGNIN: "auth/signin",
   EP_REFRESH: "auth/refresh",
   EP_ME: "users/me",
-  EP_DISCOVER: "discover/peppol"
+  EP_DISCOVER: "discover/peppol",
+  EP_VALIDATE: "validate"
 };
 
 config.ARTEFACTS_DIR = path.join(config.NODE42_DIR, "artefacts", "discovery");

package/src/discover.js

@@ -43,7 +43,7 @@ function wrapSvg(fileId, refId, svg) {
     minute: "2-digit"
   });
 
-  const templateFile = path.join(NODE42_DIR, "assets/wrapper.html.template");
+  const templateFile = path.join(NODE42_DIR, "assets/discover.html.template");
   const template = fs.readFileSync(templateFile, "utf8");
   
   html = template.replace("<!-- SVG -->", svg);

package/src/utils.js

@@ -10,7 +10,7 @@ const pkg = require("../package.json");
 const db = require("./db");
 const C = require("./colors");
 
-
+/* c8 ignore next */
 function writeHeader(text, clearScreen=false) {
   if (clearScreen) {
     process.stdout.write("\x1Bc");
@@ -22,6 +22,7 @@ function writeHeader(text, clearScreen=false) {
   }
 }
 
+/* c8 ignore next */
 function ask(question, def, hidden=false) {
   return new Promise(resolve => {
     const rl = readline.createInterface({
@@ -58,6 +59,7 @@ function ask(question, def, hidden=false) {
   });
 }
 
+/* c8 ignore next */
 function startSpinner(text = "Working") {
   const frames = ["-", "\\", "|", "/"];
   let i = 0;
@@ -73,6 +75,7 @@ function startSpinner(text = "Working") {
   };
 }
 
+/* c8 ignore next */
 async function promptForDocument(docs) {
   const { document } = await inquirer.prompt([
     {
@@ -109,10 +112,12 @@ function validateId(type, id) {
   }
 }
 
+/* c8 ignore next */
 function getShortId(id) {
   return id.slice(0, 8);
 }
 
+/* c8 ignore next */
 function capitalize(s) {
   return s.charAt(0).toUpperCase() + s.slice(1);
 }