@farm.js/core 0.1.23 → 0.1.25

package/dist/{chunk-7BC6GAL7.mjs → chunk-RR6UGYUT.mjs}

@@ -2,7 +2,7 @@ import {
   getFarmMarkdownMirrorPath,
   isFarmMarkdownMirrorExposed,
   matchesFarmMarkdownRoutePattern
-} from "./chunk-OFEY6KHO.mjs";
+} from "./chunk-U4MP7XTD.mjs";
 import {
   applyFarmBasePath
 } from "./chunk-4RB44K6Z.mjs";
@@ -67,6 +67,7 @@ function collectFarmLlmsTxtPages(sources, options) {
       continue;
     }
     if (exclude.some((pattern) => matchesFarmMarkdownRoutePattern(pattern, path))) continue;
+    if (isMetadataNoIndex(source.metadata)) continue;
     const target = isFarmMarkdownMirrorExposed(options.markdown, path) ? getFarmMarkdownMirrorPath(path) : path;
     const description = readMetadataString(source.metadata, "description");
     pages.set(path, {
@@ -79,6 +80,17 @@ function collectFarmLlmsTxtPages(sources, options) {
   return [...pages.values()].sort((left, right) => left.path.localeCompare(right.path));
 }
 __name(collectFarmLlmsTxtPages, "collectFarmLlmsTxtPages");
+function isMetadataNoIndex(metadata) {
+  if (!metadata || typeof metadata !== "object") return false;
+  const robots = metadata.robots;
+  if (typeof robots === "string") {
+    return robots.split(",").map((directive) => directive.trim().toLowerCase()).some((directive) => directive === "noindex" || directive === "none");
+  }
+  return Boolean(
+    robots && typeof robots === "object" && robots.index === false
+  );
+}
+__name(isMetadataNoIndex, "isMetadataNoIndex");
 function createFarmDefaultLlmsTxt(options) {
   const { config, pages } = options;
   const summary = config.summary ?? readMetadataString(options.rootMetadata, "description");
@@ -193,6 +205,36 @@ async function renderFarmLlmsFullTxt(value, options) {
 `;
 }
 __name(renderFarmLlmsFullTxt, "renderFarmLlmsFullTxt");
+function createFarmLlmsFullRenderer(options = {}) {
+  const now = options.now ?? Date.now;
+  const ttl = (options.revalidate ?? 0) * 1e3;
+  const maxEntries = options.maxEntries ?? 16;
+  const entries = /* @__PURE__ */ new Map();
+  let queue = Promise.resolve();
+  return (origin, render) => {
+    const entry = entries.get(origin);
+    if (entry && entry.expires > now()) return entry.body;
+    entries.delete(origin);
+    const body = queue.then(render);
+    queue = body.catch(() => {
+    });
+    const pending = { body, expires: Number.POSITIVE_INFINITY };
+    entries.set(origin, pending);
+    if (entries.size > maxEntries) entries.delete(entries.keys().next().value);
+    body.then(
+      () => {
+        if (entries.get(origin) !== pending) return;
+        if (ttl > 0) pending.expires = now() + ttl;
+        else entries.delete(origin);
+      },
+      () => {
+        if (entries.get(origin) === pending) entries.delete(origin);
+      }
+    );
+    return body;
+  };
+}
+__name(createFarmLlmsFullRenderer, "createFarmLlmsFullRenderer");
 function stripFrontmatter(markdown) {
   const match = /^\uFEFF?---\r?\n[\s\S]*?\r?\n---[ \t]*(?:\r?\n|$)/.exec(markdown);
   return match ? markdown.slice(match[0].length) : markdown;
@@ -1336,6 +1378,7 @@ export {
   serializeFarmLlmsTxt,
   createFarmLlmsMarkdownReader,
   renderFarmLlmsFullTxt,
+  createFarmLlmsFullRenderer,
   resolveFarmAgentCrawlers,
   createFarmAgentRobots,
   resolveFarmSecurityConfig,

package/dist/{chunk-LQIRVSBY.cjs → chunk-RYDW7GPR.cjs}

@@ -3,14 +3,14 @@
 
 
 
-var _chunkLYM7HY34cjs = require('./chunk-LYM7HY34.cjs');
+var _chunkAXYTGLF3cjs = require('./chunk-AXYTGLF3.cjs');
 
 
 
 var _chunkIK6LVLKCcjs = require('./chunk-IK6LVLKC.cjs');
 
 
-var _chunkDNLQMFERcjs = require('./chunk-DNLQMFER.cjs');
+var _chunkO5DVPF3Rcjs = require('./chunk-O5DVPF3R.cjs');
 
 
 var _chunk75WGQVQAcjs = require('./chunk-75WGQVQA.cjs');
@@ -39,7 +39,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: _chunkLYM7HY34cjs.resolveFarmDocsContentDir.call(void 0, docs, options)
+    contentDir: _chunkAXYTGLF3cjs.resolveFarmDocsContentDir.call(void 0, docs, options)
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, createFarmDocsAdapterRuntimeConfig, "createFarmDocsAdapterRuntimeConfig");
@@ -274,25 +274,25 @@ function getDocsDescription(docs) {
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, getDocsDescription, "getDocsDescription");
 function getLoadedDocsPages(context) {
-  return _chunkLYM7HY34cjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).map((page) => _chunkLYM7HY34cjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, page.slug)).filter((page) => Boolean(page));
+  return _chunkAXYTGLF3cjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).map((page) => _chunkAXYTGLF3cjs.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 {
-    ..._chunkLYM7HY34cjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunkAXYTGLF3cjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, toDocsSourcePage, "toDocsSourcePage");
 function toDocsSitemapPage(page) {
   return {
-    ..._chunkLYM7HY34cjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunkAXYTGLF3cjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, toDocsSitemapPage, "toDocsSitemapPage");
 function toDocsLlmsPage(page) {
-  return _chunkLYM7HY34cjs.toFarmDocsMarkdownPage.call(void 0, page);
+  return _chunkAXYTGLF3cjs.toFarmDocsMarkdownPage.call(void 0, page);
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, toDocsLlmsPage, "toDocsLlmsPage");
 function getDocsLlmsOptions(context, request) {
@@ -386,7 +386,7 @@ _chunkS3JO3N4Hcjs.__name.call(void 0, renderAgentsDocument, "renderAgentsDocumen
 function buildAgentSpec(context, request) {
   const url = new URL(request.url);
   const origin = url.origin;
-  const pages = _chunkLYM7HY34cjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
+  const pages = _chunkAXYTGLF3cjs.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 {
@@ -428,7 +428,7 @@ function buildAgentSpec(context, request) {
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, buildAgentSpec, "buildAgentSpec");
 function buildDiagnostics(context) {
-  const pages = _chunkLYM7HY34cjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
+  const pages = _chunkAXYTGLF3cjs.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 +500,12 @@ async function resolveAPIContext(options) {
     config: options.config,
     configPath: options.configPath
   }));
-  const docs = isResolvedDocsConfig(docsInput) ? docsInput : await _chunkDNLQMFERcjs.resolveDocsConfig.call(void 0, docsInput, { root, srcDir });
+  const docs = isResolvedDocsConfig(docsInput) ? docsInput : await _chunkO5DVPF3Rcjs.resolveDocsConfig.call(void 0, docsInput, { root, srcDir });
   return {
     root,
     srcDir,
     docs,
-    contentDir: _chunkLYM7HY34cjs.resolveFarmDocsContentDir.call(void 0, docs, { root, srcDir })
+    contentDir: _chunkAXYTGLF3cjs.resolveFarmDocsContentDir.call(void 0, docs, { root, srcDir })
   };
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, resolveAPIContext, "resolveAPIContext");
@@ -568,10 +568,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 = _chunkLYM7HY34cjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, slug);
+    const page = _chunkAXYTGLF3cjs.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(_chunkLYM7HY34cjs.toFarmDocsMarkdownPage.call(void 0, page), {
+      _chunkIK6LVLKCcjs.docsEngine.call(void 0, ).renderDocsMarkdownDocument(_chunkAXYTGLF3cjs.toFarmDocsMarkdownPage.call(void 0, page), {
         origin: new URL(request.url).origin,
         llms: getDocsLlmsOptions(context, request),
         sitemap: context.docs.config.sitemap

package/dist/{chunk-PGQBL5DN.mjs → chunk-T2OPSH6S.mjs}

@@ -3,16 +3,23 @@ import {
 } from "./chunk-XAXTTBUT.mjs";
 import {
   serializeFarmLlmsTxt
-} from "./chunk-7BC6GAL7.mjs";
+} from "./chunk-RR6UGYUT.mjs";
 import {
   resolveFarmThemeConfig
 } from "./chunk-AELACLOB.mjs";
+import {
+  resolveFarmAPIServerBasePath,
+  resolveFarmAPIServerRoutePath
+} from "./chunk-I6XDAKWQ.mjs";
 import {
   omitFarmResponseBody
 } from "./chunk-5WI2S4CO.mjs";
 import {
   localizeFarmPathname
 } from "./chunk-L3KT7IXV.mjs";
+import {
+  applyFarmBasePath
+} from "./chunk-4RB44K6Z.mjs";
 import {
   __name
 } from "./chunk-LPEX4YW6.mjs";
@@ -440,6 +447,66 @@ function serializeInlineValue(value) {
 }
 __name(serializeInlineValue, "serializeInlineValue");
 
+// src/api-catalog.ts
+var FARM_API_CATALOG_PATH = "/.well-known/api-catalog";
+var API_CATALOG_CONTENT_TYPE = 'application/linkset+json; profile="https://www.rfc-editor.org/info/rfc9727"';
+function resolveFarmApiCatalogInput(config) {
+  const mcp = config.mcp && config.mcp.enabled !== false ? config.mcp : void 0;
+  return {
+    basePath: config.basePath,
+    apiBaseURL: config.openapi?.servers?.[0]?.url ?? config.api.baseURL,
+    openapi: config.openapi?.enabled ? { specRoute: config.openapi.specRoute, route: config.openapi.route } : void 0,
+    mcpPath: mcp ? resolveFarmAPIServerRoutePath(
+      mcp.path ?? "/api/mcp",
+      resolveFarmAPIServerBasePath(config.api)
+    ) : void 0
+  };
+}
+__name(resolveFarmApiCatalogInput, "resolveFarmApiCatalogInput");
+function createFarmApiCatalog(input) {
+  const appPath = /* @__PURE__ */ __name((path) => applyFarmBasePath(path, input.basePath), "appPath");
+  const items = [];
+  const contexts = [];
+  const specRoute = input.openapi?.specRoute;
+  const reference = input.openapi?.route;
+  if (specRoute || reference) {
+    const api = { anchor: input.apiBaseURL };
+    if (specRoute) {
+      api["service-desc"] = [
+        { href: appPath(specRoute), type: "application/vnd.oai.openapi+json" }
+      ];
+    }
+    if (reference) api["service-doc"] = [{ href: appPath(reference), type: "text/html" }];
+    items.push({ href: input.apiBaseURL });
+    contexts.push(api);
+  }
+  if (input.mcpPath) items.push({ href: input.mcpPath });
+  return {
+    linkset: [{ anchor: appPath(FARM_API_CATALOG_PATH), item: items }, ...contexts]
+  };
+}
+__name(createFarmApiCatalog, "createFarmApiCatalog");
+function createFarmApiCatalogResponse(method, input) {
+  const upperMethod = method.toUpperCase();
+  if (upperMethod !== "GET" && upperMethod !== "HEAD") {
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { Allow: "GET, HEAD", "Content-Type": "text/plain; charset=utf-8" }
+    });
+  }
+  const catalog = createFarmApiCatalog(input);
+  return new Response(upperMethod === "HEAD" ? null : JSON.stringify(catalog), {
+    status: 200,
+    headers: {
+      "Content-Type": API_CATALOG_CONTENT_TYPE,
+      "Cache-Control": "public, max-age=0, must-revalidate",
+      Link: `<${catalog.linkset[0].anchor}>; rel="api-catalog"`,
+      "X-Content-Type-Options": "nosniff"
+    }
+  });
+}
+__name(createFarmApiCatalogResponse, "createFarmApiCatalogResponse");
+
 export {
   renderFarmLocaleAlternateLinks,
   createLateRedirectRecovery,
@@ -449,5 +516,8 @@ export {
   getDefaultErrorStatusText,
   createDefaultErrorMarkup,
   createFarmThemeDocumentParts,
-  applyFarmThemeDocument
+  applyFarmThemeDocument,
+  FARM_API_CATALOG_PATH,
+  resolveFarmApiCatalogInput,
+  createFarmApiCatalogResponse
 };

package/dist/{chunk-5UX4C5QI.mjs → chunk-TKDY6AJP.mjs}

@@ -7,7 +7,7 @@ import {
   notifyHistoryChange,
   readPageState,
   subscribeHistoryChange
-} from "./chunk-JIKGGIOL.mjs";
+} from "./chunk-6D242YGO.mjs";
 import {
   getFarmI18nClientState
 } from "./chunk-TOVMYGYW.mjs";

package/dist/{chunk-VXCA7RZP.cjs → chunk-TTVHACQV.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});// package.json
-var version = "0.1.23";
+var version = "0.1.25";
 
 // src/version.ts
 var FARM_VERSION = version;