Futonizer/Services/FileNameHelper.cs

using System.IO;
using System.Text.RegularExpressions;

namespace Futonizer.Services;

/// <summary>
/// Pure static helpers for computing the final output filename from a source
/// file path, applying release-tag prefixing and show-name injection.
/// </summary>
public static class FileNameHelper
{
    // Folder suffix release tag:  "Show Name-TTGA"  →  tag = "TTGA"
    // All-uppercase, 2-8 chars, at end of folder name.
    private static readonly Regex FolderSuffixTagRegex =
        new(@"-([A-Z][A-Z0-9]{1,7})$", RegexOptions.Compiled);

    // File suffix release tag:  "…HEVC-DemiHuman"  →  tag = "DemiHuman"
    // Mixed case, 3-21 chars (no dots/spaces), at end of filename stem.
    // Min 3 chars avoids false-positives like "-v2" or "-HD".
    private static readonly Regex FileSuffixTagRegex =
        new(@"-([A-Za-z][A-Za-z0-9]{2,20})$", RegexOptions.Compiled);

    // Prefix release tag:  "[KAA] Show Name"  →  tag = "KAA"
    private static readonly Regex PrefixTagRegex =
        new(@"^\[(.+?)\]", RegexOptions.Compiled);

    // Episode-only filename: starts with S01E01, S1E1, etc. (no show name present)
    private static readonly Regex EpisodeOnlyRegex =
        new(@"^S\d+E\d+", RegexOptions.IgnoreCase | RegexOptions.Compiled);

    // Individual metadata-token patterns used to find where the show name ends
    // inside a folder name.
    private static readonly Regex[] MetadataPatterns =
    [
        new(@"^S\d+$",                                                              RegexOptions.IgnoreCase | RegexOptions.Compiled), // S01
        new(@"^S\d+E\d+",                                                          RegexOptions.IgnoreCase | RegexOptions.Compiled), // S01E01...
        new(@"^E[Pp]?\d+$",                                                        RegexOptions.IgnoreCase | RegexOptions.Compiled), // E01, EP01
        new(@"^\d{3,4}[pP]$",                                                      RegexOptions.Compiled),                           // 1080p, 720p
        new(@"^(4K|UHD|2160p)$",                                                   RegexOptions.IgnoreCase | RegexOptions.Compiled), // 4K, UHD
        new(@"^(BD|BluRay|Blu-Ray|WEB|WEB-DL|WEBRip|HDTV|AMZN|NF|DSNP|HULU|MAX)$",RegexOptions.IgnoreCase | RegexOptions.Compiled), // sources
        new(@"^(Remux|Encode)$",                                                   RegexOptions.IgnoreCase | RegexOptions.Compiled), // processing
        new(@"^(HEVC|AVC|x264|x265|H\.?264|H\.?265|VP9)$",                        RegexOptions.IgnoreCase | RegexOptions.Compiled), // video codecs
        new(@"^(FLAC|AAC|DTS|TrueHD|Atmos|AC3|EAC3|Opus|MP3)$",                  RegexOptions.IgnoreCase | RegexOptions.Compiled), // audio codecs
        new(@"^(HDR|SDR|10bit|8bit|HDR10|DV|DoVi)$",                              RegexOptions.IgnoreCase | RegexOptions.Compiled), // HDR / bit-depth
    ];

    // -------------------------------------------------------------------------

    /// <summary>
    /// Computes the final output filename for a given source file path, applying
    /// (in order):
    /// <list type="number">
    ///   <item>Filename suffix tag extraction — a trailing <c>-GroupName</c> on
    ///         the filename stem is stripped and promoted to a bracket prefix.
    ///         Takes priority over any folder-derived tag.</item>
    ///   <item>Show-name injection — if the (now tag-free) filename starts with
    ///         an episode code (e.g. S01E01) the show name is derived from the
    ///         parent folder and prepended.</item>
    ///   <item>Release-tag prefix — a <c>[TAG]</c> bracket prefix, sourced from
    ///         the filename suffix, the folder suffix, or the folder prefix,
    ///         in that priority order.</item>
    /// </list>
    /// Returns the original filename unchanged when no transformations apply.
    /// </summary>
    public static string ComputeOutputFileName(string sourceFilePath)
    {
        string fileName    = Path.GetFileName(sourceFilePath);
        string ext         = Path.GetExtension(fileName);
        string stemNoExt   = Path.GetFileNameWithoutExtension(fileName);
        string? folder     = Path.GetDirectoryName(sourceFilePath);
        string folderName  = string.IsNullOrEmpty(folder) ? "" : (Path.GetFileName(folder) ?? "");

        // 1. Extract in-filename suffix tag and remove it from the stem.
        //    e.g. "...HEVC-DemiHuman" → tag="DemiHuman", stem="...HEVC"
        string? fileTag = null;
        var fileSuffixMatch = FileSuffixTagRegex.Match(stemNoExt);
        if (fileSuffixMatch.Success)
        {
            fileTag  = fileSuffixMatch.Groups[1].Value;
            stemNoExt = stemNoExt[..fileSuffixMatch.Index];
            fileName  = stemNoExt + ext;
        }

        // 2. Determine the release tag: filename suffix > folder tag.
        string? tag = fileTag;
        if (string.IsNullOrEmpty(tag) && !string.IsNullOrEmpty(folderName))
            tag = ExtractReleaseTag(folderName);

        // 3. Inject show name when only an episode code is present.
        if (EpisodeOnlyRegex.IsMatch(stemNoExt) && !string.IsNullOrEmpty(folderName))
        {
            string showName = ExtractShowName(folderName);
            if (!string.IsNullOrEmpty(showName))
                fileName = showName + " " + fileName;
        }

        // 4. Prepend release tag if not already present.
        if (!string.IsNullOrEmpty(tag))
        {
            string tagPrefix = $"[{tag}]";
            if (!fileName.StartsWith(tagPrefix, StringComparison.OrdinalIgnoreCase))
                fileName = tagPrefix + " " + fileName;
        }

        return fileName;
    }

    /// <summary>
    /// Extracts the release tag string (without brackets) from a folder name.
    /// Suffix pattern (<c>-TAG</c>) takes priority over prefix pattern
    /// (<c>[TAG]</c>).  Returns <c>null</c> when neither is present.
    /// </summary>
    public static string? ExtractReleaseTag(string folderName)
    {
        var suffixMatch = FolderSuffixTagRegex.Match(folderName);
        if (suffixMatch.Success) return suffixMatch.Groups[1].Value;

        var prefixMatch = PrefixTagRegex.Match(folderName);
        if (prefixMatch.Success) return prefixMatch.Groups[1].Value;

        return null;
    }

    /// <summary>
    /// Derives the show name from a folder name by stripping any release tag
    /// (prefix or suffix) and then taking all words that precede the first
    /// recognised metadata token (season, quality, source, codec, etc.).
    /// </summary>
    public static string ExtractShowName(string folderName)
    {
        // Strip release tags first.
        string name = FolderSuffixTagRegex.Replace(folderName, "").Trim();
        name = PrefixTagRegex.Replace(name, "").Trim();

        // Collect words up to the first metadata token.
        var words     = name.Split(' ', StringSplitOptions.RemoveEmptyEntries);
        var showWords = new List<string>();
        foreach (var word in words)
        {
            if (IsMetadataToken(word)) break;
            showWords.Add(word);
        }

        return string.Join(" ", showWords).Trim();
    }

    private static bool IsMetadataToken(string token)
    {
        foreach (var pattern in MetadataPatterns)
            if (pattern.IsMatch(token)) return true;
        return false;
    }
}