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