@n42/cli 0.2.31 → 0.2.42

package/README.md

@@ -1,4 +1,4 @@
-# Node42 CLI (n42)
+# Node42 CLI
 
 Command-line interface for **eDelivery discovery, diagnostics, and
 validation**, with support for the Peppol network.
@@ -7,7 +7,11 @@ 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.
 
-------------------------------------------------------------------------
+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 +132,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 +149,9 @@ Errors are printed with a clickable reference link:
 
 ## License
 
-MIT License
+MIT License
+
+## Author
+
+Alex Olsson \
+Node42

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@n42/cli",
-  "version": "0.2.31",
+  "version": "0.2.42",
   "description": "Node42 CLI – Command-line interface for Peppol eDelivery path discovery, diagnostics, and tooling",
   "keywords": [
-    "node42"
+    "node42", "peppol", "edelivery", "diagnostics",
+    "cli", "api"
   ],
   "homepage": "https://github.com/node42-dev/node42-cli",
   "repository": {

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,7 +1,7 @@
 #!/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 { startSpinner, validateEnv, validateId, createAppDirs, capitalize, cleanAppDirs } = require("./utils");
@@ -40,6 +40,42 @@ program
     console.log(`Run: ${C.BOLD}source ${dest}${C.RESET}\n`);
   });
 
+program
+  .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
   .command("login")
   .description("Authenticate using username and password and store tokens locally")
@@ -78,9 +114,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}

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