@duffcloudservices/cms 0.6.0 → 0.8.0

package/dist/plugins/index.js

@@ -1,8 +1,8 @@
-import { buildHeadTags, spliceHeadHtml, loadPagesManifest } from '../chunk-JJK7OGC2.js';
-export { buildVitePressSeoHead, createSeoTransformPageData, defaultRelativePathToRoute } from '../chunk-JJK7OGC2.js';
+import { buildSitemapXml, isHandAuthoredRobotsAcceptable, buildRobotsTxt, buildLlmsTxt, matchesExcludedGlob, breadcrumbTrailFromRoute, findReviewItemsForPage, buildHeadTags, spliceHeadHtml, loadPagesManifest } from '../chunk-UPAMLKOQ.js';
+export { buildVitePressSeoHead, createSeoTransformPageData, defaultRelativePathToRoute } from '../chunk-UPAMLKOQ.js';
 import fs2 from 'fs';
 import path2 from 'path';
-import yaml from 'js-yaml';
+import yaml2 from 'js-yaml';
 import { defineComponent, h } from 'vue';
 
 function dcsContentPlugin(options = {}) {
@@ -41,7 +41,7 @@ function dcsContentPlugin(options = {}) {
       }
       try {
         const fileContent = fs2.readFileSync(foundPath, "utf8");
-        const content = yaml.load(fileContent);
+        const content = yaml2.load(fileContent);
         if (debug) {
           console.log(`[dcs-content] Loaded ${foundPath}`);
           console.log(`[dcs-content] Version: ${content.version}`);
@@ -112,33 +112,207 @@ function loadSeoConfig(projectRoot, seoPath, debug) {
   }
   try {
     const fileContent = fs2.readFileSync(foundPath, "utf8");
-    const config = yaml.load(fileContent);
+    const config = yaml2.load(fileContent);
     return { config, foundPath };
   } catch (error) {
     console.warn("[dcs-seo] Failed to parse seo.yaml:", error);
     return null;
   }
 }
+function loadContentConfig(projectRoot, contentRelPath, debug) {
+  const possiblePaths = [
+    path2.resolve(projectRoot, contentRelPath),
+    path2.resolve(projectRoot, "..", contentRelPath),
+    path2.resolve(process.cwd(), contentRelPath)
+  ];
+  const foundPath = possiblePaths.find((p) => fs2.existsSync(p));
+  if (!foundPath) {
+    if (debug) console.log(`[dcs-seo] No content.yaml found (reviews disabled)`);
+    return void 0;
+  }
+  try {
+    const parsed = yaml2.load(fs2.readFileSync(foundPath, "utf8"));
+    if (!parsed || typeof parsed !== "object") return void 0;
+    return parsed;
+  } catch (error) {
+    console.warn("[dcs-seo] Failed to parse content.yaml (reviews disabled):", error);
+    return void 0;
+  }
+}
 function routeToOutputFile(outDir, routePath) {
   const trimmed = routePath.replace(/^\/+/, "").replace(/\/+$/, "");
   if (trimmed === "") return path2.join(outDir, "index.html");
   return path2.join(outDir, ...trimmed.split("/"), "index.html");
 }
+function loadExcludedGlobs(projectRoot, pagesPath) {
+  const possiblePaths = [
+    path2.resolve(projectRoot, pagesPath),
+    path2.resolve(projectRoot, "..", pagesPath),
+    path2.resolve(process.cwd(), pagesPath)
+  ];
+  const found = possiblePaths.find((p) => fs2.existsSync(p));
+  if (!found) return [];
+  try {
+    const raw = yaml2.load(fs2.readFileSync(found, "utf8"));
+    const excluded = raw?.excluded;
+    if (!Array.isArray(excluded)) return [];
+    return excluded.filter((e) => typeof e === "string");
+  } catch {
+    return [];
+  }
+}
+function deriveLastmod(seoConfig, projectRoot, pagesPath) {
+  const fromSeo = seoConfig?.lastUpdated;
+  if (typeof fromSeo === "string" && fromSeo.length > 0) return fromSeo;
+  const possiblePaths = [
+    path2.resolve(projectRoot, pagesPath),
+    path2.resolve(projectRoot, "..", pagesPath),
+    path2.resolve(process.cwd(), pagesPath)
+  ];
+  const found = possiblePaths.find((p) => fs2.existsSync(p));
+  if (!found) return void 0;
+  try {
+    const raw = yaml2.load(fs2.readFileSync(found, "utf8"));
+    const fromPages = raw?.lastUpdated;
+    if (typeof fromPages === "string" && fromPages.length > 0) return fromPages;
+  } catch {
+  }
+  return void 0;
+}
+function emitSiteFiles(params) {
+  const {
+    outDir,
+    projectRoot,
+    pagesPath,
+    routes,
+    seoConfig,
+    siteUrl,
+    exclude = [],
+    noindex = [],
+    preview = false,
+    robots = {},
+    llms = true,
+    debug = false
+  } = params;
+  const written = [];
+  const effectiveSiteUrl = siteUrl || seoConfig?.global?.siteUrl;
+  const excludedGlobs = loadExcludedGlobs(projectRoot, pagesPath);
+  const lastmod = deriveLastmod(seoConfig, projectRoot, pagesPath);
+  let wroteSitemap = false;
+  if (!preview) {
+    const xml = buildSitemapXml({
+      routes,
+      siteUrl: effectiveSiteUrl,
+      seoConfig,
+      exclude,
+      noindex,
+      excludedGlobs,
+      lastmod
+    });
+    if (xml) {
+      fs2.writeFileSync(path2.join(outDir, "sitemap.xml"), xml, "utf8");
+      wroteSitemap = true;
+      written.push("sitemap.xml");
+      if (debug) console.log("[dcs-seo] wrote sitemap.xml");
+    } else if (debug) {
+      console.log("[dcs-seo] no absolute <loc> derivable; sitemap.xml not written");
+    }
+  }
+  if (robots.enabled ?? true) {
+    const robotsPath = path2.join(outDir, "robots.txt");
+    const existing = fs2.existsSync(robotsPath) && !robots.force ? fs2.readFileSync(robotsPath, "utf8") : null;
+    const keepHandAuthored = existing !== null && isHandAuthoredRobotsAcceptable(existing);
+    if (keepHandAuthored) {
+      if (debug)
+        console.log("[dcs-seo] dist/robots.txt is hand-authored and meets the floor; leaving it");
+    } else {
+      const txt = buildRobotsTxt({
+        siteUrl: effectiveSiteUrl,
+        preview,
+        robots,
+        hasSitemap: wroteSitemap
+      });
+      fs2.writeFileSync(robotsPath, txt, "utf8");
+      written.push("robots.txt");
+      if (debug) {
+        console.log(
+          existing !== null ? "[dcs-seo] dist/robots.txt failed the factory floor; overwrote with emitted robots" : "[dcs-seo] wrote robots.txt"
+        );
+      }
+    }
+  }
+  if (llms && !preview) {
+    const txt = buildLlmsTxt({
+      routes,
+      siteUrl: effectiveSiteUrl,
+      seoConfig,
+      exclude,
+      noindex,
+      excludedGlobs
+    });
+    if (txt) {
+      fs2.writeFileSync(path2.join(outDir, "llms.txt"), txt, "utf8");
+      written.push("llms.txt");
+      if (debug) console.log("[dcs-seo] wrote llms.txt");
+    } else if (debug) {
+      console.log("[dcs-seo] nothing indexable; llms.txt not written");
+    }
+  }
+  return written;
+}
+function pickPageFaq(content, pageSlug) {
+  if (!content) return void 0;
+  const fromBlock = (block) => {
+    if (!block) return void 0;
+    const v = block["faq"];
+    return Array.isArray(v) ? v : void 0;
+  };
+  return fromBlock(content.pages?.[pageSlug]) ?? fromBlock(content.global);
+}
 function emitStaticSeoHtml(params) {
-  const { outDir, shellHtml, routes, seoConfig, exclude = [], noindex = [], debug = false } = params;
+  const {
+    outDir,
+    shellHtml,
+    routes,
+    seoConfig,
+    contentConfig,
+    exclude = [],
+    noindex = [],
+    excludedGlobs = [],
+    debug = false
+  } = params;
   const excludeSet = new Set(exclude);
   const noindexSet = new Set(noindex);
+  const siteUrl = seoConfig?.global?.siteUrl ?? "";
+  const routeTitles = { "/": "Home" };
+  for (const r of routes) {
+    if (r.title && r.path) routeTitles[r.path.replace(/\/+$/, "") || "/"] = r.title;
+  }
   let written = 0;
   for (const route of routes) {
     if (excludeSet.has(route.path) || route.slug && excludeSet.has(route.slug)) {
       if (debug) console.log(`[dcs-seo] skip (excluded): ${route.path}`);
       continue;
     }
+    if (matchesExcludedGlob(route.path, excludedGlobs)) {
+      if (debug) console.log(`[dcs-seo] skip (excluded glob): ${route.path}`);
+      continue;
+    }
     const forceNoindex = noindexSet.has(route.path) || route.slug && noindexSet.has(route.slug);
+    const breadcrumbTrail = siteUrl ? breadcrumbTrailFromRoute(route.path, siteUrl, routeTitles) : void 0;
+    const reviews = contentConfig ? findReviewItemsForPage(contentConfig, route.slug) : void 0;
+    const isBlogPost = /^\/blog\/.+/.test(route.path) && !!route.title;
+    const blogMeta = isBlogPost ? { headline: route.title, url: breadcrumbTrail?.[breadcrumbTrail.length - 1]?.item } : void 0;
+    const faq = pickPageFaq(contentConfig, route.slug);
     const tags = buildHeadTags(route.slug, route.path, seoConfig, {
       includeKeywords: true,
       fallbackTitle: route.title,
-      robots: forceNoindex ? "noindex, nofollow" : void 0
+      robots: forceNoindex ? "noindex, nofollow" : void 0,
+      emitGraph: true,
+      breadcrumbTrail,
+      reviews,
+      blogMeta,
+      faq
     });
     const html = spliceHeadHtml(shellHtml, tags);
     const outFile = routeToOutputFile(outDir, route.path);
@@ -159,8 +333,16 @@ function dcsSeoPlugin(options = {}) {
     debug = false,
     emitStaticHtml = false,
     pagesPath = ".dcs/pages.yaml",
+    contentPath = ".dcs/content.yaml",
     exclude = [],
-    noindex = []
+    noindex = [],
+    // Site files default ON whenever per-route HTML emission is on, so the
+    // sites already using emitStaticHtml gain sitemap/robots/llms with no edit.
+    emitSiteFiles: emitSiteFilesOpt = emitStaticHtml,
+    siteUrl,
+    robots = {},
+    preview = false,
+    llms = true
   } = options;
   let resolvedConfig;
   return {
@@ -203,7 +385,14 @@ function dcsSeoPlugin(options = {}) {
      * no-ops. Never throws (so it can never break a production build).
      */
     writeBundle() {
-      if (!emitStaticHtml) return;
+      if (!emitStaticHtml) {
+        if (options.emitSiteFiles === true) {
+          console.warn(
+            "[dcs-seo] emitSiteFiles:true is ignored because emitStaticHtml is false; set emitStaticHtml:true to emit sitemap.xml/robots.txt/llms.txt"
+          );
+        }
+        return;
+      }
       try {
         const projectRoot = resolvedConfig?.root || process.cwd();
         const outDir = resolveOutDir(resolvedConfig);
@@ -232,18 +421,43 @@ function dcsSeoPlugin(options = {}) {
           );
         }
         const shellHtml = fs2.readFileSync(shellPath, "utf8");
+        const excludedGlobs = loadExcludedGlobs(projectRoot, pagesPath);
+        const contentConfig = loadContentConfig(projectRoot, contentPath, debug);
         const written = emitStaticSeoHtml({
           outDir,
           shellHtml,
           routes,
           seoConfig: loaded?.config,
+          contentConfig,
           exclude,
           noindex,
+          excludedGlobs,
           debug
         });
         if (debug) {
           console.log(`[dcs-seo] emitStaticHtml: wrote ${written} per-route HTML file(s)`);
         }
+        if (emitSiteFilesOpt) {
+          const siteFiles = emitSiteFiles({
+            outDir,
+            projectRoot,
+            pagesPath,
+            routes,
+            seoConfig: loaded?.config,
+            siteUrl,
+            exclude,
+            noindex,
+            preview,
+            robots,
+            llms,
+            debug
+          });
+          if (debug) {
+            console.log(
+              `[dcs-seo] emitSiteFiles: wrote ${siteFiles.length} site file(s): ${siteFiles.join(", ") || "(none)"}`
+            );
+          }
+        }
       } catch (error) {
         console.warn("[dcs-seo] emitStaticHtml failed; build output left unchanged:", error);
       }
@@ -664,6 +878,6 @@ function responsiveImagePlugin(md) {
   };
 }
 
-export { dcsCdnBuildEnd, dcsCdnImagePlugin, dcsContentPlugin, dcsEditorPlugin, dcsPreviewPlugin, dcsSeoPlugin, emitStaticSeoHtml, responsiveImagePlugin };
+export { dcsCdnBuildEnd, dcsCdnImagePlugin, dcsContentPlugin, dcsEditorPlugin, dcsPreviewPlugin, dcsSeoPlugin, emitSiteFiles, emitStaticSeoHtml, responsiveImagePlugin };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map