| | | 1 | | using System.Globalization; |
| | | 2 | | |
| | | 3 | | namespace RoleRadar.Domain.Notes; |
| | | 4 | | |
| | | 5 | | public enum ProvenanceKind |
| | | 6 | | { |
| | | 7 | | Stated, |
| | | 8 | | Researched, |
| | | 9 | | Inferred |
| | | 10 | | } |
| | | 11 | | |
| | | 12 | | public static class ProvenanceKindExtensions |
| | | 13 | | { |
| | | 14 | | public static string ToWireString(this ProvenanceKind kind) => kind switch |
| | | 15 | | { |
| | | 16 | | ProvenanceKind.Stated => "stated", |
| | | 17 | | ProvenanceKind.Researched => "researched", |
| | | 18 | | ProvenanceKind.Inferred => "inferred", |
| | | 19 | | _ => throw new ArgumentOutOfRangeException(nameof(kind), kind, "Unknown provenance kind.") |
| | | 20 | | }; |
| | | 21 | | |
| | | 22 | | public static ProvenanceKind FromWireString(string value) |
| | | 23 | | { |
| | | 24 | | if (string.IsNullOrWhiteSpace(value)) |
| | | 25 | | { |
| | | 26 | | throw new ArgumentException("Provenance kind cannot be null or whitespace.", nameof(value)); |
| | | 27 | | } |
| | | 28 | | |
| | | 29 | | return value.Trim().ToLowerInvariant() switch |
| | | 30 | | { |
| | | 31 | | "stated" => ProvenanceKind.Stated, |
| | | 32 | | "researched" => ProvenanceKind.Researched, |
| | | 33 | | "inferred" => ProvenanceKind.Inferred, |
| | | 34 | | _ => throw new ArgumentException( |
| | | 35 | | $"Unsupported provenance kind '{value}'. Expected 'stated', 'researched', or 'inferred'.", |
| | | 36 | | nameof(value)) |
| | | 37 | | }; |
| | | 38 | | } |
| | | 39 | | |
| | | 40 | | public static bool TryParseWireString(string? value, out ProvenanceKind kind) |
| | | 41 | | { |
| | | 42 | | if (string.IsNullOrWhiteSpace(value)) |
| | | 43 | | { |
| | | 44 | | kind = default; |
| | | 45 | | return false; |
| | | 46 | | } |
| | | 47 | | |
| | | 48 | | switch (value.Trim().ToLowerInvariant()) |
| | | 49 | | { |
| | | 50 | | case "stated": |
| | | 51 | | kind = ProvenanceKind.Stated; |
| | | 52 | | return true; |
| | | 53 | | case "researched": |
| | | 54 | | kind = ProvenanceKind.Researched; |
| | | 55 | | return true; |
| | | 56 | | case "inferred": |
| | | 57 | | kind = ProvenanceKind.Inferred; |
| | | 58 | | return true; |
| | | 59 | | default: |
| | | 60 | | kind = default; |
| | | 61 | | return false; |
| | | 62 | | } |
| | | 63 | | } |
| | | 64 | | } |
| | | 65 | | |
| | | 66 | | public sealed record ProvenanceMarker |
| | | 67 | | { |
| | 2768 | 68 | | public ProvenanceKind Kind { get; } |
| | | 69 | | |
| | 2768 | 70 | | public string Date { get; } |
| | | 71 | | |
| | 2852 | 72 | | public string? Qualifier { get; } |
| | | 73 | | |
| | 4586 | 74 | | public ProvenanceMarker(ProvenanceKind kind, string date, string? qualifier = null) |
| | | 75 | | { |
| | 4586 | 76 | | if (!Enum.IsDefined(kind)) |
| | | 77 | | { |
| | 0 | 78 | | throw new ArgumentOutOfRangeException(nameof(kind), kind, "Invalid provenance kind."); |
| | | 79 | | } |
| | | 80 | | |
| | 4586 | 81 | | if (!IsValidIsoDate(date)) |
| | | 82 | | { |
| | 4 | 83 | | throw new ArgumentException($"Provenance date '{date}' must be a valid ISO-8601 date in 'YYYY-MM-DD' format. |
| | | 84 | | } |
| | | 85 | | |
| | 4582 | 86 | | Kind = kind; |
| | 4582 | 87 | | Date = date.Trim(); |
| | 4582 | 88 | | Qualifier = string.IsNullOrWhiteSpace(qualifier) ? null : qualifier.Trim(); |
| | 4582 | 89 | | } |
| | | 90 | | |
| | | 91 | | public static bool IsValidIsoDate(string? date) => |
| | 4890 | 92 | | !string.IsNullOrWhiteSpace(date) && |
| | 4890 | 93 | | DateOnly.TryParseExact(date.Trim(), "yyyy-MM-dd", CultureInfo.InvariantCulture, DateTimeStyles.None, out _); |
| | | 94 | | } |