store: Implement selfCanDeleteMessage

Author: chrisbobbe

lib/model/store.dart

@@ -673,6 +673,128 @@ class PerAccountStore extends PerAccountStoreBase with
 
   final AutocompleteViewManager autocompleteViewManager = AutocompleteViewManager();
 
+  /// Whether the user has permission to delete the message, as of [byDate].
+  ///
+  /// For a value of [byDate], use [ZulipBinding.instance.utcNow].
+  // There might be a better place for this to live…but it uses
+  // message, channel, self-user, and user-group data, so seemed simplest to
+  // put it here where all that is available.
+  bool selfCanDeleteMessage(int messageId, {required DateTime byDate}) {
+    // Compare web's message_delete.get_deletability.
+
+    final message = messages[messageId];
+    if (message == null) return false; // TODO(log)
+
+    final ZulipStream? channel;
+    if (message is StreamMessage) {
+      channel = streams[message.streamId];
+      // TODO(log) if channel null here?
+    } else {
+      channel = null;
+    }
+
+    if (channel != null && channel.isArchived == true) {
+      return false;
+    }
+
+    if (realmCanDeleteAnyMessageGroup != null
+        && selfHasPermissionForGroupSetting(realmCanDeleteAnyMessageGroup!,
+             GroupSettingType.realm, 'can_delete_any_message_group')) {
+      // realmCanDeleteAnyMessageGroup always present as of FL 281.
+      // TODO(server-10) make required, simplify, delete this FL-281 comment
+      return true;
+    }
+
+    if (channel != null) {
+      if (channel.canDeleteAnyMessageGroup != null
+          && selfHasPermissionForGroupSetting(channel.canDeleteAnyMessageGroup!,
+               GroupSettingType.stream, 'can_delete_any_message_group')) {
+        // channel.canDeleteAnyMessageGroup always present as of FL 407.
+        // TODO(server-11) make required, simplify, delete this FL-407 comment
+        return true;
+      }
+    }
+
+    final sender = getUser(message.senderId);
+    if (sender == null) return false;
+
+    if (
+      sender.userId != selfUserId
+      && !(sender.isBot && sender.botOwnerId == selfUserId)
+    ) {
+      return false;
+    }
+
+    // Web returns false here for local-echoed message objects;
+    // that's impossible here because `message` can't be an [OutboxMessage]
+    // (it's a [Message] from [MessageStore.messages]).
+
+    if (realmCanDeleteOwnMessageGroup != null) {
+      // realmCanDeleteOwnMessageGroup always present as of FL 291.
+      // TODO(server-10) make required, simplify, delete this FL-291 comment
+      if (!selfHasPermissionForGroupSetting(realmCanDeleteOwnMessageGroup!,
+            GroupSettingType.realm, 'can_delete_own_message_group')) {
+        if (channel == null) {
+          // i.e. this is a DM
+          return false;
+        }
+
+        if (
+          channel.canDeleteOwnMessageGroup == null
+          || !selfHasPermissionForGroupSetting(channel.canDeleteOwnMessageGroup!,
+               GroupSettingType.stream, 'can_delete_own_message_group')
+        ) {
+          // channel.canDeleteOwnMessageGroup always present as of FL 407.
+          // TODO(server-11) make required, simplify, delete this FL-407 comment
+          return false;
+        }
+      }
+    }
+
+    if (
+      realmDeleteOwnMessagePolicy != null
+      && !_selfPassesLegacyDeleteMessagePolicy(messageId, byDate: byDate)
+    ) {
+      // realmDeleteOwnMessagePolicy is removed in FL 291
+      // TODO(server-10) remove that, simplify, delete this FL-291 comment
+      return false;
+    }
+
+    if (realmMessageContentDeleteLimitSeconds == null) {
+      // i.e., no limit
+      return true;
+    }
+
+    return byDate.millisecondsSinceEpoch ~/ 1000 - message.timestamp
+      <= realmMessageContentDeleteLimitSeconds!;
+  }
+
+  bool _selfPassesLegacyDeleteMessagePolicy(int messageId, {required DateTime byDate}) {
+    assert(realmDeleteOwnMessagePolicy != null);
+    final role = selfUser.role;
+
+    // (Could early-return true on [UserRole.unknown],
+    // but pre-291 servers shouldn't be giving us an unknown role.)
+
+    switch (realmDeleteOwnMessagePolicy!) {
+      case RealmDeleteOwnMessagePolicy.members:
+        return true;
+      case RealmDeleteOwnMessagePolicy.admins:
+        return role.isAtLeast(UserRole.administrator);
+      case RealmDeleteOwnMessagePolicy.fullMembers: {
+        if (!role.isAtLeast(UserRole.member)) return false;
+        if (role == UserRole.member) {
+          return hasPassedWaitingPeriod(selfUser, byDate: byDate);
+        }
+        return true;
+      }
+      case RealmDeleteOwnMessagePolicy.moderators:
+        return role.isAtLeast(UserRole.moderator);
+      case RealmDeleteOwnMessagePolicy.everyone:
+        return true;
+    }
+  }
+
   // End of data.
   //|//////////////////////////////////////////////////////////////
 

test/example_data.dart

@@ -271,6 +271,7 @@ User user({
   String? dateJoined,
   bool? isActive,
   bool? isBot,
+  int? botOwnerId,
   UserRole? role,
   String? avatarUrl,
   Map<int, ProfileFieldUserData>? profileData,
@@ -286,7 +287,7 @@ User user({
     isActive: isActive ?? true,
     isBot: isBot ?? false,
     botType: null,
-    botOwnerId: null,
+    botOwnerId: botOwnerId,
     role: role ?? UserRole.member,
     timezone: 'UTC',
     avatarUrl: avatarUrl,