namespace Junction.Domain.Protocols
{
    /// <summary>
    /// Protocol-agnostic catalog entry describing a single selectable data item a machine exposes.
    /// Returned (unfiltered) by <see cref="IProtocolDriver.ProbeAsync"/> so the config screen can
    /// present the full set of items the user may choose to monitor. Immutable; nulls collapse to "".
    /// </summary>
    public sealed class DataItemDescriptor
    {
        /// <summary>Stable identifier of the data item (e.g. MTConnect dataItemId).</summary>
        public string Id { get; }

        /// <summary>Human-readable name (may be empty).</summary>
        public string Name { get; }

        /// <summary>Protocol type (e.g. MTConnect POSITION, EXECUTION, AVAILABILITY).</summary>
        public string Type { get; }

        /// <summary>Category (e.g. MTConnect SAMPLE, EVENT, CONDITION). Kept as string to stay generic.</summary>
        public string Category { get; }

        /// <summary>Units (may be empty).</summary>
        public string Units { get; }

        public DataItemDescriptor(string id, string name, string type, string category, string units)
        {
            Id = id ?? "";
            Name = name ?? "";
            Type = type ?? "";
            Category = category ?? "";
            Units = units ?? "";
        }
    }
}