@rimelight/seo 0.0.6 → 0.0.8

package/src/routes/api-catalog.ts

@@ -0,0 +1,55 @@
+import type { APIRoute } from "astro"
+import { buildApiCatalog } from "../catalog.js"
+import type { ApiCatalogItem } from "../types.js"
+import seoOptions from "virtual:rimelight-seo/options"
+
+export const prerender = false
+
+export const GET: APIRoute = () => {
+  const catalogOpts = typeof seoOptions?.apiCatalog === "object" ? seoOptions.apiCatalog : {}
+
+  const defaultItems: ApiCatalogItem[] = [
+    {
+      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"
+    }
+  })
+}

package/src/routes/apple-touch-icon.png.ts

@@ -0,0 +1,19 @@
+import type { APIRoute } from "astro"
+import { generatePng } from "../assets.js"
+import { masterIconBuffer } from "virtual:rimelight-seo/assets"
+
+export const prerender = true
+
+export const GET: APIRoute = 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"
+    }
+  })
+}

package/src/routes/favicon.ico.ts

@@ -0,0 +1,19 @@
+import type { APIRoute } from "astro"
+import { generateIco } from "../assets.js"
+import { masterIconBuffer } from "virtual:rimelight-seo/assets"
+
+export const prerender = true
+
+export const GET: APIRoute = 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"
+    }
+  })
+}

package/src/routes/favicon.svg.ts

@@ -0,0 +1,17 @@
+import type { APIRoute } from "astro"
+import { masterIconBuffer, isSvg } from "virtual:rimelight-seo/assets"
+
+export const prerender = true
+
+export const GET: APIRoute = 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"
+    }
+  })
+}

package/src/routes/icon-192.png.ts

@@ -0,0 +1,19 @@
+import type { APIRoute } from "astro"
+import { generatePng } from "../assets.js"
+import { masterIconBuffer } from "virtual:rimelight-seo/assets"
+
+export const prerender = true
+
+export const GET: APIRoute = 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"
+    }
+  })
+}

package/src/routes/icon-512.png.ts

@@ -0,0 +1,19 @@
+import type { APIRoute } from "astro"
+import { generatePng } from "../assets.js"
+import { masterIconBuffer } from "virtual:rimelight-seo/assets"
+
+export const prerender = true
+
+export const GET: APIRoute = 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"
+    }
+  })
+}

package/src/routes/icon-maskable-512.png.ts

@@ -0,0 +1,24 @@
+import type { APIRoute } from "astro"
+import { generateMaskablePng } from "../assets.js"
+import { masterIconBuffer, backgroundColor } from "virtual:rimelight-seo/assets"
+
+export const prerender = true
+
+export const GET: APIRoute = async () => {
+  if (!masterIconBuffer) {
+    return new Response(null, { status: 404 })
+  }
+
+  const png = await generateMaskablePng(masterIconBuffer, {
+    size: 512,
+    background: backgroundColor || "#ffffff",
+    paddingRatio: 0.15
+  })
+
+  return new Response(new Uint8Array(png), {
+    headers: {
+      "Content-Type": "image/png",
+      "Cache-Control": "public, max-age=31536000, immutable"
+    }
+  })
+}

package/src/routes/llms-full.txt.ts

@@ -1,77 +1,77 @@
-import type { APIRoute } from "astro"
-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"
-
-export const prerender = false
-
-export const GET: APIRoute = 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."
-
-  // 1. Try corpusPages if available
-  if (Array.isArray(corpusMod.corpusPages) && corpusMod.corpusPages.length > 0) {
-    const sections = new Map<string, string[]>()
-    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"
-      }
-    })
-  }
-
-  // 2. Try CMS renderCorpusMarkdown if db exists
-  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 {
-      // Fallback
-    }
-  }
-
-  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"
-    }
-  })
-}
+import type { APIRoute } from "astro"
+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"
+
+export const prerender = false
+
+export const GET: APIRoute = 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."
+
+  // 1. Try corpusPages if available
+  if (Array.isArray(corpusMod.corpusPages) && corpusMod.corpusPages.length > 0) {
+    const sections = new Map<string, string[]>()
+    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"
+      }
+    })
+  }
+
+  // 2. Try CMS renderCorpusMarkdown if db exists
+  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 {
+      // Fallback
+    }
+  }
+
+  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"
+    }
+  })
+}

package/src/routes/llms.txt.ts

@@ -1,90 +1,93 @@
-import type { APIRoute } from "astro"
-import { buildLlmsTxt, type LlmsPage } from "../llms.js"
-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"
-import seoOptions from "virtual:rimelight-seo/options"
-
-export const prerender = false
-
-export const GET: APIRoute = async ({ site, url }) => {
-  const siteConfig = siteConfigMod.siteConfig || {}
-  const siteUrl = site ? site.toString() : (siteConfig.url || `${url.protocol}//${url.host}`)
-  const llmsOpts = typeof seoOptions?.llms === "object" ? seoOptions.llms : {}
-
-  let pages: LlmsPage[] = []
-
-  if (Array.isArray(llmsOpts.pages) && llmsOpts.pages.length > 0) {
-    pages = llmsOpts.pages
-  } else if (Array.isArray(corpusMod.corpusPages) && corpusMod.corpusPages.length > 0) {
-    pages = corpusMod.corpusPages.map((p: any) => {
-      const slug = p.slug === "index" ? "" : p.slug
-      const pageUrl = `${siteUrl.replace(/\/$/, "")}/${slug}`.replace(/\/+$/, "")
-      return {
-        title: p.title,
-        description: p.description,
-        url: pageUrl,
-        section: p.section ? p.section.toUpperCase() : "GENERAL"
-      }
-    })
-  } else if (dbMod.db) {
-    try {
-      const { pages: pagesTable } = await import("#db/schema").catch(() => ({ pages: null }))
-      const { and, isNotNull, isNull } = await import("drizzle-orm")
-      if (pagesTable) {
-        const docRows = await dbMod.db
-          .select()
-          .from(pagesTable)
-          .where(and(isNull(pagesTable.deletedAt), isNotNull(pagesTable.publishedVersionId)))
-          .catch(() => [])
-
-        const resolveLocalized = (val: unknown): string => {
-          if (typeof val === "string") return val
-          if (typeof val === "object" && val !== null) {
-            const rec = val as Record<string, string>
-            return rec["en"] || Object.values(rec)[0] || ""
-          }
-          return typeof val === "number" ? String(val) : ""
-        }
-
-        pages = docRows.map((p: any) => {
-          const title = resolveLocalized(p.title) || p.slug
-          const description = resolveLocalized(p.description)
-          const slug = p.slug === "index" ? "" : p.slug
-          const pathPrefix = p.type === "doc" ? "docs" : p.type || "docs"
-          const pageUrl = `${siteUrl.replace(/\/$/, "")}/en/${pathPrefix}/${slug}`.replace(/\/+$/, "")
-          const markdownUrl = `${pageUrl}.md`
-
-          return {
-            title,
-            description,
-            url: pageUrl,
-            markdownUrl,
-            section: p.type ? p.type.toUpperCase() : "GENERAL"
-          }
-        })
-      }
-    } catch {
-      // Fallback
-    }
-  }
-
-  const title = llmsOpts.title || siteConfig.name || "Documentation"
-  const description =
-    llmsOpts.description || siteConfig.description || "Documentation index for AI agents."
-
-  const body = buildLlmsTxt({
-    site: siteUrl,
-    title,
-    description,
-    pages,
-    ...llmsOpts
-  })
-
-  return new Response(body, {
-    headers: {
-      "Content-Type": "text/plain; charset=utf-8",
-      "Cache-Control": "public, max-age=3600, s-maxage=86400"
-    }
-  })
-}
+import type { APIRoute } from "astro"
+import { buildLlmsTxt, type LlmsPage } from "../llms.js"
+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"
+import seoOptions from "virtual:rimelight-seo/options"
+
+export const prerender = false
+
+export const GET: APIRoute = async ({ site, url }) => {
+  const siteConfig = siteConfigMod.siteConfig || {}
+  const siteUrl = site ? site.toString() : siteConfig.url || `${url.protocol}//${url.host}`
+  const llmsOpts = typeof seoOptions?.llms === "object" ? seoOptions.llms : {}
+
+  let pages: LlmsPage[] = []
+
+  if (Array.isArray(llmsOpts.pages) && llmsOpts.pages.length > 0) {
+    pages = llmsOpts.pages
+  } else if (Array.isArray(corpusMod.corpusPages) && corpusMod.corpusPages.length > 0) {
+    pages = corpusMod.corpusPages.map((p: any) => {
+      const slug = p.slug === "index" ? "" : p.slug
+      const pageUrl = `${siteUrl.replace(/\/$/, "")}/${slug}`.replace(/\/+$/, "")
+      return {
+        title: p.title,
+        description: p.description,
+        url: pageUrl,
+        section: p.section ? p.section.toUpperCase() : "GENERAL"
+      }
+    })
+  } else if (dbMod.db) {
+    try {
+      const { pages: pagesTable } = await import("#db/schema").catch(() => ({ pages: null }))
+      const { and, isNotNull, isNull } = await import("drizzle-orm")
+      if (pagesTable) {
+        const docRows = await dbMod.db
+          .select()
+          .from(pagesTable)
+          .where(and(isNull(pagesTable.deletedAt), isNotNull(pagesTable.publishedVersionId)))
+          .catch(() => [])
+
+        const resolveLocalized = (val: unknown): string => {
+          if (typeof val === "string") return val
+          if (typeof val === "object" && val !== null) {
+            const rec = val as Record<string, string>
+            return rec["en"] || Object.values(rec)[0] || ""
+          }
+          return typeof val === "number" ? String(val) : ""
+        }
+
+        pages = docRows.map((p: any) => {
+          const title = resolveLocalized(p.title) || p.slug
+          const description = resolveLocalized(p.description)
+          const slug = p.slug === "index" ? "" : p.slug
+          const pathPrefix = p.type === "doc" ? "docs" : p.type || "docs"
+          const pageUrl = `${siteUrl.replace(/\/$/, "")}/en/${pathPrefix}/${slug}`.replace(
+            /\/+$/,
+            ""
+          )
+          const markdownUrl = `${pageUrl}.md`
+
+          return {
+            title,
+            description,
+            url: pageUrl,
+            markdownUrl,
+            section: p.type ? p.type.toUpperCase() : "GENERAL"
+          }
+        })
+      }
+    } catch {
+      // Fallback
+    }
+  }
+
+  const title = llmsOpts.title || siteConfig.name || "Documentation"
+  const description =
+    llmsOpts.description || siteConfig.description || "Documentation index for AI agents."
+
+  const body = buildLlmsTxt({
+    site: siteUrl,
+    title,
+    description,
+    pages,
+    ...llmsOpts
+  })
+
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+      "Cache-Control": "public, max-age=3600, s-maxage=86400"
+    }
+  })
+}

package/src/routes/robots.txt.ts

@@ -1,63 +1,63 @@
-import type { APIRoute } from "astro"
-import { buildRobotsTxt } from "../robots.js"
-import * as seoConfig from "virtual:rimelight-seo/config"
-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 sitemapURL = new URL("sitemap.xml", siteUrl).toString()
-
-  const defaultPrivatePrefixes = [
-    "/dashboard",
-    "/admin",
-    "/cms",
-    "/internal",
-    "/api",
-    "/dev",
-    "/og",
-    "/open-graph",
-    "/auth"
-  ]
-
-  const customPrivatePrefixes = Array.isArray(seoConfig.PRIVATE_PATH_PREFIXES)
-    ? seoConfig.PRIVATE_PATH_PREFIXES
-    : []
-
-  const privatePrefixes = Array.from(new Set([...defaultPrivatePrefixes, ...customPrivatePrefixes]))
-
-  const disallowPatterns = [
-    ...privatePrefixes,
-    ...privatePrefixes.map((p) => `/*${p.startsWith("/") ? p : `/${p}`}/`)
-  ]
-
-  const robotsOpts = typeof seoOptions?.robots === "object" ? seoOptions.robots : {}
-
-  const defaultAgentRules = [
-    {
-      userAgent: "GPTBot",
-      disallow: privatePrefixes.map((p) => `${p.startsWith("/") ? p : `/${p}`}/`),
-      allow: ["/"]
-    },
-    {
-      userAgent: "ClaudeBot",
-      disallow: privatePrefixes.map((p) => `${p.startsWith("/") ? p : `/${p}`}/`),
-      allow: ["/"]
-    }
-  ]
-
-  const robots = buildRobotsTxt({
-    sitemapUrl: sitemapURL,
-    disallow: disallowPatterns,
-    allow: ["/"],
-    userAgentRules: defaultAgentRules,
-    ...robotsOpts
-  })
-
-  return new Response(robots, {
-    headers: {
-      "Content-Type": "text/plain; charset=utf-8",
-      "Cache-Control": "public, max-age=3600, stale-while-revalidate=86400"
-    }
-  })
-}
+import type { APIRoute } from "astro"
+import { buildRobotsTxt } from "../robots.js"
+import * as seoConfig from "virtual:rimelight-seo/config"
+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 sitemapURL = new URL("sitemap.xml", siteUrl).toString()
+
+  const defaultPrivatePrefixes = [
+    "/dashboard",
+    "/admin",
+    "/cms",
+    "/internal",
+    "/api",
+    "/dev",
+    "/og",
+    "/open-graph",
+    "/auth"
+  ]
+
+  const customPrivatePrefixes = Array.isArray(seoConfig.PRIVATE_PATH_PREFIXES)
+    ? seoConfig.PRIVATE_PATH_PREFIXES
+    : []
+
+  const privatePrefixes = Array.from(new Set([...defaultPrivatePrefixes, ...customPrivatePrefixes]))
+
+  const disallowPatterns = [
+    ...privatePrefixes,
+    ...privatePrefixes.map((p) => `/*${p.startsWith("/") ? p : `/${p}`}/`)
+  ]
+
+  const robotsOpts = typeof seoOptions?.robots === "object" ? seoOptions.robots : {}
+
+  const defaultAgentRules = [
+    {
+      userAgent: "GPTBot",
+      disallow: privatePrefixes.map((p) => `${p.startsWith("/") ? p : `/${p}`}/`),
+      allow: ["/"]
+    },
+    {
+      userAgent: "ClaudeBot",
+      disallow: privatePrefixes.map((p) => `${p.startsWith("/") ? p : `/${p}`}/`),
+      allow: ["/"]
+    }
+  ]
+
+  const robots = buildRobotsTxt({
+    sitemapUrl: sitemapURL,
+    disallow: disallowPatterns,
+    allow: ["/"],
+    userAgentRules: defaultAgentRules,
+    ...robotsOpts
+  })
+
+  return new Response(robots, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+      "Cache-Control": "public, max-age=3600, stale-while-revalidate=86400"
+    }
+  })
+}