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

package/docs/servers.md

@@ -22,7 +22,7 @@ tags:
   ]
 version: "doc"
 status: stable
-updated: 2026-07-19
+updated: 2026-10-30
 source: "src/packages/@nodefony/http/docs/servers.md"
 coverageModule: http
 coverageFiles: servers/server-http.ts,servers/server-https.ts,servers/server-websocket.ts,certificates.ts
@@ -552,22 +552,26 @@ Depuis `http2Schema` (`config.ts#http2Schema`), appliqué seulement si défini
 Depuis `websocketSchema` (`config.ts#websocketSchema`). Les deux sections partagent la forme et les défauts ; le WSS
 lit `websocketSecure` (`config.ts#httpConfigSchema`).
 
-| Option                   | Type                | Défaut  | Effet                                                                                    |
-| ------------------------ | ------------------- | ------- | ---------------------------------------------------------------------------------------- |
-| `keepaliveInterval`      | ms                  | `20000` | Intervalle des pings — détecte les connexions zombies.                                   |
-| `keepaliveGracePeriod`   | ms                  | `10000` | Délai de grâce après un ping sans réponse avant fermeture.                               |
-| `closeTimeout`           | ms                  | `5000`  | Délai de fermeture propre avant destruction de la socket.                                |
-| `maxPayload`             | octets              | `1 MiB` | Taille max d'un message entrant → au-delà, **close 1009** (`config.ts#websocketSchema`). |
-| `allowedOrigins`         | bool \| str \| list | `false` | Allowlist d'`Origin` au handshake — **anti-CSWSH** (`config.ts#websocketSchema`).        |
-| `perMessageDeflate`      | bool \| objet       | `false` | Compression RFC 7692. Désactivée par défaut : coût CPU/RAM + risque de _zip bomb_.       |
-| `skipUTF8Validation`     | bool                | `false` | Désactive la validation UTF-8 des frames texte (RFC 6455 §8.1). À laisser `false`.       |
-| `autoPong`               | bool                | `true`  | Répond automatiquement aux pings entrants (RFC 6455 §5.5.2-3). À laisser `true`.         |
-| `allowSynchronousEvents` | bool                | `true`  | Émet plusieurs frames d'un même chunk réseau de façon synchrone (débit vs équité).       |
-| `maxBackpressure`        | octets              | `4 MiB` | Seuil du tampon d'envoi par connexion (client lent à recevoir) — anti-OOM.               |
-| `backpressurePolicy`     | `drop` \| `close`   | `drop`  | Au-delà du seuil : sauter la frame, ou fermer le client (close 1013).                    |
+| Option                        | Type                | Défaut  | Effet                                                                                    |
+| ----------------------------- | ------------------- | ------- | ---------------------------------------------------------------------------------------- |
+| `keepaliveInterval`           | ms                  | `20000` | Intervalle des pings — détecte les connexions zombies.                                   |
+| `keepaliveGracePeriod`        | ms                  | `10000` | Délai de grâce après un ping sans réponse avant fermeture.                               |
+| `closeTimeout`                | ms                  | `5000`  | Délai de fermeture propre avant destruction de la socket.                                |
+| `maxPayload`                  | octets              | `1 MiB` | Taille max d'un message entrant → au-delà, **close 1009** (`config.ts#websocketSchema`). |
+| `allowedOrigins`              | bool \| str \| list | `false` | Allowlist d'`Origin` au handshake — **anti-CSWSH** (`config.ts#websocketSchema`).        |
+| `perMessageDeflate`           | bool \| objet       | `false` | Compression RFC 7692. Désactivée par défaut : coût CPU/RAM + risque de _zip bomb_.       |
+| `skipUTF8Validation`          | bool                | `false` | Désactive la validation UTF-8 des frames texte (RFC 6455 §8.1). À laisser `false`.       |
+| `autoPong`                    | bool                | `true`  | Répond automatiquement aux pings entrants (RFC 6455 §5.5.2-3). À laisser `true`.         |
+| `allowSynchronousEvents`      | bool                | `true`  | Émet plusieurs frames d'un même chunk réseau de façon synchrone (débit vs équité).       |
+| `maxBackpressure`             | octets              | `4 MiB` | Seuil du tampon d'envoi par connexion (client lent à recevoir) — anti-OOM.               |
+| `backpressurePolicy`          | `drop` \| `close`   | `drop`  | Au-delà du seuil : sauter la frame, ou fermer le client (close 1013).                    |
+| `backpressureCloseAfterDrops` | frames              | `1000`  | Solde de frames refusées (+1 refus, −1 envoi) qui ferme en 1013 ; `0` = jamais.          |
+| `maxFramesPerSecond`          | trames / s          | `0`     | Trames REÇUES admises par connexion ; au-delà, écartées avant décodage. `0` = coupé.     |
+| `frameRateCloseAfterRejects`  | trames              | `1000`  | Solde de trames écartées (+1 écartée, −1 admise) qui ferme en 1008 ; `0` = jamais.       |
 
 > [!WARNING]
-> `keepalive*`, `closeTimeout`, `maxBackpressure` et `backpressurePolicy` sont des **réglages
+> `keepalive*`, `closeTimeout`, `maxBackpressure`, `backpressurePolicy`,
+> `backpressureCloseAfterDrops`, `maxFramesPerSecond` et `frameRateCloseAfterRejects` sont des **réglages
 > Nodefony**, pas des options de `ws` : la bibliothèque les ignore, c'est le framework qui les
 > implémente. À l'inverse, `server`, `noServer`, `clientTracking`, `host`, `port` et `backlog` sont
 > **gérés par Nodefony** et non exposés — les forcer n'aurait pas d'effet.
@@ -952,6 +956,13 @@ descripteur et du TLS, et couvre tous les pods. Ne l'activer que sur une machine
 l'OOM — un seul lent peut plomber une diffusion générale. La politique par défaut, `drop`, saute la
 frame et garde le client connecté.
 
+Dans l'autre sens, `maxFramesPerSecond` borne le **nombre** de trames qu'une connexion envoie
+(désactivé par défaut). Le compte se fait à l'arrivée de la trame brute
+(`wsFrameRate.ts#admitFrame`) : une trame écartée ne paie ni décodage ni routage, elle est
+comptée (`frameRateRejectedTotal()`, relayé par la sonde du hub temps réel) et la connexion reste
+ouverte — jusqu'à ce que le solde de refus atteigne `frameRateCloseAfterRejects`, qui ferme en
+**1008**. Seul un flux au-delà du double de la borne fait monter ce solde ; un pic passager non.
+
 ## ⚡ Performance & mémoire
 
 Le transport est du **chemin chaud absolu** : ce qui coûte ici est multiplié par le nombre de requêtes

package/docs/session.md

@@ -469,8 +469,8 @@ timer (`gcIntervalS: 0`).
 
 ## Entités de persistance
 
-**Drizzle (SQL).** La table est décrite une seule fois en spec logique (`SESSION_TABLE_SPEC`,
-`sessionEntity.ts#SESSION_TABLE_SPEC`) et déclinée par dialecte par `buildFrameworkTable()` (`colKit.ts#buildFrameworkTable`) — mêmes **noms** de
+**Drizzle (SQL).** La table est décrite une seule fois en spec logique (`SESSION_TABLE`,
+`sessionEntity.ts#SESSION_TABLE`) et déclinée par dialecte par `defineTable()` (`colKit.ts#defineTable`) — mêmes **noms** de
 colonnes partout, donc un store dialect-agnostique.
 
 | Colonne      | Type logique | SQLite              | PostgreSQL | MySQL / MariaDB | Rôle                             |
@@ -485,7 +485,7 @@ colonnes partout, donc un store dialect-agnostique.
 
 En MySQL/MariaDB, une colonne texte indexée devient `varchar` (un `TEXT` InnoDB n'est pas indexable
 sans préfixe) et le type JSON passe par un type compatible qui tolère MariaDB, laquelle stocke le JSON
-en `LONGTEXT` (`colKit.ts#mysqlColumn`).
+en `LONGTEXT` (`colKit.mysql.ts#buildMySqlTable`).
 
 **Mongoose (MongoDB).** Schéma équivalent (`@nodefony/mongoose/nodefony/entity/sessionEntity.ts#schema`) :
 `session_id` (String, index **unique**), `Attributes`/`flashBag`/`metaBag` (Object, défaut `{}`), `user`

package/docs/sse.md

@@ -23,7 +23,7 @@ status: stable
 updated: 2026-10-08
 source: "src/packages/@nodefony/http/docs/sse.md"
 coverageModule: http
-coverageFiles: context/http/SseStream.ts
+coverageFiles: context/http/SseStream.ts,context/http/StreamLifecycle.ts
 ---
 
 📍 [Documentation](../../../../../docs/index.md) › [@nodefony/http](index.md) › **Flux SSE**
@@ -153,16 +153,16 @@ data: {"step":"écriture"}
 
 ### Côté serveur — `this.renderSse()` et l'objet `SseStream`
 
-| Membre                          | Rôle                                                                                                              |
-| ------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
-| `this.renderSse(options?)`      | ouvre le flux (`Controller.renderSse()`, `Controller.ts#Controller.renderSse`) ; lève sur WebSocket               |
-| `this.acceptsSse()`             | le client a-t-il demandé `text/event-stream` ? (`Controller.acceptsSse()`, `Controller.ts#Controller.acceptsSse`) |
-| `sse.send(data, { event, id })` | un événement ; texte tel quel, objet en JSON (`SseStream.send()`, `SseStream.ts#SseStream.send`)                  |
-| `sse.comment(text)`             | un commentaire, ignoré par le client                                                                              |
-| `sse.retry(ms)`                 | impose le délai de reconnexion du client                                                                          |
-| `sse.onClose(fn)`               | appelé à la fermeture, quel que soit le bout qui ferme (`SseStream.onClose()`, `SseStream.ts#SseStream.onClose`)  |
-| `sse.close()`                   | termine la requête, idempotent (`SseStream.close()`, `SseStream.ts#SseStream.close`)                              |
-| `sse.closed`                    | le flux est-il fermé — à tester dans une boucle longue                                                            |
+| Membre                          | Rôle                                                                                                                                                                                         |
+| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `this.renderSse(options?)`      | ouvre le flux (`Controller.renderSse()`, `Controller.ts#Controller.renderSse`) ; lève sur WebSocket                                                                                          |
+| `this.acceptsSse()`             | le client a-t-il demandé `text/event-stream` ? (`Controller.acceptsSse()`, `Controller.ts#Controller.acceptsSse`)                                                                            |
+| `sse.send(data, { event, id })` | un événement ; texte tel quel, objet en JSON ; des octets (`Uint8Array`, `Buffer`) lèvent un `TypeError` : les encoder soi-même (base64) (`SseStream.send()`, `SseStream.ts#SseStream.send`) |
+| `sse.comment(text)`             | un commentaire, ignoré par le client                                                                                                                                                         |
+| `sse.retry(ms)`                 | impose le délai de reconnexion du client                                                                                                                                                     |
+| `sse.onClose(fn)`               | appelé à la fermeture, quel que soit le bout qui ferme (`SseStream.onClose()`, `SseStream.ts#SseStream.onClose`)                                                                             |
+| `sse.close()`                   | termine la requête, idempotent (`SseStream.close()`, `SseStream.ts#SseStream.close`)                                                                                                         |
+| `sse.closed`                    | le flux est-il fermé — à tester dans une boucle longue                                                                                                                                       |
 
 Options de `renderSse()` :
 
@@ -214,18 +214,25 @@ le même qui relit le flux dans les tests du serveur.
 
 ## 🏗️ Architecture interne — ce que fait l'ouverture
 
+L'ouverture repose sur le **cycle de vie commun aux réponses en flux**
+(`StreamLifecycle.ts#openStreamLifecycle`, non exporté) — la même brique sert le [flux d'octets](byte-stream.md) :
+
 1. **La réponse est prise** (`context.sended`) : plus rien ne peut répondre à la place du flux.
-2. **La session est sauvée** s'il y en a une — ses cookies partent avec les en-têtes.
-3. **Le transport se constate** : flux HTTP/2, ou réponse HTTP/1.1 ; ni l'un ni l'autre → 500,
-   avant d'avoir rien écrit (`startSseStream()`, `SseStream.ts#startSseStream`).
-4. **Les en-têtes partent** — `respond()` en HTTP/2, `flushHeaders()` en HTTP/1.1 — et le délai
+2. **Le transport se constate** : flux HTTP/2, ou réponse HTTP/1.1 ; ni l'un ni l'autre → 500,
+   avant d'avoir rien écrit.
+3. **La fermeture de la réponse est écoutée AVANT toute attente** : un client parti pendant la
+   sauvegarde de la session est vu, et le flux naît fermé (`closed`) sans rien écrire. Un client
+   déjà parti ne prend pas de place dans le plafond par IP.
+4. **La session est sauvée** s'il y en a une — ses cookies partent avec les en-têtes.
+5. **Les en-têtes partent** — `respond()` en HTTP/2, `flushHeaders()` en HTTP/1.1 — et le délai
    d'inactivité de la requête est **désarmé** : sans cela, le flux vivant prendrait un 408 au bout
-   de 30 s.
-5. **Le battement démarre** sur un minuteur `unref()`.
+   de 30 s (`SseStream.ts#startSseStream`).
+6. **Le battement démarre** sur un minuteur `unref()`.
 
-La fin, quel que soit le bout qui ferme, passe par **un seul** nettoyage (`SseStream.ts#SseStream.send`) :
-minuteur arrêté, écouteurs `close` et `drain` retirés, attente de `drain` libérée, puis les
-écouteurs `onClose`.
+La fin, quel que soit le bout qui ferme, passe par **un seul** nettoyage
+(`StreamLifecycle.ts#StreamLifecycle.finish`) : écouteur `close` retiré, minuteurs de durée de vie et
+de blocage arrêtés, sortie du registre de révocation, puis le nettoyage propre au SSE (battement,
+écouteur `drain`, attente libérée), puis les écouteurs `onClose`.
 
 ## 🔐 Sécurité
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodefony/http",
-  "version": "10.0.0-beta.4",
+  "version": "10.0.0-beta.6",
   "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",
@@ -51,36 +51,36 @@
     "test": "./nodefony/tests"
   },
   "dependencies": {
-    "@fastify/busboy": "3.2.4",
-    "cookie": "2.0.1",
+    "@fastify/busboy": "3.2.5",
+    "@types/ms": "2.1.0",
+    "@types/qs": "6.15.1",
+    "@types/serve-static": "2.2.0",
+    "@types/ws": "8.18.2",
+    "@types/xml2js": "0.4.14",
+    "cookie": "2.0.2",
     "mime-types": "3.0.2",
     "ms": "^2.1.3",
-    "qs": "^6.16.1",
+    "qs": "^6.17.1",
     "serve-static": "2.2.1",
-    "tslib": "2.8.1",
-    "ws": "8.22.0",
+    "tslib": "2.9.1",
+    "ws": "8.22.1",
     "xml2js": "0.6.2"
   },
   "devDependencies": {
     "@types/chai": "5.2.3",
     "@types/mime-types": "3.0.1",
-    "@types/ms": "2.1.0",
-    "@types/node": "26.6.5",
-    "@types/qs": "6.15.1",
-    "@types/serve-static": "2.2.0",
+    "@types/node": "26.6.6",
     "@types/websocket": "1.0.10",
-    "@types/ws": "8.18.2",
-    "@types/xml2js": "0.4.14",
-    "@vitest/coverage-v8": "5.0.5",
-    "nodefony": "^10.0.0-beta.4",
+    "@vitest/coverage-v8": "5.1.0",
+    "nodefony": "^10.0.0-beta.6",
     "tsx": "4.23.15",
-    "vitest": "5.0.5"
+    "vitest": "5.1.0"
   },
   "license": "Apache-2.0",
   "readmeFilename": "README.md",
   "contributors": [],
   "peerDependencies": {
-    "nodefony": "^10.0.0-beta.4",
+    "nodefony": "^10.0.0-beta.6",
     "zod": "^4.6.7"
   },
   "files": [