docs: add XML doc comments to server types and fix flaky test timings

Add XML doc comments to public properties across EventTypes, Connz, Varz,
NatsOptions, StreamConfig, IStreamStore, FileStore, MqttListener,
MqttSessionStore, MessageTraceContext, and JetStreamApiResponse. Fix flaky
tests by increasing timing margins (ResponseTracker expiry 1ms→50ms,
sleep 50ms→200ms) and document known flaky test patterns in tests.md.
This commit is contained in:
Joseph Doherty
2026-03-13 18:47:48 -04:00
parent 1d4b87e5f9
commit 88a82ee860
24 changed files with 2874 additions and 216 deletions

View File

@@ -186,11 +186,11 @@ public class GatewayGoParityTests
var sw = System.Diagnostics.Stopwatch.StartNew();
var disposeTask = manager.DisposeAsync().AsTask();
var completed = await Task.WhenAny(disposeTask, Task.Delay(TimeSpan.FromSeconds(5)));
var completed = await Task.WhenAny(disposeTask, Task.Delay(TimeSpan.FromSeconds(10)));
sw.Stop();
completed.ShouldBe(disposeTask, "DisposeAsync should complete within 5 seconds");
sw.Elapsed.ShouldBeLessThan(TimeSpan.FromSeconds(4));
completed.ShouldBe(disposeTask, "DisposeAsync should complete within 10 seconds");
sw.Elapsed.ShouldBeLessThan(TimeSpan.FromSeconds(8));
}
// ── TestGatewayAuth (stub — auth not yet wired to gateway handshake) ──