ScadaBridge/tests/ZB.MOM.WW.ScadaBridge.CentralUI.PlaywrightTests/Cluster/CliRunnerHelpersTests.cs

using Xunit;

namespace ZB.MOM.WW.ScadaBridge.CentralUI.PlaywrightTests.Cluster;

/// <summary>
/// TDD coverage for the typed <see cref="CliRunner"/> fixture helpers used by
/// state-changing Central UI Playwright E2E tests to provision and tear down
/// templates, attributes, areas, and instances against the running dev cluster.
/// When the cluster / MSSQL is unreachable the facts report as Skipped (not
/// Failed), matching the established suite idiom.
/// </summary>
[Collection("Playwright")]
public class CliRunnerHelpersTests
{
    /// <summary>
    /// A freshly created template is discoverable by name prefix and can be
    /// deleted, exercising <see cref="CliRunner.CreateTemplateAsync"/>,
    /// <see cref="CliRunner.ListTemplateIdsByNamePrefixAsync"/>, and
    /// <see cref="CliRunner.DeleteTemplateAsync"/> as a round-trip.
    /// </summary>
    [SkippableFact]
    public async Task CreateThenDeleteTemplate_RoundTrips()
    {
        Skip.IfNot(await ClusterAvailability.IsAvailableAsync(), ClusterAvailability.SkipReason);
        var name = CliRunner.UniqueName("tmpl");
        int id = await CliRunner.CreateTemplateAsync(name);
        try
        {
            var ids = await CliRunner.ListTemplateIdsByNamePrefixAsync(name);
            Assert.Contains(id, ids);
        }
        finally { await CliRunner.DeleteTemplateAsync(id); }
    }

    /// <summary>
    /// <see cref="CliRunner.ResolveSiteIdAsync"/> finds the well-known
    /// <c>site-a</c> seed site by its <c>siteIdentifier</c> and returns a
    /// positive id.
    /// </summary>
    [SkippableFact]
    public async Task ResolveSiteA_ReturnsId()
    {
        Skip.IfNot(await ClusterAvailability.IsAvailableAsync(), ClusterAvailability.SkipReason);
        Assert.True(await CliRunner.ResolveSiteIdAsync("site-a") > 0);
    }

    /// <summary>
    /// A freshly created data connection returns a positive id and is cleanly
    /// deleted in teardown, exercising <see cref="CliRunner.CreateDataConnectionAsync"/>
    /// and <see cref="CliRunner.DeleteDataConnectionAsync"/> as a round-trip.
    /// </summary>
    [SkippableFact]
    public async Task CreateThenDeleteDataConnection_RoundTrips()
    {
        Skip.IfNot(await ClusterAvailability.IsAvailableAsync(), ClusterAvailability.SkipReason);
        var siteId = await CliRunner.ResolveSiteIdAsync("site-a");
        var id = await CliRunner.CreateDataConnectionAsync(siteId, CliRunner.UniqueName("conn"));
        try
        {
            Assert.True(id > 0);
        }
        finally
        {
            await CliRunner.DeleteDataConnectionAsync(id);
        }
    }

    /// <summary>
    /// A freshly created API method returns a positive id and is cleanly deleted in
    /// teardown, exercising <see cref="CliRunner.CreateApiMethodAsync"/> and
    /// <see cref="CliRunner.DeleteApiMethodAsync"/> as a round-trip.
    /// </summary>
    [SkippableFact]
    public async Task CreateThenDeleteApiMethod_RoundTrips()
    {
        Skip.IfNot(await ClusterAvailability.IsAvailableAsync(), ClusterAvailability.SkipReason);
        var id = await CliRunner.CreateApiMethodAsync(CliRunner.UniqueName("method"));
        try
        {
            Assert.True(id > 0);
        }
        finally
        {
            await CliRunner.DeleteApiMethodAsync(id);
        }
    }

    /// <summary>
    /// A freshly created area is discoverable by name prefix via
    /// <see cref="CliRunner.ListAreaIdsByNamePrefixAsync"/>, confirming the round-trip
    /// used by UI tests that need to tear down areas whose ids are never surfaced.
    /// Exercises <see cref="CliRunner.CreateAreaAsync"/>,
    /// <see cref="CliRunner.ListAreaIdsByNamePrefixAsync"/>, and
    /// <see cref="CliRunner.DeleteAreaAsync"/>.
    /// </summary>
    [SkippableFact]
    public async Task ListAreaIdsByNamePrefix_FindsCreatedArea()
    {
        Skip.IfNot(await ClusterAvailability.IsAvailableAsync(), ClusterAvailability.SkipReason);

        var siteId = await CliRunner.ResolveSiteIdAsync("site-a");
        var name = CliRunner.UniqueName("listarea");
        var areaId = await CliRunner.CreateAreaAsync(siteId, name);
        try
        {
            var ids = await CliRunner.ListAreaIdsByNamePrefixAsync(siteId, name);
            Assert.Contains(areaId, ids);
        }
        finally
        {
            await CliRunner.DeleteAreaAsync(areaId);
        }
    }
}