src/admin/summary.ts

Functions

Imports

It imports src/admin/kit.ts. Imported by src/admin.ts.

Source

1// Many sites at once: a small count per site for an inbox line.
2
3import type { ContentSource } from "./kit.js";
4
5
6export interface SiteSummary {
7  site: { id: string; name: string };
8  /** Mentions waiting for a decision; null when the site does not moderate mentions here. */
9  mentionsWaiting: number | null;
10  /** Posts the host has something waiting on (Carrel's AI drafts); null when the host does not say. */
11  postsWaiting: number | null;
12  /** Files with no alt text; null where the site cannot say. */
13  mediaWithoutAlt: number | null;
14}
15
16/** A small count for one site, for an inbox line that links to the list. */
17export async function summary(source: ContentSource): Promise<SiteSummary> {
18  const capabilities = (await source.client.meta()).capabilities;
19  const mentionsWaiting = capabilities.mentions === true ? (await source.client.mentions.list({ status: "pending", limit: 1 })).counts.pending : null;
20  // A site that answers the no-alt lens (v0.6.0) and counts can say how many files lack alt text.
21  const mediaWithoutAlt =
22    capabilities.media === true && (capabilities.mediaLenses ?? []).includes("no-alt")
23      ? ((await source.client.media.list({ lens: "no-alt", limit: 1 })).total ?? null)
24      : null;
25  return {
26    site: { id: source.site.id, name: source.site.name },
27    mentionsWaiting,
28    postsWaiting: source.waiting ? await source.waiting() : null,
29    mediaWithoutAlt,
30  };
31}