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

package/dist/{chunk-I2ZA5SXS.mjs → chunk-BSEKNTMS.mjs}

@@ -2,7 +2,7 @@ import {
   createFarmReactRefreshPlugins,
   farmDesktopDevGuardPlugin,
   isFarmReactRefreshActive
-} from "./chunk-75WWOZ5C.mjs";
+} from "./chunk-QOSDWGKT.mjs";
 import {
   createFarmServerFnBoundaryModule,
   isFarmServerFnBoundaryId,
@@ -37,7 +37,7 @@ import {
   resolveFarmIsolatedClientHydrationMode,
   resolveModuleSourcePath,
   stripUseClientDirective
-} from "./chunk-S5ZA2T2W.mjs";
+} from "./chunk-EWC76P5D.mjs";
 import {
   loadTailwindVitePlugin
 } from "./chunk-PIHKO25G.mjs";
@@ -50,7 +50,7 @@ import {
 import {
   generateFarmTypeArtifacts,
   resolveRouteRenderingConfig
-} from "./chunk-WVX3BUNJ.mjs";
+} from "./chunk-CZ35L6PL.mjs";
 import {
   createFarmRouteRenderPlan,
   farmPathGuardCoversEndpoint,
@@ -79,7 +79,7 @@ import {
   resolveFarmMCPRouteLabel,
   resolveFarmMarkdownRouteLabel,
   setFarmRouteLabel
-} from "./chunk-R5P4KFPM.mjs";
+} from "./chunk-QAIAFCRZ.mjs";
 import {
   FARM_DEFAULT_MCP_PATH
 } from "./chunk-KRRZJ77U.mjs";
@@ -87,10 +87,13 @@ import {
   resolveFarmLayoutFonts
 } from "./chunk-HZOMT5DY.mjs";
 import {
+  farmBrowserBuiltinsOptimizerPlugin,
   farmEnvironmentFunctionsPlugin,
   generateProgrammaticClientRouteModule,
-  programmaticClientRouteKey
-} from "./chunk-C5JXCUKR.mjs";
+  loadFarmBrowserBuiltin,
+  programmaticClientRouteKey,
+  resolveFarmBrowserBuiltin
+} from "./chunk-ZQ5BDNKW.mjs";
 import {
   createFarmMarkdownSourceResponse,
   isFarmMarkdownPageFile,
@@ -161,10 +164,10 @@ import {
   getIntegrationDocumentNavigationMatchers,
   getIntegrationProviders,
   matchIntegrationRoute
-} from "./chunk-HHFMECFO.mjs";
+} from "./chunk-Y2G5SJFB.mjs";
 import {
   MiddlewareManager
-} from "./chunk-WSY2JD7O.mjs";
+} from "./chunk-NN3MOPSI.mjs";
 import {
   _runWithMiddlewareContext,
   _runWithMiddlewareData
@@ -226,8 +229,9 @@ import {
 } from "./chunk-2DA7CLY7.mjs";
 import {
   applyWebResponseHeaders,
+  fetchFarmExternalRewrite,
   sendWebResponse
-} from "./chunk-IUQLRTTO.mjs";
+} from "./chunk-CO6UYM2D.mjs";
 import {
   createFarmNodeRequestAbortSignal,
   createFarmNodeRequestBodyStream,
@@ -240,7 +244,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-ZF3GX4O7.mjs";
+} from "./chunk-EOSFVNXZ.mjs";
 import {
   DEFAULT_FARM_API_BASE_PATH
 } from "./chunk-BLD5GVCG.mjs";
@@ -295,6 +299,7 @@ function transformFarmFormActionModule(options) {
 
 // src/vite.ts
 import { parseSync } from "vite";
+import { isBuiltin } from "module";
 
 // src/dev-preview-guard.ts
 import { promises as fsp } from "fs";
@@ -595,7 +600,7 @@ function formatClientBoundaryWarning(id, findings) {
   }
   if (builtinImports.length > 0) {
     lines.push(
-      `- import of ${builtinImports.join(", ")} \u2014 stubbed with an empty object in the browser. Move the import into server-only code.`
+      `- import of ${builtinImports.join(", ")} \u2014 stubbed in the browser, where exports without a Web API equivalent are undefined. Move the import into server-only code.`
     );
   }
   return lines.join("\n");
@@ -760,7 +765,7 @@ function loadFarmWorkflowsDevRuntime() {
   return import("./workflows.mjs");
 }
 function loadFarmDevtoolsSnapshotRuntime() {
-  return import("./devtools-4MLL3RAL.mjs");
+  return import("./devtools-BU5IT2PD.mjs");
 }
 function loadFarmDevtoolsUIRuntime() {
   return import("./devtools-ui-CYBVFLPH.mjs");
@@ -800,11 +805,19 @@ function farmServerOnlyEntriesPlugin() {
   return {
     name: "farm:server-only-entries",
     enforce: "pre",
+    config() {
+      return {
+        optimizeDeps: { rolldownOptions: { plugins: [farmBrowserBuiltinsOptimizerPlugin()] } }
+      };
+    },
     configResolved(config) {
       root = config.root;
     },
     resolveId(id, importer, options) {
       if (id === FARM_PLATFORM_ENTRY) return options?.ssr ? null : FARM_PLATFORM_CLIENT_ID;
+      if (!options?.ssr && isBuiltin(id)) {
+        return resolveFarmBrowserBuiltin(this, id, importer, options);
+      }
       if (!FARM_SERVER_ONLY_ENTRIES.has(id)) return null;
       const importedBy = importer ? ` (imported by ${importer})` : "";
       if (!options?.ssr) {
@@ -821,7 +834,8 @@ function farmServerOnlyEntriesPlugin() {
       return null;
     },
     load(id) {
-      return id === FARM_PLATFORM_CLIENT_ID ? createFarmPlatformClientModule() : null;
+      if (id === FARM_PLATFORM_CLIENT_ID) return createFarmPlatformClientModule();
+      return loadFarmBrowserBuiltin(id) ?? null;
     }
   };
 }
@@ -904,6 +918,17 @@ function withFarmRequestTracing(handler, apiRuntime, resolveTraceUrl = (request)
     });
   };
 }
+async function proxyFarmExternalRewrite(req, res, bodySizeLimit) {
+  const destination = req.url;
+  if (!destination || !/^https?:\/\//i.test(destination)) return false;
+  let request = createRequestFromNodeRequest(req, new URL(destination));
+  if (request.method !== "GET" && request.method !== "HEAD") {
+    const body = await readNodeRequestBody(req, bodySizeLimit);
+    request = new Request(request, { body: toRequestBody(body) });
+  }
+  await sendWebResponse(res, await fetchFarmExternalRewrite(request));
+  return true;
+}
 function toRequestBody(body) {
   if (!body) return void 0;
   const copy = new Uint8Array(body.byteLength);
@@ -1193,10 +1218,12 @@ function rewriteEarlySsrRelativeImports(options) {
     const sourcePath = suffixIndex === -1 ? source.value : source.value.slice(0, suffixIndex);
     const suffix = suffixIndex === -1 ? "" : source.value.slice(suffixIndex);
     const resolvedPath = path5.resolve(path5.dirname(cleanId), sourcePath);
+    const moduleId = toViteModuleId(resolvedPath, options.root);
+    const specifier = moduleId.startsWith("/@fs/") ? toPosixPath(resolvedPath) : moduleId;
     replacements.push({
       start: source.start,
       end: source.end,
-      code: JSON.stringify(`${toViteModuleId(resolvedPath, options.root)}${suffix}`)
+      code: JSON.stringify(`${specifier}${suffix}`)
     });
   });
   if (replacements.length === 0) return null;
@@ -2295,7 +2322,10 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                   computed: docsResponse,
                   label: resolveFarmDocsEngineRouteLabel(
                     stripFarmBasePath(requestPathname, farmConfig.basePath),
-                    { path: farmConfig.docs?.entry || "/docs" }
+                    {
+                      path: farmConfig.docs?.entry || "/docs",
+                      roots: farmConfig.docs?.roots?.map((root) => root.entry)
+                    }
                   )
                 }
               );
@@ -2569,7 +2599,7 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                   await pm.runHookParallel("beforeRequest", req, res);
                 }
               }
-              if (res.writableEnded) {
+              if (res.writableEnded || await proxyFarmExternalRewrite(req, res, currentServerConfig.bodySizeLimit)) {
                 const duration2 = Date.now() - startTime2;
                 logResponse(method2, urlPath2, res.statusCode || 200, duration2, "API");
                 return;
@@ -2729,7 +2759,8 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                   route: setFarmRouteLabel(
                     { pathname: pathname2, pattern: apiLifecyclePayload.routePath },
                     resolveFarmDocsRouteLabel(pathname2, {
-                      path: farmConfig.docs?.entry || "/docs"
+                      path: farmConfig.docs?.entry || "/docs",
+                      roots: farmConfig.docs?.roots?.map((root) => root.entry)
                     })
                   )
                 }) : await invokeDocsAPIHandler(request);
@@ -3247,7 +3278,7 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                 }
               }
             }
-            if (res.writableEnded || responseInterceptor?.isEnded()) {
+            if (res.writableEnded || responseInterceptor?.isEnded() || await proxyFarmExternalRewrite(req, res, currentServerConfig.bodySizeLimit)) {
               if (!responseInterceptor?.isEnded()) {
                 const duration = Date.now() - startTime;
                 logResponse(method, urlPath, res.statusCode || 200, duration, "PAGE");
@@ -5711,7 +5742,10 @@ function farmIslandsOnlyDocument() {
   const rootContainer = document.getElementById('root')
   
   if (!rootContainer) {
-    console.error('[Farm.js] Root container not found')
+    // A document Farm did not render as a page (the docs renderer's) has nothing to hydrate.
+    if (window.__FARM_PAGE_MODULE__ !== undefined) {
+      console.error('[Farm.js] Root container not found')
+    }
     return
   }
 

package/dist/{chunk-WAPQWAE6.cjs → chunk-CECUDGXQ.cjs}

@@ -19,7 +19,7 @@ var _chunkITV4QQL2cjs = require('./chunk-ITV4QQL2.cjs');
 
 
 
-var _chunkZ5MZDFX4cjs = require('./chunk-Z5MZDFX4.cjs');
+var _chunkYIHRZBD7cjs = require('./chunk-YIHRZBD7.cjs');
 
 
 
@@ -776,6 +776,7 @@ function createIntegrationPlugin(integrationKey, integration) {
       }
     },
     async beforeRequest(req, res, context) {
+      if (req.url && !req.url.startsWith("/")) return;
       const fullUrl = `http://${req.headers.host || "localhost"}${req.url || "/"}`;
       const url = new URL(fullUrl);
       const pathname = url.pathname;
@@ -806,7 +807,7 @@ function createIntegrationPlugin(integrationKey, integration) {
         } catch (error) {
           const response = _chunkLIFUPCXWcjs.createFarmRequestBodyErrorResponse.call(void 0, error);
           if (!response) throw error;
-          await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, response);
+          await _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, res, response);
           return null;
         }
       };
@@ -854,10 +855,10 @@ function createIntegrationPlugin(integrationKey, integration) {
             for (const cookie of forwardedCookies) {
               setCookieHeaders.append("set-cookie", cookie);
             }
-            _chunkZ5MZDFX4cjs.applyWebResponseHeaders.call(void 0, res, setCookieHeaders, { appendSetCookie: true });
+            _chunkYIHRZBD7cjs.applyWebResponseHeaders.call(void 0, res, setCookieHeaders, { appendSetCookie: true });
           }
           if (response) {
-            await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, response);
+            await _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, res, response);
             await emitIntegrationLog(integration, {
               category: integration.category,
               slot: integration.category,
@@ -950,7 +951,7 @@ function createIntegrationPlugin(integrationKey, integration) {
         try {
           const validation = await validateIntegrationRouteInput(route, request, url);
           if (!validation.success) {
-            await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, validation.response);
+            await _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, res, validation.response);
             await emitIntegrationLog(integration, {
               category: integration.category,
               slot: integration.category,
@@ -973,7 +974,7 @@ function createIntegrationPlugin(integrationKey, integration) {
           for (const middlewareEntry of route.middleware || []) {
             const middlewareResponse = await middlewareEntry.handler(request, handlerContext);
             if (middlewareResponse) {
-              await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, middlewareResponse);
+              await _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, res, middlewareResponse);
               await emitIntegrationLog(integration, {
                 category: integration.category,
                 slot: integration.category,
@@ -1005,7 +1006,7 @@ function createIntegrationPlugin(integrationKey, integration) {
               handlerContext,
               beforeResponse
             );
-            await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, response2);
+            await _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, res, response2);
             await emitIntegrationLog(integration, {
               category: integration.category,
               slot: integration.category,
@@ -1031,7 +1032,7 @@ function createIntegrationPlugin(integrationKey, integration) {
             handlerContext,
             handlerResponse
           );
-          await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, response);
+          await _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, res, response);
           await emitIntegrationLog(integration, {
             category: integration.category,
             slot: integration.category,

package/dist/{chunk-IUQLRTTO.mjs → chunk-CO6UYM2D.mjs}

@@ -152,8 +152,21 @@ async function sendWebResponse(res, response) {
     }
   }
 }
+async function fetchFarmExternalRewrite(request) {
+  const response = await fetch(request);
+  if (!response.headers.has("content-encoding")) return response;
+  const headers = new Headers(response.headers);
+  headers.delete("content-encoding");
+  headers.delete("content-length");
+  return new Response(response.body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers
+  });
+}
 
 export {
   applyWebResponseHeaders,
-  sendWebResponse
+  sendWebResponse,
+  fetchFarmExternalRewrite
 };

package/dist/{chunk-WVX3BUNJ.mjs → chunk-CZ35L6PL.mjs}

@@ -407,6 +407,7 @@ async function collectSSGPages(routes, loadModule, options = {}) {
   const ssgPages = [];
   const ssrRoutes = [];
   const staticCandidateRoutes = [];
+  let staticCandidateDocsPages = 0;
   for (const route of routes) {
     try {
       const mod = await loadModule(route.filePath);
@@ -453,7 +454,8 @@ async function collectSSGPages(routes, loadModule, options = {}) {
       } else {
         ssrRoutes.push(route.path);
         if (options.suggestStaticRendering !== false && analyzeStaticRouteCandidate(mod, source, { isDynamic: route.isDynamic }).candidate) {
-          staticCandidateRoutes.push(route.path);
+          if (options.docsAdapterRoutes?.owns(route.path)) staticCandidateDocsPages += 1;
+          else staticCandidateRoutes.push(route.path);
         }
       }
     } catch (error) {
@@ -472,6 +474,11 @@ async function collectSSGPages(routes, loadModule, options = {}) {
 Add \`export const dynamic = "force-static";\` after verifying that imported code does not read cookies, headers, authentication, or other request data.`
     );
   }
+  if (staticCandidateDocsPages > 0 && !options.docsAdapterRoutes?.prerender) {
+    console.warn(
+      `[Farm.js] ${staticCandidateDocsPages} docs page${staticCandidateDocsPages === 1 ? " renders" : "s render"} on each request. Set \`docs.prerender: true\` in farm.config.ts to prerender docs pages on Node and serverless targets.`
+    );
+  }
   return { ssg: ssgPages, ssr: ssrRoutes };
 }
 function isSSGModule(mod) {

package/dist/{chunk-4GJJ65RB.mjs → chunk-EIMK7D2D.mjs}

@@ -651,16 +651,34 @@ function resolveFarmDocsContentDir(docs, options) {
   if (existsSync2(appDocsDir)) return appDocsDir;
   return path2.join(root, entryDir);
 }
+function getFarmDocsRoots(docs) {
+  return [
+    docs,
+    ...(docs.roots ?? []).map((root) => ({
+      ...docs,
+      entry: root.entry,
+      contentDir: root.contentDir,
+      config: root.config,
+      runtimeConfig: root.runtimeConfig,
+      configOverrides: root.configOverrides,
+      roots: void 0
+    }))
+  ];
+}
 function getFarmDocsRouteTypeEntries(docs) {
   if (!docs?.enabled) return [];
-  const entry = normalizeEntry2(docs.entry);
-  if (entry === "/") return ["/", "/[...docs]"];
-  return [entry, `${entry}/[...docs]`];
+  return getFarmDocsRoots(docs).flatMap((root) => {
+    const entry = normalizeEntry2(root.entry);
+    if (entry === "/") return ["/", "/[...docs]"];
+    return [entry, `${entry}/[...docs]`];
+  });
 }
 function getFarmDocsDocumentNavigationMatchers(docs) {
   if (!docs?.enabled) return [];
-  const entry = normalizeEntry2(docs.entry);
-  return [entry === "/" ? "/(.*)" : `${entry}(.*)`];
+  return getFarmDocsRoots(docs).map((root) => {
+    const entry = normalizeEntry2(root.entry);
+    return entry === "/" ? "/(.*)" : `${entry}(.*)`;
+  });
 }
 function getRequestSlug(docs, request) {
   const pathname = new URL(request.url).pathname;
@@ -1921,6 +1939,7 @@ export {
   createFarmDocsLastModifiedManifest,
   isFarmDocsRequest,
   resolveFarmDocsContentDir,
+  getFarmDocsRoots,
   getFarmDocsRouteTypeEntries,
   getFarmDocsDocumentNavigationMatchers,
   loadFarmDocsPage,

package/dist/{chunk-CY7H5KS4.cjs → chunk-EKJYE4Y7.cjs}

@@ -29,7 +29,7 @@ var _chunkSYW346ZNcjs = require('./chunk-SYW346ZN.cjs');
 var _chunkGBMWLDCCcjs = require('./chunk-GBMWLDCC.cjs');
 
 
-var _chunkWAPQWAE6cjs = require('./chunk-WAPQWAE6.cjs');
+var _chunkCECUDGXQcjs = require('./chunk-CECUDGXQ.cjs');
 
 // src/schema-dependencies.ts
 function collectSchemaDependencies(owners) {
@@ -115,7 +115,7 @@ async function withTimeout(work, timeoutMs) {
 var formatSeconds = (ms) => ms < 1e3 ? `${ms}ms` : `${Number((ms / 1e3).toFixed(1))}s`;
 function collectSchemaOwners(config) {
   const owners = [];
-  const integrationSchemas = _chunkWAPQWAE6cjs.getIntegrationSchemas.call(void 0, config.integrations);
+  const integrationSchemas = _chunkCECUDGXQcjs.getIntegrationSchemas.call(void 0, config.integrations);
   let integrationClient;
   for (const [name, schema] of Object.entries(integrationSchemas)) {
     owners.push({

package/dist/{chunk-ZF3GX4O7.mjs → chunk-EOSFVNXZ.mjs}

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.1.51-beta.0";
+var version = "0.1.51-beta.1";
 
 // src/version.ts
 var FARM_VERSION = version;

package/dist/{chunk-S5ZA2T2W.mjs → chunk-EWC76P5D.mjs}

@@ -5,7 +5,7 @@ import {
   collectSSGPages,
   matchSSGPage,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-WVX3BUNJ.mjs";
+} from "./chunk-CZ35L6PL.mjs";
 import {
   classifyFarmDocumentPrefix,
   composeFarmFullDocument,
@@ -33,7 +33,7 @@ import {
 } from "./chunk-7UPCJDB5.mjs";
 import {
   listFarmMCPLlmsTxtLinks
-} from "./chunk-R5P4KFPM.mjs";
+} from "./chunk-QAIAFCRZ.mjs";
 import {
   FARM_DEFAULT_MCP_PATH,
   collectFarmDefaultMCPPages,
@@ -60,7 +60,7 @@ import {
   createEvaluatedRouteGraph,
   mergeProgrammaticClientRoutes,
   resolveProgrammaticClientRoutes
-} from "./chunk-C5JXCUKR.mjs";
+} from "./chunk-ZQ5BDNKW.mjs";
 import {
   createFarmMarkdownRouteModuleFromFile,
   loadFarmMdxComponents
@@ -164,7 +164,7 @@ import {
   getIntegrationProviders,
   getRegisteredIntegrationAPIManifest,
   isFarmIntegrationProviderComponentReference
-} from "./chunk-HHFMECFO.mjs";
+} from "./chunk-Y2G5SJFB.mjs";
 import {
   createRouteSlotContainerId,
   parseRouteSlotFile
@@ -241,7 +241,7 @@ import {
 } from "./chunk-2DA7CLY7.mjs";
 import {
   sendWebResponse
-} from "./chunk-IUQLRTTO.mjs";
+} from "./chunk-CO6UYM2D.mjs";
 import {
   matchesFarmIfNoneMatch,
   resolveFarmServerConfig
@@ -254,7 +254,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-ZF3GX4O7.mjs";
+} from "./chunk-EOSFVNXZ.mjs";
 import {
   resolveFarmTrailingSlashRedirect,
   setFarmTrailingSlashPreference
@@ -2865,6 +2865,18 @@ var RouteManager = class {
       }
     }
   }
+  /** The page routes a docs adapter answers before Farm's own page rendering. */
+  getDocsAdapterRoutes() {
+    const docs = this.config.docs;
+    if (!docs || typeof docs !== "object" || !docs.enabled || !docs.adapter || !docs.adapter.server || !docs.adapter.react || !isReactRenderer(this.config.renderer)) {
+      return void 0;
+    }
+    const entry = `/${String(docs.entry || "docs").replace(/^\/+|\/+$/g, "")}`;
+    return {
+      owns: (routePath) => entry === "/" || routePath === entry || routePath.startsWith(`${entry}/`),
+      prerender: docs.prerender === true
+    };
+  }
   /**
    * Collect SSG pages for static generation
    *
@@ -2879,8 +2891,10 @@ var RouteManager = class {
       pattern: entry.pattern
     }));
     const i18n = this.getI18nConfig();
+    const docsAdapterRoutes = this.getDocsAdapterRoutes();
     const result = await collectSSGPages(routes, (filePath) => this.loadRouteModule(filePath), {
-      suggestStaticRendering: shouldSuggestStaticRenderingForI18n(i18n)
+      suggestStaticRendering: shouldSuggestStaticRenderingForI18n(i18n),
+      ...docsAdapterRoutes ? { docsAdapterRoutes } : {}
     });
     if (!i18n) {
       return result;

package/dist/{chunk-3HA7PP72.mjs → chunk-I3EFXUAR.mjs}

@@ -1,17 +1,18 @@
 import {
   discoverFarmDocsPages,
   getFarmDocsMarkdownPath,
+  getFarmDocsRoots,
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-4GJJ65RB.mjs";
+} from "./chunk-EIMK7D2D.mjs";
 import {
   docsEngine,
   loadFarmDocsEngine
 } from "./chunk-VE3FWJBO.mjs";
 import {
   resolveDocsConfig
-} from "./chunk-JF5CNHHF.mjs";
+} from "./chunk-KMB5BMFX.mjs";
 import {
   getFarmDocsAdapterConfigModule,
   isSecretDocsConfigKey
@@ -26,7 +27,7 @@ function hasFarmDocsRuntimeAdapter(docs) {
 }
 function assertFarmDocsAdapterServesNoGuardedPages(docs, options, isPathGuarded) {
   if (!isPathGuarded || !hasFarmDocsRuntimeAdapter(docs)) return;
-  const guarded = discoverFarmDocsPages(resolveFarmDocsContentDir(docs, options), docs).filter((page) => isPathGuarded(page.href) || isPathGuarded(getFarmDocsMarkdownPath(page.href))).map((page) => page.href);
+  const guarded = getFarmDocsRoots(docs).flatMap((root) => discoverFarmDocsPages(resolveFarmDocsContentDir(root, options), root)).filter((page) => isPathGuarded(page.href) || isPathGuarded(getFarmDocsMarkdownPath(page.href))).map((page) => page.href);
   if (guarded.length === 0) return;
   throw new Error(
     `Docs pages behind a path guard (${guarded.join(", ")}) would be public: the docs adapter ${JSON.stringify(docs.adapter.id)} serves their content in llms-full.txt, search, Markdown, and MCP without running the app's guards. Move those pages out of the docs content directory, or set docs.adapter = false to use Farm's built-in docs runtime, which keeps guarded pages off anonymous surfaces.`
@@ -39,9 +40,17 @@ async function loadFarmDocsConfigModule(docs, loadModule) {
   const config = loaded?.default ?? loaded;
   return config && typeof config === "object" ? config : void 0;
 }
+function getFarmDocsConfigModuleRoot(moduleConfig, entry) {
+  const { roots, ...shared } = moduleConfig;
+  const route = entry.replace(/^\/+|\/+$/g, "");
+  const own = Array.isArray(roots) ? roots.find(
+    (root) => Boolean(root) && typeof root === "object" && typeof root.entry === "string" && root.entry.replace(/^\/+|\/+$/g, "") === route
+  ) : void 0;
+  return own ? { ...shared, ...own } : shared;
+}
 function createFarmDocsAdapterRuntimeConfig(docs, options, moduleConfig) {
   return {
-    ...moduleConfig ? { ...moduleConfig, ...docs.configOverrides } : docs.runtimeConfig ?? docs.config,
+    ...moduleConfig ? { ...getFarmDocsConfigModuleRoot(moduleConfig, docs.entry), ...docs.configOverrides } : docs.runtimeConfig ?? docs.config,
     entry: docs.config.entry || docs.entry.replace(/^\/+|\/+$/g, "") || "docs",
     docsPath: docs.entry,
     contentDir: resolveFarmDocsContentDir(docs, options)
@@ -56,6 +65,11 @@ async function compileFarmDocsAdapterEdgeManifest(docs, options) {
   if (!hasFarmDocsRuntimeAdapter(docs)) {
     throw new Error("Farm docs adapter requires server and react runtime entrypoints.");
   }
+  if (docs.roots?.length) {
+    throw new Error(
+      "Several docs roots are not supported on edge deployments yet; they need a Node.js deployment target."
+    );
+  }
   const compilerEntry = docs.adapter.edgeCompiler;
   if (!compilerEntry) {
     throw new Error(
@@ -96,6 +110,27 @@ async function compileFarmDocsAdapterEdgeManifest(docs, options) {
   }
   return manifest;
 }
+async function listFarmDocsAdapterPages(docs, options) {
+  if (!hasFarmDocsRuntimeAdapter(docs)) return null;
+  const requireFromApp = createRequire(path.join(options.root, "package.json"));
+  const serverModule = await import(
+    /* @vite-ignore */
+    pathToFileURL(requireFromApp.resolve(docs.adapter.server)).href
+  );
+  if (typeof serverModule.listFarmDocsPages !== "function") return null;
+  const listPages = serverModule.listFarmDocsPages;
+  const pages = (await Promise.all(
+    getFarmDocsRoots(docs).map(
+      (root) => listPages(createFarmDocsAdapterRuntimeConfig(root, options), { rootDir: options.root })
+    )
+  )).flat();
+  if (!Array.isArray(pages) || pages.some((page) => typeof page !== "string" || !page.startsWith("/"))) {
+    throw new Error(
+      `Farm docs adapter ${JSON.stringify(docs.adapter.id)} listed docs pages that are not absolute paths.`
+    );
+  }
+  return [...new Set(pages)];
+}
 async function createFarmDocsAdapterHandler(docs, options) {
   if (!hasFarmDocsRuntimeAdapter(docs)) {
     throw new Error("Farm docs adapter requires server and react runtime entrypoints.");
@@ -104,26 +139,36 @@ async function createFarmDocsAdapterHandler(docs, options) {
   const serverModule = await options.loadModule(
     docs.adapter.server
   );
-  if (typeof serverModule.createFarmDocsRuntimeHandler !== "function") {
+  const multiRoot = Boolean(docs.roots?.length);
+  const handlerExport = multiRoot ? "createFarmDocsMultiRuntimeHandler" : "createFarmDocsRuntimeHandler";
+  if (typeof serverModule[handlerExport] !== "function") {
     const adapterId = JSON.stringify(docs.adapter.id);
     const serverEntry = JSON.stringify(docs.adapter.server);
     throw new Error(
-      `Farm docs adapter ${adapterId} does not export createFarmDocsRuntimeHandler from ${serverEntry}. Upgrade the adapter to a runtime-enabled release.`
+      `Farm docs adapter ${adapterId} does not export ${handlerExport} from ${serverEntry}. ` + (multiRoot ? "Upgrade the adapter to a release that serves several docs roots, or remove the roots." : "Upgrade the adapter to a runtime-enabled release.")
     );
   }
-  const runtimeConfig = createFarmDocsAdapterRuntimeConfig(
-    docs,
-    options,
-    await loadFarmDocsConfigModule(docs, options.loadModule)
-  );
-  return serverModule.createFarmDocsRuntimeHandler(runtimeConfig, {
+  const moduleConfig = await loadFarmDocsConfigModule(docs, options.loadModule);
+  const handlerOptions = {
     rootDir: options.root,
     clientEntry: options.clientEntry,
     stylesheets: getFarmDocsAdapterStylesheets(options),
     resolveLayoutFonts: options.resolveLayoutFonts,
     loadReactModule: () => options.loadModule(docs.adapter.react),
     ...options.registerMCPServer ? { registerMCPServer: options.registerMCPServer } : {}
-  });
+  };
+  if (multiRoot) {
+    return serverModule.createFarmDocsMultiRuntimeHandler(
+      getFarmDocsRoots(docs).map(
+        (root) => createFarmDocsAdapterRuntimeConfig(root, options, moduleConfig)
+      ),
+      handlerOptions
+    );
+  }
+  return serverModule.createFarmDocsRuntimeHandler(
+    createFarmDocsAdapterRuntimeConfig(docs, options, moduleConfig),
+    handlerOptions
+  );
 }
 
 // src/docs/api.ts
@@ -658,7 +703,9 @@ function createFarmDocsAPIHandler(options = {}, cloudIntegration) {
 export {
   hasFarmDocsRuntimeAdapter,
   assertFarmDocsAdapterServesNoGuardedPages,
+  getFarmDocsConfigModuleRoot,
   compileFarmDocsAdapterEdgeManifest,
+  listFarmDocsAdapterPages,
   createFarmDocsAdapterHandler,
   isFarmDocsAPIRequest,
   createDocsAPI,

package/dist/{chunk-VO6NLTV4.cjs → chunk-IFBINMI4.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkJ22JD5YJcjs = require('./chunk-J22JD5YJ.cjs');
+var _chunkRMPNYUGTcjs = require('./chunk-RMPNYUGT.cjs');
 
 
 var _chunkWJFFPXCVcjs = require('./chunk-WJFFPXCV.cjs');
@@ -273,7 +273,7 @@ function requestEvent(metadata, method, status, durationMs) {
     id: uuid(),
     requestId: metadata.id,
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    route: routeTemplate(_chunkJ22JD5YJcjs.getFarmRouteLabel.call(void 0, metadata.route)),
+    route: routeTemplate(_chunkRMPNYUGTcjs.getFarmRouteLabel.call(void 0, metadata.route)),
     agent: metadata.agent,
     kind: "request",
     method,
@@ -286,7 +286,7 @@ function toolEvent(metadata, event) {
     id: uuid(),
     requestId: metadata.id,
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    route: routeTemplate(_chunkJ22JD5YJcjs.getFarmRouteLabel.call(void 0, metadata.route)),
+    route: routeTemplate(_chunkRMPNYUGTcjs.getFarmRouteLabel.call(void 0, metadata.route)),
     agent: metadata.agent,
     kind: "mcp.tool",
     tool: event.tool,