@farming-labs/docs 0.2.24 → 0.2.25

package/dist/sitemap-CMNj0Pt3.mjs

@@ -1,252 +0,0 @@
-//#region src/sitemap.ts
-const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
-const DEFAULT_SITEMAP_MD_ROUTE = "/sitemap.md";
-const DEFAULT_SITEMAP_MD_DOCS_ROUTE = "/docs/sitemap.md";
-const DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE = "/.well-known/sitemap.md";
-const DEFAULT_SITEMAP_MANIFEST_PATH = ".farming-labs/sitemap-manifest.json";
-function normalizeUrlPath(value) {
-	const normalized = value.replace(/\/+/g, "/");
-	if (normalized === "/") return normalized;
-	return normalized.replace(/\/+$/, "");
-}
-function normalizeRoutePrefix(value) {
-	if (!value) return "";
-	const normalized = normalizeUrlPath(`/${value.replace(/^\/+|\/+$/g, "")}`);
-	return normalized === "/" ? "" : normalized;
-}
-function joinRoute(prefix, route) {
-	return normalizeUrlPath(`${prefix}/${route.replace(/^\/+/, "")}`);
-}
-function normalizeDateOnly(value) {
-	if (!value) return void 0;
-	const trimmed = value.trim();
-	if (!trimmed) return void 0;
-	const dateOnly = trimmed.match(/^(\d{4}-\d{2}-\d{2})/);
-	if (dateOnly) return dateOnly[1];
-	const parsed = new Date(trimmed);
-	if (Number.isNaN(parsed.getTime())) return void 0;
-	return parsed.toISOString().slice(0, 10);
-}
-function normalizeBaseUrl(value) {
-	if (!value) return void 0;
-	return value.trim().replace(/\/+$/, "") || void 0;
-}
-function isEnabledObject(config) {
-	if (config === false) return false;
-	if (config === void 0) return true;
-	if (config === true) return true;
-	return config.enabled !== false;
-}
-function resolveDocsSitemapConfig(sitemap, defaults = {}) {
-	const objectConfig = sitemap && typeof sitemap === "object" ? sitemap : {};
-	const routePrefix = normalizeRoutePrefix(objectConfig.routePrefix);
-	const xmlConfig = objectConfig.xml;
-	const markdownConfig = objectConfig.markdown;
-	const xmlEnabled = xmlConfig === false ? false : typeof xmlConfig === "object" ? xmlConfig.enabled ?? true : true;
-	const markdownEnabled = markdownConfig === false ? false : typeof markdownConfig === "object" ? markdownConfig.enabled ?? true : true;
-	return {
-		enabled: isEnabledObject(sitemap),
-		routePrefix,
-		baseUrl: normalizeBaseUrl(objectConfig.baseUrl ?? defaults.baseUrl),
-		manifestPath: objectConfig.manifestPath ?? DEFAULT_SITEMAP_MANIFEST_PATH,
-		xml: {
-			enabled: xmlEnabled,
-			includeLastmod: typeof xmlConfig === "object" ? xmlConfig.includeLastmod ?? true : true,
-			route: joinRoute(routePrefix, DEFAULT_SITEMAP_XML_ROUTE)
-		},
-		markdown: {
-			enabled: markdownEnabled,
-			includeDescriptions: typeof markdownConfig === "object" ? markdownConfig.includeDescriptions ?? true : true,
-			includeLastmod: typeof markdownConfig === "object" ? markdownConfig.includeLastmod ?? true : true,
-			linkTarget: typeof markdownConfig === "object" ? markdownConfig.linkTarget ?? "both" : "both",
-			route: joinRoute(routePrefix, DEFAULT_SITEMAP_MD_ROUTE),
-			docsRoute: routePrefix ? void 0 : DEFAULT_SITEMAP_MD_DOCS_ROUTE,
-			wellKnownRoute: joinRoute(routePrefix, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE)
-		}
-	};
-}
-function resolveDocsSitemapRequest(url, sitemap) {
-	const pathname = normalizeUrlPath(url.pathname);
-	const format = url.searchParams.get("format")?.trim();
-	if (pathname === "/api/docs") {
-		if (format === "sitemap-xml") return "xml";
-		if (format === "sitemap-md" || format === "sitemap-markdown") return "markdown";
-	}
-	const resolved = resolveDocsSitemapConfig(sitemap);
-	if (!resolved.enabled) return null;
-	if (resolved.xml.enabled && pathname === resolved.xml.route) return "xml";
-	if (resolved.markdown.enabled && (pathname === resolved.markdown.route || pathname === resolved.markdown.docsRoute || pathname === resolved.markdown.wellKnownRoute)) return "markdown";
-	return null;
-}
-function toDocsSitemapMarkdownUrl(url) {
-	const normalized = normalizeUrlPath(url);
-	return normalized.endsWith(".md") ? normalized : `${normalized}.md`;
-}
-function absolutizeUrl(baseUrl, url) {
-	if (/^https?:\/\//i.test(url)) return url;
-	const base = normalizeBaseUrl(baseUrl);
-	return base ? `${base}${url.startsWith("/") ? url : `/${url}`}` : url;
-}
-function escapeXml(value) {
-	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-}
-function hashString(value) {
-	let hash = 14695981039346656037n;
-	const bytes = new TextEncoder().encode(value);
-	for (const byte of bytes) {
-		hash ^= BigInt(byte);
-		hash = BigInt.asUintN(64, hash * 1099511628211n);
-	}
-	return `"fnv1a64-${hash.toString(16).padStart(16, "0")}"`;
-}
-function newestLastmod(pages) {
-	let newest;
-	for (const page of pages) {
-		const date = normalizeDateOnly(page.lastmod);
-		if (!date) continue;
-		if (!newest || date > newest) newest = date;
-	}
-	return newest;
-}
-function titleize(value) {
-	return value.replace(/-/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
-}
-function sitemapSectionName(entry, pageUrl) {
-	const normalizedEntry = `/${entry.replace(/^\/+|\/+$/g, "") || "docs"}`;
-	const normalizedUrl = normalizeUrlPath(pageUrl);
-	if (normalizedUrl === normalizedEntry) return "Overview";
-	const firstSegment = (normalizedUrl.startsWith(`${normalizedEntry}/`) ? normalizedUrl.slice(normalizedEntry.length + 1) : normalizedUrl.replace(/^\/+/, "")).split("/").filter(Boolean)[0];
-	return firstSegment ? titleize(firstSegment) : "Pages";
-}
-function buildDocsSitemapManifest(options) {
-	const baseUrl = normalizeBaseUrl(options.baseUrl);
-	const seen = /* @__PURE__ */ new Set();
-	const pages = [];
-	for (const page of options.pages) {
-		const url = normalizeUrlPath(page.url);
-		if (seen.has(url)) continue;
-		seen.add(url);
-		const resolvedLastmod = options.resolveLastmod?.(page);
-		const fallbackLastmod = normalizeDateOnly(page.lastmod ?? page.lastModified);
-		const lastmod = normalizeDateOnly(resolvedLastmod?.lastmod) ?? fallbackLastmod;
-		pages.push({
-			url,
-			absoluteUrl: absolutizeUrl(baseUrl, url),
-			markdownUrl: toDocsSitemapMarkdownUrl(url),
-			title: page.title,
-			description: page.description,
-			sourcePath: page.sourcePath,
-			lastmod,
-			lastmodSource: resolvedLastmod?.lastmodSource ?? (lastmod ? "unknown" : void 0),
-			related: page.related?.map((link) => link.href)
-		});
-	}
-	pages.sort((left, right) => left.url.localeCompare(right.url));
-	return {
-		version: 1,
-		generatedAt: options.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-		baseUrl,
-		entry: options.entry ?? "docs",
-		siteTitle: options.siteTitle,
-		pages
-	};
-}
-function renderDocsSitemapXml(manifest, options = {}) {
-	const baseUrl = normalizeBaseUrl(options.baseUrl ?? manifest.baseUrl);
-	const includeLastmod = options.includeLastmod ?? true;
-	const lines = ["<?xml version=\"1.0\" encoding=\"UTF-8\"?>", "<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">"];
-	for (const page of manifest.pages) {
-		lines.push("  <url>");
-		lines.push(`    <loc>${escapeXml(page.absoluteUrl ?? absolutizeUrl(baseUrl, page.url))}</loc>`);
-		const lastmod = normalizeDateOnly(page.lastmod);
-		if (includeLastmod && lastmod) lines.push(`    <lastmod>${lastmod}</lastmod>`);
-		lines.push("  </url>");
-	}
-	lines.push("</urlset>");
-	return `${lines.join("\n")}\n`;
-}
-function renderDocsSitemapMarkdown(manifest, options = {}) {
-	const siteTitle = manifest.siteTitle ?? "Documentation";
-	const includeDescriptions = options.includeDescriptions ?? true;
-	const includeLastmod = options.includeLastmod ?? true;
-	const linkTarget = options.linkTarget ?? "both";
-	const lines = [`# ${siteTitle} Sitemap`, ""];
-	const baseUrl = normalizeBaseUrl(options.baseUrl ?? manifest.baseUrl);
-	if (baseUrl) lines.push(`Base URL: ${baseUrl}`);
-	lines.push(`Docs entry: /${manifest.entry.replace(/^\/+|\/+$/g, "") || "docs"}`);
-	lines.push(`Generated: ${normalizeDateOnly(manifest.generatedAt) ?? manifest.generatedAt}`, "");
-	const groups = /* @__PURE__ */ new Map();
-	for (const page of manifest.pages) {
-		const sectionName = sitemapSectionName(manifest.entry, page.url);
-		groups.set(sectionName, [...groups.get(sectionName) ?? [], page]);
-	}
-	for (const [sectionName, pages] of groups) {
-		lines.push(`## ${sectionName}`, "");
-		for (const page of pages) {
-			const primaryHref = linkTarget === "markdown" ? page.markdownUrl : page.url;
-			lines.push(`- [${page.title}](${primaryHref})`);
-			if (linkTarget === "both" || linkTarget === "markdown") lines.push(`  Markdown: ${page.markdownUrl}`);
-			if (includeDescriptions && page.description) lines.push(`  Description: ${page.description}`);
-			const lastmod = normalizeDateOnly(page.lastmod);
-			if (includeLastmod && lastmod) lines.push(`  Last updated: ${lastmod}`);
-			if (page.related && page.related.length > 0) lines.push(`  Related: ${page.related.join(", ")}`);
-			lines.push("");
-		}
-	}
-	return lines.join("\n").replace(/\n{3,}/g, "\n\n");
-}
-function readDocsSitemapManifestFromContentMap(contentMap) {
-	if (!contentMap) return null;
-	const raw = contentMap[`/${DEFAULT_SITEMAP_MANIFEST_PATH}`] ?? contentMap[DEFAULT_SITEMAP_MANIFEST_PATH];
-	if (!raw) return null;
-	try {
-		return JSON.parse(raw);
-	} catch {
-		return null;
-	}
-}
-function resolveDocsSitemapPageLastmod(manifest, url) {
-	if (!manifest) return void 0;
-	const normalizedUrl = normalizeUrlPath(url);
-	return normalizeDateOnly(manifest.pages.find((entry) => normalizeUrlPath(entry.url) === normalizedUrl)?.lastmod);
-}
-function createDocsSitemapResponse({ request, sitemap, entry = "docs", siteTitle, baseUrl, pages, manifest }) {
-	const url = new URL(request.url);
-	const format = resolveDocsSitemapRequest(url, sitemap);
-	if (!format) return null;
-	const resolved = resolveDocsSitemapConfig(sitemap, { baseUrl });
-	if (!resolved.enabled) return null;
-	if (format === "xml" && !resolved.xml.enabled) return null;
-	if (format === "markdown" && !resolved.markdown.enabled) return null;
-	const nextManifest = manifest ?? buildDocsSitemapManifest({
-		pages,
-		entry,
-		siteTitle,
-		baseUrl: resolved.baseUrl ?? url.origin
-	});
-	const responseBaseUrl = resolved.baseUrl ?? nextManifest.baseUrl ?? url.origin;
-	const body = format === "xml" ? renderDocsSitemapXml(nextManifest, {
-		baseUrl: responseBaseUrl,
-		includeLastmod: resolved.xml.includeLastmod
-	}) : renderDocsSitemapMarkdown(nextManifest, {
-		baseUrl: responseBaseUrl,
-		includeDescriptions: resolved.markdown.includeDescriptions,
-		includeLastmod: resolved.markdown.includeLastmod,
-		linkTarget: resolved.markdown.linkTarget
-	});
-	const headers = new Headers({
-		"Content-Type": format === "xml" ? "application/xml; charset=utf-8" : "text/markdown; charset=utf-8",
-		"Cache-Control": "public, max-age=0, must-revalidate",
-		ETag: hashString(body)
-	});
-	const lastModified = newestLastmod(nextManifest.pages);
-	if (lastModified) headers.set("Last-Modified", (/* @__PURE__ */ new Date(`${lastModified}T00:00:00.000Z`)).toUTCString());
-	if (request.headers.get("if-none-match") === headers.get("ETag")) return new Response(null, {
-		status: 304,
-		headers
-	});
-	return new Response(body, { headers });
-}
-
-//#endregion
-export { DEFAULT_SITEMAP_XML_ROUTE as a, readDocsSitemapManifestFromContentMap as c, resolveDocsSitemapConfig as d, resolveDocsSitemapPageLastmod as f, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as i, renderDocsSitemapMarkdown as l, toDocsSitemapMarkdownUrl as m, DEFAULT_SITEMAP_MD_DOCS_ROUTE as n, buildDocsSitemapManifest as o, resolveDocsSitemapRequest as p, DEFAULT_SITEMAP_MD_ROUTE as r, createDocsSitemapResponse as s, DEFAULT_SITEMAP_MANIFEST_PATH as t, renderDocsSitemapXml as u };