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