@geekity/cms 0.30.0 → 0.32.0

package/dist/federation/webfinger.js

@@ -0,0 +1,70 @@
+import { accountOf, authorHref } from '../content/authors.js';
+import { absoluteUrl } from '../util/url.js';
+import { handleHref } from './paths.js';
+/** Where WebFinger lives, which is defined on the host rather than under a site. */
+export const WEBFINGER_PATH = '/.well-known/webfinger';
+/** `acct:{username}@{host}`, the handle a person types into a search box. */
+export function acctOf(username, baseUrl) {
+    return `acct:${accountOf(username, baseUrl)}`;
+}
+/**
+ * The user a WebFinger `resource` asks about, or `undefined` for one this site
+ * answers for nobody.
+ *
+ * Every spelling of a person resolves, and they are the ones decision-14 lists
+ * as their aliases: the `acct:` handle, the author archive, `/@{username}` and
+ * — for somebody who was published elsewhere first — the id they were
+ * published under. Matching every one of them is what lets a peer that holds
+ * any one URL for this person find the others, which is the whole job of
+ * WebFinger, and it is how a server holding only `?author=2` discovers that
+ * the account it follows is still here.
+ *
+ * Both sides of the comparison go through {@link canonicalResource} first, so
+ * the spellings that differ only in how they were typed are one spelling by
+ * the time they are matched, and no spelling needs a branch of its own.
+ */
+export function webFingerUser(users, resource, baseUrl) {
+    const wanted = canonicalResource(resource);
+    if (wanted === '')
+        return undefined;
+    return users.find((user) => [
+        acctOf(user.username, baseUrl),
+        absoluteUrl(authorHref(user.username), baseUrl),
+        absoluteUrl(handleHref(user.username), baseUrl),
+        ...(user.actorId === undefined ? [] : [user.actorId]),
+    ].some((spelling) => canonicalResource(spelling) === wanted));
+}
+/**
+ * One resource in the spelling every equivalent one reduces to.
+ *
+ * A host is case-insensitive — in DNS, in RFC 3986 and in RFC 7033 — so
+ * `acct:ada@EXAMPLE.COM` names the same person as `acct:ada@example.com` and
+ * has to find them. A username is not: Geekity compares one case sensitively
+ * (see {@link User.username}), so the case is left exactly as it was asked
+ * for and `acct:Ada@example.com` stays somebody this site does not have.
+ *
+ * A bare `user@host` is not what RFC 7033 asks for, but it is what enough
+ * clients send that refusing it would only look like a missing account, and
+ * the same goes for the leading `@` of `@ada@example.com`, which is how the
+ * handle is written everywhere a person reads it. Both are spelled back out
+ * as the `acct:` URI they meant.
+ */
+function canonicalResource(resource) {
+    const trimmed = resource.trim();
+    // A URL carries its own rules, and `URL` applies them: the scheme and the
+    // host come back lower-cased, the path untouched.
+    if (/^[a-z][a-z\d+.-]*:\/\//i.test(trimmed)) {
+        try {
+            return new URL(trimmed).href;
+        }
+        catch {
+            return trimmed;
+        }
+    }
+    const handle = trimmed.replace(/^acct:/i, '').replace(/^@/, '');
+    const at = handle.lastIndexOf('@');
+    if (at <= 0)
+        return handle;
+    return `acct:${handle.slice(0, at)}@${handle.slice(at + 1).toLowerCase()}`;
+}
+//# sourceMappingURL=webfinger.js.map

package/dist/federation/webfinger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webfinger.js","sourceRoot":"","sources":["../../src/federation/webfinger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,wBAAwB,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,UAAU,MAAM,CAAC,QAAgB,EAAE,OAAe;IACtD,OAAO,QAAQ,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAsB,EACtB,QAAgB,EAChB,OAAe;IAEf,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAEpC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACzB;QACE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC9B,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAC/C,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAC/C,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;KACtD,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEhC,0EAA0E;IAC1E,kDAAkD;IAClD,IAAI,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAChE,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3B,OAAO,QAAQ,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AAC7E,CAAC"}

package/dist/files/atomic.d.ts

@@ -113,4 +113,13 @@ export declare function writeFileAtomicallySync(file: string, contents: FileCont
  * error to handle at each call site.
  */
 export declare function readFileIfPresentSync(file: string): string | undefined;
+/**
+ * A temporary name beside the file, unique to this write.
+ *
+ * Beside it rather than in the system temporary directory because `rename(2)`
+ * is only atomic within one filesystem. The process id keeps two processes on
+ * one site apart and the counter keeps two writes in one process apart, so a
+ * failed write's leftovers can never be mistaken for another's.
+ */
+export declare function temporaryName(file: string): string;
 //# sourceMappingURL=atomic.d.ts.map

package/dist/files/atomic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atomic.d.ts","sourceRoot":"","sources":["../../src/files/atomic.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,qDAAqD;AACrD,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,MAAM,GAAG,SAAS,KACxB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAU1C;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,IAAI,EAAE,MAAM,EAGvB;CACF;AAKD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,IAAI,CAa5E;AAcD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,0BAA+B,GACvC,IAAI,CAgBN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMtE"}
+{"version":3,"file":"atomic.d.ts","sourceRoot":"","sources":["../../src/files/atomic.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,qDAAqD;AACrD,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,MAAM,GAAG,SAAS,KACxB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAE1C;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,IAAI,EAAE,MAAM,EAGvB;CACF;AAKD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,IAAI,CAa5E;AAcD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,0BAA+B,GACvC,IAAI,CAgBN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMtE;AAyCD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD"}

package/dist/files/atomic.js

@@ -1,6 +1,7 @@
 import { mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
 import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
 import path from 'node:path';
+import { createSerialQueue } from '../util/queue.js';
 /**
  * A write refused because its directory is read-only for now: a worker that
  * is handing over to a new one under `geekity serve` (TASK-288) writes
@@ -144,18 +145,12 @@ export function readFileIfPresentSync(file) {
 /** Run a task once every task already queued for this path has finished. */
 function enqueue(file, task) {
     const key = path.resolve(file);
-    const queue = queues.get(key) ?? { last: Promise.resolve(), waiting: 0 };
-    queue.waiting += 1;
+    const queue = queues.get(key) ?? createSerialQueue();
     queues.set(key, queue);
-    // The chain is of settled promises: a task that throws still lets the next
-    // one run, and its rejection reaches only the caller that queued it.
-    const next = queue.last.then(task, task);
-    queue.last = next.catch(() => undefined);
-    return next.finally(() => {
+    return queue.run(task).finally(() => {
         // The last one out turns the light off, so a process that has been running
         // for a year does not hold an entry per file it has ever written.
-        queue.waiting -= 1;
-        if (queue.waiting === 0 && queues.get(key) === queue)
+        if (queue.pending() === 0 && queues.get(key) === queue)
             queues.delete(key);
     });
 }
@@ -188,7 +183,7 @@ let sequence = 0;
  * one site apart and the counter keeps two writes in one process apart, so a
  * failed write's leftovers can never be mistaken for another's.
  */
-function temporaryName(file) {
+export function temporaryName(file) {
     sequence += 1;
     return `${file}.${process.pid.toString(36)}-${sequence.toString(36)}.tmp`;
 }

package/dist/files/atomic.js.map

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

package/dist/files/data-files.d.ts

@@ -0,0 +1,104 @@
+/**
+ * What a file under `data/` is to the site, and so what a site export does
+ * with it. Decide with an exhaustive `switch` on `kind`, so a new
+ * member breaks every place that has to decide about it.
+ */
+export type DataClass = 
+/** The site cannot be rebuilt without it. Always exported. */
+{
+    readonly kind: 'kept';
+}
+/** Typed in again from another service: an API key, a login. Exported only when asked. */
+ | {
+    readonly kind: 'credential';
+}
+/** The site makes it again, fetches it again, or falls back to a default. Never exported. */
+ | {
+    readonly kind: 'rebuildable';
+}
+/** Work not done yet, tied to this host. Never exported; drained before a move. */
+ | {
+    readonly kind: 'pending';
+}
+/** Left by a write or a lock in flight. Never exported. */
+ | {
+    readonly kind: 'scratch';
+};
+export interface DataFileDeclaration {
+    /** Under `dataDir`, `/`-separated. `*` is any run of characters in one segment and `**` any depth: `keys/*.jwk`, `images/**`. */
+    readonly pattern: string;
+    readonly dataClass: DataClass;
+    /** One sentence for the docs and `geekity export --list`: what is lost if it is lost. */
+    readonly lost: string;
+}
+export declare function dataFileMatches(declaration: DataFileDeclaration, relative: string): boolean;
+/**
+ * The declaration that covers a `/`-separated path, or `undefined` when none
+ * does. A scratch declaration wins over any other, wherever it is in the list,
+ * so a temporary file inside a kept folder is scratch. Among the rest, the
+ * first that covers it wins.
+ */
+export declare function dataFileFor(declarations: readonly DataFileDeclaration[], relative: string): DataFileDeclaration | undefined;
+export declare function writtenPrivately(declaration: DataFileDeclaration): boolean;
+export declare function declareDataFile(declaration: DataFileDeclaration): DataFileDeclaration;
+export declare function dataPath(dataDir: string, file: DataFileDeclaration, ...parts: string[]): string;
+/** The folder that holds what `folder` declares: `keys/` for `keys/*.jwk`, `images/` for `images/**`. */
+export declare function dataFolder(dataDir: string, folder: DataFileDeclaration, ...parts: string[]): string;
+export declare const TEMPORARY_FILES: DataFileDeclaration;
+export declare const LOCK_FILES: DataFileDeclaration;
+export declare const LOCK_TAKEOVER_FILES: DataFileDeclaration;
+export declare const IMPORT_MARKER: DataFileDeclaration;
+export declare const IMPORT_STAGING: DataFileDeclaration;
+export declare const IMPORT_ASIDE: DataFileDeclaration;
+export declare const EXPORTS: DataFileDeclaration;
+export declare const ACTOR_KEYS: DataFileDeclaration;
+export declare const USERS: DataFileDeclaration;
+export declare const NOTIFICATION_SECRET: DataFileDeclaration;
+export declare const COMMENT_SALT: DataFileDeclaration;
+export declare const COMMENT_EMAILS: DataFileDeclaration;
+export declare const CONTACT_MESSAGES: DataFileDeclaration;
+export declare const COMMENT_OPTOUTS: DataFileDeclaration;
+export declare const INDIEAUTH_TOKENS: DataFileDeclaration;
+export declare const LOCATIONS: DataFileDeclaration;
+export declare const KEPT_PROPERTIES: DataFileDeclaration;
+export declare const PLUGIN_CHANGES: DataFileDeclaration;
+export declare const JOBS: DataFileDeclaration;
+export declare const DEV_MODE_RECORD: DataFileDeclaration;
+export declare const INDIEAUTH_ACTIVITY: DataFileDeclaration;
+export declare const NOTIFICATION_DIGESTS: DataFileDeclaration;
+export declare const MICROPUB_MEDIA: DataFileDeclaration;
+export declare const DATABASE: DataFileDeclaration;
+export declare const DATABASE_LOG: DataFileDeclaration;
+export declare const IMAGES: DataFileDeclaration;
+export declare const AVATARS: DataFileDeclaration;
+export declare const QUEUE: DataFileDeclaration;
+export declare const QUEUE_LOG: DataFileDeclaration;
+export declare const CORE_DATA_FILES: readonly DataFileDeclaration[];
+export declare const WATCH_PROBE: DataFileDeclaration;
+export declare const CONTENT_SCRATCH_FILES: readonly DataFileDeclaration[];
+export interface ClassifiedFile {
+    /** Under the folder walked, `/`-separated. */
+    readonly relative: string;
+    readonly absolute: string;
+    /** The declaration {@link dataFileFor} gives it, or `undefined` when none covers it. */
+    readonly declaration: DataFileDeclaration | undefined;
+}
+/**
+ * The folder `fsck` keeps at the root of an ext filesystem, owned by root. A
+ * `content/` or `data/` that is a mount point holds one. It is the
+ * filesystem's, not the site's: nothing walks it, exports it or moves it.
+ */
+export declare const LOST_AND_FOUND = "lost+found";
+export declare const OTHER_ENTRY_KINDS: readonly ['a symbolic link', 'a socket', 'a FIFO', 'a device'];
+export type OtherEntryKind = (typeof OTHER_ENTRY_KINDS)[number];
+export interface ClassifiedOther extends ClassifiedFile {
+    readonly kind: OtherEntryKind;
+}
+export interface ClassifiedEntries {
+    readonly files: ClassifiedFile[];
+    readonly others: ClassifiedOther[];
+}
+export declare function classifyEntries(dir: string, declarations: readonly DataFileDeclaration[]): ClassifiedEntries;
+/** Every regular file under `dir`, sorted by its relative path, with the declaration that covers it. */
+export declare function classifyFiles(dir: string, declarations: readonly DataFileDeclaration[]): ClassifiedFile[];
+//# sourceMappingURL=data-files.d.ts.map

package/dist/files/data-files.d.ts.map

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

package/dist/files/data-files.js

@@ -0,0 +1,330 @@
+import { readdirSync } from 'node:fs';
+import path from 'node:path';
+import { isNotFound } from '../util/files.js';
+const ANY_DEPTH = '**';
+function segmentsOf(pattern) {
+    return pattern.split('/');
+}
+function isWildcard(segment) {
+    return segment.includes('*');
+}
+function segmentMatches(glob, segment) {
+    if (segment === '' || segment === '.' || segment === '..')
+        return false;
+    const source = glob
+        .split('*')
+        .map((part) => part.replace(/[.+?^${}()|[\]\\]/g, '\\$&'))
+        .join('[^/]*');
+    return new RegExp(`^${source}$`).test(segment);
+}
+function segmentsMatch(globs, segments) {
+    const [glob, ...restGlobs] = globs;
+    if (glob === undefined)
+        return segments.length === 0;
+    if (glob === ANY_DEPTH) {
+        return (segments.some((_, index) => segmentsMatch(restGlobs, segments.slice(index))) ||
+            segmentsMatch(restGlobs, []));
+    }
+    const [segment, ...restSegments] = segments;
+    return (segment !== undefined && segmentMatches(glob, segment) && segmentsMatch(restGlobs, restSegments));
+}
+export function dataFileMatches(declaration, relative) {
+    return segmentsMatch(segmentsOf(declaration.pattern), segmentsOf(relative));
+}
+/**
+ * The declaration that covers a `/`-separated path, or `undefined` when none
+ * does. A scratch declaration wins over any other, wherever it is in the list,
+ * so a temporary file inside a kept folder is scratch. Among the rest, the
+ * first that covers it wins.
+ */
+export function dataFileFor(declarations, relative) {
+    const covering = declarations.filter((declaration) => dataFileMatches(declaration, relative));
+    return covering.find((declaration) => declaration.dataClass.kind === 'scratch') ?? covering[0];
+}
+export function writtenPrivately(declaration) {
+    return declaration.dataClass.kind === 'credential';
+}
+export function declareDataFile(declaration) {
+    const segments = segmentsOf(declaration.pattern);
+    if (segments.some((segment) => segment === '' || segment === '.' || segment === '..')) {
+        throw new Error(`${declaration.pattern} is not a relative pattern of named segments.`);
+    }
+    return Object.freeze({ ...declaration });
+}
+export function dataPath(dataDir, file, ...parts) {
+    const refuse = () => {
+        throw new Error(`${parts.join('/')} is not a path ${file.pattern} declares under data/.`);
+    };
+    const built = [];
+    let next = 0;
+    for (const glob of segmentsOf(file.pattern)) {
+        if (!isWildcard(glob)) {
+            built.push(glob);
+            continue;
+        }
+        const taken = glob === ANY_DEPTH ? parts.slice(next) : parts.slice(next, next + 1);
+        if (taken.length === 0)
+            refuse();
+        if (!taken.every((part) => segmentMatches(glob === ANY_DEPTH ? '*' : glob, part)))
+            refuse();
+        built.push(...taken);
+        next += taken.length;
+    }
+    if (next !== parts.length)
+        refuse();
+    return path.join(dataDir, ...built);
+}
+/** The folder that holds what `folder` declares: `keys/` for `keys/*.jwk`, `images/` for `images/**`. */
+export function dataFolder(dataDir, folder, ...parts) {
+    const segments = segmentsOf(folder.pattern);
+    if (segments.length < 2)
+        throw new Error(`${folder.pattern} declares a file, not a folder.`);
+    return dataPath(dataDir, { ...folder, pattern: segments.slice(0, -1).join('/') }, ...parts);
+}
+const KEPT = { kind: 'kept' };
+const REBUILDABLE = { kind: 'rebuildable' };
+const PENDING = { kind: 'pending' };
+const SCRATCH = { kind: 'scratch' };
+export const TEMPORARY_FILES = declareDataFile({
+    pattern: '**/*.*-*.tmp',
+    dataClass: SCRATCH,
+    lost: 'Nothing. An atomic write that crashed can leave one behind.',
+});
+export const LOCK_FILES = declareDataFile({
+    pattern: '**/*.lock',
+    dataClass: SCRATCH,
+    lost: 'Nothing. A stale lock is taken over.',
+});
+export const LOCK_TAKEOVER_FILES = declareDataFile({
+    pattern: '**/*.lock.takeover',
+    dataClass: SCRATCH,
+    lost: 'Nothing. A waiter holds it while it removes a stale lock.',
+});
+export const IMPORT_MARKER = declareDataFile({
+    pattern: '.geekity-import',
+    dataClass: SCRATCH,
+    lost: 'Nothing. geekity import leaves it until an import is finished, so a second run knows the folder is its own.',
+});
+export const IMPORT_STAGING = declareDataFile({
+    pattern: '.geekity-importing/**',
+    dataClass: SCRATCH,
+    lost: 'Nothing. geekity import unpacks an archive here and moves it into place; a stopped import leaves it for the next run to remove.',
+});
+export const IMPORT_ASIDE = declareDataFile({
+    pattern: '.geekity-before-import-*/**',
+    dataClass: SCRATCH,
+    lost: 'What the folder held before geekity import --replace. Delete it once the imported site is checked.',
+});
+export const EXPORTS = declareDataFile({
+    pattern: 'exports/**',
+    dataClass: SCRATCH,
+    lost: 'Nothing. A site export written for the admin to download, made again on request.',
+});
+export const ACTOR_KEYS = declareDataFile({
+    pattern: 'keys/*.jwk',
+    dataClass: KEPT,
+    lost: "The actors' signing keys: remote servers reject signatures until they fetch the actor again, and proofs on objects already sent stop verifying.",
+});
+export const USERS = declareDataFile({
+    pattern: 'users.json',
+    dataClass: KEPT,
+    lost: 'Every account: usernames, which are the actor ids, emails, password hashes and profiles.',
+});
+export const NOTIFICATION_SECRET = declareDataFile({
+    pattern: 'notification-secret',
+    dataClass: KEPT,
+    lost: 'Every moderation and unsubscribe link in mail already sent stops working.',
+});
+export const COMMENT_SALT = declareDataFile({
+    pattern: 'comment-salt',
+    dataClass: KEPT,
+    lost: 'Address hashes written before the loss can no longer be compared with new ones.',
+});
+export const COMMENT_EMAILS = declareDataFile({
+    pattern: 'comments/*.json',
+    dataClass: KEPT,
+    lost: "Commenters' emails, and their reply subscriptions.",
+});
+export const CONTACT_MESSAGES = declareDataFile({
+    pattern: 'contact/*.json',
+    dataClass: KEPT,
+    lost: 'Contact messages.',
+});
+export const COMMENT_OPTOUTS = declareDataFile({
+    pattern: 'comment-optouts.json',
+    dataClass: KEPT,
+    lost: 'The list of people who unsubscribed, so the site would write to them again.',
+});
+export const INDIEAUTH_TOKENS = declareDataFile({
+    pattern: 'indieauth-tokens.json',
+    dataClass: KEPT,
+    lost: 'Every connected IndieAuth or Micropub app has to sign in again.',
+});
+export const LOCATIONS = declareDataFile({
+    pattern: 'locations.json',
+    dataClass: KEPT,
+    lost: 'Where each post was written.',
+});
+export const KEPT_PROPERTIES = declareDataFile({
+    pattern: 'kept-properties.json',
+    dataClass: KEPT,
+    lost: 'Micropub properties the site does not understand, such as an RSVP.',
+});
+export const PLUGIN_CHANGES = declareDataFile({
+    pattern: 'plugin-changes.json',
+    dataClass: KEPT,
+    lost: 'Who added, updated and removed which plugin. Nothing else holds it.',
+});
+export const JOBS = declareDataFile({
+    pattern: 'jobs.json',
+    dataClass: KEPT,
+    lost: 'Queued jobs and the last five results for each job name.',
+});
+export const DEV_MODE_RECORD = declareDataFile({
+    pattern: 'dev-mode.jsonl',
+    dataClass: KEPT,
+    lost: 'The record that proves a migration was silent.',
+});
+export const INDIEAUTH_ACTIVITY = declareDataFile({
+    pattern: 'indieauth-activity.json',
+    dataClass: REBUILDABLE,
+    lost: 'The last IndieAuth and Micropub requests, which exist for debugging.',
+});
+export const NOTIFICATION_DIGESTS = declareDataFile({
+    pattern: 'notification-digests.json',
+    dataClass: REBUILDABLE,
+    lost: 'When each user last had a digest, so one digest may come a window early.',
+});
+export const MICROPUB_MEDIA = declareDataFile({
+    pattern: 'micropub-media.json',
+    dataClass: REBUILDABLE,
+    lost: "Each user's last upload for Micropub's q=last, empty until the next upload.",
+});
+export const DATABASE = declareDataFile({
+    pattern: 'geekity.db',
+    dataClass: REBUILDABLE,
+    lost: 'The index, rebuilt from files, and sessions, delivery outcomes and other caches, which start empty.',
+});
+export const DATABASE_LOG = declareDataFile({
+    pattern: 'geekity.db-*',
+    dataClass: REBUILDABLE,
+    lost: "The database's write-ahead log, which goes with the database.",
+});
+export const IMAGES = declareDataFile({
+    pattern: 'images/**',
+    dataClass: REBUILDABLE,
+    lost: 'Image variants and icons, derived again from content/uploads/ when a page asks for them.',
+});
+export const AVATARS = declareDataFile({
+    pattern: 'avatars/*',
+    dataClass: REBUILDABLE,
+    lost: 'Cached avatars, fetched again by the avatar sweep.',
+});
+export const QUEUE = declareDataFile({
+    pattern: 'queue.sqlite',
+    dataClass: PENDING,
+    lost: "Queued deliveries, inbox work and Fedify's scheduled retries.",
+});
+export const QUEUE_LOG = declareDataFile({
+    pattern: 'queue.sqlite-*',
+    dataClass: PENDING,
+    lost: "The queue's write-ahead log, which goes with the queue.",
+});
+export const CORE_DATA_FILES = [
+    TEMPORARY_FILES,
+    LOCK_FILES,
+    LOCK_TAKEOVER_FILES,
+    IMPORT_MARKER,
+    IMPORT_STAGING,
+    IMPORT_ASIDE,
+    EXPORTS,
+    ACTOR_KEYS,
+    USERS,
+    NOTIFICATION_SECRET,
+    COMMENT_SALT,
+    COMMENT_EMAILS,
+    CONTACT_MESSAGES,
+    COMMENT_OPTOUTS,
+    INDIEAUTH_TOKENS,
+    LOCATIONS,
+    KEPT_PROPERTIES,
+    PLUGIN_CHANGES,
+    JOBS,
+    DEV_MODE_RECORD,
+    INDIEAUTH_ACTIVITY,
+    NOTIFICATION_DIGESTS,
+    MICROPUB_MEDIA,
+    DATABASE,
+    DATABASE_LOG,
+    IMAGES,
+    AVATARS,
+    QUEUE,
+    QUEUE_LOG,
+];
+export const WATCH_PROBE = declareDataFile({
+    pattern: '.geekity-watch-*/**',
+    dataClass: SCRATCH,
+    lost: 'Nothing. The content watcher makes it and removes it to check that it works.',
+});
+export const CONTENT_SCRATCH_FILES = [
+    TEMPORARY_FILES,
+    IMPORT_MARKER,
+    IMPORT_STAGING,
+    IMPORT_ASIDE,
+    WATCH_PROBE,
+];
+/**
+ * The folder `fsck` keeps at the root of an ext filesystem, owned by root. A
+ * `content/` or `data/` that is a mount point holds one. It is the
+ * filesystem's, not the site's: nothing walks it, exports it or moves it.
+ */
+export const LOST_AND_FOUND = 'lost+found';
+export const OTHER_ENTRY_KINDS = ['a symbolic link', 'a socket', 'a FIFO', 'a device'];
+function kindOf(entry) {
+    if (entry.isSymbolicLink())
+        return 'a symbolic link';
+    if (entry.isSocket())
+        return 'a socket';
+    if (entry.isFIFO())
+        return 'a FIFO';
+    return 'a device';
+}
+function byRelative(a, b) {
+    return a.relative < b.relative ? -1 : a.relative > b.relative ? 1 : 0;
+}
+export function classifyEntries(dir, declarations) {
+    const files = [];
+    const others = [];
+    const walk = (folder) => {
+        let entries;
+        try {
+            entries = readdirSync(folder, { withFileTypes: true });
+        }
+        catch (error) {
+            if (isNotFound(error))
+                return;
+            throw error;
+        }
+        for (const entry of entries) {
+            const absolute = path.join(folder, entry.name);
+            if (entry.isDirectory()) {
+                if (folder !== dir || entry.name !== LOST_AND_FOUND)
+                    walk(absolute);
+                continue;
+            }
+            const relative = path.relative(dir, absolute).split(path.sep).join('/');
+            const classified = { relative, absolute, declaration: dataFileFor(declarations, relative) };
+            if (entry.isFile())
+                files.push(classified);
+            else
+                others.push({ ...classified, kind: kindOf(entry) });
+        }
+    };
+    walk(dir);
+    return { files: files.sort(byRelative), others: others.sort(byRelative) };
+}
+/** Every regular file under `dir`, sorted by its relative path, with the declaration that covers it. */
+export function classifyFiles(dir, declarations) {
+    return classifyEntries(dir, declarations).files;
+}
+//# sourceMappingURL=data-files.js.map

package/dist/files/data-files.js.map

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

package/dist/files/export-archives.d.ts

@@ -0,0 +1,12 @@
+export interface ExportArchive {
+    readonly name: string;
+    readonly path: string;
+    readonly writtenAt: Date;
+    readonly expiresAt: Date;
+}
+export declare function expireExports(dataDir: string, now: Date): Promise<number>;
+export declare function currentExport(dataDir: string, now: Date): Promise<(ExportArchive & {
+    readonly size: number;
+}) | undefined>;
+export declare function keepOnlyExport(dataDir: string, keep: string): Promise<void>;
+//# sourceMappingURL=export-archives.d.ts.map

package/dist/files/export-archives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-archives.d.ts","sourceRoot":"","sources":["../../src/files/export-archives.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAkCD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAS/E;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,CAAC,aAAa,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAAC,CAUlE;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjF"}