nodefony 7.0.2 → 10.0.0-alpha.2

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 (903) hide show
  1. package/.ai/symbols.json +36135 -0
  2. package/LICENSE +544 -0
  3. package/README.md +316 -694
  4. package/bin/nodefony +2183 -85
  5. package/dist/client/Container.js +367 -0
  6. package/dist/client/Event.js +198 -0
  7. package/dist/client/Service.js +344 -0
  8. package/dist/client/Tools.js +162 -0
  9. package/dist/client/client/ClientKernel.js +276 -0
  10. package/dist/client/client/angular/index.js +352 -0
  11. package/dist/client/client/announce.js +212 -0
  12. package/dist/client/client/debugbar/DebugBar.js +1624 -0
  13. package/dist/client/client/debugbar/format.js +103 -0
  14. package/dist/client/client/debugbar/hmr.js +37 -0
  15. package/dist/client/client/debugbar/index.js +29 -0
  16. package/dist/client/client/debugbar/model.js +133 -0
  17. package/dist/client/client/debugbar/network.js +173 -0
  18. package/dist/client/client/debugbar/profile.js +114 -0
  19. package/dist/client/client/index.js +34 -0
  20. package/dist/client/client/react/index.js +268 -0
  21. package/dist/client/client/realtime/AdaptiveRate.js +240 -0
  22. package/dist/client/client/realtime/BrowserWsTransport.js +57 -0
  23. package/dist/client/client/realtime/RealtimeClient.js +898 -0
  24. package/dist/client/client/realtime/localEvents.js +56 -0
  25. package/dist/client/client/realtime/notice.js +125 -0
  26. package/dist/client/client/realtime/observe.js +280 -0
  27. package/dist/client/client/roles/index.js +3 -0
  28. package/dist/client/client/roles/registry.js +97 -0
  29. package/dist/client/client/roles/roles.js +91 -0
  30. package/dist/client/client/shim/events.js +88 -0
  31. package/dist/client/client/shim/util.js +20 -0
  32. package/dist/client/client/svelte/index.js +319 -0
  33. package/dist/client/client/syslog/context.js +122 -0
  34. package/dist/client/client/syslog/errors.js +49 -0
  35. package/dist/client/client/syslog/uplink.js +106 -0
  36. package/dist/client/client/vue/index.js +321 -0
  37. package/dist/client/colors.js +63 -0
  38. package/dist/client/debugbar.standalone.js +4274 -0
  39. package/dist/client/realtime/IRealtimeTransport.js +32 -0
  40. package/dist/client/realtime/JsonRpcPeer.js +251 -0
  41. package/dist/client/realtime/channelRate.js +39 -0
  42. package/dist/client/realtime/platformChannels.js +155 -0
  43. package/dist/client/syslog/Pdu.js +224 -0
  44. package/dist/client/syslog/Syslog.js +1159 -0
  45. package/dist/client/syslog/drivers/pduFlow.js +106 -0
  46. package/dist/client/syslog/drivers/pduProtocol.js +28 -0
  47. package/dist/client/syslog/logColor.js +80 -0
  48. package/dist/client/types/src/Container.d.ts +221 -0
  49. package/dist/client/types/src/Event.d.ts +171 -0
  50. package/dist/client/types/src/FileClass.d.ts +184 -0
  51. package/dist/client/types/src/Service.d.ts +165 -0
  52. package/dist/client/types/src/Tools.d.ts +116 -0
  53. package/dist/client/types/src/client/ClientKernel.d.ts +90 -0
  54. package/dist/client/types/src/client/IClientKernel.d.ts +195 -0
  55. package/dist/client/types/src/client/angular/index.d.ts +273 -0
  56. package/dist/client/types/src/client/announce.d.ts +74 -0
  57. package/dist/client/types/src/client/debugbar/DebugBar.d.ts +279 -0
  58. package/dist/client/types/src/client/debugbar/format.d.ts +48 -0
  59. package/dist/client/types/src/client/debugbar/hmr.d.ts +16 -0
  60. package/dist/client/types/src/client/debugbar/index.d.ts +30 -0
  61. package/dist/client/types/src/client/debugbar/model.d.ts +158 -0
  62. package/dist/client/types/src/client/debugbar/network.d.ts +55 -0
  63. package/dist/client/types/src/client/debugbar/profile.d.ts +99 -0
  64. package/dist/client/types/src/client/index.d.ts +47 -0
  65. package/dist/client/types/src/client/react/index.d.ts +207 -0
  66. package/dist/client/types/src/client/realtime/AdaptiveRate.d.ts +138 -0
  67. package/dist/client/types/src/client/realtime/BrowserWsTransport.d.ts +27 -0
  68. package/dist/client/types/src/client/realtime/RealtimeClient.d.ts +573 -0
  69. package/dist/client/types/src/client/realtime/localEvents.d.ts +53 -0
  70. package/dist/client/types/src/client/realtime/notice.d.ts +70 -0
  71. package/dist/client/types/src/client/realtime/observe.d.ts +284 -0
  72. package/dist/client/types/src/client/roles/index.d.ts +15 -0
  73. package/dist/client/types/src/client/roles/registry.d.ts +72 -0
  74. package/dist/client/types/src/client/roles/roles.d.ts +68 -0
  75. package/dist/client/types/src/client/shim/cli-color.d.ts +2 -0
  76. package/dist/client/types/src/client/shim/events.d.ts +39 -0
  77. package/dist/client/types/src/client/shim/util.d.ts +14 -0
  78. package/dist/client/types/src/client/svelte/index.d.ts +216 -0
  79. package/dist/client/types/src/client/syslog/context.d.ts +76 -0
  80. package/dist/client/types/src/client/syslog/errors.d.ts +46 -0
  81. package/dist/client/types/src/client/syslog/uplink.d.ts +89 -0
  82. package/dist/client/types/src/client/transport/websocket.d.ts +5 -0
  83. package/dist/client/types/src/client/vue/index.d.ts +234 -0
  84. package/dist/client/types/src/colors.d.ts +32 -0
  85. package/dist/client/types/src/config/infra.d.ts +171 -0
  86. package/dist/client/types/src/kernel/bootReport.d.ts +112 -0
  87. package/dist/client/types/src/kernel/readinessRegistry.d.ts +104 -0
  88. package/dist/client/types/src/realtime/IRealtimeSocket.d.ts +142 -0
  89. package/dist/client/types/src/realtime/IRealtimeTransport.d.ts +50 -0
  90. package/dist/client/types/src/realtime/JsonRpcPeer.d.ts +251 -0
  91. package/dist/client/types/src/realtime/RealtimeEventMap.d.ts +269 -0
  92. package/dist/client/types/src/realtime/channelRate.d.ts +55 -0
  93. package/dist/client/types/src/realtime/platformChannels.d.ts +147 -0
  94. package/dist/client/types/src/syslog/Pdu.d.ts +134 -0
  95. package/dist/client/types/src/syslog/Syslog.d.ts +482 -0
  96. package/dist/client/types/src/syslog/drivers/ILogDriver.d.ts +177 -0
  97. package/dist/client/types/src/syslog/drivers/pduFlow.d.ts +53 -0
  98. package/dist/client/types/src/syslog/drivers/pduProtocol.d.ts +20 -0
  99. package/dist/client/types/src/syslog/logColor.d.ts +59 -0
  100. package/dist/client/types/src/types/ICliKernel.d.ts +28 -0
  101. package/dist/client/types/src/types/ICommand.d.ts +14 -0
  102. package/dist/client/types/src/types/IContainer.d.ts +35 -0
  103. package/dist/client/types/src/types/IKernel.d.ts +138 -0
  104. package/dist/client/types/src/types/IMcpTool.d.ts +157 -0
  105. package/dist/client/types/src/types/IModule.d.ts +73 -0
  106. package/dist/client/types/src/types/IPage.d.ts +119 -0
  107. package/dist/client/types/src/types/IService.d.ts +62 -0
  108. package/dist/client/types/src/types/ISyslog.d.ts +58 -0
  109. package/dist/client/types/src/types/ITransport.d.ts +5 -0
  110. package/dist/client/types/src/types/globals.d.ts +47 -0
  111. package/dist/node/Cli.js +750 -0
  112. package/dist/node/Container.js +367 -0
  113. package/dist/node/Error.js +309 -0
  114. package/dist/node/Event.js +198 -0
  115. package/dist/node/FileClass.js +308 -0
  116. package/dist/node/Nodefony.js +78 -0
  117. package/dist/node/Service.js +344 -0
  118. package/dist/node/Tools.js +205 -0
  119. package/dist/node/bin/resolveLocalCli.js +10 -0
  120. package/dist/node/bundler/index.js +103 -0
  121. package/dist/node/cli/agentTargets.js +461 -0
  122. package/dist/node/cli/aiMcp.js +553 -0
  123. package/dist/node/cli/aiMcpReport.js +129 -0
  124. package/dist/node/cli/aiSync.js +323 -0
  125. package/dist/node/cli/aiSyncReport.js +142 -0
  126. package/dist/node/cli/card.js +186 -0
  127. package/dist/node/cli/cardReport.js +110 -0
  128. package/dist/node/cli/completion.js +415 -0
  129. package/dist/node/cli/create.js +805 -0
  130. package/dist/node/cli/env.js +332 -0
  131. package/dist/node/cli/envReport.js +159 -0
  132. package/dist/node/cli/execPortable.js +60 -0
  133. package/dist/node/cli/gitHooks.js +191 -0
  134. package/dist/node/cli/gitHooksReport.js +119 -0
  135. package/dist/node/cli/globalFlags.js +67 -0
  136. package/dist/node/cli/helpReport.js +288 -0
  137. package/dist/node/cli/manPage.js +165 -0
  138. package/dist/node/cli/nodefonyBin.js +61 -0
  139. package/dist/node/cli/outdated.js +144 -0
  140. package/dist/node/cli/progress.js +555 -0
  141. package/dist/node/cli/projectRoot.js +32 -0
  142. package/dist/node/cli/promptPassword.js +44 -0
  143. package/dist/node/cli/prompts.js +86 -0
  144. package/dist/node/cli/scaffold/destination.js +92 -0
  145. package/dist/node/cli/scaffold/engine.js +2156 -0
  146. package/dist/node/cli/scaffold/entityFields.js +589 -0
  147. package/dist/node/cli/scaffold/format.js +243 -0
  148. package/dist/node/cli/scaffold/interactive.js +124 -0
  149. package/dist/node/cli/scaffold/moduleLayout.js +38 -0
  150. package/dist/node/cli/scaffold/reservedEntities.js +74 -0
  151. package/dist/node/cli/scaffold/spec.js +704 -0
  152. package/dist/node/cli/scaffold/steps.js +40 -0
  153. package/dist/node/cli/scaffold/userContractSource.js +133 -0
  154. package/dist/node/cli/scaffold/versions.js +57 -0
  155. package/dist/node/cli/scaffold/writer.js +172 -0
  156. package/dist/node/cli/startMenu.js +496 -0
  157. package/dist/node/cli/symbols.js +205 -0
  158. package/dist/node/cli/sysexits.js +34 -0
  159. package/dist/node/cli/tableReport.js +184 -0
  160. package/dist/node/cli/usageReport.js +144 -0
  161. package/dist/node/colors.js +63 -0
  162. package/dist/node/command/Builder.js +153 -0
  163. package/dist/node/command/Command.js +348 -0
  164. package/dist/node/config/configProvenance.js +101 -0
  165. package/dist/node/config/defaults.js +39 -0
  166. package/dist/node/config/defineConfig.js +129 -0
  167. package/dist/node/config/defineEnv.js +264 -0
  168. package/dist/node/config/envExample.js +41 -0
  169. package/dist/node/config/envOverride.js +423 -0
  170. package/dist/node/config/infra.js +163 -0
  171. package/dist/node/config/reactivity.js +23 -0
  172. package/dist/node/config/reservedEnv.js +118 -0
  173. package/dist/node/config/schema.js +134 -0
  174. package/dist/node/config/use.js +24 -0
  175. package/dist/node/finder/File.js +49 -0
  176. package/dist/node/finder/FileResult.js +86 -0
  177. package/dist/node/finder/Finder.js +201 -0
  178. package/dist/node/finder/Result.js +45 -0
  179. package/dist/node/index.js +121 -0
  180. package/dist/node/kernel/BootConfigurationError.js +54 -0
  181. package/dist/node/kernel/CliKernel.js +630 -0
  182. package/dist/node/kernel/Kernel.js +2198 -0
  183. package/dist/node/kernel/Module.js +453 -0
  184. package/dist/node/kernel/adminPlane/adminCaller.js +98 -0
  185. package/dist/node/kernel/adminPlane/adminRbac.js +51 -0
  186. package/dist/node/kernel/adminPlane/catalog.js +158 -0
  187. package/dist/node/kernel/adminPlane/executeAdmin.js +78 -0
  188. package/dist/node/kernel/checks/deep.js +335 -0
  189. package/dist/node/kernel/checks/freshness.js +139 -0
  190. package/dist/node/kernel/checks/gating.js +231 -0
  191. package/dist/node/kernel/checks/guards.js +232 -0
  192. package/dist/node/kernel/checks/lastBoot.js +136 -0
  193. package/dist/node/kernel/checks/live.js +330 -0
  194. package/dist/node/kernel/checks/packageDeps.js +292 -0
  195. package/dist/node/kernel/checks/readiness.js +153 -0
  196. package/dist/node/kernel/checks/renderReport.js +780 -0
  197. package/dist/node/kernel/checks/report.js +421 -0
  198. package/dist/node/kernel/checks/runDoctor.js +731 -0
  199. package/dist/node/kernel/checks/surface.js +364 -0
  200. package/dist/node/kernel/checks/walk.js +100 -0
  201. package/dist/node/kernel/checks/wiring.js +450 -0
  202. package/dist/node/kernel/commands/AiMcpCommand.js +65 -0
  203. package/dist/node/kernel/commands/AiSyncCommand.js +48 -0
  204. package/dist/node/kernel/commands/BuildCommand.js +49 -0
  205. package/dist/node/kernel/commands/CardCommand.js +50 -0
  206. package/dist/node/kernel/commands/ClusterCommand.js +58 -0
  207. package/dist/node/kernel/commands/CompletionCommand.js +31 -0
  208. package/dist/node/kernel/commands/CreateCommand.js +45 -0
  209. package/dist/node/kernel/commands/DevCommand.js +99 -0
  210. package/dist/node/kernel/commands/DoctorCommand.js +115 -0
  211. package/dist/node/kernel/commands/EnvCommand.js +52 -0
  212. package/dist/node/kernel/commands/GitHooksCommand.js +47 -0
  213. package/dist/node/kernel/commands/InspectCommand.js +153 -0
  214. package/dist/node/kernel/commands/InstallCommand.js +20 -0
  215. package/dist/node/kernel/commands/MenuCommand.js +261 -0
  216. package/dist/node/kernel/commands/OutdatedCommand.js +164 -0
  217. package/dist/node/kernel/commands/ProdCommand.js +60 -0
  218. package/dist/node/kernel/commands/StatusCommand.js +30 -0
  219. package/dist/node/kernel/commands/StopCommand.js +35 -0
  220. package/dist/node/kernel/commands/SymbolsCommand.js +45 -0
  221. package/dist/node/kernel/commands/runtimeLauncher.js +95 -0
  222. package/dist/node/kernel/decorators/kernelDecorator.js +110 -0
  223. package/dist/node/kernel/injector/injector.js +137 -0
  224. package/dist/node/kernel/injector/serviceOrder.js +106 -0
  225. package/dist/node/kernel/inspect/adminSubjects.js +194 -0
  226. package/dist/node/kernel/inspect/docOutline.js +86 -0
  227. package/dist/node/kernel/lifecycleTags.js +76 -0
  228. package/dist/node/kernel/moduleConfig.js +75 -0
  229. package/dist/node/kernel/moduleGating.js +68 -0
  230. package/dist/node/kernel/readinessRegistry.js +98 -0
  231. package/dist/node/kernel/resolveModuleEntry.js +61 -0
  232. package/dist/node/mcp/caller.js +40 -0
  233. package/dist/node/mcp/guard.js +51 -0
  234. package/dist/node/mcp/protocol.js +157 -0
  235. package/dist/node/mcp/server.js +216 -0
  236. package/dist/node/mcp/tools.js +861 -0
  237. package/dist/node/oauth/authorizationServer.js +221 -0
  238. package/dist/node/oauth/protectedResource.js +293 -0
  239. package/dist/node/package.js +4 -0
  240. package/dist/node/realtime/IRealtimeTransport.js +32 -0
  241. package/dist/node/realtime/JsonRpcPeer.js +251 -0
  242. package/dist/node/realtime/RealtimeEventMap.js +15 -0
  243. package/dist/node/realtime/channelRate.js +39 -0
  244. package/dist/node/realtime/platformChannels.js +155 -0
  245. package/dist/node/runtime/GcScheduler.js +92 -0
  246. package/dist/node/runtime/RequestContext.js +76 -0
  247. package/dist/node/runtime/bearer.js +84 -0
  248. package/dist/node/runtime/engineEnvironment.js +79 -0
  249. package/dist/node/runtime/loadEnv.js +105 -0
  250. package/dist/node/runtime/pageFacets.js +85 -0
  251. package/dist/node/runtime/pageFilters.js +103 -0
  252. package/dist/node/runtime/pageGuard.js +84 -0
  253. package/dist/node/runtime/pageQuery.js +160 -0
  254. package/dist/node/runtime/pageSort.js +114 -0
  255. package/dist/node/runtime/redact.js +43 -0
  256. package/dist/node/runtime/withTimeout.js +71 -0
  257. package/dist/node/service/cluster/ClusterManager.js +202 -0
  258. package/dist/node/service/cluster/ClusterProbeAggregator.js +120 -0
  259. package/dist/node/service/cluster/ClusterRelay.js +74 -0
  260. package/dist/node/service/cluster/clusterMaster.js +65 -0
  261. package/dist/node/service/cluster/clusterMessage.js +70 -0
  262. package/dist/node/service/cluster/cpuQuota.js +59 -0
  263. package/dist/node/service/cluster/instanceProbe.js +52 -0
  264. package/dist/node/service/cluster/podEnvironment.js +48 -0
  265. package/dist/node/service/cluster/processProbe.js +70 -0
  266. package/dist/node/service/cluster/richProcessProbe.js +115 -0
  267. package/dist/node/service/cluster/topology.js +71 -0
  268. package/dist/node/service/dev/BootReporter.js +490 -0
  269. package/dist/node/service/dev/DevSupervisor.js +1004 -0
  270. package/dist/node/service/dev/bootVerdict.js +158 -0
  271. package/dist/node/service/dev/detachedStart.js +372 -0
  272. package/dist/node/service/dev/devProcess.js +1137 -0
  273. package/dist/node/service/dev/devProjects.js +138 -0
  274. package/dist/node/service/dev/devStatusReport.js +395 -0
  275. package/dist/node/service/dev/devStop.js +263 -0
  276. package/dist/node/service/fetchService.js +35 -0
  277. package/dist/node/service/gitService.js +62 -0
  278. package/dist/node/syslog/Pdu.js +224 -0
  279. package/dist/node/syslog/Syslog.js +1159 -0
  280. package/dist/node/syslog/drivers/ClusterFileLogDriver.js +114 -0
  281. package/dist/node/syslog/drivers/FileLogDriver.js +127 -0
  282. package/dist/node/syslog/drivers/ILogDriver.js +26 -0
  283. package/dist/node/syslog/drivers/LokiLogDriver.js +144 -0
  284. package/dist/node/syslog/drivers/MemoryLogDriver.js +33 -0
  285. package/dist/node/syslog/drivers/OpenSearchLogDriver.js +159 -0
  286. package/dist/node/syslog/drivers/builtinLogDrivers.js +114 -0
  287. package/dist/node/syslog/drivers/filterPdus.js +71 -0
  288. package/dist/node/syslog/drivers/logDriverRegistry.js +83 -0
  289. package/dist/node/syslog/drivers/opensearchShared.js +17 -0
  290. package/dist/node/syslog/drivers/pduFlow.js +106 -0
  291. package/dist/node/syslog/drivers/pduProtocol.js +28 -0
  292. package/dist/node/syslog/httpFetch.js +43 -0
  293. package/dist/node/syslog/logColor.js +80 -0
  294. package/dist/node/syslog/sinks/FileSink.js +142 -0
  295. package/dist/node/syslog/transports/BatchingHttpTransport.js +98 -0
  296. package/dist/node/syslog/transports/ConsoleTransport.js +14 -0
  297. package/dist/node/syslog/transports/FileTransport.js +17 -0
  298. package/dist/node/syslog/transports/HttpTransport.js +44 -0
  299. package/dist/node/syslog/transports/LokiTransport.js +80 -0
  300. package/dist/node/syslog/transports/OpenSearchTransport.js +53 -0
  301. package/dist/node/syslog/transports/SyslogTransport.js +13 -0
  302. package/dist/node/syslog/transports/index.js +8 -0
  303. package/dist/node/testing/index.js +190 -0
  304. package/dist/types/Cli.d.ts +177 -0
  305. package/dist/types/Container.d.ts +221 -0
  306. package/dist/types/Error.d.ts +162 -0
  307. package/dist/types/Event.d.ts +171 -0
  308. package/dist/types/FileClass.d.ts +184 -0
  309. package/dist/types/Nodefony.d.ts +66 -0
  310. package/dist/types/Service.d.ts +165 -0
  311. package/dist/types/Tools.d.ts +116 -0
  312. package/dist/types/bin/resolveLocalCli.d.ts +49 -0
  313. package/dist/types/bundler/index.d.ts +66 -0
  314. package/dist/types/cli/agentTargets.d.ts +378 -0
  315. package/dist/types/cli/aiMcp.d.ts +239 -0
  316. package/dist/types/cli/aiMcpReport.d.ts +113 -0
  317. package/dist/types/cli/aiSync.d.ts +68 -0
  318. package/dist/types/cli/aiSyncReport.d.ts +149 -0
  319. package/dist/types/cli/card.d.ts +49 -0
  320. package/dist/types/cli/cardReport.d.ts +127 -0
  321. package/dist/types/cli/completion.d.ts +154 -0
  322. package/dist/types/cli/create.d.ts +177 -0
  323. package/dist/types/cli/env.d.ts +103 -0
  324. package/dist/types/cli/envReport.d.ts +153 -0
  325. package/dist/types/cli/execPortable.d.ts +54 -0
  326. package/dist/types/cli/gitHooks.d.ts +48 -0
  327. package/dist/types/cli/gitHooksReport.d.ts +101 -0
  328. package/dist/types/cli/globalFlags.d.ts +48 -0
  329. package/dist/types/cli/helpReport.d.ts +110 -0
  330. package/dist/types/cli/manPage.d.ts +21 -0
  331. package/dist/types/cli/nodefonyBin.d.ts +45 -0
  332. package/dist/types/cli/outdated.d.ts +119 -0
  333. package/dist/types/cli/progress.d.ts +349 -0
  334. package/dist/types/cli/projectRoot.d.ts +19 -0
  335. package/dist/types/cli/promptPassword.d.ts +22 -0
  336. package/dist/types/cli/prompts.d.ts +102 -0
  337. package/dist/types/cli/scaffold/destination.d.ts +70 -0
  338. package/dist/types/cli/scaffold/engine.d.ts +545 -0
  339. package/dist/types/cli/scaffold/entityFields.d.ts +238 -0
  340. package/dist/types/cli/scaffold/format.d.ts +78 -0
  341. package/dist/types/cli/scaffold/interactive.d.ts +11 -0
  342. package/dist/types/cli/scaffold/moduleLayout.d.ts +69 -0
  343. package/dist/types/cli/scaffold/reservedEntities.d.ts +49 -0
  344. package/dist/types/cli/scaffold/spec.d.ts +159 -0
  345. package/dist/types/cli/scaffold/steps.d.ts +24 -0
  346. package/dist/types/cli/scaffold/userContractSource.d.ts +86 -0
  347. package/dist/types/cli/scaffold/versions.d.ts +14 -0
  348. package/dist/types/cli/scaffold/writer.d.ts +100 -0
  349. package/dist/types/cli/startMenu.d.ts +195 -0
  350. package/dist/types/cli/symbols.d.ts +84 -0
  351. package/dist/types/cli/sysexits.d.ts +31 -0
  352. package/dist/types/cli/tableReport.d.ts +44 -0
  353. package/dist/types/cli/usageReport.d.ts +108 -0
  354. package/dist/types/client/ClientKernel.d.ts +90 -0
  355. package/dist/types/client/IClientKernel.d.ts +195 -0
  356. package/dist/types/client/angular/index.d.ts +273 -0
  357. package/dist/types/client/announce.d.ts +74 -0
  358. package/dist/types/client/debugbar/DebugBar.d.ts +279 -0
  359. package/dist/types/client/debugbar/format.d.ts +48 -0
  360. package/dist/types/client/debugbar/hmr.d.ts +16 -0
  361. package/dist/types/client/debugbar/index.d.ts +30 -0
  362. package/dist/types/client/debugbar/model.d.ts +158 -0
  363. package/dist/types/client/debugbar/network.d.ts +55 -0
  364. package/dist/types/client/debugbar/profile.d.ts +99 -0
  365. package/dist/types/client/index.d.ts +47 -0
  366. package/dist/types/client/react/index.d.ts +207 -0
  367. package/dist/types/client/realtime/AdaptiveRate.d.ts +138 -0
  368. package/dist/types/client/realtime/BrowserWsTransport.d.ts +27 -0
  369. package/dist/types/client/realtime/RealtimeClient.d.ts +573 -0
  370. package/dist/types/client/realtime/localEvents.d.ts +53 -0
  371. package/dist/types/client/realtime/notice.d.ts +70 -0
  372. package/dist/types/client/realtime/observe.d.ts +284 -0
  373. package/dist/types/client/roles/index.d.ts +15 -0
  374. package/dist/types/client/roles/registry.d.ts +72 -0
  375. package/dist/types/client/roles/roles.d.ts +68 -0
  376. package/dist/types/client/shim/cli-color.d.ts +2 -0
  377. package/dist/types/client/shim/events.d.ts +39 -0
  378. package/dist/types/client/shim/util.d.ts +14 -0
  379. package/dist/types/client/svelte/index.d.ts +216 -0
  380. package/dist/types/client/syslog/context.d.ts +76 -0
  381. package/dist/types/client/syslog/errors.d.ts +46 -0
  382. package/dist/types/client/syslog/uplink.d.ts +89 -0
  383. package/dist/types/client/transport/websocket.d.ts +5 -0
  384. package/dist/types/client/vue/index.d.ts +234 -0
  385. package/dist/types/colors.d.ts +32 -0
  386. package/dist/types/command/Builder.d.ts +47 -0
  387. package/dist/types/command/Command.d.ts +268 -0
  388. package/dist/types/config/configMeta.d.ts +53 -0
  389. package/dist/types/config/configProvenance.d.ts +58 -0
  390. package/dist/types/config/defaults.d.ts +33 -0
  391. package/dist/types/config/defineConfig.d.ts +70 -0
  392. package/dist/types/config/defineEnv.d.ts +170 -0
  393. package/dist/types/config/envExample.d.ts +23 -0
  394. package/dist/types/config/envOverride.d.ts +236 -0
  395. package/dist/types/config/index.d.ts +23 -0
  396. package/dist/types/config/infra.d.ts +171 -0
  397. package/dist/types/config/reactivity.d.ts +36 -0
  398. package/dist/types/config/reservedEnv.d.ts +145 -0
  399. package/dist/types/config/schema.d.ts +113 -0
  400. package/dist/types/config/types.d.ts +374 -0
  401. package/dist/types/config/use.d.ts +80 -0
  402. package/dist/types/finder/File.d.ts +26 -0
  403. package/dist/types/finder/FileResult.d.ts +14 -0
  404. package/dist/types/finder/Finder.d.ts +51 -0
  405. package/dist/types/finder/Result.d.ts +10 -0
  406. package/dist/types/index.d.ts +205 -0
  407. package/dist/types/kernel/BootConfigurationError.d.ts +50 -0
  408. package/dist/types/kernel/CliKernel.d.ts +289 -0
  409. package/dist/types/kernel/Kernel.d.ts +1255 -0
  410. package/dist/types/kernel/Module.d.ts +326 -0
  411. package/dist/types/kernel/adminPlane/adminCaller.d.ts +105 -0
  412. package/dist/types/kernel/adminPlane/adminRbac.d.ts +44 -0
  413. package/dist/types/kernel/adminPlane/catalog.d.ts +122 -0
  414. package/dist/types/kernel/adminPlane/executeAdmin.d.ts +99 -0
  415. package/dist/types/kernel/bootReport.d.ts +112 -0
  416. package/dist/types/kernel/checks/deep.d.ts +122 -0
  417. package/dist/types/kernel/checks/freshness.d.ts +49 -0
  418. package/dist/types/kernel/checks/gating.d.ts +134 -0
  419. package/dist/types/kernel/checks/guards.d.ts +57 -0
  420. package/dist/types/kernel/checks/lastBoot.d.ts +189 -0
  421. package/dist/types/kernel/checks/live.d.ts +110 -0
  422. package/dist/types/kernel/checks/packageDeps.d.ts +44 -0
  423. package/dist/types/kernel/checks/readiness.d.ts +97 -0
  424. package/dist/types/kernel/checks/renderReport.d.ts +107 -0
  425. package/dist/types/kernel/checks/report.d.ts +414 -0
  426. package/dist/types/kernel/checks/runDoctor.d.ts +361 -0
  427. package/dist/types/kernel/checks/surface.d.ts +148 -0
  428. package/dist/types/kernel/checks/walk.d.ts +45 -0
  429. package/dist/types/kernel/checks/wiring.d.ts +54 -0
  430. package/dist/types/kernel/commands/AiMcpCommand.d.ts +39 -0
  431. package/dist/types/kernel/commands/AiSyncCommand.d.ts +28 -0
  432. package/dist/types/kernel/commands/BuildCommand.d.ts +13 -0
  433. package/dist/types/kernel/commands/CardCommand.d.ts +34 -0
  434. package/dist/types/kernel/commands/ClusterCommand.d.ts +29 -0
  435. package/dist/types/kernel/commands/CompletionCommand.d.ts +17 -0
  436. package/dist/types/kernel/commands/CreateCommand.d.ts +16 -0
  437. package/dist/types/kernel/commands/DevCommand.d.ts +40 -0
  438. package/dist/types/kernel/commands/DoctorCommand.d.ts +55 -0
  439. package/dist/types/kernel/commands/EnvCommand.d.ts +35 -0
  440. package/dist/types/kernel/commands/GitHooksCommand.d.ts +27 -0
  441. package/dist/types/kernel/commands/InspectCommand.d.ts +59 -0
  442. package/dist/types/kernel/commands/InstallCommand.d.ts +7 -0
  443. package/dist/types/kernel/commands/MenuCommand.d.ts +58 -0
  444. package/dist/types/kernel/commands/OutdatedCommand.d.ts +47 -0
  445. package/dist/types/kernel/commands/ProdCommand.d.ts +29 -0
  446. package/dist/types/kernel/commands/StatusCommand.d.ts +17 -0
  447. package/dist/types/kernel/commands/StopCommand.d.ts +17 -0
  448. package/dist/types/kernel/commands/SymbolsCommand.d.ts +29 -0
  449. package/dist/types/kernel/commands/runtimeLauncher.d.ts +76 -0
  450. package/dist/types/kernel/decorators/kernelDecorator.d.ts +76 -0
  451. package/dist/types/kernel/injector/injector.d.ts +47 -0
  452. package/dist/types/kernel/injector/serviceOrder.d.ts +29 -0
  453. package/dist/types/kernel/inspect/adminSubjects.d.ts +169 -0
  454. package/dist/types/kernel/inspect/docOutline.d.ts +53 -0
  455. package/dist/types/kernel/lifecycleTags.d.ts +79 -0
  456. package/dist/types/kernel/moduleConfig.d.ts +35 -0
  457. package/dist/types/kernel/moduleGating.d.ts +78 -0
  458. package/dist/types/kernel/readinessRegistry.d.ts +104 -0
  459. package/dist/types/kernel/resolveModuleEntry.d.ts +46 -0
  460. package/dist/types/mcp/caller.d.ts +55 -0
  461. package/dist/types/mcp/guard.d.ts +66 -0
  462. package/dist/types/mcp/protocol.d.ts +163 -0
  463. package/dist/types/mcp/server.d.ts +70 -0
  464. package/dist/types/mcp/tools.d.ts +209 -0
  465. package/dist/types/oauth/authorizationServer.d.ts +204 -0
  466. package/dist/types/oauth/protectedResource.d.ts +339 -0
  467. package/dist/types/realtime/IRealtimeSocket.d.ts +142 -0
  468. package/dist/types/realtime/IRealtimeTransport.d.ts +50 -0
  469. package/dist/types/realtime/JsonRpcPeer.d.ts +251 -0
  470. package/dist/types/realtime/RealtimeEventMap.d.ts +269 -0
  471. package/dist/types/realtime/channelRate.d.ts +55 -0
  472. package/dist/types/realtime/platformChannels.d.ts +147 -0
  473. package/dist/types/runtime/GcScheduler.d.ts +96 -0
  474. package/dist/types/runtime/RequestContext.d.ts +152 -0
  475. package/dist/types/runtime/bearer.d.ts +88 -0
  476. package/dist/types/runtime/engineEnvironment.d.ts +115 -0
  477. package/dist/types/runtime/loadEnv.d.ts +86 -0
  478. package/dist/types/runtime/pageFacets.d.ts +104 -0
  479. package/dist/types/runtime/pageFilters.d.ts +139 -0
  480. package/dist/types/runtime/pageGuard.d.ts +78 -0
  481. package/dist/types/runtime/pageQuery.d.ts +138 -0
  482. package/dist/types/runtime/pageSort.d.ts +86 -0
  483. package/dist/types/runtime/redact.d.ts +27 -0
  484. package/dist/types/runtime/withTimeout.d.ts +51 -0
  485. package/dist/types/service/cluster/ClusterManager.d.ts +112 -0
  486. package/dist/types/service/cluster/ClusterProbeAggregator.d.ts +68 -0
  487. package/dist/types/service/cluster/ClusterRelay.d.ts +57 -0
  488. package/dist/types/service/cluster/clusterMaster.d.ts +40 -0
  489. package/dist/types/service/cluster/clusterMessage.d.ts +94 -0
  490. package/dist/types/service/cluster/cpuQuota.d.ts +37 -0
  491. package/dist/types/service/cluster/instanceProbe.d.ts +82 -0
  492. package/dist/types/service/cluster/podEnvironment.d.ts +35 -0
  493. package/dist/types/service/cluster/processProbe.d.ts +53 -0
  494. package/dist/types/service/cluster/richProcessProbe.d.ts +77 -0
  495. package/dist/types/service/cluster/topology.d.ts +64 -0
  496. package/dist/types/service/dev/BootReporter.d.ts +67 -0
  497. package/dist/types/service/dev/DevSupervisor.d.ts +117 -0
  498. package/dist/types/service/dev/bootVerdict.d.ts +99 -0
  499. package/dist/types/service/dev/detachedStart.d.ts +164 -0
  500. package/dist/types/service/dev/devProcess.d.ts +638 -0
  501. package/dist/types/service/dev/devProjects.d.ts +121 -0
  502. package/dist/types/service/dev/devStatusReport.d.ts +141 -0
  503. package/dist/types/service/dev/devStop.d.ts +57 -0
  504. package/dist/types/service/fetchService.d.ts +29 -0
  505. package/dist/types/service/gitService.d.ts +24 -0
  506. package/dist/types/syslog/Pdu.d.ts +134 -0
  507. package/dist/types/syslog/Syslog.d.ts +482 -0
  508. package/dist/types/syslog/drivers/ClusterFileLogDriver.d.ts +40 -0
  509. package/dist/types/syslog/drivers/FileLogDriver.d.ts +55 -0
  510. package/dist/types/syslog/drivers/ILogDriver.d.ts +177 -0
  511. package/dist/types/syslog/drivers/LokiLogDriver.d.ts +44 -0
  512. package/dist/types/syslog/drivers/MemoryLogDriver.d.ts +20 -0
  513. package/dist/types/syslog/drivers/OpenSearchLogDriver.d.ts +40 -0
  514. package/dist/types/syslog/drivers/builtinLogDrivers.d.ts +43 -0
  515. package/dist/types/syslog/drivers/filterPdus.d.ts +21 -0
  516. package/dist/types/syslog/drivers/logDriverRegistry.d.ts +100 -0
  517. package/dist/types/syslog/drivers/opensearchShared.d.ts +11 -0
  518. package/dist/types/syslog/drivers/pduFlow.d.ts +53 -0
  519. package/dist/types/syslog/drivers/pduProtocol.d.ts +20 -0
  520. package/dist/types/syslog/httpFetch.d.ts +48 -0
  521. package/dist/types/syslog/logColor.d.ts +59 -0
  522. package/dist/types/syslog/sinks/FileSink.d.ts +78 -0
  523. package/dist/types/syslog/transports/BatchingHttpTransport.d.ts +59 -0
  524. package/dist/types/syslog/transports/ConsoleTransport.d.ts +8 -0
  525. package/dist/types/syslog/transports/FileTransport.d.ts +13 -0
  526. package/dist/types/syslog/transports/HttpTransport.d.ts +15 -0
  527. package/dist/types/syslog/transports/LokiTransport.d.ts +45 -0
  528. package/dist/types/syslog/transports/OpenSearchTransport.d.ts +40 -0
  529. package/dist/types/syslog/transports/SyslogTransport.d.ts +9 -0
  530. package/dist/types/syslog/transports/index.d.ts +12 -0
  531. package/dist/types/testing/index.d.ts +197 -0
  532. package/dist/types/types/IAdminApi.d.ts +246 -0
  533. package/dist/types/types/ICliKernel.d.ts +28 -0
  534. package/dist/types/types/ICommand.d.ts +14 -0
  535. package/dist/types/types/IContainer.d.ts +35 -0
  536. package/dist/types/types/IIdempotencyStore.d.ts +159 -0
  537. package/dist/types/types/IKernel.d.ts +138 -0
  538. package/dist/types/types/IMcpTool.d.ts +157 -0
  539. package/dist/types/types/IModule.d.ts +73 -0
  540. package/dist/types/types/IModuleManifest.d.ts +49 -0
  541. package/dist/types/types/IPage.d.ts +119 -0
  542. package/dist/types/types/IService.d.ts +62 -0
  543. package/dist/types/types/ISyslog.d.ts +58 -0
  544. package/dist/types/types/ITransport.d.ts +5 -0
  545. package/dist/types/types/globals.d.ts +47 -0
  546. package/docs/angular-services.md +318 -0
  547. package/docs/catalogue.md +184 -0
  548. package/docs/cli.md +369 -0
  549. package/docs/client.md +616 -0
  550. package/docs/debugbar.md +218 -0
  551. package/docs/environnement.md +308 -0
  552. package/docs/index.md +388 -0
  553. package/docs/kernel.md +670 -0
  554. package/docs/progression.md +228 -0
  555. package/docs/react-hooks.md +686 -0
  556. package/docs/request-context.md +507 -0
  557. package/docs/service.md +590 -0
  558. package/docs/svelte-reactivite.md +293 -0
  559. package/docs/syslog.md +848 -0
  560. package/docs/testing.md +203 -0
  561. package/docs/vue-composables.md +255 -0
  562. package/man/nodefony.1 +152 -0
  563. package/package.json +163 -83
  564. package/templates/app/agents/AGENTS.md.tpl +967 -0
  565. package/templates/app/agents/POINTEUR.md.tpl +12 -0
  566. package/templates/app/base/Dockerfile.tpl +104 -0
  567. package/templates/app/base/README.md.tpl +314 -0
  568. package/templates/app/base/dockerignore.tpl +28 -0
  569. package/templates/app/base/env.ts.tpl +130 -0
  570. package/templates/app/base/gitattributes.tpl +28 -0
  571. package/templates/app/base/github/workflows/ci.yml.tpl +91 -0
  572. package/templates/app/base/gitignore.tpl +46 -0
  573. package/templates/app/base/gitlab-ci.yml.tpl +42 -0
  574. package/templates/app/base/index.ts.tpl +69 -0
  575. package/templates/app/base/nodefony.config.ts.tpl +342 -0
  576. package/templates/app/base/oxlintrc.json.tpl +127 -0
  577. package/templates/app/base/package.json.tpl +75 -0
  578. package/templates/app/base/prettierignore.tpl +24 -0
  579. package/templates/app/base/prettierrc.json.tpl +12 -0
  580. package/templates/app/base/rolldown.config.ts.tpl +8 -0
  581. package/templates/app/base/tests/config.test.ts.tpl +29 -0
  582. package/templates/app/base/tests/e2e.setup.ts.tpl +181 -0
  583. package/templates/app/base/tests/e2e.test.ts.tpl +105 -0
  584. package/templates/app/base/tests/migrations.e2e.test.ts.tpl +579 -0
  585. package/templates/app/base/tsconfig.json.tpl +47 -0
  586. package/templates/app/base/vitest.config.ts.tpl +88 -0
  587. package/templates/app/base/vitest.e2e.config.ts.tpl +39 -0
  588. package/templates/app/complete/compose.yaml.tpl +328 -0
  589. package/templates/app/complete/deploy/migrate-job.yaml.tpl +100 -0
  590. package/templates/app/complete/docker/db/init-nodefony-e2e.sql.tpl +30 -0
  591. package/templates/app/complete/docker/grafana/provisioning/datasources/loki.yaml.tpl +15 -0
  592. package/templates/app/complete/env.local.tpl +11 -0
  593. package/templates/app/complete/env.tpl +53 -0
  594. package/templates/app/complete/nodefony/entity/User.ts.tpl +69 -0
  595. package/templates/app/complete/nodefony/security/provisionUsers.ts.tpl +124 -0
  596. package/templates/app/complete/nodefony/service/AppBannerService.ts.tpl +98 -0
  597. package/templates/app/complete/nodefony/service/AppInfoService.ts.tpl +85 -0
  598. package/templates/app/frontend/angular/frontend/src/accent.css.tpl +34 -0
  599. package/templates/app/frontend/angular/frontend/src/app/app.component.ts.tpl +400 -0
  600. package/templates/app/frontend/react/frontend/src/App.tsx.tpl +421 -0
  601. package/templates/app/frontend/react/frontend/src/accent.css.tpl +30 -0
  602. package/templates/app/frontend/shared/frontend/src/brand.ts.tpl +3 -0
  603. package/templates/app/frontend/shared/frontend/src/showcase.css.tpl +224 -0
  604. package/templates/app/frontend/shared/nodefony/controllers/AppController.ts.tpl +45 -0
  605. package/templates/app/frontend/svelte/frontend/src/App.svelte.tpl +371 -0
  606. package/templates/app/frontend/svelte/frontend/src/accent.css.tpl +34 -0
  607. package/templates/app/frontend/vue/frontend/src/App.vue.tpl +367 -0
  608. package/templates/app/frontend/vue/frontend/src/accent.css.tpl +34 -0
  609. package/templates/app/home/nodefony/controllers/HomeController.ts.tpl +38 -0
  610. package/templates/command/nodefony/command/__NAME__.ts.tpl +132 -0
  611. package/templates/controller/duplex/nodefony/controllers/__NAME__.ts.tpl +188 -0
  612. package/templates/controller/example/nodefony/controllers/__NAME__.ts.tpl +348 -0
  613. package/templates/controller/hello/nodefony/controllers/__NAME__.ts.tpl +143 -0
  614. package/templates/controller/realtime/nodefony/controllers/__NAME__.ts.tpl +153 -0
  615. package/templates/controller/realtime/tests/__KEBAB__-realtime.test.ts.tpl +79 -0
  616. package/templates/controller/rest/nodefony/controllers/__NAME__.ts.tpl +159 -0
  617. package/templates/entity/base/nodefony/entity/__PASCAL__.schema.ts.tpl +31 -0
  618. package/templates/entity/base/nodefony/entity/__PASCAL__.ts.tpl +68 -0
  619. package/templates/entity/controller/nodefony/controllers/__PASCAL__Controller.ts.tpl +335 -0
  620. package/templates/entity/service/nodefony/service/__PASCAL__Service.ts.tpl +126 -0
  621. package/templates/entity/tests/tests/__KEBAB__.e2e.test.ts.tpl +358 -0
  622. package/templates/entity/tests/tests/__KEBAB__.test.ts.tpl +87 -0
  623. package/templates/front/angular/frontend/src/app/app.component.ts.tpl +30 -0
  624. package/templates/front/base/nodefony/controllers/__NAME__.ts.tpl +60 -0
  625. package/templates/front/react/frontend/src/App.tsx.tpl +26 -0
  626. package/templates/front/svelte/frontend/src/App.svelte.tpl +19 -0
  627. package/templates/front/vue/frontend/src/App.vue.tpl +23 -0
  628. package/templates/module/ai/AGENTS.md.tpl +71 -0
  629. package/templates/module/base/README.md.tpl +62 -0
  630. package/templates/module/base/docs/index.md.tpl +55 -0
  631. package/templates/module/base/index.ts.tpl +50 -0
  632. package/templates/module/base/nodefony/config/config.ts.tpl +60 -0
  633. package/templates/module/base/nodefony/config/defineModuleConfig.ts.tpl +55 -0
  634. package/templates/module/base/nodefony/src/errors/__PASCAL__Error.ts.tpl +20 -0
  635. package/templates/module/base/package.json.tpl +53 -0
  636. package/templates/module/base/rolldown.config.ts.tpl +14 -0
  637. package/templates/module/base/tests/__KEBAB__.test.ts.tpl +39 -0
  638. package/templates/module/base/tsconfig.json.tpl +42 -0
  639. package/templates/module/base/vitest.config.ts.tpl +27 -0
  640. package/templates/module/packages/CLAUDE.md.tpl +51 -0
  641. package/templates/module/packages/MEMORY.md.tpl +39 -0
  642. package/templates/module/packages/tsconfig.declarations.json.tpl +19 -0
  643. package/templates/module/packages/tsconfig.tests.json.tpl +11 -0
  644. package/templates/module/service/nodefony/interfaces/I__PASCAL__Service.ts.tpl +14 -0
  645. package/templates/module/service/nodefony/interfaces/index.ts.tpl +1 -0
  646. package/templates/module/service/nodefony/service/__PASCAL__Service.ts.tpl +116 -0
  647. package/templates/service/nodefony/interfaces/I__PASCAL__Service.ts.tpl +19 -0
  648. package/templates/service/nodefony/service/__PASCAL__Service.ts.tpl +136 -0
  649. package/templates/service/tests/__PASCAL__Service.test.ts.tpl +53 -0
  650. package/templates/shared/front-entry/angular/frontend/src/main.ts.tpl +17 -0
  651. package/templates/shared/front-entry/react/frontend/src/main.tsx.tpl +11 -0
  652. package/templates/shared/front-entry/svelte/frontend/src/main.ts.tpl +13 -0
  653. package/templates/shared/front-entry/vue/frontend/src/main.ts.tpl +12 -0
  654. package/templates/shared/front-registrar/nodefony/frontend/register__PASCAL__Entry.ts.tpl +40 -0
  655. package/templates/shared/front-shell/frontend/index.html.tpl +39 -0
  656. package/templates/shared/ng-app-tsconfig/frontend/tsconfig.app.json.tpl +18 -0
  657. package/templates/shared/svelte-shim/frontend/src/env.d.ts.tpl +12 -0
  658. package/templates/shared/vue-shim/frontend/src/env.d.ts.tpl +15 -0
  659. package/.yarnclean +0 -45
  660. package/CHANGELOG.md +0 -406
  661. package/autoloader.es6 +0 -253
  662. package/builder.es6 +0 -366
  663. package/cli/builder/bundles/bundle.js +0 -328
  664. package/cli/builder/bundles/controller.js +0 -73
  665. package/cli/builder/bundles/users-bundle/.yarnclean +0 -45
  666. package/cli/builder/bundles/users-bundle/Command/fixtureTask.js +0 -47
  667. package/cli/builder/bundles/users-bundle/Command/usersCommand.js +0 -105
  668. package/cli/builder/bundles/users-bundle/Entity/mongoose/userEntity.js +0 -168
  669. package/cli/builder/bundles/users-bundle/Entity/sequelize/userEntity.js +0 -231
  670. package/cli/builder/bundles/users-bundle/Fixtures/users.js +0 -117
  671. package/cli/builder/bundles/users-bundle/Fixtures/usersFixtures.js +0 -114
  672. package/cli/builder/bundles/users-bundle/Resources/config/config.js +0 -90
  673. package/cli/builder/bundles/users-bundle/Resources/config/routing.js +0 -17
  674. package/cli/builder/bundles/users-bundle/Resources/config/security.js +0 -96
  675. package/cli/builder/bundles/users-bundle/Resources/config/services.js +0 -7
  676. package/cli/builder/bundles/users-bundle/Resources/config/webpack/webpack.dev.config.js +0 -13
  677. package/cli/builder/bundles/users-bundle/Resources/config/webpack/webpack.prod.config.js +0 -31
  678. package/cli/builder/bundles/users-bundle/Resources/config/webpack.config.js +0 -146
  679. package/cli/builder/bundles/users-bundle/Resources/js/users.js +0 -153
  680. package/cli/builder/bundles/users-bundle/Resources/public/favicon.ico +0 -0
  681. package/cli/builder/bundles/users-bundle/Resources/public/images/users-logo.png +0 -0
  682. package/cli/builder/bundles/users-bundle/Resources/scss/awesome/font-awesome.config.js +0 -11
  683. package/cli/builder/bundles/users-bundle/Resources/scss/custom.scss +0 -23
  684. package/cli/builder/bundles/users-bundle/Resources/scss/users.scss +0 -59
  685. package/cli/builder/bundles/users-bundle/Resources/swagger/openapi/login.js +0 -235
  686. package/cli/builder/bundles/users-bundle/Resources/swagger/openapi/users.js +0 -232
  687. package/cli/builder/bundles/users-bundle/Resources/translations/login.en_en.yml +0 -14
  688. package/cli/builder/bundles/users-bundle/Resources/translations/login.fr_fr.yml +0 -14
  689. package/cli/builder/bundles/users-bundle/Resources/translations/users.en_en.yml +0 -35
  690. package/cli/builder/bundles/users-bundle/Resources/translations/users.fr_fr.yml +0 -36
  691. package/cli/builder/bundles/users-bundle/Resources/views/base.html.twig +0 -32
  692. package/cli/builder/bundles/users-bundle/Resources/views/footer.html.twig +0 -7
  693. package/cli/builder/bundles/users-bundle/Resources/views/header.html.twig +0 -90
  694. package/cli/builder/bundles/users-bundle/Resources/views/login/login.html.twig +0 -43
  695. package/cli/builder/bundles/users-bundle/Resources/views/users/createUser.html.twig +0 -296
  696. package/cli/builder/bundles/users-bundle/Resources/views/users/readUsers.html.twig +0 -94
  697. package/cli/builder/bundles/users-bundle/controller/api/graphql/graphqlController.js +0 -56
  698. package/cli/builder/bundles/users-bundle/controller/api/graphql/userResolver.js +0 -121
  699. package/cli/builder/bundles/users-bundle/controller/api/graphql/usertype.js +0 -58
  700. package/cli/builder/bundles/users-bundle/controller/api/openapi/loginApiController.js +0 -210
  701. package/cli/builder/bundles/users-bundle/controller/api/openapi/restUserController.js +0 -244
  702. package/cli/builder/bundles/users-bundle/controller/loginController.js +0 -91
  703. package/cli/builder/bundles/users-bundle/controller/usersController.js +0 -332
  704. package/cli/builder/bundles/users-bundle/package.json +0 -58
  705. package/cli/builder/bundles/users-bundle/readme.md +0 -360
  706. package/cli/builder/bundles/users-bundle/services/usersService.js +0 -411
  707. package/cli/builder/bundles/users-bundle/src/providers/mongoose/userProvider.js +0 -47
  708. package/cli/builder/bundles/users-bundle/src/providers/sequelize/userProvider.js +0 -48
  709. package/cli/builder/bundles/users-bundle/tests/loginTest.js +0 -182
  710. package/cli/builder/bundles/users-bundle/usersBundle.js +0 -26
  711. package/cli/builder/microService/microService.js +0 -261
  712. package/cli/builder/microService/skeletons/.editorconfig +0 -18
  713. package/cli/builder/microService/skeletons/.env-cmdrc.js +0 -32
  714. package/cli/builder/microService/skeletons/.jshintrc +0 -37
  715. package/cli/builder/microService/skeletons/README.md +0 -117
  716. package/cli/builder/microService/skeletons/bin/bash/hello.sh +0 -5
  717. package/cli/builder/microService/skeletons/bin/cli +0 -13
  718. package/cli/builder/microService/skeletons/bin/python/hello.py +0 -20
  719. package/cli/builder/microService/skeletons/config/config.js +0 -29
  720. package/cli/builder/microService/skeletons/config/pm2.config.js +0 -72
  721. package/cli/builder/microService/skeletons/config/webpack/webpack.config.dev.js +0 -8
  722. package/cli/builder/microService/skeletons/config/webpack/webpack.config.prod.js +0 -25
  723. package/cli/builder/microService/skeletons/config/webpack.config.js +0 -114
  724. package/cli/builder/microService/skeletons/package.json +0 -76
  725. package/cli/builder/microService/skeletons/src/browser/index.css +0 -3
  726. package/cli/builder/microService/skeletons/src/browser/index.js +0 -16
  727. package/cli/builder/microService/skeletons/src/browser/socketio.js +0 -46
  728. package/cli/builder/microService/skeletons/src/cli/cli.js +0 -224
  729. package/cli/builder/microService/skeletons/src/cli/menu.js +0 -28
  730. package/cli/builder/microService/skeletons/src/n-api/README.md +0 -1
  731. package/cli/builder/microService/skeletons/src/n-api/binding.gyp +0 -14
  732. package/cli/builder/microService/skeletons/src/n-api/hello.cc +0 -14
  733. package/cli/builder/microService/skeletons/src/n-api/hello.js +0 -23
  734. package/cli/builder/microService/skeletons/src/n-api/package.json +0 -15
  735. package/cli/builder/microService/skeletons/src/node/examples/index.js +0 -120
  736. package/cli/builder/microService/skeletons/src/node/index.js +0 -102
  737. package/cli/builder/microService/skeletons/src/node/services/markdown/markdown.js +0 -27
  738. package/cli/builder/microService/skeletons/src/node/services/servers/http.js +0 -45
  739. package/cli/builder/microService/skeletons/src/node/services/servers/https.js +0 -44
  740. package/cli/builder/microService/skeletons/src/node/services/socketio/socketio.js +0 -46
  741. package/cli/builder/microService/skeletons/src/node/services/syscall/syscall.js +0 -111
  742. package/cli/builder/microService/skeletons/src/node/services/worker/thread.js +0 -59
  743. package/cli/builder/microService/skeletons/src/node/services/worker/worker.js +0 -60
  744. package/cli/builder/microService/skeletons/src/templates/base.html +0 -12
  745. package/cli/builder/microService/skeletons/src/templates/socket.html +0 -23
  746. package/cli/builder/microService/skeletons/tests/unit/serviceTest.js +0 -30
  747. package/cli/builder/project/project.js +0 -474
  748. package/cli/builder/project/skeletons/README.md +0 -778
  749. package/cli/builder/project/skeletons/bin/dev-deploy.sh +0 -5
  750. package/cli/builder/project/skeletons/bin/generateCertificates.sh.skeleton +0 -180
  751. package/cli/builder/project/skeletons/bin/prod-deploy.sh +0 -3
  752. package/cli/builder/project/skeletons/config/config.js.skeleton +0 -178
  753. package/cli/builder/project/skeletons/config/openssl/ca/openssl.cnf.skeleton +0 -150
  754. package/cli/builder/project/skeletons/config/openssl/ca_intermediate/openssl.cnf.skeleton +0 -152
  755. package/cli/builder/project/skeletons/config/pm2.config.js.skeleton +0 -62
  756. package/cli/builder/project/skeletons/documentation.html.twig +0 -24
  757. package/cli/builder/project/skeletons/editorconfig.skeleton +0 -18
  758. package/cli/builder/project/skeletons/eslintignore.skeleton +0 -15
  759. package/cli/builder/project/skeletons/eslintrc.js.skeleton +0 -97
  760. package/cli/builder/project/skeletons/gitignore.skeleton +0 -32
  761. package/cli/builder/project/skeletons/migrations/2022.12.25T17.37.37.entity-user.js +0 -137
  762. package/cli/builder/project/skeletons/migrations/2022.12.25T17.37.38.entity-session.js +0 -97
  763. package/cli/builder/project/skeletons/migrations/2022.12.25T17.37.39.entity-requests.js +0 -115
  764. package/cli/builder/project/skeletons/migrations/2022.12.25T17.37.40.entity-jwts.js +0 -97
  765. package/cli/builder/project/skeletons/migrations/migrations.skeleton.js +0 -101
  766. package/cli/builder/project/skeletons/package.json.twig +0 -71
  767. package/cli/builder/react/reactBuilder.js +0 -224
  768. package/cli/builder/react/skeletons/app/Resources/databases/nodefony.db +0 -0
  769. package/cli/builder/react/skeletons/app/Resources/translations/messages.en_en.yml +0 -5
  770. package/cli/builder/react/skeletons/app/Resources/translations/messages.fr_fr.yml +0 -5
  771. package/cli/builder/react/skeletons/app/Resources/views/base.html.twig +0 -33
  772. package/cli/builder/react/skeletons/app/config/config.js +0 -392
  773. package/cli/builder/react/skeletons/app/config/routing.js +0 -10
  774. package/cli/builder/react/skeletons/app/config/security.js +0 -74
  775. package/cli/builder/react/skeletons/app/controller/appController.js +0 -22
  776. package/cli/builder/sandbox/sandBoxBuilder.js +0 -610
  777. package/cli/builder/sandbox/skeletons/Resources/css/entry.css +0 -48
  778. package/cli/builder/sandbox/skeletons/Resources/js/entry.js +0 -60
  779. package/cli/builder/sandbox/skeletons/Resources/public/manifest.json +0 -32
  780. package/cli/builder/sandbox/skeletons/Resources/translations/messages.en_en.yml +0 -5
  781. package/cli/builder/sandbox/skeletons/Resources/translations/messages.fr_fr.yml +0 -5
  782. package/cli/builder/sandbox/skeletons/Resources/views/base.html.twig +0 -46
  783. package/cli/builder/sandbox/skeletons/Resources/views/index.html.twig +0 -34
  784. package/cli/builder/sandbox/skeletons/bootstrap/custom.scss +0 -27
  785. package/cli/builder/sandbox/skeletons/bootstrap/entry.scss +0 -60
  786. package/cli/builder/sandbox/skeletons/workbox/templates/index.html.twig +0 -32
  787. package/cli/builder/sandbox/skeletons/workbox/workers/service-worker.js +0 -196
  788. package/cli/builder/skeletons/Resources/public/favicon.ico +0 -0
  789. package/cli/builder/skeletons/Resources/public/images/app-logo.png +0 -0
  790. package/cli/builder/skeletons/Resources/views/framework-bundle/views/401.html.twig +0 -1
  791. package/cli/builder/skeletons/Resources/views/framework-bundle/views/401.json.twig +0 -24
  792. package/cli/builder/skeletons/Resources/views/framework-bundle/views/403.html.twig +0 -1
  793. package/cli/builder/skeletons/Resources/views/framework-bundle/views/403.json.twig +0 -20
  794. package/cli/builder/skeletons/Resources/views/framework-bundle/views/404.html.twig +0 -1
  795. package/cli/builder/skeletons/Resources/views/framework-bundle/views/404.json.twig +0 -20
  796. package/cli/builder/skeletons/Resources/views/framework-bundle/views/500.html.twig +0 -1
  797. package/cli/builder/skeletons/Resources/views/framework-bundle/views/base.html.twig +0 -30
  798. package/cli/builder/skeletons/Resources/views/framework-bundle/views/exception.html.twig +0 -1
  799. package/cli/builder/skeletons/Resources/views/framework-bundle/views/exception.json.twig +0 -24
  800. package/cli/builder/skeletons/Resources/views/framework-bundle/views/footer.html.twig +0 -33
  801. package/cli/builder/skeletons/Resources/views/framework-bundle/views/header.html.twig +0 -6
  802. package/cli/builder/skeletons/Resources/views/framework-bundle/views/index.html.twig +0 -6
  803. package/cli/builder/skeletons/Resources/views/framework-bundle/views/index.json.twig +0 -1
  804. package/cli/builder/skeletons/Resources/views/framework-bundle/views/layout.html.twig +0 -125
  805. package/cli/builder/skeletons/Resources/views/framework-bundle/views/layout.json.twig +0 -5
  806. package/cli/builder/skeletons/Resources/views/framework-bundle/views/timeout.html.twig +0 -1
  807. package/cli/builder/skeletons/Resources/views/framework-bundle/views/timeout.json.twig +0 -24
  808. package/cli/builder/skeletons/app/appKernel.js +0 -133
  809. package/cli/builder/skeletons/binding/binding.cc +0 -26
  810. package/cli/builder/skeletons/binding/binding.skeleton +0 -8
  811. package/cli/builder/skeletons/bundle/bundleClass.js +0 -37
  812. package/cli/builder/skeletons/command/commandClass.js +0 -11
  813. package/cli/builder/skeletons/command/taskClass.js +0 -20
  814. package/cli/builder/skeletons/config/config.js +0 -138
  815. package/cli/builder/skeletons/config/nodefony/elastic-bundle.js +0 -37
  816. package/cli/builder/skeletons/config/nodefony/framework-bundle.js +0 -22
  817. package/cli/builder/skeletons/config/nodefony/http-bundle.js +0 -104
  818. package/cli/builder/skeletons/config/nodefony/mail-bundle.js +0 -44
  819. package/cli/builder/skeletons/config/nodefony/mongoose-bundle.js +0 -51
  820. package/cli/builder/skeletons/config/nodefony/monitoring-bundle.js +0 -34
  821. package/cli/builder/skeletons/config/nodefony/realtime-bundle.js +0 -15
  822. package/cli/builder/skeletons/config/nodefony/redis-bundle.js +0 -44
  823. package/cli/builder/skeletons/config/nodefony/security-bundle.js +0 -25
  824. package/cli/builder/skeletons/config/nodefony/sequelize-bundle.js +0 -156
  825. package/cli/builder/skeletons/config/routing.js +0 -55
  826. package/cli/builder/skeletons/config/security.js +0 -102
  827. package/cli/builder/skeletons/config/services.js +0 -1
  828. package/cli/builder/skeletons/config/webpack/webpack.dev.config.js +0 -13
  829. package/cli/builder/skeletons/config/webpack/webpack.prod.config.js +0 -20
  830. package/cli/builder/skeletons/config/webpack.config.js +0 -148
  831. package/cli/builder/skeletons/controller/controllerClass.js +0 -75
  832. package/cli/builder/skeletons/package.json.twig +0 -57
  833. package/cli/builder/skeletons/unittest/testFile.js +0 -46
  834. package/cli/builder/vue/skeletons/Resources/public/images/app-logo.png +0 -0
  835. package/cli/builder/vue/skeletons/Resources/translations/messages.en_en.yml +0 -5
  836. package/cli/builder/vue/skeletons/Resources/translations/messages.fr_fr.yml +0 -5
  837. package/cli/builder/vue/skeletons/vue.config.js +0 -129
  838. package/cli/builder/vue/vueBuilder.js +0 -410
  839. package/cli/generate/generate.es6 +0 -103
  840. package/cli/install/install.js +0 -190
  841. package/cli/sequelize/sequelize.js +0 -94
  842. package/cli/start.js +0 -702
  843. package/cli/tools/pm2.es6 +0 -112
  844. package/cli/tools/tools.es6 +0 -97
  845. package/cli.es6 +0 -925
  846. package/container.es6 +0 -272
  847. package/error.es6 +0 -293
  848. package/fileClass.es6 +0 -242
  849. package/finder/file.es6 +0 -33
  850. package/finder/fileResult.es6 +0 -138
  851. package/finder/finder2.es6 +0 -275
  852. package/finder.es6 +0 -427
  853. package/kernel/annotations/annotations.es6 +0 -286
  854. package/kernel/api/api.es6 +0 -61
  855. package/kernel/api/graphqlApi.es6 +0 -107
  856. package/kernel/api/jsonApi.es6 +0 -177
  857. package/kernel/api/openApi.es6 +0 -139
  858. package/kernel/api/schemas/openApiSchema.js +0 -394
  859. package/kernel/babylon.es6 +0 -162
  860. package/kernel/bundle.es6 +0 -1200
  861. package/kernel/cliKernel.es6 +0 -869
  862. package/kernel/command.es6 +0 -78
  863. package/kernel/commands/nodefonyCommand.es6 +0 -247
  864. package/kernel/commands/tasks/bundlesTask.es6 +0 -59
  865. package/kernel/controllers/controller.es6 +0 -791
  866. package/kernel/fixture.es6 +0 -19
  867. package/kernel/injections/injections.es6 +0 -424
  868. package/kernel/kernel.es6 +0 -1960
  869. package/kernel/kernelWatcher.es6 +0 -387
  870. package/kernel/orm/entity.es6 +0 -59
  871. package/kernel/orm/orm.es6 +0 -139
  872. package/kernel/reader.es6 +0 -290
  873. package/kernel/security/encoder.es6 +0 -17
  874. package/kernel/security/factories/factory.es6 +0 -111
  875. package/kernel/security/factories/passeportFactory.es6 +0 -61
  876. package/kernel/security/provider.es6 +0 -58
  877. package/kernel/security/providers/chainProvider.es6 +0 -99
  878. package/kernel/security/providers/memoryProvider.es6 +0 -55
  879. package/kernel/security/providers/providerManager.es6 +0 -67
  880. package/kernel/security/providers/userEntityProvider.es6 +0 -50
  881. package/kernel/security/role.es6 +0 -12
  882. package/kernel/security/secureArea.es6 +0 -431
  883. package/kernel/security/tokens/token.es6 +0 -171
  884. package/kernel/security/user.es6 +0 -106
  885. package/kernel/serviceRealTime.es6 +0 -21
  886. package/kernel/services/connectionsService.es6 +0 -93
  887. package/kernel/services/cron/cronService.es6 +0 -123
  888. package/kernel/task.es6 +0 -80
  889. package/kernel/templates.es6 +0 -22
  890. package/kernel/templating/twig.es6 +0 -218
  891. package/kernel/tests/cliTest.js +0 -59
  892. package/kernel/tests/containerTest.js +0 -232
  893. package/kernel/tests/kernelTest.js +0 -39
  894. package/nodefony.es6 +0 -1084
  895. package/notificationsCenter.es6 +0 -118
  896. package/protocol.es6 +0 -86
  897. package/protocols/bayeux.es6 +0 -174
  898. package/protocols/jsonRpc/jsonrpc.es6 +0 -56
  899. package/result.es6 +0 -99
  900. package/service.es6 +0 -288
  901. package/syslog/pdu.es6 +0 -141
  902. package/syslog/syslog.es6 +0 -754
  903. package/watcher.es6 +0 -113
package/docs/client.md ADDED
@@ -0,0 +1,616 @@
1
+ ---
2
+ title: "Le client isomorphe — Nodefony dans le navigateur"
3
+ navTitle: Le client isomorphe
4
+ lang: fr
5
+ module: "@nodefony/core"
6
+ topic: client
7
+ coverageModule: nodefony-core
8
+ coveragePackage: "nodefony (cœur)"
9
+ coverageFiles: "client/realtime/RealtimeClient.ts,client/realtime/AdaptiveRate.ts,client/roles/roles.ts"
10
+ section: "Cœur runtime"
11
+ audience: [developer]
12
+ tags:
13
+ [
14
+ client,
15
+ isomorphe,
16
+ navigateur,
17
+ realtime,
18
+ websocket,
19
+ json-rpc,
20
+ subpath,
21
+ roles,
22
+ debugbar,
23
+ cadence,
24
+ ]
25
+ version: "doc"
26
+ status: stable
27
+ updated: 2026-07-19
28
+ source: "src/nodefony/docs/client.md"
29
+ ---
30
+
31
+ # Le client isomorphe — Nodefony dans le navigateur
32
+
33
+ > Le paquet `nodefony` ne s'arrête pas au serveur : une partie de son code est **compilée pour le
34
+ > navigateur** et publiée sous quatre points d'entrée (`nodefony/client`, `nodefony/react`,
35
+ > `nodefony/roles`, `nodefony/debugbar`). Ton front n'importe donc pas une bibliothèque cliente
36
+ > « compagnon » qu'il faudrait tenir à jour en parallèle du back — il importe **le même paquet**, avec
37
+ > les mêmes types, le même protocole et les mêmes règles de rôles. Ancré sur `src/nodefony/src/client/`.
38
+
39
+ 📍 [Documentation](../../../docs/index.md) › [Cœur — @nodefony/core](index.md) › **Client isomorphe**
40
+
41
+ ## 🧠 Le modèle mental — un paquet, deux compilations
42
+
43
+ Une application temps réel a toujours deux moitiés qui doivent **se mettre d'accord** : le serveur qui
44
+ pousse, le navigateur qui reçoit. La méthode habituelle consiste à écrire deux fois le contrat — une
45
+ fois en TypeScript côté back, une fois en JavaScript côté front — puis à réparer les divergences.
46
+
47
+ Nodefony supprime la deuxième écriture. Le même dépôt de code produit **deux sorties** depuis les
48
+ mêmes sources : un bundle Node et un bundle navigateur. Le champ `exports` du paquet aiguille selon
49
+ qui demande.
50
+
51
+ ```mermaid
52
+ flowchart TD
53
+ SRC["src/nodefony/src/<br/>sources TypeScript UNIQUES"]
54
+ SRC --> NB["bundle Node<br/>dist/node/"]
55
+ SRC --> CB["bundle navigateur<br/>dist/client/"]
56
+ NB --> SERV["Serveur<br/>Kernel · Module · Controller"]
57
+ CB --> C1["nodefony/client<br/>RealtimeClient · notices · cadence"]
58
+ CB --> C2["nodefony/react<br/>hooks useNodefony*"]
59
+ CB --> C3["nodefony/roles<br/>RBAC d'affichage"]
60
+ CB --> C4["nodefony/debugbar<br/>barre de debug dev"]
61
+ C1 -->|"WebSocket · JSON-RPC 2.0"| SERV
62
+ SHARED["code PARTAGÉ des deux côtés<br/>JsonRpcPeer · IRealtimeSocket · Pdu · Service"]
63
+ SHARED -.-> NB
64
+ SHARED -.-> CB
65
+ ```
66
+
67
+ Trois idées portent toute la page :
68
+
69
+ 1. **Le contrat n'est pas dupliqué, il est partagé.** Le moteur de protocole `JsonRpcPeer` est le
70
+ **même objet** des deux côtés : le navigateur l'exécute dans son client, le serveur en instancie un
71
+ par connexion.
72
+ 2. **Le navigateur n'a droit qu'à ce qui a du sens pour lui.** Le barrel client ne réexporte pas le
73
+ Kernel, ni les serveurs, ni la validation de schéma — on n'expédie pas 400 Kio de back au client.
74
+ 3. **Ce que le client sait faire, le serveur n'a pas à le faire.** La reconnexion, la mémoire des
75
+ abonnements et la **négociation de cadence** vivent côté navigateur : le serveur reste bête et
76
+ sans état par connexion.
77
+
78
+ ## 📖 Lexique
79
+
80
+ | Terme | Sens |
81
+ | ---------------------- | ---------------------------------------------------------------------------------------------------------- |
82
+ | **Isomorphe** | Un même code source qui s'exécute **des deux côtés** (serveur et navigateur), sans réécriture. |
83
+ | **Subpath** | Point d'entrée secondaire d'un paquet npm (`nodefony/client`), déclaré dans le champ `exports`. |
84
+ | **Condition d'export** | Clé du champ `exports` (`browser`, `import`, `types`) qui choisit **quel fichier** un outil résout. |
85
+ | **Barrel** | Fichier `index.ts` qui réexporte la surface publique d'un dossier. C'est lui qui décide ce qui est public. |
86
+ | **JSON-RPC 2.0** | Protocole d'appel de méthode par messages ; Nodefony l'emploie sur WebSocket dans les deux sens. |
87
+ | **Canal** | Sujet logique multiplexé sur l'unique connexion (`orders:new`). On s'y **abonne**, on y **publie**. |
88
+ | **Notification** | Message JSON-RPC **sans identifiant** — aucune réponse attendue. C'est la forme du pub/sub. |
89
+ | **Ref-comptage** | Compter les consommateurs d'un abonnement pour n'émettre le trafic qu'aux transitions 0↔1. |
90
+ | **Welcome** | Première trame poussée par le serveur à l'ouverture : identité résolue + capacités annoncées. |
91
+ | **Notice** | Message normalisé prêt à afficher (`level`, `title`, `message`) — le format unique des alertes du client. |
92
+ | **Close code** | Code numérique de fermeture d'une WebSocket (RFC 6455 §7.4) : il dit **pourquoi** ça s'est fermé. |
93
+ | **AIMD** | _Additive Increase / Multiplicative Decrease_ — la loi de contrôle de congestion de TCP, reprise ici. |
94
+ | **Famine** | Les trames arrivent nettement plus lentement que la cadence demandée : le producteur est sous pression. |
95
+ | **Latest-wins** | Canal d'**état** où seule la dernière valeur compte — on peut décimer sans rien perdre. |
96
+ | **RBAC** | _Role-Based Access Control_ — décider d'un droit à partir de rôles (`ROLE_ADMIN`). |
97
+ | **Shim** | Petit remplacement d'une API absente du navigateur (`node:events`, `node:util`) pour que le code compile. |
98
+ | **Tree-shaking** | Élimination du code non importé au build : un subpath qu'on n'importe pas pèse **zéro octet**. |
99
+ | **HMR** | _Hot Module Replacement_ — remplacement d'un module à chaud pendant le développement, sans recharger. |
100
+
101
+ ## Qu'est-ce qu'un client isomorphe — et ce que ça change concrètement
102
+
103
+ Un « client » de framework, d'habitude, c'est un second paquet npm (`mon-framework-client`) publié à
104
+ côté du serveur. Il embarque sa propre copie du protocole, sa propre définition des types échangés, et
105
+ son propre calendrier de versions. Tant que les deux avancent ensemble, tout va bien. Le jour où le
106
+ serveur renomme un champ, la divergence ne se voit **qu'à l'exécution**, chez l'utilisateur.
107
+
108
+ Un client isomorphe supprime la question : il n'y a **qu'un** paquet, donc **qu'une** version. Trois
109
+ conséquences pratiques, dans l'ordre où on les rencontre.
110
+
111
+ - **Les types sont les mêmes objets, pas des copies.** Le contrat de socket `IRealtimeSocket` décrit
112
+ la prise côté navigateur **et** côté serveur. Une méthode qui change de signature casse la
113
+ compilation des deux côtés, au build, pas en production.
114
+ - **Les règles de rôles s'évaluent à l'identique.** `hasAnyRole()` (`client/roles/roles.ts:34`) est
115
+ la fonction que le front appelle pour griser un bouton et que le back peut appeler dans un jury
116
+ d'autorisation. Plus de « le front croyait que `ROLE_ADMIN` suffisait ».
117
+ - **Les erreurs se traduisent une seule fois.** Le serveur ferme la connexion avec un code RFC 6455 ;
118
+ le client traduit ce code en message lisible via `closeCodeToNotice()` (`client/realtime/notice.ts:67`).
119
+ La table de correspondance vit à un seul endroit.
120
+
121
+ > [!IMPORTANT]
122
+ > Isomorphe ne veut pas dire « identique ». Le navigateur n'a ni kernel, ni serveurs, ni accès à la
123
+ > base. Le barrel client publie une **sélection** — `RealtimeClient`, `Syslog`, `Pdu`, `Service`,
124
+ > `Container` (`client/index.ts:76`) : les briques qui ont un sens dans un onglet. Le reste n'est
125
+ > simplement pas là, et n'alourdit donc pas ton bundle.
126
+
127
+ ## La vision Nodefony
128
+
129
+ Le champ `exports` du paquet est le pivot de tout le dispositif. Il déclare **quatre** points d'entrée
130
+ navigateur, plus une condition `browser` sur l'entrée principale.
131
+
132
+ | Ce que tu importes | Ce que tu obtiens | Quand l'utiliser |
133
+ | --------------------- | ------------------------------------------------------------------------ | --------------------------------------------------- |
134
+ | `nodefony/client` | Le client temps réel, les notices, la cadence adaptative, `Syslog`/`Pdu` | Toujours — c'est le point d'entrée de référence |
135
+ | `nodefony/react` | Les hooks `useNodefony*` (peer optionnelle `react`) | App React qui consomme des canaux |
136
+ | `nodefony/roles` | `hasRole` & co, `RoleSet`, `RoleRegistry` | Afficher/masquer selon les rôles |
137
+ | `nodefony/debugbar` | La barre de debug de développement + son modèle pur | Dev, ou réutiliser le calcul de cascade |
138
+ | `nodefony` (au front) | La **même chose** que `nodefony/client`, via la condition `browser` | Code partagé front/back ; sinon préfère l'explicite |
139
+
140
+ Ces quatre entrées sont produites par une compilation dédiée — `clientConfig`
141
+ (`rolldown.config.ts:100`) déclare exactement ces quatre fichiers d'entrée, en conservant la structure
142
+ des modules pour que le client temps réel ne soit émis **qu'une fois** même s'il est tiré par deux
143
+ subpaths.
144
+
145
+ Deux choix méritent d'être explicités, parce qu'ils se voient dans ton bundle.
146
+
147
+ - **Les subpaths ne sont jamais réexportés depuis le barrel principal.** Importer `nodefony/client`
148
+ ne tire ni React, ni la barre de debug. C'est ce qui permet à la barre de peser **zéro octet** en
149
+ production : personne ne l'importe.
150
+ - **React est une dépendance externe, jamais empaquetée.** `clientExternal` (`rolldown.config.ts:94`)
151
+ marque `react`/`react-dom` comme externes : c'est **ton** React qui sera utilisé, donc pas de double
152
+ instance et pas de règle des hooks violée.
153
+
154
+ Le compromis assumé : côté navigateur, quelques API Node manquent. Nodefony ne charge pas de
155
+ polyfill lourd — il substitue au build deux **shims** minimaux, `browserShim`
156
+ (`rolldown.config.ts:80`), qui redirigent `node:events` et `node:util` vers des implémentations
157
+ navigateur de quelques dizaines de lignes.
158
+
159
+ ## 🚀 Démarrage rapide
160
+
161
+ Le scénario : une application générée par `nodefony create app` avec un front servi par
162
+ `@nodefony/frontend`. On veut une socket ouverte, un canal écouté, et un appel d'API par cette même
163
+ socket.
164
+
165
+ ### 1. La socket de l'application
166
+
167
+ Le client est une classe : on l'instancie, on la connecte.
168
+
169
+ ```typescript
170
+ import { RealtimeClient } from "nodefony/client";
171
+
172
+ const socket = new RealtimeClient({ url: "/api/live/realtime" });
173
+ await socket.connect();
174
+ ```
175
+
176
+ C'est ce que fait `shared()` — **plus une garantie** : une application veut **une seule** connexion
177
+ WebSocket pour toute la page, et `new` en ouvre une par appel. `RealtimeClient.shared({ url })` rend
178
+ donc la **même instance** pour la même URL, depuis n'importe quel fichier, sans passer la socket de
179
+ main en main.
180
+
181
+ > **Retenir** : `new` pour comprendre l'objet, `shared()` partout dans une application.
182
+
183
+ Un seul fichier, monté une fois au démarrage du front.
184
+
185
+ ```typescript
186
+ // frontend/src/realtime.ts — la socket de l'app, importée partout ailleurs.
187
+ import { RealtimeClient } from "nodefony/client";
188
+ import type { NodefonyNotice } from "nodefony/client";
189
+
190
+ // Instance PARTAGÉE par URL : deux appels = la même socket, pas deux connexions.
191
+ // L'URL relative est normalisée (https → wss) avant l'ouverture.
192
+ export const socket = RealtimeClient.shared({
193
+ url: "/api/live/realtime",
194
+ });
195
+
196
+ // Les criticités du temps réel arrivent déjà traduites et prêtes à afficher.
197
+ socket.onNotice((notice: NodefonyNotice) => {
198
+ console.warn(`[${notice.level}] ${notice.message}`);
199
+ });
200
+
201
+ // `on` REÇOIT les messages ; `subscribe` DEMANDE au serveur de les pousser.
202
+ // Les deux sont nécessaires — et `subscribe` est ré-émis seul au reconnect.
203
+ socket.on("orders:new", (payload) => {
204
+ console.log("nouvelle commande", payload);
205
+ });
206
+ socket.subscribe("orders:new");
207
+
208
+ // L'identité vient du serveur (trame « welcome ») : aucune route /auth/me.
209
+ socket.onIdentity((identity) => {
210
+ if (!identity?.authenticated) console.log("visiteur anonyme");
211
+ });
212
+
213
+ await socket.connect();
214
+ ```
215
+
216
+ ### 2. Appeler l'API par la socket, pas par `fetch`
217
+
218
+ La même action de contrôleur répond en HTTP **et** en WebSocket. Un chemin qui commence par `/` est
219
+ routé vers le pont d'API ; les mutations exigent une clé d'idempotence, parce qu'une socket qui
220
+ reconnecte peut rejouer une trame en vol.
221
+
222
+ ```typescript
223
+ // frontend/src/orders.ts
224
+ import { RealtimeClient } from "nodefony/client";
225
+
226
+ // MÊME URL ⇒ MÊME instance que dans `realtime.ts` : `shared()` se relit de
227
+ // n'importe quel fichier, sans passer la socket de main en main.
228
+ const socket = RealtimeClient.shared({ url: "/api/live/realtime" });
229
+
230
+ // Lecture — équivalent strict du GET REST sur la même route.
231
+ export async function loadModules(): Promise<{ name: string }[]> {
232
+ return socket.request<{ name: string }[]>("/nodefony/kernel/api/modules");
233
+ }
234
+
235
+ // Écriture — la clé d'idempotence dédoublonne un éventuel rejeu.
236
+ export async function ship(orderId: string): Promise<void> {
237
+ await socket.mutate(`/shop/api/orders/${orderId}/ship`, {
238
+ method: "POST",
239
+ idempotencyKey: crypto.randomUUID(),
240
+ });
241
+ }
242
+
243
+ // Mesure du temps d'aller-retour — la convention `nodefony:kernel:ping` vit dans la lib.
244
+ export async function latency(): Promise<number> {
245
+ const { rtt } = await socket.ping();
246
+ return rtt;
247
+ }
248
+ ```
249
+
250
+ ### 3. Adapter l'affichage aux rôles
251
+
252
+ ```typescript
253
+ // frontend/src/nav.ts — filtrer une navigation. ERGONOMIE, pas sécurité.
254
+ import { hasAnyRole, RoleSet } from "nodefony/roles";
255
+
256
+ export function visibleTabs(roles: readonly string[]): string[] {
257
+ const tabs = ["Commandes"];
258
+ // Contrôle ponctuel : zéro allocation, parcours linéaire.
259
+ if (hasAnyRole(roles, ["ROLE_ADMIN", "ROLE_BILLING"]))
260
+ tabs.push("Facturation");
261
+ // Contrôles RÉPÉTÉS sur le même utilisateur : une allocation, puis O(1).
262
+ const set = new RoleSet(roles);
263
+ if (set.has("ROLE_ADMIN")) tabs.push("Administration");
264
+ return tabs;
265
+ }
266
+ ```
267
+
268
+ ### Ce qu'on observe
269
+
270
+ ```bash
271
+ npx nodefony development
272
+ ```
273
+
274
+ Dans la console du navigateur, à l'ouverture de la page :
275
+
276
+ ```text
277
+ visiteur anonyme # la trame welcome est arrivée, non authentifié
278
+ nouvelle commande { id: 'CMD-42' } # le canal orders:new pousse
279
+ [warning] Connexion temps réel perdue # le réseau a sauté (close code 1006)
280
+ [success] Connexion temps réel rétablie
281
+ ```
282
+
283
+ La dernière ligne mérite une remarque : elle n'est émise qu'après une **vraie** perte, jamais à la
284
+ première connexion. Le client distingue « je me connecte » de « je me reconnecte » — sinon toute page
285
+ afficherait un message de rétablissement au chargement.
286
+
287
+ > [!TIP]
288
+ > En React, ne câble rien à la main : les hooks du subpath `nodefony/react` font l'abonnement, le
289
+ > désabonnement et le re-rendu pour toi. Voir [Hooks React](react-hooks.md).
290
+
291
+ ## 🔌 `RealtimeClient` — la socket vue du navigateur
292
+
293
+ C'est la brique centrale du subpath. `RealtimeClient` (`client/realtime/RealtimeClient.ts:161`)
294
+ implémente le contrat de socket isomorphe **et** le contrat de pair JSON-RPC : il sait donc à la fois
295
+ recevoir des messages poussés et **répondre** à des requêtes venues du serveur.
296
+
297
+ ### Ouvrir, perdre, retrouver la connexion
298
+
299
+ ```mermaid
300
+ stateDiagram-v2
301
+ [*] --> disconnected
302
+ disconnected --> connecting: connect()
303
+ connecting --> connected: transport ouvert + welcome
304
+ connected --> reconnecting: fermeture TRANSITOIRE (1006, 1011…)
305
+ reconnecting --> connected: nouvelle tentative réussie
306
+ connected --> error: fermeture DÉFINITIVE (1008, 1002…)
307
+ connected --> disconnected: disconnect()
308
+ error --> connecting: retryNow() après action corrective
309
+ ```
310
+
311
+ La subtilité utile est la distinction entre fermeture **transitoire** et **définitive**.
312
+ `isReconnectableCloseCode()` (`client/realtime/notice.ts:156`) lit le code de fermeture : une perte
313
+ réseau (1006) ou un redémarrage serveur (1011) relancent la boucle de reconnexion ; un refus de
314
+ politique (1008, c'est-à-dire un 401/403 traduit) ne la relance **pas**. Sans cette règle, un visiteur
315
+ anonyme martèlerait indéfiniment un point d'entrée protégé.
316
+
317
+ Le délai entre tentatives double à chaque échec — `scheduleReconnect()`
318
+ (`client/realtime/RealtimeClient.ts:1251`) — plafonné à 30 secondes par défaut. La date de la
319
+ prochaine tentative est exposée en lecture, ce qui permet d'afficher un compte à rebours exact plutôt
320
+ qu'un sablier qui ment.
321
+
322
+ ### Les canaux — ref-comptés, et remémorés
323
+
324
+ C'est le mécanisme qui évite la classe de bugs la plus pénible d'une application temps réel : deux
325
+ composants écoutent le même canal, l'un se démonte, et **coupe le flux de l'autre**.
326
+
327
+ `RealtimeClient.subscribe()` (`client/realtime/RealtimeClient.ts:530`) compte les consommateurs et
328
+ n'envoie la demande au serveur qu'au **premier**. `RealtimeClient.unsubscribe()`
329
+ (`client/realtime/RealtimeClient.ts:543`) ne coupe qu'au **dernier**. Entre les deux, le trafic réseau
330
+ est nul.
331
+
332
+ Second effet, tout aussi important : la liste des abonnements est **rejouée à chaque reconnexion**.
333
+ Le serveur repart d'un état vide après une coupure ; c'est le client qui se souvient de ce qu'il
334
+ écoutait, dans la routine d'ouverture de socket (`client/realtime/RealtimeClient.ts:1007`).
335
+
336
+ > [!WARNING]
337
+ > `on(canal, handler)` et `subscribe(canal)` ne font **pas** la même chose et ne se remplacent pas.
338
+ > Le premier installe un écouteur local ; le second demande au serveur de pousser. Écouter sans
339
+ > s'abonner donne un canal silencieux ; s'abonner sans écouter fait transiter des trames que personne
340
+ > ne lit.
341
+
342
+ ### Les quatre façons de parler au serveur
343
+
344
+ | Appel | Ancre | Ce que ça fait |
345
+ | ------------------------------------- | --------------------------------------- | ---------------------------------------------------------------- |
346
+ | `RealtimeClient.emit()` / `publish()` | `client/realtime/RealtimeClient.ts:512` | Notification sans réponse — la forme du pub/sub |
347
+ | `RealtimeClient.request()` | `client/realtime/RealtimeClient.ts:727` | Requête/réponse ; un argument commençant par `/` cible une route |
348
+ | `RealtimeClient.mutate()` | `client/realtime/RealtimeClient.ts:797` | Écriture par le pont d'API — **clé d'idempotence obligatoire** |
349
+
350
+ Deux compléments moins courants. `RealtimeClient.call()`
351
+ (`client/realtime/RealtimeClient.ts:839`) rend l'**enveloppe complète** — la valeur **et**
352
+ l'identifiant du profil serveur de cette trame, ce qui permet en développement d'aller lire la
353
+ radiographie de l'appel. Et `RealtimeClient.register()`
354
+ (`client/realtime/RealtimeClient.ts:907`) fait du navigateur un **appelé** : le serveur peut lui
355
+ adresser une requête et attendre son résultat. C'est le duplex réel, pas seulement du push.
356
+
357
+ ### Identité et refus — l'interface sait sans demander
358
+
359
+ L'identité de la connexion n'est pas devinée par le front : le serveur l'annonce dans sa première
360
+ trame, et le client la retient. `RealtimeClient.identity`
361
+ (`client/realtime/RealtimeClient.ts:581`) vaut `null` tant que rien n'est reçu, puis porte un objet
362
+ dont `authenticated` vaut `false` pour un visiteur anonyme. Un écran de connexion se décide donc
363
+ **sans appeler aucune route**.
364
+
365
+ Le pendant côté refus : quand le serveur rejette un abonnement, il pousse un message dédié que le
366
+ client transforme en deux signaux — une notice générique pour le centre de notifications, et un
367
+ événement ciblé consommable par `RealtimeClient.onDenied()`
368
+ (`client/realtime/RealtimeClient.ts:469`) pour une réaction précise (griser le contrôle concerné). Le
369
+ motif reste volontairement générique : le serveur ne dit jamais **quel** rôle manquait, ce qui en
370
+ ferait un oracle.
371
+
372
+ ### Le transport, et pourquoi il est aussi bête
373
+
374
+ `BrowserWsTransport` (`client/realtime/BrowserWsTransport.ts:12`) enveloppe la `WebSocket` native et
375
+ ne fait rien d'autre : ouvrir, envoyer, fermer, relayer quatre événements. Toute l'orchestration —
376
+ état, reconnexion, battement de cœur, statistiques — vit au-dessus.
377
+
378
+ Cette séparation a une conséquence directe et très utile : le client accepte une **fabrique de
379
+ transport** injectée en second argument de son constructeur
380
+ (`client/realtime/RealtimeClient.ts:223`). Les tests branchent un transport factice et exercent toute
381
+ la machine à états **sans ouvrir une seule socket**. C'est ce qui rend les 177 cas de test de cette
382
+ page possibles hors navigateur.
383
+
384
+ ### Ce que le client alloue — et ce qu'il n'alloue pas
385
+
386
+ Un onglet ouvert huit heures ne pardonne pas les allocations gratuites. Les choix visibles au code :
387
+
388
+ - **Le journal de protocole est différé.** Chaque trame est poussée dans un anneau borné à 300
389
+ entrées sous forme de **référence brute** ; la mise en forme et le masquage des secrets ne sont
390
+ faits qu'à la **lecture** — `recordFrame()` (`client/realtime/RealtimeClient.ts:1308`). Un
391
+ inspecteur qu'on n'ouvre jamais ne coûte donc presque rien.
392
+ - **Les secrets ne transitent pas en clair dans l'inspecteur.** `redactFrame()`
393
+ (`client/realtime/RealtimeClient.ts:157`) remplace toute clé ressemblant à un jeton, un mot de
394
+ passe ou une autorisation, avec une profondeur bornée.
395
+ - **Ce qui n'a pas servi n'existe pas.** L'anneau de trames, l'identité et les capacités annoncées
396
+ démarrent à `null` et ne sont alloués qu'au premier usage.
397
+ - **L'échantillonnage de débit ne retient pas le processus.** Le minuteur de statistiques est
398
+ déréférencé (`client/realtime/RealtimeClient.ts:949`) — utile quand le même code tourne dans un
399
+ test Node.
400
+
401
+ ## ⚡ Cadence adaptative — une capacité du CLIENT
402
+
403
+ Voici le point le plus contre-intuitif de la lib, et son meilleur argument : **c'est le navigateur
404
+ qui décide à quel rythme il veut être servi**, sans que le serveur n'apprenne quoi que ce soit.
405
+
406
+ Le principe repose sur une convention de nommage : la cadence vit **dans le nom du canal**
407
+ (`stats` à 1 s, `stats:2000` à 2 s…). Un canal = une cadence = un ticker serveur. Changer de cadence
408
+ revient donc à **changer de canal**, opération que le client sait faire tout seul.
409
+
410
+ `AdaptiveRate` (`client/realtime/AdaptiveRate.ts:78`) est la machine à états pure qui prend la
411
+ décision — aucun minuteur, aucune socket, donc parfaitement déterministe et testable. Elle applique la
412
+ loi AIMD de TCP :
413
+
414
+ | Situation observée | Décision | Rythme |
415
+ | ------------------------------------------------------ | ---------------------------------- | -------- |
416
+ | L'écart entre trames dépasse 1,8 × la cadence (famine) | on **grossit** d'un cran l'échelle | immédiat |
417
+ | L'écart reste sous 1,25 × la cadence, 4 fois de suite | on **affine** d'un cran | lent |
418
+ | Entre les deux (bande morte) | on ne change rien | — |
419
+
420
+ L'asymétrie est délibérée : on recule vite sous pression, on revient doucement. C'est exactement ce
421
+ qui empêche l'oscillation, et la bande morte empêche le va-et-vient autour du seuil.
422
+
423
+ Deux détecteurs se complètent. `AdaptiveRate.noteFrame()`
424
+ (`client/realtime/AdaptiveRate.ts:134`) mesure l'écart **à chaque trame reçue** ; mais si le flux
425
+ s'arrête complètement, il n'y a plus de trame pour déclencher quoi que ce soit — d'où le chien de
426
+ garde `AdaptiveRate.checkStarvation()` (`client/realtime/AdaptiveRate.ts:171`), appelé
427
+ périodiquement, qui voit la famine **totale**.
428
+
429
+ Le câblage à une socket réelle est séparé : `bindAdaptiveChannel()`
430
+ (`client/realtime/AdaptiveRate.ts:239`) s'abonne au nouveau canal **avant** de couper l'ancien, ce
431
+ qui évite le trou de quelques centaines de millisecondes qu'on obtiendrait dans l'ordre inverse.
432
+
433
+ ```typescript ignore
434
+ // Un tableau de bord d'état : on VEUT 1 s, on ACCEPTE de reculer si ça souffre.
435
+ const binding = socket.adaptiveChannel(
436
+ "nodefony:dashboard",
437
+ (payload) => render(payload),
438
+ {
439
+ intervalMs: 1000,
440
+ onRate: (ms, reason) => setBadge(`${ms} ms (${reason})`),
441
+ },
442
+ );
443
+ // …plus tard
444
+ binding.dispose(); // coupe le chien de garde, l'écouteur ET l'abonnement
445
+ ```
446
+
447
+ > [!CAUTION]
448
+ > Réservé aux canaux d'**état** (latest-wins : supervision, statistiques), où sauter une valeur
449
+ > intermédiaire est sans conséquence. Sur un canal d'**événements** (journal, messages de chat), chaque
450
+ > élément compte : décimer perdrait des données. Ces flux-là se **regroupent**, ils ne se décime pas.
451
+ > Le réglage `enabled: false` (`client/realtime/AdaptiveRate.ts:200`) bascule en abonnement fixe sans
452
+ > changer le code appelant.
453
+
454
+ ## 🔐 Les rôles isomorphes — de l'ergonomie, jamais une garantie
455
+
456
+ Le subpath `nodefony/roles` fournit des fonctions **pures**, sans état ni dépendance, utilisables
457
+ telles quelles des deux côtés.
458
+
459
+ | Outil | Ancre | Coût | Quand l'employer |
460
+ | --------------- | ----------------------------- | ---------------------------------- | --------------------------------------------- |
461
+ | `hasRole()` | `client/roles/roles.ts:19` | zéro allocation, parcours linéaire | Un contrôle ponctuel |
462
+ | `hasAnyRole()` | `client/roles/roles.ts:34` | idem | « L'un de ces rôles suffit » |
463
+ | `hasAllRoles()` | `client/roles/roles.ts:51` | idem | « Tous ces rôles sont requis » |
464
+ | `RoleSet` | `client/roles/roles.ts:69` | 1 allocation, puis O(1) | Contrôles **répétés** sur le même utilisateur |
465
+ | `RoleRegistry` | `client/roles/registry.ts:27` | masques binaires, O(1) sans alloc | Ensemble **fixe** de rôles, chemin chaud |
466
+
467
+ Deux conventions à connaître, parce qu'elles surprennent au premier essai :
468
+
469
+ - `hasAnyRole()` avec une liste d'exigences **vide** rend `false` — aucune exigence ne peut être
470
+ satisfaite. `hasAllRoles()` avec une liste vide rend `true`, comme `Array.every`. Les deux sont
471
+ cohérentes avec la logique, pas entre elles.
472
+ - `RoleRegistry` est plafonné à 31 rôles — `ROLE_MASK_CAPACITY`
473
+ (`client/roles/registry.ts:11`) — parce que les opérateurs binaires de JavaScript travaillent sur
474
+ des entiers 32 bits **signés**. Au-delà, on reste sur les chaînes. Il est aussi inadapté aux rôles
475
+ **créés dynamiquement** en base : ils n'ont pas de bit fixe.
476
+
477
+ > [!IMPORTANT]
478
+ > Ces contrôles sont de l'**ergonomie**, jamais une sécurité. Le navigateur exécute du code que
479
+ > l'utilisateur contrôle : masquer un bouton n'empêche personne d'appeler la route. L'**autorité reste
480
+ > le serveur** — le pare-feu applicatif et les jurys d'autorisation décident, et refusent, quoi qu'ait
481
+ > affiché le front. Le bon usage : ne pas montrer une action qui sera de toute façon refusée. Voir
482
+ > [la sécurité du temps réel](../../../src/packages/@nodefony/realtime/docs/securite.md).
483
+
484
+ ## 🧩 La barre de debug, le stockage et les shims
485
+
486
+ Trois briques secondaires, qu'on touche rarement — mais qu'il vaut mieux connaître avant de les
487
+ croiser.
488
+
489
+ ### `nodefony/debugbar` — voir le framework respirer
490
+
491
+ Une barre de développement type « bandeau de profilage », montée par `mountDebugBar()`
492
+ (`client/debugbar/index.ts:46`). Elle ouvre **la même** socket temps réel que le reste de la page,
493
+ intercepte les appels réseau et affiche la cascade des phases serveur d'une requête. Rendue en Shadow
494
+ DOM, sans aucune dépendance d'interface.
495
+
496
+ En pratique tu ne l'appelles pas : en développement, `@nodefony/frontend` l'injecte lui-même dans la
497
+ page, en la résolvant depuis le paquet installé (`ViteConfigGenerator.ts:135`). Tu l'appelles à la
498
+ main uniquement sur une page **hors Vite**, où le bundle autonome fait office d'alternative.
499
+
500
+ Le subpath expose aussi son **modèle pur** — `computeWaterfall()`
501
+ (`client/debugbar/profile.ts:168`) et `NetworkModel` (`client/debugbar/profile.ts:91`) — sans une
502
+ ligne de DOM. C'est ce qui permet à Studio d'afficher la même cascade dans son écran de profilage
503
+ sans recopier le calcul.
504
+
505
+ ### Les shims — pourquoi ton code Node compile dans un onglet
506
+
507
+ Deux modules Node sont remplacés au build par des équivalents navigateur de quelques dizaines de
508
+ lignes : `EventEmitter` (`client/shim/events.ts:15`) couvre exactement l'API que le bus d'événements
509
+ du cœur appelle réellement, et `inspect` (`client/shim/util.ts:5`) rend un affichage lisible via
510
+ `JSON.stringify`. La façade de couleur, elle, devient l'identité (`client/shim/util.ts:20`) : il n'y a
511
+ pas de terminal dans un navigateur, donc jamais de code d'échappement.
512
+
513
+ Tu ne les importes jamais — ils sont substitués au moment du build. Leur seul intérêt pour toi est de
514
+ savoir **où sont les limites** : ce sont des shims, pas des implémentations complètes. Le shim
515
+ d'événements ne distingue pas un écouteur « une fois » d'un écouteur ordinaire, et ne gère pas
516
+ l'événement `error` spécial de Node.
517
+
518
+ ### Le kernel client — un contrat qui n'est pas encore publié
519
+
520
+ `IClientKernel` (`client/IClientKernel.ts:172`) décrit le futur chef d'orchestre de la couche
521
+ technique d'une application front : composition de services, cycle de vie navigateur, changement
522
+ d'identité. Le registre de services `NodefonyClientServices` (`client/IClientKernel.ts:100`) s'étend
523
+ par augmentation de module, comme le registre de configuration côté serveur.
524
+
525
+ **Tu ne peux pas encore l'importer**, et c'est délibéré : il a d'abord été publié en types seulement,
526
+ puis retiré de la surface avant que la 10.0.0 ne le gèle. Personne ne l'implémentait, donc le
527
+ compilateur ne l'avait jamais vérifié — et il portait deux défauts que la première implémentation
528
+ aurait révélés. Une fois publié, les corriger aurait demandé une version majeure ; l'ajouter une
529
+ fois qu'une application réelle l'exerce ne demandera qu'une mineure. La spécification, elle, vaut
530
+ toujours : elle est dans le dépôt, et l'ADR-0007 en donne les onze décisions.
531
+
532
+ ## 🏗️ Comment la lib arrive dans ton bundle
533
+
534
+ Rien de spécial à configurer : `@nodefony/frontend` pilote Vite, et Vite résout `nodefony/client`
535
+ comme n'importe quel paquet du dossier `node_modules`. Trois points valent d'être connus.
536
+
537
+ 1. **La condition `browser` fait le tri.** Dans un bundle navigateur, `import … from "nodefony"`
538
+ résout le barrel client ; dans un fichier serveur, le barrel Node. Le même import, deux
539
+ destinations — c'est le mécanisme central, et aussi la source du piège numéro un de cette page.
540
+ 2. **La barre de debug est autorisée explicitement.** Vite refuse par défaut de servir un fichier hors
541
+ de la racine du projet. Le générateur de configuration ajoute le dossier de la lib cliente à la
542
+ liste autorisée (`ViteConfigGenerator.ts:135`), sans quoi une application liée en développement
543
+ verrait la barre répondre en refus d'accès.
544
+ 3. **En production, seul ce que tu importes part.** Les quatre subpaths sont des entrées séparées :
545
+ ce que tu n'importes pas n'est pas dans le bundle.
546
+
547
+ Le détail du builder, du rechargement à chaud et du rendu de la page côté serveur est dans
548
+ [la doc de `@nodefony/frontend`](../../../src/packages/@nodefony/frontend/docs/index.md).
549
+
550
+ ## ⚠️ Pièges (symptôme → cause → correction)
551
+
552
+ | Symptôme | Cause (dans le code) | Correction |
553
+ | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
554
+ | `Cannot find module 'nodefony/realtime'` | Ce subpath **n'existe pas** — le champ `exports` n'en déclare que quatre | Importer depuis `nodefony/client` |
555
+ | `has no exported member 'RealtimeClient'` dans un fichier front | Import depuis `"nodefony"` typé par la condition **Node** (outil sans condition `browser`) | Importer explicitement depuis `nodefony/client` |
556
+ | `RealtimeIdentity` introuvable à l'import | Version antérieure : le type n'était réexporté ni par `nodefony/client` ni par `nodefony/react` | Corrigé — `import type { RealtimeIdentity } from "nodefony/client"` (ou `nodefony/react`) |
557
+ | Le canal est silencieux, aucun message | `on()` installé sans `subscribe()` — le serveur ne pousse pas | Appeler les deux (`client/realtime/RealtimeClient.ts:485`) |
558
+ | Un composant démonté coupe le flux d'un autre | Attendu et **déjà traité** : les abonnements sont ref-comptés | Ne pas contourner l'API en émettant `unsubscribe` à la main |
559
+ | Après une reconnexion, plus rien n'arrive | Le serveur repart d'un état vide ; le client ré-émet ses abonnements | Comportement natif ; vérifier que l'abonnement passe bien par `subscribe()` |
560
+ | La reconnexion ne repart jamais | Fermeture **définitive** (1008 = 401/403 traduit), reconnexion volontairement coupée | Corriger la cause (se connecter) puis `retryNow()` (`client/realtime/RealtimeClient.ts:370`) |
561
+ | Deux connexions WebSocket pour la même page | Deux `new RealtimeClient(…)` au lieu de l'instance partagée | `RealtimeClient.shared()` (`client/realtime/RealtimeClient.ts:295`) |
562
+ | Les trames envoyées juste après la connexion sont perdues | `send()` abandonne la trame tant que le transport n'est pas ouvert (`client/realtime/RealtimeClient.ts:188`) | Émettre après la résolution de `connect()` |
563
+ | La cadence adaptative « perd » des messages | Employée sur un canal d'**événements**, où décimer supprime des éléments | La réserver aux canaux d'état, ou passer `enabled: false` |
564
+ | `hasAnyRole(roles, [])` rend `false` et surprend | Aucune exigence ne peut être satisfaite (`client/roles/roles.ts:34`) | Convention assumée ; `hasAllRoles` avec une liste vide rend `true` |
565
+ | `RoleRegistry` lève au 32ᵉ rôle | Limite des entiers 32 bits signés (`client/roles/registry.ts:11`) | Rester sur les chaînes / `RoleSet` au-delà de 31 rôles |
566
+ | Un bouton masqué au front reste appelable | Le RBAC client est de l'ergonomie, pas un contrôle | Protéger la route côté serveur — c'est lui l'autorité |
567
+ | Deux instances de React après ajout de `nodefony/react` | React empaqueté au lieu d'être externe | Déjà traité au build (`rolldown.config.ts:94`) ; vérifier ses propres alias |
568
+
569
+ ## 🧪 Tests & couverture
570
+
571
+ Le client isomorphe est couvert par **177 cas** répartis sur **15 fichiers**, tous unitaires et tous
572
+ exécutés **hors navigateur** — c'est l'injection de transport qui le permet.
573
+
574
+ - **La machine à états et le transport** : ouverture, reconnexion à délai croissant, battement de
575
+ cœur, transport factice, distinction transitoire/définitif
576
+ (`RealtimeClientTransport.test.ts`, `RealtimeClientCoverage.test.ts`).
577
+ - **Le routage des trames** : classification requête/notification/réponse, dispatch vers les
578
+ écouteurs, joker, ingestion de la trame de bienvenue (`RealtimeClientDispatch.test.ts`,
579
+ `RealtimeClientIdentity.test.ts`).
580
+ - **Le protocole lui-même** : corrélation d'identifiants, délais, erreurs, flux en morceaux, actions
581
+ entrantes (`JsonRpcPeer.test.ts` — 30 cas, le plus fourni).
582
+ - **Les types comme test** : deux fichiers vérifient des propriétés de typage, dont la limite connue
583
+ de la surcharge historique de `request` (`RealtimeClient.types.test.ts`,
584
+ `JsonRpcPeer.types.test.ts`).
585
+ - **Les notices et les codes de fermeture** : la table RFC 6455 cas par cas, le silence sur les
586
+ fermetures propres, la reconnectabilité (`RealtimeNotice.test.ts` — 19 cas).
587
+ - **La cadence adaptative** : décrue immédiate, reprise après fenêtre, bande morte, chien de garde,
588
+ échelle dérivée — avec horloge et planificateur injectés (`AdaptiveRate.test.ts` — 17 cas).
589
+ - **Les rôles** (`roles.test.ts`), **le shim d'événements** (`clientShimEvents.test.ts`), **la barre
590
+ de debug** et **son modèle de profilage** (`DebugBar.test.ts`, `Profiler.client.test.ts`).
591
+
592
+ Ce qui **manque**, et qu'il faut savoir :
593
+
594
+ - **Aucun test de bout en bout dans un vrai navigateur.** Tout est exercé en Node avec un transport
595
+ factice. Les comportements réellement navigateur — normalisation d'URL par `window.location`,
596
+ `sessionStorage`, montage en Shadow DOM — ne sont donc pas couverts par une exécution réelle.
597
+ - **Aucun banc de charge ni de mémoire côté client.** Les choix d'allocation décrits plus haut sont
598
+ lisibles au code mais ne sont pas mesurés par une suite : pas d'équivalent client au gate mémoire du
599
+ pipeline serveur (skill `nodefony-check-memory-health`).
600
+ - **Aucun test d'attaque** (`*.attack.test.ts`) sur le masquage de l'inspecteur de trames — un
601
+ candidat naturel pour une campagne `nodefony-security-review`.
602
+
603
+ Couverture : `npm run coverage` dans `src/nodefony`. Les chiffres exacts vivent dans le rapport
604
+ vitest, jamais figés ici.
605
+
606
+ ## 🔗 Pour aller plus loin
607
+
608
+ - ⬆️ **Retour au hub** : [@nodefony/core — vue d'ensemble](index.md) · [Toute la documentation](../../../docs/index.md)
609
+ - 🧭 **Pages sœurs** : [Hooks React `nodefony/react`](react-hooks.md) — les bindings qui câblent tout
610
+ ça dans un composant · [Service et événements](service.md) — la classe de base, isomorphe elle
611
+ aussi · [Journalisation](syslog.md) — le `Syslog` qui tourne aussi dans l'onglet
612
+ - Le serveur en face : [la socket Nodefony](../../../src/packages/@nodefony/realtime/docs/index.md) ·
613
+ [son architecture](../../../src/packages/@nodefony/realtime/docs/architecture.md) ·
614
+ [son vocabulaire](../../../src/packages/@nodefony/realtime/docs/vocabulaire.md)
615
+ - Un exemple complet de bout en bout → [Cookbook — un chat](../../../src/packages/@nodefony/realtime/docs/cookbook-chat.md)
616
+ - Comment le bundle arrive au navigateur → [`@nodefony/frontend`](../../../src/packages/@nodefony/frontend/docs/index.md)