@nodefony/http 10.0.0-alpha.5 → 10.0.0-alpha.7

package/dist/_virtual/{_@oxc-project_runtime@0.149.0 → _@oxc-project_runtime@0.150.0}/helpers/esm/decorate.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.150.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);

package/dist/_virtual/{_@oxc-project_runtime@0.149.0 → _@oxc-project_runtime@0.150.0}/helpers/esm/decorateMetadata.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.150.0/helpers/esm/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }

package/dist/_virtual/{_@oxc-project_runtime@0.149.0 → _@oxc-project_runtime@0.150.0}/helpers/esm/decorateParam.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateParam.js
+//#region \0@oxc-project+runtime@0.150.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);

package/dist/index.js

@@ -21,8 +21,8 @@ import DefaultErrorRenderer, { schemaMismatchOf } from "./nodefony/service/error
 import DefaultRequestLogger from "./nodefony/service/request-logger.js";
 import JsonAuditLogger from "./nodefony/service/audit-logger.js";
 import PrettyRequestLogger from "./nodefony/service/pretty-request-logger.js";
-import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "./_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "./_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import http_kernel_default from "./nodefony/service/http-kernel.js";
 import server_http_default from "./nodefony/service/servers/server-http.js";
 import server_https_default from "./nodefony/service/servers/server-https.js";

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

@@ -12,9 +12,9 @@ import DefaultRequestLogger from "./request-logger.js";
 import JsonAuditLogger from "./audit-logger.js";
 import PrettyRequestLogger from "./pretty-request-logger.js";
 import { resolveTraceparent } from "./trace.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
-import { GcScheduler, Module, RequestContext, Service, injectable, logColor, nodefonyError, writeRuntimeState } from "nodefony";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import { GcScheduler, Module, RequestContext, Service, injectable, logColor, nodefonyError, servedUrl, writeRuntimeState } from "nodefony";
 import cluster from "node:cluster";
 import Ws from "ws";
 //#region nodefony/service/http-kernel.ts
@@ -597,6 +597,10 @@ let HttpKernel = class HttpKernel extends Service {
 	* Le port DÉSIRÉ est publié à côté du port obtenu : un outil peut ainsi dire
 	* « tu voulais 5151, tu écoutes sur 5153 » sans deviner.
 	*
+	* L'ADRESSE complète l'est aussi, et pour la même raison : un port ne dit pas
+	* son protocole. Le serveur est le seul à savoir lequel de ses ports parle TLS ;
+	* un lecteur qui le devine se trompe le jour où la topologie change.
+	*
 	* **Publié dans TOUS les environnements, production comprise.** Le glissement de
 	* port (`auto`) n'est pas la seule façon de sortir de la convention : une app qui
 	* déclare son port (PaaS `PORT`, ingress, `servers.http.port`) écoute ailleurs
@@ -615,13 +619,16 @@ let HttpKernel = class HttpKernel extends Service {
 	publishRuntimePorts(serverHttp, serverHttps) {
 		const ports = [];
 		const desired = [];
+		const urls = [];
 		if (serverHttp?.active && serverHttp.port > 0) {
 			ports.push(serverHttp.port);
+			urls.push(servedUrl("http", serverHttp.domain, serverHttp.port));
 			const d = this.kernel?.options.servers?.http;
 			if (d && d.port) desired.push(d.port);
 		}
 		if (serverHttps?.active && serverHttps.port > 0) {
 			ports.push(serverHttps.port);
+			urls.push(servedUrl("https", serverHttps.domain, serverHttps.port));
 			const d = this.kernel?.options.servers?.https;
 			if (d && d.port) desired.push(d.port);
 		}
@@ -629,7 +636,8 @@ let HttpKernel = class HttpKernel extends Service {
 		writeRuntimeState(process.cwd(), {
 			pid: cluster.isWorker ? process.ppid ?? process.pid : process.pid,
 			ports,
-			desiredPorts: desired.length > 0 ? desired : void 0
+			desiredPorts: desired.length > 0 ? desired : void 0,
+			urls
 		});
 	}
 	/**

package/dist/nodefony/service/servers/server-http.js

@@ -1,10 +1,10 @@
-import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import http_kernel_default from "../http-kernel.js";
 import { handleClientError } from "./clientError.js";
 import { createDrainTerminator } from "./serverShutdown.js";
 import { bindWithFallback, buildBindPlan } from "../../src/servers/portBinder.js";
-import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateParam.js";
+import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateParam.js";
 import { Module, Service, extend, inject, nodefonyError } from "nodefony";
 import http from "node:http";
 //#region nodefony/service/servers/server-http.ts

package/dist/nodefony/service/servers/server-https.js

@@ -1,10 +1,10 @@
-import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import http_kernel_default from "../http-kernel.js";
 import { handleClientError } from "./clientError.js";
 import { createDrainTerminator } from "./serverShutdown.js";
 import { bindWithFallback, buildBindPlan } from "../../src/servers/portBinder.js";
-import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateParam.js";
+import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateParam.js";
 import { Module, Service, extend, inject, nodefonyError } from "nodefony";
 import http2 from "node:http2";
 import https from "node:https";

package/dist/nodefony/service/servers/server-websocket-secure.js

@@ -1,7 +1,7 @@
-import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import http_kernel_default from "../http-kernel.js";
-import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateParam.js";
+import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateParam.js";
 import { startHeartbeat, trackPong } from "./wsHeartbeat.js";
 import { Module, Service, inject } from "nodefony";
 import Ws, { WebSocketServer } from "ws";

package/dist/nodefony/service/servers/server-websocket.js

@@ -1,7 +1,7 @@
-import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import http_kernel_default from "../http-kernel.js";
-import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateParam.js";
+import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateParam.js";
 import { startHeartbeat, trackPong } from "./wsHeartbeat.js";
 import { Module, Service, inject } from "nodefony";
 import Ws, { WebSocketServer } from "ws";

package/dist/nodefony/service/sessions/sessions-service.js

@@ -1,8 +1,8 @@
 import { SESSION_FACETS } from "../../src/session/storage/sessionFilters.js";
-import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import http_kernel_default from "../http-kernel.js";
-import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateParam.js";
+import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateParam.js";
 import Session from "../../src/session/session.js";
 import MemorySessionStorage from "../../src/session/storage/MemorySessionStorage.js";
 import RevocationGuardStorage from "../../src/session/storage/RevocationGuardStorage.js";

package/dist/nodefony/service/upload/upload-service.js

@@ -1,7 +1,7 @@
-import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import http_kernel_default from "../http-kernel.js";
-import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateParam.js";
+import __decorateParam from "../../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateParam.js";
 import { Cli, FileClass, Module, Service, inject } from "nodefony";
 import fs from "node:fs";
 import fsp from "node:fs/promises";

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

@@ -6,6 +6,7 @@ import HttpRequest from "./Request.js";
 import HttpResponse from "./Response.js";
 import Http2Request from "../http2/Request.js";
 import Http2Response from "../http2/Response.js";
+import { describeSessionStoreFailure } from "../../session/sessionStoreFailure.js";
 import { extend, typeOf } from "nodefony";
 import url, { URL } from "node:url";
 //#region nodefony/src/context/http/HttpContext.ts
@@ -156,7 +157,10 @@ var HttpContext = class extends Context {
 		return this.send(data, encoding);
 	}
 	async end() {
-		return this.saveSession().then(async (_session) => {
+		return this.saveSession().catch((e) => {
+			this.log(describeSessionStoreFailure(e).message, "CRITIC", "SESSION-STORE");
+			return null;
+		}).then(async (_session) => {
 			return this.close().catch((e) => {
 				throw e;
 			});
@@ -180,8 +184,16 @@ var HttpContext = class extends Context {
 	}
 	async #doSend(chunk, encoding) {
 		try {
-			if (this.session != null) await this.saveSession();
-			if (chunk) this.response?.setBody(chunk);
+			let body = chunk;
+			if (this.session != null) try {
+				await this.saveSession();
+			} catch (e) {
+				const failure = describeSessionStoreFailure(e);
+				this.log(failure.message, "CRITIC", "SESSION-STORE");
+				this.response.statusCode = failure.statusCode;
+				body = failure.body;
+			}
+			if (body) this.response?.setBody(body);
 			if (this.listenerCount("onSend") > 0) await this.fireAsync("onSend", this.response, this);
 			try {
 				this.writeHead();
@@ -189,7 +201,7 @@ var HttpContext = class extends Context {
 				this.log(e, "WARNING");
 			}
 			if (this.isRedirect) return await this.close();
-			return await this.write(chunk, encoding);
+			return await this.write(body, encoding);
 		} catch (error) {
 			this.log(error, "ERROR");
 			throw error;
@@ -222,6 +234,7 @@ var HttpContext = class extends Context {
 	}
 	async close() {
 		if (this.listenerCount("onClose") > 0) await this.fireAsync("onClose", this);
+		if (this.response?.response?.writableEnded) return this.response;
 		return this.response.end().then(() => this.response).catch((e) => {
 			throw e;
 		});

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

@@ -297,6 +297,10 @@ var HttpResponse = class {
 		if (!this.response) throw new Error(`Http Response not found`);
 		if (this.body === null) this.body = Buffer.alloc(0);
 		const res = this.response;
+		if (!_flush && !this.flushing && !res.writableEnded) {
+			res.end(this.body, encoding || this.encoding);
+			return this;
+		}
 		return new Promise((resolve) => {
 			let settled = false;
 			const done = () => {

package/dist/nodefony/src/servers/portBinder.js

@@ -1,3 +1,4 @@
+import { isPortListening } from "nodefony";
 //#region nodefony/src/servers/portBinder.ts
 /** Nombre de ports essayés après le désiré, en `auto`. */
 const DEFAULT_PORT_RETRY_ATTEMPTS = 20;
@@ -42,6 +43,69 @@ function buildBindPlan(which, servers, environment) {
 		attempts: policy === "auto" ? servers?.portRetryAttempts ?? 20 : 0
 	};
 }
+/** Adresses qui désignent « toutes les interfaces » — rien ne s'y connecte. */
+const WILDCARD_HOSTS = /* @__PURE__ */ new Set([
+	"",
+	"*",
+	"0.0.0.0",
+	"::",
+	"[::]"
+]);
+/** Adresses de la boucle locale, toutes familles — c'est aussi ce qu'on REND. */
+const LOOPBACK_HOSTS = ["127.0.0.1", "::1"];
+/** Les mêmes, plus le nom qui les désigne — DÉRIVÉ, jamais recopié. */
+const LOOPBACK_ALIASES = /* @__PURE__ */ new Set([...LOOPBACK_HOSTS, "localhost"]);
+/**
+* Adresses à interroger pour savoir si notre future liaison chevauche déjà un
+* serveur vivant.
+*
+* La règle est celle du TRAFIC, pas celle du noyau : on sonde ce que notre
+* liaison va RECEVOIR.
+* - Écouter sur **toutes les interfaces** recouvre la boucle locale : on sonde
+*   ses deux adresses (`127.0.0.1` et `::1`). Un wildcard n'est pas une
+*   destination, on ne peut pas s'y connecter.
+* - Écouter sur la **boucle locale** (`localhost` résout `::1` ici, `127.0.0.1`
+*   ailleurs — et les clients ne choisissent pas) : les deux, là encore.
+* - Écouter sur une **adresse d'interface précise** : elle seule. Une connexion
+*   vers elle atteint le tiers qu'il ait lié cette adresse ou le wildcard, donc
+*   une cible suffit — et sonder la boucle locale ferait refuser un pod à cause
+*   d'un voisin de conteneur qui n'a jamais été en conflit.
+*
+* Fonction PURE : le banc l'éprouve sans ouvrir un socket.
+*
+* @param host - hôte passé à `listen` (`kernel.domain`).
+* @returns les adresses à interroger, dans l'ordre.
+*/
+function conflictProbeTargets(host) {
+	const value = (host ?? "").trim().toLowerCase();
+	if (WILDCARD_HOSTS.has(value) || LOOPBACK_ALIASES.has(value)) return LOOPBACK_HOSTS;
+	return [value];
+}
+/**
+* Première adresse où un serveur répond DÉJÀ sur ce port, `null` si la voie est
+* libre.
+*
+* @param port - port candidat.
+* @param host - hôte que `listen` recevra (décide des adresses interrogées).
+* @param probe - sonde de présence (injectée par le banc).
+*/
+async function detectPortConflict(port, host, probe) {
+	for (const target of conflictProbeTargets(host)) if (await probe(port, target)) return target;
+	return null;
+}
+/**
+* Erreur d'un conflit que le noyau aurait laissé passer.
+*
+* Porte `EADDRINUSE` : pour l'appelant c'est le même fait — le port n'est pas
+* prenable — et une seule branche le traite. Le message, lui, doit dire ce que
+* le code d'erreur seul ferait chercher au mauvais endroit : ici `listen` aurait
+* RÉUSSI, et c'est la liaison d'une AUTRE adresse qui capte le trafic.
+*/
+function portConflictError(port, host) {
+	const error = /* @__PURE__ */ new Error(`Port ${port} déjà servi par un autre processus sur ${host} — le noyau l'aurait pourtant accordé (deux adresses distinctes coexistent sur le même port), et cette application aurait écouté sans rien recevoir. Libérer le port (nodefony status · nodefony stop), en figer un autre (servers.http.port / servers.https.port), ou autoriser le repli (servers.portPolicy = "auto", défaut en développement).`);
+	error.code = "EADDRINUSE";
+	return error;
+}
 /** Prochain candidat : incrémente, en sautant ce que les autres serveurs veulent. */
 function nextCandidate(from, reserved) {
 	let port = from + 1;
@@ -84,31 +148,39 @@ function isPortUnavailable(code, port) {
 *   (`ENOTFOUND`, `EACCES` sous 1024 — cf `isPortUnavailable`), soit un port
 *   indisponible après épuisement des essais (le fallback n'est PAS infini).
 */
-function bindWithFallback(server, host, plan) {
-	return new Promise((resolve, reject) => {
-		let candidate = plan.desired;
-		let used = 0;
-		const attempt = () => {
-			const onError = (error) => {
-				server.removeListener("listening", onListening);
-				if (!isPortUnavailable(error.code, candidate) || plan.desired === 0 || used >= plan.attempts) return reject(error);
-				used += 1;
-				candidate = nextCandidate(candidate, plan.reserved);
-				attempt();
-			};
-			const onListening = () => {
-				server.removeListener("error", onError);
-				resolve({
-					address: server.address(),
-					shiftedFrom: candidate === plan.desired ? null : plan.desired
-				});
-			};
-			server.once("error", onError);
-			server.once("listening", onListening);
-			server.listen(candidate, host);
+async function bindWithFallback(server, host, plan, probe = isPortListening) {
+	let candidate = plan.desired;
+	let used = 0;
+	/**
+	* Une tentative d'écoute. L'erreur est RENDUE, jamais levée depuis le
+	* callback : les deux écouteurs se retirent dans les deux cas, et la boucle
+	* ci-dessous reste le seul endroit qui décide.
+	*/
+	const listenOnce = (port) => new Promise((settle) => {
+		const onError = (error) => {
+			server.removeListener("listening", onListening);
+			settle(error);
 		};
-		attempt();
+		const onListening = () => {
+			server.removeListener("error", onError);
+			settle(null);
+		};
+		server.once("error", onError);
+		server.once("listening", onListening);
+		server.listen(port, host);
 	});
+	for (;;) {
+		const conflict = plan.desired === 0 || candidate !== plan.desired ? null : await detectPortConflict(candidate, host, probe);
+		const failure = conflict ? portConflictError(candidate, conflict) : await listenOnce(candidate);
+		if (failure === null) return {
+			address: server.address(),
+			shiftedFrom: candidate === plan.desired ? null : plan.desired
+		};
+		if (!conflict && !isPortUnavailable(failure.code, candidate)) throw failure;
+		if (plan.desired === 0 || used >= plan.attempts) throw failure;
+		used += 1;
+		candidate = nextCandidate(candidate, plan.reserved);
+	}
 }
 //#endregion
-export { DEFAULT_PORT_RETRY_ATTEMPTS, bindWithFallback, buildBindPlan, resolvePortPolicy };
+export { DEFAULT_PORT_RETRY_ATTEMPTS, bindWithFallback, buildBindPlan, conflictProbeTargets, detectPortConflict, resolvePortPolicy };

package/dist/nodefony/src/session/sessionStoreFailure.js

@@ -0,0 +1,29 @@
+//#region nodefony/src/session/sessionStoreFailure.ts
+/**
+* Reconnaît une table de session absente, quel que soit le dialecte.
+*
+* Chaque moteur formule le même défaut à sa façon, et aucun ne porte de code
+* commun : SQLite dit « no such table », PostgreSQL « relation ... does not
+* exist », MySQL « doesn't exist ». On reste volontairement large — le seul
+* enjeu est de savoir s'il faut PARLER DE MIGRATIONS, jamais de trancher une
+* branche de code.
+*/
+function looksLikeMissingTable(text) {
+	return /no such table/i.test(text) || /does ?n[o']?t exist/i.test(text) || /undefined table/i.test(text) || /unknown table/i.test(text);
+}
+/**
+* Compose la réponse et le journal d'une panne du stockage de session.
+*
+* @param error - l'erreur remontée par le store.
+* @returns le statut, le corps à servir, et la ligne de journal.
+*/
+function describeSessionStoreFailure(error) {
+	const cause = error instanceof Error ? error.message : String(error ?? "cause inconnue");
+	return {
+		statusCode: 500,
+		body: "Internal Server Error — session store unavailable",
+		message: `La session n'a pas pu être persistée — la requête est servie en 500 plutôt que laissée sans réponse. Cause : ${cause}.${looksLikeMissingTable(cause) ? " La table de session est probablement absente : appliquer les migrations (`nodefony orm:migrate`) avant de servir, ou choisir un autre stockage (`http.session.store`)." : " Vérifier que le stockage de session déclaré sous `http.session.store` est joignable ; à défaut, appliquer les migrations (`nodefony orm:migrate`)."}`
+	};
+}
+//#endregion
+export { describeSessionStoreFailure };

package/dist/types/nodefony/service/http-kernel.d.ts

@@ -314,6 +314,10 @@ declare class HttpKernel extends Service implements IHttpKernelInterface {
      * Le port DÉSIRÉ est publié à côté du port obtenu : un outil peut ainsi dire
      * « tu voulais 5151, tu écoutes sur 5153 » sans deviner.
      *
+     * L'ADRESSE complète l'est aussi, et pour la même raison : un port ne dit pas
+     * son protocole. Le serveur est le seul à savoir lequel de ses ports parle TLS ;
+     * un lecteur qui le devine se trompe le jour où la topologie change.
+     *
      * **Publié dans TOUS les environnements, production comprise.** Le glissement de
      * port (`auto`) n'est pas la seule façon de sortir de la convention : une app qui
      * déclare son port (PaaS `PORT`, ingress, `servers.http.port`) écoute ailleurs

package/dist/types/nodefony/src/servers/portBinder.d.ts

@@ -14,6 +14,24 @@
  * `listen()` est, lui, **atomique** : soit il réussit, soit le noyau dit
  * `EADDRINUSE`. On retente donc sur l'échec réel, jamais sur une prédiction.
  *
+ * ## Pourquoi une SONDE malgré cela
+ *
+ * Le `listen()` est atomique, mais il ne dit pas tout : un port peut être **déjà
+ * servi** et le noyau l'accorder quand même. Lier `0.0.0.0:P` alors qu'un autre
+ * processus tient `127.0.0.1:P` **réussit** sur macOS et les BSD — ce sont deux
+ * liaisons distinctes, et les connexions locales partent à la PLUS SPÉCIFIQUE.
+ * Entre familles d'adresses (`::1` tenu, `0.0.0.0` demandé), même linux
+ * l'accorde. L'application annonce alors `READY`, publie ses ports… et ne reçoit
+ * rien : une panne muette, et un banc qui interroge le serveur du VOISIN.
+ *
+ * On constate donc, AVANT de binder, qu'aucun serveur ne répond déjà là où notre
+ * liaison va recevoir (`isPortListening` — une connexion en boucle locale, aucun
+ * outil système, même verdict sur les trois plateformes). Ce n'est pas la sonde
+ * « ce port est-il libre ? » écartée plus haut : elle ne remplace pas le repli
+ * atomique, qui reste le seul à trancher la course — elle ajoute le seul conflit
+ * que le noyau n'exprime JAMAIS. La course résiduelle (un tiers prend le port
+ * entre la sonde et le bind) retombe donc sur `EADDRINUSE`, inchangé.
+ *
  * ## Pourquoi sauter les ports réservés
  *
  * HTTP veut 5151, HTTPS veut 5152. Si 5151 est pris, incrémenter naïvement ferait
@@ -86,6 +104,45 @@ export interface ServersPortConfig {
  * @param environment - `kernel.environment` (arbitre le défaut de la politique).
  */
 export declare function buildBindPlan(which: "http" | "https", servers: ServersPortConfig | undefined, environment: string | undefined): BindPlan;
+/**
+ * Sonde « un serveur répond-il déjà ici ? ».
+ *
+ * Injectable pour que le banc éprouve la DÉCISION sans dépendre d'un décor
+ * réseau ; le défaut est `isPortListening`, exposé par le cœur pour ne pas être
+ * recopié de paquet en paquet.
+ */
+export type PortListeningProbe = (port: number, host: string) => Promise<boolean>;
+/**
+ * Adresses à interroger pour savoir si notre future liaison chevauche déjà un
+ * serveur vivant.
+ *
+ * La règle est celle du TRAFIC, pas celle du noyau : on sonde ce que notre
+ * liaison va RECEVOIR.
+ * - Écouter sur **toutes les interfaces** recouvre la boucle locale : on sonde
+ *   ses deux adresses (`127.0.0.1` et `::1`). Un wildcard n'est pas une
+ *   destination, on ne peut pas s'y connecter.
+ * - Écouter sur la **boucle locale** (`localhost` résout `::1` ici, `127.0.0.1`
+ *   ailleurs — et les clients ne choisissent pas) : les deux, là encore.
+ * - Écouter sur une **adresse d'interface précise** : elle seule. Une connexion
+ *   vers elle atteint le tiers qu'il ait lié cette adresse ou le wildcard, donc
+ *   une cible suffit — et sonder la boucle locale ferait refuser un pod à cause
+ *   d'un voisin de conteneur qui n'a jamais été en conflit.
+ *
+ * Fonction PURE : le banc l'éprouve sans ouvrir un socket.
+ *
+ * @param host - hôte passé à `listen` (`kernel.domain`).
+ * @returns les adresses à interroger, dans l'ordre.
+ */
+export declare function conflictProbeTargets(host: string | undefined): readonly string[];
+/**
+ * Première adresse où un serveur répond DÉJÀ sur ce port, `null` si la voie est
+ * libre.
+ *
+ * @param port - port candidat.
+ * @param host - hôte que `listen` recevra (décide des adresses interrogées).
+ * @param probe - sonde de présence (injectée par le banc).
+ */
+export declare function detectPortConflict(port: number, host: string | undefined, probe: PortListeningProbe): Promise<string | null>;
 /**
  * Écoute sur `plan.desired`, ou sur le prochain port libre si `attempts > 0`.
  *
@@ -99,4 +156,4 @@ export declare function buildBindPlan(which: "http" | "https", servers: ServersP
  *   (`ENOTFOUND`, `EACCES` sous 1024 — cf `isPortUnavailable`), soit un port
  *   indisponible après épuisement des essais (le fallback n'est PAS infini).
  */
-export declare function bindWithFallback(server: Listenable, host: string, plan: BindPlan): Promise<BindResult>;
+export declare function bindWithFallback(server: Listenable, host: string, plan: BindPlan, probe?: PortListeningProbe): Promise<BindResult>;

package/dist/types/nodefony/src/session/sessionStoreFailure.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Ce qu'on répond quand le stockage de session est inutilisable.
+ *
+ * Une requête doit TOUJOURS recevoir une réponse. La sauvegarde de session a
+ * lieu juste avant l'écriture des en-têtes : une exception qui remonte de là
+ * laisse la socket ouverte, et le client attend jusqu'à son propre délai. Rien
+ * dans ses journaux ne nomme la cause — l'exploitant cherche du côté du réseau
+ * ou de la charge, et le banc de tenue dans la durée est resté rouge dix jours
+ * pour cette seule raison.
+ *
+ * Le cas de loin le plus courant est une application mise en ligne **sans ses
+ * migrations** : la table de session n'existe pas, et `session.store: "auto"`
+ * retombe sur SQLite dès que l'ORM est chargé. C'est un oubli banal que le
+ * framework doit rendre BRUYANT.
+ *
+ * Pourquoi 500 et non une réponse normale : une session qu'on ne sait pas
+ * persister est une **dégradation**, pas une indisponibilité passagère. Servir
+ * 200 laisserait croire que la connexion a été retenue alors que rien n'a été
+ * écrit — c'est exactement la dégradation silencieuse que ce framework refuse.
+ */
+/** La conduite à tenir : ce qu'on répond, et ce qu'on écrit dans le journal. */
+export interface ISessionStoreFailure {
+    /** Le statut à servir — toujours 500 : le serveur n'a pas tenu sa part. */
+    statusCode: number;
+    /** Le corps servi au client : sobre, il ne divulgue aucun détail interne. */
+    body: string;
+    /** La ligne de journal côté serveur — elle NOMME la cause et le remède. */
+    message: string;
+}
+/**
+ * Compose la réponse et le journal d'une panne du stockage de session.
+ *
+ * @param error - l'erreur remontée par le store.
+ * @returns le statut, le corps à servir, et la ligne de journal.
+ */
+export declare function describeSessionStoreFailure(error: unknown): ISessionStoreFailure;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodefony/http",
-  "version": "10.0.0-alpha.5",
+  "version": "10.0.0-alpha.7",
   "description": "Serveurs HTTP, HTTPS, HTTP/2 et WebSocket natifs pour Nodefony : sessions, contextes de requête, certificats TLS",
   "author": "Christophe CAMENSULI <ccamensuli@gmail.com>",
   "main": "./dist/index.js",
@@ -66,26 +66,26 @@
     "@types/chai": "5.2.3",
     "@types/mime-types": "3.0.1",
     "@types/ms": "2.1.0",
-    "@types/node": "26.5.1",
+    "@types/node": "26.6.1",
     "@types/node-forge": "1.3.14",
     "@types/qs": "6.15.1",
     "@types/serve-static": "2.2.0",
     "@types/websocket": "1.0.10",
     "@types/ws": "8.18.1",
     "@types/xml2js": "0.4.14",
-    "@vitest/coverage-v8": "5.0.0",
+    "@vitest/coverage-v8": "5.0.1",
     "chai": "6.2.2",
-    "nodefony": "^10.0.0-alpha.5",
+    "nodefony": "^10.0.0-alpha.7",
     "rimraf": "6.1.3",
     "tsx": "4.23.13",
-    "vitest": "5.0.0"
+    "vitest": "5.0.1"
   },
   "license": "Apache-2.0",
   "readmeFilename": "README.md",
   "contributors": [],
   "peerDependencies": {
-    "nodefony": "^10.0.0-alpha.5",
-    "zod": "^4.6.1"
+    "nodefony": "^10.0.0-alpha.7",
+    "zod": "^4.6.5"
   },
   "files": [
     "dist",