@mdream/vite 0.11.0 → 0.12.0

package/README.md

@@ -1,10 +1,15 @@
 # @mdream/vite
 
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![License][license-src]][license-href]
+
 Vite plugin for HTML to Markdown conversion with on-demand generation support.
 
 ## Features
 
 - **🚀 On-Demand Generation**: Access any HTML page as `.md` for instant markdown conversion
+- **🤖 Smart Client Detection**: Automatically serves markdown to LLM bots based on Accept headers
 - **⚡ Multi-Environment**: Works in development, preview, and production
 - **📦 Build Integration**: Generate static markdown files during build
 - **💾 Smart Caching**: Intelligent caching for optimal performance
@@ -14,11 +19,7 @@ Vite plugin for HTML to Markdown conversion with on-demand generation support.
 ## Installation
 
 ```bash
-npm install @mdream/vite mdream
-# or
-pnpm add @mdream/vite mdream
-# or
-yarn add @mdream/vite mdream
+pnpm add @mdream/vite
 ```
 
 ## Usage
@@ -54,6 +55,15 @@ The plugin enables accessing any HTML path with a `.md` extension:
 - `/docs/guide.html` → `/docs/guide.md`
 - `/blog/post` → `/blog/post.md`
 
+### Smart Client Detection
+
+The plugin automatically detects LLM bots and serves markdown without requiring the `.md` extension:
+
+- ✅ **Serves markdown** when `Accept` header contains `*/*` or `text/markdown` (but not `text/html`)
+- ❌ **Serves HTML** to browsers (checks for `text/html` in Accept header or `sec-fetch-dest: document`)
+
+This means LLM bots automatically receive optimized markdown responses, reducing token usage by ~10x compared to HTML.
+
 ## Configuration Options
 
 ```ts
@@ -206,4 +216,14 @@ app.use(async (req, res, next) => {
 
 ## License
 
-MIT
+[MIT License](./LICENSE)
+
+<!-- Badges -->
+[npm-version-src]: https://img.shields.io/npm/v/@mdream/vite/latest.svg?style=flat&colorA=18181B&colorB=4C9BE0
+[npm-version-href]: https://npmjs.com/package/@mdream/vite
+
+[npm-downloads-src]: https://img.shields.io/npm/dm/@mdream/vite.svg?style=flat&colorA=18181B&colorB=4C9BE0
+[npm-downloads-href]: https://npm.chart.dev/@mdream/vite
+
+[license-src]: https://img.shields.io/npm/l/@mdream/vite.svg?style=flat&colorA=18181B&colorB=4C9BE0
+[license-href]: https://npmjs.com/package/@mdream/vite

package/dist/index.mjs

@@ -50,7 +50,7 @@ function viteHtmlToMarkdownPlugin(userOptions = {}) {
 		}
 	}
 	async function handleMarkdownRequest(url, server = null, outDir) {
-		let basePath = url.slice(0, -3);
+		let basePath = url.endsWith(".md") ? url.slice(0, -3) : url;
 		if (basePath === "/index") basePath = "/";
 		const source = server ? "dev" : outDir ? "preview" : "build";
 		const cacheKey = `${source}:${basePath}`;
@@ -108,24 +108,33 @@ function viteHtmlToMarkdownPlugin(userOptions = {}) {
 			return regex.test(fileName);
 		});
 	}
+	function shouldServeMarkdown(acceptHeader, secFetchDest) {
+		const accept = acceptHeader || "";
+		if (secFetchDest === "document") return false;
+		if (accept.includes("text/html")) return false;
+		return accept.includes("*/*") || accept.includes("text/markdown");
+	}
 	return {
 		name: "vite-html-to-markdown",
 		configureServer(server) {
 			server.middlewares.use(async (req, res, next) => {
-				if (!req.url?.endsWith(".md")) return next();
+				const hasMarkdownExtension = req.url?.endsWith(".md");
+				const clientPrefersMarkdown = shouldServeMarkdown(req.headers.accept, req.headers["sec-fetch-dest"]);
+				if (!hasMarkdownExtension && !clientPrefersMarkdown) return next();
+				const url = hasMarkdownExtension ? req.url : req.url;
 				try {
-					const result = await handleMarkdownRequest(req.url, server);
+					const result = await handleMarkdownRequest(url, server);
 					res.setHeader("Content-Type", "text/markdown; charset=utf-8");
 					res.setHeader("Cache-Control", "no-cache");
 					res.setHeader("X-Markdown-Source", result.source);
 					res.setHeader("X-Markdown-Cached", result.cached.toString());
 					res.end(result.content);
-					log(`Served ${req.url} from ${result.source} (cached: ${result.cached})`);
+					log(`Served ${url} from ${result.source} (cached: ${result.cached})`);
 				} catch (error) {
 					const message = error instanceof Error ? error.message : String(error);
-					log(`Error serving ${req.url}: ${message}`);
+					log(`Error serving ${url}: ${message}`);
 					res.statusCode = 404;
-					res.end(`HTML content not found for ${req.url}`);
+					res.end(`HTML content not found for ${url}`);
 				}
 			});
 		},
@@ -153,21 +162,24 @@ function viteHtmlToMarkdownPlugin(userOptions = {}) {
 		},
 		configurePreviewServer(server) {
 			server.middlewares.use(async (req, res, next) => {
-				if (!req.url?.endsWith(".md")) return next();
+				const hasMarkdownExtension = req.url?.endsWith(".md");
+				const clientPrefersMarkdown = shouldServeMarkdown(req.headers.accept, req.headers["sec-fetch-dest"]);
+				if (!hasMarkdownExtension && !clientPrefersMarkdown) return next();
+				const url = hasMarkdownExtension ? req.url : req.url;
 				try {
 					const outDir = server.config.build?.outDir || "dist";
-					const result = await handleMarkdownRequest(req.url, null, outDir);
+					const result = await handleMarkdownRequest(url, null, outDir);
 					res.setHeader("Content-Type", "text/markdown; charset=utf-8");
 					res.setHeader("Cache-Control", "public, max-age=3600");
 					res.setHeader("X-Markdown-Source", result.source);
 					res.setHeader("X-Markdown-Cached", result.cached.toString());
 					res.end(result.content);
-					log(`Served ${req.url} from ${result.source} (cached: ${result.cached})`);
+					log(`Served ${url} from ${result.source} (cached: ${result.cached})`);
 				} catch (error) {
 					const message = error instanceof Error ? error.message : String(error);
-					log(`Error in preview server for ${req.url}: ${message}`);
+					log(`Error in preview server for ${url}: ${message}`);
 					res.statusCode = 404;
-					res.end(`HTML content not found for ${req.url}`);
+					res.end(`HTML content not found for ${url}`);
 				}
 			});
 		}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mdream/vite",
   "type": "module",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Vite plugin for HTML to Markdown conversion with on-demand generation",
   "author": {
     "name": "Harlan Wilton",
@@ -43,10 +43,10 @@
     "vite": "^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0"
   },
   "dependencies": {
-    "mdream": "0.11.0"
+    "mdream": "0.12.0"
   },
   "devDependencies": {
-    "@types/node": "^24.6.0",
+    "@types/node": "^24.6.1",
     "vite": "^7.1.7"
   },
   "scripts": {