@farming-labs/docs 0.1.59 → 0.1.62

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 { N as DocsSearchConfig, Z as OrderingItem, m as DocsAnalyticsConfig, w as DocsMcpConfig, z as DocsSearchSourcePage } from "./types-DfiAeeHu.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts
@@ -68,6 +68,7 @@ interface CreateDocsMcpServerOptions {
   source: DocsMcpSource;
   mcp?: boolean | DocsMcpConfig;
   search?: boolean | DocsSearchConfig;
+  analytics?: boolean | DocsAnalyticsConfig;
   defaultName?: string;
   defaultVersion?: string;
 }

package/dist/mcp.mjs

@@ -1,4 +1,4 @@
-import { _ as renderDocsRelatedMarkdownLines, g as normalizeDocsRelated, h as stripGeneratedAgentProvenance, s as performDocsSearch } from "./search-Cu_pxL8o.mjs";
+import { _ as renderDocsRelatedMarkdownLines, g as normalizeDocsRelated, h as stripGeneratedAgentProvenance, s as performDocsSearch, v as emitDocsAnalyticsEvent } from "./search-Ds3jiS2n.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";
 import path from "node:path";
@@ -84,6 +84,12 @@ function createFilesystemDocsMcpSource(options = {}) {
 		getNavigation
 	};
 }
+function nowMs() {
+	return Date.now();
+}
+function durationMs(startedAt) {
+	return Math.max(0, Date.now() - startedAt);
+}
 async function createDocsMcpServer(options) {
 	const resolved = resolveDocsMcpConfig(options.mcp, {
 		defaultName: options.defaultName ?? options.source.siteTitle ?? DEFAULT_MCP_NAME,
@@ -123,7 +129,18 @@ async function createDocsMcpServer(options) {
 		inputSchema: listPagesInputSchema,
 		annotations: { readOnlyHint: true }
 	}, async ({ locale }) => {
+		const startedAt = nowMs();
 		const pages = toPageSummaries(dedupePages(await options.source.getPages(locale)));
+		await emitDocsAnalyticsEvent(options.analytics, {
+			type: "mcp_tool",
+			source: "mcp",
+			locale,
+			properties: {
+				tool: "list_pages",
+				resultCount: pages.length,
+				durationMs: durationMs(startedAt)
+			}
+		});
 		return { content: [{
 			type: "text",
 			text: JSON.stringify({ pages }, null, 2)
@@ -135,9 +152,20 @@ async function createDocsMcpServer(options) {
 		inputSchema: getNavigationInputSchema,
 		annotations: { readOnlyHint: true }
 	}, async ({ locale }) => {
+		const startedAt = nowMs();
+		const tree = await options.source.getNavigation(locale);
+		await emitDocsAnalyticsEvent(options.analytics, {
+			type: "mcp_tool",
+			source: "mcp",
+			locale,
+			properties: {
+				tool: "get_navigation",
+				durationMs: durationMs(startedAt)
+			}
+		});
 		return { content: [{
 			type: "text",
-			text: renderNavigationTree(await options.source.getNavigation(locale))
+			text: renderNavigationTree(tree)
 		}] };
 	});
 	if (resolved.tools.searchDocs) server.registerTool("search_docs", {
@@ -146,6 +174,7 @@ async function createDocsMcpServer(options) {
 		inputSchema: searchDocsInputSchema,
 		annotations: { readOnlyHint: true }
 	}, async ({ query, limit, locale }) => {
+		const startedAt = nowMs();
 		const results = await performDocsSearch({
 			pages: toSearchSourcePages(dedupePages(await options.source.getPages(locale))),
 			query,
@@ -154,6 +183,19 @@ async function createDocsMcpServer(options) {
 			siteTitle: options.source.siteTitle,
 			limit: limit ?? 10
 		});
+		await emitDocsAnalyticsEvent(options.analytics, {
+			type: "mcp_tool",
+			source: "mcp",
+			locale,
+			input: { query },
+			properties: {
+				tool: "search_docs",
+				queryLength: query.length,
+				limit: limit ?? 10,
+				resultCount: results.length,
+				durationMs: durationMs(startedAt)
+			}
+		});
 		return { content: [{
 			type: "text",
 			text: JSON.stringify({ results }, null, 2)
@@ -165,17 +207,73 @@ async function createDocsMcpServer(options) {
 		inputSchema: readPageInputSchema,
 		annotations: { readOnlyHint: true }
 	}, async ({ path: requestedPath, locale }) => {
+		const startedAt = nowMs();
 		const page = findDocsPage(dedupePages(await options.source.getPages(locale)), requestedPath, options.source.entry);
-		if (!page) return {
-			content: [{
-				type: "text",
-				text: JSON.stringify({ error: `No docs page matched "${requestedPath}".` }, null, 2)
-			}],
-			isError: true
-		};
+		if (!page) {
+			await emitDocsAnalyticsEvent(options.analytics, {
+				type: "agent_read",
+				source: "mcp",
+				locale,
+				properties: {
+					delivery: "mcp_tool",
+					tool: "read_page",
+					requestedPath,
+					found: false,
+					durationMs: durationMs(startedAt)
+				}
+			});
+			await emitDocsAnalyticsEvent(options.analytics, {
+				type: "mcp_tool",
+				source: "mcp",
+				locale,
+				properties: {
+					tool: "read_page",
+					path: requestedPath,
+					found: false,
+					durationMs: durationMs(startedAt)
+				}
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify({ error: `No docs page matched "${requestedPath}".` }, null, 2)
+				}],
+				isError: true
+			};
+		}
+		const document = renderPageDocument(page);
+		await emitDocsAnalyticsEvent(options.analytics, {
+			type: "agent_read",
+			source: "mcp",
+			locale,
+			path: page.url,
+			properties: {
+				delivery: "mcp_tool",
+				tool: "read_page",
+				requestedPath,
+				slug: page.slug,
+				found: true,
+				contentLength: document.length,
+				durationMs: durationMs(startedAt)
+			}
+		});
+		await emitDocsAnalyticsEvent(options.analytics, {
+			type: "mcp_tool",
+			source: "mcp",
+			locale,
+			path: page.url,
+			properties: {
+				tool: "read_page",
+				requestedPath,
+				slug: page.slug,
+				found: true,
+				contentLength: document.length,
+				durationMs: durationMs(startedAt)
+			}
+		});
 		return { content: [{
 			type: "text",
-			text: renderPageDocument(page)
+			text: document
 		}] };
 	});
 	return server;
@@ -213,6 +311,7 @@ function createDocsMcpHttpHandler(options) {
 		};
 	}
 	async function handle(request) {
+		const url = new URL(request.url);
 		const method = request.method.toUpperCase();
 		const sessionId = request.headers.get("mcp-session-id") ?? request.headers.get("Mcp-Session-Id");
 		const existing = sessionId ? sessions.get(sessionId) : void 0;
@@ -223,6 +322,17 @@ function createDocsMcpHttpHandler(options) {
 			parsedBody = void 0;
 		}
 		const initializeRequest = method === "POST" && parsedBody && isInitializeRequest(parsedBody);
+		await emitDocsAnalyticsEvent(options.analytics, {
+			type: "mcp_request",
+			source: "mcp",
+			url: request.url,
+			path: url.pathname,
+			properties: {
+				method,
+				hasSession: Boolean(existing),
+				initialize: Boolean(initializeRequest)
+			}
+		});
 		if (!existing) {
 			if (!initializeRequest) return createJsonErrorResponse(method === "DELETE" ? 404 : 400, "MCP session not initialized. Start with an initialize request against this endpoint.");
 			return (await createSession()).transport.handleRequest(request, parsedBody === void 0 ? void 0 : { parsedBody });

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-DVyHOFlo.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 { n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, t as buildDocsSearchDocuments } from "./search-Ds3jiS2n.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-Cu_pxL8o.mjs → search-Ds3jiS2n.mjs}

@@ -1,3 +1,52 @@
+//#region src/analytics.ts
+function resolveConsoleLevel(value, hasEventHandler) {
+	if (value === false) return false;
+	if (value === true) return "info";
+	if (value === "log" || value === "info" || value === "debug") return value;
+	return hasEventHandler ? false : "info";
+}
+function resolveDocsAnalyticsConfig(analytics) {
+	if (!analytics) return {
+		enabled: false,
+		console: false,
+		includeInputs: false
+	};
+	if (analytics === true) return {
+		enabled: true,
+		console: "info",
+		includeInputs: false
+	};
+	const hasEventHandler = typeof analytics.onEvent === "function";
+	return {
+		enabled: analytics.enabled !== false,
+		console: resolveConsoleLevel(analytics.console, hasEventHandler),
+		includeInputs: analytics.includeInputs === true,
+		onEvent: analytics.onEvent
+	};
+}
+function normalizeAnalyticsEvent(event, config) {
+	const normalized = {
+		...event,
+		source: event.source ?? "server",
+		timestamp: event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
+	};
+	if (!config.includeInputs && normalized.input) delete normalized.input;
+	return normalized;
+}
+async function emitDocsAnalyticsEvent(analytics, event) {
+	const resolved = resolveDocsAnalyticsConfig(analytics);
+	if (!resolved.enabled) return;
+	const normalized = normalizeAnalyticsEvent(event, resolved);
+	if (resolved.console) (console[resolved.console] ?? console.info).call(console, "[farming-labs:analytics]", normalized);
+	if (!resolved.onEvent) return;
+	try {
+		await resolved.onEvent(normalized);
+	} catch (error) {
+		if (resolved.console !== false) console.warn("[farming-labs:analytics] onEvent failed", error);
+	}
+}
+
+//#endregion
 //#region src/related.ts
 function normalizeDocsRelated(value) {
 	if (!Array.isArray(value)) return [];
@@ -793,4 +842,4 @@ function createCustomSearchAdapter(adapter) {
 }
 
 //#endregion
-export { renderDocsRelatedMarkdownLines as _, createSimpleSearchAdapter as a, resolveSearchRequestConfig as c, hashGeneratedAgentContent as d, normalizeGeneratedAgentContent as f, normalizeDocsRelated as g, stripGeneratedAgentProvenance as h, createMcpSearchAdapter as i, GENERATED_AGENT_PROVENANCE_MARKER as l, serializeGeneratedAgentDocument as m, createAlgoliaSearchAdapter as n, createTypesenseSearchAdapter as o, parseGeneratedAgentDocument as p, createCustomSearchAdapter as r, performDocsSearch as s, buildDocsSearchDocuments as t, GENERATED_AGENT_PROVENANCE_VERSION as u };
+export { renderDocsRelatedMarkdownLines as _, createSimpleSearchAdapter as a, resolveSearchRequestConfig as c, hashGeneratedAgentContent as d, normalizeGeneratedAgentContent as f, normalizeDocsRelated as g, stripGeneratedAgentProvenance as h, createMcpSearchAdapter as i, GENERATED_AGENT_PROVENANCE_MARKER as l, serializeGeneratedAgentDocument as m, createAlgoliaSearchAdapter as n, createTypesenseSearchAdapter as o, parseGeneratedAgentDocument as p, createCustomSearchAdapter as r, performDocsSearch as s, buildDocsSearchDocuments as t, GENERATED_AGENT_PROVENANCE_VERSION as u, emitDocsAnalyticsEvent as v, resolveDocsAnalyticsConfig as y };

package/dist/search-HlwTDHCK.d.mts

@@ -0,0 +1,31 @@
+import { K as McpDocsSearchConfig, L as DocsSearchResult, M as DocsSearchChunkingConfig, N as DocsSearchConfig, P as DocsSearchDocument, d as CustomDocsSearchConfig, g as DocsAnalyticsEventInput, h as DocsAnalyticsEvent, j as DocsSearchAdapterFactory, k as DocsSearchAdapter, m as DocsAnalyticsConfig, mt as TypesenseDocsSearchConfig, r as AlgoliaDocsSearchConfig, z as DocsSearchSourcePage } from "./types-DfiAeeHu.mjs";
+
+//#region src/analytics.d.ts
+interface ResolvedDocsAnalyticsConfig {
+  enabled: boolean;
+  console: false | "log" | "info" | "debug";
+  includeInputs: boolean;
+  onEvent?: (event: DocsAnalyticsEvent) => void | Promise<void>;
+}
+declare function resolveDocsAnalyticsConfig(analytics?: boolean | DocsAnalyticsConfig): ResolvedDocsAnalyticsConfig;
+declare function emitDocsAnalyticsEvent(analytics: boolean | DocsAnalyticsConfig | undefined, event: DocsAnalyticsEventInput): Promise<void>;
+//#endregion
+//#region src/search.d.ts
+declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig): DocsSearchDocument[];
+declare function createSimpleSearchAdapter(): DocsSearchAdapter;
+declare function createTypesenseSearchAdapter(config: TypesenseDocsSearchConfig): DocsSearchAdapter;
+declare function resolveSearchRequestConfig(search: boolean | DocsSearchConfig | undefined, requestUrl?: string): boolean | DocsSearchConfig | undefined;
+declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearchAdapter;
+declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): DocsSearchAdapter;
+declare function performDocsSearch(options: {
+  pages: DocsSearchSourcePage[];
+  query: string;
+  search?: boolean | DocsSearchConfig;
+  locale?: string;
+  pathname?: string;
+  siteTitle?: string;
+  limit?: number;
+}): Promise<DocsSearchResult[]>;
+declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
+//#endregion
+export { createSimpleSearchAdapter as a, resolveSearchRequestConfig as c, resolveDocsAnalyticsConfig as d, createMcpSearchAdapter as i, ResolvedDocsAnalyticsConfig as l, createAlgoliaSearchAdapter as n, createTypesenseSearchAdapter as o, createCustomSearchAdapter as r, performDocsSearch as s, buildDocsSearchDocuments as t, emitDocsAnalyticsEvent as u };

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 DocsSearchAdapterContext, I as DocsSearchQuery, K as McpDocsSearchConfig, L as DocsSearchResult, N as DocsSearchConfig, P as DocsSearchDocument, Y as OpenDocsProvider, a as ApiReferenceRenderer, b as DocsConfig, g as DocsAnalyticsEventInput, h as DocsAnalyticsEvent, j as DocsSearchAdapterFactory, k as DocsSearchAdapter, m as DocsAnalyticsConfig, z as DocsSearchSourcePage } from "./types-DfiAeeHu.mjs";
+import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, d as resolveDocsAnalyticsConfig, i as createMcpSearchAdapter, l as ResolvedDocsAnalyticsConfig, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, u as emitDocsAnalyticsEvent } from "./search-HlwTDHCK.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";
 
 //#region src/api-reference.d.ts
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
@@ -63,4 +63,4 @@ declare function parsePromptStringArray(value: unknown): string[] | undefined;
 declare function resolvePromptProviderChoices(availableProviders?: PromptProviderInput[], preferredNames?: string[]): PromptProviderChoice[];
 declare function sanitizePromptText(text: string): string;
 //#endregion
-export { type ApiReferenceFramework, type ApiReferenceRenderer, type ApiReferenceRoute, DEFAULT_PROMPT_PROVIDER_TEMPLATES, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpResolvedConfig, type DocsMcpSource, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolvedApiReferenceConfig, type SerializedOpenDocsProvider, 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 };
+export { type ApiReferenceFramework, type ApiReferenceRenderer, type ApiReferenceRoute, DEFAULT_PROMPT_PROVIDER_TEMPLATES, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpResolvedConfig, type DocsMcpSource, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAnalyticsEvent, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders };

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 createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, v as emitDocsAnalyticsEvent, y as resolveDocsAnalyticsConfig } from "./search-Ds3jiS2n.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 };
+export { DEFAULT_PROMPT_PROVIDER_TEMPLATES, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAnalyticsEvent, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders };