@farm.js/core 0.1.22 → 0.1.23

package/dist/{chunk-AAWTJW2G.mjs → chunk-VPY755R2.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-EHUZ2MKO.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-GKT4ONKN.mjs → chunk-VVJCWBIE.mjs}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-ZMSZZXOR.mjs";
 import {
   APITypeGenerator
-} from "./chunk-3NM6SRI6.mjs";
+} from "./chunk-F3VB7ONA.mjs";
 import {
   mergeRouteRenderingDirectiveConfig
 } from "./chunk-DAO7JGTS.mjs";
@@ -20,7 +20,7 @@ import {
 import {
   getFarmAppDirectories,
   getFarmSourceRoots
-} from "./chunk-IILNZK5G.mjs";
+} from "./chunk-JHWOVJ3M.mjs";
 import {
   resolveFarmComponentExtensions
 } from "./chunk-DAATZTKJ.mjs";

package/dist/{chunk-2HCEC2YO.cjs → chunk-VXCA7RZP.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});// package.json
-var version = "0.1.22";
+var version = "0.1.23";
 
 // src/version.ts
 var FARM_VERSION = version;

package/dist/{chunk-CQHFU55R.mjs → chunk-WNUBR4CA.mjs}

@@ -7,6 +7,9 @@ import {
 import {
   _runWithFarmI18nRequest
 } from "./chunk-JNGIWIY6.mjs";
+import {
+  explainMissingOptionalPeer
+} from "./chunk-YOZYCI6Z.mjs";
 import {
   API_ROUTE_METHODS,
   getAllowedAPIRouteMethods,
@@ -226,7 +229,8 @@ var _APIRouteManager = class _APIRouteManager {
       }
     }
   }
-  handleLoadError(message, error) {
+  handleLoadError(message, loadError) {
+    const error = explainMissingOptionalPeer(loadError, message.replace(/^Error loading /, ""));
     logger.error(`${message}: ${error}`);
     if (this.throwOnLoadError || error instanceof APIRouteConflictError || error instanceof AmbiguousRouteError || error instanceof NonTerminalCatchAllRouteError) {
       throw error;

package/dist/{chunk-CIAGU2X4.cjs → chunk-XSIRSMAS.cjs}

@@ -18,13 +18,15 @@ var _module = require('module');
 var _path = require('path');
 var _esmodulelexer = require('es-module-lexer');
 var moduleLexerInitialized = false;
-var JSX_ROUTE_LOADERS = { ".jsx": "jsx", ".tsx": "tsx" };
-var esbuildTransformSync;
-function transformJSXRoute(content, loader, filePath) {
-  _nullishCoalesce(esbuildTransformSync, () => ( (esbuildTransformSync = _module.createRequire.call(void 0, typeof __filename === "string" ? __filename : _chunkS3JO3N4Hcjs.define_import_meta_default.url)(
-    "esbuild"
+var JSX_ROUTE_LANGS = { ".jsx": "jsx", ".tsx": "tsx" };
+var oxcTransformSync;
+function transformJSXRoute(content, lang, filePath) {
+  _nullishCoalesce(oxcTransformSync, () => ( (oxcTransformSync = _module.createRequire.call(void 0, typeof __filename === "string" ? __filename : _chunkS3JO3N4Hcjs.define_import_meta_default.url)(
+    "rolldown/utils"
   ).transformSync)));
-  return esbuildTransformSync(content, { loader, sourcefile: filePath }).code;
+  const result = oxcTransformSync(filePath, content, { lang, sourceType: "module" });
+  if (result.errors.length > 0) throw result.errors[0];
+  return result.code;
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, transformJSXRoute, "transformJSXRoute");
 var API_CLIENT_METHOD_SEGMENTS = /* @__PURE__ */ new Set([
@@ -121,8 +123,8 @@ var _APITypeGenerator = class _APITypeGenerator {
       moduleLexerInitialized = true;
     }
     const httpMethods = ["GET", "HEAD", "QUERY", "POST", "PUT", "DELETE", "PATCH", "OPTIONS"];
-    const loader = JSX_ROUTE_LOADERS[_path.extname.call(void 0, filePath)];
-    const source = loader ? transformJSXRoute(content, loader, filePath) : content;
+    const lang = JSX_ROUTE_LANGS[_path.extname.call(void 0, filePath)];
+    const source = lang ? transformJSXRoute(content, lang, filePath) : content;
     const [, exports] = _esmodulelexer.parse.call(void 0, source);
     const valueExports = new Set(
       exports.filter((specifier) => !this.isTypeOnlyExportSpecifier(source, specifier.s)).map((specifier) => specifier.n)

package/dist/{chunk-ONMW3EVV.mjs → chunk-YGMK6ESJ.mjs}

@@ -3,10 +3,14 @@ import {
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-HSDL2AUR.mjs";
+} from "./chunk-47H7VENP.mjs";
+import {
+  docsEngine,
+  loadFarmDocsEngine
+} from "./chunk-2VQKKQ6D.mjs";
 import {
   resolveDocsConfig
-} from "./chunk-SPSQFO3Z.mjs";
+} from "./chunk-BDJNP7AQ.mjs";
 import {
   getFarmDocsAdapterConfigModule
 } from "./chunk-VVBO3QH7.mjs";
@@ -120,21 +124,6 @@ async function createFarmDocsAdapterHandler(docs, options) {
 __name(createFarmDocsAdapterHandler, "createFarmDocsAdapterHandler");
 
 // src/docs/api.ts
-import {
-  buildDocsAgentDiscoverySpec,
-  buildDocsConfigMap,
-  buildDocsDiagnostics as buildFarmingDocsDiagnostics,
-  buildDocsSitemapManifest,
-  performDocsSearch,
-  renderDocsAgentsDocument,
-  renderDocsLlmsTxt,
-  renderDocsMarkdownDocument,
-  renderDocsRobotsTxt,
-  renderDocsSitemapMarkdown,
-  renderDocsSitemapXml,
-  renderDocsSkillDocument
-} from "@farming-labs/docs";
-import { resolveApiReferenceOpenApiDiscovery } from "@farming-labs/docs/server";
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -344,7 +333,7 @@ function getDocsDiscoveryOptions(context, request) {
     llms: getDocsLlmsOptions(context, request),
     sitemap: context.docs.config.sitemap ?? true,
     robots: context.docs.config.robots ?? true,
-    openapi: resolveApiReferenceOpenApiDiscovery(context.docs.config.apiReference),
+    openapi: docsEngine().resolveApiReferenceOpenApiDiscovery(context.docs.config.apiReference),
     markdown: {
       acceptHeader: true,
       signatureAgentHeader: true
@@ -354,7 +343,7 @@ function getDocsDiscoveryOptions(context, request) {
 __name(getDocsDiscoveryOptions, "getDocsDiscoveryOptions");
 function buildSitemapManifest(context, request) {
   const origin = new URL(request.url).origin;
-  return buildDocsSitemapManifest({
+  return docsEngine().buildDocsSitemapManifest({
     pages: getLoadedDocsPages(context).map(toDocsSitemapPage),
     entry: context.docs.entry,
     siteTitle: getDocsTitle(context.docs),
@@ -363,7 +352,7 @@ function buildSitemapManifest(context, request) {
 }
 __name(buildSitemapManifest, "buildSitemapManifest");
 function renderLlmsTxt(context, request, full) {
-  const generated = renderDocsLlmsTxt(
+  const generated = docsEngine().renderDocsLlmsTxt(
     getLoadedDocsPages(context).map(toDocsLlmsPage),
     getDocsLlmsOptions(context, request)
   );
@@ -383,14 +372,14 @@ function renderSkillDocument(context, request) {
     "- Sitemap XML: /api/docs?format=sitemap-xml",
     "- Agent spec JSON: /api/docs/agent/spec"
   ].join("\n");
-  return `${renderDocsSkillDocument(getDocsDiscoveryOptions(context, request)).trim()}
+  return `${docsEngine().renderDocsSkillDocument(getDocsDiscoveryOptions(context, request)).trim()}
 
 ${farmAliases}
 `;
 }
 __name(renderSkillDocument, "renderSkillDocument");
 function renderAgentsDocument(context, request) {
-  return `${renderDocsAgentsDocument(getDocsDiscoveryOptions(context, request)).trim()}
+  return `${docsEngine().renderDocsAgentsDocument(getDocsDiscoveryOptions(context, request)).trim()}
 `;
 }
 __name(renderAgentsDocument, "renderAgentsDocument");
@@ -398,7 +387,7 @@ function buildAgentSpec(context, request) {
   const url = new URL(request.url);
   const origin = url.origin;
   const pages = discoverFarmDocsPages(context.contentDir, context.docs);
-  const spec = buildDocsAgentDiscoverySpec(getDocsDiscoveryOptions(context, request));
+  const spec = docsEngine().buildDocsAgentDiscoverySpec(getDocsDiscoveryOptions(context, request));
   const title = getDocsTitle(context.docs);
   return {
     ...spec,
@@ -440,7 +429,7 @@ function buildAgentSpec(context, request) {
 __name(buildAgentSpec, "buildAgentSpec");
 function buildDiagnostics(context) {
   const pages = discoverFarmDocsPages(context.contentDir, context.docs);
-  const diagnostics = buildFarmingDocsDiagnostics(context.docs.config, {
+  const diagnostics = docsEngine().buildDocsDiagnostics(context.docs.config, {
     entry: context.docs.entry,
     mcp: {
       enabled: false,
@@ -477,7 +466,7 @@ async function searchDocs(context, request, query) {
   const sourcePages = loadedPages.map(toDocsSourcePage);
   const sourcePageByUrl = new Map(sourcePages.map((page) => [page.url, page]));
   const resultLimit = isRecord(context.docs.config.search) && typeof context.docs.config.search.maxResults === "number" ? context.docs.config.search.maxResults : void 0;
-  const results = await performDocsSearch({
+  const results = await docsEngine().performDocsSearch({
     pages: sourcePages,
     query,
     search: context.docs.config.search ?? true,
@@ -498,6 +487,7 @@ async function searchDocs(context, request, query) {
 }
 __name(searchDocs, "searchDocs");
 async function resolveAPIContext(options) {
+  await loadFarmDocsEngine();
   const runtimeConfig = globalThis.__FARM_DOCS_RUNTIME_CONFIG__;
   const root = options.rootDir || options.root || runtimeConfig?.root || process.cwd();
   const srcDir = options.srcDir || runtimeConfig?.srcDir || "src";
@@ -531,7 +521,7 @@ async function handleDocsAPIGet(request, context) {
       entry: context.docs.entry,
       contentDir: context.docs.contentDir || context.docs.config.contentDir || null,
       config: context.docs.config,
-      map: buildDocsConfigMap(context.docs.config, {
+      map: docsEngine().buildDocsConfigMap(context.docs.config, {
         file: context.docs.configPath || "farm.config.ts"
       })
     });
@@ -548,7 +538,7 @@ async function handleDocsAPIGet(request, context) {
     return text(renderLlmsTxt(context, request, true), "text/plain; charset=utf-8");
   if (format === "sitemap-md") {
     return text(
-      renderDocsSitemapMarkdown(buildSitemapManifest(context, request), {
+      docsEngine().renderDocsSitemapMarkdown(buildSitemapManifest(context, request), {
         includeDescriptions: true
       }),
       "text/markdown; charset=utf-8"
@@ -557,7 +547,7 @@ async function handleDocsAPIGet(request, context) {
   if (format === "sitemap-xml" || format === "sitemap") {
     const origin = new URL(request.url).origin;
     return text(
-      renderDocsSitemapXml(buildSitemapManifest(context, request), {
+      docsEngine().renderDocsSitemapXml(buildSitemapManifest(context, request), {
         baseUrl: origin,
         includeLastmod: true
       }),
@@ -566,7 +556,7 @@ async function handleDocsAPIGet(request, context) {
   }
   if (format === "robots") {
     return text(
-      renderDocsRobotsTxt({
+      docsEngine().renderDocsRobotsTxt({
         entry: context.docs.entry,
         sitemap: context.docs.config.sitemap ?? true,
         robots: context.docs.config.robots ?? true,
@@ -581,7 +571,7 @@ async function handleDocsAPIGet(request, context) {
     const page = loadFarmDocsPage(context.contentDir, context.docs, slug);
     if (!page) return text("Docs page not found\n", "text/plain; charset=utf-8", { status: 404 });
     return text(
-      renderDocsMarkdownDocument(toFarmDocsMarkdownPage(page), {
+      docsEngine().renderDocsMarkdownDocument(toFarmDocsMarkdownPage(page), {
         origin: new URL(request.url).origin,
         llms: getDocsLlmsOptions(context, request),
         sitemap: context.docs.config.sitemap

package/dist/chunk-YOZYCI6Z.mjs

@@ -0,0 +1,73 @@
+import {
+  __name
+} from "./chunk-LPEX4YW6.mjs";
+
+// src/optional-peer.ts
+import { createRequire } from "module";
+import path from "path";
+function isMissingPackageError(error, packageName) {
+  let current = error;
+  for (let depth = 0; depth < 4; depth++) {
+    if (!current || typeof current !== "object") return false;
+    const { code, message, cause } = current;
+    if ((code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") && typeof message === "string") {
+      return message.includes(`'${packageName}'`) || message.includes(`"${packageName}"`);
+    }
+    current = cause;
+  }
+  return false;
+}
+__name(isMissingPackageError, "isMissingPackageError");
+function isOptionalPeerInstalled(root, packageName) {
+  const appRequire = createRequire(path.join(root, "package.json"));
+  const requires = [appRequire];
+  try {
+    requires.push(createRequire(appRequire.resolve("@farm.js/core")));
+  } catch {
+  }
+  return requires.some((parentRequire) => {
+    try {
+      parentRequire.resolve(`${packageName}/package.json`);
+      return true;
+    } catch (error) {
+      return error.code === "ERR_PACKAGE_PATH_NOT_EXPORTED";
+    }
+  });
+}
+__name(isOptionalPeerInstalled, "isOptionalPeerInstalled");
+function formatOptionalPeerInstallHint(packageName, purpose, options = {}) {
+  return `Install "${packageName}" to ${purpose}: pnpm add ${options.dev ? "-D " : ""}${packageName}`;
+}
+__name(formatOptionalPeerInstallHint, "formatOptionalPeerInstallHint");
+var VERCEL_OG_INSTALL_HINT = formatOptionalPeerInstallHint(
+  "@vercel/og",
+  "render OG and metadata images"
+);
+var APP_IMPORTED_OPTIONAL_PEERS = [
+  ["@vercel/og", VERCEL_OG_INSTALL_HINT]
+];
+function explainMissingOptionalPeer(error, context) {
+  for (const [packageName, hint] of APP_IMPORTED_OPTIONAL_PEERS) {
+    if (isMissingPackageError(error, packageName)) {
+      return withOptionalPeerCause(
+        new Error(`${context} needs ${packageName}, which is not installed. ${hint}`),
+        error
+      );
+    }
+  }
+  return error;
+}
+__name(explainMissingOptionalPeer, "explainMissingOptionalPeer");
+function withOptionalPeerCause(error, cause) {
+  return Object.assign(error, { cause });
+}
+__name(withOptionalPeerCause, "withOptionalPeerCause");
+
+export {
+  isMissingPackageError,
+  isOptionalPeerInstalled,
+  formatOptionalPeerInstallHint,
+  VERCEL_OG_INSTALL_HINT,
+  explainMissingOptionalPeer,
+  withOptionalPeerCause
+};

package/dist/{chunk-HLCDYJY7.mjs → chunk-YQVSHTMR.mjs}

@@ -1,3 +1,8 @@
+import {
+  VERCEL_OG_INSTALL_HINT,
+  isMissingPackageError,
+  withOptionalPeerCause
+} from "./chunk-YOZYCI6Z.mjs";
 import {
   omitFarmResponseBody
 } from "./chunk-5WI2S4CO.mjs";
@@ -141,6 +146,20 @@ async function finalizeMetadataImageResponse(body, headers, options) {
   });
 }
 __name(finalizeMetadataImageResponse, "finalizeMetadataImageResponse");
+async function loadVercelOg() {
+  try {
+    return await import("@vercel/og");
+  } catch (error) {
+    if (!isMissingPackageError(error, "@vercel/og")) throw error;
+    throw withOptionalPeerCause(
+      new Error(
+        `Rendering a metadata image from JSX needs @vercel/og, which is not installed. ${VERCEL_OG_INSTALL_HINT}`
+      ),
+      error
+    );
+  }
+}
+__name(loadVercelOg, "loadVercelOg");
 async function createFarmMetadataImageResponse(value, imageModule, options = {}) {
   const method = (options.method || "GET").toUpperCase();
   if (method !== "GET" && method !== "HEAD") {
@@ -152,7 +171,7 @@ async function createFarmMetadataImageResponse(value, imageModule, options = {})
   const cacheControl = resolveCacheControl(imageModule.revalidate);
   const explicitContentType = imageModule.contentType?.split(";", 1)[0]?.trim().toLowerCase();
   if (isReactElement(value) && explicitContentType !== "image/svg+xml") {
-    const { ImageResponse } = await import("@vercel/og");
+    const { ImageResponse } = await loadVercelOg();
     const element = await prepareMetadataImageNode(value);
     const response = new ImageResponse(element, {
       width: imageModule.size?.width || 1200,

package/dist/{chunk-F5D4XEAS.mjs → chunk-ZZSRYEYU.mjs}

@@ -1,9 +1,11 @@
+import {
+  bundleNodeModule
+} from "./chunk-SFGWNC43.mjs";
 import {
   __name
 } from "./chunk-LPEX4YW6.mjs";
 
 // src/instrumentation.ts
-import { build } from "esbuild";
 import fs from "fs";
 import path from "path";
 import { pathToFileURL } from "url";
@@ -32,15 +34,12 @@ async function loadFarmInstrumentation(filePath, root) {
   const outputDirectory = path.join(root, ".farm", ".instrumentation-loader");
   const outputFile = path.join(outputDirectory, "instrumentation.mjs");
   await fs.promises.mkdir(outputDirectory, { recursive: true });
-  await build({
-    entryPoints: [filePath],
+  await bundleNodeModule({
+    root,
+    entry: filePath,
     outfile: outputFile,
-    bundle: true,
-    format: "esm",
-    platform: "node",
     target: "node20",
-    packages: "external",
-    sourcemap: "inline"
+    externalPackages: true
   });
   const url = pathToFileURL(outputFile);
   url.searchParams.set("t", String(Date.now()));

package/dist/{client-plugins-CWrhb1ir.d.mts → client-plugins-B_XzCegf.d.mts}

@@ -12,12 +12,13 @@ import { OrmClient, SchemaDefinition, ModelDefinition, FieldBuilder, JsonValue,
 import { a as FarmDocsUserConfig, F as FarmDocsResolvedConfig } from './types-DFbjpjXX.mjs';
 import { FarmObservabilityUserConfig } from './observability.mjs';
 import * as vite from 'vite';
-import { ViteDevServer, UserConfig, Plugin, Connect } from 'vite';
+import { ViteDevServer, UserConfig, Plugin as Plugin$1, Connect } from 'vite';
 import { k as FarmWorkflowsUserConfig, a as FarmServerConfig, F as FarmWorkflowsResolvedConfig, R as ResolvedFarmServerConfig } from './workflows-CR9ex-gz.mjs';
 import { FarmCronUserConfig, FarmCronResolvedConfig } from './cron.mjs';
 import { ResolvedFarmEnv, FarmEnvConfig } from './env.mjs';
 import { FarmServerActionsConfig, ResolvedFarmServerActionsConfig } from './server-action-security.mjs';
-import * as esbuild from 'esbuild';
+import * as rolldown_utils from 'rolldown/utils';
+import { Plugin } from 'rolldown';
 import { F as FarmImageConfig, R as ResolvedFarmImageConfig } from './image-config-Duob7wER.mjs';
 import { g as FarmI18nUserConfig, R as ResolvedFarmI18nConfig } from './types-Z0aotQ8w.mjs';
 import { FarmCacheUserConfig } from './cache.mjs';
@@ -947,7 +948,7 @@ declare function routeRulesToRedirects(routeRules: FarmRouteRules): RedirectConf
 declare function routeRulesToHeaders(routeRules: FarmRouteRules): HeaderConfig[];
 declare function routeRulesToNitroRouteRules(routeRules: FarmRouteRules): Record<string, any>;
 
-type EsbuildTransform = (typeof esbuild)["transform"];
+type OxcTransform = (typeof rolldown_utils)["transform"];
 type FarmLayerEntry = string;
 interface ResolvedFarmLayer {
     /** The value used in `extends`. */
@@ -991,8 +992,8 @@ declare function getFarmAppDirectories(config: {
 }): string[];
 declare function getFarmLayerAliases(layers: readonly ResolvedFarmLayer[] | undefined): Record<string, string>;
 declare function createFarmConfigResolutionPlugin(options: {
-    transform: EsbuildTransform;
-}): esbuild.Plugin;
+    transform: OxcTransform;
+}): Plugin;
 declare function loadFarmConfigFile<TConfig = Record<string, any>>(configPath: string, options: {
     root: string;
     cacheRoot?: string;
@@ -1509,13 +1510,14 @@ interface FarmVitePluginOptions extends FarmConfig {
     /** @internal Modules selected by the compiled isolated-hydration ownership plan. */
     isolatedClientBoundaryModules?: ReadonlySet<string>;
 }
-declare function farmI18nClientBridgePlugin(): Plugin;
+declare function farmI18nClientBridgePlugin(): Plugin$1;
 /**
  * Fail a browser graph that imports a server-only core entry, instead of
  * bundling its server runtime (for `@farm.js/core/og`, the `@vercel/og` wasm
- * renderer) into client code.
+ * renderer) into client code. A server graph that imports `@farm.js/core/og`
+ * without the optional `@vercel/og` peer fails with the install command.
  */
-declare function farmServerOnlyEntriesPlugin(): Plugin;
+declare function farmServerOnlyEntriesPlugin(): Plugin$1;
 
 /** Exported for tests: the request boundary all Farm dev middlewares share. */
 declare function withFarmRequestTracing(handler: Parameters<typeof _withAfterNodeMiddleware>[0], apiRuntime?: APIRequestRuntime, resolveTraceUrl?: (request: Connect.IncomingMessage) => URL): Connect.NextHandleFunction;
@@ -1548,7 +1550,7 @@ declare function transformIsolatedClientBoundaryModule(options: {
  * Farm leaves the module unaccepted.
  */
 declare function shouldEmitFarmClientRootHmr(renderer?: FarmRenderer): boolean;
-declare function farmPlugin(options?: FarmVitePluginOptions, initialPluginManager?: PluginManager): Plugin;
+declare function farmPlugin(options?: FarmVitePluginOptions, initialPluginManager?: PluginManager): Plugin$1;
 declare function defineConfig(config?: FarmVitePluginOptions): Promise<UserConfig>;
 
 type MaybePromise$1<T> = T | Promise<T>;