@farm.js/core 0.1.47 → 0.1.49

package/dist/chunk-KZT2VHRQ.cjs

@@ -0,0 +1,894 @@
+"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; }
+
+
+
+
+
+var _chunkBPNOYILCcjs = require('./chunk-BPNOYILC.cjs');
+
+
+
+
+var _chunkV56632LAcjs = require('./chunk-V56632LA.cjs');
+
+
+var _chunkLSHX2H5Gcjs = require('./chunk-LSHX2H5G.cjs');
+
+
+var _chunkSTF6VDYQcjs = require('./chunk-STF6VDYQ.cjs');
+
+
+
+var _chunkRD623KW4cjs = require('./chunk-RD623KW4.cjs');
+
+
+
+
+
+var _chunkNYQSC4DXcjs = require('./chunk-NYQSC4DX.cjs');
+
+
+var _chunkSG57PX7Kcjs = require('./chunk-SG57PX7K.cjs');
+
+
+var _chunkHIFIG6HLcjs = require('./chunk-HIFIG6HL.cjs');
+
+
+
+
+var _chunk6JHZPB52cjs = require('./chunk-6JHZPB52.cjs');
+
+
+var _chunkHEPJIKKQcjs = require('./chunk-HEPJIKKQ.cjs');
+
+
+
+var _chunk3EIPOTZVcjs = require('./chunk-3EIPOTZV.cjs');
+
+
+
+var _chunk5Y2P454Ocjs = require('./chunk-5Y2P454O.cjs');
+
+
+var _chunkDQJ2CIH7cjs = require('./chunk-DQJ2CIH7.cjs');
+
+
+var _chunkSSNN55Q6cjs = require('./chunk-SSNN55Q6.cjs');
+
+
+var _chunkC7425KDGcjs = require('./chunk-C7425KDG.cjs');
+
+
+var _chunkFGJQS4ECcjs = require('./chunk-FGJQS4EC.cjs');
+
+
+var _chunkWT6RAN2Icjs = require('./chunk-WT6RAN2I.cjs');
+
+
+var _chunk2HW5LWAHcjs = require('./chunk-2HW5LWAH.cjs');
+
+
+var _chunkWJFFPXCVcjs = require('./chunk-WJFFPXCV.cjs');
+
+
+var _chunkN25RPPO5cjs = require('./chunk-N25RPPO5.cjs');
+
+
+var _chunk5DX3O6TTcjs = require('./chunk-5DX3O6TT.cjs');
+
+
+var _chunkLNVGXUL3cjs = require('./chunk-LNVGXUL3.cjs');
+
+
+var _chunkXN2MB4QZcjs = require('./chunk-XN2MB4QZ.cjs');
+
+
+var _chunk5566GNEGcjs = require('./chunk-5566GNEG.cjs');
+
+
+var _chunkIWFV5ZEDcjs = require('./chunk-IWFV5ZED.cjs');
+
+
+var _chunkE552H232cjs = require('./chunk-E552H232.cjs');
+
+
+var _chunk6XQSPIN6cjs = require('./chunk-6XQSPIN6.cjs');
+
+
+var _chunk7JUIK547cjs = require('./chunk-7JUIK547.cjs');
+
+
+var _chunkD22BUQKWcjs = require('./chunk-D22BUQKW.cjs');
+
+// src/mcp-config.ts
+var _module = require('module');
+var _path = require('path'); var _path2 = _interopRequireDefault(_path);
+var _url = require('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 };
+}
+async function resolveFarmMCPPlugin(config, options) {
+  if (!config.enabled) return void 0;
+  const root = _path2.default.resolve(options.root);
+  let modulePath;
+  try {
+    const resolveFromApp = _module.createRequire.call(void 0, _path2.default.join(root, "package.json"));
+    modulePath = resolveFromApp.resolve("@farm.js/mcp/internal");
+  } catch (e) {
+    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 */
+    _url.pathToFileURL.call(void 0, 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);
+}
+
+// src/config.ts
+
+
+// src/agent-config.ts
+var DEFAULT_JSON_LD = { type: "WebSite" };
+function resolveFarmAgentConfig(input, context = {}) {
+  const jsonLd = _optionalChain([input, 'optionalAccess', _ => _.jsonLd]);
+  return {
+    jsonLd: jsonLd === void 0 ? { ...DEFAULT_JSON_LD } : !jsonLd ? false : jsonLd === true ? {} : jsonLd,
+    noindexPreviews: _chunkNYQSC4DXcjs.resolveFarmNoindexPreviews.call(void 0, _optionalChain([input, 'optionalAccess', _2 => _2.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: _chunkHIFIG6HLcjs.resolveFarmLlmsTxtConfig.call(void 0, _nullishCoalesce(_optionalChain([input, 'optionalAccess', _3 => _3.llmsTxt]), () => ( (context.docs ? false : { full: false })))),
+    // Same rule as llms.txt: the docs engine answers /sitemap.xml with its own pages.
+    sitemap: _chunkNYQSC4DXcjs.resolveFarmAgentSitemap.call(void 0, _nullishCoalesce(_optionalChain([input, 'optionalAccess', _4 => _4.sitemap]), () => ( !context.docs))),
+    crawlers: _chunkNYQSC4DXcjs.resolveFarmAgentCrawlers.call(void 0, _optionalChain([input, 'optionalAccess', _5 => _5.crawlers])),
+    apiCatalog: resolveFarmAgentBoolean(_optionalChain([input, 'optionalAccess', _6 => _6.apiCatalog]), "apiCatalog", false),
+    aiCatalog: resolveFarmAgentBoolean(_optionalChain([input, 'optionalAccess', _7 => _7.aiCatalog]), "aiCatalog", true),
+    manifest: _chunkSG57PX7Kcjs.resolveFarmAppManifestConfig.call(void 0, _optionalChain([input, 'optionalAccess', _8 => _8.manifest])),
+    // Same rule as llms.txt: the docs engine serves its own MCP server at /mcp.
+    mcp: resolveFarmAgentBoolean(_optionalChain([input, 'optionalAccess', _9 => _9.mcp]), "mcp", !context.docs)
+  };
+}
+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;
+}
+
+// src/docs/framework-detect.ts
+var _promises = require('fs/promises');
+
+
+
+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 _promises.readFile.call(void 0, _path2.default.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 (e2) {
+  }
+  return false;
+}
+var emittedNotices = /* @__PURE__ */ new Set();
+function noticeOnce(key, emit, message) {
+  if (emittedNotices.has(key)) return;
+  emittedNotices.add(key);
+  emit(message);
+}
+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;
+}
+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;
+}
+async function applyFarmDocsFrameworkAutoDetection(userConfig, options) {
+  if (!docsWantsFrameworkDetection(userConfig.docs)) return userConfig;
+  const log = _nullishCoalesce(options.log, () => ( ((message) => console.log(message))));
+  const warn = _nullishCoalesce(options.warn, () => ( ((message) => console.warn(message))));
+  const root = _path2.default.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 = _module.createRequire.call(void 0, _path2.default.join(root, "package.json"));
+    configEntryPath = requireFromApp.resolve(FRAMEWORK_CONFIG_ENTRY);
+  } catch (e3) {
+    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 */
+      _url.pathToFileURL.call(void 0, configEntryPath).href
+    );
+    const withDocs = _optionalChain([frameworkConfig, 'optionalAccess', _10 => _10.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 = _optionalChain([applied, 'optionalAccess', _11 => _11.docs, 'optionalAccess', _12 => _12.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;
+  }
+}
+
+// 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;
+}
+function hasCustomFarmRouteContext(config) {
+  return config[FARM_RESOLVED_CUSTOM_CONTEXT] === true;
+}
+function isResolvedFarmConfig(config) {
+  return Object.prototype.hasOwnProperty.call(config, FARM_RESOLVED_CUSTOM_CONTEXT);
+}
+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;
+}
+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;
+  }
+}
+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;
+}
+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`;
+}
+function resolveDeployOutputPath(root, outputDir) {
+  return _path2.default.isAbsolute(outputDir) ? outputDir : _path2.default.join(root, outputDir);
+}
+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 = _optionalChain([env, 'access', _13 => _13[key], 'optionalAccess', _14 => _14.trim, 'call', _15 => _15(), 'access', _16 => _16.toLowerCase, 'call', _17 => _17()]);
+    if (value === "1" || value === "true") return target;
+  }
+  return void 0;
+}
+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}`);
+        _chunkXN2MB4QZcjs.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);
+      _chunkXN2MB4QZcjs.logger.warn(
+        `The configured deploy target "${_nullishCoalesce(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" ? _optionalChain([deploy, 'access', _18 => _18.vercel, 'optionalAccess', _19 => _19.outputDirectory]) : resolvedTarget === "cloudflare" ? _optionalChain([deploy, 'access', _20 => _20.cloudflare, 'optionalAccess', _21 => _21.outputDir]) : resolvedTarget === "netlify" ? _optionalChain([deploy, 'access', _22 => _22.netlify, 'optionalAccess', _23 => _23.outputDir]) : void 0;
+  const outputDir = overrides.outputDir || deploy.outputDir || deploy.output || platformOutput || getDefaultDeployOutputDir(resolvedTarget, preset, distDir);
+  return {
+    ...deploy,
+    target: resolvedTarget,
+    preset,
+    outputDir
+  };
+}
+function resolveMigrationsConfig(migrations) {
+  if (!migrations) return { commands: [] };
+  if (Array.isArray(migrations)) return { commands: migrations };
+  return { commands: migrations.commands || [] };
+}
+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 || "/";
+}
+function docsRouteToEntry(route) {
+  const entry = route.replace(/^\/+/, "").replace(/\/+$/, "");
+  return entry || "docs";
+}
+function normalizeDocsContentDir(value) {
+  if (!value) return void 0;
+  const normalized = value.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
+  return normalized || void 0;
+}
+async function inferDocsContentDir(root, srcDir, entry) {
+  const { existsSync } = await import("fs");
+  const contentDir = _path2.default.resolve(root, srcDir, "app", entry);
+  if (!existsSync(contentDir)) return void 0;
+  const relativeContentDir = _path2.default.relative(root, contentDir);
+  if (relativeContentDir.startsWith("..") || _path2.default.isAbsolute(relativeContentDir)) return void 0;
+  return normalizeDocsContentDir(relativeContentDir);
+}
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+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;
+}
+function omitUndefined(value) {
+  return Object.fromEntries(
+    Object.entries(value).filter(([, entry]) => entry !== void 0)
+  );
+}
+function sanitizeDocsConfig(config) {
+  return cloneSerializable(config) || {};
+}
+async function findDocsConfigPath(rootDir, configPath) {
+  const { existsSync } = await import("fs");
+  const root = _path2.default.resolve(rootDir || process.cwd());
+  if (configPath) {
+    const resolvedPath = _path2.default.isAbsolute(configPath) ? configPath : _path2.default.join(root, configPath);
+    if (!existsSync(resolvedPath)) {
+      throw new Error(`Could not find docs config at ${configPath}.`);
+    }
+    return _path2.default.resolve(resolvedPath);
+  }
+  for (const filename of DOCS_CONFIG_FILENAMES) {
+    const resolvedPath = _path2.default.join(root, filename);
+    if (existsSync(resolvedPath)) {
+      return resolvedPath;
+    }
+  }
+  return void 0;
+}
+async function loadDocsConfig(rootDir, configPath) {
+  const fs = await import("fs/promises");
+  const { pathToFileURL: pathToFileURL3 } = await import("url");
+  const root = _path2.default.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 = _path2.default.join(root, ".farm", ".config-loader");
+    await fs.mkdir(configCacheDir, { recursive: true });
+    const modulePath = _path2.default.join(
+      configCacheDir,
+      `docs-config-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
+    );
+    await _chunkDQJ2CIH7cjs.bundleNodeModule.call(void 0, {
+      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 = _path2.default.relative(root, resolvedPath) || resolvedPath;
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to load docs config from ${relativePath}: ${message}`);
+  }
+}
+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(_optionalChain([loadedConfig, 'optionalAccess', _24 => _24.config]) || {});
+  const mergedDocsConfig = {
+    ...loadedDocsConfig,
+    ...inlineDocsConfig,
+    ...directDocsConfig
+  };
+  const runtimeDocsConfig = {
+    ..._optionalChain([loadedConfig, 'optionalAccess', _25 => _25.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: _optionalChain([loadedConfig, 'optionalAccess', _26 => _26.configPath]),
+    config: {
+      ...mergedDocsConfig,
+      entry: docsEntry,
+      docsPath: entryRoute,
+      ...contentDir ? { contentDir } : {}
+    },
+    runtimeConfig: {
+      ...runtimeDocsConfig,
+      entry: docsEntry,
+      docsPath: entryRoute,
+      ...contentDir ? { contentDir } : {}
+    },
+    configOverrides: { ...inlineDocsConfig, ...directDocsConfig }
+  };
+}
+function validateRedirectConfigs(redirects, field) {
+  for (const [index, redirect] of redirects.entries()) {
+    _chunk6XQSPIN6cjs.validateConfigRouteSource.call(void 0, redirect.source, `${field}[${index}].source`);
+    if (redirect.statusCode !== void 0 && !_chunk7JUIK547cjs.isFarmRedirectStatus.call(void 0, redirect.statusCode)) {
+      throw new RangeError(
+        `${field}[${index}].statusCode must be one of 301, 302, 303, 307, or 308.`
+      );
+    }
+  }
+  return redirects;
+}
+function validateMiddlewareConfig(middleware) {
+  for (const entry of Array.isArray(middleware) ? middleware : middleware ? [middleware] : []) {
+    _chunk5DX3O6TTcjs.compileMiddlewareConfig.call(void 0, { matcher: entry.matcher, exclude: entry.exclude });
+  }
+  return middleware;
+}
+function validateConfigRouteSources(routes, field) {
+  for (const [index, route] of routes.entries()) {
+    _chunk6XQSPIN6cjs.validateConfigRouteSource.call(void 0, route.source, `${field}[${index}].source`);
+  }
+  return routes;
+}
+async function resolveConfig(userConfig, mode) {
+  _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([userConfig, 'access', _27 => _27.experimental, 'optionalAccess', _28 => _28.serverComponents]));
+  const projectRoot = userConfig.root || process.cwd();
+  const layerResolution = await _chunk5Y2P454Ocjs.resolveFarmLayers.call(void 0, userConfig, {
+    root: projectRoot,
+    mode
+  });
+  userConfig = layerResolution.config;
+  if (userConfig.typescript !== void 0) {
+    _chunkXN2MB4QZcjs.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) {
+    _chunkXN2MB4QZcjs.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 (_chunkRD623KW4cjs.isReactRenderer.call(void 0, _chunkRD623KW4cjs.resolveFarmRenderer.call(void 0, 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 = _chunkV56632LAcjs.normalizeRouteRules.call(void 0, userConfig.routeRules);
+  const routeRuleRedirects = _chunkV56632LAcjs.routeRulesToRedirects.call(void 0, routeRules);
+  const routeRuleHeaders = _chunkV56632LAcjs.routeRulesToHeaders.call(void 0, routeRules);
+  const security = _chunk6JHZPB52cjs.resolveFarmSecurityConfig.call(void 0, userConfig.security);
+  const securityHeader = _chunk6JHZPB52cjs.getFarmSecurityHeader.call(void 0, security);
+  if (_chunk6JHZPB52cjs.farmCspBlocksFrameworkInlineScripts.call(void 0, security)) {
+    _chunkXN2MB4QZcjs.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 root = userConfig.root || process.cwd();
+  const desktopSetup = await _optionalChain([globalThis, 'access', _29 => _29[/* @__PURE__ */ Symbol.for("@farm.js/core/desktop-setup")], 'optionalCall', _30 => _30(userConfig, root, mode)]);
+  if (desktopSetup) userConfig = desktopSetup.userConfig;
+  const deploy = resolveDeployConfig(userConfig, _optionalChain([desktopSetup, 'optionalAccess', _31 => _31.deploy]));
+  const srcDir = userConfig.srcDir || "src";
+  _chunkBPNOYILCcjs.setFarmProjectSourceDir.call(void 0, root, srcDir);
+  const docs = await resolveDocsConfig(userConfig.docs, { root, srcDir });
+  const md = _chunkWJFFPXCVcjs.resolveMarkdownConfig.call(void 0, userConfig.md);
+  const mdx = _chunk2HW5LWAHcjs.resolveMdxConfig.call(void 0, userConfig.mdx);
+  const env = _chunk3EIPOTZVcjs.resolveEnv.call(void 0, userConfig.env, process.env);
+  _chunk3EIPOTZVcjs.setEnv.call(void 0, env);
+  const api = await _chunkIWFV5ZEDcjs.resolveFarmAPIConfig.call(void 0, userConfig.api, { root, mode, env });
+  const auth = _chunkBPNOYILCcjs.resolveFarmAuthConfig.call(void 0, userConfig.auth);
+  const mcp = resolveFarmMCPConfig(userConfig.mcp);
+  if (auth.enabled && _optionalChain([userConfig, 'access', _32 => _32.integrations, 'optionalAccess', _33 => _33.auth])) {
+    throw new Error(
+      "Choose either the top-level `auth` config or `integrations.auth`; they cannot both own the auth route."
+    );
+  }
+  const nativeAuthIntegration = await _chunkBPNOYILCcjs.resolveFarmAuthIntegration.call(void 0, auth, {
+    root,
+    mode
+  });
+  const nativeMCPPlugin = await resolveFarmMCPPlugin(mcp, { root });
+  if (nativeMCPPlugin && _optionalChain([userConfig, 'access', _34 => _34.plugins, 'optionalAccess', _35 => _35.some, 'call', _36 => _36((plugin) => _optionalChain([plugin, 'optionalAccess', _37 => _37.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 = _chunkE552H232cjs.normalizeFarmDeploymentId.call(void 0, 
+    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 = _chunkD22BUQKWcjs.normalizeFarmConfigBasePath.call(void 0, 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) _chunk6XQSPIN6cjs.validateConfigRouteSource.call(void 0, openapi.route, "openapi.route");
+  if (openapi.specRoute) _chunk6XQSPIN6cjs.validateConfigRouteSource.call(void 0, 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: _chunkRD623KW4cjs.resolveFarmRenderer.call(void 0, userConfig.renderer),
+    preset: deploy.preset || "node-server",
+    deploy,
+    docs,
+    md,
+    mdx,
+    migrations: resolveMigrationsConfig(userConfig.migrations),
+    cron: _chunkC7425KDGcjs.resolveCronConfig.call(void 0, userConfig.cron),
+    workflows: _chunkSSNN55Q6cjs.resolveWorkflowsConfig.call(void 0, userConfig.workflows),
+    api,
+    observability: _nullishCoalesce(userConfig.observability, () => ( false)),
+    telemetry: userConfig.telemetry !== false,
+    analytics: userConfig.analytics !== false,
+    devtools: _chunkSTF6VDYQcjs.resolveFarmDevtoolsConfig.call(void 0, userConfig.devtools, mode),
+    storage: userConfig.storage || {},
+    schema: resolveSchemaConfig(userConfig.schema),
+    cache: userConfig.cache || {},
+    auth,
+    mcp,
+    suppressLintOnLink: _nullishCoalesce(userConfig.suppressLintOnLink, () => ( false)),
+    experimental: {
+      serverComponents: false,
+      serverActions: false,
+      // Islands mode hydrates client components as islands (RFC 0003); an app can still pick
+      // isolatedClientHydration itself.
+      isolatedClientHydration: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([userConfig, 'access', _38 => _38.experimental, 'optionalAccess', _39 => _39.serverComponents])) === "islands" ? "enabled" : "off",
+      ppr: false,
+      ...userConfig.experimental
+    },
+    agent: resolveFarmAgentConfig(userConfig.agent, { docs: docs.enabled }),
+    desktop: _nullishCoalesce(_optionalChain([desktopSetup, 'optionalAccess', _40 => _40.desktop]), () => ( null)),
+    plugins: [
+      ..._chunkN25RPPO5cjs.resolveIntegrationPlugins.call(void 0, integrations),
+      ...nativeMCPPlugin ? [nativeMCPPlugin] : [],
+      ...userConfig.plugins || []
+    ],
+    integrations,
+    trailingSlash: _nullishCoalesce(userConfig.trailingSlash, () => ( false)),
+    redirects: () => [...redirects, ...routeRuleRedirects],
+    rewrites: () => rewrites,
+    headers: () => [
+      ...headers,
+      ...routeRuleHeaders,
+      ...securityHeader ? [{ source: "/*", headers: [securityHeader] }] : []
+    ],
+    routeRules,
+    images: _chunkHEPJIKKQcjs.resolveFarmImageConfig.call(void 0, userConfig.images),
+    performance: _chunkNYQSC4DXcjs.resolveFarmPerformanceConfig.call(void 0, userConfig.performance),
+    theme: _chunkWT6RAN2Icjs.resolveFarmThemeConfig.call(void 0, userConfig.theme, basePath),
+    publicDir: userConfig.publicDir || "public",
+    i18n: _chunkLNVGXUL3cjs.resolveFarmI18nConfig.call(void 0, userConfig.i18n, { root, mode, basePath }),
+    openapi,
+    middleware: validateMiddlewareConfig(userConfig.middleware) || {},
+    notFound: userConfig.notFound || {},
+    context: userConfig.context || (() => void 0),
+    server: _chunk5566GNEGcjs.resolveFarmServerConfig.call(void 0, userConfig.server),
+    serverActions: _chunkFGJQS4ECcjs.resolveServerActionsConfig.call(void 0, userConfig.serverActions),
+    security,
+    deploymentId,
+    distDir: userConfig.distDir || ".farm",
+    generateBuildId,
+    compress: _nullishCoalesce(userConfig.compress, () => ( true)),
+    devIndicators: _chunkBPNOYILCcjs.resolveFarmDevIndicatorsConfig.call(void 0, userConfig.devIndicators, mode),
+    serverRuntimeConfig: userConfig.serverRuntimeConfig || {},
+    publicRuntimeConfig: userConfig.publicRuntimeConfig || {},
+    env,
+    vite: typeof userConfig.vite === "function" ? userConfig.vite({}) : userConfig.vite || {}
+  };
+  _chunkLSHX2H5Gcjs.assertPluginDependencies.call(void 0, resolved.plugins, resolved.integrations);
+  return resolved;
+}
+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 (e4) {
+      }
+    }
+  }
+  try {
+    return String(error);
+  } catch (e5) {
+    return "Unknown config loader error";
+  }
+}
+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 = _path2.default.resolve(
+      _path2.default.isAbsolute(configPath) ? configPath : _path2.default.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 = _path2.default.isAbsolute(relativePath) ? relativePath : _path2.default.join(root, relativePath);
+      const normalizedPath = _path2.default.resolve(absolutePath);
+      if (!existsSync(normalizedPath)) {
+        continue;
+      }
+      const loadedConfig = await _chunk5Y2P454Ocjs.loadFarmConfigFile.call(void 0, 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;
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.resolveFarmMCPConfig = resolveFarmMCPConfig; exports.resolveFarmMCPPlugin = resolveFarmMCPPlugin; exports.hasCustomFarmRouteContext = hasCustomFarmRouteContext; exports.isResolvedFarmConfig = isResolvedFarmConfig; exports.normalizeDeployTarget = normalizeDeployTarget; exports.getPresetForDeployTarget = getPresetForDeployTarget; exports.getDeployTargetForPreset = getDeployTargetForPreset; exports.getDefaultDeployOutputDir = getDefaultDeployOutputDir; exports.resolveDeployOutputPath = resolveDeployOutputPath; exports.resolveDeployConfig = resolveDeployConfig; exports.resolveMigrationsConfig = resolveMigrationsConfig; exports.resolveDocsConfig = resolveDocsConfig; exports.resolveConfig = resolveConfig; exports.loadConfig = loadConfig;