@mostajs/wagon-engine 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 **Auteur** : Dr Hamid MADANI <drmdh@msn.com>
 Format : Keep a Changelog ; versions : SemVer.
 
+## [0.6.1] — 2026-10-28
+
+### Corrigé
+- **/compte d'une période prépayée dit ce qui a été payé** : le montant et la monnaie de la commande réglée
+  (`Payment`, @mostajs/payment), et sa durée (« Classe — 8 000 DZD — 1 mois »), au lieu du prix Stripe en euros par
+  mois. Relevé par le fondateur après un paiement Chargily sur Speaking. Sans commande retrouvée, le prix prépayé du
+  palier dans la monnaie de la banque. Les paiements prépayés réglés figurent parmi « Vos factures ».
+- Le dinar s'affiche sans décimales (« 8 000 DZD »), comme dans wagon-ui, aussi sur l'écran du choix du paiement.
+- Essais : T-ENG-15 ; T-WAG-13 (suite de conformité) vérifie le montant prépayé dans /compte.
+
+### Dépendances
+- `@mostajs/wagon-ui` ^0.11.1.
+
 ## [0.6.0] — 2026-10-28
 
 ### Ajouté

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/wagon-engine",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "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.7.0",
     "@mostajs/subscriptions-plan": "^0.9.0",
-    "@mostajs/wagon-ui": "^0.11.0",
+    "@mostajs/wagon-ui": "^0.11.1",
     "better-sqlite3": "^12.11.1",
     "stripe": "^17.7.0"
   },

package/src/conformite/conformite.test.mjs

@@ -590,6 +590,11 @@ const PRIX_DZD = PAYANT && (PAYANT.prepaid ?? {}).DZD?.month;
   const compte = (await req(base, '/compte', { cookie: c })).texte;
   expect(compte.includes(PAYANT.name)).toBe(true);
   expect(/payé jusqu’au/.test(compte)).toBe(true);
+  // 0.6.1 — le palier dit ce qui a été payé, dans la monnaie de la banque ; pas le prix Stripe en euros (défaut du 28/10/2026)
+  const [, devise, prixPrepaye] = OFFRE;
+  const sansEspace = (x) => x.replace(/[\s\u00a0\u202f]/g, '');
+  expect(sansEspace(compte).includes(sansEspace(String(Number(prixPrepaye.month) / 100)))).toBe(true);
+  expect([compte.includes(devise) || compte.includes('DA') || compte.includes('€'), Number(PAYANT.price) > 0 && devise !== 'EUR' ? compte.includes('€') : false]).toEqual([true, false]);
   expect((await webhook('ok')).status).toBe(200);                                         // rejeu sans effet
   expect((await req(base, '/api/paiement/webhook/inconnue', { method: 'POST', json: '{}', headers: { 'content-type': 'application/json' } })).status).toBe(404);
   await C.fermer();

package/src/wagon.mjs

@@ -118,7 +118,9 @@ const DOMAINES_BANQUES = {
   paypal: 'https://www.paypal.com https://www.sandbox.paypal.com',
   satim: 'https://cib.satim.dz https://test.satim.dz',
 };
-const montant = (mineures, devise, lang) => formatNumber(resolveFormatLocale(lang), Number(mineures) / 100, { style: 'currency', currency: devise });
+// 0.6.1 — le dinar sans décimales, comme on l'écrit en Algérie (et comme wagon-ui ≥ 0.10.1) : « 8 000 DZD ».
+const montant = (mineures, devise, lang) => formatNumber(resolveFormatLocale(lang), Number(mineures) / 100,
+  { style: 'currency', currency: devise, ...(devise === 'DZD' ? { maximumFractionDigits: 0, minimumFractionDigits: 0 } : {}) });
 
 /** Le message d'un PLAFOND atteint (wagon-ui n'a que celui des clés d'API). */
 const PLAFOND_ATTEINT = { fr: 'Plafond de votre palier atteint : {n} ({ressource}).', en: 'Your tier limit is reached: {n} ({ressource}).', ar: 'بلغتَ حدّ فئتك: {n} ({ressource}).' };
@@ -380,7 +382,36 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
     return servis.get(lang);
   };
 
-  async function vueEspace(compte) {
+  /**
+   * 0.6.1 — ce qui a été PAYÉ pour une période prépayée (Chargily, SATIM…) : le montant et la monnaie de la commande, et sa
+   * durée. /compte montrait le prix Stripe en euros par mois à une école qui avait payé 8 000 DZD (28/10/2026).
+   */
+  async function tarifPrepaye(sub, plan, lang) {
+    if (!sub?.provider || sub.stripeSubId || sub.provider === 'stripe') return null;
+    const T = TEXTES_PAIEMENT[lang] ?? TEXTES_PAIEMENT.fr;
+    const dire = (centimes, devise, periode) => `${montant(centimes, String(devise).toUpperCase(), lang)}${T[periode] ? ` — ${T[periode]}` : ''}`;
+    // La commande payée (@mostajs/payment la garde) ; sinon, le prix prépayé du palier dans la monnaie de la banque.
+    const p = sub.prepaidOrderId ? await d.findOne(S.Payment, { orderId: String(sub.prepaidOrderId) }).catch(() => null) : null;
+    if (p && Number(p.amount) > 0) {
+      const meta = typeof p.metadata === 'string' ? JSON.parse(p.metadata || '{}') : (p.metadata ?? {});
+      return dire(Math.round(Number(p.amount) * 100), p.currency, meta.wagon_periode);
+    }
+    const devise = banques[sub.provider];
+    const pp = typeof plan?.prepaid === 'string' ? JSON.parse(plan.prepaid || 'null') : plan?.prepaid;
+    const jours = (new Date(sub.currentPeriodEnd).getTime() - new Date(sub.currentPeriodStart).getTime()) / 86400000;
+    const periode = jours >= 300 ? 'year' : 'month';
+    const centimes = Number(pp?.[devise]?.[periode]);
+    return devise && centimes > 0 ? dire(centimes, devise, periode) : null;
+  }
+  /** 0.6.1 — les paiements prépayés réglés du compte, parmi les factures (montant en unités mineures, comme Stripe). */
+  async function paiementsPrepayes(compte) {
+    return (await d.find(S.Payment, { status: 'paid' }).catch(() => [])).filter((p) => {
+      const meta = typeof p.metadata === 'string' ? JSON.parse(p.metadata || '{}') : (p.metadata ?? {});
+      return String(meta[META.account] ?? '') === String(compte.id);
+    }).map((p) => ({ createdAt: p.createdAt, amount: Math.round(Number(p.amount) * 100), currency: p.currency, status: 'paid', hostedUrl: null }));
+  }
+
+  async function vueEspace(compte, lang = 'fr') {
     const actif = await facturation.activePlan(String(compte.id));
     const quotas = {};
     for (const r of periodiques) {
@@ -388,8 +419,10 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
       quotas[r.cle] = { courant: v.current, limite: v.limit === -1 ? null : v.limit, restant: v.limit === -1 ? null : Math.max(0, v.limit - v.current) };
     }
     const cles = (await comptes.cles.lister(String(compte.id))).map((c) => ({ prefix: c.prefix, label: c.label, enabled: c.enabled, usageCount: c.usageCount }));
-    const factures = (await d.find(S.Invoice, { account: String(compte.id) })).map((f) => ({ createdAt: f.createdAt, amount: f.amount, currency: f.currency, status: f.status, hostedUrl: f.hostedUrl }));
-    return { plan: actif?.plan ?? null, quotas, cles, factures, portailPossible: !!(stripe && compte.stripeCustomerId), limites: actif?.limits ?? {} };
+    const factures = [...(await d.find(S.Invoice, { account: String(compte.id) })).map((f) => ({ createdAt: f.createdAt, amount: f.amount, currency: f.currency, status: f.status, hostedUrl: f.hostedUrl })),
+      ...(await paiementsPrepayes(compte))].sort((a, b) => String(b.createdAt ?? '').localeCompare(String(a.createdAt ?? '')));
+    const tarif = await tarifPrepaye(actif?.subscription, actif?.plan, lang);
+    return { plan: actif?.plan ?? null, ...(tarif ? { tarif } : {}), quotas, cles, factures, portailPossible: !!(stripe && compte.stripeCustomerId), limites: actif?.limits ?? {} };
   }
 
   /**
@@ -754,7 +787,7 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
         const fin = sub?.currentPeriodEnd && !sub?.stripeSubId && Number(actif?.plan?.price) > 0
           ? `<p class="hint">${esc(T.jusquau.replace('{plan}', actif.plan.name).replace('{date}', new Date(sub.currentPeriodEnd).toLocaleDateString(resolveFormatLocale(lang), { day: 'numeric', month: 'long', year: 'numeric' })))}</p>` : '';
         const gestion = `<section class="gestion-compte"><h2>${esc(TC.gerer)}</h2><ul>${methodeConnexion === 'motdepasse' ? `<li><a href="/compte/mot-de-passe">${esc(TC.motDePasse)}</a></li>` : ''}<li><a href="/compte/export">${esc(TC.exporter)}</a></li><li><a href="/compte/supprimer">${esc(TC.supprimer)}</a></li></ul><form method="post" action="/deconnexion"><button class="bouton">${esc(TC.deconnexion)}</button></form></section>`;
-        return envoyer(200, page({ actif: '/compte', titre: t('espace.compte'), contenu: ui.espace({ lang, vue: await vueEspace(c) }) + fin + gestion }));
+        return envoyer(200, page({ actif: '/compte', titre: t('espace.compte'), contenu: ui.espace({ lang, vue: await vueEspace(c, lang) }) + fin + gestion }));
       }
       // 0.5 — changer son mot de passe : l'actuel d'abord ; les AUTRES sessions sont fermées, celle-ci rouverte.
       if (chemin === '/compte/mot-de-passe' && methodeConnexion === 'motdepasse') {
@@ -773,7 +806,7 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
       // 0.5 — partir avec ses données (RGPD, portabilité) : un fichier JSON.
       if (chemin === '/compte/export' && methode === 'GET') {
         const u = await d.findOne(S.User, { email: String(qui.utilisateur.courriel) });
-        const vue = await vueEspace(c);
+        const vue = await vueEspace(c, lang);
         const donnees = {
           exporteLe: new Date().toISOString(), service: config.marque.nom,
           utilisateur: { courriel: u?.email, prenom: u?.firstName, nom: u?.lastName, langue: u?.locale, creeLe: u?.createdAt },
@@ -813,8 +846,8 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
         const f = await formulaire();
         try {
           const k = await comptes.cles.creer(String(c.id), { label: String(f.libelle ?? '').slice(0, 60), portees: {} });
-          return envoyer(200, page({ actif: '/compte', titre: t('espace.compte'), contenu: ui.espace({ lang, vue: await vueEspace(c), cleNeuve: k.full }) }));
-        } catch (e) { return envoyer(200, page({ actif: '/compte', titre: t('espace.compte'), contenu: ui.espace({ lang, vue: await vueEspace(c), erreur: e.code === 'PLAFOND_CLES' ? t('espace.plafondAtteint', { n: (await vueEspace(c)).limites.maxCles }) : e.message }) })); }
+          return envoyer(200, page({ actif: '/compte', titre: t('espace.compte'), contenu: ui.espace({ lang, vue: await vueEspace(c, lang), cleNeuve: k.full }) }));
+        } catch (e) { return envoyer(200, page({ actif: '/compte', titre: t('espace.compte'), contenu: ui.espace({ lang, vue: await vueEspace(c, lang), erreur: e.code === 'PLAFOND_CLES' ? t('espace.plafondAtteint', { n: (await vueEspace(c, lang)).limites.maxCles }) : e.message }) })); }
       }
       if (chemin === '/compte/cles/revoquer' && methode === 'POST') {
         await comptes.cles.revoquer(String(c.id), String((await formulaire()).prefix ?? ''));