@farm.js/core 0.1.51-beta.3 → 0.1.61

package/dist/chunk-KLNFJDFM.cjs

@@ -1,1010 +0,0 @@
-"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 _chunkFFE2EMF7cjs = require('./chunk-FFE2EMF7.cjs');
-
-
-var _chunkSG57PX7Kcjs = require('./chunk-SG57PX7K.cjs');
-
-
-var _chunkH33PJEXNcjs = require('./chunk-H33PJEXN.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 _chunk2HW5LWAHcjs = require('./chunk-2HW5LWAH.cjs');
-
-
-var _chunkDQJ2CIH7cjs = require('./chunk-DQJ2CIH7.cjs');
-
-
-var _chunkXB24LZWIcjs = require('./chunk-XB24LZWI.cjs');
-
-
-var _chunkXYL4HSVCcjs = require('./chunk-XYL4HSVC.cjs');
-
-
-var _chunkFK25QSVCcjs = require('./chunk-FK25QSVC.cjs');
-
-
-var _chunkWT6RAN2Icjs = require('./chunk-WT6RAN2I.cjs');
-
-
-var _chunkD7UQC4O6cjs = require('./chunk-D7UQC4O6.cjs');
-
-
-var _chunkCECUDGXQcjs = require('./chunk-CECUDGXQ.cjs');
-
-
-var _chunk5DX3O6TTcjs = require('./chunk-5DX3O6TT.cjs');
-
-
-var _chunkLNVGXUL3cjs = require('./chunk-LNVGXUL3.cjs');
-
-
-var _chunkVQJYGZNXcjs = require('./chunk-VQJYGZNX.cjs');
-
-
-var _chunkLIFUPCXWcjs = require('./chunk-LIFUPCXW.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: _chunkFFE2EMF7cjs.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: _chunkH33PJEXNcjs.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: _chunkFFE2EMF7cjs.resolveFarmAgentSitemap.call(void 0, _nullishCoalesce(_optionalChain([input, 'optionalAccess', _4 => _4.sitemap]), () => ( !context.docs))),
-    crawlers: _chunkFFE2EMF7cjs.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}`);
-        _chunkVQJYGZNXcjs.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);
-      _chunkVQJYGZNXcjs.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 fileDocsConfig = omitDocsRoots(_optionalChain([loadedConfig, 'optionalAccess', _24 => _24.config]));
-  const inlineRawDocsConfig = omitDocsRoots(docsOptions.config);
-  const inlineDocsConfig = sanitizeDocsConfig(inlineRawDocsConfig);
-  const directDocsConfig = sanitizeDocsConfig({
-    ...docsOptions,
-    adapter: void 0,
-    enabled: void 0,
-    prerender: void 0,
-    config: void 0,
-    configPath: void 0,
-    roots: void 0
-  });
-  const loadedDocsConfig = sanitizeDocsConfig(fileDocsConfig);
-  const mergedDocsConfig = {
-    ...loadedDocsConfig,
-    ...inlineDocsConfig,
-    ...directDocsConfig
-  };
-  const runtimeDocsConfig = {
-    ...fileDocsConfig,
-    ...inlineRawDocsConfig,
-    ...omitUndefined({
-      ...docsOptions,
-      adapter: void 0,
-      enabled: void 0,
-      prerender: void 0,
-      config: void 0,
-      configPath: void 0,
-      roots: 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);
-  const configOverrides = { ...inlineDocsConfig, ...directDocsConfig };
-  const configFileName = loadedConfig ? _path2.default.relative(root, loadedConfig.configPath) || loadedConfig.configPath : "the docs config";
-  const roots = await resolveDocsRoots(
-    [
-      { field: `roots in ${configFileName}`, roots: docsRootsOf(_optionalChain([loadedConfig, 'optionalAccess', _25 => _25.config])), file: true },
-      { field: "docs.config.roots", roots: docsRootsOf(docsOptions.config) },
-      { field: "docs.roots", roots: docsOptions.roots }
-    ],
-    {
-      root,
-      srcDir: options.srcDir || "src",
-      mainEntry: entryRoute,
-      mergedDocsConfig,
-      runtimeDocsConfig,
-      configOverrides
-    }
-  );
-  if (roots.length > 0 && !(docsOptions.adapter && docsOptions.adapter.server && docsOptions.adapter.react)) {
-    throw new Error(
-      `Docs roots require a docs adapter such as @farming-labs/farmjs; Farm's built-in docs renderer serves a single docs root. Install the adapter, or remove the roots from ${configFileName} and docs.roots.`
-    );
-  }
-  return {
-    enabled: true,
-    entry: entryRoute,
-    ...docsOptions.adapter ? { adapter: docsOptions.adapter } : {},
-    ...docsOptions.prerender === true ? { prerender: true } : {},
-    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,
-    ...roots.length > 0 ? { roots } : {}
-  };
-}
-function docsRootsOf(config) {
-  return isRecord(config) ? config.roots : void 0;
-}
-function omitDocsRoots(config) {
-  if (!isRecord(config)) return {};
-  const { roots: _roots, ...rest } = config;
-  return rest;
-}
-function omitKeys(value, keys) {
-  const output = { ...value };
-  for (const key of keys) delete output[key];
-  return output;
-}
-async function resolveDocsRoots(sources, options) {
-  const declared = /* @__PURE__ */ new Map();
-  for (const source of sources) {
-    if (source.roots === void 0) continue;
-    if (!Array.isArray(source.roots)) throw new Error(`${source.field} must be an array.`);
-    const seen = /* @__PURE__ */ new Set();
-    for (const [index, rootInput] of source.roots.entries()) {
-      const field = `${source.field}[${index}].entry`;
-      if (!isRecord(rootInput) || typeof rootInput.entry !== "string" || !rootInput.entry.trim()) {
-        throw new Error(`${field} must be a route such as "/guides/docs".`);
-      }
-      const entryRoute = normalizeDocsRoute(rootInput.entry);
-      if (entryRoute === "/") {
-        throw new Error(
-          `${field} cannot be "/"; a docs root at "/" leaves no route for the others.`
-        );
-      }
-      if (entryRoute === options.mainEntry || seen.has(entryRoute)) {
-        throw new Error(
-          `${field} ${JSON.stringify(entryRoute)} is already served by another docs root.`
-        );
-      }
-      seen.add(entryRoute);
-      const { entry: _entry, ...fields } = rootInput;
-      const layers = _nullishCoalesce(declared.get(entryRoute), () => ( { file: {}, overrides: {} }));
-      if (source.file) layers.file = fields;
-      else layers.overrides = { ...layers.overrides, ...fields };
-      declared.set(entryRoute, layers);
-    }
-  }
-  const roots = [];
-  for (const [entryRoute, { file, overrides }] of declared) {
-    const docsEntry = docsRouteToEntry(entryRoute);
-    const contentDir = normalizeDocsContentDir(
-      typeof overrides.contentDir === "string" && overrides.contentDir || typeof file.contentDir === "string" && file.contentDir || void 0
-    ) || await inferDocsContentDir(options.root, options.srcDir, docsEntry);
-    const routeConfig = {
-      entry: docsEntry,
-      docsPath: entryRoute,
-      contentDir
-    };
-    const rootOverrides = sanitizeDocsConfig(overrides);
-    roots.push({
-      entry: entryRoute,
-      contentDir,
-      config: omitUndefined({
-        ...options.mergedDocsConfig,
-        ...sanitizeDocsConfig(file),
-        ...rootOverrides,
-        ...routeConfig
-      }),
-      runtimeConfig: omitUndefined({
-        ...options.runtimeDocsConfig,
-        ...file,
-        ...overrides,
-        ...routeConfig
-      }),
-      // The adapter reads the config file's own root from the config module, so the main
-      // root's overrides leave out whatever that root sets itself.
-      configOverrides: {
-        ...omitKeys(options.configOverrides, Object.keys(file)),
-        ...rootOverrides
-      }
-    });
-  }
-  return roots;
-}
-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) {
-    _chunkVQJYGZNXcjs.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) {
-    _chunkVQJYGZNXcjs.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)) {
-    _chunkVQJYGZNXcjs.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 = _chunkD7UQC4O6cjs.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 mobileSessionPlugin = userConfig.mobile !== void 0 && userConfig.mobile !== null ? (await import("./session-AAU7RNRO.cjs")).createFarmMobileSessionPlugin({
-    basePath,
-    integrations: () => integrations
-  }) : null;
-  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: _chunkXYL4HSVCcjs.resolveCronConfig.call(void 0, userConfig.cron),
-    workflows: _chunkXB24LZWIcjs.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)),
-    ...userConfig.mobile !== void 0 ? { mobileClient: true } : {},
-    plugins: [
-      ...mobileSessionPlugin ? [mobileSessionPlugin] : [],
-      ..._chunkCECUDGXQcjs.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: _chunkFFE2EMF7cjs.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: _chunkLIFUPCXWcjs.resolveFarmServerConfig.call(void 0, userConfig.server),
-    serverActions: _chunkFK25QSVCcjs.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;