@geekity/cms 0.3.0 → 0.4.0

package/dist/contact/form.js

@@ -0,0 +1,163 @@
+import { FORM_LOADED_FIELD, FORM_TRAP_FIELD } from '../forms/protection.js';
+/**
+ * The contact form: what it is called, what it carries, and when a page has
+ * one at all.
+ *
+ * A page opts in with `contact: true` in its front matter — one key, ignored by
+ * Eleventy, the same shape as `navigation: true` — and the theme renders
+ * `partials/contact-form.njk` under the page's content. Nothing about where the
+ * message goes is here or anywhere the template can reach: the address is read
+ * when a submission arrives, so it cannot appear in the HTML however a theme is
+ * written.
+ */
+/** The front matter key a page opts in with. */
+export const CONTACT_FRONT_MATTER_KEY = 'contact';
+/** Where the contact form posts, under the CMS's own prefix. */
+export const CONTACT_POST_PATH = '/_geekity/contact';
+/** The query the redirect after a submission carries. */
+export const CONTACT_NOTICE_PARAM = 'contact';
+/** The anchor the form and its thank-you sit at, so a redirect lands on them. */
+export const CONTACT_ANCHOR = 'contact';
+/**
+ * What that query means, and what the sender is told.
+ *
+ * A redirect rather than a rendered page, so a refresh does not send the
+ * message a second time; a query rather than a flash, because a visitor has no
+ * session to hang one on.
+ */
+export const CONTACT_NOTICES = {
+    sent: 'Thank you — your message has been sent.',
+};
+/** The fields the contact form submits. */
+export const CONTACT_FIELDS = {
+    /** Which page the form was on, as its slug. */
+    page: 'page',
+    /** The sender's name. Required. */
+    name: 'name',
+    /** Their email, which the message replies to. Required. */
+    email: 'email',
+    /** What it is about. Optional. */
+    subject: 'subject',
+    /** The message itself, as plain text. Required. */
+    message: 'message',
+    /** The honeypot, which every public form here spells the same way. */
+    trap: FORM_TRAP_FIELD,
+    /** When the form was rendered, in epoch milliseconds. */
+    loaded: FORM_LOADED_FIELD,
+};
+/** The longest a name may be. */
+export const MAXIMUM_CONTACT_NAME_LENGTH = 80;
+/** The longest an email address may be. */
+export const MAXIMUM_CONTACT_EMAIL_LENGTH = 500;
+/** The longest a subject may be. */
+export const MAXIMUM_CONTACT_SUBJECT_LENGTH = 200;
+/** The longest a message may be, in characters. */
+export const MAXIMUM_CONTACT_MESSAGE_LENGTH = 10_000;
+/** Whether this document offers a contact form. */
+export function contactOpen(document) {
+    return document.extra[CONTACT_FRONT_MATTER_KEY] === true;
+}
+/** A fresh, empty form for a page that asked for one. */
+export function contactForm(document, now = new Date()) {
+    return refilledContactForm(document, blankContactValues(), {}, now);
+}
+/**
+ * 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 message.
+ */
+export function refilledContactForm(document, values, problems, now = new Date(), error) {
+    return {
+        action: CONTACT_POST_PATH,
+        fields: CONTACT_FIELDS,
+        page: document.slug,
+        loaded: String(now.getTime()),
+        values,
+        problems,
+        nameLength: MAXIMUM_CONTACT_NAME_LENGTH,
+        subjectLength: MAXIMUM_CONTACT_SUBJECT_LENGTH,
+        messageLength: MAXIMUM_CONTACT_MESSAGE_LENGTH,
+        ...(error === undefined ? {} : { error }),
+    };
+}
+/** What a form holds before anybody has typed in it. */
+export function blankContactValues() {
+    return { name: '', email: '', subject: '', message: '' };
+}
+/** What a submitted form typed, for putting back in a refused one. */
+export function contactValuesOf(form) {
+    return {
+        name: form.name,
+        email: form.email,
+        subject: form.subject,
+        message: form.message,
+    };
+}
+/**
+ * The form for a document, or `undefined` when it does not offer one.
+ *
+ * What the renderer is handed at boot, and asked per render: a `contact: true`
+ * added to a page in the editor puts a form on it on the very next request.
+ */
+export function contactFormFor(options) {
+    if (!contactOpen(options.document))
+        return undefined;
+    return contactForm(options.document, options.now);
+}
+/**
+ * The thank-you a sender is shown after a submission, from the query the
+ * redirect carried, or `undefined` when the URL says nothing.
+ *
+ * An unknown value says nothing at all rather than being printed, so the query
+ * cannot be used to put words on somebody's page.
+ */
+export function contactNoticeFor(query) {
+    return query === undefined ? undefined : CONTACT_NOTICES[query];
+}
+/**
+ * What is wrong with a submitted form, as a person would be told it.
+ *
+ * Only the things a person can fix. The honeypot, the form's age and the rate
+ * limit are not here: none of them is the sender's mistake, and two of them
+ * should not be explained to whoever tripped them.
+ */
+export function contactProblems(form) {
+    const problems = {};
+    const name = form.name.trim();
+    if (name === '')
+        problems.name = 'A message needs a name to come from.';
+    else if (name.length > MAXIMUM_CONTACT_NAME_LENGTH) {
+        problems.name = `That name is longer than ${String(MAXIMUM_CONTACT_NAME_LENGTH)} characters.`;
+    }
+    // Required, unlike a comment's, because the whole message is a request for
+    // an answer: a reply-to is what the site is being asked for.
+    const email = form.email.trim();
+    if (email === '')
+        problems.email = 'A message needs an address to reply to.';
+    else if (!isEmail(email))
+        problems.email = 'That does not look like an email address.';
+    if (form.subject.trim().length > MAXIMUM_CONTACT_SUBJECT_LENGTH) {
+        problems.subject = `That subject is longer than ${String(MAXIMUM_CONTACT_SUBJECT_LENGTH)} characters.`;
+    }
+    const message = form.message.trim();
+    if (message === '')
+        problems.message = 'A message needs something in it.';
+    else if (message.length > MAXIMUM_CONTACT_MESSAGE_LENGTH) {
+        problems.message = `That message is longer than ${String(MAXIMUM_CONTACT_MESSAGE_LENGTH)} characters.`;
+    }
+    return problems;
+}
+/**
+ * Whether something looks like an email address.
+ *
+ * Deliberately loose, and the same rule the comment form uses: the only thing
+ * a stricter one would buy is refusing valid addresses. Whether it can be
+ * delivered to is a question the provider answers.
+ */
+function isEmail(value) {
+    if (value.length > MAXIMUM_CONTACT_EMAIL_LENGTH)
+        return false;
+    return /^[^\s@]+@[^\s@.]+(\.[^\s@.]+)+$/.test(value);
+}
+//# sourceMappingURL=form.js.map

package/dist/contact/form.js.map

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

package/dist/contact/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The contact form (TASK-56): a page that offers one, the defences in front of
+ * it, the file every message lands in, and the mail that carries it.
+ *
+ * The barrel every other module and the package index import from, so nothing
+ * outside here has to know which file a name lives in.
+ */
+export { blankContactValues, CONTACT_ANCHOR, CONTACT_FIELDS, CONTACT_FRONT_MATTER_KEY, CONTACT_NOTICE_PARAM, CONTACT_NOTICES, CONTACT_POST_PATH, contactForm, contactFormFor, contactNoticeFor, contactOpen, contactProblems, contactValuesOf, MAXIMUM_CONTACT_EMAIL_LENGTH, MAXIMUM_CONTACT_MESSAGE_LENGTH, MAXIMUM_CONTACT_NAME_LENGTH, MAXIMUM_CONTACT_SUBJECT_LENGTH, refilledContactForm, } from './form.ts';
+export type { ContactForm, ContactFormContext, ContactProblems } from './form.ts';
+export { addContactMessage, CONTACT_DATA_DIRECTORY, contactDirectory, contactMessageFile, contactMessageId, countContactMessagesByStatus, countUnreadContactMessages, deleteContactMessage, listContactMessages, readContactMessage, setContactMessageRead, } from './records.ts';
+export type { ContactMessage, ContactStatus, NewContactMessage } from './records.ts';
+export { CONTACT_RATE_LIMIT, CONTACT_RATE_WINDOW_SECONDS, contactKeys, submitContactMessage, } from './submission.ts';
+export type { ContactOutcome, ContactRefusal, ContactThrottle, SubmitContactMessageOptions, } from './submission.ts';
+export { CONTACT_MESSAGE_TEMPLATE, contactRecipient, sendContactMessage } from './delivery.ts';
+export type { ContactRecipientOptions, SendContactMessageOptions } from './delivery.ts';
+export { mountContact } from './routes.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contact/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,eAAe,EACf,4BAA4B,EAC5B,8BAA8B,EAC9B,2BAA2B,EAC3B,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAElF,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,4BAA4B,EAC5B,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAErF,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,WAAW,EACX,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC/F,YAAY,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAExF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/contact/index.js

@@ -0,0 +1,13 @@
+/**
+ * The contact form (TASK-56): a page that offers one, the defences in front of
+ * it, the file every message lands in, and the mail that carries it.
+ *
+ * The barrel every other module and the package index import from, so nothing
+ * outside here has to know which file a name lives in.
+ */
+export { blankContactValues, CONTACT_ANCHOR, CONTACT_FIELDS, CONTACT_FRONT_MATTER_KEY, CONTACT_NOTICE_PARAM, CONTACT_NOTICES, CONTACT_POST_PATH, contactForm, contactFormFor, contactNoticeFor, contactOpen, contactProblems, contactValuesOf, MAXIMUM_CONTACT_EMAIL_LENGTH, MAXIMUM_CONTACT_MESSAGE_LENGTH, MAXIMUM_CONTACT_NAME_LENGTH, MAXIMUM_CONTACT_SUBJECT_LENGTH, refilledContactForm, } from './form.js';
+export { addContactMessage, CONTACT_DATA_DIRECTORY, contactDirectory, contactMessageFile, contactMessageId, countContactMessagesByStatus, countUnreadContactMessages, deleteContactMessage, listContactMessages, readContactMessage, setContactMessageRead, } from './records.js';
+export { CONTACT_RATE_LIMIT, CONTACT_RATE_WINDOW_SECONDS, contactKeys, submitContactMessage, } from './submission.js';
+export { CONTACT_MESSAGE_TEMPLATE, contactRecipient, sendContactMessage } from './delivery.js';
+export { mountContact } from './routes.js';
+//# sourceMappingURL=index.js.map

package/dist/contact/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contact/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,eAAe,EACf,4BAA4B,EAC5B,8BAA8B,EAC9B,2BAA2B,EAC3B,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,4BAA4B,EAC5B,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,WAAW,EACX,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAG/F,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/contact/records.d.ts

@@ -0,0 +1,124 @@
+/**
+ * A contact message as the file that holds it.
+ *
+ * decision-9 makes the filesystem the source of truth for everything durable,
+ * and a message somebody typed into this site is exactly that: nothing else
+ * holds it, and no other server can be asked for it again. So it is written to
+ * disk **before** anything is emailed, which is the point — a provider that is
+ * down, a key that has expired, an address that bounces, and the message is
+ * still on the Messages screen tomorrow.
+ *
+ * Two things separate this from the comment files:
+ *
+ * - **It lives under `data/`, not under `content/`.** A message carries the
+ *   sender's email address and was never meant to be published; `content/` is
+ *   in git and is copied to the public site by an Eleventy build.
+ * - **There is no SQLite index.** A contact inbox is tens or hundreds of
+ *   files, the screen reads all of them to sort them anyway, and an index
+ *   would be a second thing to keep true for no query it makes faster. Files
+ *   are truth here with nothing derived from them at all.
+ *
+ * One JSON file per message, named by its id, which starts with the instant it
+ * arrived — so `ls` is the inbox in order, and so no two messages can collide.
+ */
+/** Where the messages live, relative to the data directory. */
+export declare const CONTACT_DATA_DIRECTORY = "contact";
+/** The absolute path of one site's `data/contact`. */
+export declare function contactDirectory(dataDir: string): string;
+/**
+ * What became of a submission, as the file records it.
+ *
+ * `spam` is a checker's opinion rather than a person's, and the message is
+ * kept and shown on a list of its own rather than thrown away: a false
+ * positive on a contact form is a customer whose message vanished, which is a
+ * worse failure than a spam list somebody has to glance at. Nothing else is
+ * ever written — a submission the honeypot, the clock or the rate limit
+ * refused leaves no file at all, because storing those would hand an anonymous
+ * caller a way to fill the disk.
+ */
+export type ContactStatus = 'received' | 'spam';
+/** One contact message, as its file says it. */
+export interface ContactMessage {
+    /** Its id, which is its filename and starts with the instant it arrived. */
+    id: string;
+    /** When it arrived, as a UTC instant. */
+    received: string;
+    /** Whether a checker thought it was spam. */
+    status: ContactStatus;
+    /** Whether somebody has read it on the Messages screen. */
+    read: boolean;
+    /** The page the form was on. */
+    page: {
+        /** Its slug. */
+        slug: string;
+        /** Its permalink, so the screen can link to where the form was. */
+        permalink: string;
+        /** Its title at the time, so a page since renamed still reads sensibly. */
+        title: string;
+    };
+    /** Who sent it. */
+    from: {
+        /** The name they gave. */
+        name: string;
+        /** The address they gave, which the message replies to. */
+        email: string;
+    };
+    /** What it is about. May be empty. */
+    subject: string;
+    /** The message itself, as plain text. */
+    message: string;
+    /**
+     * A salted hash of the address it came from, or `null` when the site could
+     * not tell. The same hash a comment keeps, so a run from one machine is
+     * visible across both.
+     */
+    addressHash: string | null;
+}
+/** A message on its way in, before it has been given an id. */
+export type NewContactMessage = Omit<ContactMessage, 'id' | 'read'> & {
+    /** Whether it has been read. Defaults to no, which is what a new one is. */
+    read?: boolean | undefined;
+};
+/**
+ * The id a message received at this instant gets.
+ *
+ * The instant first, compacted so it is one filename-safe token, and then
+ * enough randomness that two messages in the same millisecond cannot collide.
+ */
+export declare function contactMessageId(received: Date): string;
+/** The absolute path of one message's file. */
+export declare function contactMessageFile(dataDir: string, id: string): string;
+/**
+ * Write a message, and hand back what was written.
+ *
+ * The id is minted here rather than by the caller, so the only thing that
+ * decides what a message is called is the thing that stores it.
+ */
+export declare function addContactMessage(dataDir: string, message: NewContactMessage): Promise<ContactMessage>;
+/**
+ * Every message the directory holds, newest first.
+ *
+ * A file that will not parse is skipped rather than thrown over: a directory
+ * somebody has been editing by hand should cost that message rather than take
+ * the Messages screen down, and the file is still there to be looked at.
+ */
+export declare function listContactMessages(dataDir: string, options?: {
+    status?: ContactStatus | undefined;
+}): ContactMessage[];
+/** How many messages are waiting to be read, which is the number on the dashboard. */
+export declare function countUnreadContactMessages(dataDir: string): number;
+/** How many messages each list holds, for the tabs on the Messages screen. */
+export declare function countContactMessagesByStatus(dataDir: string): Record<ContactStatus, number>;
+/** One message, or `undefined` for an id nothing is filed under. */
+export declare function readContactMessage(dataDir: string, id: string): ContactMessage | undefined;
+/**
+ * Mark a message read, or unread again, and hand back what it now says.
+ *
+ * The file is re-read inside the write, so two admins with the screen open
+ * cannot make one of them undo the other's delete by writing back a message
+ * that is not there any more.
+ */
+export declare function setContactMessageRead(dataDir: string, id: string, read: boolean): Promise<ContactMessage | undefined>;
+/** Delete a message. `false` when there was nothing of that id to delete. */
+export declare function deleteContactMessage(dataDir: string, id: string): Promise<boolean>;
+//# sourceMappingURL=records.d.ts.map

package/dist/contact/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/contact/records.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;AAEhD,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,EAAE,aAAa,CAAC;IACtB,2DAA2D;IAC3D,IAAI,EAAE,OAAO,CAAC;IACd,gCAAgC;IAChC,IAAI,EAAE;QACJ,gBAAgB;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,mEAAmE;QACnE,SAAS,EAAE,MAAM,CAAC;QAClB,2EAA2E;QAC3E,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,mBAAmB;IACnB,IAAI,EAAE;QACJ,0BAA0B;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,2DAA2D;QAC3D,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG;IACpE,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,CAGvD;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,cAAc,CAAC,CAgBzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;CAAO,GACnD,cAAc,EAAE,CAalB;AAED,sFAAsF;AACtF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAI3F;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAO1F;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAmBrC;AAED,6EAA6E;AAC7E,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASxF"}

package/dist/contact/records.js

@@ -0,0 +1,218 @@
+import { randomBytes } from 'node:crypto';
+import { readdirSync } from 'node:fs';
+import { rm } from 'node:fs/promises';
+import path from 'node:path';
+import { readFileIfPresentSync, withFileLock, writeFileAtomically, writeFileAtomicallySync, } from '../files/atomic.js';
+/**
+ * A contact message as the file that holds it.
+ *
+ * decision-9 makes the filesystem the source of truth for everything durable,
+ * and a message somebody typed into this site is exactly that: nothing else
+ * holds it, and no other server can be asked for it again. So it is written to
+ * disk **before** anything is emailed, which is the point — a provider that is
+ * down, a key that has expired, an address that bounces, and the message is
+ * still on the Messages screen tomorrow.
+ *
+ * Two things separate this from the comment files:
+ *
+ * - **It lives under `data/`, not under `content/`.** A message carries the
+ *   sender's email address and was never meant to be published; `content/` is
+ *   in git and is copied to the public site by an Eleventy build.
+ * - **There is no SQLite index.** A contact inbox is tens or hundreds of
+ *   files, the screen reads all of them to sort them anyway, and an index
+ *   would be a second thing to keep true for no query it makes faster. Files
+ *   are truth here with nothing derived from them at all.
+ *
+ * One JSON file per message, named by its id, which starts with the instant it
+ * arrived — so `ls` is the inbox in order, and so no two messages can collide.
+ */
+/** Where the messages live, relative to the data directory. */
+export const CONTACT_DATA_DIRECTORY = 'contact';
+/** The absolute path of one site's `data/contact`. */
+export function contactDirectory(dataDir) {
+    return path.join(dataDir, CONTACT_DATA_DIRECTORY);
+}
+/**
+ * Ids a file may be named after: the instant, a dash and eight hex characters.
+ *
+ * Checked on the way in as well as on the way out, so an id off a form can
+ * never name a path — there is no separator, no dot and no letter outside the
+ * set in anything that matches.
+ */
+const SAFE_ID = /^[0-9]{8}T[0-9]{9}Z-[0-9a-f]{8}$/;
+/**
+ * The id a message received at this instant gets.
+ *
+ * The instant first, compacted so it is one filename-safe token, and then
+ * enough randomness that two messages in the same millisecond cannot collide.
+ */
+export function contactMessageId(received) {
+    const stamp = received.toISOString().replace(/[-:.]/g, '');
+    return `${stamp}-${randomBytes(4).toString('hex')}`;
+}
+/** The absolute path of one message's file. */
+export function contactMessageFile(dataDir, id) {
+    if (!SAFE_ID.test(id)) {
+        throw new Error(`"${id}" is not an id a contact message file can be named after.`);
+    }
+    return path.join(contactDirectory(dataDir), `${id}.json`);
+}
+/**
+ * Write a message, and hand back what was written.
+ *
+ * The id is minted here rather than by the caller, so the only thing that
+ * decides what a message is called is the thing that stores it.
+ */
+export async function addContactMessage(dataDir, message) {
+    const stored = {
+        ...message,
+        id: contactMessageId(new Date(message.received)),
+        read: message.read ?? false,
+    };
+    await writeFileAtomically(contactMessageFile(dataDir, stored.id), `${JSON.stringify(stored, null, 2)}\n`, 
+    // The sender's address is in here, so the file is the site's own to read
+    // and nobody else's, exactly like the credentials beside it.
+    { mode: 0o600 });
+    return stored;
+}
+/**
+ * Every message the directory holds, newest first.
+ *
+ * A file that will not parse is skipped rather than thrown over: a directory
+ * somebody has been editing by hand should cost that message rather than take
+ * the Messages screen down, and the file is still there to be looked at.
+ */
+export function listContactMessages(dataDir, options = {}) {
+    const messages = [];
+    for (const id of contactMessageIds(dataDir)) {
+        const message = readContactMessage(dataDir, id);
+        if (message === undefined)
+            continue;
+        if (options.status !== undefined && message.status !== options.status)
+            continue;
+        messages.push(message);
+    }
+    // By id, which begins with the instant, so the order is chronological
+    // without a date having to be parsed for every comparison.
+    return messages.sort((one, other) => (one.id < other.id ? 1 : one.id > other.id ? -1 : 0));
+}
+/** How many messages are waiting to be read, which is the number on the dashboard. */
+export function countUnreadContactMessages(dataDir) {
+    return listContactMessages(dataDir).filter((message) => !message.read).length;
+}
+/** How many messages each list holds, for the tabs on the Messages screen. */
+export function countContactMessagesByStatus(dataDir) {
+    const counts = { received: 0, spam: 0 };
+    for (const message of listContactMessages(dataDir))
+        counts[message.status] += 1;
+    return counts;
+}
+/** One message, or `undefined` for an id nothing is filed under. */
+export function readContactMessage(dataDir, id) {
+    if (!SAFE_ID.test(id))
+        return undefined;
+    const raw = readFileIfPresentSync(contactMessageFile(dataDir, id));
+    if (raw === undefined)
+        return undefined;
+    return messageFrom(raw, id);
+}
+/**
+ * Mark a message read, or unread again, and hand back what it now says.
+ *
+ * The file is re-read inside the write, so two admins with the screen open
+ * cannot make one of them undo the other's delete by writing back a message
+ * that is not there any more.
+ */
+export async function setContactMessageRead(dataDir, id, read) {
+    if (!SAFE_ID.test(id))
+        return undefined;
+    const file = contactMessageFile(dataDir, id);
+    // The read, the change and the write inside one lock, with the writer that
+    // does not queue: a message deleted while this screen was open must not be
+    // written back by a Mark read that arrived a moment later.
+    return await withFileLock(file, () => {
+        const current = readFileIfPresentSync(file);
+        if (current === undefined)
+            return undefined;
+        const message = messageFrom(current, id);
+        if (message === undefined)
+            return undefined;
+        const updated = { ...message, read };
+        writeFileAtomicallySync(file, `${JSON.stringify(updated, null, 2)}\n`, { mode: 0o600 });
+        return updated;
+    });
+}
+/** Delete a message. `false` when there was nothing of that id to delete. */
+export async function deleteContactMessage(dataDir, id) {
+    if (!SAFE_ID.test(id))
+        return false;
+    const file = contactMessageFile(dataDir, id);
+    return await withFileLock(file, async () => {
+        if (readFileIfPresentSync(file) === undefined)
+            return false;
+        await rm(file, { force: true });
+        return true;
+    });
+}
+/** Every id the directory holds, unsorted. A missing directory is no messages. */
+function contactMessageIds(dataDir) {
+    let entries;
+    try {
+        entries = readdirSync(contactDirectory(dataDir));
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((name) => name.endsWith('.json'))
+        .map((name) => name.slice(0, -'.json'.length))
+        .filter((id) => SAFE_ID.test(id));
+}
+/**
+ * One file's bytes as the message it names, or `undefined` when they are not
+ * one.
+ *
+ * Read key by key and tolerantly, like every other file this CMS treats as
+ * truth: a message missing a field it should have is shown with that field
+ * empty rather than taking the screen down.
+ */
+function messageFrom(source, id) {
+    let parsed;
+    try {
+        parsed = JSON.parse(source);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return undefined;
+    const file = parsed;
+    const page = record(file['page']);
+    const from = record(file['from']);
+    const status = file['status'];
+    const addressHash = file['addressHash'];
+    return {
+        id,
+        received: text(file['received']),
+        status: status === 'spam' ? 'spam' : 'received',
+        read: file['read'] === true,
+        page: {
+            slug: text(page['slug']),
+            permalink: text(page['permalink']),
+            title: text(page['title']),
+        },
+        from: { name: text(from['name']), email: text(from['email']) },
+        subject: text(file['subject']),
+        message: text(file['message']),
+        addressHash: typeof addressHash === 'string' && addressHash !== '' ? addressHash : null,
+    };
+}
+/** One value as a string, or the empty one. */
+function text(value) {
+    return typeof value === 'string' ? value : '';
+}
+/** One value as an object, or an empty one. */
+function record(value) {
+    return typeof value === 'object' && value !== null ? value : {};
+}
+//# sourceMappingURL=records.js.map

package/dist/contact/records.js.map

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

package/dist/contact/routes.d.ts

@@ -0,0 +1,17 @@
+import type { Hono } from 'hono';
+import type { GeekityEnv } from '../env.ts';
+/**
+ * The one public endpoint the contact form adds: where the form on a page
+ * posts to.
+ *
+ * A single path rather than one per page because the page is a field of the
+ * form. That keeps it out of the way of every permalink a site might mint — a
+ * path under `/_geekity/` is the CMS's own, like the comment endpoint beside
+ * it — and means the route table does not grow with the site.
+ *
+ * Everything it answers is either a redirect or the page rendered again with
+ * the form still filled in. There is no JSON, no fragment and no script.
+ */
+/** Register the contact endpoint. Mounted by the public site. */
+export declare function mountContact(app: Hono<GeekityEnv>): void;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/contact/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAK1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAoB5C;;;;;;;;;;;GAWG;AAEH,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CA0FxD"}