@farming-labs/docs 0.1.65 → 0.1.67

package/dist/cli/index.mjs

@@ -80,7 +80,7 @@ async function main() {
 		const { init } = await import("../init-BFhnsS7P.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-Cj7kSQsB.mjs");
+		const { dev } = await import("../dev-DkMu-1UW.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "mcp") {
 		const { runMcp } = await import("../mcp-BANLcwQ0.mjs");

package/dist/{dev-Cj7kSQsB.mjs → dev-DkMu-1UW.mjs}

@@ -201,7 +201,18 @@ const managedConfigSchema = z.object({
 		description: z.string().optional()
 	}).passthrough().optional(),
 	theme: z.object({ preset: z.string().optional() }).passthrough().optional(),
-	cloud: z.object({ enabled: z.boolean().optional() }).passthrough().optional()
+	cloud: z.object({
+		enabled: z.boolean().optional(),
+		analytics: z.union([z.boolean(), z.object({
+			enabled: z.boolean().optional(),
+			console: z.union([z.boolean(), z.enum([
+				"log",
+				"info",
+				"debug"
+			])]).optional(),
+			includeInputs: z.boolean().optional()
+		}).passthrough()]).optional()
+	}).passthrough().optional()
 }).passthrough();
 function toPosixPath(value) {
 	return value.replace(/\\/g, "/");
@@ -481,7 +492,8 @@ function readManagedDocsProject(projectRoot) {
 		siteName,
 		titleTemplate: parsed.data.site?.titleTemplate ?? `%s | ${siteName}`,
 		description: parsed.data.site?.description ?? `Documentation for ${siteName}.`,
-		theme
+		theme,
+		analytics: parsed.data.cloud?.analytics
 	};
 }
 function resolveLocalPackageSpec(projectRoot, runtimeDir) {
@@ -581,6 +593,7 @@ function renderDocsConfigFile(options) {
     specUrl: ${JSON.stringify(options.apiReference.specUrl)},
   },
 ` : "";
+	const analyticsBlock = renderManagedAnalyticsBlock(options.analytics);
 	return `import { defineDocs } from "@farming-labs/docs";
 import { ${options.theme.factory} } from "${options.theme.importPath}";
 
@@ -598,9 +611,19 @@ export default defineDocs({
     titleTemplate: ${JSON.stringify(options.titleTemplate)},
     description: ${JSON.stringify(options.description)},
   },
-${apiReferenceBlock}});
+${analyticsBlock}${apiReferenceBlock}});
 `;
 }
+function renderManagedAnalyticsBlock(analytics) {
+	if (typeof analytics === "undefined") return "";
+	if (typeof analytics === "boolean") return `  analytics: ${analytics},\n`;
+	const properties = [];
+	if (typeof analytics.enabled === "boolean") properties.push(`    enabled: ${analytics.enabled},`);
+	if (typeof analytics.console !== "undefined") properties.push(`    console: ${JSON.stringify(analytics.console)},`);
+	if (typeof analytics.includeInputs === "boolean") properties.push(`    includeInputs: ${analytics.includeInputs},`);
+	if (properties.length === 0) return "  analytics: {},\n";
+	return `  analytics: {\n${properties.join("\n")}\n  },\n`;
+}
 function renderManagedApiReferenceLayout() {
 	return `import docsConfig from "@/docs.config";
 import { createNextApiReferenceLayout } from "@farming-labs/next/api-reference";
@@ -951,6 +974,7 @@ function materializeManagedRuntime(projectRoot) {
 		titleTemplate: project.titleTemplate,
 		description: project.description,
 		theme: project.theme,
+		analytics: project.analytics,
 		apiReference: project.apiReferenceSpec ? {
 			path: apiReferenceRoute,
 			specUrl: project.apiReferenceSpec.specUrl
@@ -963,7 +987,8 @@ function materializeManagedRuntime(projectRoot) {
 		siteName: project.siteName,
 		titleTemplate: project.titleTemplate,
 		description: project.description,
-		theme: project.theme
+		theme: project.theme,
+		analytics: project.analytics
 	}));
 	else fs.rmSync(path.join(project.runtimeDir, "api-reference.config.ts"), { force: true });
 	writeFileIfChanged(path.join(appDir, "layout.tsx"), rootLayoutTemplate(templateConfig, "app/global.css"));

package/dist/mcp.mjs

@@ -279,13 +279,21 @@ async function createDocsMcpServer(options) {
 	return server;
 }
 function createDocsMcpHttpHandler(options) {
-	if (!resolveDocsMcpConfig(options.mcp, {
+	const resolved = resolveDocsMcpConfig(options.mcp, {
 		defaultName: options.defaultName ?? options.source.siteTitle ?? DEFAULT_MCP_NAME,
 		defaultVersion: options.defaultVersion
-	}).enabled) return {
-		GET: async () => createJsonErrorResponse(404, "MCP is disabled. Remove `mcp: false` or set `mcp: { enabled: true }` in docs.config to enable it again."),
-		POST: async () => createJsonErrorResponse(404, "MCP is disabled. Remove `mcp: false` or set `mcp: { enabled: true }` in docs.config to enable it again."),
-		DELETE: async () => createJsonErrorResponse(404, "MCP is disabled. Remove `mcp: false` or set `mcp: { enabled: true }` in docs.config to enable it again.")
+	});
+	const disabledMessage = "MCP is disabled. Remove `mcp: false` or set `mcp: { enabled: true }` in docs.config to enable it again.";
+	if (!resolved.enabled) return {
+		GET: async () => createJsonErrorResponse(404, disabledMessage),
+		POST: async ({ request }) => createJsonRpcErrorResponse({
+			status: 404,
+			code: -32e3,
+			message: disabledMessage,
+			id: readJsonRpcId(await parseJsonBody(request)),
+			data: { reason: "mcp_disabled" }
+		}),
+		DELETE: async () => createJsonErrorResponse(404, disabledMessage)
 	};
 	const sessions = /* @__PURE__ */ new Map();
 	async function createSession() {
@@ -316,9 +324,11 @@ function createDocsMcpHttpHandler(options) {
 		const sessionId = request.headers.get("mcp-session-id") ?? request.headers.get("Mcp-Session-Id");
 		const existing = sessionId ? sessions.get(sessionId) : void 0;
 		let parsedBody;
+		let bodyParseFailed = false;
 		if (method === "POST") try {
 			parsedBody = await request.clone().json();
 		} catch {
+			bodyParseFailed = true;
 			parsedBody = void 0;
 		}
 		const initializeRequest = method === "POST" && parsedBody && isInitializeRequest(parsedBody);
@@ -334,7 +344,18 @@ function createDocsMcpHttpHandler(options) {
 			}
 		});
 		if (!existing) {
-			if (!initializeRequest) return createJsonErrorResponse(method === "DELETE" ? 404 : 400, "MCP session not initialized. Start with an initialize request against this endpoint.");
+			if (method === "POST" && bodyParseFailed) return createJsonRpcErrorResponse({
+				status: 400,
+				code: -32700,
+				message: "Parse error: Invalid JSON"
+			});
+			if (!initializeRequest) return createJsonRpcErrorResponse({
+				status: sessionId || method === "DELETE" ? 404 : 400,
+				code: sessionId ? -32001 : -32e3,
+				message: sessionId ? "Session not found. Reinitialize the MCP client before calling docs tools." : "MCP session not initialized. Start with an initialize request against this endpoint.",
+				id: readJsonRpcId(parsedBody),
+				data: { reason: sessionId ? "session_not_found" : "session_not_initialized" }
+			});
 			return (await createSession()).transport.handleRequest(request, parsedBody === void 0 ? void 0 : { parsedBody });
 		}
 		return existing.transport.handleRequest(request, parsedBody === void 0 ? void 0 : { parsedBody });
@@ -356,6 +377,35 @@ function createJsonErrorResponse(status, error) {
 		headers: { "Content-Type": "application/json" }
 	});
 }
+async function parseJsonBody(request) {
+	try {
+		return await request.clone().json();
+	} catch {
+		return;
+	}
+}
+function readJsonRpcId(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	const id = value.id;
+	return typeof id === "string" || typeof id === "number" ? id : null;
+}
+function createJsonRpcErrorResponse({ status, code, message, id = null, data }) {
+	return new Response(JSON.stringify({
+		jsonrpc: "2.0",
+		id,
+		error: data ? {
+			code,
+			message,
+			data
+		} : {
+			code,
+			message
+		}
+	}), {
+		status,
+		headers: { "Content-Type": "application/json" }
+	});
+}
 function normalizePathSegment(value) {
 	return value.replace(/^\/+|\/+$/g, "");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.1.65",
+  "version": "0.1.67",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",