neon-sprawl/server/NeonSprawl.Server/Game/Contracts/ContractInstanceIds.cs

44 lines
1.6 KiB
C#

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}";
}
}