\s*<\/div>/;
/** Inject crawlable content into the (otherwise empty) React mount point. */
export function injectBody(html, content) {
return html.replace(ROOT_RE, `
${content}
`);
}
const BASE_HREF_RE = /
/i;
// Clean single/multi-segment route (e.g. /compress, /settings/people); rejects
// traversal and dotted names. Returns the segment list or null.
function cleanSegments(routePath) {
const segments = routePath.replace(/^\//, "").split("/");
if (!segments.length || !segments.every((s) => /^[A-Za-z0-9_-]+$/.test(s)))
return null;
return segments;
}
/**
* Write the root index.html (home preview) plus one file per route in the
* manifest: flat for single-segment routes (e.g. dist/compress.html) and nested
* for multi-segment ones (e.g. dist/settings/people.html). Returns the count of
* route pages written.
*
* `baseHref` is the absolute deploy base ("/" for a root deploy). Nested files
* need it because a relative `` would resolve their assets
* against the sub-path (e.g. /settings/) and 404; flat files and the root keep
* the build's relative base. The path prefix derived from it is also woven into
* canonical/OG/JSON-LD URLs so a sub-path deploy (RUN_SUBPATH) stays consistent.
* @returns {Promise}
*/
export async function prerenderOg({
distDir,
manifest,
ogBase = "",
baseHref = "/",
}) {
const template = await fs.readFile(path.join(distDir, "index.html"), "utf8");
const pathPrefix = baseHref.replace(/\/+$/, ""); // "" or "/app"
const siteRoot = ogBase ? `${ogBase}${pathPrefix}/` : "/";
const homePath = `${pathPrefix}/`;
const navLinks = manifest.navLinks || [];
let home = injectOg(template, manifest.default, {
ogBase,
pageUrlPath: ogBase ? homePath : null,
canonicalPath: homePath,
siteRoot,
isHome: true,
pathPrefix,
});
// Home stays the brand ("Stirling PDF"); the H1 targets the keyword.
home = injectBody(
home,
buildBodyContent(manifest.default, {
navLinks,
heading: "Free Online PDF Tools",
}),
);
await fs.writeFile(path.join(distDir, "index.html"), home);
let count = 0;
for (const [routePath, id] of Object.entries(manifest.byPath || {})) {
const segments = cleanSegments(routePath);
if (!segments) continue;
const entry = manifest.byTool[id] ?? manifest.default;
const pageUrlPath = pathPrefix + routePath;
let html = injectOg(template, entry, {
ogBase,
pageUrlPath: ogBase ? pageUrlPath : null,
canonicalPath: pageUrlPath, // self-canonical: never points at a maybe-404 alias
noindex: !!entry.noindex,
siteRoot,
isHome: false,
pathPrefix,
});
// App/auth pages (noindex) stay the bare shell - no crawlable landing copy.
if (!entry.noindex)
html = injectBody(html, buildBodyContent(entry, { navLinks }));
const nested = segments.length > 1;
if (nested)
html = html.replace(BASE_HREF_RE, `<base href="${baseHref}" />`);
const outFile = path.join(distDir, ...segments) + ".html";
if (nested) await fs.mkdir(path.dirname(outFile), { recursive: true });
await fs.writeFile(outFile, html);
count++;
}
return count;
}
/**
* Build an XML sitemap of every indexable route. Requires an absolute origin
* (sitemaps must use absolute URLs), so returns null when none is known - e.g.
* self-hosted builds with no canonical domain. Noindex routes are excluded.
* @param {object} manifest
* @param {{ogBase:string, pathPrefix?:string}} opts
* @returns {string|null}
*/
export function buildSitemap(manifest, { ogBase, pathPrefix = "" }) {
if (!ogBase) return null;
const base = ogBase + pathPrefix;
const locs = new Set([`${base}/`]);
for (const [routePath, id] of Object.entries(manifest.byPath || {})) {
if (!cleanSegments(routePath)) continue;
const entry = manifest.byTool[id] ?? manifest.default;
if (entry.noindex) continue;
locs.add(base + routePath);
}
const body = [...locs]
.sort()
.map((loc) => {
const priority = loc === `${base}/` ? "1.0" : "0.8";
return (
` <url>\n` +
` <loc>${escapeHtml(loc)}</loc>\n` +
` <changefreq>weekly</changefreq>\n` +
` <priority>${priority}</priority>\n` +
` </url>`
);
})
.join("\n");
return (
`<?xml version="1.0" encoding="UTF-8"?>\n` +
`<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n` +
`${body}\n` +
`</urlset>\n`
);
}