@mostajs/landing
v0.2.0
Published
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 produ
Maintainers
Readme
@mostajs/landing
Auteur : Dr Hamid MADANI [email protected] · Licence : AGPL-3.0-or-later
Les landing pages de pub, de l'éditeur au produit qui les sert :
- un modèle en sept blocs (accroche, image, bénéfices, étapes, questions, bouton, mentions), validé sans dépendance ;
- un rendu HTML sans aucun script, sous 50 Ko hors images, lisible de 320 à 1 280 px, en sept langues (l'arabe de droite à gauche), avec un pied légal toujours présent ;
- un envoi signé (HMAC-SHA256, horodaté) ;
- un récepteur à monter dans le produit, pour que la page soit servie sur le domaine du produit. C'est ce qu'exigent les régies : Google refuse une annonce dont la page est sur un autre domaine (Destination mismatch).
Zéro dépendance. Node ≥ 18 (le récepteur et la signature emploient node:crypto).
Installer
npm i @mostajs/landingCôté éditeur : valider, rendre, publier
import { validerPage, rendre, decrirePage, envoyer } from '@mostajs/landing';
const page = {
slug: 'anglais-au-travail', langue: 'fr', public: 'adultes',
blocs: [
{ type: 'accroche', titre: 'Parle anglais avec assurance au travail' },
{ type: 'bouton', libelle: 'Commencer', href: '/inscription?plan=essai' },
],
};
validerPage(page); // { ok: true, erreurs: [] }
const html = rendre(page, marque); // page complète, sans script
const apercu = rendre(page, marque, { fragment: true }); // pour l'aperçu d'un éditeur
// Ce que lit verifierPage de @mostajs/ad-platforms :
const description = decrirePage(page, marque, { adresse: 'https://speaking.mostajs.dev/p/anglais-au-travail', domaineProduit: 'speaking.mostajs.dev' });
await envoyer({ origine: 'https://speaking.mostajs.dev', cle: CLE_DU_PRODUIT, page }); // { ok, status, corps }Côté produit : le récepteur
import { creerRecepteur, depotFichiers } from '@mostajs/landing';
const recepteur = creerRecepteur({
cle: () => getEnv('LANDING_CLE'), // relue à chaque envoi : renouvelable sans redémarrer
depot: depotFichiers('data/landing'), // hors du code : survit au déploiement
marque: { nom: 'Speaking', logo: '/static/logo.png', pied: { confidentialite: '/confidentialite', mentions: '/mentions-legales', editeur: '…' } },
origine: 'https://speaking.mostajs.dev',
});
// dans le routeur : if (await recepteur(req, res)) return;| Adresse | Effet |
|---|---|
| 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.
Ce que le module ne fait pas
Il ne vérifie pas les règles des régies (c'est @mostajs/ad-platforms, qui lit decrirePage), ne raccourcit pas les liens (@mostajs/short-link), et n'héberge pas les images : une image est un chemin du site du produit ou une adresse https.
