using System.IO.Pipelines;
using Expecto.CSharp;
using Expecto;
using Microsoft.FSharp.Core;
using BitBadger.Documents.Sqlite;
using Microsoft.Data.Sqlite;

namespace BitBadger.Documents.Tests.CSharp;

using static Runner;

/// <summary>
/// C# tests for the SQLite implementation of <tt>BitBadger.Documents</tt>
/// </summary>
public static class SqliteCSharpTests
{
    /// <summary>
    /// Unit tests for the Query module of the SQLite library
    /// </summary>
    private static readonly Test QueryTests = TestList("Query",
    [
        TestList("WhereByFields",
        [
            TestCase("succeeds for a single field when a logical operator is passed", () =>
            {
                Expect.equal(
                    Sqlite.Query.WhereByFields(FieldMatch.Any,
                        [Field.Greater("theField", 0).WithParameterName("@test")]),
                    "data->>'theField' > @test", "WHERE clause not correct");
            }),
            TestCase("succeeds for a single field when an existence operator is passed", () =>
            {
                Expect.equal(Sqlite.Query.WhereByFields(FieldMatch.Any, [Field.NotExists("thatField")]),
                    "data->>'thatField' IS NULL", "WHERE clause not correct");
            }),
            TestCase("succeeds for a single field when a between operator is passed", () =>
            {
                Expect.equal(
                    Sqlite.Query.WhereByFields(FieldMatch.All,
                        [Field.Between("aField", 50, 99).WithParameterName("@range")]),
                    "data->>'aField' BETWEEN @rangemin AND @rangemax", "WHERE clause not correct");
            }),
            TestCase("succeeds for all multiple fields with logical operators", () =>
            {
                Expect.equal(
                    Sqlite.Query.WhereByFields(FieldMatch.All,
                        [Field.Equal("theFirst", "1"), Field.Equal("numberTwo", "2")]),
                    "data->>'theFirst' = @field0 AND data->>'numberTwo' = @field1", "WHERE clause not correct");
            }),
            TestCase("succeeds for any multiple fields with an existence operator", () =>
            {
                Expect.equal(
                    Sqlite.Query.WhereByFields(FieldMatch.Any,
                        [Field.NotExists("thatField"), Field.GreaterOrEqual("thisField", 18)]),
                    "data->>'thatField' IS NULL OR data->>'thisField' >= @field0", "WHERE clause not correct");
            }),
            TestCase("succeeds for all multiple fields with between operators", () =>
            {
                Expect.equal(
                    Sqlite.Query.WhereByFields(FieldMatch.All,
                        [Field.Between("aField", 50, 99), Field.Between("anotherField", "a", "b")]),
                    "data->>'aField' BETWEEN @field0min AND @field0max AND data->>'anotherField' BETWEEN @field1min AND @field1max",
                    "WHERE clause not correct");
            }),
            TestCase("succeeds for a field with an In comparison", () =>
            {
                Expect.equal(Sqlite.Query.WhereByFields(FieldMatch.All, [Field.In("this", ["a", "b", "c"])]),
                    "data->>'this' IN (@field0_0, @field0_1, @field0_2)", "WHERE clause not correct");
            }),
            TestCase("succeeds for a field with an InArray comparison", () =>
            {
                Expect.equal(
                    Sqlite.Query.WhereByFields(FieldMatch.All, [Field.InArray("this", "the_table", ["a", "b"])]),
                    "EXISTS (SELECT 1 FROM json_each(the_table.data, '$.this') WHERE value IN (@field0_0, @field0_1))",
                    "WHERE clause not correct");
            })
        ]),
        TestCase("WhereById succeeds", () =>
        {
            Expect.equal(Sqlite.Query.WhereById("abc"), "data->>'Id' = @id", "WHERE clause not correct");
        }),
        TestCase("Patch succeeds", () =>
        {
            Expect.equal(Sqlite.Query.Patch(SqliteDb.TableName),
                $"UPDATE {SqliteDb.TableName} SET data = json_patch(data, json(@data))", "Patch query not correct");
        }),
        TestCase("RemoveFields succeeds", () =>
        {
            Expect.equal(Sqlite.Query.RemoveFields(SqliteDb.TableName, [new("@a", "a"), new("@b", "b")]),
                $"UPDATE {SqliteDb.TableName} SET data = json_remove(data, @a, @b)",
                "Field removal query not correct");
        }),
        TestCase("ById succeeds", () =>
        {
            Expect.equal(Sqlite.Query.ById("test", "14"), "test WHERE data->>'Id' = @id", "By-ID query not correct");
        }),
        TestCase("ByFields succeeds", () =>
        {
            Expect.equal(Sqlite.Query.ByFields("unit", FieldMatch.Any, [Field.Greater("That", 14)]),
                "unit WHERE data->>'That' > @field0", "By-Field query not correct");
        }),
        TestCase("Definition.EnsureTable succeeds", () =>
        {
            Expect.equal(Sqlite.Query.Definition.EnsureTable("tbl"),
                "CREATE TABLE IF NOT EXISTS tbl (data TEXT NOT NULL)", "CREATE TABLE statement not correct");
        })
    ]);

    /// <summary>
    /// Unit tests for the Parameters module of the SQLite library
    /// </summary>
    private static readonly Test ParametersTests = TestList("Parameters",
    [
        TestCase("Id succeeds", () =>
        {
            var theParam = Parameters.Id(7);
            Expect.equal(theParam.ParameterName, "@id", "The parameter name is incorrect");
            Expect.equal(theParam.Value, "7", "The parameter value is incorrect");
        }),
        TestCase("Json succeeds", () =>
        {
            var theParam = Parameters.Json("@test", new { Nice = "job" });
            Expect.equal(theParam.ParameterName, "@test", "The parameter name is incorrect");
            Expect.equal(theParam.Value, "{\"Nice\":\"job\"}", "The parameter value is incorrect");
        }),
#pragma warning disable CS0618
        TestCase("AddField succeeds when adding a parameter", () =>
        {
            var paramList = Parameters.AddField("@field", Field.Equal("it", 99), []).ToList();
            Expect.hasLength(paramList, 1, "There should have been a parameter added");
            var theParam = paramList[0];
            Expect.equal(theParam.ParameterName, "@field", "The parameter name is incorrect");
            Expect.equal(theParam.Value, 99, "The parameter value is incorrect");
        }),
        TestCase("AddField succeeds when not adding a parameter", () =>
        {
            var paramSeq = Parameters.AddField("@it", Field.Exists("Coffee"), []);
            Expect.isEmpty(paramSeq, "There should not have been any parameters added");
        }),
#pragma warning restore CS0618
        TestCase("None succeeds", () =>
        {
            Expect.isEmpty(Parameters.None, "The parameter list should have been empty");
        })
    ]);

    // Results are exhaustively executed in the context of other tests

    /// <summary>
    /// Add the test documents to the database
    /// </summary>
    private static async Task LoadDocs()
    {
        foreach (var doc in JsonDocument.TestDocuments) await Document.Insert(SqliteDb.TableName, doc);
    }

    /// <summary>
    /// Integration tests for the Configuration module of the SQLite library
    /// </summary>
    private static readonly Test ConfigurationTests = TestCase("Configuration.UseConnectionString succeeds", () =>
    {
        try
        {
            Sqlite.Configuration.UseConnectionString("Data Source=test.db");
            Expect.equal(Sqlite.Configuration.connectionString,
                new FSharpOption<string>("Data Source=test.db;Foreign Keys=True"), "Connection string incorrect");
        }
        finally
        {
            Sqlite.Configuration.UseConnectionString("Data Source=:memory:");
        }
    });

    /// <summary>Verify a JSON array begins with "[" and ends with "]"</summary>
    private static void VerifyBeginEnd(string json)
    {
        Expect.stringStarts(json, "[", "The array should have started with `[`");
        Expect.stringEnds(json, "]", "The array should have ended with `]`");
    }

    /// <summary>Verify an empty JSON array</summary>
    private static void VerifyEmpty(string json) =>
        Expect.equal(json, "[]", "There should be no documents returned");

    /// <summary>Verify an empty JSON document</summary>
    private static void VerifyNoDoc(string json) =>
        Expect.equal(json, "{}", "There should be no document returned");

    /// <summary>Set up a stream writer for a test</summary>
    private static PipeWriter WriteStream(Stream stream) =>
        PipeWriter.Create(stream, new StreamPipeWriterOptions(leaveOpen: true));

    /// <summary>Get the text of the given stream</summary>
    private static string StreamText(Stream stream)
    {
        stream.Position = 0L;
        using StreamReader reader = new(stream);
        return reader.ReadToEnd();
    }

    /// Verify the presence of any of the given documents in the given JSON
    private static void VerifyAny(string json, IEnumerable<string> docs)
    {
        var theDocs = docs.ToList();
        if (theDocs.Any(json.Contains)) return;
        var anyDocs = string.Join(" | ", theDocs);
        Expect.isTrue(false, $"Could not find any of |{anyDocs}| in {json}");
    }

    /// <summary>
    /// Integration tests for the Custom module of the SQLite library
    /// </summary>
    private static readonly Test CustomTests = TestList("Custom",
    [
        TestList("List",
        [
            TestCase("succeeds when data is found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var docs = await Custom.List(Query.Find(SqliteDb.TableName), Parameters.None,
                    Results.FromData<JsonDocument>);
                Expect.equal(docs.Count, 5, "There should have been 5 documents returned");
            }),
            TestCase("succeeds when data is not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var docs = await Custom.List(
                    $"SELECT data FROM {SqliteDb.TableName} WHERE data ->> 'NumValue' > @value", [new("@value", 100)],
                    Results.FromData<JsonDocument>);
                Expect.isEmpty(docs, "There should have been no documents returned");
            })
        ]),
        TestList("JsonArray",
        [
            TestCase("succeeds when data is found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var json = await Custom.JsonArray(Query.Find(SqliteDb.TableName), [], Results.JsonFromData);
                VerifyBeginEnd(json);
                Expect.stringContains(json, JsonDocument.One, "Document ID `one` should have been found");
                Expect.stringContains(json, JsonDocument.Two,"Document ID `two` should have been found");
                Expect.stringContains(json, JsonDocument.Three, "Document ID `three` should have been found");
                Expect.stringContains(json, JsonDocument.Four, "Document ID `four` should have been found");
                Expect.stringContains(json, JsonDocument.Five, "Document ID `five` should have been found");
            }),
            TestCase("succeeds when data is not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                VerifyEmpty(await Custom.JsonArray(
                    $"SELECT data FROM {SqliteDb.TableName} WHERE data ->> 'NumValue' > @value",
                    [new SqliteParameter("@value", 100)], Results.JsonFromData));
            })
        ]),
        TestList("WriteJsonArray",
        [
            TestCase("succeeds when data is found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Custom.WriteJsonArray(Query.Find(SqliteDb.TableName), [], writer, Results.JsonFromData);
                    var json = StreamText(stream);
                    VerifyBeginEnd(json);
                    Expect.stringContains(json, JsonDocument.One, "Document ID `one` should have been found");
                    Expect.stringContains(json, JsonDocument.Two, "Document ID `two` should have been found");
                    Expect.stringContains(json, JsonDocument.Three, "Document ID `three` should have been found");
                    Expect.stringContains(json, JsonDocument.Four, "Document ID `four` should have been found");
                    Expect.stringContains(json, JsonDocument.Five, "Document ID `five` should have been found");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when data is not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Custom.WriteJsonArray(
                        $"SELECT data FROM {SqliteDb.TableName} WHERE data ->> 'NumValue' > @value",
                        [new SqliteParameter("@value", 100)], writer, Results.JsonFromData);
                    VerifyEmpty(StreamText(stream));
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            })
        ]),
        TestList("Single",
        [
            TestCase("succeeds when a row is found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var doc = await Custom.Single($"SELECT data FROM {SqliteDb.TableName} WHERE data ->> 'Id' = @id",
                    [Parameters.Id("one")], Results.FromData<JsonDocument>);
                Expect.isNotNull(doc, "There should have been a document returned");
                Expect.equal(doc!.Id, "one", "The incorrect document was returned");
            }),
            TestCase("succeeds when a row is not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var doc = await Custom.Single($"SELECT data FROM {SqliteDb.TableName} WHERE data ->> 'Id' = @id",
                    [Parameters.Id("eighty")], Results.FromData<JsonDocument>);
                Expect.isNull(doc, "There should not have been a document returned");
            })
        ]),
        TestList("JsonSingle",
        [
            TestCase("succeeds when a row is found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var json = await Custom.JsonSingle($"SELECT data FROM {SqliteDb.TableName} WHERE data ->> 'Id' = @id",
                    [new SqliteParameter("@id", "one")], Results.JsonFromData);
                Expect.equal(json, JsonDocument.One, "The JSON document is incorrect");
            }),
            TestCase("succeeds when a row is not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                VerifyNoDoc(await Custom.JsonSingle($"SELECT data FROM {SqliteDb.TableName} WHERE data ->> 'Id' = @id",
                    [new SqliteParameter("@id", "eighty")], Results.JsonFromData));
            })
        ]),
        TestList("NonQuery",
        [
            TestCase("succeeds when operating on data", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                await Custom.NonQuery($"DELETE FROM {SqliteDb.TableName}", Parameters.None);

                var remaining = await Count.All(SqliteDb.TableName);
                Expect.equal(remaining, 0L, "There should be no documents remaining in the table");
            }),
            TestCase("succeeds when no data matches where clause", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                await Custom.NonQuery($"DELETE FROM {SqliteDb.TableName} WHERE data ->> 'NumValue' > @value",
                    [new("@value", 100)]);

                var remaining = await Count.All(SqliteDb.TableName);
                Expect.equal(remaining, 5L, "There should be 5 documents remaining in the table");
            })
        ]),
        TestCase("Scalar succeeds", async () =>
        {
            await using var db = await SqliteDb.BuildDb();

            var nbr = await Custom.Scalar("SELECT 5 AS test_value", Parameters.None, rdr => rdr.GetInt32(0));
            Expect.equal(nbr, 5, "The query should have returned the number 5");
        })
    ]);

    /// <summary>
    /// Integration tests for the Definition module of the SQLite library
    /// </summary>
    private static readonly Test DefinitionTests = TestList("Definition",
    [
        TestCase("EnsureTable succeeds", async () =>
        {
            await using var db = await SqliteDb.BuildDb();

            var exists = await ItExists("ensured");
            var alsoExists = await ItExists("idx_ensured_key");
            Expect.isFalse(exists, "The table should not exist already");
            Expect.isFalse(alsoExists, "The key index should not exist already");

            await Definition.EnsureTable("ensured");

            exists = await ItExists("ensured");
            alsoExists = await ItExists("idx_ensured_key");
            Expect.isTrue(exists, "The table should now exist");
            Expect.isTrue(alsoExists, "The key index should now exist");
            return;

            async ValueTask<bool> ItExists(string name)
            {
                return await Custom.Scalar($"SELECT EXISTS (SELECT 1 FROM {SqliteDb.Catalog} WHERE name = @name) AS it",
                    [new("@name", name)], Results.ToExists);
            }
        }),
        TestCase("EnsureFieldIndex succeeds", async () =>
        {
            await using var db = await SqliteDb.BuildDb();

            var exists = await IndexExists();
            Expect.isFalse(exists, "The index should not exist already");

            await Definition.EnsureTable("ensured");
            await Definition.EnsureFieldIndex("ensured", "test", ["Id", "Category"]);
            exists = await IndexExists();
            Expect.isTrue(exists, "The index should now exist");
            return;

            Task<bool> IndexExists() => Custom.Scalar(
                $"SELECT EXISTS (SELECT 1 FROM {SqliteDb.Catalog} WHERE name = 'idx_ensured_test') AS it",
                Parameters.None, Results.ToExists);
        })
    ]);

    /// <summary>
    /// Integration tests for the Document module of the SQLite library
    /// </summary>
    private static readonly Test DocumentTests = TestList("Document",
    [
        TestList("Insert",
        [
            TestCase("succeeds", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                var before = await Find.All<SubDocument>(SqliteDb.TableName);
                Expect.isEmpty(before, "There should be no documents in the table");
                await Document.Insert(SqliteDb.TableName,
                    new JsonDocument { Id = "turkey", Sub = new() { Foo = "gobble", Bar = "gobble" } });
                var after = await Find.All<JsonDocument>(SqliteDb.TableName);
                Expect.equal(after.Count, 1, "There should have been one document inserted");
            }),
            TestCase("fails for duplicate key", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await Document.Insert(SqliteDb.TableName, new JsonDocument { Id = "test" });
                try
                {
                    await Document.Insert(SqliteDb.TableName, new JsonDocument { Id = "test" });
                    Expect.isTrue(false, "An exception should have been raised for duplicate document ID insert");
                }
                catch (Exception)
                {
                    // This is what is supposed to happen
                }
            }),
            TestCase("succeeds when adding a numeric auto ID", async () =>
            {
                try
                {
                    Configuration.UseAutoIdStrategy(AutoId.Number);
                    Configuration.UseIdField("Key");
                    await using var db = await SqliteDb.BuildDb();
                    var before = await Count.All(SqliteDb.TableName);
                    Expect.equal(before, 0L, "There should be no documents in the table");

                    await Document.Insert(SqliteDb.TableName, new NumIdDocument { Text = "one" });
                    await Document.Insert(SqliteDb.TableName, new NumIdDocument { Text = "two" });
                    await Document.Insert(SqliteDb.TableName, new NumIdDocument { Key = 77, Text = "three" });
                    await Document.Insert(SqliteDb.TableName, new NumIdDocument { Text = "four" });

                    var after = await Find.AllOrdered<NumIdDocument>(SqliteDb.TableName, [Field.Named("Key")]);
                    Expect.hasLength(after, 4, "There should have been 4 documents returned");
                    Expect.sequenceEqual(after.Select(x => x.Key), [1, 2, 77, 78],
                        "The IDs were not generated correctly");
                }
                finally
                {
                    Configuration.UseAutoIdStrategy(AutoId.Disabled);
                    Configuration.UseIdField("Id");
                }
            }),
            TestCase("succeeds when adding a GUID auto ID", async () =>
            {
                try
                {
                    Configuration.UseAutoIdStrategy(AutoId.Guid);
                    await using var db = await SqliteDb.BuildDb();
                    var before = await Count.All(SqliteDb.TableName);
                    Expect.equal(before, 0L, "There should be no documents in the table");

                    await Document.Insert(SqliteDb.TableName, new JsonDocument { Value = "one" });
                    await Document.Insert(SqliteDb.TableName, new JsonDocument { Value = "two" });
                    await Document.Insert(SqliteDb.TableName, new JsonDocument { Id = "abc123", Value = "three" });
                    await Document.Insert(SqliteDb.TableName, new JsonDocument { Value = "four" });

                    var after = await Find.All<JsonDocument>(SqliteDb.TableName);
                    Expect.hasLength(after, 4, "There should have been 4 documents returned");
                    Expect.equal(after.Count(x => x.Id.Length == 32), 3, "Three of the IDs should have been GUIDs");
                    Expect.equal(after.Count(x => x.Id == "abc123"), 1, "The provided ID should have been used as-is");
                }
                finally
                {
                    Configuration.UseAutoIdStrategy(AutoId.Disabled);
                }
            }),
            TestCase("succeeds when adding a RandomString auto ID", async () =>
            {
                try
                {
                    Configuration.UseAutoIdStrategy(AutoId.RandomString);
                    Configuration.UseIdStringLength(44);
                    await using var db = await SqliteDb.BuildDb();
                    var before = await Count.All(SqliteDb.TableName);
                    Expect.equal(before, 0L, "There should be no documents in the table");

                    await Document.Insert(SqliteDb.TableName, new JsonDocument { Value = "one" });
                    await Document.Insert(SqliteDb.TableName, new JsonDocument { Value = "two" });
                    await Document.Insert(SqliteDb.TableName, new JsonDocument { Id = "abc123", Value = "three" });
                    await Document.Insert(SqliteDb.TableName, new JsonDocument { Value = "four" });

                    var after = await Find.All<JsonDocument>(SqliteDb.TableName);
                    Expect.hasLength(after, 4, "There should have been 4 documents returned");
                    Expect.equal(after.Count(x => x.Id.Length == 44), 3,
                        "Three of the IDs should have been 44-character random strings");
                    Expect.equal(after.Count(x => x.Id == "abc123"), 1, "The provided ID should have been used as-is");
                }
                finally
                {
                    Configuration.UseAutoIdStrategy(AutoId.Disabled);
                    Configuration.UseIdStringLength(16);
                }
            })
        ]),
        TestList("Save",
        [
            TestCase("succeeds when a document is inserted", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                var before = await Find.All<JsonDocument>(SqliteDb.TableName);
                Expect.isEmpty(before, "There should be no documents in the table");

                await Document.Save(SqliteDb.TableName,
                    new JsonDocument { Id = "test", Sub = new() { Foo = "a", Bar = "b" } });
                var after = await Find.All<JsonDocument>(SqliteDb.TableName);
                Expect.equal(after.Count, 1, "There should have been one document inserted");
            }),
            TestCase("succeeds when a document is updated", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await Document.Insert(SqliteDb.TableName,
                    new JsonDocument { Id = "test", Sub = new() { Foo = "a", Bar = "b" } });

                var before = await Find.ById<string, JsonDocument>(SqliteDb.TableName, "test");
                Expect.isNotNull(before, "There should have been a document returned");
                Expect.equal(before!.Id, "test", "The document is not correct");
                Expect.isNotNull(before.Sub, "There should have been a sub-document");
                Expect.equal(before.Sub!.Foo, "a", "The document is not correct");
                Expect.equal(before.Sub.Bar, "b", "The document is not correct");

                await Document.Save(SqliteDb.TableName, new JsonDocument { Id = "test" });
                var after = await Find.ById<string, JsonDocument>(SqliteDb.TableName, "test");
                Expect.isNotNull(after, "There should have been a document returned post-update");
                Expect.equal(after!.Id, "test", "The updated document is not correct");
                Expect.isNull(after.Sub, "There should not have been a sub-document in the updated document");
            })
        ])
    ]);

    /// <summary>
    /// Integration tests for the Count module of the SQLite library
    /// </summary>
    private static readonly Test CountTests = TestList("Count",
    [
        TestCase("All succeeds", async () =>
        {
            await using var db = await SqliteDb.BuildDb();
            await LoadDocs();

            var theCount = await Count.All(SqliteDb.TableName);
            Expect.equal(theCount, 5L, "There should have been 5 matching documents");
        }),
        TestList("ByFields",
        [
            TestCase("succeeds for numeric range", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var theCount = await Count.ByFields(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Between("NumValue", 10, 20)]);
                Expect.equal(theCount, 3L, "There should have been 3 matching documents");
            }),
            TestCase("succeeds for non-numeric range", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var theCount = await Count.ByFields(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Between("Value", "aardvark", "apple")]);
                Expect.equal(theCount, 1L, "There should have been 1 matching document");
            })
        ])
    ]);

    /// <summary>
    /// Integration tests for the Exists module of the SQLite library
    /// </summary>
    private static readonly Test ExistsTests = TestList("Exists",
    [
        TestList("ById",
        [
            TestCase("succeeds when a document exists", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var exists = await Exists.ById(SqliteDb.TableName, "three");
                Expect.isTrue(exists, "There should have been an existing document");
            }),
            TestCase("succeeds when a document does not exist", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var exists = await Exists.ById(SqliteDb.TableName, "seven");
                Expect.isFalse(exists, "There should not have been an existing document");
            })
        ]),
        TestList("ByFields",
        [
            TestCase("succeeds when documents exist", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var exists = await Exists.ByFields(SqliteDb.TableName, FieldMatch.Any,
                    [Field.GreaterOrEqual("NumValue", 10)]);
                Expect.isTrue(exists, "There should have been existing documents");
            }),
            TestCase("succeeds when no matching documents exist", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var exists = await Exists.ByFields(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Equal("Nothing", "none")]);
                Expect.isFalse(exists, "There should not have been any existing documents");
            })
        ])
    ]);

    /// <summary>
    /// Integration tests for the Find module of the SQLite library
    /// </summary>
    private static readonly Test FindTests = TestList("Find",
    [
        TestList("All",
        [
            TestCase("succeeds when there is data", async () =>
            {
                await using var db = await SqliteDb.BuildDb();

                await Document.Insert(SqliteDb.TableName, new JsonDocument { Id = "one", Value = "two" });
                await Document.Insert(SqliteDb.TableName, new JsonDocument { Id = "three", Value = "four" });
                await Document.Insert(SqliteDb.TableName, new JsonDocument { Id = "five", Value = "six" });

                var results = await Find.All<JsonDocument>(SqliteDb.TableName);
                Expect.equal(results.Count, 3, "There should have been 3 documents returned");
            }),
            TestCase("succeeds when there is no data", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                var results = await Find.All<SubDocument>(SqliteDb.TableName);
                Expect.isEmpty(results, "There should have been no documents returned");
            })
        ]),
        TestList("AllOrdered",
        [
            TestCase("succeeds when ordering numerically", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var results = await Find.AllOrdered<JsonDocument>(SqliteDb.TableName, [Field.Named("n:NumValue")]);
                Expect.hasLength(results, 5, "There should have been 5 documents returned");
                Expect.equal(string.Join('|', results.Select(x => x.Id)), "one|three|two|four|five",
                    "The documents were not ordered correctly");
            }),
            TestCase("succeeds when ordering numerically descending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var results = await Find.AllOrdered<JsonDocument>(SqliteDb.TableName, [Field.Named("n:NumValue DESC")]);
                Expect.hasLength(results, 5, "There should have been 5 documents returned");
                Expect.equal(string.Join('|', results.Select(x => x.Id)), "five|four|two|three|one",
                    "The documents were not ordered correctly");
            }),
            TestCase("succeeds when ordering alphabetically", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var results = await Find.AllOrdered<JsonDocument>(SqliteDb.TableName, [Field.Named("Id DESC")]);
                Expect.hasLength(results, 5, "There should have been 5 documents returned");
                Expect.equal(string.Join('|', results.Select(x => x.Id)), "two|three|one|four|five",
                    "The documents were not ordered correctly");
            })
        ]),
        TestList("ById",
        [
            TestCase("succeeds when a document is found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var doc = await Find.ById<string, JsonDocument>(SqliteDb.TableName, "two");
                Expect.isNotNull(doc, "There should have been a document returned");
                Expect.equal(doc!.Id, "two", "The incorrect document was returned");
            }),
            TestCase("succeeds when a document is not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var doc = await Find.ById<string, JsonDocument>(SqliteDb.TableName, "twenty two");
                Expect.isNull(doc, "There should not have been a document returned");
            })
        ]),
        TestList("ByFields",
        [
            TestCase("succeeds when documents are found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var docs = await Find.ByFields<JsonDocument>(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Greater("NumValue", 15)]);
                Expect.equal(docs.Count, 2, "There should have been two documents returned");
            }),
            TestCase("succeeds when documents are found using IN with numeric field", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var docs = await Find.ByFields<JsonDocument>(SqliteDb.TableName, FieldMatch.All,
                    [Field.In("NumValue", [2, 4, 6, 8])]);
                Expect.hasLength(docs, 1, "There should have been one document returned");
            }),
            TestCase("succeeds when documents are not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var docs = await Find.ByFields<JsonDocument>(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Equal("Value", "mauve")]);
                Expect.isEmpty(docs, "There should have been no documents returned");
            }),
            TestCase("succeeds for InArray when matching documents exist", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await Definition.EnsureTable(SqliteDb.TableName);
                foreach (var doc in ArrayDocument.TestDocuments) await Document.Insert(SqliteDb.TableName, doc);

                var docs = await Find.ByFields<ArrayDocument>(SqliteDb.TableName, FieldMatch.All,
                    [Field.InArray("Values", SqliteDb.TableName, ["c"])]);
                Expect.hasLength(docs, 2, "There should have been two document returned");
            }),
            TestCase("succeeds for InArray when no matching documents exist", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await Definition.EnsureTable(SqliteDb.TableName);
                foreach (var doc in ArrayDocument.TestDocuments) await Document.Insert(SqliteDb.TableName, doc);

                var docs = await Find.ByFields<ArrayDocument>(SqliteDb.TableName, FieldMatch.All,
                    [Field.InArray("Values", SqliteDb.TableName, ["j"])]);
                Expect.isEmpty(docs, "There should have been no documents returned");
            })
        ]),
        TestList("ByFieldsOrdered",
        [
            TestCase("succeeds when documents are found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var docs = await Find.ByFieldsOrdered<JsonDocument>(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Greater("NumValue", 15)], [Field.Named("Id")]);
                Expect.hasLength(docs, 2, "There should have been two documents returned");
                Expect.equal(string.Join('|', docs.Select(x => x.Id)), "five|four",
                    "The documents were not sorted correctly");
            }),
            TestCase("succeeds when documents are not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var docs = await Find.ByFieldsOrdered<JsonDocument>(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Greater("NumValue", 15)], [Field.Named("Id DESC")]);
                Expect.hasLength(docs, 2, "There should have been two documents returned");
                Expect.equal(string.Join('|', docs.Select(x => x.Id)), "four|five",
                    "The documents were not sorted correctly");
            }),
            TestCase("succeeds when sorting case-sensitively", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var docs = await Find.ByFieldsOrdered<JsonDocument>(SqliteDb.TableName, FieldMatch.Any,
                    [Field.LessOrEqual("NumValue", 10)], [Field.Named("Value")]);
                Expect.hasLength(docs, 3, "There should have been three documents returned");
                Expect.equal(string.Join('|', docs.Select(x => x.Id)), "three|one|two",
                    "The documents were not sorted correctly");
            }),
            TestCase("succeeds when sorting case-insensitively", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var docs = await Find.ByFieldsOrdered<JsonDocument>(SqliteDb.TableName, FieldMatch.Any,
                    [Field.LessOrEqual("NumValue", 10)], [Field.Named("i:Value")]);
                Expect.hasLength(docs, 3, "There should have been three documents returned");
                Expect.equal(string.Join('|', docs.Select(x => x.Id)), "three|two|one",
                    "The documents were not sorted correctly");
            })
        ]),
        TestList("FirstByFields",
        [
            TestCase("succeeds when a document is found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var doc = await Find.FirstByFields<JsonDocument>(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Equal("Value", "another")]);
                Expect.isNotNull(doc, "There should have been a document returned");
                Expect.equal(doc!.Id, "two", "The incorrect document was returned");
            }),
            TestCase("succeeds when multiple documents are found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var doc = await Find.FirstByFields<JsonDocument>(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Equal("Sub.Foo", "green")]);
                Expect.isNotNull(doc, "There should have been a document returned");
                Expect.contains(["two", "four"], doc!.Id, "An incorrect document was returned");
            }),
            TestCase("succeeds when a document is not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var doc = await Find.FirstByFields<JsonDocument>(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Equal("Value", "absent")]);
                Expect.isNull(doc, "There should not have been a document returned");
            })
        ]),
        TestList("FirstByFieldsOrdered",
        [
            TestCase("succeeds when sorting ascending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var doc = await Find.FirstByFieldsOrdered<JsonDocument>(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Equal("Sub.Foo", "green")], [Field.Named("Sub.Bar")]);
                Expect.isNotNull(doc, "There should have been a document returned");
                Expect.equal("two", doc!.Id, "An incorrect document was returned");
            }),
            TestCase("succeeds when sorting descending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var doc = await Find.FirstByFieldsOrdered<JsonDocument>(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Equal("Sub.Foo", "green")], [Field.Named("Sub.Bar DESC")]);
                Expect.isNotNull(doc, "There should have been a document returned");
                Expect.equal("four", doc!.Id, "An incorrect document was returned");
            })
        ])
    ]);

    /// Integration tests for the Json module of the SQLite library
    private static readonly Test JsonTests = TestList("Json",
    [
        TestList("All",
        [
            TestCase("succeeds when there is data", async () =>
            {
                await using var db = await SqliteDb.BuildDb();

                await Document.Insert(SqliteDb.TableName, new SubDocument { Foo = "one", Bar = "two" });
                await Document.Insert(SqliteDb.TableName, new SubDocument { Foo = "three", Bar = "four" });
                await Document.Insert(SqliteDb.TableName, new SubDocument { Foo = "five", Bar = "six" });

                var json = await Json.All(SqliteDb.TableName);
                VerifyBeginEnd(json);
                Expect.stringContains(json, """{"Foo":"one","Bar":"two"}""", "The first document was not found");
                Expect.stringContains(json, """{"Foo":"three","Bar":"four"}""", "The second document was not found");
                Expect.stringContains(json, """{"Foo":"five","Bar":"six"}""", "The third document was not found");
            }),
            TestCase("succeeds when there is no data", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                VerifyEmpty(await Json.All(SqliteDb.TableName));
            })
        ]),
        TestList("AllOrdered",
        [
            TestCase("succeeds when ordering numerically", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(await Json.AllOrdered(SqliteDb.TableName, [Field.Named("n:NumValue")]),
                    $"[{JsonDocument.One},{JsonDocument.Three},{JsonDocument.Two},{JsonDocument.Four},{JsonDocument.Five}]",
                    "The documents were not ordered correctly");
            }),
            TestCase("succeeds when ordering numerically descending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(await Json.AllOrdered(SqliteDb.TableName, [Field.Named("n:NumValue DESC")]),
                    $"[{JsonDocument.Five},{JsonDocument.Four},{JsonDocument.Two},{JsonDocument.Three},{JsonDocument.One}]",
                    "The documents were not ordered correctly");
            }),
            TestCase("succeeds when ordering alphabetically", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(await Json.AllOrdered(SqliteDb.TableName, [Field.Named("Id DESC")]),
                    $"[{JsonDocument.Two},{JsonDocument.Three},{JsonDocument.One},{JsonDocument.Four},{JsonDocument.Five}]",
                    "The documents were not ordered correctly");
            })
        ]),
        TestList("ById",
        [
            TestCase("succeeds when a document is found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(await Json.ById(SqliteDb.TableName, "two"), JsonDocument.Two,
                    "The incorrect document was returned");
            }),
            TestCase("succeeds when a document is not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                VerifyNoDoc(await Json.ById(SqliteDb.TableName, "three hundred eighty-seven"));
            })
        ]),
        TestList("ByFields",
        [
            TestCase("succeeds when documents are found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var json = await Json.ByFields(SqliteDb.TableName, FieldMatch.Any, [Field.Greater("NumValue", 15)]);
                VerifyBeginEnd(json);
                Expect.stringContains(json, JsonDocument.Four, "Document `four` should have been returned");
                Expect.stringContains(json, JsonDocument.Five, "Document `five` should have been returned");
            }),
            TestCase("succeeds when documents are found using IN with numeric field", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(
                    await Json.ByFields(SqliteDb.TableName, FieldMatch.All, [Field.In("NumValue", [2, 4, 6, 8])]),
                    $"[{JsonDocument.Three}]", "There should have been one document returned");
            }),
            TestCase("succeeds when documents are not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                VerifyEmpty(await Json.ByFields(SqliteDb.TableName, FieldMatch.Any, [Field.Greater("NumValue", 100)]));
            }),
            TestCase("succeeds for InArray when matching documents exist", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await Definition.EnsureTable(SqliteDb.TableName);
                foreach (var doc in ArrayDocument.TestDocuments) await Document.Insert(SqliteDb.TableName, doc);

                var json = await Json.ByFields(SqliteDb.TableName, FieldMatch.All,
                    [Field.InArray("Values", SqliteDb.TableName, ["c"])]);
                VerifyBeginEnd(json);
                Expect.stringContains(json, """{"Id":"first","Values":["a","b","c"]}""",
                    "Document `first` should have been returned");
                Expect.stringContains(json, """{"Id":"second","Values":["c","d","e"]}""",
                    "Document `second` should have been returned");
            }),
            TestCase("succeeds for InArray when no matching documents exist", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await Definition.EnsureTable(SqliteDb.TableName);
                foreach (var doc in ArrayDocument.TestDocuments) await Document.Insert(SqliteDb.TableName, doc);
                VerifyEmpty(await Json.ByFields(SqliteDb.TableName, FieldMatch.All,
                    [Field.InArray("Values", SqliteDb.TableName, ["j"])]));
            })
        ]),
        TestList("ByFieldsOrdered",
        [
            TestCase("succeeds when sorting ascending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(
                    await Json.ByFieldsOrdered(SqliteDb.TableName, FieldMatch.Any, [Field.Greater("NumValue", 15)],
                        [Field.Named("Id")]), $"[{JsonDocument.Five},{JsonDocument.Four}]",
                    "Incorrect documents were returned");
            }),
            TestCase("succeeds when sorting descending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(
                    await Json.ByFieldsOrdered(SqliteDb.TableName, FieldMatch.Any, [Field.Greater("NumValue", 15)],
                        [Field.Named("Id DESC")]), $"[{JsonDocument.Four},{JsonDocument.Five}]",
                    "Incorrect documents were returned");
            }),
            TestCase("succeeds when sorting case-sensitively", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(
                    await Json.ByFieldsOrdered(SqliteDb.TableName, FieldMatch.All, [Field.LessOrEqual("NumValue", 10)],
                        [Field.Named("Value")]),
                    $"[{JsonDocument.Three},{JsonDocument.One},{JsonDocument.Two}]", "Documents not ordered correctly");
            }),
            TestCase("succeeds when sorting case-insensitively", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(
                    await Json.ByFieldsOrdered(SqliteDb.TableName, FieldMatch.All, [Field.LessOrEqual("NumValue", 10)],
                        [Field.Named("i:Value")]),
                    $"[{JsonDocument.Three},{JsonDocument.Two},{JsonDocument.One}]", "Documents not ordered correctly");
            })
        ]),
        TestList("FirstByFields",
        [
            TestCase("succeeds when a document is found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(
                    await Json.FirstByFields(SqliteDb.TableName, FieldMatch.Any, [Field.Equal("Value", "another")]),
                    JsonDocument.Two, "The incorrect document was returned");
            }),
            TestCase("succeeds when multiple documents are found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var json = await Json.FirstByFields(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Equal("Sub.Foo", "green")]);
                Expect.notEqual(json, "{}", "There should have been a document returned");
                VerifyAny(json, [JsonDocument.Two, JsonDocument.Four]);
            }),
            TestCase("succeeds when a document is not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                VerifyNoDoc(await Json.FirstByFields(SqliteDb.TableName, FieldMatch.Any,
                    [Field.Equal("Value", "absent")]));
            })
        ]),
        TestList("FirstByFieldsOrdered",
        [
            TestCase("succeeds when sorting ascending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(
                    await Json.FirstByFieldsOrdered(SqliteDb.TableName, FieldMatch.Any,
                        [Field.Equal("Sub.Foo", "green")], [Field.Named("Sub.Bar")]), JsonDocument.Two,
                    "An incorrect document was returned");
            }),
            TestCase("succeeds when sorting descending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();
                Expect.equal(
                    await Json.FirstByFieldsOrdered(SqliteDb.TableName, FieldMatch.Any,
                        [Field.Equal("Sub.Foo", "green")], [Field.Named("Sub.Bar DESC")]), JsonDocument.Four,
                    "An incorrect document was returned");
            })
        ]),
        TestList("WriteAll",
        [
            TestCase("succeeds when there is data", async () =>
            {
                await using var db = await SqliteDb.BuildDb();

                await Document.Insert(SqliteDb.TableName, new SubDocument { Foo = "one", Bar = "two" });
                await Document.Insert(SqliteDb.TableName, new SubDocument { Foo = "three", Bar = "four" });
                await Document.Insert(SqliteDb.TableName, new SubDocument { Foo = "five", Bar = "six" });

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteAll(SqliteDb.TableName, writer);
                    var json = StreamText(stream);
                    VerifyBeginEnd(json);
                    Expect.stringContains(json, """{"Foo":"one","Bar":"two"}""", "The first document was not found");
                    Expect.stringContains(json, """{"Foo":"three","Bar":"four"}""",
                        "The second document was not found");
                    Expect.stringContains(json, """{"Foo":"five","Bar":"six"}""", "The third document was not found");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when there is no data", async () =>
            {
                await using var db = await SqliteDb.BuildDb();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteAll(SqliteDb.TableName, writer);
                    VerifyEmpty(StreamText(stream));
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            })
        ]),
        TestList("WriteAllOrdered",
        [
            TestCase("succeeds when ordering numerically", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteAllOrdered(SqliteDb.TableName, writer, [Field.Named("n:NumValue")]);
                    Expect.equal(StreamText(stream),
                        $"[{JsonDocument.One},{JsonDocument.Three},{JsonDocument.Two},{JsonDocument.Four},{JsonDocument.Five}]",
                        "The documents were not ordered correctly");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when ordering numerically descending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteAllOrdered(SqliteDb.TableName, writer, [Field.Named("n:NumValue DESC")]);
                    Expect.equal(StreamText(stream),
                        $"[{JsonDocument.Five},{JsonDocument.Four},{JsonDocument.Two},{JsonDocument.Three},{JsonDocument.One}]",
                        "The documents were not ordered correctly");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when ordering alphabetically", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteAllOrdered(SqliteDb.TableName, writer, [Field.Named("Id DESC")]);
                    Expect.equal(StreamText(stream),
                        $"[{JsonDocument.Two},{JsonDocument.Three},{JsonDocument.One},{JsonDocument.Four},{JsonDocument.Five}]",
                        "The documents were not ordered correctly");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            })
        ]),
        TestList("WriteById",
        [
            TestCase("succeeds when a document is found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteById(SqliteDb.TableName, writer, "two");
                    Expect.equal(StreamText(stream), JsonDocument.Two, "The incorrect document was returned");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when a document is not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteById(SqliteDb.TableName, writer, "three hundred eighty-seven");
                    VerifyNoDoc(StreamText(stream));
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            })
        ]),
        TestList("WriteByFields",
        [
            TestCase("succeeds when documents are found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteByFields(SqliteDb.TableName, writer, FieldMatch.Any,
                        [Field.Greater("NumValue", 15)]);
                    var json = StreamText(stream);
                    VerifyBeginEnd(json);
                    Expect.stringContains(json, JsonDocument.Four, "Document `four` should have been returned");
                    Expect.stringContains(json, JsonDocument.Five, "Document `five` should have been returned");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when documents are found using IN with numeric field", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteByFields(SqliteDb.TableName, writer, FieldMatch.All,
                        [Field.In("NumValue", [2, 4, 6, 8])]);
                    Expect.equal(StreamText(stream), $"[{JsonDocument.Three}]",
                        "There should have been one document returned");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when documents are not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteByFields(SqliteDb.TableName, writer, FieldMatch.Any,
                        [Field.Greater("NumValue", 100)]);
                    VerifyEmpty(StreamText(stream));
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds for InArray when matching documents exist", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await Definition.EnsureTable(SqliteDb.TableName);
                foreach (var doc in ArrayDocument.TestDocuments) await Document.Insert(SqliteDb.TableName, doc);

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteByFields(SqliteDb.TableName, writer, FieldMatch.All,
                        [Field.InArray("Values", SqliteDb.TableName, ["c"])]);
                    var json = StreamText(stream);
                    VerifyBeginEnd(json);
                    Expect.stringContains(json, """{"Id":"first","Values":["a","b","c"]}""",
                        "Document `first` should have been returned");
                    Expect.stringContains(json, """{"Id":"second","Values":["c","d","e"]}""",
                        "Document `second` should have been returned");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds for InArray when no matching documents exist", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await Definition.EnsureTable(SqliteDb.TableName);
                foreach (var doc in ArrayDocument.TestDocuments) await Document.Insert(SqliteDb.TableName, doc);

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteByFields(SqliteDb.TableName, writer, FieldMatch.All,
                        [Field.InArray("Values", SqliteDb.TableName, ["j"])]);
                    VerifyEmpty(StreamText(stream));
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            })
        ]),
        TestList("WriteByFieldsOrdered",
        [
            TestCase("succeeds when sorting ascending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteByFieldsOrdered(SqliteDb.TableName, writer, FieldMatch.Any,
                        [Field.Greater("NumValue", 15)], [Field.Named("Id")]);
                    Expect.equal(StreamText(stream), $"[{JsonDocument.Five},{JsonDocument.Four}]",
                        "Incorrect documents were returned");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when sorting descending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteByFieldsOrdered(SqliteDb.TableName, writer, FieldMatch.Any,
                        [Field.Greater("NumValue", 15)], [Field.Named("Id DESC")]);
                    Expect.equal(StreamText(stream), $"[{JsonDocument.Four},{JsonDocument.Five}]",
                        "Incorrect documents were returned");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when sorting case-sensitively", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteByFieldsOrdered(SqliteDb.TableName, writer, FieldMatch.All,
                        [Field.LessOrEqual("NumValue", 10)], [Field.Named("Value")]);
                    Expect.equal(StreamText(stream), $"[{JsonDocument.Three},{JsonDocument.One},{JsonDocument.Two}]",
                        "Documents not ordered correctly");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when sorting case-insensitively", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteByFieldsOrdered(SqliteDb.TableName, writer, FieldMatch.All,
                        [Field.LessOrEqual("NumValue", 10)], [Field.Named("i:Value")]);
                    Expect.equal(StreamText(stream), $"[{JsonDocument.Three},{JsonDocument.Two},{JsonDocument.One}]",
                        "Documents not ordered correctly");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            })
        ]),
        TestList("WriteFirstByFields",
        [
            TestCase("succeeds when a document is found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteFirstByFields(SqliteDb.TableName, writer, FieldMatch.Any,
                        [Field.Equal("Value", "another")]);
                    Expect.equal(StreamText(stream), JsonDocument.Two, "The incorrect document was returned");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when multiple documents are found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteFirstByFields(SqliteDb.TableName, writer, FieldMatch.Any,
                        [Field.Equal("Sub.Foo", "green")]);
                    var json = StreamText(stream);
                    Expect.notEqual(json, "{}", "There should have been a document returned");
                    VerifyAny(json, [JsonDocument.Two, JsonDocument.Four]);
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when a document is not found", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteFirstByFields(SqliteDb.TableName, writer, FieldMatch.Any,
                        [Field.Equal("Value", "absent")]);
                    VerifyNoDoc(StreamText(stream));
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            })
        ]),
        TestList("WriteFirstByFieldsOrdered",
        [
            TestCase("succeeds when sorting ascending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteFirstByFieldsOrdered(SqliteDb.TableName, writer, FieldMatch.Any,
                        [Field.Equal("Sub.Foo", "green")], [Field.Named("Sub.Bar")]);
                    Expect.equal(StreamText(stream), JsonDocument.Two, "An incorrect document was returned");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            }),
            TestCase("succeeds when sorting descending", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                using MemoryStream stream = new();
                var writer = WriteStream(stream);
                try
                {
                    await Json.WriteFirstByFieldsOrdered(SqliteDb.TableName, writer, FieldMatch.Any,
                        [Field.Equal("Sub.Foo", "green")], [Field.Named("Sub.Bar DESC")]);
                    Expect.equal(StreamText(stream), JsonDocument.Four, "An incorrect document was returned");
                }
                finally
                {
                    await writer.CompleteAsync();
                }
            })
        ])
    ]);

    /// <summary>
    /// Integration tests for the Update module of the SQLite library
    /// </summary>
    private static readonly Test UpdateTests = TestList("Update",
    [
        TestList("ById",
        [
            TestCase("succeeds when a document is updated", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                var testDoc = new JsonDocument { Id = "one", Sub = new() { Foo = "blue", Bar = "red" } };
                await Update.ById(SqliteDb.TableName, "one", testDoc);
                var after = await Find.ById<string, JsonDocument>(SqliteDb.TableName, "one");
                Expect.isNotNull(after, "There should have been a document returned post-update");
                Expect.equal(after!.Id, "one", "The updated document is not correct");
                Expect.isNotNull(after.Sub, "The updated document should have had a sub-document");
                Expect.equal(after.Sub!.Foo, "blue", "The updated sub-document is not correct");
                Expect.equal(after.Sub.Bar, "red", "The updated sub-document is not correct");
            }),
            TestCase("succeeds when no document is updated", async () =>
            {
                await using var db = await SqliteDb.BuildDb();

                var before = await Find.All<JsonDocument>(SqliteDb.TableName);
                Expect.isEmpty(before, "There should have been no documents returned");

                // This not raising an exception is the test
                await Update.ById(SqliteDb.TableName, "test",
                    new JsonDocument { Id = "x", Sub = new() { Foo = "blue", Bar = "red" } });
            })
        ]),
        TestList("ByFunc",
        [
            TestCase("succeeds when a document is updated", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                await Update.ByFunc(SqliteDb.TableName, doc => doc.Id,
                    new JsonDocument { Id = "one", Value = "le un", NumValue = 1 });
                var after = await Find.ById<string, JsonDocument>(SqliteDb.TableName, "one");
                Expect.isNotNull(after, "There should have been a document returned post-update");
                Expect.equal(after!.Id, "one", "The updated document is incorrect");
                Expect.equal(after.Value, "le un", "The updated document is incorrect");
                Expect.equal(after.NumValue, 1, "The updated document is incorrect");
                Expect.isNull(after.Sub, "The updated document should not have a sub-document");
            }),
            TestCase("succeeds when no document is updated", async () =>
            {
                await using var db = await SqliteDb.BuildDb();

                var before = await Find.All<JsonDocument>(SqliteDb.TableName);
                Expect.isEmpty(before, "There should have been no documents returned");

                // This not raising an exception is the test
                await Update.ByFunc(SqliteDb.TableName, doc => doc.Id,
                    new JsonDocument { Id = "one", Value = "le un", NumValue = 1 });
            })
        ]),
    ]);

    /// <summary>
    /// Integration tests for the Patch module of the SQLite library
    /// </summary>
    private static readonly Test PatchTests = TestList("Patch",
    [
        TestList("ById",
        [
            TestCase("succeeds when a document is updated", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                await Patch.ById(SqliteDb.TableName, "one", new { NumValue = 44 });
                var after = await Find.ById<string, JsonDocument>(SqliteDb.TableName, "one");
                Expect.isNotNull(after, "There should have been a document returned post-update");
                Expect.equal(after!.Id, "one", "The updated document is not correct");
                Expect.equal(after.NumValue, 44, "The updated document is not correct");
            }),
            TestCase("succeeds when no document is updated", async () =>
            {
                await using var db = await SqliteDb.BuildDb();

                var before = await Find.All<JsonDocument>(SqliteDb.TableName);
                Expect.isEmpty(before, "There should have been no documents returned");

                // This not raising an exception is the test
                await Patch.ById(SqliteDb.TableName, "test", new { Foo = "green" });
            })
        ]),
        TestList("ByFields",
        [
            TestCase("succeeds when a document is updated", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                await Patch.ByFields(SqliteDb.TableName, FieldMatch.Any, [Field.Equal("Value", "purple")],
                    new { NumValue = 77 });
                var after = await Count.ByFields(SqliteDb.TableName, FieldMatch.Any, [Field.Equal("NumValue", 77)]);
                Expect.equal(after, 2L, "There should have been 2 documents returned");
            }),
            TestCase("succeeds when no document is updated", async () =>
            {
                await using var db = await SqliteDb.BuildDb();

                var before = await Find.All<SubDocument>(SqliteDb.TableName);
                Expect.isEmpty(before, "There should have been no documents returned");

                // This not raising an exception is the test
                await Patch.ByFields(SqliteDb.TableName, FieldMatch.Any, [Field.Equal("Value", "burgundy")],
                    new { Foo = "green" });
            })
        ])
    ]);

    /// <summary>
    /// Integration tests for the RemoveFields module of the SQLite library
    /// </summary>
    private static readonly Test RemoveFieldsTests = TestList("RemoveFields",
    [
        TestList("ById",
        [
            TestCase("succeeds when fields are removed", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                await RemoveFields.ById(SqliteDb.TableName, "two", ["Sub", "Value"]);
                var updated = await Find.ById<string, JsonDocument>(SqliteDb.TableName, "two");
                Expect.isNotNull(updated, "The updated document should have been retrieved");
                Expect.equal(updated.Value, "", "The string value should have been removed");
                Expect.isNull(updated.Sub, "The sub-document should have been removed");
            }),
            TestCase("succeeds when a field is not removed", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                // This not raising an exception is the test
                await RemoveFields.ById(SqliteDb.TableName, "two", ["AFieldThatIsNotThere"]);
            }),
            TestCase("succeeds when no document is matched", async () =>
            {
                await using var db = await SqliteDb.BuildDb();

                // This not raising an exception is the test
                await RemoveFields.ById(SqliteDb.TableName, "two", ["Value"]);
            })
        ]),
        TestList("ByFields",
        [
            TestCase("succeeds when a field is removed", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                await RemoveFields.ByFields(SqliteDb.TableName, FieldMatch.Any, [Field.Equal("NumValue", 17)], ["Sub"]);
                var updated = await Find.ById<string, JsonDocument>(SqliteDb.TableName, "four");
                Expect.isNotNull(updated, "The updated document should have been retrieved");
                Expect.isNull(updated.Sub, "The sub-document should have been removed");
            }),
            TestCase("succeeds when a field is not removed", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                // This not raising an exception is the test
                await RemoveFields.ByFields(SqliteDb.TableName, FieldMatch.Any, [Field.Equal("NumValue", 17)],
                    ["Nothing"]);
            }),
            TestCase("succeeds when no document is matched", async () =>
            {
                await using var db = await SqliteDb.BuildDb();

                // This not raising an exception is the test
                await RemoveFields.ByFields(SqliteDb.TableName, FieldMatch.Any,
                    [Field.NotEqual("Abracadabra", "apple")], ["Value"]);
            })
        ])
    ]);

    /// <summary>
    /// Integration tests for the Delete module of the SQLite library
    /// </summary>
    private static readonly Test DeleteTests = TestList("Delete",
    [
        TestList("ById",
        [
            TestCase("succeeds when a document is deleted", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                await Delete.ById(SqliteDb.TableName, "four");
                var remaining = await Count.All(SqliteDb.TableName);
                Expect.equal(remaining, 4L, "There should have been 4 documents remaining");
            }),
            TestCase("succeeds when a document is not deleted", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                await Delete.ById(SqliteDb.TableName, "thirty");
                var remaining = await Count.All(SqliteDb.TableName);
                Expect.equal(remaining, 5L, "There should have been 5 documents remaining");
            })
        ]),
        TestList("ByFields",
        [
            TestCase("succeeds when documents are deleted", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                await Delete.ByFields(SqliteDb.TableName, FieldMatch.Any, [Field.NotEqual("Value", "purple")]);
                var remaining = await Count.All(SqliteDb.TableName);
                Expect.equal(remaining, 2L, "There should have been 2 documents remaining");
            }),
            TestCase("succeeds when documents are not deleted", async () =>
            {
                await using var db = await SqliteDb.BuildDb();
                await LoadDocs();

                await Delete.ByFields(SqliteDb.TableName, FieldMatch.All, [Field.Equal("Value", "crimson")]);
                var remaining = await Count.All(SqliteDb.TableName);
                Expect.equal(remaining, 5L, "There should have been 5 documents remaining");
            })
        ])
    ]);

    /// <summary>
    /// All tests for SQLite C# functions and methods
    /// </summary>
    [Tests]
    public static readonly Test All = TestList("Sqlite.C#",
    [
        TestList("Unit", [QueryTests, ParametersTests]),
        TestSequenced(TestList("Integration",
        [
            ConfigurationTests,
            CustomTests,
            DefinitionTests,
            DocumentTests,
            CountTests,
            ExistsTests,
            FindTests,
            JsonTests,
            UpdateTests,
            PatchTests,
            RemoveFieldsTests,
            DeleteTests,
            TestCase("Clean up database", () => Sqlite.Configuration.UseConnectionString("data source=:memory:"))
        ]))
    ]);
}