jdescopingtool/NEW/tests/JdeScoping.DataSync.Tests/Etl/Destinations/DbBulkMergeDestinationTests.cs

using System.Data;
using JdeScoping.DataAccess.Interfaces;
using JdeScoping.DataSync.Etl.Destinations;
using NSubstitute;

namespace JdeScoping.DataSync.Tests.Etl.Destinations;

public class DbBulkMergeDestinationTests
{
    /// <summary>
    /// This test documents that column mapping is applied to ignore extra source columns.
    /// The actual functionality requires a database connection and is an integration test concept.
    /// The implementation fetches destination columns from INFORMATION_SCHEMA.COLUMNS
    /// and only maps columns that exist in both source and destination.
    /// </summary>
    [Fact]
    public void WriteAsync_SourceHasExtraColumns_IgnoresExtraColumns_IntegrationTestConcept()
    {
        // This is an integration test concept -
        // The actual behavior verifies that column mappings are applied:
        // 1. GetDestinationColumnsAsync fetches columns from INFORMATION_SCHEMA.COLUMNS
        // 2. ProcessBatchAsync only adds column mappings for columns in destination
        // 3. Extra source columns are silently ignored during bulk copy
        //
        // To test this fully, an integration test with a real database is required.
        // The unit test here just verifies the component can be constructed.
        var factory = Substitute.For<IDbConnectionFactory>();
        var dest = new DbBulkMergeDestination(factory, "TestTable", new[] { "Id" });
        Assert.NotNull(dest);
    }

    [Fact]
    public void Constructor_SetsDestinationName()
    {
        var factory = Substitute.For<IDbConnectionFactory>();
        var dest = new DbBulkMergeDestination(factory, "WorkOrder", new[] { "OrderNumber" });
        Assert.Equal("BulkMerge:WorkOrder", dest.DestinationName);
    }

    [Fact]
    public void Constructor_NullFactory_ThrowsArgumentNullException()
    {
        Assert.Throws<ArgumentNullException>(() =>
            new DbBulkMergeDestination(null!, "WorkOrder", new[] { "Id" }));
    }

    [Fact]
    public void Constructor_NullTableName_ThrowsArgumentNullException()
    {
        var factory = Substitute.For<IDbConnectionFactory>();
        Assert.Throws<ArgumentNullException>(() =>
            new DbBulkMergeDestination(factory, null!, new[] { "Id" }));
    }

    [Fact]
    public void Constructor_EmptyTableName_ThrowsArgumentException()
    {
        var factory = Substitute.For<IDbConnectionFactory>();
        Assert.Throws<ArgumentException>(() =>
            new DbBulkMergeDestination(factory, "", new[] { "Id" }));
    }

    [Fact]
    public void Constructor_EmptyMatchColumns_ThrowsArgumentException()
    {
        var factory = Substitute.For<IDbConnectionFactory>();
        Assert.Throws<ArgumentException>(() =>
            new DbBulkMergeDestination(factory, "WorkOrder", Array.Empty<string>()));
    }

    [Fact]
    public void Constructor_NullMatchColumns_ThrowsArgumentNullException()
    {
        var factory = Substitute.For<IDbConnectionFactory>();
        Assert.Throws<ArgumentNullException>(() =>
            new DbBulkMergeDestination(factory, "WorkOrder", null!));
    }

    [Fact]
    public void Constructor_WithUpdateColumns_Succeeds()
    {
        var factory = Substitute.For<IDbConnectionFactory>();
        var dest = new DbBulkMergeDestination(factory, "WorkOrder",
            new[] { "OrderNumber" },
            updateColumns: new[] { "Status", "Description" });
        Assert.Equal("BulkMerge:WorkOrder", dest.DestinationName);
    }

    [Fact]
    public void Constructor_CustomTimeout_SetsTimeout()
    {
        // Arrange & Act
        var factory = Substitute.For<IDbConnectionFactory>();
        var dest = new DbBulkMergeDestination(
            factory,
            "TestTable",
            new[] { "Id" },
            commandTimeoutSeconds: 1800);

        // Assert - can't directly test private field, but constructor should accept it
        Assert.NotNull(dest);
    }

    [Fact]
    public void Constructor_ZeroTimeout_UsesDefault()
    {
        // Arrange & Act
        var factory = Substitute.For<IDbConnectionFactory>();
        var dest = new DbBulkMergeDestination(
            factory,
            "TestTable",
            new[] { "Id" },
            commandTimeoutSeconds: 0);

        // Assert
        Assert.NotNull(dest);
    }
}