using System.Security.Cryptography; using System.Text; namespace TuneBoss.Core.IO; /// /// The on-disk envelope of a TuneBoss .tst map file: /// /// MD5(tag)_____tag\nMD5(data)_____data /// /// Two records separated by a newline; each record is MD5hex_____payload. /// The MD5 is upper-case hex with no separators (matching the legacy /// BitConverter.ToString(...).Replace("-","")). On load, both digests are /// recomputed and must match or the file is rejected as corrupt/tampered. /// public static class MapFile { public const string Extension = ".tst"; public const string RecordSep = "_____"; /// Upper-case, separator-free MD5 hex of a UTF-8 string. public static string Md5Hex(string s) { var hash = MD5.HashData(Encoding.UTF8.GetBytes(s)); return Convert.ToHexString(hash); // upper-case, no separators } /// Builds the full file text from a tag string and a data string. public static string BuildEnvelope(string tag, string data) => $"{Md5Hex(tag)}{RecordSep}{tag}\n{Md5Hex(data)}{RecordSep}{data}"; public readonly record struct ParseResult( bool Ok, string Tag, string Data, string? Error) { public static ParseResult Fail(string error) => new(false, "", "", error); public static ParseResult Success(string tag, string data) => new(true, tag, data, null); } /// /// Parses and integrity-checks a file's full text. Splits on \r\n or /// \n, separates each record on _____, and verifies both MD5s. /// public static ParseResult TryParse(string fileText) { if (string.IsNullOrEmpty(fileText)) return ParseResult.Fail("File is empty."); var lines = fileText.Split(new[] { "\r\n", "\n" }, StringSplitOptions.None); if (lines.Length < 2) return ParseResult.Fail("File is not a valid TuneBoss map (missing data record)."); var tagRec = SplitOnce(lines[0]); var dataRec = SplitOnce(lines[1]); if (tagRec is null || dataRec is null) return ParseResult.Fail("File is not a valid TuneBoss map (bad record format)."); var (tagHash, tag) = tagRec.Value; var (dataHash, data) = dataRec.Value; if (!string.Equals(tagHash, Md5Hex(tag), StringComparison.OrdinalIgnoreCase)) return ParseResult.Fail("Tag checksum mismatch — the file may be corrupt or edited."); if (!string.Equals(dataHash, Md5Hex(data), StringComparison.OrdinalIgnoreCase)) return ParseResult.Fail("Data checksum mismatch — the file may be corrupt or edited."); return ParseResult.Success(tag, data); } private static (string Hash, string Payload)? SplitOnce(string record) { int i = record.IndexOf(RecordSep, StringComparison.Ordinal); if (i < 0) return null; return (record[..i], record[(i + RecordSep.Length)..]); } }