namespace NeonSprawl.Server.Game.Contracts;

/// <summary>Id normalization for contract instance stores (NEO-146).</summary>
public static class ContractInstanceIds
{
    /// <summary>Trim + lowercase; empty when input is null/whitespace.</summary>
    public static string NormalizePlayerId(string? playerId)
    {
        var trimmed = playerId?.Trim();
        if (string.IsNullOrEmpty(trimmed))
        {
            return string.Empty;
        }

        return trimmed.ToLowerInvariant();
    }

    /// <summary>Trim + lowercase; empty when input is null/whitespace.</summary>
    public static string NormalizeContractInstanceId(string? contractInstanceId) => NormalizePlayerId(contractInstanceId);

    /// <summary>Trim + lowercase; empty when input is null/whitespace.</summary>
    public static string NormalizeTemplateId(string? templateId) => NormalizePlayerId(templateId);

    /// <summary>Trim; empty when input is null/whitespace (seed bucket casing preserved).</summary>
    public static string NormalizeSeedBucket(string? seedBucket)
    {
        var trimmed = seedBucket?.Trim();
        return string.IsNullOrEmpty(trimmed) ? string.Empty : trimmed;
    }

    /// <summary>Composite store key for <paramref name="playerId"/> + <paramref name="contractInstanceId"/>.</summary>
    public static string MakeInstanceKey(string? playerId, string? contractInstanceId)
    {
        var p = NormalizePlayerId(playerId);
        var i = NormalizeContractInstanceId(contractInstanceId);
        if (p.Length == 0 || i.Length == 0)
        {
            return string.Empty;
        }

        return $"{p}\0{i}";
    }
}