@geekity/cms 0.30.0 → 0.31.0

package/dist/store/comments.d.ts

@@ -0,0 +1,253 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { RsvpValue } from '../content/rsvp.ts';
+import type { ConversationWrite } from './conversation.ts';
+import type { ListPageOptions } from './rows.ts';
+/** Where a comment came from. */
+export declare const COMMENT_SOURCES: readonly ['comment', 'webmention', 'activitypub'];
+/**
+ * One of {@link COMMENT_SOURCES}.
+ *
+ * `comment` is the form under the post. `webmention` is another site's post
+ * pointing at this one (TASK-51), which lands in the same file with the same
+ * shape and is told apart only by this. `activitypub` is a fediverse reply or
+ * reaction a site received before it ran Geekity, brought across by an import:
+ * one this site receives itself is logged in the inbox instead.
+ */
+export type CommentSource = (typeof COMMENT_SOURCES)[number];
+/** What a comment is: something written, or a wordless pointer at the post. */
+export declare const COMMENT_KINDS: readonly ['reply', 'like', 'boost', 'mention', 'repost'];
+/**
+ * One of {@link COMMENT_KINDS}. The same five a conversation knows.
+ *
+ * `reply`, `like` and `boost` are the fediverse's three. `repost` and
+ * `mention` are the webmention vocabulary's two extra: a repost is a boost by
+ * another name and is shown with them, and a mention is the one thing neither
+ * of the others is — somebody's page pointing at this one without answering
+ * it (TASK-51).
+ */
+export type CommentKind = (typeof COMMENT_KINDS)[number];
+/** Where a comment stands with the moderator. */
+export declare const COMMENT_STATUSES: readonly ['pending', 'approved', 'spam'];
+/**
+ * One of {@link COMMENT_STATUSES}.
+ *
+ * `pending` is waiting for somebody to look at it, and is the state almost
+ * every comment starts in; `approved` is on the page and in the feeds; `spam`
+ * is kept rather than deleted, so a checker can be told it was wrong and so a
+ * mistake can be undone.
+ */
+export type CommentStatus = (typeof COMMENT_STATUSES)[number];
+/** What a comment can have had removed from it for privacy (TASK-135). */
+export declare const REDACTED_FIELDS: readonly ['email', 'addressHash', 'author'];
+/**
+ * One of {@link REDACTED_FIELDS}.
+ *
+ * `email` and `addressHash` are what the retention sweep removes once they
+ * have outlived the site's periods. `author` is an erasure on request: the
+ * name, website, picture and email all went at once.
+ */
+export type RedactedField = (typeof REDACTED_FIELDS)[number];
+/** Who wrote a comment, as much as the site knows. */
+export interface CommentAuthor {
+    /** The name they gave, which is what the page shows. */
+    name: string;
+    /** Their website, or `null`. Shown, and marked `nofollow ugc` like any link. */
+    url: string | null;
+    /**
+     * Their email, or `null`. **Never shown**: it is here for the moderator, for
+     * the auto-approval rule, and for the spam checker.
+     */
+    email: string | null;
+    /**
+     * Their avatar, or `null`.
+     *
+     * A webmention has one out of the `u-photo` of the source page's `h-card`
+     * (TASK-51), and an imported fediverse comment its actor's icon (TASK-338).
+     * A form asks for no picture: one it did ask for would be a stranger's file
+     * on somebody else's page. The page serves it through the avatar cache.
+     */
+    avatar: string | null;
+}
+/** What a comment says, in both the forms the site keeps. */
+export interface CommentContent {
+    /** What was typed, which is what a person wrote and the source of truth. */
+    markdown: string;
+    /** {@link CommentContent.markdown} through the restricted profile. */
+    html: string;
+}
+/**
+ * One comment, as its post's file under `content/_data/comments/` holds it.
+ *
+ * The 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 assumes a person filled in a form.
+ */
+export interface CommentRecord {
+    /** Its name, unique across the site, and what a reply puts in `inReplyTo`. */
+    id: string;
+    /** Where it came from. */
+    source: CommentSource;
+    /** What it is. */
+    kind: CommentKind;
+    /** Where it stands with the moderator. */
+    status: CommentStatus;
+    /** Who wrote it. */
+    author: CommentAuthor;
+    /** What it says. */
+    content: CommentContent;
+    /** When it was submitted, as an ISO 8601 instant. */
+    submitted: string;
+    /**
+     * A salted hash of the address it came from, or `null`.
+     *
+     * The address itself is not kept: the file is published with the site and
+     * goes into git, and an IP address there would be a reader's home written
+     * into a public repository. The hash is enough to see that two comments came
+     * from one place, which is what a moderator is actually asking.
+     */
+    addressHash: string | null;
+    /** The comment it answers, or `null` for one answering the post itself. */
+    inReplyTo: string | null;
+    /**
+     * Where it lives when it lives somewhere else: the source page of a
+     * webmention, and `null` for a comment written on this site.
+     *
+     * It is what a later webmention from the same page is recognised by, which
+     * is how one updates the comment it made before instead of adding a second,
+     * and it is where the thread's permalink points for an entry this site did
+     * not host.
+     */
+    url: string | null;
+    /**
+     * Whether whoever wrote it asked to hear about replies to it (TASK-55).
+     *
+     * Only ever true for a comment that carries an `author.email`, because there
+     * would be nowhere to send it otherwise, and only ever set by somebody
+     * ticking the box on the form — a webmention has nobody to ask. What it buys
+     * is one message when a reply to this comment is approved, carrying an
+     * unsubscribe link that needs no login.
+     */
+    notify: boolean;
+    /**
+     * What was removed from it for privacy, in the order {@link REDACTED_FIELDS}
+     * lists them, when anything was (TASK-135). Absent rather than empty otherwise, so the files of a site
+     * that has never swept stay byte for byte what they were.
+     *
+     * It is what tells an email that was taken away from one that was never
+     * given: an author whose email was removed must not match the auto-approval
+     * rule the way an author who gave none does, or anybody typing their name
+     * would walk past the queue.
+     */
+    redacted?: readonly RedactedField[];
+    /**
+     * What a reply that is an RSVP says (TASK-198): the `p-rsvp` of the page a
+     * webmention came from. Absent for every other comment, so the files of a
+     * site that has had none stay byte for byte what they were.
+     */
+    rsvp?: RsvpValue;
+    /**
+     * The page whose entry carried it, for a webmention reply read out of
+     * another webmention's source rather than sent on its own (a salmention,
+     * TASK-320). Absent for every other comment.
+     */
+    via?: string;
+    /**
+     * Whether it was imported from another system (TASK-336), the word a
+     * migrated post uses. It was published before the site came here, so it is
+     * shown in its thread and carried by no feed. Absent for every other comment.
+     */
+    migrated?: true;
+    /**
+     * The name it has where it was first published, for a migrated comment
+     * that has one: a fediverse note or activity id, or a webmention's source.
+     * What the feeds call it when a native reply answers it, and what a later
+     * delivery of the same thing is recognised by. Absent for every other comment.
+     */
+    origin?: string;
+    /**
+     * The site user who wrote it, by username, for a comment written by
+     * somebody signed in to the system it was imported from (TASK-337). The
+     * thread names them as it names their reply posts. Absent for every other
+     * comment.
+     */
+    user?: string;
+    /**
+     * The fediverse actor who wrote it, by id, for a migrated fediverse comment
+     * whose actor the export named (TASK-338). What tells their like here from
+     * the same person's like delivered since, whatever profile page each names.
+     * Absent for every other comment.
+     */
+    actor?: string;
+}
+/**
+ * What a comment brought from the system it was imported from, as a record
+ * carries it: each of {@link CommentRecord.migrated}, `origin`, `user` and
+ * `actor` present only when set.
+ */
+export declare function importedFields(fields: {
+    readonly migrated?: boolean | null | undefined;
+    readonly origin?: string | null | undefined;
+    readonly user?: string | null | undefined;
+    readonly actor?: string | null | undefined;
+}): Pick<CommentRecord, 'migrated' | 'origin' | 'user' | 'actor'>;
+/** A comment's {@link CommentRecord.rsvp} as a record carries it: present only when there is one. */
+export declare function rsvpField(rsvp: RsvpValue | undefined): Pick<CommentRecord, 'rsvp'>;
+/** A comment's {@link CommentRecord.via} as a record carries it: present only when there is one. */
+export declare function viaField(via: string | null | undefined): Pick<CommentRecord, 'via'>;
+/**
+ * A {@link CommentRecord} with the post it is on.
+ *
+ * The file it lives in is named after the post's slug and records the post's
+ * permalink, so both are facts of the file rather than of the entry; the index
+ * carries them on the row because a query by id has no file to read them from.
+ */
+export interface PostComment extends CommentRecord {
+    /** The post's slug, which names the file the comment lives in. */
+    slug: string;
+    /** That post's permalink, for the moderation screen and the feeds. */
+    permalink: string;
+}
+/** How {@link CommentStore.listComments} narrows and pages. */
+export interface ListCommentsOptions extends ListPageOptions {
+    /** Only comments at this status. Every status when it is not given. */
+    status?: CommentStatus | undefined;
+}
+export interface CommentStore {
+    /** One post's comments, oldest first, whatever status they are at. */
+    listCommentsFor(slug: string): PostComment[];
+    /**
+     * Comments across the site, newest first, optionally of one status and one
+     * page of them. What the moderation screen and the site-wide feed read.
+     */
+    listComments(options: ListCommentsOptions): PostComment[];
+    /** One comment by id, or `undefined`. */
+    getComment(id: string): PostComment | undefined;
+    /** The comments whose `url` is this one, whatever their status (TASK-300). */
+    listCommentsAt(url: string): PostComment[];
+    /** How many comments stand at each status. What the dashboard shows. */
+    countCommentsByStatus(): Record<CommentStatus, number>;
+    /**
+     * Whether this name and email have had a comment approved before.
+     *
+     * WordPress's rule, and the whole of the auto-approval decision: somebody a
+     * moderator has already let through does not queue again. Both have to
+     * match, so a stranger typing a regular's name is still held.
+     */
+    hasApprovedAuthor(name: string, email: string | null): boolean;
+    /** Store a comment, replacing whatever was known about that id. */
+    putComment(comment: PostComment): PostComment;
+    /** Forget a comment. Returns `false` when there was nothing to forget. */
+    deleteComment(id: string): boolean;
+    /**
+     * Make the comment index say exactly this, in one transaction.
+     *
+     * What a rebuild from `content/_data/comments/` calls (decision-9): the
+     * files are the source, so a row they do not carry is a comment that should
+     * not be on the page. Nothing outside a rebuild should reach for it.
+     */
+    replaceComments(comments: readonly PostComment[]): void;
+}
+export declare function openCommentStore(db: DatabaseSync, written: (change: ConversationWrite) => void): CommentStore;
+//# sourceMappingURL=comments.d.ts.map

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

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

package/dist/store/comments.js

@@ -0,0 +1,234 @@
+import { rsvpValue } from '../content/rsvp.js';
+import { countByStatus, inTransaction, NO_LIMIT, nullableText, oneOf } from './rows.js';
+/** Where a comment came from. */
+export const COMMENT_SOURCES = ['comment', 'webmention', 'activitypub'];
+/** What a comment is: something written, or a wordless pointer at the post. */
+export const COMMENT_KINDS = ['reply', 'like', 'boost', 'mention', 'repost'];
+/** Where a comment stands with the moderator. */
+export const COMMENT_STATUSES = ['pending', 'approved', 'spam'];
+/** What a comment can have had removed from it for privacy (TASK-135). */
+export const REDACTED_FIELDS = ['email', 'addressHash', 'author'];
+/**
+ * What a comment brought from the system it was imported from, as a record
+ * carries it: each of {@link CommentRecord.migrated}, `origin`, `user` and
+ * `actor` present only when set.
+ */
+export function importedFields(fields) {
+    const { migrated, origin, user, actor } = fields;
+    return {
+        ...(migrated === true ? { migrated: true } : {}),
+        ...(origin ? { origin } : {}),
+        ...(user ? { user } : {}),
+        ...(actor ? { actor } : {}),
+    };
+}
+/** A comment's {@link CommentRecord.rsvp} as a record carries it: present only when there is one. */
+export function rsvpField(rsvp) {
+    return rsvp === undefined ? {} : { rsvp };
+}
+/** A comment's {@link CommentRecord.via} as a record carries it: present only when there is one. */
+export function viaField(via) {
+    return via === undefined || via === null || via === '' ? {} : { via };
+}
+export function openCommentStore(db, written) {
+    const statements = {
+        listCommentsFor: db.prepare(`
+      SELECT * FROM comments WHERE slug = ? ORDER BY submitted_at, id
+    `),
+        commentById: db.prepare('SELECT * FROM comments WHERE id = ?'),
+        commentsAt: db.prepare('SELECT * FROM comments WHERE url = ? ORDER BY submitted_at'),
+        countCommentsByStatus: db.prepare('SELECT status, COUNT(*) AS count FROM comments GROUP BY status'),
+        hasApprovedAuthor: db.prepare(`
+      SELECT 1 FROM comments
+      WHERE status = 'approved' AND author_name = ? AND author_email IS ?
+        AND NOT EXISTS (SELECT 1 FROM json_each(comments.redacted) WHERE value = 'email')
+      LIMIT 1
+    `),
+        putComment: db.prepare(`
+      INSERT INTO comments (
+        id, slug, permalink, source, kind, status,
+        author_name, author_url, author_email,
+        markdown, html, submitted_at, address_hash, in_reply_to, url, author_avatar, notify,
+        redacted, rsvp, via, migrated, origin, user, actor
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT (id) DO UPDATE SET
+        slug = excluded.slug,
+        permalink = excluded.permalink,
+        source = excluded.source,
+        kind = excluded.kind,
+        status = excluded.status,
+        author_name = excluded.author_name,
+        author_url = excluded.author_url,
+        author_email = excluded.author_email,
+        markdown = excluded.markdown,
+        html = excluded.html,
+        submitted_at = excluded.submitted_at,
+        address_hash = excluded.address_hash,
+        in_reply_to = excluded.in_reply_to,
+        url = excluded.url,
+        author_avatar = excluded.author_avatar,
+        notify = excluded.notify,
+        redacted = excluded.redacted,
+        rsvp = excluded.rsvp,
+        via = excluded.via,
+        migrated = excluded.migrated,
+        origin = excluded.origin,
+        user = excluded.user,
+        actor = excluded.actor
+    `),
+        deleteComment: db.prepare('DELETE FROM comments WHERE id = ?'),
+        clearComments: db.prepare('DELETE FROM comments'),
+    };
+    return {
+        listCommentsFor(slug) {
+            return statements.listCommentsFor.all(slug).map(toComment);
+        },
+        listComments(options = {}) {
+            // Prepared here rather than beside the others because the `WHERE` is not
+            // fixed: the screen asks for one status and the site-wide feed asks for
+            // approved comments across every post.
+            const where = options.status === undefined ? '' : 'WHERE status = ?';
+            const parameters = options.status === undefined ? [] : [options.status];
+            const rows = db
+                .prepare(`SELECT * FROM comments ${where}
+           ORDER BY submitted_at DESC, id DESC
+           LIMIT ? OFFSET ?`)
+                .all(...parameters, options.limit ?? NO_LIMIT, options.offset ?? 0);
+            return rows.map(toComment);
+        },
+        getComment(id) {
+            const row = statements.commentById.get(id);
+            return row === undefined ? undefined : toComment(row);
+        },
+        listCommentsAt(url) {
+            return statements.commentsAt.all(url).map(toComment);
+        },
+        countCommentsByStatus() {
+            const rows = statements.countCommentsByStatus.all();
+            return countByStatus(rows, COMMENT_STATUSES, commentStatus);
+        },
+        hasApprovedAuthor(name, email) {
+            // `IS` rather than `=`, so an author who gave no email is matched by the
+            // rows that gave none either instead of matching nothing.
+            return statements.hasApprovedAuthor.get(name, email) !== undefined;
+        },
+        putComment(comment) {
+            const before = statements.commentById.get(comment.id);
+            statements.putComment.run(...commentColumns(comment));
+            written({
+                kind: 'comment',
+                slug: comment.slug,
+                id: comment.id,
+                approved: comment.status === 'approved' && before?.['status'] !== 'approved',
+            });
+            return comment;
+        },
+        deleteComment(id) {
+            const row = statements.commentById.get(id);
+            const slug = row === undefined ? undefined : String(row['slug']);
+            const deleted = statements.deleteComment.run(id).changes > 0;
+            if (slug !== undefined)
+                written({ kind: 'comment', slug, id, approved: false });
+            return deleted;
+        },
+        replaceComments(comments) {
+            inTransaction(db, () => {
+                statements.clearComments.run();
+                for (const comment of comments) {
+                    statements.putComment.run(...commentColumns(comment));
+                }
+            });
+        },
+    };
+}
+function toComment(row) {
+    return {
+        id: String(row['id']),
+        slug: String(row['slug']),
+        permalink: String(row['permalink']),
+        source: oneOf(row['source'], COMMENT_SOURCES, 'comment'),
+        kind: oneOf(row['kind'], COMMENT_KINDS, 'reply'),
+        status: commentStatus(row['status']),
+        author: {
+            name: String(row['author_name']),
+            url: nullableText(row['author_url']),
+            email: nullableText(row['author_email']),
+            avatar: nullableText(row['author_avatar']),
+        },
+        content: { markdown: String(row['markdown']), html: String(row['html']) },
+        submitted: String(row['submitted_at']),
+        addressHash: nullableText(row['address_hash']),
+        inReplyTo: nullableText(row['in_reply_to']),
+        url: nullableText(row['url']),
+        notify: Number(row['notify'] ?? 0) === 1,
+        ...redactedOf(row['redacted']),
+        ...rsvpField(rsvpValue(row['rsvp'])),
+        ...viaField(nullableText(row['via'])),
+        ...importedFields({
+            migrated: Number(row['migrated'] ?? 0) === 1,
+            origin: nullableText(row['origin']),
+            user: nullableText(row['user']),
+            actor: nullableText(row['actor']),
+        }),
+    };
+}
+/** A comment's {@link CommentRecord.redacted} as its column holds it: JSON, or `NULL`. */
+function redactedColumn(redacted) {
+    return redacted === undefined || redacted.length === 0 ? null : JSON.stringify(redacted);
+}
+/** The column read back, as the key a record carries only when something was removed. */
+function redactedOf(value) {
+    if (typeof value !== 'string')
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        return {};
+    }
+    const fields = Array.isArray(parsed)
+        ? REDACTED_FIELDS.filter((field) => parsed.includes(field))
+        : [];
+    return fields.length === 0 ? {} : { redacted: fields };
+}
+/**
+ * A stored comment status, or `pending` for one this version does not know.
+ *
+ * Pending is the safe reading: showing a comment nobody approved is the one
+ * mistake a moderation queue cannot make, and the screen is right there for
+ * the row.
+ */
+function commentStatus(value) {
+    return oneOf(value, COMMENT_STATUSES, 'pending');
+}
+/** A comment as the values of the comments table's columns, in the order `putComment` names them. */
+function commentColumns(comment) {
+    return [
+        comment.id,
+        comment.slug,
+        comment.permalink,
+        comment.source,
+        comment.kind,
+        comment.status,
+        comment.author.name,
+        comment.author.url,
+        comment.author.email,
+        comment.content.markdown,
+        comment.content.html,
+        comment.submitted,
+        comment.addressHash,
+        comment.inReplyTo,
+        comment.url,
+        comment.author.avatar,
+        comment.notify ? 1 : 0,
+        redactedColumn(comment.redacted),
+        comment.rsvp ?? null,
+        comment.via ?? null,
+        comment.migrated === true ? 1 : 0,
+        comment.origin ?? null,
+        comment.user ?? null,
+        comment.actor ?? null,
+    ];
+}
+//# sourceMappingURL=comments.js.map

package/dist/store/comments.js.map

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

package/dist/store/conversation.d.ts

@@ -0,0 +1,28 @@
+/**
+ * What {@link ConversationEvents.onConversationWrite} hears: a comment on the post of
+ * that slug, or an activity naming these objects as what it is about or what
+ * it answers. `approved` says this write is the one that approved the comment,
+ * so it is on the page now and was not before (TASK-333).
+ */
+export type ConversationWrite = {
+    readonly kind: 'comment';
+    readonly slug: string;
+    readonly id: string;
+    readonly approved: boolean;
+} | {
+    readonly kind: 'activity';
+    readonly about: readonly string[];
+};
+export interface ConversationEvents {
+    /**
+     * Hear about every comment written or forgotten and every activity logged,
+     * as it happens (TASK-320). A rebuild of either index is not news and says
+     * nothing. Returns the function that stops listening.
+     */
+    onConversationWrite(listener: (written: ConversationWrite) => void): () => void;
+}
+export declare function conversationEvents(): {
+    events: ConversationEvents;
+    written: (change: ConversationWrite) => void;
+};
+//# sourceMappingURL=conversation.d.ts.map

package/dist/store/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/store/conversation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,mBAAmB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACjF;AAED,wBAAgB,kBAAkB,IAAI;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC9C,CAaA"}

package/dist/store/conversation.js

@@ -0,0 +1,16 @@
+export function conversationEvents() {
+    const listeners = new Set();
+    return {
+        events: {
+            onConversationWrite(listener) {
+                listeners.add(listener);
+                return () => listeners.delete(listener);
+            },
+        },
+        written(change) {
+            for (const listener of listeners)
+                listener(change);
+        },
+    };
+}
+//# sourceMappingURL=conversation.js.map

package/dist/store/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../src/store/conversation.ts"],"names":[],"mappings":"AAwBA,MAAM,UAAU,kBAAkB;IAIhC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwC,CAAC;IAClE,OAAO;QACL,MAAM,EAAE;YACN,mBAAmB,CAAC,QAAQ;gBAC1B,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1C,CAAC;SACF;QACD,OAAO,CAAC,MAAM;YACZ,KAAK,MAAM,QAAQ,IAAI,SAAS;gBAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/store/deliveries.d.ts

@@ -0,0 +1,92 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { Clock } from '../util/clock.ts';
+/** How one delivery of one activity to one follower ended. */
+export declare const DELIVERY_STATUSES: readonly ['sent', 'queued', 'failed'];
+/**
+ * One of {@link DELIVERY_STATUSES}.
+ *
+ * `sent` is a POST the follower's server accepted. `queued` is one handed to
+ * Fedify's outbox queue, which is as much as a site running with a queue can
+ * know from the call: the queue retries out of band and does not report back.
+ * `failed` is a delivery that threw, with the reason in the row.
+ */
+export type DeliveryStatus = (typeof DELIVERY_STATUSES)[number];
+/**
+ * How one attempt to deliver one activity to one recipient ended, and what the
+ * activity was.
+ *
+ * The whole of what SQLite keeps about anything the site has sent (decision-9).
+ * No payload goes with it: an activity is rebuilt from the post's file at the
+ * moment somebody asks for it to go again, so storing the bytes that went out
+ * last time would only be a second, staler answer to the same question. What
+ * is left is a cache of outcomes, and a site that deletes its database loses
+ * nothing but the record of how yesterday's delivery went.
+ *
+ * The activity's own columns are here rather than in a table of their own
+ * because there is no longer anything else to put in one: they are what the
+ * federation screen reads to say what went out and when.
+ */
+export interface Delivery {
+    /** The id of the activity that was delivered. */
+    readonly activityId: string;
+    /** `Create`, `Update` or `Delete`. */
+    readonly activityType: string;
+    /**
+     * The ActivityStreams id of what it was about: a post, or the site's own
+     * actor when the profile itself was what moved.
+     */
+    readonly objectId: string;
+    /**
+     * The post's slug when the activity went out, or `null` for an activity
+     * about no post — which is what an actor `Update` is.
+     */
+    readonly slug: string | null;
+    /** Which follower or relay it was delivered to. */
+    readonly actorId: string;
+    /** The inbox actually used, which is the shared one when the follower has one. */
+    readonly inboxId: string;
+    /** How it went. */
+    readonly status: DeliveryStatus;
+    /** Why it failed, or `null`. */
+    readonly error: string | null;
+    /** When the attempt was made, as an ISO 8601 instant. */
+    readonly attemptedAt: string;
+}
+/** A {@link Delivery} before the store has timed it. */
+export type NewDelivery = Omit<Delivery, 'attemptedAt'> & {
+    attemptedAt?: string | undefined;
+};
+export interface DeliveryStore {
+    /**
+     * Record how one delivery to one follower ended, replacing the previous
+     * outcome for that pair: the table answers "where does this activity stand
+     * with each follower", which a resend moves rather than adds to.
+     */
+    recordDelivery(delivery: NewDelivery): Delivery;
+    /** Every follower's outcome for one activity, in follower order. */
+    listDeliveries(activityId: string): Delivery[];
+    /** How many followers this activity stands at each status with. */
+    countDeliveriesByStatus(activityId: string): Record<DeliveryStatus, number>;
+    /**
+     * The most recent delivery to one inbox, whichever activity it carried, or
+     * `undefined` when nothing has ever gone there.
+     *
+     * Keyed by the inbox rather than by the actor because that is what a relay
+     * has: it is not a follower, so there is no follower row to look its
+     * outcomes up by, and the inbox is the thing the site was told to deliver to.
+     */
+    lastDeliveryToInbox(inboxId: string): Delivery | undefined;
+    /**
+     * The most recent delivery about one object — a post's ActivityStreams id,
+     * or the site actor's — or `undefined` when nothing about it has ever gone
+     * out.
+     *
+     * What the federation screen's per-post row is filled in from. Keyed by the
+     * object rather than by the activity because a post is a series of
+     * activities and the row is about the post: the newest outcome is the one
+     * that says where the post currently stands with the fediverse.
+     */
+    lastDeliveryToObject(objectId: string): Delivery | undefined;
+}
+export declare function openDeliveryStore(db: DatabaseSync, clock: Clock): DeliveryStore;
+//# sourceMappingURL=deliveries.d.ts.map

package/dist/store/deliveries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliveries.d.ts","sourceRoot":"","sources":["../../src/store/deliveries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAI9C,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,YAAI,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,QAAQ;IACvB,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mBAAmB;IACnB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG;IACxD,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IAChD,oEAAoE;IACpE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAC/C,mEAAmE;IACnE,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC5E;;;;;;;OAOG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3D;;;;;;;;;OASG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC9D;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,aAAa,CA8E/E"}