@farm.js/core 0.1.39 → 0.1.40

package/dist/{chunk-ZUPXLIGB.mjs → chunk-XKIUHXHW.mjs}

@@ -4,19 +4,20 @@ import {
 import {
   FARM_NODE_ENV_MODULE_FILE,
   FARM_NODE_ENV_MODULE_SOURCE,
+  createFarmBunServerEntry,
   createFarmNodeServerEntry,
   withProductionNodeEnv
-} from "./chunk-6BK3K2GB.mjs";
+} from "./chunk-UIDWEU7M.mjs";
 import {
   generateNativeMCPPluginSource,
   layoutsCanCoverSamePage
-} from "./chunk-677THUVP.mjs";
+} from "./chunk-CKFK3Z2V.mjs";
 import {
   assertFarmDocsAdapterServesNoGuardedPages,
   compileFarmDocsAdapterEdgeManifest,
   createFarmDocsAPIHandler,
   hasFarmDocsRuntimeAdapter
-} from "./chunk-YKZRDB5Z.mjs";
+} from "./chunk-IMQO6ZUU.mjs";
 import {
   FARM_DOCS_LAST_MODIFIED_MANIFEST,
   createFarmDocsHandler,
@@ -27,7 +28,7 @@ import {
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-5BWWFHR2.mjs";
+} from "./chunk-HBEBV7OZ.mjs";
 import {
   generateFarmDocsSearchClientRuntime,
   isFarmDocsSearchEnabled,
@@ -35,7 +36,7 @@ import {
 } from "./chunk-UP4CW6WP.mjs";
 import {
   FARM_PRERENDER_ENV
-} from "./chunk-BZHXGVMA.mjs";
+} from "./chunk-YJBWB6GF.mjs";
 import {
   loadFarmDocsEngine
 } from "./chunk-2VQKKQ6D.mjs";
@@ -44,7 +45,7 @@ import {
   getDeployTargetForPreset,
   hasCustomFarmRouteContext,
   resolveDeployOutputPath
-} from "./chunk-75HN5IZ3.mjs";
+} from "./chunk-Y4QVEU67.mjs";
 import {
   resolveFarmInstrumentationFile
 } from "./chunk-ZZSRYEYU.mjs";
@@ -54,7 +55,6 @@ import {
 import {
   DEFAULT_NOT_FOUND_STYLES,
   FARM_LAYOUT_ELEMENT_CLIENT_SOURCE,
-  PluginManager,
   SHARP_INSTALL_HINT,
   collectFarmWebMCPTools,
   createFarmApp,
@@ -65,7 +65,6 @@ import {
   enforceFarmIsolatedHydrationRouteBudget,
   farmDocsClientConfigPlugin,
   farmFontImportsPlugin,
-  farmPluginMayAffectRuntimePath,
   generateClientCachePersistenceCode,
   generateFarmClientPluginEntryCode,
   generateFarmIntegrationProviderClientCode,
@@ -83,13 +82,16 @@ import {
   resolveFarmIsolatedClientHydrationMode,
   resolveFarmNotFoundComponentPath,
   usesFarmServerTree
-} from "./chunk-HYTZYOW2.mjs";
+} from "./chunk-FCOLU5P6.mjs";
+import {
+  PluginManager
+} from "./chunk-FGH3ZXTP.mjs";
 import {
   findRequestBoundSourceBlockers,
   generateFarmTypeArtifacts,
   parseRouteRenderingDirective,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-CQMVIOYP.mjs";
+} from "./chunk-BPGO2IEP.mjs";
 import {
   FARM_API_CATALOG_PATH,
   FARM_APP_MANIFEST_LEGACY_PATH,
@@ -105,18 +107,21 @@ import {
   resolveFarmAppManifestInput,
   routeBoundaryCoversDirectory,
   stripRouteGroups
-} from "./chunk-GKBWWRBG.mjs";
+} from "./chunk-T6DLMX5V.mjs";
 import {
   FARM_DEFAULT_MCP_PATH,
   createFarmDefaultMCPServer,
   farmConfigMountsMCP
-} from "./chunk-P664ZVTV.mjs";
+} from "./chunk-4ZZNPK25.mjs";
+import {
+  farmPluginMayAffectRuntimePath
+} from "./chunk-Y5RG6B7S.mjs";
 import {
   isFarmPreviewDeploymentEnvironment
 } from "./chunk-BOYNDCZL.mjs";
 import {
   farmEnvironmentFunctionsPlugin
-} from "./chunk-E5GNDG5F.mjs";
+} from "./chunk-CALY6QG6.mjs";
 import {
   generateFarmDocsAdapterClientRuntime,
   getFarmDocsAdapterConfigModule
@@ -128,9 +133,6 @@ import {
 import {
   routeRulesToNitroRouteRules
 } from "./chunk-GHFS7RUB.mjs";
-import {
-  getFarmAppDirectories
-} from "./chunk-BUGNQIHC.mjs";
 import {
   REACT_RENDERER,
   getFarmRendererCapabilities,
@@ -143,7 +145,10 @@ import {
 import {
   applyFarmCspHashesToHtml,
   createFarmCspNonce
-} from "./chunk-U6QLDL3G.mjs";
+} from "./chunk-PNCM5MFD.mjs";
+import {
+  getFarmAppDirectories
+} from "./chunk-BUGNQIHC.mjs";
 import {
   applyFarmCronVercelCrons,
   createFarmCronCloudflareConfig,
@@ -155,31 +160,34 @@ import {
 } from "./chunk-4OOBRCJX.mjs";
 import {
   isFarmMarkdownPageFile
-} from "./chunk-QFW2IH5E.mjs";
+} from "./chunk-GZTUT75U.mjs";
 import {
   resolveFarmMdxComponentsModulePath,
   resolveMdxConfig
 } from "./chunk-FA2W42OV.mjs";
 import {
   getFarmMarkdownAlternatePath
-} from "./chunk-VNGH5MLF.mjs";
+} from "./chunk-I6UVKUYK.mjs";
 import {
   applyFarmWorkflowVercelCrons,
   prepareFarmWorkflowsForNitro
-} from "./chunk-Q2KB32T4.mjs";
+} from "./chunk-JXB6DVCO.mjs";
+import {
+  _collectFarmStorageModules
+} from "./chunk-JGHCKIRI.mjs";
 import {
   FARM_INTEGRATION_API_BASE_PATH_KEY,
   getFarmIntegrationPluginServerRuntime,
   getIntegrationProviders
-} from "./chunk-ATSDUUFK.mjs";
+} from "./chunk-AX7S67YV.mjs";
 import {
   appendMiddlewareDirectory,
   appendMiddlewareRoutePath,
   compareMiddlewareRouteLocations
-} from "./chunk-QYMZOOC5.mjs";
+} from "./chunk-LFHCG2DU.mjs";
 import {
   APIRouteManager
-} from "./chunk-WLL43JMO.mjs";
+} from "./chunk-T36UJS3X.mjs";
 import {
   readFarmI18nCatalogs
 } from "./chunk-QCFBDFRS.mjs";
@@ -206,13 +214,13 @@ import {
 } from "./chunk-BTHHUD7Q.mjs";
 import {
   FARM_VERSION
-} from "./chunk-SOP2EAA6.mjs";
+} from "./chunk-H56MQYEG.mjs";
 import {
   getFarmPresetRuntime
 } from "./chunk-2A3EQHXX.mjs";
 import {
   _runWithFarmCspNonce
-} from "./chunk-POSPE3IO.mjs";
+} from "./chunk-ZOABCQGT.mjs";
 import {
   compareRoutePatternSpecificity
 } from "./chunk-55YI3RRB.mjs";
@@ -221,7 +229,7 @@ import {
 } from "./chunk-LPEX4YW6.mjs";
 
 // src/build/index.ts
-import path9 from "path";
+import path10 from "path";
 import { existsSync as existsSync3 } from "fs";
 
 // src/nitro/client-css-href.ts
@@ -229,15 +237,15 @@ import path from "path";
 var FARM_CLIENT_CSS_HREF_PLACEHOLDER = "/__farm_client_css_href__";
 var FARM_CLIENT_JS_SRC_PLACEHOLDER = "/__farm_client_js_src__";
 async function hashAndCopy(sourcePath, destinationDir, hashedName) {
-  const fs3 = await import("fs/promises");
+  const fs4 = await import("fs/promises");
   try {
-    const bytes = await fs3.readFile(sourcePath);
+    const bytes = await fs4.readFile(sourcePath);
     if (bytes.length === 0) return null;
     const { createHash } = await import("crypto");
     const hash = createHash("sha256").update(bytes).digest("hex").slice(0, 8);
     const name = hashedName(hash);
-    await fs3.mkdir(destinationDir, { recursive: true });
-    await fs3.writeFile(path.join(destinationDir, name), bytes);
+    await fs4.mkdir(destinationDir, { recursive: true });
+    await fs4.writeFile(path.join(destinationDir, name), bytes);
     return name;
   } catch {
     return null;
@@ -254,9 +262,9 @@ async function resolveHashedClientCssHref(clientOutputDir) {
 }
 __name(resolveHashedClientCssHref, "resolveHashedClientCssHref");
 async function findFingerprintedClientEntry(clientOutputDir) {
-  const fs3 = await import("fs/promises");
+  const fs4 = await import("fs/promises");
   try {
-    const entries = await fs3.readdir(clientOutputDir);
+    const entries = await fs4.readdir(clientOutputDir);
     return entries.find((name) => /^farm-client-h[0-9a-f]+\.js$/.test(name)) ?? null;
   } catch {
     return null;
@@ -266,17 +274,17 @@ __name(findFingerprintedClientEntry, "findFingerprintedClientEntry");
 async function resolveHashedClientJsSrc(clientOutputDir) {
   const entryName = await findFingerprintedClientEntry(clientOutputDir);
   if (!entryName) return "/farm-client.js";
-  const fs3 = await import("fs/promises");
+  const fs4 = await import("fs/promises");
   const shim = `export * from "./${entryName}";
 `;
-  await fs3.writeFile(path.join(clientOutputDir, "farm-client.js"), shim);
+  await fs4.writeFile(path.join(clientOutputDir, "farm-client.js"), shim);
   return `/${entryName}`;
 }
 __name(resolveHashedClientJsSrc, "resolveHashedClientJsSrc");
 
 // src/nitro/universal-build.ts
 import os from "os";
-import path8 from "path";
+import path9 from "path";
 import { constants as fsConstants, existsSync as existsSync2, readFileSync, realpathSync, statSync } from "fs";
 import { fileURLToPath } from "url";
 import { builtinModules, createRequire } from "module";
@@ -704,10 +712,10 @@ async function createFarmRouteRuntimeManifest(options) {
 }
 __name(createFarmRouteRuntimeManifest, "createFarmRouteRuntimeManifest");
 async function writeFarmRouteRuntimeManifest(directory, manifest) {
-  const fs3 = await import("fs/promises");
+  const fs4 = await import("fs/promises");
   const manifestPath = path5.join(directory, FARM_ROUTE_RUNTIME_MANIFEST);
-  await fs3.mkdir(directory, { recursive: true });
-  await fs3.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
+  await fs4.mkdir(directory, { recursive: true });
+  await fs4.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
 `);
   return manifestPath;
 }
@@ -752,7 +760,7 @@ __name(normalizeManifestSource, "normalizeManifestSource");
 
 // src/nitro/vercel-route-runtime.ts
 import path6 from "path";
-async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs3, basePath = "/") {
+async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs4, basePath = "/") {
   const dynamicRoutes = manifest.routes.filter(
     (route) => route.rendering === "dynamic" && route.runtime !== "edge"
   );
@@ -783,8 +791,8 @@ async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs3, b
     groupIndex += 1;
     const functionName = `__farm_runtime_${groupIndex}`;
     const functionDir = path6.join(functionsDir, `${functionName}.func`);
-    await fs3.cp(baseFunctionDir, functionDir, { recursive: true, force: true });
-    await configureVercelFunction(functionDir, group.config, fs3);
+    await fs4.cp(baseFunctionDir, functionDir, { recursive: true, force: true });
+    await configureVercelFunction(functionDir, group.config, fs4);
     destinations.set(key, `/${functionName}`);
   }
   const routes = [];
@@ -798,17 +806,7 @@ async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs3, b
       regions: route.regions,
       maxDuration: route.maxDuration
     });
-    routes.push({
-      src,
-      dest: destinations.get(key) || "/__nitro",
-      ...route.kind === "api" || route.pattern.startsWith("/api/") ? {
-        headers: {
-          "Access-Control-Allow-Origin": "*",
-          "Access-Control-Allow-Methods": "*",
-          "Access-Control-Allow-Headers": "*"
-        }
-      } : {}
-    });
+    routes.push({ src, dest: destinations.get(key) || "/__nitro" });
   }
   return routes;
 }
@@ -833,15 +831,15 @@ function farmRoutePatternToVercelSource(pattern, basePath = "/") {
   return source === "/" ? normalizedBasePath : `${normalizedBasePath}${source}`;
 }
 __name(farmRoutePatternToVercelSource, "farmRoutePatternToVercelSource");
-async function configureVercelFunction(functionDir, config, fs3) {
+async function configureVercelFunction(functionDir, config, fs4) {
   const configPath = path6.join(functionDir, ".vc-config.json");
-  const current = JSON.parse(await fs3.readFile(configPath, "utf8"));
+  const current = JSON.parse(await fs4.readFile(configPath, "utf8"));
   const next = {
     ...current,
     ...config.regions?.length ? { regions: config.regions } : {},
     ...config.maxDuration ? { maxDuration: config.maxDuration } : {}
   };
-  await fs3.writeFile(configPath, `${JSON.stringify(next, null, 2)}
+  await fs4.writeFile(configPath, `${JSON.stringify(next, null, 2)}
 `);
 }
 __name(configureVercelFunction, "configureVercelFunction");
@@ -974,6 +972,39 @@ export default async function farmNetlifyHandler(request, context) {
 }
 __name(createFarmNetlifyEntry, "createFarmNetlifyEntry");
 
+// src/nitro/client-sourcemaps.ts
+import fs3 from "fs/promises";
+import path8 from "path";
+var FARM_CLIENT_SOURCEMAPS_DIR = "client-sourcemaps";
+function resolveFarmClientSourcemap(sourcemap) {
+  return sourcemap ? "hidden" : false;
+}
+__name(resolveFarmClientSourcemap, "resolveFarmClientSourcemap");
+function createFarmPrivateClientSourcemapsPlugin(options) {
+  let maps = [];
+  return {
+    name: "farm-private-client-sourcemaps",
+    enforce: "post",
+    generateBundle(_output, bundle) {
+      maps = [];
+      for (const [fileName, output] of Object.entries(bundle)) {
+        if (output.type !== "asset" || !fileName.endsWith(".map")) continue;
+        maps.push([fileName, output.source ?? ""]);
+        delete bundle[fileName];
+      }
+    },
+    async writeBundle() {
+      await fs3.rm(options.outDir, { recursive: true, force: true });
+      for (const [fileName, source] of maps) {
+        const target = path8.join(options.outDir, fileName);
+        await fs3.mkdir(path8.dirname(target), { recursive: true });
+        await fs3.writeFile(target, source);
+      }
+    }
+  };
+}
+__name(createFarmPrivateClientSourcemapsPlugin, "createFarmPrivateClientSourcemapsPlugin");
+
 // src/nitro/universal-build.ts
 function preloadFarmNitroBuilder() {
   return import("nitro/builder").then(
@@ -983,18 +1014,18 @@ function preloadFarmNitroBuilder() {
 }
 __name(preloadFarmNitroBuilder, "preloadFarmNitroBuilder");
 var _filename = typeof import.meta.url !== "undefined" ? fileURLToPath(import.meta.url) : "";
-var _dirname = path8.dirname(_filename);
+var _dirname = path9.dirname(_filename);
 function findFarmCoreRoot(from) {
-  let dir = path8.dirname(from);
-  while (dir !== path8.dirname(dir)) {
-    const manifest = path8.join(dir, "package.json");
+  let dir = path9.dirname(from);
+  while (dir !== path9.dirname(dir)) {
+    const manifest = path9.join(dir, "package.json");
     if (existsSync2(manifest)) {
       try {
         if (JSON.parse(readFileSync(manifest, "utf8")).name === "@farm.js/core") return dir;
       } catch {
       }
     }
-    dir = path8.dirname(dir);
+    dir = path9.dirname(dir);
   }
   return null;
 }
@@ -1006,16 +1037,16 @@ function toModulePath(file) {
 }
 __name(toModulePath, "toModulePath");
 function findInstalledPackageDir(name, from) {
-  for (let dir = from; ; dir = path8.dirname(dir)) {
-    const candidate = path8.join(dir, "node_modules", name);
-    if (existsSync2(path8.join(candidate, "package.json"))) {
+  for (let dir = from; ; dir = path9.dirname(dir)) {
+    const candidate = path9.join(dir, "node_modules", name);
+    if (existsSync2(path9.join(candidate, "package.json"))) {
       try {
         return realpathSync(candidate);
       } catch {
         return null;
       }
     }
-    if (dir === path8.dirname(dir)) return null;
+    if (dir === path9.dirname(dir)) return null;
   }
 }
 __name(findInstalledPackageDir, "findInstalledPackageDir");
@@ -1027,7 +1058,7 @@ function collectFarmDependencyDirs(root) {
     seen.add(dir);
     let manifest;
     try {
-      manifest = JSON.parse(readFileSync(path8.join(dir, "package.json"), "utf8"));
+      manifest = JSON.parse(readFileSync(path9.join(dir, "package.json"), "utf8"));
     } catch {
       return;
     }
@@ -1038,7 +1069,7 @@ function collectFarmDependencyDirs(root) {
   if (farmCoreRoot) visit(realpathSync(farmCoreRoot));
   queue.push({ name: "@farm.js/core", from: root });
   try {
-    const manifest = JSON.parse(readFileSync(path8.join(root, "package.json"), "utf8"));
+    const manifest = JSON.parse(readFileSync(path9.join(root, "package.json"), "utf8"));
     for (const field of ["dependencies", "devDependencies"]) {
       for (const name of Object.keys(manifest[field] ?? {})) {
         if (name.startsWith("@farm.js/")) queue.push({ name, from: root });
@@ -1105,15 +1136,15 @@ var FARM_SSR_PACKAGE_IMPORT = "#farm-ssr-entry";
 var FARM_SSR_OUTPUT_DIR = "farm-ssr";
 var FARM_CLIENT_BUILD_TARGET = ["es2020", "edge88", "firefox78", "chrome87", "safari14"];
 function resolveNitroRuntimeDependency(root, specifier) {
-  return createRequire(resolveNitroPackageEntry(root)).resolve(specifier).split(path8.sep).join("/");
+  return createRequire(resolveNitroPackageEntry(root)).resolve(specifier).split(path9.sep).join("/");
 }
 __name(resolveNitroRuntimeDependency, "resolveNitroRuntimeDependency");
 function resolveNitroInternalRuntimeAliases(root) {
-  const runtimeDir = path8.dirname(resolveNitroPackageEntry(root));
+  const runtimeDir = path9.dirname(resolveNitroPackageEntry(root));
   return Object.fromEntries(
     ["app", "error/hooks", "runtime-config", "shutdown", "task"].map((moduleName) => [
       `#nitro/runtime/${moduleName}`,
-      path8.join(runtimeDir, "internal", `${moduleName}.mjs`).split(path8.sep).join("/")
+      path9.join(runtimeDir, "internal", `${moduleName}.mjs`).split(path9.sep).join("/")
     ])
   );
 }
@@ -1124,7 +1155,7 @@ function createPrerenderRuntimeResolverPlugin(root, resolveNitroEntry = resolveN
     name: "farm-prerender-runtime-resolver",
     async resolveId(id, _importer, options) {
       if (options.custom?.farmPrerenderRuntimeResolve) return null;
-      if (id.startsWith("\0") || id.startsWith(".") || id.startsWith("#") || id.startsWith("virtual:") || path8.isAbsolute(id) || NODE_BUILTIN_MODULES.has(id)) {
+      if (id.startsWith("\0") || id.startsWith(".") || id.startsWith("#") || id.startsWith("virtual:") || path9.isAbsolute(id) || NODE_BUILTIN_MODULES.has(id)) {
         return null;
       }
       if (nitroEntry === void 0) {
@@ -1144,8 +1175,39 @@ function createPrerenderRuntimeResolverPlugin(root, resolveNitroEntry = resolveN
   };
 }
 __name(createPrerenderRuntimeResolverPlugin, "createPrerenderRuntimeResolverPlugin");
+function createFarmStorageModuleRegistration(config) {
+  const modules = _collectFarmStorageModules(config.storage);
+  if (modules.length === 0) return "";
+  const root = config.root || process.cwd();
+  const projectRequire = createRequire(path9.join(root, "package.json"));
+  let runtimeRequire = projectRequire;
+  try {
+    runtimeRequire = createRequire(projectRequire.resolve("@farm.js/core"));
+  } catch {
+  }
+  const loaders = [];
+  for (const specifier of modules) {
+    let resolved;
+    for (const require2 of [runtimeRequire, projectRequire]) {
+      try {
+        resolved = require2.resolve(specifier);
+        break;
+      } catch {
+      }
+    }
+    if (resolved) {
+      loaders.push(
+        `  ${JSON.stringify(specifier)}: () => import(${toVirtualEntryImportSpecifier(resolved)}),`
+      );
+    }
+  }
+  return loaders.length > 0 ? `_registerFarmStorageModules({
+${loaders.join("\n")}
+});` : "";
+}
+__name(createFarmStorageModuleRegistration, "createFarmStorageModuleRegistration");
 function resolveNitroPackageEntry(root) {
-  const projectRequire = createRequire(path8.join(root, "package.json"));
+  const projectRequire = createRequire(path9.join(root, "package.json"));
   let runtimeRequire = projectRequire;
   try {
     runtimeRequire = createRequire(projectRequire.resolve("@farm.js/core"));
@@ -1220,7 +1282,7 @@ function createFarmReactWebServerAlias(hasEdgeBuild) {
 __name(createFarmReactWebServerAlias, "createFarmReactWebServerAlias");
 function hasReactDomEdgeServerBuild(root) {
   try {
-    createRequire(path8.join(root, "package.json")).resolve("react-dom/server.edge");
+    createRequire(path9.join(root, "package.json")).resolve("react-dom/server.edge");
     return true;
   } catch {
     return false;
@@ -1270,6 +1332,45 @@ function createReactProductionModePlugin() {
   };
 }
 __name(createReactProductionModePlugin, "createReactProductionModePlugin");
+var FARM_OMITTED_METADATA_IMAGE_RUNTIME_ID = "\0farm-omitted-metadata-image-runtime";
+function isFarmCoreModule(file) {
+  let dir = path9.dirname(file.split("?", 1)[0]);
+  while (dir !== path9.dirname(dir)) {
+    const manifest = path9.join(dir, "package.json");
+    if (existsSync2(manifest)) {
+      try {
+        return JSON.parse(readFileSync(manifest, "utf8")).name === "@farm.js/core";
+      } catch {
+        return false;
+      }
+    }
+    dir = path9.dirname(dir);
+  }
+  return false;
+}
+__name(isFarmCoreModule, "isFarmCoreModule");
+function createOmittedMetadataImageRuntimePlugin(externalizeOtherImports) {
+  return {
+    name: "farm-omitted-metadata-image-runtime",
+    resolveId(source, importer) {
+      if (source !== "@vercel/og") return null;
+      const fromCoreRuntime = importer !== void 0 && isFarmCoreModule(importer) && !/^og\.[cm]?[jt]sx?$/.test(path9.basename(importer.split("?", 1)[0]));
+      if (fromCoreRuntime) return FARM_OMITTED_METADATA_IMAGE_RUNTIME_ID;
+      return externalizeOtherImports ? { id: source, external: true } : null;
+    },
+    load(id) {
+      if (id !== FARM_OMITTED_METADATA_IMAGE_RUNTIME_ID) return null;
+      return `
+export class ImageResponse {
+  constructor() {
+    throw new Error("@vercel/og is not in this server build because the app has no generated metadata image route.");
+  }
+}
+`;
+    }
+  };
+}
+__name(createOmittedMetadataImageRuntimePlugin, "createOmittedMetadataImageRuntimePlugin");
 function createMetadataImageWasmPlugin() {
   return {
     name: "farm-metadata-image-wasm",
@@ -1278,7 +1379,7 @@ function createMetadataImageWasmPlugin() {
         return null;
       }
       const requestPath = source.slice(0, -"?module".length);
-      const resolvedPath = path8.isAbsolute(requestPath) ? requestPath : path8.resolve(path8.dirname(importer.split("?", 1)[0]), requestPath);
+      const resolvedPath = path9.isAbsolute(requestPath) ? requestPath : path9.resolve(path9.dirname(importer.split("?", 1)[0]), requestPath);
       return `${FARM_METADATA_IMAGE_WASM_PREFIX}${resolvedPath}`;
     },
     load(id) {
@@ -1304,11 +1405,11 @@ function collectSSRExternalPackages(ssrBundle) {
     for (const importId of [...output.imports, ...output.dynamicImports]) {
       const normalizedImportId = importId.replace(/\\/g, "/");
       const normalizedId = normalizedImportId.replace(/^\.\//, "");
-      const resolvedRelativeId = normalizedImportId.startsWith("./") || normalizedImportId.startsWith("../") ? path8.posix.normalize(path8.posix.join(path8.posix.dirname(fileName), normalizedImportId)) : null;
+      const resolvedRelativeId = normalizedImportId.startsWith("./") || normalizedImportId.startsWith("../") ? path9.posix.normalize(path9.posix.join(path9.posix.dirname(fileName), normalizedImportId)) : null;
       if (emittedFiles.has(normalizedId) || resolvedRelativeId !== null && emittedFiles.has(resolvedRelativeId) || NODE_BUILTIN_MODULES.has(importId) || importId.startsWith("node:")) {
         continue;
       }
-      if (path8.isAbsolute(importId) || /^[A-Za-z]:[\\/]/.test(importId) || importId.startsWith("#") || importId.startsWith("\0")) {
+      if (path9.isAbsolute(importId) || /^[A-Za-z]:[\\/]/.test(importId) || importId.startsWith("#") || importId.startsWith("\0")) {
         externalPackages.add(importId);
         continue;
       }
@@ -1321,15 +1422,15 @@ function collectSSRExternalPackages(ssrBundle) {
 }
 __name(collectSSRExternalPackages, "collectSSRExternalPackages");
 function createExternalSSRBundlePlugin(nitroEntryPath, ssrOutputDir, ssrEntryFile) {
-  const resolvedNitroEntry = path8.resolve(nitroEntryPath);
-  const resolvedSSREntry = path8.resolve(ssrOutputDir, ssrEntryFile);
+  const resolvedNitroEntry = path9.resolve(nitroEntryPath);
+  const resolvedSSREntry = path9.resolve(ssrOutputDir, ssrEntryFile);
   return {
     name: "farm-externalize-prebuilt-ssr",
     resolveId(source, importer) {
-      if (!importer || path8.resolve(importer) !== resolvedNitroEntry) {
+      if (!importer || path9.resolve(importer) !== resolvedNitroEntry) {
         return null;
       }
-      const resolvedImport = path8.resolve(path8.dirname(importer), source);
+      const resolvedImport = path9.resolve(path9.dirname(importer), source);
       if (resolvedImport !== resolvedSSREntry) return null;
       return { id: FARM_SSR_PACKAGE_IMPORT, external: true };
     }
@@ -1348,6 +1449,10 @@ function hasFarmServerCacheConfig(cache) {
   return cache.adapter !== void 0 || cache.namespace !== void 0 || cache.maxEntries !== void 0 || cache.lease !== void 0;
 }
 __name(hasFarmServerCacheConfig, "hasFarmServerCacheConfig");
+function hasFarmServerStorageConfig(storage) {
+  return !!storage && typeof storage === "object" && Reflect.ownKeys(storage).length > 0;
+}
+__name(hasFarmServerStorageConfig, "hasFarmServerStorageConfig");
 function hasFarmRuntimeConfigModule(config, configModulePath) {
   return Boolean(configModulePath || (config.layers || []).some((layer) => layer.configFile));
 }
@@ -1457,13 +1562,13 @@ function resolveBuildDocsContentDir(config, root) {
   if (!config.docs?.enabled) return null;
   const configuredContentDir = config.docs.contentDir || config.docs.config.contentDir;
   if (typeof configuredContentDir === "string" && configuredContentDir.trim()) {
-    const contentDir = path8.isAbsolute(configuredContentDir) ? configuredContentDir : path8.join(root, configuredContentDir);
+    const contentDir = path9.isAbsolute(configuredContentDir) ? configuredContentDir : path9.join(root, configuredContentDir);
     return existsSync2(contentDir) ? contentDir : null;
   }
   const entryDir = config.docs.config.entry || trimSlashes(config.docs.entry) || "docs";
-  const appDocsDir = path8.join(root, config.srcDir || "src", "app", entryDir);
+  const appDocsDir = path9.join(root, config.srcDir || "src", "app", entryDir);
   if (existsSync2(appDocsDir)) return appDocsDir;
-  const rootDocsDir = path8.join(root, entryDir);
+  const rootDocsDir = path9.join(root, entryDir);
   return existsSync2(rootDocsDir) ? rootDocsDir : null;
 }
 __name(resolveBuildDocsContentDir, "resolveBuildDocsContentDir");
@@ -1481,7 +1586,7 @@ function hasProjectPostcssConfig(root) {
     ".postcssrc.mjs",
     ".postcssrc.ts"
   ];
-  const projectRequire = createRequire(path8.join(root, "package.json"));
+  const projectRequire = createRequire(path9.join(root, "package.json"));
   return candidates.some((file) => {
     try {
       projectRequire.resolve(`./${file}`);
@@ -1493,7 +1598,7 @@ function hasProjectPostcssConfig(root) {
 }
 __name(hasProjectPostcssConfig, "hasProjectPostcssConfig");
 async function findFarmConfigPath(root) {
-  const fs3 = await import("fs/promises");
+  const fs4 = await import("fs/promises");
   const candidates = [
     "farm.config.ts",
     "farm.config.mts",
@@ -1505,9 +1610,9 @@ async function findFarmConfigPath(root) {
     "config.mjs"
   ];
   for (const candidate of candidates) {
-    const resolvedPath = path8.join(root, candidate);
+    const resolvedPath = path9.join(root, candidate);
     try {
-      await fs3.access(resolvedPath);
+      await fs4.access(resolvedPath);
       return resolvedPath;
     } catch {
     }
@@ -1535,13 +1640,13 @@ function farmServerRuntimePluginsMayHandlePath(config, pathname) {
 }
 __name(farmServerRuntimePluginsMayHandlePath, "farmServerRuntimePluginsMayHandlePath");
 async function discoverMiddlewareRoutes(appDir) {
-  const fs3 = await import("fs/promises");
+  const fs4 = await import("fs/promises");
   const appDirs = Array.isArray(appDir) ? [...appDir] : [appDir];
   const routes = /* @__PURE__ */ new Map();
   async function walk(dir, routePath, directory, discovered) {
     let entries;
     try {
-      entries = await fs3.readdir(dir, { withFileTypes: true });
+      entries = await fs4.readdir(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -1552,7 +1657,7 @@ async function discoverMiddlewareRoutes(appDir) {
       discovered.push({
         path: routePath,
         directory,
-        filePath: path8.join(dir, middlewareFile.name)
+        filePath: path9.join(dir, middlewareFile.name)
       });
     }
     for (const entry of entries) {
@@ -1560,7 +1665,7 @@ async function discoverMiddlewareRoutes(appDir) {
         continue;
       }
       await walk(
-        path8.join(dir, entry.name),
+        path9.join(dir, entry.name),
         appendMiddlewareRoutePath(routePath, entry.name),
         appendMiddlewareDirectory(directory, entry.name),
         discovered
@@ -1637,21 +1742,21 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
       })
     );
     logger.info(`\u{1F4CB} Found ${pageRoutes.length} page routes`);
-    const fs3 = await import("fs/promises");
+    const fs4 = await import("fs/promises");
     const layoutRoutes = [];
-    const appDir = path8.join(root, srcDir, "app");
+    const appDir = path9.join(root, srcDir, "app");
     async function findLayoutsForClient(dir, routePrefix = "/") {
       try {
-        const entries = await fs3.readdir(dir, { withFileTypes: true });
+        const entries = await fs4.readdir(dir, { withFileTypes: true });
         for (const entry of entries) {
           if (entry.isFile() && entry.name.match(/^layout\.(tsx?|jsx?|vue|svelte)$/)) {
             layoutRoutes.push({
               pattern: routePrefix,
-              modulePath: path8.join(dir, entry.name)
+              modulePath: path9.join(dir, entry.name)
             });
           } else if (entry.isDirectory() && !entry.name.startsWith(".") && !entry.name.startsWith("_")) {
             const childPrefix = routePrefix === "/" ? `/${entry.name}` : `${routePrefix}/${entry.name}`;
-            await findLayoutsForClient(path8.join(dir, entry.name), childPrefix);
+            await findLayoutsForClient(path9.join(dir, entry.name), childPrefix);
           }
         }
       } catch {
@@ -1668,7 +1773,7 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
     logger.info(`\u{1F4CB} Found ${pageRoutes.length} page routes and ${layoutRoutes.length} layouts`);
     const isolatedClientBoundaryModules = routeManager.getIsolatedClientBoundaryModules(root);
     const hydrationPlanCache = /* @__PURE__ */ new Map();
-    const clientOutputDir = path8.join(root, distDir, "client");
+    const clientOutputDir = path9.join(root, distDir, "client");
     const [productionViteResult] = await productionViteResultPromise;
     if (productionViteResult.status === "rejected") {
       await routeRuntimeManifestResultPromise;
@@ -1687,7 +1792,8 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
       routeSlots,
       isolatedClientBoundaryModules,
       hydrationPlanCache,
-      rendererBuildLifetime
+      rendererBuildLifetime,
+      routeManager.getProgrammaticClientRoutes()
     ), "buildClientBundle");
     const buildSSRBundle = /* @__PURE__ */ __name(() => buildSSRInMemory(
       productionVite,
@@ -1739,7 +1845,8 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
           routeSlots,
           isolatedClientBoundaryModules,
           hydrationPlanCache,
-          rendererBuildLifetime
+          rendererBuildLifetime,
+          routeManager.getProgrammaticClientRoutes()
         );
       } catch (retryError) {
         if (!(retryError instanceof IncompleteClientBuildOutputError)) throw retryError;
@@ -1777,10 +1884,10 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
       lifecyclePluginManager
     );
     const runtimeManifestPath = await writeFarmRouteRuntimeManifest(
-      path8.join(root, distDir),
+      path9.join(root, distDir),
       routeRuntimeManifest
     );
-    logger.info(`\u{1F4CB} Route runtime manifest: ${path8.relative(root, runtimeManifestPath)}`);
+    logger.info(`\u{1F4CB} Route runtime manifest: ${path9.relative(root, runtimeManifestPath)}`);
   } catch (error) {
     if (lifecyclePluginManager) {
       await lifecyclePluginManager.runHookParallel("onError", {
@@ -1800,50 +1907,50 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
 }
 __name(buildUniversal, "buildUniversal");
 async function writeSSRAssetsToClient(bundle, outputDir) {
-  const fs3 = await import("fs/promises");
+  const fs4 = await import("fs/promises");
   for (const [fileName, output] of Object.entries(bundle)) {
     if (output.type !== "asset") continue;
     if (fileName === "farm-fonts.css") {
       await mergeBuiltFontCss(outputDir, output.source);
       continue;
     }
-    const filePath = path8.join(outputDir, fileName);
-    await fs3.mkdir(path8.dirname(filePath), { recursive: true });
-    await fs3.writeFile(filePath, output.source);
+    const filePath = path9.join(outputDir, fileName);
+    await fs4.mkdir(path9.dirname(filePath), { recursive: true });
+    await fs4.writeFile(filePath, output.source);
   }
 }
 __name(writeSSRAssetsToClient, "writeSSRAssetsToClient");
 async function copyFarmDocsFontAssetsToClient(root, outputDir) {
-  const fs3 = await import("fs/promises");
+  const fs4 = await import("fs/promises");
   await Promise.all(
     resolveFarmDocsFontAssets(root).map(async ({ sourcePath, url }) => {
-      const targetPath = path8.join(outputDir, url.replace(/^\/+/, ""));
-      await fs3.mkdir(path8.dirname(targetPath), { recursive: true });
-      await fs3.copyFile(sourcePath, targetPath);
+      const targetPath = path9.join(outputDir, url.replace(/^\/+/, ""));
+      await fs4.mkdir(path9.dirname(targetPath), { recursive: true });
+      await fs4.copyFile(sourcePath, targetPath);
     })
   );
 }
 __name(copyFarmDocsFontAssetsToClient, "copyFarmDocsFontAssetsToClient");
 async function mergeBuiltFontCss(outputDir, fontCssSource) {
-  const fs3 = await import("fs/promises");
-  const fontCssPath = path8.join(outputDir, "farm-fonts.css");
+  const fs4 = await import("fs/promises");
+  const fontCssPath = path9.join(outputDir, "farm-fonts.css");
   let fontCss = fontCssSource;
   if (fontCss === void 0) {
     try {
-      fontCss = await fs3.readFile(fontCssPath);
+      fontCss = await fs4.readFile(fontCssPath);
     } catch {
       return;
     }
   }
-  const clientCssPath = path8.join(outputDir, "farm-client.css");
+  const clientCssPath = path9.join(outputDir, "farm-client.css");
   let clientCss = "";
   try {
-    clientCss = await fs3.readFile(clientCssPath, "utf8");
+    clientCss = await fs4.readFile(clientCssPath, "utf8");
   } catch {
   }
   const normalizedFontCss = typeof fontCss === "string" ? fontCss : Buffer.from(fontCss).toString("utf8");
-  await fs3.writeFile(fontCssPath, normalizedFontCss);
-  await fs3.writeFile(clientCssPath, mergeFarmFontCss(clientCss, normalizedFontCss));
+  await fs4.writeFile(fontCssPath, normalizedFontCss);
+  await fs4.writeFile(clientCssPath, mergeFarmFontCss(clientCss, normalizedFontCss));
 }
 __name(mergeBuiltFontCss, "mergeBuiltFontCss");
 var _IncompleteClientBuildOutputError = class _IncompleteClientBuildOutputError extends Error {
@@ -1855,28 +1962,28 @@ var _IncompleteClientBuildOutputError = class _IncompleteClientBuildOutputError
 __name(_IncompleteClientBuildOutputError, "IncompleteClientBuildOutputError");
 var IncompleteClientBuildOutputError = _IncompleteClientBuildOutputError;
 async function validateClientBuildOutput(root, srcDir, outputDir) {
-  const fs3 = await import("fs/promises");
+  const fs4 = await import("fs/promises");
   const fingerprinted = await findFingerprintedClientEntry(outputDir);
-  const clientEntryPath = path8.join(outputDir, fingerprinted ?? "farm-client.js");
+  const clientEntryPath = path9.join(outputDir, fingerprinted ?? "farm-client.js");
   let clientEntrySize = 0;
   try {
-    const clientEntry = await fs3.stat(clientEntryPath);
+    const clientEntry = await fs4.stat(clientEntryPath);
     if (clientEntry.isFile()) clientEntrySize = clientEntry.size;
   } catch {
   }
   if (clientEntrySize === 0) {
     throw new IncompleteClientBuildOutputError("farm-client.js is missing or empty");
   }
-  const clientCssPath = path8.join(outputDir, "farm-client.css");
-  const globalsCssPath = path8.join(root, srcDir, "app", "globals.css");
+  const clientCssPath = path9.join(outputDir, "farm-client.css");
+  const globalsCssPath = path9.join(root, srcDir, "app", "globals.css");
   let expectsCss = false;
   try {
-    const globalsCss = await fs3.readFile(globalsCssPath, "utf8");
+    const globalsCss = await fs4.readFile(globalsCssPath, "utf8");
     expectsCss = globalsCss.replace(/\/\*[\s\S]*?\*\//g, "").trim().length > 0;
   } catch {
   }
   try {
-    const clientCss = await fs3.stat(clientCssPath);
+    const clientCss = await fs4.stat(clientCssPath);
     if (expectsCss && (!clientCss.isFile() || clientCss.size === 0)) {
       throw new IncompleteClientBuildOutputError("farm-client.css is empty");
     }
@@ -1885,12 +1992,12 @@ async function validateClientBuildOutput(root, srcDir, outputDir) {
     if (expectsCss) {
       throw new IncompleteClientBuildOutputError("farm-client.css is missing");
     }
-    await fs3.writeFile(clientCssPath, "");
+    await fs4.writeFile(clientCssPath, "");
   }
 }
 __name(validateClientBuildOutput, "validateClientBuildOutput");
 function getCachedClientModuleHydrationPlan(modulePath, root, mode, cache, options = {}) {
-  const key = `${path8.resolve(root)}\0${mode}\0${options.asyncOwnerIslands === true}\0${path8.resolve(modulePath)}`;
+  const key = `${path9.resolve(root)}\0${mode}\0${options.asyncOwnerIslands === true}\0${path9.resolve(modulePath)}`;
   let plan = cache.get(key);
   if (!plan) {
     plan = getClientModuleHydrationPlan(modulePath, root, mode, options);
@@ -1899,11 +2006,11 @@ function getCachedClientModuleHydrationPlan(modulePath, root, mode, cache, optio
   return { ...plan, isolatedBoundaries: [...plan.isolatedBoundaries] };
 }
 __name(getCachedClientModuleHydrationPlan, "getCachedClientModuleHydrationPlan");
-async function buildClient(productionVite, config, root, srcDir, outputDir, pageRoutes, layoutRoutes = [], routeSlots = [], isolatedClientBoundaryModules = /* @__PURE__ */ new Set(), hydrationPlanCache = /* @__PURE__ */ new Map(), rendererBuildLifetime) {
+async function buildClient(productionVite, config, root, srcDir, outputDir, pageRoutes, layoutRoutes = [], routeSlots = [], isolatedClientBoundaryModules = /* @__PURE__ */ new Set(), hydrationPlanCache = /* @__PURE__ */ new Map(), rendererBuildLifetime, programmaticClientRoutes) {
   const viteBuild = productionVite.build;
   const { farmPlugin, farmServerOnlyEntriesPlugin } = await import("./vite.mjs");
-  const { PluginManager: PluginManager2 } = await import("./plugin.mjs");
-  const fs3 = await import("fs/promises");
+  const { PluginManager: PluginManager2 } = await import("./plugin-SYMK7PQ2.mjs");
+  const fs4 = await import("fs/promises");
   const pluginManager = new PluginManager2({
     config,
     isDev: false,
@@ -2129,10 +2236,10 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   logger.info(
     `\u{1F4F1} Total hydratable routes detected: ${clientPages.length} pages, ${clientLayouts.filter((layout) => layout.shouldHydrate || layout.hasIsolatedClientBoundaries).length} layouts, and ${clientRouteSlots.length} slots`
   );
-  const clientEntryRoot = path8.join(root, ".farm", "tmp");
-  await fs3.mkdir(clientEntryRoot, { recursive: true });
-  const clientEntryDir = await fs3.mkdtemp(path8.join(clientEntryRoot, "client-entry-"));
-  const clientEntryPath = path8.join(clientEntryDir, "farm-client-entry.tsx");
+  const clientEntryRoot = path9.join(root, ".farm", "tmp");
+  await fs4.mkdir(clientEntryRoot, { recursive: true });
+  const clientEntryDir = await fs4.mkdtemp(path9.join(clientEntryRoot, "client-entry-"));
+  const clientEntryPath = path9.join(clientEntryDir, "farm-client-entry.tsx");
   const clientHydrationCode = generateClientHydrationEntry(
     clientPages,
     clientLayouts,
@@ -2153,7 +2260,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     generateClientCachePersistenceCode(resolveFarmClientCacheAdapterEntry(root, config.cache)),
     adapterOwnsDocsRuntime ? getFarmDocsAdapterConfigModule(config.docs) : void 0
   );
-  await fs3.writeFile(clientEntryPath, clientHydrationCode);
+  await fs4.writeFile(clientEntryPath, clientHydrationCode);
   const hasScopedPostcssConfig = hasProjectPostcssConfig(root);
   let postcssSearchPath;
   let tailwindVitePlugin = void 0;
@@ -2164,8 +2271,8 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   if (hasScopedPostcssConfig) {
     logger.info("\u{1F4E6} Using project PostCSS/Tailwind configuration");
   } else {
-    const postcssConfigPath = path8.join(clientEntryDir, "postcss.config.cjs");
-    await fs3.writeFile(postcssConfigPath, "module.exports = { plugins: [] };\n");
+    const postcssConfigPath = path9.join(clientEntryDir, "postcss.config.cjs");
+    await fs4.writeFile(postcssConfigPath, "module.exports = { plugins: [] };\n");
     postcssSearchPath = clientEntryDir;
     tailwindVitePlugin = await loadTailwindVitePlugin({
       builder: productionVite.builder,
@@ -2187,6 +2294,8 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         target: FARM_CLIENT_BUILD_TARGET,
         outDir: outputDir,
         emptyOutDir: true,
+        // Never public: see resolveFarmClientSourcemap.
+        sourcemap: resolveFarmClientSourcemap(config.vite?.build?.sourcemap),
         assetsInlineLimit: 0,
         cssCodeSplit: false,
         // Bundle all CSS into one file
@@ -2237,15 +2346,18 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       },
       plugins: [
         createFarmThemeCssPlugin(config.theme, config.basePath),
+        createFarmPrivateClientSourcemapsPlugin({
+          outDir: path9.join(path9.dirname(outputDir), FARM_CLIENT_SOURCEMAPS_DIR)
+        }),
         createFarmClientModulePreloadPlugin({
           root,
-          buildDir: path8.dirname(outputDir),
+          buildDir: path9.dirname(outputDir),
           entryName: "farm-client"
         }),
         ...adapterOwnsDocsRuntime ? [
           createFarmDocsModulePreloadPlugin({
             root,
-            buildDir: path8.dirname(outputDir),
+            buildDir: path9.dirname(outputDir),
             importer: clientEntryPath,
             entryName: "farm-client",
             modules: [
@@ -2308,8 +2420,11 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
             return null;
           }
         },
-        farmPlugin({ ...config, isolatedClientBoundaryModules }, pluginManager),
-        farmEnvironmentFunctionsPlugin()
+        farmPlugin(
+          { ...config, isolatedClientBoundaryModules, programmaticClientRoutes },
+          pluginManager
+        ),
+        farmEnvironmentFunctionsPlugin(config)
       ],
       mode: "production",
       css: postcssSearchPath ? {
@@ -2335,7 +2450,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     await validateClientBuildOutput(root, srcDir, outputDir);
   } finally {
     try {
-      await fs3.rm(clientEntryDir, { recursive: true, force: true });
+      await fs4.rm(clientEntryDir, { recursive: true, force: true });
     } catch {
     }
   }
@@ -2343,12 +2458,12 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
 __name(buildClient, "buildClient");
 function toBakedMarkdownSourcePath(root, filePath) {
   if (!filePath) return "";
-  if (!path8.isAbsolute(filePath)) return filePath.split(path8.sep).join("/");
-  const relative = path8.relative(root, filePath);
-  if (!relative || relative.startsWith("..") || path8.isAbsolute(relative)) {
-    return path8.basename(filePath);
+  if (!path9.isAbsolute(filePath)) return filePath.split(path9.sep).join("/");
+  const relative = path9.relative(root, filePath);
+  if (!relative || relative.startsWith("..") || path9.isAbsolute(relative)) {
+    return path9.basename(filePath);
   }
-  return relative.split(path8.sep).join("/");
+  return relative.split(path9.sep).join("/");
 }
 __name(toBakedMarkdownSourcePath, "toBakedMarkdownSourcePath");
 function generateUniversalRouterStateRuntime() {
@@ -3105,7 +3220,7 @@ __farmConfigureApp(__farmAppSetup);` : `import React, { createRoot, hydrateRoot
     root,
     renderer.componentExtensions ?? []
   );
-  const globalsCssPath = path8.join(root, srcDir, "app", "globals.css");
+  const globalsCssPath = path9.join(root, srcDir, "app", "globals.css");
   const cssImport = existsSync2(globalsCssPath) ? `import ${JSON.stringify(toImportPath(globalsCssPath))};` : "";
   const layoutImportStatements = [];
   const layoutRegistrations = [];
@@ -4578,8 +4693,8 @@ __name(generateClientHydrationEntry, "generateClientHydrationEntry");
 async function buildSSRInMemory(productionVite, config, root, routeManager, apiRouteManager, serverRenderer, preset, collectedPageRoutes, collectedLayoutRoutes, collectedRouteSlots, isolatedClientBoundaryModules, hydrationPlanCache, rendererBuildLifetime) {
   const viteBuild = productionVite.build;
   const { farmPlugin, farmServerOnlyEntriesPlugin } = await import("./vite.mjs");
-  const { PluginManager: PluginManager2 } = await import("./plugin.mjs");
-  const fs3 = await import("fs/promises");
+  const { PluginManager: PluginManager2 } = await import("./plugin-SYMK7PQ2.mjs");
+  const fs4 = await import("fs/promises");
   const pluginManager = new PluginManager2({
     config,
     isDev: false,
@@ -4594,9 +4709,9 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
     buildLifetime: rendererBuildLifetime
   });
   if (!hasScopedPostcssConfig) {
-    postcssConfigDir = await fs3.mkdtemp(path8.join(os.tmpdir(), "farm-postcss-"));
-    await fs3.writeFile(
-      path8.join(postcssConfigDir, "postcss.config.cjs"),
+    postcssConfigDir = await fs4.mkdtemp(path9.join(os.tmpdir(), "farm-postcss-"));
+    await fs4.writeFile(
+      path9.join(postcssConfigDir, "postcss.config.cjs"),
       "module.exports = { plugins: [] };\n"
     );
     tailwindVitePlugin = await loadTailwindVitePlugin({
@@ -4621,7 +4736,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         fileName: entry.fileName,
         sourceType: "static",
         staticInfo: entry.staticInfo,
-        data: (await fs3.readFile(entry.modulePath)).toString("base64")
+        data: (await fs4.readFile(entry.modulePath)).toString("base64")
       });
       continue;
     }
@@ -4722,7 +4837,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   const hasServerRuntimePlugins = hasFarmServerRuntimePlugins(config);
   const hasPluginRoutes = hasFarmPluginRoutes(config);
   const hasServerCacheConfig = hasFarmServerCacheConfig(config.cache);
-  const configModulePath = hasServerRuntimeIntegrations || hasObservabilityHandler || hasMdxComponentConfig || hasMiddlewareConfig || hasRouteContextConfig || hasServerRuntimePlugins || hasPluginRoutes || hasServerCacheConfig || hasIntegrationProviders ? await findFarmConfigPath(root) : null;
+  const configModulePath = hasServerRuntimeIntegrations || hasObservabilityHandler || hasMdxComponentConfig || hasMiddlewareConfig || hasRouteContextConfig || hasServerRuntimePlugins || hasPluginRoutes || hasServerCacheConfig || hasFarmServerStorageConfig(config.storage) || hasIntegrationProviders ? await findFarmConfigPath(root) : null;
   const hasRuntimeConfigModule = hasFarmRuntimeConfigModule(config, configModulePath);
   const hasRuntimeIntegrationConfig = hasRuntimeConfigModule && hasAnyConfiguredIntegrations;
   const hasConfiguredRuntimePlugins = Boolean(
@@ -4790,6 +4905,10 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   );
   const virtualEntryId = "\0virtual:farm-ssr-entry";
   const useExternalMetadataImageRuntime = shouldUseExternalMetadataImageRuntime(preset, true);
+  const omitCoreMetadataImageRuntime = !metadataImageRoutes.some(
+    (image) => image.sourceType === "module"
+  );
+  const externalMetadataImageRuntime = useExternalMetadataImageRuntime && !omitCoreMetadataImageRuntime ? ["@vercel/og"] : [];
   const rendererOptionalExternals = isReactRenderer(config.renderer) ? [] : [
     "react",
     "react/jsx-runtime",
@@ -4823,7 +4942,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
             // startup; kept external, Nitro copies the package into the output.
             "better-sqlite3",
             ...rendererOptionalExternals,
-            ...useExternalMetadataImageRuntime ? ["@vercel/og"] : [],
+            ...externalMetadataImageRuntime,
             "@prisma/client",
             "@prisma/client/default",
             "@prisma/client/default.js",
@@ -4855,7 +4974,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
           "fsevents",
           "sharp",
           ...rendererOptionalExternals,
-          ...useExternalMetadataImageRuntime ? ["@vercel/og"] : [],
+          ...externalMetadataImageRuntime,
           "esbuild",
           "lightningcss",
           "rolldown",
@@ -4902,10 +5021,16 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         ...rendererVitePlugins,
         ...config.vite.plugins || [],
         ...!useExternalMetadataImageRuntime && metadataImageRoutes.some((image) => image.sourceType === "module") ? [createMetadataImageWasmPlugin()] : [],
+        ...omitCoreMetadataImageRuntime ? [
+          {
+            ...createOmittedMetadataImageRuntimePlugin(useExternalMetadataImageRuntime),
+            enforce: "pre"
+          }
+        ] : [],
         { ...createReactProductionModePlugin(), enforce: "pre" },
         farmServerOnlyEntriesPlugin(),
         farmPlugin({ ...config, isolatedClientBoundaryModules }, pluginManager),
-        farmEnvironmentFunctionsPlugin(),
+        farmEnvironmentFunctionsPlugin(config),
         {
           name: "farm-virtual-ssr-entry",
           resolveId(id) {
@@ -4956,7 +5081,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   } finally {
     if (postcssConfigDir) {
       try {
-        await fs3.rm(postcssConfigDir, { recursive: true, force: true });
+        await fs4.rm(postcssConfigDir, { recursive: true, force: true });
       } catch {
       }
     }
@@ -4970,7 +5095,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
 __name(buildSSRInMemory, "buildSSRInMemory");
 function readFarmAppPackageIdentity(root) {
   try {
-    return JSON.parse(readFileSync(path8.join(root, "package.json"), "utf8"));
+    return JSON.parse(readFileSync(path9.join(root, "package.json"), "utf8"));
   } catch {
     return {};
   }
@@ -5077,7 +5202,7 @@ function matchLocalIntegrationRequest(request) {
   });` : "return null;"}
 }
 
-async function handleIntegrationRequest(request, ranMiddleware) {
+async function handleIntegrationRequest(request, ranMiddleware, clientAddress) {
   ${options.hasServerRuntimeIntegrations ? `return dispatchIntegrationRequests(
     serverRuntimeIntegrations,
     {
@@ -5086,7 +5211,7 @@ async function handleIntegrationRequest(request, ranMiddleware) {
       isProd: true,
     },
     request,
-    { ranMiddleware },
+    { ranMiddleware, clientAddress },
   );` : `return { response: null, setCookies: [] };`}
 }
 
@@ -5721,6 +5846,8 @@ function renderFarmRouteServerTree(element) { return element; }`;
   createFarmProductionLifecycle,
   createFarmNodeRequestAbortSignal,
   createProductionMiddlewareRunner,
+  _withFarmGuardedResponseCache,
+  _farmPluginsKeepResponsesPrivate,
   getTheme as getFarmTheme,
   emitFarmEvent,
   getFarmDataCache,
@@ -5758,7 +5885,7 @@ function renderFarmRouteServerTree(element) { return element; }`;
   stripFarmLocaleFromPathname,
   withFarmRouteContext,
   createLateNotFoundRecovery,
-  createLateRedirectRecovery,
+  createLateRedirectRecovery,${hasFarmServerStorageConfig(config.storage) ? "\n  _registerFarmStorageModules,\n  disposeFarmStorage,\n  initFarmStorage," : ""}
 } from "@farm.js/core/internal/production-runtime";`;
   const productionSiteTelemetryImport = config.telemetry ? `import { createFarmProductionSiteReporter } from "@farm.js/core/internal/product-telemetry-runtime";` : "";
   const metadataImageRuntimeImport = hasGeneratedMetadataImages ? `import { createFarmMetadataImageResponse } from "@farm.js/core/internal/metadata-image-runtime";` : "";
@@ -5784,7 +5911,7 @@ import { fileURLToPath as farmDocsFileURLToPath } from "node:url";` : "";
   const markdownHandlerImport = config.md?.enabled ? `import { applyMarkdownNegotiationHeaders, createMarkdownMirrorResponse, getFarmMarkdownAlternatePath } from "@farm.js/core/markdown";` : "";
   const appMarkdownImport = hasMarkdownPages ? `import { FARM_MARKDOWN_ANONYMOUS_CLIENT_ADDRESS, createFarmMarkdownRouteModule, createFarmMarkdownSourceResponse, isFarmMarkdownPublicSourceResponse } from "@farm.js/core/internal/app-markdown-runtime";` : "const createFarmMarkdownSourceResponse = null;\nconst isFarmMarkdownPublicSourceResponse = null;";
   const markdownErrorImport = `import { FARM_MARKDOWN_CONTENT_TYPE, FARM_MARKDOWN_PAGE_CHECK_HEADER, _isFarmMarkdownPageCheck, createFarmMarkdownErrorBody, farmRequestWantsMarkdown } from "@farm.js/core/markdown";`;
-  const mdxComponentsPath = typeof config.mdx?.components === "string" ? path8.isAbsolute(config.mdx.components) ? config.mdx.components : path8.join(config.root, config.mdx.components) : null;
+  const mdxComponentsPath = typeof config.mdx?.components === "string" ? path9.isAbsolute(config.mdx.components) ? config.mdx.components : path9.join(config.root, config.mdx.components) : null;
   const mdxComponentsImport = mdxComponentsPath ? `import * as FarmMdxComponentsModule from ${toVirtualEntryImportSpecifier(mdxComponentsPath)};` : "";
   const layerConfigPaths = (config.layers || []).map((layer) => layer.configFile).filter((configFile) => Boolean(configFile)).filter((configFile) => configFile !== configModulePath);
   const layerConfigImports = layerConfigPaths.map(
@@ -5811,7 +5938,7 @@ ${nativeAuth.importSource}
 ${nativeMCP.importSource}
 `;
   const imageRuntime = resolveImageRuntime(config, preset);
-  const imageRuntimeImport = imageRuntime === "none" ? "" : `import { createCloudflareImageTransformer, createFarmImageHandler } from "@farm.js/core/image/server";`;
+  const imageRuntimeImport = imageRuntime === "none" ? "" : `import { _withFarmImageSourceClientAddress, createCloudflareImageTransformer, createFarmImageHandler } from "@farm.js/core/image/server";`;
   const imageNodeRuntimeImport = imageRuntime === "node" ? `import { createNodeImageFetcher, createNodeImageUrlValidator, createSharpImageTransformer } from "@farm.js/core/image/sharp";` : "";
   const apiHandlerCode = apiRoutes.length > 0 ? `
 const matchBuiltAPIRoute = createStaticAPIRouteMatcherAtBasePath(apiRoutes, farmLocalAPIBasePath);
@@ -6105,6 +6232,10 @@ const farmPluginRuntime = ${hasPluginRuntime ? `configuredPlugins.length > 0
       return manager;
     })()
   : null` : "null"};
+// A plugin's runtime.before runs for every request and may be a guard, like middleware.
+const farmPluginRuntimeKeepsResponsesPrivate = farmPluginRuntime
+  ? _farmPluginsKeepResponsesPrivate(configuredPlugins)
+  : false;
 const hasFarmPluginHTMLTransforms = configuredPlugins.some(
   (plugin) => plugin.render?.html || plugin.afterRender || plugin.transformHTML,
 );
@@ -6138,6 +6269,7 @@ const farmObservabilityConfig = farmUserConfig?.observability ?? ${JSON.stringif
   )};
 configureFarmObservability(farmObservabilityConfig);
 configureFarmCache(farmResolvedRuntimeConfig.cache);
+${createFarmStorageModuleRegistration(config)}
 const farmI18nConfig = ${JSON.stringify(config.i18n)};
 const farmServerConfig = ${JSON.stringify(config.server)};
 const farmThemeConfig = ${JSON.stringify(config.theme)};
@@ -6156,9 +6288,11 @@ export const farmProductionLifecycle = createFarmProductionLifecycle({
   server: farmServerConfig,
   start: async () => {
     await farmInstrumentationLifecycle.start();
-    try {
+    try {${hasFarmServerStorageConfig(config.storage) ? `
+      // The configured drivers and mounts, as the development server applies them.
+      await initFarmStorage(farmResolvedRuntimeConfig.storage);` : ""}
       await farmPluginRuntime?.startRuntime();
-    } catch (error) {
+    } catch (error) {${hasFarmServerStorageConfig(config.storage) ? "\n      await disposeFarmStorage();" : ""}
       await farmInstrumentationLifecycle.shutdown();
       throw error;
     }
@@ -6166,7 +6300,7 @@ export const farmProductionLifecycle = createFarmProductionLifecycle({
   close: async (reason) => {
     try {
       await farmPluginRuntime?.closeRuntime(reason);${hasInfraAnalyticsRuntime && !hasPluginRuntime ? "\n      await farmInfraAnalytics?.close();" : ""}
-    } finally {
+    } finally {${hasFarmServerStorageConfig(config.storage) ? "\n      await disposeFarmStorage();" : ""}
       await farmInstrumentationLifecycle.shutdown();
     }
   },
@@ -6264,7 +6398,7 @@ const farmDocsAPIHandler = ${config.docs?.enabled ? hasPrecompiledDocs ? "farmDo
 
 // API routes bundled at build time
 const apiRoutes = ${apiRoutes.length > 0 ? "mergePluginAPIRoutes(" : ""}[${apiRegistrations.join(",")}
-]${apiRoutes.length > 0 ? `, configuredPlugins, ${JSON.stringify(apiRoutes.map(({ path: path10, methods }) => ({ path: path10, methods })))}, { bodySizeLimit: ${JSON.stringify(config.server.bodySizeLimit)}, dispatch: dispatchFarmPluginAPIRequest })` : ""};
+]${apiRoutes.length > 0 ? `, configuredPlugins, ${JSON.stringify(apiRoutes.map(({ path: path11, methods }) => ({ path: path11, methods })))}, { bodySizeLimit: ${JSON.stringify(config.server.bodySizeLimit)}, dispatch: dispatchFarmPluginAPIRequest })` : ""};
 // A plugin calling an app endpoint (an MCP tool, say) goes through the whole
 // pipeline, so the endpoint's middleware and integration guards run for it.
 function dispatchFarmPluginAPIRequest(request) {
@@ -7872,7 +8006,8 @@ ${config.docs?.enabled ? `async function wrapFarmDocsResponseWithLayouts(request
   });
 }` : ""}
 
-const pprShellCache = getFarmDataCache();
+// Shells keep their own LRU so query-string variants never evict app cache entries.
+const pprShellCache = getFarmDataCache().pprShellCache;
 const experimentalPPREnabled = ${JSON.stringify(config.experimental?.ppr === true)};
 
 function resolveRouteRenderingView(route) {
@@ -8016,6 +8151,10 @@ async function handleFarmRequest(request, adapterContext) {
   return response;
 }
 
+// Middleware that let a request through may have been a guard: an IP allowlist, an API key
+// header, a VPN header. A CDN keys its copy by URL and never runs the guard on a hit, so
+// whatever such a request answers stays out of shared caches. Only middleware declaring
+// cache: "public" (and plugins declaring runtime.cache: "public") leave the policy alone.
 async function handleFarmRequestInContext(
   request,
   farmLocaleResolution,
@@ -8023,6 +8162,31 @@ async function handleFarmRequestInContext(
   requestStartTime = Date.now(),
   adapterContext,
   requestUrl = new URL(request.url),
+) {
+  const farmCacheGuard = { guarded: farmPluginRuntimeKeepsResponsesPrivate };
+  const response = await resolveFarmRequestInContext(
+    farmCacheGuard,
+    request,
+    farmLocaleResolution,
+    configuredRewriteApplied,
+    requestStartTime,
+    adapterContext,
+    requestUrl,
+  );
+  if (!farmCacheGuard.guarded) return response;
+  // Tells the Nitro entry, which keeps this policy over a swr rule's public one.
+  adapterContext?.onGuardedResponse?.();
+  return _withFarmGuardedResponseCache(response);
+}
+
+async function resolveFarmRequestInContext(
+  farmCacheGuard,
+  request,
+  farmLocaleResolution,
+  configuredRewriteApplied,
+  requestStartTime,
+  adapterContext,
+  requestUrl,
 ) {
   let url = requestUrl;
   let pathname = url.pathname;
@@ -8055,10 +8219,26 @@ async function handleFarmRequestInContext(
         farmLocaleResolution?.locale,
       );
       if (rewriteDestination) {
-        const rewrittenRequest = createRewrittenRequest(request, rewriteDestination);
+        let rewrittenRequest = createRewrittenRequest(request, rewriteDestination);
         if (new URL(rewrittenRequest.url).origin !== url.origin) {
           return globalThis.fetch(rewrittenRequest);
         }
+        if (farmPluginRuntime) {
+          // Plugin guards ran on the requested URL. Re-run only runtime.before
+          // so they also see the destination, like middleware does on re-entry.
+          const guarded = await farmPluginRuntime.runRuntimeBeforeForRewrite(
+            request,
+            rewrittenRequest,
+            {
+              ...getFarmPluginRequestOptions(rewrittenRequest),
+              waitUntil: typeof adapterContext?.waitUntil === "function"
+                ? adapterContext.waitUntil.bind(adapterContext)
+                : undefined,
+            },
+          );
+          if (guarded instanceof Response) return guarded;
+          rewrittenRequest = guarded;
+        }
         return _runWithCurrentRequest(rewrittenRequest, () =>
           handleFarmRequestInContext(
             rewrittenRequest,
@@ -8086,6 +8266,7 @@ async function handleFarmRequestInContext(
   const integrationDispatch = await handleIntegrationRequest(
     cloneFarmRequestWithContext(request),
     farmIntegrationRanMiddleware,
+    adapterContext?.clientAddress,
   );
   if (integrationDispatch.response) {
     return integrationDispatch.response;
@@ -8105,6 +8286,7 @@ async function handleFarmRequestInContext(
   if (middlewareResult.response) {
     return middlewareResult.response;
   }
+  if (middlewareResult.guarded) farmCacheGuard.guarded = true;
   request = middlewareResult.request;${hasServerRuntimeIntegrations ? `
   // A ctx.rewrite() target is guarded as a direct request for it is: integration
   // guards (protectedRoutes) and routes see the rewritten URL, as in dev. Guards
@@ -8113,6 +8295,7 @@ async function handleFarmRequestInContext(
     const rewrittenDispatch = await handleIntegrationRequest(
       cloneFarmRequestWithContext(request),
       farmIntegrationRanMiddleware,
+      adapterContext?.clientAddress,
     );
     farmIntegrationSetCookies = [...farmIntegrationSetCookies, ...rewrittenDispatch.setCookies];
     if (rewrittenDispatch.response) {
@@ -8122,6 +8305,9 @@ async function handleFarmRequestInContext(
       );
     }
   }` : ""}
+${hasServerRuntimeIntegrations ? `
+  // An integration guard (protectedRoutes) that let the request through.
+  if (farmIntegrationRanMiddleware.size > 0) farmCacheGuard.guarded = true;` : ""}
   const middlewareData = middlewareResult.data;
   const middlewareContext = middlewareResult.context;
   const middlewareHeaders = ${hasServerRuntimeIntegrations ? "withFarmIntegrationSetCookies(middlewareResult.headers, farmIntegrationSetCookies)" : "middlewareResult.headers"};
@@ -8139,6 +8325,9 @@ async function handleFarmRequestInContext(
   const runResolvedRequest = async () => {
     if (middlewareResult.notFound) return renderFarmNotFoundResponse();
   ` : `
+${hasServerRuntimeIntegrations ? `
+  // An integration guard (protectedRoutes) that let the request through.
+  if (farmIntegrationRanMiddleware.size > 0) farmCacheGuard.guarded = true;` : ""}
   const middlewareData = undefined;
   const middlewareContext = undefined;
   const middlewareHeaders = ${hasServerRuntimeIntegrations ? "withFarmIntegrationSetCookies(undefined, farmIntegrationSetCookies)" : "undefined"};
@@ -9521,7 +9710,9 @@ async function handleFarmPluginRequest(request, runtimeOptions, adapterContext)
 ${generatePreloadResponseRuntimeSource()}
 
 // Export as Web Standard fetch API
-export async function fetch(request, context) {
+export async function fetch(request, context) {${imageRuntime === "none" ? "" : `
+  // The image optimizer's fetch of a local source is not a loopback visitor.
+  context = _withFarmImageSourceClientAddress(request, context);`}
   ${config.agent?.noindexPreviews ? "const response = await" : "return"} _runWithAPIRequestRuntime({
     basePath: farmLocalAPIBasePath,
     dispatch: async (localRequest) =>
@@ -9543,6 +9734,20 @@ async function handleFarmFetch(request, context) {
     typeof context?.waitUntil === "function" ? context.waitUntil.bind(context) : undefined,
   );
 
+  // headers() config applies after middleware let the request through, so it learns
+  // whether the response was guarded and can't make that response shareable again.
+  let farmGuardedResponse = false;
+  if (configuredHeaderRoutes.length > 0) {
+    const adapterContext = context;
+    context = {
+      ...adapterContext,
+      onGuardedResponse() {
+        farmGuardedResponse = true;
+        adapterContext?.onGuardedResponse?.();
+      },
+    };
+  }
+
   return farmProductionLifecycle.runRequest(
     () =>
       runWithFarmRequestSpan(request, async () => {
@@ -9557,9 +9762,11 @@ async function handleFarmFetch(request, context) {
           const routePathname = configuredHeaderRoutes.length > 0
             ? getFarmRoutePathname(new URL(runtimeRequest.url).pathname)
             : undefined;
+          const configured = applyConfiguredResponseHeaders(response, routePathname);
           return applyFarmPreloadBudget(
             applyFarmCspNonceToResponse(
-              applyConfiguredResponseHeaders(response, routePathname),
+              // Configured headers may edit the response in place, so check it either way.
+              farmGuardedResponse ? _withFarmGuardedResponseCache(configured) : configured,
               farmSecurityConfig,
               cspNonce,
             ),
@@ -9723,8 +9930,17 @@ function getPhysicalPrerenderBypassReason(options) {
   return void 0;
 }
 __name(getPhysicalPrerenderBypassReason, "getPhysicalPrerenderBypassReason");
+function hasFarmNitroCacheRouteRule(routeRules) {
+  return Object.values(routeRules || {}).some((rule) => {
+    const swr = rule?.swr;
+    const cache = rule?.cache;
+    const headers = rule?.headers;
+    return swr !== void 0 && swr !== false || cache !== void 0 && cache !== false || !!headers && typeof headers === "object" && Object.keys(headers).length > 0;
+  });
+}
+__name(hasFarmNitroCacheRouteRule, "hasFarmNitroCacheRouteRule");
 async function buildNitroUniversal(config, routeManager, apiRouteManager, serverRenderer, preset, root, distDir, ssrBundle, ssrEntryFile, clientOutputDir, routeRuntimeManifest, configuredHeaderRoutes, nitroBuilderResultPromise, pluginManager) {
-  const [fs3, nitroBuilderResult] = await Promise.all([
+  const [fs4, nitroBuilderResult] = await Promise.all([
     import("fs/promises"),
     nitroBuilderResultPromise
   ]);
@@ -9733,8 +9949,8 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const isVercel = preset === "vercel" || preset === "vercel-edge";
   const isCloudflareWorker = preset === "cloudflare-module";
   const outputDir = resolveDeployOutputPath(root, config.deploy.outputDir);
-  const runtimeServerOutputDir = isVercel ? path8.join(outputDir, "functions", "__nitro.func") : path8.join(outputDir, "server");
-  const ssrOutputDir = path8.join(root, distDir, "ssr");
+  const runtimeServerOutputDir = isVercel ? path9.join(outputDir, "functions", "__nitro.func") : path9.join(outputDir, "server");
+  const ssrOutputDir = path9.join(root, distDir, "ssr");
   const imageRuntime = resolveImageRuntime(config, preset);
   const hasGeneratedMetadataImages = Array.from(routeManager.getMetadataImages().values()).some(
     (image) => image.sourceType === "module"
@@ -9806,8 +10022,8 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const [clientCssHref, clientJsSrc, docsModulePreloads, clientModulePreloads] = await Promise.all([
     resolveHashedClientCssHref(clientOutputDir),
     resolveHashedClientJsSrc(clientOutputDir),
-    readFarmDocsModulePreloads(path8.join(root, distDir)),
-    readFarmClientModulePreloads(path8.join(root, distDir))
+    readFarmDocsModulePreloads(path9.join(root, distDir)),
+    readFarmClientModulePreloads(path9.join(root, distDir))
   ]);
   const encodedDocsModulePreloads = encodeFarmDocsModulePreloads(docsModulePreloads);
   const encodedClientModulePreloads = encodeFarmClientModulePreloads(clientModulePreloads);
@@ -9826,14 +10042,15 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
       output.code = output.code.split(FARM_CLIENT_JS_SRC_PLACEHOLDER).join(clientJsSrc);
     }
   }
-  await fs3.mkdir(ssrOutputDir, { recursive: true });
+  await fs4.mkdir(ssrOutputDir, { recursive: true });
   for (const [fileName, output] of Object.entries(ssrBundle)) {
-    const filePath = path8.join(ssrOutputDir, fileName);
-    await fs3.mkdir(path8.dirname(filePath), { recursive: true });
-    await fs3.writeFile(filePath, output.type === "chunk" ? output.code : output.source);
+    const filePath = path9.join(ssrOutputDir, fileName);
+    await fs4.mkdir(path9.dirname(filePath), { recursive: true });
+    await fs4.writeFile(filePath, output.type === "chunk" ? output.code : output.source);
   }
-  const nitroEntryPath = path8.join(ssrOutputDir, "nitro-entry.mjs");
+  const nitroEntryPath = path9.join(ssrOutputDir, "nitro-entry.mjs");
   const nodeAdapterModule = preset === "node-server" ? resolveNitroRuntimeDependency(root, "srvx/node") : null;
+  const hasNitroCacheRouteRules = hasFarmNitroCacheRouteRule(config.routeRules);
   const nitroEntryCode = `
 // Farm.js Nitro Entry
 // This file adapts Farm's Web fetch handler to Nitro's event handler contract.
@@ -9854,7 +10071,39 @@ function registerFarmCloseHook() {
     farmProductionLifecycle.close('production-server-closed')
   )
 }
-
+${hasNitroCacheRouteRules ? `
+// A swr route rule caches through Nitro, which writes its own public Cache-Control on
+// the event after Farm answered, and a headers route rule sets its headers there too. H3
+// lets those replace the response's. A response middleware let through keeps Farm's
+// private policy and no CDN cache header, so no CDN serves it to others.
+const FARM_PRIVATE_CACHE_DIRECTIVE = /(?:^|,)\\s*(?:private|no-store)\\s*(?:[,=]|$)/i
+const FARM_CDN_CACHE_CONTROL_HEADERS = [
+  'cdn-cache-control',
+  'vercel-cdn-cache-control',
+  'netlify-cdn-cache-control',
+  'cloudflare-cdn-cache-control',
+]
+const farmPrivateCacheControlKey = Symbol.for('farm.privateCacheControl')
+let farmPrivateCacheHookRegistered = false
+function keepFarmPrivateCacheControl(event, cacheControl) {
+  if (!farmPrivateCacheHookRegistered) {
+    farmPrivateCacheHookRegistered = true
+    useNitroHooks().hook('response', (response, responseEvent) => {
+      const value = responseEvent.context?.[farmPrivateCacheControlKey]
+      if (!value) return
+      try {
+        if (response.headers.get('cache-control') !== value) {
+          response.headers.set('cache-control', value)
+        }
+        for (const name of FARM_CDN_CACHE_CONTROL_HEADERS) response.headers.delete(name)
+      } catch {
+        // Immutable headers belong to a response Nitro passed through untouched.
+      }
+    })
+  }
+  if (event.context) event.context[farmPrivateCacheControlKey] = cacheControl
+}
+` : ""}
 function mergeVaryHeaders(target, source) {
   const values = new Set(
     [target.get('Vary'), source]
@@ -9948,11 +10197,14 @@ export default async function farmNitroEventHandler(event) {
   const request = !srvxRequest && node?.req && node?.res
     ? new Request(webRequest, { signal: createFarmNodeRequestAbortSignal(node.req, node.res) })
     : webRequest
-  const response = await handler.fetch(request, {
+${hasNitroCacheRouteRules ? "  let farmGuardedResponse = false\n" : ""}  const response = await handler.fetch(request, {
     waitUntil: (promise) => event.waitUntil(promise),
     onResponseFinished: createResponseFinishedHook(event),
     trustedLocalOrigin: resolveTrustedLocalOrigin(event, request),
-    clientAddress: resolveFarmClientAddress(event),
+    clientAddress: resolveFarmClientAddress(event),${hasNitroCacheRouteRules ? `
+    onGuardedResponse: () => {
+      farmGuardedResponse = true
+    },` : ""}
   })
 
   // Nitro records asset compression negotiation on the event response. Merge
@@ -9963,7 +10215,15 @@ export default async function farmNitroEventHandler(event) {
   if (farmVary) {
     const nitroHeaders = event.res.headers
     if (nitroHeaders.has('Vary')) mergeVaryHeaders(nitroHeaders, farmVary)
-  }
+  }${hasNitroCacheRouteRules ? `
+  const farmCacheControl = response.headers.get('cache-control')
+  if (
+    farmGuardedResponse &&
+    farmCacheControl &&
+    FARM_PRIVATE_CACHE_DIRECTIVE.test(farmCacheControl)
+  ) {
+    keepFarmPrivateCacheControl(event, farmCacheControl)
+  }` : ""}
   return ${nodeAdapterModule ? "toFarmNodeResponse(request, response)" : "response"}
 }${nodeAdapterModule ? `
 
@@ -9984,26 +10244,38 @@ function toFarmNodeResponse(request, response) {
   })
 }` : ""}
   `.trim();
-  await fs3.writeFile(nitroEntryPath, nitroEntryCode);
-  const farmNodeServerEntryPath = preset === "node-server" ? path8.join(ssrOutputDir, "farm-node-server-entry.mjs") : null;
+  await fs4.writeFile(nitroEntryPath, nitroEntryCode);
+  const farmNodeServerEntryPath = preset === "node-server" ? path9.join(ssrOutputDir, "farm-node-server-entry.mjs") : null;
   if (farmNodeServerEntryPath && nodeAdapterModule) {
-    await fs3.writeFile(
-      path8.join(ssrOutputDir, FARM_NODE_ENV_MODULE_FILE),
+    await fs4.writeFile(
+      path9.join(ssrOutputDir, FARM_NODE_ENV_MODULE_FILE),
       FARM_NODE_ENV_MODULE_SOURCE
     );
-    await fs3.writeFile(
+    await fs4.writeFile(
       farmNodeServerEntryPath,
       createFarmNodeServerEntry({
-        nitroEntryFile: path8.basename(nitroEntryPath),
+        nitroEntryFile: path9.basename(nitroEntryPath),
         nodeAdapterModule,
         server: config.server,
         websocketAdapterModule: resolveNitroRuntimeDependency(root, "crossws/adapters/node")
       })
     );
   }
-  const farmNetlifyEntryPath = preset === "netlify" ? path8.join(ssrOutputDir, "farm-netlify-entry.mjs") : null;
+  const farmBunServerEntryPath = preset === "bun" ? path9.join(ssrOutputDir, "farm-bun-server-entry.mjs") : null;
+  if (farmBunServerEntryPath) {
+    await fs4.writeFile(
+      farmBunServerEntryPath,
+      createFarmBunServerEntry({
+        nitroEntryFile: path9.basename(nitroEntryPath),
+        bunAdapterModule: resolveNitroRuntimeDependency(root, "srvx/bun"),
+        server: config.server,
+        websocketAdapterModule: resolveNitroRuntimeDependency(root, "crossws/adapters/bun")
+      })
+    );
+  }
+  const farmNetlifyEntryPath = preset === "netlify" ? path9.join(ssrOutputDir, "farm-netlify-entry.mjs") : null;
   if (farmNetlifyEntryPath) {
-    await fs3.writeFile(
+    await fs4.writeFile(
       farmNetlifyEntryPath,
       createFarmNetlifyEntry({
         nitroNetlifyEntry: resolveNitroNetlifyEntry(resolveNitroPackageEntry(root))
@@ -10035,7 +10307,10 @@ function toFarmNodeResponse(request, response) {
   let nitroConfig = {
     preset,
     ...farmNodeServerEntryPath ? { entry: farmNodeServerEntryPath } : {},
+    ...farmBunServerEntryPath ? { entry: farmBunServerEntryPath } : {},
     ...farmNetlifyEntryPath ? { entry: farmNetlifyEntryPath } : {},
+    // The response hook that keeps a private Cache-Control under a swr or headers rule (nitro-entry).
+    ...hasNitroCacheRouteRules ? { features: { runtimeHooks: true } } : {},
     rootDir: root,
     // Farm registers every handler, task, and plugin explicitly. Scanning the
     // project root would bundle an app's own `middleware/`, `api/`, `routes/`,
@@ -10043,7 +10318,7 @@ function toFarmNodeResponse(request, response) {
     // `src` directory), as Nitro handlers outside Farm's aliases.
     serverDir: false,
     serverEntry: false,
-    buildDir: path8.join(root, distDir, ".nitro"),
+    buildDir: path9.join(root, distDir, ".nitro"),
     alias: resolveNitroInternalRuntimeAliases(root),
     compatibilityDate: "2024-12-01",
     output: resolveFarmNitroOutputConfig(preset, outputDir),
@@ -10119,7 +10394,7 @@ function toFarmNodeResponse(request, response) {
   if (pluginManager) {
     nitroConfig = await pluginManager.runHookSerial("beforeNitroBuild", nitroConfig);
   }
-  const expectedServerDir = path8.join(outputDir, "server");
+  const expectedServerDir = path9.join(outputDir, "server");
   const customRollupKeys = Object.keys(nitroConfig.rollupConfig || {}).filter(
     (key) => key !== "external" && key !== "plugins"
   );
@@ -10132,9 +10407,9 @@ function toFarmNodeResponse(request, response) {
     snapshotSSRRebundleOptions(nitroConfig)
   );
   const requestedBuilder = nitroConfig.builder ?? process.env.NITRO_BUILDER;
-  const canReusePrebuiltSSR = isPrebuiltSSRCandidate && nitroConfig.preset === "node-server" && (requestedBuilder === void 0 || requestedBuilder === "rollup" || requestedBuilder === "rolldown") && nitroConfig.sourcemap === false && !hasCustomOxcOptions && !hasLateBuildMutationConfig && !hasUnsupportedSSRRebundleOverrides && nitroConfig.rollupConfig?.external === nitroRollupExternal && !hasRollupPlugins(nitroConfig.rollupConfig?.plugins) && customRollupKeys.length === 0 && path8.resolve(nitroConfig.output?.serverDir || "") === path8.resolve(expectedServerDir) && Boolean(
+  const canReusePrebuiltSSR = isPrebuiltSSRCandidate && nitroConfig.preset === "node-server" && (requestedBuilder === void 0 || requestedBuilder === "rollup" || requestedBuilder === "rolldown") && nitroConfig.sourcemap === false && !hasCustomOxcOptions && !hasLateBuildMutationConfig && !hasUnsupportedSSRRebundleOverrides && nitroConfig.rollupConfig?.external === nitroRollupExternal && !hasRollupPlugins(nitroConfig.rollupConfig?.plugins) && customRollupKeys.length === 0 && path9.resolve(nitroConfig.output?.serverDir || "") === path9.resolve(expectedServerDir) && Boolean(
     nitroConfig.handlers?.some(
-      (handler) => path8.resolve(handler?.handler || "") === nitroEntryPath
+      (handler) => path9.resolve(handler?.handler || "") === nitroEntryPath
     )
   );
   const selectRolldownBuilder = canReusePrebuiltSSR && requestedBuilder === void 0 && await canUseRolldownBuilder();
@@ -10195,7 +10470,7 @@ function toFarmNodeResponse(request, response) {
       nitroInstance.routing.sync();
     });
   }
-  if (farmNodeServerEntryPath || farmNetlifyEntryPath) {
+  if (farmNodeServerEntryPath || farmBunServerEntryPath || farmNetlifyEntryPath) {
     nitroInstance.hooks.hook("prerender:config", (prerendererConfig) => {
       delete prerendererConfig.entry;
     });
@@ -10221,14 +10496,14 @@ function toFarmNodeResponse(request, response) {
         });
       }
       prerenderer.hooks.hook("compiled", async () => {
-        const prerenderServerDir = path8.join(outputDir, "server");
+        const prerenderServerDir = path9.join(outputDir, "server");
         await copyPrebuiltSSRBundle(
           ssrBundle,
-          path8.join(prerenderServerDir, FARM_SSR_OUTPUT_DIR),
+          path9.join(prerenderServerDir, FARM_SSR_OUTPUT_DIR),
           null,
-          fs3
+          fs4
         );
-        await registerPrebuiltSSRPackageImport(prerenderServerDir, ssrEntryFile, fs3);
+        await registerPrebuiltSSRPackageImport(prerenderServerDir, ssrEntryFile, fs4);
       });
     });
   }
@@ -10259,7 +10534,7 @@ function toFarmNodeResponse(request, response) {
       else process.env[FARM_PRERENDER_ENV] = previousPrerender;
     }
   }
-  const sharpRuntimeStagePromise = imageRuntime === "node" ? stageSharpRuntime(config, root, distDir, fs3, preset) : Promise.resolve(null);
+  const sharpRuntimeStagePromise = imageRuntime === "node" ? stageSharpRuntime(config, root, distDir, fs4, preset) : Promise.resolve(null);
   const prebuiltSSRFilesPromise = canReusePrebuiltSSR ? prepareSSRBundleFiles(
     ssrBundle,
     shouldMinify ? { keepNames: keepServerNames, target: "node18" } : null
@@ -10272,7 +10547,7 @@ function toFarmNodeResponse(request, response) {
   await nitroInstance.close();
   if (nitroBuildResult.status === "rejected") {
     if (sharpRuntimeStageResult.status === "fulfilled" && sharpRuntimeStageResult.value) {
-      await fs3.rm(sharpRuntimeStageResult.value.stageDir, {
+      await fs4.rm(sharpRuntimeStageResult.value.stageDir, {
         recursive: true,
         force: true
       });
@@ -10285,20 +10560,20 @@ function toFarmNodeResponse(request, response) {
   if (prebuiltSSRFilesResult.status === "rejected") {
     throw prebuiltSSRFilesResult.reason;
   }
-  const stagedSharpRuntime = sharpRuntimeStageResult.value ?? (imageRuntime === "node" ? await stageSharpRuntime(config, root, distDir, fs3, preset) : null);
+  const stagedSharpRuntime = sharpRuntimeStageResult.value ?? (imageRuntime === "node" ? await stageSharpRuntime(config, root, distDir, fs4, preset) : null);
   const runtimeCopyPromise = (async () => {
     if (stagedSharpRuntime) {
-      await installStagedSharpRuntime(stagedSharpRuntime, runtimeServerOutputDir, fs3);
+      await installStagedSharpRuntime(stagedSharpRuntime, runtimeServerOutputDir, fs4);
     }
     if (useExternalMetadataImageRuntime) {
-      await copyMetadataImageRuntime(root, runtimeServerOutputDir, fs3);
+      await copyMetadataImageRuntime(root, runtimeServerOutputDir, fs4);
     }
   })();
   const copyResults = await Promise.allSettled([
     prebuiltSSRFilesResult.value ? writeSSRBundleFiles(
       prebuiltSSRFilesResult.value,
-      path8.join(outputDir, "server", FARM_SSR_OUTPUT_DIR),
-      fs3
+      path9.join(outputDir, "server", FARM_SSR_OUTPUT_DIR),
+      fs4
     ) : Promise.resolve(),
     runtimeCopyPromise
   ]);
@@ -10307,7 +10582,7 @@ function toFarmNodeResponse(request, response) {
   );
   if (failedCopy) throw failedCopy.reason;
   if (canReusePrebuiltSSR) {
-    await registerPrebuiltSSRPackageImport(path8.join(outputDir, "server"), ssrEntryFile, fs3);
+    await registerPrebuiltSSRPackageImport(path9.join(outputDir, "server"), ssrEntryFile, fs4);
     logger.info("\u26A1 Reused Farm's prebuilt SSR bundle for the Node output");
   }
   if (useRolldownBuilder) {
@@ -10322,7 +10597,7 @@ function toFarmNodeResponse(request, response) {
     });
   }
   if (isVercel) {
-    await postProcessVercelOutput(root, outputDir, fs3, config, farmWorkflows, routeRuntimeManifest);
+    await postProcessVercelOutput(root, outputDir, fs4, config, farmWorkflows, routeRuntimeManifest);
   }
   logger.success(`\u2705 Nitro build completed with preset: ${preset}`);
 }
@@ -10332,11 +10607,11 @@ function resolveFarmNitroOutputConfig(preset, outputDir) {
   return {
     dir: outputDir,
     ...preset === "node-server" ? {
-      serverDir: path8.join(outputDir, "server"),
-      publicDir: path8.join(outputDir, "public")
+      serverDir: path9.join(outputDir, "server"),
+      publicDir: path9.join(outputDir, "public")
     } : isVercel ? {
-      serverDir: path8.join(outputDir, "functions", "__nitro.func"),
-      publicDir: path8.join(outputDir, "static")
+      serverDir: path9.join(outputDir, "functions", "__nitro.func"),
+      publicDir: path9.join(outputDir, "static")
     } : {}
   };
 }
@@ -10350,24 +10625,24 @@ function prepareSSRBundleFiles(ssrBundle, minifyOptions) {
   );
 }
 __name(prepareSSRBundleFiles, "prepareSSRBundleFiles");
-async function writeSSRBundleFiles(files, targetDir, fs3) {
-  await fs3.rm(targetDir, { recursive: true, force: true });
+async function writeSSRBundleFiles(files, targetDir, fs4) {
+  await fs4.rm(targetDir, { recursive: true, force: true });
   await Promise.all(
     files.map(async ({ fileName, contents }) => {
-      const targetPath = path8.join(targetDir, fileName);
-      await fs3.mkdir(path8.dirname(targetPath), { recursive: true });
-      await fs3.writeFile(targetPath, contents);
+      const targetPath = path9.join(targetDir, fileName);
+      await fs4.mkdir(path9.dirname(targetPath), { recursive: true });
+      await fs4.writeFile(targetPath, contents);
     })
   );
 }
 __name(writeSSRBundleFiles, "writeSSRBundleFiles");
-async function copyPrebuiltSSRBundle(ssrBundle, targetDir, minifyOptions, fs3) {
-  await writeSSRBundleFiles(await prepareSSRBundleFiles(ssrBundle, minifyOptions), targetDir, fs3);
+async function copyPrebuiltSSRBundle(ssrBundle, targetDir, minifyOptions, fs4) {
+  await writeSSRBundleFiles(await prepareSSRBundleFiles(ssrBundle, minifyOptions), targetDir, fs4);
 }
 __name(copyPrebuiltSSRBundle, "copyPrebuiltSSRBundle");
-async function registerPrebuiltSSRPackageImport(serverDir, ssrEntryFile, fs3) {
-  const packagePath = path8.join(serverDir, "package.json");
-  const packageJSON = await fs3.readFile(packagePath, "utf8").then((contents) => JSON.parse(contents)).catch((error) => {
+async function registerPrebuiltSSRPackageImport(serverDir, ssrEntryFile, fs4) {
+  const packagePath = path9.join(serverDir, "package.json");
+  const packageJSON = await fs4.readFile(packagePath, "utf8").then((contents) => JSON.parse(contents)).catch((error) => {
     if (error.code === "ENOENT") return { type: "module" };
     throw error;
   });
@@ -10377,14 +10652,14 @@ async function registerPrebuiltSSRPackageImport(serverDir, ssrEntryFile, fs3) {
     ...existingImports,
     [FARM_SSR_PACKAGE_IMPORT]: `./${outputEntry}`
   };
-  await fs3.mkdir(serverDir, { recursive: true });
-  await fs3.writeFile(packagePath, `${JSON.stringify(packageJSON, null, 2)}
+  await fs4.mkdir(serverDir, { recursive: true });
+  await fs4.writeFile(packagePath, `${JSON.stringify(packageJSON, null, 2)}
 `);
 }
 __name(registerPrebuiltSSRPackageImport, "registerPrebuiltSSRPackageImport");
-async function moveVercelOutputPath(src, dest, fs3) {
+async function moveVercelOutputPath(src, dest, fs4) {
   try {
-    await fs3.rename(src, dest);
+    await fs4.rename(src, dest);
     return;
   } catch (error) {
     const code = error?.code;
@@ -10392,39 +10667,39 @@ async function moveVercelOutputPath(src, dest, fs3) {
       throw error;
     }
   }
-  await fs3.cp(src, dest, { recursive: true, force: true });
-  await fs3.rm(src, { recursive: true, force: true });
+  await fs4.cp(src, dest, { recursive: true, force: true });
+  await fs4.rm(src, { recursive: true, force: true });
 }
 __name(moveVercelOutputPath, "moveVercelOutputPath");
-async function postProcessVercelOutput(root, outputDir, fs3, config, farmWorkflows, routeRuntimeManifest) {
-  const serverDir = path8.join(outputDir, "server");
-  const functionsDir = path8.join(outputDir, "functions");
-  const nitroFuncDir = path8.join(functionsDir, "__nitro.func");
-  const staticDir = path8.join(outputDir, "static");
-  const publicDir = path8.join(outputDir, "public");
-  await fs3.mkdir(nitroFuncDir, { recursive: true });
-  const serverContents = await fs3.readdir(serverDir).catch((error) => {
+async function postProcessVercelOutput(root, outputDir, fs4, config, farmWorkflows, routeRuntimeManifest) {
+  const serverDir = path9.join(outputDir, "server");
+  const functionsDir = path9.join(outputDir, "functions");
+  const nitroFuncDir = path9.join(functionsDir, "__nitro.func");
+  const staticDir = path9.join(outputDir, "static");
+  const publicDir = path9.join(outputDir, "public");
+  await fs4.mkdir(nitroFuncDir, { recursive: true });
+  const serverContents = await fs4.readdir(serverDir).catch((error) => {
     if (error.code === "ENOENT") return [];
     throw error;
   });
   for (const file of serverContents) {
-    await moveVercelOutputPath(path8.join(serverDir, file), path8.join(nitroFuncDir, file), fs3);
+    await moveVercelOutputPath(path9.join(serverDir, file), path9.join(nitroFuncDir, file), fs4);
   }
-  if (serverContents.length > 0) await fs3.rm(serverDir, { recursive: true, force: true });
+  if (serverContents.length > 0) await fs4.rm(serverDir, { recursive: true, force: true });
   try {
-    await moveVercelOutputPath(publicDir, staticDir, fs3);
+    await moveVercelOutputPath(publicDir, staticDir, fs4);
   } catch (error) {
     if (error?.code !== "ENOENT") throw error;
   }
-  await copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs3);
-  await copyPrismaClientForVercel(root, nitroFuncDir, fs3);
-  const configPath = path8.join(outputDir, "config.json");
-  const configContent = await fs3.readFile(configPath, "utf-8");
+  await copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs4);
+  await copyPrismaClientForVercel(root, nitroFuncDir, fs4);
+  const configPath = path9.join(outputDir, "config.json");
+  const configContent = await fs4.readFile(configPath, "utf-8");
   const vercelConfig = JSON.parse(configContent);
   const runtimeRoutes = await createFarmVercelRouteRuntimeFunctions(
     outputDir,
     routeRuntimeManifest,
-    fs3,
+    fs4,
     config.basePath
   );
   vercelConfig.routes = buildFarmVercelRoutes({
@@ -10439,29 +10714,29 @@ async function postProcessVercelOutput(root, outputDir, fs3, config, farmWorkflo
     vercelConfigWithWorkflowCrons,
     config.cron.jobs
   );
-  await fs3.writeFile(configPath, JSON.stringify(vercelConfigWithCrons, null, 2));
+  await fs4.writeFile(configPath, JSON.stringify(vercelConfigWithCrons, null, 2));
   logger.info("\u2705 Post-processed Vercel output for Build Output API v3");
 }
 __name(postProcessVercelOutput, "postProcessVercelOutput");
-async function copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs3) {
+async function copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs4) {
   const docsContentDir = resolveBuildDocsContentDir(config, root);
   if (!docsContentDir) return;
-  const bundledContentDir = path8.join(nitroFuncDir, "farm-docs-content");
+  const bundledContentDir = path9.join(nitroFuncDir, "farm-docs-content");
   const lastModifiedManifest = createFarmDocsLastModifiedManifest(docsContentDir, {
     fallback: "now"
   });
-  await fs3.rm(bundledContentDir, { recursive: true, force: true });
-  await fs3.mkdir(path8.dirname(bundledContentDir), { recursive: true });
-  await fs3.cp(docsContentDir, bundledContentDir, {
+  await fs4.rm(bundledContentDir, { recursive: true, force: true });
+  await fs4.mkdir(path9.dirname(bundledContentDir), { recursive: true });
+  await fs4.cp(docsContentDir, bundledContentDir, {
     recursive: true,
     force: true
   });
-  await fs3.writeFile(
-    path8.join(bundledContentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST),
+  await fs4.writeFile(
+    path9.join(bundledContentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST),
     `${JSON.stringify(lastModifiedManifest, null, 2)}
 `
   );
-  logger.info(`\u{1F4DA} Bundled docs content for Vercel: ${path8.relative(root, docsContentDir)}`);
+  logger.info(`\u{1F4DA} Bundled docs content for Vercel: ${path9.relative(root, docsContentDir)}`);
 }
 __name(copyFarmDocsContentForVercel, "copyFarmDocsContentForVercel");
 function resolveServerFunctionPlatform(preset) {
@@ -10480,9 +10755,9 @@ function platformFieldAllows(field, value) {
   return allowed.length === 0 || allowed.includes(value);
 }
 __name(platformFieldAllows, "platformFieldAllows");
-async function stageSharpRuntime(config, root, distDir, fs3, preset) {
+async function stageSharpRuntime(config, root, distDir, fs4, preset) {
   const functionPlatform = resolveServerFunctionPlatform(preset);
-  const projectRequire = createRequire(path8.join(root, "package.json"));
+  const projectRequire = createRequire(path9.join(root, "package.json"));
   let sharpRequire = projectRequire;
   if (!resolvePackageJson(projectRequire, "sharp")) {
     try {
@@ -10492,10 +10767,10 @@ async function stageSharpRuntime(config, root, distDir, fs3, preset) {
   }
   const copiedPackages = /* @__PURE__ */ new Map();
   const packageCopies = /* @__PURE__ */ new Map();
-  const stageRoot = path8.join(root, distDir, "tmp");
-  await fs3.mkdir(stageRoot, { recursive: true });
-  const stageDir = await fs3.mkdtemp(path8.join(stageRoot, "sharp-runtime-"));
-  const targetNodeModules = path8.join(stageDir, "node_modules");
+  const stageRoot = path9.join(root, distDir, "tmp");
+  await fs4.mkdir(stageRoot, { recursive: true });
+  const stageDir = await fs4.mkdtemp(path9.join(stageRoot, "sharp-runtime-"));
+  const targetNodeModules = path9.join(stageDir, "node_modules");
   function copyPackage(packageName, parentRequire) {
     const activeCopy = packageCopies.get(packageName);
     if (activeCopy) return activeCopy;
@@ -10507,19 +10782,19 @@ async function stageSharpRuntime(config, root, distDir, fs3, preset) {
   async function copyPackageOnce(packageName, parentRequire) {
     const packageJsonPath = resolvePackageJson(parentRequire, packageName);
     if (!packageJsonPath) return;
-    const packageJson = JSON.parse(await fs3.readFile(packageJsonPath, "utf8"));
+    const packageJson = JSON.parse(await fs4.readFile(packageJsonPath, "utf8"));
     if (functionPlatform && !packageSupportsPlatform(packageJson, functionPlatform)) return;
-    const packageDir = path8.dirname(packageJsonPath);
-    const targetDir = path8.join(targetNodeModules, ...packageName.split("/"));
+    const packageDir = path9.dirname(packageJsonPath);
+    const targetDir = path9.join(targetNodeModules, ...packageName.split("/"));
     copiedPackages.set(packageName, String(packageJson.version || "*"));
-    await fs3.mkdir(path8.dirname(targetDir), { recursive: true });
+    await fs4.mkdir(path9.dirname(targetDir), { recursive: true });
     const packageRequire = createRequire(packageJsonPath);
     const dependencies = {
       ...packageJson.dependencies,
       ...packageJson.optionalDependencies
     };
     await settleAllOrThrow([
-      fs3.cp(packageDir, targetDir, {
+      fs4.cp(packageDir, targetDir, {
         recursive: true,
         force: true,
         dereference: true,
@@ -10537,7 +10812,7 @@ async function stageSharpRuntime(config, root, distDir, fs3, preset) {
       throw new Error(`Farm image optimization requires sharp. ${SHARP_INSTALL_HINT}`);
     }
   } catch (error) {
-    await fs3.rm(stageDir, { recursive: true, force: true });
+    await fs4.rm(stageDir, { recursive: true, force: true });
     throw error;
   }
   return {
@@ -10548,19 +10823,19 @@ async function stageSharpRuntime(config, root, distDir, fs3, preset) {
   };
 }
 __name(stageSharpRuntime, "stageSharpRuntime");
-async function installStagedSharpRuntime(staged, nitroFuncDir, fs3) {
-  const stagedNodeModules = path8.join(staged.stageDir, "node_modules");
-  const targetNodeModules = path8.join(nitroFuncDir, "node_modules");
+async function installStagedSharpRuntime(staged, nitroFuncDir, fs4) {
+  const stagedNodeModules = path9.join(staged.stageDir, "node_modules");
+  const targetNodeModules = path9.join(nitroFuncDir, "node_modules");
   try {
-    await mergeStagedDirectory(stagedNodeModules, targetNodeModules, fs3);
-    const functionPackage = await readNitroOutputPackage(nitroFuncDir, fs3);
+    await mergeStagedDirectory(stagedNodeModules, targetNodeModules, fs4);
+    const functionPackage = await readNitroOutputPackage(nitroFuncDir, fs4);
     functionPackage.dependencies = {
       ...functionPackage.dependencies,
       ...staged.dependencies
     };
-    await writeNitroOutputPackage(nitroFuncDir, functionPackage, fs3);
+    await writeNitroOutputPackage(nitroFuncDir, functionPackage, fs4);
   } finally {
-    await fs3.rm(staged.stageDir, { recursive: true, force: true });
+    await fs4.rm(staged.stageDir, { recursive: true, force: true });
   }
   logger.info(
     `\u{1F5BC}\uFE0F  Bundled Sharp image runtime (${Object.keys(staged.dependencies).length} packages)`
@@ -10575,15 +10850,15 @@ async function settleAllOrThrow(operations) {
   if (failure) throw failure.reason;
 }
 __name(settleAllOrThrow, "settleAllOrThrow");
-async function mergeStagedDirectory(sourceDir, targetDir, fs3) {
-  await fs3.mkdir(targetDir, { recursive: true });
-  const entries = await fs3.readdir(sourceDir, { withFileTypes: true });
+async function mergeStagedDirectory(sourceDir, targetDir, fs4) {
+  await fs4.mkdir(targetDir, { recursive: true });
+  const entries = await fs4.readdir(sourceDir, { withFileTypes: true });
   await settleAllOrThrow(
     entries.map(async (entry) => {
-      const sourcePath = path8.join(sourceDir, entry.name);
-      const targetPath = path8.join(targetDir, entry.name);
+      const sourcePath = path9.join(sourceDir, entry.name);
+      const targetPath = path9.join(targetDir, entry.name);
       try {
-        await fs3.rename(sourcePath, targetPath);
+        await fs4.rename(sourcePath, targetPath);
         return;
       } catch (error) {
         const code = error.code;
@@ -10592,16 +10867,16 @@ async function mergeStagedDirectory(sourceDir, targetDir, fs3) {
         }
       }
       if (entry.isDirectory()) {
-        await mergeStagedDirectory(sourcePath, targetPath, fs3);
-        await fs3.rm(sourcePath, { recursive: true, force: true });
+        await mergeStagedDirectory(sourcePath, targetPath, fs4);
+        await fs4.rm(sourcePath, { recursive: true, force: true });
         return;
       }
-      await fs3.cp(sourcePath, targetPath, {
+      await fs4.cp(sourcePath, targetPath, {
         force: true,
         dereference: true,
         mode: fsConstants.COPYFILE_FICLONE
       });
-      await fs3.rm(sourcePath, { force: true });
+      await fs4.rm(sourcePath, { force: true });
     })
   );
 }
@@ -10609,14 +10884,14 @@ __name(mergeStagedDirectory, "mergeStagedDirectory");
 function assertMetadataImageRuntimeInstalled(root, metadataImageRoutes) {
   const generated = metadataImageRoutes.find((image) => image.sourceType === "module");
   if (!generated || resolveMetadataImageRuntimePackageJson(root)) return;
-  const file = generated.modulePath ? toPosixPath(path8.relative(root, generated.modulePath)) : "";
+  const file = generated.modulePath ? toPosixPath(path9.relative(root, generated.modulePath)) : "";
   throw new Error(
     `${file || "A generated metadata image"} renders with @vercel/og, which is not installed. ${VERCEL_OG_INSTALL_HINT}`
   );
 }
 __name(assertMetadataImageRuntimeInstalled, "assertMetadataImageRuntimeInstalled");
 function resolveMetadataImageRuntimePackageJson(root) {
-  const projectRequire = createRequire(path8.join(root, "package.json"));
+  const projectRequire = createRequire(path9.join(root, "package.json"));
   const packageJsonPath = resolvePackageJson(projectRequire, "@vercel/og");
   if (packageJsonPath) return packageJsonPath;
   try {
@@ -10626,40 +10901,40 @@ function resolveMetadataImageRuntimePackageJson(root) {
   }
 }
 __name(resolveMetadataImageRuntimePackageJson, "resolveMetadataImageRuntimePackageJson");
-async function copyMetadataImageRuntime(root, nitroFuncDir, fs3) {
+async function copyMetadataImageRuntime(root, nitroFuncDir, fs4) {
   const packageJsonPath = resolveMetadataImageRuntimePackageJson(root);
   if (!packageJsonPath) return;
-  const packageJson = JSON.parse(await fs3.readFile(packageJsonPath, "utf8"));
-  const packageDir = path8.dirname(packageJsonPath);
-  const targetDir = path8.join(nitroFuncDir, "node_modules", "@vercel", "og");
-  await fs3.mkdir(path8.dirname(targetDir), { recursive: true });
-  await fs3.cp(packageDir, targetDir, {
+  const packageJson = JSON.parse(await fs4.readFile(packageJsonPath, "utf8"));
+  const packageDir = path9.dirname(packageJsonPath);
+  const targetDir = path9.join(nitroFuncDir, "node_modules", "@vercel", "og");
+  await fs4.mkdir(path9.dirname(targetDir), { recursive: true });
+  await fs4.cp(packageDir, targetDir, {
     recursive: true,
     force: true,
     dereference: true,
     mode: fsConstants.COPYFILE_FICLONE
   });
-  const functionPackage = await readNitroOutputPackage(nitroFuncDir, fs3);
+  const functionPackage = await readNitroOutputPackage(nitroFuncDir, fs4);
   functionPackage.dependencies = {
     ...functionPackage.dependencies,
     "@vercel/og": String(packageJson.version || "0.11.1")
   };
-  await writeNitroOutputPackage(nitroFuncDir, functionPackage, fs3);
+  await writeNitroOutputPackage(nitroFuncDir, functionPackage, fs4);
   logger.info("\u{1F5BC}\uFE0F  Bundled generated metadata image runtime");
 }
 __name(copyMetadataImageRuntime, "copyMetadataImageRuntime");
-async function readNitroOutputPackage(outputDir, fs3) {
-  const packagePath = path8.join(outputDir, "package.json");
-  return fs3.readFile(packagePath, "utf8").then((contents) => JSON.parse(contents)).catch((error) => {
+async function readNitroOutputPackage(outputDir, fs4) {
+  const packagePath = path9.join(outputDir, "package.json");
+  return fs4.readFile(packagePath, "utf8").then((contents) => JSON.parse(contents)).catch((error) => {
     if (error.code === "ENOENT") return {};
     throw error;
   });
 }
 __name(readNitroOutputPackage, "readNitroOutputPackage");
-async function writeNitroOutputPackage(outputDir, packageJson, fs3) {
-  await fs3.mkdir(outputDir, { recursive: true });
-  await fs3.writeFile(
-    path8.join(outputDir, "package.json"),
+async function writeNitroOutputPackage(outputDir, packageJson, fs4) {
+  await fs4.mkdir(outputDir, { recursive: true });
+  await fs4.writeFile(
+    path9.join(outputDir, "package.json"),
     `${JSON.stringify(packageJson, null, 2)}
 `
   );
@@ -10676,9 +10951,9 @@ function resolvePackageJson(parentRequire, packageName) {
     }
   }
   try {
-    let directory = path8.dirname(metadataModule ?? parentRequire.resolve(packageName));
-    while (directory !== path8.dirname(directory)) {
-      const candidate = path8.join(directory, "package.json");
+    let directory = path9.dirname(metadataModule ?? parentRequire.resolve(packageName));
+    while (directory !== path9.dirname(directory)) {
+      const candidate = path9.join(directory, "package.json");
       if (existsSync2(candidate)) {
         try {
           const manifest = JSON.parse(readFileSync(candidate, "utf8"));
@@ -10686,52 +10961,52 @@ function resolvePackageJson(parentRequire, packageName) {
         } catch {
         }
       }
-      if (path8.basename(directory) === "node_modules") break;
-      directory = path8.dirname(directory);
+      if (path9.basename(directory) === "node_modules") break;
+      directory = path9.dirname(directory);
     }
   } catch {
   }
   return null;
 }
 __name(resolvePackageJson, "resolvePackageJson");
-async function copyPrismaClientForVercel(root, nitroFuncDir, fs3) {
-  const projectRequire = createRequire(path8.join(root, "package.json"));
+async function copyPrismaClientForVercel(root, nitroFuncDir, fs4) {
+  const projectRequire = createRequire(path9.join(root, "package.json"));
   let prismaClientDir;
   try {
-    prismaClientDir = path8.dirname(projectRequire.resolve("@prisma/client/default.js"));
+    prismaClientDir = path9.dirname(projectRequire.resolve("@prisma/client/default.js"));
   } catch {
     return;
   }
-  const generatedClientDir = path8.join(prismaClientDir, "..", "..", ".prisma", "client");
+  const generatedClientDir = path9.join(prismaClientDir, "..", "..", ".prisma", "client");
   try {
-    await fs3.access(generatedClientDir);
+    await fs4.access(generatedClientDir);
   } catch {
     return;
   }
-  const targetNodeModules = path8.join(nitroFuncDir, "node_modules");
-  const targetPrismaScopeDir = path8.join(targetNodeModules, "@prisma");
-  const targetGeneratedDir = path8.join(targetNodeModules, ".prisma", "client");
-  const targetClientDir = path8.join(targetPrismaScopeDir, "client");
-  await fs3.mkdir(targetPrismaScopeDir, { recursive: true });
-  await fs3.cp(prismaClientDir, targetClientDir, {
+  const targetNodeModules = path9.join(nitroFuncDir, "node_modules");
+  const targetPrismaScopeDir = path9.join(targetNodeModules, "@prisma");
+  const targetGeneratedDir = path9.join(targetNodeModules, ".prisma", "client");
+  const targetClientDir = path9.join(targetPrismaScopeDir, "client");
+  await fs4.mkdir(targetPrismaScopeDir, { recursive: true });
+  await fs4.cp(prismaClientDir, targetClientDir, {
     recursive: true,
     force: true
   });
-  await fs3.cp(generatedClientDir, targetGeneratedDir, {
+  await fs4.cp(generatedClientDir, targetGeneratedDir, {
     recursive: true,
     force: true
   });
-  const clientPackagePath = path8.join(prismaClientDir, "package.json");
+  const clientPackagePath = path9.join(prismaClientDir, "package.json");
   const [functionPackage, clientPackageContent] = await Promise.all([
-    readNitroOutputPackage(nitroFuncDir, fs3),
-    fs3.readFile(clientPackagePath, "utf-8")
+    readNitroOutputPackage(nitroFuncDir, fs4),
+    fs4.readFile(clientPackagePath, "utf-8")
   ]);
   const clientPackage = JSON.parse(clientPackageContent);
   functionPackage.dependencies = {
     ...functionPackage.dependencies,
     "@prisma/client": clientPackage.version
   };
-  await writeNitroOutputPackage(nitroFuncDir, functionPackage, fs3);
+  await writeNitroOutputPackage(nitroFuncDir, functionPackage, fs4);
 }
 __name(copyPrismaClientForVercel, "copyPrismaClientForVercel");
 
@@ -10904,9 +11179,9 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
     } else {
       const { build: legacyViteBuild } = await import("vite");
       logger.info("\u{1F4E6} Building client bundle...");
-      await buildClient2(legacyViteBuild, config, root, srcDir, path9.join(root, distDir, "client"));
+      await buildClient2(legacyViteBuild, config, root, srcDir, path10.join(root, distDir, "client"));
       logger.info("\u{1F4E6} Building SSR bundle...");
-      await buildSSR(legacyViteBuild, config, root, srcDir, path9.join(root, distDir, "server"));
+      await buildSSR(legacyViteBuild, config, root, srcDir, path10.join(root, distDir, "server"));
       logger.info(`\u{1F680} Building server with Nitro (preset: ${preset})...`);
       await buildNitro(
         config,
@@ -11033,7 +11308,7 @@ async function createProjectModuleServer(createViteServer, config, root, buildLi
 __name(createProjectModuleServer, "createProjectModuleServer");
 async function buildClient2(viteBuild, config, root, srcDir, outputDir) {
   const { farmI18nClientBridgePlugin, farmPlugin, farmServerOnlyEntriesPlugin } = await import("./vite.mjs");
-  const { PluginManager: PluginManager2 } = await import("./plugin.mjs");
+  const { PluginManager: PluginManager2 } = await import("./plugin-SYMK7PQ2.mjs");
   const pluginManager = new PluginManager2({
     config,
     isDev: false,
@@ -11053,7 +11328,7 @@ async function buildClient2(viteBuild, config, root, srcDir, outputDir) {
       farmI18nClientBridgePlugin(),
       farmServerOnlyEntriesPlugin(),
       farmPlugin(config, pluginManager),
-      farmEnvironmentFunctionsPlugin()
+      farmEnvironmentFunctionsPlugin(config)
     ],
     mode: "production"
   });
@@ -11061,7 +11336,7 @@ async function buildClient2(viteBuild, config, root, srcDir, outputDir) {
 __name(buildClient2, "buildClient");
 async function buildSSR(viteBuild, config, root, srcDir, outputDir) {
   const { farmI18nClientBridgePlugin, farmPlugin } = await import("./vite.mjs");
-  const { PluginManager: PluginManager2 } = await import("./plugin.mjs");
+  const { PluginManager: PluginManager2 } = await import("./plugin-SYMK7PQ2.mjs");
   const pluginManager = new PluginManager2({
     config,
     isDev: false,
@@ -11087,24 +11362,24 @@ async function buildSSR(viteBuild, config, root, srcDir, outputDir) {
     plugins: [
       farmI18nClientBridgePlugin(),
       farmPlugin(config, pluginManager),
-      farmEnvironmentFunctionsPlugin()
+      farmEnvironmentFunctionsPlugin(config)
     ],
     mode: "production"
   });
 }
 __name(buildSSR, "buildSSR");
 function resolveLegacyPageEntry(config, root, srcDir) {
-  const appDir = path9.join(root, srcDir, "app");
+  const appDir = path10.join(root, srcDir, "app");
   for (const extension of getFarmRendererComponentExtensions(config.renderer)) {
-    const candidate = path9.join(appDir, `page${extension}`);
+    const candidate = path10.join(appDir, `page${extension}`);
     if (existsSync3(candidate)) return candidate;
   }
-  return path9.join(appDir, "page.tsx");
+  return path10.join(appDir, "page.tsx");
 }
 __name(resolveLegacyPageEntry, "resolveLegacyPageEntry");
 async function buildNitro(config, routeManager, apiRouteManager, serverRenderer, preset, root, distDir, pluginManager) {
   const [{ createNitroConfig }, { createNitro, build: nitroBuild }] = await Promise.all([
-    import("./nitro-MPZJGPXK.mjs"),
+    import("./nitro-NFG2LBRC.mjs"),
     import("nitro/builder")
   ]);
   let nitroConfig = await createNitroConfig(
@@ -11118,23 +11393,23 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     nitroConfig = await pluginManager.runHookSerial("beforeNitroBuild", nitroConfig);
   }
   const outputDir = resolveDeployOutputPath(root, config.deploy.outputDir);
-  const serverOutputDir = path9.join(outputDir, "server");
-  const publicOutputDir = path9.join(outputDir, "public");
+  const serverOutputDir = path10.join(outputDir, "server");
+  const publicOutputDir = path10.join(outputDir, "public");
   const { mkdir, cp } = await import("fs/promises");
   await mkdir(serverOutputDir, { recursive: true });
   await mkdir(publicOutputDir, { recursive: true });
-  const clientDir = path9.join(root, distDir, "client");
+  const clientDir = path10.join(root, distDir, "client");
   try {
     await mkdir(publicOutputDir, { recursive: true });
     await cp(clientDir, publicOutputDir, { recursive: true });
     logger.info("\u{1F4E6} Copied client assets to public directory");
-    const manifestPath = path9.join(publicOutputDir, "farm-client-manifest.json");
-    const assetsDir = path9.join(publicOutputDir, "assets");
+    const manifestPath = path10.join(publicOutputDir, "farm-client-manifest.json");
+    const assetsDir = path10.join(publicOutputDir, "assets");
     const manifestExists = await import("fs/promises").then(
-      (fs3) => fs3.access(manifestPath).then(() => true).catch(() => false)
+      (fs4) => fs4.access(manifestPath).then(() => true).catch(() => false)
     );
     const assetsExist = await import("fs/promises").then(
-      (fs3) => fs3.access(assetsDir).then(() => true).catch(() => false)
+      (fs4) => fs4.access(assetsDir).then(() => true).catch(() => false)
     );
     if (manifestExists && assetsExist) {
       logger.info("\u2705 Verified client assets are present");
@@ -11145,8 +11420,8 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     logger.error(`\u274C Failed to copy client assets: ${error}`);
     throw error;
   }
-  const serverDir = path9.join(root, distDir, "server");
-  const nitroServerDir = path9.join(root, distDir, ".nitro", "server", "farm");
+  const serverDir = path10.join(root, distDir, "server");
+  const nitroServerDir = path10.join(root, distDir, ".nitro", "server", "farm");
   try {
     await mkdir(nitroServerDir, { recursive: true });
     await cp(serverDir, nitroServerDir, { recursive: true });
@@ -11155,7 +11430,7 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     logger.warn(`Could not copy SSR bundles: ${error}`);
   }
   const nitro = await createNitro(nitroConfig);
-  const registryPath = path9.join(root, distDir, ".nitro", "server", "farm-registry.ts");
+  const registryPath = path10.join(root, distDir, ".nitro", "server", "farm-registry.ts");
   try {
     const { farmRegistry } = await import(
       /* @vite-ignore */
@@ -11172,7 +11447,7 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     }
     farmRegistry.routePaths = routePaths;
     try {
-      const clientManifestPath = path9.join(root, distDir, "client", "farm-client-manifest.json");
+      const clientManifestPath = path10.join(root, distDir, "client", "farm-client-manifest.json");
       const { readFile } = await import("fs/promises");
       const manifestContent = await readFile(clientManifestPath, "utf-8");
       farmRegistry.clientManifest = JSON.parse(manifestContent);