@n42/cli 0.1.89 → 0.1.96

package/README.md

@@ -85,9 +85,11 @@ n42 history <participantId>
 Example output:
 
 ```bash
+Found 2 artefact(s)
+
 DATE                PID             FILE
-2026-01-30 15:42:18 9915:helger     ~/.node42/artefacts/discovery/b91f83e2.svg
-2026-01-30 15:42:10 9915:helger     ~/.node42/artefacts/discovery/ba1cbc8d.svg
+2026-01-30 16:53:28 9930:de81347... 5e0800fc.svg [Open]
+2026-01-30 16:53:08 9930:de81347... 6eeb73d0.svg [Open]
 ```
 
 #### Available options:

package/docs/DB_USAGE.md

@@ -33,7 +33,6 @@ Example `db.json`:
 {
   "user": {},
   "artefacts": [],
-  "usage": {},
 }
 ```
 

package/jest.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  testEnvironment: "node",
+  verbose: true,
+  coverageDirectory: "coverage",
+  testMatch: ["**/test/**/*.test.js"]
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@n42/cli",
-  "version": "0.1.89",
+  "version": "0.1.96",
   "description": "Node42 CLI – Command-line interface for Peppol eDelivery path discovery, diagnostics, and tooling",
   "keywords": [
     "node42"

package/src/auth.js

@@ -3,16 +3,19 @@ const { NODE42_DIR, TOKENS_FILE, API_URL, EP_SIGNIN, EP_REFRESH, EP_ME } = requi
 const { handleError } = require("./errors");
 const { getUserWithIndex } = require("./user");
 const { clearScreen, ask, startSpinner } = require("./utils");
+
 const db = require("./db");
+const pkg = require("../package.json");
+const C = require("./colors");
 
 
 async function login() {
-  clearScreen("Sign in to Node42");
+  clearScreen(`Node42 CLI v${pkg.version}\n\n${C.BOLD}Sign in to your account${C.RESET}`);
   let user = getUserWithIndex(0);
 
   const username = await ask("Username", user.userMail ?? "");
   const password = await ask("Password", null, true);
-  //console.log(username + ", " + password);
+  console.log();
 
   let stopSpinner = startSpinner();
 
@@ -24,8 +27,7 @@ async function login() {
 
   if (!res.ok) {
     stopSpinner();
-    
-    console.error(`Login failed (${res.status}) – Invalid credentials`);
+    handleError({ code: "N42E-10108", message: "Signin failed: Invalid credentials"});
     process.exit(1);
   }
 
@@ -34,7 +36,7 @@ async function login() {
   
   const { accessToken, refreshToken, idToken } = tokens;
   if (!accessToken || !refreshToken || !idToken) {
-    console.error("Invalid auth response");
+    handleError({ code: "N42E-6123", message: "Token missing"})
     process.exit(1);
   }
 
@@ -50,14 +52,12 @@ async function login() {
   stopSpinner();
 
   if (!authenticated) {
-    console.error("Not authenticated");
+    handleError({ code: "N42E-10108", message: "Signin failed: Not authenticated"});
     process.exit(1);
   }
 
   user = getUserWithIndex(0);
-  console.log(
-    `Authenticated as ${user.userName} <${user.userMail}> (${user.role})`
-  );
+  console.log(`Authenticated as ${user.userName} <${C.BLUE}${user.userMail}${C.RESET}> ${C.DIM}(${user.role})${C.RESET}\n`);
 }
 
 function logout() {
@@ -69,7 +69,7 @@ function logout() {
 
 function loadTokens() {
   if (!fs.existsSync(TOKENS_FILE)) {
-    console.error("Tokens missing...\nRun: n42 login");
+    handleError({ code: "N42E-9033", message: "Token missing: You are not signed in"})
     process.exit(1);
   }
   return JSON.parse(fs.readFileSync(TOKENS_FILE, "utf8"));
@@ -77,7 +77,7 @@ function loadTokens() {
 
 async function checkAuth() {
   if (!fs.existsSync(TOKENS_FILE)) {
-    handleError({ code: "N42E-9033", message: "Token missing..."})
+    handleError({ code: "N42E-9033", message: "Token missing: You are not signed in"})
     return false;
   }
 

package/src/cli.js

@@ -4,7 +4,7 @@ const { Command } = require("commander");
 const { login, logout, checkAuth } = require("./auth");
 const { getUserWithIndex, getUserUsage } = require("./user");
 const { runDiscovery } = require("./discover");
-const { clearScreen, startSpinner, validateEnv, validateId, createAppDirs, getArtefactExt, cleanAppDirs } = require("./utils");
+const { clearScreen, startSpinner, validateEnv, validateId, createAppDirs, capitalize, cleanAppDirs } = require("./utils");
 const { NODE42_DIR, ARTEFACTS_DIR, DEFAULT_OUTPUT, DEFAULT_FORMAT } = require("./config");
 
 createAppDirs(); 
@@ -12,6 +12,7 @@ createAppDirs();
 const program = new Command();
 const pkg = require("../package.json");
 const db = require("./db");
+const C = require("./colors");
 
 const fs = require("fs");
 const path = require("path");
@@ -27,7 +28,7 @@ program
   .action((shell) => {
 
     if (shell !== "bash") {
-      console.error("Only bash supported");
+      console.error(`${C.RED}Only bash supported${C.RESET}`);
       return;
     }
 
@@ -35,9 +36,8 @@ program
     const dest = path.join(NODE42_DIR, "completion.bash");
     fs.copyFileSync(src, dest);
 
-    console.log(`Completion script saved to ${dest}`);
-    console.log(`Run this once:`);
-    console.log(`source ${dest}`);
+    console.log(`${C.DIM}Completion script saved to ${dest}${C.RESET}`);
+    console.log(`Run: ${C.BOLD}source ${dest}${C.RESET}\n`);
   });
 
 program
@@ -80,21 +80,21 @@ program
     const user = getUserWithIndex(0);
     const currentMonth = new Date().toISOString().slice(0, 7);
     console.log(`Node42 CLI v${pkg.version}
-    User
-      ID           : ${user.id}
+    ${C.BOLD}User${C.RESET}
+      ID           : ${C.CYAN}${user.id}${C.RESET}
       Name         : ${user.userName}
       Email        : ${user.userMail}
       Role         : ${user.role}
 
-    Rate Limits
-      Discovery    : ${user.rateLimits.discovery}
-      Transactions : ${user.rateLimits.transactions}
-      Validation   : ${user.rateLimits.validation}
+    ${C.BOLD}Rate Limits${C.RESET}
+      Discovery    : ${C.RED}${user.rateLimits.discovery}${C.RESET}
+      Transactions : ${C.RED}${user.rateLimits.transactions}${C.RESET}
+      Validation   : ${C.RED}${user.rateLimits.validation}${C.RESET}
   
-    Usage (Current Month)
-      Discovery    : ${user.serviceUsage.discovery[currentMonth] ?? 0}
-      Transactions : ${user.serviceUsage.transactions[currentMonth] ?? 0}
-      Validation   : ${user.serviceUsage.validation[currentMonth] ?? 0}
+    ${C.BOLD}Usage${C.RESET} ${C.DIM}(Current Month)${C.RESET}
+      Discovery    : ${C.RED}${user.serviceUsage.discovery[currentMonth] ?? 0}${C.RESET}
+      Transactions : ${C.RED}${user.serviceUsage.transactions[currentMonth] ?? 0}${C.RESET}
+      Validation   : ${C.RED}${user.serviceUsage.validation[currentMonth] ?? 0}${C.RESET}
     `);
   });
 
@@ -110,8 +110,9 @@ program
       usage = 0;
     }
 
-    clearScreen(`Node42 CLI v${pkg.version}`);
-    console.log(`Usage for ${service} (${currentMonth}): ${usage}`);
+    clearScreen(`Node42 CLI v${pkg.version}\n`);
+    console.log(`${C.BOLD}${capitalize(service)} usage${C.RESET}`);
+    console.log(` • ${currentMonth}: ${C.RED}${usage}${C.RESET}\n`);
   });
 
 program
@@ -163,24 +164,27 @@ program
 
     // ---- OUTPUT ----
     clearScreen(`Node42 CLI v${pkg.version}`);
-    console.log(`Found ${artefacts.length} artefact(s)${filterInfo}\n`);
+    console.log(`Found ${C.RED}${artefacts.length}${C.RESET} artefact(s)${filterInfo}\n`);
 
     const DATE = "DATE".padEnd(19);
     const PID = "PID".padEnd(15);
     const FILE = "FILE";
-    console.log(`${DATE} ${PID} ${FILE}`);
+    console.log(`${DATE} ${C.CYAN}${PID}${C.RESET} ${FILE}`);
 
     for (const item of artefacts) {
       const d = new Date(item.createdAt);
-      const dt = d.toISOString().slice(0, 19).replace("T", " ");
+      const iso = d.toISOString();           // 2026-01-30T16:53:28.123Z
+      const date = iso.slice(0, 10);         // 2026-01-30
+      const time = iso.slice(11, 19);        // 16:53:28
       const file = path.join(ARTEFACTS_DIR, `${item.file}`);
+      const link = `\u001B]8;;file://${file}\u0007Open\u001B]8;;\u0007`
 
       let pid = item.participantId;
       if (!participantId) {
         pid = pid.length > 15 ? pid.substring(0, 12) + "..." : pid
-        console.log(`${dt} ${pid.padEnd(15)} ${file}`);
+        console.log(`${date} ${C.DIM}${time}${C.RESET} ${C.CYAN}${pid.padEnd(15)}${C.RESET} ${item.file} ${C.BLUE}[${link}]${C.RESET}`);
       } else {
-        console.log(`${dt} ${file}`);
+        console.log(`${date} ${C.DIM}${time}${C.RESET} ${item.file} ${C.BLUE}[${link}]${C.RESET}`);
       }
     }
 

package/src/colors.js

@@ -0,0 +1,42 @@
+const RESET = "\x1b[0m";
+
+const BLACK   = "\x1b[30m";
+const RED     = "\x1b[31m";
+const GREEN   = "\x1b[32m";
+const YELLOW  = "\x1b[33m";
+const BLUE    = "\x1b[34m";
+const MAGENTA = "\x1b[35m";
+const CYAN    = "\x1b[36m";
+const WHITE   = "\x1b[37m";
+
+const BOLD = "\x1b[1m";
+const DIM  = "\x1b[2m";
+const UNDERLINE = "\x1b[4m";
+
+const RED_BOLD     = "\x1b[1;31m";
+const GREEN_BOLD   = "\x1b[1;32m";
+const YELLOW_BOLD  = "\x1b[1;33m";
+const BLUE_BOLD    = "\x1b[1;34m";
+const MAGENTA_BOLD = "\x1b[1;35m";
+const CYAN_BOLD    = "\x1b[1;36m";
+
+module.exports = {
+  RESET,
+  BLACK,
+  RED,
+  GREEN,
+  YELLOW,
+  BLUE,
+  MAGENTA,
+  CYAN,
+  WHITE,
+  BOLD,
+  DIM,
+  UNDERLINE,
+  RED_BOLD,
+  GREEN_BOLD,
+  YELLOW_BOLD,
+  BLUE_BOLD,
+  MAGENTA_BOLD,
+  CYAN_BOLD
+};

package/src/discover.js

@@ -2,6 +2,7 @@ const fs = require("fs");
 const path = require("path");
 const pkg = require("../package.json");
 const db = require("./db");
+const C = require("./colors");
 
 const { fetchWithAuth } = require("./auth");
 const { API_URL, EP_DISCOVER, DEFAULT_OUTPUT, DEFAULT_FORMAT, ARTEFACTS_DIR } = require("./config");
@@ -88,7 +89,7 @@ async function runDiscovery(participantId, options) {
     }
   };
 
-  clearScreen(`Node42 CLI v${pkg.version}`);
+  clearScreen(`Node42 CLI v${pkg.version}\n`);
   const stopSpinner = startSpinner();
 
   const url = `${API_URL}/${EP_DISCOVER}?output=${output}&format=${format}`;
@@ -153,9 +154,12 @@ async function runDiscovery(participantId, options) {
     const file = path.join(ARTEFACTS_DIR, `${fileName}`);
     fs.writeFileSync(file, svg);
 
-    console.log(`Discovery completed`);
-    console.log(`Usage    : ${serviceUsage} / ${rateLimit}`);
-    console.log(`Artefact : ${file}\n`);
+    const link = `\u001B]8;;file://${file}\u0007Open\u001B]8;;\u0007`;
+
+    console.log(`${C.BOLD}Discovery completed${C.RESET}`);
+    console.log(`PID      : ${C.CYAN}${participantId}${C.RESET}`);
+    console.log(`Artefact : ${fileName} ${C.BLUE}[${link}]${C.RESET}`);
+    console.log(`Usage    : ${C.RED}${serviceUsage}${C.RESET} ${C.DIM}(${rateLimit})${C.RESET}\n`);
     return;
   }
 
@@ -170,9 +174,12 @@ async function runDiscovery(participantId, options) {
     const file = path.join(ARTEFACTS_DIR, `${fileName}`);
     fs.writeFileSync(file, text);
 
-    console.log(`Discovery completed`);
-    console.log(`Usage    : ${serviceUsage} / ${rateLimit}`);
-    console.log(`Artefact : ${file}\n`);
+    const link = `\u001B]8;;file://${file}\u0007Open\u001B]8;;\u0007`;
+
+    console.log(`${C.BOLD}Discovery completed${C.RESET}`);
+    console.log(`PID      : ${C.CYAN}${participantId}${C.RESET}`);
+    console.log(`Artefact : ${fileName} ${C.BLUE}[${link}]${C.RESET}`);
+    console.log(`Usage    : ${C.RED}${serviceUsage}${C.RESET} ${C.DIM}(${rateLimit})${C.RESET}\n`);
     return;
   }
 
@@ -187,9 +194,12 @@ async function runDiscovery(participantId, options) {
   const file = path.join(ARTEFACTS_DIR, `${fileName}`);
   fs.writeFileSync(file, JSON.stringify(json, null, 2));
 
-  console.log(`Discovery completed`);
-  console.log(`Usage    : ${serviceUsage} / ${rateLimit}`);
-  console.log(`Artefact : ${file}\n`);
+  const link = `\u001B]8;;file://${file}\u0007Open\u001B]8;;\u0007`;
+
+  console.log(`${C.BOLD}Discovery completed${C.RESET}`);
+  console.log(`PID      : ${C.CYAN}${participantId}${C.RESET}`);
+  console.log(`Artefact : ${fileName} ${C.BLUE}[${link}]${C.RESET}`);
+  console.log(`Usage    : ${C.RED}${serviceUsage}${C.RESET} ${C.DIM}(${rateLimit})${C.RESET}\n`); 
 }
 
 module.exports = { runDiscovery };

package/src/errors.js

@@ -1,5 +1,5 @@
 const { WWW_URL } = require("./config");
-
+const C = require("./colors");
 
 function handleError(err) {
   //console.log(err);
@@ -16,9 +16,9 @@ function handleError(err) {
   //console.log(url);
 
   if (message) {
-    console.error(`\r${err.message}\nSee details: ${url}\n`);
+    console.error(`\r${C.RED}${err.message}${C.RESET}\nSee details: ${C.BOLD}${url}${C.RESET}\n`);
   } else {
-    console.error(`\rSee details: ${url}\n`);
+    console.error(`\rSee details: ${C.BOLD}${url}${C.RESET}\n`);
   }
 }
 

package/src/utils.js

@@ -2,7 +2,9 @@ const fs = require("fs");
 const inquirer = require("inquirer");
 const readline = require("readline");
 const config = require("./config");
+const pkg = require("../package.json");
 const db = require("./db");
+const C = require("./colors");
 
 
 function clearScreen(text) {
@@ -20,7 +22,7 @@ function ask(question, def, hidden=false) {
       terminal: true
     });
 
-    const q = def ? `${question} (${def}): ` : `${question}: `;
+    const q = def ? `${question} ${C.DIM}(${def})${C.RESET}: ` : `${question}: `;
 
     process.stdin.on("data", char => {
       char = char + "";
@@ -53,7 +55,8 @@ function startSpinner(text = "Working") {
   let i = 0;
 
   const timer = setInterval(() => {
-    process.stdout.write("\r[" + frames[i++ % frames.length] + "] " + text);
+    const frame = frames[i++ % frames.length];
+    process.stdout.write(`\r[${C.RED_BOLD}${frame}${C.RESET}] ${text}`);
   }, 120);
 
   return () => {
@@ -102,6 +105,10 @@ function getShortId(id) {
   return id.slice(0, 8);
 }
 
+function capitalize(s) {
+  return s.charAt(0).toUpperCase() + s.slice(1);
+}
+
 function createAppDirs(force=false) {
   fs.mkdirSync(config.NODE42_DIR, { recursive: true });
   fs.mkdirSync(config.ARTEFACTS_DIR, { recursive: true });
@@ -129,14 +136,23 @@ function cleanAppDirs(options) {
     all
   } = options;
 
+  if (Object.keys(options).length === 0) {
+    console.log(`${C.RED}Nothing to clean${C.RESET}`);
+    return;
+  }
+
+  clearScreen(`Node42 CLI v${pkg.version}\n`);
+
+  const removed = [];
+
   if ((all || tokens) && fs.existsSync(config.TOKENS_FILE)) {
     fs.unlinkSync(config.TOKENS_FILE);
-    console.log("Tokens removed");
+    removed.push("tokens");
   }
 
   if ((all || dbFlag) && fs.existsSync(config.DATABASE_FILE)) {
     fs.unlinkSync(config.DATABASE_FILE);
-    console.log("Database removed");
+    removed.push("database");
   }
 
   if (all || artefacts) {
@@ -148,8 +164,7 @@ function cleanAppDirs(options) {
       fs.rmSync(config.ARTEFACTS_DIR, { recursive: true, force: true });
       fs.mkdirSync(config.ARTEFACTS_DIR, { recursive: true });
     }
-
-    console.log("Artefacts removed");
+    removed.push("artefacts");
   }
 
   if (all || transactions) {
@@ -161,8 +176,7 @@ function cleanAppDirs(options) {
       fs.rmSync(config.TRANSACTIONS_DIR, { recursive: true, force: true });
       fs.mkdirSync(config.TRANSACTIONS_DIR, { recursive: true });
     }
-
-    console.log("Transactions removed");
+    removed.push("transactions");
   }
 
   if (all || validations) {
@@ -174,10 +188,19 @@ function cleanAppDirs(options) {
       fs.rmSync(config.VALIDATIONS_DIR, { recursive: true, force: true });
       fs.mkdirSync(config.VALIDATIONS_DIR, { recursive: true });
     }
+    removed.push("validations");
+  }
+
+  if (removed.length === 0) {
+    console.log(`${C.RED}Nothing removed${C.RESET}`);
+  } else {
+    console.log(`${C.BOLD}Removed ${removed.length} item(s)${C.RESET}`);
+    for (const r of removed) {
+      console.log(` ${C.RED}• ${r}${C.RESET}`);
+    }
 
-    console.log("Transactions removed");
+    console.log();
   }
- 
 }
 
 function buildDocLabel({ scheme, value }) {
@@ -229,4 +252,4 @@ function getArtefactExt(output, format) {
   }
 }
 
-module.exports = { clearScreen, startSpinner, ask, buildDocLabel, promptForDocument, validateEnv, validateId, getShortId, createAppDirs, cleanAppDirs, getArtefactExt };
+module.exports = { clearScreen, startSpinner, ask, buildDocLabel, promptForDocument, validateEnv, validateId, getShortId, capitalize, createAppDirs, cleanAppDirs, getArtefactExt };

package/test/auth.test.js

@@ -95,7 +95,7 @@ describe("auth", () => {
           // expected
       }
 
-      expect(console.error.calledWithMatch("Login failed")).to.be.true;
+      expect(console.error.calledWithMatch("Signin failed")).to.be.true;
       expect(process.exit.calledWith(1)).to.be.true;
       expect(fs.writeFileSync.called).to.be.false;
     });