Add Translation Quiz game mode, winning streak, high score, timer expiry reveal, and Playwright E2E tests

source/Demo/Lexicala.NET.Demo.Api/Game/GameServiceHelpers.cs

@@ -0,0 +1,22 @@
+using Lexicala.NET.Response;
+
+namespace Lexicala.NET.Demo.Api.Game;
+
+internal static class GameServiceHelpers
+{
+    internal static RateLimitDebugResponse? BuildRateLimit(ResponseMetadata? metadata)
+    {
+        var limits = metadata?.RateLimits;
+        if (limits is null)
+        {
+            return null;
+        }
+
+        if (limits.Limit < 0 || limits.LimitRemaining < 0 || limits.Reset < 0)
+        {
+            return null;
+        }
+
+        return new RateLimitDebugResponse(limits.Limit, limits.LimitRemaining, limits.Reset);
+    }
+}

source/Demo/Lexicala.NET.Demo.Api/Game/ITranslationQuizGameService.cs

@@ -0,0 +1,14 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace Lexicala.NET.Demo.Api.Game;
+
+public interface ITranslationQuizGameService
+{
+    Task<CreateQuizRoundResponse> CreateRoundAsync(string? targetLanguage = null, CancellationToken cancellationToken = default);
+
+    Task<QuizAnswerResponse> SubmitAnswerAsync(Guid roundId, string choice, CancellationToken cancellationToken = default);
+
+    Task<QuizAnswerResponse> ExpireRoundAsync(Guid roundId, CancellationToken cancellationToken = default);
+}

source/Demo/Lexicala.NET.Demo.Api/Game/SenseSprintGameService.cs

@@ -157,19 +157,31 @@ public Task<GuessResponse> SubmitGuessAsync(Guid roundId, string guess, Cancella
     public Task<GuessResponse> GiveUpAsync(Guid roundId, CancellationToken cancellationToken = default)
     {
         var round = GetRequiredRound(roundId);
-        EnsureRoundIsActive(roundId, round);
+
+        if (round.IsCompleted)
+        {
+            return Task.FromResult(new GuessResponse(
+                roundId,
+                false,
+                "completed",
+                0,
+                round.CurrentClueIndex,
+                round.Answer,
+                "Round already completed. Start a new round."));
+        }
 
         round.IsCompleted = true;
         _cache.Set(roundId, round, round.ExpiresAtUtc);
 
+        var isExpired = DateTimeOffset.UtcNow > round.ExpiresAtUtc;
         return Task.FromResult(new GuessResponse(
             roundId,
             false,
-            "lost",
+            isExpired ? "expired" : "lost",
             0,
             round.CurrentClueIndex,
             round.Answer,
-            "Round ended. Better luck next time."));
+            isExpired ? "Time's up! The answer was revealed." : "Round ended. Better luck next time."));
     }
 
     private async Task<SenseSprintRoundState?> TryGenerateRoundAsync(CancellationToken cancellationToken)
@@ -208,26 +220,10 @@ public Task<GuessResponse> GiveUpAsync(Guid roundId, CancellationToken cancellat
             CurrentClueIndex = 0,
             IsCompleted = false,
             ExpiresAtUtc = DateTimeOffset.UtcNow.AddSeconds(RoundSeconds),
-            RateLimit = BuildRateLimit(entry.Metadata) ?? BuildRateLimit(fluky.Metadata)
+            RateLimit = GameServiceHelpers.BuildRateLimit(entry.Metadata) ?? GameServiceHelpers.BuildRateLimit(fluky.Metadata)
         };
     }
 
-    private static RateLimitDebugResponse? BuildRateLimit(ResponseMetadata? metadata)
-    {
-        var limits = metadata?.RateLimits;
-        if (limits is null)
-        {
-            return null;
-        }
-
-        if (limits.Limit < 0 || limits.LimitRemaining < 0 || limits.Reset < 0)
-        {
-            return null;
-        }
-
-        return new RateLimitDebugResponse(limits.Limit, limits.LimitRemaining, limits.Reset);
-    }
-
     private static List<string> BuildClues(Entry entry, Sense sense, string answer)
     {
         var clues = new List<string>(capacity: 4)

source/Demo/Lexicala.NET.Demo.Api/Game/TranslationQuizContracts.cs

@@ -0,0 +1,25 @@
+using System;
+
+namespace Lexicala.NET.Demo.Api.Game;
+
+public sealed record CreateQuizRoundResponse(
+    Guid RoundId,
+    string SourceWord,
+    string SourceLanguage,
+    string TargetLanguage,
+    string[] Choices,
+    DateTimeOffset ExpiresAtUtc,
+    int RoundSeconds,
+    RateLimitDebugResponse? RateLimit
+);
+
+public sealed record QuizAnswerRequest(string Choice);
+
+public sealed record QuizAnswerResponse(
+    Guid RoundId,
+    bool IsCorrect,
+    string RoundStatus,
+    int AwardedPoints,
+    string CorrectAnswer,
+    string? Message
+);