namespace MaBibli.Shared.Dtos;

/// <summary>Source d'où proviennent les métadonnées d'un candidat.</summary>
public enum SourceMetadonnees
{
    /// <summary>Catalogue général de la BnF, via son API SRU (Dublin Core).</summary>
    Bnf = 0,

    /// <summary>OpenLibrary (Internet Archive), second rideau de la cascade.</summary>
    OpenLibrary = 1,
}

/// <summary>
/// Une notice candidate pour un ISBN donné.
/// </summary>
/// <remarks>
/// Un même ISBN peut correspondre à <b>plusieurs</b> notices (rééditions successives partageant
/// l'ISBN). Décision actée dans CLAUDE.md : on ne choisit pas à la place de l'utilisateur,
/// on lui présente tous les candidats. C'est l'interface (phase 3) qui fera choisir.
/// </remarks>
public record CandidatLivre
{
    /// <summary>Titre nettoyé de la ponctuation ISBD.</summary>
    public required string Titre { get; init; }

    /// <summary>Auteur au format « Prénom Nom », ou <c>null</c> si la source n'en donne pas.</summary>
    public string? Auteur { get; init; }

    public string? Editeur { get; init; }

    /// <summary>Année de publication telle que fournie par la source (texte : « 1979 », « March 2007 »…).</summary>
    public string? Annee { get; init; }

    /// <summary>Code langue tel que fourni par la source (« fre », « eng »…).</summary>
    public string? Langue { get; init; }

    /// <summary>URL de la couverture chez OpenLibrary, toujours renseignée (voir remarques du service).</summary>
    public string? CoverUrl { get; init; }

    public required SourceMetadonnees Source { get; init; }

    /// <summary>Forme d'ISBN qui a effectivement produit cette notice (13 ou 10 converti).</summary>
    public string? IsbnInterroge { get; init; }

    /// <summary>Identifiant chez la source : ark BnF (<c>ark:/12148/cb…</c>) ou clé OpenLibrary (<c>/books/OL…M</c>).</summary>
    public string? IdentifiantSource { get; init; }
}