@mostajs/wagon-engine 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 **Auteur** : Dr Hamid MADANI <drmdh@msn.com>
 Format : Keep a Changelog ; versions : SemVer.
 
+## [0.4.0] — 2026-10-27
+
+### Ajouté
+- **`?suite=`** sur `/inscription` et `/connexion` : la page LOCALE où revenir une fois connecté. Une charge y envoie
+  un visiteur sans compte (Speaking : `/inscription?suite=/parcours`). Après l'inscription, s'il n'y a rien à montrer
+  (pas de clé d'API, pas de paiement), le visiteur y repart connecté (303) ; une clé d'API ne se montrant qu'une fois,
+  la page « inscription faite » reste alors, avec un bouton « Continuer » vers la suite ; un paiement à faire passe
+  avant. Après la connexion par mot de passe : 303 vers la suite au lieu de `/compte`. Seul un chemin du site est
+  suivi : `//hôte`, `/\hôte`, une adresse absolue, un chemin relatif ou un caractère hors liste sont ignorés
+  (redirection ouverte). La connexion par code ou lien de courriel n'en tient pas compte (à venir). Essai T-ENG-10 ;
+  sabotages consignés (suite ignorée, garde retirée → T-ENG-10).
+
+## [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é

package/README.md

@@ -60,6 +60,11 @@ Elle contrôle les comptes, le quota, le paiement (signatures Stripe réelles, b
 node examples/verifier.mjs   # une greffe de vingt lignes démarre : paiement, paliers, texte légal, quota
 ```
 
+## Revenir où l'on était
+
+Une page de la charge qui demande un compte envoie le visiteur vers `/inscription?suite=/ma-page` (ou
+`/connexion?suite=/ma-page`) : une fois inscrit ou connecté, il y revient. Seul un chemin du site est suivi.
+
 ## Référence
 
 L'API et le contrat complet de la charge sont dans `llms.txt`.

package/llms.txt

@@ -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({ compte? }), plafond(cle, n, { compte? }), courriel({ to, subject, text, html? }) → bool, admin.
+  0.4 : /inscription?suite=/chemin et /connexion?suite=/chemin — retour à une page LOCALE après inscription (si ni clé ni paiement à montrer ; sinon bouton « Continuer ») ou connexion par mot de passe ; //hôte et adresses absolues ignorés.
+  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

package/package.json

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

@@ -69,6 +69,17 @@ const TEXTES_PAIEMENT = {
  * 0.5 (audit du 09/10/2026) — LE COMPTE DU CLIENT : changer son mot de passe, le retrouver, partir avec ses données,
  * supprimer son compte (RGPD), se déconnecter par un POST. Textes propres au gabarit, en trois langues.
  */
+/**
+ * 0.4 — `?suite=` : la page LOCALE où revenir après l'inscription ou la connexion (la charge y renvoie un visiteur
+ * sans compte, par ex. /parcours de Speaking). Seul un chemin du site est suivi — jamais `//hôte`, `/\\hôte`, ni une
+ * adresse absolue (redirection ouverte) ; sinon le comportement d'avant.
+ */
+const suiteSure = (v) => {
+  const s = String(v ?? '');
+  return s.length <= 300 && /^\/(?![\/\\])[A-Za-z0-9\-._~\/?=&%+:@!$()*,;]*$/.test(s) ? s : null;
+};
+const avecSuite = (chemin, suite) => (suite ? `${chemin}?suite=${encodeURIComponent(suite)}` : chemin);
+
 const TEXTES_COMPTE = {
   fr: { gerer: 'Mon compte', motDePasse: 'Changer mon mot de passe', actuel: 'Mot de passe actuel', nouveau: 'Nouveau mot de passe', confirmer: 'Le même, encore',
     enregistrer: 'Enregistrer', mauvais: 'Mot de passe actuel incorrect.', differents: 'Les deux saisies diffèrent.', oublie: 'Mot de passe oublié ?',
@@ -79,7 +90,7 @@ const TEXTES_COMPTE = {
     exporter: 'Télécharger mes données', supprimer: 'Supprimer mon compte', supprimerAide: 'La suppression efface votre identité et vos données ; les factures sont conservées, anonymisées, le temps exigé par la loi. Pour confirmer, saisissez votre courriel.',
     confirmation: 'Votre courriel', supprimerBouton: 'Supprimer définitivement', confirmationFausse: 'Le courriel saisi ne correspond pas.',
     abonnementActif: 'Résiliez d’abord votre abonnement (« Gérer mon abonnement »).', deconnexion: 'Se déconnecter', deconnexionAide: 'Fermer votre session sur cet appareil ?',
-    trop: 'Trop d’inscriptions depuis cette adresse : réessayez dans quelques minutes.' },
+    trop: 'Trop d’inscriptions depuis cette adresse : réessayez dans quelques minutes.' , continuer: 'Continuer' },
   en: { gerer: 'My account', motDePasse: 'Change my password', actuel: 'Current password', nouveau: 'New password', confirmer: 'The same, again',
     enregistrer: 'Save', mauvais: 'Current password is incorrect.', differents: 'The two entries differ.', oublie: 'Forgot your password?',
     oubliTitre: 'Recover access', oubliAide: 'Enter your email: if an account matches, you will receive a link to choose a new password.',
@@ -89,7 +100,7 @@ const TEXTES_COMPTE = {
     exporter: 'Download my data', supprimer: 'Delete my account', supprimerAide: 'Deletion erases your identity and your data; invoices are kept, anonymised, for the period required by law. To confirm, type your email.',
     confirmation: 'Your email', supprimerBouton: 'Delete for good', confirmationFausse: 'The email typed does not match.',
     abonnementActif: 'Cancel your subscription first (“Manage my subscription”).', deconnexion: 'Sign out', deconnexionAide: 'Close your session on this device?',
-    trop: 'Too many sign-ups from this address: try again in a few minutes.' },
+    trop: 'Too many sign-ups from this address: try again in a few minutes.' , continuer: 'Continue' },
   ar: { gerer: 'حسابي', motDePasse: 'تغيير كلمة المرور', actuel: 'كلمة المرور الحالية', nouveau: 'كلمة المرور الجديدة', confirmer: 'نفسها مرة أخرى',
     enregistrer: 'حفظ', mauvais: 'كلمة المرور الحالية غير صحيحة.', differents: 'الإدخالان مختلفان.', oublie: 'نسيت كلمة المرور؟',
     oubliTitre: 'استعادة الوصول', oubliAide: 'أدخل بريدك الإلكتروني: إن كان له حساب، ستتلقى رابطًا لاختيار كلمة مرور جديدة.',
@@ -99,7 +110,7 @@ const TEXTES_COMPTE = {
     exporter: 'تنزيل بياناتي', supprimer: 'حذف حسابي', supprimerAide: 'يمحو الحذف هويتك وبياناتك؛ وتُحفظ الفواتير مجهولة الهوية المدة التي يفرضها القانون. للتأكيد، اكتب بريدك الإلكتروني.',
     confirmation: 'بريدك الإلكتروني', supprimerBouton: 'حذف نهائي', confirmationFausse: 'البريد المكتوب غير مطابق.',
     abonnementActif: 'ألغِ اشتراكك أولًا («إدارة اشتراكي»).', deconnexion: 'تسجيل الخروج', deconnexionAide: 'إغلاق جلستك على هذا الجهاز؟',
-    trop: 'تسجيلات كثيرة من هذا العنوان: أعد المحاولة بعد دقائق.' },
+    trop: 'تسجيلات كثيرة من هذا العنوان: أعد المحاولة بعد دقائق.' , continuer: 'متابعة' },
 };
 const DOMAINES_BANQUES = {
   chargily: 'https://pay.chargily.net https://pay.chargily.com',
@@ -187,7 +198,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).
@@ -555,6 +569,11 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
 
     // ── 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 }) }));
     }
@@ -583,12 +602,14 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
     if (chemin === '/inscription') {
       const tous = await paliersEnBase();
       const palierDe = (slug) => tous.find((p) => p.slug === slug && p.active !== false) ?? tous.find((p) => p.slug === (config.planGratuit ?? 'gratuit'));
-      if (methode === 'GET') return envoyer(200, page({ titre: t('inscription.titre'), contenu: ui.inscription({ lang, palier: palierDe(url.searchParams.get('plan')), methode: methodeConnexion, minMotDePasse: motsDePasse.policy.minLength }) }));
+      const suite = suiteSure(url.searchParams.get('suite'));
+      const action = avecSuite('/inscription', suite);
+      if (methode === 'GET') return envoyer(200, page({ titre: t('inscription.titre'), contenu: ui.inscription({ lang, palier: palierDe(url.searchParams.get('plan')), methode: methodeConnexion, minMotDePasse: motsDePasse.policy.minLength, action }) }));
       if (!freinInscription.take(`ip:${ipClient(req)}`).ok) return envoyer(429, page({ titre: t('inscription.titre'), contenu: `<p class="msg">${esc((TEXTES_COMPTE[lang] ?? TEXTES_COMPTE.fr).trop)}</p>` }), { 'retry-after': '60' });
       const f = await formulaire();
       const palier = palierDe(f.plan);
       const courriel = String(f.courriel ?? '').trim().toLowerCase();
-      const refus = (m) => envoyer(200, page({ titre: t('inscription.titre'), contenu: ui.inscription({ lang, palier, erreur: m, methode: methodeConnexion, minMotDePasse: motsDePasse.policy.minLength }) }));
+      const refus = (m) => envoyer(200, page({ titre: t('inscription.titre'), contenu: ui.inscription({ lang, palier, erreur: m, methode: methodeConnexion, minMotDePasse: motsDePasse.policy.minLength, action }) }));
       if (!COURRIEL.test(courriel) || !String(f.nom ?? '').trim()) return refus(t('inscription.courrielAide'));
       if (await d.findOne(S.User, { email: courriel })) return refus(t('inscription.deja'));
       if (methodeConnexion === 'motdepasse') {
@@ -602,19 +623,25 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
       let cle = null;
       try { cle = (await comptes.cles.creer(String(c.id), { label: t('espace.vosCles'), portees: {} })).full; } catch (e) { if (e.code !== 'PLAFOND_CLES') throw e; }
       const paiement = Number(palier?.price) > 0 ? { compteId: String(c.id), planSlug: palier.slug } : null;
-      const contenu = ui.inscriptionFaite({ lang, cle, base: origine, paiement });
+      // 0.4 — ?suite= : rien à montrer (ni clé, ni paiement) → on y repart, connecté ; une clé se montre UNE fois, donc
+      // la page reste, avec « Continuer » vers la suite. Un paiement à faire passe avant la suite.
+      if (suite && !cle && !paiement && methodeConnexion === 'motdepasse') return ouvrirSession(utilisateur.id, suite);
+      const continuer = suite && !paiement ? `<p><a class="btn" href="${esc(suite)}">${esc((TEXTES_COMPTE[lang] ?? TEXTES_COMPTE.fr).continuer)}</a></p>` : '';
+      const contenu = ui.inscriptionFaite({ lang, cle, base: origine, paiement }) + continuer;
       if (methodeConnexion === 'code') return envoyer(200, page({ titre: t('inscription.faite'), contenu }));
       return envoyer(200, page({ titre: t('inscription.faite'), contenu }), { 'set-cookie': cookieStrict('wagon_session', await sessions.ouvrir(utilisateur.id), { maxAge: 30 * 86400, https }) });
     }
 
     // La connexion : mot de passe, ou code + lien par courriel. Un refus ne dit jamais lequel était faux.
     if (chemin === '/connexion') {
-      if (methode === 'GET') return envoyer(200, page({ titre: t('espace.seConnecter'), contenu: ui.connexion({ lang, methode: methodeConnexion }) + (oubliPossible ? `<p class="hint"><a href="/connexion/oubli">${esc(TC.oublie)}</a></p>` : '') }));
+      const suite = suiteSure(url.searchParams.get('suite'));
+      const action = avecSuite('/connexion', suite);
+      if (methode === 'GET') return envoyer(200, page({ titre: t('espace.seConnecter'), contenu: ui.connexion({ lang, methode: methodeConnexion, action }) + (oubliPossible ? `<p class="hint"><a href="/connexion/oubli">${esc(TC.oublie)}</a></p>` : '') }));
       const f = await formulaire();
       if (methodeConnexion === 'motdepasse') {
         const r = await motsDePasse.login(String(f.courriel ?? ''), String(f.motdepasse ?? ''), { ip: ipClient(req) });
-        if (r.ok) return ouvrirSession(r.userId);
-        return envoyer(r.reason === 'throttled' ? 429 : 200, page({ titre: t('espace.seConnecter'), contenu: ui.connexion({ lang, erreur: t('espace.identifiantsFaux') }) }));
+        if (r.ok) return ouvrirSession(r.userId, suite ?? '/compte');
+        return envoyer(r.reason === 'throttled' ? 429 : 200, page({ titre: t('espace.seConnecter'), contenu: ui.connexion({ lang, erreur: t('espace.identifiantsFaux'), action }) }));
       }
       const courriel = String(f.courriel ?? '').trim().toLowerCase();
       const dfi = await codes.request(courriel, { ip: ipClient(req) });