@geekity/cms 0.3.0 → 0.5.0

package/dist/comments/records.js

@@ -0,0 +1,487 @@
+import { randomUUID } from 'node:crypto';
+import { readdirSync } from 'node:fs';
+import path from 'node:path';
+import { COMMENT_KINDS, COMMENT_SOURCES, COMMENT_STATUSES } from '../admin/store.js';
+import { readFileIfPresentSync, withFileLock, writeFileAtomicallySync } from '../files/atomic.js';
+import { hashClientAddress } from '../forms/protection.js';
+/**
+ * Native comments as the files that hold them, and the one door into them.
+ *
+ * decision-9 makes the filesystem the source of truth for everything durable,
+ * and a comment somebody typed into this site is exactly that: nothing else
+ * holds it, and no other server can be asked for it again. So it lives under
+ * `content/_data/comments/`, one JSON file per post, which puts it in git
+ * beside the posts, hands it to an Eleventy build of the same directory, and
+ * leaves SQLite holding nothing but an index — one rebuilt from these files on
+ * every boot and deletable at rest.
+ *
+ * The two rules `federation/records.ts` follows apply here for the same
+ * reasons, and are why every writer in this module goes through
+ * {@link withFileLock}:
+ *
+ * - **The file first, the index inside the same step.** Two comments arriving
+ *   at once cannot leave the index saying something the file does not.
+ * - **The index is derived, never told.** A row is built from a file entry by
+ *   {@link commentFrom} whether it is being written for the first time or
+ *   rebuilt at boot.
+ *
+ * The entry shape is deliberately wider than a form submission. A webmention
+ * (TASK-51) is somebody else's post pointing at this one: it has a `url` and no
+ * email, it may be a like rather than a reply, and it belongs in the same file
+ * and the same thread. So every entry says its `source` and its `kind`, and
+ * nothing here assumes a person filled in a form.
+ *
+ * Three things write comments — the form under a post, the webmention endpoint
+ * and a moderator's reply on the admin screen — and they all go through
+ * {@link intakeComment}, which is the whole of what happens between a proposed
+ * comment and a comment existing: the address hashed, the approved-author rule,
+ * the {@link CommentChecker}, one verdict-to-status rule, the write, and the
+ * message to whoever was waiting to hear. What the callers keep is what is
+ * really theirs — parsing a form and its cheap defences, fetching and verifying
+ * a source, and knowing who is signed in.
+ */
+/** Where the comment files live, relative to the content directory. */
+export const COMMENTS_DATA_DIRECTORY = '_data/comments';
+/** The absolute path of one site's `content/_data/comments`. */
+export function commentsDirectory(contentDir) {
+    return path.join(contentDir, ...COMMENTS_DATA_DIRECTORY.split('/'));
+}
+/**
+ * The absolute path of one post's comment file.
+ *
+ * Named by the post's slug, which is what a post keeps for its whole life: the
+ * editor gives an existing document the slug it already has, so the file that
+ * holds a post's comments never has to move. A slug carrying anything a
+ * filename should not is refused rather than sanitised, because two slugs that
+ * sanitised to one name would silently share a thread.
+ */
+export function commentsFile(contentDir, slug) {
+    if (!SAFE_SLUG.test(slug)) {
+        throw new Error(`"${slug}" is not a slug a comment file can be named after.`);
+    }
+    return path.join(commentsDirectory(contentDir), `${slug}.json`);
+}
+/** Slugs a file may be named after: what {@link slugify} produces, and no more. */
+const SAFE_SLUG = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+/**
+ * One post's comments, as its file says them, oldest first.
+ *
+ * A missing file is no comments, which is what almost every post has. Unlike
+ * `followers.json`, an entry that will not parse is dropped rather than
+ * throwing: a comment file is public, in git and editable by hand, and a typo
+ * in one post's file should cost that entry rather than take the whole site
+ * down on the next boot. Nothing irreplaceable is at stake — a comment that
+ * cannot be read is one nobody could have shown either way.
+ */
+export function readComments(contentDir, slug) {
+    const source = readFileIfPresentSync(commentsFile(contentDir, slug));
+    if (source === undefined)
+        return [];
+    return commentsIn(source);
+}
+/** One post's comment file as the post it names and the comments it holds. */
+function fileContents(source) {
+    let parsed;
+    try {
+        parsed = JSON.parse(source);
+    }
+    catch {
+        return { post: '', comments: [] };
+    }
+    if (!isRecord(parsed))
+        return { post: '', comments: [] };
+    const entries = parsed['comments'];
+    return {
+        post: typeof parsed['post'] === 'string' ? parsed['post'] : '',
+        comments: Array.isArray(entries)
+            ? entries.map(commentFrom).filter((entry) => entry !== undefined)
+            : [],
+    };
+}
+/** Just the comments, for the readers that have the post already. */
+function commentsIn(source) {
+    return fileContents(source).comments;
+}
+/**
+ * One file entry as the record it is, or `undefined` when it is not one.
+ *
+ * An entry needs an id and a name and nothing else: everything a hand-written
+ * file leaves out gets the value that means "the site was not told", so a
+ * template printing it has something to print. An entry with no id is refused,
+ * because an id is what a reply names and what a moderation action moves.
+ */
+function commentFrom(value) {
+    if (!isRecord(value))
+        return undefined;
+    const id = value['id'];
+    if (typeof id !== 'string' || id === '')
+        return undefined;
+    const author = isRecord(value['author']) ? value['author'] : {};
+    const content = isRecord(value['content']) ? value['content'] : {};
+    const name = typeof author['name'] === 'string' ? author['name'] : '';
+    if (name === '')
+        return undefined;
+    return {
+        id,
+        source: oneOf(value['source'], COMMENT_SOURCES, 'comment'),
+        kind: oneOf(value['kind'], COMMENT_KINDS, 'reply'),
+        // An entry that does not say where it stands is waiting: showing something
+        // nobody approved would be the one mistake this cannot make.
+        status: oneOf(value['status'], COMMENT_STATUSES, 'pending'),
+        author: {
+            name,
+            url: optionalText(author['url']),
+            email: optionalText(author['email']),
+            avatar: optionalText(author['avatar']),
+        },
+        content: {
+            markdown: typeof content['markdown'] === 'string' ? content['markdown'] : '',
+            html: typeof content['html'] === 'string' ? content['html'] : '',
+        },
+        submitted: typeof value['submitted'] === 'string' ? value['submitted'] : '',
+        addressHash: optionalText(value['addressHash']),
+        inReplyTo: optionalText(value['inReplyTo']),
+        url: optionalText(value['url']),
+        // An entry that does not say means one that never asked: a comment file
+        // written before TASK-55 shipped, or edited by hand, has nobody waiting on
+        // it, and defaulting the other way would email people who never opted in.
+        notify: value['notify'] === true,
+    };
+}
+/**
+ * Record a comment: append it to its post's file and index it.
+ *
+ * The id is minted here unless the caller brought one, and it is a UUID rather
+ * than a counter so two comments written at once on two machines holding the
+ * same content directory can never be given the same name.
+ */
+export async function addComment(records, comment) {
+    const { admin, contentDir } = records;
+    const file = commentsFile(contentDir, comment.slug);
+    const stored = {
+        ...commentRecordOf(comment),
+        slug: comment.slug,
+        permalink: comment.permalink,
+    };
+    return await withFileLock(file, () => {
+        const held = readCommentFile(file);
+        writeFileAtomicallySync(file, commentsJson(comment.permalink, [...held, entryOf(stored)]));
+        admin.putComment(stored);
+        return stored;
+    });
+}
+/**
+ * The one door into `content/_data/comments/`.
+ *
+ * Everything between a proposed comment and a comment existing happens here,
+ * so the form, the webmention endpoint and the admin screen cannot drift into
+ * three different answers to the same four questions.
+ *
+ * **Where the site would put it, before anybody judged it.** A form comment
+ * whose name and email together have been approved before is approved again —
+ * WordPress's rule, and the whole of the auto-approval decision. A webmention
+ * waits, because a page linking here is as much a stranger's words as a form
+ * submission is. A moderator's reply is approved, because the person writing it
+ * is the person who would have approved it.
+ *
+ * **What the checker says.** Everything but a moderator's own words goes
+ * through {@link CommentChecker}; a checker that is down or throws is no
+ * opinion, so a service having a bad afternoon never stops a site taking
+ * comments. A moderator's reply is not offered to it at all: a spam service has
+ * no say in what the owner of the site says.
+ *
+ * **The one verdict-to-status rule.**
+ *
+ * | Verdict   | A new comment                        | A webmention sent again              |
+ * | --------- | ------------------------------------ | ------------------------------------ |
+ * | `discard` | Nothing is stored.                   | The held entry is deleted.           |
+ * | `spam`    | Filed as spam.                       | Filed as spam.                       |
+ * | `ham`     | Approved.                            | The moderator's decision stands.     |
+ * | `unknown` | Where the site would have put it.    | The moderator's decision stands.     |
+ *
+ * A source re-sending its webmention must not take an approved mention back
+ * into the queue, and must not quietly let a spam one out. A checker that has
+ * changed its mind to `spam` is the one thing that moves it, because that is a
+ * new fact about the content rather than a repeat of an old one.
+ *
+ * **Who hears about it.** A new entry that is waiting sends the moderation
+ * notice, once. A webmention that was merely rewritten sends nothing — the
+ * moderators heard the first time and it has been in the queue ever since —
+ * and neither does one that was approved or filed as spam, because neither is
+ * waiting for anybody. A new comment that is approved instead tells whoever it
+ * answers, when they asked to be told.
+ */
+export async function intakeComment(options) {
+    const { records, origin, comment } = options;
+    // What this site would do about it on its own, which is both what a checker
+    // is shown and what `unknown` falls back to.
+    const proposed = {
+        ...comment,
+        status: siteStatusFor(origin, records, comment),
+        addressHash: hashClientAddress(options.dataDir, options.address),
+    };
+    const held = origin === 'webmention' ? heldWebmention(records, comment.slug, comment.url) : undefined;
+    const verdict = origin === 'moderator' ? 'unknown' : await ask(options, proposed);
+    if (verdict === 'discard') {
+        if (held === undefined)
+            return { kind: 'discarded', removed: false };
+        await deleteComment(records, held.id);
+        return { kind: 'discarded', removed: true };
+    }
+    const status = statusFor(verdict, proposed.status, held);
+    if (held !== undefined) {
+        // Its id, its post and its source never move: that is what makes it the
+        // same comment. What the page now says about itself replaces what it said.
+        const moved = await updateComment(records, held.id, {
+            kind: comment.kind,
+            status,
+            author: comment.author,
+            content: comment.content,
+            submitted: comment.submitted,
+        });
+        return moved === undefined
+            ? { kind: 'gone' }
+            : { kind: 'stored', comment: moved, created: false };
+    }
+    const stored = await addComment(records, { ...proposed, status });
+    announce(options.notices, stored);
+    return { kind: 'stored', comment: stored, created: true };
+}
+/**
+ * The webmention this site already holds from that page, if any.
+ *
+ * The source URL is a webmention's identity (doc-7), so this is what stops a
+ * blog post that is edited and re-sent adding a second entry — and what the
+ * endpoint asks before it fetches, so a source that has stopped linking here
+ * knows what to take away.
+ */
+export function heldWebmention(records, slug, source) {
+    if (source === null || source === '')
+        return undefined;
+    return records.admin
+        .listCommentsFor(slug)
+        .find((comment) => comment.source === 'webmention' && comment.url === source);
+}
+/** Where this site's own rules put a comment, before a checker has spoken. */
+function siteStatusFor(origin, records, comment) {
+    if (origin === 'moderator')
+        return 'approved';
+    if (origin === 'webmention')
+        return 'pending';
+    return records.admin.hasApprovedAuthor(comment.author.name, comment.author.email)
+        ? 'approved'
+        : 'pending';
+}
+/** The verdict-to-status rule, in the one place it is written. */
+function statusFor(verdict, site, held) {
+    if (verdict === 'spam')
+        return 'spam';
+    if (held !== undefined)
+        return held.status;
+    return verdict === 'ham' ? 'approved' : site;
+}
+/** Ask the checker, if there is one, and treat a broken one as no opinion. */
+async function ask(options, comment) {
+    const checker = options.checker;
+    if (checker === undefined)
+        return 'unknown';
+    const post = options.post;
+    const submission = {
+        comment,
+        post: {
+            slug: comment.slug,
+            title: post?.title ?? comment.slug,
+            url: post?.url ?? absolute(comment.permalink, options.baseUrl),
+        },
+        address: options.address,
+        userAgent: options.userAgent,
+        referrer: options.referrer,
+        baseUrl: options.baseUrl,
+    };
+    try {
+        return await checker.check(submission);
+    }
+    catch (error) {
+        // A checker that is down must not stop a site taking comments; the comment
+        // falls back to whatever the site's own rules said about it.
+        const logger = options.logger ?? console;
+        logger.warn(`The comment checker refused to answer: ${messageOf(error)}`);
+        return 'unknown';
+    }
+}
+/** Tell whoever was waiting on a comment that has just been written. */
+function announce(notices, stored) {
+    if (notices === undefined)
+        return;
+    // Only `pending`: one a checker filed as spam is not waiting for anybody,
+    // and one it said to discard was never stored at all.
+    if (stored.status === 'pending')
+        notices.pending(stored);
+    // A comment the site let straight through is on the page already, so
+    // whoever it answers hears about it now rather than at a moderator's hand.
+    else if (stored.status === 'approved')
+        notices.replyApproved(stored);
+}
+/** A site-root path as an absolute URL. */
+function absolute(pathname, baseUrl) {
+    try {
+        return new URL(pathname, baseUrl).href;
+    }
+    catch {
+        return pathname;
+    }
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Move a stored comment: approve it, mark it spam, put it back, or rewrite
+ * what it says.
+ *
+ * The rewrite is what a webmention needs (TASK-51): a page that links here and
+ * is then edited sends its webmention again, and what this site shows should
+ * be what that page says now rather than what it said last month. Its id, the
+ * post it is on and the source it came from never move, which is what makes it
+ * the same comment.
+ *
+ * Returns the comment as it now stands, or `undefined` when the index has no
+ * such comment. The index is what says which post's file to open, which is the
+ * one thing an id alone does not carry.
+ */
+export async function updateComment(records, id, change) {
+    const { admin, contentDir } = records;
+    const known = admin.getComment(id);
+    if (known === undefined)
+        return undefined;
+    const file = commentsFile(contentDir, known.slug);
+    return await withFileLock(file, () => {
+        const held = readCommentFile(file);
+        const at = held.findIndex((entry) => entry.id === id);
+        if (at === -1)
+            return undefined;
+        const moved = { ...known, ...held[at], ...change };
+        writeFileAtomicallySync(file, commentsJson(known.permalink, held.with(at, entryOf(moved))));
+        admin.putComment(moved);
+        return moved;
+    });
+}
+/**
+ * Forget a comment altogether.
+ *
+ * Returns whether there was anything to forget. The index is emptied of the id
+ * whether or not the file held it, so a row left over from a file somebody
+ * edited by hand cannot go on being shown.
+ */
+export async function deleteComment(records, id) {
+    const { admin, contentDir } = records;
+    const known = admin.getComment(id);
+    if (known === undefined)
+        return false;
+    const file = commentsFile(contentDir, known.slug);
+    return await withFileLock(file, () => {
+        const held = readCommentFile(file);
+        const next = held.filter((entry) => entry.id !== id);
+        if (next.length !== held.length) {
+            writeFileAtomicallySync(file, commentsJson(known.permalink, next));
+        }
+        const indexed = admin.deleteComment(id);
+        return next.length !== held.length || indexed;
+    });
+}
+/**
+ * Rebuild the comment index from the files.
+ *
+ * This is what makes `data/geekity.db` disposable for comments (decision-9):
+ * the table holds nothing but what these files say, so every boot throws away
+ * what it holds and reads them again. Editing a comment file by hand and
+ * restarting is therefore a supported thing to do, and a database deleted at
+ * rest costs a site nothing.
+ *
+ * Exported so `geekity rebuild` can call the very function boot calls, and
+ * synchronous because both callers are.
+ */
+export function rebuildCommentIndexes(records) {
+    const { admin, contentDir } = records;
+    const comments = [];
+    for (const file of commentFiles(contentDir)) {
+        const source = readFileIfPresentSync(file);
+        if (source === undefined)
+            continue;
+        const slug = path.basename(file, '.json');
+        const held = fileContents(source);
+        for (const entry of held.comments) {
+            comments.push({ ...entry, slug, permalink: held.post });
+        }
+    }
+    admin.replaceComments(comments);
+    return { comments: comments.length };
+}
+/** Every comment file a site has, in a stable order. */
+function commentFiles(contentDir) {
+    let entries;
+    try {
+        entries = readdirSync(commentsDirectory(contentDir));
+    }
+    catch {
+        // No directory is no comments, which is what a site nobody has answered
+        // has. Every other way this can fail fails again on the next boot.
+        return [];
+    }
+    return entries
+        .filter((name) => name.endsWith('.json') && SAFE_SLUG.test(name.slice(0, -'.json'.length)))
+        .sort()
+        .map((name) => path.join(commentsDirectory(contentDir), name));
+}
+/** One file's comments, read inside a lock the caller already holds. */
+function readCommentFile(file) {
+    const source = readFileIfPresentSync(file);
+    return source === undefined ? [] : commentsIn(source);
+}
+/** A new comment as the record it becomes, id and all. */
+function commentRecordOf(comment) {
+    return {
+        id: comment.id ?? randomUUID(),
+        source: comment.source,
+        kind: comment.kind,
+        status: comment.status,
+        author: { ...comment.author },
+        content: { ...comment.content },
+        submitted: comment.submitted,
+        addressHash: comment.addressHash,
+        inReplyTo: comment.inReplyTo,
+        url: comment.url,
+        notify: comment.notify,
+    };
+}
+/** A row as the file spells it: the post it is on is the file's, not the entry's. */
+function entryOf(comment) {
+    return {
+        id: comment.id,
+        source: comment.source,
+        kind: comment.kind,
+        status: comment.status,
+        author: { ...comment.author },
+        content: { ...comment.content },
+        submitted: comment.submitted,
+        addressHash: comment.addressHash,
+        inReplyTo: comment.inReplyTo,
+        url: comment.url,
+        notify: comment.notify,
+    };
+}
+/** One post's comments as the file spells them: indented, newline ended. */
+function commentsJson(permalink, comments) {
+    return `${JSON.stringify({ post: permalink, comments }, null, 2)}\n`;
+}
+/** A value the file may have left out, as the text it holds or `null`. */
+function optionalText(value) {
+    return typeof value === 'string' && value !== '' ? value : null;
+}
+/** A stored enumeration value, or the fallback for one this version does not know. */
+function oneOf(value, allowed, fallback) {
+    return allowed.includes(value) ? value : fallback;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=records.js.map

package/dist/comments/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/comments/records.ts"],"names":[],"mappings":"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"}

package/dist/comments/routes.d.ts

@@ -0,0 +1,60 @@
+import type { Hono } from 'hono';
+import type { AdminStore } from '../admin/store.ts';
+import type { Document } from '../content/document.ts';
+import type { GeekityEnv } from '../env.ts';
+import type { CommentFormContext, CommentViewer } from './form.ts';
+/**
+ * The one public endpoint comments add: where the form under a post posts to.
+ *
+ * It is a single path rather than one per post because the post is a field of
+ * the form. That keeps it out of the way of every permalink a site might ever
+ * mint — a path under `/_geekity/` is the CMS's own, like the health check —
+ * and means the route table does not grow with the site.
+ *
+ * Everything it answers is either a redirect or the post's own page rendered
+ * again with the form still filled in. There is no JSON, no fragment and no
+ * script: a comment form has worked without JavaScript since 2003 and there is
+ * no reason for this one to stop.
+ */
+export { COMMENT_POST_PATH, COMMENT_REPLY_PARAM } from './form.ts';
+/** Register the comment endpoint. Mounted by the public site. */
+export declare function mountComments(app: Hono<GeekityEnv>): void;
+/**
+ * The thank-you a reader is shown after posting, from the query the redirect
+ * carried, or `undefined` when the URL says nothing.
+ *
+ * A query rather than a flash message, because a reader has no session to hang
+ * one on, and because a comment form that only works for people with cookies
+ * is not a comment form.
+ */
+export declare function commentNoticeFor(query: string | undefined): string | undefined;
+/**
+ * The comment a `?reply_to=` query points at, as the theme needs it, or an
+ * empty object when the query names nothing on this post.
+ *
+ * Checked against the index rather than trusted, so a made-up id — or one from
+ * another page — cannot put a stranger's name on somebody's reply form, and so
+ * a comment waiting for a moderator cannot be discovered by guessing.
+ */
+export declare function commentReplyTarget(options: {
+    admin: AdminStore;
+    document: Document;
+    id: string | undefined;
+}): Record<string, unknown>;
+/**
+ * The form for a post, or `undefined` when it is not taking comments.
+ *
+ * What the renderer is handed at boot. It reads the settings and the clock on
+ * every render, so a post that closed an hour ago stops offering a form on the
+ * very next request.
+ */
+export declare function commentFormFor(options: {
+    document: Document;
+    site: Record<string, unknown>;
+    now: Date;
+    /** Whether the site can send mail, which is whether the box is offered. */
+    notifiable?: boolean | undefined;
+    /** Who the request's session says is reading, when it says anybody. */
+    viewer?: CommentViewer | undefined;
+}): CommentFormContext | undefined;
+//# sourceMappingURL=routes.d.ts.map

package/dist/comments/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/comments/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAY5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAYnE;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEnE,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAiHzD;AAqCD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;CACxB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ1B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,EAAE,IAAI,CAAC;IACV,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,uEAAuE;IACvE,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CACpC,GAAG,kBAAkB,GAAG,SAAS,CAKjC"}