SPT-Server-Build/Libraries/SPTarkov.Server.Core/Controllers/InventoryController.cs

using SPTarkov.DI.Annotations;
using SPTarkov.Server.Core.Extensions;
using SPTarkov.Server.Core.Generators;
using SPTarkov.Server.Core.Helpers;
using SPTarkov.Server.Core.Models.Common;
using SPTarkov.Server.Core.Models.Eft.Common;
using SPTarkov.Server.Core.Models.Eft.Common.Tables;
using SPTarkov.Server.Core.Models.Eft.Inventory;
using SPTarkov.Server.Core.Models.Eft.ItemEvent;
using SPTarkov.Server.Core.Models.Eft.Profile;
using SPTarkov.Server.Core.Models.Enums;
using SPTarkov.Server.Core.Models.Utils;
using SPTarkov.Server.Core.Routers;
using SPTarkov.Server.Core.Services;
using SPTarkov.Server.Core.Utils;
using SPTarkov.Server.Core.Utils.Cloners;

namespace SPTarkov.Server.Core.Controllers;

[Injectable]
public class InventoryController(
    ISptLogger<InventoryController> logger,
    HttpResponseUtil httpResponseUtil,
    PresetHelper presetHelper,
    InventoryHelper inventoryHelper,
    HideoutHelper hideoutHelper,
    ProfileHelper profileHelper,
    TraderHelper traderHelper,
    ItemHelper itemHelper,
    DatabaseService databaseService,
    FenceService fenceService,
    RagfairOfferService ragfairOfferService,
    MapMarkerService mapMarkerService,
    ServerLocalisationService serverLocalisationService,
    LootGenerator lootGenerator,
    EventOutputHolder eventOutputHolder,
    ICloner cloner
)
{
    /// <summary>
    ///     Move Item - change location of item with parentId and slotId, transfers items from one profile to another if fromOwner/toOwner is set in the body.
    ///     Otherwise, move is contained within the same profile_f
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="moveRequest">Move request data</param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void MoveItem(PmcData pmcData, InventoryMoveRequestData moveRequest, MongoId sessionId, ItemEventRouterResponse output)
    {
        if (output.Warnings?.Count > 0)
        {
            return;
        }

        // Changes made to result apply to character inventory
        var ownerInventoryItems = inventoryHelper.GetOwnerInventoryItems(moveRequest, moveRequest.Item.Value, sessionId);
        if (ownerInventoryItems.SameInventory.GetValueOrDefault(false))
        {
            // Don't move items from trader to profile, this can happen when editing a traders preset weapons
            if (moveRequest.FromOwner?.Type == "Trader" && !ownerInventoryItems.IsMail.GetValueOrDefault(false))
            {
                AppendTraderExploitErrorResponse(output);
                return;
            }

            // Check for item in inventory before allowing internal transfer
            var originalItemLocation = ownerInventoryItems.From?.FirstOrDefault(item => item.Id == moveRequest.Item);
            if (originalItemLocation is null)
            {
                // Internal item move but item never existed, possible dupe glitch
                AppendTraderExploitErrorResponse(output);
                return;
            }

            var originalLocationSlotId = originalItemLocation.SlotId;

            var moveResult = inventoryHelper.MoveItemInternal(pmcData, ownerInventoryItems.From ?? [], moveRequest, out var errorMessage);
            if (!moveResult)
            {
                httpResponseUtil.AppendErrorToOutput(output, errorMessage);
                return;
            }

            // Item is moving into or out of place of fame dog tag slot
            if (
                moveRequest.To?.Container != null
                && (
                    moveRequest.To.Container.StartsWith("dogtag", StringComparison.OrdinalIgnoreCase)
                    || originalLocationSlotId.StartsWith("dogtag", StringComparison.OrdinalIgnoreCase)
                )
            )
            {
                hideoutHelper.ApplyPlaceOfFameDogtagBonus(pmcData);
            }
        }
        else
        {
            inventoryHelper.MoveItemToProfile(ownerInventoryItems.From ?? [], ownerInventoryItems.To ?? [], moveRequest);
        }
    }

    /// <summary>
    ///     Get an event router response with inventory trader message
    /// </summary>
    /// <param name="output">Item event router response</param>
    protected void AppendTraderExploitErrorResponse(ItemEventRouterResponse output)
    {
        httpResponseUtil.AppendErrorToOutput(
            output,
            serverLocalisationService.GetText("inventory-edit_trader_item"),
            (BackendErrorCodes)228
        );
    }

    /// <summary>
    ///     Handle /client/game/profile/items/moving - PinLock
    ///     Requires no response to client, only server change
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request">Pin/Lock request data</param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void PinOrLock(PmcData pmcData, PinOrLockItemRequest request, MongoId sessionId, ItemEventRouterResponse output)
    {
        var itemToAdjust = pmcData.Inventory!.Items!.FirstOrDefault(item => item.Id == request.Item);
        if (itemToAdjust is null)
        {
            logger.Error($"Unable find item: {request.Item.Value.ToString()} to: {request.State} on player: {sessionId} to: ");

            return;
        }

        // Nullguard
        itemToAdjust.Upd ??= new Upd();

        itemToAdjust.Upd.PinLockState = request.State;
    }

    /// <summary>
    ///     Handle /client/game/profile/items/moving SaveDialogueState
    /// </summary>
    /// <param name="pmcData">Player's PMC profile</param>
    /// <param name="request"></param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output"></param>
    public void SetDialogueProgress(PmcData pmcData, SaveDialogueStateRequest request, MongoId sessionId, ItemEventRouterResponse output)
    {
        var fullProfile = profileHelper.GetFullProfile(sessionId);
        fullProfile.DialogueProgress = request.DialogueProgress;
    }

    /// <summary>
    ///     Handle /client/game/profile/items/moving SetFavoriteItems
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request"></param>
    /// <param name="sessionId">Session/Player id</param>
    public void SetFavoriteItem(PmcData pmcData, SetFavoriteItems request, MongoId sessionId)
    {
        // The client sends the full list of favorite items, so clear the current favorites
        pmcData.Inventory.FavoriteItems = [];
        pmcData.Inventory.FavoriteItems = pmcData.Inventory.FavoriteItems.Union(request.Items);
    }

    /// <summary>
    ///     Handle /client/game/profile/items/moving RedeemProfileReward
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request"></param>
    /// <param name="sessionId">Session/Player id</param>
    public void RedeemProfileReward(PmcData pmcData, RedeemProfileRequestData request, MongoId sessionId)
    {
        var fullProfile = profileHelper.GetFullProfile(sessionId);
        foreach (var rewardEvent in request.Events)
        {
            // Hard coded to `SYSTEM` for now
            // TODO: make this dynamic
            var dialog = fullProfile.DialogueRecords["59e7125688a45068a6249071"];
            var mail = dialog.Messages.FirstOrDefault(message => message.Id == rewardEvent.MessageId);
            var mailEvent = mail.ProfileChangeEvents.FirstOrDefault(changeEvent => changeEvent.Id == rewardEvent.EventId);

            switch (mailEvent.Type)
            {
                case "TraderSalesSum":
                    pmcData.TradersInfo[mailEvent.Entity].SalesSum = mailEvent.Value;
                    traderHelper.LevelUp(mailEvent.Entity, pmcData);
                    logger.Success($"Set trader {mailEvent.Entity}: Sales Sum to: {mailEvent.Value}");
                    break;
                case "TraderStanding":
                    pmcData.TradersInfo[mailEvent.Entity].Standing = mailEvent.Value;
                    traderHelper.LevelUp(mailEvent.Entity, pmcData);
                    logger.Success($"Set trader {mailEvent.Entity}: Standing to: {mailEvent.Value}");
                    break;
                case "ProfileLevel":
                    pmcData.Info.Experience = (int)mailEvent.Value.Value;
                    // Will calculate level below
                    traderHelper.ValidateTraderStandingsAndPlayerLevelForProfile(sessionId);
                    logger.Success($"Set profile xp to: {mailEvent.Value}");
                    break;
                case "SkillPoints":
                {
                    var profileSkill = pmcData.Skills.Common.FirstOrDefault(x => x.Id == Enum.Parse<SkillTypes>(mailEvent.Entity));
                    if (profileSkill is null)
                    {
                        logger.Warning($"Unable to find skill with name: {mailEvent.Entity}");
                        continue;
                    }

                    profileSkill.Progress = (double)mailEvent.Value;
                    logger.Success($"Set profile skill: {mailEvent.Entity} to: {mailEvent.Value}");
                    break;
                }
                case "ExamineAllItems":
                {
                    var itemIds = databaseService.GetItems().Where(x => x.Value.Type != "Node").Select(x => x.Key);
                    FlagItemsAsInspectedAndRewardXp(itemIds, fullProfile);
                    logger.Success($"Flagged {itemIds.Count()} items as examined");

                    break;
                }
                case "UnlockTrader":
                    pmcData.TradersInfo[mailEvent.Entity].Unlocked = true;
                    logger.Success($"Trader {mailEvent.Entity} Unlocked");

                    break;
                case "AssortmentUnlockRule":
                    fullProfile.SptData.BlacklistedItemTemplates ??= [];
                    fullProfile.SptData.BlacklistedItemTemplates.Add(mailEvent.Entity);
                    logger.Success($"Item {mailEvent.Entity} is now blacklisted");

                    break;
                case "HideoutAreaLevel":
                {
                    var areaName = mailEvent.Entity;
                    var newValue = mailEvent.Value;
                    var hideoutAreaType = Enum.Parse<HideoutAreas>(areaName ?? "NotSet");

                    var desiredArea = pmcData.Hideout.Areas.FirstOrDefault(area => area.Type == hideoutAreaType);
                    if (desiredArea is not null)
                    {
                        desiredArea.Level = (int?)newValue;
                    }

                    break;
                }
                default:
                    logger.Warning($"Unhandled profile reward event: {mailEvent.Type}");

                    break;
            }
        }
    }

    /// <summary>
    ///     Flag an item as seen in profiles encyclopedia + add inspect xp to profile
    /// </summary>
    /// <param name="itemTpls">Inspected item tpls</param>
    /// <param name="fullProfile">Profile to add xp to</param>
    protected void FlagItemsAsInspectedAndRewardXp(IEnumerable<MongoId> itemTpls, SptProfile fullProfile)
    {
        foreach (var itemTpl in itemTpls)
        {
            var item = itemHelper.GetItem(itemTpl);
            if (!item.Key)
            {
                logger.Warning(serverLocalisationService.GetText("inventory-unable_to_inspect_item_not_in_db", itemTpl));

                return;
            }

            fullProfile.CharacterData.PmcData.Info.Experience += item.Value.Properties.ExamineExperience;
            fullProfile.CharacterData.PmcData.Encyclopedia[itemTpl] = false;

            fullProfile.CharacterData.ScavData.Info.Experience += item.Value.Properties.ExamineExperience;
            fullProfile.CharacterData.ScavData.Encyclopedia[itemTpl] = false;
        }

        // TODO: update this with correct calculation using values from globals json
        profileHelper.AddSkillPointsToPlayer(fullProfile.CharacterData.PmcData, SkillTypes.Intellect, 0.05 * itemTpls.Count());
    }

    /// <summary>
    ///     Handle OpenRandomLootContainer event
    ///     Handle event fired when a container is unpacked (e.g. halloween pumpkin)
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request"></param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void OpenRandomLootContainer(
        PmcData pmcData,
        OpenRandomLootContainerRequestData request,
        MongoId sessionId,
        ItemEventRouterResponse output
    )
    {
        // Container player opened in their inventory
        var openedItem = pmcData.Inventory.Items.FirstOrDefault(item => item.Id == request.Item);
        var containerDetailsDb = itemHelper.GetItem(openedItem.Template);
        var isSealedWeaponBox = containerDetailsDb.Value.Name.Contains("event_container_airdrop");

        var foundInRaid = openedItem.Upd?.SpawnedInSession;
        var rewards = new List<List<Item>>();
        var unlockedWeaponCrates = new HashSet<MongoId>
        {
            ItemTpl.RANDOMLOOTCONTAINER_ARENA_WEAPONCRATE_VIOLET_OPEN,
            ItemTpl.RANDOMLOOTCONTAINER_ARENA_WEAPONCRATE_BLUE_OPEN,
            ItemTpl.RANDOMLOOTCONTAINER_ARENA_WEAPONCRATE_GREEN_OPEN,
        };
        // Temp fix for unlocked weapon crate hideout craft
        if (isSealedWeaponBox || unlockedWeaponCrates.Contains(containerDetailsDb.Value.Id))
        {
            var containerSettings = inventoryHelper.GetInventoryConfig().SealedAirdropContainer;
            rewards.AddRange(lootGenerator.GetSealedWeaponCaseLoot(containerSettings));

            if (containerSettings.FoundInRaid)
            {
                foundInRaid = containerSettings.FoundInRaid;
            }
        }
        else
        {
            var rewardContainerDetails = inventoryHelper.GetRandomLootContainerRewardDetails(openedItem.Template);
            if (rewardContainerDetails?.RewardCount == null)
            {
                logger.Error($"Unable to add loot to container: {openedItem.Template}, no rewards found");
            }
            else
            {
                rewards.AddRange(lootGenerator.GetRandomLootContainerLoot(rewardContainerDetails));

                if (rewardContainerDetails.FoundInRaid)
                {
                    foundInRaid = rewardContainerDetails.FoundInRaid;
                }
            }
        }

        // Add items to player inventory
        if (rewards.Count > 0)
        {
            var addItemsRequest = new AddItemsDirectRequest
            {
                ItemsWithModsToAdd = rewards,
                FoundInRaid = foundInRaid,
                Callback = null,
                UseSortingTable = true,
            };
            inventoryHelper.AddItemsToStash(sessionId, addItemsRequest, pmcData, output);
            if (output.Warnings?.Count > 0)
            {
                return;
            }
        }

        // Find and delete opened container item from player inventory
        inventoryHelper.RemoveItem(pmcData, request.Item, sessionId, output);
    }

    /// <summary>
    ///     Edit an existing map marker
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request">Edit marker request</param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void EditMapMarker(PmcData pmcData, InventoryEditMarkerRequestData request, MongoId sessionId, ItemEventRouterResponse output)
    {
        var mapItem = mapMarkerService.EditMarkerOnMap(pmcData, request);

        // sync with client
        output.ProfileChanges[sessionId].Items.ChangedItems.Add(mapItem);
    }

    /// <summary>
    ///     Delete a map marker
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request">Delete marker request</param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void DeleteMapMarker(
        PmcData pmcData,
        InventoryDeleteMarkerRequestData request,
        MongoId sessionId,
        ItemEventRouterResponse output
    )
    {
        var mapItem = mapMarkerService.DeleteMarkerFromMap(pmcData, request);

        // sync with client
        output.ProfileChanges[sessionId].Items.ChangedItems.Add(mapItem);
    }

    public void CreateMapMarker(
        PmcData pmcData,
        InventoryCreateMarkerRequestData request,
        MongoId sessionId,
        ItemEventRouterResponse output
    )
    {
        var adjustedMapItem = mapMarkerService.CreateMarkerOnMap(pmcData, request);

        // Sync with client
        output.ProfileChanges[sessionId].Items.ChangedItems.Add(adjustedMapItem);
    }

    /// <summary>
    ///     Add note to a map
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request">Add marker request</param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void SortInventory(PmcData pmcData, InventorySortRequestData request, MongoId sessionId, ItemEventRouterResponse output)
    {
        foreach (var change in request.ChangedItems)
        {
            var inventoryItem = pmcData.Inventory.Items.FirstOrDefault(item => item.Id == change.Id);
            if (inventoryItem is null)
            {
                logger.Error(serverLocalisationService.GetText("inventory-unable_to_sort_inventory_restart_game", change.Id));

                continue;
            }

            inventoryItem.ParentId = change.ParentId;
            inventoryItem.SlotId = change.SlotId;
            inventoryItem.Location = change.Location ?? null;
        }
    }

    /// <summary>
    ///     Flag item as 'seen' by player in profile
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request"></param>
    /// <param name="sessionId">Session/Player id</param>
    /// <returns></returns>
    public ItemEventRouterResponse ReadEncyclopedia(PmcData pmcData, InventoryReadEncyclopediaRequestData request, MongoId sessionId)
    {
        foreach (var id in request.Ids)
        {
            pmcData.Encyclopedia[id] = true;
        }

        return eventOutputHolder.GetOutput(sessionId);
    }

    /// <summary>
    ///     Handle examining an item
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request">Examine item request</param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void ExamineItem(PmcData pmcData, InventoryExamineRequestData request, MongoId sessionId, ItemEventRouterResponse output)
    {
        MongoId? itemId = null;
        if (request.FromOwner is not null)
        {
            try
            {
                itemId = GetExaminedItemTpl(request, sessionId);
            }
            catch
            {
                logger.Error(serverLocalisationService.GetText("inventory-examine_item_does_not_exist", request.ItemId));
            }
        }

        if (itemId is null)
        // item template
        {
            if (databaseService.GetItems().ContainsKey(request.ItemId))
            {
                itemId = request.ItemId;
            }
        }

        if (itemId is null)
        {
            // Player inventory
            var target = pmcData.Inventory.Items.FirstOrDefault(item => item.Id == request.ItemId);
            if (target is not null)
            {
                itemId = target.Template;
            }
        }

        if (itemId is not null)
        {
            var fullProfile = profileHelper.GetFullProfile(sessionId);
            FlagItemsAsInspectedAndRewardXp([itemId.Value], fullProfile);
        }
    }

    /// <summary>
    ///     Get the tpl of an item from the examine request object
    /// </summary>
    /// <param name="request"></param>
    /// <param name="sessionId">Session/Player id</param>
    /// <returns>Item tpl</returns>
    protected MongoId? GetExaminedItemTpl(InventoryExamineRequestData request, MongoId sessionId)
    {
        if (presetHelper.IsPreset(request.ItemId))
        {
            return presetHelper.GetBaseItemTpl(request.ItemId);
        }

        if (request.FromOwner.Id == Traders.FENCE)
        // Get tpl from fence assorts
        {
            return fenceService.GetRawFenceAssorts().Items.FirstOrDefault(x => x.Id == request.ItemId)?.Template;
        }

        if (request.FromOwner.Type == "Trader")
        // Not fence
        // get tpl from trader assort
        {
            return databaseService
                .GetTrader(request.FromOwner.Id.Value)
                .Assort.Items.FirstOrDefault(item => item.Id == request.ItemId)
                ?.Template;
        }

        if (request.FromOwner.Type == "RagFair")
        {
            // Try to get tplId from items.json first
            var item = itemHelper.GetItem(request.ItemId);
            if (item.Key)
            {
                return item.Value.Id;
            }

            // Try alternate way of getting offer if first approach fails
            var offer =
                ragfairOfferService.GetOfferByOfferId(request.ItemId) ?? ragfairOfferService.GetOfferByOfferId(request.FromOwner.Id.Value);

            // Try find examine item inside offer items array
            var matchingItem = offer.Items.FirstOrDefault(offerItem => offerItem.Id == request.ItemId);
            if (matchingItem is not null)
            {
                return matchingItem.Template;
            }

            // Unable to find item in database or ragfair
            logger.Warning(serverLocalisationService.GetText("inventory-unable_to_find_item", request.ItemId));
        }

        // get hideout item
        if (request.FromOwner.Type == "HideoutProduction")
        {
            return request.ItemId;
        }

        if (request.FromOwner.Type == "Mail")
        {
            // when inspecting an item in mail rewards, we are given on the message its in and its mongoId, not the Template, so we have to go find it ourselves
            // all mail the player has
            var mail = profileHelper.GetFullProfile(sessionId).DialogueRecords;
            // per trader/person mail
            var dialogue = mail.FirstOrDefault(x => x.Value.Messages.Any(m => m.Id == request.FromOwner.Id));
            // check each message from that trader/person for messages that match the ID we got
            var message = dialogue.Value.Messages.FirstOrDefault(m => m.Id == request.FromOwner.Id);
            // get the Id given and get the Template ID from that
            var item = message.Items.Data.FirstOrDefault(item => item.Id == request.ItemId);

            if (item is not null)
            {
                return item.Template;
            }
        }

        logger.Error($"Unable to get item with id: {request.ItemId}");

        return null;
    }

    /// <summary>
    ///     Unbind an inventory item from quick access menu at bottom of player screen
    ///     Handle unbind event
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request"></param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void UnBindItem(PmcData pmcData, InventoryBindRequestData request, MongoId sessionId, ItemEventRouterResponse output)
    {
        // Remove kvp from requested fast panel index

        // TODO - does this work
        pmcData.Inventory.FastPanel.Remove(request.Index);
    }

    /// <summary>
    ///     Handle bind event
    ///     Bind an inventory item to the quick access menu at bottom of player screen
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="bindRequest"></param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void BindItem(PmcData pmcData, InventoryBindRequestData bindRequest, MongoId sessionId, ItemEventRouterResponse output)
    {
        // Remove link
        pmcData.Inventory.FastPanel.Remove(bindRequest.Index);

        // Create link between fast panel slot and requested item
        pmcData.Inventory.FastPanel[bindRequest.Index] = bindRequest.Item;
    }

    /// <summary>
    ///     Add a tag to an inventory item
    /// </summary>
    /// <param name="pmcData">Profile with item to add tag to</param>
    /// <param name="request"></param>
    /// <param name="sessionId">Session/Player id</param>
    /// <returns>ItemEventRouterResponse</returns>
    public ItemEventRouterResponse TagItem(PmcData pmcData, InventoryTagRequestData request, MongoId sessionId)
    {
        var itemToTag = pmcData.Inventory.Items.FirstOrDefault(item => item.Id == request.Item);
        if (itemToTag is null)
        {
            logger.Warning($"Unable to tag item: {request.Item} as it cannot be found in player {sessionId} inventory");

            return new ItemEventRouterResponse { Warnings = [] };
        }

        // Null guard
        itemToTag.Upd ??= new Upd();

        itemToTag.Upd.Tag = new UpdTag { Color = request.TagColor, Name = request.TagName };

        return eventOutputHolder.GetOutput(sessionId);
    }

    /// <summary>
    ///     Toggles "Toggleable" items like night vision goggles and face shields.
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request">Toggle request</param>
    /// <param name="sessionId">Session/Player id</param>
    /// <returns>ItemEventRouterResponse</returns>
    public ItemEventRouterResponse ToggleItem(PmcData pmcData, InventoryToggleRequestData request, MongoId sessionId)
    {
        // May need to reassign to scav profile
        var playerData = pmcData;

        // Fix for toggling items while on they're in the Scav inventory
        if (request.FromOwner?.Type == "Profile" && request.FromOwner.Id != playerData.Id)
        {
            playerData = profileHelper.GetScavProfile(sessionId);
        }

        var itemToToggle = playerData.Inventory.Items.FirstOrDefault(x => x.Id == request.Item);
        if (itemToToggle is not null)
        {
            itemHelper.AddUpdObjectToItem(
                itemToToggle,
                serverLocalisationService.GetText("inventory-item_to_toggle_missing_upd", itemToToggle.Id)
            );

            itemToToggle.Upd.Togglable = new UpdTogglable { On = request.Value };

            return eventOutputHolder.GetOutput(sessionId);
        }

        logger.Warning(serverLocalisationService.GetText("inventory-unable_to_toggle_item_not_found", request.Item));

        return new ItemEventRouterResponse { Warnings = [] };
    }

    /// <summary>
    ///     Handles folding of Weapons
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request">Fold item request</param>
    /// <param name="sessionId">Session/Player id</param>
    /// <returns>ItemEventRouterResponse</returns>
    public ItemEventRouterResponse FoldItem(PmcData pmcData, InventoryFoldRequestData request, MongoId sessionId)
    {
        // May need to reassign to scav profile
        var playerData = pmcData;

        // We may be folding data on scav profile, get that profile instead
        if (request.FromOwner?.Type == "Profile" && request.FromOwner.Id != playerData.Id)
        {
            playerData = profileHelper.GetScavProfile(sessionId);
        }

        var itemToFold = playerData.Inventory.Items.FirstOrDefault(item => item.Id == request.Item);
        if (itemToFold is null)
        {
            // Item not found
            logger.Warning(serverLocalisationService.GetText("inventory-unable_to_fold_item_not_found_in_inventory", request.Item));

            return new ItemEventRouterResponse { Warnings = [] };
        }

        // Item may not have upd object
        itemToFold.AddUpd();

        itemToFold.Upd.Foldable = new UpdFoldable { Folded = request.Value };

        return eventOutputHolder.GetOutput(sessionId);
    }

    /// <summary>
    ///     Swap Item
    ///     used for "reload" if you have weapon in hands and magazine is somewhere else in rig or backpack in equipment
    ///     Also used to swap items using quick selection on character screen
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request">Swap item request</param>
    /// <param name="sessionId">Session/Player id</param>
    /// <returns>ItemEventRouterResponse</returns>
    public ItemEventRouterResponse SwapItem(PmcData pmcData, InventorySwapRequestData request, MongoId sessionId)
    {
        // During post-raid scav transfer, the swap may be in the scav inventory
        var playerData = pmcData;
        if (request.FromOwner?.Type == "Profile" && request.FromOwner.Id != playerData.Id)
        {
            playerData = profileHelper.GetScavProfile(sessionId);
        }

        var itemOne = playerData.Inventory.Items.FirstOrDefault(x => x.Id == request.Item);
        if (itemOne is null)
        {
            logger.Error(
                serverLocalisationService.GetText(
                    "inventory-unable_to_find_item_to_swap",
                    new { item1Id = request.Item, item2Id = request.Item2 }
                )
            );
        }

        var itemTwo = playerData.Inventory.Items.FirstOrDefault(x => x.Id == request.Item2);
        if (itemTwo is null)
        {
            logger.Error(
                serverLocalisationService.GetText(
                    "inventory-unable_to_find_item_to_swap",
                    new { item1Id = request.Item2, item2Id = request.Item }
                )
            );
        }

        // to.id is the parentId
        itemOne.ParentId = request.To.Id;

        // to.container is the slotId
        itemOne.SlotId = request.To.Container;

        // Request object has location data, add it in, otherwise remove existing location from object
        itemOne.Location = request.To.Location ?? null;

        itemTwo.ParentId = request.To2.Id;
        itemTwo.SlotId = request.To2.Container;
        itemTwo.Location = request.To2.Location ?? null;

        // Client already informed of inventory locations, nothing for us to do
        return eventOutputHolder.GetOutput(sessionId);
    }

    /// <summary>
    ///     TODO: Adds no data to output to send to client, is this by design?
    ///     Transfer items from one stack into another while keeping original stack
    ///     Used to take items from scav inventory into stash or to insert ammo into mags (shotgun ones) and reloading weapon by clicking "Reload"
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request">Transfer item request</param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void TransferItem(PmcData pmcData, InventoryTransferRequestData request, MongoId sessionId, ItemEventRouterResponse output)
    {
        // TODO - check GetOwnerInventoryItems() call still works
        var inventoryItems = inventoryHelper.GetOwnerInventoryItems(request, request.Item, sessionId);
        var sourceItem = inventoryItems.From.FirstOrDefault(item => item.Id == request.Item);
        var destinationItem = inventoryItems.To.FirstOrDefault(item => item.Id == request.With);

        if (sourceItem is null)
        {
            var errorMessage = $"Unable to transfer stack, cannot find source: {request.Item}";
            logger.Error(errorMessage);

            httpResponseUtil.AppendErrorToOutput(output, errorMessage);

            return;
        }

        if (destinationItem is null)
        {
            var errorMessage = $"Unable to transfer stack, cannot find destination: {request.With}";
            logger.Error(errorMessage);

            httpResponseUtil.AppendErrorToOutput(output, errorMessage);

            return;
        }

        sourceItem.Upd ??= new Upd { StackObjectsCount = 1 };

        var sourceStackCount = sourceItem.Upd.StackObjectsCount;
        if (sourceStackCount > request.Count)
        // Source items stack count greater than new desired count
        {
            sourceItem.Upd.StackObjectsCount = sourceStackCount - request.Count;
        }
        else
        // Moving a full stack onto a smaller stack
        {
            sourceItem.Upd.StackObjectsCount = sourceStackCount - 1;
        }

        destinationItem.Upd ??= new Upd { StackObjectsCount = 1 };

        var destinationStackCount = destinationItem.Upd.StackObjectsCount;
        destinationItem.Upd.StackObjectsCount = destinationStackCount + request.Count;
    }

    /// <summary>
    ///     Fully merge 2 inventory stacks together into one stack (merging where both stacks remain is called 'transfer')
    ///     Deletes item from `body.item` and adding number of stacks into `body.with`
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request">Merge stacks request</param>
    /// <param name="sessionID">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void MergeItem(PmcData pmcData, InventoryMergeRequestData request, MongoId sessionID, ItemEventRouterResponse output)
    {
        // Get source and destination inventories, they are not always the same (e.g. moving post-raid scav item stack into pmc inventory stack)
        var inventoryItems = inventoryHelper.GetOwnerInventoryItems(request, request.Item, sessionID);

        // Get source item (can be from player or trader or mail)
        var sourceItem = inventoryItems.From.FirstOrDefault(x => x.Id == request.Item);
        if (sourceItem is null)
        {
            var errorMessage = $"Unable to merge stacks as source item: {request.With} cannot be found";
            logger.Error(errorMessage);

            httpResponseUtil.AppendErrorToOutput(output, errorMessage);

            return;
        }

        // Get item being merged into
        var destinationItem = inventoryItems.To.FirstOrDefault(x => x.Id == request.With);
        if (destinationItem is null)
        {
            var errorMessage = $"Unable to merge stacks as destination item: {request.With} cannot be found";
            logger.Error(errorMessage);

            httpResponseUtil.AppendErrorToOutput(output, errorMessage);

            return;
        }

        destinationItem.EnsureItemHasValidStackCount();
        sourceItem.EnsureItemHasValidStackCount();

        // Merging non Found in Raid (SpawnedInSession) items with FiR item causing result to be not Found in Raid
        if (!sourceItem.Upd.SpawnedInSession.GetValueOrDefault(false) && destinationItem.Upd.SpawnedInSession.GetValueOrDefault(false))
        {
            destinationItem.Upd.SpawnedInSession = false;
        }

        // Add source stackcount to destination
        destinationItem.Upd.StackObjectsCount += sourceItem.Upd.StackObjectsCount;

        // Update output to inform client of source stack being deleted
        output.ProfileChanges[sessionID].Items.DeletedItems.Add(new DeletedItem { Id = sourceItem.Id }); // Inform client source item being deleted

        // Remove source item from server profile now it has been merged into destination item
        if (!inventoryItems.From.Remove(sourceItem))
        {
            var errorMessage = $"Unable to find item: {sourceItem.Id} to remove from sender inventory";
            logger.Error(errorMessage);

            httpResponseUtil.AppendErrorToOutput(output, errorMessage);
        }
    }

    /// <summary>
    ///     Split Item stack - 1 stack into 2
    /// </summary>
    /// <param name="pmcData">(unused, getOwnerInventoryItems() gets profile)</param>
    /// <param name="request">Split stack request</param>
    /// <param name="sessionID">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void SplitItem(PmcData pmcData, InventorySplitRequestData request, MongoId sessionID, ItemEventRouterResponse output)
    {
        // Changes made to result apply to character inventory
        var inventoryItems = inventoryHelper.GetOwnerInventoryItems(request, request.NewItem.Value, sessionID);

        // Handle cartridge edge-case
        if (request.Container.Location is null && request.Container.ContainerName == "cartridges")
        {
            var matchingItems = inventoryItems.To.Where(x => x.ParentId == request.Container.Id);
            request.Container.Location = matchingItems.Count(); // Wrong location for first cartridge
        }

        // The item being merged has three possible sources: pmc, scav or mail, getOwnerInventoryItems() handles getting correct one
        var itemToSplit = inventoryItems.From.FirstOrDefault(x => x.Id == request.SplitItem);
        if (itemToSplit is null)
        {
            var errorMessage = $"Unable to split stack as source item: {request.SplitItem} cannot be found";
            logger.Error(errorMessage);

            httpResponseUtil.AppendErrorToOutput(output, errorMessage);

            return;
        }

        // Create new upd object that retains properties of original upd + new stack count size
        var updatedUpd = cloner.Clone(itemToSplit.Upd);
        updatedUpd.StackObjectsCount = request.Count;

        // Remove split item count from source stack
        itemToSplit.Upd.StackObjectsCount -= request.Count;

        // Inform client of change
        output
            .ProfileChanges[sessionID]
            .Items.NewItems.Add(
                new Item
                {
                    Id = request.NewItem.Value,
                    Template = itemToSplit.Template,
                    Upd = updatedUpd,
                }
            );

        // Update player inventory
        inventoryItems.To.Add(
            new Item
            {
                Id = request.NewItem.Value,
                Template = itemToSplit.Template,
                ParentId = request.Container.Id,
                SlotId = request.Container.ContainerName,
                Location = request.Container.Location,
                Upd = updatedUpd,
            }
        );
    }

    /// <summary>
    ///     Implements "Discard" functionality from Main menu (Stash etc.)
    ///     Removes item from PMC Profile
    /// </summary>
    /// <param name="pmcData">Players PMC profile</param>
    /// <param name="request">Discard item request</param>
    /// <param name="sessionId">Session/Player id</param>
    /// <param name="output">Client response</param>
    public void DiscardItem(PmcData pmcData, InventoryRemoveRequestData request, MongoId sessionId, ItemEventRouterResponse output)
    {
        if (request.FromOwner?.Type == "Mail")
        {
            inventoryHelper.RemoveItemAndChildrenFromMailRewards(sessionId, request, output);

            return;
        }

        var profileToRemoveItemFrom =
            request.FromOwner is null || request.FromOwner?.Id == pmcData.Id
                ? pmcData
                : profileHelper.GetFullProfile(sessionId).CharacterData.ScavData;

        inventoryHelper.RemoveItem(profileToRemoveItemFrom, request.Item, sessionId, output);
    }
}