SVSimServer/SVSim.UnitTests/Controllers/TutorialControllerTests.cs

using System.Net;
using System.Text;
using System.Text.Json;
using NUnit.Framework;
using SVSim.UnitTests.Infrastructure;

namespace SVSim.UnitTests.Controllers;

public class TutorialControllerTests
{
    [Test]
    public async Task UpdateAction_returns_result_code_1_with_empty_data()
    {
        using var factory = new SVSimTestFactory();
        long viewerId = await factory.SeedViewerAsync(tutorialState: 0);
        using var client = factory.CreateAuthenticatedClient(viewerId);

        // tutorial_step and tutorial_action_number are fire-and-forget bookkeeping fields;
        // send representative values from the live capture (step=1, action=2).
        var requestJson =
            """{"tutorial_step":1,"tutorial_action_number":2,"viewer_id":"0","steam_id":0,"steam_session_ticket":""}""";

        var response = await client.PostAsync("/tutorial/update_action",
            new StringContent(requestJson, Encoding.UTF8, "application/json"));

        Assert.That(response.StatusCode, Is.EqualTo(HttpStatusCode.OK));
        var body = await response.Content.ReadAsStringAsync();

        // Controllers return the INNER data payload; envelope is middleware's job.
        // For the no-op shape the action returns an empty object.
        using var doc = JsonDocument.Parse(body);
        Assert.That(doc.RootElement.ValueKind, Is.EqualTo(JsonValueKind.Object));
        Assert.That(doc.RootElement.EnumerateObject().Count(), Is.EqualTo(0),
            "update_action returns empty data — client uses SkipAllNetworkChecks and reads nothing.");
    }

    [TestCase(11)]
    [TestCase(21)]
    [TestCase(31)]
    public async Task Update_echoes_requested_step_and_persists(int step)
    {
        using var factory = new SVSimTestFactory();
        long viewerId = await factory.SeedViewerAsync(tutorialState: 0);
        using var client = factory.CreateAuthenticatedClient(viewerId);

        var requestJson = $$"""
        {"tutorial_step":{{step}},"is_skip":0,"viewer_id":"0","steam_id":0,"steam_session_ticket":""}
        """;

        var response = await client.PostAsync("/tutorial/update",
            new StringContent(requestJson, Encoding.UTF8, "application/json"));

        Assert.That(response.StatusCode, Is.EqualTo(HttpStatusCode.OK));
        using var doc = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
        Assert.That(doc.RootElement.GetProperty("tutorial_step").GetInt32(), Is.EqualTo(step));

        // Side effect: viewer state advanced.
        Assert.That(await factory.GetViewerTutorialStateAsync(viewerId), Is.EqualTo(step));
    }

    [Test]
    public async Task Update_with_is_skip_1_jumps_to_100()
    {
        using var factory = new SVSimTestFactory();
        long viewerId = await factory.SeedViewerAsync(tutorialState: 0);
        using var client = factory.CreateAuthenticatedClient(viewerId);

        // The client sends the step it's MOVING TO. is_skip=1 means "skip the rest" — typically
        // sent with tutorial_step=100 already (matches what `TutorialUpdateTask` does with the
        // is_skip flag), so the server's job is just to honor whatever value is provided.
        var requestJson = """{"tutorial_step":100,"is_skip":1,"viewer_id":"0","steam_id":0,"steam_session_ticket":""}""";

        var response = await client.PostAsync("/tutorial/update",
            new StringContent(requestJson, Encoding.UTF8, "application/json"));

        using var doc = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
        Assert.That(doc.RootElement.GetProperty("tutorial_step").GetInt32(), Is.EqualTo(100));
        Assert.That(await factory.GetViewerTutorialStateAsync(viewerId), Is.EqualTo(100));
    }

    [Test]
    public async Task Update_does_not_regress_step()
    {
        using var factory = new SVSimTestFactory();
        long viewerId = await factory.SeedViewerAsync(tutorialState: 100);
        using var client = factory.CreateAuthenticatedClient(viewerId);

        // Stale/replayed request: client thinks state is still 11 and sends an update for it.
        var requestJson = """{"tutorial_step":11,"is_skip":0,"viewer_id":"0","steam_id":0,"steam_session_ticket":""}""";
        var response = await client.PostAsync("/tutorial/update",
            new StringContent(requestJson, Encoding.UTF8, "application/json"));

        Assert.That(response.StatusCode, Is.EqualTo(HttpStatusCode.OK));
        using var doc = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
        Assert.That(doc.RootElement.GetProperty("tutorial_step").GetInt32(), Is.EqualTo(11),
            "Response echoes the requested step (the client confirms its own transition).");

        Assert.That(await factory.GetViewerTutorialStateAsync(viewerId), Is.EqualTo(100),
            "Persisted state must NOT regress. Math.Max(current, requested) — mirrors the " +
            "31→41 max-preserve pattern in GiftController.TutorialGiftReceive.");
    }
}