using System; using System.Collections.Generic; using System.Linq; namespace GameCult.Caching { // The store's encoding, as the cache needs it: the one pair CultInspectorModel and variant resolution share. // Serialize takes any value, not only documents, under its owning document type's options; Deserialize is its // inverse (a document type is checked against the registry, a member type is not); Overlay replaces slots of a // serialized document payload with already-encoded member values and touches nothing else. public sealed class CultCodec { public CultCodec( Func serialize, Func deserialize, Func>, byte[]> overlay) { Serialize = serialize ?? throw new ArgumentNullException(nameof(serialize)); Deserialize = deserialize ?? throw new ArgumentNullException(nameof(deserialize)); Overlay = overlay ?? throw new ArgumentNullException(nameof(overlay)); } // (value, value type, owning document type) public Func Serialize { get; } // (value type, owning document type, bytes) public Func Deserialize { get; } // (document payload, slot and encoded value pairs) public Func>, byte[]> Overlay { get; } } public enum CultOverrideOp { Set = 0, Insert = 1, Remove = 2 } // One step of a member path: the MessagePack slot, and the id of the object-list element the step enters ("" when it // does not enter one). public sealed class CultPathStep { public CultPathStep(int slot, string elementId = "") { Slot = slot; ElementId = elementId ?? string.Empty; } public int Slot { get; } public string ElementId { get; } public override string ToString() => ElementId.Length == 0 ? $"[{Slot}]" : $"[{Slot}:{ElementId}]"; } // The wire shape [op, path[], id, value]; value is the override's already-encoded MessagePack value. public sealed class CultVariantOverride { public CultVariantOverride(CultOverrideOp op, IReadOnlyList path, string id, byte[] value) { Op = op; Path = path ?? throw new ArgumentNullException(nameof(path)); Id = id ?? string.Empty; Value = value ?? throw new ArgumentNullException(nameof(value)); } public CultOverrideOp Op { get; } public IReadOnlyList Path { get; } public string Id { get; } public byte[] Value { get; } // A top-level Set: the whole member at slot takes the encoded value. public static CultVariantOverride Set(int slot, byte[] value) => new(CultOverrideOp.Set, new[] { new CultPathStep(slot) }, string.Empty, value); internal string PathText => string.Concat(Path.Select(step => step.ToString())); } // What a variant record stores: its base and its overrides. Never the resolved document. public sealed class CultVariantDelta { public CultVariantDelta(string baseKey, IReadOnlyList overrides) { BaseKey = baseKey ?? throw new ArgumentNullException(nameof(baseKey)); Overrides = overrides ?? throw new ArgumentNullException(nameof(overrides)); } public string BaseKey { get; } public IReadOnlyList Overrides { get; } } }