@mostajs/licensing-ui-html 0.1.0

package/README.md

@@ -0,0 +1,14 @@
+# @mostajs/licensing-ui-html
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Licence** : AGPL-3.0-or-later
+
+Vues HTML **server-rendered** de licence (statut, activation, gate) pour apps **sans build / sans
+React** (node:http…). Rend des **fragments** ; l'app les enveloppe dans son shell. La logique reste
+dans `@mostajs/licensing`. **Config pilotée par `.env`.**
+
+```js
+import { licenseStatusView, activationForm, licenseBlockedView } from '@mostajs/licensing-ui-html';
+res.end(page(session, 'Licence', licenseStatusView({ status: app.license.status() })));
+```
+
+Tests & exemple (§11.1 / §12) : `npm install && npm test`. Variante React : `@mostajs/licensing-ui`.

package/llms.txt

@@ -0,0 +1,31 @@
+# @mostajs/licensing-ui-html — fiche LLM
+> Vues HTML server-rendered de licence (statut, activation, gate) pour apps SANS build/React (node:http).
+
+- Version: 0.1.0 · Licence: AGPL-3.0-or-later · Auteur: Dr Hamid MADANI <drmdh@msn.com>
+- Stack: mosta-licensing-stack · Logique: @mostajs/licensing · Variante React: @mostajs/licensing-ui
+
+## RÔLE
+Rend des FRAGMENTS HTML (pas de page, pas de React, pas de dépendance lourde) que l'app enveloppe
+dans son shell. AUCUNE logique métier : l'app passe le STATUT (produit par @mostajs/licensing) et
+les URLs d'action. Pour Salsabil & toute app no-build.
+
+## EXPORTS
+- licenseBadge(status) -> html
+- licenseStatusView({ status, activateHref? }) -> html
+- activationForm({ action?, requestAction?, serverUrl?, project?, error?, success? }) -> html
+- licenseBlockedView({ status, activateHref? }) -> html   (gate quand licence invalide + enforce)
+
+## STATUT attendu (de @mostajs/licensing / app)
+{ valid, status, reason?, expiresAt?, daysLeft?, source?, enforce?, project? }
+
+## COMPOSITION (app no-build, ex. Salsabil)
+- Logique : @mostajs/licensing (createLicenseClient pour activate/requestCode ; checkLicense pour vérif).
+- Rendu : ces fragments → enveloppés dans le shell de l'app (app-shell-ui page()).
+- Routes typiques : GET /license (licenseStatusView), GET /license/activate (activationForm),
+  POST /license/activate (client.activate → persister la licence signée), gate (licenseBlockedView).
+
+## CONFIG .env (côté app)
+LICENSE_SERVER_URL, LICENSE_PROJECT, LICENSE_PUBLIC_KEY, LICENSE, LICENSE_ENFORCE.
+
+## SÉCURITÉ
+Échappe tout libellé (anti-injection). La clé privée reste chez l'éditeur.

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@mostajs/licensing-ui-html",
+  "version": "0.1.0",
+  "description": "Vues HTML server-rendered de licence (statut, activation, gate) pour apps SANS build/React (node:http). Compose @mostajs/licensing.",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "llms.txt"
+  ],
+  "keywords": [
+    "license",
+    "licence",
+    "html",
+    "ssr",
+    "no-build",
+    "mostajs"
+  ],
+  "devDependencies": {
+    "@mostajs/mjs-unit": "^0.3.0"
+  },
+  "scripts": {
+    "test": "node test-scripts/unit/licensing-ui-html.test.mjs && node examples/run.mjs"
+  }
+}

package/src/index.js

@@ -0,0 +1,58 @@
+// @mostajs/licensing-ui-html — vues HTML server-rendered de licence (fragments réutilisables).
+// Pour apps SANS build/React (node:http…). Rend des FRAGMENTS ; l'app les enveloppe dans son shell.
+// La logique reste dans @mostajs/licensing (vérif/activation) ; ici, AUCUNE logique métier.
+// @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+
+const esc = (s) => String(s ?? '').replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
+
+/** Petit badge d'état. */
+export function licenseBadge(status = {}) {
+  const ok = status.valid;
+  const style = ok ? 'background:#eef7ee;border:1px solid #cce5cc' : 'background:#fdecec;border:1px solid #f5c2c2';
+  return `<span style="padding:4px 10px;border-radius:8px;${style}">${ok ? '✅' : '⛔'} ${esc(status.status || (ok ? 'ACTIVE' : 'INVALID'))}</span>`;
+}
+
+/** Vue STATUT complète (fragment). */
+export function licenseStatusView({ status = {}, activateHref = '/license/activate' } = {}) {
+  return `<h1>📜 Licence — ${esc(status.project || 'app')}</h1>
+    <p>${licenseBadge(status)}${status.reason ? ` — ${esc(status.reason)}` : ''}</p>
+    <ul>
+      <li>Statut : <strong>${esc(status.status || '')}</strong></li>
+      ${status.expiresAt ? `<li>Échéance : <strong>${esc(String(status.expiresAt).slice(0, 10))}</strong>${status.daysLeft != null ? ` — <strong>${status.daysLeft}</strong> j restants` : ''}</li>` : ''}
+      <li>Source : ${esc(status.source || '')} · Mode : ${status.enforce ? '<strong>bloquant</strong>' : 'informatif'}</li>
+    </ul>
+    ${!status.valid ? `<p><a href="${esc(activateHref)}">→ Activer la licence</a></p>` : ''}`;
+}
+
+/** Formulaire d'ACTIVATION (demande de code + activation par code/fichier). */
+export function activationForm({ action = '/license/activate', requestAction = '/license/request-code', serverUrl = 'https://licences.amia.fr', project = 'app', error = null, success = null } = {}) {
+  return `<h1>🔑 Activer la licence — ${esc(project)}</h1>
+    ${error ? `<p role="alert" style="padding:8px 12px;border-radius:8px;background:#fdecec;border:1px solid #f5c2c2">${esc(error)}</p>` : ''}
+    ${success ? `<p style="padding:8px 12px;border-radius:8px;background:#eef7ee;border:1px solid #cce5cc">${esc(success)}</p>` : ''}
+    <h2>Activation automatique</h2>
+    <p class="muted">Saisissez votre email et votre organisation : l'application <strong>télécharge et active</strong> la licence depuis le serveur, sans intervention.</p>
+    <form method="post" action="${esc(requestAction)}">
+      <p><label>Email <input type="email" name="email" required placeholder="vous@asso.dz"></label>
+         <label>Organisation <input name="company" required placeholder="Association…"></label>
+         <button>⬇️ Télécharger et activer la licence</button></p>
+    </form>
+    <details style="margin-top:10px">
+      <summary>J'ai déjà un code d'activation</summary>
+      <form method="post" action="${esc(action)}" style="margin-top:8px">
+        <p><label>Code d'activation <input name="activationCode" required placeholder="XXXX-XXXX-XXXX-XXXX" pattern="[A-Za-z0-9-]+"></label>
+           <button>✅ Activer avec le code</button></p>
+      </form>
+    </details>
+    <p class="muted">Serveur de licences : <a href="${esc(serverUrl)}" target="_blank" rel="noopener">${esc(serverUrl)}</a>. Projet : <strong>${esc(project)}</strong>. Config pilotée par <code>.env</code>.</p>
+    <p><a href="/license">‹ Statut</a></p>`;
+}
+
+/** Vue de BLOCAGE (gate) — affichée quand la licence est invalide et l'enforcement actif. */
+export function licenseBlockedView({ status = {}, activateHref = '/license/activate' } = {}) {
+  return `<h1>⛔ Accès suspendu — licence ${esc(status.status || 'invalide')}</h1>
+    <p>${esc(status.reason || 'La licence de cette installation n’est pas valide.')}</p>
+    <p>Veuillez <a href="${esc(activateHref)}">activer une licence</a> pour continuer.</p>
+    <p class="muted">Administrateur : générer/renouveler via <code>scripts/issue-license.mjs</code> ou activer en ligne depuis le serveur de licences.</p>`;
+}
+
+export default { licenseBadge, licenseStatusView, activationForm, licenseBlockedView };