@dreamtree-org/landing-kit 0.6.0 → 0.7.1

package/MIGRATION.md

@@ -106,3 +106,15 @@ Nothing changes for product landing pages. New, opt-in:
 - Apps that stored per-tenant brand colours elsewhere can move them into a theme with
   `validateTheme({ preset: 'custom', primary, accent })`.
 
+
+## 0.7.0 — serve-time page transforms (additive)
+
+Nothing changes unless you opt in:
+
+- `landingRoutes(app, { transformPage })`: `(body, { req, route, file, kind }) => string | null`
+  (may be async) runs on every prerendered page (`kind: 'page'`) and crawler file (`'crawler'`)
+  before the origin is filled in. Return the rewritten body, or null to serve the prerendered one;
+  a throw is logged and also serves the prerendered body. It runs per request, so cache inside it.
+- `fillPage(template, page)` from `/server`: the template fill `prerenderPages` does, as a string.
+  Keep a copy of the template (prerenderPages overwrites `landing.html`) and an SSR bundle to
+  re-render pages with live data, e.g. CMS-driven pricing.

package/README.md

@@ -2,6 +2,54 @@
 
 The shared marketing landing pages **and** authentication frame (`<AuthShell>`, `brands`, `getBrand`) for every Dreamtree product: replaces the landing setup copied across billpro, taskpro and venturepro (page chrome, sections, "Book a demo" dialog, SEO files, Express routes and prerender) and the login/signup/reset/platform-admin frame in one package.
 
+[![npm version](https://badge.fury.io/js/@dreamtree-org%2Flanding-kit.svg)](https://www.npmjs.com/package/@dreamtree-org/landing-kit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Website](https://img.shields.io/badge/by-Dreamtree--Org-0ea5e9)](https://www.dreamtreeglobal.com)
+
+## About the Company
+
+Landing Kit is built and maintained under **[Dreamtree-Org](https://www.dreamtreeglobal.com)** — a team crafting thoughtful, developer-first software for the modern web. We believe great products start with a great foundation, and that's exactly what this kit aims to be: a polished, open, and dependable landing and auth frame for teams everywhere.
+
+🌐 **Website:** [www.dreamtreeglobal.com](https://www.dreamtreeglobal.com)
+
+## Author & Maintainer
+
+**Partha Preetham Krishna** — [Dreamtree-Org](https://www.dreamtreeglobal.com)
+📧 [preetham.krishna.dev@gmail.com](mailto:preetham.krishna.dev@gmail.com)
+
+Have an idea, a bug, or just want to say hi? Reach out anytime — feedback from developers like you is what keeps this kit growing.
+
+## 💚 Sponsor & Support
+
+Landing Kit is **free and open source**, built in the open and powered entirely by passion and late nights. Every feature you rely on — every responsive section, prerendered page, and auth screen — represents hours of careful craft so that _your_ product can launch a fast, crawlable landing page in minutes.
+
+If this kit has saved you time, sparked an idea, or spared you another hand-built marketing page, please consider supporting its continued development. **Your sponsorship keeps the updates coming, the bugs squashed, and the docs sharp — for the whole community.** Even the smallest contribution is a huge encouragement. 🙏
+
+### ☕ Make a one-tap donation via UPI
+
+**📷 Scan the QR with any UPI app** (Google Pay, PhonePe, Paytm, BHIM, …) to pay instantly:
+
+<p>
+  <img src="https://unpkg.com/@dreamtree-org/twreact-ui@latest/doc/assets/upi-qr.png" alt="Scan to pay Dreamtree-Org via UPI" width="220" height="220" />
+</p>
+
+> **UPI ID:** `dhrugantha.llp@kotak` &nbsp;•&nbsp; **Payee:** Dreamtree-Org
+>
+> 📱 On mobile, you can also tap the button below — it opens your UPI app directly. On desktop, scan the QR above or copy the UPI ID into your payment app.
+
+[![Pay via UPI](https://img.shields.io/badge/Pay-via%20UPI-22c55e?style=for-the-badge&logo=googlepay&logoColor=white)](upi://pay?pa=dhrugantha.llp@kotak&pn=Dreamtree-Org&cu=INR&tn=Support%20Landing%20Kit)
+
+### 🤝 Become a Sponsor
+
+Want to back the project long-term or as a company? You can sponsor the package directly:
+
+- 📦 **npm:** [`@dreamtree-org/landing-kit`](https://www.npmjs.com/package/@dreamtree-org/landing-kit) — star, share, and sponsor the package
+- ✉️ **Corporate sponsorships & partnerships:** [preetham.krishna.dev@gmail.com](mailto:preetham.krishna.dev@gmail.com)
+
+Every star ⭐, share, and contribution helps more than you know. Thank you for being part of the journey!
+
+## Features
+
 - Two facades, both taking the product's brand from **its own repo** (`dreamtree.brand.json`, twreact-ui's brand format) through `toLandingBrand()`:
   - `<LandingPage brand={brand} content={content} />` — a product's landing page is a content file.
   - `<AuthShell brand={brand} title="Welcome back">…</AuthShell>` (also available at `@dreamtree-org/landing-kit/auth` + `@dreamtree-org/landing-kit/auth.css`).
@@ -10,12 +58,14 @@ The shared marketing landing pages **and** authentication frame (`<AuthShell>`,
 - Built for prerendered, **un-hydrated** pages (fast and crawlable): `enhanceLanding()` wires the menu and the demo button in a few hundred bytes. It also works hydrated in an SPA or Next.js (`'use client'`, `onBookDemo`, `linkComponent`).
 - Responsive from 320px up. The nav folds into a menu below 1024px. Checked with Playwright at 320/375/768/1024/1440, light and dark.
 
-## 60-second start
+## Installation
 
 ```bash
 npm install @dreamtree-org/landing-kit
 ```
 
+## Quick Start
+
 ```jsx
 // Landing.jsx
 import { LandingPage, toLandingBrand } from '@dreamtree-org/landing-kit';
@@ -266,7 +316,8 @@ to emit a graph without URLs. No ratings, reviews or prices are ever generated;
 
 | Function | Meaning |
 |---|---|
-| `landingRoutes(app, { dist, isPublicHost, hasSession, redirects, onSession, onPrivateHost, trailingSlash, rawFiles, manifest, cacheControl })` | serves `/` (visitors only, `Vary: Cookie`), every page in the manifest (default `landing-pages.json`; its paths are relative to its own directory), robots/sitemap/llms with the origin filled in, verification meta tags from env; 404s the raw files (`rawFiles: 'redirect'` 301s them to their page instead); `/x/` → 301 `/x` (`trailingSlash: 'serve'` answers both); `isPublicHost` may be async; a non-public host gets `Disallow: /` and, at `/`, `next()` or the app shell (`onPrivateHost: 'app-shell'`) |
+| `landingRoutes(app, { dist, isPublicHost, hasSession, redirects, onSession, onPrivateHost, trailingSlash, rawFiles, manifest, cacheControl, transformPage })` | serves `/` (visitors only, `Vary: Cookie`), every page in the manifest (default `landing-pages.json`; its paths are relative to its own directory), robots/sitemap/llms with the origin filled in, verification meta tags from env; 404s the raw files (`rawFiles: 'redirect'` 301s them to their page instead); `/x/` → 301 `/x` (`trailingSlash: 'serve'` answers both); `isPublicHost` may be async; a non-public host gets `Disallow: /` and, at `/`, `next()` or the app shell (`onPrivateHost: 'app-shell'`); `transformPage(body, { req, route, file, kind })` may rewrite a page or crawler file per request (e.g. live prices) and falls back to the prerendered body on null or a throw |
+| `fillPage(template, page)` | one page poured into the template, as a string: what `prerenderPages` writes. Pair it with `transformPage` to re-render a page with live data |
 | `prerenderPages({ dist, pages, files, homeFile, pagesDir, manifest })` | build step: fills `%TITLE% %DESCRIPTION% %PATH% %JSONLD% %HEAD% <!--landing-->` per page, writes `landing.html`, `landing-pages/…`, the manifest and crawler files; throws on an unfilled slot before writing anything |
 | `sessionCheck({ cookie: 'JWT_TOKEN', bearer, verify })` | `hasSession(req)` from your own JWT check |
 | `siteUrl(req)` · `verificationTags(env)` · `readCookie` · `fillSite` | helpers |
@@ -338,6 +389,25 @@ and in `app/robots.ts` / `app/sitemap.ts` use `buildRobots` / `buildSitemap` wit
 - No Vite/Next build plugin. You keep your own landing.html, SSR entry and build; the package fills and writes the files.
 - No icon library. Pass lucide (or any) components.
 
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
 ## License
 
-MIT
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- 🐛 [Issue Tracker](https://github.com/dreamtree-org/dreamtree-org.landing-kit/issues)
+- 📦 [npm package](https://www.npmjs.com/package/@dreamtree-org/landing-kit)
+- 🌐 [Dreamtree-Org](https://www.dreamtreeglobal.com)
+- 📧 [preetham.krishna.dev@gmail.com](mailto:preetham.krishna.dev@gmail.com)
+
+---
+
+**Made with ❤️ by [Partha Preetham Krishna](https://www.linkedin.com/in/partha-preetham-krishna-68ba00197/)** under [Dreamtree-Org](https://www.dreamtreeglobal.com) · [www.dreamtreeglobal.com](https://www.dreamtreeglobal.com)

package/dist/server.cjs

@@ -43,6 +43,7 @@ __export(server_exports, {
   buildSitemap: () => buildSitemap,
   contentFacts: () => contentFacts,
   escapeHtml: () => escapeHtml,
+  fillPage: () => fillPage,
   fillSite: () => fillSite,
   jsonLdScript: () => jsonLdScript,
   landingRoutes: () => landingRoutes,
@@ -420,7 +421,8 @@ function landingRoutes(app, options = {}) {
     crawlerCache = "public, max-age=3600",
     privateRobots = PRIVATE_ROBOTS,
     appUrl,
-    env = process.env
+    env = process.env,
+    transformPage
   } = 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") }.');
@@ -452,9 +454,20 @@ function landingRoutes(app, options = {}) {
     res.set("Cache-Control", "no-cache");
     return res.sendFile(import_node_path.default.join(dist, "index.html"), (err) => err && next(err));
   };
-  const sendPage = (req, res, file) => {
+  const bodyFor = async (req, body, meta) => {
+    if (!transformPage) return body;
+    try {
+      const out = await transformPage(body, { req, ...meta });
+      return typeof out === "string" ? out : body;
+    } catch (err) {
+      console.error(`landing-kit transformPage failed on ${meta.route}:`, err?.message || err);
+      return body;
+    }
+  };
+  const sendPage = async (req, res, file, route) => {
+    const body = await bodyFor(req, read(file), { route, file, kind: "page" });
     res.set("Cache-Control", cacheControl);
-    res.type("html").send(fillSite(read(file), origin(req), { html: true, env }));
+    res.type("html").send(fillSite(body, origin(req), { html: true, env }));
   };
   app.get("/", guard(async (req, res, next) => {
     const file = routes["/"];
@@ -462,7 +475,7 @@ function landingRoutes(app, options = {}) {
     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);
+    await sendPage(req, res, file, "/");
   }));
   const byFile = Object.fromEntries(Object.entries(routes).map(([route, f]) => [`/${f}`, route]));
   const rawSet = /* @__PURE__ */ new Set([`/${manifestFile.split(import_node_path.default.sep).join("/")}`, ...Object.keys(byFile)]);
@@ -487,17 +500,18 @@ function landingRoutes(app, options = {}) {
         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);
+        await sendPage(req, res, file, trimmed);
       })
     );
   }
   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) {
+      const raw = await isPublic(req) ? read(route.slice(1)) : null;
+      if (raw == null) {
         if (route !== "/robots.txt") return next();
         return res.type("text/plain").send(privateRobots);
       }
+      const body = await bodyFor(req, raw, { route, file: route.slice(1), kind: "crawler" });
       res.set("Cache-Control", crawlerCache);
       res.type(type).send(fillSite(body, origin(req)));
     }));
@@ -507,21 +521,22 @@ function landingRoutes(app, options = {}) {
 function pageFile(p, { homeFile = "landing.html", pagesDir = "landing-pages" } = {}) {
   return p === "/" ? homeFile : import_node_path.default.posix.join(pagesDir, `${p.replace(/^\/+|\/+$/g, "")}.html`);
 }
+function fillPage(template, p, { slot = "<!--landing-->" } = {}) {
+  if (!template || !template.includes(slot)) throw new Error(`landing-kit prerenderPages: the template has no ${slot} slot for the page body.`);
+  for (const k of ["path", "html"]) if (p?.[k] == null) throw new Error(`landing-kit prerenderPages: page "${p?.path || "?"}" has no "${k}".`);
+  const esc = escapeHtml;
+  const jsonLd = p.jsonLd == null ? "" : typeof p.jsonLd === "string" ? p.jsonLd : JSON.stringify(p.jsonLd).replace(/</g, "\\u003c");
+  const out = template.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}`);
+  return out;
+}
 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 : import_node_fs.default.readFileSync(import_node_path.default.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]);
-  }
+  const outputs = pages.map((p) => [p.path, pageFile(p.path, { homeFile, pagesDir }), fillPage(tpl, p, { slot })]);
   import_node_fs.default.rmSync(import_node_path.default.join(dist, pagesDir), { recursive: true, force: true });
   const map = {};
   let bytes = 0;
@@ -556,6 +571,7 @@ function prerenderPages({ dist, template = "landing.html", pages, files = {}, ho
   buildSitemap,
   contentFacts,
   escapeHtml,
+  fillPage,
   fillSite,
   jsonLdScript,
   landingRoutes,

package/dist/server.js

@@ -364,7 +364,8 @@ function landingRoutes(app, options = {}) {
     crawlerCache = "public, max-age=3600",
     privateRobots = PRIVATE_ROBOTS,
     appUrl,
-    env = process.env
+    env = process.env,
+    transformPage
   } = 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") }.');
@@ -396,9 +397,20 @@ function landingRoutes(app, options = {}) {
     res.set("Cache-Control", "no-cache");
     return res.sendFile(path.join(dist, "index.html"), (err) => err && next(err));
   };
-  const sendPage = (req, res, file) => {
+  const bodyFor = async (req, body, meta) => {
+    if (!transformPage) return body;
+    try {
+      const out = await transformPage(body, { req, ...meta });
+      return typeof out === "string" ? out : body;
+    } catch (err) {
+      console.error(`landing-kit transformPage failed on ${meta.route}:`, err?.message || err);
+      return body;
+    }
+  };
+  const sendPage = async (req, res, file, route) => {
+    const body = await bodyFor(req, read(file), { route, file, kind: "page" });
     res.set("Cache-Control", cacheControl);
-    res.type("html").send(fillSite(read(file), origin(req), { html: true, env }));
+    res.type("html").send(fillSite(body, origin(req), { html: true, env }));
   };
   app.get("/", guard(async (req, res, next) => {
     const file = routes["/"];
@@ -406,7 +418,7 @@ function landingRoutes(app, options = {}) {
     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);
+    await 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)]);
@@ -431,17 +443,18 @@ function landingRoutes(app, options = {}) {
         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);
+        await sendPage(req, res, file, trimmed);
       })
     );
   }
   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) {
+      const raw = await isPublic(req) ? read(route.slice(1)) : null;
+      if (raw == null) {
         if (route !== "/robots.txt") return next();
         return res.type("text/plain").send(privateRobots);
       }
+      const body = await bodyFor(req, raw, { route, file: route.slice(1), kind: "crawler" });
       res.set("Cache-Control", crawlerCache);
       res.type(type).send(fillSite(body, origin(req)));
     }));
@@ -451,21 +464,22 @@ function landingRoutes(app, options = {}) {
 function pageFile(p, { homeFile = "landing.html", pagesDir = "landing-pages" } = {}) {
   return p === "/" ? homeFile : path.posix.join(pagesDir, `${p.replace(/^\/+|\/+$/g, "")}.html`);
 }
+function fillPage(template, p, { slot = "<!--landing-->" } = {}) {
+  if (!template || !template.includes(slot)) throw new Error(`landing-kit prerenderPages: the template has no ${slot} slot for the page body.`);
+  for (const k of ["path", "html"]) if (p?.[k] == null) throw new Error(`landing-kit prerenderPages: page "${p?.path || "?"}" has no "${k}".`);
+  const esc = escapeHtml;
+  const jsonLd = p.jsonLd == null ? "" : typeof p.jsonLd === "string" ? p.jsonLd : JSON.stringify(p.jsonLd).replace(/</g, "\\u003c");
+  const out = template.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}`);
+  return out;
+}
 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]);
-  }
+  const outputs = pages.map((p) => [p.path, pageFile(p.path, { homeFile, pagesDir }), fillPage(tpl, p, { slot })]);
   fs.rmSync(path.join(dist, pagesDir), { recursive: true, force: true });
   const map = {};
   let bytes = 0;
@@ -499,6 +513,7 @@ export {
   buildSitemap,
   contentFacts,
   escapeHtml,
+  fillPage,
   fillSite,
   jsonLdScript,
   landingRoutes,

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@dreamtree-org/landing-kit",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "The shared marketing site and auth frame (AuthShell + brands) for every Dreamtree product: content-driven landing pages, login/signup shell, Express routes, prerender and SEO files.",
+  "author": {
+    "name": "Partha Preetham Krishna",
+    "email": "preetham.krishna.dev@gmail.com",
+    "url": "https://www.dreamtreeglobal.com"
+  },
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -75,7 +80,6 @@
   "scripts": {
     "build": "node build.mjs",
     "test": "node build.mjs && node --test test/*.test.mjs",
-    "prepublishOnly": "npm test",
     "test:viewports": "node build.mjs && node test/viewports.mjs",
     "test:tenant-viewports": "node build.mjs && node test/tenant-viewports.mjs"
   },

package/server.d.ts

@@ -31,13 +31,21 @@ export interface LandingRoutesOptions {
   privateRobots?: string;
   appUrl?: string;
   env?: Record<string, string | undefined>;
+  /**
+   * Runs on every page ('page') and crawler file ('crawler') before the origin is filled in,
+   * e.g. to re-render live prices. null/undefined or a throw serves the prerendered body.
+   */
+  transformPage?: (body: string, meta: { req: any; route: string; file: string; kind: 'page' | 'crawler' }) => string | null | undefined | Promise<string | null | undefined>;
 }
+export interface PrerenderPage { path: string; html: string; title?: string; description?: string; jsonLd?: unknown; head?: string }
+/** One page poured into the template: what prerenderPages writes, as a string. */
+export declare function fillPage(template: string, page: PrerenderPage, opts?: { slot?: string }): string;
 export declare function landingRoutes(app: any, options: LandingRoutesOptions | string): string[];
 export declare function pageFile(path: string, opts?: { homeFile?: string; pagesDir?: string }): string;
 export declare function prerenderPages(args: {
   dist: string;
   template?: string;
-  pages: Array<{ path: string; html: string; title?: string; description?: string; jsonLd?: unknown; head?: string }>;
+  pages: PrerenderPage[];
   files?: Record<string, string | null | undefined>;
   homeFile?: string; pagesDir?: string; manifest?: string; slot?: string;
 }): { manifest: Record<string, string>; bytes: number };