using ZB.MOM.WW.OtOpcUa.Core.Abstractions;

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

/// <summary>
///     Test helper bridging the v2 authoring shape (a typed <see cref="TwinCATTagDefinition"/>) to the v3
///     delivery shape (<see cref="RawTagEntry"/>). Under v3 the driver no longer takes pre-declared
///     definitions — the deploy artifact hands it authored raw tags (RawPath + TagConfig blob + owning
///     DeviceName), and the driver rebuilds the typed definitions via <see cref="TwinCATTagDefinitionFactory"/>.
///     These integration smoke tests keep expressing their intent as typed definitions; this helper serialises
///     each back to its TagConfig blob (via <see cref="TwinCATTagDefinitionFactory.ToTagConfig"/>) and packages
///     it as a <see cref="RawTagEntry"/> whose RawPath is the def's <c>Name</c> and whose
///     <see cref="RawTagEntry.DeviceName"/> is the def's <c>DeviceHostAddress</c> — so the round-trip through
///     the real mapper + the driver's device resolution (which matches DeviceName against the configured
///     devices by host) reproduces the same definition + device routing the test authored, keyed by the same
///     name the read/write/subscribe call sites use. Mirrors the unit-test project's helper of the same name.
/// </summary>
internal static class TwinCATRawTags
{
    /// <summary>Serialises one typed definition into its <see cref="RawTagEntry"/>
    /// (RawPath = def.Name, DeviceName = def.DeviceHostAddress).</summary>
    /// <param name="def">The typed definition to convert.</param>
    /// <returns>The equivalent <see cref="RawTagEntry"/>.</returns>
    public static RawTagEntry Entry(TwinCATTagDefinition def)
        => new(def.Name, TwinCATTagDefinitionFactory.ToTagConfig(def), def.WriteIdempotent, def.DeviceHostAddress);

    /// <summary>Serialises typed definitions into <see cref="RawTagEntry"/> records.</summary>
    /// <param name="defs">The typed definitions to convert (array, params, or a collection expression).</param>
    /// <returns>The equivalent raw-tag entries.</returns>
    public static IReadOnlyList<RawTagEntry> Entries(params TwinCATTagDefinition[] defs)
        => [.. defs.Select(Entry)];
}
