@n42/cli 0.1.40 → 0.1.63

package/README.md

@@ -46,7 +46,7 @@ Authenticate once using your Node42 account credentials.\
 Tokens are stored locally under `~/.node42/`.
 
 ``` bash
-n42 signin
+n42 login
 ```
 
 Check authentication status:
@@ -62,7 +62,7 @@ n42 me
 ### Basic discovery
 
 ``` bash
-n42 discover peppol <environment> <participantId>
+n42 discover peppol <participantId>
 ```
 
 ------------------------------------------------------------------------

package/docs/DB_USAGE.md

@@ -0,0 +1,223 @@
+# Node42 Local JSON DB – Usage Guide
+
+This is a lightweight local document store used by the Node42 CLI.  
+It is **not a database server** — it is a structured JSON file with helper functions.
+
+Location (Linux/macOS):
+```
+~/.node42/db.json
+```
+
+---
+
+## Purpose
+
+Designed for:
+
+- Artefact history
+- Participant lookups
+- File references
+- UUID tracking
+- Small usage statistics
+- Local cache
+
+Intended scale: **1 – 10,000 records**.
+
+---
+
+## Data Structure
+
+Example `db.json`:
+
+```json
+{
+  "user": {},
+  "artefacts": [],
+  "usage": {},
+}
+```
+
+Collections are flexible and can hold any object structure.
+
+---
+
+## Core Functions
+
+```js
+const db = require("./db");
+```
+
+### load()
+
+Reads the JSON file into memory.
+
+```js
+const db = db.load();
+```
+
+If the file does not exist, returns a default structure.
+
+---
+
+### save(database)
+
+Writes the in-memory object back to disk.
+
+```js
+db.save(database);
+```
+
+Always called after insert/update/delete.
+
+---
+
+### get(collection)
+
+Returns a collection array or an empty array.
+
+```js
+const artefacts = db.get("artefacts");
+```
+
+Safe — never throws if missing.
+
+---
+
+### insert(collection, item)
+
+Adds an item and persists.
+
+```js
+db.insert("artefacts", {
+  id: "uuid",
+  participantId: "0007:123",
+  createdAt: Date.now()
+});
+```
+
+---
+
+### find(collection, predicate)
+
+Filters a collection.
+
+```js
+const results = db.find("artefacts", x => x.participantId === pid);
+```
+
+Works well for thousands of entries.
+
+---
+
+## Indexing (Fast Lookup)
+
+### indexBy(list, key)
+
+Builds an in-memory index for repeated queries.
+
+```js
+const artefacts = db.get("artefacts");
+const byPid = db.indexBy(artefacts, "participantId");
+
+const results = byPid["0007:123"] ?? [];
+```
+
+Use when:
+- Many lookups
+- Same key repeatedly
+- Performance matters
+
+---
+
+## Optional Advanced Helpers
+
+### indexByFn(list, fn)
+
+Derived or computed keys.
+
+```js
+const byDay = db.indexByFn(list, x => x.createdAt.slice(0, 10));
+```
+
+Now **byDay** looks like:
+```json
+{
+  "2026-01-29": [ {...}, {...} ],
+  "2026-01-30": [ {...} ]
+}
+```
+
+Retrieve all items for a day
+```js
+const items = byDay["2026-01-29"] ?? [];
+```
+---
+
+### indexByMap(list, key)
+
+Same as `indexBy` but uses `Map` instead of plain object.
+Useful if keys are numbers or objects instead of strings.
+
+---
+
+## Typical CLI Workflow
+
+### Insert Record
+```js
+db.insert("artefacts", obj);
+```
+
+### Simple Search
+```js
+db.find("artefacts", x => x.id === uuid);
+```
+
+### Repeated Search
+```js
+const list = db.get("artefacts");
+const idx = db.indexBy(list, "participantId");
+```
+
+---
+
+## Performance Expectations
+
+| Records | Performance |
+|--------|------------|
+| 1k     | Instant |
+| 5k     | Instant |
+| 10k    | Fine |
+| 50k    | Noticeable |
+| 100k+  | Consider SQLite |
+
+---
+
+## File Safety
+
+Recommended permissions:
+
+```
+chmod 600 ~/.node42/db.json
+```
+
+
+## When to Upgrade to SQLite
+
+- 100k+ records
+- Complex joins
+- Multi-field queries
+- Concurrent writes
+
+---
+
+## Summary
+
+This system is:
+
+- Portable
+- Dependency-free
+- Easy to debug
+- Perfect for CLI tools
+- Sufficient for long-term local storage
+
+It behaves like a **tiny embedded document database**, not a server DB.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@n42/cli",
-  "version": "0.1.40",
+  "version": "0.1.63",
   "description": "Node42 CLI – Command-line interface for Peppol eDelivery path discovery, diagnostics, and tooling",
   "keywords": [
     "node42"
@@ -20,15 +20,19 @@
     "lint": "eslint src",
     "test": "mocha"
   },
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
     "commander": "^11.1.0",
     "inquirer": "^8.2.7",
     "open": "^11.0.0"
   },
   "devDependencies": {
-    "chai": "^6.2.2",
+    "chai": "^4.5.0",
     "eslint": "^9.39.2",
     "globals": "^17.2.0",
-    "mocha": "^11.7.5"
+    "mocha": "^11.3.0",
+    "sinon": "^21.0.1"
   }
 }

package/src/auth.js

@@ -1,12 +1,76 @@
 const fs = require("fs");
-const { NODE42_DIR, TOKENS_FILE, API_URL, EP_REFRESH } = require("./config");
+const { NODE42_DIR, TOKENS_FILE, API_URL, EP_SIGNIN, EP_REFRESH } = require("./config");
 const { handleError } = require("./errors");
-const { updateUserInfo, updateUserUsage } = require("./user");
+const { getUser } = require("./user");
+const { clearScreen, ask, startSpinner } = require("./utils");
+const db = require("./db");
 
 
+async function login() {
+  clearScreen("Sign in to Node42");
+  let user = getUser();
+
+  const username = await ask("Username", user.userMail ?? "");
+  const password = await ask("Password", null, true);
+
+  console.log(username + ", " + password);
+
+  let stopSpinner = startSpinner();
+
+  const res = await fetch(`${API_URL}/${EP_SIGNIN}`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ username, password })
+  });
+
+  if (!res.ok) {
+    stopSpinner();
+
+    console.error(`Login failed (${res.status}) – Invalid credentials`);
+    process.exit(1);
+  }
+
+  const tokens = await res.json();
+
+  const { accessToken, refreshToken, idToken } = tokens;
+  if (!accessToken || !refreshToken || !idToken) {
+    stopSpinner();
+
+    console.error("Invalid auth response");
+    process.exit(1);
+  }
+
+  fs.mkdirSync(NODE42_DIR, { recursive: true });
+  fs.writeFileSync(
+    TOKENS_FILE,
+    JSON.stringify({ accessToken, refreshToken, idToken }, null, 2)
+  );
+
+  stopSpinner();
+  stopSpinner = startSpinner();
+
+  await checkAuth();
+  user = getUser();
+  
+  console.log(
+    `Authenticated as ${user.userName} <${user.userMail}> (${user.role})`
+  );
+  
+  stopSpinner();
+}
+
+function logout() {
+  if (fs.existsSync(TOKENS_FILE)) {
+    fs.unlinkSync(TOKENS_FILE);
+  }
+
+  let user = getUser();
+  db.delete("user", user.id);
+}
+
 function loadAuth() {
   if (!fs.existsSync(TOKENS_FILE)) {
-    console.error("Not logged in. Run: n42 signin");
+    console.error("Not logged in. Run: n42 login");
     process.exit(1);
   }
   return JSON.parse(fs.readFileSync(TOKENS_FILE, "utf8"));
@@ -36,14 +100,20 @@ async function checkAuth() {
   }
 
   const auth = await res.json();
+  //console.log(auth);
   if (auth) {  
-    updateUserInfo({
+
+    db.upsert("user", {
+      id: auth.sub,
       userName: auth.userName,
       userMail: auth.userMail,
       role: auth.role,
-    });
+      rateLimits: auth.rateLimits,
+      serviceUsage: auth.serviceUsage,
+    })
 
-    updateUserUsage({ serviceUsage: auth.serviceUsage });
+    db.replace("serviceUsage", auth.serviceUsage);
+    db.replace("rateLimits", auth.rateLimits);
     return true;
   }
 
@@ -125,4 +195,4 @@ async function fetchWithAuth(url, options = {}) {
   });
 }
 
-module.exports = { loadAuth, checkAuth, fetchWithAuth };
+module.exports = { login, logout, loadAuth, checkAuth, fetchWithAuth };

package/src/browser.js

@@ -1,6 +1,7 @@
 const open = require("open").default;
 let browserOpened = false;
 
+
 async function openOnce(target) {
   if (browserOpened) return;
   browserOpened = true;

package/src/cli.js

@@ -1,13 +1,20 @@
 #!/usr/bin/env node
+
 const { Command } = require("commander");
-const { signin } = require("./signin");
-const { checkAuth } = require("./auth");
-const { getUserInfo } = require("./user");
+const { login, logout, checkAuth } = require("./auth");
+const { getUser, getUserUsage } = require("./user");
 const { runDiscovery } = require("./discover");
-const { clearScreen, startSpinner, validateEnv, validateId} = require("./utils");
+const { clearScreen, startSpinner, validateEnv, validateId, createAppDirs, getArtefactExt } = require("./utils");
+const { NODE42_DIR, ARTEFACTS_DIR, DEFAULT_OUTPUT, DEFAULT_FORMAT } = require("./config");
+
+createAppDirs(); 
 
 const program = new Command();
 const pkg = require("../package.json");
+const db = require("./db");
+
+const fs = require("fs");
+const path = require("path");
 
 program
   .name("n42")
@@ -15,23 +22,91 @@ program
   .version(pkg.version);
 
 program
-  .command("signin")
+  .command("completion <shell>")
+  .description("Install shell completion")
+  .action((shell) => {
+
+    if (shell !== "bash") {
+      console.error("Only bash supported");
+      return;
+    }
+
+    const src = path.join(__dirname, "completion/bash.sh");
+    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}`);
+  });
+
+program
+  .command("login")
   .description("Authenticate using username and password and store tokens locally")
-  .action(signin);
+  .action(login);
+
+program
+  .command("logout")
+  .description("Terminate user session and delete all local tokens")
+  .action(logout);
 
 program
   .command("me")
-  .description("returns identity and billing status for the authenticated user.")
-  .action(() => {
+  .description("Returns identity and billing status for the authenticated user.")
+  .action(async () => {
     const stopSpinner = startSpinner();
     
-    checkAuth(); 
-    const user = getUserInfo();
-    console.log(
-      `Authenticated as ${user.userName} <${user.userMail}> (${user.role})`
-    );
-
+    await checkAuth(); 
+    const user = getUser();
     stopSpinner();
+    
+    const currentMonth = new Date().toISOString().slice(0, 7);
+    console.log(`Node42 CLI v${pkg.version}
+    User
+      ID           : ${user.id}
+      Name         : ${user.userName}
+      Email        : ${user.userMail}
+      Role         : ${user.role}
+
+    Rate Limits
+      Discovery    : ${user.rateLimits.discovery}
+      Transactions : ${user.rateLimits.transactions}
+      Validation  : ${user.rateLimits.validation}
+  
+    Usage (Current Month)
+      Discovery    : ${user.serviceUsage.discovery[currentMonth] ?? 0}
+      Transactions : ${user.serviceUsage.transactions[currentMonth] ?? 0}
+      Validation   : ${user.serviceUsage.validation[currentMonth] ?? 0}
+    `);
+  });
+
+program
+  .command("usage <service>")
+  .description("Returns usage for the authenticated user.")
+  .action((service) => {
+    const userUsage = getUserUsage();
+    const currentMonth = new Date().toISOString().slice(0, 7);
+
+    const usage =
+      userUsage?.serviceUsage?.[service]?.[currentMonth] ?? 0;
+
+    clearScreen(`Node42 CLI v${pkg.version}`);
+    console.log(`Usage for ${service} (${currentMonth}): ${usage}`);
+  });
+
+program
+  .command("history <participantId>")
+  .description("Show local discovery history for a participant")
+  .action((participantId) => {
+    const artefacts = db.artefactsByParticipant(participantId);
+
+    for (const item of artefacts) {
+      const d = new Date(item.createdAt);
+      const dt = d.toISOString().slice(0,19).replace("T"," ");
+      const ext = getArtefactExt(item.output, item.format);
+      const file = path.join(ARTEFACTS_DIR, `${item.id}.${ext}`);
+      console.log(`${dt}: ${file}`);
+    }
   });
 
 const discover = program
@@ -39,20 +114,20 @@ const discover = program
   .description("Discovery and diagnostic tooling for eDelivery paths");
 
 discover
-  .command("peppol <environment> <participantId>")
+  .command("peppol <participantId>")
   .description("Resolve the Peppol eDelivery message path")
-  .option("--output <type>", "Result type (json | plantuml)", "json")
-  .option("--format <format>", "When output=plantuml (svg | text)", "svg")
+  .option("-e, --env <environment>", "Environment", "TEST")
+  .option("-o, --output <type>", "Result type (json | plantuml)", DEFAULT_OUTPUT)
+  .option("-f, --format <format>", "When output=plantuml (svg | text)", DEFAULT_FORMAT)
   .option("--force-https", "Force HTTPS endpoints", true)
   .option("--insecure", "Disable TLS certificate validation", false)
   .option("--fetch-business-card", "Fetch Peppol business card", false)
   .option("--reverse-lookup", "Enable reverse lookup", false)
   .option("--probe-endpoints", "Probe resolved endpoints", false)
-  .action((environment, participantId, options) => {
-
+  .action((participantId, options) => {
     clearScreen(`Node42 CLI v${pkg.version}`);
     
-    try { validateEnv(environment); }
+    try { validateEnv(options.env); }
     catch (e) { 
       console.error(e.message);
       process.exit(1);
@@ -64,7 +139,7 @@ discover
       process.exit(1);
     }
 
-    runDiscovery(environment.toUpperCase(), participantId, options);
+    runDiscovery(participantId, options);
   });
 
 program.parse(process.argv);

package/src/completion/bash.sh

@@ -0,0 +1,19 @@
+_n42_completions()
+{
+  local cur prev words cword
+  _init_completion || return
+
+  local commands="login logout me usage history discover"
+
+  if [[ $cword -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "$commands" -- "$cur") )
+    return
+  fi
+
+  if [[ ${words[1]} == "discover" && $cword -eq 2 ]]; then
+    COMPREPLY=( $(compgen -W "peppol" -- "$cur") )
+    return
+  fi
+}
+
+complete -F _n42_completions n42

package/src/config.js

@@ -1,4 +1,3 @@
-const fs = require("fs");
 const path = require("path");
 const os = require("os");
 
@@ -6,6 +5,7 @@ const config = {
   APP_NAME: "n42",
   API_URL: "https://api.node42.dev",
   WWW_URL: "https://www.node42.dev",
+
   API_TIMEOUT_MS: 30000,
 
   NODE42_DIR: path.join(os.homedir(), ".node42"),
@@ -14,12 +14,11 @@ const config = {
   TRANSACTIONS_DIR: null,
   VALIDATION_DIR: null,
   
-  USAGE_FILE: null,
-  USER_FILE: null,
+  DATABASE_FILE: null,
   TOKENS_FILE: null,
   CONFIG_FILE: null,
 
-  DEFAULT_OUTPUT: "json",
+  DEFAULT_OUTPUT: "plantuml",
   DEFAULT_FORMAT: "svg",
 
   EP_SIGNIN: "auth/signin",
@@ -31,24 +30,8 @@ config.ARTEFACTS_DIR = path.join(config.NODE42_DIR, "artefacts", "discovery");
 config.TRANSACTIONS_DIR = path.join(config.NODE42_DIR, "artefacts", "transactions");
 config.VALIDATION_DIR = path.join(config.NODE42_DIR, "artefacts", "validation");
 
-config.USER_FILE = path.join(config.NODE42_DIR, "user.json");
-config.USAGE_FILE = path.join(config.NODE42_DIR, "usage.json");
+config.DATABASE_FILE = path.join(config.NODE42_DIR, "db.json");
 config.TOKENS_FILE = path.join(config.NODE42_DIR, "tokens.json");
 config.CONFIG_FILE = path.join(config.NODE42_DIR, "config.json");
 
-function createAppDirs() {
-  fs.mkdirSync(config.NODE42_DIR, { recursive: true });
-
-  fs.mkdirSync(config.ARTEFACTS_DIR, { recursive: true });
-  fs.mkdirSync(config.TRANSACTIONS_DIR, { recursive: true });
-  fs.mkdirSync(config.VALIDATION_DIR, { recursive: true });
-
-  fs.writeFileSync(
-    config.CONFIG_FILE,
-    JSON.stringify(config, null, 2)
-  );
-}
-
-createAppDirs();
-
-module.exports = config;
+module.exports = config;