@nodefony/http 10.0.0-beta.4 → 10.0.0-beta.5

package/dist/index.js

@@ -2,12 +2,13 @@ import { normalizePrefix, parseProxyOrigin, proxyMountProblems } from "./nodefon
 import config, { httpConfigSchema, httpOverlaySchema } from "./nodefony/config/config.js";
 import { defineHttpConfig, httpConfigJsonSchema } from "./nodefony/config/defineModuleConfig.js";
 import { createHttpAdminApi } from "./nodefony/service/HttpAdminApi.js";
-import { createProfilerAdminApi } from "./nodefony/service/ProfilerAdminApi.js";
 import { ACTION_SELF_PHASE, NO_ROUTE, N_PLUS_ONE_MIN_REPEATS, TOOLING_URL_PREFIX, aggregateProfiles, createProfileAggregator, isFailedProfile, sqlShape } from "./nodefony/src/profiler/aggregate.js";
+import { createProfilerAdminApi } from "./nodefony/service/ProfilerAdminApi.js";
 import { Profiler } from "./nodefony/src/profiler/Profiler.js";
 import HttpError from "./nodefony/src/errors/httpError.js";
 import { MemoryRateLimitStore } from "./nodefony/src/rateLimit/MemoryRateLimitStore.js";
 import { compileDomainPattern, compileDomainPatterns, compileTrustedHosts, isDomainAllowed } from "./nodefony/src/context/domainMatcher.js";
+import { REQUEST_TRACE_CHANNEL } from "./nodefony/src/context/requestTrace.js";
 import Cookie from "./nodefony/src/cookies/cookie.js";
 import Context from "./nodefony/src/context/Context.js";
 import { decideSend, readBackpressureOptions } from "./nodefony/src/context/websocket/wsBackpressure.js";
@@ -115,4 +116,4 @@ Http = __decorate([services([
 	upload_service_default
 ])], Http);
 var http_default = Http;
-export { ACTION_SELF_PHASE, Context, Cookie, DefaultErrorRenderer, DefaultRequestLogger, FrameProfile, Http2Request, Http2Response, HttpContext, HttpError, http_kernel_default as HttpKernel, HttpRequest, HttpResponse, HttpResponse as Response, JsonAuditLogger, MemoryRateLimitStore, NO_ROUTE, N_PLUS_ONE_MIN_REPEATS, PrebuiltUi, PrettyRequestLogger, Profiler, ReverseProxy, SESSION_COLUMN_ALIASES, SESSION_DEFAULT_ORDER, SESSION_DEFAULT_ORDER_SQL, SESSION_SORTABLE_FIELDS, SSE_HEARTBEAT_MS, Session, sessions_service_default as SessionsService, SseStream, TOOLING_URL_PREFIX, WebsocketContext, WebsocketResponse, WebsocketResponse as wsResponse, acceptsEventStream, aggregateProfiles, compileDomainPattern, compileDomainPatterns, compileTrustedHosts, createProfileAggregator, decideSend, http_default as default, defineHttpConfig, httpConfigJsonSchema, httpConfigSchema, isDomainAllowed, isFailedProfile, isWebsocketContext, normalizePrefix, openSseStream, parseProxyOrigin, proxyMountProblems, readBackpressureOptions, resolveUiDelivery, schemaMismatchOf, sqlShape, toValidationFields };
+export { ACTION_SELF_PHASE, Context, Cookie, DefaultErrorRenderer, DefaultRequestLogger, FrameProfile, Http2Request, Http2Response, HttpContext, HttpError, http_kernel_default as HttpKernel, HttpRequest, HttpResponse, HttpResponse as Response, JsonAuditLogger, MemoryRateLimitStore, NO_ROUTE, N_PLUS_ONE_MIN_REPEATS, PrebuiltUi, PrettyRequestLogger, Profiler, REQUEST_TRACE_CHANNEL, ReverseProxy, SESSION_COLUMN_ALIASES, SESSION_DEFAULT_ORDER, SESSION_DEFAULT_ORDER_SQL, SESSION_SORTABLE_FIELDS, SSE_HEARTBEAT_MS, Session, sessions_service_default as SessionsService, SseStream, TOOLING_URL_PREFIX, WebsocketContext, WebsocketResponse, WebsocketResponse as wsResponse, acceptsEventStream, aggregateProfiles, compileDomainPattern, compileDomainPatterns, compileTrustedHosts, createProfileAggregator, decideSend, http_default as default, defineHttpConfig, httpConfigJsonSchema, httpConfigSchema, isDomainAllowed, isFailedProfile, isWebsocketContext, normalizePrefix, openSseStream, parseProxyOrigin, proxyMountProblems, readBackpressureOptions, resolveUiDelivery, schemaMismatchOf, sqlShape, toValidationFields };

package/dist/nodefony/config/config.js

@@ -297,7 +297,8 @@ const proxyMountSchema = z.strictObject({
 	preserveHost: z.boolean().default(false).describe("Transmet le `Host` du client au lieu de celui de la cible. Défaut false : l'amont reçoit son propre nom (ce qu'attend un serveur qui filtre les noms d'hôte), le nom d'origine part en `X-Forwarded-Host`."),
 	stripHeaders: z.array(z.string()).default([]).describe("En-têtes de requête à ne PAS transmettre (ex. `[\"cookie\", \"authorization\"]` vers un amont qui n'a pas à voir la session). Les en-têtes de connexion (RFC 9110 §7.6.1) ne le sont jamais."),
 	timeoutMs: z.number().optional().describe("Délai d'inactivité avec l'amont (ms) — dépassé avant la réponse (ou avant le `101` d'un upgrade WebSocket) : 504. Absent = `proxy.timeoutMs`. Ne s'applique pas à un WebSocket établi."),
-	secure: z.boolean().default(true).describe("Vérifie le certificat d'une cible https. `false` n'est accepté que vers la boucle locale (`127.0.0.0/8`, `localhost`, `::1`) ; ailleurs, fournir l'autorité de l'amont (`certificates.extraCaFiles`, ou `NODE_EXTRA_CA_CERTS`).")
+	secure: z.boolean().default(true).describe("Vérifie le certificat d'une cible https. `false` n'est accepté que vers la boucle locale (`127.0.0.0/8`, `localhost`, `::1`) ; ailleurs, fournir l'autorité de l'amont (`certificates.extraCaFiles`, ou `NODE_EXTRA_CA_CERTS`)."),
+	accessLog: z.enum(["all", "errors"]).default("all").describe("Ligne d'accès des requêtes relayées : `all` (défaut) les écrit toutes, `errors` seulement celles en échec (statut ≥ 400) — pour un amont qui sert beaucoup de petits fichiers.")
 }).describe("Un montage du proxy inverse : un préfixe d'URL relayé vers un amont.");
 const proxySchema = z.strictObject({
 	timeoutMs: z.number().int().positive().default(3e4).describe("Délai d'inactivité par défaut de tous les montages (ms) : un amont muet au-delà rend 504 Gateway Timeout. Défaut 30 s."),

package/dist/nodefony/interfaces/IRequestTrace.js

@@ -0,0 +1 @@
+export {};

package/dist/nodefony/service/ProfilerAdminApi.js

@@ -1,3 +1,4 @@
+import { aggregateProfiles } from "../src/profiler/aggregate.js";
 // nodefony/service/ProfilerAdminApi.ts
 /**
 * Producteur `IAdminApi` du **profiler** — exposé sous `/nodefony/profiler/api/*`.
@@ -9,6 +10,9 @@
 *
 * Endpoints :
 *  - `GET /nodefony/profiler/api/recent`  → derniers profils (résumés, récent → ancien)
+*    `?connection=<requestId>` : les seules frames de cette socket WebSocket
+*  - `GET /nodefony/profiler/api/summary` → les profils de l'anneau agrégés par
+*    route (percentiles, phases, formes SQL, N+1, erreurs — `aggregateProfiles`)
 *  - `GET /nodefony/profiler/api/{id}`    → profil complet (phases) d'un requestId
 *  - `DELETE /nodefony/profiler/api/recent` → vide le ring buffer
 *
@@ -32,9 +36,11 @@ function createProfilerAdminApi(profiler) {
 				const raw = query.limit;
 				const n = typeof raw === "string" ? parseInt(raw, 10) : NaN;
 				const limit = Number.isFinite(n) && n > 0 ? Math.min(n, 200) : 60;
+				const of = query.connection;
+				const connection = typeof of === "string" && of.length > 0 && of.length <= 200 ? of : void 0;
 				return {
 					count: profiler.size,
-					entries: profiler.recent(limit)
+					entries: profiler.recent(limit, connection)
 				};
 			}
 		},
@@ -47,6 +53,11 @@ function createProfilerAdminApi(profiler) {
 				return { cleared: true };
 			}
 		},
+		{
+			path: "summary",
+			summary: "Profiles aggregated by route: percentiles, SQL, N+1, errors",
+			handler: () => aggregateProfiles(profiler.since(0).entries)
+		},
 		{
 			path: "{id}",
 			summary: "Full profile (phase timeline) for a requestId",

package/dist/nodefony/service/audit-logger.js

@@ -1,5 +1,4 @@
 import { handshakeRefusalStatus } from "../src/context/websocket/WebsocketContext.js";
-import { performance } from "node:perf_hooks";
 // nodefony/service/audit-logger.ts
 const statusOf = (context) => {
 	return context.response?.statusCode ?? null;
@@ -8,19 +7,6 @@ const headersOf = (context) => {
 	return context.request?.headers ?? {};
 };
 /**
-* Durée totale de la requête, de la première phase (`startMs`) à maintenant.
-* `null` si le chronométrage est coupé (aucune phase enregistrée). Partagée
-* par le journal d'audit et le journal lisible — une seule définition.
-*
-* @param phases - phases chronométrées du contexte
-* @returns durée en millisecondes, ou `null`
-*/
-function computeDurationMs(phases) {
-	const first = phases.at(0);
-	if (first === void 0 || typeof first.startMs !== "number") return null;
-	return performance.now() - first.startMs;
-}
-/**
 * Severity derived from HTTP status code — RFC 9110 categories.
 * 1xx/2xx/3xx → INFO ; 4xx → WARNING ; 5xx → ERROR.
 * Unknown/missing status → INFO.
@@ -96,7 +82,7 @@ var JsonAuditLogger = class {
 			method: ctx.method,
 			url: ctx.url,
 			status,
-			durationMs: computeDurationMs(ctx.phases),
+			durationMs: ctx.stopClock(),
 			remoteAddress: ctx.remoteAddress ?? null,
 			host: ctx.getHost() ?? null,
 			userAgent: ctx.getUserAgent() ?? null,
@@ -128,7 +114,7 @@ var JsonAuditLogger = class {
 			method: ctx.method,
 			url: ctx.url,
 			status,
-			durationMs: computeDurationMs(ctx.phases),
+			durationMs: ctx.stopClock(),
 			remoteAddress: ctx.remoteAddress ?? null,
 			host: ctx.getHost() ?? null,
 			userAgent: ctx.getUserAgent() ?? null,
@@ -165,4 +151,4 @@ var JsonAuditLogger = class {
 		return entry;
 	}
 };
-export { computeDurationMs, JsonAuditLogger as default, severityFromStatus };
+export { JsonAuditLogger as default, severityFromStatus, statusOf };

package/dist/nodefony/service/http-kernel.js

@@ -1,3 +1,4 @@
+import { isProfiledUrl } from "../src/profiler/aggregate.js";
 import HttpError from "../src/errors/httpError.js";
 import { buildTrustProxy } from "../src/context/trustProxy.js";
 import { resolveForwarded } from "../src/context/forwarded.js";
@@ -5,6 +6,8 @@ import { MemoryRateLimitStore } from "../src/rateLimit/MemoryRateLimitStore.js";
 import { WsConnectionCounter } from "../src/rateLimit/WsConnectionCounter.js";
 import { compileDomainPatterns, compileTrustedHosts, isDomainAllowed } from "../src/context/domainMatcher.js";
 import { responseEnded } from "../src/context/responseEnded.js";
+import { unsentResponseWarning } from "../src/context/unsentResponse.js";
+import { closeRequestTrace, hasRequestTraceSubscribers, openRequestTrace, runTraced } from "../src/context/requestTrace.js";
 import { parseWebsocketUrl } from "../src/context/websocket/websocketUrl.js";
 import WebsocketContext, { toHandshakeStatus } from "../src/context/websocket/WebsocketContext.js";
 import { trackPong } from "./servers/wsHeartbeat.js";
@@ -110,6 +113,8 @@ let HttpKernel = class HttpKernel extends Service {
 	errorRenderer = new DefaultErrorRenderer();
 	requestLogger = new DefaultRequestLogger();
 	profiler = null;
+	/** `timing.tooling` : profiler aussi l'outillage (lu une fois, à onReady). */
+	profileTooling = false;
 	_trustProxyChecker = null;
 	_wsOriginPolicy = Object.create(null);
 	rateLimiter = null;
@@ -207,6 +212,36 @@ let HttpKernel = class HttpKernel extends Service {
 	get rateLimitStore() {
 		return this.rateLimiter;
 	}
+	/**
+	* Cette requête — ou cette frame du pont — se profile-t-elle ? Jamais sans
+	* profileur (production). L'outillage (console, profileur, journaux, Vite :
+	* `isProfiledUrl`, sur la règle `isConsolePath` du cœur) seulement sous
+	* `timing.tooling` — on ne
+	* mesure pas la façon dont on mesure : ni tampon SQL, ni instantané, ni place
+	* dans les anneaux du profileur.
+	*
+	* @param url - URL ou chemin de la requête
+	* @returns `true` quand le profil doit être pris
+	*/
+	shouldProfile(url) {
+		return this.profiler !== null && isProfiledUrl(url, this.profileTooling);
+	}
+	/**
+	* En développement, signale une action qui a rendu une valeur que le
+	* Resolver ne sait pas envoyer (`null`, `undefined`, instance de classe)
+	* et n'a rien envoyé elle-même : la requête attend son délai d'expiration.
+	* Le message nomme l'action, ce qu'elle a rendu et le geste qui convient
+	* (`unsentResponseWarning`).
+	*
+	* Appelé au timeout, AVANT que le 504/408 parte — après, `sended` est vrai et
+	* plus rien ne se signalerait — et au démontage, pour un client parti avant.
+	* Gratuit en production : rien n'est lu au-delà de `waitAsync`.
+	*
+	* @param context - le contexte HTTP de la requête
+	*/
+	warnUnsentResponse(context) {
+		if (context.waitAsync && !context.sended && this.kernel?.environment === "development") this.log(unsentResponseWarning(context.resolver, context.url), "WARNING");
+	}
 	configureRateLimit() {
 		this.rateLimitGc?.stop();
 		this.rateLimitGc = null;
@@ -277,6 +312,8 @@ let HttpKernel = class HttpKernel extends Service {
 			this.regAlias = this.compileAlias();
 			this.sessionService = this.get("sessions");
 			this.profiler = this.get("profiler");
+			const timing = this.kernel?.options.timing;
+			this.profileTooling = typeof timing === "object" && timing !== null && "tooling" in timing && timing.tooling === true;
 			this.configureRateLimit();
 			this.configureWsConnectionLimit();
 			this.configureHealth();
@@ -816,10 +853,12 @@ let HttpKernel = class HttpKernel extends Service {
 	teardownHttp(context, scope) {
 		if (context.finished) return void 0;
 		try {
-			if (context.waitAsync && !context.sended && this.kernel?.environment === "development") this.log(`Action "${context.resolver?.route?.name ?? context.url}" returned a non-renderable value (void/null/class instance) and never sent a response. Use 'return <object|string|number|boolean|Buffer>' (auto-JSON) or send/stream manually.`, "WARNING");
+			context.stopClock();
+			if (context.waitAsync) this.warnUnsentResponse(context);
 			context.logRequest();
+			if (context.requestTrace !== null) closeRequestTrace(context, context.response.statusCode, context.error);
 			context.logPhasesVerbose();
-			this.profiler?.collect(context);
+			if (this.shouldProfile(context.url)) this.profiler?.collect(context);
 			const afterResponse = context._runAfterResponse();
 			if (afterResponse !== void 0 || context.listenerCount("onFinish")) return this.finishTeardownHttp(context, scope, afterResponse);
 			this.releaseHttpContext(context, scope);
@@ -903,7 +942,7 @@ let HttpKernel = class HttpKernel extends Service {
 		try {
 			context = this.createHttpContext(scope, request, response, type);
 			const created = context;
-			const served = this.listenerCount("onCreateContext") ? this.fireAsync("onCreateContext", created).then(() => this.serveHttpContext(created, scope, request, response)) : this.serveHttpContext(created, scope, request, response);
+			const served = hasRequestTraceSubscribers() ? runTraced(openRequestTrace(created, "http"), this.dispatchHttpContext, this, created, scope, request, response) : this.dispatchHttpContext(created, scope, request, response);
 			if (!isPromise(served)) return served;
 			return served.catch((e) => this.failHttp(e, created, scope));
 		} catch (e) {
@@ -911,12 +950,26 @@ let HttpKernel = class HttpKernel extends Service {
 		}
 	}
 	/**
+	* Sert un contexte HTTP fraîchement créé : le crochet `onCreateContext`
+	* s'il a des écouteurs, puis le pipeline.
+	*
+	* Hot path : `fireAsync` est une fonction async → 1 Promise + 1 microtask
+	* MÊME à 0 listener. En prod sans @nodefony/security ces seams
+	* (onCreateContext/beforeResolve/afterAuth) n'ont aucun listener → garde
+	* `listenerCount` (O(1), 0 alloc) pour ne RIEN planifier.
+	*
+	* @returns le contexte servi, ou sa promesse
+	*/
+	dispatchHttpContext(context, scope, request, response) {
+		return this.listenerCount("onCreateContext") ? this.fireAsync("onCreateContext", context).then(() => this.serveHttpContext(context, scope, request, response)) : this.serveHttpContext(context, scope, request, response);
+	}
+	/**
 	* Traceparent, tampon du profileur, puis le pipeline dans la bulle ALS de la
 	* requête (`RequestContext.run`).
 	*/
 	serveHttpContext(context, scope, request, response) {
 		context.traceparent = resolveTraceparent(request.headers.traceparent);
-		const profilerQueries = this.profiler ? [] : null;
+		const profilerQueries = this.shouldProfile(context.url) ? [] : null;
 		context.profilerQueries = profilerQueries;
 		context.profiling = profilerQueries !== null;
 		const store = {
@@ -968,7 +1021,10 @@ let HttpKernel = class HttpKernel extends Service {
 	routeHttpRequest(httpContext, request, response) {
 		if (this.reverseProxy !== null && this.reverseProxy.mounts !== null && (httpContext.validDomain || !this.domainCheck)) {
 			const relayed = this.reverseProxy.forward(request, response, httpContext.scheme);
-			if (relayed !== void 0) return relayed.then(() => httpContext);
+			if (relayed !== void 0) {
+				httpContext.relayAccessLog = this.reverseProxy.match(request.url)?.accessLog ?? "all";
+				return relayed.then(() => httpContext);
+			}
 		}
 		httpContext.phaseStart("resolve");
 		httpContext.resolver = this.router ? this.router.resolve(httpContext) : null;
@@ -1146,7 +1202,7 @@ let HttpKernel = class HttpKernel extends Service {
 				scope
 			};
 			context?.holdRequestStore(store);
-			return await RequestContext.run(store, async () => {
+			const pipeline = async () => {
 				await this.onConnect(context, error);
 				if (this.firewall && context?.secure) {
 					context.phaseStart("firewall");
@@ -1168,6 +1224,7 @@ let HttpKernel = class HttpKernel extends Service {
 				const accepted = admission.accept();
 				const ws = accepted instanceof Promise ? await accepted : accepted;
 				if (ws === null) {
+					if (context.requestTrace !== null) closeRequestTrace(context, null, null);
 					this.releaseOrphanWsScope(scope, context);
 					return;
 				}
@@ -1180,20 +1237,36 @@ let HttpKernel = class HttpKernel extends Service {
 				} finally {
 					context.phaseEnd("action");
 				}
-			});
+			};
+			return await (context !== null && hasRequestTraceSubscribers() ? runTraced(openRequestTrace(context, "websocket"), RequestContext.run, RequestContext, store, pipeline) : RequestContext.run(store, pipeline));
 		} catch (e) {
 			try {
 				await this.onError(e, context);
 			} catch (errorHandlingError) {
 				admission.refuse(500);
+				this.closeFailedWebsocketTrace(context, e);
 				this.releaseOrphanWsScope(scope, context);
 				throw errorHandlingError;
 			}
 			admission.refuse(500);
+			this.closeFailedWebsocketTrace(context, e);
 			this.releaseOrphanWsScope(scope, context);
 			throw e;
 		}
 	}
+	/**
+	* Fin du canal `nodefony.http.request` pour un handshake interrompu par une
+	* exception — sans effet si un refus l'a déjà publiée (`refuseHandshake`).
+	* Le statut est un fait, pas une déduction : une socket rattachée dit que
+	* le `101` est parti ; sinon c'est le `500` du filet qui a été rendu.
+	*
+	* @param context - le contexte du handshake, `null` s'il n'a pu être construit
+	* @param error - l'exception qui a interrompu le pipeline
+	*/
+	closeFailedWebsocketTrace(context, error) {
+		if (!context?.requestTrace) return;
+		closeRequestTrace(context, context.connection !== null ? 101 : 500, error);
+	}
 	releaseOrphanWsScope(scope, context) {
 		if (!context) {
 			this.container?.leaveScope(scope);

package/dist/nodefony/service/pretty-request-logger.js

@@ -1,6 +1,6 @@
 import { handshakeRefusalStatus } from "../src/context/websocket/WebsocketContext.js";
-import { computeDurationMs, severityFromStatus } from "./audit-logger.js";
-import { logColor } from "nodefony";
+import { severityFromStatus, statusOf } from "./audit-logger.js";
+import { accessStatusFamily, logColor } from "nodefony";
 // nodefony/service/pretty-request-logger.ts
 /**
 * Pretty single-line logger for dev (P3.2) — the biggest gain for humans.
@@ -24,9 +24,9 @@ var PrettyRequestLogger = class {
 	renderHttp(context, error) {
 		const ctx = context;
 		const err = error ?? ctx.error ?? null;
-		const status = ctx.response?.statusCode ?? (err ? 500 : null);
+		const status = statusOf(ctx) ?? (err ? 500 : null);
 		const method = ctx.method ?? "?";
-		const duration = computeDurationMs(ctx.phases);
+		const duration = ctx.stopClock();
 		return {
 			text: `${logColor.cyan(method.padEnd(4))} ${colorizeStatus(status)} ${ctx.url} ${logColor.blackBright(formatDuration(duration))} ${logColor.blackBright(ctx.remoteAddress ?? "-")} ` + logColor.magenta(`[${shortId(ctx.requestId)}]`) + (err ? ` ${logColor.red(err.message)}` : ""),
 			severity: severityFromStatus(status),
@@ -36,8 +36,8 @@ var PrettyRequestLogger = class {
 	renderWebsocket(context, error, acceptedProtocol) {
 		const ctx = context;
 		const refused = error ? handshakeRefusalStatus(context, error) : null;
-		const status = refused ?? ctx.response?.statusCode ?? (error ? 500 : null);
-		const duration = computeDurationMs(ctx.phases);
+		const status = refused ?? statusOf(ctx) ?? (error ? 500 : null);
+		const duration = ctx.stopClock();
 		const proto = acceptedProtocol ? `[${acceptedProtocol}]` : "";
 		return {
 			text: `${logColor.cyan("WS  ")} ${colorizeStatus(status)} ${ctx.url} ${logColor.blackBright(proto)} ${logColor.blackBright(formatDuration(duration))} ${logColor.blackBright(ctx.remoteAddress ?? "-")} ` + logColor.magenta(`[${shortId(ctx.requestId)}]`) + (error ? ` ${logColor.red(error.message)}` : ""),
@@ -47,11 +47,12 @@ var PrettyRequestLogger = class {
 	}
 };
 function colorizeStatus(status) {
-	if (status === null) return logColor.blackBright("---");
+	const family = accessStatusFamily(status);
+	if (status === null || family === null) return logColor.blackBright("---");
 	const s = String(status);
-	if (status >= 500) return logColor.red(s);
-	if (status >= 400) return logColor.yellowBold(s);
-	if (status >= 300) return logColor.yellow(s);
+	if (family >= 5) return logColor.red(s);
+	if (family === 4) return logColor.yellowBold(s);
+	if (family === 3) return logColor.yellow(s);
 	return logColor.green(s);
 }
 function formatDuration(ms) {

package/dist/nodefony/src/context/Context.js

@@ -1,5 +1,6 @@
 import { buildMetaData } from "./metaData.js";
 import { protocolNameOf } from "./transport.js";
+import { resolveTimingMode } from "./timingMode.js";
 import Cookie, { cookiesParser } from "../cookies/cookie.js";
 import { RequestContext, Service, logColor } from "nodefony";
 import { randomFillSync, randomUUID } from "node:crypto";
@@ -106,6 +107,12 @@ var Context = class extends Service {
 	router = this.get("router");
 	resolver = null;
 	/**
+	* Module qui signe les lignes de CETTE requête : la ligne d'accès et les
+	* lignes du contrôleur. `null` = le module de la route (sans route : le
+	* journal du noyau). Un contrôleur le change : `this.context.logModule = "billing"`.
+	*/
+	logModule = null;
+	/**
 	* Intent de session de la route courante (posé par le Resolver depuis
 	* `@UseSession` / paramètre `@Session`). Pilote le point d'activation unique
 	* (HTTP + WS). `null` = aucune session sauf cookie existant (reprise L1).
@@ -137,8 +144,20 @@ var Context = class extends Service {
 	profilerQueries = null;
 	profiling = false;
 	securityTrace = null;
+	/**
+	* Message du canal `nodefony.http.request` pour CETTE requête, ou `null` si
+	* personne n'écoutait à son début (le cas par défaut : un champ, aucune
+	* allocation). Posé par `openRequestTrace`, remis à `null` par
+	* `closeRequestTrace` — c'est ce `null` qui rend la fin idempotente.
+	*
+	* @internal
+	*/
+	requestTrace = null;
 	_timingEnabled = false;
 	_timingVerbose = false;
+	_clockEnabled = false;
+	_clockStartMs = 0;
+	_durationMs = null;
 	phases = EMPTY_PHASES;
 	_phaseIndex = null;
 	_afterResponseFns = null;
@@ -157,20 +176,24 @@ var Context = class extends Service {
 			const p = globalThis.__nfPerfProbe;
 			if (p && p.t0 !== 0n) p.svcNs += Number(process.hrtime.bigint() - p.t0);
 		}
+		const timing = this.kernel?.options.timing;
+		const timingSection = typeof timing === "object" && timing !== null ? timing : null;
+		const mode = resolveTimingMode(timingSection !== null && "enabled" in timingSection ? timingSection.enabled : void 0, this.kernel?.environment);
+		if (mode !== "off") {
+			this._clockEnabled = true;
+			this._clockStartMs = performance.now();
+		}
+		if (mode === "phases") {
+			this._timingEnabled = true;
+			this.phases = [];
+			this._timingVerbose = timingSection !== null && "verbose" in timingSection && timingSection.verbose === true;
+		}
 		this.serverType = serverType;
 		this.type = protocolNameOf(serverType);
 		this.set("context", this);
 		this.httpKernel = this.get("HttpKernel");
 		this.sessionService = this.get("sessions");
 		this.setMetaData();
-		const explicit = (this.kernel?.options)?.timing?.enabled;
-		if (typeof explicit === "boolean") this._timingEnabled = explicit;
-		else this._timingEnabled = this.kernel?.environment !== "production";
-		if (this._timingEnabled) {
-			this.phases = [];
-			const verbose = (this.kernel?.options)?.timing?.verbose;
-			this._timingVerbose = verbose === true;
-		}
 		this.scheme = serverType;
 		switch (serverType) {
 			case "http": {
@@ -245,6 +268,24 @@ var Context = class extends Service {
 		p.endMs = performance.now();
 		p.durationMs = p.endMs - p.startMs;
 	}
+	/**
+	* Arrête l'horloge de la requête et rend sa durée, en millisecondes.
+	*
+	* La durée court de la construction du contexte au PREMIER appel : le
+	* démontage HTTP (`close` de la réponse, dernier octet remis — la mesure
+	* d'OpenTelemetry et du `$request_time` de nginx), la ligne d'accès pour un
+	* handshake WebSocket. Les appels suivants rendent la même valeur : journal
+	* d'accès, profiler et trace verbose lisent UNE durée, jamais trois.
+	*
+	* Active par défaut dans tous les environnements, production comprise :
+	* seul `timing.enabled: false` la coupe (cf `resolveTimingMode`).
+	*
+	* @returns la durée, ou `null` si `timing.enabled` vaut `false`
+	*/
+	stopClock() {
+		if (!this._clockEnabled) return null;
+		return this._durationMs ??= performance.now() - this._clockStartMs;
+	}
 	onAfterResponse(fn) {
 		const boundFn = AsyncResource.bind(fn);
 		if (this._afterResponseFired) {
@@ -296,10 +337,10 @@ var Context = class extends Service {
 	_abortIfPending(reason) {
 		if (this._abortController && !this._abortController.signal.aborted) this._abortController.abort(new Error(reason ?? "Context aborted"));
 	}
-	log(pci, severity, msgid, msg) {
+	log(pci, severity, msgid, msg, moduleName) {
 		if (!msgid) msgid = this.serverType;
-		if (this.requestId && RequestContext.getRequestId() === void 0) return RequestContext.run({ requestId: this.requestId }, () => super.log(pci, severity, msgid, msg));
-		return super.log(pci, severity, msgid, msg);
+		if (this.requestId && RequestContext.getRequestId() === void 0) return RequestContext.run({ requestId: this.requestId }, () => super.log(pci, severity, msgid, msg, moduleName));
+		return super.log(pci, severity, msgid, msg, moduleName);
 	}
 	/**
 	* Confie au contexte le magasin `RequestContext` de son unité de travail
@@ -359,7 +400,7 @@ var Context = class extends Service {
 			if (!logger) return;
 			if (logger.shouldSample && !logger.shouldSample(this, err)) return;
 			const entry = logger.renderHttp(this, err);
-			return this.log(entry.text, entry.severity, entry.msgid);
+			return this.log(entry.text, entry.severity, entry.msgid, void 0, this.logModule ?? this.resolver?.route?.module?.name);
 		} catch {
 			return;
 		}
@@ -387,7 +428,9 @@ var Context = class extends Service {
 			} else line += `${p.name}=…`;
 			i++;
 		}
-		this.log(`TRACE phases [Σ ${total.toFixed(2)}ms] ${line}`, "DEBUG", `${this.serverType} TIMING`);
+		const duration = this.stopClock();
+		const head = duration === null ? "" : `total ${duration.toFixed(2)}ms · `;
+		this.log(`TRACE phases [${head}Σ ${total.toFixed(2)}ms] ${line}`, "DEBUG", `${this.serverType} TIMING`);
 	}
 	addRequestCookie(cookie) {
 		if (cookie instanceof Cookie) return this.cookies[cookie.name] = cookie;

package/dist/nodefony/src/context/http/HttpContext.js

@@ -56,6 +56,11 @@ var HttpContext = class extends Context {
 	activeSocket = null;
 	isRedirect = false;
 	sended = false;
+	/**
+	* Requête relayée par le proxy inverse : la politique de ligne d'accès de
+	* son montage. `null` = servie par l'application (cas de toute requête).
+	*/
+	relayAccessLog = null;
 	request;
 	response;
 	uploadService;
@@ -126,6 +131,7 @@ var HttpContext = class extends Context {
 	_onTimeout() {
 		if (this.listenerCount("onTimeout")) this.fire("onTimeout", this);
 		this._abortIfPending("Request timeout");
+		this.httpKernel?.warnUnsentResponse(this);
 		let error;
 		if (this.response.stream) error = new HttpError("Gateway Timeout", 504, this);
 		else error = new HttpError("Request Timeout", 408, this);
@@ -182,6 +188,21 @@ var HttpContext = class extends Context {
 		}
 	}
 	/**
+	* Ligne d'accès — pour une requête RELAYÉE, avec le statut que l'amont a
+	* réellement rendu (le relais écrit la réponse brute, pas celle du
+	* contexte) ; un montage `accessLog: "errors"` ne l'écrit qu'en échec.
+	*
+	* @param httpError - l'erreur de la requête, s'il y en a une
+	*/
+	logRequest(httpError) {
+		if (this.relayAccessLog !== null) {
+			const raw = this.response.response;
+			if (raw !== null) this.response.statusCode = raw.statusCode;
+			if (this.relayAccessLog === "errors" && this.response.statusCode < 400 && !httpError && !this.error) return;
+		}
+		return super.logRequest(httpError);
+	}
+	/**
 	* Nettoie le contexte, et le DÉTACHE de sa socket h1 : la connexion
 	* persistante survit à la requête, et l'entrée de `socketActiveContext`
 	* retiendrait sinon tout le contexte jusqu'à sa fermeture. Seule l'entrée qui

package/dist/nodefony/src/context/http2/Response.js

@@ -93,6 +93,7 @@ var Http2Response = class extends HttpResponse {
 		const stream = this.stream;
 		if (!stream) return super.send(chunk, encoding);
 		if (stream.destroyed || !stream.writable) {
+			this.settleHeadResponse();
 			this.log("HTTP/2 stream not writable before send — skip", "DEBUG");
 			return this;
 		}
@@ -116,11 +117,29 @@ var Http2Response = class extends HttpResponse {
 	*/
 	end(chunk, encoding) {
 		if (this.stream) {
-			if (this.stream.writableEnded || this.stream.destroyed || this.stream.closed) return this.stream;
+			if (this.stream.writableEnded || this.stream.destroyed || this.stream.closed) {
+				this.settleHeadResponse();
+				return this.stream;
+			}
 			return this.stream.end(chunk, encoding || this.encoding);
 		}
 		return super.end(chunk, encoding);
 	}
+	/**
+	* Termine la réponse de compatibilité d'un HEAD, dont Node a clos le flux de
+	* lui-même au `respond()`.
+	*
+	* Sans ce geste, `Http2ServerResponse` n'émet ni `finish` ni `close` : le
+	* démontage de la requête, branché sur ce `close` (ligne d'accès, profil,
+	* hooks d'après-réponse, libération du scope DI), n'a jamais lieu. Les statuts
+	* que Node termine aussi d'office (204, 205, 304) émettent leur `close` seuls,
+	* et un flux détruit (client parti) aussi : ils ne sont pas touchés. Hors du
+	* chemin servi — appelé seulement quand le flux est déjà clos.
+	*/
+	settleHeadResponse() {
+		const raw = this.response;
+		if (raw !== null && this.context.method === "HEAD" && this.stream?.destroyed === false && !raw.writableEnded) raw.end();
+	}
 	getStatusMessage(code) {
 		if (code) {
 			if (this.response) return http.STATUS_CODES[code] || this.statusMessage;