@farm.js/core 0.1.25 → 0.1.27

package/dist/{chunk-WJYCI56T.mjs → chunk-UWTQTZFN.mjs}

@@ -7,7 +7,7 @@ import {
 import {
   compileFarmDocsAdapterEdgeManifest,
   createFarmDocsAPIHandler
-} from "./chunk-XME4TCLB.mjs";
+} from "./chunk-4FHDV7VM.mjs";
 import {
   FARM_DOCS_LAST_MODIFIED_MANIFEST,
   createFarmDocsHandler,
@@ -17,7 +17,7 @@ import {
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-2KI3CL3N.mjs";
+} from "./chunk-FPW4W3VW.mjs";
 import {
   generateFarmDocsSearchClientRuntime,
   isFarmDocsSearchEnabled,
@@ -25,7 +25,7 @@ import {
 } from "./chunk-UP4CW6WP.mjs";
 import {
   FARM_PRERENDER_ENV
-} from "./chunk-6VEHUKZ2.mjs";
+} from "./chunk-MM5D6VLP.mjs";
 import {
   loadFarmDocsEngine
 } from "./chunk-2VQKKQ6D.mjs";
@@ -34,7 +34,7 @@ import {
   getDeployTargetForPreset,
   hasCustomFarmRouteContext,
   resolveDeployOutputPath
-} from "./chunk-5YYJ6Q2L.mjs";
+} from "./chunk-WIVTGKLY.mjs";
 import {
   resolveFarmInstrumentationFile
 } from "./chunk-ZZSRYEYU.mjs";
@@ -44,6 +44,7 @@ import {
 import {
   DEFAULT_NOT_FOUND_STYLES,
   FARM_LAYOUT_ELEMENT_CLIENT_SOURCE,
+  HOISTED_HEAD_ELEMENT,
   PluginManager,
   SHARP_INSTALL_HINT,
   createFarmApp,
@@ -69,7 +70,7 @@ import {
   resolveFarmImageProviderForRuntime,
   resolveFarmIsolatedClientHydrationMode,
   resolveFarmNotFoundComponentPath
-} from "./chunk-N2Z4ZFDE.mjs";
+} from "./chunk-OGHTEYXS.mjs";
 import {
   findRequestBoundSourceBlockers,
   generateFarmTypeArtifacts,
@@ -79,7 +80,7 @@ import {
 import {
   FARM_API_CATALOG_PATH,
   resolveFarmApiCatalogInput
-} from "./chunk-T2OPSH6S.mjs";
+} from "./chunk-HG237IEY.mjs";
 import {
   isFarmPreviewDeploymentEnvironment
 } from "./chunk-BOYNDCZL.mjs";
@@ -111,7 +112,7 @@ import {
 } from "./chunk-DAATZTKJ.mjs";
 import {
   applyFarmCspHashesToHtml
-} from "./chunk-RR6UGYUT.mjs";
+} from "./chunk-JT25KHDI.mjs";
 import {
   applyFarmCronVercelCrons,
   createFarmCronCloudflareConfig,
@@ -123,14 +124,14 @@ import {
 } from "./chunk-4OOBRCJX.mjs";
 import {
   isFarmMarkdownPageFile
-} from "./chunk-XM4ZDVD7.mjs";
+} from "./chunk-MBFURXAC.mjs";
 import {
   resolveFarmMdxComponentsModulePath,
   resolveMdxConfig
 } from "./chunk-FA2W42OV.mjs";
 import {
   getFarmMarkdownAlternatePath
-} from "./chunk-U4MP7XTD.mjs";
+} from "./chunk-POXI72VV.mjs";
 import {
   applyFarmWorkflowVercelCrons,
   prepareFarmWorkflowsForNitro
@@ -144,7 +145,7 @@ import {
 } from "./chunk-TIKNUAU7.mjs";
 import {
   APIRouteManager
-} from "./chunk-QGG336NI.mjs";
+} from "./chunk-Q4BHBO6V.mjs";
 import {
   readFarmI18nCatalogs
 } from "./chunk-FV45CKBC.mjs";
@@ -6325,12 +6326,13 @@ function stripFarmDocumentWrappers(markup) {
 }
 
 // Farm's display:contents wrappers, and the head elements React 19 hoists in front of them
-// (charset, viewport, preloads, titles) when the layout's <html> is not the render root.
+// (charset, viewport, preloads, titles, async scripts, precedence styles) when the layout's
+// <html> is not the render root. The hoistable pattern is shared with the dev renderer.
 function peelFarmDocumentPrefix(markup) {
   let inner = markup.replace(/^\\s+/, "");
   let hoisted = "";
   const wrapper = /^<div\\b[^>]*style=["']display\\s*:\\s*contents["'][^>]*>/i;
-  const hoistable = /^(?:<(?:meta|link|base)\\b[^>]*>|<title\\b[^>]*>[\\s\\S]*?<\\/title>)/i;
+  const hoistable = /${HOISTED_HEAD_ELEMENT.source}/i;
   let match;
   while ((match = wrapper.exec(inner) || hoistable.exec(inner))) {
     if (!/^<div/i.test(match[0])) hoisted += match[0];
@@ -6842,7 +6844,7 @@ async function handleApplicationMetadataRouteRequest(request, routePathname) {
     const body = isLlmsFull && !(value instanceof Response)
       ? await renderFarmLlmsFullTxt(value, { origin: url.origin, readMarkdown: llmsContext.markdown })
       : value;
-    return createFarmMetadataRouteResponse(match.metadata.kind, body, routeModule, { method });
+    return createFarmMetadataRouteResponse(match.metadata.kind, body, routeModule, { method, request });
   } catch (error) {
     console.error("Metadata route render failed:", error);
     return new Response("Internal Server Error", {
@@ -7561,6 +7563,7 @@ async function handleFarmRequestInContext(
       routeExists: (targetPathname) =>
         Boolean(matchPageRoute(getFarmRoutePathname(targetPathname))),
       renderPage: (targetRequest) => handleFarmRequest(targetRequest, adapterContext),
+      apiServerBasePath: farmLocalAPIBasePath,
     });
     if (markdownResponse) {
       return applyProductionMiddlewareHeaders(markdownResponse, middlewareHeaders);
@@ -7647,7 +7650,7 @@ async function handleFarmRequestInContext(
   // agent.apiCatalog: list the OpenAPI and MCP surfaces at the RFC 9727 path.
   if (normalizeRuntimePath(routePathname) === ${JSON.stringify(FARM_API_CATALOG_PATH)}) {
     return applyProductionMiddlewareHeaders(
-      createFarmApiCatalogResponse(request.method, farmApiCatalogInput),
+      createFarmApiCatalogResponse(request.method, farmApiCatalogInput, request),
       middlewareHeaders,
     );
   }
@@ -7669,26 +7672,34 @@ async function handleFarmRequestInContext(
   if (farmGeneratedLlmsKind) {
     const llmsContext = createFarmLlmsTxtContext(request, farmGeneratedLlmsKind === "llms-full");
     const llmsOrigin = new URL(request.url).origin;
-    const renderLlmsFull = () =>
+    // A page that times out is left out, the shared render is not reused, and
+    // the partial response is not cacheable.
+    let llmsComplete = true;
+    const renderLlmsFull = (shared) =>
       renderFarmLlmsFullTxt(llmsContext.defaults, {
         origin: llmsOrigin,
         readMarkdown: llmsContext.markdown,
+        onIncomplete: () => {
+          llmsComplete = false;
+          if (shared) shared.incomplete();
+        },
       });
     // HEAD reads no pages, so it neither waits for nor fills the shared render.
     const llmsBody = farmGeneratedLlmsKind !== "llms-full"
       ? llmsContext.defaults
       : request.method.toUpperCase() === "HEAD"
         ? await renderLlmsFull()
-        : await farmLlmsFullRenderer(llmsOrigin, renderLlmsFull);
-    return applyProductionMiddlewareHeaders(
-      createFarmMetadataRouteResponse(
-        farmGeneratedLlmsKind,
-        llmsBody,
-        { revalidate: farmLlmsTxtConfig.revalidate },
-        { method: request.method },
-      ),
-      middlewareHeaders,
+        : await farmLlmsFullRenderer(llmsOrigin, renderLlmsFull, (complete) => {
+            llmsComplete = complete;
+          });
+    const llmsResponse = createFarmMetadataRouteResponse(
+      farmGeneratedLlmsKind,
+      llmsBody,
+      { revalidate: llmsComplete ? farmLlmsTxtConfig.revalidate : 0 },
+      { method: request.method, request },
     );
+    if (!llmsComplete) llmsResponse.headers.set("cache-control", "no-store");
+    return applyProductionMiddlewareHeaders(llmsResponse, middlewareHeaders);
   }
   ` : ""}
 
@@ -9231,7 +9242,12 @@ export default async function farmNitroEventHandler(event) {
     preset,
     ...farmNodeServerEntryPath ? { entry: farmNodeServerEntryPath } : {},
     rootDir: root,
-    serverDir: root,
+    // Farm registers every handler, task, and plugin explicitly. Scanning the
+    // project root would bundle an app's own `middleware/`, `api/`, `routes/`,
+    // `plugins/`, or `tasks/` folder, or a root `server.ts` (common without a
+    // `src` directory), as Nitro handlers outside Farm's aliases.
+    serverDir: false,
+    serverEntry: false,
     buildDir: path5.join(root, distDir, ".nitro"),
     alias: resolveNitroInternalRuntimeAliases(root),
     compatibilityDate: "2024-12-01",
@@ -9340,13 +9356,16 @@ export default async function farmNitroEventHandler(event) {
       const alternatePath = getFarmMarkdownAlternatePath(config.md, route.route);
       if (!alternatePath) return;
       const routeRule = nitroInstance.options.routeRules[route.route] || {};
-      nitroInstance.options.routeRules[route.route] = {
-        ...routeRule,
-        headers: {
-          ...routeRule.headers,
-          Link: `<${alternatePath}>; rel="alternate"; type="text/markdown"`
-        }
-      };
+      const alternate = `<${alternatePath}>; rel="alternate"; type="text/markdown"`;
+      const headers = { ...routeRule.headers };
+      let link;
+      for (const key of Object.keys(headers)) {
+        if (key.toLowerCase() !== "link") continue;
+        link = link ? `${link}, ${headers[key]}` : headers[key];
+        delete headers[key];
+      }
+      headers.Link = !link ? alternate : link.includes(alternate) ? link : `${link}, ${alternate}`;
+      nitroInstance.options.routeRules[route.route] = { ...routeRule, headers };
     });
     nitroInstance.hooks.hook("prerender:done", () => {
       nitroInstance.routing.sync();
@@ -10247,7 +10266,7 @@ function resolveLegacyPageEntry(config, root, srcDir) {
 __name(resolveLegacyPageEntry, "resolveLegacyPageEntry");
 async function buildNitro(config, routeManager, apiRouteManager, serverRenderer, preset, root, distDir, pluginManager) {
   const [{ createNitroConfig }, { createNitro, build: nitroBuild }] = await Promise.all([
-    import("./nitro-ZKLGOTVY.mjs"),
+    import("./nitro-NAKCRVHX.mjs"),
     import("nitro/builder")
   ]);
   let nitroConfig = await createNitroConfig(

package/dist/{chunk-5YYJ6Q2L.mjs → chunk-WIVTGKLY.mjs}

@@ -28,7 +28,7 @@ import {
   resolveFarmNoindexPreviews,
   resolveFarmPerformanceConfig,
   resolveFarmSecurityConfig
-} from "./chunk-RR6UGYUT.mjs";
+} from "./chunk-JT25KHDI.mjs";
 import {
   resolveFarmImageConfig
 } from "./chunk-G2KY33I6.mjs";
@@ -47,7 +47,7 @@ import {
 } from "./chunk-FA2W42OV.mjs";
 import {
   resolveMarkdownConfig
-} from "./chunk-U4MP7XTD.mjs";
+} from "./chunk-POXI72VV.mjs";
 import {
   bundleNodeModule
 } from "./chunk-SFGWNC43.mjs";
@@ -288,6 +288,10 @@ function hasCustomFarmRouteContext(config) {
   return config[FARM_RESOLVED_CUSTOM_CONTEXT] === true;
 }
 __name(hasCustomFarmRouteContext, "hasCustomFarmRouteContext");
+function isResolvedFarmConfig(config) {
+  return Object.prototype.hasOwnProperty.call(config, FARM_RESOLVED_CUSTOM_CONTEXT);
+}
+__name(isResolvedFarmConfig, "isResolvedFarmConfig");
 function normalizeDeployTarget(target) {
   if (!target) return void 0;
   if (target === "cloudflare-pages" || target === "cloudflare_pages") return "cloudflare";
@@ -876,6 +880,7 @@ __name(loadConfig, "loadConfig");
 
 export {
   hasCustomFarmRouteContext,
+  isResolvedFarmConfig,
   normalizeDeployTarget,
   getPresetForDeployTarget,
   getDeployTargetForPreset,

package/dist/{chunk-65P6OGYN.cjs → chunk-WJKVTJJR.cjs}

@@ -3,17 +3,20 @@
 var _chunkOWOUTKIJcjs = require('./chunk-OWOUTKIJ.cjs');
 
 
-var _chunkE3RDL2DAcjs = require('./chunk-E3RDL2DA.cjs');
+var _chunkDQMTHWPIcjs = require('./chunk-DQMTHWPI.cjs');
+
+
+var _chunkJ63ZH5OQcjs = require('./chunk-J63ZH5OQ.cjs');
 
 
 var _chunkOI6CMLWXcjs = require('./chunk-OI6CMLWX.cjs');
 
 
+var _chunkTKJZFIMLcjs = require('./chunk-TKJZFIML.cjs');
 
-var _chunkWPYFSQKKcjs = require('./chunk-WPYFSQKK.cjs');
 
 
-var _chunkTKJZFIMLcjs = require('./chunk-TKJZFIML.cjs');
+var _chunkWPYFSQKKcjs = require('./chunk-WPYFSQKK.cjs');
 
 
 var _chunkBIDYX3SLcjs = require('./chunk-BIDYX3SL.cjs');
@@ -201,10 +204,13 @@ function createFarmMetadataRouteResponse(kind, value, routeModule = {}, options
   if (method !== "GET" && method !== "HEAD") {
     return new Response(null, { status: 405, headers: { Allow: "GET, HEAD" } });
   }
+  if ((kind === "llms" || kind === "llms-full") && options.request) {
+    _chunkJ63ZH5OQcjs.emitFarmAgentRead.call(void 0, options.request, kind, isResponse(value) ? value.status : 200);
+  }
   if (isResponse(value)) {
     return method === "HEAD" ? _chunkTKJZFIMLcjs.omitFarmResponseBody.call(void 0, value) : value;
   }
-  const body = kind === "sitemap" ? serializeSitemap(value) : kind === "robots" ? serializeRobots(value) : kind === "llms" || kind === "llms-full" ? _chunkE3RDL2DAcjs.serializeFarmLlmsTxt.call(void 0, value) : serializeManifest(value);
+  const body = kind === "sitemap" ? serializeSitemap(value) : kind === "robots" ? serializeRobots(value) : kind === "llms" || kind === "llms-full" ? _chunkDQMTHWPIcjs.serializeFarmLlmsTxt.call(void 0, value) : serializeManifest(value);
   const contentType = kind === "sitemap" ? "application/xml; charset=utf-8" : kind === "robots" || kind === "llms" || kind === "llms-full" ? "text/plain; charset=utf-8" : "application/manifest+json; charset=utf-8";
   return new Response(method === "HEAD" ? null : body, {
     headers: {
@@ -486,7 +492,7 @@ function createFarmApiCatalog(input) {
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, createFarmApiCatalog, "createFarmApiCatalog");
-function createFarmApiCatalogResponse(method, input) {
+function createFarmApiCatalogResponse(method, input, request) {
   const upperMethod = method.toUpperCase();
   if (upperMethod !== "GET" && upperMethod !== "HEAD") {
     return new Response("Method Not Allowed", {
@@ -494,6 +500,7 @@ function createFarmApiCatalogResponse(method, input) {
       headers: { Allow: "GET, HEAD", "Content-Type": "text/plain; charset=utf-8" }
     });
   }
+  if (request) _chunkJ63ZH5OQcjs.emitFarmAgentRead.call(void 0, request, "api-catalog", 200);
   const catalog = createFarmApiCatalog(input);
   return new Response(upperMethod === "HEAD" ? null : JSON.stringify(catalog), {
     status: 200,

package/dist/{chunk-OAVTUMJP.cjs → chunk-YXM74XOW.cjs}

@@ -7,7 +7,7 @@ var _chunkD7JTOLFKcjs = require('./chunk-D7JTOLFK.cjs');
 
 
 
-var _chunkIXTFU4PLcjs = require('./chunk-IXTFU4PL.cjs');
+var _chunkNL3ZSMZBcjs = require('./chunk-NL3ZSMZB.cjs');
 
 
 var _chunkLTNGXMQ6cjs = require('./chunk-LTNGXMQ6.cjs');
@@ -147,9 +147,9 @@ function useMutationLifecycle(target, options = {}) {
         };
       });
       const mutationTarget = targetRef.current;
-      const isAPITarget = _chunkIXTFU4PLcjs.isAPIRouteRef.call(void 0, mutationTarget);
+      const isAPITarget = _chunkNL3ZSMZBcjs.isAPIRouteRef.call(void 0, mutationTarget);
       const sharedOptimistic = !preparationFailed && !isAPITarget ? _optionalChain([currentOptions, 'access', _3 => _3.request, 'optionalAccess', _4 => _4.optimistic]) : void 0;
-      const sharedSnapshots = _optionalChain([sharedOptimistic, 'optionalAccess', _5 => _5.update, 'optionalAccess', _6 => _6.length]) ? _chunkIXTFU4PLcjs.applyServerFnOptimisticUpdates.call(void 0, sharedOptimistic.update) : [];
+      const sharedSnapshots = _optionalChain([sharedOptimistic, 'optionalAccess', _5 => _5.update, 'optionalAccess', _6 => _6.length]) ? _chunkNL3ZSMZBcjs.applyServerFnOptimisticUpdates.call(void 0, sharedOptimistic.update) : [];
       try {
         if (preparationFailed) throw preparationError;
         let data;
@@ -176,9 +176,9 @@ function useMutationLifecycle(target, options = {}) {
             throw cause;
           }
         }
-        _chunkIXTFU4PLcjs.settleServerFnOptimisticUpdates.call(void 0, sharedSnapshots, "commit");
+        _chunkNL3ZSMZBcjs.settleServerFnOptimisticUpdates.call(void 0, sharedSnapshots, "commit");
         if (!isAPITarget && _optionalChain([currentOptions, 'access', _9 => _9.request, 'optionalAccess', _10 => _10.invalidate])) {
-          for (const key of _chunkIXTFU4PLcjs.resolveServerFnInvalidateTargets.call(void 0, currentOptions.request.invalidate)) {
+          for (const key of _chunkNL3ZSMZBcjs.resolveServerFnInvalidateTargets.call(void 0, currentOptions.request.invalidate)) {
             _chunkZEG3OPIBcjs.notifyFarmCacheInvalidation.call(void 0, key);
           }
         }
@@ -213,7 +213,7 @@ function useMutationLifecycle(target, options = {}) {
         }
         return data;
       } catch (cause) {
-        _chunkIXTFU4PLcjs.settleServerFnOptimisticUpdates.call(void 0, 
+        _chunkNL3ZSMZBcjs.settleServerFnOptimisticUpdates.call(void 0, 
           sharedSnapshots,
           _optionalChain([sharedOptimistic, 'optionalAccess', _11 => _11.rollbackOnError]) ? "rollback" : "invalidate"
         );
@@ -389,7 +389,7 @@ function useFetcher(target, options = {}) {
   const Form = _react.useMemo.call(void 0, () => {
     const FetcherForm = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, ({ action, method, encType, onSubmit, ...props }) => {
       const targetValue = targetRef.current;
-      const metadata = _chunkIXTFU4PLcjs.getAPIRouteRefMetadata.call(void 0, targetValue);
+      const metadata = _chunkNL3ZSMZBcjs.getAPIRouteRefMetadata.call(void 0, targetValue);
       const nativeAction = _nullishCoalesce(action, () => ( resolveFetcherFormAction(targetValue, metadata)));
       const nativeMethod = _nullishCoalesce(method, () => ( (metadata && (metadata.method === "GET" || metadata.method === "POST") ? metadata.method.toLowerCase() : metadata ? "post" : void 0)));
       const functionAction = typeof nativeAction === "function";
@@ -458,10 +458,10 @@ function mapFetcherFormData(target, formData, options) {
   if (options.mapFormData) {
     return options.mapFormData(formData, context);
   }
-  if (!_chunkIXTFU4PLcjs.isAPIRouteRef.call(void 0, target)) {
+  if (!_chunkNL3ZSMZBcjs.isAPIRouteRef.call(void 0, target)) {
     return formData;
   }
-  const method = _optionalChain([_chunkIXTFU4PLcjs.getAPIRouteRefMetadata.call(void 0, target), 'optionalAccess', _14 => _14.method]);
+  const method = _optionalChain([_chunkNL3ZSMZBcjs.getAPIRouteRefMetadata.call(void 0, target), 'optionalAccess', _14 => _14.method]);
   const query = method === "GET" || method === "HEAD";
   const encoding = _nullishCoalesce(_optionalChain([context, 'access', _15 => _15.submitter, 'optionalAccess', _16 => _16.getAttribute, 'call', _17 => _17("formenctype")]), () => ( _optionalChain([context, 'access', _18 => _18.form, 'optionalAccess', _19 => _19.enctype])));
   if (!query && (_optionalChain([encoding, 'optionalAccess', _20 => _20.toLowerCase, 'call', _21 => _21()]) === "multipart/form-data" || Array.from(formData.values()).some((value) => typeof value !== "string"))) {