@mostajs/wagon-engine 0.1.1 → 0.3.0

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 **Auteur** : Dr Hamid MADANI <drmdh@msn.com>
 Format : Keep a Changelog ; versions : SemVer.
 
+## [0.3.0] — 2026-10-27
+
+### Ajouté
+- Les **dispositions** de `@mostajs/wagon-ui` 0.10 : une page de la charge choisit son cadre par
+  `ctx.page({ disposition: 'application' | 'console' | 'nu' | <fournie>, application, console })` ; les pages du wagon
+  (tarifs, connexion, compte…) restent en `vitrine`. Le moteur transmet `config.jetons` (rayon, police, ombre, fond),
+  le logo de `config.marque` (`logo`, `logoClair`) et `charge.dispositions` (dispositions fournies). Essai T-ENG-8.
+- `charge.accueil` peut être une **fonction** `async (ctx) => ({ titre, contenu, disposition, … })` : l'application
+  rend son propre accueil (la maquette de Speaking ouvre sur « Rejoindre mon groupe »). La fiche de données
+  `{ fr: { titre, lede, actions, preuves } }` marche toujours. Essai T-ENG-9.
+
+### Modifié
+- Dépend de `@mostajs/wagon-ui` `^0.10.0`.
+
+## [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
@@ -22,12 +22,14 @@ PAYPAL_WEBHOOK_ID · PAIEMENT_<STRIPE|CHARGILY|SATIM|PAYPAL>=off (coupe le moyen
 Moyen ACTIF = clés présentes ET commutateur ≠ off (ET, pour une banque prépayée, proposée par config.paiement.prepaye).
 
 ## CONTRAT DE LA CHARGE (charge/index.mjs)
-liens · ressources (quota { cle, limite, periode } | plafond { cle, limite, plafond: true }) · accueil · textes ·
+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 ·
 routes(req, res, ctx) (passent en premier ; true si servie) · conformite (essai de quota T-WAG-3) · amorcer() (base au
 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.3 : ctx.page({ disposition: 'vitrine'|'application'|'console'|'nu'|<fournie>, application: { retour, titre, avatar, onglets, langues }, console: { menu, contexte, utilisateur } }) (wagon-ui 0.10) ; config.jetons { rayon, police, policeTitres, ombre, fond } ; config.marque.logo / logoClair (SVG en ligne ou chemin /…).
+  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.3.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",
@@ -52,7 +52,7 @@
     "@mostajs/orm": "^2.12.1",
     "@mostajs/payment": "^2.6.0",
     "@mostajs/subscriptions-plan": "^0.9.0",
-    "@mostajs/wagon-ui": "^0.9.1",
+    "@mostajs/wagon-ui": "^0.10.0",
     "better-sqlite3": "^12.11.1",
     "stripe": "^17.7.0"
   },

package/src/wagon.mjs

@@ -187,7 +187,10 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
     // 0.9 (wagon-ui 0.6) — la feuille de style de l'application, de confiance, posée sur toutes les pages.
     css: typeof config.css === 'string' ? config.css : '',
     // 0.5 (wagon-ui 0.5) — en-tête collant, bouton d'appel, langue en menu déroulant : déclarés par wagon.config.mjs.
-    collant: config.collant === true, appel: config.appel ?? null, selecteurLangue: config.selecteurLangue ?? 'liens' });
+    collant: config.collant === true, appel: config.appel ?? null, selecteurLangue: config.selecteurLangue ?? 'liens',
+    // 0.3 (wagon-ui 0.10) — les jetons de forme, et les dispositions que la charge fournit (une page choisit son cadre
+    // par ctx.page({ disposition }) ; le logo vient de config.marque).
+    jetons: config.jetons ?? {}, dispositions: charge.dispositions ?? {} });
   const sessions = magasinSessions({ dialect: d, schema: S.Session, nom: 'wagon_session', jours: 30 });
   // 0.5 — les sessions expirées se purgent au démarrage puis toutes les six heures (auth-plug 0.3) ; les inscriptions
   // sont freinées par adresse (config.freinInscription, défaut : 10 puis 1 par minute).
@@ -499,10 +502,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 +520,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,12 +546,23 @@ 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' });
 
     // ── Les pages du wagon ──
     if (chemin === '/' && methode === 'GET') {
+      // 0.3 — l'accueil peut être une FONCTION de la charge : elle rend la page entière (titre, contenu, disposition).
+      if (typeof charge.accueil === 'function') {
+        const p = (await charge.accueil(ctx)) ?? {};
+        return envoyer(200, page({ actif: '/', ...p, titre: p.titre ?? config.marque.nom }));
+      }
       const a = charge.accueil?.[lang] ?? charge.accueil?.fr ?? { titre: config.marque.nom };
       return envoyer(200, page({ actif: '/', titre: config.marque.nom, contenu: ui.accueil({ lang, ...a }) }));
     }