@bagelink/blox 1.15.531 → 1.15.533

package/dist/{shard-runner-JAI_Tb4S.js → shard-runner-DFZAHrwJ.js}

@@ -2,7 +2,7 @@ import { spawn } from "node:child_process";
 import os from "node:os";
 import path from "node:path";
 import process from "node:process";
-import { f as fetchCmsSiteData, s as splitSitemapPathsByLocale, l as localeSitemapPath, g as generateSitemapXml, b as generateSitemapIndexXml } from "./prerender-VtzdjvzI.js";
+import { f as fetchCmsSiteData, s as splitSitemapPathsByLocale, l as localeSitemapPath, g as generateSitemapXml, b as generateSitemapIndexXml } from "./validate-output-C-RpYkvf.js";
 const AUTO_SHARD_CAP = Number(process.env.BLOX_SSG_SHARD_CAP) || 6;
 const PREFETCH_BUDGET = Number(process.env.BLOX_SSG_PREFETCH_BUDGET) || 24;
 function resolveShardCount(shards) {
@@ -109,7 +109,7 @@ async function runSharded(opts) {
   }
   if (process.env.BLOX_SSG_LLM !== "0") {
     try {
-      const { mergeLlmParts } = await import("./prerender-VtzdjvzI.js").then((n) => n.y);
+      const { mergeLlmParts } = await import("./validate-output-C-RpYkvf.js").then((n) => n.z);
       const mergeWebsite = website;
       const partFiles = Array.from({ length: total }, (_, i) => path.join(llmPartsDir, `part.${i}.json`));
       const { pages } = await mergeLlmParts({

package/dist/{shard-runner-Bn4JyeQC.cjs → shard-runner-DTkniXr1.cjs}

@@ -26,7 +26,7 @@ const node_child_process = require("node:child_process");
 const os = require("node:os");
 const path = require("node:path");
 const process = require("node:process");
-const llmArtifacts = require("./prerender-Dc2Zl2PC.cjs");
+const llmArtifacts = require("./validate-output-C3NhyFsU.cjs");
 const AUTO_SHARD_CAP = Number(process.env.BLOX_SSG_SHARD_CAP) || 6;
 const PREFETCH_BUDGET = Number(process.env.BLOX_SSG_PREFETCH_BUDGET) || 24;
 function resolveShardCount(shards) {
@@ -133,7 +133,7 @@ async function runSharded(opts) {
   }
   if (process.env.BLOX_SSG_LLM !== "0") {
     try {
-      const { mergeLlmParts } = await Promise.resolve().then(() => require("./prerender-Dc2Zl2PC.cjs")).then((n) => n.llmArtifacts);
+      const { mergeLlmParts } = await Promise.resolve().then(() => require("./validate-output-C3NhyFsU.cjs")).then((n) => n.llmArtifacts);
       const mergeWebsite = website;
       const partFiles = Array.from({ length: total }, (_, i) => path.join(llmPartsDir, `part.${i}.json`));
       const { pages } = await mergeLlmParts({

package/dist/ssg/cli.cjs

@@ -2,7 +2,7 @@
 "use strict";
 const process = require("node:process");
 const fs = require("node:fs/promises");
-const llmArtifacts = require("../prerender-Dc2Zl2PC.cjs");
+const llmArtifacts = require("../validate-output-C3NhyFsU.cjs");
 function installFetchTimeout() {
   const ms = Number(process.env.BLOX_SSG_FETCH_TIMEOUT_MS) || 2e4;
   const original = globalThis.fetch;
@@ -56,6 +56,7 @@ async function main() {
   let shardsOpt = null;
   let routesCmd = "";
   let siteDataFile = "";
+  let validateOutDir = "";
   const passthroughArgs = [];
   const excludePaths = ["/_blox_preview"];
   for (const a of argv) {
@@ -71,6 +72,10 @@ async function main() {
       routesCmd = a.slice("--routes-cmd=".length);
     } else if (a.startsWith("--site-data=")) {
       siteDataFile = a.slice("--site-data=".length);
+    } else if (a === "--validate") {
+      validateOutDir = "dist";
+    } else if (a.startsWith("--validate=")) {
+      validateOutDir = a.slice("--validate=".length);
     } else if (a.startsWith("--shard=")) {
       const [i, n] = a.slice("--shard=".length).split("/").map(Number);
       if (Number.isInteger(i) && Number.isInteger(n) && n > 0 && i >= 0 && i < n) {
@@ -95,6 +100,7 @@ Options:
   --shard=<i/n>       (internal) Render only this shard's slice — set by --shards.
   --routes-cmd=<cmd>  Shell command whose stdout (whitespace-separated) is the
                       route list. For router-driven sites with no CMS pages.
+  --validate[=dir]    Validate generated SSG assets (default directory: dist).
   --help, -h          Show this help
 
 Environment:
@@ -120,10 +126,15 @@ Environment:
       extraPaths.push(a);
     }
   }
+  if (validateOutDir) {
+    await llmArtifacts.validateSsgOutput({ outDir: validateOutDir });
+    console.log(`[blox-ssg] validated output in ${validateOutDir}`);
+    return;
+  }
   if (shardsOpt !== null || routesCmd) {
     const { apiBase: apiBase2, websiteName: configWebsiteName2 } = await resolveApiBase(mode);
     const websiteName2 = process.env.WEBSITE_NAME ?? configWebsiteName2 ?? "default";
-    const { runSharded } = await Promise.resolve().then(() => require("../shard-runner-Bn4JyeQC.cjs"));
+    const { runSharded } = await Promise.resolve().then(() => require("../shard-runner-DTkniXr1.cjs"));
     const code = await runSharded({
       shards: shardsOpt ?? "auto",
       mode,

package/dist/ssg/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 import process from "node:process";
 import fs from "node:fs/promises";
-import { u as uploadBloxManifest, p as polyfillBloxSsgGlobals, f as fetchCmsSiteData, a as prerender } from "../prerender-VtzdjvzI.js";
+import { v as validateSsgOutput, u as uploadBloxManifest, p as polyfillBloxSsgGlobals, f as fetchCmsSiteData, a as prerender } from "../validate-output-C-RpYkvf.js";
 function installFetchTimeout() {
   const ms = Number(process.env.BLOX_SSG_FETCH_TIMEOUT_MS) || 2e4;
   const original = globalThis.fetch;
@@ -55,6 +55,7 @@ async function main() {
   let shardsOpt = null;
   let routesCmd = "";
   let siteDataFile = "";
+  let validateOutDir = "";
   const passthroughArgs = [];
   const excludePaths = ["/_blox_preview"];
   for (const a of argv) {
@@ -70,6 +71,10 @@ async function main() {
       routesCmd = a.slice("--routes-cmd=".length);
     } else if (a.startsWith("--site-data=")) {
       siteDataFile = a.slice("--site-data=".length);
+    } else if (a === "--validate") {
+      validateOutDir = "dist";
+    } else if (a.startsWith("--validate=")) {
+      validateOutDir = a.slice("--validate=".length);
     } else if (a.startsWith("--shard=")) {
       const [i, n] = a.slice("--shard=".length).split("/").map(Number);
       if (Number.isInteger(i) && Number.isInteger(n) && n > 0 && i >= 0 && i < n) {
@@ -94,6 +99,7 @@ Options:
   --shard=<i/n>       (internal) Render only this shard's slice — set by --shards.
   --routes-cmd=<cmd>  Shell command whose stdout (whitespace-separated) is the
                       route list. For router-driven sites with no CMS pages.
+  --validate[=dir]    Validate generated SSG assets (default directory: dist).
   --help, -h          Show this help
 
 Environment:
@@ -119,10 +125,15 @@ Environment:
       extraPaths.push(a);
     }
   }
+  if (validateOutDir) {
+    await validateSsgOutput({ outDir: validateOutDir });
+    console.log(`[blox-ssg] validated output in ${validateOutDir}`);
+    return;
+  }
   if (shardsOpt !== null || routesCmd) {
     const { apiBase: apiBase2, websiteName: configWebsiteName2 } = await resolveApiBase(mode);
     const websiteName2 = process.env.WEBSITE_NAME ?? configWebsiteName2 ?? "default";
-    const { runSharded } = await import("../shard-runner-JAI_Tb4S.js");
+    const { runSharded } = await import("../shard-runner-DFZAHrwJ.js");
     const code = await runSharded({
       shards: shardsOpt ?? "auto",
       mode,

package/dist/ssg/index.cjs

@@ -22,7 +22,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const llmArtifacts = require("../prerender-Dc2Zl2PC.cjs");
+const llmArtifacts = require("../validate-output-C3NhyFsU.cjs");
 const ssg_client = require("./client.cjs");
 const pinia = require("pinia");
 const vue = require("vue");
@@ -279,6 +279,7 @@ exports.prerender = llmArtifacts.prerender;
 exports.resolveManifestProvenance = llmArtifacts.resolveManifestProvenance;
 exports.splitSitemapPathsByLocale = llmArtifacts.splitSitemapPathsByLocale;
 exports.uploadBloxManifest = llmArtifacts.uploadBloxManifest;
+exports.validateSsgOutput = llmArtifacts.validateSsgOutput;
 exports.BLOX_COLLECTIONS_WINDOW_KEY = ssg_client.BLOX_COLLECTIONS_WINDOW_KEY;
 exports.BLOX_DATA_WINDOW_KEY = ssg_client.BLOX_DATA_WINDOW_KEY;
 exports.BLOX_PAGE_SEO_WINDOW_KEY = ssg_client.BLOX_PAGE_SEO_WINDOW_KEY;

package/dist/ssg/index.d.ts

@@ -29,4 +29,6 @@ export type { LlmArtifactsConfig, LlmPageEntry } from './llm-artifacts';
 export { installBloxStateCache } from './state-cache';
 export { resolveManifestProvenance, uploadBloxManifest } from './manifest-upload';
 export type { ManifestProvenance, ManifestUpload } from './manifest-upload';
+export { validateSsgOutput } from './validate-output';
+export type { ValidateSsgOutputOptions } from './validate-output';
 //# 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,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACvE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AACrH,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AACrG;;;;;;;;;;GAUG;AACH,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAC5J,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,YAAY,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAC/E,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,uBAAuB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,OAAO,CAAA;AAC9M,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACnH,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACjF,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,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,aAAa,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AACrH,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AACrG;;;;;;;;;;GAUG;AACH,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAC5J,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,YAAY,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAC/E,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,uBAAuB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,OAAO,CAAA;AAC9M,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACnH,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACjF,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/ssg/index.mjs

@@ -1,5 +1,5 @@
-import { c as buildPageHead, d as primaryContextEntry, e as buildJsonLd, h as extractPageText, B as BloxBuildResponseError, i as bloxBuildJson } from "../prerender-VtzdjvzI.js";
-import { j, k, m, f, n, o, q, r, b, g, t, v, l, w, p, a, x, s, u } from "../prerender-VtzdjvzI.js";
+import { c as buildPageHead, d as primaryContextEntry, e as buildJsonLd, h as extractPageText, B as BloxBuildResponseError, i as bloxBuildJson } from "../validate-output-C-RpYkvf.js";
+import { j, k, m, f, n, o, q, r, b, g, t, w, l, x, p, a, y, s, u, v } from "../validate-output-C-RpYkvf.js";
 import { BLOX_STATE_WINDOW_KEY, BLOX_WEBSITE_ID_WINDOW_KEY } from "./client.mjs";
 import { BLOX_COLLECTIONS_WINDOW_KEY, BLOX_DATA_WINDOW_KEY, BLOX_PAGE_SEO_WINDOW_KEY, getCollectionCache, getEmbeddedWebsiteId, installBloxStateCache, installCollectionCache } from "./client.mjs";
 import { createPinia } from "pinia";
@@ -258,15 +258,16 @@ export {
   t as getBloxBuildRequestOptions,
   getCollectionCache,
   getEmbeddedWebsiteId,
-  v as getSiteIconFlags,
+  w as getSiteIconFlags,
   installBloxStateCache,
   installCollectionCache,
   l as localeSitemapPath,
-  w as mergeLlmParts,
+  x as mergeLlmParts,
   p as polyfillBloxSsgGlobals,
   a as prerender,
   renderBloxSsgPage,
-  x as resolveManifestProvenance,
+  y as resolveManifestProvenance,
   s as splitSitemapPathsByLocale,
-  u as uploadBloxManifest
+  u as uploadBloxManifest,
+  v as validateSsgOutput
 };

package/dist/ssg/validate-output.d.ts

@@ -0,0 +1,6 @@
+export interface ValidateSsgOutputOptions {
+    outDir: string;
+    requireFiles?: string[];
+}
+export declare function validateSsgOutput(options: ValidateSsgOutputOptions): Promise<void>;
+//# sourceMappingURL=validate-output.d.ts.map

package/dist/ssg/validate-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-output.d.ts","sourceRoot":"","sources":["../../src/ssg/validate-output.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDxF"}

package/dist/{prerender-VtzdjvzI.js → validate-output-C-RpYkvf.js}

@@ -1171,6 +1171,95 @@ function discoverInternalLinks(html) {
   }
   return [...out];
 }
+const sitemapUrl = /<url>\s*<loc>[^<]+<\/loc>/m;
+const sitemapIndexEntry = /<sitemap>\s*<loc>[^<]+<\/loc>/gm;
+const sitemapLoc = /<loc>([^<]+)<\/loc>/;
+const loadingShell = /class=["'][^"']*\bblox-initial-loading\b/;
+const embeddedCmsState = /\b__BLOX_(?:STATE|DATA)__\b/;
+async function validateSsgOutput(options) {
+  const outDir = path.resolve(options.outDir);
+  const failures = [];
+  const requiredFiles = options.requireFiles ?? [
+    "robots.txt",
+    "_redirects",
+    "sitemap.xml",
+    "llms.txt",
+    "llms-full.txt"
+  ];
+  const htmlFiles = await collectHtmlFiles(outDir);
+  let hydratedFiles = 0;
+  for (const file of htmlFiles) {
+    const name = path.relative(outDir, file);
+    const html = await fs.readFile(file, "utf8");
+    if (embeddedCmsState.test(html)) hydratedFiles += 1;
+    if (!/<title>[^<]+<\/title>/i.test(html)) failures.push(`${name}: missing page title`);
+    if (!/<link\s[^>]*rel=["']canonical["'][^>]*>/i.test(html)) {
+      failures.push(`${name}: missing canonical URL`);
+    }
+    if (!/<html[^>]*\slang=["'][^"']+["']/i.test(html)) failures.push(`${name}: missing html lang`);
+    if (loadingShell.test(html) && !embeddedCmsState.test(html)) {
+      failures.push(`${name}: contains only the Blox loading shell`);
+    }
+  }
+  if (!htmlFiles.length) failures.push("output contains no HTML files");
+  if (!hydratedFiles) failures.push("output contains no prerendered Blox hydration state");
+  for (const required of requiredFiles) {
+    try {
+      const content = await fs.readFile(path.join(outDir, required), "utf8");
+      if (required === "robots.txt" && /^Disallow:\s*\/\s*$/im.test(content)) {
+        failures.push("robots.txt blocks the entire site");
+      }
+      if (required === "llms.txt" && !/^- \[[^\]]+\]\([^)]+\)/m.test(content)) {
+        failures.push("llms.txt contains no page links");
+      }
+      if (required === "sitemap.xml") {
+        failures.push(...await validateSitemap(outDir, content));
+      }
+    } catch {
+      failures.push(`missing ${required}`);
+    }
+  }
+  if (failures.length) {
+    throw new Error(`Invalid Blox SSG output:
+${failures.map((item) => `  - ${item}`).join("\n")}`);
+  }
+}
+async function collectHtmlFiles(directory) {
+  const entries = await fs.readdir(directory, { withFileTypes: true });
+  const files = await Promise.all(entries.map(async (entry) => {
+    const child = path.join(directory, entry.name);
+    if (entry.isDirectory() && entry.name !== "server") return collectHtmlFiles(child);
+    return entry.isFile() && entry.name.endsWith(".html") ? [child] : [];
+  }));
+  return files.flat();
+}
+async function validateSitemap(outDir, content) {
+  var _a;
+  if (sitemapUrl.test(content)) return [];
+  const failures = [];
+  const entries = content.match(sitemapIndexEntry) ?? [];
+  if (!entries.length) return ["sitemap.xml contains neither page URLs nor child sitemaps"];
+  let childUrlCount = 0;
+  for (const entry of entries) {
+    const loc = (_a = entry.match(sitemapLoc)) == null ? void 0 : _a[1];
+    if (!loc) continue;
+    const pathname = new URL(loc).pathname.replace(/^\/+/, "");
+    const childPath = path.resolve(outDir, pathname);
+    if (!childPath.startsWith(`${outDir}${path.sep}`)) {
+      failures.push(`child sitemap escapes output directory: ${pathname}`);
+      continue;
+    }
+    try {
+      const child = await fs.readFile(childPath, "utf8");
+      if (!sitemapUrl.test(child)) failures.push(`${pathname} contains no page URLs`);
+      else childUrlCount += (child.match(/<url>/g) ?? []).length;
+    } catch {
+      failures.push(`missing child sitemap ${pathname}`);
+    }
+  }
+  if (!childUrlCount) failures.push("sitemap index child files contain no page URLs");
+  return failures;
+}
 export {
   BloxBuildResponseError as B,
   prerender as a,
@@ -1194,8 +1283,9 @@ export {
   splitSitemapPathsByLocale as s,
   getBloxBuildRequestOptions as t,
   uploadBloxManifest as u,
-  getSiteIconFlags as v,
-  mergeLlmParts as w,
-  resolveManifestProvenance as x,
-  llmArtifacts as y
+  validateSsgOutput as v,
+  getSiteIconFlags as w,
+  mergeLlmParts as x,
+  resolveManifestProvenance as y,
+  llmArtifacts as z
 };

package/dist/{prerender-Dc2Zl2PC.cjs → validate-output-C3NhyFsU.cjs}

@@ -1194,6 +1194,95 @@ function discoverInternalLinks(html) {
   }
   return [...out];
 }
+const sitemapUrl = /<url>\s*<loc>[^<]+<\/loc>/m;
+const sitemapIndexEntry = /<sitemap>\s*<loc>[^<]+<\/loc>/gm;
+const sitemapLoc = /<loc>([^<]+)<\/loc>/;
+const loadingShell = /class=["'][^"']*\bblox-initial-loading\b/;
+const embeddedCmsState = /\b__BLOX_(?:STATE|DATA)__\b/;
+async function validateSsgOutput(options) {
+  const outDir = path.resolve(options.outDir);
+  const failures = [];
+  const requiredFiles = options.requireFiles ?? [
+    "robots.txt",
+    "_redirects",
+    "sitemap.xml",
+    "llms.txt",
+    "llms-full.txt"
+  ];
+  const htmlFiles = await collectHtmlFiles(outDir);
+  let hydratedFiles = 0;
+  for (const file of htmlFiles) {
+    const name = path.relative(outDir, file);
+    const html = await fs.readFile(file, "utf8");
+    if (embeddedCmsState.test(html)) hydratedFiles += 1;
+    if (!/<title>[^<]+<\/title>/i.test(html)) failures.push(`${name}: missing page title`);
+    if (!/<link\s[^>]*rel=["']canonical["'][^>]*>/i.test(html)) {
+      failures.push(`${name}: missing canonical URL`);
+    }
+    if (!/<html[^>]*\slang=["'][^"']+["']/i.test(html)) failures.push(`${name}: missing html lang`);
+    if (loadingShell.test(html) && !embeddedCmsState.test(html)) {
+      failures.push(`${name}: contains only the Blox loading shell`);
+    }
+  }
+  if (!htmlFiles.length) failures.push("output contains no HTML files");
+  if (!hydratedFiles) failures.push("output contains no prerendered Blox hydration state");
+  for (const required of requiredFiles) {
+    try {
+      const content = await fs.readFile(path.join(outDir, required), "utf8");
+      if (required === "robots.txt" && /^Disallow:\s*\/\s*$/im.test(content)) {
+        failures.push("robots.txt blocks the entire site");
+      }
+      if (required === "llms.txt" && !/^- \[[^\]]+\]\([^)]+\)/m.test(content)) {
+        failures.push("llms.txt contains no page links");
+      }
+      if (required === "sitemap.xml") {
+        failures.push(...await validateSitemap(outDir, content));
+      }
+    } catch {
+      failures.push(`missing ${required}`);
+    }
+  }
+  if (failures.length) {
+    throw new Error(`Invalid Blox SSG output:
+${failures.map((item) => `  - ${item}`).join("\n")}`);
+  }
+}
+async function collectHtmlFiles(directory) {
+  const entries = await fs.readdir(directory, { withFileTypes: true });
+  const files = await Promise.all(entries.map(async (entry) => {
+    const child = path.join(directory, entry.name);
+    if (entry.isDirectory() && entry.name !== "server") return collectHtmlFiles(child);
+    return entry.isFile() && entry.name.endsWith(".html") ? [child] : [];
+  }));
+  return files.flat();
+}
+async function validateSitemap(outDir, content) {
+  var _a;
+  if (sitemapUrl.test(content)) return [];
+  const failures = [];
+  const entries = content.match(sitemapIndexEntry) ?? [];
+  if (!entries.length) return ["sitemap.xml contains neither page URLs nor child sitemaps"];
+  let childUrlCount = 0;
+  for (const entry of entries) {
+    const loc = (_a = entry.match(sitemapLoc)) == null ? void 0 : _a[1];
+    if (!loc) continue;
+    const pathname = new URL(loc).pathname.replace(/^\/+/, "");
+    const childPath = path.resolve(outDir, pathname);
+    if (!childPath.startsWith(`${outDir}${path.sep}`)) {
+      failures.push(`child sitemap escapes output directory: ${pathname}`);
+      continue;
+    }
+    try {
+      const child = await fs.readFile(childPath, "utf8");
+      if (!sitemapUrl.test(child)) failures.push(`${pathname} contains no page URLs`);
+      else childUrlCount += (child.match(/<url>/g) ?? []).length;
+    } catch {
+      failures.push(`missing child sitemap ${pathname}`);
+    }
+  }
+  if (!childUrlCount) failures.push("sitemap index child files contain no page URLs");
+  return failures;
+}
 exports.BloxBuildResponseError = BloxBuildResponseError;
 exports.bloxBuildJson = bloxBuildJson;
 exports.bloxBuildRequest = bloxBuildRequest;
@@ -1220,3 +1309,4 @@ exports.primaryContextEntry = primaryContextEntry;
 exports.resolveManifestProvenance = resolveManifestProvenance;
 exports.splitSitemapPathsByLocale = splitSitemapPathsByLocale;
 exports.uploadBloxManifest = uploadBloxManifest;
+exports.validateSsgOutput = validateSsgOutput;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bagelink/blox",
   "type": "module",
-  "version": "1.15.531",
+  "version": "1.15.533",
   "description": "Blox page builder library for drag-and-drop page building and static data management",
   "author": {
     "name": "Bagel Studio",