@farm.js/core 0.1.60 → 0.1.61

package/dist/chunk-OHLSEQ57.mjs

@@ -0,0 +1,910 @@
+import {
+  assertPluginDependencies,
+  resolveFarmAuthConfig,
+  resolveFarmAuthIntegration,
+  resolveFarmDevIndicatorsConfig,
+  setFarmProjectSourceDir
+} from "./chunk-RSOJ7DRT.mjs";
+import {
+  resolveFarmDevtoolsConfig
+} from "./chunk-JBSVKMC5.mjs";
+import {
+  normalizeRouteRules,
+  routeRulesToHeaders,
+  routeRulesToRedirects
+} from "./chunk-GHFS7RUB.mjs";
+import {
+  loadFarmConfigFile,
+  resolveFarmLayers
+} from "./chunk-BUGNQIHC.mjs";
+import {
+  isReactRenderer,
+  resolveFarmRenderer
+} from "./chunk-DAATZTKJ.mjs";
+import {
+  farmCspBlocksFrameworkInlineScripts,
+  getFarmSecurityHeader,
+  resolveFarmAgentCrawlers,
+  resolveFarmAgentSitemap,
+  resolveFarmNoindexPreviews,
+  resolveFarmPerformanceConfig,
+  resolveFarmSecurityConfig
+} from "./chunk-4E5WBPEG.mjs";
+import {
+  resolveFarmLlmsTxtConfig
+} from "./chunk-DTSROJ5J.mjs";
+import {
+  resolveFarmImageConfig
+} from "./chunk-G2KY33I6.mjs";
+import {
+  resolveCronConfig
+} from "./chunk-YHOCRI4H.mjs";
+import {
+  resolveServerActionsConfig
+} from "./chunk-4WVJLURN.mjs";
+import {
+  resolveEnv,
+  setEnv
+} from "./chunk-4OOBRCJX.mjs";
+import {
+  resolveMdxConfig
+} from "./chunk-FA2W42OV.mjs";
+import {
+  resolveMarkdownConfig
+} from "./chunk-WWIKMBRN.mjs";
+import {
+  bundleNodeModule
+} from "./chunk-SFGWNC43.mjs";
+import {
+  resolveWorkflowsConfig
+} from "./chunk-Q2KB32T4.mjs";
+import {
+  resolveFarmThemeConfig
+} from "./chunk-AELACLOB.mjs";
+import {
+  resolveIntegrationPlugins
+} from "./chunk-MKYBIIAQ.mjs";
+import {
+  resolveFarmServerConfig
+} from "./chunk-ZMMBIVQM.mjs";
+import {
+  resolveFarmI18nConfig
+} from "./chunk-BCMSYSN2.mjs";
+import {
+  logger
+} from "./chunk-KI3MESHB.mjs";
+import {
+  resolveFarmAPIConfig
+} from "./chunk-7LTCDQRS.mjs";
+import {
+  normalizeFarmDeploymentId
+} from "./chunk-2A3EQHXX.mjs";
+import {
+  validateConfigRouteSource
+} from "./chunk-SAXPH6G5.mjs";
+import {
+  isFarmRedirectStatus
+} from "./chunk-CBBLJMR5.mjs";
+import {
+  normalizeFarmConfigBasePath
+} from "./chunk-4RB44K6Z.mjs";
+import {
+  __name
+} from "./chunk-LPEX4YW6.mjs";
+
+// src/mcp-config.ts
+import { createRequire } from "module";
+import path from "path";
+import { pathToFileURL } from "url";
+function resolveFarmMCPConfig(input) {
+  if (input === false || input === void 0) return { enabled: false };
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
+    throw new TypeError("mcp must be a configuration object or false.");
+  }
+  return { ...input, enabled: input.enabled !== false };
+}
+__name(resolveFarmMCPConfig, "resolveFarmMCPConfig");
+async function resolveFarmMCPPlugin(config, options) {
+  if (!config.enabled) return void 0;
+  const root = path.resolve(options.root);
+  let modulePath;
+  try {
+    const resolveFromApp = createRequire(path.join(root, "package.json"));
+    modulePath = resolveFromApp.resolve("@farm.js/mcp/internal");
+  } catch {
+    throw new Error(
+      "The `mcp` config requires @farm.js/mcp. Install it with `pnpm add @farm.js/mcp` and try again."
+    );
+  }
+  const runtime = await import(
+    /* @vite-ignore */
+    pathToFileURL(modulePath).href
+  );
+  if (typeof runtime.createFarmMCPPlugin !== "function") {
+    throw new Error(
+      "The installed @farm.js/mcp package is incompatible with this version of @farm.js/core."
+    );
+  }
+  return runtime.createFarmMCPPlugin(config);
+}
+__name(resolveFarmMCPPlugin, "resolveFarmMCPPlugin");
+
+// src/config.ts
+import path3 from "path";
+
+// src/agent-config.ts
+var DEFAULT_JSON_LD = { type: "WebSite" };
+function resolveFarmAgentConfig(input, context = {}) {
+  const jsonLd = input?.jsonLd;
+  return {
+    jsonLd: jsonLd === void 0 ? { ...DEFAULT_JSON_LD } : !jsonLd ? false : jsonLd === true ? {} : jsonLd,
+    noindexPreviews: resolveFarmNoindexPreviews(input?.noindexPreviews),
+    // The docs engine answers /llms.txt with its own pages; a default here would replace it.
+    // llms-full.txt renders every listed page, so it stays opt-in.
+    llmsTxt: resolveFarmLlmsTxtConfig(input?.llmsTxt ?? (context.docs ? false : { full: false })),
+    // Same rule as llms.txt: the docs engine answers /sitemap.xml with its own pages.
+    sitemap: resolveFarmAgentSitemap(input?.sitemap ?? !context.docs),
+    crawlers: resolveFarmAgentCrawlers(input?.crawlers),
+    apiCatalog: resolveFarmAgentBoolean(input?.apiCatalog, "apiCatalog", false),
+    aiCatalog: resolveFarmAgentBoolean(input?.aiCatalog, "aiCatalog", true),
+    manifest: resolveFarmAgentBoolean(input?.manifest, "manifest", true),
+    // Same rule as llms.txt: the docs engine serves its own MCP server at /mcp.
+    mcp: resolveFarmAgentBoolean(input?.mcp, "mcp", !context.docs)
+  };
+}
+__name(resolveFarmAgentConfig, "resolveFarmAgentConfig");
+function resolveFarmAgentBoolean(input, key, fallback) {
+  if (input === void 0) return fallback;
+  if (typeof input !== "boolean") throw new TypeError(`agent.${key} must be a boolean.`);
+  return input;
+}
+__name(resolveFarmAgentBoolean, "resolveFarmAgentBoolean");
+
+// src/docs/framework-detect.ts
+import { readFile } from "fs/promises";
+import { createRequire as createRequire2 } from "module";
+import path2 from "path";
+import { pathToFileURL as pathToFileURL2 } from "url";
+var FRAMEWORK_PACKAGE = "@farming-labs/farmjs";
+var FRAMEWORK_CONFIG_ENTRY = "@farming-labs/farmjs/config";
+var SUPPORTED_ADAPTER_PROTOCOL = 1;
+async function frameworkDeclaredByApp(root) {
+  try {
+    const raw = await readFile(path2.join(root, "package.json"), "utf8");
+    const manifest = JSON.parse(raw);
+    for (const field of ["dependencies", "devDependencies", "peerDependencies"]) {
+      const section = manifest[field];
+      if (section && typeof section === "object" && FRAMEWORK_PACKAGE in section) {
+        return true;
+      }
+    }
+  } catch {
+  }
+  return false;
+}
+__name(frameworkDeclaredByApp, "frameworkDeclaredByApp");
+var emittedNotices = /* @__PURE__ */ new Set();
+function noticeOnce(key, emit, message) {
+  if (emittedNotices.has(key)) return;
+  emittedNotices.add(key);
+  emit(message);
+}
+__name(noticeOnce, "noticeOnce");
+function docsWantsFrameworkDetection(docs) {
+  if (docs === true) return true;
+  if (!docs || typeof docs !== "object") return false;
+  if (docs.enabled === false) return false;
+  if (docs.adapter !== void 0) return false;
+  return true;
+}
+__name(docsWantsFrameworkDetection, "docsWantsFrameworkDetection");
+function isSupportedAdapterDescriptor(value) {
+  if (!value || typeof value !== "object") return false;
+  const descriptor = value;
+  return descriptor.protocol === SUPPORTED_ADAPTER_PROTOCOL && typeof descriptor.server === "string" && descriptor.server.length > 0 && typeof descriptor.react === "string" && descriptor.react.length > 0;
+}
+__name(isSupportedAdapterDescriptor, "isSupportedAdapterDescriptor");
+async function applyFarmDocsFrameworkAutoDetection(userConfig, options) {
+  if (!docsWantsFrameworkDetection(userConfig.docs)) return userConfig;
+  const log = options.log ?? ((message) => console.log(message));
+  const warn = options.warn ?? ((message) => console.warn(message));
+  const root = path2.resolve(options.root || process.cwd());
+  if (!await frameworkDeclaredByApp(root)) {
+    noticeOnce(
+      "embedded-fallback",
+      warn,
+      `[farm] docs is served by the embedded renderer, which is being replaced by the ${FRAMEWORK_PACKAGE} docs framework. Install ${FRAMEWORK_PACKAGE} (with @farming-labs/docs and @farming-labs/theme) to migrate now, or set docs.adapter = false to keep the embedded renderer and silence this notice.`
+    );
+    return userConfig;
+  }
+  let configEntryPath;
+  try {
+    const requireFromApp = createRequire2(path2.join(root, "package.json"));
+    configEntryPath = requireFromApp.resolve(FRAMEWORK_CONFIG_ENTRY);
+  } catch {
+    noticeOnce(
+      "declared-not-installed",
+      warn,
+      `[farm] ${FRAMEWORK_PACKAGE} is declared in package.json but could not be resolved; keeping the embedded docs renderer. Run your package manager's install to enable docs delegation.`
+    );
+    return userConfig;
+  }
+  try {
+    const frameworkConfig = await import(
+      /* @vite-ignore */
+      pathToFileURL2(configEntryPath).href
+    );
+    const withDocs = frameworkConfig?.withDocs;
+    if (typeof withDocs !== "function") {
+      noticeOnce(
+        "missing-withdocs",
+        warn,
+        `[farm] ${FRAMEWORK_CONFIG_ENTRY} does not export withDocs(); keeping the embedded docs renderer.`
+      );
+      return userConfig;
+    }
+    const applied = withDocs(userConfig);
+    const adapter = applied?.docs?.adapter;
+    if (!isSupportedAdapterDescriptor(adapter)) {
+      noticeOnce(
+        "unsupported-descriptor",
+        warn,
+        `[farm] The installed ${FRAMEWORK_PACKAGE} release publishes a docs adapter this Farm version cannot drive (need protocol ${SUPPORTED_ADAPTER_PROTOCOL}); keeping the embedded docs renderer. Upgrading @farm.js/core usually resolves this.`
+      );
+      return userConfig;
+    }
+    noticeOnce(
+      "delegated",
+      log,
+      `[farm] docs: delegated to ${FRAMEWORK_PACKAGE} (detected in this app). Set docs.adapter = false to keep the embedded renderer.`
+    );
+    return applied;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    noticeOnce(
+      "detect-failed",
+      warn,
+      `[farm] Failed to load ${FRAMEWORK_CONFIG_ENTRY} (${message}); keeping the embedded docs renderer.`
+    );
+    return userConfig;
+  }
+}
+__name(applyFarmDocsFrameworkAutoDetection, "applyFarmDocsFrameworkAutoDetection");
+
+// src/config.ts
+var FARM_RESOLVED_CUSTOM_CONTEXT = /* @__PURE__ */ Symbol.for("farm.resolvedCustomContext");
+function resolveSchemaConfig(config) {
+  if (config === void 0) return {};
+  if (!config || typeof config !== "object" || Array.isArray(config)) {
+    throw new TypeError("`schema` in farm.config must be an object.");
+  }
+  for (const key of ["allowExtend", "allowForeignKeys"]) {
+    const entries = config[key];
+    if (entries === void 0) continue;
+    if (!entries || typeof entries !== "object" || Array.isArray(entries)) {
+      throw new TypeError(
+        `\`schema.${key}\` must map a plugin's migrate name to a list of model or table names.`
+      );
+    }
+    for (const [owner, tables] of Object.entries(entries)) {
+      if (!Array.isArray(tables) || tables.some((table) => typeof table !== "string")) {
+        throw new TypeError(
+          `\`schema.${key}.${owner}\` must be a list of model or table names, such as ["user"].`
+        );
+      }
+    }
+  }
+  return config;
+}
+__name(resolveSchemaConfig, "resolveSchemaConfig");
+function hasCustomFarmRouteContext(config) {
+  return config[FARM_RESOLVED_CUSTOM_CONTEXT] === true;
+}
+__name(hasCustomFarmRouteContext, "hasCustomFarmRouteContext");
+function isResolvedFarmConfig(config) {
+  return Object.prototype.hasOwnProperty.call(config, FARM_RESOLVED_CUSTOM_CONTEXT);
+}
+__name(isResolvedFarmConfig, "isResolvedFarmConfig");
+function normalizeDeployTarget(target) {
+  if (!target) return void 0;
+  if (target === "cloudflare-pages" || target === "cloudflare_pages") return "cloudflare";
+  if (target === "node-server" || target === "nitro") return "node";
+  return target;
+}
+__name(normalizeDeployTarget, "normalizeDeployTarget");
+function getPresetForDeployTarget(target) {
+  switch (normalizeDeployTarget(target)) {
+    case "vercel":
+      return "vercel";
+    case "cloudflare":
+      return "cloudflare-pages";
+    case "netlify":
+      return "netlify";
+    case "node":
+      return "node-server";
+    default:
+      return void 0;
+  }
+}
+__name(getPresetForDeployTarget, "getPresetForDeployTarget");
+function getDeployTargetForPreset(preset) {
+  if (!preset) return void 0;
+  if (preset === "vercel" || preset === "vercel-edge") return "vercel";
+  if (preset === "cloudflare" || preset === "cloudflare-pages" || preset === "cloudflare-module") {
+    return "cloudflare";
+  }
+  if (preset === "netlify" || preset === "netlify-edge") return "netlify";
+  if (preset === "node-server") return "node";
+  return void 0;
+}
+__name(getDeployTargetForPreset, "getDeployTargetForPreset");
+var NETLIFY_INTERNAL_FUNCTIONS_DIR = ".netlify/functions-internal";
+function getDefaultDeployOutputDir(target, preset, distDir) {
+  const normalizedTarget = normalizeDeployTarget(target) || getDeployTargetForPreset(preset);
+  if (normalizedTarget === "vercel") return ".vercel/output";
+  if (normalizedTarget === "netlify" && (!preset || preset === "netlify")) {
+    return NETLIFY_INTERNAL_FUNCTIONS_DIR;
+  }
+  return `${distDir}/.output`;
+}
+__name(getDefaultDeployOutputDir, "getDefaultDeployOutputDir");
+function resolveDeployOutputPath(root, outputDir) {
+  return path3.isAbsolute(outputDir) ? outputDir : path3.join(root, outputDir);
+}
+__name(resolveDeployOutputPath, "resolveDeployOutputPath");
+var PLATFORM_BUILD_ENV_TARGETS = [
+  ["VERCEL", "vercel"],
+  ["NETLIFY", "netlify"],
+  ["CF_PAGES", "cloudflare"]
+];
+function detectPlatformDeployTarget(env = process.env) {
+  for (const [key, target] of PLATFORM_BUILD_ENV_TARGETS) {
+    const value = env[key]?.trim().toLowerCase();
+    if (value === "1" || value === "true") return target;
+  }
+  return void 0;
+}
+__name(detectPlatformDeployTarget, "detectPlatformDeployTarget");
+var warnedPlatformMismatches = /* @__PURE__ */ new Set();
+function resolveDeployConfig(config, overrides = {}) {
+  const deploy = config.deploy || {};
+  const distDir = config.distDir || ".farm";
+  const overrideTarget = normalizeDeployTarget(overrides.target);
+  let target = overrideTarget ? overrideTarget : overrides.preset ? getDeployTargetForPreset(overrides.preset) : normalizeDeployTarget(deploy.target);
+  const detectedTarget = detectPlatformDeployTarget(overrides.env);
+  if (detectedTarget) {
+    const hasExplicitSelection = Boolean(
+      target || overrides.preset || deploy.preset || config.preset
+    );
+    if (!hasExplicitSelection) {
+      target = detectedTarget;
+      if (!warnedPlatformMismatches.has(`select:${detectedTarget}`)) {
+        warnedPlatformMismatches.add(`select:${detectedTarget}`);
+        logger.info(
+          `Detected ${detectedTarget} build environment; using the ${detectedTarget} preset. Set deploy.target in farm.config.ts to override.`
+        );
+      }
+    }
+  }
+  const configuredPreset = deploy.preset || config.preset;
+  const overrideTargetPreset = overrideTarget && getDeployTargetForPreset(configuredPreset) !== overrideTarget ? getPresetForDeployTarget(overrideTarget) : void 0;
+  const preset = overrides.preset || overrideTargetPreset || configuredPreset || getPresetForDeployTarget(target) || "node-server";
+  const resolvedTarget = target || getDeployTargetForPreset(preset);
+  if (detectedTarget && resolvedTarget !== detectedTarget) {
+    const mismatchKey = `mismatch:${resolvedTarget}:${detectedTarget}`;
+    if (!warnedPlatformMismatches.has(mismatchKey)) {
+      warnedPlatformMismatches.add(mismatchKey);
+      logger.warn(
+        `The configured deploy target "${resolvedTarget ?? preset}" cannot be served by ${detectedTarget}, but this build is running in a ${detectedTarget} build environment. Set deploy.target: "${detectedTarget}" in farm.config.ts to deploy there.`
+      );
+    }
+  }
+  const platformOutput = resolvedTarget === "vercel" ? deploy.vercel?.outputDirectory : resolvedTarget === "cloudflare" ? deploy.cloudflare?.outputDir : resolvedTarget === "netlify" ? deploy.netlify?.outputDir : void 0;
+  const outputDir = overrides.outputDir || deploy.outputDir || deploy.output || platformOutput || getDefaultDeployOutputDir(resolvedTarget, preset, distDir);
+  return {
+    ...deploy,
+    target: resolvedTarget,
+    preset,
+    outputDir
+  };
+}
+__name(resolveDeployConfig, "resolveDeployConfig");
+function resolveMigrationsConfig(migrations) {
+  if (!migrations) return { commands: [] };
+  if (Array.isArray(migrations)) return { commands: migrations };
+  return { commands: migrations.commands || [] };
+}
+__name(resolveMigrationsConfig, "resolveMigrationsConfig");
+var DOCS_CONFIG_FILENAMES = [
+  "docs.config.ts",
+  "docs.config.tsx",
+  "docs.config.mts",
+  "docs.config.cts",
+  "docs.config.js",
+  "docs.config.jsx",
+  "docs.config.mjs",
+  "docs.config.cjs",
+  "docs.json"
+];
+function normalizeDocsRoute(value, fallback = "/docs") {
+  const raw = (value || fallback).trim();
+  if (!raw || raw === "/") return "/";
+  const normalized = raw.replace(/\\/g, "/").replace(/\/+/g, "/").replace(/^\/?/, "/").replace(/\/+$/, "");
+  return normalized || "/";
+}
+__name(normalizeDocsRoute, "normalizeDocsRoute");
+function docsRouteToEntry(route) {
+  const entry = route.replace(/^\/+/, "").replace(/\/+$/, "");
+  return entry || "docs";
+}
+__name(docsRouteToEntry, "docsRouteToEntry");
+function normalizeDocsContentDir(value) {
+  if (!value) return void 0;
+  const normalized = value.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
+  return normalized || void 0;
+}
+__name(normalizeDocsContentDir, "normalizeDocsContentDir");
+async function inferDocsContentDir(root, srcDir, entry) {
+  const { existsSync } = await import("fs");
+  const contentDir = path3.resolve(root, srcDir, "app", entry);
+  if (!existsSync(contentDir)) return void 0;
+  const relativeContentDir = path3.relative(root, contentDir);
+  if (relativeContentDir.startsWith("..") || path3.isAbsolute(relativeContentDir)) return void 0;
+  return normalizeDocsContentDir(relativeContentDir);
+}
+__name(inferDocsContentDir, "inferDocsContentDir");
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+__name(isRecord, "isRecord");
+function cloneSerializable(value, seen = /* @__PURE__ */ new WeakSet()) {
+  if (value === null) return null;
+  const valueType = typeof value;
+  if (valueType === "string" || valueType === "number" || valueType === "boolean") {
+    return value;
+  }
+  if (valueType === "undefined" || valueType === "function" || valueType === "symbol") {
+    return void 0;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => cloneSerializable(item, seen)).filter((item) => item !== void 0);
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (isRecord(value)) {
+    if (seen.has(value)) return void 0;
+    seen.add(value);
+    const output = {};
+    for (const [key, nestedValue] of Object.entries(value)) {
+      const clonedValue = cloneSerializable(nestedValue, seen);
+      if (clonedValue !== void 0) {
+        output[key] = clonedValue;
+      }
+    }
+    return output;
+  }
+  return void 0;
+}
+__name(cloneSerializable, "cloneSerializable");
+function omitUndefined(value) {
+  return Object.fromEntries(
+    Object.entries(value).filter(([, entry]) => entry !== void 0)
+  );
+}
+__name(omitUndefined, "omitUndefined");
+function sanitizeDocsConfig(config) {
+  return cloneSerializable(config) || {};
+}
+__name(sanitizeDocsConfig, "sanitizeDocsConfig");
+async function findDocsConfigPath(rootDir, configPath) {
+  const { existsSync } = await import("fs");
+  const root = path3.resolve(rootDir || process.cwd());
+  if (configPath) {
+    const resolvedPath = path3.isAbsolute(configPath) ? configPath : path3.join(root, configPath);
+    if (!existsSync(resolvedPath)) {
+      throw new Error(`Could not find docs config at ${configPath}.`);
+    }
+    return path3.resolve(resolvedPath);
+  }
+  for (const filename of DOCS_CONFIG_FILENAMES) {
+    const resolvedPath = path3.join(root, filename);
+    if (existsSync(resolvedPath)) {
+      return resolvedPath;
+    }
+  }
+  return void 0;
+}
+__name(findDocsConfigPath, "findDocsConfigPath");
+async function loadDocsConfig(rootDir, configPath) {
+  const fs = await import("fs/promises");
+  const { pathToFileURL: pathToFileURL3 } = await import("url");
+  const root = path3.resolve(rootDir || process.cwd());
+  const resolvedPath = await findDocsConfigPath(root, configPath);
+  if (!resolvedPath) return void 0;
+  try {
+    if (resolvedPath.endsWith(".json")) {
+      const content = await fs.readFile(resolvedPath, "utf8");
+      return { config: JSON.parse(content), configPath: resolvedPath };
+    }
+    const configCacheDir = path3.join(root, ".farm", ".config-loader");
+    await fs.mkdir(configCacheDir, { recursive: true });
+    const modulePath = path3.join(
+      configCacheDir,
+      `docs-config-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
+    );
+    await bundleNodeModule({
+      root,
+      entry: resolvedPath,
+      outfile: modulePath,
+      target: `node${process.versions.node.split(".")[0]}`,
+      externalPackages: true
+    });
+    const moduleUrl = pathToFileURL3(modulePath).href + `?t=${Date.now()}`;
+    let importedConfig;
+    try {
+      importedConfig = await import(
+        /* @vite-ignore */
+        moduleUrl
+      );
+    } finally {
+      await fs.unlink(modulePath).catch(() => void 0);
+    }
+    return {
+      config: importedConfig.default || importedConfig,
+      configPath: resolvedPath
+    };
+  } catch (error) {
+    const relativePath = path3.relative(root, resolvedPath) || resolvedPath;
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to load docs config from ${relativePath}: ${message}`);
+  }
+}
+__name(loadDocsConfig, "loadDocsConfig");
+async function resolveDocsConfig(userDocs, options = {}) {
+  const root = options.root || process.cwd();
+  if (userDocs === false) {
+    return {
+      enabled: false,
+      entry: "/docs",
+      config: { entry: "docs", docsPath: "/docs" }
+    };
+  }
+  const docsOptions = isRecord(userDocs) ? userDocs : {};
+  if (docsOptions.enabled === false) {
+    return {
+      enabled: false,
+      entry: "/docs",
+      config: { entry: "docs", docsPath: "/docs" }
+    };
+  }
+  const loadedConfig = await loadDocsConfig(root, docsOptions.configPath);
+  const hasExplicitDocsConfig = userDocs === true || isRecord(userDocs);
+  if (!hasExplicitDocsConfig && !loadedConfig) {
+    return {
+      enabled: false,
+      entry: "/docs",
+      config: { entry: "docs", docsPath: "/docs" }
+    };
+  }
+  const inlineDocsConfig = sanitizeDocsConfig(docsOptions.config || {});
+  const directDocsConfig = sanitizeDocsConfig({
+    ...docsOptions,
+    adapter: void 0,
+    enabled: void 0,
+    config: void 0,
+    configPath: void 0
+  });
+  const loadedDocsConfig = sanitizeDocsConfig(loadedConfig?.config || {});
+  const mergedDocsConfig = {
+    ...loadedDocsConfig,
+    ...inlineDocsConfig,
+    ...directDocsConfig
+  };
+  const runtimeDocsConfig = {
+    ...loadedConfig?.config || {},
+    ...isRecord(docsOptions.config) ? docsOptions.config : {},
+    ...omitUndefined({
+      ...docsOptions,
+      adapter: void 0,
+      enabled: void 0,
+      config: void 0,
+      configPath: void 0
+    })
+  };
+  const explicitRoute = typeof docsOptions.entry === "string" ? docsOptions.entry : void 0;
+  const configuredDocsPath = typeof mergedDocsConfig.docsPath === "string" ? mergedDocsConfig.docsPath : void 0;
+  const configuredEntry = typeof mergedDocsConfig.entry === "string" ? mergedDocsConfig.entry : void 0;
+  const entryRoute = normalizeDocsRoute(
+    configuredDocsPath || explicitRoute || (configuredEntry ? `/${configuredEntry}` : void 0)
+  );
+  const docsEntry = explicitRoute && explicitRoute.startsWith("/") ? docsRouteToEntry(explicitRoute) : docsRouteToEntry(configuredEntry || entryRoute);
+  const configuredContentDir = normalizeDocsContentDir(
+    docsOptions.contentDir || mergedDocsConfig.contentDir
+  );
+  const contentDir = configuredContentDir || await inferDocsContentDir(root, options.srcDir || "src", docsEntry);
+  return {
+    enabled: true,
+    entry: entryRoute,
+    ...docsOptions.adapter ? { adapter: docsOptions.adapter } : {},
+    contentDir,
+    configPath: loadedConfig?.configPath,
+    config: {
+      ...mergedDocsConfig,
+      entry: docsEntry,
+      docsPath: entryRoute,
+      ...contentDir ? { contentDir } : {}
+    },
+    runtimeConfig: {
+      ...runtimeDocsConfig,
+      entry: docsEntry,
+      docsPath: entryRoute,
+      ...contentDir ? { contentDir } : {}
+    },
+    configOverrides: { ...inlineDocsConfig, ...directDocsConfig }
+  };
+}
+__name(resolveDocsConfig, "resolveDocsConfig");
+function validateRedirectConfigs(redirects, field) {
+  for (const [index, redirect] of redirects.entries()) {
+    validateConfigRouteSource(redirect.source, `${field}[${index}].source`);
+    if (redirect.statusCode !== void 0 && !isFarmRedirectStatus(redirect.statusCode)) {
+      throw new RangeError(
+        `${field}[${index}].statusCode must be one of 301, 302, 303, 307, or 308.`
+      );
+    }
+  }
+  return redirects;
+}
+__name(validateRedirectConfigs, "validateRedirectConfigs");
+function validateConfigRouteSources(routes, field) {
+  for (const [index, route] of routes.entries()) {
+    validateConfigRouteSource(route.source, `${field}[${index}].source`);
+  }
+  return routes;
+}
+__name(validateConfigRouteSources, "validateConfigRouteSources");
+async function resolveConfig(userConfig, mode) {
+  const projectRoot = userConfig.root || process.cwd();
+  const layerResolution = await resolveFarmLayers(userConfig, {
+    root: projectRoot,
+    mode
+  });
+  userConfig = layerResolution.config;
+  if (userConfig.typescript !== void 0) {
+    logger.warn(
+      'The top-level "typescript" option is not supported and has no effect. Configure TypeScript in `tsconfig.json` and run `tsc --noEmit` separately when builds must enforce project type errors.'
+    );
+  }
+  if (userConfig.output !== void 0) {
+    logger.warn(
+      'The top-level "output" option is not supported and has no effect. Configure `deploy.target`, `deploy.preset`, or `deploy.outputDir` for deployment output, and use route rendering configuration for static pages.'
+    );
+  }
+  if (isReactRenderer(resolveFarmRenderer(userConfig.renderer))) {
+    userConfig = await applyFarmDocsFrameworkAutoDetection(userConfig, {
+      root: userConfig.root || projectRoot
+    });
+  }
+  const redirects = validateRedirectConfigs(
+    typeof userConfig.redirects === "function" ? await userConfig.redirects() : userConfig.redirects || [],
+    "redirects"
+  );
+  const rewrites = typeof userConfig.rewrites === "function" ? await userConfig.rewrites() : userConfig.rewrites || [];
+  validateConfigRouteSources(rewrites, "rewrites");
+  const headers = typeof userConfig.headers === "function" ? await userConfig.headers() : userConfig.headers || [];
+  validateConfigRouteSources(headers, "headers");
+  const routeRules = normalizeRouteRules(userConfig.routeRules);
+  const routeRuleRedirects = routeRulesToRedirects(routeRules);
+  const routeRuleHeaders = routeRulesToHeaders(routeRules);
+  const security = resolveFarmSecurityConfig(userConfig.security);
+  const securityHeader = getFarmSecurityHeader(security);
+  if (farmCspBlocksFrameworkInlineScripts(security)) {
+    logger.warn(
+      "security.csp blocks the inline scripts Farm injects for theming and hydration. Set security.csp.nonce to true for managed dynamic nonces and prerendered hashes, or make the governing script directive allow 'unsafe-inline' without a nonce, hash, or 'strict-dynamic' source."
+    );
+  }
+  const deploy = resolveDeployConfig(userConfig);
+  const root = userConfig.root || process.cwd();
+  const srcDir = userConfig.srcDir || "src";
+  setFarmProjectSourceDir(root, srcDir);
+  const docs = await resolveDocsConfig(userConfig.docs, { root, srcDir });
+  const md = resolveMarkdownConfig(userConfig.md);
+  const mdx = resolveMdxConfig(userConfig.mdx);
+  const env = resolveEnv(userConfig.env, process.env);
+  setEnv(env);
+  const api = await resolveFarmAPIConfig(userConfig.api, { root, mode, env });
+  const auth = resolveFarmAuthConfig(userConfig.auth);
+  const mcp = resolveFarmMCPConfig(userConfig.mcp);
+  if (auth.enabled && userConfig.integrations?.auth) {
+    throw new Error(
+      "Choose either the top-level `auth` config or `integrations.auth`; they cannot both own the auth route."
+    );
+  }
+  const nativeAuthIntegration = await resolveFarmAuthIntegration(auth, {
+    root,
+    mode
+  });
+  const nativeMCPPlugin = await resolveFarmMCPPlugin(mcp, { root });
+  if (nativeMCPPlugin && userConfig.plugins?.some((plugin) => plugin?.name === "farm:api-mcp")) {
+    throw new Error(
+      "Choose either the top-level `mcp` config or `apiMcp()` in `plugins`; they configure the same MCP transport."
+    );
+  }
+  const integrations = nativeAuthIntegration ? { ...userConfig.integrations, auth: nativeAuthIntegration } : userConfig.integrations || {};
+  const generateBuildId = userConfig.generateBuildId || (() => `build-${Date.now()}`);
+  const deploymentId = normalizeFarmDeploymentId(
+    userConfig.deploymentId || process.env.FARM_DEPLOYMENT_ID || process.env.VERCEL_GIT_COMMIT_SHA || process.env.CF_PAGES_COMMIT_SHA || (mode === "production" ? await generateBuildId() : "development")
+  );
+  const basePath = normalizeFarmConfigBasePath(userConfig.basePath);
+  const openapi = {
+    enabled: false,
+    route: "/docs/reference",
+    specRoute: "/openapi.json",
+    title: "API Documentation",
+    description: "Auto-generated API documentation",
+    version: "1.0.0",
+    ...userConfig.openapi
+  };
+  if (openapi.route !== void 0) validateConfigRouteSource(openapi.route, "openapi.route");
+  if (openapi.specRoute) validateConfigRouteSource(openapi.specRoute, "openapi.specRoute");
+  const resolved = {
+    [FARM_RESOLVED_CUSTOM_CONTEXT]: typeof userConfig.context === "function",
+    root,
+    srcDir,
+    extends: userConfig.extends || [],
+    layers: layerResolution.layers,
+    outDir: userConfig.outDir || "dist",
+    basePath,
+    renderer: resolveFarmRenderer(userConfig.renderer),
+    preset: deploy.preset || "node-server",
+    deploy,
+    docs,
+    md,
+    mdx,
+    migrations: resolveMigrationsConfig(userConfig.migrations),
+    cron: resolveCronConfig(userConfig.cron),
+    workflows: resolveWorkflowsConfig(userConfig.workflows),
+    api,
+    observability: userConfig.observability ?? false,
+    telemetry: userConfig.telemetry !== false,
+    analytics: userConfig.analytics !== false,
+    devtools: resolveFarmDevtoolsConfig(userConfig.devtools, mode),
+    storage: userConfig.storage || {},
+    schema: resolveSchemaConfig(userConfig.schema),
+    cache: userConfig.cache || {},
+    auth,
+    mcp,
+    suppressLintOnLink: userConfig.suppressLintOnLink ?? false,
+    experimental: {
+      serverComponents: false,
+      serverActions: false,
+      isolatedClientHydration: "off",
+      ppr: false,
+      ...userConfig.experimental
+    },
+    agent: resolveFarmAgentConfig(userConfig.agent, { docs: docs.enabled }),
+    plugins: [
+      ...resolveIntegrationPlugins(integrations),
+      ...nativeMCPPlugin ? [nativeMCPPlugin] : [],
+      ...userConfig.plugins || []
+    ],
+    integrations,
+    trailingSlash: userConfig.trailingSlash ?? false,
+    redirects: /* @__PURE__ */ __name(() => [...redirects, ...routeRuleRedirects], "redirects"),
+    rewrites: /* @__PURE__ */ __name(() => rewrites, "rewrites"),
+    headers: /* @__PURE__ */ __name(() => [
+      ...headers,
+      ...routeRuleHeaders,
+      ...securityHeader ? [{ source: "/*", headers: [securityHeader] }] : []
+    ], "headers"),
+    routeRules,
+    images: resolveFarmImageConfig(userConfig.images),
+    performance: resolveFarmPerformanceConfig(userConfig.performance),
+    theme: resolveFarmThemeConfig(userConfig.theme, basePath),
+    publicDir: userConfig.publicDir || "public",
+    i18n: resolveFarmI18nConfig(userConfig.i18n, { root, mode, basePath }),
+    openapi,
+    middleware: userConfig.middleware || {},
+    notFound: userConfig.notFound || {},
+    context: userConfig.context || (() => void 0),
+    server: resolveFarmServerConfig(userConfig.server),
+    serverActions: resolveServerActionsConfig(userConfig.serverActions),
+    security,
+    deploymentId,
+    distDir: userConfig.distDir || ".farm",
+    generateBuildId,
+    compress: userConfig.compress ?? true,
+    devIndicators: resolveFarmDevIndicatorsConfig(userConfig.devIndicators, mode),
+    serverRuntimeConfig: userConfig.serverRuntimeConfig || {},
+    publicRuntimeConfig: userConfig.publicRuntimeConfig || {},
+    env,
+    vite: typeof userConfig.vite === "function" ? userConfig.vite({}) : userConfig.vite || {}
+  };
+  assertPluginDependencies(resolved.plugins, resolved.integrations);
+  return resolved;
+}
+__name(resolveConfig, "resolveConfig");
+function formatConfigLoadError(error) {
+  if (error && (typeof error === "object" || typeof error === "function")) {
+    for (const property of ["message", "stack", "name"]) {
+      try {
+        const value = Reflect.get(error, property);
+        if (typeof value === "string" && value) return value;
+      } catch {
+      }
+    }
+  }
+  try {
+    return String(error);
+  } catch {
+    return "Unknown config loader error";
+  }
+}
+__name(formatConfigLoadError, "formatConfigLoadError");
+async function loadConfig(rootDir, configPath, mode = process.env.NODE_ENV === "production" ? "production" : "development", loadEnvironment) {
+  const { existsSync } = await import("fs");
+  const loadEnv = loadEnvironment || (await import("vite")).loadEnv;
+  const root = rootDir || process.cwd();
+  const loadedEnv = loadEnv(mode, root, "");
+  for (const [key, value] of Object.entries(loadedEnv)) {
+    if (process.env[key] === void 0) {
+      process.env[key] = value;
+    }
+  }
+  if (configPath) {
+    const explicitPath = path3.resolve(
+      path3.isAbsolute(configPath) ? configPath : path3.join(root, configPath)
+    );
+    if (!existsSync(explicitPath)) {
+      throw new Error(`Config file not found at ${configPath} (resolved to ${explicitPath}).`);
+    }
+  }
+  const searchPaths = [
+    configPath,
+    "farm.config.ts",
+    "farm.config.mts",
+    "farm.config.js",
+    "farm.config.mjs",
+    "config.ts",
+    "config.mts",
+    "config.js",
+    "config.mjs"
+  ].filter(Boolean);
+  for (const relativePath of searchPaths) {
+    try {
+      const absolutePath = path3.isAbsolute(relativePath) ? relativePath : path3.join(root, relativePath);
+      const normalizedPath = path3.resolve(absolutePath);
+      if (!existsSync(normalizedPath)) {
+        continue;
+      }
+      const loadedConfig = await loadFarmConfigFile(normalizedPath, { root });
+      return loadedConfig.root === void 0 ? { ...loadedConfig, root } : loadedConfig;
+    } catch (error) {
+      const configError = new Error(
+        `Failed to load config from ${relativePath}: ${formatConfigLoadError(error)}`
+      );
+      configError.cause = error;
+      throw configError;
+    }
+  }
+  return void 0;
+}
+__name(loadConfig, "loadConfig");
+
+export {
+  resolveFarmMCPConfig,
+  resolveFarmMCPPlugin,
+  hasCustomFarmRouteContext,
+  isResolvedFarmConfig,
+  normalizeDeployTarget,
+  getPresetForDeployTarget,
+  getDeployTargetForPreset,
+  getDefaultDeployOutputDir,
+  resolveDeployOutputPath,
+  resolveDeployConfig,
+  resolveMigrationsConfig,
+  resolveDocsConfig,
+  resolveConfig,
+  loadConfig
+};