Add /rooms/all/<SessionID:sid> for server-wide message deletion.

This causes all messages by the given Session id to be deleted from the
server. The deleting user must be a global moderator on the server.

This facility is needed to allow a server-wide 'Ban and Delete' feature
for Session moderators and admins.

Author: ianmacd

sogs/routes/rooms.py

@@ -960,3 +960,33 @@ def delete_all_posts(room, sid):
     if not deleted:
         abort(http.NOT_FOUND)
     return jsonify({})
+
+
+@rooms.delete("/rooms/all/<SessionID:sid>")
+def delete_user_posts_from_all_rooms(sid):
+    """
+    Deletes all posts from all rooms by a given user.
+
+    # URL Parameters
+
+    - `sid` — the session id of the user to ban
+
+    # Return value
+
+    A JSON dict with the keys:
+
+    - `total` — The total number of posts deleted across all rooms.
+    - `rooms` — A dict of room tokens and their deletion counts.
+    """
+    deletions = {}
+    total = 0
+    user = muser.User(session_id=sid, autovivify=False)
+    for room in mroom.get_accessible_rooms(g.user):
+        try:
+            count, _ = room.delete_all_posts(user, deleter=g.user)
+            total += count
+            deletions[room.token] = count
+        except exc.BadPermission:
+            pass
+
+    return jsonify({"total": total, "rooms": deletions})

sogs/routes/users.py

@@ -293,7 +293,7 @@ def ban_user(sid):
 
     The user's messages are not deleted by this request.  In order to ban and delete all messages
     use the [`/sequence`](#post-sequence) endpoint to bundle a `/user/.../ban` with a
-    [`/user/.../deleteMessages`](#post-usersiddeleteMessages) request.
+    [`/rooms/all/...`](#delete-roomsallsid) request.
 
     # Return value