@bagelink/blox 1.12.22 → 1.13.1

package/dist/{prerender-6jE_obPj.cjs → prerender-DN7Ugbtc.cjs}

@@ -25,18 +25,43 @@ const fs = require("node:fs/promises");
 const path = require("node:path");
 const process = require("node:process");
 const node_url = require("node:url");
-async function fetchCmsPrerenderPaths(apiBase, websiteName) {
+async function fetchCmsSiteData(apiBase, websiteName) {
   const sitesRes = await fetch(`${apiBase}/cms/websites`);
   const sitesData = await sitesRes.json();
   const sites = Array.isArray(sitesData) ? sitesData : sitesData.data ?? [];
   const site = sites.find((s) => s.name === websiteName);
   if ((site == null ? void 0 : site.id) == null || site.id === "") throw new Error(`Website "${websiteName}" not found at ${apiBase}`);
-  const pagesRes = await fetch(`${apiBase}/cms/websites/${site.id}/pages?locale=en`);
+  let website = site;
+  try {
+    const wRes = await fetch(`${apiBase}/cms/websites/${site.id}`);
+    if (wRes.ok) website = await wRes.json();
+  } catch {
+  }
+  const pagesRes = await fetch(`${apiBase}/cms/websites/${site.id}/pages?locale=${website.default_locale || "en"}`);
   const pagesData = await pagesRes.json();
   const pages = Array.isArray(pagesData) ? pagesData : pagesData.data ?? [];
+  const paths = await expandRoutes(apiBase, pages);
+  let redirects = [];
+  try {
+    const rRes = await fetch(`${apiBase}/cms/websites/${site.id}/redirects`);
+    if (rRes.ok) {
+      const rData = await rRes.json();
+      const items = Array.isArray(rData) ? rData : rData.data ?? [];
+      redirects = items.filter((r) => r.from_path && r.to_path);
+    }
+  } catch {
+  }
+  return { websiteId: site.id, website, paths, redirects };
+}
+async function fetchCmsPrerenderPaths(apiBase, websiteName) {
+  const { paths } = await fetchCmsSiteData(apiBase, websiteName);
+  return paths;
+}
+async function expandRoutes(apiBase, pages) {
   const routes = [];
   for (const page of pages) {
     const slug = page.slug ?? "/";
+    if (page.status && page.status !== "published") continue;
     if (slug.includes(":") && page.data_bindings) {
       for (const [, binding] of Object.entries(page.data_bindings)) {
         const b = binding;
@@ -50,7 +75,10 @@ async function fetchCmsPrerenderPaths(apiBase, websiteName) {
             for (const item of items) {
               const bindValue = item[b.bind_by];
               if (bindValue != null && bindValue !== "") {
-                const concrete = slug.replace(/:([a-z_]+)/g, (_m, p) => p === b.bind_by ? String(bindValue) : String(item[p] ?? ""));
+                const concrete = slug.replace(
+                  /:([a-z_]+)/g,
+                  (_m, p) => p === b.bind_by ? String(bindValue) : String(item[p] ?? "")
+                );
                 routes.push(concrete);
               }
             }
@@ -109,6 +137,150 @@ async function polyfillBloxSsgGlobals(options) {
   g.window.location = _win.location;
   g.window.document = _win.document;
 }
+function buildPageHead(options) {
+  const { url, resolvedData, website, stateScript } = options;
+  const parts = [];
+  const meta = (website == null ? void 0 : website.meta) ?? {};
+  const page = resolvedData == null ? void 0 : resolvedData.page;
+  const ctx = extractPrimaryContext(resolvedData == null ? void 0 : resolvedData.contexts);
+  const title = (page == null ? void 0 : page.meta_title) || ctx.title || ((page == null ? void 0 : page.title) && meta.og_site_name ? `${page.title} · ${meta.og_site_name}` : null) || (page == null ? void 0 : page.title) || meta.default_meta_title;
+  if (title) {
+    const fullTitle = ctx.title && meta.og_site_name && !ctx.title.includes(meta.og_site_name) ? `${esc(ctx.title)} · ${esc(meta.og_site_name)}` : esc(title);
+    parts.push(`<title>${fullTitle}</title>`);
+  }
+  const description = (page == null ? void 0 : page.meta_description) || ctx.description || meta.default_meta_description;
+  if (description) {
+    parts.push(`<meta name="description" content="${esc(description)}">`);
+  }
+  const canonicalBase = (meta.canonical_base_url || (website == null ? void 0 : website.domain) || "").replace(/\/$/, "");
+  if (canonicalBase) {
+    parts.push(`<link rel="canonical" href="${esc(canonicalBase + url)}">`);
+  }
+  const ogTitle = (page == null ? void 0 : page.meta_title) || ctx.title || (page == null ? void 0 : page.title) || meta.og_site_name || meta.default_meta_title;
+  const ogDesc = (page == null ? void 0 : page.meta_description) || ctx.description || meta.og_description || meta.default_meta_description;
+  const ogImage = (page == null ? void 0 : page.og_image) || ctx.image || meta.default_og_image;
+  const ogType = meta.og_type || "website";
+  if (ogTitle) parts.push(`<meta property="og:title" content="${esc(ogTitle)}">`);
+  if (ogDesc) parts.push(`<meta property="og:description" content="${esc(ogDesc)}">`);
+  if (ogImage) parts.push(`<meta property="og:image" content="${esc(ogImage)}">`);
+  parts.push(`<meta property="og:type" content="${esc(ogType)}">`);
+  if (canonicalBase) parts.push(`<meta property="og:url" content="${esc(canonicalBase + url)}">`);
+  if (meta.og_site_name) parts.push(`<meta property="og:site_name" content="${esc(meta.og_site_name)}">`);
+  const twitterCard = meta.twitter_card || (ogImage ? "summary_large_image" : "summary");
+  parts.push(`<meta name="twitter:card" content="${esc(twitterCard)}">`);
+  if (ogTitle) parts.push(`<meta name="twitter:title" content="${esc(ogTitle)}">`);
+  if (ogDesc) parts.push(`<meta name="twitter:description" content="${esc(ogDesc)}">`);
+  if (ogImage) parts.push(`<meta name="twitter:image" content="${esc(ogImage)}">`);
+  if (meta.twitter_site) parts.push(`<meta name="twitter:site" content="${esc(meta.twitter_site)}">`);
+  const alternates = resolvedData == null ? void 0 : resolvedData.alternates;
+  if (alternates && canonicalBase) {
+    for (const [locale, slug] of Object.entries(alternates)) {
+      parts.push(`<link rel="alternate" hreflang="${esc(locale)}" href="${esc(canonicalBase + slug)}">`);
+    }
+    const defaultSlug = alternates[(website == null ? void 0 : website.default_locale) ?? "en"] ?? url;
+    parts.push(`<link rel="alternate" hreflang="x-default" href="${esc(canonicalBase + defaultSlug)}">`);
+  }
+  if (meta.noindex) {
+    parts.push('<meta name="robots" content="noindex, nofollow">');
+  }
+  if (stateScript) {
+    parts.push(stateScript);
+  }
+  return parts.join("\n");
+}
+function buildSiteHead(website) {
+  if (!website) return "";
+  const parts = [];
+  const meta = website.meta ?? {};
+  if (website.favicon_url) {
+    parts.push(`<link rel="icon" href="${esc(website.favicon_url)}">`);
+  }
+  if (meta.webclip) {
+    parts.push(`<link rel="apple-touch-icon" sizes="180x180" href="${esc(meta.webclip)}">`);
+  }
+  if (meta.verification_google) {
+    parts.push(`<meta name="google-site-verification" content="${esc(meta.verification_google)}">`);
+  }
+  if (meta.verification_bing) {
+    parts.push(`<meta name="msvalidate.01" content="${esc(meta.verification_bing)}">`);
+  }
+  if (meta.structured_data_org) {
+    try {
+      const json = typeof meta.structured_data_org === "string" ? meta.structured_data_org : JSON.stringify(meta.structured_data_org);
+      parts.push(`<script type="application/ld+json">${json}${"<"}/script>`);
+    } catch {
+    }
+  }
+  const plausibleId = website.plausible_site_id;
+  if (plausibleId) {
+    parts.push(`<script defer data-domain="${esc(plausibleId)}" src="https://plausible.io/js/script.js"><${"/"}script>`);
+  }
+  return parts.join("\n");
+}
+function generateSitemapXml(options) {
+  const { renderedPaths, canonicalBase, defaultChangefreq = "weekly", defaultPriority = "0.7" } = options;
+  const base = canonicalBase.replace(/\/$/, "");
+  const urls = renderedPaths.map((p) => {
+    const priority = p === "/" ? "1.0" : defaultPriority;
+    const changefreq = p === "/" ? "daily" : defaultChangefreq;
+    return `  <url>
+    <loc>${esc(base + p)}</loc>
+    <changefreq>${changefreq}</changefreq>
+    <priority>${priority}</priority>
+  </url>`;
+  });
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls.join("\n")}
+</urlset>
+`;
+}
+function generateRobotsTxt(options) {
+  const { robotsTxt, canonicalBase, noindex } = options;
+  if (noindex) {
+    return `User-agent: *
+Disallow: /
+`;
+  }
+  const base = (canonicalBase || "").replace(/\/$/, "");
+  const sitemapLine = base ? `
+Sitemap: ${base}/sitemap.xml
+` : "";
+  if (robotsTxt) {
+    if (sitemapLine && !robotsTxt.toLowerCase().includes("sitemap:")) {
+      return robotsTxt.trimEnd() + "\n" + sitemapLine;
+    }
+    return robotsTxt;
+  }
+  return `User-agent: *
+Allow: /
+${sitemapLine}`;
+}
+function generateNetlifyRedirects(redirects) {
+  if (redirects.length === 0) return "";
+  return redirects.map((r) => `${r.from_path}  ${r.to_path}  ${r.status_code}`).join("\n") + "\n";
+}
+function stripTemplateSeoTags(template) {
+  return template.replace(/<title>[^<]*<\/title>/gi, "<!--ssg:title-->").replace(/<meta\s[^>]*name\s*=\s*["']description["'][^>]*>/gi, "").replace(/<meta\s[^>]*property\s*=\s*["']og:[^"']*["'][^>]*>/gi, "").replace(/<meta\s[^>]*(?:property|name)\s*=\s*["']twitter:[^"']*["'][^>]*>/gi, "").replace(/<link\s[^>]*rel\s*=\s*["']apple-touch-icon["'][^>]*>/gi, "").replace(/<link\s[^>]*rel\s*=\s*["']icon["'][^>]*>/gi, "").replace(/\n\s*\n\s*\n/g, "\n\n");
+}
+function extractPrimaryContext(contexts) {
+  const empty = { title: null, description: null, image: null };
+  if (!contexts || typeof contexts !== "object") return empty;
+  const ctx = Object.values(contexts).find((c) => c != null);
+  if (!ctx) return empty;
+  const str = (key) => {
+    const v = ctx[key];
+    return typeof v === "string" && v.trim() ? v.trim() : null;
+  };
+  return {
+    title: str("meta_title") || str("title"),
+    description: str("meta_description") || str("excerpt") || str("description") || str("blurb") || str("summary"),
+    image: str("og_image") || str("cover_image_url") || str("image_url") || str("image")
+  };
+}
+function esc(s) {
+  return s.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
 async function prerender({
   root = process.cwd(),
   clientOutDir = "dist/client",
@@ -118,13 +290,21 @@ async function prerender({
   excludePaths = [],
   failFast = false,
   maxPages = 5e3,
-  mode = "dir"
+  mode = "dir",
+  website = null,
+  redirects = []
 } = {}) {
   const absRoot = path.resolve(root);
   const absClient = path.resolve(absRoot, clientOutDir);
   const absServerEntry = path.resolve(absRoot, serverEntry);
   const templatePath = path.join(absClient, "index.html");
-  const template = await fs.readFile(templatePath, "utf8");
+  const rawTemplate = await fs.readFile(templatePath, "utf8");
+  let template = stripTemplateSeoTags(rawTemplate);
+  const siteHead = buildSiteHead(website);
+  if (siteHead) {
+    template = template.replace("</head>", `${siteHead}
+</head>`);
+  }
   const serverMod = await import(node_url.pathToFileURL(absServerEntry).href);
   if (typeof serverMod.render !== "function") {
     throw new TypeError(
@@ -153,7 +333,8 @@ async function prerender({
     try {
       const { html, head = "", htmlAttrs = "" } = await serverMod.render(urlPath, {
         manifest,
-        template
+        template,
+        website
       });
       const outHtml = injectIntoTemplate(template, head, html, fontPreloads, htmlAttrs);
       const outfile = outFilePath(absClient, urlPath, mode);
@@ -171,6 +352,31 @@ async function prerender({
 `, err.stack ?? err);
     }
   }
+  const websiteMeta = (website == null ? void 0 : website.meta) ?? {};
+  const canonicalBase = (websiteMeta.canonical_base_url || (website == null ? void 0 : website.domain) || "").replace(/\/$/, "");
+  if (canonicalBase && rendered.length > 0) {
+    const sitemap = generateSitemapXml({ renderedPaths: rendered, canonicalBase });
+    await fs.writeFile(path.join(absClient, "sitemap.xml"), sitemap, "utf8");
+    console.log(`  Generated sitemap.xml (${rendered.length} URLs)`);
+  }
+  const robotsTxt = generateRobotsTxt({
+    robotsTxt: website == null ? void 0 : website.robots_txt,
+    canonicalBase,
+    noindex: websiteMeta.noindex
+  });
+  await fs.writeFile(path.join(absClient, "robots.txt"), robotsTxt, "utf8");
+  console.log("  Generated robots.txt");
+  if (redirects.length > 0) {
+    const redirectsContent = generateNetlifyRedirects(redirects);
+    const redirectsPath = path.join(absClient, "_redirects");
+    let existing = "";
+    try {
+      existing = await fs.readFile(redirectsPath, "utf8");
+    } catch {
+    }
+    await fs.writeFile(redirectsPath, redirectsContent + existing, "utf8");
+    console.log(`  Generated _redirects (${redirects.length} rules)`);
+  }
   return {
     rendered,
     failures,
@@ -256,6 +462,9 @@ function injectIntoTemplate(template, head, appHtml, fontPreloads, htmlAttrs = "
 </head>`);
   }
   if (head) {
+    if (/<title>/.test(head)) {
+      out = out.replace("<!--ssg:title-->", "");
+    }
     const descTagRe = /<meta\s[^>]*name\s*=\s*["']description["'][^>]*>/gi;
     const descMatches = [...head.matchAll(descTagRe)];
     if (descMatches.length > 1) {
@@ -298,6 +507,12 @@ function discoverInternalLinks(html) {
   }
   return [...out];
 }
+exports.buildPageHead = buildPageHead;
+exports.buildSiteHead = buildSiteHead;
 exports.fetchCmsPrerenderPaths = fetchCmsPrerenderPaths;
+exports.fetchCmsSiteData = fetchCmsSiteData;
+exports.generateNetlifyRedirects = generateNetlifyRedirects;
+exports.generateRobotsTxt = generateRobotsTxt;
+exports.generateSitemapXml = generateSitemapXml;
 exports.polyfillBloxSsgGlobals = polyfillBloxSsgGlobals;
 exports.prerender = prerender;

package/dist/ssg/cli.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 "use strict";
 const process = require("node:process");
-const prerender = require("../prerender-6jE_obPj.cjs");
+const prerender = require("../prerender-DN7Ugbtc.cjs");
 async function resolveApiBase(mode) {
   if (process.env.BAGELINK_API_URL != null && process.env.BAGELINK_API_URL !== "") {
     return { apiBase: process.env.BAGELINK_API_URL };
@@ -72,11 +72,17 @@ Environment:
   const websiteName = process.env.WEBSITE_NAME ?? configWebsiteName ?? "default";
   console.log(`Fetching routes from ${apiBase} (mode: ${mode}, site: ${websiteName})…`);
   let paths = [];
+  let website = null;
+  let redirects = [];
   try {
-    paths = await prerender.fetchCmsPrerenderPaths(apiBase, websiteName);
+    const siteData = await prerender.fetchCmsSiteData(apiBase, websiteName);
+    paths = siteData.paths;
+    website = siteData.website;
+    redirects = siteData.redirects;
     console.log(`  Found ${paths.length} CMS routes`);
+    if (redirects.length > 0) console.log(`  Found ${redirects.length} redirects`);
   } catch (err) {
-    console.error("  Failed to fetch CMS routes:", err.message);
+    console.error("  Failed to fetch CMS data:", err.message);
     paths = ["/"];
   }
   for (const p of extraPaths) {
@@ -92,7 +98,9 @@ Environment:
       crawl,
       excludePaths,
       maxPages: 5e3,
-      mode: "file"
+      mode: "file",
+      website,
+      redirects
     });
     const elapsed = ((Date.now() - startTime) / 1e3).toFixed(2);
     console.log(`

package/dist/ssg/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 import process from "node:process";
-import { p as polyfillBloxSsgGlobals, f as fetchCmsPrerenderPaths, a as prerender } from "../prerender-DYmDaqcz.js";
+import { p as polyfillBloxSsgGlobals, a as fetchCmsSiteData, c as prerender } from "../prerender-BXf1VF7r.js";
 async function resolveApiBase(mode) {
   if (process.env.BAGELINK_API_URL != null && process.env.BAGELINK_API_URL !== "") {
     return { apiBase: process.env.BAGELINK_API_URL };
@@ -71,11 +71,17 @@ Environment:
   const websiteName = process.env.WEBSITE_NAME ?? configWebsiteName ?? "default";
   console.log(`Fetching routes from ${apiBase} (mode: ${mode}, site: ${websiteName})…`);
   let paths = [];
+  let website = null;
+  let redirects = [];
   try {
-    paths = await fetchCmsPrerenderPaths(apiBase, websiteName);
+    const siteData = await fetchCmsSiteData(apiBase, websiteName);
+    paths = siteData.paths;
+    website = siteData.website;
+    redirects = siteData.redirects;
     console.log(`  Found ${paths.length} CMS routes`);
+    if (redirects.length > 0) console.log(`  Found ${redirects.length} redirects`);
   } catch (err) {
-    console.error("  Failed to fetch CMS routes:", err.message);
+    console.error("  Failed to fetch CMS data:", err.message);
     paths = ["/"];
   }
   for (const p of extraPaths) {
@@ -91,7 +97,9 @@ Environment:
       crawl,
       excludePaths,
       maxPages: 5e3,
-      mode: "file"
+      mode: "file",
+      website,
+      redirects
     });
     const elapsed = ((Date.now() - startTime) / 1e3).toFixed(2);
     console.log(`

package/dist/ssg/cms-routes.d.ts

@@ -1,8 +1,18 @@
+import { WebsiteRead } from '../api/types';
+import { RedirectEntry } from './seo';
+export interface CmsSiteData {
+    websiteId: string;
+    website: WebsiteRead;
+    paths: string[];
+    redirects: RedirectEntry[];
+}
 /**
- * Collect prerender paths from the Bagelink CMS.
- *
- * Static slugs are returned as-is. Template pages (e.g. `/blog/:slug`) are
- * expanded into concrete paths using their `data_bindings` + the datastore.
+ * Fetch everything the SSG needs from the CMS in one go:
+ * website settings, page routes, and redirects.
+ */
+export declare function fetchCmsSiteData(apiBase: string, websiteName: string): Promise<CmsSiteData>;
+/**
+ * Legacy compat: fetch only prerender paths (no website/redirect data).
  */
 export declare function fetchCmsPrerenderPaths(apiBase: string, websiteName: string): Promise<string[]>;
 //# sourceMappingURL=cms-routes.d.ts.map

package/dist/ssg/cms-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cms-routes.d.ts","sourceRoot":"","sources":["../../src/ssg/cms-routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAqDnB"}
+{"version":3,"file":"cms-routes.d.ts","sourceRoot":"","sources":["../../src/ssg/cms-routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAY1C,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,WAAW,CAAA;IACpB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,EAAE,aAAa,EAAE,CAAA;CAC1B;AAMD;;;GAGG;AACH,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,CAAC,CAqCtB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAGnB"}

package/dist/ssg/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const prerender = require("../prerender-6jE_obPj.cjs");
+const prerender = require("../prerender-DN7Ugbtc.cjs");
 const constants = require("../constants-fZvybj0k.cjs");
 const ssg_client = require("./client.cjs");
 async function renderBloxSsgPage(options) {
@@ -9,7 +9,8 @@ async function renderBloxSsgPage(options) {
     resolvedData,
     renderToString,
     createAppForUrl,
-    stateWindowKey = constants.BLOX_STATE_WINDOW_KEY
+    stateWindowKey = constants.BLOX_STATE_WINDOW_KEY,
+    website = null
   } = options;
   const g = globalThis;
   const prevState = g[stateWindowKey];
@@ -21,8 +22,16 @@ async function renderBloxSsgPage(options) {
     await router.push(url);
     await router.isReady();
     const html = await renderToString(app);
-    const head = resolvedData != null ? `<script>window[${JSON.stringify(stateWindowKey)}]=${JSON.stringify({ [url]: resolvedData })};${"<"}/script>` : "";
-    return { html, head };
+    const stateScript = resolvedData != null ? `<script>window[${JSON.stringify(stateWindowKey)}]=${JSON.stringify({ [url]: resolvedData })};${"<"}/script>` : "";
+    const head = prerender.buildPageHead({
+      url,
+      resolvedData,
+      website,
+      stateScript
+    });
+    const lang = (website == null ? void 0 : website.default_locale) || "en";
+    const htmlAttrs = `lang="${lang}"`;
+    return { html, head, htmlAttrs };
   } finally {
     if (prevState !== void 0) {
       g[stateWindowKey] = prevState;
@@ -31,7 +40,13 @@ async function renderBloxSsgPage(options) {
     }
   }
 }
+exports.buildPageHead = prerender.buildPageHead;
+exports.buildSiteHead = prerender.buildSiteHead;
 exports.fetchCmsPrerenderPaths = prerender.fetchCmsPrerenderPaths;
+exports.fetchCmsSiteData = prerender.fetchCmsSiteData;
+exports.generateNetlifyRedirects = prerender.generateNetlifyRedirects;
+exports.generateRobotsTxt = prerender.generateRobotsTxt;
+exports.generateSitemapXml = prerender.generateSitemapXml;
 exports.polyfillBloxSsgGlobals = prerender.polyfillBloxSsgGlobals;
 exports.prerender = prerender.prerender;
 exports.BLOX_STATE_WINDOW_KEY = constants.BLOX_STATE_WINDOW_KEY;

package/dist/ssg/index.d.ts

@@ -1,13 +1,15 @@
-export { fetchCmsPrerenderPaths } from './cms-routes';
+export { fetchCmsPrerenderPaths, fetchCmsSiteData } from './cms-routes';
+export type { CmsSiteData } from './cms-routes';
 /**
  * @bagelink/blox/ssg — Static Site Generation helpers for Blox CMS sites.
  *
  * Provides everything needed to prerender a Vue + Blox app at build time:
  * - Browser global polyfills for Node.js
  * - CMS route discovery (including template page expansion via data_bindings)
- * - Double-render page renderer with state embedding
+ * - Page renderer with state embedding and full SEO head
  * - Client-side fetch interceptor for zero-API-call hydration
  * - Full prerender orchestrator with crawl support
+ * - SEO asset generation (sitemap.xml, robots.txt, _redirects)
  */
 export { BLOX_STATE_WINDOW_KEY } from './constants';
 export { polyfillBloxSsgGlobals } from './polyfill-node';
@@ -15,5 +17,7 @@ export { prerender } from './prerender';
 export type { PrerenderOptions, PrerenderResult, RenderContext, RenderResult } from './prerender';
 export { renderBloxSsgPage } from './render-resolved-page';
 export type { BloxSsgRouterLike } from './render-resolved-page';
+export { buildPageHead, buildSiteHead, generateNetlifyRedirects, generateRobotsTxt, generateSitemapXml } from './seo';
+export type { RedirectEntry, SeoPageData, WebsiteMeta } from './seo';
 export { installBloxStateCache } from './state-cache';
 //# sourceMappingURL=index.d.ts.map

package/dist/ssg/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ssg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD;;;;;;;;;GASG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ssg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACvE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C;;;;;;;;;;GAUG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAA;AACrH,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA"}

package/dist/ssg/index.mjs

@@ -1,4 +1,5 @@
-import { f, p, a } from "../prerender-DYmDaqcz.js";
+import { b as buildPageHead } from "../prerender-BXf1VF7r.js";
+import { d, f, a, g, e, h, p, c } from "../prerender-BXf1VF7r.js";
 import { B as BLOX_STATE_WINDOW_KEY } from "../constants-BIbQhd3z.js";
 import { installBloxStateCache } from "./client.mjs";
 async function renderBloxSsgPage(options) {
@@ -7,33 +8,48 @@ async function renderBloxSsgPage(options) {
     resolvedData,
     renderToString,
     createAppForUrl,
-    stateWindowKey = BLOX_STATE_WINDOW_KEY
+    stateWindowKey = BLOX_STATE_WINDOW_KEY,
+    website = null
   } = options;
-  const g = globalThis;
-  const prevState = g[stateWindowKey];
+  const g2 = globalThis;
+  const prevState = g2[stateWindowKey];
   if (resolvedData != null) {
-    g[stateWindowKey] = { [url]: resolvedData };
+    g2[stateWindowKey] = { [url]: resolvedData };
   }
   try {
     const { app, router } = createAppForUrl(url);
     await router.push(url);
     await router.isReady();
     const html = await renderToString(app);
-    const head = resolvedData != null ? `<script>window[${JSON.stringify(stateWindowKey)}]=${JSON.stringify({ [url]: resolvedData })};${"<"}/script>` : "";
-    return { html, head };
+    const stateScript = resolvedData != null ? `<script>window[${JSON.stringify(stateWindowKey)}]=${JSON.stringify({ [url]: resolvedData })};${"<"}/script>` : "";
+    const head = buildPageHead({
+      url,
+      resolvedData,
+      website,
+      stateScript
+    });
+    const lang = (website == null ? void 0 : website.default_locale) || "en";
+    const htmlAttrs = `lang="${lang}"`;
+    return { html, head, htmlAttrs };
   } finally {
     if (prevState !== void 0) {
-      g[stateWindowKey] = prevState;
+      g2[stateWindowKey] = prevState;
     } else {
-      delete g[stateWindowKey];
+      delete g2[stateWindowKey];
     }
   }
 }
 export {
   BLOX_STATE_WINDOW_KEY,
+  buildPageHead,
+  d as buildSiteHead,
   f as fetchCmsPrerenderPaths,
+  a as fetchCmsSiteData,
+  g as generateNetlifyRedirects,
+  e as generateRobotsTxt,
+  h as generateSitemapXml,
   installBloxStateCache,
   p as polyfillBloxSsgGlobals,
-  a as prerender,
+  c as prerender,
   renderBloxSsgPage
 };

package/dist/ssg/prerender.d.ts

@@ -1,3 +1,5 @@
+import { WebsiteRead } from '../api/types';
+import { RedirectEntry } from './seo';
 type ExcludeRule = string | RegExp | ((path: string) => boolean);
 export interface PrerenderOptions {
     root?: string;
@@ -9,10 +11,16 @@ export interface PrerenderOptions {
     failFast?: boolean;
     maxPages?: number;
     mode?: 'dir' | 'file';
+    /** Website settings for SEO injection. */
+    website?: WebsiteRead | null;
+    /** Redirects to write as _redirects (Netlify). */
+    redirects?: RedirectEntry[];
 }
 export interface RenderContext {
     manifest: Record<string, string[]> | null;
     template: string;
+    /** Website settings passed through to the render function. */
+    website?: WebsiteRead | null;
 }
 export interface RenderResult {
     html: string;
@@ -38,7 +46,9 @@ export interface PrerenderResult {
  * - "crawl" (default true) discovers internal links in rendered HTML and queues them.
  * - excludePaths can be strings, RegExp, or a predicate function.
  * - Route-level failures are logged and skipped by default.
+ * - Generates sitemap.xml, robots.txt, and _redirects post-render.
+ * - Strips hardcoded SEO tags from template and injects per-page equivalents.
  */
-export declare function prerender({ root, clientOutDir, serverEntry, paths, crawl, excludePaths, failFast, maxPages, mode, }?: PrerenderOptions): Promise<PrerenderResult>;
+export declare function prerender({ root, clientOutDir, serverEntry, paths, crawl, excludePaths, failFast, maxPages, mode, website, redirects, }?: PrerenderOptions): Promise<PrerenderResult>;
 export {};
 //# sourceMappingURL=prerender.d.ts.map

package/dist/ssg/prerender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prerender.d.ts","sourceRoot":"","sources":["../../src/ssg/prerender.ts"],"names":[],"mappings":"AAKA,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAA;AAEhE,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,YAAY,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAA;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAA;IACzC,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAMD,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC7D,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,EAC/B,IAAoB,EACpB,YAA4B,EAC5B,WAA0C,EAC1C,KAAU,EACV,KAAY,EACZ,YAAiB,EACjB,QAAgB,EAChB,QAAe,EACf,IAAY,GACZ,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA6ElD"}
+{"version":3,"file":"prerender.d.ts","sourceRoot":"","sources":["../../src/ssg/prerender.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAS1C,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAA;AAEhE,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,YAAY,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAA;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACrB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAC5B,kDAAkD;IAClD,SAAS,CAAC,EAAE,aAAa,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAA;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAMD,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC7D,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,EAC/B,IAAoB,EACpB,YAA4B,EAC5B,WAA0C,EAC1C,KAAU,EACV,KAAY,EACZ,YAAiB,EACjB,QAAgB,EAChB,QAAe,EACf,IAAY,EACZ,OAAc,EACd,SAAc,GACd,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0HlD"}

package/dist/ssg/render-resolved-page.d.ts

@@ -1,16 +1,19 @@
+import { WebsiteRead } from '../api/types';
 export interface BloxSsgRouterLike {
     push: (url: string) => Promise<void>;
     isReady: () => Promise<void>;
 }
 /**
- * Render a Blox CMS page to static HTML with embedded state.
+ * Render a Blox CMS page to static HTML with embedded state and full SEO head.
  *
  * Sets `globalThis.__BLOX_STATE__` *before* rendering so that
  * `CmsPageView` can hydrate synchronously from the embedded data
  * instead of waiting for an async fetch.
  *
- * Returns `{ html, head }` where `head` contains a `<script>` that sets
- * `window.__BLOX_STATE__` for zero-API-call client hydration.
+ * Returns `{ html, head, htmlAttrs }` where:
+ * - `head` contains per-page `<title>`, meta tags, OG, canonical, hreflang,
+ *   plus the `<script>` that sets `window.__BLOX_STATE__`
+ * - `htmlAttrs` contains the `lang` attribute
  */
 export declare function renderBloxSsgPage<TApp>(options: {
     url: string;
@@ -21,8 +24,11 @@ export declare function renderBloxSsgPage<TApp>(options: {
         router: BloxSsgRouterLike;
     };
     stateWindowKey?: string;
+    /** Website settings for SEO tags. If omitted, only state script is emitted. */
+    website?: WebsiteRead | null;
 }): Promise<{
     html: string;
     head?: string;
+    htmlAttrs?: string;
 }>;
 //# sourceMappingURL=render-resolved-page.d.ts.map

package/dist/ssg/render-resolved-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-resolved-page.d.ts","sourceRoot":"","sources":["../../src/ssg/render-resolved-page.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE;IACtD,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,cAAc,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9C,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QAAE,GAAG,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,iBAAiB,CAAA;KAAE,CAAA;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAqC3C"}
+{"version":3,"file":"render-resolved-page.d.ts","sourceRoot":"","sources":["../../src/ssg/render-resolved-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAK/C,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE;IACtD,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,cAAc,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9C,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QAAE,GAAG,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,iBAAiB,CAAA;KAAE,CAAA;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;CAC5B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkD/D"}