namespace ZB.MOM.WW.OtOpcUa.Core.Abstractions;
///
/// Optional companion to : lets the OPC UA Part 9 Acknowledge method
/// refuse, with a synchronous status, an acknowledge the driver already knows it would refuse
/// (lmxopcua#760). The native ack path is otherwise fire-and-forget after the method returns, so without
/// this the client sees Good for an acknowledge that never reached the upstream alarm system.
///
///
/// Called on an OPC UA server thread, under the SDK node-manager lock: an implementation must answer from
/// state it already holds — no I/O, no secret lookups, no blocking. It is a best-effort pre-check for
/// static misconfiguration only; an acknowledge it lets through can still fail later (that path reverts
/// the condition to unacknowledged instead).
///
public interface IAlarmAcknowledgePreflight
{
///
/// Returns why an acknowledge from a session that authenticated with would
/// be refused, or null when it would proceed or the driver cannot tell without I/O.
///
/// The session's API key id, or null for an anonymous session.
/// A refusal reason safe to show the OPC UA client (never a secret), or null.
string? GetAcknowledgeRefusal(string? apiKeyId);
}