@geekity/cms 0.3.0 → 0.4.0

package/dist/admin/media.js

@@ -0,0 +1,295 @@
+/**
+ * The media screen: what is under `content/uploads/`, what links to it, and
+ * the two things that can be done to it — add one, and take one away.
+ *
+ * The listing is a walk of the directory rather than a query, because the
+ * directory is the truth (decision-1, decision-9). Nothing records that a file
+ * exists; a file dropped in by hand over ssh, by a git pull, or by an Eleventy
+ * build is on the screen the next time it is asked for, and a file taken away
+ * the same way is off it. The only thing the index is asked is which documents
+ * mention a URL, which is a question a directory cannot answer.
+ */
+import { readdir, stat, unlink } from 'node:fs/promises';
+import path from 'node:path';
+import { UPLOAD_MEDIA_TYPES } from '../content/media.js';
+import { isTrashedPath } from '../content/store.js';
+import { removeImageVariants } from '../images/variants.js';
+import { UPLOAD_ASSET_PREFIX, UPLOAD_DIRECTORY } from '../web/assets.js';
+import { editorPath, PAGE_KIND, POST_KIND } from './documents.js';
+import { flash } from './flash.js';
+import { ADMIN_PREFIX } from './session.js';
+import { ADMIN_TEMPLATES } from './templates.js';
+import { refusedUpload, storeUpload, uploadMarkdown } from './uploads.js';
+/** Where the media screen lives. */
+export const MEDIA_PATH = `${ADMIN_PREFIX}/media`;
+/** The navigation section the screen marks as current. */
+export const MEDIA_SECTION = 'media';
+/** Where the screen's upload form posts. */
+export const MEDIA_UPLOAD_PATH = `${MEDIA_PATH}/upload`;
+/** Where a row's Delete button posts. */
+export const MEDIA_DELETE_PATH = `${MEDIA_PATH}/delete`;
+/** How many files one page of the library shows. */
+export const MEDIA_PER_PAGE = 24;
+/** The fields the forms on the media screen submit. */
+export const MEDIA_FIELDS = {
+    /** The file being added, on the upload form. */
+    file: 'file',
+    /** The upload being deleted, as a path under `content/uploads/`. */
+    path: 'path',
+    /** Set once the admin has been shown what still references the file. */
+    confirm: 'confirm',
+};
+/**
+ * Every file under `content/uploads/`, newest first.
+ *
+ * Recursive, because uploads land under `{yyyy}/{mm}/`, and a site that has
+ * been copying files in by hand may have any shape at all under there. The
+ * order is by modification time rather than by the dated path: the path is
+ * only a hint about when a file arrived, and a file dropped in by hand may
+ * have no dated path to read.
+ *
+ * A directory that does not exist yet is an empty library rather than an
+ * error — a site that has never uploaded anything has no `uploads/`.
+ */
+export async function listUploads(contentDir) {
+    const root = path.join(contentDir, UPLOAD_DIRECTORY);
+    let entries;
+    try {
+        entries = await readdir(root, { recursive: true, withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    const found = [];
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        // Hidden files are the operating system's business, not the site's:
+        // .DS_Store is not something anybody uploaded or wants to link to.
+        if (entry.name.startsWith('.'))
+            continue;
+        const file = path.join(entry.parentPath, entry.name);
+        const relative = path.relative(root, file).split(path.sep).join('/');
+        let stats;
+        try {
+            stats = await stat(file);
+        }
+        catch {
+            // It went away between the walk and the stat. Nothing to show.
+            continue;
+        }
+        found.push(describeUpload(relative, stats.size, stats.mtime));
+    }
+    // Newest first, and by path when two files share a timestamp, so a page of
+    // files copied in together has a stable order rather than the readdir one.
+    found.sort((left, right) => left.modified === right.modified
+        ? right.path.localeCompare(left.path)
+        : right.modified.localeCompare(left.modified));
+    return found;
+}
+/** One upload as the screen shows it, from what a directory walk knows. */
+export function describeUpload(relative, bytes, modified) {
+    const name = relative.slice(relative.lastIndexOf('/') + 1);
+    const extension = path.extname(name).toLowerCase();
+    const image = UPLOAD_MEDIA_TYPES.get(extension)?.image ?? false;
+    const url = `${UPLOAD_ASSET_PREFIX}${relative}`;
+    return {
+        path: relative,
+        url,
+        name,
+        extension,
+        bytes,
+        modified: modified.toISOString(),
+        image,
+        // The same Markdown the editor's upload control pastes, from the same
+        // function, so a file linked from the media screen and the same file
+        // linked from the editor are written identically.
+        markdown: uploadMarkdown({ url, label: name.slice(0, name.length - extension.length), image }),
+    };
+}
+/**
+ * Every document whose body mentions an upload's URL, trash included.
+ *
+ * The trash counts. A trashed post can be restored tomorrow, and restoring one
+ * whose picture was deleted in the meantime is a broken post nobody was warned
+ * about — so a file the trash still points at asks for confirmation exactly as
+ * a published one does.
+ *
+ * This is the one thing on the screen that comes out of the index rather than
+ * off the disk. The index is a cache of the files (decision-1), so it may be a
+ * moment behind a hand edit; that is acceptable here because the answer is a
+ * warning rather than a decision, and the confirmation step is what makes an
+ * out-of-date answer harmless in both directions.
+ */
+export function referencesTo(store, url) {
+    // Two queries rather than one because `listAll` shows the live tree or the
+    // trash and never both, which is the same reason the taxonomy screens ask
+    // twice.
+    return [...store.listAll({ trashed: false }), ...store.listAll({ trashed: true })]
+        .filter((document) => mentionsUpload(document.body, url))
+        .map((document) => ({
+        path: document.path,
+        title: document.title === '' ? document.path : document.title,
+        editUrl: editorPath(document.type === 'page' ? PAGE_KIND : POST_KIND, document.slug),
+        trashed: isTrashedPath(document.path),
+    }));
+}
+/**
+ * Whether a body points at an upload URL.
+ *
+ * A substring search with one guard on the end of it: `/uploads/a.png` must not
+ * count as a mention of `/uploads/a.pn`, and `/uploads/logo.png` must not count
+ * as a mention of `/uploads/logo`. Anything that could still be part of the
+ * same filename disqualifies the match; a quote, a bracket, a space or the end
+ * of the body ends it.
+ *
+ * Deliberately blind to whether the mention is Markdown, HTML or prose. All
+ * three break when the file goes, and a warning that only understood
+ * `![](…)` would be a warning that missed most of them.
+ */
+export function mentionsUpload(body, url) {
+    for (let at = body.indexOf(url); at !== -1; at = body.indexOf(url, at + 1)) {
+        const next = body[at + url.length];
+        if (next === undefined || !FILENAME_CHARACTER.test(next))
+            return true;
+    }
+    return false;
+}
+/** Characters that could still be part of the filename a match landed in. */
+const FILENAME_CHARACTER = /[A-Za-z0-9._~-]/;
+/**
+ * Delete one upload, and whatever was derived from it.
+ *
+ * Returns `false` when there was no such file, which is what a second click on
+ * a Delete button on a stale page is, rather than throwing: the end state the
+ * admin asked for is the end state they have.
+ */
+export async function deleteUpload(options) {
+    const file = resolveUpload(options.contentDir, options.path);
+    if (file === undefined)
+        return false;
+    try {
+        await unlink(file);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+        return false;
+    }
+    // After the original, so a hook that throws leaves a file with stale
+    // variants rather than variants with no file: the first is repairable by
+    // regenerating, the second is orphaned bytes.
+    await options.removeDerived?.(options.path);
+    return true;
+}
+/**
+ * A submitted path as an absolute file under `content/uploads/`, or
+ * `undefined` when it is not one.
+ *
+ * The path arrives in a form, so it is an attacker's string as much as an
+ * admin's. Containment is checked after resolution rather than by inspecting
+ * the string, so `..`, an encoded one, or an absolute path cannot slip past —
+ * the same rule {@link findAsset} applies to a request for a file.
+ */
+export function resolveUpload(contentDir, relative) {
+    if (relative === '' || relative.includes('\0'))
+        return undefined;
+    const root = path.resolve(contentDir, UPLOAD_DIRECTORY);
+    const file = path.resolve(root, relative);
+    if (!file.startsWith(root + path.sep))
+        return undefined;
+    return file;
+}
+/**
+ * Register the media screen: the library, the upload form and the delete.
+ *
+ * Uploading here is {@link storeUpload}, exactly as the editor's control and
+ * the avatar are, so what a site accepts is one answer given in one place
+ * rather than three screens that might disagree.
+ */
+export function mountMediaScreen(app, options) {
+    const { render, removeDerived } = options;
+    app.get(MEDIA_PATH, async (c) => render(c, ADMIN_TEMPLATES.media, await screen(c)));
+    app.post(MEDIA_UPLOAD_PATH, async (c) => {
+        const body = await c.req.parseBody();
+        const outcome = await storeUpload(body[MEDIA_FIELDS.file], c.var.config);
+        if (refusedUpload(outcome)) {
+            flash(c, 'error', `${outcome.error} Nothing was added.`);
+            return c.redirect(MEDIA_PATH, 303);
+        }
+        flash(c, 'notice', `Uploaded ${outcome.url}.`);
+        return c.redirect(MEDIA_PATH, 303);
+    });
+    app.post(MEDIA_DELETE_PATH, async (c) => {
+        const body = await c.req.parseBody();
+        const relative = field(body[MEDIA_FIELDS.path]);
+        const file = relative === '' ? undefined : resolveUpload(c.var.config.contentDir, relative);
+        if (file === undefined) {
+            flash(c, 'error', 'That is not a file in this site’s uploads.');
+            return c.redirect(MEDIA_PATH, 303);
+        }
+        const url = `${UPLOAD_ASSET_PREFIX}${relative}`;
+        const references = referencesTo(c.var.store, url);
+        // A file something still points at is offered rather than deleted: the
+        // bytes do not come back, and the documents naming them are the whole
+        // reason to think twice.
+        if (references.length > 0 && field(body[MEDIA_FIELDS.confirm]) === '') {
+            return render(c, ADMIN_TEMPLATES.media, await screen(c, { confirm: { path: relative, url, references } }));
+        }
+        const deleted = await deleteUpload({
+            contentDir: c.var.config.contentDir,
+            path: relative,
+            // The site's own image variants unless the caller named something else,
+            // so nothing has to be wired at the mount site for the ordinary case
+            // and a test can still watch the hook being called.
+            removeDerived: removeDerived ?? ((uploadPath) => removeImageVariants(c.var.config, uploadPath)),
+        });
+        flash(c, deleted ? 'notice' : 'error', deleted ? `Deleted ${url}.` : `There is no longer a file at ${url}.`);
+        return c.redirect(MEDIA_PATH, 303);
+    });
+    /** Everything the media template renders. */
+    async function screen(c, extra = {}) {
+        const files = await listUploads(c.var.config.contentDir);
+        const page = pageNumber(c.req.query('page'));
+        const start = (page - 1) * MEDIA_PER_PAGE;
+        return {
+            section: MEDIA_SECTION,
+            child: 'library',
+            heading: 'Media',
+            listUrl: MEDIA_PATH,
+            uploadUrl: MEDIA_UPLOAD_PATH,
+            deleteUrl: MEDIA_DELETE_PATH,
+            fields: MEDIA_FIELDS,
+            accepts: c.var.config.uploadTypes.join(','),
+            maxBytes: c.var.config.uploadMaxBytes,
+            total: files.length,
+            page,
+            pages: Math.max(1, Math.ceil(files.length / MEDIA_PER_PAGE)),
+            previousUrl: page > 1 ? mediaPageUrl(page - 1) : undefined,
+            nextUrl: start + MEDIA_PER_PAGE < files.length ? mediaPageUrl(page + 1) : undefined,
+            // Reference counts are one index scan per file on the page rather than
+            // per file in the library, which is what paging is for.
+            files: files.slice(start, start + MEDIA_PER_PAGE).map((file) => ({
+                ...file,
+                references: referencesTo(c.var.store, file.url),
+            })),
+            ...extra,
+        };
+    }
+}
+/** The URL of one page of the library. Page one is the screen's own URL. */
+export function mediaPageUrl(page) {
+    return page > 1 ? `${MEDIA_PATH}?page=${String(page)}` : MEDIA_PATH;
+}
+/** A `page` query as a page number. Anything that is not one is page one. */
+function pageNumber(value) {
+    const parsed = Number(value ?? '1');
+    return Number.isFinite(parsed) && parsed >= 1 ? Math.floor(parsed) : 1;
+}
+/** A form field as a string. A file upload, or a missing field, is the empty one. */
+function field(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+//# sourceMappingURL=media.js.map

package/dist/admin/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/admin/media.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE1E,oCAAoC;AACpC,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,YAAY,QAAQ,CAAC;AAElD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,UAAU,SAAS,CAAC;AAExD,yCAAyC;AACzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,UAAU,SAAS,CAAC;AAExD,oDAAoD;AACpD,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,gDAAgD;IAChD,IAAI,EAAE,MAAM;IACZ,oEAAoE;IACpE,IAAI,EAAE,MAAM;IACZ,wEAAwE;IACxE,OAAO,EAAE,SAAS;CACV,CAAC;AA0BX;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAkB;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAErD,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAClE,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,SAAS;QAC9B,oEAAoE;QACpE,mEAAmE;QACnE,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAEzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAErE,IAAI,KAAK,CAAC;QACV,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;YAC/D,SAAS;QACX,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,2EAA2E;IAC3E,2EAA2E;IAC3E,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACzB,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;QAC9B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QACrC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAChD,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,KAAa,EAAE,QAAc;IAC5E,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,KAAK,CAAC;IAChE,MAAM,GAAG,GAAG,GAAG,mBAAmB,GAAG,QAAQ,EAAE,CAAC;IAEhD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,GAAG;QACH,IAAI;QACJ,SAAS;QACT,KAAK;QACL,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE;QAChC,KAAK;QACL,sEAAsE;QACtE,qEAAqE;QACrE,kDAAkD;QAClD,QAAQ,EAAE,cAAc,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC;AAcD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,KAAmB,EAAE,GAAW;IAC3D,2EAA2E;IAC3E,0EAA0E;IAC1E,SAAS;IACT,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;SAC/E,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;SACxD,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK;QAC7D,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC;QACpF,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;KACtC,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAW;IACtD,KAAK,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACxE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6EAA6E;AAC7E,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAwB7C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAErC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qEAAqE;IACrE,yEAAyE;IACzE,8CAA8C;IAC9C,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,QAAgB;IAChE,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAEjE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAUD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAqB,EAAE,OAAgC;IACtF,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAE1C,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpF,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEzE,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,qBAAqB,CAAC,CAAC;YACzD,OAAO,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAE5F,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,4CAA4C,CAAC,CAAC;YAChE,OAAO,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,mBAAmB,GAAG,QAAQ,EAAE,CAAC;QAChD,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAElD,uEAAuE;QACvE,sEAAsE;QACtE,yBAAyB;QACzB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YACtE,OAAO,MAAM,CACX,CAAC,EACD,eAAe,CAAC,KAAK,EACrB,MAAM,MAAM,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC;YACjC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU;YACnC,IAAI,EAAE,QAAQ;YACd,wEAAwE;YACxE,qEAAqE;YACrE,oDAAoD;YACpD,aAAa,EACX,aAAa,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;SACnF,CAAC,CAAC;QAEH,KAAK,CACH,CAAC,EACD,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAC5B,OAAO,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,gCAAgC,GAAG,GAAG,CACrE,CAAC;QACF,OAAO,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,6CAA6C;IAC7C,KAAK,UAAU,MAAM,CACnB,CAAsB,EACtB,KAAK,GAA4B,EAAE;QAEnC,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC;QAE1C,OAAO;YACL,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,UAAU;YACnB,SAAS,EAAE,iBAAiB;YAC5B,SAAS,EAAE,iBAAiB;YAC5B,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;YAC3C,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc;YACrC,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,IAAI;YACJ,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;YAC5D,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;YAC1D,OAAO,EAAE,KAAK,GAAG,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;YACnF,uEAAuE;YACvE,wDAAwD;YACxD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC/D,GAAG,IAAI;gBACP,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC;aAChD,CAAC,CAAC;YACH,GAAG,KAAK;SACT,CAAC;IACJ,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,SAAS,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;AACtE,CAAC;AAED,6EAA6E;AAC7E,SAAS,UAAU,CAAC,KAAyB;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,qFAAqF;AACrF,SAAS,KAAK,CAAC,KAAc;IAC3B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/admin/menu.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The admin's left-hand menu: which sections there are, what is under each of
+ * them, and which one a screen is standing in.
+ *
+ * The shape is WordPress classic. A section is a heading with one or more
+ * children; clicking the heading opens the section and lands on its first
+ * child; the open section shows its children and the one you are on is marked.
+ * Every section has at least one child even when it has exactly one screen,
+ * because that is what makes the rule uniform — a second child can appear
+ * later without the menu changing shape, and no screen has to know whether it
+ * is the only one of its kind.
+ *
+ * The registry below is the whole menu. A screen names its section and its
+ * child, {@link adminMenu} turns that pair into the rendered list, and a pair
+ * the registry does not hold is refused rather than quietly rendered as a
+ * menu with nothing marked.
+ */
+/** One screen under a section, as the menu lists it. */
+export interface AdminMenuChild {
+    /** The name a screen passes as `child` to mark itself current. */
+    child: string;
+    /** What the link says. */
+    label: string;
+    /** Where it goes. */
+    url: string;
+}
+/** One top-level entry in the admin's left-hand navigation. */
+export interface AdminSection {
+    /** The name a screen passes as `section` to open it. */
+    section: string;
+    /** What the heading says. */
+    label: string;
+    /** Where the heading goes: its first child, always. */
+    url: string;
+    /** The screens under it, in the order they are shown. Never empty. */
+    children: readonly AdminMenuChild[];
+}
+/** A section as a screen renders it: the same entry, plus where you are. */
+export interface AdminMenuSection extends AdminSection {
+    /** Whether this is the section being looked at, so its children show. */
+    open: boolean;
+    /** Its children, each saying whether it is the screen being looked at. */
+    children: readonly AdminMenuCurrentChild[];
+}
+/** A child as a screen renders it. */
+export interface AdminMenuCurrentChild extends AdminMenuChild {
+    /** Whether this is the screen being looked at, for `aria-current`. */
+    current: boolean;
+}
+/** Where a screen says it is standing. */
+export interface AdminScreenLocation {
+    /** The section it is under. */
+    section?: string | undefined;
+    /** The child of that section it is. */
+    child?: string | undefined;
+}
+/** A screen naming a section or a child the registry does not hold. */
+export declare class UnknownAdminScreenError extends Error {
+    constructor(message: string);
+}
+/**
+ * The sections of the admin, in the order doc-5 lists them.
+ *
+ * Adding a screen to the menu is one entry in one of these `children` lists
+ * and the same `child` name on whatever the screen passes to `render`.
+ */
+export declare const ADMIN_SECTIONS: readonly AdminSection[];
+/**
+ * The whole menu, with the section a screen named open and the child it named
+ * marked current.
+ *
+ * A screen outside the shell — the login form, the two halves of forgetting a
+ * password — names neither, and gets a menu with nothing open, which is what
+ * the templates that never render it expect. Anything else has to name both:
+ * a section with no child is a screen that only knows half of where it is, and
+ * would render a menu that expands around nothing.
+ */
+export declare function adminMenu(location?: AdminScreenLocation): AdminMenuSection[];
+//# sourceMappingURL=menu.d.ts.map

package/dist/admin/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../src/admin/menu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CACrC;AAED,4EAA4E;AAC5E,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,yEAAyE;IACzE,IAAI,EAAE,OAAO,CAAC;IACd,0EAA0E;IAC1E,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC5C;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,uEAAuE;AACvE,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAsCjD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,QAAQ,GAAE,mBAAwB,GAAG,gBAAgB,EAAE,CA4BhF"}

package/dist/admin/menu.js

@@ -0,0 +1,126 @@
+/**
+ * The admin's left-hand menu: which sections there are, what is under each of
+ * them, and which one a screen is standing in.
+ *
+ * The shape is WordPress classic. A section is a heading with one or more
+ * children; clicking the heading opens the section and lands on its first
+ * child; the open section shows its children and the one you are on is marked.
+ * Every section has at least one child even when it has exactly one screen,
+ * because that is what makes the rule uniform — a second child can appear
+ * later without the menu changing shape, and no screen has to know whether it
+ * is the only one of its kind.
+ *
+ * The registry below is the whole menu. A screen names its section and its
+ * child, {@link adminMenu} turns that pair into the rendered list, and a pair
+ * the registry does not hold is refused rather than quietly rendered as a
+ * menu with nothing marked.
+ */
+import { THEMES_PATH } from './appearance.js';
+import { COMMENTS_PATH } from './comments.js';
+import { newEditorPath, PAGE_KIND, POST_KIND } from './documents.js';
+import { FEDERATION_PATH } from './federation.js';
+import { MEDIA_PATH } from './media.js';
+import { MESSAGES_PATH } from './messages.js';
+import { settingsPagePath } from './settings-page.js';
+import { ADMIN_PREFIX } from './session.js';
+import { CATEGORY_KIND, TAG_KIND } from './taxonomy.js';
+import { ADD_USER_PATH, USERS_PATH } from './users.js';
+/** A screen naming a section or a child the registry does not hold. */
+export class UnknownAdminScreenError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UnknownAdminScreenError';
+    }
+}
+/**
+ * The sections of the admin, in the order doc-5 lists them.
+ *
+ * Adding a screen to the menu is one entry in one of these `children` lists
+ * and the same `child` name on whatever the screen passes to `render`.
+ */
+export const ADMIN_SECTIONS = [
+    section('dashboard', 'Dashboard', [{ child: 'home', label: 'Home', url: ADMIN_PREFIX }]),
+    section('posts', 'Posts', [
+        { child: 'all', label: 'All posts', url: POST_KIND.basePath },
+        { child: 'new', label: 'Add new', url: newEditorPath(POST_KIND) },
+        // The terms live here rather than at the top level because that is what
+        // they are about: a tag with no post on it is nothing.
+        { child: 'categories', label: 'Categories', url: CATEGORY_KIND.basePath },
+        { child: 'tags', label: 'Tags', url: TAG_KIND.basePath },
+    ]),
+    section('pages', 'Pages', [
+        { child: 'all', label: 'All pages', url: PAGE_KIND.basePath },
+        { child: 'new', label: 'Add new', url: newEditorPath(PAGE_KIND) },
+    ]),
+    section('media', 'Media', [{ child: 'library', label: 'Library', url: MEDIA_PATH }]),
+    section('comments', 'Comments', [{ child: 'all', label: 'All comments', url: COMMENTS_PATH }]),
+    section('messages', 'Messages', [{ child: 'all', label: 'All messages', url: MESSAGES_PATH }]),
+    // In WordPress's place, between what the site holds and who may change it.
+    // One child, because the rule is uniform: a second kind of theme, or a menu
+    // editor, slots in beside Themes without the menu changing shape.
+    section('appearance', 'Appearance', [{ child: 'themes', label: 'Themes', url: THEMES_PATH }]),
+    section('users', 'Users', [
+        { child: 'all', label: 'All users', url: USERS_PATH },
+        { child: 'new', label: 'Add new', url: ADD_USER_PATH },
+    ]),
+    // WordPress's own pages, in its own order. General is first because the
+    // heading lands on the first child and General is `/admin/settings` itself.
+    section('settings', 'Settings', [
+        { child: 'general', label: 'General', url: settingsPagePath('general') },
+        { child: 'reading', label: 'Reading', url: settingsPagePath('reading') },
+        { child: 'permalinks', label: 'Permalinks', url: settingsPagePath('permalinks') },
+        { child: 'discussion', label: 'Discussion', url: settingsPagePath('discussion') },
+        { child: 'email', label: 'Email', url: settingsPagePath('email') },
+        { child: 'federation', label: 'Federation', url: settingsPagePath('federation') },
+    ]),
+    section('federation', 'Federation', [
+        { child: 'followers', label: 'Followers', url: FEDERATION_PATH },
+    ]),
+];
+/**
+ * The whole menu, with the section a screen named open and the child it named
+ * marked current.
+ *
+ * A screen outside the shell — the login form, the two halves of forgetting a
+ * password — names neither, and gets a menu with nothing open, which is what
+ * the templates that never render it expect. Anything else has to name both:
+ * a section with no child is a screen that only knows half of where it is, and
+ * would render a menu that expands around nothing.
+ */
+export function adminMenu(location = {}) {
+    const { section: name, child } = location;
+    if (name !== undefined) {
+        const found = ADMIN_SECTIONS.find((entry) => entry.section === name);
+        if (found === undefined) {
+            throw new UnknownAdminScreenError(`The admin menu has no section called ${quoted(name)}.`);
+        }
+        if (child === undefined) {
+            throw new UnknownAdminScreenError(`A screen under ${quoted(name)} named no child. Every admin screen is a child of its section.`);
+        }
+        if (!found.children.some((entry) => entry.child === child)) {
+            throw new UnknownAdminScreenError(`The admin menu's ${quoted(name)} section has no child called ${quoted(child)}.`);
+        }
+    }
+    return ADMIN_SECTIONS.map((entry) => ({
+        ...entry,
+        open: entry.section === name,
+        children: entry.children.map((item) => ({
+            ...item,
+            current: entry.section === name && item.child === child,
+        })),
+    }));
+}
+/** One section, landing on the first of its children. */
+function section(name, label, children) {
+    const [first] = children;
+    // Not reachable from the registry above, which names children for every
+    // section; it is here so the type of `url` is a string rather than a maybe.
+    if (first === undefined)
+        throw new Error(`The ${label} admin section has no children.`);
+    return { section: name, label, url: first.url, children };
+}
+/** A name as it reads in a message. */
+function quoted(value) {
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=menu.js.map

package/dist/admin/menu.js.map

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

package/dist/admin/messages.d.ts

@@ -0,0 +1,80 @@
+import type { Hono } from 'hono';
+import type { ContactStatus } from '../contact/records.ts';
+import type { GeekityEnv } from '../env.ts';
+import type { AdminRender } from './documents.ts';
+/**
+ * The inbox: what the contact form left behind (TASK-56).
+ *
+ * A message is a file under `data/contact/` and nothing else — there is no
+ * index, because this screen reads every file to sort them anyway and a second
+ * copy of the truth would only be a second thing to keep true. So the two
+ * actions here are a rewrite and an unlink, and the screen is a view of the
+ * directory as it is at that moment (decision-9).
+ *
+ * Two lists rather than one. A checker's `spam` is an opinion about a message
+ * somebody may really have sent, so it is kept rather than thrown away — but a
+ * run of it must not bury the messages a person actually has to answer.
+ */
+/** Where the Messages screen lives. */
+export declare const MESSAGES_PATH = "/admin/messages";
+/** The navigation section it marks as current. */
+export declare const MESSAGES_SECTION = "messages";
+/** Where the Mark read and Mark unread buttons post. */
+export declare const MESSAGES_READ_PATH = "/admin/messages/read";
+/** Where the Delete button posts. */
+export declare const MESSAGES_DELETE_PATH = "/admin/messages/delete";
+/** The fields the forms on this screen submit. */
+export declare const MESSAGE_FIELDS: {
+    /** Which message a button is about. */
+    readonly id: 'id';
+    /** Whether Mark read means read or unread. Empty is unread. */
+    readonly read: 'read';
+    /** Which list to go back to afterwards. */
+    readonly status: 'status';
+};
+/** How many messages one page of a list shows. */
+export declare const MESSAGES_PER_PAGE = 25;
+/** The two lists, in the order the screen offers them. */
+export declare const MESSAGE_TABS: readonly {
+    status: ContactStatus;
+    label: string;
+}[];
+/** One message as the screen shows it. */
+export interface MessageRow {
+    /** Its id, which the buttons carry. */
+    id: string;
+    /** Where it stands. */
+    status: ContactStatus;
+    /** Whether somebody has read it. */
+    read: boolean;
+    /** The name they gave. */
+    author: string;
+    /** Their address, which is what a reply goes to. */
+    email: string;
+    /** What it is about, or the empty string. */
+    subject: string;
+    /** What it says, as plain text. */
+    message: string;
+    /** When it arrived, in the site's own time zone. */
+    received: string;
+    /** A short form of the address hash, for spotting one machine's run of them. */
+    address: string | null;
+    /** The page the form was on. */
+    page: string;
+    /** Where that page can be read, or `null` when it has no permalink. */
+    pageUrl: string | null;
+    /** A `mailto:` that answers this message with its subject already filled in. */
+    replyUrl: string;
+}
+/** What {@link mountMessagesScreen} needs from the admin around it. */
+export interface MountMessagesScreenOptions {
+    /** The admin's renderer, which injects the chrome, the CSRF token and the flash. */
+    render: AdminRender;
+}
+/** Register the Messages screen. */
+export declare function mountMessagesScreen(app: Hono<GeekityEnv>, options: MountMessagesScreenOptions): void;
+/** How many messages are waiting to be read, which is the number on the dashboard. */
+export declare function unreadMessages(dataDir: string): number;
+/** Where one list of the inbox lives. */
+export declare function listUrl(status: ContactStatus, page?: number): string;
+//# sourceMappingURL=messages.d.ts.map

package/dist/admin/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/admin/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AASjC,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAOlD;;;;;;;;;;;;GAYG;AAEH,uCAAuC;AACvC,eAAO,MAAM,aAAa,oBAA6B,CAAC;AAExD,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAE3C,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,yBAA0B,CAAC;AAE1D,qCAAqC;AACrC,eAAO,MAAM,oBAAoB,2BAA4B,CAAC;AAE9D,kDAAkD;AAClD,eAAO,MAAM,cAAc;IACzB,uCAAuC;aACvC,EAAE,EAAE,IAAI;IACR,+DAA+D;aAC/D,IAAI,EAAE,MAAM;IACZ,2CAA2C;aAC3C,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,0DAA0D;AAC1D,eAAO,MAAM,YAAY,EAAE,SAAS;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAG3E,CAAC;AAEF,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,uEAAuE;AACvE,MAAM,WAAW,0BAA0B;IACzC,oFAAoF;IACpF,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,oCAAoC;AACpC,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,EACrB,OAAO,EAAE,0BAA0B,GAClC,IAAI,CAuFN;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,yCAAyC;AACzC,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,SAAI,GAAG,MAAM,CAG/D"}