@geekity/cms 0.30.0 → 0.32.0

package/dist/cms/create.d.ts

@@ -0,0 +1,272 @@
+import type { Hono } from 'hono';
+import type { AdminStore } from '../admin/index.ts';
+import type { AvatarService } from '../avatars/index.ts';
+import type { DocumentChangeHook, GeekityConfig, ResolvedConfig } from '../config.ts';
+import type { ContentEvents, ContentStore, Scheduler, SyncResult } from '../content/index.ts';
+import type { GeekityEnv } from '../web/env.ts';
+import type { ReplyBackfill } from '../federation/backfill.ts';
+import type { ActorProfileService, DeliveryService, RelayService, SiteFederation } from '../federation/index.ts';
+import type { DataFileDeclaration } from '../files/data-files.ts';
+import type { IndexNowNotifier } from '../indexnow.ts';
+import type { JobQueue } from '../jobs/types.ts';
+import type { MailService, CommentDigest, CommentNotifier } from '../notifications/index.ts';
+import type { FeedNotifier, NotifyReport } from '../notify.ts';
+import type { InstalledPlugin } from '../plugins/registry.ts';
+import type { SettingsRegistry } from '../settings/types.ts';
+import type { RetentionService } from '../privacy/retention.ts';
+import type { Supervision } from '../supervisor/supervision.ts';
+import type { ReplyContextService, WebmentionService } from '../webmention/index.ts';
+/** A running (or runnable) CMS instance. */
+export interface Cms {
+    /**
+     * The Hono app. Sites may add their own routes before calling
+     * {@link Cms.serve}; handlers reach the index as `c.var.store`.
+     */
+    readonly app: Hono<GeekityEnv>;
+    /** Config after defaults and environment overrides were applied. */
+    readonly config: ResolvedConfig;
+    /** The content index, opened against {@link ResolvedConfig.dataDir} on boot. */
+    readonly store: ContentStore;
+    /**
+     * Everything in the database that is not the content index: the sessions,
+     * the followers and inbox indexes, the delivery outcomes, the relay
+     * handshake and the scheduler's watermark. In the same file as the index.
+     *
+     * All of it is derived or disposable (decision-9); the accounts and the
+     * actor's keys, which are not, are files under `dataDir`.
+     */
+    readonly admin: AdminStore;
+    /**
+     * Every runtime setting (decision-53): maintenance and dev mode so far, each
+     * read through the environment, the config, its file under `dataDir` and its
+     * default, and written by the admin and `geekity settings`.
+     */
+    readonly settings: SettingsRegistry;
+    /**
+     * Every declaration in effect for this site: core's, the
+  
+     * settings registry's, each loaded plugin's, and one for each folder under
+     * `data/plugins/` whose plugin is not loaded. A file under `dataDir` that
+     * none of them covers is a file nobody declared.
+     */
+    dataFiles(): DataFileDeclaration[];
+    /**
+     * The site's ActivityPub actor, already mounted on {@link Cms.app}: the
+     * actor document, WebFinger, NodeInfo, the inbox and the collections.
+     *
+     * It is exposed so a site — or a later milestone — may register more
+     * dispatchers and listeners on it, and so `ctx.sendActivity` has something
+     * to be called through when a post is published.
+     */
+    readonly federation: SiteFederation;
+    /**
+     * Outbound ActivityPub delivery: what sends a post to the followers when it
+     * is published, edited or withdrawn, and what an admin screen calls to send
+     * one of them as it now reads.
+     *
+     * It is already subscribed to the index; a site only reaches for it to
+     * resend a post, or to wait for the deliveries in flight.
+     */
+    readonly delivery: DeliveryService;
+    /**
+     * The admin job queue (decision-54): long actions queued by the admin or
+     * the CLI and run out of the request, with their status in
+     * `data/jobs.json`. Started by {@link Cms.serve}; a CLI command that is not
+     * serving queues a job and runs it here with `jobs.run(id)`.
+     */
+    readonly jobs: JobQueue;
+    /**
+     * The site's relay subscriptions (FEP-ae0c): what follows a relay when one
+     * is added to the settings, what an `Accept` marks accepted, and what every
+     * public activity is delivered to alongside the followers.
+     */
+    readonly relays: RelayService;
+    /**
+     * The site's outgoing webmentions: what tells the pages a post links to that
+     * it links to them, and what an admin screen calls to tell them again.
+     *
+     * It is already subscribed to the index; a site reaches for it to send one
+     * post's links again, or to wait for the ones in flight.
+     */
+    readonly webmentions: WebmentionService;
+    /**
+     * What a post shows of the page it answers, reposts, likes or bookmarks
+     * (TASK-123, TASK-244): fetched when the post is saved or synced, kept in
+     * `content/_data/replyContexts.json`, and read from there when a page is
+     * drawn. Already subscribed to the index; a site or a test reaches for it to
+     * wait for the fetches in flight.
+     */
+    readonly replyContexts: ReplyContextService;
+    /**
+     * The remote avatars a conversation shows, cached under `data/avatars/` and
+     * served from `/_geekity/avatars/` (TASK-134). Swept on a timer once the site
+     * serves; a site or a test reaches for it to sweep now or to wait.
+     */
+    readonly avatars: AvatarService;
+    /**
+     * The profiles of the fediverse actors who are not followers, cached in the
+     * database and fetched in the background (TASK-184). Swept on a timer once
+     * the site serves; a site or a test reaches for it to sweep now or to wait.
+     */
+    readonly actorProfiles: ActorProfileService;
+    /**
+     * The fediverse replies nobody delivered, read off the `replies`
+     * collections of the fediverse replies in recent threads (TASK-321). Swept
+     * on a timer once the site serves; a site or a test reaches for it to sweep
+     * now or to wait.
+     */
+    readonly replyBackfill: ReplyBackfill;
+    /**
+     * The sweep that removes commenter emails, address hashes and contact
+     * messages once they outlive the periods in the site's settings (TASK-135).
+     * Runs on a timer once the site serves; a site or a test reaches for it to
+     * sweep now or to wait.
+     */
+    readonly retention: RetentionService;
+    /**
+     * The site's rssCloud and WebSub client: what tells the notify server named
+     * in the settings that a feed changed, so a subscriber hears at once rather
+     * than on its next poll.
+     *
+     * It is already subscribed to the index; a site reaches for it to ping a
+     * feed of its own ({@link Cms.notifyFeeds}), or to wait for the pings in
+     * flight.
+     */
+    readonly notifier: FeedNotifier;
+    /**
+     * What tells the IndexNow search engines which URLs a publish, an edit or a
+     * deletion moved (TASK-151), while the site has IndexNow on. Already
+     * subscribed to the index; a site or a test reaches for it to send what it
+     * has gathered now and wait for it.
+     */
+    readonly indexNow: IndexNowNotifier;
+    /**
+     * The site's outgoing email (TASK-53): what the settings screen's Send test
+     * email button uses, and what the password resets, moderation notices and
+     * contact messages built on it will.
+     *
+     * A site with no mail configuration still has one. Its `send` logs that the
+     * message was not sent and resolves successfully, so a feature that emails
+     * never has to ask whether the site can.
+     */
+    readonly mail: MailService;
+    /**
+     * Who is told about comments (TASK-55): the moderators when one is waiting,
+     * and a commenter when a reply to them is approved.
+     *
+     * Here so a site's own code can send the same notice for a comment it
+     * created itself. With no mail configuration it sends nothing, like the mail
+     * service behind it.
+     */
+    readonly notifications: CommentNotifier;
+    /**
+     * The batched half of the same notice (TASK-60): what writes to a user who
+     * chose an hourly or a daily digest instead of a message per comment.
+     *
+     * It is started by {@link Cms.serve} and stopped by {@link Cms.close}; a
+     * site reaches for it to send what is due without waiting for the tick,
+     * which is also what a test does.
+     */
+    readonly digests: CommentDigest;
+    /**
+     * The publisher of scheduled posts: what holds a future-dated post back and
+     * releases it when its date arrives.
+     *
+     * It is already subscribed to the index and started by {@link Cms.serve}; a
+     * site reaches for it to ask what it is waiting for, or to release what is
+     * due without waiting for the timer.
+     */
+    readonly scheduler: Scheduler;
+    /**
+     * Index changes, as they happen: `created`, `updated`, `deleted`,
+     * `published`, `unpublished` and the catch-all `change`. Every listener is
+     * handed the document before and after the change.
+     */
+    readonly events: ContentEvents;
+    /**
+     * Run a hook for every `created`, `updated` and `deleted`. The same thing
+     * the `onDocumentChange` config option does, for a site that would rather
+     * subscribe from its entry file. Returns the function that unsubscribes.
+     *
+     * The boot scan reports a cold index as a directory full of creations, so a
+     * hook that must not re-fire on a rebuilt index should check
+     * `change.origin !== 'scan'`.
+     */
+    onDocumentChange(hook: DocumentChangeHook): () => void;
+    /**
+     * Run a hook whenever a document becomes visible on the public site: created
+     * live, a draft published, or a document restored from the trash. Subject to
+     * the same `origin` caveat as {@link Cms.onDocumentChange}. Returns the
+     * function that unsubscribes.
+     */
+    onPublish(hook: DocumentChangeHook): () => void;
+    /**
+     * Run `listener` each time the index settles: after every scan, and after
+     * a run of watcher changes once none is waiting, when every listener on
+     * {@link Cms.events} has finished with them. Returns the function that
+     * unsubscribes.
+     */
+    onSettled(listener: () => unknown): () => void;
+    /**
+     * Tell the notify server that these feeds changed — absolute URLs, because
+     * it is going to fetch them. The hook a site calls for a feed the CMS does
+     * not know it has.
+     *
+     * Best effort: the pings are queued behind whatever is already going out, a
+     * repeated URL is sent once, and a refusal is logged rather than thrown. A
+     * site that names no notify server gets an empty report.
+     */
+    notifyFeeds(urls: readonly string[]): Promise<NotifyReport>;
+    /**
+     * Walk the content directory once and bring the index into line with it.
+     * What `serve()` does on boot, and what the `geekity sync` command runs.
+     */
+    sync(): Promise<SyncResult>;
+    /**
+     * Scan the content directory, start watching it unless
+     * {@link ResolvedConfig.watch} is off, and start listening. Resolves with
+     * the address actually bound, which matters when the port is 0.
+     */
+    serve(): Promise<{
+        port: number;
+    }>;
+    /**
+     * Hand over to a new server (TASK-288): refuse every request but GET and
+     * HEAD with a 503, let the writes already in flight finish, stop the
+     * timers, the watcher and the plugins, send what the queues hold, and then
+     * write nothing more to the database, `dataDir` or `contentDir`. What
+     * `geekity serve` does to the old worker on a reload, before the new one
+     * boots. `onWritesInFlight` hears how many writes are in flight when the drain has
+     * to wait for them.
+     */
+    drain(onWritesInFlight?: (writes: number) => void): Promise<void>;
+    /** Undo {@link Cms.drain}: the new server did not boot, so this one carries on. */
+    resume(): Promise<void>;
+    /**
+     * Stop watching, stop listening and close the index. Safe to call when not
+     * listening, and safe to call twice. After {@link Cms.drain}, each open
+     * connection is left to finish on its own rather than closed under a client
+     * that may be about to reuse it.
+     */
+    close(): Promise<void>;
+}
+/** What `geekity serve` hands the CMS it runs, beyond the site's config (TASK-288). */
+export interface ServeContext {
+    /** Plugins imported from the plugins folder, registered beside the config's. */
+    readonly folderPlugins?: readonly InstalledPlugin[];
+    /** The supervisor this CMS runs under, which Reload on the Plugins screen asks. */
+    readonly supervision?: Supervision;
+}
+/**
+ * Build a CMS around a site's config, or around one `resolveConfig` already
+ * resolved, which is used as it is.
+ *
+ * The returned app is a plain Hono app: the public site, the admin UI and the
+ * federation endpoints are all mounted on it. Booting opens the SQLite cache
+ * under `dataDir` (creating the directory) and applies any migrations, so
+ * `close()` has to be called to release it. A missing or outdated database is
+ * built again from the files; one written by a newer `@geekity/cms`, or damaged
+ * past opening, throws an `UnusableDatabaseError` naming the file.
+ */
+export declare function createCms(config?: GeekityConfig | ResolvedConfig, context?: ServeContext): Cms;
+//# sourceMappingURL=create.d.ts.map

package/dist/cms/create.d.ts.map

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

package/dist/cms/create.js

@@ -0,0 +1,181 @@
+import { Server as NetServer } from 'node:net';
+import { serve as serveNode } from '@hono/node-server';
+import { refuseWritesUnder } from '../files/atomic.js';
+import { siteDataFiles } from '../plugins/data.js';
+import { SITE } from '../site/namespace.js';
+import { messageOf } from '../util/errors.js';
+import { syndicationTargetProblems } from '../webmention/syndication.js';
+import { createApp } from './app.js';
+import { boot } from './boot.js';
+import { endServices, releaseServices, startServices } from './lifecycle.js';
+import { createServices } from './services.js';
+/**
+ * Build a CMS around a site's config, or around one `resolveConfig` already
+ * resolved, which is used as it is.
+ *
+ * The returned app is a plain Hono app: the public site, the admin UI and the
+ * federation endpoints are all mounted on it. Booting opens the SQLite cache
+ * under `dataDir` (creating the directory) and applies any migrations, so
+ * `close()` has to be called to release it. A missing or outdated database is
+ * built again from the files; one written by a newer `@geekity/cms`, or damaged
+ * past opening, throws an `UnusableDatabaseError` naming the file.
+ */
+export function createCms(config = {}, context = {}) {
+    const booted = boot(config, context.folderPlugins);
+    const { resolved, store, admin } = booted;
+    const services = createServices(booted);
+    const { content, lifecycle } = services;
+    const { app, writes } = createApp(booted, services, context.supervision);
+    /**
+     * Subscribe a site's hook to one event.
+     *
+     * The emitter already contains a hook that throws; this also contains one
+     * that rejects, so an `async` hook whose delivery fails is reported rather
+     * than surfacing as an unhandled rejection that would take the process down.
+     */
+    function subscribe(event, hook) {
+        return content.events.on(event, (change) => {
+            const result = hook(change);
+            if (result instanceof Promise) {
+                result.catch((error) => {
+                    const message = messageOf(error);
+                    console.warn(`A ${event} hook rejected: ${message}`);
+                });
+            }
+        });
+    }
+    if (resolved.onDocumentChange !== undefined)
+        subscribe('change', resolved.onDocumentChange);
+    if (resolved.onPublish !== undefined)
+        subscribe('published', resolved.onPublish);
+    let server;
+    let releaseFiles;
+    return {
+        app,
+        config: resolved,
+        store,
+        admin,
+        settings: booted.settings,
+        dataFiles: () => siteDataFiles({
+            dataDir: resolved.dataDir,
+            settings: booted.settings,
+            plugins: booted.plugins,
+        }),
+        federation: services.federation,
+        delivery: services.delivery,
+        jobs: services.jobs,
+        relays: services.relays,
+        webmentions: services.webmentions,
+        replyContexts: services.replyContexts,
+        avatars: services.avatars,
+        actorProfiles: services.actorProfiles,
+        replyBackfill: services.replyBackfill,
+        retention: services.retention,
+        notifier: services.notifier,
+        indexNow: services.indexNow,
+        mail: services.mail,
+        notifications: services.notifications,
+        digests: services.digests,
+        scheduler: services.scheduler,
+        events: content.events,
+        onDocumentChange(hook) {
+            return subscribe('change', hook);
+        },
+        onPublish(hook) {
+            return subscribe('published', hook);
+        },
+        onSettled(listener) {
+            return content.onSettled(listener);
+        },
+        notifyFeeds(urls) {
+            return services.notifier.notify(urls);
+        },
+        sync() {
+            return content.sync();
+        },
+        async serve() {
+            if (server !== undefined) {
+                throw new Error('This CMS is already serving; call close() before serving again.');
+            }
+            await startServices(lifecycle);
+            const stored = await booted.settings.get(SITE.base_url);
+            if (resolved.baseUrlSource === 'default' && stored !== '' && stored !== resolved.baseUrl) {
+                console.warn(`The settings give the base URL as ${stored}, but this CMS was built for ` +
+                    `${resolved.baseUrl}. Build it from \`await settleConfig(config)\` to serve the setting.`);
+            }
+            // A syndication target the site declares badly is ignored everywhere,
+            // and said so once here rather than on every page (TASK-155).
+            for (const problem of syndicationTargetProblems(resolved.contentDir))
+                console.warn(problem);
+            return new Promise((resolve) => {
+                server = serveNode({ fetch: app.fetch, port: resolved.port }, (info) => {
+                    resolve({ port: info.port });
+                });
+            });
+        },
+        async drain(onWritesInFlight) {
+            await writes.refuse(onWritesInFlight);
+            await endServices(lifecycle, 'drain');
+            store.setReadOnly(true);
+            admin.setReadOnly(true);
+            releaseFiles ??= refuseWritesUnder([resolved.dataDir, resolved.contentDir]);
+        },
+        async resume() {
+            releaseFiles?.();
+            releaseFiles = undefined;
+            store.setReadOnly(false);
+            admin.setReadOnly(false);
+            await startServices(lifecycle);
+            writes.reopen();
+        },
+        async close() {
+            const running = server;
+            server = undefined;
+            const handingOver = running !== undefined && writes.refusing ? closeServer(running, true) : undefined;
+            if (writes.refusing)
+                writes.handOver();
+            await endServices(lifecycle, 'close');
+            releaseServices(lifecycle);
+            if (running !== undefined)
+                await (handingOver ?? closeServer(running, false));
+            releaseFiles?.();
+            releaseFiles = undefined;
+            admin.close();
+            store.close();
+        },
+    };
+}
+/** How long a drained server waits for its connections to end before it closes them. */
+const GENTLE_CLOSE_MS = 30_000;
+/**
+ * Stop listening and resolve once every connection has ended.
+ *
+ * A drained server closes gently. `http.Server#close` closes idle keep-alive
+ * connections at once, racing a client that is about to reuse one, which
+ * then sees a reset. `net.Server#close` leaves them: each one either carries
+ * `Connection: close` on its next response or ends on the keep-alive timeout
+ * the client was told, which a client honours by closing first.
+ */
+function closeServer(running, gently) {
+    return new Promise((resolve, reject) => {
+        const done = (err) => {
+            if (err)
+                reject(err);
+            else
+                resolve();
+        };
+        if (!gently) {
+            running.close(done);
+            return;
+        }
+        const timer = setTimeout(() => running.closeAllConnections(), GENTLE_CLOSE_MS);
+        NetServer.prototype.close.call(running, (err) => {
+            clearTimeout(timer);
+            // The http server's own close clears its connection-checking interval;
+            // the listener is already gone, so the error it reports is expected.
+            running.close(() => undefined);
+            done(err);
+        });
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/cms/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/cms/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAqBvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAMvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAmP/C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CACvB,MAAM,GAAmC,EAAE,EAC3C,OAAO,GAAiB,EAAE;IAE1B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAC1C,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;IACxC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzE;;;;;;OAMG;IACH,SAAS,SAAS,CAAC,KAA4B,EAAE,IAAwB;QACvE,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;oBAC9B,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;oBACjC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,mBAAmB,OAAO,EAAE,CAAC,CAAC;gBACvD,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,CAAC,gBAAgB,KAAK,SAAS;QAAE,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC5F,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS;QAAE,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEjF,IAAI,MAA8B,CAAC;IACnC,IAAI,YAAsC,CAAC;IAE3C,OAAO;QACL,GAAG;QACH,MAAM,EAAE,QAAQ;QAChB,KAAK;QACL,KAAK;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,GAAG,EAAE,CACd,aAAa,CAAC;YACZ,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;QACJ,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;QAEtB,gBAAgB,CAAC,IAAI;YACnB,OAAO,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,SAAS,CAAC,IAAI;YACZ,OAAO,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QAED,SAAS,CAAC,QAAQ;YAChB,OAAO,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAED,WAAW,CAAC,IAAI;YACd,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,IAAI;YACF,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC;QAED,KAAK,CAAC,KAAK;YACT,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;YACrF,CAAC;YAED,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;YAE/B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxD,IAAI,QAAQ,CAAC,aAAa,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACzF,OAAO,CAAC,IAAI,CACV,qCAAqC,MAAM,+BAA+B;oBACxE,GAAG,QAAQ,CAAC,OAAO,sEAAsE,CAC5F,CAAC;YACJ,CAAC;YAED,sEAAsE;YACtE,8DAA8D;YAC9D,KAAK,MAAM,OAAO,IAAI,yBAAyB,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE5F,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,MAAM,GAAG,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;oBACrE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC/B,CAAC,CAAe,CAAC;YACnB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,gBAAgB;YAC1B,MAAM,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YACtC,MAAM,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACtC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,YAAY,KAAK,iBAAiB,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9E,CAAC;QAED,KAAK,CAAC,MAAM;YACV,YAAY,EAAE,EAAE,CAAC;YACjB,YAAY,GAAG,SAAS,CAAC;YACzB,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACzB,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACzB,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,OAAO,GAAG,MAAM,CAAC;YACvB,MAAM,GAAG,SAAS,CAAC;YACnB,MAAM,WAAW,GACf,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACpF,IAAI,MAAM,CAAC,QAAQ;gBAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACtC,eAAe,CAAC,SAAS,CAAC,CAAC;YAE3B,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,CAAC,WAAW,IAAI,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAE9E,YAAY,EAAE,EAAE,CAAC;YACjB,YAAY,GAAG,SAAS,CAAC;YACzB,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B;;;;;;;;GAQG;AACH,SAAS,WAAW,CAAC,OAAmB,EAAE,MAAe;IACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;YAC3B,IAAI,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAChB,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,eAAe,CAAC,CAAC;QAC/E,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE;YACtD,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,uEAAuE;YACvE,qEAAqE;YACrE,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cms/lifecycle.d.ts

@@ -0,0 +1,11 @@
+export type Ending = 'drain' | 'close';
+export interface Service {
+    start?(): void | Promise<void>;
+    stop?(ending: Ending): void | Promise<void>;
+    settled?(ending: Ending): Promise<void>;
+    release?(): void;
+}
+export declare function startServices(services: readonly Service[]): Promise<void>;
+export declare function endServices(services: readonly Service[], ending: Ending): Promise<void>;
+export declare function releaseServices(services: readonly Service[]): void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/cms/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/cms/lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvC,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7F;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAElE"}

package/dist/cms/lifecycle.js

@@ -0,0 +1,15 @@
+export async function startServices(services) {
+    for (const service of services)
+        await service.start?.();
+}
+export async function endServices(services, ending) {
+    for (const service of services.toReversed())
+        await service.stop?.(ending);
+    for (const service of services)
+        await service.settled?.(ending);
+}
+export function releaseServices(services) {
+    for (const service of services)
+        service.release?.();
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/cms/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/cms/lifecycle.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAA4B;IAC9D,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAA4B,EAAE,MAAc;IAC5E,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,UAAU,EAAE;QAAE,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;IAC1E,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAA4B;IAC1D,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;AACtD,CAAC"}

package/dist/{web/errors.d.ts → cms/server-error.d.ts}

@@ -1,6 +1,5 @@
 import type { ErrorHandler } from 'hono';
-import type { GeekityEnv } from '../env.ts';
-import type { Representation } from './negotiate.ts';
+import type { GeekityEnv } from '../web/env.ts';
 /**
  * What a request whose handler threw is answered with (TASK-129).
  *
@@ -11,9 +10,4 @@ import type { Representation } from './negotiate.ts';
  * through as Hono's own handler would.
  */
 export declare const serverError: ErrorHandler<GeekityEnv>;
-/**
- * The representation the failed request was after: the one its `.md` or
- * `.json` suffix names, else the one its `Accept` header prefers, else HTML.
- */
-export declare function representationOf(pathname: string, accept: string | undefined): Representation;
-//# sourceMappingURL=errors.d.ts.map
+//# sourceMappingURL=server-error.d.ts.map

package/dist/cms/server-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-error.d.ts","sourceRoot":"","sources":["../../src/cms/server-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAMzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AA2ChD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,EAAE,YAAY,CAAC,UAAU,CAyChD,CAAC"}

package/dist/{web/errors.js → cms/server-error.js}

@@ -1,9 +1,8 @@
 import { HTTPException } from 'hono/http-exception';
-import { ADMIN_ASSET_PREFIX } from '../admin/assets.js';
-import { ADMIN_PREFIX } from '../admin/session.js';
+import { ADMIN_ASSET_PREFIX, ADMIN_PREFIX } from '../site/admin-paths.js';
 import { ADMIN_TEMPLATES, createAdminTemplateEnvironment } from '../admin/templates.js';
-import { CONTENT_TYPES, DOCUMENT_REPRESENTATIONS, selectRepresentation, splitRepresentationExtension, } from './negotiate.js';
-import { requestPath } from './routes.js';
+import { CONTENT_TYPES, representationOf } from '../web/negotiate.js';
+import { requestPath } from '../web/request.js';
 /**
  * A server error is never stored: the next request may well succeed, and a
  * cache that kept this one would go on serving the failure after it was fixed.
@@ -74,15 +73,6 @@ export const serverError = (error, c) => {
             return c.html(orStaticPage(() => c.var.renderer.renderServerError(pathname)), 500, { 'cache-control': NO_STORE });
     }
 };
-/**
- * The representation the failed request was after: the one its `.md` or
- * `.json` suffix names, else the one its `Accept` header prefers, else HTML.
- */
-export function representationOf(pathname, accept) {
-    return (splitRepresentationExtension(pathname)?.representation ??
-        selectRepresentation(accept, DOCUMENT_REPRESENTATIONS) ??
-        'html');
-}
 function orStaticPage(render) {
     try {
         return render();
@@ -92,4 +82,4 @@ function orStaticPage(render) {
         return STATIC_PAGE;
     }
 }
-//# sourceMappingURL=errors.js.map
+//# sourceMappingURL=server-error.js.map

package/dist/cms/server-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-error.js","sourceRoot":"","sources":["../../src/cms/server-error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAExF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,MAAM,QAAQ,GAAG,UAAU,CAAC;AAE5B;;;GAGG;AACH,MAAM,WAAW,GAAG;;;;;;;;;;;;CAYnB,CAAC;AAEF,MAAM,aAAa,GACjB,qHAAqH,CAAC;AAExH,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,SAAS,CACjC;IACE,KAAK,EAAE,uBAAuB;IAC9B,OAAO,EAAE,sDAAsD;CAChE,EACD,SAAS,EACT,CAAC,CACF,IAAI,CAAC;AAEN,qFAAqF;AACrF,IAAI,gBAAyC,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAA6B,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;IAChE,IAAI,KAAK,YAAY,aAAa;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAE/D,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,QAAQ,UAAU,EAAE,KAAK,CAAC,CAAC;IAE5D,IAAI,QAAQ,KAAK,YAAY,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC;QACzE,OAAO,CAAC,CAAC,IAAI,CACX,YAAY,CAAC,GAAG,EAAE;YAChB,gBAAgB,KAAK,8BAA8B,EAAE,CAAC;YACtD,OAAO,gBAAgB,CAAC,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE;gBAC1D,QAAQ,EAAE,YAAY;gBACtB,WAAW,EAAE,kBAAkB;aAChC,CAAC,CAAC;QACL,CAAC,CAAC,EACF,GAAG,EACH,EAAE,eAAe,EAAE,QAAQ,EAAE,CAC9B,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1E,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,MAAM;YACT,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;gBAC5B,cAAc,EAAE,iCAAiC;gBACjD,eAAe,EAAE,QAAQ;aAC1B,CAAC,CAAC;QACL,KAAK,UAAU,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE;gBAChC,cAAc,EAAE,aAAa,CAAC,cAAc,CAAC;gBAC7C,qBAAqB,EAAE,QAAQ;gBAC/B,eAAe,EAAE,QAAQ;aAC1B,CAAC,CAAC;QACL,KAAK,MAAM;YACT,OAAO,CAAC,CAAC,IAAI,CACX,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,EAC9D,GAAG,EACH,EAAE,eAAe,EAAE,QAAQ,EAAE,CAC9B,CAAC;IACN,CAAC;AACH,CAAC,CAAC;AAEF,SAAS,YAAY,CAAC,MAAoB;IACxC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;QACnE,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/cms/services.d.ts

@@ -0,0 +1,57 @@
+import type { KvStore } from '@fedify/fedify';
+import type { AvatarService } from '../avatars/index.ts';
+import type { ContentSync, Scheduler } from '../content/index.ts';
+import type { ReplyBackfill } from '../federation/backfill.ts';
+import type { HandleLearner } from '../federation/handles.ts';
+import type { ActorProfileService, DeliveryService, RelayService, SiteFederation } from '../federation/index.ts';
+import type { JobQueue } from '../jobs/types.ts';
+import type { IndexNowNotifier } from '../indexnow.ts';
+import type { IndieAuthState } from '../indieauth/grants.ts';
+import type { MailService, CommentDigest, CommentNotifier } from '../notifications/index.ts';
+import type { MaintenanceSwitch } from '../maintenance.ts';
+import type { FeedNotifier } from '../notify.ts';
+import type { RetentionService } from '../privacy/retention.ts';
+import type { ConversationReader } from '../comments/conversation.ts';
+import type { RedirectSource } from '../content/redirects.ts';
+import type { SiteRecords } from '../content/write.ts';
+import type { Renderer } from '../web/render.ts';
+import type { ReplyContextService, WebmentionService } from '../webmention/index.ts';
+import type { Booted } from './boot.ts';
+import type { Service } from './lifecycle.ts';
+/**
+ * Where the scheduler's watermark lives in {@link AdminStore.getState}: the
+ * instant up to which scheduled documents have been announced.
+ */
+export declare const SCHEDULE_WATERMARK_KEY = "schedule.watermark";
+/** Where the instant the scheduler first ran on this site lives in {@link AdminStore.getState}. */
+export declare const SCHEDULE_FIRST_RUN_KEY = "schedule.firstRun";
+export interface Services {
+    readonly content: ContentSync;
+    readonly conversation: ConversationReader;
+    readonly renderer: Renderer;
+    readonly redirects: RedirectSource;
+    readonly mail: MailService;
+    readonly federation: SiteFederation;
+    readonly federationKv: KvStore;
+    readonly delivery: DeliveryService;
+    readonly relays: RelayService;
+    readonly webmentions: WebmentionService;
+    readonly replyContexts: ReplyContextService;
+    readonly avatars: AvatarService;
+    readonly actorProfiles: ActorProfileService;
+    readonly replyBackfill: ReplyBackfill;
+    readonly retention: RetentionService;
+    readonly notifier: FeedNotifier;
+    readonly indexNow: IndexNowNotifier;
+    readonly notifications: CommentNotifier;
+    readonly digests: CommentDigest;
+    readonly scheduler: Scheduler;
+    readonly learnHandles: HandleLearner;
+    readonly siteRecords: SiteRecords;
+    readonly maintenance: MaintenanceSwitch;
+    readonly indieauth: IndieAuthState;
+    readonly jobs: JobQueue;
+    readonly lifecycle: readonly Service[];
+}
+export declare function createServices({ resolved, plugins, store, admin, commentRecords, settings, }: Booted): Services;
+//# sourceMappingURL=services.d.ts.map

package/dist/cms/services.d.ts.map

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