@n42/cli 0.1.88 → 0.1.91

package/README.md

@@ -11,13 +11,14 @@ routing, SMP resolution, and Access Point behavior.
 
 ## Features
 
--   Peppol eDelivery path discovery
--   SMP and Access Point resolution diagnostics
--   Supported document type detection
--   PlantUML and SVG visualizations
--   Authenticated API access
--   Deterministic, script-friendly output
--   No browser automation or UI side effects
+- Peppol eDelivery path discovery
+- SMP and Access Point resolution diagnostics
+- Supported document type detection
+- PlantUML and SVG visualizations
+- Authenticated API access
+- Deterministic, script-friendly output
+- No browser automation or UI side effects
+- Local artefact history inspection
 
 ## Installation
 
@@ -43,7 +44,7 @@ n42 --version
 ## Authentication
 
 Authenticate once using your Node42 account credentials.\
-Tokens are stored locally under `~/.node42/`.
+Tokens are stored locally under `~/.node42/tokens.json`.
 
 ``` bash
 n42 login
@@ -65,6 +66,35 @@ n42 me
 n42 discover peppol <participantId>
 ```
 
+#### Available options:
+- **-e**, **--env** `<environment>`  Environment (TEST | PROD)
+- **-o**, **--output** `<type>`      Result type (json | plantuml)
+- **-f**, **--format** `<format>`    When output=plantuml (svg | text)
+- **--force-https**            Force HTTPS endpoints
+- **--insecure**               Disable TLS certificate validation
+- **--fetch-business-card**    Fetch Peppol business card
+- **--reverse-lookup**         Enable reverse lookup
+- **--probe-endpoints**        Probe resolved endpoints
+
+### History
+
+``` bash
+n42 history <participantId>
+```
+
+Example output:
+
+```bash
+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
+```
+
+#### Available options:
+- **--today**               Show only today's artefacts
+- **--day** `<yyyy-mm-dd>`  Show artefacts for a specific day
+- **--last** `<n>`          Show only last N results
+
 ------------------------------------------------------------------------
 
 ## Artefacts

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.88",
+  "version": "0.1.91",
   "description": "Node42 CLI – Command-line interface for Peppol eDelivery path discovery, diagnostics, and tooling",
   "keywords": [
     "node42"

package/src/auth.js

@@ -3,7 +3,9 @@ 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 C = require("./colors");
 
 
 async function login() {
@@ -25,7 +27,7 @@ async function login() {
   if (!res.ok) {
     stopSpinner();
     
-    console.error(`Login failed (${res.status}) – Invalid credentials`);
+    console.error(`[${res.status}] ${C.RED}Login failed${C.RESET} - 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");
+    console.error(`${C.RED}Invalid auth response`);
     process.exit(1);
   }
 
@@ -50,14 +52,12 @@ async function login() {
   stopSpinner();
 
   if (!authenticated) {
-    console.error("Not authenticated");
+    console.error(`${C.RED}Not authenticated${C.RESET}`);
     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,8 @@ function logout() {
 
 function loadTokens() {
   if (!fs.existsSync(TOKENS_FILE)) {
-    console.error("Tokens missing...\nRun: n42 login");
+    console.error(`Tokens missing...`);
+    console.log(`Run: ${C.BLUE}n42 login${C.RESET}\n`);
     process.exit(1);
   }
   return JSON.parse(fs.readFileSync(TOKENS_FILE, "utf8"));

package/src/cli.js

@@ -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,9 @@ program
     const dest = path.join(NODE42_DIR, "completion.bash");
     fs.copyFileSync(src, dest);
 
-    console.log(`Completion script saved to ${dest}`);
+    console.log(`${C.DIM}Completion script saved to ${dest}${C.RESET}\n`);
     console.log(`Run this once:`);
-    console.log(`source ${dest}`);
+    console.log(`${C.BLUE}source ${dest}${C.RESET}\n`);
   });
 
 program
@@ -80,21 +81,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 +111,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(`Usage ${C.BOLD}${service}${C.RESET}`);
+    console.log(`${C.DIM}${currentMonth}:${C.RESET} ${C.RED}${usage}${C.RESET}\n`);
   });
 
 program
@@ -156,30 +158,34 @@ program
 
     if (!artefacts.length) {
       clearScreen(`Node42 CLI v${pkg.version}`);
-      console.log(`No artefacts found. (${dayFilter})`);
+      const filter = dayFilter !== null ? ` (${dayFilter})` : ``;
+      console.log(`No artefacts found.${filter}`);
       return;
     }
 
     // ---- 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/utils.js

@@ -3,6 +3,7 @@ const inquirer = require("inquirer");
 const readline = require("readline");
 const config = require("./config");
 const db = require("./db");
+const C = require("./colors");
 
 
 function clearScreen(text) {
@@ -20,7 +21,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 + "";