Flaro/server/src/Flaro.Core/Library/SidecarNames.cs

namespace Flaro.Core.Library;

/// <summary>Welche Dateien Flaro neben eine Mediendatei legen darf — und sonst keine.</summary>
///
/// <remarks>
/// <para>
/// <b>Eine Erlaubnisliste, und sie ist der ganze Schutz.</b> Damit Plakate und
/// Metadaten im Filmordner landen können, muss die Einhängung schreibbar
/// sein — und damit kann der Server im Grundsatz alles dort anstellen. Dass
/// er es nicht tut, hängt an dieser Liste und an der Prüfung darunter.
/// </para>
/// <para>
/// <b>Mediendateien werden nie angefasst.</b> Nicht geändert, nicht
/// umbenannt, nicht gelöscht. Es gibt im ganzen Projekt keine Stelle, die das
/// könnte, und diese Liste ist der Grund: was nicht daraufsteht, wird
/// abgelehnt — auch wenn jemand es ausdrücklich verlangt.
/// </para>
/// <para>
/// <b>Transcode-Zwischenstände gehören ausdrücklich nicht hierher.</b> Die
/// liegen unter <c>FLARO_TRANSCODE</c>, auf einem eigenen Volume. Ein
/// Medienordner ist kein Transcode-Cache.
/// </para>
/// </remarks>
public static class SidecarNames
{
    public const string MoviePoster = "poster.jpg";
    public const string MovieBackdrop = "fanart.jpg";
    public const string MovieLogo = "logo.png";
    public const string MovieNfo = "movie.nfo";

    public const string SeriesPoster = "poster.jpg";
    public const string SeriesBackdrop = "fanart.jpg";
    public const string SeriesNfo = "tvshow.nfo";

    /// <summary>Was zu einer Folge gehört, hängt am Namen ihrer Datei.</summary>
    ///
    /// <remarks>
    /// Aus <c>Dark - S01E01.mkv</c> werden <c>Dark - S01E01.nfo</c> und
    /// <c>Dark - S01E01-thumb.jpg</c>. So erwarten es Kodi, Jellyfin und Plex
    /// — und so findet auch ein Mensch sie wieder.
    /// </remarks>
    public static string EpisodeNfo(string mediendatei) =>
        Path.GetFileNameWithoutExtension(mediendatei) + ".nfo";

    public static string EpisodeThumb(string mediendatei) =>
        Path.GetFileNameWithoutExtension(mediendatei) + "-thumb.jpg";

    /// <summary>Beiwerk für einen Film, der sich den Ordner mit anderen teilt.</summary>
    ///
    /// <remarks>
    /// <b>Sonst überschreiben sich zwei Filme gegenseitig das Plakat.</b> Wer
    /// je Film einen Ordner anlegt, bekommt die schlichten Namen; wer zehn
    /// Filme nebeneinanderlegt, bekommt sie mit dem Dateinamen davor. Kodi und
    /// Jellyfin lesen beide Formen.
    /// </remarks>
    public static string Prefixed(string mediendatei, string beiwerk) =>
        Path.GetFileNameWithoutExtension(mediendatei) + "-" + beiwerk;

    private static readonly HashSet<string> Feste = new(StringComparer.OrdinalIgnoreCase)
        { MoviePoster, MovieBackdrop, MovieLogo, MovieNfo, SeriesNfo };

    private static readonly string[] Endungen =
        [".nfo", "-thumb.jpg", "-poster.jpg", "-fanart.jpg", "-logo.png"];

    /// <summary>Ob dieser Dateiname geschrieben werden darf.</summary>
    ///
    /// <remarks>
    /// <b>Geprüft wird der Name, nicht die Absicht.</b> Ein Pfadbestandteil,
    /// ein Verzeichniswechsel oder ein führender Punkt kommen hier nicht
    /// durch — und „film.mkv" erst recht nicht, auch wenn es auf <c>.nfo</c>
    /// endete.
    /// </remarks>
    public static bool MayWrite(string dateiname)
    {
        if (string.IsNullOrWhiteSpace(dateiname)) return false;

        // Kein Pfad, nur ein Name. Alles andere könnte aus dem Ordner führen.
        if (dateiname.Contains('/') || dateiname.Contains('\\')) return false;
        if (dateiname != Path.GetFileName(dateiname)) return false;
        if (dateiname.StartsWith('.')) return false;
        if (dateiname.Contains("..", StringComparison.Ordinal)) return false;

        if (Feste.Contains(dateiname)) return true;

        // Je Folge: beliebiger Rumpf, aber nur mit diesen Endungen.
        return Endungen.Any(e => dateiname.EndsWith(e, StringComparison.OrdinalIgnoreCase)
                                 && dateiname.Length > e.Length);
    }
}