namespace AcDream.Core.Net.Packets;

/// <summary>
/// A fully-parsed AC UDP packet: 20-byte <see cref="Header"/>,
/// variable-length <see cref="Optional"/> section, zero or more
/// <see cref="Fragments"/>, and the raw body bytes following the header
/// (for callers that want to re-read parts of the login/connect payload
/// without re-invoking the parser).
///
/// <para>
/// Produced by <see cref="PacketCodec.TryDecode"/> on the receive path;
/// passed to <see cref="PacketCodec.Encode"/> on the transmit path after
/// callers fill in the fields they want.
/// </para>
/// </summary>
public sealed class Packet
{
    public PacketHeader Header;
    public PacketHeaderOptional Optional { get; } = new();
    public List<MessageFragment> Fragments { get; } = new();

    /// <summary>
    /// Copy of the body bytes (everything after the 20-byte header). Useful
    /// for LoginRequest packets where the login payload is the body tail and
    /// the caller wants to extract username/password bytes directly.
    /// </summary>
    public byte[] BodyBytes { get; set; } = Array.Empty<byte>();
}