@menapo/vi18n 0.0.0-stage → 0.1.0

package/dist/sitemap-DV3o8QD7.js

@@ -0,0 +1,159 @@
+import { i as toRuntimeConfig, n as normalizeBase } from "./runtime-DTMmliT1.js";
+import { n as localeOrigin, r as localizePath, t as atHome } from "./url-CRfCOhUI.js";
+import { r as plural } from "./output-DsaHKHEt.js";
+import { t as EXIT } from "./types-wSh9fCBY.js";
+import { o as loadProject, t as CliExit } from "./project-Dwx7iPm6.js";
+import { dirname, resolve } from "node:path";
+import { randomBytes } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+//#region src/cli/commands/sitemap.ts
+/**
+* `vi18n sitemap [<route>…] [--routes <file>] [--base-url <url>] [--out <file>] [--check]`
+* (PLAN §4.11, INTERNALS §2.14, §6 D137): a sitemap.xml listing every route
+* in every advertised locale, each `<url>` with its hreflang alternates and
+* `x-default`, built by the runtime's own URL codec (localized paths,
+* domains), so it names exactly the URLs the app serves and `alternates()`
+* prints. Routes are the app's route paths, as `localizedPaths()` takes them.
+*/
+/** XML text and attribute values: the five predefined entities. */
+const xml = (text) => text.replace(/[&<>"']/g, (c) => ({
+	"&": "&amp;",
+	"<": "&lt;",
+	">": "&gt;",
+	"\"": "&quot;",
+	"'": "&apos;"
+})[c]);
+/** A usage error found after the flags parsed (a routes file, a missing base URL). */
+function refuse(ctx, message) {
+	ctx.out.note(`vi18n sitemap: ${message}`);
+	throw new CliExit(EXIT.usage, [], { usage: message });
+}
+/** Route paths of `--routes <file>`: a JSON array, or one per line (`#` starts a comment). */
+async function readRoutes(ctx, file) {
+	let text;
+	try {
+		text = await readFile(resolve(ctx.global.cwd, file), "utf8");
+	} catch (error) {
+		refuse(ctx, `--routes ${file}: ${error.message}`);
+	}
+	if (/^\s*\[/.test(text)) {
+		let list;
+		try {
+			list = JSON.parse(text);
+		} catch (error) {
+			refuse(ctx, `--routes ${file}: ${error.message}`);
+		}
+		if (!Array.isArray(list) || !list.every((x) => typeof x === "string")) refuse(ctx, `--routes ${file}: expected an array of route paths`);
+		return list;
+	}
+	return text.split(/\r?\n/).map((line) => line.replace(/#.*/, "").trim()).filter((line) => line !== "");
+}
+/** The sitemap of `routes`: per route, per advertised locale, its URL and the alternates. */
+function sitemapEntries(routes, config, baseUrl) {
+	const base = baseUrl ? normalizeBase(baseUrl.pathname) : normalizeBase(config.routing.base ?? "/");
+	const rc = toRuntimeConfig(config, {
+		base,
+		pseudo: false
+	});
+	const single = rc.routing.url === "no_prefix";
+	const href = (route, l) => {
+		const path = base + new URL(route, "http://h").pathname.slice(1);
+		const origin = localeOrigin(l, rc);
+		if (origin !== void 0) return origin + localizePath(path, l, atHome(rc, l));
+		return baseUrl.origin + localizePath(path, l, rc);
+	};
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const route of routes) {
+		if (seen.has(route)) continue;
+		seen.add(route);
+		const urls = {};
+		for (const l of single ? [rc.sourceLocale] : rc.locales) urls[l] = href(route, l);
+		if (!single) urls["x-default"] = href(route, rc.sourceLocale);
+		out.push({
+			path: route,
+			urls
+		});
+	}
+	return out;
+}
+/** The sitemap document: one `<url>` per route and locale, each with the route's alternates. */
+function sitemapXml(routes) {
+	let body = "";
+	const seen = /* @__PURE__ */ new Set();
+	for (const { urls } of routes) {
+		const links = Object.entries(urls);
+		for (const [hreflang, loc] of links) {
+			if (hreflang === "x-default" || seen.has(loc)) continue;
+			seen.add(loc);
+			body += `  <url>\n    <loc>${xml(loc)}</loc>\n`;
+			if (links.length > 1) for (const [h, url] of links) body += `    <xhtml:link rel="alternate" hreflang="${xml(h)}" href="${xml(url)}"/>\n`;
+			body += "  </url>\n";
+		}
+	}
+	return "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\" xmlns:xhtml=\"http://www.w3.org/1999/xhtml\">\n" + body + "</urlset>\n";
+}
+async function sitemap(ctx, flags) {
+	const { config } = await loadProject(ctx);
+	const routes = [...flags.routes];
+	if (flags.routesFile !== null) routes.push(...await readRoutes(ctx, flags.routesFile));
+	const bad = routes.find((r) => !r.startsWith("/") || /[?#]/.test(r));
+	if (bad !== void 0) refuse(ctx, `${JSON.stringify(bad)} is not a route path (/about)`);
+	if (routes.length === 0) refuse(ctx, "no routes: list route paths, or --routes <file>");
+	let baseUrl = null;
+	if (flags.baseUrl !== null) {
+		try {
+			baseUrl = new URL(flags.baseUrl);
+		} catch {
+			baseUrl = null;
+		}
+		if (baseUrl === null || baseUrl.protocol !== "https:" && baseUrl.protocol !== "http:") refuse(ctx, `--base-url ${flags.baseUrl}: expected an absolute http(s) URL`);
+	} else if (config.locales.some((l) => !Object.values(config.routing.domains).includes(l))) refuse(ctx, "--base-url <url> is required: sitemaps list absolute URLs");
+	const entries = sitemapEntries(routes, config, baseUrl);
+	const text = sitemapXml(entries);
+	const urls = new Set(entries.flatMap((e) => Object.values(e.urls))).size;
+	const data = {
+		out: flags.out,
+		written: false,
+		routes: entries
+	};
+	if (flags.out === null) {
+		ctx.out.result(text);
+		return {
+			exitCode: EXIT.ok,
+			data
+		};
+	}
+	const file = resolve(ctx.global.cwd, flags.out);
+	const current = await readFile(file, "utf8").catch(() => null);
+	if (flags.check) {
+		if (current === text) return {
+			exitCode: EXIT.ok,
+			data
+		};
+		ctx.out.note(`vi18n sitemap --check: ${ctx.out.display(file)} is out of date`);
+		return {
+			exitCode: EXIT.failure,
+			data
+		};
+	}
+	if (current !== text) {
+		const temp = `${file}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
+		await mkdir(dirname(file), { recursive: true });
+		try {
+			await writeFile(temp, text);
+			await rename(temp, file);
+		} catch (error) {
+			await rm(temp, { force: true });
+			throw error;
+		}
+		data.written = true;
+	}
+	ctx.out.result(`${data.written ? "wrote" : "unchanged:"} ${ctx.out.display(file)} (${plural(urls, "URL")} for ${plural(entries.length, "route")})`);
+	return {
+		exitCode: EXIT.ok,
+		data
+	};
+}
+//#endregion
+export { sitemap };