@geekity/cms 0.31.0 → 0.32.0

package/dist/jobs/queue.js

@@ -0,0 +1,220 @@
+import { randomUUID } from 'node:crypto';
+import { messageOf } from '../util/errors.js';
+import { isClaimerAlive, thisProcess } from './processes.js';
+import { JobLostError } from './types.js';
+const DEFAULT_MAX_ATTEMPTS = 3;
+export const MAX_PAYLOAD_BYTES = 64 * 1024;
+const FOREIGN_JOB_POLL_MS = 100;
+/**
+ * The job layer of decision-54, the same on every transport. A message
+ * carries only a job id; a claim is a compare-and-set from queued to
+ * running at one attempt, and the attempt fences every later write, so a
+ * duplicate or late message runs nothing.
+ */
+export function createJobQueue(options) {
+    const { transport, records } = options;
+    const owner = randomUUID();
+    const maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+    const now = () => options.now().toISOString();
+    const definitions = new Map(options.jobs.map((job) => [job.name, job]));
+    let stopping = new AbortController();
+    let listening = Promise.resolve();
+    let started = false;
+    let inFlight = 0;
+    let idle = [];
+    /**
+     * Take back what a dead or discarded worker left: a running job whose
+     * claiming process is gone goes back to queued as the next attempt, and,
+     * while nothing runs here, every queued job is sent to the transport again,
+     * since its message may have died with another process. A duplicate message
+     * is dropped by the claim. A started queue does this on start, before
+     * answering {@link JobQueue.latest}, and each time it goes idle.
+     */
+    async function reconcile() {
+        for (const record of await records.list(['running'])) {
+            if (record.state !== 'running' || record.owner === owner || !isCutOff(record))
+                continue;
+            const expected = { state: 'running', attempt: record.attempt };
+            await records.transition(record.id, expected, record.attempt >= maxAttempts
+                ? { state: 'interrupted', attempt: record.attempt, interruptedAt: now() }
+                : { state: 'queued', attempt: record.attempt + 1, interruptedAt: now() });
+        }
+        if (inFlight > 0)
+            return;
+        for (const record of await records.list(['queued']))
+            await transport.enqueue({ id: record.id });
+    }
+    async function claimAndRun(id, signal) {
+        if (signal.aborted)
+            return false;
+        const record = await records.get(id);
+        if (record?.state !== 'queued')
+            return false;
+        const { attempt } = record;
+        const queued = { state: 'queued', attempt };
+        const definition = definitions.get(record.name);
+        if (definition === undefined) {
+            return records.transition(id, queued, {
+                state: 'failed',
+                attempt,
+                finishedAt: now(),
+                error: `No handler is registered for ${record.name}.`,
+            });
+        }
+        const claim = {
+            state: 'running',
+            attempt,
+            owner,
+            claimer: thisProcess(),
+            startedAt: now(),
+        };
+        if (!(await records.transition(id, queued, claim)))
+            return false;
+        inFlight += 1;
+        const running = { state: 'running', attempt };
+        try {
+            const result = await definition.run(definition.parse(record.payload), {
+                signal,
+                attempt,
+                async progress(progress) {
+                    const kept = await records.transition(id, running, { ...claim, progress });
+                    if (!kept)
+                        throw new JobLostError(id);
+                },
+            });
+            await records.transition(id, running, {
+                state: 'finished',
+                attempt,
+                finishedAt: now(),
+                result: plain(result ?? null),
+            });
+        }
+        catch (error) {
+            if (signal.aborted) {
+                if (await records.transition(id, running, { state: 'queued', attempt })) {
+                    await transport.enqueue({ id }).catch(() => undefined);
+                }
+            }
+            else if (!(error instanceof JobLostError)) {
+                await records.transition(id, running, {
+                    state: 'failed',
+                    attempt,
+                    finishedAt: now(),
+                    error: messageOf(error),
+                });
+            }
+        }
+        finally {
+            inFlight -= 1;
+            if (inFlight === 0) {
+                const waiting = idle;
+                idle = [];
+                for (const wake of waiting)
+                    wake();
+                if (started && !signal.aborted)
+                    void reconcile().catch(() => undefined);
+            }
+        }
+        return true;
+    }
+    async function deliver(message, signal) {
+        const id = message?.id;
+        if (typeof id === 'string')
+            await claimAndRun(id, signal);
+    }
+    function newRecord(job, payload) {
+        if (!definitions.has(job.name))
+            throw new Error(`No handler is registered for ${job.name}.`);
+        const copy = plain(payload);
+        if (Buffer.byteLength(JSON.stringify(copy)) > MAX_PAYLOAD_BYTES) {
+            throw new Error(`A ${job.name} job's payload is over ${String(MAX_PAYLOAD_BYTES)} bytes.`);
+        }
+        return {
+            id: randomUUID(),
+            name: job.name,
+            payload: copy,
+            queuedAt: now(),
+            state: 'queued',
+            attempt: 1,
+        };
+    }
+    function isActive(status, countQueued = true) {
+        if (status.state === 'queued')
+            return countQueued;
+        return status.state === 'running' && (status.owner === owner || !isCutOff(status));
+    }
+    const queue = {
+        async enqueue(job, payload) {
+            const status = newRecord(job, payload);
+            await records.create(status);
+            await transport.enqueue({ id: status.id });
+            return status.id;
+        },
+        async enqueueUnlessActive(job, payload, options = {}) {
+            const status = newRecord(job, payload);
+            if (started)
+                await reconcile();
+            const active = await records.create(status, (latest) => isActive(latest, options.countQueued));
+            if (active !== undefined)
+                return { queued: false, active };
+            await transport.enqueue({ id: status.id });
+            return { queued: true, id: status.id };
+        },
+        status: (id) => records.get(id),
+        async latest(name) {
+            if (started)
+                await reconcile();
+            return records.latest(name);
+        },
+        async active(name) {
+            const latest = await queue.latest(name);
+            return latest !== undefined && isActive(latest) ? latest : undefined;
+        },
+        async run(id) {
+            await claimAndRun(id, stopping.signal);
+            for (;;) {
+                const status = await records.get(id);
+                if (status === undefined)
+                    throw new Error(`No job ${id} is recorded.`);
+                if (isFinal(status) || stopping.signal.aborted)
+                    return status;
+                await new Promise((resolve) => setTimeout(resolve, FOREIGN_JOB_POLL_MS));
+            }
+        },
+        async start() {
+            if (started)
+                return;
+            await listening;
+            if (stopping.signal.aborted)
+                stopping = new AbortController();
+            started = true;
+            const { signal } = stopping;
+            await reconcile();
+            listening = transport.listen((message) => deliver(message, signal), { signal });
+        },
+        stop() {
+            started = false;
+            stopping.abort();
+        },
+        async settled() {
+            while (inFlight > 0)
+                await new Promise((resolve) => idle.push(resolve));
+        },
+        async close() {
+            queue.stop();
+            await queue.settled();
+            await listening;
+        },
+    };
+    return queue;
+}
+function isCutOff(status) {
+    return (status.state === 'running' && (status.claimer === undefined || !isClaimerAlive(status.claimer)));
+}
+function isFinal(status) {
+    return status.state === 'finished' || status.state === 'failed' || status.state === 'interrupted';
+}
+function plain(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+//# sourceMappingURL=queue.js.map

package/dist/jobs/queue.js.map

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

package/dist/jobs/types.d.ts

@@ -0,0 +1,159 @@
+export type Json = null | boolean | number | string | readonly Json[] | {
+    readonly [key: string]: Json;
+};
+export interface Progress {
+    readonly done: number;
+    readonly total?: number;
+    readonly note?: string;
+}
+/**
+ * The process that claimed a running job: its host, its id, and when it
+ * started as the operating system reports it, which tells it apart from a
+ * later process given the same id.
+ */
+export interface Claimer {
+    readonly host: string;
+    readonly pid: number;
+    readonly since?: string;
+}
+export type JobState = {
+    readonly state: 'queued';
+    readonly attempt: number;
+    readonly interruptedAt?: string;
+} | {
+    readonly state: 'running';
+    readonly attempt: number;
+    readonly owner: string;
+    readonly claimer?: Claimer;
+    readonly startedAt: string;
+    readonly progress?: Progress;
+} | {
+    readonly state: 'finished';
+    readonly attempt: number;
+    readonly finishedAt: string;
+    readonly result: Json;
+} | {
+    readonly state: 'failed';
+    readonly attempt: number;
+    readonly finishedAt: string;
+    readonly error: string;
+} | {
+    readonly state: 'interrupted';
+    readonly attempt: number;
+    readonly interruptedAt: string;
+};
+export declare const JOB_STATES: readonly ['queued', 'running', 'finished', 'failed', 'interrupted'];
+export type JobStateName = (typeof JOB_STATES)[number];
+export type JobStatus = {
+    readonly id: string;
+    readonly name: string;
+    readonly payload: Json;
+    readonly queuedAt: string;
+} & JobState;
+export interface JobContext {
+    /** Aborted when the queue stops. Check it between items and throw to give the job back. */
+    readonly signal: AbortSignal;
+    readonly attempt: number;
+    /** Throws {@link JobLostError} when this worker no longer owns the job. */
+    progress(progress: Progress): Promise<void>;
+}
+declare const carries: unique symbol;
+/** A job's name, typed with the payload it is queued with and the result it finishes with. */
+export interface JobName<P extends Json = Json, R extends Json = Json> {
+    readonly name: string;
+    readonly [carries]?: {
+        readonly payload: P;
+        readonly result: R;
+    };
+}
+export declare function jobName<P extends Json, R extends Json>(name: string): JobName<P, R>;
+/**
+ * A finished job's result, typed by its name. The result is the job's own
+ * output, read back from the record store, so it is trusted rather than
+ * checked again.
+ */
+export declare function finishedResult<R extends Json>(job: JobName<Json, R>, status: JobStatus | undefined): R | undefined;
+/**
+ * One kind of job. `parse` checks the payload, which crossed a boundary, and
+ * `run` must be safe to run twice: execution is at least once.
+ */
+export interface JobDefinition<P extends Json = Json, R extends Json = Json> extends JobName<P, R> {
+    parse(payload: Json): P;
+    run(payload: P, context: JobContext): Promise<R>;
+}
+/** What the admin and the CLI use. */
+export interface JobQueue {
+    /** Record a job as queued and send it to the transport. Refuses a name with no registered definition. */
+    enqueue<P extends Json>(job: JobName<P, Json>, payload: NoInfer<P>): Promise<string>;
+    /**
+     * {@link JobQueue.enqueue}, unless a job of this name is active, as
+     * {@link JobQueue.active} means it: then nothing is queued and the active
+     * job is returned. The check and the write are one step in the record
+     * store, so two callers at once queue one job. With `countQueued: false`, a
+     * queued job does not count as active.
+     */
+    enqueueUnlessActive<P extends Json>(job: JobName<P, Json>, payload: NoInfer<P>, options?: {
+        readonly countQueued?: boolean;
+    }): Promise<Enqueued>;
+    status(id: string): Promise<JobStatus | undefined>;
+    /**
+     * The newest job of this name, whatever its state. A started queue first
+     * takes back the jobs a dead or discarded worker left, so a cut-off job
+     * reads as queued again rather than as running.
+     */
+    latest(name: string): Promise<JobStatus | undefined>;
+    /**
+     * The newest job of this name while it waits or runs: queued, or running
+     * in this worker or in a process that is still alive. A job a gone process
+     * left running is not active; a started queue runs it again.
+     */
+    active(name: string): Promise<JobStatus | undefined>;
+    /**
+     * Run one queued job in this process and resolve with its final status,
+     * with no transport and no start-up recovery: what a CLI command does
+     * beside a server that may be running. A job another process claimed first
+     * is waited for instead.
+     */
+    run(id: string): Promise<JobStatus>;
+    /** Recover the jobs no worker owns and start taking messages. */
+    start(): Promise<void>;
+    /** Stop taking messages and abort the running job's signal. */
+    stop(): void;
+    /** Resolve once no handler in this process is running. */
+    settled(): Promise<void>;
+    /** {@link JobQueue.stop}, then {@link JobQueue.settled}, then the transport's `listen` returning. */
+    close(): Promise<void>;
+}
+export type Enqueued = {
+    readonly queued: true;
+    readonly id: string;
+} | {
+    readonly queued: false;
+    readonly active: JobStatus;
+};
+/** Swap point 1: what carries a job's id to a worker. Any Fedify `MessageQueue` satisfies it. */
+export interface MessageTransport {
+    enqueue(message: unknown): Promise<void>;
+    listen(handler: (message: unknown) => Promise<void>, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+}
+/** Swap point 2: where job status lives. Every transition is a compare-and-set on state and attempt. */
+export interface JobRecords {
+    /**
+     * Record a new job, unless `blocks` holds for the newest job of the same
+     * name: then record nothing and resolve with that job. The check and the
+     * write must be one step, so that two callers never both get past it.
+     */
+    create(status: JobStatus, blocks?: (latest: JobStatus) => boolean): Promise<JobStatus | undefined>;
+    get(id: string): Promise<JobStatus | undefined>;
+    latest(name: string): Promise<JobStatus | undefined>;
+    list(states: readonly JobStateName[]): Promise<JobStatus[]>;
+    transition(id: string, expected: Pick<JobState, 'state' | 'attempt'>, next: JobState): Promise<boolean>;
+}
+/** A write by a worker that no longer owns its job. */
+export declare class JobLostError extends Error {
+    constructor(id: string);
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/jobs/types.d.ts.map

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

package/dist/jobs/types.js

@@ -0,0 +1,22 @@
+export const JOB_STATES = ['queued', 'running', 'finished', 'failed', 'interrupted'];
+export function jobName(name) {
+    return { name };
+}
+/**
+ * A finished job's result, typed by its name. The result is the job's own
+ * output, read back from the record store, so it is trusted rather than
+ * checked again.
+ */
+export function finishedResult(job, status) {
+    return status?.state === 'finished' && status.name === job.name
+        ? status.result
+        : undefined;
+}
+/** A write by a worker that no longer owns its job. */
+export class JobLostError extends Error {
+    constructor(id) {
+        super(`Job ${id} is no longer this worker's.`);
+        this.name = 'JobLostError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/jobs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/jobs/types.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAU,CAAC;AA2B9F,MAAM,UAAU,OAAO,CAAiC,IAAY;IAClE,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAqB,EACrB,MAA6B;IAE7B,OAAO,MAAM,EAAE,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI;QAC7D,CAAC,CAAE,MAAM,CAAC,MAAY;QACtB,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AA2FD,uDAAuD;AACvD,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,EAAU;QACpB,KAAK,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/mail/index.d.ts

@@ -1,7 +1,5 @@
 export { BREVO_ENDPOINT, BREVO_TIMEOUT_MS, createBrevoProvider } from './brevo.ts';
 export type { BrevoProviderOptions } from './brevo.ts';
-export { MAIL_CREDENTIALS_FILE, mailCredentialsPath, readMailCredentials, removeMailCredentials, writeMailCredentials, } from './credentials.ts';
-export type { BrevoCredential, MailCredentials, SmtpCredential } from './credentials.ts';
 export { createMemoryMailProvider } from './memory.ts';
 export type { MemoryMailProvider } from './memory.ts';
 export { MAIL_PROVIDERS } from './provider.ts';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mail/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mail/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/mail/index.js

@@ -1,5 +1,4 @@
 export { BREVO_ENDPOINT, BREVO_TIMEOUT_MS, createBrevoProvider } from './brevo.js';
-export { MAIL_CREDENTIALS_FILE, mailCredentialsPath, readMailCredentials, removeMailCredentials, writeMailCredentials, } from './credentials.js';
 export { createMemoryMailProvider } from './memory.js';
 export { MAIL_PROVIDERS } from './provider.js';
 export { createSmtpProvider, SMTP_TIMEOUT_MS } from './smtp.js';

package/dist/mail/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mail/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEnF,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAS/C,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mail/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAS/C,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/maintenance.d.ts

@@ -1,47 +1,10 @@
+import { MAINTENANCE } from './settings/maintenance.ts';
+import type { SettingsRegistry, ValuesOf } from './settings/types.ts';
 import type { Clock } from './util/clock.ts';
-/**
- * Maintenance mode (TASK-130) is a file, `data/maintenance.json`, that the
- * running site checks for and `geekity maintenance on` and `off` write and
- * remove. A file rather than a setting so that turning it on needs neither a
- * restart nor a working admin, and under `data/` rather than `content/`
- * because it is operational state: `content/` is published and committed, and
- * a flag that travelled with it would take down every checkout of the site.
- */
-export declare const MAINTENANCE_FILE = "maintenance.json";
-/** The site is down on purpose. `until` is when the operator expects it back. */
-export interface MaintenanceWindow {
-    until: Date | undefined;
-}
-export declare function maintenanceFile(dataDir: string): string;
-/** Turn maintenance on, replacing whatever window was there before. */
-export declare function enterMaintenance(dataDir: string, window?: {
-    until?: Date | undefined;
-}): Promise<void>;
-/** Turn maintenance off. Already off is not an error. */
-export declare function leaveMaintenance(dataDir: string): Promise<void>;
-/**
- * The window the file describes, or `undefined` when there is no file.
- *
- * A file that is there but unreadable as a window still means maintenance:
- * the operator put it there, and taking the site back up because of a typo in
- * a date would be the surprise.
- */
-export declare function readMaintenance(dataDir: string): MaintenanceWindow | undefined;
-/** The maintenance window in force right now, or `undefined` when the site is up. */
-export type MaintenanceSwitch = () => MaintenanceWindow | undefined;
-/**
- * The running site's view of maintenance mode.
- *
- * `forced` is the `maintenance` setting or `GEEKITY_MAINTENANCE`, read once at
- * boot: it keeps the site in maintenance for the life of the process, and the
- * file can only add an expected return to it. Otherwise the file decides, and
- * is looked at no more than once a second by the site's clock: a relay burst
- * of a few hundred deliveries costs one read, and `geekity maintenance off`
- * still takes effect within a second.
- */
+export type MaintenanceState = ValuesOf<typeof MAINTENANCE>;
+export type MaintenanceSwitch = () => Promise<MaintenanceState>;
 export declare function createMaintenanceSwitch(options: {
-    dataDir: string;
-    forced: boolean;
+    settings: SettingsRegistry;
     now: Clock;
 }): MaintenanceSwitch;
 //# sourceMappingURL=maintenance.d.ts.map

package/dist/maintenance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../src/maintenance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAKnD,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,GAAG,SAAS,CAAC;CACzB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,uEAAuE;AACvE,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE;IAAE,KAAK,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;CAAO,GACxC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,yDAAyD;AACzD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAI9E;AAeD,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,GAAG,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAEpE;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,KAAK,CAAC;CACZ,GAAG,iBAAiB,CAYpB"}
+{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../src/maintenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAI7C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,WAAW,CAAC,CAAC;AAE5D,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEhE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,EAAE,KAAK,CAAC;CACZ,GAAG,iBAAiB,CAWpB"}

package/dist/maintenance.js

@@ -1,78 +1,15 @@
-import { rm } from 'node:fs/promises';
-import path from 'node:path';
-import { readFileIfPresentSync, writeFileAtomically } from './files/atomic.js';
-/**
- * Maintenance mode (TASK-130) is a file, `data/maintenance.json`, that the
- * running site checks for and `geekity maintenance on` and `off` write and
- * remove. A file rather than a setting so that turning it on needs neither a
- * restart nor a working admin, and under `data/` rather than `content/`
- * because it is operational state: `content/` is published and committed, and
- * a flag that travelled with it would take down every checkout of the site.
- */
-export const MAINTENANCE_FILE = 'maintenance.json';
-/** How long the running site trusts its last look at the file. */
+import { MAINTENANCE } from './settings/maintenance.js';
 const RECHECK_MS = 1000;
-export function maintenanceFile(dataDir) {
-    return path.join(dataDir, MAINTENANCE_FILE);
-}
-/** Turn maintenance on, replacing whatever window was there before. */
-export async function enterMaintenance(dataDir, window = {}) {
-    const body = window.until === undefined ? {} : { until: window.until.toISOString() };
-    await writeFileAtomically(maintenanceFile(dataDir), `${JSON.stringify(body, null, 2)}\n`);
-}
-/** Turn maintenance off. Already off is not an error. */
-export async function leaveMaintenance(dataDir) {
-    await rm(maintenanceFile(dataDir), { force: true });
-}
-/**
- * The window the file describes, or `undefined` when there is no file.
- *
- * A file that is there but unreadable as a window still means maintenance:
- * the operator put it there, and taking the site back up because of a typo in
- * a date would be the surprise.
- */
-export function readMaintenance(dataDir) {
-    const text = readFileIfPresentSync(maintenanceFile(dataDir));
-    if (text === undefined)
-        return undefined;
-    return { until: untilIn(text) };
-}
-function untilIn(text) {
-    try {
-        const parsed = JSON.parse(text);
-        if (typeof parsed !== 'object' || parsed === null)
-            return undefined;
-        const until = parsed['until'];
-        if (typeof until !== 'string')
-            return undefined;
-        const date = new Date(until);
-        return Number.isNaN(date.getTime()) ? undefined : date;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * The running site's view of maintenance mode.
- *
- * `forced` is the `maintenance` setting or `GEEKITY_MAINTENANCE`, read once at
- * boot: it keeps the site in maintenance for the life of the process, and the
- * file can only add an expected return to it. Otherwise the file decides, and
- * is looked at no more than once a second by the site's clock: a relay burst
- * of a few hundred deliveries costs one read, and `geekity maintenance off`
- * still takes effect within a second.
- */
 export function createMaintenanceSwitch(options) {
-    const forced = options.forced ? { until: undefined } : undefined;
     let checkedAt = Number.NEGATIVE_INFINITY;
     let current;
     return () => {
         const now = options.now().getTime();
-        if (now - checkedAt >= RECHECK_MS || now < checkedAt) {
-            current = readMaintenance(options.dataDir);
+        if (current === undefined || now - checkedAt >= RECHECK_MS || now < checkedAt) {
+            current = options.settings.values(MAINTENANCE);
             checkedAt = now;
         }
-        return current ?? forced;
+        return current;
     };
 }
 //# sourceMappingURL=maintenance.js.map

package/dist/maintenance.js.map

@@ -1 +1 @@
-{"version":3,"file":"maintenance.js","sourceRoot":"","sources":["../src/maintenance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"maintenance.js","sourceRoot":"","sources":["../src/maintenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAIxD,MAAM,UAAU,GAAG,IAAI,CAAC;AAMxB,MAAM,UAAU,uBAAuB,CAAC,OAGvC;IACC,IAAI,SAAS,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACzC,IAAI,OAA8C,CAAC;IACnD,OAAO,GAAG,EAAE;QACV,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,OAAO,KAAK,SAAS,IAAI,GAAG,GAAG,SAAS,IAAI,UAAU,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;YAC9E,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC/C,SAAS,GAAG,GAAG,CAAC;QAClB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC"}

package/dist/media/library.d.ts

@@ -1,4 +1,4 @@
-import type { UploadKind } from '../content/media.ts';
+import type { UploadKind } from '../files/upload-types.ts';
 import type { AltText } from '../content/alt-text.ts';
 /** One file under `content/uploads/`, as the screen shows it. */
 export interface MediaFile {

package/dist/media/library.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/media/library.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAItD,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,4GAA4G;IAC5G,GAAG,EAAE,OAAO,GAAG,SAAS,CAAC;IACzB,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA0C1E;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,IAAI,EACd,GAAG,CAAC,EAAE,OAAO,GACZ,SAAS,CA0BX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAMjE;AAKD,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3C;AAED,mGAAmG;AACnG,MAAM,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOtF"}
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/media/library.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAI3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAItD,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,4GAA4G;IAC5G,GAAG,EAAE,OAAO,GAAG,SAAS,CAAC;IACzB,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA2C1E;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,IAAI,EACd,GAAG,CAAC,EAAE,OAAO,GACZ,SAAS,CA0BX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAMjE;AAKD,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3C;AAED,mGAAmG;AACnG,MAAM,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOtF"}

package/dist/media/library.js

@@ -1,8 +1,9 @@
 import { readdir, stat, unlink } from 'node:fs/promises';
 import path from 'node:path';
-import { UPLOAD_MEDIA_TYPES } from '../content/media.js';
+import { UPLOAD_MEDIA_TYPES } from '../files/upload-types.js';
 import { UPLOAD_ASSET_PREFIX, UPLOAD_DIRECTORY } from '../content/uploads.js';
 import { readAltTexts, writeAltText } from '../content/alt-text.js';
+import { HALF_WRITTEN_STRIP_SUFFIX } from '../content/metadata/sweep.js';
 import { CITED_PICTURE_DIRECTORY } from '../webmention/cited-picture.js';
 import { uploadMarkdown } from './uploads.js';
 /**
@@ -37,6 +38,8 @@ export async function listUploads(contentDir) {
         // .DS_Store is not something anybody uploaded or wants to link to.
         if (entry.name.startsWith('.'))
             continue;
+        if (entry.name.endsWith(HALF_WRITTEN_STRIP_SUFFIX))
+            continue;
         const file = path.join(entry.parentPath, entry.name);
         const relative = path.relative(root, file).split(path.sep).join('/');
         if (relative.startsWith(`${CITED_PICTURE_DIRECTORY}/`))