@bestimmaa/posprint-mcp 0.1.1 → 0.2.0

package/README.md

@@ -9,42 +9,34 @@ The tool is intentionally named `print` so clients can map natural user phrasing
 - Node.js 20+
 - A printer reachable via a CUPS URI supported by `@bestimmaa/posprint`
 
-## Run With npx
-
-```bash
-npx --package=@bestimmaa/posprint-mcp posprint-mcp
-```
-
-## Install
-
-```bash
-npm install -g @bestimmaa/posprint-mcp
-```
-
-After global installation, the package exposes a `posprint-mcp` binary on your PATH.
-
 ## MCP Client Configuration
 
-Use `posprint-mcp` as the command when the package is installed in the client environment.
+Add this to your MCP client config. No separate installation step is required — `npx` fetches the package on first run.
 
 ```json
 {
   "mcpServers": {
     "posprint": {
-      "command": "posprint-mcp"
+      "command": "npx",
+      "args": ["-y", "@bestimmaa/posprint-mcp"]
     }
   }
 }
 ```
 
-For one-off use without installation, configure the command through `npx`.
+## Global Install (optional)
+
+```bash
+npm install -g @bestimmaa/posprint-mcp
+```
+
+After global installation, you can use the shorter form in your MCP client config:
 
 ```json
 {
   "mcpServers": {
     "posprint": {
-      "command": "npx",
-      "args": ["--yes", "--package=@bestimmaa/posprint-mcp", "posprint-mcp"]
+      "command": "posprint-mcp"
     }
   }
 }

package/dist/src/errors.js

@@ -12,7 +12,7 @@ export function mapUnknownError(error) {
     if (error instanceof AppError) {
         return error;
     }
-    if (error instanceof Error && /timeout/i.test(error.message)) {
+    if (error instanceof Error && /time(?:out|d\s+out)/i.test(error.message)) {
         return new AppError("TIMEOUT", "Printing timed out", { cause: error.message });
     }
     return new AppError("UNKNOWN_ERROR", "Unexpected printing failure", {

package/dist/src/printing/posprintClient.js

@@ -1,25 +1,11 @@
 import posprint from "@bestimmaa/posprint";
 const { markdownToEscpos, printRawToPrinterUri } = posprint;
-function withTimeout(promise, timeoutMs) {
-    return new Promise((resolve, reject) => {
-        const timer = setTimeout(() => reject(new Error(`print timeout after ${timeoutMs}ms`)), timeoutMs);
-        promise
-            .then((value) => {
-            clearTimeout(timer);
-            resolve(value);
-        })
-            .catch((error) => {
-            clearTimeout(timer);
-            reject(error);
-        });
-    });
-}
 export async function printMarkdown(params) {
     const { printerUri, markdown, copies = 1, timeoutMs = 15_000, charsPerLine = 42 } = params;
     const escpos = markdownToEscpos(markdown, { charsPerLine });
     const payload = Buffer.from(escpos);
     for (let i = 0; i < copies; i += 1) {
-        await withTimeout(printRawToPrinterUri(printerUri, payload), timeoutMs);
+        await printRawToPrinterUri(printerUri, payload, { timeoutMs });
     }
     return {};
 }

package/dist/src/tools/printReceipt.js

@@ -13,8 +13,10 @@ function buildSnippet(markdown, lineCount = PREVIEW_LINE_COUNT) {
 }
 export async function handlePrintReceipt(input) {
     const start = Date.now();
+    let printerUri;
     try {
         const parsed = parsePrintReceiptInput(input);
+        printerUri = parsed.printerUri;
         if (parsed.mode === "preview") {
             const lineCount = getLineCount(parsed.markdown);
             const confirmationToken = createConfirmationToken({
@@ -71,7 +73,7 @@ export async function handlePrintReceipt(input) {
                 "UNSUPPORTED_SCHEME" === error.code ||
                 "UNSUPPORTED_PATH" === error.code)) {
             throw new AppError("VALIDATION_ERROR", error.message, {
-                printerUri: error.code
+                printerUri
             });
         }
         const mapped = mapUnknownError(error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bestimmaa/posprint-mcp",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "MCP server for printing markdown receipts on POS printers.",
   "license": "MIT",
   "type": "module",
@@ -29,7 +29,7 @@
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
-    "prepack": "npm run build",
+    "prepare": "npm run build",
     "start": "node dist/src/cli.js",
     "dev": "tsx src/cli.ts",
     "test": "vitest run --passWithNoTests",