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 +115 -9
- package/CHANGELOG.md +19 -0
- package/README.md +26 -25
- package/dist/bin/nodefony.js +1 -1
- package/dist/node/package.json.js +1 -1
- package/docs/service.md +3 -1
- package/man/nodefony.1 +1 -1
- package/package.json +1 -1
- package/templates/app/base/README.md.tpl +12 -12
package/.ai/symbols.json
CHANGED
|
@@ -3,14 +3,14 @@
|
|
|
3
3
|
"producer": "repository",
|
|
4
4
|
"repoRoot": ".",
|
|
5
5
|
"stats": {
|
|
6
|
-
"files":
|
|
7
|
-
"symbols":
|
|
8
|
-
"classes":
|
|
9
|
-
"interfaces":
|
|
6
|
+
"files": 1135,
|
|
7
|
+
"symbols": 5009,
|
|
8
|
+
"classes": 396,
|
|
9
|
+
"interfaces": 1311,
|
|
10
10
|
"types": 565,
|
|
11
11
|
"enums": 2,
|
|
12
|
-
"functions":
|
|
13
|
-
"constants":
|
|
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
|
|
253
|
-
|
|
|
254
|
-
| **Échanger dans les deux sens**
|
|
255
|
-
| **Pousser dans un seul sens**
|
|
256
|
-
| **Des salons et leurs membres**
|
|
257
|
-
| **Décider qui entre**
|
|
258
|
-
| **Faire passer des octets**
|
|
259
|
-
| **Tenir à plusieurs instances**
|
|
260
|
-
| **Tenir la charge**
|
|
261
|
-
| **Des types de bout en bout**
|
|
262
|
-
| **Voir et tester**
|
|
263
|
-
| **gRPC**
|
|
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.
|
|
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.** À
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
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.
|
package/dist/bin/nodefony.js
CHANGED
|
@@ -2849,7 +2849,7 @@ function detectEnvironmentFromArgv(argv) {
|
|
|
2849
2849
|
}
|
|
2850
2850
|
}
|
|
2851
2851
|
// package.json
|
|
2852
|
-
var version = "10.0.0-beta.
|
|
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)
|
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:
|
|
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
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nodefony",
|
|
3
|
-
"version": "10.0.0-beta.
|
|
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
|
|
53
|
-
|
|
|
54
|
-
| **Échanger dans les deux sens**
|
|
55
|
-
| **Pousser dans un seul sens**
|
|
56
|
-
| **Des salons et leurs membres**
|
|
57
|
-
| **Décider qui entre**
|
|
58
|
-
| **Faire passer des octets**
|
|
59
|
-
| **Tenir à plusieurs instances**
|
|
60
|
-
| **Tenir la charge**
|
|
61
|
-
| **Des types de bout en bout**
|
|
62
|
-
| **Voir et tester**
|
|
63
|
-
| **gRPC**
|
|
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.
|