@geekity/cms 0.30.0 → 0.32.0

package/dist/store/deliveries.d.ts

@@ -0,0 +1,92 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { Clock } from '../util/clock.ts';
+/** How one delivery of one activity to one follower ended. */
+export declare const DELIVERY_STATUSES: readonly ['sent', 'queued', 'failed'];
+/**
+ * One of {@link DELIVERY_STATUSES}.
+ *
+ * `sent` is a POST the follower's server accepted. `queued` is one handed to
+ * Fedify's outbox queue, which is as much as a site running with a queue can
+ * know from the call: the queue retries out of band and does not report back.
+ * `failed` is a delivery that threw, with the reason in the row.
+ */
+export type DeliveryStatus = (typeof DELIVERY_STATUSES)[number];
+/**
+ * How one attempt to deliver one activity to one recipient ended, and what the
+ * activity was.
+ *
+ * The whole of what SQLite keeps about anything the site has sent (decision-9).
+ * No payload goes with it: an activity is rebuilt from the post's file at the
+ * moment somebody asks for it to go again, so storing the bytes that went out
+ * last time would only be a second, staler answer to the same question. What
+ * is left is a cache of outcomes, and a site that deletes its database loses
+ * nothing but the record of how yesterday's delivery went.
+ *
+ * The activity's own columns are here rather than in a table of their own
+ * because there is no longer anything else to put in one: they are what the
+ * federation screen reads to say what went out and when.
+ */
+export interface Delivery {
+    /** The id of the activity that was delivered. */
+    readonly activityId: string;
+    /** `Create`, `Update` or `Delete`. */
+    readonly activityType: string;
+    /**
+     * The ActivityStreams id of what it was about: a post, or the site's own
+     * actor when the profile itself was what moved.
+     */
+    readonly objectId: string;
+    /**
+     * The post's slug when the activity went out, or `null` for an activity
+     * about no post — which is what an actor `Update` is.
+     */
+    readonly slug: string | null;
+    /** Which follower or relay it was delivered to. */
+    readonly actorId: string;
+    /** The inbox actually used, which is the shared one when the follower has one. */
+    readonly inboxId: string;
+    /** How it went. */
+    readonly status: DeliveryStatus;
+    /** Why it failed, or `null`. */
+    readonly error: string | null;
+    /** When the attempt was made, as an ISO 8601 instant. */
+    readonly attemptedAt: string;
+}
+/** A {@link Delivery} before the store has timed it. */
+export type NewDelivery = Omit<Delivery, 'attemptedAt'> & {
+    attemptedAt?: string | undefined;
+};
+export interface DeliveryStore {
+    /**
+     * Record how one delivery to one follower ended, replacing the previous
+     * outcome for that pair: the table answers "where does this activity stand
+     * with each follower", which a resend moves rather than adds to.
+     */
+    recordDelivery(delivery: NewDelivery): Delivery;
+    /** Every follower's outcome for one activity, in follower order. */
+    listDeliveries(activityId: string): Delivery[];
+    /** How many followers this activity stands at each status with. */
+    countDeliveriesByStatus(activityId: string): Record<DeliveryStatus, number>;
+    /**
+     * The most recent delivery to one inbox, whichever activity it carried, or
+     * `undefined` when nothing has ever gone there.
+     *
+     * Keyed by the inbox rather than by the actor because that is what a relay
+     * has: it is not a follower, so there is no follower row to look its
+     * outcomes up by, and the inbox is the thing the site was told to deliver to.
+     */
+    lastDeliveryToInbox(inboxId: string): Delivery | undefined;
+    /**
+     * The most recent delivery about one object — a post's ActivityStreams id,
+     * or the site actor's — or `undefined` when nothing about it has ever gone
+     * out.
+     *
+     * What the federation screen's per-post row is filled in from. Keyed by the
+     * object rather than by the activity because a post is a series of
+     * activities and the row is about the post: the newest outcome is the one
+     * that says where the post currently stands with the fediverse.
+     */
+    lastDeliveryToObject(objectId: string): Delivery | undefined;
+}
+export declare function openDeliveryStore(db: DatabaseSync, clock: Clock): DeliveryStore;
+//# sourceMappingURL=deliveries.d.ts.map

package/dist/store/deliveries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliveries.d.ts","sourceRoot":"","sources":["../../src/store/deliveries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAI9C,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,YAAI,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,QAAQ;IACvB,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mBAAmB;IACnB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG;IACxD,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IAChD,oEAAoE;IACpE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAC/C,mEAAmE;IACnE,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC5E;;;;;;;OAOG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3D;;;;;;;;;OASG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC9D;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,aAAa,CA8E/E"}

package/dist/store/deliveries.js

@@ -0,0 +1,88 @@
+import { countByStatus, nullableText, oneOf } from './rows.js';
+/** How one delivery of one activity to one follower ended. */
+export const DELIVERY_STATUSES = ['sent', 'queued', 'failed'];
+export function openDeliveryStore(db, clock) {
+    const statements = {
+        recordDelivery: db.prepare(`
+      INSERT INTO ap_deliveries (
+        activity_id, activity_type, object_id, slug,
+        actor_id, inbox_id, status, error, attempted_at
+      )
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT (activity_id, actor_id) DO UPDATE SET
+        activity_type = excluded.activity_type,
+        object_id = excluded.object_id,
+        slug = excluded.slug,
+        inbox_id = excluded.inbox_id,
+        status = excluded.status,
+        error = excluded.error,
+        attempted_at = excluded.attempted_at
+      RETURNING *
+    `),
+        listDeliveries: db.prepare(`
+      SELECT * FROM ap_deliveries WHERE activity_id = ? ORDER BY actor_id
+    `),
+        countDeliveriesByStatus: db.prepare(`
+      SELECT status, COUNT(*) AS count FROM ap_deliveries WHERE activity_id = ? GROUP BY status
+    `),
+        lastDeliveryToInbox: db.prepare(`
+      SELECT * FROM ap_deliveries WHERE inbox_id = ?
+      ORDER BY attempted_at DESC, rowid DESC
+      LIMIT 1
+    `),
+        lastDeliveryToObject: db.prepare(`
+      SELECT * FROM ap_deliveries WHERE object_id = ?
+      ORDER BY attempted_at DESC, rowid DESC
+      LIMIT 1
+    `),
+    };
+    return {
+        recordDelivery(delivery) {
+            const row = statements.recordDelivery.get(delivery.activityId, delivery.activityType, delivery.objectId, delivery.slug, delivery.actorId, delivery.inboxId, delivery.status, delivery.error, delivery.attemptedAt ?? clock().toISOString());
+            if (row === undefined) {
+                throw new Error(`The delivery of "${delivery.activityId}" to "${delivery.actorId}" was not recorded.`);
+            }
+            return toDelivery(row);
+        },
+        listDeliveries(activityId) {
+            const rows = statements.listDeliveries.all(activityId);
+            return rows.map(toDelivery);
+        },
+        countDeliveriesByStatus(activityId) {
+            const rows = statements.countDeliveriesByStatus.all(activityId);
+            return countByStatus(rows, DELIVERY_STATUSES, deliveryStatus);
+        },
+        lastDeliveryToInbox(inboxId) {
+            const row = statements.lastDeliveryToInbox.get(inboxId);
+            return row === undefined ? undefined : toDelivery(row);
+        },
+        lastDeliveryToObject(objectId) {
+            const row = statements.lastDeliveryToObject.get(objectId);
+            return row === undefined ? undefined : toDelivery(row);
+        },
+    };
+}
+function toDelivery(row) {
+    return {
+        activityId: String(row['activity_id']),
+        activityType: String(row['activity_type']),
+        objectId: String(row['object_id']),
+        slug: nullableText(row['slug']),
+        actorId: String(row['actor_id']),
+        inboxId: String(row['inbox_id']),
+        status: deliveryStatus(row['status']),
+        error: nullableText(row['error']),
+        attemptedAt: String(row['attempted_at']),
+    };
+}
+/**
+ * A stored status, or `failed` for one this version does not know.
+ *
+ * An unreadable status is reported as the pessimistic one: an admin screen
+ * showing a delivery as failed when it was not is a nuisance, and showing one
+ * as sent when nobody knows is a lie.
+ */
+function deliveryStatus(value) {
+    return oneOf(value, DELIVERY_STATUSES, 'failed');
+}
+//# sourceMappingURL=deliveries.js.map

package/dist/store/deliveries.js.map

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

package/dist/store/followers.d.ts

@@ -0,0 +1,91 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { Clock } from '../util/clock.ts';
+import type { ListPageOptions } from './rows.ts';
+/**
+ * A remote actor that follows this site.
+ *
+ * The followers are irreplaceable — an actor that followed and was forgotten
+ * never hears from the site again and has no way of noticing — so
+ * `content/_data/federation/followers.json` is where they are kept
+ * (decision-9), and this row is the index of that file, emptied and read back
+ * on every boot. The display columns are a copy of what the actor said about
+ * itself when it followed, so the admin can list its followers without
+ * dereferencing every one of them.
+ */
+export interface Follower {
+    /**
+     * Which user is followed (decision-14).
+     *
+     * Every user is an actor with followers of their own, so a follower is only
+     * ever a follower *of somebody*: the column is what makes one person's
+     * followers collection, and one person's delivery, theirs. It is the name of
+     * the directory the file came from rather than anything the file says.
+     */
+    readonly username: string;
+    /** The follower's ActivityStreams id, which is what identifies it. */
+    readonly actorId: string;
+    /** Where an activity addressed to this follower is delivered. */
+    readonly inboxId: string;
+    /**
+     * The follower's instance-wide inbox, when it published one. Delivering one
+     * activity to a shared inbox reaches every follower on that instance, so it
+     * is what keeps a popular post from becoming a thousand POSTs.
+     */
+    readonly sharedInboxId: string | null;
+    /** `@name@host`, as the follower's own instance spells it, or `null`. */
+    readonly handle: string | null;
+    /** The display name the actor published, or `null`. */
+    readonly name: string | null;
+    /** The actor's avatar, or `null`. */
+    readonly iconUrl: string | null;
+    /** The actor's profile page, for a human following the link, or `null`. */
+    readonly url: string | null;
+    /** When the follow arrived, as an ISO 8601 instant. */
+    readonly followedAt: string;
+}
+/**
+ * A {@link Follower} on its way in.
+ *
+ * `followedAt` is optional and defaults to now; naming one is what makes an
+ * import — or a test — able to say when a follow really happened.
+ */
+export type NewFollower = Omit<Follower, 'followedAt'> & {
+    followedAt?: string | undefined;
+};
+export interface FollowerStore {
+    /**
+     * How many actors follow one user, or the whole site when no user is named.
+     * What a user's followers collection counts.
+     */
+    countFollowers(username?: string): number;
+    /**
+     * Followers, newest follow first, optionally one page of them.
+     *
+     * Newest first matches the outbox, and means the collection's first page is
+     * the followers a human is most likely to be looking for. A follow that
+     * arrives while somebody is walking the collection shifts the pages under
+     * them by one, which is the same trade the outbox makes.
+     */
+    listFollowers(username?: string, options?: ListPageOptions): Follower[];
+    /** One user's follower by actor id, or `undefined`. */
+    getFollower(username: string, actorId: string): Follower | undefined;
+    /**
+     * Store a follower, replacing whatever was known about that actor. The
+     * original `followedAt` is kept, because a repeat `Follow` from an actor
+     * that already follows is a redelivery rather than a new follow.
+     */
+    putFollower(follower: NewFollower): Follower;
+    /** Forget one user's follower. Returns `false` when there was nothing to forget. */
+    deleteFollower(username: string, actorId: string): boolean;
+    /**
+     * Make the followers index say exactly this, in one transaction.
+     *
+     * What a rebuild from every `content/_data/federation/{username}/followers.json` calls
+     * (decision-9): the file is the source, so a row it does not carry is a row
+     * that should not be delivered to, and replacing the lot is the only way to
+     * say that. Nothing outside a rebuild should reach for it.
+     */
+    replaceFollowers(followers: readonly NewFollower[]): void;
+}
+export declare function openFollowerStore(db: DatabaseSync, clock: Clock): FollowerStore;
+//# sourceMappingURL=followers.d.ts.map

package/dist/store/followers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"followers.d.ts","sourceRoot":"","sources":["../../src/store/followers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG;IACvD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C;;;;;;;OAOG;IACH,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,EAAE,CAAC;IACxE,uDAAuD;IACvD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAErE;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC7C,oFAAoF;IACpF,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3D;;;;;;;OAOG;IACH,gBAAgB,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAAC;CAC3D;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,aAAa,CAkG/E"}

package/dist/store/followers.js

@@ -0,0 +1,79 @@
+import { inTransaction, NO_LIMIT, nullableText } from './rows.js';
+export function openFollowerStore(db, clock) {
+    const statements = {
+        // `?1 IS NULL` is how one statement answers both questions: naming a user
+        // counts theirs, naming nobody counts the site's.
+        countFollowers: db.prepare('SELECT COUNT(*) AS count FROM followers WHERE ?1 IS NULL OR username = ?1'),
+        listFollowers: db.prepare(`
+      SELECT * FROM followers
+      WHERE ?1 IS NULL OR username = ?1
+      ORDER BY followed_at DESC, actor_id DESC
+      LIMIT ?2 OFFSET ?3
+    `),
+        followerById: db.prepare('SELECT * FROM followers WHERE username = ? AND actor_id = ?'),
+        putFollower: db.prepare(`
+      INSERT INTO followers (
+        username, actor_id, inbox_id, shared_inbox_id, handle, name, icon_url, url, followed_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT (username, actor_id) DO UPDATE SET
+        inbox_id = excluded.inbox_id,
+        shared_inbox_id = excluded.shared_inbox_id,
+        handle = excluded.handle,
+        name = excluded.name,
+        icon_url = excluded.icon_url,
+        url = excluded.url
+    `),
+        deleteFollower: db.prepare('DELETE FROM followers WHERE username = ? AND actor_id = ?'),
+        clearFollowers: db.prepare('DELETE FROM followers'),
+    };
+    return {
+        countFollowers(username) {
+            const row = statements.countFollowers.get(username ?? null);
+            return Number(row?.['count'] ?? 0);
+        },
+        listFollowers(username, options = {}) {
+            const rows = statements.listFollowers.all(username ?? null, options.limit ?? NO_LIMIT, options.offset ?? 0);
+            return rows.map(toFollower);
+        },
+        getFollower(username, actorId) {
+            const row = statements.followerById.get(username, actorId);
+            return row === undefined ? undefined : toFollower(row);
+        },
+        putFollower(follower) {
+            statements.putFollower.run(follower.username, follower.actorId, follower.inboxId, follower.sharedInboxId, follower.handle, follower.name, follower.iconUrl, follower.url, follower.followedAt ?? clock().toISOString());
+            // Read back rather than returning what was written: the upsert leaves an
+            // existing `followed_at` alone, so the row is the only thing that knows
+            // when the follow really began.
+            const row = statements.followerById.get(follower.username, follower.actorId);
+            if (row === undefined) {
+                throw new Error(`The follower "${follower.actorId}" vanished between insert and read.`);
+            }
+            return toFollower(row);
+        },
+        deleteFollower(username, actorId) {
+            return statements.deleteFollower.run(username, actorId).changes > 0;
+        },
+        replaceFollowers(followers) {
+            inTransaction(db, () => {
+                statements.clearFollowers.run();
+                for (const follower of followers) {
+                    statements.putFollower.run(follower.username, follower.actorId, follower.inboxId, follower.sharedInboxId, follower.handle, follower.name, follower.iconUrl, follower.url, follower.followedAt ?? clock().toISOString());
+                }
+            });
+        },
+    };
+}
+function toFollower(row) {
+    return {
+        username: String(row['username']),
+        actorId: String(row['actor_id']),
+        inboxId: String(row['inbox_id']),
+        sharedInboxId: nullableText(row['shared_inbox_id']),
+        handle: nullableText(row['handle']),
+        name: nullableText(row['name']),
+        iconUrl: nullableText(row['icon_url']),
+        url: nullableText(row['url']),
+        followedAt: String(row['followed_at']),
+    };
+}
+//# sourceMappingURL=followers.js.map

package/dist/store/followers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"followers.js","sourceRoot":"","sources":["../../src/store/followers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AA6FlE,MAAM,UAAU,iBAAiB,CAAC,EAAgB,EAAE,KAAY;IAC9D,MAAM,UAAU,GAAG;QACjB,0EAA0E;QAC1E,kDAAkD;QAClD,cAAc,EAAE,EAAE,CAAC,OAAO,CACxB,2EAA2E,CAC5E;QACD,aAAa,EAAE,EAAE,CAAC,OAAO,CAAC;;;;;KAKzB,CAAC;QACF,YAAY,EAAE,EAAE,CAAC,OAAO,CAAC,6DAA6D,CAAC;QAEvF,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;KAWvB,CAAC;QACF,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,2DAA2D,CAAC;QACvF,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC;KACpD,CAAC;IACF,OAAO;QACL,cAAc,CAAC,QAAQ;YACrB,MAAM,GAAG,GAAG,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CACrB,CAAC;YACtC,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,CAAC;QAED,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,EAAE;YAClC,MAAM,IAAI,GAAG,UAAU,CAAC,aAAa,CAAC,GAAG,CACvC,QAAQ,IAAI,IAAI,EAChB,OAAO,CAAC,KAAK,IAAI,QAAQ,EACzB,OAAO,CAAC,MAAM,IAAI,CAAC,CACS,CAAC;YAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC;QAED,WAAW,CAAC,QAAQ,EAAE,OAAO;YAC3B,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CACpB,CAAC;YACtC,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACzD,CAAC;QAED,WAAW,CAAC,QAAQ;YAClB,UAAU,CAAC,WAAW,CAAC,GAAG,CACxB,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,aAAa,EACtB,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,GAAG,EACZ,QAAQ,CAAC,UAAU,IAAI,KAAK,EAAE,CAAC,WAAW,EAAE,CAC7C,CAAC;YACF,yEAAyE;YACzE,wEAAwE;YACxE,gCAAgC;YAChC,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CACtC,CAAC;YACtC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,OAAO,qCAAqC,CAAC,CAAC;YAC1F,CAAC;YACD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,cAAc,CAAC,QAAQ,EAAE,OAAO;YAC9B,OAAO,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;QACtE,CAAC;QAED,gBAAgB,CAAC,SAAS;YACxB,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE;gBACrB,UAAU,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;gBAChC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;oBACjC,UAAU,CAAC,WAAW,CAAC,GAAG,CACxB,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,aAAa,EACtB,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,GAAG,EACZ,QAAQ,CAAC,UAAU,IAAI,KAAK,EAAE,CAAC,WAAW,EAAE,CAC7C,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,GAA4B;IAC9C,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChC,aAAa,EAAE,YAAY,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACnD,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/{federation/replies.d.ts → store/inbox-replies.d.ts}

@@ -7,7 +7,7 @@
  * out of that stored JSON-LD rather than out of columns, so the index can be
  * thrown away and rebuilt from the files TASK-32 writes.
  */
-import type { InboxActivity } from '../admin/store.ts';
+import type { InboxActivity } from './admin-store.ts';
 /** The activity type a reply arrives as. A comment is a note somebody created. */
 export declare const REPLY_ACTIVITY_TYPE = "Create";
 /** One logged reply, as everything that shows a comment wants it. */
@@ -115,4 +115,4 @@ export declare function replyIdOf(activity: Pick<InboxActivity, 'activityType' |
  * an object is what a live one says.
  */
 export declare function uriOf(value: unknown): string | null;
-//# sourceMappingURL=replies.d.ts.map
+//# sourceMappingURL=inbox-replies.d.ts.map

package/dist/store/inbox-replies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-replies.d.ts","sourceRoot":"","sources":["../../src/store/inbox-replies.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C,qEAAqE;AACrE,MAAM,WAAW,KAAK;IACpB,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,SAAS,EAAE,IAAI,CAAC;IAChB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAChD,KAAK,GAAG,SAAS,CAYnB;AAED,mFAAmF;AACnF,MAAM,WAAW,KAAK;IACpB,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,SAAS,EAAE,IAAI,CAAC;IAChB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AASD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,KAAK,GAAG,SAAS,CASpE;AA8BD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAc/D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIzD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,GAAG,UAAU,GAAG,MAAM,CAAC,GAClE,MAAM,GAAG,IAAI,CAKf;AAsBD;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkBnD"}

package/dist/{federation/replies.js → store/inbox-replies.js}

@@ -7,6 +7,7 @@
  * out of that stored JSON-LD rather than out of columns, so the index can be
  * thrown away and rebuilt from the files TASK-32 writes.
  */
+import { isRecord } from '../util/guards.js';
 /** The activity type a reply arrives as. A comment is a note somebody created. */
 export const REPLY_ACTIVITY_TYPE = 'Create';
 /**
@@ -233,7 +234,4 @@ function languageText(value) {
     }
     return undefined;
 }
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-//# sourceMappingURL=replies.js.map
+//# sourceMappingURL=inbox-replies.js.map

package/dist/store/inbox-replies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-replies.js","sourceRoot":"","sources":["../../src/store/inbox-replies.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,kFAAkF;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AAyB5C;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CACvB,QAAuB,EACvB,OAAiD;IAEjD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAClD,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAEzC,OAAO;QACL,GAAG,IAAI,CAAC,IAAI;QACZ,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QACtE,SAAS;KACV,CAAC;AACJ,CAAC;AAkBD;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,CAAU,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,QAAuB;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAErF,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kEAAkE;AAClE,SAAS,QAAQ,CAAC,QAAuB;IAMvC,IAAI,QAAQ,CAAC,YAAY,KAAK,mBAAmB;QAAE,OAAO,SAAS,CAAC;IAEpE,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO;QACL,MAAM;QACN,IAAI,EAAE;YACJ,EAAE;YACF,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE;YAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE;YAC3E,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;SACzF;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ;SACtB,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC;SACnC,GAAG,EAAE,CAAC;IACT,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9E,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,QAAmE;IAEnE,IAAI,QAAQ,CAAC,YAAY,KAAK,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAC/D,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7E,OAAO,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,mEAAmE;AACnE,SAAS,QAAQ,CAAC,MAA+B,EAAE,QAAuB;IACxE,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,QAAQ,CAAC;AACzC,CAAC;AAED,kFAAkF;AAClF,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAExC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,4EAA4E;IAC5E,yDAAyD;IACzD,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3C,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;QACxC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/store/inbox.d.ts

@@ -0,0 +1,132 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { Clock } from '../util/clock.ts';
+import { replyIdOf } from './inbox-replies.ts';
+import type { ConversationWrite } from './conversation.ts';
+import type { ListPageOptions } from './rows.ts';
+/**
+ * One activity that arrived in the inbox and was recorded rather than acted
+ * on: doc-4's `Like`, `Announce` and `Create(Note)` reply, and the follow
+ * traffic alongside them.
+ *
+ * The raw JSON-LD is kept whole because a later phase surfaces likes, boosts
+ * and comments, and what that phase needs out of an activity is not knowable
+ * from here.
+ */
+export interface InboxActivity {
+    /** Row id, and the order activities arrived in. */
+    readonly id: number;
+    /** The activity's own id, or `null` for one that arrived without one. */
+    readonly activityId: string | null;
+    /** The compacted ActivityStreams type name, such as `Like` or `Announce`. */
+    readonly activityType: string;
+    /** Who sent it. */
+    readonly actorId: string;
+    /** What it was about — the post that was liked, the note replied to — or `null`. */
+    readonly objectId: string | null;
+    /**
+     * Which of this site's users it was addressed to, or `null` for one
+     * delivered to the shared inbox without naming one.
+     *
+     * decision-14 makes every user an actor, so the log records whose inbox was
+     * told as well as what it was told. Derived from the log line rather than
+     * from the activity, because the addressee is a fact about the delivery.
+     */
+    readonly recipient: string | null;
+    /**
+     * The object this activity answers, for a `Create` that carried an
+     * `inReplyTo`, and `null` for everything else.
+     *
+     * Derived from {@link InboxActivity.json} by {@link replyTargetOf} rather
+     * than supplied, so an index rebuilt from the inbox log holds exactly what
+     * the live one holds. It is a column so a post's replies can be counted
+     * without reading every activity the site was ever sent.
+     */
+    readonly inReplyTo: string | null;
+    /** When it arrived, as an ISO 8601 instant. */
+    readonly receivedAt: string;
+    /**
+     * Whether the site read it rather than was told it: a reply found in a
+     * fediverse reply's `replies` collection (TASK-321), logged as the `Create`
+     * nobody delivered. Only these are the site's to remove when the remote
+     * server stops listing them.
+     */
+    readonly fetched: boolean;
+    /** The activity as compacted JSON-LD, exactly as it was received. */
+    readonly json: string;
+}
+/**
+ * An {@link InboxActivity} before the store has given it a row and the reply
+ * target it derives.
+ *
+ * `receivedAt` is optional and defaults to now, exactly as a follower's
+ * `followedAt` is: naming one is what lets the boot rebuild put the log's own
+ * arrival times back rather than stamping every activity with the moment the
+ * index was rebuilt.
+ */
+export type NewInboxActivity = Omit<InboxActivity, 'id' | 'receivedAt' | 'inReplyTo' | 'recipient' | 'fetched'> & {
+    receivedAt?: string | undefined;
+    /** Delivered, unless it says otherwise. */
+    fetched?: boolean | undefined;
+    /**
+     * Who it was addressed to, when the delivery said. Optional and `null` by
+     * default: an activity that reached the shared inbox without naming one of
+     * this site's actors is addressed to nobody in particular, and so is every
+     * line of a log written before decision-14.
+     */
+    recipient?: string | null | undefined;
+};
+export interface InboxStore {
+    /** How many activities the inbound log holds. */
+    countInboxActivities(): number;
+    /** Logged activities, newest first, optionally one page of them. */
+    listInboxActivities(options?: ListPageOptions): InboxActivity[];
+    /**
+     * Record an inbound activity, replacing an earlier row with the same
+     * activity id so a redelivered `Like` stays one like. An activity that
+     * arrived without an id is always a new row: there is nothing to match it
+     * against.
+     */
+    logInboxActivity(activity: NewInboxActivity): InboxActivity;
+    /** Forget one logged activity by its row id. Returns `false` when there was none. */
+    deleteInboxActivity(id: number): boolean;
+    /**
+     * Make the inbound log index say exactly this, in one transaction, with the
+     * row ids starting again from one.
+     *
+     * The counterpart of {@link FollowerStore.replaceFollowers} over
+     * `content/_data/federation/inbox/{yyyy}-{mm}.jsonl`. The ids restart
+     * because a row id is the order things arrived in and nothing else: letting
+     * them climb on every boot would give the same log different ids on two
+     * machines holding the same files.
+     */
+    replaceInboxActivities(activities: readonly NewInboxActivity[]): void;
+    /** How many logged activities are replies to anything at all. */
+    countReplies(): number;
+    /** Every logged reply, newest first, optionally one page of them. */
+    listReplies(options?: ListPageOptions): InboxActivity[];
+    /** How many replies one object — a post's ActivityStreams id — has. */
+    countRepliesTo(objectId: string): number;
+    /** One object's replies, newest first, optionally one page of them. */
+    listRepliesTo(objectId: string, options?: ListPageOptions): InboxActivity[];
+    /**
+     * Every logged activity that names one of these objects — as what it is
+     * about, or as what it answers — oldest first.
+     *
+     * The query a conversation is built from: the likes and boosts of a post,
+     * the replies to it, and the `Delete` or `Undo` that takes one of those
+     * back, all name an object this side already knows the id of. Both columns
+     * are read because a `Create` is *about* the note it carries and only
+     * `in_reply_to` says which post that note answers.
+     *
+     * Oldest first, because that is the order a thread reads in; a caller
+     * wanting the newest can reverse a page it has. Naming nothing returns
+     * nothing rather than everything.
+     */
+    listActivitiesAbout(objectIds: readonly string[]): InboxActivity[];
+    /** The logged replies whose note's id has this `/replies/` key (TASK-327). */
+    listRepliesByKey(key: string): InboxActivity[];
+}
+export declare function openInboxStore(db: DatabaseSync, written: (change: ConversationWrite) => void, clock: Clock): InboxStore;
+/** The `/replies/` key of a logged reply's note, or `null` for anything else. */
+export declare function replyKeyOf(activity: Parameters<typeof replyIdOf>[0]): string | null;
+//# sourceMappingURL=inbox.d.ts.map

package/dist/store/inbox.d.ts.map

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