src/visual-pr.ts

Functions

Imports

It imports no other module of this repo. Imported by src/auto-merge-tick.ts.

Source

1// VISUAL PULL REQUESTS (job_0368576da167; Dustin, 2026-10-14: "i still want to see them
2// first, but you need to notify and then provide a way for me to see them. that will be
3// true for all sites/repos."). A pull request labelled `visual` waits for Dustin's yes on
4// every roster repo. The auto-merge tick holds it for him (src/auto-merge-tick.ts), reads
5// what he needs to look at from the pull request itself, and the phone alert
6// (src/push.ts), the inbox (src/inbox.ts) and the Portal's Pull requests page carry it.
7// His Approve in the Portal merges it on green CI through the approval executor, as any
8// approved pull request.
9
10const VISUAL_LABEL = "visual";
11const MAX_SHOTS = 12;
12
13/** What Dustin needs to look at a visual change: its title, a live preview when the
14 *  pull request names one, and the screenshots in its description. */
15export interface VisualPr {
16  title: string;
17  preview: string | null;
18  shots: string[];
19}
20
21/** Whether a pull request carries the visual label. */
22export function isVisual(pr: { labels?: ReadonlyArray<{ name?: string } | string> | null }): boolean {
23  return (pr.labels ?? []).some((l) => (typeof l === "string" ? l : l.name ?? "").toLowerCase() === VISUAL_LABEL);
24}
25
26const URL_RE = /https:\/\/[^\s)<>"'\]]+/g;
27// Hosts that serve a pull request's own build: Cloudflare Worker and Pages previews.
28const PREVIEW_HOST = /^https:\/\/[^/]*\.(workers\.dev|pages\.dev)(\/|$)/i;
29
30/** The live preview a pull request names: a URL on a line that says "preview", else the
31 *  first Worker or Pages preview URL in its description. Images are never previews. */
32export function previewUrl(body: string): string | null {
33  const urls = (line: string) => [...line.matchAll(URL_RE)].map((m) => m[0]).filter((u) => !isImage(u));
34  for (const line of body.split("\n")) {
35    if (/preview/i.test(line) && !/!\[/.test(line)) {
36      const [u] = urls(line);
37      if (u) return u;
38    }
39  }
40  return urls(body).find((u) => PREVIEW_HOST.test(u)) ?? null;
41}
42
43function isImage(url: string): boolean {
44  return /\.(png|jpe?g|gif|webp|svg)(\?|#|$)/i.test(url) || /user-attachments\/assets\//i.test(url);
45}
46
47/** The screenshots in a pull request's description: markdown images and <img> tags, in
48 *  order, each once, at most MAX_SHOTS. */
49export function screenshotUrls(body: string): string[] {
50  const found: string[] = [];
51  for (const m of body.matchAll(/!\[[^\]]*\]\((https:\/\/[^\s)]+)\)|<img\b[^>]*\bsrc=["'](https:\/\/[^"']+)["']/gi)) {
52    const url = m[1] ?? m[2];
53    if (url && !found.includes(url)) found.push(url);
54  }
55  return found.slice(0, MAX_SHOTS);
56}
57
58/** Everything the notice carries, read from the pull request. */
59export function visualDetails(pr: { title?: string | null; body?: string | null }): VisualPr {
60  const body = pr.body ?? "";
61  return { title: (pr.title ?? "").trim() || "(no title)", preview: previewUrl(body), shots: screenshotUrls(body) };
62}