@farm.js/core 0.1.51-beta.0 → 0.1.51-beta.2

package/dist/{chunk-AMRK3P6W.mjs → chunk-4SSRBCBR.mjs}

@@ -13,23 +13,28 @@ import {
 import {
   generateNativeMCPPluginSource
 } from "./chunk-KQH2COEJ.mjs";
+import {
+  FARM_MOBILE_SESSION_PLUGIN
+} from "./chunk-C3BOESDW.mjs";
 import {
   assertFarmDocsAdapterServesNoGuardedPages,
   compileFarmDocsAdapterEdgeManifest,
   createFarmDocsAPIHandler,
-  hasFarmDocsRuntimeAdapter
-} from "./chunk-3HA7PP72.mjs";
+  hasFarmDocsRuntimeAdapter,
+  listFarmDocsAdapterPages
+} from "./chunk-FM2UEKS2.mjs";
 import {
   FARM_DOCS_LAST_MODIFIED_MANIFEST,
   createFarmDocsHandler,
   createFarmDocsLastModifiedManifest,
   discoverFarmDocsPages,
   getFarmDocsMarkdownPath,
+  getFarmDocsRoots,
   getFarmDocsRouteTypeEntries,
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-4GJJ65RB.mjs";
+} from "./chunk-EIMK7D2D.mjs";
 import {
   generateFarmDocsSearchClientRuntime,
   isFarmDocsSearchEnabled,
@@ -37,7 +42,7 @@ import {
 } from "./chunk-ALEUMLJN.mjs";
 import {
   FARM_PRERENDER_ENV
-} from "./chunk-YLNBWUVS.mjs";
+} from "./chunk-E6LTONL4.mjs";
 import {
   resolveFarmInstrumentationFile
 } from "./chunk-N35YPV4N.mjs";
@@ -52,7 +57,7 @@ import {
   getDeployTargetForPreset,
   hasCustomFarmRouteContext,
   resolveDeployOutputPath
-} from "./chunk-JF5CNHHF.mjs";
+} from "./chunk-CTM4SPB3.mjs";
 import {
   DEFAULT_NOT_FOUND_STYLES,
   FARM_LAYOUT_ELEMENT_CLIENT_SOURCE,
@@ -84,7 +89,7 @@ import {
   resolveFarmIsolatedClientHydrationMode,
   resolveFarmNotFoundComponentPath,
   usesFarmServerTree
-} from "./chunk-S5ZA2T2W.mjs";
+} from "./chunk-PMKUU273.mjs";
 import {
   loadTailwindVitePlugin
 } from "./chunk-PIHKO25G.mjs";
@@ -95,7 +100,7 @@ import {
   generateFarmTypeArtifacts,
   readRouteRenderingDirectiveFromFile,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-WVX3BUNJ.mjs";
+} from "./chunk-CZ35L6PL.mjs";
 import {
   HOISTED_HEAD_ELEMENT,
   appMiddlewareMayHandlePath,
@@ -122,7 +127,7 @@ import {
   listFarmBuiltInRoutePaths,
   resolveFarmApiCatalogInput,
   resolveFarmAppManifestInput
-} from "./chunk-R5P4KFPM.mjs";
+} from "./chunk-E73PGHSR.mjs";
 import {
   FARM_DEFAULT_MCP_PATH,
   createFarmDefaultMCPServer,
@@ -130,7 +135,7 @@ import {
 } from "./chunk-KRRZJ77U.mjs";
 import {
   farmEnvironmentFunctionsPlugin
-} from "./chunk-C5JXCUKR.mjs";
+} from "./chunk-ZQ5BDNKW.mjs";
 import {
   isFarmMarkdownPageFile
 } from "./chunk-GW4YUIHW.mjs";
@@ -193,7 +198,7 @@ import {
 import {
   getFarmIntegrationPluginServerRuntime,
   getIntegrationProviders
-} from "./chunk-HHFMECFO.mjs";
+} from "./chunk-Y2G5SJFB.mjs";
 import {
   FARM_INTEGRATION_API_BASE_PATH_KEY
 } from "./chunk-F6TLUMH7.mjs";
@@ -231,7 +236,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-ZF3GX4O7.mjs";
+} from "./chunk-6CYQQQGR.mjs";
 import {
   getFarmPresetRuntime
 } from "./chunk-UAQD67HM.mjs";
@@ -1682,15 +1687,14 @@ function createServerChunkMinifyPlugin(options) {
 function trimSlashes(value) {
   return value.replace(/^\/+|\/+$/g, "");
 }
-function resolveBuildDocsContentDir(config, root) {
-  if (!config.docs?.enabled) return null;
-  const configuredContentDir = config.docs.contentDir || config.docs.config.contentDir;
+function resolveBuildDocsContentDir(docs, root, srcDir) {
+  const configuredContentDir = docs.contentDir || docs.config.contentDir;
   if (typeof configuredContentDir === "string" && configuredContentDir.trim()) {
     const contentDir = path10.isAbsolute(configuredContentDir) ? configuredContentDir : path10.join(root, configuredContentDir);
     return existsSync2(contentDir) ? contentDir : null;
   }
-  const entryDir = config.docs.config.entry || trimSlashes(config.docs.entry) || "docs";
-  const appDocsDir = path10.join(root, config.srcDir || "src", "app", entryDir);
+  const entryDir = docs.config.entry || trimSlashes(docs.entry) || "docs";
+  const appDocsDir = path10.join(root, srcDir || "src", "app", entryDir);
   if (existsSync2(appDocsDir)) return appDocsDir;
   const rootDocsDir = path10.join(root, entryDir);
   return existsSync2(rootDocsDir) ? rootDocsDir : null;
@@ -1754,7 +1758,9 @@ function hasFarmPluginRoutes(config) {
 }
 function farmServerRuntimePluginsMayHandlePath(config, pathname) {
   return (config.plugins || []).some(
-    (plugin) => getFarmIntegrationPluginServerRuntime(plugin) !== false && farmPluginMayAffectRuntimePath(plugin, pathname)
+    (plugin) => getFarmIntegrationPluginServerRuntime(plugin) !== false && // Mobile session tokens change only bearer requests and cookie-clearing responses, which a
+    // prerendered file never answers or sends; its endpoints live under /__farm/.
+    plugin.name !== FARM_MOBILE_SESSION_PLUGIN && farmPluginMayAffectRuntimePath(plugin, pathname)
   );
 }
 async function discoverMiddlewareRoutes(appDir) {
@@ -2212,9 +2218,12 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   const adapterOwnsDocsRuntime = Boolean(
     isReactRenderer(config.renderer) && config.docs?.enabled && config.docs.adapter?.server && config.docs.adapter.react
   );
-  const adapterDocsEntry = config.docs?.enabled ? `/${config.docs.entry || "docs"}`.replace(/\/+/g, "/").replace(/\/$/, "") || "/" : null;
-  const isAdapterDocsRoute = (routePattern) => Boolean(
-    adapterOwnsDocsRuntime && adapterDocsEntry && (adapterDocsEntry === "/" || routePattern === adapterDocsEntry || routePattern.startsWith(`${adapterDocsEntry}/`))
+  const docsEntries = config.docs?.enabled ? getFarmDocsRoots(config.docs).map(
+    (docsRoot) => `/${docsRoot.entry || "docs"}`.replace(/\/+/g, "/").replace(/\/$/, "") || "/"
+  ) : [];
+  const adapterDocsEntry = docsEntries[0] ?? null;
+  const isAdapterDocsRoute = (routePattern) => adapterOwnsDocsRuntime && docsEntries.some(
+    (docsEntry) => docsEntry === "/" || routePattern === docsEntry || routePattern.startsWith(`${docsEntry}/`)
   );
   const syntheticDocsEntry = config.docs?.enabled && !adapterOwnsDocsRuntime ? adapterDocsEntry : null;
   const syntheticDocsPatterns = syntheticDocsEntry ? syntheticDocsEntry === "/" ? ["/", "/[...slug]"] : [syntheticDocsEntry, `${syntheticDocsEntry}/[...slug]`] : [];
@@ -2264,7 +2273,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     layoutAppliesToRoute
   );
   for (const layout of clientLayouts) {
-    const matchesBuiltRoute = pageRoutes.some((route) => layoutAppliesToRoute(layout.pattern, routeDirectory(route))) || Boolean(adapterDocsEntry && layoutAppliesToRoute(layout.pattern, adapterDocsEntry));
+    const matchesBuiltRoute = pageRoutes.some((route) => layoutAppliesToRoute(layout.pattern, routeDirectory(route))) || docsEntries.some((docsEntry) => layoutAppliesToRoute(layout.pattern, docsEntry));
     if (matchesBuiltRoute && layout.suppressedAsyncHydration) {
       logger.warn(`\u26A0\uFE0F  ${describeSuppressedAsyncHydration(layout.pattern, layout.fallbackReason)}`);
     }
@@ -2372,7 +2381,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     srcDir,
     adapterOwnsDocsRuntime ? false : isFarmDocsSearchEnabled(config.docs),
     adapterOwnsDocsRuntime ? void 0 : resolveFarmDocsSearchClientModule(root),
-    config.docs?.enabled ? config.docs.entry : void 0,
+    config.docs?.enabled ? getFarmDocsRoots(config.docs).map((docsRoot) => docsRoot.entry) : void 0,
     adapterOwnsDocsRuntime ? config.docs.adapter?.react : void 0,
     config.i18n,
     config.plugins,
@@ -2440,28 +2449,9 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
               return "assets/[name]-h[hash][extname]";
             }
           },
-          // Externalize Node.js built-ins and server-side modules for client build
+          // A browser cannot load a Node builtin: farmServerOnlyEntriesPlugin
+          // resolves one to Farm's browser module for it instead.
           external: (id) => {
-            if (id.startsWith("node:") || [
-              "path",
-              "url",
-              "fs",
-              "fs/promises",
-              "os",
-              "crypto",
-              "http",
-              "https",
-              "net",
-              "stream",
-              "util",
-              "events",
-              "child_process",
-              "module",
-              "tty",
-              "dns"
-            ].includes(id)) {
-              return true;
-            }
             if (id === "fsevents" || id.includes("fsevents") || id.endsWith(".node")) {
               return true;
             }
@@ -2657,21 +2647,24 @@ async function fetchFarmNavigationDocument(url, headers, recover = true, signal)
   return response;
 }
 
-${streamNavigations ? `const FARM_FLUSH_MARKER = "<!--farm-flush-->";
-
-// Reads a streamed navigation (F-Stream) up to the end of React's shell. \`next\` then resolves
+${streamNavigations ? `// Reads a streamed navigation (F-Stream) up to the end of React's shell. \`next\` then resolves
 // with each later flush as it ends, and null at the end; a document without a marker is all shell.
-async function readFarmNavigationStream(body) {
+// The marker carries the random token the server sent in the F-Flush header, so page content
+// cannot forge a boundary; a response without a valid token is all shell.
+async function readFarmNavigationStream(body, flushToken) {
   const reader = body.getReader();
   const decoder = new TextDecoder();
+  const marker = typeof flushToken === "string" && /^[0-9a-f]{32}$/.test(flushToken)
+    ? "<!--farm-flush:" + flushToken + "-->"
+    : "";
   let text = "";
   let done = false;
   const next = async function() {
     for (;;) {
-      const at = text.indexOf(FARM_FLUSH_MARKER);
+      const at = marker ? text.indexOf(marker) : -1;
       if (at !== -1) {
         const flush = text.slice(0, at);
-        text = text.slice(at + FARM_FLUSH_MARKER.length);
+        text = text.slice(at + marker.length);
         return flush;
       }
       if (done) {
@@ -3245,7 +3238,7 @@ ${streamNavigations ? `  // A streamed navigation swaps in the page's shell; its
         }
       };
 ${streamNavigations ? `      if (streamShell && response.body) {
-        const streamed = await readFarmNavigationStream(response.body);
+        const streamed = await readFarmNavigationStream(response.body, response.headers.get("F-Flush"));
         if (!streamed.next) {
           store(streamed.shell);
           return streamed.shell;
@@ -3524,8 +3517,18 @@ function isFarmLocaleDocumentChange() {
   return false;
 }
 `;
-  const docsNavigationRuntime = docsEntryPath ? `
-const farmDocsEntryPath = ${JSON.stringify(docsEntryPath)};
+  const docsEntryPaths = typeof docsEntryPath === "string" ? [docsEntryPath] : docsEntryPath ?? [];
+  const docsNavigationRuntime = docsEntryPaths.length > 1 ? `
+const farmDocsEntryPaths = ${JSON.stringify(docsEntryPaths)};
+function isFarmDocsPath(pathname) {
+  const routePathname = getFarmRoutePathname(pathname);
+  const normalizedPath = routePathname.length > 1 ? routePathname.replace(/\\/+$/, "") : routePathname;
+  return farmDocsEntryPaths.some(
+    (entryPath) => normalizedPath === entryPath || normalizedPath.startsWith(entryPath + "/"),
+  );
+}
+` : docsEntryPaths[0] ? `
+const farmDocsEntryPath = ${JSON.stringify(docsEntryPaths[0])};
 function isFarmDocsPath(pathname) {
   const routePathname = getFarmRoutePathname(pathname);
   const normalizedPath = routePathname.length > 1 ? routePathname.replace(/\\/+$/, "") : routePathname;
@@ -5571,15 +5574,14 @@ function readFarmPageLastModified(pageRoutes) {
 }
 function getFarmDocsGuardedPaths(config, middlewareRoutes) {
   if (!config.docs?.enabled) return [];
-  const contentDir = resolveFarmDocsContentDir(config.docs, {
-    root: config.root,
-    srcDir: config.srcDir
-  });
+  const options = { root: config.root, srcDir: config.srcDir };
   const guards = {
     config: { middleware: config.middleware, integrations: config.integrations },
     middlewareRoutes
   };
-  return discoverFarmDocsPages(contentDir, config.docs).flatMap((page) => [page.href, getFarmDocsMarkdownPath(page.href)]).filter((pathname) => farmPathGuardCoversPage(guards, pathname));
+  return getFarmDocsRoots(config.docs).flatMap(
+    (docsRoot) => discoverFarmDocsPages(resolveFarmDocsContentDir(docsRoot, options), docsRoot)
+  ).flatMap((page) => [page.href, getFarmDocsMarkdownPath(page.href)]).filter((pathname) => farmPathGuardCoversPage(guards, pathname));
 }
 function getFarmAppOwnedDocsEnginePaths(agent, applicationMetadataRoutes) {
   const llmsTxt = agent?.llmsTxt;
@@ -5593,10 +5595,34 @@ function getFarmAppOwnedDocsEnginePaths(agent, applicationMetadataRoutes) {
     ...agent?.crawlers?.enabled || ownedByFile("robots") ? ["/robots.txt"] : []
   ];
 }
+function generateFarmDocsAdapterHandlerArguments(docs, docsConfigModulePath) {
+  const runtimeConfig = (root) => `{
+  ${docsConfigModulePath ? `...getFarmDocsConfigModuleRoot(farmDocsConfigModule.default || farmDocsConfigModule, ${root}.entry),
+  ...${root}.configOverrides,` : `...${root}.config,`}
+  entry: ${root}.config?.entry || String(${root}.entry || "/docs").replace(/^\\/+|\\/+$/g, "") || "docs",
+  docsPath: ${root}.entry,
+  contentDir: ${root}.contentDir || ${root}.config?.contentDir,
+}`;
+  if (docs?.roots?.length) {
+    return {
+      factory: "createFarmDocsAdapterMultiRuntimeHandler",
+      config: `[farmDocsResolvedConfig, ...farmDocsResolvedConfig.roots].map((farmDocsRoot) => (${runtimeConfig("farmDocsRoot")}))`
+    };
+  }
+  return {
+    factory: "createFarmDocsAdapterRuntimeHandler",
+    config: runtimeConfig("farmDocsResolvedConfig")
+  };
+}
 function generateFarmDocsRuntimeConfigExpression(docs, precompiled = false) {
   if (!docs.enabled) return "null";
-  const baseConfig = {
+  const serializableDocs = docs.roots?.length ? {
     ...docs,
+    // React elements and functions do not survive JSON; see runtimeConfig below.
+    roots: docs.roots.map((docsRoot) => ({ ...docsRoot, runtimeConfig: void 0 }))
+  } : docs;
+  const baseConfig = {
+    ...serializableDocs,
     contentDir: void 0,
     ...precompiled ? { configPath: void 0 } : {},
     config: void 0,
@@ -5614,7 +5640,7 @@ function generateFarmDocsRuntimeConfigExpression(docs, precompiled = false) {
       config: nestedConfig
     });
   }
-  return `farmDocsBundledContentDir
+  const expression = `farmDocsBundledContentDir
   ? {
       ...${JSON.stringify(baseConfig)},
       contentDir: farmDocsBundledContentDir,
@@ -5623,7 +5649,19 @@ function generateFarmDocsRuntimeConfigExpression(docs, precompiled = false) {
         contentDir: farmDocsBundledContentDir,
       },
     }
-  : ${JSON.stringify({ ...docs, runtimeConfig: void 0 })}`;
+  : ${JSON.stringify({ ...serializableDocs, runtimeConfig: void 0 })}`;
+  if (!docs.roots?.length) return expression;
+  return `((farmDocs) => ({
+  ...farmDocs,
+  roots: farmDocs.roots.map((farmDocsRoot, index) => {
+    const contentDir = farmDocsBundledRootsDir
+      ? farmDocsJoin(farmDocsBundledRootsDir, String(index))
+      : null;
+    return contentDir && farmDocsExistsSync(contentDir)
+      ? { ...farmDocsRoot, contentDir, config: { ...farmDocsRoot.config, contentDir } }
+      : farmDocsRoot;
+  }),
+}))(${expression})`;
 }
 function toVirtualEntryImportSpecifier(modulePath) {
   return JSON.stringify(modulePath.replace(/\\/g, "/"));
@@ -5938,7 +5976,13 @@ function generateVirtualEntryCode(apiRoutes, pageRoutes, layoutRoutes, routeSlot
   const adapterOwnsDocsRuntime = Boolean(
     isReactRenderer(config.renderer) && config.docs?.enabled && config.docs.adapter?.server && config.docs.adapter.react
   );
+  if (config.docs?.enabled && config.docs.roots?.length && !adapterOwnsDocsRuntime) {
+    throw new Error(
+      "Several docs roots need the docs adapter, which serves the React renderer only; Farm's built-in docs renderer serves a single docs root."
+    );
+  }
   const docsConfigModulePath = adapterOwnsDocsRuntime && !hasPrecompiledDocs && config.docs.configPath && !config.docs.configPath.endsWith(".json") ? config.docs.configPath : void 0;
+  const adapterHandler = generateFarmDocsAdapterHandlerArguments(config.docs, docsConfigModulePath);
   const hasIsolatedClientGraphRuntime = isReactRenderer(config.renderer) && isolatedClientBoundaryModules.size > 0;
   const rendererStreamingCapabilities = getFarmRendererStreamingCapabilitiesForRuntime(
     config.renderer,
@@ -6335,6 +6379,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
   resolveFarmInstrumentationRuntime,
   resolveFarmPreviewDeployment,
   resolveFarmWebRequestOrigin,
+  fetchFarmExternalRewrite,
   runWithFarmRequestSpan,
   createFarmSearchParams,
   searchParamsToObject,
@@ -6366,8 +6411,8 @@ const isFarmDocsAPIRequest = (requestOrPathname) => {
     : new URL(requestOrPathname.url).pathname;
   const apiPath = ${JSON.stringify(farmDocsPrecompiledManifest?.apiPath || "/api/docs")};
   return pathname === apiPath || pathname.startsWith(apiPath + "/");
-};` : adapterOwnsDocsRuntime ? `import { isFarmDocsAPIRequest } from "@farm.js/core/docs";
-import { createFarmDocsRuntimeHandler as createFarmDocsAdapterRuntimeHandler } from ${JSON.stringify(config.docs.adapter.server)};
+};` : adapterOwnsDocsRuntime ? `import { ${docsConfigModulePath ? "getFarmDocsConfigModuleRoot, " : ""}isFarmDocsAPIRequest } from "@farm.js/core/docs";
+import { ${config.docs.roots?.length ? "createFarmDocsMultiRuntimeHandler as createFarmDocsAdapterMultiRuntimeHandler" : "createFarmDocsRuntimeHandler as createFarmDocsAdapterRuntimeHandler"} } from ${JSON.stringify(config.docs.adapter.server)};
 import * as FarmDocsAdapterReact from ${JSON.stringify(config.docs.adapter.react)};${docsConfigModulePath ? `
 import * as farmDocsConfigModule from ${toVirtualEntryImportSpecifier(docsConfigModulePath)};` : ""}` : `import { createFarmDocsAPIHandler, createFarmDocsHandler, isFarmDocsAPIRequest } from "@farm.js/core/docs";` : "";
   const docsFontImport = config.docs?.enabled && !hasPrecompiledDocs ? `import { resolveFarmLayoutFonts } from "@farm.js/core/font";` : "";
@@ -6396,12 +6441,16 @@ import { fileURLToPath as farmDocsFileURLToPath } from "node:url";` : "";
   const instrumentationImport = instrumentationPath ? `import * as FarmInstrumentationModule from ${toVirtualEntryImportSpecifier(instrumentationPath)};` : "";
   const nativeAuth = generateNativeAuthIntegrationSource(config.auth);
   const nativeMCP = generateNativeMCPPluginSource(config.mcp);
+  const mobileSession = (config.plugins || []).some(
+    (plugin) => plugin?.name === FARM_MOBILE_SESSION_PLUGIN
+  );
   const integrationImports = `
 ${configModulePath ? `import * as FarmUserConfigModule from ${toVirtualEntryImportSpecifier(configModulePath)};` : ""}
 ${layerConfigImports}
 ${integrationRuntimeImport}
 ${nativeAuth.importSource}
 ${nativeMCP.importSource}
+${mobileSession ? `import { createFarmMobileSessionPlugin as __farmCreateMobileSessionPlugin } from "@farm.js/core/internal/production-runtime";` : ""}
 `;
   const imageRuntime = resolveFarmImageServerRuntime(config.images, preset);
   const imageRuntimeImport = imageRuntime === "none" ? "" : `import { _withFarmImageSourceClientAddress, createCloudflareImageTransformer, createFarmImageHandler } from "@farm.js/core/image/server";`;
@@ -6682,6 +6731,10 @@ const configuredPlugins = [
   ${hasCompressionRuntime && hasPluginRuntime ? "createCompressionPlugin()," : ""}
   ${hasRuntimeIntegrationConfig ? "...resolveIntegrationPlugins(serverRuntimeIntegrations)," : ""}
   ${nativeMCP.pluginSource}
+  ${mobileSession ? `__farmCreateMobileSessionPlugin({
+    basePath: ${JSON.stringify(config.basePath)},
+    integrations: () => serverRuntimeIntegrations,
+  }),` : ""}
   ${hasConfiguredRuntimePlugins ? `...farmRuntimeConfigs.flatMap((runtimeConfig) =>
     Array.isArray(runtimeConfig.plugins) ? runtimeConfig.plugins : [],
   ),` : ""}
@@ -6785,7 +6838,20 @@ const farmDocsBundledContentDir = ${config.docs?.enabled && !hasPrecompiledDocs
   } catch {
     return null;
   }
-})()` : "null"};
+})()` : "null"};${config.docs?.enabled && !hasPrecompiledDocs && config.docs.roots?.length ? `
+const farmDocsBundledRootsDir = (() => {
+  try {
+    const currentDir = farmDocsDirname(farmDocsFileURLToPath(import.meta.url));
+    const candidates = [
+      farmDocsJoin(currentDir, "farm-docs-roots"),
+      farmDocsJoin(currentDir, "..", "farm-docs-roots"),
+      farmDocsJoin(currentDir, "..", "..", "farm-docs-roots"),
+    ];
+    return candidates.find((candidate) => farmDocsExistsSync(candidate)) || null;
+  } catch {
+    return null;
+  }
+})();` : ""}
 const farmDocsResolvedConfig = ${generateFarmDocsRuntimeConfigExpression(config.docs, hasPrecompiledDocs)};
 const farmDocsRuntimeRoot = ${hasPrecompiledDocs ? '"."' : `farmDocsBundledContentDir || ${JSON.stringify(config.root)}`};
 // Docs pages a path-specific guard covers, decided at build time. The docs API and the
@@ -6823,12 +6889,7 @@ const farmDocsModulePreloadPaths = farmDocsModulePreloads
       ),
     }
   : undefined;
-const farmDocsHandler = ${config.docs?.enabled ? hasPrecompiledDocs ? "farmDocsPrecompiledRuntime.handleDocsRequest" : adapterOwnsDocsRuntime ? `createFarmDocsAdapterRuntimeHandler({
-  ${docsConfigModulePath ? "...(farmDocsConfigModule.default || farmDocsConfigModule),\n  ...farmDocsResolvedConfig.configOverrides," : "...farmDocsResolvedConfig.config,"}
-  entry: farmDocsResolvedConfig.config?.entry || String(farmDocsResolvedConfig.entry || "/docs").replace(/^\\/+|\\/+$/g, "") || "docs",
-  docsPath: farmDocsResolvedConfig.entry,
-  contentDir: farmDocsResolvedConfig.contentDir || farmDocsResolvedConfig.config?.contentDir,
-}, {
+const farmDocsHandler = ${config.docs?.enabled ? hasPrecompiledDocs ? "farmDocsPrecompiledRuntime.handleDocsRequest" : adapterOwnsDocsRuntime ? `${adapterHandler.factory}(${adapterHandler.config}, {
   rootDir: farmDocsRuntimeRoot,
   // A production build's content cannot change, so the adapter reads its
   // navigation once instead of scanning the content directory per request.
@@ -7033,10 +7094,22 @@ function escapeFarmHtmlAttribute(value) {
     .replace(/>/g, "&gt;");
 }
 
-async function renderFarmElement(ReactDOMServer, element, routeKey, flushMarkers = false) {
-  // Written after each React flush in a streamed navigation (flushMarkers): the browser swaps in
+// A streamed navigation's flush marker token: 128 random bits, hex.
+function createFarmFlushToken() {
+  const bytes = new Uint8Array(16);
+  globalThis.crypto.getRandomValues(bytes);
+  let token = "";
+  for (const byte of bytes) token += byte.toString(16).padStart(2, "0");
+  return token;
+}
+
+async function renderFarmElement(ReactDOMServer, element, routeKey, flushToken = "") {
+  // Written after each React flush in a streamed navigation (flushToken): the browser swaps in
   // the shell, then adds each Suspense boundary as soon as the flush that completed it ends.
-  const FARM_FLUSH_MARKER = "<!--farm-flush-->";
+  // The token is random per response and reaches the browser in the F-Flush header, so page
+  // content cannot forge a boundary.
+  const flushMarkers = Boolean(flushToken);
+  const FARM_FLUSH_MARKER = flushMarkers ? "<!--farm-flush:" + flushToken + "-->" : "";
   // Islands mode: each render writes its islands' values itself, so a request that renders twice
   // (notFound(), or a synchronous attempt that suspends and streams) still sends them.
   if (typeof farmIslandsRender === "function") element = farmIslandsRender(element);
@@ -8480,7 +8553,7 @@ const farmBuiltInRoutePaths = new Set(${JSON.stringify(
   )});
 ${config.docs?.enabled ? `const farmDocsRouteLabelInput = {
   path: normalizeRuntimePath(farmDocsResolvedConfig?.entry || "/docs"),
-  apiPath: ${JSON.stringify(farmDocsPrecompiledManifest?.apiPath || "/api/docs")},
+  apiPath: ${JSON.stringify(farmDocsPrecompiledManifest?.apiPath || "/api/docs")},${config.docs.roots?.length ? "\n  roots: farmDocsResolvedConfig.roots.map((farmDocsRoot) => farmDocsRoot.entry)," : ""}
 };
 ` : ""}// The request's route payload, for a handler that learns what answered while it handles.
 const farmRouteLabelSlot = Symbol("farm.route.label.slot");
@@ -8855,7 +8928,7 @@ async function resolveFarmRequestInContext(
       if (rewriteDestination) {
         let rewrittenRequest = createRewrittenRequest(request, rewriteDestination);
         if (new URL(rewrittenRequest.url).origin !== url.origin) {
-          return globalThis.fetch(rewrittenRequest);
+          return fetchFarmExternalRewrite(rewrittenRequest);
         }
         if (farmPluginRuntime) {
           // Plugin guards ran on the requested URL. Re-run only runtime.before
@@ -9574,10 +9647,13 @@ ${hasServerRuntimeIntegrations ? `
           !route.shouldHydrate &&
           request.headers.get("f-render") === "tree";
         // A navigation the browser streams marks where each React flush ends, so the browser
-        // shows the page before its Suspense content arrives (FARM_FLUSH_MARKER).
-        const farmFlushMarkers = request.headers.get("f-stream") === "flush";` : `const farmLayoutKeyOf = null;
+        // shows the page before its Suspense content arrives (FARM_FLUSH_MARKER). The marker
+        // carries a random token sent in the F-Flush header: page content cannot forge one.
+        const farmFlushToken = request.headers.get("f-stream") === "flush"
+          ? createFarmFlushToken()
+          : "";` : `const farmLayoutKeyOf = null;
         const farmPayloadOnlyNavigation = false;
-        const farmFlushMarkers = false;`}
+        const farmFlushToken = "";`}
         const renderPageElement = async () => {
             // First, render the page content
             let pageElement;
@@ -9699,7 +9775,7 @@ ${hasServerRuntimeIntegrations ? `
           }
 
           wrappedElement = wrapWithFarmIntegrationProviders(wrappedElement);
-          return renderFarmElement(ReactDOMServer, wrappedElement, route.pattern, farmFlushMarkers);
+          return renderFarmElement(ReactDOMServer, wrappedElement, route.pattern, farmFlushToken);
         };
         const renderedPage = ${hasMiddlewareRuntime ? `await _runWithMiddlewareData(middlewareData, () =>
           _runWithMiddlewareContext(middlewareContext, renderPageElement)
@@ -10006,7 +10082,11 @@ ${hasServerRuntimeIntegrations ? `
               );
           return applyProductionMiddlewareHeaders(farmOwnedResponse(streamedDocument, {
             status: pageStatus,
-            headers: { ...responseHeaders, "x-farm-preload-streaming": "1" },
+            headers: {
+              ...responseHeaders,
+              "x-farm-preload-streaming": "1",
+              ...(farmFlushToken ? { "F-Flush": farmFlushToken } : {}),
+            },
           }), middlewareHeaders);
         }
 
@@ -10689,6 +10769,29 @@ function getPhysicalPrerenderBypassReason(options) {
   }
   return void 0;
 }
+async function getFarmDocsPrerenderPages(config, root, preset) {
+  if (!config.docs?.enabled || !config.docs.prerender) return [];
+  if (!isReactRenderer(config.renderer) || !hasFarmDocsRuntimeAdapter(config.docs)) {
+    logger.warn(
+      "docs.prerender needs a docs adapter such as @farming-labs/farmjs; Farm's built-in docs renderer keeps rendering docs pages on request."
+    );
+    return [];
+  }
+  if (getFarmPresetRuntime(preset) === "edge") {
+    logger.info(
+      `\u21AA Keeping docs pages in the edge docs snapshot: docs.prerender writes static files on Node and serverless targets, not "${preset}".`
+    );
+    return [];
+  }
+  const pages = await listFarmDocsAdapterPages(config.docs, { root, srcDir: config.srcDir });
+  if (!pages) {
+    logger.warn(
+      `The docs adapter ${JSON.stringify(config.docs.adapter.id)} does not list its pages for prerendering; upgrade it to prerender docs pages. They render on request until then.`
+    );
+    return [];
+  }
+  return pages;
+}
 function hasFarmNitroCacheRouteRule(routeRules) {
   return Object.values(routeRules || {}).some((rule) => {
     const swr = rule?.swr;
@@ -10730,12 +10833,19 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const ssgCollectionPromise = routeManager.collectSSGPages();
   const middlewareRoutesPromise = discoverMiddlewareRoutes(getFarmAppDirectories(config));
   const configuredResponseRoutesPromise = Promise.all([config.redirects(), config.rewrites()]);
+  const docsPrerenderPagesPromise = getFarmDocsPrerenderPages(config, root, preset);
   const farmWorkflows = await prepareFarmWorkflowsForNitro(config);
   const farmCron = await prepareFarmCronForNitro(config);
-  const [{ ssg: ssgPages }, middlewareRoutes, [configuredRedirects, configuredRewrites]] = await Promise.all([
+  const [
+    { ssg: ssgPages },
+    middlewareRoutes,
+    [configuredRedirects, configuredRewrites],
+    docsPrerenderPages
+  ] = await Promise.all([
     ssgCollectionPromise,
     middlewareRoutesPromise,
-    configuredResponseRoutesPromise
+    configuredResponseRoutesPromise,
+    docsPrerenderPagesPromise
   ]);
   const redirectSources = [
     ...routeManager.getRedirects().map((route) => route.source),
@@ -10744,7 +10854,7 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const rewriteSources = configuredRewrites.map((route) => route.source);
   const prerenderRoutes = [];
   const skippedPrerenderRoutes = [];
-  const middlewareRoutesWithConfig = ssgPages.length > 0 ? await Promise.all(
+  const middlewareRoutesWithConfig = ssgPages.length > 0 || docsPrerenderPages.length > 0 ? await Promise.all(
     middlewareRoutes.map(async (route) => ({
       ...route,
       config: await readMiddlewareFileConfig(route.filePath)
@@ -10767,6 +10877,26 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
     }
     prerenderRoutes.push(page.urlPath);
   }
+  const docsRouteRuntimeManifest = {
+    ...routeRuntimeManifest,
+    routes: routeRuntimeManifest.routes.filter((entry) => entry.kind !== "page")
+  };
+  for (const pathname of docsPrerenderPages) {
+    if (prerenderRoutes.includes(pathname)) continue;
+    const reason = getPhysicalPrerenderBypassReason({
+      config,
+      middlewareRoutes: middlewareRoutesWithConfig,
+      routeRuntimeManifest: docsRouteRuntimeManifest,
+      redirectSources,
+      rewriteSources,
+      pathname
+    });
+    if (reason) {
+      skippedPrerenderRoutes.push({ pathname, reason });
+      continue;
+    }
+    prerenderRoutes.push(pathname);
+  }
   for (const skipped of skippedPrerenderRoutes) {
     logger.info(`\u21AA Keeping SSG route ${skipped.pathname} server-handled (${skipped.reason})`);
   }
@@ -11500,9 +11630,28 @@ async function postProcessVercelOutput(root, outputDir, fs4, config, farmWorkflo
   logger.info("\u2705 Post-processed Vercel output for Build Output API v3");
 }
 async function copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs4) {
-  const docsContentDir = resolveBuildDocsContentDir(config, root);
+  if (!config.docs?.enabled) return;
+  const [mainRoot, ...extraRoots] = getFarmDocsRoots(config.docs);
+  await copyFarmDocsRootContent(
+    mainRoot,
+    root,
+    config.srcDir,
+    path10.join(nitroFuncDir, "farm-docs-content"),
+    fs4
+  );
+  for (const [index, docsRoot] of extraRoots.entries()) {
+    await copyFarmDocsRootContent(
+      docsRoot,
+      root,
+      config.srcDir,
+      path10.join(nitroFuncDir, "farm-docs-roots", String(index)),
+      fs4
+    );
+  }
+}
+async function copyFarmDocsRootContent(docs, root, srcDir, bundledContentDir, fs4) {
+  const docsContentDir = resolveBuildDocsContentDir(docs, root, srcDir);
   if (!docsContentDir) return;
-  const bundledContentDir = path10.join(nitroFuncDir, "farm-docs-content");
   const lastModifiedManifest = createFarmDocsLastModifiedManifest(docsContentDir, {
     fallback: "now"
   });

package/dist/{chunk-PDJSL7PL.cjs → chunk-5IONBVJY.cjs}

@@ -40,7 +40,7 @@ var _chunkJYNNIGQOcjs = require('./chunk-JYNNIGQO.cjs');
 var _chunkVQJYGZNXcjs = require('./chunk-VQJYGZNX.cjs');
 
 
-var _chunkZ5MZDFX4cjs = require('./chunk-Z5MZDFX4.cjs');
+var _chunkYIHRZBD7cjs = require('./chunk-YIHRZBD7.cjs');
 
 
 
@@ -457,11 +457,11 @@ function farmApiPlugin(options = {}) {
             const response = await apiRouterHandler(request);
             const duration = Date.now() - startTime;
             logResponse(method, currentPathname, response.status, duration);
-            await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, response);
+            await _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, res, response);
           } catch (error) {
             const bodyErrorResponse = _chunkLIFUPCXWcjs.createFarmRequestBodyErrorResponse.call(void 0, error);
             if (bodyErrorResponse) {
-              await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, bodyErrorResponse);
+              await _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, res, bodyErrorResponse);
               return;
             }
             const duration = Date.now() - startTime;