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

package/dist/{chunk-JF5CNHHF.mjs → chunk-CTM4SPB3.mjs}

@@ -71,7 +71,7 @@ import {
 } from "./chunk-N77JBPLC.mjs";
 import {
   resolveIntegrationPlugins
-} from "./chunk-HHFMECFO.mjs";
+} from "./chunk-Y2G5SJFB.mjs";
 import {
   compileMiddlewareConfig
 } from "./chunk-EDPENAVO.mjs";
@@ -565,29 +565,35 @@ async function resolveDocsConfig(userDocs, options = {}) {
       config: { entry: "docs", docsPath: "/docs" }
     };
   }
-  const inlineDocsConfig = sanitizeDocsConfig(docsOptions.config || {});
+  const fileDocsConfig = omitDocsRoots(loadedConfig?.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
+    configPath: void 0,
+    roots: void 0
   });
-  const loadedDocsConfig = sanitizeDocsConfig(loadedConfig?.config || {});
+  const loadedDocsConfig = sanitizeDocsConfig(fileDocsConfig);
   const mergedDocsConfig = {
     ...loadedDocsConfig,
     ...inlineDocsConfig,
     ...directDocsConfig
   };
   const runtimeDocsConfig = {
-    ...loadedConfig?.config || {},
-    ...isRecord(docsOptions.config) ? docsOptions.config : {},
+    ...fileDocsConfig,
+    ...inlineRawDocsConfig,
     ...omitUndefined({
       ...docsOptions,
       adapter: void 0,
       enabled: void 0,
+      prerender: void 0,
       config: void 0,
-      configPath: void 0
+      configPath: void 0,
+      roots: void 0
     })
   };
   const explicitRoute = typeof docsOptions.entry === "string" ? docsOptions.entry : void 0;
@@ -601,10 +607,33 @@ async function resolveDocsConfig(userDocs, options = {}) {
     docsOptions.contentDir || mergedDocsConfig.contentDir
   );
   const contentDir = configuredContentDir || await inferDocsContentDir(root, options.srcDir || "src", docsEntry);
+  const configOverrides = { ...inlineDocsConfig, ...directDocsConfig };
+  const configFileName = loadedConfig ? path3.relative(root, loadedConfig.configPath) || loadedConfig.configPath : "the docs config";
+  const roots = await resolveDocsRoots(
+    [
+      { field: `roots in ${configFileName}`, roots: docsRootsOf(loadedConfig?.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: loadedConfig?.configPath,
     config: {
@@ -619,9 +648,90 @@ async function resolveDocsConfig(userDocs, options = {}) {
       docsPath: entryRoute,
       ...contentDir ? { contentDir } : {}
     },
-    configOverrides: { ...inlineDocsConfig, ...directDocsConfig }
+    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 = 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()) {
     validateConfigRouteSource(redirect.source, `${field}[${index}].source`);
@@ -721,6 +831,10 @@ async function resolveConfig(userConfig, mode) {
     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 = normalizeFarmConfigBasePath(userConfig.basePath);
+  const mobileSessionPlugin = userConfig.mobile !== void 0 && userConfig.mobile !== null ? (await import("./session-IGEDQ5PY.mjs")).createFarmMobileSessionPlugin({
+    basePath,
+    integrations: () => integrations
+  }) : null;
   const openapi = {
     enabled: false,
     route: "/docs/reference",
@@ -772,6 +886,7 @@ async function resolveConfig(userConfig, mode) {
     agent: resolveFarmAgentConfig(userConfig.agent, { docs: docs.enabled }),
     desktop: desktopSetup?.desktop ?? null,
     plugins: [
+      ...mobileSessionPlugin ? [mobileSessionPlugin] : [],
       ...resolveIntegrationPlugins(integrations),
       ...nativeMCPPlugin ? [nativeMCPPlugin] : [],
       ...userConfig.plugins || []

package/dist/{chunk-WVX3BUNJ.mjs → chunk-CZ35L6PL.mjs}

@@ -407,6 +407,7 @@ async function collectSSGPages(routes, loadModule, options = {}) {
   const ssgPages = [];
   const ssrRoutes = [];
   const staticCandidateRoutes = [];
+  let staticCandidateDocsPages = 0;
   for (const route of routes) {
     try {
       const mod = await loadModule(route.filePath);
@@ -453,7 +454,8 @@ async function collectSSGPages(routes, loadModule, options = {}) {
       } else {
         ssrRoutes.push(route.path);
         if (options.suggestStaticRendering !== false && analyzeStaticRouteCandidate(mod, source, { isDynamic: route.isDynamic }).candidate) {
-          staticCandidateRoutes.push(route.path);
+          if (options.docsAdapterRoutes?.owns(route.path)) staticCandidateDocsPages += 1;
+          else staticCandidateRoutes.push(route.path);
         }
       }
     } catch (error) {
@@ -472,6 +474,11 @@ async function collectSSGPages(routes, loadModule, options = {}) {
 Add \`export const dynamic = "force-static";\` after verifying that imported code does not read cookies, headers, authentication, or other request data.`
     );
   }
+  if (staticCandidateDocsPages > 0 && !options.docsAdapterRoutes?.prerender) {
+    console.warn(
+      `[Farm.js] ${staticCandidateDocsPages} docs page${staticCandidateDocsPages === 1 ? " renders" : "s render"} on each request. Set \`docs.prerender: true\` in farm.config.ts to prerender docs pages on Node and serverless targets.`
+    );
+  }
   return { ssg: ssgPages, ssr: ssrRoutes };
 }
 function isSSGModule(mod) {