@farming-labs/docs 0.1.59 → 0.1.60

package/dist/{mcp-DSCLcG0O.mjs → mcp-BANLcwQ0.mjs}

@@ -1,4 +1,4 @@
-import "./prompt-utils-CbtKaiIU.mjs";
+import "./prompt-utils-8nmFLQVH.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 import "./server.mjs";
 import { c as readNavTitle, f as resolveDocsConfigPath, n as extractObjectLiteral, o as readBooleanProperty, p as resolveDocsContentDir, u as readStringProperty } from "./config-Si-yUfM_.mjs";

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { D as DocsSearchConfig, G as OrderingItem, N as DocsSearchSourcePage, v as DocsMcpConfig } from "./types-bAjvrTGU.mjs";
+import { D as DocsSearchConfig, G as OrderingItem, N as DocsSearchSourcePage, v as DocsMcpConfig } from "./types-G-xf-4_c.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts

package/dist/{prompt-utils-CbtKaiIU.mjs → prompt-utils-8nmFLQVH.mjs}

@@ -61,6 +61,9 @@ function normalizeRemoteSpecUrl(value) {
 	if (!trimmed) return void 0;
 	return trimmed;
 }
+function isRequestRelativeSpecUrl(value) {
+	return typeof value === "string" && value.startsWith("/");
+}
 function buildApiReferencePageTitle(config, title = "API Reference") {
 	const template = config.metadata?.titleTemplate;
 	if (!template) return title;
@@ -426,18 +429,18 @@ function relativeLuminance([r, g, b]) {
 function buildApiReferenceOpenApiDocument(config, options) {
 	if (resolveApiReferenceConfig(config.apiReference).specUrl) return buildUnavailableOpenApiDocument(config, `Remote OpenAPI specs require the async API reference builder. Use the framework route helper or buildApiReferenceOpenApiDocumentAsync().`);
 	const routes = buildApiReferenceRoutes(config, options);
-	return buildOpenApiDocumentFromRoutes(config, options.framework, routes);
+	return buildOpenApiDocumentFromRoutes(config, options.framework, routes, options.baseUrl);
 }
 async function buildApiReferenceOpenApiDocumentAsync(config, options) {
 	const apiReference = resolveApiReferenceConfig(config.apiReference);
 	if (!apiReference.specUrl) return buildApiReferenceOpenApiDocument(config, options);
 	try {
-		return normalizeRemoteOpenApiDocument(await fetchRemoteOpenApiDocument(apiReference.specUrl, options.baseUrl), config);
+		return normalizeRemoteOpenApiDocument(await fetchRemoteOpenApiDocument(apiReference.specUrl, options.baseUrl), config, options.baseUrl);
 	} catch (error) {
 		return buildUnavailableOpenApiDocument(config, `Unable to load the remote OpenAPI JSON. ${error instanceof Error ? error.message : "Unknown error"}`);
 	}
 }
-function buildOpenApiDocumentFromRoutes(config, framework, routes) {
+function buildOpenApiDocumentFromRoutes(config, framework, routes, baseUrl) {
 	const tags = Array.from(new Set(routes.map((route) => route.tag))).map((name) => ({
 		name,
 		description: `${name} endpoints`
@@ -449,7 +452,7 @@ function buildOpenApiDocumentFromRoutes(config, framework, routes) {
 			description: config.metadata?.description ?? `Generated API reference for ${framework}.`,
 			version: "0.0.0"
 		},
-		servers: [{ url: "/" }],
+		servers: [{ url: baseUrl ?? "/" }],
 		tags,
 		paths: buildOpenApiPaths(routes)
 	};
@@ -504,8 +507,12 @@ async function fetchRemoteOpenApiDocument(specUrl, baseUrl) {
 	if (!("openapi" in parsed) && !("swagger" in parsed)) throw new Error("The remote JSON does not look like an OpenAPI document.");
 	return parsed;
 }
-function normalizeRemoteOpenApiDocument(document, config) {
+function normalizeRemoteOpenApiDocument(document, config, baseUrl) {
+	const apiReference = resolveApiReferenceConfig(config.apiReference);
 	const info = document.info && typeof document.info === "object" && !Array.isArray(document.info) ? document.info : {};
+	const normalizedPaths = normalizeRemoteOpenApiPaths(document.paths);
+	const normalizedTags = normalizeRemoteOpenApiTags(document.tags, normalizedPaths);
+	const normalizedServers = isRequestRelativeSpecUrl(apiReference.specUrl) ? [{ url: baseUrl ?? "/" }] : document.servers;
 	return {
 		...document,
 		info: {
@@ -513,9 +520,78 @@ function normalizeRemoteOpenApiDocument(document, config) {
 			version: "0.0.0",
 			...info,
 			description: typeof info.description === "string" && info.description.trim() ? info.description : config.metadata?.description
-		}
+		},
+		servers: normalizedServers,
+		paths: normalizedPaths,
+		tags: normalizedTags
 	};
 }
+function normalizeRemoteOpenApiPaths(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return;
+	const paths = value;
+	const normalized = {};
+	for (const [routePath, pathItem] of Object.entries(paths)) {
+		if (!pathItem || typeof pathItem !== "object" || Array.isArray(pathItem)) continue;
+		const normalizedPathItem = { ...pathItem };
+		for (const method of [
+			"get",
+			"post",
+			"put",
+			"patch",
+			"delete",
+			"options",
+			"head"
+		]) {
+			const operation = normalizedPathItem[method];
+			if (!operation || typeof operation !== "object" || Array.isArray(operation)) continue;
+			const operationRecord = operation;
+			const tags = Array.isArray(operationRecord.tags) ? operationRecord.tags.filter((tag) => typeof tag === "string" && tag.trim().length > 0) : [];
+			normalizedPathItem[method] = {
+				...operationRecord,
+				tags: tags.length > 0 ? tags : [inferRemoteOpenApiTag(routePath)]
+			};
+		}
+		normalized[routePath] = normalizedPathItem;
+	}
+	return normalized;
+}
+function inferRemoteOpenApiTag(routePath) {
+	return humanizeSegment(routePath.split("/").filter(Boolean).find((value) => !value.startsWith("{")) ?? "general");
+}
+function normalizeRemoteOpenApiTags(value, paths) {
+	const existingTags = Array.isArray(value) ? value.filter((tag) => !!tag && typeof tag === "object") : [];
+	const tagsByName = /* @__PURE__ */ new Map();
+	for (const tag of existingTags) {
+		const name = typeof tag.name === "string" && tag.name.trim() ? tag.name.trim() : void 0;
+		if (!name) continue;
+		tagsByName.set(name, tag);
+	}
+	if (paths) for (const pathItem of Object.values(paths)) for (const method of [
+		"get",
+		"post",
+		"put",
+		"patch",
+		"delete",
+		"options",
+		"head"
+	]) {
+		const operation = pathItem[method];
+		if (!operation || typeof operation !== "object" || Array.isArray(operation)) continue;
+		const tags = Array.isArray(operation.tags) ? operation.tags : [];
+		for (const tag of tags) {
+			if (typeof tag !== "string" || !tag.trim()) continue;
+			if (!tagsByName.has(tag)) tagsByName.set(tag, {
+				name: tag,
+				description: `${tag} endpoints`
+			});
+		}
+	}
+	if (tagsByName.size === 0) return [{
+		name: "General",
+		description: "General endpoints"
+	}];
+	return Array.from(tagsByName.values());
+}
 function buildUnavailableOpenApiDocument(config, description) {
 	return {
 		openapi: "3.1.0",

package/dist/{search-DFCYC33M.mjs → search-CLoh315v.mjs}

@@ -1,5 +1,5 @@
 import { n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, t as buildDocsSearchDocuments } from "./search-Cu_pxL8o.mjs";
-import "./prompt-utils-CbtKaiIU.mjs";
+import "./prompt-utils-8nmFLQVH.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
 import { a as loadProjectEnv, d as readTopLevelStringProperty, f as resolveDocsConfigPath, p as resolveDocsContentDir } from "./config-Si-yUfM_.mjs";

package/dist/{search-DWkWwsU5.d.mts → search-COePaQmH.d.mts}

@@ -1,4 +1,4 @@
-import { B as McpDocsSearchConfig, C as DocsSearchAdapter, D as DocsSearchConfig, E as DocsSearchChunkingConfig, N as DocsSearchSourcePage, O as DocsSearchDocument, T as DocsSearchAdapterFactory, ct as TypesenseDocsSearchConfig, d as CustomDocsSearchConfig, j as DocsSearchResult, r as AlgoliaDocsSearchConfig } from "./types-bAjvrTGU.mjs";
+import { B as McpDocsSearchConfig, C as DocsSearchAdapter, D as DocsSearchConfig, E as DocsSearchChunkingConfig, N as DocsSearchSourcePage, O as DocsSearchDocument, T as DocsSearchAdapterFactory, ct as TypesenseDocsSearchConfig, d as CustomDocsSearchConfig, j as DocsSearchResult, r as AlgoliaDocsSearchConfig } from "./types-G-xf-4_c.mjs";
 
 //#region src/search.d.ts
 declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig): DocsSearchDocument[];

package/dist/server.d.mts

@@ -1,6 +1,6 @@
-import { A as DocsSearchQuery, B as McpDocsSearchConfig, C as DocsSearchAdapter, D as DocsSearchConfig, N as DocsSearchSourcePage, O as DocsSearchDocument, T as DocsSearchAdapterFactory, U as OpenDocsProvider, a as ApiReferenceRenderer, j as DocsSearchResult, m as DocsConfig, w as DocsSearchAdapterContext } from "./types-bAjvrTGU.mjs";
+import { A as DocsSearchQuery, B as McpDocsSearchConfig, C as DocsSearchAdapter, D as DocsSearchConfig, N as DocsSearchSourcePage, O as DocsSearchDocument, T as DocsSearchAdapterFactory, U as OpenDocsProvider, a as ApiReferenceRenderer, j as DocsSearchResult, m as DocsConfig, w as DocsSearchAdapterContext } from "./types-G-xf-4_c.mjs";
 import { DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
-import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-DWkWwsU5.mjs";
+import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-COePaQmH.mjs";
 
 //#region src/api-reference.d.ts
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";

package/dist/server.mjs

@@ -1,5 +1,5 @@
 import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-Cu_pxL8o.mjs";
-import { a as sanitizePromptText, c as serializeOpenDocsProviders, d as buildApiReferenceOpenApiDocument, f as buildApiReferenceOpenApiDocumentAsync, g as resolveApiReferenceRenderer, h as resolveApiReferenceConfig, i as resolvePromptProviderChoices, l as buildApiReferenceHtmlDocument, m as buildApiReferenceScalarCss, n as normalizePromptProviderName, o as serializeDocsIcon, p as buildApiReferencePageTitle, r as parsePromptStringArray, s as serializeDocsIconRegistry, t as DEFAULT_PROMPT_PROVIDER_TEMPLATES, u as buildApiReferenceHtmlDocumentAsync } from "./prompt-utils-CbtKaiIU.mjs";
+import { a as sanitizePromptText, c as serializeOpenDocsProviders, d as buildApiReferenceOpenApiDocument, f as buildApiReferenceOpenApiDocumentAsync, g as resolveApiReferenceRenderer, h as resolveApiReferenceConfig, i as resolvePromptProviderChoices, l as buildApiReferenceHtmlDocument, m as buildApiReferenceScalarCss, n as normalizePromptProviderName, o as serializeDocsIcon, p as buildApiReferencePageTitle, r as parsePromptStringArray, s as serializeDocsIconRegistry, t as DEFAULT_PROMPT_PROVIDER_TEMPLATES, u as buildApiReferenceHtmlDocumentAsync } from "./prompt-utils-8nmFLQVH.mjs";
 import { createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 export { DEFAULT_PROMPT_PROVIDER_TEMPLATES, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveDocsMcpConfig, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders };