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,147 @@
1
+ /**
2
+ * platformChannels — **espace de nommage des surfaces temps réel de la plateforme**,
3
+ * partagé par les deux bords de la socket (serveur et navigateur).
4
+ *
5
+ * Tout ce que Nodefony expose sur la socket pour parler **de lui-même** (journaux,
6
+ * santé de la base, métriques du process, supervision du cluster, journal d'audit,
7
+ * contrôle du pod) porte le préfixe {@link NODEFONY_CHANNEL_NAMESPACE}. Ce que
8
+ * l'application expose pour parler de **son métier** ne le porte pas.
9
+ *
10
+ * C'est la même convention que les routes d'administration (`/nodefony/<module>/api/*`) :
11
+ * une seule marque, des deux côtés du transport. Avant, chaque sonde apportait son
12
+ * propre namespace (`syslog:`, `orm:`, `dashboard:`, `node:`…) — neuf territoires pour
13
+ * une douzaine de canaux, dont un (`node:`) qui percutait le préfixe d'import des
14
+ * modules natifs Node et polluait tout audit.
15
+ *
16
+ * **La table est la source unique** : personne n'écrit un nom de canal de plateforme en
17
+ * clair, ni côté serveur (producteurs) ni côté navigateur (consommateurs). Une chaîne
18
+ * recopiée dans un écran est une chaîne qui survivra au renommage suivant.
19
+ *
20
+ * Pur et isomorphe (aucun import, aucune allocation) : chargé aussi bien dans le bundle
21
+ * navigateur que dans le pod.
22
+ *
23
+ * @see {@link rateChannel} — le suffixe de cadence (`base:<ms>`) se compose PAR-DESSUS
24
+ * ces bases ; ajouter un segment au préfixe ne le perturbe pas.
25
+ */
26
+ /**
27
+ * Marque des surfaces de plateforme sur la socket. Un canal qui commence par ce préfixe
28
+ * décrit le serveur, jamais le métier de l'application.
29
+ *
30
+ * Conséquence côté sécurité : ces canaux ont un **plancher irréductible**
31
+ * (authentification exigée, et sans module de sécurité ils sont purement fermés aux
32
+ * connexions clientes). Une application ne peut pas se les approprier par accident —
33
+ * c'est tout l'intérêt d'une marque en toutes lettres plutôt que d'un mot courant.
34
+ */
35
+ export declare const NODEFONY_CHANNEL_NAMESPACE = "nodefony:";
36
+ /**
37
+ * Canaux de **diffusion** de la plateforme (le serveur pousse, les écrans regardent).
38
+ *
39
+ * Les valeurs sont des **bases** : trois d'entre elles se déclinent par cible
40
+ * (`…@<pid>` pour un forage sur un process, `…@<id>` pour un job) et toutes acceptent
41
+ * le suffixe de cadence `:<ms>` (cf {@link rateChannel}). Composer, jamais concaténer
42
+ * un préfixe à la main.
43
+ */
44
+ export declare const PLATFORM_CHANNELS: {
45
+ /** Journaux du pod (flux de `Pdu`, coalescé par le pont syslog). */
46
+ readonly syslog: "nodefony:syslog";
47
+ /** Journal d'audit sécurité — plancher super-admin, un cran au-dessus des autres. */
48
+ readonly audit: "nodefony:audit";
49
+ /** Métriques agrégées du tableau de bord (vue d'ensemble). */
50
+ readonly dashboard: "nodefony:dashboard";
51
+ /** Supervision des process du cluster ; forage par process : `…@<pid>`. */
52
+ readonly supervision: "nodefony:supervision";
53
+ /** Sondes de la barre de debug (mêmes mesures que la supervision, ticker séparé). */
54
+ readonly debugbar: "nodefony:debugbar";
55
+ /** Auto-observabilité de la socket elle-même (canaux, abonnés, fan-out, backpressure). */
56
+ readonly socket: "nodefony:socket";
57
+ /** Santé des connecteurs de base (état, ping). */
58
+ readonly ormHealth: "nodefony:orm:health";
59
+ /** Flux ORM (débit de requêtes, latence, requêtes lentes) — plus dynamique que la santé. */
60
+ readonly ormFlow: "nodefony:orm:flow";
61
+ /** Forage détaillé d'un connecteur sur un process donné : `…@<pid>`. */
62
+ readonly ormRich: "nodefony:orm:rich";
63
+ /** Sortie d'un job de génération de code : `…@<jobId>` (développement uniquement). */
64
+ readonly scaffoldJob: "nodefony:scaffold:job";
65
+ };
66
+ /**
67
+ * Canaux **MONTANTS** de la plateforme (le navigateur pousse, le pod reçoit).
68
+ *
69
+ * Ils vivent dans une table à part parce qu'ils sont l'inverse de
70
+ * {@link PLATFORM_CHANNELS} : là un écran regarde, ici un écran ÉCRIT. Les mélanger
71
+ * ferait passer une surface d'écriture pour une surface de lecture au premier coup
72
+ * d'œil — et c'est précisément la distinction qui décide des bornes à poser.
73
+ *
74
+ * Ils portent la même marque `nodefony:`, donc le même **plancher irréductible**
75
+ * (authentification exigée ; sans module de sécurité, fermés aux connexions
76
+ * clientes). C'est le défaut voulu : un journal d'exploitation ouvert en écriture
77
+ * anonyme se noie et se falsifie. Une application qui veut capter les erreurs de
78
+ * visiteurs non authentifiés le déclare explicitement, et hérite des bornes.
79
+ */
80
+ export declare const PLATFORM_INBOUND: {
81
+ /** Journaux du navigateur remontés vers le `Syslog` du pod (lots de `Pdu`). */
82
+ readonly syslogUplink: "nodefony:syslog:uplink";
83
+ };
84
+ /** Nom d'un canal montant de plateforme (valeur de {@link PLATFORM_INBOUND}). */
85
+ export type PlatformInboundChannel = (typeof PLATFORM_INBOUND)[keyof typeof PLATFORM_INBOUND];
86
+ /**
87
+ * Méthodes **RPC** de la plateforme (le client demande, le serveur répond).
88
+ *
89
+ * Elles portent la même marque que les canaux pour la même raison : ce sont des
90
+ * surfaces du serveur, pas de l'application. `nodefony:kernel:gc` déclenche un cycle
91
+ * de ramasse-miettes bloquant — un nom aussi lourd de conséquences n'a rien à faire
92
+ * dans l'espace de nommage où une application déclare ses propres actions.
93
+ *
94
+ * ⚠️ À ne pas confondre avec les **notifications du protocole** (`realtime:welcome`,
95
+ * `realtime:denied`) : celles-là décrivent la mécanique de la socket elle-même, pas
96
+ * une surface de la plateforme, et ne sont ni des canaux ni des actions.
97
+ */
98
+ export declare const PLATFORM_METHODS: {
99
+ /** Liveness + mesure du temps d'aller-retour. */
100
+ readonly ping: "nodefony:kernel:ping";
101
+ /** Force un cycle GC (seulement si le pod tourne avec `--expose-gc`). */
102
+ readonly gc: "nodefony:kernel:gc";
103
+ /** Ce qu'un scaffold écrirait — fichiers créés, diff des réécritures — sans rien écrire. */
104
+ readonly scaffoldPreview: "nodefony:scaffold:preview";
105
+ /** Démarre un job de génération de code et rend son identifiant. */
106
+ readonly scaffoldRun: "nodefony:scaffold:run";
107
+ /** Demande l'arrêt d'un job de génération en cours. */
108
+ readonly scaffoldCancel: "nodefony:scaffold:cancel";
109
+ };
110
+ /**
111
+ * Événements **DOM** de la plateforme (`window`), dans le même espace de nommage.
112
+ *
113
+ * Ils ne passent pas par la socket — ce sont des `CustomEvent` que le navigateur
114
+ * fait circuler entre la barre de debug, le pont HMR et l'écran qui les écoute.
115
+ * Ils portent la marque pour la même raison que les canaux : `window` est un
116
+ * espace partagé avec l'application, et un nom d'événement générique s'y
117
+ * télescoperait.
118
+ */
119
+ export declare const PLATFORM_EVENTS: {
120
+ /** Un hot-update Vite vient d'être appliqué (émis par le pont du template). */
121
+ readonly hmr: "nodefony:hmr";
122
+ /** L'utilisateur a choisi une entrée dans la barre de debug. */
123
+ readonly debugbarSelect: "nodefony:debugbar:select";
124
+ };
125
+ /** Nom d'un canal de plateforme (valeur de {@link PLATFORM_CHANNELS}). */
126
+ export type PlatformChannel = (typeof PLATFORM_CHANNELS)[keyof typeof PLATFORM_CHANNELS];
127
+ /** Nom d'une méthode RPC de plateforme (valeur de {@link PLATFORM_METHODS}). */
128
+ export type PlatformMethod = (typeof PLATFORM_METHODS)[keyof typeof PLATFORM_METHODS];
129
+ /**
130
+ * `s` commence-t-il par `prefix`, **insensible à la casse** et sans allocation ?
131
+ *
132
+ * La casse doit être neutralisée : sinon `NODEFONY:syslog` échapperait au plancher que
133
+ * `nodefony:syslog` subit — un contournement à un `toUpperCase()` près. Comparaison
134
+ * caractère par caractère plutôt que `toLowerCase()` : ce test est sur le chemin
135
+ * d'abonnement, on n'y alloue pas de chaîne.
136
+ */
137
+ export declare function startsWithCI(s: string, prefix: string): boolean;
138
+ /**
139
+ * Le nom désigne-t-il une surface de la plateforme (canal OU méthode) ?
140
+ *
141
+ * Un seul `startsWith` insensible à la casse, là où il fallait auparavant parcourir
142
+ * neuf préfixes à chaque abonnement.
143
+ *
144
+ * @param name - nom du canal demandé (suffixes de cadence/forage inclus) ou de la
145
+ * méthode RPC appelée.
146
+ */
147
+ export declare function isPlatformChannel(name: string): boolean;
@@ -0,0 +1,96 @@
1
+ /**
2
+ * Ordonnanceur de **maintenance périodique** (« garbage collection ») exécutée
3
+ * HORS du chemin d'une requête — pattern unifié du framework pour purger des
4
+ * entrées expirées d'un store (sessions, jetons/PAT, clés d'idempotence, audit…).
5
+ *
6
+ * Motivation : la purge ne doit JAMAIS vivre dans le hot path ni être
7
+ * probabiliste (l'ancien modèle PHP `gc_probability` affamait les serveurs à bas
8
+ * trafic et payait le scan p99 du tirage malchanceux). Ce composant centralise le
9
+ * **bon** pattern — auparavant dupliqué dans `TokenService` et `SessionsService`,
10
+ * et absent (ou dégradé) ailleurs :
11
+ *
12
+ * 1. **délai de départ** (laisse passer le boot) **+ jitter** borné : décale les
13
+ * balayages entre process d'un cluster sur un store partagé (anti
14
+ * *thundering herd* — N pods ne scannent pas la même base au même instant) ;
15
+ * 2. **`unref()`** sur les timers : n'empêchent pas l'arrêt propre du process ;
16
+ * 3. **anti-empilement** : une seule passe concurrente (si une passe déborde
17
+ * l'intervalle, le tick suivant est ignoré, pas empilé) ;
18
+ * 4. **désarmement idempotent** (`stop()`) au shutdown ;
19
+ * 5. **`intervalS ≤ 0` ⇒ désarmé** : délègue la purge à un worker cron / k8s
20
+ * CronJob, ou au TTL natif du store (Redis) — sans brancher de code.
21
+ *
22
+ * Isomorphe : n'utilise que `setTimeout`/`setInterval` (globaux) et `unref?.()`
23
+ * (gardé — absent côté navigateur, où ce composant n'est de toute façon jamais
24
+ * instancié). Aucune dépendance au kernel → testable et réutilisable partout.
25
+ *
26
+ * ⚠️ Réservé au **lifecycle** (1 instance / store / process), jamais au hot path.
27
+ *
28
+ * @module
29
+ */
30
+ /** Options de construction d'un {@link GcScheduler}. */
31
+ export interface IGcSchedulerOptions {
32
+ /**
33
+ * Intervalle entre deux passes, en **secondes**. `≤ 0` = ordonnanceur désarmé
34
+ * (la maintenance est déléguée à un worker externe ou au TTL natif du store).
35
+ */
36
+ intervalS: number;
37
+ /**
38
+ * La passe de maintenance (typiquement `() => store.gc()`). Peut être sync ou
39
+ * async ; ses rejets sont capturés (jamais d'`unhandledRejection`).
40
+ */
41
+ run: () => Promise<unknown> | unknown;
42
+ /**
43
+ * Étale le **départ** d'un délai aléatoire borné (anti *thundering herd* en
44
+ * cluster). Défaut `true`. Une fois lancés, les ticks restent décalés.
45
+ */
46
+ jitter?: boolean;
47
+ /** Reçoit l'erreur d'une passe qui a levé (sinon l'échec est silencieux). */
48
+ onError?: (error: unknown) => void;
49
+ /**
50
+ * Délai fixe avant la **première** passe (ms, défaut `30_000`) — laisse finir
51
+ * le boot avant de scanner.
52
+ */
53
+ initialDelayMs?: number;
54
+ /** Plafond du jitter (ms, défaut `60_000`) — borne le retard de la 1ʳᵉ passe. */
55
+ jitterCapMs?: number;
56
+ }
57
+ /**
58
+ * Timer de maintenance déterministe, jittéré et désarmable. Voir la doc du
59
+ * module pour le rationnel complet.
60
+ *
61
+ * @example
62
+ * ```ts
63
+ * const gc = new GcScheduler({
64
+ * intervalS: config.gcIntervalS,
65
+ * jitter: config.gcJitter,
66
+ * run: () => store.gc(),
67
+ * onError: (e) => this.log(e, "WARNING"),
68
+ * });
69
+ * gc.start(); // au boot / onReady
70
+ * // …
71
+ * gc.stop(); // au onTerminate
72
+ * ```
73
+ */
74
+ export declare class GcScheduler {
75
+ #private;
76
+ constructor(opts: IGcSchedulerOptions);
77
+ /** `true` si l'ordonnanceur est armé (délai initial en cours OU timer récurrent). */
78
+ get armed(): boolean;
79
+ /**
80
+ * Arme l'ordonnanceur. Idempotent (no-op si déjà armé). Retourne `false` si
81
+ * `intervalS ≤ 0` (désarmé volontaire — délégation cron / TTL natif), `true`
82
+ * si un timer a été posé. Premier balayage après `initialDelayMs (+ jitter)`,
83
+ * puis tous les `intervalS`.
84
+ */
85
+ start(): boolean;
86
+ /**
87
+ * Exécute une passe **immédiatement** — point d'entrée public (le timer
88
+ * l'appelle ; un worker cron / une commande batch peut l'appeler à sa place).
89
+ * Anti-empilement : ignore l'appel si une passe court déjà. **Ne lève jamais**
90
+ * — une erreur va à `onError`, pour ne pas tuer le déclencheur (retry au tick
91
+ * suivant).
92
+ */
93
+ runNow(): Promise<void>;
94
+ /** Désarme les timers (idempotent) — à appeler au shutdown. */
95
+ stop(): void;
96
+ }
@@ -0,0 +1,152 @@
1
+ /**
2
+ * Une requête ORM (SQL/NoSQL) capturée pendant le scope de requête, pour le
3
+ * profiler dev-only. Shape canonique partagée par tous les adapters ORM et le
4
+ * Profiler `@nodefony/http` (structurellement identique à `ProfileQuery`).
5
+ */
6
+ export interface IProfilerQuery {
7
+ /** Requête (SQL ou commande NoSQL), tronquée si volumineuse. */
8
+ sql: string;
9
+ /**
10
+ * Début relatif (`performance.now()`, ms) — même horloge que
11
+ * `PhaseTiming.startMs` du Context, donc la requête se PLACE dans le waterfall
12
+ * des phases (le SQL apparaît DANS la barre `action`), au lieu de flotter en
13
+ * liste à côté. Absent si l'adapter ne l'a pas fourni.
14
+ */
15
+ startMs?: number;
16
+ /** Durée d'exécution en ms. */
17
+ durationMs: number;
18
+ /** Lignes affectées/retournées, si connu. */
19
+ rows?: number;
20
+ /** Connecteur émetteur (`drizzle`, `mongoose`…). */
21
+ connector?: string;
22
+ }
23
+ /**
24
+ * Per-request state propagated transparently across the async pipeline.
25
+ *
26
+ * Set by HttpKernel at request entry (`handleHttp` / `handleWebsocket`) and
27
+ * accessible from any downstream service (logs, ORM, security decorators)
28
+ * without manually threading the context.
29
+ *
30
+ * Open shape — modules add their own keys (security adds `user`, audit
31
+ * adds `traceparent`, etc.). Keep keys flat and primitive when possible.
32
+ */
33
+ export interface RequestContextPayload {
34
+ requestId: string;
35
+ scheme?: string;
36
+ /** Set by the security firewall after `afterAuth` (P6). */
37
+ userId?: string;
38
+ /** Set by the security firewall after `afterAuth` (P6). IUser instance. */
39
+ user?: unknown;
40
+ /** W3C traceparent header for OpenTelemetry compatibility (P2.7). */
41
+ traceparent?: string;
42
+ /**
43
+ * Buffer de requêtes ORM du profiler — **présent uniquement en dev** quand
44
+ * le `HttpKernel` l'alloue (profiler actif). Son absence = signal « ne pas
45
+ * profiler » : les adapters ORM gardent un coût nul en prod. Même référence
46
+ * que `context.profilerQueries`, lue par `Profiler.collect()` au teardown.
47
+ *
48
+ * ⚠️ Contrat sécurité : un adapter qui pousse ici DOIT redacter le `sql`
49
+ * via {@link redactSecrets} AVANT le push (le SQL interpolé peut contenir un
50
+ * credential). Le SQL paramétré (placeholders `?`, ex. Drizzle) est déjà
51
+ * credential-free ; le SQL interpolé (ex. un ORM en mode `logging`) ne l'est pas.
52
+ */
53
+ queries?: IProfilerQuery[];
54
+ /**
55
+ * Contexte transport courant (`HttpContext` / `WebsocketContext`), posé par
56
+ * `HttpKernel` à l'entrée du scope (V4.1). Typé `unknown` ici : le core ne
57
+ * connaît pas `@nodefony/http` — les consommateurs (helpers `Controller`,
58
+ * décorateurs) castent. Permet aux controllers **singleton** (stateless) de
59
+ * retrouver le contexte de LA requête en cours sans le porter sur `this`.
60
+ */
61
+ context?: unknown;
62
+ /**
63
+ * Corps de la requête posé par le **pont WS-RPC `api.request`** (mutations) :
64
+ * en WebSocket il n'existe aucun corps HTTP parsé, donc le pont transporte la
65
+ * charge utile de la frame ici (per-invocation via `RequestContext.run` → zéro
66
+ * bleed entre frames concurrentes de la même socket). Lu par
67
+ * `AdminApiController.buildRequest` en priorité sur `queryPost` (vide en WS).
68
+ * Absent en HTTP (le corps vient du pipeline → `queryPost`).
69
+ */
70
+ body?: unknown;
71
+ /**
72
+ * Clé d'idempotence (modèle Stripe) portée par une **mutation** du data plane
73
+ * admin : posée par le pont WS (`params.idempotencyKey`) ou lue de l'en-tête
74
+ * HTTP `Idempotency-Key`. Sert à dédoublonner un rejeu (socket qui reconnecte)
75
+ * → cache borné scopé à l'identité. Absente = pas de dédup (GET, HTTP legacy).
76
+ */
77
+ idempotencyKey?: string;
78
+ /**
79
+ * Puits de CAPTURE du rendu, posé par le **pont WS-RPC `api.request`** : une
80
+ * action user peut répondre par un RENDU (`renderJson`/`renderView`) au lieu
81
+ * d'une valeur nue. En HTTP ce rendu écrit la réponse ; via le pont il ne
82
+ * doit JAMAIS écrire une frame nue sur la socket (hors protocole JSON-RPC —
83
+ * et le retour `WebsocketResponse` est circulaire → `JSON.stringify` de
84
+ * l'enveloppe casserait la chaîne du peer). Quand ce sink est présent,
85
+ * `WebsocketContext.send()` capture le payload ici au lieu de l'émettre ; le
86
+ * pont le sert ensuite en `result` RPC. Per-invocation via
87
+ * `RequestContext.run` → zéro bleed entre frames concurrentes d'une socket.
88
+ */
89
+ renderSink?: {
90
+ body?: string | Buffer;
91
+ };
92
+ /**
93
+ * Profil de l'**invocation** en cours (`FrameProfile` de `@nodefony/http`),
94
+ * posé par le pont WS-RPC. Porte les phases et le buffer ORM de CETTE frame :
95
+ * le contexte WebSocket, lui, vit pour toute la connexion — y empiler des
96
+ * phases produirait une timeline cumulative, donc fausse. Typé `unknown` (le
97
+ * core ne connaît pas `@nodefony/http`) ; absent en HTTP, où le contexte EST
98
+ * l'unité de requête. Présent seulement quand le profiler dev ou le timing
99
+ * sont actifs.
100
+ */
101
+ invocation?: unknown;
102
+ [key: string]: unknown;
103
+ }
104
+ /**
105
+ * AsyncLocalStorage facade — single shared instance per process. Lazily
106
+ * constructed so importing this module has zero cost if `run()` is never
107
+ * called (the ALS allocation is the only cost).
108
+ *
109
+ * Perf : `als.run` adds ~50-100 ns per request on Node 22+. `.getStore()`
110
+ * is a hot-path read — keep it cheap.
111
+ */
112
+ declare class RequestContext {
113
+ private static _als;
114
+ private static get als();
115
+ /** Enter a new request scope. All `await`s inside `fn` see the payload. */
116
+ static run<T>(payload: RequestContextPayload, fn: () => T): T;
117
+ /** Returns the current payload, or `undefined` outside any request scope. */
118
+ static get(): RequestContextPayload | undefined;
119
+ /** Shortcut — returns the current requestId or `undefined`. */
120
+ static getRequestId(): string | undefined;
121
+ /** Shortcut — returns the current authenticated user (P6) or `undefined`. */
122
+ static getUser(): unknown | undefined;
123
+ /**
124
+ * Shortcut — returns the current transport context (V4.1) or `undefined`.
125
+ * Générique car le core ne connaît pas les types de `@nodefony/http` :
126
+ * `RequestContext.getContext<ContextType>()` côté framework.
127
+ */
128
+ static getContext<T = unknown>(): T | undefined;
129
+ /** Shortcut — returns the current userId (P6) or `undefined`. */
130
+ static getUserId(): string | undefined;
131
+ /**
132
+ * Mutate the current payload in place. No-op outside a scope.
133
+ * Used by security after login to inject `user`/`userId` without re-running.
134
+ */
135
+ static set<K extends keyof RequestContextPayload>(key: K, value: RequestContextPayload[K]): void;
136
+ /**
137
+ * `true` si un buffer de profiling de requêtes ORM est actif sur le scope
138
+ * courant (dev + `HttpKernel` profiler activé). Les adapters ORM lisent ce
139
+ * flag AVANT de mesurer (`performance.now()`) pour rester gratuits en prod.
140
+ *
141
+ * @returns `true` si `pushQuery` aura un effet, `false` sinon.
142
+ */
143
+ static isProfiling(): boolean;
144
+ /**
145
+ * Pousse une requête ORM dans le buffer de profiling du scope courant.
146
+ * No-op hors scope ou hors dev (buffer absent) → coût nul en prod.
147
+ *
148
+ * @param query - requête capturée (sql, durée, lignes, connecteur).
149
+ */
150
+ static pushQuery(query: IProfilerQuery): void;
151
+ }
152
+ export default RequestContext;
@@ -0,0 +1,88 @@
1
+ /**
2
+ * Extraction du jeton d'un en-tête `Authorization: Bearer …` — sans expression
3
+ * régulière, et volontairement.
4
+ *
5
+ * Le motif d'origine, `/^bearer\s+(.+)$/i`, était dupliqué dans deux
6
+ * authentificateurs et **quadratique** : `\s+` suivi de `(.+)` laisse le moteur
7
+ * essayer chaque point de découpage entre les deux quantificateurs. Un client
8
+ * anonyme envoyant `Bearer ` suivi de milliers d'espaces faisait donc brûler du
9
+ * temps processeur à chaque requête — sur la boucle d'événements, qui est
10
+ * unique. Aggravant : le test de support s'exécute AVANT toute authentification,
11
+ * donc le coût se paie pour un porteur qui n'a rien prouvé, et la taille
12
+ * d'en-tête tolérée par Node (16 Kio) suffit largement à le rendre sensible.
13
+ *
14
+ * Ici, tout est linéaire : une comparaison de préfixe, un saut d'espaces, une
15
+ * découpe. Aucun retour arrière n'est possible parce qu'il n'y a pas d'automate.
16
+ *
17
+ * **Séparateur restreint à l'espace et à la tabulation** : c'est ce que la
18
+ * RFC 9110 §5.6.3 autorise entre le schéma et ses paramètres (`OWS`). `\s`
19
+ * acceptait retours à la ligne et espaces Unicode — plus permissif que la norme,
20
+ * pour aucun bénéfice.
21
+ *
22
+ * ## Pourquoi au CŒUR, et pas dans le module de sécurité
23
+ *
24
+ * Deux couches lisent le même en-tête sans pouvoir se voir : les
25
+ * authentificateurs de `@nodefony/security`, et la porte MCP, dont le protocole
26
+ * vit ici. Une frontière de paquets aurait imposé une copie — or une copie de
27
+ * cette fonction ne diverge pas bruyamment : elle diverge sur un cas limite
28
+ * (`Bearer …`, `Bearer` sans séparateur) que chaque copie continue de
29
+ * passer dans ses propres tests. La règle « 1 règle = 1 implémentation » veut
30
+ * donc qu'elle vive au niveau que les deux peuvent atteindre — le plus bas.
31
+ *
32
+ * Elle est ici, et non dans un dossier `mcp/`, parce qu'elle ne doit rien à ce
33
+ * protocole : c'est de la sémantique HTTP, lue à chaque requête entrante.
34
+ */
35
+ /**
36
+ * Ce que porte un en-tête `Authorization` — et surtout ce qu'il NE porte pas.
37
+ *
38
+ * 🔴 Les trois façons de ne pas présenter de jeton ne se valent pas, et les
39
+ * confondre a rendu inatteignable la tolérance anonyme d'une porte protégée :
40
+ * un client dont la variable d'environnement n'est pas substituée envoie
41
+ * `Authorization: Bearer ` — un en-tête PRÉSENT qui n'affirme rien. Traité
42
+ * comme malformé, il recevait `400` là où le même client, muet, recevait les
43
+ * outils publics : la porte punissait plus sévèrement celui qui n'a rien à dire
44
+ * que celui qui se tait. Distinguer coûte un champ ; ne pas distinguer coûte la
45
+ * capacité entière.
46
+ */
47
+ export type BearerHeader =
48
+ /** Aucun en-tête, ou vide : le client n'a rien affirmé. */
49
+ {
50
+ kind: "absent";
51
+ }
52
+ /** Schéma `Bearer` reconnu, mais aucun jeton derrière — rien affirmé non plus. */
53
+ | {
54
+ kind: "empty";
55
+ }
56
+ /** Un autre schéma, ou `Bearer` collé à sa valeur : le client s'y prend mal. */
57
+ | {
58
+ kind: "other";
59
+ }
60
+ /** Un jeton est présenté — reste à le juger. */
61
+ | {
62
+ kind: "token";
63
+ token: string;
64
+ };
65
+ /**
66
+ * Lit un en-tête `Authorization` et dit ce qu'il porte.
67
+ *
68
+ * @param header - la valeur brute de l'en-tête (absente, d'un autre schéma, ou
69
+ * vide — aucun de ces cas ne lève).
70
+ * @returns le verdict de lecture ; jamais une exception.
71
+ */
72
+ export declare function readBearerHeader(header: unknown): BearerHeader;
73
+ /**
74
+ * Rend le jeton porté par un en-tête `Authorization`, ou `null`.
75
+ *
76
+ * Projection de {@link readBearerHeader} pour les appelants que la NUANCE ne
77
+ * regarde pas — un authentificateur qui cherche un porteur et passe la main s'il
78
+ * n'y en a pas. Une porte qui doit RÉPONDRE (401 ? 400 ? anonyme ?) lit le
79
+ * verdict complet : sans lui, elle ne peut pas distinguer « rien présenté » de
80
+ * « mal présenté », et elle tranche donc toujours du mauvais côté pour l'un des
81
+ * deux.
82
+ *
83
+ * @param header - la valeur brute de l'en-tête (peut être absente ou d'un autre
84
+ * schéma — les deux rendent `null`, jamais une exception).
85
+ * @returns le jeton débarrassé de ses espaces de tête et de queue, ou `null` si
86
+ * l'en-tête n'est pas un `Bearer` valide ou ne porte aucun jeton.
87
+ */
88
+ export declare function bearerToken(header: unknown): string | null;
@@ -0,0 +1,115 @@
1
+ /**
2
+ * Le mode MOTEUR quand rien ne le dit — source UNIQUE.
3
+ *
4
+ * Cette règle était écrite à CINQ endroits (`Kernel.environment`, le dernier
5
+ * terme de `Kernel.resolveRuntimeEnv`, `CliDefaultOptions.environment`,
6
+ * `Cli.environment`, et le `??` du constructeur de `Cli`). Cinq copies d'une
7
+ * même décision divergent en silence, et elles avaient déjà divergé : le kernel
8
+ * se déclarait en `production` pendant que la cascade `.env` ne chargeait NI
9
+ * `.env.production` NI `.env.development`, l'application tournant donc dans un
10
+ * mode dont elle n'avait pas la configuration.
11
+ *
12
+ * Module sans aucune dépendance, à côté de `loadEnv` : il est importé par le
13
+ * cœur (`Kernel`), par la couche CLI (`Cli`) et par le lanceur (`bin/nodefony`),
14
+ * qui n'ont pas le droit de se connaître entre eux.
15
+ *
16
+ * @module
17
+ */
18
+ import type { EnvironmentType } from "../types/globals.js";
19
+ /**
20
+ * Mode retenu lorsque ni l'environnement ni la commande n'en désignent un.
21
+ *
22
+ * 🔴 **`development`, et c'est un choix de SÛRETÉ.** Le raisonnement, parce
23
+ * qu'il se reprendra le jour où quelqu'un voudra l'inverser :
24
+ *
25
+ * Ce défaut ne s'applique QUE si `NODE_ENV` est absent ET que la commande
26
+ * n'exprime aucune intention. Or aucun serveur ne démarre dans cet état : les
27
+ * trois lanceurs posent leur mode eux-mêmes (`ProdCommand`, `DevCommand`,
28
+ * `ClusterCommand`), et il n'existe pas d'autre façon d'en lancer un. Le défaut
29
+ * ne gouverne donc que les commandes UTILITAIRES — `inspect`, `check`, `env`,
30
+ * `security:*` — tapées, dans leur écrasante majorité, sur un poste de
31
+ * développement. Le défaut doit protéger le cas où l'information manque, et
32
+ * l'information manque là.
33
+ *
34
+ * ⚠️ **Ce n'est pas le « 12-factor » qui le justifie** : sa section Config
35
+ * déconseille au contraire les *environment groups* comme `NODE_ENV`, et rien
36
+ * n'oblige un orchestrateur à le poser. Ce qui garantit le mode en production
37
+ * ici est FACTUEL, pas doctrinal — l'image générée pose
38
+ * `ENV NODE_ENV=production`, et les lanceurs déclarent leur intention. Ce qui
39
+ * relève vraiment du 12-factor est la PRÉCÉDENCE : l'ambiant l'emporte sur
40
+ * l'intention de la commande.
41
+ *
42
+ * Risque résiduel, nommé plutôt que masqué : une commande utilitaire lancée sur
43
+ * un déploiement de production SANS `NODE_ENV` et HORS image officielle partira
44
+ * en `development`. Le symétrique — le poste de développement traité comme la
45
+ * production — est ce qui a réellement cassé trois fois : un jeton émis contre
46
+ * la mauvaise configuration, une inspection montrant les modules de production
47
+ * sur une machine de développement, et un contrôle de banc comparant deux
48
+ * applications distinctes. Aucun n'a levé la moindre erreur.
49
+ */
50
+ export declare const DEFAULT_ENGINE_ENVIRONMENT: EnvironmentType;
51
+ /**
52
+ * Le défaut à retenir SELON que `NODE_ENV` a été posé ou non.
53
+ *
54
+ * 🔴 **Poser `NODE_ENV` est un ACTE DE DÉPLOIEMENT ; ne rien poser est l'état
55
+ * d'un poste de développement.** C'est toute la distinction, et l'ignorer a
56
+ * failli coûter cher : une première version de cette règle rendait
57
+ * `development` dès que `NODE_ENV` ne désignait aucun mode moteur — donc pour
58
+ * `staging`, `canary`, `prod-eu`, `test`. Un déploiement de pré-production
59
+ * aurait chargé les modules `policy:"dev"` (console d'administration, outillage
60
+ * de développement) et détaillé ses traces. La suite de tests l'a arrêté.
61
+ *
62
+ * Les valeurs non-moteur ne sont donc PAS traitées comme une absence : elles
63
+ * nomment un déploiement, et un déploiement tourne comme la production. Seule
64
+ * l'absence TOTALE de la variable désigne un poste de développement.
65
+ *
66
+ * Une chaîne vide compte comme POSÉE — on ne peut pas distinguer « vidée par
67
+ * erreur » de « vidée exprès », et le choix conservateur ne coûte qu'une
68
+ * commande utilitaire, là où l'inverse expose une console d'administration.
69
+ *
70
+ * @param nodeEnv - `process.env.NODE_ENV` tel quel, `undefined` s'il est absent.
71
+ * @returns le mode à retenir quand rien d'autre ne le désigne.
72
+ */
73
+ export declare function defaultEngineEnvironment(nodeEnv: string | undefined): EnvironmentType;
74
+ /**
75
+ * Le mode qu'une ligne de commande EXPRIME — détecté avant tout kernel.
76
+ *
77
+ * Pourquoi en amont : commander ne parse la sous-commande qu'au démarrage du
78
+ * kernel, si bien que `this.environment` reste indéfini pendant les premières
79
+ * lignes du boot. Plusieurs branches en dépendent, et elles ratent sans cette
80
+ * pré-détection. Une commande non reconnue rend `undefined`, et le défaut
81
+ * reprend la main.
82
+ *
83
+ * 🔴 **Seuls les mots de COMMANDE sont examinés — ceux qui précèdent la première
84
+ * option.** La version précédente balayait l'argv ENTIER : n'importe quel mot,
85
+ * où qu'il soit, décidait du mode. `nodefony doctor --env production` faisait
86
+ * ainsi basculer tout le processus en production — il chargeait `.env.production`
87
+ * et les modules de production pour répondre à une question sur le poste, et le
88
+ * catalogue de l'application, refusant de se construire, retombait en silence
89
+ * sur une version périmée. Un argument de valeur n'est pas une intention.
90
+ *
91
+ * Vit ici plutôt que dans le binaire : ce module est la source unique de « quel
92
+ * mode », il est importable, et une règle qu'on ne peut pas importer est une
93
+ * règle qu'on ne peut pas éprouver.
94
+ *
95
+ * @param argv - les arguments APRÈS le binaire (`process.argv.slice(2)`).
96
+ * @returns le mode exprimé par la commande, ou `undefined` si elle n'en exprime aucun.
97
+ */
98
+ export declare function detectEnvironmentFromArgv(argv: string[]): EnvironmentType | undefined;
99
+ /**
100
+ * Le mode MOTEUR que désigne une étiquette d'environnement — le « collapse ».
101
+ *
102
+ * 🔴 Tout ce qui n'est pas `dev`/`development` tourne comme la PRODUCTION :
103
+ * `staging`, `canary`, `prod-eu` nomment un déploiement, et un déploiement est
104
+ * optimisé, gated et tracé comme la production.
105
+ *
106
+ * Écrite ici, et nulle part ailleurs : cette règle décide à la fois de ce que
107
+ * le Kernel FAIT au démarrage et de ce que `doctor --env` PRÉDIT. Deux copies
108
+ * qui divergent feraient annoncer un déploiement que l'application ne produit
109
+ * pas — le pire défaut possible pour un outil dont c'est tout le propos.
110
+ *
111
+ * @param raw - l'étiquette telle qu'elle est posée (`NODE_ENV`, `--env`, …).
112
+ * @returns `"development"` ou `"production"` — jamais les formes courtes
113
+ * `dev`/`prod`, que ce collapse a justement pour rôle de résoudre.
114
+ */
115
+ export declare function engineModeOf(raw: string | undefined): "development" | "production";