app/lib/pages/protected.mjs

Functions

Imports

It imports app/lib/license.mjs. Imported by app/lib/pages/compile.mjs, app/lib/pages/save.server.ts.

Source

1// The pages that must always be published (job_044f96426efa). /terms is the dataset license: TERMS_PATH
2// is what the `Link: rel="license"` header on every download and the `license` of every Dataset point at,
3// so a /terms that 404s or answers as a draft breaks the license of every data set the site publishes.
4// Carrel already refuses to unpublish or delete it; this is the site's own refusal, in the doors every
5// write and every sync goes through, so no client has to be trusted to carry the rule.
6
7import { TERMS_PATH } from "../license.mjs";
8
9/** @type {readonly string[]} */
10export const PROTECTED_PAGE_PATHS = [TERMS_PATH];
11
12/**
13 * Why a page may not be unpublished or deleted, or null when it may. The sentence names the reason, so the
14 * refusal a client sees says what the page is for.
15 *
16 * @param {string} path
17 * @returns {string | null}
18 */
19export function protectedPageReason(path) {
20  if (!PROTECTED_PAGE_PATHS.includes(path)) return null;
21  return (
22    `${path} is the license on every data set this site publishes (the Link rel="license" header on each ` +
23    "download and the license of each Dataset point at it), so it can never be unpublished or deleted"
24  );
25}