@farm.js/core 0.1.22 → 0.1.24

package/dist/{chunk-AAWTJW2G.mjs → chunk-6YSEHN46.mjs}

@@ -6,7 +6,7 @@ import {
   parseRouteSlotFile,
   resolveRouteRenderingConfig,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-GKT4ONKN.mjs";
+} from "./chunk-VVJCWBIE.mjs";
 import {
   collectSchemaExtensions,
   declareSchemaTables,
@@ -30,7 +30,7 @@ import {
 } from "./chunk-BOYNDCZL.mjs";
 import {
   createFarmMetadataImageResponse
-} from "./chunk-HLCDYJY7.mjs";
+} from "./chunk-YQVSHTMR.mjs";
 import {
   createFarmImageHandler
 } from "./chunk-F6XEGFHO.mjs";
@@ -74,7 +74,7 @@ import {
   getFarmAppDirectories,
   getFarmLayerAliases,
   getFarmSourceRoots
-} from "./chunk-IILNZK5G.mjs";
+} from "./chunk-JHWOVJ3M.mjs";
 import {
   REACT_RENDERER,
   assertFarmRendererStreamingRuntime,
@@ -144,7 +144,7 @@ import {
 } from "./chunk-OFEY6KHO.mjs";
 import {
   resolveWorkflowsConfig
-} from "./chunk-EGJDUF4Q.mjs";
+} from "./chunk-3ATMYLLJ.mjs";
 import {
   initStorage
 } from "./chunk-UWPLULNK.mjs";
@@ -182,7 +182,7 @@ import {
 } from "./chunk-IOEH4VWN.mjs";
 import {
   APIRouteManager
-} from "./chunk-CQHFU55R.mjs";
+} from "./chunk-WNUBR4CA.mjs";
 import {
   findProgrammaticRouteFiles,
   loadProgrammaticRouteManifests
@@ -193,6 +193,12 @@ import {
   createFarmI18nRuntime,
   getFarmI18nClientSnapshot
 } from "./chunk-JNGIWIY6.mjs";
+import {
+  VERCEL_OG_INSTALL_HINT,
+  formatOptionalPeerInstallHint,
+  isMissingPackageError,
+  isOptionalPeerInstalled
+} from "./chunk-YOZYCI6Z.mjs";
 import {
   isFarmAPIPathname
 } from "./chunk-XP777LRD.mjs";
@@ -265,7 +271,7 @@ import {
 } from "./chunk-Z2RZJZIZ.mjs";
 import {
   FARM_VERSION
-} from "./chunk-X2ZUD4GI.mjs";
+} from "./chunk-BNSD3VDY.mjs";
 import {
   resolveFarmTrailingSlashRedirect,
   setFarmTrailingSlashPreference
@@ -7419,20 +7425,6 @@ __name(createFarmApp, "createFarmApp");
 // src/build/tailwind.ts
 import path11 from "path";
 
-// src/optional-peer.ts
-function isMissingPackageError(error, packageName) {
-  if (!error || typeof error !== "object") return false;
-  const { code, message } = error;
-  if (code !== "ERR_MODULE_NOT_FOUND" && code !== "MODULE_NOT_FOUND") return false;
-  if (typeof message !== "string") return false;
-  return message.includes(`'${packageName}'`) || message.includes(`"${packageName}"`);
-}
-__name(isMissingPackageError, "isMissingPackageError");
-function formatOptionalPeerInstallHint(packageName, purpose, options = {}) {
-  return `Install "${packageName}" to ${purpose}: pnpm add ${options.dev ? "-D " : ""}${packageName}`;
-}
-__name(formatOptionalPeerInstallHint, "formatOptionalPeerInstallHint");
-
 // src/build/vite-plugin-compat.ts
 function adaptTailwindVitePlugin(pluginOption, builder) {
   if (builder !== "rolldown") return pluginOption;
@@ -7525,6 +7517,26 @@ function createMissingTailwindPlugin() {
 }
 __name(createMissingTailwindPlugin, "createMissingTailwindPlugin");
 
+// src/image-runtime.ts
+var SHARP_INSTALL_HINT = formatOptionalPeerInstallHint("sharp", "optimize images");
+var CLOUDFLARE_IMAGE_PRESETS = /* @__PURE__ */ new Set(["cloudflare", "cloudflare-pages", "cloudflare-module"]);
+function resolveFarmImageProviderForRuntime(images, options) {
+  const provider = images?.provider ?? "auto";
+  if (provider === "none") return images;
+  const usesSharp = options.dev ? true : provider === "node" || provider === "auto" && !CLOUDFLARE_IMAGE_PRESETS.has(options.preset || "");
+  if (!usesSharp || isOptionalPeerInstalled(options.root, "sharp")) return images;
+  if (provider === "node") {
+    throw new Error(
+      `images.provider "node" optimizes images with sharp, which is not installed. ${SHARP_INSTALL_HINT}`
+    );
+  }
+  logger.info(
+    `Image optimization is off because sharp is not installed; images use their original URLs. ${SHARP_INSTALL_HINT}, or set images.provider to "none".`
+  );
+  return Object.freeze({ ...images, provider: "none" });
+}
+__name(resolveFarmImageProviderForRuntime, "resolveFarmImageProviderForRuntime");
+
 // src/schema-step-types.ts
 function validateSchemaSteps(owner, schema, steps) {
   if (steps === void 0) return;
@@ -9494,7 +9506,7 @@ function loadFarmDocsSearchDevRuntime() {
 }
 __name(loadFarmDocsSearchDevRuntime, "loadFarmDocsSearchDevRuntime");
 function loadFarmOpenAPIDevRuntime() {
-  return import("./manager-NPG43N46.mjs");
+  return import("./manager-RT733VRK.mjs");
 }
 __name(loadFarmOpenAPIDevRuntime, "loadFarmOpenAPIDevRuntime");
 function loadFarmWorkflowsDevRuntime() {
@@ -9502,7 +9514,7 @@ function loadFarmWorkflowsDevRuntime() {
 }
 __name(loadFarmWorkflowsDevRuntime, "loadFarmWorkflowsDevRuntime");
 function loadFarmDevtoolsSnapshotRuntime() {
-  return import("./devtools-EZ5ORGAK.mjs");
+  return import("./devtools-OY4SNU3P.mjs");
 }
 __name(loadFarmDevtoolsSnapshotRuntime, "loadFarmDevtoolsSnapshotRuntime");
 function loadFarmDevtoolsUIRuntime() {
@@ -9532,14 +9544,29 @@ function farmI18nClientBridgePlugin() {
 __name(farmI18nClientBridgePlugin, "farmI18nClientBridgePlugin");
 var FARM_SERVER_ONLY_ENTRIES = /* @__PURE__ */ new Set(["@farm.js/core/og"]);
 function farmServerOnlyEntriesPlugin() {
+  let root = process.cwd();
+  let vercelOgInstalled = false;
   return {
     name: "farm:server-only-entries",
     enforce: "pre",
+    configResolved(config) {
+      root = config.root;
+    },
     resolveId(id, importer, options) {
-      if (options?.ssr || !FARM_SERVER_ONLY_ENTRIES.has(id)) return null;
-      this.error(
-        `${id} is server-only and cannot be imported into client code${importer ? ` (imported by ${importer})` : ""}. Use it from an API route or another server module.`
-      );
+      if (!FARM_SERVER_ONLY_ENTRIES.has(id)) return null;
+      const importedBy = importer ? ` (imported by ${importer})` : "";
+      if (!options?.ssr) {
+        this.error(
+          `${id} is server-only and cannot be imported into client code${importedBy}. Use it from an API route or another server module.`
+        );
+      }
+      vercelOgInstalled || (vercelOgInstalled = isOptionalPeerInstalled(root, "@vercel/og"));
+      if (!vercelOgInstalled) {
+        this.error(
+          `${id} needs @vercel/og, which is not installed${importedBy}. ${VERCEL_OG_INSTALL_HINT}`
+        );
+      }
+      return null;
     }
   };
 }
@@ -10180,6 +10207,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       }
       const apiServerBasePath = resolveFarmAPIServerBasePath(farmConfig.api);
       const serverConfig = resolveFarmServerConfig(farmConfig.server);
+      globalThis.__FARM_IMAGE_CONFIG__ = getPublicFarmImageConfig(farmConfig.images);
       let imageHandler = null;
       if (farmConfig.images.provider !== "none") {
         const { createNodeImageFetcher, createNodeImageUrlValidator, createSharpImageTransformer } = await import("./image/sharp.mjs");
@@ -14158,7 +14186,7 @@ async function defineConfig(config = {}) {
   const tailwindVitePlugin = await loadTailwindVitePlugin();
   const appRoot = path17.resolve(config.root || process.cwd());
   if (config.extends?.length) {
-    const { config: layeredConfig } = await import("./layers-CJKSJGLN.mjs").then(
+    const { config: layeredConfig } = await import("./layers-BRQF5ETU.mjs").then(
       ({ resolveFarmLayers }) => resolveFarmLayers(config, {
         root: appRoot,
         mode: process.env.NODE_ENV === "production" ? "production" : "development"
@@ -14167,6 +14195,7 @@ async function defineConfig(config = {}) {
     config = layeredConfig;
   }
   config.renderer = resolveFarmRenderer(config.renderer);
+  config.images = resolveFarmImageProviderForRuntime(config.images, { root: appRoot, dev: true });
   const rendererVitePlugins = await loadFarmRendererVitePlugins(config.renderer, appRoot, {
     ssr: true
   });
@@ -14393,6 +14422,8 @@ export {
   FarmPluginOptionsError,
   farmPluginMayAffectRuntimePath,
   loadTailwindVitePlugin,
+  SHARP_INSTALL_HINT,
+  resolveFarmImageProviderForRuntime,
   generateFarmClientPluginEntryCode,
   resolveFarmClientCacheAdapterEntry,
   generateClientCachePersistenceCode,

package/dist/{chunk-PUCUVI7K.mjs → chunk-72VJRKJD.mjs}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-IOEH4VWN.mjs";
 import {
   APIRouteConflictError
-} from "./chunk-CQHFU55R.mjs";
+} from "./chunk-WNUBR4CA.mjs";
 import {
   findProgrammaticRouteFilesInDir
 } from "./chunk-YOYF2E4U.mjs";

package/dist/{chunk-PC33YKTC.mjs → chunk-ARHWIOUZ.mjs}

@@ -7,7 +7,7 @@ import {
 import {
   compileFarmDocsAdapterEdgeManifest,
   createFarmDocsAPIHandler
-} from "./chunk-ONMW3EVV.mjs";
+} from "./chunk-YGMK6ESJ.mjs";
 import {
   FARM_DOCS_LAST_MODIFIED_MANIFEST,
   createFarmDocsHandler,
@@ -17,7 +17,7 @@ import {
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-HSDL2AUR.mjs";
+} from "./chunk-47H7VENP.mjs";
 import {
   generateFarmDocsSearchClientRuntime,
   isFarmDocsSearchEnabled,
@@ -26,15 +26,18 @@ import {
 import {
   FARM_PRERENDER_ENV
 } from "./chunk-6VEHUKZ2.mjs";
+import {
+  loadFarmDocsEngine
+} from "./chunk-2VQKKQ6D.mjs";
 import {
   getDefaultDeployOutputDir,
   getDeployTargetForPreset,
   hasCustomFarmRouteContext,
   resolveDeployOutputPath
-} from "./chunk-SPSQFO3Z.mjs";
+} from "./chunk-BDJNP7AQ.mjs";
 import {
   resolveFarmInstrumentationFile
-} from "./chunk-F5D4XEAS.mjs";
+} from "./chunk-ZZSRYEYU.mjs";
 import {
   resolveFarmInstrumentationRuntime
 } from "./chunk-H77NVNJ2.mjs";
@@ -42,6 +45,7 @@ import {
   DEFAULT_NOT_FOUND_STYLES,
   FARM_LAYOUT_ELEMENT_CLIENT_SOURCE,
   PluginManager,
+  SHARP_INSTALL_HINT,
   createFarmApp,
   createFarmSourceAlias,
   createFarmThemeCssPlugin,
@@ -62,15 +66,16 @@ import {
   mergeFarmProductionViteConfig,
   mergeFarmViteConfig,
   resolveFarmClientCacheAdapterEntry,
+  resolveFarmImageProviderForRuntime,
   resolveFarmIsolatedClientHydrationMode,
   resolveFarmNotFoundComponentPath
-} from "./chunk-AAWTJW2G.mjs";
+} from "./chunk-6YSEHN46.mjs";
 import {
   findRequestBoundSourceBlockers,
   generateFarmTypeArtifacts,
   parseRouteRenderingDirective,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-GKT4ONKN.mjs";
+} from "./chunk-VVJCWBIE.mjs";
 import {
   isFarmPreviewDeploymentEnvironment
 } from "./chunk-BOYNDCZL.mjs";
@@ -90,7 +95,7 @@ import {
 } from "./chunk-GHFS7RUB.mjs";
 import {
   getFarmAppDirectories
-} from "./chunk-IILNZK5G.mjs";
+} from "./chunk-JHWOVJ3M.mjs";
 import {
   REACT_RENDERER,
   getFarmRendererCapabilities,
@@ -122,7 +127,7 @@ import {
 import {
   applyFarmWorkflowVercelCrons,
   prepareFarmWorkflowsForNitro
-} from "./chunk-EGJDUF4Q.mjs";
+} from "./chunk-3ATMYLLJ.mjs";
 import {
   getFarmIntegrationPluginServerRuntime,
   getIntegrationProviders
@@ -132,10 +137,13 @@ import {
 } from "./chunk-TIKNUAU7.mjs";
 import {
   APIRouteManager
-} from "./chunk-CQHFU55R.mjs";
+} from "./chunk-WNUBR4CA.mjs";
 import {
   readFarmI18nCatalogs
 } from "./chunk-FV45CKBC.mjs";
+import {
+  VERCEL_OG_INSTALL_HINT
+} from "./chunk-YOZYCI6Z.mjs";
 import {
   resolveFarmAPIServerBasePath,
   resolveFarmAPIServerRoutePath
@@ -1073,6 +1081,9 @@ var NITRO_EXTERNAL_MODULES = /* @__PURE__ */ new Set([
   "fsevents",
   "esbuild",
   "lightningcss",
+  "rolldown",
+  "rolldown/experimental",
+  "rolldown/utils",
   "rollup",
   "vite",
   "nitro",
@@ -1313,69 +1324,70 @@ function hasFarmRuntimeConfigModule(config, configModulePath) {
   return Boolean(configModulePath || (config.layers || []).some((layer) => layer.configFile));
 }
 __name(hasFarmRuntimeConfigModule, "hasFarmRuntimeConfigModule");
-function createEsbuildTransformOptions(configuredEsbuildOptions, minify, defaultTarget) {
-  const {
-    include: _include,
-    exclude: _exclude,
-    sourceMap: _sourceMap,
-    loaders: _loaders,
-    ...configuredTransformOptions
-  } = configuredEsbuildOptions;
-  const configuredTarget = Array.isArray(configuredTransformOptions.target) ? configuredTransformOptions.target.filter(
-    (target) => typeof target === "string"
-  ) : configuredTransformOptions.target;
-  const transformTarget = Array.isArray(configuredTarget) && configuredTarget.length === 0 ? defaultTarget : configuredTarget ?? defaultTarget;
-  const transformSupported = configuredTransformOptions.supported ? Object.fromEntries(
-    Object.entries(configuredTransformOptions.supported).filter(
-      (entry) => typeof entry[1] === "boolean"
-    )
-  ) : void 0;
-  return {
-    ...configuredTransformOptions,
-    format: "esm",
-    target: transformTarget,
-    loader: "js",
-    sourcemap: false,
-    minify,
-    keepNames: configuredTransformOptions.keepNames ?? true,
-    legalComments: configuredTransformOptions.legalComments ?? "none",
-    supported: transformSupported
-  };
+async function minifyFarmServerChunk(code, fileName, options) {
+  const rolldownUtils = await import("rolldown/utils");
+  const keepNames = { function: options.keepNames, class: options.keepNames };
+  const result = await rolldownUtils.minify(fileName, code, {
+    module: true,
+    compress: { target: options.target, keepNames },
+    mangle: { keepNames },
+    codegen: { legalComments: "none", asciiOnly: true },
+    sourcemap: false
+  });
+  if (result.errors.length > 0) {
+    throw new Error(`Failed to minify ${fileName}: ${result.errors[0].message}`);
+  }
+  return restoreLiteralModuleSpecifiers(result.code, fileName, rolldownUtils);
+}
+__name(minifyFarmServerChunk, "minifyFarmServerChunk");
+function restoreLiteralModuleSpecifiers(code, fileName, { parseSync, Visitor }) {
+  if (!code.includes("import(`") && !code.includes("require(`")) return code;
+  const parsed = parseSync(fileName, code, { lang: "js", sourceType: "module" });
+  if (parsed.errors.length > 0) {
+    throw new Error(`Failed to minify ${fileName}: ${parsed.errors[0].message}`);
+  }
+  const replacements = [];
+  const restore = /* @__PURE__ */ __name((node) => {
+    if (node?.type !== "TemplateLiteral") return;
+    const template = node;
+    const value = template.quasis[0]?.value.cooked;
+    if (template.expressions.length > 0 || typeof value !== "string") return;
+    const text = JSON.stringify(value).replace(
+      /[\u007f-￿]/g,
+      (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`
+    );
+    replacements.push({ start: template.start, end: template.end, text });
+  }, "restore");
+  new Visitor({
+    ImportExpression(node) {
+      restore(node.source);
+    },
+    CallExpression(node) {
+      if (node.callee.type === "Identifier" && node.callee.name === "require" && node.arguments.length === 1) {
+        restore(node.arguments[0]);
+      }
+    }
+  }).visit(parsed.program);
+  let restored = "";
+  let offset = 0;
+  for (const { start, end, text } of replacements.sort((a, b) => a.start - b.start)) {
+    restored += code.slice(offset, start) + text;
+    offset = end;
+  }
+  return restored + code.slice(offset);
 }
-__name(createEsbuildTransformOptions, "createEsbuildTransformOptions");
-function createEsbuildChunkMinifyPlugin(configuredEsbuildOptions) {
-  const configuredTransformOptions = createEsbuildTransformOptions(
-    configuredEsbuildOptions,
-    true,
-    "esnext"
-  );
-  const transformOptions = {
-    format: "esm",
-    target: configuredTransformOptions.target,
-    loader: "js",
-    sourcemap: false,
-    minify: true,
-    keepNames: configuredTransformOptions.keepNames,
-    legalComments: configuredTransformOptions.legalComments,
-    charset: configuredTransformOptions.charset
-  };
+__name(restoreLiteralModuleSpecifiers, "restoreLiteralModuleSpecifiers");
+function createServerChunkMinifyPlugin(options) {
   return {
-    name: "farm-esbuild-minify",
+    name: "farm-server-chunk-minify",
     async renderChunk(code, chunk) {
-      const { transform } = await import("esbuild");
-      const result = await transform(code, {
-        ...transformOptions,
-        sourcefile: chunk.fileName
-      });
-      if (!result.code) return null;
-      return {
-        code: result.code,
-        map: result.map || null
-      };
+      const minified = await minifyFarmServerChunk(code, chunk.fileName, options);
+      if (!minified) return null;
+      return { code: minified, map: null };
     }
   };
 }
-__name(createEsbuildChunkMinifyPlugin, "createEsbuildChunkMinifyPlugin");
+__name(createServerChunkMinifyPlugin, "createServerChunkMinifyPlugin");
 function trimSlashes(value) {
   return value.replace(/^\/+|\/+$/g, "");
 }
@@ -2188,7 +2200,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
             if (id.includes("/api/") && id.includes("/route")) {
               return { id: "\0empty-api-route", external: false };
             }
-            if (id === "fsevents" || id.includes("fsevents") || id.endsWith(".node") || id === "nitro" || id === "vite" || id === "esbuild" || id === "rollup" || id.startsWith("nitro/") || id.includes("node-pre-gyp") || id.includes("nf3")) {
+            if (id === "fsevents" || id.includes("fsevents") || id.endsWith(".node") || id === "nitro" || id === "vite" || id === "esbuild" || id === "rolldown" || id.startsWith("rolldown/") || id === "rollup" || id.startsWith("nitro/") || id.includes("node-pre-gyp") || id.includes("nf3")) {
               return { id: "\0empty-module", external: false };
             }
             return null;
@@ -4388,7 +4400,7 @@ void hydrate();
 __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 } = await import("./vite.mjs");
+  const { farmPlugin, farmServerOnlyEntriesPlugin } = await import("./vite.mjs");
   const { PluginManager: PluginManager2 } = await import("./plugin.mjs");
   const fs = await import("fs/promises");
   const pluginManager = new PluginManager2({
@@ -4444,6 +4456,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
       modulePath: entry.modulePath
     });
   }
+  assertMetadataImageRuntimeInstalled(root, metadataImageRoutes);
   const applicationMetadataRoutes = Array.from(
     routeManager.getMetadataRoutes().values(),
     (entry) => ({
@@ -4487,7 +4500,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   const appDirs = getFarmAppDirectories(config);
   let openAPIReference = null;
   if (config.openapi.enabled && config.openapi.route) {
-    const { OpenAPIManager, renderOpenAPIReferenceHTML } = await import("./manager-NPG43N46.mjs");
+    const { OpenAPIManager, renderOpenAPIReferenceHTML } = await import("./manager-RT733VRK.mjs");
     const openAPIManager = new OpenAPIManager(appDirs, config.openapi, {
       mode: "production",
       apiBaseURL: config.api.baseURL
@@ -4648,6 +4661,9 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
           ...useExternalMetadataImageRuntime ? ["@vercel/og"] : [],
           "esbuild",
           "lightningcss",
+          "rolldown",
+          "rolldown/experimental",
+          "rolldown/utils",
           "rollup",
           "@rollup/rollup-darwin-arm64",
           "@rollup/rollup-darwin-x64",
@@ -4703,6 +4719,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
             };
           }
         },
+        farmServerOnlyEntriesPlugin(),
         farmPlugin({ ...config, isolatedClientBoundaryModules }, pluginManager),
         farmEnvironmentFunctionsPlugin(),
         {
@@ -9277,16 +9294,9 @@ export default async function farmNitroEventHandler(event) {
   if (selectRolldownBuilder) nitroConfig.builder = "rolldown";
   const useRolldownBuilder = canReusePrebuiltSSR && (nitroConfig.builder ?? process.env.NITRO_BUILDER) === "rolldown";
   const shouldMinify = nitroConfig.minify !== false;
-  const configuredEsbuildOptions = {};
-  const resolvedEsbuildOptions = {
-    // Function-name helpers are unsafe for provider scripts that serialize a
-    // function with toString(); the helper is outside the emitted script scope.
-    keepNames: !(config.docs?.enabled && config.docs.adapter?.server),
-    legalComments: "none"
-  };
-  const prebuiltSSREsbuildOptions = config.docs?.enabled && config.docs.adapter?.server ? resolvedEsbuildOptions : configuredEsbuildOptions;
-  const useFarmEsbuildMinifier = shouldMinify && nitroConfig.sourcemap === false && !hasCustomOxcOptions && !hasLateBuildMutationConfig;
-  const esbuildChunkMinifier = useFarmEsbuildMinifier ? createEsbuildChunkMinifyPlugin(resolvedEsbuildOptions) : null;
+  const keepServerNames = !(config.docs?.enabled && config.docs.adapter?.server);
+  const useFarmServerMinifier = shouldMinify && nitroConfig.sourcemap === false && !hasCustomOxcOptions && !hasLateBuildMutationConfig;
+  const serverChunkMinifier = useFarmServerMinifier ? createServerChunkMinifyPlugin({ keepNames: keepServerNames, target: "esnext" }) : null;
   if (canReusePrebuiltSSR) {
     const configuredRollupPlugins = nitroConfig.rollupConfig?.plugins;
     nitroConfig.rollupConfig = {
@@ -9297,7 +9307,7 @@ export default async function farmNitroEventHandler(event) {
       ]
     };
   }
-  nitroConfig.minify = useFarmEsbuildMinifier ? false : shouldMinify;
+  nitroConfig.minify = useFarmServerMinifier ? false : shouldMinify;
   const nitroInstance = await nitroBuilder.createNitro(nitroConfig);
   if (config.security.csp && config.security.csp.nonce) {
     nitroInstance.hooks.hook("prerender:generate", async (route) => {
@@ -9347,26 +9357,25 @@ export default async function farmNitroEventHandler(event) {
         await copyPrebuiltSSRBundle(
           ssrBundle,
           path5.join(prerenderServerDir, FARM_SSR_OUTPUT_DIR),
-          {},
-          false,
+          null,
           fs
         );
         await registerPrebuiltSSRPackageImport(prerenderServerDir, ssrEntryFile, fs);
       });
     });
   }
-  if (esbuildChunkMinifier || useRolldownBuilder) {
+  if (serverChunkMinifier || useRolldownBuilder) {
     nitroInstance.hooks.hook("rollup:before", (_nitro, rollupConfig) => {
       if (useRolldownBuilder) {
         const rolldownConfig = rollupConfig;
         delete rolldownConfig.inject;
         delete rolldownConfig.jsx;
       }
-      if (esbuildChunkMinifier) {
+      if (serverChunkMinifier) {
         const configuredPlugins = rollupConfig.plugins;
         rollupConfig.plugins = [
           ...Array.isArray(configuredPlugins) ? configuredPlugins : configuredPlugins ? [configuredPlugins] : [],
-          esbuildChunkMinifier
+          serverChunkMinifier
         ];
       }
     });
@@ -9413,8 +9422,7 @@ export default async function farmNitroEventHandler(event) {
     canReusePrebuiltSSR ? copyPrebuiltSSRBundle(
       ssrBundle,
       path5.join(outputDir, "server", FARM_SSR_OUTPUT_DIR),
-      prebuiltSSREsbuildOptions,
-      shouldMinify,
+      shouldMinify ? { keepNames: keepServerNames, target: "node18" } : null,
       fs
     ) : Promise.resolve(),
     runtimeCopyPromise
@@ -9458,23 +9466,7 @@ function resolveFarmNitroOutputConfig(preset, outputDir) {
   };
 }
 __name(resolveFarmNitroOutputConfig, "resolveFarmNitroOutputConfig");
-async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOptions, minify, fs) {
-  const {
-    include: _include,
-    exclude: _exclude,
-    sourceMap: _sourceMap,
-    loaders: _loaders,
-    ...configuredTransformOptions
-  } = configuredEsbuildOptions;
-  const hasConfiguredTransforms = Object.keys(configuredTransformOptions).some(
-    (option) => option !== "minify"
-  );
-  const transformOptions = createEsbuildTransformOptions(
-    configuredEsbuildOptions,
-    minify,
-    "node18"
-  );
-  const transform = minify || hasConfiguredTransforms ? (await import("esbuild")).transform : null;
+async function copyPrebuiltSSRBundle(ssrBundle, targetDir, minifyOptions, fs) {
   await fs.rm(targetDir, { recursive: true, force: true });
   await Promise.all(
     Object.entries(ssrBundle).map(async ([fileName, output]) => {
@@ -9484,14 +9476,7 @@ async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOpti
         await fs.writeFile(targetPath, output.source);
         return;
       }
-      let code = output.code;
-      if (transform) {
-        const result = await transform(code, {
-          ...transformOptions,
-          sourcefile: fileName
-        });
-        code = result.code;
-      }
+      const code = minifyOptions ? await minifyFarmServerChunk(output.code, fileName, minifyOptions) : output.code;
       await fs.writeFile(targetPath, code);
     })
   );
@@ -9666,9 +9651,7 @@ async function stageSharpRuntime(config, root, distDir, fs, preset) {
   try {
     await copyPackage("sharp", sharpRequire);
     if (!copiedPackages.has("sharp")) {
-      throw new Error(
-        "Farm image optimization requires sharp. Reinstall dependencies without omitting optional packages."
-      );
+      throw new Error(`Farm image optimization requires sharp. ${SHARP_INSTALL_HINT}`);
     }
   } catch (error) {
     await fs.rm(stageDir, { recursive: true, force: true });
@@ -9740,22 +9723,29 @@ async function mergeStagedDirectory(sourceDir, targetDir, fs) {
   );
 }
 __name(mergeStagedDirectory, "mergeStagedDirectory");
-async function copyMetadataImageRuntime(root, nitroFuncDir, fs) {
+function assertMetadataImageRuntimeInstalled(root, metadataImageRoutes) {
+  const generated = metadataImageRoutes.find((image) => image.sourceType === "module");
+  if (!generated || resolveMetadataImageRuntimePackageJson(root)) return;
+  const file = generated.modulePath ? toPosixPath(path5.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(path5.join(root, "package.json"));
-  let runtimeRequire = projectRequire;
-  let packageJsonPath = resolvePackageJson(runtimeRequire, "@vercel/og");
-  if (!packageJsonPath) {
-    try {
-      runtimeRequire = createRequire(projectRequire.resolve("@farm.js/core"));
-      packageJsonPath = resolvePackageJson(runtimeRequire, "@vercel/og");
-    } catch {
-    }
-  }
-  if (!packageJsonPath) {
-    throw new Error(
-      "Generated metadata images require @vercel/og. Reinstall @farm.js/core with production dependencies."
-    );
+  const packageJsonPath = resolvePackageJson(projectRequire, "@vercel/og");
+  if (packageJsonPath) return packageJsonPath;
+  try {
+    return resolvePackageJson(createRequire(projectRequire.resolve("@farm.js/core")), "@vercel/og");
+  } catch {
+    return null;
   }
+}
+__name(resolveMetadataImageRuntimePackageJson, "resolveMetadataImageRuntimePackageJson");
+async function copyMetadataImageRuntime(root, nitroFuncDir, fs) {
+  const packageJsonPath = resolveMetadataImageRuntimePackageJson(root);
+  if (!packageJsonPath) return;
   const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
   const packageDir = path5.dirname(packageJsonPath);
   const targetDir = path5.join(nitroFuncDir, "node_modules", "@vercel", "og");
@@ -9930,6 +9920,14 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
         outputDir: targets.outputDir
       }
     };
+    config = {
+      ...config,
+      images: resolveFarmImageProviderForRuntime(config.images, {
+        root: targets.root,
+        preset: targets.preset
+      })
+    };
+    if (config.docs?.enabled) await loadFarmDocsEngine();
     pluginManager.updateContext({ config });
     const { root, preset, srcDir, distDir, deployOutputDir } = targets;
     logger.info(`\u{1F69C} Building Farm.js application with preset: ${preset}...`);
@@ -10191,7 +10189,7 @@ function resolveLegacyPageEntry(config, root, srcDir) {
 __name(resolveLegacyPageEntry, "resolveLegacyPageEntry");
 async function buildNitro(config, routeManager, apiRouteManager, serverRenderer, preset, root, distDir, pluginManager) {
   const [{ createNitroConfig }, { createNitro, build: nitroBuild }] = await Promise.all([
-    import("./nitro-4LFVTT24.mjs"),
+    import("./nitro-ZKLGOTVY.mjs"),
     import("nitro/builder")
   ]);
   let nitroConfig = await createNitroConfig(