@rimelight/seo 0.0.8 → 0.0.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rimelight Entertainment
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { generateIco, generateMaskablePng, generateOgCard, generatePng } from "./assets.mjs";
 import { i as buildBreadcrumbSchema, n as BreadcrumbItem, r as buildArticleSchema, t as ArticleSchemaOptions } from "./schema-C8v69blQ.mjs";
 import { a as buildLlmsTxt, i as buildLlmsFullTxt, n as LlmsPage, r as LlmsTxtOptions, t as LlmsFullTxtOptions } from "./llms-BVLxzjr-.mjs";
-import { ApiCatalog, ApiCatalogItem, ApiCatalogOptions, ApiCatalogRouteOptions, AssetRouteOptions, ChangeFreq, HeadProps, LlmsFullRouteOptions, LlmsRouteOptions, LocaleConfig, ManifestRouteOptions, OGImage, OpenGraphMeta, RSSFeed, RimelightSeoOptions, RobotsOptions, RobotsRouteOptions, RssCollectionConfig, RssFeedOptions, RssItem, RssOptions, SecurityRouteOptions, SecurityTxtOptions, SeoEntry, SiteConfig, SitemapAlternate, SitemapOptions, SitemapUrl, TwitterMeta, UserAgentRule, WebManifest, WebManifestIcon, WebManifestOptions, WebManifestShortcut } from "./types.mjs";
+import { ApiCatalog, ApiCatalogItem, ApiCatalogOptions, ApiCatalogRouteOptions, AssetRouteOptions, ChangeFreq, HeadProps, LlmsFullRouteOptions, LlmsRouteOptions, LocaleConfig, ManifestRouteOptions, OGImage, OgRouteOptions, OpenGraphMeta, RSSFeed, RimelightSeoOptions, RobotsOptions, RobotsRouteOptions, RssCollectionConfig, RssFeedOptions, RssItem, RssOptions, SecurityRouteOptions, SecurityTxtOptions, SeoEntry, SiteConfig, SitemapAlternate, SitemapOptions, SitemapUrl, TwitterMeta, UserAgentRule, WebManifest, WebManifestIcon, WebManifestOptions, WebManifestShortcut } from "./types.mjs";
 import { buildApiCatalog } from "./catalog.mjs";
 import { buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, chunkSitemapUrls } from "./sitemap.mjs";
 import { buildRobotsTxt } from "./robots.mjs";
@@ -11,4 +11,4 @@ import { buildSecurityTxt } from "./security.mjs";
 import { buildWebManifest } from "./manifest.mjs";
 import { OgFontConfig, OgLayoutOptions, OgRenderConfig } from "./og.mjs";
 import rimelightSeo from "./integration.mjs";
-export { type ApiCatalog, type ApiCatalogItem, type ApiCatalogOptions, type ApiCatalogRouteOptions, type ArticleSchemaOptions, type AssetRouteOptions, type BreadcrumbItem, type ChangeFreq, type HeadProps, type LlmsFullRouteOptions, type LlmsFullTxtOptions, type LlmsPage, type LlmsRouteOptions, type LlmsTxtOptions, type LocaleConfig, type ManifestRouteOptions, type OGImage, type OgFontConfig, type OgLayoutOptions, type OgRenderConfig, type OpenGraphMeta, type RSSFeed, type RimelightSeoOptions, type RobotsOptions, type RobotsRouteOptions, type RssCollectionConfig, type RssFeedOptions, type RssItem, type RssOptions, type SecurityRouteOptions, type SecurityTxtOptions, type SeoEntry, type SiteConfig, type SitemapAlternate, type SitemapOptions, type SitemapUrl, type TwitterMeta, type UserAgentRule, type WebManifest, type WebManifestIcon, type WebManifestOptions, type WebManifestShortcut, buildApiCatalog, buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildRssXml, buildSafeDescription, buildSecurityTxt, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebManifest, buildWebSiteSchema, chunkSitemapUrls, deepMerge, rimelightSeo as default, rimelightSeo, escapeXml, generateIco, generateMaskablePng, generateOgCard, generatePng };
+export { type ApiCatalog, type ApiCatalogItem, type ApiCatalogOptions, type ApiCatalogRouteOptions, type ArticleSchemaOptions, type AssetRouteOptions, type BreadcrumbItem, type ChangeFreq, type HeadProps, type LlmsFullRouteOptions, type LlmsFullTxtOptions, type LlmsPage, type LlmsRouteOptions, type LlmsTxtOptions, type LocaleConfig, type ManifestRouteOptions, type OGImage, type OgFontConfig, type OgLayoutOptions, type OgRenderConfig, type OgRouteOptions, type OpenGraphMeta, type RSSFeed, type RimelightSeoOptions, type RobotsOptions, type RobotsRouteOptions, type RssCollectionConfig, type RssFeedOptions, type RssItem, type RssOptions, type SecurityRouteOptions, type SecurityTxtOptions, type SeoEntry, type SiteConfig, type SitemapAlternate, type SitemapOptions, type SitemapUrl, type TwitterMeta, type UserAgentRule, type WebManifest, type WebManifestIcon, type WebManifestOptions, type WebManifestShortcut, buildApiCatalog, buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildRssXml, buildSafeDescription, buildSecurityTxt, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebManifest, buildWebSiteSchema, chunkSitemapUrls, deepMerge, rimelightSeo as default, rimelightSeo, escapeXml, generateIco, generateMaskablePng, generateOgCard, generatePng };

package/dist/integration.mjs

@@ -15,21 +15,35 @@ function rimelightSeo(options = {}) {
 				}
 				return null;
 			};
-			const seoConfigPath = findFile([
-				"src/config/seo.config.ts",
-				"src/config/seo.config.js",
-				"src/config/seo.config.mjs"
-			]);
-			const hasConfigExport = (name) => {
-				if (!seoConfigPath) return false;
-				const content = fs.readFileSync(seoConfigPath, "utf8");
-				return new RegExp(`export\\s+(?:const|let|var|async\\s+function|function|class)\\s+${name}\\b`).test(content) || new RegExp(`export\\s*\\{[^}]*\\b${name}\\b}`).test(content);
+			const siteOpt = options.site || {};
+			const normalizedSiteConfig = {
+				id: siteOpt.id || options.id || "",
+				name: siteOpt.name || options.name || "",
+				description: siteOpt.description || options.description || "",
+				url: siteOpt.url || options.url || "",
+				ogImage: siteOpt.ogImage || options.ogImage || void 0,
+				author: siteOpt.author || options.author || siteOpt.name || options.name || "",
+				email: siteOpt.email || options.email || "",
+				branding: {
+					logo: { alt: siteOpt.branding?.logo?.alt || options.branding?.logo?.alt || siteOpt.name || options.name || "" },
+					colors: {
+						themeColor: siteOpt.branding?.colors?.themeColor || options.branding?.colors?.themeColor || "#ffffff",
+						backgroundColor: siteOpt.branding?.colors?.backgroundColor || options.branding?.colors?.backgroundColor || "#ffffff"
+					},
+					...siteOpt.branding,
+					...options.branding
+				},
+				seo: {
+					titleTemplate: siteOpt.seo?.titleTemplate || options.titleTemplate || (options.name ? `%s | ${options.name}` : "%s"),
+					maxDescriptionLength: siteOpt.seo?.maxDescriptionLength || options.maxDescriptionLength || 160,
+					authorHandle: siteOpt.seo?.authorHandle || options.authorHandle || void 0,
+					...siteOpt.seo
+				},
+				...siteOpt.openGraph || options.openGraph ? { openGraph: siteOpt.openGraph || options.openGraph } : {},
+				...siteOpt.twitter || options.twitter ? { twitter: siteOpt.twitter || options.twitter } : {}
 			};
-			const siteConfigPath = findFile([
-				"src/config/site.config.ts",
-				"src/config/site.config.js",
-				"src/config/site.config.mjs"
-			]);
+			const seoLocales = options.locales;
+			const privatePathPrefixes = options.privatePathPrefixes || [];
 			const dbPath = findFile([
 				"src/db/index.ts",
 				"src/db/index.js",
@@ -63,10 +77,16 @@ function rimelightSeo(options = {}) {
 				pattern: typeof options.robots === "object" && options.robots.path ? options.robots.path : "/robots.txt",
 				entrypoint: "@rimelight/seo/routes/robots.txt.ts"
 			});
-			if (options.sitemap !== false) injectRoute({
-				pattern: typeof options.sitemap === "object" && options.sitemap.path ? options.sitemap.path : "/sitemap.xml",
-				entrypoint: "@rimelight/seo/routes/sitemap.xml.ts"
-			});
+			if (options.sitemap !== false) {
+				injectRoute({
+					pattern: typeof options.sitemap === "object" && options.sitemap.path ? options.sitemap.path : "/sitemap.xml",
+					entrypoint: "@rimelight/seo/routes/sitemap.xml.ts"
+				});
+				injectRoute({
+					pattern: "/sitemap-index.xml",
+					entrypoint: "@rimelight/seo/routes/sitemap-index.xml.ts"
+				});
+			}
 			if (options.rss !== false) injectRoute({
 				pattern: typeof options.rss === "object" && options.rss.path ? options.rss.path : "/rss.xml",
 				entrypoint: "@rimelight/seo/routes/rss.xml.ts"
@@ -98,6 +118,10 @@ function rimelightSeo(options = {}) {
 				pattern: typeof options.manifest === "object" && options.manifest.path ? options.manifest.path : "/site.webmanifest",
 				entrypoint: "@rimelight/seo/routes/site.webmanifest.ts"
 			});
+			if (options.og !== false) injectRoute({
+				pattern: typeof options.og === "object" && options.og.path ? options.og.path : "/open-graph/[...route].png",
+				entrypoint: "@rimelight/seo/routes/open-graph.[...route].png.ts"
+			});
 			updateConfig({ vite: { plugins: [{
 				name: "vite-plugin-rimelight-seo-assets",
 				configureServer(server) {
@@ -245,6 +269,7 @@ function rimelightSeo(options = {}) {
 				name: "vite-plugin-rimelight-seo",
 				resolveId(id) {
 					if (id === "virtual:rimelight-seo-config" || id === "virtual:rimelight-seo/options") return "\0virtual:rimelight-seo/options";
+					if (id === "virtual:rimelight/seo") return "\0virtual:rimelight/seo";
 					if (id === "virtual:rimelight-seo/config") return "\0virtual:rimelight-seo/config";
 					if (id === "virtual:rimelight-seo/site-config") return "\0virtual:rimelight-seo/site-config";
 					if (id === "virtual:rimelight-seo/db") return "\0virtual:rimelight-seo/db";
@@ -253,26 +278,21 @@ function rimelightSeo(options = {}) {
 				},
 				load(id) {
 					if (id === "\0virtual:rimelight-seo/options") return `export default ${JSON.stringify(options)};`;
-					if (id === "\0virtual:rimelight-seo/config") {
-						if (seoConfigPath) {
-							const seoEntriesExport = hasConfigExport("seoEntries");
-							const rssEntriesExport = hasConfigExport("rssEntries");
-							return `import * as customConfig from ${JSON.stringify(seoConfigPath)};
-export const SEO_LOCALES = customConfig.SEO_LOCALES;
-export const PRIVATE_PATH_PREFIXES = customConfig.PRIVATE_PATH_PREFIXES || [];
-export const seoEntries = ${seoEntriesExport ? "customConfig.seoEntries" : "undefined"};
-export const rssEntries = ${rssEntriesExport ? "customConfig.rssEntries" : "undefined"};
-export default customConfig;`;
-						}
-						return `export const SEO_LOCALES = undefined;
-export const PRIVATE_PATH_PREFIXES = [];
+					if (id === "\0virtual:rimelight/seo") return `export const siteConfig = ${JSON.stringify(normalizedSiteConfig)};
+export const SEO_LOCALES = ${JSON.stringify(seoLocales)};
+export const PRIVATE_PATH_PREFIXES = ${JSON.stringify(privatePathPrefixes)};
+export const seoConfig = {
+  SEO_LOCALES: ${JSON.stringify(seoLocales)},
+  PRIVATE_PATH_PREFIXES: ${JSON.stringify(privatePathPrefixes)}
+};
+export default siteConfig;`;
+					if (id === "\0virtual:rimelight-seo/config") return `export const SEO_LOCALES = ${JSON.stringify(seoLocales)};
+export const PRIVATE_PATH_PREFIXES = ${JSON.stringify(privatePathPrefixes)};
 export const seoEntries = async () => [];
-export const rssEntries = undefined;`;
-					}
-					if (id === "\0virtual:rimelight-seo/site-config") {
-						if (siteConfigPath) return `export * from ${JSON.stringify(siteConfigPath)};`;
-						return `export const siteConfig = { name: "Site", description: "", url: "" };`;
-					}
+export const rssEntries = undefined;
+export default { SEO_LOCALES: ${JSON.stringify(seoLocales)}, PRIVATE_PATH_PREFIXES: ${JSON.stringify(privatePathPrefixes)} };`;
+					if (id === "\0virtual:rimelight-seo/site-config") return `export const siteConfig = ${JSON.stringify(normalizedSiteConfig)};
+export default siteConfig;`;
 					if (id === "\0virtual:rimelight-seo/db") {
 						if (dbPath) return `export * from ${JSON.stringify(dbPath)};`;
 						return `export const db = null;

package/dist/routes/open-graph._...route_.png.d.mts

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

package/dist/routes/open-graph._...route_.png.mjs

@@ -0,0 +1,57 @@
+import { renderDefaultOg } from "../og.mjs";
+import seoOptions from "virtual:rimelight-seo/options";
+import * as siteConfigMod from "virtual:rimelight-seo/site-config";
+import * as dbMod from "virtual:rimelight-seo/db";
+//#region src/routes/open-graph.[...route].png.ts
+const prerender = false;
+function getLocalizedText(val, locale = "en") {
+	if (typeof val === "object" && val !== null) {
+		const record = val;
+		return record[locale] || Object.values(record)[0] || "";
+	}
+	if (typeof val === "string") return val;
+	if (typeof val === "number" || typeof val === "boolean") return String(val);
+	return "";
+}
+const GET = async ({ request }) => {
+	const url = new URL(request.url);
+	const routeParam = url.pathname.replace(/^\/open-graph\//, "").replace(/\.png$/, "");
+	const siteConfig = siteConfigMod.siteConfig || {};
+	const ogOpts = typeof seoOptions?.og === "object" ? seoOptions.og : {};
+	const brand = ogOpts.brand || seoOptions?.name || siteConfig.name || url.hostname;
+	const defaultBg = ogOpts.defaultBackground ?? "dark";
+	const docsBg = ogOpts.docsBackground ?? "gradient";
+	let title = url.searchParams.get("title") || "";
+	let description = url.searchParams.get("description") || "";
+	let date = url.searchParams.get("pubDate") || "";
+	const badge = url.searchParams.get("type") || (routeParam.includes("blog") ? "Blog Post" : routeParam.includes("legal") ? "Legal" : "");
+	if (!title && routeParam && routeParam !== "page" && routeParam !== "default" && dbMod.db) try {
+		const { pages: pagesTable } = await import("#db/schema").catch(() => ({ pages: null }));
+		const { eq, and, isNull } = await import("drizzle-orm");
+		if (pagesTable) {
+			const slug = routeParam.split("/").pop() ?? "";
+			const page = await dbMod.db.select({
+				title: pagesTable.title,
+				description: pagesTable.description,
+				postedAt: pagesTable.postedAt
+			}).from(pagesTable).where(and(eq(pagesTable.slug, slug), isNull(pagesTable.deletedAt))).limit(1).then((r) => r[0]).catch(() => void 0);
+			if (page) {
+				title = getLocalizedText(page.title);
+				description = description || getLocalizedText(page.description);
+				if (page.postedAt && !date) date = new Date(page.postedAt).toLocaleDateString();
+			}
+		}
+	} catch {}
+	const isDocs = url.searchParams.get("isDocs") === "true" || routeParam.includes("docs");
+	return renderDefaultOg({
+		title: title || brand,
+		description,
+		brand,
+		badge,
+		date,
+		background: isDocs ? docsBg : defaultBg,
+		preview: url.searchParams.get("preview") === "1"
+	});
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/sitemap-index.xml.d.mts

@@ -0,0 +1,4 @@
+import { APIRoute } from "astro";
+//#region src/routes/sitemap-index.xml.d.ts
+export declare const GET: APIRoute;
+//#endregion

package/dist/routes/sitemap-index.xml.mjs

@@ -0,0 +1,16 @@
+import { buildSitemapIndexXml } from "../sitemap.mjs";
+import seoOptions from "virtual:rimelight-seo/options";
+import * as siteConfigMod from "virtual:rimelight-seo/site-config";
+//#region src/routes/sitemap-index.xml.ts
+const GET = ({ site, url }) => {
+	const siteUrl = site ? site.toString() : siteConfigMod.siteConfig?.url || url.origin;
+	const sitemapOpts = typeof seoOptions?.sitemap === "object" ? seoOptions.sitemap : {};
+	const sitemapPattern = typeof sitemapOpts.path === "string" ? sitemapOpts.path : "/sitemap.xml";
+	const xml = buildSitemapIndexXml([new URL(sitemapPattern, siteUrl).toString()]);
+	return new Response(xml, { headers: {
+		"Content-Type": "application/xml; charset=utf-8",
+		"Cache-Control": "public, max-age=3600, stale-while-revalidate=86400"
+	} });
+};
+//#endregion
+export { GET };

package/dist/types.d.mts

@@ -493,6 +493,47 @@ export interface AssetRouteOptions {
   ogImage?: boolean;
 }
 export interface RimelightSeoOptions {
+  /**
+   * Site identifier / domain (e.g. "rimelight.com")
+   */
+  id?: string;
+  /**
+   * Primary site name (e.g. "Rimelight")
+   */
+  name?: string;
+  /**
+   * Default site description
+   */
+  description?: string;
+  /**
+   * Canonical origin URL (e.g. "https://rimelight.com")
+   */
+  url?: string;
+  ogImage?: string;
+  author?: string;
+  email?: string;
+  branding?: Partial<SiteConfig["branding"]>;
+  titleTemplate?: string;
+  maxDescriptionLength?: number;
+  authorHandle?: string;
+  openGraph?: OpenGraphMeta;
+  twitter?: TwitterMeta;
+  /**
+   * Full or partial SiteConfig object
+   */
+  site?: Partial<SiteConfig>;
+  /**
+   * Locale mappings for hreflang / sitemaps
+   */
+  locales?: LocaleConfig | Record<string, string>;
+  /**
+   * Path prefixes to exclude from sitemap and indexing
+   */
+  privatePathPrefixes?: string[];
+  /**
+   * Custom SEO entry generator function
+   */
+  entries?: () => Promise<SeoEntry[]> | SeoEntry[];
   /**
    * Sitemap configuration or false to disable automatic /sitemap.xml (default: true)
    */
@@ -532,6 +573,40 @@ export interface RimelightSeoOptions {
    * icons) from a single master icon (default: true)
    */
   assets?: boolean | AssetRouteOptions;
+  /**
+   * Open Graph image route configuration, or false to disable automatic /open-graph/[...route].png
+   * (default: true). When enabled, the route reads brand/background from seo.name and injects a
+   * handler that supports query-param overrides and optional DB slug lookup.
+   */
+  og?: boolean | OgRouteOptions;
+}
+/**
+ * Configuration for the auto-injected /open-graph/[...route].png route.
+ */
+export interface OgRouteOptions {
+  /**
+   * Route pattern for the OG image handler.
+   *
+   * @default "/open-graph/[...route].png"
+   */
+  path?: string;
+  /**
+   * Brand name shown top-left of every OG image. Defaults to seo.name / site.name from integration
+   * config.
+   */
+  brand?: string;
+  /**
+   * Background style used for standard pages.
+   *
+   * @default "dark"
+   */
+  defaultBackground?: "dark" | "gradient" | (string & {});
+  /**
+   * Background style used when ?isDocs=true or the route segment contains "docs".
+   *
+   * @default "gradient"
+   */
+  docsBackground?: "dark" | "gradient" | (string & {});
 }
 //#endregion
 export type { ArticleSchemaOptions, BreadcrumbItem, LlmsFullTxtOptions, LlmsPage, LlmsTxtOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimelight/seo",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "private": false,
   "description": "Rimelight Entertainment's SEO Package",
   "homepage": "https://rimelight.com/docs",
@@ -72,14 +72,9 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "vp pack",
-    "prepack": "pnpm run build",
-    "check": "vp check --fix && astro check"
-  },
   "devDependencies": {
-    "@rimelight/config": "workspace:*",
-    "astro": "7.3.2",
+    "@rimelight/config": "0.0.12",
+    "astro": "7.3.3",
     "sharp": "^0.35.4",
     "typescript": "6.0.3"
   },
@@ -97,7 +92,10 @@
     }
   },
   "engines": {
-    "node": ">=26.8.2"
+    "node": ">=26.9.0"
   },
-  "packageManager": "pnpm@12.4.1"
-}
+  "scripts": {
+    "build": "vp pack",
+    "check": "vp check --fix && astro check"
+  }
+}

package/src/env.d.ts

@@ -1,55 +1,66 @@
-declare module "virtual:rimelight-seo-config" {
-  const config: import("./integration.js").RimelightSeoOptions
-  export default config
-}
-
-declare module "virtual:rimelight-seo/options" {
-  const config: import("./integration.js").RimelightSeoOptions
-  export default config
-}
-
-declare module "virtual:rimelight-seo/config" {
-  export const SEO_LOCALES: import("./types.js").LocaleConfig | undefined
-  export const PRIVATE_PATH_PREFIXES: string[] | undefined
-  export const seoEntries: (() => Promise<import("./types.js").SeoEntry[]>) | undefined
-  export const rssEntries: (() => Promise<import("./types.js").RssItem[]>) | undefined
-}
-
-declare module "virtual:rimelight-seo/site-config" {
-  export const siteConfig: import("./types.js").SiteConfig | Record<string, any>
-}
-
-declare module "virtual:rimelight-seo/db" {
-  export const db: any
-  export const pages: any
-}
-
-declare module "virtual:rimelight-seo/corpus" {
-  export const corpusPages: any[]
-}
-
-declare module "#db/schema" {
-  export const pages: any
-}
-
-declare module "drizzle-orm" {
-  export const and: (...args: any[]) => any
-  export const isNull: (column: any) => any
-  export const isNotNull: (column: any) => any
-  export const sql: any
-  export const eq: (column: any, value: any) => any
-}
-
-declare module "@rimelight/cms" {
-  export const renderCorpusMarkdown: (db: any, options: any) => Promise<string>
-}
-
-declare module "astro:content" {
-  export const getCollection: (collection: string) => Promise<any[]>
-}
-
-declare module "virtual:rimelight-seo/assets" {
-  export const masterIconBuffer: Buffer | null
-  export const isSvg: boolean
-  export const backgroundColor: string
-}
+declare module "virtual:rimelight/seo" {
+  export const siteConfig: import("./types.js").SiteConfig
+  export const SEO_LOCALES: import("./types.js").LocaleConfig | Record<string, string> | undefined
+  export const PRIVATE_PATH_PREFIXES: string[]
+  export const seoConfig: {
+    SEO_LOCALES?: import("./types.js").LocaleConfig | Record<string, string>
+    PRIVATE_PATH_PREFIXES: string[]
+  }
+  export default siteConfig
+}
+
+declare module "virtual:rimelight-seo-config" {
+  const config: import("./integration.js").RimelightSeoOptions
+  export default config
+}
+
+declare module "virtual:rimelight-seo/options" {
+  const config: import("./integration.js").RimelightSeoOptions
+  export default config
+}
+
+declare module "virtual:rimelight-seo/config" {
+  export const SEO_LOCALES: import("./types.js").LocaleConfig | undefined
+  export const PRIVATE_PATH_PREFIXES: string[] | undefined
+  export const seoEntries: (() => Promise<import("./types.js").SeoEntry[]>) | undefined
+  export const rssEntries: (() => Promise<import("./types.js").RssItem[]>) | undefined
+}
+
+declare module "virtual:rimelight-seo/site-config" {
+  export const siteConfig: import("./types.js").SiteConfig | Record<string, any>
+}
+
+declare module "virtual:rimelight-seo/db" {
+  export const db: any
+  export const pages: any
+}
+
+declare module "virtual:rimelight-seo/corpus" {
+  export const corpusPages: any[]
+}
+
+declare module "#db/schema" {
+  export const pages: any
+}
+
+declare module "drizzle-orm" {
+  export const and: (...args: any[]) => any
+  export const isNull: (column: any) => any
+  export const isNotNull: (column: any) => any
+  export const sql: any
+  export const eq: (column: any, value: any) => any
+}
+
+declare module "@rimelight/cms" {
+  export const renderCorpusMarkdown: (db: any, options: any) => Promise<string>
+}
+
+declare module "astro:content" {
+  export const getCollection: (collection: string) => Promise<any[]>
+}
+
+declare module "virtual:rimelight-seo/assets" {
+  export const masterIconBuffer: Buffer | null
+  export const isSvg: boolean
+  export const backgroundColor: string
+}

package/src/index.ts

@@ -66,6 +66,7 @@ export { buildApiCatalog } from "./catalog.js"
 export { buildArticleSchema, buildBreadcrumbSchema } from "./schema.js"
 export { generatePng, generateMaskablePng, generateIco, generateOgCard } from "./assets.js"
 export type { OgFontConfig, OgLayoutOptions, OgRenderConfig } from "./og.js"
+export type { OgRouteOptions } from "./types.js"
 
 import { rimelightSeo } from "./integration.js"
 export type { RimelightSeoOptions } from "./integration.js"

package/src/integration.ts

@@ -23,27 +23,57 @@ export function rimelightSeo(options: RimelightSeoOptions = {}): AstroIntegratio
           return null
         }
 
-        const seoConfigPath = findFile([
-          "src/config/seo.config.ts",
-          "src/config/seo.config.js",
-          "src/config/seo.config.mjs"
-        ])
-
-        const hasConfigExport = (name: string): boolean => {
-          if (!seoConfigPath) return false
-          const content = fs.readFileSync(seoConfigPath, "utf8")
-          return (
-            new RegExp(
-              `export\\s+(?:const|let|var|async\\s+function|function|class)\\s+${name}\\b`
-            ).test(content) || new RegExp(`export\\s*\\{[^}]*\\b${name}\\b}`).test(content)
-          )
+        const siteOpt = options.site || {}
+        const normalizedSiteConfig = {
+          id: siteOpt.id || options.id || "",
+          name: siteOpt.name || options.name || "",
+          description: siteOpt.description || options.description || "",
+          url: siteOpt.url || options.url || "",
+          ogImage: siteOpt.ogImage || options.ogImage || undefined,
+          author: siteOpt.author || options.author || siteOpt.name || options.name || "",
+          email: siteOpt.email || options.email || "",
+          branding: {
+            logo: {
+              alt:
+                siteOpt.branding?.logo?.alt ||
+                options.branding?.logo?.alt ||
+                siteOpt.name ||
+                options.name ||
+                ""
+            },
+            colors: {
+              themeColor:
+                siteOpt.branding?.colors?.themeColor ||
+                options.branding?.colors?.themeColor ||
+                "#ffffff",
+              backgroundColor:
+                siteOpt.branding?.colors?.backgroundColor ||
+                options.branding?.colors?.backgroundColor ||
+                "#ffffff"
+            },
+            ...siteOpt.branding,
+            ...options.branding
+          },
+          seo: {
+            titleTemplate:
+              siteOpt.seo?.titleTemplate ||
+              options.titleTemplate ||
+              (options.name ? `%s | ${options.name}` : "%s"),
+            maxDescriptionLength:
+              siteOpt.seo?.maxDescriptionLength || options.maxDescriptionLength || 160,
+            authorHandle: siteOpt.seo?.authorHandle || options.authorHandle || undefined,
+            ...siteOpt.seo
+          },
+          ...(siteOpt.openGraph || options.openGraph
+            ? { openGraph: siteOpt.openGraph || options.openGraph }
+            : {}),
+          ...(siteOpt.twitter || options.twitter
+            ? { twitter: siteOpt.twitter || options.twitter }
+            : {})
         }
 
-        const siteConfigPath = findFile([
-          "src/config/site.config.ts",
-          "src/config/site.config.js",
-          "src/config/site.config.mjs"
-        ])
+        const seoLocales = options.locales
+        const privatePathPrefixes = options.privatePathPrefixes || []
 
         const dbPath = findFile(["src/db/index.ts", "src/db/index.js", "src/db/index.mjs"])
 
@@ -100,6 +130,10 @@ export function rimelightSeo(options: RimelightSeoOptions = {}): AstroIntegratio
             pattern,
             entrypoint: "@rimelight/seo/routes/sitemap.xml.ts"
           })
+          injectRoute({
+            pattern: "/sitemap-index.xml",
+            entrypoint: "@rimelight/seo/routes/sitemap-index.xml.ts"
+          })
         }
 
         if (options.rss !== false) {
@@ -173,6 +207,17 @@ export function rimelightSeo(options: RimelightSeoOptions = {}): AstroIntegratio
           })
         }
 
+        if (options.og !== false) {
+          const pattern =
+            typeof options.og === "object" && options.og.path
+              ? options.og.path
+              : "/open-graph/[...route].png"
+          injectRoute({
+            pattern,
+            entrypoint: "@rimelight/seo/routes/open-graph.[...route].png.ts"
+          })
+        }
+
         updateConfig({
           vite: {
             plugins: [
@@ -298,6 +343,9 @@ export function rimelightSeo(options: RimelightSeoOptions = {}): AstroIntegratio
                   ) {
                     return "\0virtual:rimelight-seo/options"
                   }
+                  if (id === "virtual:rimelight/seo") {
+                    return "\0virtual:rimelight/seo"
+                  }
                   if (id === "virtual:rimelight-seo/config") {
                     return "\0virtual:rimelight-seo/config"
                   }
@@ -316,27 +364,26 @@ export function rimelightSeo(options: RimelightSeoOptions = {}): AstroIntegratio
                   if (id === "\0virtual:rimelight-seo/options") {
                     return `export default ${JSON.stringify(options)};`
                   }
+                  if (id === "\0virtual:rimelight/seo") {
+                    return `export const siteConfig = ${JSON.stringify(normalizedSiteConfig)};
+export const SEO_LOCALES = ${JSON.stringify(seoLocales)};
+export const PRIVATE_PATH_PREFIXES = ${JSON.stringify(privatePathPrefixes)};
+export const seoConfig = {
+  SEO_LOCALES: ${JSON.stringify(seoLocales)},
+  PRIVATE_PATH_PREFIXES: ${JSON.stringify(privatePathPrefixes)}
+};
+export default siteConfig;`
+                  }
                   if (id === "\0virtual:rimelight-seo/config") {
-                    if (seoConfigPath) {
-                      const seoEntriesExport = hasConfigExport("seoEntries")
-                      const rssEntriesExport = hasConfigExport("rssEntries")
-                      return `import * as customConfig from ${JSON.stringify(seoConfigPath)};
-export const SEO_LOCALES = customConfig.SEO_LOCALES;
-export const PRIVATE_PATH_PREFIXES = customConfig.PRIVATE_PATH_PREFIXES || [];
-export const seoEntries = ${seoEntriesExport ? "customConfig.seoEntries" : "undefined"};
-export const rssEntries = ${rssEntriesExport ? "customConfig.rssEntries" : "undefined"};
-export default customConfig;`
-                    }
-                    return `export const SEO_LOCALES = undefined;
-export const PRIVATE_PATH_PREFIXES = [];
+                    return `export const SEO_LOCALES = ${JSON.stringify(seoLocales)};
+export const PRIVATE_PATH_PREFIXES = ${JSON.stringify(privatePathPrefixes)};
 export const seoEntries = async () => [];
-export const rssEntries = undefined;`
+export const rssEntries = undefined;
+export default { SEO_LOCALES: ${JSON.stringify(seoLocales)}, PRIVATE_PATH_PREFIXES: ${JSON.stringify(privatePathPrefixes)} };`
                   }
                   if (id === "\0virtual:rimelight-seo/site-config") {
-                    if (siteConfigPath) {
-                      return `export * from ${JSON.stringify(siteConfigPath)};`
-                    }
-                    return `export const siteConfig = { name: "Site", description: "", url: "" };`
+                    return `export const siteConfig = ${JSON.stringify(normalizedSiteConfig)};
+export default siteConfig;`
                   }
                   if (id === "\0virtual:rimelight-seo/db") {
                     if (dbPath) {

package/src/routes/open-graph.[...route].png.ts

@@ -0,0 +1,81 @@
+import type { APIRoute } from "astro"
+import { renderDefaultOg } from "../og.js"
+import * as siteConfigMod from "virtual:rimelight-seo/site-config"
+import * as dbMod from "virtual:rimelight-seo/db"
+import seoOptions from "virtual:rimelight-seo/options"
+
+export const prerender = false
+
+function getLocalizedText(val: unknown, locale = "en"): string {
+  if (typeof val === "object" && val !== null) {
+    const record = val as Record<string, string>
+    return record[locale] || Object.values(record)[0] || ""
+  }
+  if (typeof val === "string") return val
+  if (typeof val === "number" || typeof val === "boolean") return String(val)
+  return ""
+}
+
+export const GET: APIRoute = async ({ request }) => {
+  const url = new URL(request.url)
+  const routeParam = url.pathname.replace(/^\/open-graph\//, "").replace(/\.png$/, "")
+
+  const siteConfig = siteConfigMod.siteConfig || {}
+  const ogOpts = typeof seoOptions?.og === "object" ? seoOptions.og : {}
+
+  // Brand: explicit og.brand > seo.name > site.name > hostname
+  const brand = ogOpts.brand || (seoOptions as any)?.name || siteConfig.name || url.hostname
+
+  const defaultBg = ogOpts.defaultBackground ?? "dark"
+  const docsBg = ogOpts.docsBackground ?? "gradient"
+
+  let title = url.searchParams.get("title") || ""
+  let description = url.searchParams.get("description") || ""
+  let date = url.searchParams.get("pubDate") || ""
+  const badge =
+    url.searchParams.get("type") ||
+    (routeParam.includes("blog") ? "Blog Post" : routeParam.includes("legal") ? "Legal" : "")
+
+  // DB slug lookup -- same pattern as llms.txt.ts, gracefully skipped when db is absent
+  if (!title && routeParam && routeParam !== "page" && routeParam !== "default" && dbMod.db) {
+    try {
+      const { pages: pagesTable } = await import("#db/schema").catch(() => ({ pages: null }))
+      const { eq, and, isNull } = await import("drizzle-orm")
+
+      if (pagesTable) {
+        const slug = routeParam.split("/").pop() ?? ""
+        const page = await dbMod.db
+          .select({
+            title: pagesTable.title,
+            description: pagesTable.description,
+            postedAt: pagesTable.postedAt
+          })
+          .from(pagesTable)
+          .where(and(eq(pagesTable.slug, slug), isNull(pagesTable.deletedAt)))
+          .limit(1)
+          .then((r: any[]) => r[0])
+          .catch(() => undefined)
+
+        if (page) {
+          title = getLocalizedText(page.title)
+          description = description || getLocalizedText(page.description)
+          if (page.postedAt && !date) date = new Date(page.postedAt).toLocaleDateString()
+        }
+      }
+    } catch {
+      // DB unavailable -- fall through to query-param values
+    }
+  }
+
+  const isDocs = url.searchParams.get("isDocs") === "true" || routeParam.includes("docs")
+
+  return renderDefaultOg({
+    title: title || brand,
+    description,
+    brand,
+    badge,
+    date,
+    background: isDocs ? docsBg : defaultBg,
+    preview: url.searchParams.get("preview") === "1"
+  })
+}

package/src/routes/sitemap-index.xml.ts

@@ -0,0 +1,20 @@
+import type { APIRoute } from "astro"
+import { buildSitemapIndexXml } from "../sitemap.js"
+import * as siteConfigMod from "virtual:rimelight-seo/site-config"
+import seoOptions from "virtual:rimelight-seo/options"
+
+export const GET: APIRoute = ({ site, url }) => {
+  const siteUrl = site ? site.toString() : siteConfigMod.siteConfig?.url || url.origin
+
+  const sitemapOpts = typeof seoOptions?.sitemap === "object" ? seoOptions.sitemap : {}
+  const sitemapPattern = typeof sitemapOpts.path === "string" ? sitemapOpts.path : "/sitemap.xml"
+
+  const xml = buildSitemapIndexXml([new URL(sitemapPattern, siteUrl).toString()])
+
+  return new Response(xml, {
+    headers: {
+      "Content-Type": "application/xml; charset=utf-8",
+      "Cache-Control": "public, max-age=3600, stale-while-revalidate=86400"
+    }
+  })
+}

package/src/types.ts

@@ -519,6 +519,47 @@ export interface AssetRouteOptions {
 }
 
 export interface RimelightSeoOptions {
+  /**
+   * Site identifier / domain (e.g. "rimelight.com")
+   */
+  id?: string
+  /**
+   * Primary site name (e.g. "Rimelight")
+   */
+  name?: string
+  /**
+   * Default site description
+   */
+  description?: string
+  /**
+   * Canonical origin URL (e.g. "https://rimelight.com")
+   */
+  url?: string
+  ogImage?: string
+  author?: string
+  email?: string
+  branding?: Partial<SiteConfig["branding"]>
+  titleTemplate?: string
+  maxDescriptionLength?: number
+  authorHandle?: string
+  openGraph?: OpenGraphMeta
+  twitter?: TwitterMeta
+  /**
+   * Full or partial SiteConfig object
+   */
+  site?: Partial<SiteConfig>
+  /**
+   * Locale mappings for hreflang / sitemaps
+   */
+  locales?: LocaleConfig | Record<string, string>
+  /**
+   * Path prefixes to exclude from sitemap and indexing
+   */
+  privatePathPrefixes?: string[]
+  /**
+   * Custom SEO entry generator function
+   */
+  entries?: () => Promise<SeoEntry[]> | SeoEntry[]
   /**
    * Sitemap configuration or false to disable automatic /sitemap.xml (default: true)
    */
@@ -558,6 +599,41 @@ export interface RimelightSeoOptions {
    * icons) from a single master icon (default: true)
    */
   assets?: boolean | AssetRouteOptions
+  /**
+   * Open Graph image route configuration, or false to disable automatic /open-graph/[...route].png
+   * (default: true). When enabled, the route reads brand/background from seo.name and injects a
+   * handler that supports query-param overrides and optional DB slug lookup.
+   */
+  og?: boolean | OgRouteOptions
+}
+
+/**
+ * Configuration for the auto-injected /open-graph/[...route].png route.
+ */
+export interface OgRouteOptions {
+  /**
+   * Route pattern for the OG image handler.
+   *
+   * @default "/open-graph/[...route].png"
+   */
+  path?: string
+  /**
+   * Brand name shown top-left of every OG image. Defaults to seo.name / site.name from integration
+   * config.
+   */
+  brand?: string
+  /**
+   * Background style used for standard pages.
+   *
+   * @default "dark"
+   */
+  defaultBackground?: "dark" | "gradient" | (string & {})
+  /**
+   * Background style used when ?isDocs=true or the route segment contains "docs".
+   *
+   * @default "gradient"
+   */
+  docsBackground?: "dark" | "gradient" | (string & {})
 }
 
 export type { LlmsPage, LlmsTxtOptions, LlmsFullTxtOptions } from "./llms.js"