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

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.5",
+  "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.5",
+    "@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.5",
+    "nodefony": "^10.0.0-beta.6",
     "zod": "^4.6.7"
   },
   "files": [