Initial commit: scadaproj umbrella — sister-project index, auth component normalization (design + GAPS), and the built ZB.MOM.WW.Auth shared library (0.1.0, flattened in).

2026-06-01 03:59:23 -04:00
commit 37e23cf9f2
73 changed files with 6836 additions and 0 deletions
@@ -0,0 +1,35 @@
+using System.Text.Json;
+
+namespace ZB.MOM.WW.Auth.ApiKeys.Sqlite;
+
+/// <summary>
+/// Serializes API-key scope sets to a canonical JSON array. Scopes are sorted with
+/// <see cref="StringComparer.Ordinal"/> so that equal sets always produce identical
+/// column text, regardless of insertion order.
+/// </summary>
+public static class ScopeSerializer
+{
+    /// <summary>Serializes scopes to an ordinal-sorted JSON array.</summary>
+    /// <param name="scopes">The scopes to serialize.</param>
+    /// <returns>A JSON array string with elements sorted ordinally.</returns>
+    public static string Serialize(IReadOnlySet<string> scopes)
+    {
+        ArgumentNullException.ThrowIfNull(scopes);
+        return JsonSerializer.Serialize(scopes.Order(StringComparer.Ordinal));
+    }
+
+    /// <summary>Deserializes scopes from a JSON array string.</summary>
+    /// <param name="value">The JSON string to deserialize; may be null or empty.</param>
+    /// <returns>An ordinal-compared set of scopes; empty when the input is null/blank.</returns>
+    public static IReadOnlySet<string> Deserialize(string? value)
+    {
+        if (string.IsNullOrWhiteSpace(value))
+        {
+            return new HashSet<string>(StringComparer.Ordinal);
+        }
+
+        string[]? scopes = JsonSerializer.Deserialize<string[]>(value);
+
+        return new HashSet<string>(scopes ?? [], StringComparer.Ordinal);
+    }
+}