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,86 @@
1
+ /**
2
+ * Options de {@link loadEnv} — les deux axes d'environnement Nodefony (12-factor).
3
+ */
4
+ export interface ILoadEnvOptions {
5
+ /**
6
+ * Mode RUNTIME (`"development"` | `"production"`) = NODE_ENV. Sélectionne
7
+ * `.env.<runtimeEnv>` (+ `.env.<runtimeEnv>.local`). Omis → ces niveaux sont sautés.
8
+ */
9
+ runtimeEnv?: string;
10
+ /**
11
+ * Environnement de DÉPLOIEMENT (string libre : `staging` / `canary` / `prod-eu`…) =
12
+ * APP_ENV / NF_ENV. Sélectionne `.env.<appEnv>` (+ `.env.<appEnv>.local`),
13
+ * PLUS prioritaire que le mode runtime (plus spécifique). Omis ou égal à
14
+ * `runtimeEnv` → ces niveaux sont sautés (pas de doublon).
15
+ */
16
+ appEnv?: string;
17
+ /** Racine du projet où chercher les fichiers (défaut `process.cwd()`). */
18
+ cwd?: string;
19
+ }
20
+ /**
21
+ * Charge les fichiers `.env` du projet dans `process.env`, en cascade et SANS
22
+ * jamais écraser une variable déjà présente.
23
+ *
24
+ * **Convention B (Vite / Next.js)** — règle : les fichiers `*.local` (gitignorés,
25
+ * secrets/machine) priment TOUJOURS sur les committés ; à rang égal, le plus
26
+ * spécifique gagne. Nodefony ajoute un 2ᵉ axe : `appEnv` (déploiement) est plus
27
+ * spécifique que `runtimeEnv` (mode). Précédence, du PLUS fort au PLUS faible :
28
+ *
29
+ * ```
30
+ * process.env ← shell / orchestrateur k8s (gagne TOUJOURS)
31
+ * > .env.<appEnv>.local ┐ gitignorés (*.local) ┐ si appEnv défini
32
+ * > .env.<runtimeEnv>.local │ │ & ≠ runtimeEnv
33
+ * > .env.local ┘ │
34
+ * > .env.<appEnv> ┐ committés (non-secrets) ┘
35
+ * > .env.<runtimeEnv> │
36
+ * > .env ┘ défauts communs (le + faible)
37
+ * ```
38
+ *
39
+ * Mécanique : on lit du **plus** prioritaire au **moins** prioritaire et on
40
+ * n'assigne QUE les clés encore absentes de `process.env`. Une variable déjà
41
+ * posée — shell, orchestrateur, ou fichier plus prioritaire déjà traité — n'est
42
+ * jamais réécrite → la précédence ci-dessus en découle naturellement.
43
+ *
44
+ * Parse natif `node:util.parseEnv` (Node ≥ 21) → **zéro dépendance**. Un fichier
45
+ * absent ou illisible est ignoré silencieusement (tout `.env` est optionnel).
46
+ *
47
+ * Appelé une seule fois au démarrage du bin CLI, **AVANT `new CliKernel()`** : les
48
+ * configs de modules lisent `process.env` au boot (ex. `REDIS_*` dans
49
+ * `defineRedisConfig`), l'env doit donc être peuplé en amont.
50
+ *
51
+ * @param opts - {@link ILoadEnvOptions} (runtimeEnv / appEnv / cwd).
52
+ * @returns le nombre de variables effectivement injectées (diagnostic / tests).
53
+ */
54
+ /**
55
+ * Les fichiers de la cascade, du PLUS prioritaire au MOINS prioritaire.
56
+ *
57
+ * Extrait de {@link loadEnv} pour être la source UNIQUE de cet ordre : la
58
+ * commande `nodefony env` l'affiche, et un ordre affiché qui différerait de
59
+ * l'ordre appliqué serait pire que pas d'affichage du tout — c'est exactement ce
60
+ * qu'un utilisateur croirait sur parole en cherchant pourquoi sa variable est
61
+ * ignorée.
62
+ *
63
+ * @param opts - `runtimeEnv` (mode) et `appEnv` (déploiement).
64
+ * @returns les noms de fichiers, ordonnés ; ne dit pas lesquels existent.
65
+ */
66
+ export declare function envFileOrder(opts?: Pick<ILoadEnvOptions, "runtimeEnv" | "appEnv">): string[];
67
+ /**
68
+ * L'environnement EFFECTIF d'un projet, sans toucher à `process.env`.
69
+ *
70
+ * Même cascade et même précédence que {@link loadEnv} — dont c'est désormais le
71
+ * moteur —, mais rendue plutôt qu'injectée. Elle sert à tout ce qui doit LIRE
72
+ * l'environnement d'une application sans être cette application : un diagnostic
73
+ * lancé depuis un poste voit ainsi ce que l'app verra, alors que `process.env`
74
+ * nu ne montre que ce que le terminal a posé.
75
+ *
76
+ * 🔴 C'est exactement le trou que `doctor` portait : le dialecte du connecteur
77
+ * était déduit de `process.env` seul, donc une application dont l'URL vit dans
78
+ * `.env.local` — le chemin que le gabarit PRESCRIT — voyait chacune de ses
79
+ * entités accusée d'être écrite pour le mauvais moteur.
80
+ *
81
+ * @param base - l'environnement de départ, qui GAGNE sur les fichiers.
82
+ * @param opts - la cascade à lire (racine, mode runtime, environnement de déploiement).
83
+ * @returns un objet neuf ; ni `base` ni `process.env` ne sont modifiés.
84
+ */
85
+ export declare function resolveEnvCascade(base: Record<string, string | undefined>, opts?: ILoadEnvOptions): Record<string, string | undefined>;
86
+ export declare function loadEnv(opts?: ILoadEnvOptions): number;
@@ -0,0 +1,104 @@
1
+ /**
2
+ * Valeur d'un compteur tel qu'il traverse HTTP : un nombre, ou `null` quand le
3
+ * backend branché ne sait pas répondre.
4
+ *
5
+ * `null` n'est pas `0`, et c'est tout l'intérêt de ce type. Un store en curseur
6
+ * (Redis `SCAN`) refuse le comptage exact — il coûterait un parcours complet du
7
+ * keyspace — et le dit en rendant `-1` ({@link UNKNOWN_COUNT}). Sans un canal
8
+ * distinct pour l'inconnu, cette réponse arriverait au navigateur sous la forme
9
+ * d'un zéro, et une console d'administration afficherait « 0 session » là où il
10
+ * y en a des milliers.
11
+ */
12
+ export type FacetCount = number | null;
13
+ /**
14
+ * Ce qu'un store rend quand il ne PEUT pas compter — convention de tous les
15
+ * backends du dépôt (`countSessions`, `countTokens`, `countEndpoints`).
16
+ *
17
+ * Une valeur sentinelle plutôt qu'une exception : ne pas savoir compter est un
18
+ * état nominal d'un backend en curseur, pas une panne.
19
+ */
20
+ export declare const UNKNOWN_COUNT = -1;
21
+ /**
22
+ * Les compteurs rendus, une clé par facette déclarée.
23
+ *
24
+ * Le type dérive de la déclaration : ajouter une facette à la constante ajoute
25
+ * sa clé ici, et le consommateur qui l'oublie ne compile plus.
26
+ */
27
+ export type FacetCounts<S> = {
28
+ [K in keyof S]: FacetCount;
29
+ };
30
+ /**
31
+ * Compte plusieurs **facettes** d'une même collection en un seul geste.
32
+ *
33
+ * Une facette est une question fermée posée à la collection entière — « combien
34
+ * de sessions authentifiées ? », « combien de clés révoquées ? ». C'est ce que
35
+ * les cartes en tête d'un écran d'administration prétendent afficher, et ce
36
+ * qu'elles calculaient jusqu'ici **sur la page chargée** : avec une fenêtre de
37
+ * 25 lignes, une carte annonçant « 3 comptes actifs » décrit trois lignes
38
+ * visibles, pas l'annuaire. Un nombre présenté sans qualificatif est lu comme un
39
+ * total ; le corriger d'une mention en petits caractères ne le rend pas vrai.
40
+ *
41
+ * L'algorithme vit ici en **un seul exemplaire** ; ce qui varie d'une ressource
42
+ * à l'autre est la **donnée** — la table des facettes — qui se déclare à côté du
43
+ * contrat de la ressource, jamais sous forme de fonction.
44
+ *
45
+ * Aucune facette n'est dérivée d'une autre (`inactive = total - active`) : deux
46
+ * facettes peuvent se recouvrir (un compte peut être à la fois désactivé et
47
+ * verrouillé), et une soustraction rendrait alors un nombre que rien ne compte.
48
+ * Chaque facette est une question posée telle quelle au store.
49
+ *
50
+ * @param facets - nom public → filtre à appliquer. Un filtre vide compte tout.
51
+ * @param count - le compteur du store, appelé une fois par facette. Il rend
52
+ * {@link UNKNOWN_COUNT} lorsqu'il ne sait pas compter.
53
+ * @returns un compteur par facette, `null` là où le store a répondu « inconnu ».
54
+ *
55
+ * @remarks **Cold path d'administration.** Les facettes partent en parallèle
56
+ * (une requête `COUNT` chacune) : c'est acceptable pour quatre questions
57
+ * posées à l'ouverture d'un écran, et ce ne serait pas acceptable dans un
58
+ * chemin de requête. Ne pas rejouer ces comptages à chaque tour de page — ils
59
+ * ne dépendent ni de `limit`, ni de `offset`, ni de l'ordre.
60
+ *
61
+ * @example
62
+ * ```ts
63
+ * const SESSION_FACETS = {
64
+ * total: {},
65
+ * authenticated: { authenticated: true },
66
+ * anonymous: { authenticated: false },
67
+ * } as const satisfies IFacetSpec<ISessionListQuery>;
68
+ *
69
+ * const counts = await countFacets(SESSION_FACETS, (q) => storage.countSessions(q));
70
+ * // → { total: 1204, authenticated: 87, anonymous: 1117 } (Redis : que des null)
71
+ * ```
72
+ */
73
+ export declare function countFacets<S extends Readonly<Record<string, object>>>(facets: S, count: (query: S[keyof S]) => number | Promise<number>): Promise<FacetCounts<S>>;
74
+ /**
75
+ * Les champs qu'une table de facettes **décompose** — donc ceux qu'un client ne
76
+ * peut pas filtrer sur l'endpoint qui les rend.
77
+ *
78
+ * Poser `?status=active` sur un endpoint dont les facettes sont justement les
79
+ * états produirait une réponse qui se contredit : le total suivrait le filtre,
80
+ * et chaque facette l'écraserait par le sien (« 5 clés au total, dont 538
81
+ * révoquées »). Ce n'est pas un cas tordu, c'est le cas NOMINAL — un client
82
+ * envoie naturellement le même query string à la liste et aux compteurs.
83
+ *
84
+ * Sert donc de garde : la spec de filtre d'un endpoint de statistiques ne doit
85
+ * contenir aucune de ces clés, ce qu'un test vérifie par ressource.
86
+ *
87
+ * @param facets - la table déclarée.
88
+ * @returns les noms de champs apparaissant dans au moins une facette, triés.
89
+ */
90
+ export declare function facetDimensions(facets: Readonly<Record<string, object>>): string[];
91
+ /**
92
+ * Déclaration des facettes d'une ressource : nom public → filtre de sa requête
93
+ * de liste.
94
+ *
95
+ * Le paramètre `Q` est le contrat de liste de la ressource
96
+ * (`ISessionListQuery`, `ITokenListQuery`…), ce qui interdit à la compilation
97
+ * de déclarer une facette sur un champ que le store ne sait pas filtrer. C'est
98
+ * la garde qui empêche de réintroduire le compteur approximatif : une facette
99
+ * qui n'est pas exprimable comme un filtre du contrat n'est pas une facette —
100
+ * elle exige soit d'étendre le contrat, soit une capacité déclarée à part
101
+ * (le cas d'un décompte de valeurs distinctes, qu'un `COUNT` filtré ne rend
102
+ * pas).
103
+ */
104
+ export type IFacetSpec<Q> = Readonly<Record<string, Partial<Q>>>;
@@ -0,0 +1,139 @@
1
+ import type { PageQuerySource } from "./pageQuery.js";
2
+ /**
3
+ * Nature d'un filtre — ce qui suffit à le lire depuis une source clé→valeur.
4
+ *
5
+ * Volontairement CLOS et minuscule : ces trois natures couvrent la totalité des
6
+ * filtres exposés par les data planes du dépôt (`revoked`, `enabled`, `role`,
7
+ * `actor`, `since`…). Une grammaire d'opérateurs (`contains`, `in`,
8
+ * `startsWith`) serait un langage de requête, pas un filtre : elle appartient au
9
+ * store, qui seul sait ce qu'il peut indexer.
10
+ */
11
+ export type FilterKind = "string" | "boolean" | "int";
12
+ /**
13
+ * Un filtre à valeurs **multiples** : la clé peut être répétée dans l'URL
14
+ * (`?severity=ERROR&severity=CRITIC`), chaque occurrence étant validée par
15
+ * `each`.
16
+ *
17
+ * C'est une AUTORISATION explicite, jamais un hasard de query string : hors
18
+ * `{ each }`, un paramètre répété est refusé en `400` (`singleValue`). Le sens
19
+ * du OU entre les valeurs appartient au store, pas au lecteur.
20
+ *
21
+ * @remarks Une valeur invalide fait échouer la LISTE ENTIÈRE. Le réflexe
22
+ * inverse — garder les valeurs valides et jeter les autres — est celui que
23
+ * les data planes appliquaient à la main, et il ment : `?flow=nimporte`
24
+ * laissait le critère vide, donc rendait le journal ENTIER sous un `200`.
25
+ */
26
+ export interface FilterEach {
27
+ /** La nature de CHAQUE valeur : une liste fermée, ou un type scalaire. */
28
+ readonly each: FilterKind | readonly string[];
29
+ }
30
+ /**
31
+ * Définition d'UN filtre : sa nature, la **liste fermée** de ses valeurs, ou
32
+ * l'une des deux répétée ({@link FilterEach}).
33
+ *
34
+ * Une liste vaut énumération — `["auth", "authz", "token"]` — et devient
35
+ * l'allowlist qui la valide, exactement comme `sortable` pour le tri.
36
+ */
37
+ export type FilterDef = FilterKind | readonly string[] | FilterEach;
38
+ /**
39
+ * Ce qu'un point d'entrée sait filtrer : nom public → définition.
40
+ *
41
+ * C'est une **donnée**, pas un comportement — une constante par ressource, à
42
+ * côté de son contrat. Elle ne vit pas sur le store : contrairement au tri (que
43
+ * Redis ne sait pas faire, d'où `sortableFields` par backend), un filtre déclaré
44
+ * dans un `IXListQuery` est une **obligation** de tous les backends de cette
45
+ * ressource. Le déclarer par store laisserait croire le contraire.
46
+ *
47
+ * Étant une donnée sérialisable, elle est **publiable** : un endpoint de
48
+ * capacités peut la rendre telle quelle, et le front cesse de coder les filtres
49
+ * en dur.
50
+ */
51
+ export type IFilterSpec = Readonly<Record<string, FilterDef>>;
52
+ /** Réglages de lecture d'un point d'entrée qui porte plus que des filtres. */
53
+ export interface IParseFiltersOptions {
54
+ /**
55
+ * Paramètres que ce point d'entrée lit **lui-même**, hors filtres — une
56
+ * projection (`?include=author`), un format de sortie, une clé propre au
57
+ * transport.
58
+ *
59
+ * Ils sont laissés passer sans être validés ni rendus : c'est l'appelant qui
60
+ * s'en occupe. Les déclarer ici est le seul moyen de garder le refus de
61
+ * l'inconnu — sans cette liste, `?include=author` deviendrait un `400` sur un
62
+ * paramètre parfaitement légitime, et la seule échappatoire serait de ne plus
63
+ * refuser du tout.
64
+ *
65
+ * @remarks Une clé énoncée ici est un **engagement de l'appelant** à la
66
+ * traiter. L'y mettre pour faire taire un refus, sans la lire ensuite,
67
+ * recrée exactement le paramètre accepté puis jeté que ce contrat bannit.
68
+ */
69
+ accepts?: readonly string[];
70
+ }
71
+ /** Le type d'UNE valeur, sans la répétition — brique de {@link FilterValue}. */
72
+ type ScalarFilterValue<D> = D extends "string" ? string : D extends "boolean" ? boolean : D extends "int" ? number : D extends readonly (infer V)[] ? V : never;
73
+ /**
74
+ * Le type JavaScript qu'une définition de filtre produit une fois lue — un
75
+ * **tableau** pour un filtre `{ each }`, la valeur seule sinon.
76
+ */
77
+ export type FilterValue<D extends FilterDef> = D extends {
78
+ each: infer E;
79
+ } ? ScalarFilterValue<E>[] : ScalarFilterValue<D>;
80
+ /**
81
+ * Les filtres lus, **typés depuis la spec** : une énumération rend son union de
82
+ * littéraux, `boolean` rend un booléen, `int` un nombre.
83
+ *
84
+ * C'est ce qui permet de composer directement avec un `IXListQuery` — sans cast,
85
+ * sans `as AuditCategory`. Une spec déclarée `as const satisfies IFilterSpec`
86
+ * porte donc à la fois la validation à l'exécution et le type à la compilation :
87
+ * ajouter une valeur à une énumération met les deux à jour d'un seul geste.
88
+ */
89
+ export type FilterValues<S extends IFilterSpec> = {
90
+ -readonly [K in keyof S]?: FilterValue<S[K]>;
91
+ };
92
+ /**
93
+ * **Le** lecteur de filtres : transforme une source clé→valeur en filtres
94
+ * validés, selon la spec déclarée par la ressource. Fonction **pure**.
95
+ *
96
+ * Il remplace les lectures `one(query, "x")` que chaque data plane recopiait —
97
+ * une vingtaine dans le dépôt, avec autant de coercitions maison. Ce n'est pas
98
+ * la répétition qui coûtait, c'est ce qu'elles faisaient toutes : **accepter
99
+ * puis jeter**. `?revoked=oui` posait le filtre à `undefined`, `?category=zzz`
100
+ * tombait hors de l'énumération, `?enbaled=true` n'existait pour personne — et
101
+ * dans les trois cas la réponse était une page NON filtrée, que le client lit
102
+ * comme le résultat de son filtre. Le tri a cessé de faire ça ; les filtres le
103
+ * faisaient encore.
104
+ *
105
+ * Trois refus, tous en `400` :
106
+ *
107
+ * | Cas | Exemple |
108
+ * | ---------------------------------- | -------------------------- |
109
+ * | valeur mal formée | `?revoked=oui` |
110
+ * | valeur hors énumération | `?category=zzz` |
111
+ * | paramètre reconnu par personne | `?enbaled=true` |
112
+ *
113
+ * Le troisième est le plus important et le moins évident : sans lui, une faute
114
+ * de frappe dans une URL d'administration rend silencieusement la collection
115
+ * ENTIÈRE. Les clés du contrat de page ({@link PAGE_QUERY_KEYS}) sont bien sûr
116
+ * admises — c'est le même URL qui porte les deux.
117
+ *
118
+ * @param source - la query string parsée, ou le corps d'une requête `QUERY`.
119
+ * @param spec - ce que ce point d'entrée sait filtrer.
120
+ * @param options - paramètres que l'appelant lit lui-même (voir
121
+ * {@link IParseFiltersOptions.accepts}).
122
+ * @returns les filtres présents et valides (les absents ne sont pas posés).
123
+ * @throws {@link PageQueryError} (`code` 400) sur l'un des trois cas ci-dessus.
124
+ *
125
+ * @example
126
+ * ```ts
127
+ * const TOKEN_FILTERS = {
128
+ * subjectId: "string",
129
+ * revoked: "boolean",
130
+ * kind: ["pat", "refresh"],
131
+ * } as const satisfies IFilterSpec;
132
+ *
133
+ * const page = parsePageQuery(request.query, { sortable });
134
+ * const filters = parseFilters(request.query, TOKEN_FILTERS);
135
+ * return store.listPage({ ...page, ...filters });
136
+ * ```
137
+ */
138
+ export declare function parseFilters<const S extends IFilterSpec>(source: PageQuerySource, spec: S, options?: IParseFiltersOptions): FilterValues<S>;
139
+ export {};
@@ -0,0 +1,78 @@
1
+ import nodefonyError from "../Error.js";
2
+ import type { IPageQuery } from "../types/IPage.js";
3
+ /**
4
+ * Les deux modes de pagination du contrat {@link IPageQuery}, **mutuellement
5
+ * exclusifs** : un backend n'expose que l'un ({@link IPageQuery.offset} navigation
6
+ * directe, ou {@link IPageQuery.cursor} navigation « après ce jeton »). Cf le TSDoc
7
+ * d'`IPageQuery` : « un backend n'expose qu'un mode ; le store le déclare ».
8
+ */
9
+ export type PaginationMode = "offset" | "cursor";
10
+ /**
11
+ * Erreur levée quand un `listPage` reçoit le champ de pagination du mode que son
12
+ * store **ne sait pas honorer** — un `cursor` pour un store offset, ou un `offset`
13
+ * de navigation pour un store curseur.
14
+ *
15
+ * `code = 400` : c'est une erreur du **client** (mauvais paramètre), jamais une
16
+ * panne serveur. Avant ce garde-fou, le champ hors-mode était **avalé en silence**
17
+ * (un client curseur bouclait indéfiniment sur la page 1 d'un store offset, cf
18
+ * l'écart F27/F51 du registre doc↔code). Le data plane admin (`AdminApiController`)
19
+ * traduit ce `code` en statut HTTP 400 au lieu du 500 générique.
20
+ */
21
+ export declare class PaginationModeError extends nodefonyError {
22
+ /**
23
+ * @param received - le mode dont un champ a été fourni (celui de trop).
24
+ * @param supported - le mode réellement supporté par le store.
25
+ */
26
+ constructor(received: PaginationMode, supported: PaginationMode);
27
+ }
28
+ /**
29
+ * Erreur levée quand un store paginant par **curseur** reçoit un
30
+ * {@link IPageQuery.order} : il ne peut pas l'honorer, et l'avaler mentirait.
31
+ *
32
+ * Ce n'est pas une limite d'implémentation, c'est la nature du curseur : le
33
+ * jeton encode une **position dans un ordre total**, celui-là même que le store
34
+ * applique. Le rendre paramétrable rendrait tout jeton déjà émis ininterprétable
35
+ * — la page suivante sauterait ou répéterait des lignes, silencieusement, ce qui
36
+ * est le pire défaut possible sur un journal d'audit.
37
+ *
38
+ * `code = 400` : c'est le client qui demande une capacité que ce point d'entrée
39
+ * n'a pas. Un backend curseur qui saurait trier devrait d'abord embarquer
40
+ * l'ordre DANS son curseur ; il déclarerait alors `sortableFields` et cette
41
+ * garde serait à revoir avec lui — pas avant.
42
+ */
43
+ export declare class CursorOrderError extends nodefonyError {
44
+ /** @param fields - les champs de tri demandés, dans l'ordre reçu. */
45
+ constructor(fields: readonly string[]);
46
+ }
47
+ /**
48
+ * Fait respecter le contrat « un store expose UN seul mode » au point d'entrée
49
+ * d'un `listPage`, sur la requête **brute** reçue de l'appelant (avant qu'elle ne
50
+ * soit normalisée) : rejette explicitement le champ du mode non supporté plutôt
51
+ * que de l'ignorer sans un mot.
52
+ *
53
+ * Chaque store connaît son mode **statiquement** (constante de l'implémentation) et
54
+ * appelle ce garde-fou en première ligne. À placer côté store — jamais dans un
55
+ * helper de pagination en aval (`paginate()`), qui reçoit une requête déjà
56
+ * reconstruite d'où le champ hors-mode a pu disparaître, laissant la violation
57
+ * passer inaperçue.
58
+ *
59
+ * **Valeurs neutres tolérées** (pas une navigation) : un `cursor` **vide** côté
60
+ * offset et un `offset` **0** côté curseur désignent tous deux « le début » — ils
61
+ * ne trahissent aucune intention du mauvais mode et ne sont donc pas rejetés. Seule
62
+ * une vraie navigation du mode adverse (`cursor` non vide, `offset > 0`) lève.
63
+ *
64
+ * **Le mode curseur refuse aussi le TRI** ({@link CursorOrderError}) : son ordre
65
+ * est imposé par le jeton, pas choisi par l'appelant. Le data plane le refuse
66
+ * déjà en amont (aucun endpoint curseur ne déclare `sortable`), mais un appelant
67
+ * interne — un autre service, un test, un futur endpoint — fabrique son
68
+ * `IPageQuery` à la main ; sans cette ligne, son `order` était ignoré sans un
69
+ * mot par les six stores curseur du dépôt.
70
+ *
71
+ * @param query - la requête de page brute reçue par le store.
72
+ * @param mode - le mode que le store sait honorer.
73
+ * @throws {@link PaginationModeError} (`code` 400) si le champ du mode adverse est
74
+ * présent avec une valeur de navigation.
75
+ * @throws {@link CursorOrderError} (`code` 400) si un `order` non vide est fourni
76
+ * à un store curseur.
77
+ */
78
+ export declare function assertPageQuery(query: IPageQuery, mode: PaginationMode): void;
@@ -0,0 +1,138 @@
1
+ import nodefonyError from "../Error.js";
2
+ import type { IPageQuery } from "../types/IPage.js";
3
+ /**
4
+ * Source d'où extraire une requête de page, **agnostique de sa provenance** :
5
+ * une query string déjà parsée (`?limit=20&offset=40`), le corps JSON d'une
6
+ * requête `QUERY` (RFC 10008), ou tout autre porteur clé→valeur.
7
+ *
8
+ * C'est le point de toute la conception : {@link parsePageQuery} ne connaît pas
9
+ * HTTP. Le jour où le transport change, seul l'appelant change — pas le contrat,
10
+ * pas les stores.
11
+ */
12
+ export type PageQuerySource = Readonly<Record<string, string | string[] | undefined>>;
13
+ /**
14
+ * Réglages d'un point d'entrée paginé : ses bornes et ce qu'il accepte de trier.
15
+ *
16
+ * Les défauts (`50` / `200`) sont ceux que tous les data planes admin du dépôt
17
+ * appliquaient déjà chacun de leur côté — ils deviennent ici la valeur unique.
18
+ */
19
+ export interface IParsePageQueryOptions {
20
+ /** Taille de page quand le client n'en demande pas. Défaut `50`. */
21
+ defaultLimit?: number;
22
+ /**
23
+ * Cap dur : une demande supérieure est **ramenée** à ce plafond (jamais
24
+ * refusée — un client qui demande trop ne mérite pas une erreur, il mérite
25
+ * une page). Défaut `200`.
26
+ */
27
+ maxLimit?: number;
28
+ /**
29
+ * Champs sur lesquels ce point d'entrée sait trier — l'**allowlist** qui rend
30
+ * `order` exploitable.
31
+ *
32
+ * @remarks Absente, tout `order` reçu est **refusé** (`400`) au lieu d'être
33
+ * ignoré : un tri accepté puis jeté fait croire au client que la page est
34
+ * triée alors qu'elle ne l'est pas. Elle borne aussi ce qui peut atteindre
35
+ * un store — un nom de champ arbitraire n'a rien à faire dans une requête.
36
+ */
37
+ sortable?: readonly string[];
38
+ /**
39
+ * Ce point d'entrée sait-il **chercher** (`?q=`) — c'est-à-dire relayer `q`
40
+ * jusqu'à un store qui l'honore. Défaut `false`.
41
+ *
42
+ * @remarks Défaut symétrique de {@link IParsePageQueryOptions.sortable} : non
43
+ * déclarée, la recherche est **refusée** (`400`) au lieu d'être ignorée. Le
44
+ * défaut inverse aurait été le péché habituel — deux data planes du dépôt
45
+ * acceptaient `?q=` sans jamais le transmettre à leur store, et rendaient
46
+ * donc la collection ENTIÈRE à qui croyait lire un résultat de recherche.
47
+ * Comme le tri, la recherche est une capacité du **backend branché** (un
48
+ * store en curseur ne balaie pas), donc elle se constate et se déclare —
49
+ * jamais elle ne se suppose.
50
+ */
51
+ searchable?: boolean;
52
+ }
53
+ /**
54
+ * Erreur d'une requête de page mal formée ou non honorable par le point
55
+ * d'entrée : `order` sur un endpoint qui ne trie pas, champ hors allowlist,
56
+ * sens de tri inconnu.
57
+ *
58
+ * `code = 400` : la faute est au client. Le data plane admin
59
+ * (`AdminApiController`) traduit ce `code` en statut HTTP, comme il le fait
60
+ * déjà pour {@link PaginationModeError}.
61
+ */
62
+ export declare class PageQueryError extends nodefonyError {
63
+ constructor(message: string);
64
+ }
65
+ /**
66
+ * Les clés que le contrat de page revendique sur le fil — **source unique**.
67
+ *
68
+ * Elle existe pour un consommateur : `parseFilters`, qui doit distinguer un
69
+ * paramètre de pagination d'un filtre inconnu, et refuse le second. Recopier
70
+ * cette liste là-bas aurait suffi à ce qu'un `?tenantId=` légitime devienne un
71
+ * `400` le jour où le contrat gagne une clé ici et pas là.
72
+ *
73
+ * `tenantId` y figure bien qu'il ne soit pas encore lu (réserve multi-tenant du
74
+ * contrat, `IPageQuery.tenantId`) : le front l'émet déjà sur les sessions.
75
+ */
76
+ export declare const PAGE_QUERY_KEYS: ReadonlySet<string>;
77
+ /**
78
+ * **La** lecture d'une valeur unique dans une source de page — partagée par
79
+ * {@link parsePageQuery} et `parseFilters`.
80
+ *
81
+ * Une {@link PageQuerySource} peut porter plusieurs valeurs par clé (query
82
+ * string répétée, tableau JSON d'un corps `QUERY`) : c'est le polymorphisme du
83
+ * transport. Aucun des deux lecteurs ne sait quoi faire d'une seconde valeur —
84
+ * ni le contrat de page, ni une spec de filtre n'expriment l'appartenance à un
85
+ * ensemble. Prendre la première et **jeter les autres en silence** rendait une
86
+ * page filtrée sur `a` à qui avait demandé `a` **et** `b`, sans rien dire : la
87
+ * faute exacte que ce contrat bannit partout ailleurs.
88
+ *
89
+ * D'où le refus. Le jour où un point d'entrée doit accepter plusieurs valeurs,
90
+ * ce sera une nature de filtre déclarée (`["in", …]`), pas une tolérance
91
+ * implicite du lecteur.
92
+ *
93
+ * @throws {@link PageQueryError} (`400`) si la clé porte plus d'une valeur.
94
+ */
95
+ export declare const singleValue: (source: PageQuerySource, key: string) => string | undefined;
96
+ /**
97
+ * **Le** traducteur d'une requête de page : transforme une source clé→valeur en
98
+ * {@link IPageQuery} borné et validé. Fonction **pure** — aucun accès au kernel,
99
+ * à l'ALS ni à la requête HTTP.
100
+ *
101
+ * Il remplace les parseurs `limit`/`offset` que chaque data plane réécrivait
102
+ * pour lui-même. Ces copies avaient déjà divergé (`Number.isNaN` d'un côté,
103
+ * `Number.isFinite` de l'autre : `?limit=abc` bornait à `50` ici et plantait à
104
+ * `NaN` là), et aucune ne validait le tri.
105
+ *
106
+ * Ce qui est lu, et rien d'autre — un paramètre inconnu est laissé à l'appelant,
107
+ * qui compose ses propres filtres par-dessus (`interface XQuery extends
108
+ * IPageQuery`) :
109
+ *
110
+ * | Paramètre | Forme sur le fil | Résultat |
111
+ * | ------------ | --------------------------- | ------------------------------------------- |
112
+ * | `limit` | `?limit=20` | borné à `[1, maxLimit]`, défaut `defaultLimit` |
113
+ * | `offset` | `?offset=40` | `≥ 0` (négatif ou invalide → absent) |
114
+ * | `cursor` | `?cursor=abc` | posé si non vide |
115
+ * | `order` | `?order=name:ASC,age:DESC` | validé contre `sortable` |
116
+ * | `withTotal` | `?withTotal=false` | posé **seulement** si `false` (défaut `true`) |
117
+ * | `q` | `?q=jean` | trimé, posé si non vide — **refusé** sans `searchable` |
118
+ *
119
+ * `offset` et `cursor` peuvent tous deux être présents ici : ce n'est pas à ce
120
+ * traducteur d'arbitrer, mais au store, qui seul connaît son mode — il l'énonce
121
+ * en appelant `assertPageQuery(query, mode)` en première ligne de son `listPage`.
122
+ *
123
+ * @param source - la query string parsée, ou le corps d'une requête `QUERY`.
124
+ * @param options - bornes et champs triables de ce point d'entrée.
125
+ * @returns une requête de page conforme au contrat, prête pour un store.
126
+ * @throws {@link PageQueryError} (`code` 400) si le tri demandé n'est pas
127
+ * honorable par ce point d'entrée.
128
+ *
129
+ * @example
130
+ * ```ts
131
+ * const query = parsePageQuery(request.query, {
132
+ * maxLimit: 200,
133
+ * sortable: ["username", "createdAt"],
134
+ * });
135
+ * return repository.listPage({ ...query, enabled: true });
136
+ * ```
137
+ */
138
+ export declare function parsePageQuery(source: PageQuerySource, options?: IParsePageQueryOptions): IPageQuery;
@@ -0,0 +1,86 @@
1
+ import type { IPageQuery } from "../types/IPage.js";
2
+ /**
3
+ * Lit la valeur d'un champ triable sur un élément. Chaque store fournit la
4
+ * sienne : le nom du champ est **public** (celui de l'URL), la façon de
5
+ * l'atteindre est interne.
6
+ *
7
+ * @typeParam T - type des éléments triés.
8
+ */
9
+ export type FieldReader<T> = (item: T, field: string) => unknown;
10
+ /**
11
+ * Réécrit les noms de champs d'un `order` selon une table d'alias — le pont
12
+ * entre le vocabulaire **public** (celui de l'URL) et le schéma d'un backend.
13
+ *
14
+ * Il existe parce que chaque store le refaisait : trois fonctions strictement
15
+ * identiques traduisaient `id` vers `_id` ou `session_id`, une par ressource.
16
+ * La règle (« réécrire les noms ») est la même partout ; seule la TABLE change,
17
+ * et c'est elle qui est une donnée du backend, pas du code.
18
+ *
19
+ * Un champ absent de la table passe inchangé — l'immense majorité des noms
20
+ * publics sont déjà ceux du schéma.
21
+ *
22
+ * @param order - l'ordre demandé, en vocabulaire public.
23
+ * @param aliases - `{ nomPublic: nomDansLeSchéma }`.
24
+ * @returns le même ordre, exprimé dans le schéma du backend.
25
+ *
26
+ * @example
27
+ * ```ts
28
+ * // Mongo stocke la clé primaire en `_id`, il n'existe aucun champ `id`.
29
+ * renameOrderFields(order, { id: "_id" });
30
+ * ```
31
+ */
32
+ export declare function renameOrderFields(order: NonNullable<IPageQuery["order"]>, aliases: Readonly<Record<string, string>>): NonNullable<IPageQuery["order"]>;
33
+ /**
34
+ * Retient d'un `order` demandé les seuls couples dont le champ est **déclaré
35
+ * triable**, et retombe sur l'ordre par défaut s'il n'en reste aucun.
36
+ *
37
+ * C'est le dernier étage d'une garde à deux niveaux, et il n'est pas redondant :
38
+ * le data plane refuse déjà en 400 un champ hors allowlist, mais tout appelant
39
+ * interne (un autre service, un test, un futur endpoint) peut fabriquer un
40
+ * `IPageQuery` à la main. Sans ce filtre, deux backends répondraient
41
+ * différemment à la même requête — celui qui lit l'objet en mémoire trierait sur
42
+ * un champ jamais annoncé, celui qui compose du SQL l'ignorerait — et le contrat
43
+ * partagé ne décrirait plus un comportement mais deux.
44
+ *
45
+ * 🔒 Côté SQL, ce filtre est une **garde d'injection** : un nom de colonne ne se
46
+ * lie pas en paramètre, il se concatène dans le `ORDER BY`.
47
+ *
48
+ * @param order - l'ordre demandé (peut être absent ou vide).
49
+ * @param allowed - les champs que le store déclare savoir trier.
50
+ * @param fallback - l'ordre contractuel appliqué à défaut.
51
+ * @returns un ordre non vide, garanti clos sur `allowed` ∪ `fallback`.
52
+ *
53
+ * @example
54
+ * ```ts
55
+ * const order = pickOrder(query.order, this.sortableFields, DEFAULT_ORDER);
56
+ * rows.sort(compareByOrder(order, (r, f) => r[f as keyof Row]));
57
+ * ```
58
+ */
59
+ export declare function pickOrder(order: IPageQuery["order"], allowed: readonly string[], fallback: NonNullable<IPageQuery["order"]>): NonNullable<IPageQuery["order"]>;
60
+ /**
61
+ * Fabrique le comparateur d'un `order` du contrat de page — **le** tri en
62
+ * mémoire de Nodefony, partagé par tous les stores qui n'ont pas de moteur pour
63
+ * le faire à leur place.
64
+ *
65
+ * Il existe parce que chaque store mémoire réécrivait le sien, en dur et inline :
66
+ * le tri d'un backend mémoire différait alors de celui du backend SQL de la même
67
+ * ressource, si bien qu'un test vert en mémoire ne disait rien de la production.
68
+ * Les backends SQL et Mongo, eux, n'en ont pas besoin — ils poussent l'`order`
69
+ * dans la requête, où il est infiniment moins cher.
70
+ *
71
+ * Les couples sont appliqués **dans l'ordre** : le premier qui départage
72
+ * l'emporte, les suivants ne servent qu'aux ex æquo. Un `order` vide rend un
73
+ * comparateur neutre (`0` partout), ce qui laisse `Array.prototype.sort` stable
74
+ * et préserve donc l'ordre d'origine.
75
+ *
76
+ * @param order - les couples `[champ, sens]` du contrat.
77
+ * @param read - comment lire un champ sur un élément.
78
+ * @returns un comparateur utilisable tel quel dans `.sort()`.
79
+ *
80
+ * @example
81
+ * ```ts
82
+ * const order = query.order?.length ? query.order : DEFAULT_ORDER;
83
+ * rows.sort(compareByOrder(order, (r, field) => r[field as keyof Row]));
84
+ * ```
85
+ */
86
+ export declare function compareByOrder<T>(order: NonNullable<IPageQuery["order"]>, read: FieldReader<T>): (a: T, b: T) => number;
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Redaction de secrets dans une ligne de texte (logs, SQL profilé, payloads).
3
+ *
4
+ * **Défense en profondeur, pas un contrôle d'accès** : la source de vérité reste
5
+ * « ne pas logger de secret ». Cette passe masque les fuites résiduelles avant
6
+ * d'exposer du texte hors du process (viewer de logs Studio, profiler dev, debug
7
+ * bar). Pure et isomorphe (zéro dépendance Node) → utilisable serveur ET browser.
8
+ *
9
+ * Couvre trois familles fréquentes :
10
+ * - paires clé/valeur JSON `"password":"x"` / `"token": x` ;
11
+ * - paires clé/valeur texte `password=x` / `Authorization: x` ;
12
+ * - schémas d'auth porteurs `Bearer <jwt>` / `Basic <b64>`.
13
+ *
14
+ * Les regex sont compilées une fois (coût nul par appel hormis le `replace`).
15
+ * Hors hot-path requête (admin plane / dev) — l'usage en boucle reste correct
16
+ * mais préférer un appel par ligne.
17
+ */
18
+ /**
19
+ * Renvoie `line` avec les secrets connus masqués par `***`.
20
+ *
21
+ * Idempotent (re-rédiger une ligne déjà masquée ne change rien). Conserve la
22
+ * structure (clés, ponctuation) pour que la ligne reste lisible/diffable.
23
+ *
24
+ * @param line - ligne de log/texte brute.
25
+ * @returns la même ligne, valeurs sensibles remplacées par `***`.
26
+ */
27
+ export declare function redactSecrets(line: string): string;