@farm.js/core 0.1.60 → 0.1.62

package/dist/{chunk-NQJDO7K7.cjs → chunk-545WJ5UG.cjs}

@@ -59,19 +59,21 @@ var _chunkLT4VAF5Zcjs = require('./chunk-LT4VAF5Z.cjs');
 var _chunkDQJ2CIH7cjs = require('./chunk-DQJ2CIH7.cjs');
 
 
-var _chunkQRX4JRBOcjs = require('./chunk-QRX4JRBO.cjs');
+var _chunk3CCAICF7cjs = require('./chunk-3CCAICF7.cjs');
 
 
-var _chunkYI6FKTTNcjs = require('./chunk-YI6FKTTN.cjs');
 
 
-var _chunkFK25QSVCcjs = require('./chunk-FK25QSVC.cjs');
+var _chunkBT4SEFLCcjs = require('./chunk-BT4SEFLC.cjs');
+
+
+var _chunk4P5634G6cjs = require('./chunk-4P5634G6.cjs');
 
 
 var _chunkWT6RAN2Icjs = require('./chunk-WT6RAN2I.cjs');
 
 
-var _chunkZP32GNJQcjs = require('./chunk-ZP32GNJQ.cjs');
+var _chunkI32V5CZLcjs = require('./chunk-I32V5CZL.cjs');
 
 
 var _chunk5DX3O6TTcjs = require('./chunk-5DX3O6TT.cjs');
@@ -83,7 +85,7 @@ var _chunkLNVGXUL3cjs = require('./chunk-LNVGXUL3.cjs');
 var _chunkQMNWKQL4cjs = require('./chunk-QMNWKQL4.cjs');
 
 
-var _chunkLIFUPCXWcjs = require('./chunk-LIFUPCXW.cjs');
+var _chunkCFG4QERRcjs = require('./chunk-CFG4QERR.cjs');
 
 
 var _chunkPMJSG4JScjs = require('./chunk-PMJSG4JS.cjs');
@@ -100,6 +102,9 @@ var _chunk7JUIK547cjs = require('./chunk-7JUIK547.cjs');
 
 var _chunkD22BUQKWcjs = require('./chunk-D22BUQKW.cjs');
 
+
+var _chunkBTZ5O6VMcjs = require('./chunk-BTZ5O6VM.cjs');
+
 // src/mcp-config.ts
 var _module = require('module');
 var _path = require('path'); var _path2 = _interopRequireDefault(_path);
@@ -135,27 +140,295 @@ async function resolveFarmMCPPlugin(config, options) {
   return runtime.createFarmMCPPlugin(config);
 }
 
+// src/cron-scan.ts
+var LANGS = {
+  ts: "ts",
+  tsx: "tsx",
+  js: "jsx",
+  jsx: "jsx"
+};
+var parseAst;
+async function loadParseAst() {
+  if (!parseAst) {
+    const { createRequire: createRequire3 } = await import("module");
+    parseAst = createRequire3(typeof __filename === "string" ? __filename : _chunkBTZ5O6VMcjs.define_import_meta_default.url)(
+      "rolldown/parseAst"
+    ).parseAst;
+  }
+  return parseAst;
+}
+function unwrap(node) {
+  while (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "TSNonNullExpression" || node.type === "ParenthesizedExpression") {
+    node = node.expression;
+  }
+  return node;
+}
+function* walkNodes(value) {
+  if (!value || typeof value !== "object") return;
+  if (Array.isArray(value)) {
+    for (const item of value) yield* walkNodes(item);
+    return;
+  }
+  const node = value;
+  if (typeof node.type === "string") yield node;
+  for (const key of Object.keys(node)) {
+    if (key === "type" || key === "start" || key === "end" || key === "loc" || key === "range") {
+      continue;
+    }
+    yield* walkNodes(node[key]);
+  }
+}
+function notLiteral(file, key) {
+  throw new TypeError(
+    `The \`${key}\` option of cronRoute() in ${file} is not a literal. The build reads scheduling options from the source without running the module, so write \`${key}\` out literally or move the job to the \`cron\` config in farm.config.ts.`
+  );
+}
+function literalValue(node, file, key) {
+  if (!node) notLiteral(file, key);
+  switch (node.type) {
+    case "Literal":
+      if (node.regex || typeof node.value === "bigint") notLiteral(file, key);
+      return node.value;
+    case "TemplateLiteral":
+      if (node.expressions.length > 0) notLiteral(file, key);
+      return _nullishCoalesce(_optionalChain([node, 'access', _ => _.quasis, 'access', _2 => _2[0], 'optionalAccess', _3 => _3.value, 'optionalAccess', _4 => _4.cooked]), () => ( notLiteral(file, key)));
+    case "UnaryExpression":
+      if (node.operator === "-" && node.argument.type === "Literal" && typeof node.argument.value === "number") {
+        return -node.argument.value;
+      }
+      notLiteral(file, key);
+      break;
+    case "ArrayExpression": {
+      const items = [];
+      for (const element of node.elements) {
+        if (!element || element.type === "SpreadElement") notLiteral(file, key);
+        items.push(literalValue(unwrap(element), file, key));
+      }
+      return items;
+    }
+    case "ObjectExpression": {
+      const object = {};
+      for (const property of node.properties) {
+        if (property.type !== "Property" || property.computed || property.kind !== "init") {
+          notLiteral(file, key);
+        }
+        const propertyKey = property.key.type === "Identifier" ? property.key.name : property.key.value;
+        if (typeof propertyKey !== "string" || propertyKey === "__proto__") notLiteral(file, key);
+        object[propertyKey] = literalValue(unwrap(property.value), file, key);
+      }
+      return object;
+    }
+    case "TSAsExpression":
+    case "TSSatisfiesExpression":
+    case "TSNonNullExpression":
+    case "ParenthesizedExpression":
+      return literalValue(node.expression, file, key);
+  }
+  notLiteral(file, key);
+}
+function optionProperty(object, name) {
+  return _optionalChain([object, 'access', _5 => _5.properties, 'access', _6 => _6.find, 'call', _7 => _7(
+    (entry) => entry.type === "Property" && !entry.computed && (entry.key.name === name || entry.key.value === name)
+  ), 'optionalAccess', _8 => _8.value]);
+}
+function cronRouteLocalNames(program) {
+  const locals = /* @__PURE__ */ new Set();
+  for (const statement of program.body) {
+    if (statement.type !== "ImportDeclaration") continue;
+    for (const specifier of statement.specifiers) {
+      if (specifier.type !== "ImportSpecifier") continue;
+      const imported = _nullishCoalesce(_optionalChain([specifier, 'access', _9 => _9.imported, 'optionalAccess', _10 => _10.name]), () => ( _optionalChain([specifier, 'access', _11 => _11.imported, 'optionalAccess', _12 => _12.value])));
+      if (imported === "cronRoute") locals.add(specifier.local.name);
+    }
+  }
+  return locals;
+}
+function scannedJobFromOptions(optionsNode, file, routePath) {
+  const scheduleNode = optionProperty(optionsNode, "schedule");
+  if (!scheduleNode) return null;
+  if (optionsNode.properties.some((entry) => entry.type === "SpreadElement")) {
+    throw new TypeError(
+      `The cronRoute() options in ${file} spread another object next to \`schedule\`, so the build cannot read the job statically. Write every scheduling option literally in the call.`
+    );
+  }
+  const read = (key) => {
+    const node = optionProperty(optionsNode, key);
+    return node === void 0 ? void 0 : literalValue(unwrap(node), file, key);
+  };
+  const name = readScannedName(read("name"), file, routePath);
+  const schedule = readScannedSchedule(read("schedule"), file, name);
+  const description = read("description");
+  if (description !== void 0 && typeof description !== "string") {
+    throw new TypeError(
+      `The \`description\` option of cronRoute() in ${file} must be a string literal.`
+    );
+  }
+  const timeoutMs = read("timeoutMs");
+  if (timeoutMs !== void 0 && (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs) || timeoutMs <= 0)) {
+    throw new TypeError(
+      `The \`timeoutMs\` option of cronRoute() in ${file} must be a positive number literal in milliseconds.`
+    );
+  }
+  const enabled = read("enabled");
+  if (enabled !== void 0 && typeof enabled !== "boolean") {
+    throw new TypeError(
+      `The \`enabled\` option of cronRoute() in ${file} must be \`true\` or \`false\`.`
+    );
+  }
+  const input = read("input");
+  return {
+    name,
+    schedule,
+    path: routePath,
+    ...typeof description === "string" && description.trim() ? { description: description.trim() } : {},
+    ...input !== void 0 ? { input } : {},
+    ...timeoutMs !== void 0 ? { timeoutMs } : {},
+    filePath: file,
+    enabled: enabled !== false
+  };
+}
+function readScannedName(value, file, routePath) {
+  if (value === void 0) {
+    const defaultName = routePath === "/api" ? "" : routePath.slice("/api/".length);
+    if (!defaultName) {
+      throw new TypeError(
+        `The scheduled cronRoute() in ${file} sits at the \`/api\` root, which has no default job name. Set the \`name\` option.`
+      );
+    }
+    return defaultName;
+  }
+  if (typeof value !== "string" || value.length === 0) {
+    throw new TypeError(
+      `The \`name\` option of cronRoute() in ${file} must be a non-empty string literal.`
+    );
+  }
+  if (!value.split("/").every((segment) => _chunkBT4SEFLCcjs.FARM_CRON_NAME_SEGMENT_PATTERN.test(segment))) {
+    throw new TypeError(
+      `The \`name\` option ${JSON.stringify(value)} of cronRoute() in ${file} is invalid. Each "/"-separated segment must start with a letter or number and contain only letters, numbers, dots, underscores, or hyphens.`
+    );
+  }
+  return value;
+}
+function readScannedSchedule(value, file, name) {
+  const raw = Array.isArray(value) ? value : [value];
+  if (raw.length === 0) {
+    throw new TypeError(
+      `The \`schedule\` option of cronRoute() in ${file} must list at least one cron expression.`
+    );
+  }
+  try {
+    return [...new Set(raw.map((entry) => _chunkBT4SEFLCcjs.normalizeCronExpression.call(void 0, name, entry)))];
+  } catch (error) {
+    throw new TypeError(`${error.message} (from the cronRoute() options in ${file})`);
+  }
+}
+async function scanFarmCronRouteJobs(options) {
+  const [path4, fs] = await Promise.all([import("path"), import("fs/promises")]);
+  const apiDir = path4.join(options.root, options.srcDir || "src", "app", "api");
+  try {
+    if (!(await fs.stat(apiDir)).isDirectory()) return [];
+  } catch (e2) {
+    return [];
+  }
+  const { glob } = await import("tinyglobby");
+  const files = (await glob("**/route.{ts,tsx,js,jsx}", {
+    cwd: apiDir,
+    absolute: true,
+    expandDirectories: false
+  })).sort();
+  const jobs = [];
+  const byName = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    const code = await fs.readFile(file, "utf8");
+    if (!code.includes("cronRoute")) continue;
+    const parse = await loadParseAst();
+    const lang = _nullishCoalesce(LANGS[path4.extname(file).slice(1)], () => ( "tsx"));
+    let program;
+    try {
+      program = parse(code, { lang });
+    } catch (error) {
+      throw new TypeError(
+        `The route file ${file} could not be parsed while reading its cronRoute() schedule: ${error.message}`
+      );
+    }
+    const locals = cronRouteLocalNames(program);
+    if (locals.size === 0) continue;
+    const relativeDir = path4.relative(apiDir, path4.dirname(file)).split(path4.sep).join("/");
+    const routePath = relativeDir === "" || relativeDir === "." ? "/api" : `/api/${relativeDir}`;
+    for (const node of walkNodes(program)) {
+      if (node.type !== "CallExpression" || _optionalChain([node, 'access', _13 => _13.callee, 'optionalAccess', _14 => _14.type]) !== "Identifier" || !locals.has(node.callee.name)) {
+        continue;
+      }
+      const optionsArgument = _optionalChain([node, 'access', _15 => _15.arguments, 'optionalAccess', _16 => _16[1]]);
+      if (!optionsArgument || optionsArgument.type === "SpreadElement") continue;
+      const optionsNode = unwrap(optionsArgument);
+      if (optionsNode.type !== "ObjectExpression") continue;
+      const job = scannedJobFromOptions(optionsNode, file, routePath);
+      if (!job) continue;
+      if (/[[\]]/.test(routePath)) {
+        throw new TypeError(
+          `The scheduled cronRoute() in ${file} sits under a dynamic segment, and a scheduler cannot fill route params. Move the schedule to a static route.`
+        );
+      }
+      const existing = byName.get(job.name);
+      if (existing !== void 0) {
+        throw new TypeError(
+          `Farm cron job ${JSON.stringify(job.name)} is defined twice: in ${existing} and in ${file}. Rename or remove one of them.`
+        );
+      }
+      byName.set(job.name, file);
+      jobs.push(job);
+    }
+  }
+  return jobs;
+}
+function mergeFarmCronJobs(config, scanned) {
+  const configNames = new Set(config.jobs.map((job) => job.name));
+  const jobs = [...config.jobs];
+  for (const scannedJob of scanned) {
+    if (configNames.has(scannedJob.name)) {
+      throw new TypeError(
+        `Farm cron job ${JSON.stringify(scannedJob.name)} is defined twice: in the \`cron\` config in farm.config.ts and in ${scannedJob.filePath}. Rename or remove one of them.`
+      );
+    }
+    if (!scannedJob.enabled) continue;
+    const { filePath: _filePath, enabled: _enabled, ...job } = scannedJob;
+    jobs.push(job);
+  }
+  if (jobs.length === config.jobs.length) return config;
+  return { ...config, enabled: jobs.length > 0, jobs };
+}
+async function resolveProjectCronJobs(options) {
+  const resolved = _chunkBT4SEFLCcjs.resolveCronConfig.call(void 0, options.cron);
+  if (resolved === options.cron || options.cron === false) return resolved;
+  const scanned = await scanFarmCronRouteJobs({
+    root: options.root || process.cwd(),
+    srcDir: options.srcDir
+  });
+  return mergeFarmCronJobs(resolved, scanned);
+}
+
 // src/config.ts
 
 
 // src/agent-config.ts
 var DEFAULT_JSON_LD = { type: "WebSite" };
 function resolveFarmAgentConfig(input, context = {}) {
-  const jsonLd = _optionalChain([input, 'optionalAccess', _ => _.jsonLd]);
+  const jsonLd = _optionalChain([input, 'optionalAccess', _17 => _17.jsonLd]);
   return {
     jsonLd: jsonLd === void 0 ? { ...DEFAULT_JSON_LD } : !jsonLd ? false : jsonLd === true ? {} : jsonLd,
-    noindexPreviews: _chunkDZPR2W6Ucjs.resolveFarmNoindexPreviews.call(void 0, _optionalChain([input, 'optionalAccess', _2 => _2.noindexPreviews])),
+    noindexPreviews: _chunkDZPR2W6Ucjs.resolveFarmNoindexPreviews.call(void 0, _optionalChain([input, 'optionalAccess', _18 => _18.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: _chunkMEQN6DDAcjs.resolveFarmLlmsTxtConfig.call(void 0, _nullishCoalesce(_optionalChain([input, 'optionalAccess', _3 => _3.llmsTxt]), () => ( (context.docs ? false : { full: false })))),
+    llmsTxt: _chunkMEQN6DDAcjs.resolveFarmLlmsTxtConfig.call(void 0, _nullishCoalesce(_optionalChain([input, 'optionalAccess', _19 => _19.llmsTxt]), () => ( (context.docs ? false : { full: false })))),
     // Same rule as llms.txt: the docs engine answers /sitemap.xml with its own pages.
-    sitemap: _chunkDZPR2W6Ucjs.resolveFarmAgentSitemap.call(void 0, _nullishCoalesce(_optionalChain([input, 'optionalAccess', _4 => _4.sitemap]), () => ( !context.docs))),
-    crawlers: _chunkDZPR2W6Ucjs.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])),
+    sitemap: _chunkDZPR2W6Ucjs.resolveFarmAgentSitemap.call(void 0, _nullishCoalesce(_optionalChain([input, 'optionalAccess', _20 => _20.sitemap]), () => ( !context.docs))),
+    crawlers: _chunkDZPR2W6Ucjs.resolveFarmAgentCrawlers.call(void 0, _optionalChain([input, 'optionalAccess', _21 => _21.crawlers])),
+    apiCatalog: resolveFarmAgentBoolean(_optionalChain([input, 'optionalAccess', _22 => _22.apiCatalog]), "apiCatalog", false),
+    aiCatalog: resolveFarmAgentBoolean(_optionalChain([input, 'optionalAccess', _23 => _23.aiCatalog]), "aiCatalog", true),
+    manifest: _chunkSG57PX7Kcjs.resolveFarmAppManifestConfig.call(void 0, _optionalChain([input, 'optionalAccess', _24 => _24.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)
+    mcp: resolveFarmAgentBoolean(_optionalChain([input, 'optionalAccess', _25 => _25.mcp]), "mcp", !context.docs)
   };
 }
 function resolveFarmAgentBoolean(input, key, fallback) {
@@ -182,7 +455,7 @@ async function frameworkDeclaredByApp(root) {
         return true;
       }
     }
-  } catch (e2) {
+  } catch (e3) {
   }
   return false;
 }
@@ -221,7 +494,7 @@ async function applyFarmDocsFrameworkAutoDetection(userConfig, options) {
   try {
     const requireFromApp = _module.createRequire.call(void 0, _path2.default.join(root, "package.json"));
     configEntryPath = requireFromApp.resolve(FRAMEWORK_CONFIG_ENTRY);
-  } catch (e3) {
+  } catch (e4) {
     noticeOnce(
       "declared-not-installed",
       warn,
@@ -234,7 +507,7 @@ async function applyFarmDocsFrameworkAutoDetection(userConfig, options) {
       /* @vite-ignore */
       _url.pathToFileURL.call(void 0, configEntryPath).href
     );
-    const withDocs = _optionalChain([frameworkConfig, 'optionalAccess', _10 => _10.withDocs]);
+    const withDocs = _optionalChain([frameworkConfig, 'optionalAccess', _26 => _26.withDocs]);
     if (typeof withDocs !== "function") {
       noticeOnce(
         "missing-withdocs",
@@ -244,7 +517,7 @@ async function applyFarmDocsFrameworkAutoDetection(userConfig, options) {
       return userConfig;
     }
     const applied = withDocs(userConfig);
-    const adapter = _optionalChain([applied, 'optionalAccess', _11 => _11.docs, 'optionalAccess', _12 => _12.adapter]);
+    const adapter = _optionalChain([applied, 'optionalAccess', _27 => _27.docs, 'optionalAccess', _28 => _28.adapter]);
     if (!isSupportedAdapterDescriptor(adapter)) {
       noticeOnce(
         "unsupported-descriptor",
@@ -350,7 +623,7 @@ var PLATFORM_BUILD_ENV_TARGETS = [
 ];
 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()]);
+    const value = _optionalChain([env, 'access', _29 => _29[key], 'optionalAccess', _30 => _30.trim, 'call', _31 => _31(), 'access', _32 => _32.toLowerCase, 'call', _33 => _33()]);
     if (value === "1" || value === "true") return target;
   }
   return void 0;
@@ -389,7 +662,7 @@ function resolveDeployConfig(config, overrides = {}) {
       );
     }
   }
-  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 platformOutput = resolvedTarget === "vercel" ? _optionalChain([deploy, 'access', _34 => _34.vercel, 'optionalAccess', _35 => _35.outputDirectory]) : resolvedTarget === "cloudflare" ? _optionalChain([deploy, 'access', _36 => _36.cloudflare, 'optionalAccess', _37 => _37.outputDir]) : resolvedTarget === "netlify" ? _optionalChain([deploy, 'access', _38 => _38.netlify, 'optionalAccess', _39 => _39.outputDir]) : void 0;
   const outputDir = overrides.outputDir || deploy.outputDir || deploy.output || platformOutput || getDefaultDeployOutputDir(resolvedTarget, preset, distDir);
   return {
     ...deploy,
@@ -565,7 +838,7 @@ async function resolveDocsConfig(userDocs, options = {}) {
       config: { entry: "docs", docsPath: "/docs" }
     };
   }
-  const fileDocsConfig = omitDocsRoots(_optionalChain([loadedConfig, 'optionalAccess', _24 => _24.config]));
+  const fileDocsConfig = omitDocsRoots(_optionalChain([loadedConfig, 'optionalAccess', _40 => _40.config]));
   const inlineRawDocsConfig = omitDocsRoots(docsOptions.config);
   const inlineDocsConfig = sanitizeDocsConfig(inlineRawDocsConfig);
   const directDocsConfig = sanitizeDocsConfig({
@@ -611,7 +884,7 @@ async function resolveDocsConfig(userDocs, options = {}) {
   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: `roots in ${configFileName}`, roots: docsRootsOf(_optionalChain([loadedConfig, 'optionalAccess', _41 => _41.config])), file: true },
       { field: "docs.config.roots", roots: docsRootsOf(docsOptions.config) },
       { field: "docs.roots", roots: docsOptions.roots }
     ],
@@ -635,7 +908,7 @@ async function resolveDocsConfig(userDocs, options = {}) {
     ...docsOptions.adapter ? { adapter: docsOptions.adapter } : {},
     ...docsOptions.prerender === true ? { prerender: true } : {},
     contentDir,
-    configPath: _optionalChain([loadedConfig, 'optionalAccess', _26 => _26.configPath]),
+    configPath: _optionalChain([loadedConfig, 'optionalAccess', _42 => _42.configPath]),
     config: {
       ...mergedDocsConfig,
       entry: docsEntry,
@@ -756,7 +1029,7 @@ function validateConfigRouteSources(routes, field) {
   return routes;
 }
 async function resolveConfig(userConfig, mode) {
-  _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([userConfig, 'access', _27 => _27.experimental, 'optionalAccess', _28 => _28.serverComponents]));
+  _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([userConfig, 'access', _43 => _43.experimental, 'optionalAccess', _44 => _44.serverComponents]));
   const projectRoot = userConfig.root || process.cwd();
   const layerResolution = await _chunk5Y2P454Ocjs.resolveFarmLayers.call(void 0, userConfig, {
     root: projectRoot,
@@ -797,9 +1070,9 @@ async function resolveConfig(userConfig, mode) {
     );
   }
   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)]);
+  const desktopSetup = await _optionalChain([globalThis, 'access', _45 => _45[/* @__PURE__ */ Symbol.for("@farm.js/core/desktop-setup")], 'optionalCall', _46 => _46(userConfig, root, mode)]);
   if (desktopSetup) userConfig = desktopSetup.userConfig;
-  const deploy = resolveDeployConfig(userConfig, _optionalChain([desktopSetup, 'optionalAccess', _31 => _31.deploy]));
+  const deploy = resolveDeployConfig(userConfig, _optionalChain([desktopSetup, 'optionalAccess', _47 => _47.deploy]));
   const srcDir = userConfig.srcDir || "src";
   _chunkBPNOYILCcjs.setFarmProjectSourceDir.call(void 0, root, srcDir);
   const docs = await resolveDocsConfig(userConfig.docs, { root, srcDir });
@@ -808,9 +1081,10 @@ async function resolveConfig(userConfig, mode) {
   const env = _chunk3EIPOTZVcjs.resolveEnv.call(void 0, userConfig.env, process.env);
   _chunk3EIPOTZVcjs.setEnv.call(void 0, env);
   const api = await _chunkPMJSG4JScjs.resolveFarmAPIConfig.call(void 0, userConfig.api, { root, mode, env });
+  const cron = await resolveProjectCronJobs({ root, srcDir, cron: userConfig.cron });
   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])) {
+  if (auth.enabled && _optionalChain([userConfig, 'access', _48 => _48.integrations, 'optionalAccess', _49 => _49.auth])) {
     throw new Error(
       "Choose either the top-level `auth` config or `integrations.auth`; they cannot both own the auth route."
     );
@@ -820,7 +1094,7 @@ async function resolveConfig(userConfig, mode) {
     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")])) {
+  if (nativeMCPPlugin && _optionalChain([userConfig, 'access', _50 => _50.plugins, 'optionalAccess', _51 => _51.some, 'call', _52 => _52((plugin) => _optionalChain([plugin, 'optionalAccess', _53 => _53.name]) === "farm:api-mcp")])) {
     throw new Error(
       "Choose either the top-level `mcp` config or `apiMcp()` in `plugins`; they configure the same MCP transport."
     );
@@ -835,6 +1109,12 @@ async function resolveConfig(userConfig, mode) {
     basePath,
     integrations: () => integrations
   }) : null;
+  let nativeServerFnAppDirs = [];
+  const nativeServerFnPlugin = userConfig.mobile !== void 0 && userConfig.mobile !== null ? (await import("./native-server-fn-handler-J5MYRXN6.cjs")).createFarmNativeServerFnPlugin({
+    resolve: (await import("./internal/native-server-fns.cjs")).createFarmDevNativeServerFnResolver(
+      { root, srcDir, appDirs: () => nativeServerFnAppDirs }
+    )
+  }) : null;
   const openapi = {
     enabled: false,
     route: "/docs/reference",
@@ -861,8 +1141,8 @@ async function resolveConfig(userConfig, mode) {
     md,
     mdx,
     migrations: resolveMigrationsConfig(userConfig.migrations),
-    cron: _chunkYI6FKTTNcjs.resolveCronConfig.call(void 0, userConfig.cron),
-    workflows: _chunkQRX4JRBOcjs.resolveWorkflowsConfig.call(void 0, userConfig.workflows),
+    cron,
+    workflows: _chunk3CCAICF7cjs.resolveWorkflowsConfig.call(void 0, userConfig.workflows),
     api,
     observability: _nullishCoalesce(userConfig.observability, () => ( false)),
     telemetry: userConfig.telemetry !== false,
@@ -879,16 +1159,17 @@ async function resolveConfig(userConfig, mode) {
       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",
+      isolatedClientHydration: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([userConfig, 'access', _54 => _54.experimental, 'optionalAccess', _55 => _55.serverComponents])) === "islands" ? "enabled" : "off",
       ppr: false,
       ...userConfig.experimental
     },
     agent: resolveFarmAgentConfig(userConfig.agent, { docs: docs.enabled }),
-    desktop: _nullishCoalesce(_optionalChain([desktopSetup, 'optionalAccess', _40 => _40.desktop]), () => ( null)),
+    desktop: _nullishCoalesce(_optionalChain([desktopSetup, 'optionalAccess', _56 => _56.desktop]), () => ( null)),
     ...userConfig.mobile !== void 0 ? { mobileClient: true } : {},
     plugins: [
       ...mobileSessionPlugin ? [mobileSessionPlugin] : [],
-      ..._chunkZP32GNJQcjs.resolveIntegrationPlugins.call(void 0, integrations),
+      ...nativeServerFnPlugin ? [nativeServerFnPlugin] : [],
+      ..._chunkI32V5CZLcjs.resolveIntegrationPlugins.call(void 0, integrations),
       ...nativeMCPPlugin ? [nativeMCPPlugin] : [],
       ...userConfig.plugins || []
     ],
@@ -911,8 +1192,8 @@ async function resolveConfig(userConfig, mode) {
     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),
+    server: _chunkCFG4QERRcjs.resolveFarmServerConfig.call(void 0, userConfig.server),
+    serverActions: _chunk4P5634G6cjs.resolveServerActionsConfig.call(void 0, userConfig.serverActions),
     security,
     deploymentId,
     distDir: userConfig.distDir || ".farm",
@@ -925,6 +1206,9 @@ async function resolveConfig(userConfig, mode) {
     vite: typeof userConfig.vite === "function" ? userConfig.vite({}) : userConfig.vite || {}
   };
   _chunkLSHX2H5Gcjs.assertPluginDependencies.call(void 0, resolved.plugins, resolved.integrations);
+  if (nativeServerFnPlugin) {
+    nativeServerFnAppDirs = (await import("./layers-DMRXRL7F.cjs")).getFarmAppDirectories(resolved);
+  }
   return resolved;
 }
 function formatConfigLoadError(error) {
@@ -933,13 +1217,13 @@ function formatConfigLoadError(error) {
       try {
         const value = Reflect.get(error, property);
         if (typeof value === "string" && value) return value;
-      } catch (e4) {
+      } catch (e5) {
       }
     }
   }
   try {
     return String(error);
-  } catch (e5) {
+  } catch (e6) {
     return "Unknown config loader error";
   }
 }

package/dist/{chunk-VU3MYZPO.mjs → chunk-5FE5YT2N.mjs}

@@ -5,6 +5,29 @@ var FARM_NODE_ENV_MODULE_SOURCE = `if (!process.env.NODE_ENV) process.env.NODE_E
 var FARM_DESKTOP_ENV_MODULE_FILE = "farm-desktop-env.mjs";
 var FARM_DESKTOP_ENV_MODULE_SOURCE = `process.env.FARM_PLATFORM = "desktop";
 ${FARM_NODE_ENV_MODULE_SOURCE}`;
+var FARM_SERVER_MODULE_FILE = "farm-server.mjs";
+var FARM_COMPILE_CACHE_DIR = ".compile-cache";
+function createFarmCompileCacheLauncher(serverModuleFile) {
+  return `import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// A deployment that set NODE_COMPILE_CACHE itself already chose a location.
+if (!process.env.NODE_COMPILE_CACHE) {
+  try {
+    const { enableCompileCache } = await import("node:module");
+    enableCompileCache?.(join(dirname(fileURLToPath(import.meta.url)), ${JSON.stringify(FARM_COMPILE_CACHE_DIR)}));
+  } catch {
+    // Node without the API, or an output directory it cannot write: start uncached.
+  }
+}
+
+const farmServer = await import(${JSON.stringify(`./${serverModuleFile}`)});
+
+// The built server starts on import and exports a placeholder default. Pass it through so
+// the entry's module shape is the one Nitro emitted.
+export default farmServer.default;
+`;
+}
 var FARM_DESKTOP_READY_PREFIX = "farm:ready ";
 var nodeServerSource = (desktop) => `const socketPath = process.env.NITRO_UNIX_SOCKET;
 const server = serve({
@@ -426,6 +449,9 @@ export {
   FARM_NODE_ENV_MODULE_SOURCE,
   FARM_DESKTOP_ENV_MODULE_FILE,
   FARM_DESKTOP_ENV_MODULE_SOURCE,
+  FARM_SERVER_MODULE_FILE,
+  FARM_COMPILE_CACHE_DIR,
+  createFarmCompileCacheLauncher,
   createFarmNodeServerEntry,
   createFarmBunServerEntry,
   withProductionNodeEnv

package/dist/{chunk-A5BJKSZE.cjs → chunk-5IQ2ERQA.cjs}

@@ -3,7 +3,7 @@
 var _chunkUNJZGVPUcjs = require('./chunk-UNJZGVPU.cjs');
 
 
-var _chunkLIFUPCXWcjs = require('./chunk-LIFUPCXW.cjs');
+var _chunkCFG4QERRcjs = require('./chunk-CFG4QERR.cjs');
 
 // src/image-pattern.ts
 var compiledPatterns = /* @__PURE__ */ new WeakMap();
@@ -582,7 +582,7 @@ function createOptimizedImageResponse(request, image) {
     // document, it still cannot run script or load anything.
     "content-security-policy": "default-src 'none'; sandbox"
   });
-  if (_chunkLIFUPCXWcjs.matchesFarmIfNoneMatch.call(void 0, request.headers.get("if-none-match"), image.etag)) {
+  if (_chunkCFG4QERRcjs.matchesFarmIfNoneMatch.call(void 0, request.headers.get("if-none-match"), image.etag)) {
     headers.delete("content-length");
     return new Response(null, { status: 304, headers });
   }

package/dist/{chunk-SJRCWF4Z.mjs → chunk-5Y22WNTO.mjs}

@@ -1,6 +1,6 @@
 import {
   readFarmNativeWebSpec
-} from "./chunk-6UUH4N4J.mjs";
+} from "./chunk-43V3ANPQ.mjs";
 import {
   isPlainObject,
   readAppPackageJson
@@ -43,7 +43,7 @@ function scanFarmMobileAppModules(options) {
     specs.push({ name: match[2], file });
   }
   const android = entries.filter((entry) => entry.endsWith(".kt")).map((entry) => path.join(dir, entry));
-  const ios = entries.filter((entry) => entry.endsWith(".swift")).map((entry) => path.join(dir, entry));
+  const ios = entries.filter((entry) => /\.(?:mm|m|h|swift)$/.test(entry)).map((entry) => path.join(dir, entry));
   if (specs.length === 0 && android.length === 0 && ios.length === 0) return void 0;
   return { dir, specs, android, ios };
 }

package/dist/{chunk-U4BJKNIR.cjs → chunk-752XUZIM.cjs}

@@ -180,15 +180,20 @@ async function scanRoutePatterns(options) {
     }
   }
   if (!options.platformFiles) return { pages, modules };
+  const nativeOnlyPages = /* @__PURE__ */ new Set();
   for (const [pattern, files] of nativePages) {
-    if (!pages.has(pattern)) {
-      const file = path.relative(root, Object.values(files)[0]);
-      throw new Error(
-        `${file.replace(/\\/g, "/")} has no web page next to it. Add ${path.join(path.dirname(file), "page.tsx").replace(/\\/g, "/")}: it is the route's web screen and the fallback on every platform.`
-      );
+    if (pages.has(pattern)) continue;
+    if (files.native) {
+      nativeOnlyPages.add(pattern);
+      continue;
     }
+    const file = path.relative(root, Object.values(files)[0]);
+    const dir = path.dirname(file);
+    throw new Error(
+      `${file.replace(/\\/g, "/")} has no web page next to it. Add ${path.join(dir, "page.tsx").replace(/\\/g, "/")} (the route's web screen and fallback), or ${path.join(dir, "page.native.tsx").replace(/\\/g, "/")} to make the route native-only on both OSes.`
+    );
   }
-  return { pages, modules, pageFiles, nativePages, nativeLayouts };
+  return { pages, modules, pageFiles, nativePages, nativeLayouts, nativeOnlyPages };
 }
 function scanPlatformRouteFiles(appDir, files, nativePages, nativeLayouts) {
   const seen = /* @__PURE__ */ new Map();