@farm.js/core 0.1.35 → 0.1.37

package/dist/{chunk-SAZVVAJH.mjs → chunk-WQ7T2263.mjs}

@@ -1,3 +1,6 @@
+import {
+  createFarmDevServerDispatch
+} from "./chunk-SGBZPZUW.mjs";
 import {
   _runWithAPIRequestRuntime
 } from "./chunk-R3DS7A2T.mjs";
@@ -6,10 +9,10 @@ import {
 } from "./chunk-IOEH4VWN.mjs";
 import {
   APIRouteConflictError
-} from "./chunk-22LTEMGQ.mjs";
+} from "./chunk-VXAWRDK7.mjs";
 import {
   findProgrammaticRouteFilesInDir
-} from "./chunk-UDNPLXW7.mjs";
+} from "./chunk-MYIZXDZA.mjs";
 import {
   isFarmAPIRouteFileName
 } from "./chunk-CU625VAY.mjs";
@@ -20,7 +23,7 @@ import {
   matchAPIRouteAtBasePath,
   mergePluginAPIRoutes,
   resolveAPIRouteEndpoint
-} from "./chunk-G5RT7EXW.mjs";
+} from "./chunk-HEVMCTSR.mjs";
 import {
   isProgrammaticRoutesFileName
 } from "./chunk-EA5K5BKU.mjs";
@@ -28,13 +31,13 @@ import {
   createFarmRequestBodyErrorResponse,
   readNodeRequestBody,
   resolveFarmServerConfig
-} from "./chunk-Y7RKTKYI.mjs";
+} from "./chunk-ZMMBIVQM.mjs";
 import {
   createCliColors
 } from "./chunk-I2BHUNBU.mjs";
 import {
   loadFarmDevModule
-} from "./chunk-43FMW62B.mjs";
+} from "./chunk-KMTGADN3.mjs";
 import {
   toPosixPath,
   toViteModuleId
@@ -44,7 +47,7 @@ import {
 } from "./chunk-Z2RZJZIZ.mjs";
 import {
   resolveFarmRequestURL
-} from "./chunk-FDR64H6B.mjs";
+} from "./chunk-3KGDJLJK.mjs";
 import {
   AmbiguousRouteError,
   assertUniqueRouteParameters,
@@ -65,6 +68,7 @@ function farmApiPlugin(options = {}) {
   let apiRoutesCache = /* @__PURE__ */ new Map();
   let apiRouterHandler = null;
   let projectRoot = process.cwd();
+  let devServer;
   let pluginMergedRoutes = null;
   const servedRoutes = /* @__PURE__ */ __name(() => pluginMergedRoutes ?? apiRoutesCache, "servedRoutes");
   let routePlugins;
@@ -187,7 +191,13 @@ function farmApiPlugin(options = {}) {
     const plugins = options.plugins ? await (routePlugins ?? (routePlugins = Promise.resolve(options.plugins({ root: projectRoot })))) : [];
     pluginMergedRoutes = plugins.length ? new Map(
       mergePluginAPIRoutes([...apiRoutesCache.values()], plugins, void 0, {
-        bodySizeLimit
+        bodySizeLimit,
+        // A plugin calling an app endpoint (an MCP tool, say) goes back through this server,
+        // so the middleware that guards the endpoint's path runs for it.
+        dispatch: /* @__PURE__ */ __name((request) => {
+          if (!devServer) throw new Error("The Farm API dev server is not running.");
+          return createFarmDevServerDispatch(devServer)(request);
+        }, "dispatch")
       }).map((route) => [route.path, route])
     ) : null;
     const totalEndpoints = Array.from(servedRoutes().values()).reduce(
@@ -235,6 +245,7 @@ function farmApiPlugin(options = {}) {
     enforce: "pre",
     configureServer(server) {
       projectRoot = server.config.root;
+      devServer = server;
       const discoverFileRoutes = /* @__PURE__ */ __name(async (apiDir) => {
         const fs = await import("fs");
         const path = await import("path");

package/dist/chunk-WRPHYQVY.mjs

@@ -0,0 +1,109 @@
+import {
+  matchSegmentParts,
+  normalizePathname,
+  parseRoutePattern,
+  splitNormalizedPathname
+} from "./chunk-OT6ZEW74.mjs";
+import {
+  getRouteGroupScope,
+  isInRouteGroupScope
+} from "./chunk-LBGILORX.mjs";
+import {
+  __name
+} from "./chunk-LPEX4YW6.mjs";
+
+// src/nitro/native-mcp-source.ts
+function generateNativeMCPPluginSource(mcp) {
+  if (mcp?.enabled !== true) {
+    return { importSource: "", registerSource: "", pluginSource: "" };
+  }
+  return {
+    importSource: `import { createFarmMCPPlugin as __farmCreateMCPPlugin } from "@farm.js/mcp/internal";`,
+    registerSource: `function __farmMCPIsPlainObject(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+
+function __farmMergeMCPConfig(base, override) {
+  const output = { ...base };
+  for (const [key, value] of Object.entries(override)) {
+    if (value === undefined) continue;
+    output[key] =
+      __farmMCPIsPlainObject(output[key]) && __farmMCPIsPlainObject(value)
+        ? __farmMergeMCPConfig(output[key], value)
+        : value;
+  }
+  return output;
+}
+
+const farmNativeMCPConfig = farmRuntimeConfigs.reduce((merged, runtimeConfig) => {
+  const value = runtimeConfig?.mcp;
+  if (value === undefined) return merged;
+  if (value === false) return false;
+  return __farmMergeMCPConfig(merged && merged !== false ? merged : {}, value);
+}, undefined);
+const farmNativeMCPPlugin =
+  farmNativeMCPConfig && farmNativeMCPConfig.enabled !== false
+    ? __farmCreateMCPPlugin(farmNativeMCPConfig)
+    : null;`,
+    pluginSource: `...(farmNativeMCPPlugin ? [farmNativeMCPPlugin] : []),`
+  };
+}
+__name(generateNativeMCPPluginSource, "generateNativeMCPPluginSource");
+
+// src/routing/layout-selector.ts
+function createFarmLayoutSelector(layouts, resolveRouteDirectory) {
+  const prepared = layouts.map((layout) => {
+    const segments = layout.pattern === "/" ? [] : parseRoutePattern(layout.pattern);
+    return {
+      layout,
+      segments: segments.length === 0 ? null : segments,
+      groupScope: getRouteGroupScope(layout.pattern)
+    };
+  });
+  return (pathname, routeDirectory) => {
+    const applicable = [];
+    let parts;
+    let directory = routeDirectory;
+    for (const { layout, segments, groupScope } of prepared) {
+      if (segments !== null) {
+        parts ?? (parts = splitNormalizedPathname(normalizePathname(pathname.replace(/\/$/, "") || "/")));
+        if (matchSegmentParts(segments, parts, true) === null) continue;
+      }
+      if (groupScope !== null) {
+        if (directory === void 0) directory = resolveRouteDirectory?.(pathname) ?? null;
+        if (!isInRouteGroupScope(directory, groupScope)) continue;
+      }
+      applicable.push(layout);
+    }
+    return applicable;
+  };
+}
+__name(createFarmLayoutSelector, "createFarmLayoutSelector");
+function layoutsCanCoverSamePage(a, b) {
+  const scopeA = getRouteGroupScope(a);
+  const scopeB = getRouteGroupScope(b);
+  if (scopeA !== null && scopeB !== null && !isInRouteGroupScope(scopeA, scopeB) && !isInRouteGroupScope(scopeB, scopeA)) {
+    return false;
+  }
+  const segmentsA = a === "/" ? [] : parseRoutePattern(a);
+  const segmentsB = b === "/" ? [] : parseRoutePattern(b);
+  const length = Math.min(segmentsA.length, segmentsB.length);
+  for (let index = 0; index < length; index++) {
+    const segmentA = segmentsA[index];
+    const segmentB = segmentsB[index];
+    if (segmentA.type === "dynamic" && segmentA.catchAll) return true;
+    if (segmentB.type === "dynamic" && segmentB.catchAll) return true;
+    if (segmentA.type === "dynamic" || segmentB.type === "dynamic") continue;
+    if (segmentA.value !== segmentB.value) return false;
+  }
+  return true;
+}
+__name(layoutsCanCoverSamePage, "layoutsCanCoverSamePage");
+
+export {
+  generateNativeMCPPluginSource,
+  createFarmLayoutSelector,
+  layoutsCanCoverSamePage
+};

package/dist/chunk-WT4TGLXT.cjs

@@ -0,0 +1,109 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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 _chunkPCOTGFSMcjs = require('./chunk-PCOTGFSM.cjs');
+
+
+
+var _chunkLOFKRKO7cjs = require('./chunk-LOFKRKO7.cjs');
+
+
+var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+
+// src/nitro/native-mcp-source.ts
+function generateNativeMCPPluginSource(mcp) {
+  if (_optionalChain([mcp, 'optionalAccess', _ => _.enabled]) !== true) {
+    return { importSource: "", registerSource: "", pluginSource: "" };
+  }
+  return {
+    importSource: `import { createFarmMCPPlugin as __farmCreateMCPPlugin } from "@farm.js/mcp/internal";`,
+    registerSource: `function __farmMCPIsPlainObject(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+
+function __farmMergeMCPConfig(base, override) {
+  const output = { ...base };
+  for (const [key, value] of Object.entries(override)) {
+    if (value === undefined) continue;
+    output[key] =
+      __farmMCPIsPlainObject(output[key]) && __farmMCPIsPlainObject(value)
+        ? __farmMergeMCPConfig(output[key], value)
+        : value;
+  }
+  return output;
+}
+
+const farmNativeMCPConfig = farmRuntimeConfigs.reduce((merged, runtimeConfig) => {
+  const value = runtimeConfig?.mcp;
+  if (value === undefined) return merged;
+  if (value === false) return false;
+  return __farmMergeMCPConfig(merged && merged !== false ? merged : {}, value);
+}, undefined);
+const farmNativeMCPPlugin =
+  farmNativeMCPConfig && farmNativeMCPConfig.enabled !== false
+    ? __farmCreateMCPPlugin(farmNativeMCPConfig)
+    : null;`,
+    pluginSource: `...(farmNativeMCPPlugin ? [farmNativeMCPPlugin] : []),`
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, generateNativeMCPPluginSource, "generateNativeMCPPluginSource");
+
+// src/routing/layout-selector.ts
+function createFarmLayoutSelector(layouts, resolveRouteDirectory) {
+  const prepared = layouts.map((layout) => {
+    const segments = layout.pattern === "/" ? [] : _chunkPCOTGFSMcjs.parseRoutePattern.call(void 0, layout.pattern);
+    return {
+      layout,
+      segments: segments.length === 0 ? null : segments,
+      groupScope: _chunkLOFKRKO7cjs.getRouteGroupScope.call(void 0, layout.pattern)
+    };
+  });
+  return (pathname, routeDirectory) => {
+    const applicable = [];
+    let parts;
+    let directory = routeDirectory;
+    for (const { layout, segments, groupScope } of prepared) {
+      if (segments !== null) {
+        _nullishCoalesce(parts, () => ( (parts = _chunkPCOTGFSMcjs.splitNormalizedPathname.call(void 0, _chunkPCOTGFSMcjs.normalizePathname.call(void 0, pathname.replace(/\/$/, "") || "/")))));
+        if (_chunkPCOTGFSMcjs.matchSegmentParts.call(void 0, segments, parts, true) === null) continue;
+      }
+      if (groupScope !== null) {
+        if (directory === void 0) directory = _nullishCoalesce(_optionalChain([resolveRouteDirectory, 'optionalCall', _2 => _2(pathname)]), () => ( null));
+        if (!_chunkLOFKRKO7cjs.isInRouteGroupScope.call(void 0, directory, groupScope)) continue;
+      }
+      applicable.push(layout);
+    }
+    return applicable;
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createFarmLayoutSelector, "createFarmLayoutSelector");
+function layoutsCanCoverSamePage(a, b) {
+  const scopeA = _chunkLOFKRKO7cjs.getRouteGroupScope.call(void 0, a);
+  const scopeB = _chunkLOFKRKO7cjs.getRouteGroupScope.call(void 0, b);
+  if (scopeA !== null && scopeB !== null && !_chunkLOFKRKO7cjs.isInRouteGroupScope.call(void 0, scopeA, scopeB) && !_chunkLOFKRKO7cjs.isInRouteGroupScope.call(void 0, scopeB, scopeA)) {
+    return false;
+  }
+  const segmentsA = a === "/" ? [] : _chunkPCOTGFSMcjs.parseRoutePattern.call(void 0, a);
+  const segmentsB = b === "/" ? [] : _chunkPCOTGFSMcjs.parseRoutePattern.call(void 0, b);
+  const length = Math.min(segmentsA.length, segmentsB.length);
+  for (let index = 0; index < length; index++) {
+    const segmentA = segmentsA[index];
+    const segmentB = segmentsB[index];
+    if (segmentA.type === "dynamic" && segmentA.catchAll) return true;
+    if (segmentB.type === "dynamic" && segmentB.catchAll) return true;
+    if (segmentA.type === "dynamic" || segmentB.type === "dynamic") continue;
+    if (segmentA.value !== segmentB.value) return false;
+  }
+  return true;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, layoutsCanCoverSamePage, "layoutsCanCoverSamePage");
+
+
+
+
+
+exports.generateNativeMCPPluginSource = generateNativeMCPPluginSource; exports.createFarmLayoutSelector = createFarmLayoutSelector; exports.layoutsCanCoverSamePage = layoutsCanCoverSamePage;

package/dist/{chunk-SOMHP6GF.mjs → chunk-XOPOIFTJ.mjs}

@@ -3,14 +3,14 @@ import {
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-PDOCJ6RY.mjs";
+} from "./chunk-O6WAEAX3.mjs";
 import {
   docsEngine,
   loadFarmDocsEngine
 } from "./chunk-2VQKKQ6D.mjs";
 import {
   resolveDocsConfig
-} from "./chunk-6DU6UFUE.mjs";
+} from "./chunk-EXG5LD6B.mjs";
 import {
   getFarmDocsAdapterConfigModule,
   isSecretDocsConfigKey

package/dist/{chunk-3PXS2MHU.mjs → chunk-YCKO6FRS.mjs}

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.1.35";
+var version = "0.1.37";
 
 // src/version.ts
 var FARM_VERSION = version;

package/dist/{chunk-C35ZBVRD.mjs → chunk-YWMZUGIS.mjs}

@@ -67,6 +67,7 @@ function isolateFarmServerPageGraph(ReactRuntime, element) {
   return ReactRuntime.createElement(Context.Provider, { value: false }, element);
 }
 __name(isolateFarmServerPageGraph, "isolateFarmServerPageGraph");
+var warnedUnserializableBoundaries = /* @__PURE__ */ new Set();
 function createFarmIsolatedClientBoundary(ReactRuntime, Component, moduleReference, exportName, islandStrategy) {
   function FarmIsolatedClientBoundary(props) {
     const Context = getBoundaryGraphContext(ReactRuntime);
@@ -79,9 +80,12 @@ function createFarmIsolatedClientBoundary(ReactRuntime, Component, moduleReferen
     try {
       serializedProps = serializeBoundaryPayload(props);
     } catch (error) {
-      if (typeof window === "undefined") {
+      const message = error instanceof Error ? error.message : String(error);
+      const warningKey = `${moduleReference}#${exportName}:${message}`;
+      if (typeof window === "undefined" && !warnedUnserializableBoundaries.has(warningKey)) {
+        warnedUnserializableBoundaries.add(warningKey);
         console.warn(
-          `[Farm.js] Could not isolate ${moduleReference}#${exportName}: ${error instanceof Error ? error.message : String(error)}. The server-rendered component was preserved without client hydration.`
+          `[Farm.js] Could not isolate ${moduleReference}#${exportName}: ${message}. The server-rendered component was preserved without client hydration.`
         );
       }
       return ReactRuntime.createElement(Component, props);

package/dist/{chunk-HMIJDL7S.mjs → chunk-Z5BEWYVO.mjs}

@@ -4,7 +4,7 @@ import {
 import {
   compileMiddlewareConfig,
   matchesCompiledMiddlewareConfig
-} from "./chunk-JG6DJF5A.mjs";
+} from "./chunk-HZFM2LWQ.mjs";
 import {
   bufferFarmRequestBody,
   clearRequestContext,
@@ -16,11 +16,15 @@ import {
   readNodeRequestBody,
   resolveFarmServerConfig,
   setRequestContext
-} from "./chunk-Y7RKTKYI.mjs";
+} from "./chunk-ZMMBIVQM.mjs";
 import {
   applyWebResponseHeaders,
   sendWebResponse
 } from "./chunk-Z2RZJZIZ.mjs";
+import {
+  createFarmAPIMiddlewarePathnames,
+  resolveFarmAPIServerBasePath
+} from "./chunk-BTHHUD7Q.mjs";
 import {
   api,
   defineIntegrationAPIOperation
@@ -1577,10 +1581,12 @@ async function dispatchIntegrationRequest(runtime, request, options = {}) {
   const middleware = [...integration.middleware || []];
   const forwardedSetCookies = [];
   for (const entry of middleware) {
+    if (options.ranMiddleware?.has(entry)) continue;
     const params = resolveIntegrationMiddlewareParams(entry, pathname, runtime.config);
     if (!params) {
       continue;
     }
+    options.ranMiddleware?.add(entry);
     const handlerContext = createServerIntegrationHandlerContext({
       runtime,
       route: {
@@ -1845,6 +1851,7 @@ async function dispatchIntegrationRequests(integrations, runtime, request, optio
       request.clone(),
       {
         currentRequest: options.currentRequest,
+        ranMiddleware: options.ranMiddleware,
         onForwardedCookies: /* @__PURE__ */ __name((cookies) => setCookies.push(...cookies), "onForwardedCookies")
       }
     );
@@ -2006,8 +2013,10 @@ function resolveIntegrationMiddlewareParams(entry, pathname, config) {
   const params = resolveMatcherParams(entry.matcher, pathname);
   if (params || !entry.matcher) return params;
   const routePathname = resolveIntegrationRoutePathname(pathname, config);
-  if (routePathname !== pathname) {
-    const routeParams = resolveMatcherParams(entry.matcher, routePathname);
+  const candidates = [.../* @__PURE__ */ new Set([pathname, ...getIntegrationAPIPathnames(config)(routePathname)])];
+  for (const candidate of candidates) {
+    if (candidate === pathname) continue;
+    const routeParams = resolveMatcherParams(entry.matcher, candidate);
     if (routeParams) return routeParams;
   }
   let compiled = compiledIntegrationGuards.get(entry);
@@ -2017,13 +2026,28 @@ function resolveIntegrationMiddlewareParams(entry, pathname, config) {
     });
     compiledIntegrationGuards.set(entry, compiled);
   }
-  for (const candidate of routePathname === pathname ? [pathname] : [pathname, routePathname]) {
+  for (const candidate of candidates) {
     const result = matchesCompiledMiddlewareConfig(candidate, compiled, noMiddlewareContext);
     if (result.matched) return result.params ?? {};
   }
   return null;
 }
 __name(resolveIntegrationMiddlewareParams, "resolveIntegrationMiddlewareParams");
+var FARM_INTEGRATION_API_BASE_PATH_KEY = "__farmAPIServerBasePath";
+var integrationAPIPathnames = /* @__PURE__ */ new WeakMap();
+function getIntegrationAPIPathnames(config) {
+  if (!config) return (pathname) => [pathname];
+  let toPathnames = integrationAPIPathnames.get(config);
+  if (!toPathnames) {
+    const recorded = config[FARM_INTEGRATION_API_BASE_PATH_KEY];
+    const api2 = config.api;
+    const serverBasePath = typeof recorded === "string" ? recorded : typeof api2?.baseURL === "string" && typeof api2.basePath === "string" ? resolveFarmAPIServerBasePath(api2) : void 0;
+    toPathnames = createFarmAPIMiddlewarePathnames(serverBasePath);
+    integrationAPIPathnames.set(config, toPathnames);
+  }
+  return toPathnames;
+}
+__name(getIntegrationAPIPathnames, "getIntegrationAPIPathnames");
 function resolveIntegrationRoutePathname(pathname, config) {
   const basePath = typeof config?.basePath === "string" ? config.basePath : void 0;
   let routePathname = basePath ? stripFarmBasePath(pathname, basePath) : pathname;
@@ -2158,5 +2182,6 @@ export {
   matchRegisteredIntegrationRoute,
   getRegisteredIntegrationAPIManifest,
   dispatchIntegrationRequest,
-  dispatchIntegrationRequests
+  dispatchIntegrationRequests,
+  FARM_INTEGRATION_API_BASE_PATH_KEY
 };

package/dist/{chunk-OKZUAXHF.mjs → chunk-Z7LA7MHQ.mjs}

@@ -27,7 +27,7 @@ import {
 } from "./chunk-ZMSZZXOR.mjs";
 import {
   getIntegrationSchemas
-} from "./chunk-HMIJDL7S.mjs";
+} from "./chunk-Z5BEWYVO.mjs";
 import {
   __name
 } from "./chunk-LPEX4YW6.mjs";

package/dist/{chunk-Y7RKTKYI.mjs → chunk-ZMMBIVQM.mjs}

@@ -118,6 +118,15 @@ var DEFAULT_FARM_SERVER_REQUEST_TIMEOUT = 3e5;
 var DEFAULT_FARM_SERVER_KEEP_ALIVE_TIMEOUT = 5e3;
 var DEFAULT_FARM_SERVER_GRACEFUL_SHUTDOWN_TIMEOUT = 3e4;
 var MAX_FARM_SERVER_TIMEOUT = 2147483647;
+function createFarmWeakETag(body) {
+  let hash = 2166136261;
+  for (let index = 0; index < body.length; index++) {
+    hash ^= body.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return `W/"${(hash >>> 0).toString(16).padStart(8, "0")}"`;
+}
+__name(createFarmWeakETag, "createFarmWeakETag");
 function matchesFarmIfNoneMatch(value, etag) {
   const expected = parseEntityTag(trimOptionalWhitespace(etag));
   if (!expected) return false;
@@ -483,6 +492,7 @@ export {
   copyRequestContext,
   createFarmNodeRequestAbortSignal,
   DEFAULT_FARM_SERVER_BODY_SIZE_LIMIT,
+  createFarmWeakETag,
   matchesFarmIfNoneMatch,
   resolveFarmServerConfig,
   parseBodySizeLimit,