@mostajs/licensing-ui-env 0.1.0

package/README.md

@@ -0,0 +1,15 @@
+# @mostajs/licensing-ui-env
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Licence** : AGPL-3.0-or-later
+
+Service de licence **piloté par `.env`** (statut, activation en ligne, persistance) — **extrait de
+l'app Salsabil** (`src/license.mjs`) et **composant `@mostajs/licensing`**. Sans framework (no-build).
+
+```js
+import { createLicenseEnv } from '@mostajs/licensing-ui-env';
+const lic = createLicenseEnv({ env: process.env, defaultProject: 'salsabil' });
+lic.status();                 // { valid, status, expiresAt, daysLeft, serverUrl, … }
+await lic.activate(code);     // active via licences.amia.fr → persiste data/license.json
+await lic.requestCode({ email });
+```
+Vues : `@mostajs/licensing-ui-html` (no-build) ou `@mostajs/licensing-ui-react`. Tests/§12 : `npm install && npm test`.

package/llms.txt

@@ -0,0 +1,29 @@
+# @mostajs/licensing-ui-env — fiche LLM
+> Service de licence piloté par .env (statut, activation en ligne, persistance) — extrait de Salsabil ; compose @mostajs/licensing.
+
+- Version: 0.1.0 · Licence: AGPL-3.0-or-later · Auteur: Dr Hamid MADANI <drmdh@msn.com>
+- Stack: mosta-licensing-stack · Logique: @mostajs/licensing · Vues: licensing-ui-html (no-build) / licensing-ui-react
+
+## RÔLE
+Couche CONTRÔLEUR pilotée par .env pour apps no-build (node:http…). Lit la config .env, vérifie la
+licence (signée .env OU activée+persistée <dataDir>/license.json), expose le statut, et l'activation
+en ligne (compose le client serveur de @mostajs/licensing). AUCUNE UI ici (cf. licensing-ui-html).
+
+## EXPORTS
+- createLicenseEnv({ env, dataDir?, defaultProject?, now? }) -> { enabled, enforce, project, serverUrl, machineId, status, activate, requestCode }
+
+## API
+- status() -> { valid, status, reason?, expiresAt?, daysLeft?, source, enforce, project, serverUrl }
+- activate(activationCode) -> CheckResult  (télécharge+vérifie+persiste data/license.json)
+- requestCode({ email, company? })
+
+## CONFIG .env
+LICENSE (signée b64), LICENSE_PUBLIC_KEY (PEM b64), LICENSE_PROJECT, LICENSE_SERVER_URL
+(défaut https://licences.amia.fr), LICENSE_ENFORCE (on/off), LICENSE_EXPIRES_AT (essai simple).
+
+## PRIORITÉ DE RÉSOLUTION
+1) .env LICENSE  2) <dataDir>/license.json (activation en ligne)  3) LICENSE_EXPIRES_AT (essai)  4) UNLICENSED.
+
+## CONSOMMATEUR
+App Salsabil (src/license.mjs en réexporte createLicense = createLicenseEnv). Couplez à
+@mostajs/licensing-ui-html pour les vues (statut/activation/gate).

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@mostajs/licensing-ui-env",
+  "version": "0.1.0",
+  "description": "Service de licence piloté par .env (statut, activation en ligne, persistance) — extrait de l'app Salsabil ; compose @mostajs/licensing. Sans framework (no-build).",
+  "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",
+    "env",
+    "config",
+    "no-build",
+    "mostajs"
+  ],
+  "dependencies": {
+    "@mostajs/licensing": "^0.1.0"
+  },
+  "devDependencies": {
+    "@mostajs/mjs-unit": "^0.3.0"
+  },
+  "scripts": {
+    "test": "node test-scripts/unit/licensing-ui-env.test.mjs && node examples/run.mjs"
+  }
+}

package/src/index.js

@@ -0,0 +1,72 @@
+// @mostajs/licensing-ui-env — service de licence PILOTÉ PAR .env (extrait de l'app Salsabil).
+// COMPOSE @mostajs/licensing (vérif RSA + client serveur). Gérable par .env :
+//   LICENSE (signée base64), LICENSE_PUBLIC_KEY (PEM base64), LICENSE_PROJECT, LICENSE_SERVER_URL,
+//   LICENSE_ENFORCE (on/off), LICENSE_EXPIRES_AT (essai simple). Activation en ligne → licence
+//   persistée dans <dataDir>/license.json. DB-agnostique, sans framework (no-build).
+// @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import crypto from 'node:crypto';
+import { checkLicense, createLicenseClient } from '@mostajs/licensing';
+
+const b64decode = (s) => Buffer.from(String(s), 'base64').toString('utf8');
+const daysLeft = (expiresAt, n) => (expiresAt ? Math.ceil((new Date(expiresAt).getTime() - n.getTime()) / 86400000) : null);
+
+/**
+ * @param {object} opts
+ * @param {object} opts.env          variables (.env)
+ * @param {string} [opts.dataDir]    dossier de persistance de la licence activée (défaut './data')
+ * @param {string} [opts.defaultProject] projet par défaut si LICENSE_PROJECT absent (défaut 'app')
+ * @param {() => Date} [opts.now]
+ */
+export function createLicenseEnv({ env = {}, now = () => new Date(), dataDir = './data', defaultProject = 'app' } = {}) {
+  const project = env.LICENSE_PROJECT || defaultProject;
+  const enforce = String(env.LICENSE_ENFORCE || '').toLowerCase() === 'on';
+  const serverUrl = (env.LICENSE_SERVER_URL || 'https://licences.amia.fr').replace(/\/+$/, '');
+  const licenseFile = path.join(dataDir, 'license.json');
+  let pub = null;
+  try { if (env.LICENSE_PUBLIC_KEY) pub = b64decode(env.LICENSE_PUBLIC_KEY); } catch { /* clé illisible */ }
+
+  // Licence courante : .env LICENSE prioritaire, sinon fichier persisté (activation en ligne).
+  function loadSigned() {
+    if (env.LICENSE) { try { return JSON.parse(b64decode(env.LICENSE)); } catch { /* */ } }
+    try { if (fs.existsSync(licenseFile)) return JSON.parse(fs.readFileSync(licenseFile, 'utf8')); } catch { /* */ }
+    return null;
+  }
+
+  function status() {
+    const n = now();
+    const signed = loadSigned();
+    if (signed && pub) {
+      const r = checkLicense(signed, { project, publicKeyPem: pub, now: n });
+      return { valid: r.valid, status: r.status, reason: r.reason || null, expiresAt: r.expiresAt || null, daysLeft: daysLeft(r.expiresAt, n), enforce, source: 'signed', project, serverUrl };
+    }
+    if (env.LICENSE_EXPIRES_AT) {
+      const exp = new Date(env.LICENSE_EXPIRES_AT); const valid = exp.getTime() > n.getTime();
+      return { valid, status: valid ? 'TRIAL' : 'EXPIRED', reason: valid ? null : `Essai expiré le ${env.LICENSE_EXPIRES_AT}`, expiresAt: env.LICENSE_EXPIRES_AT, daysLeft: daysLeft(env.LICENSE_EXPIRES_AT, n), enforce, source: 'trial', project, serverUrl };
+    }
+    return { valid: !enforce, status: 'UNLICENSED', reason: 'Aucune licence configurée', expiresAt: null, daysLeft: null, enforce, source: 'none', project, serverUrl };
+  }
+
+  const client = createLicenseClient({ baseUrl: serverUrl, publicKeyPem: pub || undefined });
+  const machineId = crypto.createHash('sha256').update(`${os.hostname()}|${project}`).digest('hex').slice(0, 24);
+
+  /** Active via le serveur : télécharge la licence du code, vérifie, persiste <dataDir>/license.json. */
+  async function activate(activationCode) {
+    const code = String(activationCode || '').trim();
+    if (!code) throw new Error('code d’activation requis');
+    const { signed, check } = await client.activate({ activationCode: code, machineId, machineName: os.hostname(), project });
+    if (check?.valid) { fs.mkdirSync(dataDir, { recursive: true }); fs.writeFileSync(licenseFile, JSON.stringify(signed)); }
+    return check;
+  }
+  /** Demande un code d'activation par email. */
+  const requestCode = ({ email, company } = {}) => client.requestActivationCode({ email, project, company });
+
+  return {
+    enabled: !!(env.LICENSE || env.LICENSE_EXPIRES_AT || fs.existsSync(licenseFile)),
+    enforce, project, serverUrl, machineId, status, activate, requestCode,
+  };
+}
+
+export default createLicenseEnv;