package de.gecheckt.pdf.umbenenner.application.port.in;

import java.util.Objects;

import de.gecheckt.pdf.umbenenner.domain.model.DocumentFingerprint;

/**
 * Anfrage an den {@link ManualFileCopyUseCase} zum manuellen Kopieren der Quelldatei
 * eines bisher nicht erfolgreich verarbeiteten Dokuments mit einem benutzerdefinierten
 * Zieldateinamen.
 * <p>
 * Der Benutzer gibt im GUI ausschließlich den Basistitel ohne {@code .pdf}-Endung an.
 * Der Use-Case hängt die Erweiterung selbst an.
 *
 * @param fingerprint        Inhalts-Fingerabdruck des Dokuments, dessen Quelldatei
 *                           kopiert werden soll; nie null
 * @param desiredBaseFileName gewünschter Basisdateiname ohne {@code .pdf}-Endung;
 *                            nie null; darf nicht leer oder nur aus Leerzeichen bestehen
 */
public record ManualFileCopyRequest(
        DocumentFingerprint fingerprint,
        String desiredBaseFileName) {

    /**
     * Kompakter Konstruktor zur Validierung der Pflichtfelder.
     *
     * @throws NullPointerException     wenn {@code fingerprint} oder
     *                                  {@code desiredBaseFileName} null sind
     * @throws IllegalArgumentException wenn {@code desiredBaseFileName} leer ist
     */
    public ManualFileCopyRequest {
        Objects.requireNonNull(fingerprint, "fingerprint must not be null");
        Objects.requireNonNull(desiredBaseFileName, "desiredBaseFileName must not be null");
        if (desiredBaseFileName.isBlank()) {
            throw new IllegalArgumentException("desiredBaseFileName must not be blank");
        }
    }
}
