git.stella-ops.org/src/Notifier/StellaOps.Notifier/StellaOps.Notifier.WebService/Contracts/LocalizationContracts.cs

namespace StellaOps.Notifier.WebService.Contracts;

/// <summary>
/// Request to create/update a localization bundle.
/// </summary>
public sealed record LocalizationBundleUpsertRequest
{
    public string? Locale { get; init; }
    public string? BundleKey { get; init; }
    public IReadOnlyDictionary<string, string>? Strings { get; init; }
    public bool? IsDefault { get; init; }
    public string? ParentLocale { get; init; }
    public string? Description { get; init; }
    public IReadOnlyDictionary<string, string>? Metadata { get; init; }
}

/// <summary>
/// Request to resolve localized strings.
/// </summary>
public sealed record LocalizationResolveRequest
{
    public string? BundleKey { get; init; }
    public IReadOnlyList<string>? StringKeys { get; init; }
    public string? Locale { get; init; }
}

/// <summary>
/// Response containing resolved localized strings.
/// </summary>
public sealed record LocalizationResolveResponse
{
    public required IReadOnlyDictionary<string, LocalizedStringResult> Strings { get; init; }
    public required string RequestedLocale { get; init; }
    public required IReadOnlyList<string> FallbackChain { get; init; }
}

/// <summary>
/// Result for a single localized string.
/// </summary>
public sealed record LocalizedStringResult
{
    public required string Value { get; init; }
    public required string ResolvedLocale { get; init; }
    public required bool UsedFallback { get; init; }
}