@nodefony/http 10.0.0-alpha.9 → 10.0.0-beta.2

package/README.md

@@ -6,7 +6,7 @@ pipeline de contexte/controller.
 
 > Docs IA (dans le dépôt) : [`CLAUDE.md`](https://github.com/nodefony/nodefony-core/blob/main/src/packages/@nodefony/http/CLAUDE.md) · [`MEMORY.md`](https://github.com/nodefony/nodefony-core/blob/main/src/packages/@nodefony/http/MEMORY.md) · [`docs/`](./docs).
 > Règle dure : ce module ne peut PAS importer `@nodefony/framework` (cycle) — accès au resolver
-> via `(context as any)?.resolver`.
+> via `context.resolver`, typé par le contrat `IRouteResolver` que ce module définit.
 
 ## Serveurs
 
@@ -26,14 +26,23 @@ serveur → http-kernel.handle() → rate-limit IP → createContext()
    → Router.resolve()                (match avant le parse du body)
    → Firewall.applySecurityHeaders() → fallback statique si aucune route
    → parse du body
-   → handleFrontController() (Resolver.resolve → controller + initialize())
+   → prepareFrontController()        (route + zone armées, AUCUNE instanciation)
    → Firewall.enforceCsrf() → startSession() → Firewall.handleSecurity()
-   → action du controller → Response.send()
+   → @IsGranted → instanciation DI + initialize() → action du controller → Response.send()
 ```
 
+En WebSocket, le contrôleur est instancié au handshake (`handleFrontController()`), avant le pare-feu.
+
 Chaque contexte (HTTP + WS) porte un `requestId` (UUID v4, ou `X-Request-Id` client),
 réinjecté dans la réponse et corrélé dans les logs via AsyncLocalStorage.
 
+Chaque requête HTTP — et chaque connexion WebSocket — reçoit aussi **son propre conteneur de
+services** : un scope ouvert à l'entrée (`enterScope`), dont le prototype est le conteneur du kernel,
+refermé après les hooks `onAfterResponse`/`onFinish` (`leaveScope`), y compris quand un hook lève.
+Le serveur le pose dans le contexte asynchrone de la requête : `RequestContext.getScope()` le rend
+depuis n'importe quel code, et les services `@injectable({ scope: "request" })` y vivent. Détail :
+[Injection & portées](https://github.com/nodefony/nodefony-core/blob/main/docs/architecture/injection-portees.md).
+
 ## Rate-limit général par IP
 
 Plafond de trafic **par IP cliente** sur toutes les routes HTTP — protège la capacité du serveur

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

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.152.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.151.0 → _@oxc-project_runtime@0.152.0}/helpers/esm/decorateMetadata.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.152.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.151.0 → _@oxc-project_runtime@0.152.0}/helpers/esm/decorateParam.js

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

package/dist/index.js

@@ -1,4 +1,4 @@
-import config, { httpConfigSchema } from "./nodefony/config/config.js";
+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";
@@ -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.151.0/helpers/esm/decorateMetadata.js";
-import __decorate from "./_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
+import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/decorateMetadata.js";
+import __decorate from "./_virtual/_@oxc-project_runtime@0.152.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";
@@ -42,6 +42,7 @@ import { PrebuiltUi, resolveUiDelivery } from "./nodefony/src/assets/prebuiltUi.
 import { Kernel, Module, services } from "nodefony";
 //#region index.ts
 let Http = class Http extends Module {
+	overlaySchema = httpOverlaySchema;
 	constructor(kernel) {
 		super("http", kernel, import.meta.url, config);
 		this.addCommand(Network);
@@ -68,7 +69,8 @@ let Http = class Http extends Module {
 	* certificats `serialNumber`) — cf `defineHttpConfig`.
 	*/
 	async onKernelRegister() {
-		this.options = defineHttpConfig(this.options ?? {}, this.kernel);
+		const input = this.options;
+		this.options = defineHttpConfig(input ?? {}, this.kernel);
 		return this;
 	}
 	/**

package/dist/nodefony/command/assetsPublishCommand.js

@@ -80,7 +80,7 @@ var AssetsPublish = class extends Command {
 	}
 	/** Sources = mounts natifs (`server-static`) + bundles `@nodefony/frontend`. */
 	collectSources() {
-		const modules = this.kernel?.getModules?.() ?? {};
+		const modules = this.kernel?.getModules() ?? {};
 		const sources = [];
 		const staticSvc = modules["http"]?.get("server-static");
 		staticSvc?.mountModulePublics?.();

package/dist/nodefony/command/certificatesCommand.js

@@ -21,12 +21,11 @@ var Certificates = class extends Command {
 		this.addOption("-j, --json", "output the certificate summary as JSON");
 	}
 	async generate(opts) {
-		const service = (this.kernel?.getModules()?.["http"])?.get("certificates") ?? null;
+		const service = (this.kernel?.getModules()["http"])?.get("certificates") ?? null;
 		if (!service) {
 			this.log("Service 'certificates' introuvable (module @nodefony/http non chargé).", "ERROR");
 			return this;
 		}
-		await service.loadForge();
 		await service.generateServerCertificates(Boolean(opts.force));
 		const info = await service.describe();
 		if (opts.json) process.stdout.write(`${JSON.stringify(info, void 0, 2)}\n`);

package/dist/nodefony/command/networkCommand.js

@@ -16,7 +16,7 @@ var Network = class extends Command {
 		let network = this.kernel?.getNetwork();
 		let result = {};
 		if (arg) {
-			if (network?.interfaces[arg]) result = network?.interfaces[arg];
+			if (network?.interfaces[arg]) result = network.interfaces[arg];
 		} else result = network?.interfaces;
 		if (opts.json) process.stdout.write(`${JSON.stringify(result, void 0, " ")}\n`);
 		else process.stdout.write(`${inspect(result, { colors: process.stdout.isTTY })}\n`);

package/dist/nodefony/command/proxyGenerateCommand.js

@@ -43,7 +43,7 @@ var ProxyGenerate = class extends Command {
 	}
 	/** Construit le modèle d'introspection depuis le kernel + le service statique. */
 	buildIntrospection(opts) {
-		const module = this.kernel?.getModules()?.["http"];
+		const module = this.kernel?.getModules()["http"];
 		const httpOpts = module?.options ?? {};
 		const servers = (this.kernel?.options)?.servers;
 		const staticSvc = module?.get("server-static");

package/dist/nodefony/config/config.js

@@ -1,3 +1,4 @@
+import { overlayField } from "nodefony";
 import { z } from "zod";
 //#region nodefony/config/config.ts
 /**
@@ -158,8 +159,9 @@ const http3Schema = z.looseObject({});
 const selfSignedAttrSchema = z.looseObject({
 	name: z.string().optional(),
 	value: z.string().optional(),
-	shortName: z.string().optional()
-}).describe("Champ de sujet/issuer node-forge (CertificateField).");
+	shortName: z.string().optional(),
+	type: z.string().optional()
+}).describe("Attribut du sujet/émetteur : `name` (commonName…), `shortName` (CN…) ou `type` (OID), et `value`.");
 const selfSignedSchema = z.strictObject({
 	size: z.number().int().positive().default(2048).describe("Taille de la clé RSA (bits). 2048 minimum, 4096 recommandé en prod."),
 	hash: z.enum([
@@ -173,7 +175,7 @@ const selfSignedSchema = z.strictObject({
 		kernelDerived: true,
 		description: "Attributs du certificat (commonName, organizationName…). Vide (défaut) = dérivés du kernel par le builder (commonName ← domain)."
 	})
-}).describe("Génération du certificat AUTO-SIGNÉ (node-forge, JavaScript pur — aucun binaire externe n'est invoqué). Ces réglages ne valent QUE pour la stratégie `selfsigned` : sous `mkcert` (défaut en développement) ils sont ignorés — mkcert ne reçoit que les noms d'hôtes — et sous `strategy: \"explicit\"` le certificat est fourni, donc rien n'est généré.");
+}).describe("Génération du certificat AUTO-SIGNÉ (node:crypto — aucun binaire externe ni dépendance tierce). Ces réglages ne valent QUE pour la stratégie `selfsigned` : sous `mkcert` (défaut en développement) ils sont ignorés — mkcert ne reçoit que les noms d'hôtes — et sous `strategy: \"explicit\"` le certificat est fourni, donc rien n'est généré.");
 const sanSchema = z.strictObject({
 	dns: z.array(z.string()).default([]).meta({
 		kernelDerived: true,
@@ -327,9 +329,29 @@ const httpConfigSchema = z.strictObject({
 	})
 }).describe("Configuration de @nodefony/http.");
 /**
+* LISTE BLANCHE des clés qu'une requête peut surcharger pour elle seule
+* (`overlayConfig("@nodefony/http", …)`, #494) : les quotas de corps et
+* d'envoi, lus au MOMENT de lire le corps (`Request.readBodyLimits`) — un
+* calque posé avant la lecture du corps (écouteur `onRequestScope`, organisation
+* reconnue à son nom d'hôte) les voit. Tout le reste est refusé : en-têtes de
+* sécurité, pare-feu, `trustProxy`, sessions, limites de débit, certificats —
+* et `queryString`, lu au constructeur de la requête, avant tout calque.
+* Chaque champ réutilise celui du schéma (mêmes bornes) sans son défaut.
+*/
+const httpOverlaySchema = z.strictObject({
+	maxBodySize: overlayField(httpConfigSchema.shape.maxBodySize),
+	upload: z.strictObject({
+		maxFileSize: overlayField(uploadSchema.shape.maxFileSize),
+		maxTotalFileSize: overlayField(uploadSchema.shape.maxTotalFileSize),
+		maxFiles: overlayField(uploadSchema.shape.maxFiles),
+		maxFields: overlayField(uploadSchema.shape.maxFields),
+		maxFieldsSize: overlayField(uploadSchema.shape.maxFieldsSize)
+	}).partial()
+}).partial().describe("Clés de @nodefony/http surchargeables par requête.");
+/**
 * Défauts du module, matérialisés depuis le schéma (source unique). Toujours
 * valides par construction ; passés au `super(..., config)` du Module class.
 */
 const config = httpConfigSchema.parse({});
 //#endregion
-export { config as default, httpConfigSchema };
+export { config as default, httpConfigSchema, httpOverlaySchema };

package/dist/nodefony/interfaces/IRouting.js

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

package/dist/nodefony/interfaces/ISecurity.js

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

package/dist/nodefony/service/ProfilerAdminApi.js

@@ -51,7 +51,8 @@ function createProfilerAdminApi(profiler) {
 			path: "{id}",
 			summary: "Full profile (phase timeline) for a requestId",
 			handler: ({ params }) => {
-				const entry = profiler.get(params.id);
+				const { id = "" } = params;
+				const entry = profiler.get(id);
 				if (!entry) return {
 					status: 404,
 					body: {

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

@@ -2,6 +2,19 @@ import { RequestContext } from "nodefony";
 import { performance } from "node:perf_hooks";
 //#region nodefony/service/audit-logger.ts
 /**
+* 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.
@@ -77,7 +90,7 @@ var JsonAuditLogger = class {
 			method: ctx.method,
 			url: ctx.url,
 			status,
-			durationMs: this.computeDurationMs(ctx.phases),
+			durationMs: computeDurationMs(ctx.phases),
 			remoteAddress: ctx.remoteAddress ?? null,
 			host: ctx.getHost?.() ?? null,
 			userAgent: ctx.getUserAgent?.() ?? null,
@@ -108,7 +121,7 @@ var JsonAuditLogger = class {
 			method: ctx.method,
 			url: ctx.url,
 			status,
-			durationMs: this.computeDurationMs(ctx.phases),
+			durationMs: computeDurationMs(ctx.phases),
 			remoteAddress: ctx.remoteAddress ?? null,
 			host: ctx.getHost?.() ?? null,
 			userAgent: ctx.getUserAgent?.() ?? null,
@@ -128,16 +141,6 @@ var JsonAuditLogger = class {
 		};
 	}
 	/**
-	* Total request duration computed from the first phase startMs to now.
-	* Returns null if timing is disabled (no phases recorded).
-	*/
-	computeDurationMs(phases) {
-		if (!phases.length) return null;
-		const first = phases[0];
-		if (typeof first.startMs !== "number") return null;
-		return performance.now() - first.startMs;
-	}
-	/**
 	* Serialise an Error (recursively for `cause` chain) into an AuditErrorEntry.
 	* Stack is included only when `includeStack === true` (dev default).
 	* Cause chain is capped at `maxCauseDepth`.
@@ -156,4 +159,4 @@ var JsonAuditLogger = class {
 	}
 };
 //#endregion
-export { JsonAuditLogger as default, severityFromStatus };
+export { computeDurationMs, JsonAuditLogger as default, severityFromStatus };