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