Extend managed macOS client toward feature parity

dotnet/src/VoiceCat.Core/ClientAdministration.cs

@@ -0,0 +1,71 @@
+using Voicecat.V1;
+
+namespace VoiceCat.Core;
+
+public sealed partial class VoiceCatClient
+{
+    public Permissions Permissions => Authentication?.Permissions?.Clone() ?? new Permissions();
+
+    public Task<GenericResult> KickUserAsync(uint userId, string reason = "", CancellationToken cancellationToken = default) =>
+        RequestGenericAsync(new() { Kick = new() { UserId = userId, Reason = reason } }, cancellationToken);
+
+    public Task<GenericResult> BanUserAsync(uint userId, string reason = "", ulong expiresUnixMs = 0, CancellationToken cancellationToken = default) =>
+        RequestGenericAsync(new() { Ban = new() { UserId = userId, Reason = reason, ExpiresUnixMs = expiresUnixMs } }, cancellationToken);
+
+    public Task<GenericResult> MoveUserAsync(uint userId, uint channelId, CancellationToken cancellationToken = default) =>
+        RequestGenericAsync(new() { MoveUser = new() { UserId = userId, ChannelId = channelId } }, cancellationToken);
+
+    public Task<GenericResult> SetServerMuteAsync(uint userId, bool muted, bool deafened, CancellationToken cancellationToken = default) =>
+        RequestGenericAsync(new() { ServerMute = new() { UserId = userId, Muted = muted, Deafened = deafened } }, cancellationToken);
+
+    public Task<GenericResult> SetPermissionsAsync(uint userId, Permissions permissions, CancellationToken cancellationToken = default) =>
+        RequestGenericAsync(new() { SetPermission = new() { UserId = userId, Permissions = permissions.Clone() } }, cancellationToken);
+
+    public Task<GenericResult> CreateChannelAsync(Channel channel, string password = "", CancellationToken cancellationToken = default) =>
+        RequestGenericAsync(new() { CreateChannel = new() { Channel = channel.Clone(), Password = password } }, cancellationToken);
+
+    public Task<GenericResult> EditChannelAsync(Channel channel, string password = "", CancellationToken cancellationToken = default) =>
+        RequestGenericAsync(new() { EditChannel = new() { Channel = channel.Clone(), Password = password } }, cancellationToken);
+
+    public Task<GenericResult> DeleteChannelAsync(uint channelId, CancellationToken cancellationToken = default) =>
+        RequestGenericAsync(new() { DeleteChannel = new() { ChannelId = channelId } }, cancellationToken);
+
+    public Task<GenericResult> CreateAccountAsync(string username, string password, CancellationToken cancellationToken = default) =>
+        RequestGenericAsync(new() { CreateAccount = new() { Username = username, Password = password } }, cancellationToken);
+
+    public Task<GenericResult> ResetPasswordAsync(string username, string password, CancellationToken cancellationToken = default) =>
+        RequestGenericAsync(new() { ResetPassword = new() { Username = username, NewPassword = password } }, cancellationToken);
+
+    public Task<GenericResult> DeleteAccountAsync(string username, CancellationToken cancellationToken = default) =>
+        RequestGenericAsync(new() { DeleteAccount = new() { Username = username } }, cancellationToken);
+
+    public async Task<IReadOnlyList<AccountEntry>> ListAccountsAsync(CancellationToken cancellationToken = default)
+    {
+        Envelope response = await RequestAsync(new() { ListAccounts = new() }, cancellationToken).ConfigureAwait(false);
+        if (response.ListAccountsResult is null) throw new IOException("Unexpected account-list response.");
+        return response.ListAccountsResult.Accounts.Select(account => account.Clone()).ToArray();
+    }
+
+    public void SetSelfAudioState(bool microphoneMuted, bool deafened)
+    {
+        Audio.MicMuted = microphoneMuted;
+        Audio.Deafened = deafened;
+        foreach (StreamInfo stream in LocalStreams)
+        {
+            (float _, bool talking) = Audio.GetLocalLevel(stream.StreamId);
+            Send(new() { StreamState = new() { StreamId = stream.StreamId, Muted = microphoneMuted, Talking = talking } });
+        }
+    }
+
+    public void PublishStreamState(uint streamId, bool talking)
+    {
+        if (!LocalStreams.Any(stream => stream.StreamId == streamId)) return;
+        Send(new() { StreamState = new() { StreamId = streamId, Muted = Audio.MicMuted, Talking = talking } });
+    }
+
+    private async Task<GenericResult> RequestGenericAsync(Envelope request, CancellationToken cancellationToken)
+    {
+        Envelope response = await RequestAsync(request, cancellationToken).ConfigureAwait(false);
+        return response.GenericResult?.Clone() ?? throw new IOException("Unexpected administration response.");
+    }
+}

dotnet/src/VoiceCat.Core/ServerProfile.cs

@@ -5,7 +5,8 @@ namespace VoiceCat.Core;
 
 public enum ServerAuthentication { Guest, Account }
 
-public sealed record ServerProfile(Guid Id, string Host, ushort Port, ServerAuthentication Authentication, string? Username, string? Nickname)
+public sealed record ServerProfile(Guid Id, string Host, ushort Port, ServerAuthentication Authentication, string? Username, string? Nickname,
+    [property: JsonIgnore] string? LegacyKeychainTag = null)
 {
     public static ServerProfile Create(string host, ushort port, ServerAuthentication authentication, string? username = null, string? nickname = null, Guid? id = null)
     {
@@ -43,7 +44,11 @@ public sealed class ServerProfileStore(string path)
         try
         {
             if (!File.Exists(path)) return [];
-            return (JsonSerializer.Deserialize<ServerProfile[]>(File.ReadAllBytes(path), Json) ?? [])
+            byte[] contents = File.ReadAllBytes(path);
+            using JsonDocument document = JsonDocument.Parse(contents);
+            if (document.RootElement.ValueKind == JsonValueKind.Array && document.RootElement.EnumerateArray().Any(LooksLegacy))
+                return LoadLegacy(document.RootElement);
+            return (JsonSerializer.Deserialize<ServerProfile[]>(contents, Json) ?? [])
                 .Where(profile => profile.IsValid).ToArray();
         }
         catch (Exception exception) when (exception is IOException or UnauthorizedAccessException or JsonException) { return []; }
@@ -55,6 +60,7 @@ public sealed class ServerProfileStore(string path)
         ServerProfile[] valid = profiles.Where(profile => profile is not null && profile.IsValid).ToArray();
         string fullPath = Path.GetFullPath(path);
         Directory.CreateDirectory(Path.GetDirectoryName(fullPath)!);
+        PreserveLegacyBackup(fullPath);
         string temporary = fullPath + "." + Guid.NewGuid().ToString("N") + ".tmp";
         try
         {
@@ -63,4 +69,38 @@ public sealed class ServerProfileStore(string path)
         }
         finally { if (File.Exists(temporary)) File.Delete(temporary); }
     }
+
+    private static bool LooksLegacy(JsonElement item) => item.ValueKind == JsonValueKind.Object && item.TryGetProperty("authMode", out _);
+
+    private static IReadOnlyList<ServerProfile> LoadLegacy(JsonElement root)
+    {
+        var profiles = new List<ServerProfile>();
+        foreach (JsonElement item in root.EnumerateArray())
+        {
+            if (!item.TryGetProperty("id", out JsonElement idValue) || !Guid.TryParse(idValue.GetString(), out Guid id) ||
+                !item.TryGetProperty("host", out JsonElement hostValue) || !item.TryGetProperty("port", out JsonElement portValue) ||
+                !portValue.TryGetUInt16(out ushort port)) continue;
+            string? mode = item.TryGetProperty("authMode", out JsonElement modeValue) ? modeValue.GetString() : null;
+            string? username = item.TryGetProperty("savedUsername", out JsonElement usernameValue) ? usernameValue.GetString() : null;
+            string? nickname = item.TryGetProperty("nickname", out JsonElement nicknameValue) ? nicknameValue.GetString() : null;
+            string? keychainTag = item.TryGetProperty("keychainTag", out JsonElement tagValue) ? tagValue.GetString() : null;
+            ServerAuthentication authentication = mode == "password" ? ServerAuthentication.Account : ServerAuthentication.Guest;
+            try { profiles.Add(ServerProfile.Create(hostValue.GetString() ?? "", port, authentication, username, nickname, id) with { LegacyKeychainTag = keychainTag }); }
+            catch (ArgumentException) { }
+        }
+        return profiles;
+    }
+
+    private static void PreserveLegacyBackup(string fullPath)
+    {
+        if (!File.Exists(fullPath)) return;
+        try
+        {
+            using JsonDocument document = JsonDocument.Parse(File.ReadAllBytes(fullPath));
+            if (document.RootElement.ValueKind != JsonValueKind.Array || !document.RootElement.EnumerateArray().Any(LooksLegacy)) return;
+            string backup = fullPath + ".swift-backup.json";
+            if (!File.Exists(backup)) File.Copy(fullPath, backup);
+        }
+        catch (JsonException) { }
+    }
 }