WIP: Notify user when DMing a guest

assets/l10n/app_en.arb

@@ -415,6 +415,21 @@
       "others": {"type": "String", "example": "Alice, Bob"}
     }
   },
+  "guestUserDmWarningOne": "{guestUser} is a guest in this organization.",
+  "@guestUserDmWarningOne": {
+    "description": "Warning shown when composing a DM to one guest user",
+    "placeholders": {
+      "guestUser": {"type": "String", "example": "Alice"}
+    }
+  },
+
+  "guestUserDmWarningMany": "{guestUsers} are guests in this organization.",
+  "@guestUserDmWarningMany": {
+    "description": "Warning shown when composing DMs to multiple guest users",
+    "placeholders": {
+      "guestUsers": {"type": "String", "example": "Alice, Bob, and Charlie"}
+    }
+  },
   "messageListGroupYouWithYourself": "Messages with yourself",
   "@messageListGroupYouWithYourself": {
     "description": "Message list recipient header for a DM group that only includes yourself."

lib/api/model/events.dart

@@ -67,6 +67,11 @@ sealed class Event {
       case 'submessage': return SubmessageEvent.fromJson(json);
       case 'typing': return TypingEvent.fromJson(json);
       case 'reaction': return ReactionEvent.fromJson(json);
+      case 'realm':
+        switch(json['op'] as String){
+          case 'update': return RealmUpdateEvent.fromJson(json);
+          default: return UnexpectedEvent.fromJson(json);
+        }
       case 'heartbeat': return HeartbeatEvent.fromJson(json);
       // TODO add many more event types
       default: return UnexpectedEvent.fromJson(json);
@@ -1151,6 +1156,46 @@ enum ReactionOp {
   remove,
 }
 
+/// A Zulip event of type `realm`, with op `update`.
+///
+/// This is the simpler of two possible event types sent when realm configuration changes.
+/// It updates a single realm setting at a time.
+///
+/// See: https://zulip.com/api/get-events#realm-update
+@JsonSerializable(fieldRename: FieldRename.snake)
+class RealmUpdateEvent extends Event {
+  @override
+  @JsonKey(includeToJson: true)
+  String get type => 'realm';
+
+  @JsonKey(includeToJson: true)
+  String get op => 'update';
+
+  @JsonKey(unknownEnumValue: JsonKey.nullForUndefinedEnumValue)
+  final RealmPropertyName? property;
+
+  final dynamic value;
+
+  RealmUpdateEvent({
+    required super.id,
+    required this.property,
+    required this.value,
+  });
+
+  factory RealmUpdateEvent.fromJson(Map<String, dynamic> json) =>
+    _$RealmUpdateEventFromJson(json);
+
+  @override
+  Map<String, dynamic> toJson() => _$RealmUpdateEventToJson(this);
+}
+
+/// As in [RealmUpdateEvent.property].
+@JsonEnum(fieldRename: FieldRename.snake)
+enum RealmPropertyName {
+  @JsonValue('enable_guest_user_dm_warning')
+  realmEnableGuestUserDmWarning,
+}
+
 /// A Zulip event of type `heartbeat`: https://zulip.com/api/get-events#heartbeat
 @JsonSerializable(fieldRename: FieldRename.snake)
 class HeartbeatEvent extends Event {

lib/api/model/initial_snapshot.dart

@@ -86,6 +86,9 @@ class InitialSnapshot {
 
   final int maxFileUploadSizeMib;
 
+  @JsonKey(defaultValue: false) // TODO(server-10): Remove default
+  final bool realmEnableGuestUserDmWarning;
+
   final Uri? serverEmojiDataUrl; // TODO(server-6)
 
   final String? realmEmptyTopicDisplayName; // TODO(server-10)
@@ -144,6 +147,7 @@ class InitialSnapshot {
     required this.realmMessageContentEditLimitSeconds,
     required this.realmDefaultExternalAccounts,
     required this.maxFileUploadSizeMib,
+    required this.realmEnableGuestUserDmWarning,
     required this.serverEmojiDataUrl,
     required this.realmEmptyTopicDisplayName,
     required this.realmUsers,

lib/generated/l10n/zulip_localizations.dart

@@ -647,6 +647,18 @@ abstract class ZulipLocalizations {
   /// **'DMs with {others}'**
   String dmsWithOthersPageTitle(String others);
 
+  /// Warning shown when composing a DM to one guest user
+  ///
+  /// In en, this message translates to:
+  /// **'{guestUser} is a guest in this organization.'**
+  String guestUserDmWarningOne(String guestUser);
+
+  /// Warning shown when composing DMs to multiple guest users
+  ///
+  /// In en, this message translates to:
+  /// **'{guestUsers} are guests in this organization.'**
+  String guestUserDmWarningMany(String guestUsers);
+
   /// Message list recipient header for a DM group that only includes yourself.
   ///
   /// In en, this message translates to:

lib/generated/l10n/zulip_localizations_ar.dart

@@ -324,6 +324,16 @@ class ZulipLocalizationsAr extends ZulipLocalizations {
     return 'DMs with $others';
   }
 
+  @override
+  String guestUserDmWarningOne(String guestUser) {
+    return '$guestUser is a guest in this organization.';
+  }
+
+  @override
+  String guestUserDmWarningMany(String guestUsers) {
+    return '$guestUsers are guests in this organization.';
+  }
+
   @override
   String get messageListGroupYouWithYourself => 'Messages with yourself';
 

lib/generated/l10n/zulip_localizations_en.dart

@@ -324,6 +324,16 @@ class ZulipLocalizationsEn extends ZulipLocalizations {
     return 'DMs with $others';
   }
 
+  @override
+  String guestUserDmWarningOne(String guestUser) {
+    return '$guestUser is a guest in this organization.';
+  }
+
+  @override
+  String guestUserDmWarningMany(String guestUsers) {
+    return '$guestUsers are guests in this organization.';
+  }
+
   @override
   String get messageListGroupYouWithYourself => 'Messages with yourself';
 

lib/generated/l10n/zulip_localizations_ja.dart

@@ -324,6 +324,16 @@ class ZulipLocalizationsJa extends ZulipLocalizations {
     return 'DMs with $others';
   }
 
+  @override
+  String guestUserDmWarningOne(String guestUser) {
+    return '$guestUser is a guest in this organization.';
+  }
+
+  @override
+  String guestUserDmWarningMany(String guestUsers) {
+    return '$guestUsers are guests in this organization.';
+  }
+
   @override
   String get messageListGroupYouWithYourself => 'Messages with yourself';
 

lib/generated/l10n/zulip_localizations_nb.dart

@@ -324,6 +324,16 @@ class ZulipLocalizationsNb extends ZulipLocalizations {
     return 'DMs with $others';
   }
 
+  @override
+  String guestUserDmWarningOne(String guestUser) {
+    return '$guestUser is a guest in this organization.';
+  }
+
+  @override
+  String guestUserDmWarningMany(String guestUsers) {
+    return '$guestUsers are guests in this organization.';
+  }
+
   @override
   String get messageListGroupYouWithYourself => 'Messages with yourself';
 

lib/generated/l10n/zulip_localizations_pl.dart

@@ -324,6 +324,16 @@ class ZulipLocalizationsPl extends ZulipLocalizations {
     return 'DM z $others';
   }
 
+  @override
+  String guestUserDmWarningOne(String guestUser) {
+    return '$guestUser is a guest in this organization.';
+  }
+
+  @override
+  String guestUserDmWarningMany(String guestUsers) {
+    return '$guestUsers are guests in this organization.';
+  }
+
   @override
   String get messageListGroupYouWithYourself => 'Zapiski na własne konto';
 

lib/generated/l10n/zulip_localizations_ru.dart

@@ -324,6 +324,16 @@ class ZulipLocalizationsRu extends ZulipLocalizations {
     return 'ЛС с $others';
   }
 
+  @override
+  String guestUserDmWarningOne(String guestUser) {
+    return '$guestUser is a guest in this organization.';
+  }
+
+  @override
+  String guestUserDmWarningMany(String guestUsers) {
+    return '$guestUsers are guests in this organization.';
+  }
+
   @override
   String get messageListGroupYouWithYourself => 'Сообщения с собой';
 

lib/generated/l10n/zulip_localizations_sk.dart

@@ -324,6 +324,16 @@ class ZulipLocalizationsSk extends ZulipLocalizations {
     return 'DMs with $others';
   }
 
+  @override
+  String guestUserDmWarningOne(String guestUser) {
+    return '$guestUser is a guest in this organization.';
+  }
+
+  @override
+  String guestUserDmWarningMany(String guestUsers) {
+    return '$guestUsers are guests in this organization.';
+  }
+
   @override
   String get messageListGroupYouWithYourself => 'Messages with yourself';