@mostajs/appconfig

Auteur : Dr Hamid MADANI [email protected] Licence : AGPL-3.0-or-later

Interface d'administration de la configuration .env des modules @mostajs/* (chatbot, sourcing, chat, base de données…). Autosuffisant (sans @mostajs/socle), compose @mostajs/config.

Principe

1. Chaque module contribue une spec déclarative de ses réglages (clé env, libellé, type, défaut, choix, aide, secret).
2. resolveSettings() lit les valeurs courantes via getEnv (cascade MOSTA_ENV). Les secrets ne renvoient que présent/absent — jamais la valeur.
3. L'UI (./client, socle-free) édite les réglages non sensibles ; une server action applique.
4. applyChanges(io, changes, {restart}) valide puis réécrit le .env (préserve commentaires/ordre) et redémarre — l'I/O (readEnv/writeEnv/restart) est injectée par l'app (DI : le chemin et pm2 restent hors module).

Usage (app)

import { registerBuiltinSettings, resolveSettings, applyChanges } from "@mostajs/appconfig";
import { AppConfigForm } from "@mostajs/appconfig/client";

registerBuiltinSettings();                  // ou registerSettings([...vos specs])
const groups = resolveSettings();           // pour l'UI

// server action
async function saveConfigAction(fd: FormData) {
  "use server";
  const changes = [...]; // extraits du FormData pour les clés non-secrètes
  await applyChanges(io, changes, { restart: fd.get("__restart") === "1" });
}

// <AppConfigForm groups={groups} action={saveConfigAction} note="L'enregistrement peut redémarrer l'app." />

io (DI) :

const io = {
  readEnv: () => fs.promises.readFile(ENV_PATH, "utf8"),
  writeEnv: (t) => writeAtomic(ENV_PATH, t),     // tmp + rename
  restart: () => exec("pm2 restart crm"),
};

Sécurité

• Permission app.config (côté app) sur la page et l'action.
• Secrets (secret:true) : jamais lus/écrits/renvoyés au client. Édition via le .env serveur (SSH).
• Validation avant écriture ; valeurs échappées ; seules les clés des specs enregistrées sont éditables.

Voir docs/ (livrables #1-#3) et CHANGELOG.md.