@farm.js/core 0.1.22 → 0.1.24

package/dist/{chunk-AYJR42WX.cjs → chunk-UFDV5N3C.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkCIAGU2X4cjs = require('./chunk-CIAGU2X4.cjs');
+var _chunkXSIRSMAScjs = require('./chunk-XSIRSMAS.cjs');
 
 
 
@@ -603,7 +603,7 @@ var _OpenAPIManager = class _OpenAPIManager {
     this.appDir = appDirs[appDirs.length - 1];
     this.config = config;
     this.generator = new OpenAPIGenerator(this.appDir, config, context);
-    this.apiTypeGenerator = new (0, _chunkCIAGU2X4cjs.APITypeGenerator)(appDirs);
+    this.apiTypeGenerator = new (0, _chunkXSIRSMAScjs.APITypeGenerator)(appDirs);
   }
   /**
    * Generate OpenAPI spec from API routes

package/dist/chunk-UYIHRDE4.cjs

@@ -0,0 +1,97 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+
+// src/build/node-module-bundle.ts
+var _module = require('module');
+var _path = require('path'); var _path2 = _interopRequireDefault(_path);
+var _util = require('util');
+var NON_PACKAGE_SPECIFIER_RE = /^(?:[./\\#]|[A-Za-z]:[\\/])/;
+function isPackageSpecifier(specifier) {
+  return !specifier.startsWith("\0") && !NON_PACKAGE_SPECIFIER_RE.test(specifier) && !_path2.default.isAbsolute(specifier);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isPackageSpecifier, "isPackageSpecifier");
+var DECLARATION_FILE_RE = /\.d\.(?:[^./\\]+\.)?[cm]?ts$/;
+function isDeclarationFile(id) {
+  return DECLARATION_FILE_RE.test(id.split("?", 1)[0]);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isDeclarationFile, "isDeclarationFile");
+var packageResolvers = /* @__PURE__ */ new Map();
+async function resolvePackageWithoutTsconfig(source, importer, kind) {
+  const condition = kind === "require-call" ? "require" : "import";
+  let resolver = packageResolvers.get(condition);
+  if (!resolver) {
+    resolver = import("rolldown/experimental").then(
+      ({ ResolverFactory }) => new ResolverFactory({
+        conditionNames: [condition, "node", "default"],
+        mainFields: ["main", "module"]
+      })
+    );
+    packageResolvers.set(condition, resolver);
+  }
+  const result = await (await resolver).async(_path2.default.dirname(importer), source);
+  return _nullishCoalesce(result.path, () => ( null));
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, resolvePackageWithoutTsconfig, "resolvePackageWithoutTsconfig");
+async function bundleNodeModule(options) {
+  const { rolldown } = await import("rolldown");
+  const plugins = options.externalPackages ? [externalizePackagesPlugin()] : [];
+  plugins.push(..._nullishCoalesce(options.plugins, () => ( [])));
+  try {
+    const bundle = await rolldown({
+      cwd: options.root,
+      input: options.entry,
+      platform: "node",
+      logLevel: "silent",
+      external: options.external,
+      plugins,
+      // Package imports stay external by the path they were found at (as esbuild
+      // did), so a workspace symlink is not mistaken for a local alias target.
+      resolve: options.externalPackages ? { symlinks: false } : void 0,
+      transform: { target: options.target, jsx: { runtime: "automatic" } }
+    });
+    try {
+      await bundle.write({
+        file: options.outfile,
+        format: "esm",
+        sourcemap: "inline",
+        codeSplitting: false
+      });
+    } finally {
+      await bundle.close();
+    }
+  } catch (error) {
+    throw withPlainDiagnostics(error);
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, bundleNodeModule, "bundleNodeModule");
+function externalizePackagesPlugin() {
+  return {
+    name: "farm-externalize-packages",
+    async resolveId(source, importer, extraOptions) {
+      if (!importer || !isPackageSpecifier(source) || _module.isBuiltin.call(void 0, source)) return null;
+      const resolved = await this.resolve(source, importer, {
+        kind: extraOptions.kind,
+        skipSelf: true
+      });
+      if (resolved && !resolved.external && !resolved.id.startsWith("\0") && !resolved.id.split(/[\\/]/).includes("node_modules") && !isDeclarationFile(resolved.id)) {
+        return resolved;
+      }
+      return { id: source, external: true };
+    }
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, externalizePackagesPlugin, "externalizePackagesPlugin");
+function withPlainDiagnostics(error) {
+  if (!(error instanceof Error)) return error;
+  error.message = _util.stripVTControlCharacters.call(void 0, error.message);
+  if (typeof error.stack === "string") error.stack = _util.stripVTControlCharacters.call(void 0, error.stack);
+  return error;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, withPlainDiagnostics, "withPlainDiagnostics");
+
+
+
+
+
+exports.isDeclarationFile = isDeclarationFile; exports.resolvePackageWithoutTsconfig = resolvePackageWithoutTsconfig; exports.bundleNodeModule = bundleNodeModule;

package/dist/{chunk-Y4YMF2NQ.cjs → chunk-VPTDD5XF.cjs}

@@ -1,4 +1,9 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+var _chunkUYIHRDE4cjs = require('./chunk-UYIHRDE4.cjs');
+
 
 var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
 
@@ -146,62 +151,47 @@ function toExternalSpecifier(resolvedPath) {
   return _path2.default.isAbsolute(resolvedPath) ? _url.pathToFileURL.call(void 0, resolvedPath).href : resolvedPath;
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, toExternalSpecifier, "toExternalSpecifier");
+var BARE_SPECIFIER_RE = /^[^./]/;
 function createFarmConfigResolutionPlugin(options) {
   const configEntryChecks = /* @__PURE__ */ new Map();
   return {
     name: "farm-config-package-resolution",
-    setup(pluginBuild) {
-      pluginBuild.onResolve({ filter: /^@farm\.js\/core$/ }, async (args) => {
-        if (_optionalChain([args, 'access', _ => _.pluginData, 'optionalAccess', _2 => _2.farmConfigExternal]) || args.kind !== "import-statement" || !args.importer) {
-          return;
-        }
-        let configEntryCheck = configEntryChecks.get(args.importer);
-        if (!configEntryCheck) {
-          configEntryCheck = onlyImportsFarmConfigHelpers(args.importer, options.transform);
-          configEntryChecks.set(args.importer, configEntryCheck);
-        }
-        if (!await configEntryCheck) return;
-        const resolved = await pluginBuild.resolve(FARM_CONFIG_ENTRY, {
-          importer: args.importer,
-          kind: args.kind,
-          namespace: args.namespace,
-          resolveDir: args.resolveDir,
-          pluginData: { farmConfigExternal: true }
+    async resolveId(source, importer, extraOptions) {
+      if (!importer || extraOptions.isEntry || !BARE_SPECIFIER_RE.test(source) || source.startsWith("\0") || _module.isBuiltin.call(void 0, source) || _path2.default.isAbsolute(source) || WINDOWS_ABSOLUTE_PATH_RE.test(source)) {
+        return null;
+      }
+      const resolveRuntimePath = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, async (specifier) => {
+        const resolved = await this.resolve(specifier, importer, {
+          kind: extraOptions.kind,
+          skipSelf: true
         });
-        if (resolved.errors.length > 0 || !resolved.path) return;
-        return {
-          path: toExternalSpecifier(resolved.path),
-          external: true,
-          warnings: resolved.warnings
-        };
-      });
-      pluginBuild.onResolve({ filter: /^[^./]/ }, async (args) => {
-        if (args.kind === "entry-point" || _path2.default.isAbsolute(args.path) || WINDOWS_ABSOLUTE_PATH_RE.test(args.path)) {
-          return;
+        if (!_optionalChain([resolved, 'optionalAccess', _ => _.id]) || !_chunkUYIHRDE4cjs.isDeclarationFile.call(void 0, resolved.id)) return _optionalChain([resolved, 'optionalAccess', _2 => _2.id]);
+        return await _asyncNullishCoalesce(await _chunkUYIHRDE4cjs.resolvePackageWithoutTsconfig.call(void 0, specifier, importer, extraOptions.kind), async () => ( void 0));
+      }, "resolveRuntimePath");
+      if (source === FARM_CORE_PACKAGE && extraOptions.kind === "import-statement") {
+        let configEntryCheck = configEntryChecks.get(importer);
+        if (!configEntryCheck) {
+          configEntryCheck = onlyImportsFarmConfigHelpers(importer, options.transform);
+          configEntryChecks.set(importer, configEntryCheck);
         }
-        if (_optionalChain([args, 'access', _3 => _3.pluginData, 'optionalAccess', _4 => _4.farmConfigExternal])) return;
-        const resolved = await pluginBuild.resolve(args.path, {
-          importer: args.importer,
-          kind: args.kind,
-          namespace: args.namespace,
-          resolveDir: args.resolveDir,
-          pluginData: { farmConfigExternal: true }
-        });
-        if (resolved.errors.length > 0 || !resolved.path) {
-          return { path: args.path, external: true };
+        if (await configEntryCheck) {
+          const configEntry = await resolveRuntimePath(FARM_CONFIG_ENTRY);
+          if (configEntry) {
+            return { id: toExternalSpecifier(configEntry), external: true };
+          }
         }
-        return {
-          path: toExternalSpecifier(resolved.path),
-          external: true,
-          warnings: resolved.warnings
-        };
-      });
+      }
+      const resolvedId = await resolveRuntimePath(source);
+      if (!resolvedId) {
+        return { id: source, external: true };
+      }
+      return { id: toExternalSpecifier(resolvedId), external: true };
     }
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, createFarmConfigResolutionPlugin, "createFarmConfigResolutionPlugin");
 async function loadFarmConfigFile(configPath, options) {
-  const { build, transform } = await import("esbuild");
+  const { transform } = await import("rolldown/utils");
   const cacheRoot = _path2.default.resolve(options.cacheRoot || options.root);
   const configCacheDir = _path2.default.join(cacheRoot, ".farm", ".config-loader");
   await _promises.mkdir.call(void 0, configCacheDir, { recursive: true });
@@ -209,18 +199,12 @@ async function loadFarmConfigFile(configPath, options) {
     configCacheDir,
     `farm-config-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
   );
-  await build({
-    absWorkingDir: _path2.default.resolve(options.root),
-    entryPoints: [_path2.default.resolve(configPath)],
+  await _chunkUYIHRDE4cjs.bundleNodeModule.call(void 0, {
+    root: _path2.default.resolve(options.root),
+    entry: _path2.default.resolve(configPath),
     outfile: modulePath,
-    bundle: true,
-    format: "esm",
-    platform: "node",
     target: `node${process.versions.node.split(".")[0]}`,
-    plugins: [createFarmConfigResolutionPlugin({ transform })],
-    jsx: "automatic",
-    logLevel: "silent",
-    sourcemap: "inline"
+    plugins: [createFarmConfigResolutionPlugin({ transform })]
   });
   const moduleUrl = `${_url.pathToFileURL.call(void 0, modulePath).href}?t=${Date.now()}`;
   try {
@@ -242,12 +226,12 @@ async function onlyImportsFarmConfigHelpers(importer, transform) {
   try {
     const source = _fs.readFileSync.call(void 0, importer, "utf8");
     if (!source.includes(FARM_CORE_PACKAGE)) return false;
-    const transformed = await transform(source, {
-      format: "esm",
-      jsx: "automatic",
-      loader: getEsbuildLoader(importer),
-      sourcefile: importer
+    const transformed = await transform(importer, source, {
+      lang: getSourceLang(importer),
+      sourceType: "module",
+      jsx: { runtime: "automatic" }
     });
+    if (transformed.errors.length > 0) return false;
     const references = [...transformed.code.matchAll(FARM_CORE_REFERENCE_RE)];
     if (references.length === 0) return false;
     const safeImportRanges = [];
@@ -268,7 +252,7 @@ async function onlyImportsFarmConfigHelpers(importer, transform) {
   }
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, onlyImportsFarmConfigHelpers, "onlyImportsFarmConfigHelpers");
-function getEsbuildLoader(file) {
+function getSourceLang(file) {
   switch (_path2.default.extname(file)) {
     case ".ts":
     case ".mts":
@@ -282,7 +266,7 @@ function getEsbuildLoader(file) {
       return "js";
   }
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, getEsbuildLoader, "getEsbuildLoader");
+_chunkS3JO3N4Hcjs.__name.call(void 0, getSourceLang, "getSourceLang");
 function normalizeLayerEntries(value, owner) {
   if (value === void 0) return [];
   if (!Array.isArray(value)) {

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-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()));