@mostajs/wagon-engine 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 **Auteur** : Dr Hamid MADANI <drmdh@msn.com>
 Format : Keep a Changelog ; versions : SemVer.
 
+## [0.2.0] — 2026-10-26
+
+### Ajouté
+- `ctx.palier({ compte })` et `ctx.plafond(cle, actuel, { compte })` lisent le palier d'un compte **désigné**, et non plus seulement de celui de la session. Une requête sans session peut ainsi être bornée par le palier d'un compte : un élève qui rejoint le groupe de son école compte dans le plafond d'apprenants de l'école (Speeking). La charge ne désigne qu'un compte qu'elle a elle-même rattaché à la requête. Essai T-ENG-6.
+- `ctx.courriel(message)` permet à la charge d'envoyer un courriel par le transport du wagon (SMTP du `.env`). La fonction rend `true` si le courriel est parti, `false` sans transport ou en cas d'échec ; elle ne lève jamais d'exception. Essai T-ENG-7.
+
+## [0.1.1] — 2026-10-26
+
+### Corrigé (suite de conformité)
+Speeking, première greffe qui ne ressemble pas au gabarit, a fait apparaître trois hypothèses fausses :
+- **T-WAG-2** attendait une clé d'API à l'inscription, et un palier gratuit nommé « Gratuit ». La clé n'est attendue que si le palier gratuit en permet une (`maxCles > 0`), et le nom vient de la configuration.
+- **T-WAG-5** (API par clé) est **ignoré avec son motif** quand le palier gratuit ne donne pas de clé.
+- **T-WAG-6** montait la limite du *premier* palier payant à 777, ce qui inversait l'échelle quand un palier plus haut avait une limite plus basse (« Classe » 40, « École » 300). Il prend maintenant le palier payant à la plus grande limite finie, et le porte au-dessus de toutes les autres.
+
+Une seconde greffe d'essai, faite comme une école (`test-scripts/greffe-plafond`), rejoue la suite à chaque version.
+
 ## [0.1.0] — 2026-10-26
 
 ### Extrait

package/llms.txt

@@ -4,7 +4,7 @@
 > 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.1.0 · Licence: AGPL-3.0-or-later · Auteur: Dr Hamid MADANI <drmdh@msn.com>
+- Version: 0.2.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
 
 ## EXPORTS
@@ -27,7 +27,8 @@ routes(req, res, ctx) (passent en premier ; true si servie) · conformite (essai
 démarrage) · exporterCompte(id), effacerCompte(id) (RGPD) · sitemap() · sauvegarde() · permissions (0.11 :
 { '/page': { microphone: 'self' }, '/dossier/*': … }, garde-http ≥ 0.2).
 ctx : chemin, methode, lang, t, ui, page({ titre, contenu }), envoyer, json, rediriger, formulaire, corpsJson({ strict }),
-compte, consommer(cle), refuser(v), palier(), plafond(cle, n), admin.
+compte, consommer(cle), refuser(v), palier({ compte? }), plafond(cle, n, { compte? }), courriel({ to, subject, text, html? }) → bool, admin.
+  0.2 : { compte } = identifiant d'un compte DÉSIGNÉ (requête sans session bornée par le palier d'un compte rattaché par la charge).
 
 ## PIÈGES
 - wagon-ui ≥ 0.9 exige config.marque.auteur.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/wagon-engine",
-  "version": "0.1.0",
+  "version": "0.2.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",

package/src/conformite/conformite.test.mjs

@@ -39,6 +39,13 @@ const ESSAI = charge.conformite?.route ? charge.conformite : null;
 /** `conformite.tarifs: false` : la charge remplace /tarifs (ex. les prix de ses voyages) — les paliers n'y sont pas. */
 const TARIFS = charge.conformite?.tarifs !== false;
 const MAIL_PAYANT = 'payant@exemple.test';
+/** 0.1.1 — une clé d'API naît-elle à l'inscription ? Seulement si le palier gratuit en permet une (maxCles > 0). */
+const CLE_A_L_INSCRIPTION = Number(GRATUIT?.limits?.maxCles ?? 0) > 0;
+/** 0.1.1 — T-WAG-6 change une limite SANS inverser l'échelle : le palier payant qui a la plus grande limite finie, porté
+ *  au-dessus de toutes les autres (777 au moins). Le premier palier payant n'est pas toujours le plus haut. */
+const finie = (p) => Number(p.limits?.[LIMITE]) >= 0;
+const CIBLE = ACTIFS.filter((p) => Number(p.price) > 0 && finie(p)).sort((a, b) => Number(b.limits[LIMITE]) - Number(a.limits[LIMITE]))[0] ?? null;
+const VALEUR_ADMIN = String(Math.max(777, ...ACTIFS.filter(finie).map((p) => Number(p.limits[LIMITE]) + 1)));
 /** Un essai sans objet pour cette greffe : ignoré AVEC son motif (mjs-unit ≥ 0.8 : il entre au rapport et au compte rendu). */
 const sansObjet = (motif) => (nom, fn) => test.skip(nom, fn, `sans objet : ${motif}`);
 
@@ -133,8 +140,8 @@ test('T-WAG-2 — inscription, connexion, espace, déconnexion', async () => {
   const r = await inscrire(B, 'anis@exemple.test');
   expect(r.status).toBe(200);
   const m = r.texte.match(/sk_(?:test|live)_[0-9a-f]{64}/);
-  expect(m !== null).toBe(true);
-  cleApi = m[0];
+  expect(m !== null).toBe(CLE_A_L_INSCRIPTION);                        // pas de clé si le palier gratuit n'en donne pas
+  cleApi = m?.[0] ?? '';
   expect(r.cookie !== '').toBe(true);
   const deja = await inscrire(B, 'anis@exemple.test');
   expect(/existe déjà/i.test(deja.texte)).toBe(true);
@@ -142,9 +149,8 @@ test('T-WAG-2 — inscription, connexion, espace, déconnexion', async () => {
   const c = await connecter(B, 'anis@exemple.test');
   expect(c !== '').toBe(true);
   const e = (await req(B, '/compte', { cookie: c })).texte;
-  expect(e.includes('Gratuit')).toBe(true);
-  expect(e.includes(cleApi.slice(0, 12))).toBe(true);
-  expect(e.includes(cleApi)).toBe(false);
+  expect(e.includes(GRATUIT.name)).toBe(true);
+  if (CLE_A_L_INSCRIPTION) { expect(e.includes(cleApi.slice(0, 12))).toBe(true); expect(e.includes(cleApi)).toBe(false); }
   const d = await req(B, '/deconnexion', { method: 'POST', cookie: c, form: {} });   // 0.5 : un POST
   expect(d.status).toBe(303);
   expect((await req(B, '/compte', { cookie: c })).status).toBe(303);
@@ -238,7 +244,7 @@ test('T-WAG-2 — inscription, connexion, espace, déconnexion', async () => {
   expect(appels.sessions.length).toBe(avant);                                              // aucune session Stripe ouverte
 });
 
-test('T-WAG-5 — API par clé, révocation bornée', async () => {
+(CLE_A_L_INSCRIPTION ? test : sansObjet('le palier gratuit ne donne pas de clé d’API (maxCles 0)'))(`T-WAG-5 — API par clé, révocation bornée${CLE_A_L_INSCRIPTION ? '' : ' (sans objet : pas de clé d’API au palier gratuit)'}`, async () => {
   const moi = await req(B, '/api/v1/moi', { headers: { authorization: `Bearer ${cleApi}` } });
   expect(moi.status).toBe(200);
   expect(JSON.parse(moi.texte).compte.nom).toBe('Société anis@exemple.test');
@@ -251,7 +257,7 @@ test('T-WAG-5 — API par clé, révocation bornée', async () => {
   expect((await req(B, '/api/v1/moi', { headers: { authorization: `Bearer ${cleApi}` } })).status).toBe(401);
 });
 
-(PAYANT && LIMITE ? test : sansObjet('pas de palier payant ou pas de limite'))(`T-WAG-6 — administration : accès, paliers, échelle, usage${PAYANT && LIMITE ? '' : ' (sans objet : pas de palier payant ou pas de limite)'}`, async () => {
+(CIBLE && LIMITE ? test : sansObjet('pas de palier payant à limite finie, ou pas de limite'))(`T-WAG-6 — administration : accès, paliers, échelle, usage${CIBLE && LIMITE ? '' : ' (sans objet : pas de palier payant à limite finie, ou pas de limite)'}`, async () => {
   const client = await connecter(B, 'anis@exemple.test');
   expect((await req(B, '/admin/plans', { cookie: client })).status).toBe(404);
   await inscrire(B, 'admin@exemple.test');
@@ -260,12 +266,12 @@ test('T-WAG-5 — API par clé, révocation bornée', async () => {
   await A.w.confirmerAdmin('admin@exemple.test');
   const page = await req(B, '/admin/plans', { cookie: adm });
   expect(page.status).toBe(200);
-  expect(page.texte.includes(`name="${PAYANT.slug}.${LIMITE}"`)).toBe(true);
+  expect(page.texte.includes(`name="${CIBLE.slug}.${LIMITE}"`)).toBe(true);
   const valeurs = Object.fromEntries(config.paliers.flatMap((p) => Object.entries(p.limits).map(([k, v]) => [`${p.slug}.${k}`, String(v)])));
-  const ok = await req(B, '/admin/plans', { method: 'POST', cookie: adm, form: { ...valeurs, [`${PAYANT.slug}.${LIMITE}`]: '777' } });
+  const ok = await req(B, '/admin/plans', { method: 'POST', cookie: adm, form: { ...valeurs, [`${CIBLE.slug}.${LIMITE}`]: VALEUR_ADMIN } });
   expect(ok.status).toBe(200);
-  if (TARIFS) expect((await req(B, '/tarifs')).texte.includes('777')).toBe(true);
-  else expect((await req(B, '/admin/plans', { cookie: adm })).texte.includes('value="777"')).toBe(true);   // la valeur tient, vue de l'administration
+  if (TARIFS) expect((await req(B, '/tarifs')).texte.includes(VALEUR_ADMIN)).toBe(true);
+  else expect((await req(B, '/admin/plans', { cookie: adm })).texte.includes(`value="${VALEUR_ADMIN}"`)).toBe(true);   // la valeur tient, vue de l'administration
   // L'échelle inversée : le gratuit donnerait PLUS que le payant.
   const inverse = await req(B, '/admin/plans', { method: 'POST', cookie: adm, form: { ...valeurs, [`${GRATUIT.slug}.${LIMITE}`]: '2', [`${PAYANT.slug}.${LIMITE}`]: '1' } });
   expect(/inversée|moins/i.test(inverse.texte)).toBe(true);

package/src/wagon.mjs

@@ -499,10 +499,13 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
       const texte = v.plafond && v.limit ? v.reason : v.permanent ? t('tarifs.aucun') : v.reason;
       return envoyer(code, page({ titre: String(code), contenu: `<h1>${code}</h1><p class="msg">${esc(texte)}</p><p><a class="bouton" href="/tarifs">${esc(t('nav.tarifs'))}</a></p>` }), en);
     };
-    /** Le palier de la requête : celui du compte, sinon le palier anonyme. */
-    const palier = async () => {
-      if (compte) {
-        const a = await facturation.activePlan(String(compte.id));
+    /** Le palier de la requête : celui du compte, sinon le palier anonyme. 0.2 (wagon-engine) — `{ compte }` désigne
+     *  un AUTRE compte (son identifiant) : une requête sans session (l'élève qui rejoint son école) lit le palier de
+     *  l'école. La charge n'en fait usage que pour un compte qu'elle a elle-même rattaché à la requête. */
+    const palier = async ({ compte: designe } = {}) => {
+      const cible = designe ? { id: String(designe) } : compte;
+      if (cible) {
+        const a = await facturation.activePlan(String(cible.id));
         const l = a?.limits ?? {};
         return { slug: a?.plan?.slug ?? null, nom: a?.plan?.name ?? null, limites: typeof l === 'string' ? JSON.parse(l) : l };
       }
@@ -514,10 +517,10 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
      * une unité de plus tient dans le palier. Refus toujours définitif (403) — un stock ne se recharge pas
      * avec le temps ; il se libère (suppression, archivage) ou se relève (palier supérieur).
      */
-    const plafond = async (cle, actuel) => {
+    const plafond = async (cle, actuel, { compte: designe } = {}) => {
       const r = ressources.find((x) => x.cle === cle && x.plafond);
       if (!r) throw new Error(`ressource « ${cle} » : pas un plafond déclaré par la charge`);
-      const limite = Number((await palier()).limites?.[r.limite] ?? 0);
+      const limite = Number((await palier({ compte: designe })).limites?.[r.limite] ?? 0);
       const n = Number(actuel) || 0;
       if (limite === -1) return { allowed: true, plafond: true, resource: cle, current: n, limit: -1 };
       if (!limite) return { allowed: false, permanent: true, plafond: true, resource: cle, current: n, limit: 0, reason: 'plan does not include this resource' };
@@ -540,7 +543,13 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
     };
     // 0.3.1 — `admin` : la session est celle d'un administrateur (config.admins + WAGON_ADMINS) — pour qu'une
     // charge réserve ses outils (ex. l'outil de l'agence de travel) sans recalculer la liste.
-    const ctx = { chemin, methode, lang, t, ui, page, envoyer, json, rediriger, formulaire, corpsJson, compte, consommer, refuser, palier, plafond, admin: estAdmin && !compteCle };
+    /** 0.2 (wagon-engine) — un courriel de la charge, par le transport du wagon (SMTP du .env). Rend true s'il est parti,
+     *  false s'il n'y a pas de transport ou s'il a échoué (journalisé) : jamais une exception dans la route. */
+    const courriel = async (m) => {
+      if (!transport) return false;
+      try { await transport.envoyer(m); return true; } catch (e) { journal.warn(`wagon : courriel de la charge non parti : ${e?.message ?? e}`); return false; }
+    };
+    const ctx = { chemin, methode, lang, t, ui, page, envoyer, json, rediriger, formulaire, corpsJson, compte, consommer, refuser, palier, plafond, courriel, admin: estAdmin && !compteCle };
     if (charge.routes && (await charge.routes(req, res, ctx))) return true;
     if (chemin.startsWith('/api/')) return json(404, { ok: false, error: 'introuvable' });