feat(card): /card/create_foil_card Seer's Globe conversion (1 orb + 1 base → 1 foil)

SVSim.EmulatedEntrypoint/Controllers/CardController.cs

@@ -1,7 +1,11 @@
 using Microsoft.AspNetCore.Mvc;
+using Microsoft.EntityFrameworkCore;
+using SVSim.Database;
 using SVSim.Database.Enums;
+using SVSim.Database.Models;
 using SVSim.Database.Repositories.Card;
 using SVSim.Database.Services;
+using SVSim.Database.Services.Inventory;
 using SVSim.EmulatedEntrypoint.Models.Dtos;
 using SVSim.EmulatedEntrypoint.Models.Dtos.Requests.Card;
 using SVSim.EmulatedEntrypoint.Models.Dtos.Responses.Card;
@@ -10,18 +14,28 @@ using System.Text.Json;
 namespace SVSim.EmulatedEntrypoint.Controllers;
 
 /// <summary>
-/// /card/* — viewer card-inventory mutations. Ships /card/destruct, /card/create, /card/protect.
-/// /card/create_foil_card is reserved for a follow-up slice.
+/// /card/* — viewer card-inventory mutations. Ships /card/destruct, /card/create, /card/protect,
+/// /card/create_foil_card.
 /// </summary>
 [Route("card")]
 public class CardController : SVSimController
 {
+    /// <summary>Item catalog id for Orb (Seer's Globe currency). Source: PremiumCardConversionTask</summary>
+    private const int OrbItemId = 1000;
+
+    /// <summary>Per-card ownership cap mirrored from the client gate (CardDetailUI.cs:2261).</summary>
+    private const int MaxCardCopies = 3;
+
     private readonly ICardInventoryRepository _inventory;
+    private readonly IInventoryService _inv;
+    private readonly SVSimDbContext _db;
     private readonly ILogger<CardController> _log;
 
-    public CardController(ICardInventoryRepository inventory, ILogger<CardController> log)
+    public CardController(ICardInventoryRepository inventory, IInventoryService inv, SVSimDbContext db, ILogger<CardController> log)
     {
         _inventory = inventory;
+        _inv = inv;
+        _db = db;
         _log = log;
     }
 
@@ -132,6 +146,82 @@ public class CardController : SVSimController
         _ => "malformed_request",
     };
 
+    /// <summary>
+    /// Seer's Globe conversion (decomp: Wizard/PremiumCardConversionTask.cs). Spends N Orbs
+    /// (Item 1000) + N copies of the base card, grants N copies of the foil twin (base.Id + 1).
+    /// Foil convention is the documented one on <see cref="ShadowverseCardEntry.IsFoil"/> —
+    /// the foil twin shares the base's CardSet at card_id = base + 1. The 3-copy cap is mirrored
+    /// from the client gate (CardDetailUI.cs:2261); reject server-side too so direct API hits
+    /// can't bypass.
+    /// </summary>
+    [HttpPost("create_foil_card")]
+    public async Task<ActionResult<CardCreateFoilCardResponse>> CreateFoilCard(
+        CardCreateFoilCardRequest request, CancellationToken ct)
+    {
+        if (!TryGetViewerId(out long viewerId)) return Unauthorized();
+        if (request.CreateNumber < 1) return BadRequest(new { error = "invalid_create_number" });
+
+        var baseCard = await _db.Set<ShadowverseCardEntry>()
+            .FirstOrDefaultAsync(c => c.Id == request.BaseCardId, ct);
+        if (baseCard is null || baseCard.IsFoil)
+            return BadRequest(new { error = "invalid_base_card" });
+
+        var foilCard = await _db.Set<ShadowverseCardEntry>()
+            .FirstOrDefaultAsync(c => c.Id == baseCard.Id + 1 && c.IsFoil, ct);
+        if (foilCard is null)
+            return BadRequest(new { error = "no_foil_variant" });
+
+        await using var tx = await _inv.BeginAsync(viewerId, ct);
+        var viewer = tx.Viewer;
+
+        var baseOwned = viewer.Cards.FirstOrDefault(c => c.Card.Id == baseCard.Id);
+        if (baseOwned is null || baseOwned.Count < request.CreateNumber)
+            return BadRequest(new { error = "insufficient_base_card" });
+
+        var foilOwned = viewer.Cards.FirstOrDefault(c => c.Card.Id == foilCard.Id);
+        int existingFoilCount = foilOwned?.Count ?? 0;
+        if (existingFoilCount + request.CreateNumber > MaxCardCopies)
+            return BadRequest(new { error = "would_exceed_max_copies" });
+
+        // Snapshot mismatch is warn-log only — matches the /card/create + /card/destruct pattern.
+        if (request.BaseCardNumber != baseOwned.Count)
+        {
+            _log.LogWarning(
+                "CreateFoilCard possession-snapshot mismatch: card={BaseCardId} client_snapshot={Snapshot} server={Server}",
+                request.BaseCardId, request.BaseCardNumber, baseOwned.Count);
+        }
+
+        // Spend Orbs first so an Orb-poor viewer keeps their base copy on failure. The inventory
+        // facade throws InventoryCatalogException when the item has never been owned at all (no
+        // OwnedItemEntry row), so pre-check rather than relying on TryDebitAsync alone.
+        var orbOwned = viewer.Items.FirstOrDefault(i => i.Item.Id == OrbItemId);
+        if (orbOwned is null || orbOwned.Count < request.CreateNumber)
+            return BadRequest(new { error = "insufficient_orb" });
+        var orbSpend = await tx.TryDebitAsync(UserGoodsType.Item, OrbItemId, request.CreateNumber, ct);
+        if (!orbSpend.Success)
+            return BadRequest(new { error = "insufficient_orb" });
+
+        // Debit base copies directly (InventoryTransaction.TryDebitAsync doesn't route Card).
+        baseOwned.Count -= request.CreateNumber;
+
+        // Grant foil copies via the canonical primitive so CardCosmeticReward cascades fire.
+        await tx.GrantAsync(UserGoodsType.Card, foilCard.Id, request.CreateNumber, ct);
+
+        var result = await tx.CommitAsync(ct);
+
+        // Append the base card's post-state total so the client can update its on-screen count
+        // (UpdateHaveUserGoodsNumByJsonData does direct assignment, not delta).
+        var rewardList = result.RewardList.ToRewardList();
+        rewardList.Add(new RewardListEntry
+        {
+            RewardType = (int)UserGoodsType.Card,
+            RewardId = baseCard.Id,
+            RewardNum = baseOwned.Count,
+        });
+
+        return new CardCreateFoilCardResponse { RewardList = rewardList };
+    }
+
     [HttpPost("protect")]
     public async Task<ActionResult<CardProtectResponse>> Protect(CardProtectRequest request)
     {

SVSim.EmulatedEntrypoint/Models/Dtos/Requests/Card/CardCreateFoilCardRequest.cs

@@ -0,0 +1,30 @@
+using MessagePack;
+using System.Text.Json.Serialization;
+
+namespace SVSim.EmulatedEntrypoint.Models.Dtos.Requests.Card;
+
+/// <summary>
+/// POST /card/create_foil_card — Seer's Globe conversion (Wizard/PremiumCardConversionTask.cs).
+/// Consumes <see cref="CreateNumber"/> Orbs (Item id 1000) + <see cref="CreateNumber"/> copies of
+/// <see cref="BaseCardId"/> to grant <see cref="CreateNumber"/> copies of the foil twin (base+1).
+/// </summary>
+[MessagePackObject]
+public class CardCreateFoilCardRequest : BaseRequest
+{
+    [JsonPropertyName("base_card_id")]
+    [Key("base_card_id")]
+    public int BaseCardId { get; set; }
+
+    /// <summary>
+    /// Client's snapshot of how many normal copies it has at request time. Sanity-check only —
+    /// the actual spend is <c>create_number</c> copies, not this value.
+    /// </summary>
+    [JsonPropertyName("base_card_number")]
+    [Key("base_card_number")]
+    public int BaseCardNumber { get; set; }
+
+    /// <summary>Hardcoded to 1 by <c>PremiumCardConversionTask.SetParameter</c>.</summary>
+    [JsonPropertyName("create_number")]
+    [Key("create_number")]
+    public int CreateNumber { get; set; }
+}

SVSim.EmulatedEntrypoint/Models/Dtos/Responses/Card/CardCreateFoilCardResponse.cs

@@ -0,0 +1,19 @@
+using MessagePack;
+using SVSim.EmulatedEntrypoint.Models.Dtos;
+using System.Text.Json.Serialization;
+
+namespace SVSim.EmulatedEntrypoint.Models.Dtos.Responses.Card;
+
+/// <summary>
+/// /card/create_foil_card response. reward_list entries are POST-STATE TOTALS — client's
+/// <c>PlayerStaticData.UpdateHaveUserGoodsNumByJsonData</c> does direct assignment. Contains
+/// the Item (Orb) post-balance, base-card post-count, and foil-card post-count.
+/// </summary>
+[MessagePackObject]
+public class CardCreateFoilCardResponse
+{
+    [JsonPropertyName("reward_list")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    [Key("reward_list")]
+    public List<RewardListEntry> RewardList { get; set; } = new();
+}