470 lines
34 KiB
TypeScript
470 lines
34 KiB
TypeScript
// Content moderation (#31, #51): versions of works and the L2 -> L1 -> admin pipeline.
|
|
// A revision holds a work's Divan text, a summary and a status; every step taken on it is an event (who, what,
|
|
// when, comment), which is both the review thread and the moderation log.
|
|
// L2 moderator: drafts and submits -> submitted
|
|
// L1 moderator (grant covering the work): approves, returns (with a comment) or rejects; an L1's own draft
|
|
// goes straight to the admin step -> approved
|
|
// admin: publishes (an admin's own draft publishes directly), returns or rejects
|
|
// Admins are super moderators: they can edit, review and publish any work without grants.
|
|
// Publishing numbers the version, writes it to divan-data as Divan-owned content (owned.ts), commits it there (git.ts)
|
|
// and updates the site.
|
|
// If another version was published after the draft started, publishing is refused until the draft is redone.
|
|
// Arranging a book or section (order.ts, entity 'order') uses the same revisions, steps and publishing; it needs
|
|
// the separate 'arrange' permission. Tagging (tags.ts, entity 'tags-category' / 'tags-work') likewise, with the 'tags'
|
|
// permission. A new e-book's details (ebooks.ts, entity 'ebook') likewise, with the 'ebooks' permission. A poet's details
|
|
// (name, pen name, years, intro) and a book or section's title (details.ts, entities 'poet' and 'book') likewise, with
|
|
// the edit permission on poets or books (#32).
|
|
// GET /api/mod/can?poem= what the reader may do on a work
|
|
// GET /api/mod/queue my drafts, drafts to review, drafts to publish
|
|
// GET /api/mod/work/:id a work's current text and its history
|
|
// POST /api/mod/work/:id/draft start (or reopen) my draft
|
|
// GET /api/mod/revisions/:id a revision, its diff against the version it started from, its events
|
|
// GET /api/mod/order/:id a book/section's current order and its history
|
|
// POST /api/mod/order/:id/draft start (or reopen) my arrangement draft
|
|
// GET /api/mod/tags/:kind/:id a book/section's (kind category) or work's tags and their history
|
|
// GET /api/mod/details/:kind/:id a poet's details (kind poet) or a book/section's title (kind book), history
|
|
// POST /api/mod/details/:kind/:id/draft start (or reopen) my draft of them
|
|
// POST /api/mod/tags/:kind/:id/draft start (or reopen) my tagging draft
|
|
// POST /api/mod/revisions/:id/save {content, summary}
|
|
// POST /api/mod/revisions/:id/:action submit | approve | return | reject | publish {comment}
|
|
// GET /api/mod/log?page=&who=&kind=&action= who did what, newest first; filtered by person, kind of change, step
|
|
// GET /api/mod/compare/:entity/:id?a=&b= two published versions of a work, order or tags and their diff (0 = the
|
|
// Wikisource text before Divan's first version)
|
|
// POST /api/mod/revert/:entity/:id {version}: a draft that brings back that version, through the pipeline
|
|
import type { FastifyInstance, FastifyReply, FastifyRequest } from 'fastify';
|
|
import { pool } from './db.ts';
|
|
import { sessionUser } from './auth.ts';
|
|
import { can } from './permissions.ts';
|
|
import { fromPoem, writeOwned } from './owned.ts';
|
|
import { parse, toVerses, toText } from './divantext.ts';
|
|
import { normalise } from './urdu.ts';
|
|
import { diffLines, changed } from './diff.ts';
|
|
import { commit, identity } from './git.ts';
|
|
import { currentOrder, checkOrder, applyOrder, writeOrder, orderSlugs } from './order.ts';
|
|
import { currentTags, checkTags, applyTags, writeTags, parseTags, tagsText, type Tag, type TagTarget } from './tags.ts';
|
|
import { currentEbook, checkEbook, applyEbook, writeEbook, mayUpload } from './ebooks.ts';
|
|
import { publicName } from './auth.ts';
|
|
import { isDetail, currentDetails, checkDetails, applyDetails, writeDetails, parseDetails, detailsText, type DetailKind } from './details.ts';
|
|
|
|
const dataDir = () => process.env.DIVAN_DATA_DIR ?? new URL('../../../divan-data', import.meta.url).pathname;
|
|
const isModerator = (u: any) => ['mod-l2', 'mod-l1', 'admin'].includes(u?.role);
|
|
const mayEdit = (u: any, poemId: number) => can(u, 'edit', 'works', { poemId });
|
|
const mayArrange = async (u: any, categoryId: number) =>
|
|
(await can(u, 'arrange', 'works', { categoryId })) || (await can(u, 'arrange', 'books', { categoryId }));
|
|
const mayTag = (u: any, kind: TagTarget, id: number) => can(u, 'edit', 'tags', kind === 'work' ? { poemId: id } : { categoryId: id });
|
|
// may change what this revision changes (a work's text, a book/section's order, tags); reviewing needs L1 or admin
|
|
const mayEbook = async (u: any, ebookId: number) =>
|
|
mayUpload(u, (await pool.query('SELECT poet_id FROM ebooks WHERE id = $1', [ebookId])).rows[0]?.poet_id ?? 0);
|
|
const mayDetails = (u: any, kind: DetailKind, id: number) =>
|
|
kind === 'poet' ? can(u, 'edit', 'poets', { poetId: id }) : can(u, 'edit', 'books', { categoryId: id });
|
|
const mayChange = (u: any, r: { entity: string; entity_id: number }) => isDetail(r.entity) ? mayDetails(u, r.entity, r.entity_id) :
|
|
r.entity === 'order' ? mayArrange(u, r.entity_id) : r.entity.startsWith('tags-') ? mayTag(u, tagKind(r), r.entity_id)
|
|
: r.entity === 'ebook' ? mayEbook(u, r.entity_id) : mayEdit(u, r.entity_id);
|
|
const tagKind = (r: { entity: string }) => r.entity.slice('tags-'.length) as TagTarget;
|
|
const ENTITIES = `('work', 'order', 'tags-category', 'tags-work', 'ebook', 'poet', 'book')`;
|
|
const mayReview = async (u: any, r: { entity: string; entity_id: number }) => ['mod-l1', 'admin'].includes(u?.role) && (await mayChange(u, r));
|
|
const OPEN = ['draft', 'returned'];
|
|
// a draft whose text is still the text it started from is not shown anywhere (opening the editor is not a change)
|
|
const CHANGED = `(r.status <> 'draft' OR r.content <> r.base_content)`;
|
|
|
|
async function moderator(req: FastifyRequest, reply: FastifyReply) {
|
|
const u = await sessionUser(req);
|
|
if (!u) return void reply.code(401).send({ error: 'لاگ ان کریں' });
|
|
if (!isModerator(u)) return void reply.code(403).send({ error: 'صرف موڈریٹرز کے لیے' });
|
|
return u;
|
|
}
|
|
|
|
const event = (revId: number, u: any, action: string, comment?: string | null) =>
|
|
pool.query('INSERT INTO revision_events (revision_id, actor_id, actor_email, action, comment) VALUES ($1, $2, $3, $4, $5)',
|
|
[revId, u?.id ?? null, u?.email ?? 'server', action, comment || null]);
|
|
|
|
// a work's current published text: its latest Divan version, or the Wikisource text as Divan text
|
|
async function current(poemId: number) {
|
|
const poem = (await pool.query(
|
|
'SELECT p.id, p.url, p.title, p.source_url, t.nickname AS poet FROM poems p JOIN poets t ON t.id = p.poet_id WHERE p.id = $1', [poemId])).rows[0];
|
|
if (!poem) return null;
|
|
const last = (await pool.query(
|
|
`SELECT version, content FROM revisions WHERE entity = 'work' AND entity_id = $1 AND status = 'published' ORDER BY version DESC LIMIT 1`, [poemId])).rows[0];
|
|
if (last) return { poem, version: last.version as number, content: last.content as string };
|
|
const verses = (await pool.query('SELECT position AS "Position", couplet AS "CoupletIndex", text AS "Text" FROM verses WHERE poem_id = $1 ORDER BY vorder', [poemId])).rows;
|
|
return { poem, version: 0, content: fromPoem({ Title: poem.title, Verses: verses, SourceUrl: poem.source_url ?? undefined }, { شاعر: poem.poet }) };
|
|
}
|
|
|
|
// what a revision changes: a work, or a book/section's order (work_title/work_url name either)
|
|
const TARGET = `LEFT JOIN poems p ON r.entity IN ('work', 'tags-work') AND p.id = r.entity_id
|
|
LEFT JOIN categories c ON r.entity IN ('order', 'tags-category', 'book') AND c.id = r.entity_id
|
|
LEFT JOIN ebooks b ON r.entity = 'ebook' AND b.id = r.entity_id
|
|
LEFT JOIN poets pt ON r.entity = 'poet' AND pt.id = r.entity_id`;
|
|
// (not named URL: that would hide the global URL used for the default divan-data folder)
|
|
const TARGET_TITLE = `coalesce(p.title, c.title, b.title, pt.nickname)`, TARGET_URL = `coalesce(p.url, c.url, '/ebook/' || b.id, pt.url)`;
|
|
const TARGET_COLS = `${TARGET_TITLE} AS work_title, ${TARGET_URL} AS work_url`;
|
|
|
|
async function revision(id: number) {
|
|
return (await pool.query(`SELECT r.*, ${TARGET_COLS} FROM revisions r ${TARGET} WHERE r.id = $1 AND r.entity IN ${ENTITIES}`, [id])).rows[0];
|
|
}
|
|
|
|
// what this person may do with this revision now
|
|
async function actions(u: any, r: any) {
|
|
const mine = Number(r.author_id) === Number(u.id), review = await mayReview(u, r), admin = u.role === 'admin';
|
|
return {
|
|
save: mine && OPEN.includes(r.status),
|
|
submit: mine && OPEN.includes(r.status),
|
|
approve: !mine && review && r.status === 'submitted',
|
|
return: (review || admin) && ['submitted', 'approved'].includes(r.status) && !(mine && !admin),
|
|
reject: (review || admin) && ['submitted', 'approved'].includes(r.status) && !(mine && !admin),
|
|
publish: admin && r.status === 'approved',
|
|
};
|
|
}
|
|
|
|
async function publish(r: any, u: any, comment?: string) {
|
|
const order = r.entity === 'order', tags = r.entity.startsWith('tags-'), ebook = r.entity === 'ebook';
|
|
const cur = await currentOf(r.entity, r.entity_id);
|
|
if (!cur) throw Object.assign(new Error('کلام نہیں ملا'), { code: 404 });
|
|
if (cur.version !== r.base_version)
|
|
throw Object.assign(new Error('اس دوران اس کا نیا ورژن شائع ہو چکا ہے۔ مسودہ واپس بھیج کر تازہ متن پر دوبارہ بنوائیں۔'), { code: 409 });
|
|
// the section's contents may have changed since (a new work from the sync): the arrangement must be redone
|
|
const details = isDetail(r.entity);
|
|
const stale = order ? await checkOrder(r.entity_id, r.content) : tags ? await checkTags(tagKind(r), r.entity_id, r.content)
|
|
: ebook ? checkEbook(r.content) : details ? checkDetails(r.entity, r.content) : null;
|
|
if (stale) throw Object.assign(new Error(`اس دوران اس حصے کی چیزیں بدل گئی ہیں: ${stale}`), { code: 409 });
|
|
const doc = order || tags || ebook || details ? null : parse(r.content), verses = doc ? toVerses(doc) : [];
|
|
const title = 'details' in cur ? `${r.entity === 'poet' ? 'شاعر' : 'عنوان'}: ${parseDetails(r.content)[r.entity === 'poet' ? 'تخلص' : 'عنوان']}`
|
|
: 'cat' in cur ? `ترتیب: ${cur.cat.title}` : 'target' in cur ? `ٹیگ: ${cur.target.title}`
|
|
: 'ebook' in cur ? `ای بک: ${cur.ebook.poet}، ${cur.ebook.title}` : doc!.meta['عنوان'] || cur.poem.title;
|
|
const version = cur.version + 1, at = new Date().toISOString();
|
|
// who did it, by public name (divan-data is public: never email addresses)
|
|
const people = async (id: unknown) => id ? (await pool.query('SELECT id, full_name FROM users WHERE id = $1', [id])).rows[0] ?? null : null;
|
|
const [author, reviewer] = await Promise.all([people(r.author_id), people(r.reviewer_id)]);
|
|
const who = (p: any) => p && { id: Number(p.id), name: publicName(p) };
|
|
const credits = { by: who(author)?.name ?? 'موڈریٹر', reviewedBy: who(reviewer)?.name ?? null, publishedBy: publicName(u) };
|
|
// divan-data first (the published record, committed to git), then the site's database
|
|
const files = 'details' in cur ? [await writeDetails(dataDir(), r.entity, cur.details.url, r.content)]
|
|
: 'cat' in cur ? [await writeOrder(dataDir(), cur.cat.url, r.content)]
|
|
: 'target' in cur ? [await writeTags(dataDir(), cur.target.url, r.content)]
|
|
: 'ebook' in cur ? [await writeEbook(dataDir(), cur.ebook, r.content)]
|
|
: await writeOwned(dataDir(), cur.poem.url, r.content, { ...credits, at, version, revision: Number(r.id) });
|
|
const trailers = [`Divan-Revision: ${r.id}`, `Divan-Version: ${version}`,
|
|
...(reviewer ? [`Reviewed-by: ${identityOf(reviewer)}`] : []), `Approved-by: ${identityOf(u)}`];
|
|
const sha = await commit(dataDir(), files.map((f) => f.slice(dataDir().replace(/\/$/, '').length + 1)),
|
|
who(author) ?? { id: 0, name: 'موڈریٹر' }, `${title}: ${r.summary || 'ترمیم'} (ورژن ${version})\n\n${trailers.join('\n')}`);
|
|
const client = await pool.connect();
|
|
try {
|
|
await client.query('BEGIN');
|
|
await client.query(`UPDATE revisions SET status = 'published', version = $2, publisher_email = $3, published_at = $4, commit = $5, credits = $6, updated_at = now()
|
|
WHERE id = $1`, [r.id, version, u.email, at, sha, credits]);
|
|
if (order) await applyOrder(client, r.entity_id, r.content);
|
|
else if (tags) await applyTags(client, tagKind(r), r.entity_id, r.content);
|
|
else if (ebook) await applyEbook(client, r.entity_id, r.content);
|
|
else if (details) await applyDetails(client, r.entity, r.entity_id, r.content);
|
|
else {
|
|
await client.query('UPDATE poems SET title = $2, search_text = $3 WHERE id = $1',
|
|
[r.entity_id, title, normalise([title, ...verses.map((v) => v.Text)].join(' '))]);
|
|
await client.query('DELETE FROM verses WHERE poem_id = $1', [r.entity_id]);
|
|
for (const v of verses)
|
|
await client.query('INSERT INTO verses (poem_id, vorder, position, couplet, text) VALUES ($1, $2, $3, $4, $5)',
|
|
[r.entity_id, v.VOrder, v.Position, v.CoupletIndex, v.Text]);
|
|
}
|
|
await client.query('COMMIT');
|
|
} catch (e) {
|
|
await client.query('ROLLBACK');
|
|
throw e;
|
|
} finally {
|
|
client.release();
|
|
}
|
|
// ponytail: radif/matla/maqta and the contents order are recomputed by the next daily export + import
|
|
await event(r.id, u, 'published', comment);
|
|
return version;
|
|
}
|
|
|
|
// what an entity is now (its latest published version), for any kind of revision
|
|
const currentOf = (entity: string, id: number): Promise<any> => entity === 'order' ? currentOrder(id)
|
|
: entity.startsWith('tags-') ? currentTags(tagKind({ entity }), id) : entity === 'ebook' ? currentEbook(id)
|
|
: isDetail(entity) ? currentDetails(entity, id) : current(id);
|
|
// the kinds of change with versions to compare and bring back (an e-book's details are a one-off)
|
|
const VERSIONED = ['work', 'order', 'tags-work', 'tags-category', 'poet', 'book'];
|
|
// a published version's content; version 0 is what the first Divan draft started from (the Wikisource text)
|
|
async function versionText(entity: string, id: number, v: number, cur: { version: number; content: string }) {
|
|
if (v === cur.version) return cur.content;
|
|
const { rows } = await pool.query(v
|
|
? `SELECT content FROM revisions WHERE entity = $1 AND entity_id = $2 AND status = 'published' AND version = $3`
|
|
: `SELECT base_content AS content FROM revisions WHERE entity = $1 AND entity_id = $2 AND base_version = 0 AND $3 = 0 ORDER BY id LIMIT 1`, [entity, id, v]);
|
|
return rows[0]?.content as string | undefined;
|
|
}
|
|
|
|
const identityOf = (p: any) => identity({ id: Number(p.id), name: publicName(p) });
|
|
|
|
export function moderationRoutes(app: FastifyInstance) {
|
|
// ?poem= on a work page; ?category= on a poet or book/section page (arrange)
|
|
app.get<{ Querystring: { poem?: string; category?: string } }>('/api/mod/can', async (req) => {
|
|
const u = await sessionUser(req), poemId = Number(req.query.poem) || 0, categoryId = Number(req.query.category) || 0;
|
|
if (!isModerator(u)) return { edit: false, review: false, publish: false, arrange: false, tags: false, ebooks: false };
|
|
if (categoryId) {
|
|
const poetId = (await pool.query('SELECT poet_id FROM categories WHERE id = $1', [categoryId])).rows[0]?.poet_id ?? 0;
|
|
return { arrange: await mayArrange(u, categoryId), tags: await mayTag(u, 'category', categoryId), ebooks: await mayUpload(u, poetId),
|
|
book: await mayDetails(u, 'book', categoryId), poet: await mayDetails(u, 'poet', poetId) };
|
|
}
|
|
return { edit: await mayEdit(u, poemId), review: await mayReview(u, { entity: 'work', entity_id: poemId }), publish: u.role === 'admin',
|
|
tags: await mayTag(u, 'work', poemId) };
|
|
});
|
|
|
|
app.get('/api/mod/queue', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const { rows } = await pool.query(
|
|
`SELECT r.id, r.entity, r.entity_id, r.status, r.summary, r.author_id, r.author_email, r.reviewer_email, r.updated_at,
|
|
${TARGET_TITLE} AS title, ${TARGET_URL} AS url
|
|
FROM revisions r ${TARGET}
|
|
WHERE r.entity IN ${ENTITIES} AND (r.status IN ('submitted', 'approved') OR (r.author_id = $1 AND r.status IN ('draft', 'returned') AND ${CHANGED}))
|
|
ORDER BY r.updated_at DESC LIMIT 300`, [u.id]);
|
|
const strip = ({ author_id, ...r }: any) => ({ ...r, id: Number(r.id) });
|
|
const review = [];
|
|
for (const r of rows) if (r.status === 'submitted' && Number(r.author_id) !== Number(u.id) && (await mayReview(u, r))) review.push(strip(r));
|
|
return {
|
|
mine: rows.filter((r) => Number(r.author_id) === Number(u.id)).map(strip),
|
|
review,
|
|
publish: u.role === 'admin' ? rows.filter((r) => r.status === 'approved').map(strip) : [],
|
|
};
|
|
});
|
|
|
|
app.get<{ Params: { id: string } }>('/api/mod/work/:id', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const cur = await current(Number(req.params.id) || 0);
|
|
if (!cur) return reply.code(404).send({ error: 'کلام نہیں ملا' });
|
|
const { rows } = await pool.query(
|
|
`SELECT id, version, base_version, status, summary, author_email, reviewer_email, publisher_email, created_at, published_at
|
|
FROM revisions r WHERE entity = 'work' AND entity_id = $1 AND ${CHANGED} ORDER BY coalesce(published_at, created_at) DESC`, [cur.poem.id]);
|
|
return { work: cur.poem, version: cur.version, content: cur.content, history: rows.map((r) => ({ ...r, id: Number(r.id) })),
|
|
may: { edit: await mayEdit(u, cur.poem.id) } };
|
|
});
|
|
|
|
app.post<{ Params: { id: string } }>('/api/mod/work/:id/draft', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const poemId = Number(req.params.id) || 0;
|
|
if (!(await mayEdit(u, poemId))) return reply.code(403).send({ error: 'اس کلام میں ترمیم کی اجازت نہیں' });
|
|
const open = (await pool.query(
|
|
`SELECT id FROM revisions WHERE entity = 'work' AND entity_id = $1 AND author_id = $2 AND status IN ('draft', 'returned') LIMIT 1`, [poemId, u.id])).rows[0];
|
|
if (open) return { id: Number(open.id) };
|
|
const cur = await current(poemId);
|
|
if (!cur) return reply.code(404).send({ error: 'کلام نہیں ملا' });
|
|
const { rows } = await pool.query(
|
|
`INSERT INTO revisions (entity, entity_id, base_version, base_content, content, status, author_id, author_email)
|
|
VALUES ('work', $1, $2, $3, $3, 'draft', $4, $5) RETURNING id`,
|
|
[poemId, cur.version, cur.content, u.id, u.email]);
|
|
await event(rows[0].id, u, 'created');
|
|
return { id: Number(rows[0].id) };
|
|
});
|
|
|
|
app.get<{ Params: { id: string } }>('/api/mod/order/:id', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const cur = await currentOrder(Number(req.params.id) || 0);
|
|
if (!cur) return reply.code(404).send({ error: 'حصہ نہیں ملا' });
|
|
const { rows } = await pool.query(
|
|
`SELECT id, version, base_version, status, summary, author_email, reviewer_email, publisher_email, created_at, published_at
|
|
FROM revisions r WHERE entity = 'order' AND entity_id = $1 AND ${CHANGED} ORDER BY coalesce(published_at, created_at) DESC`, [cur.cat.id]);
|
|
return { section: cur.cat, version: cur.version, content: cur.content, count: cur.count,
|
|
history: rows.map((r) => ({ ...r, id: Number(r.id) })), may: { arrange: await mayArrange(u, cur.cat.id) } };
|
|
});
|
|
|
|
app.post<{ Params: { id: string } }>('/api/mod/order/:id/draft', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const catId = Number(req.params.id) || 0;
|
|
if (!(await mayArrange(u, catId))) return reply.code(403).send({ error: 'اس حصے کی ترتیب بدلنے کی اجازت نہیں' });
|
|
const open = (await pool.query(
|
|
`SELECT id FROM revisions WHERE entity = 'order' AND entity_id = $1 AND author_id = $2 AND status IN ('draft', 'returned') LIMIT 1`, [catId, u.id])).rows[0];
|
|
if (open) return { id: Number(open.id) };
|
|
const cur = await currentOrder(catId);
|
|
if (!cur) return reply.code(404).send({ error: 'حصہ نہیں ملا' });
|
|
if (cur.count < 2) return reply.code(400).send({ error: 'اس حصے میں ترتیب دینے کو کچھ نہیں' });
|
|
const { rows } = await pool.query(
|
|
`INSERT INTO revisions (entity, entity_id, base_version, base_content, content, status, author_id, author_email)
|
|
VALUES ('order', $1, $2, $3, $3, 'draft', $4, $5) RETURNING id`,
|
|
[catId, cur.version, cur.content, u.id, u.email]);
|
|
await event(rows[0].id, u, 'created');
|
|
return { id: Number(rows[0].id) };
|
|
});
|
|
|
|
app.get<{ Params: { kind: string; id: string } }>('/api/mod/tags/:kind/:id', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const kind = req.params.kind as TagTarget;
|
|
if (kind !== 'work' && kind !== 'category') return reply.code(404).send({ error: 'نہیں ملا' });
|
|
const cur = await currentTags(kind, Number(req.params.id) || 0);
|
|
if (!cur) return reply.code(404).send({ error: 'نہیں ملا' });
|
|
const { rows } = await pool.query(
|
|
`SELECT id, version, base_version, status, summary, author_email, reviewer_email, publisher_email, created_at, published_at
|
|
FROM revisions r WHERE entity = $1 AND entity_id = $2 AND ${CHANGED} ORDER BY coalesce(published_at, created_at) DESC`, [`tags-${kind}`, cur.target.id]);
|
|
return { kind, target: cur.target, version: cur.version, content: cur.content, couplets: cur.couplets,
|
|
history: rows.map((r) => ({ ...r, id: Number(r.id) })), may: { tags: await mayTag(u, kind, cur.target.id) } };
|
|
});
|
|
|
|
app.post<{ Params: { kind: string; id: string } }>('/api/mod/tags/:kind/:id/draft', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const kind = req.params.kind as TagTarget, id = Number(req.params.id) || 0;
|
|
if (kind !== 'work' && kind !== 'category') return reply.code(404).send({ error: 'نہیں ملا' });
|
|
if (!(await mayTag(u, kind, id))) return reply.code(403).send({ error: 'یہاں ٹیگ لگانے کی اجازت نہیں' });
|
|
const open = (await pool.query(
|
|
`SELECT id FROM revisions WHERE entity = $1 AND entity_id = $2 AND author_id = $3 AND status IN ('draft', 'returned') LIMIT 1`, [`tags-${kind}`, id, u.id])).rows[0];
|
|
if (open) return { id: Number(open.id) };
|
|
const cur = await currentTags(kind, id);
|
|
if (!cur) return reply.code(404).send({ error: 'نہیں ملا' });
|
|
const { rows } = await pool.query(
|
|
`INSERT INTO revisions (entity, entity_id, base_version, base_content, content, status, author_id, author_email)
|
|
VALUES ($1, $2, $3, $4, $4, 'draft', $5, $6) RETURNING id`,
|
|
[`tags-${kind}`, id, cur.version, cur.content, u.id, u.email]);
|
|
await event(rows[0].id, u, 'created');
|
|
return { id: Number(rows[0].id) };
|
|
});
|
|
|
|
app.get<{ Params: { kind: string; id: string } }>('/api/mod/details/:kind/:id', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const { kind } = req.params, cur = isDetail(kind) ? await currentDetails(kind, Number(req.params.id) || 0) : null;
|
|
if (!cur) return reply.code(404).send({ error: 'نہیں ملا' });
|
|
const { rows } = await pool.query(
|
|
`SELECT id, version, base_version, status, summary, author_email, reviewer_email, publisher_email, created_at, published_at
|
|
FROM revisions r WHERE entity = $1 AND entity_id = $2 AND ${CHANGED} ORDER BY coalesce(published_at, created_at) DESC`, [kind, cur.details.id]);
|
|
return { kind, target: cur.details, version: cur.version, content: cur.content, fields: parseDetails(cur.content),
|
|
history: rows.map((r) => ({ ...r, id: Number(r.id) })), may: { edit: await mayDetails(u, kind as DetailKind, cur.details.id) } };
|
|
});
|
|
|
|
app.post<{ Params: { kind: string; id: string } }>('/api/mod/details/:kind/:id/draft', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const { kind } = req.params, id = Number(req.params.id) || 0;
|
|
if (!isDetail(kind)) return reply.code(404).send({ error: 'نہیں ملا' });
|
|
if (!(await mayDetails(u, kind, id))) return reply.code(403).send({ error: 'اس میں ترمیم کی اجازت نہیں' });
|
|
const open = (await pool.query(
|
|
`SELECT id FROM revisions WHERE entity = $1 AND entity_id = $2 AND author_id = $3 AND status IN ('draft', 'returned') LIMIT 1`, [kind, id, u.id])).rows[0];
|
|
if (open) return { id: Number(open.id) };
|
|
const cur = await currentDetails(kind, id);
|
|
if (!cur) return reply.code(404).send({ error: 'نہیں ملا' });
|
|
const { rows } = await pool.query(
|
|
`INSERT INTO revisions (entity, entity_id, base_version, base_content, content, status, author_id, author_email)
|
|
VALUES ($1, $2, $3, $4, $4, 'draft', $5, $6) RETURNING id`, [kind, id, cur.version, cur.content, u.id, u.email]);
|
|
await event(rows[0].id, u, 'created');
|
|
return { id: Number(rows[0].id) };
|
|
});
|
|
|
|
app.get<{ Params: { id: string } }>('/api/mod/revisions/:id', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const r = await revision(Number(req.params.id) || 0);
|
|
if (!r) return reply.code(404).send({ error: 'مسودہ نہیں ملا' });
|
|
const may = await actions(u, r);
|
|
if (Number(r.author_id) !== Number(u.id) && !(await mayReview(u, r)) && u.role !== 'admin')
|
|
return reply.code(403).send({ error: 'یہ مسودہ دیکھنے کی اجازت نہیں' });
|
|
const diff = diffLines(r.base_content, r.content); // against the text the draft started from
|
|
const events = (await pool.query('SELECT actor_email, action, comment, at FROM revision_events WHERE revision_id = $1 ORDER BY at, id', [r.id])).rows;
|
|
const { author_id, base_content, ...rest } = r;
|
|
return { revision: { ...rest, id: Number(r.id) }, diff, changes: changed(diff), events, may };
|
|
});
|
|
|
|
app.post<{ Params: { id: string }; Body: { content?: string; summary?: string } }>('/api/mod/revisions/:id/save', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const r = await revision(Number(req.params.id) || 0);
|
|
if (!r) return reply.code(404).send({ error: 'مسودہ نہیں ملا' });
|
|
if (!(await actions(u, r)).save) return reply.code(403).send({ error: 'یہ مسودہ اب محفوظ نہیں کیا جا سکتا' });
|
|
const content = String(req.body?.content ?? '').replace(/\r\n?/g, '\n');
|
|
if (r.entity === 'order' || r.entity.startsWith('tags-') || r.entity === 'ebook' || isDetail(r.entity)) {
|
|
const bad = r.entity === 'order' ? await checkOrder(r.entity_id, content) : r.entity === 'ebook' ? checkEbook(content)
|
|
: isDetail(r.entity) ? checkDetails(r.entity, content)
|
|
: await checkTags(tagKind(r), r.entity_id, content);
|
|
if (bad) return reply.code(400).send({ error: bad });
|
|
} else if (!toVerses(parse(content)).length) return reply.code(400).send({ error: 'متن میں کوئی شعر یا پیراگراف نہیں' });
|
|
if (content.length > 500_000) return reply.code(400).send({ error: 'متن بہت لمبا ہے' });
|
|
// no change from the text it started from (compared as Divan text, so layout-only differences don't count):
|
|
// a plain draft is dropped rather than kept
|
|
const norm = (t: string) => (r.entity === 'order' ? orderSlugs(t).join('\n') : r.entity.startsWith('tags-') ? tagsText(parseTags(t) as Tag[])
|
|
: r.entity === 'ebook' ? t.trim() : isDetail(r.entity) ? detailsText(r.entity, parseDetails(t)) : toText(parse(t)));
|
|
const same = norm(content) === norm(r.base_content);
|
|
if (same && r.status === 'draft') {
|
|
await pool.query('DELETE FROM revisions WHERE id = $1', [r.id]);
|
|
return { discarded: true };
|
|
}
|
|
if (same) return reply.code(400).send({ error: 'متن میں کوئی تبدیلی نہیں' });
|
|
const summary = String(req.body?.summary ?? '').trim().slice(0, 500) || null;
|
|
await pool.query('UPDATE revisions SET content = $2, summary = $3, updated_at = now() WHERE id = $1', [r.id, content, summary]);
|
|
await event(r.id, u, 'saved');
|
|
return { ok: true };
|
|
});
|
|
|
|
app.post<{ Params: { id: string; action: string }; Body: { comment?: string } }>('/api/mod/revisions/:id/:action', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const r = await revision(Number(req.params.id) || 0);
|
|
if (!r) return reply.code(404).send({ error: 'مسودہ نہیں ملا' });
|
|
const action = req.params.action as keyof Awaited<ReturnType<typeof actions>>, may = await actions(u, r);
|
|
if (!['submit', 'approve', 'return', 'reject', 'publish'].includes(action)) return reply.code(404).send({ error: 'نامعلوم عمل' });
|
|
if (!may[action]) return reply.code(403).send({ error: 'یہ عمل آپ کے لیے دستیاب نہیں' });
|
|
const comment = String(req.body?.comment ?? '').trim().slice(0, 2000);
|
|
if ((action === 'return' || action === 'reject') && !comment) return reply.code(400).send({ error: 'وجہ لکھیں' });
|
|
const set = (status: string, extra = '') => pool.query(`UPDATE revisions SET status = $2, updated_at = now()${extra} WHERE id = $1`, [r.id, status]);
|
|
try {
|
|
if (action === 'submit') {
|
|
// L2 -> L1 review; an L1's own draft goes to the admin; an admin's own draft publishes
|
|
if (u.role === 'admin') { await set('approved'); await event(r.id, u, 'submitted', comment); return { status: 'published', version: await publish({ ...r, status: 'approved' }, u) }; }
|
|
await set(u.role === 'mod-l1' ? 'approved' : 'submitted');
|
|
await event(r.id, u, 'submitted', comment);
|
|
return { status: u.role === 'mod-l1' ? 'approved' : 'submitted' };
|
|
}
|
|
if (action === 'approve') {
|
|
await pool.query(`UPDATE revisions SET status = 'approved', reviewer_id = $3, reviewer_email = $2, updated_at = now() WHERE id = $1`, [r.id, u.email, u.id]);
|
|
await event(r.id, u, 'approved', comment);
|
|
return { status: 'approved' };
|
|
}
|
|
if (action === 'return' || action === 'reject') {
|
|
await set(action === 'return' ? 'returned' : 'rejected');
|
|
await event(r.id, u, action === 'return' ? 'returned' : 'rejected', comment);
|
|
return { status: action === 'return' ? 'returned' : 'rejected' };
|
|
}
|
|
return { status: 'published', version: await publish(r, u, comment) };
|
|
} catch (e: any) {
|
|
return reply.code(e.code ?? 500).send({ error: e.message });
|
|
}
|
|
});
|
|
|
|
app.get<{ Querystring: { page?: string; who?: string; kind?: string; action?: string } }>('/api/mod/log', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const page = Math.max(1, Number(req.query.page) || 1), { who, kind, action } = req.query;
|
|
// filters: a person (part of their address), a kind of change (tags covers both), a step; empty = all
|
|
const { rows } = await pool.query(
|
|
`SELECT e.at, e.actor_email, e.action, e.comment, r.id AS revision, r.entity, r.version, ${TARGET_TITLE} AS title, ${TARGET_URL} AS url
|
|
FROM revision_events e JOIN revisions r ON r.id = e.revision_id ${TARGET}
|
|
WHERE r.entity IN ${ENTITIES} AND ${CHANGED}
|
|
AND ($1 = '' OR e.actor_email ILIKE '%' || $1 || '%') AND ($2 = '' OR r.entity = $2 OR r.entity LIKE $2 || '-%') AND ($3 = '' OR e.action = $3)
|
|
ORDER BY e.at DESC, e.id DESC LIMIT 50 OFFSET ${(page - 1) * 50}`, [who?.trim() ?? '', kind ?? '', action ?? '']);
|
|
return { page, entries: rows.map((r) => ({ ...r, revision: Number(r.revision) })) };
|
|
});
|
|
|
|
app.get<{ Params: { entity: string; id: string }; Querystring: { a?: string; b?: string } }>('/api/mod/compare/:entity/:id', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const { entity } = req.params, id = Number(req.params.id) || 0;
|
|
const cur = VERSIONED.includes(entity) ? await currentOf(entity, id) : null;
|
|
if (!cur) return reply.code(404).send({ error: 'نہیں ملا' });
|
|
const pick = (q: string | undefined, d: number) => (q === undefined || q === '' ? d : Number(q));
|
|
const a = pick(req.query.a, Math.max(0, cur.version - 1)), b = pick(req.query.b, cur.version);
|
|
const [ta, tb] = await Promise.all([a, b].map((v) => Number.isInteger(v) && v >= 0 && v <= cur.version ? versionText(entity, id, v, cur) : undefined));
|
|
if (ta === undefined || tb === undefined) return reply.code(404).send({ error: 'یہ ورژن نہیں ملا' });
|
|
const target = cur.poem ?? cur.cat ?? cur.target ?? cur.details, diff = diffLines(ta, tb);
|
|
return { entity, id, title: target.title, url: target.url, version: cur.version, a, b, diff, changes: changed(diff),
|
|
may: { revert: await mayChange(u, { entity, entity_id: id }) } };
|
|
});
|
|
|
|
app.post<{ Params: { entity: string; id: string }; Body: { version?: number } }>('/api/mod/revert/:entity/:id', async (req, reply) => {
|
|
const u = await moderator(req, reply); if (!u) return;
|
|
const { entity } = req.params, id = Number(req.params.id) || 0, v = Number(req.body?.version);
|
|
const cur = VERSIONED.includes(entity) ? await currentOf(entity, id) : null;
|
|
if (!cur) return reply.code(404).send({ error: 'نہیں ملا' });
|
|
if (!(await mayChange(u, { entity, entity_id: id }))) return reply.code(403).send({ error: 'اس میں تبدیلی کی اجازت نہیں' });
|
|
const content = Number.isInteger(v) && v >= 0 && v < cur.version ? await versionText(entity, id, v, cur) : undefined;
|
|
if (content === undefined) return reply.code(400).send({ error: 'یہ ورژن واپس نہیں لایا جا سکتا' });
|
|
if (content === cur.content) return reply.code(400).send({ error: 'یہ ورژن موجودہ ورژن جیسا ہی ہے' });
|
|
// the reverted text goes into my open draft (or a new one) and then through review like any edit
|
|
const summary = v ? `ورژن ${v} واپس لایا` : 'ویکی ماخذ کا متن واپس لایا';
|
|
const open = (await pool.query(
|
|
`SELECT id FROM revisions WHERE entity = $1 AND entity_id = $2 AND author_id = $3 AND status IN ('draft', 'returned') LIMIT 1`, [entity, id, u.id])).rows[0];
|
|
const revId = open ? Number(open.id) : Number((await pool.query(
|
|
`INSERT INTO revisions (entity, entity_id, base_version, base_content, content, status, author_id, author_email)
|
|
VALUES ($1, $2, $3, $4, $4, 'draft', $5, $6) RETURNING id`, [entity, id, cur.version, cur.content, u.id, u.email])).rows[0].id);
|
|
if (!open) await event(revId, u, 'created');
|
|
await pool.query(`UPDATE revisions SET content = $2, summary = $3, base_version = $4, base_content = $5, updated_at = now() WHERE id = $1`,
|
|
[revId, content, summary, cur.version, cur.content]);
|
|
await event(revId, u, 'reverted', summary);
|
|
return { id: revId };
|
|
});
|
|
}
|