nodefony 10.0.0-beta.8 → 10.0.0

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.
Files changed (174) hide show
  1. package/.ai/symbols.json +497 -96
  2. package/CHANGELOG.md +54 -0
  3. package/README.md +44 -26
  4. package/dist/bin/nodefony.js +1 -1
  5. package/dist/client/client/angular/index.js +1 -1
  6. package/dist/client/client/debugbar/DebugBar.js +80 -17
  7. package/dist/client/client/debugbar/frames.js +26 -8
  8. package/dist/client/client/index.js +2 -2
  9. package/dist/client/client/react/index.js +1 -1
  10. package/dist/client/client/realtime/NodefonySocket.js +40 -16
  11. package/dist/client/client/realtime/observe.js +2 -2
  12. package/dist/client/client/realtime/snapshot.js +118 -8
  13. package/dist/client/client/sse/NodefonySse.js +1 -1
  14. package/dist/client/client/svelte/index.js +1 -1
  15. package/dist/client/client/vue/index.js +1 -1
  16. package/dist/client/debugbar.standalone.js +259 -47
  17. package/dist/client/realtime/base64url.js +1 -1
  18. package/dist/client/realtime/codec/decode.js +1 -1
  19. package/dist/client/realtime/codec/encode.js +3 -4
  20. package/dist/client/realtime/throughputProbe.js +1 -1
  21. package/dist/client/types/src/client/debugbar/DebugBar.d.ts +9 -3
  22. package/dist/client/types/src/client/index.d.ts +2 -2
  23. package/dist/client/types/src/client/realtime/NodefonySocket.d.ts +16 -3
  24. package/dist/client/types/src/client/realtime/observe.d.ts +2 -2
  25. package/dist/client/types/src/client/realtime/snapshot.d.ts +83 -1
  26. package/dist/client/types/src/kernel/runProfile.d.ts +16 -0
  27. package/dist/client/types/src/types/ICommand.d.ts +6 -0
  28. package/dist/node/Cli.js +6 -6
  29. package/dist/node/Error.js +3 -3
  30. package/dist/node/Event.js +1 -1
  31. package/dist/node/FileClass.js +3 -3
  32. package/dist/node/Nodefony.js +1 -1
  33. package/dist/node/bundler/index.js +1 -1
  34. package/dist/node/cli/agentTargets.js +2 -2
  35. package/dist/node/cli/aiMcp.js +2 -2
  36. package/dist/node/cli/aiSync.js +2 -2
  37. package/dist/node/cli/card.js +2 -2
  38. package/dist/node/cli/cliFreshness.js +1 -1
  39. package/dist/node/cli/completion.js +4 -4
  40. package/dist/node/cli/contributions.js +9 -8
  41. package/dist/node/cli/create.js +132 -28
  42. package/dist/node/cli/env.js +14 -5
  43. package/dist/node/cli/gitHooks.js +3 -3
  44. package/dist/node/cli/image/index.js +1 -1
  45. package/dist/node/cli/image/tarLayers.js +1 -1
  46. package/dist/node/cli/installCommand.js +86 -0
  47. package/dist/node/cli/installedPackages.js +34 -14
  48. package/dist/node/cli/licenses.js +3 -3
  49. package/dist/node/cli/man.js +2 -2
  50. package/dist/node/cli/manPage.js +1 -1
  51. package/dist/node/cli/outdated.js +1 -1
  52. package/dist/node/cli/packageManager.js +13 -1
  53. package/dist/node/cli/progress.js +1 -1
  54. package/dist/node/cli/projectRoot.js +1 -1
  55. package/dist/node/cli/prompts.js +1 -1
  56. package/dist/node/cli/scaffold/contribute.js +52 -0
  57. package/dist/node/cli/scaffold/engine.js +138 -24
  58. package/dist/node/cli/scaffold/format.js +1 -1
  59. package/dist/node/cli/scaffold/help.js +11 -3
  60. package/dist/node/cli/scaffold/interactive.js +1 -1
  61. package/dist/node/cli/scaffold/spec.js +9 -0
  62. package/dist/node/cli/scaffold/versions.js +6 -6
  63. package/dist/node/cli/see.js +3 -3
  64. package/dist/node/cli/symbols.js +2 -2
  65. package/dist/node/cli/symbolsGenerate.js +3 -3
  66. package/dist/node/cli/upgrade.js +66 -52
  67. package/dist/node/command/Builder.js +3 -3
  68. package/dist/node/command/Command.js +1 -1
  69. package/dist/node/config/defineEnv.js +1 -1
  70. package/dist/node/finder/Finder.js +2 -2
  71. package/dist/node/index.js +5 -3
  72. package/dist/node/kernel/CliKernel.js +2 -2
  73. package/dist/node/kernel/Kernel.js +9 -8
  74. package/dist/node/kernel/Module.js +3 -3
  75. package/dist/node/kernel/checks/deep.js +3 -3
  76. package/dist/node/kernel/checks/freshness.js +3 -3
  77. package/dist/node/kernel/checks/gating.js +1 -1
  78. package/dist/node/kernel/checks/guards.js +1 -1
  79. package/dist/node/kernel/checks/lastBoot.js +1 -1
  80. package/dist/node/kernel/checks/managerDrift.js +2 -2
  81. package/dist/node/kernel/checks/packageDeps.js +1 -1
  82. package/dist/node/kernel/checks/projectScope.js +2 -2
  83. package/dist/node/kernel/checks/readiness.js +2 -2
  84. package/dist/node/kernel/checks/renderReport.js +1 -1
  85. package/dist/node/kernel/checks/runDoctor.js +3 -3
  86. package/dist/node/kernel/checks/surface.js +2 -2
  87. package/dist/node/kernel/checks/wiring.js +2 -2
  88. package/dist/node/kernel/commands/BuildCommand.js +1 -1
  89. package/dist/node/kernel/commands/ClusterCommand.js +1 -1
  90. package/dist/node/kernel/commands/LicensesCommand.js +2 -2
  91. package/dist/node/kernel/commands/MenuCommand.js +3 -3
  92. package/dist/node/kernel/commands/OutdatedCommand.js +4 -4
  93. package/dist/node/kernel/commands/ProdCommand.js +1 -1
  94. package/dist/node/kernel/commands/UpgradeCommand.js +1 -1
  95. package/dist/node/kernel/commands/runtimeLauncher.js +1 -1
  96. package/dist/node/kernel/decorators/kernelDecorator.js +1 -1
  97. package/dist/node/kernel/injector/injector.js +1 -1
  98. package/dist/node/kernel/injector/serviceOrder.js +1 -1
  99. package/dist/node/kernel/kernelCluster.js +1 -1
  100. package/dist/node/kernel/kernelLog.js +2 -2
  101. package/dist/node/kernel/periodicTask.js +7 -2
  102. package/dist/node/kernel/runProfile.js +17 -1
  103. package/dist/node/kernel/storeManifest.js +2 -2
  104. package/dist/node/package.json.js +3 -2
  105. package/dist/node/realtime/base64url.js +1 -1
  106. package/dist/node/realtime/codec/decode.js +1 -1
  107. package/dist/node/realtime/codec/encode.js +3 -4
  108. package/dist/node/realtime/throughputProbe.js +1 -1
  109. package/dist/node/runtime/loadEnv.js +1 -1
  110. package/dist/node/runtime/scanPage.js +233 -0
  111. package/dist/node/service/cluster/ClusterManager.js +1 -1
  112. package/dist/node/service/cluster/clusterMaster.js +1 -1
  113. package/dist/node/service/cluster/cpuQuota.js +1 -1
  114. package/dist/node/service/cluster/richProcessProbe.js +1 -1
  115. package/dist/node/service/cluster/topology.js +1 -1
  116. package/dist/node/service/dev/BootReporter.js +1 -1
  117. package/dist/node/service/dev/DevSupervisor.js +53 -7
  118. package/dist/node/service/dev/DevTerminal.js +1 -1
  119. package/dist/node/service/dev/clipboard.js +1 -1
  120. package/dist/node/service/dev/detachedStart.js +5 -5
  121. package/dist/node/service/dev/devProcess.js +2 -2
  122. package/dist/node/service/dev/devProjects.js +2 -2
  123. package/dist/node/service/dev/devStatusReport.js +2 -2
  124. package/dist/node/service/dev/devStop.js +2 -2
  125. package/dist/node/service/dev/devTranscript.js +1 -1
  126. package/dist/node/service/dev/restartCycle.js +1 -1
  127. package/dist/node/service/dev/startupScreen.js +1 -1
  128. package/dist/node/syslog/Syslog.js +1 -1
  129. package/dist/node/syslog/drivers/ClusterFileLogDriver.js +2 -2
  130. package/dist/node/syslog/drivers/FileLogDriver.js +1 -1
  131. package/dist/node/syslog/drivers/builtinLogDrivers.js +1 -1
  132. package/dist/node/testing/index.js +5 -5
  133. package/dist/node/testing/stopChildTree.js +1 -1
  134. package/dist/types/cli/create.d.ts +64 -0
  135. package/dist/types/cli/installCommand.d.ts +41 -0
  136. package/dist/types/cli/installedPackages.d.ts +2 -2
  137. package/dist/types/cli/packageManager.d.ts +8 -0
  138. package/dist/types/cli/scaffold/contribute.d.ts +34 -0
  139. package/dist/types/cli/scaffold/engine.d.ts +49 -0
  140. package/dist/types/cli/upgrade.d.ts +10 -0
  141. package/dist/types/client/debugbar/DebugBar.d.ts +9 -3
  142. package/dist/types/client/index.d.ts +2 -2
  143. package/dist/types/client/realtime/NodefonySocket.d.ts +16 -3
  144. package/dist/types/client/realtime/observe.d.ts +2 -2
  145. package/dist/types/client/realtime/snapshot.d.ts +83 -1
  146. package/dist/types/index.d.ts +4 -1
  147. package/dist/types/kernel/commands/UpgradeCommand.d.ts +1 -1
  148. package/dist/types/kernel/periodicTask.d.ts +9 -3
  149. package/dist/types/kernel/runProfile.d.ts +16 -0
  150. package/dist/types/runtime/scanPage.d.ts +111 -0
  151. package/dist/types/service/dev/DevSupervisor.d.ts +31 -0
  152. package/dist/types/service/dev/restartCycle.d.ts +8 -0
  153. package/dist/types/types/ICommand.d.ts +6 -0
  154. package/docs/cli.md +6 -2
  155. package/docs/client.md +16 -4
  156. package/docs/debugbar.md +8 -4
  157. package/docs/react-hooks.md +19 -18
  158. package/docs/service.md +10 -0
  159. package/man/nodefony.1 +1 -1
  160. package/package.json +17 -8
  161. package/templates/app/agent-instructions/AGENTS.md.tpl +4 -6
  162. package/templates/app/base/Dockerfile.tpl +129 -15
  163. package/templates/app/base/README.md.tpl +31 -6
  164. package/templates/app/base/github/workflows/ci.yml.tpl +103 -1
  165. package/templates/app/base/gitlab-ci.yml.tpl +54 -1
  166. package/templates/app/complete/compose.yaml.tpl +11 -0
  167. package/templates/app/complete/github/workflows/production.yml.tpl +55 -2
  168. package/templates/controller/realtime-entity/nodefony/controllers/__NAME__.ts.tpl +82 -0
  169. package/templates/controller/realtime-entity/nodefony/service/__ENTITY__EventsRelay.ts.tpl +91 -0
  170. package/templates/controller/realtime-entity/tests/__KEBAB__-realtime.test.ts.tpl +87 -0
  171. package/templates/demo/front/frontend/src/App.tsx.tpl +3 -3
  172. package/templates/demo/front/frontend/src/kit/theme.ts.tpl +14 -7
  173. package/templates/demo/server/nodefony/entity/rooms.ts.tpl +10 -8
  174. package/templates/entity/controller/nodefony/controllers/__PASCAL__Controller.ts.tpl +9 -12
package/CHANGELOG.md CHANGED
@@ -8,6 +8,60 @@ 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 - 2026-11-18
12
+
13
+ _La première version stable de Nodefony 10 : le framework réécrit en TypeScript strict sur les serveurs natifs de Node (`node:http`, `node:http2`, WebSocket), où le WebSocket partage le pipeline, les routes et la sécurité du HTTP, et où chaque requête reçoit son propre conteneur de services. Seize paquets à la même version, sous le canal `latest` : `npm create nodefony mon-app` suffit, sans nommer de canal. Elle reprend la beta.9 sans rupture d'API mesurée ; les ruptures de la ligne 10 sont annoncées bêta par bêta ci-dessous, chacune avec son geste de migration. Une application de la série 7 (JavaScript, dépréciée) ne se monte pas : les deux API n'ont rien de commun._
14
+
15
+ ### Changed
16
+
17
+ - **cli:** Générer les applications avec rolldown `^1.3.3`, vitest `^5.1.1` et svelte `^5.58.0` (26477502d)
18
+ - **devkit:** Ne plus faire nommer le canal `beta` par le skill `nodefony-upgrade` livré aux applications : `npm install nodefony` suit `latest`, et une version précise s'écrit la même sur tous les paquets (f9dacd969)
19
+
20
+ ### Fixed
21
+
22
+ - **cli:** Calculer le canal dans l'aide de `nodefony upgrade`, qui affirmait en dur que `latest` servait la série 7 (#782) (840b49447)
23
+
24
+ <!-- Surface publique mesurée depuis 10.0.0-beta.9 (npm) : 0 retrait sur 2 935 déclarations ; 1 à relire, relue — `NODEFONY_CLIENT` de ./angular (extensions des import() du .d.ts brut, rétablies au pack). Détail : npm run release:api-diff -- --from 10.0.0-beta.9 --details -->
25
+
26
+ ## 10.0.0-beta.9 - 2026-11-18
27
+
28
+ _Une bêta de correctifs avant la stable : une faille de révocation de sessions sur Redis corrigée, une image d'application qui s'ouvre aux paquets système et se met à jour avec le framework, et une CI générée qui éprouve aussi l'arm64. Aucune rupture d'API mesurée._
29
+
30
+ ### Changed
31
+
32
+ - **session:** Rendre `true` depuis `ISessionStorage.destroy` seulement si une session de cet identifiant existait et a été retirée, `false` sinon (absente, déjà détruite, store injoignable) — les stores Redis, Mongo et Drizzle rendaient `true` à chaque appel, et une révocation sans effet était auditée comme faite ; un store maison doit suivre ce contrat (2b3b44dd9)
33
+
34
+ ### Added
35
+
36
+ - **cli:** Livrer le `Dockerfile` d'une application en copie suivie par le paquet `nodefony` : `nodefony upgrade` le remplace tant que l'application n'y a pas touché, et le garde en le signalant sinon (#780) (4be3579b7)
37
+ - **cli:** Ouvrir l'image générée aux paquets système par une seconde fin `with-packages` et choisir l'image Node ou d'exécution par `--build-arg` (`NODE_IMAGE`, `RUNTIME_IMAGE`), sans retoucher le `Dockerfile` (#779) (2741bab87)
38
+ - **cli:** Éprouver aussi l'image en arm64 dans la CI générée par `create app` (#787) (8ef04499d)
39
+ - **cli:** Générer avec `create controller --kind realtime --entity` un contrôleur qui diffuse en direct les écritures d'une entité (#785) (345674cc6)
40
+ - **nodefony:** Accepter une option `allWorkers` dans `runOnceAtStartup` pour lancer la tâche dans chaque worker de la grappe, et plus seulement dans le worker de tête (345674cc6)
41
+ - **nodefony:** Exposer la présence de chaque canal tenu dans `SocketSnapshot` (champ `presence`, lu sur `nodefony/client`, `react`, `vue`, `svelte` et `angular`), et l'afficher dans la carte Socket de la barre de debug (#783) (65596590f)
42
+ - **orm:** Déclarer des références logiques (`IEntity.logicalReferences`) — une colonne qui désigne une ligne d'une autre table sans clé étrangère, exprès (compte dans une autre base, porteur polymorphe) (94da28c60)
43
+ - **studio:** Dessiner les références logiques dans le schéma ORM, avec un mode dense, des boîtes par module, la boucle d'auto-référence et une carte du lien au survol (830c80408, 5b1bef944)
44
+
45
+ ### Fixed
46
+
47
+ - **redis:** Ne plus perdre de clés en reprenant une page au milieu d'un lot `SCAN` : « déconnecter partout » pouvait laisser vivre une session (faille présente depuis la 10.0.0-beta.3, sessions, jetons d'accès, passkeys et idempotence) (#789) (4c49c91a7)
48
+ - **redis:** Lister les sessions d'un compte par son index au lieu de lire tout le parc — 48 s → 3 ms pour un compte parmi 20 000 sessions, sur la création de compte, le changement de mot de passe, la désactivation et « déconnecter partout » (e51be8b6a)
49
+ - **http:** Répondre 400 à une requête malformée arrivée sur une socket keep-alive réutilisée, au lieu de détruire la socket sans réponse (c11032c54)
50
+ - **http:** Répondre 431, et non 414, à un en-tête trop long arrivé en plusieurs paquets (0dfc09d93)
51
+ - **http:** Garder tel quel un champ multipart nommé comme une propriété d'`Object.prototype` (857a5e711)
52
+ - **cli:** Donner aux deux fins de l'image générée le même contrat (`/nodejs/bin/node`, point d'entrée, sonde) et les rendre atteignables par compose et la CI sans retouche ; refuser en le nommant un paquet demandé sans la fin `with-packages` (#779) (badfc4951)
53
+ - **cli:** Ne plus construire la demande de fusion d'un fork sur un runner arm64 auto-hébergé, dans la CI générée (#787) (2705e8bbb)
54
+ - **cli:** Raccourcir la sortie de `create app` hors dialogue et mettre la consigne « lis AGENTS.md » en tête, là où un agent la lit (#785) (1d7db9c65)
55
+ - **cli:** Nommer `csrfHeaders` dans l'`AGENTS.md` généré, là où l'agent écrit ses tests (#785) (0c85a5e07)
56
+ - **scaffold:** Nommer le canal dans la commande d'installation affichée par l'écran de connexion et la démo — la forme nue servait `nodefony@7.0.2` (#784) (e4633df1b)
57
+ - **env:** Lire les variables déclarées par un module chargé par son chemin (`{ name: "./src/demo" }`) dans `nodefony env` et `env --example`, au lieu de les annoncer lues par personne (55da2d328)
58
+ - **security:** Ne plus alerter en CRITIC sur l'absence des clés `totp` et `webhooks` pendant `security:secrets --env`, qui démarre l'application justement pour les fabriquer (#786) (4ae03c93e)
59
+ - **frontend:** Ne plus pendre 60 s à l'arrêt du superviseur Vite quand son process est déjà sorti (e9cbf27db)
60
+ - **debugbar:** Nommer « Mesures », et non « Temps réel », le contrôle du flux de la barre de debug (#783) (98b7517a0)
61
+ - **demo:** Porter de vraies clés étrangères entre les tables de la démo (salles, invités, réactions, réponses) (5d156a95a)
62
+
63
+ <!-- Surface publique mesurée depuis 10.0.0-beta.8 (npm) : 0 retrait sur 2 913 déclarations ; 7 à relire, relues — `SocketSnapshot.presence` ×5 (champ d'un objet PRODUIT par le framework : ajout, pas rupture), `runOnceAtStartup` (option facultative ajoutée), `NODEFONY_CLIENT` (extensions des import() du .d.ts brut, rétablies au pack). Détail : npm run release:api-diff -- --from 10.0.0-beta.8 --details -->
64
+
11
65
  ## 10.0.0-beta.8 - 2026-11-16
12
66
 
13
67
  _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._
package/README.md CHANGED
@@ -30,15 +30,14 @@ _Une action de contrôleur. Deux transports. La même session, la même sécurit
30
30
 
31
31
  > **Ce paquet est le CŒUR du framework** — noyau, injection de dépendances, modules, journalisation,
32
32
  > interface en ligne de commande, client temps réel et codec CBOR. Il s'installe rarement seul : une
33
- > application le reçoit par `npm create nodefony@beta`, et les autres paquets (`@nodefony/http`,
33
+ > application le reçoit par `npm create nodefony`, et les autres paquets (`@nodefony/http`,
34
34
  > `@nodefony/framework`, `@nodefony/security`…) le déclarent en dépendance de pair.
35
35
 
36
36
  ```bash
37
- npm install nodefony@beta
37
+ npm install nodefony
38
38
  ```
39
39
 
40
- > Le dist-tag est OBLIGATOIRE tant que la série 10 est en préversion : `latest` sert encore la
41
- > `7.0.2`, écrite en JavaScript, dont l'API n'a aucun rapport avec ce qui suit.
40
+ > La série 7, écrite en JavaScript, n'a aucun rapport d'API avec ce qui suit.
42
41
 
43
42
  ---
44
43
 
@@ -74,7 +73,7 @@ documentés, pas encore générés — [Docker et cloud](https://nodefony.net/do
74
73
  <div align="center">
75
74
 
76
75
  ```bash
77
- npm create nodefony@beta mon-app
76
+ npm create nodefony mon-app
78
77
  ```
79
78
 
80
79
  </div>
@@ -141,10 +140,10 @@ applications réelles tournent encore dessus. Fin 2023, plutôt que de le migrer
141
140
  choix a été fait d'une **réécriture complète en TypeScript**, fichier par fichier, en gardant les
142
141
  concepts et en jetant tout le reste.
143
142
 
144
- Pourquoi une réécriture et pas une migration progressive ? Parce qu'un framework ne se contente pas
145
- d'exécuter du code : il **contraint** celui qu'on écrit contre lui. Une couche de types posée après
146
- coup sur du JavaScript décrit ce que le code fait ; elle ne garantit rien. Les partis pris de cette
147
- réécriture sont donc structurels, et chacun ferme une porte :
143
+ Pourquoi tout réécrire plutôt que migrer petit à petit ? Parce que ton code s'appuie sur le
144
+ framework : si ses types sont justes, le compilateur trouve tes erreurs avant l'exécution. Ajouter
145
+ des types à du vieux JavaScript ne les rend pas justes. Chaque choix de cette réécriture supprime
146
+ donc une source d'erreur :
148
147
 
149
148
  | Décision | Ce qu'elle rend impossible |
150
149
  | ---------------------------------------- | ------------------------------------------------------------- |
@@ -269,7 +268,7 @@ sur invitation, sonde industrielle, tableau de bord partagé, notification priv
269
268
 
270
269
  JSON reste le format par défaut. Dès que des octets circulent — image, son, mesures de capteur,
271
270
  état d'une partie —, le serveur accepte **CBOR**, un JSON binaire. Nodefony embarque son propre
272
- codec : isomorphe, sans dépendance, environ 5,5 Ko compressés, et téléchargé seulement par la page
271
+ codec : isomorphe, sans dépendance, environ 6 Ko compressés, et téléchargé seulement par la page
273
272
  qui l'importe. Il rend exactement ce que JSON rendrait, à une exception près : un `Uint8Array`
274
273
  voyage en octets et revient en `Uint8Array`. Un message ordinaire pèse 30 à 45 % de moins, et 64 Ko
275
274
  d'octets en occupent 65,6 au lieu des 87,4 du base64.
@@ -370,21 +369,15 @@ appeler.
370
369
 
371
370
  ## Démarrage
372
371
 
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
- stable : une rupture reste possible d'une bêta à la suivante — chacune est alors annoncée en tête
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
- nommant ce canal :
372
+ La version `10.0.0` est en ligne. Les ruptures n'arrivent qu'aux versions majeures, annoncées en
373
+ tête du [CHANGELOG](https://github.com/nodefony/nodefony-core/blob/main/CHANGELOG.md). Une application se crée en une commande :
377
374
 
378
375
  ```bash
379
- npm create nodefony@beta mon-app
376
+ npm create nodefony mon-app
380
377
  cd mon-app
381
378
  npm run dev
382
379
  ```
383
380
 
384
- Le canal se nomme tant que la 10 n'est pas stable : c'est lui qui garantit de recevoir la
385
- préversion, et non la `7.0.2` que `npm install nodefony` sert encore — la version JavaScript
386
- d'avant, sans rapport avec ce que cette page décrit.
387
-
388
381
  L'application répond sur `http://127.0.0.1:5151` — ou le premier port libre, annoncé au
389
382
  démarrage — et la console d'administration sur `/nodefony`.
390
383
 
@@ -701,11 +694,36 @@ Pour la même raison, un lanceur qui change la commande la passe en **arguments*
701
694
  Kubernetes (jamais `command:`, qui remplacerait le Node d'entrée de l'image), `command:` dans
702
695
  compose, qui ne touche que les arguments.
703
696
 
704
- **Pour en changer** — vers Alpine (`apk add` possible) ou `node:24-slim` (glibc, avec `bash`) —,
705
- le `Dockerfile` le dit en tête, en quatre gestes : l'étage de construction et l'étage d'exécution
706
- changent **ensemble** (les modules natifs sont compilés pour la libc de l'étage de construction, et
707
- le symptôme d'un mélange est au DÉMARRAGE, pas à l'installation), le `RUN mkdir` des dossiers de
708
- données revient, et la sonde appelle `node`.
697
+ **Pour en changer — sans retoucher le `Dockerfile`**, qui reste ainsi celui que le framework
698
+ sait mettre à jour. Les deux bases sont des arguments de construction : `NODE_IMAGE` (construction)
699
+ et `RUNTIME_IMAGE` (exécution). Un registre interne ou une autre ligne de Node passent par
700
+ `--build-arg` ; les deux bases bougent **ensemble**, sur la même libc (les modules natifs sont
701
+ compilés pour celle de l'étage de construction, et le symptôme d'un mélange est au DÉMARRAGE, pas
702
+ à l'installation).
703
+
704
+ Pour un **outil système** (ffmpeg, ImageMagick…), une seconde fin du même fichier part de
705
+ `NODE_IMAGE`, avec un gestionnaire de paquets — au prix de la surface d'attaque mesurée plus haut :
706
+
707
+ ```bash
708
+ docker build --target with-packages --build-arg PACKAGES="ffmpeg" -t mon-app .
709
+ docker build --target with-packages --build-arg NODE_IMAGE=node:24-alpine -t mon-app . # Alpine
710
+ ```
711
+
712
+ Même contrat que la fin par défaut — utilisateur 1000, `/readyz`, même `CMD`, et `node` au même
713
+ chemin `/nodejs/bin/node` : toutes les commandes de cette page servent les deux fins. Compose et la
714
+ CI générés y conduisent sans retouche, par des variables : `NF_IMAGE_TARGET=with-packages` et
715
+ `NF_IMAGE_PACKAGES`, plus `NF_IMAGE_NODE` / `NF_IMAGE_RUNTIME` pour changer de base (l'environnement
716
+ ou le `.env` pour compose, les variables du dépôt pour la CI — à poser AUX DEUX endroits, sinon la CI
717
+ éprouve une autre image que la tienne). Des paquets demandés sans `with-packages` arrêtent la
718
+ construction en le disant, au lieu d'être ignorés.
719
+
720
+ Un serveur ARM (AWS Graviton, Raspberry Pi 4/5 en 64 bits, nœuds Kubernetes ARM) ? Pose la
721
+ variable du dépôt `NF_IMAGE_PLATFORMS=linux/amd64,linux/arm64` : la CI construit et contrôle
722
+ aussi l'image arm64, et la chaîne de production la démarre et l'arrête — chacune sur un runner
723
+ ARM **natif** (`ubuntu-24.04-arm` sur GitHub, `saas-linux-small-arm64` sur GitLab.com ; un
724
+ runner auto-hébergé se désigne par `NF_IMAGE_ARM64_RUNNER` ou `NF_IMAGE_ARM64_RUNNER_TAG`).
725
+ C'est là que cassent les modules natifs, au démarrage et jamais à l'installation. Sans la
726
+ variable, rien ne change ; une valeur inconnue arrête la CI en la nommant.
709
727
 
710
728
  ##### Si tu PUBLIES cette image
711
729
 
@@ -739,12 +757,12 @@ dans `nodefony.config.ts`).
739
757
  | --- | --- |
740
758
  | [`nodefony`](https://nodefony.net/docs/modules/core/) | **Ce paquet** — noyau : 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 |
741
759
  | [`@nodefony/http`](https://nodefony.net/docs/modules/http/) | Serveurs HTTP, HTTPS, HTTP/2 et WebSocket natifs, flux SSE, sessions, contextes de requête, certificats TLS |
742
- | [`@nodefony/framework`](https://nodefony.net/docs/modules/framework/) | Routeur, contrôleurs, décorateurs, vues — le modèle de programmation |
760
+ | [`@nodefony/framework`](https://nodefony.net/docs/modules/framework/) | Routeur, contrôleurs, décorateurs, vues, services gRPC (gRPC, gRPC-Web et Connect sur la même route) — le modèle de programmation |
743
761
  | [`@nodefony/security`](https://nodefony.net/docs/modules/security/) · [`@nodefony/user`](https://nodefony.net/docs/modules/user/) | Pare-feu par zones, authentification, autorisation par rôles, CSRF, audit |
744
762
  | [`@nodefony/realtime`](https://nodefony.net/docs/modules/realtime/) | Socket à canaux, salons et leurs membres, admission par canal, binaire CBOR, contre-pression, diffusion entre plusieurs instances |
745
763
  | [`@nodefony/ai`](https://nodefony.net/docs/modules/ai/) | Porte MCP : les outils de l'application offerts aux agents d'IA, en HTTP avec flux SSE ou en stdio |
746
764
  | [`@nodefony/orm-core`](https://nodefony.net/docs/modules/orm-core/) | Un contrat de dépôt de données, plusieurs moteurs : [Drizzle](https://nodefony.net/docs/modules/drizzle/) (SQLite, PostgreSQL, MySQL), [Mongoose](https://nodefony.net/docs/modules/mongoose/), [Redis](https://nodefony.net/docs/modules/redis/) |
747
- | [`@nodefony/frontend`](https://nodefony.net/docs/modules/frontend/) | Construction et rechargement à chaud des frontends de chaque module |
765
+ | [`@nodefony/frontend`](https://nodefony.net/docs/modules/frontend/) | Vite intégré : construction et rechargement à chaud des frontends de chaque module, en **React, Vue, Angular ou Svelte** — page, connexion et temps réel livrés par `nodefony create front` |
748
766
  | [`@nodefony/studio`](https://nodefony.net/docs/modules/studio/) | Console d'administration |
749
767
 
750
768
  Par défaut, un processus Node égale une instance : le passage à l'échelle revient à l'orchestrateur,
@@ -2849,7 +2849,7 @@ function detectEnvironmentFromArgv(argv) {
2849
2849
  }
2850
2850
  }
2851
2851
  // package.json
2852
- var version = "10.0.0-beta.8";
2852
+ var version = "10.0.0";
2853
2853
  // src/bin/nodefony.ts
2854
2854
  /**
2855
2855
  * Résout le **mode runtime** (dev/prod) AVANT le kernel : `NODE_ENV` (ambiant)
@@ -1,9 +1,9 @@
1
+ import { DestroyRef, InjectionToken, NgZone, assertInInjectionContext, effect, inject, makeEnvironmentProviders, signal, untracked } from "@angular/core";
1
2
  import { EMPTY_PRESENCE } from "../../realtime/presenceView.js";
2
3
  import { adaptiveRebindKey, connectShared, observeChannel, observeChannelStats, observeIdentity, observeKernelIdentity, observeKernelState, observeNoticeLog, observeNotices, observePresence, observeSnapshot, observeState, observeSyslog, requireChannelHandler } from "../realtime/observe.js";
3
4
  import { initialSseSnapshot, observeSse } from "../sse/observe.js";
4
5
  import { NodefonyLogin, observeLogin } from "../auth/NodefonyLogin.js";
5
6
  import { isRateChannel, parseRate, rateChannel } from "../../realtime/channelRate.js";
6
- import { DestroyRef, InjectionToken, NgZone, assertInInjectionContext, effect, inject, makeEnvironmentProviders, signal, untracked } from "@angular/core";
7
7
  // src/client/angular/index.ts
8
8
  /**
9
9
  * `nodefony/angular` — liaisons **Angular** du client temps réel isomorphe.
@@ -1,7 +1,8 @@
1
1
  import { NodefonySocket } from "../realtime/NodefonySocket.js";
2
- import { codecBadges, describeCodec, describeSocket, socketSnapshot } from "../realtime/snapshot.js";
2
+ import { PRESENCE_NONE, codecBadges, describeCodec, describeLosses, describePresence, describePresenceVersion, describeSocket, describeState, shortenIds, socketSnapshot } from "../realtime/snapshot.js";
3
3
  import { KERNEL_PROBE_EVENT, exposedKernels, isDevBuild, isVerbose, pageSockets, serverEnvironment } from "../announce.js";
4
4
  import { RpcError } from "../../realtime/JsonRpcPeer.js";
5
+ import "../../realtime/RealtimeEventMap.js";
5
6
  import { frameLinks, frameMeaning } from "./frames.js";
6
7
  import { AUTH_ME_PATH } from "../../runtime/authRoutes.js";
7
8
  import { adoptStyles } from "../cspStyles.js";
@@ -152,7 +153,7 @@ const KERNEL_HELP = /* @__PURE__ */ new Map([
152
153
  ["terminée à", "terminate() : départ de la page, ou appel de l'application."],
153
154
  ["annonce", "Badge et détail replié dans la console du navigateur (option banner)."],
154
155
  ["services", "Services composés par le noyau — kernel.get(nom)."],
155
- ["socket", "État de la socket du noyau. Le bouton « Temps réel » de la barre règle le FLUX, pas la connexion."],
156
+ ["socket", "État de la socket du noyau. Le bouton « Mesures » de la barre règle le FLUX, pas la connexion."],
156
157
  ["s'ouvre", "Option connectOnBoot. false : socket authentifiée, elle attend setIdentity — jamais anonyme."],
157
158
  ["origine", "Option realtime : socket créée par le noyau, fournie par l'application, ou aucune."],
158
159
  ["sockets", "Les sockets temps réel ouvertes par la page — la barre compte la sienne."],
@@ -166,6 +167,20 @@ const KERNEL_HELP = /* @__PURE__ */ new Map([
166
167
  function helpLabel(label, help) {
167
168
  return help ? `<span class="k help" tabindex="0" data-tip="${escapeHtml(help)}">${escapeHtml(label)}</span>` : `<span class="k">${escapeHtml(label)}</span>`;
168
169
  }
170
+ /** `n` suivi du mot, au pluriel au-delà de 1 (0 et 1 au singulier, en français). */
171
+ function counted(n, word) {
172
+ return `${n} ${word}${n > 1 ? "s" : ""}`;
173
+ }
174
+ /**
175
+ * Lignes de `describeSocket` que la carte Socket montre AILLEURS : l'adresse,
176
+ * l'état et le format dans son en-tête, les canaux dans leur tableau.
177
+ */
178
+ const SOCKET_ROWS_SHOWN_ELSEWHERE = /* @__PURE__ */ new Set([
179
+ "adresse",
180
+ "état",
181
+ "format",
182
+ "canaux tenus"
183
+ ]);
169
184
  /** Une ligne clé/valeur échappée — la même mise en forme dans chaque onglet. */
170
185
  function kvHtml(label, value, help, cls = "", full = "") {
171
186
  const title = full ? ` title="${escapeHtml(full)}"` : "";
@@ -450,10 +465,22 @@ const STYLES = `
450
465
  .spacer { flex: 1 1 auto; min-width: 8px; }
451
466
  .card > .ttl.sk-head { font-size:12px; color:#e6e9ee; margin-bottom:11px; padding-bottom:8px; border-bottom:1px solid var(--line); }
452
467
  .fmts { display:inline-flex; gap:6px; }
468
+ .sk-head { gap:8px; } .sk-url { font-weight:700; text-transform:none; letter-spacing:0; min-width:0; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
469
+ .sk-state { text-transform:none; letter-spacing:0; font-weight:700; white-space:nowrap; }
470
+ .sk-ch { width:100%; table-layout:fixed; border-collapse:collapse; margin-top:8px; }
471
+ .sk-ch th { text-align:left; font-weight:400; color:var(--muted); padding:4px 6px 4px 0; border-bottom:1px solid var(--line); }
472
+ .sk-ch th:first-child { width:38%; } .sk-ch th:last-child { width:5.5em; text-align:right; padding-right:0; }
473
+ .sk-ch th .k { color:inherit; } .sk-ch th .muted { margin-left:4px; }
474
+ .sk-ch td { padding:3px 6px 3px 0; vertical-align:baseline; border-bottom:1px solid color-mix(in srgb, var(--line) 55%, transparent); }
475
+ .sk-ch td.c { font:11px/1.6 ui-monospace,SFMono-Regular,Menlo,monospace; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
476
+ .sk-ch td.p { font-weight:600; overflow-wrap:anywhere; } .sk-ch td.p.muted { font-weight:400; }
477
+ .sk-ch td.ver { color:var(--muted); text-align:right; white-space:nowrap; padding-right:0; font-size:.92em; }
478
+ .sk-ch tr:last-child td { border-bottom:0; }
453
479
  .fmt { display:inline-flex; align-items:center; padding:.15em .65em; border-radius:9px; border:1px solid; font-size:10.5px; font-weight:800; letter-spacing:.4px; text-transform:lowercase; }
454
480
  .fmt.bin { color:var(--blue2); border-color:rgba(58,160,255,.5); background:rgba(58,160,255,.12); }
455
481
  .fmt.txt { color:#c9ced6; border-color:var(--line); background:#22262e; }
456
482
  .fmt.codec { color:#c4b5fd; border-color:rgba(167,139,250,.5); background:rgba(167,139,250,.12); }
483
+ .fmt.pres { color:var(--ok); border-color:color-mix(in srgb, var(--ok) 50%, transparent); background:color-mix(in srgb, var(--ok) 12%, transparent); padding:0 .5em; font-size:9.5px; }
457
484
  .ok{color:var(--ok)} .warn{color:var(--warn)} .crit{color:var(--crit)} .info{color:var(--info)} .muted{color:var(--muted)} .blue{color:var(--blue2)}
458
485
  .spark.ok{stroke:var(--ok)} .spark.warn{stroke:var(--warn)} .spark.crit{stroke:var(--crit)} .spark.rt{stroke:var(--blue2)}
459
486
  .area.ok{fill:rgba(54,179,126,.12)} .area.warn{fill:rgba(255,171,0,.14)} .area.crit{fill:rgba(255,86,48,.16)} .area.rt{fill:rgba(58,160,255,.16)}
@@ -1687,7 +1714,7 @@ var DebugBar = class {
1687
1714
  <button type="button" class="brand" data-el="btnBrand" aria-controls="nf-db-panel" aria-expanded="${this.startOpen}" data-tip="Barre de débogage Nodefony (développement uniquement) — cliquer pour ouvrir ou fermer le panneau"><span class="logo">${NODEFONY_LOGO}</span><span class="name">nodefony</span></button>
1688
1715
  <span class="env-badge" data-el="envBadge" data-tip="Environnement dans lequel tourne l'application">env</span>
1689
1716
  <span class="branch" data-el="branch" data-tip="Branche git de la copie de travail" hidden><svg class="ico" viewBox="0 0 16 16" aria-hidden="true"><path d="M5 2.5v11M5 13.5a1.5 1.5 0 1 0 0-.01M11 5.5a1.5 1.5 0 1 0 0-.01M11 7c0 3.5-6 2.5-6 5"/></svg><span data-el="branchName"></span></span>
1690
- <button type="button" class="rt ui" data-el="btnLive" aria-pressed="false" data-tip="Temps réel"><span class="rt-dot" aria-hidden="true"></span><span class="rt-name">Temps réel</span><span class="rt-state" data-el="rtCtlState">arrêté</span></button>
1717
+ <button type="button" class="rt ui" data-el="btnLive" aria-pressed="false" data-tip="Mesures"><span class="rt-dot" aria-hidden="true"></span><span class="rt-name">Mesures</span><span class="rt-state" data-el="rtCtlState">arrêté</span></button>
1691
1718
  ${this.miniMetric("rt", "rt", "rtMini", "0/s", "realtime", "Messages temps réel reçus par seconde — cliquer pour ouvrir l'onglet Realtime")}
1692
1719
  ${this.miniMetric("cpu", "cpu", "cpuMini", "0%", "perf", "Charge processeur du serveur — cliquer pour ouvrir l'onglet Perf")}
1693
1720
  ${this.miniMetric("mem", "mem", "memMini", "0%", "perf", "Mémoire utilisée par le serveur — cliquer pour ouvrir l'onglet Perf")}
@@ -1761,9 +1788,13 @@ var DebugBar = class {
1761
1788
  <div class="ctabs" data-el="connTabs" role="group" aria-label="Socket affichée"></div>
1762
1789
  <div class="sgrid" data-el="wsView">
1763
1790
  <div class="card hero sk-id">
1764
- <div class="ttl sk-head">Socket<span class="spacer"></span><span class="fmts" data-el="rtFormat"></span></div>
1791
+ <div class="ttl sk-head">Socket <span class="sk-url" data-el="skUrl"></span><span class="sk-state" data-el="skState"></span><span class="spacer"></span><span class="fmts" data-el="rtFormat"></span></div>
1792
+ <div data-el="skRows"></div>
1765
1793
  <div class="kv">${helpLabel("aller-retour", "Mesuré par nodefony:kernel:ping à l'ouverture de l'onglet et au bouton, jamais en boucle : chaque mesure écrit deux trames dans le journal qu'on lit pour diagnostiquer.")}<span class="v"><span data-el="rtRtt">—</span> <button type="button" class="toolbtn" data-el="btnRtt" aria-label="Mesurer l'aller-retour">mesurer</button></span></div>
1766
- <div data-el="rtRows"></div>
1794
+ <table class="sk-ch" aria-label="Canaux tenus et leur présence">
1795
+ <thead><tr><th scope="col">${helpLabel("canal", "Abonnements comptés par référence : dix composants sur le même canal, un seul abonnement réseau.")}<span class="muted" data-el="skChN"></span></th><th scope="col">${helpLabel("présence", "Qui est là sur le canal (ADR-0025) : les comptes nommés, sinon leur nombre, puis les anonymes. « non suivie par la page » : le serveur en envoie, mais aucun écran ne la lit.")}</th><th scope="col">vue</th></tr></thead>
1796
+ <tbody data-el="skChannels"></tbody>
1797
+ </table>
1767
1798
  </div>
1768
1799
  <div class="card sk-st"><div class="ttl">Notifications par méthode</div><div data-el="rtStats"></div></div>
1769
1800
  <div class="card sk-inc"><div class="ttl">Incidents</div><div data-el="rtInc"></div></div>
@@ -1792,13 +1823,13 @@ var DebugBar = class {
1792
1823
  }
1793
1824
  /**
1794
1825
  * L'onglet Perf — une carte par mesure du process serveur (60 dernières
1795
- * secondes, « Temps réel » allumé), et ce que le navigateur sait du
1826
+ * secondes, « Mesures » allumé), et ce que le navigateur sait du
1796
1827
  * chargement de cette page.
1797
1828
  */
1798
1829
  perfPane() {
1799
1830
  return `<div class="pane pfp" data-pane="perf">
1800
- <div class="pfstate" data-el="pfOff">Les courbes avancent avec « Temps réel », éteint : les dernières valeurs restent affichées. <button type="button" class="toolbtn" data-el="btnPfLive">Allumer</button></div>
1801
- <p class="pfstate" data-el="pfOn" hidden><span class="dot ok" aria-hidden="true"></span>Temps réel en direct · 60 dernières secondes</p>
1831
+ <div class="pfstate" data-el="pfOff">Les courbes avancent avec « Mesures », éteint : les dernières valeurs restent affichées. <button type="button" class="toolbtn" data-el="btnPfLive">Allumer</button></div>
1832
+ <p class="pfstate" data-el="pfOn" hidden><span class="dot ok" aria-hidden="true"></span>Mesures en direct · 60 dernières secondes</p>
1802
1833
  <div class="pgrid" data-el="pGrid">
1803
1834
  <div class="card">${this.chart(helpLabel("CPU", "Temps CPU du process serveur, en % d'un cœur."), "cpuVal", "cpuPeak", "cpuLine", "cpuArea")}<div data-el="cpuRows"></div></div>
1804
1835
  <div class="card">${this.chart(helpLabel("Mémoire (heap)", "Tas JavaScript utilisé, en % de sa limite."), "heapVal", "heapPeak", "heapLine", "heapArea")}<div data-el="heapRows"></div></div>
@@ -2153,12 +2184,12 @@ var DebugBar = class {
2153
2184
  this.updateLiveBtn();
2154
2185
  this.scheduleRender();
2155
2186
  }
2156
- /** Met à jour l'aspect du bouton « Temps réel » selon l'état. */
2187
+ /** Met à jour l'aspect du bouton « Mesures » selon l'état. */
2157
2188
  updateLiveBtn() {
2158
2189
  this.renderRealtimeControl(this.model.view.state);
2159
2190
  }
2160
2191
  /**
2161
- * Le contrôle « Temps réel » — UN état lisible, tiré de deux faits : la
2192
+ * Le contrôle « Mesures » — UN état lisible, tiré de deux faits : la
2162
2193
  * connexion (partagée avec l'hôte) et l'abonnement de la barre (le direct).
2163
2194
  *
2164
2195
  * | direct | connexion | affiché |
@@ -2170,8 +2201,8 @@ var DebugBar = class {
2170
2201
  * | non | fermée | arrêté |
2171
2202
  */
2172
2203
  renderRealtimeControl(state) {
2173
- const btn = this.el["btnLive"];
2174
- if (!btn) return;
2204
+ const btn = this.el.btnLive;
2205
+ if (!(btn instanceof HTMLElement)) return;
2175
2206
  const connected = state === "connected";
2176
2207
  let mode;
2177
2208
  if (this.refused && !connected) mode = "refused";
@@ -2738,7 +2769,7 @@ var DebugBar = class {
2738
2769
  const methods = c.serverMethods;
2739
2770
  this.rtRttTone = "muted";
2740
2771
  if (c.state !== "connected") this.rtRtt = "socket non connectée";
2741
- else if (methods !== null && !methods.includes(PLATFORM_METHODS.ping)) this.rtRtt = "pas de mesure : ce serveur n'offre pas nodefony:kernel:ping";
2772
+ else if (methods !== null && !methods.includes(PLATFORM_METHODS.ping)) this.rtRtt = "non offert par ce serveur";
2742
2773
  else {
2743
2774
  this.rtRtt = "mesure…";
2744
2775
  this.scheduleRender();
@@ -2747,7 +2778,7 @@ var DebugBar = class {
2747
2778
  this.rtRtt = `${r.rtt} ms à ${fmtClock(Date.now())}`;
2748
2779
  this.rtRttTone = "";
2749
2780
  } catch (e) {
2750
- if (e instanceof RpcError && e.code === -32001) this.rtRtt = "pas de mesure : réservée à un autre rôle que le vôtre";
2781
+ if (e instanceof RpcError && e.code === -32001) this.rtRtt = "non permis pour ce rôle";
2751
2782
  else {
2752
2783
  this.rtRtt = `échec — ${e instanceof Error ? e.message : String(e)}`;
2753
2784
  this.rtRttTone = "warn";
@@ -2843,6 +2874,36 @@ var DebugBar = class {
2843
2874
  inc.unshift(notice);
2844
2875
  if (inc.length > 20) inc.pop();
2845
2876
  }
2877
+ /**
2878
+ * La carte d'identité de la socket montrée : en-tête (adresse, état, format),
2879
+ * lignes clé/valeur du cœur, puis le tableau des canaux tenus et de leur
2880
+ * présence — serrée pour la hauteur bornée du panneau.
2881
+ */
2882
+ renderSocketCard(snap) {
2883
+ const url = snap.url ?? "—";
2884
+ this.setHtml("skUrl", `<span title="${escapeHtml(url)}">${escapeHtml(socketPath(snap.url))}</span>`);
2885
+ const tone = snap.state === "connected" ? "ok" : snap.state === "connecting" || snap.state === "reconnecting" ? "warn" : "crit";
2886
+ this.setHtml("skState", `<span class="${tone}">● ${escapeHtml(describeState(snap))}</span>`);
2887
+ const id = snap.identity;
2888
+ this.setHtml("skRows", describeSocket(snap).filter((r) => !SOCKET_ROWS_SHOWN_ELSEWHERE.has(r.label)).map((r) => {
2889
+ if (r.label === "identité" && id?.authenticated === true) {
2890
+ const who = [id.userIdentifier || "authentifié", id.type].filter(Boolean).join(" · ");
2891
+ return id.roles.length === 0 ? kvHtml(r.label, who, r.hint) : kvHtml(r.label, `${who} · ${counted(id.roles.length, "rôle")}`, `Rôles : ${id.roles.join(", ")}. ${r.hint}`);
2892
+ }
2893
+ if (r.label === "trames perdues") return kvHtml(r.label, r.value, r.hint, describeLosses(snap).lost ? "warn" : "");
2894
+ return kvHtml(r.label, r.value, r.hint);
2895
+ }).join(""));
2896
+ this.text("skChN", `(${snap.channels.length})`);
2897
+ const reader = id?.authenticated === true && id.id ? {
2898
+ id: id.id,
2899
+ name: id.userIdentifier || id.id
2900
+ } : void 0;
2901
+ this.setHtml("skChannels", snap.channels.length === 0 ? `<tr><td class="c muted" colspan="3">aucun</td></tr>` : snap.channels.map((ch, i) => {
2902
+ const status = snap.presence[i] ?? PRESENCE_NONE;
2903
+ const quiet = status.kind !== "followed";
2904
+ return `<tr><td class="c" title="${escapeHtml(ch)}">${escapeHtml(shortenIds(ch))}</td><td class="p${quiet ? " muted" : ""}">${escapeHtml(describePresence(status, reader))}</td><td class="ver">${escapeHtml(describePresenceVersion(status))}</td></tr>`;
2905
+ }).join(""));
2906
+ }
2846
2907
  renderSocketPane() {
2847
2908
  const list = this.pageSockets();
2848
2909
  const c = this.shownSocket();
@@ -2866,9 +2927,11 @@ var DebugBar = class {
2866
2927
  }
2867
2928
  this.text("rtRtt", this.rtRtt);
2868
2929
  this.cls("rtRtt", this.rtRttTone);
2930
+ const btnRtt = this.el.btnRtt;
2931
+ if (btnRtt instanceof HTMLElement) btnRtt.hidden = c.serverMethods !== null && !c.serverMethods.includes(PLATFORM_METHODS.ping);
2869
2932
  const fmt = codecBadges(c.codec);
2870
2933
  this.setHtml("rtFormat", `<span class="fmt ${fmt.nature === "binaire" ? "bin" : "txt"}">${fmt.nature}</span><span class="fmt codec">${escapeHtml(fmt.codec)}</span>`);
2871
- this.setHtml("rtRows", describeSocket(socketSnapshot(c)).map((r) => kvHtml(r.label, r.value, r.hint)).join(""));
2934
+ this.renderSocketCard(socketSnapshot(c));
2872
2935
  const stats = c.getStats();
2873
2936
  this.setHtml("rtStats", stats.length === 0 ? `<div class="kv"><span class="k">aucune</span></div>` : stats.map((st) => kvHtml(st.method, `${st.msgCount} · ${st.rate}/s`)).join(""));
2874
2937
  const inc = this.sockIncidents?.get(c) ?? null;
@@ -2929,7 +2992,7 @@ var DebugBar = class {
2929
2992
  const k = frameKey(fr);
2930
2993
  const isOpen = open?.has(k) === true;
2931
2994
  const link = links.get(picked.at(n) ?? -1);
2932
- return `<details data-k="${escapeHtml(k)}"${isOpen ? " open" : ""}><summary><span class="${fr.dir}">${fr.dir === "in" ? "↓" : "↑"}</span> ${fmtClock(fr.ts)} <b>${escapeHtml(fr.kind)}</b>${fr.id === void 0 ? "" : ` #${fr.id}`}${fr.channel ? ` · ${escapeHtml(fr.channel)}` : ""} · ${fr.size === 0 ? "taille inconnue" : `${fr.size} ${fr.binary ? "octets" : "car."}`} · ${fr.binary ? "binaire" : "texte"}<span class="fmean">${escapeHtml(frameMeaning(fr))}</span>${link === void 0 ? "" : `<span class="flink">↳ ${escapeHtml(link)}</span>`}</summary><pre>${isOpen ? escapeHtml(payloadText(fr)) : ""}</pre></details>`;
2995
+ return `<details data-k="${escapeHtml(k)}"${isOpen ? " open" : ""}><summary><span class="${fr.dir}">${fr.dir === "in" ? "↓" : "↑"}</span> ${fmtClock(fr.ts)} <b>${escapeHtml(fr.kind)}</b>${fr.kind === "realtime:presence" ? ` <span class="fmt pres">présence</span>` : ""}${fr.id === void 0 ? "" : ` #${fr.id}`}${fr.channel ? ` · ${escapeHtml(fr.channel)}` : ""} · ${fr.size === 0 ? "taille inconnue" : `${fr.size} ${fr.binary ? "octets" : "car."}`} · ${fr.binary ? "binaire" : "texte"}<span class="fmean">${escapeHtml(frameMeaning(fr))}</span>${link === void 0 ? "" : `<span class="flink">↳ ${escapeHtml(link)}</span>`}</summary><pre>${isOpen ? escapeHtml(payloadText(fr)) : ""}</pre></details>`;
2933
2996
  }).join("")));
2934
2997
  }
2935
2998
  /**
@@ -3033,7 +3096,7 @@ var DebugBar = class {
3033
3096
  kvHtml("mémoire", formatBytes(live ? v.rss : num(p, "rss")), "Mémoire résidente du process (rss)."),
3034
3097
  kvHtml("heap", `${formatBytes(live ? v.heapUsed : num(p, "heapUsed"))} / ${formatBytes(live ? v.heapTotal : num(p, "heapTotal"))}`, `Tas JavaScript utilisé / réservé — limite ${formatBytes(live ? v.heapLimit : num(p, "heapLimit"))}.`),
3035
3098
  kvHtml("external", formatBytes(live ? v.external : num(p, "external")), "Mémoire hors tas tenue par des objets JavaScript (tampons)."),
3036
- `<div class="tag">${live ? "Suivie en continu (Temps réel)." : `Relevée à ${new Date(s.at).toLocaleTimeString("fr-FR")} — « Temps réel » la suit en continu.`}</div>`
3099
+ `<div class="tag">${live ? "Suivie en continu (Mesures en direct)." : `Relevée à ${new Date(s.at).toLocaleTimeString("fr-FR")} — « Mesures » la suit en continu.`}</div>`
3037
3100
  ].join(""));
3038
3101
  }
3039
3102
  renderRequestsPane(v) {
@@ -1,4 +1,6 @@
1
1
  import { fmtClock } from "./format.js";
2
+ import { ownField } from "../../runtime/ownField.js";
3
+ import "../../realtime/RealtimeEventMap.js";
2
4
  // src/client/debugbar/frames.ts
3
5
  /** Au-delà de ce délai, une poussée n'est plus rapprochée d'une émission. */
4
6
  const ECHO_WINDOW_MS = 2e3;
@@ -7,13 +9,9 @@ const SUBSCRIBE = "subscribe";
7
9
  const UNSUBSCRIBE = "unsubscribe";
8
10
  const PING = "ping";
9
11
  const API_REQUEST = "api.request";
10
- /** Un champ propre d'un objet inconnu, sans traverser le prototype. */
11
- function own(value, key) {
12
- return value !== null && typeof value === "object" && Object.prototype.hasOwnProperty.call(value, key) ? Reflect.get(value, key) : void 0;
13
- }
14
12
  /** Les `params` de la trame (la charge journalisée EST la trame JSON-RPC). */
15
13
  function paramsOf(fr) {
16
- return own(fr.payload, "params");
14
+ return ownField(fr.payload, "params");
17
15
  }
18
16
  /** Une valeur scalaire courte, pour un résumé d'une ligne. */
19
17
  function short(value) {
@@ -42,6 +40,25 @@ function summarizeParams(params) {
42
40
  const rest = keys.length - shown.length;
43
41
  return rest > 0 ? `${shown.join(", ")} +${rest}` : shown.join(", ");
44
42
  }
43
+ /** Longueur d'un champ tableau, `0` s'il est absent ou d'une autre forme. */
44
+ function lengthOf(value) {
45
+ return Array.isArray(value) ? value.length : 0;
46
+ }
47
+ /**
48
+ * Le sens d'une trame `realtime:presence` (ADR-0025) : liste complète ou
49
+ * changement numéroté, avec ses nombres — la trame se lit sans l'ouvrir.
50
+ *
51
+ * @param params - les `params` de la trame
52
+ * @returns la phrase
53
+ */
54
+ function presenceMeaning(params) {
55
+ const channel = short(ownField(params, "channel")) ?? "?";
56
+ const version = short(ownField(params, "version")) ?? "?";
57
+ const numbers = `${short(ownField(params, "count")) ?? "?"} compte(s), ${short(ownField(params, "unnamed")) ?? "?"} anonyme(s)`;
58
+ const changes = ownField(params, "changes");
59
+ if (changes !== void 0) return `présence de « ${channel} » : changement v${version} — ${numbers} (${lengthOf(ownField(changes, "set")) / 2} arrivée(s) ou mise(s) à jour, ${lengthOf(ownField(changes, "gone"))} départ(s))`;
60
+ return `présence de « ${channel} » : ${ownField(params, "members") === void 0 ? "nombres seuls" : "liste complète"} v${version} — ${numbers}`;
61
+ }
45
62
  /**
46
63
  * Le sens d'une trame, en une phrase.
47
64
  *
@@ -50,21 +67,22 @@ function summarizeParams(params) {
50
67
  */
51
68
  function frameMeaning(fr) {
52
69
  const params = paramsOf(fr);
53
- const channel = fr.channel ?? short(own(params, "channel")) ?? "?";
70
+ const channel = fr.channel ?? short(ownField(params, "channel")) ?? "?";
54
71
  if (fr.dir === "out") {
55
72
  if (fr.kind === SUBSCRIBE) return `la page s'abonne au canal « ${channel} »`;
56
73
  if (fr.kind === UNSUBSCRIBE) return `la page se désabonne du canal « ${channel} »`;
57
74
  if (fr.kind === PING && fr.id === void 0) return "battement de cœur — garde la connexion ouverte, sans réponse";
58
- if (fr.kind === API_REQUEST) return `la page appelle ${short(own(params, "method")) ?? "GET"} ${short(own(params, "path")) ?? "?"} par la socket — réponse attendue (#${fr.id ?? "?"})`;
75
+ if (fr.kind === API_REQUEST) return `la page appelle ${short(ownField(params, "method")) ?? "GET"} ${short(ownField(params, "path")) ?? "?"} par la socket — réponse attendue (#${fr.id ?? "?"})`;
59
76
  if (fr.id !== void 0) return `la page appelle l'action « ${fr.kind} » — réponse attendue (#${fr.id})`;
60
77
  return `la page émet sur « ${fr.kind} » — notification, sans réponse ; ${summarizeParams(params)}`;
61
78
  }
62
79
  if (fr.kind === "realtime:welcome") return "le serveur accueille la connexion : identité, canaux et actions offerts";
63
80
  if (fr.kind === "realtime:subscribed") return `le serveur confirme l'abonnement au canal « ${channel} »`;
64
81
  if (fr.kind === "realtime:denied") {
65
- const reason = short(own(params, "reason"));
82
+ const reason = short(ownField(params, "reason"));
66
83
  return `le serveur refuse « ${channel} »${reason === null ? "" : ` (${reason})`}`;
67
84
  }
85
+ if (fr.kind === "realtime:presence") return presenceMeaning(params);
68
86
  if (fr.kind === "response") return `le serveur répond à #${fr.id ?? "?"}`;
69
87
  if (fr.kind === "error") return `le serveur répond à #${fr.id ?? "?"} par une erreur`;
70
88
  if (fr.kind === "stream") return `le serveur envoie un morceau du flux #${fr.id ?? "?"}`;
@@ -19,7 +19,7 @@ import { isRateChannel, parseRate, rateChannel } from "../realtime/channelRate.j
19
19
  import { isRealtimePayload } from "../realtime/payload.js";
20
20
  import { AdaptiveRate, bindAdaptiveChannel } from "./realtime/AdaptiveRate.js";
21
21
  import { initialSseSnapshot, observeSse, sseRebindKey } from "./sse/observe.js";
22
- import { describeCodec, describeSocket, socketSnapshot } from "./realtime/snapshot.js";
22
+ import { describeCodec, describeLosses, describePresence, describePresenceVersion, describeSocket, describeState, shortenIds, socketSnapshot } from "./realtime/snapshot.js";
23
23
  import { JSON_RPC_VERSION, JsonRpcError, JsonRpcServerError, classifyJsonRpcFrame, isJsonRpcErrorObject, isJsonRpcId, jsonRpcFailure, jsonRpcNotification, jsonRpcRequest, jsonRpcSuccess } from "../jsonrpc/index.js";
24
24
  import { JSON_PROTOCOL } from "../realtime/IFrameCodec.js";
25
25
  import { BYTES_MARKER_HEADER, textCodecForMarker } from "../realtime/jsonFrameCodec.js";
@@ -54,4 +54,4 @@ import { SESSION_AMR_KEY, SESSION_AUTH_AT_KEY, readSessionAuthentication } from
54
54
  function generateId() {
55
55
  return randomUuid();
56
56
  }
57
- export { AUTH_API_BASE, AUTH_LOGIN_PATH, AUTH_LOGIN_TOTP_PATH, AUTH_LOGOUT_PATH, AUTH_ME_PATH, AdaptiveRate, BROWSER_ERROR_MSGID, BROWSER_ORIGIN, BROWSER_REJECTION_MSGID, BYTES_MARKER_HEADER, BrowserWsTransport, CSP_NONCE_META_PROPERTY, Container, DEFAULT_LOGIN_PAGE_SKIN, EMPTY_PRESENCE, INSECURE_TRANSPORT_MESSAGE, JSON_PROTOCOL, JSON_RPC_VERSION, JsonRpcError, JsonRpcPeer, JsonRpcServerError, LOCAL_EVENTS, LOGIN_PAGE_ASSETS_BASE, LOGIN_PAGE_LAYOUTS, LOGIN_PAGE_PATH, LOGIN_PAGE_SCRIPT_PATH, LOGIN_PAGE_SKINS, LOGIN_PAGE_SKIN_SPECS, LOGIN_PAGE_STYLE_PATH, LOGIN_PAGE_THEME_KEY, MFA_METHOD_TOTP, NODEFONY_CHANNEL_NAMESPACE, NodefonyKernel, NodefonyLogin, NodefonySocket, NodefonySse, OAUTH2_API_BASE, OAUTH2_CANCELLED_REASON, OAUTH2_FAILED_REASON, OAUTH2_PROVIDERS_PATH, PLATFORM_CHANNELS, PLATFORM_EVENTS, PLATFORM_INBOUND, PLATFORM_LITTLE_ENDIAN, PLATFORM_METHODS, PRESENCE_RESYNC_JITTER, PRESENCE_RESYNC_MS, Pdu, PresenceView, REALTIME_PRESENCE_METHOD, RpcError, SESSION_AMR_KEY, SESSION_AUTH_AT_KEY, SEVERITY_NAMES, SSE_MAX_EVENT_SIZE, SUPERVISION_HISTORY_COLUMNS, SUPERVISION_LOOP_BANDS, Service, SseLimitError, SseParser, Syslog, THROUGHPUT_PAYLOAD_SIZES, TransportState, UPLINK_MSGID, WEBAUTHN_API_BASE, WEBAUTHN_LOGIN_OPTIONS_PATH, WEBAUTHN_LOGIN_VERIFY_PATH, WEBAUTHN_STATUS_PATH, adaptiveRebindKey, adoptStyles, bindAdaptiveChannel, classifyJsonRpcFrame, classifyNumberedChange, closeCodeToNotice, connectShared, createIdempotencyKey, createThroughputPayload, describeCodec, describeSocket, extend, fillRoutePath, fromLittleEndianBytes, generateId, getCurrentRequestId, getPageId, initialSseSnapshot, installErrorCapture, installRequestIdProvider, installSyslogUplink, isArray, isContainer, isEmptyObject, isFunction, isJsonRpcErrorObject, isJsonRpcId, isLocalEvent, isLoginPageSkin, isPlainObject, isPlatformChannel, isPresenceFrame, isPromise, isRateChannel, isRealtimePayload, isRegExp, isSubclassOf, isThroughputPayloadSize, isUndefined, jsonRpcFailure, jsonRpcNotification, jsonRpcRequest, jsonRpcSuccess, loginPagePath, loginPageSkinFile, oauth2AuthorizePath, observeAdaptiveChannel, observeChannel, observeChannelData, observeChannelStats, observeIdentity, observeKernelIdentity, observeKernelState, observeLogin, observeNoticeLog, observeNotices, observePresence, observeReconnect, observeSnapshot, observeSse, observeState, observeSyslog, ownField, parseRate, rateChannel, readCspNonce, readSessionAuthentication, resetClientLogContext, routePathParams, runtimeMode, safeRedirectPath, socketSnapshot, sseRebindKey, textCodecForMarker, toLittleEndianBytes, typeOf, withRequestId };
57
+ export { AUTH_API_BASE, AUTH_LOGIN_PATH, AUTH_LOGIN_TOTP_PATH, AUTH_LOGOUT_PATH, AUTH_ME_PATH, AdaptiveRate, BROWSER_ERROR_MSGID, BROWSER_ORIGIN, BROWSER_REJECTION_MSGID, BYTES_MARKER_HEADER, BrowserWsTransport, CSP_NONCE_META_PROPERTY, Container, DEFAULT_LOGIN_PAGE_SKIN, EMPTY_PRESENCE, INSECURE_TRANSPORT_MESSAGE, JSON_PROTOCOL, JSON_RPC_VERSION, JsonRpcError, JsonRpcPeer, JsonRpcServerError, LOCAL_EVENTS, LOGIN_PAGE_ASSETS_BASE, LOGIN_PAGE_LAYOUTS, LOGIN_PAGE_PATH, LOGIN_PAGE_SCRIPT_PATH, LOGIN_PAGE_SKINS, LOGIN_PAGE_SKIN_SPECS, LOGIN_PAGE_STYLE_PATH, LOGIN_PAGE_THEME_KEY, MFA_METHOD_TOTP, NODEFONY_CHANNEL_NAMESPACE, NodefonyKernel, NodefonyLogin, NodefonySocket, NodefonySse, OAUTH2_API_BASE, OAUTH2_CANCELLED_REASON, OAUTH2_FAILED_REASON, OAUTH2_PROVIDERS_PATH, PLATFORM_CHANNELS, PLATFORM_EVENTS, PLATFORM_INBOUND, PLATFORM_LITTLE_ENDIAN, PLATFORM_METHODS, PRESENCE_RESYNC_JITTER, PRESENCE_RESYNC_MS, Pdu, PresenceView, REALTIME_PRESENCE_METHOD, RpcError, SESSION_AMR_KEY, SESSION_AUTH_AT_KEY, SEVERITY_NAMES, SSE_MAX_EVENT_SIZE, SUPERVISION_HISTORY_COLUMNS, SUPERVISION_LOOP_BANDS, Service, SseLimitError, SseParser, Syslog, THROUGHPUT_PAYLOAD_SIZES, TransportState, UPLINK_MSGID, WEBAUTHN_API_BASE, WEBAUTHN_LOGIN_OPTIONS_PATH, WEBAUTHN_LOGIN_VERIFY_PATH, WEBAUTHN_STATUS_PATH, adaptiveRebindKey, adoptStyles, bindAdaptiveChannel, classifyJsonRpcFrame, classifyNumberedChange, closeCodeToNotice, connectShared, createIdempotencyKey, createThroughputPayload, describeCodec, describeLosses, describePresence, describePresenceVersion, describeSocket, describeState, extend, fillRoutePath, fromLittleEndianBytes, generateId, getCurrentRequestId, getPageId, initialSseSnapshot, installErrorCapture, installRequestIdProvider, installSyslogUplink, isArray, isContainer, isEmptyObject, isFunction, isJsonRpcErrorObject, isJsonRpcId, isLocalEvent, isLoginPageSkin, isPlainObject, isPlatformChannel, isPresenceFrame, isPromise, isRateChannel, isRealtimePayload, isRegExp, isSubclassOf, isThroughputPayloadSize, isUndefined, jsonRpcFailure, jsonRpcNotification, jsonRpcRequest, jsonRpcSuccess, loginPagePath, loginPageSkinFile, oauth2AuthorizePath, observeAdaptiveChannel, observeChannel, observeChannelData, observeChannelStats, observeIdentity, observeKernelIdentity, observeKernelState, observeLogin, observeNoticeLog, observeNotices, observePresence, observeReconnect, observeSnapshot, observeSse, observeState, observeSyslog, ownField, parseRate, rateChannel, readCspNonce, readSessionAuthentication, resetClientLogContext, routePathParams, runtimeMode, safeRedirectPath, shortenIds, socketSnapshot, sseRebindKey, textCodecForMarker, toLittleEndianBytes, typeOf, withRequestId };
@@ -1,8 +1,8 @@
1
+ import * as React from "react";
1
2
  import { adaptiveRebindKey, connectShared, observeChannel, observeChannelStats, observeIdentity, observeKernelIdentity, observeKernelState, observeNoticeLog, observeNotices, observePresence, observeSnapshot, observeState, observeSyslog, requireChannelHandler } from "../realtime/observe.js";
2
3
  import { NodefonyLogin } from "../auth/NodefonyLogin.js";
3
4
  import { initialSseSnapshot, observeSse, sseRebindKey } from "../sse/observe.js";
4
5
  import { isRateChannel, parseRate, rateChannel } from "../../realtime/channelRate.js";
5
- import * as React from "react";
6
6
  // src/client/react/index.ts
7
7
  /**
8
8
  * `nodefony/react` — bindings React **fins** du client temps réel isomorphe.