@dreamtree-org/landing-kit 0.0.0-stage → 0.2.0

package/dist/server.js

@@ -0,0 +1,512 @@
+// src/server.js
+import fs from "node:fs";
+import path from "node:path";
+
+// src/seo.js
+var SITE_PLACEHOLDER = "__SITE_URL__";
+var AI_CRAWLERS = [
+  "GPTBot",
+  "OAI-SearchBot",
+  "ChatGPT-User",
+  "ClaudeBot",
+  "Claude-SearchBot",
+  "Claude-User",
+  "PerplexityBot",
+  "Perplexity-User",
+  "Google-Extended",
+  "Applebot-Extended",
+  "Bingbot",
+  "CCBot"
+];
+var DEFAULT_PRIVATE_PATHS = ["/api/", "/oauth/", "/.well-known/", "/mcp"];
+var PRIVATE_ROBOTS = "User-agent: *\nDisallow: /\n";
+var DEFAULT_LOCALE = { lang: "en-IN", og: "en_IN", country: "India" };
+var DEFAULT_IMAGE = { path: "/og-image.png", width: 1200, height: 630, type: "image/png" };
+function escapeHtml(value) {
+  return String(value).replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function jsonLdScript(graph) {
+  return JSON.stringify(graph).replace(/</g, "\\u003c");
+}
+function pageUrl(path2 = "/", site = SITE_PLACEHOLDER) {
+  if (/^https?:\/\//.test(path2)) return path2;
+  if (site == null) return void 0;
+  const base = String(site).replace(/\/+$/, "");
+  return path2 === "/" ? `${base}/` : `${base}${path2.startsWith("/") ? path2 : `/${path2}`}`;
+}
+var imageOf = (product) => {
+  const img = product.image;
+  if (!img) return DEFAULT_IMAGE;
+  if (typeof img === "string") return { ...DEFAULT_IMAGE, path: img, type: /\.png$/i.test(img) ? "image/png" : void 0 };
+  return { ...DEFAULT_IMAGE, ...img };
+};
+var need = (fn, obj, keys) => {
+  for (const k of keys) {
+    const v = k.split(".").reduce((o, p) => o == null ? o : o[p], obj);
+    if (v == null || v === "") throw new Error(`${fn}: "${k}" is missing \u2014 pass it in the ${k.split(".")[0]} object.`);
+  }
+};
+function buildJsonLd({
+  site = SITE_PLACEHOLDER,
+  product,
+  org = { name: "Dreamtree-Org" },
+  page = { path: "/" },
+  faq,
+  howTo,
+  breadcrumbs,
+  parts,
+  keywords,
+  lastmod,
+  speakable,
+  locale = DEFAULT_LOCALE
+}) {
+  need("buildJsonLd", { product, page }, ["product.name", "product.definition"]);
+  const u = (p) => pageUrl(p, site);
+  const home = u("/");
+  const id = (frag, base = home) => base ? `${base}#${frag}` : void 0;
+  const ref = (frag) => home ? { "@id": id(frag) } : void 0;
+  const url = u(page.path || "/");
+  const image = imageOf(product);
+  const imageUrl = u(image.path);
+  const sameAs = (org.sameAs || []).filter((s) => /^https?:\/\//.test(s));
+  const graph = [
+    {
+      "@type": "Organization",
+      "@id": id("organization"),
+      name: org.name,
+      url: home,
+      ...org.logo ? { logo: { "@type": "ImageObject", url: u(org.logo) } } : {},
+      ...product.logo ? { brand: { "@type": "Brand", name: product.name, logo: u(product.logo) } } : { brand: { "@type": "Brand", name: product.name } },
+      ...org.email ? { email: org.email, contactPoint: { "@type": "ContactPoint", contactType: "sales", email: org.email } } : {},
+      ...sameAs.length ? { sameAs } : {}
+    },
+    {
+      "@type": "WebSite",
+      "@id": id("website"),
+      url: home,
+      name: product.name,
+      ...product.description ? { description: product.description } : {},
+      publisher: ref("organization"),
+      inLanguage: locale.lang
+    },
+    {
+      "@type": "SoftwareApplication",
+      "@id": id("software"),
+      name: product.name,
+      description: product.definition,
+      applicationCategory: product.category || "BusinessApplication",
+      ...product.subCategory ? { applicationSubCategory: product.subCategory } : {},
+      operatingSystem: product.operatingSystem || "Web browser",
+      url: home,
+      image: imageUrl,
+      ...product.screenshot ? { screenshot: u(product.screenshot) } : {},
+      ...product.features && product.features.length ? { featureList: product.features } : {},
+      ...product.audience ? { audience: { "@type": "BusinessAudience", audienceType: product.audience } } : {},
+      ...locale.country ? { areaServed: { "@type": "Country", name: locale.country } } : {},
+      publisher: ref("organization"),
+      inLanguage: locale.lang,
+      ...product.offers ? {
+        offers: {
+          "@type": "Offer",
+          description: product.offers.description || "Contact us for pricing",
+          url: u(product.offers.url || "/#book-demo"),
+          availability: "https://schema.org/InStock",
+          seller: ref("organization")
+        }
+      } : {}
+    }
+  ];
+  if (page.title) {
+    graph.push({
+      "@type": "WebPage",
+      "@id": id("webpage", url),
+      url,
+      name: page.title,
+      ...page.description ? { description: page.description } : {},
+      isPartOf: ref("website"),
+      about: ref("software"),
+      primaryImageOfPage: { "@type": "ImageObject", url: imageUrl, width: image.width, height: image.height },
+      inLanguage: locale.lang,
+      ...lastmod ? { dateModified: lastmod } : {},
+      ...speakable && speakable.length ? { speakable: { "@type": "SpeakableSpecification", cssSelector: speakable } } : {},
+      ...url ? { breadcrumb: { "@id": id("breadcrumb", url) } } : {},
+      ...keywords && keywords.length ? { keywords: keywords.join(", ") } : {},
+      ...parts && parts.length ? { hasPart: parts.map((p) => ({ "@type": "WebPage", url: u(p.path), name: p.name })) } : {}
+    });
+    const trail = breadcrumbs || (page.path && page.path !== "/" ? [[product.name, "/"], [page.name || page.title, page.path]] : [[product.name, "/"]]);
+    graph.push({
+      "@type": "BreadcrumbList",
+      "@id": id("breadcrumb", url),
+      itemListElement: trail.map(([name, p], i) => ({ "@type": "ListItem", position: i + 1, name, item: u(p) }))
+    });
+  }
+  if (faq && faq.length) {
+    graph.push({
+      "@type": "FAQPage",
+      "@id": id("faq", url),
+      ...page.title && url ? { isPartOf: { "@id": id("webpage", url) } } : {},
+      mainEntity: faq.map((f) => ({ "@type": "Question", name: f.q, acceptedAnswer: { "@type": "Answer", text: f.a } }))
+    });
+  }
+  if (howTo && howTo.steps && howTo.steps.length) {
+    const anchor = howTo.anchor || "how-it-works";
+    graph.push({
+      "@type": "HowTo",
+      "@id": id(anchor, url),
+      name: howTo.name || `How to use ${product.name}`,
+      ...howTo.description ? { description: howTo.description } : {},
+      tool: { "@type": "HowToTool", name: product.name },
+      step: howTo.steps.map((st, i) => ({
+        "@type": "HowToStep",
+        position: i + 1,
+        name: st.name || st.title,
+        text: st.text || st.body,
+        ...url ? { url: `${url}#${anchor}` } : {}
+      }))
+    });
+  }
+  return { "@context": "https://schema.org", "@graph": JSON.parse(JSON.stringify(graph)) };
+}
+function contentFacts(content = {}) {
+  const steps = content.steps ? content.steps.steps || content.steps.items : null;
+  const sections = [];
+  for (const s of content.sections || []) {
+    if (!s || !s.title || s.use) continue;
+    const items = (s.items || []).map((i) => typeof i === "string" ? `- ${i}` : `- ${i.title}${i.body ? `: ${i.body}` : ""}`);
+    const extra = [s.detail, s.note].filter(Boolean).join(" ");
+    sections.push([s.eyebrow || s.title, [s.body, extra, items.join("\n")].filter(Boolean).join("\n\n")]);
+  }
+  if (content.audiences) {
+    sections.push([content.audiences.title, (content.audiences.items || []).map((a) => `- ${a.title}: ${a.body}`).join("\n")]);
+  }
+  if (steps) sections.push([content.steps.title, steps.map((st, i) => `${i + 1}. ${st.name || st.title}: ${st.text || st.body}`).join("\n")]);
+  return {
+    faq: content.faq ? content.faq.items || [] : [],
+    howTo: steps ? { name: content.steps.howToName, description: content.steps.title, steps, anchor: content.steps.id || "how-it-works" } : null,
+    features: content.product && content.product.features || [],
+    sections
+  };
+}
+function buildHead({ site = SITE_PLACEHOLDER, page, product, twitterHandle, jsonLd, locale = DEFAULT_LOCALE, robots }) {
+  need("buildHead", { page, product }, ["page.title", "page.description", "product.name"]);
+  const e = escapeHtml;
+  const url = pageUrl(page.path || "/", site);
+  const image = imageOf(product);
+  const imageUrl = pageUrl(image.path, site);
+  const alt = image.alt || `${product.name}: ${page.name && page.name !== "Home" ? page.name : page.title}`;
+  const handle = twitterHandle ? `@${String(twitterHandle).replace(/^@/, "")}` : "";
+  return [
+    `<title>${e(page.title)}</title>`,
+    `<meta name="description" content="${e(page.description)}" />`,
+    `<meta name="robots" content="${e(robots || "index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1")}" />`,
+    url ? `<link rel="canonical" href="${e(url)}" />` : null,
+    url ? `<link rel="alternate" hreflang="${locale.lang}" href="${e(url)}" />` : null,
+    url ? `<link rel="alternate" hreflang="x-default" href="${e(url)}" />` : null,
+    '<meta property="og:type" content="website" />',
+    `<meta property="og:site_name" content="${e(product.name)}" />`,
+    `<meta property="og:locale" content="${locale.og}" />`,
+    url ? `<meta property="og:url" content="${e(url)}" />` : null,
+    `<meta property="og:title" content="${e(page.title)}" />`,
+    `<meta property="og:description" content="${e(page.description)}" />`,
+    imageUrl ? `<meta property="og:image" content="${e(imageUrl)}" />` : null,
+    image.type ? `<meta property="og:image:type" content="${e(image.type)}" />` : null,
+    `<meta property="og:image:width" content="${image.width}" />`,
+    `<meta property="og:image:height" content="${image.height}" />`,
+    `<meta property="og:image:alt" content="${e(alt)}" />`,
+    '<meta name="twitter:card" content="summary_large_image" />',
+    handle ? `<meta name="twitter:site" content="${e(handle)}" />` : null,
+    `<meta name="twitter:title" content="${e(page.title)}" />`,
+    `<meta name="twitter:description" content="${e(page.description)}" />`,
+    imageUrl ? `<meta name="twitter:image" content="${e(imageUrl)}" />` : null,
+    site != null ? `<link rel="alternate" type="text/plain" title="LLM summary" href="${e(pageUrl("/llms.txt", site))}" />` : null,
+    jsonLd ? `<script type="application/ld+json">${jsonLdScript(jsonLd)}</script>` : null
+  ].filter(Boolean).join("\n    ");
+}
+function buildRobots({ site = SITE_PLACEHOLDER, privatePaths = DEFAULT_PRIVATE_PATHS, crawlers = AI_CRAWLERS } = {}) {
+  const rules = ["Allow: /", ...privatePaths.map((p) => `Disallow: ${p}`)];
+  const blocks = ["*", ...crawlers].map((agent) => [`User-agent: ${agent}`, ...rules].join("\n"));
+  const map = pageUrl("/sitemap.xml", site);
+  return `${blocks.join("\n\n")}
+${map ? `
+Sitemap: ${map}
+` : ""}`;
+}
+function buildSitemap({ site = SITE_PLACEHOLDER, pages, lastmod, changefreq = "monthly" }) {
+  if (!Array.isArray(pages) || !pages.length) throw new Error('buildSitemap: "pages" is missing \u2014 pass [{ path: "/" }, ...].');
+  return [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
+    ...pages.map((p) => {
+      const pr = p.priority || (p.path === "/" ? "1.0" : "0.8");
+      return `  <url><loc>${escapeHtml(pageUrl(p.path, site))}</loc>${lastmod ? `<lastmod>${lastmod}</lastmod>` : ""}<changefreq>${p.changefreq || changefreq}</changefreq><priority>${pr}</priority></url>`;
+    }),
+    "</urlset>",
+    ""
+  ].join("\n");
+}
+function buildLlmsTxt({ site = SITE_PLACEHOLDER, product, org = { name: "Dreamtree-Org" }, pages = [], about, facts, optional }) {
+  need("buildLlmsTxt", { product }, ["product.name", "product.definition"]);
+  const u = (p) => pageUrl(p, site);
+  return [
+    `# ${product.name}`,
+    "",
+    `> ${product.definition}`,
+    "",
+    about || `${product.name} is made by ${org.name}. It runs in the web browser.`,
+    "",
+    "## Pages",
+    "",
+    ...pages.map((p) => `- [${p.path === "/" ? `${product.name} home` : p.name || p.title}](${u(p.path)}): ${p.summary || p.description}`),
+    `- [Full product description for language models](${u("/llms-full.txt")}): every feature, page and FAQ in plain text`,
+    "",
+    "## What it does",
+    "",
+    ...(facts || product.features || []).map((f) => `- ${f}`),
+    "",
+    "## Optional",
+    "",
+    ...(optional || [
+      { label: "Book a demo", path: "/#book-demo" },
+      { label: "Log in", path: "/login" }
+    ]).map((o) => `- [${o.label}](${u(o.path)})`),
+    ""
+  ].join("\n");
+}
+function buildLlmsFullTxt({ site = SITE_PLACEHOLDER, product, org = { name: "Dreamtree-Org" }, pages = [], sections = () => [] }) {
+  need("buildLlmsFullTxt", { product }, ["product.name", "product.definition"]);
+  const out = [`# ${product.name}: full description`, "", `> ${product.definition}`, "", `Made by ${org.name}. Source: ${pageUrl("/", site)}`, ""];
+  for (const page of pages) {
+    out.push(`## ${page.path === "/" ? "Overview" : page.name || page.title}`, "", `Page: ${pageUrl(page.path, site)}`, "");
+    if (page.description) out.push(page.description, "");
+    for (const [heading, body] of sections(page) || []) {
+      out.push(`### ${heading}`, "");
+      if (body) out.push(body, "");
+    }
+    if (page.faq && page.faq.length) {
+      out.push("### Frequently asked questions", "");
+      for (const f of page.faq) out.push(`**${f.q}**`, "", f.a, "");
+    }
+  }
+  if (product.features && product.features.length) out.push("## Features", "", ...product.features.map((f) => `- ${f}`), "");
+  return out.join("\n");
+}
+
+// src/server.js
+var CRAWLER_FILES = {
+  "/robots.txt": "text/plain; charset=utf-8",
+  "/sitemap.xml": "application/xml; charset=utf-8",
+  "/llms.txt": "text/plain; charset=utf-8",
+  "/llms-full.txt": "text/plain; charset=utf-8"
+};
+var PLACEHOLDER_RE = new RegExp(SITE_PLACEHOLDER, "g");
+var VERIFY_SLOT = "<!--site-verification-->";
+function siteUrl(req, { appUrl = process.env.APP_URL } = {}) {
+  const configured = String(appUrl || "").trim().replace(/\/+$/, "");
+  if (configured) return configured;
+  const h = req.headers || {};
+  const proto = String(h["x-forwarded-proto"] || req.protocol || "http").split(",")[0].trim();
+  const host = String(h["x-forwarded-host"] || h.host || "localhost").split(",")[0].trim();
+  return `${proto}://${host}`;
+}
+function readCookie(req, name) {
+  const raw = String(req.headers && req.headers.cookie || "");
+  const m = new RegExp(`(?:^|;\\s*)${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}=([^;]+)`).exec(raw);
+  if (!m) return null;
+  try {
+    return decodeURIComponent(m[1]);
+  } catch {
+    return m[1];
+  }
+}
+function sessionCheck({ cookie = "JWT_TOKEN", bearer = false, verify } = {}) {
+  if (typeof verify !== "function") {
+    throw new Error('landing-kit sessionCheck: "verify" is missing \u2014 pass (token) => boolean using your JWT check.');
+  }
+  return (req) => {
+    let token = cookie ? readCookie(req, cookie) : null;
+    if (!token && bearer) {
+      const auth = String(req.headers && req.headers.authorization || "");
+      if (/^Bearer\s+/i.test(auth)) token = auth.replace(/^Bearer\s+/i, "").trim();
+    }
+    if (!token) return false;
+    try {
+      return verify(token) === true;
+    } catch {
+      return false;
+    }
+  };
+}
+function verificationTags(env = process.env) {
+  const tags = [];
+  const google = String(env.GOOGLE_SITE_VERIFICATION || "").trim();
+  const bing = String(env.BING_SITE_VERIFICATION || "").trim();
+  if (google) tags.push(`<meta name="google-site-verification" content="${escapeHtml(google)}" />`);
+  if (bing) tags.push(`<meta name="msvalidate.01" content="${escapeHtml(bing)}" />`);
+  return tags.join("\n    ");
+}
+function fillSite(body, origin, { html = false, env = process.env } = {}) {
+  const out = String(body).replace(PLACEHOLDER_RE, origin);
+  return html ? out.replace(VERIFY_SLOT, () => verificationTags(env)) : out;
+}
+function landingRoutes(app, options = {}) {
+  const opts = typeof options === "string" ? { dist: options } : options;
+  const {
+    dist,
+    manifest: manifestFile = "landing-pages.json",
+    isPublicHost = () => true,
+    hasSession = () => false,
+    onSession = "next",
+    onPrivateHost = "next",
+    trailingSlash = "redirect",
+    rawFiles: rawMode = "not-found",
+    redirects = {},
+    cacheControl = "public, max-age=300",
+    crawlerCache = "public, max-age=3600",
+    privateRobots = PRIVATE_ROBOTS,
+    appUrl,
+    env = process.env
+  } = opts;
+  if (!app || typeof app.get !== "function") throw new Error("landing-kit landingRoutes: pass the Express app as the first argument.");
+  if (!dist) throw new Error('landing-kit landingRoutes: "dist" is missing \u2014 pass { dist: path.join(__dirname, "client/dist") }.');
+  const cache = /* @__PURE__ */ new Map();
+  const read = (rel) => {
+    if (!cache.has(rel)) {
+      const full = path.join(dist, rel);
+      cache.set(rel, fs.existsSync(full) && fs.statSync(full).isFile() ? fs.readFileSync(full, "utf8") : null);
+    }
+    return cache.get(rel);
+  };
+  const origin = (req) => siteUrl(req, appUrl !== void 0 ? { appUrl } : void 0);
+  const base = path.posix.dirname(manifestFile.split(path.sep).join("/"));
+  const fromManifest = (f) => base === "." ? f : path.posix.join(base, f);
+  let routes = {};
+  const rawManifest = read(manifestFile);
+  if (rawManifest) {
+    try {
+      routes = Object.fromEntries(Object.entries(JSON.parse(rawManifest) || {}).map(([p, f]) => [p, fromManifest(f)]));
+    } catch {
+      routes = {};
+    }
+  } else if (read("landing.html") != null) {
+    routes = { "/": "landing.html" };
+  }
+  const isPublic = (req) => Promise.resolve(isPublicHost(req)).then(Boolean);
+  const guard = (fn) => (req, res, next) => Promise.resolve(fn(req, res, next)).catch(next);
+  const appShell = (res, next) => {
+    res.set("Cache-Control", "no-cache");
+    return res.sendFile(path.join(dist, "index.html"), (err) => err && next(err));
+  };
+  const sendPage = (req, res, file) => {
+    res.set("Cache-Control", cacheControl);
+    res.type("html").send(fillSite(read(file), origin(req), { html: true, env }));
+  };
+  app.get("/", guard(async (req, res, next) => {
+    const file = routes["/"];
+    if (!file || read(file) == null) return next();
+    if (!await isPublic(req)) return onPrivateHost === "app-shell" ? appShell(res, next) : next();
+    res.set("Vary", "Cookie");
+    if (hasSession(req)) return onSession === "app-shell" ? appShell(res, next) : next();
+    sendPage(req, res, file);
+  }));
+  const byFile = Object.fromEntries(Object.entries(routes).map(([route, f]) => [`/${f}`, route]));
+  const rawSet = /* @__PURE__ */ new Set([`/${manifestFile.split(path.sep).join("/")}`, ...Object.keys(byFile)]);
+  const rawDirs = [...new Set(Object.values(routes).filter((f) => f.includes("/")).map((f) => `/${f.split("/")[0]}/`))];
+  app.use((req, res, next) => {
+    if (req.method !== "GET" && req.method !== "HEAD") return next();
+    const p = req.path;
+    if (!rawSet.has(p) && !rawDirs.some((d) => p.startsWith(d))) return next();
+    if (rawMode === "redirect" && byFile[p]) return res.redirect(301, byFile[p]);
+    return res.status(404).type("text/plain").send("Not found");
+  });
+  for (const [from, to] of Object.entries(redirects)) {
+    app.get(from, guard(async (req, res, next) => await isPublic(req) ? res.redirect(301, to) : next()));
+  }
+  const others = Object.keys(routes).filter((p) => p !== "/");
+  if (others.length) {
+    app.get(
+      others.flatMap((p) => [p, `${p}/`]),
+      guard(async (req, res, next) => {
+        if (!await isPublic(req)) return next();
+        const trimmed = req.path.replace(/\/+$/, "");
+        const file = routes[trimmed];
+        if (!file || read(file) == null) return next();
+        if (trimmed !== req.path && trailingSlash !== "serve") return res.redirect(301, trimmed + req.originalUrl.slice(req.path.length));
+        sendPage(req, res, file);
+      })
+    );
+  }
+  for (const [route, type] of Object.entries(CRAWLER_FILES)) {
+    app.get(route, guard(async (req, res, next) => {
+      const body = await isPublic(req) ? read(route.slice(1)) : null;
+      if (body == null) {
+        if (route !== "/robots.txt") return next();
+        return res.type("text/plain").send(privateRobots);
+      }
+      res.set("Cache-Control", crawlerCache);
+      res.type(type).send(fillSite(body, origin(req)));
+    }));
+  }
+  return Object.keys(routes);
+}
+function pageFile(p, { homeFile = "landing.html", pagesDir = "landing-pages" } = {}) {
+  return p === "/" ? homeFile : path.posix.join(pagesDir, `${p.replace(/^\/+|\/+$/g, "")}.html`);
+}
+function prerenderPages({ dist, template = "landing.html", pages, files = {}, homeFile = "landing.html", pagesDir = "landing-pages", manifest = "landing-pages.json", slot = "<!--landing-->" }) {
+  if (!dist) throw new Error('landing-kit prerenderPages: "dist" is missing.');
+  if (!Array.isArray(pages) || !pages.length) throw new Error('landing-kit prerenderPages: "pages" is missing \u2014 pass [{ path, html, title, description }].');
+  const tpl = template.includes("<") ? template : fs.readFileSync(path.join(dist, template), "utf8");
+  if (!tpl.includes(slot)) throw new Error(`landing-kit prerenderPages: the template has no ${slot} slot for the page body.`);
+  const esc = escapeHtml;
+  const outputs = [];
+  for (const p of pages) {
+    for (const k of ["path", "html"]) if (p[k] == null) throw new Error(`landing-kit prerenderPages: page "${p.path || "?"}" has no "${k}".`);
+    const jsonLd = p.jsonLd == null ? "" : typeof p.jsonLd === "string" ? p.jsonLd : JSON.stringify(p.jsonLd).replace(/</g, "\\u003c");
+    const out = tpl.replace(/%TITLE%/g, () => esc(p.title || "")).replace(/%DESCRIPTION%/g, () => esc(p.description || "")).replace(/%PATH%/g, () => p.path).replace("%JSONLD%", () => jsonLd).replace("%HEAD%", () => p.head || "").replace(slot, () => p.html);
+    const left = /%(TITLE|DESCRIPTION|PATH|JSONLD|HEAD)%/.exec(out);
+    if (left) throw new Error(`landing-kit prerenderPages: unfilled ${left[0]} on ${p.path}`);
+    outputs.push([p.path, pageFile(p.path, { homeFile, pagesDir }), out]);
+  }
+  fs.rmSync(path.join(dist, pagesDir), { recursive: true, force: true });
+  const map = {};
+  let bytes = 0;
+  for (const [route, file, out] of outputs) {
+    fs.mkdirSync(path.dirname(path.join(dist, file)), { recursive: true });
+    fs.writeFileSync(path.join(dist, file), out);
+    map[route] = file;
+    bytes += out.length;
+  }
+  const mdir = path.posix.dirname(manifest.split(path.sep).join("/"));
+  const rel = mdir === "." ? map : Object.fromEntries(Object.entries(map).map(([r, f]) => [r, path.posix.relative(mdir, f)]));
+  fs.mkdirSync(path.dirname(path.join(dist, manifest)), { recursive: true });
+  fs.writeFileSync(path.join(dist, manifest), JSON.stringify(rel, null, 2));
+  for (const [name, body] of Object.entries(files)) {
+    if (body != null) fs.writeFileSync(path.join(dist, name), body);
+  }
+  return { manifest: rel, bytes };
+}
+export {
+  AI_CRAWLERS,
+  CRAWLER_FILES,
+  DEFAULT_LOCALE,
+  DEFAULT_PRIVATE_PATHS,
+  PRIVATE_ROBOTS,
+  SITE_PLACEHOLDER,
+  buildHead,
+  buildJsonLd,
+  buildLlmsFullTxt,
+  buildLlmsTxt,
+  buildRobots,
+  buildSitemap,
+  contentFacts,
+  escapeHtml,
+  fillSite,
+  jsonLdScript,
+  landingRoutes,
+  pageFile,
+  pageUrl,
+  prerenderPages,
+  readCookie,
+  sessionCheck,
+  siteUrl,
+  verificationTags
+};

package/enhance.d.ts

@@ -0,0 +1,12 @@
+export interface EnhanceOptions {
+  /** Open the demo form for the clicked button (or null for a #book-demo link). */
+  openDemo?: (trigger: HTMLElement | null | undefined) => void | Promise<void>;
+  /** Lazily import a module exporting `openDemo` (e.g. () => import('./demoIsland.jsx')). Warmed on hover/focus. */
+  loadDemo?: () => Promise<{ openDemo: (trigger?: HTMLElement | null) => void }> | { openDemo: (trigger?: HTMLElement | null) => void };
+  warmDemo?: () => unknown;
+  /** URL hash that opens the form on load. Default '#book-demo'; '' disables. */
+  hash?: string;
+}
+/** Wire a prerendered, un-hydrated landing page. Returns a function that removes the listeners. */
+export declare function enhanceLanding(root?: Document | Element, options?: EnhanceOptions): () => void;
+export default enhanceLanding;