@markdown-for-agents/web 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Konstantin Konstantinov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -0,0 +1,27 @@
+import { MiddlewareOptions, MiddlewareOptions as MiddlewareOptions$1 } from "markdown-for-agents";
+
+//#region src/index.d.ts
+type Handler = (request: Request) => Response | Promise<Response>;
+type Middleware = (request: Request, next: Handler) => Response | Promise<Response>;
+/**
+ * Web-standard middleware that converts HTML responses to markdown
+ * when the client sends an `Accept: text/markdown` header.
+ *
+ * Compatible with any runtime that supports the Fetch API
+ * (Cloudflare Workers, Deno, Bun, etc.).
+ *
+ * @param options - Conversion and middleware options.
+ * @returns A middleware function that wraps a {@link Handler}.
+ *
+ * @example
+ * ```ts
+ * import { markdownMiddleware } from "@markdown-for-agents/web";
+ *
+ * const md = markdownMiddleware({ extract: true });
+ * const response = await md(request, handler);
+ * ```
+ */
+declare function markdownMiddleware(options?: MiddlewareOptions$1): Middleware;
+//#endregion
+export { type MiddlewareOptions, markdownMiddleware };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;KAKK,OAAA,IAAW,OAAA,EAAS,OAAA,KAAY,QAAA,GAAW,OAAA,CAAQ,QAAA;AAAA,KACnD,UAAA,IAAc,OAAA,EAAS,OAAA,EAAS,IAAA,EAAM,OAAA,KAAY,QAAA,GAAW,OAAA,CAAQ,QAAA;;;;;;;;;;;;;;;;AADV;;;iBA0BhD,kBAAA,CAAmB,OAAA,GAAU,mBAAA,GAAoB,UAAA"}

package/dist/index.mjs

@@ -0,0 +1,45 @@
+import { convert } from "markdown-for-agents";
+
+//#region src/index.ts
+function wantsMarkdown(request) {
+	return (request.headers.get("accept") ?? "").includes("text/markdown");
+}
+/**
+* Web-standard middleware that converts HTML responses to markdown
+* when the client sends an `Accept: text/markdown` header.
+*
+* Compatible with any runtime that supports the Fetch API
+* (Cloudflare Workers, Deno, Bun, etc.).
+*
+* @param options - Conversion and middleware options.
+* @returns A middleware function that wraps a {@link Handler}.
+*
+* @example
+* ```ts
+* import { markdownMiddleware } from "@markdown-for-agents/web";
+*
+* const md = markdownMiddleware({ extract: true });
+* const response = await md(request, handler);
+* ```
+*/
+function markdownMiddleware(options) {
+	const tokenHeader = options?.tokenHeader ?? "x-markdown-tokens";
+	return async (request, next) => {
+		if (!wantsMarkdown(request)) return next(request);
+		const response = await next(request);
+		if (!(response.headers.get("content-type") ?? "").includes("text/html")) return response;
+		const { markdown, tokenEstimate } = convert(await response.text(), options);
+		const headers = new Headers(response.headers);
+		headers.set("content-type", "text/markdown; charset=utf-8");
+		headers.set(tokenHeader, String(tokenEstimate.tokens));
+		return new Response(markdown, {
+			status: response.status,
+			statusText: response.statusText,
+			headers
+		});
+	};
+}
+
+//#endregion
+export { markdownMiddleware };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { convert } from 'markdown-for-agents';\nimport type { MiddlewareOptions } from 'markdown-for-agents';\n\nexport type { MiddlewareOptions } from 'markdown-for-agents';\n\ntype Handler = (request: Request) => Response | Promise<Response>;\ntype Middleware = (request: Request, next: Handler) => Response | Promise<Response>;\n\nfunction wantsMarkdown(request: Request): boolean {\n    const accept = request.headers.get('accept') ?? '';\n    return accept.includes('text/markdown');\n}\n\n/**\n * Web-standard middleware that converts HTML responses to markdown\n * when the client sends an `Accept: text/markdown` header.\n *\n * Compatible with any runtime that supports the Fetch API\n * (Cloudflare Workers, Deno, Bun, etc.).\n *\n * @param options - Conversion and middleware options.\n * @returns A middleware function that wraps a {@link Handler}.\n *\n * @example\n * ```ts\n * import { markdownMiddleware } from \"@markdown-for-agents/web\";\n *\n * const md = markdownMiddleware({ extract: true });\n * const response = await md(request, handler);\n * ```\n */\nexport function markdownMiddleware(options?: MiddlewareOptions): Middleware {\n    const tokenHeader = options?.tokenHeader ?? 'x-markdown-tokens';\n\n    return async (request: Request, next: Handler): Promise<Response> => {\n        if (!wantsMarkdown(request)) {\n            return next(request);\n        }\n\n        const response = await next(request);\n        const contentType = response.headers.get('content-type') ?? '';\n\n        if (!contentType.includes('text/html')) {\n            return response;\n        }\n\n        const html = await response.text();\n        const { markdown, tokenEstimate } = convert(html, options);\n\n        const headers = new Headers(response.headers);\n        headers.set('content-type', 'text/markdown; charset=utf-8');\n        headers.set(tokenHeader, String(tokenEstimate.tokens));\n\n        return new Response(markdown, {\n            status: response.status,\n            statusText: response.statusText,\n            headers\n        });\n    };\n}\n"],"mappings":";;;AAQA,SAAS,cAAc,SAA2B;AAE9C,SADe,QAAQ,QAAQ,IAAI,SAAS,IAAI,IAClC,SAAS,gBAAgB;;;;;;;;;;;;;;;;;;;;AAqB3C,SAAgB,mBAAmB,SAAyC;CACxE,MAAM,cAAc,SAAS,eAAe;AAE5C,QAAO,OAAO,SAAkB,SAAqC;AACjE,MAAI,CAAC,cAAc,QAAQ,CACvB,QAAO,KAAK,QAAQ;EAGxB,MAAM,WAAW,MAAM,KAAK,QAAQ;AAGpC,MAAI,EAFgB,SAAS,QAAQ,IAAI,eAAe,IAAI,IAE3C,SAAS,YAAY,CAClC,QAAO;EAIX,MAAM,EAAE,UAAU,kBAAkB,QADvB,MAAM,SAAS,MAAM,EACgB,QAAQ;EAE1D,MAAM,UAAU,IAAI,QAAQ,SAAS,QAAQ;AAC7C,UAAQ,IAAI,gBAAgB,+BAA+B;AAC3D,UAAQ,IAAI,aAAa,OAAO,cAAc,OAAO,CAAC;AAEtD,SAAO,IAAI,SAAS,UAAU;GAC1B,QAAQ,SAAS;GACjB,YAAY,SAAS;GACrB;GACH,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@markdown-for-agents/web",
+  "version": "0.1.1",
+  "description": "Web Standard (Request/Response) middleware for markdown-for-agents",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "dependencies": {
+    "markdown-for-agents": "0.1.1"
+  },
+  "keywords": [
+    "html",
+    "markdown",
+    "middleware",
+    "web",
+    "fetch",
+    "request",
+    "response"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KKonstantinov/markdown-for-agents.git",
+    "directory": "packages/middleware/web"
+  },
+  "homepage": "https://github.com/KKonstantinov/markdown-for-agents/tree/main/packages/middleware/web#readme",
+  "bugs": {
+    "url": "https://github.com/KKonstantinov/markdown-for-agents/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run test/integration",
+    "typecheck": "tsc --noEmit"
+  }
+}