@farm.js/core 0.1.51-beta.0 → 0.1.51-beta.2

package/dist/{chunk-IOUOGRDX.cjs → chunk-5N7QAGEA.cjs}

@@ -651,16 +651,34 @@ function resolveFarmDocsContentDir(docs, options) {
   if (_fs.existsSync.call(void 0, appDocsDir)) return appDocsDir;
   return _path2.default.join(root, entryDir);
 }
+function getFarmDocsRoots(docs) {
+  return [
+    docs,
+    ...(_nullishCoalesce(docs.roots, () => ( []))).map((root) => ({
+      ...docs,
+      entry: root.entry,
+      contentDir: root.contentDir,
+      config: root.config,
+      runtimeConfig: root.runtimeConfig,
+      configOverrides: root.configOverrides,
+      roots: void 0
+    }))
+  ];
+}
 function getFarmDocsRouteTypeEntries(docs) {
   if (!_optionalChain([docs, 'optionalAccess', _44 => _44.enabled])) return [];
-  const entry = normalizeEntry2(docs.entry);
-  if (entry === "/") return ["/", "/[...docs]"];
-  return [entry, `${entry}/[...docs]`];
+  return getFarmDocsRoots(docs).flatMap((root) => {
+    const entry = normalizeEntry2(root.entry);
+    if (entry === "/") return ["/", "/[...docs]"];
+    return [entry, `${entry}/[...docs]`];
+  });
 }
 function getFarmDocsDocumentNavigationMatchers(docs) {
   if (!_optionalChain([docs, 'optionalAccess', _45 => _45.enabled])) return [];
-  const entry = normalizeEntry2(docs.entry);
-  return [entry === "/" ? "/(.*)" : `${entry}(.*)`];
+  return getFarmDocsRoots(docs).map((root) => {
+    const entry = normalizeEntry2(root.entry);
+    return entry === "/" ? "/(.*)" : `${entry}(.*)`;
+  });
 }
 function getRequestSlug(docs, request) {
   const pathname = new URL(request.url).pathname;
@@ -1928,4 +1946,5 @@ function createFarmDocsHandler(docs, options) {
 
 
 
-exports.FARM_DOCS_LAST_MODIFIED_MANIFEST = FARM_DOCS_LAST_MODIFIED_MANIFEST; exports.createFarmDocsLastModifiedManifest = createFarmDocsLastModifiedManifest; exports.isFarmDocsRequest = isFarmDocsRequest; exports.resolveFarmDocsContentDir = resolveFarmDocsContentDir; exports.getFarmDocsRouteTypeEntries = getFarmDocsRouteTypeEntries; exports.getFarmDocsDocumentNavigationMatchers = getFarmDocsDocumentNavigationMatchers; exports.loadFarmDocsPage = loadFarmDocsPage; exports.getFarmDocsMarkdownPath = getFarmDocsMarkdownPath; exports.discoverFarmDocsPages = discoverFarmDocsPages; exports.toFarmDocsMarkdownPage = toFarmDocsMarkdownPage; exports.createFarmDocsHandler = createFarmDocsHandler;
+
+exports.FARM_DOCS_LAST_MODIFIED_MANIFEST = FARM_DOCS_LAST_MODIFIED_MANIFEST; exports.createFarmDocsLastModifiedManifest = createFarmDocsLastModifiedManifest; exports.isFarmDocsRequest = isFarmDocsRequest; exports.resolveFarmDocsContentDir = resolveFarmDocsContentDir; exports.getFarmDocsRoots = getFarmDocsRoots; exports.getFarmDocsRouteTypeEntries = getFarmDocsRouteTypeEntries; exports.getFarmDocsDocumentNavigationMatchers = getFarmDocsDocumentNavigationMatchers; exports.loadFarmDocsPage = loadFarmDocsPage; exports.getFarmDocsMarkdownPath = getFarmDocsMarkdownPath; exports.discoverFarmDocsPages = discoverFarmDocsPages; exports.toFarmDocsMarkdownPage = toFarmDocsMarkdownPage; exports.createFarmDocsHandler = createFarmDocsHandler;

package/dist/{chunk-DGOLAZLV.cjs → chunk-65Y5SIBH.cjs}

@@ -15,7 +15,7 @@ function farmDesktopDevGuardPlugin(basePath) {
       order: "pre",
       async handler(server) {
         if (_chunkAQLHD6HZcjs.resolveFarmPlatform.call(void 0, ) !== "desktop") return;
-        const { createFarmDesktopDevGuard } = await import("./dev-guard-YLO5DE3H.cjs");
+        const { createFarmDesktopDevGuard } = await import("./dev-guard-2UW2KERP.cjs");
         server.middlewares.use(createFarmDesktopDevGuard(server, { basePath: basePath || "" }));
       }
     }

package/dist/{chunk-ZF3GX4O7.mjs → chunk-6CYQQQGR.mjs}

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.1.51-beta.0";
+var version = "0.1.51-beta.2";
 
 // src/version.ts
 var FARM_VERSION = version;

package/dist/{chunk-QI5AQMEE.mjs → chunk-72NBDVWQ.mjs}

@@ -40,7 +40,7 @@ import {
 } from "./chunk-Y3N5BFRJ.mjs";
 import {
   sendWebResponse
-} from "./chunk-IUQLRTTO.mjs";
+} from "./chunk-CO6UYM2D.mjs";
 import {
   createFarmRequestBodyErrorResponse,
   readNodeRequestBody,

package/dist/{chunk-I2ZA5SXS.mjs → chunk-74Z5KX4A.mjs}

@@ -2,7 +2,7 @@ import {
   createFarmReactRefreshPlugins,
   farmDesktopDevGuardPlugin,
   isFarmReactRefreshActive
-} from "./chunk-75WWOZ5C.mjs";
+} from "./chunk-QOSDWGKT.mjs";
 import {
   createFarmServerFnBoundaryModule,
   isFarmServerFnBoundaryId,
@@ -37,7 +37,7 @@ import {
   resolveFarmIsolatedClientHydrationMode,
   resolveModuleSourcePath,
   stripUseClientDirective
-} from "./chunk-S5ZA2T2W.mjs";
+} from "./chunk-PMKUU273.mjs";
 import {
   loadTailwindVitePlugin
 } from "./chunk-PIHKO25G.mjs";
@@ -50,7 +50,7 @@ import {
 import {
   generateFarmTypeArtifacts,
   resolveRouteRenderingConfig
-} from "./chunk-WVX3BUNJ.mjs";
+} from "./chunk-CZ35L6PL.mjs";
 import {
   createFarmRouteRenderPlan,
   farmPathGuardCoversEndpoint,
@@ -79,7 +79,7 @@ import {
   resolveFarmMCPRouteLabel,
   resolveFarmMarkdownRouteLabel,
   setFarmRouteLabel
-} from "./chunk-R5P4KFPM.mjs";
+} from "./chunk-E73PGHSR.mjs";
 import {
   FARM_DEFAULT_MCP_PATH
 } from "./chunk-KRRZJ77U.mjs";
@@ -87,10 +87,13 @@ import {
   resolveFarmLayoutFonts
 } from "./chunk-HZOMT5DY.mjs";
 import {
+  farmBrowserBuiltinsOptimizerPlugin,
   farmEnvironmentFunctionsPlugin,
   generateProgrammaticClientRouteModule,
-  programmaticClientRouteKey
-} from "./chunk-C5JXCUKR.mjs";
+  loadFarmBrowserBuiltin,
+  programmaticClientRouteKey,
+  resolveFarmBrowserBuiltin
+} from "./chunk-ZQ5BDNKW.mjs";
 import {
   createFarmMarkdownSourceResponse,
   isFarmMarkdownPageFile,
@@ -161,10 +164,10 @@ import {
   getIntegrationDocumentNavigationMatchers,
   getIntegrationProviders,
   matchIntegrationRoute
-} from "./chunk-HHFMECFO.mjs";
+} from "./chunk-Y2G5SJFB.mjs";
 import {
   MiddlewareManager
-} from "./chunk-WSY2JD7O.mjs";
+} from "./chunk-NN3MOPSI.mjs";
 import {
   _runWithMiddlewareContext,
   _runWithMiddlewareData
@@ -226,8 +229,9 @@ import {
 } from "./chunk-2DA7CLY7.mjs";
 import {
   applyWebResponseHeaders,
+  fetchFarmExternalRewrite,
   sendWebResponse
-} from "./chunk-IUQLRTTO.mjs";
+} from "./chunk-CO6UYM2D.mjs";
 import {
   createFarmNodeRequestAbortSignal,
   createFarmNodeRequestBodyStream,
@@ -240,7 +244,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-ZF3GX4O7.mjs";
+} from "./chunk-6CYQQQGR.mjs";
 import {
   DEFAULT_FARM_API_BASE_PATH
 } from "./chunk-BLD5GVCG.mjs";
@@ -295,6 +299,7 @@ function transformFarmFormActionModule(options) {
 
 // src/vite.ts
 import { parseSync } from "vite";
+import { isBuiltin } from "module";
 
 // src/dev-preview-guard.ts
 import { promises as fsp } from "fs";
@@ -595,7 +600,7 @@ function formatClientBoundaryWarning(id, findings) {
   }
   if (builtinImports.length > 0) {
     lines.push(
-      `- import of ${builtinImports.join(", ")} \u2014 stubbed with an empty object in the browser. Move the import into server-only code.`
+      `- import of ${builtinImports.join(", ")} \u2014 stubbed in the browser, where exports without a Web API equivalent are undefined. Move the import into server-only code.`
     );
   }
   return lines.join("\n");
@@ -760,7 +765,7 @@ function loadFarmWorkflowsDevRuntime() {
   return import("./workflows.mjs");
 }
 function loadFarmDevtoolsSnapshotRuntime() {
-  return import("./devtools-4MLL3RAL.mjs");
+  return import("./devtools-UQLDAOEI.mjs");
 }
 function loadFarmDevtoolsUIRuntime() {
   return import("./devtools-ui-CYBVFLPH.mjs");
@@ -800,11 +805,19 @@ function farmServerOnlyEntriesPlugin() {
   return {
     name: "farm:server-only-entries",
     enforce: "pre",
+    config() {
+      return {
+        optimizeDeps: { rolldownOptions: { plugins: [farmBrowserBuiltinsOptimizerPlugin()] } }
+      };
+    },
     configResolved(config) {
       root = config.root;
     },
     resolveId(id, importer, options) {
       if (id === FARM_PLATFORM_ENTRY) return options?.ssr ? null : FARM_PLATFORM_CLIENT_ID;
+      if (!options?.ssr && isBuiltin(id)) {
+        return resolveFarmBrowserBuiltin(this, id, importer, options);
+      }
       if (!FARM_SERVER_ONLY_ENTRIES.has(id)) return null;
       const importedBy = importer ? ` (imported by ${importer})` : "";
       if (!options?.ssr) {
@@ -821,7 +834,8 @@ function farmServerOnlyEntriesPlugin() {
       return null;
     },
     load(id) {
-      return id === FARM_PLATFORM_CLIENT_ID ? createFarmPlatformClientModule() : null;
+      if (id === FARM_PLATFORM_CLIENT_ID) return createFarmPlatformClientModule();
+      return loadFarmBrowserBuiltin(id) ?? null;
     }
   };
 }
@@ -904,6 +918,17 @@ function withFarmRequestTracing(handler, apiRuntime, resolveTraceUrl = (request)
     });
   };
 }
+async function proxyFarmExternalRewrite(req, res, bodySizeLimit) {
+  const destination = req.url;
+  if (!destination || !/^https?:\/\//i.test(destination)) return false;
+  let request = createRequestFromNodeRequest(req, new URL(destination));
+  if (request.method !== "GET" && request.method !== "HEAD") {
+    const body = await readNodeRequestBody(req, bodySizeLimit);
+    request = new Request(request, { body: toRequestBody(body) });
+  }
+  await sendWebResponse(res, await fetchFarmExternalRewrite(request));
+  return true;
+}
 function toRequestBody(body) {
   if (!body) return void 0;
   const copy = new Uint8Array(body.byteLength);
@@ -1193,10 +1218,12 @@ function rewriteEarlySsrRelativeImports(options) {
     const sourcePath = suffixIndex === -1 ? source.value : source.value.slice(0, suffixIndex);
     const suffix = suffixIndex === -1 ? "" : source.value.slice(suffixIndex);
     const resolvedPath = path5.resolve(path5.dirname(cleanId), sourcePath);
+    const moduleId = toViteModuleId(resolvedPath, options.root);
+    const specifier = moduleId.startsWith("/@fs/") ? toPosixPath(resolvedPath) : moduleId;
     replacements.push({
       start: source.start,
       end: source.end,
-      code: JSON.stringify(`${toViteModuleId(resolvedPath, options.root)}${suffix}`)
+      code: JSON.stringify(`${specifier}${suffix}`)
     });
   });
   if (replacements.length === 0) return null;
@@ -2295,7 +2322,10 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                   computed: docsResponse,
                   label: resolveFarmDocsEngineRouteLabel(
                     stripFarmBasePath(requestPathname, farmConfig.basePath),
-                    { path: farmConfig.docs?.entry || "/docs" }
+                    {
+                      path: farmConfig.docs?.entry || "/docs",
+                      roots: farmConfig.docs?.roots?.map((root) => root.entry)
+                    }
                   )
                 }
               );
@@ -2569,7 +2599,7 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                   await pm.runHookParallel("beforeRequest", req, res);
                 }
               }
-              if (res.writableEnded) {
+              if (res.writableEnded || await proxyFarmExternalRewrite(req, res, currentServerConfig.bodySizeLimit)) {
                 const duration2 = Date.now() - startTime2;
                 logResponse(method2, urlPath2, res.statusCode || 200, duration2, "API");
                 return;
@@ -2729,7 +2759,8 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                   route: setFarmRouteLabel(
                     { pathname: pathname2, pattern: apiLifecyclePayload.routePath },
                     resolveFarmDocsRouteLabel(pathname2, {
-                      path: farmConfig.docs?.entry || "/docs"
+                      path: farmConfig.docs?.entry || "/docs",
+                      roots: farmConfig.docs?.roots?.map((root) => root.entry)
                     })
                   )
                 }) : await invokeDocsAPIHandler(request);
@@ -3247,7 +3278,7 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                 }
               }
             }
-            if (res.writableEnded || responseInterceptor?.isEnded()) {
+            if (res.writableEnded || responseInterceptor?.isEnded() || await proxyFarmExternalRewrite(req, res, currentServerConfig.bodySizeLimit)) {
               if (!responseInterceptor?.isEnded()) {
                 const duration = Date.now() - startTime;
                 logResponse(method, urlPath, res.statusCode || 200, duration, "PAGE");
@@ -5711,7 +5742,10 @@ function farmIslandsOnlyDocument() {
   const rootContainer = document.getElementById('root')
   
   if (!rootContainer) {
-    console.error('[Farm.js] Root container not found')
+    // A document Farm did not render as a page (the docs renderer's) has nothing to hydrate.
+    if (window.__FARM_PAGE_MODULE__ !== undefined) {
+      console.error('[Farm.js] Root container not found')
+    }
     return
   }