using System.Globalization;

namespace MaBibli.Shared.Isbn;

/// <summary>
/// Reconnaissance des codes-barres de <b>périodiques</b> et extraction de leur ISSN.
/// </summary>
/// <remarks>
/// Un livre porte un EAN-13 préfixé <c>978</c> ou <c>979</c> ; un magazine porte <c>977</c>,
/// qui encode un <b>ISSN</b> — c'est-à-dire un <i>titre de revue</i>, pas un ouvrage. Aucune
/// recherche <c>bib.isbn</c> ne peut donc aboutir sur un tel code, et l'application répondait
/// « aucun résultat » là où le code lui-même dit qu'on ne cherche pas au bon endroit.
/// <para>
/// Structure du code, vérifiée sur <c>9772466671438</c> le 2026-08-18 :
/// <c>977</c> + les <b>7 premiers chiffres de l'ISSN</b> (sa clé n'y figure pas, elle est
/// recalculée) + <b>2 chiffres de parution</b> + la clé EAN-13. Les deux chiffres de parution
/// sont la raison pour laquelle un même ISSN couvre tous les numéros d'une revue : ils ne sont
/// <b>pas</b> exploitables comme numéro d'édition fiable, et ne sont donc pas exposés ici.
/// </para>
/// </remarks>
public static class CodePeriodique
{
    /// <summary>Préfixe EAN-13 réservé aux publications en série.</summary>
    public const string Prefixe = "977";

    /// <summary>
    /// Vrai si <paramref name="ean"/> (déjà normalisé) est un EAN-13 valide de périodique.
    /// </summary>
    public static bool EstCodePeriodique(string? ean) =>
        IsbnUtils.EstIsbn13Valide(ean) && ean!.StartsWith(Prefixe, StringComparison.Ordinal);

    /// <summary>
    /// ISSN porté par le code-barres, sous sa forme canonique à tiret (<c>2466-6718</c>),
    /// ou <c>null</c> si le code n'est pas celui d'un périodique.
    /// </summary>
    /// <remarks>
    /// La clé de l'ISSN n'est pas dans le code-barres : elle se recalcule (somme pondérée 8→2,
    /// modulo 11, <c>X</c> si le complément vaut 10). C'est le même principe que la clé ISBN-10,
    /// sur sept chiffres au lieu de neuf.
    /// </remarks>
    public static string? IssnDepuis(string? ean)
    {
        if (!EstCodePeriodique(ean))
        {
            return null;
        }

        // Chiffres 4 à 10 du code : l'ISSN amputé de sa clé.
        var corps = ean!.Substring(3, 7);

        var somme = 0;
        for (var i = 0; i < 7; i++)
        {
            somme += (corps[i] - '0') * (8 - i);
        }

        var cle = (11 - (somme % 11)) % 11;
        var caractereCle = cle == 10 ? "X" : cle.ToString(CultureInfo.InvariantCulture);

        return $"{corps[..4]}-{corps[4..]}{caractereCle}";
    }
}
