@geekity/plugin-wordpress 0.0.0-stage → 0.1.0

package/dist/import.js

@@ -0,0 +1,461 @@
+import { createPrivateKey, createPublicKey } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { exportJwk } from '@fedify/fedify';
+import { WORDPRESS_ACTIVITYPUB_BASE } from './records.js';
+/**
+ * Bringing one person across from the WordPress ActivityPub plugin
+ * (decision-14, TASK-71).
+ *
+ * Three things a site leaving the plugin cannot regenerate, and this is where
+ * they arrive: the RSA key pair its followers have cached, the actor id its
+ * followers key the account by, and the followers themselves. Everything else
+ * about the move — the posts, their ids, the compatibility paths — comes in
+ * with the content or is this plugin.
+ *
+ * Nothing here is a screen, on purpose. A stored actor id is identity for the
+ * life of the account (doc-4), and identity is not something a form should be
+ * able to retype.
+ */
+/** The algorithm the plugin signs with, and the only one it has a key for. */
+const RSA = 'RSASSA-PKCS1-v1_5';
+/**
+ * Thrown when the user already has a key pair and this run was not told to
+ * replace it.
+ *
+ * Its own class because the answer is a flag rather than a correction, and
+ * because losing a private key is the one mistake this CMS cannot help with:
+ * every follower's server has cached the public half, and a new key means none
+ * of them can verify this person again.
+ */
+export class ExistingKeyPairError extends Error {
+    name = 'ExistingKeyPairError';
+    /** The file that is already there. */
+    file;
+    constructor(username, file) {
+        super(`${username} already has a different key pair, in ${file}. Importing over it would ` +
+            'change their identity: every follower has cached the public half of the key that is ' +
+            'there, and none of them could verify this person again. Pass --force only if you are ' +
+            'sure the pair being imported is the one the followers hold.');
+        this.file = file;
+    }
+}
+/** Thrown when the PEM is not an RSA private key at all. */
+export class UnusableKeyPemError extends Error {
+    name = 'UnusableKeyPemError';
+}
+/**
+ * Bring one WordPress actor's key pair across, and say what changed.
+ *
+ * Run twice with the same inputs it changes nothing and says so, which is what
+ * makes it safe to run again after a follower's server was down.
+ */
+export async function importWordPressActor(options) {
+    const { site, records, username } = options;
+    // Everything that can be refused is decided before anything is written, so a
+    // run that is going to stop stops with the disk as it was.
+    assertIdentityFree(options);
+    const planned = await planKeyImport(options);
+    const actorIdChanged = await site.setActorId(username, options.actorId);
+    const numberChanged = await records.setNumber(username, options.wordpressActorId);
+    const identity = actorIdChanged || numberChanged ? 'set' : 'unchanged';
+    const keys = [applyKeyImport(site, username, planned)];
+    // The Ed25519 pair is minted here rather than left to the first request,
+    // because this is also what proves the file just written imports: Fedify
+    // swallows what a key pairs dispatcher throws, so an unusable key found at
+    // request time would be found by nobody.
+    const hadEd25519 = site.actorKey(username, 'Ed25519').jwk !== undefined;
+    await site.loadActorKeys(username);
+    keys.push({
+        file: site.actorKey(username, 'Ed25519').file,
+        algorithm: 'Ed25519',
+        state: hadEd25519 ? 'unchanged' : 'generated',
+    });
+    const followers = await importFollowers(options);
+    return {
+        username,
+        actorId: options.actorId,
+        wordpressActorId: options.wordpressActorId,
+        identity,
+        keys,
+        followers,
+        changed: identity === 'set' ||
+            keys.some((key) => key.state !== 'unchanged') ||
+            followers.added.length > 0 ||
+            followers.refreshed.length > 0,
+    };
+}
+/**
+ * Refuse a user the site does not have, and an id or a number somebody else
+ * already carries: two accounts answering to one identity is not something to
+ * pick a winner for.
+ */
+function assertIdentityFree(options) {
+    const { site, records, username } = options;
+    const users = site.users();
+    if (!users.some((user) => user.username === username)) {
+        throw new Error(`This site has no user named "${username}".`);
+    }
+    const byActorId = users.find((user) => user.username !== username && user.actorId === options.actorId);
+    if (byActorId !== undefined) {
+        throw new Error(`The actor id ${options.actorId} already belongs to "${byActorId.username}".`);
+    }
+    for (const [other, number] of records.actors()) {
+        if (other !== username && number === options.wordpressActorId) {
+            throw new Error(`WordPress actor ${String(options.wordpressActorId)} already belongs to "${other}".`);
+        }
+    }
+}
+/**
+ * Bring the followers across: read the collection, work out who each item is,
+ * and put them in the user's `followers.json` and the index.
+ *
+ * The plugin's collection carries nothing but a `first` page, and the page's
+ * `orderedItems` are bare actor URLs, so almost every follower here costs one
+ * fetch. That is the one step of the import that is really a network
+ * operation, which is why it can be pointed at a file instead: an owner who
+ * saved the collection before the DNS moved has everything they need offline.
+ *
+ * The site's `addFollower` is what writes, so a follower already in the file
+ * keeps the place and the follow time it has — running this again after an
+ * instance came back adds the missing people and moves nobody.
+ */
+async function importFollowers(options) {
+    const empty = {
+        source: undefined,
+        added: [],
+        unchanged: [],
+        refreshed: [],
+        failed: [],
+    };
+    if (options.followers === false)
+        return empty;
+    const { site, username } = options;
+    const source = options.followers ?? followersCollectionUrl(options);
+    const added = [];
+    const unchanged = [];
+    const refreshed = [];
+    const failed = [];
+    for (const item of await collectionItems(source)) {
+        const actor = uriOf(item) ?? String(item);
+        try {
+            const document = isRecord(item) && uriOf(item['inbox']) !== null ? item : await fetchAs(actor);
+            const follower = followerFrom(document);
+            const held = site.followers(username).find((entry) => entry.actorId === follower.actorId);
+            await site.addFollower(username, follower);
+            if (held === undefined)
+                added.push(follower.actorId);
+            else if (sameFollower(held, follower))
+                unchanged.push(follower.actorId);
+            else
+                refreshed.push(follower.actorId);
+        }
+        catch (error) {
+            failed.push({ actor, reason: messageOf(error) });
+        }
+    }
+    return { source, added, unchanged, refreshed, failed };
+}
+/**
+ * The plugin's public followers collection for this actor.
+ *
+ * Built from the stored actor id's own origin rather than from anything the
+ * command was told separately: the id is the one URL an owner is certain to
+ * have right, and it is the site the followers are still pointed at.
+ */
+function followersCollectionUrl(options) {
+    const number = String(options.wordpressActorId);
+    return new URL(`${WORDPRESS_ACTIVITYPUB_BASE}/actors/${number}/followers`, options.actorId).href;
+}
+/**
+ * Everything a followers collection names, in the order it names them.
+ *
+ * A collection with no items of its own is followed through `first`, and a
+ * page through `next`, until there is nowhere left to go; either may be a URL
+ * to fetch or a page already embedded in the document. URLs already visited
+ * are not visited again, because a server whose `next` points back at itself
+ * would otherwise be an endless import.
+ */
+async function collectionItems(source) {
+    const items = [];
+    const seen = new Set();
+    let document = isUrl(source) ? await fetchAs(source) : readJsonFile(source);
+    if (isUrl(source))
+        seen.add(source);
+    while (isRecord(document)) {
+        const listed = document['orderedItems'] ?? document['items'];
+        const here = Array.isArray(listed) ? listed : undefined;
+        if (here !== undefined)
+            items.push(...here);
+        // `next` on a page; `first` only when this document listed nothing itself,
+        // which is the plugin's outer collection.
+        const onward = document['next'] ?? (here === undefined ? document['first'] : undefined);
+        if (onward === undefined || onward === null)
+            break;
+        if (isRecord(onward)) {
+            document = onward;
+            continue;
+        }
+        const url = uriOf(onward);
+        if (url === null || seen.has(url))
+            break;
+        seen.add(url);
+        document = await fetchAs(url);
+    }
+    return items;
+}
+/** A saved collection, as the JSON it holds. */
+function readJsonFile(file) {
+    let source;
+    try {
+        source = readFileSync(file, 'utf8');
+    }
+    catch {
+        throw new Error(`There is no followers collection at ${file}.`);
+    }
+    try {
+        return JSON.parse(source);
+    }
+    catch (error) {
+        throw new Error(`${file} could not be read as JSON: ${messageOf(error)}`, { cause: error });
+    }
+}
+/** Whether a `--followers` value is a URL to fetch rather than a file to read. */
+function isUrl(source) {
+    const protocol = URL.parse(source)?.protocol;
+    return protocol === 'http:' || protocol === 'https:';
+}
+/** What a peer should ask a fediverse server for. */
+const ACTIVITY_STREAMS_ACCEPT = 'application/activity+json, application/ld+json; profile="https://www.w3.org/ns/activitystreams"';
+/** One ActivityStreams document, or a thrown error naming the URL and the status. */
+async function fetchAs(url) {
+    let response;
+    try {
+        response = await fetch(url, { headers: { accept: ACTIVITY_STREAMS_ACCEPT } });
+    }
+    catch (error) {
+        throw new Error(`${url} could not be fetched: ${messageOf(error)}`, { cause: error });
+    }
+    if (!response.ok) {
+        throw new Error(`${url} answered ${String(response.status)} ${response.statusText}`.trim());
+    }
+    try {
+        return await response.json();
+    }
+    catch (error) {
+        throw new Error(`${url} did not answer with JSON: ${messageOf(error)}`, { cause: error });
+    }
+}
+/**
+ * One actor document as the follower it stands for.
+ *
+ * Read straight out of the JSON rather than through Fedify's vocabulary,
+ * because a command has a plain document and no federation context to
+ * dereference with. The fields are the ones `followers.json` holds (doc-4):
+ * two to deliver with, the rest to show.
+ */
+function followerFrom(document) {
+    if (!isRecord(document))
+        throw new Error('that is not an actor document');
+    const actorId = uriOf(document['id']);
+    const inboxId = uriOf(document['inbox']);
+    if (actorId === null)
+        throw new Error('that actor document has no id');
+    if (inboxId === null)
+        throw new Error(`${actorId} publishes no inbox to deliver to`);
+    const endpoints = document['endpoints'];
+    const icon = document['icon'];
+    return {
+        actorId,
+        inboxId,
+        sharedInboxId: isRecord(endpoints) ? uriOf(endpoints['sharedInbox']) : null,
+        handle: handleOf(document, actorId),
+        name: textOf(document['name']) ?? null,
+        iconUrl: uriOf(isRecord(icon) ? icon['url'] : icon),
+        url: uriOf(document['url']),
+    };
+}
+/**
+ * `@name@host` for an actor, from its `preferredUsername` where it has one.
+ *
+ * Falling back to {@link actorHandle}, which guesses from the URL, for the
+ * server that publishes no `preferredUsername` at all.
+ */
+function handleOf(document, actorId) {
+    const preferred = textOf(document['preferredUsername']);
+    if (preferred === undefined || preferred === '')
+        return actorHandle(actorId) ?? null;
+    return `@${preferred.replace(/^@/, '')}@${new URL(actorId).host}`;
+}
+/** Whether a stored follower already says everything this one does. */
+function sameFollower(held, incoming) {
+    return (held.inboxId === incoming.inboxId &&
+        held.sharedInboxId === incoming.sharedInboxId &&
+        held.handle === incoming.handle &&
+        held.name === incoming.name &&
+        held.iconUrl === incoming.iconUrl &&
+        held.url === incoming.url);
+}
+/** A JSON-LD string value, which may be wrapped in a language map. */
+function textOf(value) {
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const found = textOf(item);
+            if (found !== undefined)
+                return found;
+        }
+        return undefined;
+    }
+    if (isRecord(value))
+        return textOf(value['@value']);
+    return typeof value === 'string' && value !== '' ? value : undefined;
+}
+/**
+ * The handle an actor URL implies, `@name@host` from its last path segment,
+ * or `undefined` when the segment is a number or missing.
+ */
+function actorHandle(actorId) {
+    const url = new URL(actorId);
+    const last = url.pathname
+        .split('/')
+        .filter((segment) => segment !== '')
+        .pop();
+    if (last === undefined || /^\d+$/.test(last))
+        return undefined;
+    return `@${last.replace(/^@/, '')}@${url.host}`;
+}
+/**
+ * The URL a JSON-LD value names: a string, a node's `id`, a `Link`'s `href`,
+ * or the first of an array that names one.
+ */
+function uriOf(value) {
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const found = uriOf(item);
+            if (found !== null)
+                return found;
+        }
+        return null;
+    }
+    if (isRecord(value))
+        return uriOf(value['id'] ?? value['@id'] ?? value['href']);
+    if (typeof value !== 'string')
+        return null;
+    return URL.parse(value)?.href ?? null;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Work out what the exported PEM means for the user's RSA key file, without
+ * touching it.
+ *
+ * A file already holding this very key is left alone and reported unchanged —
+ * that is what makes the whole command idempotent — and one holding a
+ * different key is refused unless the run was told to replace it.
+ */
+async function planKeyImport(options) {
+    const { site, username } = options;
+    const privateKey = privateKeyFrom(options.privateKeyPem);
+    assertPairMatches(privateKey, options.publicKeyPem);
+    const jwk = `${JSON.stringify(await privateJwkOf(privateKey), undefined, 2)}\n`;
+    const { file, jwk: held } = site.actorKey(username, RSA);
+    if (held === undefined)
+        return { file, algorithm: RSA, state: 'imported', jwk };
+    if (sameKeyFile(held, jwk))
+        return { file, algorithm: RSA, state: 'unchanged', jwk: undefined };
+    if (options.force !== true)
+        throw new ExistingKeyPairError(username, file);
+    return { file, algorithm: RSA, state: 'replaced', jwk };
+}
+/** Carry out what {@link planKeyImport} decided. */
+function applyKeyImport(site, username, planned) {
+    const { jwk, ...key } = planned;
+    if (jwk !== undefined)
+        site.writeActorKey(username, key.algorithm, jwk);
+    return key;
+}
+/**
+ * The PEM as a key object, whichever of the two encodings the export used.
+ *
+ * PHP writes `-----BEGIN PRIVATE KEY-----` (PKCS#8) on OpenSSL 3 and
+ * `-----BEGIN RSA PRIVATE KEY-----` (PKCS#1) on older builds, and an owner
+ * copying one out of `wp option get` has no reason to know which they have.
+ * `createPrivateKey` reads both.
+ */
+function privateKeyFrom(pem) {
+    const text = pem.trim();
+    if (text === '') {
+        throw new UnusableKeyPemError('The private key is empty. Check what the export wrote.');
+    }
+    let key;
+    try {
+        key = createPrivateKey({ key: text, format: 'pem' });
+    }
+    catch (error) {
+        throw new UnusableKeyPemError(`That is not a PEM private key: ${messageOf(error)}. It should begin with ` +
+            '"-----BEGIN PRIVATE KEY-----" or "-----BEGIN RSA PRIVATE KEY-----".', { cause: error });
+    }
+    if (key.asymmetricKeyType !== 'rsa') {
+        throw new UnusableKeyPemError(`That is a ${String(key.asymmetricKeyType)} key, and the WordPress ActivityPub plugin ` +
+            'signs with RSA. Check that the right key was exported.');
+    }
+    return key;
+}
+/** Refuse an export whose two halves are not halves of one pair. */
+function assertPairMatches(privateKey, publicKeyPem) {
+    const text = (publicKeyPem ?? '').trim();
+    if (text === '')
+        return;
+    let given;
+    try {
+        given = createPublicKey({ key: text, format: 'pem' });
+    }
+    catch (error) {
+        throw new UnusableKeyPemError(`That is not a PEM public key: ${messageOf(error)}.`, {
+            cause: error,
+        });
+    }
+    const derived = createPublicKey(privateKey);
+    if (!given
+        .export({ type: 'spki', format: 'der' })
+        .equals(derived.export({ type: 'spki', format: 'der' }))) {
+        throw new UnusableKeyPemError('The public and private keys are not two halves of one pair. Export both again from the ' +
+            'same WordPress user, or leave the public key off — it is derived from the private one.');
+    }
+}
+/**
+ * The private JWK the key file holds, produced the way a generated one is.
+ *
+ * The PEM goes to DER through node:crypto, into WebCrypto, and out through
+ * Fedify's `exportJwk` — the same call the site makes when it mints a pair.
+ * Going the long way round rather than asking node:crypto for the JWK directly
+ * is what guarantees an imported file and a generated one carry the
+ * same members in the same shape, `alg: "RS256"` included, which is what the
+ * loader's boot check insists on.
+ */
+async function privateJwkOf(privateKey) {
+    const pkcs8 = privateKey.export({ type: 'pkcs8', format: 'der' });
+    const key = await crypto.subtle.importKey('pkcs8', pkcs8, { name: RSA, hash: 'SHA-256' }, true, [
+        'sign',
+    ]);
+    return await exportJwk(key);
+}
+/**
+ * Whether a key file already holds the key being imported.
+ *
+ * Compared as the parsed JWK rather than as bytes, so a file somebody
+ * reindented is still the same key.
+ */
+function sameKeyFile(held, incoming) {
+    try {
+        return (JSON.stringify(JSON.parse(held)) ===
+            JSON.stringify(JSON.parse(incoming)));
+    }
+    catch {
+        return false;
+    }
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=import.js.map

package/dist/import.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@geekity/plugin-wordpress` (decision-33): what a site that moved from the
+ * WordPress ActivityPub plugin needs until its followers' servers have caught
+ * up. Its old inbox and collection paths, the record of when each was last
+ * asked for, and `geekity import wordpress-actor`.
+ *
+ * Stored actor and object ids, WebFinger aliases, the feed and archive layout
+ * and oEmbed are the site's own and stay in `@geekity/cms` (decision-14).
+ */
+export { ExistingKeyPairError, importWordPressActor, UnusableKeyPemError } from './import.ts';
+export type { FollowersImportReport, ImportedKey, ImportWordPressActorOptions, ImportWordPressActorReport, UnreachableFollower, } from './import.ts';
+export { ACTORS_FILE, ConflictingWordPressIdError, REQUESTS_FILE, WORDPRESS_ACTIVITYPUB_BASE, wordPressRecords, wordPressRequestTarget, } from './records.ts';
+export type { WordPressRecords, WordPressRequests, WordPressRequestTarget, WordPressRoute, } from './records.ts';
+declare const _default: import("@geekity/cms/plugin").Plugin<"@geekity/plugin-wordpress", {}>;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC9F,YAAY,EACV,qBAAqB,EACrB,WAAW,EACX,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,2BAA2B,EAC3B,aAAa,EACb,0BAA0B,EAC1B,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,GACf,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * `@geekity/plugin-wordpress` (decision-33): what a site that moved from the
+ * WordPress ActivityPub plugin needs until its followers' servers have caught
+ * up. Its old inbox and collection paths, the record of when each was last
+ * asked for, and `geekity import wordpress-actor`.
+ *
+ * Stored actor and object ids, WebFinger aliases, the feed and archive layout
+ * and oEmbed are the site's own and stay in `@geekity/cms` (decision-14).
+ */
+import { definePlugin } from '@geekity/cms/plugin';
+import { importCommand } from './command.js';
+import { wordPressFederation } from './federation.js';
+import { wordPressRecords } from './records.js';
+import { wordPressScreen } from './screen.js';
+import { VERSION } from './version.js';
+export { ExistingKeyPairError, importWordPressActor, UnusableKeyPemError } from './import.js';
+export { ACTORS_FILE, ConflictingWordPressIdError, REQUESTS_FILE, WORDPRESS_ACTIVITYPUB_BASE, wordPressRecords, wordPressRequestTarget, } from './records.js';
+export default definePlugin({
+    name: '@geekity/plugin-wordpress',
+    version: VERSION,
+    label: 'WordPress',
+    description: 'Answers the inbox and collection paths the WordPress ActivityPub plugin published, ' +
+        'for a site that moved here from it, until every follower has refetched the actor.',
+    hostApi: 1,
+    register(host) {
+        const records = wordPressRecords(host.data);
+        host.federation(wordPressFederation(records));
+        host.screen(wordPressScreen(records));
+        host.command(importCommand(records));
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAQ9F,OAAO,EACL,WAAW,EACX,2BAA2B,EAC3B,aAAa,EACb,0BAA0B,EAC1B,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAQtB,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE,2BAA2B;IACjC,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,WAAW;IAClB,WAAW,EACT,qFAAqF;QACrF,mFAAmF;IACrF,OAAO,EAAE,CAAC;IACV,QAAQ,CAAC,IAAI;QACX,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACvC,CAAC;CACF,CAAC,CAAC"}

package/dist/records.d.ts

@@ -0,0 +1,87 @@
+/**
+ * What the plugin keeps in its data folder, `data/plugins/@geekity/plugin-wordpress/`:
+ * the number the WordPress ActivityPub plugin gave each person, and when each
+ * of its old paths was last asked for.
+ *
+ * Files rather than a table, because the database is a cache a site may delete
+ * (decision-9), and both of these are facts the site cannot work out again.
+ */
+import type { PluginDataFolder, PluginSite } from '@geekity/cms/plugin';
+/** Where the plugin's REST namespace lives, on the site's origin. */
+export declare const WORDPRESS_ACTIVITYPUB_BASE = "/wp-json/activitypub/1.0";
+/** The plugin's actor path. Its identifier is the WordPress user's number. */
+export declare const WORDPRESS_ACTOR_PATH: "/wp-json/activitypub/1.0/actors/{identifier}";
+/** The actor's inbox, outbox and two follow collections, as the plugin spells them. */
+export declare const WORDPRESS_INBOX_PATH: "/wp-json/activitypub/1.0/actors/{identifier}/inbox";
+export declare const WORDPRESS_OUTBOX_PATH: "/wp-json/activitypub/1.0/actors/{identifier}/outbox";
+export declare const WORDPRESS_FOLLOWERS_PATH: "/wp-json/activitypub/1.0/actors/{identifier}/followers";
+export declare const WORDPRESS_FOLLOWING_PATH: "/wp-json/activitypub/1.0/actors/{identifier}/following";
+/** The plugin's instance-wide inbox, which its `sharedInbox` endpoint names. */
+export declare const WORDPRESS_SHARED_INBOX_PATH: "/wp-json/activitypub/1.0/inbox";
+/** The file mapping each username to its WordPress number. */
+export declare const ACTORS_FILE = "actors.json";
+/** The file holding when each path was last asked for. */
+export declare const REQUESTS_FILE = "requests.json";
+/** One of the plugin's paths, as the record of what was asked for names it. */
+export type WordPressRoute = 'actor' | 'inbox' | 'outbox' | 'followers' | 'following';
+/** Every per-person path, in the order the plugin's actor names them. */
+export declare const WORDPRESS_ROUTES: readonly WordPressRoute[];
+/** Which compatibility path a request is for, and whose. */
+export interface WordPressRequestTarget {
+    /** The path it is, or `sharedInbox` for the instance-wide one. */
+    readonly route: WordPressRoute | 'sharedInbox';
+    /** The WordPress number in the path, or `undefined` for the shared inbox. */
+    readonly wordpressActorId?: string | undefined;
+}
+/**
+ * The compatibility path a request asks for, or `undefined` for anything else.
+ *
+ * Matched here rather than left to Fedify because the record of what was last
+ * asked for is written whether or not a user answers: a delivery to a number
+ * nobody carries is still a peer holding the old URL. Fedify's router still
+ * decides what is served.
+ */
+export declare function wordPressRequestTarget(pathname: string): WordPressRequestTarget | undefined;
+/** When each compatibility path was last asked for. */
+export interface WordPressRequests {
+    /** When the instance-wide inbox was last delivered to, or `undefined`. */
+    readonly sharedInbox?: string | undefined;
+    /** When each of a user's own paths was last asked for, by username. */
+    readonly users: Readonly<Record<string, Readonly<Partial<Record<WordPressRoute, string>>>>>;
+}
+/** Thrown when a WordPress number already belongs to another user. */
+export declare class ConflictingWordPressIdError extends Error {
+    readonly name = "ConflictingWordPressIdError";
+    /** The user who already has it. */
+    readonly username: string;
+    constructor(username: string, wordpressActorId: number);
+}
+/** The plugin's two files, read and written through its data folder. */
+export interface WordPressRecords {
+    /** Each username's WordPress number. */
+    actors(): ReadonlyMap<string, number>;
+    /**
+     * The user the plugin numbered `identifier`, or `undefined`. The identifier
+     * is a path segment, so it is compared as the decimal the plugin writes:
+     * `02` and `2.0` name nobody, because neither is a URL it ever published.
+     * A number whose user the site no longer has names nobody either.
+     */
+    userByNumber(site: PluginSite, identifier: string): string | undefined;
+    /**
+     * Give a user their WordPress number. Returns whether anything changed;
+     * throws {@link ConflictingWordPressIdError} when another user has it.
+     */
+    setNumber(username: string, wordpressActorId: number): Promise<boolean>;
+    requests(): WordPressRequests;
+    /**
+     * Record that one path was just asked for. A path whose number names
+     * nobody is not recorded: the record is per user.
+     */
+    recordRequest(options: {
+        target: WordPressRequestTarget;
+        username: string | undefined;
+        at: Date;
+    }): Promise<void>;
+}
+export declare function wordPressRecords(data: PluginDataFolder): WordPressRecords;
+//# sourceMappingURL=records.d.ts.map

package/dist/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../src/records.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAExE,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AAErE,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,gDAA+D,CAAC;AAEjG,uFAAuF;AACvF,eAAO,MAAM,oBAAoB,sDAA2C,CAAC;AAC7E,eAAO,MAAM,qBAAqB,uDAA4C,CAAC;AAC/E,eAAO,MAAM,wBAAwB,0DAA+C,CAAC;AACrF,eAAO,MAAM,wBAAwB,0DAA+C,CAAC;AAErF,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,kCAAiD,CAAC;AAE1F,8DAA8D;AAC9D,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,0DAA0D;AAC1D,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAEtF,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAMrD,CAAC;AAEF,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAAC;IAC/C,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAY3F;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC7F;AAED,sEAAsE;AACtE,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAkB,IAAI,iCAAiC;IACvD,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAGrD;CACF;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACvE;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,QAAQ,IAAI,iBAAiB,CAAC;IAC9B;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE;QACrB,MAAM,EAAE,sBAAsB,CAAC;QAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,EAAE,EAAE,IAAI,CAAC;KACV,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAwDzE"}