app/lib/wordpress-redirects.mjs

Functions

Imports

It imports app/lib/site-origin.mjs. Imported by app/lib/pages/links.mjs, workers/app.ts.

Source

1/**
2 * The old WordPress site's addresses, answered on the apex host (and www) so they are live the moment
3 * DNS moves: a 301 to the page that replaces each one, or 410 Gone for what was removed. The map is
4 * cutover.md's "Redirect map" (Capsid, dustinedwards), decided 2026-09-27; this file is that record in
5 * code, pattern rules first, then explicit rows.
6 *
7 * Host-scoped, because the workers.dev host serves the new site's own paths and must never see these.
8 * These are the only moves the gateway answers: the new site's own old addresses do not redirect (Dustin,
9 * 2026-10-20: "the only redirects should be from the old site to the new site").
10 *
11 * Paths match with and without the trailing slash. The query is ignored: a 301 never carries it, since
12 * WordPress's `?et_blog` and `?profiletab=` mean nothing on the new site.
13 */
14
15import { SITE_ORIGIN } from "./site-origin.mjs";
16
17const APEX_HOSTS = new Set(["dustinedwards.info", "www.dustinedwards.info"]);
18
19/** @param {string} hostname */
20export function isApexHost(hostname) {
21  return APEX_HOSTS.has(hostname.toLowerCase());
22}
23
24/**
25 * Where a request to `www` goes: the apex, in ONE hop. The apex is the canonical host, so `www` serving the same
26 * pages would be a second copy of every URL. An old WordPress address goes straight to the page that replaces it
27 * (the map's own Location, which carries no query), so a `www` reader of an old URL is not sent through two
28 * redirects. Everything else keeps its path and query. A removed address (410) goes to the apex too, which
29 * answers it. Null for any host but `www`.
30 *
31 * @param {string} hostname
32 * @param {string} pathname
33 * @param {string} search the request's query string, with its `?`, or ""
34 * @returns {string | null} an absolute https URL on the apex
35 */
36export function wwwRedirectTarget(hostname, pathname, search) {
37  if (hostname.toLowerCase() !== "www.dustinedwards.info") return null;
38  const disposition = wordpressDisposition(pathname);
39  const target = disposition?.status === 301 ? disposition.location : `${pathname}${search}`;
40  return new URL(target, SITE_ORIGIN).toString();
41}
42
43/**
44 * Not kept, and not put in R2: its protocol is rewritten as a page, so the old PDF address, which
45 * still earns clicks, points there (Dustin, 2026-09-27).
46 */
47export const BAYLOR_PDF = "/wp-content/uploads/2017/09/DNA-Extraction-Protocol-Baylor.pdf";
48const CV_PDF = "/wp-content/uploads/2019/02/Dustin-Edwards-Curriculum-Vitae-2019.pdf";
49
50/**
51 * Targets whose pages do not exist yet. Every 301 into one of these answers 404 until its page job
52 * lands, so the switch checklist reads this list: it must be empty, or each entry accepted, before
53 * DNS moves.
54 */
55export const PENDING_TARGETS = [
56  "/research",
57  "/research/retroviruses",
58  "/research/bacteriophages",
59  "/research/science-education",
60  "/research/phages",
61  "/research/protocols",
62  "/research/protocols/phage-isolation",
63  "/research/protocols/phage-dna-extraction",
64  "/research/protocols/coi-primers",
65  "/research/protocols/rev-lpdv-primers",
66  "/research/protocols/pan-avian-gapdh",
67  "/teaching",
68  "/teaching/phage-discovery",
69  "/teaching/virus-isolation",
70  "/teaching/phage-bioinformatics",
71  "/teaching/central-dogma",
72  "/teaching/study-skills",
73  "/research/retroviruses/avian",
74];
75
76/**
77 * @typedef {{ status: 301, location: string } | { status: 410 }} Disposition
78 */
79
80/** Where every student and author profile goes, except Dustin's own. */
81export const PROFILE_TARGET = "/teaching/phage-discovery#roster";
82
83/** @type {(location: string) => Disposition} */
84const moved = (location) => ({ status: 301, location });
85/** @type {Disposition} */
86const GONE = { status: 410 };
87
88/**
89 * Pattern rules, in order; each reads the path without its trailing slash. `null` passes to the next.
90 * @type {Array<(path: string) => Disposition | null>}
91 */
92const PATTERNS = [
93  (p) => {
94    const name = /^\/(?:discovery|annotation)-of-([a-z0-9-]+)$/i.exec(p)?.[1];
95    return name ? moved(`/research/phages#${name.toLowerCase()}`) : null;
96  },
97  (p) =>
98    ["/phylogenetics-lysm", "/arlo-gene-67", "/arlo-gene-67-cloning", "/raspberry-pi-plaque-counter"].includes(p)
99      ? moved("/research/phages")
100      : null,
101  // The lab's own directory answered "how do I join", so it goes to Join the lab, ahead of the rule below.
102  (p) => (p === "/directory-research-group" ? moved("/teaching#join-the-lab") : null),
103  (p) => (/^\/directory-[^/]+$/.test(p) ? moved("/teaching/phage-discovery") : null),
104  // Dustin's own author page ranks for his name, so it goes to the About page, ahead of the rule below.
105  (p) => (p === "/author/dustin" ? moved("/about") : null),
106  // The bare /user/ was the membership directory, so it is gone with the membership pages.
107  (p) => (["/user", "/register", "/members", "/logout", "/account", "/password-reset"].includes(p) ? GONE : null),
108  // Every other student and author profile (146 in Search Console, 147 with Dustin's own) goes to the
109  // roster at the bottom of the Phage Discovery Program page, as on the old site (Dustin, 2026-09-27).
110  (p) => (/^\/(?:user|author)(?:\/.*)?$/.test(p) ? moved(PROFILE_TARGET) : null),
111  (p) =>
112    /^\/(?:category\/phage-isolation-notes|microbiomes\/page|phages\/page)(?:\/.*)?$/.test(p)
113      ? moved("/research/phages")
114      : null,
115  (p) => (/^\/knowledge-base\/category(?:\/.*)?$/.test(p) ? moved("/research/protocols") : null),
116  (p) => (/^\/(?:category|tag)(?:\/.*)?$/.test(p) ? GONE : null),
117  (p) => (p === BAYLOR_PDF ? moved("/research/protocols/phage-dna-extraction") : null),
118  (p) => (p === CV_PDF ? moved("/dustin-edwards-cv.pdf") : null),
119  // Both still earn clicks or impressions: a lab protocol goes to the page that carries it.
120  (p) => (p === "/wp-content/uploads/2023/11/Electrophoresis.pdf" ? moved("/research/protocols") : null),
121  (p) => (p === "/wp-content/uploads/2023/11/DNA-Extraction-Scan.pdf" ? moved("/research/protocols/phage-dna-extraction") : null),
122  (p) => (p.startsWith("/wp-content/uploads/") ? GONE : null),
123  // Nothing on the new site does these calculations (Dustin, 2026-09-27).
124  (p) => (["/molarity-calculator", "/knowledge-base/metric-prefix"].includes(p) ? GONE : null),
125];
126
127/** Explicit rows, keyed by the old path without its trailing slash. */
128const ROWS = /** @type {Record<string, string>} */ ({
129  "/knowledge-base/pcr-coi-lco1490-hco2198": "/research/protocols/coi-primers",
130  // The old pages were a course and a program, so each goes to the course or program, not a protocol.
131  "/virus-isolation": "/teaching/virus-isolation",
132  "/phage-discovery": "/teaching/phage-discovery",
133  // No Wolbachia page: it is not Dustin's research any more, so its methods land on the protocols.
134  "/wolbachia-project-genetic-techniques": "/research/protocols",
135  "/knowledge-base/pcr-wolbachia-16s-rrna": "/research/protocols",
136  "/gentech-2018a": "/research/protocols",
137  "/research": "/research",
138  "/knowledge-base/pcr-rev-3-ltr-8000-8297": "/research/protocols/rev-lpdv-primers",
139  "/knowledge-base/pcr-rev-pol-2500-3750": "/research/protocols/rev-lpdv-primers",
140  "/knowledge-base/pcr-rev-pol-4777-5575": "/research/protocols/rev-lpdv-primers",
141  "/knowledge-base/pcr-pan-avian-gapdh": "/research/protocols/pan-avian-gapdh",
142  "/publications": "/research/publications",
143  "/manuscripts": "/research/publications",
144  "/knowledge-base/rev-lpdv-2018-2020-database": "/research/publications",
145  "/knowledge-base/rev-lpdv-2023-2025-database": "/research/publications",
146  "/virology-course": "/teaching",
147  "/genetics-course": "/teaching",
148  "/vaccines-course": "/teaching",
149  "/cell-biology-course": "/teaching",
150  "/lecture-courses": "/teaching",
151  "/courses": "/teaching",
152  "/related-courses": "/teaching",
153  "/research-lab-courses": "/teaching",
154  "/study-skills-guide": "/teaching/study-skills",
155  "/prospective-students": "/teaching#join-the-lab",
156  "/biomedical-sciences-academic-advising": "/teaching",
157  "/teaching-philosophy": "/teaching#teaching-philosophy",
158  "/tarleton-biological-sciences-biomedical-sciences-and-biology": "/teaching",
159  "/phages": "/research/phages",
160  "/phage-archives": "/research/phages",
161  "/microbiomes": "/research",
162  "/laboratory": "/research",
163  "/phage-bioinformatics": "/teaching/phage-bioinformatics",
164  "/phage-genetic-studies": "/research/bacteriophages",
165  "/phage-discovery-application": "/teaching/phage-discovery",
166  "/central-dogma-tutorials": "/teaching/central-dogma",
167  "/retroviruses": "/research/retroviruses",
168  "/rev-lpdv-surveys": "/research/retroviruses/avian",
169  "/rev-lpdv-genetic-studies": "/research/retroviruses/avian",
170  "/knowledge-base": "/research/protocols",
171  "/virus-isolation-reagent-request": "/teaching/virus-isolation",
172});
173
174/** Kept at their own address: the home page, and the two pages the new site answers itself. */
175const KEPT = new Set(["", "/contact", "/login"]);
176
177/** Every explicit row's old path, for the tests. */
178export const EXPLICIT_ROWS = Object.freeze({ ...ROWS });
179
180/**
181 * What an apex request for `pathname` gets: a 301 with its path-only Location, a 410, or null when the
182 * new site answers the path itself (a kept page, or anything the map does not name).
183 *
184 * @param {string} pathname the request's pathname, already decoded by URL
185 * @returns {{ status: 301, location: string } | { status: 410 } | null}
186 */
187export function wordpressDisposition(pathname) {
188  if (typeof pathname !== "string" || !pathname.startsWith("/")) return null;
189  const path = pathname.length > 1 ? pathname.replace(/\/+$/, "") : "";
190  if (KEPT.has(path)) return null;
191
192  let disposition = null;
193  for (const rule of PATTERNS) {
194    disposition = rule(path);
195    if (disposition) break;
196  }
197  const row = Object.hasOwn(ROWS, path) ? ROWS[path] : undefined;
198  if (!disposition && row) disposition = moved(row);
199  if (!disposition) return null;
200
201  // A row that rebuilds a page at its own address (`/research/` to `/research`) redirects only the
202  // slashed form; the bare form is the page, and redirecting it to itself would loop.
203  if (disposition.status === 301 && disposition.location === pathname) return null;
204  return disposition;
205}