@frihet/mcp-server 1.7.0-beta.1 → 1.9.0-beta.1

package/README.md

@@ -17,7 +17,7 @@
   <a href="https://smithery.ai/server/frihet/frihet-mcp"><img src="https://smithery.ai/badge/frihet/frihet-mcp" alt="Smithery installs"></a>
   <a href="https://registry.modelcontextprotocol.io/?q=io.frihet"><img src="https://img.shields.io/badge/MCP_Registry-io.frihet%2Ferp-4A90D9?style=flat&logo=anthropic&logoColor=white" alt="MCP Registry"></a>
   <a href="https://github.com/Frihet-io/frihet-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-18181b?style=flat&labelColor=09090b" alt="license"></a>
-  <img src="https://img.shields.io/badge/tools-66-18181b?style=flat&labelColor=09090b" alt="66 tools">
+  <img src="https://img.shields.io/badge/tools-94-18181b?style=flat&labelColor=09090b" alt="94 tools">
   <img src="https://img.shields.io/badge/node-%3E%3D18-18181b?style=flat&labelColor=09090b" alt="node >=18">
   <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-18181b?style=flat&labelColor=09090b" alt="TypeScript"></a>
 </p>
@@ -33,7 +33,9 @@ You:     "Create an invoice for TechStart SL, 40 hours of consulting at 75 EUR/h
 Claude:  Done. Invoice INV-2026-089 created. Total: 3,000.00 EUR + 21% IVA = 3,630.00 EUR.
 ```
 
-66 tools. 8 resources. 7 prompts. Structured output on every tool. Zero boilerplate.
+94 tools. 8 resources. 7 prompts. Structured output on every tool. Zero boilerplate.
+
+<!-- v1.9.0-beta.1 — Wave Mature 1: Banking (5) + Fiscal (8) + Stay (5) + POS (4) + Time (4) + Recurring (2) = 94 tools total -->
 
 ---
 
@@ -161,7 +163,7 @@ Talk to your ERP. These are real prompts, not marketing copy.
 
 ## What to expect
 
-This MCP is a **structured data interface** -- you describe what you want in natural language, and the AI creates, queries, or modifies business records in Frihet. All 66 tools are CRUD operations over the REST API.
+This MCP is a **structured data interface** -- you describe what you want in natural language, and the AI creates, queries, or modifies business records in Frihet. All 94 tools are CRUD operations over the REST API.
 
 **Works great:**
 
@@ -188,7 +190,7 @@ If you need to digitize paper invoices or receipts, extract the data first (e.g.
 
 ---
 
-## Tools (66)
+## Tools (94)
 
 ### Invoices (6)
 
@@ -294,7 +296,7 @@ If you need to digitize paper invoices or receipts, extract the data first (e.g.
 | `validate_einvoice_xml` | Validate raw XML against format schema + schematron rules (KOSIT / Mustang / XSD / Schematron) |
 | `export_datev` | Export accounting data as DATEV EXTF (Buchungsstapel / Debitoren / Kreditoren) in CP1252 encoding |
 
-All 66 tools return **structured output** via `outputSchema` -- typed JSON, not raw text. List tools return paginated results (`{ data, total, limit, offset }`).
+All 94 tools return **structured output** via `outputSchema` -- typed JSON, not raw text. List tools return paginated results (`{ data, total, limit, offset }`).
 
 ---
 
@@ -473,7 +475,7 @@ npm run build   # must pass before submitting
 
 | Package | What it is |
 |---------|-----------|
-| [`@frihet/mcp-server`](https://www.npmjs.com/package/@frihet/mcp-server) | This MCP server (66 tools, 8 resources, 7 prompts) |
+| [`@frihet/mcp-server`](https://www.npmjs.com/package/@frihet/mcp-server) | This MCP server (94 tools, 8 resources, 7 prompts) |
 | [`@frihet/sdk`](https://github.com/Frihet-io/frihet-sdk) | TypeScript SDK (`frihet.invoices.create()`) |
 | [`frihet`](https://www.npmjs.com/package/frihet) | CLI (`frihet invoices list --status overdue`) |
 | [`n8n-nodes-frihet`](https://www.npmjs.com/package/n8n-nodes-frihet) | n8n community node for workflow automation |

package/dist/__tests__/banking-tools.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tests for Banking MCP tools — Wave 6 (5 tools).
+ *
+ * Uses Node.js built-in test runner (node:test + node:assert).
+ * Run: npm test (after build)
+ *
+ * Coverage:
+ *   1. Tool registration — all 5 banking tools registered
+ *   2. list_bank_accounts — success path + structuredContent shape
+ *   3. get_bank_account — success path
+ *   4. list_transactions — success path + filters
+ *   5. categorize_transaction — success path + update response
+ *   6. match_transaction_to_invoice — confirm=false gate
+ *   7. match_transaction_to_invoice — confirm=true success path
+ *   8. API error — 404 propagated as isError=true
+ */
+export {};
+//# sourceMappingURL=banking-tools.test.d.ts.map

package/dist/__tests__/banking-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banking-tools.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/banking-tools.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/__tests__/banking-tools.test.js

@@ -0,0 +1,252 @@
+/**
+ * Tests for Banking MCP tools — Wave 6 (5 tools).
+ *
+ * Uses Node.js built-in test runner (node:test + node:assert).
+ * Run: npm test (after build)
+ *
+ * Coverage:
+ *   1. Tool registration — all 5 banking tools registered
+ *   2. list_bank_accounts — success path + structuredContent shape
+ *   3. get_bank_account — success path
+ *   4. list_transactions — success path + filters
+ *   5. categorize_transaction — success path + update response
+ *   6. match_transaction_to_invoice — confirm=false gate
+ *   7. match_transaction_to_invoice — confirm=true success path
+ *   8. API error — 404 propagated as isError=true
+ */
+import { test, describe, beforeEach } from "node:test";
+import assert from "node:assert/strict";
+class StubMcpServer {
+    tools = new Map();
+    registerTool(name, config, handler) {
+        this.tools.set(name, { name, config, handler });
+    }
+}
+// ── Mock data ────────────────────────────────────────────────────────────────
+const MOCK_ACCOUNT = {
+    id: "acct_001",
+    alias: "Cuenta corriente BRTHLS",
+    ibanLast4: "4321",
+    currency: "EUR",
+    balance: 12345.67,
+    lastSyncedAt: "2026-05-10T08:00:00Z",
+    createdAt: "2026-01-01T00:00:00Z",
+};
+const MOCK_ACCOUNTS_LIST = {
+    data: [MOCK_ACCOUNT],
+    total: 1,
+    limit: 20,
+    offset: 0,
+};
+const MOCK_TRANSACTION = {
+    id: "tx_abc123",
+    accountId: "acct_001",
+    amount: -250.0,
+    currency: "EUR",
+    description: "Pago proveedor Acme",
+    postedAt: "2026-05-09T14:23:00Z",
+    category: "supplies",
+    status: "posted",
+    matchedDocId: null,
+};
+const MOCK_TRANSACTIONS_LIST = {
+    data: [MOCK_TRANSACTION],
+    total: 1,
+    limit: 20,
+    offset: 0,
+};
+// ── Client stubs ─────────────────────────────────────────────────────────────
+function makeSuccessClient() {
+    return {
+        listBankAccounts: async () => MOCK_ACCOUNTS_LIST,
+        getBankAccount: async (_id) => MOCK_ACCOUNT,
+        listTransactions: async () => MOCK_TRANSACTIONS_LIST,
+        categorizeTransaction: async (_id, data) => ({ ...MOCK_TRANSACTION, category: data["category"] }),
+        matchTransactionToDocument: async (_txId, data) => ({
+            ...MOCK_TRANSACTION,
+            matchedDocId: data["documentId"],
+        }),
+    };
+}
+function make404Client() {
+    const notFound = () => {
+        const err = Object.assign(new Error("Not Found"), { statusCode: 404, errorCode: "not_found" });
+        return Promise.reject(err);
+    };
+    return {
+        listBankAccounts: notFound,
+        getBankAccount: notFound,
+        listTransactions: notFound,
+        categorizeTransaction: notFound,
+        matchTransactionToDocument: notFound,
+    };
+}
+// ── Helper ───────────────────────────────────────────────────────────────────
+async function makeServer(clientFn) {
+    const server = new StubMcpServer();
+    const { registerBankingTools } = await import("../tools/banking.js");
+    registerBankingTools(server, clientFn());
+    return server;
+}
+// ── Registration tests ───────────────────────────────────────────────────────
+describe("Banking Tools — Registration", () => {
+    let server;
+    beforeEach(async () => {
+        server = await makeServer(makeSuccessClient);
+    });
+    test("registers exactly 5 banking tools", () => {
+        assert.equal(server.tools.size, 5);
+    });
+    test("registers list_bank_accounts", () => {
+        assert.ok(server.tools.has("list_bank_accounts"));
+    });
+    test("registers get_bank_account", () => {
+        assert.ok(server.tools.has("get_bank_account"));
+    });
+    test("registers list_transactions", () => {
+        assert.ok(server.tools.has("list_transactions"));
+    });
+    test("registers categorize_transaction", () => {
+        assert.ok(server.tools.has("categorize_transaction"));
+    });
+    test("registers match_transaction_to_invoice", () => {
+        assert.ok(server.tools.has("match_transaction_to_invoice"));
+    });
+});
+// ── list_bank_accounts ───────────────────────────────────────────────────────
+describe("list_bank_accounts — success path", () => {
+    test("returns structuredContent with data array", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("list_bank_accounts");
+        const result = await tool.handler({});
+        assert.ok(!result.isError);
+        assert.ok(result.structuredContent);
+        const sc = result.structuredContent;
+        assert.ok(Array.isArray(sc["data"]));
+        assert.equal(sc["data"].length, 1);
+        assert.equal(sc["total"], 1);
+    });
+    test("first account has IBAN last 4 and balance", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("list_bank_accounts");
+        const result = await tool.handler({});
+        const first = result.structuredContent["data"][0];
+        assert.equal(first["id"], "acct_001");
+        assert.equal(first["ibanLast4"], "4321");
+        assert.equal(first["currency"], "EUR");
+        assert.equal(first["balance"], 12345.67);
+    });
+    test("content block has type text and mentions bank_accounts", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("list_bank_accounts");
+        const result = await tool.handler({});
+        assert.equal(result.content[0].type, "text");
+        assert.ok(result.content[0].text.includes("bank_accounts"));
+    });
+});
+// ── get_bank_account ─────────────────────────────────────────────────────────
+describe("get_bank_account — success path", () => {
+    test("returns single account by ID", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("get_bank_account");
+        const result = await tool.handler({ id: "acct_001" });
+        assert.ok(!result.isError);
+        const sc = result.structuredContent;
+        assert.equal(sc["id"], "acct_001");
+        assert.equal(sc["alias"], "Cuenta corriente BRTHLS");
+    });
+    test("404 propagates as isError=true", async () => {
+        const server = await makeServer(make404Client);
+        const tool = server.tools.get("get_bank_account");
+        const result = await tool.handler({ id: "acct_missing" });
+        assert.ok(result.isError);
+        assert.ok(result.content[0].text.includes("Error:"));
+    });
+});
+// ── list_transactions ────────────────────────────────────────────────────────
+describe("list_transactions — success path", () => {
+    test("returns transactions list", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("list_transactions");
+        const result = await tool.handler({ accountId: "acct_001", from: "2026-05-01", to: "2026-05-31" });
+        assert.ok(!result.isError);
+        const sc = result.structuredContent;
+        assert.ok(Array.isArray(sc["data"]));
+        assert.equal(sc["total"], 1);
+    });
+    test("first transaction has expected fields", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("list_transactions");
+        const result = await tool.handler({});
+        const first = result.structuredContent["data"][0];
+        assert.equal(first["id"], "tx_abc123");
+        assert.equal(first["amount"], -250.0);
+        assert.equal(first["status"], "posted");
+        assert.equal(first["category"], "supplies");
+    });
+    test("accepts status filter without error", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("list_transactions");
+        const result = await tool.handler({ status: "posted" });
+        assert.ok(!result.isError);
+    });
+});
+// ── categorize_transaction ───────────────────────────────────────────────────
+describe("categorize_transaction — success path", () => {
+    test("returns updated transaction with new category", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("categorize_transaction");
+        const result = await tool.handler({ id: "tx_abc123", category: "travel" });
+        assert.ok(!result.isError);
+        const sc = result.structuredContent;
+        assert.equal(sc["id"], "tx_abc123");
+        assert.equal(sc["category"], "travel");
+    });
+    test("content block mentions categorized", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("categorize_transaction");
+        const result = await tool.handler({ id: "tx_abc123", category: "software", notes: "SaaS Q2" });
+        assert.ok(result.content[0].text.includes("categorized"));
+    });
+});
+// ── match_transaction_to_invoice ─────────────────────────────────────────────
+describe("match_transaction_to_invoice — trust area gate", () => {
+    test("confirm=false returns isError=true without calling API", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("match_transaction_to_invoice");
+        const result = await tool.handler({
+            transactionId: "tx_abc123",
+            documentId: "inv_xyz",
+            documentType: "invoice",
+            confirm: false,
+        });
+        assert.ok(result.isError, "should be isError when confirm=false");
+        assert.ok(result.content[0].text.includes("confirm=true"));
+    });
+    test("confirm=true success path returns matched transaction", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("match_transaction_to_invoice");
+        const result = await tool.handler({
+            transactionId: "tx_abc123",
+            documentId: "inv_xyz456",
+            documentType: "invoice",
+            confirm: true,
+        });
+        assert.ok(!result.isError);
+        const sc = result.structuredContent;
+        assert.equal(sc["id"], "tx_abc123");
+        assert.equal(sc["matchedDocId"], "inv_xyz456");
+    });
+    test("confirm=true with expense type works", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("match_transaction_to_invoice");
+        const result = await tool.handler({
+            transactionId: "tx_abc123",
+            documentId: "exp_abc",
+            documentType: "expense",
+            confirm: true,
+        });
+        assert.ok(!result.isError);
+    });
+});
+//# sourceMappingURL=banking-tools.test.js.map

package/dist/__tests__/banking-tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banking-tools.test.js","sourceRoot":"","sources":["../../src/__tests__/banking-tools.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/fiscal-tools.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tests for Fiscal MCP tools — Wave 6 (8 tools).
+ *
+ * Uses Node.js built-in test runner (node:test + node:assert).
+ * Run: npm test (after build)
+ *
+ * Coverage:
+ *   1. Tool registration — all 8 fiscal tools registered
+ *   2. get_modelo_303_summary — success path + period param
+ *   3. get_modelo_130_summary — success path
+ *   4. get_modelo_390_summary — success path
+ *   5. get_modelo_180_summary — success path
+ *   6. get_modelo_347_summary — success path
+ *   7. verifactu_status — success path
+ *   8. verifactu_resubmit — confirm=false gate + confirm=true success
+ *   9. ticketbai_status — success path + province field
+ *  10. API error — 404 propagated as isError=true
+ */
+export {};
+//# sourceMappingURL=fiscal-tools.test.d.ts.map

package/dist/__tests__/fiscal-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscal-tools.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fiscal-tools.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/__tests__/fiscal-tools.test.js

@@ -0,0 +1,233 @@
+/**
+ * Tests for Fiscal MCP tools — Wave 6 (8 tools).
+ *
+ * Uses Node.js built-in test runner (node:test + node:assert).
+ * Run: npm test (after build)
+ *
+ * Coverage:
+ *   1. Tool registration — all 8 fiscal tools registered
+ *   2. get_modelo_303_summary — success path + period param
+ *   3. get_modelo_130_summary — success path
+ *   4. get_modelo_390_summary — success path
+ *   5. get_modelo_180_summary — success path
+ *   6. get_modelo_347_summary — success path
+ *   7. verifactu_status — success path
+ *   8. verifactu_resubmit — confirm=false gate + confirm=true success
+ *   9. ticketbai_status — success path + province field
+ *  10. API error — 404 propagated as isError=true
+ */
+import { test, describe, beforeEach } from "node:test";
+import assert from "node:assert/strict";
+class StubMcpServer {
+    tools = new Map();
+    registerTool(name, config, handler) {
+        this.tools.set(name, { name, config, handler });
+    }
+}
+// ── Mock data ────────────────────────────────────────────────────────────────
+const MOCK_MODELO_SUMMARY = {
+    modeloCode: "303",
+    period: "2026-Q1",
+    totalsByRate: { "21": 4200.0, "10": 350.0, "4": 80.0 },
+    totalDeductible: 1200.0,
+    totalDue: 3430.0,
+    deadline: "2026-04-20",
+};
+const MOCK_VERIFACTU_STATUS = {
+    invoiceId: "inv_abc123",
+    lastSubmissionAt: "2026-05-09T10:00:00Z",
+    hash: "sha256:abcdef1234567890",
+    status: "success",
+    aeatResponse: "0000",
+    qrUrl: "https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR?nif=B12345678&numserie=2026-001&fecha=2026-05-09&importe=1210.00",
+};
+const MOCK_TICKETBAI_STATUS = {
+    invoiceId: "inv_def456",
+    lastSubmissionAt: "2026-05-09T11:00:00Z",
+    hash: "sha256:xyz9876543210",
+    status: "success",
+    aeatResponse: "0000",
+    qrUrl: "https://tbai.ehu.eus/qr/...",
+    province: "bizkaia",
+};
+// ── Client stubs ─────────────────────────────────────────────────────────────
+function makeSuccessClient() {
+    return {
+        getFiscalModeloSummary: async (modeloCode, period) => ({
+            ...MOCK_MODELO_SUMMARY,
+            modeloCode,
+            period: period ?? "2026-Q1",
+        }),
+        getVerifactuStatus: async (_invoiceId) => MOCK_VERIFACTU_STATUS,
+        resubmitVerifactu: async (_invoiceId) => ({ ...MOCK_VERIFACTU_STATUS, status: "pending" }),
+        getTicketbaiStatus: async (_invoiceId) => MOCK_TICKETBAI_STATUS,
+    };
+}
+function make404Client() {
+    const notFound = () => {
+        const err = Object.assign(new Error("Not Found"), { statusCode: 404, errorCode: "not_found" });
+        return Promise.reject(err);
+    };
+    return {
+        getFiscalModeloSummary: notFound,
+        getVerifactuStatus: notFound,
+        resubmitVerifactu: notFound,
+        getTicketbaiStatus: notFound,
+    };
+}
+// ── Helper ───────────────────────────────────────────────────────────────────
+async function makeServer(clientFn) {
+    const server = new StubMcpServer();
+    const { registerFiscalTools } = await import("../tools/fiscal.js");
+    registerFiscalTools(server, clientFn());
+    return server;
+}
+// ── Registration tests ───────────────────────────────────────────────────────
+describe("Fiscal Tools — Registration", () => {
+    let server;
+    beforeEach(async () => {
+        server = await makeServer(makeSuccessClient);
+    });
+    test("registers exactly 8 fiscal tools", () => {
+        assert.equal(server.tools.size, 8);
+    });
+    for (const name of [
+        "get_modelo_303_summary",
+        "get_modelo_130_summary",
+        "get_modelo_390_summary",
+        "get_modelo_180_summary",
+        "get_modelo_347_summary",
+        "verifactu_status",
+        "verifactu_resubmit",
+        "ticketbai_status",
+    ]) {
+        test(`registers ${name}`, () => {
+            assert.ok(server.tools.has(name), `${name} not registered`);
+        });
+    }
+});
+// ── Modelo summaries ─────────────────────────────────────────────────────────
+describe("get_modelo_303_summary — success path", () => {
+    test("returns summary with totalsDue and period", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("get_modelo_303_summary");
+        const result = await tool.handler({ period: "2026-Q1" });
+        assert.ok(!result.isError);
+        const sc = result.structuredContent;
+        assert.equal(sc["modeloCode"], "303");
+        assert.equal(sc["period"], "2026-Q1");
+        assert.equal(sc["totalDue"], 3430.0);
+        assert.ok(typeof sc["totalsByRate"] === "object");
+    });
+    test("content block mentions Modelo 303", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("get_modelo_303_summary");
+        const result = await tool.handler({});
+        assert.ok(result.content[0].text.includes("303"));
+    });
+    test("404 propagates as isError=true", async () => {
+        const server = await makeServer(make404Client);
+        const tool = server.tools.get("get_modelo_303_summary");
+        const result = await tool.handler({ period: "2026-Q1" });
+        assert.ok(result.isError);
+    });
+});
+describe("get_modelo_130_summary — success path", () => {
+    test("returns modeloCode 130", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("get_modelo_130_summary");
+        const result = await tool.handler({ period: "2026-Q1" });
+        assert.ok(!result.isError);
+        assert.equal(result.structuredContent["modeloCode"], "130");
+    });
+});
+describe("get_modelo_390_summary — success path", () => {
+    test("returns modeloCode 390", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("get_modelo_390_summary");
+        const result = await tool.handler({ period: "2025" });
+        assert.ok(!result.isError);
+        assert.equal(result.structuredContent["modeloCode"], "390");
+    });
+});
+describe("get_modelo_180_summary — success path", () => {
+    test("returns modeloCode 180", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("get_modelo_180_summary");
+        const result = await tool.handler({ period: "2025" });
+        assert.ok(!result.isError);
+        assert.equal(result.structuredContent["modeloCode"], "180");
+    });
+});
+describe("get_modelo_347_summary — success path", () => {
+    test("returns modeloCode 347", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("get_modelo_347_summary");
+        const result = await tool.handler({ period: "2025" });
+        assert.ok(!result.isError);
+        assert.equal(result.structuredContent["modeloCode"], "347");
+    });
+});
+// ── verifactu_status ─────────────────────────────────────────────────────────
+describe("verifactu_status — success path", () => {
+    test("returns status with hash and qrUrl", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("verifactu_status");
+        const result = await tool.handler({ invoiceId: "inv_abc123" });
+        assert.ok(!result.isError);
+        const sc = result.structuredContent;
+        assert.equal(sc["invoiceId"], "inv_abc123");
+        assert.equal(sc["status"], "success");
+        assert.ok(typeof sc["hash"] === "string");
+        assert.ok(typeof sc["qrUrl"] === "string");
+    });
+    test("aeatResponse is present", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("verifactu_status");
+        const result = await tool.handler({ invoiceId: "inv_abc123" });
+        assert.equal(result.structuredContent["aeatResponse"], "0000");
+    });
+});
+// ── verifactu_resubmit ───────────────────────────────────────────────────────
+describe("verifactu_resubmit — trust area gate", () => {
+    test("confirm=false returns isError=true", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("verifactu_resubmit");
+        const result = await tool.handler({ invoiceId: "inv_abc123", confirm: false });
+        assert.ok(result.isError);
+        assert.ok(result.content[0].text.includes("confirm=true"));
+    });
+    test("confirm=true proceeds and returns pending status", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("verifactu_resubmit");
+        const result = await tool.handler({ invoiceId: "inv_abc123", confirm: true });
+        assert.ok(!result.isError);
+        assert.equal(result.structuredContent["status"], "pending");
+    });
+    test("confirm=true with 404 propagates isError=true", async () => {
+        const server = await makeServer(make404Client);
+        const tool = server.tools.get("verifactu_resubmit");
+        const result = await tool.handler({ invoiceId: "inv_missing", confirm: true });
+        assert.ok(result.isError);
+    });
+});
+// ── ticketbai_status ─────────────────────────────────────────────────────────
+describe("ticketbai_status — success path", () => {
+    test("returns status with province field", async () => {
+        const server = await makeServer(makeSuccessClient);
+        const tool = server.tools.get("ticketbai_status");
+        const result = await tool.handler({ invoiceId: "inv_def456" });
+        assert.ok(!result.isError);
+        const sc = result.structuredContent;
+        assert.equal(sc["invoiceId"], "inv_def456");
+        assert.equal(sc["province"], "bizkaia");
+        assert.equal(sc["status"], "success");
+    });
+    test("404 propagates as isError=true", async () => {
+        const server = await makeServer(make404Client);
+        const tool = server.tools.get("ticketbai_status");
+        const result = await tool.handler({ invoiceId: "inv_missing" });
+        assert.ok(result.isError);
+    });
+});
+//# sourceMappingURL=fiscal-tools.test.js.map

package/dist/__tests__/fiscal-tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscal-tools.test.js","sourceRoot":"","sources":["../../src/__tests__/fiscal-tools.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/pos-tools.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tests for POS MCP tools — Wave 5 (4 tools).
+ *
+ * Uses Node.js built-in test runner (node:test + node:assert).
+ * Run: npm test (after build)
+ *
+ * Coverage:
+ *   1. Tool registration — all 4 tools registered on McpServer
+ *   2. list_terminals — success path + structuredContent shape
+ *   3. get_sale — success path + structuredContent shape
+ *   4. list_sales — success path + structuredContent shape
+ *   5. refund_sale — confirm=false blocked, confirm=true succeeds
+ *   6. API error path — 404 propagated through handleToolError
+ */
+export {};
+//# sourceMappingURL=pos-tools.test.d.ts.map

package/dist/__tests__/pos-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pos-tools.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/pos-tools.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}