namespace NpgsqlRestClient.Testing;

/// <summary>Kind of a parsed test step.</summary>
public enum TestStepKind
{
    /// <summary>A SQL statement (or DO block) executed on the test connection.</summary>
    Sql,
    /// <summary>An embedded HTTP request (a /* ... */ block whose first line is a request line).</summary>
    Http,
    /// <summary>An include line (<c>\i file</c> or <c>\ir file</c>) — expanded into the included file's steps.</summary>
    Include,
}

/// <summary>One ordered step in a parsed .test.sql file.</summary>
public abstract class TestStep
{
    public TestStepKind Kind { get; }
    /// <summary>1-based line in the source file where this step starts (for error reporting).</summary>
    public int LineNumber { get; }
    /// <summary>
    /// Full path of the file this step came from when it was spliced in via <c>\i</c>/<c>\ir</c>;
    /// null when the step belongs to the file being executed itself.
    /// </summary>
    public string? SourceFile { get; set; }

    protected TestStep(TestStepKind kind, int lineNumber)
    {
        Kind = kind;
        LineNumber = lineNumber;
    }
}

/// <summary>
/// An include line: <c>\i path</c> (path relative to the current working directory, like every other
/// configured path) or <c>\ir path</c> (relative to the file containing the include) — psql semantics.
/// Expanded by <see cref="TestFileLoader"/> into the included file's steps, as if the content were pasted.
/// </summary>
public sealed class IncludeStep : TestStep
{
    public string Path { get; }
    /// <summary>True for <c>\ir</c> (relative to the including file), false for <c>\i</c> (cwd-relative).</summary>
    public bool RelativeToFile { get; }

    public IncludeStep(string path, bool relativeToFile, int lineNumber) : base(TestStepKind.Include, lineNumber)
    {
        Path = path;
        RelativeToFile = relativeToFile;
    }
}

/// <summary>A SQL statement step — executed via ExecuteReader; a boolean first column is an assertion.</summary>
public sealed class SqlStep : TestStep
{
    public string Text { get; }
    public bool IsDoBlock { get; }

    public SqlStep(string text, bool isDoBlock, int lineNumber) : base(TestStepKind.Sql, lineNumber)
    {
        Text = text;
        IsDoBlock = isDoBlock;
    }
}

/// <summary>An embedded single-request HTTP step parsed from a block comment.</summary>
public sealed class HttpStep : TestStep
{
    /// <summary>HTTP method (upper-cased): GET, PUT, POST, DELETE.</summary>
    public string Method { get; }
    /// <summary>Request target verbatim, including any query string. Always starts with '/'.</summary>
    public string Path { get; }
    /// <summary>Request headers in declared order (duplicates allowed).</summary>
    public IReadOnlyList<(string Name, string Value)> Headers { get; }
    /// <summary>Claims for the acting principal (from <c># @claim name=value</c>), in declared order.</summary>
    public IReadOnlyList<(string Name, string Value)> Claims { get; }
    /// <summary>Request body (verbatim), or null when none.</summary>
    public string? Body { get; }
    /// <summary>Response temp-table name override from <c># @response name</c>, or null (use the configured default).</summary>
    public string? ResponseTable { get; }

    public HttpStep(
        string method,
        string path,
        IReadOnlyList<(string Name, string Value)> headers,
        IReadOnlyList<(string Name, string Value)> claims,
        string? body,
        string? responseTable,
        int lineNumber) : base(TestStepKind.Http, lineNumber)
    {
        Method = method;
        Path = path;
        Headers = headers;
        Claims = claims;
        Body = body;
        ResponseTable = responseTable;
    }
}