rainbow-dragon/Sources/ForgeOffload/MHL.swift

import Foundation

/// Media Hash List (ASC MHL-style) manifest: per-file path/size/xxh64.
/// Structure follows MHL v2 hashlist shape; full ASC MHL chain/directory
/// hashes can layer on later without breaking this format.
public enum MHL {

    public struct Failure: Equatable, Sendable {
        public enum Reason: Equatable, Sendable {
            case missing
            case hashMismatch
            case sizeMismatch
        }
        public let path: String
        public let reason: Reason
    }

    public struct VerifyResult: Sendable {
        public let checked: Int
        public let failures: [Failure]
        public var passed: Bool { failures.isEmpty }
    }

    static func escape(_ s: String) -> String {
        s.replacingOccurrences(of: "&", with: "&")
            .replacingOccurrences(of: "<", with: "&lt;")
            .replacingOccurrences(of: ">", with: "&gt;")
    }

    static func unescape(_ s: String) -> String {
        s.replacingOccurrences(of: "&lt;", with: "<")
            .replacingOccurrences(of: "&gt;", with: ">")
            .replacingOccurrences(of: "&amp;", with: "&")
    }

    /// Build manifest XML for files (relative paths) under root.
    public static func generate(root: String, creator: String, files: [String]) throws -> String {
        let fm = FileManager.default
        let dateFormatter = ISO8601DateFormatter()
        var out = """
        <?xml version="1.0" encoding="UTF-8"?>
        <hashlist version="2.0">
          <creatorinfo>
            <creationdate>\(dateFormatter.string(from: Date()))</creationdate>
            <tool>\(escape(creator))</tool>
          </creatorinfo>
          <hashes>

        """
        for rel in files.sorted() {
            let full = root + "/" + rel
            guard fm.fileExists(atPath: full) else {
                throw OffloadError.fileNotFound(full)
            }
            let size = (try fm.attributesOfItem(atPath: full)[.size] as? UInt64) ?? 0
            let hash = try FileHasher.xxh64(path: full)
            out += """
                <hash>
                  <path>\(escape(rel))</path>
                  <size>\(size)</size>
                  <xxh64>\(hash)</xxh64>
                </hash>

            """
        }
        out += "  </hashes>\n</hashlist>\n"
        return out
    }

    /// Write manifest to file.
    public static func write(root: String, creator: String, files: [String], to path: String) throws {
        let xml = try generate(root: root, creator: creator, files: files)
        try xml.write(toFile: path, atomically: true, encoding: .utf8)
    }

    /// Verify manifest against tree at root.
    public static func verify(manifest: String, root: String) throws -> VerifyResult {
        let entries = try parse(manifest)
        let fm = FileManager.default
        var failures = [Failure]()
        for e in entries {
            let full = root + "/" + e.path
            guard fm.fileExists(atPath: full) else {
                failures.append(Failure(path: e.path, reason: .missing))
                continue
            }
            let size = (try fm.attributesOfItem(atPath: full)[.size] as? UInt64) ?? 0
            if size != e.size {
                failures.append(Failure(path: e.path, reason: .sizeMismatch))
                continue
            }
            let hash = try FileHasher.xxh64(path: full)
            if hash != e.xxh64 {
                failures.append(Failure(path: e.path, reason: .hashMismatch))
            }
        }
        return VerifyResult(checked: entries.count, failures: failures)
    }

    struct Entry {
        let path: String
        let size: UInt64
        let xxh64: String
    }

    /// Scanner-based parse of <hash> blocks.
    static func parse(_ xml: String) throws -> [Entry] {
        guard xml.contains("<hashlist") else {
            throw OffloadError.readFailed("not an MHL manifest")
        }
        var entries = [Entry]()
        var searchRange = xml.startIndex..<xml.endIndex
        while let blockStart = xml.range(of: "<hash>", range: searchRange),
              let blockEnd = xml.range(of: "</hash>", range: blockStart.upperBound..<xml.endIndex) {
            let block = String(xml[blockStart.upperBound..<blockEnd.lowerBound])
            func field(_ tag: String) -> String? {
                guard let open = block.range(of: "<\(tag)>"),
                      let close = block.range(of: "</\(tag)>"),
                      open.upperBound <= close.lowerBound else { return nil }
                return String(block[open.upperBound..<close.lowerBound])
            }
            guard let path = field("path"),
                  let sizeStr = field("size"), let size = UInt64(sizeStr),
                  let hash = field("xxh64") else {
                throw OffloadError.readFailed("malformed <hash> entry")
            }
            entries.append(Entry(path: unescape(path), size: size, xxh64: hash))
            searchRange = blockEnd.upperBound..<xml.endIndex
        }
        guard !entries.isEmpty else {
            throw OffloadError.readFailed("no hash entries in manifest")
        }
        return entries
    }
}