From 9043e206467da629c45ac465257449984f5df5d7 Mon Sep 17 00:00:00 2001
From: gamer147 <gamer147@gmail.com>
Date: Tue, 26 May 2026 22:49:30 -0400
Subject: [PATCH] feat(bp): IBattlePassService skeleton + level-curve method +
 DI

---
 .../Models/Dtos/BattlePassLevel.cs            | 11 ++++++--
 SVSim.EmulatedEntrypoint/Program.cs           |  6 ++++
 .../Services/BattlePassBuyOutcome.cs          | 14 ++++++++++
 .../Services/BattlePassPointGrant.cs          | 17 +++++++++++
 .../Services/BattlePassPointSource.cs         | 12 ++++++++
 .../Services/BattlePassService.cs             | 28 +++++++++++++++++++
 .../Services/IBattlePassService.cs            | 11 ++++++++
 7 files changed, 96 insertions(+), 3 deletions(-)
 create mode 100644 SVSim.EmulatedEntrypoint/Services/BattlePassBuyOutcome.cs
 create mode 100644 SVSim.EmulatedEntrypoint/Services/BattlePassPointGrant.cs
 create mode 100644 SVSim.EmulatedEntrypoint/Services/BattlePassPointSource.cs
 create mode 100644 SVSim.EmulatedEntrypoint/Services/BattlePassService.cs
 create mode 100644 SVSim.EmulatedEntrypoint/Services/IBattlePassService.cs

diff --git a/SVSim.EmulatedEntrypoint/Models/Dtos/BattlePassLevel.cs b/SVSim.EmulatedEntrypoint/Models/Dtos/BattlePassLevel.cs
index 23a1c00..e878f43 100644
--- a/SVSim.EmulatedEntrypoint/Models/Dtos/BattlePassLevel.cs
+++ b/SVSim.EmulatedEntrypoint/Models/Dtos/BattlePassLevel.cs
@@ -3,13 +3,18 @@ using System.Text.Json.Serialization;
 
 namespace SVSim.EmulatedEntrypoint.Models.Dtos;
 
+/// <summary>
+/// One entry under <c>/load/index.battle_pass_level_info</c>. Per memory
+/// project_wire_key_serialization, wire ints are strings here — client parses them via .ToInt().
+/// </summary>
 [MessagePackObject]
 public class BattlePassLevel
 {
     [JsonPropertyName("level")]
     [Key("level")]
-    public int Level { get; set; }
+    public string Level { get; set; } = "";
+
     [JsonPropertyName("required_point")]
     [Key("required_point")]
-    public int RequiredPoints { get; set; }
-}
\ No newline at end of file
+    public string RequiredPoint { get; set; } = "";
+}
diff --git a/SVSim.EmulatedEntrypoint/Program.cs b/SVSim.EmulatedEntrypoint/Program.cs
index 6e6c187..8d06003 100644
--- a/SVSim.EmulatedEntrypoint/Program.cs
+++ b/SVSim.EmulatedEntrypoint/Program.cs
@@ -83,6 +83,12 @@ public class Program
         builder.Services.AddScoped<PackOpenService>();
         builder.Services.AddScoped<ICardAcquisitionService, CardAcquisitionService>();
         builder.Services.AddScoped<RewardGrantService>();
+        builder.Services.AddScoped<SVSim.Database.Repositories.BattlePass.IBattlePassRepository,
+                                    SVSim.Database.Repositories.BattlePass.BattlePassRepository>();
+        builder.Services.AddScoped<SVSim.Database.Repositories.BattlePass.IViewerBattlePassRepository,
+                                    SVSim.Database.Repositories.BattlePass.ViewerBattlePassRepository>();
+        builder.Services.AddScoped<IBattlePassService, BattlePassService>();
+        builder.Services.AddSingleton<TimeProvider>(TimeProvider.System);
         builder.Services.AddScoped<IStoryMasterRepository, StoryMasterRepository>();
         builder.Services.AddScoped<IViewerStoryProgressRepository, ViewerStoryProgressRepository>();
         builder.Services.AddScoped<IStoryService, StoryService>();
diff --git a/SVSim.EmulatedEntrypoint/Services/BattlePassBuyOutcome.cs b/SVSim.EmulatedEntrypoint/Services/BattlePassBuyOutcome.cs
new file mode 100644
index 0000000..5d7060f
--- /dev/null
+++ b/SVSim.EmulatedEntrypoint/Services/BattlePassBuyOutcome.cs
@@ -0,0 +1,14 @@
+using SVSim.Database.Services;
+
+namespace SVSim.EmulatedEntrypoint.Services;
+
+/// <summary>
+/// Result of <see cref="IBattlePassService.BuyPremiumAsync"/>. <c>AchievedRewards</c> = the
+/// delta that was just granted (goes into <c>achieved_info.battle_pass_reward_list</c>);
+/// <c>PostStateTotals</c> = post-state totals for affected goods (goes into <c>reward_list</c>),
+/// including the crystal deduction per memory project_wire_reward_list_post_state.
+/// </summary>
+public sealed record BattlePassBuyOutcome(
+    int ResultCode,
+    IReadOnlyList<GrantedReward> AchievedRewards,
+    IReadOnlyList<GrantedReward> PostStateTotals);
diff --git a/SVSim.EmulatedEntrypoint/Services/BattlePassPointGrant.cs b/SVSim.EmulatedEntrypoint/Services/BattlePassPointGrant.cs
new file mode 100644
index 0000000..686d7ea
--- /dev/null
+++ b/SVSim.EmulatedEntrypoint/Services/BattlePassPointGrant.cs
@@ -0,0 +1,17 @@
+using SVSim.Database.Services;
+
+namespace SVSim.EmulatedEntrypoint.Services;
+
+/// <summary>
+/// Result of <see cref="IBattlePassService.AddPointsAsync"/>. Future point-source endpoints
+/// (mission/retire, battle finish handlers) translate this into the embedded
+/// <c>battle_pass_gauge_info</c> block on their response.
+/// </summary>
+public sealed record BattlePassPointGrant(
+    int BeforePoint,
+    int BeforeLevel,
+    int AfterPoint,
+    int AfterLevel,
+    int PointAdd,
+    BattlePassPointSource Source,
+    IReadOnlyList<GrantedReward> NewlyClaimed);
diff --git a/SVSim.EmulatedEntrypoint/Services/BattlePassPointSource.cs b/SVSim.EmulatedEntrypoint/Services/BattlePassPointSource.cs
new file mode 100644
index 0000000..9765cf1
--- /dev/null
+++ b/SVSim.EmulatedEntrypoint/Services/BattlePassPointSource.cs
@@ -0,0 +1,12 @@
+namespace SVSim.EmulatedEntrypoint.Services;
+
+/// <summary>
+/// Which categorized field on <c>battle_pass_gauge_info</c> a point grant feeds. Mirrors the
+/// breakdown shown by <c>BattlePassResultPanel</c> after a win.
+/// </summary>
+public enum BattlePassPointSource
+{
+    BattleResult,
+    DailyMission,
+    BattlePassMission,
+}
diff --git a/SVSim.EmulatedEntrypoint/Services/BattlePassService.cs b/SVSim.EmulatedEntrypoint/Services/BattlePassService.cs
new file mode 100644
index 0000000..061049e
--- /dev/null
+++ b/SVSim.EmulatedEntrypoint/Services/BattlePassService.cs
@@ -0,0 +1,28 @@
+using System.Globalization;
+using SVSim.Database.Repositories.BattlePass;
+using SVSim.EmulatedEntrypoint.Models.Dtos;
+
+namespace SVSim.EmulatedEntrypoint.Services;
+
+public sealed class BattlePassService : IBattlePassService
+{
+    private readonly IBattlePassRepository _bp;
+
+    public BattlePassService(IBattlePassRepository bp)
+    {
+        _bp = bp;
+    }
+
+    public async Task<IReadOnlyDictionary<string, BattlePassLevel>?> GetLevelCurveAsync(CancellationToken ct)
+    {
+        var rows = await _bp.GetLevelCurveAsync(ct);
+        if (rows.Count == 0) return null;
+        return rows.ToDictionary(
+            r => r.Level.ToString(CultureInfo.InvariantCulture),
+            r => new BattlePassLevel
+            {
+                Level = r.Level.ToString(CultureInfo.InvariantCulture),
+                RequiredPoint = r.RequiredPoint.ToString(CultureInfo.InvariantCulture),
+            });
+    }
+}
diff --git a/SVSim.EmulatedEntrypoint/Services/IBattlePassService.cs b/SVSim.EmulatedEntrypoint/Services/IBattlePassService.cs
new file mode 100644
index 0000000..5aa0637
--- /dev/null
+++ b/SVSim.EmulatedEntrypoint/Services/IBattlePassService.cs
@@ -0,0 +1,11 @@
+using SVSim.EmulatedEntrypoint.Models.Dtos;
+
+namespace SVSim.EmulatedEntrypoint.Services;
+
+public interface IBattlePassService
+{
+    /// <summary>Global level curve as wire-string dictionary; null if no levels seeded.</summary>
+    Task<IReadOnlyDictionary<string, BattlePassLevel>?> GetLevelCurveAsync(CancellationToken ct);
+
+    // The Info / ItemList / Buy / AddPoints methods are added in later tasks (11, 12, 13, 14).
+}