beliq-mcp 0.3.1 → 0.3.2

package/README.md

@@ -83,7 +83,7 @@ A PDF (Factur-X / ZUGFeRD) must be passed by `documentPath` for validate, parse,
 
 ## Development
 
-This server depends on the published [`@beliq/sdk`](https://www.npmjs.com/package/@beliq/sdk), which carries the request, transport, and result-shaping logic. No lockfile is committed; `@beliq/sdk` is resolved fresh at install time.
+This server depends on the published [`@beliq/sdk`](https://www.npmjs.com/package/@beliq/sdk), which carries the request, transport, and result-shaping logic. `package-lock.json` is committed, and CI and the release build install from it with `npm ci`.
 
 - `npm install`
 - `npm run build` - compile to `dist/`

package/dist/schema.js

@@ -117,11 +117,11 @@ export const generateInputShape = {
     output: z
         .enum(['xml', 'pdf'])
         .optional()
-        .describe("'xml' (default) returns the document inline. 'pdf' produces a Factur-X / ZUGFeRD hybrid PDF and needs outputPath to write it to."),
+        .describe("'xml' (default) returns the document inline. 'pdf' needs outputPath to write it to: for facturx and zugferd it is a hybrid PDF/A-3 with the XML embedded; xrechnung and peppol-bis have no hybrid form, so it is a visualization with no XML inside it, and their legal document stays the XML."),
     facturxProfile: z
         .enum(LIVE_PROFILES)
         .optional()
-        .describe('Profile for a Factur-X / ZUGFeRD PDF; applies only when standard is facturx or zugferd.'),
+        .describe('Profile for a Factur-X / ZUGFeRD document; ignored for xrechnung and peppol-bis. extended-ctc-fr is Factur-X only: zugferd accepts basicwl, en16931 and extended.'),
     verify: z
         .boolean()
         .optional()

package/dist/tools/generate.js

@@ -3,7 +3,7 @@ import { runGenerate } from './shared.js';
 const description = [
     'Generate a compliant EU electronic invoice from an EN 16931 invoice object.',
     'Set standard to the target (xrechnung, zugferd, facturx, or peppol-bis) and pass the invoice fields.',
-    "output 'xml' (default) returns the document inline; 'pdf' produces a Factur-X / ZUGFeRD hybrid PDF, which needs outputPath to write it to.",
+    "output 'xml' (default) returns the document inline; 'pdf' needs outputPath to write it to, and is a hybrid PDF/A-3 with the XML embedded for facturx and zugferd, or a visualization with no embedded XML for xrechnung and peppol-bis (whose legal document stays the XML).",
     'By default the result is validated before it is returned (verify), so a non-compliant document fails rather than coming back.',
     'beliq produces the compliant document; transmission (Peppol, PDP, KSeF, SDI), archiving, and tax-authority reporting stay with your access point.',
 ].join(' ');

package/dist/tools/shared.js

@@ -1,5 +1,5 @@
 import { readFile, writeFile } from 'node:fs/promises';
-import { BeliqApiError } from '@beliq/sdk';
+import { BeliqApiError, isProfileAllowedForStandard, profilesForStandard, } from '@beliq/sdk';
 import { summarizeConvert, summarizeGenerate, summarizeParse, summarizeValidation } from '../summary.js';
 function errorResult(message) {
     return { content: [{ type: 'text', text: message }], isError: true };
@@ -153,6 +153,15 @@ export async function runGenerate(input, deps) {
     if (output === 'pdf' && !outputPath) {
         return errorResult('A pdf output needs outputPath: the file path to write the generated PDF to.');
     }
+    // The SDK drops facturxProfile outside the Factur-X / ZUGFeRD family. Inside
+    // it the pair is still pinned: extended-ctc-fr is Factur-X only, and the API
+    // answers it on zugferd with 422 PROFILE_STANDARD_MISMATCH. Name the legal
+    // values rather than spend a call on a pair that cannot succeed.
+    const hybrid = input.standard === 'facturx' || input.standard === 'zugferd';
+    if (hybrid && input.facturxProfile && !isProfileAllowedForStandard(input.standard, input.facturxProfile)) {
+        return errorResult(`facturxProfile '${input.facturxProfile}' is not available for ${input.standard}. ` +
+            `Use one of: ${profilesForStandard(input.standard).join(', ')}.`);
+    }
     let result;
     try {
         result = await deps.client.generate({
@@ -160,6 +169,10 @@ export async function runGenerate(input, deps) {
             invoice: input.invoice,
             output,
             facturxProfile: input.facturxProfile,
+            // XRechnung and Peppol BIS have no hybrid PDF, and the API refuses PDF
+            // for them unless the request names a visual to render. Factur-X and
+            // ZUGFeRD render theirs either way, so this is inert for them.
+            template: output === 'pdf' ? 'standard' : undefined,
             verify: input.verify ?? true,
             // Always seal so the tool can hand back the document sha256 and the
             // validation verdict for the model to cite.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beliq-mcp",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "beliq MCP server: validate, parse, generate, and convert EU e-invoices (XRechnung, ZUGFeRD, Factur-X, Peppol BIS) against authority-pinned, drift-checked rules, for MCP clients.",
   "license": "MIT",
   "type": "module",
@@ -56,7 +56,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@beliq/sdk": "^0.3.0",
+    "@beliq/sdk": "^0.4.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.4.3"
   },
@@ -66,6 +66,6 @@
     "@typescript-eslint/parser": "^7.18.0",
     "eslint": "^8.57.0",
     "typescript": "^5.5.4",
-    "vitest": "^3.2.6"
+    "vitest": "^4.0.0"
   }
 }