src/site-reports.ts

Functions

Imports

It imports src/env.ts, src/ops-sites.ts. Imported by src/bing-webmaster.ts, src/search-console.ts.

Source

1import type { Env } from "./env";
2import { readSiteRow, sitesFrom } from "./ops-sites";
3
4// What the search reports (src/search-console.ts, src/bing-webmaster.ts) share: the
5// namespace's configured site, and a page to inspect that must be on it.
6
7/** The namespace's site from ops_sites, or a refusal naming what it lacks. */
8export async function reportSite(env: Env, namespace: string, what: string) {
9  const row = await readSiteRow(env.DB, namespace);
10  const site = row ? sitesFrom([row])[0] : undefined;
11  if (!row || !site) {
12    throw new Error(`${namespace} has no site configured (ops_sites), so it has no ${what}. The admin adds one with capsid_admin_run_controls control site_add.`);
13  }
14  return site;
15}
16
17/** The page to inspect, refused unless it is an https page on the site's own host. */
18export function pageOnSite(origin: string, namespace: string, url: string): string {
19  let parsed: URL;
20  try {
21    parsed = new URL(url);
22  } catch {
23    throw new Error("url must be a whole address, such as https://example.com/about.");
24  }
25  if (parsed.protocol !== "https:" || parsed.hostname !== new URL(origin).hostname) {
26    throw new Error(`url must be a page on ${namespace}'s site, ${origin}.`);
27  }
28  return parsed.toString();
29}