app/lib/media/resolvers.server.ts

Functions

Imports

It imports app/lib/error-message.mjs, app/lib/media/resolvers/posts.server.ts. Imported by app/lib/carrel/media-adapter.server.ts, app/lib/media/actions.server.ts, app/lib/media/resolvers/posts.server.ts, app/routes/admin.media._index.tsx.

Source

1// Resolvers return structured results, never booleans, so a refusal can name the post and the form.
2
3export type MediaCitation = {
4  type: string;
5  id: string;
6  title: string;
7  form: "markdown-image" | "figure-directive" | "frontmatter-cover" | "link" | "html" | "other";
8  detail: string;
9};
10
11// Batched: each resolver reads one corpus and scans it, so a per-key call would be one read per key.
12export type ReferenceResolver = (
13  env: Env,
14  keys: string[],
15) => Promise<Map<string, MediaCitation[]>>;
16
17import { postsResolver } from "./resolvers/posts.server";
18import { errorMessage } from "~/lib/error-message.mjs";
19
20// A plain array, not a runtime `register()`, so there is no import-order problem.
21const RESOLVERS: Array<{ name: string; resolve: ReferenceResolver }> = [
22  { name: "posts", resolve: postsResolver },
23];
24
25type ResolutionResult = {
26  citations: Map<string, MediaCitation[]>;
27  // False when a resolver threw: a delete must then refuse.
28  complete: boolean;
29  failed: string[];
30};
31
32// Failure is reported, never swallowed: "we could not check" must not render as "nothing cites it".
33export async function resolveCitations(
34  env: Env,
35  keys: string[],
36): Promise<ResolutionResult> {
37  const citations = new Map<string, MediaCitation[]>(keys.map((key) => [key, []]));
38  const failed: string[] = [];
39
40  const answers = await Promise.all(
41    RESOLVERS.map(async (resolver) => {
42      try {
43        return { name: resolver.name, map: await resolver.resolve(env, keys) };
44      } catch (error) {
45        console.error(
46          JSON.stringify({ alert: "media-resolver-failed", resolver: resolver.name, detail: errorMessage(error) }),
47        );
48        failed.push(resolver.name);
49        return null;
50      }
51    }),
52  );
53
54  for (const answer of answers) {
55    if (!answer) continue;
56    for (const [key, found] of answer.map) {
57      const list = citations.get(key);
58      if (list) list.push(...found);
59    }
60  }
61
62  return { citations, complete: failed.length === 0, failed };
63}