feat(bp): IBattlePassService skeleton + level-curve method + DI

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);

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);

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,
+}

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),
+            });
+    }
+}

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).
+}