@geekity/cms 0.30.0 → 0.31.0

package/dist/comments/conversation.d.ts

@@ -0,0 +1,334 @@
+import type { Document } from '../content/document.ts';
+import type { RsvpValue } from '../content/rsvp.ts';
+import type { AdminStore, PostComment } from '../store/admin-store.ts';
+/**
+ * Where an interaction came from.
+ *
+ * `activitypub` is a reply, a like or a boost the site's inbox was sent.
+ * `comment` is the form under the post (TASK-50). `webmention` is another
+ * site's post pointing at this one (TASK-51). `post` is a reply post a user of
+ * this site wrote, whose `in-reply-to` names the post or something said under
+ * it (TASK-300). All four are the same shape and thread together, which is the
+ * whole point of naming the source rather than keeping four lists.
+ */
+export type InteractionSource = 'activitypub' | 'comment' | 'webmention' | 'post';
+/**
+ * What an interaction is.
+ *
+ * `reply` is something somebody wrote; `like` and `boost` are the two ways the
+ * fediverse can point at a post without writing anything. `repost` is a
+ * webmention's word for a boost and is grouped with them, because to a reader
+ * they are the same act under two vocabularies. `mention` is the one thing
+ * none of the others is: somebody's page linking to this one without answering
+ * it (TASK-51).
+ */
+export type InteractionKind = 'reply' | 'like' | 'boost' | 'repost' | 'mention';
+/**
+ * Where an interaction stands with the moderator.
+ *
+ * Everything a remote server sends is `published`: it was published there
+ * before it arrived here, and this site did not decide it. A native comment
+ * carries the status its file gives it, and only an `approved` one is ever put
+ * in a conversation — `pending` and `spam` are named here because that is what
+ * the file can say, not because a template will ever be handed one.
+ */
+export type InteractionStatus = 'published' | 'pending' | 'approved' | 'spam';
+/** Who wrote something, as much as the site knows. */
+export interface InteractionAuthor {
+    /** The best name available: their display name, else their handle, else their id. */
+    readonly name: string;
+    /** `@user@host`, when the source knows or can imply one. */
+    readonly handle: string | null;
+    /** Their profile page, for a reader following the link. */
+    readonly url: string | null;
+    /**
+     * Their avatar, when the site knows one: always a same-origin path, never
+     * the remote URL, so a reader's browser asks this site for it (TASK-134).
+     */
+    readonly avatar: string | null;
+    /** Their id, which is what identifies them however they are named. */
+    readonly actorId: string | null;
+    /**
+     * Where to follow what they publish, when the site knows (TASK-324): a
+     * webmention author's h-card or site, or a site user's author feed. A
+     * visitor's own website is only what they typed, and a fediverse actor
+     * publishes no feed the site knows of, so both are `null`.
+     */
+    readonly feed: string | null;
+    /**
+     * The site user they are, by username, else `null`: whoever a reply post
+     * is by, or whoever a stored comment names (TASK-337). A theme vouches for
+     * the link of a site user and of nobody else.
+     */
+    readonly username: string | null;
+}
+/** One thing somebody did to a post: a reply, a like or a boost. */
+export interface Interaction {
+    /** What it is called: the note's id, and what a reply to it names. */
+    readonly id: string;
+    /**
+     * Its key (decision-51): a stored comment's id, else the key of its guid.
+     * The one thing in its anchor, `#comment-{key}`, and its replies feed,
+     * `/replies/{key}/`.
+     */
+    readonly key: string;
+    /**
+     * What the comments feeds call it, and what a reply to it names in
+     * `source:inReplyTo`: a stored form comment's page, a stored comment's
+     * origin or else its url, and anything else's id.
+     */
+    readonly guid: string;
+    /**
+     * Whether it was imported from another system (TASK-336): shown in the
+     * thread like any other, and carried by no feed and no reply count.
+     */
+    readonly migrated: boolean;
+    /** Where it came from. */
+    readonly source: InteractionSource;
+    /** Which of the three it is. */
+    readonly kind: InteractionKind;
+    /** Who did it. */
+    readonly author: InteractionAuthor;
+    /** Where it can be read on its own server, or `null` for one with no page. */
+    readonly url: string | null;
+    /** What it says, sanitised and ready to print. Empty for a like or a boost. */
+    readonly content: string;
+    /** When it was published, or when it arrived if it did not say. */
+    readonly published: Date;
+    /** What it answers: the post, or another interaction. `null` for a reaction. */
+    readonly inReplyTo: string | null;
+    /** Whether a reader may see it. */
+    readonly status: InteractionStatus;
+    /** The replies to this one, oldest first. */
+    readonly replies: ThreadReply[];
+    /**
+     * What a reply that is an RSVP says (TASK-198): its `rsvp` value and the
+     * words for it. A webmention carries one, and so does a fediverse answer
+     * to an event (TASK-200).
+     */
+    readonly rsvp?: {
+        readonly value: RsvpValue;
+        readonly label: string;
+    };
+}
+/**
+ * A comment a reader may not see, standing in the thread for the replies to it
+ * that a reader may (TASK-325): it is waiting for a moderator, filed as spam or
+ * deleted. It names nobody and says nothing, and there is one only while a
+ * visible reply sits under it.
+ */
+export interface WithheldReply {
+    /** The hidden comment's id. */
+    readonly id: string;
+    /** Its key, so its anchor on the post is still there. */
+    readonly key: string;
+    readonly withheld: true;
+    /** The replies under it, oldest first, at least one of them visible. */
+    readonly replies: ThreadReply[];
+}
+/** One entry of a thread: a reply, or the placeholder for a hidden one. */
+export type ThreadReply = Interaction | WithheldReply;
+/** How many of each a conversation holds. */
+export interface InteractionCounts {
+    /** Replies, counted through the whole thread rather than the top of it. */
+    readonly replies: number;
+    /** Likes. */
+    readonly likes: number;
+    /** Boosts, reposts included. */
+    readonly boosts: number;
+    /** Mentions: pages that linked to this one without answering it. */
+    readonly mentions: number;
+    /** RSVPs to an event, one per person, in every group. */
+    readonly rsvps: number;
+    /** All of them added up: zero is what "no conversation" means. */
+    readonly total: number;
+}
+/** Everything under one post. */
+export interface Conversation {
+    /** The replies to the post itself, oldest first, each carrying its own. */
+    readonly replies: ThreadReply[];
+    /** The likes, oldest first. */
+    readonly likes: Interaction[];
+    /** The boosts and the reposts, oldest first and in one list. */
+    readonly boosts: Interaction[];
+    /** The pages that linked here without answering, oldest first. */
+    readonly mentions: Interaction[];
+    /**
+     * The answers to an event (TASK-200), grouped as going, maybe, interested
+     * and not going, each group oldest first and only when it has somebody in
+     * it. Empty on a post that is no event.
+     */
+    readonly rsvps: RsvpGroup[];
+    /** How many of each. */
+    readonly counts: InteractionCounts;
+}
+/** Everybody who gave an event one answer. */
+export interface RsvpGroup {
+    readonly value: RsvpValue;
+    readonly label: string;
+    /** Each person's latest answer, oldest first, each an RSVP interaction. */
+    readonly people: Interaction[];
+}
+/**
+ * Something said in a conversation, with the reply it sits under (TASK-324):
+ * what the comments feeds name as what it answers.
+ */
+export interface Placed extends Interaction {
+    /**
+     * The visible reply it answers, or `null` for the post. A hidden comment in
+     * between is passed over, the way the thread already passes over a
+     * withdrawn note, so a reader walking the feeds reaches every visible reply.
+     */
+    readonly parent: Interaction | null;
+}
+/** One interaction with the post it is about, which a site-wide list needs. */
+export interface SiteInteraction extends Placed {
+    /** The post it answers. */
+    readonly post: Document;
+    /**
+     * Who wrote the reply it answers, when it answers one a reader can see
+     * (TASK-318), and `null` for an answer to the post itself.
+     */
+    readonly replyingTo: string | null;
+}
+/**
+ * The three questions anything showing a conversation asks.
+ *
+ * Every one of them is answered from both indexes at once, because a reader
+ * does not care which door an answer came in by. The moderation screen and the
+ * notices are not conversation display and keep their own queries: they are
+ * about what a moderator has to decide, which is the one thing a reader never
+ * sees.
+ */
+export interface ConversationReader {
+    /** Everything said about one post, threaded. */
+    readonly thread: (document: Document) => Conversation;
+    /**
+     * How many visible replies answer each of these documents directly, by
+     * permalink: what a reader following `source:comments` finds in its
+     * `/replies/` feed (TASK-324). Read off each thread, since that is the only
+     * reading that knows which replies a reader sees and where they sit.
+     */
+    readonly counts: (documents: readonly Document[]) => Map<string, number>;
+    /**
+     * The site's latest answers, newest first, each with the post it answers.
+     *
+     * One about a post that has since been unpublished or trashed is left out,
+     * because the post it is about is not there to read: the feed would be
+     * showing a conversation about nothing. That filtering happens after the
+     * indexes have paged, so the pages are read until enough survive.
+     */
+    readonly latest: (limit: number) => SiteInteraction[];
+    /**
+     * One native comment as its own page reads it (TASK-318), or `undefined`
+     * for an id that names no approved comment written on this site. The post
+     * comes back in whatever state it is in, so the page can answer as the post
+     * itself would.
+     */
+    readonly comment: (id: string) => CommentThread | undefined;
+    /**
+     * The reply on a post that a URL names, or `undefined` (TASK-319):
+     * a comment by its own page or by the post's `#comment-` anchor, a
+     * webmention by the page it was sent from, a fediverse reply by its url or
+     * its id. Every stored comment counts whatever its status, because what a
+     * reply answers is a fact about it, and whether a reader may see the one it
+     * answers is decided when the thread is read.
+     */
+    readonly replyNamed: (document: Document, url: string) => Interaction | undefined;
+    /**
+     * What a URL names on this site, while a reader may see it: a reply (a
+     * comment by its page or its anchor, a webmention by the page it was sent
+     * from, a fediverse reply by its id or url, a reply post by its permalink)
+     * with the post it is on, or a served post or page itself (TASK-300,
+     * TASK-326). What a reply post answering it cites, instead of fetching a page.
+     */
+    readonly heldAt: (url: string) => HeldAt | undefined;
+    /**
+     * What a key names and its direct replies (TASK-324, decision-51), or
+     * `undefined`: a served post or page, or a reply a reader can see.
+     */
+    readonly repliesTo: (key: string) => RepliesOf | undefined;
+    /**
+     * The document whose conversation a URL is in (TASK-320): the post a
+     * comment's page or anchor is on, the post a webmention was sent to, the
+     * post a fediverse reply answers however deep, or the document at the URL.
+     */
+    readonly documentOf: (url: string) => Document | undefined;
+    /**
+     * Every page in the conversation a document is in that answers something
+     * off this site, with what a reader sees under it (TASK-320): what a
+     * salmention is sent from. A reply post answers its `in-reply-to`; a
+     * comment's own page answers the webmention reply it is under. One
+     * answering something here has nobody to tell: this site already knows.
+     */
+    readonly upstreams: (document: Document) => Upstream[];
+}
+/** One page of this site's answering a page elsewhere (TASK-320). */
+export interface Upstream {
+    /** The document the page is, or that the comment is on. */
+    readonly post: Document;
+    /** The page, absolute: a reply post's permalink or a comment's own page. */
+    readonly source: string;
+    /** What it answers, off this site. */
+    readonly target: string;
+    /** The replies a reader sees under it, as its page prints them. */
+    readonly replies: readonly ThreadReply[];
+}
+/** What one `/replies/` feed is about, and what is in it (TASK-324). */
+export interface RepliesOf {
+    /** The document whose conversation it is. */
+    readonly post: Document;
+    /** The reply whose replies these are, or `null` for the document's own. */
+    readonly reply: Interaction | null;
+    /** The visible replies directly under it, each carrying its own. */
+    readonly replies: Placed[];
+}
+/** What {@link ConversationReader.heldAt} found: a reply and the post it is on, or a post. */
+export type HeldAt = {
+    readonly kind: 'reply';
+    readonly post: Document;
+    readonly reply: Interaction;
+} | {
+    readonly kind: 'document';
+    readonly post: Document;
+    readonly author: InteractionAuthor;
+};
+/** A native comment, what it answers and what answers it (TASK-318). */
+export interface CommentThread {
+    /** The post it is on. */
+    readonly post: Document;
+    /** The comment, carrying its replies at every depth as the thread does. */
+    readonly comment: Interaction;
+    /**
+     * What it answers, from the top-level comment down to its parent. `null`
+     * is an ancestor a reader may not see: one waiting for a moderator, filed
+     * as spam, deleted or withdrawn.
+     */
+    readonly ancestors: readonly (Interaction | null)[];
+}
+/**
+ * The URLs a reply post can answer a native comment by: its own page, and its
+ * anchor on the post at this absolute permalink.
+ */
+export declare function commentNames(id: string, permalink: string, baseUrl: string): string[];
+/**
+ * The stored comment holding a fediverse note or activity id as its origin:
+ * one imported from the site this one replaced, keyed by that id as it would
+ * have been had it arrived here (TASK-336). A delivery or a fetch of the same
+ * id is that comment again, and the stored one wins, since it is the one the
+ * moderator decided on and the thread anchors.
+ */
+export declare function heldComment(admin: AdminStore, id: string): PostComment | undefined;
+/**
+ * The `id` a thread entry is anchored at on the page, by its key.
+ *
+ * Prefixed rather than bare so a comment can never collide with a heading
+ * anchor the post's own Markdown produced.
+ */
+export declare function commentAnchor(key: string): string;
+/** The key of the comment whose page a path is, or `undefined` (TASK-319). */
+export declare function commentKeyAt(pathname: string): string | undefined;
+/** The entry of a thread with this key that a reader can see, at any depth. */
+export declare function visibleReply(replies: readonly ThreadReply[], key: string): Interaction | undefined;
+export declare function isWithheld(reply: ThreadReply): reply is WithheldReply;
+//# sourceMappingURL=conversation.d.ts.map

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

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

package/dist/comments/conversation.js

@@ -0,0 +1,51 @@
+import { COMMENT_PAGE_PREFIX, commentPageHref, isKey, repliesKey } from '../content/guids.js';
+import { absoluteUrl } from '../util/url.js';
+/**
+ * The URLs a reply post can answer a native comment by: its own page, and its
+ * anchor on the post at this absolute permalink.
+ */
+export function commentNames(id, permalink, baseUrl) {
+    return [absoluteUrl(commentPageHref(id), baseUrl), `${permalink}#${commentAnchor(id)}`];
+}
+/**
+ * The stored comment holding a fediverse note or activity id as its origin:
+ * one imported from the site this one replaced, keyed by that id as it would
+ * have been had it arrived here (TASK-336). A delivery or a fetch of the same
+ * id is that comment again, and the stored one wins, since it is the one the
+ * moderator decided on and the thread anchors.
+ */
+export function heldComment(admin, id) {
+    const comment = admin.getComment(repliesKey(id));
+    return comment?.origin === id ? comment : undefined;
+}
+/**
+ * The `id` a thread entry is anchored at on the page, by its key.
+ *
+ * Prefixed rather than bare so a comment can never collide with a heading
+ * anchor the post's own Markdown produced.
+ */
+export function commentAnchor(key) {
+    return `comment-${key}`;
+}
+/** The key of the comment whose page a path is, or `undefined` (TASK-319). */
+export function commentKeyAt(pathname) {
+    if (!pathname.startsWith(COMMENT_PAGE_PREFIX) || !pathname.endsWith('/'))
+        return undefined;
+    const key = pathname.slice(COMMENT_PAGE_PREFIX.length, -1);
+    return isKey(key) ? key : undefined;
+}
+/** The entry of a thread with this key that a reader can see, at any depth. */
+export function visibleReply(replies, key) {
+    for (const reply of replies) {
+        if (!isWithheld(reply) && reply.key === key)
+            return reply;
+        const found = visibleReply(reply.replies, key);
+        if (found !== undefined)
+            return found;
+    }
+    return undefined;
+}
+export function isWithheld(reply) {
+    return 'withheld' in reply;
+}
+//# sourceMappingURL=conversation.js.map

package/dist/comments/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../src/comments/conversation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG9F,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA2T7C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,SAAiB,EAAE,OAAe;IACzE,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,SAAS,IAAI,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,EAAU;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IACjD,OAAO,OAAO,EAAE,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,WAAW,GAAG,EAAE,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3F,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAC1B,OAA+B,EAC/B,GAAW;IAEX,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QAC1D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,OAAO,UAAU,IAAI,KAAK,CAAC;AAC7B,CAAC"}

package/dist/comments/form.d.ts

@@ -110,14 +110,14 @@ export declare const COMMENT_REPLY_PARAM = "reply_to";
  */
 export declare const COMMENT_NOTICES: Readonly<Record<string, string>>;
 /** A fresh, empty form for a post that is taking comments. */
-export declare function commentForm(document: Document, now?: Date, notifiable?: boolean): CommentFormContext;
+export declare function commentForm(document: Document, now: Date, notifiable?: boolean): CommentFormContext;
 /**
  * The same form with what somebody typed still in it.
  *
  * What a refused submission is answered with: losing a paragraph because an
  * email address had a typo in it is the fastest way to lose a commenter.
  */
-export declare function refilledCommentForm(document: Document, values: CommentFormContext['values'], problems: CommentProblems, now?: Date, error?: string, notifiable?: boolean): CommentFormContext;
+export declare function refilledCommentForm(document: Document, values: CommentFormContext['values'], problems: CommentProblems, now: Date, error?: string, notifiable?: boolean): CommentFormContext;
 /** What a form holds before anybody has typed in it. */
 export declare function blankValues(): CommentFormContext['values'];
 /** What a submitted form typed, for putting back in a refused one. */

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

@@ -1 +1 @@
-{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/comments/form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,cAAc,EAA4C,MAAM,iBAAiB,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,OAAO,cAAc,CAAC;IAC9B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9F;;;;;OAKG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,eAAe,CAAC;IAC1B,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACvD;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,aAAa,GACpB,kBAAkB,CAMpB;AAED,oCAAoC;AACpC,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AAEtD,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG5D,CAAC;AAEF,8DAA8D;AAC9D,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,GAAG,GAAE,IAAiB,EACtB,UAAU,UAAQ,GACjB,kBAAkB,CAEpB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACpC,QAAQ,EAAE,eAAe,EACzB,GAAG,GAAE,IAAiB,EACtB,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,UAAQ,GACjB,kBAAkB,CAapB;AAED,wDAAwD;AACxD,wBAAgB,WAAW,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAE1D;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAUxE"}
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/comments/form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,cAAc,EAA4C,MAAM,iBAAiB,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,OAAO,cAAc,CAAC;IAC9B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9F;;;;;OAKG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,eAAe,CAAC;IAC1B,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACvD;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,aAAa,GACpB,kBAAkB,CAMpB;AAED,oCAAoC;AACpC,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AAEtD,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG5D,CAAC;AAEF,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,UAAQ,GAAG,kBAAkB,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACpC,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,IAAI,EACT,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,UAAQ,GACjB,kBAAkB,CAapB;AAED,wDAAwD;AACxD,wBAAgB,WAAW,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAE1D;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAUxE"}

package/dist/comments/form.js

@@ -38,7 +38,7 @@ export const COMMENT_NOTICES = {
     pending: 'Thank you — your comment is waiting to be approved.',
 };
 /** A fresh, empty form for a post that is taking comments. */
-export function commentForm(document, now = new Date(), notifiable = false) {
+export function commentForm(document, now, notifiable = false) {
     return refilledCommentForm(document, blankValues(), {}, now, undefined, notifiable);
 }
 /**
@@ -47,7 +47,7 @@ export function commentForm(document, now = new Date(), notifiable = false) {
  * What a refused submission is answered with: losing a paragraph because an
  * email address had a typo in it is the fastest way to lose a commenter.
  */
-export function refilledCommentForm(document, values, problems, now = new Date(), error, notifiable = false) {
+export function refilledCommentForm(document, values, problems, now, error, notifiable = false) {
     return {
         action: COMMENT_POST_PATH,
         fields: COMMENT_FIELDS,

package/dist/comments/form.js.map

@@ -1 +1 @@
-{"version":3,"file":"form.js","sourceRoot":"","sources":["../../src/comments/form.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAiF3F;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAwB,EACxB,MAAqB;IAErB,OAAO;QACL,GAAG,IAAI;QACP,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;QAClD,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAEtD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqC;IAC/D,MAAM,EAAE,0CAA0C;IAClD,OAAO,EAAE,qDAAqD;CAC/D,CAAC;AAEF,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CACzB,QAAkB,EAClB,GAAG,GAAS,IAAI,IAAI,EAAE,EACtB,UAAU,GAAG,KAAK;IAElB,OAAO,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACtF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,MAAoC,EACpC,QAAyB,EACzB,GAAG,GAAS,IAAI,IAAI,EAAE,EACtB,KAAc,EACd,UAAU,GAAG,KAAK;IAElB,OAAO;QACL,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,cAAc;QACtB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM;QACN,QAAQ;QACR,UAAU;QACV,UAAU,EAAE,mBAAmB;QAC/B,UAAU,EAAE,mBAAmB;QAC/B,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC3F,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,IAAiB;IACxC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../../src/comments/form.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAiF3F;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAwB,EACxB,MAAqB;IAErB,OAAO;QACL,GAAG,IAAI;QACP,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;QAClD,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAEtD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqC;IAC/D,MAAM,EAAE,0CAA0C;IAClD,OAAO,EAAE,qDAAqD;CAC/D,CAAC;AAEF,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,QAAkB,EAAE,GAAS,EAAE,UAAU,GAAG,KAAK;IAC3E,OAAO,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACtF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,MAAoC,EACpC,QAAyB,EACzB,GAAS,EACT,KAAc,EACd,UAAU,GAAG,KAAK;IAElB,OAAO;QACL,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,cAAc;QACtB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM;QACN,QAAQ;QACR,UAAU;QACV,UAAU,EAAE,mBAAmB;QAC/B,UAAU,EAAE,mBAAmB;QAC/B,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC3F,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,IAAiB;IACxC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC"}

package/dist/comments/index.d.ts

@@ -5,12 +5,18 @@ export type { CommentFormContext, CommentViewer } from './form.ts';
 export { renderCommentMarkdown } from './markdown.ts';
 export { isModerationAction, moderateComment, MODERATION_ACTIONS } from './moderate.ts';
 export type { ModerateCommentOptions, ModerationAction, ModerationOutcome } from './moderate.ts';
-export { COMMENTS_FRONT_MATTER_KEY, commentPolicyOf, commentsOpen, DEFAULT_COMMENTS_CLOSE_AFTER_DAYS, } from './policy.ts';
+export { COMMENTS_FRONT_MATTER_KEY } from '../content/comments.ts';
+export { commentPolicyOf, commentsOpen } from './policy.ts';
+export { DEFAULT_COMMENTS_CLOSE_AFTER_DAYS } from '../site/settings.ts';
 export type { CommentPolicy } from './policy.ts';
-export { addComment, COMMENT_EMAILS_DIRECTORY, COMMENT_EMAILS_FILE_MODE, commentEmailsFile, COMMENTS_DATA_DIRECTORY, commentsDirectory, commentsFile, deleteComment, followAllMovedComments, followMovedComments, heldWebmention, intakeComment, migrateCommentEmails, migrateCommentKeys, putComments, renameComments, readComments, rebuildCommentIndexes, updateComment, } from './records.ts';
-export type { CommentEmailMigrationReport, CommentKeyMigrationReport, CommentIndexReport, CommentIntakeOutcome, CommentNotices, CommentOrigin, CommentRecords, IntakeCommentOptions, NewComment, ProposedComment, } from './records.ts';
-export { commentFormFor, commentNoticeFor, mountComments } from './routes.ts';
+export { addComment, COMMENT_EMAILS_DIRECTORY, COMMENT_EMAILS_FILE_MODE, commentEmailsFile, COMMENTS_DATA_DIRECTORY, commentsDirectory, commentsFile, deleteComment, followAllMovedComments, followMovedComments, putComments, renameComments, readComments, rebuildCommentIndexes, updateComment, } from './records.ts';
+export type { CommentIndexReport, CommentRecords, NewComment } from './records.ts';
+export { heldWebmention, intakeComment } from './intake.ts';
+export type { CommentIntakeOutcome, CommentNotices, CommentOrigin, IntakeCommentOptions, ProposedComment, } from './intake.ts';
+export { migrateCommentEmails, migrateCommentKeys } from './migrations.ts';
+export type { CommentEmailMigrationReport, CommentKeyMigrationReport } from './migrations.ts';
+export { commentFormFor, commentNoticeFor } from './page-form.ts';
 export { COMMENT_FIELDS, COMMENT_RATE_LIMIT, COMMENT_RATE_WINDOW_SECONDS, COMMENT_SALT_FILE, commentKeys, commentProblems, hashClientAddress, MAXIMUM_BODY_LENGTH, MAXIMUM_NAME_LENGTH, MAXIMUM_URL_LENGTH, MAXIMUM_FORM_AGE_SECONDS, MINIMUM_SUBMIT_SECONDS, normalizeWebsite, submitComment, } from './submission.ts';
-export type { CommentChecker, CommentForm, CommentOutcome, CommentProblems, CommentRefusal, CommentReport, CommentSubmission, SubmissionType, CommentThrottle, CommentVerdict, SubmitCommentOptions, } from './submission.ts';
-export { signedInCommenter } from './viewer.ts';
+export type { CommentChecker, CommentReport, CommentSubmission, SubmissionType, CommentVerdict, } from '../forms/checker.ts';
+export type { CommentForm, CommentOutcome, CommentProblems, CommentRefusal, CommentThrottle, SubmitCommentOptions, } from './submission.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/comments/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxF,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjG,OAAO,EACL,yBAAyB,EACzB,eAAe,EACf,YAAY,EACZ,iCAAiC,GAClC,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,2BAA2B,EAC3B,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/comments/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxF,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjG,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,YAAY,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,2BAA2B,EAC3B,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/comments/index.js

@@ -2,9 +2,12 @@ export { AKISMET_ENDPOINT, AKISMET_KEY_FILE, AKISMET_TIMEOUT_MS, AKISMET_USER_AG
 export { blankValues, COMMENT_NOTICE_PARAM, COMMENT_NOTICES, COMMENT_POST_PATH, COMMENT_REPLY_PARAM, commentForm, refilledCommentForm, signedInCommentForm, valuesOf, } from './form.js';
 export { renderCommentMarkdown } from './markdown.js';
 export { isModerationAction, moderateComment, MODERATION_ACTIONS } from './moderate.js';
-export { COMMENTS_FRONT_MATTER_KEY, commentPolicyOf, commentsOpen, DEFAULT_COMMENTS_CLOSE_AFTER_DAYS, } from './policy.js';
-export { addComment, COMMENT_EMAILS_DIRECTORY, COMMENT_EMAILS_FILE_MODE, commentEmailsFile, COMMENTS_DATA_DIRECTORY, commentsDirectory, commentsFile, deleteComment, followAllMovedComments, followMovedComments, heldWebmention, intakeComment, migrateCommentEmails, migrateCommentKeys, putComments, renameComments, readComments, rebuildCommentIndexes, updateComment, } from './records.js';
-export { commentFormFor, commentNoticeFor, mountComments } from './routes.js';
+export { COMMENTS_FRONT_MATTER_KEY } from '../content/comments.js';
+export { commentPolicyOf, commentsOpen } from './policy.js';
+export { DEFAULT_COMMENTS_CLOSE_AFTER_DAYS } from '../site/settings.js';
+export { addComment, COMMENT_EMAILS_DIRECTORY, COMMENT_EMAILS_FILE_MODE, commentEmailsFile, COMMENTS_DATA_DIRECTORY, commentsDirectory, commentsFile, deleteComment, followAllMovedComments, followMovedComments, putComments, renameComments, readComments, rebuildCommentIndexes, updateComment, } from './records.js';
+export { heldWebmention, intakeComment } from './intake.js';
+export { migrateCommentEmails, migrateCommentKeys } from './migrations.js';
+export { commentFormFor, commentNoticeFor } from './page-form.js';
 export { COMMENT_FIELDS, COMMENT_RATE_LIMIT, COMMENT_RATE_WINDOW_SECONDS, COMMENT_SALT_FILE, commentKeys, commentProblems, hashClientAddress, MAXIMUM_BODY_LENGTH, MAXIMUM_NAME_LENGTH, MAXIMUM_URL_LENGTH, MAXIMUM_FORM_AGE_SECONDS, MINIMUM_SUBMIT_SECONDS, normalizeWebsite, submitComment, } from './submission.js';
-export { signedInCommenter } from './viewer.js';
 //# sourceMappingURL=index.js.map

package/dist/comments/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/comments/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AAOtB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,QAAQ,GACT,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExF,OAAO,EACL,yBAAyB,EACzB,eAAe,EACf,YAAY,EACZ,iCAAiC,GAClC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAC;AAatB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,2BAA2B,EAC3B,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAczB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/comments/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AAOtB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,QAAQ,GACT,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExF,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQ5D,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,2BAA2B,EAC3B,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC"}