@mostajs/landing 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 **Auteur** : Dr Hamid MADANI <drmdh@msn.com>
 
+## [0.2.0] — 2026-11-01
+### Ajouté
+- Récepteur : `apresVisite` (chaque page servie, compté après l'envoi) et `statistiques` (GET `_stats`, signé, nombres seulement) ; client `lireStatistiques`. Demandé par LinksFly, lot 5 (SPEC-LP-31, 33).
+
 ## [0.1.0] — 2026-10-31
 ### Ajouté
 - Modèle en sept blocs et sa validation ; sept langues, arabe de droite à gauche ; public « adultes » ou « écoles ».

package/README.md

@@ -56,6 +56,7 @@ const recepteur = creerRecepteur({
 | `POST /p/_publier` | corps `{ page }` signé → 201 `{ slug, version, adresse }` ; 401 si la signature est fausse, absente, périmée ou le corps altéré ; 422 si la page est invalide |
 | `POST /p/_retirer` | corps `{ slug }` signé → la page n'est plus servie (ses versions restent) |
 | `GET /p/_marque` | la marque publique du produit (nom, logo, couleurs, pied légal) : l'éditeur y voit que le récepteur est installé |
+| `GET /p/_stats?jours=30` | 0.2 — signé : les nombres de visites et d'inscriptions par jour et par source (`statistiques`) ; jamais une donnée personnelle |
 | `GET /p/<slug>` | la dernière version, rendue avec la **marque du produit** ; `Cache-Control: public, max-age=60` ; 404 sinon |
 
 Le bouton de la page recopie dans son lien les UTM et identifiants de clic (`fbclid`, `gclid`, `gbraid`, `wbraid`, `ttclid`, `ScCid`) de l'adresse reçue : la source arrive jusqu'à l'inscription sans cookie ni script.

package/llms.txt

@@ -1,7 +1,7 @@
 # @mostajs/landing — fiche LLM
 > Landing pages de pub : modèle en 7 blocs, rendu HTML sans script (< 50 Ko, pied légal, 7 langues, arabe rtl), envoi signé HMAC, récepteur monté dans le produit (page servie sur SON domaine). Zéro dépendance.
 
-- 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-ads-stack/mosta-landing · ESM · Node ≥ 18 (node:crypto, node:fs)
 - Niveau §5.bis : N1 · technique · multi-domaine · depend_de []
 - Consommateurs : LinksFly (Entreprise/ads, éditeur et publication), Speaking (récepteur /p/)
@@ -11,8 +11,9 @@
 - Rendu : `rendre(page, marque, { requete?, fragment?, canonique?, sansImages? })` → HTML ; `decrirePage(page, marque, { adresse, domaineProduit, langueCampagne?, accrocheAnnonce?, html? })` → description lue par `verifierPage` d'ad-platforms ; `lienAvecSource(href, requete)` ; `A_CONSERVER` ; `esc`
 - Textes : `TEXTES`, `textesDe(l)` (titres par défaut, pied légal)
 - Signature : `signer(corps, cle)` → 't=<s>,v1=<hex>' ; `verifierSignature(brut, entete, cle, { tolerance=300 })` → { ok } | { ok:false, motif: absente|illisible|perimee|fausse } ; `ENTETE_SIGNATURE` = 'x-landing-signature'
-- Récepteur : `creerRecepteur({ cle: string|fn, depot, marque: obj|fn, prefixe='/p/', maxOctets=256Ko, origine, journal })` → async (req, res, chemin?) → bool ; sert POST _publier, POST _retirer, GET _marque (marque publique), GET <slug>
+- Récepteur : `creerRecepteur({ cle: string|fn, depot, marque: obj|fn, prefixe='/p/', maxOctets=256Ko, origine, journal, apresVisite?, statistiques? })` — 0.2 : apresVisite({ slug, version, requete, req }) après chaque page servie (200) ; statistiques(jours) → lignes de GET _stats (signé sur « GET <chemin>?<requête> ») → async (req, res, chemin?) → bool ; sert POST _publier, POST _retirer, GET _marque (marque publique), GET <slug>
 - Dépôts : `depotMemoire({ garder=20 })`, `depotFichiers(dossier, { garder=20 })` — { enregistrer(page) → {slug,version}, derniere(slug), versions(slug), retirer(slug) }
+- Statistiques : `lireStatistiques({ origine, cle, jours=30, prefixe })` → { ok, status, corps: { jours, lignes } } (0.2)
 - Envoi : `envoyer({ origine, cle, page? | retirer?, prefixe, fetch?, delai=10000 })` → { ok, status, corps }
 
 ## PAGE

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/landing",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Landing pages de pub : modèle en sept blocs (accroche, image, bénéfices, étapes, questions, bouton, mentions), rendu HTML sans script sous 50 Ko avec pied légal, sept langues dont l'arabe de droite à gauche, envoi signé HMAC, récepteur monté dans le produit qui sert la page sur son propre domaine. Zéro dépendance.",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
   "license": "AGPL-3.0-or-later",
@@ -22,7 +22,14 @@
     "CHANGELOG.md",
     "LICENSE"
   ],
-  "keywords": ["landing-page", "ads", "utm", "hmac", "rtl", "mostajs"],
+  "keywords": [
+    "landing-page",
+    "ads",
+    "utm",
+    "hmac",
+    "rtl",
+    "mostajs"
+  ],
   "mostajs": {
     "niveau": "N1",
     "nature": "technique",

package/src/index.js

@@ -8,4 +8,4 @@ export { rendre, decrirePage, lienAvecSource, A_CONSERVER, esc } from './rendre.
 export { signer, verifierSignature, ENTETE_SIGNATURE } from './signature.js'
 export { creerRecepteur } from './recepteur.js'
 export { depotMemoire, depotFichiers } from './depots.js'
-export { envoyer } from './publier.js'
+export { envoyer, lireStatistiques } from './publier.js'

package/src/publier.js

@@ -16,3 +16,15 @@ export async function envoyer({ origine, cle, page, retirer, prefixe = '/p/', fe
   let lu = null; try { lu = await r.json() } catch { /* corps non JSON */ }
   return { ok: r.status === 201 || r.status === 200, status: r.status, corps: lu }
 }
+
+/**
+ * 0.2 — lire les statistiques d'un produit (GET <prefixe>_stats, signé avec sa clé).
+ * @returns {Promise<{ ok: boolean, status: number, corps: any }>}
+ */
+export async function lireStatistiques({ origine, cle, jours = 30, prefixe = '/p/', fetch: f = globalThis.fetch, delai = 10000 }) {
+  const chemin = `${prefixe}_stats`
+  const requete = new URLSearchParams({ jours: String(jours) }).toString()
+  const r = await f(`${String(origine).replace(/\/+$/, '')}${chemin}?${requete}`, { headers: { [ENTETE_SIGNATURE]: signer(`GET ${chemin}?${requete}`, cle) }, signal: AbortSignal.timeout(delai), redirect: 'manual' })
+  let lu = null; try { lu = await r.json() } catch { /* corps non JSON */ }
+  return { ok: r.status === 200, status: r.status, corps: lu }
+}

package/src/recepteur.js

@@ -4,6 +4,9 @@
  *   POST <prefixe>_retirer   corps JSON { slug } signé → 200 ; la page n'est plus servie
  *   GET  <prefixe>_marque    la marque PUBLIQUE du produit (nom, logo, couleurs, pied légal) : l'éditeur s'en sert pour
  *                            l'aperçu et la conformité, et y voit que le récepteur est installé
+ *   GET  <prefixe>_stats     0.2 — signé (même clé, sur « GET <chemin>?<requête> ») : les NOMBRES de visites et d'inscriptions
+ *                            par jour et par source, fournis par `statistiques(jours)` ; jamais un compte ni une donnée
+ *                            personnelle. 404 si le produit n'en fournit pas.
  *   GET  <prefixe><slug>     la dernière version, rendue avec la MARQUE du produit (pied légal compris) ; 404 sinon
  * Signature fausse, absente, périmée ou corps altéré → 401, rien n'est gardé. Page invalide → 422. Corps trop gros → 413.
  * @author Dr Hamid MADANI <drmdh@msn.com>
@@ -21,12 +24,14 @@ const json = (res, code, o) => { res.writeHead(code, { 'content-type': 'applicat
 
 /**
  * @param {{ cle: string|(() => string), depot: object, marque: object|(() => object), prefixe?: string, maxOctets?: number,
- *   origine?: string, journal?: Pick<Console,'warn'> }} o
+ *   origine?: string, journal?: Pick<Console,'warn'>, apresVisite?: (e) => any, statistiques?: (jours: number) => Promise<object[]> }} o
+ *   apresVisite : 0.2 — appelé APRÈS l'envoi d'une page (200) : { slug, version, requete: URLSearchParams, req } ; une
+ *     erreur n'atteint pas le visiteur ; statistiques : 0.2 — les lignes de /_stats
  *   cle : la clé de publication du produit (lue à chaque envoi : elle peut être renouvelée sans redémarrer)
  *   origine : adresse publique du produit (https://speaking.mostajs.dev), pour l'adresse rendue et la canonique
  * @returns {(req, res, chemin?: string) => Promise<boolean>} true si la requête est servie
  */
-export function creerRecepteur({ cle, depot, marque, prefixe = '/p/', maxOctets = 256 * 1024, origine = '', journal = console }) {
+export function creerRecepteur({ cle, depot, marque, prefixe = '/p/', maxOctets = 256 * 1024, origine = '', journal = console, apresVisite = null, statistiques = null }) {
   if (!depot) throw new Error('landing : un dépôt est requis')
   const cleDe = () => (typeof cle === 'function' ? cle() : cle)
   const marqueDe = () => (typeof marque === 'function' ? marque() : marque) ?? {}
@@ -50,6 +55,14 @@ export function creerRecepteur({ cle, depot, marque, prefixe = '/p/', maxOctets
       return json(res, 201, { slug, version, adresse: `${origine}${prefixe}${slug}` })
     }
 
+    if (req.method === 'GET' && suite === '_stats') {
+      if (typeof statistiques !== 'function') return json(res, 404, { error: 'statistiques non fournies' })
+      const v = verifierSignature(`GET ${p}?${url.searchParams.toString()}`, req.headers[ENTETE_SIGNATURE], cleDe())
+      if (!v.ok) return json(res, 401, { error: 'signature refusée', motif: v.motif })
+      const jours = Math.min(400, Math.max(1, Number(url.searchParams.get('jours')) || 30))
+      return json(res, 200, { jours, lignes: await statistiques(jours) })
+    }
+
     if (req.method === 'GET' && suite === '_marque') {
       const m = marqueDe()
       return json(res, 200, { recepteur: '@mostajs/landing', nom: m.nom ?? '', logo: m.logo ?? '', couleurs: m.couleurs ?? {}, pied: m.pied ?? {}, prefixe })
@@ -61,6 +74,9 @@ export function creerRecepteur({ cle, depot, marque, prefixe = '/p/', maxOctets
       const html = rendre(d.page, marqueDe(), { requete: url.searchParams, canonique: origine ? `${origine}${prefixe}${suite}` : '' })
       res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'public, max-age=60', 'x-landing-version': String(d.version) })
       res.end(req.method === 'HEAD' ? undefined : html)
+      if (req.method === 'GET' && typeof apresVisite === 'function') {
+        setImmediate(() => { Promise.resolve().then(() => apresVisite({ slug: suite, version: d.version, requete: url.searchParams, req })).catch((e) => journal.warn?.(`landing : visite non comptée (${e?.message ?? e})`)) })
+      }
       return true
     }
     return false