AX-Copilot-Codex/src/AxCopilot/Services/UrlTemplateEngine.cs

using System.Text.RegularExpressions;

namespace AxCopilot.Services;

/// <summary>
/// Phase L3-4: URL 템플릿 엔진.
/// {0}, {1}, {query}, {param} 등의 플레이스홀더를 인자로 치환합니다.
/// </summary>
public static class UrlTemplateEngine
{
    private static readonly Regex NamedPlaceholder = new(@"\{(\w+)\}", RegexOptions.Compiled);
    private static readonly Regex IndexedPlaceholder = new(@"\{(\d+)\}", RegexOptions.Compiled);

    /// <summary>
    /// URL 템플릿의 플레이스홀더를 args 배열로 치환합니다.
    /// {0}, {1} — 순서 기반 | {query}, {param} 등 — 첫 번째 인자로 치환
    /// </summary>
    public static string Expand(string urlTemplate, params string[] args)
    {
        if (string.IsNullOrEmpty(urlTemplate)) return urlTemplate;

        var encoded = args.Select(Uri.EscapeDataString).ToArray();

        // 인덱스 기반: {0}, {1}…
        var result = IndexedPlaceholder.Replace(urlTemplate, m =>
        {
            if (int.TryParse(m.Groups[1].Value, out var idx) && idx < encoded.Length)
                return encoded[idx];
            return m.Value;
        });

        // 이름 기반: {query}, {param}… → 첫 번째 인자로 치환
        result = NamedPlaceholder.Replace(result, m =>
        {
            return encoded.Length > 0 ? encoded[0] : m.Value;
        });

        return result;
    }

    /// <summary>공백으로 구분된 쿼리 문자열을 파싱하여 템플릿에 적용합니다.</summary>
    public static string ExpandFromQuery(string urlTemplate, string query)
    {
        var parts = query.Trim().Split(' ', StringSplitOptions.RemoveEmptyEntries);
        return Expand(urlTemplate, parts);
    }

    /// <summary>템플릿에 포함된 플레이스홀더 목록을 반환합니다.</summary>
    public static IReadOnlyList<string> GetPlaceholders(string urlTemplate)
    {
        var result = new List<string>();
        foreach (Match m in NamedPlaceholder.Matches(urlTemplate))
            result.Add(m.Groups[1].Value);
        return result;
    }
}