document-mcp 1.4.0 → 1.4.2

package/README.md

@@ -54,11 +54,12 @@ Requires Node.js `>=20` and pnpm `11.6.0` (pinned via `packageManager` in `packa
 
 ```sh
 pnpm install
-pnpm build         # tsdown -> dist/ (ESM + CJS + .d.ts)
-pnpm typecheck     # tsc --noEmit
-pnpm lint          # eslint . --fix --cache --max-warnings 0
-pnpm test          # vitest run --project unit
-pnpm test:smoke    # rebuilds dist/, then spawns dist/bin.js as a real subprocess and drives it over genuine MCP stdio
+pnpm build         # turbo -> tsdown -> dist/ (ESM + CJS + .d.ts)
+pnpm typecheck     # turbo -> tsc --noEmit
+pnpm lint          # turbo -> eslint . --fix --cache --max-warnings 0
+pnpm test          # turbo -> vitest run --project unit
+pnpm test:workers  # turbo -> vitest under the real Cloudflare Workers runtime (workerd) via @cloudflare/vitest-pool-workers, driving createServer() through an in-memory JSON-RPC pair
+pnpm test:smoke    # turbo -> tsdown then vitest --project smoke -- spawns dist/bin.js as a real subprocess driven over genuine MCP stdio
 ```
 
 Once published, run the server directly via `npx document-mcp` (stdio transport, no install step needed).
@@ -127,6 +128,10 @@ Every tool that takes or produces document bytes goes through the same two hybri
 - [document-cli](https://github.com/ExaDev/document-cli) — the sibling CLI/TUI over the same library, whose toolchain this repository's scaffold mirrors.
 - [Model Context Protocol](https://modelcontextprotocol.io) — the protocol this server implements, via [`@modelcontextprotocol/server`](https://www.npmjs.com/package/@modelcontextprotocol/server).
 
+## Gotchas
+
+- **Runtime dependencies are `documents.js` + `@modelcontextprotocol/server` + `zod` only; `pdf-codec` and `odf.js` are devDependencies (test-support only).** Every runtime reach into either — `ProvidedFont`/`FontSubstitution`/`describeFontFace`/the `WinAnsi` substitution shape — goes through `documents.js`'s own re-exports, so a published install pulls in no direct `pdf-codec`/`odf.js` dependency. `odf.js` survives in `devDependencies` solely because `src/test-support/odm-fixture.ts` and `src/test-support/embedded-font-fixture.ts` build real ODF package fixtures from its low-level XML primitives (`zipPackage`/`el`/`rootElement`), and `src/test-support/` is excluded from the `tsdown` build — only `src/index.ts` and `src/bin.ts` are entry points — so neither fixture module ever ships in `dist/`.
+
 ## License
 
 MIT

package/dist/bin.js

@@ -1,14 +1,13 @@
 #!/usr/bin/env node
 import { serveStdio } from "@modelcontextprotocol/server/stdio";
 import { McpServer } from "@modelcontextprotocol/server";
-import { DocumentFormatSchema, OdbReportNotSpecifiedError, OdmUnresolvedSectionError, UnrecognizedDocumentSchemaError, base64ToBytes, buildDocumentBytes, bytesToBase64, createLocalDocumentConverter, decodeOdbPackage, decodePackage, documentFromJson, evaluateSelect, extractSourceFontsForFormat, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
+import { DocumentFormatSchema, OdbReportNotSpecifiedError, OdmUnresolvedSectionError, UnrecognizedDocumentSchemaError, base64ToBytes, buildDocumentBytes, bytesToBase64, createLocalDocumentConverter, decodeOdbPackage, decodePackage, describeFontFace, documentFromJson, evaluateSelect, extractSourceFontsForFormat, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
 import { z } from "zod";
 import { readFile, writeFile } from "node:fs/promises";
-import { readFontFace } from "pdf-codec";
 import { existsSync, readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 //#region package.json
-var version = "1.4.0";
+var version = "1.4.2";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -252,7 +251,7 @@ function errorResult$1(message) {
 		isError: true
 	};
 }
-/** errorResult's counterpart for a caught exception: UnsupportedFontSourceFormatError (extractSourceFontsForFormat rejecting a format with no source-embedded-font concept -- xlsx/pdf/markdown/odf) and FontFaceParseError (readFontFace rejecting bytes that are not a recognised sfnt font, or a .ttc collection) both carry a self-contained, already-actionable message, so there is nothing to add beyond surfacing it verbatim. */
+/** errorResult's counterpart for a caught exception: UnsupportedFontSourceFormatError (extractSourceFontsForFormat rejecting a format with no source-embedded-font concept -- xlsx/pdf/markdown/odf) and FontFaceParseError (describeFontFace rejecting bytes that are not a recognised sfnt font, or a .ttc collection) both carry a self-contained, already-actionable message, so there is nothing to add beyond surfacing it verbatim. */
 function toErrorResult$1(error) {
 	return errorResult$1(error instanceof Error ? error.message : String(error));
 }
@@ -291,7 +290,7 @@ function registerFontTools(server) {
 	}, async ({ source }) => {
 		try {
 			const { bytes, source: label } = await resolveFontFileInput(source);
-			const face = readFontFace(bytes, label);
+			const face = describeFontFace(bytes, label);
 			return jsonResult({
 				family: face.family,
 				bold: face.bold,

package/dist/index.cjs

@@ -3,11 +3,10 @@ let _modelcontextprotocol_server = require("@modelcontextprotocol/server");
 let documents_js = require("documents.js");
 let zod = require("zod");
 let node_fs_promises = require("node:fs/promises");
-let pdf_codec = require("pdf-codec");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 //#region package.json
-var version = "1.4.0";
+var version = "1.4.2";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -251,7 +250,7 @@ function errorResult$1(message) {
 		isError: true
 	};
 }
-/** errorResult's counterpart for a caught exception: UnsupportedFontSourceFormatError (extractSourceFontsForFormat rejecting a format with no source-embedded-font concept -- xlsx/pdf/markdown/odf) and FontFaceParseError (readFontFace rejecting bytes that are not a recognised sfnt font, or a .ttc collection) both carry a self-contained, already-actionable message, so there is nothing to add beyond surfacing it verbatim. */
+/** errorResult's counterpart for a caught exception: UnsupportedFontSourceFormatError (extractSourceFontsForFormat rejecting a format with no source-embedded-font concept -- xlsx/pdf/markdown/odf) and FontFaceParseError (describeFontFace rejecting bytes that are not a recognised sfnt font, or a .ttc collection) both carry a self-contained, already-actionable message, so there is nothing to add beyond surfacing it verbatim. */
 function toErrorResult$1(error) {
 	return errorResult$1(error instanceof Error ? error.message : String(error));
 }
@@ -290,7 +289,7 @@ function registerFontTools(server) {
 	}, async ({ source }) => {
 		try {
 			const { bytes, source: label } = await resolveFontFileInput(source);
-			const face = (0, pdf_codec.readFontFace)(bytes, label);
+			const face = (0, documents_js.describeFontFace)(bytes, label);
 			return jsonResult({
 				family: face.family,
 				bold: face.bold,

package/dist/index.js

@@ -1,12 +1,11 @@
 import { McpServer } from "@modelcontextprotocol/server";
-import { DocumentFormatSchema, OdbReportNotSpecifiedError, OdmUnresolvedSectionError, UnrecognizedDocumentSchemaError, base64ToBytes, buildDocumentBytes, bytesToBase64, createLocalDocumentConverter, decodeOdbPackage, decodePackage, documentFromJson, evaluateSelect, extractSourceFontsForFormat, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
+import { DocumentFormatSchema, OdbReportNotSpecifiedError, OdmUnresolvedSectionError, UnrecognizedDocumentSchemaError, base64ToBytes, buildDocumentBytes, bytesToBase64, createLocalDocumentConverter, decodeOdbPackage, decodePackage, describeFontFace, documentFromJson, evaluateSelect, extractSourceFontsForFormat, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
 import { z } from "zod";
 import { readFile, writeFile } from "node:fs/promises";
-import { readFontFace } from "pdf-codec";
 import { existsSync, readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 //#region package.json
-var version = "1.4.0";
+var version = "1.4.2";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -250,7 +249,7 @@ function errorResult$1(message) {
 		isError: true
 	};
 }
-/** errorResult's counterpart for a caught exception: UnsupportedFontSourceFormatError (extractSourceFontsForFormat rejecting a format with no source-embedded-font concept -- xlsx/pdf/markdown/odf) and FontFaceParseError (readFontFace rejecting bytes that are not a recognised sfnt font, or a .ttc collection) both carry a self-contained, already-actionable message, so there is nothing to add beyond surfacing it verbatim. */
+/** errorResult's counterpart for a caught exception: UnsupportedFontSourceFormatError (extractSourceFontsForFormat rejecting a format with no source-embedded-font concept -- xlsx/pdf/markdown/odf) and FontFaceParseError (describeFontFace rejecting bytes that are not a recognised sfnt font, or a .ttc collection) both carry a self-contained, already-actionable message, so there is nothing to add beyond surfacing it verbatim. */
 function toErrorResult$1(error) {
 	return errorResult$1(error instanceof Error ? error.message : String(error));
 }
@@ -289,7 +288,7 @@ function registerFontTools(server) {
 	}, async ({ source }) => {
 		try {
 			const { bytes, source: label } = await resolveFontFileInput(source);
-			const face = readFontFace(bytes, label);
+			const face = describeFontFace(bytes, label);
 			return jsonResult({
 				family: face.family,
 				bold: face.bold,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-mcp",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "MCP (Model Context Protocol) server exposing documents.js's document-conversion, .odb, metadata, and font tooling as MCP tools.",
   "type": "module",
   "repository": {
@@ -85,8 +85,7 @@
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
     "@modelcontextprotocol/server": "^2.0.0",
-    "documents.js": "^1.94.0",
-    "pdf-codec": "^2.0.0",
+    "documents.js": "^1.95.1",
     "zod": "^4.2.0"
   },
   "devDependencies": {
@@ -105,6 +104,7 @@
     "husky": "^9.1.7",
     "lint-staged": "^17.3.0",
     "odf.js": "^2.3.1",
+    "pdf-codec": "^2.1.3",
     "publint": "^0.3.22",
     "semantic-release": "^25.0.8",
     "tsdown": "^0.22.14",