@mostajs/wagon-engine 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 **Auteur** : Dr Hamid MADANI <drmdh@msn.com>
 Format : Keep a Changelog ; versions : SemVer.
 
+## [0.6.0] — 2026-10-28
+
+### Ajouté
+- **Le vendeur de chaque devise** (`@mostajs/payment` ≥ 2.7) : `PAIEMENT_VENDEUR_<DEVISE>` dans le `.env`. Dès qu'une
+  telle variable est déclarée, une devise sans vendeur nommé n'est pas vendue : Stripe et les banques prépayées de
+  cette devise sont écartés, même avec leurs clés (un avertissement le dit au démarrage). `{{VENDEUR}}` des textes
+  légaux nomme le vendeur de chaque devise vendue, une ligne par devise ; `config.legal.VENDEUR` l'emporte s'il est
+  posé. `PAIEMENT_STRIPE_DEVISES` dit la devise de Stripe (défaut EUR), reprise par l'affichage des prix. Sans aucune
+  `PAIEMENT_VENDEUR_*`, rien ne change. Essai T-ENG-14.
+- `creerWagon(…).moyens` : les moyens réellement proposés ; `demarrer` le rend tel quel.
+- `llms.txt` et le README s'ouvrent sur la configuration du `.env` par `@mostajs/config` (chargement, cascade
+  `MOSTA_ENV`, valeur vide, priorité de l'environnement).
+
+### Dépendances
+- `@mostajs/payment` ^2.7.0.
+
 ## [0.5.0] — 2026-10-28
 
 ### Ajouté

package/README.md

@@ -41,6 +41,12 @@ await demarrer({ config, charge });
 | `CHARGILY_SECRET_KEY` · `SATIM_MERCHANT_ID`, `SATIM_PASSWORD`, `SATIM_TERMINAL_ID` · `PAYPAL_…` | les banques prépayées proposées par `config.paiement.prepaye` |
 | `PAIEMENT_STRIPE=off`, `PAIEMENT_CHARGILY=off`, `PAIEMENT_SATIM=off`, `PAIEMENT_PAYPAL=off` | **coupe un moyen** sans toucher à ses clés |
 | `WAGON_ADMINS` | les courriels administrateurs (confirmés par un code reçu) |
+| `PAIEMENT_VENDEUR_DZD`, `PAIEMENT_VENDEUR_EUR`… | 0.6 — **le vendeur de chaque devise** (dénomination, forme, adresse, immatriculations) ; dès qu'une est déclarée, une devise sans vendeur n'est pas vendue, et `{{VENDEUR}}` des CGV les nomme |
+| `PAIEMENT_STRIPE_DEVISES` | 0.6 — la devise de Stripe (défaut `EUR`) |
+
+**Le `.env` d'abord.** Toutes les clés passent par `getEnv` de `@mostajs/config` : cascade `MOSTA_ENV` (`PROD_CLÉ` l'emporte sur `CLÉ`), valeur vide = absente, et `loadEnv` n'écrase jamais une variable déjà posée par l'orchestrateur. Si `wagon.config.mjs` lit des variables, il appelle `loadEnv` lui-même, en tête.
+
+**Un vendeur par devise (0.6).** Un SaaS qui vend en dinars par un auto-entrepreneur et en euros par une société pose `PAIEMENT_VENDEUR_DZD=…` et `PAIEMENT_VENDEUR_EUR=…`. Une devise déclarée vide (`PAIEMENT_VENDEUR_EUR=`, la société n'est pas encore immatriculée) n'est pas vendue : Stripe est écarté même avec sa clé. Sans aucune `PAIEMENT_VENDEUR_*`, rien ne change.
 
 **Le paiement est au choix de l'utilisateur**, parmi les moyens actifs. Un moyen est actif quand ses clés sont dans le `.env` et que son commutateur n'est pas sur `off`. Une banque prépayée doit en plus être proposée par la configuration.
 

package/llms.txt

@@ -4,13 +4,28 @@
 > PayPal), espace client, administration, pages légales, robots/sitemap, sauvegarde, fr/en/ar. Une GREFFE n'apporte que
 > wagon.config.mjs, charge/, legal/ et son .env. N2 (pack). Extrait du gabarit mosta-wagon 0.11.0 le 26/10/2026.
 
-- Version: 0.2.0 · Licence: AGPL-3.0-or-later · Auteur: Dr Hamid MADANI <drmdh@msn.com>
+- Version: 0.6.0 · Licence: AGPL-3.0-or-later · Auteur: Dr Hamid MADANI <drmdh@msn.com>
 - Chemin: mostajs/mosta-platform-stack/mosta-wagon-engine · gabarit d'une greffe : Entreprise/mosta-wagon
 
+## ⚙️ D'EMBLÉE : LE .env ET LA CASCADE @mostajs/config
+Une greffe se configure par SON `.env` (dossier courant de `demarrer`, ou `racine`). Avant tout :
+1. **Qui le charge** : `demarrer` appelle `loadEnv({ path: <racine>/.env })` de `@mostajs/config`. Si `wagon.config.mjs`
+   lit lui-même des variables (getEnv au chargement du module), il doit appeler `loadEnv` EN TÊTE, avant de les lire :
+   `import { loadEnv, getEnv } from '@mostajs/config'; loadEnv({ path: join(process.cwd(), '.env') });`
+   Le second appel (celui de demarrer) n'écrase rien.
+2. **loadEnv ne SURCHARGE pas** une variable déjà dans l'environnement : la valeur de l'orchestrateur (pm2, systemd,
+   conteneur) prime sur le fichier.
+3. **Cascade** (première valeur NON VIDE) : `${MOSTA_ENV}_${CLÉ}` → `${CLÉ}` → défaut. Un seul .env, des profils
+   `TEST_`/`DEV_`/`PROD_`. Toutes les clés ci-dessous, et celles de `@mostajs/payment`, passent par `getEnv`.
+4. **Vide = absent** : `WAGON_STRIPE_SECRET_KEY=` ne configure rien. Exception voulue : `PAIEMENT_VENDEUR_<DEVISE>=`
+   vide DÉCLARE la devise sans la nommer (elle n'est pas vendue).
+5. Les secrets et les informations de l'entreprise sont posés par l'exploitant sur le serveur, jamais commités ;
+   `.env.example` de la greffe liste chaque clé, sans valeur.
+
 ## EXPORTS
-- demarrer({ config, charge, racine = cwd, journal }) → { wagon, serveur, moyens: string[], fermer() }
+- demarrer({ config, charge, racine = cwd, journal }) → { wagon, serveur, moyens: string[], fermer() } (moyens = wagon.moyens, 0.6)
 - creerWagon({ config, charge, sgbd: string|{dialect,uri}, baseUrl, stripe?, webhookSecret?, transport?, journal?,
-  paiement?: { banques: { chargily:'DZD', … }, port? }, racine? }) → { handler, catalogue(), catalogueStripe(), fermer(), … }
+  paiement?: { banques: { chargily:'DZD', … }, port?, deviseStripe? }, racine? }) → { moyens, handler, catalogue(), catalogueStripe(), fermer(), … }
 - schemasWagon() (sauvegarde) · sauvegarder({ cibles, driver, seau, recipients, garder }) · suivrePalette(…)
 - '@mostajs/wagon-engine/conformite' = src/conformite/conformite.test.mjs (suite mjs-unit, juge WAGON_GREFFE ou cwd)
 
@@ -19,7 +34,13 @@ PORT, HOST · WAGON_BASE_URL · WAGON_DB_DIALECT (sqlite|postgres…), WAGON_SGB
 WAGON_EMAIL_FROM (ou WAGON_COURRIEL_FICHIER pour les essais) · WAGON_STRIPE_SECRET_KEY|RESTRICTED_KEY, WAGON_STRIPE_WEBHOOK_SECRET ·
 CHARGILY_SECRET_KEY|API_KEY · SATIM_MERCHANT_ID, SATIM_PASSWORD, SATIM_TERMINAL_ID · PAYPAL_CLIENT_ID, PAYPAL_SECRET,
 PAYPAL_WEBHOOK_ID · PAIEMENT_<STRIPE|CHARGILY|SATIM|PAYPAL>=off (coupe le moyen) · WAGON_ADMINS · WAGON_INDEXER.
-Moyen ACTIF = clés présentes ET commutateur ≠ off (ET, pour une banque prépayée, proposée par config.paiement.prepaye).
+0.6 (@mostajs/payment ≥ 2.7) : PAIEMENT_VENDEUR_<DEVISE> (le vendeur de cette devise : dénomination, forme, adresse,
+immatriculations) · PAIEMENT_STRIPE_DEVISES (la devise de Stripe, défaut EUR).
+Moyen ACTIF = clés présentes ET commutateur ≠ off (ET, pour une banque prépayée, proposée par config.paiement.prepaye)
+ET, 0.6, dès qu'une PAIEMENT_VENDEUR_* est déclarée, un vendeur NOMMÉ pour sa devise. `{{VENDEUR}}` des textes légaux
+nomme alors le vendeur de chaque devise vendue (une ligne par devise, nom de la devise dans la langue de la page) ;
+`config.legal.VENDEUR` l'emporte s'il est posé. Exemple : dinars par un auto-entrepreneur, euros par une société pas
+encore immatriculée → `PAIEMENT_VENDEUR_DZD=…`, `PAIEMENT_VENDEUR_EUR=` (vide) : seule la vente en dinars s'ouvre.
 
 ## CONTRAT DE LA CHARGE (charge/index.mjs)
 liens · ressources (quota { cle, limite, periode } | plafond { cle, limite, plafond: true }) · accueil (fiche { fr: { titre, lede, actions, preuves } }, ou 0.3 : async (ctx) => ({ titre, contenu, disposition, application, console })) · dispositions (0.3 : { nom: (p) => corps }) · textes ·

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/wagon-engine",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Le wagon d'un SaaS, une fois pour toutes : comptes, connexion, paliers, quotas, paiement (Stripe, Chargily, SATIM), espace client, administration, pages légales, fr/en/ar. Une greffe n'apporte que wagon.config.mjs, charge/, legal/ et son .env ; la suite de conformité publiée juge la greffe.",
   "keywords": [
     "mostajs",
@@ -50,7 +50,7 @@
     "@mostajs/mailer": "^0.2.0",
     "@mostajs/markdown-html": "^0.3.0",
     "@mostajs/orm": "^2.12.1",
-    "@mostajs/payment": "^2.6.0",
+    "@mostajs/payment": "^2.7.0",
     "@mostajs/subscriptions-plan": "^0.9.0",
     "@mostajs/wagon-ui": "^0.11.0",
     "better-sqlite3": "^12.11.1",

package/src/demarrer.mjs

@@ -11,6 +11,7 @@ import { createServer } from 'node:http';
 import { appendFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { loadEnv, getEnv } from '@mostajs/config';
+import { devisesDuMoyen } from '@mostajs/payment/server';
 import { creerWagon } from './wagon.mjs';
 
 const coupe = (moyen) => getEnv(`PAIEMENT_${moyen.toUpperCase()}`, '') === 'off';
@@ -53,10 +54,11 @@ export async function demarrer({ config, charge, racine = process.cwd(), journal
     stripe: cle ? new (await import('stripe')).default(cle) : null,
     webhookSecret: getEnv('WAGON_STRIPE_WEBHOOK_SECRET', ''),
     transport: await transport(),
-    paiement: { banques },
+    // 0.6 — la devise de Stripe (PAIEMENT_STRIPE_DEVISES, défaut EUR) : creerWagon écarte une devise sans vendeur.
+    paiement: { banques, deviseStripe: devisesDuMoyen('stripe', ['EUR'])[0] },
   });
   await wagon.catalogue();
-  const moyens = [...(cle ? ['stripe'] : []), ...Object.keys(banques)];
+  const moyens = wagon.moyens;
   const serveur = createServer(wagon.handler);
   const port = Number(getEnv('PORT', '4800'));
   await new Promise((ok) => serveur.listen(port, getEnv('HOST', '127.0.0.1'), ok));

package/src/wagon.mjs

@@ -25,6 +25,7 @@ import { creerWagonUi, esc } from '@mostajs/wagon-ui';
 import { creerComptes, schemasComptes } from '@mostajs/comptes';
 import { createBilling, createStripeSale, createPrepaidSale, billingSchemas, checkLimits, assertMonotonicPlans } from '@mostajs/subscriptions-plan/server';
 import { PaymentSchema } from '@mostajs/payment';
+import { venteAutorisee, vendeursFromEnv } from '@mostajs/payment/server';
 import { formatNumber, resolveFormatLocale } from '@mostajs/i18n';
 import { createPasswordAuth, createEmailCodeAuth, SessionSchema, ipClient, memoryLimiter } from '@mostajs/auth-lite';
 import { emailCodeEmailHtml, emailCodeEmailText, emailCodeForm, emailLinkConfirmPage, AUTH_CSS } from '@mostajs/auth-ui';
@@ -165,12 +166,18 @@ const cookieDe = (req, nom) => (req.headers.cookie || '').split(';').map((s) =>
  * @param {{ envoyer: Function } | null} [o.transport]  les courriels (code de connexion)
  * @param {{ banques?: Record<string, string>, port?: object }} [o.paiement]  0.3 — vente prépayée : les banques ACTIVES
  *        et leur devise (`{ chargily: 'DZD', paypal: 'EUR' }`, server.mjs ne garde que celles dont le .env porte les
- *        clés) ; `port` remplace @mostajs/payment (essais)
+ *        clés) ; `port` remplace @mostajs/payment (essais) ; 0.6 — `deviseStripe` (défaut 'EUR') : la devise de Stripe
+ * 0.6 — une devise sans VENDEUR (`PAIEMENT_VENDEUR_<DEVISE>`, @mostajs/payment ≥ 2.7, règle en vigueur dès qu'une telle
+ *        variable est déclarée) n'est pas vendue : Stripe et les banques de cette devise sont écartés ici, et `{{VENDEUR}}`
+ *        des textes légaux nomme le vendeur de chaque devise vendue.
  */
 /** 0.5 — le commit en service (posé par le déployeur dans le dossier de l'instance) et l'heure de démarrage. */
 const lireRevision = (racine) => { try { return readFileSync(join(racine, 'REVISION'), 'utf8').trim() || null; } catch { return null; } };
 export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null, webhookSecret = '', transport = null, journal = console, paiement = null, racine = process.cwd() }) {
   const origine = String(baseUrl || '').replace(/\/$/, '');
+  // 0.6 — pas de vente dans une devise sans vendeur (même si les clés de sa banque sont posées).
+  const deviseStripe = String(paiement?.deviseStripe ?? 'EUR').toUpperCase();
+  if (stripe && !venteAutorisee(deviseStripe)) { journal.warn(`wagon : Stripe écarté — aucun vendeur pour ${deviseStripe} (PAIEMENT_VENDEUR_${deviseStripe})`); stripe = null; }
   const REVISION = lireRevision(racine); const DEMARRE_LE = new Date().toISOString();
   const https = /^https:/.test(origine);
   const S = Object.fromEntries(schemasWagon().map((s) => [s.name, s]));
@@ -226,7 +233,11 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
       accountOf: async (c) => (await d.findOne(S.Account, { stripeCustomerId: c }))?.id ?? null,
     },
   }) : null;
-  const banques = { ...(paiement?.banques ?? {}) };
+  const banques = Object.fromEntries(Object.entries(paiement?.banques ?? {}).filter(([b, dv]) => {
+    if (venteAutorisee(String(dv))) return true;
+    journal.warn(`wagon : ${b} écarté — aucun vendeur pour ${String(dv).toUpperCase()} (PAIEMENT_VENDEUR_${String(dv).toUpperCase()})`);
+    return false;
+  }));
   const prepaye = Object.keys(banques).length ? createPrepaidSale({
     billing: facturation, providers: banques, payment: paiement?.port, metadataKeys: { account: META.account, plan: META.plan, period: 'wagon_periode' },
     // 0.10 — `return` : SATIM ne notifie pas le serveur, il renvoie l'acheteur (@mostajs/payment ≥ 2.6). Les banques à
@@ -329,12 +340,26 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
    */
   const NOMS_MOYENS = { stripe: 'Stripe (carte bancaire)', chargily: 'Chargily (CIB, Edahabia)', paypal: 'PayPal', satim: 'SATIM (CIB)' };
   const signales = new Set();
+  /**
+   * 0.6 — `{{VENDEUR}}` : le vendeur de chaque devise VENDUE (Stripe et les banques actives), d'après
+   * `PAIEMENT_VENDEUR_<DEVISE>` ; une ligne par devise. Vide si aucune n'a de vendeur : le texte n'est alors pas servi.
+   */
+  function vendeurLegal(lang) {
+    const vendeurs = vendeursFromEnv();
+    const parDevise = new Map(stripe ? [[deviseStripe, ['stripe']]] : []);
+    for (const [b, dv] of Object.entries(banques)) { const k = String(dv).toUpperCase(); parDevise.set(k, [...(parDevise.get(k) ?? []), b]); }
+    let noms = null; try { noms = new Intl.DisplayNames([lang, 'fr'], { type: 'currency' }); } catch { /* langue inconnue */ }
+    return [...parDevise].filter(([dv]) => vendeurs[dv]).map(([dv, ms]) => {
+      const n = noms?.of(dv) ?? dv;
+      return `- **${n.charAt(0).toUpperCase()}${n.slice(1)} (${dv})** — ${ms.map((m) => NOMS_MOYENS[m] ?? m).join(', ')} : ${vendeurs[dv]}`;
+    }).join('\n');
+  }
   function documentLegal(doc, lang) {
     const dossier = config.dossierLegal ?? join(racine, 'legal');   // la greffe, plus le moteur
     const f = [lang, 'fr'].map((l) => join(dossier, `${doc}.${l}.md`)).find((x) => existsSync(x));
     if (!f) return { html: '', complet: false };
     const moyens = [...(stripe ? ['stripe'] : []), ...Object.keys(paiement?.banques ?? {})].map((m) => NOMS_MOYENS[m] ?? m).join(', ');
-    const valeurs = { SERVICE: config.marque.nom, DOMAINE: origine.replace(/^https?:\/\//, ''), CONTACT_EMAIL: config.marque.courriel ?? '', PAIEMENT: moyens, ...(config.legal ?? {}) };
+    const valeurs = { SERVICE: config.marque.nom, DOMAINE: origine.replace(/^https?:\/\//, ''), CONTACT_EMAIL: config.marque.courriel ?? '', PAIEMENT: moyens, VENDEUR: vendeurLegal(lang), ...(config.legal ?? {}) };
     const manquants = new Set();
     const texte = readFileSync(f, 'utf8').replace(/\{\{(\w+)\}\}/g, (m, k) => { if (valeurs[k]) return String(valeurs[k]); manquants.add(k); return ''; });
     const aTrancher = /⚖️|À FAIRE TRANCHER/.test(texte);
@@ -618,7 +643,7 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
         if (!p) return null;
         const pp = typeof p.prepaid === 'string' ? JSON.parse(p.prepaid || 'null') : p.prepaid;
         const l = [...new Set(Object.values(banques))].filter((dv) => Number(pp?.[dv]?.month) > 0).map((dv) => ({ centimes: Number(pp[dv].month), devise: dv }));
-        if (stripe && Number(p.price) > 0) l.push({ centimes: Number(p.price), devise: 'EUR' });
+        if (stripe && Number(p.price) > 0) l.push({ centimes: Number(p.price), devise: deviseStripe });
         return l.length ? l : null;
       };
       const suite = suiteSure(url.searchParams.get('suite'));
@@ -894,6 +919,8 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
   }
 
   return {
+    // 0.6 — les moyens réellement proposés (après le contrôle du vendeur de chaque devise)
+    moyens: [...(stripe ? ['stripe'] : []), ...Object.keys(banques)],
     handler: (req, res) => handler(req, res).catch((e) => { journal.error(e); if (!res.headersSent) { res.writeHead(500, { 'content-type': 'text/plain; charset=utf-8' }); res.end('Erreur interne'); } }),
     catalogue, catalogueStripe, dialect: d, schemas: S, comptes, facturation, confirmerAdmin, reprendrePaiements,
     /** Fixe le mot de passe d'un compte depuis le serveur (mot de passe perdu) ; lève si la règle le refuse. */