@mostajs/wagon-engine 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 **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é)

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.1",
+  "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/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' });