cards-native/Sources/Core/API/CardsAPI+Generation.swift

import Foundation
import ManaCore

/// AI-Deck-Generierung + Multipart-Helpers — ausgelagert aus `CardsAPI`,
/// damit der Haupt-Actor unter der Type-Body-Length-Grenze bleibt.
extension CardsAPI {
    /// `POST /api/v1/decks/generate` — KI generiert Deck aus Prompt.
    /// Rate-Limit serverseitig 10/min. Antwort dauert typisch 10–60s
    /// (synchron, kein Streaming).
    func generateDeckFromText(_ body: DeckGenerateBody) async throws -> DeckGenerateResponse {
        let data = try makeJSON(body)
        let (responseData, http) = try await transport.request(
            path: "/api/v1/decks/generate",
            method: "POST",
            body: data
        )
        try ensureOK(http, data: responseData)
        return try decoder.decode(DeckGenerateResponse.self, from: responseData)
    }

    /// `POST /api/v1/decks/from-image` — Vision-LLM generiert Deck aus
    /// Bildern und/oder PDFs (max 5 Files, 10 MiB pro Bild, 30 MiB pro PDF)
    /// und optional einer URL für Zusatz-Kontext. Rate-Limit 10/min.
    /// Multipart-Body mit `file`-Parts (wiederholt) + Text-Felder.
    func generateDeckFromMedia(
        files: [GenerationMediaFile],
        language: GenerationLanguage,
        count: Int,
        url: String?
    ) async throws -> DeckGenerateResponse {
        let boundary = "cards-native-\(UUID().uuidString)"
        let body = makeFromImageMultipartBody(
            files: files,
            language: language,
            count: count,
            url: url,
            boundary: boundary
        )
        let (responseData, http) = try await transport.request(
            path: "/api/v1/decks/from-image",
            method: "POST",
            body: body,
            contentType: "multipart/form-data; boundary=\(boundary)"
        )
        try ensureOK(http, data: responseData)
        return try decoder.decode(DeckGenerateResponse.self, from: responseData)
    }

    // MARK: - Multipart

    /// Single-File-Multipart-Body für `/media/upload`.
    func makeMultipartBody(
        file: Data,
        filename: String,
        mimeType: String,
        boundary: String
    ) -> Data {
        var body = Data()
        let lineBreak = "\r\n"
        let header = """
        --\(boundary)\(lineBreak)\
        Content-Disposition: form-data; name="file"; filename="\(filename)"\(lineBreak)\
        Content-Type: \(mimeType)\(lineBreak)\(lineBreak)
        """
        body.append(Data(header.utf8))
        body.append(file)
        body.append(Data(lineBreak.utf8))
        body.append(Data("--\(boundary)--\(lineBreak)".utf8))
        return body
    }

    /// Multi-File-Multipart-Body für `/decks/from-image` — mehrere Files
    /// unter dem Form-Feld `file` (Server liest sie via `getAll('file')`)
    /// plus optional `language`, `count`, `url` als Text-Felder.
    func makeFromImageMultipartBody(
        files: [GenerationMediaFile],
        language: GenerationLanguage,
        count: Int,
        url: String?,
        boundary: String
    ) -> Data {
        var body = Data()
        let lineBreak = "\r\n"

        func appendField(name: String, value: String) {
            let part = """
            --\(boundary)\(lineBreak)\
            Content-Disposition: form-data; name="\(name)"\(lineBreak)\(lineBreak)\
            \(value)\(lineBreak)
            """
            body.append(Data(part.utf8))
        }

        appendField(name: "language", value: language.rawValue)
        appendField(name: "count", value: String(count))
        if let url, !url.trimmingCharacters(in: .whitespaces).isEmpty {
            appendField(name: "url", value: url)
        }

        for file in files {
            let header = """
            --\(boundary)\(lineBreak)\
            Content-Disposition: form-data; name="file"; filename="\(file.filename)"\(lineBreak)\
            Content-Type: \(file.mimeType)\(lineBreak)\(lineBreak)
            """
            body.append(Data(header.utf8))
            body.append(file.data)
            body.append(Data(lineBreak.utf8))
        }

        body.append(Data("--\(boundary)--\(lineBreak)".utf8))
        return body
    }
}