@growth-labs/seo 0.5.0 → 0.6.0

package/dist/vite-plugin.d.ts

@@ -1,5 +1,5 @@
 import type { Plugin } from 'vite';
-import type { ResolvedSeoOptions } from './options.js';
+import { type ResolvedSeoOptions } from './options.js';
 export interface SeoVitePluginOptions {
     config: ResolvedSeoOptions;
     /**

package/dist/vite-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAKtD,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,kBAAkB,CAAA;IAC1B;;;;;;;;;OASG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,GAAG,MAAM,CA4C3F"}
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,EAAE,KAAK,kBAAkB,EAAmB,MAAM,cAAc,CAAA;AA8BvE,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,kBAAkB,CAAA;IAC1B;;;;;;;;;OASG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,GAAG,MAAM,CA0D3F"}

package/dist/vite-plugin.js

@@ -1,5 +1,30 @@
+import { resolveAeoTwins } from './options.js';
 const VIRTUAL_MODULE_ID = 'virtual:growth-labs/seo/config';
 const RESOLVED_VIRTUAL_MODULE_ID = `\0${VIRTUAL_MODULE_ID}`;
+// Mode-aware twin of the virtual config module, imported by the always-runtime
+// SEO middleware and the head components (SeoHead/AeoHead). It seeds `_setConfig`
+// always, and seeds the contentProvider ONLY in non-static modes:
+//
+//   - STATIC mode (aeoTwins false/'static', no flexibleSampling): provider-free.
+//     The middleware runs in the DEPLOYED Worker on every request; importing the
+//     provider-bearing `config` here would pull the consumer's contentProviderModule
+//     — and transitively `astro:content` plus the whole content store (tens of MB
+//     on a large catalog) — into the runtime Worker, blowing Cloudflare's 10 MB
+//     limit even though the middleware only needs metadata. In static mode the
+//     middleware needs no provider (AEO twins are prerendered, members-gating is
+//     unavailable), so it stays out.
+//
+//   - NON-STATIC mode (aeoTwins 'middleware'/'both', or flexibleSampling): the
+//     middleware genuinely needs the provider at runtime (Accept: text/markdown
+//     negotiation, LLM-training-crawler 403 on members items). Route modules load
+//     lazily under the Cloudflare adapter, so we cannot rely on an SSR route's
+//     import to seed the provider before the middleware runs. Seeding it via THIS
+//     module — imported at the middleware's own module load — is deterministic.
+//     Bundling the store is acceptable here: non-static consumers serve dynamic
+//     content at runtime by design and are not the ones relying on prerender to
+//     stay under 10 MB.
+const VIRTUAL_LITE_ID = 'virtual:growth-labs/seo/config-lite';
+const RESOLVED_VIRTUAL_LITE_ID = `\0${VIRTUAL_LITE_ID}`;
 export function growthLabsSeoPlugin(opts) {
     // Back-compat: callers from 0.2.x passed ResolvedSeoOptions directly.
     const normalized = 'config' in opts && 'site' in opts.config
@@ -15,23 +40,36 @@ export function growthLabsSeoPlugin(opts) {
             if (id === VIRTUAL_MODULE_ID) {
                 return RESOLVED_VIRTUAL_MODULE_ID;
             }
+            if (id === VIRTUAL_LITE_ID) {
+                return RESOLVED_VIRTUAL_LITE_ID;
+            }
         },
         load(id) {
-            if (id !== RESOLVED_VIRTUAL_MODULE_ID)
+            if (id !== RESOLVED_VIRTUAL_MODULE_ID && id !== RESOLVED_VIRTUAL_LITE_ID)
                 return;
+            // `config` always seeds the provider (when a module is wired). `config-lite`
+            // seeds the provider only in NON-static modes (see the module comment): in
+            // static mode it must stay provider-free so the always-runtime middleware
+            // doesn't drag the content store into the deployed Worker; in non-static
+            // modes the middleware needs the provider at runtime, so config-lite seeds
+            // it deterministically at the middleware's own load.
+            const aeo = resolveAeoTwins(config.aeoTwins);
+            const staticMode = (!aeo || aeo.mode === 'static') && !config.flexibleSampling.enabled;
+            const isLite = id === RESOLVED_VIRTUAL_LITE_ID;
+            const withProvider = Boolean(contentProviderModule) && (!isLite || !staticMode);
             // The generated module seeds state via side-effect at import time.
-            // Routes/middleware that `import 'virtual:growth-labs/seo/config'` before
-            // calling getConfig() populate state in whatever environment they run —
-            // the main Worker AND the Cloudflare prerender worker.
+            // Routes/middleware that import it before calling getConfig() populate
+            // state in whatever environment they run — the main Worker AND the
+            // Cloudflare prerender worker.
             const lines = [
-                `import { _setConfig, _setContentProvider } from '@growth-labs/seo/_internal/state';`,
+                `import { _setConfig${withProvider ? ', _setContentProvider' : ''} } from '@growth-labs/seo/_internal/state';`,
             ];
-            if (contentProviderModule) {
+            if (withProvider) {
                 lines.push(`import _cp from ${JSON.stringify(contentProviderModule)};`);
             }
             lines.push(`const config = ${JSON.stringify(staticConfig)};`);
             lines.push(`_setConfig(config);`);
-            if (contentProviderModule) {
+            if (withProvider) {
                 lines.push(`_setContentProvider(_cp);`);
             }
             lines.push(`export { config };`);

package/dist/vite-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin.js","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAGA,MAAM,iBAAiB,GAAG,gCAAgC,CAAA;AAC1D,MAAM,0BAA0B,GAAG,KAAK,iBAAiB,EAAE,CAAA;AAiB3D,MAAM,UAAU,mBAAmB,CAAC,IAA+C;IAClF,sEAAsE;IACtE,MAAM,UAAU,GACf,QAAQ,IAAI,IAAI,IAAI,MAAM,IAAK,IAA6B,CAAC,MAAM;QAClE,CAAC,CAAE,IAA6B;QAChC,CAAC,CAAC,EAAE,MAAM,EAAE,IAA0B,EAAE,CAAA;IAE1C,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,GAAG,UAAU,CAAA;IACpD,uEAAuE;IACvE,2CAA2C;IAC3C,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,MAAiC,CAAA;IAEjF,OAAO;QACN,IAAI,EAAE,wBAAwB;QAC9B,SAAS,CAAC,EAAE;YACX,IAAI,EAAE,KAAK,iBAAiB,EAAE,CAAC;gBAC9B,OAAO,0BAA0B,CAAA;YAClC,CAAC;QACF,CAAC;QACD,IAAI,CAAC,EAAE;YACN,IAAI,EAAE,KAAK,0BAA0B;gBAAE,OAAM;YAE7C,mEAAmE;YACnE,0EAA0E;YAC1E,wEAAwE;YACxE,uDAAuD;YACvD,MAAM,KAAK,GAAa;gBACvB,qFAAqF;aACrF,CAAA;YACD,IAAI,qBAAqB,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAA;YACxE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;YAC7D,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;YACjC,IAAI,qBAAqB,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;YACxC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;YAChC,KAAK,CAAC,IAAI,CACT,mFAAmF,CACnF,CAAA;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC;KACD,CAAA;AACF,CAAC"}
+{"version":3,"file":"vite-plugin.js","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,eAAe,EAAE,MAAM,cAAc,CAAA;AAEvE,MAAM,iBAAiB,GAAG,gCAAgC,CAAA;AAC1D,MAAM,0BAA0B,GAAG,KAAK,iBAAiB,EAAE,CAAA;AAE3D,+EAA+E;AAC/E,kFAAkF;AAClF,kEAAkE;AAClE,EAAE;AACF,iFAAiF;AACjF,iFAAiF;AACjF,qFAAqF;AACrF,kFAAkF;AAClF,gFAAgF;AAChF,+EAA+E;AAC/E,iFAAiF;AACjF,qCAAqC;AACrC,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,kFAAkF;AAClF,+EAA+E;AAC/E,kFAAkF;AAClF,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,wBAAwB;AACxB,MAAM,eAAe,GAAG,qCAAqC,CAAA;AAC7D,MAAM,wBAAwB,GAAG,KAAK,eAAe,EAAE,CAAA;AAiBvD,MAAM,UAAU,mBAAmB,CAAC,IAA+C;IAClF,sEAAsE;IACtE,MAAM,UAAU,GACf,QAAQ,IAAI,IAAI,IAAI,MAAM,IAAK,IAA6B,CAAC,MAAM;QAClE,CAAC,CAAE,IAA6B;QAChC,CAAC,CAAC,EAAE,MAAM,EAAE,IAA0B,EAAE,CAAA;IAE1C,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,GAAG,UAAU,CAAA;IACpD,uEAAuE;IACvE,2CAA2C;IAC3C,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,MAAiC,CAAA;IAEjF,OAAO;QACN,IAAI,EAAE,wBAAwB;QAC9B,SAAS,CAAC,EAAE;YACX,IAAI,EAAE,KAAK,iBAAiB,EAAE,CAAC;gBAC9B,OAAO,0BAA0B,CAAA;YAClC,CAAC;YACD,IAAI,EAAE,KAAK,eAAe,EAAE,CAAC;gBAC5B,OAAO,wBAAwB,CAAA;YAChC,CAAC;QACF,CAAC;QACD,IAAI,CAAC,EAAE;YACN,IAAI,EAAE,KAAK,0BAA0B,IAAI,EAAE,KAAK,wBAAwB;gBAAE,OAAM;YAEhF,6EAA6E;YAC7E,2EAA2E;YAC3E,0EAA0E;YAC1E,yEAAyE;YACzE,2EAA2E;YAC3E,qDAAqD;YACrD,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YAC5C,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAA;YACtF,MAAM,MAAM,GAAG,EAAE,KAAK,wBAAwB,CAAA;YAC9C,MAAM,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,CAAA;YAE/E,mEAAmE;YACnE,uEAAuE;YACvE,mEAAmE;YACnE,+BAA+B;YAC/B,MAAM,KAAK,GAAa;gBACvB,sBAAsB,YAAY,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,6CAA6C;aAC9G,CAAA;YACD,IAAI,YAAY,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAA;YACxE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;YAC7D,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;YACjC,IAAI,YAAY,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;YACxC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;YAChC,KAAK,CAAC,IAAI,CACT,mFAAmF,CACnF,CAAA;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC;KACD,CAAA;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growth-labs/seo",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -73,7 +73,7 @@
     "astro": "^6.1.10",
     "typescript": "^5.7.0",
     "vite": "^7.3.2",
-    "vitest": "^3.0.0"
+    "vitest": "^4.1.8"
   },
   "scripts": {
     "build": "tsc",

package/src/components/AeoHead.astro

@@ -1,7 +1,10 @@
 ---
 // Side-effect: seeds state in whatever environment Vite bundles for.
-// Required so `getConfig()` works in the Cloudflare prerender Worker.
-import 'virtual:growth-labs/seo/config'
+// Required so `getConfig()` works in the Cloudflare prerender Worker. Uses the
+// provider-free (in static mode) `config-lite` twin — AeoHead only reads
+// getConfig()/resolveAeoTwins(), never getContentProvider() — so it doesn't drag
+// the content store into an SSR page that renders this head component.
+import 'virtual:growth-labs/seo/config-lite'
 
 // Use package self-imports (not relative ../options.js / ../state.js) because
 // this component ships as source from src/components/ but options.ts and state.ts

package/src/components/SeoHead.astro

@@ -20,7 +20,11 @@
 // Centralizing here eliminates that class of bug across ~12 sites.
 //
 // Side-effect import seeds state in both main and Cloudflare prerender Workers.
-import 'virtual:growth-labs/seo/config'
+// SeoHead only reads getConfig() — never getContentProvider() — so it imports the
+// mode-aware `config-lite` twin. In static mode that keeps the contentProvider (and
+// the content store) out of any SSR page that renders this layout; the feed/AEO
+// routes that DO need the provider import the full `config` themselves.
+import 'virtual:growth-labs/seo/config-lite'
 
 import { getConfig, type ContentItem } from '@growth-labs/seo'
 import { resolveSeoConfig } from '@growth-labs/seo/site-url'

package/src/index.ts

@@ -89,53 +89,83 @@ export default function seo(userOptions: SeoOptions): AstroIntegration {
 
 				const injected: string[] = []
 				const skipped: Array<{ pattern: string; reason: string }> = []
+				const injectedRoutes = options.injectedRoutes
 
-				// ─── Sitemaps (provider-wired gated) ───
-				if (providerWired) {
-					injectRoute({
-						pattern: SITEMAP_INDEX_PATH,
-						entrypoint: resolveEntrypoint('./routes/sitemap-index'),
-						prerender: false,
-					})
-					injected.push(SITEMAP_INDEX_PATH)
-					injectRoute({
-						pattern: '/sitemap-articles.xml',
-						entrypoint: resolveEntrypoint('./routes/sitemap-articles'),
-						prerender: false,
-					})
-					injected.push('/sitemap-articles.xml')
+				// ─── Prerender content routes in static mode ───
+				// The injected feed/sitemap/llms routes call the contentProvider, which
+				// (for content-layer-backed providers) transitively imports `astro:content`
+				// and the entire content store. As SSR (`prerender: false`) routes, that
+				// store ships in the DEPLOYED Worker — on a large catalog this blows
+				// Cloudflare's 10 MB Worker size limit. In "static" mode the feeds carry
+				// no per-request variation, so we prerender them: the provider runs in the
+				// build-time prerender Worker and the feeds are emitted as static Assets
+				// (which are NOT counted against the Worker size limit). Non-static modes
+				// (aeo 'middleware'/'both', flexibleSampling) keep SSR behavior unchanged —
+				// they genuinely branch per request and the middleware needs the provider.
+				//
+				// NOTE: the route modules must NOT carry a literal `export const prerender`
+				// — Astro's regex scanner would override this injected value. They were
+				// stripped of that export so this flag is authoritative.
+				const prerenderContentRoutes =
+					(!aeo || aeo.mode === 'static') && !options.flexibleSampling.enabled
+
+				const injectSeoRoute = (pattern: string, entrypoint: string) => {
 					injectRoute({
-						pattern: '/sitemap-pages.xml',
-						entrypoint: resolveEntrypoint('./routes/sitemap-pages'),
-						prerender: false,
+						pattern,
+						entrypoint: resolveEntrypoint(entrypoint),
+						prerender: prerenderContentRoutes,
 					})
-					injected.push('/sitemap-pages.xml')
-					injectRoute({
-						pattern: '/sitemap-videos.xml',
-						entrypoint: resolveEntrypoint('./routes/sitemap-videos'),
-						prerender: false,
+					injected.push(pattern)
+				}
+
+				const skipDisabledRoute = (pattern: string, optionName: string) => {
+					skipped.push({
+						pattern,
+						reason: `injectedRoutes.${optionName} is false`,
 					})
-					injected.push('/sitemap-videos.xml')
-					if (options.commerce?.enabled) {
-						injectRoute({
-							pattern: '/sitemap-products.xml',
-							entrypoint: resolveEntrypoint('./routes/sitemap-products'),
-							prerender: false,
-						})
-						injected.push('/sitemap-products.xml')
+				}
+
+				// ─── Sitemaps (provider-wired gated) ───
+				if (providerWired) {
+					if (injectedRoutes.sitemapIndex) {
+						injectSeoRoute(SITEMAP_INDEX_PATH, './routes/sitemap-index')
+					} else {
+						skipDisabledRoute(SITEMAP_INDEX_PATH, 'sitemapIndex')
+					}
+
+					if (injectedRoutes.sitemapArticles) {
+						injectSeoRoute('/sitemap-articles.xml', './routes/sitemap-articles')
+					} else {
+						skipDisabledRoute('/sitemap-articles.xml', 'sitemapArticles')
+					}
+
+					if (injectedRoutes.sitemapPages) {
+						injectSeoRoute('/sitemap-pages.xml', './routes/sitemap-pages')
+					} else {
+						skipDisabledRoute('/sitemap-pages.xml', 'sitemapPages')
+					}
+
+					if (injectedRoutes.sitemapVideos) {
+						injectSeoRoute('/sitemap-videos.xml', './routes/sitemap-videos')
+					} else {
+						skipDisabledRoute('/sitemap-videos.xml', 'sitemapVideos')
+					}
+
+					if (!injectedRoutes.sitemapProducts) {
+						skipDisabledRoute('/sitemap-products.xml', 'sitemapProducts')
+					} else if (options.commerce?.enabled) {
+						injectSeoRoute('/sitemap-products.xml', './routes/sitemap-products')
 					} else {
 						skipped.push({
 							pattern: '/sitemap-products.xml',
 							reason: 'commerce.enabled is false',
 						})
 					}
-					if (options.markdownSitemap && aeo && aeo.mode !== 'middleware') {
-						injectRoute({
-							pattern: '/sitemap-markdown.xml',
-							entrypoint: resolveEntrypoint('./routes/sitemap-markdown'),
-							prerender: false,
-						})
-						injected.push('/sitemap-markdown.xml')
+
+					if (!injectedRoutes.sitemapMarkdown) {
+						skipDisabledRoute('/sitemap-markdown.xml', 'sitemapMarkdown')
+					} else if (options.markdownSitemap && aeo && aeo.mode !== 'middleware') {
+						injectSeoRoute('/sitemap-markdown.xml', './routes/sitemap-markdown')
 					} else if (options.markdownSitemap) {
 						skipped.push({
 							pattern: '/sitemap-markdown.xml',
@@ -165,7 +195,7 @@ export default function seo(userOptions: SeoOptions): AstroIntegration {
 					injectRoute({
 						pattern: '/robots.txt',
 						entrypoint: resolveEntrypoint('./routes/robots'),
-						prerender: false,
+						prerender: prerenderContentRoutes,
 					})
 					injected.push('/robots.txt')
 				} else {
@@ -181,7 +211,7 @@ export default function seo(userOptions: SeoOptions): AstroIntegration {
 					injectRoute({
 						pattern: '/llms.txt',
 						entrypoint: resolveEntrypoint('./routes/llms'),
-						prerender: false,
+						prerender: prerenderContentRoutes,
 					})
 					injected.push('/llms.txt')
 				}
@@ -189,7 +219,7 @@ export default function seo(userOptions: SeoOptions): AstroIntegration {
 					injectRoute({
 						pattern: '/llms-full.txt',
 						entrypoint: resolveEntrypoint('./routes/llms-full'),
-						prerender: false,
+						prerender: prerenderContentRoutes,
 					})
 					injected.push('/llms-full.txt')
 				}
@@ -199,7 +229,7 @@ export default function seo(userOptions: SeoOptions): AstroIntegration {
 					injectRoute({
 						pattern: '/feed.xml',
 						entrypoint: resolveEntrypoint('./routes/rss'),
-						prerender: false,
+						prerender: prerenderContentRoutes,
 					})
 					injected.push('/feed.xml')
 				}
@@ -209,7 +239,7 @@ export default function seo(userOptions: SeoOptions): AstroIntegration {
 					injectRoute({
 						pattern: options.appleNews.feedPath,
 						entrypoint: resolveEntrypoint('./routes/apple-news'),
-						prerender: false,
+						prerender: prerenderContentRoutes,
 					})
 					injected.push(options.appleNews.feedPath)
 				}
@@ -219,7 +249,7 @@ export default function seo(userOptions: SeoOptions): AstroIntegration {
 					injectRoute({
 						pattern: options.podcast.feedPath,
 						entrypoint: resolveEntrypoint('./routes/podcast'),
-						prerender: false,
+						prerender: prerenderContentRoutes,
 					})
 					injected.push(options.podcast.feedPath)
 				}
@@ -229,7 +259,7 @@ export default function seo(userOptions: SeoOptions): AstroIntegration {
 					injectRoute({
 						pattern: options.audioNarration.podcastFeedPath,
 						entrypoint: resolveEntrypoint('./routes/podcast-narration'),
-						prerender: false,
+						prerender: prerenderContentRoutes,
 					})
 					injected.push(options.audioNarration.podcastFeedPath)
 				}
@@ -282,8 +312,10 @@ export default function seo(userOptions: SeoOptions): AstroIntegration {
 				// Note: we try to load items here to check the guard, but this is
 				// best-effort. If contentProvider uses astro:content or other Vite
 				// virtuals, it will fail at raw-Node import time and we skip silently.
-				// The guard is a defence-in-depth check; the primary guarantee comes
-				// from the consumer-set `export const prerender = false` on gated routes.
+				// The guard is a defence-in-depth check. Note flexibleSampling forces
+				// non-static mode, so `prerenderContentRoutes` is false here and the
+				// injected content routes stay SSR (their prerender is controlled by the
+				// injectRoute flag above, not a literal `export const prerender`).
 				if (contentProvider && options.flexibleSampling?.enabled) {
 					try {
 						const items = await contentProvider({ type: 'articles' }, {} as never)
@@ -313,12 +345,17 @@ export default function seo(userOptions: SeoOptions): AstroIntegration {
 
 				for (const file of htmlFiles) {
 					const html = readFileSync(file, 'utf-8')
+					const relPath = file.replace(outDir, '')
 					const result = validatePage(html, {
 						titleMaxLength: options.validation.titleMaxLength,
 						descriptionMaxLength: options.validation.descriptionMaxLength,
 						heroMinWidth: options.validation.heroMinWidth,
+						pagePath: relPath,
+						requireH1: options.validation.requireH1,
+						requireHeroImage: options.validation.requireHeroImage,
+						requireArticleSchema: options.validation.requireArticleSchema,
+						requireMaxImagePreviewLarge: options.validation.requireMaxImagePreviewLarge,
 					})
-					const relPath = file.replace(outDir, '')
 					for (const error of result.errors) {
 						logger.error(`${relPath}: ${error}`)
 						errorCount++
@@ -352,6 +389,9 @@ export default function seo(userOptions: SeoOptions): AstroIntegration {
 
 				if (errorCount || warningCount) {
 					logger.info(`SEO validation: ${errorCount} errors, ${warningCount} warnings`)
+					if (errorCount > 0) {
+						throw new Error(`[@growth-labs/seo] SEO validation failed with ${errorCount} errors`)
+					}
 				} else {
 					logger.info('SEO validation: all checks passed')
 				}

package/src/middleware/seo.ts

@@ -1,4 +1,13 @@
-import 'virtual:growth-labs/seo/config'
+// Provider-free config import: the middleware runs in the deployed Worker on
+// every request and only needs metadata-level lookups. Importing the
+// provider-bearing 'config' module here would pull the consumer's
+// contentProviderModule — and transitively `astro:content` plus the whole
+// content-layer store — into the runtime Worker, blowing Cloudflare's 10 MB
+// size limit on large catalogs. The provider is seeded separately by the
+// injected content routes (prerendered in static mode). getContentProvider()
+// returns undefined here in static mode, which the provider-gated branches
+// below already tolerate.
+import 'virtual:growth-labs/seo/config-lite'
 import { getConfig, getContentProvider } from '../_internal/state.js'
 import type { SeoEnv } from '../bindings.js'
 import { type ResolvedSeoOptions, resolveAeoTwins } from '../options.js'

package/src/options.ts

@@ -185,6 +185,19 @@ const crawlerPolicySchema = z
 	})
 	.default({})
 
+// ─── Injected route ownership ───
+
+const injectedRoutesSchema = z
+	.object({
+		sitemapIndex: z.boolean().default(true),
+		sitemapArticles: z.boolean().default(true),
+		sitemapPages: z.boolean().default(true),
+		sitemapVideos: z.boolean().default(true),
+		sitemapProducts: z.boolean().default(true),
+		sitemapMarkdown: z.boolean().default(true),
+	})
+	.default({})
+
 // ─── Main schema ───
 
 const siteUrlSchema = z.union([
@@ -217,6 +230,10 @@ export const seoOptionsSchema = z.object({
 	markdownSitemap: z.boolean().default(true),
 	rss: z.boolean().default(false),
 
+	// ─── Injected route ownership ───
+	// Set a route false when the consumer application owns that public path.
+	injectedRoutes: injectedRoutesSchema,
+
 	// ─── AEO twins ───
 	// Boolean form = { mode: 'static' } when true, no twins emitted when false.
 	aeoTwins: z.union([z.boolean(), aeoTwinsObjectSchema]).default(false),
@@ -269,6 +286,10 @@ export const seoOptionsSchema = z.object({
 			heroMinWidth: z.number().default(1200),
 			titleMaxLength: z.number().default(110),
 			descriptionMaxLength: z.number().default(160),
+			requireH1: z.boolean().default(true),
+			requireHeroImage: z.boolean().default(true),
+			requireArticleSchema: z.boolean().default(true),
+			requireMaxImagePreviewLarge: z.boolean().default(true),
 			enabled: z.boolean().default(true),
 		})
 		.default({}),

package/src/routes/apple-news.ts

@@ -5,8 +5,6 @@ import { resolveSeoConfig } from '../site-url.js'
 import type { ContentItem } from '../types.js'
 import { generateAppleNewsRss } from '../utils/apple-news-rss.js'
 
-export const prerender = false
-
 export const GET: APIRoute = async (context) => {
 	const config = resolveSeoConfig(getConfig())
 	const contentProvider = getContentProvider()

package/src/routes/llms-full.ts

@@ -4,8 +4,6 @@ import { getConfig, getContentProvider } from '../_internal/state.js'
 import type { ContentItem } from '../types.js'
 import { generateLlmsFull } from '../utils/llms-full.js'
 
-export const prerender = false
-
 export const GET: APIRoute = async (context) => {
 	const config = getConfig()
 	const contentProvider = getContentProvider()

package/src/routes/llms.ts

@@ -3,8 +3,6 @@ import type { APIRoute } from 'astro'
 import { getConfig } from '../_internal/state.js'
 import { generateLlmsTxt } from '../utils/llms.js'
 
-export const prerender = false
-
 export const GET: APIRoute = async () => {
 	const config = getConfig()
 	const txt = generateLlmsTxt(config)

package/src/routes/podcast-narration.ts

@@ -5,8 +5,6 @@ import { resolveSeoConfig } from '../site-url.js'
 import type { ContentItem } from '../types.js'
 import { generatePodcastFeed } from '../utils/podcast.js'
 
-export const prerender = false
-
 export const GET: APIRoute = async (context) => {
 	const config = resolveSeoConfig(getConfig())
 	const contentProvider = getContentProvider()

package/src/routes/podcast.ts

@@ -5,8 +5,6 @@ import { resolveSeoConfig } from '../site-url.js'
 import type { ContentItem } from '../types.js'
 import { generatePodcastFeed } from '../utils/podcast.js'
 
-export const prerender = false
-
 export const GET: APIRoute = async (context) => {
 	const config = resolveSeoConfig(getConfig())
 	const contentProvider = getContentProvider()

package/src/routes/robots.ts

@@ -4,8 +4,6 @@ import { getConfig, getContentProvider } from '../_internal/state.js'
 import { resolveSeoConfig } from '../site-url.js'
 import { generateRobotsTxt } from '../utils/robots.js'
 
-export const prerender = false
-
 export const GET: APIRoute = async () => {
 	const config = resolveSeoConfig(getConfig())
 	// The sitemap-index route is only injected when a content provider is wired.

package/src/routes/rss.ts

@@ -6,8 +6,6 @@ import type { ContentItem } from '../types.js'
 import { forRss } from '../utils/content-filter.js'
 import { generateRssFeed } from '../utils/rss.js'
 
-export const prerender = false
-
 export const GET: APIRoute = async (context) => {
 	const config = resolveSeoConfig(getConfig())
 	const contentProvider = getContentProvider()

package/src/routes/sitemap-articles.ts

@@ -4,8 +4,6 @@ import { getConfig, getContentProvider } from '../_internal/state.js'
 import type { ContentItem } from '../types.js'
 import { generateArticleSitemap } from '../utils/sitemap.js'
 
-export const prerender = false
-
 export const GET: APIRoute = async (context) => {
 	const config = getConfig()
 	const contentProvider = getContentProvider()

package/src/routes/sitemap-index.ts

@@ -5,8 +5,6 @@ import { resolveSeoConfig } from '../site-url.js'
 import type { SitemapEntry } from '../utils/sitemap.js'
 import { generateSitemapIndex } from '../utils/sitemap.js'
 
-export const prerender = false
-
 export const GET: APIRoute = async (context) => {
 	const config = resolveSeoConfig(getConfig())
 	const contentProvider = getContentProvider()
@@ -14,6 +12,7 @@ export const GET: APIRoute = async (context) => {
 	const sitemaps: SitemapEntry[] = []
 
 	const { site } = config
+	const injectedRoutes = config.injectedRoutes
 
 	// Fetch articles lastmod if possible
 	let articlesLastmod: string | undefined
@@ -22,43 +21,49 @@ export const GET: APIRoute = async (context) => {
 	let productsLastmod: string | undefined
 
 	if (contentProvider) {
-		try {
-			const articles = await contentProvider({ type: 'articles' }, context as any)
-			if (articles.length > 0) {
-				const dates = articles
-					.map((a) => a.dateModified ?? a.datePublished)
-					.filter(Boolean) as string[]
-				if (dates.length > 0) {
-					articlesLastmod = dates.sort().at(-1)
+		if (injectedRoutes.sitemapArticles) {
+			try {
+				const articles = await contentProvider({ type: 'articles' }, context as any)
+				if (articles.length > 0) {
+					const dates = articles
+						.map((a) => a.dateModified ?? a.datePublished)
+						.filter(Boolean) as string[]
+					if (dates.length > 0) {
+						articlesLastmod = dates.sort().at(-1)
+					}
 				}
-			}
-		} catch {}
+			} catch {}
+		}
 
-		try {
-			const pages = await contentProvider({ type: 'pages' }, context as any)
-			if (pages.length > 0) {
-				const dates = pages
-					.map((p) => p.dateModified ?? p.datePublished)
-					.filter(Boolean) as string[]
-				if (dates.length > 0) {
-					pagesLastmod = dates.sort().at(-1)
+		if (injectedRoutes.sitemapPages) {
+			try {
+				const pages = await contentProvider({ type: 'pages' }, context as any)
+				if (pages.length > 0) {
+					const dates = pages
+						.map((p) => p.dateModified ?? p.datePublished)
+						.filter(Boolean) as string[]
+					if (dates.length > 0) {
+						pagesLastmod = dates.sort().at(-1)
+					}
 				}
-			}
-		} catch {}
+			} catch {}
+		}
 
-		try {
-			const videos = await contentProvider({ type: 'videos' }, context as any)
-			if (videos.length > 0) {
-				const dates = videos
-					.map((v) => v.dateModified ?? v.datePublished)
-					.filter(Boolean) as string[]
-				if (dates.length > 0) {
-					videosLastmod = dates.sort().at(-1)
+		if (injectedRoutes.sitemapVideos) {
+			try {
+				const videos = await contentProvider({ type: 'videos' }, context as any)
+				if (videos.length > 0) {
+					const dates = videos
+						.map((v) => v.dateModified ?? v.datePublished)
+						.filter(Boolean) as string[]
+					if (dates.length > 0) {
+						videosLastmod = dates.sort().at(-1)
+					}
 				}
-			}
-		} catch {}
+			} catch {}
+		}
 
-		if (config.commerce?.enabled) {
+		if (config.commerce?.enabled && injectedRoutes.sitemapProducts) {
 			try {
 				const products = await contentProvider({ type: 'products' }, context as any)
 				if (products.length > 0) {
@@ -73,11 +78,17 @@ export const GET: APIRoute = async (context) => {
 		}
 	}
 
-	sitemaps.push({ loc: `${site}/sitemap-articles.xml`, lastmod: articlesLastmod })
-	sitemaps.push({ loc: `${site}/sitemap-pages.xml`, lastmod: pagesLastmod })
-	sitemaps.push({ loc: `${site}/sitemap-videos.xml`, lastmod: videosLastmod })
+	if (injectedRoutes.sitemapArticles) {
+		sitemaps.push({ loc: `${site}/sitemap-articles.xml`, lastmod: articlesLastmod })
+	}
+	if (injectedRoutes.sitemapPages) {
+		sitemaps.push({ loc: `${site}/sitemap-pages.xml`, lastmod: pagesLastmod })
+	}
+	if (injectedRoutes.sitemapVideos) {
+		sitemaps.push({ loc: `${site}/sitemap-videos.xml`, lastmod: videosLastmod })
+	}
 
-	if (config.commerce?.enabled) {
+	if (config.commerce?.enabled && injectedRoutes.sitemapProducts) {
 		sitemaps.push({ loc: `${site}/sitemap-products.xml`, lastmod: productsLastmod })
 	}
 

package/src/routes/sitemap-markdown.ts

@@ -5,8 +5,6 @@ import { resolveAeoTwins } from '../options.js'
 import type { ContentItem } from '../types.js'
 import { generateMarkdownSitemap } from '../utils/sitemap-markdown.js'
 
-export const prerender = false
-
 export const GET: APIRoute = async (context) => {
 	const config = getConfig()
 	const contentProvider = getContentProvider()