@geekity/cms 0.3.0

package/dist/content/sync.js

@@ -0,0 +1,421 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { watch as watchPaths } from 'chokidar';
+import { parseDocument } from './parser.js';
+import { DuplicatePermalinkError, isTrashedPath, TRASH_DIRECTORY } from './store.js';
+/** File extensions the sync treats as documents. */
+const MARKDOWN_EXTENSIONS = new Set(['.md', '.markdown']);
+/** How long the watcher waits for a path to stop changing before re-reading it. */
+export const DEFAULT_DEBOUNCE_MS = 100;
+/** Directories that hold documents. Everything else in `content/` is not indexed. */
+const DOCUMENT_DIRECTORIES = new Map([
+    ['posts', 'post'],
+    ['pages', 'page'],
+]);
+/**
+ * Build the sync for one content directory.
+ *
+ * Files are the source of truth (decision-1). A scan parses every document
+ * under `content/`, writes the ones whose hash differs from the indexed row,
+ * and drops rows whose file has gone. Nothing else in the directory is
+ * touched: uploads, directory data files and every underscore-prefixed
+ * directory but `_trash` are skipped.
+ */
+export function createContentSync(options) {
+    const { store, contentDir } = options;
+    const logger = options.logger ?? console;
+    const events = createEmitter(logger);
+    /**
+     * Write a document, giving way to a file that has already gone.
+     *
+     * Renaming a file — which is what trashing and restoring are — briefly
+     * leaves two rows claiming one permalink, and the watcher may well see the
+     * new name before the old one disappears. When the conflicting row's file is
+     * no longer on disk the row is stale, so it is dropped (and reported) and
+     * the write retried. A conflict between two files that both exist is a
+     * content mistake and is left to the caller to report.
+     */
+    async function index(document, origin) {
+        try {
+            store.upsert(document);
+            return;
+        }
+        catch (error) {
+            if (!(error instanceof DuplicatePermalinkError))
+                throw error;
+            const conflicting = error.conflictingPath;
+            if (conflicting === undefined)
+                throw error;
+            if (await exists(path.join(contentDir, conflicting)))
+                throw error;
+            const stale = store.getByPath(conflicting);
+            store.remove(conflicting);
+            if (stale !== undefined) {
+                await emitChange(events, {
+                    type: 'deleted',
+                    path: conflicting,
+                    previous: stale,
+                    next: undefined,
+                    origin,
+                });
+            }
+            store.upsert(document);
+        }
+    }
+    async function reconcile(relativePath, origin) {
+        const previous = store.getByPath(relativePath);
+        const source = await readSource(path.join(contentDir, relativePath));
+        if (source === undefined) {
+            if (previous === undefined)
+                return false;
+            store.remove(relativePath);
+            await emitChange(events, {
+                type: 'deleted',
+                path: relativePath,
+                previous,
+                next: undefined,
+                origin,
+            });
+            return true;
+        }
+        let document;
+        try {
+            document = parseDocument(source, { path: relativePath });
+        }
+        catch (error) {
+            logger.warn(`Skipping ${relativePath}: ${messageOf(error)}`);
+            throw new SkippedFile();
+        }
+        // The hash covers the canonical file text, so a rewrite that changes
+        // nothing — an admin save, a touch, the watcher event that follows an
+        // admin write — costs no index write and emits no event.
+        if (previous !== undefined && previous.hash === document.hash)
+            return false;
+        try {
+            await index(document, origin);
+        }
+        catch (error) {
+            logger.warn(`Could not index ${relativePath}: ${messageOf(error)}`);
+            throw new SkippedFile();
+        }
+        await emitChange(events, {
+            type: previous === undefined ? 'created' : 'updated',
+            path: relativePath,
+            previous,
+            next: document,
+            origin,
+        });
+        return true;
+    }
+    async function scan() {
+        const result = {
+            scanned: 0,
+            created: 0,
+            updated: 0,
+            removed: 0,
+            unchanged: 0,
+            failed: 0,
+        };
+        const onDisk = await walk(contentDir, logger);
+        const seen = new Set(onDisk);
+        // Rows whose file has gone go first, so a document that was renamed —
+        // moving into or out of `_trash/` is a rename — does not collide with its
+        // own old row over the permalink they share.
+        for (const indexed of store.listPaths()) {
+            if (seen.has(indexed))
+                continue;
+            try {
+                if (await reconcile(indexed, 'scan'))
+                    result.removed += 1;
+            }
+            catch (error) {
+                if (!(error instanceof SkippedFile))
+                    throw error;
+                result.failed += 1;
+            }
+        }
+        for (const relativePath of onDisk) {
+            result.scanned += 1;
+            const existed = store.getByPath(relativePath) !== undefined;
+            try {
+                const wrote = await reconcile(relativePath, 'scan');
+                if (!wrote)
+                    result.unchanged += 1;
+                else if (existed)
+                    result.updated += 1;
+                else
+                    result.created += 1;
+            }
+            catch (error) {
+                if (!(error instanceof SkippedFile))
+                    throw error;
+                result.failed += 1;
+            }
+        }
+        return result;
+    }
+    // Watcher events are debounced per path and then handled one at a time, so
+    // a burst of writes to one file costs a single re-parse and two files that
+    // change together never interleave their index writes.
+    const pending = new Map();
+    let queue = Promise.resolve();
+    let watcher;
+    function handle(absolutePath) {
+        const relativePath = toRelative(contentDir, absolutePath);
+        if (relativePath === undefined || !isDocumentPath(relativePath))
+            return;
+        clearTimeout(pending.get(relativePath));
+        pending.set(relativePath, setTimeout(() => {
+            pending.delete(relativePath);
+            queue = queue.then(async () => {
+                try {
+                    await reconcile(relativePath, 'watch');
+                }
+                catch (error) {
+                    if (error instanceof SkippedFile)
+                        return;
+                    logger.warn(`Could not sync ${relativePath}: ${messageOf(error)}`);
+                }
+            });
+        }, options.debounceMs ?? DEFAULT_DEBOUNCE_MS));
+    }
+    async function startWatching() {
+        if (watcher !== undefined)
+            return;
+        const started = watchPaths(contentDir, {
+            ignored: (candidate, stats) => isIgnored(contentDir, candidate, stats),
+            ignoreInitial: true,
+            persistent: true,
+        });
+        watcher = started;
+        started.on('add', handle);
+        started.on('change', handle);
+        started.on('unlink', handle);
+        started.on('error', (error) => {
+            logger.warn(`Content watcher error: ${messageOf(error)}`);
+        });
+        await new Promise((resolve) => {
+            started.once('ready', () => resolve());
+        });
+    }
+    return {
+        events,
+        announce(change) {
+            return emitChange(events, change);
+        },
+        sync() {
+            return scan();
+        },
+        async start() {
+            const result = await scan();
+            if (options.watch !== false)
+                await startWatching();
+            return result;
+        },
+        async stop() {
+            for (const timer of pending.values())
+                clearTimeout(timer);
+            pending.clear();
+            const running = watcher;
+            watcher = undefined;
+            if (running !== undefined)
+                await running.close();
+            // Anything already past its debounce is allowed to finish, so stopping
+            // never leaves a half-applied write behind.
+            await queue;
+        },
+    };
+}
+/**
+ * Whether chokidar should skip a path: anything inside a directory the walk
+ * would not descend into, and any file that is not a document.
+ *
+ * chokidar calls this without stats before it knows what a path is, so a name
+ * that could be a directory is kept and filtered again when its event arrives.
+ */
+function isIgnored(contentDir, absolutePath, stats) {
+    const relativePath = toRelative(contentDir, absolutePath);
+    if (relativePath === undefined)
+        return false;
+    if (relativePath === '')
+        return false;
+    const segments = relativePath.split('/');
+    const name = segments.at(-1);
+    if (segments.slice(0, -1).some((segment) => !isWalkableDirectory(segment)))
+        return true;
+    if (stats?.isFile() === true)
+        return !isDocumentPath(relativePath);
+    return !isWalkableDirectory(name);
+}
+/** A watched absolute path as a content-relative one, or `undefined` if it is outside. */
+function toRelative(contentDir, absolutePath) {
+    const relativePath = path.relative(contentDir, absolutePath).replace(/\\/g, '/');
+    if (relativePath.startsWith('../') || path.isAbsolute(relativePath))
+        return undefined;
+    return relativePath;
+}
+/** Thrown inside a reconcile that logged and gave up on one file. */
+class SkippedFile extends Error {
+    name = 'SkippedFile';
+}
+/**
+ * Emit the primary change, then the visibility change it implies, and resolve
+ * once every listener has finished with all of them.
+ *
+ * The events go out in order rather than at once, so a subscriber that listens
+ * for both `created` and `published` sees them the way the names read.
+ */
+async function emitChange(events, change) {
+    await events.emit(change.type, change);
+    await events.emit('change', change);
+    const wasPublic = isPublic(change.previous);
+    const isNowPublic = isPublic(change.next);
+    if (isNowPublic && !wasPublic)
+        await events.emit('published', change);
+    else if (wasPublic && !isNowPublic)
+        await events.emit('unpublished', change);
+}
+/** A document is public when it exists, is not a draft and is not in the trash. */
+function isPublic(document) {
+    if (document === undefined)
+        return false;
+    return !document.draft && !isTrashedPath(document.path);
+}
+/** The file's text, or `undefined` when it is not there any more. */
+async function readSource(file) {
+    try {
+        return await readFile(file, 'utf8');
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return undefined;
+        throw error;
+    }
+}
+/** Whether a file is still on disk. */
+async function exists(file) {
+    try {
+        await stat(file);
+        return true;
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return false;
+        throw error;
+    }
+}
+function isNotFound(error) {
+    const code = error?.code;
+    return code === 'ENOENT' || code === 'ENOTDIR' || code === 'EISDIR';
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Every document file under the content directory, content-relative and
+ * sorted. A directory that cannot be read is reported and skipped rather than
+ * failing the whole walk.
+ */
+async function walk(contentDir, logger) {
+    const found = [];
+    async function visit(directory, prefix) {
+        let entries;
+        try {
+            entries = await readdir(directory, { withFileTypes: true });
+        }
+        catch (error) {
+            if (!isNotFound(error))
+                logger.warn(`Could not read ${directory}: ${messageOf(error)}`);
+            return;
+        }
+        for (const entry of entries) {
+            const relativePath = prefix === '' ? entry.name : `${prefix}/${entry.name}`;
+            if (entry.isDirectory()) {
+                if (!isWalkableDirectory(entry.name))
+                    continue;
+                await visit(path.join(directory, entry.name), relativePath);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            if (isDocumentPath(relativePath))
+                found.push(relativePath);
+        }
+    }
+    await visit(contentDir, '');
+    return found.sort();
+}
+/**
+ * Whether the walk descends into a directory. Eleventy ignores directories
+ * whose name starts with an underscore and so does the CMS, with one
+ * exception: the trash still holds documents, which stay indexed so the admin
+ * can restore them.
+ */
+function isWalkableDirectory(name) {
+    if (name === TRASH_DIRECTORY)
+        return true;
+    if (name.startsWith('_') || name.startsWith('.'))
+        return false;
+    return name !== 'node_modules';
+}
+/**
+ * Whether a content-relative path is a document: a Markdown file under a
+ * `posts/` or `pages/` directory. Uploads, directory data files and anything
+ * the CMS does not model are skipped without a word.
+ */
+function isDocumentPath(relativePath) {
+    if (!MARKDOWN_EXTENSIONS.has(path.extname(relativePath).toLowerCase()))
+        return false;
+    const segments = relativePath.split('/').slice(0, -1);
+    return segments.some((segment) => DOCUMENT_DIRECTORIES.has(segment));
+}
+function createEmitter(logger) {
+    const listeners = new Map();
+    function setFor(event) {
+        const existing = listeners.get(event);
+        if (existing !== undefined)
+            return existing;
+        const created = new Set();
+        listeners.set(event, created);
+        return created;
+    }
+    return {
+        on(event, listener) {
+            setFor(event).add(listener);
+            return () => {
+                listeners.get(event)?.delete(listener);
+            };
+        },
+        once(event, listener) {
+            const wrapped = (change) => {
+                listeners.get(event)?.delete(wrapped);
+                listener(change);
+            };
+            setFor(event).add(wrapped);
+            return () => {
+                listeners.get(event)?.delete(wrapped);
+            };
+        },
+        off(event, listener) {
+            listeners.get(event)?.delete(listener);
+        },
+        async emit(event, change) {
+            const registered = listeners.get(event);
+            if (registered === undefined)
+                return;
+            for (const listener of [...registered]) {
+                try {
+                    // A listener's return is ignored, but an `async` one hands back a
+                    // promise: awaiting it is what lets a subscriber that writes to disk
+                    // finish before the caller carries on, and what keeps a rejection
+                    // from escaping as an unhandled one.
+                    await listener(change);
+                }
+                catch (error) {
+                    logger.warn(`A ${event} listener threw: ${messageOf(error)}`);
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=sync.js.map

package/dist/content/sync.js.map

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

package/dist/content/writer.d.ts

@@ -0,0 +1,37 @@
+import type { DocumentContent } from './document.ts';
+/**
+ * Turn a Document back into the text of its Markdown file.
+ *
+ * Front matter keys are emitted in the order of
+ * {@link KNOWN_FRONT_MATTER_KEYS}, followed by the unmodelled keys in the order
+ * they were read, so an unchanged document always writes the same bytes and a
+ * real edit produces a small diff. Keys that carry no information — an empty
+ * tag list, `draft: false` — are left out.
+ */
+export declare function serializeDocument(document: DocumentContent): string;
+/**
+ * The writable half of a parsed document: what it would be written back from.
+ *
+ * A rewrite that means to change one thing has to carry everything else
+ * through untouched, and an optional field has to come back absent rather than
+ * `undefined`, or the front matter grows keys with no values. This is the one
+ * place that spelling lives, so a caller that only wants to add a key — the
+ * federation stamping `activitypub` into a post it has just announced — cannot
+ * quietly drop another.
+ */
+export declare function documentContent(document: DocumentContent): DocumentContent;
+/**
+ * Strip the whitespace a Markdown body does not need, so that files differing
+ * only in blank lines at the edges are the same document.
+ */
+export declare function normalizeBody(body: string): string;
+/**
+ * The front matter block a document would be written with: the keys the CMS
+ * models, in {@link KNOWN_FRONT_MATTER_KEYS} order, then the unmodelled ones.
+ *
+ * This is the same object {@link serializeDocument} dumps to YAML, so the JSON
+ * representation of a document and the Markdown file cannot disagree about
+ * what its front matter is.
+ */
+export declare function documentFrontMatter(document: DocumentContent): Record<string, unknown>;
+//# sourceMappingURL=writer.d.ts.map

package/dist/content/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/content/writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIrD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAMnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAc1E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBtF"}

package/dist/content/writer.js

@@ -0,0 +1,97 @@
+import { dump } from 'js-yaml';
+import { KNOWN_FRONT_MATTER_KEYS } from './document.js';
+const KNOWN_KEYS = new Set(KNOWN_FRONT_MATTER_KEYS);
+/**
+ * Turn a Document back into the text of its Markdown file.
+ *
+ * Front matter keys are emitted in the order of
+ * {@link KNOWN_FRONT_MATTER_KEYS}, followed by the unmodelled keys in the order
+ * they were read, so an unchanged document always writes the same bytes and a
+ * real edit produces a small diff. Keys that carry no information — an empty
+ * tag list, `draft: false` — are left out.
+ */
+export function serializeDocument(document) {
+    const frontMatter = documentFrontMatter(document);
+    const yaml = dump(frontMatter, { lineWidth: -1, noRefs: true });
+    const body = normalizeBody(document.body);
+    return body === '' ? `---\n${yaml}---\n` : `---\n${yaml}---\n\n${body}\n`;
+}
+/**
+ * The writable half of a parsed document: what it would be written back from.
+ *
+ * A rewrite that means to change one thing has to carry everything else
+ * through untouched, and an optional field has to come back absent rather than
+ * `undefined`, or the front matter grows keys with no values. This is the one
+ * place that spelling lives, so a caller that only wants to add a key — the
+ * federation stamping `activitypub` into a post it has just announced — cannot
+ * quietly drop another.
+ */
+export function documentContent(document) {
+    return {
+        title: document.title,
+        ...(document.date === undefined ? {} : { date: document.date }),
+        ...(document.updated === undefined ? {} : { updated: document.updated }),
+        permalink: document.permalink,
+        tags: [...document.tags],
+        draft: document.draft,
+        ...(document.description === undefined ? {} : { description: document.description }),
+        ...(document.author === undefined ? {} : { author: document.author }),
+        ...(document.activitypub === undefined ? {} : { activitypub: { ...document.activitypub } }),
+        extra: { ...document.extra },
+        body: document.body,
+    };
+}
+/**
+ * Strip the whitespace a Markdown body does not need, so that files differing
+ * only in blank lines at the edges are the same document.
+ */
+export function normalizeBody(body) {
+    return body.replace(/\r\n?/g, '\n').trim();
+}
+/**
+ * The front matter block a document would be written with: the keys the CMS
+ * models, in {@link KNOWN_FRONT_MATTER_KEYS} order, then the unmodelled ones.
+ *
+ * This is the same object {@link serializeDocument} dumps to YAML, so the JSON
+ * representation of a document and the Markdown file cannot disagree about
+ * what its front matter is.
+ */
+export function documentFrontMatter(document) {
+    const data = { title: document.title };
+    if (document.date !== undefined)
+        data['date'] = document.date;
+    if (document.updated !== undefined)
+        data['updated'] = document.updated;
+    data['permalink'] = document.permalink;
+    if (document.tags.length > 0)
+        data['tags'] = [...document.tags];
+    if (document.draft)
+        data['draft'] = true;
+    if (document.description !== undefined)
+        data['description'] = document.description;
+    if (document.author !== undefined)
+        data['author'] = document.author;
+    const activitypub = activityPubOf(document);
+    if (activitypub !== undefined)
+        data['activitypub'] = activitypub;
+    for (const [key, value] of Object.entries(document.extra)) {
+        if (KNOWN_KEYS.has(key))
+            continue;
+        if (value === undefined)
+            continue;
+        data[key] = value;
+    }
+    return data;
+}
+function activityPubOf(document) {
+    const block = document.activitypub;
+    if (block === undefined)
+        return undefined;
+    const out = {};
+    if (block.id !== undefined)
+        out['id'] = block.id;
+    if (block.published !== undefined)
+        out['published'] = block.published;
+    return Object.keys(out).length === 0 ? undefined : out;
+}
+//# sourceMappingURL=writer.js.map

package/dist/content/writer.js.map

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

package/dist/env.d.ts

@@ -0,0 +1,48 @@
+import type { AdminStore } from './admin/store.ts';
+import type { Session } from './admin/store.ts';
+import type { ResolvedConfig } from './config.ts';
+import type { ContentStore } from './content/store.ts';
+import type { DocumentChange } from './content/sync.ts';
+import type { DeliveryService } from './federation/delivery.ts';
+import type { Renderer } from './web/render.ts';
+/**
+ * What every Hono handler in the CMS can read off the context, so a route
+ * never has to be handed the store, the config or the theme by hand.
+ */
+export interface GeekityEnv {
+    Variables: {
+        /** The derived content index this CMS booted. */
+        store: ContentStore;
+        /** Users and sessions, the part of the database that is not derived. */
+        admin: AdminStore;
+        /** Config after defaults and environment overrides. */
+        config: ResolvedConfig;
+        /** The theme, for handlers that answer with HTML. */
+        renderer: Renderer;
+        /**
+         * Report a write this request made to the content directory.
+         *
+         * The admin corrects the index as soon as the bytes land rather than
+         * waiting for the watcher (doc-1), which means the watcher's later re-read
+         * of that file finds a matching hash and emits nothing. A handler that
+         * writes therefore has to say so, or no subscriber — a site's
+         * `onPublish` hook, the federation's delivery — ever hears about an admin
+         * save. The promise resolves once every listener has finished.
+         */
+        announce: (change: DocumentChange) => Promise<void>;
+        /**
+         * Outbound ActivityPub delivery, so a handler can send a recorded activity
+         * again. The federation screen's Redeliver button is the whole reason it is
+         * here: everything else about delivery happens off the index, away from any
+         * request.
+         */
+        delivery: DeliveryService;
+        /**
+         * The session this request carries, set by the admin guard: a login, the
+         * anonymous session that holds a CSRF token before login, or `undefined`
+         * outside `/admin` and for a request whose session has expired.
+         */
+        session: Session | undefined;
+    };
+}
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE;QACT,iDAAiD;QACjD,KAAK,EAAE,YAAY,CAAC;QACpB,wEAAwE;QACxE,KAAK,EAAE,UAAU,CAAC;QAClB,uDAAuD;QACvD,MAAM,EAAE,cAAc,CAAC;QACvB,qDAAqD;QACrD,QAAQ,EAAE,QAAQ,CAAC;QACnB;;;;;;;;;WASG;QACH,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACpD;;;;;WAKG;QACH,QAAQ,EAAE,eAAe,CAAC;QAC1B;;;;WAIG;QACH,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;KAC9B,CAAC;CACH"}

package/dist/env.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":""}