app/lib/content/url-policy.mjs

Functions

Imports

It imports app/lib/content/slug.mjs. Imported by app/lib/content/pipeline.mjs.

Source

1// The site's link rules on top of Prelum's URL policy (@drdustinedwards/site-helpers/render/url), which
2// stays the one protocol check: these compose with isAllowedUrl, never replace it.
3
4import { SLUG_PATTERN } from "./slug.mjs";
5
6const INTERNAL_LINK_PREFIX = "/writing/";
7
8/**
9 * Composed with isAllowedUrl, never instead of it. The protocol is checked explicitly because the URL
10 * constructor parses mailto:, which is not further reading.
11 *
12 * @param {string} value
13 * @returns {boolean}
14 */
15export function isFurtherReadingUrl(value) {
16  if (value.startsWith(INTERNAL_LINK_PREFIX)) return internalLinkSlug(value) !== null;
17  let parsed;
18  try {
19    parsed = new URL(value);
20  } catch {
21    return false;
22  }
23  return parsed.protocol === "https:" || parsed.protocol === "http:";
24}
25
26/**
27 * Exported so check:content resolves internal links without a second copy of the prefix rule.
28 *
29 * @param {string} value
30 * @returns {string | null}
31 */
32export function internalLinkSlug(value) {
33  if (!value.startsWith(INTERNAL_LINK_PREFIX)) return null;
34  const slug = value.slice(INTERNAL_LINK_PREFIX.length);
35  return SLUG_PATTERN.test(slug) ? slug : null;
36}