using System;
using System.Threading.Tasks;

namespace AibisDream.SaveSystem.CloudSave
{
    /// <summary>
    /// 云存档后端适配器接口。
    /// <para>
    /// P2 仅定义接口与本地 no-op 实现，未来 Steamworks.NET / TapTap TDS SDK 通过实现此接口接入。
    /// 每个槽位在本地对应一组文件（snapshot.json / meta.json / thumbnail.png），
    /// backend 可选择逐文件上传，或将整组文件打包后上传。
    /// </para>
    /// </summary>
    public interface ICloudSaveBackend
    {
        /// <summary>平台名称，用于日志。</summary>
        string PlatformName { get; }

        /// <summary>当前平台是否可用。</summary>
        bool IsAvailable { get; }

        /// <summary>上传槽位文件集。</summary>
        /// <param name="slotIndex">槽位编号。</param>
        /// <param name="filePaths">该槽位下需要同步的文件绝对路径。</param>
        Task UploadSlotAsync(int slotIndex, string[] filePaths);

        /// <summary>下载槽位文件集到目标目录。</summary>
        Task DownloadSlotAsync(int slotIndex, string targetDirectory);

        /// <summary>删除云端槽位。</summary>
        Task DeleteSlotAsync(int slotIndex);

        /// <summary>获取云端该槽位的时间戳，用于冲突检测。</summary>
        /// <returns>远程保存时间；不存在返回 null。</returns>
        Task<DateTime?> GetRemoteTimestampAsync(int slotIndex);
    }
}