@mostajs/appconfig 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog — @mostajs/appconfig
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com>
+
+## 0.1.0 — 2026-06-08 — intégration CRM + déployé
+- **Intégré au CRM TRADING et déployé** (`crm.amia.fr`) : page `/admin/config` (gardée `app.config`), `lib/appconfig.ts` (`registerBuiltinSettings` + `AppConfigIO` réel : lecture/écriture atomique du `.env` du process + redémarrage **détaché/différé** `pm2 restart crm --update-env` re-sourçant `.env`), server action `saveConfigAction` (n'écrit que les clés **non secrètes réellement modifiées**, option redémarrage). Carte `/admin` + entrée Sidebar « Paramètres ».
+- Vérifié en prod : rendu OK, secrets en présent/absent **sans fuite de valeur**, `.env` = `/home/hmd/prod/crm/.env` (pm2 cwd correct), pm2 dans le PATH.
+- ⚠ Le `.env` runtime est réécrit par `deploy/env.prod` à chaque déploiement : les éditions UI vivent jusqu'au prochain déploiement (reporter les changements durables dans `deploy/env.prod`).
+
+## 0.0.1 — 2026-06-08
+- Scaffold (DEVRULES §5) après livrables #1-#3 (`docs/`). Interface d'administration de la configuration `.env` des modules `@mostajs/*`. **Autosuffisant** (sans `@mostajs/socle`), compose `@mostajs/config`.
+- **Spec déclarative** de réglage (`SettingSpec` : key/label/category/type/default/choices/help/secret) + **registre** (style dialecte/provider : `registerSettings`/`collectSettings`).
+- **Packs built-in** : `CHATBOT_SETTINGS`, `SOURCING_SETTINGS`, `CHAT_SETTINGS`, `DB_SETTINGS`, `STORAGE_SETTINGS` (+ `registerBuiltinSettings()`).
+- **Résolution** `resolveSettings()` via `getEnv` (cascade `MOSTA_ENV`), groupée par catégorie ; **secrets → présent/absent**, jamais la valeur.
+- **Validation** `validateChange` (type/choices/secret/retour-ligne). **Réécriture `.env`** `upsertEnv` (préserve commentaires/ordre, upsert+append, échappement) + `diffEnv` (aperçu).
+- **Application** `applyChanges(io, changes, {restart})` : tout-ou-rien, ordre read→write→restart, refus secret/clé inconnue. **I/O `.env` + redémarrage injectés (DI)** via `AppConfigIO` (chemin & pm2 hors module).
+- **UI socle-free** `./client` : `<AppConfigForm>` (groupes, secrets en présent/absent, action injectée).
+- **Test** `test-scripts/test-appconfig.mjs` (zéro fs/réseau) : **27/27**. Build `tsc` vert.
+- Reste : **0.1.0** intégration CRM (`/admin/config` + I/O réel `.env` prod + `pm2 restart`, garde `app.config`) ; 0.2 diff visuel/audit ; 0.3 feature flags (option).

package/README.md

@@ -0,0 +1,49 @@
+# @mostajs/appconfig
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com>
+**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)
+
+```ts
+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) :
+```ts
+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`.

package/dist/apply.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @mostajs/appconfig — application d'un lot de changements : validation → réécriture `.env` (via I/O
+ * injectée) → redémarrage optionnel. Refuse d'écrire si une valeur est invalide ou cible un secret.
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import type { AppConfigIO, ApplyReport, EnvChange } from "./types.js";
+/**
+ * Valide puis applique les changements. `restart` n'est appelé que si fourni et succès.
+ * Tout-ou-rien : en cas d'erreur de validation, **rien** n'est écrit.
+ */
+export declare function applyChanges(io: AppConfigIO, changes: EnvChange[], opts?: {
+    restart?: boolean;
+    allowSecrets?: boolean;
+}): Promise<ApplyReport>;
+//# sourceMappingURL=apply.d.ts.map

package/dist/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AAKvF;;;GAGG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvD,OAAO,CAAC,WAAW,CAAC,CAkBtB"}

package/dist/apply.js

@@ -0,0 +1,32 @@
+import { getSpec } from "./registry.js";
+import { validateChange } from "./validate.js";
+import { upsertEnv } from "./envfile.js";
+/**
+ * Valide puis applique les changements. `restart` n'est appelé que si fourni et succès.
+ * Tout-ou-rien : en cas d'erreur de validation, **rien** n'est écrit.
+ */
+export async function applyChanges(io, changes, opts = {}) {
+    const errors = [];
+    for (const c of changes) {
+        const spec = getSpec(c.key);
+        if (!spec) {
+            errors.push({ key: c.key, message: "Réglage inconnu (non enregistré)." });
+            continue;
+        }
+        const err = validateChange(spec, c.value, { allowSecrets: opts.allowSecrets });
+        if (err)
+            errors.push(err);
+    }
+    if (errors.length)
+        return { ok: false, applied: [], errors, restarted: false };
+    const current = await io.readEnv();
+    const next = upsertEnv(current, changes);
+    await io.writeEnv(next);
+    let restarted = false;
+    if (opts.restart && io.restart) {
+        await io.restart();
+        restarted = true;
+    }
+    return { ok: true, applied: changes, errors: [], restarted };
+}
+//# sourceMappingURL=apply.js.map

package/dist/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAe,EACf,OAAoB,EACpB,OAAsD,EAAE;IAExD,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACnG,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC/E,IAAI,GAAG;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAE/E,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAExB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;QAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;QAAC,SAAS,GAAG,IAAI,CAAC;IAAC,CAAC;IAEzE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;AAC/D,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,19 @@
+import * as React from "react";
+import type { ResolvedGroup } from "./types.js";
+export interface AppConfigFormProps {
+    groups: ResolvedGroup[];
+    /** Server action : reçoit le FormData (clés = noms de variables). Applique + (option) redémarre. */
+    action: (formData: FormData) => void | Promise<void>;
+    /** Message d'avertissement (ex. « l'enregistrement redémarre l'application »). */
+    note?: string;
+    /** Classe racine (le style est fourni par l'app — aucun CSS embarqué). */
+    className?: string;
+    /**
+     * Autorise l'édition (ÉCRITURE SEULE) des secrets : champ mot de passe, jamais pré-rempli ;
+     * laisser vide = conserver la valeur existante. Défaut `false` (secrets en présent/absent).
+     */
+    allowSecretEdit?: boolean;
+}
+export declare function AppConfigForm({ groups, action, note, className, allowSecretEdit }: AppConfigFormProps): React.JSX.Element;
+export default AppConfigForm;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,oGAAoG;IACpG,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAkDD,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE,kBAAkB,qBAgBrG;AAED,eAAe,aAAa,CAAC"}

package/dist/client.js

@@ -0,0 +1,40 @@
+/**
+ * @mostajs/appconfig/client — UI d'administration de la configuration, **socle-free** (React pur,
+ * aucune dépendance à @mostajs/socle/menu/radix). Reçoit les groupes résolus + une server action
+ * d'enregistrement (DI). Les secrets s'affichent en présent/absent (jamais d'input de valeur).
+ *
+ * Usage (server component de l'app) :
+ *   <AppConfigForm groups={resolveSettings()} action={saveConfigAction} note="…" />
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function Field({ s, allowSecretEdit }) {
+    if (s.secret) {
+        if (!allowSecretEdit) {
+            return (_jsxs("div", { className: "acfg-field acfg-secret", children: [_jsxs("label", { children: [s.label, " ", _jsx("code", { children: s.key })] }), _jsx("span", { className: s.present ? "acfg-badge ok" : "acfg-badge ko", children: s.present ? "● présent" : "○ absent" }), s.help ? _jsx("small", { children: s.help }) : null] }));
+        }
+        // Écriture seule : input mot de passe, jamais pré-rempli ; vide = conserver.
+        return (_jsxs("div", { className: "acfg-field acfg-secret", children: [_jsxs("label", { htmlFor: s.key, children: [s.label, " ", _jsx("code", { children: s.key }), " ", _jsx("span", { className: s.present ? "acfg-badge ok" : "acfg-badge ko", children: s.present ? "● présent" : "○ absent" })] }), _jsx("input", { name: s.key, type: "password", autoComplete: "off", defaultValue: "", placeholder: s.present ? "•••••• (laisser vide pour conserver)" : "définir une valeur" }), s.help ? _jsx("small", { children: s.help }) : null] }));
+    }
+    const v = s.value ?? "";
+    let input;
+    if (s.type === "boolean") {
+        const on = /^(1|true|on|yes)$/i.test(v);
+        input = (_jsxs("select", { name: s.key, defaultValue: on ? "1" : "0", children: [_jsx("option", { value: "1", children: "Activ\u00E9" }), _jsx("option", { value: "0", children: "D\u00E9sactiv\u00E9" })] }));
+    }
+    else if (s.type === "enum") {
+        input = (_jsx("select", { name: s.key, defaultValue: v, children: (s.choices ?? []).map((c) => _jsx("option", { value: c, children: c }, c)) }));
+    }
+    else {
+        input = _jsx("input", { name: s.key, type: s.type === "number" ? "number" : "text", defaultValue: v, placeholder: s.placeholder });
+    }
+    return (_jsxs("div", { className: "acfg-field", children: [_jsxs("label", { htmlFor: s.key, children: [s.label, " ", _jsx("code", { children: s.key })] }), input, s.help ? _jsx("small", { children: s.help }) : null] }));
+}
+export function AppConfigForm({ groups, action, note, className, allowSecretEdit }) {
+    return (_jsxs("form", { action: action, className: className ?? "acfg", children: [note ? _jsx("p", { className: "acfg-note", children: note }) : null, groups.map((g) => (_jsxs("section", { className: "acfg-group", children: [_jsx("h3", { children: g.category }), g.settings.map((s) => _jsx(Field, { s: s, allowSecretEdit: allowSecretEdit }, s.key))] }, g.category))), _jsxs("div", { className: "acfg-actions", children: [_jsxs("label", { className: "acfg-restart", children: [_jsx("input", { type: "checkbox", name: "__restart", value: "1" }), " Red\u00E9marrer apr\u00E8s enregistrement"] }), _jsx("button", { type: "submit", className: "btn primary", children: "Enregistrer" })] })] }));
+}
+export default AppConfigForm;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"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"}

package/dist/envfile.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @mostajs/appconfig — réécriture d'un fichier `.env` : upsert par clé en **préservant commentaires
+ * et ordre** des lignes existantes, ajout en fin si la clé est absente. Logique pure (aucun I/O),
+ * testable. Échappe les valeurs (guillemets si caractères spéciaux).
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import type { EnvChange } from "./types.js";
+/** Échappe une valeur `.env` : guillemets si espaces/`#`/`=`/vide ; double-quote échappées. */
+export declare function escapeEnvValue(value: string): string;
+/**
+ * Applique les changements à un texte `.env` et renvoie le nouveau texte. Les lignes existantes
+ * (commentaires inclus) sont conservées dans l'ordre ; une clé déjà présente est remplacée sur place ;
+ * une clé nouvelle est ajoutée en fin (sous un en-tête).
+ */
+export declare function upsertEnv(text: string, changes: EnvChange[]): string;
+export interface EnvDiff {
+    key: string;
+    before?: string;
+    after: string;
+}
+/** Diff des changements vs le texte actuel (pour aperçu avant application). */
+export declare function diffEnv(text: string, changes: EnvChange[]): EnvDiff[];
+//# sourceMappingURL=envfile.d.ts.map

package/dist/envfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envfile.d.ts","sourceRoot":"","sources":["../src/envfile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD;AAQD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAuBpE;AAED,MAAM,WAAW,OAAO;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAWxE,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAErE"}

package/dist/envfile.js

@@ -0,0 +1,55 @@
+/** Échappe une valeur `.env` : guillemets si espaces/`#`/`=`/vide ; double-quote échappées. */
+export function escapeEnvValue(value) {
+    const v = value.replace(/[\r\n]/g, " ");
+    if (v === "" || /[\s#"'=]/.test(v))
+        return `"${v.replace(/"/g, '\\"')}"`;
+    return v;
+}
+/** Vrai si la ligne (hors commentaire) définit `key`. */
+function isAssignment(line, key) {
+    const m = line.match(/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=/);
+    return !!m && m[1] === key;
+}
+/**
+ * Applique les changements à un texte `.env` et renvoie le nouveau texte. Les lignes existantes
+ * (commentaires inclus) sont conservées dans l'ordre ; une clé déjà présente est remplacée sur place ;
+ * une clé nouvelle est ajoutée en fin (sous un en-tête).
+ */
+export function upsertEnv(text, changes) {
+    const map = new Map(changes.map((c) => [c.key, c.value]));
+    const done = new Set();
+    const eol = text.includes("\r\n") ? "\r\n" : "\n";
+    const lines = text.split(/\r?\n/);
+    const out = lines.map((line) => {
+        for (const [key, value] of map) {
+            if (!done.has(key) && isAssignment(line, key)) {
+                done.add(key);
+                return `${key}=${escapeEnvValue(value)}`;
+            }
+        }
+        return line;
+    });
+    const appended = changes.filter((c) => !done.has(c.key));
+    if (appended.length) {
+        if (out.length && out[out.length - 1].trim() !== "")
+            out.push("");
+        out.push("# — @mostajs/appconfig —");
+        for (const c of appended)
+            out.push(`${c.key}=${escapeEnvValue(c.value)}`);
+    }
+    return out.join(eol);
+}
+/** Lit la valeur brute (non déséchappée finement) d'une clé dans un texte `.env`. */
+function readRaw(text, key) {
+    for (const line of text.split(/\r?\n/)) {
+        const m = line.match(/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=(.*)$/);
+        if (m && m[1] === key)
+            return m[2].trim();
+    }
+    return undefined;
+}
+/** Diff des changements vs le texte actuel (pour aperçu avant application). */
+export function diffEnv(text, changes) {
+    return changes.map((c) => ({ key: c.key, before: readRaw(text, c.key), after: escapeEnvValue(c.value) }));
+}
+//# sourceMappingURL=envfile.js.map

package/dist/envfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envfile.js","sourceRoot":"","sources":["../src/envfile.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @mostajs/appconfig — interface d'administration de la configuration `.env` des modules @mostajs/*.
+ * Spec déclarative contribuée par module → résolution (secrets = présent/absent) → édition validée →
+ * réécriture `.env` (I/O injectée) → redémarrage. Autosuffisant (sans @mostajs/socle), compose @mostajs/config.
+ *
+ * Usage app :
+ *   import { registerBuiltinSettings, resolveSettings, applyChanges } from "@mostajs/appconfig";
+ *   registerBuiltinSettings();                       // ou registerSettings([...vos specs])
+ *   const groups = resolveSettings();                // pour l'UI
+ *   await applyChanges(io, changes, { restart:true });// io = { readEnv, writeEnv, restart } (DI app)
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+export { registerSettings, collectSettings, getSpec, clearSettings } from "./registry.js";
+export { registerBuiltinSettings, CHATBOT_SETTINGS, SOURCING_SETTINGS, CHAT_SETTINGS, DB_SETTINGS, STORAGE_SETTINGS } from "./specs/index.js";
+export { resolveSetting, resolveSettings } from "./resolve.js";
+export { validateChange } from "./validate.js";
+export { upsertEnv, diffEnv, escapeEnvValue } from "./envfile.js";
+export type { EnvDiff } from "./envfile.js";
+export { applyChanges } from "./apply.js";
+export type { SettingType, SettingSpec, ResolvedSetting, ResolvedGroup, EnvChange, ValidationError, AppConfigIO, ApplyReport, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC9I,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EACV,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,GAC/G,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * @mostajs/appconfig — interface d'administration de la configuration `.env` des modules @mostajs/*.
+ * Spec déclarative contribuée par module → résolution (secrets = présent/absent) → édition validée →
+ * réécriture `.env` (I/O injectée) → redémarrage. Autosuffisant (sans @mostajs/socle), compose @mostajs/config.
+ *
+ * Usage app :
+ *   import { registerBuiltinSettings, resolveSettings, applyChanges } from "@mostajs/appconfig";
+ *   registerBuiltinSettings();                       // ou registerSettings([...vos specs])
+ *   const groups = resolveSettings();                // pour l'UI
+ *   await applyChanges(io, changes, { restart:true });// io = { readEnv, writeEnv, restart } (DI app)
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+export { registerSettings, collectSettings, getSpec, clearSettings } from "./registry.js";
+export { registerBuiltinSettings, CHATBOT_SETTINGS, SOURCING_SETTINGS, CHAT_SETTINGS, DB_SETTINGS, STORAGE_SETTINGS } from "./specs/index.js";
+export { resolveSetting, resolveSettings } from "./resolve.js";
+export { validateChange } from "./validate.js";
+export { upsertEnv, diffEnv, escapeEnvValue } from "./envfile.js";
+export { applyChanges } from "./apply.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC9I,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @mostajs/appconfig — registre des specs de réglages (style registre de dialectes/providers).
+ * Chaque module/app enregistre ses specs ; l'UI collecte l'ensemble, groupé par catégorie.
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import type { SettingSpec } from "./types.js";
+/** Enregistre une ou plusieurs specs (idempotent par `key`). */
+export declare function registerSettings(specs: SettingSpec[]): void;
+/** Toutes les specs enregistrées (ordre d'insertion). */
+export declare function collectSettings(): SettingSpec[];
+/** Spec d'une clé donnée (ou null). */
+export declare function getSpec(key: string): SettingSpec | null;
+/** Vide le registre (tests). */
+export declare function clearSettings(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAE3D;AAED,yDAAyD;AACzD,wBAAgB,eAAe,IAAI,WAAW,EAAE,CAE/C;AAED,uCAAuC;AACvC,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAEvD;AAED,gCAAgC;AAChC,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/registry.js

@@ -0,0 +1,19 @@
+const SPECS = new Map(); // clé env → spec (dernier enregistré gagne)
+/** Enregistre une ou plusieurs specs (idempotent par `key`). */
+export function registerSettings(specs) {
+    for (const s of specs)
+        SPECS.set(s.key, s);
+}
+/** Toutes les specs enregistrées (ordre d'insertion). */
+export function collectSettings() {
+    return Array.from(SPECS.values());
+}
+/** Spec d'une clé donnée (ou null). */
+export function getSpec(key) {
+    return SPECS.get(key) ?? null;
+}
+/** Vide le registre (tests). */
+export function clearSettings() {
+    SPECS.clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAOA,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC,CAAC,4CAA4C;AAE1F,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AAChC,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,aAAa;IAC3B,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,6 @@
+import type { ResolvedGroup, ResolvedSetting, SettingSpec } from "./types.js";
+/** Résout une spec en valeur affichable (secret → présent/absent, sans la valeur). */
+export declare function resolveSetting(spec: SettingSpec): ResolvedSetting;
+/** Résout des specs (ou toutes les enregistrées) et les groupe par catégorie (ordre d'apparition). */
+export declare function resolveSettings(specs?: SettingSpec[]): ResolvedGroup[];
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9E,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,CAOjE;AAED,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,KAAK,GAAE,WAAW,EAAsB,GAAG,aAAa,EAAE,CASzF"}

package/dist/resolve.js

@@ -0,0 +1,32 @@
+/**
+ * @mostajs/appconfig — résolution des valeurs courantes via @mostajs/config (`getEnv`, cascade
+ * MOSTA_ENV). Les **secrets** ne renvoient JAMAIS leur valeur : seulement `present` (non vide ?).
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import { getEnv } from "@mostajs/config";
+import { collectSettings } from "./registry.js";
+/** Résout une spec en valeur affichable (secret → présent/absent, sans la valeur). */
+export function resolveSetting(spec) {
+    if (spec.secret) {
+        const raw = getEnv(spec.key);
+        return { ...spec, present: !!(raw && raw.trim()) };
+    }
+    const value = getEnv(spec.key) ?? spec.default ?? "";
+    return { ...spec, value };
+}
+/** Résout des specs (ou toutes les enregistrées) et les groupe par catégorie (ordre d'apparition). */
+export function resolveSettings(specs = collectSettings()) {
+    const groups = [];
+    const byCat = new Map();
+    for (const spec of specs) {
+        let g = byCat.get(spec.category);
+        if (!g) {
+            g = { category: spec.category, settings: [] };
+            byCat.set(spec.category, g);
+            groups.push(g);
+        }
+        g.settings.push(resolveSetting(spec));
+    }
+    return groups;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IACrD,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACrD,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,eAAe,CAAC,QAAuB,eAAe,EAAE;IACtE,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,CAAC,EAAE,CAAC;YAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;QACvG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @mostajs/appconfig/server — ré-export serveur-safe (résolution + application `.env`).
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+export * from "./index.js";
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,YAAY,CAAC"}

package/dist/server.js

@@ -0,0 +1,6 @@
+/**
+ * @mostajs/appconfig/server — ré-export serveur-safe (résolution + application `.env`).
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+export * from "./index.js";
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,YAAY,CAAC"}

package/dist/specs/chat.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Specs `.env` du module @mostajs/chat (messageries de contact).
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import type { SettingSpec } from "../types.js";
+export declare const CHAT_SETTINGS: SettingSpec[];
+//# sourceMappingURL=chat.d.ts.map

package/dist/specs/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/specs/chat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,eAAO,MAAM,aAAa,EAAE,WAAW,EAMtC,CAAC"}

package/dist/specs/chat.js

@@ -0,0 +1,9 @@
+const CAT = "Chat / Messageries";
+export const CHAT_SETTINGS = [
+    { key: "CHAT_ENABLED", label: "Activer le chat de contact", category: CAT, type: "boolean", default: "1" },
+    { key: "CHAT_PROVIDERS", label: "Providers (ordre)", category: CAT, type: "list", default: "wechat,whatsapp,messenger,telegram", placeholder: "wechat,whatsapp,messenger,telegram", help: "Messageries proposées." },
+    { key: "WECHAT_OFFICIAL_QR", label: "QR officiel WeChat", category: CAT, type: "string", placeholder: "weixin://…", help: "Contenu du QR du compte officiel." },
+    // Secret — envoi programmatique Telegram (Bot API). Présent/absent uniquement.
+    { key: "TELEGRAM_BOT_TOKEN", label: "Token Bot Telegram", category: CAT, type: "secret", secret: true, help: "Pour l'envoi RFQ réel via Telegram. Édition via .env serveur." },
+];
+//# sourceMappingURL=chat.js.map

package/dist/specs/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/specs/chat.ts"],"names":[],"mappings":"AAMA,MAAM,GAAG,GAAG,oBAAoB,CAAC;AAEjC,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,4BAA4B,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE;IAC1G,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oCAAoC,EAAE,WAAW,EAAE,oCAAoC,EAAE,IAAI,EAAE,wBAAwB,EAAE;IACpN,EAAE,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,mCAAmC,EAAE;IAC/J,+EAA+E;IAC/E,EAAE,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,+DAA+D,EAAE;CAC/K,CAAC"}

package/dist/specs/chatbot.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Specs `.env` du module @mostajs/chatbot. Les clés IA sont des **secrets** (présent/absent uniquement).
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import type { SettingSpec } from "../types.js";
+export declare const CHATBOT_SETTINGS: SettingSpec[];
+//# sourceMappingURL=chatbot.d.ts.map

package/dist/specs/chatbot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.d.ts","sourceRoot":"","sources":["../../src/specs/chatbot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAWzC,CAAC"}

package/dist/specs/chatbot.js

@@ -0,0 +1,14 @@
+const CAT = "Chatbot";
+export const CHATBOT_SETTINGS = [
+    { key: "CHATBOT_ENABLED", label: "Activer le chatbot", category: CAT, type: "boolean", default: "1", help: "Affiche le copilote dans l'app." },
+    { key: "CHATBOT_MODE", label: "Mode", category: CAT, type: "enum", choices: ["assistant", "agent"], default: "assistant", help: "assistant (Q/R) ou agent (multi-étapes, tool-use)." },
+    { key: "CHATBOT_BACKEND", label: "Backend", category: CAT, type: "enum", choices: ["scripted", "ai"], default: "scripted", help: "scripted (sans clé) ou ai (LLM, nécessite une clé)." },
+    { key: "CHATBOT_PROVIDERS", label: "Providers LLM (ordre/fallback)", category: CAT, type: "list", default: "anthropic,deepseek", placeholder: "anthropic,deepseek", help: "Liste ordonnée ; bascule au suivant en cas d'échec." },
+    { key: "CHATBOT_MODEL", label: "Modèle", category: CAT, type: "string", placeholder: "claude-opus-4-8", help: "Modèle par défaut du provider principal." },
+    { key: "CHATBOT_WEB_SEARCH", label: "Recherche web", category: CAT, type: "boolean", default: "0", help: "Autorise web_search/web_fetch (backend ai)." },
+    { key: "CHATBOT_ROLES", label: "Rôles autorisés", category: CAT, type: "list", placeholder: "admin,employe", help: "Vide = tous les utilisateurs connectés." },
+    // Secrets — jamais édités par l'UI (présent/absent), à régler dans le .env serveur (SSH).
+    { key: "ANTHROPIC_API_KEY", label: "Clé API Anthropic", category: CAT, type: "secret", secret: true, help: "Provider anthropic. Édition via .env serveur." },
+    { key: "DEEPSEEK_API_KEY", label: "Clé API DeepSeek", category: CAT, type: "secret", secret: true, help: "Provider deepseek. Édition via .env serveur." },
+];
+//# sourceMappingURL=chatbot.js.map

package/dist/specs/chatbot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.js","sourceRoot":"","sources":["../../src/specs/chatbot.ts"],"names":[],"mappings":"AAMA,MAAM,GAAG,GAAG,SAAS,CAAC;AAEtB,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,iCAAiC,EAAE;IAC9I,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,oDAAoD,EAAE;IACtL,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,qDAAqD,EAAE;IACxL,EAAE,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,gCAAgC,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE,qDAAqD,EAAE;IACjO,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,IAAI,EAAE,0CAA0C,EAAE;IAC1J,EAAE,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,6CAA6C,EAAE;IACxJ,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,yCAAyC,EAAE;IAC9J,0FAA0F;IAC1F,EAAE,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,+CAA+C,EAAE;IAC5J,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,8CAA8C,EAAE;CAC1J,CAAC"}

package/dist/specs/db.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Specs `.env` socle app : base de données, environnement, stockage.
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import type { SettingSpec } from "../types.js";
+export declare const DB_SETTINGS: SettingSpec[];
+export declare const STORAGE_SETTINGS: SettingSpec[];
+//# sourceMappingURL=db.d.ts.map

package/dist/specs/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/specs/db.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,WAAW,EAAE,WAAW,EAIpC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAEzC,CAAC"}

package/dist/specs/db.js

@@ -0,0 +1,9 @@
+export const DB_SETTINGS = [
+    { key: "MOSTA_ENV", label: "Profil d'environnement", category: "Application", type: "enum", choices: ["DEV", "TEST", "PROD"], default: "PROD", help: "Cascade de configuration (préfixe des clés)." },
+    { key: "DB_DIALECT", label: "Dialecte base de données", category: "Base de données", type: "enum", choices: ["sqljs", "sqlite", "postgres", "mysql"], default: "sqljs", help: "Pilote ORM." },
+    { key: "DATABASE_URL", label: "URL / chemin base", category: "Base de données", type: "string", placeholder: "./trading.db", help: "Chemin (sqljs/sqlite) ou URL de connexion." },
+];
+export const STORAGE_SETTINGS = [
+    { key: "STORAGE_MAX_MB", label: "Taille max upload (Mo)", category: "Stockage", type: "number", default: "200", help: "Limite par fichier." },
+];
+//# sourceMappingURL=db.js.map

package/dist/specs/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/specs/db.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,wBAAwB,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,8CAA8C,EAAE;IACrM,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,0BAA0B,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE;IAC7L,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,4CAA4C,EAAE;CAClL,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,wBAAwB,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE;CAC9I,CAAC"}

package/dist/specs/index.d.ts

@@ -0,0 +1,8 @@
+import { CHATBOT_SETTINGS } from "./chatbot.js";
+import { SOURCING_SETTINGS } from "./sourcing.js";
+import { CHAT_SETTINGS } from "./chat.js";
+import { DB_SETTINGS, STORAGE_SETTINGS } from "./db.js";
+export { CHATBOT_SETTINGS, SOURCING_SETTINGS, CHAT_SETTINGS, DB_SETTINGS, STORAGE_SETTINGS };
+/** Enregistre tous les packs built-in (app, db, chat, chatbot, sourcing, stockage). */
+export declare function registerBuiltinSettings(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/specs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/specs/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;AAE7F,uFAAuF;AACvF,wBAAgB,uBAAuB,IAAI,IAAI,CAQ9C"}

package/dist/specs/index.js

@@ -0,0 +1,22 @@
+/**
+ * @mostajs/appconfig — packs de specs built-in. `registerBuiltinSettings()` les enregistre tous ;
+ * l'app peut aussi en (dé)sélectionner ou enregistrer les siens via `registerSettings`.
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import { registerSettings } from "../registry.js";
+import { CHATBOT_SETTINGS } from "./chatbot.js";
+import { SOURCING_SETTINGS } from "./sourcing.js";
+import { CHAT_SETTINGS } from "./chat.js";
+import { DB_SETTINGS, STORAGE_SETTINGS } from "./db.js";
+export { CHATBOT_SETTINGS, SOURCING_SETTINGS, CHAT_SETTINGS, DB_SETTINGS, STORAGE_SETTINGS };
+/** Enregistre tous les packs built-in (app, db, chat, chatbot, sourcing, stockage). */
+export function registerBuiltinSettings() {
+    registerSettings([
+        ...DB_SETTINGS,
+        ...CHATBOT_SETTINGS,
+        ...SOURCING_SETTINGS,
+        ...CHAT_SETTINGS,
+        ...STORAGE_SETTINGS,
+    ]);
+}
+//# sourceMappingURL=index.js.map

package/dist/specs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/specs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;AAE7F,uFAAuF;AACvF,MAAM,UAAU,uBAAuB;IACrC,gBAAgB,CAAC;QACf,GAAG,WAAW;QACd,GAAG,gBAAgB;QACnB,GAAG,iBAAiB;QACpB,GAAG,aAAa;QAChB,GAAG,gBAAgB;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/specs/sourcing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Specs `.env` du module @mostajs/sourcing.
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import type { SettingSpec } from "../types.js";
+export declare const SOURCING_SETTINGS: SettingSpec[];
+//# sourceMappingURL=sourcing.d.ts.map

package/dist/specs/sourcing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourcing.d.ts","sourceRoot":"","sources":["../../src/specs/sourcing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,eAAO,MAAM,iBAAiB,EAAE,WAAW,EAM1C,CAAC"}

package/dist/specs/sourcing.js

@@ -0,0 +1,9 @@
+const CAT = "Sourcing";
+export const SOURCING_SETTINGS = [
+    { key: "SOURCING_CONNECTORS", label: "Connecteurs (ordre)", category: CAT, type: "list", default: "internal,web", placeholder: "internal,web", help: "Sources d'offres actives." },
+    { key: "SOURCING_WEIGHTS", label: "Pondérations de scoring", category: CAT, type: "string", default: "price:0.5,leadTime:0.2,moq:0.1,reliability:0.2", help: "Poids des critères (somme libre)." },
+    { key: "SOURCING_TOPN", label: "Top-N offres", category: CAT, type: "number", default: "5", help: "Nombre d'offres retournées." },
+    { key: "SOURCING_MAX_PAGES", label: "Pages web max / requête", category: CAT, type: "number", default: "8", help: "Borne coût/latence de la recherche." },
+    { key: "SOURCING_RFQ", label: "RFQ (envoi réel)", category: CAT, type: "boolean", default: "0", help: "Active l'envoi des demandes de devis (humain-in-the-loop conseillé)." },
+];
+//# sourceMappingURL=sourcing.js.map

package/dist/specs/sourcing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourcing.js","sourceRoot":"","sources":["../../src/specs/sourcing.ts"],"names":[],"mappings":"AAMA,MAAM,GAAG,GAAG,UAAU,CAAC;AAEvB,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,EAAE,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,2BAA2B,EAAE;IAClL,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,yBAAyB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gDAAgD,EAAE,IAAI,EAAE,mCAAmC,EAAE;IAClM,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,6BAA6B,EAAE;IACjI,EAAE,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAE,yBAAyB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,qCAAqC,EAAE;IACzJ,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,sEAAsE,EAAE;CAC/K,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @mostajs/appconfig — types. Spec déclarative d'un réglage `.env`, contribuée par module (registre
+ * style dialecte/provider). I/O `.env` + redémarrage **injectés** (DI) — le module ne code pas en dur
+ * un chemin de fichier ni un process pm2.
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+export type SettingType = "string" | "number" | "boolean" | "enum" | "list" | "secret";
+/** Description déclarative d'un réglage (= une variable d'environnement). */
+export interface SettingSpec {
+    /** Nom de la variable d'environnement (ex. `CHATBOT_ENABLED`). */
+    key: string;
+    label: string;
+    /** Groupe d'affichage (ex. « Chatbot », « Sourcing », « Base de données »). */
+    category: string;
+    type: SettingType;
+    default?: string;
+    /** Valeurs autorisées (type `enum`). */
+    choices?: string[];
+    help?: string;
+    placeholder?: string;
+    /** Secret : la valeur n'est JAMAIS lue/écrite/renvoyée par l'UI ; seulement présent/absent. */
+    secret?: boolean;
+}
+/** Réglage résolu pour l'affichage. Pour un secret : `present` renseigné, `value` toujours absent. */
+export interface ResolvedSetting extends SettingSpec {
+    value?: string;
+    present?: boolean;
+}
+/** Groupe de réglages résolus (par catégorie), pour l'UI. */
+export interface ResolvedGroup {
+    category: string;
+    settings: ResolvedSetting[];
+}
+/** Modification demandée (jamais émise pour un secret). */
+export interface EnvChange {
+    key: string;
+    value: string;
+}
+/** Erreur de validation d'un changement. */
+export interface ValidationError {
+    key: string;
+    message: string;
+}
+/**
+ * I/O injectée par l'app (DI) : lecture/écriture du `.env` serveur + redémarrage. Le chemin réel et
+ * le process pm2 sont propres au déploiement → hors module.
+ */
+export interface AppConfigIO {
+    readEnv(): Promise<string>;
+    writeEnv(text: string): Promise<void>;
+    restart?(): Promise<void>;
+}
+/** Rapport d'application d'un lot de changements. */
+export interface ApplyReport {
+    ok: boolean;
+    applied: EnvChange[];
+    errors: ValidationError[];
+    restarted: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvF,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,sGAAsG;AACtG,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * @mostajs/appconfig — types. Spec déclarative d'un réglage `.env`, contribuée par module (registre
+ * style dialecte/provider). I/O `.env` + redémarrage **injectés** (DI) — le module ne code pas en dur
+ * un chemin de fichier ni un process pm2.
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/validate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @mostajs/appconfig — validation d'un changement avant écriture (type/choices/secret).
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import type { SettingSpec, ValidationError } from "./types.js";
+/** Options de validation. `allowSecrets` autorise l'écriture SEULE de secrets (valeur non vide). */
+export interface ValidateOptions {
+    allowSecrets?: boolean;
+}
+/** Valide une valeur pour une spec. Renvoie une erreur ou `null`. */
+export declare function validateChange(spec: SettingSpec, value: string, opts?: ValidateOptions): ValidationError | null;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI/D,oGAAoG;AACpG,MAAM,WAAW,eAAe;IAAG,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE;AAE3D,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,eAAe,GAAG,IAAI,CA+BnH"}

package/dist/validate.js

@@ -0,0 +1,37 @@
+const BOOL = /^(0|1|true|false|on|off|yes|no)$/i;
+/** Valide une valeur pour une spec. Renvoie une erreur ou `null`. */
+export function validateChange(spec, value, opts = {}) {
+    if (spec.secret || spec.type === "secret") {
+        if (!opts.allowSecrets) {
+            return { key: spec.key, message: "Réglage secret : non éditable via l'interface (éditer le .env serveur)." };
+        }
+        if (/[\r\n]/.test(value))
+            return { key: spec.key, message: "Valeur invalide : retour à la ligne interdit." };
+        if (value.trim() === "")
+            return { key: spec.key, message: "Valeur secrète vide (laisser vide pour conserver)." };
+        return null; // secret avec une nouvelle valeur → accepté (écriture seule)
+    }
+    if (/[\r\n]/.test(value)) {
+        return { key: spec.key, message: "Valeur invalide : retour à la ligne interdit." };
+    }
+    switch (spec.type) {
+        case "number":
+            if (value.trim() === "" || !Number.isFinite(Number(value))) {
+                return { key: spec.key, message: "Doit être un nombre." };
+            }
+            break;
+        case "boolean":
+            if (!BOOL.test(value.trim())) {
+                return { key: spec.key, message: "Doit être un booléen (0/1, true/false, on/off, yes/no)." };
+            }
+            break;
+        case "enum":
+            if (spec.choices && !spec.choices.includes(value)) {
+                return { key: spec.key, message: `Valeur hors choix autorisés : ${spec.choices.join(", ")}.` };
+            }
+            break;
+        // string / list : libre
+    }
+    return null;
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAMA,MAAM,IAAI,GAAG,mCAAmC,CAAC;AAKjD,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAAC,IAAiB,EAAE,KAAa,EAAE,OAAwB,EAAE;IACzF,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,yEAAyE,EAAE,CAAC;QAC/G,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;QAC7G,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;QACjH,OAAO,IAAI,CAAC,CAAC,6DAA6D;IAC5E,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;IACrF,CAAC;IACD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC3D,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;YAC5D,CAAC;YACD,MAAM;QACR,KAAK,SAAS;YACZ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC7B,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,yDAAyD,EAAE,CAAC;YAC/F,CAAC;YACD,MAAM;QACR,KAAK,MAAM;YACT,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClD,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,iCAAiC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACjG,CAAC;YACD,MAAM;QACR,wBAAwB;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/llms.txt

@@ -0,0 +1,22 @@
+# @mostajs/appconfig — llms.txt
+
+But : administrer la configuration `.env` des modules @mostajs/* via une UI. Autosuffisant (sans @mostajs/socle), compose @mostajs/config. Ne réimplémente pas getEnv ; n'embarque pas de DB ; ne manipule jamais un secret.
+
+API (import "@mostajs/appconfig") :
+- registerSettings(specs) / collectSettings() / getSpec(key) / clearSettings() — registre (style dialecte).
+- registerBuiltinSettings() + packs CHATBOT_SETTINGS / SOURCING_SETTINGS / CHAT_SETTINGS / DB_SETTINGS / STORAGE_SETTINGS.
+- resolveSettings(specs?) -> ResolvedGroup[] : valeurs courantes via getEnv ; secret -> {present} sans value.
+- validateChange(spec, value) -> ValidationError|null.
+- upsertEnv(text, changes) / diffEnv(text, changes) / escapeEnvValue(v) — réécriture .env pure (préserve commentaires/ordre).
+- applyChanges(io, changes, {restart}) -> ApplyReport : valide -> écrit -> redémarre (tout-ou-rien ; refuse secret/clé inconnue).
+- Types : SettingSpec, SettingType, ResolvedSetting, ResolvedGroup, EnvChange, ValidationError, AppConfigIO, ApplyReport.
+
+UI (import "@mostajs/appconfig/client") :
+- <AppConfigForm groups={ResolvedGroup[]} action={(FormData)=>void} note? className? /> — socle-free ; secrets en présent/absent.
+
+DI (app) : AppConfigIO { readEnv(): Promise<string>; writeEnv(text): Promise<void>; restart?(): Promise<void> }.
+Le chemin du .env et le process pm2 sont fournis par l'app, jamais codés dans le module.
+
+Règles : secrets jamais exposés/écrits par l'UI (.env serveur via SSH) ; permission app.config ; validation avant écriture.
+
+Auteur : Dr Hamid MADANI <drmdh@msn.com> — AGPL-3.0-or-later.

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@mostajs/appconfig",
+  "version": "0.1.0",
+  "description": "Interface d'administration de la configuration .env des modules @mostajs/* : spec déclarative contribuée par module (chatbot, sourcing, chat, db…), résolution des valeurs courantes (secrets = présent/absent), édition validée et réécriture .env (I/O injectée par DI) + redémarrage. Autosuffisant (sans @mostajs/socle). Compose @mostajs/config.",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "default": "./dist/server.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
+    }
+  },
+  "files": [
+    "dist",
+    "llms.txt",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@mostajs/config": "*",
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/react": "^19.0.0"
+  },
+  "keywords": [
+    "config",
+    "env",
+    "settings",
+    "admin",
+    "dotenv",
+    "no-socle",
+    "mostajs"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}