@nodefony/framework 10.0.0-beta.4 → 10.0.0-beta.6

package/dist/types/nodefony/src/Controller.d.ts

@@ -1,12 +1,13 @@
-import { Service, Module, FileClass } from "nodefony";
-import type { IRequestUser, MaybePromise } from "nodefony";
+import { Service, Module, type Pci, type Severity, type Msgid, type Message, FileClass } from "nodefony";
+import type { DefaultEventsMap, EventsMap, IRequestUser, MaybePromise } from "nodefony";
 import type { IController } from "../interfaces/index.js";
 import Route from "./Route.js";
 import { contextRequest, HTTPMethod, HttpResponse, Session, ContextType, Http2Response, WebsocketResponse } from "@nodefony/http";
-import type { ISseStreamOptions, SseStream } from "@nodefony/http";
+import type { ByteStreamSource, IByteStreamOptions, IByteStreamResult, ISseStreamOptions, SseStream } from "@nodefony/http";
 import { OutgoingHttpHeaders } from "node:http";
 import { ReadStream } from "node:fs";
 import Eta from "../service/Eta.js";
+import type { IFileServingConfig } from "../config/config.js";
 type ReadStreamOptions = {
     flags?: string;
     encoding?: BufferEncoding;
@@ -17,6 +18,17 @@ type ReadStreamOptions = {
     start?: number;
     end?: number;
     highWaterMark?: number;
+    /**
+     * `false` coupe les requêtes conditionnelles : ni `ETag`, ni
+     * `Last-Modified`, ni 304/412, ni `Cache-Control` par défaut, et
+     * `If-Range` n'autorise aucune reprise. Pour des fichiers dont la date
+     * n'est pas fiable (archive décompressée, build reproductible : même taille
+     * et même date pour deux contenus) — passer plutôt sa propre `ETag`
+     * (hachage du contenu) garde le 304. Défaut : `fileServing.validators` de
+     * la config du module (`true` d'usine) ; `true` ici le rétablit pour un
+     * appel quand la config l'a coupé.
+     */
+    validators?: boolean;
 };
 /**
  * Parse un header `Range` mono-plage en octets (RFC 9110 §14.1.2).
@@ -50,6 +62,13 @@ export declare function parseByteRange(range: string, length: number): {
  *   dans `initialize()`, ou garde un état sur `this`.
  */
 export type ControllerScope = "request" | "singleton";
+/**
+ * Fixe le défaut des fichiers servis (validateurs, `Cache-Control`) pour
+ * toute l'application. Appelé par le module au boot avec sa config validée.
+ *
+ * @param config - section `fileServing` validée
+ */
+export declare function configureFileServing(config: IFileServingConfig): void;
 declare class Controller extends Service implements IController {
     #private;
     static prefix: string;
@@ -83,6 +102,14 @@ declare class Controller extends Service implements IController {
      */
     get context(): ContextType | undefined;
     set context(context: ContextType | undefined);
+    /**
+     * Journalise au nom du module du contrôleur, pas du noyau : `moduleName`
+     * explicite, sinon le module posé sur la requête (`context.logModule`),
+     * sinon le module propriétaire du contrôleur.
+     *
+     * @param moduleName - module qui signe CETTE ligne
+     */
+    log(pci: Pci, severity?: Severity, msgid?: Msgid, msg?: Message, moduleName?: string): import("nodefony").Pdu;
     /**
      * Route de l'appel en cours. Par requête : posée par le Resolver
      * (`setRoute`). Singleton : celle du résolveur de l'APPEL quand le pont
@@ -168,6 +195,13 @@ declare class Controller extends Service implements IController {
      */
     renderResponse(data: unknown, encoding?: BufferEncoding, status?: string | number, headers?: OutgoingHttpHeaders): MaybePromise<Http2Response | HttpResponse | WebsocketResponse>;
     renderView(path: string | FileClass, param?: Record<string, unknown>, status?: string | number, headers?: Record<string, string | number>): Promise<Http2Response | HttpResponse | WebsocketResponse>;
+    /**
+     * Expose le nonce CSP de la requête à la vue (`cspNonce`), lu seulement si
+     * le gabarit s'en sert : un accesseur, pas une valeur — une vue sans
+     * `<script>` ni `<style>` ne tire aucun nonce. Une valeur `cspNonce`
+     * fournie par l'action est gardée.
+     */
+    private withNonceLocal;
     /**
      * Injecte les helpers frontend (`frontendTags`/`frontendDocument`) dans les
      * locals du template (passés en data, pas de registre global de fonctions).
@@ -209,11 +243,61 @@ declare class Controller extends Service implements IController {
      * }
      * ```
      *
+     * Typé par le contrat temps réel de l'application, le flux lit la MÊME carte
+     * que la socket : `this.renderSse<ContractServerEmit<ChatContract>>()`, puis
+     * `sse.send(m, { event: "chat:room" })`. Sans paramètre de type, il reste
+     * libre — un flux hors contrat est valide.
+     *
+     * @typeParam Events - carte des événements du flux (défaut : libre).
      * @param options - battement de cœur, délai `retry:` initial.
      * @returns le flux, ou sa promesse quand une session est à sauver d'abord.
      * @throws HttpError 500 hors HTTP (WebSocket) ou quand la réponse est partie.
      */
-    renderSse(options?: ISseStreamOptions): SseStream | Promise<SseStream>;
+    renderSse<Events extends EventsMap = DefaultEventsMap>(options?: ISseStreamOptions): SseStream<Events> | Promise<SseStream<Events>>;
+    /**
+     * Répond par un FLUX D'OCTETS : un `<video src>`, un `fetch()`, un
+     * téléchargement ou un outil tiers (curl) le consomment comme n'importe quelle
+     * réponse HTTP, une réponse par consommateur. Pour des ÉVÉNEMENTS texte lus
+     * par `EventSource`, voir {@link Controller.renderSse}. Pour UNE source
+     * d'octets diffusée à N lecteurs par la socket, publier un `Uint8Array` sur
+     * un canal temps réel (`@nodefony/realtime`), pas une réponse HTTP.
+     *
+     * La réponse est prise à l'appel ; les en-têtes partent au premier morceau.
+     * Une erreur de la source AVANT lui rend la page d'erreur ordinaire (500, ou
+     * le code d'une `HttpError`) ; APRÈS, le client voit une coupure. La source
+     * appartient au flux dès l'appel : détruite à la fin, quelle qu'en soit la
+     * raison, et détruite aussi quand l'appel lève (un flux web est annulé). La
+     * promesse ne rejette jamais : elle rend la raison de la fin et les octets
+     * envoyés.
+     *
+     * @example
+     * ```ts
+     * const ff = spawn("ffmpeg", args, { stdio: ["ignore", "pipe", "ignore"], windowsHide: true });
+     * try {
+     *   await this.renderStream(ff.stdout, { headers: { "content-type": "video/mp4" } });
+     * } finally {
+     *   ff.kill("SIGKILL"); // le flux est fini, quelle qu'en soit la raison
+     * }
+     * ```
+     *
+     * Relais d'un autre service — le signal coupe l'amont au départ du client ;
+     * ne recopier que `content-type` (`fetch` a déjà décompressé le corps) :
+     * ```ts
+     * const r = await fetch(url, { signal: this.context.signal });
+     * if (!r.ok || r.body === null) throw new HttpError(502);
+     * return this.renderStream(r.body, {
+     *   headers: { "content-type": r.headers.get("content-type") ?? "application/octet-stream" },
+     * });
+     * ```
+     *
+     * @param source - flux Node, ou flux web ; jamais en mode objet.
+     * @param options - statut, en-têtes, `idleTimeout`, `stallTimeout`,
+     *   `maxDuration`, `onClose(reason)`.
+     * @returns la raison de la fin et le nombre d'octets envoyés.
+     * @throws HttpError 500 hors HTTP (WebSocket) ou quand la réponse est partie ;
+     *   429 au-delà du plafond de connexions par IP. La source est alors détruite.
+     */
+    renderStream(source: ByteStreamSource, options?: IByteStreamOptions): Promise<IByteStreamResult>;
     /**
      * Pose la route de la requête courante sur l'instance (per-request).
      *
@@ -273,9 +357,10 @@ declare class Controller extends Service implements IController {
      * @param file - chemin ou `FileClass` du fichier à servir.
      * @param options - options de `createReadStream`.
      * @param headers - en-têtes ajoutés (écrasent ceux posés par défaut).
-     * @returns le flux de lecture, une fois la réponse écoulée.
+     * @returns le flux de lecture, une fois la réponse écoulée — `null` quand
+     *   les préconditions ont répondu 304 ou 412 (cf {@link Controller.streamFile}).
      */
-    renderFileDownload(file: FileClass | string, options?: ReadStreamOptions, headers?: OutgoingHttpHeaders): Promise<ReadStream>;
+    renderFileDownload(file: FileClass | string, options?: ReadStreamOptions, headers?: OutgoingHttpHeaders): Promise<ReadStream | null>;
     /**
      * Envoie un fichier en FLUX, du disque vers la réponse, sans jamais le charger
      * en mémoire.
@@ -287,17 +372,38 @@ declare class Controller extends Service implements IController {
      * `Content-Range`). Annoncer `Accept-Ranges: bytes` depuis ici est un piège :
      * le client croit pouvoir se déplacer et reçoit tout le fichier.
      *
-     * Ce que cette méthode garantit et qui justifie son existence : le NETTOYAGE.
-     * Le flux est ouvert en `autoClose: false` ; un client qui raccroche en plein
-     * téléchargement laisserait sinon un descripteur ouvert et une promesse pendue.
+     * Le cycle de vie est celui de toute réponse en flux
+     * ({@link Controller.renderStream}) : la réponse est prise à l'appel, les
+     * en-têtes partent au premier morceau, le flux est DÉTRUIT (descripteur
+     * fermé) quand le client raccroche. Un fichier illisible à l'ouverture
+     * (`EACCES`) rend la page d'erreur ordinaire, 500 ; une lecture qui échoue
+     * en cours de route coupe la connexion. Sans délai d'inactivité (un disque
+     * n'est pas une source muette).
+     *
+     * **Requêtes conditionnelles** (RFC 9110 §13) : le fichier ENTIER porte une
+     * `ETag` forte et un `Last-Modified`, tirés de sa taille et de sa date de
+     * modification ; `If-Match`, `If-Unmodified-Since`, `If-None-Match` et
+     * `If-Modified-Since` y sont évalués dans l'ordre de §13.2.2 → 304 ou 412,
+     * sans ouvrir le fichier. Une `ETag` ou un `Last-Modified` passés dans
+     * `headers` (ou déjà posés sur la réponse) l'emportent, et servent à la
+     * comparaison. `Cache-Control: private, no-cache` est posé si l'action n'en
+     * fixe aucun — en passer un dans `headers` le remplace. Un EXTRAIT
+     * (`start`/`end`) n'est pas la représentation entière : il ne reçoit ni
+     * validateur ni évaluation.
+     * `{ validators: false }` dans `options` coupe le tout — validateurs,
+     * évaluation et `Cache-Control` par défaut — pour des fichiers dont la date
+     * n'est pas fiable ; une `ETag` tirée du contenu garde, elle, le 304.
      *
      * @param file - chemin ou `FileClass` du fichier à servir.
      * @param headers - en-têtes ajoutés à la réponse (le type MIME est déduit si absent).
      * @param options - options de `createReadStream` (`start`/`end` pour un extrait).
-     * @returns le flux de lecture, une fois la réponse écoulée.
-     * @throws Si la réponse n'est pas disponible, ou si le fichier est illisible.
+     * @returns le flux de lecture, une fois la réponse écoulée — détruit, quelle
+     *   que soit la fin ; `null` quand les préconditions ont répondu 304 ou 412 :
+     *   aucun fichier n'a alors été ouvert.
+     * @throws HttpError 404 si le fichier n'existe pas ; 500 hors HTTP
+     *   (WebSocket) ou quand la réponse est déjà partie.
      */
-    streamFile(file: FileClass | string, headers?: OutgoingHttpHeaders, options?: ReadStreamOptions | undefined): Promise<ReadStream>;
-    renderMediaStream(file: FileClass | string, headers?: OutgoingHttpHeaders, options?: ReadStreamOptions | undefined): Promise<HttpResponse | ReadStream | WebsocketResponse>;
+    streamFile(file: FileClass | string, headers?: OutgoingHttpHeaders, options?: ReadStreamOptions): Promise<ReadStream | null>;
+    renderMediaStream(file: FileClass | string, headers?: OutgoingHttpHeaders, options?: ReadStreamOptions | undefined): Promise<HttpResponse | ReadStream | WebsocketResponse | null>;
 }
 export default Controller;

package/dist/types/nodefony/src/Resolver.d.ts

@@ -37,6 +37,14 @@ declare class Resolver implements IResolver {
     resolve: boolean;
     variables: unknown[];
     exception?: HttpError | Error | null | undefined;
+    /**
+     * Ce que l'action a rendu quand le Resolver n'a rien pu envoyer — absent
+     * sinon. Lu par l'avertissement de développement
+     * (`IRouteResolver.unrendered`). `declare` : AUCUN champ émis — un Resolver
+     * naît à chaque requête, et la propriété n'apparaît que sur la branche qui
+     * attend déjà son délai d'expiration (`micro-resolver-field.mjs`).
+     */
+    unrendered?: string;
     acceptedProtocol: string | null;
     bypassFirewall: boolean;
     /**
@@ -248,7 +256,7 @@ declare class Resolver implements IResolver {
      * (`returnController`) — le chemin du **pont `api.request`** (WS) : la valeur
      * nue est enveloppée `{id, result}` par le peer, jamais rendue sur le
      * transport. La méthode HTTP logique d'une mutation du pont voyage dans
-     * {@link methodOverride} ; sans porte ici, un rejeu `socket.mutate` (socket
+     * {@link methodOverride} ; sans porte ici, un rejeu `socket.post` (socket
      * qui reconnecte) ré-exécuterait la mutation (doublon — vécu au banc duplex).
      *
      * @returns `{ result }` — la valeur retournée par l'action (ou la réponse

package/dist/types/nodefony/src/ResourceController.d.ts

@@ -67,7 +67,7 @@ export interface IResourceService<T = unknown> {
     delete?(criteria: Record<string, unknown>): Promise<number> | number;
 }
 /**
- * Controller de ressource **souverain** (V4.2 — POC API souveraine, Phase 2) :
+ * Controller de ressource **duplex** (V4.2 — une action, deux transports) :
  * la logique métier est écrite UNE fois dans le service de ressource, les
  * actions de la sous-classe ne sont que des portes (REST, WS-RPC `invoke`,
  * GraphQL à venir) qui retournent la **valeur brute** — `returnController`
@@ -102,8 +102,12 @@ export interface IResourceService<T = unknown> {
  *     return this.listResource();
  *   }
  *   \@route("books-get", { path: "/{id}", requirements: { methods: ["GET", "WEBSOCKET"] } })
- *   detail(\@Param("id") id: string) {
- *     return this.getResource(id);
+ *   async detail(\@Param("id") id: string) {
+ *     // `null` rendu tel quel = « l'action répond elle-même » : la requête
+ *     // pendrait jusqu'au délai d'expiration. La porte décide du 404.
+ *     const found = await this.getResource(id);
+ *     if (!found) throw new HttpError(`Book ${id} not found`, 404);
+ *     return found;
  *   }
  * }
  * ```
@@ -155,6 +159,10 @@ declare class ResourceController<T = unknown> extends Controller {
     /**
      * Lit une entité par id — `null` si absente (la porte décide du 404).
      *
+     * ⚠️ Ne pas rendre ce `null` tel quel depuis une action : pour le Resolver,
+     * `null` veut dire « l'action répond elle-même », et la requête attend
+     * alors son délai d'expiration. Lever un `HttpError` 404.
+     *
      * `options.relations` charge les associations dans la foulée. La porte doit
      * n'y laisser passer que des relations qu'elle a DÉCLARÉES : un `include`
      * libre laisse le client nommer n'importe quelle association, donc lire des

package/dist/types/nodefony/src/SecurityApiController.d.ts

@@ -1,15 +1,28 @@
 import type { OutgoingHttpHeaders } from "node:http";
 import Controller from "./Controller.js";
+/**
+ * En-têtes d'un 401 : ceux reçus, plus le défi par défaut
+ * ({@link SESSION_AUTH_CHALLENGE}) s'ils n'en portent aucun — RFC 9110 §15.5.2
+ * exige un `WWW-Authenticate` sur TOUT 401. Un défi posé par l'appelant (un
+ * `Bearer` de ressource protégée, par exemple) garde la main.
+ *
+ * Chemin froid : n'est appelé que pour un 401.
+ *
+ * @param headers - les en-têtes déjà prévus pour la réponse.
+ * @returns les mêmes en-têtes, défi compris.
+ */
+export declare function withAuthChallenge(headers: Readonly<OutgoingHttpHeaders> | undefined): OutgoingHttpHeaders;
 /**
  * Base des contrôleurs d'authentification (`/nodefony/security/api/*`) : toute
- * réponse JSON part en `Cache-Control: no-store`.
+ * réponse JSON part en `Cache-Control: no-store`, et tout 401 porte un défi.
  *
  * Ces réponses portent une identité, un jeton, un secret affiché une seule
  * fois (clé API, secret TOTP, codes de récupération) ou leur refus. Un cookie
  * ou un en-tête dans la requête n'empêche pas un cache partagé de STOCKER la
- * réponse (RFC 9111 §3) ; RFC 6749 §5.1 exige `no-store` sur un jeton. La règle
- * vit ici, une fois : une action ajoutée à un contrôleur héritier ne peut pas
- * l'oublier. Un en-tête passé par l'action garde la priorité.
+ * réponse (RFC 9111 §3) ; RFC 6749 §5.1 exige `no-store` sur un jeton. Un 401
+ * reçoit le défi par défaut ({@link withAuthChallenge}, RFC 9110 §15.5.2). Ces
+ * règles vivent ici, une fois : une action ajoutée à un contrôleur héritier ne
+ * peut pas les oublier. Un en-tête passé par l'action garde la priorité.
  */
 declare abstract class SecurityApiController extends Controller {
     renderJson(obj: unknown, status?: string | number, headers?: OutgoingHttpHeaders): ReturnType<Controller["renderJson"]>;

package/dist/types/nodefony/src/conditionalRequest.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Requêtes conditionnelles sur une représentation servie par un contrôleur —
+ * validateurs (RFC 9110 §8.8) et évaluation des préconditions (§13).
+ *
+ * Fonctions PURES : l'instant courant est un paramètre, aucune lecture
+ * d'horloge ni d'en-tête n'a lieu ici. Le contrôleur rassemble les entrées,
+ * ce module rend le verdict.
+ */
+/** Validateurs d'une représentation (RFC 9110 §8.8). */
+export interface IValidators {
+    /** Étiquette d'entité, guillemets compris (`"…"` forte, `W/"…"` faible) ; `null` si aucune. */
+    readonly etag: string | null;
+    /**
+     * Dernière modification (ms depuis l'époque), à la seconde — la précision
+     * d'une date HTTP — et jamais postérieure à l'instant de la réponse
+     * (§8.8.2.1) ; `null` si aucune.
+     */
+    readonly lastModified: number | null;
+    /**
+     * La date est-elle un validateur FORT (§8.8.2.2) : modifiée au moins une
+     * seconde avant la réponse, elle ne peut plus changer dans la même seconde.
+     * Seul un validateur fort autorise une reprise par `If-Range` (§13.1.5).
+     */
+    readonly lastModifiedStrong: boolean;
+}
+/** Issue des préconditions : servir (200), rien n'a changé (304), condition fausse (412). */
+export type PreconditionOutcome = 200 | 304 | 412;
+/** En-têtes de requête lus par l'évaluation (noms en minuscules, comme Node les rend). */
+export interface IConditionalHeaders {
+    readonly "if-match"?: string | undefined;
+    readonly "if-none-match"?: string | undefined;
+    readonly "if-modified-since"?: string | undefined;
+    readonly "if-unmodified-since"?: string | undefined;
+    readonly "if-range"?: string | undefined;
+}
+/**
+ * Validateurs d'un fichier, tirés de ses métadonnées sans le lire.
+ *
+ * L'`ETag` est FORTE : taille et date de modification à la microseconde, deux
+ * grandeurs qu'une écriture change. C'est la forme que posent les serveurs de
+ * fichiers courants, et la seule qui autorise une reprise (§13.1.5).
+ *
+ * @param stats - taille et date de modification du fichier
+ * @param now - instant de la réponse (ms)
+ * @returns les validateurs du fichier
+ */
+export declare function fileValidators(stats: {
+    readonly size: number;
+    readonly mtimeMs: number;
+}, now: number): IValidators;
+/**
+ * Date HTTP (RFC 9110 §5.6.7) lue en ms, ou `null` si la valeur n'en est pas
+ * une — une condition sur une date invalide DOIT être ignorée (§13.1.3, §13.1.4).
+ *
+ * @param value - valeur brute de l'en-tête
+ */
+export declare function parseHttpDate(value: string | undefined): number | null;
+/**
+ * Évalue les préconditions d'une requête sur une représentation qui EXISTE,
+ * dans l'ordre de RFC 9110 §13.2.2 — `If-Match`, sinon `If-Unmodified-Since` ;
+ * puis `If-None-Match`, sinon `If-Modified-Since`. `Range` et `If-Range`
+ * viennent après, s'il faut servir (voir {@link ifRangeHolds}).
+ *
+ * @param method - méthode de la requête
+ * @param headers - en-têtes de la requête
+ * @param validators - validateurs de la représentation
+ * @returns 200 pour servir, 304 si rien n'a changé (GET et HEAD seulement),
+ *   412 si une condition est fausse
+ */
+export declare function evaluatePreconditions(method: string, headers: IConditionalHeaders, validators: IValidators): PreconditionOutcome;
+/**
+ * Une condition `If-Range` tient-elle (RFC 9110 §13.1.5) ? Vraie, la plage
+ * demandée est servie (206) ; fausse, `Range` est ignoré et la représentation
+ * part entière (200) — un client ne recolle jamais deux versions.
+ *
+ * Une étiquette tient si elle est FORTEMENT égale ; une date, si elle égale
+ * exactement `Last-Modified` ET que celle-ci est un validateur fort.
+ *
+ * @param value - valeur brute de `If-Range`
+ * @param validators - validateurs de la représentation
+ */
+export declare function ifRangeHolds(value: string, validators: IValidators): boolean;

package/dist/types/nodefony/src/loginPage.d.ts

@@ -141,4 +141,4 @@ export declare function buildLoginPageView(page: ILoginPageDescription, request:
  * d'empreinte (`i-finger`) reprend `IconFingerprint` de Tabler Icons (MIT),
  * celle du bouton de Studio : les deux écrans montrent le même geste.
  */
-export declare const LOGIN_PAGE_TEMPLATE = "<!doctype html>\n<html lang=\"fr\"<% if (it.theme) { %> data-theme=\"<%= it.theme %>\"<% } %>>\n  <head>\n    <meta charset=\"utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n    <meta name=\"color-scheme\" content=\"dark light\" />\n    <meta name=\"robots\" content=\"noindex\" />\n    <title><%= it.title %> \u2014 <%= it.brand %></title>\n    <link rel=\"icon\" href=\"<%= it.logoHref %>\" type=\"image/svg+xml\" />\n<% if (!it.theme) { %>\n    <script nonce=\"<%= it.nonce %>\">try{var t=localStorage.getItem(\"nf-login-theme\");if(t===\"light\"||t===\"dark\")document.documentElement.dataset.theme=t}catch(e){}</script>\n<% } %>\n    <link rel=\"stylesheet\" href=\"<%= it.styleHref %>\" />\n<% if (it.skinHref) { %>\n    <link rel=\"stylesheet\" href=\"<%= it.skinHref %>\" />\n<% } %>\n<% if (it.stylesheetHref) { %>\n    <link rel=\"stylesheet\" href=\"<%= it.stylesheetHref %>\" />\n<% } %>\n    <script type=\"module\" src=\"<%= it.scriptHref %>\" nonce=\"<%= it.nonce %>\"></script>\n  </head>\n  <body data-skin=\"<%= it.skin %>\" data-layout=\"<%= it.layout %>\"<% if (it.backdrop) { %> data-backdrop<% } %><% if (it.ssoFirst) { %> data-sso-first<% } %>>\n    <svg width=\"0\" height=\"0\" style=\"position: absolute\" aria-hidden=\"true\">\n      <symbol id=\"i-user\" viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"8\" r=\"3.5\" /><path d=\"M5.5 20a6.5 6.5 0 0 1 13 0\" /></symbol>\n      <symbol id=\"i-lock\" viewBox=\"0 0 24 24\"><rect x=\"5\" y=\"10.5\" width=\"14\" height=\"10\" rx=\"2\" /><path d=\"M8.5 10.5V7.5a3.5 3.5 0 0 1 7 0v3\" /></symbol>\n      <symbol id=\"i-eye\" viewBox=\"0 0 24 24\"><path d=\"M2.5 12S6 5.5 12 5.5 21.5 12 21.5 12 18 18.5 12 18.5 2.5 12 2.5 12Z\" /><circle cx=\"12\" cy=\"12\" r=\"2.8\" /></symbol>\n      <symbol id=\"i-arrow\" viewBox=\"0 0 24 24\"><path d=\"M5 12h14M13 6l6 6-6 6\" /></symbol>\n      <symbol id=\"i-key\" viewBox=\"0 0 24 24\"><circle cx=\"8\" cy=\"15\" r=\"3.8\" /><path d=\"M10.8 12.2 19.5 3.5M16.5 6.5l2.5 2.5M14 9l2 2\" /></symbol>\n      <symbol id=\"i-check\" viewBox=\"0 0 24 24\"><path d=\"M5 12.5l4.5 4.5L19 7.5\" /></symbol>\n      <symbol id=\"i-finger\" viewBox=\"0 0 24 24\"><path d=\"M18.9 7a8 8 0 0 1 1.1 5v1a6 6 0 0 0 .8 3\" /><path d=\"M8 11a4 4 0 0 1 8 0v1a10 10 0 0 0 2 6\" /><path d=\"M12 11v2a14 14 0 0 0 2.5 8\" /><path d=\"M8 15a18 18 0 0 0 1.8 6\" /><path d=\"M4.9 19a22 22 0 0 1-.9-7v-1a8 8 0 0 1 12-6.95\" /></symbol>\n      <symbol id=\"i-sun\" viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"4\" /><path d=\"M12 2.5v2M12 19.5v2M4.6 4.6l1.4 1.4M18 18l1.4 1.4M2.5 12h2M19.5 12h2M4.6 19.4 6 18M18 6l1.4-1.4\" /></symbol>\n      <symbol id=\"i-moon\" viewBox=\"0 0 24 24\"><path d=\"M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5Z\" /></symbol>\n      <symbol id=\"i-shield\" viewBox=\"0 0 24 24\"><path d=\"M12 3l7.5 3v5.5c0 4.6-3.2 8-7.5 9.5-4.3-1.5-7.5-4.9-7.5-9.5V6z\" /></symbol>\n      <symbol id=\"m-github\" viewBox=\"0 0 16 16\"><path d=\"M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27s1.36.09 2 .27c1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.01 8.01 0 0 0 16 8c0-4.42-3.58-8-8-8Z\" /></symbol>\n    </svg>\n    <header class=\"nf-strip\">\n      <div class=\"nf-strip-brand\"><img class=\"nf-logo\" src=\"<%= it.logo %>\" alt=\"\" /><%= it.brand %></div>\n    </header>\n    <div class=\"nf-layout\">\n      <aside class=\"nf-hero\" aria-hidden=\"true\">\n        <div class=\"nf-hero-brand\"><img class=\"nf-logo\" src=\"<%= it.logo %>\" alt=\"\" /><%= it.brand %></div>\n<% if (it.hero === null) { %>\n        <div class=\"nf-home\">\n          <img\n            class=\"nf-home-logo\"\n            src=\"<%= it.logoHref %>\"\n            alt=\"\"\n          />\n          <h2>Le framework Node.js fullstack</h2>\n          <p class=\"sub\">\n            Temps r\u00E9el natif \u00B7 d\u00E9veloppement agentic-ready \u00B7 socle TypeScript\n            isomorphe\n          </p>\n          <p class=\"sig\">\n            Une action de contr\u00F4leur. Deux transports. La m\u00EAme session, la m\u00EAme\n            s\u00E9curit\u00E9, le m\u00EAme code.\n          </p>\n          <ul class=\"badges\">\n            <li class=\"agentic\">Agentic ready</li>\n            <li>Node.js \u2265 24.14</li>\n            <li>TypeScript strict</li>\n            <li>ESM only</li>\n            <li>Licence Apache 2.0</li>\n          </ul>\n          <div\n            class=\"install\"\n            role=\"img\"\n            aria-label=\"Commande d'installation : npx nodefony create app\"\n          >\n            <span class=\"p\">$</span><span>npx nodefony create app</span>\n          </div>\n          <div class=\"features\">\n            <div class=\"feature\">\n              <span class=\"ic\"\n                ><svg\n                  viewBox=\"0 0 24 24\"\n                  fill=\"none\"\n                  stroke=\"currentColor\"\n                  stroke-width=\"2\"\n                  stroke-linecap=\"round\"\n                  stroke-linejoin=\"round\"\n                  aria-hidden=\"true\"\n                >\n                  <polygon\n                    points=\"13 2 3 14 12 14 11 22 21 10 12 10 13 2\"\n                  /></svg\n              ></span>\n              <h3>Temps r\u00E9el natif</h3>\n              <p>\n                Le WebSocket n'est pas un ajout : m\u00EAme pipeline, m\u00EAme table de\n                routes, m\u00EAme s\u00E9curit\u00E9 que le HTTP.\n              </p>\n            </div>\n            <div class=\"feature\">\n              <span class=\"ic\"\n                ><svg\n                  viewBox=\"0 0 24 24\"\n                  fill=\"none\"\n                  stroke=\"currentColor\"\n                  stroke-width=\"2\"\n                  stroke-linecap=\"round\"\n                  stroke-linejoin=\"round\"\n                  aria-hidden=\"true\"\n                >\n                  <path d=\"M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z\" />\n                  <path d=\"m9 12 2 2 4-4\" /></svg\n              ></span>\n              <h3>S\u00E9curit\u00E9 par conception</h3>\n              <p>\n                Pare-feu applicatif par zones, Zero Trust, CSRF Fetch Metadata,\n                sessions hybrides, WebAuthn.\n              </p>\n            </div>\n            <div class=\"feature\">\n              <span class=\"ic\"\n                ><svg\n                  viewBox=\"0 0 24 24\"\n                  fill=\"none\"\n                  stroke=\"currentColor\"\n                  stroke-width=\"2\"\n                  stroke-linecap=\"round\"\n                  stroke-linejoin=\"round\"\n                  aria-hidden=\"true\"\n                >\n                  <rect x=\"3\" y=\"3\" width=\"7\" height=\"7\" rx=\"1\" />\n                  <rect x=\"14\" y=\"3\" width=\"7\" height=\"7\" rx=\"1\" />\n                  <rect x=\"3\" y=\"14\" width=\"7\" height=\"7\" rx=\"1\" />\n                  <rect x=\"14\" y=\"14\" width=\"7\" height=\"7\" rx=\"1\" /></svg\n              ></span>\n              <h3>DI & modules</h3>\n              <p>\n                Injection de d\u00E9pendances par d\u00E9corateurs, modules autonomes,\n                configuration valid\u00E9e au boot.\n              </p>\n            </div>\n            <div class=\"feature\">\n              <span class=\"ic\"\n                ><svg\n                  viewBox=\"0 0 24 24\"\n                  fill=\"none\"\n                  stroke=\"currentColor\"\n                  stroke-width=\"2\"\n                  stroke-linecap=\"round\"\n                  stroke-linejoin=\"round\"\n                  aria-hidden=\"true\"\n                >\n                  <circle cx=\"12\" cy=\"12\" r=\"9\" />\n                  <path\n                    d=\"M3 12h18M12 3c2.5 2.6 4 5.7 4 9s-1.5 6.4-4 9c-2.5-2.6-4-5.7-4-9s1.5-6.4 4-9z\"\n                  /></svg\n              ></span>\n              <h3>Socle isomorphe</h3>\n              <p>\n                Le m\u00EAme paquet c\u00F4t\u00E9 serveur et c\u00F4t\u00E9 navigateur : client temps\n                r\u00E9el, r\u00E8gles et types \u00E9crits une fois.\n              </p>\n            </div>\n          </div>\n        </div>\n        <small>Propuls\u00E9 par Nodefony</small>\n<% } else if (it.hero) { %>\n        <div class=\"nf-home\">\n          <h2><%= it.hero.heading %></h2>\n<% if (it.hero.text) { %>\n          <p class=\"sub\"><%= it.hero.text %></p>\n<% } %>\n        </div>\n<% } %>\n      </aside>\n      <main class=\"nf-stage\" data-nf-login data-from=\"<%= it.from %>\">\n        <button type=\"button\" class=\"nf-theme\" data-theme-toggle aria-label=\"Basculer entre th\u00E8me clair et th\u00E8me sombre\"><svg class=\"nf-icon t-sun\" aria-hidden=\"true\"><use href=\"#i-sun\" /></svg><svg class=\"nf-icon t-moon\" aria-hidden=\"true\"><use href=\"#i-moon\" /></svg></button>\n        <section class=\"nf-card\" aria-labelledby=\"nf-title\">\n          <div class=\"nf-head\">\n            <div class=\"nf-brand\"><img class=\"nf-logo\" src=\"<%= it.logo %>\" alt=\"\" /><%= it.brand %></div>\n            <h1 id=\"nf-title\"><%= it.title %></h1>\n            <p class=\"nf-sub\" id=\"nf-sub\"><%= it.lead %></p>\n          </div>\n          <div class=\"nf-body\">\n<% if (it.password) { %>\n            <ol class=\"nf-steps\" aria-label=\"\u00C9tapes\">\n              <li data-tab=\"identifier\" aria-current=\"step\">Identifiant</li>\n              <li data-tab=\"password\">Mot de passe</li>\n              <li data-tab=\"mfa\" hidden>V\u00E9rification</li>\n            </ol>\n            <form data-step=\"identifier\">\n              <div class=\"nf-field\">\n                <label for=\"nf-username\">Identifiant ou adresse e-mail</label>\n                <div class=\"nf-input\">\n                  <svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-user\" /></svg>\n                  <input id=\"nf-username\" name=\"username\" autocomplete=\"username\" autocapitalize=\"none\" spellcheck=\"false\" required />\n                </div>\n              </div>\n              <button class=\"nf-btn primary\" type=\"submit\">Continuer<svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-arrow\" /></svg></button>\n            </form>\n            <form data-step=\"password\" hidden>\n              <!-- Compte de l'\u00E9tape pr\u00E9c\u00E9dente, masqu\u00E9 : le gestionnaire de mots de passe\n                   associe le mot de passe \u00E0 CE compte (HTML, jeton \u00AB username \u00BB). -->\n              <input name=\"username\" autocomplete=\"username\" hidden readonly tabindex=\"-1\" />\n              <div class=\"nf-account\">\n                <span class=\"nf-avatar\" aria-hidden=\"true\"></span><span class=\"who\"></span>\n                <button type=\"button\" class=\"nf-link\" data-go=\"identifier\">Changer</button>\n              </div>\n              <div class=\"nf-field\">\n                <div class=\"nf-label-row\"><label for=\"nf-password\">Mot de passe</label></div>\n                <div class=\"nf-input\">\n                  <svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-lock\" /></svg>\n                  <input id=\"nf-password\" name=\"password\" type=\"password\" autocomplete=\"current-password\" required />\n                  <button type=\"button\" class=\"nf-reveal\" data-reveal aria-label=\"Afficher le mot de passe\" aria-pressed=\"false\"><svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-eye\" /></svg></button>\n                </div>\n              </div>\n              <button class=\"nf-btn primary\" type=\"submit\">Se connecter<svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-arrow\" /></svg></button>\n            </form>\n            <form data-step=\"mfa\" hidden>\n              <div class=\"nf-field\">\n                <label id=\"nf-otp-label\">Code \u00E0 6 chiffres</label>\n                <div class=\"nf-otp\" role=\"group\" aria-labelledby=\"nf-otp-label\">\n                  <input inputmode=\"numeric\" maxlength=\"1\" autocomplete=\"one-time-code\" aria-label=\"Chiffre 1\" /><input inputmode=\"numeric\" maxlength=\"1\" aria-label=\"Chiffre 2\" /><input inputmode=\"numeric\" maxlength=\"1\" aria-label=\"Chiffre 3\" /><input inputmode=\"numeric\" maxlength=\"1\" aria-label=\"Chiffre 4\" /><input inputmode=\"numeric\" maxlength=\"1\" aria-label=\"Chiffre 5\" /><input inputmode=\"numeric\" maxlength=\"1\" aria-label=\"Chiffre 6\" />\n                </div>\n              </div>\n              <p class=\"nf-hint\">Le code affich\u00E9 par votre application d'authentification.</p>\n              <button class=\"nf-btn primary\" type=\"submit\">V\u00E9rifier</button>\n            </form>\n<% } %>\n<% if (it.password || it.passkey) { %>\n            <div data-step=\"authenticated\" hidden>\n              <div class=\"nf-done\" role=\"status\">\n                <span class=\"ring\" aria-hidden=\"true\"><svg class=\"nf-icon\"><use href=\"#i-check\" /></svg></span>\n                <strong>Session ouverte</strong><span class=\"dest\"></span>\n                <span class=\"nf-progress\" aria-hidden=\"true\"><span></span></span>\n              </div>\n            </div>\n<% } %>\n<% if (it.providers.length > 0 || it.passkey) { %>\n            <div data-alt>\n<% if (it.password) { %>\n              <div class=\"nf-or\">ou</div>\n<% } %>\n              <div class=\"nf-alt\">\n<% if (it.passkey) { %>\n                <button type=\"button\" class=\"nf-btn span\" data-passkey hidden><svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-finger\" /></svg>Passkey / empreinte digitale</button>\n<% } %>\n<% it.providers.forEach(function (provider) { %>\n                <a class=\"nf-btn\" href=\"<%= provider.href %>\"><% if (provider.image) { %><img class=\"nf-icon\" src=\"<%= provider.image %>\" alt=\"\" /><% } else { %><svg class=\"<%= provider.icon === 'm-github' ? 'nf-mark' : 'nf-icon' %>\" aria-hidden=\"true\"><use href=\"#<%= provider.icon %>\" /></svg><% } %><% if (provider.caption) { %><span class=\"nf-label\"><%= provider.label %><small><%= provider.caption %></small></span><% } else { %><%= provider.label %><% } %></a>\n<% }) %>\n              </div>\n            </div>\n<% } %>\n            <div class=\"nf-message\" aria-live=\"polite\" data-message><% if (it.empty) { %><p class=\"nf-alert\" role=\"alert\"><span class=\"code\">\u2014</span><span>Aucun moyen de connexion n'est disponible pour le moment. Pr\u00E9venez l'administrateur du site.</span></p><% } else if (it.notice) { %><p class=\"nf-alert\" role=\"alert\"><span class=\"code\">SSO</span><span><%= it.notice %></span></p><% } %></div>\n<% if (it.password || it.passkey) { %>\n            <noscript><p class=\"nf-hint\">Cette page a besoin de JavaScript pour vous connecter.</p></noscript>\n<% } %>\n          </div>\n        </section>\n<% if (it.picker) { %>\n        <form class=\"nf-picker\" method=\"get\" data-preview-picker<% if (it.picker.hook) { %> data-preview-hook=\"<%= it.picker.hook %>\"<% } %> aria-label=\"Aper\u00E7u de la page (d\u00E9veloppement)\">\n          <input type=\"hidden\" name=\"from\" value=\"<%= it.from %>\" />\n          <label>Habillage <select name=\"skin\"><% it.picker.skins.forEach(function (skin) { %><option value=\"<%= skin %>\"<% if (skin === it.skin) { %> selected<% } %>><%= skin %></option><% }) %></select></label>\n          <label>Mise en page <select name=\"layout\"><% it.picker.layouts.forEach(function (layout) { %><option value=\"<%= layout %>\"<% if (layout === it.layout) { %> selected<% } %>><%= layout %></option><% }) %></select></label>\n          <noscript><button type=\"submit\">Appliquer</button></noscript>\n        </form>\n<% } %>\n<% if (it.footer) { %>\n        <div class=\"nf-foot\">\n          <ul class=\"nf-facts\" aria-label=\"Protection de la session\">\n            <li><svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-shield\" /></svg>cookie HttpOnly</li>\n            <li><svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-shield\" /></svg>anti-CSRF</li>\n            <li><svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-shield\" /></svg>CSP stricte</li>\n          </ul>\n          <a class=\"nf-powered\" href=\"https://github.com/nodefony/nodefony-core\" rel=\"noopener noreferrer\"><img class=\"nf-logo nf-logo-mono\" src=\"<%= it.logoHref %>\" alt=\"\" />Propuls\u00E9 par Nodefony</a>\n        </div>\n<% } %>\n      </main>\n    </div>\n  </body>\n</html>\n";
+export declare const LOGIN_PAGE_TEMPLATE = "<!doctype html>\n<html lang=\"fr\"<% if (it.theme) { %> data-theme=\"<%= it.theme %>\"<% } %>>\n  <head>\n    <meta charset=\"utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n    <meta name=\"color-scheme\" content=\"dark light\" />\n    <meta name=\"robots\" content=\"noindex\" />\n    <% if (it.nonce) { %><meta property=\"csp-nonce\" nonce=\"<%= it.nonce %>\"><% } %>\n    <title><%= it.title %> \u2014 <%= it.brand %></title>\n    <link rel=\"icon\" href=\"<%= it.logoHref %>\" type=\"image/svg+xml\" />\n<% if (!it.theme) { %>\n    <script nonce=\"<%= it.nonce %>\">try{var t=localStorage.getItem(\"nf-login-theme\");if(t===\"light\"||t===\"dark\")document.documentElement.dataset.theme=t}catch(e){}</script>\n<% } %>\n    <link rel=\"stylesheet\" href=\"<%= it.styleHref %>\" />\n<% if (it.skinHref) { %>\n    <link rel=\"stylesheet\" href=\"<%= it.skinHref %>\" />\n<% } %>\n<% if (it.stylesheetHref) { %>\n    <link rel=\"stylesheet\" href=\"<%= it.stylesheetHref %>\" />\n<% } %>\n    <script type=\"module\" src=\"<%= it.scriptHref %>\" nonce=\"<%= it.nonce %>\"></script>\n  </head>\n  <body data-skin=\"<%= it.skin %>\" data-layout=\"<%= it.layout %>\"<% if (it.backdrop) { %> data-backdrop<% } %><% if (it.ssoFirst) { %> data-sso-first<% } %>>\n    <svg width=\"0\" height=\"0\" style=\"position: absolute\" aria-hidden=\"true\">\n      <symbol id=\"i-user\" viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"8\" r=\"3.5\" /><path d=\"M5.5 20a6.5 6.5 0 0 1 13 0\" /></symbol>\n      <symbol id=\"i-lock\" viewBox=\"0 0 24 24\"><rect x=\"5\" y=\"10.5\" width=\"14\" height=\"10\" rx=\"2\" /><path d=\"M8.5 10.5V7.5a3.5 3.5 0 0 1 7 0v3\" /></symbol>\n      <symbol id=\"i-eye\" viewBox=\"0 0 24 24\"><path d=\"M2.5 12S6 5.5 12 5.5 21.5 12 21.5 12 18 18.5 12 18.5 2.5 12 2.5 12Z\" /><circle cx=\"12\" cy=\"12\" r=\"2.8\" /></symbol>\n      <symbol id=\"i-arrow\" viewBox=\"0 0 24 24\"><path d=\"M5 12h14M13 6l6 6-6 6\" /></symbol>\n      <symbol id=\"i-key\" viewBox=\"0 0 24 24\"><circle cx=\"8\" cy=\"15\" r=\"3.8\" /><path d=\"M10.8 12.2 19.5 3.5M16.5 6.5l2.5 2.5M14 9l2 2\" /></symbol>\n      <symbol id=\"i-check\" viewBox=\"0 0 24 24\"><path d=\"M5 12.5l4.5 4.5L19 7.5\" /></symbol>\n      <symbol id=\"i-finger\" viewBox=\"0 0 24 24\"><path d=\"M18.9 7a8 8 0 0 1 1.1 5v1a6 6 0 0 0 .8 3\" /><path d=\"M8 11a4 4 0 0 1 8 0v1a10 10 0 0 0 2 6\" /><path d=\"M12 11v2a14 14 0 0 0 2.5 8\" /><path d=\"M8 15a18 18 0 0 0 1.8 6\" /><path d=\"M4.9 19a22 22 0 0 1-.9-7v-1a8 8 0 0 1 12-6.95\" /></symbol>\n      <symbol id=\"i-sun\" viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"4\" /><path d=\"M12 2.5v2M12 19.5v2M4.6 4.6l1.4 1.4M18 18l1.4 1.4M2.5 12h2M19.5 12h2M4.6 19.4 6 18M18 6l1.4-1.4\" /></symbol>\n      <symbol id=\"i-moon\" viewBox=\"0 0 24 24\"><path d=\"M20 14.5A8 8 0 0 1 9.5 4a8 8 0 1 0 10.5 10.5Z\" /></symbol>\n      <symbol id=\"i-shield\" viewBox=\"0 0 24 24\"><path d=\"M12 3l7.5 3v5.5c0 4.6-3.2 8-7.5 9.5-4.3-1.5-7.5-4.9-7.5-9.5V6z\" /></symbol>\n      <symbol id=\"m-github\" viewBox=\"0 0 16 16\"><path d=\"M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27s1.36.09 2 .27c1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.01 8.01 0 0 0 16 8c0-4.42-3.58-8-8-8Z\" /></symbol>\n    </svg>\n    <header class=\"nf-strip\">\n      <div class=\"nf-strip-brand\"><img class=\"nf-logo\" src=\"<%= it.logo %>\" alt=\"\" /><%= it.brand %></div>\n    </header>\n    <div class=\"nf-layout\">\n      <aside class=\"nf-hero\" aria-hidden=\"true\">\n        <div class=\"nf-hero-brand\"><img class=\"nf-logo\" src=\"<%= it.logo %>\" alt=\"\" /><%= it.brand %></div>\n<% if (it.hero === null) { %>\n        <div class=\"nf-home\">\n          <img\n            class=\"nf-home-logo\"\n            src=\"<%= it.logoHref %>\"\n            alt=\"\"\n          />\n          <h2>Le framework Node.js fullstack</h2>\n          <p class=\"sub\">\n            Temps r\u00E9el natif \u00B7 d\u00E9veloppement agentic-ready \u00B7 socle TypeScript\n            isomorphe\n          </p>\n          <p class=\"sig\">\n            Une action de contr\u00F4leur. Deux transports. La m\u00EAme session, la m\u00EAme\n            s\u00E9curit\u00E9, le m\u00EAme code.\n          </p>\n          <ul class=\"badges\">\n            <li class=\"agentic\">Agentic ready</li>\n            <li>Node.js \u2265 24.14</li>\n            <li>TypeScript strict</li>\n            <li>ESM only</li>\n            <li>Licence Apache 2.0</li>\n          </ul>\n          <div\n            class=\"install\"\n            role=\"img\"\n            aria-label=\"Commande d'installation : npx nodefony create app\"\n          >\n            <span class=\"p\">$</span><span>npx nodefony create app</span>\n          </div>\n          <div class=\"features\">\n            <div class=\"feature\">\n              <span class=\"ic\"\n                ><svg\n                  viewBox=\"0 0 24 24\"\n                  fill=\"none\"\n                  stroke=\"currentColor\"\n                  stroke-width=\"2\"\n                  stroke-linecap=\"round\"\n                  stroke-linejoin=\"round\"\n                  aria-hidden=\"true\"\n                >\n                  <polygon\n                    points=\"13 2 3 14 12 14 11 22 21 10 12 10 13 2\"\n                  /></svg\n              ></span>\n              <h3>Temps r\u00E9el natif</h3>\n              <p>\n                Le WebSocket n'est pas un ajout : m\u00EAme pipeline, m\u00EAme table de\n                routes, m\u00EAme s\u00E9curit\u00E9 que le HTTP.\n              </p>\n            </div>\n            <div class=\"feature\">\n              <span class=\"ic\"\n                ><svg\n                  viewBox=\"0 0 24 24\"\n                  fill=\"none\"\n                  stroke=\"currentColor\"\n                  stroke-width=\"2\"\n                  stroke-linecap=\"round\"\n                  stroke-linejoin=\"round\"\n                  aria-hidden=\"true\"\n                >\n                  <path d=\"M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z\" />\n                  <path d=\"m9 12 2 2 4-4\" /></svg\n              ></span>\n              <h3>S\u00E9curit\u00E9 par conception</h3>\n              <p>\n                Pare-feu applicatif par zones, Zero Trust, CSRF Fetch Metadata,\n                sessions hybrides, WebAuthn.\n              </p>\n            </div>\n            <div class=\"feature\">\n              <span class=\"ic\"\n                ><svg\n                  viewBox=\"0 0 24 24\"\n                  fill=\"none\"\n                  stroke=\"currentColor\"\n                  stroke-width=\"2\"\n                  stroke-linecap=\"round\"\n                  stroke-linejoin=\"round\"\n                  aria-hidden=\"true\"\n                >\n                  <rect x=\"3\" y=\"3\" width=\"7\" height=\"7\" rx=\"1\" />\n                  <rect x=\"14\" y=\"3\" width=\"7\" height=\"7\" rx=\"1\" />\n                  <rect x=\"3\" y=\"14\" width=\"7\" height=\"7\" rx=\"1\" />\n                  <rect x=\"14\" y=\"14\" width=\"7\" height=\"7\" rx=\"1\" /></svg\n              ></span>\n              <h3>DI & modules</h3>\n              <p>\n                Injection de d\u00E9pendances par d\u00E9corateurs, modules autonomes,\n                configuration valid\u00E9e au boot.\n              </p>\n            </div>\n            <div class=\"feature\">\n              <span class=\"ic\"\n                ><svg\n                  viewBox=\"0 0 24 24\"\n                  fill=\"none\"\n                  stroke=\"currentColor\"\n                  stroke-width=\"2\"\n                  stroke-linecap=\"round\"\n                  stroke-linejoin=\"round\"\n                  aria-hidden=\"true\"\n                >\n                  <circle cx=\"12\" cy=\"12\" r=\"9\" />\n                  <path\n                    d=\"M3 12h18M12 3c2.5 2.6 4 5.7 4 9s-1.5 6.4-4 9c-2.5-2.6-4-5.7-4-9s1.5-6.4 4-9z\"\n                  /></svg\n              ></span>\n              <h3>Socle isomorphe</h3>\n              <p>\n                Le m\u00EAme paquet c\u00F4t\u00E9 serveur et c\u00F4t\u00E9 navigateur : client temps\n                r\u00E9el, r\u00E8gles et types \u00E9crits une fois.\n              </p>\n            </div>\n          </div>\n        </div>\n        <small>Propuls\u00E9 par Nodefony</small>\n<% } else if (it.hero) { %>\n        <div class=\"nf-home\">\n          <h2><%= it.hero.heading %></h2>\n<% if (it.hero.text) { %>\n          <p class=\"sub\"><%= it.hero.text %></p>\n<% } %>\n        </div>\n<% } %>\n      </aside>\n      <main class=\"nf-stage\" data-nf-login data-from=\"<%= it.from %>\">\n        <button type=\"button\" class=\"nf-theme\" data-theme-toggle aria-label=\"Basculer entre th\u00E8me clair et th\u00E8me sombre\"><svg class=\"nf-icon t-sun\" aria-hidden=\"true\"><use href=\"#i-sun\" /></svg><svg class=\"nf-icon t-moon\" aria-hidden=\"true\"><use href=\"#i-moon\" /></svg></button>\n        <section class=\"nf-card\" aria-labelledby=\"nf-title\">\n          <div class=\"nf-head\">\n            <div class=\"nf-brand\"><img class=\"nf-logo\" src=\"<%= it.logo %>\" alt=\"\" /><%= it.brand %></div>\n            <h1 id=\"nf-title\"><%= it.title %></h1>\n            <p class=\"nf-sub\" id=\"nf-sub\"><%= it.lead %></p>\n          </div>\n          <div class=\"nf-body\">\n<% if (it.password) { %>\n            <ol class=\"nf-steps\" aria-label=\"\u00C9tapes\">\n              <li data-tab=\"identifier\" aria-current=\"step\">Identifiant</li>\n              <li data-tab=\"password\">Mot de passe</li>\n              <li data-tab=\"mfa\" hidden>V\u00E9rification</li>\n            </ol>\n            <form data-step=\"identifier\">\n              <div class=\"nf-field\">\n                <label for=\"nf-username\">Identifiant ou adresse e-mail</label>\n                <div class=\"nf-input\">\n                  <svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-user\" /></svg>\n                  <input id=\"nf-username\" name=\"username\" autocomplete=\"username\" autocapitalize=\"none\" spellcheck=\"false\" required />\n                </div>\n              </div>\n              <button class=\"nf-btn primary\" type=\"submit\">Continuer<svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-arrow\" /></svg></button>\n            </form>\n            <form data-step=\"password\" hidden>\n              <!-- Compte de l'\u00E9tape pr\u00E9c\u00E9dente, masqu\u00E9 : le gestionnaire de mots de passe\n                   associe le mot de passe \u00E0 CE compte (HTML, jeton \u00AB username \u00BB). -->\n              <input name=\"username\" autocomplete=\"username\" hidden readonly tabindex=\"-1\" />\n              <div class=\"nf-account\">\n                <span class=\"nf-avatar\" aria-hidden=\"true\"></span><span class=\"who\"></span>\n                <button type=\"button\" class=\"nf-link\" data-go=\"identifier\">Changer</button>\n              </div>\n              <div class=\"nf-field\">\n                <div class=\"nf-label-row\"><label for=\"nf-password\">Mot de passe</label></div>\n                <div class=\"nf-input\">\n                  <svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-lock\" /></svg>\n                  <input id=\"nf-password\" name=\"password\" type=\"password\" autocomplete=\"current-password\" required />\n                  <button type=\"button\" class=\"nf-reveal\" data-reveal aria-label=\"Afficher le mot de passe\" aria-pressed=\"false\"><svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-eye\" /></svg></button>\n                </div>\n              </div>\n              <button class=\"nf-btn primary\" type=\"submit\">Se connecter<svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-arrow\" /></svg></button>\n            </form>\n            <form data-step=\"mfa\" hidden>\n              <div class=\"nf-field\">\n                <label id=\"nf-otp-label\">Code \u00E0 6 chiffres</label>\n                <div class=\"nf-otp\" role=\"group\" aria-labelledby=\"nf-otp-label\">\n                  <input inputmode=\"numeric\" maxlength=\"1\" autocomplete=\"one-time-code\" aria-label=\"Chiffre 1\" /><input inputmode=\"numeric\" maxlength=\"1\" aria-label=\"Chiffre 2\" /><input inputmode=\"numeric\" maxlength=\"1\" aria-label=\"Chiffre 3\" /><input inputmode=\"numeric\" maxlength=\"1\" aria-label=\"Chiffre 4\" /><input inputmode=\"numeric\" maxlength=\"1\" aria-label=\"Chiffre 5\" /><input inputmode=\"numeric\" maxlength=\"1\" aria-label=\"Chiffre 6\" />\n                </div>\n              </div>\n              <p class=\"nf-hint\">Le code affich\u00E9 par votre application d'authentification.</p>\n              <button class=\"nf-btn primary\" type=\"submit\">V\u00E9rifier</button>\n            </form>\n<% } %>\n<% if (it.password || it.passkey) { %>\n            <div data-step=\"authenticated\" hidden>\n              <div class=\"nf-done\" role=\"status\">\n                <span class=\"ring\" aria-hidden=\"true\"><svg class=\"nf-icon\"><use href=\"#i-check\" /></svg></span>\n                <strong>Session ouverte</strong><span class=\"dest\"></span>\n                <span class=\"nf-progress\" aria-hidden=\"true\"><span></span></span>\n              </div>\n            </div>\n<% } %>\n<% if (it.providers.length > 0 || it.passkey) { %>\n            <div data-alt>\n<% if (it.password) { %>\n              <div class=\"nf-or\">ou</div>\n<% } %>\n              <div class=\"nf-alt\">\n<% if (it.passkey) { %>\n                <button type=\"button\" class=\"nf-btn span\" data-passkey hidden><svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-finger\" /></svg>Passkey / empreinte digitale</button>\n<% } %>\n<% it.providers.forEach(function (provider) { %>\n                <a class=\"nf-btn\" href=\"<%= provider.href %>\"><% if (provider.image) { %><img class=\"nf-icon\" src=\"<%= provider.image %>\" alt=\"\" /><% } else { %><svg class=\"<%= provider.icon === 'm-github' ? 'nf-mark' : 'nf-icon' %>\" aria-hidden=\"true\"><use href=\"#<%= provider.icon %>\" /></svg><% } %><% if (provider.caption) { %><span class=\"nf-label\"><%= provider.label %><small><%= provider.caption %></small></span><% } else { %><%= provider.label %><% } %></a>\n<% }) %>\n              </div>\n            </div>\n<% } %>\n            <div class=\"nf-message\" aria-live=\"polite\" data-message><% if (it.empty) { %><p class=\"nf-alert\" role=\"alert\"><span class=\"code\">\u2014</span><span>Aucun moyen de connexion n'est disponible pour le moment. Pr\u00E9venez l'administrateur du site.</span></p><% } else if (it.notice) { %><p class=\"nf-alert\" role=\"alert\"><span class=\"code\">SSO</span><span><%= it.notice %></span></p><% } %></div>\n<% if (it.password || it.passkey) { %>\n            <noscript><p class=\"nf-hint\">Cette page a besoin de JavaScript pour vous connecter.</p></noscript>\n<% } %>\n          </div>\n        </section>\n<% if (it.picker) { %>\n        <form class=\"nf-picker\" method=\"get\" data-preview-picker<% if (it.picker.hook) { %> data-preview-hook=\"<%= it.picker.hook %>\"<% } %> aria-label=\"Aper\u00E7u de la page (d\u00E9veloppement)\">\n          <input type=\"hidden\" name=\"from\" value=\"<%= it.from %>\" />\n          <label>Habillage <select name=\"skin\"><% it.picker.skins.forEach(function (skin) { %><option value=\"<%= skin %>\"<% if (skin === it.skin) { %> selected<% } %>><%= skin %></option><% }) %></select></label>\n          <label>Mise en page <select name=\"layout\"><% it.picker.layouts.forEach(function (layout) { %><option value=\"<%= layout %>\"<% if (layout === it.layout) { %> selected<% } %>><%= layout %></option><% }) %></select></label>\n          <noscript><button type=\"submit\">Appliquer</button></noscript>\n        </form>\n<% } %>\n<% if (it.footer) { %>\n        <div class=\"nf-foot\">\n          <ul class=\"nf-facts\" aria-label=\"Protection de la session\">\n            <li><svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-shield\" /></svg>cookie HttpOnly</li>\n            <li><svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-shield\" /></svg>anti-CSRF</li>\n            <li><svg class=\"nf-icon\" aria-hidden=\"true\"><use href=\"#i-shield\" /></svg>CSP stricte</li>\n          </ul>\n          <a class=\"nf-powered\" href=\"https://github.com/nodefony/nodefony-core\" rel=\"noopener noreferrer\"><img class=\"nf-logo nf-logo-mono\" src=\"<%= it.logoHref %>\" alt=\"\" />Propuls\u00E9 par Nodefony</a>\n        </div>\n<% } %>\n      </main>\n    </div>\n  </body>\n</html>\n";

package/dist/types/nodefony/src/syslogFilters.d.ts

@@ -28,6 +28,8 @@ export declare const SYSLOG_FILTERS: {
     readonly module: "string";
     /** Catégorie de message (msgid) — inclusion insensible à la casse. */
     readonly msgid: "string";
+    /** Module exclu — égalité insensible à la casse (`NODEFONY` = le framework). */
+    readonly excludeModule: "string";
     /** Protocole d'origine ; absent = les deux. */
     readonly protocol: readonly ["ws", "http"];
     /**
@@ -45,6 +47,10 @@ export declare const SYSLOG_FILTERS: {
     readonly flow: {
         readonly each: FlowStepId[];
     };
+    /** Écarte les lignes d'accès de la console d'administration elle-même. */
+    readonly hideConsole: "boolean";
+    /** Une ligne par requête (sa ligne d'accès), avec le nombre de lignes regroupées. */
+    readonly groupByRequest: "boolean";
     /** Borne basse d'horodatage (epoch ms, incluse). */
     readonly from: "int";
     /** Borne haute d'horodatage (epoch ms, incluse). */

package/dist/types/nodefony/src/viewNonce.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Signature CSP des vues : chaque `<script>` et `<style>` ÉCRIT dans un
+ * gabarit reçoit le nonce de la requête, sans geste de l'auteur.
+ *
+ * La politique par défaut exige un nonce sur les scripts (`'strict-dynamic'`)
+ * et sur les styles (ADR-0024 §C1, §C2). Une page écrite vite, par quelqu'un
+ * qui ignore tout de la CSP, ne doit pas être bloquée (§C0) : la signature se
+ * pose donc au rendu, par le framework.
+ *
+ * Elle porte sur le TEXTE DU GABARIT, avant que les données y soient insérées :
+ * une balise que les données apporteraient (une valeur insérée brute par
+ * `<%~ %>`) n'est jamais signée — c'est ce qui garde au nonce sa valeur contre
+ * l'injection. Même principe que l'`index.html` d'un front bâti
+ * (`prebuiltUi.ts#splitAroundNonce`).
+ */
+/** Variable de vue qui porte le nonce CSP de la requête (`<%= cspNonce %>`). */
+export declare const VIEW_NONCE_LOCAL = "cspNonce";
+/**
+ * Ajoute le nonce de la requête à chaque `<script>` et `<style>` littéral du
+ * gabarit qui n'en porte pas.
+ *
+ * Une balise déjà signée par l'auteur est laissée telle quelle ; un `<script`
+ * écrit À L'INTÉRIEUR d'une balise Eta (une chaîne de code) n'est jamais
+ * touché. Un `<script>` dont un attribut vient des données
+ * (`src="<%= it.url %>"`) n'est pas signé non plus : le signer exécuterait
+ * l'URL qu'elles apportent. L'auteur qui la tient pour sûre signe lui-même
+ * (`nonce="<%= it.cspNonce %>"`). Le rendu doit fournir la variable
+ * {@link VIEW_NONCE_LOCAL}.
+ *
+ * @param source - texte du gabarit Eta, tel que lu sur le disque.
+ * @returns le gabarit signé — la MÊME chaîne quand il n'y a rien à signer.
+ */
+export declare function signTemplateTags(source: string): string;

package/docs/admin.md

@@ -82,7 +82,7 @@ Trois idées à retenir :
 | RBAC                  | _Role-Based Access Control_ : l'accès dépend des rôles de l'appelant.                                      |
 | `ROLE_NODEFONY_*`     | Rôles de la **plateforme** (admin du framework), distincts des rôles applicatifs `ROLE_*` d'un tenant.     |
 | Pont / dispatch       | Le controller unique qui, à chaque requête, retrouve l'endpoint et exécute son handler.                    |
-| API souveraine        | Toute action admin déclare AUSSI le transport WebSocket → invocable par le pont WS-RPC `api.request`.      |
+| Deux transports       | Toute action admin déclare AUSSI le transport WebSocket → invocable par le pont WS-RPC `api.request`.      |
 | Duplex                | Une même action servie sur HTTP **et** WebSocket (le différenciateur Nodefony).                            |
 | Catalogue / discovery | La liste des producteurs + endpoints, exposée en JSON pour que Studio bâtisse sa navigation.               |
 | Playground            | La console dev qui joue n'importe quel controller depuis le navigateur (`/nodefony/playground`).           |
@@ -327,7 +327,7 @@ laissez-passer.
 > applicatifs `ROLE_*` d'un tenant. Un endpoint peut exiger un rôle plus fin (`role: "ROLE_…"`) ou
 > graduer l'information **dans** son handler en lisant `request.roles`.
 
-## 🔌 HTTP et WebSocket — la même action (API souveraine)
+## 🔌 HTTP et WebSocket — la même action
 
 Toute action admin déclare **aussi** le transport `WEBSOCKET` (`AdminBroker.ts#AdminBroker.mountAll`) : la route est
 montée avec `[method, "WEBSOCKET"]`. Elle devient donc invocable par le pont WS-RPC `api.request`
@@ -362,6 +362,55 @@ Trois pas, du point de vue d'un module :
 **Handlers lazy** : résous tes services **dans** le handler (à la requête), jamais au montage — un
 service désactivable renvoie alors `503` proprement au lieu de casser le boot.
 
+### Ce que publie un endpoint — l'état réel, aucun secret, ses capacités déclarées
+
+Tout ce que renvoie un handler part tel quel vers la console, le pont socket et les agents. Trois
+règles en découlent.
+
+**1. Un DTO ne porte aucun secret : il en dit la présence.** Un mot de passe, une clé ou un jeton
+se décrivent par un booléen. Le résumé d'un utilisateur expose `hasPassword`, jamais le hash
+(`UserAdminApi.ts#IUserSummary`). La description du pare-feu expose `synchronizerToken: boolean`
+(`IFirewallDescription.ts#IFirewallDescription`). La redaction se fait **en construisant** le DTO,
+champ par champ. Copier l'objet puis retirer les clés sensibles laisserait passer la prochaine qui
+sera ajoutée. Un test le prouve : `JSON.stringify(dto)` ne contient pas la valeur sentinelle posée
+dans la configuration.
+
+**2. Une description montre ce qui TOURNE, pas la configuration relue.** Une méthode `describe()`
+lit les structures que le service a bâties au démarrage
+(`IFirewall.ts#IFirewall.describe`, `IBackplane.ts#IBackplane.describe`). Un authenticator mal
+orthographié dans la configuration n'y figure pas, puisqu'il n'est pas monté. Relire la
+configuration montrerait l'intention, et la console afficherait comme active une défense qui ne
+tourne pas.
+
+**3. Une capacité de liste non déclarée est refusée en `400`, jamais ignorée.** Tri, filtres,
+recherche et facettes se déclarent dans `page` (`IAdminApi.ts#IAdminPageCapabilities`), et le
+handler lit **la même donnée** : il passe ses champs triables à `parsePageQuery()`
+(`pageQuery.ts#parsePageQuery`) et son vocabulaire de filtres à `parseFilters()`
+(`pageFilters.ts#parseFilters`). Ces deux lecteurs refusent en `400` un tri hors liste, un `?q=`
+sur un endpoint qui ne cherche pas, une valeur mal formée et un paramètre que personne ne
+reconnaît. Lire `request.query.order` à la main renvoie une page non triée que le client prend pour
+triée. Avec un filtre mal orthographié, c'est la collection entière qui revient.
+
+```typescript ignore
+import { parseFilters, parsePageQuery, type IAdminEndpoint } from "nodefony";
+
+// Une constante, deux lectures : le catalogue et le handler ne peuvent pas diverger.
+const SORTABLE = ["createdAt", "total"] as const;
+const FILTERS = { status: ["paid", "pending", "refunded"] } as const;
+
+const listOrders: IAdminEndpoint = {
+  path: "orders",
+  method: "GET",
+  summary: "Commandes, paginées.",
+  page: { sortable: () => SORTABLE, filters: FILTERS },
+  handler: async (request) => {
+    const query = parsePageQuery(request.query, { sortable: SORTABLE }); // ?order=x → 400
+    const filters = parseFilters(request.query, FILTERS); // ?status=zzz, ?stauts= → 400
+    return orders.listPage({ ...query, ...filters });
+  },
+};
+```
+
 ### Les producteurs réels (à imiter, sans les redocumenter)
 
 Le broker lui-même est déclaré comme service du framework (`index.ts`). Les producteurs internes