using System;

namespace MxGateway.Worker.MxAccess;

/// <summary>
///     Library-agnostic alarm-state enum. Mirrors the four <c>STATE</c>
///     values returned by AVEVA's <c>WNWRAPCONSUMERLib</c> XML payload —
///     <c>UNACK_ALM</c>, <c>ACK_ALM</c>, <c>UNACK_RTN</c>, <c>ACK_RTN</c>.
///     Decoupling the consumer from any specific COM library keeps the
///     proto-build path testable without an AVEVA install.
/// </summary>
public enum MxAlarmStateKind
{
    Unspecified = 0,
    UnackAlm = 1,
    AckAlm = 2,
    UnackRtn = 3,
    AckRtn = 4,
}

/// <summary>
///     Single alarm record as emitted by the wnwrapConsumer XML stream.
///     Field names match the captured XML schema (see
///     <c>docs/AlarmClientDiscovery.md</c> "Option A — captured" section).
/// </summary>
public sealed class MxAlarmSnapshotRecord
{
    public Guid AlarmGuid { get; set; }
    public DateTime TransitionTimestampUtc { get; set; }
    public string ProviderNode { get; set; } = string.Empty;
    public string ProviderName { get; set; } = string.Empty;
    public string Group { get; set; } = string.Empty;
    public string TagName { get; set; } = string.Empty;
    public string Type { get; set; } = string.Empty;
    public string Value { get; set; } = string.Empty;
    public string Limit { get; set; } = string.Empty;
    public int Priority { get; set; }
    public MxAlarmStateKind State { get; set; }
    public string OperatorNode { get; set; } = string.Empty;
    public string OperatorName { get; set; } = string.Empty;
    public string AlarmComment { get; set; } = string.Empty;
}

/// <summary>
///     One transition emitted by the consumer's snapshot diff. Pairs the
///     latest record with its previous state so the proto layer can decide
///     whether the transition is a Raise / Acknowledge / Clear.
/// </summary>
public sealed class MxAlarmTransitionEvent : EventArgs
{
    public MxAlarmSnapshotRecord Record { get; set; } = new MxAlarmSnapshotRecord();

    /// <summary>
    ///     The state on the consumer's previous polled snapshot, or
    ///     <see cref="MxAlarmStateKind.Unspecified"/> when this is the
    ///     first time the GUID has been observed.
    /// </summary>
    public MxAlarmStateKind PreviousState { get; set; }
}