using QuestStateEnum = BaseGames.Core.Events.QuestState;

namespace BaseGames.Quest
{
    /// <summary>
    /// 任务管理器的公开契约。ServiceLocator.Get&lt;IQuestManager&gt;() 获取实例，
    /// 避免外部代码直接依赖 QuestManager 具体类型。
    /// </summary>
    public interface IQuestManager
    {
        /// <summary>接取任务（幂等）。</summary>
        void AcceptQuest(string questId);

        /// <summary>完成任务并发放奖励。rewardTarget 接收奖励（如玩家）。</summary>
        void CompleteQuest(string questId, IRewardTarget rewardTarget);

        /// <summary>返回当前任务状态。未知 questId 返回 Unavailable。</summary>
        QuestStateEnum GetState(string questId);

        /// <summary>判断任务是否满足完成条件。</summary>
        bool IsReadyToComplete(string questId);
    }
}