ShrinkDataSaver.Integration.App/Runtime/ShrinkDataSaverAppInstaller.cs

#nullable enable

using System;
using Cysharp.Threading.Tasks;
using ShrinkApp;
using ShrinkContext;

namespace ShrinkDataSaver.Integration.App
{
    [ShrinkAppModuleInstaller]
    [Obsolete("ClassicHost compatibility only. ContextLoader projects should use ShrinkDataSaverAppComponent from a composition root.")]
    public sealed class ShrinkDataSaverAppInstaller : IShrinkAppModuleInstaller
    {
        public string ModuleId => "shrink.datasaver";
        public int Order => -2000;
        public System.Collections.Generic.IReadOnlyList<string> DependsOn => Array.Empty<string>();

        public void RegisterServices(ShrinkAppContext context)
        {
            context.Services.Register(new ShrinkDataSaverService());
        }

        public UniTask InitializeAsync(ShrinkAppContext context)
        {
            ShrinkDataSaverRuntime.Initialize();
            return UniTask.CompletedTask;
        }
    }

    /// <summary>不产生存档写入的读取能力。</summary>
    public interface IShrinkDataSaverReader
    {
        int LoadedSlot { get; }
        int GetRecentSlotIndex();
        UniTask<int> GetRecommendedContinueSlotAsync();
        UniTask<SaveMeta[]> GetAllMetaAsync();
    }

    /// <summary>完整存档能力；社区模组可通过 intercept 被降权为仅 <see cref="IShrinkDataSaverReader"/>。</summary>
    public interface IShrinkDataSaverWriter : IShrinkDataSaverReader
    {
        UniTask SaveSlotAsync(int slotIndex, SaveOptions? options = null);
        UniTask LoadSlotAsync(int slotIndex, string? decryptionKey = null);
    }

    public static class ShrinkDataSaverAccess
    {
        public const string MetadataKey = "access";
        public const string ReadOnly = "read-only";
    }

    public sealed class ShrinkDataSaverService : IShrinkDataSaverWriter
    {
        public int LoadedSlot => ShrinkSave.LoadedSlot;
        public int GetRecentSlotIndex() => ShrinkSave.GetRecentSlotIndex();
        public UniTask<int> GetRecommendedContinueSlotAsync() => ShrinkSave.GetRecommendedContinueSlotAsync();
        public UniTask<SaveMeta[]> GetAllMetaAsync() => ShrinkSave.GetAllMetaAsync();
        public UniTask SaveSlotAsync(int slotIndex, SaveOptions? options = null) => ShrinkSave.SaveSlotAsync(slotIndex, options);
        public UniTask LoadSlotAsync(int slotIndex, string? decryptionKey = null) => ShrinkSave.LoadSlotAsync(slotIndex, decryptionKey);
    }

    internal sealed class ShrinkDataSaverReadOnlyService : IShrinkDataSaverReader
    {
        private readonly IShrinkDataSaverReader _inner;

        public ShrinkDataSaverReadOnlyService(IShrinkDataSaverReader inner)
        {
            _inner = inner ?? throw new ArgumentNullException(nameof(inner));
        }

        public int LoadedSlot => _inner.LoadedSlot;
        public int GetRecentSlotIndex() => _inner.GetRecentSlotIndex();
        public UniTask<int> GetRecommendedContinueSlotAsync() => _inner.GetRecommendedContinueSlotAsync();
        public UniTask<SaveMeta[]> GetAllMetaAsync() => _inner.GetAllMetaAsync();
    }

    /// <summary>DataSaver provider 侧的访问介导；仅约束经 ShrinkCtx.Get 取得的能力。</summary>
    internal sealed class ShrinkDataSaverAccessPolicy : IShrinkCoeffectAccessPolicy
    {
        private readonly ShrinkDataSaverReadOnlyService _readOnly;

        public ShrinkDataSaverAccessPolicy(ShrinkDataSaverService full)
        {
            _readOnly = new ShrinkDataSaverReadOnlyService(
                full ?? throw new ArgumentNullException(nameof(full)));
        }

        public object? Resolve(ShrinkCoeffectAccessContext context, object? value)
        {
            if (!context.TryGetMetadata<string>(ShrinkDataSaverAccess.MetadataKey, out var access) ||
                !string.Equals(access, ShrinkDataSaverAccess.ReadOnly, StringComparison.Ordinal))
                return value;

            if (typeof(IShrinkDataSaverWriter).IsAssignableFrom(context.RequestedType) ||
                context.RequestedType == typeof(ShrinkDataSaverService))
            {
                throw new ShrinkCoeffectAccessDeniedException(context.Key,
                    "the current context grants read-only DataSaver access");
            }

            if (context.RequestedType == typeof(object) || context.RequestedType.IsInstanceOfType(_readOnly))
                return _readOnly;

            throw new ShrinkCoeffectAccessDeniedException(context.Key,
                $"read-only DataSaver view cannot satisfy requested type '{context.RequestedType.FullName}'");
        }
    }
}