7d4da69f22
Behavior-preserving; 231 BattleNode tests green. - §D: MsgEnvelope.Try -> RetryAttempt (drops keyword-escape; wire key stays "try"); SocketIoFrame.AckResponse arg -> pubSeqEcho. - §B: Gungnir.EmitInterval -> BattleNodeOptions.AliveEmitInterval (unused literal moved to its config home); deck-idx 4L -> InitialHand.Length + 1. - §E: shared Wire.WireJsonOptions.CamelCase replaces the duplicated camelCase JsonSerializerOptions in EngineIoHandshake and MsgEnvelope. - §F: do-NOT-consistency-fix polarity notes on TurnEndFinalHandler (From wins) and RetireKillHandler (From loses). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
40 lines
2.0 KiB
C#
40 lines
2.0 KiB
C#
namespace SVSim.BattleNode.Bridge;
|
|
|
|
/// <summary>
|
|
/// DI-injected options for the battle node. NodeServerUrl matches the prod
|
|
/// do_matching wire format: <c>host:port/socket.io/</c>, no scheme prefix.
|
|
/// BestHTTP's SocketManager parses it as the Socket.IO v2 endpoint URL.
|
|
/// </summary>
|
|
public sealed class BattleNodeOptions
|
|
{
|
|
public string NodeServerUrl { get; set; } = "localhost:5148/socket.io/";
|
|
|
|
/// <summary>
|
|
/// How long the first arriver's WS waits for a partner before disconnecting.
|
|
/// Matches the architecture spec's 60s default; override (typically lower)
|
|
/// in tests via the factory.
|
|
/// </summary>
|
|
public TimeSpan WaitingRoomTimeout { get; set; } = TimeSpan.FromSeconds(60);
|
|
|
|
/// <summary>
|
|
/// Cadence of the server→client alive ("Gungnir") keepalive emit. The driving timer/loop
|
|
/// (to live on <see cref="Sessions.BattleSession"/>) is deferred in v1; this is its future
|
|
/// home so the interval isn't a magic literal stranded on the <c>Gungnir</c> body factory.
|
|
/// </summary>
|
|
public TimeSpan AliveEmitInterval { get; set; } = TimeSpan.FromSeconds(5);
|
|
|
|
/// <summary>
|
|
/// When true, <see cref="Sessions.Participants.RealParticipant"/> emits per-frame
|
|
/// diagnostic logs at Information level: <c>[sio-in]</c> on every inbound msg/alive/hand
|
|
/// envelope (URI, pubSeq, ackId, dispatch decision, ack-sent flag, ack arg, inbound
|
|
/// watermark); <c>[sio-out]</c> on every outbound push (URI, pubSeq, playSeq, stock);
|
|
/// <c>[ws-rx-text]</c> / <c>[ws-rx-bin]</c> on every WS frame received at the transport
|
|
/// layer; <c>[ws-recv-exit]</c> / <c>[ws-loop-exit]</c> on read-loop termination
|
|
/// (with WebSocket state + exception type when applicable). Default false — keeps
|
|
/// production logs clean. Flip on per session for live WS debugging, PvP investigation,
|
|
/// or to reproduce the kind of softlock chased in
|
|
/// <c>docs/audits/battle-node-sio-events-2026-06-02.md</c>.
|
|
/// </summary>
|
|
public bool DiagnosticLogging { get; set; } = false;
|
|
}
|