nodebb-plugin-admin-chats 3.5.1 → 3.6.0

package/lib/history.js

@@ -1,6 +1,5 @@
 'use strict';
 
-const validator = nodebb.require('validator');
 const Messaging = nodebb.require('./src/messaging');
 const User = nodebb.require('./src/user');
 const db = nodebb.require('./src/database');
@@ -59,6 +58,10 @@ async function getMessageEditHistory(mid) {
         };
     };
 
+    // The author of the current version is whoever performed the most recent
+    // edit (the newest revision's editor); with no revisions it's the sender.
+    const lastRevision = revisions[revisions.length - 1];
+
     return {
         mid,
         exists: !!exists,
@@ -69,6 +72,7 @@ async function getMessageEditHistory(mid) {
             edited: parseInt(current && current.edited, 10) || 0,
             timestamp: parseInt(current && current.timestamp, 10) || 0,
             deleted: parseInt(current && current.deleted, 10) === 1,
+            editor: decorate(lastRevision ? lastRevision.editedByUid : authorUid),
         },
         revisionCount: revisions.length,
         revisions: revisions.map(rev => ({
@@ -80,65 +84,27 @@ async function getMessageEditHistory(mid) {
     };
 }
 
-function renderMessageHistoryHtml(history) {
-    const esc = value => validator.escape(String(value == null ? '' : value));
-    const fmt = (ts) => {
-        const numeric = parseInt(ts, 10) || 0;
-        return numeric ? new Date(numeric).toISOString().replace('T', ' ').replace(/\..+$/, ' UTC') : '—';
-    };
+async function deleteRevision(mid, index) {
+    const key = editHistoryKey(mid);
+    const items = await db.getListRange(key, 0, -1);
+    const numericIndex = parseInt(index, 10);
 
-    if (!history.exists) {
-        return `<!doctype html><html lang="he" dir="rtl"><meta charset="utf-8"><title>היסטוריית עריכות</title><body style="font-family:system-ui,Arial,sans-serif;padding:2rem;">
-            <h1>הודעה ${esc(history.mid)} לא נמצאה</h1></body></html>`;
+    if (!Array.isArray(items) || Number.isNaN(numericIndex) || numericIndex < 0 || numericIndex >= items.length) {
+        return false;
     }
 
-    const timeline = history.revisions.map((rev, index) => `
-        <li class="rev">
-            <div class="meta">גרסה ${index + 1} · הוחלפה ב-${esc(fmt(rev.replacedAt))} · עורך: ${esc(rev.editor.username)}</div>
-            <pre class="content">${esc(rev.content)}</pre>
-        </li>`).join('');
-
-    const currentBlock = `
-        <li class="rev current">
-            <div class="meta">גרסה נוכחית${history.current.edited ? ` · נערכה לאחרונה ${esc(fmt(history.current.edited))}` : ''}${history.current.deleted ? ' · מחוקה' : ''}</div>
-            <pre class="content">${esc(history.current.content)}</pre>
-        </li>`;
-
-    return `<!doctype html>
-<html lang="he" dir="rtl">
-<head>
-<meta charset="utf-8">
-<meta name="robots" content="noindex,nofollow">
-<title>היסטוריית עריכות · הודעה ${esc(history.mid)}</title>
-<style>
-    body { font-family: system-ui, Segoe UI, Arial, sans-serif; margin: 0; padding: 2rem; background: #f5f6f8; color: #1c1e21; }
-    h1 { font-size: 1.25rem; margin: 0 0 .25rem; }
-    .sub { color: #65676b; font-size: .875rem; margin-bottom: 1.5rem; }
-    ul { list-style: none; margin: 0; padding: 0; max-width: 780px; }
-    .rev { background: #fff; border: 1px solid #dcdfe3; border-radius: 8px; padding: .75rem 1rem; margin-bottom: 1rem; }
-    .rev.current { border-color: #2d6cdf; box-shadow: 0 0 0 1px #2d6cdf33; }
-    .meta { font-size: .8rem; color: #65676b; margin-bottom: .5rem; }
-    .content { white-space: pre-wrap; word-break: break-word; margin: 0; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: .9rem; }
-    @media (prefers-color-scheme: dark) {
-        body { background: #18191a; color: #e4e6eb; }
-        .rev { background: #242526; border-color: #3a3b3c; }
-        .meta, .sub { color: #b0b3b8; }
+    items.splice(numericIndex, 1);
+    await db.delete(key);
+    for (const item of items) {
+        // eslint-disable-next-line no-await-in-loop
+        await db.listAppend(key, item);
     }
-</style>
-</head>
-<body>
-    <h1>היסטוריית עריכות · הודעה ${esc(history.mid)}</h1>
-    <div class="sub">מחבר: ${esc(history.author.username)} · חדר: ${esc(history.roomId)} · ${esc(history.revisionCount)} עריכות קודמות</div>
-    <ul>
-        ${history.revisionCount ? timeline : '<li class="rev"><div class="meta">אין עריכות קודמות מתועדות</div></li>'}
-        ${currentBlock}
-    </ul>
-</body>
-</html>`;
+
+    return true;
 }
 
 module.exports = {
     editHistoryKey,
     getMessageEditHistory,
-    renderMessageHistoryHtml,
+    deleteRevision,
 };

package/lib/routes.js

@@ -6,11 +6,10 @@ const db = nodebb.require('./src/database');
 const meta = nodebb.require('./src/meta');
 const privileges = nodebb.require('./src/privileges');
 const helpers = nodebb.require('./src/controllers/helpers');
-const validator = nodebb.require('validator');
 const sockets = nodebb.require('./src/socket.io');
 
 const { canAccessAdminChats, canManageAdminChats } = require('./access');
-const { getMessageEditHistory, renderMessageHistoryHtml } = require('./history');
+const { getMessageEditHistory, deleteRevision } = require('./history');
 const { roomExists, lockRoom, unlockRoom, getRoomLockData } = require('./lock');
 
 const ADMIN_CHAT_PAGE_SIZE = 30;
@@ -374,19 +373,17 @@ function registerRoutes(app, router, middleware) {
         }
     });
 
-    // --- Hidden chat edit-history viewer ---------------------------------
-    // These two routes are intentionally NOT referenced from any template,
-    // client script, menu or API payload. They do not appear in the admin
-    // chats UI, so a "regular" administrator who has not read this source
-    // will never encounter them. They are still protected by
-    // assertAdminChatsAccess(), so only privileged accounts can read data
-    // even if the URL is discovered. Paths:
-    //   GET /api/admin-chats/history/:mid   -> JSON
-    //   GET /admin-chats/history/:mid       -> standalone HTML page
+    // --- Chat edit-history (message options menu) -------------------------
+    // Surfaced as an "Edit history" item in each message's options dropdown
+    // (templates/partials/chats/message.tpl + static/lib/message-history.js),
+    // mirroring core's post diffs modal. Both routes require the manage
+    // privilege — view-only admin-chats access is not enough.
+    //   GET    /api/admin-chats/history/:mid          -> JSON
+    //   DELETE /api/admin-chats/history/:mid/:index   -> delete one revision
     router.get('/api/admin-chats/history/:mid', ...routeMiddleware, async (req, res) => {
         try {
-            if (!await assertAdminChatsAccess(req, res)) {
-                return;
+            if (!req.uid || !await canManageAdminChats(req.uid)) {
+                return res.status(403).json({ status: { code: 'forbidden', message: 'Manage privilege required' } });
             }
 
             const mid = parseInt(req.params.mid, 10);
@@ -401,21 +398,61 @@ function registerRoutes(app, router, middleware) {
         }
     });
 
-    router.get('/admin-chats/history/:mid', ...routeMiddleware, async (req, res) => {
+    // Restore a revision — like core post diffs (src/posts/diffs.js Diffs.restore),
+    // restoring is just an edit that sets the message content back to the
+    // revision's content. Going through Messaging.editMessage means the
+    // replaced current version is snapshotted into history (lib/overrides.js)
+    // and open chat windows update live via core's edit broadcast.
+    router.put('/api/admin-chats/history/:mid/:index', ...routeMiddleware, async (req, res) => {
         try {
-            if (!await assertAdminChatsAccess(req, res)) {
-                return;
+            if (!req.uid || !await canManageAdminChats(req.uid)) {
+                return res.status(403).json({ status: { code: 'forbidden', message: 'Manage privilege required' } });
             }
 
             const mid = parseInt(req.params.mid, 10);
-            if (Number.isNaN(mid)) {
-                return res.status(400).type('html').send('<h1>400</h1><p>Invalid message id</p>');
+            const index = parseInt(req.params.index, 10);
+            if (Number.isNaN(mid) || Number.isNaN(index) || index < 0) {
+                return res.status(400).json({ status: { code: 'bad-request', message: 'Invalid message id or revision index' } });
+            }
+
+            const history = await getMessageEditHistory(mid);
+            if (!history.exists) {
+                return res.status(404).json({ status: { code: 'not-found', message: 'Message not found' } });
+            }
+            if (index >= history.revisions.length) {
+                return res.status(404).json({ status: { code: 'not-found', message: 'Revision not found' } });
+            }
+
+            await Messaging.editMessage(req.uid, mid, history.roomId, history.revisions[index].content);
+
+            const fresh = await getMessageEditHistory(mid);
+            return res.json({ status: { code: 'ok', message: 'Revision restored' }, ...fresh });
+        } catch (err) {
+            return res.status(500).json({ status: { code: 'error', message: err.message } });
+        }
+    });
+
+    router.delete('/api/admin-chats/history/:mid/:index', ...routeMiddleware, async (req, res) => {
+        try {
+            if (!req.uid || !await canManageAdminChats(req.uid)) {
+                return res.status(403).json({ status: { code: 'forbidden', message: 'Manage privilege required' } });
+            }
+
+            const mid = parseInt(req.params.mid, 10);
+            const index = parseInt(req.params.index, 10);
+            if (Number.isNaN(mid) || Number.isNaN(index) || index < 0) {
+                return res.status(400).json({ status: { code: 'bad-request', message: 'Invalid message id or revision index' } });
+            }
+
+            const deleted = await deleteRevision(mid, index);
+            if (!deleted) {
+                return res.status(404).json({ status: { code: 'not-found', message: 'Revision not found' } });
             }
 
             const history = await getMessageEditHistory(mid);
-            return res.type('html').send(renderMessageHistoryHtml(history));
+            return res.json({ status: { code: 'ok', message: 'Revision deleted' }, ...history });
         } catch (err) {
-            return res.status(500).type('html').send(`<h1>500</h1><pre>${validator.escape(String(err.message))}</pre>`);
+            return res.status(500).json({ status: { code: 'error', message: err.message } });
         }
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodebb-plugin-admin-chats",
-  "version": "3.5.1",
+  "version": "3.6.0",
   "description": "A plugin that allows the administrator to view and manage user chats.",
   "main": "library.js",
   "nbbpm": {

package/plugin.json

@@ -9,7 +9,8 @@
     "static/lib/switch-chat.js",
     "static/lib/lock-toggle.js",
     "static/lib/live-updates.js",
-    "static/lib/profile-link.js"
+    "static/lib/profile-link.js",
+    "static/lib/message-history.js"
   ],
   "hooks": [
     {

package/public/languages/ar/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "لا يمكن تنفيذ هذا الإجراء في غرفة مقفلة.",
   "admin-chats-view": "عرض جميع الدردشات",
   "admin-chats-manage": "إدارة غرف الدردشة",
-  "participants": "المشاركون"
+  "participants": "المشاركون",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/de/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Diese Aktion kann in einem gesperrten Raum nicht ausgeführt werden.",
   "admin-chats-view": "Alle Chats ansehen",
   "admin-chats-manage": "Chat-Räume verwalten",
-  "participants": "Teilnehmer"
+  "participants": "Teilnehmer",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/de-CH/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Diese Aktion kann in einem gesperrten Raum nicht ausgeführt werden.",
   "admin-chats-view": "Alle Chats ansehen",
   "admin-chats-manage": "Chat-Räume verwalten",
-  "participants": "Teilnehmer"
+  "participants": "Teilnehmer",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/el/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Αυτή η ενέργεια δεν μπορεί να εκτελεστεί σε κλειδωμένο δωμάτιο.",
   "admin-chats-view": "Προβολή όλων των συνομιλιών",
   "admin-chats-manage": "Διαχείριση δωματίων συνομιλίας",
-  "participants": "Συμμετέχοντες"
+  "participants": "Συμμετέχοντες",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/en/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "This action cannot be performed in a locked room.",
   "admin-chats-view": "View all chats",
   "admin-chats-manage": "Manage chat rooms",
-  "participants": "Participants"
+  "participants": "Participants",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/en-GB/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "This action cannot be performed in a locked room.",
   "admin-chats-view": "View all chats",
   "admin-chats-manage": "Manage chat rooms",
-  "participants": "Participants"
+  "participants": "Participants",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/es/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Esta acción no se puede realizar en una sala bloqueada.",
   "admin-chats-view": "Ver todos los chats",
   "admin-chats-manage": "Administrar salas de chat",
-  "participants": "Participantes"
+  "participants": "Participantes",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/fr/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Cette action ne peut pas être effectuée dans un salon verrouillé.",
   "admin-chats-view": "Voir tous les Chats",
   "admin-chats-manage": "Gérer les salons de discussion",
-  "participants": "Participants"
+  "participants": "Participants",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/fr-CH/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Cette action ne peut pas être effectuée dans une salle verrouillée.",
   "admin-chats-view": "Voir toutes les discussions",
   "admin-chats-manage": "Gérer les salons de discussion",
-  "participants": "Participants"
+  "participants": "Participants",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/he/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "לא ניתן לבצע פעולה זו בחדר נעול",
   "admin-chats-view": "צפיה בכל הצ'אטים",
   "admin-chats-manage": "ניהול חדרי צ'אט",
-  "participants": "משתתפים"
+  "participants": "משתתפים",
+  "history.title": "היסטוריית עריכות",
+  "history.current": "גרסה נוכחית",
+  "history.revisionCount": "%1 עריכות קודמות",
+  "history.deleteRevision": "מחיקת גרסה",
+  "history.confirmDelete": "האם למחוק גרסה זו לצמיתות?",
+  "history.deleted": "הגרסה נמחקה",
+  "errors.history": "לא ניתן לטעון או לעדכן את היסטוריית העריכות.",
+  "history.restore": "שחזור גרסה",
+  "history.restored": "ההודעה שוחזרה לגרסה שנבחרה",
+  "history.restoreDescription": "שחזור יציב את תוכן הגרסה שנבחרה כגרסה הנוכחית; הגרסה שהוחלפה תישמר בהיסטוריה."
 }

package/public/languages/hi/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "लॉक किए गए कमरे में यह कार्रवाई नहीं की जा सकती।",
   "admin-chats-view": "सभी चैट देखें",
   "admin-chats-manage": "चैट रूम प्रबंधित करें",
-  "participants": "प्रतिभागी"
+  "participants": "प्रतिभागी",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/it/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Questa azione non può essere eseguita in una stanza bloccata.",
   "admin-chats-view": "Visualizza tutte le chat",
   "admin-chats-manage": "Gestisci le stanze di chat",
-  "participants": "Partecipanti"
+  "participants": "Partecipanti",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/it-CH/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Questa azione non può essere eseguita in una stanza bloccata.",
   "admin-chats-view": "Visualizza tutte le chat",
   "admin-chats-manage": "Gestisci le stanze di chat",
-  "participants": "Partecipanti"
+  "participants": "Partecipanti",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/ja/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "ロックされたルームではこの操作は実行できません。",
   "admin-chats-view": "すべてのチャットを見る",
   "admin-chats-manage": "チャットルームを管理",
-  "participants": "参加者"
+  "participants": "参加者",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/nl/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Deze actie kan niet worden uitgevoerd in een vergrendelde chatruimte.",
   "admin-chats-view": "Alle chats bekijken",
   "admin-chats-manage": "Chatruimtes beheren",
-  "participants": "Deelnemers"
+  "participants": "Deelnemers",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/pl/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Tej czynności nie można wykonać w zablokowanym pokoju.",
   "admin-chats-view": "Wyświetl wszystkie czaty",
   "admin-chats-manage": "Zarządzaj pokojami czatu",
-  "participants": "Uczestnicy"
+  "participants": "Uczestnicy",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/pt-BR/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Esta ação não pode ser realizada em uma sala bloqueada.",
   "admin-chats-view": "Ver todos os chats",
   "admin-chats-manage": "Gerenciar salas de chat",
-  "participants": "Participantes"
+  "participants": "Participantes",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/rm-CH/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Questa acziun na po betg vegnir fatga en in local bloccà.",
   "admin-chats-view": "Veser tut ils chats",
   "admin-chats-manage": "Administrar locals da chat",
-  "participants": "Participonts"
+  "participants": "Participonts",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/ru/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Это действие нельзя выполнить в заблокированной комнате.",
   "admin-chats-view": "Просмотреть все чаты",
   "admin-chats-manage": "Управлять чат-комнатами",
-  "participants": "Участники"
+  "participants": "Участники",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/uk/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "Цю дію не можна виконати в блокованій кімнаті.",
   "admin-chats-view": "Переглянути всі чати",
   "admin-chats-manage": "Керувати чат-кімнатами",
-  "participants": "Учасники"
+  "participants": "Учасники",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/zh-CN/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "锁定的聊天室无法执行此操作。",
   "admin-chats-view": "查看所有聊天",
   "admin-chats-manage": "管理聊天室",
-  "participants": "参与者"
+  "participants": "参与者",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/public/languages/zh-TW/admin-chats.json

@@ -8,5 +8,15 @@
   "errors.lockedAction": "鎖定的聊天室無法執行此操作。",
   "admin-chats-view": "查看所有聊天",
   "admin-chats-manage": "管理聊天室",
-  "participants": "參與者"
+  "participants": "參與者",
+  "history.title": "Edit History",
+  "history.current": "Current version",
+  "history.revisionCount": "%1 previous edits",
+  "history.deleteRevision": "Delete version",
+  "history.confirmDelete": "Permanently delete this version?",
+  "history.deleted": "Version deleted",
+  "errors.history": "Unable to load or update the edit history.",
+  "history.restore": "Restore version",
+  "history.restored": "Message restored to the selected version",
+  "history.restoreDescription": "Restoring sets the selected version as the current one; the replaced version is kept in the history."
 }

package/static/lib/message-history.js

@@ -0,0 +1,221 @@
+'use strict';
+
+// "Edit history" item in the chat message options dropdown (rendered
+// server-side in templates/partials/chats/message.tpl, gated on manage
+// privilege via isAdminOrGlobalMod). Opens a modal modelled on core's post
+// diffs modal (public/src/client/topic/diffs.js): a revision selector, the
+// selected revision's content, and a delete-revision button. The API routes
+// it calls are manage-only as well, so the client gating is cosmetic.
+$(document).ready(function () {
+    const localeStringOpts = { year: 'numeric', month: 'short', day: 'numeric', hour: 'numeric', minute: 'numeric' };
+
+    function prettyDate(timestamp) {
+        const numeric = parseInt(timestamp, 10) || 0;
+        if (!numeric) {
+            return '—';
+        }
+        return new Date(numeric).toLocaleString((config.userLang || 'en-GB').replace('_', '-'), localeStringOpts);
+    }
+
+    async function requestHistory(mid, method, revisionIndex) {
+        const suffix = (method === 'DELETE' || method === 'PUT') ? `/${revisionIndex}` : '';
+        const response = await fetch(`${config.relative_path || ''}/api/admin-chats/history/${mid}${suffix}`, {
+            method: method || 'GET',
+            headers: { 'x-csrf-token': config.csrf_token },
+            credentials: 'same-origin',
+        });
+
+        const data = await response.json();
+        if (!response.ok) {
+            throw new Error((data && data.status && data.status.message) || 'Request failed');
+        }
+
+        return data;
+    }
+
+    // The selector lists the current version first, then prior revisions
+    // newest-first. Option values keep the revision's index in the stored
+    // (oldest-first) list so deletes address the right entry.
+    function buildEntries(history, labels) {
+        const currentEditor = (history.current.editor && history.current.editor.username) ||
+            (history.author && history.author.username) || '';
+        const entries = [{
+            value: 'current',
+            label: `${prettyDate(history.current.edited || history.current.timestamp)} [${currentEditor}] · ${labels.current}`,
+            content: history.current.content,
+        }];
+
+        history.revisions.forEach((revision, index) => {
+            entries.push({
+                value: String(index),
+                label: `${prettyDate(revision.replacedAt)} [${revision.editor.username}]`,
+                content: revision.content,
+            });
+        });
+
+        return [entries[0]].concat(entries.slice(1).reverse());
+    }
+
+    function renderState($modal, history, labels) {
+        const $select = $modal.find('select');
+        const $content = $modal.find('.admin-chat-history-content');
+        const $deleteBtn = $modal.find('[data-action="delete-revision"]');
+        const $restoreBtn = $modal.find('[data-action="restore-revision"]');
+        const $count = $modal.find('.admin-chat-history-count');
+
+        const entries = buildEntries(history, labels);
+        const contentByValue = new Map(entries.map(entry => [entry.value, entry.content]));
+
+        $select.empty();
+        entries.forEach((entry) => {
+            const option = document.createElement('option');
+            option.value = entry.value;
+            option.textContent = entry.label;
+            $select.append(option);
+        });
+
+        $count.text(labels.count.replace('%1', String(history.revisionCount)));
+
+        const showSelection = () => {
+            const value = $select.val();
+            $content.text(contentByValue.get(value) || '');
+            $deleteBtn.prop('disabled', value === 'current');
+            $restoreBtn.prop('disabled', value === 'current');
+        };
+
+        $select.off('change').on('change', showSelection);
+        showSelection();
+    }
+
+    async function openHistoryModal(mid, modals, alerts, translator) {
+        const history = await requestHistory(mid);
+
+        const labels = {
+            current: await translator.translate('[[admin-chats:history.current]]'),
+            count: await translator.translate('[[admin-chats:history.revisionCount, %1]]'),
+        };
+
+        // modals.dialog runs the message through the translator itself
+        const $modal = await modals.dialog({
+            title: '[[admin-chats:history.title]]',
+            message: '<p class="admin-chat-history-count text-muted"></p>' +
+                '<div class="mb-3">' +
+                '<select class="form-control"></select>' +
+                '<hr />' +
+                '<pre class="admin-chat-history-content text-break mb-3" style="white-space: pre-wrap;"></pre>' +
+                '<button class="btn btn-primary" data-action="restore-revision">[[admin-chats:history.restore]]</button> ' +
+                '<button class="btn btn-danger" data-action="delete-revision">[[admin-chats:history.deleteRevision]]</button>' +
+                '<p class="form-text">[[admin-chats:history.restoreDescription]]</p>' +
+                '</div>',
+            size: 'large',
+            onEscape: true,
+            backdrop: true,
+        });
+
+        renderState($modal, history, labels);
+
+        $modal.find('[data-action="restore-revision"]').on('click', async function () {
+            const value = $modal.find('select').val();
+            if (value === 'current') {
+                return;
+            }
+
+            try {
+                await requestHistory(mid, 'PUT', value);
+                $modal.modal('hide');
+                alerts.success('[[admin-chats:history.restored]]');
+            } catch (err) {
+                alerts.error('[[admin-chats:errors.history]]');
+            }
+        });
+
+        $modal.find('[data-action="delete-revision"]').on('click', function () {
+            const value = $modal.find('select').val();
+            if (value === 'current') {
+                return;
+            }
+
+            modals.confirm('[[admin-chats:history.confirmDelete]]', async (confirmed) => {
+                if (!confirmed) {
+                    return;
+                }
+
+                try {
+                    const fresh = await requestHistory(mid, 'DELETE', value);
+                    renderState($modal, fresh, labels);
+                    alerts.success('[[admin-chats:history.deleted]]');
+                } catch (err) {
+                    alerts.error('[[admin-chats:errors.history]]');
+                }
+            });
+        });
+    }
+
+    // Messages rendered live on the client (incoming messages, and a message
+    // re-parsed right after an edit) go through core's parseMessage, which
+    // sets isAdminOrGlobalMod = app.user.isAdmin || app.user.isGlobalMod —
+    // ignoring the plugin's manage privilege that gates the server-rendered
+    // item. Re-add the item on dropdown open when the room payload grants
+    // management and the item is missing.
+    $(document).on('show.bs.dropdown', '[component="chat/message"] .btn-group', function () {
+        if (!ajaxify.data || !ajaxify.data.isAdminOrGlobalMod) {
+            return;
+        }
+
+        const $menu = $(this).find('.dropdown-menu');
+        if (!$menu.length || $menu.find('.admin-chat-history-item').length) {
+            return;
+        }
+
+        const $message = $(this).closest('[component="chat/message"]');
+        const mid = parseInt($message.attr('data-mid'), 10);
+        if (!mid) {
+            return;
+        }
+
+        // Same gate as the server-rendered item: only edited messages have a
+        // history to show. The edited indicator element exists on every
+        // message and carries `hidden` while the message is unedited.
+        const $edited = $message.find('[component="chat/message/edited"]');
+        if (!$edited.length || $edited.hasClass('hidden')) {
+            return;
+        }
+
+        require(['translator'], function (translator) {
+            translator.translate('[[admin-chats:history.title]]', function (title) {
+                if ($menu.find('.admin-chat-history-item').length) {
+                    return;
+                }
+
+                const $item = $(
+                    '<li><a href="#" class="dropdown-item rounded-1 admin-chat-history-item" role="menuitem">' +
+                    '<span class="d-inline-flex align-items-center gap-2"><i class="fa fa-fw fa-history text-muted"></i> </span></a></li>'
+                );
+                $item.find('a').attr('data-mid', String(mid));
+                $item.find('span').append(document.createTextNode(title));
+
+                const $copyText = $menu.find('[data-action="copy-text"]').closest('li');
+                if ($copyText.length) {
+                    $item.insertBefore($copyText);
+                } else {
+                    $menu.append($item);
+                }
+            });
+        });
+    });
+
+    $(document).on('click', '.admin-chat-history-item', function (ev) {
+        ev.preventDefault();
+
+        const mid = parseInt($(this).attr('data-mid'), 10);
+        if (!mid) {
+            return;
+        }
+
+        require(['modals', 'alerts', 'translator'], function (modals, alerts, translator) {
+            openHistoryModal(mid, modals, alerts, translator).catch(() => {
+                alerts.error('[[admin-chats:errors.history]]');
+            });
+        });
+    });
+});

package/templates/partials/chats/message.tpl

@@ -55,6 +55,11 @@
 						{{{ end }}}
 
 						{{{ if isAdminOrGlobalMod }}}
+						{{{ if messages.edited }}}
+						<li>
+							<a href="#" class="dropdown-item rounded-1 admin-chat-history-item" data-mid="{messages.messageId}" role="menuitem"><span class="d-inline-flex align-items-center gap-2"><i class="fa fa-fw fa-history text-muted"></i> {{tx("admin-chats:history.title")}}</span></a>
+						</li>
+						{{{ end }}}
 						<li>
 							<a href="#" class="dropdown-item rounded-1 chat-ip-button" role="menuitem">
 								<span class="d-inline-flex align-items-center gap-2 show"><i class="fa fa-fw fa-info-circle text-muted"></i> {{tx("modules:chat.show-ip")}}</span>