@nodefony/http 10.0.0-beta.6 → 10.0.0-beta.7

package/docs/upload.md

@@ -297,6 +297,30 @@ du calque de configuration — une application peut les changer pour une requêt
 sont lus au moment de lire le corps (`Request.readBodyLimits()`), donc un calque posé après ce moment
 (au pare-feu, dans un contrôleur) n'agit pas. Détail : [configuration](../../../../../docs/guides/configuration.md).
 
+### Par route — l'option `upload`
+
+Une route règle ses propres bornes d'envoi, sans toucher à celles des autres : un dépôt de vidéos
+relève `maxFileSize`, un avatar l'abaisse. Chaque clé déclarée remplace celle de la configuration,
+**dans les deux sens** ; une clé absente garde la valeur de la configuration
+(`framework/nodefony/src/Route.ts#RouteOptions.upload`).
+
+```ts ignore
+// un avatar : 256 Kio au plus, un seul fichier, son empreinte calculée pendant le flux
+@Post("/avatar", { upload: { maxFileSize: 262_144, maxFiles: 1, hashAlgorithm: "sha256" } })
+async avatar(@UploadedFile() file: IUploadedFile | undefined) {
+  return { size: file?.size ?? 0, sha256: file?.hash ?? null };
+}
+```
+
+- **Le fichier trop gros est coupé PENDANT son flux** (413) : la route est résolue avant la lecture
+  du corps, ses bornes s'appliquent donc à busboy comme celles de la configuration — jamais un
+  fichier écrit en entier puis refusé (`context/http/Request.ts#HttpRequest.readBodyLimits`).
+- **Une route sans l'option ne paie rien** : aucune fusion, aucune allocation.
+- **Validée à la déclaration** (`framework/nodefony/decorators/routerDecorators.ts#checkedUpload`) :
+  entiers ≥ 1, empreinte connue, aucune clé inconnue — une faute de frappe (`maxFilesize`) laisserait
+  sinon la route sur la borne de l'application. `uploadDir` et `encoding` restent ceux de la
+  configuration. Exclue avec `bodyStream: true`, dont le corps n'est jamais lu par le pipeline.
+
 ### Fichiers multipart — `upload.*`
 
 Table dérivée de `uploadSchema` (`config/config.ts#uploadSchema`). Toutes les bornes sont `runtimeMutable`.
@@ -342,15 +366,15 @@ Les décorateurs `@UploadedFile` / `@UploadedFiles` sont des fabriques de param
 Chaque entrée de `files` est un `UploadedFile` (`service/upload/upload-service.ts#UploadedFile`), déjà écrit
 sur disque. Ses membres utiles :
 
-| Membre                   | Ce qu'il donne                                                          | Ancrage                                                                           |
-| ------------------------ | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
-| `filename`               | Nom **d'origine** déclaré par le client (métadonnée, jamais le chemin). | `realName()` (`service/upload/upload-service.ts#UploadedFile.realName`)           |
-| `size`                   | Taille réellement écrite (octets).                                      | `getSize()` (`service/upload/upload-service.ts#UploadedFile.getSize`)             |
-| `prettySize`             | Taille lisible (`« 1.2 MB »`).                                          | `getPrettySize()` (`service/upload/upload-service.ts#UploadedFile.getPrettySize`) |
-| `mimeType`               | Type MIME déclaré (`image/png`…), sinon deviné de l'extension.          | `getMimeType()` (`service/upload/upload-service.ts#UploadedFile.getMimeType`)     |
-| `hash` / `hashAlgorithm` | Empreinte d'intégrité si `upload.hashAlgorithm` est réglé.              | `interfaces/IUpload.ts#IUploadedFile.hashAlgorithm`                               |
-| `moveAsync(target)`      | Déplace le temp — **non bloquant, recommandé** dans le pipeline.        | `moveAsync()` (`service/upload/upload-service.ts#UploadedFile.moveAsync`)         |
-| `move(target)`           | Variante **synchrone** (compat) — bloque l'event-loop.                  | `move()` (`service/upload/upload-service.ts#UploadedFile.move`)                   |
+| Membre                   | Ce qu'il donne                                                                                                                                                              | Ancrage                                                                           |
+| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
+| `filename`               | Nom **d'origine** déclaré par le client (métadonnée, jamais le chemin).                                                                                                     | `realName()` (`service/upload/upload-service.ts#UploadedFile.realName`)           |
+| `size`                   | Taille réellement écrite (octets).                                                                                                                                          | `getSize()` (`service/upload/upload-service.ts#UploadedFile.getSize`)             |
+| `prettySize`             | Taille lisible (`« 1.2 MB »`).                                                                                                                                              | `getPrettySize()` (`service/upload/upload-service.ts#UploadedFile.getPrettySize`) |
+| `mimeType`               | Type MIME déclaré (`image/png`…), sinon deviné de l'extension ; `false` si ni l'un ni l'autre. Déclaratif : jamais une preuve du contenu.                                   | `getMimeType()` (`service/upload/upload-service.ts#UploadedFile.getMimeType`)     |
+| `hash` / `hashAlgorithm` | Empreinte d'intégrité si `upload.hashAlgorithm` est réglé.                                                                                                                  | `interfaces/IUpload.ts#IUploadedFile.hashAlgorithm`                               |
+| `moveAsync(target)`      | Déplace le temp — **non bloquant, recommandé** dans le pipeline. Rend le `FileClass` de la destination (sans nom d'origine ni empreinte : ils restent sur le fichier reçu). | `moveAsync()` (`service/upload/upload-service.ts#UploadedFile.moveAsync`)         |
+| `move(target)`           | Variante **synchrone** (compat) — bloque l'event-loop.                                                                                                                      | `move()` (`service/upload/upload-service.ts#UploadedFile.move`)                   |
 
 `move`/`moveAsync` acceptent un **fichier cible** ou un **dossier existant** : sur un dossier, la
 destination est bâtie avec `filename` — d'où l'avertissement de sécurité ci-dessous.
@@ -429,6 +453,7 @@ pipeline : `npm run test:memory` (skill `nodefony-check-memory-health`).
 | `@Body()` est vide sur un upload de fichier             | Les fichiers vont dans `files`, **pas** dans `body`                               | Lire les fichiers avec `@UploadedFiles()` / `this.files` ; `@Body()` = champs texte                                         |
 | Un `POST` JSON de 1,5 Mo est refusé en `413`            | `maxBodySize` vaut **1 MiB** par défaut                                           | Augmenter `maxBodySize` (pas `upload.maxFileSize`)                                                                          |
 | Un gros fichier passe alors que `maxBodySize` est petit | Le multipart **n'écoute pas** `maxBodySize`                                       | Régler `upload.maxFileSize` / `maxTotalFileSize`                                                                            |
+| Un avatar de 2 Go remplit le disque avant d'être refusé | La borne de l'application (500 Mo) vaut pour toutes les routes                    | Option de route `upload: { maxFileSize }` — coupé pendant le flux                                                           |
 | `413` sur upload sans message clair                     | Une borne busboy atteinte en streaming (fichier, cumul, nombre)                   | Vérifier les bornes `upload.*` — 413 émis sur `stream.on("limit")` (`context/http/Request.ts#HttpRequest.enforceBodyLimit`) |
 | Un fichier écrit `../../etc/…` après un `move`          | `move(dossier)` utilise le nom **client** (`upload-service.ts#UploadedFile.move`) | Passer une cible complète, ou `path.basename(file.filename)`                                                                |
 | Des fichiers temporaires s'accumulent dans `uploadDir`  | Le contrôleur ne déplace jamais le temp                                           | Appeler `moveAsync()` (ou purger l'ancien temp par TTL)                                                                     |
@@ -441,14 +466,15 @@ pipeline : `npm run test:memory` (skill `nodefony-check-memory-health`).
 Les chiffres exacts vivent dans la carte de tests de cette page (régénérée depuis vitest, jamais figés
 dans le Markdown).
 
-| Type                        | Où                                                                                                                  |
-| --------------------------- | ------------------------------------------------------------------------------------------------------------------- |
-| Unitaires — `UploadedFile`  | `unit/UploadedFile.test.ts` — `create()` async, `move`/`moveAsync`, `mimeType`, `realName`                          |
-| Unitaires — `@Body` stream  | `framework` `unit/BodyStream.test.ts` — `@Body({ stream })`, `resolveParamArg`, `routeExpectsBodyStream`            |
-| Intégration — multipart     | `http/upload.test.ts` — upload simple, multi-fichiers, mime non-octet, champ + fichier, `413` par fichier et cumulé |
-| Intégration — content-types | `http/body-content-types.test.ts` — JSON, urlencoded, `@Body("champ")`, XML → `body`                                |
-| Intégration — bornes        | `http/body-limit.test.ts` — sous la limite `200`, `Content-Length` > 1 MiB → `413`, chunked > 1 MiB refusé          |
-| Intégration — flux brut     | `integration/bodyStream.test.ts` — `@Body({ stream })` bout-en-bout (TLS + clair), non-régression `@Body()`         |
+| Type                        | Où                                                                                                                                                                                                            |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Unitaires — `UploadedFile`  | `unit/UploadedFile.test.ts` — `create()` async, `move`/`moveAsync`, `mimeType`, `realName`                                                                                                                    |
+| Unitaires — `@Body` stream  | `framework` `unit/BodyStream.test.ts` — `@Body({ stream })`, `resolveParamArg`, `routeExpectsBodyStream`                                                                                                      |
+| Intégration — multipart     | `http/upload.test.ts` — upload simple, multi-fichiers, mime non-octet, champ + fichier, `413` par fichier et cumulé ; bornes et empreinte PAR ROUTE (abaissée, relevée), aucun temporaire laissé par un refus |
+| Unitaires — option `upload` | `framework` `unit/httpMethodDecorators.test.ts` — portée jusqu'à la route, figée ; refus à la déclaration                                                                                                     |
+| Intégration — content-types | `http/body-content-types.test.ts` — JSON, urlencoded, `@Body("champ")`, XML → `body`                                                                                                                          |
+| Intégration — bornes        | `http/body-limit.test.ts` — sous la limite `200`, `Content-Length` > 1 MiB → `413`, chunked > 1 MiB refusé                                                                                                    |
+| Intégration — flux brut     | `integration/bodyStream.test.ts` — `@Body({ stream })` bout-en-bout (TLS + clair), non-régression `@Body()`                                                                                                   |
 
 Ce qui **manque** aujourd'hui : pas de banc de **charge** dédié à l'upload (le streaming multipart n'est
 exercé que fonctionnellement), pas de test **d'attaque** (`*.attack.test.ts`) sur le path traversal de

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodefony/http",
-  "version": "10.0.0-beta.6",
+  "version": "10.0.0-beta.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",
@@ -12,6 +12,12 @@
       "types": "./dist/types/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./grpc": {
+      "nodefony-source": "./nodefony/grpc/index.ts",
+      "types": "./dist/types/nodefony/grpc/index.d.ts",
+      "import": "./dist/nodefony/grpc/index.js",
+      "default": "./dist/nodefony/grpc/index.js"
     }
   },
   "scripts": {
@@ -27,7 +33,7 @@
   },
   "private": false,
   "engines": {
-    "node": ">=24.14.0"
+    "node": "^24.16.0 || >=26.0.0"
   },
   "keywords": [
     "nodefony",
@@ -63,7 +69,7 @@
     "qs": "^6.17.1",
     "serve-static": "2.2.1",
     "tslib": "2.9.1",
-    "ws": "8.22.1",
+    "ws": "8.23.0",
     "xml2js": "0.6.2"
   },
   "devDependencies": {
@@ -72,7 +78,7 @@
     "@types/node": "26.6.6",
     "@types/websocket": "1.0.10",
     "@vitest/coverage-v8": "5.1.0",
-    "nodefony": "^10.0.0-beta.6",
+    "nodefony": "^10.0.0-beta.7",
     "tsx": "4.23.15",
     "vitest": "5.1.0"
   },
@@ -80,9 +86,23 @@
   "readmeFilename": "README.md",
   "contributors": [],
   "peerDependencies": {
-    "nodefony": "^10.0.0-beta.6",
+    "@bufbuild/protobuf": "^2.7.0",
+    "@connectrpc/connect": "^2.3.0",
+    "@connectrpc/connect-node": "^2.3.0",
+    "nodefony": "^10.0.0-beta.7",
     "zod": "^4.6.7"
   },
+  "peerDependenciesMeta": {
+    "@bufbuild/protobuf": {
+      "optional": true
+    },
+    "@connectrpc/connect": {
+      "optional": true
+    },
+    "@connectrpc/connect-node": {
+      "optional": true
+    }
+  },
   "files": [
     "dist",
     "docs"
@@ -90,7 +110,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "homepage": "https://nodefony.github.io/nodefony-core/",
+  "homepage": "https://nodefony.net/",
   "bugs": {
     "url": "https://github.com/nodefony/nodefony-core/issues"
   }