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