feat: Wave 6 batch 2 — accounts/auth, gateways, routes, JetStream API, JetStream cluster tests

Add comprehensive Go-parity test coverage across 5 subsystems:
- Accounts/Auth: isolation, import/export, auth mechanisms, permissions (82 tests)
- Gateways: connection, forwarding, interest mode, config (106 tests)
- Routes: connection, subscription, forwarding, config validation (78 tests)
- JetStream API: stream/consumer CRUD, pub/sub, features, admin (234 tests)
- JetStream Cluster: streams, consumers, failover, meta (108 tests)

Total: ~608 new test annotations across 22 files (+13,844 lines)
All tests pass individually; suite total: 2,283 passing, 3 skipped
This commit is contained in:
Joseph Doherty
2026-02-23 22:35:06 -05:00
parent 9554d53bf5
commit f1353868af
23 changed files with 13844 additions and 74 deletions

View File

@@ -0,0 +1,580 @@
using Microsoft.Extensions.Logging.Abstractions;
using NATS.Server.Configuration;
using NATS.Server.Gateways;
using NATS.Server.Monitoring;
namespace NATS.Server.Tests.Gateways;
/// <summary>
/// Gateway configuration validation, options parsing, monitoring endpoint,
/// and server lifecycle tests.
/// Ported from golang/nats-server/server/gateway_test.go.
/// </summary>
public class GatewayConfigTests
{
// ── GatewayOptions Defaults ─────────────────────────────────────────
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public void Default_gateway_options_have_correct_defaults()
{
var options = new GatewayOptions();
options.Name.ShouldBeNull();
options.Host.ShouldBe("0.0.0.0");
options.Port.ShouldBe(0);
options.Remotes.ShouldNotBeNull();
options.Remotes.Count.ShouldBe(0);
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public void Gateway_options_name_can_be_set()
{
var options = new GatewayOptions { Name = "CLUSTER-A" };
options.Name.ShouldBe("CLUSTER-A");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public void Gateway_options_host_can_be_set()
{
var options = new GatewayOptions { Host = "192.168.1.1" };
options.Host.ShouldBe("192.168.1.1");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public void Gateway_options_port_can_be_set()
{
var options = new GatewayOptions { Port = 7222 };
options.Port.ShouldBe(7222);
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public void Gateway_options_remotes_can_be_set()
{
var options = new GatewayOptions
{
Remotes = ["127.0.0.1:7222", "127.0.0.1:7223"],
};
options.Remotes.Count.ShouldBe(2);
}
// ── NatsOptions Gateway Configuration ───────────────────────────────
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public void NatsOptions_gateway_is_null_by_default()
{
var opts = new NatsOptions();
opts.Gateway.ShouldBeNull();
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public void NatsOptions_gateway_can_be_assigned()
{
var opts = new NatsOptions
{
Gateway = new GatewayOptions
{
Name = "TestGW",
Host = "127.0.0.1",
Port = 7222,
},
};
opts.Gateway.ShouldNotBeNull();
opts.Gateway.Name.ShouldBe("TestGW");
}
// ── Config File Parsing ─────────────────────────────────────────────
// Go: TestGatewayWithListenToAny server/gateway_test.go:834
[Fact]
public void Config_processor_parses_gateway_name()
{
var config = """
gateway {
name: "MY-GATEWAY"
}
""";
var opts = ConfigProcessor.ProcessConfig(config);
opts.Gateway.ShouldNotBeNull();
opts.Gateway!.Name.ShouldBe("MY-GATEWAY");
}
// Go: TestGatewayWithListenToAny server/gateway_test.go:834
[Fact]
public void Config_processor_parses_gateway_listen()
{
var config = """
gateway {
name: "GW"
listen: "127.0.0.1:7222"
}
""";
var opts = ConfigProcessor.ProcessConfig(config);
opts.Gateway.ShouldNotBeNull();
opts.Gateway!.Host.ShouldBe("127.0.0.1");
opts.Gateway!.Port.ShouldBe(7222);
}
// Go: TestGatewayWithListenToAny server/gateway_test.go:834
[Fact]
public void Config_processor_parses_gateway_listen_any()
{
var config = """
gateway {
name: "GW"
listen: "0.0.0.0:7333"
}
""";
var opts = ConfigProcessor.ProcessConfig(config);
opts.Gateway.ShouldNotBeNull();
opts.Gateway!.Host.ShouldBe("0.0.0.0");
opts.Gateway!.Port.ShouldBe(7333);
}
// Go: TestGatewayWithListenToAny server/gateway_test.go:834
[Fact]
public void Config_processor_gateway_without_name_leaves_null()
{
var config = """
gateway {
listen: "127.0.0.1:7222"
}
""";
var opts = ConfigProcessor.ProcessConfig(config);
opts.Gateway.ShouldNotBeNull();
opts.Gateway!.Name.ShouldBeNull();
}
// Go: TestGatewayWithListenToAny server/gateway_test.go:834
[Fact]
public void Config_processor_no_gateway_section_leaves_null()
{
var config = """
port: 4222
""";
var opts = ConfigProcessor.ProcessConfig(config);
opts.Gateway.ShouldBeNull();
}
// ── Server Lifecycle with Gateway ───────────────────────────────────
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Server_starts_with_gateway_configured()
{
var opts = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Gateway = new GatewayOptions
{
Name = "LIFECYCLE",
Host = "127.0.0.1",
Port = 0,
},
};
var server = new NatsServer(opts, NullLoggerFactory.Instance);
var cts = new CancellationTokenSource();
_ = server.StartAsync(cts.Token);
await server.WaitForReadyAsync();
server.GatewayListen.ShouldNotBeNull();
server.GatewayListen.ShouldContain("127.0.0.1:");
await cts.CancelAsync();
server.Dispose();
cts.Dispose();
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Server_gateway_listen_uses_ephemeral_port()
{
var opts = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Gateway = new GatewayOptions
{
Name = "EPHEMERAL",
Host = "127.0.0.1",
Port = 0,
},
};
var server = new NatsServer(opts, NullLoggerFactory.Instance);
var cts = new CancellationTokenSource();
_ = server.StartAsync(cts.Token);
await server.WaitForReadyAsync();
// The gateway listen should have a non-zero port
var parts = server.GatewayListen!.Split(':');
int.Parse(parts[1]).ShouldBeGreaterThan(0);
await cts.CancelAsync();
server.Dispose();
cts.Dispose();
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Server_without_gateway_has_null_gateway_listen()
{
var opts = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
};
var server = new NatsServer(opts, NullLoggerFactory.Instance);
var cts = new CancellationTokenSource();
_ = server.StartAsync(cts.Token);
await server.WaitForReadyAsync();
server.GatewayListen.ShouldBeNull();
await cts.CancelAsync();
server.Dispose();
cts.Dispose();
}
// Go: TestGatewayNoPanicOnStartupWithMonitoring server/gateway_test.go:6903
[Fact]
public async Task Server_starts_with_both_gateway_and_monitoring()
{
var opts = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
MonitorPort = 0,
Gateway = new GatewayOptions
{
Name = "MON-GW",
Host = "127.0.0.1",
Port = 0,
},
};
var server = new NatsServer(opts, NullLoggerFactory.Instance);
var cts = new CancellationTokenSource();
_ = server.StartAsync(cts.Token);
await server.WaitForReadyAsync();
server.GatewayListen.ShouldNotBeNull();
await cts.CancelAsync();
server.Dispose();
cts.Dispose();
}
// ── GatewayManager Unit Tests ───────────────────────────────────────
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_manager_starts_and_listens()
{
var options = new GatewayOptions
{
Name = "UNIT",
Host = "127.0.0.1",
Port = 0,
};
var stats = new ServerStats();
var manager = new GatewayManager(
options,
stats,
"SERVER-1",
_ => { },
_ => { },
NullLogger<GatewayManager>.Instance);
await manager.StartAsync(CancellationToken.None);
manager.ListenEndpoint.ShouldContain("127.0.0.1:");
await manager.DisposeAsync();
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_manager_ephemeral_port_resolves()
{
var options = new GatewayOptions
{
Name = "UNIT",
Host = "127.0.0.1",
Port = 0,
};
var manager = new GatewayManager(
options,
new ServerStats(),
"S1",
_ => { },
_ => { },
NullLogger<GatewayManager>.Instance);
await manager.StartAsync(CancellationToken.None);
// Port should have been resolved
options.Port.ShouldBeGreaterThan(0);
await manager.DisposeAsync();
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_manager_dispose_decrements_stats()
{
var options = new GatewayOptions
{
Name = "STATS",
Host = "127.0.0.1",
Port = 0,
};
var stats = new ServerStats();
var manager = new GatewayManager(
options,
stats,
"S1",
_ => { },
_ => { },
NullLogger<GatewayManager>.Instance);
await manager.StartAsync(CancellationToken.None);
await manager.DisposeAsync();
stats.Gateways.ShouldBe(0);
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_manager_forward_without_connections_does_not_throw()
{
var options = new GatewayOptions
{
Name = "EMPTY",
Host = "127.0.0.1",
Port = 0,
};
var manager = new GatewayManager(
options,
new ServerStats(),
"S1",
_ => { },
_ => { },
NullLogger<GatewayManager>.Instance);
// ForwardMessageAsync without any connections should not throw
await manager.ForwardMessageAsync("$G", "test", null, new byte[] { 1 }, CancellationToken.None);
manager.ForwardedJetStreamClusterMessages.ShouldBe(0);
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_manager_propagate_without_connections_does_not_throw()
{
var options = new GatewayOptions
{
Name = "EMPTY",
Host = "127.0.0.1",
Port = 0,
};
var manager = new GatewayManager(
options,
new ServerStats(),
"S1",
_ => { },
_ => { },
NullLogger<GatewayManager>.Instance);
// These should not throw even without connections
manager.PropagateLocalSubscription("$G", "test.>", null);
manager.PropagateLocalUnsubscription("$G", "test.>", null);
}
// ── GatewayzHandler ─────────────────────────────────────────────────
// Go: TestGatewayNoPanicOnStartupWithMonitoring server/gateway_test.go:6903
[Fact]
public async Task Gatewayz_handler_returns_gateway_count()
{
await using var fixture = await GatewayConfigFixture.StartAsync();
var handler = new GatewayzHandler(fixture.Local);
var result = handler.Build();
result.ShouldNotBeNull();
}
// Go: TestGatewayNoPanicOnStartupWithMonitoring server/gateway_test.go:6903
[Fact]
public async Task Gatewayz_handler_reflects_active_connections()
{
await using var fixture = await GatewayConfigFixture.StartAsync();
fixture.Local.Stats.Gateways.ShouldBeGreaterThan(0);
}
// ── Duplicate Remote Deduplication ───────────────────────────────────
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Duplicate_remotes_are_deduplicated()
{
var localOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Gateway = new GatewayOptions
{
Name = "LOCAL",
Host = "127.0.0.1",
Port = 0,
},
};
var local = new NatsServer(localOptions, NullLoggerFactory.Instance);
var localCts = new CancellationTokenSource();
_ = local.StartAsync(localCts.Token);
await local.WaitForReadyAsync();
// Create remote with duplicate entries
var remoteOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Gateway = new GatewayOptions
{
Name = "REMOTE",
Host = "127.0.0.1",
Port = 0,
Remotes = [local.GatewayListen!, local.GatewayListen!],
},
};
var remote = new NatsServer(remoteOptions, NullLoggerFactory.Instance);
var remoteCts = new CancellationTokenSource();
_ = remote.StartAsync(remoteCts.Token);
await remote.WaitForReadyAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested && (local.Stats.Gateways == 0 || remote.Stats.Gateways == 0))
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
// Should have exactly 1 gateway connection, not 2
// (remote deduplicates identical endpoints)
local.Stats.Gateways.ShouldBeGreaterThan(0);
remote.Stats.Gateways.ShouldBeGreaterThan(0);
await localCts.CancelAsync();
await remoteCts.CancelAsync();
local.Dispose();
remote.Dispose();
localCts.Dispose();
remoteCts.Dispose();
}
// ── ServerStats Gateway Fields ──────────────────────────────────────
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public void ServerStats_gateway_fields_initialized_to_zero()
{
var stats = new ServerStats();
stats.Gateways.ShouldBe(0);
stats.SlowConsumerGateways.ShouldBe(0);
stats.StaleConnectionGateways.ShouldBe(0);
}
// Go: TestGatewaySlowConsumer server/gateway_test.go:7003
[Fact]
public void ServerStats_gateway_counter_atomic()
{
var stats = new ServerStats();
Interlocked.Increment(ref stats.Gateways);
Interlocked.Increment(ref stats.Gateways);
stats.Gateways.ShouldBe(2);
Interlocked.Decrement(ref stats.Gateways);
stats.Gateways.ShouldBe(1);
}
}
/// <summary>
/// Shared fixture for config tests.
/// </summary>
internal sealed class GatewayConfigFixture : IAsyncDisposable
{
private readonly CancellationTokenSource _localCts;
private readonly CancellationTokenSource _remoteCts;
private GatewayConfigFixture(NatsServer local, NatsServer remote, CancellationTokenSource localCts, CancellationTokenSource remoteCts)
{
Local = local;
Remote = remote;
_localCts = localCts;
_remoteCts = remoteCts;
}
public NatsServer Local { get; }
public NatsServer Remote { get; }
public static async Task<GatewayConfigFixture> StartAsync()
{
var localOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Gateway = new GatewayOptions
{
Name = "LOCAL",
Host = "127.0.0.1",
Port = 0,
},
};
var local = new NatsServer(localOptions, NullLoggerFactory.Instance);
var localCts = new CancellationTokenSource();
_ = local.StartAsync(localCts.Token);
await local.WaitForReadyAsync();
var remoteOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Gateway = new GatewayOptions
{
Name = "REMOTE",
Host = "127.0.0.1",
Port = 0,
Remotes = [local.GatewayListen!],
},
};
var remote = new NatsServer(remoteOptions, NullLoggerFactory.Instance);
var remoteCts = new CancellationTokenSource();
_ = remote.StartAsync(remoteCts.Token);
await remote.WaitForReadyAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested && (local.Stats.Gateways == 0 || remote.Stats.Gateways == 0))
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
return new GatewayConfigFixture(local, remote, localCts, remoteCts);
}
public async ValueTask DisposeAsync()
{
await _localCts.CancelAsync();
await _remoteCts.CancelAsync();
Local.Dispose();
Remote.Dispose();
_localCts.Dispose();
_remoteCts.Dispose();
}
}

View File

@@ -0,0 +1,898 @@
using System.Net;
using System.Net.Sockets;
using System.Text;
using Microsoft.Extensions.Logging.Abstractions;
using NATS.Client.Core;
using NATS.Server.Configuration;
using NATS.Server.Gateways;
using NATS.Server.Subscriptions;
namespace NATS.Server.Tests.Gateways;
/// <summary>
/// Gateway connection establishment, handshake, lifecycle, and reconnection tests.
/// Ported from golang/nats-server/server/gateway_test.go.
/// </summary>
public class GatewayConnectionTests
{
// ── Handshake and Connection Establishment ──────────────────────────
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_outbound_handshake_sets_remote_id()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL-SERVER", cts.Token);
var line = await ReadLineAsync(clientSocket, cts.Token);
line.ShouldBe("GATEWAY LOCAL-SERVER");
await WriteLineAsync(clientSocket, "GATEWAY REMOTE-SERVER", cts.Token);
await handshake;
gw.RemoteId.ShouldBe("REMOTE-SERVER");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_inbound_handshake_sets_remote_id()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformInboundHandshakeAsync("LOCAL-SERVER", cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE-CLIENT", cts.Token);
var line = await ReadLineAsync(clientSocket, cts.Token);
line.ShouldBe("GATEWAY LOCAL-SERVER");
await handshake;
gw.RemoteId.ShouldBe("REMOTE-CLIENT");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_handshake_rejects_invalid_protocol()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformInboundHandshakeAsync("LOCAL", cts.Token);
await WriteLineAsync(clientSocket, "INVALID protocol", cts.Token);
await Should.ThrowAsync<InvalidOperationException>(async () => await handshake);
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_handshake_rejects_empty_id()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformInboundHandshakeAsync("LOCAL", cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY ", cts.Token);
await Should.ThrowAsync<InvalidOperationException>(async () => await handshake);
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Two_clusters_establish_gateway_connections()
{
await using var fixture = await GatewayConnectionFixture.StartAsync();
fixture.Local.Stats.Gateways.ShouldBeGreaterThan(0);
fixture.Remote.Stats.Gateways.ShouldBeGreaterThan(0);
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_connection_count_tracked_in_stats()
{
await using var fixture = await GatewayConnectionFixture.StartAsync();
fixture.Local.Stats.Gateways.ShouldBeGreaterThanOrEqualTo(1);
fixture.Remote.Stats.Gateways.ShouldBeGreaterThanOrEqualTo(1);
}
// Go: TestGatewayDoesntSendBackToItself server/gateway_test.go:2150
[Fact]
public async Task Gateway_does_not_create_echo_cycle()
{
await using var fixture = await GatewayConnectionFixture.StartAsync();
await using var remoteSub = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await remoteSub.ConnectAsync();
await using var localConn = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await localConn.ConnectAsync();
await using var sub = await remoteSub.SubscribeCoreAsync<string>("cycle.test");
await remoteSub.PingAsync();
await fixture.WaitForRemoteInterestOnLocalAsync("cycle.test");
await localConn.PublishAsync("cycle.test", "ping");
await localConn.PingAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(3));
var msg = await sub.Msgs.ReadAsync(timeout.Token);
msg.Data.ShouldBe("ping");
// Verify no additional cycle messages arrive
await Task.Delay(200);
using var noMoreTimeout = new CancellationTokenSource(TimeSpan.FromMilliseconds(300));
await Should.ThrowAsync<OperationCanceledException>(async () =>
await sub.Msgs.ReadAsync(noMoreTimeout.Token));
}
// Go: TestGatewaySolicitShutdown server/gateway_test.go:784
[Fact]
public async Task Gateway_manager_shutdown_does_not_hang()
{
var options = new GatewayOptions
{
Name = "TEST",
Host = "127.0.0.1",
Port = 0,
Remotes = ["127.0.0.1:19999"], // Non-existent host
};
var manager = new GatewayManager(
options,
new ServerStats(),
"S1",
_ => { },
_ => { },
NullLogger<GatewayManager>.Instance);
await manager.StartAsync(CancellationToken.None);
// Dispose should complete promptly even with pending reconnect attempts
var disposeTask = manager.DisposeAsync().AsTask();
var completed = await Task.WhenAny(disposeTask, Task.Delay(TimeSpan.FromSeconds(5)));
completed.ShouldBe(disposeTask, "DisposeAsync should complete within timeout");
}
// Go: TestGatewayBasic server/gateway_test.go:399 (reconnection part)
[Fact]
public async Task Gateway_reconnects_after_remote_shutdown()
{
var localOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Gateway = new GatewayOptions
{
Name = "LOCAL",
Host = "127.0.0.1",
Port = 0,
},
};
var local = new NatsServer(localOptions, NullLoggerFactory.Instance);
var localCts = new CancellationTokenSource();
_ = local.StartAsync(localCts.Token);
await local.WaitForReadyAsync();
// Start remote
var remoteOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Gateway = new GatewayOptions
{
Name = "REMOTE",
Host = "127.0.0.1",
Port = 0,
Remotes = [local.GatewayListen!],
},
};
var remote = new NatsServer(remoteOptions, NullLoggerFactory.Instance);
var remoteCts = new CancellationTokenSource();
_ = remote.StartAsync(remoteCts.Token);
await remote.WaitForReadyAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested && (local.Stats.Gateways == 0 || remote.Stats.Gateways == 0))
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
local.Stats.Gateways.ShouldBeGreaterThan(0);
remote.Stats.Gateways.ShouldBeGreaterThan(0);
// Shutdown remote
await remoteCts.CancelAsync();
remote.Dispose();
// Wait for gateway count to drop
using var dropTimeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!dropTimeout.IsCancellationRequested && local.Stats.Gateways > 0)
await Task.Delay(50, dropTimeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
// Restart remote connecting to local
var remote2Options = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Gateway = new GatewayOptions
{
Name = "REMOTE2",
Host = "127.0.0.1",
Port = 0,
Remotes = [local.GatewayListen!],
},
};
var remote2 = new NatsServer(remote2Options, NullLoggerFactory.Instance);
var remote2Cts = new CancellationTokenSource();
_ = remote2.StartAsync(remote2Cts.Token);
await remote2.WaitForReadyAsync();
// Wait for new gateway link
using var reconTimeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!reconTimeout.IsCancellationRequested && (local.Stats.Gateways == 0 || remote2.Stats.Gateways == 0))
await Task.Delay(50, reconTimeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
local.Stats.Gateways.ShouldBeGreaterThan(0);
remote2.Stats.Gateways.ShouldBeGreaterThan(0);
await localCts.CancelAsync();
await remote2Cts.CancelAsync();
local.Dispose();
remote2.Dispose();
localCts.Dispose();
remote2Cts.Dispose();
remoteCts.Dispose();
}
// Go: TestGatewayNoReconnectOnClose server/gateway_test.go:1735
[Fact]
public async Task Connection_read_loop_starts_and_processes_messages()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
// Perform handshake
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
var receivedMessage = new TaskCompletionSource<GatewayMessage>();
gw.MessageReceived = msg =>
{
receivedMessage.TrySetResult(msg);
return Task.CompletedTask;
};
gw.StartLoop(cts.Token);
// Send a GMSG message
var payload = "hello-gateway"u8.ToArray();
var line = $"GMSG $G test.subject - {payload.Length}\r\n";
await clientSocket.SendAsync(Encoding.ASCII.GetBytes(line), SocketFlags.None, cts.Token);
await clientSocket.SendAsync(payload, SocketFlags.None, cts.Token);
await clientSocket.SendAsync("\r\n"u8.ToArray(), SocketFlags.None, cts.Token);
var msg = await receivedMessage.Task.WaitAsync(cts.Token);
msg.Subject.ShouldBe("test.subject");
msg.ReplyTo.ShouldBeNull();
Encoding.UTF8.GetString(msg.Payload.Span).ShouldBe("hello-gateway");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Connection_read_loop_processes_gmsg_with_reply()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
var receivedMessage = new TaskCompletionSource<GatewayMessage>();
gw.MessageReceived = msg =>
{
receivedMessage.TrySetResult(msg);
return Task.CompletedTask;
};
gw.StartLoop(cts.Token);
var payload = "data"u8.ToArray();
var line = $"GMSG $G test.subject _INBOX.abc {payload.Length}\r\n";
await clientSocket.SendAsync(Encoding.ASCII.GetBytes(line), SocketFlags.None, cts.Token);
await clientSocket.SendAsync(payload, SocketFlags.None, cts.Token);
await clientSocket.SendAsync("\r\n"u8.ToArray(), SocketFlags.None, cts.Token);
var msg = await receivedMessage.Task.WaitAsync(cts.Token);
msg.Subject.ShouldBe("test.subject");
msg.ReplyTo.ShouldBe("_INBOX.abc");
msg.Account.ShouldBe("$G");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Connection_read_loop_processes_account_scoped_gmsg()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
var receivedMessage = new TaskCompletionSource<GatewayMessage>();
gw.MessageReceived = msg =>
{
receivedMessage.TrySetResult(msg);
return Task.CompletedTask;
};
gw.StartLoop(cts.Token);
var payload = "msg"u8.ToArray();
var line = $"GMSG ACCT test.subject - {payload.Length}\r\n";
await clientSocket.SendAsync(Encoding.ASCII.GetBytes(line), SocketFlags.None, cts.Token);
await clientSocket.SendAsync(payload, SocketFlags.None, cts.Token);
await clientSocket.SendAsync("\r\n"u8.ToArray(), SocketFlags.None, cts.Token);
var msg = await receivedMessage.Task.WaitAsync(cts.Token);
msg.Account.ShouldBe("ACCT");
msg.Subject.ShouldBe("test.subject");
}
// Go: TestGatewayDontSendSubInterest server/gateway_test.go:1755
[Fact]
public async Task Connection_read_loop_processes_aplus_interest()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
var receivedSub = new TaskCompletionSource<RemoteSubscription>();
gw.RemoteSubscriptionReceived = sub =>
{
receivedSub.TrySetResult(sub);
return Task.CompletedTask;
};
gw.StartLoop(cts.Token);
await WriteLineAsync(clientSocket, "A+ MYACC orders.>", cts.Token);
var sub = await receivedSub.Task.WaitAsync(cts.Token);
sub.Subject.ShouldBe("orders.>");
sub.Account.ShouldBe("MYACC");
sub.IsRemoval.ShouldBeFalse();
}
// Go: TestGatewayAccountUnsub server/gateway_test.go:1912
[Fact]
public async Task Connection_read_loop_processes_aminus_interest()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
var receivedSubs = new List<RemoteSubscription>();
var tcs = new TaskCompletionSource();
gw.RemoteSubscriptionReceived = sub =>
{
receivedSubs.Add(sub);
if (receivedSubs.Count >= 2)
tcs.TrySetResult();
return Task.CompletedTask;
};
gw.StartLoop(cts.Token);
await WriteLineAsync(clientSocket, "A+ ACC foo.*", cts.Token);
await WriteLineAsync(clientSocket, "A- ACC foo.*", cts.Token);
await tcs.Task.WaitAsync(cts.Token);
receivedSubs[0].IsRemoval.ShouldBeFalse();
receivedSubs[1].IsRemoval.ShouldBeTrue();
}
// Go: TestGatewayQueueSub server/gateway_test.go:2265
[Fact]
public async Task Connection_read_loop_processes_aplus_with_queue()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
var receivedSub = new TaskCompletionSource<RemoteSubscription>();
gw.RemoteSubscriptionReceived = sub =>
{
receivedSub.TrySetResult(sub);
return Task.CompletedTask;
};
gw.StartLoop(cts.Token);
await WriteLineAsync(clientSocket, "A+ $G foo.bar workers", cts.Token);
var sub = await receivedSub.Task.WaitAsync(cts.Token);
sub.Subject.ShouldBe("foo.bar");
sub.Queue.ShouldBe("workers");
sub.Account.ShouldBe("$G");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Send_message_writes_gmsg_protocol()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
var payload = Encoding.UTF8.GetBytes("payload-data");
await gw.SendMessageAsync("$G", "test.subject", "_INBOX.reply", payload, cts.Token);
var buf = new byte[4096];
var total = new StringBuilder();
using var readCts = new CancellationTokenSource(TimeSpan.FromSeconds(2));
while (true)
{
var n = await clientSocket.ReceiveAsync(buf, SocketFlags.None, readCts.Token);
if (n == 0) break;
total.Append(Encoding.ASCII.GetString(buf, 0, n));
if (total.ToString().Contains("payload-data", StringComparison.Ordinal))
break;
}
var received = total.ToString();
received.ShouldContain("GMSG $G test.subject _INBOX.reply");
received.ShouldContain("payload-data");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Send_aplus_writes_interest_protocol()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
await gw.SendAPlusAsync("$G", "orders.>", null, cts.Token);
var line = await ReadLineAsync(clientSocket, cts.Token);
line.ShouldBe("A+ $G orders.>");
}
// Go: TestGatewayQueueSub server/gateway_test.go:2265
[Fact]
public async Task Send_aplus_with_queue_writes_interest_protocol()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
await gw.SendAPlusAsync("$G", "foo", "workers", cts.Token);
var line = await ReadLineAsync(clientSocket, cts.Token);
line.ShouldBe("A+ $G foo workers");
}
// Go: TestGatewayAccountUnsub server/gateway_test.go:1912
[Fact]
public async Task Send_aminus_writes_unsubscribe_interest_protocol()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
await gw.SendAMinusAsync("$G", "orders.>", null, cts.Token);
var line = await ReadLineAsync(clientSocket, cts.Token);
line.ShouldBe("A- $G orders.>");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Send_message_with_no_reply_uses_dash()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
await gw.SendMessageAsync("$G", "test.subject", null, new byte[] { 0x41 }, cts.Token);
var buf = new byte[4096];
var total = new StringBuilder();
using var readCts = new CancellationTokenSource(TimeSpan.FromSeconds(2));
while (true)
{
var n = await clientSocket.ReceiveAsync(buf, SocketFlags.None, readCts.Token);
if (n == 0) break;
total.Append(Encoding.ASCII.GetString(buf, 0, n));
if (total.ToString().Contains("\r\n", StringComparison.Ordinal) && total.Length > 20)
break;
}
total.ToString().ShouldContain("GMSG $G test.subject - 1");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Send_message_with_empty_payload()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
await gw.SendMessageAsync("$G", "test.empty", null, ReadOnlyMemory<byte>.Empty, cts.Token);
var buf = new byte[4096];
var total = new StringBuilder();
using var readCts = new CancellationTokenSource(TimeSpan.FromSeconds(2));
while (true)
{
var n = await clientSocket.ReceiveAsync(buf, SocketFlags.None, readCts.Token);
if (n == 0) break;
total.Append(Encoding.ASCII.GetString(buf, 0, n));
if (total.ToString().Contains("GMSG", StringComparison.Ordinal))
break;
}
total.ToString().ShouldContain("GMSG $G test.empty - 0");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Connection_dispose_cleans_up_gracefully()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
gw.StartLoop(cts.Token);
await gw.DisposeAsync(); // Should not throw
// Verify the connection is no longer usable after dispose
gw.RemoteId.ShouldBe("REMOTE");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Multiple_concurrent_sends_are_serialized()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
using var clientSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await clientSocket.ConnectAsync(IPAddress.Loopback, port);
using var serverSocket = await listener.AcceptSocketAsync();
await using var gw = new GatewayConnection(serverSocket);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var handshake = gw.PerformOutboundHandshakeAsync("LOCAL", cts.Token);
await ReadLineAsync(clientSocket, cts.Token);
await WriteLineAsync(clientSocket, "GATEWAY REMOTE", cts.Token);
await handshake;
// Fire off concurrent sends
var tasks = new List<Task>();
for (int i = 0; i < 10; i++)
{
var idx = i;
tasks.Add(gw.SendMessageAsync("$G", $"sub.{idx}", null, Encoding.UTF8.GetBytes($"msg-{idx}"), cts.Token));
}
await Task.WhenAll(tasks);
// Drain all data from socket
var buf = new byte[8192];
var total = new StringBuilder();
using var readCts = new CancellationTokenSource(TimeSpan.FromSeconds(2));
while (true)
{
try
{
var n = await clientSocket.ReceiveAsync(buf, SocketFlags.None, readCts.Token);
if (n == 0) break;
total.Append(Encoding.ASCII.GetString(buf, 0, n));
}
catch (OperationCanceledException)
{
break;
}
}
// All 10 messages should be present
var received = total.ToString();
for (int i = 0; i < 10; i++)
{
received.ShouldContain($"sub.{i}");
}
}
// ── Helpers ─────────────────────────────────────────────────────────
private static async Task<string> ReadLineAsync(Socket socket, CancellationToken ct)
{
var bytes = new List<byte>(64);
var single = new byte[1];
while (true)
{
var read = await socket.ReceiveAsync(single, SocketFlags.None, ct);
if (read == 0)
break;
if (single[0] == (byte)'\n')
break;
if (single[0] != (byte)'\r')
bytes.Add(single[0]);
}
return Encoding.ASCII.GetString([.. bytes]);
}
private static Task WriteLineAsync(Socket socket, string line, CancellationToken ct)
=> socket.SendAsync(Encoding.ASCII.GetBytes($"{line}\r\n"), SocketFlags.None, ct).AsTask();
}
/// <summary>
/// Shared fixture for gateway connection tests that need two running server clusters.
/// </summary>
internal sealed class GatewayConnectionFixture : IAsyncDisposable
{
private readonly CancellationTokenSource _localCts;
private readonly CancellationTokenSource _remoteCts;
private GatewayConnectionFixture(NatsServer local, NatsServer remote, CancellationTokenSource localCts, CancellationTokenSource remoteCts)
{
Local = local;
Remote = remote;
_localCts = localCts;
_remoteCts = remoteCts;
}
public NatsServer Local { get; }
public NatsServer Remote { get; }
public static async Task<GatewayConnectionFixture> StartAsync()
{
var localOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Gateway = new GatewayOptions
{
Name = "LOCAL",
Host = "127.0.0.1",
Port = 0,
},
};
var local = new NatsServer(localOptions, NullLoggerFactory.Instance);
var localCts = new CancellationTokenSource();
_ = local.StartAsync(localCts.Token);
await local.WaitForReadyAsync();
var remoteOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Gateway = new GatewayOptions
{
Name = "REMOTE",
Host = "127.0.0.1",
Port = 0,
Remotes = [local.GatewayListen!],
},
};
var remote = new NatsServer(remoteOptions, NullLoggerFactory.Instance);
var remoteCts = new CancellationTokenSource();
_ = remote.StartAsync(remoteCts.Token);
await remote.WaitForReadyAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested && (local.Stats.Gateways == 0 || remote.Stats.Gateways == 0))
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
return new GatewayConnectionFixture(local, remote, localCts, remoteCts);
}
public async Task WaitForRemoteInterestOnLocalAsync(string subject)
{
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested)
{
if (Local.HasRemoteInterest(subject))
return;
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
}
throw new TimeoutException($"Timed out waiting for remote interest on '{subject}'.");
}
public async ValueTask DisposeAsync()
{
await _localCts.CancelAsync();
await _remoteCts.CancelAsync();
Local.Dispose();
Remote.Dispose();
_localCts.Dispose();
_remoteCts.Dispose();
}
}

View File

@@ -0,0 +1,775 @@
using System.Net;
using System.Net.Sockets;
using System.Text;
using Microsoft.Extensions.Logging.Abstractions;
using NATS.Client.Core;
using NATS.Server.Auth;
using NATS.Server.Configuration;
using NATS.Server.Gateways;
using NATS.Server.Subscriptions;
namespace NATS.Server.Tests.Gateways;
/// <summary>
/// Gateway message forwarding, reply mapping, queue subscription delivery,
/// and cross-cluster pub/sub tests.
/// Ported from golang/nats-server/server/gateway_test.go.
/// </summary>
public class GatewayForwardingTests
{
// ── Basic Message Forwarding ────────────────────────────────────────
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Message_published_on_local_arrives_at_remote_subscriber()
{
await using var fixture = await ForwardingFixture.StartAsync();
await using var subscriber = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await subscriber.ConnectAsync();
await using var publisher = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await publisher.ConnectAsync();
await using var sub = await subscriber.SubscribeCoreAsync<string>("fwd.test");
await subscriber.PingAsync();
await fixture.WaitForRemoteInterestOnLocalAsync("fwd.test");
await publisher.PublishAsync("fwd.test", "hello-world");
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var msg = await sub.Msgs.ReadAsync(timeout.Token);
msg.Data.ShouldBe("hello-world");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Message_published_on_remote_arrives_at_local_subscriber()
{
await using var fixture = await ForwardingFixture.StartAsync();
await using var subscriber = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await subscriber.ConnectAsync();
await using var publisher = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await publisher.ConnectAsync();
await using var sub = await subscriber.SubscribeCoreAsync<string>("fwd.reverse");
await subscriber.PingAsync();
await fixture.WaitForRemoteInterestOnRemoteAsync("fwd.reverse");
await publisher.PublishAsync("fwd.reverse", "reverse-msg");
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var msg = await sub.Msgs.ReadAsync(timeout.Token);
msg.Data.ShouldBe("reverse-msg");
}
// Go: TestGatewayMsgSentOnlyOnce server/gateway_test.go:2993
[Fact]
public async Task Message_forwarded_only_once_to_remote_subscriber()
{
await using var fixture = await ForwardingFixture.StartAsync();
await using var subscriber = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await subscriber.ConnectAsync();
await using var publisher = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await publisher.ConnectAsync();
await using var sub = await subscriber.SubscribeCoreAsync<string>("once.test");
await subscriber.PingAsync();
await fixture.WaitForRemoteInterestOnLocalAsync("once.test");
await publisher.PublishAsync("once.test", "exactly-once");
await publisher.PingAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(3));
var msg = await sub.Msgs.ReadAsync(timeout.Token);
msg.Data.ShouldBe("exactly-once");
// Wait and verify no duplicates
await Task.Delay(300);
using var noMoreTimeout = new CancellationTokenSource(TimeSpan.FromMilliseconds(300));
await Should.ThrowAsync<OperationCanceledException>(async () =>
await sub.Msgs.ReadAsync(noMoreTimeout.Token));
}
// Go: TestGatewaySendsToNonLocalSubs server/gateway_test.go:3140
[Fact]
public async Task Message_without_local_subscriber_forwarded_to_remote()
{
await using var fixture = await ForwardingFixture.StartAsync();
await using var subscriber = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await subscriber.ConnectAsync();
await using var publisher = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await publisher.ConnectAsync();
// Subscribe only on remote, no local subscriber
await using var sub = await subscriber.SubscribeCoreAsync<string>("only.remote");
await subscriber.PingAsync();
await fixture.WaitForRemoteInterestOnLocalAsync("only.remote");
await publisher.PublishAsync("only.remote", "no-local");
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var msg = await sub.Msgs.ReadAsync(timeout.Token);
msg.Data.ShouldBe("no-local");
}
// Go: TestGatewayDoesntSendBackToItself server/gateway_test.go:2150
[Fact]
public async Task Both_local_and_remote_subscribers_receive_message_published_locally()
{
await using var fixture = await ForwardingFixture.StartAsync();
await using var remoteConn = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await remoteConn.ConnectAsync();
await using var localConn = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await localConn.ConnectAsync();
await using var remoteSub = await remoteConn.SubscribeCoreAsync<string>("both.test");
await remoteConn.PingAsync();
await using var localSub = await localConn.SubscribeCoreAsync<string>("both.test");
await localConn.PingAsync();
await fixture.WaitForRemoteInterestOnLocalAsync("both.test");
await localConn.PublishAsync("both.test", "shared");
await localConn.PingAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var localMsg = await localSub.Msgs.ReadAsync(timeout.Token);
localMsg.Data.ShouldBe("shared");
var remoteMsg = await remoteSub.Msgs.ReadAsync(timeout.Token);
remoteMsg.Data.ShouldBe("shared");
}
// ── Wildcard Subject Forwarding ─────────────────────────────────────
// Go: TestGatewaySubjectInterest server/gateway_test.go:1972
[Fact]
public async Task Wildcard_subscription_receives_matching_gateway_messages()
{
await using var fixture = await ForwardingFixture.StartAsync();
await using var subscriber = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await subscriber.ConnectAsync();
await using var publisher = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await publisher.ConnectAsync();
await using var sub = await subscriber.SubscribeCoreAsync<string>("wc.>");
await subscriber.PingAsync();
await fixture.WaitForRemoteInterestOnLocalAsync("wc.test.one");
await publisher.PublishAsync("wc.test.one", "wildcard-msg");
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var msg = await sub.Msgs.ReadAsync(timeout.Token);
msg.Subject.ShouldBe("wc.test.one");
msg.Data.ShouldBe("wildcard-msg");
}
// Go: TestGatewaySubjectInterest server/gateway_test.go:1972
[Fact]
public async Task Partial_wildcard_subscription_receives_gateway_messages()
{
await using var fixture = await ForwardingFixture.StartAsync();
await using var subscriber = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await subscriber.ConnectAsync();
await using var publisher = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await publisher.ConnectAsync();
await using var sub = await subscriber.SubscribeCoreAsync<string>("orders.*");
await subscriber.PingAsync();
await fixture.WaitForRemoteInterestOnLocalAsync("orders.created");
await publisher.PublishAsync("orders.created", "order-1");
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var msg = await sub.Msgs.ReadAsync(timeout.Token);
msg.Subject.ShouldBe("orders.created");
msg.Data.ShouldBe("order-1");
}
// ── Reply Subject Mapping (_GR_. Prefix) ────────────────────────────
// Go: TestGatewaySendReplyAcrossGateways server/gateway_test.go:5165
[Fact]
public void Reply_mapper_adds_gr_prefix_with_cluster_id()
{
var mapped = ReplyMapper.ToGatewayReply("_INBOX.abc", "CLUSTER-A");
mapped.ShouldNotBeNull();
mapped.ShouldStartWith("_GR_.");
mapped.ShouldContain("CLUSTER-A");
}
// Go: TestGatewaySendReplyAcrossGateways server/gateway_test.go:5165
[Fact]
public void Reply_mapper_restores_original_reply()
{
var original = "_INBOX.abc123";
var mapped = ReplyMapper.ToGatewayReply(original, "C1");
mapped.ShouldNotBeNull();
ReplyMapper.TryRestoreGatewayReply(mapped, out var restored).ShouldBeTrue();
restored.ShouldBe(original);
}
// Go: TestGatewaySendReplyAcrossGateways server/gateway_test.go:5165
[Fact]
public void Reply_mapper_handles_nested_gr_prefixes()
{
var original = "_INBOX.reply1";
var once = ReplyMapper.ToGatewayReply(original, "CLUSTER-A");
var twice = ReplyMapper.ToGatewayReply(once, "CLUSTER-B");
ReplyMapper.TryRestoreGatewayReply(twice!, out var restored).ShouldBeTrue();
restored.ShouldBe(original);
}
// Go: TestGatewayClientsDontReceiveMsgsOnGWPrefix server/gateway_test.go:5586
[Fact]
public void Reply_mapper_returns_null_for_null_input()
{
var result = ReplyMapper.ToGatewayReply(null, "CLUSTER");
result.ShouldBeNull();
}
// Go: TestGatewayClientsDontReceiveMsgsOnGWPrefix server/gateway_test.go:5586
[Fact]
public void Reply_mapper_returns_empty_for_empty_input()
{
var result = ReplyMapper.ToGatewayReply("", "CLUSTER");
result.ShouldBe("");
}
// Go: TestGatewayClientsDontReceiveMsgsOnGWPrefix server/gateway_test.go:5586
[Fact]
public void Has_gateway_reply_prefix_detects_gr_prefix()
{
ReplyMapper.HasGatewayReplyPrefix("_GR_.CLUSTER.inbox").ShouldBeTrue();
ReplyMapper.HasGatewayReplyPrefix("_INBOX.abc").ShouldBeFalse();
ReplyMapper.HasGatewayReplyPrefix(null).ShouldBeFalse();
ReplyMapper.HasGatewayReplyPrefix("").ShouldBeFalse();
}
// Go: TestGatewaySendReplyAcrossGateways server/gateway_test.go:5165
[Fact]
public void Restore_returns_false_for_non_gr_subject()
{
ReplyMapper.TryRestoreGatewayReply("_INBOX.abc", out _).ShouldBeFalse();
}
// Go: TestGatewayReplyMapTracking server/gateway_test.go:6017
[Fact]
public void Restore_returns_false_for_malformed_gr_subject()
{
// _GR_. with no cluster separator
ReplyMapper.TryRestoreGatewayReply("_GR_.nodot", out _).ShouldBeFalse();
}
// Go: TestGatewayReplyMapTracking server/gateway_test.go:6017
[Fact]
public void Restore_returns_false_for_gr_prefix_with_nothing_after_separator()
{
ReplyMapper.TryRestoreGatewayReply("_GR_.CLUSTER.", out _).ShouldBeFalse();
}
// ── Queue Subscription Forwarding ───────────────────────────────────
// Go: TestGatewayQueueSub server/gateway_test.go:2265
[Fact]
public async Task Queue_subscription_interest_tracked_on_remote()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("foo", "bar", "gw1", "$G"));
subList.HasRemoteInterest("$G", "foo").ShouldBeTrue();
subList.MatchRemote("$G", "foo").Count.ShouldBe(1);
}
// Go: TestGatewayQueueSub server/gateway_test.go:2265
[Fact]
public async Task Queue_subscription_with_multiple_groups_all_tracked()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("foo", "bar", "gw1", "$G"));
subList.ApplyRemoteSub(new RemoteSubscription("foo", "baz", "gw1", "$G"));
subList.MatchRemote("$G", "foo").Count.ShouldBe(2);
}
// Go: TestGatewayQueueSub server/gateway_test.go:2265
[Fact]
public async Task Queue_sub_removal_clears_remote_interest()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("foo", "bar", "gw1", "$G"));
subList.HasRemoteInterest("$G", "foo").ShouldBeTrue();
subList.ApplyRemoteSub(RemoteSubscription.Removal("foo", "bar", "gw1", "$G"));
subList.HasRemoteInterest("$G", "foo").ShouldBeFalse();
}
// ── GatewayManager Forwarding ───────────────────────────────────────
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_manager_forward_message_increments_js_counter()
{
var manager = new GatewayManager(
new GatewayOptions { Name = "GW", Host = "127.0.0.1", Port = 0 },
new ServerStats(),
"S1",
_ => { },
_ => { },
NullLogger<GatewayManager>.Instance);
await manager.ForwardJetStreamClusterMessageAsync(
new GatewayMessage("$JS.CLUSTER.test", null, "x"u8.ToArray()),
default);
manager.ForwardedJetStreamClusterMessages.ShouldBe(1);
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public async Task Gateway_manager_forward_js_message_multiple_times()
{
var manager = new GatewayManager(
new GatewayOptions { Name = "GW", Host = "127.0.0.1", Port = 0 },
new ServerStats(),
"S1",
_ => { },
_ => { },
NullLogger<GatewayManager>.Instance);
for (int i = 0; i < 5; i++)
{
await manager.ForwardJetStreamClusterMessageAsync(
new GatewayMessage("$JS.CLUSTER.test", null, "x"u8.ToArray()),
default);
}
manager.ForwardedJetStreamClusterMessages.ShouldBe(5);
}
// ── Multiple Messages ───────────────────────────────────────────────
// Go: TestGatewayMsgSentOnlyOnce server/gateway_test.go:2993
[Fact]
public async Task Multiple_messages_forwarded_across_gateway()
{
await using var fixture = await ForwardingFixture.StartAsync();
await using var subscriber = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await subscriber.ConnectAsync();
await using var publisher = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await publisher.ConnectAsync();
await using var sub = await subscriber.SubscribeCoreAsync<string>("multi.test");
await subscriber.PingAsync();
await fixture.WaitForRemoteInterestOnLocalAsync("multi.test");
const int count = 10;
for (int i = 0; i < count; i++)
{
await publisher.PublishAsync("multi.test", $"msg-{i}");
}
await publisher.PingAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(10));
var received = new List<string>();
for (int i = 0; i < count; i++)
{
var msg = await sub.Msgs.ReadAsync(timeout.Token);
received.Add(msg.Data!);
}
received.Count.ShouldBe(count);
for (int i = 0; i < count; i++)
{
received.ShouldContain($"msg-{i}");
}
}
// Go: TestGatewayAccountUnsub server/gateway_test.go:1912
// Verifies that a message published on local with a reply-to subject is forwarded
// to the remote with the reply-to intact, allowing manual request-reply across gateway.
[Fact]
public async Task Message_with_reply_to_forwarded_across_gateway()
{
await using var fixture = await ForwardingFixture.StartAsync();
await using var remoteConn = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await remoteConn.ConnectAsync();
// Subscribe on remote for requests
await using var sub = await remoteConn.SubscribeCoreAsync<string>("svc.request");
await remoteConn.PingAsync();
await fixture.WaitForRemoteInterestOnLocalAsync("svc.request");
// Publish from local with a reply-to subject via raw socket
using var sock = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
await sock.ConnectAsync(IPAddress.Loopback, fixture.Local.Port);
var infoBuf = new byte[4096];
_ = await sock.ReceiveAsync(infoBuf); // read INFO
await sock.SendAsync(Encoding.ASCII.GetBytes(
"CONNECT {}\r\nPUB svc.request _INBOX.reply123 12\r\nrequest-data\r\nPING\r\n"));
// Wait for PONG to confirm the message was processed
var pongBuf = new byte[4096];
var pongTotal = new StringBuilder();
using var pongCts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!pongTotal.ToString().Contains("PONG"))
{
var n = await sock.ReceiveAsync(pongBuf, SocketFlags.None, pongCts.Token);
if (n == 0) break;
pongTotal.Append(Encoding.ASCII.GetString(pongBuf, 0, n));
}
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(10));
var msg = await sub.Msgs.ReadAsync(timeout.Token);
msg.Data.ShouldBe("request-data");
msg.ReplyTo.ShouldNotBeNullOrEmpty();
}
// ── Account Scoped Forwarding ───────────────────────────────────────
// Go: TestGatewayAccountInterest server/gateway_test.go:1794
[Fact]
public async Task Messages_forwarded_within_same_account_only()
{
var users = new User[]
{
new() { Username = "user_a", Password = "pass", Account = "ACCT_A" },
new() { Username = "user_b", Password = "pass", Account = "ACCT_B" },
};
await using var fixture = await ForwardingFixture.StartWithUsersAsync(users);
await using var remoteA = new NatsConnection(new NatsOpts
{
Url = $"nats://user_a:pass@127.0.0.1:{fixture.Remote.Port}",
});
await remoteA.ConnectAsync();
await using var remoteB = new NatsConnection(new NatsOpts
{
Url = $"nats://user_b:pass@127.0.0.1:{fixture.Remote.Port}",
});
await remoteB.ConnectAsync();
await using var publisherA = new NatsConnection(new NatsOpts
{
Url = $"nats://user_a:pass@127.0.0.1:{fixture.Local.Port}",
});
await publisherA.ConnectAsync();
await using var subA = await remoteA.SubscribeCoreAsync<string>("acct.test");
await using var subB = await remoteB.SubscribeCoreAsync<string>("acct.test");
await remoteA.PingAsync();
await remoteB.PingAsync();
await fixture.WaitForRemoteInterestOnLocalAsync("ACCT_A", "acct.test");
await publisherA.PublishAsync("acct.test", "for-account-a");
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var msgA = await subA.Msgs.ReadAsync(timeout.Token);
msgA.Data.ShouldBe("for-account-a");
// Account B should not receive
using var noMsgTimeout = new CancellationTokenSource(TimeSpan.FromMilliseconds(500));
await Should.ThrowAsync<OperationCanceledException>(async () =>
await subB.Msgs.ReadAsync(noMsgTimeout.Token));
}
// Go: TestGatewayAccountInterest server/gateway_test.go:1794
[Fact]
public async Task Non_matching_subject_not_forwarded_after_interest_established()
{
await using var fixture = await ForwardingFixture.StartAsync();
await using var subscriber = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await subscriber.ConnectAsync();
await using var publisher = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await publisher.ConnectAsync();
// Subscribe to a specific subject
await using var sub = await subscriber.SubscribeCoreAsync<string>("specific.topic");
await subscriber.PingAsync();
await fixture.WaitForRemoteInterestOnLocalAsync("specific.topic");
// Publish to a different subject
await publisher.PublishAsync("other.topic", "should-not-arrive");
await publisher.PingAsync();
await Task.Delay(300);
using var noMsgTimeout = new CancellationTokenSource(TimeSpan.FromMilliseconds(300));
await Should.ThrowAsync<OperationCanceledException>(async () =>
await sub.Msgs.ReadAsync(noMsgTimeout.Token));
}
// Go: TestGatewayNoCrashOnInvalidSubject server/gateway_test.go:6279
[Fact]
public void GatewayMessage_record_stores_all_fields()
{
var payload = new byte[] { 1, 2, 3 };
var msg = new GatewayMessage("test.subject", "_INBOX.reply", payload, "MYACCT");
msg.Subject.ShouldBe("test.subject");
msg.ReplyTo.ShouldBe("_INBOX.reply");
msg.Payload.Length.ShouldBe(3);
msg.Account.ShouldBe("MYACCT");
}
// Go: TestGatewayBasic server/gateway_test.go:399
[Fact]
public void GatewayMessage_defaults_account_to_global()
{
var msg = new GatewayMessage("test.subject", null, new byte[] { });
msg.Account.ShouldBe("$G");
}
// ── Interest-Only Mode and ShouldForwardInterestOnly ────────────────
// Go: TestGatewaySwitchToInterestOnlyModeImmediately server/gateway_test.go:6934
[Fact]
public void Should_forward_interest_only_returns_true_when_interest_exists()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("orders.>", null, "gw1", "A"));
GatewayManager.ShouldForwardInterestOnly(subList, "A", "orders.created").ShouldBeTrue();
}
// Go: TestGatewaySwitchToInterestOnlyModeImmediately server/gateway_test.go:6934
[Fact]
public void Should_forward_interest_only_returns_false_without_interest()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("orders.>", null, "gw1", "A"));
GatewayManager.ShouldForwardInterestOnly(subList, "A", "payments.created").ShouldBeFalse();
}
// Go: TestGatewaySwitchToInterestOnlyModeImmediately server/gateway_test.go:6934
[Fact]
public void Should_forward_interest_only_for_different_account_returns_false()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("orders.>", null, "gw1", "A"));
GatewayManager.ShouldForwardInterestOnly(subList, "B", "orders.created").ShouldBeFalse();
}
// Go: TestGatewaySubjectInterest server/gateway_test.go:1972
[Fact]
public void Should_forward_with_wildcard_interest()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("test.*", null, "gw1", "$G"));
GatewayManager.ShouldForwardInterestOnly(subList, "$G", "test.one").ShouldBeTrue();
GatewayManager.ShouldForwardInterestOnly(subList, "$G", "test.two").ShouldBeTrue();
GatewayManager.ShouldForwardInterestOnly(subList, "$G", "other.one").ShouldBeFalse();
}
// Go: TestGatewaySubjectInterest server/gateway_test.go:1972
[Fact]
public void Should_forward_with_fwc_interest()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("events.>", null, "gw1", "$G"));
GatewayManager.ShouldForwardInterestOnly(subList, "$G", "events.a.b.c").ShouldBeTrue();
GatewayManager.ShouldForwardInterestOnly(subList, "$G", "other.x").ShouldBeFalse();
}
}
/// <summary>
/// Shared fixture for forwarding tests that need two running server clusters.
/// </summary>
internal sealed class ForwardingFixture : IAsyncDisposable
{
private readonly CancellationTokenSource _localCts;
private readonly CancellationTokenSource _remoteCts;
private ForwardingFixture(NatsServer local, NatsServer remote, CancellationTokenSource localCts, CancellationTokenSource remoteCts)
{
Local = local;
Remote = remote;
_localCts = localCts;
_remoteCts = remoteCts;
}
public NatsServer Local { get; }
public NatsServer Remote { get; }
public static Task<ForwardingFixture> StartAsync()
=> StartWithUsersAsync(null);
public static async Task<ForwardingFixture> StartWithUsersAsync(IReadOnlyList<User>? users)
{
var localOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Users = users,
Gateway = new GatewayOptions
{
Name = "LOCAL",
Host = "127.0.0.1",
Port = 0,
},
};
var local = new NatsServer(localOptions, NullLoggerFactory.Instance);
var localCts = new CancellationTokenSource();
_ = local.StartAsync(localCts.Token);
await local.WaitForReadyAsync();
var remoteOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Users = users,
Gateway = new GatewayOptions
{
Name = "REMOTE",
Host = "127.0.0.1",
Port = 0,
Remotes = [local.GatewayListen!],
},
};
var remote = new NatsServer(remoteOptions, NullLoggerFactory.Instance);
var remoteCts = new CancellationTokenSource();
_ = remote.StartAsync(remoteCts.Token);
await remote.WaitForReadyAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested && (local.Stats.Gateways == 0 || remote.Stats.Gateways == 0))
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
return new ForwardingFixture(local, remote, localCts, remoteCts);
}
public async Task WaitForRemoteInterestOnLocalAsync(string subject)
{
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested)
{
if (Local.HasRemoteInterest(subject))
return;
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
}
throw new TimeoutException($"Timed out waiting for remote interest on '{subject}'.");
}
public async Task WaitForRemoteInterestOnLocalAsync(string account, string subject)
{
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested)
{
if (Local.HasRemoteInterest(account, subject))
return;
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
}
throw new TimeoutException($"Timed out waiting for remote interest {account}:{subject}.");
}
public async Task WaitForRemoteInterestOnRemoteAsync(string subject)
{
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested)
{
if (Remote.HasRemoteInterest(subject))
return;
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
}
throw new TimeoutException($"Timed out waiting for remote interest on '{subject}'.");
}
public async ValueTask DisposeAsync()
{
await _localCts.CancelAsync();
await _remoteCts.CancelAsync();
Local.Dispose();
Remote.Dispose();
_localCts.Dispose();
_remoteCts.Dispose();
}
}

View File

@@ -0,0 +1,576 @@
using System.Net;
using System.Net.Sockets;
using System.Text;
using Microsoft.Extensions.Logging.Abstractions;
using NATS.Client.Core;
using NATS.Server.Auth;
using NATS.Server.Configuration;
using NATS.Server.Gateways;
using NATS.Server.Subscriptions;
namespace NATS.Server.Tests.Gateways;
/// <summary>
/// Gateway interest-only mode, account interest, subject interest propagation,
/// and subscription lifecycle tests.
/// Ported from golang/nats-server/server/gateway_test.go.
/// </summary>
public class GatewayInterestModeTests
{
// ── Remote Interest Tracking via SubList ─────────────────────────────
// Go: TestGatewayAccountInterest server/gateway_test.go:1794
[Fact]
public void Remote_interest_tracked_for_literal_subject()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("orders.created", null, "gw1", "$G"));
subList.HasRemoteInterest("$G", "orders.created").ShouldBeTrue();
subList.HasRemoteInterest("$G", "orders.updated").ShouldBeFalse();
}
// Go: TestGatewayAccountInterest server/gateway_test.go:1794
[Fact]
public void Remote_interest_tracked_for_wildcard_subject()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("orders.*", null, "gw1", "$G"));
subList.HasRemoteInterest("$G", "orders.created").ShouldBeTrue();
subList.HasRemoteInterest("$G", "orders.updated").ShouldBeTrue();
subList.HasRemoteInterest("$G", "orders.deep.nested").ShouldBeFalse();
}
// Go: TestGatewayAccountInterest server/gateway_test.go:1794
[Fact]
public void Remote_interest_tracked_for_fwc_subject()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("events.>", null, "gw1", "$G"));
subList.HasRemoteInterest("$G", "events.one").ShouldBeTrue();
subList.HasRemoteInterest("$G", "events.one.two.three").ShouldBeTrue();
subList.HasRemoteInterest("$G", "other").ShouldBeFalse();
}
// Go: TestGatewayAccountInterest server/gateway_test.go:1794
[Fact]
public void Remote_interest_scoped_to_account()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("orders.>", null, "gw1", "ACCT_A"));
subList.HasRemoteInterest("ACCT_A", "orders.created").ShouldBeTrue();
subList.HasRemoteInterest("ACCT_B", "orders.created").ShouldBeFalse();
subList.HasRemoteInterest("$G", "orders.created").ShouldBeFalse();
}
// Go: TestGatewayAccountUnsub server/gateway_test.go:1912
[Fact]
public void Remote_interest_removed_on_aminus()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("orders.>", null, "gw1", "$G"));
subList.HasRemoteInterest("$G", "orders.created").ShouldBeTrue();
subList.ApplyRemoteSub(RemoteSubscription.Removal("orders.>", null, "gw1", "$G"));
subList.HasRemoteInterest("$G", "orders.created").ShouldBeFalse();
}
// Go: TestGatewayAccountInterest server/gateway_test.go:1794
[Fact]
public void Multiple_remote_interests_from_different_routes()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("orders.*", null, "gw1", "$G"));
subList.ApplyRemoteSub(new RemoteSubscription("orders.*", null, "gw2", "$G"));
subList.HasRemoteInterest("$G", "orders.created").ShouldBeTrue();
subList.MatchRemote("$G", "orders.created").Count.ShouldBe(2);
}
// Go: TestGatewayAccountUnsub server/gateway_test.go:1912
[Fact]
public void Removing_one_route_interest_keeps_other()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("orders.*", null, "gw1", "$G"));
subList.ApplyRemoteSub(new RemoteSubscription("orders.*", null, "gw2", "$G"));
subList.ApplyRemoteSub(RemoteSubscription.Removal("orders.*", null, "gw1", "$G"));
subList.HasRemoteInterest("$G", "orders.created").ShouldBeTrue();
subList.MatchRemote("$G", "orders.created").Count.ShouldBe(1);
}
// ── Interest Change Events ──────────────────────────────────────────
// Go: TestGatewaySwitchToInterestOnlyModeImmediately server/gateway_test.go:6934
[Fact]
public void Interest_change_event_fired_on_remote_add()
{
using var subList = new SubList();
var changes = new List<InterestChange>();
subList.InterestChanged += change => changes.Add(change);
subList.ApplyRemoteSub(new RemoteSubscription("test.>", null, "gw1", "$G"));
changes.Count.ShouldBe(1);
changes[0].Kind.ShouldBe(InterestChangeKind.RemoteAdded);
changes[0].Subject.ShouldBe("test.>");
changes[0].Account.ShouldBe("$G");
}
// Go: TestGatewayAccountUnsub server/gateway_test.go:1912
[Fact]
public void Interest_change_event_fired_on_remote_remove()
{
using var subList = new SubList();
var changes = new List<InterestChange>();
subList.InterestChanged += change => changes.Add(change);
subList.ApplyRemoteSub(new RemoteSubscription("test.>", null, "gw1", "$G"));
subList.ApplyRemoteSub(RemoteSubscription.Removal("test.>", null, "gw1", "$G"));
changes.Count.ShouldBe(2);
changes[1].Kind.ShouldBe(InterestChangeKind.RemoteRemoved);
}
// Go: TestGatewaySwitchToInterestOnlyModeImmediately server/gateway_test.go:6934
[Fact]
public void Duplicate_remote_add_does_not_fire_extra_event()
{
using var subList = new SubList();
var addCount = 0;
subList.InterestChanged += change =>
{
if (change.Kind == InterestChangeKind.RemoteAdded)
addCount++;
};
subList.ApplyRemoteSub(new RemoteSubscription("test.>", null, "gw1", "$G"));
subList.ApplyRemoteSub(new RemoteSubscription("test.>", null, "gw1", "$G"));
addCount.ShouldBe(1);
}
// Go: TestGatewayAccountUnsub server/gateway_test.go:1912
[Fact]
public void Remove_nonexistent_subscription_does_not_fire_event()
{
using var subList = new SubList();
var removeCount = 0;
subList.InterestChanged += change =>
{
if (change.Kind == InterestChangeKind.RemoteRemoved)
removeCount++;
};
subList.ApplyRemoteSub(RemoteSubscription.Removal("nonexistent", null, "gw1", "$G"));
removeCount.ShouldBe(0);
}
// ── Queue Weight in MatchRemote ─────────────────────────────────────
// Go: TestGatewayTotalQSubs server/gateway_test.go:2484
[Fact]
public void Match_remote_expands_queue_weight()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("foo", "bar", "gw1", "$G", QueueWeight: 3));
var matches = subList.MatchRemote("$G", "foo");
matches.Count.ShouldBe(3);
}
// Go: TestGatewayTotalQSubs server/gateway_test.go:2484
[Fact]
public void Match_remote_default_weight_is_one()
{
using var subList = new SubList();
subList.ApplyRemoteSub(new RemoteSubscription("foo", "bar", "gw1", "$G"));
var matches = subList.MatchRemote("$G", "foo");
matches.Count.ShouldBe(1);
}
// ── End-to-End Interest Propagation via Gateway ─────────────────────
// Go: TestGatewayDontSendSubInterest server/gateway_test.go:1755
[Fact]
public async Task Local_subscription_propagated_to_remote_via_gateway()
{
await using var fixture = await InterestModeFixture.StartAsync();
await using var localConn = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await localConn.ConnectAsync();
await using var sub = await localConn.SubscribeCoreAsync<string>("prop.test");
await localConn.PingAsync();
// The remote server should see the interest
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested && !fixture.Remote.HasRemoteInterest("prop.test"))
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
fixture.Remote.HasRemoteInterest("prop.test").ShouldBeTrue();
}
// Go: TestGatewayAccountUnsub server/gateway_test.go:1912
[Fact]
public async Task Unsubscribe_propagated_to_remote_via_gateway()
{
await using var fixture = await InterestModeFixture.StartAsync();
await using var localConn = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Local.Port}",
});
await localConn.ConnectAsync();
var sub = await localConn.SubscribeCoreAsync<string>("unsub.test");
await localConn.PingAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested && !fixture.Remote.HasRemoteInterest("unsub.test"))
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
fixture.Remote.HasRemoteInterest("unsub.test").ShouldBeTrue();
// Unsubscribe
await sub.DisposeAsync();
await localConn.PingAsync();
// Wait for interest to be removed
using var unsubTimeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!unsubTimeout.IsCancellationRequested && fixture.Remote.HasRemoteInterest("unsub.test"))
await Task.Delay(50, unsubTimeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
fixture.Remote.HasRemoteInterest("unsub.test").ShouldBeFalse();
}
// Go: TestGatewaySubjectInterest server/gateway_test.go:1972
[Fact]
public async Task Remote_wildcard_subscription_establishes_interest()
{
await using var fixture = await InterestModeFixture.StartAsync();
await using var remoteConn = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await remoteConn.ConnectAsync();
await using var sub = await remoteConn.SubscribeCoreAsync<string>("interest.>");
await remoteConn.PingAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested && !fixture.Local.HasRemoteInterest("interest.test"))
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
fixture.Local.HasRemoteInterest("interest.test").ShouldBeTrue();
fixture.Local.HasRemoteInterest("interest.deep.nested").ShouldBeTrue();
}
// Go: TestGatewayDontSendSubInterest server/gateway_test.go:1755
[Fact]
public async Task Multiple_subscribers_same_subject_produces_single_interest()
{
await using var fixture = await InterestModeFixture.StartAsync();
await using var conn1 = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await conn1.ConnectAsync();
await using var conn2 = new NatsConnection(new NatsOpts
{
Url = $"nats://127.0.0.1:{fixture.Remote.Port}",
});
await conn2.ConnectAsync();
await using var sub1 = await conn1.SubscribeCoreAsync<string>("multi.interest");
await using var sub2 = await conn2.SubscribeCoreAsync<string>("multi.interest");
await conn1.PingAsync();
await conn2.PingAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested && !fixture.Local.HasRemoteInterest("multi.interest"))
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
fixture.Local.HasRemoteInterest("multi.interest").ShouldBeTrue();
}
// Go: TestGatewayAccountInterest server/gateway_test.go:1794
[Fact]
public async Task Account_scoped_interest_propagated_via_gateway()
{
var users = new User[]
{
new() { Username = "acct_user", Password = "pass", Account = "MYACCT" },
};
await using var fixture = await InterestModeFixture.StartWithUsersAsync(users);
await using var conn = new NatsConnection(new NatsOpts
{
Url = $"nats://acct_user:pass@127.0.0.1:{fixture.Remote.Port}",
});
await conn.ConnectAsync();
await using var sub = await conn.SubscribeCoreAsync<string>("acct.interest");
await conn.PingAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested && !fixture.Local.HasRemoteInterest("MYACCT", "acct.interest"))
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
fixture.Local.HasRemoteInterest("MYACCT", "acct.interest").ShouldBeTrue();
}
// ── RemoteSubscription Record Tests ─────────────────────────────────
// Go: TestGatewayAccountInterest server/gateway_test.go:1794
[Fact]
public void RemoteSubscription_record_equality()
{
var a = new RemoteSubscription("foo", null, "gw1", "$G");
var b = new RemoteSubscription("foo", null, "gw1", "$G");
a.ShouldBe(b);
}
// Go: TestGatewayAccountInterest server/gateway_test.go:1794
[Fact]
public void RemoteSubscription_removal_factory()
{
var removal = RemoteSubscription.Removal("foo", "bar", "gw1", "$G");
removal.IsRemoval.ShouldBeTrue();
removal.Subject.ShouldBe("foo");
removal.Queue.ShouldBe("bar");
removal.RouteId.ShouldBe("gw1");
}
// Go: TestGatewayAccountInterest server/gateway_test.go:1794
[Fact]
public void RemoteSubscription_default_account_is_global()
{
var sub = new RemoteSubscription("foo", null, "gw1");
sub.Account.ShouldBe("$G");
}
// Go: TestGatewayTotalQSubs server/gateway_test.go:2484
[Fact]
public void RemoteSubscription_default_queue_weight_is_one()
{
var sub = new RemoteSubscription("foo", "bar", "gw1");
sub.QueueWeight.ShouldBe(1);
}
// Go: TestGatewayAccountUnsub server/gateway_test.go:1912
[Fact]
public void RemoteSubscription_default_is_not_removal()
{
var sub = new RemoteSubscription("foo", null, "gw1");
sub.IsRemoval.ShouldBeFalse();
}
// ── Subscription Propagation by GatewayManager ──────────────────────
// Go: TestGatewayDontSendSubInterest server/gateway_test.go:1755
[Fact]
public async Task Gateway_manager_propagate_subscription_sends_aplus()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
var options = new GatewayOptions
{
Name = "LOCAL",
Host = "127.0.0.1",
Port = 0,
Remotes = [$"127.0.0.1:{port}"],
};
var manager = new GatewayManager(
options,
new ServerStats(),
"SERVER1",
_ => { },
_ => { },
NullLogger<GatewayManager>.Instance);
await manager.StartAsync(CancellationToken.None);
// Accept the connection from gateway manager
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
using var gwSocket = await listener.AcceptSocketAsync(cts.Token);
// Exchange handshakes
var line = await ReadLineAsync(gwSocket, cts.Token);
line.ShouldStartWith("GATEWAY ");
await WriteLineAsync(gwSocket, "GATEWAY REMOTE1", cts.Token);
// Wait for connection to be registered
await Task.Delay(200);
// Propagate a subscription
manager.PropagateLocalSubscription("$G", "orders.>", null);
// Read the A+ message
await Task.Delay(100);
var aplusLine = await ReadLineAsync(gwSocket, cts.Token);
aplusLine.ShouldBe("A+ $G orders.>");
await manager.DisposeAsync();
}
// Go: TestGatewayAccountUnsub server/gateway_test.go:1912
[Fact]
public async Task Gateway_manager_propagate_unsubscription_sends_aminus()
{
using var listener = new TcpListener(IPAddress.Loopback, 0);
listener.Start();
var port = ((IPEndPoint)listener.LocalEndpoint).Port;
var options = new GatewayOptions
{
Name = "LOCAL",
Host = "127.0.0.1",
Port = 0,
Remotes = [$"127.0.0.1:{port}"],
};
var manager = new GatewayManager(
options,
new ServerStats(),
"SERVER1",
_ => { },
_ => { },
NullLogger<GatewayManager>.Instance);
await manager.StartAsync(CancellationToken.None);
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
using var gwSocket = await listener.AcceptSocketAsync(cts.Token);
var line = await ReadLineAsync(gwSocket, cts.Token);
line.ShouldStartWith("GATEWAY ");
await WriteLineAsync(gwSocket, "GATEWAY REMOTE1", cts.Token);
await Task.Delay(200);
manager.PropagateLocalUnsubscription("$G", "orders.>", null);
await Task.Delay(100);
var aminusLine = await ReadLineAsync(gwSocket, cts.Token);
aminusLine.ShouldBe("A- $G orders.>");
await manager.DisposeAsync();
}
// ── Helpers ─────────────────────────────────────────────────────────
private static async Task<string> ReadLineAsync(Socket socket, CancellationToken ct)
{
var bytes = new List<byte>(64);
var single = new byte[1];
while (true)
{
var read = await socket.ReceiveAsync(single, SocketFlags.None, ct);
if (read == 0)
break;
if (single[0] == (byte)'\n')
break;
if (single[0] != (byte)'\r')
bytes.Add(single[0]);
}
return Encoding.ASCII.GetString([.. bytes]);
}
private static Task WriteLineAsync(Socket socket, string line, CancellationToken ct)
=> socket.SendAsync(Encoding.ASCII.GetBytes($"{line}\r\n"), SocketFlags.None, ct).AsTask();
}
/// <summary>
/// Shared fixture for interest mode tests.
/// </summary>
internal sealed class InterestModeFixture : IAsyncDisposable
{
private readonly CancellationTokenSource _localCts;
private readonly CancellationTokenSource _remoteCts;
private InterestModeFixture(NatsServer local, NatsServer remote, CancellationTokenSource localCts, CancellationTokenSource remoteCts)
{
Local = local;
Remote = remote;
_localCts = localCts;
_remoteCts = remoteCts;
}
public NatsServer Local { get; }
public NatsServer Remote { get; }
public static Task<InterestModeFixture> StartAsync()
=> StartWithUsersAsync(null);
public static async Task<InterestModeFixture> StartWithUsersAsync(IReadOnlyList<User>? users)
{
var localOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Users = users,
Gateway = new GatewayOptions
{
Name = "LOCAL",
Host = "127.0.0.1",
Port = 0,
},
};
var local = new NatsServer(localOptions, NullLoggerFactory.Instance);
var localCts = new CancellationTokenSource();
_ = local.StartAsync(localCts.Token);
await local.WaitForReadyAsync();
var remoteOptions = new NatsOptions
{
Host = "127.0.0.1",
Port = 0,
Users = users,
Gateway = new GatewayOptions
{
Name = "REMOTE",
Host = "127.0.0.1",
Port = 0,
Remotes = [local.GatewayListen!],
},
};
var remote = new NatsServer(remoteOptions, NullLoggerFactory.Instance);
var remoteCts = new CancellationTokenSource();
_ = remote.StartAsync(remoteCts.Token);
await remote.WaitForReadyAsync();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
while (!timeout.IsCancellationRequested && (local.Stats.Gateways == 0 || remote.Stats.Gateways == 0))
await Task.Delay(50, timeout.Token).ContinueWith(_ => { }, TaskScheduler.Default);
return new InterestModeFixture(local, remote, localCts, remoteCts);
}
public async ValueTask DisposeAsync()
{
await _localCts.CancelAsync();
await _remoteCts.CancelAsync();
Local.Dispose();
Remote.Dispose();
_localCts.Dispose();
_remoteCts.Dispose();
}
}