@geekity/cms 0.29.0 → 0.31.0

package/dist/store/profiles.d.ts

@@ -0,0 +1,49 @@
+import type { DatabaseSync } from 'node:sqlite';
+/**
+ * How a remote actor presents itself: what a conversation shows of somebody
+ * who is not a follower (TASK-184).
+ *
+ * Read out of the actor document when one of their activities arrives, and
+ * kept only in the cache (decision-9): a profile is somebody else's to change,
+ * and it can always be fetched again.
+ */
+export interface ActorProfile {
+    /** The actor's ActivityStreams id, which is what identifies them. */
+    readonly actorId: string;
+    /** `@preferredUsername@host`, or `null` when the document names no username. */
+    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;
+}
+/** An {@link ActorProfile} as the cache holds it, with when it was fetched. */
+export interface StoredActorProfile extends ActorProfile {
+    /** When the document was read, as an ISO 8601 instant. */
+    readonly fetchedAt: string;
+}
+export interface ProfileStore {
+    /**
+     * Whether a URL is an avatar a reader of this site can be shown: the picture
+     * of a follower who has done something to a post, or of the author of an
+     * approved comment or webmention. The avatar proxy fetches nothing else
+     * (TASK-134), so it cannot be pointed at an arbitrary URL.
+     */
+    isAvatarSource(url: string): boolean;
+    /** Every URL {@link ProfileStore.isAvatarSource} answers yes for, each once. */
+    listAvatarSources(): string[];
+    /** The stored profile of a remote actor, or `undefined` (TASK-184). */
+    getActorProfile(actorId: string): StoredActorProfile | undefined;
+    /** Store a remote actor's profile, replacing whatever was stored for them. */
+    putActorProfile(profile: StoredActorProfile): void;
+    /**
+     * Every actor the inbox log names who is not a follower and whose profile
+     * is missing or was fetched before `fetchedBefore`, each once: the actors
+     * whose profiles are due.
+     */
+    listActorsToProfile(fetchedBefore: string): string[];
+}
+export declare function openProfileStore(db: DatabaseSync): ProfileStore;
+//# sourceMappingURL=profiles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/store/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,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;CAC7B;AAED,+EAA+E;AAC/E,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,gFAAgF;IAChF,iBAAiB,IAAI,MAAM,EAAE,CAAC;IAC9B,uEAAuE;IACvE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IACjE,8EAA8E;IAC9E,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnD;;;;OAIG;IACH,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACtD;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,YAAY,CAyE/D"}

package/dist/store/profiles.js

@@ -0,0 +1,71 @@
+import { nullableText } from './rows.js';
+export function openProfileStore(db) {
+    const statements = {
+        isAvatarSource: db.prepare(`
+      SELECT 1 FROM followers
+      WHERE icon_url = ?1 AND actor_id IN (SELECT actor_id FROM ap_inbox)
+      UNION ALL
+      SELECT 1 FROM actor_profiles
+      WHERE icon_url = ?1 AND actor_id IN (SELECT actor_id FROM ap_inbox)
+      UNION ALL
+      SELECT 1 FROM comments WHERE author_avatar = ?1 AND status = 'approved'
+      LIMIT 1
+    `),
+        listAvatarSources: db.prepare(`
+      SELECT icon_url AS url FROM followers
+      WHERE icon_url IS NOT NULL AND actor_id IN (SELECT actor_id FROM ap_inbox)
+      UNION
+      SELECT icon_url AS url FROM actor_profiles
+      WHERE icon_url IS NOT NULL AND actor_id IN (SELECT actor_id FROM ap_inbox)
+      UNION
+      SELECT author_avatar AS url FROM comments
+      WHERE author_avatar IS NOT NULL AND status = 'approved'
+    `),
+        actorProfileById: db.prepare('SELECT * FROM actor_profiles WHERE actor_id = ?'),
+        putActorProfile: db.prepare(`
+      INSERT INTO actor_profiles (actor_id, handle, name, icon_url, url, fetched_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+      ON CONFLICT (actor_id) DO UPDATE SET
+        handle = excluded.handle,
+        name = excluded.name,
+        icon_url = excluded.icon_url,
+        url = excluded.url,
+        fetched_at = excluded.fetched_at
+    `),
+        listActorsToProfile: db.prepare(`
+      SELECT DISTINCT actor_id FROM ap_inbox
+      WHERE actor_id NOT IN (SELECT actor_id FROM followers)
+        AND actor_id NOT IN (SELECT actor_id FROM actor_profiles WHERE fetched_at >= ?)
+      ORDER BY actor_id
+    `),
+    };
+    return {
+        isAvatarSource(url) {
+            return statements.isAvatarSource.get(url) !== undefined;
+        },
+        listAvatarSources() {
+            return statements.listAvatarSources.all().map((row) => String(row['url']));
+        },
+        getActorProfile(actorId) {
+            const row = statements.actorProfileById.get(actorId);
+            return row === undefined ? undefined : toActorProfile(row);
+        },
+        putActorProfile(profile) {
+            statements.putActorProfile.run(profile.actorId, profile.handle, profile.name, profile.iconUrl, profile.url, profile.fetchedAt);
+        },
+        listActorsToProfile(fetchedBefore) {
+            return statements.listActorsToProfile.all(fetchedBefore).map((row) => String(row['actor_id']));
+        },
+    };
+}
+function toActorProfile(row) {
+    return {
+        actorId: String(row['actor_id']),
+        handle: nullableText(row['handle']),
+        name: nullableText(row['name']),
+        iconUrl: nullableText(row['icon_url']),
+        url: nullableText(row['url']),
+        fetchedAt: String(row['fetched_at']),
+    };
+}
+//# sourceMappingURL=profiles.js.map

package/dist/store/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/store/profiles.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAmDzC,MAAM,UAAU,gBAAgB,CAAC,EAAgB;IAC/C,MAAM,UAAU,GAAG;QACjB,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC;;;;;;;;;KAS1B,CAAC;QACF,iBAAiB,EAAE,EAAE,CAAC,OAAO,CAAC;;;;;;;;;KAS7B,CAAC;QACF,gBAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,iDAAiD,CAAC;QAC/E,eAAe,EAAE,EAAE,CAAC,OAAO,CAAC;;;;;;;;;KAS3B,CAAC;QACF,mBAAmB,EAAE,EAAE,CAAC,OAAO,CAAC;;;;;KAK/B,CAAC;KACH,CAAC;IACF,OAAO;QACL,cAAc,CAAC,GAAG;YAChB,OAAO,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;QAC1D,CAAC;QAED,iBAAiB;YACf,OAAQ,UAAU,CAAC,iBAAiB,CAAC,GAAG,EAAgC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACnF,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CACnB,CAAC;QACJ,CAAC;QAED,eAAe,CAAC,OAAO;YACrB,MAAM,GAAG,GAAG,UAAU,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAwC,CAAC;YAC5F,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7D,CAAC;QAED,eAAe,CAAC,OAAO;YACrB,UAAU,CAAC,eAAe,CAAC,GAAG,CAC5B,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,SAAS,CAClB,CAAC;QACJ,CAAC;QAED,mBAAmB,CAAC,aAAa;YAC/B,OAAQ,UAAU,CAAC,mBAAmB,CAAC,GAAG,CAAC,aAAa,CAA+B,CAAC,GAAG,CACzF,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CACjC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,GAA4B;IAClD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChC,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,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/store/relays.d.ts

@@ -0,0 +1,66 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { Clock } from '../util/clock.ts';
+/** Where a relay subscription stands (FEP-ae0c). */
+export declare const RELAY_STATES: readonly ['pending', 'accepted', 'rejected'];
+/**
+ * One of {@link RELAY_STATES}.
+ *
+ * `pending` is a `Follow` that has gone out and not been answered — which may
+ * take days, because a relay is allowed to hold one for a human to approve.
+ * `accepted` is one the relay answered `Accept` to, and the only state the
+ * site delivers to. `rejected` is one it answered `Reject` to, with whatever
+ * it said in {@link Relay.reason}.
+ */
+export type RelayState = (typeof RELAY_STATES)[number];
+/**
+ * The site's subscription to one relay.
+ *
+ * The list of relays itself is a setting, and so lives in `site.json`; this is
+ * the state of the handshake with each of them, which is operational rather
+ * than editorial. Keyed by the inbox because that is the only thing known when the
+ * `Follow` goes out: a relay's actor id is not learned until it answers.
+ */
+export interface Relay {
+    /** The relay's inbox, which is what the site was given and what it delivers to. */
+    readonly inboxId: string;
+    /** The relay actor's id, once it has answered, and `null` until then. */
+    readonly actorId: string | null;
+    /** Where the subscription stands. */
+    readonly state: RelayState;
+    /** Why a `Reject` was a reject, when it gave a reason, or `null`. */
+    readonly reason: string | null;
+    /** The id of the `Follow` that was sent, which an `Accept` names. */
+    readonly followId: string | null;
+    /** When the site first subscribed, as an ISO 8601 instant. */
+    readonly createdAt: string;
+    /** When the subscription last moved — accepted, rejected, re-followed. */
+    readonly updatedAt: string;
+}
+/** A {@link Relay} before the store has timed it. */
+export type NewRelay = Omit<Relay, 'createdAt' | 'updatedAt'> & {
+    createdAt?: string | undefined;
+};
+export interface RelayStore {
+    /** Every relay subscription, oldest first, however it stands. */
+    listRelays(): Relay[];
+    /** One relay subscription by the inbox it was made to, or `undefined`. */
+    getRelay(inboxId: string): Relay | undefined;
+    /**
+     * The subscription one `Follow` established, or `undefined`.
+     *
+     * This is how an `Accept` or a `Reject` arriving later finds the relay it
+     * answers: the activity names the follow, and the follow names the record.
+     */
+    getRelayByFollow(followId: string): Relay | undefined;
+    /**
+     * Store a relay subscription, replacing whatever was known about that inbox
+     * and leaving the original `createdAt` alone: a subscription that moves from
+     * pending to accepted is the same subscription, and when it began is a fact
+     * only the row remembers.
+     */
+    putRelay(relay: NewRelay): Relay;
+    /** Forget a relay subscription. Returns `false` when there was nothing to forget. */
+    deleteRelay(inboxId: string): boolean;
+}
+export declare function openRelayStore(db: DatabaseSync, clock: Clock): RelayStore;
+//# sourceMappingURL=relays.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relays.d.ts","sourceRoot":"","sources":["../../src/store/relays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAI9C,oDAAoD;AACpD,eAAO,MAAM,YAAY,YAAI,SAAS,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,KAAK;IACpB,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,qDAAqD;AACrD,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG;IAC9D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,UAAU,IAAI,KAAK,EAAE,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAC7C;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IACtD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,CAAC;IACjC,qFAAqF;IACrF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU,CAuDzE"}

package/dist/store/relays.js

@@ -0,0 +1,69 @@
+import { nullableText, oneOf } from './rows.js';
+/** Where a relay subscription stands (FEP-ae0c). */
+export const RELAY_STATES = ['pending', 'accepted', 'rejected'];
+export function openRelayStore(db, clock) {
+    const statements = {
+        listRelays: db.prepare('SELECT * FROM ap_relays ORDER BY created_at, inbox_id'),
+        relayByInbox: db.prepare('SELECT * FROM ap_relays WHERE inbox_id = ?'),
+        relayByFollow: db.prepare('SELECT * FROM ap_relays WHERE follow_id = ?'),
+        putRelay: db.prepare(`
+      INSERT INTO ap_relays (
+        inbox_id, actor_id, state, reason, follow_id, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT (inbox_id) DO UPDATE SET
+        actor_id = excluded.actor_id,
+        state = excluded.state,
+        reason = excluded.reason,
+        follow_id = excluded.follow_id,
+        updated_at = excluded.updated_at
+      RETURNING *
+    `),
+        deleteRelay: db.prepare('DELETE FROM ap_relays WHERE inbox_id = ?'),
+    };
+    return {
+        listRelays() {
+            return statements.listRelays.all().map(toRelay);
+        },
+        getRelay(inboxId) {
+            const row = statements.relayByInbox.get(inboxId);
+            return row === undefined ? undefined : toRelay(row);
+        },
+        getRelayByFollow(followId) {
+            const row = statements.relayByFollow.get(followId);
+            return row === undefined ? undefined : toRelay(row);
+        },
+        putRelay(relay) {
+            const now = clock().toISOString();
+            const row = statements.putRelay.get(relay.inboxId, relay.actorId, relay.state, relay.reason, relay.followId, relay.createdAt ?? now, now);
+            if (row === undefined) {
+                throw new Error(`The relay subscription to "${relay.inboxId}" was not written.`);
+            }
+            return toRelay(row);
+        },
+        deleteRelay(inboxId) {
+            return statements.deleteRelay.run(inboxId).changes > 0;
+        },
+    };
+}
+function toRelay(row) {
+    return {
+        inboxId: String(row['inbox_id']),
+        actorId: nullableText(row['actor_id']),
+        state: relayState(row['state']),
+        reason: nullableText(row['reason']),
+        followId: nullableText(row['follow_id']),
+        createdAt: String(row['created_at']),
+        updatedAt: String(row['updated_at']),
+    };
+}
+/**
+ * A stored relay state, or `pending` for one this version does not know.
+ *
+ * Pending is the safe reading of an unknown state: a subscription this version
+ * cannot make sense of is one it should not be delivering public posts to, and
+ * Retry is on the screen for exactly that row.
+ */
+function relayState(value) {
+    return oneOf(value, RELAY_STATES, 'pending');
+}
+//# sourceMappingURL=relays.js.map

package/dist/store/relays.js.map

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

package/dist/store/rows.d.ts

@@ -0,0 +1,33 @@
+import type { DatabaseSync } from 'node:sqlite';
+/** How {@link FollowerStore.listFollowers} and its inbox-log sibling page. */
+export interface ListPageOptions {
+    /** Largest number of rows to return. Everything, when it is not given. */
+    limit?: number | undefined;
+    /** How many rows to skip first. Zero when it is not given. */
+    offset?: number | undefined;
+}
+/**
+ * What a `LIMIT` means when the caller named none. SQLite reads a negative
+ * limit as "every row", which is what an unpaged list asks for.
+ */
+export declare const NO_LIMIT = -1;
+/**
+ * A `TEXT` column that may be `NULL`, as a string or `null`.
+ *
+ * Anything that is not text is read as `null` rather than stringified: every
+ * column this is used on is declared `TEXT`, so a value of another shape is a
+ * row somebody else wrote, and `[object Object]` is a worse answer than none.
+ */
+export declare function nullableText(value: unknown): string | null;
+/** A stored enumeration value, or the fallback for one this version does not know. */
+export declare function oneOf<T extends string>(value: unknown, allowed: readonly T[], fallback: T): T;
+export declare function countByStatus<S extends string>(rows: readonly Record<string, unknown>[], statuses: readonly S[], statusOf: (value: unknown) => S): Record<S, number>;
+/**
+ * Run a body with every write in it committed together, or none of them.
+ *
+ * The rebuilds are what need it: emptying an index and filling it again is
+ * one step to everything reading it, and a half-emptied `followers` is a
+ * site that has quietly stopped delivering to half its followers.
+ */
+export declare function inTransaction(db: DatabaseSync, body: () => void): void;
+//# sourceMappingURL=rows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../src/store/rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,KAAK,CAAC;AAE3B;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED,sFAAsF;AACtF,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAE7F;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACxC,QAAQ,EAAE,SAAS,CAAC,EAAE,EACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAC9B,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAInB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAStE"}

package/dist/store/rows.js

@@ -0,0 +1,44 @@
+/**
+ * What a `LIMIT` means when the caller named none. SQLite reads a negative
+ * limit as "every row", which is what an unpaged list asks for.
+ */
+export const NO_LIMIT = -1;
+/**
+ * A `TEXT` column that may be `NULL`, as a string or `null`.
+ *
+ * Anything that is not text is read as `null` rather than stringified: every
+ * column this is used on is declared `TEXT`, so a value of another shape is a
+ * row somebody else wrote, and `[object Object]` is a worse answer than none.
+ */
+export function nullableText(value) {
+    return typeof value === 'string' ? value : null;
+}
+/** A stored enumeration value, or the fallback for one this version does not know. */
+export function oneOf(value, allowed, fallback) {
+    return allowed.includes(value) ? value : fallback;
+}
+export function countByStatus(rows, statuses, statusOf) {
+    const counts = Object.fromEntries(statuses.map((status) => [status, 0]));
+    for (const row of rows)
+        counts[statusOf(row['status'])] += Number(row['count'] ?? 0);
+    return counts;
+}
+/**
+ * Run a body with every write in it committed together, or none of them.
+ *
+ * The rebuilds are what need it: emptying an index and filling it again is
+ * one step to everything reading it, and a half-emptied `followers` is a
+ * site that has quietly stopped delivering to half its followers.
+ */
+export function inTransaction(db, body) {
+    db.exec('BEGIN');
+    try {
+        body();
+        db.exec('COMMIT');
+    }
+    catch (error) {
+        db.exec('ROLLBACK');
+        throw error;
+    }
+}
+//# sourceMappingURL=rows.js.map

package/dist/store/rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.js","sourceRoot":"","sources":["../../src/store/rows.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,KAAK,CAAmB,KAAc,EAAE,OAAqB,EAAE,QAAW;IACxF,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAU,CAAC,CAAC,CAAC,CAAE,KAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAwC,EACxC,QAAsB,EACtB,QAA+B;IAE/B,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAsB,CAAC;IAC9F,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACrF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,EAAgB,EAAE,IAAgB;IAC9D,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,EAAE,CAAC;QACP,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/store/schema.d.ts

@@ -0,0 +1,14 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { Migration } from '../cache.ts';
+import type { Clock } from '../util/clock.ts';
+/** The table this store's applied versions are recorded in. */
+export declare const LEDGER = "admin_migrations";
+/**
+ * Schema versions for the admin tables, applied in order. They keep their own
+ * ledger so their numbering never collides with the content index's.
+ *
+ * Never edit a migration that has shipped; append a new one.
+ */
+export declare const MIGRATIONS: readonly Migration[];
+export declare function openAdminDatabase(dataDir: string, now: Clock): DatabaseSync;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/store/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAK9C,+DAA+D;AAC/D,eAAO,MAAM,MAAM,qBAAqB,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EA2jB1C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,YAAY,CAE3E"}