Files
natsnet/docs/plans/phases/phase6sessions/session-04.md
Joseph Doherty 88b1391ef0 feat: port session 07 — Protocol Parser, Auth extras (TPM/certidp/certstore), Internal utilities & data structures
Session 07 scope (5 features, 17 tests, ~1165 Go LOC):
- Protocol/ParserTypes.cs: ParserState enum (79 states), PublishArgument, ParseContext
- Protocol/IProtocolHandler.cs: handler interface decoupling parser from client
- Protocol/ProtocolParser.cs: Parse(), ProtoSnippet(), OverMaxControlLineLimit(),
  ProcessPub/HeaderPub/RoutedMsgArgs/RoutedHeaderMsgArgs, ClonePubArg(), GetHeader()
- tests/Protocol/ProtocolParserTests.cs: 17 tests via TestProtocolHandler stub

Auth extras from session 06 (committed separately):
- Auth/TpmKeyProvider.cs, Auth/CertificateIdentityProvider/, Auth/CertificateStore/

Internal utilities & data structures (session 06 overflow):
- Internal/AccessTimeService.cs, ElasticPointer.cs, SystemMemory.cs, ProcessStatsProvider.cs
- Internal/DataStructures/GenericSublist.cs, HashWheel.cs
- Internal/DataStructures/SubjectTree.cs, SubjectTreeNode.cs, SubjectTreeParts.cs

All 461 tests pass (460 unit + 1 integration). DB updated for features 2588-2592 and tests 2598-2614.
2026-02-26 13:16:56 -05:00

1.5 KiB
Raw Blame History

Session 04: Logging, Signals & Services

Summary

Logging infrastructure, OS signal handling (Unix/Windows/WASM), and Windows service management. Small session — good opportunity to also address platform-specific abstractions.

Scope

Go File Features Feature IDs Go LOC
server/log.go 18 20502067 207
server/signal.go 5 31553159 156
server/signal_wasm.go 2 31603161 6
server/signal_windows.go 2 31623163 79
server/service.go 2 31483149 7
server/service_windows.go 5 31503154 79
Total 34 534

.NET Classes

  • NatsLogger (or logging integration) — server logging wrapper
  • SignalHandler — OS signal handling (SIGTERM, SIGHUP, etc.)
  • ServiceManager — Windows service lifecycle

Test Files

Test File Tests Test IDs
server/log_test.go 6 20172022
server/signal_test.go 19 29102928
server/service_test.go 1 2908
server/service_windows_test.go 1 2909
Total 27

Dependencies

  • Session 01 (Foundation Types)

.NET Target Location

  • dotnet/src/ZB.MOM.NatsNet.Server/Internal/ (logging)
  • dotnet/src/ZB.MOM.NatsNet.Server.Host/ (signal/service)

Notes

  • .NET uses Microsoft.Extensions.Logging + Serilog per standards
  • Windows service support maps to Microsoft.Extensions.Hosting.WindowsServices
  • Signal handling maps to Console.CancelKeyPress + AppDomain.ProcessExit