nodefony 10.0.0-beta.7 → 10.0.0-beta.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/.ai/symbols.json CHANGED
@@ -3,14 +3,14 @@
3
3
  "producer": "repository",
4
4
  "repoRoot": ".",
5
5
  "stats": {
6
- "files": 1134,
7
- "symbols": 4998,
8
- "classes": 394,
9
- "interfaces": 1309,
6
+ "files": 1135,
7
+ "symbols": 5009,
8
+ "classes": 396,
9
+ "interfaces": 1311,
10
10
  "types": 565,
11
11
  "enums": 2,
12
- "functions": 2021,
13
- "constants": 707
12
+ "functions": 2026,
13
+ "constants": 709
14
14
  },
15
15
  "symbols": {
16
16
  "Cli": {
@@ -32462,6 +32462,86 @@
32462
32462
  "module": "@nodefony/http",
32463
32463
  "description": "**Le vocabulaire de filtre du registre de rate-limit**, en noms PUBLICS — celui que la console écrit dans l'URL (`?limited=true`)."
32464
32464
  },
32465
+ "Http2SessionState": {
32466
+ "name": "Http2SessionState",
32467
+ "kind": "class",
32468
+ "file": "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts",
32469
+ "exported": true,
32470
+ "module": "@nodefony/http",
32471
+ "extends": null,
32472
+ "implements": [],
32473
+ "decorators": [],
32474
+ "description": "Ce que la surveillance retient d'UNE session HTTP/2 : la session et des nombres, tous posés à la construction (forme stable)."
32475
+ },
32476
+ "Http2ConnectionManager": {
32477
+ "name": "Http2ConnectionManager",
32478
+ "kind": "class",
32479
+ "file": "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts",
32480
+ "exported": true,
32481
+ "module": "@nodefony/http",
32482
+ "extends": null,
32483
+ "implements": [],
32484
+ "decorators": [],
32485
+ "description": "Gère les connexions HTTP/2 d'UN serveur — TLS (5152) comme h2c — selon la section `http2` : âge maximal et délai de grâce (gRPC A9), PING de keepalive (gRPC A9, RFC 9113 §6.7), police des PING reçu…"
32486
+ },
32487
+ "IHttp2ConnectionPolicy": {
32488
+ "name": "IHttp2ConnectionPolicy",
32489
+ "kind": "interface",
32490
+ "file": "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts",
32491
+ "exported": true,
32492
+ "module": "@nodefony/http",
32493
+ "extends": null,
32494
+ "description": "La gestion des connexions HTTP/2 lue dans la section `http2` du module, résolue en nombres : `0` coupe une fonction, `Infinity` lève une borne."
32495
+ },
32496
+ "IHttp2SessionActions": {
32497
+ "name": "IHttp2SessionActions",
32498
+ "kind": "interface",
32499
+ "file": "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts",
32500
+ "exported": true,
32501
+ "module": "@nodefony/http",
32502
+ "extends": null,
32503
+ "description": "Les gestes sur une session, séparés de la règle : la règle se prouve pas à pas sur des doublures, les gestes sur de vraies sessions."
32504
+ },
32505
+ "http2ConnectionPolicy": {
32506
+ "name": "http2ConnectionPolicy",
32507
+ "kind": "function",
32508
+ "file": "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts",
32509
+ "exported": true,
32510
+ "module": "@nodefony/http",
32511
+ "description": "Résout la gestion des connexions HTTP/2 depuis la config du module."
32512
+ },
32513
+ "connectionAgeDeadline": {
32514
+ "name": "connectionAgeDeadline",
32515
+ "kind": "function",
32516
+ "file": "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts",
32517
+ "exported": true,
32518
+ "module": "@nodefony/http",
32519
+ "description": "Échéance d'âge d'une connexion, avec ± 10 % d'aléa propre à la connexion (gRPC A9) : sans lui, les clients d'un même démarrage reconnecteraient ensemble, à période fixe."
32520
+ },
32521
+ "http2ConnectionTick": {
32522
+ "name": "http2ConnectionTick",
32523
+ "kind": "function",
32524
+ "file": "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts",
32525
+ "exported": true,
32526
+ "module": "@nodefony/http",
32527
+ "description": "Un tour de surveillance : âge, délai de grâce et keepalive de chaque session."
32528
+ },
32529
+ "judgeReceivedPing": {
32530
+ "name": "judgeReceivedPing",
32531
+ "kind": "function",
32532
+ "file": "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts",
32533
+ "exported": true,
32534
+ "module": "@nodefony/http",
32535
+ "description": "Juge un PING reçu (gRPC A8, « Server Enforcement ») : trop proche du dernier PING valide, c'est une faute ; au-delà de `maxPingStrikes` fautes, le pair abuse."
32536
+ },
32537
+ "manageHttp2Connections": {
32538
+ "name": "manageHttp2Connections",
32539
+ "kind": "function",
32540
+ "file": "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts",
32541
+ "exported": true,
32542
+ "module": "@nodefony/http",
32543
+ "description": "Arme la gestion des connexions d'un serveur HTTP/2 si la section `http2` la demande. Règle UNIQUE des serveurs HTTP/2 — TLS (5152) comme h2c."
32544
+ },
32465
32545
  "announceSessionClose": {
32466
32546
  "name": "announceSessionClose",
32467
32547
  "kind": "function",
@@ -32486,6 +32566,22 @@
32486
32566
  "module": "@nodefony/http",
32487
32567
  "description": "Plus long délai d'annonce (ms) : un pair qui ne répond pas au PING ne retient pas la fermeture."
32488
32568
  },
32569
+ "GOAWAY_MAX_IDLE": {
32570
+ "name": "GOAWAY_MAX_IDLE",
32571
+ "kind": "const",
32572
+ "file": "src/packages/@nodefony/http/nodefony/src/servers/http2Goaway.ts",
32573
+ "exported": true,
32574
+ "module": "@nodefony/http",
32575
+ "description": "Données de débogage du GOAWAY d'une session fermée pour inactivité (gRPC A9, `MAX_CONNECTION_IDLE`) — allouées une fois, partagées par toutes les sessions."
32576
+ },
32577
+ "GOAWAY_MAX_AGE": {
32578
+ "name": "GOAWAY_MAX_AGE",
32579
+ "kind": "const",
32580
+ "file": "src/packages/@nodefony/http/nodefony/src/servers/http2Goaway.ts",
32581
+ "exported": true,
32582
+ "module": "@nodefony/http",
32583
+ "description": "Données de débogage du GOAWAY d'une session qui a atteint son âge maximal (gRPC A9, `MAX_CONNECTION_AGE`)."
32584
+ },
32489
32585
  "http2ServerLimits": {
32490
32586
  "name": "http2ServerLimits",
32491
32587
  "kind": "function",
@@ -44184,7 +44280,6 @@
44184
44280
  "src/packages/@nodefony/http/nodefony/service/certificates.ts",
44185
44281
  "src/packages/@nodefony/http/nodefony/service/http-kernel.ts",
44186
44282
  "src/packages/@nodefony/http/nodefony/service/servers/server-http.ts",
44187
- "src/packages/@nodefony/http/nodefony/service/servers/server-https.ts",
44188
44283
  "src/packages/@nodefony/http/nodefony/service/servers/server-websocket-secure.ts",
44189
44284
  "src/packages/@nodefony/http/nodefony/service/servers/server-websocket.ts",
44190
44285
  "src/packages/@nodefony/http/nodefony/service/sessions/sessions-service.ts",
@@ -53069,6 +53164,7 @@
53069
53164
  "src/packages/@nodefony/http/nodefony/service/servers/server-websocket-secure.ts",
53070
53165
  "src/packages/@nodefony/http/nodefony/service/servers/server-websocket.ts",
53071
53166
  "src/packages/@nodefony/http/nodefony/service/sessions/sessions-service.ts",
53167
+ "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts",
53072
53168
  "src/packages/@nodefony/http/nodefony/src/servers/http2Limits.ts"
53073
53169
  ],
53074
53170
  "IHttpConfigInput": [
@@ -53466,7 +53562,8 @@
53466
53562
  "src/packages/@nodefony/http/nodefony/service/http-kernel.ts"
53467
53563
  ],
53468
53564
  "SHUTDOWN_STREAMS_WAIT_MS": [
53469
- "src/packages/@nodefony/http/nodefony/service/http-kernel.ts"
53565
+ "src/packages/@nodefony/http/nodefony/service/http-kernel.ts",
53566
+ "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts"
53470
53567
  ],
53471
53568
  "ShutdownRegistry": [
53472
53569
  "src/packages/@nodefony/http/nodefony/service/http-kernel.ts"
@@ -53608,6 +53705,10 @@
53608
53705
  "src/packages/@nodefony/http/nodefony/service/servers/server-h2c.ts",
53609
53706
  "src/packages/@nodefony/http/nodefony/service/servers/server-https.ts"
53610
53707
  ],
53708
+ "manageHttp2Connections": [
53709
+ "src/packages/@nodefony/http/nodefony/service/servers/server-h2c.ts",
53710
+ "src/packages/@nodefony/http/nodefony/service/servers/server-https.ts"
53711
+ ],
53611
53712
  "bindWithFallback": [
53612
53713
  "src/packages/@nodefony/http/nodefony/service/servers/server-h2c.ts",
53613
53714
  "src/packages/@nodefony/http/nodefony/service/servers/server-http.ts",
@@ -53647,7 +53748,8 @@
53647
53748
  ],
53648
53749
  "ANNOUNCE_CAP_MS": [
53649
53750
  "src/packages/@nodefony/http/nodefony/service/servers/serverShutdown.ts",
53650
- "src/packages/@nodefony/http/nodefony/src/context/http/StreamLifecycle.ts"
53751
+ "src/packages/@nodefony/http/nodefony/src/context/http/StreamLifecycle.ts",
53752
+ "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts"
53651
53753
  ],
53652
53754
  "announceSessionClose": [
53653
53755
  "src/packages/@nodefony/http/nodefony/service/servers/serverShutdown.ts"
@@ -53962,7 +54064,11 @@
53962
54064
  "RateLimitVerdict": [
53963
54065
  "src/packages/@nodefony/http/nodefony/src/rateLimit/MemoryRateLimitStore.ts"
53964
54066
  ],
54067
+ "GOAWAY_MAX_AGE": [
54068
+ "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts"
54069
+ ],
53965
54070
  "closeIdleSession": [
54071
+ "src/packages/@nodefony/http/nodefony/src/servers/http2Connections.ts",
53966
54072
  "src/packages/@nodefony/http/nodefony/src/servers/http2Limits.ts"
53967
54073
  ],
53968
54074
  "ServersConfig": [
package/CHANGELOG.md CHANGED
@@ -8,6 +8,25 @@ Les sections naissent d'un BROUILLON rendu par `npm run release` depuis les mess
8
8
  de commit, puis sont RÉÉCRITES à la main : un journal git est écrit pour l'auteur,
9
9
  un changelog pour celui qui met à jour.
10
10
 
11
+ ## 10.0.0-beta.8 - 2026-11-16
12
+
13
+ _Une bêta de durcissement HTTP/2 : l'âge des connexions se borne, un pair muet se sonde, un pair qui pingue trop se ferme — tout inactif par défaut. Une rupture : la section `http2` refuse désormais une clé qu'elle ne lit pas._
14
+
15
+ ### Changed
16
+
17
+ - **http (breaking):** Refuser au démarrage une clé inconnue dans la section `http2` de la configuration — elle se disait transmise à Node, mais seules `maxConcurrentStreams` et `maxSessionMemory` étaient lues et toute autre clé restait sans effet : retirer la clé que le démarrage nomme (68d74ed3b)
18
+
19
+ ### Added
20
+
21
+ - **http:** Borner l'âge des connexions HTTP/2 (`maxConnectionAge`, `maxConnectionAgeGrace`), sonder les pairs muets par PING (`keepaliveInterval`, `keepaliveTimeout`) et fermer un pair qui pingue trop (`minPingInterval`, `maxPingStrikes`), sur le port TLS comme en h2c — rien n'est armé sans clé posée (68d74ed3b)
22
+
23
+ ### Fixed
24
+
25
+ - **devkit:** Mesurer l'audit `desktop` de la sonde navigateur (`nodefony see --audit`) dans les conditions d'un poste de bureau, et non sous le bridage d'un téléphone (827899fbb)
26
+ - **devkit:** Nommer, quand l'écran de connexion n'apparaît pas, les requêtes restées sans réponse, celles en échec avec leur motif et les erreurs de la page (6967b65a6)
27
+
28
+ <!-- Surface publique mesurée depuis 10.0.0-beta.7 (npm) : 0 retrait ; 2 déclarations à relire, relues — `httpConfigSchema` (la rupture ci-dessus) et `NODEFONY_CLIENT` (extensions des import() du .d.ts, rétablies au pack : tarball identique à la beta.7). Détail : npm run release:api-diff -- --from 10.0.0-beta.7 --details -->
29
+
11
30
  ## 10.0.0-beta.7 - 2026-11-15
12
31
 
13
32
  _Une bêta qui ouvre deux portes : servir des services gRPC dans le pipeline HTTP/2, et publier la présence d'un canal temps réel, répartie entre exemplaires. L'arrêt passe en deux phases, et `create app --demo` livre une démo complète à essayer et à lire. Huit ruptures, chacune avec son geste de migration._
package/README.md CHANGED
@@ -249,18 +249,18 @@ décider qui entre ; faire passer des octets ; tenir à plusieurs instances ; vo
249
249
  quand ça coince. Chacune a sa réponse dans le framework, écrite contre la norme qui la définit, et
250
250
  éprouvée par des tests.
251
251
 
252
- | Ce qu'il te faut | Ce que Nodefony fournit |
253
- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
254
- | **Échanger dans les deux sens** | La **socket Nodefony** : des canaux à volonté sur une seule connexion — le serveur diffuse, le client appelle et attend la réponse, ou pousse sans attendre. JSON-RPC 2.0 sur WebSocket (RFC 6455), dans le pipeline HTTP |
255
- | **Pousser dans un seul sens** | Les **flux SSE** (`text/event-stream`) : une action répond par `this.renderSse()`, en HTTP/1.1 comme en HTTP/2. Le client isomorphe se reconnecte avec `Last-Event-ID`, et sait envoyer un `POST` et des en-têtes |
256
- | **Des salons et leurs membres** | **Canaux à membres** : lister qui est là, abonner d'office, éjecter un compte, fermer le salon, sur toutes les instances. Un message privé atteint une personne par `publishToUser` |
257
- | **Décider qui entre** | Une **règle d'admission** par canal (`allow`, fonction ou service injecté), sous le même pare-feu que le HTTP. Origine vérifiée à la poignée de main ; un jeton expiré ferme la socket avec un code dédié |
258
- | **Faire passer des octets** | **CBOR** (RFC 8949), négocié connexion par connexion — détaillé ci-dessous |
259
- | **Tenir à plusieurs instances** | Un bus de diffusion entre workers ou par Redis, messages scellés (HMAC-SHA256). Un seul producteur par canal et par processus, quel que soit le nombre d'abonnés |
260
- | **Tenir la charge** | Contre-pression en sortie, débit borné en entrée, cadence de diffusion qui s'adapte à chaque client |
261
- | **Des types de bout en bout** | Un **contrat** écrit une fois type le contrôleur, la socket et les hooks React, Vue, Svelte et Angular. Les routes qu'il annonce sont vérifiées au démarrage |
262
- | **Voir et tester** | Une sonde, la console d'administration, les onglets Socket et SSE de la barre de débogage, un traceur de trames ; une identité d'essai pour tester un canal protégé |
263
- | **gRPC** — _à venir en 10.0.0-beta.7_ | Des services gRPC servis par le même pipeline HTTP/2, déclarés depuis un module, avec la réflexion et la santé standard |
252
+ | Ce qu'il te faut | Ce que Nodefony fournit |
253
+ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
254
+ | **Échanger dans les deux sens** | La **socket Nodefony** : des canaux à volonté sur une seule connexion — le serveur diffuse, le client appelle et attend la réponse, ou pousse sans attendre. JSON-RPC 2.0 sur WebSocket (RFC 6455), dans le pipeline HTTP |
255
+ | **Pousser dans un seul sens** | Les **flux SSE** (`text/event-stream`) : une action répond par `this.renderSse()`, en HTTP/1.1 comme en HTTP/2. Le client isomorphe se reconnecte avec `Last-Event-ID`, et sait envoyer un `POST` et des en-têtes |
256
+ | **Des salons et leurs membres** | **Canaux à membres** : lister qui est là, abonner d'office, éjecter un compte, fermer le salon, sur toutes les instances. Un message privé atteint une personne par `publishToUser` |
257
+ | **Décider qui entre** | Une **règle d'admission** par canal (`allow`, fonction ou service injecté), sous le même pare-feu que le HTTP. Origine vérifiée à la poignée de main ; un jeton expiré ferme la socket avec un code dédié |
258
+ | **Faire passer des octets** | **CBOR** (RFC 8949), négocié connexion par connexion — détaillé ci-dessous |
259
+ | **Tenir à plusieurs instances** | Un bus de diffusion entre workers ou par Redis, messages scellés (HMAC-SHA256). Un seul producteur par canal et par processus, quel que soit le nombre d'abonnés |
260
+ | **Tenir la charge** | Contre-pression en sortie, débit borné en entrée, cadence de diffusion qui s'adapte à chaque client |
261
+ | **Des types de bout en bout** | Un **contrat** écrit une fois type le contrôleur, la socket et les hooks React, Vue, Svelte et Angular. Les routes qu'il annonce sont vérifiées au démarrage |
262
+ | **Voir et tester** | Une sonde, la console d'administration, les onglets Socket et SSE de la barre de débogage, un traceur de trames ; une identité d'essai pour tester un canal protégé |
263
+ | **gRPC** | Des services gRPC servis par le même pipeline HTTP/2, déclarés depuis un module ; la réflexion et la santé standard sont à venir |
264
264
 
265
265
  Chaque besoin a son exemple complet et testé : jeu (déplacements, recherche de partie), salon privé
266
266
  sur invitation, sonde industrielle, tableau de bord partagé, notification privée, tâche d'agent.
@@ -370,7 +370,7 @@ appeler.
370
370
 
371
371
  ## Démarrage
372
372
 
373
- Une préversion `10.0.0-beta.6` est en ligne sous le canal `beta`. Une bêta n'est pas une version
373
+ Une préversion `10.0.0-beta.8` est en ligne sous le canal `beta`. Une bêta n'est pas une version
374
374
  stable : une rupture reste possible d'une bêta à la suivante — chacune est alors annoncée en tête
375
375
  du [CHANGELOG](https://github.com/nodefony/nodefony-core/blob/main/CHANGELOG.md) — et elle n'est pas destinée à la production. Elle s'installe en
376
376
  nommant ce canal :
@@ -771,18 +771,19 @@ construction des frontends — est couvert par des suites de tests exécutables
771
771
  réelle, et le dépôt versionne des seuils de fuite mémoire et de charge
772
772
  opposables à chaque exécution.
773
773
 
774
- **Ce que ça donne en charge.** À travail égal — mêmes journaux, même contexte de requête, mêmes
775
- en-têtes de sécurité, même protection CSRF —, Nodefony se tient **dans la même zone que les frameworks
776
- Node.js établis, munis des mêmes intergiciels** : entre 93,6 et 112,7 % de leur débit sur une route qui ne
777
- fait rien (21 686 requêtes/s, p99 4,4 ms sur la machine de référence), entre 95,9 et 96,7 % sur une
778
- route qui lit et écrit une base — pour une résolution de banc de 3 %. Quatre-vingt-huit minutes de
779
- charge continue et 97,5 millions de requêtes laissent **le tas, l'empreinte mémoire et le `rss`
780
- plats** : 0,021 Mo par million de requêtes. La page de mesures de la version courante —
781
- **[peut-on partir en production ?](https://nodefony.net/performance/latest/)** — porte le comparatif, la
782
- tenue dans la durée, le dimensionnement d'un pod et un calculateur ; elle nomme aussi ce que ces
783
- chiffres **ne** prouvent pas. Le dossier [`docs/performance/`](https://nodefony.net/performance/) donne le
784
- protocole, les scripts qui rejouent chaque chiffre et les instruments qui ont menti avant qu'on
785
- s'en aperçoive — aucun absolu pris derrière un chemin virtualisé n'est transposable.
774
+ **Ce que ça donne en charge.** À résultat observable égal — mêmes en-têtes de sécurité, même
775
+ identifiant de requête, même corrélation `traceparent`, même protection CSRF, vérifiés par un
776
+ contrôle de parité —, Nodefony sert de 4 à 17 % de requêtes en moins que NestJS 12 équipé (sur
777
+ Fastify et sur `node:http`) et se tient dans la même zone qu'Express 5 équipé, sur une route qui
778
+ ne fait rien — le cas où le framework est tout le budget. Dès qu'une base entre dans la boucle, les
779
+ camps se tiennent à quelques pourcents, sauf sur le refus de validation face à Express (−21 %),
780
+ où Nodefony audite chaque refus quand le témoin n'en garde aucune trace. Quatre-vingt-dix minutes de charge continue et 110 millions de requêtes
781
+ laissent le tas plat et aucune ressource accumulée. Mesuré sur un portable de 2018 : seuls les
782
+ rapports entre camps valent, pas les absolus. La page de la version courante —
783
+ **[peut-on partir en production ?](https://nodefony.net/performance/latest/)** — porte le comparatif,
784
+ la tenue dans la durée et le dimensionnement d'un pod ;
785
+ **[où part le temps](https://nodefony.net/performance/analyses/)** décompose l'écart étage par étage
786
+ et nomme le travail que la parité ne voit pas.
786
787
 
787
788
  Ce qu'il faut savoir avant de bâtir dessus : les versions JavaScript historiques (≤ 7.x) ne
788
789
  reçoivent plus de correctifs.
@@ -2849,7 +2849,7 @@ function detectEnvironmentFromArgv(argv) {
2849
2849
  }
2850
2850
  }
2851
2851
  // package.json
2852
- var version = "10.0.0-beta.7";
2852
+ var version = "10.0.0-beta.8";
2853
2853
  // src/bin/nodefony.ts
2854
2854
  /**
2855
2855
  * Résout le **mode runtime** (dev/prod) AVANT le kernel : `NODE_ENV` (ambiant)
@@ -1,3 +1,3 @@
1
1
  // package.json
2
- var version = "10.0.0-beta.7";
2
+ var version = "10.0.0-beta.8";
3
3
  export { version };
package/docs/service.md CHANGED
@@ -423,7 +423,9 @@ spec:
423
423
  containers:
424
424
  - name: purge
425
425
  image: mon-app:1.4.0
426
- command: ["npx", "nodefony", "app:purge"]
426
+ # `args:`, jamais `command:` : l'ENTRYPOINT de l'image générée est node
427
+ # (distroless — ni npx, ni shell), et `command:` le remplacerait.
428
+ args: ["node_modules/nodefony/bin/nodefony", "app:purge"]
427
429
  ```
428
430
 
429
431
  La commande démarre le noyau en mode console : `schedulePeriodic()` et `runOnceAtStartup()` n'y
package/man/nodefony.1 CHANGED
@@ -1,4 +1,4 @@
1
- .TH NODEFONY 1 "" "nodefony 10.0.0\-beta.7" "Nodefony Manual"
1
+ .TH NODEFONY 1 "" "nodefony 10.0.0\-beta.8" "Nodefony Manual"
2
2
  .SH NAME
3
3
  nodefony \- framework fullstack Node.js : HTTP, WebSocket, ORM, agents
4
4
  .SH SYNOPSIS
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nodefony",
3
- "version": "10.0.0-beta.7",
3
+ "version": "10.0.0-beta.8",
4
4
  "description": "Noyau du framework Nodefony : modules, injection de dépendances, configuration validée au démarrage, journalisation structurée corrélée, CLI — et le client temps réel partagé avec le navigateur",
5
5
  "type": "module",
6
6
  "exports": {
@@ -49,18 +49,18 @@ décider qui entre ; faire passer des octets ; tenir à plusieurs instances ; vo
49
49
  quand ça coince. Chacune a sa réponse dans le framework, écrite contre la norme qui la définit, et
50
50
  éprouvée par des tests.
51
51
 
52
- | Ce qu'il te faut | Ce que Nodefony fournit |
53
- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
54
- | **Échanger dans les deux sens** | La **socket Nodefony** : des canaux à volonté sur une seule connexion — le serveur diffuse, le client appelle et attend la réponse, ou pousse sans attendre. JSON-RPC 2.0 sur WebSocket (RFC 6455), dans le pipeline HTTP |
55
- | **Pousser dans un seul sens** | Les **flux SSE** (`text/event-stream`) : une action répond par `this.renderSse()`, en HTTP/1.1 comme en HTTP/2. Le client isomorphe se reconnecte avec `Last-Event-ID`, et sait envoyer un `POST` et des en-têtes |
56
- | **Des salons et leurs membres** | **Canaux à membres** : lister qui est là, abonner d'office, éjecter un compte, fermer le salon, sur toutes les instances. Un message privé atteint une personne par `publishToUser` |
57
- | **Décider qui entre** | Une **règle d'admission** par canal (`allow`, fonction ou service injecté), sous le même pare-feu que le HTTP. Origine vérifiée à la poignée de main ; un jeton expiré ferme la socket avec un code dédié |
58
- | **Faire passer des octets** | **CBOR** (RFC 8949), négocié connexion par connexion — détaillé ci-dessous |
59
- | **Tenir à plusieurs instances** | Un bus de diffusion entre workers ou par Redis, messages scellés (HMAC-SHA256). Un seul producteur par canal et par processus, quel que soit le nombre d'abonnés |
60
- | **Tenir la charge** | Contre-pression en sortie, débit borné en entrée, cadence de diffusion qui s'adapte à chaque client |
61
- | **Des types de bout en bout** | Un **contrat** écrit une fois type le contrôleur, la socket et les hooks React, Vue, Svelte et Angular. Les routes qu'il annonce sont vérifiées au démarrage |
62
- | **Voir et tester** | Une sonde, la console d'administration, les onglets Socket et SSE de la barre de débogage, un traceur de trames ; une identité d'essai pour tester un canal protégé |
63
- | **gRPC** — _à venir en 10.0.0-beta.7_ | Des services gRPC servis par le même pipeline HTTP/2, déclarés depuis un module, avec la réflexion et la santé standard |
52
+ | Ce qu'il te faut | Ce que Nodefony fournit |
53
+ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
54
+ | **Échanger dans les deux sens** | La **socket Nodefony** : des canaux à volonté sur une seule connexion — le serveur diffuse, le client appelle et attend la réponse, ou pousse sans attendre. JSON-RPC 2.0 sur WebSocket (RFC 6455), dans le pipeline HTTP |
55
+ | **Pousser dans un seul sens** | Les **flux SSE** (`text/event-stream`) : une action répond par `this.renderSse()`, en HTTP/1.1 comme en HTTP/2. Le client isomorphe se reconnecte avec `Last-Event-ID`, et sait envoyer un `POST` et des en-têtes |
56
+ | **Des salons et leurs membres** | **Canaux à membres** : lister qui est là, abonner d'office, éjecter un compte, fermer le salon, sur toutes les instances. Un message privé atteint une personne par `publishToUser` |
57
+ | **Décider qui entre** | Une **règle d'admission** par canal (`allow`, fonction ou service injecté), sous le même pare-feu que le HTTP. Origine vérifiée à la poignée de main ; un jeton expiré ferme la socket avec un code dédié |
58
+ | **Faire passer des octets** | **CBOR** (RFC 8949), négocié connexion par connexion — détaillé ci-dessous |
59
+ | **Tenir à plusieurs instances** | Un bus de diffusion entre workers ou par Redis, messages scellés (HMAC-SHA256). Un seul producteur par canal et par processus, quel que soit le nombre d'abonnés |
60
+ | **Tenir la charge** | Contre-pression en sortie, débit borné en entrée, cadence de diffusion qui s'adapte à chaque client |
61
+ | **Des types de bout en bout** | Un **contrat** écrit une fois type le contrôleur, la socket et les hooks React, Vue, Svelte et Angular. Les routes qu'il annonce sont vérifiées au démarrage |
62
+ | **Voir et tester** | Une sonde, la console d'administration, les onglets Socket et SSE de la barre de débogage, un traceur de trames ; une identité d'essai pour tester un canal protégé |
63
+ | **gRPC** | Des services gRPC servis par le même pipeline HTTP/2, déclarés depuis un module ; la réflexion et la santé standard sont à venir |
64
64
 
65
65
  Chaque besoin a son exemple complet et testé : jeu (déplacements, recherche de partie), salon privé
66
66
  sur invitation, sonde industrielle, tableau de bord partagé, notification privée, tâche d'agent.