@farm.js/core 0.1.31 → 0.1.35

package/dist/{chunk-4IEPYMHF.mjs → chunk-3UEVPCGW.mjs}

@@ -1,6 +1,6 @@
 import {
   applyFarmCacheInvalidationTargets
-} from "./chunk-IV6CQY7O.mjs";
+} from "./chunk-MSSFIQGM.mjs";
 import {
   isMultipartSchema
 } from "./chunk-EMLAPBEM.mjs";

package/dist/{chunk-MXDTKXO6.cjs → chunk-3UH7MRCP.cjs}

@@ -3,17 +3,18 @@
 
 
 
-var _chunk2FXWWUE5cjs = require('./chunk-2FXWWUE5.cjs');
+var _chunkVZJR7UTGcjs = require('./chunk-VZJR7UTG.cjs');
 
 
 
 var _chunkIK6LVLKCcjs = require('./chunk-IK6LVLKC.cjs');
 
 
-var _chunkDFLLARUKcjs = require('./chunk-DFLLARUK.cjs');
+var _chunkF7JZENPFcjs = require('./chunk-F7JZENPF.cjs');
 
 
-var _chunk75WGQVQAcjs = require('./chunk-75WGQVQA.cjs');
+
+var _chunkHITLGIAOcjs = require('./chunk-HITLGIAO.cjs');
 
 
 var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
@@ -27,7 +28,7 @@ function hasFarmDocsRuntimeAdapter(docs) {
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, hasFarmDocsRuntimeAdapter, "hasFarmDocsRuntimeAdapter");
 async function loadFarmDocsConfigModule(docs, loadModule) {
-  const configModule = _chunk75WGQVQAcjs.getFarmDocsAdapterConfigModule.call(void 0, docs);
+  const configModule = _chunkHITLGIAOcjs.getFarmDocsAdapterConfigModule.call(void 0, docs);
   if (!configModule) return void 0;
   const loaded = await loadModule(configModule);
   const config = _nullishCoalesce(_optionalChain([loaded, 'optionalAccess', _4 => _4.default]), () => ( loaded));
@@ -39,7 +40,7 @@ function createFarmDocsAdapterRuntimeConfig(docs, options, moduleConfig) {
     ...moduleConfig ? { ...moduleConfig, ...docs.configOverrides } : _nullishCoalesce(docs.runtimeConfig, () => ( docs.config)),
     entry: docs.config.entry || docs.entry.replace(/^\/+|\/+$/g, "") || "docs",
     docsPath: docs.entry,
-    contentDir: _chunk2FXWWUE5cjs.resolveFarmDocsContentDir.call(void 0, docs, options)
+    contentDir: _chunkVZJR7UTGcjs.resolveFarmDocsContentDir.call(void 0, docs, options)
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, createFarmDocsAdapterRuntimeConfig, "createFarmDocsAdapterRuntimeConfig");
@@ -118,12 +119,14 @@ async function createFarmDocsAdapterHandler(docs, options) {
     clientEntry: options.clientEntry,
     stylesheets: getFarmDocsAdapterStylesheets(options),
     resolveLayoutFonts: options.resolveLayoutFonts,
-    loadReactModule: /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, () => options.loadModule(docs.adapter.react), "loadReactModule")
+    loadReactModule: /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, () => options.loadModule(docs.adapter.react), "loadReactModule"),
+    ...options.registerMCPServer ? { registerMCPServer: options.registerMCPServer } : {}
   });
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, createFarmDocsAdapterHandler, "createFarmDocsAdapterHandler");
 
 // src/docs/api.ts
+
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -274,25 +277,25 @@ function getDocsDescription(docs) {
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, getDocsDescription, "getDocsDescription");
 function getLoadedDocsPages(context) {
-  return _chunk2FXWWUE5cjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).map((page) => _chunk2FXWWUE5cjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, page.slug)).filter((page) => Boolean(page));
+  return _chunkVZJR7UTGcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).map((page) => _chunkVZJR7UTGcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, page.slug)).filter((page) => Boolean(page));
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, getLoadedDocsPages, "getLoadedDocsPages");
 function toDocsSourcePage(page) {
   return {
-    ..._chunk2FXWWUE5cjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunkVZJR7UTGcjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, toDocsSourcePage, "toDocsSourcePage");
 function toDocsSitemapPage(page) {
   return {
-    ..._chunk2FXWWUE5cjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunkVZJR7UTGcjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, toDocsSitemapPage, "toDocsSitemapPage");
 function toDocsLlmsPage(page) {
-  return _chunk2FXWWUE5cjs.toFarmDocsMarkdownPage.call(void 0, page);
+  return _chunkVZJR7UTGcjs.toFarmDocsMarkdownPage.call(void 0, page);
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, toDocsLlmsPage, "toDocsLlmsPage");
 function getDocsLlmsOptions(context, request) {
@@ -386,7 +389,7 @@ _chunkS3JO3N4Hcjs.__name.call(void 0, renderAgentsDocument, "renderAgentsDocumen
 function buildAgentSpec(context, request) {
   const url = new URL(request.url);
   const origin = url.origin;
-  const pages = _chunk2FXWWUE5cjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
+  const pages = _chunkVZJR7UTGcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
   const spec = _chunkIK6LVLKCcjs.docsEngine.call(void 0, ).buildDocsAgentDiscoverySpec(getDocsDiscoveryOptions(context, request));
   const title = getDocsTitle(context.docs);
   return {
@@ -423,12 +426,60 @@ function buildAgentSpec(context, request) {
       robots: spec.capabilities.robots,
       post: false
     },
-    pages
+    // Same root-relative source paths the precompiled runtime serves.
+    pages: pages.map(({ sourcePath, ...page }) => {
+      const publicSourcePath = toPublicDocsPath(sourcePath, context.root);
+      return publicSourcePath ? { ...page, sourcePath: `./${publicSourcePath}` } : page;
+    })
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, buildAgentSpec, "buildAgentSpec");
+var REDACTED_DOCS_CONFIG_VALUE = "[redacted]";
+function redactDocsConfigValue(value, key, inHeaders) {
+  if (Array.isArray(value)) {
+    return value.map((entry) => redactDocsConfigValue(entry, key, inHeaders));
+  }
+  if (isRecord(value) && !(value instanceof Date) && !(value instanceof URL)) {
+    const headers = inHeaders || key.toLowerCase() === "headers";
+    return Object.fromEntries(
+      Object.entries(value).map(([childKey, child]) => [
+        childKey,
+        redactDocsConfigValue(child, childKey, headers)
+      ])
+    );
+  }
+  if (value === null || value === void 0 || typeof value === "function") return value;
+  return inHeaders || _chunkHITLGIAOcjs.isSecretDocsConfigKey.call(void 0, key) ? REDACTED_DOCS_CONFIG_VALUE : value;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, redactDocsConfigValue, "redactDocsConfigValue");
+function toPublicDocsPath(value, root) {
+  if (typeof value !== "string" || !value) return void 0;
+  if (!_path2.default.isAbsolute(value)) return value;
+  const relative = _path2.default.relative(root, value);
+  if (_path2.default.isAbsolute(relative) || relative === ".." || relative.startsWith(`..${_path2.default.sep}`)) {
+    return void 0;
+  }
+  return relative.split(_path2.default.sep).join("/") || ".";
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, toPublicDocsPath, "toPublicDocsPath");
+function buildPublicConfig(context) {
+  const redacted = redactDocsConfigValue(context.docs.config, "", false);
+  const contentDir = toPublicDocsPath(redacted.contentDir, context.root);
+  const publicInput = { ...redacted, contentDir };
+  const map = _chunkIK6LVLKCcjs.docsEngine.call(void 0, ).buildDocsConfigMap(publicInput, {
+    file: toPublicDocsPath(context.docs.configPath, context.root) || "farm.config.ts"
+  });
+  const config = Object.fromEntries(Object.keys(map.values).map((key) => [key, publicInput[key]]));
+  return {
+    entry: context.docs.entry,
+    contentDir: toPublicDocsPath(context.docs.contentDir, context.root) || contentDir || null,
+    config,
+    map
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, buildPublicConfig, "buildPublicConfig");
 function buildDiagnostics(context) {
-  const pages = _chunk2FXWWUE5cjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
+  const pages = _chunkVZJR7UTGcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
   const diagnostics = _chunkIK6LVLKCcjs.docsEngine.call(void 0, ).buildDocsDiagnostics(context.docs.config, {
     entry: context.docs.entry,
     mcp: {
@@ -500,12 +551,13 @@ async function resolveAPIContext(options) {
     config: options.config,
     configPath: options.configPath
   }));
-  const docs = isResolvedDocsConfig(docsInput) ? docsInput : await _chunkDFLLARUKcjs.resolveDocsConfig.call(void 0, docsInput, { root, srcDir });
+  const docs = isResolvedDocsConfig(docsInput) ? docsInput : await _chunkF7JZENPFcjs.resolveDocsConfig.call(void 0, docsInput, { root, srcDir });
   return {
     root,
     srcDir,
     docs,
-    contentDir: _chunk2FXWWUE5cjs.resolveFarmDocsContentDir.call(void 0, docs, { root, srcDir })
+    contentDir: _chunkVZJR7UTGcjs.resolveFarmDocsContentDir.call(void 0, docs, { root, srcDir }),
+    diagnostics: options.diagnostics === true
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, resolveAPIContext, "resolveAPIContext");
@@ -517,21 +569,16 @@ async function handleDocsAPIGet(request, context) {
   const format = getDocsAPIFormat(request);
   const pathTarget = getDocsAPIPathTarget(request);
   if (format === "config" || format === "docs-config") {
-    return json({
-      entry: context.docs.entry,
-      contentDir: context.docs.contentDir || context.docs.config.contentDir || null,
-      config: context.docs.config,
-      map: _chunkIK6LVLKCcjs.docsEngine.call(void 0, ).buildDocsConfigMap(context.docs.config, {
-        file: context.docs.configPath || "farm.config.ts"
-      })
-    });
+    return json(buildPublicConfig(context));
   }
   if (format === "skill")
     return text(renderSkillDocument(context, request), "text/markdown; charset=utf-8");
   if (format === "agents")
     return text(renderAgentsDocument(context, request), "text/markdown; charset=utf-8");
   if (format === "agent" || format === "agent-spec") return json(buildAgentSpec(context, request));
-  if (format === "diagnostics") return json(buildDiagnostics(context));
+  if (format === "diagnostics") {
+    return context.diagnostics ? json(buildDiagnostics(context)) : json({ error: "Docs diagnostics are only available in development" }, { status: 404 });
+  }
   if (format === "llms")
     return text(renderLlmsTxt(context, request, false), "text/plain; charset=utf-8");
   if (format === "llms-full")
@@ -568,10 +615,10 @@ async function handleDocsAPIGet(request, context) {
   if (format === "markdown" || url.pathname.endsWith(".md")) {
     const pathParam = url.searchParams.get("path") || url.searchParams.get("slug");
     const slug = normalizeDocsApiSlug(_nullishCoalesce(_nullishCoalesce(pathParam, () => ( pathTarget.slug)), () => ( "")), context.docs);
-    const page = _chunk2FXWWUE5cjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, slug);
+    const page = _chunkVZJR7UTGcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, slug);
     if (!page) return text("Docs page not found\n", "text/plain; charset=utf-8", { status: 404 });
     return text(
-      _chunkIK6LVLKCcjs.docsEngine.call(void 0, ).renderDocsMarkdownDocument(_chunk2FXWWUE5cjs.toFarmDocsMarkdownPage.call(void 0, page), {
+      _chunkIK6LVLKCcjs.docsEngine.call(void 0, ).renderDocsMarkdownDocument(_chunkVZJR7UTGcjs.toFarmDocsMarkdownPage.call(void 0, page), {
         origin: new URL(request.url).origin,
         llms: getDocsLlmsOptions(context, request),
         sitemap: context.docs.config.sitemap

package/dist/{chunk-7QOCTYBS.mjs → chunk-4JHOT46A.mjs}

@@ -1,7 +1,7 @@
 import {
   createFarmMarkdownViewResponse,
   requestAcceptsMarkdown
-} from "./chunk-JBC2FKRW.mjs";
+} from "./chunk-WWIKMBRN.mjs";
 import {
   __name
 } from "./chunk-LPEX4YW6.mjs";
@@ -107,6 +107,11 @@ function createFarmMarkdownRouteModule(input) {
   };
 }
 __name(createFarmMarkdownRouteModule, "createFarmMarkdownRouteModule");
+var publicSourceResponses = /* @__PURE__ */ new WeakSet();
+function isFarmMarkdownPublicSourceResponse(response) {
+  return publicSourceResponses.has(response);
+}
+__name(isFarmMarkdownPublicSourceResponse, "isFarmMarkdownPublicSourceResponse");
 async function createFarmMarkdownSourceResponse(options) {
   if (options.request.method !== "GET" && options.request.method !== "HEAD") {
     return null;
@@ -124,6 +129,36 @@ async function createFarmMarkdownSourceResponse(options) {
   if (!source) {
     return null;
   }
+  const anonymous = !options.request.headers.has("cookie") && !options.request.headers.has("authorization");
+  if (options.renderPage && (hasMarkdownExtension || !anonymous)) {
+    const publicUrl = new URL(url);
+    publicUrl.pathname = targetPathname;
+    const publicHeaders = new Headers(options.request.headers);
+    publicHeaders.delete("cookie");
+    publicHeaders.delete("authorization");
+    publicHeaders.set("accept", "text/markdown");
+    const publicResponse = await options.renderPage(
+      new Request(publicUrl, {
+        method: options.request.method,
+        headers: publicHeaders,
+        signal: options.request.signal
+      })
+    );
+    if (publicResponse.headers.get("X-Farm-Markdown-Route") === targetPathname) {
+      publicSourceResponses.add(publicResponse);
+      return publicResponse;
+    }
+    await publicResponse.body?.cancel();
+    if (!hasMarkdownExtension) return null;
+    return new Response(`No public Markdown version of ${targetPathname}.
+`, {
+      status: 404,
+      headers: {
+        "Content-Type": "text/plain; charset=utf-8",
+        "Cache-Control": "private, no-store"
+      }
+    });
+  }
   const headers = new Headers({
     "Content-Type": "text/markdown; charset=utf-8",
     "Content-Location": targetPathname === "/" ? "/index.md" : `${targetPathname}.md`,
@@ -152,5 +187,6 @@ export {
   titleFromMarkdown,
   createMarkdownMetadata,
   createFarmMarkdownRouteModule,
+  isFarmMarkdownPublicSourceResponse,
   createFarmMarkdownSourceResponse
 };