namespace ZB.MOM.WW.OtOpcUa.Driver.TwinCAT;

/// <summary>
///     Thrown by <see cref="ITwinCATClient.AddNotificationAsync"/> when the client refuses to register a
///     native notification for one tag — its declared type cannot decode the PLC symbol
///     (<see cref="TwinCATTypeMismatchException"/>), or an array is too large for a native notification.
///     The driver isolates that one tag to <see cref="StatusCode"/> (one WARN) and keeps the rest of the
///     subscription; the intent stays registered so the probe-tick retry re-checks it.
/// </summary>
internal class TwinCATNotificationRefusedException : Exception
{
    /// <summary>Initializes a new instance of the <see cref="TwinCATNotificationRefusedException"/> class.</summary>
    /// <param name="symbolPath">The ADS symbol the tag names.</param>
    /// <param name="reason">The one-line reason.</param>
    /// <param name="statusCode">The OPC UA status the refused tag publishes.</param>
    public TwinCATNotificationRefusedException(string symbolPath, string reason, uint statusCode)
        : base($"TwinCAT symbol '{symbolPath}': {reason}")
    {
        SymbolPath = symbolPath;
        StatusCode = statusCode;
    }

    /// <summary>Gets the ADS symbol the refused tag names.</summary>
    public string SymbolPath { get; }

    /// <summary>Gets the OPC UA status the refused tag publishes.</summary>
    public uint StatusCode { get; }
}