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
package/docs/client.md
ADDED
|
@@ -0,0 +1,616 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Le client isomorphe — Nodefony dans le navigateur"
|
|
3
|
+
navTitle: Le client isomorphe
|
|
4
|
+
lang: fr
|
|
5
|
+
module: "@nodefony/core"
|
|
6
|
+
topic: client
|
|
7
|
+
coverageModule: nodefony-core
|
|
8
|
+
coveragePackage: "nodefony (cœur)"
|
|
9
|
+
coverageFiles: "client/realtime/RealtimeClient.ts,client/realtime/AdaptiveRate.ts,client/roles/roles.ts"
|
|
10
|
+
section: "Cœur runtime"
|
|
11
|
+
audience: [developer]
|
|
12
|
+
tags:
|
|
13
|
+
[
|
|
14
|
+
client,
|
|
15
|
+
isomorphe,
|
|
16
|
+
navigateur,
|
|
17
|
+
realtime,
|
|
18
|
+
websocket,
|
|
19
|
+
json-rpc,
|
|
20
|
+
subpath,
|
|
21
|
+
roles,
|
|
22
|
+
debugbar,
|
|
23
|
+
cadence,
|
|
24
|
+
]
|
|
25
|
+
version: "doc"
|
|
26
|
+
status: stable
|
|
27
|
+
updated: 2026-07-19
|
|
28
|
+
source: "src/nodefony/docs/client.md"
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
# Le client isomorphe — Nodefony dans le navigateur
|
|
32
|
+
|
|
33
|
+
> Le paquet `nodefony` ne s'arrête pas au serveur : une partie de son code est **compilée pour le
|
|
34
|
+
> navigateur** et publiée sous quatre points d'entrée (`nodefony/client`, `nodefony/react`,
|
|
35
|
+
> `nodefony/roles`, `nodefony/debugbar`). Ton front n'importe donc pas une bibliothèque cliente
|
|
36
|
+
> « compagnon » qu'il faudrait tenir à jour en parallèle du back — il importe **le même paquet**, avec
|
|
37
|
+
> les mêmes types, le même protocole et les mêmes règles de rôles. Ancré sur `src/nodefony/src/client/`.
|
|
38
|
+
|
|
39
|
+
📍 [Documentation](../../../docs/index.md) › [Cœur — @nodefony/core](index.md) › **Client isomorphe**
|
|
40
|
+
|
|
41
|
+
## 🧠 Le modèle mental — un paquet, deux compilations
|
|
42
|
+
|
|
43
|
+
Une application temps réel a toujours deux moitiés qui doivent **se mettre d'accord** : le serveur qui
|
|
44
|
+
pousse, le navigateur qui reçoit. La méthode habituelle consiste à écrire deux fois le contrat — une
|
|
45
|
+
fois en TypeScript côté back, une fois en JavaScript côté front — puis à réparer les divergences.
|
|
46
|
+
|
|
47
|
+
Nodefony supprime la deuxième écriture. Le même dépôt de code produit **deux sorties** depuis les
|
|
48
|
+
mêmes sources : un bundle Node et un bundle navigateur. Le champ `exports` du paquet aiguille selon
|
|
49
|
+
qui demande.
|
|
50
|
+
|
|
51
|
+
```mermaid
|
|
52
|
+
flowchart TD
|
|
53
|
+
SRC["src/nodefony/src/<br/>sources TypeScript UNIQUES"]
|
|
54
|
+
SRC --> NB["bundle Node<br/>dist/node/"]
|
|
55
|
+
SRC --> CB["bundle navigateur<br/>dist/client/"]
|
|
56
|
+
NB --> SERV["Serveur<br/>Kernel · Module · Controller"]
|
|
57
|
+
CB --> C1["nodefony/client<br/>RealtimeClient · notices · cadence"]
|
|
58
|
+
CB --> C2["nodefony/react<br/>hooks useNodefony*"]
|
|
59
|
+
CB --> C3["nodefony/roles<br/>RBAC d'affichage"]
|
|
60
|
+
CB --> C4["nodefony/debugbar<br/>barre de debug dev"]
|
|
61
|
+
C1 -->|"WebSocket · JSON-RPC 2.0"| SERV
|
|
62
|
+
SHARED["code PARTAGÉ des deux côtés<br/>JsonRpcPeer · IRealtimeSocket · Pdu · Service"]
|
|
63
|
+
SHARED -.-> NB
|
|
64
|
+
SHARED -.-> CB
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Trois idées portent toute la page :
|
|
68
|
+
|
|
69
|
+
1. **Le contrat n'est pas dupliqué, il est partagé.** Le moteur de protocole `JsonRpcPeer` est le
|
|
70
|
+
**même objet** des deux côtés : le navigateur l'exécute dans son client, le serveur en instancie un
|
|
71
|
+
par connexion.
|
|
72
|
+
2. **Le navigateur n'a droit qu'à ce qui a du sens pour lui.** Le barrel client ne réexporte pas le
|
|
73
|
+
Kernel, ni les serveurs, ni la validation de schéma — on n'expédie pas 400 Kio de back au client.
|
|
74
|
+
3. **Ce que le client sait faire, le serveur n'a pas à le faire.** La reconnexion, la mémoire des
|
|
75
|
+
abonnements et la **négociation de cadence** vivent côté navigateur : le serveur reste bête et
|
|
76
|
+
sans état par connexion.
|
|
77
|
+
|
|
78
|
+
## 📖 Lexique
|
|
79
|
+
|
|
80
|
+
| Terme | Sens |
|
|
81
|
+
| ---------------------- | ---------------------------------------------------------------------------------------------------------- |
|
|
82
|
+
| **Isomorphe** | Un même code source qui s'exécute **des deux côtés** (serveur et navigateur), sans réécriture. |
|
|
83
|
+
| **Subpath** | Point d'entrée secondaire d'un paquet npm (`nodefony/client`), déclaré dans le champ `exports`. |
|
|
84
|
+
| **Condition d'export** | Clé du champ `exports` (`browser`, `import`, `types`) qui choisit **quel fichier** un outil résout. |
|
|
85
|
+
| **Barrel** | Fichier `index.ts` qui réexporte la surface publique d'un dossier. C'est lui qui décide ce qui est public. |
|
|
86
|
+
| **JSON-RPC 2.0** | Protocole d'appel de méthode par messages ; Nodefony l'emploie sur WebSocket dans les deux sens. |
|
|
87
|
+
| **Canal** | Sujet logique multiplexé sur l'unique connexion (`orders:new`). On s'y **abonne**, on y **publie**. |
|
|
88
|
+
| **Notification** | Message JSON-RPC **sans identifiant** — aucune réponse attendue. C'est la forme du pub/sub. |
|
|
89
|
+
| **Ref-comptage** | Compter les consommateurs d'un abonnement pour n'émettre le trafic qu'aux transitions 0↔1. |
|
|
90
|
+
| **Welcome** | Première trame poussée par le serveur à l'ouverture : identité résolue + capacités annoncées. |
|
|
91
|
+
| **Notice** | Message normalisé prêt à afficher (`level`, `title`, `message`) — le format unique des alertes du client. |
|
|
92
|
+
| **Close code** | Code numérique de fermeture d'une WebSocket (RFC 6455 §7.4) : il dit **pourquoi** ça s'est fermé. |
|
|
93
|
+
| **AIMD** | _Additive Increase / Multiplicative Decrease_ — la loi de contrôle de congestion de TCP, reprise ici. |
|
|
94
|
+
| **Famine** | Les trames arrivent nettement plus lentement que la cadence demandée : le producteur est sous pression. |
|
|
95
|
+
| **Latest-wins** | Canal d'**état** où seule la dernière valeur compte — on peut décimer sans rien perdre. |
|
|
96
|
+
| **RBAC** | _Role-Based Access Control_ — décider d'un droit à partir de rôles (`ROLE_ADMIN`). |
|
|
97
|
+
| **Shim** | Petit remplacement d'une API absente du navigateur (`node:events`, `node:util`) pour que le code compile. |
|
|
98
|
+
| **Tree-shaking** | Élimination du code non importé au build : un subpath qu'on n'importe pas pèse **zéro octet**. |
|
|
99
|
+
| **HMR** | _Hot Module Replacement_ — remplacement d'un module à chaud pendant le développement, sans recharger. |
|
|
100
|
+
|
|
101
|
+
## Qu'est-ce qu'un client isomorphe — et ce que ça change concrètement
|
|
102
|
+
|
|
103
|
+
Un « client » de framework, d'habitude, c'est un second paquet npm (`mon-framework-client`) publié à
|
|
104
|
+
côté du serveur. Il embarque sa propre copie du protocole, sa propre définition des types échangés, et
|
|
105
|
+
son propre calendrier de versions. Tant que les deux avancent ensemble, tout va bien. Le jour où le
|
|
106
|
+
serveur renomme un champ, la divergence ne se voit **qu'à l'exécution**, chez l'utilisateur.
|
|
107
|
+
|
|
108
|
+
Un client isomorphe supprime la question : il n'y a **qu'un** paquet, donc **qu'une** version. Trois
|
|
109
|
+
conséquences pratiques, dans l'ordre où on les rencontre.
|
|
110
|
+
|
|
111
|
+
- **Les types sont les mêmes objets, pas des copies.** Le contrat de socket `IRealtimeSocket` décrit
|
|
112
|
+
la prise côté navigateur **et** côté serveur. Une méthode qui change de signature casse la
|
|
113
|
+
compilation des deux côtés, au build, pas en production.
|
|
114
|
+
- **Les règles de rôles s'évaluent à l'identique.** `hasAnyRole()` (`client/roles/roles.ts:34`) est
|
|
115
|
+
la fonction que le front appelle pour griser un bouton et que le back peut appeler dans un jury
|
|
116
|
+
d'autorisation. Plus de « le front croyait que `ROLE_ADMIN` suffisait ».
|
|
117
|
+
- **Les erreurs se traduisent une seule fois.** Le serveur ferme la connexion avec un code RFC 6455 ;
|
|
118
|
+
le client traduit ce code en message lisible via `closeCodeToNotice()` (`client/realtime/notice.ts:67`).
|
|
119
|
+
La table de correspondance vit à un seul endroit.
|
|
120
|
+
|
|
121
|
+
> [!IMPORTANT]
|
|
122
|
+
> Isomorphe ne veut pas dire « identique ». Le navigateur n'a ni kernel, ni serveurs, ni accès à la
|
|
123
|
+
> base. Le barrel client publie une **sélection** — `RealtimeClient`, `Syslog`, `Pdu`, `Service`,
|
|
124
|
+
> `Container` (`client/index.ts:76`) : les briques qui ont un sens dans un onglet. Le reste n'est
|
|
125
|
+
> simplement pas là, et n'alourdit donc pas ton bundle.
|
|
126
|
+
|
|
127
|
+
## La vision Nodefony
|
|
128
|
+
|
|
129
|
+
Le champ `exports` du paquet est le pivot de tout le dispositif. Il déclare **quatre** points d'entrée
|
|
130
|
+
navigateur, plus une condition `browser` sur l'entrée principale.
|
|
131
|
+
|
|
132
|
+
| Ce que tu importes | Ce que tu obtiens | Quand l'utiliser |
|
|
133
|
+
| --------------------- | ------------------------------------------------------------------------ | --------------------------------------------------- |
|
|
134
|
+
| `nodefony/client` | Le client temps réel, les notices, la cadence adaptative, `Syslog`/`Pdu` | Toujours — c'est le point d'entrée de référence |
|
|
135
|
+
| `nodefony/react` | Les hooks `useNodefony*` (peer optionnelle `react`) | App React qui consomme des canaux |
|
|
136
|
+
| `nodefony/roles` | `hasRole` & co, `RoleSet`, `RoleRegistry` | Afficher/masquer selon les rôles |
|
|
137
|
+
| `nodefony/debugbar` | La barre de debug de développement + son modèle pur | Dev, ou réutiliser le calcul de cascade |
|
|
138
|
+
| `nodefony` (au front) | La **même chose** que `nodefony/client`, via la condition `browser` | Code partagé front/back ; sinon préfère l'explicite |
|
|
139
|
+
|
|
140
|
+
Ces quatre entrées sont produites par une compilation dédiée — `clientConfig`
|
|
141
|
+
(`rolldown.config.ts:100`) déclare exactement ces quatre fichiers d'entrée, en conservant la structure
|
|
142
|
+
des modules pour que le client temps réel ne soit émis **qu'une fois** même s'il est tiré par deux
|
|
143
|
+
subpaths.
|
|
144
|
+
|
|
145
|
+
Deux choix méritent d'être explicités, parce qu'ils se voient dans ton bundle.
|
|
146
|
+
|
|
147
|
+
- **Les subpaths ne sont jamais réexportés depuis le barrel principal.** Importer `nodefony/client`
|
|
148
|
+
ne tire ni React, ni la barre de debug. C'est ce qui permet à la barre de peser **zéro octet** en
|
|
149
|
+
production : personne ne l'importe.
|
|
150
|
+
- **React est une dépendance externe, jamais empaquetée.** `clientExternal` (`rolldown.config.ts:94`)
|
|
151
|
+
marque `react`/`react-dom` comme externes : c'est **ton** React qui sera utilisé, donc pas de double
|
|
152
|
+
instance et pas de règle des hooks violée.
|
|
153
|
+
|
|
154
|
+
Le compromis assumé : côté navigateur, quelques API Node manquent. Nodefony ne charge pas de
|
|
155
|
+
polyfill lourd — il substitue au build deux **shims** minimaux, `browserShim`
|
|
156
|
+
(`rolldown.config.ts:80`), qui redirigent `node:events` et `node:util` vers des implémentations
|
|
157
|
+
navigateur de quelques dizaines de lignes.
|
|
158
|
+
|
|
159
|
+
## 🚀 Démarrage rapide
|
|
160
|
+
|
|
161
|
+
Le scénario : une application générée par `nodefony create app` avec un front servi par
|
|
162
|
+
`@nodefony/frontend`. On veut une socket ouverte, un canal écouté, et un appel d'API par cette même
|
|
163
|
+
socket.
|
|
164
|
+
|
|
165
|
+
### 1. La socket de l'application
|
|
166
|
+
|
|
167
|
+
Le client est une classe : on l'instancie, on la connecte.
|
|
168
|
+
|
|
169
|
+
```typescript
|
|
170
|
+
import { RealtimeClient } from "nodefony/client";
|
|
171
|
+
|
|
172
|
+
const socket = new RealtimeClient({ url: "/api/live/realtime" });
|
|
173
|
+
await socket.connect();
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
C'est ce que fait `shared()` — **plus une garantie** : une application veut **une seule** connexion
|
|
177
|
+
WebSocket pour toute la page, et `new` en ouvre une par appel. `RealtimeClient.shared({ url })` rend
|
|
178
|
+
donc la **même instance** pour la même URL, depuis n'importe quel fichier, sans passer la socket de
|
|
179
|
+
main en main.
|
|
180
|
+
|
|
181
|
+
> **Retenir** : `new` pour comprendre l'objet, `shared()` partout dans une application.
|
|
182
|
+
|
|
183
|
+
Un seul fichier, monté une fois au démarrage du front.
|
|
184
|
+
|
|
185
|
+
```typescript
|
|
186
|
+
// frontend/src/realtime.ts — la socket de l'app, importée partout ailleurs.
|
|
187
|
+
import { RealtimeClient } from "nodefony/client";
|
|
188
|
+
import type { NodefonyNotice } from "nodefony/client";
|
|
189
|
+
|
|
190
|
+
// Instance PARTAGÉE par URL : deux appels = la même socket, pas deux connexions.
|
|
191
|
+
// L'URL relative est normalisée (https → wss) avant l'ouverture.
|
|
192
|
+
export const socket = RealtimeClient.shared({
|
|
193
|
+
url: "/api/live/realtime",
|
|
194
|
+
});
|
|
195
|
+
|
|
196
|
+
// Les criticités du temps réel arrivent déjà traduites et prêtes à afficher.
|
|
197
|
+
socket.onNotice((notice: NodefonyNotice) => {
|
|
198
|
+
console.warn(`[${notice.level}] ${notice.message}`);
|
|
199
|
+
});
|
|
200
|
+
|
|
201
|
+
// `on` REÇOIT les messages ; `subscribe` DEMANDE au serveur de les pousser.
|
|
202
|
+
// Les deux sont nécessaires — et `subscribe` est ré-émis seul au reconnect.
|
|
203
|
+
socket.on("orders:new", (payload) => {
|
|
204
|
+
console.log("nouvelle commande", payload);
|
|
205
|
+
});
|
|
206
|
+
socket.subscribe("orders:new");
|
|
207
|
+
|
|
208
|
+
// L'identité vient du serveur (trame « welcome ») : aucune route /auth/me.
|
|
209
|
+
socket.onIdentity((identity) => {
|
|
210
|
+
if (!identity?.authenticated) console.log("visiteur anonyme");
|
|
211
|
+
});
|
|
212
|
+
|
|
213
|
+
await socket.connect();
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
### 2. Appeler l'API par la socket, pas par `fetch`
|
|
217
|
+
|
|
218
|
+
La même action de contrôleur répond en HTTP **et** en WebSocket. Un chemin qui commence par `/` est
|
|
219
|
+
routé vers le pont d'API ; les mutations exigent une clé d'idempotence, parce qu'une socket qui
|
|
220
|
+
reconnecte peut rejouer une trame en vol.
|
|
221
|
+
|
|
222
|
+
```typescript
|
|
223
|
+
// frontend/src/orders.ts
|
|
224
|
+
import { RealtimeClient } from "nodefony/client";
|
|
225
|
+
|
|
226
|
+
// MÊME URL ⇒ MÊME instance que dans `realtime.ts` : `shared()` se relit de
|
|
227
|
+
// n'importe quel fichier, sans passer la socket de main en main.
|
|
228
|
+
const socket = RealtimeClient.shared({ url: "/api/live/realtime" });
|
|
229
|
+
|
|
230
|
+
// Lecture — équivalent strict du GET REST sur la même route.
|
|
231
|
+
export async function loadModules(): Promise<{ name: string }[]> {
|
|
232
|
+
return socket.request<{ name: string }[]>("/nodefony/kernel/api/modules");
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
// Écriture — la clé d'idempotence dédoublonne un éventuel rejeu.
|
|
236
|
+
export async function ship(orderId: string): Promise<void> {
|
|
237
|
+
await socket.mutate(`/shop/api/orders/${orderId}/ship`, {
|
|
238
|
+
method: "POST",
|
|
239
|
+
idempotencyKey: crypto.randomUUID(),
|
|
240
|
+
});
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
// Mesure du temps d'aller-retour — la convention `nodefony:kernel:ping` vit dans la lib.
|
|
244
|
+
export async function latency(): Promise<number> {
|
|
245
|
+
const { rtt } = await socket.ping();
|
|
246
|
+
return rtt;
|
|
247
|
+
}
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
### 3. Adapter l'affichage aux rôles
|
|
251
|
+
|
|
252
|
+
```typescript
|
|
253
|
+
// frontend/src/nav.ts — filtrer une navigation. ERGONOMIE, pas sécurité.
|
|
254
|
+
import { hasAnyRole, RoleSet } from "nodefony/roles";
|
|
255
|
+
|
|
256
|
+
export function visibleTabs(roles: readonly string[]): string[] {
|
|
257
|
+
const tabs = ["Commandes"];
|
|
258
|
+
// Contrôle ponctuel : zéro allocation, parcours linéaire.
|
|
259
|
+
if (hasAnyRole(roles, ["ROLE_ADMIN", "ROLE_BILLING"]))
|
|
260
|
+
tabs.push("Facturation");
|
|
261
|
+
// Contrôles RÉPÉTÉS sur le même utilisateur : une allocation, puis O(1).
|
|
262
|
+
const set = new RoleSet(roles);
|
|
263
|
+
if (set.has("ROLE_ADMIN")) tabs.push("Administration");
|
|
264
|
+
return tabs;
|
|
265
|
+
}
|
|
266
|
+
```
|
|
267
|
+
|
|
268
|
+
### Ce qu'on observe
|
|
269
|
+
|
|
270
|
+
```bash
|
|
271
|
+
npx nodefony development
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
Dans la console du navigateur, à l'ouverture de la page :
|
|
275
|
+
|
|
276
|
+
```text
|
|
277
|
+
visiteur anonyme # la trame welcome est arrivée, non authentifié
|
|
278
|
+
nouvelle commande { id: 'CMD-42' } # le canal orders:new pousse
|
|
279
|
+
[warning] Connexion temps réel perdue # le réseau a sauté (close code 1006)
|
|
280
|
+
[success] Connexion temps réel rétablie
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
La dernière ligne mérite une remarque : elle n'est émise qu'après une **vraie** perte, jamais à la
|
|
284
|
+
première connexion. Le client distingue « je me connecte » de « je me reconnecte » — sinon toute page
|
|
285
|
+
afficherait un message de rétablissement au chargement.
|
|
286
|
+
|
|
287
|
+
> [!TIP]
|
|
288
|
+
> En React, ne câble rien à la main : les hooks du subpath `nodefony/react` font l'abonnement, le
|
|
289
|
+
> désabonnement et le re-rendu pour toi. Voir [Hooks React](react-hooks.md).
|
|
290
|
+
|
|
291
|
+
## 🔌 `RealtimeClient` — la socket vue du navigateur
|
|
292
|
+
|
|
293
|
+
C'est la brique centrale du subpath. `RealtimeClient` (`client/realtime/RealtimeClient.ts:161`)
|
|
294
|
+
implémente le contrat de socket isomorphe **et** le contrat de pair JSON-RPC : il sait donc à la fois
|
|
295
|
+
recevoir des messages poussés et **répondre** à des requêtes venues du serveur.
|
|
296
|
+
|
|
297
|
+
### Ouvrir, perdre, retrouver la connexion
|
|
298
|
+
|
|
299
|
+
```mermaid
|
|
300
|
+
stateDiagram-v2
|
|
301
|
+
[*] --> disconnected
|
|
302
|
+
disconnected --> connecting: connect()
|
|
303
|
+
connecting --> connected: transport ouvert + welcome
|
|
304
|
+
connected --> reconnecting: fermeture TRANSITOIRE (1006, 1011…)
|
|
305
|
+
reconnecting --> connected: nouvelle tentative réussie
|
|
306
|
+
connected --> error: fermeture DÉFINITIVE (1008, 1002…)
|
|
307
|
+
connected --> disconnected: disconnect()
|
|
308
|
+
error --> connecting: retryNow() après action corrective
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
La subtilité utile est la distinction entre fermeture **transitoire** et **définitive**.
|
|
312
|
+
`isReconnectableCloseCode()` (`client/realtime/notice.ts:156`) lit le code de fermeture : une perte
|
|
313
|
+
réseau (1006) ou un redémarrage serveur (1011) relancent la boucle de reconnexion ; un refus de
|
|
314
|
+
politique (1008, c'est-à-dire un 401/403 traduit) ne la relance **pas**. Sans cette règle, un visiteur
|
|
315
|
+
anonyme martèlerait indéfiniment un point d'entrée protégé.
|
|
316
|
+
|
|
317
|
+
Le délai entre tentatives double à chaque échec — `scheduleReconnect()`
|
|
318
|
+
(`client/realtime/RealtimeClient.ts:1251`) — plafonné à 30 secondes par défaut. La date de la
|
|
319
|
+
prochaine tentative est exposée en lecture, ce qui permet d'afficher un compte à rebours exact plutôt
|
|
320
|
+
qu'un sablier qui ment.
|
|
321
|
+
|
|
322
|
+
### Les canaux — ref-comptés, et remémorés
|
|
323
|
+
|
|
324
|
+
C'est le mécanisme qui évite la classe de bugs la plus pénible d'une application temps réel : deux
|
|
325
|
+
composants écoutent le même canal, l'un se démonte, et **coupe le flux de l'autre**.
|
|
326
|
+
|
|
327
|
+
`RealtimeClient.subscribe()` (`client/realtime/RealtimeClient.ts:530`) compte les consommateurs et
|
|
328
|
+
n'envoie la demande au serveur qu'au **premier**. `RealtimeClient.unsubscribe()`
|
|
329
|
+
(`client/realtime/RealtimeClient.ts:543`) ne coupe qu'au **dernier**. Entre les deux, le trafic réseau
|
|
330
|
+
est nul.
|
|
331
|
+
|
|
332
|
+
Second effet, tout aussi important : la liste des abonnements est **rejouée à chaque reconnexion**.
|
|
333
|
+
Le serveur repart d'un état vide après une coupure ; c'est le client qui se souvient de ce qu'il
|
|
334
|
+
écoutait, dans la routine d'ouverture de socket (`client/realtime/RealtimeClient.ts:1007`).
|
|
335
|
+
|
|
336
|
+
> [!WARNING]
|
|
337
|
+
> `on(canal, handler)` et `subscribe(canal)` ne font **pas** la même chose et ne se remplacent pas.
|
|
338
|
+
> Le premier installe un écouteur local ; le second demande au serveur de pousser. Écouter sans
|
|
339
|
+
> s'abonner donne un canal silencieux ; s'abonner sans écouter fait transiter des trames que personne
|
|
340
|
+
> ne lit.
|
|
341
|
+
|
|
342
|
+
### Les quatre façons de parler au serveur
|
|
343
|
+
|
|
344
|
+
| Appel | Ancre | Ce que ça fait |
|
|
345
|
+
| ------------------------------------- | --------------------------------------- | ---------------------------------------------------------------- |
|
|
346
|
+
| `RealtimeClient.emit()` / `publish()` | `client/realtime/RealtimeClient.ts:512` | Notification sans réponse — la forme du pub/sub |
|
|
347
|
+
| `RealtimeClient.request()` | `client/realtime/RealtimeClient.ts:727` | Requête/réponse ; un argument commençant par `/` cible une route |
|
|
348
|
+
| `RealtimeClient.mutate()` | `client/realtime/RealtimeClient.ts:797` | Écriture par le pont d'API — **clé d'idempotence obligatoire** |
|
|
349
|
+
|
|
350
|
+
Deux compléments moins courants. `RealtimeClient.call()`
|
|
351
|
+
(`client/realtime/RealtimeClient.ts:839`) rend l'**enveloppe complète** — la valeur **et**
|
|
352
|
+
l'identifiant du profil serveur de cette trame, ce qui permet en développement d'aller lire la
|
|
353
|
+
radiographie de l'appel. Et `RealtimeClient.register()`
|
|
354
|
+
(`client/realtime/RealtimeClient.ts:907`) fait du navigateur un **appelé** : le serveur peut lui
|
|
355
|
+
adresser une requête et attendre son résultat. C'est le duplex réel, pas seulement du push.
|
|
356
|
+
|
|
357
|
+
### Identité et refus — l'interface sait sans demander
|
|
358
|
+
|
|
359
|
+
L'identité de la connexion n'est pas devinée par le front : le serveur l'annonce dans sa première
|
|
360
|
+
trame, et le client la retient. `RealtimeClient.identity`
|
|
361
|
+
(`client/realtime/RealtimeClient.ts:581`) vaut `null` tant que rien n'est reçu, puis porte un objet
|
|
362
|
+
dont `authenticated` vaut `false` pour un visiteur anonyme. Un écran de connexion se décide donc
|
|
363
|
+
**sans appeler aucune route**.
|
|
364
|
+
|
|
365
|
+
Le pendant côté refus : quand le serveur rejette un abonnement, il pousse un message dédié que le
|
|
366
|
+
client transforme en deux signaux — une notice générique pour le centre de notifications, et un
|
|
367
|
+
événement ciblé consommable par `RealtimeClient.onDenied()`
|
|
368
|
+
(`client/realtime/RealtimeClient.ts:469`) pour une réaction précise (griser le contrôle concerné). Le
|
|
369
|
+
motif reste volontairement générique : le serveur ne dit jamais **quel** rôle manquait, ce qui en
|
|
370
|
+
ferait un oracle.
|
|
371
|
+
|
|
372
|
+
### Le transport, et pourquoi il est aussi bête
|
|
373
|
+
|
|
374
|
+
`BrowserWsTransport` (`client/realtime/BrowserWsTransport.ts:12`) enveloppe la `WebSocket` native et
|
|
375
|
+
ne fait rien d'autre : ouvrir, envoyer, fermer, relayer quatre événements. Toute l'orchestration —
|
|
376
|
+
état, reconnexion, battement de cœur, statistiques — vit au-dessus.
|
|
377
|
+
|
|
378
|
+
Cette séparation a une conséquence directe et très utile : le client accepte une **fabrique de
|
|
379
|
+
transport** injectée en second argument de son constructeur
|
|
380
|
+
(`client/realtime/RealtimeClient.ts:223`). Les tests branchent un transport factice et exercent toute
|
|
381
|
+
la machine à états **sans ouvrir une seule socket**. C'est ce qui rend les 177 cas de test de cette
|
|
382
|
+
page possibles hors navigateur.
|
|
383
|
+
|
|
384
|
+
### Ce que le client alloue — et ce qu'il n'alloue pas
|
|
385
|
+
|
|
386
|
+
Un onglet ouvert huit heures ne pardonne pas les allocations gratuites. Les choix visibles au code :
|
|
387
|
+
|
|
388
|
+
- **Le journal de protocole est différé.** Chaque trame est poussée dans un anneau borné à 300
|
|
389
|
+
entrées sous forme de **référence brute** ; la mise en forme et le masquage des secrets ne sont
|
|
390
|
+
faits qu'à la **lecture** — `recordFrame()` (`client/realtime/RealtimeClient.ts:1308`). Un
|
|
391
|
+
inspecteur qu'on n'ouvre jamais ne coûte donc presque rien.
|
|
392
|
+
- **Les secrets ne transitent pas en clair dans l'inspecteur.** `redactFrame()`
|
|
393
|
+
(`client/realtime/RealtimeClient.ts:157`) remplace toute clé ressemblant à un jeton, un mot de
|
|
394
|
+
passe ou une autorisation, avec une profondeur bornée.
|
|
395
|
+
- **Ce qui n'a pas servi n'existe pas.** L'anneau de trames, l'identité et les capacités annoncées
|
|
396
|
+
démarrent à `null` et ne sont alloués qu'au premier usage.
|
|
397
|
+
- **L'échantillonnage de débit ne retient pas le processus.** Le minuteur de statistiques est
|
|
398
|
+
déréférencé (`client/realtime/RealtimeClient.ts:949`) — utile quand le même code tourne dans un
|
|
399
|
+
test Node.
|
|
400
|
+
|
|
401
|
+
## ⚡ Cadence adaptative — une capacité du CLIENT
|
|
402
|
+
|
|
403
|
+
Voici le point le plus contre-intuitif de la lib, et son meilleur argument : **c'est le navigateur
|
|
404
|
+
qui décide à quel rythme il veut être servi**, sans que le serveur n'apprenne quoi que ce soit.
|
|
405
|
+
|
|
406
|
+
Le principe repose sur une convention de nommage : la cadence vit **dans le nom du canal**
|
|
407
|
+
(`stats` à 1 s, `stats:2000` à 2 s…). Un canal = une cadence = un ticker serveur. Changer de cadence
|
|
408
|
+
revient donc à **changer de canal**, opération que le client sait faire tout seul.
|
|
409
|
+
|
|
410
|
+
`AdaptiveRate` (`client/realtime/AdaptiveRate.ts:78`) est la machine à états pure qui prend la
|
|
411
|
+
décision — aucun minuteur, aucune socket, donc parfaitement déterministe et testable. Elle applique la
|
|
412
|
+
loi AIMD de TCP :
|
|
413
|
+
|
|
414
|
+
| Situation observée | Décision | Rythme |
|
|
415
|
+
| ------------------------------------------------------ | ---------------------------------- | -------- |
|
|
416
|
+
| L'écart entre trames dépasse 1,8 × la cadence (famine) | on **grossit** d'un cran l'échelle | immédiat |
|
|
417
|
+
| L'écart reste sous 1,25 × la cadence, 4 fois de suite | on **affine** d'un cran | lent |
|
|
418
|
+
| Entre les deux (bande morte) | on ne change rien | — |
|
|
419
|
+
|
|
420
|
+
L'asymétrie est délibérée : on recule vite sous pression, on revient doucement. C'est exactement ce
|
|
421
|
+
qui empêche l'oscillation, et la bande morte empêche le va-et-vient autour du seuil.
|
|
422
|
+
|
|
423
|
+
Deux détecteurs se complètent. `AdaptiveRate.noteFrame()`
|
|
424
|
+
(`client/realtime/AdaptiveRate.ts:134`) mesure l'écart **à chaque trame reçue** ; mais si le flux
|
|
425
|
+
s'arrête complètement, il n'y a plus de trame pour déclencher quoi que ce soit — d'où le chien de
|
|
426
|
+
garde `AdaptiveRate.checkStarvation()` (`client/realtime/AdaptiveRate.ts:171`), appelé
|
|
427
|
+
périodiquement, qui voit la famine **totale**.
|
|
428
|
+
|
|
429
|
+
Le câblage à une socket réelle est séparé : `bindAdaptiveChannel()`
|
|
430
|
+
(`client/realtime/AdaptiveRate.ts:239`) s'abonne au nouveau canal **avant** de couper l'ancien, ce
|
|
431
|
+
qui évite le trou de quelques centaines de millisecondes qu'on obtiendrait dans l'ordre inverse.
|
|
432
|
+
|
|
433
|
+
```typescript ignore
|
|
434
|
+
// Un tableau de bord d'état : on VEUT 1 s, on ACCEPTE de reculer si ça souffre.
|
|
435
|
+
const binding = socket.adaptiveChannel(
|
|
436
|
+
"nodefony:dashboard",
|
|
437
|
+
(payload) => render(payload),
|
|
438
|
+
{
|
|
439
|
+
intervalMs: 1000,
|
|
440
|
+
onRate: (ms, reason) => setBadge(`${ms} ms (${reason})`),
|
|
441
|
+
},
|
|
442
|
+
);
|
|
443
|
+
// …plus tard
|
|
444
|
+
binding.dispose(); // coupe le chien de garde, l'écouteur ET l'abonnement
|
|
445
|
+
```
|
|
446
|
+
|
|
447
|
+
> [!CAUTION]
|
|
448
|
+
> Réservé aux canaux d'**état** (latest-wins : supervision, statistiques), où sauter une valeur
|
|
449
|
+
> intermédiaire est sans conséquence. Sur un canal d'**événements** (journal, messages de chat), chaque
|
|
450
|
+
> élément compte : décimer perdrait des données. Ces flux-là se **regroupent**, ils ne se décime pas.
|
|
451
|
+
> Le réglage `enabled: false` (`client/realtime/AdaptiveRate.ts:200`) bascule en abonnement fixe sans
|
|
452
|
+
> changer le code appelant.
|
|
453
|
+
|
|
454
|
+
## 🔐 Les rôles isomorphes — de l'ergonomie, jamais une garantie
|
|
455
|
+
|
|
456
|
+
Le subpath `nodefony/roles` fournit des fonctions **pures**, sans état ni dépendance, utilisables
|
|
457
|
+
telles quelles des deux côtés.
|
|
458
|
+
|
|
459
|
+
| Outil | Ancre | Coût | Quand l'employer |
|
|
460
|
+
| --------------- | ----------------------------- | ---------------------------------- | --------------------------------------------- |
|
|
461
|
+
| `hasRole()` | `client/roles/roles.ts:19` | zéro allocation, parcours linéaire | Un contrôle ponctuel |
|
|
462
|
+
| `hasAnyRole()` | `client/roles/roles.ts:34` | idem | « L'un de ces rôles suffit » |
|
|
463
|
+
| `hasAllRoles()` | `client/roles/roles.ts:51` | idem | « Tous ces rôles sont requis » |
|
|
464
|
+
| `RoleSet` | `client/roles/roles.ts:69` | 1 allocation, puis O(1) | Contrôles **répétés** sur le même utilisateur |
|
|
465
|
+
| `RoleRegistry` | `client/roles/registry.ts:27` | masques binaires, O(1) sans alloc | Ensemble **fixe** de rôles, chemin chaud |
|
|
466
|
+
|
|
467
|
+
Deux conventions à connaître, parce qu'elles surprennent au premier essai :
|
|
468
|
+
|
|
469
|
+
- `hasAnyRole()` avec une liste d'exigences **vide** rend `false` — aucune exigence ne peut être
|
|
470
|
+
satisfaite. `hasAllRoles()` avec une liste vide rend `true`, comme `Array.every`. Les deux sont
|
|
471
|
+
cohérentes avec la logique, pas entre elles.
|
|
472
|
+
- `RoleRegistry` est plafonné à 31 rôles — `ROLE_MASK_CAPACITY`
|
|
473
|
+
(`client/roles/registry.ts:11`) — parce que les opérateurs binaires de JavaScript travaillent sur
|
|
474
|
+
des entiers 32 bits **signés**. Au-delà, on reste sur les chaînes. Il est aussi inadapté aux rôles
|
|
475
|
+
**créés dynamiquement** en base : ils n'ont pas de bit fixe.
|
|
476
|
+
|
|
477
|
+
> [!IMPORTANT]
|
|
478
|
+
> Ces contrôles sont de l'**ergonomie**, jamais une sécurité. Le navigateur exécute du code que
|
|
479
|
+
> l'utilisateur contrôle : masquer un bouton n'empêche personne d'appeler la route. L'**autorité reste
|
|
480
|
+
> le serveur** — le pare-feu applicatif et les jurys d'autorisation décident, et refusent, quoi qu'ait
|
|
481
|
+
> affiché le front. Le bon usage : ne pas montrer une action qui sera de toute façon refusée. Voir
|
|
482
|
+
> [la sécurité du temps réel](../../../src/packages/@nodefony/realtime/docs/securite.md).
|
|
483
|
+
|
|
484
|
+
## 🧩 La barre de debug, le stockage et les shims
|
|
485
|
+
|
|
486
|
+
Trois briques secondaires, qu'on touche rarement — mais qu'il vaut mieux connaître avant de les
|
|
487
|
+
croiser.
|
|
488
|
+
|
|
489
|
+
### `nodefony/debugbar` — voir le framework respirer
|
|
490
|
+
|
|
491
|
+
Une barre de développement type « bandeau de profilage », montée par `mountDebugBar()`
|
|
492
|
+
(`client/debugbar/index.ts:46`). Elle ouvre **la même** socket temps réel que le reste de la page,
|
|
493
|
+
intercepte les appels réseau et affiche la cascade des phases serveur d'une requête. Rendue en Shadow
|
|
494
|
+
DOM, sans aucune dépendance d'interface.
|
|
495
|
+
|
|
496
|
+
En pratique tu ne l'appelles pas : en développement, `@nodefony/frontend` l'injecte lui-même dans la
|
|
497
|
+
page, en la résolvant depuis le paquet installé (`ViteConfigGenerator.ts:135`). Tu l'appelles à la
|
|
498
|
+
main uniquement sur une page **hors Vite**, où le bundle autonome fait office d'alternative.
|
|
499
|
+
|
|
500
|
+
Le subpath expose aussi son **modèle pur** — `computeWaterfall()`
|
|
501
|
+
(`client/debugbar/profile.ts:168`) et `NetworkModel` (`client/debugbar/profile.ts:91`) — sans une
|
|
502
|
+
ligne de DOM. C'est ce qui permet à Studio d'afficher la même cascade dans son écran de profilage
|
|
503
|
+
sans recopier le calcul.
|
|
504
|
+
|
|
505
|
+
### Les shims — pourquoi ton code Node compile dans un onglet
|
|
506
|
+
|
|
507
|
+
Deux modules Node sont remplacés au build par des équivalents navigateur de quelques dizaines de
|
|
508
|
+
lignes : `EventEmitter` (`client/shim/events.ts:15`) couvre exactement l'API que le bus d'événements
|
|
509
|
+
du cœur appelle réellement, et `inspect` (`client/shim/util.ts:5`) rend un affichage lisible via
|
|
510
|
+
`JSON.stringify`. La façade de couleur, elle, devient l'identité (`client/shim/util.ts:20`) : il n'y a
|
|
511
|
+
pas de terminal dans un navigateur, donc jamais de code d'échappement.
|
|
512
|
+
|
|
513
|
+
Tu ne les importes jamais — ils sont substitués au moment du build. Leur seul intérêt pour toi est de
|
|
514
|
+
savoir **où sont les limites** : ce sont des shims, pas des implémentations complètes. Le shim
|
|
515
|
+
d'événements ne distingue pas un écouteur « une fois » d'un écouteur ordinaire, et ne gère pas
|
|
516
|
+
l'événement `error` spécial de Node.
|
|
517
|
+
|
|
518
|
+
### Le kernel client — un contrat qui n'est pas encore publié
|
|
519
|
+
|
|
520
|
+
`IClientKernel` (`client/IClientKernel.ts:172`) décrit le futur chef d'orchestre de la couche
|
|
521
|
+
technique d'une application front : composition de services, cycle de vie navigateur, changement
|
|
522
|
+
d'identité. Le registre de services `NodefonyClientServices` (`client/IClientKernel.ts:100`) s'étend
|
|
523
|
+
par augmentation de module, comme le registre de configuration côté serveur.
|
|
524
|
+
|
|
525
|
+
**Tu ne peux pas encore l'importer**, et c'est délibéré : il a d'abord été publié en types seulement,
|
|
526
|
+
puis retiré de la surface avant que la 10.0.0 ne le gèle. Personne ne l'implémentait, donc le
|
|
527
|
+
compilateur ne l'avait jamais vérifié — et il portait deux défauts que la première implémentation
|
|
528
|
+
aurait révélés. Une fois publié, les corriger aurait demandé une version majeure ; l'ajouter une
|
|
529
|
+
fois qu'une application réelle l'exerce ne demandera qu'une mineure. La spécification, elle, vaut
|
|
530
|
+
toujours : elle est dans le dépôt, et l'ADR-0007 en donne les onze décisions.
|
|
531
|
+
|
|
532
|
+
## 🏗️ Comment la lib arrive dans ton bundle
|
|
533
|
+
|
|
534
|
+
Rien de spécial à configurer : `@nodefony/frontend` pilote Vite, et Vite résout `nodefony/client`
|
|
535
|
+
comme n'importe quel paquet du dossier `node_modules`. Trois points valent d'être connus.
|
|
536
|
+
|
|
537
|
+
1. **La condition `browser` fait le tri.** Dans un bundle navigateur, `import … from "nodefony"`
|
|
538
|
+
résout le barrel client ; dans un fichier serveur, le barrel Node. Le même import, deux
|
|
539
|
+
destinations — c'est le mécanisme central, et aussi la source du piège numéro un de cette page.
|
|
540
|
+
2. **La barre de debug est autorisée explicitement.** Vite refuse par défaut de servir un fichier hors
|
|
541
|
+
de la racine du projet. Le générateur de configuration ajoute le dossier de la lib cliente à la
|
|
542
|
+
liste autorisée (`ViteConfigGenerator.ts:135`), sans quoi une application liée en développement
|
|
543
|
+
verrait la barre répondre en refus d'accès.
|
|
544
|
+
3. **En production, seul ce que tu importes part.** Les quatre subpaths sont des entrées séparées :
|
|
545
|
+
ce que tu n'importes pas n'est pas dans le bundle.
|
|
546
|
+
|
|
547
|
+
Le détail du builder, du rechargement à chaud et du rendu de la page côté serveur est dans
|
|
548
|
+
[la doc de `@nodefony/frontend`](../../../src/packages/@nodefony/frontend/docs/index.md).
|
|
549
|
+
|
|
550
|
+
## ⚠️ Pièges (symptôme → cause → correction)
|
|
551
|
+
|
|
552
|
+
| Symptôme | Cause (dans le code) | Correction |
|
|
553
|
+
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
|
|
554
|
+
| `Cannot find module 'nodefony/realtime'` | Ce subpath **n'existe pas** — le champ `exports` n'en déclare que quatre | Importer depuis `nodefony/client` |
|
|
555
|
+
| `has no exported member 'RealtimeClient'` dans un fichier front | Import depuis `"nodefony"` typé par la condition **Node** (outil sans condition `browser`) | Importer explicitement depuis `nodefony/client` |
|
|
556
|
+
| `RealtimeIdentity` introuvable à l'import | Version antérieure : le type n'était réexporté ni par `nodefony/client` ni par `nodefony/react` | Corrigé — `import type { RealtimeIdentity } from "nodefony/client"` (ou `nodefony/react`) |
|
|
557
|
+
| Le canal est silencieux, aucun message | `on()` installé sans `subscribe()` — le serveur ne pousse pas | Appeler les deux (`client/realtime/RealtimeClient.ts:485`) |
|
|
558
|
+
| Un composant démonté coupe le flux d'un autre | Attendu et **déjà traité** : les abonnements sont ref-comptés | Ne pas contourner l'API en émettant `unsubscribe` à la main |
|
|
559
|
+
| Après une reconnexion, plus rien n'arrive | Le serveur repart d'un état vide ; le client ré-émet ses abonnements | Comportement natif ; vérifier que l'abonnement passe bien par `subscribe()` |
|
|
560
|
+
| La reconnexion ne repart jamais | Fermeture **définitive** (1008 = 401/403 traduit), reconnexion volontairement coupée | Corriger la cause (se connecter) puis `retryNow()` (`client/realtime/RealtimeClient.ts:370`) |
|
|
561
|
+
| Deux connexions WebSocket pour la même page | Deux `new RealtimeClient(…)` au lieu de l'instance partagée | `RealtimeClient.shared()` (`client/realtime/RealtimeClient.ts:295`) |
|
|
562
|
+
| Les trames envoyées juste après la connexion sont perdues | `send()` abandonne la trame tant que le transport n'est pas ouvert (`client/realtime/RealtimeClient.ts:188`) | Émettre après la résolution de `connect()` |
|
|
563
|
+
| La cadence adaptative « perd » des messages | Employée sur un canal d'**événements**, où décimer supprime des éléments | La réserver aux canaux d'état, ou passer `enabled: false` |
|
|
564
|
+
| `hasAnyRole(roles, [])` rend `false` et surprend | Aucune exigence ne peut être satisfaite (`client/roles/roles.ts:34`) | Convention assumée ; `hasAllRoles` avec une liste vide rend `true` |
|
|
565
|
+
| `RoleRegistry` lève au 32ᵉ rôle | Limite des entiers 32 bits signés (`client/roles/registry.ts:11`) | Rester sur les chaînes / `RoleSet` au-delà de 31 rôles |
|
|
566
|
+
| Un bouton masqué au front reste appelable | Le RBAC client est de l'ergonomie, pas un contrôle | Protéger la route côté serveur — c'est lui l'autorité |
|
|
567
|
+
| Deux instances de React après ajout de `nodefony/react` | React empaqueté au lieu d'être externe | Déjà traité au build (`rolldown.config.ts:94`) ; vérifier ses propres alias |
|
|
568
|
+
|
|
569
|
+
## 🧪 Tests & couverture
|
|
570
|
+
|
|
571
|
+
Le client isomorphe est couvert par **177 cas** répartis sur **15 fichiers**, tous unitaires et tous
|
|
572
|
+
exécutés **hors navigateur** — c'est l'injection de transport qui le permet.
|
|
573
|
+
|
|
574
|
+
- **La machine à états et le transport** : ouverture, reconnexion à délai croissant, battement de
|
|
575
|
+
cœur, transport factice, distinction transitoire/définitif
|
|
576
|
+
(`RealtimeClientTransport.test.ts`, `RealtimeClientCoverage.test.ts`).
|
|
577
|
+
- **Le routage des trames** : classification requête/notification/réponse, dispatch vers les
|
|
578
|
+
écouteurs, joker, ingestion de la trame de bienvenue (`RealtimeClientDispatch.test.ts`,
|
|
579
|
+
`RealtimeClientIdentity.test.ts`).
|
|
580
|
+
- **Le protocole lui-même** : corrélation d'identifiants, délais, erreurs, flux en morceaux, actions
|
|
581
|
+
entrantes (`JsonRpcPeer.test.ts` — 30 cas, le plus fourni).
|
|
582
|
+
- **Les types comme test** : deux fichiers vérifient des propriétés de typage, dont la limite connue
|
|
583
|
+
de la surcharge historique de `request` (`RealtimeClient.types.test.ts`,
|
|
584
|
+
`JsonRpcPeer.types.test.ts`).
|
|
585
|
+
- **Les notices et les codes de fermeture** : la table RFC 6455 cas par cas, le silence sur les
|
|
586
|
+
fermetures propres, la reconnectabilité (`RealtimeNotice.test.ts` — 19 cas).
|
|
587
|
+
- **La cadence adaptative** : décrue immédiate, reprise après fenêtre, bande morte, chien de garde,
|
|
588
|
+
échelle dérivée — avec horloge et planificateur injectés (`AdaptiveRate.test.ts` — 17 cas).
|
|
589
|
+
- **Les rôles** (`roles.test.ts`), **le shim d'événements** (`clientShimEvents.test.ts`), **la barre
|
|
590
|
+
de debug** et **son modèle de profilage** (`DebugBar.test.ts`, `Profiler.client.test.ts`).
|
|
591
|
+
|
|
592
|
+
Ce qui **manque**, et qu'il faut savoir :
|
|
593
|
+
|
|
594
|
+
- **Aucun test de bout en bout dans un vrai navigateur.** Tout est exercé en Node avec un transport
|
|
595
|
+
factice. Les comportements réellement navigateur — normalisation d'URL par `window.location`,
|
|
596
|
+
`sessionStorage`, montage en Shadow DOM — ne sont donc pas couverts par une exécution réelle.
|
|
597
|
+
- **Aucun banc de charge ni de mémoire côté client.** Les choix d'allocation décrits plus haut sont
|
|
598
|
+
lisibles au code mais ne sont pas mesurés par une suite : pas d'équivalent client au gate mémoire du
|
|
599
|
+
pipeline serveur (skill `nodefony-check-memory-health`).
|
|
600
|
+
- **Aucun test d'attaque** (`*.attack.test.ts`) sur le masquage de l'inspecteur de trames — un
|
|
601
|
+
candidat naturel pour une campagne `nodefony-security-review`.
|
|
602
|
+
|
|
603
|
+
Couverture : `npm run coverage` dans `src/nodefony`. Les chiffres exacts vivent dans le rapport
|
|
604
|
+
vitest, jamais figés ici.
|
|
605
|
+
|
|
606
|
+
## 🔗 Pour aller plus loin
|
|
607
|
+
|
|
608
|
+
- ⬆️ **Retour au hub** : [@nodefony/core — vue d'ensemble](index.md) · [Toute la documentation](../../../docs/index.md)
|
|
609
|
+
- 🧭 **Pages sœurs** : [Hooks React `nodefony/react`](react-hooks.md) — les bindings qui câblent tout
|
|
610
|
+
ça dans un composant · [Service et événements](service.md) — la classe de base, isomorphe elle
|
|
611
|
+
aussi · [Journalisation](syslog.md) — le `Syslog` qui tourne aussi dans l'onglet
|
|
612
|
+
- Le serveur en face : [la socket Nodefony](../../../src/packages/@nodefony/realtime/docs/index.md) ·
|
|
613
|
+
[son architecture](../../../src/packages/@nodefony/realtime/docs/architecture.md) ·
|
|
614
|
+
[son vocabulaire](../../../src/packages/@nodefony/realtime/docs/vocabulaire.md)
|
|
615
|
+
- Un exemple complet de bout en bout → [Cookbook — un chat](../../../src/packages/@nodefony/realtime/docs/cookbook-chat.md)
|
|
616
|
+
- Comment le bundle arrive au navigateur → [`@nodefony/frontend`](../../../src/packages/@nodefony/frontend/docs/index.md)
|