api: Add updateSettings route

Author: chrisbobbe

lib/api/model/events.g.dart

@@ -257,6 +257,7 @@ class UserSettings {
   // (1) add it to the [UserSettingName] enum
   // (2) then re-run the command to refresh the .g.dart files
   // (3) handle the event that signals an update to the setting
+  // (4) add the setting to the [updateSettings] route binding
 
   UserSettings({
     required this.twentyFourHourTime,

lib/api/model/initial_snapshot.dart

@@ -180,6 +180,8 @@ enum UserSettingName {
   // _$…EnumMap is thanks to `alwaysCreate: true` and `fieldRename: FieldRename.snake`
   static final _byRawString = _$UserSettingNameEnumMap
     .map((key, value) => MapEntry(value, key));
+
+  String toJson() => _$UserSettingNameEnumMap[this]!;
 }
 
 /// As in [UserSettings.emojiset].
@@ -199,6 +201,8 @@ enum Emojiset {
   // _$…EnumMap is thanks to `alwaysCreate: true` and `fieldRename: FieldRename.kebab`
   static final _byRawString = _$EmojisetEnumMap
     .map((key, value) => MapEntry(value, key));
+
+  String toJson() => _$EmojisetEnumMap[this]!;
 }
 
 /// As in [InitialSnapshot.realmUserGroups] or [UserGroupAddEvent].

lib/api/model/initial_snapshot.g.dart

@@ -0,0 +1,22 @@
+import '../core.dart';
+import '../model/model.dart';
+
+/// https://zulip.com/api/update-settings
+Future<void> updateSettings(ApiConnection connection, {
+  required Map<UserSettingName, Object?> newSettings,
+}) {
+  final params = <String, Object?>{};
+  for (final entry in newSettings.entries) {
+    final name = entry.key;
+    final valueRaw = entry.value;
+    final value = switch (name) {
+      UserSettingName.twentyFourHourTime => valueRaw as bool,
+      UserSettingName.displayEmojiReactionUsers => valueRaw as bool,
+      UserSettingName.emojiset => RawParameter((valueRaw as Emojiset).toJson()),
+      UserSettingName.presenceEnabled => valueRaw as bool,
+    };
+    params[name.toJson()] = value;
+  }
+
+  return connection.patch('updateSettings', (_) {}, 'settings', params);
+}

lib/api/model/model.dart

@@ -0,0 +1,41 @@
+import 'package:checks/checks.dart';
+import 'package:http/http.dart' as http;
+import 'package:flutter_test/flutter_test.dart';
+import 'package:zulip/api/model/model.dart';
+import 'package:zulip/api/route/settings.dart';
+
+import '../../stdlib_checks.dart';
+import '../fake_api.dart';
+
+void main() {
+  test('smoke updateSettings', () {
+    return FakeApiConnection.with_((connection) async {
+      connection.prepare(json: {});
+
+      final newSettings = <UserSettingName, Object?>{};
+      final expectedBodyFields = <String, String>{};
+      for (final name in UserSettingName.values) {
+        switch (name) {
+          case UserSettingName.twentyFourHourTime:
+            newSettings[name] = true;
+            expectedBodyFields['twenty_four_hour_time'] = 'true';
+          case UserSettingName.displayEmojiReactionUsers:
+            newSettings[name] = false;
+            expectedBodyFields['display_emoji_reaction_users'] = 'false';
+          case UserSettingName.emojiset:
+            newSettings[name] = Emojiset.googleBlob;
+            expectedBodyFields['emojiset'] = 'google-blob';
+          case UserSettingName.presenceEnabled:
+            newSettings[name] = true;
+            expectedBodyFields['presence_enabled'] = 'true';
+        }
+      }
+
+      await updateSettings(connection, newSettings: newSettings);
+      check(connection.takeRequests()).single.isA<http.Request>()
+        ..method.equals('PATCH')
+        ..url.path.equals('/api/v1/settings')
+        ..bodyFields.deepEquals(expectedBodyFields);
+    });
+  });
+}