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
@@ -0,0 +1,1255 @@
1
+ import cluster from "node:cluster";
2
+ import os from "node:os";
3
+ import FileClass from "../FileClass.js";
4
+ import Service, { DefaultOptionsService } from "../Service.js";
5
+ import Command, { CommandArgs } from "../command/Command.js";
6
+ import { Severity } from "../syslog/Pdu.js";
7
+ import { DebugType, EnvironmentType } from "../types/globals.js";
8
+ import CliKernel from "./CliKernel.js";
9
+ import Module from "./Module.js";
10
+ import Injector from "./injector/injector.js";
11
+ import type { IKernel } from "../types/IKernel.js";
12
+ import type { IModuleManifest } from "../types/IModuleManifest.js";
13
+ import type { IInfra, IStoreResolution } from "../config/infra.js";
14
+ import type { IGuardedEmitResult } from "../Event.js";
15
+ import type { IBootReport } from "./bootReport.js";
16
+ import type { IReadinessContributor } from "./readinessRegistry.js";
17
+ export interface TypeKernelOptions extends DefaultOptionsService {
18
+ node_start?: NodefonyStartType;
19
+ /**
20
+ * Manifeste déclaratif des modules de l'app (liste ordonnée, gatable par
21
+ * `policy`/`when`/environnement). Lu et orchestré par le Kernel à
22
+ * `onPreRegister`. Remplace l'usage du décorateur `@modules` côté app.
23
+ * Cf `project_module_loading_architecture` (mémoire IA).
24
+ */
25
+ modules?: IModuleManifest;
26
+ /**
27
+ * Deadline GLOBALE du shutdown (ms) — cf `AppConfigInput.shutdownDeadline`
28
+ * (config/types.ts). Au-delà, {@link Kernel.terminate} force la sortie code 1
29
+ * même si un listener `onTerminate` pend. `0` = filet désactivé.
30
+ */
31
+ shutdownDeadline?: number;
32
+ log?: {
33
+ active?: boolean;
34
+ /**
35
+ * Répertoire des fichiers de log (relatif au cwd, défaut `"logs"`) — où sont
36
+ * écrits le sink texte `nodefony-<pid>.log` (LB.W) ET le JSONL queryable
37
+ * `nodefony-<pid>.jsonl` (LB.2/5). Source UNIQUE : le Kernel y écrit, et le
38
+ * viewer de fichiers Studio (`/nodefony/syslog/api/files`) y lit → cohérent.
39
+ * Remplace l'ancien pointage sur `tmpDir`. Un chemin absolu dans `file.path`/
40
+ * `queryFile.path` reste prioritaire (override par fichier).
41
+ */
42
+ dir?: string;
43
+ debug?: DebugType;
44
+ /** Coalescing des writes stdout par tick : "auto" (hors TTY) | true | false. */
45
+ buffered?: boolean | "auto";
46
+ /** Driver de sink (LB.W) : "stdout" (défaut) | "file" (fd async/worker) | "null" (bench). */
47
+ driver?: "stdout" | "file" | "null";
48
+ /** Options du driver "file" (chemin du log ; défaut logs/nodefony-<pid>.log ; sync=write direct). */
49
+ file?: {
50
+ path?: string;
51
+ sync?: boolean;
52
+ };
53
+ /**
54
+ * Driver du **Log Backplane** (axe DESTINATION queryable, LB.0+) — où l'on
55
+ * RELIT les logs : "memory" (défaut, ring buffer ; dev) | "file" (LB.2, JSONL
56
+ * du worker courant) | "cluster-file" (LB.5, agrège les `nodefony-*.jsonl` de
57
+ * TOUS les workers = vue cluster) | "elastic"/"loki" (LB.4, si enregistré).
58
+ * Orthogonal à `driver` (sink write texte) et au bus temps réel `nodefony:syslog`.
59
+ * En prod = figé ici/env (12-factor) ; le switch à la volée est une action de
60
+ * contrôle dev-only.
61
+ */
62
+ queryDriver?: string;
63
+ /**
64
+ * Taille du **ring buffer** de logs en mémoire (nombre de Pdu conservés pour
65
+ * la relecture par le driver `memory` + le snapshot Studio). Défaut **100**
66
+ * (prod-safe) ; **2000 en développement** si non précisé → assez profond pour
67
+ * tracer une requête complète (appel DB inclus) sans que le bruit de fond ne
68
+ * l'évince. Borné en RAM : c'est une fenêtre glissante, pas une persistance.
69
+ */
70
+ maxStack?: number;
71
+ /**
72
+ * Options du driver de relecture `file` (LB.2) / `cluster-file` (LB.5) — actif
73
+ * UNIQUEMENT si `queryDriver` vaut l'un des deux. `path` = fichier JSONL ÉCRIT
74
+ * par ce worker (défaut `logs/nodefony-<pid>.jsonl`) ; `maxScanBytes` = plafond
75
+ * d'octets relus depuis la FIN à chaque query (anti-OOM, défaut 8 MiB, appliqué
76
+ * PAR fichier en mode cluster). Quand actif, un transport file `format:"json"`
77
+ * est branché pour ÉCRIRE ce JSONL (cohérence write↔read). En `cluster-file`,
78
+ * la lecture agrège le DOSSIER de `path` (tous les `nodefony-*.jsonl`).
79
+ */
80
+ queryFile?: {
81
+ path?: string;
82
+ maxScanBytes?: number;
83
+ };
84
+ /**
85
+ * Options du driver de relecture `loki` (LB.4) — actif UNIQUEMENT si
86
+ * `queryDriver === "loki"`. `url` = base Loki (ex. `http://127.0.0.1:3100`).
87
+ * Quand actif, un {@link LokiTransport} batché est branché pour POUSSER les logs
88
+ * (`/loki/api/v1/push`) et le driver les RELIT en LogQL (write↔read cohérents).
89
+ * Opt-in strict (jamais en dev « au cas où ») ; figé par config/env en prod.
90
+ */
91
+ loki?: {
92
+ url: string;
93
+ labels?: Record<string, string>;
94
+ tenantId?: string;
95
+ batchSize?: number;
96
+ flushIntervalMs?: number;
97
+ maxQueue?: number;
98
+ maxScanLines?: number;
99
+ };
100
+ /**
101
+ * Options du driver de relecture `opensearch` (LB.4) — actif UNIQUEMENT si
102
+ * `queryDriver === "opensearch"`. `url` = base OpenSearch (ex. `http://127.0.0.1:9200`),
103
+ * `index` (défaut `nodefony-logs`), `username`/`password` (auth basic prod). Write
104
+ * via `/_bulk`, read via `/_search`. Opt-in strict ; figé par config/env en prod.
105
+ */
106
+ opensearch?: {
107
+ url: string;
108
+ index?: string;
109
+ username?: string;
110
+ password?: string;
111
+ batchSize?: number;
112
+ flushIntervalMs?: number;
113
+ maxQueue?: number;
114
+ maxHits?: number;
115
+ };
116
+ };
117
+ }
118
+ interface MemoryStats {
119
+ rss: number;
120
+ heapTotal: number;
121
+ heapUsed: number;
122
+ external: number;
123
+ }
124
+ interface Stats {
125
+ memory: MemoryStats;
126
+ }
127
+ /**
128
+ * Dérogation au gating `policy:"dev"` en production — posée à `1`, les modules de
129
+ * développement sont chargés malgré le mode.
130
+ *
131
+ * Existe pour éprouver un runtime de production AVEC les briques de banc (une suite
132
+ * d'intégration interroge des routes qu'un module `policy:"dev"` porte, et qui
133
+ * n'existent donc pas là-bas : tout répond 404). Réservée aux bancs et au
134
+ * diagnostic — chaque module chargé par dérogation est journalisé en WARNING, et
135
+ * la variable n'a **aucun effet** hors production.
136
+ */
137
+ export declare const FORCE_DEV_MODULES_ENV = "NF_WITH_DEV_MODULES";
138
+ /**
139
+ * Durée de vie d'un runtime de production qui a dérogé au gating des modules dev.
140
+ *
141
+ * La variable seule ne protège de rien : elle s'oublie, dans une image, un manifeste
142
+ * de déploiement, un fichier d'environnement recopié — et le jour où elle survit à
143
+ * une mise en production, plus rien ne le dit. Un runtime en dérogation **s'arrête
144
+ * donc tout seul** : l'oubli devient un incident immédiat et lisible plutôt qu'une
145
+ * surface offerte pour des mois. Large devant toute suite de tests (les tâches
146
+ * d'intégration continue du dépôt expirent à 20 minutes), dérisoire devant la durée
147
+ * de vie d'un déploiement.
148
+ */
149
+ export declare const FORCE_DEV_MODULES_TTL_MS: number;
150
+ /**
151
+ * Plafond DUR de cette durée de vie. Un banc de charge légitime dure plus qu'une
152
+ * suite d'intégration, d'où le réglage ci-dessous — mais aucune valeur ne désarme
153
+ * la minuterie : une protection qu'on peut annuler par la même variable que celle
154
+ * qu'elle protège n'en est pas une.
155
+ */
156
+ export declare const FORCE_DEV_MODULES_TTL_MAX_MS: number;
157
+ /** Variable de réglage de la durée de vie, en MINUTES (bornée par le plafond dur). */
158
+ export declare const FORCE_DEV_MODULES_TTL_ENV = "NF_WITH_DEV_MODULES_TTL_MIN";
159
+ /**
160
+ * Durée de vie effective d'un runtime en dérogation — fonction PURE.
161
+ *
162
+ * @param env - environnement à lire (injecté : la règle s'éprouve sans toucher au process).
163
+ * @returns la durée en millisecondes, toujours comprise entre le défaut et le plafond.
164
+ */
165
+ export declare function resolveDevModulesTtlMs(env: Record<string, string | undefined>): number;
166
+ type ClusterType = "master" | "worker";
167
+ type NodefonyStartType = "CONSOLE" | "NODEFONY" | "NODEFONY_CONSOLE";
168
+ type EventsType = Record<string, number>;
169
+ declare const Events: Readonly<EventsType>;
170
+ export type KernelEventsType = keyof typeof Events;
171
+ /**
172
+ * Durée de vie d'un run : `"oneshot"` = fait sa tâche puis le process sort (build,
173
+ * install, help) ; `"longrunning"` = reste vivant jusqu'à un signal (serveur, daemon,
174
+ * REPL) — maintenu soit par un socket en écoute, soit par un park explicite.
175
+ */
176
+ export type RunLifetime = "oneshot" | "longrunning";
177
+ /**
178
+ * Profil d'exécution d'un run — remplace l'ancien binaire `KernelType` (SERVER/CONSOLE)
179
+ * qui écrasait 3 axes orthogonaux en un seul drapeau. Déclaré par chaque commande.
180
+ *
181
+ * - `servers` — monte des serveurs réseau HTTP/WS.
182
+ * - `lifetime` — voir {@link RunLifetime}.
183
+ * - `interactive` — a besoin d'un TTY (REPL, menu). Consommé au câblage REPL (différé).
184
+ *
185
+ * Note : le démarrage réel des serveurs reste piloté par `kernelEvent` + la présence du
186
+ * `HttpKernel`. En revanche `lifetime` est désormais EFFECTIF : à la fin d'un run sans
187
+ * serveur, le Kernel parke (daemon) ou terminate (one-shot) — cf {@link Kernel.finishOrPark}
188
+ * et {@link Kernel.park} (source unique du park, ex-`new Promise(()=>{})` inline).
189
+ */
190
+ export interface IRunProfile {
191
+ servers: boolean;
192
+ lifetime: RunLifetime;
193
+ interactive: boolean;
194
+ }
195
+ /** Profil par défaut — équivaut à l'ancien `type = "CONSOLE"` (one-shot, sans serveur). */
196
+ export declare const CONSOLE_RUN_PROFILE: Readonly<IRunProfile>;
197
+ interface AppEnvironmentType {
198
+ environment: EnvironmentType | string;
199
+ }
200
+ export interface NetworkInterface {
201
+ [name: string]: os.NetworkInterfaceInfo[];
202
+ }
203
+ export type FamilyType = "IPv4" | "IPv6";
204
+ export interface FilterInterface {
205
+ type?: "local" | "external";
206
+ family?: FamilyType;
207
+ condition?: "&&" | "||" | "==";
208
+ }
209
+ /**
210
+ * Interface-marqueur du **hook de cycle de vie async de boot** (pattern NestJS
211
+ * `OnModuleInit`). Un service qui implémente `init` est initialisé une fois
212
+ * au démarrage — par {@link Kernel.addKernelService} (service kernel) ou
213
+ * {@link Module.addService} (service de module) — sous garde de boot
214
+ * ({@link Kernel.guardInitialize} : timeout + politique de criticité).
215
+ *
216
+ * C'est LE hook standard : ne pas réinventer `boot()`/`connect()`/`onConnect()`.
217
+ * Hook **optionnel** (pas de méthode no-op forcée sur {@link Service} : éviterait
218
+ * une microtask par service sans init — règle perf). Distinct du hook
219
+ * **per-request** des controllers (`ControllerWithInitialize.initialize`, hot
220
+ * path, non gardé) : les deux noms restent volontairement disjoints (`init` =
221
+ * boot une fois ; `initialize` = par requête) — pas de collision sur un
222
+ * Controller qui est aussi un Service.
223
+ *
224
+ * @remarks `owner` = le {@link Module} (service de module) ou le {@link Kernel}
225
+ * (service kernel) propriétaire. Retour `Promise<this>` — l'implémenteur renvoie
226
+ * son instance typée.
227
+ */
228
+ export interface ServiceWithInit extends Service {
229
+ init?(owner?: Module<unknown> | Kernel): Promise<this>;
230
+ }
231
+ export interface ServiceConstructor {
232
+ new (...args: any[]): ServiceWithInit;
233
+ _inject?: {
234
+ [key: number]: string;
235
+ };
236
+ }
237
+ export interface ModuleConstructor {
238
+ new (kernel: Kernel, ...args: any[]): Module;
239
+ }
240
+ type trunkType = "javascript" | "typescript" | null;
241
+ /**
242
+ * Orchestrateur central de Nodefony — gère le boot, les modules, le DI Container racine,
243
+ * et expose les events lifecycle auxquels services/modules se branchent.
244
+ *
245
+ * Hérite de {@link Service} → bénéficie DI, EventEmitter, Syslog. Pollue le singleton
246
+ * `Nodefony.#kernel` au constructor (`Nodefony.setKernel(this)`) — isoler les tests avec
247
+ * un mock minimal.
248
+ *
249
+ * **Lifecycle phases** (chronologiques, jamais régressives) :
250
+ * `started → preRegistered → registered → booted → ready → postReady`
251
+ *
252
+ * **Events bitmask** (`progress` = OR cumulatif) :
253
+ * - `onInit=1`, `onPreStart=2`, `onStart=4`
254
+ * - `onPreRegister=8`, `onRegister=16`
255
+ * - `onPreBoot=32`, `onBoot=64`
256
+ * - `onReady=128`, `onServersReady=256`, `onPostReady=512`
257
+ * - `onTerminate=1024`
258
+ *
259
+ * **Chaîne async** (chaque maillon appelle le suivant si `!setCommandComplete`) :
260
+ * `start() → preRegister() → boot() → onReady() → initServers()`
261
+ *
262
+ * @example
263
+ * ```ts
264
+ * import { CliKernel } from "nodefony";
265
+ * const cli = new CliKernel("development");
266
+ * await cli.start(); // → new Kernel(env, cli) → kernel.start() → boot complet
267
+ * ```
268
+ */
269
+ declare class Kernel extends Service implements IKernel {
270
+ #private;
271
+ Events: Readonly<EventsType>;
272
+ runProfile: IRunProfile;
273
+ version: string;
274
+ started: boolean;
275
+ booted: boolean;
276
+ ready: boolean;
277
+ postReady: boolean;
278
+ /**
279
+ * Composants qui RETIENNENT la mise en service (cf `readinessRegistry.ts`).
280
+ *
281
+ * `null` tant que personne ne s'inscrit — et de nouveau `null` quand le
282
+ * dernier contributeur se retire : la sonde `/readyz` est sur le chemin le
283
+ * plus chaud du framework, elle ne doit rien payer pour un mécanisme dont
284
+ * aucune application ne se sert. Lire {@link Kernel.readinessBlocked}.
285
+ */
286
+ private readiness;
287
+ /**
288
+ * Supprime les bannières serveurs « Server Listen on… » (`showBanner`) — posé
289
+ * par le `BootReporter` animé (dev TTY non-debug) : le bloc « ✓ Prêt » liste
290
+ * déjà les URLs, ces logs feraient doublon. Reste `false` en prod/CI/`--debug`
291
+ * → bannières affichées (aucun changement hors écran de boot animé).
292
+ */
293
+ suppressBootBanners: boolean;
294
+ trunk: trunkType;
295
+ private _appEntry;
296
+ core: boolean;
297
+ command: Command | null;
298
+ commandArgs: CommandArgs;
299
+ preRegistered: boolean;
300
+ registered: boolean;
301
+ app: Module | null;
302
+ cli: CliKernel | null;
303
+ /**
304
+ * Mode MOTEUR par défaut, quand RIEN ne le dit.
305
+ *
306
+ * 🔴 `development`, et c'est un choix de sûreté — pas de confort. Le défaut
307
+ * ne s'applique que si `NODE_ENV` est absent ET que la commande n'exprime
308
+ * aucune intention. Or cette information ne manque JAMAIS en production : le
309
+ * `Dockerfile` généré pose `ENV NODE_ENV=production`, tout orchestrateur pose
310
+ * la variable, et les trois lanceurs posent leur mode eux-mêmes
311
+ * (`ProdCommand`, `DevCommand`, `ClusterCommand`). Elle ne manque que sur un
312
+ * poste de développement — le défaut doit donc protéger CE cas.
313
+ *
314
+ * L'ancien défaut `production` a produit trois défauts constatés : un jeton
315
+ * émis contre la mauvaise configuration, une inspection qui montrait les
316
+ * modules de production sur une machine de développement, et un contrôle de
317
+ * banc qui comparait deux applications différentes. Aucun n'a levé d'erreur :
318
+ * deviner « production » là où l'on est manifestement en développement est
319
+ * une dégradation SILENCIEUSE, ce que ce framework s'interdit.
320
+ *
321
+ * Il était de surcroît incohérent avec lui-même : la cascade `.env` ne
322
+ * chargeait alors NI `.env.production` ni `.env.development` (le lanceur
323
+ * rendait `undefined`), si bien que l'application se déclarait en production
324
+ * sans en avoir la configuration.
325
+ */
326
+ environment: EnvironmentType;
327
+ debug: DebugType;
328
+ appEnvironment: AppEnvironmentType;
329
+ path: string;
330
+ typeCluster: ClusterType;
331
+ pid: number;
332
+ workerId: number | undefined;
333
+ worker: cluster.Worker | undefined;
334
+ console: boolean;
335
+ /**
336
+ * Vrai terminal disponible ? Résolu UNE fois dans le constructor (volet
337
+ * « environnement », cf {@link IKernel.isTTY}). Surchargeable via `NF_NO_TTY` (test/CI).
338
+ */
339
+ isTTY: boolean;
340
+ /**
341
+ * Timer no-op ref'd gardant l'event loop vivant pendant un {@link park} `keepAlive`
342
+ * (daemon CONSOLE sans socket). `null` tant qu'aucun park alive — lazy. Nettoyé par
343
+ * {@link terminate}.
344
+ */
345
+ private parkTimer;
346
+ /**
347
+ * Le shutdown en cours, s'il y en a un — garde de ré-entrance de
348
+ * {@link terminate}. `null` par défaut : aucune allocation tant qu'on ne
349
+ * termine pas, et un kernel ne termine qu'une fois.
350
+ */
351
+ private terminating;
352
+ /** Minuterie d'auto-arrêt d'un runtime en dérogation de modules dev (`null` = aucune). */
353
+ private devModulesStopTimer;
354
+ node_start: NodefonyStartType;
355
+ platform: NodeJS.Platform;
356
+ projectName: string;
357
+ uptime: number;
358
+ numberCpu: number;
359
+ modules: Record<string, Module>;
360
+ tmpDir?: FileClass;
361
+ /**
362
+ * Répertoire des données runtime **persistées** (`<path>/var`) — base commune des
363
+ * stores fichier (passkeys, TOTP, sessions) et bases SQLite. Gitignoré comme
364
+ * `tmpDir` → garanti créé au boot. Distinct de `tmpDir` (éphémère).
365
+ */
366
+ varDir?: FileClass;
367
+ interfaces: NetworkInterface;
368
+ domain: string;
369
+ progress: number;
370
+ injector: Injector;
371
+ /**
372
+ * Transports d'ÉCRITURE montés par {@link initializeLog} (drivers du Log
373
+ * Backplane). `initializeLog` est ré-entrant (logger précoce dans `start()`,
374
+ * puis re-init avec la config app dans `loadApp()`) : on retire ces transports
375
+ * AVANT d'en monter de nouveaux, sinon chaque `FileTransport` (nouvelle instance
376
+ * → dédup `addTransport` par référence inopérante) s'accumule et chaque log est
377
+ * écrit N× dans le JSONL. Lazy (`null` tant qu'aucun transport monté).
378
+ */
379
+ private _mountedLogTransports;
380
+ isDev: boolean;
381
+ isProd: boolean;
382
+ /**
383
+ * En dev, `BootReporter` (checklist animée) prend la main sur l'en-tête de boot
384
+ * (splash + banner `SERVER`). Quand `true`, `initCluster()` ne ré-imprime PAS le
385
+ * banner `logEnv()` (le reporter le place lui-même, dans le bon ordre). Dev-only,
386
+ * boot-only — 0 impact runtime/requête.
387
+ */
388
+ reporterOwnsHeader: boolean;
389
+ private pendingModuleAddLogs;
390
+ /**
391
+ * Échecs de boot non fatals (fail-soft) agrégés pour le {@link IBootReport}.
392
+ * **Lazy** : reste `null` tant qu'aucun module/hook n'échoue → 0 allocation sur
393
+ * un boot nominal (règle perf core).
394
+ */
395
+ private bootFailures;
396
+ /**
397
+ * Modules du manifeste volontairement NON chargés (gating `policy`/`when` de
398
+ * {@link resolveModuleEntries}), avec leur raison — un gating silencieux se lit
399
+ * comme un module perdu. **Lazy** : `null` si rien n'est gaté (cas nominal).
400
+ */
401
+ private modulesGated;
402
+ /**
403
+ * Compteurs WARNING/ERROR du journal de boot, **figés** quand `postReady` passe
404
+ * true (après, le ring syslog mélange boot et runtime). `null` = boot en cours
405
+ * → {@link getBootReport} compte à la volée.
406
+ */
407
+ private bootLogCounts;
408
+ /**
409
+ * Serveurs réellement en écoute, figés à `onPostReady`. `null` tant que le boot
410
+ * n'a pas atteint cette phase ; `[]` si profil serveur mais rien n'écoute (cas
411
+ * du garde-fou 0-serveur).
412
+ */
413
+ private bootServers;
414
+ /** Horodatage (`Date.now()`) du début de `start()` — base de `durationMs`. */
415
+ private bootStartedAt;
416
+ /**
417
+ * Lignes de détail de boot par phase (canal NEUTRE) : un module pousse via
418
+ * {@link reportBootLine} ce qu'il veut voir RACONTÉ sous sa phase (ex. un
419
+ * adapter ORM : « drizzle → sqlite »). Le core reste agnostique du contenu.
420
+ * Lazy : `null` tant qu'aucune ligne (dev-only en pratique).
421
+ */
422
+ private bootLines;
423
+ /**
424
+ * Construit le Kernel. **Side effect critique** : appelle `Nodefony.setKernel(this)` →
425
+ * écrase le singleton global. Isoler les tests avec un mock minimal pour éviter de
426
+ * polluer les autres tests qui dépendent de `Nodefony.getKernel()`.
427
+ *
428
+ * Récupère le container du CLI si présent, sinon en crée un nouveau. Initialise les
429
+ * interfaces réseau OS pour `setDomain()`. Fire `"onInit"` à la fin.
430
+ *
431
+ * @param environment - mode MOTEUR (`"development"` / `"production"`, ou leurs
432
+ * abrégés `"dev"` / `"prod"`). ⚠️ Ni `"test"` ni `"staging"` : `test` est une valeur
433
+ * de `NODE_ENV` normalisée en `runtimeEnv` (→ `ConfigContext.isTest`), et un staging
434
+ * tourne EN mode `production` — il se distingue par `APP_ENV`, pas par son moteur.
435
+ * @param cli - kernel CLI parent (fournit container, packageManager, commander). Peut être null.
436
+ * @param options - options surchargées (events.nbListeners, log, etc.).
437
+ */
438
+ constructor(environment: EnvironmentType, cli?: CliKernel | null, options?: TypeKernelOptions);
439
+ /**
440
+ * Point d'entrée du boot — et POINT DE PASSAGE UNIQUE de l'échec de démarrage.
441
+ *
442
+ * Le déroulé vit dans {@link startBoot} ; cette enveloppe ne fait qu'une
443
+ * chose : figer le bilan (`var/last-boot.json`) quand le démarrage est
444
+ * abandonné, puis relancer l'erreur inchangée. Le bilan d'un démarrage
445
+ * ABOUTI est écrit ailleurs — au moment où il est complet (cf
446
+ * {@link captureBootServers} / `onPostReady`), pas ici.
447
+ *
448
+ * Pourquoi l'échec ICI et pas dans les `catch` du pipeline : ils sont une
449
+ * douzaine, et chacun relance. Y répartir l'écriture donnerait autant
450
+ * d'implémentations d'une même règle — dont certaines seraient oubliées au
451
+ * premier ajout de phase, sans que rien ne le signale. Un seul point ne peut
452
+ * pas diverger de lui-même.
453
+ *
454
+ * Et pourquoi RIEN n'est effacé sur un succès : une commande console
455
+ * (`inspect`, une commande de module) démarre et réussit sans jamais monter
456
+ * de serveur. Effacer ici ferait disparaître le bilan d'un échec applicatif
457
+ * au premier `nodefony inspect` lancé pour le diagnostiquer — l'outil de
458
+ * diagnostic détruirait la preuve qu'il vient chercher.
459
+ *
460
+ * @returns `this` après boot complet.
461
+ * @throws Toute exception du pipeline est loggée CRITIC puis re-throw — le
462
+ * bilan n'en absorbe aucune.
463
+ */
464
+ start(): Promise<this>;
465
+ /**
466
+ * Traduit le bitmask {@link progress} en NOM de la dernière phase atteinte.
467
+ *
468
+ * C'est l'information la plus discriminante d'une trace d'échec : elle situe
469
+ * le défaut dans le cycle de vie (« mort à `onBoot` » désigne les modules,
470
+ * « mort à `onReady` » désigne les serveurs) sans qu'on ait à lire une pile.
471
+ *
472
+ * @returns le nom de la phase la plus avancée, `"onInit"` par défaut.
473
+ */
474
+ private lastReachedPhase;
475
+ /**
476
+ * Socle commun des deux bilans (abouti et abandonné) — ce qui est vrai dans
477
+ * les deux cas se remplit ICI, une seule fois.
478
+ *
479
+ * @param status - issue du démarrage.
480
+ * @returns le bilan, prêt à être complété par l'appelant.
481
+ */
482
+ private baseLastBoot;
483
+ /**
484
+ * QUI démarre — la distinction qui empêche `doctor` de désigner le mauvais
485
+ * coupable.
486
+ *
487
+ * Un `nodefony inspect` ou un `orm:migrate` boote en console et échoue
488
+ * souvent pour une raison qui ne concerne pas le serveur : un environnement
489
+ * absent du terminal où l'on tape. Sans ce champ, son bilan s'écrivait
490
+ * par-dessus celui du serveur, et le diagnostic envoyait chercher là où il
491
+ * n'y a rien.
492
+ *
493
+ * `cluster` est distingué de `server` parce que le maître ne sert AUCUNE
494
+ * requête lui-même : ses workers le font. Le critère se CONSTATE — la
495
+ * commande `cluster` dans le process primaire ; un worker forké, lui, porte
496
+ * `cluster.isWorker` et sert bien des requêtes, donc c'est un `server`.
497
+ *
498
+ * @returns le profil de ce démarrage.
499
+ */
500
+ private lastBootProfile;
501
+ /**
502
+ * Fige le bilan d'un démarrage ABOUTI.
503
+ *
504
+ * Ce n'est pas une redondance avec le journal : le bilan retient ce que le
505
+ * terminal a montré une fois puis perdu — les briques ignorées AVEC leur
506
+ * raison, celles que le gating a écartées, les comptes d'avertissements. Une
507
+ * application qui démarre amputée ne se signale plus après sa première
508
+ * seconde de vie ; c'est justement le cas que personne ne diagnostique.
509
+ *
510
+ * @param report - bilan de boot figé (serveurs capturés).
511
+ */
512
+ private writeBootSummary;
513
+ /**
514
+ * Consigne le démarrage ABANDONNÉ, sans jamais pouvoir aggraver la panne.
515
+ *
516
+ * À ne pas confondre avec {@link recordBootFailure}, qui collecte les échecs
517
+ * **non fatals** (fail-soft) d'un boot qui, lui, continue. Les deux se
518
+ * complètent, et c'est pourquoi le bilan embarque le second : quand le boot
519
+ * meurt, savoir quelles briques avaient DÉJÀ été ignorées avant désigne
520
+ * souvent la cause réelle — un module optionnel tombé emporte plus loin celle
521
+ * qui en dépendait, et seul le premier incident l'explique.
522
+ *
523
+ * @param e - l'erreur qui a fait abandonner le boot.
524
+ */
525
+ private traceFatalBootFailure;
526
+ /**
527
+ * Déroulé du boot. Fire `"onPreStart"` puis `"onStart"`, charge l'application
528
+ * (`loadApp()`), instancie services kernel (Rollup), puis enchaîne sur
529
+ * `preRegister()` → `boot()` → `onReady()` → `initServers()`.
530
+ *
531
+ * Si `command.kernelEvent` matche la phase atteinte → {@link finishOrPark} immédiat
532
+ * (la command a fini son boulot : terminate one-shot OU park daemon long-running) —
533
+ * même sémantique de sortie à TOUTES les phases d'arrêt.
534
+ *
535
+ * Appelé UNIQUEMENT par {@link start}, qui porte la trace d'échec.
536
+ *
537
+ * @returns `this` après boot complet.
538
+ * @throws Toute exception du pipeline est loggée CRITIC puis re-throw.
539
+ */
540
+ private startBoot;
541
+ /**
542
+ * Phase pré-registration — fire `"onPreRegister"` puis `"onRegister"`. Le manifeste
543
+ * `config.modules` est consommé ici (chargement via {@link loadModulesFromManifest}).
544
+ *
545
+ * @returns `this` ou chaîne sur `boot()`.
546
+ */
547
+ preRegister(): Promise<this>;
548
+ private fixCommanderCli;
549
+ /**
550
+ * Phase boot — fire `"onPreBoot"` puis `"onBoot"`. Les services kernel (router, certificats,
551
+ * sessions, http-kernel) sont créés ici via les décorateurs `@services`.
552
+ *
553
+ * @returns `this` ou chaîne sur `onReady()`.
554
+ */
555
+ boot(): Promise<this>;
556
+ /**
557
+ * Phase ready — fire `"onReady"`, démarre les serveurs HTTP/WS via `initServers()`, log
558
+ * memoryUsage, puis fire `"onPostReady"`. C'est ici que les Server Listen apparaissent.
559
+ *
560
+ * @returns `this` après tout le pipeline post-ready.
561
+ */
562
+ onReady(): Promise<this>;
563
+ /**
564
+ * Démarre les serveurs HTTP/HTTPS/HTTP2/WS/WSS via le `HttpKernel` (@nodefony/http).
565
+ *
566
+ * Si le HttpKernel n'est pas dans le container (mode CONSOLE pur) → retourne tableau vide.
567
+ * Sinon → délègue à `httpKernel.initServers()`, fire `"onServersReady"` après succès.
568
+ *
569
+ * **Le profil d'exécution fait foi** : une commande qui déclare ne pas vouloir
570
+ * de serveur (`runProfile.servers === false`, le défaut console) n'en obtient
571
+ * pas, même si le `HttpKernel` est chargé. Sans cette garde, toute commande
572
+ * poussée jusqu'à `onPostReady` ouvrait les ports par effet de bord — elle
573
+ * échouait alors si un serveur tournait déjà, et refusait le service à celui
574
+ * qui tournait pendant sa brève existence. `onServersReady` n'est pas émis :
575
+ * annoncer des serveurs prêts quand il n'y en a aucun rendrait l'événement
576
+ * inexploitable pour ceux qui l'écoutent.
577
+ *
578
+ * @returns array d'instances de serveurs démarrés (ou `[]`).
579
+ */
580
+ initServers(): Promise<any[]>;
581
+ /**
582
+ * Parke le flow : retourne une Promise qui ne se résout JAMAIS (met en pause le
583
+ * pipeline async appelant). **Source UNIQUE** du « rester vivant jusqu'à un signal »
584
+ * — remplace les `new Promise(() => {})` inline disséminés (DevSupervisor parent,
585
+ * master cluster, daemon).
586
+ *
587
+ * ⚠️ Une Promise pending ne garde PAS Node en vie (le process sort dès l'event loop
588
+ * vide). Pour un daemon CONSOLE qui n'a aucun socket/handle → `keepAlive: true` ref un
589
+ * timer no-op (réveil ~tous les 12 j, coût nul). Les superviseurs ont DÉJÀ leurs propres
590
+ * handles (watchers fs du DevSupervisor / canaux IPC workers + timers de sonde du
591
+ * master) → `keepAlive` défaut `false` : aucun handle en trop qui empêcherait leur
592
+ * sortie naturelle au shutdown. Le timer alive est nettoyé par {@link terminate}.
593
+ *
594
+ * Signal handling : déjà fourni globalement par `Cli.handleSignals` → `terminate()`.
595
+ *
596
+ * @param opts.keepAlive - ref un timer no-op pour garder l'event loop vivant.
597
+ * @returns Promise jamais résolue.
598
+ */
599
+ park(opts?: {
600
+ keepAlive?: boolean;
601
+ }): Promise<never>;
602
+ /**
603
+ * Fin de cycle d'une commande ayant atteint sa phase cible : `terminate(code)` pour un
604
+ * run one-shot (build, install, batch, help), MAIS **park** pour un run long-running
605
+ * sans serveur (daemon CONSOLE : worker de queue, consumer, agent IA, cron daemon).
606
+ *
607
+ * C'est ICI que `lifetime` devient effectif : avant, chaque commande daemon inlinait
608
+ * son propre park ; désormais le Kernel décide à partir de la `lifetime` DÉCLARÉE par
609
+ * la commande (`command.lifetime`, fallback `runProfile.lifetime`) croisée avec
610
+ * `runProfile.servers` (les serveurs gardent déjà le process vivant → jamais de park).
611
+ *
612
+ * @param code - exit code si run one-shot.
613
+ * @returns Promise du terminate (one-shot) ou park (daemon, jamais résolue).
614
+ */
615
+ private finishOrPark;
616
+ clean(): void;
617
+ setCommand(command: Command): void;
618
+ setDomain(): string;
619
+ readConfig(config?: TypeKernelOptions): TypeKernelOptions;
620
+ addService(service: ServiceConstructor, module: Module, ...args: any[]): Promise<Service>;
621
+ /**
622
+ * Instancie un service au niveau kernel (vs niveau module via `Module.addService`).
623
+ *
624
+ * Utilisé pour les services partagés essentiels au boot (Rollup, HttpKernel).
625
+ * Stocke directement dans le container kernel.
626
+ *
627
+ * @param ctor - constructeur du service (typiquement décoré `@injectable`).
628
+ * @param args - args additionnels après les `@inject` resolved.
629
+ * @returns instance du service prête à l'usage.
630
+ */
631
+ addKernelService(service: ServiceConstructor, ...args: any[]): Promise<Service | null>;
632
+ loadService(service: string, module?: Module | null, ...args: any[]): Promise<Service>;
633
+ /**
634
+ * Charge un module du manifeste. La résolution part de l'APPLICATION
635
+ * ({@link resolveModuleEntry}) et non du paquet `nodefony` : sans cela, un
636
+ * module local de l'app (workspace `modules/*`) est introuvable dès que le core
637
+ * vit hors de l'arbre `node_modules` de l'app (`--link`, monorepo, pnpm).
638
+ */
639
+ loadModule(moduleName: string): Promise<Module>;
640
+ /**
641
+ * Résout la liste ORDONNÉE des entrées de modules à charger depuis le manifeste
642
+ * `config.modules`, AVEC leur config colocalisée (`use(name, config)`). L'ordre
643
+ * du tableau est conservé (= priorité de chargement) ; `policy`/`when` ne font
644
+ * que FILTRER, jamais réordonner.
645
+ *
646
+ * - `policy:"dev"` → ignoré en production (gain mémoire = non-chargement ; en
647
+ * ESM un module importé n'est jamais déchargé).
648
+ * - `when(config)` faux → ignoré (sa config colocalisée l'est aussi → pas de
649
+ * warning « module absent » sur un module volontairement gaté).
650
+ * - string nue → policy `optional`, toujours chargée, sans config.
651
+ *
652
+ * @returns entrées `{ name, config? }` à charger, dans l'ordre.
653
+ */
654
+ private resolveModuleEntries;
655
+ /**
656
+ * Enregistre un module volontairement non chargé (gating `policy`/`when`) avec
657
+ * sa raison — surfacé par le bilan de boot ({@link getBootReport}). Lazy : 0
658
+ * allocation si rien n'est gaté.
659
+ *
660
+ * @param module - nom d'entrée du manifeste.
661
+ * @param reason - raison lisible du non-chargement.
662
+ */
663
+ private recordModuleGated;
664
+ /**
665
+ * Arme l'auto-arrêt d'un runtime de production ayant dérogé au gating des modules
666
+ * de développement (cf {@link FORCE_DEV_MODULES_ENV}). Idempotent : une seule
667
+ * minuterie, quel que soit le nombre de modules concernés.
668
+ *
669
+ * **L'échéance est ANNONCÉE, deux fois.** Un arrêt temporisé qui surprend est pire
670
+ * que pas de garde-fou : il coupe un banc de charge au milieu d'une mesure, et le
671
+ * journal qu'on relira ensuite accusera le code. On dit donc l'échéance au
672
+ * démarrage — avec le moyen de l'allonger — puis on prévient avant de tomber, et
673
+ * l'arrêt lui-même en donne la raison. Les minuteries sont `unref` : elles
674
+ * n'empêchent jamais une sortie naturelle.
675
+ */
676
+ private armDevModulesSelfStop;
677
+ /**
678
+ * Charge en série les modules résolus par {@link resolveModuleEntries} via
679
+ * `loadModule` (import dynamique → lazy : un module hors liste n'est jamais
680
+ * importé), puis applique la config colocalisée (`use(name, config)`) de
681
+ * chaque entrée. Branché à `onPreRegister` par {@link loadApp} si un manifeste
682
+ * `config.modules` est présent. Seul orchestrateur du chargement de modules.
683
+ */
684
+ private loadModulesFromManifest;
685
+ /**
686
+ * Instancie un module et l'enregistre dans `kernel.modules[name]`. Appelle `initialize(this)`
687
+ * sur le module si défini (équivalent constructeur async).
688
+ *
689
+ * @param Mod - constructeur du module (extends `Module`).
690
+ * @param args - arguments additionnels (après `kernel, path, options` par défaut).
691
+ * @returns instance du module enregistrée.
692
+ */
693
+ addModule(Mod: ModuleConstructor, ...args: any[]): Promise<Module>;
694
+ getModule(name: string): Module;
695
+ getModules(): Record<string, Module>;
696
+ /**
697
+ * Applique les overrides de config inter-modules (clés `Module-<name>` /
698
+ * `module-<name>` dans les options d'un module — typiquement l'app qui
699
+ * reconfigure un autre module) en itérant TOUS les modules enregistrés.
700
+ *
701
+ * Appelé par {@link preRegister} ENTRE `onPreRegister` (tous les modules sont
702
+ * alors enregistrés via `@modules`/`loadApp`) et `onRegister` (où les modules
703
+ * valident + gèlent leur config Zod dans `onKernelRegister`). Corrige la dette
704
+ * d'ordering : l'override était auparavant posé à `onPreBoot` (après la
705
+ * validation) → silencieusement ignoré par tout module qui fige sa config tôt
706
+ * (redis, realtime…). Désormais il précède la validation, qui le voit.
707
+ *
708
+ * Ordre d'application = ordre d'insertion dans `this.modules` (app chargée en
709
+ * premier → configure les modules avant qu'ils ne se valident). Idempotent.
710
+ */
711
+ private applyModuleConfigOverrides;
712
+ /**
713
+ * Applique les overrides de config par variable d'environnement générique
714
+ * `NF__<MODULE>__<CHEMIN…>` (ADR-0006 D3) sur la config de chaque module ciblé.
715
+ *
716
+ * Résolu 1× au boot (hors hot path). La surcharge est déposée sur
717
+ * `module.options` → elle sera validée par le schéma Zod du module à
718
+ * `onKernelRegister` (fail-closed si invalide). Un module ou un chemin
719
+ * introuvable est SIGNALÉ (WARNING) sans bloquer le boot — jamais de clé
720
+ * fantôme silencieuse. Les valeurs de chemins « secrets » sont rédigées au log.
721
+ */
722
+ private applyEnvConfigOverrides;
723
+ /**
724
+ * Filet « clé réservée » : avertit au BOOT quand une application a posé une clé de
725
+ * config marquée `reserved` (inerte — son levier vit ailleurs) à une valeur
726
+ * non-défaut. C'est le pendant runtime du drapeau que Studio se contente de griser :
727
+ * sans lui, une clé réservée écrite reste un silence total (l'app croit régler un
728
+ * comportement, rien ne se produit, rien ne le dit). Symétrique du signalement des
729
+ * chemins env inconnus ({@link applyEnvConfigOverrides}).
730
+ *
731
+ * Générique — 0 `if` par module : le JSON Schema (`Module.configSchema()`, avec les
732
+ * flags `.meta()`) et la config résolue suffisent. Un module non migré (schéma
733
+ * `null`) est ignoré. Appelé 1× après `onRegister` (options validées) → hors hot
734
+ * path ; le message inclut la `description` du champ, qui nomme la remplaçante.
735
+ */
736
+ private warnReservedConfigKeys;
737
+ /**
738
+ * Résout un segment de nom de module (minuscule, issu d'un `NF__<MODULE>__…`)
739
+ * vers son instance : compare au **basename** du nom de module (après le `/`),
740
+ * insensible à la casse (`security` → `@nodefony/security`).
741
+ *
742
+ * @param seg - segment module normalisé (minuscule).
743
+ * @returns le module correspondant, ou `undefined`.
744
+ */
745
+ private findModuleBySegment;
746
+ /**
747
+ * Basenames de tous les modules chargés (segment ciblable par `NF__<MODULE>__…`).
748
+ * Sert au « did you mean » quand le segment module d'un override ne résout pas.
749
+ *
750
+ * @returns la liste des basenames (ex. `security`, `http`).
751
+ */
752
+ private moduleSegments;
753
+ /**
754
+ * Valide la config de l'app au boot via le schéma fourni par l'app, si présent.
755
+ *
756
+ * Convention générique (le core ne dépend PAS de Zod) : si l'entrée de l'app
757
+ * (`dist/index.js`) exporte une fonction `validateConfig`, le Kernel l'exécute sur
758
+ * la config résolue de l'app (`app.options`) — l'app porte le schéma + la dépendance
759
+ * Zod. Absent → étape sautée (rétro-compatible avec une app sans schéma). L'import
760
+ * est déjà résolu par `loadModule` (cache ESM) → coût négligeable, hors hot path.
761
+ *
762
+ * @throws si le validateur de l'app rejette la config (message agrégé).
763
+ */
764
+ private validateAppConfig;
765
+ /**
766
+ * Construit le contexte d'environnement (`ctx`) passé au descripteur
767
+ * {@link defineConfig} d'une app moderne. `runtimeEnv` = `NODE_ENV` normalisé
768
+ * (`dev`→`development`, conserve `test`/`production`) — granularité que le ctx
769
+ * expose (`isTest`), DISTINCTE du collapse dev/prod de {@link resolveRuntimeEnv}
770
+ * (gating moteur : un staging tourne « comme prod »). `appEnv` = axe déploiement
771
+ * libre (`APP_ENV`/`NF_ENV`). `process.env` est déjà peuplé par `loadEnv`
772
+ * (bin/nodefony) avant le boot → lecture sûre ici.
773
+ *
774
+ * @param env - catalogue env typé exposé par l'app (`export const env = defineEnv(…)`) ;
775
+ * `undefined` (app legacy / pas de catalogue) → `process.env` brut.
776
+ * @returns contexte d'environnement pour `descriptor.resolve(ctx)`.
777
+ */
778
+ private buildConfigContext;
779
+ /** Infra déclarée mémoïsés — lazy, `null` tant que non lus. */
780
+ private _infra;
781
+ /**
782
+ * Infra déclarée (`database`/`cache`/`logs`) résolus depuis
783
+ * `process.env` (modèle « infra déclarée », Phase 0.8). Calcul 1 fois, mémoïsé —
784
+ * consommé par le ctx `defineConfig` (`ctx.infra`) et par les briques dont
785
+ * le store vaut `"auto"` (`resolveAutoStore`).
786
+ *
787
+ * @throws Error au premier accès si `NF_DATABASE_URL` a un scheme non
788
+ * supporté (fail-loud : jamais de repli sqlite silencieux).
789
+ */
790
+ get infra(): IInfra;
791
+ /**
792
+ * Registre des résolutions de stores — lazy (`null` tant qu'aucune brique n'a
793
+ * résolu son store). Alloué au premier `registerStoreResolution` (au boot, une
794
+ * fois par brique) — jamais dans le hot-path. Clé = `brick` (dernière gagne).
795
+ */
796
+ private _storeResolutions;
797
+ /**
798
+ * Résolutions EFFECTIVES des stores de persistance capturées au boot — la
799
+ * vérité vécue (replis annoncés inclus). Alimente `/nodefony/kernel/api/stores`
800
+ * et l'écran Studio « Stores ». Vide si aucune brique n'a encore résolu.
801
+ */
802
+ get storeResolutions(): IStoreResolution[];
803
+ /**
804
+ * Enregistre la résolution effective d'une brique (idempotent par `brick`).
805
+ * La provenance est dérivée de `configured` : la sentinelle `"auto"` ⇒
806
+ * `"infra"` (résolu depuis l'infra déclarée), un backend nommé ⇒ `"explicit"`.
807
+ *
808
+ * @param resolution - triplet brique/configuré/résolu + raison + nature
809
+ * ({@link IStoreResolution} sans `provenance`, dérivée ici).
810
+ */
811
+ registerStoreResolution(resolution: Omit<IStoreResolution, "provenance">): void;
812
+ /**
813
+ * Résout les options brutes de l'app. App moderne (`export default defineConfig(…)`)
814
+ * → `raw` est un descripteur {@link AppConfigDescriptor} (le symbole de marque
815
+ * survit au spread d'options de `Service`) → résolu avec `ctx` (deep-merge des
816
+ * défauts framework + validation Zod intégrée à `resolve`). App legacy → objet de
817
+ * config retourné tel quel (validé séparément par son export `validateConfig`).
818
+ *
819
+ * @param raw - export par défaut de l'app (descripteur ou objet de config).
820
+ * @param ctx - contexte d'environnement ({@link buildConfigContext}).
821
+ * @returns options résolues + `wasDescriptor` (pilote le fallback de validation).
822
+ */
823
+ private resolveAppOptions;
824
+ /**
825
+ * Émet au log le rapport des overrides `NF__APP__*` appliqués à la config app
826
+ * (INFO par override, secret rédigé) + les warnings « did you mean » des chemins
827
+ * non résolus. Appelé APRÈS `resolve()` : le logger kernel est prêt (le merge,
828
+ * lui, tourne dans `resolve()` AVANT le logger → rapport différé, cf defineConfig).
829
+ *
830
+ * @param options - config app résolue (porte le rapport en clé non-énumérable).
831
+ */
832
+ private surfaceAppEnvOverrides;
833
+ /**
834
+ * Construit + PRÉSENTE une erreur de configuration de boot de façon
835
+ * EXCEPTIONNELLEMENT claire, et EXPLICITE sur la config PAR DÉFAUT du framework
836
+ * (ce qui s'applique pour tout champ omis). Une config cassée n'est pas
837
+ * récupérable (le framework ne peut pas deviner ports/modules) → fail-fast PROPRE :
838
+ * log lisible SANS stack brute (faute de config, pas bug framework), erreur marquée
839
+ * `presented` (le catch de boot ne re-loggue pas) + `exitCode` `EX_CONFIG`
840
+ * (l'orchestrateur distingue « mauvaise config » d'un crash logiciel).
841
+ *
842
+ * @param title - titre court de l'erreur.
843
+ * @param detail - phrase de contexte.
844
+ * @param cause - erreur d'origine (Zod, import, fonction de config).
845
+ * @param hints - correctifs actionnables.
846
+ * @returns nodefonyError marquée (`exitCode`/`presented`), à `throw`.
847
+ */
848
+ private bootConfigError;
849
+ /** Rendu lisible (1 ligne/clé top-level) des valeurs par défaut du framework. */
850
+ private formatDefaults;
851
+ private loadApp;
852
+ /**
853
+ * Résout le point d'entrée de l'application depuis SON `package.json`
854
+ * (champ `main` — la source de vérité Node), fallback legacy `dist/index.js`
855
+ * puis `index.js`. Vérifie l'EXISTENCE du fichier, sans jamais l'importer :
856
+ * l'exécution (side effects top-level, cache ESM) et la validation du module
857
+ * (export default = `Module`) appartiennent à {@link loadApp}, une seule
858
+ * fois, avec son diagnostic `bootConfigError`. Mémoïsé (stable pour le boot).
859
+ *
860
+ * Anti faux-positif : un projet Node QUELCONQUE (Express…) a aussi un
861
+ * `package.json` + `main` → on exige le signal d'identité Nodefony, sans
862
+ * import : `nodefony` déclaré dans les dépendances, OU installé
863
+ * (`node_modules/nodefony` — couvre le monorepo self-hosted où la racine ne
864
+ * le déclare pas mais où le workspace le symlinke).
865
+ *
866
+ * En production (image Docker), seuls `package.json` + `dist/` +
867
+ * `node_modules` sont déployés : la détection ne dépend d'AUCUN source.
868
+ *
869
+ * @returns chemin absolu de l'entrée, ou `null` (cwd hors projet Nodefony).
870
+ */
871
+ resolveAppEntry(): string | null;
872
+ isTrunk(): Promise<trunkType>;
873
+ /**
874
+ * Diagnostic fail-loud d'un PROJET Nodefony non bootable — différencie les
875
+ * trois raisons qu'un `resolveAppEntry()` nul confond : « vraiment pas un
876
+ * projet » (→ `null`, wizard/message générique), « dépendances non
877
+ * installées » et « non construit ». Sans lui, un `nodefony dev` dans une
878
+ * app fraîchement générée tombait sur le wizard de création — déroutant
879
+ * alors qu'il ne manque que `npm install` / `npm run build` (vécu).
880
+ *
881
+ * @returns le message actionnable à logger CRITIC, ou `null` si ce dossier
882
+ * n'est pas un projet Nodefony (le flux hors-projet reste inchangé)
883
+ */
884
+ diagnoseUnbootableProject(): string | null;
885
+ isCore(): Promise<boolean>;
886
+ isModule(subclass: unknown): boolean;
887
+ getEventName(event: number): string;
888
+ setCommandComplete(progress: number): boolean;
889
+ isCommandComplete(progress: number): boolean;
890
+ initializeLog(): void | null;
891
+ setCli(cli?: CliKernel | null): CliKernel | null;
892
+ isConsole(): boolean;
893
+ setNodeEnv(environment: EnvironmentType): void;
894
+ /**
895
+ * Résout le **mode runtime** (dev/prod) : `NODE_ENV`
896
+ * (ambient, posé par l'orchestrateur en cloud) PRIME sur l'intention de la
897
+ * commande locale, qui prime sur la valeur courante. Normalise en
898
+ * `"development" | "production"`. Pur (lit `process.env`, n'écrit rien) → sûr à
899
+ * appeler avant que `setNodeEnv` n'ait posé `NODE_ENV` (ex. gating de modules à
900
+ * `onPreRegister`). Cf project_app_config_refonte_chantier (deux axes d'env).
901
+ */
902
+ resolveRuntimeEnv(fromCommand?: EnvironmentType): "development" | "production";
903
+ setEnv(environment?: EnvironmentType): void;
904
+ /**
905
+ * Header de boot dev consolidé, imprimé juste sous l'ASCII (dev-only) : nom +
906
+ * version + environnement + meta (`cluster · platform · node · pid`). Remplace la
907
+ * ligne « Version … » et le banner « SERVER … » bruts. Couleurs gatées TTY (logColor).
908
+ */
909
+ private printDevHeader;
910
+ logEnv(): string;
911
+ clusterIsMaster(): boolean;
912
+ /**
913
+ * Vide le buffer des `MODULE ADD` accumulés pendant `loadApp()` et bascule
914
+ * `addModule()` en mode log immédiat. Appelé par `initCluster()` juste
915
+ * après l'en-tête SERVER, pour que les modules apparaissent SOUS le banner.
916
+ */
917
+ private flushPendingModuleAddLogs;
918
+ initCluster(): void;
919
+ fire(event: KernelEventsType, ...args: any[]): boolean;
920
+ emit(event: KernelEventsType, ...args: any[]): boolean;
921
+ emitAsync(event: KernelEventsType, ...args: any[]): Promise<any>;
922
+ fireAsync(event: KernelEventsType, ...args: any[]): Promise<any>;
923
+ /**
924
+ * Timeout par listener appliqué au boot (résilience Phase 3). Précédence :
925
+ * `NF_BOOT_TIMEOUT_MS` (env, orchestrateur) > défaut par env (dev 20 s,
926
+ * prod 60 s). Large à dessein : il borne la PENDAISON infinie (ex. file Redis
927
+ * offline qui ne rejette jamais), pas la lenteur normale d'un hook.
928
+ */
929
+ private bootTimeoutMs;
930
+ /**
931
+ * Seuil d'alerte de lenteur d'un hook de boot (NOTICE, sans le tuer). Précédence :
932
+ * `NF_BOOT_WARN_MS` (env) > défaut 5 s. `0` désactive la mesure.
933
+ */
934
+ private bootWarnMs;
935
+ /**
936
+ * Politique d'échec de boot commune (lifecycle + `initialize`). Log + verdict
937
+ * de propagation. **Fatal** = module critique (tag `critical !== false`) ET
938
+ * (`production` OU erreur de **configuration** {@link BootConfigurationError})
939
+ * → on interrompt le boot (le pod crashe, l'orchestrateur le redémarre —
940
+ * cloud-native). Sinon **fail-soft** : WARNING, le boot continue.
941
+ *
942
+ * **Pourquoi la config est fatale même en dev** : le fail-soft protège la DX
943
+ * d'un module optionnel cassé — mais une configuration EXPLICITE non
944
+ * honorable (infra déclarée injoignable, entité non portée sur le dialecte
945
+ * demandé) ne se répare pas en continuant : le serveur « vivant » qui en
946
+ * résulte est un piège (briques durables mortes, login impossible, cause
947
+ * noyée dans un WARNING — vécu). Cf {@link BootConfigurationError}.
948
+ *
949
+ * @param error - erreur/timeout capturé.
950
+ * @param owner - module propriétaire (tag), ou `undefined` (listener interne).
951
+ * @param critical - criticité (tag) ; `undefined` → traité comme critique.
952
+ * @param timedOut - `true` si l'échec est un dépassement de timeout.
953
+ * @returns `true` si l'échec doit interrompre le boot.
954
+ */
955
+ private isBootErrorFatal;
956
+ /**
957
+ * Enregistre un échec de boot **non fatal** (fail-soft) dans le buffer agrégé,
958
+ * alloué paresseusement au premier échec (0 allocation si le boot est nominal).
959
+ *
960
+ * @param failure - module en échec + raison + étape.
961
+ */
962
+ private recordBootFailure;
963
+ /**
964
+ * Fige la liste des serveurs **réellement en écoute** à `onPostReady`
965
+ * (`initServers()` ne retourne un serveur qu'une fois son `listen()` résolu).
966
+ * Source de vérité de {@link getBootReport}.
967
+ *
968
+ * @param servers - instances de serveurs retournées par `initServers()`.
969
+ */
970
+ private captureBootServers;
971
+ /**
972
+ * Verdict agrégé du dernier boot (vérité unique, recalculable à la demande pour
973
+ * l'introspection Studio/IA). `healthy=false` ⇒ un profil serveur a fini sans
974
+ * aucun serveur en écoute (garde-fou 0-serveur). Les modules ignorés seuls
975
+ * laissent le boot `healthy` (dégradé mais vivant).
976
+ *
977
+ * @returns le {@link IBootReport}.
978
+ */
979
+ getBootReport(): IBootReport;
980
+ get readinessBlocked(): number;
981
+ /**
982
+ * Ce processus a-t-il le droit de recevoir du trafic ?
983
+ *
984
+ * **La règle de mise en service, en UN seul endroit.** Elle est lue par la
985
+ * sonde `/readyz` (que le kubelet interroge) ET par le champ `ready` du plan
986
+ * d'administration (que lit un exploitant) : deux vérités sur la
987
+ * disponibilité, c'en est une de trop — quelqu'un qui voit `ready: true` d'un
988
+ * côté pendant que l'orchestrateur reçoit 503 de l'autre cherche au mauvais
989
+ * endroit. Les deux ont divergé (`booted` contre `postReady`), et l'écart ne
990
+ * s'est vu qu'en production, où la fin du cycle de démarrage arrive assez tard
991
+ * pour ouvrir une fenêtre de plusieurs secondes.
992
+ *
993
+ * Deux conditions, et rien d'autre :
994
+ *
995
+ * - **le cycle de démarrage est TERMINÉ** (`postReady`) — `booted` ne suffit
996
+ * pas : les écouteurs de `onPostReady` montent encore des choses dont une
997
+ * requête a besoin ;
998
+ * - **aucun composant ne retient la mise en service** — un entier déjà
999
+ * calculé par eux ({@link Kernel.setReadiness}), jamais une vérification
1000
+ * déclenchée ici : une sonde ne doit tomber avec RIEN.
1001
+ *
1002
+ * Ce que ce getter ne connaît pas, volontairement : l'ARRÊT. Le drain
1003
+ * appartient au transport, qui bascule sa propre sonde à 503 avant même de
1004
+ * commencer à drainer — et `/livez`, lui, doit rester vert pendant ce
1005
+ * temps, sans quoi un redémarrage casserait l'arrêt gracieux en cours.
1006
+ *
1007
+ * @returns `true` si le processus peut servir du trafic.
1008
+ */
1009
+ get servable(): boolean;
1010
+ /**
1011
+ * Pose le verdict de disponibilité d'un composant nommé — un schéma de base en
1012
+ * retard, un cache froid, un service tiers muet. Tant qu'un seul contributeur
1013
+ * répond `false`, `/readyz` rend **503** et l'orchestrateur n'envoie pas de
1014
+ * trafic ; le processus reste VIVANT (`/livez` inchangé), car un état externe
1015
+ * ne se répare pas en redémarrant le processus.
1016
+ *
1017
+ * Le verdict doit être DÉJÀ CALCULÉ : ce n'est pas une vérification que la
1018
+ * sonde déclenchera, c'est un booléen que le composant met à jour à son propre
1019
+ * rythme. Dès qu'il repose `true`, le processus redevient disponible tout seul
1020
+ * — sans redéploiement, ce qui est toute la raison d'être du mécanisme.
1021
+ *
1022
+ * **`blocking: false` publie l'état SANS retenir le trafic.** Un composant
1023
+ * réglé pour tolérer sa propre panne (« journalise et sers quand même ») doit
1024
+ * pouvoir le dire sans disparaître du registre : c'est sa présence, et non la
1025
+ * rétention, qui apprend au noyau qu'un état EXTERNE est en cours et qu'un
1026
+ * échec de démarrage ne doit donc pas être fatal
1027
+ * ({@link Kernel.isBootErrorFatal}). Sans cette distinction, affaiblir la
1028
+ * sonde faisait perdre la tolérance du démarrage — au moment précis où l'on
1029
+ * cherchait de l'air.
1030
+ *
1031
+ * Idempotent par nom : réenregistrer le même nom remplace son verdict.
1032
+ *
1033
+ * @param name - nom du contributeur, qui apparaîtra au journal (`"drizzle:schema"`)
1034
+ * @param ready - `false` retient la mise en service, `true` la libère
1035
+ * @param reason - ce qui retient, en clair (journalisé ; ignoré si `ready`)
1036
+ */
1037
+ setReadiness(name: string, ready: boolean, reason?: string, blocking?: boolean): void;
1038
+ /**
1039
+ * Retire un contributeur du registre — sa voix ne compte plus. Geste d'un
1040
+ * module qui s'arrête ; le registre est LIBÉRÉ quand le dernier part, pour que
1041
+ * la sonde retrouve exactement le coût qu'elle avait avant toute inscription.
1042
+ *
1043
+ * @param name - nom du contributeur, tel que passé à {@link Kernel.setReadiness}
1044
+ */
1045
+ clearReadiness(name: string): void;
1046
+ /**
1047
+ * Restitue l'état de chaque contributeur — pour un diagnostic (journal,
1048
+ * `status`, console d'administration), jamais pour la sonde.
1049
+ *
1050
+ * @returns un contributeur par inscription, triés par nom ; vide si aucun
1051
+ */
1052
+ readinessReport(): IReadinessContributor[];
1053
+ /**
1054
+ * Publie sur le disque QUI retient la mise en service — le canal que lit
1055
+ * `nodefony status`.
1056
+ *
1057
+ * **Pourquoi un fichier plutôt que la sonde** : le détail existe déjà sur
1058
+ * `livez`, mais réservé à un appelant authentifié, et cette route est publique
1059
+ * en production. Le système de fichiers est la vraie frontière « local », il
1060
+ * répond même quand la boucle d'événements ne répond plus, et il n'ouvre
1061
+ * aucune surface publique. Détail : {@link readinessStateFile}.
1062
+ *
1063
+ * **N'écrit que si l'état a CHANGÉ.** En régime établi — un contributeur qui
1064
+ * repose le même verdict toutes les quinze secondes — ce mécanisme ne touche
1065
+ * pas le disque. La signature est une chaîne courte, composée hors du chemin
1066
+ * d'une requête : `setReadiness` n'est appelé qu'au démarrage et au rythme
1067
+ * propre de chaque contributeur.
1068
+ */
1069
+ private publishReadinessState;
1070
+ /**
1071
+ * Dit au journal ce qui vient de basculer. Appelé UNIQUEMENT quand le verdict
1072
+ * agrégé change (jamais à chaque pose de verdict identique) : un pod retenu
1073
+ * plusieurs heures ne doit pas noyer son propre journal, et un exploitant qui
1074
+ * voit un pod jamais disponible doit trouver ici le NOM de ce qui le retient —
1075
+ * le corps de la sonde, lui, reste une constante pré-allouée.
1076
+ */
1077
+ private logReadinessFlip;
1078
+ /**
1079
+ * Compte les WARNING (severity 4) et les ERROR-et-pire (severity 0-3 :
1080
+ * EMERGENCY/ALERT/CRITIC/ERROR) présents dans le ring buffer syslog. Pendant le
1081
+ * boot, le ring ne contient QUE des logs de boot → le compte est le « journal
1082
+ * du boot ». Borné par la capacité du ring (compte plancher, jamais gonflé).
1083
+ *
1084
+ * @returns compteurs `{ warnings, errors }`.
1085
+ */
1086
+ private countBootLogIssues;
1087
+ /**
1088
+ * Une entrée de journal ramenée à ce qui tient dans un bilan.
1089
+ *
1090
+ * Le message brut porte parfois une pile entière : la première ligne dit ce
1091
+ * qui s'est passé, le reste appartient au journal. Le module émetteur est
1092
+ * conservé — c'est lui qui répond à « QUI a crié ? », la question qu'un
1093
+ * compte seul laissait entière.
1094
+ *
1095
+ * @param pdu - l'entrée du journal.
1096
+ * @returns une ligne, bornée.
1097
+ */
1098
+ private condenseBootMessage;
1099
+ /**
1100
+ * Déclare une ligne de détail à afficher SOUS une phase de boot (canal NEUTRE
1101
+ * dev-only : le `BootReporter` la rend ; le core ne connaît pas son contenu).
1102
+ * Un adapter ORM/frontend/… l'appelle à son hook de phase pour que le boot
1103
+ * RACONTE ce qu'il met en place — sans coupler le core au domaine du module.
1104
+ *
1105
+ * @param phase - libellé de la phase (cf `BootReporter` PHASES, ex. « Services & ORM »).
1106
+ * @param line - ligne lisible (ex. « drizzle → sqlite (./var/app.db) »).
1107
+ */
1108
+ reportBootLine(phase: string, line: string): void;
1109
+ /**
1110
+ * REMPLACE les lignes de détail d'une phase (vs {@link reportBootLine} qui
1111
+ * AJOUTE). Pour un producteur idempotent invoqué plusieurs fois qui reconstruit
1112
+ * la liste complète à chaque appel (ex. le wiring ORM, déclenché par N drivers,
1113
+ * itère tout le registre → « dernier gagne »).
1114
+ *
1115
+ * @param phase - libellé de la phase.
1116
+ * @param lines - liste complète des lignes (remplace l'existant ; vide = efface).
1117
+ */
1118
+ setBootLines(phase: string, lines: string[]): void;
1119
+ /**
1120
+ * Lignes de détail déclarées pour une phase de boot (vide si aucune).
1121
+ *
1122
+ * @param phase - libellé de la phase.
1123
+ * @returns lignes dans l'ordre de déclaration.
1124
+ */
1125
+ getBootLines(phase: string): string[];
1126
+ /**
1127
+ * Action corrective suggérée d'après les raisons d'échec — surfacée dans le
1128
+ * verdict (écran + log). Heuristique : un `import()` qui échoue (« Cannot find
1129
+ * package/module ») pointe presque toujours un `dist/` périmé après pull/merge.
1130
+ *
1131
+ * Le manifeste VIDE est traité en premier parce qu'il ne produit aucune raison
1132
+ * d'échec : rien n'ayant été tenté, `skipped` est vide et l'heuristique
1133
+ * suivante n'a rien à lire. C'est précisément l'état qui laissait le diagnostic
1134
+ * muet — il faut donc le nommer ici, à défaut de pouvoir le déduire.
1135
+ *
1136
+ * Le manifeste vide n'est signalé que sous un profil SERVEUR : une commande
1137
+ * batch ou un test qui boote sans manifeste est un cas nominal, et une
1138
+ * remédiation posée là serait un faux diagnostic recopié partout où le rapport
1139
+ * est lu.
1140
+ *
1141
+ * @param skipped - modules ignorés.
1142
+ * @param manifestEntries - entrées déclarées au manifeste `config.modules`.
1143
+ * @param serversExpected - le profil d'exécution attendait-il des serveurs.
1144
+ * @returns une phrase d'action, ou `null`.
1145
+ */
1146
+ private bootRemediationHint;
1147
+ /**
1148
+ * Log structuré du verdict de boot — émis **toujours** (prod incluse), donc
1149
+ * indépendant du `BootReporter` (qui n'existe qu'en dev). En non-TTY/prod c'est
1150
+ * la seule trace écran ; en dev TTY animé le sink est muté → va au backplane,
1151
+ * et le `BootReporter` rend le verdict joli (✓/⚠/⛔).
1152
+ *
1153
+ * @param report - verdict à logger.
1154
+ */
1155
+ private logBootVerdict;
1156
+ /**
1157
+ * Émet une phase de **lifecycle de boot** de façon GARDÉE (cf
1158
+ * `Event.emitAsyncGuarded`) : chaque hook de module est isolé par try/catch +
1159
+ * timeout ; un module qui throw ou se fige ne gèle/ne tue plus tout le boot. La
1160
+ * politique (propager vs fail-soft) est tranchée par {@link isBootErrorFatal}
1161
+ * d'après les tags `owner`/`critical` posés par `Module.setEvents()`.
1162
+ *
1163
+ * Remplace `fireAsync` **uniquement** dans la chaîne boot (`onPreRegister` →
1164
+ * `onPostReady`). Le hot path HTTP/WS garde `emitAsync` nu (aucun timer/alloc).
1165
+ *
1166
+ * @param event - phase lifecycle à émettre.
1167
+ * @param args - arguments passés aux hooks (typiquement `this`).
1168
+ * @returns le {@link IGuardedEmitResult} (results / errors / stopped).
1169
+ * @throws l'erreur d'un module critique en production (interrompt le boot).
1170
+ */
1171
+ fireLifecycle(event: KernelEventsType, ...args: any[]): Promise<IGuardedEmitResult>;
1172
+ /**
1173
+ * Initialise un service **sous garde de boot** (timeout + politique de criticité
1174
+ * via {@link guardInitialize}) si le service expose le hook `init`. Point
1175
+ * d'entrée commun à {@link addKernelService} (service kernel, `critical=true`) et
1176
+ * à {@link Module.addService} (service de module, criticité = celle du module
1177
+ * porteur), pour que les deux chemins d'init partagent la même résilience.
1178
+ *
1179
+ * @remarks Avant 2026-05-29 les services de module passaient par un `await` NU
1180
+ * (aucun timeout) : un `init` qui pend (ex. `redis` = connexion réseau)
1181
+ * gelait le boot indéfiniment. Désormais borné comme les services kernel.
1182
+ *
1183
+ * @param serviceInit - instance du service ; ne fait rien si `init` absent.
1184
+ * @param owner - propriétaire passé au hook : le {@link Module} ou ce {@link Kernel}.
1185
+ * @param critical - criticité transmise à {@link isBootErrorFatal}.
1186
+ */
1187
+ guardServiceInitialize(serviceInit: ServiceWithInit, owner: Module<unknown> | Kernel, critical: boolean): Promise<void>;
1188
+ /**
1189
+ * Applique la politique de criticité du boot à l'échec d'un service déclaré via
1190
+ * `@services([...])` — **construction (`new`) comprise**, pas seulement `init`.
1191
+ * Pendant symétrique de {@link guardServiceInitialize} pour le chemin décorateur.
1192
+ *
1193
+ * @remarks Le `catch` du décorateur `@services` avalait auparavant TOUT échec
1194
+ * (`log(e, "ERROR")` et rien d'autre) : il n'atteignait ni cette politique —
1195
+ * donc jamais fatal, **même en production** — ni le {@link getBootReport}, si
1196
+ * bien qu'un boot amputé d'un service critique se déclarait « UP ». Un service
1197
+ * qu'on ne peut pas CONSTRUIRE doit suivre exactement la règle de celui qu'on
1198
+ * ne peut pas INITIALISER.
1199
+ *
1200
+ * @param error - l'échec remonté par `addService`/`loadService`.
1201
+ * @param serviceName - nom lisible (pour le log + le BootReport).
1202
+ * @param critical - criticité du module porteur ({@link Module.critical}).
1203
+ * @returns `true` si l'échec est fatal → l'appelant **doit** propager.
1204
+ */
1205
+ serviceBootErrorFatal(error: unknown, serviceName: string, critical: boolean): boolean;
1206
+ /**
1207
+ * Exécute un `initialize()` (module ou service kernel) sous garde de boot :
1208
+ * borné par {@link bootTimeoutMs} et soumis à {@link isBootErrorFatal}. Un
1209
+ * `initialize` qui se fige (connexion réseau qui pend) ne gèle plus le boot.
1210
+ *
1211
+ * @param run - thunk qui lance l'`initialize` (déjà lié à son instance).
1212
+ * @param owner - nom du module/service (pour le log).
1213
+ * @param critical - criticité (module → `Module.critical` ; service kernel → `true`).
1214
+ */
1215
+ private guardInitialize;
1216
+ checkPath(myPath: string): string | null;
1217
+ sendMessage(message: any, handle?: any, options?: {
1218
+ swallowErrors?: boolean;
1219
+ keepOpen?: boolean | undefined;
1220
+ }, callback?: ((error: Error | null) => void) | undefined): boolean;
1221
+ memoryUsage(message?: string, severity?: Severity): void;
1222
+ stats(): Stats;
1223
+ interfacesFilter(filters?: FilterInterface): NetworkInterface;
1224
+ getNetworkInterfaces(): {
1225
+ [name: string]: os.NetworkInterfaceInfo[];
1226
+ };
1227
+ getNetwork(): {
1228
+ external: NetworkInterface;
1229
+ local: NetworkInterface;
1230
+ ipv4: NetworkInterface;
1231
+ ipv6: NetworkInterface;
1232
+ interfaces: NetworkInterface;
1233
+ };
1234
+ getFirstExternalInterface(family?: FamilyType): os.NetworkInterfaceInfo | undefined;
1235
+ /**
1236
+ * Shutdown propre du kernel — fire `"onTerminate"` puis `CliKernel.quit(code)` sur next tick.
1237
+ *
1238
+ * Le drain complet (`fireAsync("onTerminate")` : bascule readiness → close WS
1239
+ * 1001 → drain HTTP → cleanup services) est borné par la deadline GLOBALE
1240
+ * `shutdownDeadline` (défaut 15 s, < grace period orchestrateur) : un listener
1241
+ * qui pend (SSE ouvert, store bloqué, module tiers) force la sortie code 1 —
1242
+ * jamais un process zombie qui attend le SIGKILL externe. `0` = filet désactivé.
1243
+ *
1244
+ * @param code - exit code Unix (0 = succès, 1+ = erreur).
1245
+ * @param quiet - muselle l'AFFICHAGE (le log « terminate : N ») — jamais le
1246
+ * drain : une sortie voulue par l'utilisateur (Ctrl+C d'un menu) n'a pas à
1247
+ * ressembler à un événement système.
1248
+ * @returns Promise résolue avec `this` (ou rejected si `quit()` throw).
1249
+ */
1250
+ terminate(code?: number, quiet?: boolean): Promise<this>;
1251
+ /** Le shutdown lui-même — protégé de la ré-entrance par {@link terminate}. */
1252
+ private doTerminate;
1253
+ }
1254
+ export default Kernel;
1255
+ export { Events };