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,638 @@
1
+ /**
2
+ * Helpers d'INTROSPECTION des process de développement Nodefony — source de vérité
3
+ * PARTAGÉE entre le superviseur (`DevSupervisor`, écrivain du pidfile) et les
4
+ * commandes de diagnostic (`nodefony status`, `nodefony stop`, lecteurs).
5
+ *
6
+ * 100 % OBSERVATION EXTERNE : pidfile + `ps` + sonde TCP, AUCUN IPC superviseur↔enfant
7
+ * (choix d'architecture). Toute valeur dont la divergence écrivain/lecteur serait un
8
+ * bug (chemin du pidfile, ports surveillés) vit ICI et n'est dupliquée nulle part.
9
+ */
10
+ /** Titre de process du superviseur de dev (posé par {@link DevSupervisor.start}). */
11
+ export declare const DEV_SUPERVISOR_TITLE = "nodefony-dev-supervisor";
12
+ /** Titre de process du serveur enfant supervisé (posé par `DevCommand` à `onReady`). */
13
+ export declare const DEV_SERVER_TITLE = "nodefony-dev-server";
14
+ /** Préfixe de titre des process Vite (`ViteProcessSupervisor`, via `argv0`). */
15
+ export declare const DEV_VITE_PREFIX = "nodefony-vite";
16
+ /**
17
+ * Titre du serveur prod **mono-process** (`production` ou `cluster` avec `workers:1`,
18
+ * posé par `Prod`/`ClusterCommand.generate`). Espace (≠ tiret de `nodefony-dev-server`)
19
+ * → aucune collision de `String.includes` entre les deux.
20
+ */
21
+ export declare const PROD_SERVER_TITLE = "nodefony server";
22
+ /** Préfixe du titre du master cluster (posé par `startClusterMaster`, ex. `nodefony master [cluster 6w]`). */
23
+ export declare const CLUSTER_MASTER_PREFIX = "nodefony master";
24
+ /** Préfixe du titre d'un worker cluster (posé par `Prod`/`ClusterCommand.generate`, ex. `nodefony worker 3 [cluster]`). */
25
+ export declare const CLUSTER_WORKER_PREFIX = "nodefony worker";
26
+ /**
27
+ * Mode de runtime d'un process Nodefony — la « molette front » (cf modèle 2 molettes).
28
+ * `dev` = superviseur + serveur + Vite (HMR) ; `prod` = serveur mono-process foreground
29
+ * (1 pod) ; `cluster` = master superviseur + N workers. Distingue un `nodefony server`
30
+ * (prod) d'un `nodefony-dev-server` (dev) là où le seul `role` ne suffit pas.
31
+ */
32
+ export type RuntimeMode = "dev" | "prod" | "cluster";
33
+ /**
34
+ * Rôle d'un process dans la topologie runtime Nodefony (dev OU prod OU cluster).
35
+ * `supervisor`/`master` = superviseurs (0 HTTP) ; `server`/`worker` = servent le HTTP ;
36
+ * `vite` = enfant dev (bundler).
37
+ */
38
+ export type DevProcessRole = "supervisor" | "server" | "vite" | "master" | "worker";
39
+ /** Process runtime Nodefony vivant observé via `ps` (sans IPC) — dev, prod ou cluster. */
40
+ export interface DevProcessInfo {
41
+ readonly pid: number;
42
+ /** PID du parent (relie l'enfant au superviseur/master, Vite à l'enfant). */
43
+ readonly ppid: number;
44
+ /** Mode runtime du process (dev/prod/cluster) — distingue prod-server de dev-server. */
45
+ readonly mode: RuntimeMode;
46
+ readonly role: DevProcessRole;
47
+ /** Étiquette courte de colonne (`supervisor`, `server`, `vite`). */
48
+ readonly label: string;
49
+ /** Détail optionnel hors colonne (bundles d'une instance Vite : `react+vue`). */
50
+ readonly detail?: string;
51
+ /** Mémoire résidente en kilo-octets (champ `rss` de `ps`). */
52
+ readonly rssKb: number;
53
+ /** Pourcentage CPU instantané (champ `pcpu` de `ps`). */
54
+ readonly cpu: number;
55
+ /** Durée de vie en secondes (champ `etime` de `ps`, normalisé). */
56
+ readonly uptimeSec: number;
57
+ }
58
+ /** État de sonde d'un port serveur. */
59
+ export interface PortState {
60
+ readonly port: number;
61
+ /** `true` si un service accepte une connexion loopback sur ce port. */
62
+ readonly listening: boolean;
63
+ }
64
+ /**
65
+ * Chemin du pidfile single-instance du superviseur dev — **source UNIQUE** lue par
66
+ * `status`/`stop` et écrite par le superviseur (divergence = bug : le lecteur ne
67
+ * verrait jamais l'instance). Sous `node_modules/.cache` (déjà gitignoré).
68
+ */
69
+ export declare function devSupervisorPidFile(cwd: string): string;
70
+ /** Ports Nodefony historiques — le point de départ, pas une vérité. */
71
+ export declare const FALLBACK_DEV_PORTS: readonly number[];
72
+ /**
73
+ * Chemin du **state file runtime** — le canal par lequel le serveur DIT sur quels
74
+ * ports il écoute VRAIMENT.
75
+ *
76
+ * Il existe parce que le port n'est plus une convention : avec
77
+ * `servers.portPolicy: "auto"`, un port occupé fait glisser l'écoute (5151 → 5153).
78
+ * `status`, `stop` et la readiness `--detach` sondaient `[5151, 5152]` **en dur** —
79
+ * ils deviendraient aveugles à la première app décalée. Le serveur écrit donc ses
80
+ * ports effectifs ici, et les lecteurs les prennent à la source.
81
+ *
82
+ * À côté du pidfile, même dossier déjà gitignoré.
83
+ */
84
+ export declare function runtimeStateFile(cwd: string): string;
85
+ /**
86
+ * Chemin du **canal de disponibilité** — par lequel le serveur DIT *qui* retient
87
+ * sa mise en service, et pourquoi.
88
+ *
89
+ * ## Pourquoi un fichier, et pas la sonde HTTP
90
+ *
91
+ * Le serveur publie déjà ce détail sur `/nodefony/kernel/api/livez`, mais
92
+ * **réservé à un appelant authentifié** : les noms décrivent l'architecture
93
+ * interne, et cette route est publique en production. La gradation est
94
+ * délibérée — l'anonyme reçoit un compte, jamais des noms — et l'ouvrir pour le
95
+ * confort d'un outil local serait payer en surface publique un service rendu sur
96
+ * une seule machine.
97
+ *
98
+ * Le système de fichiers **est** la frontière « local », et une bien meilleure
99
+ * que l'adresse d'appel : un conteneur voisin ou un mandataire présentent la
100
+ * boucle locale sans être l'exploitant. Ici, lire le fichier suppose déjà un
101
+ * accès au dossier du projet.
102
+ *
103
+ * Et il répond quand la sonde ne répond plus — pipeline saturé, boucle
104
+ * d'événements bloquée. C'est précisément le moment où l'on tape `status`.
105
+ *
106
+ * À côté du pidfile et du state file runtime, même dossier déjà gitignoré.
107
+ */
108
+ export declare function readinessStateFile(cwd: string): string;
109
+ /** Un contributeur de disponibilité, tel que le serveur le publie. */
110
+ export interface ReadinessContributorState {
111
+ /** Nom du contributeur, tel qu'il s'est inscrit. */
112
+ name: string;
113
+ /** `false` retient la mise en service. */
114
+ ready: boolean;
115
+ /** Ce qui retient, en clair — absent quand le contributeur est prêt. */
116
+ reason?: string;
117
+ }
118
+ /** Ce que le serveur publie sur sa disponibilité. */
119
+ export interface ReadinessState {
120
+ /** PID du process qui l'a écrit — un fichier d'un mort ne vaut rien. */
121
+ pid: number;
122
+ /** Un par contributeur inscrit, triés par nom. */
123
+ contributors: ReadinessContributorState[];
124
+ /** Horodatage d'écriture (`Date.now()`). */
125
+ ts: number;
126
+ }
127
+ /**
128
+ * Publie qui retient la mise en service — **best-effort, jamais bloquant**.
129
+ *
130
+ * Écrit seulement quand l'état a changé (l'appelant en décide) : en régime
131
+ * établi, ce fichier ne coûte rien. Un système de fichiers en lecture seule, un
132
+ * dossier absent, un disque plein : on n'écrit pas, et le diagnostic retombe sur
133
+ * le compte que la sonde donne déjà. Publier son état ne doit jamais mettre en
134
+ * péril le processus qui sert.
135
+ *
136
+ * @param cwd - racine du projet.
137
+ * @param contributors - l'état de chaque contributeur, tel que le registre le rend.
138
+ */
139
+ export declare function writeReadinessState(cwd: string, contributors: readonly ReadinessContributorState[]): void;
140
+ /**
141
+ * Efface le canal de disponibilité — geste d'un processus qui s'arrête.
142
+ *
143
+ * @param cwd - racine du projet.
144
+ */
145
+ export declare function clearReadinessState(cwd: string): void;
146
+ /**
147
+ * Lit qui retient la mise en service, ou `null`.
148
+ *
149
+ * **Un fichier dont le process est MORT est ignoré** : sinon `status` nommerait
150
+ * le contributeur d'un serveur d'hier, ce qui est pire que de ne rien nommer —
151
+ * on chercherait une cause déjà disparue.
152
+ *
153
+ * @param cwd - racine du projet à interroger.
154
+ * @returns les contributeurs publiés, ou `null` si rien d'exploitable.
155
+ */
156
+ export declare function readReadinessState(cwd: string): ReadinessContributorState[] | null;
157
+ /** Ce que le serveur publie sur lui-même une fois ses serveurs en écoute. */
158
+ export interface RuntimeState {
159
+ /** PID du process qui écoute. */
160
+ pid: number;
161
+ /** Ports EFFECTIFS (après résolution d'un éventuel conflit). */
162
+ ports: number[];
163
+ /** Ports DÉSIRÉS (config) — diffèrent des effectifs si `auto` a dû décaler. */
164
+ desiredPorts?: number[];
165
+ /** Horodatage d'écriture (`Date.now()`). */
166
+ ts: number;
167
+ }
168
+ /**
169
+ * Publie les ports EFFECTIFS du runtime. Best-effort : un échec d'écriture ne doit
170
+ * jamais faire tomber un serveur qui, lui, écoute très bien (les lecteurs
171
+ * retomberont sur les ports par défaut).
172
+ */
173
+ export declare function writeRuntimeState(cwd: string, state: Omit<RuntimeState, "ts">): void;
174
+ export declare function readRuntimeState(cwd: string, opts?: {
175
+ purgeStale?: boolean;
176
+ }): RuntimeState | null;
177
+ /** Retire le state file (arrêt propre, ou reliquat d'un process mort). */
178
+ /**
179
+ * Retrouve le runtime de CE projet par son fichier d'état, sans observer les process.
180
+ *
181
+ * Repli employé là où l'observation externe n'existe pas ({@link isProcessDiscoverySupported}).
182
+ * Le fichier vit sous le `cwd` du projet et porte le PID de qui écoute : l'appartenance au
183
+ * projet est donc acquise par construction, là où `ps` exigeait de lire le répertoire
184
+ * courant d'un process tiers. {@link readRuntimeState} a déjà vérifié que le PID est
185
+ * vivant et purgé le fichier sinon — un reliquat ne peut pas faire tuer un PID recyclé.
186
+ *
187
+ * Rend la TOPOLOGIE, pas un process isolé : le superviseur (pidfile) EN TÊTE, puis le
188
+ * serveur qui écoute (fichier d'état). L'ordre porte une conséquence — un superviseur
189
+ * relance son enfant dès qu'il le voit mourir, donc arrêter le serveur seul ne fait que
190
+ * provoquer un rechargement. Les instances Vite, elles, restent hors de portée : rien ne
191
+ * les publie, et elles meurent avec le superviseur qui les a lancées.
192
+ *
193
+ * Ce que le repli NE donne pas, faute de les observer : mémoire résidente, part CPU,
194
+ * durée de vie du superviseur. Ces colonnes valent zéro et le rapport le dit.
195
+ *
196
+ * @param cwd - racine du projet.
197
+ * @returns les process du projet, du superviseur au serveur ; vide si rien d'exploitable.
198
+ */
199
+ export declare function discoverFromRuntimeState(cwd: string): DevProcessInfo[];
200
+ export declare function clearRuntimeState(cwd: string): void;
201
+ /**
202
+ * Chemin du **verrou de suspension du superviseur dev** — le canal par lequel le serveur
203
+ * dit à son parent : « je suis en train d'écrire dans les sources, ne me redémarre pas
204
+ * maintenant ».
205
+ *
206
+ * Il existe parce que le watcher regarde `nodefony/`, `index.ts`, `src/` — et que
207
+ * certaines opérations du serveur écrivent PRÉCISÉMENT là : générer un module depuis
208
+ * Studio, appliquer une migration, installer un module tiers. Sans verrou, le
209
+ * rechargement part au milieu de l'opération et tue le `npm install` en cours (le process
210
+ * npm est un enfant du serveur), laissant un `node_modules` à moitié écrit.
211
+ *
212
+ * Un fichier, et pas un IPC, parce que parent et enfant n'en ont pas (`stdio: [ignore,
213
+ * pipe, pipe]`) — et parce que c'est déjà le patron du pidfile et du state file, au même
214
+ * endroit, déjà gitignoré.
215
+ */
216
+ export declare function supervisorLockFile(cwd: string): string;
217
+ /** Ce que le serveur publie quand il demande au superviseur de patienter. */
218
+ export interface SupervisorLock {
219
+ /** PID du process qui tient le verrou — sert à détecter un verrou ORPHELIN. */
220
+ pid: number;
221
+ /**
222
+ * Pourquoi le rechargement est suspendu, en clair.
223
+ *
224
+ * Affiché tel quel par le superviseur : un rechargement qui ne part pas SANS
225
+ * explication est un mystère pour l'utilisateur (« j'édite, rien ne se passe »).
226
+ * La raison est donc obligatoire.
227
+ */
228
+ reason: string;
229
+ /** Précision libre (id de job, nom de migration…) — traçabilité. */
230
+ detail?: string;
231
+ /** Horodatage de pose (`Date.now()`) — sert à l'expiration. */
232
+ ts: number;
233
+ }
234
+ /**
235
+ * Suspend le rechargement automatique le temps d'une opération qui écrit dans les
236
+ * sources.
237
+ *
238
+ * À utiliser par TOUTE opération serveur qui touche aux fichiers surveillés — génération
239
+ * de code, migration, installation d'un module. Best-effort : un échec d'écriture ne doit
240
+ * jamais faire échouer l'opération elle-même (au pire, le superviseur redémarre).
241
+ *
242
+ * @param cwd - racine du projet.
243
+ * @param reason - raison affichée à l'utilisateur (« génération de code »…).
244
+ * @param detail - précision optionnelle (id de job…).
245
+ */
246
+ export declare function suspendSupervisor(cwd: string, reason: string, detail?: string): void;
247
+ /** Rend la main au superviseur (fin de l'opération, quelle qu'en soit l'issue). */
248
+ export declare function resumeSupervisor(cwd: string): void;
249
+ /**
250
+ * Le rechargement est-il suspendu, et pourquoi ?
251
+ *
252
+ * **Fail-safe par construction** : dans le doute, on répond `null` (le watcher fait son
253
+ * travail). Un verrou muselle le rechargement automatique — le laisser traîner serait
254
+ * pire que le mal : on éditerait ses fichiers sans que plus rien ne se recharge, sans la
255
+ * moindre explication. Un verrou n'est donc retenu que s'il est VIVANT :
256
+ *
257
+ * - son process existe encore (`kill(pid, 0)`) — un serveur tué en pleine opération
258
+ * laisse son fichier derrière lui ; on ne le croit pas sur parole ;
259
+ * - il a moins de {@link SUPERVISOR_LOCK_TTL_MS} — filet si un PID est recyclé par l'OS.
260
+ *
261
+ * Un verrou mort est SUPPRIMÉ au passage, pour ne pas se reposer la question.
262
+ *
263
+ * @param cwd - racine du projet.
264
+ * @returns le verrou vivant (avec sa raison, à afficher), ou `null`.
265
+ */
266
+ export declare function readSupervisorSuspension(cwd: string): SupervisorLock | null;
267
+ /**
268
+ * Ports serveur à SONDER (`status`, `stop`, readiness, attente de libération).
269
+ *
270
+ * Ordre de vérité, du plus fiable au moins fiable :
271
+ * 1. `NF_DEV_PORTS` — override explicite de l'opérateur, il gagne toujours ;
272
+ * 2. le **state file runtime** — ce que le serveur écoute VRAIMENT (seule source
273
+ * exacte quand `portPolicy: "auto"` a décalé l'écoute) ;
274
+ * 3. `NF_PORT` / `NF_PORT_HTTPS` — ce que l'application DÉCLARE. L'alias
275
+ * plateforme `PORT` (Cloud Run, Heroku) n'est PAS lu ici : il appartient au
276
+ * gabarit d'application, qui choisit de l'accepter, pas au framework — le
277
+ * lire depuis le cœur ferait précisément la collision que le préfixe `NF_`
278
+ * existe pour empêcher (un `PORT` posé pour un autre outil détournerait la
279
+ * sonde). Sans cette marche, une application qui tourne ailleurs que sur la
280
+ * convention était jugée sur les ports d'un projet VOISIN : `check` rendait
281
+ * « port déjà tenu » sur du code parfait dès qu'un autre serveur tournait
282
+ * sur le poste, et le verdict devenait dépendant de la machine ;
283
+ * 4. `[5151, 5152]` — la convention historique, quand rien n'est déclaré ni ne
284
+ * tourne (cas du tout premier boot : personne n'a pu publier quoi que ce soit).
285
+ *
286
+ * @param cwd - racine du projet (le state file est par projet).
287
+ */
288
+ export declare function defaultDevPorts(cwd?: string): number[];
289
+ /** Lit le PID du superviseur depuis le pidfile, ou `null` si absent / illisible. */
290
+ export declare function readSupervisorPid(cwd: string): number | null;
291
+ /** `true` si le process `pid` est vivant (signal 0 — ne le tue pas). */
292
+ export declare function isPidAlive(pid: number): boolean;
293
+ /**
294
+ * Nom d'image d'une ligne `tasklist /NH /FO CSV` — fonction PURE.
295
+ *
296
+ * `tasklist` sort `"node.exe","4212","Console","1","52 480 K"`, mais aussi, quand le
297
+ * PID n'existe plus, une phrase en clair (`INFO: No tasks are running…`) avec un code
298
+ * de sortie NUL. Ne rendre un nom que sur la forme CSV attendue est donc ce qui
299
+ * distingue « je l'ai vu » de « je n'ai rien vu ».
300
+ *
301
+ * @param out - sortie brute de `tasklist`.
302
+ * @returns le nom d'image, ou `null` si la sortie ne décrit aucun process.
303
+ */
304
+ export declare function parseTasklistImage(out: string): string | null;
305
+ /** Ce qu'on a pu CONSTATER d'un process — le verdict d'observation avec la donnée. */
306
+ export interface ProcessIdentity {
307
+ /**
308
+ * `true` si l'outil a réellement répondu. Sépare « ce PID n'est pas à nous » de
309
+ * « je n'ai pas pu regarder » — deux états qu'une chaîne vide confondait, et dont
310
+ * dépend le droit de tuer.
311
+ */
312
+ readonly observed: boolean;
313
+ /** Ligne de commande (POSIX) ou nom d'image (Windows). `null` si non observé. */
314
+ readonly command: string | null;
315
+ }
316
+ /**
317
+ * Identifie un process vivant par OBSERVATION EXTERNE, sur toutes les plateformes.
318
+ *
319
+ * POSIX lit la ligne de commande (`ps -o command=`) — la preuve la plus forte, elle
320
+ * contient le titre de process Nodefony. Windows n'a pas d'équivalent bon marché :
321
+ * `tasklist` ne rend que le nom d'IMAGE (`node.exe`), preuve plus faible, qui suffit
322
+ * néanmoins à écarter un PID recyclé par un process tiers. C'est à l'appelant de
323
+ * corroborer (le pidfile qui nomme ce PID vit dans SON projet).
324
+ *
325
+ * @param pid - process à identifier (supposé vivant).
326
+ * @returns le verdict d'observation, cf {@link ProcessIdentity}.
327
+ */
328
+ export declare function identifyProcess(pid: number): ProcessIdentity;
329
+ /**
330
+ * Comment atteindre l'ARBRE de `pid` sur `platform` — fonction PURE, sans effet.
331
+ *
332
+ * POSIX répond par un signal au groupe (`-pid`), qui n'a pas d'équivalent Windows :
333
+ * là-bas la seule voie est un programme externe, `taskkill /T`, qui descend la
334
+ * FILIATION (parent → enfants → petits-enfants) au lieu du groupe. C'est pourquoi
335
+ * l'enfant serveur y est spawné `detached:false` : rattaché, il est atteignable.
336
+ *
337
+ * `/F` (forcé) est là par nécessité, pas par choix : `taskkill` sans `/F` poste un
338
+ * `WM_CLOSE` aux FENÊTRES du process, ce qu'un process console n'a pas — la demande
339
+ * gracieuse n'arriverait donc nulle part. **Windows n'offre aucun arrêt gracieux
340
+ * d'arbre**, et ce fait s'ÉNONCE ({@link TreeSignalOutcome}) plutôt qu'il ne se
341
+ * masque derrière un `SIGTERM` qui n'en a que le nom.
342
+ *
343
+ * @param pid - racine de l'arbre à emporter.
344
+ * @param platform - `process.platform` (injecté : c'est ce qui rend la règle testable
345
+ * depuis n'importe quel système).
346
+ * @returns le programme à lancer, ou `null` quand la plateforme passe par les signaux.
347
+ */
348
+ export declare function killTreeCommand(pid: number, platform: NodeJS.Platform): {
349
+ file: string;
350
+ args: string[];
351
+ } | null;
352
+ /**
353
+ * Ce qu'un envoi de signal a RÉELLEMENT pu atteindre — le verdict, pas l'intention.
354
+ *
355
+ * - `group` : le groupe POSIX a reçu le signal (descendants inclus), gracieux respecté.
356
+ * - `forced-tree` : l'arbre Windows a été emporté de FORCE (aucune autre voie n'existe).
357
+ * - `single` : seul le process visé a été atteint. **Ses descendants survivent** — un
358
+ * Vite orphelin par rechargement, ce qui rend le mode dev inutilisable à la longue.
359
+ * Cet état se DIT à l'utilisateur ; c'est tout l'intérêt de le distinguer.
360
+ * - `gone` : plus rien à atteindre (déjà mort). À ne surtout pas confondre avec
361
+ * `single` : le second annonce un risque d'orphelin, le premier un non-événement —
362
+ * les confondre ferait crier au Vite fantôme à chaque arrêt normal.
363
+ */
364
+ export type TreeSignalOutcome = "group" | "forced-tree" | "single" | "gone";
365
+ /** Dépendances de {@link signalProcessGroup} — injectées pour éprouver Windows sans Windows. */
366
+ export interface SignalTreeDeps {
367
+ readonly platform?: NodeJS.Platform;
368
+ /** Lance le programme de kill d'arbre ; `true` si l'arbre a été traité. */
369
+ readonly runTreeKill?: (cmd: {
370
+ file: string;
371
+ args: string[];
372
+ }) => boolean;
373
+ readonly killPid?: (pid: number, signal: NodeJS.Signals) => void;
374
+ readonly killGroup?: (pid: number, signal: NodeJS.Signals) => void;
375
+ }
376
+ /**
377
+ * Envoie `signal` à l'ARBRE de `pid` — enfant serveur ET ses Vite — et dit ce qu'il a
378
+ * pu atteindre. No-op silencieux si le process n'existe plus.
379
+ *
380
+ * POSIX : signal au groupe (`-pid`) puis au pid en repli. Windows : `taskkill /T /F`
381
+ * (cf {@link killTreeCommand}) puis, si le programme manque, `process.kill(pid)` —
382
+ * qui n'emporte QUE l'enfant direct, d'où le verdict `single` à annoncer.
383
+ *
384
+ * @returns ce qui a été atteint, cf {@link TreeSignalOutcome}.
385
+ */
386
+ export declare function signalProcessGroup(pid: number, signal: NodeJS.Signals, deps?: SignalTreeDeps): TreeSignalOutcome;
387
+ /** Supprime le pidfile du superviseur (best-effort, idempotent). */
388
+ export declare function clearSupervisorPidFile(cwd: string): void;
389
+ /**
390
+ * Racines d'un ensemble de process : ceux dont le parent n'est PAS lui-même dans
391
+ * l'ensemble. Tuer le GROUPE d'une racine suffit à emporter ses descendants présents
392
+ * (le superviseur emporte enfant serveur + Vite ; un orphelin est sa propre racine).
393
+ */
394
+ export declare function rootProcesses(procs: readonly DevProcessInfo[]): DevProcessInfo[];
395
+ /** Attend que tous les `pids` soient morts (poll), renvoie ceux encore vivants à l'échéance. */
396
+ export declare function waitAllDead(pids: readonly number[], timeoutMs: number): Promise<number[]>;
397
+ /** Options de {@link terminateDevProcesses}. */
398
+ export interface TerminateOptions {
399
+ /** Délai d'arrêt gracieux (SIGTERM) avant d'escalader en SIGKILL. Défaut 4000 ms. */
400
+ readonly termWaitMs?: number;
401
+ /** Délai d'attente de la mort après SIGKILL. Défaut 1500 ms. */
402
+ readonly killWaitMs?: number;
403
+ }
404
+ /**
405
+ * Arrête un ensemble de process dev par GROUPE — SIGTERM (arrêt gracieux) sur les
406
+ * racines puis SIGKILL des récalcitrants (groupes racines + PID restants un à un).
407
+ * Renvoie les PID encore vivants à la fin (vide = arrêt complet).
408
+ *
409
+ * OBSERVATION EXTERNE pure (signaux POSIX, aucun IPC). Logique PARTAGÉE entre
410
+ * `nodefony stop` (rapport user, cf {@link DevProcessInfo}) et le verrou single-instance
411
+ * du superviseur (nettoyage des résiduels au démarrage) → une seule définition de « tuer
412
+ * proprement un arbre de process dev » (divergence = bug).
413
+ */
414
+ export declare function terminateDevProcesses(procs: readonly DevProcessInfo[], opts?: TerminateOptions): Promise<number[]>;
415
+ /**
416
+ * Répertoire de travail d'un process — `/proc/<pid>/cwd` (Linux) ou `lsof -d cwd`
417
+ * (macOS/BSD). `null` si irrésolu (process mort, permissions, outil absent).
418
+ *
419
+ * Sert au SCOPING PAR PROJET du multi-app : plusieurs apps Nodefony peuvent
420
+ * tourner en dev sur le même poste — un balayage `ps` global sans notion de
421
+ * projet faisait tuer le runtime d'un AUTRE dossier (destructeur, vécu en
422
+ * design review). Le cwd est le seul identifiant de projet observable de
423
+ * l'extérieur (aucun IPC — choix d'architecture de ce module).
424
+ */
425
+ export declare function processCwd(pid: number): string | null;
426
+ /** Un process découvert, enrichi du cwd résolu (`null` = irrésolu). */
427
+ export type DevProcessWithCwd = DevProcessInfo & {
428
+ cwd: string | null;
429
+ };
430
+ /**
431
+ * Scinde des process découverts entre CE projet (`mine` — tuables par les gardes
432
+ * single-instance / `nodefony stop`) et les AUTRES (`foreign` — JAMAIS touchés).
433
+ *
434
+ * Règles de rattachement :
435
+ * - rôles racine (supervisor/master/server/worker) : cwd EXACTEMENT le projet —
436
+ * ils sont toujours spawnés à la racine ;
437
+ * - `vite` : projet OU sous-dossier (le builder peut travailler dans `frontend/`) ;
438
+ * - cwd IRRÉSOLU → `foreign` : on préfère laisser vivre un orphelin (bénin, la
439
+ * collision de ports est refusée plus loin) plutôt que tuer la session d'un
440
+ * autre projet (destructeur).
441
+ *
442
+ * Limite assumée : deux projets IMBRIQUÉS (une app dans un sous-dossier du repo)
443
+ * partagent le préfixe → le Vite de l'app peut être adopté par le parent.
444
+ */
445
+ export declare function splitByProject(procs: readonly DevProcessInfo[], projectCwd: string, getCwd?: (pid: number) => string | null): {
446
+ mine: DevProcessInfo[];
447
+ foreign: DevProcessWithCwd[];
448
+ };
449
+ /**
450
+ * `true` si `cwd` ressemble à un projet Nodefony : `package.json` déclarant la
451
+ * dépendance `nodefony`, OU `node_modules/nodefony` présent (app installée sans
452
+ * la déclarer). MÊME heuristique que `Kernel.resolveAppEntry` (détection d'app),
453
+ * mais STANDALONE (fs seul, aucun kernel) — pour que `nodefony status`/`stop`
454
+ * lancés hors projet le DISENT au lieu de suggérer un `nodefony dev` voué à
455
+ * l'échec.
456
+ *
457
+ * @param cwd - dossier à tester.
458
+ */
459
+ export declare function isNodefonyProjectDir(cwd: string): boolean;
460
+ /**
461
+ * Racines de projet des runtimes ÉTRANGERS = cwd des rôles racine
462
+ * (supervisor/master/server/worker), toujours spawnés à la racine de leur projet.
463
+ * Un Vite, lui, peut travailler dans un sous-dossier : il se rattache par préfixe.
464
+ *
465
+ * Fonction PURE, partagée par le groupement d'affichage
466
+ * ({@link formatForeignRuntimes}) et l'attribution des ports
467
+ * ({@link foreignPortOwners}) — deux lectures du même découpage, une seule règle.
468
+ */
469
+ export declare function foreignProjectRoots(foreign: readonly DevProcessWithCwd[]): string[];
470
+ /**
471
+ * À QUI appartient chaque port occupé, quand ce n'est pas à nous.
472
+ *
473
+ * Un port tenu par le voisin n'est pas un arrêt qui a échoué : `stop` marquait
474
+ * `✗ encore occupé` les ports 5151/5152 juste après avoir annoncé lui-même que ces
475
+ * runtimes appartenaient à un AUTRE projet — la croix suggérait un échec là où il
476
+ * n'y avait rien à arrêter. Et `status`, faute de cette distinction, annonçait
477
+ * « 2/2 ports UP » à une application qui ne tournait pas.
478
+ *
479
+ * On interroge le canal que chaque projet publie sur lui-même
480
+ * ({@link readRuntimeState}) : c'est la seule source qui dise les ports EFFECTIFS
481
+ * quand `portPolicy: "auto"` les a décalés. Lecture SANS purge — le ménage d'un
482
+ * projet étranger ne nous appartient pas.
483
+ *
484
+ * @param foreign - runtimes d'autres projets (sortie `splitByProject().foreign`).
485
+ * @param readState - lecture d'un état de projet (injectable pour les tests).
486
+ * @returns port → racine du projet qui le tient (objet nu : sérialisable JSON,
487
+ * donc transportable tel quel par le data plane, là où une `Map` se perdrait).
488
+ */
489
+ export declare function foreignPortOwners(foreign: readonly DevProcessWithCwd[], readState?: (cwd: string) => RuntimeState | null): Record<number, string>;
490
+ /** Appartenance d'un port sondé — ce que le symbole affiché doit distinguer. */
491
+ export type PortOwnership =
492
+ /** Personne n'écoute. */
493
+ "free"
494
+ /** Occupé par un projet Nodefony IDENTIFIÉ, qui n'est pas le nôtre. */
495
+ | "foreign"
496
+ /** Occupé sans propriétaire identifié (notre runtime, ou un tiers quelconque). */
497
+ | "occupied";
498
+ /**
499
+ * Qualifie un port sondé à partir des propriétaires connus
500
+ * ({@link foreignPortOwners}). Fonction PURE : c'est LA règle « pas à moi ≠ pas
501
+ * mort », et elle vit à un seul endroit pour que `status` et `stop` la lisent pareil.
502
+ */
503
+ export declare function portOwnership(state: PortState, owners?: Record<number, string>): PortOwnership;
504
+ /**
505
+ * Met en forme les runtimes ÉTRANGERS (autre projet) en bloc multi-lignes AÉRÉ :
506
+ * groupés par racine de projet (un Vite au cwd sous-dossier est rattaché à la
507
+ * racine qui le préfixe, affiché en relatif), un process par ligne (pid + rôle),
508
+ * puis les commandes EXACTES à copier-coller pour les arrêter. Partagé par le
509
+ * refus de boot (`DevSupervisor`), `nodefony dev --detach`, `nodefony stop` et
510
+ * `nodefony status` — même pédagogie partout (vécu : un pavé mono-ligne de 4 pids,
511
+ * dev bloqué sans savoir QUOI taper).
512
+ *
513
+ * @param foreign - runtimes d'autres projets (sortie `splitByProject().foreign`).
514
+ * @returns lignes prêtes à afficher (sans couleur ; l'appelant préfixe/colore).
515
+ */
516
+ export declare function formatForeignRuntimes(foreign: readonly DevProcessWithCwd[]): string[];
517
+ /**
518
+ * `true` si un service écoute sur `port` en loopback (connexion acceptée). Inverse de
519
+ * la sonde « port libre » du superviseur : ici on confirme qu'un serveur RÉPOND.
520
+ */
521
+ export declare function isPortListening(port: number, host?: string, timeoutMs?: number): Promise<boolean>;
522
+ /** Sonde TCP de plusieurs ports en parallèle. */
523
+ export declare function probePorts(ports: readonly number[]): Promise<PortState[]>;
524
+ /** Formate une durée (s) en libellé court (`45s`, `2m14s`, `1h03m`, `2d 05h`). */
525
+ export declare function formatUptime(sec: number): string;
526
+ /**
527
+ * Parse UNE ligne `ps` (pid ppid rss pcpu etime command) en {@link DevProcessInfo},
528
+ * ou `null` si la ligne ne matche pas ou n'est pas un process dev connu. `%CPU` toléré
529
+ * avec point OU virgule décimale (robustesse locale — la virgule FR a déjà fait passer
530
+ * la détection à zéro). Fonction PURE (testable sans `ps`).
531
+ */
532
+ export declare function parsePsRow(line: string): DevProcessInfo | null;
533
+ /** Options de {@link discoverDevProcesses}. */
534
+ export interface DiscoverOptions {
535
+ /**
536
+ * Inclure le process APPELANT s'il porte lui-même un titre dev connu. Défaut
537
+ * `false` (comportement CLI : `nodefony status`/`stop` tournent dans un process
538
+ * standalone qui n'est PAS un process dev → l'exclusion est neutre). Le data
539
+ * plane (`GET /kernel/api/processes`) tourne DANS le serveur enfant
540
+ * (`nodefony-dev-server`) → il doit `includeSelf:true` pour SE compter, sinon
541
+ * le rôle « server » manquerait à la topologie rapportée.
542
+ */
543
+ readonly includeSelf?: boolean;
544
+ }
545
+ /**
546
+ * Sondes système d'un rapport de process (`nodefony status`, `nodefony stop`),
547
+ * INJECTABLES. Les trois valeurs par défaut sont les vraies sondes ; les fournir
548
+ * permet d'éprouver un rapport complet — y compris ses libellés — sans dépendre de
549
+ * ce qui tourne sur la machine, et sans jamais risquer de signaler un process réel.
550
+ */
551
+ export interface DevObservationDeps {
552
+ /** Observation externe des process (défaut : {@link discoverDevProcessesDetailed}). */
553
+ readonly discover?: (opts: DiscoverOptions) => ProcessDiscovery;
554
+ /** Répertoire courant d'un pid (défaut : {@link processCwd}) — clé du scoping projet. */
555
+ readonly getCwd?: (pid: number) => string | null;
556
+ /** Sonde TCP des ports (défaut : {@link probePorts}). */
557
+ readonly probe?: (ports: readonly number[]) => Promise<PortState[]>;
558
+ /**
559
+ * Demande au runtime s'il peut SERVIR (défaut : `probeReadiness`, canal
560
+ * `livez`). Injectable pour éprouver un rapport sans réseau. Rend `null`
561
+ * quand rien d'exploitable n'a été obtenu — jamais un verdict deviné.
562
+ */
563
+ readonly probeReadiness?: (port: number) => Promise<{
564
+ readonly ready: boolean;
565
+ readonly blocked: number;
566
+ } | null>;
567
+ /** Écriture du rapport (défaut : `writeSync(1, …)` — un seul écrit, jamais tronqué). */
568
+ readonly write?: (chunk: string) => void;
569
+ }
570
+ /** Résultat d'une tentative d'observation externe — le VERDICT avec la liste. */
571
+ export interface ProcessDiscovery {
572
+ /**
573
+ * `true` si `ps` a réellement répondu. Distingue « aucun process » de « je n'ai pas
574
+ * pu regarder » — deux états que la seule liste vide confondait, et dont dépend
575
+ * l'existence d'un repli.
576
+ */
577
+ readonly supported: boolean;
578
+ readonly procs: DevProcessInfo[];
579
+ }
580
+ /**
581
+ * Découvre les process dev Nodefony vivants par OBSERVATION EXTERNE (`ps`), et DIT si
582
+ * l'observation a eu lieu.
583
+ *
584
+ * Ne retient que les process dont la commande porte un titre dev connu (superviseur /
585
+ * serveur / Vite) et en extrait PID/PPID/RSS/CPU/uptime. S'auto-exclut par défaut (le
586
+ * process appelant) sauf `opts.includeSelf`. Tri : superviseur, puis serveur, puis Vite.
587
+ *
588
+ * @remarks La disponibilité de `ps` ne se DÉDUIT pas de la plateforme, elle se CONSTATE.
589
+ * La supposer d'après `process.platform` revenait à parier que tout ce qui n'est pas
590
+ * Windows embarque `ps` — faux là où ça compte le plus : `procps` n'est pas installé
591
+ * dans les images Node minces (`node:*-slim`, distroless, Alpine nu) qui SONT le
592
+ * modèle de déploiement de Nodefony, et les BSD n'acceptent pas forcément cette
593
+ * syntaxe. Le pari donnait alors « aucun process » sans repli et sans un mot. On rend
594
+ * donc `supported:false` sur tout ce qui empêche de conclure : plateforme sans `ps`,
595
+ * binaire absent (`ENOENT`), code de sortie non nul, sortie illisible.
596
+ */
597
+ export declare function discoverDevProcessesDetailed(opts?: DiscoverOptions): ProcessDiscovery;
598
+ /**
599
+ * Liste seule des process observés — commodité pour les appelants qui n'ont rien à
600
+ * décider du « je n'ai pas pu regarder » (le rendu d'un tableau, un décompte).
601
+ * Quiconque doit choisir un REPLI prend {@link discoverDevProcessesDetailed}, sans quoi
602
+ * une liste vide se lit « rien ne tourne » alors qu'elle peut signifier l'inverse.
603
+ */
604
+ export declare function discoverDevProcesses(opts?: DiscoverOptions): DevProcessInfo[];
605
+ /**
606
+ * Modes runtime présents parmi les process PRINCIPAUX (Vite exclu — un Vite ne « tient »
607
+ * pas les ports serveur). Set vide = aucun runtime principal vivant. Fonction PURE.
608
+ */
609
+ export declare function runtimeModes(procs: readonly DevProcessInfo[]): Set<RuntimeMode>;
610
+ /**
611
+ * Mode runtime dominant observé, ou `null` si aucun process principal. Priorité
612
+ * dev > cluster > prod en cas de cohabitation anormale (le conflit est signalé par
613
+ * ailleurs en warning / refus). Fonction PURE.
614
+ */
615
+ export declare function detectRuntimeMode(procs: readonly DevProcessInfo[]): RuntimeMode | null;
616
+ /**
617
+ * Process PRINCIPAUX appartenant à un runtime d'un mode DIFFÉRENT de `intended` — un
618
+ * conflit de cohabitation (ex. un `prod`/`cluster` occupe les ports quand on veut
619
+ * démarrer en `dev`, ou l'inverse). Vite exclu (enfant). Sert aux gardes anti-collision :
620
+ * fail-loud (refus + message), JAMAIS de kill cross-mode automatique (un prod est
621
+ * intentionnel). Fonction PURE.
622
+ */
623
+ export declare function findRuntimeConflict(procs: readonly DevProcessInfo[], intended: RuntimeMode): DevProcessInfo[];
624
+ /**
625
+ * Liste les workspaces qui DEVRAIENT produire un dist (présence d'un `rolldown.config.ts`)
626
+ * mais dont le dossier `dist/` est absent ou vide — renvoie leurs **noms de package**
627
+ * (pour `turbo --filter`). On cible l'ABSENCE de build, pas l'entrée exacte (le core
628
+ * sort `dist/node/…`, d'autres `dist/index.js`) → vérifier « dist non vide » est le
629
+ * critère robuste et uniforme.
630
+ *
631
+ * POST-CONDITION du build du superviseur : `turbo run build` peut renvoyer 0 en « cache
632
+ * hit » SANS restaurer un dist supprimé (gitignored, `clean` partiel, checkout de
633
+ * branche) → le module manquant tombe en fail-soft au boot et cascade en silence
634
+ * (« vert mais cassé »). On vérifie le terrain (la confiance n'exclut pas le contrôle).
635
+ * Pur filesystem, aucun boot. Un workspace sans config de bundler (WIP non câblé) est
636
+ * ignoré : aucun dist n'est attendu de lui.
637
+ */
638
+ export declare function missingWorkspaceDists(cwd: string): string[];