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

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

/// <summary>
///     Test helper bridging the v2 authoring shape (a typed <see cref="FocasTagDefinition"/>) 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 + DeviceName),
///     and the driver rebuilds the typed definitions via <see cref="FocasTagDefinitionFactory"/> and routes
///     each to its device by <see cref="RawTagEntry.DeviceName"/>. These integration wire tests keep
///     expressing their intent as typed definitions; this helper serialises each back to its TagConfig blob
///     (via <see cref="FocasTagDefinitionFactory.ToTagConfig"/>) and packages it as a <see cref="RawTagEntry"/>
///     whose RawPath is the def's <c>Name</c> and whose DeviceName is the def's <c>DeviceHostAddress</c> — so
///     the round-trip through the real mapper + device match reproduces the same definition 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 FocasRawTags
{
    /// <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(FocasTagDefinition def)
        => new(def.Name, FocasTagDefinitionFactory.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 FocasTagDefinition[] defs)
        => [.. defs.Select(Entry)];
}
