@n42/cli 0.2.32 → 0.2.71

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,13 +1,22 @@
-# Node42 CLI (n42)
+[![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)
 
-Command-line interface for **eDelivery discovery, diagnostics, and
-validation**, with support for the Peppol network.
+# Node42 CLI
 
-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.
+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.
+
+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
 
@@ -128,9 +137,15 @@ Artefacts are stored under:
 
 ## Error Handling
 
-Errors are printed with a clickable reference link:
+Errors are printed with a clickable reference link.
 
-    https://www.node42.dev/errors?code=XXXX
+Example output:
+
+``` bash
+Error: 9031 [View details]
+
+Invalid token: the authorization token provided is invalid
+``` 
 
 ## Security
 
@@ -139,4 +154,9 @@ Errors are printed with a clickable reference link:
 
 ## License
 
-MIT License
+MIT License
+
+## Author
+
+Alex Olsson \
+Node42

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@n42/cli",
-  "version": "0.2.32",
+  "version": "0.2.71",
   "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/auth.js

@@ -7,11 +7,54 @@ const { ask, startSpinner } = require("./utils");
 const db = require("./db");
 const C = require("./colors");
 
+function setApiKey(userId, key) {
+  if (!key) return;
+  
+  const database = db.load();
+
+  const u = database.user.find(x => x.id === userId);
+  if (!u) return;
+
+  u.apiKey = {
+    "value": key,
+    "createdAt": Date.now()
+  }
+
+  db.save(database);
+}
+
+function getApiKey(userId) {
+  const database = db.load();
+
+  const u = database.user.find(x => x.id === userId);
+  if (!u || !u.apiKey) return null;
+
+  return u.apiKey.value;
+}
+
+function removeApiKey(userId) {
+  const database = db.load();
+
+  const u = database.user.find(x => x.id === userId);
+  if (!u || !u.apiKey) return false;
+
+  delete u.apiKey;
+  db.save(database);
+
+  return true;
+}
 
 async function login() {
   console.log(`${C.BOLD}Sign in to your account${C.RESET}`);
   let user = getUserWithIndex(0);
 
+  const apiKey = getApiKey(user.id);
+  if (apiKey) {
+    console.log(`\n${C.RED}API key authentication is configured.${C.RESET}`);
+    console.log(`Login is not required.\n`);
+    return;
+  }
+
   const username = await ask("Username", user.userMail ?? "");
   const password = await ask("Password", null, true);
   console.log();
@@ -158,21 +201,33 @@ async function refreshSession() {
 }
 
 async function fetchWithAuth(url, options = {}) {
+  const user = getUserWithIndex(0);
+  const apiKey = user ? getApiKey(user.id) : null;
+
   let { accessToken } = loadTokens();
-  if (!accessToken) {
+
+  if (!accessToken && !apiKey) {
     handleError({ code: "N42E-9032" });
-    return;
+    return null;
+  }
+
+  if (apiKey) {
+    console.log(`${C.DIM}Authenticating with API key.${C.RESET}\n`);
   }
 
   const res = await fetch(url, {
     ...options,
     headers: {
       ...(options.headers || {}),
-      ...(accessToken ? { Authorization: `Bearer ${accessToken}` } : {})
+      ...(accessToken 
+        ? { Authorization: `Bearer ${accessToken}` } 
+        : apiKey 
+        ? { "X-Api-Key": apiKey } 
+        : {})
     }
   });
 
-  if (res.status !== 401) {
+  if (apiKey || res.status !== 401) {
     return res;
   }
 
@@ -191,4 +246,4 @@ async function fetchWithAuth(url, options = {}) {
   });
 }
 
-module.exports = { login, logout, loadTokens, checkAuth, fetchWithAuth };
+module.exports = { setApiKey,  getApiKey, removeApiKey, login, logout, loadTokens, checkAuth, fetchWithAuth };

package/src/cli.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 
 const { Command } = require("commander");
-const { login, logout, checkAuth } = require("./auth");
+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");
 
@@ -51,16 +52,39 @@ program
   .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);
+  .command("apikey")
+  .description("Manage API key authentication")
+  .option("--set <key>", "Authenticate using an API key")
+  .option("--remove", "Remove stored API key")
+  .action((options) => {
+    const user = getUserWithIndex(0);
+    if (!user) {
+      console.error(`${C.RED}No local user context found${C.RESET}`);
+      process.exit(1);
+    }
+
+    console.log(`${C.BOLD}Node42 Account${C.RESET} (${user.userMail})\n`);
+
+    if (options.set) {
+      setApiKey(user.id, options.set);
+
+      if (getApiKey(user.id) === options.set) {
+        console.log(`${C.GREEN}API key authentication configured${C.RESET}\n`);
+      } else {
+        console.log(`${C.RED}API key configuration failed${C.RESET}\n`);
+      }
+      return;
+    }
+
+    if (options.remove) {
+      const removed = removeApiKey(user.id);
+      console.log(removed ? `${C.RED}API key removed${C.RESET}\n` : `${C.RED}No API key configured${C.RESET}\n`);
+      return;
+    }
+
+    // default: show status
+    const apiKey = getApiKey(user.id);
+    console.log(apiKey ? `${C.RED}API key configured${C.RESET}\n` : `${C.RED}No API key configured${C.RESET}\n`);
   });
 
 program
@@ -78,9 +102,8 @@ program
     
     const user = getUserWithIndex(0);
     const currentMonth = new Date().toISOString().slice(0, 7);
-    console.log(`Node42 Account (CLI v${pkg.version})
+    console.log(`Node42 Account: ${C.BOLD}${user.id}${C.RESET}
     ${C.BOLD}User${C.RESET}
-      ID           : ${C.CYAN}${user.id}${C.RESET}
       Name         : ${user.userName}
       Email        : ${user.userMail}
       Role         : ${user.role}
@@ -113,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")
@@ -225,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/errors.js

@@ -15,10 +15,12 @@ function handleError(err) {
     : `${WWW_URL}/errors`;
   //console.log(url);
 
+  const link = `\u001B]8;;${url}\u0007View details\u001B]8;;\u0007`;
+
   if (message) {
-    console.error(`\r${C.RED}${err.message}${C.RESET}\nSee details: ${C.BOLD}${url}${C.RESET}\n`);
+    console.error(`\r${C.BOLD}Error: ${code}${C.RESET} ${C.BLUE}[${link}]${C.RESET}\n\n${C.RED}${err.message}${C.RESET}\n`);
   } else {
-    console.error(`\rSee details: ${C.BOLD}${url}${C.RESET}\n`);
+    console.error(`\r${C.BOLD}Error: ${code}${C.RESET} ${C.BLUE}[${url}]${C.RESET}\n\nFor details, see the documentation.\n`);
   }
 }
 

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);
 }