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,246 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Contrat d'exposition d'admin (Studio data plane) — défini dans le CORE.
|
|
3
|
+
*
|
|
4
|
+
* Vit dans `@nodefony/core` (et non dans framework/http) pour une raison
|
|
5
|
+
* d'architecture : la donnée d'admin peut être produite par N'IMPORTE quel
|
|
6
|
+
* niveau de la pile — y compris un module qui ne dépend que du core (adapter
|
|
7
|
+
* ORM, service IA, kernel lui-même). Le contrat doit donc résider au plus bas
|
|
8
|
+
* niveau commun.
|
|
9
|
+
*
|
|
10
|
+
* Séparation des rôles (inversion de dépendance) :
|
|
11
|
+
* - Ce fichier = **producteur** de donnée. Un module déclare *quoi* il expose,
|
|
12
|
+
* sans connaître le transport (HTTP, route, sérialisation).
|
|
13
|
+
* - `IAdminBroker` (dans `@nodefony/framework`) = **transporteur**. Lui seul a
|
|
14
|
+
* le Router : il collecte les `IAdminApi` au boot et monte
|
|
15
|
+
* `/nodefony/<namespace>/api/*`.
|
|
16
|
+
*
|
|
17
|
+
* Le handler reçoit un {@link IAdminRequest} (abstraction du Context HTTP) et
|
|
18
|
+
* renvoie du JSON sérialisable — **jamais** un objet `Context`/`Response`.
|
|
19
|
+
* C'est ce qui permet au core de définir le contrat sans importer
|
|
20
|
+
* `@nodefony/http` (interdit : le core est sous http dans le graphe de deps).
|
|
21
|
+
*/
|
|
22
|
+
import type { IFilterSpec } from "../runtime/pageFilters.js";
|
|
23
|
+
/** Méthodes HTTP supportées par le data plane admin. */
|
|
24
|
+
export type AdminHttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
|
|
25
|
+
/**
|
|
26
|
+
* Requête admin normalisée — projection minimale du Context HTTP/WS.
|
|
27
|
+
*
|
|
28
|
+
* Le broker (framework) construit cet objet à partir du `ContextType` réel,
|
|
29
|
+
* puis le passe au handler. Le handler n'accède jamais au socket ni à la
|
|
30
|
+
* Response : il lit des données, il renvoie des données.
|
|
31
|
+
*/
|
|
32
|
+
export interface IAdminRequest {
|
|
33
|
+
/** Variables de route extraites du pattern, ex `{id}` → `params.id`. */
|
|
34
|
+
params: Readonly<Record<string, string>>;
|
|
35
|
+
/** Query string parsée (`?a=1&b=2` → `{ a: "1", b: "2" }`). */
|
|
36
|
+
query: Readonly<Record<string, string | string[]>>;
|
|
37
|
+
/** Corps de requête déjà parsé (JSON), `null` si absent. */
|
|
38
|
+
body: unknown;
|
|
39
|
+
/**
|
|
40
|
+
* Utilisateur authentifié injecté par le firewall (P6), `null` tant que
|
|
41
|
+
* l'auth est mock ou la route anonyme. Typé `unknown` : le core ne connaît
|
|
42
|
+
* pas `IUser` (vit dans `@nodefony/user`).
|
|
43
|
+
*/
|
|
44
|
+
user: unknown | null;
|
|
45
|
+
/** Rôles résolus de l'utilisateur courant — base du contrôle d'accès. */
|
|
46
|
+
roles: readonly string[];
|
|
47
|
+
/** Corrélation de logs (ALS `RequestContext.getRequestId()`). */
|
|
48
|
+
requestId?: string;
|
|
49
|
+
/**
|
|
50
|
+
* Clé d'idempotence d'une **mutation** (modèle Stripe), si fournie par le
|
|
51
|
+
* client (en-tête HTTP `Idempotency-Key` ou `params.idempotencyKey` du pont
|
|
52
|
+
* WS). Le broker l'utilise pour dédoublonner un rejeu AVANT d'appeler le
|
|
53
|
+
* handler ; exposée au handler pour traçabilité/audit (il peut l'ignorer).
|
|
54
|
+
* `undefined` pour un GET ou une mutation HTTP legacy sans clé.
|
|
55
|
+
*/
|
|
56
|
+
idempotencyKey?: string;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Enveloppe de réponse d'un endpoint admin.
|
|
60
|
+
*
|
|
61
|
+
* Un handler peut renvoyer directement sa donnée (`T`) — le broker assume
|
|
62
|
+
* `{ status: 200, body: T }` — ou cette enveloppe pour piloter le statut et
|
|
63
|
+
* les en-têtes.
|
|
64
|
+
*/
|
|
65
|
+
export interface IAdminResponse<T = unknown> {
|
|
66
|
+
/** Code HTTP, défaut `200`. */
|
|
67
|
+
status?: number;
|
|
68
|
+
/** En-têtes additionnels (le broker pose `content-type: application/json`). */
|
|
69
|
+
headers?: Readonly<Record<string, string>>;
|
|
70
|
+
/** Charge utile sérialisable JSON. */
|
|
71
|
+
body: T;
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* Handler d'un endpoint admin : fonction pure entrée → sortie.
|
|
75
|
+
*
|
|
76
|
+
* Synchrone ou async. Renvoie soit la donnée brute, soit une
|
|
77
|
+
* {@link IAdminResponse} pour contrôler statut/headers.
|
|
78
|
+
*/
|
|
79
|
+
export type AdminHandler<T = unknown> = (request: IAdminRequest) => T | IAdminResponse<T> | Promise<T | IAdminResponse<T>>;
|
|
80
|
+
/**
|
|
81
|
+
* Ce qu'un endpoint paginé sait faire — **publié**, pour que son client cesse
|
|
82
|
+
* de le deviner.
|
|
83
|
+
*
|
|
84
|
+
* Une console d'administration doit savoir quelles colonnes proposer au tri et
|
|
85
|
+
* quels filtres offrir. Sans cette publication elle les code en dur, et se
|
|
86
|
+
* trompe forcément : le tri n'est pas une propriété de la ressource mais du
|
|
87
|
+
* **backend branché** (le store Redis des sessions ne trie rien, l'annuaire en
|
|
88
|
+
* mémoire ne connaît pas `createdAt`). Une en-tête de colonne triable qui rend
|
|
89
|
+
* un `400` au premier clic est le symptôme de cette devinette.
|
|
90
|
+
*
|
|
91
|
+
* ⚠️ **Cette déclaration et le handler doivent lire la MÊME donnée.** Écrire
|
|
92
|
+
* `sortable` ici et `parsePageQuery(..., { sortable })` là-bas avec deux
|
|
93
|
+
* expressions distinctes recrée exactement la divergence que la publication
|
|
94
|
+
* vient supprimer : déclarer une constante locale et la lire aux deux endroits.
|
|
95
|
+
*/
|
|
96
|
+
export interface IAdminPageCapabilities {
|
|
97
|
+
/**
|
|
98
|
+
* Champs triables — **une fonction**, parce que la réponse dépend du store
|
|
99
|
+
* effectivement branché au démarrage, pas d'une constante de compilation.
|
|
100
|
+
* Elle est évaluée à la lecture du catalogue.
|
|
101
|
+
*/
|
|
102
|
+
sortable?: () => readonly string[];
|
|
103
|
+
/**
|
|
104
|
+
* Vocabulaire de filtre de l'endpoint ({@link IFilterSpec}), sérialisable tel
|
|
105
|
+
* quel : un nom → une nature (`"boolean"`, `"int"`, `"string"`) ou la liste
|
|
106
|
+
* fermée de ses valeurs, qui vaut allowlist.
|
|
107
|
+
*/
|
|
108
|
+
filters?: IFilterSpec;
|
|
109
|
+
/**
|
|
110
|
+
* L'endpoint sait-il **chercher** (`?q=`) — même raison d'être que
|
|
111
|
+
* {@link IAdminPageCapabilities.sortable}, et même piège s'il manque : une
|
|
112
|
+
* console qui affiche une barre de recherche que le serveur ignore présente
|
|
113
|
+
* la collection entière comme un résultat de recherche.
|
|
114
|
+
*
|
|
115
|
+
* **Une fonction**, parce que la réponse dépend du store branché au
|
|
116
|
+
* démarrage — un backend en curseur ne balaie pas. Absente = pas de
|
|
117
|
+
* recherche, et `parsePageQuery` refuse alors `?q=` en `400`.
|
|
118
|
+
*/
|
|
119
|
+
search?: () => boolean;
|
|
120
|
+
/**
|
|
121
|
+
* Table des **facettes** de cet endpoint — nom → jeu de filtres qui la
|
|
122
|
+
* sélectionne. Publiée pour que les cartes de tête d'une console deviennent
|
|
123
|
+
* CLIQUABLES sans redéclarer, côté client, ce que « actives » ou « en échec »
|
|
124
|
+
* veut dire.
|
|
125
|
+
*
|
|
126
|
+
* C'est la même donnée que celle passée à `countFacets` : une carte affiche
|
|
127
|
+
* un nombre, et le clic pose exactement le filtre qui l'a produit — sans quoi
|
|
128
|
+
* la liste montrerait autre chose que ce que la carte annonce. Une console
|
|
129
|
+
* qui recomposerait ce mapping de son côté divergerait au premier changement
|
|
130
|
+
* de définition (« utilisable » = sans échéance OU échéance à venir, une règle
|
|
131
|
+
* qui vit dans le vocabulaire de la ressource, pas dans l'écran).
|
|
132
|
+
*
|
|
133
|
+
* Sérialisable telle quelle : ce sont des valeurs, pas des prédicats.
|
|
134
|
+
*/
|
|
135
|
+
facets?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
|
|
136
|
+
}
|
|
137
|
+
/**
|
|
138
|
+
* Définition déclarative d'un endpoint, relative au namespace du module.
|
|
139
|
+
*
|
|
140
|
+
* Exemple : `{ path: "sessions", method: "GET" }` sur le module `http` est
|
|
141
|
+
* monté en `GET /nodefony/http/api/sessions`.
|
|
142
|
+
*/
|
|
143
|
+
export interface IAdminEndpoint<T = unknown> {
|
|
144
|
+
/**
|
|
145
|
+
* Chemin RELATIF au namespace, sans `/` initial. Supporte les variables de
|
|
146
|
+
* route du framework (`"routes/{id}"`). **≥ 1 segment** — interdit de monter
|
|
147
|
+
* la racine `/nodefony/<module>/api` seule (réservée à un éventuel index).
|
|
148
|
+
*/
|
|
149
|
+
path: string;
|
|
150
|
+
/** Méthode HTTP, défaut `"GET"`. */
|
|
151
|
+
method?: AdminHttpMethod;
|
|
152
|
+
/**
|
|
153
|
+
* Rôle minimum requis pour appeler l'endpoint (RBAC appliqué par le broker).
|
|
154
|
+
* Défaut `"ROLE_NODEFONY_ADMIN"`. Le broker refuse (403) si
|
|
155
|
+
* `request.roles` ne le contient pas.
|
|
156
|
+
*/
|
|
157
|
+
role?: string;
|
|
158
|
+
/**
|
|
159
|
+
* Endpoint PUBLIC : le broker n'impose AUCUN rôle (pas de défaut
|
|
160
|
+
* `ROLE_NODEFONY_ADMIN`), la route est atteignable sans authentification.
|
|
161
|
+
* À RÉSERVER aux sondes (liveness/readiness cloud-native) ; toute gradation
|
|
162
|
+
* d'information par rôle se fait alors DANS le handler (`request.roles`). La
|
|
163
|
+
* route doit aussi être placée hors d'une aire fermée (zone firewall dédiée
|
|
164
|
+
* avec `anonymous`), sinon le firewall la verrouille en amont (401).
|
|
165
|
+
*/
|
|
166
|
+
public?: boolean;
|
|
167
|
+
/** Résumé court pour l'auto-doc Studio et l'introspection. */
|
|
168
|
+
summary?: string;
|
|
169
|
+
/**
|
|
170
|
+
* Capacités de pagination publiées dans le catalogue admin — tri possible et
|
|
171
|
+
* vocabulaire de filtre. Cf {@link IAdminPageCapabilities}.
|
|
172
|
+
*/
|
|
173
|
+
page?: IAdminPageCapabilities;
|
|
174
|
+
/** Implémentation. */
|
|
175
|
+
handler: AdminHandler<T>;
|
|
176
|
+
}
|
|
177
|
+
/**
|
|
178
|
+
* Métadonnées d'affichage du module dans la sidebar Studio.
|
|
179
|
+
*/
|
|
180
|
+
export interface IAdminDescriptor {
|
|
181
|
+
/** Libellé humain, ex `"HTTP"`, `"Sécurité"`, `"Kernel"`. */
|
|
182
|
+
label: string;
|
|
183
|
+
/** Nom d'icône (jeu Tabler, cohérent avec le frontend Studio). */
|
|
184
|
+
icon?: string;
|
|
185
|
+
/** Ordre d'affichage croissant dans la sidebar. */
|
|
186
|
+
order?: number;
|
|
187
|
+
/** Rôle requis pour voir l'entrée de menu (peut différer par endpoint). */
|
|
188
|
+
role?: string;
|
|
189
|
+
}
|
|
190
|
+
/**
|
|
191
|
+
* Contrat qu'un producteur (module ou kernel) implémente pour exposer sa
|
|
192
|
+
* donnée d'admin à Studio via le data plane `/nodefony/<namespace>/api/*`.
|
|
193
|
+
*
|
|
194
|
+
* Un `IAdminApi` est un objet **séparé** de la classe `Module` (pas un mixin) :
|
|
195
|
+
* un module l'expose via `getAdminApi?(): IAdminApi | null` et le broker le
|
|
196
|
+
* collecte au boot. Cela évite de polluer la classe `Module` et permet au
|
|
197
|
+
* kernel — qui n'est pas un `Module` — d'exposer le sien de la même façon.
|
|
198
|
+
*
|
|
199
|
+
* @see IAdminBroker (dans `@nodefony/framework`) pour le montage des routes.
|
|
200
|
+
*/
|
|
201
|
+
export interface IAdminApi {
|
|
202
|
+
/**
|
|
203
|
+
* Segment de route ET clé d'identification unique. Donne
|
|
204
|
+
* `/nodefony/<adminNamespace>/api/*`. Ex `"http"`, `"security"`, `"kernel"`.
|
|
205
|
+
* Doit être stable (les liens Studio en dépendent) et url-safe.
|
|
206
|
+
*/
|
|
207
|
+
readonly adminNamespace: string;
|
|
208
|
+
/** Métadonnées d'affichage (sidebar Studio). */
|
|
209
|
+
adminDescriptor(): IAdminDescriptor;
|
|
210
|
+
/** Endpoints exposés par ce producteur. Évalué une fois au montage. */
|
|
211
|
+
adminEndpoints(): IAdminEndpoint[];
|
|
212
|
+
}
|
|
213
|
+
/**
|
|
214
|
+
* Façade d'enregistrement du data plane admin — vue **minimale** du broker que
|
|
215
|
+
* voit un producteur.
|
|
216
|
+
*
|
|
217
|
+
* Vit dans le core (pas dans framework) précisément pour que n'importe quel
|
|
218
|
+
* module producteur puisse s'enregistrer **sans importer `@nodefony/framework`**
|
|
219
|
+
* (interdit : `@nodefony/http` etc. sont sous framework dans le graphe de deps).
|
|
220
|
+
* Un module récupère le service `"adminBroker"` du container et le type via
|
|
221
|
+
* cette interface :
|
|
222
|
+
*
|
|
223
|
+
* ```ts
|
|
224
|
+
* const registry = container.get("adminBroker") as IAdminRegistry;
|
|
225
|
+
* registry.register(myAdminApi);
|
|
226
|
+
* ```
|
|
227
|
+
*
|
|
228
|
+
* Le contrat complet (montage des routes, résolution) est `IAdminBroker` dans
|
|
229
|
+
* `@nodefony/framework`, qui étend celui-ci.
|
|
230
|
+
*/
|
|
231
|
+
export interface IAdminRegistry {
|
|
232
|
+
/**
|
|
233
|
+
* Enregistre un producteur. À appeler dans `onKernelBoot` (avant le montage
|
|
234
|
+
* fait par framework à `onKernelReady`).
|
|
235
|
+
* @throws si le namespace est déjà pris ou si le montage a déjà eu lieu.
|
|
236
|
+
*/
|
|
237
|
+
register(api: IAdminApi): this;
|
|
238
|
+
/** Retire un producteur (et ses routes si déjà montées). */
|
|
239
|
+
unregister(namespace: string): boolean;
|
|
240
|
+
/** `true` si un producteur est enregistré sous ce namespace. */
|
|
241
|
+
has(namespace: string): boolean;
|
|
242
|
+
/** Producteur enregistré sous ce namespace, ou `undefined`. */
|
|
243
|
+
getApi(namespace: string): IAdminApi | undefined;
|
|
244
|
+
/** Liste immuable des producteurs enregistrés. */
|
|
245
|
+
list(): readonly IAdminApi[];
|
|
246
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { Command as CommanderCommand } from "commander";
|
|
2
|
+
import type { EnvironmentType, DebugType } from "./globals.js";
|
|
3
|
+
type RunLifetime = "oneshot" | "longrunning";
|
|
4
|
+
interface IRunProfile {
|
|
5
|
+
servers: boolean;
|
|
6
|
+
lifetime: RunLifetime;
|
|
7
|
+
interactive: boolean;
|
|
8
|
+
}
|
|
9
|
+
export interface ICliKernel {
|
|
10
|
+
commander: CommanderCommand | null;
|
|
11
|
+
environment: EnvironmentType;
|
|
12
|
+
runProfile: IRunProfile;
|
|
13
|
+
/** Boot silencieux d'une commande CLI utilitaire (cf CliKernel.quietBoot). */
|
|
14
|
+
quietBoot?: boolean;
|
|
15
|
+
debug: DebugType;
|
|
16
|
+
pid: number | null;
|
|
17
|
+
setProcessTitle(name?: string): void;
|
|
18
|
+
showBanner(): void;
|
|
19
|
+
blankLine(): void;
|
|
20
|
+
clear(): void;
|
|
21
|
+
showAsciify(name: string | null): Promise<unknown>;
|
|
22
|
+
parseCommandAsync(argv?: string[]): Promise<CommanderCommand>;
|
|
23
|
+
runCommandAsync(cmd: string, args?: string[]): Promise<CommanderCommand>;
|
|
24
|
+
setPackageManager(manager?: string): unknown;
|
|
25
|
+
setCommandVersion(version: string): CommanderCommand;
|
|
26
|
+
initSyslog(env?: EnvironmentType, debug?: DebugType): void | null;
|
|
27
|
+
}
|
|
28
|
+
export {};
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
type KernelEventKey = "onInit" | "onPreStart" | "onStart" | "onPreRegister" | "onRegister" | "onPreBoot" | "onBoot" | "onReady" | "onServersReady" | "onPostReady" | "onTerminate";
|
|
2
|
+
type RunLifetime = "oneshot" | "longrunning";
|
|
3
|
+
export type { KernelEventKey, RunLifetime };
|
|
4
|
+
export interface ICommand {
|
|
5
|
+
name: string;
|
|
6
|
+
kernelEvent: KernelEventKey;
|
|
7
|
+
/**
|
|
8
|
+
* Durée de vie DÉCLARÉE par la commande : `"oneshot"` (build/install/batch → terminate
|
|
9
|
+
* une fois la phase atteinte) ou `"longrunning"` (daemon CONSOLE → le Kernel parke au
|
|
10
|
+
* lieu de terminer, cf `Kernel.finishOrPark`). Capability déclarative, lue par le Kernel.
|
|
11
|
+
*/
|
|
12
|
+
lifetime: RunLifetime;
|
|
13
|
+
action(...args: unknown[]): Promise<unknown>;
|
|
14
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { DynamicParam } from "../Container.js";
|
|
2
|
+
import type { Pci, Severity, Msgid, Message } from "../syslog/Pdu.js";
|
|
3
|
+
import type Syslog from "../syslog/Syslog.js";
|
|
4
|
+
/**
|
|
5
|
+
* Contrat public d'un scope (Container enfant lié à un parent).
|
|
6
|
+
* Étend IContainer et ajoute name + getParameters avec merge/deep.
|
|
7
|
+
*/
|
|
8
|
+
export interface IScope extends IContainer {
|
|
9
|
+
readonly name: string;
|
|
10
|
+
getParameters(name: string, merge?: boolean, deep?: boolean): DynamicParam | null;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Contrat public du DI Container nodefony.
|
|
14
|
+
* Container et Scope l'implémentent.
|
|
15
|
+
*/
|
|
16
|
+
export interface IContainer {
|
|
17
|
+
readonly id: string;
|
|
18
|
+
set<T>(name: string, object: T): void;
|
|
19
|
+
get<T = unknown>(name: string): T | null;
|
|
20
|
+
remove(name: string): boolean;
|
|
21
|
+
has(name: string): boolean;
|
|
22
|
+
keys(): string[];
|
|
23
|
+
entries(): [string, unknown][];
|
|
24
|
+
setParameters<T>(name: string, ele: T): DynamicParam | null;
|
|
25
|
+
getParameters(name: string): DynamicParam | null;
|
|
26
|
+
addScope(name: string): object;
|
|
27
|
+
enterScope(name: string): IScope;
|
|
28
|
+
leaveScope(scope: IScope): void;
|
|
29
|
+
removeScope(name: string): void;
|
|
30
|
+
/** Nombre d'instances vivantes du scope nommé (introspection/sondes). */
|
|
31
|
+
scopeCount(name: string): number;
|
|
32
|
+
log(pci: Pci, severity?: Severity, msgid?: Msgid, msg?: Message): ReturnType<Syslog["log"]> | void;
|
|
33
|
+
clean(): void;
|
|
34
|
+
reset(): void;
|
|
35
|
+
}
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
import type { IPage, IPageQuery } from "./IPage.js";
|
|
2
|
+
/**
|
|
3
|
+
* Réponse mémorisée d'une mutation idempotente — la forme `{status, headers?, body}`
|
|
4
|
+
* produite par un endpoint (data plane admin `AdminApiController.runAdmin`, ou
|
|
5
|
+
* action userland `@Idempotent`), pour la rejouer telle quelle à un rejeu (même
|
|
6
|
+
* statut, même corps, même en-têtes).
|
|
7
|
+
*/
|
|
8
|
+
export interface IdempotentResponse {
|
|
9
|
+
/** Code HTTP de la réponse mémorisée. */
|
|
10
|
+
status: number;
|
|
11
|
+
/** En-têtes additionnels éventuels. */
|
|
12
|
+
headers?: Readonly<Record<string, string>>;
|
|
13
|
+
/** Charge utile sérialisable JSON. */
|
|
14
|
+
body: unknown;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Verdict de {@link IIdempotencyStore.begin} pour une clé d'idempotence donnée.
|
|
18
|
+
* Aligné sur `draft-ietf-httpapi-idempotency-key-header-06` §2.6/§2.7.
|
|
19
|
+
*
|
|
20
|
+
* - `fresh` : clé jamais vue (ou bail expiré) → réservée *in-flight*, l'appelant
|
|
21
|
+
* DOIT exécuter la mutation puis appeler `complete()` (succès) ou `abort()`
|
|
22
|
+
* (échec). (§2.6 « First time request ».)
|
|
23
|
+
* - `in-flight` : une exécution identique est **en cours** → l'appelant renvoie
|
|
24
|
+
* `409 Conflict` (§2.6 « Concurrent Request », §2.7).
|
|
25
|
+
* - `replayed` : la mutation a **déjà** été exécutée → l'appelant renvoie la
|
|
26
|
+
* `response` mémorisée SANS ré-exécuter (§2.6 « Retry » : une socket qui
|
|
27
|
+
* reconnecte rejoue sa frame en vol).
|
|
28
|
+
* - `mismatch` : la clé a déjà été vue avec un **payload DIFFÉRENT** (fingerprint
|
|
29
|
+
* distinct) → réutilisation interdite d'une clé → l'appelant renvoie
|
|
30
|
+
* `422 Unprocessable Content` (§2.2 + §2.7).
|
|
31
|
+
*/
|
|
32
|
+
export type IdempotencyOutcome = {
|
|
33
|
+
state: "fresh";
|
|
34
|
+
} | {
|
|
35
|
+
state: "in-flight";
|
|
36
|
+
} | {
|
|
37
|
+
state: "replayed";
|
|
38
|
+
response: IdempotentResponse;
|
|
39
|
+
} | {
|
|
40
|
+
state: "mismatch";
|
|
41
|
+
};
|
|
42
|
+
/**
|
|
43
|
+
* Une clé d'idempotence telle qu'exposée à l'INTROSPECTION admin.
|
|
44
|
+
*
|
|
45
|
+
* 🔒 **Sans la réponse mémorisée, par construction du contrat.** Le `body`
|
|
46
|
+
* mémorisé est la réponse métier d'un utilisateur : le rendre lisible par ce
|
|
47
|
+
* chemin serait exactement l'IDOR sur le cache contre lequel
|
|
48
|
+
* {@link IIdempotencyStore} met en garde. Le `fingerprint` est également exclu
|
|
49
|
+
* (aucune valeur d'exploitation). La `key`, elle, est visible : c'est ce qu'un
|
|
50
|
+
* admin doit voir pour repérer une clé figée *in-flight* — d'où un endpoint
|
|
51
|
+
* réservé à l'administration.
|
|
52
|
+
*/
|
|
53
|
+
export interface IIdempotencyKeyEntry {
|
|
54
|
+
/** La clé d'idempotence (telle que composée par l'appelant). */
|
|
55
|
+
readonly key: string;
|
|
56
|
+
/** `in-flight` = mutation en cours ; `done` = réponse mémorisée (rejouable). */
|
|
57
|
+
readonly state: "in-flight" | "done";
|
|
58
|
+
/** Échéance de l'entrée (epoch ms) — au-delà, la clé redevient `fresh`. */
|
|
59
|
+
readonly expiresAtMs: number;
|
|
60
|
+
/** `true` si une réponse est mémorisée (jamais son contenu). */
|
|
61
|
+
readonly hasResponse: boolean;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Requête de listing des clés d'idempotence — {@link IPageQuery} + le filtre
|
|
65
|
+
* d'exploitation. `q` (hérité) = **préfixe** de clé : les clés sont composées
|
|
66
|
+
* (identité + méthode + chemin), donc le préfixe isole un scope entier.
|
|
67
|
+
*/
|
|
68
|
+
export interface IIdempotencyListQuery extends IPageQuery {
|
|
69
|
+
/** Restreint à un état. Omis = les deux. */
|
|
70
|
+
state?: "in-flight" | "done";
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Cache d'idempotence borné (modèle Stripe `Idempotency-Key`) — dédoublonne les
|
|
74
|
+
* **mutations** rejouées (reconnexion socket, double-clic) du data plane admin
|
|
75
|
+
* comme des controllers userland décorés `@Idempotent`.
|
|
76
|
+
*
|
|
77
|
+
* Contrat de l'appelant (anti double-effet) — `begin` prend DEUX arguments, et
|
|
78
|
+
* l'`await` est requis (une impl distribuée renvoie une `Promise`) :
|
|
79
|
+
* ```
|
|
80
|
+
* const o = await store.begin(key, fingerprint);
|
|
81
|
+
* if (o.state === "in-flight") return conflict409;
|
|
82
|
+
* if (o.state === "replayed") return o.response;
|
|
83
|
+
* if (o.state === "mismatch") return unprocessable422; // clé réutilisée, autre payload
|
|
84
|
+
* try { const r = await handler(); await store.complete(key, r); return r; }
|
|
85
|
+
* catch (e) { await store.abort(key); throw e; } // un échec ne se mémorise pas
|
|
86
|
+
* ```
|
|
87
|
+
*
|
|
88
|
+
* 🔒 **La `key` DOIT être scopée à l'identité** (`userId` + méthode + chemin +
|
|
89
|
+
* clé client) : sinon un utilisateur rejouerait la clé d'un autre et lirait sa
|
|
90
|
+
* réponse mémorisée (IDOR sur le cache). Le store reste **agnostique** au scope
|
|
91
|
+
* — c'est l'appelant qui compose une clé sûre.
|
|
92
|
+
*
|
|
93
|
+
* **Per-pod** : implémentation mémoire par défaut (la socket reste affine à son
|
|
94
|
+
* pod). En cluster, une impl partagée (Redis `SET NX`+`EXPIRE`, Drizzle) se
|
|
95
|
+
* branche derrière ce contrat — slot prévu, à la façon de `ITokenStore`. Ce
|
|
96
|
+
* contrat vit au CORE (pas `@nodefony/framework`) pour que `@nodefony/redis` /
|
|
97
|
+
* `@nodefony/drizzle` (graphe sous orm-core/core, hors framework) puissent
|
|
98
|
+
* l'implémenter sans dépendre de framework.
|
|
99
|
+
*
|
|
100
|
+
* **Sync OU async** : `begin`/`complete`/`abort` renvoient `T | Promise<T>`.
|
|
101
|
+
* L'impl mémoire reste **synchrone** (mono-thread JS, 0 microtask sur le store
|
|
102
|
+
* lui-même) ; une impl **distribuée** (Redis/Drizzle) est forcément async (round
|
|
103
|
+
* trip réseau) → elle renvoie des `Promise`. L'appelant `await` le résultat : le
|
|
104
|
+
* surcoût d'un `await` sur une valeur sync (1 microtask) ne touche QUE le chemin
|
|
105
|
+
* **mutation idempotente** (déjà async, froid) ; le hot path GET/non-décoré ne
|
|
106
|
+
* passe jamais ici (court-circuit `idempotent === null` en amont).
|
|
107
|
+
*/
|
|
108
|
+
export interface IIdempotencyStore {
|
|
109
|
+
/**
|
|
110
|
+
* Réserve **atomiquement** la clé et renvoie le verdict à suivre. L'atomicité
|
|
111
|
+
* vient du **mono-thread JS** (impl mémoire) ou d'un `SET … NX` côté serveur
|
|
112
|
+
* (impl Redis) : deux `begin` concurrents → un seul réserve (`fresh`), l'autre
|
|
113
|
+
* voit l'entrée (`in-flight`). Une entrée *in-flight* dont le bail a expiré
|
|
114
|
+
* (handler figé sans `complete`/`abort`) est traitée comme `fresh`.
|
|
115
|
+
*
|
|
116
|
+
* @param fingerprint - empreinte du **payload** de la requête (méthode + chemin
|
|
117
|
+
* + corps), comparée à celle mémorisée pour la clé : si elle diffère, la clé
|
|
118
|
+
* est réutilisée pour une AUTRE requête → `mismatch` (422). Cf draft §2.4.
|
|
119
|
+
*/
|
|
120
|
+
begin(key: string, fingerprint: string): IdempotencyOutcome | Promise<IdempotencyOutcome>;
|
|
121
|
+
/** Mémorise la réponse d'une clé *in-flight* (TTL) → rejeux futurs = `replayed`. */
|
|
122
|
+
complete(key: string, response: IdempotentResponse): void | Promise<void>;
|
|
123
|
+
/**
|
|
124
|
+
* Libère une clé *in-flight* dont l'exécution a échoué : rien n'est mémorisé
|
|
125
|
+
* (un échec doit pouvoir être réessayé). No-op si la clé n'est plus *in-flight*.
|
|
126
|
+
*/
|
|
127
|
+
abort(key: string): void | Promise<void>;
|
|
128
|
+
/**
|
|
129
|
+
* Purge les entrées expirées — présente UNIQUEMENT sur les impls SANS expiration
|
|
130
|
+
* native (`drizzle` → `DELETE WHERE expiresAt <= now`). **Absente** quand le store
|
|
131
|
+
* expire seul (Redis `PX` natif) ou purge passivement (mémoire, au cap FIFO).
|
|
132
|
+
* Quand cette méthode existe, le framework arme un `GcScheduler` au boot
|
|
133
|
+
* (intervalle `idempotency.gcIntervalS`) — hors hot-path.
|
|
134
|
+
*
|
|
135
|
+
* @param now - horloge de purge (epoch ms ; défaut = horloge interne du store).
|
|
136
|
+
* @returns nombre d'entrées purgées.
|
|
137
|
+
*/
|
|
138
|
+
gc?(now?: number): Promise<number> | number;
|
|
139
|
+
/**
|
|
140
|
+
* Page de clés vivantes — introspection admin (repérer une clé figée
|
|
141
|
+
* *in-flight* qui bloque les rejeux d'un client). Ne matérialise jamais plus
|
|
142
|
+
* d'une page ; la réponse mémorisée ne sort pas (cf
|
|
143
|
+
* {@link IIdempotencyKeyEntry}).
|
|
144
|
+
*
|
|
145
|
+
* Capacité selon le backend : **offset + total** (mémoire, SQL) ou
|
|
146
|
+
* **curseur** (`nextCursor`, Redis `SCAN`) — le store déclare ce qu'il sait
|
|
147
|
+
* faire en posant l'un ou l'autre, jamais les deux.
|
|
148
|
+
*
|
|
149
|
+
* Ordre : `expiresAtMs` ASC (ce qui va expirer en premier d'abord) pour les
|
|
150
|
+
* backends ordonnables ; non garanti en mode curseur (`SCAN` n'ordonne pas).
|
|
151
|
+
*/
|
|
152
|
+
listPage(query: IIdempotencyListQuery): Promise<IPage<IIdempotencyKeyEntry>>;
|
|
153
|
+
/**
|
|
154
|
+
* Nombre d'entrées vivantes (observabilité / tests). **Sync best-effort** : la
|
|
155
|
+
* vérité per-pod pour l'impl mémoire ; pour une impl distribuée (Redis), une
|
|
156
|
+
* approximation locale (compteur du pod, pas un `SCAN`/`DBSIZE` cluster cher).
|
|
157
|
+
*/
|
|
158
|
+
readonly size: number;
|
|
159
|
+
}
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
import type { IService } from "./IService.js";
|
|
2
|
+
import type { IModule } from "./IModule.js";
|
|
3
|
+
import type { IBootReport } from "../kernel/bootReport.js";
|
|
4
|
+
import type { IReadinessContributor } from "../kernel/readinessRegistry.js";
|
|
5
|
+
import type FileClass from "../FileClass.js";
|
|
6
|
+
import type { EnvironmentType, DebugType } from "./globals.js";
|
|
7
|
+
import type { ICliKernel } from "./ICliKernel.js";
|
|
8
|
+
import type { IInfra, IStoreResolution } from "../config/infra.js";
|
|
9
|
+
import type { ICommand } from "./ICommand.js";
|
|
10
|
+
import type os from "node:os";
|
|
11
|
+
type RunLifetime = "oneshot" | "longrunning";
|
|
12
|
+
interface IRunProfile {
|
|
13
|
+
servers: boolean;
|
|
14
|
+
lifetime: RunLifetime;
|
|
15
|
+
interactive: boolean;
|
|
16
|
+
}
|
|
17
|
+
type EventsType = Record<string, number>;
|
|
18
|
+
type TrunkType = "javascript" | "typescript" | null;
|
|
19
|
+
export interface KernelNetworkResult {
|
|
20
|
+
external: Record<string, os.NetworkInterfaceInfo[]>;
|
|
21
|
+
local: Record<string, os.NetworkInterfaceInfo[]>;
|
|
22
|
+
ipv4: Record<string, os.NetworkInterfaceInfo[]>;
|
|
23
|
+
ipv6: Record<string, os.NetworkInterfaceInfo[]>;
|
|
24
|
+
interfaces: Record<string, os.NetworkInterfaceInfo[]>;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Contrat public du Kernel nodefony.
|
|
28
|
+
* Utilisé comme type de IService.kernel pour éviter l'import circulaire
|
|
29
|
+
* Kernel.ts → Service.ts → IService.ts → IKernel.ts → Kernel.ts.
|
|
30
|
+
*
|
|
31
|
+
* IModule sera ajouté quand IModule sera défini (getModule/modules typés object pour l'instant).
|
|
32
|
+
* command/commandArgs typés object/unknown[] — ICommand session dédiée.
|
|
33
|
+
*/
|
|
34
|
+
export interface IKernel extends IService {
|
|
35
|
+
runProfile: IRunProfile;
|
|
36
|
+
readonly version: string;
|
|
37
|
+
readonly environment: EnvironmentType;
|
|
38
|
+
readonly debug: DebugType;
|
|
39
|
+
readonly projectName: string;
|
|
40
|
+
readonly path: string;
|
|
41
|
+
/**
|
|
42
|
+
* Répertoire des données runtime PERSISTÉES (`<path>/var`) — base commune des
|
|
43
|
+
* stores fichier (passkeys, TOTP, sessions) et bases SQLite. Gitignoré ; garanti
|
|
44
|
+
* créé au boot (comme `tmpDir`, éphémère). Absent tant que le Kernel n'a pas booté.
|
|
45
|
+
*/
|
|
46
|
+
readonly varDir?: FileClass;
|
|
47
|
+
readonly isDev: boolean;
|
|
48
|
+
readonly isProd: boolean;
|
|
49
|
+
/**
|
|
50
|
+
* Infra déclarée (`database`/`cache`/`logs`) résolue depuis l'environnement
|
|
51
|
+
* (URLs `NF_DATABASE_URL`/`NF_REDIS_URL`/…). Mémoïsée — consommée par les
|
|
52
|
+
* briques dont le store vaut `"auto"` (`resolveAutoStore`).
|
|
53
|
+
*/
|
|
54
|
+
readonly infra: IInfra;
|
|
55
|
+
/**
|
|
56
|
+
* Résolutions EFFECTIVES des stores de persistance, capturées au boot par
|
|
57
|
+
* chaque brique (`registerStoreResolution`) — la vérité vécue (replis inclus),
|
|
58
|
+
* alimente l'écran Studio « Stores ». Vide tant qu'aucune brique n'a résolu.
|
|
59
|
+
*/
|
|
60
|
+
readonly storeResolutions: IStoreResolution[];
|
|
61
|
+
/**
|
|
62
|
+
* Enregistre la résolution effective d'une brique de persistance (idempotent
|
|
63
|
+
* par `brick` — la dernière résolution gagne). La provenance est dérivée de
|
|
64
|
+
* `configured` (`"auto"` → `"infra"`, sinon `"explicit"`). Appelé au boot,
|
|
65
|
+
* après le `log()` de résolution du consommateur.
|
|
66
|
+
*/
|
|
67
|
+
registerStoreResolution(resolution: Omit<IStoreResolution, "provenance">): void;
|
|
68
|
+
/**
|
|
69
|
+
* L'environnement FOURNIT-il un vrai terminal ? Résolu une fois au boot
|
|
70
|
+
* (`process.stdout.isTTY`, surchargeable `NF_NO_TTY`). Volet « environnement » qui
|
|
71
|
+
* complète `runProfile.interactive` (besoin déclaré) : un prompt n'a de sens que si
|
|
72
|
+
* `runProfile.interactive && kernel.isTTY`. Cloud-native (pod/CI) → toujours `false`.
|
|
73
|
+
*/
|
|
74
|
+
readonly isTTY: boolean;
|
|
75
|
+
readonly pid: number;
|
|
76
|
+
readonly platform: NodeJS.Platform;
|
|
77
|
+
/** Répertoire temporaire du projet (`<cwd>/tmp`), initialisé au boot. */
|
|
78
|
+
tmpDir?: FileClass;
|
|
79
|
+
readonly started: boolean;
|
|
80
|
+
readonly booted: boolean;
|
|
81
|
+
readonly ready: boolean;
|
|
82
|
+
readonly postReady: boolean;
|
|
83
|
+
/** Supprime les bannières serveurs sous l'écran de boot animé (dev). */
|
|
84
|
+
readonly suppressBootBanners: boolean;
|
|
85
|
+
readonly Events: Readonly<EventsType>;
|
|
86
|
+
readonly progress: number;
|
|
87
|
+
readonly trunk: TrunkType;
|
|
88
|
+
command: ICommand | null;
|
|
89
|
+
commandArgs: unknown[];
|
|
90
|
+
domain: string;
|
|
91
|
+
cli: ICliKernel | null;
|
|
92
|
+
readonly modules: Record<string, IModule>;
|
|
93
|
+
start(): Promise<this>;
|
|
94
|
+
/** `quiet` muselle l'affichage (log « terminate : N ») — jamais le drain. */
|
|
95
|
+
terminate(code?: number, quiet?: boolean): Promise<this>;
|
|
96
|
+
isTrunk(): Promise<TrunkType>;
|
|
97
|
+
isModule(subclass: unknown): boolean;
|
|
98
|
+
addModule(Mod: unknown, ...args: unknown[]): Promise<IModule>;
|
|
99
|
+
loadModule(nameOrPath: string): Promise<IModule>;
|
|
100
|
+
getModule(name: string): IModule;
|
|
101
|
+
getModules(): Record<string, IModule>;
|
|
102
|
+
getNetwork(): KernelNetworkResult;
|
|
103
|
+
checkPath(myPath: string): string | null;
|
|
104
|
+
isCommandComplete(progress: number): boolean;
|
|
105
|
+
/** Verdict agrégé du dernier boot (modules, serveurs, santé) — vérité unique. */
|
|
106
|
+
getBootReport(): IBootReport;
|
|
107
|
+
/** AJOUTE une ligne de détail à afficher sous une phase de boot (canal neutre). */
|
|
108
|
+
reportBootLine(phase: string, line: string): void;
|
|
109
|
+
/** REMPLACE les lignes de détail d'une phase (producteur idempotent). */
|
|
110
|
+
setBootLines(phase: string, lines: string[]): void;
|
|
111
|
+
/** Lignes de détail déclarées pour une phase de boot. */
|
|
112
|
+
getBootLines(phase: string): string[];
|
|
113
|
+
/**
|
|
114
|
+
* Nombre de composants qui retiennent la mise en service — `0` = disponible.
|
|
115
|
+
* Verdict DÉJÀ calculé : le lire ne déclenche aucune vérification.
|
|
116
|
+
*/
|
|
117
|
+
readonly readinessBlocked: number;
|
|
118
|
+
/**
|
|
119
|
+
* Ce processus a-t-il le droit de recevoir du trafic ?
|
|
120
|
+
*
|
|
121
|
+
* La règle de mise en service, en UN point : cycle de démarrage TERMINÉ
|
|
122
|
+
* (`postReady`) et aucun composant qui retienne. Lue telle quelle par la
|
|
123
|
+
* sonde `/readyz` et par le champ `ready` du plan d'administration — les
|
|
124
|
+
* recomposer chacun de son côté les a déjà fait diverger.
|
|
125
|
+
*/
|
|
126
|
+
readonly servable: boolean;
|
|
127
|
+
/**
|
|
128
|
+
* Pose le verdict de disponibilité d'un composant nommé (schéma en retard,
|
|
129
|
+
* cache froid…). Un seul `false` suffit à faire rendre 503 à `/readyz` ;
|
|
130
|
+
* `/livez` reste 200 — un état externe ne se répare pas par un redémarrage.
|
|
131
|
+
*/
|
|
132
|
+
setReadiness(name: string, ready: boolean, reason?: string): void;
|
|
133
|
+
/** Retire un contributeur : sa voix ne retient plus rien. */
|
|
134
|
+
clearReadiness(name: string): void;
|
|
135
|
+
/** État de chaque contributeur — pour un diagnostic, jamais pour la sonde. */
|
|
136
|
+
readinessReport(): IReadinessContributor[];
|
|
137
|
+
}
|
|
138
|
+
export {};
|