@farming-labs/docs 0.1.64 → 0.1.66

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.64",
+  "version": "0.1.66",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",