feat(adminui): add connection-health signal to in-process broadcaster + bridges

This commit is contained in:
Joseph Doherty
2026-06-11 09:20:36 -04:00
parent 565b77e6cf
commit 3a0e0907e4
4 changed files with 130 additions and 2 deletions
@@ -26,16 +26,78 @@ public interface IInProcessBroadcaster<T>
/// <summary>Fan the item out to all current <see cref="Received"/> subscribers.</summary>
void Publish(T item);
/// <summary>
/// Whether the upstream feed (the per-node SignalR bridge's DPS subscription) is currently
/// live. Drives the "live" pill on the Blazor pages. False until the bridge's first
/// <c>SubscribeAck</c>; flips false again when the bridge stops.
/// </summary>
bool IsConnected { get; }
/// <summary>
/// Raised whenever <see cref="IsConnected"/> changes (and only on change), with the new value.
/// Handlers run on the caller's thread (the bridge actor), so Blazor subscribers must marshal
/// via <c>InvokeAsync</c>.
/// </summary>
event Action<bool>? ConnectionStateChanged;
/// <summary>
/// Set by the bridge actor from its DPS-subscription health: <c>true</c> on <c>SubscribeAck</c>
/// (subscription live), <c>false</c> on <c>PostStop</c>/failure. Raises
/// <see cref="ConnectionStateChanged"/> only when the value actually changes.
/// </summary>
/// <param name="connected">The new connection state.</param>
void SetConnected(bool connected);
}
/// <summary>Thread-safe singleton implementation of <see cref="IInProcessBroadcaster{T}"/>.</summary>
/// <typeparam name="T">The event payload type.</typeparam>
public sealed class InProcessBroadcaster<T> : IInProcessBroadcaster<T>
{
// Guards _isConnected: the bridge actor sets it on the actor thread; Blazor reads it on the
// render thread, so access must be serialised.
private readonly object _connectionLock = new();
private bool _isConnected;
/// <inheritdoc />
public event Action<T>? Received;
/// <inheritdoc />
public event Action<bool>? ConnectionStateChanged;
/// <inheritdoc />
// Capture-then-invoke (via ?.) so a concurrent unsubscribe can't null the delegate mid-raise.
public void Publish(T item) => Received?.Invoke(item);
/// <inheritdoc />
public bool IsConnected
{
get
{
lock (_connectionLock)
{
return _isConnected;
}
}
}
/// <inheritdoc />
public void SetConnected(bool connected)
{
Action<bool>? handler;
lock (_connectionLock)
{
if (_isConnected == connected)
{
return;
}
_isConnected = connected;
// Capture inside the lock, invoke outside (mirrors Publish) so a concurrent
// unsubscribe can't null the delegate mid-raise and we never hold the lock during a callback.
handler = ConnectionStateChanged;
}
handler?.Invoke(connected);
}
}