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

package/dist/{chunk-J37KTQIA.cjs → chunk-NK2VWS7P.cjs}

@@ -13,6 +13,51 @@ var _path = require('path'); var _path2 = _interopRequireDefault(_path);
 
 // src/programmatic-routes-client.ts
 var _module = require('module');
+
+// src/browser-builtins.ts
+
+var FARM_BROWSER_BUILTIN_PREFIX = "\0farm:browser-builtin:";
+var BROWSER_IMPLEMENTATIONS = {
+  crypto: {
+    webcrypto: "globalThis.crypto",
+    subtle: "globalThis.crypto?.subtle",
+    getRandomValues: "(array) => globalThis.crypto.getRandomValues(array)",
+    randomUUID: "() => globalThis.crypto.randomUUID()"
+  }
+};
+var BROWSER_EXTERNAL_RE = /^(?:__vite-)?browser-external(?::|$)/;
+var IDENTIFIER_RE = /^[A-Za-z_$][\w$]*$/;
+async function resolveFarmBrowserBuiltin(context, source, importer, options) {
+  const resolved = await context.resolve(source, importer, { ...options, skipSelf: true });
+  if (!resolved || !BROWSER_EXTERNAL_RE.test(resolved.id)) return resolved;
+  return FARM_BROWSER_BUILTIN_PREFIX + source.replace(/^node:/, "");
+}
+function loadFarmBrowserBuiltin(id) {
+  if (!id.startsWith(FARM_BROWSER_BUILTIN_PREFIX)) return void 0;
+  const name = id.slice(FARM_BROWSER_BUILTIN_PREFIX.length);
+  const implementations = _nullishCoalesce(BROWSER_IMPLEMENTATIONS[name], () => ( {}));
+  const exports = Object.keys(_nullishCoalesce(process.getBuiltinModule(`node:${name}`), () => ( {}))).filter(
+    (key) => key !== "default" && IDENTIFIER_RE.test(key)
+  );
+  const implemented = exports.filter((key) => key in implementations);
+  return [
+    ...exports.map((key) => `export const ${key} = ${_nullishCoalesce(implementations[key], () => ( "undefined"))};`),
+    `export default { ${implemented.join(", ")} };`
+  ].join("\n");
+}
+function farmBrowserBuiltinsOptimizerPlugin() {
+  return {
+    name: "farm:browser-builtins-optimizer",
+    resolveId(source, importer, options) {
+      return _module.isBuiltin.call(void 0, source) ? resolveFarmBrowserBuiltin(this, source, importer, options) : null;
+    },
+    load(id) {
+      return _nullishCoalesce(loadFarmBrowserBuiltin(id), () => ( null));
+    }
+  };
+}
+
+// src/programmatic-routes-client.ts
 var _url = require('url');
 var SERVER_PROPS_KEYS = ["params", "search", "guard", "data"];
 function programmaticClientRouteKey(routesFile, kind, routePath) {
@@ -258,6 +303,7 @@ function isApplicationModuleId(id) {
   return MODULE_EXTENSION_RE.test(id.split("?", 1)[0]);
 }
 function isNodeBuiltinId(id) {
+  if (id.startsWith(FARM_BROWSER_BUILTIN_PREFIX)) return true;
   const external = id.indexOf("__vite-browser-external:");
   const bare = external === 0 || external === 1 ? id.slice(external + 24) : id;
   return bare.startsWith("node:") || NODE_BUILTINS.has(bare);
@@ -493,11 +539,11 @@ function compareOwners(left, right) {
   if (right.exportName === "default") return 1;
   return left.exportName < right.exportName ? -1 : left.exportName > right.exportName ? 1 : 0;
 }
-var IDENTIFIER_RE = /^[A-Za-z_$][\w$]*$/;
+var IDENTIFIER_RE2 = /^[A-Za-z_$][\w$]*$/;
 function importExport(value, local, toImportSpecifier) {
   const source = JSON.stringify(toImportSpecifier(value.file));
   if (value.exportName === "default") return `import ${local} from ${source};`;
-  const imported = IDENTIFIER_RE.test(value.exportName) ? value.exportName : JSON.stringify(value.exportName);
+  const imported = IDENTIFIER_RE2.test(value.exportName) ? value.exportName : JSON.stringify(value.exportName);
   return `import { ${imported} as ${local} } from ${source};`;
 }
 function toPosixPath(filePath) {
@@ -902,4 +948,7 @@ function transformError(id, message) {
 
 
 
-exports.programmaticClientRouteKey = programmaticClientRouteKey; exports.resolveProgrammaticClientRoutes = resolveProgrammaticClientRoutes; exports.createEvaluatedRouteGraph = createEvaluatedRouteGraph; exports.mergeProgrammaticClientRoutes = mergeProgrammaticClientRoutes; exports.generateProgrammaticClientRouteModule = generateProgrammaticClientRouteModule; exports.transformEnvironmentFunctions = transformEnvironmentFunctions; exports.farmEnvironmentFunctionsPlugin = farmEnvironmentFunctionsPlugin;
+
+
+
+exports.resolveFarmBrowserBuiltin = resolveFarmBrowserBuiltin; exports.loadFarmBrowserBuiltin = loadFarmBrowserBuiltin; exports.farmBrowserBuiltinsOptimizerPlugin = farmBrowserBuiltinsOptimizerPlugin; exports.programmaticClientRouteKey = programmaticClientRouteKey; exports.resolveProgrammaticClientRoutes = resolveProgrammaticClientRoutes; exports.createEvaluatedRouteGraph = createEvaluatedRouteGraph; exports.mergeProgrammaticClientRoutes = mergeProgrammaticClientRoutes; exports.generateProgrammaticClientRouteModule = generateProgrammaticClientRouteModule; exports.transformEnvironmentFunctions = transformEnvironmentFunctions; exports.farmEnvironmentFunctionsPlugin = farmEnvironmentFunctionsPlugin;

package/dist/{chunk-WSY2JD7O.mjs → chunk-NN3MOPSI.mjs}

@@ -33,7 +33,7 @@ import {
 } from "./chunk-2DA7CLY7.mjs";
 import {
   sendWebResponse
-} from "./chunk-IUQLRTTO.mjs";
+} from "./chunk-CO6UYM2D.mjs";
 import {
   createFarmAPIMiddlewarePathnames
 } from "./chunk-LM2YOGDK.mjs";

package/dist/{chunk-O3MMJPC2.cjs → chunk-NPQLMP7M.cjs}

@@ -71,7 +71,7 @@ var _chunkWT6RAN2Icjs = require('./chunk-WT6RAN2I.cjs');
 var _chunkWJFFPXCVcjs = require('./chunk-WJFFPXCV.cjs');
 
 
-var _chunkWAPQWAE6cjs = require('./chunk-WAPQWAE6.cjs');
+var _chunkCECUDGXQcjs = require('./chunk-CECUDGXQ.cjs');
 
 
 var _chunk5DX3O6TTcjs = require('./chunk-5DX3O6TT.cjs');
@@ -565,29 +565,35 @@ async function resolveDocsConfig(userDocs, options = {}) {
       config: { entry: "docs", docsPath: "/docs" }
     };
   }
-  const inlineDocsConfig = sanitizeDocsConfig(docsOptions.config || {});
+  const fileDocsConfig = omitDocsRoots(_optionalChain([loadedConfig, 'optionalAccess', _24 => _24.config]));
+  const inlineRawDocsConfig = omitDocsRoots(docsOptions.config);
+  const inlineDocsConfig = sanitizeDocsConfig(inlineRawDocsConfig);
   const directDocsConfig = sanitizeDocsConfig({
     ...docsOptions,
     adapter: void 0,
     enabled: void 0,
+    prerender: void 0,
     config: void 0,
-    configPath: void 0
+    configPath: void 0,
+    roots: void 0
   });
-  const loadedDocsConfig = sanitizeDocsConfig(_optionalChain([loadedConfig, 'optionalAccess', _24 => _24.config]) || {});
+  const loadedDocsConfig = sanitizeDocsConfig(fileDocsConfig);
   const mergedDocsConfig = {
     ...loadedDocsConfig,
     ...inlineDocsConfig,
     ...directDocsConfig
   };
   const runtimeDocsConfig = {
-    ..._optionalChain([loadedConfig, 'optionalAccess', _25 => _25.config]) || {},
-    ...isRecord(docsOptions.config) ? docsOptions.config : {},
+    ...fileDocsConfig,
+    ...inlineRawDocsConfig,
     ...omitUndefined({
       ...docsOptions,
       adapter: void 0,
       enabled: void 0,
+      prerender: void 0,
       config: void 0,
-      configPath: void 0
+      configPath: void 0,
+      roots: void 0
     })
   };
   const explicitRoute = typeof docsOptions.entry === "string" ? docsOptions.entry : void 0;
@@ -601,10 +607,33 @@ async function resolveDocsConfig(userDocs, options = {}) {
     docsOptions.contentDir || mergedDocsConfig.contentDir
   );
   const contentDir = configuredContentDir || await inferDocsContentDir(root, options.srcDir || "src", docsEntry);
+  const configOverrides = { ...inlineDocsConfig, ...directDocsConfig };
+  const configFileName = loadedConfig ? _path2.default.relative(root, loadedConfig.configPath) || loadedConfig.configPath : "the docs config";
+  const roots = await resolveDocsRoots(
+    [
+      { field: `roots in ${configFileName}`, roots: docsRootsOf(_optionalChain([loadedConfig, 'optionalAccess', _25 => _25.config])), file: true },
+      { field: "docs.config.roots", roots: docsRootsOf(docsOptions.config) },
+      { field: "docs.roots", roots: docsOptions.roots }
+    ],
+    {
+      root,
+      srcDir: options.srcDir || "src",
+      mainEntry: entryRoute,
+      mergedDocsConfig,
+      runtimeDocsConfig,
+      configOverrides
+    }
+  );
+  if (roots.length > 0 && !(docsOptions.adapter && docsOptions.adapter.server && docsOptions.adapter.react)) {
+    throw new Error(
+      `Docs roots require a docs adapter such as @farming-labs/farmjs; Farm's built-in docs renderer serves a single docs root. Install the adapter, or remove the roots from ${configFileName} and docs.roots.`
+    );
+  }
   return {
     enabled: true,
     entry: entryRoute,
     ...docsOptions.adapter ? { adapter: docsOptions.adapter } : {},
+    ...docsOptions.prerender === true ? { prerender: true } : {},
     contentDir,
     configPath: _optionalChain([loadedConfig, 'optionalAccess', _26 => _26.configPath]),
     config: {
@@ -619,9 +648,90 @@ async function resolveDocsConfig(userDocs, options = {}) {
       docsPath: entryRoute,
       ...contentDir ? { contentDir } : {}
     },
-    configOverrides: { ...inlineDocsConfig, ...directDocsConfig }
+    configOverrides,
+    ...roots.length > 0 ? { roots } : {}
   };
 }
+function docsRootsOf(config) {
+  return isRecord(config) ? config.roots : void 0;
+}
+function omitDocsRoots(config) {
+  if (!isRecord(config)) return {};
+  const { roots: _roots, ...rest } = config;
+  return rest;
+}
+function omitKeys(value, keys) {
+  const output = { ...value };
+  for (const key of keys) delete output[key];
+  return output;
+}
+async function resolveDocsRoots(sources, options) {
+  const declared = /* @__PURE__ */ new Map();
+  for (const source of sources) {
+    if (source.roots === void 0) continue;
+    if (!Array.isArray(source.roots)) throw new Error(`${source.field} must be an array.`);
+    const seen = /* @__PURE__ */ new Set();
+    for (const [index, rootInput] of source.roots.entries()) {
+      const field = `${source.field}[${index}].entry`;
+      if (!isRecord(rootInput) || typeof rootInput.entry !== "string" || !rootInput.entry.trim()) {
+        throw new Error(`${field} must be a route such as "/guides/docs".`);
+      }
+      const entryRoute = normalizeDocsRoute(rootInput.entry);
+      if (entryRoute === "/") {
+        throw new Error(
+          `${field} cannot be "/"; a docs root at "/" leaves no route for the others.`
+        );
+      }
+      if (entryRoute === options.mainEntry || seen.has(entryRoute)) {
+        throw new Error(
+          `${field} ${JSON.stringify(entryRoute)} is already served by another docs root.`
+        );
+      }
+      seen.add(entryRoute);
+      const { entry: _entry, ...fields } = rootInput;
+      const layers = _nullishCoalesce(declared.get(entryRoute), () => ( { file: {}, overrides: {} }));
+      if (source.file) layers.file = fields;
+      else layers.overrides = { ...layers.overrides, ...fields };
+      declared.set(entryRoute, layers);
+    }
+  }
+  const roots = [];
+  for (const [entryRoute, { file, overrides }] of declared) {
+    const docsEntry = docsRouteToEntry(entryRoute);
+    const contentDir = normalizeDocsContentDir(
+      typeof overrides.contentDir === "string" && overrides.contentDir || typeof file.contentDir === "string" && file.contentDir || void 0
+    ) || await inferDocsContentDir(options.root, options.srcDir, docsEntry);
+    const routeConfig = {
+      entry: docsEntry,
+      docsPath: entryRoute,
+      contentDir
+    };
+    const rootOverrides = sanitizeDocsConfig(overrides);
+    roots.push({
+      entry: entryRoute,
+      contentDir,
+      config: omitUndefined({
+        ...options.mergedDocsConfig,
+        ...sanitizeDocsConfig(file),
+        ...rootOverrides,
+        ...routeConfig
+      }),
+      runtimeConfig: omitUndefined({
+        ...options.runtimeDocsConfig,
+        ...file,
+        ...overrides,
+        ...routeConfig
+      }),
+      // The adapter reads the config file's own root from the config module, so the main
+      // root's overrides leave out whatever that root sets itself.
+      configOverrides: {
+        ...omitKeys(options.configOverrides, Object.keys(file)),
+        ...rootOverrides
+      }
+    });
+  }
+  return roots;
+}
 function validateRedirectConfigs(redirects, field) {
   for (const [index, redirect] of redirects.entries()) {
     _chunk6XQSPIN6cjs.validateConfigRouteSource.call(void 0, redirect.source, `${field}[${index}].source`);
@@ -721,6 +831,10 @@ async function resolveConfig(userConfig, mode) {
     userConfig.deploymentId || process.env.FARM_DEPLOYMENT_ID || process.env.VERCEL_GIT_COMMIT_SHA || process.env.CF_PAGES_COMMIT_SHA || (mode === "production" ? await generateBuildId() : "development")
   );
   const basePath = _chunkD22BUQKWcjs.normalizeFarmConfigBasePath.call(void 0, userConfig.basePath);
+  const mobileSessionPlugin = userConfig.mobile !== void 0 && userConfig.mobile !== null ? (await import("./session-AAU7RNRO.cjs")).createFarmMobileSessionPlugin({
+    basePath,
+    integrations: () => integrations
+  }) : null;
   const openapi = {
     enabled: false,
     route: "/docs/reference",
@@ -772,7 +886,8 @@ async function resolveConfig(userConfig, mode) {
     agent: resolveFarmAgentConfig(userConfig.agent, { docs: docs.enabled }),
     desktop: _nullishCoalesce(_optionalChain([desktopSetup, 'optionalAccess', _40 => _40.desktop]), () => ( null)),
     plugins: [
-      ..._chunkWAPQWAE6cjs.resolveIntegrationPlugins.call(void 0, integrations),
+      ...mobileSessionPlugin ? [mobileSessionPlugin] : [],
+      ..._chunkCECUDGXQcjs.resolveIntegrationPlugins.call(void 0, integrations),
       ...nativeMCPPlugin ? [nativeMCPPlugin] : [],
       ...userConfig.plugins || []
     ],

package/dist/{chunk-QK3HBOTG.cjs → chunk-NXBHYO7S.cjs}

@@ -7,11 +7,11 @@ var _chunkSJ23LJ3Ncjs = require('./chunk-SJ23LJ3N.cjs');
 var _chunkXPMC4E2Gcjs = require('./chunk-XPMC4E2G.cjs');
 
 
-var _chunkO3MMJPC2cjs = require('./chunk-O3MMJPC2.cjs');
+var _chunkNPQLMP7Mcjs = require('./chunk-NPQLMP7M.cjs');
 
 
 
-var _chunkDGOLAZLVcjs = require('./chunk-DGOLAZLV.cjs');
+var _chunk65Y5SIBHcjs = require('./chunk-65Y5SIBH.cjs');
 
 
 var _chunkLNM57D3Hcjs = require('./chunk-LNM57D3H.cjs');
@@ -91,7 +91,7 @@ async function createFarmRscViteConfig(userConfig, options) {
   for (const key of FARM_RSC_CONFIG_KEYS) {
     if (userConfig[key] !== void 0) rscConfig[key] = userConfig[key];
   }
-  const createReactPlugin = hasPluginNamed(vitePlugins, "vite:react") ? void 0 : await _asyncNullishCoalesce(await _asyncOptionalChain([viteReact, 'optionalAccess', async _2 => _2.default]), async () => ( (options.command === "serve" ? (await _chunkDGOLAZLVcjs.loadFarmReactPlugin.call(void 0, )).default : void 0)));
+  const createReactPlugin = hasPluginNamed(vitePlugins, "vite:react") ? void 0 : await _asyncNullishCoalesce(await _asyncOptionalChain([viteReact, 'optionalAccess', async _2 => _2.default]), async () => ( (options.command === "serve" ? (await _chunk65Y5SIBHcjs.loadFarmReactPlugin.call(void 0, )).default : void 0)));
   const tailwind = hasPluginNamed(vitePlugins, "@tailwindcss/vite") ? void 0 : await _chunkLNM57D3Hcjs.loadTailwindVitePlugin.call(void 0, );
   const farmConfig = pluginRsc.defineConfig({
     ...rscConfig,
@@ -99,7 +99,7 @@ async function createFarmRscViteConfig(userConfig, options) {
     port: _nullishCoalesce(options.port, () => ( _optionalChain([userConfig, 'access', _3 => _3.server, 'optionalAccess', _4 => _4.port]))),
     plugins: [
       ...options.command === "serve" && _chunkAQLHD6HZcjs.resolveFarmPlatform.call(void 0, ) === "desktop" ? [
-        _chunkDGOLAZLVcjs.farmDesktopDevGuardPlugin.call(void 0, 
+        _chunk65Y5SIBHcjs.farmDesktopDevGuardPlugin.call(void 0, 
           typeof userConfig.basePath === "string" ? userConfig.basePath : void 0
         )
       ] : [],
@@ -111,7 +111,7 @@ async function createFarmRscViteConfig(userConfig, options) {
         server: { environmentName: "rsc" },
         config: {
           preset: options.preset,
-          outputDir: options.outputDir && _chunkO3MMJPC2cjs.resolveDeployOutputPath.call(void 0, root, options.outputDir)
+          outputDir: options.outputDir && _chunkNPQLMP7Mcjs.resolveDeployOutputPath.call(void 0, root, options.outputDir)
         }
       })
     ]

package/dist/{chunk-S5ZA2T2W.mjs → chunk-PMKUU273.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-E73PGHSR.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-6CYQQQGR.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-75WWOZ5C.mjs → chunk-QOSDWGKT.mjs}

@@ -12,7 +12,7 @@ function farmDesktopDevGuardPlugin(basePath) {
       order: "pre",
       async handler(server) {
         if (resolveFarmPlatform() !== "desktop") return;
-        const { createFarmDesktopDevGuard } = await import("./dev-guard-4PFQNXQX.mjs");
+        const { createFarmDesktopDevGuard } = await import("./dev-guard-ONNMVQUN.mjs");
         server.middlewares.use(createFarmDesktopDevGuard(server, { basePath: basePath || "" }));
       }
     }

package/dist/{chunk-VO6NLTV4.cjs → chunk-QXPSWMUD.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 _chunkJ3LBO2O4cjs = require('./chunk-J3LBO2O4.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(_chunkJ3LBO2O4cjs.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(_chunkJ3LBO2O4cjs.getFarmRouteLabel.call(void 0, metadata.route)),
     agent: metadata.agent,
     kind: "mcp.tool",
     tool: event.tool,

package/dist/{chunk-Y7TLL65B.cjs → chunk-UQHIWZZ6.cjs}

@@ -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 (_optionalChain([options, 'access', _41 => _41.docsAdapterRoutes, 'optionalAccess', _42 => _42.owns, 'call', _43 => _43(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 && !_optionalChain([options, 'access', _44 => _44.docsAdapterRoutes, 'optionalAccess', _45 => _45.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) {
@@ -749,7 +756,7 @@ function fieldTsType(field) {
       case "json":
         return "unknown";
       case "enum":
-        return _optionalChain([field, 'access', _41 => _41.values, 'optionalAccess', _42 => _42.length]) ? field.values.map((value) => JSON.stringify(value)).join(" | ") : "string";
+        return _optionalChain([field, 'access', _46 => _46.values, 'optionalAccess', _47 => _47.length]) ? field.values.map((value) => JSON.stringify(value)).join(" | ") : "string";
       // id, uuid, string, text, datetime all travel as strings over JSON.
       default:
         return "string";
@@ -773,7 +780,7 @@ async function generateFarmTypeArtifacts(options) {
   const shouldGenerateApi = options.api !== false;
   const shouldGenerateEnv = options.env !== false;
   const shouldGenerateImages = options.images !== false;
-  const shouldGenerateI18n = options.i18n !== false && _optionalChain([options, 'access', _43 => _43.i18nConfig, 'optionalAccess', _44 => _44.enabled]);
+  const shouldGenerateI18n = options.i18n !== false && _optionalChain([options, 'access', _48 => _48.i18nConfig, 'optionalAccess', _49 => _49.enabled]);
   const sourceRoots = _chunk5Y2P454Ocjs.getFarmSourceRoots.call(void 0, { root, srcDir, layers: options.layers });
   const appDirs = _chunk5Y2P454Ocjs.getFarmAppDirectories.call(void 0, { root, srcDir, layers: options.layers });
   const result = {
@@ -893,7 +900,7 @@ async function generateFarmTypeArtifacts(options) {
       });
     }
   }
-  if (shouldRefreshUnifiedTypes && _optionalChain([options, 'access', _45 => _45.i18nConfig, 'optionalAccess', _46 => _46.enabled]) && !options.i18nTypesOutFile) {
+  if (shouldRefreshUnifiedTypes && _optionalChain([options, 'access', _50 => _50.i18nConfig, 'optionalAccess', _51 => _51.enabled]) && !options.i18nTypesOutFile) {
     const { signatures } = await _chunkBBPDJGCUcjs.readFarmI18nCatalogs.call(void 0, options.i18nConfig);
     unifiedSections.push(renderFarmI18nTypes(options.i18nConfig.locales, signatures));
     result.i18nTypesPath = unifiedTypesPath;

package/dist/{chunk-PPDHCRTC.mjs → chunk-VS7EHLLW.mjs}

@@ -1,6 +1,6 @@
 import {
   MiddlewareManager
-} from "./chunk-WSY2JD7O.mjs";
+} from "./chunk-NN3MOPSI.mjs";
 import {
   matchesMiddlewarePredicate
 } from "./chunk-EDPENAVO.mjs";