@rimelight/seo 0.0.5 → 0.0.7

package/dist/og.d.mts

@@ -0,0 +1,117 @@
+//#region src/og.d.ts
+/**
+ * Font configuration for OG image rendering. Pass to `loadOgFonts()` or `renderOgResponse()`.
+ */
+export interface OgFontConfig {
+  /**
+   * Font-family name referenced in layout styles
+   */
+  name: string;
+  /**
+   * URL to the regular-weight TTF
+   */
+  regularUrl: string;
+  /**
+   * URL to the bold-weight TTF
+   */
+  boldUrl: string;
+}
+/**
+ * Default font: Noto Sans from jsDelivr Fontsource CDN.
+ */
+export declare const NOTO_SANS: OgFontConfig;
+/**
+ * Options for the default OG image layout. Build your own layout instead via `renderOgResponse()`
+ * directly.
+ */
+export interface OgLayoutOptions {
+  /**
+   * Main heading -- required
+   */
+  title: string;
+  /**
+   * Subtitle / excerpt beneath the title
+   */
+  description?: string;
+  /**
+   * Branding shown top-left. Pass a plain string (site name) or a pre-built takumi-js VNode for a
+   * custom logo treatment.
+   */
+  brand?: string | object;
+  /**
+   * Pill badge shown bottom-left. e.g. "Blog Post", "Documentation", "Legal"
+   */
+  badge?: string;
+  /**
+   * Date string shown bottom-right. e.g. new Date(postedAt).toLocaleDateString()
+   */
+  date?: string;
+  /**
+   * Background style. "dark" -> solid #0a0a0a (default) "gradient" -> diagonal dark-to-navy
+   * gradient any string -> treated as a CSS `background` value
+   */
+  background?: "dark" | "gradient" | (string & {});
+  /**
+   * When true, overlays a dashed red PREVIEW border. Useful during development.
+   */
+  preview?: boolean;
+}
+/**
+ * Rendering config shared by `renderOgResponse()` and `renderDefaultOg()`.
+ */
+export interface OgRenderConfig {
+  /**
+   * Font to embed -- defaults to `NOTO_SANS`
+   */
+  font?: OgFontConfig;
+  /**
+   * Image width in px -- defaults to 1200
+   */
+  width?: number;
+  /**
+   * Image height in px -- defaults to 630
+   */
+  height?: number;
+}
+/**
+ * Fetches and caches the regular + bold TTF buffers for the given font config. Uses a module-level
+ * cache keyed on `regularUrl`, so repeated calls within the same Worker lifetime are free after the
+ * first fetch.
+ */
+export declare function loadOgFonts(config?: OgFontConfig, timeoutMs?: number): Promise<{
+  regular: ArrayBuffer;
+  bold: ArrayBuffer;
+}>;
+/**
+ * Builds a takumi-js-compatible VNode for the default Rimelight OG layout.
+ *
+ * Consumers that need a fully custom look should build their own VNode and call
+ * `renderOgResponse()` directly -- this function is just the house style.
+ */
+export declare function defaultOgLayout(options: OgLayoutOptions, font?: OgFontConfig): object;
+/**
+ * Renders any takumi-js VNode to a PNG `Response` with standard OG headers. Use this when you
+ * supply your own layout entirely.
+ *
+ * @example
+ *   const vnode = myBrandedLayout({ title, description })
+ *   return renderOgResponse(vnode, { font: MY_FONT })
+ */
+export declare function renderOgResponse(vnode: object, config?: OgRenderConfig): Promise<Response>;
+/**
+ * Renders the default OG layout to a PNG `Response`. The 90% case -- use `renderOgResponse()` for
+ * full layout control.
+ *
+ * @example
+ *   export const GET: APIRoute = async ({ request }) => {
+ *     const url = new URL(request.url)
+ *     return renderDefaultOg({
+ *       title: url.searchParams.get("title") ?? "Untitled",
+ *       description: url.searchParams.get("description") ?? "",
+ *       brand: "My Site",
+ *       badge: url.searchParams.get("type") ?? ""
+ *     })
+ *   }
+ */
+export declare function renderDefaultOg(options: OgLayoutOptions, config?: OgRenderConfig): Promise<Response>;
+//#endregion

package/dist/og.mjs

@@ -0,0 +1,302 @@
+//#region src/og.ts
+/**
+* Default font: Noto Sans from jsDelivr Fontsource CDN.
+*/
+const NOTO_SANS = {
+	name: "Noto Sans",
+	regularUrl: "https://cdn.jsdelivr.net/fontsource/fonts/noto-sans@latest/latin-400-normal.ttf",
+	boldUrl: "https://cdn.jsdelivr.net/fontsource/fonts/noto-sans@latest/latin-700-normal.ttf"
+};
+const fontCaches = /* @__PURE__ */ new Map();
+/**
+* Fetches an ArrayBuffer with a timeout.
+*/
+async function fetchArrayBuffer(url, timeoutMs = 5e3) {
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+	try {
+		const res = await fetch(url, { signal: controller.signal });
+		if (!res.ok) throw new Error(`Failed to fetch font from ${url}: status ${res.status}`);
+		return await res.arrayBuffer();
+	} finally {
+		clearTimeout(timeoutId);
+	}
+}
+/**
+* Fetches and caches the regular + bold TTF buffers for the given font config. Uses a module-level
+* cache keyed on `regularUrl`, so repeated calls within the same Worker lifetime are free after the
+* first fetch.
+*/
+async function loadOgFonts(config = NOTO_SANS, timeoutMs = 5e3) {
+	const cached = fontCaches.get(config.regularUrl);
+	if (cached) return cached;
+	const [regular, bold] = await Promise.all([fetchArrayBuffer(config.regularUrl, timeoutMs), fetchArrayBuffer(config.boldUrl, timeoutMs)]);
+	const result = {
+		regular,
+		bold
+	};
+	fontCaches.set(config.regularUrl, result);
+	return result;
+}
+/**
+* Builds a takumi-js-compatible VNode for the default Rimelight OG layout.
+*
+* Consumers that need a fully custom look should build their own VNode and call
+* `renderOgResponse()` directly -- this function is just the house style.
+*/
+function defaultOgLayout(options, font = NOTO_SANS) {
+	const { title, description, brand, badge, date, background = "dark", preview = false } = options;
+	const MAX_TITLE_LEN = 160;
+	const MAX_DESC_LEN = 240;
+	const safeTitle = title.length > MAX_TITLE_LEN ? title.slice(0, 159) + "…" : title;
+	const safeDescription = description && description.length > MAX_DESC_LEN ? description.slice(0, 239) + "…" : description;
+	const bg = background === "dark" ? { backgroundColor: "#0a0a0a" } : background === "gradient" ? { background: "linear-gradient(135deg, #0a0a0a 0%, #1a1a2e 100%)" } : { background };
+	const isGradient = background !== "dark";
+	const brandNode = typeof brand === "object" && brand !== null ? brand : {
+		type: "span",
+		props: {
+			style: {
+				fontSize: "28px",
+				fontWeight: 700,
+				color: "#ffffff",
+				letterSpacing: "-0.02em"
+			},
+			children: brand ?? ""
+		}
+	};
+	const accentBar = isGradient ? {
+		type: "div",
+		props: { style: {
+			width: "60px",
+			height: "4px",
+			backgroundColor: "#60a5fa",
+			borderRadius: "2px",
+			marginBottom: "16px"
+		} }
+	} : null;
+	const titleFontSize = isGradient ? "52px" : "56px";
+	const descColor = isGradient ? "#94a3b8" : "#a0a0a0";
+	const descFontSize = isGradient ? "22px" : "24px";
+	const badgeNode = badge ? isGradient ? {
+		type: "div",
+		props: {
+			style: {
+				padding: "6px 16px",
+				borderRadius: "9999px",
+				backgroundColor: "rgba(96,165,250,0.15)",
+				border: "1px solid rgba(96,165,250,0.3)",
+				fontSize: "14px",
+				fontWeight: 600,
+				color: "#93c5fd"
+			},
+			children: badge
+		}
+	} : {
+		type: "div",
+		props: {
+			style: {
+				padding: "8px 20px",
+				borderRadius: "9999px",
+				border: "1px solid #333333",
+				fontSize: "16px",
+				fontWeight: 600,
+				color: "#e5e5e5"
+			},
+			children: badge
+		}
+	} : null;
+	const dateNode = date ? {
+		type: "div",
+		props: {
+			style: {
+				fontSize: "16px",
+				color: "#666666"
+			},
+			children: date
+		}
+	} : null;
+	const previewOverlay = preview ? {
+		type: "div",
+		props: { style: {
+			position: "absolute",
+			inset: 0,
+			border: "6px dashed #ff4444",
+			pointerEvents: "none"
+		} }
+	} : null;
+	const previewLabel = preview ? {
+		type: "div",
+		props: {
+			style: {
+				position: "absolute",
+				top: "12px",
+				right: "12px",
+				backgroundColor: "#ff4444",
+				color: "#ffffff",
+				fontSize: "14px",
+				fontWeight: 700,
+				padding: "6px 16px",
+				borderRadius: "4px",
+				letterSpacing: "0.05em"
+			},
+			children: "PREVIEW"
+		}
+	} : null;
+	return {
+		type: "div",
+		props: {
+			style: {
+				width: "100%",
+				height: "100%",
+				display: "flex",
+				flexDirection: "column",
+				padding: "56px",
+				color: "#e5e5e5",
+				fontFamily: font.name,
+				position: "relative",
+				overflow: "hidden",
+				...bg
+			},
+			children: [
+				{
+					type: "div",
+					props: {
+						style: {
+							display: "flex",
+							alignItems: "center"
+						},
+						children: [brandNode]
+					}
+				},
+				{
+					type: "div",
+					props: {
+						style: {
+							display: "flex",
+							flexDirection: "column",
+							justifyContent: "center",
+							flexGrow: 1,
+							paddingTop: "24px"
+						},
+						children: [
+							accentBar,
+							{
+								type: "div",
+								props: {
+									style: {
+										fontSize: titleFontSize,
+										fontWeight: 700,
+										color: "#ffffff",
+										lineHeight: 1.15,
+										maxWidth: "950px"
+									},
+									children: safeTitle
+								}
+							},
+							safeDescription ? {
+								type: "div",
+								props: {
+									style: {
+										fontSize: descFontSize,
+										fontWeight: 400,
+										color: descColor,
+										marginTop: isGradient ? "12px" : "16px",
+										lineHeight: 1.4,
+										maxWidth: isGradient ? "800px" : "850px"
+									},
+									children: safeDescription
+								}
+							} : null
+						].filter(Boolean)
+					}
+				},
+				{
+					type: "div",
+					props: {
+						style: {
+							display: "flex",
+							alignItems: "center",
+							justifyContent: isGradient ? "flex-start" : "space-between",
+							gap: "12px",
+							marginTop: "auto"
+						},
+						children: [badgeNode, dateNode].filter(Boolean)
+					}
+				},
+				previewOverlay,
+				previewLabel
+			].filter(Boolean)
+		}
+	};
+}
+/**
+* Renders any takumi-js VNode to a PNG `Response` with standard OG headers. Use this when you
+* supply your own layout entirely.
+*
+* @example
+*   const vnode = myBrandedLayout({ title, description })
+*   return renderOgResponse(vnode, { font: MY_FONT })
+*/
+async function renderOgResponse(vnode, config = {}) {
+	const { font = NOTO_SANS, width = 1200, height = 630 } = config;
+	try {
+		const { render } = await import("takumi-js");
+		const { regular, bold } = await loadOgFonts(font);
+		const pngBuffer = await render(vnode, {
+			width,
+			height,
+			fonts: [{
+				name: font.name,
+				data: regular,
+				weight: 400,
+				style: "normal"
+			}, {
+				name: font.name,
+				data: bold,
+				weight: 700,
+				style: "normal"
+			}]
+		});
+		return new Response(new Blob([new Uint8Array(pngBuffer)], { type: "image/png" }), {
+			status: 200,
+			headers: {
+				"Content-Type": "image/png",
+				"Cache-Control": "public, max-age=31536000, immutable",
+				"CDN-Cache-Control": "public, max-age=31536000"
+			}
+		});
+	} catch (error) {
+		console.error("[OG Render Error]:", error);
+		return new Response(JSON.stringify({
+			error: "Failed to render Open Graph image",
+			message: error instanceof Error ? error.message : String(error)
+		}), {
+			status: 500,
+			headers: {
+				"Content-Type": "application/json",
+				"Cache-Control": "no-store"
+			}
+		});
+	}
+}
+/**
+* Renders the default OG layout to a PNG `Response`. The 90% case -- use `renderOgResponse()` for
+* full layout control.
+*
+* @example
+*   export const GET: APIRoute = async ({ request }) => {
+*     const url = new URL(request.url)
+*     return renderDefaultOg({
+*       title: url.searchParams.get("title") ?? "Untitled",
+*       description: url.searchParams.get("description") ?? "",
+*       brand: "My Site",
+*       badge: url.searchParams.get("type") ?? ""
+*     })
+*   }
+*/
+async function renderDefaultOg(options, config = {}) {
+	const { font = NOTO_SANS } = config;
+	return renderOgResponse(defaultOgLayout(options, font), config);
+}
+//#endregion
+export { NOTO_SANS, defaultOgLayout, loadOgFonts, renderDefaultOg, renderOgResponse };

package/dist/routes/api-catalog.d.mts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/routes/api-catalog.d.ts
+export declare const prerender = false;
+export declare const GET: APIRoute;
+//#endregion

package/dist/routes/api-catalog.mjs

@@ -0,0 +1,38 @@
+import { buildApiCatalog } from "../catalog.mjs";
+import seoOptions from "virtual:rimelight-seo/options";
+//#region src/routes/api-catalog.ts
+const prerender = false;
+const GET = () => {
+	const catalogOpts = typeof seoOptions?.apiCatalog === "object" ? seoOptions.apiCatalog : {};
+	const defaultItems = [{
+		rel: "self",
+		href: "/.well-known/api-catalog",
+		type: "application/linkset+json"
+	}];
+	if (seoOptions?.sitemap !== false) defaultItems.push({
+		rel: "alternate",
+		href: "/sitemap.xml",
+		type: "application/xml",
+		title: "Sitemap"
+	});
+	if (seoOptions?.rss !== false) defaultItems.push({
+		rel: "alternate",
+		href: "/rss.xml",
+		type: "application/rss+xml",
+		title: "RSS Feed"
+	});
+	if (seoOptions?.llms !== false) defaultItems.push({
+		rel: "llms",
+		href: "/llms.txt",
+		type: "text/plain",
+		title: "LLMs.txt"
+	});
+	const items = catalogOpts.items || defaultItems;
+	const catalog = buildApiCatalog({ items });
+	return new Response(JSON.stringify(catalog, null, 2), { headers: {
+		"Content-Type": "application/linkset+json; charset=utf-8",
+		"Cache-Control": "public, max-age=86400, stale-while-revalidate=604800"
+	} });
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/apple-touch-icon.png.d.mts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/routes/apple-touch-icon.png.d.ts
+export declare const prerender = true;
+export declare const GET: APIRoute;
+//#endregion

package/dist/routes/apple-touch-icon.png.mjs

@@ -0,0 +1,17 @@
+import { generatePng } from "../assets.mjs";
+import { masterIconBuffer } from "virtual:rimelight-seo/assets";
+//#region src/routes/apple-touch-icon.png.ts
+const prerender = true;
+const GET = async () => {
+	if (!masterIconBuffer) return new Response(null, { status: 404 });
+	const png = await generatePng(masterIconBuffer, {
+		width: 180,
+		height: 180
+	});
+	return new Response(new Uint8Array(png), { headers: {
+		"Content-Type": "image/png",
+		"Cache-Control": "public, max-age=31536000, immutable"
+	} });
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/favicon.ico.d.mts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/routes/favicon.ico.d.ts
+export declare const prerender = true;
+export declare const GET: APIRoute;
+//#endregion

package/dist/routes/favicon.ico.mjs

@@ -0,0 +1,14 @@
+import { generateIco } from "../assets.mjs";
+import { masterIconBuffer } from "virtual:rimelight-seo/assets";
+//#region src/routes/favicon.ico.ts
+const prerender = true;
+const GET = async () => {
+	if (!masterIconBuffer) return new Response(null, { status: 404 });
+	const ico = await generateIco(masterIconBuffer, 32);
+	return new Response(new Uint8Array(ico), { headers: {
+		"Content-Type": "image/x-icon",
+		"Cache-Control": "public, max-age=31536000, immutable"
+	} });
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/favicon.svg.d.mts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/routes/favicon.svg.d.ts
+export declare const prerender = true;
+export declare const GET: APIRoute;
+//#endregion

package/dist/routes/favicon.svg.mjs

@@ -0,0 +1,12 @@
+import { isSvg, masterIconBuffer } from "virtual:rimelight-seo/assets";
+//#region src/routes/favicon.svg.ts
+const prerender = true;
+const GET = async () => {
+	if (!masterIconBuffer || !isSvg) return new Response(null, { status: 404 });
+	return new Response(new Uint8Array(masterIconBuffer), { headers: {
+		"Content-Type": "image/svg+xml",
+		"Cache-Control": "public, max-age=31536000, immutable"
+	} });
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/icon-192.png.d.mts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/routes/icon-192.png.d.ts
+export declare const prerender = true;
+export declare const GET: APIRoute;
+//#endregion

package/dist/routes/icon-192.png.mjs

@@ -0,0 +1,17 @@
+import { generatePng } from "../assets.mjs";
+import { masterIconBuffer } from "virtual:rimelight-seo/assets";
+//#region src/routes/icon-192.png.ts
+const prerender = true;
+const GET = async () => {
+	if (!masterIconBuffer) return new Response(null, { status: 404 });
+	const png = await generatePng(masterIconBuffer, {
+		width: 192,
+		height: 192
+	});
+	return new Response(new Uint8Array(png), { headers: {
+		"Content-Type": "image/png",
+		"Cache-Control": "public, max-age=31536000, immutable"
+	} });
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/icon-512.png.d.mts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/routes/icon-512.png.d.ts
+export declare const prerender = true;
+export declare const GET: APIRoute;
+//#endregion

package/dist/routes/icon-512.png.mjs

@@ -0,0 +1,17 @@
+import { generatePng } from "../assets.mjs";
+import { masterIconBuffer } from "virtual:rimelight-seo/assets";
+//#region src/routes/icon-512.png.ts
+const prerender = true;
+const GET = async () => {
+	if (!masterIconBuffer) return new Response(null, { status: 404 });
+	const png = await generatePng(masterIconBuffer, {
+		width: 512,
+		height: 512
+	});
+	return new Response(new Uint8Array(png), { headers: {
+		"Content-Type": "image/png",
+		"Cache-Control": "public, max-age=31536000, immutable"
+	} });
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/icon-maskable-512.png.d.mts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/routes/icon-maskable-512.png.d.ts
+export declare const prerender = true;
+export declare const GET: APIRoute;
+//#endregion

package/dist/routes/icon-maskable-512.png.mjs

@@ -0,0 +1,18 @@
+import { generateMaskablePng } from "../assets.mjs";
+import { backgroundColor, masterIconBuffer } from "virtual:rimelight-seo/assets";
+//#region src/routes/icon-maskable-512.png.ts
+const prerender = true;
+const GET = async () => {
+	if (!masterIconBuffer) return new Response(null, { status: 404 });
+	const png = await generateMaskablePng(masterIconBuffer, {
+		size: 512,
+		background: backgroundColor || "#ffffff",
+		paddingRatio: .15
+	});
+	return new Response(new Uint8Array(png), { headers: {
+		"Content-Type": "image/png",
+		"Cache-Control": "public, max-age=31536000, immutable"
+	} });
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/llms-full.txt.d.mts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/routes/llms-full.txt.d.ts
+export declare const prerender = false;
+export declare const GET: APIRoute;
+//#endregion

package/dist/routes/llms-full.txt.mjs

@@ -0,0 +1,57 @@
+import * as siteConfigMod from "virtual:rimelight-seo/site-config";
+import * as dbMod from "virtual:rimelight-seo/db";
+import * as corpusMod from "virtual:rimelight-seo/corpus";
+//#region src/routes/llms-full.txt.ts
+const prerender = false;
+const GET = async ({ site, url }) => {
+	const siteConfig = siteConfigMod.siteConfig || {};
+	const siteUrl = site ? site.toString() : siteConfig.url || `${url.protocol}//${url.host}`;
+	const title = siteConfig.name ? `${siteConfig.name} Full Documentation Corpus` : "Full Documentation Corpus";
+	const description = "Complete single-corpus documentation for AI agents and LLM ingest.";
+	if (Array.isArray(corpusMod.corpusPages) && corpusMod.corpusPages.length > 0) {
+		const sections = /* @__PURE__ */ new Map();
+		for (const p of corpusMod.corpusPages) {
+			const key = (p.section || "GENERAL").toUpperCase();
+			if (!sections.has(key)) sections.set(key, []);
+			const slug = p.slug === "index" ? "" : p.slug;
+			const pageUrl = `${siteUrl.replace(/\/$/, "")}/${slug}`.replace(/\/+$/, "");
+			sections.get(key).push(`### ${p.title}\nURL: ${pageUrl}\n${p.description || ""}`);
+		}
+		const body = [
+			`# ${title}`,
+			"",
+			description,
+			"",
+			...Array.from(sections.entries()).flatMap(([section, pages]) => [
+				`## ${section}`,
+				"",
+				...pages,
+				""
+			])
+		].join("\n");
+		return new Response(body, { headers: {
+			"Content-Type": "text/plain; charset=utf-8",
+			"Cache-Control": "public, max-age=3600, s-maxage=86400"
+		} });
+	}
+	if (dbMod.db) try {
+		const { renderCorpusMarkdown } = await import("@rimelight/cms");
+		const body = await renderCorpusMarkdown(dbMod.db, {
+			type: "doc",
+			locale: "en",
+			siteUrl,
+			title,
+			description
+		});
+		return new Response(body, { headers: {
+			"Content-Type": "text/plain; charset=utf-8",
+			"Cache-Control": "public, max-age=3600, s-maxage=86400"
+		} });
+	} catch {}
+	return new Response(`# ${title}\n\n${description}\n`, { headers: {
+		"Content-Type": "text/plain; charset=utf-8",
+		"Cache-Control": "public, max-age=3600, s-maxage=86400"
+	} });
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/llms.txt.d.mts

@@ -1,4 +1,5 @@
 import { APIRoute } from "astro";
 //#region src/routes/llms.txt.d.ts
+export declare const prerender = false;
 export declare const GET: APIRoute;
 //#endregion